@velajs/vela 1.16.0 → 1.17.0

package/dist/websocket-node/redis-live.js

@@ -0,0 +1,57 @@
+const swallow = (op)=>{
+    void Promise.resolve(op).catch(()=>{});
+};
+/**
+ * Cross-instance live-invalidation driver for node/bun via Redis pub/sub —
+ * the live sibling of the WebSocket `redis()` sync driver, carrying TAGS
+ * instead of frames. Local-first: `dispatch` applies to this instance's
+ * engine immediately (its log stamps the returned commit cursor), then fans
+ * the command out so every peer re-runs ITS local subscriptions.
+ *
+ * Guarantees (same honesty as `redis()`): at-most-once, no cross-publisher
+ * ordering, no replay. Each instance keeps its own per-process epoch, so a
+ * client reconnecting onto a different instance always receives a full
+ * snapshot — exactly the protocol's multi-instance-node rule. Real cursor
+ * resume needs a shared ordered log (the Cloudflare DO transport).
+ */ export function redisLive(options) {
+    const prefix = options.prefix ?? 'vela:live';
+    const channel = `${prefix}:invalidate`;
+    const origin = crypto.randomUUID();
+    let sink;
+    let bound = false;
+    const onMessage = (ch, message)=>{
+        if (ch !== channel) return;
+        let cmd;
+        try {
+            cmd = JSON.parse(message);
+        } catch  {
+            return;
+        }
+        if (cmd.origin === origin) return; // our own publish — already applied locally
+        if (sink) swallow(sink.applyInvalidation(cmd));
+    };
+    return {
+        kind: 'redis',
+        bind (boundSink) {
+            sink = boundSink;
+            if (bound) return; // idempotent — never stack duplicate 'message' listeners
+            bound = true;
+            swallow(options.sub.subscribe(channel));
+            options.sub.on('message', onMessage);
+        },
+        async dispatch (cmd) {
+            swallow(options.pub.publish(channel, JSON.stringify({
+                ...cmd,
+                origin
+            })));
+            return sink?.applyInvalidation(cmd);
+        },
+        stop () {
+            if (!bound) return;
+            bound = false;
+            options.sub.off?.('message', onMessage);
+            options.sub.removeListener?.('message', onMessage);
+            swallow(options.sub.unsubscribe?.(channel));
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velajs/vela",
-  "version": "1.16.0",
+  "version": "1.17.0",
   "description": "NestJS-compatible framework for edge runtimes, powered by Hono",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,6 +38,10 @@
       "types": "./dist/queue/index.d.ts",
       "import": "./dist/queue/index.js"
     },
+    "./live": {
+      "types": "./dist/live/index.d.ts",
+      "import": "./dist/live/index.js"
+    },
     "./storage": {
       "types": "./dist/storage/index.d.ts",
       "import": "./dist/storage/index.js"
@@ -84,6 +88,7 @@
     "node": ">=20"
   },
   "dependencies": {
+    "@velajs/live-protocol": "^1.0.0",
     "hono": "^4.12.26"
   },
   "peerDependencies": {