cross-tab-worker-databus 0.20.17 → 0.20.19

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/)；变更记录格式参考 [Keep a Changelog](https://keepachangelog.com/)。
 
+## [0.20.19] - 2026-09-03
+
+### Added
+
+- Added optional `recovery.maxAttempts` to cap automatic transport reopen attempts while preserving explicit demand-driven recovery.
+- Added validation and regression coverage for capped recovery sequences.
+
+## [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

package/dist/centrifuge.js

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

package/dist/{chunk-LZ7S62BQ.js → chunk-TC7XXOVN.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.
@@ -1284,7 +1284,8 @@ var CrossTabDataBus = class _CrossTabDataBus {
   // stop to settle.
   pendingStop = null;
   // Minimum interval in ms between automatic recovery attempts.
-  static RECOVERY_COOLDOWN_MS = 1e3;
+  recoveryCooldownMs;
+  recoveryMaxAttempts;
   constructor(options) {
     const replay = options.replay;
     if (replay) {
@@ -1314,7 +1315,15 @@ 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;
+    this.recoveryMaxAttempts = recovery?.maxAttempts ?? Number.POSITIVE_INFINITY;
+    if (!Number.isFinite(this.recoveryCooldownMs) || this.recoveryCooldownMs <= 0) {
+      throw new TypeError("recovery.cooldownMs must be a positive finite number.");
+    }
+    if (!(this.recoveryMaxAttempts === Number.POSITIVE_INFINITY || Number.isSafeInteger(this.recoveryMaxAttempts) && this.recoveryMaxAttempts > 0)) {
+      throw new TypeError("recovery.maxAttempts must be a positive safe integer.");
+    }
     this.now = dedup?.now ?? Date.now;
     this.replayHydration = this.hydrateReplay();
     this.transport = transport;
@@ -1870,15 +1879,16 @@ 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;
         const attempt = ++this.recoveryAttempt;
+        if (attempt > this.recoveryMaxAttempts) return;
         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(attempt);
-        }, _CrossTabDataBus.RECOVERY_COOLDOWN_MS);
+        }, this.recoveryCooldownMs);
       }
     }
     this.invokeHandlers(this.statusHandlers, (handler) => handler(status));
@@ -2091,4 +2101,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-LZ7S62BQ.js.map
+//# sourceMappingURL=chunk-TC7XXOVN.js.map