cross-tab-worker-databus 0.20.95 → 0.20.96

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [0.20.96] - 2026-09-22
+
+### Deprecated
+- An empty topic string (`""`) is deprecated in `subscribe()`, `publish()` and `publishBatch()`. It is still accepted and still flows through routing as a literal channel, but no transport can address such a channel, so the subscription it creates can never receive anything. The bus now logs one `console.warn` per instance the first time any of the three is called with `""`. Following the pre-1.0 deprecation policy, a future minor will reject it at that boundary with a `TypeError`, like the existing option guards. Callers using `""` as a topic should move to a real channel name.
+
+### Changed
+- Documentation and tests only, otherwise: seven behaviors that could not fail their tests are now mutation-verified — the departing-owner handoff that deletes an unserved route instead of migrating it onto a live peer, the owner's release of its transport subscription when the last remote subscriber leaves, a cancelled durable-retention sweep staying silent, a superseded hydration snapshot being dropped rather than merged, the default platform `WebSocket` construction (subprotocols included), `ready()` surfacing the recorded transport error once the recovery budget is spent, and the Vue adapter containing a rejected `ready()`. `docs/architecture.md` (en + zh) gains the **Unserved route drop** and **Last-subscriber release** invariants; `AGENTS.md` records the two `ChannelHub`/batching-writer traps and the duplicated-guard mutation trap that made early drafts decorative. `vue.ts` and `hooks.ts` are now at 100% on all four coverage metrics, and `cluster.ts` is down to one uncovered line.
+- `typescript-eslint` refreshed to `8.70.1`. TypeScript stays at `6.0.3`: the lint toolchain's peer range is still `typescript >=4.8.4 <6.1.0`, so a 7.x install breaks the lint gate before it touches this project's own types.
+
 ## [0.20.95] - 2026-09-22
 
 ### Fixed

package/dist/centrifuge.js

@@ -5,7 +5,7 @@ import {
   parseDataBusPublication,
   publicationMetadata,
   selectWorkerBackend
-} from "./chunk-7BPB2Y4E.js";
+} from "./chunk-SSSJNWCH.js";
 import {
   CENTRIFUGE_INPUT_TYPE,
   CENTRIFUGE_OUTPUT_TYPE,

package/dist/{chunk-7BPB2Y4E.js → chunk-SSSJNWCH.js}

@@ -2340,7 +2340,7 @@ var DedupManager = class {
 };
 
 // src/core/version.ts
-var SDK_VERSION = true ? "0.20.95" : "";
+var SDK_VERSION = true ? "0.20.96" : "";
 
 // src/core/data-bus.ts
 var DEFAULT_REPLAY_MAX_PER_TOPIC = 100;
@@ -2431,6 +2431,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. */
@@ -2835,6 +2839,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);
@@ -2884,8 +2889,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)) {
@@ -2904,6 +2921,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];
@@ -3532,4 +3550,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-7BPB2Y4E.js.map
+//# sourceMappingURL=chunk-SSSJNWCH.js.map