cross-tab-worker-databus 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -19,6 +19,19 @@
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-08-31
+
+### Added
+
+- 真实浏览器发布基准入口：`pnpm bench:browser`，在本地 Centrifuge 演示服务上用两个真实标签页分别测 dedicated/shared Worker 的跨 Tab 发布耗时。
+- 可选 replay 持久化契约与 IndexedDB 实现：`createIndexedDbReplayPersistence({ maxPerTopic })`；默认仍为纯内存，持久化失败通过错误处理器报告。
+- E2E：新增真实 Chrome reload 场景，验证 IndexedDB replay 历史在页面重建后恢复（总计 8 项 E2E）。
+
+### Notes
+
+- 当前基准包含页面点击、JSON 序列化、Worker/Storage/BroadcastChannel、服务端回显和接收端渲染，结果用于端到端回归趋势，不等同于核心 `publish()` 微基准。
+- 2026-08-31 本机 Chrome 100 条消息采样：dedicated 约 34.03 ms/条，shared 约 33.89 ms/条；两者接近，暂不据此改动 publish 路径，避免在缺少核心 profile 时引入陈旧路由缓存。
+
 ## [0.3.0] - 2026-08-29
 
 ### Added

package/dist/centrifuge.js

@@ -1,7 +1,7 @@
 import {
   CrossTabDataBus,
   selectWorkerBackend
-} from "./chunk-ZGQRELIV.js";
+} from "./chunk-W7DAXK4D.js";
 import "./chunk-5WRI5ZAA.js";
 
 // src/centrifuge-session.ts

package/dist/{chunk-ZGQRELIV.js → chunk-W7DAXK4D.js}

@@ -1185,6 +1185,8 @@ var CrossTabDataBus = class _CrossTabDataBus {
   // replay is enabled — buffering is opt-in and must cost nothing otherwise.
   replayBuffers;
   replayMaxPerTopic;
+  replayPersistence;
+  replayHydration;
   initialConfig;
   hasInitialConfig;
   trace;
@@ -1224,6 +1226,8 @@ var CrossTabDataBus = class _CrossTabDataBus {
     }
     this.replayMaxPerTopic = replay?.maxPerTopic ?? DEFAULT_REPLAY_MAX_PER_TOPIC;
     this.replayBuffers = replay ? /* @__PURE__ */ new Map() : null;
+    this.replayPersistence = replay?.persistence ?? null;
+    this.replayHydration = this.hydrateReplay();
     const { autoStart, initialConfig, trace, transport, ...clusterOptions } = options;
     this.transport = transport;
     this.initialConfig = initialConfig;
@@ -1392,7 +1396,13 @@ var CrossTabDataBus = class _CrossTabDataBus {
         typeof options.replay === "number" ? Math.floor(options.replay) : this.replayMaxPerTopic,
         this.replayMaxPerTopic
       );
-      this.deliverReplay(topic, limit, handler);
+      if (this.replayPersistence) {
+        void this.replayHydration.then(() => {
+          if (this.topicHandlers.get(topic)?.has(handler)) this.deliverReplay(topic, limit, handler);
+        });
+      } else {
+        this.deliverReplay(topic, limit, handler);
+      }
     }
     return () => this.unsubscribe(topic, handler);
   }
@@ -1516,6 +1526,27 @@ var CrossTabDataBus = class _CrossTabDataBus {
     }
     buffer.push(message);
     if (buffer.length > this.replayMaxPerTopic) buffer.shift();
+    if (this.replayPersistence) {
+      void this.replayPersistence.append(message).catch((error) => this.reportError(error));
+    }
+  }
+  async hydrateReplay() {
+    if (!this.replayBuffers || !this.replayPersistence) {
+      return;
+    }
+    try {
+      for (const message of await this.replayPersistence.load()) {
+        let buffer = this.replayBuffers.get(message.topic);
+        if (!buffer) {
+          buffer = [];
+          this.replayBuffers.set(message.topic, buffer);
+        }
+        buffer.push(message);
+        if (buffer.length > this.replayMaxPerTopic) buffer.shift();
+      }
+    } catch (error) {
+      this.reportError(error);
+    }
   }
   /** Deliver buffered history to a newly-registered handler. For an exact
    * topic this is that topic's ring; for a wildcard subscription every
@@ -1735,4 +1766,4 @@ export {
   CrossTabDataBus,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-ZGQRELIV.js.map
+//# sourceMappingURL=chunk-W7DAXK4D.js.map