@ultimat3/realtime 19.3.3 → 20.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/realtime",
-  "version": "19.3.3",
+  "version": "20.0.0",
   "description": "Three-tier realtime: channels, live queries, local-first sync — one protocol, one mutator shape",
   "license": "MIT",
   "type": "module",
@@ -36,8 +36,8 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "19.3.3",
-    "@ultimat3/query": "19.3.3",
+    "@ultimat3/core": "20.0.0",
+    "@ultimat3/query": "20.0.0",
     "nats": "2.29.3"
   }
 }

package/src/sync-node.ts

@@ -99,6 +99,8 @@ export interface SyncNodeOptions {
 export interface SyncNode {
   readonly sockets: SocketRegistry;
   readonly ready: boolean;
+  /** The one path it answers an upgrade on: a HOST has to route it, and must not restate it. */
+  readonly path: string;
   start(): Promise<void>;
   /**
    * Refuse new connections, keep every one this node holds. The SIGTERM `accept` phase calls it —
@@ -280,6 +282,7 @@ export function createSyncNode(options: SyncNodeOptions): SyncNode {
 
   return {
     sockets,
+    path,
 
     get ready(): boolean {
       return ready;

package/src/sync-protocol.ts

@@ -1,6 +1,10 @@
 // The wire. One protocol for all three tiers: a channel subscribe, a live-query subscribe, and an
-// offline mutation drain are frames in the same union. Moving a route from tier 2 to tier 3 is a
-// config flag (`persist: true`), never a new protocol — that promise is enforced here.
+// offline mutation drain are frames in the same union — so moving a route from tier 2 to tier 3
+// needs no new protocol, and THAT is the half this file enforces.
+// It is not a `persist: true` config flag: this header said so until 2026-09 and `query()` has
+// never accepted the key (`local-store.ts` records the same). Tier 3 is reached by passing a
+// `LocalStore` to the live client, which is a client-side wiring decision this file cannot see —
+// claiming to enforce it here is the declared-and-never-wired shape the repo keeps re-shipping.
 
 import { renderThrowable, stringField } from '@ultimat3/core';
 import { CURSOR_ID_LIMIT, type LiveCursor } from './cursor';