cross-tab-worker-databus 0.20.95 → 0.20.97

package/dist/cjs/index.cjs

@@ -2466,7 +2466,7 @@ var DedupManager = class {
 };
 
 // src/core/version.ts
-var SDK_VERSION = true ? "0.20.95" : "";
+var SDK_VERSION = true ? "0.20.97" : "";
 
 // src/core/data-bus.ts
 var DEFAULT_REPLAY_MAX_PER_TOPIC = 100;
@@ -2557,6 +2557,10 @@ var CrossTabDataBus = class {
   // themselves demand: the failure path starts an on-demand reopen instead of
   // stranding them until some unrelated future operation arrives.
   recoveryWaiters = 0;
+  // Latch for the empty-topic deprecation warning so a hot publish path cannot
+  // fill the console. It is per-bus and never reset: the warning is about the
+  // caller's code, not about a transient runtime condition.
+  emptyTopicWarned = 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. */
@@ -2961,6 +2965,7 @@ var CrossTabDataBus = class {
       };
     }
     this.ensureStarted();
+    if (topic === "") this.warnEmptyTopic("subscribe");
     const handlers = this.topicHandlers.get(topic) ?? /* @__PURE__ */ new Set();
     const wasUnused = handlers.size === 0;
     handlers.add(handler);
@@ -3010,8 +3015,20 @@ var CrossTabDataBus = class {
   resetDedup() {
     this.dedupManager.reset();
   }
+  /** Warn (once per bus) that an empty topic is deprecated, without changing
+   * behavior yet. `''` flows through routing as a literal channel, so the
+   * subscription it creates can never be addressed by a transport: the message
+   * silently goes nowhere. A future minor rejects it at this boundary. */
+  warnEmptyTopic(operation) {
+    if (this.emptyTopicWarned) return;
+    this.emptyTopicWarned = true;
+    console.warn(
+      `cross-tab-worker-databus: ${operation}("") addresses a channel no transport can route. Use a non-empty topic; passing "" is planned to throw in a future minor.`
+    );
+  }
   /** Publish a message to `topic`. The owning Worker delivers it to the transport. */
   publish(topic, data, options) {
+    if (topic === "") this.warnEmptyTopic("publish");
     this.ensureStarted();
     if (this.rejectPublishDuringStop("publish")) return;
     if (!this.cluster.publish(topic, data, options)) {
@@ -3030,6 +3047,7 @@ var CrossTabDataBus = class {
   publishBatch(topic, items) {
     this.ensureStarted();
     if (items.length === 0) return;
+    if (topic === "") this.warnEmptyTopic("publishBatch");
     if (this.rejectPublishDuringStop("publishBatch")) return;
     if (items.length === 1) {
       const first = items[0];