cross-tab-worker-databus 0.20.58 → 0.20.60

package/CHANGELOG.md

@@ -1,4 +1,18 @@
 # Changelog
+## [0.20.60] - 2026-09-04
+
+### Added
+- `publishBatch(topic, items)` on both `CrossTabDataBus` and `WorkerClusterRuntime` packs multiple items into a single BroadcastChannel postMessage so the receiving owner can dispatch them in one tick instead of one channel post per item.
+- Per-item `messageId` / `timestamp` is preserved across the batched wire frame, so dedup / replay / ordering still apply per item in the original order.
+- Empty batch is a no-op; single-item batch delegates to `publish()` so callers do not have to special-case the boundary.
+- Added a `data bus hot paths` bench case (`publishBatch / 1000 messages / 10 per call`) to give an upper-bound reference for the burst path.
+
+## [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-KLHPSFVU.js";
 
 // src/centrifuge-session.ts
 import { Centrifuge } from "centrifuge";

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

@@ -572,6 +572,67 @@ var WorkerClusterRuntime = class {
       }
       this.wildcardPublishCache.set(topic, null);
     }
+    return this.sendControl(this.resolvePublishTarget(topic, topicKey), "PUBLISH", topic, topicKey, data, metadata);
+  }
+  /**
+   * Burst-friendly variant of `publish()`: packs up to N items into a single
+   * BroadcastChannel postMessage so the receiving owner dispatches them all in
+   * one tick. Per-item dedup / replay / dispatch ordering is preserved; items
+   * may carry their own messageId/timestamp. Empty batch is a no-op,
+   * single-item batch delegates to `publish()`.
+   */
+  publishBatch(topic, items) {
+    if (items.length === 0) return true;
+    if (items.length === 1) {
+      const single = items[0];
+      const metadata = single.messageId !== void 0 || single.timestamp !== void 0 ? {
+        ...single.messageId !== void 0 ? { messageId: single.messageId } : {},
+        ...single.timestamp !== void 0 ? { timestamp: single.timestamp } : {}
+      } : void 0;
+      return this.publish(topic, single.data, metadata);
+    }
+    const topicKey = this.rememberTopic(topic);
+    if (this.assignedTopics.has(topicKey)) {
+      for (const item of items) this.dispatchLocalPublish(topic, topicKey, item.data, item.messageId, item.timestamp);
+      return true;
+    }
+    const cachedPattern = this.wildcardPublishCache.get(topic);
+    if (cachedPattern !== void 0 && cachedPattern !== null && this.assignedTopics.has(cachedPattern)) {
+      for (const item of items) this.dispatchLocalPublish(topic, topicKey, item.data, item.messageId, item.timestamp);
+      return true;
+    }
+    if (cachedPattern === void 0) {
+      for (const pattern of this.assignedTopics.values()) {
+        if (pattern !== topic && topicMatchesPattern(pattern, topic)) {
+          this.wildcardPublishCache.set(topic, pattern);
+          for (const item of items) this.dispatchLocalPublish(topic, topicKey, item.data, item.messageId, item.timestamp);
+          return true;
+        }
+      }
+      this.wildcardPublishCache.set(topic, null);
+    }
+    const target = this.resolvePublishTarget(topic, topicKey);
+    if (target === this.workerId) {
+      for (const item of items) this.dispatchLocalPublish(topic, topicKey, item.data, item.messageId, item.timestamp);
+      return true;
+    }
+    return this.send({
+      type: "CONTROL",
+      sourceWorkerId: this.workerId,
+      targetWorkerId: target,
+      action: "PUBLISH",
+      topic,
+      topicKey,
+      items: items.map((item) => ({
+        data: item.data,
+        ...item.messageId !== void 0 ? { messageId: item.messageId } : {},
+        ...item.timestamp !== void 0 ? { timestamp: item.timestamp } : {}
+      }))
+    });
+  }
+  /** Resolve which worker should receive a PUBLISH for `topic`. Centralises the
+   * route-owner cache lookup so `publish()` and `publishBatch()` share one path. */
+  resolvePublishTarget(topic, topicKey) {
     const workers = this.readWorkers();
     const route = this.readRoute(topicKey);
     const cached = this.routeOwnerCache.get(topicKey);
@@ -579,9 +640,19 @@ var WorkerClusterRuntime = class {
     if (cachedLive) this.routeOwnerCacheHits += 1;
     else this.routeOwnerCacheMisses += 1;
     const target = cachedLive ? cached.workerId : this.routeOwnerIsLive(route, workers) ? route?.workerId ?? this.workerId : this.workerId;
-    if (route && target === route.workerId) this.touchRouteOwnerCache(topicKey, { workerId: route.workerId, generation: route.generation });
-    else this.routeOwnerCache.delete(topicKey);
-    return this.sendControl(target, "PUBLISH", topic, topicKey, data, metadata);
+    if (route && target === route.workerId) {
+      this.touchRouteOwnerCache(topicKey, { workerId: route.workerId, generation: route.generation });
+    } else {
+      this.routeOwnerCache.delete(topicKey);
+    }
+    return target;
+  }
+  /** Fan out a single batched item to the local onControl path. */
+  dispatchLocalPublish(topic, topicKey, data, messageId, timestamp) {
+    void topicKey;
+    const meta = publicationMetadata(messageId, timestamp);
+    if (meta) this.handlers.onControl("PUBLISH", topic, data, meta.messageId, meta.timestamp);
+    else this.handlers.onControl("PUBLISH", topic, data);
   }
   /** True when `route` exists and its owner worker is among `workers`.
    * Shared by subscribe (skip re-assignment) and publish (route to owner).
@@ -701,6 +772,15 @@ var WorkerClusterRuntime = class {
         if (this.releaseHandoffOnUnsubscribe(message)) return;
         break;
       case "PUBLISH":
+        if (message.items && message.items.length > 0) {
+          for (const item of message.items) {
+            const itemMeta = publicationMetadata(item.messageId, item.timestamp);
+            if (itemMeta) this.handlers.onControl("PUBLISH", message.topic, item.data, itemMeta.messageId, itemMeta.timestamp);
+            else this.handlers.onControl("PUBLISH", message.topic, item.data);
+          }
+          return;
+        }
+        break;
       default:
         break;
     }
@@ -1316,6 +1396,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 +1596,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;
@@ -1659,6 +1750,32 @@ var CrossTabDataBus = class {
       );
     }
   }
+  /**
+   * Burst-friendly variant of `publish()`: delivers `items` in a single
+   * BroadcastChannel postMessage so the receiving owner can dispatch them all
+   * in one tick. Per-item dedup / replay / ordering is preserved; each item
+   * may carry its own `messageId` / `timestamp` via `options`. Empty array is
+   * a no-op; single-item array delegates to `publish()`.
+   */
+  publishBatch(topic, items) {
+    this.ensureStarted();
+    if (items.length === 0) return;
+    if (items.length === 1) {
+      const first = items[0];
+      this.publish(topic, first.data, first.options);
+      return;
+    }
+    const mapped = items.map((item) => ({
+      data: item.data,
+      ...item.options?.messageId !== void 0 ? { messageId: item.options.messageId } : {},
+      ...item.options?.timestamp !== void 0 ? { timestamp: item.options.timestamp } : {}
+    }));
+    if (!this.cluster.publishBatch(topic, mapped)) {
+      this.reportError(
+        new Error("Failed to send the batched publish control message to the owning worker.")
+      );
+    }
+  }
   /** Register a handler that fires on every transport status change. Immediately invoked with the current status. */
   onStatus(handler) {
     this.statusHandlers.add(handler);
@@ -1679,9 +1796,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 +2288,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-BWSJUUUP.js.map
+//# sourceMappingURL=chunk-KLHPSFVU.js.map