cross-tab-worker-databus 0.20.18 → 0.20.20

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/)；变更记录格式参考 [Keep a Changelog](https://keepachangelog.com/)。
 
+## [0.20.20] - 2026-09-03
+
+### Added
+
+- Automatic recovery now emits an `exhausted` reliability event when `recovery.maxAttempts` is reached, instead of stopping silently.
+
+## [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

package/dist/centrifuge.js

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

package/dist/{chunk-UN5Q6JUA.js → chunk-2PUSQWOL.js}

@@ -1285,6 +1285,7 @@ var CrossTabDataBus = class {
   pendingStop = null;
   // Minimum interval in ms between automatic recovery attempts.
   recoveryCooldownMs;
+  recoveryMaxAttempts;
   constructor(options) {
     const replay = options.replay;
     if (replay) {
@@ -1316,9 +1317,13 @@ var CrossTabDataBus = class {
     }
     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;
@@ -1877,6 +1882,10 @@ var CrossTabDataBus = class {
       if (now - this.lastRecoveryAt >= this.recoveryCooldownMs) {
         this.lastRecoveryAt = now;
         const attempt = ++this.recoveryAttempt;
+        if (attempt > this.recoveryMaxAttempts) {
+          this.trace.event({ type: "reliability", operation: "transport_recovery", attempt: this.recoveryMaxAttempts, outcome: "exhausted" });
+          return;
+        }
         this.trace.event({ type: "reliability", operation: "transport_recovery", attempt, outcome: "scheduled" });
         setTimeout(() => {
           if (this.stopping || !this.started || this.suspended) return;
@@ -2095,4 +2104,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-UN5Q6JUA.js.map
+//# sourceMappingURL=chunk-2PUSQWOL.js.map