@gwakko/shared-websocket 0.3.0 → 0.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/utils/disposable.ts","../src/utils/id.ts","../src/MessageBus.ts","../src/TabCoordinator.ts","../src/utils/backoff.ts","../src/SharedSocket.ts","../src/WorkerSocket.ts","../src/SubscriptionManager.ts","../src/SharedWebSocket.ts"],"sourcesContent":["/** Polyfill Symbol.dispose if not available. */\nif (typeof Symbol.dispose === 'undefined') {\n (Symbol as any).dispose = Symbol('Symbol.dispose');\n}\n","export function generateId(): string {\n if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n return crypto.randomUUID();\n }\n return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n","import './utils/disposable';\nimport { generateId } from './utils/id';\nimport type { BusMessage, Unsubscribe } from './types';\n\ntype Listener = (msg: BusMessage) => void;\n\nexport class MessageBus implements Disposable {\n private channel: BroadcastChannel;\n private listeners = new Map<string, Set<Listener>>();\n private pendingRequests = new Map<string, { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> }>();\n\n constructor(\n channelName: string,\n private readonly tabId: string,\n ) {\n this.channel = new BroadcastChannel(channelName);\n this.channel.onmessage = (ev: MessageEvent<BusMessage>) => {\n this.handleMessage(ev.data);\n };\n }\n\n subscribe<T>(topic: string, fn: (data: T) => void): Unsubscribe {\n const wrapper: Listener = (msg) => {\n if (msg.source !== this.tabId) fn(msg.data as T);\n };\n this.addListener(topic, wrapper);\n return () => this.removeListener(topic, wrapper);\n }\n\n publish<T>(topic: string, data: T): void {\n this.postMessage({ topic, type: 'publish', data });\n }\n\n broadcast<T>(topic: string, data: T): void {\n const msg = this.createMessage(topic, 'broadcast', data);\n this.channel.postMessage(msg);\n // Also deliver to self\n this.handleMessage(msg);\n }\n\n async request<T, R>(topic: string, data: T, timeout = 5000): Promise<R> {\n const msg = this.createMessage(topic, 'request', data);\n return new Promise<R>((resolve, reject) => {\n const timer = setTimeout(() => {\n this.pendingRequests.delete(msg.id);\n reject(new Error(`MessageBus.request: timeout for topic \"${topic}\"`));\n }, timeout);\n this.pendingRequests.set(msg.id, { resolve: resolve as (v: unknown) => void, reject, timer });\n this.channel.postMessage(msg);\n });\n }\n\n respond<T, R>(topic: string, fn: (data: T) => R | Promise<R>): Unsubscribe {\n const wrapper: Listener = async (msg) => {\n if (msg.type !== 'request' || msg.source === this.tabId) return;\n const result = await fn(msg.data as T);\n this.postMessage({ topic, type: 'response', data: { requestId: msg.id, result } });\n };\n this.addListener(topic, wrapper);\n return () => this.removeListener(topic, wrapper);\n }\n\n private handleMessage(msg: BusMessage): void {\n // Handle response to pending request\n if (msg.type === 'response') {\n const payload = msg.data as { requestId: string; result: unknown };\n const pending = this.pendingRequests.get(payload.requestId);\n if (pending) {\n clearTimeout(pending.timer);\n this.pendingRequests.delete(payload.requestId);\n pending.resolve(payload.result);\n return;\n }\n }\n\n const listeners = this.listeners.get(msg.topic);\n if (listeners) {\n for (const fn of listeners) fn(msg);\n }\n }\n\n private postMessage(partial: Pick<BusMessage, 'topic' | 'type' | 'data'>): void {\n this.channel.postMessage(this.createMessage(partial.topic, partial.type, partial.data));\n }\n\n private createMessage(topic: string, type: BusMessage['type'], data: unknown): BusMessage {\n return { id: generateId(), source: this.tabId, topic, type, data, timestamp: Date.now() };\n }\n\n private addListener(topic: string, fn: Listener): void {\n let set = this.listeners.get(topic);\n if (!set) {\n set = new Set();\n this.listeners.set(topic, set);\n }\n set.add(fn);\n }\n\n private removeListener(topic: string, fn: Listener): void {\n this.listeners.get(topic)?.delete(fn);\n }\n\n [Symbol.dispose](): void {\n for (const pending of this.pendingRequests.values()) {\n clearTimeout(pending.timer);\n pending.reject(new Error('MessageBus disposed'));\n }\n this.pendingRequests.clear();\n this.listeners.clear();\n this.channel.close();\n }\n}\n","import './utils/disposable';\nimport { MessageBus } from './MessageBus';\nimport type { Unsubscribe } from './types';\n\ninterface CoordinatorOptions {\n electionTimeout?: number; // ms to wait for rejection (default 200)\n heartbeatInterval?: number; // ms between heartbeats (default 2000)\n leaderTimeout?: number; // ms without heartbeat to trigger election (default 5000)\n}\n\nexport class TabCoordinator implements Disposable {\n private _isLeader = false;\n private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n private leaderCheckTimer: ReturnType<typeof setInterval> | null = null;\n private lastHeartbeat = 0;\n private disposed = false;\n\n private onBecomeLeaderFns = new Set<() => void>();\n private onLoseLeadershipFns = new Set<() => void>();\n private cleanups: Unsubscribe[] = [];\n\n private readonly electionTimeout: number;\n private readonly heartbeatInterval: number;\n private readonly leaderTimeout: number;\n\n constructor(\n private readonly bus: MessageBus,\n private readonly tabId: string,\n options: CoordinatorOptions = {},\n ) {\n this.electionTimeout = options.electionTimeout ?? 200;\n this.heartbeatInterval = options.heartbeatInterval ?? 2000;\n this.leaderTimeout = options.leaderTimeout ?? 5000;\n\n // Listen for election requests — reject if we are leader\n this.cleanups.push(\n this.bus.subscribe<{ tabId: string }>('coord:election', () => {\n if (this._isLeader) {\n this.bus.publish('coord:reject', { tabId: this.tabId });\n }\n }),\n );\n\n // Listen for heartbeats\n this.cleanups.push(\n this.bus.subscribe<{ tabId: string }>('coord:heartbeat', () => {\n this.lastHeartbeat = Date.now();\n }),\n );\n\n // Listen for abdication\n this.cleanups.push(\n this.bus.subscribe('coord:abdicate', () => {\n if (!this._isLeader && !this.disposed) {\n this.elect();\n }\n }),\n );\n }\n\n get isLeader(): boolean {\n return this._isLeader;\n }\n\n async elect(): Promise<void> {\n if (this.disposed) return;\n\n return new Promise<void>((resolve) => {\n let rejected = false;\n\n const unsub = this.bus.subscribe('coord:reject', () => {\n rejected = true;\n unsub();\n // We are follower — start monitoring leader heartbeat\n this.startLeaderCheck();\n resolve();\n });\n\n this.bus.publish('coord:election', { tabId: this.tabId });\n\n setTimeout(() => {\n unsub();\n if (!rejected && !this.disposed) {\n this.becomeLeader();\n }\n resolve();\n }, this.electionTimeout);\n });\n }\n\n abdicate(): void {\n if (!this._isLeader) return;\n this._isLeader = false;\n this.stopHeartbeat();\n this.bus.publish('coord:abdicate', { tabId: this.tabId });\n for (const fn of this.onLoseLeadershipFns) fn();\n }\n\n onBecomeLeader(fn: () => void): Unsubscribe {\n this.onBecomeLeaderFns.add(fn);\n return () => this.onBecomeLeaderFns.delete(fn);\n }\n\n onLoseLeadership(fn: () => void): Unsubscribe {\n this.onLoseLeadershipFns.add(fn);\n return () => this.onLoseLeadershipFns.delete(fn);\n }\n\n private becomeLeader(): void {\n this._isLeader = true;\n this.stopLeaderCheck();\n this.startHeartbeat();\n for (const fn of this.onBecomeLeaderFns) fn();\n }\n\n private startHeartbeat(): void {\n this.stopHeartbeat();\n this.heartbeatTimer = setInterval(() => {\n this.bus.publish('coord:heartbeat', { tabId: this.tabId });\n }, this.heartbeatInterval);\n // Send immediately\n this.bus.publish('coord:heartbeat', { tabId: this.tabId });\n }\n\n private stopHeartbeat(): void {\n if (this.heartbeatTimer) {\n clearInterval(this.heartbeatTimer);\n this.heartbeatTimer = null;\n }\n }\n\n private startLeaderCheck(): void {\n this.stopLeaderCheck();\n this.lastHeartbeat = Date.now();\n this.leaderCheckTimer = setInterval(() => {\n if (Date.now() - this.lastHeartbeat > this.leaderTimeout && !this.disposed) {\n this.stopLeaderCheck();\n this.elect();\n }\n }, 1000);\n }\n\n private stopLeaderCheck(): void {\n if (this.leaderCheckTimer) {\n clearInterval(this.leaderCheckTimer);\n this.leaderCheckTimer = null;\n }\n }\n\n [Symbol.dispose](): void {\n this.disposed = true;\n if (this._isLeader) {\n this.abdicate();\n }\n this.stopHeartbeat();\n this.stopLeaderCheck();\n for (const unsub of this.cleanups) unsub();\n this.cleanups = [];\n this.onBecomeLeaderFns.clear();\n this.onLoseLeadershipFns.clear();\n }\n}\n","/** Exponential backoff generator with jitter. */\nexport function* backoff(base = 1000, max = 30_000): Generator<number> {\n let delay = base;\n while (true) {\n const jitter = delay * 0.25 * (Math.random() * 2 - 1);\n yield Math.min(delay + jitter, max);\n delay = Math.min(delay * 2, max);\n }\n}\n","import './utils/disposable';\nimport { backoff } from './utils/backoff';\nimport type { SocketState, Unsubscribe, EventHandler } from './types';\n\ninterface SharedSocketOptions {\n protocols?: string[];\n reconnect?: boolean;\n reconnectMaxDelay?: number;\n heartbeatInterval?: number;\n sendBuffer?: number;\n auth?: () => string | Promise<string>;\n authToken?: string;\n authParam?: string;\n /** Heartbeat payload (default: { type: \"ping\" }). */\n pingPayload?: unknown;\n}\n\nexport class SharedSocket implements Disposable {\n private ws: WebSocket | null = null;\n private _state: SocketState = 'closed';\n private buffer: unknown[] = [];\n private disposed = false;\n private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n\n private onMessageFns = new Set<EventHandler>();\n private onStateChangeFns = new Set<(state: SocketState) => void>();\n\n private readonly opts: Required<Omit<SharedSocketOptions, 'auth' | 'authToken' | 'authParam' | 'pingPayload'>> & {\n auth?: () => string | Promise<string>;\n authToken?: string;\n authParam: string;\n pingPayload: unknown;\n };\n\n constructor(\n private url: string,\n options: SharedSocketOptions = {},\n ) {\n this.opts = {\n protocols: options.protocols ?? [],\n reconnect: options.reconnect ?? true,\n reconnectMaxDelay: options.reconnectMaxDelay ?? 30_000,\n heartbeatInterval: options.heartbeatInterval ?? 30_000,\n sendBuffer: options.sendBuffer ?? 100,\n auth: options.auth,\n authToken: options.authToken,\n authParam: options.authParam ?? 'token',\n pingPayload: options.pingPayload ?? { type: 'ping' },\n };\n }\n\n get state(): SocketState {\n return this._state;\n }\n\n async connect(): Promise<void> {\n if (this.disposed) return;\n\n this.setState('connecting');\n\n const connectUrl = await this.buildUrl();\n this.ws = new WebSocket(connectUrl, this.opts.protocols);\n\n this.ws.onopen = () => {\n this.setState('connected');\n this.flushBuffer();\n this.startHeartbeat();\n };\n\n this.ws.onmessage = (ev: MessageEvent) => {\n let data: unknown;\n try {\n data = JSON.parse(ev.data as string);\n } catch {\n data = ev.data;\n }\n for (const fn of this.onMessageFns) fn(data);\n };\n\n this.ws.onclose = () => {\n this.stopHeartbeat();\n if (!this.disposed && this.opts.reconnect) {\n this.reconnect();\n } else {\n this.setState('closed');\n }\n };\n\n this.ws.onerror = () => {\n // onclose will fire after onerror\n };\n }\n\n disconnect(): void {\n this.disposed = true;\n this.stopHeartbeat();\n this.clearReconnect();\n\n if (this.ws) {\n this.ws.onclose = null;\n this.ws.onmessage = null;\n this.ws.onerror = null;\n if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {\n this.ws.close(1000, 'client disconnect');\n }\n this.ws = null;\n }\n\n this.setState('closed');\n }\n\n send(data: unknown): void {\n if (this._state === 'connected' && this.ws?.readyState === WebSocket.OPEN) {\n this.ws.send(JSON.stringify(data));\n } else if (this._state === 'reconnecting' || this._state === 'connecting') {\n if (this.buffer.length < this.opts.sendBuffer) {\n this.buffer.push(data);\n }\n }\n }\n\n onMessage(fn: EventHandler): Unsubscribe {\n this.onMessageFns.add(fn);\n return () => this.onMessageFns.delete(fn);\n }\n\n onStateChange(fn: (state: SocketState) => void): Unsubscribe {\n this.onStateChangeFns.add(fn);\n return () => this.onStateChangeFns.delete(fn);\n }\n\n private reconnect(): void {\n this.setState('reconnecting');\n const gen = backoff(1000, this.opts.reconnectMaxDelay);\n\n const attempt = () => {\n if (this.disposed) return;\n const delay = gen.next().value;\n this.reconnectTimer = setTimeout(() => {\n if (!this.disposed) this.connect();\n }, delay);\n };\n\n attempt();\n }\n\n private flushBuffer(): void {\n const pending = this.buffer.splice(0);\n for (const item of pending) {\n this.send(item);\n }\n }\n\n private startHeartbeat(): void {\n this.stopHeartbeat();\n this.heartbeatTimer = setInterval(() => {\n if (this.ws?.readyState === WebSocket.OPEN) {\n this.ws.send(JSON.stringify(this.opts.pingPayload));\n }\n }, this.opts.heartbeatInterval);\n }\n\n private stopHeartbeat(): void {\n if (this.heartbeatTimer) {\n clearInterval(this.heartbeatTimer);\n this.heartbeatTimer = null;\n }\n }\n\n private clearReconnect(): void {\n if (this.reconnectTimer) {\n clearTimeout(this.reconnectTimer);\n this.reconnectTimer = null;\n }\n }\n\n private async buildUrl(): Promise<string> {\n // Resolve token: callback > static > none\n let token: string | undefined;\n if (this.opts.auth) {\n token = await this.opts.auth();\n } else if (this.opts.authToken) {\n token = this.opts.authToken;\n }\n\n if (!token) return this.url;\n\n // WebSocket URLs (ws://, wss://) are not fully supported by URL API.\n // Convert to http(s) for parsing, then back to ws(s).\n const httpUrl = this.url.replace(/^ws(s?):\\/\\//, 'http$1://');\n const parsed = new URL(httpUrl);\n parsed.searchParams.set(this.opts.authParam, token);\n\n return parsed.toString().replace(/^http(s?):\\/\\//, 'ws$1://');\n }\n\n private setState(state: SocketState): void {\n this._state = state;\n for (const fn of this.onStateChangeFns) fn(state);\n }\n\n [Symbol.dispose](): void {\n this.disconnect();\n this.onMessageFns.clear();\n this.onStateChangeFns.clear();\n this.buffer = [];\n }\n}\n","import './utils/disposable';\nimport type { SocketState, Unsubscribe, EventHandler } from './types';\n\n/**\n * WorkerSocket — WebSocket running inside a Web Worker.\n *\n * Same interface as SharedSocket, but WebSocket lives off main thread.\n * Benefits: heartbeat timers and JSON parsing don't block UI rendering.\n *\n * Use when:\n * - High message rate (50+ msgs/sec)\n * - Heavy JSON payloads\n * - UI does complex rendering that could block main thread\n *\n * Don't use when:\n * - Low message rate (simple chat, notifications)\n * - Bundle size matters (adds worker file)\n * - Debugging (Worker DevTools is less convenient)\n */\nexport class WorkerSocket implements Disposable {\n private worker: Worker | null = null;\n private _state: SocketState = 'closed';\n\n private onMessageFns = new Set<EventHandler>();\n private onStateChangeFns = new Set<(state: SocketState) => void>();\n\n constructor(\n private url: string,\n private options: {\n protocols?: string[];\n reconnect?: boolean;\n reconnectMaxDelay?: number;\n heartbeatInterval?: number;\n sendBuffer?: number;\n workerUrl?: string | URL;\n } = {},\n ) {}\n\n get state(): SocketState {\n return this._state;\n }\n\n connect(): void {\n // Create worker from inline blob if no workerUrl provided\n const workerUrl = this.options.workerUrl ?? this.createWorkerBlob();\n\n this.worker = new Worker(workerUrl, { type: 'module' });\n\n this.worker.onmessage = (ev: MessageEvent) => {\n const msg = ev.data;\n\n switch (msg.type) {\n case 'state':\n this._state = msg.state;\n for (const fn of this.onStateChangeFns) fn(msg.state);\n break;\n\n case 'message':\n for (const fn of this.onMessageFns) fn(msg.data);\n break;\n\n case 'open':\n // State already set via 'state' message\n break;\n\n case 'close':\n break;\n\n case 'error':\n console.error('WorkerSocket error:', msg.message);\n break;\n }\n };\n\n this.worker.postMessage({\n type: 'connect',\n url: this.url,\n protocols: this.options.protocols ?? [],\n reconnect: this.options.reconnect ?? true,\n reconnectMaxDelay: this.options.reconnectMaxDelay ?? 30_000,\n heartbeatInterval: this.options.heartbeatInterval ?? 30_000,\n bufferSize: this.options.sendBuffer ?? 100,\n });\n }\n\n send(data: unknown): void {\n this.worker?.postMessage({ type: 'send', data });\n }\n\n disconnect(): void {\n this.worker?.postMessage({ type: 'disconnect' });\n setTimeout(() => {\n this.worker?.terminate();\n this.worker = null;\n }, 100);\n this._state = 'closed';\n }\n\n onMessage(fn: EventHandler): Unsubscribe {\n this.onMessageFns.add(fn);\n return () => this.onMessageFns.delete(fn);\n }\n\n onStateChange(fn: (state: SocketState) => void): Unsubscribe {\n this.onStateChangeFns.add(fn);\n return () => this.onStateChangeFns.delete(fn);\n }\n\n private createWorkerBlob(): URL {\n // Inline the worker code as a blob URL\n // In production, use a bundler (Vite, webpack) to handle worker imports\n const code = `\n let ws = null, state = 'closed', buffer = [], disposed = false;\n let heartbeatTimer = null, reconnectTimer = null;\n let url = '', protocols = [], shouldReconnect = true;\n let maxDelay = 30000, hbInterval = 30000, maxBuf = 100, delay = 1000;\n\n function setState(s) { state = s; self.postMessage({ type: 'state', state: s }); }\n function connect() {\n if (disposed) return;\n setState('connecting');\n ws = new WebSocket(url, protocols);\n ws.onopen = () => { setState('connected'); delay = 1000; self.postMessage({ type: 'open' }); flush(); startHB(); };\n ws.onmessage = (e) => { let d; try { d = JSON.parse(e.data); } catch { d = e.data; } self.postMessage({ type: 'message', data: d }); };\n ws.onclose = (e) => { stopHB(); self.postMessage({ type: 'close', code: e.code, reason: e.reason }); if (!disposed && shouldReconnect && e.code !== 1000) reconnect(); else setState('closed'); };\n ws.onerror = () => { self.postMessage({ type: 'error', message: 'error' }); };\n }\n function send(d) { if (state === 'connected' && ws?.readyState === 1) ws.send(JSON.stringify(d)); else if (buffer.length < maxBuf) buffer.push(d); }\n function flush() { const p = buffer.splice(0); p.forEach(send); }\n function startHB() { stopHB(); heartbeatTimer = setInterval(() => { if (ws?.readyState === 1) ws.send('{\"type\":\"ping\"}'); }, hbInterval); }\n function stopHB() { if (heartbeatTimer) { clearInterval(heartbeatTimer); heartbeatTimer = null; } }\n function reconnect() { setState('reconnecting'); const j = delay * 0.25 * (Math.random() * 2 - 1); reconnectTimer = setTimeout(() => { if (!disposed) connect(); }, Math.min(delay + j, maxDelay)); delay = Math.min(delay * 2, maxDelay); }\n self.onmessage = (e) => {\n const c = e.data;\n if (c.type === 'connect') { url = c.url; protocols = c.protocols || []; shouldReconnect = c.reconnect ?? true; maxDelay = c.reconnectMaxDelay || 30000; hbInterval = c.heartbeatInterval || 30000; maxBuf = c.bufferSize || 100; connect(); }\n if (c.type === 'send') send(c.data);\n if (c.type === 'disconnect') { disposed = true; stopHB(); if (reconnectTimer) clearTimeout(reconnectTimer); if (ws) { ws.onclose = null; if (ws.readyState < 2) ws.close(1000); ws = null; } buffer = []; setState('closed'); }\n };\n `;\n const blob = new Blob([code], { type: 'application/javascript' });\n return new URL(URL.createObjectURL(blob));\n }\n\n [Symbol.dispose](): void {\n this.disconnect();\n this.onMessageFns.clear();\n this.onStateChangeFns.clear();\n }\n}\n","import './utils/disposable';\nimport type { EventHandler, Unsubscribe } from './types';\n\nexport class SubscriptionManager implements Disposable {\n private handlers = new Map<string, Set<EventHandler>>();\n private lastMessages = new Map<string, unknown>();\n\n on(event: string, handler: EventHandler): Unsubscribe {\n let set = this.handlers.get(event);\n if (!set) {\n set = new Set();\n this.handlers.set(event, set);\n }\n set.add(handler);\n return () => set!.delete(handler);\n }\n\n once(event: string, handler: EventHandler): Unsubscribe {\n const wrapper: EventHandler = (data) => {\n unsub();\n handler(data);\n };\n const unsub = this.on(event, wrapper);\n return unsub;\n }\n\n off(event: string, handler?: EventHandler): void {\n if (handler) {\n this.handlers.get(event)?.delete(handler);\n } else {\n this.handlers.delete(event);\n }\n }\n\n emit(event: string, data: unknown): void {\n this.lastMessages.set(event, data);\n const set = this.handlers.get(event);\n if (set) {\n for (const fn of set) fn(data);\n }\n }\n\n getLastMessage(event: string): unknown | undefined {\n return this.lastMessages.get(event);\n }\n\n async *stream(event: string, signal?: AbortSignal): AsyncGenerator<unknown> {\n const queue: unknown[] = [];\n let resolve: (() => void) | null = null;\n let done = false;\n\n const unsub = this.on(event, (data) => {\n queue.push(data);\n resolve?.();\n });\n\n const onAbort = () => {\n done = true;\n resolve?.();\n };\n signal?.addEventListener('abort', onAbort);\n\n try {\n while (!done) {\n if (queue.length > 0) {\n yield queue.shift()!;\n } else {\n await new Promise<void>((r) => { resolve = r; });\n resolve = null;\n }\n }\n } finally {\n unsub();\n signal?.removeEventListener('abort', onAbort);\n }\n }\n\n offAll(): void {\n this.handlers.clear();\n this.lastMessages.clear();\n }\n\n [Symbol.dispose](): void {\n this.offAll();\n }\n}\n","import './utils/disposable';\nimport { generateId } from './utils/id';\nimport { MessageBus } from './MessageBus';\nimport { TabCoordinator } from './TabCoordinator';\nimport { SharedSocket } from './SharedSocket';\nimport { WorkerSocket } from './WorkerSocket';\nimport { SubscriptionManager } from './SubscriptionManager';\nimport type { SharedWebSocketOptions, TabRole, Unsubscribe, EventHandler, Channel, EventProtocol, EventMap, Logger, Middleware } from './types';\n\nconst DEFAULT_PROTOCOL: EventProtocol = {\n eventField: 'event',\n dataField: 'data',\n channelJoin: '$channel:join',\n channelLeave: '$channel:leave',\n ping: { type: 'ping' },\n defaultEvent: 'message',\n};\n\nconst NOOP_LOGGER: Logger = {\n debug() {},\n info() {},\n warn() {},\n error() {},\n};\n\n/** Common interface for both SharedSocket and WorkerSocket. */\ninterface SocketAdapter {\n readonly state: string;\n connect(): void;\n send(data: unknown): void;\n disconnect(): void;\n onMessage(fn: EventHandler): Unsubscribe;\n onStateChange(fn: (state: string) => void): Unsubscribe;\n [Symbol.dispose](): void;\n}\n\n/**\n * SharedWebSocket — shares ONE WebSocket connection across browser tabs.\n *\n * @typeParam TEvents - Event map for type-safe subscriptions.\n *\n * @example\n * // Typed events\n * type Events = {\n * 'chat.message': { text: string; userId: string };\n * 'order.created': { id: string; total: number };\n * };\n * const ws = new SharedWebSocket<Events>(url);\n * ws.on('chat.message', (msg) => msg.text); // ← msg: { text, userId }\n */\nexport class SharedWebSocket<TEvents extends EventMap = EventMap> implements Disposable {\n private bus: MessageBus;\n private coordinator: TabCoordinator;\n private socket: SocketAdapter | null = null;\n private subs = new SubscriptionManager();\n private syncStore = new Map<string, unknown>();\n private tabId: string;\n private cleanups: Unsubscribe[] = [];\n private disposed = false;\n private readonly proto: EventProtocol;\n private readonly log: Logger;\n private outgoingMiddleware: Middleware[] = [];\n private incomingMiddleware: Middleware[] = [];\n\n constructor(\n private readonly url: string,\n private readonly options: SharedWebSocketOptions<TEvents> = {} as SharedWebSocketOptions<TEvents>,\n ) {\n this.proto = { ...DEFAULT_PROTOCOL, ...options.events };\n this.log = options.debug ? (options.logger ?? console) : NOOP_LOGGER;\n this.tabId = generateId();\n this.log.debug('[SharedWS] init', { tabId: this.tabId, url });\n this.bus = new MessageBus('shared-ws', this.tabId);\n this.coordinator = new TabCoordinator(this.bus, this.tabId, {\n electionTimeout: options.electionTimeout,\n heartbeatInterval: options.leaderHeartbeat,\n leaderTimeout: options.leaderTimeout,\n });\n\n // When ANY tab receives a WS message via bus → emit to local subscribers\n this.cleanups.push(\n this.bus.subscribe<{ event: string; data: unknown }>('ws:message', (msg) => {\n this.subs.emit(msg.event, msg.data);\n }),\n );\n\n // Leader listens for send requests from followers\n this.cleanups.push(\n this.bus.subscribe<{ event: string; data: unknown }>('ws:send', (msg) => {\n if (this.coordinator.isLeader && this.socket) {\n this.socket.send({ [this.proto.eventField]: msg.event, [this.proto.dataField]: msg.data });\n }\n }),\n );\n\n // Sync across tabs\n this.cleanups.push(\n this.bus.subscribe<{ key: string; value: unknown }>('ws:sync', (msg) => {\n this.syncStore.set(msg.key, msg.value);\n this.subs.emit(`sync:${msg.key}`, msg.value);\n }),\n );\n\n // Leader lifecycle\n this.coordinator.onBecomeLeader(() => {\n this.handleBecomeLeader();\n this.bus.broadcast('ws:lifecycle', { type: 'leader', isLeader: true });\n });\n this.coordinator.onLoseLeadership(() => {\n this.handleLoseLeadership();\n this.bus.broadcast('ws:lifecycle', { type: 'leader', isLeader: false });\n });\n\n // Lifecycle events from bus (all tabs receive)\n this.cleanups.push(\n this.bus.subscribe<{ type: string; isLeader?: boolean; error?: unknown }>('ws:lifecycle', (msg) => {\n switch (msg.type) {\n case 'connect':\n this.subs.emit('$lifecycle:connect', undefined);\n break;\n case 'disconnect':\n this.subs.emit('$lifecycle:disconnect', undefined);\n break;\n case 'reconnecting':\n this.subs.emit('$lifecycle:reconnecting', undefined);\n break;\n case 'leader':\n this.subs.emit('$lifecycle:leader', msg.isLeader);\n break;\n case 'error':\n this.subs.emit('$lifecycle:error', msg.error);\n break;\n }\n }),\n );\n\n // Cleanup on tab close\n if (typeof window !== 'undefined') {\n const onBeforeUnload = () => this[Symbol.dispose]();\n window.addEventListener('beforeunload', onBeforeUnload);\n this.cleanups.push(() => window.removeEventListener('beforeunload', onBeforeUnload));\n }\n }\n\n get connected(): boolean {\n return this.socket?.state === 'connected' || !this.coordinator.isLeader;\n }\n\n get tabRole(): TabRole {\n return this.coordinator.isLeader ? 'leader' : 'follower';\n }\n\n /** Start leader election and connect. */\n async connect(): Promise<void> {\n await this.coordinator.elect();\n }\n\n // ─── Lifecycle Hooks ─────────────────────────────────\n\n /** Called when WebSocket connection opens (broadcast to all tabs). */\n onConnect(fn: () => void): Unsubscribe {\n return this.subs.on('$lifecycle:connect', fn);\n }\n\n /** Called when WebSocket connection closes (broadcast to all tabs). */\n onDisconnect(fn: () => void): Unsubscribe {\n return this.subs.on('$lifecycle:disconnect', fn);\n }\n\n /** Called when WebSocket starts reconnecting (broadcast to all tabs). */\n onReconnecting(fn: () => void): Unsubscribe {\n return this.subs.on('$lifecycle:reconnecting', fn);\n }\n\n /** Called when this tab becomes leader or loses leadership. */\n onLeaderChange(fn: (isLeader: boolean) => void): Unsubscribe {\n return this.subs.on('$lifecycle:leader', fn as EventHandler);\n }\n\n /** Called on WebSocket or network error (broadcast to all tabs). */\n onError(fn: (error: unknown) => void): Unsubscribe {\n return this.subs.on('$lifecycle:error', fn as EventHandler);\n }\n\n // ─── Middleware ───────────────────────────────────────\n\n /**\n * Add middleware to transform messages before send or after receive.\n * Return null from middleware to drop the message.\n *\n * @example\n * // Add timestamp to every outgoing message\n * ws.use('outgoing', (msg) => ({ ...msg, timestamp: Date.now() }));\n *\n * @example\n * // Decrypt incoming messages\n * ws.use('incoming', (msg) => ({ ...msg, data: decrypt(msg.data) }));\n *\n * @example\n * // Drop messages from blocked users\n * ws.use('incoming', (msg) => blockedUsers.has(msg.userId) ? null : msg);\n */\n use(direction: 'outgoing' | 'incoming', fn: Middleware): this {\n if (direction === 'outgoing') {\n this.outgoingMiddleware.push(fn);\n } else {\n this.incomingMiddleware.push(fn);\n }\n return this;\n }\n\n // ─── Event Subscription ──────────────────────────────\n\n /** Subscribe to server events (works in ALL tabs). Type-safe with EventMap. */\n on<K extends string & keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): Unsubscribe;\n on(event: string, handler: EventHandler<unknown>): Unsubscribe;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n on(event: string, handler: (data: any) => void): Unsubscribe {\n return this.subs.on(event, handler);\n }\n\n once<K extends string & keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): Unsubscribe;\n once(event: string, handler: EventHandler<unknown>): Unsubscribe;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n once(event: string, handler: (data: any) => void): Unsubscribe {\n return this.subs.once(event, handler);\n }\n\n off(event: string, handler?: EventHandler): void {\n this.subs.off(event, handler);\n }\n\n /** Async generator for consuming events. Type-safe with EventMap. */\n stream<K extends string & keyof TEvents>(event: K, signal?: AbortSignal): AsyncGenerator<TEvents[K]>;\n stream(event: string, signal?: AbortSignal): AsyncGenerator<unknown>;\n stream(event: string, signal?: AbortSignal): AsyncGenerator<unknown> {\n return this.subs.stream(event, signal);\n }\n\n /** Send message to server (auto-routed through leader). Type-safe with EventMap. */\n send<K extends string & keyof TEvents>(event: K, data: TEvents[K]): void;\n send(event: string, data: unknown): void;\n send(event: string, data: unknown): void {\n let payload: unknown = { [this.proto.eventField]: event, [this.proto.dataField]: data };\n\n for (const mw of this.outgoingMiddleware) {\n payload = mw(payload);\n if (payload === null) {\n this.log.debug('[SharedWS] ✗ outgoing dropped by middleware', event);\n return;\n }\n }\n\n this.log.debug('[SharedWS] → send', event, data);\n\n if (this.coordinator.isLeader && this.socket) {\n this.socket.send(payload);\n } else {\n this.bus.publish('ws:send', { event, data });\n }\n }\n\n /** Request/response through server via leader. */\n async request<T>(event: string, data: unknown, timeout = 5000): Promise<T> {\n return this.bus.request('ws:request', { event, data }, timeout);\n }\n\n /** Sync state across tabs (no server roundtrip). */\n sync<T>(key: string, value: T): void {\n this.syncStore.set(key, value);\n this.bus.broadcast('ws:sync', { key, value });\n }\n\n getSync<T>(key: string): T | undefined {\n return this.syncStore.get(key) as T | undefined;\n }\n\n onSync<T>(key: string, fn: (value: T) => void): Unsubscribe {\n return this.subs.on(`sync:${key}`, fn as EventHandler);\n }\n\n /**\n * Subscribe to a private/scoped channel. Returns a channel handle with\n * scoped on/send/stream methods. Sends join on subscribe, leave on unsubscribe.\n *\n * @example\n * const chat = ws.channel('chat:room_123');\n * chat.on('message', (msg) => render(msg));\n * chat.send('message', { text: 'Hello' });\n * chat.leave(); // sends leave + unsubscribes\n *\n * @example\n * // Private notifications for tenant\n * const notifications = ws.channel(`tenant:${tenantId}:notifications`);\n * notifications.on('alert', (alert) => showToast(alert));\n */\n channel(name: string): Channel {\n // Notify server about channel subscription\n this.send(this.proto.channelJoin, { channel: name });\n\n const self = this;\n const unsubs: Unsubscribe[] = [];\n\n return {\n name,\n on(event: string, handler: EventHandler): Unsubscribe {\n const unsub = self.subs.on(`${name}:${event}`, handler);\n unsubs.push(unsub);\n return unsub;\n },\n once(event: string, handler: EventHandler): Unsubscribe {\n const unsub = self.subs.once(`${name}:${event}`, handler);\n unsubs.push(unsub);\n return unsub;\n },\n send(event: string, data: unknown): void {\n self.send(`${name}:${event}`, data);\n },\n stream(event: string, signal?: AbortSignal): AsyncGenerator<unknown> {\n return self.subs.stream(`${name}:${event}`, signal);\n },\n leave(): void {\n self.send(self.proto.channelLeave, { channel: name });\n for (const unsub of unsubs) unsub();\n unsubs.length = 0;\n },\n };\n }\n\n disconnect(): void {\n this[Symbol.dispose]();\n }\n\n private createSocket(): SocketAdapter {\n const socketOptions = {\n protocols: this.options.protocols,\n reconnect: this.options.reconnect,\n reconnectMaxDelay: this.options.reconnectMaxDelay,\n heartbeatInterval: this.options.heartbeatInterval,\n sendBuffer: this.options.sendBuffer,\n pingPayload: this.proto.ping,\n };\n\n if (this.options.useWorker) {\n // WebSocket runs in a Web Worker — main thread stays free\n return new WorkerSocket(this.url, {\n ...socketOptions,\n workerUrl: this.options.workerUrl,\n });\n }\n\n // WebSocket runs in main thread (default)\n return new SharedSocket(this.url, {\n ...socketOptions,\n auth: this.options.auth,\n authToken: this.options.authToken,\n authParam: this.options.authParam,\n });\n }\n\n private handleBecomeLeader(): void {\n this.log.info('[SharedWS] 👑 became leader');\n this.socket = this.createSocket();\n\n this.socket.onMessage((raw: unknown) => {\n let data: unknown = raw;\n for (const mw of this.incomingMiddleware) {\n data = mw(data);\n if (data === null) {\n this.log.debug('[SharedWS] ✗ incoming dropped by middleware');\n return;\n }\n }\n\n const msg = data as Record<string, unknown> | null | undefined;\n const event = (msg?.[this.proto.eventField] as string) ?? this.proto.defaultEvent;\n const payload = msg?.[this.proto.dataField] ?? data;\n this.log.debug('[SharedWS] ← recv', event, payload);\n this.bus.broadcast('ws:message', { event, data: payload });\n });\n\n this.socket.onStateChange((state: string) => {\n this.log.info('[SharedWS]', state === 'connected' ? '✓ connected' : state === 'reconnecting' ? '🔄 reconnecting' : `state: ${state}`);\n switch (state) {\n case 'connected':\n this.bus.broadcast('ws:lifecycle', { type: 'connect' });\n break;\n case 'closed':\n this.bus.broadcast('ws:lifecycle', { type: 'disconnect' });\n break;\n case 'reconnecting':\n this.bus.broadcast('ws:lifecycle', { type: 'reconnecting' });\n break;\n }\n });\n\n this.cleanups.push(\n this.bus.respond<{ event: string; data: unknown }, unknown>('ws:request', async (req) => {\n return new Promise((resolve) => {\n const unsub = this.socket!.onMessage((response: unknown) => {\n const res = response as Record<string, unknown> | undefined;\n if (res?.[this.proto.eventField] === req.event || res?.requestId) {\n unsub();\n resolve(res?.[this.proto.dataField] ?? response);\n }\n });\n this.socket!.send({ event: req.event, data: req.data });\n });\n }),\n );\n\n this.socket.connect();\n }\n\n private handleLoseLeadership(): void {\n if (this.socket) {\n this.socket[Symbol.dispose]();\n this.socket = null;\n }\n }\n\n [Symbol.dispose](): void {\n if (this.disposed) return;\n this.disposed = true;\n\n this.coordinator[Symbol.dispose]();\n\n if (this.socket) {\n this.socket[Symbol.dispose]();\n this.socket = null;\n }\n\n for (const unsub of this.cleanups) unsub();\n this.cleanups = [];\n this.subs[Symbol.dispose]();\n this.bus[Symbol.dispose]();\n this.syncStore.clear();\n }\n}\n"],"mappings":"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","names":[]}
@@ -253,7 +253,8 @@ var SharedSocket = (_class3 = class {
253
253
  sendBuffer: _nullishCoalesce(options.sendBuffer, () => ( 100)),
254
254
  auth: options.auth,
255
255
  authToken: options.authToken,
256
- authParam: _nullishCoalesce(options.authParam, () => ( "token"))
256
+ authParam: _nullishCoalesce(options.authParam, () => ( "token")),
257
+ pingPayload: _nullishCoalesce(options.pingPayload, () => ( { type: "ping" }))
257
258
  };
258
259
  }
259
260
 
@@ -353,7 +354,7 @@ var SharedSocket = (_class3 = class {
353
354
  this.stopHeartbeat();
354
355
  this.heartbeatTimer = setInterval(() => {
355
356
  if (_optionalChain([this, 'access', _8 => _8.ws, 'optionalAccess', _9 => _9.readyState]) === WebSocket.OPEN) {
356
- this.ws.send(JSON.stringify({ type: "ping" }));
357
+ this.ws.send(JSON.stringify(this.opts.pingPayload));
357
358
  }
358
359
  }, this.opts.heartbeatInterval);
359
360
  }
@@ -576,11 +577,32 @@ var SubscriptionManager = (_class5 = class {constructor() { _class5.prototype.__
576
577
  }, _class5);
577
578
 
578
579
  // src/SharedWebSocket.ts
580
+ var DEFAULT_PROTOCOL = {
581
+ eventField: "event",
582
+ dataField: "data",
583
+ channelJoin: "$channel:join",
584
+ channelLeave: "$channel:leave",
585
+ ping: { type: "ping" },
586
+ defaultEvent: "message"
587
+ };
588
+ var NOOP_LOGGER = {
589
+ debug() {
590
+ },
591
+ info() {
592
+ },
593
+ warn() {
594
+ },
595
+ error() {
596
+ }
597
+ };
579
598
  var SharedWebSocket = (_class6 = class {
580
- constructor(url, options = {}) {;_class6.prototype.__init25.call(this);_class6.prototype.__init26.call(this);_class6.prototype.__init27.call(this);_class6.prototype.__init28.call(this);_class6.prototype.__init29.call(this);
599
+ constructor(url, options = {}) {;_class6.prototype.__init25.call(this);_class6.prototype.__init26.call(this);_class6.prototype.__init27.call(this);_class6.prototype.__init28.call(this);_class6.prototype.__init29.call(this);_class6.prototype.__init30.call(this);_class6.prototype.__init31.call(this);
581
600
  this.url = url;
582
601
  this.options = options;
602
+ this.proto = { ...DEFAULT_PROTOCOL, ...options.events };
603
+ this.log = options.debug ? _nullishCoalesce(options.logger, () => ( console)) : NOOP_LOGGER;
583
604
  this.tabId = generateId();
605
+ this.log.debug("[SharedWS] init", { tabId: this.tabId, url });
584
606
  this.bus = new MessageBus("shared-ws", this.tabId);
585
607
  this.coordinator = new TabCoordinator(this.bus, this.tabId, {
586
608
  electionTimeout: options.electionTimeout,
@@ -595,7 +617,7 @@ var SharedWebSocket = (_class6 = class {
595
617
  this.cleanups.push(
596
618
  this.bus.subscribe("ws:send", (msg) => {
597
619
  if (this.coordinator.isLeader && this.socket) {
598
- this.socket.send({ event: msg.event, data: msg.data });
620
+ this.socket.send({ [this.proto.eventField]: msg.event, [this.proto.dataField]: msg.data });
599
621
  }
600
622
  })
601
623
  );
@@ -605,8 +627,35 @@ var SharedWebSocket = (_class6 = class {
605
627
  this.subs.emit(`sync:${msg.key}`, msg.value);
606
628
  })
607
629
  );
608
- this.coordinator.onBecomeLeader(() => this.onBecomeLeader());
609
- this.coordinator.onLoseLeadership(() => this.onLoseLeadership());
630
+ this.coordinator.onBecomeLeader(() => {
631
+ this.handleBecomeLeader();
632
+ this.bus.broadcast("ws:lifecycle", { type: "leader", isLeader: true });
633
+ });
634
+ this.coordinator.onLoseLeadership(() => {
635
+ this.handleLoseLeadership();
636
+ this.bus.broadcast("ws:lifecycle", { type: "leader", isLeader: false });
637
+ });
638
+ this.cleanups.push(
639
+ this.bus.subscribe("ws:lifecycle", (msg) => {
640
+ switch (msg.type) {
641
+ case "connect":
642
+ this.subs.emit("$lifecycle:connect", void 0);
643
+ break;
644
+ case "disconnect":
645
+ this.subs.emit("$lifecycle:disconnect", void 0);
646
+ break;
647
+ case "reconnecting":
648
+ this.subs.emit("$lifecycle:reconnecting", void 0);
649
+ break;
650
+ case "leader":
651
+ this.subs.emit("$lifecycle:leader", msg.isLeader);
652
+ break;
653
+ case "error":
654
+ this.subs.emit("$lifecycle:error", msg.error);
655
+ break;
656
+ }
657
+ })
658
+ );
610
659
  if (typeof window !== "undefined") {
611
660
  const onBeforeUnload = () => this[Symbol.dispose]();
612
661
  window.addEventListener("beforeunload", onBeforeUnload);
@@ -623,6 +672,10 @@ var SharedWebSocket = (_class6 = class {
623
672
 
624
673
  __init28() {this.cleanups = []}
625
674
  __init29() {this.disposed = false}
675
+
676
+
677
+ __init30() {this.outgoingMiddleware = []}
678
+ __init31() {this.incomingMiddleware = []}
626
679
  get connected() {
627
680
  return _optionalChain([this, 'access', _30 => _30.socket, 'optionalAccess', _31 => _31.state]) === "connected" || !this.coordinator.isLeader;
628
681
  }
@@ -633,24 +686,78 @@ var SharedWebSocket = (_class6 = class {
633
686
  async connect() {
634
687
  await this.coordinator.elect();
635
688
  }
636
- /** Subscribe to server events (works in ALL tabs). */
689
+ // ─── Lifecycle Hooks ─────────────────────────────────
690
+ /** Called when WebSocket connection opens (broadcast to all tabs). */
691
+ onConnect(fn) {
692
+ return this.subs.on("$lifecycle:connect", fn);
693
+ }
694
+ /** Called when WebSocket connection closes (broadcast to all tabs). */
695
+ onDisconnect(fn) {
696
+ return this.subs.on("$lifecycle:disconnect", fn);
697
+ }
698
+ /** Called when WebSocket starts reconnecting (broadcast to all tabs). */
699
+ onReconnecting(fn) {
700
+ return this.subs.on("$lifecycle:reconnecting", fn);
701
+ }
702
+ /** Called when this tab becomes leader or loses leadership. */
703
+ onLeaderChange(fn) {
704
+ return this.subs.on("$lifecycle:leader", fn);
705
+ }
706
+ /** Called on WebSocket or network error (broadcast to all tabs). */
707
+ onError(fn) {
708
+ return this.subs.on("$lifecycle:error", fn);
709
+ }
710
+ // ─── Middleware ───────────────────────────────────────
711
+ /**
712
+ * Add middleware to transform messages before send or after receive.
713
+ * Return null from middleware to drop the message.
714
+ *
715
+ * @example
716
+ * // Add timestamp to every outgoing message
717
+ * ws.use('outgoing', (msg) => ({ ...msg, timestamp: Date.now() }));
718
+ *
719
+ * @example
720
+ * // Decrypt incoming messages
721
+ * ws.use('incoming', (msg) => ({ ...msg, data: decrypt(msg.data) }));
722
+ *
723
+ * @example
724
+ * // Drop messages from blocked users
725
+ * ws.use('incoming', (msg) => blockedUsers.has(msg.userId) ? null : msg);
726
+ */
727
+ use(direction, fn) {
728
+ if (direction === "outgoing") {
729
+ this.outgoingMiddleware.push(fn);
730
+ } else {
731
+ this.incomingMiddleware.push(fn);
732
+ }
733
+ return this;
734
+ }
735
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
637
736
  on(event, handler) {
638
737
  return this.subs.on(event, handler);
639
738
  }
739
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
640
740
  once(event, handler) {
641
741
  return this.subs.once(event, handler);
642
742
  }
643
743
  off(event, handler) {
644
744
  this.subs.off(event, handler);
645
745
  }
646
- /** Async generator for consuming events. */
647
746
  stream(event, signal) {
648
747
  return this.subs.stream(event, signal);
649
748
  }
650
- /** Send message to server (auto-routed through leader). */
651
749
  send(event, data) {
750
+ let payload = { [this.proto.eventField]: event, [this.proto.dataField]: data };
751
+ for (const mw of this.outgoingMiddleware) {
752
+ payload = mw(payload);
753
+ if (payload === null) {
754
+ this.log.debug("[SharedWS] \u2717 outgoing dropped by middleware", event);
755
+ return;
756
+ }
757
+ }
758
+ this.log.debug("[SharedWS] \u2192 send", event, data);
652
759
  if (this.coordinator.isLeader && this.socket) {
653
- this.socket.send({ event, data });
760
+ this.socket.send(payload);
654
761
  } else {
655
762
  this.bus.publish("ws:send", { event, data });
656
763
  }
@@ -670,6 +777,50 @@ var SharedWebSocket = (_class6 = class {
670
777
  onSync(key, fn) {
671
778
  return this.subs.on(`sync:${key}`, fn);
672
779
  }
780
+ /**
781
+ * Subscribe to a private/scoped channel. Returns a channel handle with
782
+ * scoped on/send/stream methods. Sends join on subscribe, leave on unsubscribe.
783
+ *
784
+ * @example
785
+ * const chat = ws.channel('chat:room_123');
786
+ * chat.on('message', (msg) => render(msg));
787
+ * chat.send('message', { text: 'Hello' });
788
+ * chat.leave(); // sends leave + unsubscribes
789
+ *
790
+ * @example
791
+ * // Private notifications for tenant
792
+ * const notifications = ws.channel(`tenant:${tenantId}:notifications`);
793
+ * notifications.on('alert', (alert) => showToast(alert));
794
+ */
795
+ channel(name) {
796
+ this.send(this.proto.channelJoin, { channel: name });
797
+ const self = this;
798
+ const unsubs = [];
799
+ return {
800
+ name,
801
+ on(event, handler) {
802
+ const unsub = self.subs.on(`${name}:${event}`, handler);
803
+ unsubs.push(unsub);
804
+ return unsub;
805
+ },
806
+ once(event, handler) {
807
+ const unsub = self.subs.once(`${name}:${event}`, handler);
808
+ unsubs.push(unsub);
809
+ return unsub;
810
+ },
811
+ send(event, data) {
812
+ self.send(`${name}:${event}`, data);
813
+ },
814
+ stream(event, signal) {
815
+ return self.subs.stream(`${name}:${event}`, signal);
816
+ },
817
+ leave() {
818
+ self.send(self.proto.channelLeave, { channel: name });
819
+ for (const unsub of unsubs) unsub();
820
+ unsubs.length = 0;
821
+ }
822
+ };
823
+ }
673
824
  disconnect() {
674
825
  this[Symbol.dispose]();
675
826
  }
@@ -679,7 +830,8 @@ var SharedWebSocket = (_class6 = class {
679
830
  reconnect: this.options.reconnect,
680
831
  reconnectMaxDelay: this.options.reconnectMaxDelay,
681
832
  heartbeatInterval: this.options.heartbeatInterval,
682
- sendBuffer: this.options.sendBuffer
833
+ sendBuffer: this.options.sendBuffer,
834
+ pingPayload: this.proto.ping
683
835
  };
684
836
  if (this.options.useWorker) {
685
837
  return new WorkerSocket(this.url, {
@@ -694,20 +846,46 @@ var SharedWebSocket = (_class6 = class {
694
846
  authParam: this.options.authParam
695
847
  });
696
848
  }
697
- onBecomeLeader() {
849
+ handleBecomeLeader() {
850
+ this.log.info("[SharedWS] \u{1F451} became leader");
698
851
  this.socket = this.createSocket();
699
- this.socket.onMessage((data) => {
700
- const event = _nullishCoalesce(_optionalChain([data, 'optionalAccess', _32 => _32.event]), () => ( "message"));
701
- const payload = _nullishCoalesce(_optionalChain([data, 'optionalAccess', _33 => _33.data]), () => ( data));
852
+ this.socket.onMessage((raw) => {
853
+ let data = raw;
854
+ for (const mw of this.incomingMiddleware) {
855
+ data = mw(data);
856
+ if (data === null) {
857
+ this.log.debug("[SharedWS] \u2717 incoming dropped by middleware");
858
+ return;
859
+ }
860
+ }
861
+ const msg = data;
862
+ const event = _nullishCoalesce(_optionalChain([msg, 'optionalAccess', _32 => _32[this.proto.eventField]]), () => ( this.proto.defaultEvent));
863
+ const payload = _nullishCoalesce(_optionalChain([msg, 'optionalAccess', _33 => _33[this.proto.dataField]]), () => ( data));
864
+ this.log.debug("[SharedWS] \u2190 recv", event, payload);
702
865
  this.bus.broadcast("ws:message", { event, data: payload });
703
866
  });
867
+ this.socket.onStateChange((state) => {
868
+ this.log.info("[SharedWS]", state === "connected" ? "\u2713 connected" : state === "reconnecting" ? "\u{1F504} reconnecting" : `state: ${state}`);
869
+ switch (state) {
870
+ case "connected":
871
+ this.bus.broadcast("ws:lifecycle", { type: "connect" });
872
+ break;
873
+ case "closed":
874
+ this.bus.broadcast("ws:lifecycle", { type: "disconnect" });
875
+ break;
876
+ case "reconnecting":
877
+ this.bus.broadcast("ws:lifecycle", { type: "reconnecting" });
878
+ break;
879
+ }
880
+ });
704
881
  this.cleanups.push(
705
882
  this.bus.respond("ws:request", async (req) => {
706
883
  return new Promise((resolve) => {
707
884
  const unsub = this.socket.onMessage((response) => {
708
- if (_optionalChain([response, 'optionalAccess', _34 => _34.event]) === req.event || _optionalChain([response, 'optionalAccess', _35 => _35.requestId])) {
885
+ const res = response;
886
+ if (_optionalChain([res, 'optionalAccess', _34 => _34[this.proto.eventField]]) === req.event || _optionalChain([res, 'optionalAccess', _35 => _35.requestId])) {
709
887
  unsub();
710
- resolve(_nullishCoalesce(_optionalChain([response, 'optionalAccess', _36 => _36.data]), () => ( response)));
888
+ resolve(_nullishCoalesce(_optionalChain([res, 'optionalAccess', _36 => _36[this.proto.dataField]]), () => ( response)));
711
889
  }
712
890
  });
713
891
  this.socket.send({ event: req.event, data: req.data });
@@ -716,7 +894,7 @@ var SharedWebSocket = (_class6 = class {
716
894
  );
717
895
  this.socket.connect();
718
896
  }
719
- onLoseLeadership() {
897
+ handleLoseLeadership() {
720
898
  if (this.socket) {
721
899
  this.socket[Symbol.dispose]();
722
900
  this.socket = null;
@@ -746,4 +924,4 @@ var SharedWebSocket = (_class6 = class {
746
924
 
747
925
 
748
926
  exports.MessageBus = MessageBus; exports.TabCoordinator = TabCoordinator; exports.SharedSocket = SharedSocket; exports.WorkerSocket = WorkerSocket; exports.SubscriptionManager = SubscriptionManager; exports.SharedWebSocket = SharedWebSocket;
749
- //# sourceMappingURL=chunk-Q4OKSJX7.cjs.map
927
+ //# sourceMappingURL=chunk-UEOFAFLV.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/gwakko/Projects/shared-websocket/dist/chunk-UEOFAFLV.cjs","../src/utils/disposable.ts","../src/utils/id.ts","../src/MessageBus.ts","../src/TabCoordinator.ts","../src/utils/backoff.ts","../src/SharedSocket.ts","../src/WorkerSocket.ts","../src/SubscriptionManager.ts","../src/SharedWebSocket.ts"],"names":[],"mappings":"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","file":"/Users/gwakko/Projects/shared-websocket/dist/chunk-UEOFAFLV.cjs","sourcesContent":[null,"/** Polyfill Symbol.dispose if not available. */\nif (typeof Symbol.dispose === 'undefined') {\n (Symbol as any).dispose = Symbol('Symbol.dispose');\n}\n","export function generateId(): string {\n if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n return crypto.randomUUID();\n }\n return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;\n}\n","import './utils/disposable';\nimport { generateId } from './utils/id';\nimport type { BusMessage, Unsubscribe } from './types';\n\ntype Listener = (msg: BusMessage) => void;\n\nexport class MessageBus implements Disposable {\n private channel: BroadcastChannel;\n private listeners = new Map<string, Set<Listener>>();\n private pendingRequests = new Map<string, { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> }>();\n\n constructor(\n channelName: string,\n private readonly tabId: string,\n ) {\n this.channel = new BroadcastChannel(channelName);\n this.channel.onmessage = (ev: MessageEvent<BusMessage>) => {\n this.handleMessage(ev.data);\n };\n }\n\n subscribe<T>(topic: string, fn: (data: T) => void): Unsubscribe {\n const wrapper: Listener = (msg) => {\n if (msg.source !== this.tabId) fn(msg.data as T);\n };\n this.addListener(topic, wrapper);\n return () => this.removeListener(topic, wrapper);\n }\n\n publish<T>(topic: string, data: T): void {\n this.postMessage({ topic, type: 'publish', data });\n }\n\n broadcast<T>(topic: string, data: T): void {\n const msg = this.createMessage(topic, 'broadcast', data);\n this.channel.postMessage(msg);\n // Also deliver to self\n this.handleMessage(msg);\n }\n\n async request<T, R>(topic: string, data: T, timeout = 5000): Promise<R> {\n const msg = this.createMessage(topic, 'request', data);\n return new Promise<R>((resolve, reject) => {\n const timer = setTimeout(() => {\n this.pendingRequests.delete(msg.id);\n reject(new Error(`MessageBus.request: timeout for topic \"${topic}\"`));\n }, timeout);\n this.pendingRequests.set(msg.id, { resolve: resolve as (v: unknown) => void, reject, timer });\n this.channel.postMessage(msg);\n });\n }\n\n respond<T, R>(topic: string, fn: (data: T) => R | Promise<R>): Unsubscribe {\n const wrapper: Listener = async (msg) => {\n if (msg.type !== 'request' || msg.source === this.tabId) return;\n const result = await fn(msg.data as T);\n this.postMessage({ topic, type: 'response', data: { requestId: msg.id, result } });\n };\n this.addListener(topic, wrapper);\n return () => this.removeListener(topic, wrapper);\n }\n\n private handleMessage(msg: BusMessage): void {\n // Handle response to pending request\n if (msg.type === 'response') {\n const payload = msg.data as { requestId: string; result: unknown };\n const pending = this.pendingRequests.get(payload.requestId);\n if (pending) {\n clearTimeout(pending.timer);\n this.pendingRequests.delete(payload.requestId);\n pending.resolve(payload.result);\n return;\n }\n }\n\n const listeners = this.listeners.get(msg.topic);\n if (listeners) {\n for (const fn of listeners) fn(msg);\n }\n }\n\n private postMessage(partial: Pick<BusMessage, 'topic' | 'type' | 'data'>): void {\n this.channel.postMessage(this.createMessage(partial.topic, partial.type, partial.data));\n }\n\n private createMessage(topic: string, type: BusMessage['type'], data: unknown): BusMessage {\n return { id: generateId(), source: this.tabId, topic, type, data, timestamp: Date.now() };\n }\n\n private addListener(topic: string, fn: Listener): void {\n let set = this.listeners.get(topic);\n if (!set) {\n set = new Set();\n this.listeners.set(topic, set);\n }\n set.add(fn);\n }\n\n private removeListener(topic: string, fn: Listener): void {\n this.listeners.get(topic)?.delete(fn);\n }\n\n [Symbol.dispose](): void {\n for (const pending of this.pendingRequests.values()) {\n clearTimeout(pending.timer);\n pending.reject(new Error('MessageBus disposed'));\n }\n this.pendingRequests.clear();\n this.listeners.clear();\n this.channel.close();\n }\n}\n","import './utils/disposable';\nimport { MessageBus } from './MessageBus';\nimport type { Unsubscribe } from './types';\n\ninterface CoordinatorOptions {\n electionTimeout?: number; // ms to wait for rejection (default 200)\n heartbeatInterval?: number; // ms between heartbeats (default 2000)\n leaderTimeout?: number; // ms without heartbeat to trigger election (default 5000)\n}\n\nexport class TabCoordinator implements Disposable {\n private _isLeader = false;\n private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n private leaderCheckTimer: ReturnType<typeof setInterval> | null = null;\n private lastHeartbeat = 0;\n private disposed = false;\n\n private onBecomeLeaderFns = new Set<() => void>();\n private onLoseLeadershipFns = new Set<() => void>();\n private cleanups: Unsubscribe[] = [];\n\n private readonly electionTimeout: number;\n private readonly heartbeatInterval: number;\n private readonly leaderTimeout: number;\n\n constructor(\n private readonly bus: MessageBus,\n private readonly tabId: string,\n options: CoordinatorOptions = {},\n ) {\n this.electionTimeout = options.electionTimeout ?? 200;\n this.heartbeatInterval = options.heartbeatInterval ?? 2000;\n this.leaderTimeout = options.leaderTimeout ?? 5000;\n\n // Listen for election requests — reject if we are leader\n this.cleanups.push(\n this.bus.subscribe<{ tabId: string }>('coord:election', () => {\n if (this._isLeader) {\n this.bus.publish('coord:reject', { tabId: this.tabId });\n }\n }),\n );\n\n // Listen for heartbeats\n this.cleanups.push(\n this.bus.subscribe<{ tabId: string }>('coord:heartbeat', () => {\n this.lastHeartbeat = Date.now();\n }),\n );\n\n // Listen for abdication\n this.cleanups.push(\n this.bus.subscribe('coord:abdicate', () => {\n if (!this._isLeader && !this.disposed) {\n this.elect();\n }\n }),\n );\n }\n\n get isLeader(): boolean {\n return this._isLeader;\n }\n\n async elect(): Promise<void> {\n if (this.disposed) return;\n\n return new Promise<void>((resolve) => {\n let rejected = false;\n\n const unsub = this.bus.subscribe('coord:reject', () => {\n rejected = true;\n unsub();\n // We are follower — start monitoring leader heartbeat\n this.startLeaderCheck();\n resolve();\n });\n\n this.bus.publish('coord:election', { tabId: this.tabId });\n\n setTimeout(() => {\n unsub();\n if (!rejected && !this.disposed) {\n this.becomeLeader();\n }\n resolve();\n }, this.electionTimeout);\n });\n }\n\n abdicate(): void {\n if (!this._isLeader) return;\n this._isLeader = false;\n this.stopHeartbeat();\n this.bus.publish('coord:abdicate', { tabId: this.tabId });\n for (const fn of this.onLoseLeadershipFns) fn();\n }\n\n onBecomeLeader(fn: () => void): Unsubscribe {\n this.onBecomeLeaderFns.add(fn);\n return () => this.onBecomeLeaderFns.delete(fn);\n }\n\n onLoseLeadership(fn: () => void): Unsubscribe {\n this.onLoseLeadershipFns.add(fn);\n return () => this.onLoseLeadershipFns.delete(fn);\n }\n\n private becomeLeader(): void {\n this._isLeader = true;\n this.stopLeaderCheck();\n this.startHeartbeat();\n for (const fn of this.onBecomeLeaderFns) fn();\n }\n\n private startHeartbeat(): void {\n this.stopHeartbeat();\n this.heartbeatTimer = setInterval(() => {\n this.bus.publish('coord:heartbeat', { tabId: this.tabId });\n }, this.heartbeatInterval);\n // Send immediately\n this.bus.publish('coord:heartbeat', { tabId: this.tabId });\n }\n\n private stopHeartbeat(): void {\n if (this.heartbeatTimer) {\n clearInterval(this.heartbeatTimer);\n this.heartbeatTimer = null;\n }\n }\n\n private startLeaderCheck(): void {\n this.stopLeaderCheck();\n this.lastHeartbeat = Date.now();\n this.leaderCheckTimer = setInterval(() => {\n if (Date.now() - this.lastHeartbeat > this.leaderTimeout && !this.disposed) {\n this.stopLeaderCheck();\n this.elect();\n }\n }, 1000);\n }\n\n private stopLeaderCheck(): void {\n if (this.leaderCheckTimer) {\n clearInterval(this.leaderCheckTimer);\n this.leaderCheckTimer = null;\n }\n }\n\n [Symbol.dispose](): void {\n this.disposed = true;\n if (this._isLeader) {\n this.abdicate();\n }\n this.stopHeartbeat();\n this.stopLeaderCheck();\n for (const unsub of this.cleanups) unsub();\n this.cleanups = [];\n this.onBecomeLeaderFns.clear();\n this.onLoseLeadershipFns.clear();\n }\n}\n","/** Exponential backoff generator with jitter. */\nexport function* backoff(base = 1000, max = 30_000): Generator<number> {\n let delay = base;\n while (true) {\n const jitter = delay * 0.25 * (Math.random() * 2 - 1);\n yield Math.min(delay + jitter, max);\n delay = Math.min(delay * 2, max);\n }\n}\n","import './utils/disposable';\nimport { backoff } from './utils/backoff';\nimport type { SocketState, Unsubscribe, EventHandler } from './types';\n\ninterface SharedSocketOptions {\n protocols?: string[];\n reconnect?: boolean;\n reconnectMaxDelay?: number;\n heartbeatInterval?: number;\n sendBuffer?: number;\n auth?: () => string | Promise<string>;\n authToken?: string;\n authParam?: string;\n /** Heartbeat payload (default: { type: \"ping\" }). */\n pingPayload?: unknown;\n}\n\nexport class SharedSocket implements Disposable {\n private ws: WebSocket | null = null;\n private _state: SocketState = 'closed';\n private buffer: unknown[] = [];\n private disposed = false;\n private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n\n private onMessageFns = new Set<EventHandler>();\n private onStateChangeFns = new Set<(state: SocketState) => void>();\n\n private readonly opts: Required<Omit<SharedSocketOptions, 'auth' | 'authToken' | 'authParam' | 'pingPayload'>> & {\n auth?: () => string | Promise<string>;\n authToken?: string;\n authParam: string;\n pingPayload: unknown;\n };\n\n constructor(\n private url: string,\n options: SharedSocketOptions = {},\n ) {\n this.opts = {\n protocols: options.protocols ?? [],\n reconnect: options.reconnect ?? true,\n reconnectMaxDelay: options.reconnectMaxDelay ?? 30_000,\n heartbeatInterval: options.heartbeatInterval ?? 30_000,\n sendBuffer: options.sendBuffer ?? 100,\n auth: options.auth,\n authToken: options.authToken,\n authParam: options.authParam ?? 'token',\n pingPayload: options.pingPayload ?? { type: 'ping' },\n };\n }\n\n get state(): SocketState {\n return this._state;\n }\n\n async connect(): Promise<void> {\n if (this.disposed) return;\n\n this.setState('connecting');\n\n const connectUrl = await this.buildUrl();\n this.ws = new WebSocket(connectUrl, this.opts.protocols);\n\n this.ws.onopen = () => {\n this.setState('connected');\n this.flushBuffer();\n this.startHeartbeat();\n };\n\n this.ws.onmessage = (ev: MessageEvent) => {\n let data: unknown;\n try {\n data = JSON.parse(ev.data as string);\n } catch {\n data = ev.data;\n }\n for (const fn of this.onMessageFns) fn(data);\n };\n\n this.ws.onclose = () => {\n this.stopHeartbeat();\n if (!this.disposed && this.opts.reconnect) {\n this.reconnect();\n } else {\n this.setState('closed');\n }\n };\n\n this.ws.onerror = () => {\n // onclose will fire after onerror\n };\n }\n\n disconnect(): void {\n this.disposed = true;\n this.stopHeartbeat();\n this.clearReconnect();\n\n if (this.ws) {\n this.ws.onclose = null;\n this.ws.onmessage = null;\n this.ws.onerror = null;\n if (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING) {\n this.ws.close(1000, 'client disconnect');\n }\n this.ws = null;\n }\n\n this.setState('closed');\n }\n\n send(data: unknown): void {\n if (this._state === 'connected' && this.ws?.readyState === WebSocket.OPEN) {\n this.ws.send(JSON.stringify(data));\n } else if (this._state === 'reconnecting' || this._state === 'connecting') {\n if (this.buffer.length < this.opts.sendBuffer) {\n this.buffer.push(data);\n }\n }\n }\n\n onMessage(fn: EventHandler): Unsubscribe {\n this.onMessageFns.add(fn);\n return () => this.onMessageFns.delete(fn);\n }\n\n onStateChange(fn: (state: SocketState) => void): Unsubscribe {\n this.onStateChangeFns.add(fn);\n return () => this.onStateChangeFns.delete(fn);\n }\n\n private reconnect(): void {\n this.setState('reconnecting');\n const gen = backoff(1000, this.opts.reconnectMaxDelay);\n\n const attempt = () => {\n if (this.disposed) return;\n const delay = gen.next().value;\n this.reconnectTimer = setTimeout(() => {\n if (!this.disposed) this.connect();\n }, delay);\n };\n\n attempt();\n }\n\n private flushBuffer(): void {\n const pending = this.buffer.splice(0);\n for (const item of pending) {\n this.send(item);\n }\n }\n\n private startHeartbeat(): void {\n this.stopHeartbeat();\n this.heartbeatTimer = setInterval(() => {\n if (this.ws?.readyState === WebSocket.OPEN) {\n this.ws.send(JSON.stringify(this.opts.pingPayload));\n }\n }, this.opts.heartbeatInterval);\n }\n\n private stopHeartbeat(): void {\n if (this.heartbeatTimer) {\n clearInterval(this.heartbeatTimer);\n this.heartbeatTimer = null;\n }\n }\n\n private clearReconnect(): void {\n if (this.reconnectTimer) {\n clearTimeout(this.reconnectTimer);\n this.reconnectTimer = null;\n }\n }\n\n private async buildUrl(): Promise<string> {\n // Resolve token: callback > static > none\n let token: string | undefined;\n if (this.opts.auth) {\n token = await this.opts.auth();\n } else if (this.opts.authToken) {\n token = this.opts.authToken;\n }\n\n if (!token) return this.url;\n\n // WebSocket URLs (ws://, wss://) are not fully supported by URL API.\n // Convert to http(s) for parsing, then back to ws(s).\n const httpUrl = this.url.replace(/^ws(s?):\\/\\//, 'http$1://');\n const parsed = new URL(httpUrl);\n parsed.searchParams.set(this.opts.authParam, token);\n\n return parsed.toString().replace(/^http(s?):\\/\\//, 'ws$1://');\n }\n\n private setState(state: SocketState): void {\n this._state = state;\n for (const fn of this.onStateChangeFns) fn(state);\n }\n\n [Symbol.dispose](): void {\n this.disconnect();\n this.onMessageFns.clear();\n this.onStateChangeFns.clear();\n this.buffer = [];\n }\n}\n","import './utils/disposable';\nimport type { SocketState, Unsubscribe, EventHandler } from './types';\n\n/**\n * WorkerSocket — WebSocket running inside a Web Worker.\n *\n * Same interface as SharedSocket, but WebSocket lives off main thread.\n * Benefits: heartbeat timers and JSON parsing don't block UI rendering.\n *\n * Use when:\n * - High message rate (50+ msgs/sec)\n * - Heavy JSON payloads\n * - UI does complex rendering that could block main thread\n *\n * Don't use when:\n * - Low message rate (simple chat, notifications)\n * - Bundle size matters (adds worker file)\n * - Debugging (Worker DevTools is less convenient)\n */\nexport class WorkerSocket implements Disposable {\n private worker: Worker | null = null;\n private _state: SocketState = 'closed';\n\n private onMessageFns = new Set<EventHandler>();\n private onStateChangeFns = new Set<(state: SocketState) => void>();\n\n constructor(\n private url: string,\n private options: {\n protocols?: string[];\n reconnect?: boolean;\n reconnectMaxDelay?: number;\n heartbeatInterval?: number;\n sendBuffer?: number;\n workerUrl?: string | URL;\n } = {},\n ) {}\n\n get state(): SocketState {\n return this._state;\n }\n\n connect(): void {\n // Create worker from inline blob if no workerUrl provided\n const workerUrl = this.options.workerUrl ?? this.createWorkerBlob();\n\n this.worker = new Worker(workerUrl, { type: 'module' });\n\n this.worker.onmessage = (ev: MessageEvent) => {\n const msg = ev.data;\n\n switch (msg.type) {\n case 'state':\n this._state = msg.state;\n for (const fn of this.onStateChangeFns) fn(msg.state);\n break;\n\n case 'message':\n for (const fn of this.onMessageFns) fn(msg.data);\n break;\n\n case 'open':\n // State already set via 'state' message\n break;\n\n case 'close':\n break;\n\n case 'error':\n console.error('WorkerSocket error:', msg.message);\n break;\n }\n };\n\n this.worker.postMessage({\n type: 'connect',\n url: this.url,\n protocols: this.options.protocols ?? [],\n reconnect: this.options.reconnect ?? true,\n reconnectMaxDelay: this.options.reconnectMaxDelay ?? 30_000,\n heartbeatInterval: this.options.heartbeatInterval ?? 30_000,\n bufferSize: this.options.sendBuffer ?? 100,\n });\n }\n\n send(data: unknown): void {\n this.worker?.postMessage({ type: 'send', data });\n }\n\n disconnect(): void {\n this.worker?.postMessage({ type: 'disconnect' });\n setTimeout(() => {\n this.worker?.terminate();\n this.worker = null;\n }, 100);\n this._state = 'closed';\n }\n\n onMessage(fn: EventHandler): Unsubscribe {\n this.onMessageFns.add(fn);\n return () => this.onMessageFns.delete(fn);\n }\n\n onStateChange(fn: (state: SocketState) => void): Unsubscribe {\n this.onStateChangeFns.add(fn);\n return () => this.onStateChangeFns.delete(fn);\n }\n\n private createWorkerBlob(): URL {\n // Inline the worker code as a blob URL\n // In production, use a bundler (Vite, webpack) to handle worker imports\n const code = `\n let ws = null, state = 'closed', buffer = [], disposed = false;\n let heartbeatTimer = null, reconnectTimer = null;\n let url = '', protocols = [], shouldReconnect = true;\n let maxDelay = 30000, hbInterval = 30000, maxBuf = 100, delay = 1000;\n\n function setState(s) { state = s; self.postMessage({ type: 'state', state: s }); }\n function connect() {\n if (disposed) return;\n setState('connecting');\n ws = new WebSocket(url, protocols);\n ws.onopen = () => { setState('connected'); delay = 1000; self.postMessage({ type: 'open' }); flush(); startHB(); };\n ws.onmessage = (e) => { let d; try { d = JSON.parse(e.data); } catch { d = e.data; } self.postMessage({ type: 'message', data: d }); };\n ws.onclose = (e) => { stopHB(); self.postMessage({ type: 'close', code: e.code, reason: e.reason }); if (!disposed && shouldReconnect && e.code !== 1000) reconnect(); else setState('closed'); };\n ws.onerror = () => { self.postMessage({ type: 'error', message: 'error' }); };\n }\n function send(d) { if (state === 'connected' && ws?.readyState === 1) ws.send(JSON.stringify(d)); else if (buffer.length < maxBuf) buffer.push(d); }\n function flush() { const p = buffer.splice(0); p.forEach(send); }\n function startHB() { stopHB(); heartbeatTimer = setInterval(() => { if (ws?.readyState === 1) ws.send('{\"type\":\"ping\"}'); }, hbInterval); }\n function stopHB() { if (heartbeatTimer) { clearInterval(heartbeatTimer); heartbeatTimer = null; } }\n function reconnect() { setState('reconnecting'); const j = delay * 0.25 * (Math.random() * 2 - 1); reconnectTimer = setTimeout(() => { if (!disposed) connect(); }, Math.min(delay + j, maxDelay)); delay = Math.min(delay * 2, maxDelay); }\n self.onmessage = (e) => {\n const c = e.data;\n if (c.type === 'connect') { url = c.url; protocols = c.protocols || []; shouldReconnect = c.reconnect ?? true; maxDelay = c.reconnectMaxDelay || 30000; hbInterval = c.heartbeatInterval || 30000; maxBuf = c.bufferSize || 100; connect(); }\n if (c.type === 'send') send(c.data);\n if (c.type === 'disconnect') { disposed = true; stopHB(); if (reconnectTimer) clearTimeout(reconnectTimer); if (ws) { ws.onclose = null; if (ws.readyState < 2) ws.close(1000); ws = null; } buffer = []; setState('closed'); }\n };\n `;\n const blob = new Blob([code], { type: 'application/javascript' });\n return new URL(URL.createObjectURL(blob));\n }\n\n [Symbol.dispose](): void {\n this.disconnect();\n this.onMessageFns.clear();\n this.onStateChangeFns.clear();\n }\n}\n","import './utils/disposable';\nimport type { EventHandler, Unsubscribe } from './types';\n\nexport class SubscriptionManager implements Disposable {\n private handlers = new Map<string, Set<EventHandler>>();\n private lastMessages = new Map<string, unknown>();\n\n on(event: string, handler: EventHandler): Unsubscribe {\n let set = this.handlers.get(event);\n if (!set) {\n set = new Set();\n this.handlers.set(event, set);\n }\n set.add(handler);\n return () => set!.delete(handler);\n }\n\n once(event: string, handler: EventHandler): Unsubscribe {\n const wrapper: EventHandler = (data) => {\n unsub();\n handler(data);\n };\n const unsub = this.on(event, wrapper);\n return unsub;\n }\n\n off(event: string, handler?: EventHandler): void {\n if (handler) {\n this.handlers.get(event)?.delete(handler);\n } else {\n this.handlers.delete(event);\n }\n }\n\n emit(event: string, data: unknown): void {\n this.lastMessages.set(event, data);\n const set = this.handlers.get(event);\n if (set) {\n for (const fn of set) fn(data);\n }\n }\n\n getLastMessage(event: string): unknown | undefined {\n return this.lastMessages.get(event);\n }\n\n async *stream(event: string, signal?: AbortSignal): AsyncGenerator<unknown> {\n const queue: unknown[] = [];\n let resolve: (() => void) | null = null;\n let done = false;\n\n const unsub = this.on(event, (data) => {\n queue.push(data);\n resolve?.();\n });\n\n const onAbort = () => {\n done = true;\n resolve?.();\n };\n signal?.addEventListener('abort', onAbort);\n\n try {\n while (!done) {\n if (queue.length > 0) {\n yield queue.shift()!;\n } else {\n await new Promise<void>((r) => { resolve = r; });\n resolve = null;\n }\n }\n } finally {\n unsub();\n signal?.removeEventListener('abort', onAbort);\n }\n }\n\n offAll(): void {\n this.handlers.clear();\n this.lastMessages.clear();\n }\n\n [Symbol.dispose](): void {\n this.offAll();\n }\n}\n","import './utils/disposable';\nimport { generateId } from './utils/id';\nimport { MessageBus } from './MessageBus';\nimport { TabCoordinator } from './TabCoordinator';\nimport { SharedSocket } from './SharedSocket';\nimport { WorkerSocket } from './WorkerSocket';\nimport { SubscriptionManager } from './SubscriptionManager';\nimport type { SharedWebSocketOptions, TabRole, Unsubscribe, EventHandler, Channel, EventProtocol, EventMap, Logger, Middleware } from './types';\n\nconst DEFAULT_PROTOCOL: EventProtocol = {\n eventField: 'event',\n dataField: 'data',\n channelJoin: '$channel:join',\n channelLeave: '$channel:leave',\n ping: { type: 'ping' },\n defaultEvent: 'message',\n};\n\nconst NOOP_LOGGER: Logger = {\n debug() {},\n info() {},\n warn() {},\n error() {},\n};\n\n/** Common interface for both SharedSocket and WorkerSocket. */\ninterface SocketAdapter {\n readonly state: string;\n connect(): void;\n send(data: unknown): void;\n disconnect(): void;\n onMessage(fn: EventHandler): Unsubscribe;\n onStateChange(fn: (state: string) => void): Unsubscribe;\n [Symbol.dispose](): void;\n}\n\n/**\n * SharedWebSocket — shares ONE WebSocket connection across browser tabs.\n *\n * @typeParam TEvents - Event map for type-safe subscriptions.\n *\n * @example\n * // Typed events\n * type Events = {\n * 'chat.message': { text: string; userId: string };\n * 'order.created': { id: string; total: number };\n * };\n * const ws = new SharedWebSocket<Events>(url);\n * ws.on('chat.message', (msg) => msg.text); // ← msg: { text, userId }\n */\nexport class SharedWebSocket<TEvents extends EventMap = EventMap> implements Disposable {\n private bus: MessageBus;\n private coordinator: TabCoordinator;\n private socket: SocketAdapter | null = null;\n private subs = new SubscriptionManager();\n private syncStore = new Map<string, unknown>();\n private tabId: string;\n private cleanups: Unsubscribe[] = [];\n private disposed = false;\n private readonly proto: EventProtocol;\n private readonly log: Logger;\n private outgoingMiddleware: Middleware[] = [];\n private incomingMiddleware: Middleware[] = [];\n\n constructor(\n private readonly url: string,\n private readonly options: SharedWebSocketOptions<TEvents> = {} as SharedWebSocketOptions<TEvents>,\n ) {\n this.proto = { ...DEFAULT_PROTOCOL, ...options.events };\n this.log = options.debug ? (options.logger ?? console) : NOOP_LOGGER;\n this.tabId = generateId();\n this.log.debug('[SharedWS] init', { tabId: this.tabId, url });\n this.bus = new MessageBus('shared-ws', this.tabId);\n this.coordinator = new TabCoordinator(this.bus, this.tabId, {\n electionTimeout: options.electionTimeout,\n heartbeatInterval: options.leaderHeartbeat,\n leaderTimeout: options.leaderTimeout,\n });\n\n // When ANY tab receives a WS message via bus → emit to local subscribers\n this.cleanups.push(\n this.bus.subscribe<{ event: string; data: unknown }>('ws:message', (msg) => {\n this.subs.emit(msg.event, msg.data);\n }),\n );\n\n // Leader listens for send requests from followers\n this.cleanups.push(\n this.bus.subscribe<{ event: string; data: unknown }>('ws:send', (msg) => {\n if (this.coordinator.isLeader && this.socket) {\n this.socket.send({ [this.proto.eventField]: msg.event, [this.proto.dataField]: msg.data });\n }\n }),\n );\n\n // Sync across tabs\n this.cleanups.push(\n this.bus.subscribe<{ key: string; value: unknown }>('ws:sync', (msg) => {\n this.syncStore.set(msg.key, msg.value);\n this.subs.emit(`sync:${msg.key}`, msg.value);\n }),\n );\n\n // Leader lifecycle\n this.coordinator.onBecomeLeader(() => {\n this.handleBecomeLeader();\n this.bus.broadcast('ws:lifecycle', { type: 'leader', isLeader: true });\n });\n this.coordinator.onLoseLeadership(() => {\n this.handleLoseLeadership();\n this.bus.broadcast('ws:lifecycle', { type: 'leader', isLeader: false });\n });\n\n // Lifecycle events from bus (all tabs receive)\n this.cleanups.push(\n this.bus.subscribe<{ type: string; isLeader?: boolean; error?: unknown }>('ws:lifecycle', (msg) => {\n switch (msg.type) {\n case 'connect':\n this.subs.emit('$lifecycle:connect', undefined);\n break;\n case 'disconnect':\n this.subs.emit('$lifecycle:disconnect', undefined);\n break;\n case 'reconnecting':\n this.subs.emit('$lifecycle:reconnecting', undefined);\n break;\n case 'leader':\n this.subs.emit('$lifecycle:leader', msg.isLeader);\n break;\n case 'error':\n this.subs.emit('$lifecycle:error', msg.error);\n break;\n }\n }),\n );\n\n // Cleanup on tab close\n if (typeof window !== 'undefined') {\n const onBeforeUnload = () => this[Symbol.dispose]();\n window.addEventListener('beforeunload', onBeforeUnload);\n this.cleanups.push(() => window.removeEventListener('beforeunload', onBeforeUnload));\n }\n }\n\n get connected(): boolean {\n return this.socket?.state === 'connected' || !this.coordinator.isLeader;\n }\n\n get tabRole(): TabRole {\n return this.coordinator.isLeader ? 'leader' : 'follower';\n }\n\n /** Start leader election and connect. */\n async connect(): Promise<void> {\n await this.coordinator.elect();\n }\n\n // ─── Lifecycle Hooks ─────────────────────────────────\n\n /** Called when WebSocket connection opens (broadcast to all tabs). */\n onConnect(fn: () => void): Unsubscribe {\n return this.subs.on('$lifecycle:connect', fn);\n }\n\n /** Called when WebSocket connection closes (broadcast to all tabs). */\n onDisconnect(fn: () => void): Unsubscribe {\n return this.subs.on('$lifecycle:disconnect', fn);\n }\n\n /** Called when WebSocket starts reconnecting (broadcast to all tabs). */\n onReconnecting(fn: () => void): Unsubscribe {\n return this.subs.on('$lifecycle:reconnecting', fn);\n }\n\n /** Called when this tab becomes leader or loses leadership. */\n onLeaderChange(fn: (isLeader: boolean) => void): Unsubscribe {\n return this.subs.on('$lifecycle:leader', fn as EventHandler);\n }\n\n /** Called on WebSocket or network error (broadcast to all tabs). */\n onError(fn: (error: unknown) => void): Unsubscribe {\n return this.subs.on('$lifecycle:error', fn as EventHandler);\n }\n\n // ─── Middleware ───────────────────────────────────────\n\n /**\n * Add middleware to transform messages before send or after receive.\n * Return null from middleware to drop the message.\n *\n * @example\n * // Add timestamp to every outgoing message\n * ws.use('outgoing', (msg) => ({ ...msg, timestamp: Date.now() }));\n *\n * @example\n * // Decrypt incoming messages\n * ws.use('incoming', (msg) => ({ ...msg, data: decrypt(msg.data) }));\n *\n * @example\n * // Drop messages from blocked users\n * ws.use('incoming', (msg) => blockedUsers.has(msg.userId) ? null : msg);\n */\n use(direction: 'outgoing' | 'incoming', fn: Middleware): this {\n if (direction === 'outgoing') {\n this.outgoingMiddleware.push(fn);\n } else {\n this.incomingMiddleware.push(fn);\n }\n return this;\n }\n\n // ─── Event Subscription ──────────────────────────────\n\n /** Subscribe to server events (works in ALL tabs). Type-safe with EventMap. */\n on<K extends string & keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): Unsubscribe;\n on(event: string, handler: EventHandler<unknown>): Unsubscribe;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n on(event: string, handler: (data: any) => void): Unsubscribe {\n return this.subs.on(event, handler);\n }\n\n once<K extends string & keyof TEvents>(event: K, handler: EventHandler<TEvents[K]>): Unsubscribe;\n once(event: string, handler: EventHandler<unknown>): Unsubscribe;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n once(event: string, handler: (data: any) => void): Unsubscribe {\n return this.subs.once(event, handler);\n }\n\n off(event: string, handler?: EventHandler): void {\n this.subs.off(event, handler);\n }\n\n /** Async generator for consuming events. Type-safe with EventMap. */\n stream<K extends string & keyof TEvents>(event: K, signal?: AbortSignal): AsyncGenerator<TEvents[K]>;\n stream(event: string, signal?: AbortSignal): AsyncGenerator<unknown>;\n stream(event: string, signal?: AbortSignal): AsyncGenerator<unknown> {\n return this.subs.stream(event, signal);\n }\n\n /** Send message to server (auto-routed through leader). Type-safe with EventMap. */\n send<K extends string & keyof TEvents>(event: K, data: TEvents[K]): void;\n send(event: string, data: unknown): void;\n send(event: string, data: unknown): void {\n let payload: unknown = { [this.proto.eventField]: event, [this.proto.dataField]: data };\n\n for (const mw of this.outgoingMiddleware) {\n payload = mw(payload);\n if (payload === null) {\n this.log.debug('[SharedWS] ✗ outgoing dropped by middleware', event);\n return;\n }\n }\n\n this.log.debug('[SharedWS] → send', event, data);\n\n if (this.coordinator.isLeader && this.socket) {\n this.socket.send(payload);\n } else {\n this.bus.publish('ws:send', { event, data });\n }\n }\n\n /** Request/response through server via leader. */\n async request<T>(event: string, data: unknown, timeout = 5000): Promise<T> {\n return this.bus.request('ws:request', { event, data }, timeout);\n }\n\n /** Sync state across tabs (no server roundtrip). */\n sync<T>(key: string, value: T): void {\n this.syncStore.set(key, value);\n this.bus.broadcast('ws:sync', { key, value });\n }\n\n getSync<T>(key: string): T | undefined {\n return this.syncStore.get(key) as T | undefined;\n }\n\n onSync<T>(key: string, fn: (value: T) => void): Unsubscribe {\n return this.subs.on(`sync:${key}`, fn as EventHandler);\n }\n\n /**\n * Subscribe to a private/scoped channel. Returns a channel handle with\n * scoped on/send/stream methods. Sends join on subscribe, leave on unsubscribe.\n *\n * @example\n * const chat = ws.channel('chat:room_123');\n * chat.on('message', (msg) => render(msg));\n * chat.send('message', { text: 'Hello' });\n * chat.leave(); // sends leave + unsubscribes\n *\n * @example\n * // Private notifications for tenant\n * const notifications = ws.channel(`tenant:${tenantId}:notifications`);\n * notifications.on('alert', (alert) => showToast(alert));\n */\n channel(name: string): Channel {\n // Notify server about channel subscription\n this.send(this.proto.channelJoin, { channel: name });\n\n const self = this;\n const unsubs: Unsubscribe[] = [];\n\n return {\n name,\n on(event: string, handler: EventHandler): Unsubscribe {\n const unsub = self.subs.on(`${name}:${event}`, handler);\n unsubs.push(unsub);\n return unsub;\n },\n once(event: string, handler: EventHandler): Unsubscribe {\n const unsub = self.subs.once(`${name}:${event}`, handler);\n unsubs.push(unsub);\n return unsub;\n },\n send(event: string, data: unknown): void {\n self.send(`${name}:${event}`, data);\n },\n stream(event: string, signal?: AbortSignal): AsyncGenerator<unknown> {\n return self.subs.stream(`${name}:${event}`, signal);\n },\n leave(): void {\n self.send(self.proto.channelLeave, { channel: name });\n for (const unsub of unsubs) unsub();\n unsubs.length = 0;\n },\n };\n }\n\n disconnect(): void {\n this[Symbol.dispose]();\n }\n\n private createSocket(): SocketAdapter {\n const socketOptions = {\n protocols: this.options.protocols,\n reconnect: this.options.reconnect,\n reconnectMaxDelay: this.options.reconnectMaxDelay,\n heartbeatInterval: this.options.heartbeatInterval,\n sendBuffer: this.options.sendBuffer,\n pingPayload: this.proto.ping,\n };\n\n if (this.options.useWorker) {\n // WebSocket runs in a Web Worker — main thread stays free\n return new WorkerSocket(this.url, {\n ...socketOptions,\n workerUrl: this.options.workerUrl,\n });\n }\n\n // WebSocket runs in main thread (default)\n return new SharedSocket(this.url, {\n ...socketOptions,\n auth: this.options.auth,\n authToken: this.options.authToken,\n authParam: this.options.authParam,\n });\n }\n\n private handleBecomeLeader(): void {\n this.log.info('[SharedWS] 👑 became leader');\n this.socket = this.createSocket();\n\n this.socket.onMessage((raw: unknown) => {\n let data: unknown = raw;\n for (const mw of this.incomingMiddleware) {\n data = mw(data);\n if (data === null) {\n this.log.debug('[SharedWS] ✗ incoming dropped by middleware');\n return;\n }\n }\n\n const msg = data as Record<string, unknown> | null | undefined;\n const event = (msg?.[this.proto.eventField] as string) ?? this.proto.defaultEvent;\n const payload = msg?.[this.proto.dataField] ?? data;\n this.log.debug('[SharedWS] ← recv', event, payload);\n this.bus.broadcast('ws:message', { event, data: payload });\n });\n\n this.socket.onStateChange((state: string) => {\n this.log.info('[SharedWS]', state === 'connected' ? '✓ connected' : state === 'reconnecting' ? '🔄 reconnecting' : `state: ${state}`);\n switch (state) {\n case 'connected':\n this.bus.broadcast('ws:lifecycle', { type: 'connect' });\n break;\n case 'closed':\n this.bus.broadcast('ws:lifecycle', { type: 'disconnect' });\n break;\n case 'reconnecting':\n this.bus.broadcast('ws:lifecycle', { type: 'reconnecting' });\n break;\n }\n });\n\n this.cleanups.push(\n this.bus.respond<{ event: string; data: unknown }, unknown>('ws:request', async (req) => {\n return new Promise((resolve) => {\n const unsub = this.socket!.onMessage((response: unknown) => {\n const res = response as Record<string, unknown> | undefined;\n if (res?.[this.proto.eventField] === req.event || res?.requestId) {\n unsub();\n resolve(res?.[this.proto.dataField] ?? response);\n }\n });\n this.socket!.send({ event: req.event, data: req.data });\n });\n }),\n );\n\n this.socket.connect();\n }\n\n private handleLoseLeadership(): void {\n if (this.socket) {\n this.socket[Symbol.dispose]();\n this.socket = null;\n }\n }\n\n [Symbol.dispose](): void {\n if (this.disposed) return;\n this.disposed = true;\n\n this.coordinator[Symbol.dispose]();\n\n if (this.socket) {\n this.socket[Symbol.dispose]();\n this.socket = null;\n }\n\n for (const unsub of this.cleanups) unsub();\n this.cleanups = [];\n this.subs[Symbol.dispose]();\n this.bus[Symbol.dispose]();\n this.syncStore.clear();\n }\n}\n"]}
package/dist/index.cjs CHANGED
@@ -5,7 +5,7 @@
5
5
 
6
6
 
7
7
 
8
- var _chunkQ4OKSJX7cjs = require('./chunk-Q4OKSJX7.cjs');
8
+ var _chunkUEOFAFLVcjs = require('./chunk-UEOFAFLV.cjs');
9
9
 
10
10
  // src/withSocket.ts
11
11
  async function withSocket(url, optionsOrCallback, maybeCallback) {
@@ -17,7 +17,7 @@ async function withSocket(url, optionsOrCallback, maybeCallback) {
17
17
  options = optionsOrCallback;
18
18
  callback = maybeCallback;
19
19
  }
20
- const ws = new (0, _chunkQ4OKSJX7cjs.SharedWebSocket)(url, options);
20
+ const ws = new (0, _chunkUEOFAFLVcjs.SharedWebSocket)(url, options);
21
21
  const controller = new AbortController();
22
22
  if (_optionalChain([options, 'optionalAccess', _ => _.signal])) {
23
23
  if (options.signal.aborted) {
@@ -42,5 +42,5 @@ async function withSocket(url, optionsOrCallback, maybeCallback) {
42
42
 
43
43
 
44
44
 
45
- exports.MessageBus = _chunkQ4OKSJX7cjs.MessageBus; exports.SharedSocket = _chunkQ4OKSJX7cjs.SharedSocket; exports.SharedWebSocket = _chunkQ4OKSJX7cjs.SharedWebSocket; exports.SubscriptionManager = _chunkQ4OKSJX7cjs.SubscriptionManager; exports.TabCoordinator = _chunkQ4OKSJX7cjs.TabCoordinator; exports.WorkerSocket = _chunkQ4OKSJX7cjs.WorkerSocket; exports.withSocket = withSocket;
45
+ exports.MessageBus = _chunkUEOFAFLVcjs.MessageBus; exports.SharedSocket = _chunkUEOFAFLVcjs.SharedSocket; exports.SharedWebSocket = _chunkUEOFAFLVcjs.SharedWebSocket; exports.SubscriptionManager = _chunkUEOFAFLVcjs.SubscriptionManager; exports.TabCoordinator = _chunkUEOFAFLVcjs.TabCoordinator; exports.WorkerSocket = _chunkUEOFAFLVcjs.WorkerSocket; exports.withSocket = withSocket;
46
46
  //# sourceMappingURL=index.cjs.map
package/dist/index.d.ts CHANGED
@@ -1,8 +1,9 @@
1
1
  export { SharedWebSocket } from './SharedWebSocket';
2
- export { withSocket, type WithSocketCallback, type WithSocketOptions, type SocketScope } from './withSocket';
2
+ export { withSocket } from './withSocket';
3
3
  export { MessageBus } from './MessageBus';
4
4
  export { TabCoordinator } from './TabCoordinator';
5
5
  export { SharedSocket } from './SharedSocket';
6
6
  export { WorkerSocket } from './WorkerSocket';
7
7
  export { SubscriptionManager } from './SubscriptionManager';
8
- export type { SharedWebSocketOptions, SocketState, TabRole, Unsubscribe, EventHandler } from './types';
8
+ export type { WithSocketCallback, WithSocketOptions, SocketScope } from './withSocket';
9
+ export type { SharedWebSocketOptions, SocketState, TabRole, Unsubscribe, EventHandler, Channel, EventProtocol, BusMessage, SocketLifecycleHandlers, EventMap, Logger, Middleware, } from './types';
package/dist/index.js CHANGED
@@ -5,7 +5,7 @@ import {
5
5
  SubscriptionManager,
6
6
  TabCoordinator,
7
7
  WorkerSocket
8
- } from "./chunk-JJTAPRPG.js";
8
+ } from "./chunk-4D2ZDCA6.js";
9
9
 
10
10
  // src/withSocket.ts
11
11
  async function withSocket(url, optionsOrCallback, maybeCallback) {