@rlanz/socket 0.0.1-0 → 0.0.1-10

package/build/src/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/client/channel.ts","../../../src/client/socket_session.ts","../../../src/client/socket.ts"],"sourcesContent":["import type {\n  SocketClientTransport,\n  SubscribeOptions,\n  SubscribeResult,\n  UnsubscribeOptions,\n  PresenceData,\n  PresenceUser,\n  EventHandler,\n  ChannelMessage,\n  ChannelAck,\n} from './types.js'\n\ninterface PendingSubscribe {\n  promise: Promise<Channel>\n  resolve: (channel: Channel) => void\n  reject: (error: Error) => void\n  token: number\n}\n\n/**\n * Represents a subscribed channel.\n * Chainable API inspired by Laravel Echo.\n *\n * @example\n * ```ts\n * socket.channel('chat/general')\n *   .here((users) => setOnlineUsers(users))\n *   .joining((user) => console.log(`${user.name} joined`))\n *   .leaving((user) => console.log(`${user.name} left`))\n *   .listen('chat:message', (msg) => addMessage(msg))\n *   .subscribe()\n * ```\n */\nexport class Channel {\n  /**\n   * Channel name.\n   */\n  readonly name: string\n\n  /**\n   * Socket client transport.\n   */\n  #transport: SocketClientTransport\n\n  /**\n   * Whether the channel should stay subscribed.\n   */\n  #subscribed = false\n  #active = false\n\n  /**\n   * Event handlers grouped by event type.\n   */\n  #eventHandlers = new Map<string, Set<EventHandler>>()\n\n  /**\n   * Current presence data.\n   */\n  #presence: PresenceData | null = null\n\n  /**\n   * Present user IDs used to detect join and leave events.\n   */\n  #presentUserIds = new Set<string>()\n\n  /**\n   * Handler registered through .here().\n   */\n  #hereHandler: EventHandler<PresenceUser[]> | null = null\n\n  /**\n   * Handler registered through .joining().\n   */\n  #joiningHandler: EventHandler<PresenceUser> | null = null\n\n  /**\n   * Handler registered through .leaving().\n   */\n  #leavingHandler: EventHandler<PresenceUser> | null = null\n\n  /**\n   * Internal transport handlers to clean up on unsubscribe.\n   */\n  #boundPresenceHandler: ((data: unknown) => void) | null = null\n  #boundEventHandler: ((data: unknown) => void) | null = null\n  #boundDisconnectHandler: (() => void) | null = null\n  #listenersAttached = false\n  #pendingSubscribe: PendingSubscribe | null = null\n  #subscribeToken = 0\n\n  constructor(name: string, transport: SocketClientTransport) {\n    this.name = name\n    this.#transport = transport\n  }\n\n  /**\n   * Whether the channel should stay subscribed.\n   */\n  get subscribed(): boolean {\n    return this.#subscribed\n  }\n\n  /**\n   * Whether the channel is active on the server.\n   */\n  get active(): boolean {\n    return this.#active\n  }\n\n  /**\n   * List of present users.\n   */\n  get users(): PresenceUser[] {\n    return this.#presence?.users ?? []\n  }\n\n  /**\n   * Number of present users.\n   */\n  get count(): number {\n    return this.#presence?.count ?? 0\n  }\n\n  /**\n   * Registers a handler called with the present users.\n   * Called immediately on subscribe and after each presence change.\n   */\n  here(handler: EventHandler<PresenceUser[]>): this {\n    this.#hereHandler = handler\n    return this\n  }\n\n  /**\n   * Registers a handler called when a user joins.\n   */\n  joining(handler: EventHandler<PresenceUser>): this {\n    this.#joiningHandler = handler\n    return this\n  }\n\n  /**\n   * Registers a handler called when a user leaves.\n   */\n  leaving(handler: EventHandler<PresenceUser>): this {\n    this.#leavingHandler = handler\n    return this\n  }\n\n  /**\n   * Listens for an event on this channel.\n   */\n  listen<T = unknown>(event: string, handler: EventHandler<T>): this {\n    if (!this.#eventHandlers.has(event)) {\n      this.#eventHandlers.set(event, new Set())\n    }\n    this.#eventHandlers.get(event)!.add(handler as EventHandler)\n    return this\n  }\n\n  /**\n   * Removes an event listener.\n   */\n  stopListening(event: string, handler?: EventHandler): this {\n    if (handler) {\n      this.#eventHandlers.get(event)?.delete(handler)\n    } else {\n      this.#eventHandlers.delete(event)\n    }\n    return this\n  }\n\n  /**\n   * Subscribes to the channel.\n   *\n   * client listeners -> subscribe ack -> active channel\n   *        |                 |                 |\n   *        v                 v                 v\n   *     events ready     presence sync      send/listen\n   */\n  async subscribe(options: SubscribeOptions = {}): Promise<this> {\n    this.#subscribed = true\n\n    if (this.#pendingSubscribe) {\n      return this.#pendingSubscribe.promise as Promise<this>\n    }\n\n    if (this.#active) {\n      return this\n    }\n\n    const timeout = options.timeout ?? 5000\n\n    // Attach listeners before subscribing so the first server events are not missed.\n    if (!this.#listenersAttached) {\n      this.#setupSocketListeners()\n    }\n\n    const token = ++this.#subscribeToken\n\n    let resolvePromise: (channel: Channel) => void\n    let rejectPromise: (error: Error) => void\n\n    const promise = new Promise<Channel>((resolve, reject) => {\n      resolvePromise = resolve\n      rejectPromise = reject\n    })\n\n    this.#pendingSubscribe = {\n      promise,\n      resolve: resolvePromise!,\n      reject: rejectPromise!,\n      token,\n    }\n\n    const { resolve, reject } = this.#pendingSubscribe\n\n    const timer = setTimeout(() => {\n      if (token !== this.#subscribeToken) return\n      this.#pendingSubscribe = null\n      this.#resetConnectionState()\n      reject(new Error(`Subscribe timeout for channel: ${this.name}`))\n    }, timeout)\n\n    this.#transport\n      .sendRequest<SubscribeResult>({ type: 'subscribe', channel: this.name }, timeout)\n      .then((response) => {\n        if (token !== this.#subscribeToken) return\n        clearTimeout(timer)\n        this.#pendingSubscribe = null\n\n        if (response.ok) {\n          this.#active = true\n\n          const presenceData = response.data?.presenceData ?? response.presenceData\n\n          // Apply the initial presence snapshot.\n          if (presenceData) {\n            this.#handleInitialPresence(presenceData)\n          }\n\n          resolve(this)\n        } else {\n          this.#resetConnectionState()\n          reject(new Error(response.error ?? 'Subscribe failed'))\n        }\n      })\n      .catch((error) => {\n        if (token !== this.#subscribeToken) return\n        clearTimeout(timer)\n        this.#pendingSubscribe = null\n        this.#resetConnectionState()\n        reject(error instanceof Error ? error : new Error('Subscribe failed'))\n      })\n\n    return promise as Promise<this>\n  }\n\n  /**\n   * Unsubscribes from the channel.\n   */\n  async unsubscribe(options: UnsubscribeOptions = {}): Promise<void> {\n    if (!this.#subscribed && !this.#active) return\n    this.#subscribed = false\n    this.#subscribeToken++\n    if (this.#pendingSubscribe) {\n      this.#pendingSubscribe.reject(new Error(`Unsubscribed from channel: ${this.name}`))\n      this.#pendingSubscribe = null\n    }\n\n    return new Promise((resolve) => {\n      const timeout = options.timeout ?? 5000\n      const timer = setTimeout(() => {\n        this.#cleanupTerminal()\n        resolve()\n      }, timeout)\n\n      this.#transport\n        .sendRequest({ type: 'unsubscribe', channel: this.name }, timeout)\n        .then(() => {\n          clearTimeout(timer)\n          this.#cleanupTerminal()\n          resolve()\n        })\n        .catch(() => {\n          clearTimeout(timer)\n          this.#cleanupTerminal()\n          resolve()\n        })\n    })\n  }\n\n  /**\n   * Sends an event to the server.\n   */\n  send<T = unknown>(event: string, data?: T): this {\n    if (!this.#active) {\n      console.warn(`Cannot send to channel ${this.name}: not subscribed`)\n      return this\n    }\n    const payload: ChannelMessage = {\n      channel: this.name,\n      event,\n      data,\n    }\n    this.#transport.send({ type: 'message', ...payload })\n    return this\n  }\n\n  /**\n   * Sends an event and waits for a response.\n   */\n  async sendWithAck<T = unknown, R = unknown>(event: string, data?: T): Promise<R> {\n    if (!this.#active) {\n      throw new Error(`Cannot send to channel ${this.name}: not subscribed`)\n    }\n    const payload: ChannelMessage = {\n      channel: this.name,\n      event,\n      data,\n    }\n    const response = await this.#transport.sendRequest<ChannelAck<R>>({\n      type: 'message',\n      ...payload,\n    })\n    if (!response?.ok) {\n      throw new Error(response?.error ?? `Channel handler failed: ${event}`)\n    }\n    return response.data as R\n  }\n\n  /**\n   * Configures transport listeners.\n   */\n  #setupSocketListeners(): void {\n    // Handler for presence:update.\n    this.#boundPresenceHandler = (data: unknown) => {\n      if (!data || typeof data !== 'object') return\n      this.#handlePresenceUpdate(data as PresenceData)\n    }\n    this.#transport.on(`channel:${this.name}:presence:update`, this.#boundPresenceHandler)\n\n    this.#boundEventHandler = (data: unknown) => {\n      if (!data || typeof data !== 'object') return\n\n      const payload = data as { event?: string; data?: unknown }\n      if (!payload.event) return\n\n      const handlers = this.#eventHandlers.get(payload.event)\n      handlers?.forEach((handler) => handler(payload.data))\n    }\n    this.#transport.on(`channel:${this.name}:event`, this.#boundEventHandler)\n\n    // Mark the channel inactive when the socket disconnects.\n    this.#boundDisconnectHandler = () => {\n      this.#resetConnectionState()\n    }\n    this.#transport.on('disconnect', this.#boundDisconnectHandler)\n\n    this.#listenersAttached = true\n  }\n\n  /**\n   * Handles the initial presence snapshot.\n   */\n  #handleInitialPresence(data: PresenceData): void {\n    this.#presence = data\n    this.#presentUserIds = new Set(data.users.map((u) => u.id))\n\n    // Call here() with all users.\n    this.#hereHandler?.(data.users)\n  }\n\n  /**\n   * Handles a presence update.\n   *\n   * previous IDs     current IDs\n   *     |                |\n   *     +-- diff in -----+--> joining / leaving callbacks\n   */\n  #handlePresenceUpdate(data: PresenceData): void {\n    const previousIds = this.#presentUserIds\n    const currentIds = new Set(data.users.map((u) => u.id))\n\n    // Detect new users.\n    for (const user of data.users) {\n      if (!previousIds.has(user.id)) {\n        this.#joiningHandler?.(user)\n      }\n    }\n\n    // Detect users that left.\n    if (this.#presence) {\n      for (const user of this.#presence.users) {\n        if (!currentIds.has(user.id)) {\n          this.#leavingHandler?.(user)\n        }\n      }\n    }\n\n    // Update local state.\n    this.#presence = data\n    this.#presentUserIds = currentIds\n\n    // Call here() with the updated list.\n    this.#hereHandler?.(data.users)\n  }\n\n  #resetConnectionState(): void {\n    this.#active = false\n    this.#presence = null\n    this.#presentUserIds.clear()\n  }\n\n  #detachTransportListeners(): void {\n    if (this.#boundPresenceHandler) {\n      this.#transport.off(`channel:${this.name}:presence:update`, this.#boundPresenceHandler)\n      this.#boundPresenceHandler = null\n    }\n\n    if (this.#boundEventHandler) {\n      this.#transport.off(`channel:${this.name}:event`, this.#boundEventHandler)\n      this.#boundEventHandler = null\n    }\n\n    if (this.#boundDisconnectHandler) {\n      this.#transport.off('disconnect', this.#boundDisconnectHandler)\n      this.#boundDisconnectHandler = null\n    }\n\n    this.#listenersAttached = false\n  }\n\n  #clearUserCallbacks(): void {\n    this.#eventHandlers.clear()\n    this.#hereHandler = null\n    this.#joiningHandler = null\n    this.#leavingHandler = null\n  }\n\n  /**\n   * Performs terminal cleanup after the user leaves or the socket is disposed.\n   */\n  #cleanupTerminal(): void {\n    this.#subscribed = false\n    this.#resetConnectionState()\n    this.#detachTransportListeners()\n    this.#clearUserCallbacks()\n  }\n}\n","import type { ConnectionState, EventHandler } from './types.js'\nimport type { ServerProtocolMessage } from '../shared_types.js'\n\ninterface PendingRequest {\n  resolve: (value: unknown) => void\n  reject: (error: Error) => void\n  timer: ReturnType<typeof setTimeout>\n}\n\ninterface ClientSocketSessionOptions {\n  buildUrl: () => string\n  createWebSocket?: (url: string) => WebSocket\n  autoReconnect?: boolean\n  reconnectDelay?: number\n  reconnectMaxDelay?: number\n  onConnected?: () => void\n}\n\nexport class ClientSocketSession {\n  #ws: WebSocket | null = null\n  #state: ConnectionState = 'disconnected'\n  #connectPromise: Promise<void> | null = null\n  #cancelConnect: ((error: Error) => void) | null = null\n  #stateHandlers = new Set<EventHandler<ConnectionState>>()\n  #eventHandlers = new Map<string, Set<EventHandler>>()\n  #pendingRequests = new Map<string, PendingRequest>()\n  #requestId = 0\n  #reconnectAttempts = 0\n  #reconnectTimer: ReturnType<typeof setTimeout> | null = null\n  #manualDisconnect = false\n  #buildUrl: () => string\n  #createWebSocket: (url: string) => WebSocket\n  #autoReconnect: boolean\n  #reconnectDelay: number\n  #reconnectMaxDelay: number\n  #onConnected?: () => void\n\n  constructor(options: ClientSocketSessionOptions) {\n    this.#buildUrl = options.buildUrl\n    this.#createWebSocket = options.createWebSocket ?? ((url) => new WebSocket(url))\n    this.#autoReconnect = options.autoReconnect ?? true\n    this.#reconnectDelay = Math.max(0, options.reconnectDelay ?? 250)\n    this.#reconnectMaxDelay = Math.max(this.#reconnectDelay, options.reconnectMaxDelay ?? 5000)\n    this.#onConnected = options.onConnected\n  }\n\n  get state(): ConnectionState {\n    return this.#state\n  }\n\n  get connected(): boolean {\n    return this.#state === 'connected'\n  }\n\n  connect(): Promise<void> {\n    if (this.#state === 'connected') {\n      return Promise.resolve()\n    }\n\n    if (this.#connectPromise) {\n      return this.#connectPromise\n    }\n\n    this.#manualDisconnect = false\n    this.#setState('connecting')\n\n    const connectPromise = new Promise<void>((resolve, reject) => {\n      const ws = this.#createWebSocket(this.#buildUrl())\n      this.#ws = ws\n      let settled = false\n\n      const cleanup = () => {\n        ws.removeEventListener('open', handleOpen)\n        ws.removeEventListener('error', handleError)\n        if (this.#connectPromise === connectPromise) {\n          this.#connectPromise = null\n        }\n        if (this.#cancelConnect === cancelConnect) {\n          this.#cancelConnect = null\n        }\n      }\n\n      const cancelConnect = (error: Error) => {\n        if (settled) {\n          return\n        }\n\n        settled = true\n        cleanup()\n        reject(error)\n      }\n\n      const handleOpen = () => {\n        settled = true\n        cleanup()\n        this.#reconnectAttempts = 0\n        this.#setState('connected')\n        this.#emitLocal('connect')\n        this.#onConnected?.()\n        resolve()\n      }\n\n      const handleError = () => {\n        cancelConnect(new Error('WebSocket connection failed'))\n        if (this.#ws === ws) {\n          this.#setState('disconnected')\n        }\n      }\n\n      const handleClose = () => {\n        cancelConnect(new Error('WebSocket connection failed'))\n\n        if (this.#ws === ws) {\n          this.#handleClose()\n        }\n      }\n\n      this.#cancelConnect = cancelConnect\n      ws.addEventListener('open', handleOpen)\n      ws.addEventListener('error', handleError)\n      ws.addEventListener('message', (event) => this.#handleIncoming(event.data))\n      ws.addEventListener('close', handleClose)\n    })\n\n    this.#connectPromise = connectPromise\n    return connectPromise\n  }\n\n  disconnect(): void {\n    this.#manualDisconnect = true\n    if (this.#reconnectTimer) {\n      clearTimeout(this.#reconnectTimer)\n      this.#reconnectTimer = null\n    }\n\n    this.#cancelConnect?.(new Error('Socket disconnected'))\n    this.#reconnectAttempts = 0\n    this.#ws?.close()\n    this.#rejectPending(new Error('Socket disconnected'))\n  }\n\n  onStateChange(handler: EventHandler<ConnectionState>): () => void {\n    this.#stateHandlers.add(handler)\n\n    return () => {\n      this.#stateHandlers.delete(handler)\n    }\n  }\n\n  on<T = unknown>(event: string, handler: EventHandler<T>): () => void {\n    if (!this.#eventHandlers.has(event)) {\n      this.#eventHandlers.set(event, new Set())\n    }\n\n    this.#eventHandlers.get(event)!.add(handler as EventHandler)\n\n    return () => {\n      this.off(event, handler as EventHandler)\n    }\n  }\n\n  off(event: string, handler: EventHandler): void {\n    this.#eventHandlers.get(event)?.delete(handler)\n  }\n\n  send(message: Record<string, unknown>): void {\n    if (this.#ws?.readyState !== WebSocket.OPEN) {\n      return\n    }\n\n    this.#ws.send(JSON.stringify(message))\n  }\n\n  sendRequest<T = unknown>(message: Record<string, unknown>, timeout = 5000): Promise<T> {\n    if (this.#ws?.readyState !== WebSocket.OPEN) {\n      return Promise.reject(new Error('Socket is not connected'))\n    }\n\n    const id = String(++this.#requestId)\n    const payload = { id, ...message }\n\n    return new Promise((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.#pendingRequests.delete(id)\n        reject(new Error('Socket request timed out'))\n      }, timeout)\n\n      this.#pendingRequests.set(id, { resolve: resolve as (value: unknown) => void, reject, timer })\n      this.#ws!.send(JSON.stringify(payload))\n    })\n  }\n\n  #handleIncoming(raw: unknown): void {\n    const message = this.#parseMessage(raw)\n    if (!message) {\n      return\n    }\n\n    if (message.type === 'ack') {\n      this.#resolveAck(message)\n      return\n    }\n\n    if (message.type === 'event') {\n      if (message.channel) {\n        if (message.event === 'presence:update') {\n          this.#emitLocal(`channel:${message.channel}:presence:update`, message.data)\n          return\n        }\n\n        this.#emitLocal(`channel:${message.channel}:event`, {\n          event: message.event,\n          data: message.data,\n        })\n        return\n      }\n\n      this.#emitLocal(message.event, message.data)\n    }\n  }\n\n  #parseMessage(raw: unknown): ServerProtocolMessage | null {\n    try {\n      const data = typeof raw === 'string' ? raw : String(raw)\n      const message = JSON.parse(data)\n      return message && typeof message === 'object' ? (message as ServerProtocolMessage) : null\n    } catch {\n      return null\n    }\n  }\n\n  #resolveAck(message: Extract<ServerProtocolMessage, { type: 'ack' }>): void {\n    if (!message.id) {\n      return\n    }\n\n    const pending = this.#pendingRequests.get(message.id)\n    if (!pending) {\n      return\n    }\n\n    clearTimeout(pending.timer)\n    this.#pendingRequests.delete(message.id)\n\n    if (message.ok) {\n      pending.resolve({ ok: true, data: message.data })\n    } else {\n      pending.resolve({ ok: false, error: message.error })\n    }\n  }\n\n  #handleClose(): void {\n    const shouldEmitDisconnect = this.#state !== 'disconnected'\n\n    this.#setState('disconnected')\n    if (shouldEmitDisconnect) {\n      this.#emitLocal('disconnect')\n    }\n    this.#rejectPending(new Error('Socket disconnected'))\n\n    this.#scheduleReconnect()\n  }\n\n  #scheduleReconnect(): void {\n    if (this.#manualDisconnect || !this.#autoReconnect || this.#reconnectTimer) {\n      return\n    }\n\n    const delay = Math.min(\n      this.#reconnectDelay * 2 ** this.#reconnectAttempts,\n      this.#reconnectMaxDelay\n    )\n    this.#reconnectAttempts += 1\n\n    this.#reconnectTimer = setTimeout(() => {\n      this.#reconnectTimer = null\n      this.connect().catch(() => this.#handleClose())\n    }, delay)\n  }\n\n  #rejectPending(error: Error): void {\n    for (const [id, pending] of this.#pendingRequests) {\n      clearTimeout(pending.timer)\n      pending.reject(error)\n      this.#pendingRequests.delete(id)\n    }\n  }\n\n  #emitLocal(event: string, data?: unknown): void {\n    this.#eventHandlers.get(event)?.forEach((handler) => handler(data))\n  }\n\n  #setState(state: ConnectionState): void {\n    if (this.#state === state) {\n      return\n    }\n\n    this.#state = state\n    this.#stateHandlers.forEach((handler) => handler(state))\n  }\n}\n","import { Channel } from './channel.js'\nimport { ClientSocketSession } from './socket_session.js'\nimport type {\n  SocketOptions,\n  ConnectionState,\n  EventHandler,\n  SocketClientTransport,\n} from './types.js'\n\n/**\n * Main Socket client.\n */\nexport class Socket implements SocketClientTransport {\n  #channels = new Map<string, Channel>()\n  #url: string\n  #path: string\n  #auth?: Record<string, unknown>\n  #session: ClientSocketSession\n\n  constructor(options: SocketOptions = {}) {\n    const browserWindow = globalThis as typeof globalThis & {\n      window?: { location?: { origin?: string } }\n    }\n    const browserOrigin =\n      typeof globalThis === 'object' && browserWindow.window?.location?.origin\n        ? browserWindow.window.location.origin\n        : ''\n\n    this.#url = options.url ?? browserOrigin\n    this.#path = options.path ?? '/socket'\n    this.#auth = options.auth\n    this.#session = new ClientSocketSession({\n      buildUrl: () => this.#buildUrl(),\n      autoReconnect: options.autoReconnect,\n      reconnectDelay: options.reconnectDelay,\n      reconnectMaxDelay: options.reconnectMaxDelay,\n      onConnected: () => {\n        void this.#resubscribeChannels()\n      },\n    })\n  }\n\n  get state(): ConnectionState {\n    return this.#session.state\n  }\n\n  get connected(): boolean {\n    return this.#session.connected\n  }\n\n  get id(): string | undefined {\n    return undefined\n  }\n\n  connect(): Promise<void> {\n    return this.#session.connect()\n  }\n\n  disconnect(): void {\n    for (const channel of this.#channels.values()) {\n      channel.unsubscribe().catch(() => {})\n    }\n    this.#channels.clear()\n\n    this.#session.disconnect()\n  }\n\n  channel(name: string): Channel {\n    if (!this.#channels.has(name)) {\n      this.#channels.set(name, new Channel(name, this))\n    }\n\n    return this.#channels.get(name)!\n  }\n\n  async leave(name: string): Promise<void> {\n    const channel = this.#channels.get(name)\n    if (channel) {\n      await channel.unsubscribe()\n      this.#channels.delete(name)\n    }\n  }\n\n  onStateChange(handler: EventHandler<ConnectionState>): () => void {\n    return this.#session.onStateChange(handler)\n  }\n\n  on<T = unknown>(event: string, handler: EventHandler<T>): () => void {\n    return this.#session.on(event, handler)\n  }\n\n  off(event: string, handler: EventHandler): void {\n    this.#session.off(event, handler)\n  }\n\n  send(message: Record<string, unknown>): void {\n    this.#session.send(message)\n  }\n\n  sendRequest<T = unknown>(message: Record<string, unknown>, timeout = 5000): Promise<T> {\n    return this.#session.sendRequest(message, timeout)\n  }\n\n  #buildUrl(): string {\n    const browserGlobal = globalThis as typeof globalThis & {\n      location?: { origin?: string }\n    }\n    const url = new URL(this.#url || browserGlobal.location?.origin || 'http://localhost')\n    url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:'\n    url.pathname = this.#path\n\n    if (this.#auth) {\n      url.searchParams.set('auth', JSON.stringify(this.#auth))\n    }\n\n    return url.toString()\n  }\n\n  async #resubscribeChannels(): Promise<void> {\n    for (const channel of this.#channels.values()) {\n      if (channel.subscribed && !channel.active) {\n        await channel.subscribe().catch(console.error)\n      }\n    }\n  }\n}\n"],"mappings":"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","names":["resolve","reject"]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/build/src/client/react.d.ts

@@ -0,0 +1,30 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { S as Socket } from '../../index-8jB5RG6v.js';
+import { ConnectionState, EventHandler } from './types.js';
+import { F as FrameworkChannelCallArgs, a as FrameworkChannel, b as FrameworkChannelPattern, c as FrameworkChannelEvent, d as FrameworkChannelParameters, e as FrameworkChannelEventPayload } from '../../framework-16ypv4Ss.js';
+import '../../shared_types-DE86M136.js';
+
+type ChannelEventArgs<Registry, Pattern extends FrameworkChannelPattern<Registry>, Event extends FrameworkChannelEvent<Registry, Pattern>> = FrameworkChannelParameters<Registry, Pattern> extends undefined ? [event: Event, handler: EventHandler<FrameworkChannelEventPayload<Registry, Pattern, Event>>] : [
+    parameters: FrameworkChannelParameters<Registry, Pattern>,
+    event: Event,
+    handler: EventHandler<FrameworkChannelEventPayload<Registry, Pattern, Event>>
+];
+interface SocketProviderProps<Registry> {
+    socket: Socket<Registry>;
+    children?: ReactNode;
+    /** Connect on mount and disconnect on unmount. Use only for an exclusively owned socket. */
+    owned?: boolean;
+}
+declare function createSocketHooks<Registry = never>(): {
+    SocketProvider: ({ socket, children, owned }: SocketProviderProps<Registry>) => react.FunctionComponentElement<react.ProviderProps<Socket<Registry> | null>>;
+    useSocket: () => Socket<Registry>;
+    useSocketState: () => ConnectionState;
+    useChannel: {
+        <const Args extends FrameworkChannelCallArgs<Registry>>(...args: Args): FrameworkChannel<Registry, Args[0]> | null;
+        (pattern: null): null;
+    };
+    useChannelEvent: <const Pattern extends FrameworkChannelPattern<Registry>, Event extends FrameworkChannelEvent<Registry, Pattern>>(pattern: Pattern | null, ...args: ChannelEventArgs<Registry, Pattern, Event>) => void;
+};
+
+export { type SocketProviderProps, createSocketHooks };

package/build/src/client/react.js

@@ -0,0 +1,86 @@
+import {
+  acquireChannel,
+  acquireSocketOwnership,
+  createChannelCallArgs,
+  resolveChannelEventArgs
+} from "../../chunk-55EIQ2VV.js";
+import {
+  buildChannelName
+} from "../../chunk-O6UYCGTV.js";
+import "../../chunk-BLRAKPXW.js";
+import "../../chunk-6PJ4ALJD.js";
+import "../../chunk-E6ILCRL3.js";
+
+// src/client/react.ts
+import {
+  createContext,
+  createElement,
+  useContext,
+  useEffect,
+  useRef,
+  useState,
+  useSyncExternalStore
+} from "react";
+function createSocketHooks() {
+  const SocketContext = createContext(null);
+  function useSocket() {
+    const socket = useContext(SocketContext);
+    if (!socket) throw new Error("SocketProvider is missing");
+    return socket;
+  }
+  function SocketProvider({ socket, children, owned = false }) {
+    useEffect(() => {
+      if (!owned) return;
+      return acquireSocketOwnership(socket);
+    }, [owned, socket]);
+    return createElement(SocketContext.Provider, { value: socket }, children);
+  }
+  function useSocketState() {
+    const socket = useSocket();
+    return useSyncExternalStore(
+      (notify) => socket.onStateChange(notify),
+      () => socket.state,
+      () => "disconnected"
+    );
+  }
+  function useChannel(...args) {
+    const [pattern, parameters] = args;
+    const socket = useSocket();
+    const name = pattern === null ? null : buildChannelName(pattern, parameters);
+    const [acquired, setAcquired] = useState(null);
+    useEffect(() => {
+      if (pattern === null || name === null) {
+        setAcquired(null);
+        return;
+      }
+      const channelArgs = createChannelCallArgs(pattern, parameters);
+      const { channel, lease } = acquireChannel(socket, ...channelArgs);
+      setAcquired({ socket, name, channel });
+      return () => lease.release();
+    }, [name, pattern, socket]);
+    return acquired?.socket === socket && acquired.name === name ? acquired.channel : null;
+  }
+  function useChannelEvent(pattern, ...args) {
+    const socket = useSocket();
+    const {
+      parameterInput: parameters,
+      event,
+      handler
+    } = resolveChannelEventArgs(args);
+    const name = pattern === null ? null : buildChannelName(pattern, parameters);
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+      if (pattern === null || name === null) return;
+      const channelArgs = createChannelCallArgs(pattern, parameters);
+      const { lease } = acquireChannel(socket, ...channelArgs);
+      lease.listen(event, (data) => handlerRef.current(data));
+      return () => lease.release();
+    }, [event, name, pattern, socket]);
+  }
+  return { SocketProvider, useSocket, useSocketState, useChannel, useChannelEvent };
+}
+export {
+  createSocketHooks
+};
+//# sourceMappingURL=react.js.map

package/build/src/client/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/client/react.ts"],"sourcesContent":["import {\n  createContext,\n  createElement,\n  useContext,\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  type ReactNode,\n} from 'react'\nimport type { Channel } from './channel.js'\nimport { buildChannelName, type Socket } from './socket.js'\nimport type { ConnectionState, EventHandler } from './types.js'\nimport {\n  acquireChannel,\n  acquireSocketOwnership,\n  createChannelCallArgs,\n  resolveChannelEventArgs,\n  type FrameworkChannel,\n  type FrameworkChannelCallArgs,\n  type FrameworkChannelEvent,\n  type FrameworkChannelEventPayload,\n  type FrameworkChannelParameters,\n  type FrameworkChannelPattern,\n} from './framework.js'\n\ntype ChannelEventArgs<\n  Registry,\n  Pattern extends FrameworkChannelPattern<Registry>,\n  Event extends FrameworkChannelEvent<Registry, Pattern>,\n> =\n  FrameworkChannelParameters<Registry, Pattern> extends undefined\n    ? [event: Event, handler: EventHandler<FrameworkChannelEventPayload<Registry, Pattern, Event>>]\n    : [\n        parameters: FrameworkChannelParameters<Registry, Pattern>,\n        event: Event,\n        handler: EventHandler<FrameworkChannelEventPayload<Registry, Pattern, Event>>,\n      ]\n\nexport interface SocketProviderProps<Registry> {\n  socket: Socket<Registry>\n  children?: ReactNode\n  /** Connect on mount and disconnect on unmount. Use only for an exclusively owned socket. */\n  owned?: boolean\n}\n\nexport function createSocketHooks<Registry = never>() {\n  const SocketContext = createContext<Socket<Registry> | null>(null)\n\n  function useSocket(): Socket<Registry> {\n    const socket = useContext(SocketContext)\n    if (!socket) throw new Error('SocketProvider is missing')\n    return socket\n  }\n\n  function SocketProvider({ socket, children, owned = false }: SocketProviderProps<Registry>) {\n    useEffect(() => {\n      if (!owned) return\n      return acquireSocketOwnership(socket)\n    }, [owned, socket])\n\n    return createElement(SocketContext.Provider, { value: socket }, children)\n  }\n\n  function useSocketState(): ConnectionState {\n    const socket = useSocket()\n    return useSyncExternalStore(\n      (notify) => socket.onStateChange(notify),\n      () => socket.state,\n      () => 'disconnected'\n    )\n  }\n\n  function useChannel<const Args extends FrameworkChannelCallArgs<Registry>>(\n    ...args: Args\n  ): FrameworkChannel<Registry, Args[0]> | null\n  function useChannel(pattern: null): null\n  function useChannel(\n    ...args: [pattern: FrameworkChannelPattern<Registry> | null, parameters?: object]\n  ): Channel<any> | null {\n    const [pattern, parameters] = args\n    const socket = useSocket()\n    const name = pattern === null ? null : buildChannelName(pattern, parameters)\n    const [acquired, setAcquired] = useState<{\n      socket: Socket<Registry>\n      name: string\n      channel: Channel<any>\n    } | null>(null)\n\n    useEffect(() => {\n      if (pattern === null || name === null) {\n        setAcquired(null)\n        return\n      }\n      const channelArgs = createChannelCallArgs<Registry>(pattern, parameters)\n      const { channel, lease } = acquireChannel(socket, ...channelArgs)\n      setAcquired({ socket, name, channel })\n      return () => lease.release()\n    }, [name, pattern, socket])\n\n    return acquired?.socket === socket && acquired.name === name ? acquired.channel : null\n  }\n\n  function useChannelEvent<\n    const Pattern extends FrameworkChannelPattern<Registry>,\n    Event extends FrameworkChannelEvent<Registry, Pattern>,\n  >(pattern: Pattern | null, ...args: ChannelEventArgs<Registry, Pattern, Event>): void {\n    const socket = useSocket()\n    const {\n      parameterInput: parameters,\n      event,\n      handler,\n    } = resolveChannelEventArgs<\n      FrameworkChannelParameters<Registry, Pattern>,\n      Event,\n      FrameworkChannelEventPayload<Registry, Pattern, Event>\n    >(args)\n    const name = pattern === null ? null : buildChannelName(pattern, parameters)\n    const handlerRef = useRef(handler)\n    handlerRef.current = handler\n\n    useEffect(() => {\n      if (pattern === null || name === null) return\n      const channelArgs = createChannelCallArgs<Registry>(pattern, parameters)\n      const { lease } = acquireChannel(socket, ...channelArgs)\n      lease.listen(event, (data) => handlerRef.current(data))\n      return () => lease.release()\n    }, [event, name, pattern, socket])\n  }\n\n  return { SocketProvider, useSocket, useSocketState, useChannel, useChannelEvent }\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAqCA,SAAS,oBAAsC;AACpD,QAAM,gBAAgB,cAAuC,IAAI;AAEjE,WAAS,YAA8B;AACrC,UAAM,SAAS,WAAW,aAAa;AACvC,QAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,2BAA2B;AACxD,WAAO;AAAA,EACT;AAEA,WAAS,eAAe,EAAE,QAAQ,UAAU,QAAQ,MAAM,GAAkC;AAC1F,cAAU,MAAM;AACd,UAAI,CAAC,MAAO;AACZ,aAAO,uBAAuB,MAAM;AAAA,IACtC,GAAG,CAAC,OAAO,MAAM,CAAC;AAElB,WAAO,cAAc,cAAc,UAAU,EAAE,OAAO,OAAO,GAAG,QAAQ;AAAA,EAC1E;AAEA,WAAS,iBAAkC;AACzC,UAAM,SAAS,UAAU;AACzB,WAAO;AAAA,MACL,CAAC,WAAW,OAAO,cAAc,MAAM;AAAA,MACvC,MAAM,OAAO;AAAA,MACb,MAAM;AAAA,IACR;AAAA,EACF;AAMA,WAAS,cACJ,MACkB;AACrB,UAAM,CAAC,SAAS,UAAU,IAAI;AAC9B,UAAM,SAAS,UAAU;AACzB,UAAM,OAAO,YAAY,OAAO,OAAO,iBAAiB,SAAS,UAAU;AAC3E,UAAM,CAAC,UAAU,WAAW,IAAI,SAItB,IAAI;AAEd,cAAU,MAAM;AACd,UAAI,YAAY,QAAQ,SAAS,MAAM;AACrC,oBAAY,IAAI;AAChB;AAAA,MACF;AACA,YAAM,cAAc,sBAAgC,SAAS,UAAU;AACvE,YAAM,EAAE,SAAS,MAAM,IAAI,eAAe,QAAQ,GAAG,WAAW;AAChE,kBAAY,EAAE,QAAQ,MAAM,QAAQ,CAAC;AACrC,aAAO,MAAM,MAAM,QAAQ;AAAA,IAC7B,GAAG,CAAC,MAAM,SAAS,MAAM,CAAC;AAE1B,WAAO,UAAU,WAAW,UAAU,SAAS,SAAS,OAAO,SAAS,UAAU;AAAA,EACpF;AAEA,WAAS,gBAGP,YAA4B,MAAwD;AACpF,UAAM,SAAS,UAAU;AACzB,UAAM;AAAA,MACJ,gBAAgB;AAAA,MAChB;AAAA,MACA;AAAA,IACF,IAAI,wBAIF,IAAI;AACN,UAAM,OAAO,YAAY,OAAO,OAAO,iBAAiB,SAAS,UAAU;AAC3E,UAAM,aAAa,OAAO,OAAO;AACjC,eAAW,UAAU;AAErB,cAAU,MAAM;AACd,UAAI,YAAY,QAAQ,SAAS,KAAM;AACvC,YAAM,cAAc,sBAAgC,SAAS,UAAU;AACvE,YAAM,EAAE,MAAM,IAAI,eAAe,QAAQ,GAAG,WAAW;AACvD,YAAM,OAAO,OAAO,CAAC,SAAS,WAAW,QAAQ,IAAI,CAAC;AACtD,aAAO,MAAM,MAAM,QAAQ;AAAA,IAC7B,GAAG,CAAC,OAAO,MAAM,SAAS,MAAM,CAAC;AAAA,EACnC;AAEA,SAAO,EAAE,gBAAgB,WAAW,gBAAgB,YAAY,gBAAgB;AAClF;","names":[]}

package/build/src/client/types.d.ts

@@ -1,5 +1,58 @@
-export { C as ChannelAck, a as ChannelMessage } from '../../shared_types-Dw9AphfO.js';
+import { C as ChannelServerEventsOf } from '../../shared_types-DE86M136.js';
+export { a as ChannelAck, b as ChannelMessage } from '../../shared_types-DE86M136.js';
 
+/** Type-only contract carried by a browser channel. */
+interface ChannelContract<ClientEvents = unknown, ServerEvents = unknown> {
+    readonly clientEvents: ClientEvents;
+    readonly serverEvents: ServerEvents;
+}
+type ChannelInstance<Entry> = Entry extends {
+    readonly channel: abstract new (...args: any[]) => infer Instance;
+} ? Instance : never;
+type HandlerName<E, K> = E extends {
+    readonly handlers: infer H;
+} ? K extends keyof H ? H[K] : never : never;
+type HandlerAck<Entry, Event> = HandlerName<Entry, Event> extends keyof ChannelInstance<Entry> ? ChannelInstance<Entry>[HandlerName<Entry, Event>] extends (...args: any[]) => infer Result ? Awaited<Result> : unknown : unknown;
+type HandlerPayload<Entry, Event> = HandlerName<Entry, Event> extends keyof ChannelInstance<Entry> ? ChannelInstance<Entry>[HandlerName<Entry, Event>] extends (...args: any[]) => unknown ? Parameters<ChannelInstance<Entry>[HandlerName<Entry, Event>]> extends [
+    unknown,
+    ...infer Rest
+] ? Rest extends [] ? undefined : Rest[0] : undefined : unknown : unknown;
+type ClientContracts<Entry> = Entry extends {
+    readonly handlers: infer Handlers;
+} ? {
+    [Event in Extract<keyof Handlers, string>]: {
+        payload: HandlerPayload<Entry, Event>;
+        ack: HandlerAck<Entry, Event>;
+    };
+} : unknown;
+type ContractOfEntry<Entry> = ChannelContract<ClientContracts<Entry>, ChannelServerEventsOf<ChannelInstance<Entry>>>;
+type RegistryChannels<Registry> = Registry extends {
+    readonly channels: infer Channels;
+} ? Channels : never;
+type RegistryChannelEntry<Registry, Pattern extends ChannelPattern<Registry>> = RegistryChannels<Registry>[Pattern];
+/** Channel patterns explicitly declared in a generated registry. */
+type ChannelPattern<Registry> = Extract<keyof RegistryChannels<Registry>, string>;
+/** Resolves an explicit generated channel pattern to its contract. */
+type ChannelContractFor<Registry, Pattern extends string> = string extends Pattern ? never : Pattern extends ChannelPattern<Registry> ? ContractOfEntry<RegistryChannelEntry<Registry, Pattern>> : never;
+type ChannelParameterValue = string | number;
+/** Parameters generated for an explicit channel pattern. Static channels use `undefined`. */
+type ChannelParameters<Registry, Pattern extends ChannelPattern<Registry>> = RegistryChannelEntry<Registry, Pattern> extends {
+    readonly params: infer Parameters;
+} ? Parameters extends object | undefined ? Parameters : never : never;
+/** A correlated client call for one generated channel pattern. */
+type ChannelCallArgs<Registry, Pattern extends ChannelPattern<Registry> = ChannelPattern<Registry>> = Pattern extends ChannelPattern<Registry> ? ChannelParameters<Registry, Pattern> extends undefined ? [pattern: Pattern] : [pattern: Pattern, parameters: ChannelParameters<Registry, Pattern>] : never;
+type ClientEvents<Contract> = Contract extends ChannelContract<infer Events, unknown> ? Events : never;
+type ServerEvents<Contract> = Contract extends ChannelContract<unknown, infer Events> ? Events : never;
+/** Client events accepted by a generated channel. */
+type ChannelClientEvent<Registry, Pattern extends ChannelPattern<Registry>> = Extract<keyof ClientEvents<ChannelContractFor<Registry, Pattern>>, string>;
+/** Payload sent from the client for a generated channel event. */
+type ChannelClientEventPayload<Registry, Pattern extends ChannelPattern<Registry>, Event extends ChannelClientEvent<Registry, Pattern>> = ClientEvents<ChannelContractFor<Registry, Pattern>>[Event] extends {
+    payload: infer Payload;
+} ? Payload : never;
+/** Server broadcast events received by a generated channel. */
+type ChannelBroadcastEvent<Registry, Pattern extends ChannelPattern<Registry>> = Extract<keyof ServerEvents<ChannelContractFor<Registry, Pattern>>, string>;
+/** Payload received from a server broadcast on a generated channel. */
+type ChannelBroadcastPayload<Registry, Pattern extends ChannelPattern<Registry>, Event extends ChannelBroadcastEvent<Registry, Pattern>> = ServerEvents<ChannelContractFor<Registry, Pattern>>[Event];
 /**
  * Connection options.
  */
@@ -25,10 +78,10 @@ interface SocketOptions {
      */
     reconnectMaxDelay?: number;
     /**
-     * Authentication data sent during the WebSocket handshake query string.
-     * Ex: { token: 'oat_MjE...' }
+     * Decides whether a remotely closed connection should reconnect.
+     * By default, deliberate server disconnects are terminal and other closes reconnect.
      */
-    auth?: Record<string, unknown>;
+    shouldReconnect?: (event: CloseEvent) => boolean;
 }
 /**
  * Channel subscription options.
@@ -61,7 +114,6 @@ interface SubscribeResult {
     ok: boolean;
     error?: string;
     data?: SubscribeAckData;
-    presenceData?: PresenceData | null;
 }
 /**
  * Presence data.
@@ -70,14 +122,15 @@ interface PresenceData {
     channel: string;
     users: PresenceUser[];
     count: number;
+    [key: string]: unknown;
 }
 /**
  * User in presence data.
  */
 interface PresenceUser {
     id: string;
-    name: string;
     joinedAt: string;
+    [key: string]: unknown;
 }
 /**
  * Connection state.
@@ -94,8 +147,8 @@ interface SocketClientTransport {
     connected: boolean;
     sendRequest<T = unknown>(message: Record<string, unknown>, timeout?: number): Promise<T>;
     send(message: Record<string, unknown>): void;
-    on(event: string, handler: EventHandler): void;
-    off(event: string, handler: EventHandler): void;
+    on<T = unknown>(event: string, handler: EventHandler<T>): void;
+    off<T = unknown>(event: string, handler: EventHandler<T>): void;
 }
 
-export type { ConnectionState, EventHandler, PresenceData, PresenceUser, SocketClientTransport, SocketOptions, SubscribeAckData, SubscribeOptions, SubscribeResult, UnsubscribeOptions };
+export { type ChannelBroadcastEvent, type ChannelBroadcastPayload, type ChannelCallArgs, type ChannelClientEvent, type ChannelClientEventPayload, type ChannelContract, type ChannelContractFor, type ChannelParameterValue, type ChannelParameters, type ChannelPattern, ChannelServerEventsOf, type ConnectionState, type EventHandler, type PresenceData, type PresenceUser, type SocketClientTransport, type SocketOptions, type SubscribeAckData, type SubscribeOptions, type SubscribeResult, type UnsubscribeOptions };

package/build/src/client/vue.d.ts

@@ -0,0 +1,32 @@
+import { ShallowRef, ComputedRef, MaybeRefOrGetter } from 'vue';
+import { S as Socket } from '../../index-8jB5RG6v.js';
+import { ConnectionState, EventHandler } from './types.js';
+import { b as FrameworkChannelPattern, d as FrameworkChannelParameters, a as FrameworkChannel, c as FrameworkChannelEvent, e as FrameworkChannelEventPayload } from '../../framework-16ypv4Ss.js';
+import '../../shared_types-DE86M136.js';
+
+type ChannelParameterInput<Registry, Pattern extends FrameworkChannelPattern<Registry>> = MaybeRefOrGetter<FrameworkChannelParameters<Registry, Pattern>>;
+type VueChannelCallArgs<Registry> = {
+    [Pattern in FrameworkChannelPattern<Registry>]: FrameworkChannelParameters<Registry, Pattern> extends undefined ? [pattern: Pattern] : [pattern: Pattern, parameters: ChannelParameterInput<Registry, Pattern>];
+}[FrameworkChannelPattern<Registry>];
+type VueChannelEventArgs<Registry, Pattern extends FrameworkChannelPattern<Registry>, Event extends FrameworkChannelEvent<Registry, Pattern>> = FrameworkChannelParameters<Registry, Pattern> extends undefined ? [event: Event, handler: EventHandler<FrameworkChannelEventPayload<Registry, Pattern, Event>>] : [
+    parameters: ChannelParameterInput<Registry, Pattern>,
+    event: Event,
+    handler: EventHandler<FrameworkChannelEventPayload<Registry, Pattern, Event>>
+];
+declare function createSocketComposables<Registry = never>(): {
+    provideSocket: (socket: Socket<Registry>, options?: {
+        owned?: boolean;
+    }) => void;
+    useSocket: () => Socket<Registry>;
+    useSocketState: () => {
+        state: Readonly<ShallowRef<ConnectionState>>;
+        connected: ComputedRef<boolean>;
+    };
+    useChannel: {
+        <const Args extends VueChannelCallArgs<Registry>>(...args: Args): Readonly<ShallowRef<FrameworkChannel<Registry, Args[0]> | null>>;
+        (pattern: null): Readonly<ShallowRef<null>>;
+    };
+    useChannelEvent: <const Pattern extends FrameworkChannelPattern<Registry>, Event extends FrameworkChannelEvent<Registry, Pattern>>(pattern: Pattern | null, ...args: VueChannelEventArgs<Registry, Pattern, Event>) => void;
+};
+
+export { createSocketComposables };

package/build/src/client/vue.js

@@ -0,0 +1,100 @@
+import {
+  acquireChannel,
+  acquireSocketOwnership,
+  createChannelCallArgs,
+  resolveChannelEventArgs
+} from "../../chunk-55EIQ2VV.js";
+import {
+  buildChannelName
+} from "../../chunk-O6UYCGTV.js";
+import "../../chunk-BLRAKPXW.js";
+import "../../chunk-6PJ4ALJD.js";
+import "../../chunk-E6ILCRL3.js";
+
+// src/client/vue.ts
+import {
+  computed,
+  inject,
+  onMounted,
+  onScopeDispose,
+  provide,
+  shallowRef,
+  toValue,
+  watch
+} from "vue";
+function createSocketComposables() {
+  const key = /* @__PURE__ */ Symbol("socket");
+  function provideSocket(socket, options = {}) {
+    const state = shallowRef(socket.state);
+    const stopStateListener = socket.onStateChange((nextState) => {
+      state.value = nextState;
+    });
+    provide(key, { socket, state });
+    let releaseOwnership;
+    if (options.owned) onMounted(() => releaseOwnership = acquireSocketOwnership(socket));
+    onScopeDispose(() => {
+      stopStateListener();
+      releaseOwnership?.();
+    });
+  }
+  function useContext() {
+    const context = inject(key);
+    if (!context) throw new Error("provideSocket must be called by an ancestor");
+    return context;
+  }
+  function useSocket() {
+    return useContext().socket;
+  }
+  function useSocketState() {
+    const state = useContext().state;
+    return { state, connected: computed(() => state.value === "connected") };
+  }
+  function useChannel(...args) {
+    const [pattern, parameterInput] = args;
+    const socket = useSocket();
+    const channel = shallowRef(null);
+    watch(
+      () => pattern === null ? null : toValue(parameterInput),
+      (parameters, _previousParameters, onCleanup) => {
+        const nextName = pattern === null ? null : buildChannelName(pattern, parameters);
+        if (nextName === null || pattern === null) {
+          channel.value = null;
+          return;
+        }
+        const channelArgs = createChannelCallArgs(
+          pattern,
+          parameters
+        );
+        const acquired = acquireChannel(socket, ...channelArgs);
+        channel.value = acquired.channel;
+        onCleanup(() => acquired.lease.release());
+      },
+      { immediate: true }
+    );
+    return channel;
+  }
+  function useChannelEvent(pattern, ...args) {
+    const socket = useSocket();
+    const { parameterInput, event, handler } = resolveChannelEventArgs(args);
+    watch(
+      () => pattern === null ? null : toValue(parameterInput),
+      (parameters, _previousParameters, onCleanup) => {
+        const nextName = pattern === null ? null : buildChannelName(pattern, parameters);
+        if (nextName === null || pattern === null) return;
+        const channelArgs = createChannelCallArgs(
+          pattern,
+          parameters
+        );
+        const { lease } = acquireChannel(socket, ...channelArgs);
+        lease.listen(event, handler);
+        onCleanup(() => lease.release());
+      },
+      { immediate: true }
+    );
+  }
+  return { provideSocket, useSocket, useSocketState, useChannel, useChannelEvent };
+}
+export {
+  createSocketComposables
+};
+//# sourceMappingURL=vue.js.map

package/build/src/client/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/client/vue.ts"],"sourcesContent":["import {\n  computed,\n  inject,\n  onMounted,\n  onScopeDispose,\n  provide,\n  shallowRef,\n  toValue,\n  watch,\n  type ComputedRef,\n  type InjectionKey,\n  type MaybeRefOrGetter,\n  type ShallowRef,\n} from 'vue'\nimport type { Channel } from './channel.js'\nimport { buildChannelName, type Socket } from './socket.js'\nimport type { ConnectionState, EventHandler } from './types.js'\nimport {\n  acquireChannel,\n  acquireSocketOwnership,\n  createChannelCallArgs,\n  resolveChannelEventArgs,\n  type FrameworkChannel,\n  type FrameworkChannelEvent,\n  type FrameworkChannelEventPayload,\n  type FrameworkChannelParameters,\n  type FrameworkChannelPattern,\n} from './framework.js'\n\ninterface VueSocketContext<Registry> {\n  socket: Socket<Registry>\n  state: ShallowRef<ConnectionState>\n}\n\ntype ChannelParameterInput<\n  Registry,\n  Pattern extends FrameworkChannelPattern<Registry>,\n> = MaybeRefOrGetter<FrameworkChannelParameters<Registry, Pattern>>\n\ntype VueChannelCallArgs<Registry> = {\n  [Pattern in FrameworkChannelPattern<Registry>]: FrameworkChannelParameters<\n    Registry,\n    Pattern\n  > extends undefined\n    ? [pattern: Pattern]\n    : [pattern: Pattern, parameters: ChannelParameterInput<Registry, Pattern>]\n}[FrameworkChannelPattern<Registry>]\n\ntype VueChannelEventArgs<\n  Registry,\n  Pattern extends FrameworkChannelPattern<Registry>,\n  Event extends FrameworkChannelEvent<Registry, Pattern>,\n> =\n  FrameworkChannelParameters<Registry, Pattern> extends undefined\n    ? [event: Event, handler: EventHandler<FrameworkChannelEventPayload<Registry, Pattern, Event>>]\n    : [\n        parameters: ChannelParameterInput<Registry, Pattern>,\n        event: Event,\n        handler: EventHandler<FrameworkChannelEventPayload<Registry, Pattern, Event>>,\n      ]\n\nexport function createSocketComposables<Registry = never>() {\n  const key = Symbol('socket') as InjectionKey<VueSocketContext<Registry>>\n\n  function provideSocket(socket: Socket<Registry>, options: { owned?: boolean } = {}): void {\n    const state = shallowRef(socket.state)\n    const stopStateListener = socket.onStateChange((nextState) => {\n      state.value = nextState\n    })\n    provide(key, { socket, state })\n\n    let releaseOwnership: (() => void) | undefined\n    if (options.owned) onMounted(() => (releaseOwnership = acquireSocketOwnership(socket)))\n    onScopeDispose(() => {\n      stopStateListener()\n      releaseOwnership?.()\n    })\n  }\n\n  function useContext(): VueSocketContext<Registry> {\n    const context = inject(key)\n    if (!context) throw new Error('provideSocket must be called by an ancestor')\n    return context\n  }\n\n  function useSocket(): Socket<Registry> {\n    return useContext().socket\n  }\n\n  function useSocketState(): {\n    state: Readonly<ShallowRef<ConnectionState>>\n    connected: ComputedRef<boolean>\n  } {\n    const state = useContext().state\n    return { state, connected: computed(() => state.value === 'connected') }\n  }\n\n  function useChannel<const Args extends VueChannelCallArgs<Registry>>(\n    ...args: Args\n  ): Readonly<ShallowRef<FrameworkChannel<Registry, Args[0]> | null>>\n  function useChannel(pattern: null): Readonly<ShallowRef<null>>\n  function useChannel(\n    ...args: [\n      pattern: FrameworkChannelPattern<Registry> | null,\n      parameterInput?: MaybeRefOrGetter<object | undefined>,\n    ]\n  ): Readonly<ShallowRef<Channel<any> | null>> {\n    const [pattern, parameterInput] = args\n    const socket = useSocket()\n    const channel = shallowRef(null) as ShallowRef<Channel<any> | null>\n\n    watch(\n      () => (pattern === null ? null : toValue(parameterInput)),\n      (parameters, _previousParameters, onCleanup) => {\n        const nextName =\n          pattern === null ? null : buildChannelName(pattern, parameters as object | undefined)\n        if (nextName === null || pattern === null) {\n          channel.value = null\n          return\n        }\n        const channelArgs = createChannelCallArgs<Registry>(\n          pattern,\n          parameters as object | undefined\n        )\n        const acquired = acquireChannel(socket, ...channelArgs)\n        channel.value = acquired.channel\n        onCleanup(() => acquired.lease.release())\n      },\n      { immediate: true }\n    )\n\n    return channel\n  }\n\n  function useChannelEvent<\n    const Pattern extends FrameworkChannelPattern<Registry>,\n    Event extends FrameworkChannelEvent<Registry, Pattern>,\n  >(pattern: Pattern | null, ...args: VueChannelEventArgs<Registry, Pattern, Event>): void {\n    const socket = useSocket()\n    const { parameterInput, event, handler } = resolveChannelEventArgs<\n      ChannelParameterInput<Registry, Pattern>,\n      Event,\n      FrameworkChannelEventPayload<Registry, Pattern, Event>\n    >(args)\n    watch(\n      () => (pattern === null ? null : toValue(parameterInput)),\n      (parameters, _previousParameters, onCleanup) => {\n        const nextName =\n          pattern === null ? null : buildChannelName(pattern, parameters as object | undefined)\n        if (nextName === null || pattern === null) return\n        const channelArgs = createChannelCallArgs<Registry>(\n          pattern,\n          parameters as object | undefined\n        )\n        const { lease } = acquireChannel(socket, ...channelArgs)\n        lease.listen(event, handler)\n        onCleanup(() => lease.release())\n      },\n      { immediate: true }\n    )\n  }\n\n  return { provideSocket, useSocket, useSocketState, useChannel, useChannelEvent }\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AAgDA,SAAS,0BAA4C;AAC1D,QAAM,MAAM,uBAAO,QAAQ;AAE3B,WAAS,cAAc,QAA0B,UAA+B,CAAC,GAAS;AACxF,UAAM,QAAQ,WAAW,OAAO,KAAK;AACrC,UAAM,oBAAoB,OAAO,cAAc,CAAC,cAAc;AAC5D,YAAM,QAAQ;AAAA,IAChB,CAAC;AACD,YAAQ,KAAK,EAAE,QAAQ,MAAM,CAAC;AAE9B,QAAI;AACJ,QAAI,QAAQ,MAAO,WAAU,MAAO,mBAAmB,uBAAuB,MAAM,CAAE;AACtF,mBAAe,MAAM;AACnB,wBAAkB;AAClB,yBAAmB;AAAA,IACrB,CAAC;AAAA,EACH;AAEA,WAAS,aAAyC;AAChD,UAAM,UAAU,OAAO,GAAG;AAC1B,QAAI,CAAC,QAAS,OAAM,IAAI,MAAM,6CAA6C;AAC3E,WAAO;AAAA,EACT;AAEA,WAAS,YAA8B;AACrC,WAAO,WAAW,EAAE;AAAA,EACtB;AAEA,WAAS,iBAGP;AACA,UAAM,QAAQ,WAAW,EAAE;AAC3B,WAAO,EAAE,OAAO,WAAW,SAAS,MAAM,MAAM,UAAU,WAAW,EAAE;AAAA,EACzE;AAMA,WAAS,cACJ,MAIwC;AAC3C,UAAM,CAAC,SAAS,cAAc,IAAI;AAClC,UAAM,SAAS,UAAU;AACzB,UAAM,UAAU,WAAW,IAAI;AAE/B;AAAA,MACE,MAAO,YAAY,OAAO,OAAO,QAAQ,cAAc;AAAA,MACvD,CAAC,YAAY,qBAAqB,cAAc;AAC9C,cAAM,WACJ,YAAY,OAAO,OAAO,iBAAiB,SAAS,UAAgC;AACtF,YAAI,aAAa,QAAQ,YAAY,MAAM;AACzC,kBAAQ,QAAQ;AAChB;AAAA,QACF;AACA,cAAM,cAAc;AAAA,UAClB;AAAA,UACA;AAAA,QACF;AACA,cAAM,WAAW,eAAe,QAAQ,GAAG,WAAW;AACtD,gBAAQ,QAAQ,SAAS;AACzB,kBAAU,MAAM,SAAS,MAAM,QAAQ,CAAC;AAAA,MAC1C;AAAA,MACA,EAAE,WAAW,KAAK;AAAA,IACpB;AAEA,WAAO;AAAA,EACT;AAEA,WAAS,gBAGP,YAA4B,MAA2D;AACvF,UAAM,SAAS,UAAU;AACzB,UAAM,EAAE,gBAAgB,OAAO,QAAQ,IAAI,wBAIzC,IAAI;AACN;AAAA,MACE,MAAO,YAAY,OAAO,OAAO,QAAQ,cAAc;AAAA,MACvD,CAAC,YAAY,qBAAqB,cAAc;AAC9C,cAAM,WACJ,YAAY,OAAO,OAAO,iBAAiB,SAAS,UAAgC;AACtF,YAAI,aAAa,QAAQ,YAAY,KAAM;AAC3C,cAAM,cAAc;AAAA,UAClB;AAAA,UACA;AAAA,QACF;AACA,cAAM,EAAE,MAAM,IAAI,eAAe,QAAQ,GAAG,WAAW;AACvD,cAAM,OAAO,OAAO,OAAO;AAC3B,kBAAU,MAAM,MAAM,QAAQ,CAAC;AAAA,MACjC;AAAA,MACA,EAAE,WAAW,KAAK;AAAA,IACpB;AAAA,EACF;AAEA,SAAO,EAAE,eAAe,WAAW,gBAAgB,YAAY,gBAAgB;AACjF;","names":[]}

package/build/src/decorators.d.ts

@@ -1,17 +1,20 @@
-import { C as ChannelEventMap, a as ChannelHandlerMap } from '../types-C0rDwbry.js';
+import { A as AuthenticatedSocket } from '../base_channel-DKmR3Z0l.js';
 import 'ws';
 import 'node:http';
+import '@adonisjs/core/types/http';
+import '@adonisjs/core/http';
 import '@boringnode/bus/types/main';
-import '../shared_types-Dw9AphfO.js';
+import '../shared_types-DE86M136.js';
 
+type DecoratedChannelHandler<User> = (socket: AuthenticatedSocket<User>, data: unknown) => unknown;
 /**
- * Legacy method decorator used to bind an incoming channel event to a method.
+ * Method decorator used to bind an incoming channel event to a method.
  */
 declare function onMessage<EventName extends string>(event: EventName): MethodDecorator;
 /**
  * Resolve decorated handlers for a channel instance, including inherited ones.
  * Child classes override parent handlers when the event name is the same.
  */
-declare function getDecoratedChannelHandlers<User = unknown, Events extends ChannelEventMap = ChannelEventMap, HttpContext = unknown>(instance: object): ChannelHandlerMap<User, Events, HttpContext>;
+declare function getDecoratedChannelHandlers<User = unknown>(instance: object): Record<string, DecoratedChannelHandler<User>>;
 
 export { getDecoratedChannelHandlers, onMessage };

package/build/src/decorators.js

@@ -1,7 +1,7 @@
 import {
   getDecoratedChannelHandlers,
   onMessage
-} from "../chunk-XUDFDJME.js";
+} from "../chunk-G75J233Z.js";
 export {
   getDecoratedChannelHandlers,
   onMessage

package/build/src/health_check.d.ts

@@ -1,12 +1,15 @@
-import { S as SocketService } from '../socket_service-jxIaH5Rs.js';
-import '../types-C0rDwbry.js';
 import { BaseCheck, Result } from '@adonisjs/core/health';
-import '../shared_types-Dw9AphfO.js';
+import { S as SocketService } from '../socket_service-C1JM64_9.js';
 import 'node:http';
 import '@adonisjs/logger';
 import 'emittery';
 import 'ws';
+import '../base_channel-DKmR3Z0l.js';
+import '@adonisjs/core/types/http';
+import '@adonisjs/core/http';
 import '@boringnode/bus/types/main';
+import '../shared_types-DE86M136.js';
+import './testing.js';
 
 declare class SocketHealthCheck extends BaseCheck {
     private socket;

package/build/src/health_check.js

@@ -1,6 +1,17 @@
-import {
-  SocketHealthCheck
-} from "../chunk-HK7Z65DA.js";
+// src/health_check.ts
+import { BaseCheck, Result } from "@adonisjs/core/health";
+var SocketHealthCheck = class extends BaseCheck {
+  constructor(socket) {
+    super();
+    this.socket = socket;
+  }
+  name = "Socket health check";
+  async run() {
+    const snapshot = this.socket.health();
+    const result = snapshot.ready ? Result.ok("Socket service is ready") : Result.failed(`Socket service is ${snapshot.status}`);
+    return result.setMetaData(snapshot);
+  }
+};
 export {
   SocketHealthCheck
 };

package/build/src/health_check.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../../src/health_check.ts"],"sourcesContent":["import { BaseCheck, Result } from '@adonisjs/core/health'\nimport type { SocketService } from './socket_service.js'\n\nexport class SocketHealthCheck extends BaseCheck {\n  name = 'Socket health check'\n\n  constructor(private socket: SocketService) {\n    super()\n  }\n\n  async run() {\n    const snapshot = this.socket.health()\n    const result = snapshot.ready\n      ? Result.ok('Socket service is ready')\n      : Result.failed(`Socket service is ${snapshot.status}`)\n\n    return result.setMetaData(snapshot)\n  }\n}\n"],"mappings":";AAAA,SAAS,WAAW,cAAc;AAG3B,IAAM,oBAAN,cAAgC,UAAU;AAAA,EAG/C,YAAoB,QAAuB;AACzC,UAAM;AADY;AAAA,EAEpB;AAAA,EAJA,OAAO;AAAA,EAMP,MAAM,MAAM;AACV,UAAM,WAAW,KAAK,OAAO,OAAO;AACpC,UAAM,SAAS,SAAS,QACpB,OAAO,GAAG,yBAAyB,IACnC,OAAO,OAAO,qBAAqB,SAAS,MAAM,EAAE;AAExD,WAAO,OAAO,YAAY,QAAQ;AAAA,EACpC;AACF;","names":[]}

package/build/src/otel.d.ts

@@ -23,6 +23,7 @@ declare class SocketInstrumentation extends InstrumentationBase<SocketInstrument
     protected broadcastHandlers?: TracingChannelSubscribers<SocketBroadcastMessage>;
     constructor(config?: SocketInstrumentationConfig);
     protected init(): undefined;
+    protected _updateMetricInstruments(): void;
     enable(): void;
     disable(): void;
     manuallyRegister(): void;