@forinda/kickjs-ws 2.0.1 → 2.1.0

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/interfaces.ts","../src/ws-context.ts","../src/room-manager.ts","../src/ws-adapter.ts","../src/decorators.ts"],"sourcesContent":["type Constructor = new (...args: any[]) => any\n\nexport const WS_METADATA = {\n  WS_CONTROLLER: Symbol('kick:ws:controller'),\n  WS_HANDLERS: Symbol('kick:ws:handlers'),\n} as const\n\nexport type WsHandlerType = 'connect' | 'disconnect' | 'message' | 'error'\n\nexport interface WsHandlerDefinition {\n  type: WsHandlerType\n  /** Event name — only for 'message' type */\n  event?: string\n  /** Method name on the controller class */\n  handlerName: string\n}\n\nexport interface WsAdapterOptions {\n  /** Base path for WebSocket upgrade (default: '/ws') */\n  path?: string\n  /** Heartbeat ping interval in ms (default: 30000). Set to 0 to disable. */\n  heartbeatInterval?: number\n  /** Maximum message payload size in bytes */\n  maxPayload?: number\n}\n\n/** Registry of all @WsController classes — populated at decorator time */\nexport const wsControllerRegistry = new Set<Constructor>()\n","import type { WebSocket, WebSocketServer } from 'ws'\nimport type { RoomManager } from './room-manager'\n\n/**\n * Context object passed to WebSocket handler methods.\n * Analogous to RequestContext for HTTP controllers.\n *\n * @example\n * ```ts\n * @OnMessage('chat:send')\n * handleSend(ctx: WsContext) {\n *   console.log(ctx.data)          // parsed message payload\n *   ctx.send('chat:ack', { ok: true })\n *   ctx.broadcast('chat:receive', ctx.data)\n *   ctx.join('room-1')\n *   ctx.to('room-1').send('chat:receive', ctx.data)\n * }\n * ```\n */\nexport class WsContext {\n  /** Unique connection ID */\n  readonly id: string\n  /** Parsed message payload (set for @OnMessage handlers) */\n  data: any\n  /** Event name from the message envelope (set for @OnMessage handlers) */\n  event: string\n  /** The namespace this connection belongs to */\n  readonly namespace: string\n\n  private metadata = new Map<string, any>()\n\n  constructor(\n    readonly socket: WebSocket,\n    readonly server: WebSocketServer,\n    private readonly roomManager: RoomManager,\n    private readonly namespaceSockets: Map<string, WebSocket>,\n    id: string,\n    namespace: string,\n  ) {\n    this.id = id\n    this.namespace = namespace\n    this.data = null\n    this.event = ''\n  }\n\n  /** Get a metadata value */\n  get<T = any>(key: string): T | undefined {\n    return this.metadata.get(key)\n  }\n\n  /** Set a metadata value (persists for the lifetime of the connection) */\n  set(key: string, value: any): void {\n    this.metadata.set(key, value)\n  }\n\n  /** Send a message to this socket */\n  send(event: string, data: any): void {\n    if (this.socket.readyState === this.socket.OPEN) {\n      this.socket.send(JSON.stringify({ event, data }))\n    }\n  }\n\n  /** Send to all sockets in the same namespace except this one */\n  broadcast(event: string, data: any): void {\n    const message = JSON.stringify({ event, data })\n    for (const [id, socket] of this.namespaceSockets) {\n      if (id !== this.id && socket.readyState === socket.OPEN) {\n        socket.send(message)\n      }\n    }\n  }\n\n  /** Send to all sockets in the same namespace including this one */\n  broadcastAll(event: string, data: any): void {\n    const message = JSON.stringify({ event, data })\n    for (const [, socket] of this.namespaceSockets) {\n      if (socket.readyState === socket.OPEN) {\n        socket.send(message)\n      }\n    }\n  }\n\n  /** Join a room */\n  join(room: string): void {\n    this.roomManager.join(this.id, this.socket, room)\n  }\n\n  /** Leave a room */\n  leave(room: string): void {\n    this.roomManager.leave(this.id, room)\n  }\n\n  /** Get all rooms this socket is in */\n  rooms(): string[] {\n    return this.roomManager.getRooms(this.id)\n  }\n\n  /** Send to all sockets in a room */\n  to(room: string): { send(event: string, data: any): void } {\n    return {\n      send: (event: string, data: any) => {\n        this.roomManager.broadcast(room, event, data)\n      },\n    }\n  }\n}\n","import type { WebSocket } from 'ws'\n\n/**\n * Manages WebSocket room membership and broadcasting.\n * Standalone from ws/socket.io — can be swapped for socket.io's built-in rooms.\n */\nexport class RoomManager {\n  /** socketId → set of room names */\n  private socketRooms = new Map<string, Set<string>>()\n  /** room name → set of { socketId, socket } */\n  private roomSockets = new Map<string, Map<string, WebSocket>>()\n\n  join(socketId: string, socket: WebSocket, room: string): void {\n    if (!this.socketRooms.has(socketId)) {\n      this.socketRooms.set(socketId, new Set())\n    }\n    this.socketRooms.get(socketId)!.add(room)\n\n    if (!this.roomSockets.has(room)) {\n      this.roomSockets.set(room, new Map())\n    }\n    this.roomSockets.get(room)!.set(socketId, socket)\n  }\n\n  leave(socketId: string, room: string): void {\n    this.socketRooms.get(socketId)?.delete(room)\n    this.roomSockets.get(room)?.delete(socketId)\n\n    // Clean up empty rooms\n    if (this.roomSockets.get(room)?.size === 0) {\n      this.roomSockets.delete(room)\n    }\n  }\n\n  /** Remove socket from all rooms (called on disconnect) */\n  leaveAll(socketId: string): void {\n    const rooms = this.socketRooms.get(socketId)\n    if (rooms) {\n      for (const room of rooms) {\n        this.roomSockets.get(room)?.delete(socketId)\n        if (this.roomSockets.get(room)?.size === 0) {\n          this.roomSockets.delete(room)\n        }\n      }\n    }\n    this.socketRooms.delete(socketId)\n  }\n\n  getRooms(socketId: string): string[] {\n    return Array.from(this.socketRooms.get(socketId) ?? [])\n  }\n\n  getSockets(room: string): Map<string, WebSocket> {\n    return this.roomSockets.get(room) ?? new Map()\n  }\n\n  /** Get all rooms with their member counts */\n  getAllRooms(): Record<string, number> {\n    const result: Record<string, number> = {}\n    for (const [room, sockets] of this.roomSockets) {\n      result[room] = sockets.size\n    }\n    return result\n  }\n\n  /** Broadcast to all sockets in a room, optionally excluding one */\n  broadcast(room: string, event: string, data: any, excludeId?: string): void {\n    const sockets = this.roomSockets.get(room)\n    if (!sockets) return\n\n    const message = JSON.stringify({ event, data })\n    for (const [id, socket] of sockets) {\n      if (id !== excludeId && socket.readyState === socket.OPEN) {\n        socket.send(message)\n      }\n    }\n  }\n}\n","import { randomUUID } from 'node:crypto'\nimport { WebSocketServer, type WebSocket } from 'ws'\nimport type { IncomingMessage } from 'node:http'\nimport type { Duplex } from 'node:stream'\nimport {\n  type AppAdapter,\n  type AdapterContext,\n  type Container,\n  createLogger,\n  ref,\n  type Ref,\n  getClassMetaOrUndefined,\n  getClassMeta,\n} from '@forinda/kickjs'\nimport {\n  WS_METADATA,\n  wsControllerRegistry,\n  type WsAdapterOptions,\n  type WsHandlerDefinition,\n} from './interfaces'\nimport { WsContext } from './ws-context'\nimport { RoomManager } from './room-manager'\n\nconst log = createLogger('WsAdapter')\n\ninterface NamespaceEntry {\n  namespace: string\n  controllerClass: any\n  handlers: WsHandlerDefinition[]\n  sockets: Map<string, WebSocket>\n  contexts: Map<string, WsContext>\n}\n\n/**\n * WebSocket adapter for KickJS. Attaches to the HTTP server and routes\n * WebSocket connections to @WsController classes based on namespace paths.\n *\n * @example\n * ```ts\n * import { WsAdapter } from '@forinda/kickjs-ws'\n *\n * bootstrap({\n *   modules: [ChatModule],\n *   adapters: [\n *     new WsAdapter({ path: '/ws' }),\n *   ],\n * })\n * ```\n *\n * Clients connect to: `ws://localhost:3000/ws/chat`\n * Messages are JSON: `{ \"event\": \"send\", \"data\": { \"text\": \"hello\" } }`\n */\nexport class WsAdapter implements AppAdapter {\n  readonly name = 'WsAdapter'\n\n  private basePath: string\n  private heartbeatInterval: number\n  private maxPayload: number | undefined\n  private wss: WebSocketServer | null = null\n  private container: Container | null = null\n  private namespaces = new Map<string, NamespaceEntry>()\n  private roomManager = new RoomManager()\n  private heartbeatTimer: ReturnType<typeof setInterval> | null = null\n\n  // ── Reactive Stats (exposed for DevToolsAdapter) ─────────────────────\n  /** Total WebSocket connections ever opened */\n  readonly totalConnections: Ref<number>\n  /** Currently active connections */\n  readonly activeConnections: Ref<number>\n  /** Total messages received */\n  readonly messagesReceived: Ref<number>\n  /** Total messages sent */\n  readonly messagesSent: Ref<number>\n  /** Total errors */\n  readonly wsErrors: Ref<number>\n\n  constructor(options: WsAdapterOptions = {}) {\n    this.basePath = options.path ?? '/ws'\n    this.heartbeatInterval = options.heartbeatInterval ?? 30000\n    this.maxPayload = options.maxPayload\n\n    this.totalConnections = ref(0)\n    this.activeConnections = ref(0)\n    this.messagesReceived = ref(0)\n    this.messagesSent = ref(0)\n    this.wsErrors = ref(0)\n  }\n\n  /** Get a snapshot of WebSocket stats for DevTools */\n  getStats() {\n    const namespaceStats: Record<string, { connections: number; handlers: number }> = {}\n    for (const [path, entry] of this.namespaces) {\n      namespaceStats[path] = {\n        connections: entry.sockets.size,\n        handlers: entry.handlers.length,\n      }\n    }\n    return {\n      totalConnections: this.totalConnections.value,\n      activeConnections: this.activeConnections.value,\n      messagesReceived: this.messagesReceived.value,\n      messagesSent: this.messagesSent.value,\n      errors: this.wsErrors.value,\n      namespaces: namespaceStats,\n      rooms: this.roomManager.getAllRooms(),\n    }\n  }\n\n  beforeStart({ container }: AdapterContext): void {\n    this.container = container\n\n    // Discover all @WsController classes and build routing table\n    for (const controllerClass of wsControllerRegistry) {\n      const namespace = getClassMetaOrUndefined<string>(WS_METADATA.WS_CONTROLLER, controllerClass)\n      if (namespace === undefined) continue\n\n      const handlers = getClassMeta<WsHandlerDefinition[]>(\n        WS_METADATA.WS_HANDLERS,\n        controllerClass,\n        [],\n      )\n\n      const fullPath = this.basePath + (namespace === '/' ? '' : namespace)\n\n      this.namespaces.set(fullPath, {\n        namespace,\n        controllerClass,\n        handlers,\n        sockets: new Map(),\n        contexts: new Map(),\n      })\n\n      log.info(`Registered WS namespace: ${fullPath} (${controllerClass.name})`)\n    }\n  }\n\n  afterStart({ server }: AdapterContext): void {\n    if (!server) return\n\n    this.wss = new WebSocketServer({\n      noServer: true,\n      maxPayload: this.maxPayload,\n    })\n\n    // Handle upgrade requests — route to correct namespace\n    server.on('upgrade', (request: IncomingMessage, socket: Duplex, head: Buffer) => {\n      const url = request.url || '/'\n      // Parse pathname without relying on host header\n      const pathname = url.split('?')[0]\n\n      const entry = this.namespaces.get(pathname)\n      if (!entry) {\n        socket.write('HTTP/1.1 404 Not Found\\r\\n\\r\\n')\n        socket.destroy()\n        return\n      }\n\n      this.wss!.handleUpgrade(request, socket, head, (ws) => {\n        this.handleConnection(ws, entry)\n      })\n    })\n\n    // Heartbeat ping/pong\n    if (this.heartbeatInterval > 0) {\n      this.heartbeatTimer = setInterval(() => {\n        for (const [, entry] of this.namespaces) {\n          for (const [, socket] of entry.sockets) {\n            if ((socket as any).__alive === false) {\n              socket.terminate()\n              continue\n            }\n            ;(socket as any).__alive = false\n            socket.ping()\n          }\n        }\n      }, this.heartbeatInterval)\n    }\n\n    const totalHandlers = Array.from(this.namespaces.values()).reduce(\n      (sum, e) => sum + e.handlers.length,\n      0,\n    )\n    log.info(`WebSocket ready — ${this.namespaces.size} namespace(s), ${totalHandlers} handler(s)`)\n  }\n\n  shutdown(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer)\n    }\n\n    // Close all connections\n    for (const [, entry] of this.namespaces) {\n      for (const [, socket] of entry.sockets) {\n        socket.close(1001, 'Server shutting down')\n      }\n      entry.sockets.clear()\n      entry.contexts.clear()\n    }\n\n    this.wss?.close()\n  }\n\n  // ── Internal ───────────────────────────────────────────────────────────\n\n  private handleConnection(ws: WebSocket, entry: NamespaceEntry): void {\n    const socketId = randomUUID()\n    ;(ws as any).__alive = true\n\n    entry.sockets.set(socketId, ws)\n    this.totalConnections.value++\n    this.activeConnections.value++\n\n    const ctx = new WsContext(\n      ws,\n      this.wss!,\n      this.roomManager,\n      entry.sockets,\n      socketId,\n      entry.namespace,\n    )\n    entry.contexts.set(socketId, ctx)\n\n    // Resolve controller from DI\n    const controller = this.container!.resolve(entry.controllerClass)\n\n    // Pong handler for heartbeat\n    ws.on('pong', () => {\n      ;(ws as any).__alive = true\n    })\n\n    // @OnConnect handlers\n    this.invokeHandlers(controller, entry.handlers, 'connect', ctx)\n\n    // Message handler\n    ws.on('message', (raw: Buffer | string) => {\n      this.messagesReceived.value++\n      try {\n        const parsed = JSON.parse(raw.toString())\n        const event = parsed.event as string\n        const data = parsed.data\n\n        if (!event || typeof event !== 'string') {\n          ctx.send('error', { message: 'Invalid message format: missing \"event\" field' })\n          return\n        }\n\n        ctx.event = event\n        ctx.data = data\n\n        // Find matching @OnMessage handler\n        const handler = entry.handlers.find((h) => h.type === 'message' && h.event === event)\n\n        if (handler) {\n          this.safeInvoke(controller, handler.handlerName, ctx)\n        } else {\n          // Try catch-all @OnMessage('*')\n          const catchAll = entry.handlers.find((h) => h.type === 'message' && h.event === '*')\n          if (catchAll) {\n            this.safeInvoke(controller, catchAll.handlerName, ctx)\n          }\n        }\n      } catch {\n        ctx.data = { message: 'Invalid JSON' }\n        this.invokeHandlers(controller, entry.handlers, 'error', ctx)\n      }\n    })\n\n    // Close handler\n    ws.on('close', () => {\n      this.activeConnections.value--\n      this.invokeHandlers(controller, entry.handlers, 'disconnect', ctx)\n      this.roomManager.leaveAll(socketId)\n      entry.sockets.delete(socketId)\n      entry.contexts.delete(socketId)\n    })\n\n    // Error handler\n    ws.on('error', (err: Error) => {\n      this.wsErrors.value++\n      ctx.data = { message: err.message, name: err.name }\n      this.invokeHandlers(controller, entry.handlers, 'error', ctx)\n    })\n  }\n\n  private invokeHandlers(\n    controller: any,\n    handlers: WsHandlerDefinition[],\n    type: WsHandlerDefinition['type'],\n    ctx: WsContext,\n  ): void {\n    for (const handler of handlers) {\n      if (handler.type === type) {\n        this.safeInvoke(controller, handler.handlerName, ctx)\n      }\n    }\n  }\n\n  private safeInvoke(controller: any, method: string, ctx: WsContext): void {\n    try {\n      const result = controller[method](ctx)\n      if (result instanceof Promise) {\n        result.catch((err: Error) => {\n          log.error({ err }, `WS handler error in ${method}`)\n        })\n      }\n    } catch (err) {\n      log.error({ err }, `WS handler error in ${method}`)\n    }\n  }\n}\n","import { Service, setClassMeta, pushClassMeta } from '@forinda/kickjs'\nimport { WS_METADATA, wsControllerRegistry, type WsHandlerDefinition } from './interfaces'\n\n/**\n * Mark a class as a WebSocket controller with a namespace path.\n * Registers the class in the DI container and the WS controller registry.\n *\n * @example\n * ```ts\n * @WsController('/chat')\n * export class ChatController {\n *   @OnConnect()\n *   handleConnect(ctx: WsContext) { }\n *\n *   @OnMessage('send')\n *   handleSend(ctx: WsContext) { }\n * }\n * ```\n */\nexport function WsController(namespace?: string): ClassDecorator {\n  return (target: any) => {\n    Service()(target)\n    setClassMeta(WS_METADATA.WS_CONTROLLER, namespace || '/', target)\n    wsControllerRegistry.add(target)\n  }\n}\n\nfunction createWsHandlerDecorator(type: WsHandlerDefinition['type'], event?: string) {\n  return (): MethodDecorator => {\n    return (target, propertyKey) => {\n      pushClassMeta<WsHandlerDefinition>(WS_METADATA.WS_HANDLERS, target.constructor, {\n        type,\n        event,\n        handlerName: propertyKey as string,\n      })\n    }\n  }\n}\n\n/**\n * Handle new WebSocket connections.\n *\n * @example\n * ```ts\n * @OnConnect()\n * handleConnect(ctx: WsContext) {\n *   console.log(`Client ${ctx.id} connected`)\n * }\n * ```\n */\nexport const OnConnect = createWsHandlerDecorator('connect')\n\n/**\n * Handle WebSocket disconnections.\n *\n * @example\n * ```ts\n * @OnDisconnect()\n * handleDisconnect(ctx: WsContext) {\n *   console.log(`Client ${ctx.id} disconnected`)\n * }\n * ```\n */\nexport const OnDisconnect = createWsHandlerDecorator('disconnect')\n\n/**\n * Handle WebSocket errors.\n *\n * @example\n * ```ts\n * @OnError()\n * handleError(ctx: WsContext) {\n *   console.error('WS error:', ctx.data)\n * }\n * ```\n */\nexport const OnError = createWsHandlerDecorator('error')\n\n/**\n * Handle a specific WebSocket message event.\n * Use '*' as a catch-all for unmatched events.\n *\n * Messages must be JSON: `{ \"event\": \"chat:send\", \"data\": { ... } }`\n *\n * @example\n * ```ts\n * @OnMessage('chat:send')\n * handleChatSend(ctx: WsContext) {\n *   ctx.broadcast('chat:receive', ctx.data)\n * }\n *\n * @OnMessage('*')\n * handleUnknown(ctx: WsContext) {\n *   ctx.send('error', { message: `Unknown event: ${ctx.event}` })\n * }\n * ```\n */\nexport function OnMessage(event: string): MethodDecorator {\n  return (target, propertyKey) => {\n    pushClassMeta<WsHandlerDefinition>(WS_METADATA.WS_HANDLERS, target.constructor, {\n      type: 'message',\n      event,\n      handlerName: propertyKey as string,\n    })\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-ws",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "WebSocket support with decorators, namespaces, rooms, and DI integration for KickJS",
   "keywords": [
     "kickjs",
@@ -38,28 +38,45 @@
     "vite"
   ],
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
     }
   },
   "files": [
     "dist"
   ],
+  "wireit": {
+    "build": {
+      "command": "tsdown",
+      "files": [
+        "src/**/*.ts",
+        "tsdown.config.ts",
+        "tsconfig.json",
+        "package.json"
+      ],
+      "output": [
+        "dist/**"
+      ],
+      "dependencies": [
+        "../core:build"
+      ]
+    }
+  },
   "dependencies": {
     "reflect-metadata": "^0.2.2",
     "ws": "^8.20.0",
-    "@forinda/kickjs": "2.0.1"
+    "@forinda/kickjs": "2.1.0"
   },
   "devDependencies": {
-    "@swc/core": "^1.7.28",
+    "@swc/core": "^1.15.21",
     "@types/node": "^25.0.0",
     "@types/ws": "^8.18.0",
     "typescript": "^5.9.2",
-    "vitest": "^4.1.1"
+    "vitest": "^4.1.2"
   },
   "publishConfig": {
     "access": "public"
@@ -79,13 +96,12 @@
     "url": "https://github.com/forinda/kick-js/issues"
   },
   "scripts": {
-    "build": "vite build && pnpm build:types",
-    "build:types": "tsc -p tsconfig.build.json",
-    "dev": "vite build --watch",
+    "build": "wireit",
+    "dev": "tsdown --watch",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist .turbo",
+    "clean": "rm -rf dist .wireit",
     "lint": "tsc --noEmit"
   }
 }

package/dist/decorators.d.ts

@@ -1,75 +0,0 @@
-import 'reflect-metadata';
-/**
- * Mark a class as a WebSocket controller with a namespace path.
- * Registers the class in the DI container and the WS controller registry.
- *
- * @example
- * ```ts
- * @WsController('/chat')
- * export class ChatController {
- *   @OnConnect()
- *   handleConnect(ctx: WsContext) { }
- *
- *   @OnMessage('send')
- *   handleSend(ctx: WsContext) { }
- * }
- * ```
- */
-export declare function WsController(namespace?: string): ClassDecorator;
-/**
- * Handle new WebSocket connections.
- *
- * @example
- * ```ts
- * @OnConnect()
- * handleConnect(ctx: WsContext) {
- *   console.log(`Client ${ctx.id} connected`)
- * }
- * ```
- */
-export declare const OnConnect: () => MethodDecorator;
-/**
- * Handle WebSocket disconnections.
- *
- * @example
- * ```ts
- * @OnDisconnect()
- * handleDisconnect(ctx: WsContext) {
- *   console.log(`Client ${ctx.id} disconnected`)
- * }
- * ```
- */
-export declare const OnDisconnect: () => MethodDecorator;
-/**
- * Handle WebSocket errors.
- *
- * @example
- * ```ts
- * @OnError()
- * handleError(ctx: WsContext) {
- *   console.error('WS error:', ctx.data)
- * }
- * ```
- */
-export declare const OnError: () => MethodDecorator;
-/**
- * Handle a specific WebSocket message event.
- * Use '*' as a catch-all for unmatched events.
- *
- * Messages must be JSON: `{ "event": "chat:send", "data": { ... } }`
- *
- * @example
- * ```ts
- * @OnMessage('chat:send')
- * handleChatSend(ctx: WsContext) {
- *   ctx.broadcast('chat:receive', ctx.data)
- * }
- *
- * @OnMessage('*')
- * handleUnknown(ctx: WsContext) {
- *   ctx.send('error', { message: `Unknown event: ${ctx.event}` })
- * }
- * ```
- */
-export declare function OnMessage(event: string): MethodDecorator;
-//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAIzB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAM/D;AAiBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,QAzBT,eAyB+C,CAAA;AAE5D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,QAtCZ,eAsCqD,CAAA;AAElE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,QAnDP,eAmD2C,CAAA;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAWxD"}

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-export { WsAdapter } from './ws-adapter';
-export { WsContext } from './ws-context';
-export { WsController, OnConnect, OnDisconnect, OnMessage, OnError } from './decorators';
-export { RoomManager } from './room-manager';
-export { WS_METADATA, type WsAdapterOptions, type WsHandlerDefinition, type WsHandlerType, } from './interfaces';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAGxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAGxC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGxF,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG5C,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -1,262 +0,0 @@
-import { randomUUID as u } from "node:crypto";
-import { WebSocketServer as k } from "ws";
-import { Service as p, createLogger as R, ref as h } from "@forinda/kickjs";
-import "reflect-metadata";
-var c = {
-  WS_CONTROLLER: /* @__PURE__ */ Symbol("kick:ws:controller"),
-  WS_HANDLERS: /* @__PURE__ */ Symbol("kick:ws:handlers")
-}, g = /* @__PURE__ */ new Set(), M = class {
-  id;
-  data;
-  event;
-  namespace;
-  metadata = /* @__PURE__ */ new Map();
-  constructor(e, t, s, a, o, n) {
-    this.socket = e, this.server = t, this.roomManager = s, this.namespaceSockets = a, this.id = o, this.namespace = n, this.data = null, this.event = "";
-  }
-  get(e) {
-    return this.metadata.get(e);
-  }
-  set(e, t) {
-    this.metadata.set(e, t);
-  }
-  send(e, t) {
-    this.socket.readyState === this.socket.OPEN && this.socket.send(JSON.stringify({
-      event: e,
-      data: t
-    }));
-  }
-  broadcast(e, t) {
-    const s = JSON.stringify({
-      event: e,
-      data: t
-    });
-    for (const [a, o] of this.namespaceSockets) a !== this.id && o.readyState === o.OPEN && o.send(s);
-  }
-  broadcastAll(e, t) {
-    const s = JSON.stringify({
-      event: e,
-      data: t
-    });
-    for (const [, a] of this.namespaceSockets) a.readyState === a.OPEN && a.send(s);
-  }
-  join(e) {
-    this.roomManager.join(this.id, this.socket, e);
-  }
-  leave(e) {
-    this.roomManager.leave(this.id, e);
-  }
-  rooms() {
-    return this.roomManager.getRooms(this.id);
-  }
-  to(e) {
-    return { send: (t, s) => {
-      this.roomManager.broadcast(e, t, s);
-    } };
-  }
-}, N = class {
-  socketRooms = /* @__PURE__ */ new Map();
-  roomSockets = /* @__PURE__ */ new Map();
-  join(e, t, s) {
-    this.socketRooms.has(e) || this.socketRooms.set(e, /* @__PURE__ */ new Set()), this.socketRooms.get(e).add(s), this.roomSockets.has(s) || this.roomSockets.set(s, /* @__PURE__ */ new Map()), this.roomSockets.get(s).set(e, t);
-  }
-  leave(e, t) {
-    this.socketRooms.get(e)?.delete(t), this.roomSockets.get(t)?.delete(e), this.roomSockets.get(t)?.size === 0 && this.roomSockets.delete(t);
-  }
-  leaveAll(e) {
-    const t = this.socketRooms.get(e);
-    if (t) for (const s of t)
-      this.roomSockets.get(s)?.delete(e), this.roomSockets.get(s)?.size === 0 && this.roomSockets.delete(s);
-    this.socketRooms.delete(e);
-  }
-  getRooms(e) {
-    return Array.from(this.socketRooms.get(e) ?? []);
-  }
-  getSockets(e) {
-    return this.roomSockets.get(e) ?? /* @__PURE__ */ new Map();
-  }
-  getAllRooms() {
-    const e = {};
-    for (const [t, s] of this.roomSockets) e[t] = s.size;
-    return e;
-  }
-  broadcast(e, t, s, a) {
-    const o = this.roomSockets.get(e);
-    if (!o) return;
-    const n = JSON.stringify({
-      event: t,
-      data: s
-    });
-    for (const [i, r] of o) i !== a && r.readyState === r.OPEN && r.send(n);
-  }
-}, d = R("WsAdapter"), A = class {
-  name = "WsAdapter";
-  basePath;
-  heartbeatInterval;
-  maxPayload;
-  wss = null;
-  container = null;
-  namespaces = /* @__PURE__ */ new Map();
-  roomManager = new N();
-  heartbeatTimer = null;
-  totalConnections;
-  activeConnections;
-  messagesReceived;
-  messagesSent;
-  wsErrors;
-  constructor(e = {}) {
-    this.basePath = e.path ?? "/ws", this.heartbeatInterval = e.heartbeatInterval ?? 3e4, this.maxPayload = e.maxPayload, this.totalConnections = h(0), this.activeConnections = h(0), this.messagesReceived = h(0), this.messagesSent = h(0), this.wsErrors = h(0);
-  }
-  getStats() {
-    const e = {};
-    for (const [t, s] of this.namespaces) e[t] = {
-      connections: s.sockets.size,
-      handlers: s.handlers.length
-    };
-    return {
-      totalConnections: this.totalConnections.value,
-      activeConnections: this.activeConnections.value,
-      messagesReceived: this.messagesReceived.value,
-      messagesSent: this.messagesSent.value,
-      errors: this.wsErrors.value,
-      namespaces: e,
-      rooms: this.roomManager.getAllRooms()
-    };
-  }
-  beforeStart({ container: e }) {
-    this.container = e;
-    for (const t of g) {
-      const s = Reflect.getMetadata(c.WS_CONTROLLER, t);
-      if (s === void 0) continue;
-      const a = Reflect.getMetadata(c.WS_HANDLERS, t) || [], o = this.basePath + (s === "/" ? "" : s);
-      this.namespaces.set(o, {
-        namespace: s,
-        controllerClass: t,
-        handlers: a,
-        sockets: /* @__PURE__ */ new Map(),
-        contexts: /* @__PURE__ */ new Map()
-      }), d.info(`Registered WS namespace: ${o} (${t.name})`);
-    }
-  }
-  afterStart({ server: e }) {
-    if (!e) return;
-    this.wss = new k({
-      noServer: !0,
-      maxPayload: this.maxPayload
-    }), e.on("upgrade", (s, a, o) => {
-      const n = (s.url || "/").split("?")[0], i = this.namespaces.get(n);
-      if (!i) {
-        a.write(`HTTP/1.1 404 Not Found\r
-\r
-`), a.destroy();
-        return;
-      }
-      this.wss.handleUpgrade(s, a, o, (r) => {
-        this.handleConnection(r, i);
-      });
-    }), this.heartbeatInterval > 0 && (this.heartbeatTimer = setInterval(() => {
-      for (const [, s] of this.namespaces) for (const [, a] of s.sockets) {
-        if (a.__alive === !1) {
-          a.terminate();
-          continue;
-        }
-        a.__alive = !1, a.ping();
-      }
-    }, this.heartbeatInterval));
-    const t = Array.from(this.namespaces.values()).reduce((s, a) => s + a.handlers.length, 0);
-    d.info(`WebSocket ready — ${this.namespaces.size} namespace(s), ${t} handler(s)`);
-  }
-  shutdown() {
-    this.heartbeatTimer && clearInterval(this.heartbeatTimer);
-    for (const [, e] of this.namespaces) {
-      for (const [, t] of e.sockets) t.close(1001, "Server shutting down");
-      e.sockets.clear(), e.contexts.clear();
-    }
-    this.wss?.close();
-  }
-  handleConnection(e, t) {
-    const s = u();
-    e.__alive = !0, t.sockets.set(s, e), this.totalConnections.value++, this.activeConnections.value++;
-    const a = new M(e, this.wss, this.roomManager, t.sockets, s, t.namespace);
-    t.contexts.set(s, a);
-    const o = this.container.resolve(t.controllerClass);
-    e.on("pong", () => {
-      e.__alive = !0;
-    }), this.invokeHandlers(o, t.handlers, "connect", a), e.on("message", (n) => {
-      this.messagesReceived.value++;
-      try {
-        const i = JSON.parse(n.toString()), r = i.event, S = i.data;
-        if (!r || typeof r != "string") {
-          a.send("error", { message: 'Invalid message format: missing "event" field' });
-          return;
-        }
-        a.event = r, a.data = S;
-        const f = t.handlers.find((l) => l.type === "message" && l.event === r);
-        if (f) this.safeInvoke(o, f.handlerName, a);
-        else {
-          const l = t.handlers.find((v) => v.type === "message" && v.event === "*");
-          l && this.safeInvoke(o, l.handlerName, a);
-        }
-      } catch {
-        a.data = { message: "Invalid JSON" }, this.invokeHandlers(o, t.handlers, "error", a);
-      }
-    }), e.on("close", () => {
-      this.activeConnections.value--, this.invokeHandlers(o, t.handlers, "disconnect", a), this.roomManager.leaveAll(s), t.sockets.delete(s), t.contexts.delete(s);
-    }), e.on("error", (n) => {
-      this.wsErrors.value++, a.data = {
-        message: n.message,
-        name: n.name
-      }, this.invokeHandlers(o, t.handlers, "error", a);
-    });
-  }
-  invokeHandlers(e, t, s, a) {
-    for (const o of t) o.type === s && this.safeInvoke(e, o.handlerName, a);
-  }
-  safeInvoke(e, t, s) {
-    try {
-      const a = e[t](s);
-      a instanceof Promise && a.catch((o) => {
-        d.error({ err: o }, `WS handler error in ${t}`);
-      });
-    } catch (a) {
-      d.error({ err: a }, `WS handler error in ${t}`);
-    }
-  }
-};
-function O(e) {
-  return (t) => {
-    p()(t), Reflect.defineMetadata(c.WS_CONTROLLER, e || "/", t), g.add(t);
-  };
-}
-function m(e, t) {
-  return () => (s, a) => {
-    const o = Reflect.getMetadata(c.WS_HANDLERS, s.constructor) || [];
-    o.push({
-      type: e,
-      event: t,
-      handlerName: a
-    }), Reflect.defineMetadata(c.WS_HANDLERS, o, s.constructor);
-  };
-}
-var y = m("connect"), E = m("disconnect"), _ = m("error");
-function P(e) {
-  return (t, s) => {
-    const a = Reflect.getMetadata(c.WS_HANDLERS, t.constructor) || [];
-    a.push({
-      type: "message",
-      event: e,
-      handlerName: s
-    }), Reflect.defineMetadata(c.WS_HANDLERS, a, t.constructor);
-  };
-}
-export {
-  y as OnConnect,
-  E as OnDisconnect,
-  _ as OnError,
-  P as OnMessage,
-  N as RoomManager,
-  c as WS_METADATA,
-  A as WsAdapter,
-  M as WsContext,
-  O as WsController
-};

package/dist/interfaces.d.ts

@@ -1,25 +0,0 @@
-type Constructor = new (...args: any[]) => any;
-export declare const WS_METADATA: {
-    readonly WS_CONTROLLER: symbol;
-    readonly WS_HANDLERS: symbol;
-};
-export type WsHandlerType = 'connect' | 'disconnect' | 'message' | 'error';
-export interface WsHandlerDefinition {
-    type: WsHandlerType;
-    /** Event name — only for 'message' type */
-    event?: string;
-    /** Method name on the controller class */
-    handlerName: string;
-}
-export interface WsAdapterOptions {
-    /** Base path for WebSocket upgrade (default: '/ws') */
-    path?: string;
-    /** Heartbeat ping interval in ms (default: 30000). Set to 0 to disable. */
-    heartbeatInterval?: number;
-    /** Maximum message payload size in bytes */
-    maxPayload?: number;
-}
-/** Registry of all @WsController classes — populated at decorator time */
-export declare const wsControllerRegistry: Set<Constructor>;
-export {};
-//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;AAE9C,eAAO,MAAM,WAAW;;;CAGd,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,CAAA;AAE1E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAA;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,kBAAyB,CAAA"}

package/dist/room-manager.d.ts

@@ -1,22 +0,0 @@
-import type { WebSocket } from 'ws';
-/**
- * Manages WebSocket room membership and broadcasting.
- * Standalone from ws/socket.io — can be swapped for socket.io's built-in rooms.
- */
-export declare class RoomManager {
-    /** socketId → set of room names */
-    private socketRooms;
-    /** room name → set of { socketId, socket } */
-    private roomSockets;
-    join(socketId: string, socket: WebSocket, room: string): void;
-    leave(socketId: string, room: string): void;
-    /** Remove socket from all rooms (called on disconnect) */
-    leaveAll(socketId: string): void;
-    getRooms(socketId: string): string[];
-    getSockets(room: string): Map<string, WebSocket>;
-    /** Get all rooms with their member counts */
-    getAllRooms(): Record<string, number>;
-    /** Broadcast to all sockets in a room, optionally excluding one */
-    broadcast(room: string, event: string, data: any, excludeId?: string): void;
-}
-//# sourceMappingURL=room-manager.d.ts.map

package/dist/room-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"room-manager.d.ts","sourceRoot":"","sources":["../src/room-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AAEnC;;;GAGG;AACH,qBAAa,WAAW;IACtB,mCAAmC;IACnC,OAAO,CAAC,WAAW,CAAiC;IACpD,8CAA8C;IAC9C,OAAO,CAAC,WAAW,CAA4C;IAE/D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAY7D,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAU3C,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAahC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAIpC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAIhD,6CAA6C;IAC7C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQrC,mEAAmE;IACnE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;CAW5E"}

package/dist/ws-adapter.d.ts

@@ -1,63 +0,0 @@
-import { type AppAdapter, type AdapterContext, type Ref } from '@forinda/kickjs';
-import { type WsAdapterOptions } from './interfaces';
-/**
- * WebSocket adapter for KickJS. Attaches to the HTTP server and routes
- * WebSocket connections to @WsController classes based on namespace paths.
- *
- * @example
- * ```ts
- * import { WsAdapter } from '@forinda/kickjs-ws'
- *
- * bootstrap({
- *   modules: [ChatModule],
- *   adapters: [
- *     new WsAdapter({ path: '/ws' }),
- *   ],
- * })
- * ```
- *
- * Clients connect to: `ws://localhost:3000/ws/chat`
- * Messages are JSON: `{ "event": "send", "data": { "text": "hello" } }`
- */
-export declare class WsAdapter implements AppAdapter {
-    readonly name = "WsAdapter";
-    private basePath;
-    private heartbeatInterval;
-    private maxPayload;
-    private wss;
-    private container;
-    private namespaces;
-    private roomManager;
-    private heartbeatTimer;
-    /** Total WebSocket connections ever opened */
-    readonly totalConnections: Ref<number>;
-    /** Currently active connections */
-    readonly activeConnections: Ref<number>;
-    /** Total messages received */
-    readonly messagesReceived: Ref<number>;
-    /** Total messages sent */
-    readonly messagesSent: Ref<number>;
-    /** Total errors */
-    readonly wsErrors: Ref<number>;
-    constructor(options?: WsAdapterOptions);
-    /** Get a snapshot of WebSocket stats for DevTools */
-    getStats(): {
-        totalConnections: number;
-        activeConnections: number;
-        messagesReceived: number;
-        messagesSent: number;
-        errors: number;
-        namespaces: Record<string, {
-            connections: number;
-            handlers: number;
-        }>;
-        rooms: Record<string, number>;
-    };
-    beforeStart({ container }: AdapterContext): void;
-    afterStart({ server }: AdapterContext): void;
-    shutdown(): void;
-    private handleConnection;
-    private invokeHandlers;
-    private safeInvoke;
-}
-//# sourceMappingURL=ws-adapter.d.ts.map

package/dist/ws-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ws-adapter.d.ts","sourceRoot":"","sources":["../src/ws-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,cAAc,EAInB,KAAK,GAAG,EACT,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,cAAc,CAAA;AAcrB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,QAAQ,CAAC,IAAI,eAAc;IAE3B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,cAAc,CAA8C;IAGpE,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACtC,mCAAmC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACvC,8BAA8B;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACtC,0BAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClC,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;gBAElB,OAAO,GAAE,gBAAqB;IAY1C,qDAAqD;IACrD,QAAQ;;;;;;;yBAC8C,MAAM;sBAAY,MAAM;;;;IAkB9E,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,cAAc,GAAG,IAAI;IA4BhD,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,cAAc,GAAG,IAAI;IAiD5C,QAAQ,IAAI,IAAI;IAmBhB,OAAO,CAAC,gBAAgB;IAgFxB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,UAAU;CAYnB"}

package/dist/ws-context.d.ts

@@ -1,55 +0,0 @@
-import type { WebSocket, WebSocketServer } from 'ws';
-import type { RoomManager } from './room-manager';
-/**
- * Context object passed to WebSocket handler methods.
- * Analogous to RequestContext for HTTP controllers.
- *
- * @example
- * ```ts
- * @OnMessage('chat:send')
- * handleSend(ctx: WsContext) {
- *   console.log(ctx.data)          // parsed message payload
- *   ctx.send('chat:ack', { ok: true })
- *   ctx.broadcast('chat:receive', ctx.data)
- *   ctx.join('room-1')
- *   ctx.to('room-1').send('chat:receive', ctx.data)
- * }
- * ```
- */
-export declare class WsContext {
-    readonly socket: WebSocket;
-    readonly server: WebSocketServer;
-    private readonly roomManager;
-    private readonly namespaceSockets;
-    /** Unique connection ID */
-    readonly id: string;
-    /** Parsed message payload (set for @OnMessage handlers) */
-    data: any;
-    /** Event name from the message envelope (set for @OnMessage handlers) */
-    event: string;
-    /** The namespace this connection belongs to */
-    readonly namespace: string;
-    private metadata;
-    constructor(socket: WebSocket, server: WebSocketServer, roomManager: RoomManager, namespaceSockets: Map<string, WebSocket>, id: string, namespace: string);
-    /** Get a metadata value */
-    get<T = any>(key: string): T | undefined;
-    /** Set a metadata value (persists for the lifetime of the connection) */
-    set(key: string, value: any): void;
-    /** Send a message to this socket */
-    send(event: string, data: any): void;
-    /** Send to all sockets in the same namespace except this one */
-    broadcast(event: string, data: any): void;
-    /** Send to all sockets in the same namespace including this one */
-    broadcastAll(event: string, data: any): void;
-    /** Join a room */
-    join(room: string): void;
-    /** Leave a room */
-    leave(room: string): void;
-    /** Get all rooms this socket is in */
-    rooms(): string[];
-    /** Send to all sockets in a room */
-    to(room: string): {
-        send(event: string, data: any): void;
-    };
-}
-//# sourceMappingURL=ws-context.d.ts.map