@forinda/kickjs-ws 3.2.0 → 4.0.0

package/README.md

@@ -1,52 +1,50 @@
 # @forinda/kickjs-ws
 
-WebSocket support with decorators, namespaces, rooms, and DI integration for KickJS.
+WebSocket adapter for KickJS — decorator-driven handlers (`@WsController`, `@OnConnect`, `@OnDisconnect`, `@OnMessage`, `@OnError`), namespaces, rooms, heartbeat, optional auth resolver.
 
 ## Install
 
 ```bash
-# Using the KickJS CLI (recommended — auto-installs peer dependencies)
 kick add ws
-
-# Manual install
-pnpm add @forinda/kickjs-ws ws
 ```
 
-## Features
-
-- `WsAdapter` — lifecycle adapter that attaches a WebSocket server to your app
-- Decorator-driven handlers: `@WsController`, `@OnConnect`, `@OnDisconnect`, `@OnMessage`, `@OnError`
-- `WsContext` — typed context for WebSocket handlers
-- `RoomManager` — built-in room/namespace management
-
 ## Quick Example
 
-```typescript
-import { WsAdapter, WsController, OnConnect, OnMessage, WsContext } from '@forinda/kickjs-ws'
+```ts
+// chat.ws-controller.ts
+import { WsController, OnConnect, OnMessage, WsContext } from '@forinda/kickjs-ws'
 
 @WsController('/chat')
-class ChatHandler {
+export class ChatController {
   @OnConnect()
   onConnect(ctx: WsContext) {
-    console.log('Client connected')
+    ctx.send('welcome', { id: ctx.socketId })
   }
 
-  @OnMessage('message')
-  onMessage(ctx: WsContext) {
-    ctx.broadcast(ctx.data)
+  @OnMessage('say')
+  onSay(ctx: WsContext) {
+    ctx.broadcast('say', ctx.data)
   }
 }
+```
+
+```ts
+// src/index.ts
+import { bootstrap } from '@forinda/kickjs'
+import { WsAdapter } from '@forinda/kickjs-ws'
+import { modules } from './modules'
 
-// In bootstrap
-bootstrap({
+export const app = await bootstrap({
   modules,
-  adapters: [new WsAdapter()],
+  adapters: [WsAdapter({ path: '/ws' })],
 })
 ```
 
+Clients connect to `ws://localhost:3000/ws/chat`.
+
 ## Documentation
 
-[Full documentation](https://forinda.github.io/kick-js/guide/websockets)
+[forinda.github.io/kick-js/guide/websockets](https://forinda.github.io/kick-js/guide/websockets)
 
 ## License
 

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 
 import { WebSocket, WebSocketServer } from "ws";
 import * as _$_forinda_kickjs0 from "@forinda/kickjs";
-import { AdapterContext, AppAdapter, Ref } from "@forinda/kickjs";
+import { Ref } from "@forinda/kickjs";
 import { IncomingMessage } from "node:http";
 
 //#region src/room-manager.d.ts
@@ -101,48 +101,12 @@ declare const WS_USER_BROADCASTER: _$_forinda_kickjs0.InjectionToken<WsUserBroad
 //#endregion
 //#region src/ws-adapter.d.ts
 /**
- * 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" } }`
+ * Public extension methods exposed by a WsAdapter instance — broadcast
+ * helpers, namespace stats, and reactive counters that DevTools and
+ * other adapters consume directly.
  */
-declare class WsAdapter implements AppAdapter {
-  readonly name = "WsAdapter";
-  private basePath;
-  private heartbeatInterval;
-  private maxPayload;
-  private auth?;
-  private userRoomPrefix;
-  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 */
+interface WsAdapterExtensions {
+  /** Snapshot of WebSocket stats — consumed by DevTools / Swagger ws-server discovery. */
   getStats(): {
     totalConnections: number;
     activeConnections: number;
@@ -153,31 +117,43 @@ declare class WsAdapter implements AppAdapter {
       connections: number;
       handlers: number;
     }>;
-    rooms: Record<string, number>;
+    rooms: ReturnType<RoomManager['getAllRooms']>;
   };
   /** Room name used for per-user broadcasting. */
   userRoom(userId: string): string;
   /** Broadcast a single event to every socket in `user:<id>` (across namespaces). */
   broadcastToUser(userId: string, event: string, data: unknown): void;
-  private buildUserBroadcaster;
-  beforeStart({
-    container
-  }: AdapterContext): void;
-  afterStart({
-    server
-  }: AdapterContext): void;
-  shutdown(): void;
-  private handleConnection;
-  /**
-   * Runs the configured auth hook against the upgrade request. Stashes the
-   * resolved user on the context (as `user`, plus mirrored keys) and, when
-   * `autoJoinUserRoom` is enabled, joins the socket to `user:<id>`.
-   * Returns `false` (and closes the socket with code 4401) on failure.
-   */
-  private authenticate;
-  private invokeHandlers;
-  private safeInvoke;
+  /** 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>;
 }
+/**
+ * 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: [
+ *     WsAdapter({ path: '/ws' }),
+ *   ],
+ * })
+ * ```
+ *
+ * Clients connect to: `ws://localhost:3000/ws/chat`
+ * Messages are JSON: `{ "event": "send", "data": { "text": "hello" } }`
+ */
+declare const WsAdapter: _$_forinda_kickjs0.AdapterFactory<WsAdapterOptions, WsAdapterExtensions>;
 //#endregion
 //#region src/ws-context.d.ts
 /**

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/room-manager.ts","../src/interfaces.ts","../src/ws-adapter.ts","../src/ws-context.ts","../src/decorators.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/room-manager.ts","../src/interfaces.ts","../src/ws-adapter.ts","../src/ws-context.ts","../src/decorators.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-ws v3.2.0
+ * @forinda/kickjs-ws v4.0.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -10,7 +10,7 @@
  */
 import { randomUUID } from "node:crypto";
 import { WebSocketServer } from "ws";
-import { Service, createLogger, createToken, getClassMeta, getClassMetaOrUndefined, pushClassMeta, ref, setClassMeta } from "@forinda/kickjs";
+import { Service, createLogger, createToken, defineAdapter, getClassMeta, getClassMetaOrUndefined, pushClassMeta, ref, setClassMeta } from "@forinda/kickjs";
 //#region src/interfaces.ts
 const WS_METADATA = {
 	WS_CONTROLLER: Symbol("kick:ws:controller"),
@@ -198,7 +198,7 @@ const log = createLogger("WsAdapter");
 * bootstrap({
 *   modules: [ChatModule],
 *   adapters: [
-*     new WsAdapter({ path: '/ws' }),
+*     WsAdapter({ path: '/ws' }),
 *   ],
 * })
 * ```
@@ -206,230 +206,229 @@ const log = createLogger("WsAdapter");
 * Clients connect to: `ws://localhost:3000/ws/chat`
 * Messages are JSON: `{ "event": "send", "data": { "text": "hello" } }`
 */
-var WsAdapter = class {
-	name = "WsAdapter";
-	basePath;
-	heartbeatInterval;
-	maxPayload;
-	auth;
-	userRoomPrefix;
-	wss = null;
-	container = null;
-	namespaces = /* @__PURE__ */ new Map();
-	roomManager = new RoomManager();
-	heartbeatTimer = null;
-	/** Total WebSocket connections ever opened */
-	totalConnections;
-	/** Currently active connections */
-	activeConnections;
-	/** Total messages received */
-	messagesReceived;
-	/** Total messages sent */
-	messagesSent;
-	/** Total errors */
-	wsErrors;
-	constructor(options = {}) {
-		this.basePath = options.path ?? "/ws";
-		this.heartbeatInterval = options.heartbeatInterval ?? 3e4;
-		this.maxPayload = options.maxPayload;
-		this.auth = options.auth;
-		this.userRoomPrefix = options.auth?.userRoomPrefix ?? "user:";
-		this.totalConnections = ref(0);
-		this.activeConnections = ref(0);
-		this.messagesReceived = ref(0);
-		this.messagesSent = ref(0);
-		this.wsErrors = ref(0);
-	}
-	/** Get a snapshot of WebSocket stats for DevTools */
-	getStats() {
-		const namespaceStats = {};
-		for (const [path, entry] of this.namespaces) namespaceStats[path] = {
-			connections: entry.sockets.size,
-			handlers: entry.handlers.length
-		};
-		return {
-			totalConnections: this.totalConnections.value,
-			activeConnections: this.activeConnections.value,
-			messagesReceived: this.messagesReceived.value,
-			messagesSent: this.messagesSent.value,
-			errors: this.wsErrors.value,
-			namespaces: namespaceStats,
-			rooms: this.roomManager.getAllRooms()
-		};
-	}
-	/** Room name used for per-user broadcasting. */
-	userRoom(userId) {
-		return this.userRoomPrefix + userId;
-	}
-	/** Broadcast a single event to every socket in `user:<id>` (across namespaces). */
-	broadcastToUser(userId, event, data) {
-		this.roomManager.broadcast(this.userRoom(userId), event, data);
-	}
-	buildUserBroadcaster() {
-		const self = this;
-		return {
-			roomFor: (id) => self.userRoom(id),
-			broadcastToUser: (id, event, data) => self.broadcastToUser(id, event, data),
-			toUser: (id) => ({ send: (event, data) => self.broadcastToUser(id, event, data) })
+const WsAdapter = defineAdapter({
+	name: "WsAdapter",
+	defaults: {
+		path: "/ws",
+		heartbeatInterval: 3e4
+	},
+	build: (options) => {
+		const basePath = options.path;
+		const heartbeatInterval = options.heartbeatInterval;
+		const maxPayload = options.maxPayload;
+		const auth = options.auth;
+		const userRoomPrefix = options.auth?.userRoomPrefix ?? "user:";
+		let wss = null;
+		let container = null;
+		const namespaces = /* @__PURE__ */ new Map();
+		const roomManager = new RoomManager();
+		let heartbeatTimer = null;
+		const totalConnections = ref(0);
+		const activeConnections = ref(0);
+		const messagesReceived = ref(0);
+		const messagesSent = ref(0);
+		const wsErrors = ref(0);
+		const userRoom = (userId) => userRoomPrefix + userId;
+		const broadcastToUser = (userId, event, data) => {
+			roomManager.broadcast(userRoom(userId), event, data);
 		};
-	}
-	beforeStart({ container }) {
-		this.container = container;
-		container.registerInstance(WS_ADAPTER, this);
-		container.registerInstance(WS_ROOM_MANAGER, this.roomManager);
-		container.registerInstance(WS_USER_BROADCASTER, this.buildUserBroadcaster());
-		for (const controllerClass of wsControllerRegistry) {
-			const namespace = getClassMetaOrUndefined(WS_METADATA.WS_CONTROLLER, controllerClass);
-			if (namespace === void 0) continue;
-			const handlers = getClassMeta(WS_METADATA.WS_HANDLERS, controllerClass, []);
-			const fullPath = this.basePath + (namespace === "/" ? "" : namespace);
-			this.namespaces.set(fullPath, {
-				namespace,
-				controllerClass,
-				handlers,
-				sockets: /* @__PURE__ */ new Map(),
-				contexts: /* @__PURE__ */ new Map()
-			});
-			log.info(`Registered WS namespace: ${fullPath} (${controllerClass.name})`);
-		}
-	}
-	afterStart({ server }) {
-		if (!server) return;
-		this.wss = new WebSocketServer({
-			noServer: true,
-			maxPayload: this.maxPayload
-		});
-		server.on("upgrade", (request, socket, head) => {
-			const pathname = (request.url || "/").split("?")[0];
-			const entry = this.namespaces.get(pathname);
-			if (!entry) {
-				socket.write("HTTP/1.1 404 Not Found\r\n\r\n");
-				socket.destroy();
-				return;
-			}
-			this.wss.handleUpgrade(request, socket, head, (ws) => {
-				this.handleConnection(ws, entry, request);
-			});
+		const buildUserBroadcaster = () => ({
+			roomFor: (id) => userRoom(id),
+			broadcastToUser: (id, event, data) => broadcastToUser(id, event, data),
+			toUser: (id) => ({ send: (event, data) => broadcastToUser(id, event, data) })
 		});
-		if (this.heartbeatInterval > 0) this.heartbeatTimer = setInterval(() => {
-			for (const [, entry] of this.namespaces) for (const [, socket] of entry.sockets) {
-				if (socket.__alive === false) {
-					socket.terminate();
-					continue;
-				}
-				socket.__alive = false;
-				socket.ping();
+		const getStats = () => {
+			const namespaceStats = {};
+			for (const [path, entry] of namespaces) namespaceStats[path] = {
+				connections: entry.sockets.size,
+				handlers: entry.handlers.length
+			};
+			return {
+				totalConnections: totalConnections.value,
+				activeConnections: activeConnections.value,
+				messagesReceived: messagesReceived.value,
+				messagesSent: messagesSent.value,
+				errors: wsErrors.value,
+				namespaces: namespaceStats,
+				rooms: roomManager.getAllRooms()
+			};
+		};
+		const safeInvoke = (controller, method, ctx) => {
+			try {
+				const result = controller[method](ctx);
+				if (result instanceof Promise) result.catch((err) => {
+					log.error({ err }, `WS handler error in ${method}`);
+				});
+			} catch (err) {
+				log.error({ err }, `WS handler error in ${method}`);
 			}
-		}, this.heartbeatInterval);
-		const totalHandlers = Array.from(this.namespaces.values()).reduce((sum, e) => sum + e.handlers.length, 0);
-		log.info(`WebSocket ready — ${this.namespaces.size} namespace(s), ${totalHandlers} handler(s)`);
-	}
-	shutdown() {
-		if (this.heartbeatTimer) clearInterval(this.heartbeatTimer);
-		for (const [, entry] of this.namespaces) {
-			for (const [, socket] of entry.sockets) socket.close(1001, "Server shutting down");
-			entry.sockets.clear();
-			entry.contexts.clear();
-		}
-		this.wss?.close();
-	}
-	handleConnection(ws, entry, request) {
-		const socketId = randomUUID();
-		ws.__alive = true;
-		entry.sockets.set(socketId, ws);
-		this.totalConnections.value++;
-		this.activeConnections.value++;
-		const ctx = new WsContext(ws, this.wss, this.roomManager, entry.sockets, socketId, entry.namespace, request);
-		entry.contexts.set(socketId, ctx);
-		const controller = this.container.resolve(entry.controllerClass);
-		ws.on("pong", () => {
-			ws.__alive = true;
-		});
-		let authed = this.auth === void 0;
-		(this.auth ? this.authenticate(ctx) : Promise.resolve(true)).then((ok) => {
-			if (!ok) return;
-			authed = true;
-			this.invokeHandlers(controller, entry.handlers, "connect", ctx);
-		});
-		ws.on("message", (raw) => {
-			if (!authed) return;
-			this.messagesReceived.value++;
+		};
+		const invokeHandlers = (controller, handlers, type, ctx) => {
+			for (const handler of handlers) if (handler.type === type) safeInvoke(controller, handler.handlerName, ctx);
+		};
+		/**
+		* Runs the configured auth hook against the upgrade request. Stashes the
+		* resolved user on the context (as `user`, plus mirrored keys) and, when
+		* `autoJoinUserRoom` is enabled, joins the socket to `user:<id>`.
+		* Returns `false` (and closes the socket with code 4401) on failure.
+		*/
+		const authenticate = async (ctx) => {
+			if (!auth) return true;
 			try {
-				const parsed = JSON.parse(raw.toString());
-				const event = parsed.event;
-				const data = parsed.data;
-				if (!event || typeof event !== "string") {
-					ctx.send("error", { message: "Invalid message format: missing \"event\" field" });
-					return;
-				}
-				ctx.event = event;
-				ctx.data = data;
-				const handler = entry.handlers.find((h) => h.type === "message" && h.event === event);
-				if (handler) this.safeInvoke(controller, handler.handlerName, ctx);
-				else {
-					const catchAll = entry.handlers.find((h) => h.type === "message" && h.event === "*");
-					if (catchAll) this.safeInvoke(controller, catchAll.handlerName, ctx);
+				const user = await auth.resolveUser(ctx.request);
+				if (!user || !user.id) {
+					ctx.socket.close(4401, "Unauthorized");
+					return false;
 				}
-			} catch {
-				ctx.data = { message: "Invalid JSON" };
-				this.invokeHandlers(controller, entry.handlers, "error", ctx);
-			}
-		});
-		ws.on("close", () => {
-			this.activeConnections.value--;
-			this.invokeHandlers(controller, entry.handlers, "disconnect", ctx);
-			this.roomManager.leaveAll(socketId);
-			entry.sockets.delete(socketId);
-			entry.contexts.delete(socketId);
-		});
-		ws.on("error", (err) => {
-			this.wsErrors.value++;
-			ctx.data = {
-				message: err.message,
-				name: err.name
-			};
-			this.invokeHandlers(controller, entry.handlers, "error", ctx);
-		});
-	}
-	/**
-	* Runs the configured auth hook against the upgrade request. Stashes the
-	* resolved user on the context (as `user`, plus mirrored keys) and, when
-	* `autoJoinUserRoom` is enabled, joins the socket to `user:<id>`.
-	* Returns `false` (and closes the socket with code 4401) on failure.
-	*/
-	async authenticate(ctx) {
-		const cfg = this.auth;
-		if (!cfg) return true;
-		try {
-			const user = await cfg.resolveUser(ctx.request);
-			if (!user || !user.id) {
+				ctx.set("user", user);
+				ctx.set("userId", user.id);
+				if (auth.autoJoinUserRoom !== false) ctx.join(userRoom(user.id));
+				return true;
+			} catch (err) {
+				log.warn("WS auth failed", err);
 				ctx.socket.close(4401, "Unauthorized");
 				return false;
 			}
-			ctx.set("user", user);
-			ctx.set("userId", user.id);
-			if (cfg.autoJoinUserRoom !== false) ctx.join(this.userRoom(user.id));
-			return true;
-		} catch (err) {
-			log.warn("WS auth failed", err);
-			ctx.socket.close(4401, "Unauthorized");
-			return false;
-		}
-	}
-	invokeHandlers(controller, handlers, type, ctx) {
-		for (const handler of handlers) if (handler.type === type) this.safeInvoke(controller, handler.handlerName, ctx);
-	}
-	safeInvoke(controller, method, ctx) {
-		try {
-			const result = controller[method](ctx);
-			if (result instanceof Promise) result.catch((err) => {
-				log.error({ err }, `WS handler error in ${method}`);
+		};
+		const handleConnection = (ws, entry, request) => {
+			const socketId = randomUUID();
+			ws.__alive = true;
+			entry.sockets.set(socketId, ws);
+			totalConnections.value++;
+			activeConnections.value++;
+			const ctx = new WsContext(ws, wss, roomManager, entry.sockets, socketId, entry.namespace, request);
+			entry.contexts.set(socketId, ctx);
+			const controller = container.resolve(entry.controllerClass);
+			ws.on("pong", () => {
+				ws.__alive = true;
 			});
-		} catch (err) {
-			log.error({ err }, `WS handler error in ${method}`);
-		}
+			let authed = auth === void 0;
+			(auth ? authenticate(ctx) : Promise.resolve(true)).then((ok) => {
+				if (!ok) return;
+				authed = true;
+				invokeHandlers(controller, entry.handlers, "connect", ctx);
+			});
+			ws.on("message", (raw) => {
+				if (!authed) return;
+				messagesReceived.value++;
+				try {
+					const parsed = JSON.parse(raw.toString());
+					const event = parsed.event;
+					const data = parsed.data;
+					if (!event || typeof event !== "string") {
+						ctx.send("error", { message: "Invalid message format: missing \"event\" field" });
+						return;
+					}
+					ctx.event = event;
+					ctx.data = data;
+					const handler = entry.handlers.find((h) => h.type === "message" && h.event === event);
+					if (handler) safeInvoke(controller, handler.handlerName, ctx);
+					else {
+						const catchAll = entry.handlers.find((h) => h.type === "message" && h.event === "*");
+						if (catchAll) safeInvoke(controller, catchAll.handlerName, ctx);
+					}
+				} catch {
+					ctx.data = { message: "Invalid JSON" };
+					invokeHandlers(controller, entry.handlers, "error", ctx);
+				}
+			});
+			ws.on("close", () => {
+				activeConnections.value--;
+				invokeHandlers(controller, entry.handlers, "disconnect", ctx);
+				roomManager.leaveAll(socketId);
+				entry.sockets.delete(socketId);
+				entry.contexts.delete(socketId);
+			});
+			ws.on("error", (err) => {
+				wsErrors.value++;
+				ctx.data = {
+					message: err.message,
+					name: err.name
+				};
+				invokeHandlers(controller, entry.handlers, "error", ctx);
+			});
+		};
+		return {
+			getStats,
+			userRoom,
+			broadcastToUser,
+			totalConnections,
+			activeConnections,
+			messagesReceived,
+			messagesSent,
+			wsErrors,
+			beforeStart({ container: containerArg }) {
+				container = containerArg;
+				container.registerInstance(WS_ADAPTER, {
+					getStats,
+					userRoom,
+					broadcastToUser,
+					totalConnections,
+					activeConnections,
+					messagesReceived,
+					messagesSent,
+					wsErrors
+				});
+				container.registerInstance(WS_ROOM_MANAGER, roomManager);
+				container.registerInstance(WS_USER_BROADCASTER, buildUserBroadcaster());
+				for (const controllerClass of wsControllerRegistry) {
+					const namespace = getClassMetaOrUndefined(WS_METADATA.WS_CONTROLLER, controllerClass);
+					if (namespace === void 0) continue;
+					const handlers = getClassMeta(WS_METADATA.WS_HANDLERS, controllerClass, []);
+					const fullPath = basePath + (namespace === "/" ? "" : namespace);
+					namespaces.set(fullPath, {
+						namespace,
+						controllerClass,
+						handlers,
+						sockets: /* @__PURE__ */ new Map(),
+						contexts: /* @__PURE__ */ new Map()
+					});
+					log.info(`Registered WS namespace: ${fullPath} (${controllerClass.name})`);
+				}
+			},
+			afterStart({ server }) {
+				if (!server) return;
+				wss = new WebSocketServer({
+					noServer: true,
+					maxPayload
+				});
+				server.on("upgrade", (request, socket, head) => {
+					const pathname = (request.url || "/").split("?")[0];
+					const entry = namespaces.get(pathname);
+					if (!entry) {
+						socket.write("HTTP/1.1 404 Not Found\r\n\r\n");
+						socket.destroy();
+						return;
+					}
+					wss.handleUpgrade(request, socket, head, (ws) => {
+						handleConnection(ws, entry, request);
+					});
+				});
+				if (heartbeatInterval > 0) heartbeatTimer = setInterval(() => {
+					for (const [, entry] of namespaces) for (const [, socket] of entry.sockets) {
+						if (socket.__alive === false) {
+							socket.terminate();
+							continue;
+						}
+						socket.__alive = false;
+						socket.ping();
+					}
+				}, heartbeatInterval);
+				const totalHandlers = Array.from(namespaces.values()).reduce((sum, e) => sum + e.handlers.length, 0);
+				log.info(`WebSocket ready — ${namespaces.size} namespace(s), ${totalHandlers} handler(s)`);
+			},
+			shutdown() {
+				if (heartbeatTimer) clearInterval(heartbeatTimer);
+				for (const [, entry] of namespaces) {
+					for (const [, socket] of entry.sockets) socket.close(1001, "Server shutting down");
+					entry.sockets.clear();
+					entry.contexts.clear();
+				}
+				wss?.close();
+			}
+		};
 	}
-};
+});
 //#endregion
 //#region src/decorators.ts
 /**

package/dist/index.mjs.map

@@ -1 +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":["import type { IncomingMessage } from 'node:http'\nimport { createToken } from '@forinda/kickjs'\nimport type { RoomManager } from './room-manager'\n\ntype 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\n/**\n * Resolved principal returned from {@link WsAuthConfig.resolveUser}. Only `id`\n * is required — everything else is free-form metadata stashed on the\n * `WsContext` under `user:<field>` keys for handler access.\n */\nexport interface WsAuthenticatedUser {\n  id: string\n  [key: string]: unknown\n}\n\nexport interface WsAuthConfig {\n  /**\n   * Resolve a user from the upgrade request. Called once per socket during\n   * handshake, before any `@OnConnect` handler fires. Return `null` or throw\n   * to reject the socket with HTTP 401.\n   */\n  resolveUser: (\n    request: IncomingMessage,\n  ) => Promise<WsAuthenticatedUser | null> | WsAuthenticatedUser | null\n  /**\n   * When true, each authenticated socket auto-joins `user:<id>` immediately\n   * after `resolveUser` resolves. Pairs with {@link WsUserBroadcaster}.\n   */\n  autoJoinUserRoom?: boolean\n  /**\n   * Room name prefix for per-user broadcasting (default: `'user:'`).\n   * Must match what `@forinda/kickjs-ws`'s `WsUserBroadcaster` targets.\n   */\n  userRoomPrefix?: 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  /** Optional authenticated-handshake configuration. */\n  auth?: WsAuthConfig\n}\n\n/**\n * Per-user broadcasting across all WS namespaces. Registered on the DI\n * container when {@link WsAdapterOptions.auth} is configured, but the\n * underlying room (`user:<id>`) can also be joined manually by any\n * controller — the helper works either way.\n */\nexport interface WsUserBroadcaster {\n  /** Send a single event to every socket bound to this user. */\n  toUser(userId: string): { send(event: string, data: unknown): void }\n  /** Convenience — `toUser(id).send(event, data)` in one call. */\n  broadcastToUser(userId: string, event: string, data: unknown): void\n  /** Room name for a given user (respects `userRoomPrefix`). */\n  roomFor(userId: string): string\n}\n\n/** DI token for the live {@link WsAdapter} instance. */\nexport const WS_ADAPTER = createToken<unknown>('WsAdapter')\n/** DI token for the shared {@link RoomManager}. */\nexport const WS_ROOM_MANAGER = createToken<RoomManager>('WsRoomManager')\n/** DI token for the per-user broadcaster helper. */\nexport const WS_USER_BROADCASTER = createToken<WsUserBroadcaster>('WsUserBroadcaster')\n\n/** Registry of all @WsController classes — populated at decorator time */\nexport const wsControllerRegistry = new Set<Constructor>()\n","import type { IncomingMessage } from 'node:http'\nimport 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  /** The HTTP upgrade request — available from @OnConnect onward. Use to read\n   * cookies, headers, query string, and client IP for authenticated handshakes. */\n  readonly request: IncomingMessage\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    request: IncomingMessage,\n  ) {\n    this.id = id\n    this.namespace = namespace\n    this.request = request\n    this.data = null\n    this.event = ''\n  }\n\n  /** Parsed cookies from the upgrade request (raw `Cookie` header parse). */\n  get cookies(): Record<string, string> {\n    const header = this.request.headers.cookie\n    if (!header) return {}\n    const out: Record<string, string> = {}\n    for (const part of header.split(';')) {\n      const idx = part.indexOf('=')\n      if (idx === -1) continue\n      const k = part.slice(0, idx).trim()\n      const v = part.slice(idx + 1).trim()\n      if (k) out[k] = decodeURIComponent(v)\n    }\n    return out\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_ADAPTER,\n  WS_METADATA,\n  WS_ROOM_MANAGER,\n  WS_USER_BROADCASTER,\n  wsControllerRegistry,\n  type WsAdapterOptions,\n  type WsAuthConfig,\n  type WsHandlerDefinition,\n  type WsUserBroadcaster,\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 auth?: WsAuthConfig\n  private userRoomPrefix: string\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    this.auth = options.auth\n    this.userRoomPrefix = options.auth?.userRoomPrefix ?? 'user:'\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  /** Room name used for per-user broadcasting. */\n  userRoom(userId: string): string {\n    return this.userRoomPrefix + userId\n  }\n\n  /** Broadcast a single event to every socket in `user:<id>` (across namespaces). */\n  broadcastToUser(userId: string, event: string, data: unknown): void {\n    this.roomManager.broadcast(this.userRoom(userId), event, data)\n  }\n\n  private buildUserBroadcaster(): WsUserBroadcaster {\n    const self = this\n    return {\n      roomFor: (id) => self.userRoom(id),\n      broadcastToUser: (id, event, data) => self.broadcastToUser(id, event, data),\n      toUser: (id) => ({\n        send: (event, data) => self.broadcastToUser(id, event, data),\n      }),\n    }\n  }\n\n  beforeStart({ container }: AdapterContext): void {\n    this.container = container\n\n    container.registerInstance(WS_ADAPTER, this)\n    container.registerInstance(WS_ROOM_MANAGER, this.roomManager)\n    container.registerInstance(WS_USER_BROADCASTER, this.buildUserBroadcaster())\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, request)\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, request: IncomingMessage): 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      request,\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    // Authenticated handshake (optional). Messages received before auth\n    // resolves are buffered on the socket; we gate dispatch on `authed`.\n    let authed = this.auth === undefined\n    const authPromise = this.auth ? this.authenticate(ctx) : Promise.resolve(true)\n\n    authPromise.then((ok) => {\n      if (!ok) return\n      authed = true\n      // @OnConnect handlers\n      this.invokeHandlers(controller, entry.handlers, 'connect', ctx)\n    })\n\n    // Message handler\n    ws.on('message', (raw: Buffer | string) => {\n      if (!authed) return\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  /**\n   * Runs the configured auth hook against the upgrade request. Stashes the\n   * resolved user on the context (as `user`, plus mirrored keys) and, when\n   * `autoJoinUserRoom` is enabled, joins the socket to `user:<id>`.\n   * Returns `false` (and closes the socket with code 4401) on failure.\n   */\n  private async authenticate(ctx: WsContext): Promise<boolean> {\n    const cfg = this.auth\n    if (!cfg) return true\n    try {\n      const user = await cfg.resolveUser(ctx.request)\n      if (!user || !user.id) {\n        ctx.socket.close(4401, 'Unauthorized')\n        return false\n      }\n      ctx.set('user', user)\n      ctx.set('userId', user.id)\n      if (cfg.autoJoinUserRoom !== false) {\n        ctx.join(this.userRoom(user.id))\n      }\n      return true\n    } catch (err) {\n      log.warn('WS auth failed', err)\n      ctx.socket.close(4401, 'Unauthorized')\n      return false\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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"}
+{"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":["import type { IncomingMessage } from 'node:http'\nimport { createToken } from '@forinda/kickjs'\nimport type { RoomManager } from './room-manager'\n\ntype 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\n/**\n * Resolved principal returned from {@link WsAuthConfig.resolveUser}. Only `id`\n * is required — everything else is free-form metadata stashed on the\n * `WsContext` under `user:<field>` keys for handler access.\n */\nexport interface WsAuthenticatedUser {\n  id: string\n  [key: string]: unknown\n}\n\nexport interface WsAuthConfig {\n  /**\n   * Resolve a user from the upgrade request. Called once per socket during\n   * handshake, before any `@OnConnect` handler fires. Return `null` or throw\n   * to reject the socket with HTTP 401.\n   */\n  resolveUser: (\n    request: IncomingMessage,\n  ) => Promise<WsAuthenticatedUser | null> | WsAuthenticatedUser | null\n  /**\n   * When true, each authenticated socket auto-joins `user:<id>` immediately\n   * after `resolveUser` resolves. Pairs with {@link WsUserBroadcaster}.\n   */\n  autoJoinUserRoom?: boolean\n  /**\n   * Room name prefix for per-user broadcasting (default: `'user:'`).\n   * Must match what `@forinda/kickjs-ws`'s `WsUserBroadcaster` targets.\n   */\n  userRoomPrefix?: 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  /** Optional authenticated-handshake configuration. */\n  auth?: WsAuthConfig\n}\n\n/**\n * Per-user broadcasting across all WS namespaces. Registered on the DI\n * container when {@link WsAdapterOptions.auth} is configured, but the\n * underlying room (`user:<id>`) can also be joined manually by any\n * controller — the helper works either way.\n */\nexport interface WsUserBroadcaster {\n  /** Send a single event to every socket bound to this user. */\n  toUser(userId: string): { send(event: string, data: unknown): void }\n  /** Convenience — `toUser(id).send(event, data)` in one call. */\n  broadcastToUser(userId: string, event: string, data: unknown): void\n  /** Room name for a given user (respects `userRoomPrefix`). */\n  roomFor(userId: string): string\n}\n\n/** DI token for the live {@link WsAdapter} instance. */\nexport const WS_ADAPTER = createToken<unknown>('WsAdapter')\n/** DI token for the shared {@link RoomManager}. */\nexport const WS_ROOM_MANAGER = createToken<RoomManager>('WsRoomManager')\n/** DI token for the per-user broadcaster helper. */\nexport const WS_USER_BROADCASTER = createToken<WsUserBroadcaster>('WsUserBroadcaster')\n\n/** Registry of all @WsController classes — populated at decorator time */\nexport const wsControllerRegistry = new Set<Constructor>()\n","import type { IncomingMessage } from 'node:http'\nimport 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  /** The HTTP upgrade request — available from @OnConnect onward. Use to read\n   * cookies, headers, query string, and client IP for authenticated handshakes. */\n  readonly request: IncomingMessage\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    request: IncomingMessage,\n  ) {\n    this.id = id\n    this.namespace = namespace\n    this.request = request\n    this.data = null\n    this.event = ''\n  }\n\n  /** Parsed cookies from the upgrade request (raw `Cookie` header parse). */\n  get cookies(): Record<string, string> {\n    const header = this.request.headers.cookie\n    if (!header) return {}\n    const out: Record<string, string> = {}\n    for (const part of header.split(';')) {\n      const idx = part.indexOf('=')\n      if (idx === -1) continue\n      const k = part.slice(0, idx).trim()\n      const v = part.slice(idx + 1).trim()\n      if (k) out[k] = decodeURIComponent(v)\n    }\n    return out\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  defineAdapter,\n  type Container,\n  createLogger,\n  ref,\n  type Ref,\n  getClassMetaOrUndefined,\n  getClassMeta,\n} from '@forinda/kickjs'\nimport {\n  WS_ADAPTER,\n  WS_METADATA,\n  WS_ROOM_MANAGER,\n  WS_USER_BROADCASTER,\n  wsControllerRegistry,\n  type WsAdapterOptions,\n  type WsHandlerDefinition,\n  type WsUserBroadcaster,\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 * Public extension methods exposed by a WsAdapter instance — broadcast\n * helpers, namespace stats, and reactive counters that DevTools and\n * other adapters consume directly.\n */\nexport interface WsAdapterExtensions {\n  /** Snapshot of WebSocket stats — consumed by DevTools / Swagger ws-server discovery. */\n  getStats(): {\n    totalConnections: number\n    activeConnections: number\n    messagesReceived: number\n    messagesSent: number\n    errors: number\n    namespaces: Record<string, { connections: number; handlers: number }>\n    rooms: ReturnType<RoomManager['getAllRooms']>\n  }\n  /** Room name used for per-user broadcasting. */\n  userRoom(userId: string): string\n  /** Broadcast a single event to every socket in `user:<id>` (across namespaces). */\n  broadcastToUser(userId: string, event: string, data: unknown): void\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\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 *     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 const WsAdapter = defineAdapter<WsAdapterOptions, WsAdapterExtensions>({\n  name: 'WsAdapter',\n  defaults: {\n    path: '/ws',\n    heartbeatInterval: 30000,\n  },\n  build: (options) => {\n    const basePath = options.path!\n    const heartbeatInterval = options.heartbeatInterval!\n    const maxPayload = options.maxPayload\n    const auth = options.auth\n    const userRoomPrefix = options.auth?.userRoomPrefix ?? 'user:'\n\n    let wss: WebSocketServer | null = null\n    let container: Container | null = null\n    const namespaces = new Map<string, NamespaceEntry>()\n    const roomManager = new RoomManager()\n    let heartbeatTimer: ReturnType<typeof setInterval> | null = null\n\n    const totalConnections = ref(0)\n    const activeConnections = ref(0)\n    const messagesReceived = ref(0)\n    const messagesSent = ref(0)\n    const wsErrors = ref(0)\n\n    const userRoom = (userId: string): string => userRoomPrefix + userId\n\n    const broadcastToUser = (userId: string, event: string, data: unknown): void => {\n      roomManager.broadcast(userRoom(userId), event, data)\n    }\n\n    const buildUserBroadcaster = (): WsUserBroadcaster => ({\n      roomFor: (id) => userRoom(id),\n      broadcastToUser: (id, event, data) => broadcastToUser(id, event, data),\n      toUser: (id) => ({\n        send: (event, data) => broadcastToUser(id, event, data),\n      }),\n    })\n\n    const getStats = () => {\n      const namespaceStats: Record<string, { connections: number; handlers: number }> = {}\n      for (const [path, entry] of namespaces) {\n        namespaceStats[path] = {\n          connections: entry.sockets.size,\n          handlers: entry.handlers.length,\n        }\n      }\n      return {\n        totalConnections: totalConnections.value,\n        activeConnections: activeConnections.value,\n        messagesReceived: messagesReceived.value,\n        messagesSent: messagesSent.value,\n        errors: wsErrors.value,\n        namespaces: namespaceStats,\n        rooms: roomManager.getAllRooms(),\n      }\n    }\n\n    const 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    const 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          safeInvoke(controller, handler.handlerName, ctx)\n        }\n      }\n    }\n\n    /**\n     * Runs the configured auth hook against the upgrade request. Stashes the\n     * resolved user on the context (as `user`, plus mirrored keys) and, when\n     * `autoJoinUserRoom` is enabled, joins the socket to `user:<id>`.\n     * Returns `false` (and closes the socket with code 4401) on failure.\n     */\n    const authenticate = async (ctx: WsContext): Promise<boolean> => {\n      if (!auth) return true\n      try {\n        const user = await auth.resolveUser(ctx.request)\n        if (!user || !user.id) {\n          ctx.socket.close(4401, 'Unauthorized')\n          return false\n        }\n        ctx.set('user', user)\n        ctx.set('userId', user.id)\n        if (auth.autoJoinUserRoom !== false) {\n          ctx.join(userRoom(user.id))\n        }\n        return true\n      } catch (err) {\n        log.warn('WS auth failed', err)\n        ctx.socket.close(4401, 'Unauthorized')\n        return false\n      }\n    }\n\n    const handleConnection = (\n      ws: WebSocket,\n      entry: NamespaceEntry,\n      request: IncomingMessage,\n    ): void => {\n      const socketId = randomUUID()\n      ;(ws as any).__alive = true\n\n      entry.sockets.set(socketId, ws)\n      totalConnections.value++\n      activeConnections.value++\n\n      const ctx = new WsContext(\n        ws,\n        wss!,\n        roomManager,\n        entry.sockets,\n        socketId,\n        entry.namespace,\n        request,\n      )\n      entry.contexts.set(socketId, ctx)\n\n      const controller = container!.resolve(entry.controllerClass)\n\n      ws.on('pong', () => {\n        ;(ws as any).__alive = true\n      })\n\n      // Authenticated handshake (optional). Messages received before auth\n      // resolves are buffered on the socket; we gate dispatch on `authed`.\n      let authed = auth === undefined\n      const authPromise = auth ? authenticate(ctx) : Promise.resolve(true)\n\n      authPromise.then((ok) => {\n        if (!ok) return\n        authed = true\n        invokeHandlers(controller, entry.handlers, 'connect', ctx)\n      })\n\n      ws.on('message', (raw: Buffer | string) => {\n        if (!authed) return\n        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          const handler = entry.handlers.find((h) => h.type === 'message' && h.event === event)\n\n          if (handler) {\n            safeInvoke(controller, handler.handlerName, ctx)\n          } else {\n            const catchAll = entry.handlers.find((h) => h.type === 'message' && h.event === '*')\n            if (catchAll) {\n              safeInvoke(controller, catchAll.handlerName, ctx)\n            }\n          }\n        } catch {\n          ctx.data = { message: 'Invalid JSON' }\n          invokeHandlers(controller, entry.handlers, 'error', ctx)\n        }\n      })\n\n      ws.on('close', () => {\n        activeConnections.value--\n        invokeHandlers(controller, entry.handlers, 'disconnect', ctx)\n        roomManager.leaveAll(socketId)\n        entry.sockets.delete(socketId)\n        entry.contexts.delete(socketId)\n      })\n\n      ws.on('error', (err: Error) => {\n        wsErrors.value++\n        ctx.data = { message: err.message, name: err.name }\n        invokeHandlers(controller, entry.handlers, 'error', ctx)\n      })\n    }\n\n    return {\n      getStats,\n      userRoom,\n      broadcastToUser,\n      totalConnections,\n      activeConnections,\n      messagesReceived,\n      messagesSent,\n      wsErrors,\n\n      beforeStart({ container: containerArg }) {\n        container = containerArg\n\n        // The factory's mutate-name pattern means `this` inside lifecycle\n        // hooks does not reach the returned adapter object; pass the\n        // adapter itself via WS_ADAPTER for code that wants the full\n        // surface (broadcast helpers, stats, refs).\n        // We don't have a `this` reference for the WS_ADAPTER token, so\n        // we rebuild the externally-visible surface inline here.\n        container.registerInstance(WS_ADAPTER, {\n          getStats,\n          userRoom,\n          broadcastToUser,\n          totalConnections,\n          activeConnections,\n          messagesReceived,\n          messagesSent,\n          wsErrors,\n        })\n        container.registerInstance(WS_ROOM_MANAGER, roomManager)\n        container.registerInstance(WS_USER_BROADCASTER, buildUserBroadcaster())\n\n        // Discover all @WsController classes and build routing table\n        for (const controllerClass of wsControllerRegistry) {\n          const namespace = getClassMetaOrUndefined<string>(\n            WS_METADATA.WS_CONTROLLER,\n            controllerClass,\n          )\n          if (namespace === undefined) continue\n\n          const handlers = getClassMeta<WsHandlerDefinition[]>(\n            WS_METADATA.WS_HANDLERS,\n            controllerClass,\n            [],\n          )\n\n          const fullPath = basePath + (namespace === '/' ? '' : namespace)\n\n          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 }) {\n        if (!server) return\n\n        wss = new WebSocketServer({\n          noServer: true,\n          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 = 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          wss!.handleUpgrade(request, socket, head, (ws) => {\n            handleConnection(ws, entry, request)\n          })\n        })\n\n        // Heartbeat ping/pong\n        if (heartbeatInterval > 0) {\n          heartbeatTimer = setInterval(() => {\n            for (const [, entry] of 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          }, heartbeatInterval)\n        }\n\n        const totalHandlers = Array.from(namespaces.values()).reduce(\n          (sum, e) => sum + e.handlers.length,\n          0,\n        )\n        log.info(`WebSocket ready — ${namespaces.size} namespace(s), ${totalHandlers} handler(s)`)\n      },\n\n      shutdown() {\n        if (heartbeatTimer) {\n          clearInterval(heartbeatTimer)\n        }\n\n        // Close all connections\n        for (const [, entry] of 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        wss?.close()\n      },\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": "3.2.0",
+  "version": "4.0.0",
   "description": "WebSocket support with decorators, namespaces, rooms, and DI integration for KickJS",
   "keywords": [
     "kickjs",
@@ -22,13 +22,10 @@
     "@forinda/kickjs",
     "@forinda/kickjs-auth",
     "@forinda/kickjs-cli",
-    "@forinda/kickjs-config",
-    "@forinda/kickjs-core",
     "@forinda/kickjs-cron",
     "@forinda/kickjs-devtools",
     "@forinda/kickjs-drizzle",
     "@forinda/kickjs-graphql",
-    "@forinda/kickjs-http",
     "@forinda/kickjs-mailer",
     "@forinda/kickjs-multi-tenant",
     "@forinda/kickjs-notifications",
@@ -64,9 +61,7 @@
       "output": [
         "dist/**"
       ],
-      "dependencies": [
-        "../core:build"
-      ]
+      "dependencies": []
     }
   },
   "dependencies": {
@@ -74,12 +69,12 @@
     "ws": "^8.20.0"
   },
   "devDependencies": {
-    "@swc/core": "^1.15.21",
-    "@types/node": "^25.0.0",
+    "@swc/core": "^1.15.30",
+    "@types/node": "^25.6.0",
     "@types/ws": "^8.18.0",
-    "typescript": "^5.9.2",
-    "vitest": "^4.1.2",
-    "@forinda/kickjs": "3.2.0"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5",
+    "@forinda/kickjs": "4.0.0"
   },
   "publishConfig": {
     "access": "public"