cross-tab-worker-databus 0.20.66 → 0.20.68

package/dist/cjs/index.cjs

@@ -321,6 +321,7 @@ var BatchingStorageWriter = class {
 };
 
 // src/core/cluster.ts
+var CLUSTER_PROTOCOL_VERSION = 1;
 var DEFAULT_HEARTBEAT_INTERVAL_MS = 3e3;
 var DEFAULT_WORKER_TTL_MS = 1e4;
 var DEFAULT_STORAGE_PREFIX = "cross-tab-worker-databus";
@@ -381,6 +382,8 @@ var WorkerClusterRuntime = class {
   routeOwnerCacheMax;
   routeOwnerCacheHits = 0;
   routeOwnerCacheMisses = 0;
+  unknownMessageCount = 0;
+  lastUnknownMessageType = null;
   touchRouteOwnerCache(topicKey, value) {
     if (this.routeOwnerCache.has(topicKey)) this.routeOwnerCache.delete(topicKey);
     this.routeOwnerCache.set(topicKey, value);
@@ -737,6 +740,10 @@ var WorkerClusterRuntime = class {
     }
     return false;
   }
+  /** Count and last type of unknown protocol messages observed. */
+  getUnknownMessageStats() {
+    return { count: this.unknownMessageCount, lastType: this.lastUnknownMessageType };
+  }
   /** Read-only snapshot of the cluster state (workers, routes, assignments). */
   getSnapshot() {
     const routes = this.storage ? readAllByPrefix(this.storage, this.routePrefix).map(({ value }) => ({
@@ -744,6 +751,7 @@ var WorkerClusterRuntime = class {
       topic: this.knownTopics.get(value.topicKey) ?? null
     })) : [];
     return {
+      protocolVersion: CLUSTER_PROTOCOL_VERSION,
       coordinated: Boolean(this.storage && this.channel),
       suspended: this.suspended,
       currentWorker: { ...this.currentRecord },
@@ -800,9 +808,13 @@ var WorkerClusterRuntime = class {
       case "REGISTRY":
         this.reconcile();
         return;
-      default:
+      default: {
+        this.unknownMessageCount += 1;
+        const unknown = message;
+        this.lastUnknownMessageType = typeof unknown.type === "string" ? unknown.type : null;
         this.handlers.onUnknownMessage?.(message);
         return;
+      }
     }
   };
   /** Handle a point-to-point CONTROL message (SUBSCRIBE / UNSUBSCRIBE / PUBLISH). */
@@ -996,7 +1008,7 @@ var WorkerClusterRuntime = class {
   send(message) {
     if (!this.channel) return false;
     try {
-      this.channel.postMessage(message);
+      this.channel.postMessage({ ...message, protocolVersion: CLUSTER_PROTOCOL_VERSION });
       return true;
     } catch {
       return false;
@@ -1908,6 +1920,7 @@ var CrossTabDataBus = class {
       recovery: this.getRecoveryStats(),
       dedup: this.getDedupStats(),
       replay: { enabled: Boolean(this.replayBuffers), topics: this.replayBuffers?.size ?? 0, messages },
+      protocol: { version: this.cluster.getSnapshot().protocolVersion, unknownMessages: this.cluster.getUnknownMessageStats().count, lastUnknownMessageType: this.cluster.getUnknownMessageStats().lastType },
       cluster: this.cluster.getSnapshot()
     };
   }