cross-tab-worker-databus 0.20.59 → 0.20.60

package/CHANGELOG.md

@@ -1,4 +1,12 @@
 # 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

package/dist/centrifuge.js

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

package/dist/{chunk-RAUX7RZC.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;
     }
@@ -1670,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);
@@ -2182,4 +2288,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-RAUX7RZC.js.map
+//# sourceMappingURL=chunk-KLHPSFVU.js.map