@pluv/platform-cloudflare 0.19.0 → 0.21.0

package/.turbo/turbo-build.log

@@ -1,18 +1,18 @@
 
-> @pluv/platform-cloudflare@0.19.0 build /home/runner/work/pluv/pluv/packages/platform-cloudflare
+> @pluv/platform-cloudflare@0.21.0 build /home/runner/work/pluv/pluv/packages/platform-cloudflare
 > tsup src/index.ts --format esm,cjs --dts
 
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.1.0
-CLI Target: es6
-ESM Build start
-CJS Build start
-CJS dist/index.js 6.86 KB
-CJS ⚡️ Build success in 91ms
-ESM dist/index.mjs 5.73 KB
-ESM ⚡️ Build success in 92ms
-DTS Build start
-DTS ⚡️ Build success in 2530ms
-DTS dist/index.d.mts 3.02 KB
-DTS dist/index.d.ts  3.02 KB
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.2.4
+CLI Target: es6
+ESM Build start
+CJS Build start
+CJS dist/index.js 15.00 KB
+CJS ⚡️ Build success in 80ms
+ESM dist/index.mjs 13.96 KB
+ESM ⚡️ Build success in 85ms
+DTS Build start
+DTS ⚡️ Build success in 2845ms
+DTS dist/index.d.mts 4.11 KB
+DTS dist/index.d.ts  4.11 KB

package/CHANGELOG.md

@@ -1,5 +1,90 @@
 # @pluv/platform-cloudflare
 
+## 0.21.0
+
+### Minor Changes
+
+- 307bd44: `@pluv/platform-cloudflare` now supports Cloudflare Worker's WebSocket Hibernation API, and usees it by default.
+
+  To switch back to not using the WebSocket Hibernation API, specify a `mode` of `attached`.
+
+  ```ts
+  // With event-listeners directly attached to the websocket on registration (i.e. non-hibernation)
+  createIO({
+    platform: platformCloudflare({
+      mode: "attached",
+    }),
+  });
+
+  // With event listeners unattached to the websocket during registration (i.e. hibernation)
+  createIO({
+    platform: platformCloudflare({
+      mode: "detached",
+    }),
+  });
+  ```
+
+- 41b15e4: **BREAKING** - Updated `sessions` type in the procedure context from `Map<string, WebSocketSession>` to `readonly WebSocketSession[]`.
+- f570c8a: **BREAKING**: The original request object is no longer available in the context of any event resolvers.
+
+  Previously, the request object that was passed into `PluvServer.getRoom` would be made available on the context object of each of the resolvers. This is no-longer a part of the event context, and therefore needs to be omitted from calls to `PluvServer.getRoom`.
+
+  ```ts
+  // Before
+
+  // With platform-node
+  ioServer.getRoom(websocket, { req, token });
+
+  // With platform-cloudflare
+  ioServer.getRoom(websocket, { env, req, token });
+  ```
+
+  ```ts
+  // Now
+
+  // With platform-node
+  ioServer.getRoom(websocket, { req });
+
+  // With platform-cloudflare
+  ioServer.getRoom(websocket, { env, req });
+  ```
+
+- b98ab6b: Internal updates to platforms (i.e. `@pluv/platform-cloudflare` and `@pluv/platform-node`) to be able to support Cloudflare Worker Websocket Hibernation APIs.
+- 4c2228d: **BREAKING**: Require `DurableObjectState` in `ioServer.getRoom`.
+
+  ```ts
+  // Before
+
+  // With platform-cloudflare
+  ioServer.getRoom(websocket, { env, req });
+  ```
+
+  ```ts
+  // Now
+
+  // With platform-cloudflare
+  ioServer.getRoom(websocket, { env, req, state });
+  ```
+
+### Patch Changes
+
+- cc2613e: Moved `sessionId` from being derived in `IORoom` to being derived as a getter in `AbstractWebsocket`.
+- Updated dependencies [307bd44]
+- Updated dependencies [41b15e4]
+- Updated dependencies [f570c8a]
+- Updated dependencies [b98ab6b]
+- Updated dependencies [4c2228d]
+- Updated dependencies [cc2613e]
+  - @pluv/io@0.21.0
+  - @pluv/types@0.21.0
+
+## 0.20.0
+
+### Patch Changes
+
+- @pluv/io@0.20.0
+- @pluv/types@0.20.0
+
 ## 0.19.0
 
 ### Patch Changes

package/README.md

@@ -1,30 +1,3 @@
-> **Disclaimer:**
-> This package is currently in preview and may have breaking changes between versions. Please wait for a `v1.0.0` stable release before using this in production.
-
-<h1 align="center">
-  <br />
-  <img src="https://github.com/pluv-io/pluv/blob/master/assets/pluv-icon-192x192.png?raw=true" alt="Pluv.IO" width="180" style="border-radius:16px" />
-  <br />
-  <a href="https://pluv.io/docs/introduction">Pluv.IO (preview)</a>
-  <br />
-</h1>
-
-<h3 align="center">Multi-platform, E2E type-safe realtime packages</h3>
-<h4 align="center">💕 Inspired by <a href="https://trpc.io">trpc</a> 💕 <a href="https://docs.yjs.dev/">yjs</a> 💕 and <a href="https://developers.cloudflare.com/">Cloudflare</a> 💕 </h4>
-
-<p align="center">
-  <a href="https://www.npmjs.com/package/@pluv/platform-cloudflare">
-    <img src="https://img.shields.io/npm/v/@pluv/platform-cloudflare" alt="npm @pluv/platform-cloudflare" />
-  </a>
-  <a href="https://github.com/pluv-io/pluv/blob/master/LICENSE">
-    <img alt="GitHub" src="https://img.shields.io/github/license/pluv-io/pluv" alt="License MIT" />
-  </a>
-  <a href="https://commitizen.github.io/cz-cli/">
-    <img src="https://img.shields.io/badge/commitizen-friendly-brightgreen.svg" alt="Commitizen friendly" />
-  </a>
-  <img src="https://badgen.net/badge/-/TypeScript?icon=typescript&label&labelColor=blue&color=555555" alt="TypeScript" />
-</p>
-
 ## `@pluv/platform-cloudflare`
 
 > Enables [@pluv/io](https://www.npmjs.com/package/@pluv/io) to run on [Cloudflare Workers](https://workers.cloudflare.com/).
@@ -43,26 +16,3 @@ yarn add @pluv/platform-cloudflare
 # pnpm
 pnpm add @pluv/platform-cloudflare
 ```
-
-## Basic Example
-
-```ts
-import { createIO } from "@pluv/io";
-import { platformCloudflare } from "@pluv/platform-cloudflare";
-
-export const io = createIO({ platform: platformCloudflare() });
-export const ioServer = io.server();
-
-/* Somewhere in a Cloudflare worker durable object */
-const { 0: client, 1: server } = new WebSocketPair();
-
-const room = ioServer.getRoom(state.id.toString(), { env });
-
-await room.register(server);
-
-return new Response(null, { status: 101, webSocket: client });
-```
-
-## Reference
-
-Check us out on [GitHub](https://github.com/pluv-io/pluv) for more information on how to use `@pluv/io`.

package/dist/index.d.mts

@@ -1,26 +1,48 @@
-import { AbstractWebSocket, AbstractEventMap, AbstractListener, AbstractWebSocketConfig, AbstractPlatform, ConvertWebSocketConfig, PluvServer } from '@pluv/io';
-import { MaybePromise, Maybe, InferIOAuthorizeUser, InferIOAuthorize, InferIOAuthorizeRequired, Id } from '@pluv/types';
+import { AbstractWebSocket, WebSocketSerializedState, AbstractEventMap, AbstractListener, AbstractWebSocketConfig, AbstractPlatformConfig, WebSocketRegistrationMode, AbstractPlatform, ConvertWebSocketConfig, PluvServer } from '@pluv/io';
+import { JsonObject, MaybePromise, Maybe, InferIOAuthorizeUser, InferIOAuthorize, InferIOAuthorizeRequired, Id } from '@pluv/types';
 
 type CloudflareWebSocketConfig = AbstractWebSocketConfig;
-declare class CloudflareWebSocket extends AbstractWebSocket {
-    webSocket: WebSocket;
+declare class CloudflareWebSocket extends AbstractWebSocket<WebSocket> {
+    set presence(presence: JsonObject | null);
     get readyState(): 0 | 1 | 2 | 3;
+    get sessionId(): string;
+    get state(): WebSocketSerializedState;
     constructor(webSocket: WebSocket, config: CloudflareWebSocketConfig);
     addEventListener<TType extends keyof AbstractEventMap>(type: TType, handler: AbstractListener<TType>): void;
     close(code?: number | undefined, reason?: string | undefined): void;
-    initialize(): Promise<() => undefined>;
     send(message: string | ArrayBuffer | ArrayBufferView): void;
     terminate(): void;
 }
 
-declare class CloudflarePlatform<TEnv extends Record<string, any> = {}> extends AbstractPlatform<WebSocket, {
+type CloudflarePlatformConfig<TEnv extends Record<string, any> = {}> = AbstractPlatformConfig<{
     env: TEnv;
 }, {
-    request: Request;
+    state: DurableObjectState;
+}> & {
+    mode?: WebSocketRegistrationMode;
+};
+declare class CloudflarePlatform<TEnv extends Record<string, any> = {}> extends AbstractPlatform<CloudflareWebSocket, {
+    env: TEnv;
+}, {
+    state: DurableObjectState;
 }> {
+    readonly _registrationMode: WebSocketRegistrationMode;
+    constructor(config?: CloudflarePlatformConfig<TEnv>);
+    acceptWebSocket(webSocket: CloudflareWebSocket): Promise<void>;
     convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): CloudflareWebSocket;
+    getLastPing(webSocket: CloudflareWebSocket): number | null;
+    getSerializedState(webSocket: CloudflareWebSocket): WebSocketSerializedState | null;
+    getSessionId(webSocket: WebSocket): string | null;
+    getWebSockets(): readonly WebSocket[];
+    initialize(config: AbstractPlatformConfig<{
+        env: TEnv;
+    }, {
+        state: DurableObjectState;
+    }>): this;
     parseData(data: string | ArrayBuffer): Record<string, any>;
     randomUUID(): string;
+    setSerializedState(webSocket: CloudflareWebSocket, state: WebSocketSerializedState): void;
+    private _getDetachedState;
 }
 
 interface AuthorizeFunctionContext {
@@ -47,8 +69,8 @@ interface CreatePluvHandlerResult<TEnv extends Record<string, any> = {}> {
     handler: ExportedHandler<TEnv>;
 }
 type InferCloudflarePluvHandlerEnv<TPluvServer extends PluvServer<CloudflarePlatform, any, any, any>> = TPluvServer extends PluvServer<CloudflarePlatform<infer IEnv>, any, any, any> ? IEnv : {};
-declare const createPluvHandler: <TPluvServer extends PluvServer<CloudflarePlatform<{}>, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer, Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>) => CreatePluvHandlerResult<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>;
+declare const createPluvHandler: <TPluvServer extends PluvServer<CloudflarePlatform, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer, Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>) => CreatePluvHandlerResult<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>;
 
-declare const platformCloudflare: <TEnv extends Record<string, any> = {}>() => CloudflarePlatform<TEnv>;
+declare const platformCloudflare: <TEnv extends Record<string, any> = {}>(config?: CloudflarePlatformConfig<TEnv>) => CloudflarePlatform<TEnv>;
 
-export { type AuthorizeFunction, type AuthorizeFunctionContext, type CreatePluvHandlerConfig, type CreatePluvHandlerResult, type PluvHandlerFetch, createPluvHandler, platformCloudflare };
+export { type AuthorizeFunction, type AuthorizeFunctionContext, type CloudflarePlatformConfig, type CreatePluvHandlerConfig, type CreatePluvHandlerResult, type PluvHandlerFetch, createPluvHandler, platformCloudflare };

package/dist/index.d.ts

@@ -1,26 +1,48 @@
-import { AbstractWebSocket, AbstractEventMap, AbstractListener, AbstractWebSocketConfig, AbstractPlatform, ConvertWebSocketConfig, PluvServer } from '@pluv/io';
-import { MaybePromise, Maybe, InferIOAuthorizeUser, InferIOAuthorize, InferIOAuthorizeRequired, Id } from '@pluv/types';
+import { AbstractWebSocket, WebSocketSerializedState, AbstractEventMap, AbstractListener, AbstractWebSocketConfig, AbstractPlatformConfig, WebSocketRegistrationMode, AbstractPlatform, ConvertWebSocketConfig, PluvServer } from '@pluv/io';
+import { JsonObject, MaybePromise, Maybe, InferIOAuthorizeUser, InferIOAuthorize, InferIOAuthorizeRequired, Id } from '@pluv/types';
 
 type CloudflareWebSocketConfig = AbstractWebSocketConfig;
-declare class CloudflareWebSocket extends AbstractWebSocket {
-    webSocket: WebSocket;
+declare class CloudflareWebSocket extends AbstractWebSocket<WebSocket> {
+    set presence(presence: JsonObject | null);
     get readyState(): 0 | 1 | 2 | 3;
+    get sessionId(): string;
+    get state(): WebSocketSerializedState;
     constructor(webSocket: WebSocket, config: CloudflareWebSocketConfig);
     addEventListener<TType extends keyof AbstractEventMap>(type: TType, handler: AbstractListener<TType>): void;
     close(code?: number | undefined, reason?: string | undefined): void;
-    initialize(): Promise<() => undefined>;
     send(message: string | ArrayBuffer | ArrayBufferView): void;
     terminate(): void;
 }
 
-declare class CloudflarePlatform<TEnv extends Record<string, any> = {}> extends AbstractPlatform<WebSocket, {
+type CloudflarePlatformConfig<TEnv extends Record<string, any> = {}> = AbstractPlatformConfig<{
     env: TEnv;
 }, {
-    request: Request;
+    state: DurableObjectState;
+}> & {
+    mode?: WebSocketRegistrationMode;
+};
+declare class CloudflarePlatform<TEnv extends Record<string, any> = {}> extends AbstractPlatform<CloudflareWebSocket, {
+    env: TEnv;
+}, {
+    state: DurableObjectState;
 }> {
+    readonly _registrationMode: WebSocketRegistrationMode;
+    constructor(config?: CloudflarePlatformConfig<TEnv>);
+    acceptWebSocket(webSocket: CloudflareWebSocket): Promise<void>;
     convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): CloudflareWebSocket;
+    getLastPing(webSocket: CloudflareWebSocket): number | null;
+    getSerializedState(webSocket: CloudflareWebSocket): WebSocketSerializedState | null;
+    getSessionId(webSocket: WebSocket): string | null;
+    getWebSockets(): readonly WebSocket[];
+    initialize(config: AbstractPlatformConfig<{
+        env: TEnv;
+    }, {
+        state: DurableObjectState;
+    }>): this;
     parseData(data: string | ArrayBuffer): Record<string, any>;
     randomUUID(): string;
+    setSerializedState(webSocket: CloudflareWebSocket, state: WebSocketSerializedState): void;
+    private _getDetachedState;
 }
 
 interface AuthorizeFunctionContext {
@@ -47,8 +69,8 @@ interface CreatePluvHandlerResult<TEnv extends Record<string, any> = {}> {
     handler: ExportedHandler<TEnv>;
 }
 type InferCloudflarePluvHandlerEnv<TPluvServer extends PluvServer<CloudflarePlatform, any, any, any>> = TPluvServer extends PluvServer<CloudflarePlatform<infer IEnv>, any, any, any> ? IEnv : {};
-declare const createPluvHandler: <TPluvServer extends PluvServer<CloudflarePlatform<{}>, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer, Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>) => CreatePluvHandlerResult<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>;
+declare const createPluvHandler: <TPluvServer extends PluvServer<CloudflarePlatform, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer, Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>) => CreatePluvHandlerResult<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>;
 
-declare const platformCloudflare: <TEnv extends Record<string, any> = {}>() => CloudflarePlatform<TEnv>;
+declare const platformCloudflare: <TEnv extends Record<string, any> = {}>(config?: CloudflarePlatformConfig<TEnv>) => CloudflarePlatform<TEnv>;
 
-export { type AuthorizeFunction, type AuthorizeFunctionContext, type CreatePluvHandlerConfig, type CreatePluvHandlerResult, type PluvHandlerFetch, createPluvHandler, platformCloudflare };
+export { type AuthorizeFunction, type AuthorizeFunctionContext, type CloudflarePlatformConfig, type CreatePluvHandlerConfig, type CreatePluvHandlerResult, type PluvHandlerFetch, createPluvHandler, platformCloudflare };

package/dist/index.js

@@ -1,8 +1,25 @@
 "use strict";
 var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -51,14 +68,23 @@ var createPluvHandler = (config) => {
   const { authorize, binding, endpoint = "/api/pluv", modify, io } = config;
   const DurableObject = class {
     constructor(state, env) {
-      this._env = env;
-      this._io = io.getRoom(state.id.toString(), { env });
+      this._room = io.getRoom(state.id.toString(), { env, state });
     }
     webSocketClose(ws, code, reason, wasClean) {
+      if (io._registrationMode !== "detached") return;
+      const handler2 = this._room.onClose(ws);
+      handler2({ code, reason });
     }
     webSocketError(ws, error) {
+      if (io._registrationMode !== "detached") return;
+      const handler2 = this._room.onError(ws);
+      const eventError = error instanceof Error ? error : new Error("Internal Error");
+      handler2({ error: eventError, message: eventError.message });
     }
     webSocketMessage(ws, message) {
+      if (io._registrationMode !== "detached") return;
+      const handler2 = this._room.onMessage(ws);
+      handler2({ data: message });
     }
     fetch(request) {
       return __async(this, null, function* () {
@@ -68,11 +94,7 @@ var createPluvHandler = (config) => {
         }
         const { 0: client, 1: server } = new WebSocketPair();
         const token = new URL(request.url).searchParams.get("token");
-        yield this._io.register(server, {
-          env: this._env,
-          request,
-          token
-        });
+        yield this._room.register(server, { token });
         return new Response(null, { status: 101, webSocket: client });
       });
     }
@@ -154,18 +176,50 @@ var createPluvHandler = (config) => {
 };
 
 // src/CloudflarePlatform.ts
-var import_io2 = require("@pluv/io");
+var import_io3 = require("@pluv/io");
 
 // src/CloudflareWebSocket.ts
 var import_io = require("@pluv/io");
 var CloudflareWebSocket = class extends import_io.AbstractWebSocket {
+  set presence(presence) {
+    const deserialized = this.webSocket.deserializeAttachment();
+    const state = deserialized.state;
+    this.webSocket.serializeAttachment(__spreadProps(__spreadValues({}, this.webSocket.deserializeAttachment()), {
+      state: __spreadProps(__spreadValues({}, state), { presence })
+    }));
+  }
   get readyState() {
     return this.webSocket.readyState;
   }
+  get sessionId() {
+    var _a, _b;
+    const deserialized = (_a = this.webSocket.deserializeAttachment()) != null ? _a : {};
+    const sessionId = (_b = deserialized.sessionId) != null ? _b : crypto.randomUUID();
+    if (typeof deserialized.sessionId !== "string") {
+      this.webSocket.serializeAttachment(__spreadProps(__spreadValues({}, deserialized), { sessionId }));
+    }
+    return sessionId;
+  }
+  get state() {
+    var _a;
+    const deserialized = this.webSocket.deserializeAttachment();
+    const state = (_a = deserialized.state) != null ? _a : null;
+    if (!state) throw new Error("Could not get websocket state");
+    return state;
+  }
   constructor(webSocket, config) {
-    const { room, sessionId, userId } = config;
-    super({ room, sessionId, userId });
-    this.webSocket = webSocket;
+    const { room } = config;
+    super(webSocket, config);
+    const state = {
+      presence: null,
+      quit: false,
+      room,
+      timers: { ping: (/* @__PURE__ */ new Date()).getTime() }
+    };
+    webSocket.serializeAttachment(__spreadValues({
+      sessionId: this.sessionId,
+      state
+    }, webSocket.deserializeAttachment()));
   }
   addEventListener(type, handler) {
     this.webSocket.addEventListener(type, handler);
@@ -175,10 +229,6 @@ var CloudflareWebSocket = class extends import_io.AbstractWebSocket {
     if (!canClose) return;
     this.webSocket.close(code, reason);
   }
-  initialize() {
-    this.webSocket.accept();
-    return Promise.resolve(() => void 0);
-  }
   send(message) {
     if (this.readyState !== this.OPEN) return;
     this.webSocket.send(message);
@@ -188,10 +238,169 @@ var CloudflareWebSocket = class extends import_io.AbstractWebSocket {
   }
 };
 
+// src/PersistanceCloudflare.ts
+var import_io2 = require("@pluv/io");
+
+// src/utils/partitionByLength.ts
+var partitionByLength = (arr, length) => {
+  if (!arr.length) return [];
+  const head = arr.slice(0, length);
+  const tail = arr.slice(length);
+  return [head, ...partitionByLength(tail, length)];
+};
+
+// src/PersistanceCloudflare.ts
+var CLOUDFLARE_DELETE_BATCH_LIMIT = 128;
+var STORAGE_PREFIX = "$PLUV_STORAGE;";
+var USER_PREFIX = "$PLUV_USER";
+var PersistanceCloudflare = class extends import_io2.AbstractPersistance {
+  constructor(config) {
+    super();
+    const { state } = config;
+    this._state = state;
+  }
+  addUser(room, connectionId, user) {
+    return __async(this, null, function* () {
+      yield this._state.storage.put(this._getUserKey(room, connectionId), user);
+    });
+  }
+  deleteStorageState(room) {
+    return __async(this, null, function* () {
+      yield this._state.storage.delete(this._getStorageKey(room));
+    });
+  }
+  deleteUser(room, connectionId) {
+    return __async(this, null, function* () {
+      yield this._state.storage.delete(this._getUserKey(room, connectionId));
+    });
+  }
+  deleteUsers(room) {
+    return __async(this, null, function* () {
+      const map = yield this._state.storage.list({
+        allowConcurrency: true,
+        noCache: true,
+        prefix: USER_PREFIX
+      });
+      const partitions = partitionByLength(Array.from(map.keys()), CLOUDFLARE_DELETE_BATCH_LIMIT);
+      yield this._state.storage.transaction((tx) => __async(this, null, function* () {
+        yield partitions.reduce((promise, partition) => __async(this, null, function* () {
+          return yield promise.then(() => __async(this, null, function* () {
+            yield tx.delete(partition);
+          }));
+        }), Promise.resolve());
+      }));
+    });
+  }
+  getSize(room) {
+    return __async(this, null, function* () {
+      const storage = yield this._state.storage.list({ prefix: USER_PREFIX });
+      return storage.size;
+    });
+  }
+  getStorageState(room) {
+    return __async(this, null, function* () {
+      const storage = yield this._state.storage.get(this._getStorageKey(room));
+      return storage != null ? storage : null;
+    });
+  }
+  getUser(room, connectionId) {
+    return __async(this, null, function* () {
+      const user = yield this._state.storage.get(this._getUserKey(room, connectionId));
+      return user != null ? user : null;
+    });
+  }
+  getUsers(room) {
+    return __async(this, null, function* () {
+      const storage = yield this._state.storage.list({
+        prefix: USER_PREFIX
+      });
+      return Array.from(storage.values());
+    });
+  }
+  setStorageState(room, state) {
+    return __async(this, null, function* () {
+      yield this._state.storage.put(this._getStorageKey(room), state, {
+        allowConcurrency: true
+      });
+    });
+  }
+  _getStorageKey(room) {
+    return `${STORAGE_PREFIX}::${room}`;
+  }
+  _getUserKey(room, connectionId) {
+    return `${USER_PREFIX}::${room}::${connectionId}`;
+  }
+};
+
+// src/constants.ts
+var DEFAULT_REGISTRATION_MODE = "detached";
+
 // src/CloudflarePlatform.ts
-var CloudflarePlatform = class extends import_io2.AbstractPlatform {
+var CloudflarePlatform = class _CloudflarePlatform extends import_io3.AbstractPlatform {
+  constructor(config = {}) {
+    var _a;
+    super(__spreadValues(__spreadValues({}, config), config.context && config.mode === "detached" ? { persistance: new PersistanceCloudflare(config.context) } : {}));
+    this._registrationMode = (_a = config.mode) != null ? _a : DEFAULT_REGISTRATION_MODE;
+    const detachedState = this._getDetachedState();
+    if (!detachedState) return;
+    detachedState.setWebSocketAutoResponse(
+      new WebSocketRequestResponsePair('{"type":"$PING","data":{}}', JSON.stringify({ type: "$PONG", data: {} }))
+    );
+  }
+  acceptWebSocket(webSocket) {
+    return __async(this, null, function* () {
+      const detachedState = this._getDetachedState();
+      if (!detachedState) {
+        webSocket.webSocket.accept();
+        return;
+      }
+      detachedState.acceptWebSocket(webSocket.webSocket);
+    });
+  }
   convertWebSocket(webSocket, config) {
-    return new CloudflareWebSocket(webSocket, config);
+    const { room } = config;
+    return new CloudflareWebSocket(webSocket, { persistance: this.persistance, room });
+  }
+  getLastPing(webSocket) {
+    var _a;
+    const detachedState = this._getDetachedState();
+    if (!detachedState) return null;
+    const timestamp = detachedState.getWebSocketAutoResponseTimestamp(webSocket.webSocket);
+    return (_a = timestamp == null ? void 0 : timestamp.getTime()) != null ? _a : null;
+  }
+  getSerializedState(webSocket) {
+    var _a;
+    const deserialized = webSocket.webSocket.deserializeAttachment();
+    return (_a = deserialized == null ? void 0 : deserialized.state) != null ? _a : null;
+  }
+  getSessionId(webSocket) {
+    var _a;
+    const deserialized = (_a = webSocket.deserializeAttachment()) != null ? _a : {};
+    const sessionId = deserialized.sessionId;
+    if (typeof sessionId !== "string") {
+      throw new Error("This websocket was not registered");
+    }
+    return sessionId;
+  }
+  getWebSockets() {
+    var _a;
+    const detachedState = this._getDetachedState();
+    if (!detachedState) return [];
+    return (_a = detachedState.getWebSockets()) != null ? _a : [];
+  }
+  initialize(config) {
+    var _a;
+    const context = (_a = config.context) != null ? _a : __spreadValues(__spreadValues({}, this._ioContext), this._roomContext);
+    if (!context.env || !context.state) {
+      throw new Error("Could not derive platform context");
+    }
+    return new _CloudflarePlatform(__spreadProps(__spreadValues({
+      mode: this._registrationMode,
+      persistance: this.persistance,
+      pubSub: this.pubSub
+    }, config), {
+      context: { env: context.env, state: context.state }
+    }))._initialize();
   }
   parseData(data) {
     if (typeof data === "string") return JSON.parse(data);
@@ -201,11 +410,21 @@ var CloudflarePlatform = class extends import_io2.AbstractPlatform {
   randomUUID() {
     return crypto.randomUUID();
   }
+  setSerializedState(webSocket, state) {
+    var _a;
+    const deserialized = (_a = webSocket.webSocket.deserializeAttachment()) != null ? _a : {};
+    webSocket.webSocket.serializeAttachment(__spreadProps(__spreadValues({}, deserialized), { state }));
+  }
+  _getDetachedState() {
+    var _a, _b;
+    if (this._registrationMode !== "detached") return null;
+    return (_b = (_a = this._roomContext) == null ? void 0 : _a.state) != null ? _b : null;
+  }
 };
 
 // src/platformCloudflare.ts
-var platformCloudflare = () => {
-  return new CloudflarePlatform();
+var platformCloudflare = (config = {}) => {
+  return new CloudflarePlatform(config);
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {