quantum-flow 1.0.5 → 1.1.0

package/README.md

@@ -23,11 +23,14 @@ Use the `@Controller` decorator to define controllers with options such as prefi
 ```typescript
 import { Controller } from 'quantum-flow/core';
 
+@Controller(api, [...middlewares])
 @Controller({
   prefix: 'api',
   controllers: [UserController, SocketController],
-  interceptors: [(resp) => resp],
+  middelwares: [...middlewares],
+  interceptor: (parsedRequest, httpRequest, httpResponse) => parsedRequest,
 })
+@Catch((error) => ({ status: 400, error }))
 class RootController {}
 ```
 
@@ -36,16 +39,14 @@ class RootController {}
 Use the `@Server` decorator with configuration options like port, host, controllers, and WebSocket enablement.
 
 ```typescript
-import { Server, Port, Host, Use, Intercept, Catch, HttpServer } from 'quantum-flow/http';
+import { Server, Port, Host, Use, Catch, HttpServer } from 'quantum-flow/http';
 
-@Server({
-  controllers: [RootController],
-})
+@Server({ controllers: [RootController] })
 @Port(3000)
 @Host('localhost')
-@Use((res: any) => res)
-@Intercept((data, req, res) => data)
-@Catch((error) => error)
+@Use((data) => data)
+@Use((data) => data)
+@Catch((error) => ({ status: 400, error }))
 class App {}
 
 const server = new HttpServer(App);
@@ -56,7 +57,6 @@ server.listen().catch(console.error);
 ## Middlewares, Interceptors, and Error Handlers
 
 - Use `@Use` to apply middlewares.
-- Use `@Intercept` to apply interceptors.
 - Use `@Catch` to handle errors.
 - Use `@Port` and `@Host` to configure server port and host.
 
@@ -66,11 +66,10 @@ server.listen().catch(console.error);
 - Use `@Headers` to access request headers.
 - Use `@Query` to handle query parameters.
 - Use `@Params` to access route parameters.
-- Use `@Host` to configure the server host.
-- Use `@Port` to configure the server port.
 - Use `@Multipart` for handling multipart/form-data requests.
-- Use `@Request` to access the entire request object.
-- Use `@Response` to access the response object.
+- Use `@Request` to access the original request object.
+- Use `@Response` to access the original object.
+- Use `@InjectWS` to access the WebsocketService.
 
 # AWS Lambda Support
 
@@ -79,6 +78,20 @@ Use `LambdaAdapter` to convert API Gateway events to requests and responses. Cre
 ```typescript
 Example Lambda handler creation
 import { LambdaAdapter } from 'quantum-flow/aws';
+
+let dbConnection = null;
+
+@Controller({
+  prefix: 'api',
+  controllers: [UserController, SocketController],
+})
+class RootController {
+  async beforeStart(){
+    if(!dbConnection){
+      connection = await connect()
+    }
+  }
+}
 export const handler = LambdaAdapter.createHandler(RootController);
 ```
 
@@ -165,11 +178,20 @@ export class Socket {
     );
   }
 }
+```
+
+# Http server configuration
+
+```typescript
 @Server({
-  controllers: [Socket],
+  controllers: [Root],
   websocket: { enabled: true },
+  interceptor: (data) => data,
 })
-@Use(middleware)
+@Port(3000)
+@Use((data) => data)
+@Use((data) => data)
+@Catch((error) => ({ status: 400, error }))
 class App {}
 ```
 
@@ -205,15 +227,6 @@ Class decorator to add global middlewares to the server.
 class App {}
 ```
 
-### Intercept
-
-Class decorator to add global interceptors to the server.
-
-```typescript
-@Intercept(interceptor)
-class App {}
-```
-
 ### Catch
 
 Class decorator to set a global error handler for the server.
@@ -248,6 +261,7 @@ class App {}
 Method or class decorator to validate request parameters (query, body, params, headers) against a DTO class using class-validator.
 
 ```typescript
+import { IsEmail } from 'class-validator';
 class UserDTO {
   @IsEmail()
   email: string;

package/dist/app/aws/decorators.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parameter decorator to inject AWS lambda event.
+ */
+export declare const LambdaEvent: () => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;
+/**
+ * Parameter decorator to inject AWS lambda context.
+ */
+export declare const LambdaContext: () => (target: any, propertyKey: string | symbol, parameterIndex: number) => void;

package/dist/app/aws/decorators.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LambdaContext = exports.LambdaEvent = void 0;
+const _utils_1 = require("../../utils/index.js");
+/**
+ * Parameter decorator to inject AWS lambda event.
+ */
+const LambdaEvent = () => (0, _utils_1.createParamDecorator)('event');
+exports.LambdaEvent = LambdaEvent;
+/**
+ * Parameter decorator to inject AWS lambda context.
+ */
+const LambdaContext = () => (0, _utils_1.createParamDecorator)('context');
+exports.LambdaContext = LambdaContext;

package/dist/app/aws/index.d.ts

@@ -1 +1,2 @@
 export * from './lambda';
+export * from './decorators';

package/dist/app/aws/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lambda"), exports);
+__exportStar(require("./decorators"), exports);

package/dist/app/aws/lambda.d.ts

@@ -1,11 +1,11 @@
 import { APIGatewayProxyEvent, APIGatewayProxyResult, Context, Handler } from 'aws-lambda';
-import { LambdaRequest, LambdaResponse } from '../../types/index.js';
+import { LambdaRequest, LambdaResponse, LambdaApp } from '../../types/index.js';
 export declare class LambdaAdapter {
     private static getHeaderValue;
     static toRequest(event: APIGatewayProxyEvent, context: Context): LambdaRequest;
     static createResponseBody(response: any): any;
     static toLambdaResponse(response: any, request?: LambdaRequest): LambdaResponse;
-    static createHandler(Contoller: any): Handler<APIGatewayProxyEvent, APIGatewayProxyResult>;
+    static createHandler(Contoller: new (...args: any[]) => LambdaApp): Handler<APIGatewayProxyEvent, APIGatewayProxyResult>;
     private static safeHeaders;
     private static safeParams;
     private static getSourceIp;

package/dist/app/aws/lambda.js

@@ -63,7 +63,7 @@ class LambdaAdapter {
             body,
             params: this.safeParams(event.pathParameters),
             cookies,
-            raw: event,
+            event,
             context,
             isBase64Encoded: event.isBase64Encoded || false,
             requestId: context.awsRequestId,
@@ -156,6 +156,9 @@ class LambdaAdapter {
     static createHandler(Contoller) {
         const handler = async (event, context) => {
             const instance = new Contoller();
+            if (Object.hasOwn(instance, 'beforeStart')) {
+                await instance.beforeStart?.();
+            }
             try {
                 const request = LambdaAdapter.toRequest(event, context);
                 if (typeof instance.handleRequest === 'function') {

package/dist/app/http/Application.d.ts

@@ -17,7 +17,6 @@ export declare class HttpServer extends Socket {
     private createRequest;
     private applyMiddlewares;
     private findController;
-    private applyInterceptors;
     private sendResponse;
     private handleError;
 }

package/dist/app/http/Application.js

@@ -35,9 +35,11 @@ class HttpServer extends Socket_1.Socket {
 ║  📍 Host: ${this.config.host}                       
 ║  🔌 Port: ${this.config.port}                         
 ║  🔌 Websocket: ${!!this.config.websocket}                         
-║  🔧 Middlewares: ${this.config.globalMiddlewares?.length || 0}                   
-║  🎯 Interceptors: ${this.config.globalInterceptors?.length || 0}                   
-║  📦 Controllers: ${this.config.controllers?.length || 0}                   
+║  🔧 Global Middlewares: ${this.config.middlewares?.length || 0}                   
+║  🔧 Error middlewares: ${this.config.errorHandler?.length || 0}                   
+║  🎯 Global Interceptors: ${!!this.config.interceptor?.length}                   
+║  📦 Controllers: ${_constants_1.STATISTIC.controllers}                   
+║  📦 Routes: ${_constants_1.STATISTIC.routes}                   
 ╚════════════════════════════════════════╝
     `);
     }
@@ -99,10 +101,12 @@ class HttpServer extends Socket_1.Socket {
         const startTime = Date.now();
         try {
             const request = await this.createRequest(req);
-            let processedRequest = await this.applyMiddlewares(request, res);
-            const data = await this.findController(processedRequest, res);
-            const finalResponse = await this.applyInterceptors(data, request, res);
-            await this.sendResponse(res, finalResponse, startTime);
+            let appRequest = await this.applyMiddlewares(request, req, res);
+            let data = await this.findController(appRequest, req, res);
+            if (this.config.interceptor) {
+                data = await this.config.interceptor(data, req, res);
+            }
+            await this.sendResponse(res, data, startTime);
         }
         catch (error) {
             await this.handleError(error, req, res, startTime);
@@ -121,9 +125,8 @@ class HttpServer extends Socket_1.Socket {
         const fullUrl = `${protocol}://${host}${req.url}`;
         const whatwgUrl = new URL(fullUrl);
         return {
-            method: req.method,
+            method: req.method?.toUpperCase(),
             url: whatwgUrl,
-            path: whatwgUrl.pathname,
             headers: req.headers,
             body: parsedBody,
             rawBody: rawBody,
@@ -134,21 +137,21 @@ class HttpServer extends Socket_1.Socket {
             _startTime: Date.now(),
         };
     }
-    async applyMiddlewares(request, res) {
-        let processed = request;
-        for (const middleware of this.config.globalMiddlewares || []) {
-            const result = await middleware(processed, res);
+    async applyMiddlewares(appRequest, request, response) {
+        let processed = appRequest;
+        for (const middleware of this.config.middlewares?.reverse() || []) {
+            const result = await middleware(processed, request, response);
             if (result) {
-                processed = { ...processed, ...result };
+                processed = result;
             }
         }
         return processed;
     }
-    async findController(request, response) {
+    async findController(appRequest, request, response) {
         for (const ControllerClass of this.config.controllers || []) {
             const instance = new ControllerClass();
             if (typeof instance.handleRequest === 'function') {
-                const data = await instance.handleRequest(request, response);
+                const data = await instance.handleRequest(appRequest, request, response);
                 if (data && data.status !== 404) {
                     return data;
                 }
@@ -156,18 +159,11 @@ class HttpServer extends Socket_1.Socket {
         }
         return {
             status: 404,
-            data: { message: `Route ${request.method} ${request.path} not found` },
+            data: { message: `Route ${appRequest.method} ${appRequest.url.pathname} not found` },
         };
     }
-    async applyInterceptors(data, request, response) {
-        let processed = data;
-        for (const interceptor of this.config.globalInterceptors || []) {
-            processed = await interceptor(processed, request, response);
-        }
-        return processed;
-    }
     async sendResponse(res, data, startTime) {
-        const resp = data?.data !== undefined ? data.data : data;
+        const response = data?.data !== undefined ? data.data : data;
         if (!res.headersSent) {
             if (!res.getHeader('Content-Type')) {
                 res.setHeader('Content-Type', 'application/json');
@@ -182,9 +178,9 @@ class HttpServer extends Socket_1.Socket {
         }
         res.setHeader('X-Response-Time', `${Date.now() - startTime}ms`);
         res.statusCode = data.status ?? 200;
-        res.end(JSON.stringify(resp));
+        res.end(JSON.stringify(response));
     }
-    async handleError(error, req, res, startTime) {
+    async handleError(error, request, response, startTime) {
         let errorResponse = {
             status: error.status || 500,
             data: {
@@ -192,17 +188,17 @@ class HttpServer extends Socket_1.Socket {
                 errors: error.errors || [],
             },
         };
-        if (!this.config.globalErrorHandler) {
-            return this.sendResponse(res, errorResponse, startTime);
+        if (!this.config.errorHandler) {
+            return this.sendResponse(response, errorResponse, startTime);
         }
         try {
-            const intercepted = await this.config.globalErrorHandler(error, req, res);
-            errorResponse = { ...errorResponse, ...intercepted };
+            const intercepted = await this.config.errorHandler(error, request, response);
+            errorResponse = intercepted;
         }
         catch (cathed) {
             Object.assign(errorResponse, cathed);
         }
-        return this.sendResponse(res, errorResponse, startTime);
+        return this.sendResponse(response, errorResponse, startTime);
     }
 }
 exports.HttpServer = HttpServer;

package/dist/app/http/decorators.d.ts

@@ -1,7 +1,4 @@
-import { Conf, Interceptor } from '../../types/index.js';
-export declare function Server(config?: Conf): (target: any) => any;
-export declare function Use(middleware: any): (target: any) => any;
-export declare function Intercept(interceptor: Interceptor): (target: any) => any;
-export declare function Catch(handler: any): (target: any) => any;
+import { ServerConfig } from '../../types/index.js';
+export declare function Server(config?: ServerConfig): (target: any) => any;
 export declare function Port(port: number): (target: any) => any;
 export declare function Host(host: string): (target: any) => any;

package/dist/app/http/decorators.js

@@ -1,9 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Server = Server;
-exports.Use = Use;
-exports.Intercept = Intercept;
-exports.Catch = Catch;
 exports.Port = Port;
 exports.Host = Host;
 const _constants_1 = require("../../constants.js");
@@ -14,8 +11,8 @@ function Server(config = {}) {
             ...existingConfig,
             ...config,
             controllers: [...(existingConfig.controllers || []), ...(config.controllers || [])],
-            globalMiddlewares: existingConfig.globalMiddlewares || config.globalMiddlewares,
-            globalInterceptors: existingConfig.globalInterceptors || config.globalInterceptors || [],
+            middlewares: [...(existingConfig.middlewares ?? []), ...(config.middlewares ?? [])],
+            interceptors: existingConfig.interceptor ?? config.interceptor,
         };
         Reflect.defineMetadata(_constants_1.SERVER_CONFIG_KEY, mergedConfig, target);
         if (config.controllers) {
@@ -24,41 +21,6 @@ function Server(config = {}) {
         return target;
     };
 }
-function Use(middleware) {
-    return function (target) {
-        const existingConfig = Reflect.getMetadata(_constants_1.SERVER_CONFIG_KEY, target) || {};
-        const middlewares = existingConfig.globalMiddlewares || [];
-        middlewares.push(middleware);
-        console.log(middlewares);
-        Reflect.defineMetadata(_constants_1.SERVER_CONFIG_KEY, {
-            ...existingConfig,
-            globalMiddlewares: middlewares,
-        }, target);
-        return target;
-    };
-}
-function Intercept(interceptor) {
-    return function (target) {
-        const existingConfig = Reflect.getMetadata(_constants_1.SERVER_CONFIG_KEY, target) || {};
-        const interceptors = existingConfig.globalInterceptors || [];
-        interceptors.push(interceptor);
-        Reflect.defineMetadata(_constants_1.SERVER_CONFIG_KEY, {
-            ...existingConfig,
-            globalInterceptors: interceptors,
-        }, target);
-        return target;
-    };
-}
-function Catch(handler) {
-    return function (target) {
-        const existingConfig = Reflect.getMetadata(_constants_1.SERVER_CONFIG_KEY, target) || {};
-        Reflect.defineMetadata(_constants_1.SERVER_CONFIG_KEY, {
-            ...existingConfig,
-            globalErrorHandler: handler,
-        }, target);
-        return target;
-    };
-}
 function Port(port) {
     return function (target) {
         const existingConfig = Reflect.getMetadata(_constants_1.SERVER_CONFIG_KEY, target) || {};

package/dist/constants.d.ts

@@ -1,16 +1,22 @@
 export declare const PARAM_METADATA_KEY = "design:parameters";
 export declare const APP_METADATA_KEY = "app:configuration";
-export declare const ROUTE_PREFIX = "route:profix";
-export declare const MIDDLEWARES = "route:middlewares";
+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 INTERCEPTORS = "app:interceptors";
+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 SERVER_MODULES_KEY = "server:modules";
+export declare const USE_MIDDLEWARE = "controller:usemiddleware";
 export declare const WS_METADATA_KEY = "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 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 STATISTIC: Record<'controllers' | 'routes', number>;
+export declare const INCREMENT_STATISTIC: (prop: "controllers" | "routes") => void;

package/dist/constants.js

@@ -1,19 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TO_VALIDATE = exports.OK_STATUSES = exports.STOPPED = exports.WS_SERVICE_KEY = exports.WS_TOPIC_KEY = exports.WS_METADATA_KEY = exports.SERVER_MODULES_KEY = exports.SERVER_CONFIG_KEY = exports.OK_METADATA_KEY = exports.ENDPOINT = exports.INTERCEPTORS = exports.CONTROLLERS = exports.MIDDLEWARES = exports.ROUTE_PREFIX = exports.APP_METADATA_KEY = exports.PARAM_METADATA_KEY = void 0;
+exports.INCREMENT_STATISTIC = exports.STATISTIC = exports.TO_VALIDATE = exports.OK_STATUSES = exports.STOPPED = exports.CATCH = exports.INTECEPT = exports.WS_SERVICE_KEY = exports.WS_TOPIC_KEY = exports.WS_METADATA_KEY = exports.USE_MIDDLEWARE = exports.SERVER_MODULES_KEY = 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:profix';
-exports.MIDDLEWARES = 'route:middlewares';
+exports.ROUTE_PREFIX = 'route:prefix';
+exports.ROUTE_MIDDLEWARES = 'route:middlewares';
+exports.MIDDLEWARES = 'controller:middlewares';
 exports.CONTROLLERS = 'app:controllers';
-exports.INTERCEPTORS = 'app:interceptors';
+exports.INTERCEPTOR = 'app:interceptors';
 exports.ENDPOINT = 'route:endpoints';
 exports.OK_METADATA_KEY = 'custom:ok';
 exports.SERVER_CONFIG_KEY = 'server:config';
 exports.SERVER_MODULES_KEY = 'server:modules';
+exports.USE_MIDDLEWARE = 'controller:usemiddleware';
 exports.WS_METADATA_KEY = 'websocket:handler';
 exports.WS_TOPIC_KEY = 'websocket:topic';
 exports.WS_SERVICE_KEY = 'websocket:service';
+exports.INTECEPT = 'server:intercept';
+exports.CATCH = 'server:catch';
 exports.STOPPED = `
 ╔════════════════════════════════════════╗
 ║  👋 Server stopped                      ║
@@ -22,3 +26,11 @@ exports.STOPPED = `
           `;
 exports.OK_STATUSES = [200, 201, 202, 203, 204, 205, 206, 207, 208, 226];
 exports.TO_VALIDATE = ['headers', 'params', 'multipart', 'query', 'body'];
+exports.STATISTIC = {
+    controllers: 0,
+    routes: 0,
+};
+const INCREMENT_STATISTIC = (prop) => {
+    exports.STATISTIC[prop] = exports.STATISTIC[prop] + 1;
+};
+exports.INCREMENT_STATISTIC = INCREMENT_STATISTIC;

package/dist/core/Controller.d.ts

@@ -1,16 +1,6 @@
-import { Interceptor, Middleware } from '../types/index.js';
-import { ServerResponse } from 'http';
+import { AppRequest, ControllerClass, ControllerConfig, ControllerInstance, InterceptorCB, RouteContext } from '../types/index.js';
+import { IncomingMessage, ServerResponse } from 'http';
 import 'reflect-metadata';
-type ControllerClass = {
-    new (...args: any[]): any;
-};
-type ControllerInstance = InstanceType<ControllerClass>;
-interface ControllerConfig {
-    prefix: string;
-    middlewares?: Array<Middleware>;
-    controllers?: ControllerClass[];
-    interceptors?: Array<(...args: any[]) => any> | ((...args: any[]) => any);
-}
 /**
  * Class decorator to define a controller with optional configuration.
  *
@@ -32,33 +22,31 @@ interface ControllerConfig {
  *
  * @returns A class decorator function that enhances the controller class.
  */
-export declare function Controller(config: string | ControllerConfig, middlewares?: Array<Interceptor>): <T extends ControllerClass>(constructor: T) => {
+export declare function Controller(config: string | ControllerConfig, middlewares?: Array<InterceptorCB>): <T extends ControllerClass>(constructor: T) => {
     new (...args: any[]): {
         [x: string]: any;
-        executeControllerMethod: (controller: import("../types/index.js").ControllerInstance, propertyName: string, payload: any, response?: ServerResponse) => Promise<any>;
-        getControllerMethods: (controller: import("../types/index.js").ControllerInstance) => {
-            name: string;
-            httpMethod: string;
-            pattern: string;
-            middlewares?: Array<(req: any, res?: ServerResponse) => any>;
-        }[];
+        executeControllerMethod: (controller: ControllerInstance, propertyName: string, payload: any, request?: IncomingMessage, response?: ServerResponse) => Promise<any>;
+        getControllerMethods: (controller: ControllerInstance) => import("../types/index.js").ControllerMethods;
         getResponse(data: {
             controllerInstance: ControllerInstance;
             name: string;
             payload: any;
-            interceptors: Array<(...args: any[]) => any | Promise<any>>;
+            interceptors: InterceptorCB[];
+            request?: IncomingMessage;
             response?: ServerResponse;
         }): Promise<{
             status: any;
             data: any;
         }>;
-        handleRequest: (request: any, response?: ServerResponse) => Promise<{
-            status: any;
-            data: any;
-        } | {
-            status: number;
-            message: string;
-        }>;
+        handleRequest: (appRequest: AppRequest, request?: IncomingMessage, response?: ServerResponse) => Promise<any>;
+        routeWalker(context: RouteContext): Promise<any>;
+        getAllMethods(obj: any): string[];
+        findRouteInController(instance: any, path: string, route: string, method: string): {
+            name: string;
+            pathParams: Record<string, string>;
+            priority: number;
+            methodMiddlewares: any[];
+            methodInterceptors: any[];
+        };
     };
 } & T;
-export {};