cross-tab-worker-databus 0.20.58 → 0.20.59

package/dist/cjs/index.cjs

@@ -1357,6 +1357,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;
@@ -1550,7 +1557,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;
@@ -1720,9 +1731,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