@xbg.solutions/utils-realtime-connector 1.0.0

package/lib/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Realtime Connector Barrel Export
+ */
+export * from './types';
+export * from './realtime-connector';
+export * from './providers/sse-provider';
+export * from './providers/websocket-provider';
+import { RealtimeConnector } from './realtime-connector';
+export declare function initializeRealtimeConnector(config: any): void;
+export declare function createRealtimeConnector(): RealtimeConnector | null;
+export declare function getRealtimeConnector(): RealtimeConnector | null;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAOzD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAI7D;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,GAAG,IAAI,CAwBlE;AAID,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,IAAI,CAK/D"}

package/lib/index.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Realtime Connector Barrel Export
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeRealtimeConnector = initializeRealtimeConnector;
+exports.createRealtimeConnector = createRealtimeConnector;
+exports.getRealtimeConnector = getRealtimeConnector;
+__exportStar(require("./types"), exports);
+__exportStar(require("./realtime-connector"), exports);
+__exportStar(require("./providers/sse-provider"), exports);
+__exportStar(require("./providers/websocket-provider"), exports);
+const realtime_connector_1 = require("./realtime-connector");
+const sse_provider_1 = require("./providers/sse-provider");
+const websocket_provider_1 = require("./providers/websocket-provider");
+// Config is provided via initializeRealtimeConnector() at app startup
+let connectorConfig = null;
+function initializeRealtimeConnector(config) {
+    connectorConfig = config;
+    // Reset singleton so it gets re-created with new config
+    realtimeConnectorInstance = undefined;
+}
+function createRealtimeConnector() {
+    if (!connectorConfig) {
+        throw new Error('Realtime connector not initialized. Call initializeRealtimeConnector() first.');
+    }
+    if (!connectorConfig.realtime.enabled) {
+        return null;
+    }
+    const provider = connectorConfig.realtime.provider;
+    if (provider === 'sse') {
+        const config = connectorConfig.realtime.providers.sse;
+        return new realtime_connector_1.RealtimeConnector(new sse_provider_1.SSEProvider(config === null || config === void 0 ? void 0 : config.heartbeatInterval));
+    }
+    if (provider === 'websocket') {
+        const config = connectorConfig.realtime.providers.websocket;
+        return new realtime_connector_1.RealtimeConnector(new websocket_provider_1.WebSocketProvider((config === null || config === void 0 ? void 0 : config.port) || 8080, config === null || config === void 0 ? void 0 : config.path));
+    }
+    throw new Error(`Unsupported realtime provider: ${provider}`);
+}
+let realtimeConnectorInstance;
+function getRealtimeConnector() {
+    if (realtimeConnectorInstance === undefined) {
+        realtimeConnectorInstance = createRealtimeConnector();
+    }
+    return realtimeConnectorInstance;
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAcH,kEAIC;AAED,0DAwBC;AAID,oDAKC;AAnDD,0CAAwB;AACxB,uDAAqC;AACrC,2DAAyC;AACzC,iEAA+C;AAE/C,6DAAyD;AACzD,2DAAuD;AACvD,uEAAmE;AAEnE,sEAAsE;AACtE,IAAI,eAAe,GAAQ,IAAI,CAAC;AAEhC,SAAgB,2BAA2B,CAAC,MAAW;IACrD,eAAe,GAAG,MAAM,CAAC;IACzB,wDAAwD;IACxD,yBAAyB,GAAG,SAAS,CAAC;AACxC,CAAC;AAED,SAAgB,uBAAuB;IACrC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACnG,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAEnD,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC;QACtD,OAAO,IAAI,sCAAiB,CAAC,IAAI,0BAAW,CAAC,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,iBAAiB,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC;QAC5D,OAAO,IAAI,sCAAiB,CAC1B,IAAI,sCAAiB,CAAC,CAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,KAAI,IAAI,EAAE,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,IAAI,CAAC,CAC1D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,IAAI,yBAA+D,CAAC;AAEpE,SAAgB,oBAAoB;IAClC,IAAI,yBAAyB,KAAK,SAAS,EAAE,CAAC;QAC5C,yBAAyB,GAAG,uBAAuB,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,yBAAyB,CAAC;AACnC,CAAC"}

package/lib/providers/sse-provider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SSE (Server-Sent Events) Provider
+ */
+import { Response } from 'express';
+import { RealtimeProvider } from '../realtime-connector';
+import { RealtimeMessage, RealtimeClient, BroadcastOptions } from '../types';
+export declare class SSEProvider implements RealtimeProvider {
+    private clients;
+    private heartbeatInterval;
+    constructor(heartbeatInterval?: number);
+    addClient(clientId: string, res: Response, client: RealtimeClient): void;
+    broadcast(message: RealtimeMessage, options?: BroadcastOptions): Promise<void>;
+    sendToClient(clientId: string, message: RealtimeMessage): Promise<void>;
+    sendToUser(userId: string, message: RealtimeMessage): Promise<void>;
+    sendToChannel(channel: string, message: RealtimeMessage): Promise<void>;
+    getConnectedClients(): RealtimeClient[];
+    disconnect(clientId: string): Promise<void>;
+    private formatSSE;
+    private startHeartbeat;
+}
+//# sourceMappingURL=sse-provider.d.ts.map

package/lib/providers/sse-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-provider.d.ts","sourceRoot":"","sources":["../../src/providers/sse-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7E,qBAAa,WAAY,YAAW,gBAAgB;IAClD,OAAO,CAAC,OAAO,CAAqE;IACpF,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,iBAAiB,SAAQ;IAKrC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IASlE,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IASnE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7E,mBAAmB,IAAI,cAAc,EAAE;IAIjC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,cAAc;CAOvB"}

package/lib/providers/sse-provider.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * SSE (Server-Sent Events) Provider
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SSEProvider = void 0;
+class SSEProvider {
+    constructor(heartbeatInterval = 30000) {
+        this.clients = new Map();
+        this.heartbeatInterval = heartbeatInterval;
+        this.startHeartbeat();
+    }
+    addClient(clientId, res, client) {
+        this.clients.set(clientId, { res, client });
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+        });
+    }
+    async broadcast(message, options) {
+        const formatted = this.formatSSE(message);
+        for (const [clientId, { res, client }] of this.clients.entries()) {
+            if ((options === null || options === void 0 ? void 0 : options.excludeClient) && clientId === options.excludeClient)
+                continue;
+            if ((options === null || options === void 0 ? void 0 : options.channel) && !client.channels.includes(options.channel))
+                continue;
+            if ((options === null || options === void 0 ? void 0 : options.userId) && client.userId !== options.userId)
+                continue;
+            res.write(formatted);
+        }
+    }
+    async sendToClient(clientId, message) {
+        const entry = this.clients.get(clientId);
+        if (entry) {
+            entry.res.write(this.formatSSE(message));
+        }
+    }
+    async sendToUser(userId, message) {
+        const formatted = this.formatSSE(message);
+        for (const { res, client } of this.clients.values()) {
+            if (client.userId === userId) {
+                res.write(formatted);
+            }
+        }
+    }
+    async sendToChannel(channel, message) {
+        const formatted = this.formatSSE(message);
+        for (const { res, client } of this.clients.values()) {
+            if (client.channels.includes(channel)) {
+                res.write(formatted);
+            }
+        }
+    }
+    getConnectedClients() {
+        return Array.from(this.clients.values()).map(({ client }) => client);
+    }
+    async disconnect(clientId) {
+        const entry = this.clients.get(clientId);
+        if (entry) {
+            entry.res.end();
+            this.clients.delete(clientId);
+        }
+    }
+    formatSSE(message) {
+        return `id: ${message.id}\nevent: ${message.type}\ndata: ${JSON.stringify(message.data)}\n\n`;
+    }
+    startHeartbeat() {
+        setInterval(() => {
+            for (const { res } of this.clients.values()) {
+                res.write(':heartbeat\n\n');
+            }
+        }, this.heartbeatInterval);
+    }
+}
+exports.SSEProvider = SSEProvider;
+//# sourceMappingURL=sse-provider.js.map

package/lib/providers/sse-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-provider.js","sourceRoot":"","sources":["../../src/providers/sse-provider.ts"],"names":[],"mappings":"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"}

package/lib/providers/websocket-provider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WebSocket Provider
+ */
+import { RealtimeProvider } from '../realtime-connector';
+import { RealtimeMessage, RealtimeClient, BroadcastOptions } from '../types';
+export declare class WebSocketProvider implements RealtimeProvider {
+    private wss;
+    private clients;
+    constructor(port: number, path?: string);
+    private setupServer;
+    private handleMessage;
+    broadcast(message: RealtimeMessage, options?: BroadcastOptions): Promise<void>;
+    sendToClient(clientId: string, message: RealtimeMessage): Promise<void>;
+    sendToUser(userId: string, message: RealtimeMessage): Promise<void>;
+    sendToChannel(channel: string, message: RealtimeMessage): Promise<void>;
+    getConnectedClients(): RealtimeClient[];
+    disconnect(clientId: string): Promise<void>;
+    private generateClientId;
+}
+//# sourceMappingURL=websocket-provider.d.ts.map

package/lib/providers/websocket-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-provider.d.ts","sourceRoot":"","sources":["../../src/providers/websocket-provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7E,qBAAa,iBAAkB,YAAW,gBAAgB;IACxD,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,OAAO,CAAqE;gBAExE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAQ;IAKtC,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,aAAa;IAcf,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IASnE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7E,mBAAmB,IAAI,cAAc,EAAE;IAIjC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,OAAO,CAAC,gBAAgB;CAGzB"}

package/lib/providers/websocket-provider.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * WebSocket Provider
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketProvider = void 0;
+const ws_1 = require("ws");
+class WebSocketProvider {
+    constructor(port, path = '/ws') {
+        this.clients = new Map();
+        this.wss = new ws_1.WebSocketServer({ port, path });
+        this.setupServer();
+    }
+    setupServer() {
+        this.wss.on('connection', (ws) => {
+            const clientId = this.generateClientId();
+            const client = { id: clientId, channels: [] };
+            this.clients.set(clientId, { ws, client });
+            ws.on('message', (data) => this.handleMessage(clientId, data.toString()));
+            ws.on('close', () => this.clients.delete(clientId));
+            ws.send(JSON.stringify({ type: 'connected', clientId }));
+        });
+    }
+    handleMessage(clientId, data) {
+        try {
+            const message = JSON.parse(data);
+            if (message.type === 'subscribe' && message.channel) {
+                const entry = this.clients.get(clientId);
+                if (entry && !entry.client.channels.includes(message.channel)) {
+                    entry.client.channels.push(message.channel);
+                }
+            }
+        }
+        catch (error) {
+            // Invalid message
+        }
+    }
+    async broadcast(message, options) {
+        const data = JSON.stringify(message);
+        for (const [clientId, { ws, client }] of this.clients.entries()) {
+            if ((options === null || options === void 0 ? void 0 : options.excludeClient) && clientId === options.excludeClient)
+                continue;
+            if ((options === null || options === void 0 ? void 0 : options.channel) && !client.channels.includes(options.channel))
+                continue;
+            if ((options === null || options === void 0 ? void 0 : options.userId) && client.userId !== options.userId)
+                continue;
+            if (ws.readyState === ws_1.WebSocket.OPEN) {
+                ws.send(data);
+            }
+        }
+    }
+    async sendToClient(clientId, message) {
+        const entry = this.clients.get(clientId);
+        if (entry && entry.ws.readyState === ws_1.WebSocket.OPEN) {
+            entry.ws.send(JSON.stringify(message));
+        }
+    }
+    async sendToUser(userId, message) {
+        const data = JSON.stringify(message);
+        for (const { ws, client } of this.clients.values()) {
+            if (client.userId === userId && ws.readyState === ws_1.WebSocket.OPEN) {
+                ws.send(data);
+            }
+        }
+    }
+    async sendToChannel(channel, message) {
+        const data = JSON.stringify(message);
+        for (const { ws, client } of this.clients.values()) {
+            if (client.channels.includes(channel) && ws.readyState === ws_1.WebSocket.OPEN) {
+                ws.send(data);
+            }
+        }
+    }
+    getConnectedClients() {
+        return Array.from(this.clients.values()).map(({ client }) => client);
+    }
+    async disconnect(clientId) {
+        const entry = this.clients.get(clientId);
+        if (entry) {
+            entry.ws.close();
+            this.clients.delete(clientId);
+        }
+    }
+    generateClientId() {
+        return `client_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+exports.WebSocketProvider = WebSocketProvider;
+//# sourceMappingURL=websocket-provider.js.map

package/lib/providers/websocket-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-provider.js","sourceRoot":"","sources":["../../src/providers/websocket-provider.ts"],"names":[],"mappings":"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"}

package/lib/realtime-connector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Realtime Connector
+ * Manages real-time connections via SSE or WebSocket
+ */
+import { RealtimeMessage, RealtimeClient, BroadcastOptions } from './types';
+export interface RealtimeProvider {
+    broadcast(message: RealtimeMessage, options?: BroadcastOptions): Promise<void>;
+    sendToClient(clientId: string, message: RealtimeMessage): Promise<void>;
+    sendToUser(userId: string, message: RealtimeMessage): Promise<void>;
+    sendToChannel(channel: string, message: RealtimeMessage): Promise<void>;
+    getConnectedClients(): RealtimeClient[];
+    disconnect(clientId: string): Promise<void>;
+}
+export declare class RealtimeConnector {
+    private provider;
+    constructor(provider: RealtimeProvider);
+    broadcast(message: RealtimeMessage, options?: BroadcastOptions): Promise<void>;
+    sendToClient(clientId: string, message: RealtimeMessage): Promise<void>;
+    sendToUser(userId: string, message: RealtimeMessage): Promise<void>;
+    sendToChannel(channel: string, message: RealtimeMessage): Promise<void>;
+    getConnectedClients(): RealtimeClient[];
+    disconnect(clientId: string): Promise<void>;
+}
+//# sourceMappingURL=realtime-connector.d.ts.map

package/lib/realtime-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-connector.d.ts","sourceRoot":"","sources":["../src/realtime-connector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG5E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,mBAAmB,IAAI,cAAc,EAAE,CAAC;IACxC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAmB;gBAEvB,QAAQ,EAAE,gBAAgB;IAIhC,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,mBAAmB,IAAI,cAAc,EAAE;IAIjC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD"}

package/lib/realtime-connector.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Realtime Connector
+ * Manages real-time connections via SSE or WebSocket
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RealtimeConnector = void 0;
+const utils_logger_1 = require("@xbg/utils-logger");
+class RealtimeConnector {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async broadcast(message, options) {
+        utils_logger_1.logger.info('Broadcasting message', { type: message.type, options });
+        return this.provider.broadcast(message, options);
+    }
+    async sendToClient(clientId, message) {
+        return this.provider.sendToClient(clientId, message);
+    }
+    async sendToUser(userId, message) {
+        return this.provider.sendToUser(userId, message);
+    }
+    async sendToChannel(channel, message) {
+        return this.provider.sendToChannel(channel, message);
+    }
+    getConnectedClients() {
+        return this.provider.getConnectedClients();
+    }
+    async disconnect(clientId) {
+        return this.provider.disconnect(clientId);
+    }
+}
+exports.RealtimeConnector = RealtimeConnector;
+//# sourceMappingURL=realtime-connector.js.map

package/lib/realtime-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-connector.js","sourceRoot":"","sources":["../src/realtime-connector.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,oDAA2C;AAW3C,MAAa,iBAAiB;IAG5B,YAAY,QAA0B;QACpC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAwB,EAAE,OAA0B;QAClE,qBAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,OAAwB;QACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,mBAAmB;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;CACF;AA/BD,8CA+BC"}

package/lib/types.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Realtime Connector Types
+ * For SSE and WebSocket real-time communication
+ */
+export interface RealtimeMessage {
+    id: string;
+    type: string;
+    data: any;
+    timestamp: Date;
+}
+export interface RealtimeClient {
+    id: string;
+    userId?: string;
+    channels: string[];
+    metadata?: Record<string, any>;
+}
+export interface BroadcastOptions {
+    channel?: string;
+    userId?: string;
+    excludeClient?: string;
+}
+export interface SSEResponse {
+    write: (data: string) => void;
+    end: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB"}

package/lib/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Realtime Connector Types
+ * For SSE and WebSocket real-time communication
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@xbg.solutions/utils-realtime-connector",
+  "version": "1.0.0",
+  "description": "SSE and WebSocket providers",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rm -rf lib",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@xbg/utils-logger": "^1.0.0",
+    "ws": "^8.15.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": "22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}