@pluv/platform-cloudflare 0.0.0-canary-20261027022227

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Shoubhit Dash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+## `@pluv/platform-cloudflare`
+
+> Enables [@pluv/io](https://www.npmjs.com/package/@pluv/io) to run on [Cloudflare Workers](https://workers.cloudflare.com/).
+
+**👉 See full documentation on [docs.pluv.io](https://docs.pluv.io/docs). 👈**
+
+## Installation
+
+```bash
+# npm
+npm install @pluv/platform-cloudflare
+
+# yarn
+yarn add @pluv/platform-cloudflare
+
+# pnpm
+pnpm add @pluv/platform-cloudflare
+```

package/dist/index.d.mts

@@ -0,0 +1,60 @@
+import { AbstractEventMap, AbstractListener, AbstractPlatform, AbstractPlatformConfig, AbstractWebSocket, AbstractWebSocketConfig, ConvertWebSocketConfig, WebSocketSerializedState, WebSocketSession } from "@pluv/io";
+import { BaseUser, Id, Json, JsonObject } from "@pluv/types";
+type CloudflareWebSocketConfig = AbstractWebSocketConfig;
+declare class CloudflareWebSocket extends AbstractWebSocket<WebSocket> {
+  set presence(presence: JsonObject | null);
+  get readyState(): 0 | 1 | 2 | 3;
+  get session(): WebSocketSession<any>;
+  get sessionId(): string;
+  get state(): WebSocketSerializedState;
+  set state(state: WebSocketSerializedState);
+  get user(): BaseUser | null;
+  set user(user: BaseUser);
+  constructor(webSocket: WebSocket, config: CloudflareWebSocketConfig);
+  addEventListener<TType extends keyof AbstractEventMap>(type: TType, handler: AbstractListener<TType>): void;
+  close(code?: number, reason?: string): void;
+  send(message: string | ArrayBuffer | ArrayBufferView): void;
+  terminate(code?: number): void;
+}
+type CloudflarePlatformRoomContext<TEnv extends Record<string, any>, TMeta extends Record<string, Json>> = {
+  env: TEnv;
+  state: DurableObjectState;
+} & (keyof TMeta extends never ? {
+  meta?: undefined;
+} : {
+  meta: TMeta;
+});
+type CloudflarePlatformConfig<TEnv extends Record<string, any> = {}, TMeta extends Record<string, Json> = {}> = AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>>;
+declare class CloudflarePlatform<TEnv extends Record<string, any> = {}, TMeta extends Record<string, Json> = {}> extends AbstractPlatform<CloudflareWebSocket, {
+  env: TEnv;
+  request: Request;
+}, CloudflarePlatformRoomContext<TEnv, TMeta>> {
+  readonly id: string;
+  readonly _name = "platformCloudflare";
+  private readonly _persistenceProvided;
+  constructor(config: CloudflarePlatformConfig<TEnv, TMeta>);
+  acceptWebSocket(webSocket: CloudflareWebSocket): Promise<void>;
+  convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): CloudflareWebSocket;
+  getLastPing(webSocket: CloudflareWebSocket): number | null;
+  getSerializedState(webSocket: WebSocket): WebSocketSerializedState | null;
+  getSessionId(webSocket: WebSocket): string | null;
+  getWebSockets(): readonly WebSocket[];
+  initialize(config: AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>>): this;
+  parseData(data: string | ArrayBuffer): Record<string, any>;
+  randomUUID(): string;
+  setSerializedState(webSocket: CloudflareWebSocket, state: WebSocketSerializedState): WebSocketSerializedState;
+  keepAlive(promise: Promise<unknown>): void;
+  private _getDurableObjectState;
+}
+declare const identity: <T extends unknown>(x: T) => T;
+type InferCallback<TEnv extends Record<string, any> = {}, TMeta extends Record<string, Json> = {}> = (i: typeof identity) => {
+  env?: (io: TEnv) => TEnv;
+  meta?: (io: TMeta) => TMeta;
+};
+export declare const infer: <TEnv extends Record<string, any> = {}, TMeta extends Record<string, Json> = {}>(callback: InferCallback<TEnv, TMeta>) => InferCallback<TEnv, TMeta>;
+type PlatformCloudflareParams<TEnv extends Record<string, any> = {}, TMeta extends Record<string, Json> = {}> = Id<CloudflarePlatformConfig<TEnv, TMeta> & {
+  types?: InferCallback<TEnv, TMeta>;
+}>;
+export declare const platformCloudflare: <TEnv extends Record<string, any> = {}, TMeta extends Record<string, Json> = {}>(config?: PlatformCloudflareParams<TEnv, TMeta>) => (() => CloudflarePlatform<TEnv, TMeta>);
+export type { CloudflarePlatform, CloudflarePlatformConfig, InferCallback, PlatformCloudflareParams };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/CloudflareWebSocket.ts","../src/CloudflarePlatform.ts","../src/utils/identity.ts","../src/infer.ts","../src/platformCloudflare.ts"],"mappings":";;KAUY,4BAA4B;cAE3B,4BAA4B,kBAAkB;MAC5C,SAAS,UAAU;MAUnB;MAIA,WAAW;MAkBX;MAWA,SAAS;MAoBT,MAAM,OAAO;MAMb,QAAQ;MAOR,KAAK,MAAM;EAMtB,YAAY,WAAW,WAAW,QAAQ;EAuBnC,iBAAiB,oBAAoB,kBACxC,MAAM,OACN,SAAS,iBAAiB;EAOvB,MAAM,eAAe;EAUrB,KAAK,kBAAkB,cAAc;EAMrC,UAAU;;KCrIT,8BACR,aAAa,qBACb,cAAc,eAAe;EAE7B,KAAK;EACL,OAAO;WACA;EAAwB;;EAAuB,MAAM;;KAEpD,yBACR,aAAa,0BACb,cAAc,eAAe,cAC7B,uBAAuB,8BAA8B,MAAM;cAElD,mBACT,aAAa,0BACb,cAAc,eAAe,oBACvB,iBACN;EACE,KAAK;EAAM,SAAS;GACtB,8BAA8B,MAAM;WAEpB;WACA;mBAEC;EAEjB,YAAY,QAAQ,yBAAyB,MAAM;EAyBtC,gBAAgB,WAAW,sBAAsB;EAYvD,iBACH,WAAW,WACX,QAAQ,yBACT;EAUI,YAAY,WAAW;EAUvB,mBAAmB,WAAW,YAAY;EAM1C,aAAa,WAAW;EASxB,0BAA0B;EAU1B,WACH,QAAQ,uBAAuB,8BAA8B,MAAM;EAyBhE,UAAU,eAAe,cAAc;EAQvC;EAIA,mBACH,WAAW,qBACX,OAAO,2BACR;EAQa,UAAU,SAAS;UAK3B;;cC/KC,WAAY,mBAAiB,GAAK,MAAI;KCGvC,cACR,aAAa,0BACb,cAAc,eAAe,eAC5B,UAAU;EACX,OAAO,IAAI,SAAS;EACpB,QAAQ,IAAI,UAAU;;qBAGb,QACT,aAAa,0BACb,cAAc,eAAe,YAAU,UAE7B,cAAc,MAAM,WAAM,cAAA,MAAA;KCV5B,yBACR,aAAa,0BACb,cAAc,eAAe,cAC7B,GACA,yBAAyB,MAAM;EAC3B,QAAQ,cAAc,MAAM;;qBAIvB,qBACT,aAAa,0BACb,cAAc,eAAe,YAAU,SAE/B,yBAAyB,MAAM,kBACjC,mBAAmB,MAAM"}

package/dist/index.mjs

@@ -0,0 +1,200 @@
+import { AbstractPlatform, AbstractWebSocket } from "@pluv/io";
+import { PersistenceCloudflareTransactionalStorage } from "@pluv/persistence-cloudflare-transactional-storage";
+// src/infer.ts
+const infer = (callback) => callback;
+// src/CloudflareWebSocket.ts
+var CloudflareWebSocket = class extends AbstractWebSocket {
+	set presence(presence) {
+		const state = this.webSocket.deserializeAttachment().state;
+		this.webSocket.serializeAttachment({
+			...this.webSocket.deserializeAttachment(),
+			state: {
+				...state,
+				presence
+			}
+		});
+	}
+	get readyState() {
+		return this.webSocket.readyState;
+	}
+	get session() {
+		const sessionId = this.webSocket.deserializeAttachment().sessionId;
+		const state = this.state;
+		const user = this.user;
+		if (!user) throw new Error("WebSocket is not authorized");
+		return {
+			...state,
+			id: sessionId,
+			user,
+			webSocket: this
+		};
+	}
+	get sessionId() {
+		const deserialized = this.webSocket.deserializeAttachment() ?? {};
+		const sessionId = deserialized.sessionId ?? `p_${crypto.randomUUID()}`;
+		if (typeof deserialized.sessionId !== "string") this.webSocket.serializeAttachment({
+			...deserialized,
+			sessionId
+		});
+		return sessionId;
+	}
+	get state() {
+		const state = this.webSocket.deserializeAttachment()?.state ?? null;
+		if (!state) throw new Error("Could not get websocket state");
+		const currentPing = state.timers.ping;
+		const lastPing = this._platform.getLastPing(this);
+		if (!lastPing) return state;
+		if (currentPing >= lastPing) return state;
+		const newState = {
+			...state,
+			timers: {
+				...state.timers,
+				ping: lastPing
+			}
+		};
+		return this._platform.setSerializedState(this, newState);
+	}
+	set state(state) {
+		const deserialized = this.webSocket.deserializeAttachment();
+		this.webSocket.serializeAttachment({
+			...deserialized,
+			state
+		});
+	}
+	get user() {
+		return this.webSocket.deserializeAttachment()?.user ?? null;
+	}
+	set user(user) {
+		const deserialized = this.webSocket.deserializeAttachment();
+		this.webSocket.serializeAttachment({
+			...deserialized,
+			user
+		});
+	}
+	constructor(webSocket, config) {
+		const { room } = config;
+		super(webSocket, config);
+		const state = {
+			kind: "user",
+			operator: null,
+			presence: null,
+			quit: false,
+			room,
+			seq: { presence: null },
+			timers: { ping: (/* @__PURE__ */ new Date()).getTime() }
+		};
+		webSocket.serializeAttachment({
+			state,
+			...webSocket.deserializeAttachment()
+		});
+	}
+	addEventListener(type, handler) {
+		throw new Error("Cloudflare WebSockets use hibernation handlers (webSocketMessage/Close/Error), not addEventListener");
+	}
+	close(code, reason) {
+		if (![this.CONNECTING, this.OPEN].some((readyState) => readyState === this.readyState)) return;
+		this.webSocket.close(code, reason);
+	}
+	send(message) {
+		if (this.readyState !== this.OPEN) return;
+		this.webSocket.send(message);
+	}
+	terminate(code = 1011) {
+		return this.webSocket.close(code, "Terminated");
+	}
+};
+// src/CloudflarePlatform.ts
+var CloudflarePlatform = class CloudflarePlatform extends AbstractPlatform {
+	id = crypto.randomUUID();
+	_name = "platformCloudflare";
+	_persistenceProvided;
+	constructor(config) {
+		super({
+			...config,
+			...config.roomContext ? { persistence: config.persistence ?? new PersistenceCloudflareTransactionalStorage() } : {}
+		});
+		this._persistenceProvided = !!config.persistence;
+		const state = this._getDurableObjectState();
+		if (!state) return;
+		state.setWebSocketAutoResponse(new WebSocketRequestResponsePair("{\"type\":\"$ping\",\"data\":{}}", JSON.stringify({
+			type: "$pong",
+			data: {}
+		})));
+	}
+	async acceptWebSocket(webSocket) {
+		const state = this._getDurableObjectState();
+		if (!state) throw new Error("Cloudflare platform requires DurableObjectState for WebSocket hibernation");
+		state.acceptWebSocket(webSocket.webSocket);
+	}
+	convertWebSocket(webSocket, config) {
+		const { room } = config;
+		return new CloudflareWebSocket(webSocket, {
+			persistence: this.persistence,
+			platform: this,
+			room
+		});
+	}
+	getLastPing(webSocket) {
+		const state = this._getDurableObjectState();
+		if (!state) return null;
+		return state.getWebSocketAutoResponseTimestamp(webSocket.webSocket)?.getTime() ?? null;
+	}
+	getSerializedState(webSocket) {
+		return webSocket.deserializeAttachment()?.state ?? null;
+	}
+	getSessionId(webSocket) {
+		const sessionId = (webSocket.deserializeAttachment() ?? {}).sessionId;
+		if (typeof sessionId !== "string") return null;
+		return sessionId;
+	}
+	getWebSockets() {
+		const state = this._getDurableObjectState();
+		if (!state) return [];
+		return state.getWebSockets() ?? [];
+	}
+	initialize(config) {
+		const ctx = config.roomContext ?? { ...this._roomContext };
+		if (!ctx.env || !ctx.state) throw new Error("Could not derive platform roomContext");
+		const roomContext = {
+			env: ctx.env,
+			meta: ctx.meta,
+			state: ctx.state
+		};
+		const persistence = (this._persistenceProvided ? this.persistence : new PersistenceCloudflareTransactionalStorage()).initialize(roomContext);
+		return new CloudflarePlatform({
+			roomContext,
+			persistence,
+			pubSub: this.pubSub
+		})._initialize();
+	}
+	parseData(data) {
+		if (typeof data === "string") return JSON.parse(data);
+		const decoder = new TextDecoder("utf8");
+		return JSON.parse(decoder.decode(data));
+	}
+	randomUUID() {
+		return crypto.randomUUID();
+	}
+	setSerializedState(webSocket, state) {
+		const deserialized = webSocket.webSocket.deserializeAttachment() ?? {};
+		webSocket.webSocket.serializeAttachment({
+			...deserialized,
+			state
+		});
+		return state;
+	}
+	keepAlive(promise) {
+		super.keepAlive(promise);
+		this._getDurableObjectState()?.waitUntil(promise);
+	}
+	_getDurableObjectState() {
+		return this._roomContext?.state ?? null;
+	}
+};
+// src/platformCloudflare.ts
+const platformCloudflare = (config = {}) => {
+	return () => new CloudflarePlatform(config);
+};
+export { infer, platformCloudflare };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/infer.ts","../src/CloudflareWebSocket.ts","../src/CloudflarePlatform.ts","../src/platformCloudflare.ts"],"sourcesContent":["import type { Json } from \"@pluv/types\";\nimport type { identity } from \"./utils\";\n\nexport type InferCallback<\n    TEnv extends Record<string, any> = {},\n    TMeta extends Record<string, Json> = {},\n> = (i: typeof identity) => {\n    env?: (io: TEnv) => TEnv;\n    meta?: (io: TMeta) => TMeta;\n};\n\nexport const infer = <\n    TEnv extends Record<string, any> = {},\n    TMeta extends Record<string, Json> = {},\n>(\n    callback: InferCallback<TEnv, TMeta>,\n) => callback;\n","import type {\n    AbstractEventMap,\n    AbstractListener,\n    AbstractWebSocketConfig,\n    WebSocketSerializedState,\n    WebSocketSession,\n} from \"@pluv/io\";\nimport { AbstractWebSocket } from \"@pluv/io\";\nimport type { BaseUser, JsonObject } from \"@pluv/types\";\n\nexport type CloudflareWebSocketConfig = AbstractWebSocketConfig;\n\nexport class CloudflareWebSocket extends AbstractWebSocket<WebSocket> {\n    public set presence(presence: JsonObject | null) {\n        const deserialized = this.webSocket.deserializeAttachment();\n        const state = deserialized.state;\n\n        this.webSocket.serializeAttachment({\n            ...this.webSocket.deserializeAttachment(),\n            state: { ...state, presence },\n        });\n    }\n\n    public get readyState(): 0 | 1 | 2 | 3 {\n        return this.webSocket.readyState as 0 | 1 | 2 | 3;\n    }\n\n    public get session(): WebSocketSession<any> {\n        const deserialized = this.webSocket.deserializeAttachment();\n        const sessionId = deserialized.sessionId as string;\n        const state = this.state;\n        const user = this.user;\n\n        if (!user) {\n            throw new Error(\"WebSocket is not authorized\");\n        }\n\n        return {\n            ...state,\n            id: sessionId,\n            user,\n            webSocket: this,\n        };\n    }\n\n    public get sessionId(): string {\n        const deserialized = this.webSocket.deserializeAttachment() ?? {};\n        const sessionId = deserialized.sessionId ?? `p_${crypto.randomUUID()}`;\n\n        if (typeof deserialized.sessionId !== \"string\") {\n            this.webSocket.serializeAttachment({ ...deserialized, sessionId });\n        }\n\n        return sessionId;\n    }\n\n    public get state(): WebSocketSerializedState {\n        const deserialized = this.webSocket.deserializeAttachment();\n        const state = deserialized?.state ?? null;\n\n        if (!state) throw new Error(\"Could not get websocket state\");\n\n        const currentPing = state.timers.ping;\n        const lastPing = this._platform.getLastPing(this);\n\n        if (!lastPing) return state;\n        if (currentPing >= lastPing) return state;\n\n        const newState: WebSocketSerializedState = {\n            ...state,\n            timers: { ...state.timers, ping: lastPing },\n        };\n\n        return this._platform.setSerializedState(this, newState);\n    }\n\n    public set state(state: WebSocketSerializedState) {\n        const deserialized = this.webSocket.deserializeAttachment();\n\n        this.webSocket.serializeAttachment({ ...deserialized, state });\n    }\n\n    public get user(): BaseUser | null {\n        const deserialized = this.webSocket.deserializeAttachment();\n        const user = deserialized?.user as BaseUser | null | undefined;\n\n        return user ?? null;\n    }\n\n    public set user(user: BaseUser) {\n        const deserialized = this.webSocket.deserializeAttachment();\n\n        this.webSocket.serializeAttachment({ ...deserialized, user });\n    }\n\n    constructor(webSocket: WebSocket, config: CloudflareWebSocketConfig) {\n        const { room } = config;\n\n        super(webSocket, config);\n\n        const state: WebSocketSerializedState = {\n            kind: \"user\",\n            operator: null,\n            presence: null,\n            quit: false,\n            room,\n            seq: { presence: null },\n            timers: {\n                ping: new Date().getTime(),\n            },\n        };\n\n        webSocket.serializeAttachment({\n            state,\n            ...webSocket.deserializeAttachment(),\n        });\n    }\n\n    public addEventListener<TType extends keyof AbstractEventMap>(\n        type: TType,\n        handler: AbstractListener<TType>,\n    ): void {\n        throw new Error(\n            \"Cloudflare WebSockets use hibernation handlers (webSocketMessage/Close/Error), not addEventListener\",\n        );\n    }\n\n    public close(code?: number, reason?: string): void {\n        const canClose = [this.CONNECTING, this.OPEN].some(\n            (readyState) => readyState === this.readyState,\n        );\n\n        if (!canClose) return;\n\n        this.webSocket.close(code, reason);\n    }\n\n    public send(message: string | ArrayBuffer | ArrayBufferView): void {\n        if (this.readyState !== this.OPEN) return;\n\n        this.webSocket.send(message);\n    }\n\n    public terminate(code: number = 1011): void {\n        return this.webSocket.close(code, \"Terminated\");\n    }\n}\n","import type {\n    AbstractPlatformConfig,\n    ConvertWebSocketConfig,\n    WebSocketSerializedState,\n} from \"@pluv/io\";\nimport { AbstractPlatform } from \"@pluv/io\";\nimport { PersistenceCloudflareTransactionalStorage } from \"@pluv/persistence-cloudflare-transactional-storage\";\nimport type { Json } from \"@pluv/types\";\nimport { CloudflareWebSocket } from \"./CloudflareWebSocket\";\n\nexport type CloudflarePlatformRoomContext<\n    TEnv extends Record<string, any>,\n    TMeta extends Record<string, Json>,\n> = {\n    env: TEnv;\n    state: DurableObjectState;\n} & (keyof TMeta extends never ? { meta?: undefined } : { meta: TMeta });\n\nexport type CloudflarePlatformConfig<\n    TEnv extends Record<string, any> = {},\n    TMeta extends Record<string, Json> = {},\n> = AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>>;\n\nexport class CloudflarePlatform<\n    TEnv extends Record<string, any> = {},\n    TMeta extends Record<string, Json> = {},\n> extends AbstractPlatform<\n    CloudflareWebSocket,\n    { env: TEnv; request: Request },\n    CloudflarePlatformRoomContext<TEnv, TMeta>\n> {\n    public readonly id = crypto.randomUUID();\n    public readonly _name = \"platformCloudflare\";\n\n    private readonly _persistenceProvided: boolean;\n\n    constructor(config: CloudflarePlatformConfig<TEnv, TMeta>) {\n        super({\n            ...config,\n            ...(config.roomContext\n                ? {\n                      persistence:\n                          config.persistence ?? new PersistenceCloudflareTransactionalStorage(),\n                  }\n                : {}),\n        });\n\n        this._persistenceProvided = !!config.persistence;\n\n        const state = this._getDurableObjectState();\n\n        if (!state) return;\n\n        state.setWebSocketAutoResponse(\n            new WebSocketRequestResponsePair(\n                '{\"type\":\"$ping\",\"data\":{}}',\n                JSON.stringify({ type: \"$pong\", data: {} }),\n            ),\n        );\n    }\n\n    public async acceptWebSocket(webSocket: CloudflareWebSocket): Promise<void> {\n        const state = this._getDurableObjectState();\n\n        if (!state) {\n            throw new Error(\n                \"Cloudflare platform requires DurableObjectState for WebSocket hibernation\",\n            );\n        }\n\n        state.acceptWebSocket(webSocket.webSocket);\n    }\n\n    public convertWebSocket(\n        webSocket: WebSocket,\n        config: ConvertWebSocketConfig,\n    ): CloudflareWebSocket {\n        const { room } = config;\n\n        return new CloudflareWebSocket(webSocket, {\n            persistence: this.persistence,\n            platform: this,\n            room,\n        });\n    }\n\n    public getLastPing(webSocket: CloudflareWebSocket): number | null {\n        const state = this._getDurableObjectState();\n\n        if (!state) return null;\n\n        const timestamp = state.getWebSocketAutoResponseTimestamp(webSocket.webSocket);\n\n        return timestamp?.getTime() ?? null;\n    }\n\n    public getSerializedState(webSocket: WebSocket): WebSocketSerializedState | null {\n        const deserialized = webSocket.deserializeAttachment();\n\n        return deserialized?.state ?? null;\n    }\n\n    public getSessionId(webSocket: WebSocket): string | null {\n        const deserialized = webSocket.deserializeAttachment() ?? {};\n        const sessionId = deserialized.sessionId;\n\n        if (typeof sessionId !== \"string\") return null;\n\n        return sessionId;\n    }\n\n    public getWebSockets(): readonly WebSocket[] {\n        const state = this._getDurableObjectState();\n\n        if (!state) return [];\n\n        const webSockets = state.getWebSockets() ?? [];\n\n        return webSockets;\n    }\n\n    public initialize(\n        config: AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>>,\n    ): this {\n        const ctx = config.roomContext ?? { ...this._roomContext };\n\n        if (!ctx.env || !ctx.state) throw new Error(\"Could not derive platform roomContext\");\n\n        const roomContext = {\n            env: ctx.env,\n            meta: ctx.meta,\n            state: ctx.state,\n        } as CloudflarePlatformRoomContext<TEnv, TMeta>;\n\n        const persistence = (\n            this._persistenceProvided\n                ? this.persistence\n                : new PersistenceCloudflareTransactionalStorage()\n        ).initialize(roomContext);\n\n        return new CloudflarePlatform<TEnv, TMeta>({\n            roomContext,\n            persistence,\n            pubSub: this.pubSub,\n        })._initialize() as this;\n    }\n\n    public parseData(data: string | ArrayBuffer): Record<string, any> {\n        if (typeof data === \"string\") return JSON.parse(data);\n\n        const decoder = new TextDecoder(\"utf8\");\n\n        return JSON.parse(decoder.decode(data));\n    }\n\n    public randomUUID(): string {\n        return crypto.randomUUID();\n    }\n\n    public setSerializedState(\n        webSocket: CloudflareWebSocket,\n        state: WebSocketSerializedState,\n    ): WebSocketSerializedState {\n        const deserialized = webSocket.webSocket.deserializeAttachment() ?? {};\n\n        webSocket.webSocket.serializeAttachment({ ...deserialized, state });\n\n        return state;\n    }\n\n    public override keepAlive(promise: Promise<unknown>): void {\n        super.keepAlive(promise);\n        this._getDurableObjectState()?.waitUntil(promise);\n    }\n\n    private _getDurableObjectState(): DurableObjectState | null {\n        return this._roomContext?.state ?? null;\n    }\n}\n","import type { Id, Json } from \"@pluv/types\";\nimport type { CloudflarePlatformConfig } from \"./CloudflarePlatform\";\nimport { CloudflarePlatform } from \"./CloudflarePlatform\";\nimport type { InferCallback } from \"./infer\";\n\nexport type PlatformCloudflareParams<\n    TEnv extends Record<string, any> = {},\n    TMeta extends Record<string, Json> = {},\n> = Id<\n    CloudflarePlatformConfig<TEnv, TMeta> & {\n        types?: InferCallback<TEnv, TMeta>;\n    }\n>;\n\nexport const platformCloudflare = <\n    TEnv extends Record<string, any> = {},\n    TMeta extends Record<string, Json> = {},\n>(\n    config: PlatformCloudflareParams<TEnv, TMeta> = {} as PlatformCloudflareParams<TEnv, TMeta>,\n): (() => CloudflarePlatform<TEnv, TMeta>) => {\n    return () => new CloudflarePlatform<TEnv, TMeta>(config);\n};\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@pluv/platform-cloudflare",
+  "version": "0.0.0-canary-20261027022227",
+  "description": "@pluv/io adapter for cloudflare workers",
+  "author": {
+    "email": "david@pluv.io",
+    "name": "i3dly",
+    "url": "https://github.com/i3dly"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/pluv-io/pluv",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pluv-io/pluv.git",
+    "directory": "packages/platform-cloudflare"
+  },
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pluv/crdt": "^0.0.0-canary-20261027022227",
+    "@pluv/io": "^0.0.0-canary-20261027022227",
+    "@pluv/persistence-cloudflare-transactional-storage": "^0.0.0-canary-20261027022227",
+    "@pluv/types": "^0.0.0-canary-20261027022227",
+    "path-to-regexp": "^9.0.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^5.20261025.1",
+    "@pluv/tsconfig": "^0.0.0-canary-20261027022227",
+    "tsdown": "^0.23.2",
+    "typescript": "7.1.0-beta"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./*": "./*"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
+  }
+}