Release 2.27.0

[VeskeR]

Bumps the version to 2.27.0 in package.json, package-lock.json and src/platform/react-hooks/src/AblyReactHooks.ts, and adds the 2.27.0 entry to CHANGELOG.md.

The change that drove the release is #2285: a browser client behind a proxy that rejects the WebSocket upgrade outright never connected at all, rotating through fallback hosts on web_socket indefinitely instead of falling back to xhr_polling.

A minor rather than a patch because of #2273. The public API surface is unchanged — ably.d.ts declarations are byte-identical to 2.26.0 once docstrings are excluded — but the resumption semantics of existing public members changed, silently as far as the type system is concerned: Connection#id and Connection#key are now retained through SUSPENDED, so createRecoveryKey() returns a key there where it previously returned null. The DISCONNECTED/SUSPENDED docstrings changed with it. That is adoption of spec 6.1.0, not a fix to broken behaviour, so a patch label would misdescribe it.

PRs included since 2.26.0

User-facing (in changelog)

• fix: fall back to the base transport when websocket handshakes are rejected outright #2285 (WebSocket fallback fix — drove the release)
• Move resumability decisions from the client to the server (spec 6.1.0) #2273 (server-side resumability — reason for the minor)
• Only update attachSerial for non-resumed attaches (RTL15c) #2276
• fix: replace in-flight presence sync sequences #2261
• DX-1211: Auth interface docstrings (prerequisites, side-effects, failure modes) #2242, DX-1206 RealtimeChannel interface docstrings #2243, DX-1206: RealtimePresence interface docstrings #2244, DX-1618: RealtimeAnnotations & RestAnnotations interface docstrings #2245, DX-1211: link the REST Channel and Presence members to their reference pages #2282 (docstrings, one combined bullet)

Not user-facing (not in changelog)

• ci-run-w3lld1 #2274 — CI
• [AIT-1245] objects/uts: RTO27 lifecycle tests, RTO17/18 sync-event fix, and path_object quiescence barriers #2278 — test-only

#2219 merged before the 2.26.0 tag and is already in that release; #2272 is the 2.26.0 release PR itself.

[coderabbitai]

Walkthrough

The release metadata was updated to version 2.27.0. The changelog documents transport fallback, resumability, attach serial handling, and presence cleanup changes.

Changes

Release metadata

Layer / File(s)	Summary
Version and changelog updates package.json, src/platform/react-hooks/src/AblyReactHooks.ts, CHANGELOG.md	The package version and exported React hooks version constant now report 2.27.0. The changelog includes the 2.27.0 release entries.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

• ably/ably-js#2238: Similar release metadata and React hooks version updates.
• ably/ably-js#2240: Similar release version bump across the changelog, package, and React hooks.
• ably/ably-js#2251: Similar release metadata and React hooks version update.

Suggested reviewers: owenpearson, ttypic

Poem

A rabbit checks the version line,
“Two-seven-oh,” it reads just fine.
The changelog grows, the tags align,
React hooks hop into the sign.
Release notes rest beneath the pine.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies this changeset as the 2.27.0 release and matches the version and changelog updates.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release/2.27.0

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}