cross-tab-worker-databus 0.6.0 → 0.7.0

package/dist/cjs/index.cjs

@@ -562,6 +562,7 @@ var WorkerClusterRuntime = class {
       projectedLoads.set(owner.workerId, (projectedLoads.get(owner.workerId) ?? owner.load) + 1);
       const generation = (previous?.generation ?? 0) + 1;
       this.writeRoute(topicKey, owner, previous?.workerId, generation);
+      this.handlers.onDiagnostic?.({ operation: "route_migration", topic });
       this.flushStorage();
       this.handlers.onControl("UNSUBSCRIBE", topic);
       this.sendRouteReleased(owner.workerId, topic, topicKey, generation);
@@ -946,6 +947,8 @@ var WorkerClusterRuntime = class {
       ...route,
       confirmedAt: this.environment.now()
     });
+    const topic = this.knownTopics.get(topicKey);
+    if (topic) this.handlers.onDiagnostic?.({ operation: "route_ack", topic });
   }
   /** Remove routes whose topic has no subscribers and whose TTL has expired. */
   cleanupOrphanedRoutes(workers) {
@@ -1239,6 +1242,10 @@ var CrossTabDataBus = class _CrossTabDataBus {
   initialConfig;
   hasInitialConfig;
   trace;
+  dedupMaxEntries;
+  dedupTtlMs;
+  dedupEnabled;
+  seenMessageIds = /* @__PURE__ */ new Map();
   activeConfig;
   status = "disconnected";
   started = false;
@@ -1277,11 +1284,20 @@ var CrossTabDataBus = class _CrossTabDataBus {
     this.replayBuffers = replay ? /* @__PURE__ */ new Map() : null;
     this.replayPersistence = replay?.persistence ?? null;
     this.replayHydration = this.hydrateReplay();
-    const { autoStart, initialConfig, trace, transport, ...clusterOptions } = options;
+    const { autoStart, initialConfig, trace, transport, dedup, ...clusterOptions } = options;
     this.transport = transport;
     this.initialConfig = initialConfig;
     this.hasInitialConfig = "initialConfig" in options;
     this.trace = new DataBusTraceReporter(trace);
+    this.dedupMaxEntries = dedup?.maxEntries ?? 1e3;
+    this.dedupTtlMs = dedup?.ttlMs ?? 6e4;
+    this.dedupEnabled = dedup !== void 0;
+    if (!Number.isSafeInteger(this.dedupMaxEntries) || this.dedupMaxEntries <= 0) {
+      throw new TypeError("dedup.maxEntries must be a positive safe integer.");
+    }
+    if (!Number.isFinite(this.dedupTtlMs) || this.dedupTtlMs <= 0) {
+      throw new TypeError("dedup.ttlMs must be a positive finite number.");
+    }
     this.cluster = new WorkerClusterRuntime({
       ...clusterOptions,
       handlers: {
@@ -1321,6 +1337,9 @@ var CrossTabDataBus = class _CrossTabDataBus {
           this.trace.event({ type: "lifecycle", action: "resume" });
           this.trace.start();
           this.resumeTransport();
+        },
+        onDiagnostic: (event) => {
+          this.trace.event({ type: "reliability", ...event });
         }
       }
     });
@@ -1467,6 +1486,9 @@ var CrossTabDataBus = class _CrossTabDataBus {
     if (handlers.size > 0) return;
     this.topicHandlers.delete(topic);
     this.replayBuffers?.delete(topic);
+    if (this.replayPersistence?.clearTopic) {
+      void this.replayPersistence.clearTopic(topic).catch((error) => this.reportError(error));
+    }
     this.cluster.unsubscribe(topic);
   }
   /** Publish a message to `topic`. The owning Worker delivers it to the transport. */
@@ -1522,6 +1544,7 @@ var CrossTabDataBus = class _CrossTabDataBus {
       else await this.transport.stop();
     } finally {
       this.transportSubscribedTopics.clear();
+      this.seenMessageIds.clear();
       this.started = false;
       this.stopping = false;
       this.suspended = false;
@@ -1539,6 +1562,7 @@ var CrossTabDataBus = class _CrossTabDataBus {
    * and dispatches locally.
    */
   handleTransportMessage(message) {
+    if (this.isDuplicate(message)) return;
     this.trace.recordReceived(message.topic);
     if (!this.cluster.isAssigned(message.topic)) {
       this.trace.recordDiscarded(message.topic);
@@ -1551,6 +1575,21 @@ var CrossTabDataBus = class _CrossTabDataBus {
     }
     this.trace.recordDiscarded(message.topic);
   }
+  isDuplicate(message) {
+    if (!this.dedupEnabled || !message.messageId) return false;
+    const now = Date.now();
+    for (const [id, timestamp] of this.seenMessageIds) {
+      if (now - timestamp > this.dedupTtlMs) this.seenMessageIds.delete(id);
+    }
+    if (this.seenMessageIds.has(message.messageId)) return true;
+    this.seenMessageIds.set(message.messageId, now);
+    while (this.seenMessageIds.size > this.dedupMaxEntries) {
+      const oldest = this.seenMessageIds.keys().next().value;
+      if (oldest === void 0) break;
+      this.seenMessageIds.delete(oldest);
+    }
+    return false;
+  }
   /** Deliver a message to every local handler registered for its topic,
    * plus every handler registered with a wildcard subscription that matches
    * (e.g. a handler subscribed to "chat.*" receives "chat.room.1"). */
@@ -1635,6 +1674,7 @@ var CrossTabDataBus = class _CrossTabDataBus {
       const now = Date.now();
       if (now - this.lastRecoveryAt >= _CrossTabDataBus.RECOVERY_COOLDOWN_MS) {
         this.lastRecoveryAt = now;
+        this.trace.event({ type: "reliability", operation: "transport_recovery", attempt: 1 });
         setTimeout(() => {
           if (this.stopping || !this.started || this.suspended) return;
           if (this.status !== "error") return;
@@ -1834,6 +1874,24 @@ function createIndexedDbReplayPersistence(options) {
         transaction.oncomplete = () => resolve();
         transaction.onerror = () => reject(transaction.error ?? new Error("Failed to persist replay history."));
       });
+    },
+    async clear() {
+      const db = await open();
+      await new Promise((resolve, reject) => {
+        const transaction = db.transaction(storeName, "readwrite");
+        transaction.objectStore(storeName).clear();
+        transaction.oncomplete = () => resolve();
+        transaction.onerror = () => reject(transaction.error ?? new Error("Failed to clear replay history."));
+      });
+    },
+    async clearTopic(topic) {
+      const db = await open();
+      await new Promise((resolve, reject) => {
+        const transaction = db.transaction(storeName, "readwrite");
+        transaction.objectStore(storeName).delete(topic);
+        transaction.oncomplete = () => resolve();
+        transaction.onerror = () => reject(transaction.error ?? new Error("Failed to clear topic replay history."));
+      });
     }
   };
 }