@xnetjs/runtime 0.2.2 → 0.3.0

package/dist/index.d.ts

@@ -187,6 +187,14 @@ interface SyncManager {
     track(nodeId: string, schemaId: string): void;
     /** Stop tracking a Node */
     untrack(nodeId: string): void;
+    /**
+     * Subscribe (receive-only) to a share room — e.g. a channel's
+     * `xnet-channel-<id>` — so grant-covered nodes the hub fans in reach the
+     * local store (exploration 0298). Idempotent. No-op without a node store.
+     */
+    subscribeShareRoom(room: string): void;
+    /** Stop receiving a share room's changes. */
+    unsubscribeShareRoom(room: string): void;
     /** Acquire a Y.Doc (used by useNode) */
     acquire(nodeId: string): Promise<Y.Doc>;
     /** Release a Y.Doc (component unmounted) */
@@ -944,6 +952,13 @@ declare function createMultiHubSyncManager(config: MultiHubSyncManagerConfig): M
  *    genuine backlog can't trip the hub's per-connection rate limiter (1008).
  */
 
+/**
+ * The share room that carries a channel's nodes to its grantees (0298). Must
+ * match the hub's `channelShareRoom` so `topicToResource` resolves the grant.
+ */
+declare const channelShareRoom: (channelId: string) => string;
+/** The share room that carries a workspace (bench) node to its grantees (0298). */
+declare const workspaceShareRoom: (workspaceId: string) => string;
 type SerializedNodeChange = {
     id: string;
     type: string;
@@ -984,6 +999,7 @@ type SyncBlockedListener = (reason: SyncBlockedReason, detail: string) => void;
 declare class NodeStoreSyncProvider {
     private store;
     private room;
+    private subscribeOnly;
     /** Confirmed, persisted high-water mark (advanced from the hub's response). */
     private lastSyncedLamport;
     /** Optimistic in-memory cursor: lamport of the last change actually sent. */
@@ -1005,7 +1021,15 @@ declare class NodeStoreSyncProvider {
     private outboundHalted;
     private clearResolver;
     private firstRemoteApplyMarked;
-    constructor(store: NodeStore, room: string);
+    /**
+     * Subscribe-only providers (channel share rooms, 0298) RECEIVE and apply a
+     * room's changes but never publish local changes into it (the hub owns
+     * fan-out) and never advance the cursor from a live broadcast's author
+     * lamport — a share room's cursor is a per-room `seq` carried opaquely in the
+     * sync-response high-water mark, and author lamports across members are not
+     * mutually ordered.
+     */
+    constructor(store: NodeStore, room: string, subscribeOnly?: boolean);
     /**
      * Mark the first remote apply once. Platform-agnostic and defensive: a
      * missing `performance` global, or a throw, is a no-op — instrumentation
@@ -1313,4 +1337,4 @@ declare function negotiateProtocolVersion(ours: readonly string[], theirs: reado
  */
 declare function isProtocolCompatible(theirs: readonly string[]): boolean;
 
-export { type AdapterConformanceCheck, AdapterConformanceError, type AdapterConformanceResult, type BlobStoreForSync, type ConformanceClientFactory, type ConnectionManager, type ConnectionManagerConfig, type ConnectionStatus, type CreateXNetClientOptions, type HubConnection, type HubTransport, type InitialSyncManager, type InitialSyncMessage, type LiveQuery, type LiveQueryValue, METABRIDGE_ORIGIN, METABRIDGE_SEED_ORIGIN, type MetaBridge, type MultiHubConnectionManagerConfig, type MultiHubSyncManager, type MultiHubSyncManagerConfig, type NodePool, type NodePoolConfig, NodeStoreSyncProvider, type NodeSyncResponse, type OfflineQueue, type OfflineQueueConfig, type PlannedHub, type PoolEntryState, type ProgressListener, type QueueEntry, type Registry, type RegistryConfig, type RegistryStorage, type ReplicaTrust, type ReplicationDestinationSpec, type ReplicationScopeNode, type ScopedRoomHandle, type SerializedNodeChange, type SpaceReplicationPolicy, type SyncBlockedListener, type SyncBlockedReason, type SyncManager, type SyncManagerConfig, type SyncPhase, type SyncProgress, type SyncReconciliationOptions, type SyncReconciliationReport, type SyncStatus, type TrackedNode, WebSocketSyncProvider, type WebSocketSyncProviderOptions, XNET_AWARENESS_VERSION, XNET_DATA_MODEL_VERSION, XNET_PROTOCOL_VERSION, XNET_SCHEMA_VERSION, XNET_SUPPORTED_PROTOCOL_VERSIONS, XNET_SYNC_ENVELOPE_VERSION, XNET_UCAN_PROFILE, type XNetClient, type XNetClientBridgeMode, type XNetClientPluginOptions, type XNetClientRuntimePhase, type XNetClientRuntimeStatus, type XNetClientSyncOptions, type XNetClientTelemetry, type XNetClientUndoOptions, type XNetProtocolBundle, createConnectionManager, createInitialSyncManager, createMetaBridge, createMultiHubConnectionManager, createMultiHubSyncManager, createNodePool, createOfflineQueue, createRegistry, createSyncManager, createXNetClient, isProtocolCompatible, liveQuery, namespaceForNode, negotiateProtocolVersion, replicationConfigFromPolicies, runAdapterConformance, spaceNamespace, systemNamespace };
+export { type AdapterConformanceCheck, AdapterConformanceError, type AdapterConformanceResult, type BlobStoreForSync, type ConformanceClientFactory, type ConnectionManager, type ConnectionManagerConfig, type ConnectionStatus, type CreateXNetClientOptions, type HubConnection, type HubTransport, type InitialSyncManager, type InitialSyncMessage, type LiveQuery, type LiveQueryValue, METABRIDGE_ORIGIN, METABRIDGE_SEED_ORIGIN, type MetaBridge, type MultiHubConnectionManagerConfig, type MultiHubSyncManager, type MultiHubSyncManagerConfig, type NodePool, type NodePoolConfig, NodeStoreSyncProvider, type NodeSyncResponse, type OfflineQueue, type OfflineQueueConfig, type PlannedHub, type PoolEntryState, type ProgressListener, type QueueEntry, type Registry, type RegistryConfig, type RegistryStorage, type ReplicaTrust, type ReplicationDestinationSpec, type ReplicationScopeNode, type ScopedRoomHandle, type SerializedNodeChange, type SpaceReplicationPolicy, type SyncBlockedListener, type SyncBlockedReason, type SyncManager, type SyncManagerConfig, type SyncPhase, type SyncProgress, type SyncReconciliationOptions, type SyncReconciliationReport, type SyncStatus, type TrackedNode, WebSocketSyncProvider, type WebSocketSyncProviderOptions, XNET_AWARENESS_VERSION, XNET_DATA_MODEL_VERSION, XNET_PROTOCOL_VERSION, XNET_SCHEMA_VERSION, XNET_SUPPORTED_PROTOCOL_VERSIONS, XNET_SYNC_ENVELOPE_VERSION, XNET_UCAN_PROFILE, type XNetClient, type XNetClientBridgeMode, type XNetClientPluginOptions, type XNetClientRuntimePhase, type XNetClientRuntimeStatus, type XNetClientSyncOptions, type XNetClientTelemetry, type XNetClientUndoOptions, type XNetProtocolBundle, channelShareRoom, createConnectionManager, createInitialSyncManager, createMetaBridge, createMultiHubConnectionManager, createMultiHubSyncManager, createNodePool, createOfflineQueue, createRegistry, createSyncManager, createXNetClient, isProtocolCompatible, liveQuery, namespaceForNode, negotiateProtocolVersion, replicationConfigFromPolicies, runAdapterConformance, spaceNamespace, systemNamespace, workspaceShareRoom };

package/dist/index.js

@@ -901,11 +901,22 @@ function nowMs2() {
 function yieldToEventLoop() {
   return new Promise((resolve) => setTimeout(resolve, 0));
 }
+var channelShareRoom = (channelId) => `xnet-channel-${channelId}`;
+var workspaceShareRoom = (workspaceId) => `xnet-workspace-${workspaceId}`;
 var CAPACITY_REJECTION_CODES = /* @__PURE__ */ new Set(["QUOTA_EXCEEDED", "STORAGE_FULL"]);
 var NodeStoreSyncProvider = class {
-  constructor(store, room) {
+  /**
+   * Subscribe-only providers (channel share rooms, 0298) RECEIVE and apply a
+   * room's changes but never publish local changes into it (the hub owns
+   * fan-out) and never advance the cursor from a live broadcast's author
+   * lamport — a share room's cursor is a per-room `seq` carried opaquely in the
+   * sync-response high-water mark, and author lamports across members are not
+   * mutually ordered.
+   */
+  constructor(store, room, subscribeOnly = false) {
     this.store = store;
     this.room = room;
+    this.subscribeOnly = subscribeOnly;
   }
   /** Confirmed, persisted high-water mark (advanced from the hub's response). */
   lastSyncedLamport = 0;
@@ -990,10 +1001,12 @@ var NodeStoreSyncProvider = class {
         this.onDisconnected();
       }
     });
-    this.storeCleanup = this.store.subscribe((event) => {
-      if (event.isRemote) return;
-      this.enqueueChange(event.change);
-    });
+    if (!this.subscribeOnly) {
+      this.storeCleanup = this.store.subscribe((event) => {
+        if (event.isRemote) return;
+        this.enqueueChange(event.change);
+      });
+    }
     if (connection.status === "connected") {
       void this.onConnected();
     }
@@ -1026,7 +1039,7 @@ var NodeStoreSyncProvider = class {
     if (!this.connection || this.connection.status !== "connected") return;
     this.requestSync();
     await this.waitForSyncResponse();
-    await this.syncLocalChanges();
+    if (!this.subscribeOnly) await this.syncLocalChanges();
   }
   onDisconnected() {
     this.clearSendQueue();
@@ -1180,7 +1193,7 @@ var NodeStoreSyncProvider = class {
   }
   async handleRemoteChange(serialized, peerId = "unknown") {
     const change = this.deserializeChange(serialized);
-    if (serialized.lamportTime > this.lastSyncedLamport) {
+    if (!this.subscribeOnly && serialized.lamportTime > this.lastSyncedLamport) {
       this.lastSyncedLamport = serialized.lamportTime;
     }
     if (!KNOWN_CHANGE_TYPES.has(change.type)) {
@@ -1798,6 +1811,7 @@ function createSyncManager(config) {
   });
   let offlineQueueReady = Promise.resolve();
   const nodeSyncProvider = config.nodeSyncRoom ? new NodeStoreSyncProvider(config.nodeStore, config.nodeSyncRoom) : null;
+  const shareRoomProviders = /* @__PURE__ */ new Map();
   let blobSync = null;
   if (config.blobStore) {
     const underlyingStore = config.blobStore;
@@ -2269,6 +2283,7 @@ function createSyncManager(config) {
       log2("Connecting to signaling server...");
       connection.connect();
       nodeSyncProvider?.attach(connection);
+      for (const provider of shareRoomProviders.values()) provider.attach(connection);
       blobSync?.start();
       const tracked = registry.getTracked();
       log2("Joining rooms for", tracked.length, "tracked nodes");
@@ -2286,6 +2301,8 @@ function createSyncManager(config) {
       });
       blobSync?.stop();
       nodeSyncProvider?.detach();
+      for (const provider of shareRoomProviders.values()) provider.detach();
+      shareRoomProviders.clear();
       for (const nodeId of Array.from(roomCleanups.keys())) {
         leaveNodeRoom(nodeId);
       }
@@ -2314,6 +2331,18 @@ function createSyncManager(config) {
       scheduleRegistrySave();
       leaveNodeRoom(nodeId);
     },
+    subscribeShareRoom(room) {
+      if (shareRoomProviders.has(room)) return;
+      const provider = new NodeStoreSyncProvider(config.nodeStore, room, true);
+      shareRoomProviders.set(room, provider);
+      provider.attach(connection);
+    },
+    unsubscribeShareRoom(room) {
+      const provider = shareRoomProviders.get(room);
+      if (!provider) return;
+      provider.detach();
+      shareRoomProviders.delete(room);
+    },
     async acquire(nodeId) {
       log2("Acquiring doc for node:", nodeId);
       registry.touch(nodeId);
@@ -3492,6 +3521,7 @@ export {
   XNET_SUPPORTED_PROTOCOL_VERSIONS,
   XNET_SYNC_ENVELOPE_VERSION,
   XNET_UCAN_PROFILE,
+  channelShareRoom,
   createConnectionManager,
   createInitialSyncManager,
   createMetaBridge,
@@ -3509,5 +3539,6 @@ export {
   replicationConfigFromPolicies,
   runAdapterConformance,
   spaceNamespace,
-  systemNamespace
+  systemNamespace,
+  workspaceShareRoom
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xnetjs/runtime",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Framework-agnostic xNet runtime: createXNetClient() and sync orchestration, usable from any framework, a CLI, a worker, or a Node service",
   "license": "MIT",
   "repository": {
@@ -28,15 +28,15 @@
   "dependencies": {
     "y-protocols": "^1.0.6",
     "yjs": "^13.6.24",
-    "@xnetjs/core": "0.10.0",
-    "@xnetjs/crypto": "0.10.0",
-    "@xnetjs/data": "0.10.0",
-    "@xnetjs/data-bridge": "0.10.0",
-    "@xnetjs/history": "0.10.0",
-    "@xnetjs/identity": "0.10.0",
-    "@xnetjs/plugins": "0.10.0",
-    "@xnetjs/storage": "0.10.0",
-    "@xnetjs/sync": "0.10.0"
+    "@xnetjs/core": "0.11.0",
+    "@xnetjs/data": "0.11.0",
+    "@xnetjs/crypto": "0.11.0",
+    "@xnetjs/data-bridge": "0.11.0",
+    "@xnetjs/history": "0.11.0",
+    "@xnetjs/identity": "0.11.0",
+    "@xnetjs/plugins": "0.11.0",
+    "@xnetjs/storage": "0.11.0",
+    "@xnetjs/sync": "0.11.0"
   },
   "devDependencies": {
     "jsdom": "^26.0.0",