diff --git a/.changeset/calm-servers-hibernate.md b/.changeset/calm-servers-hibernate.md deleted file mode 100644 index 4fc5b569..00000000 --- a/.changeset/calm-servers-hibernate.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"partyserver": patch ---- - -Inherit hibernation settings when a Server subclass declares partial static options. diff --git a/fixtures/chat/package.json b/fixtures/chat/package.json index 59fe7406..cdc6fe21 100644 --- a/fixtures/chat/package.json +++ b/fixtures/chat/package.json @@ -9,7 +9,7 @@ }, "dependencies": { "nanoid": "^5.1.9", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "react": "^19.2.5", "react-dom": "^19.2.5" diff --git a/fixtures/globe/package.json b/fixtures/globe/package.json index 9b7623a2..1c40d25b 100644 --- a/fixtures/globe/package.json +++ b/fixtures/globe/package.json @@ -9,7 +9,7 @@ }, "dependencies": { "cobe": "^2.0.1", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "react": "^19.2.5", "react-dom": "^19.2.5" diff --git a/fixtures/hono/package.json b/fixtures/hono/package.json index 3f2aaf88..fc3c8b43 100644 --- a/fixtures/hono/package.json +++ b/fixtures/hono/package.json @@ -10,7 +10,7 @@ "dependencies": { "hono": "^4.12.15", "hono-party": "^2.1.0", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "react": "^19.2.5", "react-dom": "^19.2.5" diff --git a/fixtures/tiptap-yjs/package.json b/fixtures/tiptap-yjs/package.json index a512adf3..b0912a0c 100644 --- a/fixtures/tiptap-yjs/package.json +++ b/fixtures/tiptap-yjs/package.json @@ -11,7 +11,7 @@ "@tiptap/extension-collaboration": "^3.22.5", "@tiptap/react": "^3.22.5", "@tiptap/starter-kit": "^3.22.5", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "react": "^19.2.5", "react-dom": "^19.2.5", "tailwindcss": "^4.2.4", diff --git a/fixtures/tldraw/package.json b/fixtures/tldraw/package.json index 6460ee93..60b4f43e 100644 --- a/fixtures/tldraw/package.json +++ b/fixtures/tldraw/package.json @@ -7,7 +7,7 @@ "start": "vite dev" }, "dependencies": { - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "react": "^19.2.5", "react-dom": "^19.2.5", diff --git a/fixtures/todo-sync/package.json b/fixtures/todo-sync/package.json index bfc46c0c..349ab3ed 100644 --- a/fixtures/todo-sync/package.json +++ b/fixtures/todo-sync/package.json @@ -10,7 +10,7 @@ "dependencies": { "nanoid": "^5.1.9", "partyfn": "^0.1.0", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "partysync": "^2.1.0", "react": "^19.2.5", diff --git a/package-lock.json b/package-lock.json index 4d822d18..32864887 100644 --- a/package-lock.json +++ b/package-lock.json @@ -56,7 +56,7 @@ "version": "0.0.11", "dependencies": { "nanoid": "^5.1.9", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "react": "^19.2.5", "react-dom": "^19.2.5" @@ -89,7 +89,7 @@ "version": "0.0.11", "dependencies": { "cobe": "^2.0.1", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "react": "^19.2.5", "react-dom": "^19.2.5" @@ -106,7 +106,7 @@ "dependencies": { "hono": "^4.12.15", "hono-party": "^2.1.0", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "react": "^19.2.5", "react-dom": "^19.2.5" @@ -193,7 +193,7 @@ "@tiptap/extension-collaboration": "^3.22.5", "@tiptap/react": "^3.22.5", "@tiptap/starter-kit": "^3.22.5", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "react": "^19.2.5", "react-dom": "^19.2.5", "tailwindcss": "^4.2.4", @@ -208,7 +208,7 @@ "name": "@partyserver/fixture-tldraw", "version": "0.0.11", "dependencies": { - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "react": "^19.2.5", "react-dom": "^19.2.5", @@ -225,7 +225,7 @@ "dependencies": { "nanoid": "^5.1.9", "partyfn": "^0.1.0", - "partyserver": "^0.5.9", + "partyserver": "^0.5.10", "partysocket": "^1.3.0", "partysync": "^2.1.0", "react": "^19.2.5", @@ -11684,7 +11684,7 @@ "license": "ISC" }, "packages/partyserver": { - "version": "0.5.9", + "version": "0.5.10", "license": "ISC", "dependencies": { "nanoid": "^5.1.9" diff --git a/packages/partyserver/CHANGELOG.md b/packages/partyserver/CHANGELOG.md index 8a3c729a..0dec311f 100644 --- a/packages/partyserver/CHANGELOG.md +++ b/packages/partyserver/CHANGELOG.md @@ -1,5 +1,11 @@ # partyflare +## 0.5.10 + +### Patch Changes + +- [#417](https://github.com/cloudflare/partykit/pull/417) [`5ce45b7`](https://github.com/cloudflare/partykit/commit/5ce45b7df1e097e9b1f87ff547307de98af89184) Thanks [@threepointone](https://github.com/threepointone)! - Inherit hibernation settings when a Server subclass declares partial static options. + ## 0.5.9 ### Patch Changes @@ -21,6 +27,7 @@ On compatibility dates `>= 2026-04-07` the `web_socket_auto_reply_to_close` flag makes the runtime send a reciprocal Close frame and tear the socket down automatically. For a non-hibernating PartyServer (`hibernate: false`), the Durable Object sits on the server end of a connection that the runtime tunnels back to the client, so that auto-teardown could fire through an already-severed tunnel — surfacing as a spurious retryable `Network connection lost.` rejection (for example when a Durable Object is reset while a connection is still open). Half-open mode keeps PartyServer's existing close handling in control; it already reciprocates the peer's Close frame on every compatibility date, so client behavior is unchanged. Also in this release, two related WebSocket fixes that keep behavior consistent across all compatibility dates: + - **Pin `binaryType` to `"arraybuffer"` for non-hibernating connections.** On compatibility dates `>= 2026-03-17` the `websocket_standard_binary_type` flag flips the default server-side `binaryType` from `"arraybuffer"` to `"blob"`, so binary frames arrived as `Blob` instead of `ArrayBuffer` on the in-memory path. PartyServer (and frameworks built on it, e.g. Cloudflare Agents) have always received `ArrayBuffer`, so it is now pinned back in `accept()`. This is a no-op on older dates and corrective on newer ones; the Hibernation API is unaffected (it always delivers `ArrayBuffer`). - **Stop reporting transport-teardown errors as `onError`.** A retryable `Network connection lost.` / `WebSocket peer disconnected` error that fires on an already closing/closed connection is the socket going away during the close handshake, not an application error. It is now suppressed when the connection is `CLOSING`/`CLOSED` (detected via the structured `retryable` flag, with a message fallback), so it no longer spams logs on abrupt client disconnects. Genuine mid-connection (`OPEN`) errors still reach `onError`. @@ -55,6 +62,7 @@ The fix is at the call site, not in PartyServer: pass `id: someBoundDONamespace.idFromName(facetName)` to `ctx.facets.get(...)`. The facet then gets its own native `ctx.id.name === facetName` and PartyServer's `name` getter does the right thing automatically. No `setName()` is required, no `__ps_name` storage record is written, and cold-wake recovery happens for free because the factory re-runs and `idFromName` is deterministic. This release adds: + - **A "Using PartyServer with Durable Object Facets" section in the README** that walks through the recommended pattern with a code example, calls out the implicit-id footgun explicitly, and documents that plain-string `id` values are not a substitute for `idFromName(facetName)` (workerd treats string ids as `idFromString`-like, so the resulting facet has no `ctx.id.name`). - **`setName()` docstring updated** to clarify that facets are NOT a `setName()` use case — point to the explicit-`id` pattern instead. The original `setName()` `ctx.id.name` mismatch throw is preserved as a typo guard for the `idFromName` happy path. - **End-to-end facet test coverage** against the real workerd `ctx.facets.get(...)` API. A `FacetParent` / `FacetChild` fixture exercises both the implicit-id path (pinning the runtime contract that `this.name` returns the parent's name in that flow — i.e., behavior-as-documentation so framework authors are unsurprised) and the explicit-id path (recommended; verifies that all reasonable id-construction strategies work and that cold wake recovers without any storage record). Plain-string `id` is also tested; the test asserts it does NOT carry a name, pinning the contract so callers don't get tempted by the type signature. @@ -83,6 +91,7 @@ ``` Backward compatible: + - For DOs addressed via `idFromName()` / `getByName()` (the happy path), `setName()` continues to NOT write storage — `ctx.id.name` is the source of truth and `setName()` is just a no-op-plus-onStart. - The pre-existing direct-storage-write pattern keeps working — the storage write becomes idempotent with what `setName()` would do. @@ -97,6 +106,7 @@ 0.5.0 moved the legacy storage hydrate into `alarm()` only, breaking Cloudflare Agents facets and any other framework that writes `__ps_name` directly before calling `__unsafe_ensureInitialized()`. Facet DOs are spawned via `ctx.facets.get(...)` rather than `idFromName()` and therefore have `ctx.id.name === undefined`; they relied on PartyServer reading the storage record back to populate `this.name` before `onStart()`. Changes: + - Move the legacy `__ps_name` hydrate from `alarm()` into `#ensureInitialized()`, still gated on `!ctx.id.name && !#_name` so it costs nothing on the happy path (normal `idFromName()`/`getByName()` DOs skip the storage read entirely). - `Server.fetch()` now delegates to `#ensureInitialized()` for the hydrate instead of doing its own. The `x-partykit-room` header fallback remains as a last resort when neither `ctx.id.name` nor a legacy storage record is available. - `Server.alarm()` is simplified — it no longer needs its own hydrate call since `#ensureInitialized()` handles it. @@ -111,6 +121,7 @@ Durable Objects now expose `ctx.id.name` on every entry point (constructor, fetch, alarm, hibernating websocket handlers) when the DO is addressed via `idFromName()`/`getByName()`. PartyServer now uses this as the primary source of `this.name`, which simplifies routing, eliminates storage writes, and makes `this.name` available inside the constructor. Changes in `partyserver`: + - `this.name` resolves from `this.ctx.id.name`. The apologetic `workerd#2240` error message is gone. - `this.name` is now available **inside the constructor** and from class field initializers, not just after `setName()`/`fetch()` has run. - `routePartykitRequest` no longer issues a `setName()`/`_initAndFetch()` RPC before `fetch()`. The WebSocket path goes from 2 RPCs to 1; the HTTP path remains 1 RPC. Props, when supplied, are delivered to the DO via the `x-partykit-props` request header, set after `onBeforeConnect`/`onBeforeRequest` hooks run. @@ -122,6 +133,7 @@ - When reading `this.name` throws, it is because `ctx.id.name` is undefined and no legacy fallback has populated the name: the DO was addressed via `idFromString()` or `newUniqueId()` (both unsupported), the runtime is too old to expose `ctx.id.name`, or a pre-2026-03-15 alarm fired before the legacy storage fallback ran. Changes in all affected packages (`partyserver`, `partysub`, `partysync`, `y-partyserver`, `hono-party`): + - `@cloudflare/workers-types` peer dependency bumped from `^4.20240729.0` to `^4.20260424.1`. The old range predates `ctx.id.name` in the type surface. Not supported: addressing PartyServer DOs via `idFromString()` or `newUniqueId()`. These paths return `ctx.id.name === undefined` inside the DO and will surface as a clear error from `this.name`. PartyServer has always assumed name-based addressing via `getServerByName` / `routePartykitRequest`; this release makes that assumption explicit. @@ -442,12 +454,14 @@ ### Patch Changes - [`528adea`](https://github.com/threepointone/partyserver/commit/528adeaced6dce6e888d2f54cc75c3569bf2c277) Thanks [@threepointone](https://github.com/threepointone)! - some fixes and tweaks + - getServerByName was throwing on all requests - `Env` is now an optional arg when defining `Server` - `y-partyserver/provider` can now take an optional `prefix` arg to use a custom url to connect - `routePartyKitRequest`/`getServerByName` now accepts `jurisdiction` bonus: + - added a bunch of fixtures - added stubs for docs diff --git a/packages/partyserver/package.json b/packages/partyserver/package.json index ff4e6688..6103a3dc 100644 --- a/packages/partyserver/package.json +++ b/packages/partyserver/package.json @@ -1,6 +1,6 @@ { "name": "partyserver", - "version": "0.5.9", + "version": "0.5.10", "repository": { "type": "git", "url": "git://github.com/cloudflare/partykit.git"