@velajs/vela 1.17.0 → 1.17.1

package/dist/live/index.d.ts

@@ -1,7 +1,7 @@
 export { LiveModule } from './live.module';
 export { LiveResolver, LiveQuery, getLiveQueries } from './live.decorators';
 export { LiveEngine, LIVE_SUBS_DATA_KEY, readPersistedLiveSubscriptions } from './live.engine';
-export { LiveInvalidation, localLive, stampCommitHeaders } from './live.invalidation';
+export { LiveInvalidation, localLive, perAppLiveDriver, stampCommitHeaders } from './live.invalidation';
 export { InMemoryCursorLog } from './live.cursor';
 export { encodeSubscriptionUpdate } from './live.delta';
 export { PresenceService, PresenceResolver, presenceTag, PRESENCE_ROSTER_QUERY } from './presence';

package/dist/live/index.js

@@ -6,7 +6,7 @@
 export { LiveModule } from "./live.module.js";
 export { LiveResolver, LiveQuery, getLiveQueries } from "./live.decorators.js";
 export { LiveEngine, LIVE_SUBS_DATA_KEY, readPersistedLiveSubscriptions } from "./live.engine.js";
-export { LiveInvalidation, localLive, stampCommitHeaders } from "./live.invalidation.js";
+export { LiveInvalidation, localLive, perAppLiveDriver, stampCommitHeaders } from "./live.invalidation.js";
 export { InMemoryCursorLog } from "./live.cursor.js";
 export { encodeSubscriptionUpdate } from "./live.delta.js";
 export { PresenceService, PresenceResolver, presenceTag, PRESENCE_ROSTER_QUERY } from "./presence.js";

package/dist/live/live.invalidation.d.ts

@@ -1,6 +1,24 @@
 import type { CommitStamp, InvalidationCommand, LiveDriver } from './live.types';
 /** Single-scope default driver: deliver straight to this process's engine. */
 export declare function localLive(): LiveDriver;
+/**
+ * Per-app wrapper around a (possibly SHARED) driver instance.
+ *
+ * A driver passed to `LiveModule.forRoot({ driver })` is a plain config object
+ * — and on Cloudflare the SAME app module (thus the same driver object)
+ * bootstraps in the Worker isolate AND inside each Durable Object, often
+ * within one isolate. Mutable per-app state must therefore never live on the
+ * driver itself: the DO flipping a shared `durableObjectLive()` into local
+ * mode would otherwise poison the Worker's engine, which then executes the
+ * DO's storage handle in the wrong request context ("Cannot perform I/O on
+ * behalf of a different request").
+ *
+ * The wrapper owns the per-app sink and the per-app local-mode flag; isolate-
+ * wide concerns (env capture) forward to the underlying driver. Platform init
+ * hooks (`_setLocalMode`, `_initializeEnv`) are exposed pass-through so
+ * platform packages can keep type-guarding on their presence.
+ */
+export declare function perAppLiveDriver(underlying: LiveDriver): LiveDriver;
 /**
  * The injectable invalidation surface for custom (non-CRUD) write paths:
  *

package/dist/live/live.invalidation.js

@@ -12,6 +12,49 @@ import { getContext } from "hono/context-storage";
         }
     };
 }
+/**
+ * Per-app wrapper around a (possibly SHARED) driver instance.
+ *
+ * A driver passed to `LiveModule.forRoot({ driver })` is a plain config object
+ * — and on Cloudflare the SAME app module (thus the same driver object)
+ * bootstraps in the Worker isolate AND inside each Durable Object, often
+ * within one isolate. Mutable per-app state must therefore never live on the
+ * driver itself: the DO flipping a shared `durableObjectLive()` into local
+ * mode would otherwise poison the Worker's engine, which then executes the
+ * DO's storage handle in the wrong request context ("Cannot perform I/O on
+ * behalf of a different request").
+ *
+ * The wrapper owns the per-app sink and the per-app local-mode flag; isolate-
+ * wide concerns (env capture) forward to the underlying driver. Platform init
+ * hooks (`_setLocalMode`, `_initializeEnv`) are exposed pass-through so
+ * platform packages can keep type-guarding on their presence.
+ */ export function perAppLiveDriver(underlying) {
+    let ownSink;
+    let localMode = false;
+    const cfHooks = underlying;
+    return {
+        get kind () {
+            return underlying.kind;
+        },
+        bind (sink) {
+            ownSink = sink;
+            underlying.bind(sink);
+        },
+        dispatch (cmd) {
+            if (localMode && ownSink) return ownSink.applyInvalidation(cmd);
+            return underlying.dispatch(cmd);
+        },
+        start: underlying.start ? ()=>underlying.start?.() : undefined,
+        stop: underlying.stop ? ()=>underlying.stop?.() : undefined,
+        // Platform hooks (Cloudflare): local mode is PER APP; env is per isolate.
+        _setLocalMode () {
+            localMode = true;
+        },
+        _initializeEnv (env) {
+            cfHooks._initializeEnv?.(env);
+        }
+    };
+}
 /**
  * The injectable invalidation surface for custom (non-CRUD) write paths:
  *

package/dist/live/live.module.js

@@ -1,7 +1,7 @@
 import { defineModule } from "../index.js";
 import { InMemoryCursorLog } from "./live.cursor.js";
 import { LiveEngine } from "./live.engine.js";
-import { LiveInvalidation, localLive } from "./live.invalidation.js";
+import { LiveInvalidation, localLive, perAppLiveDriver } from "./live.invalidation.js";
 import { LIVE_CURSOR_LOG, LIVE_DRIVER, LIVE_MODULE_OPTIONS } from "./live.tokens.js";
 import { PresenceResolver, PresenceService } from "./presence.js";
 /**
@@ -39,7 +39,11 @@ import { PresenceResolver, PresenceService } from "./presence.js";
                 },
                 {
                     provide: LIVE_DRIVER,
-                    useFactory: (o)=>o.driver ?? localLive(),
+                    // Wrapped per app: user-supplied drivers are shared config objects
+                    // (the same module bootstraps in the Worker AND in each Durable
+                    // Object), so per-app sink/mode state lives in the wrapper — see
+                    // perAppLiveDriver.
+                    useFactory: (o)=>perAppLiveDriver(o.driver ?? localLive()),
                     inject: [
                         OPTIONS
                     ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velajs/vela",
-  "version": "1.17.0",
+  "version": "1.17.1",
   "description": "NestJS-compatible framework for edge runtimes, powered by Hono",
   "type": "module",
   "main": "./dist/index.js",