@pluv/platform-cloudflare 0.41.7 → 0.43.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/platform-cloudflare@0.41.7 build /home/runner/work/pluv/pluv/packages/platform-cloudflare
+> @pluv/platform-cloudflare@0.43.0 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.90 KB
-ESM ⚡️ Build success in 27ms
+ESM dist/index.mjs 13.91 KB
+ESM ⚡️ Build success in 50ms
 DTS Build start
-DTS ⚡️ Build success in 1059ms
-DTS dist/index.d.mts 7.18 KB
+DTS ⚡️ Build success in 1206ms
+DTS dist/index.d.mts 7.31 KB

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @pluv/platform-cloudflare
 
+## 0.43.0
+
+### Patch Changes
+
+- 29fe3fc: Update `platformNode` and `platformCloudflare` to be able to configure limits for `PluvIO` (when self-hosted).
+- Updated dependencies [e60a677]
+- Updated dependencies [0063e80]
+- Updated dependencies [244a973]
+- Updated dependencies [4b0fbb3]
+  - @pluv/io@0.43.0
+  - @pluv/persistence-cloudflare-transactional-storage@0.43.0
+  - @pluv/types@0.43.0
+
+## 0.42.0
+
+### Minor Changes
+
+- 5c2c71d: **BREAKING** Updated the `PersistenceCloudflareTransactionalStorage` constructor so require a new property `mode` (either `kv` or `sqlite`). `sqlite` makes use of `DurableObject` SQLite storage, and `kv` makes use of their key-value storage. `platformCloudflare` now sets the underlying `PersistenceCloudflareTransactionalStorage` to use the `sqlite` mode by default (was previously using `kv`). For more information on the differences, please refer to [Cloudflare's documentation](https://developers.cloudflare.com/durable-objects/api/storage-api/#sql-api).
+
+  To continue using the `kv` mode, you will need to install `@pluv/persistence-cloudflare-transactional-storage` and provide it manually to `platformCloudflare` with your desired mode.
+
+  ```ts
+  platformCloudflare({
+    // ...
+    persistence: new PersistenceCloudflareTransactionalStorage({ mode: "kv" }),
+    // ...
+  });
+  ```
+
+### Patch Changes
+
+- a47e171: Deprecated `createPluvHandler`. Instead, documentation will be provided on how to host pluv.io yourself on Node.js and Cloudflare Workers.
+- Updated dependencies [5c2c71d]
+- Updated dependencies [4ce32ee]
+- Updated dependencies [cf1529a]
+  - @pluv/persistence-cloudflare-transactional-storage@0.42.0
+  - @pluv/io@0.42.0
+  - @pluv/types@0.42.0
+
 ## 0.41.7
 
 ### Patch Changes

package/dist/index.d.mts

@@ -102,6 +102,10 @@ 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 : {};
+/**
+ * @deprecated Instructions will be provided on https://pluv.io on how to host this yourself instead.
+ * @date April 27, 2025
+ */
 declare const createPluvHandler: <TPluvServer extends PluvServer<CloudflarePlatform<any, any>, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer, Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>) => CreatePluvHandlerResult<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>;
 
 declare const identity: <T extends unknown>(x: T) => T;

package/dist/index.mjs

@@ -274,7 +274,7 @@ var CloudflareWebSocket = class extends AbstractWebSocket {
 var CloudflarePlatform = class _CloudflarePlatform extends AbstractPlatform {
   constructor(config) {
     var _a;
-    super(__spreadValues(__spreadValues({}, config), config.roomContext && config.mode === "detached" ? { persistence: new PersistenceCloudflareTransactionalStorage(config.roomContext) } : {}));
+    super(__spreadValues(__spreadValues({}, config), config.roomContext && config.mode === "detached" ? { persistence: new PersistenceCloudflareTransactionalStorage({ mode: "sqlite" }) } : {}));
     this._name = "platformCloudflare";
     this._config = {
       authorize: {
@@ -340,16 +340,17 @@ var CloudflarePlatform = class _CloudflarePlatform extends AbstractPlatform {
   }
   initialize(config) {
     var _a;
-    const roomContext = (_a = config.roomContext) != null ? _a : __spreadValues({}, this._roomContext);
-    if (!roomContext.env || !roomContext.state) throw new Error("Could not derive platform roomContext");
+    const ctx = (_a = config.roomContext) != null ? _a : __spreadValues({}, 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
+    };
     return new _CloudflarePlatform({
-      roomContext: {
-        env: roomContext.env,
-        meta: roomContext.meta,
-        state: roomContext.state
-      },
+      roomContext,
       mode: this._config.registrationMode,
-      persistence: this.persistence,
+      persistence: this.persistence.initialize(roomContext),
       pubSub: this.pubSub
     })._initialize();
   }
@@ -377,12 +378,13 @@ var CloudflarePlatform = class _CloudflarePlatform extends AbstractPlatform {
 
 // src/platformCloudflare.ts
 var platformCloudflare = (config = {}) => {
-  const { authorize, context, crdt, debug } = config;
+  const { authorize, context, crdt, debug, limits } = config;
   return {
     authorize,
     context,
     crdt,
     debug,
+    limits,
     platform: new CloudflarePlatform(config)
   };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/platform-cloudflare",
-  "version": "0.41.7",
+  "version": "0.43.0",
   "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.41.7",
-    "@pluv/persistence-cloudflare-transactional-storage": "^0.41.7",
-    "@pluv/types": "^0.41.7"
+    "@pluv/io": "^0.43.0",
+    "@pluv/persistence-cloudflare-transactional-storage": "^0.43.0",
+    "@pluv/types": "^0.43.0"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20250418.0",
-    "eslint": "^9.25.0",
+    "@cloudflare/workers-types": "^4.20250428.0",
+    "eslint": "^9.25.1",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
-    "@pluv/tsconfig": "^0.41.7",
-    "eslint-config-pluv": "^0.41.7"
+    "@pluv/tsconfig": "^0.43.0",
+    "eslint-config-pluv": "^0.43.0"
   },
   "scripts": {
     "build": "tsup src/index.ts",

package/src/CloudflarePlatform.ts

@@ -52,7 +52,7 @@ export class CloudflarePlatform<
         super({
             ...config,
             ...(config.roomContext && config.mode === "detached"
-                ? { persistence: new PersistenceCloudflareTransactionalStorage(config.roomContext) }
+                ? { persistence: new PersistenceCloudflareTransactionalStorage({ mode: "sqlite" }) }
                 : {}),
         });
 
@@ -136,18 +136,20 @@ export class CloudflarePlatform<
     }
 
     public initialize(config: AbstractPlatformConfig<CloudflarePlatformRoomContext<TEnv, TMeta>>): this {
-        const roomContext = config.roomContext ?? { ...this._roomContext };
+        const ctx = config.roomContext ?? { ...this._roomContext };
 
-        if (!roomContext.env || !roomContext.state) throw new Error("Could not derive platform 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,
+        } as CloudflarePlatformRoomContext<TEnv, TMeta>;
 
         return new CloudflarePlatform<TAuthorize, TEnv, TMeta>({
-            roomContext: {
-                env: roomContext.env,
-                meta: roomContext.meta,
-                state: roomContext.state,
-            } as CloudflarePlatformRoomContext<TEnv, TMeta>,
+            roomContext,
             mode: this._config.registrationMode,
-            persistence: this.persistence,
+            persistence: this.persistence.initialize(roomContext),
             pubSub: this.pubSub,
         })._initialize() as this;
     }

package/src/createPluvHandler.ts

@@ -40,6 +40,10 @@ export interface CreatePluvHandlerResult<TEnv extends Record<string, any> = {}>
 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>>(
     config: CreatePluvHandlerConfig<TPluvServer, Id<InferCloudflarePluvHandlerEnv<TPluvServer>>>,
 ): CreatePluvHandlerResult<Id<InferCloudflarePluvHandlerEnv<TPluvServer>>> => {

package/src/platformCloudflare.ts

@@ -33,13 +33,14 @@ export const platformCloudflare = <
 >(
     config: PlatformCloudflareCreateIOParams<TEnv, TMeta, TContext, TUser> = {},
 ): CreateIOParams<CloudflarePlatform<IOAuthorize<TUser, TContext>, TEnv, TMeta>, TContext, TUser> => {
-    const { authorize, context, crdt, debug } = config;
+    const { authorize, context, crdt, debug, limits } = config;
 
     return {
         authorize,
         context,
         crdt,
         debug,
+        limits,
         platform: new CloudflarePlatform<IOAuthorize<TUser, TContext>, TEnv, TMeta>(config),
     };
 };