@hazeljs/websocket 0.2.0-beta.1

package/dist/src/websocket.module.js

@@ -0,0 +1,88 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var WebSocketModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketModule = void 0;
+const core_1 = require("@hazeljs/core");
+const sse_handler_1 = require("./sse/sse.handler");
+const room_manager_1 = require("./room/room.manager");
+const core_2 = __importDefault(require("@hazeljs/core"));
+/**
+ * WebSocket module for HazelJS
+ */
+let WebSocketModule = WebSocketModule_1 = class WebSocketModule {
+    /**
+     * Configure WebSocket module
+     */
+    static forRoot(options = {}) {
+        const { isGlobal = true, enableSSE = true, enableRooms = true } = options;
+        core_2.default.info('Configuring WebSocket module...');
+        const providers = [];
+        // Add SSE handler if enabled
+        if (enableSSE) {
+            providers.push({
+                provide: sse_handler_1.SSEHandler,
+                useValue: new sse_handler_1.SSEHandler(),
+            });
+        }
+        // Add room manager if enabled
+        if (enableRooms) {
+            providers.push({
+                provide: room_manager_1.RoomManager,
+                useValue: new room_manager_1.RoomManager(),
+            });
+        }
+        return {
+            module: WebSocketModule_1,
+            providers,
+            exports: providers.map((p) => p.provide),
+            global: isGlobal,
+        };
+    }
+    /**
+     * Configure WebSocket module asynchronously
+     */
+    static forRootAsync(options) {
+        return {
+            module: WebSocketModule_1,
+            providers: [
+                {
+                    provide: 'WEBSOCKET_OPTIONS',
+                    useFactory: options.useFactory,
+                    inject: options.inject || [],
+                },
+                {
+                    provide: sse_handler_1.SSEHandler,
+                    useFactory: (wsOptions) => {
+                        return wsOptions.enableSSE !== false ? new sse_handler_1.SSEHandler() : null;
+                    },
+                    inject: ['WEBSOCKET_OPTIONS'],
+                },
+                {
+                    provide: room_manager_1.RoomManager,
+                    useFactory: (wsOptions) => {
+                        return wsOptions.enableRooms !== false ? new room_manager_1.RoomManager() : null;
+                    },
+                    inject: ['WEBSOCKET_OPTIONS'],
+                },
+            ],
+            exports: [sse_handler_1.SSEHandler, room_manager_1.RoomManager],
+            global: true,
+        };
+    }
+};
+exports.WebSocketModule = WebSocketModule;
+exports.WebSocketModule = WebSocketModule = WebSocketModule_1 = __decorate([
+    (0, core_1.HazelModule)({
+        providers: [],
+        exports: [],
+    })
+], WebSocketModule);

package/dist/src/websocket.types.d.ts

@@ -0,0 +1,258 @@
+import { IncomingMessage } from 'http';
+/**
+ * WebSocket client interface
+ */
+export interface WebSocketClient {
+    /**
+     * Unique client ID
+     */
+    id: string;
+    /**
+     * Client socket
+     */
+    socket: unknown;
+    /**
+     * Client metadata
+     */
+    metadata: Map<string, unknown>;
+    /**
+     * Rooms the client is in
+     */
+    rooms: Set<string>;
+    /**
+     * Send message to client
+     */
+    send(event: string, data: unknown): void;
+    /**
+     * Disconnect client
+     */
+    disconnect(): void;
+    /**
+     * Join a room
+     */
+    join(room: string): void;
+    /**
+     * Leave a room
+     */
+    leave(room: string): void;
+    /**
+     * Check if client is in a room
+     */
+    inRoom(room: string): boolean;
+}
+/**
+ * WebSocket message
+ */
+export interface WebSocketMessage {
+    /**
+     * Event name
+     */
+    event: string;
+    /**
+     * Message data
+     */
+    data: unknown;
+    /**
+     * Timestamp
+     */
+    timestamp: number;
+    /**
+     * Client ID
+     */
+    clientId?: string;
+}
+/**
+ * WebSocket gateway options
+ */
+export interface WebSocketGatewayOptions {
+    /**
+     * Gateway path
+     */
+    path?: string;
+    /**
+     * Namespace
+     */
+    namespace?: string;
+    /**
+     * CORS options
+     */
+    cors?: {
+        origin?: string | string[];
+        credentials?: boolean;
+    };
+    /**
+     * Authentication required
+     */
+    auth?: boolean;
+    /**
+     * Ping interval in milliseconds
+     */
+    pingInterval?: number;
+    /**
+     * Ping timeout in milliseconds
+     */
+    pingTimeout?: number;
+    /**
+     * Maximum payload size in bytes
+     */
+    maxPayload?: number;
+}
+/**
+ * Room interface
+ */
+export interface Room {
+    /**
+     * Room name
+     */
+    name: string;
+    /**
+     * Clients in the room
+     */
+    clients: Set<string>;
+    /**
+     * Room metadata
+     */
+    metadata: Map<string, unknown>;
+    /**
+     * Created timestamp
+     */
+    createdAt: number;
+}
+/**
+ * WebSocket event handler
+ */
+export type WebSocketEventHandler = (client: WebSocketClient, data: unknown) => void | Promise<void>;
+/**
+ * Connection handler
+ */
+export type ConnectionHandler = (client: WebSocketClient, request: IncomingMessage) => void | Promise<void>;
+/**
+ * Disconnection handler
+ */
+export type DisconnectionHandler = (client: WebSocketClient, reason?: string) => void | Promise<void>;
+/**
+ * WebSocket server options
+ */
+export interface WebSocketServerOptions {
+    /**
+     * Port to listen on
+     */
+    port?: number;
+    /**
+     * Host to bind to
+     */
+    host?: string;
+    /**
+     * Path for WebSocket endpoint
+     */
+    path?: string;
+    /**
+     * Enable per-message deflate
+     */
+    perMessageDeflate?: boolean;
+    /**
+     * Maximum payload size
+     */
+    maxPayload?: number;
+    /**
+     * Client tracking
+     */
+    clientTracking?: boolean;
+}
+/**
+ * SSE (Server-Sent Events) options
+ */
+export interface SSEOptions {
+    /**
+     * Retry interval in milliseconds
+     */
+    retry?: number;
+    /**
+     * Keep-alive interval in milliseconds
+     */
+    keepAlive?: number;
+    /**
+     * Event ID
+     */
+    id?: string;
+}
+/**
+ * SSE message
+ */
+export interface SSEMessage {
+    /**
+     * Event type
+     */
+    event?: string;
+    /**
+     * Message data
+     */
+    data: unknown;
+    /**
+     * Event ID
+     */
+    id?: string;
+    /**
+     * Retry interval
+     */
+    retry?: number;
+}
+/**
+ * Subscription options
+ */
+export interface SubscriptionOptions {
+    /**
+     * Topic pattern
+     */
+    topic: string;
+    /**
+     * Filter function
+     */
+    filter?: (data: unknown) => boolean;
+    /**
+     * Transform function
+     */
+    transform?: (data: unknown) => unknown;
+    /**
+     * Batch size
+     */
+    batchSize?: number;
+    /**
+     * Batch interval in milliseconds
+     */
+    batchInterval?: number;
+}
+/**
+ * WebSocket statistics
+ */
+export interface WebSocketStats {
+    /**
+     * Total connected clients
+     */
+    connectedClients: number;
+    /**
+     * Total rooms
+     */
+    totalRooms: number;
+    /**
+     * Messages sent
+     */
+    messagesSent: number;
+    /**
+     * Messages received
+     */
+    messagesReceived: number;
+    /**
+     * Bytes sent
+     */
+    bytesSent: number;
+    /**
+     * Bytes received
+     */
+    bytesReceived: number;
+    /**
+     * Uptime in milliseconds
+     */
+    uptime: number;
+}
+//# sourceMappingURL=websocket.types.d.ts.map

package/dist/src/websocket.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.types.d.ts","sourceRoot":"","sources":["../../src/websocket.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,UAAU,IAAI,IAAI,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAEF;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAErB;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,OAAO,KACV,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,eAAe,KACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,MAAM,KACZ,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IAEpC;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/src/websocket.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/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/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"}

package/dist/sse/sse.handler.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.SSEHandler = void 0;
+exports.createSSEResponse = createSSEResponse;
+exports.sendSSEMessage = sendSSEMessage;
+const core_1 = __importDefault(require("@hazeljs/core"));
+/**
+ * Server-Sent Events (SSE) handler
+ */
+class SSEHandler {
+    constructor() {
+        this.connections = new Map();
+        this.keepAliveIntervals = new Map();
+    }
+    /**
+     * Initialize SSE connection
+     */
+    initConnection(req, res, options = {}) {
+        const connectionId = this.generateConnectionId();
+        // Set SSE headers
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+            'Access-Control-Allow-Origin': '*',
+            'X-Accel-Buffering': 'no', // Disable nginx buffering
+        });
+        // Send initial retry interval
+        if (options.retry) {
+            res.write(`retry: ${options.retry}\n\n`);
+        }
+        // Store connection
+        this.connections.set(connectionId, res);
+        // Setup keep-alive
+        const keepAliveInterval = options.keepAlive || 30000;
+        const interval = setInterval(() => {
+            if (this.connections.has(connectionId)) {
+                res.write(': keep-alive\n\n');
+            }
+            else {
+                clearInterval(interval);
+            }
+        }, keepAliveInterval);
+        this.keepAliveIntervals.set(connectionId, interval);
+        // Handle connection close
+        req.on('close', () => {
+            this.closeConnection(connectionId);
+        });
+        core_1.default.debug(`SSE connection initialized: ${connectionId}`);
+        return connectionId;
+    }
+    /**
+     * Send message to a specific connection
+     */
+    send(connectionId, message) {
+        const res = this.connections.get(connectionId);
+        if (!res) {
+            return false;
+        }
+        try {
+            let output = '';
+            // Add event type
+            if (message.event) {
+                output += `event: ${message.event}\n`;
+            }
+            // Add ID
+            if (message.id) {
+                output += `id: ${message.id}\n`;
+            }
+            // Add retry
+            if (message.retry) {
+                output += `retry: ${message.retry}\n`;
+            }
+            // Add data (can be multi-line)
+            const data = typeof message.data === 'string' ? message.data : JSON.stringify(message.data);
+            const lines = data.split('\n');
+            for (const line of lines) {
+                output += `data: ${line}\n`;
+            }
+            output += '\n';
+            res.write(output);
+            return true;
+        }
+        catch (error) {
+            core_1.default.error(`Failed to send SSE message to ${connectionId}:`, error);
+            return false;
+        }
+    }
+    /**
+     * Broadcast message to all connections
+     */
+    broadcast(message) {
+        for (const connectionId of this.connections.keys()) {
+            this.send(connectionId, message);
+        }
+        core_1.default.debug(`SSE broadcast: ${message.event || 'message'}`);
+    }
+    /**
+     * Close a specific connection
+     */
+    closeConnection(connectionId) {
+        const res = this.connections.get(connectionId);
+        if (res) {
+            res.end();
+            this.connections.delete(connectionId);
+        }
+        const interval = this.keepAliveIntervals.get(connectionId);
+        if (interval) {
+            clearInterval(interval);
+            this.keepAliveIntervals.delete(connectionId);
+        }
+        core_1.default.debug(`SSE connection closed: ${connectionId}`);
+    }
+    /**
+     * Close all connections
+     */
+    closeAll() {
+        for (const connectionId of this.connections.keys()) {
+            this.closeConnection(connectionId);
+        }
+        core_1.default.info('All SSE connections closed');
+    }
+    /**
+     * Get active connection count
+     */
+    getConnectionCount() {
+        return this.connections.size;
+    }
+    /**
+     * Check if connection exists
+     */
+    hasConnection(connectionId) {
+        return this.connections.has(connectionId);
+    }
+    /**
+     * Get all connection IDs
+     */
+    getConnectionIds() {
+        return Array.from(this.connections.keys());
+    }
+    /**
+     * Generate unique connection ID
+     */
+    generateConnectionId() {
+        return `sse-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Create a stream for continuous data
+     */
+    async *createStream(connectionId, dataSource, options = {}) {
+        try {
+            for await (const data of dataSource) {
+                const transformedData = options.transform ? options.transform(data) : data;
+                const sent = this.send(connectionId, {
+                    event: options.event,
+                    data: transformedData,
+                });
+                yield sent;
+                if (!sent) {
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            core_1.default.error(`SSE stream error for ${connectionId}:`, error);
+        }
+    }
+}
+exports.SSEHandler = SSEHandler;
+/**
+ * Helper function to create SSE response
+ */
+function createSSEResponse(res, options = {}) {
+    res.writeHead(200, {
+        'Content-Type': 'text/event-stream',
+        'Cache-Control': 'no-cache',
+        Connection: 'keep-alive',
+        'Access-Control-Allow-Origin': '*',
+        'X-Accel-Buffering': 'no',
+    });
+    if (options.retry) {
+        res.write(`retry: ${options.retry}\n\n`);
+    }
+}
+/**
+ * Helper function to send SSE message
+ */
+function sendSSEMessage(res, message) {
+    let output = '';
+    if (message.event) {
+        output += `event: ${message.event}\n`;
+    }
+    if (message.id) {
+        output += `id: ${message.id}\n`;
+    }
+    if (message.retry) {
+        output += `retry: ${message.retry}\n`;
+    }
+    const data = typeof message.data === 'string' ? message.data : JSON.stringify(message.data);
+    const lines = data.split('\n');
+    for (const line of lines) {
+        output += `data: ${line}\n`;
+    }
+    output += '\n';
+    res.write(output);
+}