@heliosjs/core 1.0.2

package/dist/utils/shared/parsers.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseHeaders = exports.parseRequestCookie = exports.parseBody = exports.parseQuery = void 0;
+const parseQuery = (url) => {
+    const params = url.searchParams;
+    const query = {};
+    for (const key of params.keys()) {
+        const values = params.getAll(key);
+        query[key] = values.length > 1 ? values : values[0];
+    }
+    return query;
+};
+exports.parseQuery = parseQuery;
+const parseBody = (request) => {
+    if (request.body && typeof request.body === 'object' && !Buffer.isBuffer(request.body)) {
+        return request.body;
+    }
+    const { body, headers, isBase64Encoded } = request;
+    if (!body) {
+        return {};
+    }
+    let processedBody = body;
+    if (isBase64Encoded && typeof body === 'string') {
+        try {
+            processedBody = Buffer.from(body, 'base64');
+        }
+        catch (error) {
+            console.error('Failed to decode base64 body:', error);
+        }
+    }
+    let contentType = headers['content-type'] ?? headers['Content-Type'] ?? '';
+    if (Array.isArray(contentType)) {
+        contentType = contentType[0];
+    }
+    const cleanContentType = contentType.split(';')[0].trim().toLowerCase();
+    const getString = (data) => {
+        if (Buffer.isBuffer(data)) {
+            return data.toString('utf8');
+        }
+        if (typeof data === 'string') {
+            return data;
+        }
+        return String(data);
+    };
+    if (cleanContentType === 'application/json') {
+        try {
+            const str = getString(processedBody);
+            return JSON.parse(str);
+        }
+        catch (error) {
+            return { text: getString(processedBody), parseError: true };
+        }
+    }
+    if (cleanContentType.startsWith('text/')) {
+        return { text: getString(processedBody) };
+    }
+    if (cleanContentType === 'application/x-www-form-urlencoded') {
+        try {
+            const text = getString(processedBody);
+            const params = new URLSearchParams(text);
+            const result = {};
+            for (const [key, value] of params.entries()) {
+                if (result[key] !== undefined) {
+                    if (Array.isArray(result[key])) {
+                        result[key].push(value);
+                    }
+                    else {
+                        result[key] = [result[key], value];
+                    }
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+            return result;
+        }
+        catch (error) {
+            return { raw: getString(processedBody) };
+        }
+    }
+    if (cleanContentType === 'application/xml' || cleanContentType === 'text/xml') {
+        return { xml: getString(processedBody) };
+    }
+    if (cleanContentType.startsWith('multipart/')) {
+        return {
+            multipart: true,
+            contentType,
+            body: processedBody,
+        };
+    }
+    if (Buffer.isBuffer(processedBody)) {
+        return { raw: processedBody.toString('utf8') };
+    }
+    return processedBody;
+};
+exports.parseBody = parseBody;
+const parseCookie = (cookies) => {
+    return cookies.split(';').reduce((acc, cookie) => {
+        const [name, value] = cookie.trim().split('=');
+        if (name && value) {
+            acc[name] = decodeURIComponent(value);
+        }
+        return acc;
+    }, {});
+};
+const parseRequestCookie = (cookies) => {
+    if (!cookies)
+        return {};
+    const values = Array.isArray(cookies) ? cookies : [cookies];
+    return values.reduce((acc, cookie) => {
+        return {
+            ...acc,
+            ...parseCookie(cookie),
+        };
+    }, {});
+};
+exports.parseRequestCookie = parseRequestCookie;
+/**
+ * Safely convert headers to Record<string, string | string[]>
+ */
+const parseHeaders = (headers) => {
+    const result = {};
+    if (!headers)
+        return result;
+    Object.entries(headers).forEach(([key, value]) => {
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    });
+    return result;
+};
+exports.parseHeaders = parseHeaders;
+//# sourceMappingURL=parsers.js.map

package/dist/utils/shared/parsers.js.map

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

package/dist/utils/shared/validate.d.ts

@@ -0,0 +1 @@
+export declare function validate(dtoClass: any, data: any): Promise<any>;

package/dist/utils/shared/validate.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validate = validate;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+async function validate(dtoClass, data) {
+    if (!dtoClass) {
+        return data;
+    }
+    if (typeof dtoClass.from === 'function') {
+        return dtoClass.from(data);
+    }
+    if (typeof dtoClass === 'function') {
+        const instance = (0, class_transformer_1.plainToInstance)(dtoClass, data);
+        if (!instance) {
+            throw { status: 400, message: 'Validation failed', errors: 'Empty value' };
+        }
+        const errors = await (0, class_validator_1.validate)(instance);
+        if (errors.length > 0) {
+            const formattedErrors = formatValidationErrors(errors);
+            throw { status: 400, message: 'Validation failed', errors: formattedErrors };
+        }
+        return data;
+    }
+    return data;
+}
+function formatValidationErrors(errors) {
+    return errors.map((error) => {
+        const constraints = error.constraints || {};
+        const children = error.children && error.children.length > 0
+            ? formatValidationErrors(error.children)
+            : undefined;
+        return {
+            property: error.property,
+            value: error.value,
+            constraints: Object.values(constraints),
+            children,
+        };
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/utils/shared/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/utils/shared/validate.ts"],"names":[],"mappings":";;AAGA,4BA0BC;AA7BD,yDAAoD;AACpD,qDAAwE;AAEjE,KAAK,UAAU,QAAQ,CAAC,QAAa,EAAE,IAAS;IACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAA,mCAAe,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEjD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAC7E,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAQ,EAAC,QAAQ,CAAC,CAAC;QAExC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,eAAe,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YACvD,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QAC/E,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAyB;IACvD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC;QAE5C,MAAM,QAAQ,GACZ,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACzC,CAAC,CAAC,sBAAsB,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxC,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;YACvC,QAAQ;SACT,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/socket/index.d.ts

@@ -0,0 +1,3 @@
+export * from './server';
+export * from './service';
+export * from './socket';

package/dist/utils/socket/index.js

@@ -0,0 +1,20 @@
+"use strict";
+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 });
+__exportStar(require("./server"), exports);
+__exportStar(require("./service"), exports);
+__exportStar(require("./socket"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/socket/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/socket/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B;AAC1B,2CAAyB"}

package/dist/utils/socket/server.d.ts

@@ -0,0 +1,33 @@
+import http from 'http';
+import { WebSocketServer as Server } from 'ws';
+import { ControllerType } from '../../types/core';
+import { IWebSocketServer, WebSocketClient } from '../../types/ws';
+export declare class WebSocketServer implements IWebSocketServer {
+    wss: Server;
+    private clients;
+    private topics;
+    private controllers;
+    private options;
+    constructor(server: http.Server, options?: {
+        path: string;
+    });
+    private shouldHandleWebSocket;
+    private handleConnection;
+    private handleMessage;
+    private handleClose;
+    private handleError;
+    private triggerHandlers;
+    registerControllers(controllers: ControllerType[]): void;
+    subscribeToTopic(client: WebSocketClient, topic: string): void;
+    unsubscribeFromTopic(client: WebSocketClient, topic: string): void;
+    publishToTopic(topic: string, data: any, exclude?: string[]): void;
+    sendToClient(clientId: string, message: any): boolean;
+    broadcast(message: any, excludeClientId?: string): void;
+    getStats(): {
+        clients: number;
+        topics: {
+            topic: string;
+            subscribers: number;
+        }[];
+    };
+}

package/dist/utils/socket/server.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketServer = void 0;
+const uuid_1 = require("uuid");
+const ws_1 = require("ws");
+class WebSocketServer {
+    wss;
+    clients = new Map();
+    topics = new Map();
+    controllers = [];
+    options;
+    constructor(server, options) {
+        this.options = options;
+        this.wss = new ws_1.WebSocketServer({
+            noServer: true,
+            path: this.options.path,
+        });
+        this.wss.on('connection', (socket, request) => {
+            this.handleConnection(socket);
+        });
+        server.on('upgrade', (request, socket, head) => {
+            if (socket.__wsHandled) {
+                return;
+            }
+            socket.__wsHandled = true;
+            if (this.shouldHandleWebSocket(request.url)) {
+                this.wss.handleUpgrade(request, socket, head, (ws) => {
+                    this.wss.emit('connection', ws, request);
+                });
+            }
+            else {
+                socket.destroy();
+            }
+        });
+    }
+    shouldHandleWebSocket(url = '') {
+        return url.startsWith(this.options.path);
+    }
+    async handleConnection(socket) {
+        const clientId = (0, uuid_1.v4)();
+        const client = {
+            id: clientId,
+            socket,
+            topics: new Set(),
+            data: {},
+            connectedAt: new Date(),
+        };
+        this.clients.set(clientId, client);
+        socket.on('message', (data) => {
+            this.handleMessage(client, data);
+        });
+        socket.on('close', () => {
+            this.handleClose(client);
+        });
+        socket.on('error', (error) => {
+            this.handleError(client, error);
+        });
+        await this.triggerHandlers('connection', { type: 'connection', client });
+    }
+    async handleMessage(client, data) {
+        try {
+            const message = JSON.parse(data.toString());
+            const topic = message.topic ?? message.data?.topic;
+            if (message.type === 'subscribe' && topic) {
+                this.subscribeToTopic(client, topic);
+                return;
+            }
+            if (message.type === 'unsubscribe' && message.topic) {
+                this.unsubscribeFromTopic(client, message.topic);
+                return;
+            }
+            if (message.type === 'topic_message' && message.topic) {
+                await this.triggerHandlers('message', {
+                    type: 'message',
+                    client,
+                    message,
+                }, message.topic);
+                this.publishToTopic(message.topic, message.data, [client.id]);
+                return;
+            }
+            await this.triggerHandlers('message', {
+                type: 'message',
+                client,
+                message,
+            });
+        }
+        catch (error) {
+            client.socket.send(JSON.stringify({ type: 'error', data: { message: 'Invalid message format' } }));
+        }
+    }
+    async handleClose(client) {
+        client.topics.forEach((topic) => {
+            const topicClients = this.topics.get(topic);
+            if (topicClients) {
+                topicClients.delete(client.id);
+                if (topicClients.size === 0) {
+                    this.topics.delete(topic);
+                }
+            }
+        });
+        this.clients.delete(client.id);
+        await this.triggerHandlers('close', {
+            type: 'close',
+            client,
+        });
+    }
+    async handleError(client, error) {
+        await this.triggerHandlers('error', {
+            type: 'error',
+            client,
+            data: error,
+        });
+    }
+    async triggerHandlers(eventType, event, topic) {
+        for (const controller of this.controllers) {
+            const controllerHandlers = controller.ws?.handlers?.[eventType] ?? [];
+            const matchingHandlers = controllerHandlers.filter((h) => {
+                if (h.type !== eventType)
+                    return false;
+                if (!topic)
+                    return !h.topic;
+                return !h.topic || h.topic === topic;
+            });
+            for (const handler of matchingHandlers) {
+                try {
+                    await handler.fn(event);
+                }
+                catch (error) {
+                    console.error(`Error in WebSocket handler ${handler.method}:`, error);
+                }
+            }
+            if (eventType === 'message' && topic) {
+                const matchingSubs = controller.ws?.topics.filter((s) => s.topic === topic) ?? [];
+                for (const sub of matchingSubs) {
+                    try {
+                        await sub.fn(event);
+                    }
+                    catch (error) {
+                        console.error(`Error in subscription ${sub.method}:`, error);
+                    }
+                }
+            }
+        }
+    }
+    registerControllers(controllers) {
+        this.controllers = controllers.filter((c) => !!c.ws);
+    }
+    subscribeToTopic(client, topic) {
+        if (!this.topics.has(topic)) {
+            this.topics.set(topic, new Set());
+        }
+        this.topics.get(topic).add(client.id);
+        client.topics.add(topic);
+        client.socket.send(JSON.stringify({ type: 'subscribed', topic, data: { success: true } }));
+    }
+    unsubscribeFromTopic(client, topic) {
+        const topicClients = this.topics.get(topic);
+        if (topicClients) {
+            topicClients.delete(client.id);
+            if (topicClients.size === 0) {
+                this.topics.delete(topic);
+            }
+        }
+        client.topics.delete(topic);
+        client.socket.send(JSON.stringify({
+            type: 'unsubscribed',
+            topic,
+            data: { success: true },
+        }));
+    }
+    publishToTopic(topic, data, exclude) {
+        const topicClients = this.topics.get(topic);
+        if (!topicClients)
+            return;
+        const message = JSON.stringify({
+            type: 'message',
+            topic,
+            data,
+            timestamp: new Date().toISOString(),
+        });
+        topicClients.forEach((clientId) => {
+            if (exclude && exclude.includes(clientId)) {
+                return;
+            }
+            const client = this.clients.get(clientId);
+            if (client) {
+                client.socket.send(message);
+            }
+        });
+    }
+    sendToClient(clientId, message) {
+        const client = this.clients.get(clientId);
+        if (client) {
+            client.socket.send(JSON.stringify(message));
+            return true;
+        }
+        return false;
+    }
+    broadcast(message, excludeClientId) {
+        const messageStr = JSON.stringify(message);
+        this.clients.forEach((client, clientId) => {
+            if (clientId !== excludeClientId) {
+                client.socket.send(messageStr);
+            }
+        });
+    }
+    getStats() {
+        return {
+            clients: this.clients.size,
+            topics: Array.from(this.topics.entries()).map(([topic, clients]) => ({
+                topic,
+                subscribers: clients.size,
+            })),
+        };
+    }
+}
+exports.WebSocketServer = WebSocketServer;
+//# sourceMappingURL=server.js.map

package/dist/utils/socket/server.js.map

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

package/dist/utils/socket/service.d.ts

@@ -0,0 +1,20 @@
+import { IWebSocketService } from '../../types/ws';
+import { WebSocketServer } from './server';
+export declare class WebSocketService implements IWebSocketService {
+    private static instance;
+    private wss;
+    private constructor();
+    static getInstance(): WebSocketService;
+    initialize(wss: WebSocketServer): void;
+    sendToClient(clientId: string, message: any): boolean;
+    publishToTopic(topic: string, data: any, exclude?: string[]): void;
+    broadcast(message: any, excludeClientId?: string): void;
+    getStats(): {
+        clients: number;
+        topics: {
+            topic: string;
+            subscribers: number;
+        }[];
+    };
+    isAvailable(): boolean;
+}

package/dist/utils/socket/service.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketService = void 0;
+class WebSocketService {
+    static instance;
+    wss = null;
+    constructor() { }
+    static getInstance() {
+        if (!WebSocketService.instance) {
+            WebSocketService.instance = new WebSocketService();
+        }
+        return WebSocketService.instance;
+    }
+    initialize(wss) {
+        this.wss = wss;
+    }
+    sendToClient(clientId, message) {
+        if (!this.wss)
+            return false;
+        return this.wss.sendToClient(clientId, message);
+    }
+    publishToTopic(topic, data, exclude) {
+        if (!this.wss)
+            return;
+        this.wss.publishToTopic(topic, data, exclude);
+    }
+    broadcast(message, excludeClientId) {
+        if (!this.wss)
+            return;
+        this.wss.broadcast(message, excludeClientId);
+    }
+    getStats() {
+        if (!this.wss)
+            return { clients: 0, topics: [] };
+        return this.wss.getStats();
+    }
+    isAvailable() {
+        return this.wss !== null;
+    }
+}
+exports.WebSocketService = WebSocketService;
+//# sourceMappingURL=service.js.map

package/dist/utils/socket/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/utils/socket/service.ts"],"names":[],"mappings":";;;AAGA,MAAa,gBAAgB;IACnB,MAAM,CAAC,QAAQ,CAAmB;IAClC,GAAG,GAA2B,IAAI,CAAC;IAE3C,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;YAC/B,gBAAgB,CAAC,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,gBAAgB,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,UAAU,CAAC,GAAoB;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,YAAY,CAAC,QAAgB,EAAE,OAAY;QACzC,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,KAAa,EAAE,IAAS,EAAE,OAAkB;QACzD,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO;QACtB,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,SAAS,CAAC,OAAY,EAAE,eAAwB;QAC9C,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO;QACtB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC;IAC3B,CAAC;CACF;AAxCD,4CAwCC"}

package/dist/utils/socket/socket.d.ts

@@ -0,0 +1,16 @@
+import { WebSocketServer } from './server';
+export declare class Socket {
+    protected wss: WebSocketServer;
+    registerWebSocketControllers(controllers: any[]): this;
+    sendToClient(clientId: string, message: any): boolean;
+    publishToTopic(topic: string, data: any): void;
+    broadcast(message: any, excludeClientId?: string): void;
+    getWebSocketStats(): {
+        clients: number;
+        topics: {
+            topic: string;
+            subscribers: number;
+        }[];
+    };
+    isWebSocketAvailable(): boolean;
+}

package/dist/utils/socket/socket.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Socket = void 0;
+const service_1 = require("./service");
+class Socket {
+    wss;
+    registerWebSocketControllers(controllers) {
+        if (!this.wss) {
+            console.warn('⚠️ WebSocket is disabled. Enable it in config: { websocket: { enabled: true } }');
+            return this;
+        }
+        this.wss.registerControllers(controllers);
+        console.log(`📝 Registered ${controllers.length} WebSocket controllers`);
+        return this;
+    }
+    sendToClient(clientId, message) {
+        return service_1.WebSocketService.getInstance().sendToClient(clientId, message);
+    }
+    publishToTopic(topic, data) {
+        service_1.WebSocketService.getInstance().publishToTopic(topic, data);
+    }
+    broadcast(message, excludeClientId) {
+        service_1.WebSocketService.getInstance().broadcast(message, excludeClientId);
+    }
+    getWebSocketStats() {
+        return service_1.WebSocketService.getInstance().getStats();
+    }
+    isWebSocketAvailable() {
+        return service_1.WebSocketService.getInstance().isAvailable();
+    }
+}
+exports.Socket = Socket;
+//# sourceMappingURL=socket.js.map

package/dist/utils/socket/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../../src/utils/socket/socket.ts"],"names":[],"mappings":";;;AACA,uCAA6C;AAE7C,MAAa,MAAM;IACP,GAAG,CAAkB;IAExB,4BAA4B,CAAC,WAAkB;QACpD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CACV,iFAAiF,CAClF,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,iBAAiB,WAAW,CAAC,MAAM,wBAAwB,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,YAAY,CAAC,QAAgB,EAAE,OAAY;QAChD,OAAO,0BAAgB,CAAC,WAAW,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAEM,cAAc,CAAC,KAAa,EAAE,IAAS;QAC5C,0BAAgB,CAAC,WAAW,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAEM,SAAS,CAAC,OAAY,EAAE,eAAwB;QACrD,0BAAgB,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACrE,CAAC;IAEM,iBAAiB;QACtB,OAAO,0BAAgB,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;IACnD,CAAC;IAEM,oBAAoB;QACzB,OAAO,0BAAgB,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,CAAC;CACF;AAlCD,wBAkCC"}

package/dist/utils/sse/index.d.ts

@@ -0,0 +1,2 @@
+export * from './server';
+export * from './service';

package/dist/utils/sse/index.js

@@ -0,0 +1,19 @@
+"use strict";
+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 });
+__exportStar(require("./server"), exports);
+__exportStar(require("./service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/sse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/sse/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B"}

package/dist/utils/sse/server.d.ts

@@ -0,0 +1,14 @@
+import { ServerResponse } from 'http';
+import { ControllerType, ISSEServer, SSEClient, SSEMessage } from '../../types/core';
+export declare class SSEServer implements ISSEServer {
+    private clients;
+    controllers: any[];
+    createConnection(res: ServerResponse): SSEClient;
+    sendToClient(clientId: string, message: SSEMessage): boolean;
+    broadcast(message: SSEMessage, excludeClientId?: string): void;
+    getStats(): {
+        clients: number;
+    };
+    registerControllers(controllers: ControllerType[]): void;
+    private triggerHandlers;
+}