cross-tab-worker-databus 0.20.87 → 0.20.89

package/dist/cjs/centrifuge.cjs

@@ -1661,8 +1661,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);
   }
@@ -1675,6 +1676,7 @@ var DataBusTraceReporter = class {
   }
   stop() {
     this.stopped = true;
+    this.pendingEvents = [];
     this.pause();
   }
   /** Synchronous sink state for diagnostics: whether delivery is async and how
@@ -1685,7 +1687,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.
@@ -1768,7 +1770,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() {
@@ -2070,6 +2072,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). */
@@ -2168,19 +2172,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);
       }
     });
@@ -2197,7 +2202,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();
@@ -2331,7 +2338,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;
@@ -2525,10 +2532,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) => {
@@ -2558,15 +2562,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);
@@ -2681,6 +2689,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;
@@ -2691,13 +2700,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.");
@@ -2711,18 +2723,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;
     });
   }
@@ -2919,7 +2934,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,
@@ -2990,7 +3005,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();
     }
@@ -3086,7 +3101,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;
@@ -3138,9 +3153,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;
@@ -3160,8 +3175,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). */
@@ -3224,6 +3245,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.
@@ -3236,8 +3266,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;
@@ -3332,10 +3365,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.
@@ -3441,6 +3481,10 @@ var CentrifugeSession = class {
   transferable = false;
   tokenBridge = false;
   nextRequestId = 1;
+  // Bumped on every initialize/stop. Async client callbacks capture the value
+  // from the connection that created them so a stopped client cannot emit into
+  // a later session instance (including the main-thread local fallback).
+  lifecycle = 0;
   pendingTokenRequests = /* @__PURE__ */ new Map();
   /** Dispatch an incoming Worker message to the matching operation.
    * Unknown message types are ignored rather than thrown, so a future protocol
@@ -3476,6 +3520,7 @@ var CentrifugeSession = class {
   /** Create the Centrifuge client, wire up lifecycle listeners, and connect. */
   initialize(url, config, transferable, tokenBridge) {
     if (this.client) return;
+    const lifecycle = ++this.lifecycle;
     this.transferable = transferable;
     this.tokenBridge = tokenBridge;
     const clientOptions = tokenBridge ? {
@@ -3489,12 +3534,23 @@ var CentrifugeSession = class {
     const client = new import_centrifuge.Centrifuge(url, clientOptions);
     this.client = client;
     client.on("state", (context) => {
+      if (this.lifecycle !== lifecycle) return;
       this.post({ type: CENTRIFUGE_OUTPUT_TYPE.STATUS, status: normalizeStatus(context.newState) });
     });
-    client.on("connected", () => this.post({ type: CENTRIFUGE_OUTPUT_TYPE.STATUS, status: WORKER_STATUS.CONNECTED }));
-    client.on("disconnected", () => this.post({ type: CENTRIFUGE_OUTPUT_TYPE.STATUS, status: WORKER_STATUS.DISCONNECTED }));
-    client.on("error", (context) => this.postError(context));
+    client.on("connected", () => {
+      if (this.lifecycle !== lifecycle) return;
+      this.post({ type: CENTRIFUGE_OUTPUT_TYPE.STATUS, status: WORKER_STATUS.CONNECTED });
+    });
+    client.on("disconnected", () => {
+      if (this.lifecycle !== lifecycle) return;
+      this.post({ type: CENTRIFUGE_OUTPUT_TYPE.STATUS, status: WORKER_STATUS.DISCONNECTED });
+    });
+    client.on("error", (context) => {
+      if (this.lifecycle !== lifecycle) return;
+      this.postError(context);
+    });
     client.on("publication", (context) => {
+      if (this.lifecycle !== lifecycle) return;
       const topic = context.channel || getPayloadTopic(context.data);
       if (!topic || this.subscriptions.has(topic)) return;
       this.postPublication(topic, context.data);
@@ -3507,6 +3563,7 @@ var CentrifugeSession = class {
    * avoiding the removeAllListeners + re-on churn on every duplicate message. */
   subscribe(topic) {
     if (!this.client) return this.postError(new Error("Centrifuge client is not initialized."));
+    const lifecycle = this.lifecycle;
     const existing = this.subscriptions.get(topic);
     if (existing) {
       existing.subscribe();
@@ -3519,10 +3576,16 @@ var CentrifugeSession = class {
     subscription.removeAllListeners("unsubscribed");
     this.subscriptions.set(topic, subscription);
     subscription.on("publication", (context) => {
+      if (this.lifecycle !== lifecycle) return;
       this.postPublication(topic, context.data);
     });
-    subscription.on("error", (context) => this.postError(context));
-    subscription.on("unsubscribed", () => this.subscriptions.delete(topic));
+    subscription.on("error", (context) => {
+      if (this.lifecycle !== lifecycle) return;
+      this.postError(context);
+    });
+    subscription.on("unsubscribed", () => {
+      if (this.lifecycle === lifecycle) this.subscriptions.delete(topic);
+    });
     subscription.subscribe();
   }
   /** Unsubscribe from a Centrifuge channel and clean up the local reference.
@@ -3540,13 +3603,16 @@ var CentrifugeSession = class {
   /** Publish a message to the Centrifuge channel. */
   publish(topic, data, messageId, timestamp) {
     if (!this.client) return this.postError(new Error("Centrifuge client is not initialized."));
+    const lifecycle = this.lifecycle;
     const hasMetadata = messageId !== void 0 || timestamp !== void 0;
     const payload = hasMetadata ? {
       data,
       ...messageId === void 0 ? {} : { messageId },
       ...timestamp === void 0 ? {} : { timestamp }
     } : data;
-    void this.client.publish(topic, payload).catch((error) => this.postError(error));
+    void this.client.publish(topic, payload).catch((error) => {
+      if (this.lifecycle === lifecycle) this.postError(error);
+    });
   }
   /** Forward a publication to the transport. Binary payloads take the
    * zero-copy `MESSAGE_BIN` path when `transferable` is enabled; everything
@@ -3569,6 +3635,7 @@ var CentrifugeSession = class {
   }
   /** Disconnect the client and clear all subscriptions. */
   stop() {
+    this.lifecycle += 1;
     for (const [, pending] of this.pendingTokenRequests) {
       pending.reject(new Error("Centrifuge session stopped before the credential was resolved."));
     }
@@ -3582,9 +3649,14 @@ var CentrifugeSession = class {
    * Used as Centrifuge's `getToken` / `getChannelToken` when token bridging is
    * enabled; resolved or rejected by a matching TOKEN_RESPONSE / TOKEN_ERROR. */
   requestToken(kind, channel) {
+    const lifecycle = this.lifecycle;
     const requestId = this.nextRequestId;
     this.nextRequestId += 1;
     return new Promise((resolve, reject) => {
+      if (this.lifecycle !== lifecycle) {
+        reject(new Error("Centrifuge session stopped before the credential was requested."));
+        return;
+      }
       this.pendingTokenRequests.set(requestId, { resolve, reject });
       this.post({
         type: CENTRIFUGE_OUTPUT_TYPE.TOKEN_REQUEST,
@@ -3805,10 +3877,24 @@ var CentrifugeWorkerTransport = class {
    * credentialProvider, then post the fresh token (or a serialized failure)
    * back to the session that issued the request. */
   resolveTokenRequest(requestId, kind, channel) {
+    const generation = this.generation;
+    const worker = this.worker;
+    const port = this.port;
+    const localSession = this.localSession;
+    const isCurrentBackend = () => this.generation === generation && this.worker === worker && this.port === port && this.localSession === localSession;
     const provider = this.credentialProvider;
-    const value = kind === "channelToken" && provider?.getChannelToken ? provider.getChannelToken(channel ?? "") : provider?.getToken?.();
+    let value;
+    try {
+      value = kind === "channelToken" && provider?.getChannelToken ? provider.getChannelToken(channel ?? "") : provider?.getToken?.();
+    } catch (error) {
+      if (isCurrentBackend()) {
+        this.post({ type: CENTRIFUGE_INPUT_TYPE.TOKEN_ERROR, requestId, error: serializeError(error) });
+      }
+      return;
+    }
     Promise.resolve(value).then(
       (token) => {
+        if (!isCurrentBackend()) return;
         if (typeof token !== "string" || token.length === 0) {
           this.post({
             type: CENTRIFUGE_INPUT_TYPE.TOKEN_ERROR,
@@ -3820,6 +3906,7 @@ var CentrifugeWorkerTransport = class {
         this.post({ type: CENTRIFUGE_INPUT_TYPE.TOKEN_RESPONSE, requestId, token });
       },
       (error) => {
+        if (!isCurrentBackend()) return;
         this.post({ type: CENTRIFUGE_INPUT_TYPE.TOKEN_ERROR, requestId, error: serializeError(error) });
       }
     );