alepha 0.13.0 → 0.13.2

package/dist/websocket/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":["channel: ChannelDescriptor<TClient, TServer>","options: {\n      url?: string;\n      autoReconnect?: boolean;\n      reconnectInterval?: number;\n      maxReconnectAttempts?: number;\n    }","env: Static<typeof envSchema>","url","code?: number"],"sources":["../../src/websocket/descriptors/$channel.ts","../../src/websocket/providers/WebSocketServerProvider.ts","../../src/websocket/descriptors/$websocket.ts","../../src/websocket/services/WebSocketClient.ts","../../src/websocket/errors/WebSocketError.ts","../../src/websocket/interfaces/WebSocketInterfaces.ts","../../src/websocket/services/RoomManager.ts","../../src/websocket/services/WebSocketTopicService.ts","../../src/websocket/index.browser.ts"],"sourcesContent":["import {\n  createDescriptor,\n  Descriptor,\n  KIND,\n  type TObject,\n  type TString,\n  type TUnion,\n} from \"alepha\";\n\nexport type TWSObject = TObject | TUnion;\n\n/**\n * Channel descriptor options\n */\nexport interface ChannelDescriptorOptions<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> {\n  /**\n   * WebSocket endpoint path (e.g., \"/ws/chat\")\n   */\n  path: string;\n\n  /**\n   * Optional description for documentation\n   */\n  description?: string;\n\n  /**\n   * Message schemas for bidirectional communication\n   */\n  schema: {\n    /**\n     * Optional room ID schema validation\n     * Default: t.text() (any string)\n     * Can be enforced at application level: t.uuid(), t.regex(/^[a-f0-9\\-]{36}$/)\n     */\n    roomId?: TString;\n\n    /**\n     * Messages from server to client\n     * This is what clients will receive\n     */\n    in: TClient;\n\n    /**\n     * Messages from client to server\n     * This is what the server will receive\n     */\n    out: TServer;\n  };\n}\n\n/**\n * Defines a WebSocket channel with specified client and server message schemas.\n *\n * Channels must be defined as class properties to be registered in the Alepha context.\n * They define the \"vocabulary\" for communication - the schema for messages flowing\n * in both directions (server→client and client→server).\n *\n * @example Server-side with $websocket\n * ```typescript\n * class ChatController {\n *   // Channel must be defined inside a class\n *   chatChannel = $channel({\n *     path: \"/ws/chat\",\n *     description: \"Real-time chat channel\",\n *     schema: {\n *       // Server → Client messages\n *       in: t.union([\n *         t.object({\n *           type: t.const(\"append\"),\n *           content: t.text(),\n *           username: t.text()\n *         }),\n *         t.object({\n *           type: t.const(\"system\"),\n *           message: t.text()\n *         })\n *       ]),\n *       // Client → Server messages\n *       out: t.object({\n *         content: t.text()\n *       })\n *     }\n *   });\n *\n *   chat = $websocket({\n *     channel: this.chatChannel,\n *     handler: async ({ message, reply }) => {\n *       await reply({\n *         message: { type: \"append\", content: message.content, username: \"user\" }\n *       });\n *     }\n *   });\n * }\n * ```\n *\n * @example Browser-side with useRoom\n * ```typescript\n * // Define channel in a class for browser context\n * class ChatClient {\n *   chatChannel = $channel({\n *     path: \"/ws/chat\",\n *     schema: { in: inSchema, out: outSchema }\n *   });\n * }\n *\n * // Use in React component\n * function Chat() {\n *   const client = useInject(ChatClient);\n *   const chat = useRoom({ roomId: \"lobby\", channel: client.chatChannel, handler: ... }, []);\n * }\n * ```\n */\nexport const $channel = <TClient extends TWSObject, TServer extends TWSObject>(\n  options: ChannelDescriptorOptions<TClient, TServer>,\n): ChannelDescriptor<TClient, TServer> => {\n  return createDescriptor(ChannelDescriptor<TClient, TServer>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ChannelDescriptor<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> extends Descriptor<ChannelDescriptorOptions<TClient, TServer>> {\n  // Channels are just schema definitions - no initialization logic needed\n}\n\n$channel[KIND] = ChannelDescriptor;\n","import type { TWSObject } from \"../descriptors/$channel.ts\";\nimport type {\n  EmitOptions,\n  WebSocketConnection,\n  WebSocketDescriptorOptions,\n} from \"../interfaces/WebSocketInterfaces.ts\";\n\n/**\n * Abstract WebSocket server provider\n *\n * This class provides the base interface that must be implemented by\n * platform-specific providers (Node.js, Browser, etc.)\n */\nexport abstract class WebSocketServerProvider {\n  /**\n   * Register a WebSocket endpoint with its channel configuration\n   */\n  abstract registerEndpoint<\n    TClient extends TWSObject,\n    TServer extends TWSObject,\n  >(config: WebSocketDescriptorOptions<TClient, TServer>): void;\n\n  /**\n   * Emit a message to clients based on targeting criteria\n   *\n   * This method distributes messages across all server instances via pub/sub.\n   */\n  abstract emit<TClient extends TWSObject>(\n    channelPath: string,\n    options: EmitOptions<TClient>,\n  ): Promise<void>;\n\n  /**\n   * Get all active connections (local to this server instance)\n   */\n  abstract getConnections(): WebSocketConnection[];\n\n  /**\n   * Get connections in a specific room (local to this server instance)\n   */\n  abstract getRoomConnections(roomId: string): WebSocketConnection[];\n\n  /**\n   * Get connections for a specific user (local to this server instance)\n   */\n  abstract getUserConnections(userId: string): WebSocketConnection[];\n\n  /**\n   * Close a specific connection\n   */\n  abstract closeConnection(\n    connectionId: string,\n    code?: number,\n    reason?: string,\n  ): Promise<void>;\n}\n","import { $inject, createDescriptor, Descriptor, KIND } from \"alepha\";\nimport type {\n  EmitOptions,\n  WebSocketDescriptorOptions,\n} from \"../interfaces/WebSocketInterfaces.ts\";\nimport { WebSocketServerProvider } from \"../providers/WebSocketServerProvider.ts\";\nimport type { TWSObject } from \"./$channel.ts\";\n\n/**\n * Defines a WebSocket server endpoint for a specific channel.\n *\n * Server-side only. Creates a WebSocket endpoint that:\n * - Accepts connections from clients\n * - Validates incoming messages against the channel schema\n * - Provides room-based messaging\n * - Integrates with alepha/security for authentication (optional)\n * - Supports horizontal scaling via alepha/topic\n *\n * @example\n * ```typescript\n * class ChatController {\n *   chat = $websocket({\n *     channel: chatChannel,\n *     handler: async ({ connectionId, userId, roomId, message, reply }) => {\n *       // Broadcast to all in room except sender\n *       await reply({\n *         message: {\n *           type: \"append\",\n *           username: userId,\n *           content: message.content\n *         },\n *         exceptSelf: true\n *       });\n *     }\n *   });\n *\n *   async broadcastAnnouncement(roomId: string, text: string) {\n *     await this.chat.emit({\n *       roomId,\n *       message: {\n *         type: \"append\",\n *         username: \"System\",\n *         content: text\n *       }\n *     });\n *   }\n * }\n * ```\n */\nexport const $websocket = <\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n>(\n  options: WebSocketDescriptorOptions<TClient, TServer>,\n): WebSocketDescriptor<TClient, TServer> => {\n  return createDescriptor(WebSocketDescriptor<TClient, TServer>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class WebSocketDescriptor<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> extends Descriptor<WebSocketDescriptorOptions<TClient, TServer>> {\n  protected readonly webSocketServerProvider = $inject(WebSocketServerProvider);\n\n  protected onInit() {\n    this.webSocketServerProvider.registerEndpoint(this.options);\n  }\n\n  /**\n   * Emit message to clients\n   *\n   * Send messages from the server to connected clients based on targeting criteria.\n   * Messages are distributed across all server instances via pub/sub.\n   *\n   * @example\n   * ```typescript\n   * // Send to specific room\n   * await websocket.emit({\n   *   roomId: \"room-123\",\n   *   message: { type: \"update\", data: {...} }\n   * });\n   *\n   * // Send to specific user (all their connections)\n   * await websocket.emit({\n   *   userId: \"user-456\",\n   *   message: { type: \"notification\", text: \"Hello!\" }\n   * });\n   *\n   * // Send to multiple rooms, except certain users\n   * await websocket.emit({\n   *   roomIds: [\"room-1\", \"room-2\"],\n   *   exceptUserIds: [\"user-123\"],\n   *   message: { type: \"broadcast\", content: \"System announcement\" }\n   * });\n   * ```\n   */\n  public async emit(options: EmitOptions<TClient>): Promise<void> {\n    await this.webSocketServerProvider.emit(\n      this.options.channel.options.path,\n      options,\n    );\n  }\n}\n\n$websocket[KIND] = WebSocketDescriptor;\n","import {\n  $env,\n  $inject,\n  Alepha,\n  AlephaError,\n  type Static,\n  TypeBoxValue,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { ChannelDescriptor, TWSObject } from \"../descriptors/$channel.ts\";\n\nconst envSchema = t.object({\n  WEBSOCKET_URL: t.text({\n    default: \"\",\n    description:\n      \"WebSocket server URL (e.g., ws://localhost:3001). Leave empty to auto-detect.\",\n  }),\n  WEBSOCKET_RECONNECT_INTERVAL: t.integer({\n    default: 3000,\n    description: \"Reconnection interval in milliseconds\",\n  }),\n  WEBSOCKET_MAX_RECONNECT_ATTEMPTS: t.integer({\n    default: 10,\n    description:\n      \"Maximum number of reconnection attempts. Set to -1 for infinite.\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Room subscription\n */\ninterface RoomSubscription<TClient extends TWSObject> {\n  roomId: string;\n  handler: (message: Static<TClient>) => void;\n}\n\n/**\n * WebSocket channel connection\n *\n * Manages a single WebSocket connection to a channel with multiple room subscriptions.\n * One connection can handle multiple rooms on the same channel.\n */\nexport class WebSocketChannelConnection<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected ws?: WebSocket;\n  protected reconnectAttempts = 0;\n  protected reconnectTimer?: number;\n  protected messageQueue: Array<{ roomId: string; message: Static<TServer> }> =\n    [];\n\n  // Room subscriptions: Map<roomId, handler>\n  protected subscriptions = new Map<\n    string,\n    (message: Static<TClient>) => void\n  >();\n\n  // Connection state\n  public isConnected = false;\n  public isConnecting = false;\n  public isError = false;\n  public error?: Error;\n\n  // Connection callbacks\n  protected onConnectCallbacks = new Set<() => void>();\n  protected onDisconnectCallbacks = new Set<() => void>();\n  protected onErrorCallbacks = new Set<(error: Error) => void>();\n\n  constructor(\n    protected readonly channel: ChannelDescriptor<TClient, TServer>,\n    protected readonly options: {\n      url?: string;\n      autoReconnect?: boolean;\n      reconnectInterval?: number;\n      maxReconnectAttempts?: number;\n    },\n    protected readonly env: Static<typeof envSchema>,\n  ) {}\n\n  /**\n   * Build WebSocket URL\n   */\n  protected buildUrl(): string {\n    this.log.trace(\"Building WebSocket URL\", {\n      hasCustomUrl: !!this.options.url,\n      channelPath: this.channel.options.path,\n    });\n\n    if (this.options.url) {\n      this.log.debug(\"Using custom WebSocket URL\", { url: this.options.url });\n      return this.options.url;\n    }\n\n    // Auto-detect URL from current location (browser only)\n    if (typeof window !== \"undefined\") {\n      const protocol = window.location.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n      const host = window.location.host;\n      const path = this.channel.options.path;\n      // Send all room IDs as query params\n      const roomIds = Array.from(this.subscriptions.keys());\n      const roomParam =\n        roomIds.length > 0 ? `?roomIds=${roomIds.join(\",\")}` : \"\";\n      const url = `${protocol}//${host}${path}${roomParam}`;\n      this.log.debug(\"Auto-detected WebSocket URL\", { url, roomIds });\n      return url;\n    }\n\n    // Fallback to env URL\n    const url = `${this.env.WEBSOCKET_URL}${this.channel.options.path}`;\n    this.log.debug(\"Using env WebSocket URL\", { url });\n    return url;\n  }\n\n  /**\n   * Subscribe to a room on this channel\n   */\n  public subscribe(\n    roomId: string,\n    handler: (message: Static<TClient>) => void,\n    callbacks?: {\n      onConnect?: () => void;\n      onDisconnect?: () => void;\n      onError?: (error: Error) => void;\n    },\n  ): () => void {\n    this.log.debug(\"Subscribing to room\", {\n      roomId,\n      channelPath: this.channel.options.path,\n      existingSubscriptions: this.subscriptions.size,\n    });\n\n    // Add subscription\n    this.subscriptions.set(roomId, handler);\n\n    // Add callbacks\n    if (callbacks?.onConnect) this.onConnectCallbacks.add(callbacks.onConnect);\n    if (callbacks?.onDisconnect)\n      this.onDisconnectCallbacks.add(callbacks.onDisconnect);\n    if (callbacks?.onError) this.onErrorCallbacks.add(callbacks.onError);\n\n    // Connect if not already connected\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {\n      this.log.trace(\"No active connection, initiating connect\");\n      this.connect().catch((error) => {\n        this.log.error(\"Failed to connect:\", error);\n      });\n    } else {\n      this.log.trace(\"Already connected, reusing existing connection\");\n    }\n\n    // Return unsubscribe function\n    return () => {\n      this.log.debug(\"Unsubscribing from room\", { roomId });\n      this.subscriptions.delete(roomId);\n      if (callbacks?.onConnect)\n        this.onConnectCallbacks.delete(callbacks.onConnect);\n      if (callbacks?.onDisconnect)\n        this.onDisconnectCallbacks.delete(callbacks.onDisconnect);\n      if (callbacks?.onError) this.onErrorCallbacks.delete(callbacks.onError);\n\n      // Disconnect if no more subscriptions\n      if (this.subscriptions.size === 0) {\n        this.log.debug(\"No more subscriptions, disconnecting\");\n        this.disconnect();\n      }\n    };\n  }\n\n  /**\n   * Connect to WebSocket server\n   */\n  protected async connect(): Promise<void> {\n    if (this.ws?.readyState === WebSocket.OPEN) {\n      this.log.trace(\"Already connected, skipping connect\");\n      return;\n    }\n\n    this.isConnecting = true;\n    this.isError = false;\n    this.error = undefined;\n\n    const url = this.buildUrl();\n    this.log.info(\"Connecting to WebSocket server\", { url });\n\n    return new Promise((resolve, reject) => {\n      try {\n        const ws = new WebSocket(url);\n        this.ws = ws;\n\n        ws.onopen = () => {\n          this.isConnected = true;\n          this.isConnecting = false;\n          this.isError = false;\n          this.error = undefined;\n          this.reconnectAttempts = 0;\n\n          this.log.info(\"WebSocket connected\", {\n            channelPath: this.channel.options.path,\n            rooms: Array.from(this.subscriptions.keys()),\n          });\n\n          // Flush queued messages\n          if (this.messageQueue.length > 0) {\n            this.log.debug(\"Flushing queued messages\", {\n              count: this.messageQueue.length,\n            });\n          }\n          while (this.messageQueue.length > 0) {\n            const msg = this.messageQueue.shift();\n            if (msg) {\n              this.log.trace(\"Sending queued message\", { roomId: msg.roomId });\n              ws.send(\n                JSON.stringify({\n                  roomId: msg.roomId,\n                  message: msg.message,\n                }),\n              );\n            }\n          }\n\n          // Call all connect callbacks\n          for (const callback of this.onConnectCallbacks) {\n            callback();\n          }\n\n          resolve();\n        };\n\n        ws.onmessage = (event) => {\n          this.log.trace(\"Message received\", {\n            dataLength: event.data?.length,\n          });\n          this.handleMessage(event.data);\n        };\n\n        ws.onclose = (event) => {\n          this.isConnected = false;\n          this.isConnecting = false;\n          this.ws = undefined;\n\n          this.log.info(\"WebSocket disconnected\", {\n            code: event.code,\n            reason: event.reason,\n            wasClean: event.wasClean,\n          });\n\n          // Call all disconnect callbacks\n          for (const callback of this.onDisconnectCallbacks) {\n            callback();\n          }\n\n          // Attempt reconnection\n          if (this.options.autoReconnect !== false) {\n            this.scheduleReconnect();\n          }\n        };\n\n        ws.onerror = () => {\n          const err = new Error(\"WebSocket connection error\");\n          this.isError = true;\n          this.error = err;\n          this.isConnecting = false;\n\n          this.log.error(\"WebSocket error\", { url });\n\n          // Call all error callbacks\n          for (const callback of this.onErrorCallbacks) {\n            callback(err);\n          }\n\n          reject(err);\n        };\n      } catch (err) {\n        const error =\n          err instanceof Error ? err : new Error(\"Connection failed\");\n        this.isError = true;\n        this.error = error;\n        this.isConnecting = false;\n\n        this.log.error(\"Failed to create WebSocket\", { error: error.message });\n\n        // Call all error callbacks\n        for (const callback of this.onErrorCallbacks) {\n          callback(error);\n        }\n\n        reject(error);\n      }\n    });\n  }\n\n  /**\n   * Handle incoming message\n   */\n  protected handleMessage(data: string): void {\n    try {\n      const parsed = JSON.parse(data);\n      this.log.trace(\"Parsed incoming message\", { parsed });\n\n      // Validate incoming message against schema\n      const inSchema = this.channel.options.schema.in;\n      this.alepha.codec.validate(inSchema, parsed);\n\n      this.log.debug(\"Dispatching message to handlers\", {\n        handlerCount: this.subscriptions.size,\n      });\n\n      // Extract roomId from message if present (server should send it back)\n      // For now, broadcast to all subscribed rooms\n      // TODO: Server should include roomId in response\n      for (const handler of this.subscriptions.values()) {\n        handler(parsed as Static<TClient>);\n      }\n    } catch (err) {\n      this.log.error(\"Error handling message:\", err);\n    }\n  }\n\n  /**\n   * Send message to a specific room\n   */\n  public async send(roomId: string, message: Static<TServer>): Promise<void> {\n    this.log.trace(\"Sending message\", { roomId, message });\n\n    // Validate outgoing message against schema\n    const outSchema = this.channel.options.schema.out;\n    if (!TypeBoxValue.Check(outSchema, message)) {\n      const errors = Array.from(TypeBoxValue.Errors(outSchema, message));\n      this.log.warn(\"Message validation failed\", { errors });\n      throw new Error(\n        `Message validation failed: ${errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {\n      // Queue message\n      this.log.debug(\"Connection not ready, queuing message\", {\n        roomId,\n        queueSize: this.messageQueue.length + 1,\n      });\n      this.messageQueue.push({ roomId, message });\n      return;\n    }\n\n    this.log.debug(\"Sending message to server\", { roomId });\n    this.ws.send(\n      JSON.stringify({\n        roomId,\n        message,\n      }),\n    );\n  }\n\n  /**\n   * Schedule reconnection\n   */\n  protected scheduleReconnect(): void {\n    const maxAttempts =\n      this.options.maxReconnectAttempts ??\n      this.env.WEBSOCKET_MAX_RECONNECT_ATTEMPTS ??\n      10;\n    const reconnectInterval =\n      this.options.reconnectInterval ??\n      this.env.WEBSOCKET_RECONNECT_INTERVAL ??\n      3000;\n\n    if (maxAttempts !== -1 && this.reconnectAttempts >= maxAttempts) {\n      this.log.warn(\"Max reconnection attempts reached\", {\n        attempts: this.reconnectAttempts,\n        maxAttempts,\n      });\n      return;\n    }\n\n    this.reconnectAttempts++;\n\n    this.log.debug(\"Scheduling reconnection\", {\n      attempt: this.reconnectAttempts,\n      maxAttempts,\n      intervalMs: reconnectInterval,\n    });\n\n    this.reconnectTimer = window.setTimeout(() => {\n      this.log.info(\"Reconnecting...\", {\n        attempt: this.reconnectAttempts,\n        maxAttempts,\n      });\n      this.connect().catch((error) => {\n        this.log.error(\"Reconnection failed:\", error);\n      });\n    }, reconnectInterval);\n  }\n\n  /**\n   * Disconnect from server\n   */\n  public disconnect(): void {\n    this.log.debug(\"Disconnecting\", {\n      hasTimer: !!this.reconnectTimer,\n      hasConnection: !!this.ws,\n    });\n\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = undefined;\n    }\n\n    if (this.ws) {\n      this.ws.close();\n      this.ws = undefined;\n    }\n\n    this.isConnected = false;\n    this.isConnecting = false;\n\n    this.log.info(\"Disconnected\");\n  }\n\n  /**\n   * Reconnect manually\n   */\n  public reconnect(): void {\n    this.log.info(\"Manual reconnect requested\");\n    this.disconnect();\n    this.connect().catch((error) => {\n      this.log.error(\"Manual reconnection failed:\", error);\n    });\n  }\n\n  /**\n   * Check if subscribed to a room\n   */\n  public hasRoom(roomId: string): boolean {\n    return this.subscriptions.has(roomId);\n  }\n\n  /**\n   * Get all subscribed rooms\n   */\n  public getRooms(): string[] {\n    return Array.from(this.subscriptions.keys());\n  }\n}\n\n/**\n * WebSocket Client Service\n *\n * Manages WebSocket connections from the client side (browser).\n * One connection per channel, multiple rooms per connection.\n */\nexport class WebSocketClient {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n\n  // Map<channelPath, connection>\n  protected connections = new Map<\n    string,\n    WebSocketChannelConnection<any, any>\n  >();\n\n  /**\n   * Subscribe to a room on a channel\n   */\n  public subscribe<TClient extends TWSObject, TServer extends TWSObject>(\n    roomId: string,\n    channel: ChannelDescriptor<TClient, TServer>,\n    handler: (message: Static<TClient>) => void,\n    options: {\n      url?: string;\n      autoReconnect?: boolean;\n      reconnectInterval?: number;\n      maxReconnectAttempts?: number;\n      onConnect?: () => void;\n      onDisconnect?: () => void;\n      onError?: (error: Error) => void;\n    } = {},\n  ): () => void {\n    const channelPath = channel.options.path;\n\n    this.log.debug(\"WebSocketClient.subscribe\", {\n      roomId,\n      channelPath,\n      existingConnections: this.connections.size,\n    });\n\n    // Get or create connection for this channel\n    let connection = this.connections.get(\n      channelPath,\n    ) as WebSocketChannelConnection<TClient, TServer>;\n\n    if (!connection) {\n      this.log.debug(\"Creating new connection for channel\", { channelPath });\n      connection = this.alepha.inject(WebSocketChannelConnection, {\n        lifetime: \"transient\",\n        args: [\n          channel,\n          {\n            url: options.url,\n            autoReconnect: options.autoReconnect,\n            reconnectInterval: options.reconnectInterval,\n            maxReconnectAttempts: options.maxReconnectAttempts,\n          },\n          this.env,\n        ],\n      }) as WebSocketChannelConnection<any, any>;\n\n      this.connections.set(channelPath, connection);\n    } else {\n      this.log.trace(\"Reusing existing connection for channel\", {\n        channelPath,\n      });\n    }\n\n    // Subscribe to the room on this connection\n    const unsubscribe = connection.subscribe(roomId, handler, {\n      onConnect: options.onConnect,\n      onDisconnect: options.onDisconnect,\n      onError: options.onError,\n    });\n\n    // Return unsubscribe function\n    return () => {\n      this.log.debug(\"WebSocketClient.unsubscribe\", { roomId, channelPath });\n      unsubscribe();\n\n      // Clean up connection if no more rooms\n      if (connection.getRooms().length === 0) {\n        this.log.debug(\"Removing connection for channel (no more rooms)\", {\n          channelPath,\n        });\n        this.connections.delete(channelPath);\n      }\n    };\n  }\n\n  /**\n   * Send message to a room on a channel\n   */\n  public async send<TClient extends TWSObject, TServer extends TWSObject>(\n    roomId: string,\n    channel: ChannelDescriptor<TClient, TServer>,\n    message: Static<TServer>,\n  ): Promise<void> {\n    const channelPath = channel.options.path;\n\n    this.log.trace(\"WebSocketClient.send\", { roomId, channelPath });\n\n    const connection = this.connections.get(\n      channelPath,\n    ) as WebSocketChannelConnection<TClient, TServer>;\n\n    if (!connection) {\n      this.log.warn(\"Attempted to send on unsubscribed channel\", {\n        channelPath,\n      });\n      throw new AlephaError(\n        `Not subscribed to channel ${channelPath}. Subscribe first before sending messages.`,\n      );\n    }\n\n    await connection.send(roomId, message);\n  }\n\n  /**\n   * Get connection for a channel\n   */\n  public getConnection<TClient extends TWSObject, TServer extends TWSObject>(\n    channel: ChannelDescriptor<TClient, TServer>,\n  ): WebSocketChannelConnection<TClient, TServer> | undefined {\n    const channelPath = channel.options.path;\n    const connection = this.connections.get(channelPath) as\n      | WebSocketChannelConnection<TClient, TServer>\n      | undefined;\n\n    this.log.trace(\"WebSocketClient.getConnection\", {\n      channelPath,\n      found: !!connection,\n    });\n\n    return connection;\n  }\n\n  /**\n   * Disconnect all connections\n   */\n  public disconnectAll(): void {\n    this.log.info(\"Disconnecting all connections\", {\n      count: this.connections.size,\n    });\n\n    for (const connection of this.connections.values()) {\n      connection.disconnect();\n    }\n    this.connections.clear();\n\n    this.log.debug(\"All connections disconnected\");\n  }\n}\n","/**\n * Base WebSocket error class\n */\nexport class WebSocketError extends Error {\n  constructor(\n    message: string,\n    public readonly code?: number,\n  ) {\n    super(message);\n    this.name = \"WebSocketError\";\n  }\n}\n\n/**\n * Error thrown when WebSocket connection fails\n */\nexport class WebSocketConnectionError extends WebSocketError {\n  constructor(message: string, code?: number) {\n    super(message, code);\n    this.name = \"WebSocketConnectionError\";\n  }\n}\n\n/**\n * Error thrown when WebSocket message validation fails\n */\nexport class WebSocketValidationError extends WebSocketError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"WebSocketValidationError\";\n  }\n}\n","import type { Static } from \"alepha\";\nimport type { ChannelDescriptor, TWSObject } from \"../descriptors/$channel.ts\";\n\n/**\n * WebSocket connection interface\n */\nexport interface WebSocketConnection {\n  /**\n   * Unique connection ID\n   */\n  id: string;\n\n  /**\n   * User ID (if authenticated and security module is used)\n   */\n  userId?: string;\n\n  /**\n   * Room IDs that this connection is currently in\n   */\n  roomIds: string[];\n\n  /**\n   * Send a message to this connection\n   */\n  send(message: any): Promise<void>;\n\n  /**\n   * Close this connection\n   */\n  close(code?: number, reason?: string): Promise<void>;\n\n  /**\n   * Connection metadata (custom data)\n   */\n  metadata?: Record<string, any>;\n\n  /**\n   * Connection state\n   */\n  readyState: WebSocketState;\n}\n\n/**\n * WebSocket state enum\n */\nexport enum WebSocketState {\n  CONNECTING = 0,\n  OPEN = 1,\n  CLOSING = 2,\n  CLOSED = 3,\n}\n\n/**\n * WebSocket endpoint configuration (server-side)\n */\nexport interface WebSocketDescriptorOptions<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> {\n  /**\n   * Channel definition with schema and path\n   */\n  channel: ChannelDescriptor<TClient, TServer>;\n\n  /**\n   * Handler for incoming messages from clients\n   */\n  handler: WebSocketHandler<TClient, TServer>;\n\n  /**\n   * Optional connection handler (called when a client connects)\n   */\n  onConnect?: (params: {\n    /**\n     * Unique connection ID of the client\n     */\n    connectionId: string;\n\n    /**\n     * User ID of the connected client (if authenticated and security module is used)\n     */\n    userId?: string;\n\n    /**\n     * Room IDs that the client is connecting to\n     */\n    roomIds: string[];\n  }) => Promise<void> | void;\n\n  /**\n   * Optional disconnection handler (called when a client disconnects)\n   */\n  onDisconnect?: (params: {\n    /**\n     * Unique connection ID of the client\n     */\n    connectionId: string;\n\n    /**\n     * User ID of the connected client (if authenticated and security module is used)\n     */\n    userId?: string;\n\n    /**\n     * Room IDs that the client was connected to\n     */\n    roomIds: string[];\n  }) => Promise<void> | void;\n\n  /**\n   * Change WebSocket server provider (for custom implementations)\n   */\n  provider?: any;\n\n  /**\n   * Whether to enforce security (authentication, authorization) on this WebSocket endpoint\n   * Requires alepha/security integration\n   */\n  secure?: boolean;\n\n  /**\n   * Limit number of connections per user (if authenticated)\n   */\n  maxConnectionsPerUser?: number;\n}\n\n/**\n * WebSocket message handler\n */\nexport type WebSocketHandler<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> = (\n  context: WebSocketHandlerContext<TClient, TServer>,\n) => Promise<void> | void;\n\n/**\n * WebSocket handler context\n */\nexport interface WebSocketHandlerContext<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> {\n  /**\n   * Unique connection ID of the client\n   */\n  connectionId: string;\n\n  /**\n   * User ID of the connected client (if authenticated and security module is used)\n   */\n  userId?: string;\n\n  /**\n   * Room ID that the client sent the message from\n   */\n  roomId: string;\n\n  /**\n   * The parsed and validated message from the client\n   */\n  message: Static<TServer>;\n\n  /**\n   * Reply function tailored to current context (connectionId, roomId)\n   */\n  reply: (options: {\n    /**\n     * Message to send\n     */\n    message: Static<TClient>;\n\n    /**\n     * Optional: specify room ID to send to (defaults to sender's room ID)\n     */\n    roomId?: string;\n\n    /**\n     * Optional: exclude the sender connection from receiving the message\n     * Will populate exceptConnectionIds with sender connection ID behind the scenes\n     */\n    exceptSelf?: boolean;\n\n    /**\n     * Optional: exclude specific connection IDs from receiving the message\n     */\n    exceptConnectionIds?: string[];\n\n    /**\n     * Optional: exclude specific user IDs from receiving the message\n     * Requires alepha/security integration\n     */\n    exceptUserIds?: string[];\n  }) => Promise<void>;\n}\n\n/**\n * Emit options for sending messages from the server\n */\nexport interface EmitOptions<TClient extends TWSObject> {\n  /**\n   * Message to send to clients\n   */\n  message: Static<TClient>;\n\n  /**\n   * Room ID to send the message to\n   */\n  roomId?: string;\n\n  /**\n   * Room IDs to send the message to\n   */\n  roomIds?: string[];\n\n  /**\n   * User ID to send the message to (if authenticated)\n   */\n  userId?: string;\n\n  /**\n   * User IDs to send the message to (if authenticated)\n   */\n  userIds?: string[];\n\n  /**\n   * Connection ID to send the message to\n   */\n  connectionId?: string;\n\n  /**\n   * Connection IDs to send the message to\n   */\n  connectionIds?: string[];\n\n  /**\n   * Optional: exclude specific connection IDs from receiving the message\n   */\n  exceptConnectionIds?: string[];\n\n  /**\n   * Optional: exclude specific user IDs from receiving the message\n   * Requires alepha/security integration\n   */\n  exceptUserIds?: string[];\n}\n","import { $logger } from \"alepha/logger\";\n\n/**\n * Manages WebSocket room memberships\n *\n * Rooms are logical groupings of connections. A connection can be in multiple rooms,\n * and messages can be targeted to specific rooms.\n */\nexport class RoomManager {\n  protected readonly log = $logger();\n\n  /**\n   * Maps roomId → Set<connectionId>\n   */\n  protected readonly rooms = new Map<string, Set<string>>();\n\n  /**\n   * Maps connectionId → Set<roomId>\n   * Inverse index for fast lookup of connection's rooms\n   */\n  protected readonly connectionRooms = new Map<string, Set<string>>();\n\n  /**\n   * Join a connection to one or more rooms\n   */\n  public joinRooms(connectionId: string, roomIds: string[]): void {\n    for (const roomId of roomIds) {\n      this.joinRoom(connectionId, roomId);\n    }\n  }\n\n  /**\n   * Join a connection to a room\n   */\n  public joinRoom(connectionId: string, roomId: string): void {\n    // Add to room\n    let room = this.rooms.get(roomId);\n    if (!room) {\n      room = new Set();\n      this.rooms.set(roomId, room);\n    }\n    room.add(connectionId);\n\n    // Update inverse index\n    let connRooms = this.connectionRooms.get(connectionId);\n    if (!connRooms) {\n      connRooms = new Set();\n      this.connectionRooms.set(connectionId, connRooms);\n    }\n    connRooms.add(roomId);\n\n    this.log.debug(`Connection ${connectionId} joined room ${roomId}`);\n  }\n\n  /**\n   * Leave a connection from a room\n   */\n  public leaveRoom(connectionId: string, roomId: string): void {\n    // Remove from room\n    const room = this.rooms.get(roomId);\n    if (room) {\n      room.delete(connectionId);\n      if (room.size === 0) {\n        this.rooms.delete(roomId);\n      }\n    }\n\n    // Update inverse index\n    const connRooms = this.connectionRooms.get(connectionId);\n    if (connRooms) {\n      connRooms.delete(roomId);\n      if (connRooms.size === 0) {\n        this.connectionRooms.delete(connectionId);\n      }\n    }\n\n    this.log.debug(`Connection ${connectionId} left room ${roomId}`);\n  }\n\n  /**\n   * Remove a connection from all rooms\n   */\n  public leaveAllRooms(connectionId: string): void {\n    const connRooms = this.connectionRooms.get(connectionId);\n    if (!connRooms) {\n      return;\n    }\n\n    for (const roomId of connRooms) {\n      const room = this.rooms.get(roomId);\n      if (room) {\n        room.delete(connectionId);\n        if (room.size === 0) {\n          this.rooms.delete(roomId);\n        }\n      }\n    }\n\n    this.connectionRooms.delete(connectionId);\n    this.log.debug(`Connection ${connectionId} left all rooms`);\n  }\n\n  /**\n   * Get all connection IDs in a room\n   */\n  public getRoomConnections(roomId: string): string[] {\n    const room = this.rooms.get(roomId);\n    return room ? Array.from(room) : [];\n  }\n\n  /**\n   * Get all room IDs for a connection\n   */\n  public getConnectionRooms(connectionId: string): string[] {\n    const connRooms = this.connectionRooms.get(connectionId);\n    return connRooms ? Array.from(connRooms) : [];\n  }\n\n  /**\n   * Check if a connection is in a room\n   */\n  public isInRoom(connectionId: string, roomId: string): boolean {\n    const connRooms = this.connectionRooms.get(connectionId);\n    return connRooms ? connRooms.has(roomId) : false;\n  }\n\n  /**\n   * Get all active rooms\n   */\n  public getAllRooms(): string[] {\n    return Array.from(this.rooms.keys());\n  }\n\n  /**\n   * Get total number of connections across all rooms\n   */\n  public getTotalConnections(): number {\n    return this.connectionRooms.size;\n  }\n\n  /**\n   * Get room statistics\n   */\n  public getStats(): {\n    totalRooms: number;\n    totalConnections: number;\n    roomSizes: Map<string, number>;\n  } {\n    const roomSizes = new Map<string, number>();\n    for (const [roomId, connections] of this.rooms) {\n      roomSizes.set(roomId, connections.size);\n    }\n\n    return {\n      totalRooms: this.rooms.size,\n      totalConnections: this.connectionRooms.size,\n      roomSizes,\n    };\n  }\n}\n","import { type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { $topic } from \"alepha/topic\";\n\n/**\n * WebSocket message distribution event\n */\nconst webSocketMessageSchema = {\n  payload: t.object({\n    /**\n     * Channel path (e.g., \"/ws/chat\")\n     */\n    channelPath: t.text(),\n\n    /**\n     * Target room ID(s)\n     */\n    roomIds: t.optional(t.array(t.text())),\n\n    /**\n     * Target user ID(s)\n     */\n    userIds: t.optional(t.array(t.text())),\n\n    /**\n     * Target connection ID(s)\n     */\n    connectionIds: t.optional(t.array(t.text())),\n\n    /**\n     * Exclude connection ID(s) from receiving the message\n     */\n    exceptConnectionIds: t.optional(t.array(t.text())),\n\n    /**\n     * Exclude user ID(s) from receiving the message\n     */\n    exceptUserIds: t.optional(t.array(t.text())),\n\n    /**\n     * The message payload to send\n     */\n    message: t.any(),\n  }),\n};\n\n/**\n * WebSocket Topic Service\n *\n * Manages pub/sub messaging for WebSocket connections across multiple server instances.\n * Uses alepha/topic for cross-instance message distribution, enabling horizontal scaling.\n *\n * When a WebSocket message needs to be sent:\n * 1. Server instance A publishes to the topic\n * 2. All server instances (A, B, C, etc.) receive the message\n * 3. Each instance sends to its local connections that match the criteria\n *\n * This enables:\n * - Multiple server instances handling WebSocket connections\n * - Redis-backed message distribution (with alepha/topic/redis)\n * - Horizontal scaling without losing messages\n */\nexport class WebSocketTopicService {\n  protected readonly log = $logger();\n\n  /**\n   * Handler function to be called when a message is received from the topic\n   * This is set by the WebSocket provider during initialization\n   */\n  public messageHandler?: (\n    event: Static<(typeof webSocketMessageSchema)[\"payload\"]>,\n  ) => Promise<void>;\n\n  /**\n   * Topic for distributing WebSocket messages across server instances\n   */\n  public readonly topic = $topic({\n    name: \"websocket:broadcast\",\n    description:\n      \"Distributes WebSocket messages across server instances for horizontal scaling\",\n    schema: webSocketMessageSchema,\n    handler: async (message) => {\n      if (this.messageHandler) {\n        await this.messageHandler(message.payload);\n      }\n    },\n  });\n\n  /**\n   * Publish a message to be distributed across all server instances\n   */\n  public async publish(\n    event: Static<(typeof webSocketMessageSchema)[\"payload\"]>,\n  ): Promise<void> {\n    await this.topic.publish(event);\n  }\n\n  /**\n   * Set the handler for incoming messages\n   */\n  public setMessageHandler(\n    handler: (\n      event: Static<(typeof webSocketMessageSchema)[\"payload\"]>,\n    ) => Promise<void>,\n  ): void {\n    this.messageHandler = handler;\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaTopic } from \"alepha/topic\";\nimport { $channel } from \"./descriptors/$channel.ts\";\nimport { $websocket } from \"./descriptors/$websocket.ts\";\nimport { WebSocketClient } from \"./services/WebSocketClient.ts\";\n\n/**\n * alepha/websocket (Browser)\n *\n * Browser-side WebSocket client module. Provides WebSocketClient service\n * for managing WebSocket connections from the browser.\n *\n * For React applications, use alepha/react/websocket with the useRoom hook.\n */\nexport * from \"./index.shared.ts\";\n\nexport const AlephaWebSocket = $module({\n  name: \"alepha.websocket\",\n  descriptors: [$channel, $websocket],\n  services: [WebSocketClient],\n  register: (alepha: Alepha) => {\n    alepha.with(AlephaTopic);\n    alepha.with(WebSocketClient);\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.browser.js","names":["channel: ChannelPrimitive<TClient, TServer>","options: {\n      url?: string;\n      autoReconnect?: boolean;\n      reconnectInterval?: number;\n      maxReconnectAttempts?: number;\n    }","env: Static<typeof envSchema>","url","code?: number"],"sources":["../../src/websocket/primitives/$channel.ts","../../src/websocket/providers/WebSocketServerProvider.ts","../../src/websocket/primitives/$websocket.ts","../../src/websocket/services/WebSocketClient.ts","../../src/websocket/errors/WebSocketError.ts","../../src/websocket/interfaces/WebSocketInterfaces.ts","../../src/websocket/services/RoomManager.ts","../../src/websocket/services/WebSocketTopicService.ts","../../src/websocket/index.browser.ts"],"sourcesContent":["import {\n  createPrimitive,\n  KIND,\n  Primitive,\n  type TObject,\n  type TString,\n  type TUnion,\n} from \"alepha\";\n\nexport type TWSObject = TObject | TUnion;\n\n/**\n * Channel primitive options\n */\nexport interface ChannelPrimitiveOptions<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> {\n  /**\n   * WebSocket endpoint path (e.g., \"/ws/chat\")\n   */\n  path: string;\n\n  /**\n   * Optional description for documentation\n   */\n  description?: string;\n\n  /**\n   * Message schemas for bidirectional communication\n   */\n  schema: {\n    /**\n     * Optional room ID schema validation\n     * Default: t.text() (any string)\n     * Can be enforced at application level: t.uuid(), t.regex(/^[a-f0-9\\-]{36}$/)\n     */\n    roomId?: TString;\n\n    /**\n     * Messages from server to client\n     * This is what clients will receive\n     */\n    in: TClient;\n\n    /**\n     * Messages from client to server\n     * This is what the server will receive\n     */\n    out: TServer;\n  };\n}\n\n/**\n * Defines a WebSocket channel with specified client and server message schemas.\n *\n * Channels must be defined as class properties to be registered in the Alepha context.\n * They define the \"vocabulary\" for communication - the schema for messages flowing\n * in both directions (server→client and client→server).\n *\n * @example Server-side with $websocket\n * ```typescript\n * class ChatController {\n *   // Channel must be defined inside a class\n *   chatChannel = $channel({\n *     path: \"/ws/chat\",\n *     description: \"Real-time chat channel\",\n *     schema: {\n *       // Server → Client messages\n *       in: t.union([\n *         t.object({\n *           type: t.const(\"append\"),\n *           content: t.text(),\n *           username: t.text()\n *         }),\n *         t.object({\n *           type: t.const(\"system\"),\n *           message: t.text()\n *         })\n *       ]),\n *       // Client → Server messages\n *       out: t.object({\n *         content: t.text()\n *       })\n *     }\n *   });\n *\n *   chat = $websocket({\n *     channel: this.chatChannel,\n *     handler: async ({ message, reply }) => {\n *       await reply({\n *         message: { type: \"append\", content: message.content, username: \"user\" }\n *       });\n *     }\n *   });\n * }\n * ```\n *\n * @example Browser-side with useRoom\n * ```typescript\n * // Define channel in a class for browser context\n * class ChatClient {\n *   chatChannel = $channel({\n *     path: \"/ws/chat\",\n *     schema: { in: inSchema, out: outSchema }\n *   });\n * }\n *\n * // Use in React component\n * function Chat() {\n *   const client = useInject(ChatClient);\n *   const chat = useRoom({ roomId: \"lobby\", channel: client.chatChannel, handler: ... }, []);\n * }\n * ```\n */\nexport const $channel = <TClient extends TWSObject, TServer extends TWSObject>(\n  options: ChannelPrimitiveOptions<TClient, TServer>,\n): ChannelPrimitive<TClient, TServer> => {\n  return createPrimitive(ChannelPrimitive<TClient, TServer>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class ChannelPrimitive<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> extends Primitive<ChannelPrimitiveOptions<TClient, TServer>> {\n  // Channels are just schema definitions - no initialization logic needed\n}\n\n$channel[KIND] = ChannelPrimitive;\n","import type {\n  EmitOptions,\n  WebSocketConnection,\n  WebSocketPrimitiveOptions,\n} from \"../interfaces/WebSocketInterfaces.ts\";\nimport type { TWSObject } from \"../primitives/$channel.ts\";\n\n/**\n * Abstract WebSocket server provider\n *\n * This class provides the base interface that must be implemented by\n * platform-specific providers (Node.js, Browser, etc.)\n */\nexport abstract class WebSocketServerProvider {\n  /**\n   * Register a WebSocket endpoint with its channel configuration\n   */\n  abstract registerEndpoint<\n    TClient extends TWSObject,\n    TServer extends TWSObject,\n  >(config: WebSocketPrimitiveOptions<TClient, TServer>): void;\n\n  /**\n   * Emit a message to clients based on targeting criteria\n   *\n   * This method distributes messages across all server instances via pub/sub.\n   */\n  abstract emit<TClient extends TWSObject>(\n    channelPath: string,\n    options: EmitOptions<TClient>,\n  ): Promise<void>;\n\n  /**\n   * Get all active connections (local to this server instance)\n   */\n  abstract getConnections(): WebSocketConnection[];\n\n  /**\n   * Get connections in a specific room (local to this server instance)\n   */\n  abstract getRoomConnections(roomId: string): WebSocketConnection[];\n\n  /**\n   * Get connections for a specific user (local to this server instance)\n   */\n  abstract getUserConnections(userId: string): WebSocketConnection[];\n\n  /**\n   * Close a specific connection\n   */\n  abstract closeConnection(\n    connectionId: string,\n    code?: number,\n    reason?: string,\n  ): Promise<void>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type {\n  EmitOptions,\n  WebSocketPrimitiveOptions,\n} from \"../interfaces/WebSocketInterfaces.ts\";\nimport { WebSocketServerProvider } from \"../providers/WebSocketServerProvider.ts\";\nimport type { TWSObject } from \"./$channel.ts\";\n\n/**\n * Defines a WebSocket server endpoint for a specific channel.\n *\n * Server-side only. Creates a WebSocket endpoint that:\n * - Accepts connections from clients\n * - Validates incoming messages against the channel schema\n * - Provides room-based messaging\n * - Integrates with alepha/security for authentication (optional)\n * - Supports horizontal scaling via alepha/topic\n *\n * @example\n * ```typescript\n * class ChatController {\n *   chat = $websocket({\n *     channel: chatChannel,\n *     handler: async ({ connectionId, userId, roomId, message, reply }) => {\n *       // Broadcast to all in room except sender\n *       await reply({\n *         message: {\n *           type: \"append\",\n *           username: userId,\n *           content: message.content\n *         },\n *         exceptSelf: true\n *       });\n *     }\n *   });\n *\n *   async broadcastAnnouncement(roomId: string, text: string) {\n *     await this.chat.emit({\n *       roomId,\n *       message: {\n *         type: \"append\",\n *         username: \"System\",\n *         content: text\n *       }\n *     });\n *   }\n * }\n * ```\n */\nexport const $websocket = <\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n>(\n  options: WebSocketPrimitiveOptions<TClient, TServer>,\n): WebSocketPrimitive<TClient, TServer> => {\n  return createPrimitive(WebSocketPrimitive<TClient, TServer>, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class WebSocketPrimitive<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> extends Primitive<WebSocketPrimitiveOptions<TClient, TServer>> {\n  protected readonly webSocketServerProvider = $inject(WebSocketServerProvider);\n\n  protected onInit() {\n    this.webSocketServerProvider.registerEndpoint(this.options);\n  }\n\n  /**\n   * Emit message to clients\n   *\n   * Send messages from the server to connected clients based on targeting criteria.\n   * Messages are distributed across all server instances via pub/sub.\n   *\n   * @example\n   * ```typescript\n   * // Send to specific room\n   * await websocket.emit({\n   *   roomId: \"room-123\",\n   *   message: { type: \"update\", data: {...} }\n   * });\n   *\n   * // Send to specific user (all their connections)\n   * await websocket.emit({\n   *   userId: \"user-456\",\n   *   message: { type: \"notification\", text: \"Hello!\" }\n   * });\n   *\n   * // Send to multiple rooms, except certain users\n   * await websocket.emit({\n   *   roomIds: [\"room-1\", \"room-2\"],\n   *   exceptUserIds: [\"user-123\"],\n   *   message: { type: \"broadcast\", content: \"System announcement\" }\n   * });\n   * ```\n   */\n  public async emit(options: EmitOptions<TClient>): Promise<void> {\n    await this.webSocketServerProvider.emit(\n      this.options.channel.options.path,\n      options,\n    );\n  }\n}\n\n$websocket[KIND] = WebSocketPrimitive;\n","import {\n  $env,\n  $inject,\n  Alepha,\n  AlephaError,\n  type Static,\n  TypeBoxValue,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { ChannelPrimitive, TWSObject } from \"../primitives/$channel.ts\";\n\nconst envSchema = t.object({\n  WEBSOCKET_URL: t.text({\n    default: \"\",\n    description:\n      \"WebSocket server URL (e.g., ws://localhost:3001). Leave empty to auto-detect.\",\n  }),\n  WEBSOCKET_RECONNECT_INTERVAL: t.integer({\n    default: 3000,\n    description: \"Reconnection interval in milliseconds\",\n  }),\n  WEBSOCKET_MAX_RECONNECT_ATTEMPTS: t.integer({\n    default: 10,\n    description:\n      \"Maximum number of reconnection attempts. Set to -1 for infinite.\",\n  }),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Room subscription\n */\ninterface RoomSubscription<TClient extends TWSObject> {\n  roomId: string;\n  handler: (message: Static<TClient>) => void;\n}\n\n/**\n * WebSocket channel connection\n *\n * Manages a single WebSocket connection to a channel with multiple room subscriptions.\n * One connection can handle multiple rooms on the same channel.\n */\nexport class WebSocketChannelConnection<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected ws?: WebSocket;\n  protected reconnectAttempts = 0;\n  protected reconnectTimer?: number;\n  protected messageQueue: Array<{ roomId: string; message: Static<TServer> }> =\n    [];\n\n  // Room subscriptions: Map<roomId, handler>\n  protected subscriptions = new Map<\n    string,\n    (message: Static<TClient>) => void\n  >();\n\n  // Connection state\n  public isConnected = false;\n  public isConnecting = false;\n  public isError = false;\n  public error?: Error;\n\n  // Connection callbacks\n  protected onConnectCallbacks = new Set<() => void>();\n  protected onDisconnectCallbacks = new Set<() => void>();\n  protected onErrorCallbacks = new Set<(error: Error) => void>();\n\n  constructor(\n    protected readonly channel: ChannelPrimitive<TClient, TServer>,\n    protected readonly options: {\n      url?: string;\n      autoReconnect?: boolean;\n      reconnectInterval?: number;\n      maxReconnectAttempts?: number;\n    },\n    protected readonly env: Static<typeof envSchema>,\n  ) {}\n\n  /**\n   * Build WebSocket URL\n   */\n  protected buildUrl(): string {\n    this.log.trace(\"Building WebSocket URL\", {\n      hasCustomUrl: !!this.options.url,\n      channelPath: this.channel.options.path,\n    });\n\n    if (this.options.url) {\n      this.log.debug(\"Using custom WebSocket URL\", { url: this.options.url });\n      return this.options.url;\n    }\n\n    // Auto-detect URL from current location (browser only)\n    if (typeof window !== \"undefined\") {\n      const protocol = window.location.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n      const host = window.location.host;\n      const path = this.channel.options.path;\n      // Send all room IDs as query params\n      const roomIds = Array.from(this.subscriptions.keys());\n      const roomParam =\n        roomIds.length > 0 ? `?roomIds=${roomIds.join(\",\")}` : \"\";\n      const url = `${protocol}//${host}${path}${roomParam}`;\n      this.log.debug(\"Auto-detected WebSocket URL\", { url, roomIds });\n      return url;\n    }\n\n    // Fallback to env URL\n    const url = `${this.env.WEBSOCKET_URL}${this.channel.options.path}`;\n    this.log.debug(\"Using env WebSocket URL\", { url });\n    return url;\n  }\n\n  /**\n   * Subscribe to a room on this channel\n   */\n  public subscribe(\n    roomId: string,\n    handler: (message: Static<TClient>) => void,\n    callbacks?: {\n      onConnect?: () => void;\n      onDisconnect?: () => void;\n      onError?: (error: Error) => void;\n    },\n  ): () => void {\n    this.log.debug(\"Subscribing to room\", {\n      roomId,\n      channelPath: this.channel.options.path,\n      existingSubscriptions: this.subscriptions.size,\n    });\n\n    // Add subscription\n    this.subscriptions.set(roomId, handler);\n\n    // Add callbacks\n    if (callbacks?.onConnect) this.onConnectCallbacks.add(callbacks.onConnect);\n    if (callbacks?.onDisconnect)\n      this.onDisconnectCallbacks.add(callbacks.onDisconnect);\n    if (callbacks?.onError) this.onErrorCallbacks.add(callbacks.onError);\n\n    // Connect if not already connected\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {\n      this.log.trace(\"No active connection, initiating connect\");\n      this.connect().catch((error) => {\n        this.log.error(\"Failed to connect:\", error);\n      });\n    } else {\n      this.log.trace(\"Already connected, reusing existing connection\");\n    }\n\n    // Return unsubscribe function\n    return () => {\n      this.log.debug(\"Unsubscribing from room\", { roomId });\n      this.subscriptions.delete(roomId);\n      if (callbacks?.onConnect)\n        this.onConnectCallbacks.delete(callbacks.onConnect);\n      if (callbacks?.onDisconnect)\n        this.onDisconnectCallbacks.delete(callbacks.onDisconnect);\n      if (callbacks?.onError) this.onErrorCallbacks.delete(callbacks.onError);\n\n      // Disconnect if no more subscriptions\n      if (this.subscriptions.size === 0) {\n        this.log.debug(\"No more subscriptions, disconnecting\");\n        this.disconnect();\n      }\n    };\n  }\n\n  /**\n   * Connect to WebSocket server\n   */\n  protected async connect(): Promise<void> {\n    if (this.ws?.readyState === WebSocket.OPEN) {\n      this.log.trace(\"Already connected, skipping connect\");\n      return;\n    }\n\n    this.isConnecting = true;\n    this.isError = false;\n    this.error = undefined;\n\n    const url = this.buildUrl();\n    this.log.info(\"Connecting to WebSocket server\", { url });\n\n    return new Promise((resolve, reject) => {\n      try {\n        const ws = new WebSocket(url);\n        this.ws = ws;\n\n        ws.onopen = () => {\n          this.isConnected = true;\n          this.isConnecting = false;\n          this.isError = false;\n          this.error = undefined;\n          this.reconnectAttempts = 0;\n\n          this.log.info(\"WebSocket connected\", {\n            channelPath: this.channel.options.path,\n            rooms: Array.from(this.subscriptions.keys()),\n          });\n\n          // Flush queued messages\n          if (this.messageQueue.length > 0) {\n            this.log.debug(\"Flushing queued messages\", {\n              count: this.messageQueue.length,\n            });\n          }\n          while (this.messageQueue.length > 0) {\n            const msg = this.messageQueue.shift();\n            if (msg) {\n              this.log.trace(\"Sending queued message\", { roomId: msg.roomId });\n              ws.send(\n                JSON.stringify({\n                  roomId: msg.roomId,\n                  message: msg.message,\n                }),\n              );\n            }\n          }\n\n          // Call all connect callbacks\n          for (const callback of this.onConnectCallbacks) {\n            callback();\n          }\n\n          resolve();\n        };\n\n        ws.onmessage = (event) => {\n          this.log.trace(\"Message received\", {\n            dataLength: event.data?.length,\n          });\n          this.handleMessage(event.data);\n        };\n\n        ws.onclose = (event) => {\n          this.isConnected = false;\n          this.isConnecting = false;\n          this.ws = undefined;\n\n          this.log.info(\"WebSocket disconnected\", {\n            code: event.code,\n            reason: event.reason,\n            wasClean: event.wasClean,\n          });\n\n          // Call all disconnect callbacks\n          for (const callback of this.onDisconnectCallbacks) {\n            callback();\n          }\n\n          // Attempt reconnection\n          if (this.options.autoReconnect !== false) {\n            this.scheduleReconnect();\n          }\n        };\n\n        ws.onerror = () => {\n          const err = new Error(\"WebSocket connection error\");\n          this.isError = true;\n          this.error = err;\n          this.isConnecting = false;\n\n          this.log.error(\"WebSocket error\", { url });\n\n          // Call all error callbacks\n          for (const callback of this.onErrorCallbacks) {\n            callback(err);\n          }\n\n          reject(err);\n        };\n      } catch (err) {\n        const error =\n          err instanceof Error ? err : new Error(\"Connection failed\");\n        this.isError = true;\n        this.error = error;\n        this.isConnecting = false;\n\n        this.log.error(\"Failed to create WebSocket\", { error: error.message });\n\n        // Call all error callbacks\n        for (const callback of this.onErrorCallbacks) {\n          callback(error);\n        }\n\n        reject(error);\n      }\n    });\n  }\n\n  /**\n   * Handle incoming message\n   */\n  protected handleMessage(data: string): void {\n    try {\n      const parsed = JSON.parse(data);\n      this.log.trace(\"Parsed incoming message\", { parsed });\n\n      // Validate incoming message against schema\n      const inSchema = this.channel.options.schema.in;\n      this.alepha.codec.validate(inSchema, parsed);\n\n      this.log.debug(\"Dispatching message to handlers\", {\n        handlerCount: this.subscriptions.size,\n      });\n\n      // Extract roomId from message if present (server should send it back)\n      // For now, broadcast to all subscribed rooms\n      // TODO: Server should include roomId in response\n      for (const handler of this.subscriptions.values()) {\n        handler(parsed as Static<TClient>);\n      }\n    } catch (err) {\n      this.log.error(\"Error handling message:\", err);\n    }\n  }\n\n  /**\n   * Send message to a specific room\n   */\n  public async send(roomId: string, message: Static<TServer>): Promise<void> {\n    this.log.trace(\"Sending message\", { roomId, message });\n\n    // Validate outgoing message against schema\n    const outSchema = this.channel.options.schema.out;\n    if (!TypeBoxValue.Check(outSchema, message)) {\n      const errors = Array.from(TypeBoxValue.Errors(outSchema, message));\n      this.log.warn(\"Message validation failed\", { errors });\n      throw new Error(\n        `Message validation failed: ${errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {\n      // Queue message\n      this.log.debug(\"Connection not ready, queuing message\", {\n        roomId,\n        queueSize: this.messageQueue.length + 1,\n      });\n      this.messageQueue.push({ roomId, message });\n      return;\n    }\n\n    this.log.debug(\"Sending message to server\", { roomId });\n    this.ws.send(\n      JSON.stringify({\n        roomId,\n        message,\n      }),\n    );\n  }\n\n  /**\n   * Schedule reconnection\n   */\n  protected scheduleReconnect(): void {\n    const maxAttempts =\n      this.options.maxReconnectAttempts ??\n      this.env.WEBSOCKET_MAX_RECONNECT_ATTEMPTS ??\n      10;\n    const reconnectInterval =\n      this.options.reconnectInterval ??\n      this.env.WEBSOCKET_RECONNECT_INTERVAL ??\n      3000;\n\n    if (maxAttempts !== -1 && this.reconnectAttempts >= maxAttempts) {\n      this.log.warn(\"Max reconnection attempts reached\", {\n        attempts: this.reconnectAttempts,\n        maxAttempts,\n      });\n      return;\n    }\n\n    this.reconnectAttempts++;\n\n    this.log.debug(\"Scheduling reconnection\", {\n      attempt: this.reconnectAttempts,\n      maxAttempts,\n      intervalMs: reconnectInterval,\n    });\n\n    this.reconnectTimer = window.setTimeout(() => {\n      this.log.info(\"Reconnecting...\", {\n        attempt: this.reconnectAttempts,\n        maxAttempts,\n      });\n      this.connect().catch((error) => {\n        this.log.error(\"Reconnection failed:\", error);\n      });\n    }, reconnectInterval);\n  }\n\n  /**\n   * Disconnect from server\n   */\n  public disconnect(): void {\n    this.log.debug(\"Disconnecting\", {\n      hasTimer: !!this.reconnectTimer,\n      hasConnection: !!this.ws,\n    });\n\n    if (this.reconnectTimer) {\n      clearTimeout(this.reconnectTimer);\n      this.reconnectTimer = undefined;\n    }\n\n    if (this.ws) {\n      this.ws.close();\n      this.ws = undefined;\n    }\n\n    this.isConnected = false;\n    this.isConnecting = false;\n\n    this.log.info(\"Disconnected\");\n  }\n\n  /**\n   * Reconnect manually\n   */\n  public reconnect(): void {\n    this.log.info(\"Manual reconnect requested\");\n    this.disconnect();\n    this.connect().catch((error) => {\n      this.log.error(\"Manual reconnection failed:\", error);\n    });\n  }\n\n  /**\n   * Check if subscribed to a room\n   */\n  public hasRoom(roomId: string): boolean {\n    return this.subscriptions.has(roomId);\n  }\n\n  /**\n   * Get all subscribed rooms\n   */\n  public getRooms(): string[] {\n    return Array.from(this.subscriptions.keys());\n  }\n}\n\n/**\n * WebSocket Client Service\n *\n * Manages WebSocket connections from the client side (browser).\n * One connection per channel, multiple rooms per connection.\n */\nexport class WebSocketClient {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly env = $env(envSchema);\n\n  // Map<channelPath, connection>\n  protected connections = new Map<\n    string,\n    WebSocketChannelConnection<any, any>\n  >();\n\n  /**\n   * Subscribe to a room on a channel\n   */\n  public subscribe<TClient extends TWSObject, TServer extends TWSObject>(\n    roomId: string,\n    channel: ChannelPrimitive<TClient, TServer>,\n    handler: (message: Static<TClient>) => void,\n    options: {\n      url?: string;\n      autoReconnect?: boolean;\n      reconnectInterval?: number;\n      maxReconnectAttempts?: number;\n      onConnect?: () => void;\n      onDisconnect?: () => void;\n      onError?: (error: Error) => void;\n    } = {},\n  ): () => void {\n    const channelPath = channel.options.path;\n\n    this.log.debug(\"WebSocketClient.subscribe\", {\n      roomId,\n      channelPath,\n      existingConnections: this.connections.size,\n    });\n\n    // Get or create connection for this channel\n    let connection = this.connections.get(\n      channelPath,\n    ) as WebSocketChannelConnection<TClient, TServer>;\n\n    if (!connection) {\n      this.log.debug(\"Creating new connection for channel\", { channelPath });\n      connection = this.alepha.inject(WebSocketChannelConnection, {\n        lifetime: \"transient\",\n        args: [\n          channel,\n          {\n            url: options.url,\n            autoReconnect: options.autoReconnect,\n            reconnectInterval: options.reconnectInterval,\n            maxReconnectAttempts: options.maxReconnectAttempts,\n          },\n          this.env,\n        ],\n      }) as WebSocketChannelConnection<any, any>;\n\n      this.connections.set(channelPath, connection);\n    } else {\n      this.log.trace(\"Reusing existing connection for channel\", {\n        channelPath,\n      });\n    }\n\n    // Subscribe to the room on this connection\n    const unsubscribe = connection.subscribe(roomId, handler, {\n      onConnect: options.onConnect,\n      onDisconnect: options.onDisconnect,\n      onError: options.onError,\n    });\n\n    // Return unsubscribe function\n    return () => {\n      this.log.debug(\"WebSocketClient.unsubscribe\", { roomId, channelPath });\n      unsubscribe();\n\n      // Clean up connection if no more rooms\n      if (connection.getRooms().length === 0) {\n        this.log.debug(\"Removing connection for channel (no more rooms)\", {\n          channelPath,\n        });\n        this.connections.delete(channelPath);\n      }\n    };\n  }\n\n  /**\n   * Send message to a room on a channel\n   */\n  public async send<TClient extends TWSObject, TServer extends TWSObject>(\n    roomId: string,\n    channel: ChannelPrimitive<TClient, TServer>,\n    message: Static<TServer>,\n  ): Promise<void> {\n    const channelPath = channel.options.path;\n\n    this.log.trace(\"WebSocketClient.send\", { roomId, channelPath });\n\n    const connection = this.connections.get(\n      channelPath,\n    ) as WebSocketChannelConnection<TClient, TServer>;\n\n    if (!connection) {\n      this.log.warn(\"Attempted to send on unsubscribed channel\", {\n        channelPath,\n      });\n      throw new AlephaError(\n        `Not subscribed to channel ${channelPath}. Subscribe first before sending messages.`,\n      );\n    }\n\n    await connection.send(roomId, message);\n  }\n\n  /**\n   * Get connection for a channel\n   */\n  public getConnection<TClient extends TWSObject, TServer extends TWSObject>(\n    channel: ChannelPrimitive<TClient, TServer>,\n  ): WebSocketChannelConnection<TClient, TServer> | undefined {\n    const channelPath = channel.options.path;\n    const connection = this.connections.get(channelPath) as\n      | WebSocketChannelConnection<TClient, TServer>\n      | undefined;\n\n    this.log.trace(\"WebSocketClient.getConnection\", {\n      channelPath,\n      found: !!connection,\n    });\n\n    return connection;\n  }\n\n  /**\n   * Disconnect all connections\n   */\n  public disconnectAll(): void {\n    this.log.info(\"Disconnecting all connections\", {\n      count: this.connections.size,\n    });\n\n    for (const connection of this.connections.values()) {\n      connection.disconnect();\n    }\n    this.connections.clear();\n\n    this.log.debug(\"All connections disconnected\");\n  }\n}\n","/**\n * Base WebSocket error class\n */\nexport class WebSocketError extends Error {\n  constructor(\n    message: string,\n    public readonly code?: number,\n  ) {\n    super(message);\n    this.name = \"WebSocketError\";\n  }\n}\n\n/**\n * Error thrown when WebSocket connection fails\n */\nexport class WebSocketConnectionError extends WebSocketError {\n  constructor(message: string, code?: number) {\n    super(message, code);\n    this.name = \"WebSocketConnectionError\";\n  }\n}\n\n/**\n * Error thrown when WebSocket message validation fails\n */\nexport class WebSocketValidationError extends WebSocketError {\n  constructor(message: string) {\n    super(message);\n    this.name = \"WebSocketValidationError\";\n  }\n}\n","import type { Static } from \"alepha\";\nimport type { ChannelPrimitive, TWSObject } from \"../primitives/$channel.ts\";\n\n/**\n * WebSocket connection interface\n */\nexport interface WebSocketConnection {\n  /**\n   * Unique connection ID\n   */\n  id: string;\n\n  /**\n   * User ID (if authenticated and security module is used)\n   */\n  userId?: string;\n\n  /**\n   * Room IDs that this connection is currently in\n   */\n  roomIds: string[];\n\n  /**\n   * Send a message to this connection\n   */\n  send(message: any): Promise<void>;\n\n  /**\n   * Close this connection\n   */\n  close(code?: number, reason?: string): Promise<void>;\n\n  /**\n   * Connection metadata (custom data)\n   */\n  metadata?: Record<string, any>;\n\n  /**\n   * Connection state\n   */\n  readyState: WebSocketState;\n}\n\n/**\n * WebSocket state enum\n */\nexport enum WebSocketState {\n  CONNECTING = 0,\n  OPEN = 1,\n  CLOSING = 2,\n  CLOSED = 3,\n}\n\n/**\n * WebSocket endpoint configuration (server-side)\n */\nexport interface WebSocketPrimitiveOptions<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> {\n  /**\n   * Channel definition with schema and path\n   */\n  channel: ChannelPrimitive<TClient, TServer>;\n\n  /**\n   * Handler for incoming messages from clients\n   */\n  handler: WebSocketHandler<TClient, TServer>;\n\n  /**\n   * Optional connection handler (called when a client connects)\n   */\n  onConnect?: (params: {\n    /**\n     * Unique connection ID of the client\n     */\n    connectionId: string;\n\n    /**\n     * User ID of the connected client (if authenticated and security module is used)\n     */\n    userId?: string;\n\n    /**\n     * Room IDs that the client is connecting to\n     */\n    roomIds: string[];\n  }) => Promise<void> | void;\n\n  /**\n   * Optional disconnection handler (called when a client disconnects)\n   */\n  onDisconnect?: (params: {\n    /**\n     * Unique connection ID of the client\n     */\n    connectionId: string;\n\n    /**\n     * User ID of the connected client (if authenticated and security module is used)\n     */\n    userId?: string;\n\n    /**\n     * Room IDs that the client was connected to\n     */\n    roomIds: string[];\n  }) => Promise<void> | void;\n\n  /**\n   * Change WebSocket server provider (for custom implementations)\n   */\n  provider?: any;\n\n  /**\n   * Whether to enforce security (authentication, authorization) on this WebSocket endpoint\n   * Requires alepha/security integration\n   */\n  secure?: boolean;\n\n  /**\n   * Limit number of connections per user (if authenticated)\n   */\n  maxConnectionsPerUser?: number;\n}\n\n/**\n * WebSocket message handler\n */\nexport type WebSocketHandler<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> = (\n  context: WebSocketHandlerContext<TClient, TServer>,\n) => Promise<void> | void;\n\n/**\n * WebSocket handler context\n */\nexport interface WebSocketHandlerContext<\n  TClient extends TWSObject,\n  TServer extends TWSObject,\n> {\n  /**\n   * Unique connection ID of the client\n   */\n  connectionId: string;\n\n  /**\n   * User ID of the connected client (if authenticated and security module is used)\n   */\n  userId?: string;\n\n  /**\n   * Room ID that the client sent the message from\n   */\n  roomId: string;\n\n  /**\n   * The parsed and validated message from the client\n   */\n  message: Static<TServer>;\n\n  /**\n   * Reply function tailored to current context (connectionId, roomId)\n   */\n  reply: (options: {\n    /**\n     * Message to send\n     */\n    message: Static<TClient>;\n\n    /**\n     * Optional: specify room ID to send to (defaults to sender's room ID)\n     */\n    roomId?: string;\n\n    /**\n     * Optional: exclude the sender connection from receiving the message\n     * Will populate exceptConnectionIds with sender connection ID behind the scenes\n     */\n    exceptSelf?: boolean;\n\n    /**\n     * Optional: exclude specific connection IDs from receiving the message\n     */\n    exceptConnectionIds?: string[];\n\n    /**\n     * Optional: exclude specific user IDs from receiving the message\n     * Requires alepha/security integration\n     */\n    exceptUserIds?: string[];\n  }) => Promise<void>;\n}\n\n/**\n * Emit options for sending messages from the server\n */\nexport interface EmitOptions<TClient extends TWSObject> {\n  /**\n   * Message to send to clients\n   */\n  message: Static<TClient>;\n\n  /**\n   * Room ID to send the message to\n   */\n  roomId?: string;\n\n  /**\n   * Room IDs to send the message to\n   */\n  roomIds?: string[];\n\n  /**\n   * User ID to send the message to (if authenticated)\n   */\n  userId?: string;\n\n  /**\n   * User IDs to send the message to (if authenticated)\n   */\n  userIds?: string[];\n\n  /**\n   * Connection ID to send the message to\n   */\n  connectionId?: string;\n\n  /**\n   * Connection IDs to send the message to\n   */\n  connectionIds?: string[];\n\n  /**\n   * Optional: exclude specific connection IDs from receiving the message\n   */\n  exceptConnectionIds?: string[];\n\n  /**\n   * Optional: exclude specific user IDs from receiving the message\n   * Requires alepha/security integration\n   */\n  exceptUserIds?: string[];\n}\n","import { $logger } from \"alepha/logger\";\n\n/**\n * Manages WebSocket room memberships\n *\n * Rooms are logical groupings of connections. A connection can be in multiple rooms,\n * and messages can be targeted to specific rooms.\n */\nexport class RoomManager {\n  protected readonly log = $logger();\n\n  /**\n   * Maps roomId → Set<connectionId>\n   */\n  protected readonly rooms = new Map<string, Set<string>>();\n\n  /**\n   * Maps connectionId → Set<roomId>\n   * Inverse index for fast lookup of connection's rooms\n   */\n  protected readonly connectionRooms = new Map<string, Set<string>>();\n\n  /**\n   * Join a connection to one or more rooms\n   */\n  public joinRooms(connectionId: string, roomIds: string[]): void {\n    for (const roomId of roomIds) {\n      this.joinRoom(connectionId, roomId);\n    }\n  }\n\n  /**\n   * Join a connection to a room\n   */\n  public joinRoom(connectionId: string, roomId: string): void {\n    // Add to room\n    let room = this.rooms.get(roomId);\n    if (!room) {\n      room = new Set();\n      this.rooms.set(roomId, room);\n    }\n    room.add(connectionId);\n\n    // Update inverse index\n    let connRooms = this.connectionRooms.get(connectionId);\n    if (!connRooms) {\n      connRooms = new Set();\n      this.connectionRooms.set(connectionId, connRooms);\n    }\n    connRooms.add(roomId);\n\n    this.log.debug(`Connection ${connectionId} joined room ${roomId}`);\n  }\n\n  /**\n   * Leave a connection from a room\n   */\n  public leaveRoom(connectionId: string, roomId: string): void {\n    // Remove from room\n    const room = this.rooms.get(roomId);\n    if (room) {\n      room.delete(connectionId);\n      if (room.size === 0) {\n        this.rooms.delete(roomId);\n      }\n    }\n\n    // Update inverse index\n    const connRooms = this.connectionRooms.get(connectionId);\n    if (connRooms) {\n      connRooms.delete(roomId);\n      if (connRooms.size === 0) {\n        this.connectionRooms.delete(connectionId);\n      }\n    }\n\n    this.log.debug(`Connection ${connectionId} left room ${roomId}`);\n  }\n\n  /**\n   * Remove a connection from all rooms\n   */\n  public leaveAllRooms(connectionId: string): void {\n    const connRooms = this.connectionRooms.get(connectionId);\n    if (!connRooms) {\n      return;\n    }\n\n    for (const roomId of connRooms) {\n      const room = this.rooms.get(roomId);\n      if (room) {\n        room.delete(connectionId);\n        if (room.size === 0) {\n          this.rooms.delete(roomId);\n        }\n      }\n    }\n\n    this.connectionRooms.delete(connectionId);\n    this.log.debug(`Connection ${connectionId} left all rooms`);\n  }\n\n  /**\n   * Get all connection IDs in a room\n   */\n  public getRoomConnections(roomId: string): string[] {\n    const room = this.rooms.get(roomId);\n    return room ? Array.from(room) : [];\n  }\n\n  /**\n   * Get all room IDs for a connection\n   */\n  public getConnectionRooms(connectionId: string): string[] {\n    const connRooms = this.connectionRooms.get(connectionId);\n    return connRooms ? Array.from(connRooms) : [];\n  }\n\n  /**\n   * Check if a connection is in a room\n   */\n  public isInRoom(connectionId: string, roomId: string): boolean {\n    const connRooms = this.connectionRooms.get(connectionId);\n    return connRooms ? connRooms.has(roomId) : false;\n  }\n\n  /**\n   * Get all active rooms\n   */\n  public getAllRooms(): string[] {\n    return Array.from(this.rooms.keys());\n  }\n\n  /**\n   * Get total number of connections across all rooms\n   */\n  public getTotalConnections(): number {\n    return this.connectionRooms.size;\n  }\n\n  /**\n   * Get room statistics\n   */\n  public getStats(): {\n    totalRooms: number;\n    totalConnections: number;\n    roomSizes: Map<string, number>;\n  } {\n    const roomSizes = new Map<string, number>();\n    for (const [roomId, connections] of this.rooms) {\n      roomSizes.set(roomId, connections.size);\n    }\n\n    return {\n      totalRooms: this.rooms.size,\n      totalConnections: this.connectionRooms.size,\n      roomSizes,\n    };\n  }\n}\n","import { type Static, t } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { $topic } from \"alepha/topic\";\n\n/**\n * WebSocket message distribution event\n */\nconst webSocketMessageSchema = {\n  payload: t.object({\n    /**\n     * Channel path (e.g., \"/ws/chat\")\n     */\n    channelPath: t.text(),\n\n    /**\n     * Target room ID(s)\n     */\n    roomIds: t.optional(t.array(t.text())),\n\n    /**\n     * Target user ID(s)\n     */\n    userIds: t.optional(t.array(t.text())),\n\n    /**\n     * Target connection ID(s)\n     */\n    connectionIds: t.optional(t.array(t.text())),\n\n    /**\n     * Exclude connection ID(s) from receiving the message\n     */\n    exceptConnectionIds: t.optional(t.array(t.text())),\n\n    /**\n     * Exclude user ID(s) from receiving the message\n     */\n    exceptUserIds: t.optional(t.array(t.text())),\n\n    /**\n     * The message payload to send\n     */\n    message: t.any(),\n  }),\n};\n\n/**\n * WebSocket Topic Service\n *\n * Manages pub/sub messaging for WebSocket connections across multiple server instances.\n * Uses alepha/topic for cross-instance message distribution, enabling horizontal scaling.\n *\n * When a WebSocket message needs to be sent:\n * 1. Server instance A publishes to the topic\n * 2. All server instances (A, B, C, etc.) receive the message\n * 3. Each instance sends to its local connections that match the criteria\n *\n * This enables:\n * - Multiple server instances handling WebSocket connections\n * - Redis-backed message distribution (with alepha/topic/redis)\n * - Horizontal scaling without losing messages\n */\nexport class WebSocketTopicService {\n  protected readonly log = $logger();\n\n  /**\n   * Handler function to be called when a message is received from the topic\n   * This is set by the WebSocket provider during initialization\n   */\n  public messageHandler?: (\n    event: Static<(typeof webSocketMessageSchema)[\"payload\"]>,\n  ) => Promise<void>;\n\n  /**\n   * Topic for distributing WebSocket messages across server instances\n   */\n  public readonly topic = $topic({\n    name: \"websocket:broadcast\",\n    description:\n      \"Distributes WebSocket messages across server instances for horizontal scaling\",\n    schema: webSocketMessageSchema,\n    handler: async (message) => {\n      if (this.messageHandler) {\n        await this.messageHandler(message.payload);\n      }\n    },\n  });\n\n  /**\n   * Publish a message to be distributed across all server instances\n   */\n  public async publish(\n    event: Static<(typeof webSocketMessageSchema)[\"payload\"]>,\n  ): Promise<void> {\n    await this.topic.publish(event);\n  }\n\n  /**\n   * Set the handler for incoming messages\n   */\n  public setMessageHandler(\n    handler: (\n      event: Static<(typeof webSocketMessageSchema)[\"payload\"]>,\n    ) => Promise<void>,\n  ): void {\n    this.messageHandler = handler;\n  }\n}\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaTopic } from \"alepha/topic\";\nimport { $channel } from \"./primitives/$channel.ts\";\nimport { $websocket } from \"./primitives/$websocket.ts\";\nimport { WebSocketClient } from \"./services/WebSocketClient.ts\";\n\n/**\n * alepha/websocket (Browser)\n *\n * Browser-side WebSocket client module. Provides WebSocketClient service\n * for managing WebSocket connections from the browser.\n *\n * For React applications, use alepha/react/websocket with the useRoom hook.\n */\nexport * from \"./index.shared.ts\";\n\nexport const AlephaWebSocket = $module({\n  name: \"alepha.websocket\",\n  primitives: [$channel, $websocket],\n  services: [WebSocketClient],\n  register: (alepha: Alepha) => {\n    alepha.with(AlephaTopic);\n    alepha.with(WebSocketClient);\n  },\n});\n"],"mappings":"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"}

package/dist/websocket/index.d.ts

@@ -1,16 +1,37 @@
 import * as alepha42 from "alepha";
-import { Alepha, Descriptor, KIND, Static, TObject, TString, TUnion } from "alepha";
+import { Alepha, KIND, Primitive, Static, TObject, TString, TUnion } from "alepha";
 import * as alepha_topic0 from "alepha/topic";
 import * as alepha_logger1 from "alepha/logger";
 import { WebSocket as WebSocket$1, WebSocketServer } from "ws";
 import { IncomingMessage } from "node:http";
 
-//#region src/websocket/descriptors/$channel.d.ts
+//#region src/websocket/errors/WebSocketError.d.ts
+/**
+ * Base WebSocket error class
+ */
+declare class WebSocketError extends Error {
+  readonly code?: number | undefined;
+  constructor(message: string, code?: number | undefined);
+}
+/**
+ * Error thrown when WebSocket connection fails
+ */
+declare class WebSocketConnectionError extends WebSocketError {
+  constructor(message: string, code?: number);
+}
+/**
+ * Error thrown when WebSocket message validation fails
+ */
+declare class WebSocketValidationError extends WebSocketError {
+  constructor(message: string);
+}
+//#endregion
+//#region src/websocket/primitives/$channel.d.ts
 type TWSObject = TObject | TUnion;
 /**
- * Channel descriptor options
+ * Channel primitive options
  */
-interface ChannelDescriptorOptions<TClient extends TWSObject, TServer extends TWSObject> {
+interface ChannelPrimitiveOptions<TClient extends TWSObject, TServer extends TWSObject> {
   /**
    * WebSocket endpoint path (e.g., "/ws/chat")
    */
@@ -104,10 +125,10 @@ interface ChannelDescriptorOptions<TClient extends TWSObject, TServer extends TW
  * ```
  */
 declare const $channel: {
-  <TClient extends TWSObject, TServer extends TWSObject>(options: ChannelDescriptorOptions<TClient, TServer>): ChannelDescriptor<TClient, TServer>;
-  [KIND]: typeof ChannelDescriptor;
+  <TClient extends TWSObject, TServer extends TWSObject>(options: ChannelPrimitiveOptions<TClient, TServer>): ChannelPrimitive<TClient, TServer>;
+  [KIND]: typeof ChannelPrimitive;
 };
-declare class ChannelDescriptor<TClient extends TWSObject, TServer extends TWSObject> extends Descriptor<ChannelDescriptorOptions<TClient, TServer>> {}
+declare class ChannelPrimitive<TClient extends TWSObject, TServer extends TWSObject> extends Primitive<ChannelPrimitiveOptions<TClient, TServer>> {}
 //#endregion
 //#region src/websocket/interfaces/WebSocketInterfaces.d.ts
 /**
@@ -155,11 +176,11 @@ declare enum WebSocketState {
 /**
  * WebSocket endpoint configuration (server-side)
  */
-interface WebSocketDescriptorOptions<TClient extends TWSObject, TServer extends TWSObject> {
+interface WebSocketPrimitiveOptions<TClient extends TWSObject, TServer extends TWSObject> {
   /**
    * Channel definition with schema and path
    */
-  channel: ChannelDescriptor<TClient, TServer>;
+  channel: ChannelPrimitive<TClient, TServer>;
   /**
    * Handler for incoming messages from clients
    */
@@ -318,7 +339,7 @@ declare abstract class WebSocketServerProvider {
   /**
    * Register a WebSocket endpoint with its channel configuration
    */
-  abstract registerEndpoint<TClient extends TWSObject, TServer extends TWSObject>(config: WebSocketDescriptorOptions<TClient, TServer>): void;
+  abstract registerEndpoint<TClient extends TWSObject, TServer extends TWSObject>(config: WebSocketPrimitiveOptions<TClient, TServer>): void;
   /**
    * Emit a message to clients based on targeting criteria
    *
@@ -343,7 +364,7 @@ declare abstract class WebSocketServerProvider {
   abstract closeConnection(connectionId: string, code?: number, reason?: string): Promise<void>;
 }
 //#endregion
-//#region src/websocket/descriptors/$websocket.d.ts
+//#region src/websocket/primitives/$websocket.d.ts
 /**
  * Defines a WebSocket server endpoint for a specific channel.
  *
@@ -386,10 +407,10 @@ declare abstract class WebSocketServerProvider {
  * ```
  */
 declare const $websocket: {
-  <TClient extends TWSObject, TServer extends TWSObject>(options: WebSocketDescriptorOptions<TClient, TServer>): WebSocketDescriptor<TClient, TServer>;
-  [KIND]: typeof WebSocketDescriptor;
+  <TClient extends TWSObject, TServer extends TWSObject>(options: WebSocketPrimitiveOptions<TClient, TServer>): WebSocketPrimitive<TClient, TServer>;
+  [KIND]: typeof WebSocketPrimitive;
 };
-declare class WebSocketDescriptor<TClient extends TWSObject, TServer extends TWSObject> extends Descriptor<WebSocketDescriptorOptions<TClient, TServer>> {
+declare class WebSocketPrimitive<TClient extends TWSObject, TServer extends TWSObject> extends Primitive<WebSocketPrimitiveOptions<TClient, TServer>> {
   protected readonly webSocketServerProvider: WebSocketServerProvider;
   protected onInit(): void;
   /**
@@ -423,27 +444,6 @@ declare class WebSocketDescriptor<TClient extends TWSObject, TServer extends TWS
   emit(options: EmitOptions<TClient>): Promise<void>;
 }
 //#endregion
-//#region src/websocket/errors/WebSocketError.d.ts
-/**
- * Base WebSocket error class
- */
-declare class WebSocketError extends Error {
-  readonly code?: number | undefined;
-  constructor(message: string, code?: number | undefined);
-}
-/**
- * Error thrown when WebSocket connection fails
- */
-declare class WebSocketConnectionError extends WebSocketError {
-  constructor(message: string, code?: number);
-}
-/**
- * Error thrown when WebSocket message validation fails
- */
-declare class WebSocketValidationError extends WebSocketError {
-  constructor(message: string);
-}
-//#endregion
 //#region src/websocket/services/RoomManager.d.ts
 /**
  * Manages WebSocket room memberships
@@ -524,7 +524,7 @@ declare module "alepha" {
  * One connection can handle multiple rooms on the same channel.
  */
 declare class WebSocketChannelConnection<TClient extends TWSObject, TServer extends TWSObject> {
-  protected readonly channel: ChannelDescriptor<TClient, TServer>;
+  protected readonly channel: ChannelPrimitive<TClient, TServer>;
   protected readonly options: {
     url?: string;
     autoReconnect?: boolean;
@@ -549,7 +549,7 @@ declare class WebSocketChannelConnection<TClient extends TWSObject, TServer exte
   protected onConnectCallbacks: Set<() => void>;
   protected onDisconnectCallbacks: Set<() => void>;
   protected onErrorCallbacks: Set<(error: Error) => void>;
-  constructor(channel: ChannelDescriptor<TClient, TServer>, options: {
+  constructor(channel: ChannelPrimitive<TClient, TServer>, options: {
     url?: string;
     autoReconnect?: boolean;
     reconnectInterval?: number;
@@ -618,7 +618,7 @@ declare class WebSocketClient {
   /**
    * Subscribe to a room on a channel
    */
-  subscribe<TClient extends TWSObject, TServer extends TWSObject>(roomId: string, channel: ChannelDescriptor<TClient, TServer>, handler: (message: Static<TClient>) => void, options?: {
+  subscribe<TClient extends TWSObject, TServer extends TWSObject>(roomId: string, channel: ChannelPrimitive<TClient, TServer>, handler: (message: Static<TClient>) => void, options?: {
     url?: string;
     autoReconnect?: boolean;
     reconnectInterval?: number;
@@ -630,11 +630,11 @@ declare class WebSocketClient {
   /**
    * Send message to a room on a channel
    */
-  send<TClient extends TWSObject, TServer extends TWSObject>(roomId: string, channel: ChannelDescriptor<TClient, TServer>, message: Static<TServer>): Promise<void>;
+  send<TClient extends TWSObject, TServer extends TWSObject>(roomId: string, channel: ChannelPrimitive<TClient, TServer>, message: Static<TServer>): Promise<void>;
   /**
    * Get connection for a channel
    */
-  getConnection<TClient extends TWSObject, TServer extends TWSObject>(channel: ChannelDescriptor<TClient, TServer>): WebSocketChannelConnection<TClient, TServer> | undefined;
+  getConnection<TClient extends TWSObject, TServer extends TWSObject>(channel: ChannelPrimitive<TClient, TServer>): WebSocketChannelConnection<TClient, TServer> | undefined;
   /**
    * Disconnect all connections
    */
@@ -703,7 +703,7 @@ declare class WebSocketTopicService {
   /**
    * Topic for distributing WebSocket messages across server instances
    */
-  readonly topic: alepha_topic0.TopicDescriptor<{
+  readonly topic: alepha_topic0.TopicPrimitive<{
     payload: alepha42.TObject<{
       /**
        * Channel path (e.g., "/ws/chat")
@@ -761,18 +761,18 @@ declare class NodeWebSocketServerProvider extends WebSocketServerProvider {
     WEBSOCKET_PATH: string;
   };
   protected wss?: WebSocketServer;
-  protected endpoints: Map<string, WebSocketDescriptorOptions<any, any>>;
+  protected endpoints: Map<string, WebSocketPrimitiveOptions<any, any>>;
   protected connections: Map<string, WebSocketConnection>;
   protected userConnections: Map<string, Set<string>>;
   protected nextConnectionId: number;
-  registerEndpoint<TClient extends TWSObject, TServer extends TWSObject>(config: WebSocketDescriptorOptions<TClient, TServer>): void;
+  registerEndpoint<TClient extends TWSObject, TServer extends TWSObject>(config: WebSocketPrimitiveOptions<TClient, TServer>): void;
   emit<TClient extends TWSObject>(channelPath: string, options: EmitOptions<TClient>): Promise<void>;
   getConnections(): WebSocketConnection[];
   getRoomConnections(roomId: string): WebSocketConnection[];
   getUserConnections(userId: string): WebSocketConnection[];
   closeConnection(connectionId: string, code?: number, reason?: string): Promise<void>;
   protected handleUpgrade(request: IncomingMessage, socket: any, head: Buffer): boolean;
-  protected handleConnection<TClient extends TWSObject, TServer extends TWSObject>(ws: WebSocket$1, endpoint: WebSocketDescriptorOptions<TClient, TServer>, request: IncomingMessage): void;
+  protected handleConnection<TClient extends TWSObject, TServer extends TWSObject>(ws: WebSocket$1, endpoint: WebSocketPrimitiveOptions<TClient, TServer>, request: IncomingMessage): void;
   protected extractRoomIds(url: URL): string[];
   /**
    * Send message to local connections based on targeting criteria
@@ -785,9 +785,9 @@ declare class NodeWebSocketServerProvider extends WebSocketServerProvider {
     exceptConnectionIds?: string[];
     exceptUserIds?: string[];
   }): Promise<void>;
-  protected readonly start: alepha42.HookDescriptor<"start">;
-  protected readonly ready: alepha42.HookDescriptor<"ready">;
-  protected readonly stop: alepha42.HookDescriptor<"stop">;
+  protected readonly start: alepha42.HookPrimitive<"start">;
+  protected readonly ready: alepha42.HookPrimitive<"ready">;
+  protected readonly stop: alepha42.HookPrimitive<"stop">;
 }
 declare class NodeWebSocketConnection implements WebSocketConnection {
   readonly id: string;
@@ -795,10 +795,10 @@ declare class NodeWebSocketConnection implements WebSocketConnection {
   readonly roomIds: string[];
   protected readonly ws: WebSocket$1;
   protected readonly provider: NodeWebSocketServerProvider;
-  protected readonly endpoint: WebSocketDescriptorOptions<any, any>;
+  protected readonly endpoint: WebSocketPrimitiveOptions<any, any>;
   protected readonly log: alepha_logger1.Logger;
   metadata?: Record<string, any>;
-  constructor(id: string, userId: string | undefined, roomIds: string[], ws: WebSocket$1, provider: NodeWebSocketServerProvider, endpoint: WebSocketDescriptorOptions<any, any>);
+  constructor(id: string, userId: string | undefined, roomIds: string[], ws: WebSocket$1, provider: NodeWebSocketServerProvider, endpoint: WebSocketPrimitiveOptions<any, any>);
   get readyState(): WebSocketState;
   send(message: any): Promise<void>;
   close(code?: number, reason?: string): Promise<void>;
@@ -845,7 +845,7 @@ declare module "alepha" {
 /**
  * Provides real-time bidirectional communication using WebSockets.
  *
- * The WebSockets module enables building real-time applications using the `$websocket` descriptor
+ * The WebSockets module enables building real-time applications using the `$websocket` primitive
  * on class properties. It provides automatic connection management, message routing, type-safe
  * message handling, and seamless integration with other Alepha modules.
  *
@@ -857,5 +857,5 @@ declare module "alepha" {
  */
 declare const AlephaWebSocket: alepha42.Service<alepha42.Module>;
 //#endregion
-export { $channel, $websocket, AlephaWebSocket, ChannelDescriptor, ChannelDescriptorOptions, EmitOptions, NodeWebSocketConnection, NodeWebSocketServerProvider, RoomManager, TWSObject, WebSocketChannelConnection, WebSocketClient, WebSocketConnection, WebSocketConnectionError, WebSocketDescriptor, WebSocketDescriptorOptions, WebSocketError, WebSocketHandler, WebSocketHandlerContext, WebSocketServerProvider, WebSocketState, WebSocketTopicService, WebSocketValidationError };
+export { $channel, $websocket, AlephaWebSocket, ChannelPrimitive, ChannelPrimitiveOptions, EmitOptions, NodeWebSocketConnection, NodeWebSocketServerProvider, RoomManager, TWSObject, WebSocketChannelConnection, WebSocketClient, WebSocketConnection, WebSocketConnectionError, WebSocketError, WebSocketHandler, WebSocketHandlerContext, WebSocketPrimitive, WebSocketPrimitiveOptions, WebSocketServerProvider, WebSocketState, WebSocketTopicService, WebSocketValidationError };
 //# sourceMappingURL=index.d.ts.map

package/dist/websocket/index.js

@@ -1,10 +1,10 @@
-import { $env, $hook, $inject, $module, Alepha, AlephaError, Descriptor, KIND, TypeBoxValue, createDescriptor, t } from "alepha";
+import { $env, $hook, $inject, $module, Alepha, AlephaError, KIND, Primitive, TypeBoxValue, createPrimitive, t } from "alepha";
 import { AlephaServer } from "alepha/server";
 import { $topic, AlephaTopic } from "alepha/topic";
 import { $logger } from "alepha/logger";
 import { WebSocket as WebSocket$1, WebSocketServer } from "ws";
 
-//#region src/websocket/descriptors/$channel.ts
+//#region src/websocket/primitives/$channel.ts
 /**
 * Defines a WebSocket channel with specified client and server message schemas.
 *
@@ -68,10 +68,10 @@ import { WebSocket as WebSocket$1, WebSocketServer } from "ws";
 * ```
 */
 const $channel = (options) => {
-	return createDescriptor(ChannelDescriptor, options);
+	return createPrimitive(ChannelPrimitive, options);
 };
-var ChannelDescriptor = class extends Descriptor {};
-$channel[KIND] = ChannelDescriptor;
+var ChannelPrimitive = class extends Primitive {};
+$channel[KIND] = ChannelPrimitive;
 
 //#endregion
 //#region src/websocket/providers/WebSocketServerProvider.ts
@@ -84,7 +84,7 @@ $channel[KIND] = ChannelDescriptor;
 var WebSocketServerProvider = class {};
 
 //#endregion
-//#region src/websocket/descriptors/$websocket.ts
+//#region src/websocket/primitives/$websocket.ts
 /**
 * Defines a WebSocket server endpoint for a specific channel.
 *
@@ -127,9 +127,9 @@ var WebSocketServerProvider = class {};
 * ```
 */
 const $websocket = (options) => {
-	return createDescriptor(WebSocketDescriptor, options);
+	return createPrimitive(WebSocketPrimitive, options);
 };
-var WebSocketDescriptor = class extends Descriptor {
+var WebSocketPrimitive = class extends Primitive {
 	webSocketServerProvider = $inject(WebSocketServerProvider);
 	onInit() {
 		this.webSocketServerProvider.registerEndpoint(this.options);
@@ -166,7 +166,7 @@ var WebSocketDescriptor = class extends Descriptor {
 		await this.webSocketServerProvider.emit(this.options.channel.options.path, options);
 	}
 };
-$websocket[KIND] = WebSocketDescriptor;
+$websocket[KIND] = WebSocketPrimitive;
 
 //#endregion
 //#region src/websocket/errors/WebSocketError.ts
@@ -568,7 +568,7 @@ var NodeWebSocketServerProvider = class extends WebSocketServerProvider {
 		on: "ready",
 		handler: async () => {
 			if (this.alepha.isServerless() || !this.wss) return;
-			const httpServer = this.alepha.state.get("alepha.node.server");
+			const httpServer = this.alepha.store.get("alepha.node.server");
 			if (httpServer) {
 				httpServer.on("upgrade", (request, socket, head) => {
 					this.handleUpgrade(request, socket, head);
@@ -1068,7 +1068,7 @@ var WebSocketClient = class {
 /**
 * Provides real-time bidirectional communication using WebSockets.
 *
-* The WebSockets module enables building real-time applications using the `$websocket` descriptor
+* The WebSockets module enables building real-time applications using the `$websocket` primitive
 * on class properties. It provides automatic connection management, message routing, type-safe
 * message handling, and seamless integration with other Alepha modules.
 *
@@ -1080,7 +1080,7 @@ var WebSocketClient = class {
 */
 const AlephaWebSocket = $module({
 	name: "alepha.websocket",
-	descriptors: [$channel, $websocket],
+	primitives: [$channel, $websocket],
 	services: [
 		WebSocketServerProvider,
 		NodeWebSocketServerProvider,
@@ -1098,5 +1098,5 @@ const AlephaWebSocket = $module({
 });
 
 //#endregion
-export { $channel, $websocket, AlephaWebSocket, ChannelDescriptor, NodeWebSocketConnection, NodeWebSocketServerProvider, RoomManager, WebSocketChannelConnection, WebSocketClient, WebSocketConnectionError, WebSocketDescriptor, WebSocketError, WebSocketServerProvider, WebSocketState, WebSocketTopicService, WebSocketValidationError };
+export { $channel, $websocket, AlephaWebSocket, ChannelPrimitive, NodeWebSocketConnection, NodeWebSocketServerProvider, RoomManager, WebSocketChannelConnection, WebSocketClient, WebSocketConnectionError, WebSocketError, WebSocketPrimitive, WebSocketServerProvider, WebSocketState, WebSocketTopicService, WebSocketValidationError };
 //# sourceMappingURL=index.js.map