cross-tab-worker-databus 0.20.16 → 0.20.18

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/)；变更记录格式参考 [Keep a Changelog](https://keepachangelog.com/)。
 
+## [0.20.18] - 2026-09-03
+
+### Added
+
+- Added optional `recovery.cooldownMs` to tune automatic transport reopen pacing for different runtime environments.
+- Added validation and fake-timer coverage for custom recovery cooldowns.
+
+## [0.20.17] - 2026-09-03
+
+### Added
+
+- Consecutive transport recovery traces now carry monotonic attempt numbers and reset after a successful reopen.
+- Added regression coverage for multi-failure recovery sequences.
+
 ## [0.20.16] - 2026-09-03
 
 ### Added

package/dist/centrifuge.js

@@ -2,7 +2,7 @@ import {
   CrossTabDataBus,
   parseDataBusPublication,
   selectWorkerBackend
-} from "./chunk-WSJN2RG7.js";
+} from "./chunk-UN5Q6JUA.js";
 
 // src/centrifuge-session.ts
 import { Centrifuge } from "centrifuge";

package/dist/{chunk-WSJN2RG7.js → chunk-UN5Q6JUA.js}

@@ -1220,7 +1220,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.
@@ -1272,6 +1272,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;
@@ -1281,7 +1284,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) {
@@ -1311,7 +1314,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;
@@ -1867,14 +1874,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));
@@ -1964,10 +1972,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");
@@ -1976,11 +1985,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);
@@ -2081,4 +2095,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-WSJN2RG7.js.map
+//# sourceMappingURL=chunk-UN5Q6JUA.js.map