@pluv/platform-cloudflare 0.44.2 → 1.0.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/platform-cloudflare@0.44.2 build /home/runner/work/pluv/pluv/packages/platform-cloudflare
+> @pluv/platform-cloudflare@1.0.1 build /home/runner/work/pluv/pluv/packages/platform-cloudflare
 > tsup src/index.ts
 
 CLI Building entry: src/index.ts
@@ -8,8 +8,8 @@
 CLI Using tsup config: /home/runner/work/pluv/pluv/packages/platform-cloudflare/tsup.config.ts
 CLI Target: es6
 ESM Build start
-ESM dist/index.mjs 13.91 KB
-ESM ⚡️ Build success in 49ms
+ESM dist/index.mjs 14.01 KB
+ESM ⚡️ Build success in 24ms
 DTS Build start
-DTS ⚡️ Build success in 1191ms
+DTS ⚡️ Build success in 1051ms
 DTS dist/index.d.mts 7.31 KB

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @pluv/platform-cloudflare
 
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies [c583be9]
+  - @pluv/io@1.0.1
+  - @pluv/persistence-cloudflare-transactional-storage@1.0.1
+  - @pluv/types@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- af94706: pluv.io is now stable and production ready!
+
+  With this v1 release, pluv.io will now follow [semantic versioning](https://semver.org/) with more comprehensive release notes for future changes to the library.
+
+  Checkout the [full documentation here](https://pluv.io/docs/introduction) to get started today!
+
+### Patch Changes
+
+- Updated dependencies [af94706]
+  - @pluv/io@1.0.0
+  - @pluv/persistence-cloudflare-transactional-storage@1.0.0
+  - @pluv/types@1.0.0
+
 ## 0.44.2
 
 ### Patch Changes

package/dist/index.mjs

@@ -83,7 +83,8 @@ var createPluvHandler = (config) => {
         const { 0: client, 1: server } = new WebSocketPair();
         const token = new URL(request.url).searchParams.get("token");
         const alarm = yield this.ctx.storage.getAlarm();
-        if (alarm !== null) yield this.ctx.storage.setAlarm(Date.now() + GARBAGE_COLLECT_INTERVAL_MS);
+        if (alarm !== null)
+          yield this.ctx.storage.setAlarm(Date.now() + GARBAGE_COLLECT_INTERVAL_MS);
         yield this._room.register(server, { env: this.env, request, token });
         return new Response(null, { status: 101, webSocket: client });
       });
@@ -116,7 +117,11 @@ var createPluvHandler = (config) => {
       });
     }
     try {
-      const user = yield authorize({ env, request, room });
+      const user = yield authorize({
+        env,
+        request,
+        room
+      });
       if (!user) throw new Error();
       const namespace = getDurableObjectNamespace(env);
       const durableObjectId = namespace.idFromName(room);
@@ -257,7 +262,9 @@ var CloudflareWebSocket = class extends AbstractWebSocket {
     this.webSocket.addEventListener(type, handler);
   }
   close(code, reason) {
-    const canClose = [this.CONNECTING, this.OPEN].some((readyState) => readyState === this.readyState);
+    const canClose = [this.CONNECTING, this.OPEN].some(
+      (readyState) => readyState === this.readyState
+    );
     if (!canClose) return;
     this.webSocket.close(code, reason);
   }
@@ -295,7 +302,10 @@ var CloudflarePlatform = class _CloudflarePlatform extends AbstractPlatform {
     const detachedState = this._getDetachedState();
     if (!detachedState) return;
     detachedState.setWebSocketAutoResponse(
-      new WebSocketRequestResponsePair('{"type":"$ping","data":{}}', JSON.stringify({ type: "$pong", data: {} }))
+      new WebSocketRequestResponsePair(
+        '{"type":"$ping","data":{}}',
+        JSON.stringify({ type: "$pong", data: {} })
+      )
     );
   }
   acceptWebSocket(webSocket) {
@@ -310,7 +320,11 @@ var CloudflarePlatform = class _CloudflarePlatform extends AbstractPlatform {
   }
   convertWebSocket(webSocket, config) {
     const { room } = config;
-    return new CloudflareWebSocket(webSocket, { persistence: this.persistence, platform: this, room });
+    return new CloudflareWebSocket(webSocket, {
+      persistence: this.persistence,
+      platform: this,
+      room
+    });
   }
   getLastPing(webSocket) {
     var _a;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/platform-cloudflare",
-  "version": "0.44.2",
+  "version": "1.0.1",
   "description": "@pluv/io adapter for cloudflare workers",
   "author": "leedavidcs",
   "license": "MIT",
@@ -17,17 +17,17 @@
   },
   "dependencies": {
     "path-to-regexp": "^8.2.0",
-    "@pluv/io": "^0.44.2",
-    "@pluv/persistence-cloudflare-transactional-storage": "^0.44.2",
-    "@pluv/types": "^0.44.2"
+    "@pluv/io": "^1.0.1",
+    "@pluv/persistence-cloudflare-transactional-storage": "^1.0.1",
+    "@pluv/types": "^1.0.1"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20250428.0",
+    "@cloudflare/workers-types": "^4.20250430.0",
     "eslint": "^9.25.1",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
-    "eslint-config-pluv": "^0.44.2",
-    "@pluv/tsconfig": "^0.44.2"
+    "@pluv/tsconfig": "^1.0.1",
+    "eslint-config-pluv": "^1.0.1"
   },
   "scripts": {
     "build": "tsup src/index.ts",

package/src/CloudflarePlatform.ts

@@ -10,7 +10,10 @@ import type { IOAuthorize, Json } from "@pluv/types";
 import { CloudflareWebSocket } from "./CloudflareWebSocket";
 import { DEFAULT_REGISTRATION_MODE } from "./constants";
 
-export type CloudflarePlatformRoomContext<TEnv extends Record<string, any>, TMeta extends Record<string, Json>> = {
+export type CloudflarePlatformRoomContext<
+    TEnv extends Record<string, any>,
+    TMeta extends Record<string, Json>,
+> = {
     env: TEnv;
     state: DurableObjectState;
 } & (keyof TMeta extends never ? { meta?: undefined } : { meta: TMeta });
@@ -18,7 +21,9 @@ export type CloudflarePlatformRoomContext<TEnv extends Record<string, any>, TMet
 export type CloudflarePlatformConfig<
     TEnv extends Record<string, any> = {},
     TMeta extends Record<string, Json> = {},
-> = AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>> & { mode?: WebSocketRegistrationMode };
+> = AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>> & {
+    mode?: WebSocketRegistrationMode;
+};
 
 export class CloudflarePlatform<
     TAuthorize extends IOAuthorize<any, any> | null = null,
@@ -78,7 +83,10 @@ export class CloudflarePlatform<
         if (!detachedState) return;
 
         detachedState.setWebSocketAutoResponse(
-            new WebSocketRequestResponsePair('{"type":"$ping","data":{}}', JSON.stringify({ type: "$pong", data: {} })),
+            new WebSocketRequestResponsePair(
+                '{"type":"$ping","data":{}}',
+                JSON.stringify({ type: "$pong", data: {} }),
+            ),
         );
     }
 
@@ -94,10 +102,17 @@ export class CloudflarePlatform<
         detachedState.acceptWebSocket(webSocket.webSocket);
     }
 
-    public convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): CloudflareWebSocket<TAuthorize> {
+    public convertWebSocket(
+        webSocket: WebSocket,
+        config: ConvertWebSocketConfig,
+    ): CloudflareWebSocket<TAuthorize> {
         const { room } = config;
 
-        return new CloudflareWebSocket<TAuthorize>(webSocket, { persistence: this.persistence, platform: this, room });
+        return new CloudflareWebSocket<TAuthorize>(webSocket, {
+            persistence: this.persistence,
+            platform: this,
+            room,
+        });
     }
 
     public getLastPing(webSocket: CloudflareWebSocket<TAuthorize>): number | null {
@@ -135,7 +150,9 @@ export class CloudflarePlatform<
         return webSockets;
     }
 
-    public initialize(config: AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>>): this {
+    public initialize(
+        config: AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>>,
+    ): this {
         const ctx = config.roomContext ?? { ...this._roomContext };
 
         if (!ctx.env || !ctx.state) throw new Error("Could not derive platform roomContext");

package/src/CloudflareWebSocket.ts

@@ -17,10 +17,9 @@ export interface CloudflareWebSocketEventMap {
 
 export type CloudflareWebSocketConfig = AbstractWebSocketConfig;
 
-export class CloudflareWebSocket<TAuthorize extends IOAuthorize<any, any> | null = null> extends AbstractWebSocket<
-    WebSocket,
-    TAuthorize
-> {
+export class CloudflareWebSocket<
+    TAuthorize extends IOAuthorize<any, any> | null = null,
+> extends AbstractWebSocket<WebSocket, TAuthorize> {
     public set presence(presence: JsonObject | null) {
         const deserialized = this.webSocket.deserializeAttachment();
         const state = deserialized.state;
@@ -113,12 +112,17 @@ export class CloudflareWebSocket<TAuthorize extends IOAuthorize<any, any> | null
         });
     }
 
-    public addEventListener<TType extends keyof AbstractEventMap>(type: TType, handler: AbstractListener<TType>) {
+    public addEventListener<TType extends keyof AbstractEventMap>(
+        type: TType,
+        handler: AbstractListener<TType>,
+    ) {
         this.webSocket.addEventListener(type, handler as any);
     }
 
     public close(code?: number | undefined, reason?: string | undefined): void {
-        const canClose = [this.CONNECTING, this.OPEN].some((readyState) => readyState === this.readyState);
+        const canClose = [this.CONNECTING, this.OPEN].some(
+            (readyState) => readyState === this.readyState,
+        );
 
         if (!canClose) return;
 

package/src/createPluvHandler.ts

@@ -1,5 +1,12 @@
 import type { InferInitContextType, IORoom, PluvServer } from "@pluv/io";
-import type { BaseUser, Id, InferIOAuthorize, InferIOAuthorizeUser, Maybe, MaybePromise } from "@pluv/types";
+import type {
+    BaseUser,
+    Id,
+    InferIOAuthorize,
+    InferIOAuthorizeUser,
+    Maybe,
+    MaybePromise,
+} from "@pluv/types";
 import { DurableObject as BaseDurableObject } from "cloudflare:workers";
 import { match } from "path-to-regexp";
 import { CloudflarePlatform } from "./CloudflarePlatform";
@@ -7,7 +14,9 @@ import { GARBAGE_COLLECT_INTERVAL_MS } from "./constants";
 
 export type AuthorizeFunctionContext<TPluvServer extends PluvServer<any, any, any, any>> = {
     room: string;
-} & InferInitContextType<TPluvServer extends PluvServer<infer IPlatform, any, any, any> ? IPlatform : never>;
+} & InferInitContextType<
+    TPluvServer extends PluvServer<infer IPlatform, any, any, any> ? IPlatform : never
+>;
 export type AuthorizeFunction<TPluvServer extends PluvServer<any, any, any, any>> = (
     ctx: AuthorizeFunctionContext<TPluvServer>,
 ) => MaybePromise<Maybe<InferIOAuthorizeUser<InferIOAuthorize<TPluvServer>>>>;
@@ -37,28 +46,41 @@ export interface CreatePluvHandlerResult<TEnv extends Record<string, any> = {}>
     handler: ExportedHandler<TEnv>;
 }
 
-type InferCloudflarePluvHandlerEnv<TPluvServer extends PluvServer<CloudflarePlatform<any, any>, any, any, any>> =
-    TPluvServer extends PluvServer<CloudflarePlatform<any, infer IEnv>, any, any, any> ? IEnv : {};
+type InferCloudflarePluvHandlerEnv<
+    TPluvServer extends PluvServer<CloudflarePlatform<any, any>, any, any, any>,
+> = TPluvServer extends PluvServer<CloudflarePlatform<any, infer IEnv>, any, any, any> ? IEnv : {};
 
 /**
  * @deprecated Instructions will be provided on https://pluv.io on how to host this yourself instead.
  * @date April 27, 2025
  */
-export const createPluvHandler = <TPluvServer extends PluvServer<CloudflarePlatform<any, any>, any, any, any>>(
+export const createPluvHandler = <
+    TPluvServer extends PluvServer<CloudflarePlatform<any, any>, any, any, any>,
+>(
     config: CreatePluvHandlerConfig<TPluvServer, Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>,
 ): CreatePluvHandlerResult<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> => {
     const { authorize, binding, endpoint = "/api/pluv", modify, io } = config;
 
-    const DurableObject = class extends BaseDurableObject<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> {
+    const DurableObject = class extends BaseDurableObject<
+        Id<InferCloudflarePluvHandlerEnv<TPluvServer>>
+    > {
         private _room: IORoom<CloudflarePlatform<any, any>>;
 
-        constructor(state: DurableObjectState, env: Id<InferCloudflarePluvHandlerEnv<TPluvServer>>) {
+        constructor(
+            state: DurableObjectState,
+            env: Id<InferCloudflarePluvHandlerEnv<TPluvServer>>,
+        ) {
             super(state, env);
 
             this._room = io.createRoom(state.id.toString(), { env, state });
         }
 
-        public async webSocketClose(ws: WebSocket, code: number, reason: string, wasClean: boolean): Promise<void> {
+        public async webSocketClose(
+            ws: WebSocket,
+            code: number,
+            reason: string,
+            wasClean: boolean,
+        ): Promise<void> {
             if (io._defs.platform._config.registrationMode !== "detached") return;
 
             const onCloseHandler = this._room.onClose(ws);
@@ -92,7 +114,8 @@ export const createPluvHandler = <TPluvServer extends PluvServer<CloudflarePlatf
             const token = new URL(request.url).searchParams.get("token");
 
             const alarm = await this.ctx.storage.getAlarm();
-            if (alarm !== null) await this.ctx.storage.setAlarm(Date.now() + GARBAGE_COLLECT_INTERVAL_MS);
+            if (alarm !== null)
+                await this.ctx.storage.setAlarm(Date.now() + GARBAGE_COLLECT_INTERVAL_MS);
 
             await this._room.register(server, { env: this.env, request, token });
 
@@ -105,7 +128,9 @@ export const createPluvHandler = <TPluvServer extends PluvServer<CloudflarePlatf
         }
     };
 
-    const getDurableObjectNamespace = (env: Id<InferCloudflarePluvHandlerEnv<TPluvServer>>): DurableObjectNamespace => {
+    const getDurableObjectNamespace = (
+        env: Id<InferCloudflarePluvHandlerEnv<TPluvServer>>,
+    ): DurableObjectNamespace => {
         const namespace = env[binding as keyof typeof env] as DurableObjectNamespace;
 
         if (!namespace) {
@@ -115,7 +140,10 @@ export const createPluvHandler = <TPluvServer extends PluvServer<CloudflarePlatf
         return namespace;
     };
 
-    const authHandler: PluvHandlerFetch<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> = async (request, env) => {
+    const authHandler: PluvHandlerFetch<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> = async (
+        request,
+        env,
+    ) => {
         if (!authorize) return null;
 
         const { pathname, searchParams } = new URL(request.url);
@@ -134,7 +162,11 @@ export const createPluvHandler = <TPluvServer extends PluvServer<CloudflarePlatf
         }
 
         try {
-            const user = await authorize({ env, request, room } as AuthorizeFunctionContext<TPluvServer>);
+            const user = await authorize({
+                env,
+                request,
+                room,
+            } as AuthorizeFunctionContext<TPluvServer>);
 
             if (!user) throw new Error();
 
@@ -160,7 +192,10 @@ export const createPluvHandler = <TPluvServer extends PluvServer<CloudflarePlatf
         }
     };
 
-    const roomHandler: PluvHandlerFetch<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> = async (request, env) => {
+    const roomHandler: PluvHandlerFetch<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> = async (
+        request,
+        env,
+    ) => {
         const { pathname } = new URL(request.url);
         const matcher = match<{ roomId: string }>(`${endpoint}/room/:roomId`);
         const matched = matcher(pathname);
@@ -183,7 +218,10 @@ export const createPluvHandler = <TPluvServer extends PluvServer<CloudflarePlatf
         return room.fetch(request);
     };
 
-    const handlerFetch: PluvHandlerFetch<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> = async (request, env) => {
+    const handlerFetch: PluvHandlerFetch<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> = async (
+        request,
+        env,
+    ) => {
         return [authHandler, roomHandler].reduce(async (promise, current) => {
             return await promise.then(async (value) => value ?? (await current(request, env)));
         }, Promise.resolve<Response | null>(null));

package/src/infer.ts

@@ -1,13 +1,17 @@
 import type { Json } from "@pluv/types";
 import type { identity } from "./utils";
 
-export type InferCallback<TEnv extends Record<string, any> = {}, TMeta extends Record<string, Json> = {}> = (
-    i: typeof identity,
-) => {
+export type InferCallback<
+    TEnv extends Record<string, any> = {},
+    TMeta extends Record<string, Json> = {},
+> = (i: typeof identity) => {
     env?: (io: TEnv) => TEnv;
     meta?: (io: TMeta) => TMeta;
 };
 
-export const infer = <TEnv extends Record<string, any> = {}, TMeta extends Record<string, Json> = {}>(
+export const infer = <
+    TEnv extends Record<string, any> = {},
+    TMeta extends Record<string, Json> = {},
+>(
     callback: InferCallback<TEnv, TMeta>,
 ) => callback;

package/src/platformCloudflare.ts

@@ -12,7 +12,11 @@ export type PlatformCloudflareCreateIOParams<
 > = Id<
     CloudflarePlatformConfig<TEnv, TMeta> &
         Omit<
-            CreateIOParams<CloudflarePlatform<IOAuthorize<TUser, TContext>, TEnv, TMeta>, TContext, TUser>,
+            CreateIOParams<
+                CloudflarePlatform<IOAuthorize<TUser, TContext>, TEnv, TMeta>,
+                TContext,
+                TUser
+            >,
             "authorize" | "context" | "platform"
         > & {
             authorize?: PluvIOAuthorize<
@@ -20,7 +24,10 @@ export type PlatformCloudflareCreateIOParams<
                 TUser,
                 InferInitContextType<CloudflarePlatform<IOAuthorize<TUser, TContext>, TEnv, TMeta>>
             >;
-            context?: PluvContext<CloudflarePlatform<IOAuthorize<TUser, any>, TEnv, TMeta>, TContext>;
+            context?: PluvContext<
+                CloudflarePlatform<IOAuthorize<TUser, any>, TEnv, TMeta>,
+                TContext
+            >;
             types?: InferCallback<TEnv, TMeta>;
         }
 >;
@@ -32,7 +39,11 @@ export const platformCloudflare = <
     TUser extends BaseUser | null = null,
 >(
     config: PlatformCloudflareCreateIOParams<TEnv, TMeta, TContext, TUser> = {},
-): CreateIOParams<CloudflarePlatform<IOAuthorize<TUser, TContext>, TEnv, TMeta>, TContext, TUser> => {
+): CreateIOParams<
+    CloudflarePlatform<IOAuthorize<TUser, TContext>, TEnv, TMeta>,
+    TContext,
+    TUser
+> => {
     const { authorize, context, crdt, debug, limits } = config;
 
     return {