@gwakko/shared-websocket 0.1.0

package/dist/chunk-TNEMKPGP.js.map

@@ -0,0 +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}\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'>> & { auth?: () => string | Promise<string> };\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    };\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    let connectUrl = this.url;\n    if (this.opts.auth) {\n      const token = await this.opts.auth();\n      const sep = connectUrl.includes('?') ? '&' : '?';\n      connectUrl = `${connectUrl}${sep}token=${encodeURIComponent(token)}`;\n    }\n\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({ type: 'ping' }));\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 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 } from './types';\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 * One tab becomes the \"leader\" and holds the WebSocket.\n * Other tabs are \"followers\" receiving data via BroadcastChannel.\n * If the leader closes, a new leader is elected automatically.\n */\nexport class SharedWebSocket 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\n  constructor(\n    private readonly url: string,\n    private readonly options: SharedWebSocketOptions = {},\n  ) {\n    this.tabId = generateId();\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({ event: msg.event, data: 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(() => this.onBecomeLeader());\n    this.coordinator.onLoseLeadership(() => this.onLoseLeadership());\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  /** Subscribe to server events (works in ALL tabs). */\n  on(event: string, handler: EventHandler): Unsubscribe {\n    return this.subs.on(event, handler);\n  }\n\n  once(event: string, handler: EventHandler): 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. */\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). */\n  send(event: string, data: unknown): void {\n    if (this.coordinator.isLeader && this.socket) {\n      this.socket.send({ event, data });\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  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    };\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    });\n  }\n\n  private onBecomeLeader(): void {\n    this.socket = this.createSocket();\n\n    this.socket.onMessage((data: any) => {\n      const event = data?.event ?? 'message';\n      const payload = data?.data ?? data;\n      // Broadcast to ALL tabs (including self)\n      this.bus.broadcast('ws:message', { event, data: payload });\n    });\n\n    // Handle send requests from followers (request/response pattern)\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: any) => {\n            if (response?.event === req.event || response?.requestId) {\n              unsub();\n              resolve(response?.data ?? 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 onLoseLeadership(): 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":[]}

package/dist/index.cjs

@@ -0,0 +1,46 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+
+
+
+var _chunkSMH3X34Ncjs = require('./chunk-SMH3X34N.cjs');
+
+// src/withSocket.ts
+async function withSocket(url, optionsOrCallback, maybeCallback) {
+  let options;
+  let callback;
+  if (typeof optionsOrCallback === "function") {
+    callback = optionsOrCallback;
+  } else {
+    options = optionsOrCallback;
+    callback = maybeCallback;
+  }
+  const ws = new (0, _chunkSMH3X34Ncjs.SharedWebSocket)(url, options);
+  const controller = new AbortController();
+  if (_optionalChain([options, 'optionalAccess', _ => _.signal])) {
+    if (options.signal.aborted) {
+      ws[Symbol.dispose]();
+      throw _nullishCoalesce(options.signal.reason, () => ( new Error("Aborted")));
+    }
+    options.signal.addEventListener("abort", () => controller.abort(options.signal.reason), { once: true });
+  }
+  try {
+    await ws.connect();
+    await callback({ ws, signal: controller.signal });
+  } finally {
+    controller.abort();
+    ws[Symbol.dispose]();
+  }
+}
+
+
+
+
+
+
+
+
+exports.MessageBus = _chunkSMH3X34Ncjs.MessageBus; exports.SharedSocket = _chunkSMH3X34Ncjs.SharedSocket; exports.SharedWebSocket = _chunkSMH3X34Ncjs.SharedWebSocket; exports.SubscriptionManager = _chunkSMH3X34Ncjs.SubscriptionManager; exports.TabCoordinator = _chunkSMH3X34Ncjs.TabCoordinator; exports.WorkerSocket = _chunkSMH3X34Ncjs.WorkerSocket; exports.withSocket = withSocket;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/gwakko/Projects/shared-websocket/dist/index.cjs","../src/withSocket.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACA;AC2CA,MAAA,SAAsB,UAAA,CACpB,GAAA,EACA,iBAAA,EACA,aAAA,EACe;AACf,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI,QAAA;AAEJ,EAAA,GAAA,CAAI,OAAO,kBAAA,IAAsB,UAAA,EAAY;AAC3C,IAAA,SAAA,EAAW,iBAAA;AAAA,EACb,EAAA,KAAO;AACL,IAAA,QAAA,EAAU,iBAAA;AACV,IAAA,SAAA,EAAW,aAAA;AAAA,EACb;AAEA,EAAA,MAAM,GAAA,EAAK,IAAI,sCAAA,CAAgB,GAAA,EAAK,OAAO,CAAA;AAC3C,EAAA,MAAM,WAAA,EAAa,IAAI,eAAA,CAAgB,CAAA;AAGvC,EAAA,GAAA,iBAAI,OAAA,2BAAS,QAAA,EAAQ;AACnB,IAAA,GAAA,CAAI,OAAA,CAAQ,MAAA,CAAO,OAAA,EAAS;AAC1B,MAAA,EAAA,CAAG,MAAA,CAAO,OAAO,CAAA,CAAE,CAAA;AACnB,MAAA,uBAAM,OAAA,CAAQ,MAAA,CAAO,MAAA,UAAU,IAAI,KAAA,CAAM,SAAS,GAAA;AAAA,IACpD;AACA,IAAA,OAAA,CAAQ,MAAA,CAAO,gBAAA,CAAiB,OAAA,EAAS,CAAA,EAAA,GAAM,UAAA,CAAW,KAAA,CAAM,OAAA,CAAS,MAAA,CAAQ,MAAM,CAAA,EAAG,EAAE,IAAA,EAAM,KAAK,CAAC,CAAA;AAAA,EAC1G;AAEA,EAAA,IAAI;AACF,IAAA,MAAM,EAAA,CAAG,OAAA,CAAQ,CAAA;AACjB,IAAA,MAAM,QAAA,CAAS,EAAE,EAAA,EAAI,MAAA,EAAQ,UAAA,CAAW,OAAO,CAAC,CAAA;AAAA,EAClD,EAAA,QAAE;AACA,IAAA,UAAA,CAAW,KAAA,CAAM,CAAA;AACjB,IAAA,EAAA,CAAG,MAAA,CAAO,OAAO,CAAA,CAAE,CAAA;AAAA,EACrB;AACF;ADlDA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,8XAAC","file":"/Users/gwakko/Projects/shared-websocket/dist/index.cjs","sourcesContent":[null,"import { SharedWebSocket } from './SharedWebSocket';\nimport type { SharedWebSocketOptions } from './types';\n\n/**\n * Callback context — destructure what you need.\n */\nexport interface SocketScope {\n  /** The SharedWebSocket instance. */\n  ws: SharedWebSocket;\n  /** AbortSignal — aborted when scope exits (use with stream/fetch). */\n  signal: AbortSignal;\n}\n\nexport interface WithSocketOptions extends SharedWebSocketOptions {\n  /** External AbortSignal — aborts the scope and disposes the socket. */\n  signal?: AbortSignal;\n}\n\n/**\n * Scoped WebSocket lifecycle — creates, connects, and auto-disposes.\n * Guarantees cleanup even on errors. No polyfills needed.\n *\n * @example\n * // Basic — destructure { ws }\n * await withSocket('wss://api.example.com/ws', async ({ ws }) => {\n *   ws.on('order.created', (order) => console.log(order));\n *   await longRunningWork();\n * });\n *\n * @example\n * // With auth and signal\n * await withSocket('wss://api.example.com/ws', {\n *   auth: () => localStorage.getItem('token')!,\n * }, async ({ ws, signal }) => {\n *   for await (const msg of ws.stream('chat.messages', signal)) {\n *     renderMessage(msg);\n *   }\n * });\n *\n * @example\n * // External cancellation\n * const controller = new AbortController();\n * setTimeout(() => controller.abort(), 30_000);\n *\n * await withSocket('wss://api.example.com/ws', {\n *   signal: controller.signal,\n * }, async ({ ws, signal }) => {\n *   ws.on('notifications', (n) => showToast(n));\n *   // Stays alive until controller aborts or scope exits\n *   await new Promise((_, reject) => signal.addEventListener('abort', reject));\n * });\n */\nexport async function withSocket(\n  url: string,\n  optionsOrCallback: WithSocketOptions | WithSocketCallback,\n  maybeCallback?: WithSocketCallback,\n): Promise<void> {\n  let options: WithSocketOptions | undefined;\n  let callback: WithSocketCallback;\n\n  if (typeof optionsOrCallback === 'function') {\n    callback = optionsOrCallback;\n  } else {\n    options = optionsOrCallback;\n    callback = maybeCallback!;\n  }\n\n  const ws = new SharedWebSocket(url, options);\n  const controller = new AbortController();\n\n  // Link external signal\n  if (options?.signal) {\n    if (options.signal.aborted) {\n      ws[Symbol.dispose]();\n      throw options.signal.reason ?? new Error('Aborted');\n    }\n    options.signal.addEventListener('abort', () => controller.abort(options!.signal!.reason), { once: true });\n  }\n\n  try {\n    await ws.connect();\n    await callback({ ws, signal: controller.signal });\n  } finally {\n    controller.abort();\n    ws[Symbol.dispose]();\n  }\n}\n\nexport type WithSocketCallback = (scope: SocketScope) => void | Promise<void>;\n"]}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { SharedWebSocket } from './SharedWebSocket';
+export { withSocket, type WithSocketCallback, type WithSocketOptions, type SocketScope } from './withSocket';
+export { MessageBus } from './MessageBus';
+export { TabCoordinator } from './TabCoordinator';
+export { SharedSocket } from './SharedSocket';
+export { WorkerSocket } from './WorkerSocket';
+export { SubscriptionManager } from './SubscriptionManager';
+export type { SharedWebSocketOptions, SocketState, TabRole, Unsubscribe, EventHandler } from './types';

package/dist/index.js

@@ -0,0 +1,46 @@
+import {
+  MessageBus,
+  SharedSocket,
+  SharedWebSocket,
+  SubscriptionManager,
+  TabCoordinator,
+  WorkerSocket
+} from "./chunk-TNEMKPGP.js";
+
+// src/withSocket.ts
+async function withSocket(url, optionsOrCallback, maybeCallback) {
+  let options;
+  let callback;
+  if (typeof optionsOrCallback === "function") {
+    callback = optionsOrCallback;
+  } else {
+    options = optionsOrCallback;
+    callback = maybeCallback;
+  }
+  const ws = new SharedWebSocket(url, options);
+  const controller = new AbortController();
+  if (options?.signal) {
+    if (options.signal.aborted) {
+      ws[Symbol.dispose]();
+      throw options.signal.reason ?? new Error("Aborted");
+    }
+    options.signal.addEventListener("abort", () => controller.abort(options.signal.reason), { once: true });
+  }
+  try {
+    await ws.connect();
+    await callback({ ws, signal: controller.signal });
+  } finally {
+    controller.abort();
+    ws[Symbol.dispose]();
+  }
+}
+export {
+  MessageBus,
+  SharedSocket,
+  SharedWebSocket,
+  SubscriptionManager,
+  TabCoordinator,
+  WorkerSocket,
+  withSocket
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/withSocket.ts"],"sourcesContent":["import { SharedWebSocket } from './SharedWebSocket';\nimport type { SharedWebSocketOptions } from './types';\n\n/**\n * Callback context — destructure what you need.\n */\nexport interface SocketScope {\n  /** The SharedWebSocket instance. */\n  ws: SharedWebSocket;\n  /** AbortSignal — aborted when scope exits (use with stream/fetch). */\n  signal: AbortSignal;\n}\n\nexport interface WithSocketOptions extends SharedWebSocketOptions {\n  /** External AbortSignal — aborts the scope and disposes the socket. */\n  signal?: AbortSignal;\n}\n\n/**\n * Scoped WebSocket lifecycle — creates, connects, and auto-disposes.\n * Guarantees cleanup even on errors. No polyfills needed.\n *\n * @example\n * // Basic — destructure { ws }\n * await withSocket('wss://api.example.com/ws', async ({ ws }) => {\n *   ws.on('order.created', (order) => console.log(order));\n *   await longRunningWork();\n * });\n *\n * @example\n * // With auth and signal\n * await withSocket('wss://api.example.com/ws', {\n *   auth: () => localStorage.getItem('token')!,\n * }, async ({ ws, signal }) => {\n *   for await (const msg of ws.stream('chat.messages', signal)) {\n *     renderMessage(msg);\n *   }\n * });\n *\n * @example\n * // External cancellation\n * const controller = new AbortController();\n * setTimeout(() => controller.abort(), 30_000);\n *\n * await withSocket('wss://api.example.com/ws', {\n *   signal: controller.signal,\n * }, async ({ ws, signal }) => {\n *   ws.on('notifications', (n) => showToast(n));\n *   // Stays alive until controller aborts or scope exits\n *   await new Promise((_, reject) => signal.addEventListener('abort', reject));\n * });\n */\nexport async function withSocket(\n  url: string,\n  optionsOrCallback: WithSocketOptions | WithSocketCallback,\n  maybeCallback?: WithSocketCallback,\n): Promise<void> {\n  let options: WithSocketOptions | undefined;\n  let callback: WithSocketCallback;\n\n  if (typeof optionsOrCallback === 'function') {\n    callback = optionsOrCallback;\n  } else {\n    options = optionsOrCallback;\n    callback = maybeCallback!;\n  }\n\n  const ws = new SharedWebSocket(url, options);\n  const controller = new AbortController();\n\n  // Link external signal\n  if (options?.signal) {\n    if (options.signal.aborted) {\n      ws[Symbol.dispose]();\n      throw options.signal.reason ?? new Error('Aborted');\n    }\n    options.signal.addEventListener('abort', () => controller.abort(options!.signal!.reason), { once: true });\n  }\n\n  try {\n    await ws.connect();\n    await callback({ ws, signal: controller.signal });\n  } finally {\n    controller.abort();\n    ws[Symbol.dispose]();\n  }\n}\n\nexport type WithSocketCallback = (scope: SocketScope) => void | Promise<void>;\n"],"mappings":";;;;;;;;;;AAoDA,eAAsB,WACpB,KACA,mBACA,eACe;AACf,MAAI;AACJ,MAAI;AAEJ,MAAI,OAAO,sBAAsB,YAAY;AAC3C,eAAW;AAAA,EACb,OAAO;AACL,cAAU;AACV,eAAW;AAAA,EACb;AAEA,QAAM,KAAK,IAAI,gBAAgB,KAAK,OAAO;AAC3C,QAAM,aAAa,IAAI,gBAAgB;AAGvC,MAAI,SAAS,QAAQ;AACnB,QAAI,QAAQ,OAAO,SAAS;AAC1B,SAAG,OAAO,OAAO,EAAE;AACnB,YAAM,QAAQ,OAAO,UAAU,IAAI,MAAM,SAAS;AAAA,IACpD;AACA,YAAQ,OAAO,iBAAiB,SAAS,MAAM,WAAW,MAAM,QAAS,OAAQ,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;AAAA,EAC1G;AAEA,MAAI;AACF,UAAM,GAAG,QAAQ;AACjB,UAAM,SAAS,EAAE,IAAI,QAAQ,WAAW,OAAO,CAAC;AAAA,EAClD,UAAE;AACA,eAAW,MAAM;AACjB,OAAG,OAAO,OAAO,EAAE;AAAA,EACrB;AACF;","names":[]}

package/dist/react.cjs

@@ -0,0 +1,100 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkSMH3X34Ncjs = require('./chunk-SMH3X34N.cjs');
+
+// src/adapters/react.ts
+
+
+
+
+
+
+
+var _react = require('react');
+var SharedWSContext = _react.createContext.call(void 0, null);
+function SharedWebSocketProvider({ url, options, children }) {
+  const [socket] = _react.useState.call(void 0, () => {
+    const ws = new (0, _chunkSMH3X34Ncjs.SharedWebSocket)(url, options);
+    ws.connect();
+    return ws;
+  });
+  _react.useEffect.call(void 0, () => {
+    return () => {
+      socket[Symbol.dispose]();
+    };
+  }, [socket]);
+  return _react.createElement.call(void 0, SharedWSContext.Provider, { value: socket }, children);
+}
+function useSharedWebSocket() {
+  const ctx = _react.useContext.call(void 0, SharedWSContext);
+  if (!ctx) {
+    throw new Error("useSharedWebSocket must be used within <SharedWebSocketProvider>");
+  }
+  return ctx;
+}
+function useSocketEvent(event) {
+  const socket = useSharedWebSocket();
+  const [value, setValue] = _react.useState.call(void 0, void 0);
+  const onEvent = _react.useEffectEvent.call(void 0, (data) => {
+    setValue(data);
+  });
+  _react.useEffect.call(void 0, () => {
+    const unsub = socket.on(event, onEvent);
+    return unsub;
+  }, [socket, event]);
+  return value;
+}
+function useSocketStream(event) {
+  const socket = useSharedWebSocket();
+  const [items, setItems] = _react.useState.call(void 0, []);
+  const onEvent = _react.useEffectEvent.call(void 0, (data) => {
+    setItems((prev) => [...prev, data]);
+  });
+  _react.useEffect.call(void 0, () => {
+    setItems([]);
+    const unsub = socket.on(event, onEvent);
+    return unsub;
+  }, [socket, event]);
+  return items;
+}
+function useSocketSync(key, initialValue) {
+  const socket = useSharedWebSocket();
+  const [value, setValue] = _react.useState.call(void 0, () => {
+    return _nullishCoalesce(socket.getSync(key), () => ( initialValue));
+  });
+  const onSync = _react.useEffectEvent.call(void 0, (synced) => {
+    setValue(synced);
+  });
+  _react.useEffect.call(void 0, () => {
+    const unsub = socket.onSync(key, onSync);
+    return unsub;
+  }, [socket, key]);
+  const setAndSync = _react.useEffectEvent.call(void 0, (newValue) => {
+    setValue(newValue);
+    socket.sync(key, newValue);
+  });
+  return [value, setAndSync];
+}
+function useSocketStatus() {
+  const socket = useSharedWebSocket();
+  const [connected, setConnected] = _react.useState.call(void 0, socket.connected);
+  const [tabRole, setTabRole] = _react.useState.call(void 0, socket.tabRole);
+  const tick = _react.useEffectEvent.call(void 0, () => {
+    setConnected(socket.connected);
+    setTabRole(socket.tabRole);
+  });
+  _react.useEffect.call(void 0, () => {
+    const interval = setInterval(tick, 1e3);
+    return () => clearInterval(interval);
+  }, [socket]);
+  return { connected, tabRole };
+}
+
+
+
+
+
+
+
+exports.SharedWebSocketProvider = SharedWebSocketProvider; exports.useSharedWebSocket = useSharedWebSocket; exports.useSocketEvent = useSocketEvent; exports.useSocketStatus = useSocketStatus; exports.useSocketStream = useSocketStream; exports.useSocketSync = useSocketSync;
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/gwakko/Projects/shared-websocket/dist/react.cjs","../src/adapters/react.ts"],"names":[],"mappings":"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","file":"/Users/gwakko/Projects/shared-websocket/dist/react.cjs","sourcesContent":[null,"import {\n  createContext,\n  useContext,\n  useEffect,\n  useState,\n  useEffectEvent,\n  type ReactNode,\n  createElement,\n} from 'react';\nimport { SharedWebSocket } from '../SharedWebSocket';\nimport type { SharedWebSocketOptions, TabRole } from '../types';\n\n// ─── Context ─────────────────────────────────────────────\n\nconst SharedWSContext = createContext<SharedWebSocket | null>(null);\n\n/**\n * Provider props — pass URL and options as props for flexibility.\n *\n * @example\n * <SharedWebSocketProvider url=\"wss://api.example.com/ws\" options={{ auth: getToken }}>\n *   <App />\n * </SharedWebSocketProvider>\n */\nexport interface SharedWebSocketProviderProps {\n  url: string;\n  options?: SharedWebSocketOptions;\n  children: ReactNode;\n}\n\n/**\n * Provider component — creates SharedWebSocket from props, auto-disposes on unmount.\n *\n * @example\n * function App() {\n *   return (\n *     <SharedWebSocketProvider\n *       url=\"wss://api.example.com/ws\"\n *       options={{\n *         auth: () => localStorage.getItem('token')!,\n *         useWorker: true,\n *       }}\n *     >\n *       <Dashboard />\n *     </SharedWebSocketProvider>\n *   );\n * }\n */\nexport function SharedWebSocketProvider({ url, options, children }: SharedWebSocketProviderProps) {\n  const [socket] = useState(() => {\n    const ws = new SharedWebSocket(url, options);\n    ws.connect();\n    return ws;\n  });\n\n  useEffect(() => {\n    return () => {\n      socket[Symbol.dispose]();\n    };\n  }, [socket]);\n\n  return createElement(SharedWSContext.Provider, { value: socket }, children);\n}\n\n/**\n * Access the SharedWebSocket instance from context.\n *\n * @example\n * const ws = useSharedWebSocket();\n * ws.send('chat.message', { text: 'Hello' });\n */\nexport function useSharedWebSocket(): SharedWebSocket {\n  const ctx = useContext(SharedWSContext);\n  if (!ctx) {\n    throw new Error('useSharedWebSocket must be used within <SharedWebSocketProvider>');\n  }\n  return ctx;\n}\n\n// ─── Hooks ───────────────────────────────────────────────\n\n/**\n * Subscribe to a WebSocket event. Returns the latest received value.\n * Uses useEffectEvent for a stable callback ref — no stale closures.\n *\n * @example\n * const order = useSocketEvent<Order>('order.created');\n */\nexport function useSocketEvent<T>(event: string): T | undefined {\n  const socket = useSharedWebSocket();\n  const [value, setValue] = useState<T | undefined>(undefined);\n\n  const onEvent = useEffectEvent((data: T) => {\n    setValue(data);\n  });\n\n  useEffect(() => {\n    const unsub = socket.on(event, onEvent);\n    return unsub;\n  }, [socket, event]);\n\n  return value;\n}\n\n/**\n * Accumulate WebSocket events into an array.\n * Uses useEffectEvent — handler always sees latest state without re-subscribing.\n *\n * @example\n * const messages = useSocketStream<ChatMessage>('chat.message');\n */\nexport function useSocketStream<T>(event: string): T[] {\n  const socket = useSharedWebSocket();\n  const [items, setItems] = useState<T[]>([]);\n\n  const onEvent = useEffectEvent((data: T) => {\n    setItems((prev) => [...prev, data]);\n  });\n\n  useEffect(() => {\n    setItems([]);\n    const unsub = socket.on(event, onEvent);\n    return unsub;\n  }, [socket, event]);\n\n  return items;\n}\n\n/**\n * Two-way state sync across browser tabs.\n * Uses useEffectEvent for stable sync callback.\n *\n * @example\n * const [cart, setCart] = useSocketSync<Cart>('cart', { items: [] });\n * // setCart in one tab → updates all tabs instantly\n */\nexport function useSocketSync<T>(\n  key: string,\n  initialValue: T,\n): [T, (value: T) => void] {\n  const socket = useSharedWebSocket();\n  const [value, setValue] = useState<T>(() => {\n    return socket.getSync<T>(key) ?? initialValue;\n  });\n\n  const onSync = useEffectEvent((synced: T) => {\n    setValue(synced);\n  });\n\n  useEffect(() => {\n    const unsub = socket.onSync<T>(key, onSync);\n    return unsub;\n  }, [socket, key]);\n\n  const setAndSync = useEffectEvent((newValue: T) => {\n    setValue(newValue);\n    socket.sync(key, newValue);\n  });\n\n  return [value, setAndSync];\n}\n\n/**\n * Reactive connection status.\n * Uses useEffectEvent to avoid re-creating interval on state change.\n *\n * @example\n * const { connected, tabRole } = useSocketStatus();\n */\nexport function useSocketStatus(): {\n  connected: boolean;\n  tabRole: TabRole;\n} {\n  const socket = useSharedWebSocket();\n  const [connected, setConnected] = useState(socket.connected);\n  const [tabRole, setTabRole] = useState<TabRole>(socket.tabRole);\n\n  const tick = useEffectEvent(() => {\n    setConnected(socket.connected);\n    setTabRole(socket.tabRole);\n  });\n\n  useEffect(() => {\n    const interval = setInterval(tick, 1000);\n    return () => clearInterval(interval);\n  }, [socket]);\n\n  return { connected, tabRole };\n}\n"]}

package/dist/react.js

@@ -0,0 +1,100 @@
+import {
+  SharedWebSocket
+} from "./chunk-TNEMKPGP.js";
+
+// src/adapters/react.ts
+import {
+  createContext,
+  useContext,
+  useEffect,
+  useState,
+  useEffectEvent,
+  createElement
+} from "react";
+var SharedWSContext = createContext(null);
+function SharedWebSocketProvider({ url, options, children }) {
+  const [socket] = useState(() => {
+    const ws = new SharedWebSocket(url, options);
+    ws.connect();
+    return ws;
+  });
+  useEffect(() => {
+    return () => {
+      socket[Symbol.dispose]();
+    };
+  }, [socket]);
+  return createElement(SharedWSContext.Provider, { value: socket }, children);
+}
+function useSharedWebSocket() {
+  const ctx = useContext(SharedWSContext);
+  if (!ctx) {
+    throw new Error("useSharedWebSocket must be used within <SharedWebSocketProvider>");
+  }
+  return ctx;
+}
+function useSocketEvent(event) {
+  const socket = useSharedWebSocket();
+  const [value, setValue] = useState(void 0);
+  const onEvent = useEffectEvent((data) => {
+    setValue(data);
+  });
+  useEffect(() => {
+    const unsub = socket.on(event, onEvent);
+    return unsub;
+  }, [socket, event]);
+  return value;
+}
+function useSocketStream(event) {
+  const socket = useSharedWebSocket();
+  const [items, setItems] = useState([]);
+  const onEvent = useEffectEvent((data) => {
+    setItems((prev) => [...prev, data]);
+  });
+  useEffect(() => {
+    setItems([]);
+    const unsub = socket.on(event, onEvent);
+    return unsub;
+  }, [socket, event]);
+  return items;
+}
+function useSocketSync(key, initialValue) {
+  const socket = useSharedWebSocket();
+  const [value, setValue] = useState(() => {
+    return socket.getSync(key) ?? initialValue;
+  });
+  const onSync = useEffectEvent((synced) => {
+    setValue(synced);
+  });
+  useEffect(() => {
+    const unsub = socket.onSync(key, onSync);
+    return unsub;
+  }, [socket, key]);
+  const setAndSync = useEffectEvent((newValue) => {
+    setValue(newValue);
+    socket.sync(key, newValue);
+  });
+  return [value, setAndSync];
+}
+function useSocketStatus() {
+  const socket = useSharedWebSocket();
+  const [connected, setConnected] = useState(socket.connected);
+  const [tabRole, setTabRole] = useState(socket.tabRole);
+  const tick = useEffectEvent(() => {
+    setConnected(socket.connected);
+    setTabRole(socket.tabRole);
+  });
+  useEffect(() => {
+    const interval = setInterval(tick, 1e3);
+    return () => clearInterval(interval);
+  }, [socket]);
+  return { connected, tabRole };
+}
+export {
+  SharedWebSocketProvider,
+  useSharedWebSocket,
+  useSocketEvent,
+  useSocketStatus,
+  useSocketStream,
+  useSocketSync
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/react.ts"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useEffect,\n  useState,\n  useEffectEvent,\n  type ReactNode,\n  createElement,\n} from 'react';\nimport { SharedWebSocket } from '../SharedWebSocket';\nimport type { SharedWebSocketOptions, TabRole } from '../types';\n\n// ─── Context ─────────────────────────────────────────────\n\nconst SharedWSContext = createContext<SharedWebSocket | null>(null);\n\n/**\n * Provider props — pass URL and options as props for flexibility.\n *\n * @example\n * <SharedWebSocketProvider url=\"wss://api.example.com/ws\" options={{ auth: getToken }}>\n *   <App />\n * </SharedWebSocketProvider>\n */\nexport interface SharedWebSocketProviderProps {\n  url: string;\n  options?: SharedWebSocketOptions;\n  children: ReactNode;\n}\n\n/**\n * Provider component — creates SharedWebSocket from props, auto-disposes on unmount.\n *\n * @example\n * function App() {\n *   return (\n *     <SharedWebSocketProvider\n *       url=\"wss://api.example.com/ws\"\n *       options={{\n *         auth: () => localStorage.getItem('token')!,\n *         useWorker: true,\n *       }}\n *     >\n *       <Dashboard />\n *     </SharedWebSocketProvider>\n *   );\n * }\n */\nexport function SharedWebSocketProvider({ url, options, children }: SharedWebSocketProviderProps) {\n  const [socket] = useState(() => {\n    const ws = new SharedWebSocket(url, options);\n    ws.connect();\n    return ws;\n  });\n\n  useEffect(() => {\n    return () => {\n      socket[Symbol.dispose]();\n    };\n  }, [socket]);\n\n  return createElement(SharedWSContext.Provider, { value: socket }, children);\n}\n\n/**\n * Access the SharedWebSocket instance from context.\n *\n * @example\n * const ws = useSharedWebSocket();\n * ws.send('chat.message', { text: 'Hello' });\n */\nexport function useSharedWebSocket(): SharedWebSocket {\n  const ctx = useContext(SharedWSContext);\n  if (!ctx) {\n    throw new Error('useSharedWebSocket must be used within <SharedWebSocketProvider>');\n  }\n  return ctx;\n}\n\n// ─── Hooks ───────────────────────────────────────────────\n\n/**\n * Subscribe to a WebSocket event. Returns the latest received value.\n * Uses useEffectEvent for a stable callback ref — no stale closures.\n *\n * @example\n * const order = useSocketEvent<Order>('order.created');\n */\nexport function useSocketEvent<T>(event: string): T | undefined {\n  const socket = useSharedWebSocket();\n  const [value, setValue] = useState<T | undefined>(undefined);\n\n  const onEvent = useEffectEvent((data: T) => {\n    setValue(data);\n  });\n\n  useEffect(() => {\n    const unsub = socket.on(event, onEvent);\n    return unsub;\n  }, [socket, event]);\n\n  return value;\n}\n\n/**\n * Accumulate WebSocket events into an array.\n * Uses useEffectEvent — handler always sees latest state without re-subscribing.\n *\n * @example\n * const messages = useSocketStream<ChatMessage>('chat.message');\n */\nexport function useSocketStream<T>(event: string): T[] {\n  const socket = useSharedWebSocket();\n  const [items, setItems] = useState<T[]>([]);\n\n  const onEvent = useEffectEvent((data: T) => {\n    setItems((prev) => [...prev, data]);\n  });\n\n  useEffect(() => {\n    setItems([]);\n    const unsub = socket.on(event, onEvent);\n    return unsub;\n  }, [socket, event]);\n\n  return items;\n}\n\n/**\n * Two-way state sync across browser tabs.\n * Uses useEffectEvent for stable sync callback.\n *\n * @example\n * const [cart, setCart] = useSocketSync<Cart>('cart', { items: [] });\n * // setCart in one tab → updates all tabs instantly\n */\nexport function useSocketSync<T>(\n  key: string,\n  initialValue: T,\n): [T, (value: T) => void] {\n  const socket = useSharedWebSocket();\n  const [value, setValue] = useState<T>(() => {\n    return socket.getSync<T>(key) ?? initialValue;\n  });\n\n  const onSync = useEffectEvent((synced: T) => {\n    setValue(synced);\n  });\n\n  useEffect(() => {\n    const unsub = socket.onSync<T>(key, onSync);\n    return unsub;\n  }, [socket, key]);\n\n  const setAndSync = useEffectEvent((newValue: T) => {\n    setValue(newValue);\n    socket.sync(key, newValue);\n  });\n\n  return [value, setAndSync];\n}\n\n/**\n * Reactive connection status.\n * Uses useEffectEvent to avoid re-creating interval on state change.\n *\n * @example\n * const { connected, tabRole } = useSocketStatus();\n */\nexport function useSocketStatus(): {\n  connected: boolean;\n  tabRole: TabRole;\n} {\n  const socket = useSharedWebSocket();\n  const [connected, setConnected] = useState(socket.connected);\n  const [tabRole, setTabRole] = useState<TabRole>(socket.tabRole);\n\n  const tick = useEffectEvent(() => {\n    setConnected(socket.connected);\n    setTabRole(socket.tabRole);\n  });\n\n  useEffect(() => {\n    const interval = setInterval(tick, 1000);\n    return () => clearInterval(interval);\n  }, [socket]);\n\n  return { connected, tabRole };\n}\n"],"mappings":";;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,OACK;AAMP,IAAM,kBAAkB,cAAsC,IAAI;AAkC3D,SAAS,wBAAwB,EAAE,KAAK,SAAS,SAAS,GAAiC;AAChG,QAAM,CAAC,MAAM,IAAI,SAAS,MAAM;AAC9B,UAAM,KAAK,IAAI,gBAAgB,KAAK,OAAO;AAC3C,OAAG,QAAQ;AACX,WAAO;AAAA,EACT,CAAC;AAED,YAAU,MAAM;AACd,WAAO,MAAM;AACX,aAAO,OAAO,OAAO,EAAE;AAAA,IACzB;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEX,SAAO,cAAc,gBAAgB,UAAU,EAAE,OAAO,OAAO,GAAG,QAAQ;AAC5E;AASO,SAAS,qBAAsC;AACpD,QAAM,MAAM,WAAW,eAAe;AACtC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;AAWO,SAAS,eAAkB,OAA8B;AAC9D,QAAM,SAAS,mBAAmB;AAClC,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,MAAS;AAE3D,QAAM,UAAU,eAAe,CAAC,SAAY;AAC1C,aAAS,IAAI;AAAA,EACf,CAAC;AAED,YAAU,MAAM;AACd,UAAM,QAAQ,OAAO,GAAG,OAAO,OAAO;AACtC,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,KAAK,CAAC;AAElB,SAAO;AACT;AASO,SAAS,gBAAmB,OAAoB;AACrD,QAAM,SAAS,mBAAmB;AAClC,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAc,CAAC,CAAC;AAE1C,QAAM,UAAU,eAAe,CAAC,SAAY;AAC1C,aAAS,CAAC,SAAS,CAAC,GAAG,MAAM,IAAI,CAAC;AAAA,EACpC,CAAC;AAED,YAAU,MAAM;AACd,aAAS,CAAC,CAAC;AACX,UAAM,QAAQ,OAAO,GAAG,OAAO,OAAO;AACtC,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,KAAK,CAAC;AAElB,SAAO;AACT;AAUO,SAAS,cACd,KACA,cACyB;AACzB,QAAM,SAAS,mBAAmB;AAClC,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAY,MAAM;AAC1C,WAAO,OAAO,QAAW,GAAG,KAAK;AAAA,EACnC,CAAC;AAED,QAAM,SAAS,eAAe,CAAC,WAAc;AAC3C,aAAS,MAAM;AAAA,EACjB,CAAC;AAED,YAAU,MAAM;AACd,UAAM,QAAQ,OAAO,OAAU,KAAK,MAAM;AAC1C,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,GAAG,CAAC;AAEhB,QAAM,aAAa,eAAe,CAAC,aAAgB;AACjD,aAAS,QAAQ;AACjB,WAAO,KAAK,KAAK,QAAQ;AAAA,EAC3B,CAAC;AAED,SAAO,CAAC,OAAO,UAAU;AAC3B;AASO,SAAS,kBAGd;AACA,QAAM,SAAS,mBAAmB;AAClC,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,OAAO,SAAS;AAC3D,QAAM,CAAC,SAAS,UAAU,IAAI,SAAkB,OAAO,OAAO;AAE9D,QAAM,OAAO,eAAe,MAAM;AAChC,iBAAa,OAAO,SAAS;AAC7B,eAAW,OAAO,OAAO;AAAA,EAC3B,CAAC;AAED,YAAU,MAAM;AACd,UAAM,WAAW,YAAY,MAAM,GAAI;AACvC,WAAO,MAAM,cAAc,QAAQ;AAAA,EACrC,GAAG,CAAC,MAAM,CAAC;AAEX,SAAO,EAAE,WAAW,QAAQ;AAC9B;","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+export type SocketState = 'connecting' | 'connected' | 'reconnecting' | 'closed';
+export type TabRole = 'leader' | 'follower';
+export type Unsubscribe = () => void;
+export type EventHandler = (data: any) => void;
+export interface BusMessage {
+    id: string;
+    source: string;
+    topic: string;
+    type: 'publish' | 'request' | 'response' | 'broadcast';
+    data: unknown;
+    timestamp: number;
+}
+export interface SharedWebSocketOptions {
+    protocols?: string[];
+    reconnect?: boolean;
+    reconnectMaxDelay?: number;
+    heartbeatInterval?: number;
+    electionTimeout?: number;
+    leaderHeartbeat?: number;
+    leaderTimeout?: number;
+    sendBuffer?: number;
+    auth?: () => string | Promise<string>;
+    /** Run WebSocket inside a Web Worker (offloads JSON parsing, heartbeat from main thread). */
+    useWorker?: boolean;
+    /** Custom worker URL (if useWorker is true and you want to provide your own worker file). */
+    workerUrl?: string | URL;
+}

package/dist/utils/backoff.d.ts

@@ -0,0 +1,2 @@
+/** Exponential backoff generator with jitter. */
+export declare function backoff(base?: number, max?: number): Generator<number>;

package/dist/utils/id.d.ts

@@ -0,0 +1 @@
+export declare function generateId(): string;

package/dist/vue.cjs

@@ -0,0 +1,93 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkSMH3X34Ncjs = require('./chunk-SMH3X34N.cjs');
+
+// src/adapters/vue.ts
+
+
+
+
+
+
+var _vue = require('vue');
+var SharedWebSocketKey = /* @__PURE__ */ Symbol("SharedWebSocket");
+function createSharedWebSocketPlugin(url, options) {
+  return {
+    install(app) {
+      const socket = new (0, _chunkSMH3X34Ncjs.SharedWebSocket)(url, options);
+      socket.connect();
+      app.provide(SharedWebSocketKey, socket);
+      const originalUnmount = app.unmount.bind(app);
+      app.unmount = () => {
+        socket[Symbol.dispose]();
+        originalUnmount();
+      };
+    }
+  };
+}
+function useSharedWebSocket() {
+  const socket = _vue.inject.call(void 0, SharedWebSocketKey);
+  if (!socket) {
+    throw new Error("useSharedWebSocket: SharedWebSocket not provided. Did you install the plugin?");
+  }
+  return socket;
+}
+function useSocketEvent(event) {
+  const socket = useSharedWebSocket();
+  const value = _vue.ref.call(void 0, void 0);
+  const unsub = socket.on(event, (data) => {
+    value.value = data;
+  });
+  _vue.onUnmounted.call(void 0, unsub);
+  return _vue.readonly.call(void 0, value);
+}
+function useSocketStream(event) {
+  const socket = useSharedWebSocket();
+  const items = _vue.ref.call(void 0, []);
+  const unsub = socket.on(event, (data) => {
+    items.value = [...items.value, data];
+  });
+  _vue.onUnmounted.call(void 0, unsub);
+  return _vue.readonly.call(void 0, items);
+}
+function useSocketSync(key, initialValue) {
+  const socket = useSharedWebSocket();
+  const value = _vue.ref.call(void 0, _nullishCoalesce(socket.getSync(key), () => ( initialValue)));
+  const unsub = socket.onSync(key, (v) => {
+    value.value = v;
+  });
+  _vue.watch.call(void 0, 
+    value,
+    (newVal) => {
+      socket.sync(key, newVal);
+    },
+    { deep: true }
+  );
+  _vue.onUnmounted.call(void 0, unsub);
+  return value;
+}
+function useSocketStatus() {
+  const socket = useSharedWebSocket();
+  const connected = _vue.ref.call(void 0, socket.connected);
+  const tabRole = _vue.ref.call(void 0, socket.tabRole);
+  let timer;
+  timer = setInterval(() => {
+    connected.value = socket.connected;
+    tabRole.value = socket.tabRole;
+  }, 1e3);
+  _vue.onUnmounted.call(void 0, () => clearInterval(timer));
+  return {
+    connected: _vue.readonly.call(void 0, connected),
+    tabRole: _vue.readonly.call(void 0, tabRole)
+  };
+}
+
+
+
+
+
+
+
+
+exports.SharedWebSocketKey = SharedWebSocketKey; exports.createSharedWebSocketPlugin = createSharedWebSocketPlugin; exports.useSharedWebSocket = useSharedWebSocket; exports.useSocketEvent = useSocketEvent; exports.useSocketStatus = useSocketStatus; exports.useSocketStream = useSocketStream; exports.useSocketSync = useSocketSync;
+//# sourceMappingURL=vue.cjs.map

package/dist/vue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/gwakko/Projects/shared-websocket/dist/vue.cjs","../src/adapters/vue.ts"],"names":[],"mappings":"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","file":"/Users/gwakko/Projects/shared-websocket/dist/vue.cjs","sourcesContent":[null,"import {\n  ref,\n  onUnmounted,\n  inject,\n  readonly,\n  watch,\n  type Ref,\n  type InjectionKey,\n  type App,\n} from 'vue';\nimport { SharedWebSocket } from '../SharedWebSocket';\nimport type { SharedWebSocketOptions, TabRole } from '../types';\n\n// ─── Plugin ──────────────────────────────────────────────\n\nexport const SharedWebSocketKey: InjectionKey<SharedWebSocket> = Symbol('SharedWebSocket');\n\n/**\n * Vue 3 plugin for SharedWebSocket.\n *\n * @example\n * const app = createApp(App);\n * app.use(createSharedWebSocketPlugin('wss://api.example.com/ws'));\n */\nexport function createSharedWebSocketPlugin(url: string, options?: SharedWebSocketOptions) {\n  return {\n    install(app: App) {\n      const socket = new SharedWebSocket(url, options);\n      socket.connect();\n      app.provide(SharedWebSocketKey, socket);\n\n      // Cleanup on app unmount\n      const originalUnmount = app.unmount.bind(app);\n      app.unmount = () => {\n        socket[Symbol.dispose]();\n        originalUnmount();\n      };\n    },\n  };\n}\n\n/**\n * Access the SharedWebSocket instance from provided context.\n *\n * @example\n * const ws = useSharedWebSocket();\n */\nexport function useSharedWebSocket(): SharedWebSocket {\n  const socket = inject(SharedWebSocketKey);\n  if (!socket) {\n    throw new Error('useSharedWebSocket: SharedWebSocket not provided. Did you install the plugin?');\n  }\n  return socket;\n}\n\n// ─── Composables ─────────────────────────────────────────\n\n/**\n * Subscribe to a WebSocket event. Returns reactive ref with latest value.\n *\n * @example\n * const order = useSocketEvent<Order>('order.created');\n */\nexport function useSocketEvent<T>(event: string): Ref<T | undefined> {\n  const socket = useSharedWebSocket();\n  const value = ref<T | undefined>(undefined) as Ref<T | undefined>;\n\n  const unsub = socket.on(event, (data: T) => {\n    value.value = data;\n  });\n\n  onUnmounted(unsub);\n  return readonly(value) as Ref<T | undefined>;\n}\n\n/**\n * Accumulate WebSocket events into reactive array.\n *\n * @example\n * const messages = useSocketStream<ChatMessage>('chat.message');\n */\nexport function useSocketStream<T>(event: string): Ref<T[]> {\n  const socket = useSharedWebSocket();\n  const items = ref<T[]>([]) as Ref<T[]>;\n\n  const unsub = socket.on(event, (data: T) => {\n    items.value = [...items.value, data];\n  });\n\n  onUnmounted(unsub);\n  return readonly(items) as Ref<T[]>;\n}\n\n/**\n * Two-way state sync across browser tabs via reactive ref.\n *\n * @example\n * const cart = useSocketSync<Cart>('cart', { items: [] });\n * cart.value = { items: [1, 2, 3] }; // syncs to all tabs\n */\nexport function useSocketSync<T>(key: string, initialValue: T): Ref<T> {\n  const socket = useSharedWebSocket();\n  const value = ref<T>(socket.getSync<T>(key) ?? initialValue) as Ref<T>;\n\n  const unsub = socket.onSync<T>(key, (v) => {\n    value.value = v;\n  });\n\n  // Watch for local changes → sync to other tabs\n  watch(\n    value,\n    (newVal) => {\n      socket.sync(key, newVal);\n    },\n    { deep: true },\n  );\n\n  onUnmounted(unsub);\n  return value;\n}\n\n/**\n * Reactive connection status.\n *\n * @example\n * const { connected, tabRole } = useSocketStatus();\n */\nexport function useSocketStatus(): {\n  connected: Ref<boolean>;\n  tabRole: Ref<TabRole>;\n} {\n  const socket = useSharedWebSocket();\n  const connected = ref(socket.connected);\n  const tabRole = ref<TabRole>(socket.tabRole);\n\n  let timer: ReturnType<typeof setInterval>;\n\n  timer = setInterval(() => {\n    connected.value = socket.connected;\n    tabRole.value = socket.tabRole;\n  }, 1000);\n\n  onUnmounted(() => clearInterval(timer));\n\n  return {\n    connected: readonly(connected) as Ref<boolean>,\n    tabRole: readonly(tabRole) as Ref<TabRole>,\n  };\n}\n"]}