@hazeljs/websocket 0.2.0-beta.1

package/dist/decorators/realtime.decorator.js

@@ -0,0 +1,202 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Realtime = Realtime;
+exports.getRealtimeMetadata = getRealtimeMetadata;
+exports.isRealtimeGateway = isRealtimeGateway;
+exports.Subscribe = Subscribe;
+exports.getSubscribeMetadata = getSubscribeMetadata;
+exports.OnConnect = OnConnect;
+exports.getOnConnectMetadata = getOnConnectMetadata;
+exports.OnDisconnect = OnDisconnect;
+exports.getOnDisconnectMetadata = getOnDisconnectMetadata;
+exports.OnMessage = OnMessage;
+exports.getOnMessageMetadata = getOnMessageMetadata;
+exports.Client = Client;
+exports.Data = Data;
+exports.getParameterMetadata = getParameterMetadata;
+require("reflect-metadata");
+const core_1 = __importDefault(require("@hazeljs/core"));
+const REALTIME_METADATA_KEY = 'hazel:realtime';
+const SUBSCRIBE_METADATA_KEY = 'hazel:subscribe';
+const ON_CONNECT_METADATA_KEY = 'hazel:onconnect';
+const ON_DISCONNECT_METADATA_KEY = 'hazel:ondisconnect';
+const ON_MESSAGE_METADATA_KEY = 'hazel:onmessage';
+/**
+ * Realtime decorator for WebSocket gateways
+ *
+ * @example
+ * ```typescript
+ * @Realtime('/notifications')
+ * export class NotificationGateway {
+ *   // Gateway methods
+ * }
+ * ```
+ */
+function Realtime(pathOrOptions) {
+    return (target) => {
+        const options = typeof pathOrOptions === 'string' ? { path: pathOrOptions } : pathOrOptions || {};
+        const defaults = {
+            path: '/',
+            namespace: '/',
+            auth: false,
+            pingInterval: 25000,
+            pingTimeout: 5000,
+            maxPayload: 1048576, // 1MB
+            ...options,
+        };
+        const targetName = typeof target === 'function' ? target.name : 'unknown';
+        core_1.default.debug(`Marking ${targetName} as realtime gateway with path: ${defaults.path}`);
+        Reflect.defineMetadata(REALTIME_METADATA_KEY, defaults, target);
+    };
+}
+/**
+ * Get realtime metadata from a class
+ */
+function getRealtimeMetadata(target) {
+    return Reflect.getMetadata(REALTIME_METADATA_KEY, target);
+}
+/**
+ * Check if a class is a realtime gateway
+ */
+function isRealtimeGateway(target) {
+    return Reflect.hasMetadata(REALTIME_METADATA_KEY, target);
+}
+/**
+ * Subscribe decorator for event handlers
+ *
+ * @example
+ * ```typescript
+ * @Subscribe('user-{userId}')
+ * onUserEvent(@Param('userId') userId: string, @Data() data: any) {
+ *   // Handle event
+ * }
+ * ```
+ */
+function Subscribe(event) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(SUBSCRIBE_METADATA_KEY, event, target, propertyKey);
+        core_1.default.debug(`Subscribe decorator applied to ${target.constructor.name}.${String(propertyKey)} for event: ${event}`);
+        return descriptor;
+    };
+}
+/**
+ * Get subscribe metadata from a method
+ */
+function getSubscribeMetadata(target, propertyKey) {
+    return Reflect.getMetadata(SUBSCRIBE_METADATA_KEY, target, propertyKey);
+}
+/**
+ * OnConnect decorator for connection handlers
+ *
+ * @example
+ * ```typescript
+ * @OnConnect()
+ * handleConnection(@Client() client: WebSocketClient) {
+ *   console.log('Client connected:', client.id);
+ * }
+ * ```
+ */
+function OnConnect() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(ON_CONNECT_METADATA_KEY, true, target, propertyKey);
+        core_1.default.debug(`OnConnect decorator applied to ${target.constructor.name}.${String(propertyKey)}`);
+        return descriptor;
+    };
+}
+/**
+ * Get OnConnect metadata
+ */
+function getOnConnectMetadata(target, propertyKey) {
+    return Reflect.getMetadata(ON_CONNECT_METADATA_KEY, target, propertyKey) || false;
+}
+/**
+ * OnDisconnect decorator for disconnection handlers
+ *
+ * @example
+ * ```typescript
+ * @OnDisconnect()
+ * handleDisconnect(@Client() client: WebSocketClient) {
+ *   console.log('Client disconnected:', client.id);
+ * }
+ * ```
+ */
+function OnDisconnect() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(ON_DISCONNECT_METADATA_KEY, true, target, propertyKey);
+        core_1.default.debug(`OnDisconnect decorator applied to ${target.constructor.name}.${String(propertyKey)}`);
+        return descriptor;
+    };
+}
+/**
+ * Get OnDisconnect metadata
+ */
+function getOnDisconnectMetadata(target, propertyKey) {
+    return Reflect.getMetadata(ON_DISCONNECT_METADATA_KEY, target, propertyKey) || false;
+}
+/**
+ * OnMessage decorator for message handlers
+ *
+ * @example
+ * ```typescript
+ * @OnMessage('chat')
+ * handleMessage(@Client() client: WebSocketClient, @Data() data: any) {
+ *   // Handle message
+ * }
+ * ```
+ */
+function OnMessage(event) {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(ON_MESSAGE_METADATA_KEY, event, target, propertyKey);
+        core_1.default.debug(`OnMessage decorator applied to ${target.constructor.name}.${String(propertyKey)} for event: ${event}`);
+        return descriptor;
+    };
+}
+/**
+ * Get OnMessage metadata
+ */
+function getOnMessageMetadata(target, propertyKey) {
+    return Reflect.getMetadata(ON_MESSAGE_METADATA_KEY, target, propertyKey);
+}
+/**
+ * Client parameter decorator
+ *
+ * @example
+ * ```typescript
+ * handleConnection(@Client() client: WebSocketClient) {
+ *   // client is injected
+ * }
+ * ```
+ */
+function Client() {
+    return (target, propertyKey, parameterIndex) => {
+        const existingParams = Reflect.getMetadata('hazel:ws:params', target, propertyKey) || [];
+        existingParams[parameterIndex] = 'client';
+        Reflect.defineMetadata('hazel:ws:params', existingParams, target, propertyKey);
+    };
+}
+/**
+ * Data parameter decorator
+ *
+ * @example
+ * ```typescript
+ * handleMessage(@Data() data: any) {
+ *   // data is injected
+ * }
+ * ```
+ */
+function Data() {
+    return (target, propertyKey, parameterIndex) => {
+        const existingParams = Reflect.getMetadata('hazel:ws:params', target, propertyKey) || [];
+        existingParams[parameterIndex] = 'data';
+        Reflect.defineMetadata('hazel:ws:params', existingParams, target, propertyKey);
+    };
+}
+/**
+ * Get parameter metadata
+ */
+function getParameterMetadata(target, propertyKey) {
+    return Reflect.getMetadata('hazel:ws:params', target, propertyKey) || [];
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @hazeljs/websocket - WebSocket and SSE module for HazelJS
+ */
+export { WebSocketModule, type WebSocketModuleOptions } from './websocket.module';
+export { WebSocketGateway, createWebSocketClient } from './websocket.gateway';
+export { Realtime, Subscribe, OnConnect, OnDisconnect, OnMessage, Client, Data, getRealtimeMetadata, isRealtimeGateway, getSubscribeMetadata, getOnConnectMetadata, getOnDisconnectMetadata, getOnMessageMetadata, getParameterMetadata, } from './decorators/realtime.decorator';
+export { SSEHandler, createSSEResponse, sendSSEMessage } from './sse/sse.handler';
+export { RoomManager } from './room/room.manager';
+export { type WebSocketClient, type WebSocketMessage, type WebSocketGatewayOptions, type Room, type WebSocketEventHandler, type ConnectionHandler, type DisconnectionHandler, type WebSocketServerOptions, type SSEOptions, type SSEMessage, type SubscriptionOptions, type WebSocketStats, } from './websocket.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,QAAQ,EACR,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,MAAM,EACN,IAAI,EACJ,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,IAAI,EACT,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * @hazeljs/websocket - WebSocket and SSE module for HazelJS
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoomManager = exports.sendSSEMessage = exports.createSSEResponse = exports.SSEHandler = exports.getParameterMetadata = exports.getOnMessageMetadata = exports.getOnDisconnectMetadata = exports.getOnConnectMetadata = exports.getSubscribeMetadata = exports.isRealtimeGateway = exports.getRealtimeMetadata = exports.Data = exports.Client = exports.OnMessage = exports.OnDisconnect = exports.OnConnect = exports.Subscribe = exports.Realtime = exports.createWebSocketClient = exports.WebSocketGateway = exports.WebSocketModule = void 0;
+var websocket_module_1 = require("./websocket.module");
+Object.defineProperty(exports, "WebSocketModule", { enumerable: true, get: function () { return websocket_module_1.WebSocketModule; } });
+var websocket_gateway_1 = require("./websocket.gateway");
+Object.defineProperty(exports, "WebSocketGateway", { enumerable: true, get: function () { return websocket_gateway_1.WebSocketGateway; } });
+Object.defineProperty(exports, "createWebSocketClient", { enumerable: true, get: function () { return websocket_gateway_1.createWebSocketClient; } });
+var realtime_decorator_1 = require("./decorators/realtime.decorator");
+Object.defineProperty(exports, "Realtime", { enumerable: true, get: function () { return realtime_decorator_1.Realtime; } });
+Object.defineProperty(exports, "Subscribe", { enumerable: true, get: function () { return realtime_decorator_1.Subscribe; } });
+Object.defineProperty(exports, "OnConnect", { enumerable: true, get: function () { return realtime_decorator_1.OnConnect; } });
+Object.defineProperty(exports, "OnDisconnect", { enumerable: true, get: function () { return realtime_decorator_1.OnDisconnect; } });
+Object.defineProperty(exports, "OnMessage", { enumerable: true, get: function () { return realtime_decorator_1.OnMessage; } });
+Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return realtime_decorator_1.Client; } });
+Object.defineProperty(exports, "Data", { enumerable: true, get: function () { return realtime_decorator_1.Data; } });
+Object.defineProperty(exports, "getRealtimeMetadata", { enumerable: true, get: function () { return realtime_decorator_1.getRealtimeMetadata; } });
+Object.defineProperty(exports, "isRealtimeGateway", { enumerable: true, get: function () { return realtime_decorator_1.isRealtimeGateway; } });
+Object.defineProperty(exports, "getSubscribeMetadata", { enumerable: true, get: function () { return realtime_decorator_1.getSubscribeMetadata; } });
+Object.defineProperty(exports, "getOnConnectMetadata", { enumerable: true, get: function () { return realtime_decorator_1.getOnConnectMetadata; } });
+Object.defineProperty(exports, "getOnDisconnectMetadata", { enumerable: true, get: function () { return realtime_decorator_1.getOnDisconnectMetadata; } });
+Object.defineProperty(exports, "getOnMessageMetadata", { enumerable: true, get: function () { return realtime_decorator_1.getOnMessageMetadata; } });
+Object.defineProperty(exports, "getParameterMetadata", { enumerable: true, get: function () { return realtime_decorator_1.getParameterMetadata; } });
+var sse_handler_1 = require("./sse/sse.handler");
+Object.defineProperty(exports, "SSEHandler", { enumerable: true, get: function () { return sse_handler_1.SSEHandler; } });
+Object.defineProperty(exports, "createSSEResponse", { enumerable: true, get: function () { return sse_handler_1.createSSEResponse; } });
+Object.defineProperty(exports, "sendSSEMessage", { enumerable: true, get: function () { return sse_handler_1.sendSSEMessage; } });
+var room_manager_1 = require("./room/room.manager");
+Object.defineProperty(exports, "RoomManager", { enumerable: true, get: function () { return room_manager_1.RoomManager; } });

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

@@ -0,0 +1,81 @@
+import { Room, WebSocketClient } from '../websocket.types';
+/**
+ * Room manager for WebSocket connections
+ */
+export declare class RoomManager {
+    private rooms;
+    private clientRooms;
+    /**
+     * Create a room
+     */
+    createRoom(name: string): Room;
+    /**
+     * Get a room
+     */
+    getRoom(name: string): Room | undefined;
+    /**
+     * Delete a room
+     */
+    deleteRoom(name: string): boolean;
+    /**
+     * Add client to room
+     */
+    addClientToRoom(clientId: string, roomName: string): void;
+    /**
+     * Remove client from room
+     */
+    removeClientFromRoom(clientId: string, roomName: string): void;
+    /**
+     * Remove client from all rooms
+     */
+    removeClientFromAllRooms(clientId: string): void;
+    /**
+     * Get all rooms a client is in
+     */
+    getClientRooms(clientId: string): string[];
+    /**
+     * Get all clients in a room
+     */
+    getRoomClients(roomName: string): string[];
+    /**
+     * Check if client is in room
+     */
+    isClientInRoom(clientId: string, roomName: string): boolean;
+    /**
+     * Get all rooms
+     */
+    getAllRooms(): Room[];
+    /**
+     * Get room count
+     */
+    getRoomCount(): number;
+    /**
+     * Get total client count across all rooms
+     */
+    getTotalClientCount(): number;
+    /**
+     * Broadcast to room
+     */
+    broadcastToRoom(roomName: string, event: string, data: unknown, clients: Map<string, WebSocketClient>, excludeClientId?: string): void;
+    /**
+     * Set room metadata
+     */
+    setRoomMetadata(roomName: string, key: string, value: unknown): void;
+    /**
+     * Get room metadata
+     */
+    getRoomMetadata(roomName: string, key: string): unknown;
+    /**
+     * Clear all rooms
+     */
+    clear(): void;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        totalRooms: number;
+        totalClients: number;
+        averageClientsPerRoom: number;
+    };
+}
+//# sourceMappingURL=room.manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"room.manager.d.ts","sourceRoot":"","sources":["../../src/room/room.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG3D;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,WAAW,CAAuC;IAE1D;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkB9B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAoBjC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAkBzD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAsB9D;;OAEG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAchD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAK1C;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAK1C;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK3D;;OAEG;IACH,WAAW,IAAI,IAAI,EAAE;IAIrB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAQ7B;;OAEG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EACrC,eAAe,CAAC,EAAE,MAAM,GACvB,IAAI;IAoBP;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAOpE;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAKvD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,qBAAqB,EAAE,MAAM,CAAC;KAC/B;CAWF"}

package/dist/room/room.manager.js

@@ -0,0 +1,209 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoomManager = void 0;
+const core_1 = __importDefault(require("@hazeljs/core"));
+/**
+ * Room manager for WebSocket connections
+ */
+class RoomManager {
+    constructor() {
+        this.rooms = new Map();
+        this.clientRooms = new Map();
+    }
+    /**
+     * Create a room
+     */
+    createRoom(name) {
+        if (this.rooms.has(name)) {
+            return this.rooms.get(name);
+        }
+        const room = {
+            name,
+            clients: new Set(),
+            metadata: new Map(),
+            createdAt: Date.now(),
+        };
+        this.rooms.set(name, room);
+        core_1.default.debug(`Room created: ${name}`);
+        return room;
+    }
+    /**
+     * Get a room
+     */
+    getRoom(name) {
+        return this.rooms.get(name);
+    }
+    /**
+     * Delete a room
+     */
+    deleteRoom(name) {
+        const room = this.rooms.get(name);
+        if (!room) {
+            return false;
+        }
+        // Remove room from all clients
+        for (const clientId of room.clients) {
+            const clientRooms = this.clientRooms.get(clientId);
+            if (clientRooms) {
+                clientRooms.delete(name);
+            }
+        }
+        this.rooms.delete(name);
+        core_1.default.debug(`Room deleted: ${name}`);
+        return true;
+    }
+    /**
+     * Add client to room
+     */
+    addClientToRoom(clientId, roomName) {
+        // Create room if it doesn't exist
+        if (!this.rooms.has(roomName)) {
+            this.createRoom(roomName);
+        }
+        const room = this.rooms.get(roomName);
+        room.clients.add(clientId);
+        // Track client's rooms
+        if (!this.clientRooms.has(clientId)) {
+            this.clientRooms.set(clientId, new Set());
+        }
+        this.clientRooms.get(clientId).add(roomName);
+        core_1.default.debug(`Client ${clientId} joined room ${roomName}`);
+    }
+    /**
+     * Remove client from room
+     */
+    removeClientFromRoom(clientId, roomName) {
+        const room = this.rooms.get(roomName);
+        if (!room) {
+            return;
+        }
+        room.clients.delete(clientId);
+        // Remove from client's rooms
+        const clientRooms = this.clientRooms.get(clientId);
+        if (clientRooms) {
+            clientRooms.delete(roomName);
+        }
+        // Delete room if empty
+        if (room.clients.size === 0) {
+            this.deleteRoom(roomName);
+        }
+        core_1.default.debug(`Client ${clientId} left room ${roomName}`);
+    }
+    /**
+     * Remove client from all rooms
+     */
+    removeClientFromAllRooms(clientId) {
+        const clientRooms = this.clientRooms.get(clientId);
+        if (!clientRooms) {
+            return;
+        }
+        for (const roomName of clientRooms) {
+            this.removeClientFromRoom(clientId, roomName);
+        }
+        this.clientRooms.delete(clientId);
+        core_1.default.debug(`Client ${clientId} removed from all rooms`);
+    }
+    /**
+     * Get all rooms a client is in
+     */
+    getClientRooms(clientId) {
+        const rooms = this.clientRooms.get(clientId);
+        return rooms ? Array.from(rooms) : [];
+    }
+    /**
+     * Get all clients in a room
+     */
+    getRoomClients(roomName) {
+        const room = this.rooms.get(roomName);
+        return room ? Array.from(room.clients) : [];
+    }
+    /**
+     * Check if client is in room
+     */
+    isClientInRoom(clientId, roomName) {
+        const room = this.rooms.get(roomName);
+        return room ? room.clients.has(clientId) : false;
+    }
+    /**
+     * Get all rooms
+     */
+    getAllRooms() {
+        return Array.from(this.rooms.values());
+    }
+    /**
+     * Get room count
+     */
+    getRoomCount() {
+        return this.rooms.size;
+    }
+    /**
+     * Get total client count across all rooms
+     */
+    getTotalClientCount() {
+        let count = 0;
+        for (const room of this.rooms.values()) {
+            count += room.clients.size;
+        }
+        return count;
+    }
+    /**
+     * Broadcast to room
+     */
+    broadcastToRoom(roomName, event, data, clients, excludeClientId) {
+        const room = this.rooms.get(roomName);
+        if (!room) {
+            return;
+        }
+        for (const clientId of room.clients) {
+            if (excludeClientId && clientId === excludeClientId) {
+                continue;
+            }
+            const client = clients.get(clientId);
+            if (client) {
+                client.send(event, data);
+            }
+        }
+        core_1.default.debug(`Broadcast to room ${roomName}: ${event}`);
+    }
+    /**
+     * Set room metadata
+     */
+    setRoomMetadata(roomName, key, value) {
+        const room = this.rooms.get(roomName);
+        if (room) {
+            room.metadata.set(key, value);
+        }
+    }
+    /**
+     * Get room metadata
+     */
+    getRoomMetadata(roomName, key) {
+        const room = this.rooms.get(roomName);
+        return room ? room.metadata.get(key) : undefined;
+    }
+    /**
+     * Clear all rooms
+     */
+    clear() {
+        this.rooms.clear();
+        this.clientRooms.clear();
+        core_1.default.info('All rooms cleared');
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        const totalRooms = this.rooms.size;
+        const totalClients = this.getTotalClientCount();
+        const averageClientsPerRoom = totalRooms > 0 ? totalClients / totalRooms : 0;
+        return {
+            totalRooms,
+            totalClients,
+            averageClientsPerRoom: Math.round(averageClientsPerRoom * 100) / 100,
+        };
+    }
+}
+exports.RoomManager = RoomManager;

package/dist/src/decorators/realtime.decorator.d.ts

@@ -0,0 +1,113 @@
+import 'reflect-metadata';
+import { WebSocketGatewayOptions } from '../websocket.types';
+/**
+ * Realtime decorator for WebSocket gateways
+ *
+ * @example
+ * ```typescript
+ * @Realtime('/notifications')
+ * export class NotificationGateway {
+ *   // Gateway methods
+ * }
+ * ```
+ */
+export declare function Realtime(pathOrOptions?: string | WebSocketGatewayOptions): ClassDecorator;
+/**
+ * Get realtime metadata from a class
+ */
+export declare function getRealtimeMetadata(target: object | (new (...args: unknown[]) => object)): WebSocketGatewayOptions | undefined;
+/**
+ * Check if a class is a realtime gateway
+ */
+export declare function isRealtimeGateway(target: object | (new (...args: unknown[]) => object)): boolean;
+/**
+ * Subscribe decorator for event handlers
+ *
+ * @example
+ * ```typescript
+ * @Subscribe('user-{userId}')
+ * onUserEvent(@Param('userId') userId: string, @Data() data: any) {
+ *   // Handle event
+ * }
+ * ```
+ */
+export declare function Subscribe(event: string): MethodDecorator;
+/**
+ * Get subscribe metadata from a method
+ */
+export declare function getSubscribeMetadata(target: object, propertyKey: string | symbol): string | undefined;
+/**
+ * OnConnect decorator for connection handlers
+ *
+ * @example
+ * ```typescript
+ * @OnConnect()
+ * handleConnection(@Client() client: WebSocketClient) {
+ *   console.log('Client connected:', client.id);
+ * }
+ * ```
+ */
+export declare function OnConnect(): MethodDecorator;
+/**
+ * Get OnConnect metadata
+ */
+export declare function getOnConnectMetadata(target: object, propertyKey: string | symbol): boolean;
+/**
+ * OnDisconnect decorator for disconnection handlers
+ *
+ * @example
+ * ```typescript
+ * @OnDisconnect()
+ * handleDisconnect(@Client() client: WebSocketClient) {
+ *   console.log('Client disconnected:', client.id);
+ * }
+ * ```
+ */
+export declare function OnDisconnect(): MethodDecorator;
+/**
+ * Get OnDisconnect metadata
+ */
+export declare function getOnDisconnectMetadata(target: object, propertyKey: string | symbol): boolean;
+/**
+ * OnMessage decorator for message handlers
+ *
+ * @example
+ * ```typescript
+ * @OnMessage('chat')
+ * handleMessage(@Client() client: WebSocketClient, @Data() data: any) {
+ *   // Handle message
+ * }
+ * ```
+ */
+export declare function OnMessage(event: string): MethodDecorator;
+/**
+ * Get OnMessage metadata
+ */
+export declare function getOnMessageMetadata(target: object, propertyKey: string | symbol): string | undefined;
+/**
+ * Client parameter decorator
+ *
+ * @example
+ * ```typescript
+ * handleConnection(@Client() client: WebSocketClient) {
+ *   // client is injected
+ * }
+ * ```
+ */
+export declare function Client(): ParameterDecorator;
+/**
+ * Data parameter decorator
+ *
+ * @example
+ * ```typescript
+ * handleMessage(@Data() data: any) {
+ *   // data is injected
+ * }
+ * ```
+ */
+export declare function Data(): ParameterDecorator;
+/**
+ * Get parameter metadata
+ */
+export declare function getParameterMetadata(target: object, propertyKey: string | symbol): string[];
+//# sourceMappingURL=realtime.decorator.d.ts.map

package/dist/src/decorators/realtime.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.decorator.d.ts","sourceRoot":"","sources":["../../../src/decorators/realtime.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAS7D;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,uBAAuB,GAAG,cAAc,CAmBzF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,GACpD,uBAAuB,GAAG,SAAS,CAErC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,GAAG,OAAO,CAEhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAQxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,IAAI,eAAe,CAQ3C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAE1F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAQ9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAE7F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAQxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,MAAM,GAAG,SAAS,CAEpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,IAAI,kBAAkB,CAM3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,IAAI,kBAAkB,CAMzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,CAE3F"}