@heliosjs/middlewares 2.0.2 → 4.0.0

package/dist/catch.d.ts

@@ -1,4 +1,4 @@
-import { ErrorCB } from './types/core';
+import { ErorrHandler } from './types/core';
 /**
  * Decorator to register a global or controller-level error handler.
  *
@@ -7,7 +7,7 @@ import { ErrorCB } 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 {ErrorCB} handler - The error callback function to handle errors.
+ * @param {ErorrHandler} 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 { ErrorCB } 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: ErrorCB): (target: any) => any;
+export declare function Catch(handler: ErorrHandler): (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => void;

package/dist/catch.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Catch = Catch;
-const constants_1 = require("./constants");
+const shared_1 = require("./utils/shared");
 /**
  * Decorator to register a global or controller-level error handler.
  *
@@ -10,7 +10,7 @@ const constants_1 = require("./constants");
  * It attaches the handler as metadata on the target class, allowing the framework to
  * retrieve and execute the error handler appropriately during runtime.
  *
- * @param {ErrorCB} handler - The error callback function to handle errors.
+ * @param {ErorrHandler} handler - The error callback function to handle errors.
  *
  * @returns {Function} A class decorator function that defines the error handler metadata.
  *
@@ -30,9 +30,14 @@ const constants_1 = require("./constants");
  * to invoke the registered error handler when errors occur.
  */
 function Catch(handler) {
-    return function (target) {
-        Reflect.defineMetadata(constants_1.CATCH, handler, target);
-        return target;
+    return function (target, propertyKey, descriptor) {
+        const data = { errors: [handler] };
+        if (descriptor) {
+            (0, shared_1.defineMiddlewaresMeta)(data, target, propertyKey);
+        }
+        else {
+            (0, shared_1.defineMiddlewaresMeta)(data, target);
+        }
     };
 }
 //# sourceMappingURL=catch.js.map

package/dist/catch.js.map

@@ -1 +1 @@
-{"version":3,"file":"catch.js","sourceRoot":"","sources":["../src/catch.ts"],"names":[],"mappings":";;AA8BA,sBAMC;AApCD,2CAAoC;AAGpC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,KAAK,CAAC,OAAgB;IACpC,OAAO,UAAU,MAAW;QAC1B,OAAO,CAAC,cAAc,CAAC,iBAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE/C,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"catch.js","sourceRoot":"","sources":["../src/catch.ts"],"names":[],"mappings":";;AA6BA,sBAUC;AAtCD,2CAAuD;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,KAAK,CAAC,OAAqB;IACzC,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAEnC,IAAI,UAAU,EAAE,CAAC;YACf,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/constants.d.ts

@@ -23,3 +23,8 @@ 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";
+export declare enum DECORATOR {
+    controller = "controller:config",
+    middlewares = "controller:middlewares",
+    route = "controller:route"
+}

package/dist/constants.js

@@ -1,6 +1,6 @@
 "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.INTERCEPT = 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.DECORATOR = 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.INTERCEPT = 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';
@@ -31,4 +31,10 @@ exports.SSE_METADATA_KEY = 'sse:handlers';
 exports.SSE_TOPIC_KEY = 'sse:topics';
 exports.SSE_SERVICE_KEY = 'sse:service';
 exports.STATIC_METADATA_KEY = 'static:config';
+var DECORATOR;
+(function (DECORATOR) {
+    DECORATOR["controller"] = "controller:config";
+    DECORATOR["middlewares"] = "controller:middlewares";
+    DECORATOR["route"] = "controller:route";
+})(DECORATOR || (exports.DECORATOR = DECORATOR = {}));
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +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,SAAS,GAAG,kBAAkB,CAAC;AAC/B,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"}
+{"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,SAAS,GAAG,kBAAkB,CAAC;AAC/B,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;AAEnD,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,6CAAgC,CAAA;IAChC,mDAAsC,CAAA;IACtC,uCAA0B,CAAA;AAC5B,CAAC,EAJW,SAAS,yBAAT,SAAS,QAIpB"}

package/dist/cors.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Cors = Cors;
-const constants_1 = require("./constants");
 const core_1 = require("./types/core");
+const shared_1 = require("./utils/shared");
 /**
  * Decorator to configure Cross-Origin Resource Sharing (CORS) settings for HTTP controllers or methods.
  *
@@ -46,11 +46,12 @@ function Cors(config = {}) {
             methods: Object.keys(core_1.HTTP_METHODS),
         };
         const finalConfig = { ...defaultConfig, ...config };
-        if (propertyKey && descriptor) {
-            Reflect.defineMetadata(constants_1.CORS_METADATA, finalConfig, target, propertyKey);
+        const data = { cors: [finalConfig] };
+        if (descriptor) {
+            (0, shared_1.defineMiddlewaresMeta)(data, target, propertyKey);
         }
         else {
-            Reflect.defineMetadata(constants_1.CORS_METADATA, finalConfig, target.prototype || target);
+            (0, shared_1.defineMiddlewaresMeta)(data, target);
         }
     };
 }

package/dist/cors.js.map

@@ -1 +1 @@
-{"version":3,"file":"cors.js","sourceRoot":"","sources":["../src/cors.ts"],"names":[],"mappings":";;AAsCA,oBAgBC;AAtDD,2CAA4C;AAC5C,uCAAwD;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,SAAgB,IAAI,CAAC,SAAqB,EAAE;IAC1C,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,aAAa,GAAe;YAChC,MAAM,EAAE,GAAG;YACX,oBAAoB,EAAE,GAAG;YACzB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,mBAAY,CAAC;SACnC,CAAC;QAEF,MAAM,WAAW,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;QAEpD,IAAI,WAAW,IAAI,UAAU,EAAE,CAAC;YAC9B,OAAO,CAAC,cAAc,CAAC,yBAAa,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,cAAc,CAAC,yBAAa,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;QACjF,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cors.js","sourceRoot":"","sources":["../src/cors.ts"],"names":[],"mappings":";;AAsCA,oBAkBC;AAxDD,uCAAwD;AAExD,2CAAuD;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,SAAgB,IAAI,CAAC,SAAqB,EAAE;IAC1C,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,aAAa,GAAe;YAChC,MAAM,EAAE,GAAG;YACX,oBAAoB,EAAE,GAAG;YACzB,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,mBAAY,CAAC;SACnC,CAAC;QAEF,MAAM,WAAW,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,EAAE,CAAC;QAEpD,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC;QAErC,IAAI,UAAU,EAAE,CAAC;YACf,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/guard.d.ts

@@ -0,0 +1,44 @@
+import { type Guard, GuardFn } from './types/core';
+/**
+ * Decorator to register a guard.
+ *
+ * Guards are used to control access to a controller by validating
+ * incoming requests before they reach route handlers. If a guard
+ * returns `false`, the request is blocked.
+ *
+ * @param guard - A guard class or function used to determine whether
+ * the request is allowed to proceed.
+ *
+ * @returns A class decorator that attaches guard metadata to the target.
+ *
+ * @example
+ * // Using function guard
+ * @Guard((req, res) => {
+ *   return !!req.headers.authorization;
+ * })
+ * class MyController {}
+ *
+ * @example
+ * // Using class-based guard
+ * class AuthGuard {
+ *   canActivate(req: Request, res: Response) {
+ *     return !!req.headers.authorization;
+ *   }
+ * }
+ *
+ * @Guard(AuthGuard)
+ * class MyController {}
+ *
+ * @remarks
+ * Guards are executed before controller methods.
+ * They can be used for:
+ * - authentication
+ * - authorization
+ * - request validation
+ *
+ * If any guard returns `false`, the request handling is stopped.
+ *
+ * Metadata is stored under the CONTROLLER_CONFIGUARTION key and used
+ * internally by the framework during request processing.
+ */
+export declare function Guard(guard: Guard | GuardFn): (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => void;

package/dist/guard.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Guard = Guard;
+const shared_1 = require("./utils/shared");
+/**
+ * Decorator to register a guard.
+ *
+ * Guards are used to control access to a controller by validating
+ * incoming requests before they reach route handlers. If a guard
+ * returns `false`, the request is blocked.
+ *
+ * @param guard - A guard class or function used to determine whether
+ * the request is allowed to proceed.
+ *
+ * @returns A class decorator that attaches guard metadata to the target.
+ *
+ * @example
+ * // Using function guard
+ * @Guard((req, res) => {
+ *   return !!req.headers.authorization;
+ * })
+ * class MyController {}
+ *
+ * @example
+ * // Using class-based guard
+ * class AuthGuard {
+ *   canActivate(req: Request, res: Response) {
+ *     return !!req.headers.authorization;
+ *   }
+ * }
+ *
+ * @Guard(AuthGuard)
+ * class MyController {}
+ *
+ * @remarks
+ * Guards are executed before controller methods.
+ * They can be used for:
+ * - authentication
+ * - authorization
+ * - request validation
+ *
+ * If any guard returns `false`, the request handling is stopped.
+ *
+ * Metadata is stored under the CONTROLLER_CONFIGUARTION key and used
+ * internally by the framework during request processing.
+ */
+function Guard(guard) {
+    return function (target, propertyKey, descriptor) {
+        const data = { guards: [guard] };
+        if (descriptor) {
+            (0, shared_1.defineMiddlewaresMeta)(data, target, propertyKey);
+        }
+        else {
+            (0, shared_1.defineMiddlewaresMeta)(data, target);
+        }
+    };
+}
+//# sourceMappingURL=guard.js.map

package/dist/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../src/guard.ts"],"names":[],"mappings":";;AA4CA,sBAUC;AArDD,2CAAuD;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,SAAgB,KAAK,CAAC,KAAsB;IAC1C,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QAEjC,IAAI,UAAU,EAAE,CAAC;YACf,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 import 'reflect-metadata';
 export * from './catch';
 export * from './cors';
+export * from './guard';
+export * from './interceptor';
+export * from './pipe';
 export * from './sanitize';
 export * from './status';
 export * from './use';

package/dist/index.js

@@ -17,6 +17,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 require("reflect-metadata");
 __exportStar(require("./catch"), exports);
 __exportStar(require("./cors"), exports);
+__exportStar(require("./guard"), exports);
+__exportStar(require("./interceptor"), exports);
+__exportStar(require("./pipe"), exports);
 __exportStar(require("./sanitize"), exports);
 __exportStar(require("./status"), exports);
 __exportStar(require("./use"), exports);

package/dist/index.js.map

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

package/dist/interceptor.d.ts

@@ -0,0 +1,45 @@
+import { InterceptorCB } from '@heliosjs/core';
+/**
+ * Decorator to register an interceptor at the controller or method level.
+ *
+ * Interceptors are functions that wrap the execution of a route handler.
+ * They can run logic before after the handler is executed, allowing
+ * you to modify  responses, or handle cross-cutting concerns.
+ *
+ * @param handler - Interceptor callback function.
+ *
+ * @returns A decorator that attaches interceptor metadata to the target
+ * (either a class or a method).
+ *
+ * @example
+ * // Logging interceptor
+ * @Intercept(async (ctx, next) => {
+ *   console.log('Before');
+ *   const result = await next();
+ *   console.log('After');
+ *   return result;
+ * })
+ * class MyController {}
+ *
+ * @example
+ * // Method-level interceptor
+ * class MyController {
+ *   @Intercept(async (ctx, next) => {
+ *     return next();
+ *   })
+ *   getData() {}
+ * }
+ *
+ * @remarks
+ * - Interceptors can modify the result returned by the handler.
+ * - They are executed in the order they are applied.
+ * - Can be used for:
+ *   - logging
+ *   - response transformation
+ *   - caching
+ *   - error handling (wrapping)
+ *
+ * Metadata is stored using the MIDDLEWARES_CONFIG key and
+ * used internally by the framework during request processing.
+ */
+export declare function Intercept(handler: InterceptorCB): (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => void;

package/dist/interceptor.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Intercept = Intercept;
+const shared_1 = require("./utils/shared");
+/**
+ * Decorator to register an interceptor at the controller or method level.
+ *
+ * Interceptors are functions that wrap the execution of a route handler.
+ * They can run logic before after the handler is executed, allowing
+ * you to modify  responses, or handle cross-cutting concerns.
+ *
+ * @param handler - Interceptor callback function.
+ *
+ * @returns A decorator that attaches interceptor metadata to the target
+ * (either a class or a method).
+ *
+ * @example
+ * // Logging interceptor
+ * @Intercept(async (ctx, next) => {
+ *   console.log('Before');
+ *   const result = await next();
+ *   console.log('After');
+ *   return result;
+ * })
+ * class MyController {}
+ *
+ * @example
+ * // Method-level interceptor
+ * class MyController {
+ *   @Intercept(async (ctx, next) => {
+ *     return next();
+ *   })
+ *   getData() {}
+ * }
+ *
+ * @remarks
+ * - Interceptors can modify the result returned by the handler.
+ * - They are executed in the order they are applied.
+ * - Can be used for:
+ *   - logging
+ *   - response transformation
+ *   - caching
+ *   - error handling (wrapping)
+ *
+ * Metadata is stored using the MIDDLEWARES_CONFIG key and
+ * used internally by the framework during request processing.
+ */
+function Intercept(handler) {
+    return function (target, propertyKey, descriptor) {
+        const data = { interceptors: [handler] };
+        if (descriptor) {
+            (0, shared_1.defineMiddlewaresMeta)(data, target, propertyKey);
+        }
+        else {
+            (0, shared_1.defineMiddlewaresMeta)(data, target);
+        }
+    };
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.js","sourceRoot":"","sources":["../src/interceptor.ts"],"names":[],"mappings":";;AA6CA,8BAUC;AAtDD,2CAAuD;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,SAAgB,SAAS,CAAC,OAAsB;IAC9C,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,IAAI,GAAG,EAAE,YAAY,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAEzC,IAAI,UAAU,EAAE,CAAC;YACf,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/pipe.d.ts

@@ -0,0 +1,31 @@
+import { type Pipe } from './types/core';
+/**
+ * Decorator to register a data transformation pipe.
+ *
+ * Pipes are used to transform incoming request data before it reaches
+ * the route handler. They can be applied at the controller level and
+ * modify parts of the request such as body, query, params, or headers.
+ *
+ * @param config - Configuration object containing transformation functions
+ * for different parts of the request.
+ *
+ * @returns A class decorator that attaches pipe metadata to the target.
+ *
+ * @example
+ * @Pipe({
+ *   body: (body) => ({ ...body, name: body.name.trim() }),
+ *   query: (query) => ({ ...query, page: Number(query.page) }),
+ * })
+ * class MyController {}
+ *
+ * @remarks
+ * Each function in the pipe receives raw data and must return the transformed value.
+ * Pipes are executed before controller methods and can be used for:
+ * - data normalization
+ * - type casting
+ * - sanitization
+ *
+ * Metadata is stored under the CONTROLLER_CONFIGUARTION key and later used
+ * by the framework during request processing.
+ */
+export declare function Pipe(pipe: Pipe): (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => void;

package/dist/pipe.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pipe = Pipe;
+const shared_1 = require("./utils/shared");
+/**
+ * Decorator to register a data transformation pipe.
+ *
+ * Pipes are used to transform incoming request data before it reaches
+ * the route handler. They can be applied at the controller level and
+ * modify parts of the request such as body, query, params, or headers.
+ *
+ * @param config - Configuration object containing transformation functions
+ * for different parts of the request.
+ *
+ * @returns A class decorator that attaches pipe metadata to the target.
+ *
+ * @example
+ * @Pipe({
+ *   body: (body) => ({ ...body, name: body.name.trim() }),
+ *   query: (query) => ({ ...query, page: Number(query.page) }),
+ * })
+ * class MyController {}
+ *
+ * @remarks
+ * Each function in the pipe receives raw data and must return the transformed value.
+ * Pipes are executed before controller methods and can be used for:
+ * - data normalization
+ * - type casting
+ * - sanitization
+ *
+ * Metadata is stored under the CONTROLLER_CONFIGUARTION key and later used
+ * by the framework during request processing.
+ */
+function Pipe(pipe) {
+    return function (target, propertyKey, descriptor) {
+        const data = { pipes: [pipe] };
+        if (descriptor) {
+            (0, shared_1.defineMiddlewaresMeta)(data, target, propertyKey);
+        }
+        else {
+            (0, shared_1.defineMiddlewaresMeta)(data, target);
+        }
+    };
+}
+//# sourceMappingURL=pipe.js.map

package/dist/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../src/pipe.ts"],"names":[],"mappings":";;AA+BA,oBAUC;AAxCD,2CAAuD;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,IAAI,CAAC,IAAU;IAC7B,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAE/B,IAAI,UAAU,EAAE,CAAC;YACf,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/sanitize.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Sanitize = Sanitize;
-const constants_1 = require("./constants");
+const shared_1 = require("./utils/shared");
 /**
  * Decorator to apply sanitization configurations to a controller or method.
  *
@@ -42,12 +42,12 @@ const constants_1 = require("./constants");
  */
 function Sanitize(sanitizeConfig) {
     return function (target, propertyKey, descriptor) {
-        const configs = Array.isArray(sanitizeConfig) ? sanitizeConfig : [sanitizeConfig];
-        if (propertyKey && descriptor) {
-            Reflect.defineMetadata(constants_1.SANITIZE, configs, target, propertyKey);
+        const data = { sanitizers: Array.isArray(sanitizeConfig) ? sanitizeConfig : [sanitizeConfig] };
+        if (descriptor) {
+            (0, shared_1.defineMiddlewaresMeta)(data, target, propertyKey);
         }
         else {
-            Reflect.defineMetadata(constants_1.SANITIZE, configs, target.prototype || target);
+            (0, shared_1.defineMiddlewaresMeta)(data, target);
         }
     };
 }

package/dist/sanitize.js.map

@@ -1 +1 @@
-{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":";;AAyCA,4BAUC;AAnDD,2CAAuC;AAGvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAgB,QAAQ,CAAC,cAAmD;IAC1E,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;QAElF,IAAI,WAAW,IAAI,UAAU,EAAE,CAAC;YAC9B,OAAO,CAAC,cAAc,CAAC,oBAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,cAAc,CAAC,oBAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":";;AAwCA,4BAUC;AAjDD,2CAAuD;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAgB,QAAQ,CAAC,cAAmD;IAC1E,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,IAAI,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC;QAE/F,IAAI,UAAU,EAAE,CAAC;YACf,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/status.d.ts

@@ -31,7 +31,7 @@
  * This metadata is accessible via Reflect API and used internally by the framework
  * to set the HTTP response status.
  */
-export declare function Status(status: number): (target: any, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<any>) => void;
+export declare function Status(status: number): (target: any, propertyKey?: string) => void;
 /**
  * Shortcut decorator to set HTTP 200 OK status.
  *
@@ -40,7 +40,7 @@ export declare function Status(status: number): (target: any, propertyKey?: stri
  *
  * @returns {Function} A decorator function that sets the HTTP status to 200.
  */
-export declare const Ok200: () => (target: any, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<any>) => void;
+export declare const Ok200: () => (target: any, propertyKey?: string) => void;
 /**
  * Shortcut decorator to set HTTP 201 Created status.
  *
@@ -49,7 +49,7 @@ export declare const Ok200: () => (target: any, propertyKey?: string | symbol, d
  *
  * @returns {Function} A decorator function that sets the HTTP status to 201.
  */
-export declare const Ok201: () => (target: any, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<any>) => void;
+export declare const Ok201: () => (target: any, propertyKey?: string) => void;
 /**
  * Shortcut decorator to set HTTP 204 No Content status.
  *
@@ -59,4 +59,4 @@ export declare const Ok201: () => (target: any, propertyKey?: string | symbol, d
  *
  * @returns {Function} A decorator function that sets the HTTP status to 204.
  */
-export declare const Ok204: () => (target: any, propertyKey?: string | symbol, descriptor?: TypedPropertyDescriptor<any>) => void;
+export declare const Ok204: () => (target: any, propertyKey?: string) => void;

package/dist/status.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Ok204 = exports.Ok201 = exports.Ok200 = void 0;
 exports.Status = Status;
-const constants_1 = require("./constants");
+const shared_1 = require("./utils/shared");
 /**
  * Decorator to set the HTTP status code for the response.
  *
@@ -37,13 +37,11 @@ const constants_1 = require("./constants");
  * to set the HTTP response status.
  */
 function Status(status) {
-    return function (target, propertyKey, descriptor) {
-        if (!propertyKey) {
-            Reflect.defineMetadata(constants_1.OK_METADATA_KEY, status, target.prototype || target);
-            return;
-        }
-        if (descriptor) {
-            Reflect.defineMetadata(constants_1.OK_METADATA_KEY, status, target, propertyKey);
+    return function (target, propertyKey) {
+        if (propertyKey) {
+            const meta = (0, shared_1.reflectMiddlewaresMetadata)(target);
+            meta.status = status;
+            (0, shared_1.defineMiddlewaresMeta)(meta, target, propertyKey);
         }
     };
 }

package/dist/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":";;;AAmCA,wBAeC;AAlDD,2CAA8C;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,SAAgB,MAAM,CAAC,MAAc;IACnC,OAAO,UACL,MAAW,EACX,WAA6B,EAC7B,UAAyC;QAEzC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,cAAc,CAAC,2BAAe,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,cAAc,CAAC,2BAAe,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACvE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACI,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAA1B,QAAA,KAAK,SAAqB;AAEvC;;;;;;;GAOG;AACI,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAA1B,QAAA,KAAK,SAAqB;AAEvC;;;;;;;;GAQG;AACI,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAA1B,QAAA,KAAK,SAAqB"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":";;;AAkCA,wBAQC;AA1CD,2CAAmF;AACnF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,SAAgB,MAAM,CAAC,MAAc;IACnC,OAAO,UAAU,MAAW,EAAE,WAAoB;QAChD,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,IAAA,mCAA0B,EAAC,MAAM,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACI,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAA1B,QAAA,KAAK,SAAqB;AAEvC;;;;;;;GAOG;AACI,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAA1B,QAAA,KAAK,SAAqB;AAEvC;;;;;;;;GAQG;AACI,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAA1B,QAAA,KAAK,SAAqB"}

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

@@ -20,33 +20,11 @@ export type ControllerType = {
     new (...args: any[]): any;
 };
 export type ControllerInstance = InstanceType<ControllerType>;
-export type ControllerMetadata = {
-    routePrefix: string;
-    middlewares: MiddlewareCB[];
-    interceptor?: InterceptorCB;
-    subControllers: ControllerInstance[];
-    errorHandler?: ErorrHandler;
-    cors?: CORSConfig;
-    sanitizers: SanitizerConfig[];
-};
 export interface ControllerConfig {
     prefix: string;
     middlewares?: Array<MiddlewareCB>;
     controllers?: ControllerInstance[];
-    interceptor?: InterceptorCB;
 }
-export type RouteContext = {
-    controllerInstance: any;
-    controllerMeta: ControllerMetadata;
-    path: string;
-    method: string;
-    middlewareChain: MiddlewareCB[];
-    interceptorChain: InterceptorCB[];
-    corsChain: CORSConfig[];
-    errorHandlerChain: ErorrHandler[];
-    subPath: string;
-    sanitizersChain: SanitizerConfig[];
-};
 export type SSE_HANDLER_META = {
     type: string;
     method: string;
@@ -76,31 +54,67 @@ export type SeeControllerHandlers = {
         error: HandlerMeta[];
     };
 };
+export type FunctionsMeta = {
+    middlewares: MiddlewareCB[];
+    errors: ErorrHandler[];
+    cors: CORSConfig[];
+    sanitizers: SanitizerConfig[];
+    pipes: Pipe[];
+    guards: (Guard | GuardFn)[];
+    interceptors: InterceptorCB[];
+    status?: number;
+};
 export type Route = {
     name: string;
     route: string;
     method: HTTP_METHODS;
     cors?: CORSConfig[];
     ok: number;
-    paramMetadata: ParamMetadata[];
-    interceptors: InterceptorCB[];
-    functions: {
-        sanitizers: SanitizerConfig[];
-        errors: ErorrHandler[];
-        middlewares: MiddlewareCB[];
-    }[];
+    parameters: ParamMetadata[];
+    interceptor?: InterceptorCB;
+    functions: FunctionsMeta[];
     fn: (...args: any[]) => any;
 };
 export type NextFunction = (error?: unknown) => void;
 export type ControllerMeta = {
     prefix: string;
+    name: string;
     routes: Route[];
-    interceptors: InterceptorCB[];
-    cors: CORSConfig[];
-    functions: {
-        sanitizers: SanitizerConfig[];
-        errors: ErorrHandler[];
-        middlewares: MiddlewareCB[];
-    }[];
     children?: ControllerMeta[];
+    functions: MiddlewaresMetadata[];
+    controllers: ControllerClass[];
+};
+export type ControllerMetadata = {
+    prefix: string;
+    name: string;
+    middlewares: MiddlewareCB[];
+    controllers: ControllerInstance[];
+};
+export type RouteMetadata = {
+    route: string;
+    method: HTTP_METHODS;
+    middlewares: MiddlewareCB[];
+    parameters: ParamMetadata[];
+};
+export type PipeKey = 'body' | 'query' | 'params' | 'headers';
+export type Pipe = {
+    body?: (body: unknown, request: Request) => unknown;
+    query?: (query: Record<string, string | string[]>, request: Request) => Record<string, string | string[]>;
+    params?: (params: Record<string, string>, request: Request) => Record<string, string>;
+    headers?: (headers: Record<string, string | string[]>, request: Request) => Record<string, string | string[]>;
+};
+export interface Guard {
+    new (...any: any[]): any;
+    canActivate(request: Request, response: Response): boolean;
+}
+export type GuardFn = (request: Request, response: Response) => boolean;
+export type MiddlewaresMetadata = {
+    middlewares: MiddlewareCB[];
+    errors: ErorrHandler[];
+    cors: CORSConfig[];
+    sanitizers: SanitizerConfig[];
+    pipes: Pipe[];
+    guards: (Guard | GuardFn)[];
+    interceptors: InterceptorCB[];
+    status?: number;
 };

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

@@ -7,7 +7,6 @@ export declare enum ErrorCode {
     NOT_FOUND = "NOT_FOUND",
     VALIDATION_FAILED = "VALIDATION_FAILED",
     RATE_LIMIT_EXCEEDED = "RATE_LIMIT_EXCEEDED",
-    INTERNAL_ERROR = "INTERNAL_ERROR",
     SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
     DATABASE_ERROR = "DATABASE_ERROR",
     DUPLICATE_ENTRY = "DUPLICATE_ENTRY",

package/dist/types/core/error.js

@@ -9,7 +9,6 @@ var ErrorCode;
     ErrorCode["NOT_FOUND"] = "NOT_FOUND";
     ErrorCode["VALIDATION_FAILED"] = "VALIDATION_FAILED";
     ErrorCode["RATE_LIMIT_EXCEEDED"] = "RATE_LIMIT_EXCEEDED";
-    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
     ErrorCode["SERVICE_UNAVAILABLE"] = "SERVICE_UNAVAILABLE";
     ErrorCode["DATABASE_ERROR"] = "DATABASE_ERROR";
     ErrorCode["DUPLICATE_ENTRY"] = "DUPLICATE_ENTRY";

package/dist/types/core/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/types/core/error.ts"],"names":[],"mappings":";;;AAGA,IAAY,SAcX;AAdD,WAAY,SAAS;IACnB,wCAA2B,CAAA;IAC3B,0CAA6B,CAAA;IAC7B,oCAAuB,CAAA;IACvB,oCAAuB,CAAA;IACvB,oDAAuC,CAAA;IACvC,wDAA2C,CAAA;IAC3C,8CAAiC,CAAA;IACjC,wDAA2C,CAAA;IAC3C,8CAAiC,CAAA;IACjC,gDAAmC,CAAA;IACnC,4CAA+B,CAAA;IAC/B,oDAAuC,CAAA;IACvC,4DAA+C,CAAA;AACjD,CAAC,EAdW,SAAS,yBAAT,SAAS,QAcpB"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/types/core/error.ts"],"names":[],"mappings":";;;AAGA,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,wCAA2B,CAAA;IAC3B,0CAA6B,CAAA;IAC7B,oCAAuB,CAAA;IACvB,oCAAuB,CAAA;IACvB,oDAAuC,CAAA;IACvC,wDAA2C,CAAA;IAC3C,wDAA2C,CAAA;IAC3C,8CAAiC,CAAA;IACjC,gDAAmC,CAAA;IACnC,4CAA+B,CAAA;IAC/B,oDAAuC,CAAA;IACvC,4DAA+C,CAAA;AACjD,CAAC,EAbW,SAAS,yBAAT,SAAS,QAapB"}

package/dist/use.d.ts

@@ -1,2 +1,46 @@
 import { MiddlewareCB } from './types/core';
-export declare function Use(middleware: MiddlewareCB | MiddlewareCB[]): (target: any) => any;
+/**
+ * Decorator to register middleware(s) at the controller or method level.
+ *
+ * Middlewares are functions executed before the route handler.
+ * They can be used to:
+ * - modify request/response
+ * - perform logging
+ * - handle authentication/authorization
+ * - short-circuit request handling
+ *
+ * @param middleware - A single middleware function or an array of middleware functions.
+ *
+ * @returns A decorator that attaches middleware metadata to the target
+ * (either a class or a method).
+ *
+ * @example
+ * // Single middleware
+ * @Use((req, res, next) => {
+ *   console.log('Request received');
+ *   next();
+ * })
+ * class MyController {}
+ *
+ * @example
+ * // Multiple middlewares
+ * @Use([
+ *   authMiddleware,
+ *   loggingMiddleware,
+ * ])
+ * class MyController {}
+ *
+ * @example
+ * // Method-level middleware
+ * class MyController {
+ *   @Use(authMiddleware)
+ *   getData() {}
+ * }
+ *
+ * @remarks
+ * - Middlewares are executed in the order they are defined.
+ * - Can be applied at both class and method levels.
+ * - Metadata is stored using the MIDDLEWARES_CONFIG key and used
+ *   internally by the framework during request handling.
+ */
+export declare function Use(middleware: MiddlewareCB | MiddlewareCB[]): (target: any, propertyKey?: string, descriptor?: PropertyDescriptor) => any;

package/dist/use.js

@@ -1,11 +1,61 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Use = Use;
-const constants_1 = require("./constants");
+const shared_1 = require("./utils/shared");
+/**
+ * Decorator to register middleware(s) at the controller or method level.
+ *
+ * Middlewares are functions executed before the route handler.
+ * They can be used to:
+ * - modify request/response
+ * - perform logging
+ * - handle authentication/authorization
+ * - short-circuit request handling
+ *
+ * @param middleware - A single middleware function or an array of middleware functions.
+ *
+ * @returns A decorator that attaches middleware metadata to the target
+ * (either a class or a method).
+ *
+ * @example
+ * // Single middleware
+ * @Use((req, res, next) => {
+ *   console.log('Request received');
+ *   next();
+ * })
+ * class MyController {}
+ *
+ * @example
+ * // Multiple middlewares
+ * @Use([
+ *   authMiddleware,
+ *   loggingMiddleware,
+ * ])
+ * class MyController {}
+ *
+ * @example
+ * // Method-level middleware
+ * class MyController {
+ *   @Use(authMiddleware)
+ *   getData() {}
+ * }
+ *
+ * @remarks
+ * - Middlewares are executed in the order they are defined.
+ * - Can be applied at both class and method levels.
+ * - Metadata is stored using the MIDDLEWARES_CONFIG key and used
+ *   internally by the framework during request handling.
+ */
 function Use(middleware) {
-    return function (target) {
-        const existed = Reflect.getMetadata(constants_1.USE_MIDDLEWARE, target) || [];
-        Reflect.defineMetadata(constants_1.USE_MIDDLEWARE, existed.concat(middleware).reverse(), target);
+    return function (target, propertyKey, descriptor) {
+        const middlewares = Array.isArray(middleware) ? middleware : [middleware];
+        const data = { middlewares };
+        if (descriptor) {
+            (0, shared_1.defineMiddlewaresMeta)(data, target, propertyKey);
+        }
+        else {
+            (0, shared_1.defineMiddlewaresMeta)(data, target);
+        }
         return target;
     };
 }

package/dist/use.js.map

@@ -1 +1 @@
-{"version":3,"file":"use.js","sourceRoot":"","sources":["../src/use.ts"],"names":[],"mappings":";;AAGA,kBAQC;AAXD,2CAA6C;AAG7C,SAAgB,GAAG,CAAC,UAAyC;IAC3D,OAAO,UAAU,MAAW;QAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,0BAAc,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAElE,OAAO,CAAC,cAAc,CAAC,0BAAc,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;QAErF,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../src/use.ts"],"names":[],"mappings":";;AA+CA,kBAcC;AA5DD,2CAAuD;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,SAAgB,GAAG,CAAC,UAAyC;IAC3D,OAAO,UAAU,MAAW,EAAE,WAAoB,EAAE,UAA+B;QACjF,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAE1E,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,CAAC;QAE7B,IAAI,UAAU,EAAE,CAAC;YACf,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,IAAA,8BAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

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

@@ -1 +1,10 @@
+import 'reflect-metadata';
+import { ControllerMeta, MiddlewaresMetadata, RouteMetadata } from '../../types/core/controller';
 export declare const generateUniqueId: () => string;
+export declare function reflectControllerMeta(target: object): ControllerMeta;
+export declare function defineControllerMeta(meta: Partial<ControllerMeta>, target: object): void;
+export declare function reflectMiddlewaresMetadata(target: any, propertie?: string): MiddlewaresMetadata;
+export declare function reflectRouteMetadata(target: object, popertie: string): RouteMetadata;
+export declare function defineMiddlewaresMeta(meta: Partial<MiddlewaresMetadata>, target: object): void;
+export declare function defineMiddlewaresMeta(meta: Partial<MiddlewaresMetadata>, target: object, propertie?: string): void;
+export declare function defineRouteMeta(meta: Partial<RouteMetadata>, target: object, propertie: string): void;

package/dist/utils/shared/helpers.js

@@ -1,8 +1,91 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateUniqueId = void 0;
+exports.reflectControllerMeta = reflectControllerMeta;
+exports.defineControllerMeta = defineControllerMeta;
+exports.reflectMiddlewaresMetadata = reflectMiddlewaresMetadata;
+exports.reflectRouteMetadata = reflectRouteMetadata;
+exports.defineMiddlewaresMeta = defineMiddlewaresMeta;
+exports.defineRouteMeta = defineRouteMeta;
+require("reflect-metadata");
+const constants_1 = require("../../constants");
 const generateUniqueId = () => {
     return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
 };
 exports.generateUniqueId = generateUniqueId;
+function reflectControllerMeta(target) {
+    const data = Reflect.getMetadata(constants_1.DECORATOR.controller, target) ?? {};
+    if (!data['controllers']) {
+        data['controllers'] = [];
+    }
+    return data;
+}
+function defineControllerMeta(meta, target) {
+    const existed = reflectControllerMeta(target);
+    const merged = Object.entries(meta).reduce((acc, [key, value]) => {
+        if (Array.isArray(acc[key])) {
+            acc[key] = acc[key].concat(value);
+        }
+        else {
+            acc[key] = value;
+        }
+        return acc;
+    }, existed);
+    Reflect.defineMetadata(constants_1.DECORATOR.controller, merged, target);
+}
+function reflectMiddlewaresMetadata(target, propertie) {
+    let data;
+    if (propertie) {
+        data = Reflect.getMetadata(constants_1.DECORATOR.middlewares, target, propertie) ?? {};
+    }
+    else {
+        data = Reflect.getMetadata(constants_1.DECORATOR.middlewares, target) ?? {};
+    }
+    ['middlewares', 'errors', 'guards', 'pipes', 'cors', 'sanitizers', 'interceptors'].forEach((prop) => {
+        if (!data[prop]?.length) {
+            data[prop] = [];
+        }
+    });
+    return data;
+}
+function reflectRouteMetadata(target, popertie) {
+    const data = Reflect.getMetadata(constants_1.DECORATOR.route, target, popertie) ?? {};
+    ['parameters', 'middlewares'].forEach((prop) => {
+        if (!data[prop]?.length) {
+            data[prop] = [];
+        }
+    });
+    return data;
+}
+function defineMiddlewaresMeta(meta, target, propertie) {
+    const existed = reflectMiddlewaresMetadata(target, propertie);
+    const merged = Object.entries(meta).reduce((acc, [key, value]) => {
+        if (Array.isArray(acc[key])) {
+            acc[key] = acc[key].concat(value);
+        }
+        else {
+            acc[key] = value;
+        }
+        return acc;
+    }, existed);
+    if (propertie) {
+        Reflect.defineMetadata(constants_1.DECORATOR.middlewares, merged, target, propertie);
+    }
+    else {
+        Reflect.defineMetadata(constants_1.DECORATOR.middlewares, merged, target);
+    }
+}
+function defineRouteMeta(meta, target, propertie) {
+    const existed = reflectRouteMetadata(target, propertie);
+    const merged = Object.entries(meta).reduce((acc, [key, value]) => {
+        if (Array.isArray(acc[key])) {
+            acc[key] = acc[key].concat(value);
+        }
+        else {
+            acc[key] = value;
+        }
+        return acc;
+    }, existed);
+    Reflect.defineMetadata(constants_1.DECORATOR.route, merged, target, propertie);
+}
 //# sourceMappingURL=helpers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/utils/shared/helpers.ts"],"names":[],"mappings":";;;AAAO,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACnC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC,CAAC;AAFW,QAAA,gBAAgB,oBAE3B"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/utils/shared/helpers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heliosjs/middlewares",
-  "version": "2.0.2",
+  "version": "4.0.0",
   "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": "^1.4.2",
+    "@heliosjs/core": "^2.1.0",
     "typescript": ">=4.0.0"
   }
 }