cross-tab-worker-databus 0.20.64 → 0.20.65

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 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

package/dist/centrifuge.js

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

package/dist/{chunk-5CP7GNU6.js → chunk-KKSZ5GUC.js}

@@ -1380,6 +1380,7 @@ var CrossTabDataBus = class {
   replayMaxPerTopic;
   replayPersistence;
   replayRetentionMs;
+  replayPruneStrategy;
   replayRetentionSweepMs;
   persistenceRetryMaxAttempts;
   persistenceRetryBackoffMs;
@@ -1395,6 +1396,10 @@ var CrossTabDataBus = class {
   trace;
   dedupMaxEntries;
   dedupTtlMs;
+  dedupAdaptiveBounds;
+  dedupWindowStartedAt = 0;
+  dedupWindowAccepted = 0;
+  dedupAdaptiveWindowMs = 5e3;
   dedupSweepMs;
   dedupSweepTimer = null;
   dedupEnabled;
@@ -1453,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.");
     }
@@ -1485,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) {
@@ -1758,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. */
@@ -1930,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;
@@ -1947,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"). */
@@ -1976,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) {
@@ -2329,4 +2364,4 @@ export {
   parseDataBusPublication,
   selectWorkerBackend
 };
-//# sourceMappingURL=chunk-5CP7GNU6.js.map
+//# sourceMappingURL=chunk-KKSZ5GUC.js.map