cross-tab-worker-databus 0.20.87 → 0.20.89

package/dist/cjs/index.cjs

@@ -1659,8 +1659,9 @@ var DataBusTraceReporter = class {
   /** Start the periodic metrics flush interval. No-op when mode is 'events'
    * (no metrics to emit), when disabled, or when already running. */
   start() {
-    if (!this.enabled || this.intervalHandle || this.mode === TRACE_MODE.EVENTS) return;
+    if (!this.enabled) return;
     this.stopped = false;
+    if (this.intervalHandle || this.mode === TRACE_MODE.EVENTS) return;
     this.intervalStartedAt = this.now();
     this.intervalHandle = setInterval(() => this.flush(), this.metricsIntervalMs);
   }
@@ -1673,6 +1674,7 @@ var DataBusTraceReporter = class {
   }
   stop() {
     this.stopped = true;
+    this.pendingEvents = [];
     this.pause();
   }
   /** Synchronous sink state for diagnostics: whether delivery is async and how
@@ -1683,7 +1685,7 @@ var DataBusTraceReporter = class {
   }
   /** Record an instantaneous trace event (lifecycle, status, error, etc.). */
   event(event) {
-    if (!this.enabled || this.mode === TRACE_MODE.METRICS) return;
+    if (!this.enabled || this.stopped || this.mode === TRACE_MODE.METRICS) return;
     this.emit({ ...event, timestamp: this.now() });
   }
   /** Synchronous snapshot of the current metrics window without resetting it.
@@ -1766,7 +1768,7 @@ var DataBusTraceReporter = class {
    * Extracted so the four record / flush methods share one guard expression
    * instead of repeating `!this.enabled || this.mode === 'events'` at each. */
   get metricsActive() {
-    return this.enabled && this.mode !== TRACE_MODE.EVENTS;
+    return this.enabled && !this.stopped && this.mode !== TRACE_MODE.EVENTS;
   }
   /** Emit the accumulated metrics snapshot if the interval is active. */
   flush() {
@@ -2068,6 +2070,8 @@ var ReplayManager = class {
    * or stopped bus does not keep hammering the store) and stop the sweep. */
   suspend() {
     this.retryGeneration += 1;
+    this.pendingReplayPersistence = [];
+    this.retentionCutoff = null;
     this.stop();
   }
   /** Drop all in-memory buffers (used on full teardown). */
@@ -2166,19 +2170,20 @@ var ReplayManager = class {
       this.retentionCutoff = cutoff;
     }
     if (this.retentionCleanup) return;
+    const generation = this.retryGeneration;
     this.retentionCleanup = (async () => {
-      while (this.retentionCutoff !== null) {
+      while (this.retentionCutoff !== null && generation === this.retryGeneration) {
         const nextCutoff = this.retentionCutoff;
         this.retentionCutoff = null;
         try {
           await this.persistence.clearBefore(nextCutoff);
         } catch (error) {
-          this.onPersistenceError(error);
+          if (generation === this.retryGeneration) this.onPersistenceError(error);
         }
       }
     })().finally(() => {
       this.retentionCleanup = null;
-      if (this.retentionCutoff !== null) {
+      if (this.retentionCutoff !== null && generation === this.retryGeneration) {
         this.scheduleRetentionCleanup(this.retentionCutoff);
       }
     });
@@ -2195,7 +2200,9 @@ var ReplayManager = class {
       attempt += 1;
       try {
         if (generation !== this.retryGeneration) throw new PersistenceRetryCancelledError();
-        return await operation();
+        const result = await operation();
+        if (generation !== this.retryGeneration) throw new PersistenceRetryCancelledError();
+        return result;
       } catch (error) {
         if (error instanceof PersistenceRetryCancelledError || generation !== this.retryGeneration) {
           throw new PersistenceRetryCancelledError();
@@ -2329,7 +2336,7 @@ var DedupManager = class {
 };
 
 // src/core/version.ts
-var SDK_VERSION = true ? "0.20.87" : "";
+var SDK_VERSION = true ? "0.20.89" : "";
 
 // src/core/data-bus.ts
 var DEFAULT_REPLAY_MAX_PER_TOPIC = 100;
@@ -2523,10 +2530,7 @@ var CrossTabDataBus = class {
           this.suspendTransport();
         },
         onResume: () => {
-          this.trace.event({ type: TRACE_EVENT_TYPE.LIFECYCLE, action: TRACE_LIFECYCLE_ACTION.RESUME });
-          this.trace.start();
-          this.startDedupSweep();
-          this.replayManager.start();
+          this.resumeSuspendedResources();
           this.resumeTransport();
         },
         onDiagnostic: (event) => {
@@ -2556,15 +2560,19 @@ var CrossTabDataBus = class {
       if (!transportDown) return Promise.resolve();
       this.activeConfig = config;
       this.resetFailureState();
-      return this.reopenTransport();
+      const resumingFromSuspend = this.suspended;
+      if (resumingFromSuspend) this.resumeSuspendedResources();
+      const opening2 = this.reopenTransport();
+      if (resumingFromSuspend) this.cluster.start();
+      return opening2;
     }
     this.started = true;
     this.stopping = false;
     this.suspended = false;
     this.activeConfig = config;
     this.resetFailureState();
-    this.trace.event({ type: TRACE_EVENT_TYPE.LIFECYCLE, action: TRACE_LIFECYCLE_ACTION.START });
     this.trace.start();
+    this.trace.event({ type: TRACE_EVENT_TYPE.LIFECYCLE, action: TRACE_LIFECYCLE_ACTION.START });
     this.startDedupSweep();
     this.replayManager.start();
     this.updateStatus(WORKER_STATUS.CONNECTING);
@@ -2679,6 +2687,7 @@ var CrossTabDataBus = class {
     this.transportReady = false;
     const chainedPendingStop = this.pendingStop;
     const isCurrentLifecycle = () => lifecycleEpoch === this.lifecycleEpoch;
+    let startupInProgress = true;
     return before.catch(() => void 0).then(() => {
       if (!isCurrentLifecycle() || this.stopping || this.suspended) return;
       if (this.pendingStop === chainedPendingStop) this.pendingStop = null;
@@ -2689,13 +2698,16 @@ var CrossTabDataBus = class {
             if (isCurrentLifecycle()) this.handleTransportMessage(message);
           },
           onStatus: (status) => {
-            if (isCurrentLifecycle()) this.updateStatus(status);
+            if (isCurrentLifecycle()) {
+              this.updateStatus(status, status !== WORKER_STATUS.ERROR || !startupInProgress);
+            }
           },
           onError: (error) => {
             if (isCurrentLifecycle()) this.reportError(error);
           }
         })
       ).then(() => {
+        startupInProgress = false;
         if (!isCurrentLifecycle()) return;
         if (this.status === WORKER_STATUS.ERROR) {
           throw new Error("Transport failed during startup.");
@@ -2709,18 +2721,21 @@ var CrossTabDataBus = class {
       });
     }).catch((error) => {
       if (!isCurrentLifecycle()) throw error;
+      startupInProgress = false;
       if (stopClusterOnFailure) this.started = false;
       if (!this.pendingStop) {
         this.pendingStop = this.createStopPromise();
       }
       this.transportReady = false;
-      this.updateStatus(WORKER_STATUS.ERROR);
-      this.reportError(error);
       if (stopClusterOnFailure) {
         this.stopping = true;
         this.cluster.stop();
         this.stopping = false;
       }
+      this.recordError(error);
+      this.startPromise = null;
+      this.updateStatus(WORKER_STATUS.ERROR);
+      this.notifyError(error);
       throw error;
     });
   }
@@ -2917,7 +2932,7 @@ var CrossTabDataBus = class {
   getHealthSummary() {
     const transport = this.transport;
     const transportDown = this.status !== WORKER_STATUS.CONNECTED;
-    const state = !this.started ? HEALTH_STATE.STOPPED : this.suspended ? HEALTH_STATE.SUSPENDED : transportDown ? this.recoveryExhausted ? HEALTH_STATE.DEGRADED : this.status === WORKER_STATUS.CONNECTING && this.recoveryAttempt === 0 ? HEALTH_STATE.STARTING : HEALTH_STATE.RECOVERING : HEALTH_STATE.HEALTHY;
+    const state = !this.started || this.stopping ? HEALTH_STATE.STOPPED : this.suspended ? HEALTH_STATE.SUSPENDED : transportDown ? this.recoveryExhausted ? HEALTH_STATE.DEGRADED : this.status === WORKER_STATUS.CONNECTING && this.recoveryAttempt === 0 ? HEALTH_STATE.STARTING : HEALTH_STATE.RECOVERING : HEALTH_STATE.HEALTHY;
     return {
       healthy: state === HEALTH_STATE.HEALTHY,
       state,
@@ -2988,7 +3003,7 @@ var CrossTabDataBus = class {
       this.canceledQueuedStartToken = this.queuedStartToken;
       this.queuedStart = null;
     }
-    if (this.stopPromise) return this.stopPromise;
+    if (this.stopPromise && this.stopping) return this.stopPromise;
     if (!this.started && !this.startPromise && !this.pendingStop && !this.transportReady) {
       return Promise.resolve();
     }
@@ -3084,7 +3099,7 @@ var CrossTabDataBus = class {
    * Propagate a status change to the cluster, trace, and all registered
    * status handlers. On reconnect, re-subscribe any topics assigned to us.
    */
-  updateStatus(status) {
+  updateStatus(status, notifyHandlers = true) {
     const previousStatus = this.status;
     this.status = status;
     if (status === WORKER_STATUS.CONNECTED) this.transportHasConnected = true;
@@ -3136,9 +3151,9 @@ var CrossTabDataBus = class {
     } else if (status === WORKER_STATUS.ERROR) {
       this.releaseRecoveryGate();
     }
-    this.invokeHandlers(this.statusHandlers, (handler) => handler(status));
+    if (notifyHandlers) this.invokeHandlers(this.statusHandlers, (handler) => handler(status));
   }
-  reportError(error, source = FAILURE_SOURCE.TRANSPORT) {
+  recordError(error, source = FAILURE_SOURCE.TRANSPORT) {
     const at = this.now();
     if (source === FAILURE_SOURCE.TRANSPORT) {
       this.lastError = error;
@@ -3158,8 +3173,14 @@ var CrossTabDataBus = class {
       type: TRACE_EVENT_TYPE.ERROR,
       source: source === FAILURE_SOURCE.TRANSPORT ? TRACE_ERROR_SOURCE.TRANSPORT : TRACE_ERROR_SOURCE.OPERATION
     });
+  }
+  notifyError(error) {
     this.invokeHandlers(this.errorHandlers, (handler) => handler(error), INVOKE_LABEL.ERROR_HANDLER);
   }
+  reportError(error, source = FAILURE_SOURCE.TRANSPORT) {
+    this.recordError(error, source);
+    this.notifyError(error);
+  }
   /** Report a persistence failure to the trace and the unified failure ledger,
    * unless it is a {@link PersistenceRetryCancelledError} cancellation from a
    * lifecycle transition (teardown should stay quiet). */
@@ -3222,6 +3243,15 @@ var CrossTabDataBus = class {
       }
     }
   }
+  /** Resume the resources paused by a pagehide suspension. Both the native
+   * pageshow path and explicit start() must run this so an explicit resume
+   * cannot leave trace metrics and periodic cleanup timers permanently off. */
+  resumeSuspendedResources() {
+    this.trace.start();
+    this.trace.event({ type: TRACE_EVENT_TYPE.LIFECYCLE, action: TRACE_LIFECYCLE_ACTION.RESUME });
+    this.startDedupSweep();
+    this.replayManager.start();
+  }
   /**
    * Suspend the transport when the tab goes hidden. Stops the transport and
    * clears subscription state so it will be re-established on resume.
@@ -3234,8 +3264,11 @@ var CrossTabDataBus = class {
     this.transportReady = false;
     this.transportSubscribedTopics.clear();
     this.updateStatus(WORKER_STATUS.DISCONNECTED);
-    if (this.pendingStop) return;
-    const pending = this.startPromise ?? Promise.resolve();
+    if (this.pendingStop && (this.startPromise === null || this.startPromise === this.pendingStop)) {
+      this.startPromise = this.pendingStop;
+      return;
+    }
+    const pending = this.startPromise ?? this.pendingStop ?? Promise.resolve();
     const stopping = pending.catch(() => void 0).then(() => this.transport.stop()).catch((error) => this.reportError(error));
     this.startPromise = stopping;
     this.pendingStop = stopping;
@@ -3330,10 +3363,17 @@ var CrossTabDataBus = class {
       ready = this.reopenTransport();
     }
     if (!ready || this.stopping) return;
-    void ready.then(() => {
-      if (!this.started || this.stopping || this.suspended) return;
-      return operation();
-    }).catch((error) => this.reportError(error));
+    void ready.then(
+      () => {
+        if (!this.started || this.stopping || this.suspended) return;
+        return operation();
+      },
+      // The opening promise reports its own lifecycle failure through
+      // openTransport(). Swallowing it here prevents a stale startup
+      // rejection from being recorded again after an onStatus/onError
+      // callback has already started and reset the ledger for a retry.
+      () => void 0
+    ).catch((error) => this.reportError(error));
   }
   /**
    * Publications started after teardown begins cannot reach any transport.
@@ -3903,10 +3943,16 @@ var WebSocketTransport = class {
    * server cannot crash the message path. */
   async handleMessage(raw) {
     if (typeof Blob !== "undefined" && raw instanceof Blob) {
+      const socket = this.socket;
+      const handlers = this.handlers;
       try {
-        await this.handleMessage(await raw.arrayBuffer());
+        const buffer = await raw.arrayBuffer();
+        if (this.socket !== socket || this.handlers !== handlers || !this.socketActive) return;
+        await this.handleMessage(buffer);
       } catch (error) {
-        this.handlers?.onError(error);
+        if (this.socket === socket && this.handlers === handlers && this.socketActive) {
+          this.handlers?.onError(error);
+        }
       }
       return;
     }