quantum-flow 1.0.5 → 1.1.0

package/dist/core/Controller.js

@@ -27,21 +27,19 @@ require("reflect-metadata");
  * @returns A class decorator function that enhances the controller class.
  */
 function Controller(config, middlewares = []) {
+    (0, _constants_1.INCREMENT_STATISTIC)('controllers');
     // Handle both string and config object
     const routePrefix = typeof config === 'string' ? config : config.prefix;
     const controllers = typeof config === 'object' ? config.controllers : undefined;
     const controllerMiddlewares = typeof config === 'object' ? [...(config.middlewares || []), ...middlewares] : middlewares;
-    const interceptors = typeof config === 'object'
-        ? config.interceptors
-            ? [].concat(config.interceptors)
-            : []
-        : [];
+    let interceptor = typeof config === 'object' && typeof config.interceptor === 'function' && config.interceptor;
     return function (constructor) {
         const proto = constructor.prototype;
+        Reflect.defineMetadata('controller:name', constructor.name, proto);
         Reflect.defineMetadata(_constants_1.ROUTE_PREFIX, routePrefix, proto);
         Reflect.defineMetadata(_constants_1.MIDDLEWARES, controllerMiddlewares, proto);
         Reflect.defineMetadata(_constants_1.CONTROLLERS, controllers || [], proto);
-        Reflect.defineMetadata(_constants_1.INTERCEPTORS, interceptors, proto);
+        Reflect.defineMetadata(_constants_1.INTERCEPTOR, interceptor, proto);
         for (const key of Object.getOwnPropertyNames(proto)) {
             if (key === 'constructor')
                 continue;
@@ -73,12 +71,13 @@ function Controller(config, middlewares = []) {
             }
             async getResponse(data) {
                 try {
-                    let response = await this.executeControllerMethod(data.controllerInstance, data.name, data.payload, data.response);
-                    let status = response.status ?? 200;
+                    let appResponse = await this.executeControllerMethod(data.controllerInstance, data.name, data.payload, data.request, data.response);
+                    let status = appResponse.status ?? 200;
                     const isError = !_constants_1.OK_STATUSES.includes(status);
-                    for (let index = 0; index < data.interceptors?.length && !isError; index++) {
-                        const interceptor = data.interceptors[index];
-                        response = await interceptor(response);
+                    const interceptors = data.interceptors.reverse();
+                    for (let index = 0; index < interceptors?.length && !isError; index++) {
+                        const interceptor = interceptors[index];
+                        appResponse = await interceptor(appResponse, data.request, data.response);
                     }
                     const propertyName = data.name;
                     const prototype = Object.getPrototypeOf(data.controllerInstance);
@@ -90,91 +89,148 @@ function Controller(config, middlewares = []) {
                         const classOkStatus = Reflect.getMetadata(_constants_1.OK_METADATA_KEY, prototype);
                         !isError && classOkStatus && (status = classOkStatus);
                     }
-                    return { status, data: response };
+                    return { status, data: appResponse };
                 }
                 catch (err) {
                     console.error(err);
                     throw err;
                 }
             }
-            handleRequest = async (request, response) => {
-                const method = request.method;
-                const path = (request.url.path ?? request.url.pathname ?? '').replace(/^\/+/g, '');
-                const baseInterceptors = Reflect.getMetadata(_constants_1.INTERCEPTORS, proto);
-                const routePrefix = Reflect.getMetadata(_constants_1.ROUTE_PREFIX, proto) || '';
-                const middlewares = Reflect.getMetadata(_constants_1.MIDDLEWARES, proto) || [];
-                const subControllers = Reflect.getMetadata(_constants_1.CONTROLLERS, proto) || [];
-                // Try sub-controllers
-                for (const SubController of subControllers) {
-                    const controllerInstance = new SubController(SubController);
-                    if (!controllerInstance)
-                        continue;
-                    const subInterceptors = Reflect.getMetadata(_constants_1.INTERCEPTORS, controllerInstance);
-                    const controllerPrefix = Reflect.getMetadata(_constants_1.ROUTE_PREFIX, SubController.prototype) || '';
-                    const controllerMiddlewares = Reflect.getMetadata(_constants_1.MIDDLEWARES, SubController.prototype) || [];
-                    const methods = this.getControllerMethods(controllerInstance);
-                    for (const methodInfo of methods) {
-                        if (methodInfo.httpMethod === method || methodInfo.httpMethod === 'USE') {
-                            // Build full pattern: main prefix + controller prefix + method pattern
-                            const fullPattern = [routePrefix, controllerPrefix, methodInfo.pattern]
-                                .filter(Boolean)
-                                .join('/')
-                                .replace(/\/+ /g, '/');
-                            const pathParams = (0, _utils_1.matchRoute)(fullPattern, path);
-                            if (pathParams) {
-                                let payload = { ...request, params: pathParams };
-                                // Apply all middlewares in order: main controller -> sub-controller -> method
-                                for (const middleware of [
-                                    ...middlewares,
-                                    ...controllerMiddlewares,
-                                    ...(methodInfo.middlewares || []),
-                                ]) {
-                                    const middlawareResponde = await middleware(payload, response);
-                                    payload = { ...payload, ...middlawareResponde };
-                                }
-                                return this.getResponse({
-                                    interceptors: [...subInterceptors, ...baseInterceptors],
-                                    controllerInstance,
-                                    name: methodInfo.name,
-                                    payload,
-                                    response,
-                                });
-                            }
+            handleRequest = async (appRequest, request, response) => {
+                const context = {
+                    controllerInstance: this,
+                    controllerMeta: {
+                        routePrefix: Reflect.getMetadata(_constants_1.ROUTE_PREFIX, proto) || '',
+                        middlewares: Reflect.getMetadata(_constants_1.MIDDLEWARES, proto) || [],
+                        interceptor: Reflect.getMetadata(_constants_1.INTERCEPTOR, proto),
+                        subControllers: Reflect.getMetadata(_constants_1.CONTROLLERS, proto) || [],
+                        errorHandler: Reflect.getMetadata(_constants_1.CATCH, proto),
+                    },
+                    path: (appRequest.url.pathname ?? '').replace(/^\/+/g, ''),
+                    method: appRequest.method.toUpperCase(),
+                    appRequest,
+                    request,
+                    response,
+                    middlewareChain: [],
+                    interceptorChain: [],
+                    subPath: Reflect.getMetadata(_constants_1.ROUTE_PREFIX, proto) || '',
+                };
+                const result = await this.routeWalker(context);
+                return result || { status: 404, message: 'Method Not Found' };
+            };
+            async routeWalker(context) {
+                const { controllerInstance, controllerMeta, path, method, subPath } = context;
+                for (const SubController of controllerMeta.subControllers) {
+                    const subInstance = new SubController();
+                    const subMeta = {
+                        routePrefix: Reflect.getMetadata(_constants_1.ROUTE_PREFIX, SubController.prototype) || '',
+                        middlewares: Reflect.getMetadata(_constants_1.MIDDLEWARES, SubController.prototype) || [],
+                        interceptor: Reflect.getMetadata(_constants_1.INTERCEPTOR, SubController.prototype),
+                        errorHandler: Reflect.getMetadata(_constants_1.CATCH, SubController.prototype),
+                        subControllers: Reflect.getMetadata(_constants_1.CONTROLLERS, SubController.prototype) || [],
+                    };
+                    const fullSubPath = [subPath, subMeta.routePrefix]
+                        .filter(Boolean)
+                        .join('/')
+                        .replace(/\/+/g, '/');
+                    if (path.startsWith(fullSubPath)) {
+                        const subResult = await this.routeWalker({
+                            ...context,
+                            subPath: fullSubPath,
+                            controllerInstance: subInstance,
+                            controllerMeta: subMeta,
+                            path,
+                            middlewareChain: [...context.middlewareChain, ...controllerMeta.middlewares],
+                            interceptorChain: [...context.interceptorChain, controllerMeta.interceptor].filter((el) => !!el),
+                        });
+                        if (subResult && subResult.status !== 404) {
+                            return subResult;
                         }
                     }
                 }
-                const propertyNames = Object.getOwnPropertyNames(proto);
-                for (const propertyName of propertyNames) {
-                    const fn = this[propertyName];
-                    if (typeof fn !== 'function')
+                const routeMatch = this.findRouteInController(controllerInstance, subPath, path, method);
+                if (routeMatch) {
+                    const { name, pathParams, methodMiddlewares, methodInterceptors } = routeMatch;
+                    const allMiddlewares = [
+                        ...context.middlewareChain,
+                        ...controllerMeta.middlewares,
+                        ...methodMiddlewares,
+                    ];
+                    let payload = { ...context.appRequest, params: pathParams };
+                    for (const mw of allMiddlewares) {
+                        const mwResult = await mw(payload, context.request, context.response);
+                        payload = { ...payload, ...mwResult };
+                    }
+                    return this.getResponse({
+                        interceptors: [...context.interceptorChain, controllerMeta.interceptor].filter((el) => !!el),
+                        controllerInstance,
+                        name,
+                        payload,
+                        response: context.response,
+                        request: context.request,
+                    }).catch((error) => {
+                        if (controllerMeta.errorHandler) {
+                            return controllerMeta.errorHandler(error, context.request, context.response);
+                        }
+                        return error;
+                    });
+                }
+                return null;
+            }
+            getAllMethods(obj) {
+                let methods = new Set();
+                let current = Object.getPrototypeOf(obj);
+                while (current && current !== Object.prototype) {
+                    Object.getOwnPropertyNames(current).forEach((name) => {
+                        if (name !== 'constructor' && typeof current[name] === 'function') {
+                            methods.add(name);
+                        }
+                    });
+                    current = Object.getPrototypeOf(current);
+                }
+                return Array.from(methods);
+            }
+            findRouteInController(instance, path, route, method) {
+                const prototype = Object.getPrototypeOf(instance);
+                const propertyNames = this.getAllMethods(instance);
+                const matches = [];
+                for (const name of propertyNames) {
+                    if ([
+                        'constructor',
+                        'getResponse',
+                        'routeWalker',
+                        'getAllMethods',
+                        'findRouteInController',
+                    ].includes(name))
+                        continue;
+                    const endpointMeta = Reflect.getMetadata(_constants_1.ENDPOINT, prototype, name) || [];
+                    if (endpointMeta.length === 0)
                         continue;
-                    const endpointMeta = Reflect.getMetadata(_constants_1.ENDPOINT, proto, propertyName) || [];
                     const [httpMethod, routePattern] = endpointMeta;
-                    if (httpMethod === method || httpMethod === 'USE') {
-                        const fullPattern = [routePrefix, routePattern]
-                            .filter(Boolean)
-                            .join('/')
-                            .replace(/\/+ /g, '/');
-                        const pathParams = (0, _utils_1.matchRoute)(fullPattern, path);
-                        if (pathParams) {
-                            let payload = { ...request, params: pathParams };
-                            // Apply controller-level middlewares
-                            for (const middleware of middlewares) {
-                                const middlewareResponse = await middleware(payload);
-                                payload = { ...payload, middlewareResponse };
-                            }
-                            return this.getResponse({
-                                interceptors: baseInterceptors,
-                                controllerInstance: this,
-                                name: propertyName,
-                                payload,
-                                response,
-                            });
-                        }
+                    if (httpMethod !== method && httpMethod !== 'USE') {
+                        continue;
+                    }
+                    if (httpMethod === 'USE') {
+                        let useRoute = route.split('/');
+                        useRoute.pop();
+                        route = useRoute.join('/');
+                    }
+                    const current = [path, routePattern].join('/').replace(/\/+/g, '/');
+                    const pathParams = (0, _utils_1.matchRoute)(current, route);
+                    if (pathParams) {
+                        const priority = httpMethod === 'USE' ? 0 : Object.keys(pathParams).length > 0 ? 1 : 2;
+                        matches.push({
+                            name,
+                            pathParams,
+                            priority,
+                            methodMiddlewares: Reflect.getMetadata(_constants_1.MIDDLEWARES, prototype, name) || [],
+                            methodInterceptors: Reflect.getMetadata(_constants_1.INTERCEPTOR, prototype, name) || [],
+                        });
                     }
                 }
-                return { status: 404, message: 'Method Not Found' };
-            };
+                matches.sort((a, b) => b.priority - a.priority);
+                return matches[0] || null;
+            }
         };
     };
 }

package/dist/core/Endpoint.d.ts

@@ -1,4 +1,4 @@
-import { Middleware } from '../types/index.js';
+import { HTTP_METHODS, MiddlewareCB } from '../types/index.js';
 /**
  * Method decorator to define HTTP method and route pattern metadata on controller methods.
  *
@@ -13,7 +13,7 @@ import { Middleware } from '../types/index.js';
  *
  * @returns A method decorator function.
  */
-export declare function Endpoint(method: string, pathPattern?: string, middlewares?: Middleware[]): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function Endpoint(method: HTTP_METHODS, pathPattern?: string, middlewares?: MiddlewareCB[]): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Shortcut decorator for HTTP GET method.
  *
@@ -21,7 +21,7 @@ export declare function Endpoint(method: string, pathPattern?: string, middlewar
  * @param middlewares - Optional array of middlewares.
  * @returns Method decorator for GET endpoint.
  */
-export declare const GET: (pathPattern?: string, middlewares?: Middleware[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const GET: (pathPattern?: string, middlewares?: MiddlewareCB[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Shortcut decorator for HTTP POST method.
  *
@@ -29,7 +29,7 @@ export declare const GET: (pathPattern?: string, middlewares?: Middleware[]) =>
  * @param middlewares - Optional array of middlewares.
  * @returns Method decorator for POST endpoint.
  */
-export declare const POST: (pathPattern?: string, middlewares?: Middleware[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const POST: (pathPattern?: string, middlewares?: MiddlewareCB[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Shortcut decorator for HTTP PUT method.
  *
@@ -37,7 +37,7 @@ export declare const POST: (pathPattern?: string, middlewares?: Middleware[]) =>
  * @param middlewares - Optional array of middlewares.
  * @returns Method decorator for PUT endpoint.
  */
-export declare const PUT: (pathPattern?: string, middlewares?: Middleware[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const PUT: (pathPattern?: string, middlewares?: MiddlewareCB[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Shortcut decorator for HTTP PATCH method.
  *
@@ -45,7 +45,7 @@ export declare const PUT: (pathPattern?: string, middlewares?: Middleware[]) =>
  * @param middlewares - Optional array of middlewares.
  * @returns Method decorator for PATCH endpoint.
  */
-export declare const PATCH: (pathPattern?: string, middlewares?: Middleware[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const PATCH: (pathPattern?: string, middlewares?: MiddlewareCB[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
  * Shortcut decorator for HTTP DELETE method.
  *
@@ -53,12 +53,21 @@ export declare const PATCH: (pathPattern?: string, middlewares?: Middleware[]) =
  * @param middlewares - Optional array of middlewares.
  * @returns Method decorator for DELETE endpoint.
  */
-export declare const DELETE: (pathPattern?: string, middlewares?: Middleware[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const DELETE: (pathPattern?: string, middlewares?: MiddlewareCB[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
 /**
- * Shortcut decorator for middleware usage on routes.
+ * Shortcut decorator for HTTP OPTIONS method.
  *
  * @param pathPattern - Optional route pattern string.
  * @param middlewares - Optional array of middlewares.
- * @returns Method decorator for middleware usage.
+ * @returns Method decorator for DELETE endpoint.
+ */
+export declare const OPTIONS: (pathPattern?: string, middlewares?: MiddlewareCB[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Shortcut decorator for HTTP HEAD method.
+ *
+ * @param pathPattern - Optional route pattern string.
+ * @param middlewares - Optional array of middlewares.
+ * @returns Method decorator for DELETE endpoint.
  */
-export declare const USE: (pathPattern?: string, middlewares?: Middleware[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare const HEAD: (pathPattern?: string, middlewares?: MiddlewareCB[]) => (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+export declare function USE(middlewares?: MiddlewareCB[]): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;

package/dist/core/Endpoint.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.USE = exports.DELETE = exports.PATCH = exports.PUT = exports.POST = exports.GET = void 0;
+exports.HEAD = exports.OPTIONS = exports.DELETE = exports.PATCH = exports.PUT = exports.POST = exports.GET = void 0;
 exports.Endpoint = Endpoint;
+exports.USE = USE;
 const _constants_1 = require("../constants.js");
+const _types_1 = require("../types/index.js");
 /**
  * Method decorator to define HTTP method and route pattern metadata on controller methods.
  *
@@ -24,10 +26,12 @@ function Endpoint(method, pathPattern, middlewares) {
             console.warn('❌ originalMethod is undefined!');
             return descriptor;
         }
+        console.log(pathPattern);
         if (method && pathPattern) {
             Reflect.defineMetadata(_constants_1.ENDPOINT, [method, pathPattern], target, propertyKey);
             Reflect.defineMetadata('middlewares', middlewares || [], target, propertyKey);
         }
+        (0, _constants_1.INCREMENT_STATISTIC)('routes');
         return descriptor;
     };
 }
@@ -39,7 +43,7 @@ function Endpoint(method, pathPattern, middlewares) {
  * @returns Method decorator for GET endpoint.
  */
 const GET = (pathPattern, middlewares) => {
-    return Endpoint('GET', pathPattern, middlewares);
+    return Endpoint(_types_1.HTTP_METHODS.GET, pathPattern, middlewares);
 };
 exports.GET = GET;
 /**
@@ -50,7 +54,7 @@ exports.GET = GET;
  * @returns Method decorator for POST endpoint.
  */
 const POST = (pathPattern, middlewares) => {
-    return Endpoint('POST', pathPattern, middlewares);
+    return Endpoint(_types_1.HTTP_METHODS.POST, pathPattern, middlewares);
 };
 exports.POST = POST;
 /**
@@ -61,7 +65,7 @@ exports.POST = POST;
  * @returns Method decorator for PUT endpoint.
  */
 const PUT = (pathPattern, middlewares) => {
-    return Endpoint('PUT', pathPattern, middlewares);
+    return Endpoint(_types_1.HTTP_METHODS.PUT, pathPattern, middlewares);
 };
 exports.PUT = PUT;
 /**
@@ -72,7 +76,7 @@ exports.PUT = PUT;
  * @returns Method decorator for PATCH endpoint.
  */
 const PATCH = (pathPattern, middlewares) => {
-    return Endpoint('PATCH', pathPattern, middlewares);
+    return Endpoint(_types_1.HTTP_METHODS.PATCH, pathPattern, middlewares);
 };
 exports.PATCH = PATCH;
 /**
@@ -83,17 +87,43 @@ exports.PATCH = PATCH;
  * @returns Method decorator for DELETE endpoint.
  */
 const DELETE = (pathPattern, middlewares) => {
-    return Endpoint('DELETE', pathPattern, middlewares);
+    return Endpoint(_types_1.HTTP_METHODS.DELETE, pathPattern, middlewares);
 };
 exports.DELETE = DELETE;
 /**
- * Shortcut decorator for middleware usage on routes.
+ * Shortcut decorator for HTTP OPTIONS method.
  *
  * @param pathPattern - Optional route pattern string.
  * @param middlewares - Optional array of middlewares.
- * @returns Method decorator for middleware usage.
+ * @returns Method decorator for DELETE endpoint.
  */
-const USE = (pathPattern, middlewares) => {
-    return Endpoint('USE', pathPattern, middlewares);
+const OPTIONS = (pathPattern, middlewares) => {
+    return Endpoint(_types_1.HTTP_METHODS.OPTIONS, pathPattern, middlewares);
 };
-exports.USE = USE;
+exports.OPTIONS = OPTIONS;
+/**
+ * Shortcut decorator for HTTP HEAD method.
+ *
+ * @param pathPattern - Optional route pattern string.
+ * @param middlewares - Optional array of middlewares.
+ * @returns Method decorator for DELETE endpoint.
+ */
+const HEAD = (pathPattern, middlewares) => {
+    return Endpoint(_types_1.HTTP_METHODS.HEAD, pathPattern, middlewares);
+};
+exports.HEAD = HEAD;
+// /**
+//  * Shortcut decorator for middleware usage on routes.
+//  *
+//  * @param pathPattern - Optional route pattern string.
+//  * @param middlewares - Optional array of middlewares.
+//  * @returns Method decorator for middleware usage.
+//  */
+function USE(middlewares) {
+    return function (target, propertyKey, descriptor) {
+        Reflect.defineMetadata(_constants_1.ENDPOINT, ['USE', '/'], target, propertyKey);
+        Reflect.defineMetadata(_constants_1.MIDDLEWARES, middlewares || [], target, propertyKey);
+        (0, _constants_1.INCREMENT_STATISTIC)('routes');
+        return descriptor;
+    };
+}

package/dist/core/index.d.ts

@@ -4,7 +4,7 @@
  * This module provides centralized exports for controller and endpoint decorators,
  * as well as related types and utility functions used throughout the core framework.
  */
-export { EndpointResponse, IController, Interceptor, Middleware, Request, Router, WebSocketClient, WebSocketEvent, WebSocketMessage, } from '../types/index.js';
+export { AppRequest, EndpointResponse, ErrorCB, IController, InterceptorCB, IWebSocketService, MiddlewareCB, ResponseWithStatus, Router, WebSocketClient, WebSocketEvent, WebSocketMessage, } from '../types/index.js';
 export * from './Controller';
 export * from './Endpoint';
 export * from './utils';

package/dist/core/utils/extractors.d.ts

@@ -1,10 +1,3 @@
-import { ParamDecoratorType } from '../../types/index.js';
-export interface ParamMetadata {
-    index: number;
-    type: ParamDecoratorType;
-    dto?: any;
-    name?: string;
-}
 /**
  * Parameter decorator to extract and validate the request body.
  * @param dto Optional DTO class for validation and transformation.

package/dist/core/utils/extractors.js

@@ -1,59 +1,50 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Response = exports.Multipart = exports.Cookies = exports.Headers = exports.Request = exports.Query = exports.Params = exports.Body = void 0;
-const _constants_1 = require("../../constants.js");
-function createParamDecorator(type, dto, name) {
-    return function (target, propertyKey, parameterIndex) {
-        const existingParams = Reflect.getMetadata(_constants_1.PARAM_METADATA_KEY, target, propertyKey) || [];
-        existingParams.push({ index: parameterIndex, type, dto, name });
-        existingParams.sort((a, b) => a.index - b.index);
-        Reflect.defineMetadata(_constants_1.PARAM_METADATA_KEY, existingParams, target, propertyKey);
-        const saved = Reflect.getMetadata(_constants_1.PARAM_METADATA_KEY, target, propertyKey);
-    };
-}
+const _utils_1 = require("../../utils/index.js");
 /**
  * Parameter decorator to extract and validate the request body.
  * @param dto Optional DTO class for validation and transformation.
  */
-const Body = (dto) => createParamDecorator('body', dto);
+const Body = (dto) => (0, _utils_1.createParamDecorator)('body', dto);
 exports.Body = Body;
 /**
  * Parameter decorator to extract route parameters.
  * @param name Optional name of the parameter to extract.
  */
-const Params = (name) => createParamDecorator('params', undefined, name);
+const Params = (name) => (0, _utils_1.createParamDecorator)('params', undefined, name);
 exports.Params = Params;
 /**
  * Parameter decorator to extract query parameters.
  * @param name Optional name of the query parameter to extract.
  */
-const Query = (name) => createParamDecorator('query', undefined, name);
+const Query = (name) => (0, _utils_1.createParamDecorator)('query', undefined, name);
 exports.Query = Query;
 /**
  * Parameter decorator to inject the entire request object.
  */
-const Request = () => createParamDecorator('request');
+const Request = () => (0, _utils_1.createParamDecorator)('request');
 exports.Request = Request;
 /**
  * Parameter decorator to extract headers from the request.
  * @param name Optional name of the header to extract.
  */
-const Headers = (name) => createParamDecorator('headers', undefined, name);
+const Headers = (name) => (0, _utils_1.createParamDecorator)('headers', undefined, name);
 exports.Headers = Headers;
 /**
  * Parameter decorator to extract cookies from the request.
  * @param name Optional name of the cookie to extract.
  */
-const Cookies = (name) => createParamDecorator('cookies', undefined, name);
+const Cookies = (name) => (0, _utils_1.createParamDecorator)('cookies', undefined, name);
 exports.Cookies = Cookies;
 /**
  * Parameter decorator to extract multipart form data.
  * @param name Optional name of the multipart field to extract.
  */
-const Multipart = (name) => createParamDecorator('multipart', undefined, name);
+const Multipart = (name) => (0, _utils_1.createParamDecorator)('multipart', undefined, name);
 exports.Multipart = Multipart;
 /**
  * Parameter decorator to inject the response object.
  */
-const Response = () => createParamDecorator('response');
+const Response = () => (0, _utils_1.createParamDecorator)('response');
 exports.Response = Response;

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

@@ -1,3 +1,4 @@
 export * from './extractors';
 export * from './helpers';
+export * from './middlewares';
 export * from './websocket';

package/dist/core/utils/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./extractors"), exports);
 __exportStar(require("./helpers"), exports);
+__exportStar(require("./middlewares"), exports);
 __exportStar(require("./websocket"), exports);

package/dist/core/utils/middlewares.d.ts

@@ -0,0 +1,3 @@
+import { ErrorCB, MiddlewareCB } from '../../types/index.js';
+export declare function Use(middleware: MiddlewareCB): (target: any) => any;
+export declare function Catch(handler: ErrorCB): (target: any) => any;

package/dist/core/utils/middlewares.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Use = Use;
+exports.Catch = Catch;
+const _constants_1 = require("../../constants.js");
+function Use(middleware) {
+    return function (target) {
+        const config = Reflect.getMetadata(_constants_1.SERVER_CONFIG_KEY, target) || {};
+        const mergedConfig = {
+            ...config,
+            middlewares: [...(config?.middlewares ?? []), middleware].filter((el) => !!el),
+        };
+        Reflect.defineMetadata(_constants_1.SERVER_CONFIG_KEY, mergedConfig, target);
+        return target;
+    };
+}
+function Catch(handler) {
+    return function (target) {
+        Reflect.defineMetadata(_constants_1.CATCH, handler, target);
+        return target;
+    };
+}

package/dist/examples/controllers/socket.d.ts

@@ -1,24 +1,8 @@
 import { WebSocketEvent } from 'quantum-flow/core';
 export declare class Socket {
-    /**
-     * 1. Приветствие при подключении
-     */
     onConnection(event: WebSocketEvent): void;
-    /**
-     * 2. @Subscribe - АВТОМАТИЧЕСКАЯ рассылка всем подписчикам
-     * Не нужно использовать WebSocketService!
-     */
     onChatMessage(event: WebSocketEvent): void;
-    /**
-     * 3. @Subscribe для другой комнаты
-     */
     onNewsMessage(event: WebSocketEvent): void;
-    /**
-     * 4. @OnMessage для команд (без WebSocketService)
-     */
     onPing(event: WebSocketEvent): void;
-    /**
-     * 5. @OnMessage для подписки
-     */
     onSubscribe(event: WebSocketEvent): void;
 }