cross-tab-worker-databus 0.7.0 → 0.8.0

package/dist/cjs/index.cjs

@@ -574,20 +574,20 @@ var WorkerClusterRuntime = class {
    * posted to a remote owner, so the caller can surface the failure instead of
    * silently dropping the publication.
    */
-  publish(topic, data) {
+  publish(topic, data, messageId) {
     const topicKey = this.rememberTopic(topic);
     if (this.assignedTopics.has(topicKey)) {
-      return this.sendControl(this.workerId, "PUBLISH", topic, topicKey, data);
+      return this.sendControl(this.workerId, "PUBLISH", topic, topicKey, data, messageId);
     }
     for (const pattern of this.assignedTopics.values()) {
       if (pattern !== topic && topicMatchesPattern(pattern, topic)) {
-        return this.sendControl(this.workerId, "PUBLISH", topic, topicKey, data);
+        return this.sendControl(this.workerId, "PUBLISH", topic, topicKey, data, messageId);
       }
     }
     const workers = this.readWorkers();
     const route = this.readRoute(topicKey);
     const target = this.routeOwnerIsLive(route, workers) ? route?.workerId ?? this.workerId : this.workerId;
-    return this.sendControl(target, "PUBLISH", topic, topicKey, data);
+    return this.sendControl(target, "PUBLISH", topic, topicKey, data, messageId);
   }
   /** True when `route` exists and its owner worker is among `workers`.
    * Shared by subscribe (skip re-assignment) and publish (route to owner).
@@ -709,7 +709,11 @@ var WorkerClusterRuntime = class {
       default:
         break;
     }
-    this.handlers.onControl(message.action, message.topic, message.data);
+    if (message.messageId === void 0) {
+      this.handlers.onControl(message.action, message.topic, message.data);
+    } else {
+      this.handlers.onControl(message.action, message.topic, message.data, message.messageId);
+    }
     if (message.action !== "PUBLISH") this.updateLoad();
   }
   /**
@@ -826,7 +830,7 @@ var WorkerClusterRuntime = class {
    * Local execution updates the assignment map and route synchronously, bypassing
    * the BroadcastChannel latency.
    */
-  sendControl(targetWorkerId, action, topic, topicKey, data) {
+  sendControl(targetWorkerId, action, topic, topicKey, data, messageId) {
     if (targetWorkerId === this.workerId) {
       switch (action) {
         case "SUBSCRIBE":
@@ -840,7 +844,8 @@ var WorkerClusterRuntime = class {
         default:
           break;
       }
-      this.handlers.onControl(action, topic, data);
+      if (messageId === void 0) this.handlers.onControl(action, topic, data);
+      else this.handlers.onControl(action, topic, data, messageId);
       if (action !== "PUBLISH") this.updateLoad();
       return true;
     }
@@ -851,7 +856,8 @@ var WorkerClusterRuntime = class {
       action,
       topic,
       topicKey,
-      ...data === void 0 ? {} : { data }
+      ...data === void 0 ? {} : { data },
+      ...messageId === void 0 ? {} : { messageId }
     });
   }
   /** Post a message on the BroadcastChannel. Returns false on postMessage failure. */
@@ -1303,7 +1309,7 @@ var CrossTabDataBus = class _CrossTabDataBus {
       handlers: {
         // The cluster calls `onControl` when it receives a SUBSCRIBE/UNSUBSCRIBE/PUBLISH
         // control message — meaning the owning Worker has delegated the action to us.
-        onControl: (action, topic, data) => {
+        onControl: (action, topic, data, messageId) => {
           switch (action) {
             case "SUBSCRIBE":
               if (this.subscribeTransport(topic)) this.traceSubscription("subscribe", topic);
@@ -1312,7 +1318,7 @@ var CrossTabDataBus = class _CrossTabDataBus {
               if (this.unsubscribeTransport(topic)) this.traceSubscription("unsubscribe", topic);
               break;
             case "PUBLISH":
-              this.runTransport(() => this.transport.publish(topic, data));
+              this.runTransport(() => this.transport.publish(topic, data, messageId ? { messageId } : void 0));
               break;
             default:
               break;
@@ -1491,10 +1497,22 @@ var CrossTabDataBus = class _CrossTabDataBus {
     }
     this.cluster.unsubscribe(topic);
   }
+  /** Clear all in-memory replay buffers and, when supported, durable history. */
+  async clearReplay() {
+    this.replayBuffers?.clear();
+    if (this.replayPersistence?.clear) {
+      try {
+        await this.replayPersistence.clear();
+      } catch (error) {
+        this.reportError(error);
+        throw error;
+      }
+    }
+  }
   /** Publish a message to `topic`. The owning Worker delivers it to the transport. */
-  publish(topic, data) {
+  publish(topic, data, options) {
     this.ensureStarted();
-    if (!this.cluster.publish(topic, data)) {
+    if (!this.cluster.publish(topic, data, options?.messageId)) {
       this.reportError(
         new Error("Failed to send the publish control message to the owning worker.")
       );
@@ -1581,7 +1599,10 @@ var CrossTabDataBus = class _CrossTabDataBus {
     for (const [id, timestamp] of this.seenMessageIds) {
       if (now - timestamp > this.dedupTtlMs) this.seenMessageIds.delete(id);
     }
-    if (this.seenMessageIds.has(message.messageId)) return true;
+    if (this.seenMessageIds.has(message.messageId)) {
+      this.trace.event({ type: "reliability", operation: "dedup_suppressed", topic: message.topic });
+      return true;
+    }
     this.seenMessageIds.set(message.messageId, now);
     while (this.seenMessageIds.size > this.dedupMaxEntries) {
       const oldest = this.seenMessageIds.keys().next().value;
@@ -1943,12 +1964,12 @@ var WebSocketTransport = class {
     this.sendFrame({ op: "unsubscribe", topic });
   }
   /** Publish `data` to `topic` as a JSON frame. Requires an open socket. */
-  publish(topic, data) {
+  publish(topic, data, options) {
     if (data instanceof ArrayBuffer) {
-      this.sendBinaryFrame(topic, data);
+      this.sendBinaryFrame(topic, data, options?.messageId);
       return;
     }
-    this.sendFrame({ op: "publish", topic, data });
+    this.sendFrame({ op: "publish", topic, data, ...options?.messageId ? { messageId: options.messageId } : {} });
   }
   /** Close the socket and drop all state. Safe to call multiple times. */
   stop() {
@@ -1968,7 +1989,11 @@ var WebSocketTransport = class {
     }
     this.socket.send(JSON.stringify(payload));
   }
-  sendBinaryFrame(topic, data) {
+  sendBinaryFrame(topic, data, messageId) {
+    if (messageId) {
+      this.sendFrame({ op: "publish", topic, data: Array.from(new Uint8Array(data)), messageId });
+      return;
+    }
     if (this.socket?.readyState !== WS_OPEN) {
       this.handlers?.onError(new Error('WebSocket is not open; dropped "publish" frame.'));
       return;
@@ -2010,7 +2035,12 @@ var WebSocketTransport = class {
     if (!parsed || typeof parsed !== "object") return;
     const frame = parsed;
     if (typeof frame.topic !== "string") return;
-    this.handlers?.onMessage({ topic: frame.topic, data: frame.data });
+    const message = {
+      topic: frame.topic,
+      data: frame.data,
+      ...typeof frame.messageId === "string" ? { messageId: frame.messageId } : {}
+    };
+    this.handlers?.onMessage(message);
   }
 };
 function defaultWebSocketFactory(url, protocols) {