cross-tab-worker-databus 0.20.70 → 0.20.85

package/dist/core/dedup-manager.d.ts

@@ -0,0 +1,98 @@
+/**
+ * DedupManager — bounded duplicate suppression for publications carrying
+ * `messageId`.
+ *
+ * Extracted from CrossTabDataBus so the seen-ID map, adaptive TTL, and sweep
+ * timer live in one self-contained unit with their own lifecycle. The DataBus
+ * keeps a thin delegation: `isDuplicate()` on the inbound path, `start`/`stop`
+ * on the lifecycle transitions, and `getStats()`/`reset()` on the diagnostics
+ * surface.
+ *
+ * Deduplication is opt-in: an instance is only created when the DataBus was
+ * configured with `dedup` options, so the zero-overhead default (no map, no
+ * timer) is preserved.
+ */
+import type { DataBusTraceReporter } from './trace';
+/** Opt-in bounded duplicate suppression for publications carrying `messageId`. */
+export interface DataBusDedupOptions {
+    /** Max remembered message IDs before the oldest (FIFO) entry is evicted.
+     * Default 1_000. */
+    maxEntries?: number;
+    /** Time-to-live for a remembered ID. Default 60_000 ms. */
+    ttlMs?: number;
+    /** Optional periodic sweep interval for quiet-topic expiry. */
+    sweepMs?: number;
+    /** Injectable epoch clock for deterministic tests and non-wall-clock hosts. */
+    now?: () => number;
+    /** Optional adaptive TTL bounds; enabled only when both are provided. */
+    adaptiveTtl?: {
+        minMs: number;
+        maxMs: number;
+    };
+}
+/** Bounded deduplication counters for diagnostics and health checks. */
+export interface DataBusDedupStats {
+    enabled: boolean;
+    /** Currently remembered message IDs. */
+    tracked: number;
+    /** Publications suppressed as duplicates since the last reset. */
+    suppressed: number;
+    /** Publications accepted (tracked) since the last reset. */
+    accepted: number;
+    /** Effective TTL when adaptive bounds are configured. */
+    ttlMs?: number;
+}
+/** Resolved constructor options after defaults are applied. */
+export interface DedupManagerOptions {
+    /** Whether deduplication is enabled at all (false → no-op instance). */
+    enabled: boolean;
+    maxEntries: number;
+    ttlMs: number;
+    adaptiveBounds?: {
+        minMs: number;
+        maxMs: number;
+    } | undefined;
+    /** Optional periodic sweep interval for quiet-topic expiry. */
+    sweepMs?: number | undefined;
+    /** Injectable epoch clock; also used as the message-arrival clock. */
+    now: () => number;
+    /** Trace sink for suppression events and metrics counters. */
+    trace: DataBusTraceReporter;
+}
+export declare class DedupManager {
+    private readonly enabled;
+    private readonly maxEntries;
+    private readonly ttlMs;
+    private readonly adaptiveBounds;
+    private readonly sweepMs;
+    private readonly now;
+    private readonly trace;
+    private readonly seenMessageIds;
+    private sweepTimer;
+    private windowStartedAt;
+    private windowAccepted;
+    private suppressed;
+    private accepted;
+    constructor(options: DedupManagerOptions);
+    /** True when a publication carrying `messageId` was already seen. Records the
+     * ID and updates counters/trace on acceptance. Disabled or ID-less messages
+     * always pass through. */
+    isDuplicate(messageId: string, topic: string): boolean;
+    /** Start the periodic expiry sweep. No-op when disabled or no sweepMs was
+     * configured (the hot-path opportunistic expiry still bounds the map). */
+    start(): void;
+    /** Stop the periodic expiry sweep. */
+    stop(): void;
+    /** Return bounded deduplication counters for diagnostics and health checks. */
+    getStats(): DataBusDedupStats;
+    /** Drop all remembered IDs and reset dedup counters. */
+    reset(): void;
+    /** Remove IDs whose timestamp predates the effective TTL cutoff. */
+    private pruneExpired;
+    /** Effective TTL: the fixed `ttlMs` unless adaptive bounds are configured, in
+     * which case a higher recent message rate shortens the window (dedup only
+     * needs to live long enough to bridge duplicate bursts). The window resets
+     * every ADAPTIVE_WINDOW_MS. */
+    private currentTtl;
+}
+//# sourceMappingURL=dedup-manager.d.ts.map

package/dist/core/dedup-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup-manager.d.ts","sourceRoot":"","sources":["../../src/core/dedup-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAGpD,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC;wBACoB;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC9D,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,sEAAsE;IACtE,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,8DAA8D;IAC9D,KAAK,EAAE,oBAAoB,CAAC;CAC7B;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAC9E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAK;gBAET,OAAO,EAAE,mBAAmB;IAWxC;;8BAE0B;IAC1B,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAmCtD;8EAC0E;IAC1E,KAAK,IAAI,IAAI;IAKb,sCAAsC;IACtC,IAAI,IAAI,IAAI;IAKZ,+EAA+E;IAC/E,QAAQ,IAAI,iBAAiB;IAU7B,wDAAwD;IACxD,KAAK,IAAI,IAAI;IAQb,oEAAoE;IACpE,OAAO,CAAC,YAAY;IAOpB;;;mCAG+B;IAC/B,OAAO,CAAC,UAAU;CAanB"}

package/dist/core/environment.d.ts

@@ -6,6 +6,8 @@
  * with custom adapters injected via `ClusterEnvironment`.
  */
 import type { TabVisibilityState, WorkerClusterMessage } from './types';
+import { CHANNEL_FALLBACK } from '../utils/constants';
+import type { EVENT_TYPE } from '../utils/constants';
 /** Minimal storage interface compatible with both localStorage and MemoryStorage. */
 export interface StorageLike {
     readonly length: number;
@@ -17,8 +19,8 @@ export interface StorageLike {
 }
 /** Minimal BroadcastChannel interface. The cluster uses it for control messages and event fan-out. */
 export interface ClusterChannel {
-    addEventListener(type: 'message', listener: (event: MessageEvent<WorkerClusterMessage>) => void): void;
-    removeEventListener(type: 'message', listener: (event: MessageEvent<WorkerClusterMessage>) => void): void;
+    addEventListener(type: typeof EVENT_TYPE.MESSAGE, listener: (event: MessageEvent<WorkerClusterMessage>) => void): void;
+    removeEventListener(type: typeof EVENT_TYPE.MESSAGE, listener: (event: MessageEvent<WorkerClusterMessage>) => void): void;
     postMessage(message: WorkerClusterMessage): void;
     close(): void;
 }
@@ -57,12 +59,50 @@ export interface ClusterEnvironment {
     /** Remove a previously-added pageshow listener. */
     removePageShowListener: (listener: () => void) => void;
 }
+/** Minimal window surface the storage-event channel needs (injectable for tests). */
+export interface StorageEventWindow {
+    addEventListener(type: 'storage', listener: (event: {
+        key: string | null;
+        newValue: string | null;
+    }) => void): void;
+    removeEventListener(type: 'storage', listener: (event: {
+        key: string | null;
+        newValue: string | null;
+    }) => void): void;
+}
+/**
+ * Create a {@link ClusterChannel} backed by localStorage `storage` events, as
+ * a coordination fallback for environments where BroadcastChannel is
+ * unavailable. Returns null when localStorage or a storage-event source is
+ * missing.
+ *
+ * Semantics mirror BroadcastChannel: writes are not echoed to the sender
+ * (per spec, the writing tab receives no `storage` event) and every message
+ * is JSON-serializable. The payload is written under a dedicated key and
+ * removed on close.
+ *
+ * Security note: unlike BroadcastChannel messages (memory only), these
+ * payloads transit through localStorage and therefore persist — at least
+ * transiently, and after a crash indefinitely. Coordination frames carry
+ * plaintext topic names; callers who enable this fallback accept that
+ * trade-off (see docs/configuration.md).
+ */
+export declare function createStorageEventChannel(options: {
+    name: string;
+    storage: StorageLike | null;
+    win: StorageEventWindow | null;
+}): ClusterChannel | null;
 /**
  * Default environment adapter for browser runtimes.
  * Probes for localStorage, BroadcastChannel, document, and window APIs
  * and gracefully returns null / no-ops when they are absent (SSR, Node).
  */
-export declare function createBrowserEnvironment(): ClusterEnvironment;
+export declare function createBrowserEnvironment(options?: {
+    /** When BroadcastChannel is unavailable, fall back to a localStorage
+     * storage-event channel instead of degrading to local mode. Opt-in because
+     * the fallback persists coordination payloads in localStorage. */
+    channelFallback?: (typeof CHANNEL_FALLBACK)[keyof typeof CHANNEL_FALLBACK];
+}): ClusterEnvironment;
 /**
  * Probe a storage instance with a write-read-delete round-trip.
  * Returns a type guard so the caller can narrow the type after a successful check.

package/dist/core/environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/core/environment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAExE,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,sGAAsG;AACtG,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACvG,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1G,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACjD,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,cAAc,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,2DAA2D;IAC3D,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,kEAAkE;IAClE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,GAAG,IAAI,CAAC;IACvD,4DAA4D;IAC5D,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IACnE,wCAAwC;IACxC,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,sDAAsD;IACtD,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;IAC7C,uDAAuD;IACvD,2BAA2B,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC5D,2DAA2D;IAC3D,8BAA8B,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC/D,wDAAwD;IACxD,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,mDAAmD;IACnD,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACvD,iEAAiE;IACjE,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,mDAAmD;IACnD,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACxD;AA2BD;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,CAoC7D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,IAAI,WAAW,CASnG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,kBAAkB,EAC/B,GAAG,SAAoC,GACtC,MAAM,CAqBR"}
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/core/environment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAA8D,MAAM,oBAAoB,CAAC;AAClH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,sGAAsG;AACtG,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,IAAI,EAAE,OAAO,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IACvH,mBAAmB,CAAC,IAAI,EAAE,OAAO,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,oBAAoB,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1H,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACjD,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,cAAc,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,2DAA2D;IAC3D,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,kEAAkE;IAClE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,GAAG,IAAI,CAAC;IACvD,4DAA4D;IAC5D,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IACnE,wCAAwC;IACxC,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC,sDAAsD;IACtD,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;IAC7C,uDAAuD;IACvD,2BAA2B,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC5D,2DAA2D;IAC3D,8BAA8B,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IAC/D,wDAAwD;IACxD,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,mDAAmD;IACnD,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACvD,iEAAiE;IACjE,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACpD,mDAAmD;IACnD,sBAAsB,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACxD;AAsBD,qFAAqF;AACrF,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACpH,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACxH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAChC,GAAG,cAAc,GAAG,IAAI,CAmDxB;AAOD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACjD;;sEAEkE;IAClE,eAAe,CAAC,EAAE,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;CAC5E,GAAG,kBAAkB,CA8CrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,IAAI,WAAW,CASnG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,kBAAkB,EAC/B,GAAG,SAAqB,GACvB,MAAM,CAqBR"}

package/dist/core/replay-manager.d.ts

@@ -0,0 +1,128 @@
+import type { DataBusReplayPersistence } from './replay-persistence';
+import type { DataBusTraceReporter } from './trace';
+import type { DataBusMessage, DataBusMessageHandler } from './types';
+import { PRUNE_STRATEGY } from '../utils/constants';
+/** Thrown when a lifecycle transition cancels an in-flight persistence retry. */
+export declare class PersistenceRetryCancelledError extends Error {
+    constructor();
+}
+/** Resolved constructor options after the DataBus applies defaults. */
+export interface ReplayManagerDeps<TData = unknown> {
+    /** Whether replay buffering is enabled at all (false → no-op instance). */
+    enabled: boolean;
+    /** Maximum buffered publications per topic. */
+    maxPerTopic: number;
+    /** Optional durable history backend; null → in-memory only. */
+    persistence?: DataBusReplayPersistence<TData> | null;
+    /** Optional producer-timestamp retention window in milliseconds. */
+    retentionMs?: number | undefined;
+    /** History trimming policy. */
+    pruneStrategy: (typeof PRUNE_STRATEGY)[keyof typeof PRUNE_STRATEGY];
+    /** Optional periodic sweep interval for durable retention cleanup. */
+    retentionSweepMs?: number | undefined;
+    /** Total persistence attempts including the initial operation. */
+    persistenceRetryMaxAttempts: number;
+    /** Initial delay between persistence retry attempts. */
+    persistenceRetryBackoffMs: number;
+    /** Injectable epoch clock; used for retention cutoffs. */
+    now: () => number;
+    /** Trace sink for persistence retry/cleanup diagnostics. */
+    trace: DataBusTraceReporter;
+    /** Sink for persistence failures (routes to the DataBus failure ledger). */
+    onPersistenceError: (error: unknown) => void;
+    /** Sink for a throwing replay-delivery handler (dispatch error source). */
+    onDispatchError: (error: unknown) => void;
+}
+export declare class ReplayManager<TData = unknown> {
+    private readonly deps;
+    private readonly buffers;
+    private readonly maxPerTopic;
+    private readonly persistence;
+    private readonly retentionMs;
+    private readonly pruneStrategy;
+    private readonly retentionSweepMs;
+    private readonly persistenceRetryMaxAttempts;
+    private readonly persistenceRetryBackoffMs;
+    private readonly now;
+    private readonly trace;
+    private readonly onPersistenceError;
+    private readonly onDispatchError;
+    /** Bumped on suspend/stop so in-flight persistence retries are cancelled. */
+    private retryGeneration;
+    private pendingReplayPersistence;
+    private persistenceFlushScheduled;
+    private readonly hydration;
+    /** Coalesced retention cleanup: the newest cutoff wins while one is running. */
+    private retentionCleanup;
+    private retentionCutoff;
+    private retentionTimer;
+    constructor(deps: ReplayManagerDeps<TData>);
+    /** True when replay buffering is enabled. */
+    get enabled(): boolean;
+    /** Append a dispatched publication to the topic's replay ring buffer.
+     * No-op when replay is disabled. */
+    record(message: DataBusMessage<TData>): void;
+    /** Deliver buffered history to a newly-registered handler. For an exact
+     * topic this is that topic's ring; for a wildcard subscription every
+     * buffered topic matching the pattern contributes (in buffer insertion
+     * order). Replay deliveries are marked `replayed: true` and are not counted
+     * into trace metrics.
+     *
+     * When a durable persistence backend is present, delivery waits for the
+     * hydration load to settle first; `isHandlerActive` is then consulted so a
+     * handler that unsubscribed during the async load does not receive history.
+     */
+    deliverReplay(topic: string, replayOption: boolean | number, handler: DataBusMessageHandler<TData>, isHandlerActive?: () => boolean): void;
+    /** Clean up a topic that lost its last local handler: drop the ring buffer,
+     * filter queued batch flushes (so an in-flight append cannot undo the
+     * clearTopic), and prune durable history. */
+    onTopicUnsubscribed(topic: string): void;
+    /** Clear all in-memory replay buffers and, when supported, durable history.
+     * Reports persistence failures and rethrows, mirroring the public API
+     * contract that callers can observe a failed clear. */
+    clearAll(): Promise<void>;
+    /** Clear replay history for one exact topic, including durable storage. */
+    clearTopic(topic: string): Promise<void>;
+    /** Remove replay entries older than an epoch-millisecond cutoff. */
+    clearBefore(timestamp: number): Promise<void>;
+    /** Start the periodic retention sweep. No-op when no durable retention
+     * config makes it necessary. */
+    start(): void;
+    /** Stop the periodic retention sweep. */
+    stop(): void;
+    /** Suspend the manager: cancel in-flight persistence retries (so a hidden tab
+     * or stopped bus does not keep hammering the store) and stop the sweep. */
+    suspend(): void;
+    /** Drop all in-memory buffers (used on full teardown). */
+    resetBuffers(): void;
+    /** Buffer occupancy for diagnostics. `bytes` is an approximate in-memory
+     * payload footprint (same heuristic as adaptive load weighting), computed on
+     * demand so the hot append path never pays for it. */
+    getStats(): {
+        enabled: boolean;
+        topics: number;
+        messages: number;
+        bytes: number;
+    };
+    /** Deliver history from one topic's ring to a handler, isolating a throwing
+     * handler so the remaining buffers are still delivered. */
+    private deliver;
+    /** Coalesce queued persistence appends into a single microtask batch so a
+     * burst of publications does not issue one IndexedDB transaction each.
+     * Only reachable when the backend advertises `appendBatch` (the sole queuer,
+     * `record()`, guards on it), so the batched path is unconditional here. */
+    private schedulePersistenceFlush;
+    /** Load durable history into the in-memory rings once at startup, pruning
+     * entries past the retention window first. Failures are reported but do not
+     * block startup — the bus runs with whatever survived. */
+    private hydrate;
+    /** Coalesce retention cleanup: the newest cutoff wins while one pass runs,
+     * so a burst of publications issues at most one clearBefore transaction. */
+    private scheduleRetentionCleanup;
+    /** Run a persistence operation with exponential backoff on transient failure.
+     * Bumped `retryGeneration` (suspend/stop) cancels the loop early; a
+     * structurally failing operation throws after `persistenceRetryMaxAttempts`,
+     * leaving the ring buffer intact so the bus keeps working. */
+    private withPersistenceRetry;
+}
+//# sourceMappingURL=replay-manager.d.ts.map

package/dist/core/replay-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-manager.d.ts","sourceRoot":"","sources":["../../src/core/replay-manager.ts"],"names":[],"mappings":"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"}

package/dist/core/replay-persistence.d.ts

@@ -1,8 +1,11 @@
 import type { DataBusMessage } from './types';
+import { PRUNE_STRATEGY } from '../utils/constants';
 /** Optional persistence backend for replay history. */
 export interface DataBusReplayPersistence<TData = unknown> {
     load(): Promise<ReadonlyArray<DataBusMessage<TData>>>;
     append(message: DataBusMessage<TData>): Promise<void>;
+    /** Optional bulk append used to amortize IndexedDB transaction overhead. */
+    appendBatch?(messages: ReadonlyArray<DataBusMessage<TData>>): Promise<void>;
     /** Remove all persisted replay history. */
     clear?(): Promise<void>;
     /** Remove persisted replay history for one exact topic. */
@@ -13,7 +16,7 @@ export interface DataBusReplayPersistence<TData = unknown> {
 export interface IndexedDbReplayPersistenceOptions {
     dbName?: string;
     maxPerTopic: number;
-    pruneStrategy?: 'count' | 'age' | 'both';
+    pruneStrategy?: (typeof PRUNE_STRATEGY)[keyof typeof PRUNE_STRATEGY];
     retentionMs?: number;
 }
 /** Create a browser IndexedDB-backed replay store. */

package/dist/core/replay-persistence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"replay-persistence.d.ts","sourceRoot":"","sources":["../../src/core/replay-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,uDAAuD;AACvD,MAAM,WAAW,wBAAwB,CAAC,KAAK,GAAG,OAAO;IACvD,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,2CAA2C;IAC3C,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,2DAA2D;IAC3D,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,+EAA+E;IAC/E,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,iCAAiC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sDAAsD;AACtD,wBAAgB,gCAAgC,CAAC,KAAK,GAAG,OAAO,EAC9D,OAAO,EAAE,iCAAiC,GACzC,wBAAwB,CAAC,KAAK,CAAC,CAwJjC"}
+{"version":3,"file":"replay-persistence.d.ts","sourceRoot":"","sources":["../../src/core/replay-persistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAA0B,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG5E,uDAAuD;AACvD,MAAM,WAAW,wBAAwB,CAAC,KAAK,GAAG,OAAO;IACvD,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,4EAA4E;IAC5E,WAAW,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,2CAA2C;IAC3C,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,2DAA2D;IAC3D,UAAU,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,+EAA+E;IAC/E,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,iCAAiC;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sDAAsD;AACtD,wBAAgB,gCAAgC,CAAC,KAAK,GAAG,OAAO,EAC9D,OAAO,EAAE,iCAAiC,GACzC,wBAAwB,CAAC,KAAK,CAAC,CA4PjC"}

package/dist/core/routing.d.ts

@@ -5,19 +5,38 @@
  * owner, and decide when to migrate a topic. All side-effect-free, making
  * them straightforward to test and reason about.
  */
-import type { WorkerRecord, WorkerRoute } from './types';
+import type { LoadWeightingOptions, WorkerRecord, WorkerRoute } from './types';
 /** Default cap on the number of Workers that can own topics concurrently.
  * Limits fan-out breadth: only N workers are eligible to be new-route
  * owners, so a cluster of 20 tabs still concentrates ownership on a few. */
 export declare const DEFAULT_MAX_ACTIVE_WORKERS = 3;
 /**
- * Pick the Worker with the fewest owned topics, optionally preferring a
+ * Compute the effective load score used for owner selection.
+ *
+ * Legacy behavior: `worker.load` (owned-topic count) with no throughput
+ * contribution. When a Worker publishes a traffic sample AND weights are set,
+ * the normalized per-second rates are added on top, so a busy owner becomes
+ * less attractive for NEW routes without ever migrating an existing one.
+ * Returns the raw topic count when no sample or no weight is present.
+ */
+export declare function effectiveWorkerLoad(worker: WorkerRecord, options?: LoadWeightingOptions): number;
+/**
+ * Cheap, allocation-free estimate of a payload's wire size, used to populate
+ * the byte side of an adaptive load sample. Only runs when adaptive routing is
+ * enabled, so approximate sizes are fine — the goal is a stable cross-worker
+ * comparison, not an exact byte count. Sizes: null/undefined 0, booleans 4,
+ * numbers 8, strings their length, binary views their byteLength, arrays an
+ * 8-byte header plus elements, plain objects the sum of their values.
+ */
+export declare function approximatePayloadBytes(payload: unknown): number;
+/**
+ * Pick the Worker with the fewest effective load, optionally preferring a
  * specific sticky owner when it is still in the candidate set.
  * Uses a single reduce pass instead of a full sort — O(n) — and breaks
  * load ties by workerId for deterministic routing across tabs (the
  * comparison is code-unit based, not locale-based, for cross-host stability).
  */
-export declare function selectLeastLoadedWorker(workers: readonly WorkerRecord[], preferredWorkerId?: string): WorkerRecord | undefined;
+export declare function selectLeastLoadedWorker(workers: readonly WorkerRecord[], preferredWorkerId?: string, options?: LoadWeightingOptions): WorkerRecord | undefined;
 /**
  * Select the (up to `maxActiveWorkers`) Workers eligible to own topics.
  *

package/dist/core/routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/core/routing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEzD;;4EAE4E;AAC5E,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,iBAAiB,CAAC,EAAE,MAAM,GACzB,YAAY,GAAG,SAAS,CAY1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,gBAAgB,SAA6B,GAC5C,YAAY,EAAE,CAYhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,eAAe,EAAE,MAAM,GACtB,YAAY,GAAG,IAAI,CAYrB;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAEnG;AAED;;oDAEoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;sCAGsC;AACtC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAM3E"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/core/routing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG/E;;4EAE4E;AAC5E,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,CA2CR;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEhE;AA4CD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,iBAAiB,CAAC,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,YAAY,GAAG,SAAS,CAY1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,gBAAgB,SAA6B,GAC5C,YAAY,EAAE,CAchB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,eAAe,EAAE,MAAM,GACtB,YAAY,GAAG,IAAI,CAYrB;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAEnG;AAED;;oDAEoD;AACpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;sCAGsC;AACtC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAM3E"}

package/dist/core/storage-batch.d.ts

@@ -6,10 +6,6 @@
  * on quota/failure. Keeps the coordination metadata writes off the hot path.
  */
 import type { StorageLike } from './environment';
-/**
- * Coalesces synchronous storage writes and applies them in one pass, with
- * exponential backoff when the underlying storage rejects a write.
- */
 /**
  * Coalesces synchronous storage writes and applies them in one pass, with
  * exponential backoff when the underlying storage rejects a write.

package/dist/core/storage-batch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-batch.d.ts","sourceRoot":"","sources":["../../src/core/storage-batch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAYjD;;;GAGG;AACH;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,WAAW;IAS3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,YAAY,CAA0B;gBAEjB,OAAO,EAAE,WAAW;IAEjD;;gCAE4B;IAC5B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIjC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzC,KAAK,IAAI,IAAI;IA6Cb,yEAAyE;IACzE,OAAO,CAAC,IAAI;IAiBZ,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,WAAW;CAMpB"}
+{"version":3,"file":"storage-batch.d.ts","sourceRoot":"","sources":["../../src/core/storage-batch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAajD;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,WAAW;IAS3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IACxD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,YAAY,CAA0B;gBAEjB,OAAO,EAAE,WAAW;IAEjD;;gCAE4B;IAC5B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIjC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK7B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzC,KAAK,IAAI,IAAI;IA6Cb,yEAAyE;IACzE,OAAO,CAAC,IAAI;IAiBZ,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/core/trace.d.ts

@@ -7,35 +7,38 @@
  * message path — errors in the sink are isolated to console.warn.
  */
 import type { WorkerStatus } from './types';
+import type { PERSISTENCE_OPERATION, RECOVERY_OUTCOME, RELIABILITY_OPERATION, SUBSCRIPTION_ACTION, TRACE_ERROR_SOURCE, TRACE_LIFECYCLE_ACTION } from '../utils/constants';
+import { TRACE_EVENT_TYPE, TRACE_MODE } from '../utils/constants';
 /** Trace reporting mode: record only events, only metrics, or both. */
 /** Selects which trace categories the reporter emits.
  * - `events` — lifecycle/status/subscription/coordination/error events only.
  * - `metrics` — periodic `message_metrics` snapshots only.
  * - `all` — both event streams and metrics snapshots. */
-export type DataBusTraceMode = 'events' | 'metrics' | 'all';
+export type DataBusTraceMode = (typeof TRACE_MODE)[keyof typeof TRACE_MODE];
 /** Emitted when the DataBus starts, stops, suspends, or resumes. */
 export interface DataBusLifecycleTraceEvent {
-    type: 'lifecycle';
-    action: 'start' | 'stop' | 'suspend' | 'resume';
+    type: typeof TRACE_EVENT_TYPE.LIFECYCLE;
+    action: (typeof TRACE_LIFECYCLE_ACTION)[keyof typeof TRACE_LIFECYCLE_ACTION];
     timestamp: number;
 }
 /** Emitted when the transport connection status changes. */
 export interface DataBusStatusTraceEvent {
-    type: 'status';
+    type: typeof TRACE_EVENT_TYPE.STATUS;
     status: WorkerStatus;
     timestamp: number;
 }
 /** Emitted when a topic subscription is added or removed. */
 export interface DataBusSubscriptionTraceEvent {
-    type: 'subscription';
-    action: 'subscribe' | 'unsubscribe';
+    type: typeof TRACE_EVENT_TYPE.SUBSCRIPTION;
+    action: (typeof SUBSCRIPTION_ACTION)[keyof typeof SUBSCRIPTION_ACTION];
     topic: string;
     activeTopics: number;
     timestamp: number;
 }
-/** Emitted on each reconciliation round to record whether the cluster coordinated. */
+/** Emitted after each transport open (initial start and recovery) to record
+ * the coordinated cluster state, including the settled route list. */
 export interface DataBusCoordinationTraceEvent {
-    type: 'coordination';
+    type: typeof TRACE_EVENT_TYPE.COORDINATION;
     coordinated: boolean;
     activeWorkers: number;
     workers: string[];
@@ -44,19 +47,19 @@ export interface DataBusCoordinationTraceEvent {
 }
 /** Emitted when a transport or operation error occurs. */
 export interface DataBusErrorTraceEvent {
-    type: 'error';
-    source: 'transport' | 'operation';
+    type: typeof TRACE_EVENT_TYPE.ERROR;
+    source: (typeof TRACE_ERROR_SOURCE)[keyof typeof TRACE_ERROR_SOURCE];
     timestamp: number;
 }
 /** Bounded reliability diagnostics for recovery, acknowledgments, and migrations. */
 export interface DataBusReliabilityTraceEvent {
-    type: 'reliability';
-    operation: 'transport_recovery' | 'route_ack' | 'route_migration' | 'persistence_cleanup' | 'persistence_retry' | 'dedup_suppressed';
+    type: typeof TRACE_EVENT_TYPE.RELIABILITY;
+    operation: (typeof RELIABILITY_OPERATION)[keyof typeof RELIABILITY_OPERATION];
     topic?: string;
-    persistenceOperation?: 'load' | 'append' | 'clear' | 'clearTopic' | 'clearBefore';
+    persistenceOperation?: (typeof PERSISTENCE_OPERATION)[keyof typeof PERSISTENCE_OPERATION];
     attempt?: number;
     /** Outcome for a transport recovery attempt. */
-    outcome?: 'scheduled' | 'succeeded' | 'failed' | 'exhausted';
+    outcome?: (typeof RECOVERY_OUTCOME)[keyof typeof RECOVERY_OUTCOME];
     durationMs?: number;
     timestamp: number;
 }
@@ -66,7 +69,7 @@ export interface DataBusReliabilityTraceEvent {
  * `metricsIntervalMs`.
  */
 export interface DataBusMetricsTraceEvent {
-    type: 'message_metrics';
+    type: typeof TRACE_EVENT_TYPE.MESSAGE_METRICS;
     durationMs: number;
     received: number;
     dispatched: number;
@@ -80,6 +83,31 @@ export interface DataBusMetricsTraceEvent {
     dedupSuppressed: number;
     timestamp: number;
 }
+/**
+ * Synchronous metrics snapshot: same derived counters as a periodic
+ * `message_metrics` event, but queryable on demand (e.g. from
+ * `getDiagnostics()`) without a sink or an interval flush, and without
+ * resetting the aggregation window.
+ */
+export interface DataBusMetricsSnapshot {
+    /** Milliseconds elapsed in the current aggregation window. */
+    durationMs: number;
+    /** Messages received in the window. */
+    received: number;
+    /** Messages dispatched locally in the window. */
+    dispatched: number;
+    /** Distinct topics touched in the window. */
+    topics: number;
+    /** Latency samples collected in the window. */
+    dispatchSamples: number;
+    dispatchAvgMs: number;
+    dispatchP50Ms: number;
+    dispatchP95Ms: number;
+    dispatchMaxMs: number;
+    dedupAccepted: number;
+    dedupSuppressed: number;
+    timestamp: number;
+}
 export type DataBusTraceEvent = DataBusLifecycleTraceEvent | DataBusStatusTraceEvent | DataBusSubscriptionTraceEvent | DataBusCoordinationTraceEvent | DataBusErrorTraceEvent | DataBusReliabilityTraceEvent | DataBusMetricsTraceEvent;
 /** Distributive-conditional type: given a trace event union, derive the same shape minus `timestamp`. */
 type DataBusTraceEventInput = DataBusTraceEvent extends infer TEvent ? TEvent extends DataBusTraceEvent ? Omit<TEvent, 'timestamp'> : never : never;
@@ -134,8 +162,20 @@ export declare class DataBusTraceReporter {
     /** Pause the metrics interval and reset accumulated counters. */
     pause(): void;
     stop(): void;
+    /** Synchronous sink state for diagnostics: whether delivery is async and how
+     * many events are queued behind the microtask flush. A growing queue under
+     * `asyncSink: true` is the first sign of sink back-pressure. */
+    getSinkState(): {
+        asyncSink: boolean;
+        pendingEvents: number;
+    };
     /** Record an instantaneous trace event (lifecycle, status, error, etc.). */
     event(event: DataBusTraceEventInput): void;
+    /** Synchronous snapshot of the current metrics window without resetting it.
+     * Returns the same derived counters as a periodic `message_metrics` event,
+     * or null when metrics recording is inactive (disabled or events-only mode).
+     * The window keeps accumulating until the next interval flush. */
+    getMetrics(): DataBusMetricsSnapshot | null;
     /** Record that a message was received on `topic`; stores its timestamp for latency tracking. */
     recordReceived(topic: string): void;
     /**

package/dist/core/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/core/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,uEAAuE;AACvE;;;yDAGyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAE5D,oEAAoE;AACpE,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4DAA4D;AAC5D,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6DAA6D;AAC7D,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sFAAsF;AACtF,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,oBAAoB,GAAG,WAAW,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;IACrI,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,aAAa,CAAC;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GACzB,0BAA0B,GAC1B,uBAAuB,GACvB,6BAA6B,GAC7B,6BAA6B,GAC7B,sBAAsB,GACtB,4BAA4B,GAC5B,wBAAwB,CAAC;AAE7B,yGAAyG;AACzG,KAAK,sBAAsB,GAAG,iBAAiB,SAAS,MAAM,MAAM,GAChE,MAAM,SAAS,iBAAiB,GAC9B,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,GACzB,KAAK,GACP,KAAK,CAAC;AAEV;wEACwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,qDAAqD;IACrD,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACzC,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAWD;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+B;IAE1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmD;IAClF,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,eAAe,CAAK;gBAEhB,OAAO,CAAC,EAAE,mBAAmB,EAAE,GAAG,GAAE,MAAM,MAAiC;IASvF;uEACmE;IACnE,KAAK,IAAI,IAAI;IAOb,iEAAiE;IACjE,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAKZ,4EAA4E;IAC5E,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAK1C,gGAAgG;IAChG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkBnC;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQpC;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAgBrC,iEAAiE;IACjE,mBAAmB,IAAI,IAAI;IAI3B,qBAAqB,IAAI,IAAI;IAI7B;;iFAE6E;IAC7E,OAAO,KAAK,aAAa,GAExB;IAED,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,QAAQ;IA4BhB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,IAAI;IAiBZ,OAAO,CAAC,QAAQ;CAWjB"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/core/trace.ts"],"names":[],"mappings":"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"}