@hazeljs/websocket 0.2.0-beta.1

package/dist/src/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/src/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/src/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/src/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/src/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/src/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/src/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/sse/sse.handler.d.ts

@@ -0,0 +1,61 @@
+import { IncomingMessage, ServerResponse } from 'http';
+import { SSEMessage, SSEOptions } from '../websocket.types';
+/**
+ * Server-Sent Events (SSE) handler
+ */
+export declare class SSEHandler {
+    private connections;
+    private keepAliveIntervals;
+    /**
+     * Initialize SSE connection
+     */
+    initConnection(req: IncomingMessage, res: ServerResponse, options?: SSEOptions): string;
+    /**
+     * Send message to a specific connection
+     */
+    send(connectionId: string, message: SSEMessage): boolean;
+    /**
+     * Broadcast message to all connections
+     */
+    broadcast(message: SSEMessage): void;
+    /**
+     * Close a specific connection
+     */
+    closeConnection(connectionId: string): void;
+    /**
+     * Close all connections
+     */
+    closeAll(): void;
+    /**
+     * Get active connection count
+     */
+    getConnectionCount(): number;
+    /**
+     * Check if connection exists
+     */
+    hasConnection(connectionId: string): boolean;
+    /**
+     * Get all connection IDs
+     */
+    getConnectionIds(): string[];
+    /**
+     * Generate unique connection ID
+     */
+    private generateConnectionId;
+    /**
+     * Create a stream for continuous data
+     */
+    createStream<T>(connectionId: string, dataSource: AsyncIterable<T> | Iterable<T>, options?: {
+        event?: string;
+        transform?: (data: T) => unknown;
+    }): AsyncGenerator<boolean>;
+}
+/**
+ * Helper function to create SSE response
+ */
+export declare function createSSEResponse(res: ServerResponse, options?: SSEOptions): void;
+/**
+ * Helper function to send SSE message
+ */
+export declare function sendSSEMessage(res: ServerResponse, message: SSEMessage): void;
+//# sourceMappingURL=sse.handler.d.ts.map

package/dist/src/sse/sse.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.handler.d.ts","sourceRoot":"","sources":["../../../src/sse/sse.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAG5D;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,kBAAkB,CAA0C;IAEpE;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM;IA0C3F;;OAEG;IACH,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO;IA0CxD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAQpC;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAgB3C;;OAEG;IACH,QAAQ,IAAI,IAAI;IAQhB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAI5C;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACI,YAAY,CAAC,CAAC,EACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAC1C,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;KAAO,GACjE,cAAc,CAAC,OAAO,CAAC;CAmB3B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,GAAE,UAAe,GAAG,IAAI,CAYrF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAyB7E"}