cross-tab-worker-databus 0.20.16 → 0.20.18

package/dist/cjs/index.cjs

@@ -1261,7 +1261,7 @@ var PersistenceRetryCancelledError = class extends Error {
     this.name = "PersistenceRetryCancelledError";
   }
 };
-var CrossTabDataBus = class _CrossTabDataBus {
+var CrossTabDataBus = class {
   transport;
   cluster;
   // Map of topic → set of local subscribers.
@@ -1313,6 +1313,9 @@ var CrossTabDataBus = class _CrossTabDataBus {
   // Timestamp of the last automatic transport recovery attempt.
   // Used to avoid a tight retry loop when the transport fails repeatedly.
   lastRecoveryAt = 0;
+  // Monotonic attempt number within one runtime recovery sequence; reset once
+  // a transport reopen succeeds so traces can correlate repeated failures.
+  recoveryAttempt = 0;
   // True while the tab is hidden so an in-flight transport start does not mark
   // the transport ready after suspendTransport() has stopped it.
   suspended = false;
@@ -1322,7 +1325,7 @@ var CrossTabDataBus = class _CrossTabDataBus {
   // stop to settle.
   pendingStop = null;
   // Minimum interval in ms between automatic recovery attempts.
-  static RECOVERY_COOLDOWN_MS = 1e3;
+  recoveryCooldownMs;
   constructor(options) {
     const replay = options.replay;
     if (replay) {
@@ -1352,7 +1355,11 @@ var CrossTabDataBus = class _CrossTabDataBus {
     if (!Number.isFinite(this.persistenceRetryBackoffMs) || this.persistenceRetryBackoffMs < 0) {
       throw new TypeError("replay.persistenceRetry.backoffMs must be a non-negative finite number.");
     }
-    const { autoStart, initialConfig, trace, transport, dedup, ...clusterOptions } = options;
+    const { autoStart, initialConfig, trace, transport, dedup, recovery, ...clusterOptions } = options;
+    this.recoveryCooldownMs = recovery?.cooldownMs ?? 1e3;
+    if (!Number.isFinite(this.recoveryCooldownMs) || this.recoveryCooldownMs <= 0) {
+      throw new TypeError("recovery.cooldownMs must be a positive finite number.");
+    }
     this.now = dedup?.now ?? Date.now;
     this.replayHydration = this.hydrateReplay();
     this.transport = transport;
@@ -1908,14 +1915,15 @@ var CrossTabDataBus = class _CrossTabDataBus {
     }
     if (status === "error" && this.started && !this.stopping) {
       const now = this.now();
-      if (now - this.lastRecoveryAt >= _CrossTabDataBus.RECOVERY_COOLDOWN_MS) {
+      if (now - this.lastRecoveryAt >= this.recoveryCooldownMs) {
         this.lastRecoveryAt = now;
-        this.trace.event({ type: "reliability", operation: "transport_recovery", attempt: 1, outcome: "scheduled" });
+        const attempt = ++this.recoveryAttempt;
+        this.trace.event({ type: "reliability", operation: "transport_recovery", attempt, outcome: "scheduled" });
         setTimeout(() => {
           if (this.stopping || !this.started || this.suspended) return;
           if (this.status !== "error") return;
-          void this.reopenTransport();
-        }, _CrossTabDataBus.RECOVERY_COOLDOWN_MS);
+          void this.reopenTransport(attempt);
+        }, this.recoveryCooldownMs);
       }
     }
     this.invokeHandlers(this.statusHandlers, (handler) => handler(status));
@@ -2005,10 +2013,11 @@ var CrossTabDataBus = class _CrossTabDataBus {
    * its rejection so the reopen is not blocked. Returns the opening promise so
    * callers can queue operations behind it.
    */
-  reopenTransport() {
+  reopenTransport(recoveryAttempt) {
     if (this.stopping || this.activeConfig === void 0) return Promise.resolve();
     if (this.startPromise && this.startPromise !== this.pendingStop) return this.startPromise;
     const config = this.activeConfig;
+    const traceAttempt = recoveryAttempt ?? (this.recoveryAttempt > 0 ? this.recoveryAttempt : void 0);
     this.started = true;
     this.suspended = false;
     this.updateStatus("connecting");
@@ -2017,11 +2026,16 @@ var CrossTabDataBus = class _CrossTabDataBus {
     this.startPromise = opening;
     void opening.then(
       () => {
-        this.trace.event({ type: "reliability", operation: "transport_recovery", attempt: 1, outcome: "succeeded" });
+        if (traceAttempt !== void 0) {
+          this.trace.event({ type: "reliability", operation: "transport_recovery", attempt: traceAttempt, outcome: "succeeded" });
+          this.recoveryAttempt = 0;
+        }
         if (this.startPromise === opening) this.startPromise = null;
       },
       () => {
-        this.trace.event({ type: "reliability", operation: "transport_recovery", attempt: 1, outcome: "failed" });
+        if (traceAttempt !== void 0) {
+          this.trace.event({ type: "reliability", operation: "transport_recovery", attempt: traceAttempt, outcome: "failed" });
+        }
       }
     );
     void opening.catch(() => void 0);