cross-tab-worker-databus 0.20.63 → 0.20.65

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.20.65] - 2026-09-05
+
+### Added
+- Added opt-in adaptive dedup TTL sampling with bounded `minMs`/`maxMs` controls and diagnostics exposure.
+- Added replay `pruneStrategy` configuration (`count`, `age`, `both`) for memory history trimming while preserving legacy defaults.
+
+## [0.20.64] - 2026-09-05
+
+### Added
+- Added opt-in `asyncSink` trace mode, batching sink delivery onto a microtask while preserving event order and sink error isolation.
+- Added regression coverage for asynchronous trace batching (339 unit tests).
+
 ## [0.20.63] - 2026-09-05
 
 ### Added

package/dist/centrifuge.js

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

package/dist/{chunk-ZHCGYGL3.js → chunk-KKSZ5GUC.js}

@@ -1158,6 +1158,9 @@ var DataBusTraceReporter = class {
   metricsIntervalMs;
   sink;
   now;
+  asyncSink;
+  pendingEvents = [];
+  sinkFlushScheduled = false;
   intervalHandle = null;
   intervalStartedAt = 0;
   // A reporter may be flushed explicitly before start(), but once stop() is
@@ -1179,6 +1182,7 @@ var DataBusTraceReporter = class {
     this.mode = options?.mode ?? "all";
     this.metricsIntervalMs = normalizeInterval(options?.metricsIntervalMs);
     this.sink = options?.sink ?? (() => void 0);
+    this.asyncSink = options?.asyncSink ?? false;
     this.now = now;
   }
   /** Start the periodic metrics flush interval. No-op when mode is 'events'
@@ -1305,6 +1309,22 @@ var DataBusTraceReporter = class {
     this.dedupSuppressed = 0;
   }
   emit(event) {
+    if (this.asyncSink) {
+      this.pendingEvents.push(event);
+      if (!this.sinkFlushScheduled) {
+        this.sinkFlushScheduled = true;
+        queueMicrotask(() => {
+          this.sinkFlushScheduled = false;
+          const events = this.pendingEvents;
+          this.pendingEvents = [];
+          for (const queued of events) this.emitSync(queued);
+        });
+      }
+      return;
+    }
+    this.emitSync(event);
+  }
+  emitSync(event) {
     try {
       this.sink(event);
     } catch (error) {
@@ -1360,6 +1380,7 @@ var CrossTabDataBus = class {
   replayMaxPerTopic;
   replayPersistence;
   replayRetentionMs;
+  replayPruneStrategy;
   replayRetentionSweepMs;
   persistenceRetryMaxAttempts;
   persistenceRetryBackoffMs;
@@ -1375,6 +1396,10 @@ var CrossTabDataBus = class {
   trace;
   dedupMaxEntries;
   dedupTtlMs;
+  dedupAdaptiveBounds;
+  dedupWindowStartedAt = 0;
+  dedupWindowAccepted = 0;
+  dedupAdaptiveWindowMs = 5e3;
   dedupSweepMs;
   dedupSweepTimer = null;
   dedupEnabled;
@@ -1433,6 +1458,8 @@ var CrossTabDataBus = class {
     this.replayBuffers = replay ? /* @__PURE__ */ new Map() : null;
     this.replayPersistence = replay?.persistence ?? null;
     this.replayRetentionMs = replay?.retentionMs;
+    this.replayPruneStrategy = replay?.pruneStrategy ?? "count";
+    if (!["count", "age", "both"].includes(this.replayPruneStrategy)) throw new TypeError("replay.pruneStrategy must be count, age, or both.");
     if (this.replayRetentionMs !== void 0 && (!Number.isFinite(this.replayRetentionMs) || this.replayRetentionMs <= 0)) {
       throw new TypeError("replay.retentionMs must be a positive finite number.");
     }
@@ -1465,6 +1492,9 @@ var CrossTabDataBus = class {
     this.trace = new DataBusTraceReporter(trace);
     this.dedupMaxEntries = dedup?.maxEntries ?? 1e3;
     this.dedupTtlMs = dedup?.ttlMs ?? 6e4;
+    this.dedupAdaptiveBounds = dedup?.adaptiveTtl;
+    if (this.dedupAdaptiveBounds && (this.dedupAdaptiveBounds.minMs <= 0 || this.dedupAdaptiveBounds.maxMs < this.dedupAdaptiveBounds.minMs)) throw new TypeError("dedup.adaptiveTtl bounds are invalid.");
+    this.dedupWindowStartedAt = this.now();
     this.dedupSweepMs = dedup?.sweepMs;
     this.dedupEnabled = dedup !== void 0;
     if (!Number.isSafeInteger(this.dedupMaxEntries) || this.dedupMaxEntries <= 0) {
@@ -1738,7 +1768,8 @@ var CrossTabDataBus = class {
       enabled: this.dedupEnabled,
       tracked: this.seenMessageIds.size,
       suppressed: this.dedupSuppressed,
-      accepted: this.dedupAccepted
+      accepted: this.dedupAccepted,
+      ...this.dedupAdaptiveBounds ? { ttlMs: this.currentDedupTtl() } : {}
     };
   }
   /** Drop all remembered IDs and reset dedup counters. */
@@ -1910,6 +1941,7 @@ var CrossTabDataBus = class {
     }
     this.seenMessageIds.set(message.messageId, now);
     this.dedupAccepted += 1;
+    this.dedupWindowAccepted += 1;
     this.trace.recordDedupAccepted();
     while (this.seenMessageIds.size > this.dedupMaxEntries) {
       const oldest = this.seenMessageIds.keys().next().value;
@@ -1927,11 +1959,24 @@ var CrossTabDataBus = class {
     this.dedupSweepTimer = null;
   }
   pruneExpiredDedup() {
-    const cutoff = this.now() - this.dedupTtlMs;
+    const cutoff = this.now() - this.currentDedupTtl();
     for (const [id, timestamp] of this.seenMessageIds) {
       if (timestamp < cutoff) this.seenMessageIds.delete(id);
     }
   }
+  currentDedupTtl() {
+    if (!this.dedupAdaptiveBounds) return this.dedupTtlMs;
+    const now = this.now();
+    const elapsed = now - this.dedupWindowStartedAt;
+    if (elapsed >= this.dedupAdaptiveWindowMs) {
+      this.dedupWindowStartedAt = now;
+      this.dedupWindowAccepted = 0;
+      return this.dedupAdaptiveBounds.maxMs;
+    }
+    const rate = this.dedupWindowAccepted / Math.max(1, elapsed);
+    const factor = Math.min(1, rate / 0.01);
+    return this.dedupAdaptiveBounds.maxMs - (this.dedupAdaptiveBounds.maxMs - this.dedupAdaptiveBounds.minMs) * factor;
+  }
   /** Deliver a message to every local handler registered for its topic,
    * plus every handler registered with a wildcard subscription that matches
    * (e.g. a handler subscribed to "chat.*" receives "chat.room.1"). */
@@ -1956,7 +2001,17 @@ var CrossTabDataBus = class {
     }
     const storedMessage = message;
     buffer.push(storedMessage);
-    if (buffer.length > this.replayMaxPerTopic) buffer.shift();
+    if (this.replayPruneStrategy !== "age") {
+      while (buffer.length > this.replayMaxPerTopic) buffer.shift();
+    }
+    if (this.replayPruneStrategy !== "count" && this.replayRetentionMs !== void 0) {
+      const cutoff = this.now() - this.replayRetentionMs;
+      while (buffer.length > 0) {
+        const first = buffer[0];
+        if (!first || first.timestamp === void 0 || first.timestamp >= cutoff) break;
+        buffer.shift();
+      }
+    }
     if (this.replayPersistence) {
       void this.withPersistenceRetry("append", () => this.replayPersistence.append(storedMessage)).catch((error) => this.reportPersistenceError(error));
       if (this.replayRetentionMs !== void 0 && this.replayPersistence.clearBefore) {
@@ -2309,4 +2364,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-ZHCGYGL3.js.map
+//# sourceMappingURL=chunk-KKSZ5GUC.js.map