@velajs/vela 1.15.0 → 1.17.0

package/dist/websocket-node/redis-live.d.ts

@@ -0,0 +1,24 @@
+import type { LiveDriver } from '../live/index';
+import type { RedisPubSubClient } from './redis-sync';
+export interface RedisLiveOptions {
+    /** Connection used to publish invalidations. */
+    pub: RedisPubSubClient;
+    /** Separate connection kept in subscriber mode. */
+    sub: RedisPubSubClient;
+    /** Channel prefix. Default `vela:live`. */
+    prefix?: string;
+}
+/**
+ * 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 declare function redisLive(options: RedisLiveOptions): LiveDriver;

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.15.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": {
@@ -102,6 +107,7 @@
     "@vitest/runner": "^4.1.9",
     "@vitest/snapshot": "^4.1.9",
     "intl-messageformat": "^11.2.9",
+    "typedoc": "~0.28.19",
     "typescript": "^6.0.3",
     "unplugin-swc": "^1.5.9",
     "vitest": "^4.1.9",
@@ -112,6 +118,9 @@
     "test": "vitest run",
     "test:workers": "vitest run --config vitest.config.workers.ts",
     "test:workers:als": "vitest run --config vitest.config.workers-als.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.type-tests.json",
+    "check:skill": "node scripts/check-skill.mjs",
+    "docs": "typedoc",
+    "docs:check": "typedoc --emit none"
   }
 }