cross-tab-worker-databus 0.20.86 → 0.20.87

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/core/replay-persistence.ts", "../src/websocket.ts"],
-  "sourcesContent": ["import type { DataBusMessage } from './types';\nimport { pruneReplayHistory } from './replay-pruning';\nimport { DEFAULT_STORAGE_PREFIX, PRUNE_STRATEGY } from '../utils/constants';\nimport { assertPositiveFiniteNumber, assertPositiveSafeInteger, assertPruneStrategy } from '../utils/validation';\n\n/** Optional persistence backend for replay history. */\nexport interface DataBusReplayPersistence<TData = unknown> {\n  load(): Promise<ReadonlyArray<DataBusMessage<TData>>>;\n  append(message: DataBusMessage<TData>): Promise<void>;\n  /** Optional bulk append used to amortize IndexedDB transaction overhead. */\n  appendBatch?(messages: ReadonlyArray<DataBusMessage<TData>>): Promise<void>;\n  /** Remove all persisted replay history. */\n  clear?(): Promise<void>;\n  /** Remove persisted replay history for one exact topic. */\n  clearTopic?(topic: string): Promise<void>;\n  /** Remove persisted messages older than the given epoch-millisecond cutoff. */\n  clearBefore?(timestamp: number): Promise<void>;\n}\n\nexport interface IndexedDbReplayPersistenceOptions {\n  dbName?: string;\n  maxPerTopic: number;\n  pruneStrategy?: (typeof PRUNE_STRATEGY)[keyof typeof PRUNE_STRATEGY];\n  retentionMs?: number;\n}\n\n/** Create a browser IndexedDB-backed replay store. */\nexport function createIndexedDbReplayPersistence<TData = unknown>(\n  options: IndexedDbReplayPersistenceOptions\n): DataBusReplayPersistence<TData> {\n  const indexedDb = globalThis.indexedDB;\n  if (!indexedDb) throw new Error('IndexedDB is unavailable in this environment.');\n  const dbName = options.dbName ?? DEFAULT_STORAGE_PREFIX;\n  const storeName = 'replay';\n  const maxPerTopic = options.maxPerTopic;\n  const pruneStrategy = options.pruneStrategy ?? PRUNE_STRATEGY.COUNT;\n  const retentionMs = options.retentionMs;\n  assertPruneStrategy(pruneStrategy);\n  if (retentionMs !== undefined) assertPositiveFiniteNumber(retentionMs, 'retentionMs');\n  assertPositiveSafeInteger(maxPerTopic, 'maxPerTopic');\n  let dbPromise: Promise<IDBDatabase> | null = null;\n  const invalidate = (db: IDBDatabase): void => {\n    if (dbPromise) {\n      void dbPromise.then(current => {\n        if (current === db) {\n          current.close();\n          dbPromise = null;\n        }\n      }, () => undefined);\n    }\n  };\n  // IndexedDB transactions are atomic, but a read-modify-write append can\n  // still lose updates when callers start several appends concurrently.\n  // Serialize all mutations per adapter instance while keeping reads free.\n  // Consecutive append/appendBatch entries are coalesced into a single\n  // transaction at the head of the queue, so a burst spanning many microtask\n  // flushes issues one transaction instead of one per flush. Ordering against\n  // clears is preserved: coalescing only merges adjacent batch entries and\n  // never reorders them relative to a clear.\n  type QueuedMutation =\n    | { kind: 'batch'; messages: ReadonlyArray<DataBusMessage<TData>> }\n    | { kind: 'run'; run: () => Promise<void> };\n  const pending: Array<{\n    mutation: QueuedMutation;\n    resolve: () => void;\n    reject: (error: unknown) => void;\n  }> = [];\n  let draining = false;\n\n  const drain = async (): Promise<void> => {\n    if (draining) return;\n    draining = true;\n    try {\n      // Let a burst of synchronous enqueues accumulate into `pending` before\n      // the first coalescing pass, so a single flush cycle's batches merge\n      // into one transaction instead of two.\n      await Promise.resolve();\n      while (pending.length > 0) {\n        const head = pending[0]!.mutation;\n        if (head.kind === 'batch') {\n          // Merge every adjacent batch entry into one transaction.\n          const merged: DataBusMessage<TData>[] = [];\n          const entries: Array<{ resolve: () => void; reject: (error: unknown) => void }> = [];\n          while (pending.length > 0) {\n            const next = pending[0]!.mutation;\n            if (next.kind !== 'batch') break;\n            merged.push(...next.messages);\n            entries.push({ resolve: pending[0]!.resolve, reject: pending[0]!.reject });\n            pending.shift();\n          }\n          try {\n            await appendTransaction(merged);\n            for (const entry of entries) entry.resolve();\n          } catch (error) {\n            for (const entry of entries) entry.reject(error);\n          }\n        } else {\n          const entry = pending.shift()!;\n          try {\n            await head.run();\n            entry.resolve();\n          } catch (error) {\n            entry.reject(error);\n          }\n        }\n      }\n    } finally {\n      draining = false;\n    }\n  };\n\n  const enqueue = (mutation: QueuedMutation): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      pending.push({ mutation, resolve, reject });\n      void drain();\n    });\n\n  /** Read-modify-write one topic-batched append inside a single transaction. */\n  const appendTransaction = (messages: ReadonlyArray<DataBusMessage<TData>>): Promise<void> =>\n    (async () => {\n      const db = await open();\n      return new Promise<void>((resolve, reject) => {\n        let transaction: IDBTransaction;\n        try {\n          transaction = db.transaction(storeName, 'readwrite');\n        } catch (error) {\n          invalidate(db);\n          reject(error);\n          return;\n        }\n        const store = transaction.objectStore(storeName);\n        const grouped = new Map<string, DataBusMessage<TData>[]>();\n        for (const message of messages) {\n          grouped.set(message.topic, [...(grouped.get(message.topic) ?? []), message]);\n        }\n        let hasError = false;\n        const fail = (error: unknown): void => {\n          if (hasError) return;\n          hasError = true;\n          invalidate(db);\n          reject(error);\n        };\n        for (const [topic, topicMessages] of grouped) {\n          const request = store.get(topic);\n          request.onsuccess = () => {\n            if (hasError) return;\n            const history = pruneReplayHistory(\n              ((request.result?.messages ?? []) as DataBusMessage<TData>[]).concat(topicMessages),\n              { maxPerTopic, pruneStrategy, retentionMs, now: Date.now() }\n            );\n            store.put({ topic, messages: history });\n          };\n          request.onerror = () => fail(request.error ?? new Error('Failed to read replay history.'));\n        }\n        transaction.oncomplete = () => {\n          if (!hasError) resolve();\n        };\n        transaction.onerror = () => fail(transaction.error ?? new Error('Failed to persist replay history.'));\n        // A connection loss can abort a transaction without first dispatching a\n        // request error. Without this path, the serialized mutation queue would\n        // stay blocked forever after the promise never settles.\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to persist replay history.'));\n      });\n    })();\n  const open = (): Promise<IDBDatabase> => {\n    if (dbPromise) return dbPromise;\n    const pending = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDb.open(dbName, 1);\n      request.onupgradeneeded = () => request.result.createObjectStore(storeName, { keyPath: 'topic' });\n      request.onsuccess = () => {\n        const db = request.result;\n        // A schema upgrade in another tab invalidates this connection. Close\n        // it and clear the cached promise so the next operation reopens a\n        // usable connection instead of repeatedly targeting a dead database.\n        db.onversionchange = () => {\n          db.close();\n          if (dbPromise) dbPromise = null;\n        };\n        resolve(db);\n      };\n      request.onerror = () => reject(request.error ?? new Error('Failed to open replay database.'));\n    });\n    dbPromise = pending;\n    // Do not permanently cache a rejected open promise. IndexedDB can fail\n    // transiently (quota, private-mode initialization, a closing connection,\n    // or a browser shutdown); the next operation must be able to retry.\n    void pending.catch(() => {\n      if (dbPromise === pending) dbPromise = null;\n    });\n    return pending;\n  };\n  return {\n    async load() {\n      const db = await open();\n      return new Promise((resolve, reject) => {\n        let transaction: IDBTransaction;\n        let request: IDBRequest;\n        try {\n          transaction = db.transaction(storeName, 'readonly');\n          request = transaction.objectStore(storeName).getAll();\n        } catch (error) {\n          invalidate(db);\n          reject(error);\n          return;\n        }\n        let settled = false;\n        const fail = (error: unknown): void => {\n          if (settled) return;\n          settled = true;\n          invalidate(db);\n          reject(error);\n        };\n        let records: Array<{ messages: DataBusMessage<TData>[] }> = [];\n        request.onsuccess = () => {\n          records = request.result as Array<{ messages: DataBusMessage<TData>[] }>;\n        };\n        request.onerror = () => fail(request.error ?? new Error('Failed to load replay history.'));\n        transaction.oncomplete = () => {\n          if (settled) return;\n          settled = true;\n          resolve(records.flatMap(record => record.messages));\n        };\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to load replay history.'));\n      });\n    },\n    append(message) {\n      return enqueue({ kind: 'batch', messages: [message] });\n    },\n    appendBatch(messages) {\n      if (messages.length === 0) return Promise.resolve();\n      return enqueue({ kind: 'batch', messages });\n    },\n    clear() {\n      return enqueue({\n        kind: 'run',\n        run: () => (async () => {\n        const db = await open();\n        return new Promise<void>((resolve, reject) => {\n        let transaction: IDBTransaction;\n        try { transaction = db.transaction(storeName, 'readwrite'); }\n        catch (error) { invalidate(db); reject(error); return; }\n        let settled = false;\n        const fail = (error: unknown): void => {\n          if (settled) return;\n          settled = true;\n          invalidate(db);\n          reject(error);\n        };\n        transaction.objectStore(storeName).clear();\n        transaction.oncomplete = () => { settled = true; resolve(); };\n        transaction.onerror = () => fail(transaction.error ?? new Error('Failed to clear replay history.'));\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to clear replay history.'));\n        });\n        })()\n      });\n    },\n    clearTopic(topic) {\n      return enqueue({\n        kind: 'run',\n        run: () => (async () => {\n        const db = await open();\n        return new Promise<void>((resolve, reject) => {\n        let transaction: IDBTransaction;\n        try { transaction = db.transaction(storeName, 'readwrite'); }\n        catch (error) { invalidate(db); reject(error); return; }\n        let settled = false;\n        const fail = (error: unknown): void => {\n          if (settled) return;\n          settled = true;\n          invalidate(db);\n          reject(error);\n        };\n        transaction.objectStore(storeName).delete(topic);\n        transaction.oncomplete = () => { settled = true; resolve(); };\n        transaction.onerror = () => fail(transaction.error ?? new Error('Failed to clear topic replay history.'));\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to clear topic replay history.'));\n        });\n        })()\n      });\n    },\n    clearBefore(timestamp) {\n      return enqueue({\n        kind: 'run',\n        run: () => (async () => {\n        const db = await open();\n        return new Promise<void>((resolve, reject) => {\n        let transaction: IDBTransaction;\n        try { transaction = db.transaction(storeName, 'readwrite'); }\n        catch (error) { invalidate(db); reject(error); return; }\n        let settled = false;\n        const fail = (error: unknown): void => {\n          if (settled) return;\n          settled = true;\n          invalidate(db);\n          reject(error);\n        };\n        const store = transaction.objectStore(storeName);\n        const request = store.getAll();\n        request.onsuccess = () => {\n          for (const record of request.result as Array<{ topic: string; messages: DataBusMessage<TData>[] }>) {\n            const messages = record.messages.filter(message => message.timestamp === undefined || message.timestamp >= timestamp);\n            if (messages.length === 0) store.delete(record.topic);\n            else if (messages.length !== record.messages.length) store.put({ topic: record.topic, messages });\n          }\n        };\n        request.onerror = () => fail(request.error ?? new Error('Failed to read replay history.'));\n        transaction.oncomplete = () => { settled = true; resolve(); };\n        transaction.onerror = () => fail(transaction.error ?? new Error('Failed to prune replay history.'));\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to prune replay history.'));\n        });\n        })()\n      });\n    }\n  };\n}\n", "/**\n * WebSocketTransport \u2014 a dependency-free transport over a plain WebSocket.\n *\n * Validates the `DataBusTransport` abstraction with a second, minimal backend:\n * any WebSocket server that speaks the tiny JSON protocol below can back the\n * same cross-tab clustering stack (owner dedup, sticky routes, EVENT fan-out)\n * that the Centrifuge backend uses.\n *\n * Wire protocol (JSON text frames):\n * - client \u2192 server: `{\"op\":\"subscribe\"|\"unsubscribe\"|\"publish\",\"topic\":...,\"data\":...}`\n * - client \u2192 server (batched): `{\"op\":\"publishBatch\",\"topic\":...,\"items\":[{data,...}]}`\n * - server \u2192 client: `{\"topic\":...,\"data\":...}` for publications; anything\n *   without a string `topic` field is ignored (forward-compatible).\n */\nimport { CrossTabDataBus } from './core/data-bus';\nimport { parseDataBusPublication } from './core/publication';\nimport type { CrossTabDataBusOptions } from './core/data-bus';\nimport { WS_OP, WORKER_STATUS } from './utils/constants';\nimport type {\n  DataBusTransport,\n  DataBusTransportHandlers,\n  DataBusPublishOptions,\n  DataBusPublicationItem,\n  DataBusMessage,\n  MaybePromise,\n  WorkerStatus\n} from './core/types';\n\n/** Minimal WebSocket surface used by the transport. Matches the browser\n * `WebSocket` subset the transport touches; injectable for tests and runtimes. */\nexport interface WebSocketLike {\n  /** Current connection state; 1 (OPEN) means frames may be sent. */\n  readonly readyState?: number;\n  send(data: string | ArrayBuffer): void;\n  close(code?: number, reason?: string): void;\n  onopen: (() => void) | null;\n  onclose: (() => void) | null;\n  onerror: (() => void) | null;\n  onmessage: ((event: { data: unknown }) => void) | null;\n}\n\n/** Connection configuration for {@link WebSocketTransport}. */\nexport interface WebSocketDataBusConfig {\n  /** WebSocket endpoint, e.g. `wss://example.test/ws`. */\n  url: string;\n  /** Subprotocol(s) passed to the WebSocket handshake. */\n  protocols?: string | string[];\n  /** Custom socket factory. Defaults to the global `WebSocket`; injectable\n   * for tests and non-browser runtimes. */\n  webSocketFactory?: (url: string, protocols?: string | string[]) => WebSocketLike;\n}\n\n/** Options for creating a fully-configured CrossTabDataBus with a WebSocket transport. */\nexport interface CreateWebSocketDataBusOptions<TData = unknown>\n  extends Omit<\n    CrossTabDataBusOptions<WebSocketDataBusConfig, TData>,\n    'autoStart' | 'clusterKey' | 'initialConfig' | 'transport'\n  > {\n  /** WebSocket connection configuration. */\n  connection: WebSocketDataBusConfig;\n  /** Cluster key for cross-tab coordination. Defaults to the connection URL. */\n  clusterKey?: string;\n}\n\nconst WS_OPEN = 1;\n\n/** Transport that talks a minimal JSON protocol over a plain WebSocket.\n * Connection lifecycle maps directly to the DataBus status vocabulary:\n * open \u2192 `connected`, close \u2192 `disconnected`, error \u2192 `error` (which the\n * DataBus treats as its auto-recovery trigger). The transport holds no\n * reconnection logic of its own \u2014 reopening is the DataBus's job. */\nexport class WebSocketTransport<TData = unknown>\n  implements DataBusTransport<WebSocketDataBusConfig, TData>\n{\n  readonly diagnosticsName = 'websocket';\n  readonly diagnosticsBackend = 'native-websocket';\n  private socket: WebSocketLike | null = null;\n  private handlers: DataBusTransportHandlers<TData> | null = null;\n  private readonly subscribedTopics = new Set<string>();\n\n  constructor(private readonly connection: WebSocketDataBusConfig) {}\n\n  /** Open the WebSocket and wire lifecycle listeners. A factory failure is\n   * reported through `onStatus('error')` so the DataBus can recover. */\n  start(config: WebSocketDataBusConfig, handlers: DataBusTransportHandlers<TData>): MaybePromise<void> {\n    if (this.socket) return;\n    this.handlers = handlers;\n    // The factory may live on the constructor connection (createWebSocketDataBus\n    // path) or on the runtime config (direct transport use) \u2014 accept both.\n    const factory = config.webSocketFactory ?? this.connection.webSocketFactory ?? defaultWebSocketFactory;\n    const protocols = config.protocols ?? this.connection.protocols;\n    let socket: WebSocketLike;\n    try {\n      socket = factory(config.url, protocols);\n    } catch (error) {\n      handlers.onStatus(WORKER_STATUS.ERROR);\n      handlers.onError(error);\n      return;\n    }\n    socket.onopen = () => {\n      if (this.socket !== socket || this.handlers !== handlers) return;\n      // Re-assert every topic so a reopened socket (recovery path) restores\n      // the server-side subscriptions without DataBus involvement.\n      for (const topic of this.subscribedTopics) {\n        this.sendFrame({ op: WS_OP.SUBSCRIBE, topic });\n      }\n      handlers.onStatus(WORKER_STATUS.CONNECTED);\n    };\n    socket.onclose = () => {\n      if (this.socket === socket && this.handlers === handlers) handlers.onStatus(WORKER_STATUS.DISCONNECTED);\n    };\n    socket.onerror = () => {\n      if (this.socket === socket && this.handlers === handlers) handlers.onStatus(WORKER_STATUS.ERROR);\n    };\n    socket.onmessage = event => {\n      if (this.socket === socket && this.handlers === handlers) void this.handleMessage(event.data);\n    };\n    this.socket = socket;\n  }\n\n  /** Idempotent: re-subscribing an active topic re-sends the frame but does\n   * not duplicate the local tracking entry. */\n  subscribe(topic: string): MaybePromise<void> {\n    this.subscribedTopics.add(topic);\n    this.sendFrame({ op: WS_OP.SUBSCRIBE, topic });\n  }\n\n  /** Idempotent: unsubscribing an unknown topic is a no-op. */\n  unsubscribe(topic: string): MaybePromise<void> {\n    this.subscribedTopics.delete(topic);\n    this.sendFrame({ op: WS_OP.UNSUBSCRIBE, topic });\n  }\n\n  /** Publish `data` to `topic` as a JSON frame. Requires an open socket. */\n  publish(topic: string, data: unknown, options?: DataBusPublishOptions): MaybePromise<void> {\n    if (data instanceof ArrayBuffer) {\n      this.sendBinaryFrame(topic, data, options?.messageId, options?.timestamp);\n      return;\n    }\n    this.sendFrame({\n      op: WS_OP.PUBLISH,\n      topic,\n      data,\n      ...(options?.messageId === undefined ? {} : { messageId: options.messageId }),\n      ...(options?.timestamp === undefined ? {} : { timestamp: options.timestamp })\n    });\n  }\n\n  /** Publish many items for one topic as a single wire frame. One-item\n   * batches delegate to `publish` so the legacy single-publication frame\n   * shape (including binary framing) is preserved. */\n  publishBatch(topic: string, items: ReadonlyArray<DataBusPublicationItem>): MaybePromise<void> {\n    if (items.length === 0) return;\n    if (items.length === 1) {\n      const single = items[0]!;\n      return this.publish(topic, single.data, {\n        ...(single.messageId === undefined ? {} : { messageId: single.messageId }),\n        ...(single.timestamp === undefined ? {} : { timestamp: single.timestamp })\n      });\n    }\n    if (this.socket?.readyState !== WS_OPEN) {\n      this.handlers?.onError(new Error('WebSocket is not open; dropped \"publishBatch\" frame.'));\n      return;\n    }\n    // Binary payloads are embedded as byte arrays so the whole batch stays in\n    // one JSON frame; the server re-fans them out as individual publications.\n    this.socket.send(JSON.stringify({\n      op: WS_OP.PUBLISH_BATCH,\n      topic,\n      items: items.map(item => ({\n        data: item.data instanceof ArrayBuffer ? Array.from(new Uint8Array(item.data)) : item.data,\n        ...(item.messageId === undefined ? {} : { messageId: item.messageId }),\n        ...(item.timestamp === undefined ? {} : { timestamp: item.timestamp })\n      }))\n    }));\n  }\n\n  /** Close the socket and drop all state. Safe to call multiple times. */\n  stop(): MaybePromise<void> {\n    const socket = this.socket;\n    this.socket = null;\n    this.handlers = null;\n    this.subscribedTopics.clear();\n    socket?.close();\n  }\n\n  /** Send one JSON frame. Frames are dropped with an `onError` report when\n   * the socket is not open \u2014 subscribe frames are re-sent on open, so the\n   * only real loss is a publish during a disconnect window. */\n  private sendFrame(payload: { op: string; topic: string; data?: unknown; messageId?: string; timestamp?: number }): void {\n    if (this.socket?.readyState !== WS_OPEN) {\n      this.handlers?.onError(new Error(`WebSocket is not open; dropped \"${payload.op}\" frame.`));\n      return;\n    }\n    this.socket.send(JSON.stringify(payload));\n  }\n\n  private sendBinaryFrame(topic: string, data: ArrayBuffer, messageId?: string, timestamp?: number): void {\n    if (messageId !== undefined || timestamp !== undefined) {\n      // Binary frames retain their compact legacy shape; metadata is sent as a\n      // JSON envelope so IDs are never silently lost.\n      this.sendFrame({\n        op: WS_OP.PUBLISH,\n        topic,\n        data: Array.from(new Uint8Array(data)),\n        ...(messageId === undefined ? {} : { messageId }),\n        ...(timestamp === undefined ? {} : { timestamp })\n      });\n      return;\n    }\n    if (this.socket?.readyState !== WS_OPEN) {\n      this.handlers?.onError(new Error('WebSocket is not open; dropped \"publish\" frame.'));\n      return;\n    }\n    const topicBytes = new TextEncoder().encode(topic);\n    if (topicBytes.length > 0xffff) {\n      this.handlers?.onError(new Error('WebSocket topic is too long for a binary frame.'));\n      return;\n    }\n    const frame = new Uint8Array(3 + topicBytes.length + data.byteLength);\n    frame[0] = 0xc7;\n    new DataView(frame.buffer).setUint16(1, topicBytes.length);\n    frame.set(topicBytes, 3);\n    frame.set(new Uint8Array(data), 3 + topicBytes.length);\n    this.socket.send(frame.buffer);\n  }\n\n  /** Parse a server frame. Only objects carrying a string `topic` are\n   * publications; malformed JSON and unknown shapes are ignored so a chatty\n   * server cannot crash the message path. */\n  private async handleMessage(raw: unknown): Promise<void> {\n    // Browser WebSockets may deliver binary frames as Blob unless\n    // `binaryType = 'arraybuffer'` is explicitly configured by the host.\n    // Normalize Blob asynchronously and reuse the exact ArrayBuffer parser.\n    if (typeof Blob !== 'undefined' && raw instanceof Blob) {\n      try {\n        await this.handleMessage(await raw.arrayBuffer());\n      } catch (error) {\n        this.handlers?.onError(error);\n      }\n      return;\n    }\n    let parsed: unknown;\n    if (raw instanceof ArrayBuffer) {\n      const bytes = new Uint8Array(raw);\n      if (bytes[0] !== 0xc7 || bytes.length < 3) return;\n      const topicLength = new DataView(raw).getUint16(1);\n      if (bytes.length < 3 + topicLength) return;\n      const topic = new TextDecoder().decode(bytes.subarray(3, 3 + topicLength));\n      const data = bytes.slice(3 + topicLength).buffer;\n      this.handlers?.onMessage({ topic, data: data as TData });\n      return;\n    }\n    if (typeof raw !== 'string') return;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      this.handlers?.onError(new Error('WebSocket server sent a non-JSON frame.'));\n      return;\n    }\n    if (!parsed || typeof parsed !== 'object') return;\n    const publication = parseDataBusPublication<TData>(parsed);\n    if (publication) this.handlers?.onMessage(publication as DataBusMessage<TData>);\n  }\n}\n\n/** Resolve the platform WebSocket, or null in runtimes without one (SSR/Node). */\nfunction defaultWebSocketFactory(url: string, protocols?: string | string[]): WebSocketLike {\n  if (typeof WebSocket === 'undefined') {\n    throw new Error('WebSocketTransport requires a WebSocket implementation.');\n  }\n  return new WebSocket(url, protocols) as unknown as WebSocketLike;\n}\n\n/** Create a CrossTabDataBus backed by a plain WebSocket transport.\n * Cross-tab clustering (owner dedup, sticky routes, failover) works identically\n * to the Centrifuge backend \u2014 only the transport I/O differs. */\nexport function createWebSocketDataBus<TData = unknown>(\n  options: CreateWebSocketDataBusOptions<TData>\n): CrossTabDataBus<WebSocketDataBusConfig, TData> {\n  const { clusterKey, connection, ...dataBusOptions } = options;\n  return new CrossTabDataBus({\n    ...dataBusOptions,\n    autoStart: true,\n    clusterKey: clusterKey ?? connection.url,\n    initialConfig: connection,\n    transport: new WebSocketTransport<TData>(connection)\n  });\n}\n\n/** Re-export for convenience: the status type used by the transport. */\nexport type { WorkerStatus };\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { DataBusMessage } from './types';\nimport { pruneReplayHistory } from './replay-pruning';\nimport { DEFAULT_STORAGE_PREFIX, PRUNE_STRATEGY } from '../utils/constants';\nimport { assertPositiveFiniteNumber, assertPositiveSafeInteger, assertPruneStrategy } from '../utils/validation';\n\n/** Optional persistence backend for replay history. */\nexport interface DataBusReplayPersistence<TData = unknown> {\n  load(): Promise<ReadonlyArray<DataBusMessage<TData>>>;\n  append(message: DataBusMessage<TData>): Promise<void>;\n  /** Optional bulk append used to amortize IndexedDB transaction overhead. */\n  appendBatch?(messages: ReadonlyArray<DataBusMessage<TData>>): Promise<void>;\n  /** Remove all persisted replay history. */\n  clear?(): Promise<void>;\n  /** Remove persisted replay history for one exact topic. */\n  clearTopic?(topic: string): Promise<void>;\n  /** Remove persisted messages older than the given epoch-millisecond cutoff. */\n  clearBefore?(timestamp: number): Promise<void>;\n}\n\nexport interface IndexedDbReplayPersistenceOptions {\n  dbName?: string;\n  maxPerTopic: number;\n  pruneStrategy?: (typeof PRUNE_STRATEGY)[keyof typeof PRUNE_STRATEGY];\n  retentionMs?: number;\n}\n\n/** Create a browser IndexedDB-backed replay store. */\nexport function createIndexedDbReplayPersistence<TData = unknown>(\n  options: IndexedDbReplayPersistenceOptions\n): DataBusReplayPersistence<TData> {\n  const indexedDb = globalThis.indexedDB;\n  if (!indexedDb) throw new Error('IndexedDB is unavailable in this environment.');\n  const dbName = options.dbName ?? DEFAULT_STORAGE_PREFIX;\n  const storeName = 'replay';\n  const maxPerTopic = options.maxPerTopic;\n  const pruneStrategy = options.pruneStrategy ?? PRUNE_STRATEGY.COUNT;\n  const retentionMs = options.retentionMs;\n  assertPruneStrategy(pruneStrategy);\n  if (retentionMs !== undefined) assertPositiveFiniteNumber(retentionMs, 'retentionMs');\n  assertPositiveSafeInteger(maxPerTopic, 'maxPerTopic');\n  let dbPromise: Promise<IDBDatabase> | null = null;\n  const invalidate = (db: IDBDatabase): void => {\n    if (dbPromise) {\n      void dbPromise.then(current => {\n        if (current === db) {\n          current.close();\n          dbPromise = null;\n        }\n      }, () => undefined);\n    }\n  };\n  // IndexedDB transactions are atomic, but a read-modify-write append can\n  // still lose updates when callers start several appends concurrently.\n  // Serialize all mutations per adapter instance while keeping reads free.\n  // Consecutive append/appendBatch entries are coalesced into a single\n  // transaction at the head of the queue, so a burst spanning many microtask\n  // flushes issues one transaction instead of one per flush. Ordering against\n  // clears is preserved: coalescing only merges adjacent batch entries and\n  // never reorders them relative to a clear.\n  type QueuedMutation =\n    | { kind: 'batch'; messages: ReadonlyArray<DataBusMessage<TData>> }\n    | { kind: 'run'; run: () => Promise<void> };\n  const pending: Array<{\n    mutation: QueuedMutation;\n    resolve: () => void;\n    reject: (error: unknown) => void;\n  }> = [];\n  let draining = false;\n\n  const drain = async (): Promise<void> => {\n    if (draining) return;\n    draining = true;\n    try {\n      // Let a burst of synchronous enqueues accumulate into `pending` before\n      // the first coalescing pass, so a single flush cycle's batches merge\n      // into one transaction instead of two.\n      await Promise.resolve();\n      while (pending.length > 0) {\n        const head = pending[0]!.mutation;\n        if (head.kind === 'batch') {\n          // Merge every adjacent batch entry into one transaction.\n          const merged: DataBusMessage<TData>[] = [];\n          const entries: Array<{ resolve: () => void; reject: (error: unknown) => void }> = [];\n          while (pending.length > 0) {\n            const next = pending[0]!.mutation;\n            if (next.kind !== 'batch') break;\n            merged.push(...next.messages);\n            entries.push({ resolve: pending[0]!.resolve, reject: pending[0]!.reject });\n            pending.shift();\n          }\n          try {\n            await appendTransaction(merged);\n            for (const entry of entries) entry.resolve();\n          } catch (error) {\n            for (const entry of entries) entry.reject(error);\n          }\n        } else {\n          const entry = pending.shift()!;\n          try {\n            await head.run();\n            entry.resolve();\n          } catch (error) {\n            entry.reject(error);\n          }\n        }\n      }\n    } finally {\n      draining = false;\n    }\n  };\n\n  const enqueue = (mutation: QueuedMutation): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      pending.push({ mutation, resolve, reject });\n      void drain();\n    });\n\n  /** Read-modify-write one topic-batched append inside a single transaction. */\n  const appendTransaction = (messages: ReadonlyArray<DataBusMessage<TData>>): Promise<void> =>\n    (async () => {\n      const db = await open();\n      return new Promise<void>((resolve, reject) => {\n        let transaction: IDBTransaction;\n        try {\n          transaction = db.transaction(storeName, 'readwrite');\n        } catch (error) {\n          invalidate(db);\n          reject(error);\n          return;\n        }\n        const store = transaction.objectStore(storeName);\n        const grouped = new Map<string, DataBusMessage<TData>[]>();\n        for (const message of messages) {\n          grouped.set(message.topic, [...(grouped.get(message.topic) ?? []), message]);\n        }\n        let hasError = false;\n        const fail = (error: unknown): void => {\n          if (hasError) return;\n          hasError = true;\n          invalidate(db);\n          reject(error);\n        };\n        for (const [topic, topicMessages] of grouped) {\n          const request = store.get(topic);\n          request.onsuccess = () => {\n            if (hasError) return;\n            const history = pruneReplayHistory(\n              ((request.result?.messages ?? []) as DataBusMessage<TData>[]).concat(topicMessages),\n              { maxPerTopic, pruneStrategy, retentionMs, now: Date.now() }\n            );\n            store.put({ topic, messages: history });\n          };\n          request.onerror = () => fail(request.error ?? new Error('Failed to read replay history.'));\n        }\n        transaction.oncomplete = () => {\n          if (!hasError) resolve();\n        };\n        transaction.onerror = () => fail(transaction.error ?? new Error('Failed to persist replay history.'));\n        // A connection loss can abort a transaction without first dispatching a\n        // request error. Without this path, the serialized mutation queue would\n        // stay blocked forever after the promise never settles.\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to persist replay history.'));\n      });\n    })();\n  const open = (): Promise<IDBDatabase> => {\n    if (dbPromise) return dbPromise;\n    const pending = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDb.open(dbName, 1);\n      request.onupgradeneeded = () => request.result.createObjectStore(storeName, { keyPath: 'topic' });\n      request.onsuccess = () => {\n        const db = request.result;\n        // A schema upgrade in another tab invalidates this connection. Close\n        // it and clear the cached promise so the next operation reopens a\n        // usable connection instead of repeatedly targeting a dead database.\n        db.onversionchange = () => {\n          db.close();\n          if (dbPromise) dbPromise = null;\n        };\n        resolve(db);\n      };\n      request.onerror = () => reject(request.error ?? new Error('Failed to open replay database.'));\n    });\n    dbPromise = pending;\n    // Do not permanently cache a rejected open promise. IndexedDB can fail\n    // transiently (quota, private-mode initialization, a closing connection,\n    // or a browser shutdown); the next operation must be able to retry.\n    void pending.catch(() => {\n      if (dbPromise === pending) dbPromise = null;\n    });\n    return pending;\n  };\n  return {\n    async load() {\n      const db = await open();\n      return new Promise((resolve, reject) => {\n        let transaction: IDBTransaction;\n        let request: IDBRequest;\n        try {\n          transaction = db.transaction(storeName, 'readonly');\n          request = transaction.objectStore(storeName).getAll();\n        } catch (error) {\n          invalidate(db);\n          reject(error);\n          return;\n        }\n        let settled = false;\n        const fail = (error: unknown): void => {\n          if (settled) return;\n          settled = true;\n          invalidate(db);\n          reject(error);\n        };\n        let records: Array<{ messages: DataBusMessage<TData>[] }> = [];\n        request.onsuccess = () => {\n          records = request.result as Array<{ messages: DataBusMessage<TData>[] }>;\n        };\n        request.onerror = () => fail(request.error ?? new Error('Failed to load replay history.'));\n        transaction.oncomplete = () => {\n          if (settled) return;\n          settled = true;\n          resolve(records.flatMap(record => record.messages));\n        };\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to load replay history.'));\n      });\n    },\n    append(message) {\n      return enqueue({ kind: 'batch', messages: [message] });\n    },\n    appendBatch(messages) {\n      if (messages.length === 0) return Promise.resolve();\n      return enqueue({ kind: 'batch', messages });\n    },\n    clear() {\n      return enqueue({\n        kind: 'run',\n        run: () => (async () => {\n        const db = await open();\n        return new Promise<void>((resolve, reject) => {\n        let transaction: IDBTransaction;\n        try { transaction = db.transaction(storeName, 'readwrite'); }\n        catch (error) { invalidate(db); reject(error); return; }\n        let settled = false;\n        const fail = (error: unknown): void => {\n          if (settled) return;\n          settled = true;\n          invalidate(db);\n          reject(error);\n        };\n        transaction.objectStore(storeName).clear();\n        transaction.oncomplete = () => { settled = true; resolve(); };\n        transaction.onerror = () => fail(transaction.error ?? new Error('Failed to clear replay history.'));\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to clear replay history.'));\n        });\n        })()\n      });\n    },\n    clearTopic(topic) {\n      return enqueue({\n        kind: 'run',\n        run: () => (async () => {\n        const db = await open();\n        return new Promise<void>((resolve, reject) => {\n        let transaction: IDBTransaction;\n        try { transaction = db.transaction(storeName, 'readwrite'); }\n        catch (error) { invalidate(db); reject(error); return; }\n        let settled = false;\n        const fail = (error: unknown): void => {\n          if (settled) return;\n          settled = true;\n          invalidate(db);\n          reject(error);\n        };\n        transaction.objectStore(storeName).delete(topic);\n        transaction.oncomplete = () => { settled = true; resolve(); };\n        transaction.onerror = () => fail(transaction.error ?? new Error('Failed to clear topic replay history.'));\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to clear topic replay history.'));\n        });\n        })()\n      });\n    },\n    clearBefore(timestamp) {\n      return enqueue({\n        kind: 'run',\n        run: () => (async () => {\n        const db = await open();\n        return new Promise<void>((resolve, reject) => {\n        let transaction: IDBTransaction;\n        try { transaction = db.transaction(storeName, 'readwrite'); }\n        catch (error) { invalidate(db); reject(error); return; }\n        let settled = false;\n        const fail = (error: unknown): void => {\n          if (settled) return;\n          settled = true;\n          invalidate(db);\n          reject(error);\n        };\n        const store = transaction.objectStore(storeName);\n        const request = store.getAll();\n        request.onsuccess = () => {\n          for (const record of request.result as Array<{ topic: string; messages: DataBusMessage<TData>[] }>) {\n            const messages = record.messages.filter(message => message.timestamp === undefined || message.timestamp >= timestamp);\n            if (messages.length === 0) store.delete(record.topic);\n            else if (messages.length !== record.messages.length) store.put({ topic: record.topic, messages });\n          }\n        };\n        request.onerror = () => fail(request.error ?? new Error('Failed to read replay history.'));\n        transaction.oncomplete = () => { settled = true; resolve(); };\n        transaction.onerror = () => fail(transaction.error ?? new Error('Failed to prune replay history.'));\n        transaction.onabort = () => fail(transaction.error ?? new Error('Failed to prune replay history.'));\n        });\n        })()\n      });\n    }\n  };\n}\n", "/**\n * WebSocketTransport \u2014 a dependency-free transport over a plain WebSocket.\n *\n * Validates the `DataBusTransport` abstraction with a second, minimal backend:\n * any WebSocket server that speaks the tiny JSON protocol below can back the\n * same cross-tab clustering stack (owner dedup, sticky routes, EVENT fan-out)\n * that the Centrifuge backend uses.\n *\n * Wire protocol (JSON text frames):\n * - client \u2192 server: `{\"op\":\"subscribe\"|\"unsubscribe\"|\"publish\",\"topic\":...,\"data\":...}`\n * - client \u2192 server (batched): `{\"op\":\"publishBatch\",\"topic\":...,\"items\":[{data,...}]}`\n * - server \u2192 client: `{\"topic\":...,\"data\":...}` for publications; anything\n *   without a string `topic` field is ignored (forward-compatible).\n */\nimport { CrossTabDataBus } from './core/data-bus';\nimport { parseDataBusPublication } from './core/publication';\nimport type { CrossTabDataBusOptions } from './core/data-bus';\nimport { WS_OP, WORKER_STATUS } from './utils/constants';\nimport type {\n  DataBusTransport,\n  DataBusTransportHandlers,\n  DataBusPublishOptions,\n  DataBusPublicationItem,\n  DataBusMessage,\n  MaybePromise,\n  WorkerStatus\n} from './core/types';\n\n/** Minimal WebSocket surface used by the transport. Matches the browser\n * `WebSocket` subset the transport touches; injectable for tests and runtimes. */\nexport interface WebSocketLike {\n  /** Current connection state; 1 (OPEN) means frames may be sent. */\n  readonly readyState?: number;\n  send(data: string | ArrayBuffer): void;\n  close(code?: number, reason?: string): void;\n  onopen: (() => void) | null;\n  onclose: (() => void) | null;\n  onerror: (() => void) | null;\n  onmessage: ((event: { data: unknown }) => void) | null;\n}\n\n/** Connection configuration for {@link WebSocketTransport}. */\nexport interface WebSocketDataBusConfig {\n  /** WebSocket endpoint, e.g. `wss://example.test/ws`. */\n  url: string;\n  /** Subprotocol(s) passed to the WebSocket handshake. */\n  protocols?: string | string[];\n  /** Custom socket factory. Defaults to the global `WebSocket`; injectable\n   * for tests and non-browser runtimes. */\n  webSocketFactory?: (url: string, protocols?: string | string[]) => WebSocketLike;\n  /** Milliseconds to wait for the handshake before reporting `error` and\n   * failing the start. Defaults to 30000 ms; pass\n   * `0` or `Infinity` to wait indefinitely. The timeout exists because\n   * `start()` resolves on connect, so a socket that never opens and never\n   * errors would otherwise leave the DataBus start gate (and every operation\n   * queued behind it) pending forever. */\n  connectTimeoutMs?: number;\n}\n\n/** Options for creating a fully-configured CrossTabDataBus with a WebSocket transport. */\nexport interface CreateWebSocketDataBusOptions<TData = unknown>\n  extends Omit<\n    CrossTabDataBusOptions<WebSocketDataBusConfig, TData>,\n    'autoStart' | 'clusterKey' | 'initialConfig' | 'transport'\n  > {\n  /** WebSocket connection configuration. */\n  connection: WebSocketDataBusConfig;\n  /** Cluster key for cross-tab coordination. Defaults to the connection URL. */\n  clusterKey?: string;\n}\n\n/** Default handshake budget. A socket that never opens and never fires\n * error/close would otherwise keep a started transport stuck in `connecting`\n * forever, with every queued operation parked behind an unsettled `start()`. */\nconst DEFAULT_CONNECT_TIMEOUT_MS = 30_000;\n\nconst WS_OPEN = 1;\n\n/** Transport that talks a minimal JSON protocol over a plain WebSocket.\n * Connection lifecycle maps directly to the DataBus status vocabulary:\n * open \u2192 `connected`, close \u2192 `disconnected`, error \u2192 `error` (which the\n * DataBus treats as its auto-recovery trigger). The transport holds no\n * reconnection logic of its own \u2014 reopening is the DataBus's job. */\nexport class WebSocketTransport<TData = unknown>\n  implements DataBusTransport<WebSocketDataBusConfig, TData>\n{\n  readonly diagnosticsName = 'websocket';\n  readonly diagnosticsBackend = 'native-websocket';\n  private socket: WebSocketLike | null = null;\n  private socketActive = false;\n  private handlers: DataBusTransportHandlers<TData> | null = null;\n  private readonly subscribedTopics = new Set<string>();\n  // Handshake gate for the current start(). Resolves once the socket opens,\n  // rejects when the attempt fails, so the DataBus start Promise \u2014 and every\n  // operation parked behind it \u2014 settles at the real connection boundary.\n  private connectPromise: Promise<void> | null = null;\n  private connectResolve: (() => void) | null = null;\n  private connectReject: ((error: unknown) => void) | null = null;\n  private connectTimer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(private readonly connection: WebSocketDataBusConfig) {}\n\n  /** Open the WebSocket and wire lifecycle listeners. Resolves once the\n   * handshake completes and rejects when the attempt fails, matching the\n   * `DataBusTransport.start` contract (\"resolves on connect or rejects on\n   * failure\"). A factory failure is reported through `onStatus('error')` so\n   * the DataBus can recover. */\n  start(config: WebSocketDataBusConfig, handlers: DataBusTransportHandlers<TData>): MaybePromise<void> {\n    if (this.socket && this.socketActive) {\n      // Reuse the live socket instead of orphaning it. While the first\n      // attempt is still connecting, share its handshake gate so a duplicate\n      // start() cannot report readiness before the socket is usable.\n      return this.connectPromise ?? undefined;\n    }\n    // A failed or closed socket is one-shot; retain its object only long\n    // enough for a transparent same-object reopen to fire, but replace it\n    // whenever start() is called again. Clearing the reference here also\n    // makes every late callback from the old socket a no-op.\n    this.socket = null;\n    this.socketActive = false;\n    this.handlers = handlers;\n    // The factory may live on the constructor connection (createWebSocketDataBus\n    // path) or on the runtime config (direct transport use) \u2014 accept both.\n    const factory = config.webSocketFactory ?? this.connection.webSocketFactory ?? defaultWebSocketFactory;\n    const protocols = config.protocols ?? this.connection.protocols;\n    let socket: WebSocketLike;\n    try {\n      socket = factory(config.url, protocols);\n    } catch (error) {\n      handlers.onStatus(WORKER_STATUS.ERROR);\n      handlers.onError(error);\n      return;\n    }\n    const opening = new Promise<void>((resolve, reject) => {\n      this.connectResolve = resolve;\n      this.connectReject = reject;\n      // Per-attempt handshake state. A socket that opens, then closes and\n      // re-opens in place (a protocol-level recovery) may reuse the same\n      // attempt; a timeout or a close/error before the first open permanently\n      // invalidates it so a late onopen cannot report readiness.\n      let handshakeCompleted = false;\n      let handshakeFailed = false;\n      const timeoutMs =\n        config.connectTimeoutMs ?? this.connection.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;\n      if (Number.isFinite(timeoutMs) && timeoutMs > 0) {\n        this.connectTimer = setTimeout(() => {\n          if (this.socket !== socket || this.handlers !== handlers || handshakeCompleted) return;\n          handshakeFailed = true;\n          this.connectTimer = null;\n          this.socketActive = false;\n          const error = new Error(`WebSocket did not open within ${timeoutMs}ms.`);\n          handlers.onStatus(WORKER_STATUS.ERROR);\n          handlers.onError(error);\n          this.failConnect(error);\n          // Abort the half-open handshake so the timed-out attempt cannot\n          // linger in CONNECTING or deliver a late onopen.\n          socket.close();\n        }, timeoutMs);\n      }\n      socket.onopen = () => {\n        if (this.socket !== socket || this.handlers !== handlers || handshakeFailed) return;\n        this.socketActive = true;\n        this.clearConnectTimer();\n        // Re-assert every topic so a reopened socket (recovery path) restores\n        // the server-side subscriptions without DataBus involvement.\n        for (const topic of this.subscribedTopics) {\n          this.sendFrame({ op: WS_OP.SUBSCRIBE, topic });\n        }\n        handlers.onStatus(WORKER_STATUS.CONNECTED);\n        if (!handshakeCompleted) {\n          handshakeCompleted = true;\n          this.settleConnect();\n        }\n      };\n      socket.onclose = () => {\n        if (this.socket !== socket || this.handlers !== handlers || !this.socketActive) return;\n        this.socketActive = false;\n        handlers.onStatus(WORKER_STATUS.DISCONNECTED);\n        if (!handshakeCompleted) {\n          handshakeFailed = true;\n          this.failConnect(new Error('WebSocket closed before the handshake completed.'));\n        }\n      };\n      socket.onerror = () => {\n        if (this.socket !== socket || this.handlers !== handlers || !this.socketActive) return;\n        this.socketActive = false;\n        handlers.onStatus(WORKER_STATUS.ERROR);\n        if (!handshakeCompleted) {\n          handshakeFailed = true;\n          this.failConnect(new Error('WebSocket failed to open.'));\n        }\n      };\n      socket.onmessage = event => {\n        if (this.socket === socket && this.handlers === handlers && this.socketActive) {\n          void this.handleMessage(event.data);\n        }\n      };\n      this.socket = socket;\n      this.socketActive = true;\n    });\n    this.connectPromise = opening;\n    return opening;\n  }\n\n  /** Idempotent: re-subscribing an active topic re-sends the frame but does\n   * not duplicate the local tracking entry. */\n  subscribe(topic: string): MaybePromise<void> {\n    this.subscribedTopics.add(topic);\n    this.sendFrame({ op: WS_OP.SUBSCRIBE, topic });\n  }\n\n  /** Idempotent: unsubscribing an unknown topic is a no-op. */\n  unsubscribe(topic: string): MaybePromise<void> {\n    this.subscribedTopics.delete(topic);\n    this.sendFrame({ op: WS_OP.UNSUBSCRIBE, topic });\n  }\n\n  /** Publish `data` to `topic` as a JSON frame. Requires an open socket. */\n  publish(topic: string, data: unknown, options?: DataBusPublishOptions): MaybePromise<void> {\n    if (data instanceof ArrayBuffer) {\n      this.sendBinaryFrame(topic, data, options?.messageId, options?.timestamp);\n      return;\n    }\n    this.sendFrame({\n      op: WS_OP.PUBLISH,\n      topic,\n      data,\n      ...(options?.messageId === undefined ? {} : { messageId: options.messageId }),\n      ...(options?.timestamp === undefined ? {} : { timestamp: options.timestamp })\n    });\n  }\n\n  /** Publish many items for one topic as a single wire frame. One-item\n   * batches delegate to `publish` so the legacy single-publication frame\n   * shape (including binary framing) is preserved. */\n  publishBatch(topic: string, items: ReadonlyArray<DataBusPublicationItem>): MaybePromise<void> {\n    if (items.length === 0) return;\n    if (items.length === 1) {\n      const single = items[0]!;\n      return this.publish(topic, single.data, {\n        ...(single.messageId === undefined ? {} : { messageId: single.messageId }),\n        ...(single.timestamp === undefined ? {} : { timestamp: single.timestamp })\n      });\n    }\n    if (this.socket?.readyState !== WS_OPEN) {\n      this.handlers?.onError(new Error('WebSocket is not open; dropped \"publishBatch\" frame.'));\n      return;\n    }\n    // Binary payloads are embedded as byte arrays so the whole batch stays in\n    // one JSON frame; the server re-fans them out as individual publications.\n    this.socket.send(JSON.stringify({\n      op: WS_OP.PUBLISH_BATCH,\n      topic,\n      items: items.map(item => ({\n        data: item.data instanceof ArrayBuffer ? Array.from(new Uint8Array(item.data)) : item.data,\n        ...(item.messageId === undefined ? {} : { messageId: item.messageId }),\n        ...(item.timestamp === undefined ? {} : { timestamp: item.timestamp })\n      }))\n    }));\n  }\n\n  /** Close the socket and drop all state. Safe to call multiple times. */\n  stop(): MaybePromise<void> {\n    const socket = this.socket;\n    const shouldClose = this.socketActive;\n    this.socket = null;\n    this.socketActive = false;\n    this.handlers = null;\n    this.subscribedTopics.clear();\n    // Settle an in-flight handshake gate: a DataBus stop() awaits the start\n    // Promise, so leaving it pending would hang teardown. Resolving (rather\n    // than rejecting) keeps an intentional stop from surfacing as an error.\n    this.settleConnect();\n    this.connectPromise = null;\n    if (shouldClose) socket?.close();\n  }\n\n  /** Resolve the in-flight handshake gate. Idempotent: once the socket has\n   * opened (or a newer attempt replaced it) later calls are no-ops. */\n  private settleConnect(): void {\n    this.clearConnectTimer();\n    const resolve = this.connectResolve;\n    this.connectResolve = null;\n    this.connectReject = null;\n    resolve?.();\n  }\n\n  /** Reject the in-flight handshake gate. Idempotent on the same terms as\n   * {@link settleConnect}. */\n  private failConnect(error: unknown): void {\n    this.clearConnectTimer();\n    const reject = this.connectReject;\n    this.connectResolve = null;\n    this.connectReject = null;\n    reject?.(error);\n  }\n\n  private clearConnectTimer(): void {\n    if (this.connectTimer !== null) {\n      clearTimeout(this.connectTimer);\n      this.connectTimer = null;\n    }\n  }\n\n  /** Send one JSON frame. Frames are dropped with an `onError` report when\n   * the socket is not open \u2014 subscribe frames are re-sent on open, so the\n   * only real loss is a publish during a disconnect window. */\n  private sendFrame(payload: { op: string; topic: string; data?: unknown; messageId?: string; timestamp?: number }): void {\n    if (this.socket?.readyState !== WS_OPEN) {\n      this.handlers?.onError(new Error(`WebSocket is not open; dropped \"${payload.op}\" frame.`));\n      return;\n    }\n    this.socket.send(JSON.stringify(payload));\n  }\n\n  private sendBinaryFrame(topic: string, data: ArrayBuffer, messageId?: string, timestamp?: number): void {\n    if (messageId !== undefined || timestamp !== undefined) {\n      // Binary frames retain their compact legacy shape; metadata is sent as a\n      // JSON envelope so IDs are never silently lost.\n      this.sendFrame({\n        op: WS_OP.PUBLISH,\n        topic,\n        data: Array.from(new Uint8Array(data)),\n        ...(messageId === undefined ? {} : { messageId }),\n        ...(timestamp === undefined ? {} : { timestamp })\n      });\n      return;\n    }\n    if (this.socket?.readyState !== WS_OPEN) {\n      this.handlers?.onError(new Error('WebSocket is not open; dropped \"publish\" frame.'));\n      return;\n    }\n    const topicBytes = new TextEncoder().encode(topic);\n    if (topicBytes.length > 0xffff) {\n      this.handlers?.onError(new Error('WebSocket topic is too long for a binary frame.'));\n      return;\n    }\n    const frame = new Uint8Array(3 + topicBytes.length + data.byteLength);\n    frame[0] = 0xc7;\n    new DataView(frame.buffer).setUint16(1, topicBytes.length);\n    frame.set(topicBytes, 3);\n    frame.set(new Uint8Array(data), 3 + topicBytes.length);\n    this.socket.send(frame.buffer);\n  }\n\n  /** Parse a server frame. Only objects carrying a string `topic` are\n   * publications; malformed JSON and unknown shapes are ignored so a chatty\n   * server cannot crash the message path. */\n  private async handleMessage(raw: unknown): Promise<void> {\n    // Browser WebSockets may deliver binary frames as Blob unless\n    // `binaryType = 'arraybuffer'` is explicitly configured by the host.\n    // Normalize Blob asynchronously and reuse the exact ArrayBuffer parser.\n    if (typeof Blob !== 'undefined' && raw instanceof Blob) {\n      try {\n        await this.handleMessage(await raw.arrayBuffer());\n      } catch (error) {\n        this.handlers?.onError(error);\n      }\n      return;\n    }\n    let parsed: unknown;\n    if (raw instanceof ArrayBuffer) {\n      const bytes = new Uint8Array(raw);\n      if (bytes[0] !== 0xc7 || bytes.length < 3) return;\n      const topicLength = new DataView(raw).getUint16(1);\n      if (bytes.length < 3 + topicLength) return;\n      const topic = new TextDecoder().decode(bytes.subarray(3, 3 + topicLength));\n      const data = bytes.slice(3 + topicLength).buffer;\n      this.handlers?.onMessage({ topic, data: data as TData });\n      return;\n    }\n    if (typeof raw !== 'string') return;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      this.handlers?.onError(new Error('WebSocket server sent a non-JSON frame.'));\n      return;\n    }\n    if (!parsed || typeof parsed !== 'object') return;\n    const publication = parseDataBusPublication<TData>(parsed);\n    if (publication) this.handlers?.onMessage(publication as DataBusMessage<TData>);\n  }\n}\n\n/** Resolve the platform WebSocket, or null in runtimes without one (SSR/Node). */\nfunction defaultWebSocketFactory(url: string, protocols?: string | string[]): WebSocketLike {\n  if (typeof WebSocket === 'undefined') {\n    throw new Error('WebSocketTransport requires a WebSocket implementation.');\n  }\n  return new WebSocket(url, protocols) as unknown as WebSocketLike;\n}\n\n/** Create a CrossTabDataBus backed by a plain WebSocket transport.\n * Cross-tab clustering (owner dedup, sticky routes, failover) works identically\n * to the Centrifuge backend \u2014 only the transport I/O differs. */\nexport function createWebSocketDataBus<TData = unknown>(\n  options: CreateWebSocketDataBusOptions<TData>\n): CrossTabDataBus<WebSocketDataBusConfig, TData> {\n  const { clusterKey, connection, ...dataBusOptions } = options;\n  return new CrossTabDataBus({\n    ...dataBusOptions,\n    autoStart: true,\n    clusterKey: clusterKey ?? connection.url,\n    initialConfig: connection,\n    transport: new WebSocketTransport<TData>(connection)\n  });\n}\n\n/** Re-export for convenience: the status type used by the transport. */\nexport type { WorkerStatus };\n"],
+  "mappings": "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",
   "names": ["pending"]
 }

package/dist/vue.d.ts

@@ -16,7 +16,8 @@ export interface UseCrossTabHealthOptions {
 /**
  * Mirror the bus health summary into a Vue ref. `getHealthSummary()` is a
  * snapshot, so the composable polls it on an interval (default 1000 ms) and
- * refreshes on status changes and errors. Returns `null` until the bus exists.
+ * refreshes on status changes and errors. A reactive interval change replaces
+ * the timer without rebuilding the bus. Returns `null` until the bus exists.
  */
 export declare function useCrossTabHealth<TConfig, TData>(bus: Ref<CrossTabDataBus<TConfig, TData> | null>, options?: UseCrossTabHealthOptions): Ref<DataBusHealthSummary | null>;
 //# sourceMappingURL=vue.d.ts.map

package/dist/vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../src/vue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAsD,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAC/C,MAAM,EAAE,MAAM,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,EAC7C,IAAI,GAAE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAM,GACvD,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,CA2B7C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,KAAK,EACpD,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAC7E,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,GAChD,IAAI,CAoBN;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAC9C,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,GAC/C,GAAG,CAAC,YAAY,CAAC,CAUnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;yDACqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAC9C,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,EAChD,OAAO,CAAC,EAAE,wBAAwB,GACjC,GAAG,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAyBlC"}
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../src/vue.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAsD,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,KAAK,EAC/C,MAAM,EAAE,MAAM,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,EAC7C,IAAI,GAAE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,CAAM,GACvD,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,CA2B7C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,KAAK,EACpD,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAC7E,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,GAChD,IAAI,CAoBN;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAC9C,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,GAC/C,GAAG,CAAC,YAAY,CAAC,CAUnB;AAED,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;yDACqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAC9C,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,EAChD,OAAO,CAAC,EAAE,wBAAwB,GACjC,GAAG,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAyBlC"}

package/dist/vue.js

@@ -85,7 +85,7 @@ function useCrossTabHealth(bus, options) {
     for (const cleanup of cleanups) cleanup();
     cleanups = [];
   };
-  watch(bus, (next) => {
+  watch([bus, () => options?.intervalMs], ([next]) => {
     teardown();
     if (!next) {
       health.value = null;

package/dist/vue.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/vue.ts"],
-  "sourcesContent": ["/** Vue 3 composables adapter for cross-tab-worker-databus.\n * Vue is an optional peer dependency; this module is a separate entry point.\n */\nimport { onBeforeUnmount, onMounted, ref, shallowRef, watch, type Ref } from 'vue';\nimport type { CrossTabDataBus, DataBusHealthSummary } from './core/data-bus';\nimport type { DataBusMessage, WorkerStatus } from './core/types';\nimport { WORKER_STATUS } from './utils/constants';\n\nexport function useCrossTabDataBus<TConfig, TData>(\n  create: () => CrossTabDataBus<TConfig, TData>,\n  deps: ReadonlyArray<Ref<unknown> | (() => unknown)> = []\n): Ref<CrossTabDataBus<TConfig, TData> | null> {\n  const bus = shallowRef<CrossTabDataBus<TConfig, TData> | null>(null);\n  let instance: CrossTabDataBus<TConfig, TData> | null = null;\n  let lifecycleGeneration = 0;\n  const stop = async () => { const current = instance; instance = null; bus.value = null; if (current) await current.stop(); };\n  const start = () => {\n    const generation = ++lifecycleGeneration;\n    void stop().then(() => {\n      if (generation !== lifecycleGeneration) return;\n      const next = create();\n      instance = next;\n      bus.value = next;\n      void next.ready().catch(() => {});\n    });\n  };\n  onMounted(start);\n  onBeforeUnmount(() => {\n    // Bump the generation so a start() still awaiting its stop() sees itself\n    // superseded. Without this the pending continuation would run create()\n    // after the component is gone, leaving a live bus with no owner to stop\n    // it (the React adapter has no such window: its create() is synchronous\n    // inside useEffect).\n    lifecycleGeneration += 1;\n    void stop();\n  });\n  if (deps.length > 0) watch(deps, start);\n  return bus as Ref<CrossTabDataBus<TConfig, TData> | null>;\n}\n\nexport function useCrossTabSubscription<TConfig, TData>(\n  bus: Ref<CrossTabDataBus<TConfig, TData> | null>, topic: Ref<string> | string,\n  handler: (message: DataBusMessage<TData>) => void\n): void {\n  let currentBus: CrossTabDataBus<TConfig, TData> | null = null;\n  let currentTopic: string | null = null;\n  let cleanup: (() => void) | undefined;\n  let latestHandler = handler;\n  const stop = () => { cleanup?.(); cleanup = undefined; currentBus = null; currentTopic = null; };\n  const sync = () => {\n    const nextBus = bus.value;\n    const nextTopic = typeof topic === 'string' ? topic : topic.value;\n    if (nextBus === currentBus && currentTopic === nextTopic && cleanup) return;\n    stop();\n    if (!nextBus) return;\n    currentBus = nextBus;\n    currentTopic = nextTopic;\n    cleanup = nextBus.subscribe(nextTopic, message => latestHandler(message));\n  };\n  watch(bus, sync, { immediate: true });\n  if (typeof topic !== 'string') watch(topic, sync);\n  watch(() => handler, value => { latestHandler = value; });\n  onBeforeUnmount(stop);\n}\n\nexport function useCrossTabStatus<TConfig, TData>(\n  bus: Ref<CrossTabDataBus<TConfig, TData> | null>\n): Ref<WorkerStatus> {\n  const status = ref<WorkerStatus>(WORKER_STATUS.CONNECTING);\n  let cleanup: (() => void) | undefined;\n  watch(bus, next => {\n    cleanup?.(); cleanup = undefined;\n    status.value = next?.getStatus() ?? WORKER_STATUS.CONNECTING;\n    if (next) cleanup = next.onStatus(value => { status.value = value; });\n  }, { immediate: true });\n  onBeforeUnmount(() => cleanup?.());\n  return status;\n}\n\n/** Options for {@link useCrossTabHealth}. */\nexport interface UseCrossTabHealthOptions {\n  /** Polling cadence in ms for the health snapshot. Default 1000; `0` disables\n   * polling and relies on status/error events only. */\n  intervalMs?: number;\n}\n\n/**\n * Mirror the bus health summary into a Vue ref. `getHealthSummary()` is a\n * snapshot, so the composable polls it on an interval (default 1000 ms) and\n * refreshes on status changes and errors. Returns `null` until the bus exists.\n */\nexport function useCrossTabHealth<TConfig, TData>(\n  bus: Ref<CrossTabDataBus<TConfig, TData> | null>,\n  options?: UseCrossTabHealthOptions\n): Ref<DataBusHealthSummary | null> {\n  const health = ref<DataBusHealthSummary | null>(null);\n  let timer: ReturnType<typeof setInterval> | null = null;\n  let cleanups: Array<() => void> = [];\n  const teardown = () => {\n    if (timer) clearInterval(timer);\n    timer = null;\n    for (const cleanup of cleanups) cleanup();\n    cleanups = [];\n  };\n  watch(bus, next => {\n    teardown();\n    if (!next) {\n      health.value = null;\n      return;\n    }\n    const refresh = () => { health.value = next.getHealthSummary(); };\n    refresh();\n    cleanups.push(next.onStatus(refresh));\n    cleanups.push(next.onError(refresh));\n    const intervalMs = options?.intervalMs ?? 1_000;\n    if (intervalMs > 0) timer = setInterval(refresh, intervalMs);\n  }, { immediate: true });\n  onBeforeUnmount(teardown);\n  return health as Ref<DataBusHealthSummary | null>;\n}\n"],
-  "mappings": ";;;;;AAGA,SAAS,iBAAiB,WAAW,KAAK,YAAY,aAAuB;AAKtE,SAAS,mBACd,QACA,OAAsD,CAAC,GACV;AAC7C,QAAM,MAAM,WAAmD,IAAI;AACnE,MAAI,WAAmD;AACvD,MAAI,sBAAsB;AAC1B,QAAM,OAAO,YAAY;AAAE,UAAM,UAAU;AAAU,eAAW;AAAM,QAAI,QAAQ;AAAM,QAAI,QAAS,OAAM,QAAQ,KAAK;AAAA,EAAG;AAC3H,QAAM,QAAQ,MAAM;AAClB,UAAM,aAAa,EAAE;AACrB,SAAK,KAAK,EAAE,KAAK,MAAM;AACrB,UAAI,eAAe,oBAAqB;AACxC,YAAM,OAAO,OAAO;AACpB,iBAAW;AACX,UAAI,QAAQ;AACZ,WAAK,KAAK,MAAM,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IAClC,CAAC;AAAA,EACH;AACA,YAAU,KAAK;AACf,kBAAgB,MAAM;AAMpB,2BAAuB;AACvB,SAAK,KAAK;AAAA,EACZ,CAAC;AACD,MAAI,KAAK,SAAS,EAAG,OAAM,MAAM,KAAK;AACtC,SAAO;AACT;AAEO,SAAS,wBACd,KAAkD,OAClD,SACM;AACN,MAAI,aAAqD;AACzD,MAAI,eAA8B;AAClC,MAAI;AACJ,MAAI,gBAAgB;AACpB,QAAM,OAAO,MAAM;AAAE,cAAU;AAAG,cAAU;AAAW,iBAAa;AAAM,mBAAe;AAAA,EAAM;AAC/F,QAAM,OAAO,MAAM;AACjB,UAAM,UAAU,IAAI;AACpB,UAAM,YAAY,OAAO,UAAU,WAAW,QAAQ,MAAM;AAC5D,QAAI,YAAY,cAAc,iBAAiB,aAAa,QAAS;AACrE,SAAK;AACL,QAAI,CAAC,QAAS;AACd,iBAAa;AACb,mBAAe;AACf,cAAU,QAAQ,UAAU,WAAW,aAAW,cAAc,OAAO,CAAC;AAAA,EAC1E;AACA,QAAM,KAAK,MAAM,EAAE,WAAW,KAAK,CAAC;AACpC,MAAI,OAAO,UAAU,SAAU,OAAM,OAAO,IAAI;AAChD,QAAM,MAAM,SAAS,WAAS;AAAE,oBAAgB;AAAA,EAAO,CAAC;AACxD,kBAAgB,IAAI;AACtB;AAEO,SAAS,kBACd,KACmB;AACnB,QAAM,SAAS,IAAkB,cAAc,UAAU;AACzD,MAAI;AACJ,QAAM,KAAK,UAAQ;AACjB,cAAU;AAAG,cAAU;AACvB,WAAO,QAAQ,MAAM,UAAU,KAAK,cAAc;AAClD,QAAI,KAAM,WAAU,KAAK,SAAS,WAAS;AAAE,aAAO,QAAQ;AAAA,IAAO,CAAC;AAAA,EACtE,GAAG,EAAE,WAAW,KAAK,CAAC;AACtB,kBAAgB,MAAM,UAAU,CAAC;AACjC,SAAO;AACT;AAcO,SAAS,kBACd,KACA,SACkC;AAClC,QAAM,SAAS,IAAiC,IAAI;AACpD,MAAI,QAA+C;AACnD,MAAI,WAA8B,CAAC;AACnC,QAAM,WAAW,MAAM;AACrB,QAAI,MAAO,eAAc,KAAK;AAC9B,YAAQ;AACR,eAAW,WAAW,SAAU,SAAQ;AACxC,eAAW,CAAC;AAAA,EACd;AACA,QAAM,KAAK,UAAQ;AACjB,aAAS;AACT,QAAI,CAAC,MAAM;AACT,aAAO,QAAQ;AACf;AAAA,IACF;AACA,UAAM,UAAU,MAAM;AAAE,aAAO,QAAQ,KAAK,iBAAiB;AAAA,IAAG;AAChE,YAAQ;AACR,aAAS,KAAK,KAAK,SAAS,OAAO,CAAC;AACpC,aAAS,KAAK,KAAK,QAAQ,OAAO,CAAC;AACnC,UAAM,aAAa,SAAS,cAAc;AAC1C,QAAI,aAAa,EAAG,SAAQ,YAAY,SAAS,UAAU;AAAA,EAC7D,GAAG,EAAE,WAAW,KAAK,CAAC;AACtB,kBAAgB,QAAQ;AACxB,SAAO;AACT;",
+  "sourcesContent": ["/** Vue 3 composables adapter for cross-tab-worker-databus.\n * Vue is an optional peer dependency; this module is a separate entry point.\n */\nimport { onBeforeUnmount, onMounted, ref, shallowRef, watch, type Ref } from 'vue';\nimport type { CrossTabDataBus, DataBusHealthSummary } from './core/data-bus';\nimport type { DataBusMessage, WorkerStatus } from './core/types';\nimport { WORKER_STATUS } from './utils/constants';\n\nexport function useCrossTabDataBus<TConfig, TData>(\n  create: () => CrossTabDataBus<TConfig, TData>,\n  deps: ReadonlyArray<Ref<unknown> | (() => unknown)> = []\n): Ref<CrossTabDataBus<TConfig, TData> | null> {\n  const bus = shallowRef<CrossTabDataBus<TConfig, TData> | null>(null);\n  let instance: CrossTabDataBus<TConfig, TData> | null = null;\n  let lifecycleGeneration = 0;\n  const stop = async () => { const current = instance; instance = null; bus.value = null; if (current) await current.stop(); };\n  const start = () => {\n    const generation = ++lifecycleGeneration;\n    void stop().then(() => {\n      if (generation !== lifecycleGeneration) return;\n      const next = create();\n      instance = next;\n      bus.value = next;\n      void next.ready().catch(() => {});\n    });\n  };\n  onMounted(start);\n  onBeforeUnmount(() => {\n    // Bump the generation so a start() still awaiting its stop() sees itself\n    // superseded. Without this the pending continuation would run create()\n    // after the component is gone, leaving a live bus with no owner to stop\n    // it (the React adapter has no such window: its create() is synchronous\n    // inside useEffect).\n    lifecycleGeneration += 1;\n    void stop();\n  });\n  if (deps.length > 0) watch(deps, start);\n  return bus as Ref<CrossTabDataBus<TConfig, TData> | null>;\n}\n\nexport function useCrossTabSubscription<TConfig, TData>(\n  bus: Ref<CrossTabDataBus<TConfig, TData> | null>, topic: Ref<string> | string,\n  handler: (message: DataBusMessage<TData>) => void\n): void {\n  let currentBus: CrossTabDataBus<TConfig, TData> | null = null;\n  let currentTopic: string | null = null;\n  let cleanup: (() => void) | undefined;\n  let latestHandler = handler;\n  const stop = () => { cleanup?.(); cleanup = undefined; currentBus = null; currentTopic = null; };\n  const sync = () => {\n    const nextBus = bus.value;\n    const nextTopic = typeof topic === 'string' ? topic : topic.value;\n    if (nextBus === currentBus && currentTopic === nextTopic && cleanup) return;\n    stop();\n    if (!nextBus) return;\n    currentBus = nextBus;\n    currentTopic = nextTopic;\n    cleanup = nextBus.subscribe(nextTopic, message => latestHandler(message));\n  };\n  watch(bus, sync, { immediate: true });\n  if (typeof topic !== 'string') watch(topic, sync);\n  watch(() => handler, value => { latestHandler = value; });\n  onBeforeUnmount(stop);\n}\n\nexport function useCrossTabStatus<TConfig, TData>(\n  bus: Ref<CrossTabDataBus<TConfig, TData> | null>\n): Ref<WorkerStatus> {\n  const status = ref<WorkerStatus>(WORKER_STATUS.CONNECTING);\n  let cleanup: (() => void) | undefined;\n  watch(bus, next => {\n    cleanup?.(); cleanup = undefined;\n    status.value = next?.getStatus() ?? WORKER_STATUS.CONNECTING;\n    if (next) cleanup = next.onStatus(value => { status.value = value; });\n  }, { immediate: true });\n  onBeforeUnmount(() => cleanup?.());\n  return status;\n}\n\n/** Options for {@link useCrossTabHealth}. */\nexport interface UseCrossTabHealthOptions {\n  /** Polling cadence in ms for the health snapshot. Default 1000; `0` disables\n   * polling and relies on status/error events only. */\n  intervalMs?: number;\n}\n\n/**\n * Mirror the bus health summary into a Vue ref. `getHealthSummary()` is a\n * snapshot, so the composable polls it on an interval (default 1000 ms) and\n * refreshes on status changes and errors. A reactive interval change replaces\n * the timer without rebuilding the bus. Returns `null` until the bus exists.\n */\nexport function useCrossTabHealth<TConfig, TData>(\n  bus: Ref<CrossTabDataBus<TConfig, TData> | null>,\n  options?: UseCrossTabHealthOptions\n): Ref<DataBusHealthSummary | null> {\n  const health = ref<DataBusHealthSummary | null>(null);\n  let timer: ReturnType<typeof setInterval> | null = null;\n  let cleanups: Array<() => void> = [];\n  const teardown = () => {\n    if (timer) clearInterval(timer);\n    timer = null;\n    for (const cleanup of cleanups) cleanup();\n    cleanups = [];\n  };\n  watch([bus, () => options?.intervalMs], ([next]) => {\n    teardown();\n    if (!next) {\n      health.value = null;\n      return;\n    }\n    const refresh = () => { health.value = next.getHealthSummary(); };\n    refresh();\n    cleanups.push(next.onStatus(refresh));\n    cleanups.push(next.onError(refresh));\n    const intervalMs = options?.intervalMs ?? 1_000;\n    if (intervalMs > 0) timer = setInterval(refresh, intervalMs);\n  }, { immediate: true });\n  onBeforeUnmount(teardown);\n  return health as Ref<DataBusHealthSummary | null>;\n}\n"],
+  "mappings": ";;;;;AAGA,SAAS,iBAAiB,WAAW,KAAK,YAAY,aAAuB;AAKtE,SAAS,mBACd,QACA,OAAsD,CAAC,GACV;AAC7C,QAAM,MAAM,WAAmD,IAAI;AACnE,MAAI,WAAmD;AACvD,MAAI,sBAAsB;AAC1B,QAAM,OAAO,YAAY;AAAE,UAAM,UAAU;AAAU,eAAW;AAAM,QAAI,QAAQ;AAAM,QAAI,QAAS,OAAM,QAAQ,KAAK;AAAA,EAAG;AAC3H,QAAM,QAAQ,MAAM;AAClB,UAAM,aAAa,EAAE;AACrB,SAAK,KAAK,EAAE,KAAK,MAAM;AACrB,UAAI,eAAe,oBAAqB;AACxC,YAAM,OAAO,OAAO;AACpB,iBAAW;AACX,UAAI,QAAQ;AACZ,WAAK,KAAK,MAAM,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IAClC,CAAC;AAAA,EACH;AACA,YAAU,KAAK;AACf,kBAAgB,MAAM;AAMpB,2BAAuB;AACvB,SAAK,KAAK;AAAA,EACZ,CAAC;AACD,MAAI,KAAK,SAAS,EAAG,OAAM,MAAM,KAAK;AACtC,SAAO;AACT;AAEO,SAAS,wBACd,KAAkD,OAClD,SACM;AACN,MAAI,aAAqD;AACzD,MAAI,eAA8B;AAClC,MAAI;AACJ,MAAI,gBAAgB;AACpB,QAAM,OAAO,MAAM;AAAE,cAAU;AAAG,cAAU;AAAW,iBAAa;AAAM,mBAAe;AAAA,EAAM;AAC/F,QAAM,OAAO,MAAM;AACjB,UAAM,UAAU,IAAI;AACpB,UAAM,YAAY,OAAO,UAAU,WAAW,QAAQ,MAAM;AAC5D,QAAI,YAAY,cAAc,iBAAiB,aAAa,QAAS;AACrE,SAAK;AACL,QAAI,CAAC,QAAS;AACd,iBAAa;AACb,mBAAe;AACf,cAAU,QAAQ,UAAU,WAAW,aAAW,cAAc,OAAO,CAAC;AAAA,EAC1E;AACA,QAAM,KAAK,MAAM,EAAE,WAAW,KAAK,CAAC;AACpC,MAAI,OAAO,UAAU,SAAU,OAAM,OAAO,IAAI;AAChD,QAAM,MAAM,SAAS,WAAS;AAAE,oBAAgB;AAAA,EAAO,CAAC;AACxD,kBAAgB,IAAI;AACtB;AAEO,SAAS,kBACd,KACmB;AACnB,QAAM,SAAS,IAAkB,cAAc,UAAU;AACzD,MAAI;AACJ,QAAM,KAAK,UAAQ;AACjB,cAAU;AAAG,cAAU;AACvB,WAAO,QAAQ,MAAM,UAAU,KAAK,cAAc;AAClD,QAAI,KAAM,WAAU,KAAK,SAAS,WAAS;AAAE,aAAO,QAAQ;AAAA,IAAO,CAAC;AAAA,EACtE,GAAG,EAAE,WAAW,KAAK,CAAC;AACtB,kBAAgB,MAAM,UAAU,CAAC;AACjC,SAAO;AACT;AAeO,SAAS,kBACd,KACA,SACkC;AAClC,QAAM,SAAS,IAAiC,IAAI;AACpD,MAAI,QAA+C;AACnD,MAAI,WAA8B,CAAC;AACnC,QAAM,WAAW,MAAM;AACrB,QAAI,MAAO,eAAc,KAAK;AAC9B,YAAQ;AACR,eAAW,WAAW,SAAU,SAAQ;AACxC,eAAW,CAAC;AAAA,EACd;AACA,QAAM,CAAC,KAAK,MAAM,SAAS,UAAU,GAAG,CAAC,CAAC,IAAI,MAAM;AAClD,aAAS;AACT,QAAI,CAAC,MAAM;AACT,aAAO,QAAQ;AACf;AAAA,IACF;AACA,UAAM,UAAU,MAAM;AAAE,aAAO,QAAQ,KAAK,iBAAiB;AAAA,IAAG;AAChE,YAAQ;AACR,aAAS,KAAK,KAAK,SAAS,OAAO,CAAC;AACpC,aAAS,KAAK,KAAK,QAAQ,OAAO,CAAC;AACnC,UAAM,aAAa,SAAS,cAAc;AAC1C,QAAI,aAAa,EAAG,SAAQ,YAAY,SAAS,UAAU;AAAA,EAC7D,GAAG,EAAE,WAAW,KAAK,CAAC;AACtB,kBAAgB,QAAQ;AACxB,SAAO;AACT;",
   "names": []
 }

package/dist/websocket.d.ts

@@ -38,6 +38,13 @@ export interface WebSocketDataBusConfig {
     /** Custom socket factory. Defaults to the global `WebSocket`; injectable
      * for tests and non-browser runtimes. */
     webSocketFactory?: (url: string, protocols?: string | string[]) => WebSocketLike;
+    /** Milliseconds to wait for the handshake before reporting `error` and
+     * failing the start. Defaults to 30000 ms; pass
+     * `0` or `Infinity` to wait indefinitely. The timeout exists because
+     * `start()` resolves on connect, so a socket that never opens and never
+     * errors would otherwise leave the DataBus start gate (and every operation
+     * queued behind it) pending forever. */
+    connectTimeoutMs?: number;
 }
 /** Options for creating a fully-configured CrossTabDataBus with a WebSocket transport. */
 export interface CreateWebSocketDataBusOptions<TData = unknown> extends Omit<CrossTabDataBusOptions<WebSocketDataBusConfig, TData>, 'autoStart' | 'clusterKey' | 'initialConfig' | 'transport'> {
@@ -56,11 +63,19 @@ export declare class WebSocketTransport<TData = unknown> implements DataBusTrans
     readonly diagnosticsName = "websocket";
     readonly diagnosticsBackend = "native-websocket";
     private socket;
+    private socketActive;
     private handlers;
     private readonly subscribedTopics;
+    private connectPromise;
+    private connectResolve;
+    private connectReject;
+    private connectTimer;
     constructor(connection: WebSocketDataBusConfig);
-    /** Open the WebSocket and wire lifecycle listeners. A factory failure is
-     * reported through `onStatus('error')` so the DataBus can recover. */
+    /** Open the WebSocket and wire lifecycle listeners. Resolves once the
+     * handshake completes and rejects when the attempt fails, matching the
+     * `DataBusTransport.start` contract ("resolves on connect or rejects on
+     * failure"). A factory failure is reported through `onStatus('error')` so
+     * the DataBus can recover. */
     start(config: WebSocketDataBusConfig, handlers: DataBusTransportHandlers<TData>): MaybePromise<void>;
     /** Idempotent: re-subscribing an active topic re-sends the frame but does
      * not duplicate the local tracking entry. */
@@ -75,6 +90,13 @@ export declare class WebSocketTransport<TData = unknown> implements DataBusTrans
     publishBatch(topic: string, items: ReadonlyArray<DataBusPublicationItem>): MaybePromise<void>;
     /** Close the socket and drop all state. Safe to call multiple times. */
     stop(): MaybePromise<void>;
+    /** Resolve the in-flight handshake gate. Idempotent: once the socket has
+     * opened (or a newer attempt replaced it) later calls are no-ops. */
+    private settleConnect;
+    /** Reject the in-flight handshake gate. Idempotent on the same terms as
+     * {@link settleConnect}. */
+    private failConnect;
+    private clearConnectTimer;
     /** Send one JSON frame. Frames are dropped with an `onError` report when
      * the socket is not open — subscribe frames are re-sent on open, so the
      * only real loss is a publish during a disconnect window. */

package/dist/websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EAEtB,YAAY,EACZ,YAAY,EACb,MAAM,cAAc,CAAC;AAEtB;kFACkF;AAClF,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CACxD;AAED,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B;6CACyC;IACzC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,aAAa,CAAC;CAClF;AAED,0FAA0F;AAC1F,MAAM,WAAW,6BAA6B,CAAC,KAAK,GAAG,OAAO,CAC5D,SAAQ,IAAI,CACV,sBAAsB,CAAC,sBAAsB,EAAE,KAAK,CAAC,EACrD,WAAW,GAAG,YAAY,GAAG,eAAe,GAAG,WAAW,CAC3D;IACD,0CAA0C;IAC1C,UAAU,EAAE,sBAAsB,CAAC;IACnC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID;;;;qEAIqE;AACrE,qBAAa,kBAAkB,CAAC,KAAK,GAAG,OAAO,CAC7C,YAAW,gBAAgB,CAAC,sBAAsB,EAAE,KAAK,CAAC;IAQ9C,OAAO,CAAC,QAAQ,CAAC,UAAU;IANvC,QAAQ,CAAC,eAAe,eAAe;IACvC,QAAQ,CAAC,kBAAkB,sBAAsB;IACjD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,QAAQ,CAAgD;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;gBAEzB,UAAU,EAAE,sBAAsB;IAE/D;0EACsE;IACtE,KAAK,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,EAAE,wBAAwB,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;IAoCpG;iDAC6C;IAC7C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IAK5C,6DAA6D;IAC7D,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;IAK9C,0EAA0E;IAC1E,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,YAAY,CAAC,IAAI,CAAC;IAc1F;;wDAEoD;IACpD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC;IA0B7F,wEAAwE;IACxE,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC;IAQ1B;;iEAE6D;IAC7D,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,eAAe;IA8BvB;;+CAE2C;YAC7B,aAAa;CAkC5B;AAUD;;iEAEiE;AACjE,wBAAgB,sBAAsB,CAAC,KAAK,GAAG,OAAO,EACpD,OAAO,EAAE,6BAA6B,CAAC,KAAK,CAAC,GAC5C,eAAe,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAShD;AAED,wEAAwE;AACxE,YAAY,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"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"}

package/docs/api.md

@@ -70,11 +70,13 @@ While an explicit `stop()` is settling, `ready()` rejects unless a `start()` has
 
 If a later `stop()` cancels that queued restart, the queued `start()` Promise still resolves without opening a transport, but `ready()` rejects with a lifecycle error rather than reporting a stopped bus as ready.
 
+While the tab is BFCache-suspended (after `pagehide` and before `pageshow`), `ready()` rejects with a suspended-state error. The suspend path reuses `startPromise` as the asynchronous `transport.stop()` gate, so returning it would resolve readiness against a deliberately stopped transport. `pageshow` or an explicit `start()` clears the suspension and installs a real reopen promise, after which `ready()` resolves normally once the transport is ready.
+
 If that queued restart fails during transport startup, `ready()` rejects with the underlying startup error even when no `initialConfig` was supplied. The failure is retained for explicit recovery rather than being replaced by the generic missing-configuration error.
 
 When no `initialConfig` is provided and `start(config)` has not been called, `ready()` returns a rejected Promise instead of throwing synchronously, so callers can attach `.catch` and decide whether to start explicitly.
 
-`ready()` is not equivalent to the server being connected; protocol connection status is obtained via `onStatus`.
+`ready()` resolves when the current transport satisfies its `start()` contract; it is not a guarantee that the remote server is ready to serve application traffic. For the built-in WebSocket backend, `start()` waits for the socket handshake and rejects on a pre-open `error`, a pre-open `close`, or `connectTimeoutMs` expiry, so `ready()` cannot resolve against a `CONNECTING` socket. Protocol-level connection status remains available through `onStatus`.
 
 ### `subscribe(topic, handler)`
 
@@ -90,7 +92,7 @@ Registers a local subscription and returns a cleanup function.
 - Multiple handlers for the same topic use reference counting.
 - The first handler in the current tab registers a cluster subscription.
 - The current tab only leaves the topic after the last handler is released.
-- Subscriptions are automatically queued when the transport is not yet ready.
+- Subscriptions are automatically queued when the transport is not yet ready, including while a transport recovery is pending: they are held behind the recovery gate and issued once the reopen succeeds instead of being written to the connection that just reported `error`.
 - A subscription requested while an explicit `stop()` is settling is not registered: `subscribe()` reports the rejection through `onError` and returns a no-op cleanup function. Wait for `stop()` to settle, then call `start()` before subscribing again.
 - Wildcard subscriptions: a topic ending in `.*` (`chat.*`) matches any remainder, and `*` matches everything. The pattern is routed, owned, and transport-subscribed as a literal channel; publications tagged with a matching concrete topic (or with the pattern itself) are delivered to wildcard handlers. See `topicMatchesPattern` below.
 - Replay (opt-in): construct the bus with `replay: { maxPerTopic }` and pass `{ replay: true | n }` as the third `subscribe()` argument. `maxPerTopic` must be a positive safe integer. The new handler immediately receives the buffered history (up to `n`, capped by `maxPerTopic`, default 100) with `message.replayed: true`, so late joiners do not miss earlier publications. Only dispatched publications are buffered (a topic with no local subscriber drops them as unowned); buffers are in-memory and cleared when the last handler for the topic unsubscribes. Wildcard subscriptions replay across every buffered topic matching the pattern. For reload/BFCache persistence, pass an optional `persistence` created by `createIndexedDbReplayPersistence({ maxPerTopic })`; persistence is asynchronous and failures are reported through `onError` without breaking live delivery. Set `retentionMs` to prune expired producer-timestamped history in memory and to sweep adapters that implement `clearBefore` during hydration and after appends. Set `persistenceRetry: { maxAttempts, backoffMs }` to retry transient persistence failures; defaults preserve one-attempt behavior. Set `pruneStrategy` to `'count'` (default), `'age'`, or `'both'` to cap by `maxPerTopic`, prune timestamped history by `retentionMs`, or apply both. Under `age`, timestamp-less legacy entries are retained but capped by `maxPerTopic`; timestamped entries are bounded by the retention window.
@@ -127,6 +129,8 @@ When the owning Worker is a remote Tab and the publish control message cannot be
 
 Calling `publish()` while `stop()` is still settling reports through `onError` and routes nothing; the message is not deferred until a later start. Publications issued earlier and still queued behind an in-flight transport open are canceled by the stop.
 
+A publication issued after a runtime transport `error` is held behind the recovery gate and sent once the transport is ready again, so it is never written to the connection that just failed. If the recovery budget is exhausted or the wait is superseded by `stop()` / page hide, the publication is dropped rather than deferred indefinitely (page suspension keeps its documented drop-without-defer semantics). A clean `disconnected` status does not schedule a background DataBus reopen, but it no longer swallows later operations either: a `subscribe()` / `publish()` issued after the close demands one on-demand reopen, is held until the replacement connects, and then flushes. Call `start()` (or send an operation) to reopen explicitly.
+
 Incoming messages may include a caller/server supplied `messageId`. Enable bounded duplicate suppression with `dedup: { maxEntries, ttlMs }`; repeated IDs within the window are ignored. This is disabled by default and does not provide an exactly-once server guarantee. Tests and hosts with a custom time source may provide `dedup.now`. A full `stop()` clears the remembered ID window; a later `start()` begins a fresh dedup session.
 
 When supplied, `options.messageId` and `options.timestamp` are propagated through cross-tab routing, Worker boundaries, and supported transports. The server must echo or otherwise preserve them for inbound deduplication and replay retention.
@@ -206,7 +210,7 @@ Compact readiness verdict for dashboards, readiness probes, and support bundles.
 
 ```ts
 interface DataBusHealthSummary {
-  healthy: boolean;   // started, not suspended, transport ready
+  healthy: boolean;   // started, not suspended, live transport status is 'connected'
   state: 'stopped' | 'starting' | 'healthy' | 'recovering' | 'suspended' | 'degraded';
   status: WorkerStatus;
   sdkVersion: string;
@@ -221,7 +225,7 @@ interface DataBusHealthSummary {
 }
 ```
 
-`state` semantics: `stopped` (not started), `starting` (initial open in flight), `recovering` (automatic transport recovery in progress), `suspended` (tab hidden, resumes on pageshow), `degraded` (automatic recovery exhausted — call `start()` or subscribe again to recover manually), `healthy`. Calling `start()` again while degraded keeps the cluster, subscriptions, and replay buffers intact, resets the failure/recovery ledger, and reopens the transport; subscribe and publish also trigger the same reopen path. `lastFailure` is a unified ledger across all failure sources and resets on every explicit `start()`.
+`state` semantics: `stopped` (not started), `starting` (initial open in flight), `recovering` (automatic transport recovery in progress), `suspended` (tab hidden, resumes on pageshow), `degraded` (automatic recovery exhausted — call `start()` or subscribe again to recover manually), `healthy`. Calling `start()` again while degraded keeps the cluster, subscriptions, and replay buffers intact, resets the failure/recovery ledger, and reopens the transport; subscribe and publish also trigger the same reopen path. `lastFailure` is a unified ledger across all failure sources and resets on every explicit `start()`. The `healthy` verdict follows the live transport status; `transport.ready` is diagnostic and can remain `false` for the brief window between a transport reporting `connected` and its `start()` Promise settling, during which operations are queued behind that in-flight start rather than dropped.
 
 ### `getRecoveryStats()` / `getPersistenceStats()`
 
@@ -230,7 +234,7 @@ getRecoveryStats(): { attempt; exhausted; maxAttempts; hasError; errorMessage; e
 getPersistenceStats(): { failures; lastFailureAt; lastErrorMessage }
 ```
 
-`recovery.generation` increments on every successful transport open (initial start and each recovery); `lastSuccessAt` is the timestamp of that open (`null` before the first one). Persistence counters cover the optional replay persistence backend only.
+`recovery.generation` increments on every successful transport open (initial start and each recovery); `lastSuccessAt` is the timestamp of that open (`null` before the first one). `recovery.hasError` / `errorMessage` / `errorAt` describe the most recent retained *transport* failure — from a transport open or a runtime `onError` — and share the lifetime of the unified `lastFailure` ledger: a successful recovery keeps the last failure visible, and only an explicit `start()` clears it. Non-transport failures (`persistence`, `dispatch`) never flip the recovery ledger; they stay visible through `lastFailure` (and `getPersistenceStats()` for the replay backend). A transport failure is stamped once, so `recovery.errorAt` and the `lastFailure.at` of that same failure are equal. Persistence counters cover the optional replay persistence backend only.
 
 ### `getDiagnostics()`
 
@@ -301,7 +305,7 @@ Low-frequency event types include `lifecycle`, `status`, `subscription`, `coordi
 stop(): Promise<void>
 ```
 
-Permanently destroys the current instance: cleans up handlers, cluster registration, routes, Workers, and transport. If a transport open or reopen is still settling, `stop()` waits for it and invalidates its result so it cannot become ready after the stop. Normal page hide and restore do not require calling this method.
+Permanently destroys the current instance: cleans up handlers, cluster registration, routes, Workers, and transport. If a transport open or reopen is still settling, `stop()` waits for it and invalidates its result so it cannot become ready after the stop. Normal page hide and restore do not require calling this method. Teardown is fault-tolerant: if the transport's own `stop()` rejects (or throws), `stop()` still resolves once the bus is destroyed and reports the failure through `onError` and the unified `lastFailure` record instead of rejecting, so the fire-and-forget unmount path in the React and Vue adapters cannot produce an unhandled rejection. The instance remains restartable afterwards.
 
 ## `DataBusTransport<TConfig, TData>`
 
@@ -398,13 +402,14 @@ const bus = createWebSocketDataBus({
 new WebSocketTransport<TData>(connection: WebSocketDataBusConfig)
 ```
 
-Implements `DataBusTransport`. Connection lifecycle maps to the DataBus status vocabulary: socket `open` → `connected`, `close` → `disconnected`, `error` → `error` (which triggers DataBus auto-recovery). Subscriptions are re-asserted when a socket reopens in place. Frames dropped while the socket is not open are reported via `handlers.onError`; reopening re-sends subscribe frames.
+Implements `DataBusTransport`. `start()` settles only after the socket handshake completes: it resolves on `open` and rejects when the attempt errors, closes before opening, or exceeds `connectTimeoutMs`. Connection lifecycle maps to the DataBus status vocabulary: socket `open` → `connected`, `close` → `disconnected`, `error` → `error` (which triggers DataBus auto-recovery). Subscriptions are re-asserted when a socket reopens in place. When the bus reopens after a failed socket — automatic recovery after `error`, or an explicit `start()` / page restore / later operation after `close` — `start()` creates a replacement socket and ignores late lifecycle or message callbacks from the superseded one, including a late `open` from a timed-out attempt. Frames dropped while the socket is not open are reported via `handlers.onError`; the replacement re-sends subscribe frames.
 
 `WebSocketDataBusConfig` fields:
 
 - `url` — WebSocket endpoint.
 - `protocols` — optional subprotocol(s) for the handshake.
 - `webSocketFactory` — optional factory `(url, protocols) => WebSocketLike` for tests and non-browser runtimes (defaults to the global `WebSocket`).
+- `connectTimeoutMs` — optional handshake budget in milliseconds. Defaults to `30000`; `0` or `Infinity` waits indefinitely. On expiry the attempt reports `error` and rejects `start()` (and therefore `ready()`), then closes the half-open socket.
 
 ### Wire protocol
 
@@ -438,7 +443,7 @@ Mirrors `bus.onStatus()` into React state and reads the current value synchronou
 
 ### `useCrossTabHealth(bus, options?)`
 
-Mirrors `bus.getHealthSummary()` into React state (`DataBusHealthSummary | null`). Because the summary is a snapshot, the hook polls it on an interval (default 1000 ms; pass `{ intervalMs: 0 }` for event-driven refreshes only) and refreshes immediately on status changes and errors. Returns `null` while the bus has not been created yet.
+Mirrors `bus.getHealthSummary()` into React state (`DataBusHealthSummary | null`). Because the summary is a snapshot, the hook polls it on an interval (default 1000 ms; pass `{ intervalMs: 0 }` for event-driven refreshes only) and refreshes immediately on status changes and errors. An `intervalMs` change replaces the polling timer without recreating the bus. Returns `null` while the bus has not been created yet.
 
 ## Vue Composables (`cross-tab-worker-databus/vue`)
 
@@ -454,7 +459,7 @@ useVueCrossTabSubscription(bus, 'chat.*', message => console.log(message.data));
 
 ### `useVueCrossTabHealth(bus, options?)`
 
-The Vue binding of `useCrossTabHealth`: mirrors `bus.getHealthSummary()` into a `Ref<DataBusHealthSummary | null>`. Because the summary is a snapshot rather than an event stream, the composable polls it on an interval (default 1000 ms; pass `{ intervalMs: 0 }` for event-driven refreshes only) and refreshes immediately on status changes and errors. Returns `null` while the bus has not been created yet.
+The Vue binding of `useCrossTabHealth`: mirrors `bus.getHealthSummary()` into a `Ref<DataBusHealthSummary | null>`. Because the summary is a snapshot rather than an event stream, the composable polls it on an interval (default 1000 ms; pass `{ intervalMs: 0 }` for event-driven refreshes only) and refreshes immediately on status changes and errors. A reactive `intervalMs` change replaces the polling timer without rebuilding the bus. Returns `null` while the bus has not been created yet.
 
 ## `WorkerClusterRuntime`
 

package/docs/architecture.md

@@ -538,7 +538,7 @@ These invariants are pinned by regression tests (see `tests/stability.test.ts` a
 - **Handoff ACK validity.** A `ROUTE_RELEASED` is accepted only when the route still points at the receiver, the release comes from the recorded `handoffFromWorkerId`, and the ACK generation is at least as new as the stored route generation. Replayed ACKs from an earlier handoff round (e.g. an a↔b ping-pong) carry an older generation and are dropped.
 - **Replay persistence cleanup ordering.** A batched persistence flush queued behind the current task is filtered against the cleanup that wins the race: `unsubscribe` and `clearReplayTopic` drop the topic's pending entries, `clearReplayBefore` drops entries older than the cutoff. Cleared history is never re-appended by an in-flight flush.
 - **Storage write recovery.** Coalesced writes retry with exponential backoff (50 ms → 1.6 s cap). A structurally failing key is dropped after 5 attempts (with a `console.warn`) without permanently blocking other queued keys, and the backoff delay resets once the queue fully drains or `clear()` cancels the retries.
-- **Transport recovery budget.** Automatic recovery is paced by a cooldown, bounded by `recovery.maxAttempts`, and reports `exhausted` when the budget is spent. A successful reopen resets the attempt counter and the exhausted flag; explicit `subscribe` on a down transport can still recover manually.
+- **Transport recovery budget.** Automatic recovery is paced by a cooldown, bounded by `recovery.maxAttempts`, and reports `exhausted` when the budget is spent. A successful reopen resets the attempt counter and the exhausted flag; explicit `subscribe` on a down transport can still recover manually. Scheduling alone does not reopen a connection: the backend must release the invalid connection before a retry can create or re-open one. `WebSocketTransport` resolves `start()` only after the socket opens, rejects a pre-open `error`/`close` or a `connectTimeoutMs` expiry, marks the socket active only until error/close, and drops the stale reference before the next `start()` invokes the factory, so late callbacks from the superseded socket are ignored.
 - **BFCache suspension.** Hiding the tab stops the transport, bumps the persistence-retry generation (cancelling in-flight persistence retries without surfacing errors), and gates dispatch; pageshow reopens the transport and re-establishes subscriptions exactly once per cycle.
 - **Handoff channel close ordering.** `pause()` defers the physical `channel.close()` by one task. Closing synchronously would discard messages still queued for delivery — including the handoff's `ROUTE_RELEASED` — stranding the handoff target with an unconfirmed route.
 - **Stranded-handoff recovery.** If the previous owner is gone and its `ROUTE_RELEASED` never arrives (dropped channel message under load, or a crash between the route write and the ACK), the reconcile loop re-elects a live owner once the unconfirmed handoff has been stuck longer than a worker TTL (10 s default): the route is rewritten with a fresh generation and the handoff marker cleared, so the normal confirmation path completes (pinned by regression). The age gate matters — a fresh unconfirmed route may simply be waiting out its confirmation flush — and while the previous owner is still alive the new owner keeps waiting, so the strict handoff keeps its no-overlap guarantee.
@@ -551,6 +551,8 @@ DataBus separates "business subscription intent" from "transport current subscri
 
 The built-in Centrifuge transport also retains its own Subscriptions and performs protocol-level reconnection. Both layers of recovery require `subscribe` / `unsubscribe` to be idempotent.
 
+A runtime `error` intentionally keeps `transportReady` true: the flag records that the installed transport opened for this session, so `ready()` keeps tracking the transport instead of flapping with the protocol connection. Transport *operations* are gated separately by the recovery gate. While an automatic or demand-driven reopen is pending, `runTransport()` parks new `subscribe` / `publish` calls behind that gate rather than writing them to the connection that just reported `error`; the gate is released only once a reopen succeeds (or the transport self-heals to `connected`), and every parked operation then runs against the live transport. A failed automatic attempt keeps the gate closed but lets the next explicit operation drive an immediate on-demand reopen instead of waiting out another cooldown; once the recovery budget is exhausted, or the wait is superseded by `stop()` / page-hide, the gate is released so the documented explicit-retry path stays reachable. `disconnected` is a clean close rather than a recoverable failure: it never schedules a background DataBus reopen, and only an explicit `start()`, a page restore, the transport's own reconnection, or a later transport operation returns it to `connected`. That last path matters because the ready fast path is refused once the transport has actually reached `connected` and then reports `disconnected`; a `subscribe()` / `publish()` arriving after such a clean close is parked behind the same recovery gate and drives exactly one on-demand reopen, then flushes against the replacement connection instead of being written to the closed one. A transport that resolved `start()` before its first `connected` (worker-style backends report the connection asynchronously) is still handed operations directly, because its `disconnected` status means "not connected yet" rather than "a working connection was lost".
+
 ## Lifecycle State Machine
 
 `CrossTabDataBus` uses several boolean flags and promise gates to serialize lifecycle transitions. The interaction between them is the most complex part of the DataBus layer.
@@ -562,7 +564,7 @@ The built-in Centrifuge transport also retains its own Subscriptions and perform
 | `started` | `boolean` | `start()` has been called and no `stop()` has completed since |
 | `stopping` | `boolean` | `stop()` is in progress; prevents new operations |
 | `suspended` | `boolean` | Tab is hidden; transport is intentionally stopped |
-| `transportReady` | `boolean` | Transport has reported `connected` and is accepting operations |
+| `transportReady` | `boolean` | Transport opened successfully for the current session; retained through a runtime `error` so `ready()` keeps tracking the installed transport (pending operations are held by the recovery gate, not by this flag) |
 | `startPromise` | `Promise \| null` | Gate for concurrent `start()` calls; cleared after settle |
 | `stopPromise` | `Promise \| null` | Shared gate for an explicit `stop()` and any restart queued behind it |
 | `queuedStart` | `Promise \| null` | One fresh start waiting for an in-flight explicit stop to settle |
@@ -606,8 +608,10 @@ The built-in Centrifuge transport also retains its own Subscriptions and perform
 - **Stop-time lifecycle-operation rejection**: The `stopping` gate also covers `subscribe()` and `ready()`. A late `subscribe()` is reported through `onError` and returns a no-op cleanup, preventing a handler from being erased by `topicHandlers.clear()` or leaking into a later restart without its handler. `ready()` rejects instead of resolving against the stopping transport. If `start()` has already queued a restart behind the stop, `ready()` returns that queued-start promise because it is the newest lifecycle intent.
 - **Queued-restart failure retention**: A queued restart that fails during transport startup clears `started` but retains its actual error for later `ready()` calls. Without `initialConfig`, those calls reject with the startup failure instead of the generic configuration error, while an explicit `start(config)` remains a clean manual retry with a fresh failure ledger.
 - **Suspend during start**: If `pagehide` fires while `openTransport` is in flight, `suspendTransport()` sets `suspended = true` and chains a `transport.stop()` after the in-flight start. The `openTransport` catch path detects `suspended` and abandons the open without treating it as a failure.
+- **Readiness during suspend**: A suspended bus sets `suspended = true` and reuses `startPromise`/`pendingStop` for the chained `transport.stop()`, so that promise proves cleanup completed rather than readiness. `ready()` checks `suspended` after the `stopping` gate and rejects with a suspended-state error instead of returning the stop gate. `pageshow`/`reopenTransport()` and an explicit `start()` clear the flag and install a real reopen promise, so `ready()` follows the newest lifecycle intent. `getHealthSummary()` already reported `{ healthy: false, state: 'suspended' }`; rejection keeps that verdict consistent with `ready()`.
 - **Superseded open invalidation**: Every fresh start, reopen, suspend, and stop advances `lifecycleEpoch`. An open captures its epoch, ignores stale status/message/error callbacks, and neither marks the transport ready nor performs failure cleanup after a newer transition owns the lifecycle. `stop()` therefore waits for pending opens/reopens and prevents a superseded open from becoming ready after the stop completes.
 - **Recovery cooldown**: When the transport reports `error` while `started` is true and `stopping` is false, `updateStatus` schedules an automatic `reopenTransport()` after `RECOVERY_COOLDOWN_MS` (1000 ms). A second error within the cooldown window is suppressed to prevent a tight retry loop.
+- **Transport recovery gate**: Scheduling a reopen also arms a recovery gate, so `subscribe` / `publish` issued during the cooldown cannot reach the failed connection; they are released after the reopen succeeds. The gate deliberately survives a failed automatic attempt: the next explicit operation starts an immediate on-demand reopen instead of waiting for the next paced attempt, and parked operations flush behind that success. Exhausting `recovery.maxAttempts`, or superseding the wait with `stop()` / `suspendTransport()`, releases the gate so the explicit-retry path and the documented suspend-drop semantics are preserved. A runtime `error` does not clear `transportReady`, because clearing it would let caller traffic reopen the transport outside the cooldown and report readiness against a connection that is not carrying data.
 - **Stop during suspend**: `stop()` sets `stopping = true`, which prevents `suspendTransport()` from running. The cleanup awaits `startPromise` and `pendingStop` to ensure any in-flight open or stop completes before the final `transport.stop()`.
 
 ## Degradation

package/docs/roadmap.md

@@ -1,6 +1,13 @@
 # Roadmap
 
-0.20.86 is the current development line. The project is intentionally continuing through reliability-focused minor releases before a 1.0.0 stability freeze.
+0.20.87 is the current development line. The project is intentionally continuing through reliability-focused minor releases before a 1.0.0 stability freeze.
+
+## 0.20.87 delivered scope
+
+- Transport recovery/readiness hardening: the native WebSocket backend now honors the `DataBusTransport.start()` contract (resolves only after `open`, rejects on a failed handshake or `connectTimeoutMs`), automatic recovery actually creates a replacement socket after a failure, and `getHealthSummary()` follows the live transport status instead of the `transportReady` diagnostic flag.
+- No operation is written to a connection that is gone. A recovery gate parks `subscribe()` / `publish()` through automatic and on-demand reopens (including an automatic attempt that failed but left the budget open), and a clean `disconnected` after a real connection now demands exactly one on-demand reopen instead of being handed to a closed socket — while a worker-style backend that reports the connection asynchronously keeps its pre-connect window unreopened.
+- Lifecycle/`ready()` boundary fixes: `ready()` rejects while the tab is BFCache-suspended, `stop()` resolves even when the transport's own `stop()` rejects or throws, a failed open is stamped once across both recovery ledgers, runtime transport errors land in the recovery ledger, and superseded asynchronous opens can no longer tear down a newer suspend/resume transition.
+- Adapter and toolchain: React/Vue `useCrossTabHealth` apply `intervalMs` changes without recreating the bus, and `vitest` and its coverage-v8 provider moved to the 5.0.1 patch.
 
 ## 0.20.86 delivered scope
 

package/docs/transports.md

@@ -35,6 +35,12 @@ connection state changes; call `onMessage` for each inbound publication; call
 `onError` for non-fatal errors (the DataBus applies a recovery cooldown so a
 flapping connection does not retry-loop).
 
+`start()` MUST settle its returned promise only once the backend is connected,
+and reject it when the attempt fails. The DataBus uses that settlement as its
+readiness and recovery boundary: a `CONNECTING` socket is not ready, and queued
+operations must not be released until the handshake succeeds. A backend that
+can stall should enforce its own handshake timeout and reject.
+
 ## Architectural layers
 
 ```
@@ -154,10 +160,21 @@ without metadata keep their original shape. Metadata-bearing publishes use
 `{ data, messageId?, timestamp? }`, while inbound publications additionally
 accept the canonical nested `DataBusPublicationEnvelope`.
 
+`start()` resolves only after `open` and rejects when the handshake errors,
+closes before opening, or exceeds `connectTimeoutMs` (default `30000` ms; `0`
+or `Infinity` waits indefinitely). A timed-out socket is closed and a late
+`open` from that attempt is ignored.
+
 Lifecycle mapping: `open` → `connected`, `close` → `disconnected`,
 `error` → `error` (DataBus auto-recovery). Subscribe frames are re-sent when
-the socket reopens in place. A pattern-aware server may tag publications with
-the concrete topic — see wildcard subscriptions in [api.md](./api.md).
+the socket reopens in place. A successful reopen can either reuse the same
+socket object or create a replacement through the factory; callbacks from the
+superseded socket are ignored, so a late close or message from the failed
+connection cannot pollute the recovered one. A clean `disconnected` schedules no
+background recovery, but the next `subscribe()` / `publish()` demands one reopen
+and flushes behind it, so a post-close operation is never sent to the closed
+socket. A pattern-aware server may tag publications with the concrete topic —
+see wildcard subscriptions in [api.md](./api.md).
 
 ## Factory entry point