@heliosjs/middlewares 4.0.0 → 4.0.3

package/dist/catch.d.ts

@@ -1,4 +1,4 @@
-import { ErorrHandler } from './types/core';
+import { ErrorHandler } from './types/core';
 /**
  * Decorator to register a global or controller-level error handler.
  *
@@ -7,7 +7,7 @@ import { ErorrHandler } from './types/core';
  * It attaches the handler as metadata on the target class, allowing the framework to
  * retrieve and execute the error handler appropriately during runtime.
  *
- * @param {ErorrHandler} handler - The error callback function to handle errors.
+ * @param {ErrorHandler} handler - The error callback function to handle errors.
  *
  * @returns {Function} A class decorator function that defines the error handler metadata.
  *
@@ -26,4 +26,4 @@ import { ErorrHandler } from './types/core';
  * This metadata is accessible via Reflect API and used internally by the framework
  * to invoke the registered error handler when errors occur.
  */
-export declare function Catch(handler: ErorrHandler): (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => void;
+export declare function Catch(handler: ErrorHandler): (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => void;

package/dist/catch.js

@@ -10,7 +10,7 @@ const shared_1 = require("./utils/shared");
  * It attaches the handler as metadata on the target class, allowing the framework to
  * retrieve and execute the error handler appropriately during runtime.
  *
- * @param {ErorrHandler} handler - The error callback function to handle errors.
+ * @param {ErrorHandler} handler - The error callback function to handle errors.
  *
  * @returns {Function} A class decorator function that defines the error handler metadata.
  *

package/dist/interceptor.d.ts

@@ -1,4 +1,4 @@
-import { InterceptorCB } from '@heliosjs/core';
+import { InterceptorCB } from './types/core';
 /**
  * Decorator to register an interceptor at the controller or method level.
  *

package/dist/types/core/controller.d.ts

@@ -1,6 +1,6 @@
 import { HTTP_METHODS, InterceptorCB, MiddlewareCB, ParamMetadata } from './common';
 import { CORSConfig } from './cors';
-import { ErorrHandler } from './error';
+import { ErrorHandler } from './error';
 import { Request } from './request';
 import { Response } from './response';
 import { SanitizerConfig } from './sanitize';
@@ -56,7 +56,7 @@ export type SeeControllerHandlers = {
 };
 export type FunctionsMeta = {
     middlewares: MiddlewareCB[];
-    errors: ErorrHandler[];
+    errors: ErrorHandler[];
     cors: CORSConfig[];
     sanitizers: SanitizerConfig[];
     pipes: Pipe[];
@@ -110,7 +110,7 @@ export interface Guard {
 export type GuardFn = (request: Request, response: Response) => boolean;
 export type MiddlewaresMetadata = {
     middlewares: MiddlewareCB[];
-    errors: ErorrHandler[];
+    errors: ErrorHandler[];
     cors: CORSConfig[];
     sanitizers: SanitizerConfig[];
     pipes: Pipe[];

package/dist/types/core/error.d.ts

@@ -69,7 +69,7 @@ export interface ErrorHandlerConfig {
     logStack?: boolean;
     customHandlers?: Record<ErrorCode, (error: HeliosError) => unknown>;
 }
-export type ErorrHandler = (error: Error, req: Request, response: Response) => unknown;
+export type ErrorHandler = (error: Error, req: Request, response: Response) => unknown;
 type ErrorChildren = {
     property?: string;
     value: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heliosjs/middlewares",
-  "version": "4.0.0",
+  "version": "4.0.3",
   "description": "Core functionality for Quantum Flow",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,7 +30,7 @@
     "reflect-metadata": "^0.2.2"
   },
   "peerDependencies": {
-    "@heliosjs/core": "^2.1.0",
+    "@heliosjs/core": "^2.1.2",
     "typescript": ">=4.0.0"
   }
 }

package/dist/types/ws/index.d.ts

@@ -1,50 +0,0 @@
-import WebSocket from 'ws';
-export type WebSocketHandlerType = 'connection' | 'message' | 'close' | 'error';
-export interface WebSocketEvent {
-    type: WebSocketHandlerType;
-    client: WebSocketClient;
-    message?: WebSocketMessage;
-    data?: unknown;
-}
-export interface WebSocketClient {
-    id: string;
-    socket: WebSocket;
-    topics: Set<string>;
-    data: Record<string, unknown>;
-    connectedAt: Date;
-}
-export interface WebSocketMessage {
-    type: string;
-    topic?: string;
-    data: any;
-    clientId?: string;
-}
-export interface WebSocketStats {
-    clients: number;
-    topics: Array<{
-        topic: string;
-        subscribers: number;
-    }>;
-}
-export interface IWebSocketService {
-    sendToClient(clientId: string, message: unknown): boolean;
-    publishToTopic(topic: string, data: any, exclude?: string[]): void;
-    broadcast(message: unknown, excludeClientId?: string): void;
-    getStats(): {
-        clients: number;
-        topics: Array<{
-            topic: string;
-            subscribers: number;
-        }>;
-    };
-    isAvailable(): boolean;
-}
-export interface IWebSocketServer {
-    sendToClient(clientId: string, message: unknown): boolean;
-    publishToTopic(topic: string, data: any, exclude: string[]): void;
-    broadcast(message: unknown, excludeClientId?: string): void;
-    getStats(): WebSocketStats;
-    subscribeToTopic(client: WebSocketClient, topic: string): void;
-    unsubscribeFromTopic(client: WebSocketClient, topic: string): void;
-    registerControllers(controllers: (new (...args: any[]) => any)[]): void;
-}

package/dist/types/ws/index.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=index.js.map

package/dist/types/ws/index.js.map

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

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

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

package/dist/utils/sse/index.js

@@ -1,19 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,14 +0,0 @@
-import { ServerResponse } from 'node:http';
-import { ControllerType, ISSEServer, SSEClient, SSEMessage } from '../../types/core';
-export declare class SSEServer implements ISSEServer {
-    private readonly 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;
-}

package/dist/utils/sse/server.js

@@ -1,85 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SSEServer = void 0;
-const shared_1 = require("../shared");
-class SSEServer {
-    clients = new Map();
-    controllers = [];
-    createConnection(res) {
-        const clientId = (0, shared_1.generateUniqueId)();
-        res.writeHead(200, {
-            'Content-Type': 'text/event-stream',
-            'Cache-Control': 'no-cache',
-            Connection: 'keep-alive',
-            'Access-Control-Allow-Origin': '*',
-        });
-        res.write(': connected\n\n');
-        const client = {
-            id: clientId,
-            response: res,
-            topics: new Set(),
-            data: {},
-            connectedAt: new Date(),
-        };
-        this.clients.set(clientId, client);
-        this.triggerHandlers('connection', {
-            type: 'connection',
-            client,
-            data: res,
-        });
-        res.on('close', () => {
-            this.clients.delete(clientId);
-            this.triggerHandlers('close', { type: 'close', client });
-        });
-        return client;
-    }
-    sendToClient(clientId, message) {
-        const client = this.clients.get(clientId);
-        if (!client)
-            return false;
-        try {
-            let sseMessage = '';
-            if (message.event)
-                sseMessage += `event: ${message.event}\n`;
-            if (message.id)
-                sseMessage += `id: ${message.id}\n`;
-            if (message.retry)
-                sseMessage += `retry: ${message.retry}\n`;
-            const dataStr = typeof message.data === 'string' ? message.data : JSON.stringify(message.data);
-            dataStr.split('\n').forEach((line) => {
-                sseMessage += `data: ${line}\n`;
-            });
-            sseMessage += '\n';
-            client.response.write(sseMessage);
-            return true;
-        }
-        catch (error) {
-            console.error(`SSE send error to ${clientId}:`, error);
-            return false;
-        }
-    }
-    broadcast(message, excludeClientId) {
-        this.clients.forEach((_, clientId) => {
-            if (clientId !== excludeClientId) {
-                this.sendToClient(clientId, message);
-            }
-        });
-    }
-    getStats() {
-        return { clients: this.clients.size };
-    }
-    registerControllers(controllers) {
-        this.controllers = controllers.filter((c) => c.sse);
-    }
-    async triggerHandlers(eventType, event) {
-        for (const controller of this.controllers) {
-            if (controller.sse.handlers && controller.sse.handlers[eventType]) {
-                for (const handler of controller.sse.handlers[eventType]) {
-                    await handler.fn(event).catch(console.error);
-                }
-            }
-        }
-    }
-}
-exports.SSEServer = SSEServer;
-//# sourceMappingURL=server.js.map

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

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

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

@@ -1,17 +0,0 @@
-import { ServerResponse } from 'http';
-import { ISSEService, SSEClient, SSEMessage } from '../../types/core';
-import { SSEServer } from './server';
-export declare class SSEService implements ISSEService {
-    private static instance;
-    private sse;
-    private constructor();
-    static getInstance(): SSEService;
-    initialize(sse: SSEServer): void;
-    sendToClient(clientId: string, message: SSEMessage): boolean;
-    broadcast(message: SSEMessage, excludeClientId?: string): void;
-    getStats(): {
-        clients: number;
-    };
-    isAvailable(): boolean;
-    createConnection(res: ServerResponse): SSEClient;
-}

package/dist/utils/sse/service.js

@@ -1,40 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SSEService = void 0;
-class SSEService {
-    static instance;
-    sse = null;
-    constructor() { }
-    static getInstance() {
-        if (!SSEService.instance) {
-            SSEService.instance = new SSEService();
-        }
-        return SSEService.instance;
-    }
-    initialize(sse) {
-        this.sse = sse;
-    }
-    sendToClient(clientId, message) {
-        if (!this.sse)
-            return false;
-        return this.sse.sendToClient(clientId, message);
-    }
-    broadcast(message, excludeClientId) {
-        if (!this.sse)
-            return;
-        this.sse.broadcast(message, excludeClientId);
-    }
-    getStats() {
-        if (!this.sse)
-            return { clients: 0 };
-        return this.sse.getStats();
-    }
-    isAvailable() {
-        return this.sse !== null;
-    }
-    createConnection(res) {
-        return this.sse.createConnection(res);
-    }
-}
-exports.SSEService = SSEService;
-//# sourceMappingURL=service.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/utils/sse/service.ts"],"names":[],"mappings":";;;AAIA,MAAa,UAAU;IACb,MAAM,CAAC,QAAQ,CAAa;IAC5B,GAAG,GAAqB,IAAI,CAAC;IAErC,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACzB,UAAU,CAAC,QAAQ,GAAG,IAAI,UAAU,EAAE,CAAC;QACzC,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,GAAc;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,YAAY,CAAC,QAAgB,EAAE,OAAmB;QAChD,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,SAAS,CAAC,OAAmB,EAAE,eAAwB;QACrD,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,CAAC;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC;IAC3B,CAAC;IAED,gBAAgB,CAAC,GAAmB;QAClC,OAAO,IAAI,CAAC,GAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;CACF;AAvCD,gCAuCC"}