@objectstack/metadata 5.1.0 → 5.2.0

package/dist/index.cjs

@@ -2392,6 +2392,23 @@ var _MetadataManager = class _MetadataManager {
     this.notifyWatchers(type, legacyEvent);
   }
   notifyWatchers(type, event) {
+    this.notifyWatchersLocal(type, event);
+    if (this.clusterPubSub) {
+      const payload = {
+        originNode: this.clusterNodeId,
+        type,
+        event
+      };
+      const key = `${type}:${event.name ?? ""}`;
+      void this.clusterPubSub.publish(_MetadataManager.CLUSTER_CHANNEL, payload, { partitionKey: key }).catch((err) => {
+        this.logger.error("Cluster metadata publish failed", void 0, {
+          type,
+          error: err instanceof Error ? err.message : String(err)
+        });
+      });
+    }
+  }
+  notifyWatchersLocal(type, event) {
     const callbacks = this.watchCallbacks.get(type);
     if (!callbacks) return;
     for (const callback of callbacks) {
@@ -2405,6 +2422,63 @@ var _MetadataManager = class _MetadataManager {
       }
     }
   }
+  /**
+   * Attach a cluster pub/sub transport so metadata-change events fan
+   * out to peer nodes and remote events replay into local watchers.
+   *
+   * The bridge plugin in @objectstack/service-cluster calls this once
+   * per kernel boot after both cluster and metadata services are
+   * registered. Passing the same MetadataManager twice no-ops; passing
+   * a different transport replaces the prior subscription.
+   *
+   * Pass `nodeId` matching the local cluster's nodeId so loopback
+   * suppression works.
+   *
+   * @returns disposer that unsubscribes from cluster events.
+   */
+  attachClusterPubSub(pubsub, nodeId) {
+    if (this.clusterPubSub === pubsub && this.clusterNodeId === nodeId) {
+      return () => this.detachClusterPubSub();
+    }
+    this.detachClusterPubSub();
+    this.clusterPubSub = pubsub;
+    this.clusterNodeId = nodeId;
+    this.clusterUnsubscribe = pubsub.subscribe(
+      _MetadataManager.CLUSTER_CHANNEL,
+      (msg) => {
+        const p = msg.payload;
+        if (p?.originNode && p.originNode === this.clusterNodeId) return;
+        if (!p?.type || !p.event) return;
+        setImmediate(() => {
+          try {
+            this.notifyWatchersLocal(p.type, p.event);
+          } catch (err) {
+            this.logger.error("Cluster remote replay failed", void 0, {
+              type: p.type,
+              error: err instanceof Error ? err.message : String(err)
+            });
+          }
+        });
+      }
+    );
+    this.logger.info("MetadataManager attached to cluster pubsub", {
+      nodeId,
+      channel: _MetadataManager.CLUSTER_CHANNEL
+    });
+    return () => this.detachClusterPubSub();
+  }
+  /** Tear down cluster wiring. Safe to call multiple times. */
+  detachClusterPubSub() {
+    if (this.clusterUnsubscribe) {
+      try {
+        this.clusterUnsubscribe();
+      } catch {
+      }
+      this.clusterUnsubscribe = void 0;
+    }
+    this.clusterPubSub = void 0;
+    this.clusterNodeId = void 0;
+  }
   // ==========================================
   // Version History & Rollback
   // ==========================================
@@ -2505,6 +2579,7 @@ var _MetadataManager = class _MetadataManager {
   }
 };
 _MetadataManager.LIST_CACHE_TTL_MS = 3e4;
+_MetadataManager.CLUSTER_CHANNEL = "metadata.changed";
 var MetadataManager = _MetadataManager;
 
 // src/plugin.ts