@heliosjs/http 1.0.1

package/dist/Application.js

@@ -0,0 +1,269 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpServer = void 0;
+const ws_1 = require("graphql-ws/use/ws");
+const graphql_yoga_1 = require("graphql-yoga");
+const http_1 = __importDefault(require("http"));
+const type_graphql_1 = require("type-graphql");
+const constants_1 = require("./constants");
+const core_1 = require("./utils/core");
+const http_2 = require("./utils/http");
+const socket_1 = require("./utils/socket");
+const sse_1 = require("./utils/sse");
+class HttpServer extends http_2.Plugin {
+    config;
+    isRunning = false;
+    sse;
+    websocket;
+    controllers = [];
+    middlewares = [];
+    app;
+    plugins = [];
+    allContriollers = [];
+    staticMiddlewares = [];
+    constructor(configOrClass) {
+        super();
+        this.config = (0, http_2.resolveConfig)(configOrClass);
+        this.middlewares = this.middlewares.concat(this.config.middlewares ?? []);
+        this.controllers = this.collectControllers(this.config.controllers ?? []);
+        this.app = http_1.default.createServer(this.requestHandler.bind(this));
+        for (const st of this.config.statics ?? []) {
+            const staticMw = (0, http_2.staticMiddleware)(st.path, st.options);
+            this.staticMiddlewares.push(staticMw);
+        }
+        if (this.config.websocket && this.config.graphql) {
+            throw new Error(`You  cant't use custom websocket with graphql`);
+        }
+        if (this.config.websocket) {
+            this.setUpWebsocket();
+        }
+        if (this.config.graphql) {
+            this.setupGraphQL();
+        }
+        if (this.config.sse?.enabled) {
+            this.sse = new sse_1.SSEServer();
+            this.sse.registerControllers(this.controllers);
+            sse_1.SSEService.getInstance().initialize(this.sse);
+        }
+        this.logConfig();
+    }
+    setUpWebsocket() {
+        this.websocket = new socket_1.WebSocketServer(this.app, { path: this.config.websocket?.path ?? '/ws' });
+        this.websocket.registerControllers(this.controllers);
+        socket_1.WebSocketService.getInstance().initialize(this.websocket);
+    }
+    collectControllers(controllers = []) {
+        const result = [];
+        for (const ControllerClass of controllers) {
+            if (typeof ControllerClass !== 'function') {
+                continue;
+            }
+            if (!result.includes(ControllerClass)) {
+                result.push(ControllerClass);
+            }
+            const subControllers = Reflect.getMetadata(constants_1.CONTROLLERS, ControllerClass.prototype) || [];
+            if (subControllers.length > 0) {
+                const nestedControllers = this.collectControllers(subControllers);
+                for (const nested of nestedControllers) {
+                    if (!result.includes(nested)) {
+                        result.push(nested);
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    logConfig() {
+        console.log(`
+╔════════════════════════════════════════╗
+║  🚀 Server Configuration               
+╠════════════════════════════════════════╣
+║  📍 Host: ${this.config.host}                       
+║  🔌 Port: ${this.config.port}                         
+║  🔌 Websocket: ${!!this.config.websocket && this.config.graphql?.pubSub}                         
+║  🔌 Websocket path prefix: ${this.config.websocket?.path ?? '/ws'}                       
+║  🔧 Global Middlewares: ${this.middlewares?.length || 0}                   
+║  🔧 Error handler: ${!this.config.errorHandler}                   
+║  🎯 Global Interceptors: ${!!this.config.interceptor?.length}                   
+║  📦 Root controllers: ${this.config.controllers?.length ?? 0}                   
+║  📦 Sub controllers: ${this.controllers.length - (this.config.controllers?.length ?? 0)}                                    
+║  📦 GraphQL resolvers: ${this.config.graphql?.resolvers?.length ?? 0}                   
+╚════════════════════════════════════════╝
+    `);
+    }
+    async listen(port, host) {
+        if (this.isRunning) {
+            return this.app;
+        }
+        const listenPort = port || this.config.port || 3000;
+        const listenHost = host || this.config.host || 'localhost';
+        return new Promise(async (resolve, reject) => {
+            try {
+                this.app.listen(listenPort, listenHost, () => {
+                    this.isRunning = true;
+                    console.log(`
+╔════════════════════════════════════════╗
+║  🎉 Server started successfully!       
+║  📍 http://${listenHost}:${listenPort}  
+║  📊 Status: RUNNING                    
+╚════════════════════════════════════════╝
+          `);
+                    resolve(this.app);
+                });
+                await this.callPluginMethod('onStart', this.app);
+                this.app.on('error', (error) => {
+                    reject(error);
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    async close() {
+        return new Promise((resolve, reject) => {
+            if (!this.isRunning) {
+                resolve();
+                return;
+            }
+            this.app.close(async (err) => {
+                await this.callPluginMethod('onStop', this.app);
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    this.isRunning = false;
+                    resolve();
+                }
+            });
+        });
+    }
+    status() {
+        return { running: this.isRunning, config: this.config };
+    }
+    async requestHandler(req, res) {
+        const startTime = Date.now();
+        const request = await http_2.RequestFactory.create(req);
+        const response = http_2.ResponseFactory.create(res, request);
+        try {
+            await this.callPluginHook('beforeRequest', req);
+        }
+        catch (error) {
+            response.status = 500;
+            response.data = error;
+            return this.sendResponse(request, response, startTime);
+        }
+        if (response.headersSent)
+            return;
+        try {
+            let handledCors = this.config.cors
+                ? (0, core_1.handleCORS)(request, response, this.config.cors)
+                : { permitted: true, continue: true };
+            if (!handledCors.permitted) {
+                response.status = 403;
+                response.data = 'CORS: Origin not allowed';
+                return this.sendResponse(request, response, startTime);
+            }
+            if (!handledCors.continue && handledCors.permitted) {
+                response.status = 204;
+                return this.sendResponse(request, response, startTime);
+            }
+            await this.beforeRequest(request, response);
+            if (response.headersSent)
+                return;
+            await this.callPluginHook('beforeRoute', request, response);
+            if (response.headersSent)
+                return;
+            await this.runController(request, response);
+            return this.sendResponse(request, response, startTime);
+        }
+        catch (error) {
+            response.error(error);
+            return this.sendResponse(request, response, startTime);
+        }
+    }
+    async beforeRequest(request, response) {
+        (0, core_1.sanitizeRequest)(request, this.config.sanitizers ?? []);
+        for (const middleware of this.staticMiddlewares) {
+            await middleware(request.raw, response.raw, core_1.NextFunction);
+        }
+        if (response.raw.headersSent) {
+            return;
+        }
+        for (const middleware of this.middlewares?.reverse() || []) {
+            await middleware(request, response, core_1.NextFunction);
+        }
+    }
+    async runController(request, response) {
+        for (const ControllerClass of this.controllers ?? []) {
+            const instance = new ControllerClass();
+            if (typeof instance.handleRequest === 'function') {
+                const done = await instance.handleRequest(request, response);
+                if (done) {
+                    break;
+                }
+            }
+        }
+    }
+    async sendResponse(request, response, startTime) {
+        if (response.headersSent)
+            return;
+        if (!response.getHeader('Content-Type')) {
+            response.setHeader('Content-Type', 'application/json');
+        }
+        response.setHeader('X-Response-Time', `${Date.now() - startTime}ms`);
+        try {
+            response.end(response.data);
+            await this.callPluginHook('afterResponse', request, response);
+        }
+        catch (err) {
+            response.status = 500;
+            response.error(err);
+            response.end(err);
+        }
+    }
+    async setupGraphQL() {
+        if (!this.config.graphql || !this.config.graphql?.resolvers?.length)
+            return;
+        const graphqlWsServer = new socket_1.WebSocketServer(this.app, {
+            path: this.config.graphql.path ?? '/graphql',
+        });
+        const schemaConfig = {
+            resolvers: this.config.graphql?.resolvers,
+            validate: true,
+        };
+        if (this.config.graphql.pubSub) {
+            Object.assign(schemaConfig, { pubSub: this.config.graphql.pubSub });
+        }
+        const schema = await (0, type_graphql_1.buildSchema)(schemaConfig);
+        const yoga = (0, graphql_yoga_1.createYoga)({
+            schema,
+            context: (ctx) => {
+                const req = ctx.request ?? ctx.req;
+                return {
+                    request: req.raw,
+                    headers: req?.headers,
+                    pubSub: this.config.graphql?.pubSub ?? (0, graphql_yoga_1.createPubSub)(),
+                };
+            },
+            graphiql: !!this.config.graphql?.playground,
+        });
+        if (this.config.graphql.pubSub) {
+            (0, ws_1.useServer)({ schema, context: () => ({ pubSub: this.config.graphql?.pubSub }) }, graphqlWsServer.wss);
+            this.use(async (req, res) => {
+                if (req.requestUrl.pathname?.startsWith('/graphql')) {
+                    await yoga(req.raw, res.raw);
+                }
+            });
+        }
+    }
+    use(middleware) {
+        this.middlewares.unshift(middleware);
+        return this;
+    }
+}
+exports.HttpServer = HttpServer;
+//# sourceMappingURL=Application.js.map

package/dist/Application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Application.js","sourceRoot":"","sources":["../src/Application.ts"],"names":[],"mappings":";;;;;;AAAA,0CAA8C;AAC9C,+CAAwD;AACxD,gDAA6D;AAC7D,+CAA0D;AAC1D,2CAA0C;AAG1C,uCAAyE;AACzE,uCAMsB;AACtB,2CAAmE;AACnE,qCAAoD;AAEpD,MAAa,UAAW,SAAQ,aAAM;IAC5B,MAAM,CAAe;IACrB,SAAS,GAAY,KAAK,CAAC;IAC3B,GAAG,CAAa;IAChB,SAAS,CAAmB;IACpC,WAAW,GAAqB,EAAE,CAAC;IACnC,WAAW,GAAmB,EAAE,CAAC;IACjC,GAAG,CAAc;IACjB,OAAO,GAAiB,EAAE,CAAC;IAC3B,eAAe,GAAqB,EAAE,CAAC;IACvC,iBAAiB,GAAQ,EAAE,CAAC;IAE5B,YAAY,aAA0C;QACpD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAA,oBAAa,EAAC,aAAa,CAAC,CAAC;QAE3C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QAE1E,IAAI,CAAC,GAAG,GAAG,cAAI,CAAC,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE7D,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAC3C,MAAM,QAAQ,GAAG,IAAA,uBAAgB,EAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,GAAG,IAAI,eAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC/C,gBAAU,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAe,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QAC/F,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrD,yBAAgB,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAU,CAAC,CAAC;IAC7D,CAAC;IAEO,kBAAkB,CAAC,cAAgC,EAAE;QAC3D,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,KAAK,MAAM,eAAe,IAAI,WAAW,EAAE,CAAC;YAC1C,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;gBAC1C,SAAS;YACX,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC/B,CAAC;YACD,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,uBAAW,EAAE,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAEzF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,iBAAiB,GAAG,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;gBAClE,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;oBACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACtB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,SAAS;QACf,OAAO,CAAC,GAAG,CAAC;;;;cAIF,IAAI,CAAC,MAAM,CAAC,IAAI;cAChB,IAAI,CAAC,MAAM,CAAC,IAAI;mBACX,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM;+BAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,IAAI,KAAK;4BACvC,IAAI,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;uBAClC,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY;6BACnB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM;0BACpC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;yBACrC,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC;2BAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;;KAEjE,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,IAAa,EAAE,IAAa;QAC9C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,GAAG,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;QACpD,MAAM,UAAU,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC;QAE3D,OAAO,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE;oBAC3C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;oBACtB,OAAO,CAAC,GAAG,CAAC;;;eAGP,UAAU,IAAI,UAAU;;;WAG5B,CAAC,CAAC;oBAEH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC,CAAC,CAAC;gBAEH,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEjD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBAC7B,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChB,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAC3B,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChD,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;oBACvB,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM;QACX,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,GAAoB,EAAE,GAAmB;QACpE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,OAAO,GAAG,MAAM,qBAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,sBAAe,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEtD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;YACtB,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC;YACtB,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,QAAQ,CAAC,WAAW;YAAE,OAAO;QAEjC,IAAI,CAAC;YACH,IAAI,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI;gBAChC,CAAC,CAAC,IAAA,iBAAU,EAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACjD,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAExC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;gBAC3B,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;gBACtB,QAAQ,CAAC,IAAI,GAAG,0BAA0B,CAAC;gBAC3C,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YACzD,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;gBACnD,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;gBACtB,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YACzD,CAAC;YAED,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAE5C,IAAI,QAAQ,CAAC,WAAW;gBAAE,OAAO;YACjC,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC5D,IAAI,QAAQ,CAAC,WAAW;gBAAE,OAAO;YAEjC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAE5C,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,OAAiB,EAAE,QAAmB;QAChE,IAAA,sBAAe,EAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAEvD,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAChD,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,mBAAY,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QACD,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YAC3D,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,mBAAY,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,OAAiB,EAAE,QAAmB;QAChE,KAAK,MAAM,eAAe,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;YACvC,IAAI,OAAO,QAAQ,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;gBACjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC7D,IAAI,IAAI,EAAE,CAAC;oBACT,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,OAAiB,EACjB,QAAmB,EACnB,SAAiB;QAEjB,IAAI,QAAQ,CAAC,WAAW;YAAE,OAAO;QAEjC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YACxC,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACzD,CAAC;QAED,QAAQ,CAAC,SAAS,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;YACtB,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM;YAAE,OAAO;QAE5E,MAAM,eAAe,GAAG,IAAI,wBAAe,CAAC,IAAI,CAAC,GAAG,EAAE;YACpD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU;SAC7C,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG;YACnB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,SAAoC;YACpE,QAAQ,EAAE,IAAI;SACf,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAW,EAAC,YAAY,CAAC,CAAC;QAE/C,MAAM,IAAI,GAAG,IAAA,yBAAU,EAAC;YACtB,MAAM;YACN,OAAO,EAAE,CAAC,GAAQ,EAAE,EAAE;gBACpB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,IAAK,GAAW,CAAC,GAAG,CAAC;gBAE5C,OAAO;oBACL,OAAO,EAAE,GAAG,CAAC,GAAG;oBAChB,OAAO,EAAE,GAAG,EAAE,OAAO;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,IAAA,2BAAY,GAAE;iBACtD,CAAC;YACJ,CAAC;YACD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU;SAC5C,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAA,cAAS,EACP,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,EACpE,eAAe,CAAC,GAAG,CACpB,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;gBAC1B,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBACpD,MAAM,IAAI,CAAC,GAAG,CAAC,GAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEM,GAAG,CAAC,UAAwB;QACjC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAvSD,gCAuSC"}

package/dist/constants.d.ts

@@ -0,0 +1,25 @@
+export declare const PARAM_METADATA_KEY = "design:parameters";
+export declare const APP_METADATA_KEY = "app:configuration";
+export declare const ROUTE_PREFIX = "route:prefix";
+export declare const ROUTE_MIDDLEWARES = "route:middlewares";
+export declare const MIDDLEWARES = "controller:middlewares";
+export declare const CONTROLLERS = "app:controllers";
+export declare const INTERCEPTOR = "app:interceptors";
+export declare const ENDPOINT = "route:endpoints";
+export declare const OK_METADATA_KEY = "custom:ok";
+export declare const SERVER_CONFIG_KEY = "server:config";
+export declare const USE_MIDDLEWARE = "controller:usemiddleware";
+export declare const WS_HANDLER = "websocket:handler";
+export declare const WS_TOPIC_KEY = "websocket:topic";
+export declare const WS_SERVICE_KEY = "websocket:service";
+export declare const INTECEPT = "server:intercept";
+export declare const CATCH = "server:catch";
+export declare const SANITIZE = "action:sanitize";
+export declare const STOPPED = "\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551  \uD83D\uDC4B Server stopped                      \u2551\n\u2551  \uD83D\uDCCA Status: STOPPED                      \u2551\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D\n          ";
+export declare const OK_STATUSES: number[];
+export declare const TO_VALIDATE: string[];
+export declare const CORS_METADATA = "cors:config";
+export declare const SSE_METADATA_KEY = "sse:handlers";
+export declare const SSE_TOPIC_KEY = "sse:topics";
+export declare const SSE_SERVICE_KEY = "sse:service";
+export declare const STATIC_METADATA_KEY = "static:config";

package/dist/constants.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STATIC_METADATA_KEY = exports.SSE_SERVICE_KEY = exports.SSE_TOPIC_KEY = exports.SSE_METADATA_KEY = exports.CORS_METADATA = exports.TO_VALIDATE = exports.OK_STATUSES = exports.STOPPED = exports.SANITIZE = exports.CATCH = exports.INTECEPT = exports.WS_SERVICE_KEY = exports.WS_TOPIC_KEY = exports.WS_HANDLER = exports.USE_MIDDLEWARE = exports.SERVER_CONFIG_KEY = exports.OK_METADATA_KEY = exports.ENDPOINT = exports.INTERCEPTOR = exports.CONTROLLERS = exports.MIDDLEWARES = exports.ROUTE_MIDDLEWARES = exports.ROUTE_PREFIX = exports.APP_METADATA_KEY = exports.PARAM_METADATA_KEY = void 0;
+exports.PARAM_METADATA_KEY = 'design:parameters';
+exports.APP_METADATA_KEY = 'app:configuration';
+exports.ROUTE_PREFIX = 'route:prefix';
+exports.ROUTE_MIDDLEWARES = 'route:middlewares';
+exports.MIDDLEWARES = 'controller:middlewares';
+exports.CONTROLLERS = 'app:controllers';
+exports.INTERCEPTOR = 'app:interceptors';
+exports.ENDPOINT = 'route:endpoints';
+exports.OK_METADATA_KEY = 'custom:ok';
+exports.SERVER_CONFIG_KEY = 'server:config';
+exports.USE_MIDDLEWARE = 'controller:usemiddleware';
+exports.WS_HANDLER = 'websocket:handler';
+exports.WS_TOPIC_KEY = 'websocket:topic';
+exports.WS_SERVICE_KEY = 'websocket:service';
+exports.INTECEPT = 'server:intercept';
+exports.CATCH = 'server:catch';
+exports.SANITIZE = 'action:sanitize';
+exports.STOPPED = `
+╔════════════════════════════════════════╗
+║  👋 Server stopped                      ║
+║  📊 Status: STOPPED                      ║
+╚════════════════════════════════════════╝
+          `;
+exports.OK_STATUSES = [200, 201, 202, 203, 204, 205, 206, 207, 208, 226];
+exports.TO_VALIDATE = ['headers', 'params', 'multipart', 'query', 'body'];
+exports.CORS_METADATA = 'cors:config';
+exports.SSE_METADATA_KEY = 'sse:handlers';
+exports.SSE_TOPIC_KEY = 'sse:topics';
+exports.SSE_SERVICE_KEY = 'sse:service';
+exports.STATIC_METADATA_KEY = 'static:config';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,kBAAkB,GAAG,mBAAmB,CAAC;AACzC,QAAA,gBAAgB,GAAG,mBAAmB,CAAC;AACvC,QAAA,YAAY,GAAG,cAAc,CAAC;AAC9B,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AACxC,QAAA,WAAW,GAAG,wBAAwB,CAAC;AACvC,QAAA,WAAW,GAAG,iBAAiB,CAAC;AAChC,QAAA,WAAW,GAAG,kBAAkB,CAAC;AACjC,QAAA,QAAQ,GAAG,iBAAiB,CAAC;AAC7B,QAAA,eAAe,GAAG,WAAW,CAAC;AAE9B,QAAA,iBAAiB,GAAG,eAAe,CAAC;AACpC,QAAA,cAAc,GAAG,0BAA0B,CAAC;AAE5C,QAAA,UAAU,GAAG,mBAAmB,CAAC;AACjC,QAAA,YAAY,GAAG,iBAAiB,CAAC;AACjC,QAAA,cAAc,GAAG,mBAAmB,CAAC;AACrC,QAAA,QAAQ,GAAG,kBAAkB,CAAC;AAC9B,QAAA,KAAK,GAAG,cAAc,CAAC;AACvB,QAAA,QAAQ,GAAG,iBAAiB,CAAC;AAE7B,QAAA,OAAO,GAAG;;;;;WAKZ,CAAC;AAEC,QAAA,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACjE,QAAA,WAAW,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAElE,QAAA,aAAa,GAAG,aAAa,CAAC;AAC9B,QAAA,gBAAgB,GAAG,cAAc,CAAC;AAClC,QAAA,aAAa,GAAG,YAAY,CAAC;AAC7B,QAAA,eAAe,GAAG,aAAa,CAAC;AAChC,QAAA,mBAAmB,GAAG,eAAe,CAAC"}

package/dist/decorators.d.ts

@@ -0,0 +1,43 @@
+import { ServerConfig } from './types/http';
+/**
+ * Class decorator to configure the server with the given options.
+ *
+ * @param {ServerConfig} config - Configuration options for the server.
+ *
+ * Usage:
+ * ```ts
+ * @Server({ port: 3000, controllers: [...], middlewares: [...] })
+ * class MyServer {}
+ * ```
+ *
+ * This decorator merges the provided configuration with any existing metadata on the target class.
+ */
+export declare function Server(config?: ServerConfig): (target: any) => any;
+/**
+ * Class decorator to set the port number for the server.
+ *
+ * @param {number} port - The port number to listen on.
+ *
+ * Usage:
+ * ```ts
+ * @Port(8080)
+ * class MyServer {}
+ * ```
+ *
+ * This decorator updates the server metadata with the specified port.
+ */
+export declare function Port(port: number): (target: any) => any;
+/**
+ * Class decorator to set the host for the server.
+ *
+ * @param {string} host - The hostname or IP address to bind the server.
+ *
+ * Usage:
+ * ```ts
+ * @Host('localhost')
+ * class MyServer {}
+ * ```
+ *
+ * This decorator updates the server metadata with the specified host.
+ */
+export declare function Host(host: string): (target: any) => any;

package/dist/decorators.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Server = Server;
+exports.Port = Port;
+exports.Host = Host;
+const constants_1 = require("./constants");
+/**
+ * Class decorator to configure the server with the given options.
+ *
+ * @param {ServerConfig} config - Configuration options for the server.
+ *
+ * Usage:
+ * ```ts
+ * @Server({ port: 3000, controllers: [...], middlewares: [...] })
+ * class MyServer {}
+ * ```
+ *
+ * This decorator merges the provided configuration with any existing metadata on the target class.
+ */
+function Server(config = {}) {
+    return function (target) {
+        const existingConfig = Reflect.getMetadata(constants_1.SERVER_CONFIG_KEY, target) || {};
+        const mergedConfig = {
+            ...existingConfig,
+            ...config,
+            controllers: [...(existingConfig.controllers || []), ...(config.controllers || [])],
+            middlewares: [...(existingConfig.middlewares ?? []), ...(config.middlewares ?? [])],
+            cors: config.cors,
+            interceptors: existingConfig.interceptor ?? config.interceptor,
+        };
+        Reflect.defineMetadata(constants_1.SERVER_CONFIG_KEY, mergedConfig, target);
+        return target;
+    };
+}
+/**
+ * Class decorator to set the port number for the server.
+ *
+ * @param {number} port - The port number to listen on.
+ *
+ * Usage:
+ * ```ts
+ * @Port(8080)
+ * class MyServer {}
+ * ```
+ *
+ * This decorator updates the server metadata with the specified port.
+ */
+function Port(port) {
+    return function (target) {
+        const existingConfig = Reflect.getMetadata(constants_1.SERVER_CONFIG_KEY, target) || {};
+        Reflect.defineMetadata(constants_1.SERVER_CONFIG_KEY, {
+            ...existingConfig,
+            port,
+        }, target);
+        return target;
+    };
+}
+/**
+ * Class decorator to set the host for the server.
+ *
+ * @param {string} host - The hostname or IP address to bind the server.
+ *
+ * Usage:
+ * ```ts
+ * @Host('localhost')
+ * class MyServer {}
+ * ```
+ *
+ * This decorator updates the server metadata with the specified host.
+ */
+function Host(host) {
+    return function (target) {
+        const existingConfig = Reflect.getMetadata(constants_1.SERVER_CONFIG_KEY, target) || {};
+        Reflect.defineMetadata(constants_1.SERVER_CONFIG_KEY, {
+            ...existingConfig,
+            host,
+        }, target);
+        return target;
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":";;AAgBA,wBAiBC;AAeD,oBAeC;AAeD,oBAeC;AA7FD,2CAAgD;AAGhD;;;;;;;;;;;;GAYG;AACH,SAAgB,MAAM,CAAC,SAAuB,EAAE;IAC9C,OAAO,UAAU,MAAW;QAC1B,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,6BAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAE5E,MAAM,YAAY,GAAG;YACnB,GAAG,cAAc;YACjB,GAAG,MAAM;YACT,WAAW,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YACnF,WAAW,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,WAAW,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;YACnF,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,YAAY,EAAE,cAAc,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;SAC/D,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,6BAAiB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAEhE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,IAAI,CAAC,IAAY;IAC/B,OAAO,UAAU,MAAW;QAC1B,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,6BAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAE5E,OAAO,CAAC,cAAc,CACpB,6BAAiB,EACjB;YACE,GAAG,cAAc;YACjB,IAAI;SACL,EACD,MAAM,CACP,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,IAAI,CAAC,IAAY;IAC/B,OAAO,UAAU,MAAW;QAC1B,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,6BAAiB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAE5E,OAAO,CAAC,cAAc,CACpB,6BAAiB,EACjB;YACE,GAAG,cAAc;YACjB,IAAI;SACL,EACD,MAAM,CACP,CAAC;QAEF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import 'reflect-metadata';
+export * from './Application';
+export * from './decorators';
+export * from './socket';
+export * from './sse';
+export { ISSEService } from './types/core';
+export { Plugin } from './types/http';
+export { IWebSocketService, WebSocketEvent } from './types/ws';

package/dist/index.js

@@ -0,0 +1,22 @@
+"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 });
+require("reflect-metadata");
+__exportStar(require("./Application"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./socket"), exports);
+__exportStar(require("./sse"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,2CAAyB;AACzB,wCAAsB"}

package/dist/socket/decorators.d.ts

@@ -0,0 +1,77 @@
+import { WebSocketHandlerType } from '../types/ws';
+/**
+ * Method decorator to handle WebSocket events.
+ *
+ * @param {WebSocketHandlerType} type - Type of WebSocket event (connection, message, close, error).
+ * @param {string} [topic] - Optional topic for message filtering.
+ *
+ * Usage:
+ * ```ts
+ * @OnWS('message', 'chat')
+ * onMessage(msg) {}
+ * ```
+ */
+export declare function OnWS(type: WebSocketHandlerType, topic?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Shortcut decorator for WebSocket connection event handler.
+ *
+ * Usage:
+ * ```ts
+ * @OnConnection()
+ * onConnect() {}
+ * ```
+ */
+export declare function OnConnection(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Shortcut decorator for WebSocket message event handler.
+ *
+ * @param {string} [topic] - Optional topic for message filtering.
+ *
+ * Usage:
+ * ```ts
+ * @OnMessage('chat')
+ * onChatMessage(msg) {}
+ * ```
+ */
+export declare function OnMessage(topic?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Shortcut decorator for WebSocket close event handler.
+ *
+ * Usage:
+ * ```ts
+ * @OnClose()
+ * onClose() {}
+ * ```
+ */
+export declare function OnClose(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Shortcut decorator for WebSocket error event handler.
+ *
+ * Usage:
+ * ```ts
+ * @OnError()
+ * onError() {}
+ * ```
+ */
+export declare function OnError(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Method decorator to subscribe to a WebSocket topic.
+ *
+ * @param {string} topic - Topic name to subscribe.
+ *
+ * Usage:
+ * ```ts
+ * @Subscribe('news')
+ * onNews(data) {}
+ * ```
+ */
+export declare function Subscribe(topic: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Parameter decorator to inject WebSocket service instance.
+ *
+ * Usage:
+ * ```ts
+ * someMethod(@InjectWS() ws) {}
+ * ```
+ */
+export declare function InjectWS(): (target: any, propertyKey: string | symbol, parameterIndex: number) => void;