cross-tab-worker-databus 0.20.58 → 0.20.59

package/CHANGELOG.md

@@ -1,4 +1,10 @@
 # Changelog
+## [0.20.59] - 2026-09-04
+
+### Added
+- Extended `CrossTabDataBus.getRecoveryStats()` with `generation` (monotonic counter incremented on every successful transport open) and `lastSuccessAt` (timestamp of the most recent successful open, or `null` until the transport reaches `ready`).
+- Added a unit test asserting generation/lastSuccessAt advance on the initial start and after a recovery, and stay stable across failed recovery attempts.
+
 ## [0.20.58] - 2026-09-04
 
 ### Changed

package/dist/centrifuge.js

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

package/dist/{chunk-BWSJUUUP.js → chunk-RAUX7RZC.js}

@@ -1316,6 +1316,13 @@ var CrossTabDataBus = class {
   // a transport reopen succeeds so traces can correlate repeated failures.
   recoveryAttempt = 0;
   recoveryExhausted = false;
+  /** Monotonic generation incremented on every successful transport open.
+   * Stays in lockstep with `lastSuccessAt` so callers can detect that the
+   * transport has been reopened even if the timestamp window is short. */
+  recoveryGeneration = 0;
+  /** Timestamp of the most recent successful transport open. Null until the
+   * transport has reached the `ready` state at least once. */
+  lastSuccessAt = null;
   // 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;
@@ -1509,7 +1516,11 @@ var CrossTabDataBus = class {
         if (this.status === "error") {
           throw new Error("Transport failed during startup.");
         }
-        if (!this.suspended && !this.stopping) this.transportReady = true;
+        if (!this.suspended && !this.stopping) {
+          this.recoveryGeneration += 1;
+          this.lastSuccessAt = this.now();
+          this.transportReady = true;
+        }
       });
     }).catch((error) => {
       if (stopClusterOnFailure) this.started = false;
@@ -1679,9 +1690,22 @@ var CrossTabDataBus = class {
     return this.status;
   }
   /** Return the current automatic transport recovery state. `hasError` means a transport error is currently retained. */
+  /** Return the current automatic transport recovery state plus diagnostics.
+   * `generation` increments on every successful transport open (initial start
+   * and every recovery); `lastSuccessAt` is the timestamp of the most recent
+   * successful open, or `null` until the transport reaches `ready`. */
   getRecoveryStats() {
     const errorMessage = this.lastError instanceof Error ? this.lastError.message : this.lastError === null ? null : String(this.lastError);
-    return { attempt: this.recoveryAttempt, exhausted: this.recoveryExhausted, maxAttempts: this.recoveryMaxAttempts, hasError: this.lastError !== null, errorMessage, errorAt: this.lastErrorAt };
+    return {
+      attempt: this.recoveryAttempt,
+      exhausted: this.recoveryExhausted,
+      maxAttempts: this.recoveryMaxAttempts,
+      hasError: this.lastError !== null,
+      errorMessage,
+      errorAt: this.lastErrorAt,
+      generation: this.recoveryGeneration,
+      lastSuccessAt: this.lastSuccessAt
+    };
   }
   /** Snapshot of the cluster state (workers, routes, assignments).
    * For diagnostics only — the returned object is a shallow copy but
@@ -2158,4 +2182,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-BWSJUUUP.js.map
+//# sourceMappingURL=chunk-RAUX7RZC.js.map