@expressots/adapter-express 1.2.0 → 1.2.2

package/lib/CHANGELOG.md

@@ -1,5 +1,20 @@
 
 
+## [1.2.2](https://github.com/expressots/adapter-express/compare/1.2.1...1.2.2) (2024-04-25)
+
+
+### Bug Fixes
+
+* validate parameter types in param decorator by default ([b7a8657](https://github.com/expressots/adapter-express/commit/b7a8657598ce51a6fa44c3a388d38106b47ad70d))
+
+## [1.2.1](https://github.com/expressots/adapter-express/compare/1.2.0...1.2.1) (2024-04-04)
+
+
+### Code Refactoring
+
+* adapter expressto to be used in AppFactory ([239501e](https://github.com/expressots/adapter-express/commit/239501e41bfd98ecc0893a50c34de58dd8914d9e))
+* rename items for standardization and improve doc ([2e691d5](https://github.com/expressots/adapter-express/commit/2e691d50731e8d4d689fe4b4420daab8ba2f5803))
+
 ## [1.2.0](https://github.com/expressots/adapter-express/compare/1.1.1...1.2.0) (2024-3-5)
 
 

package/lib/cjs/adapter-express/application-express.js

@@ -5,50 +5,32 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServerEnvironment = exports.AppExpress = void 0;
+exports.AppExpress = void 0;
+const core_1 = require("@expressots/core");
 const inversify_binding_decorators_1 = require("inversify-binding-decorators");
 const process_1 = __importDefault(require("process"));
-const core_1 = require("@expressots/core");
+const application_express_base_1 = require("./application-express.base");
 const inversify_express_server_1 = require("./express-utils/inversify-express-server");
-const application_base_1 = require("./application-base");
-/**
- * Abstract class for creating custom Expresso middleware.
- * Custom middleware classes should extend this class and implement the use method.
- *
- */
-class ExpressoMiddleware {
-    get name() {
-        return this.constructor.name;
-    }
-}
-/**
- * Enum representing possible server environments.
- */
-var ServerEnvironment;
-(function (ServerEnvironment) {
-    ServerEnvironment["Development"] = "development";
-    ServerEnvironment["Production"] = "production";
-})(ServerEnvironment || (exports.ServerEnvironment = ServerEnvironment = {}));
+const application_express_types_1 = require("./application-express.types");
 /**
- * The Application class provides a way to configure and manage an Express application.
- * @provide Application
+ * The AppExpress class provides methods for configuring and running an Express application.
+ * @class AppExpress
+ * @implements {IWebServer} - Interface for the WebServer application implementation.
+ * @extends {ApplicationBase} - Base class for the application implementation that provides lifecycle hooks.
+ * @method configure - Configures the InversifyJS container.
+ * @method listen - Start listening on the given port and environment.
+ * @method setGlobalRoutePrefix - Sets the global route prefix for the application.
+ * @method setEngine - Configures the application's view engine based on the provided configuration options.
+ * @method isDevelopment - Verifies if the current environment is development.
  */
-let ApplicationExpress = class ApplicationExpress extends application_base_1.ApplicationBase {
+let AppExpress = class AppExpress extends application_express_base_1.ApplicationBase {
     constructor() {
         super(...arguments);
+        this.globalPrefix = "/";
         this.middlewares = [];
     }
     configureServices() { }
@@ -61,40 +43,46 @@ let ApplicationExpress = class ApplicationExpress extends application_base_1.App
         this.serverShutdown();
         process_1.default.exit(0);
     }
+    /**
+     * Configures the InversifyJS container.
+     * @param container - The InversifyJS container.
+     */
+    async configure(container) {
+        this.container = container;
+        this.console = this.container.get(core_1.Console);
+    }
     /**
      * Configures the Express application with the provided middleware entries.
      * @param app - The Express application instance.
      * @param middlewareEntries - An array of Express middleware entries to be applied.
      */
-    configureMiddleware(app, middlewareEntries) {
-        return __awaiter(this, void 0, void 0, function* () {
-            for (const entry of middlewareEntries) {
-                if (typeof entry === "function") {
-                    app.use(entry);
-                    // eslint-disable-next-line no-prototype-builtins
-                }
-                else if (entry === null || entry === void 0 ? void 0 : entry.hasOwnProperty("path")) {
-                    const { path, middlewares } = entry;
-                    for (const mid of middlewares) {
-                        if (path) {
-                            if (typeof mid === "function") {
-                                app.use(path, mid);
-                            }
-                            else {
-                                const middleware = mid;
-                                middleware.use = middleware.use.bind(middleware);
-                                app.use(path, middleware.use);
-                            }
+    async configureMiddleware(app, middlewareEntries) {
+        for (const entry of middlewareEntries) {
+            if (typeof entry === "function") {
+                app.use(entry);
+                // eslint-disable-next-line no-prototype-builtins
+            }
+            else if (entry?.hasOwnProperty("path")) {
+                const { path, middlewares } = entry;
+                for (const mid of middlewares) {
+                    if (path) {
+                        if (typeof mid === "function") {
+                            app.use(path, mid);
+                        }
+                        else {
+                            const middleware = mid;
+                            middleware.use = middleware.use.bind(middleware);
+                            app.use(path, middleware.use);
                         }
                     }
                 }
-                else {
-                    const middleware = entry;
-                    middleware.use = middleware.use.bind(middleware);
-                    app.use(middleware.use);
-                }
             }
-        });
+            else {
+                const middleware = entry;
+                middleware.use = middleware.use.bind(middleware);
+                app.use(middleware.use);
+            }
+        }
     }
     /**
      * Create and configure the Express application.
@@ -102,41 +90,25 @@ let ApplicationExpress = class ApplicationExpress extends application_base_1.App
      * @param middlewares - An array of Express middlewares to be applied.
      * @returns The configured Application instance.
      */
-    init(container, middlewares = []) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.configureServices();
-            const middleware = container.get(core_1.Middleware);
-            const sortedMiddlewarePipeline = middleware.getMiddlewarePipeline();
-            const pipeline = sortedMiddlewarePipeline.map((entry) => entry.middleware);
-            this.middlewares.push(...middlewares, ...pipeline);
-            const expressServer = new inversify_express_server_1.InversifyExpressServer(container, null, {
-                rootPath: this.globalPrefix,
-            });
-            expressServer.setConfig((app) => {
-                this.configureMiddleware(app, this.middlewares);
-            });
-            expressServer.setErrorConfig((app) => {
-                if (middleware.getErrorHandler()) {
-                    app.use(middleware.getErrorHandler());
-                }
-            });
-            this.app = expressServer.build();
-            return this;
+    async init() {
+        await this.configureServices();
+        const middleware = this.container.get(core_1.Middleware);
+        const sortedMiddlewarePipeline = middleware.getMiddlewarePipeline();
+        const pipeline = sortedMiddlewarePipeline.map((entry) => entry.middleware);
+        this.middlewares.push(...pipeline);
+        const expressServer = new inversify_express_server_1.InversifyExpressServer(this.container, null, {
+            rootPath: this.globalPrefix,
         });
-    }
-    /**
-     * Create and configure the Express application.
-     * @param container - The InversifyJS container.
-     * @param middlewares - An array of Express middlewares to be applied.
-     * @returns The configured Application instance.
-     */
-    create(container, middlewares = []) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.container = container;
-            this.middlewares = middlewares;
-            this.globalPrefix = this.globalPrefix || "/";
-            return this;
+        expressServer.setConfig((app) => {
+            this.configureMiddleware(app, this.middlewares);
         });
+        expressServer.setErrorConfig((app) => {
+            if (middleware.getErrorHandler()) {
+                app.use(middleware.getErrorHandler());
+            }
+        });
+        this.app = expressServer.build();
+        return this;
     }
     /**
      * Start listening on the given port and environment.
@@ -144,23 +116,18 @@ let ApplicationExpress = class ApplicationExpress extends application_base_1.App
      * @param environment - The server environment.
      * @param consoleMessage - Optional message to display in the console.
      */
-    listen(port, environment, consoleMessage) {
-        return __awaiter(this, void 0, void 0, function* () {
-            /* Initializes the application and executes the middleware pipeline */
-            yield this.init(this.container, this.middlewares);
-            /* Sets the port and environment */
-            this.port = port;
-            this.environment = environment;
-            this.app.set("env", environment);
-            this.app.listen(this.port, () => {
-                const console = this.container.get(core_1.Console);
-                console.messageServer(this.port, this.environment, consoleMessage);
-                ["SIGTERM", "SIGHUP", "SIGBREAK", "SIGQUIT", "SIGINT"].forEach((signal) => {
-                    process_1.default.on(signal, this.handleExit.bind(this));
-                });
+    async listen(port, environment, consoleMessage) {
+        await this.init();
+        this.port = port;
+        this.environment = environment;
+        this.app.set("env", environment);
+        this.app.listen(this.port, () => {
+            this.console.messageServer(this.port, this.environment, consoleMessage);
+            ["SIGTERM", "SIGHUP", "SIGBREAK", "SIGQUIT", "SIGINT"].forEach((signal) => {
+                process_1.default.on(signal, this.handleExit.bind(this));
             });
-            yield Promise.resolve(this.postServerInitialization());
         });
+        await this.postServerInitialization();
     }
     /**
      * Sets the global route prefix for the application.
@@ -200,24 +167,15 @@ let ApplicationExpress = class ApplicationExpress extends application_base_1.App
      */
     isDevelopment() {
         if (this.app) {
-            return this.app.get("env") === ServerEnvironment.Development;
+            return this.app.get("env") === application_express_types_1.ServerEnvironment.Development;
         }
         this.container
             .get(core_1.Logger)
             .error("isDevelopment() method must be called on `PostServerInitialization`", "application");
         return false;
     }
-    /**
-     * Verifies if the current environment is production.
-     *
-     * @returns A boolean value indicating whether the current environment is production or not.
-     *
-     */
-    get ExpressApp() {
-        return this.app;
-    }
 };
-exports.AppExpress = ApplicationExpress;
-exports.AppExpress = ApplicationExpress = __decorate([
-    (0, inversify_binding_decorators_1.provide)(ApplicationExpress)
-], ApplicationExpress);
+exports.AppExpress = AppExpress;
+exports.AppExpress = AppExpress = __decorate([
+    (0, inversify_binding_decorators_1.provide)(AppExpress)
+], AppExpress);

package/lib/cjs/adapter-express/application-express.types.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServerEnvironment = exports.ExpressoMiddleware = void 0;
+/**
+ * Abstract class for creating custom Expresso middleware.
+ * Custom middleware classes should extend this class and implement the use method.
+ *
+ */
+class ExpressoMiddleware {
+    get name() {
+        return this.constructor.name;
+    }
+}
+exports.ExpressoMiddleware = ExpressoMiddleware;
+/**
+ * Enum representing possible server environments.
+ */
+var ServerEnvironment;
+(function (ServerEnvironment) {
+    ServerEnvironment["Development"] = "development";
+    ServerEnvironment["Production"] = "production";
+})(ServerEnvironment || (exports.ServerEnvironment = ServerEnvironment = {}));

package/lib/cjs/adapter-express/express-utils/decorators.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.params = exports.Principal = exports.next = exports.cookies = exports.headers = exports.body = exports.query = exports.param = exports.response = exports.request = exports.httpMethod = exports.Delete = exports.Head = exports.Patch = exports.Put = exports.Post = exports.Get = exports.all = exports.controller = exports.injectHttpContext = void 0;
+exports.params = exports.principal = exports.next = exports.cookies = exports.headers = exports.body = exports.query = exports.param = exports.response = exports.request = exports.httpMethod = exports.Delete = exports.Head = exports.Patch = exports.Put = exports.Post = exports.Get = exports.All = exports.controller = exports.injectHttpContext = void 0;
 require("reflect-metadata");
 const inversify_1 = require("inversify");
 const constants_1 = require("./constants");
 exports.injectHttpContext = (0, inversify_1.inject)(constants_1.TYPE.HttpContext);
+/**
+ * Controller decorator to define a new controller
+ * @param path route path
+ * @param middleware array of middleware to be applied to all routes in the controller
+ */
 function controller(path, ...middleware) {
     return (target) => {
         const currentMetadata = {
@@ -20,34 +25,99 @@ function controller(path, ...middleware) {
     };
 }
 exports.controller = controller;
-function all(path, ...middleware) {
+/**
+ * Decorator to allow accept all HTTP methods
+ * @param path route path, wildcard
+ * @param middleware array of middleware to be applied to all routes defined in path logic
+ */
+function All(path, ...middleware) {
     return httpMethod("all", path, ...middleware);
 }
-exports.all = all;
+exports.All = All;
+/**
+ * Decorator to allow GET HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 function Get(path, ...middleware) {
-    return httpMethod("get", path, ...middleware);
+    return enhancedHttpMethod("get", path, ...middleware);
 }
 exports.Get = Get;
+/**
+ * Decorator to allow POST HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 function Post(path, ...middleware) {
     return httpMethod("post", path, ...middleware);
 }
 exports.Post = Post;
+/**
+ * Decorator to allow PUT HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 function Put(path, ...middleware) {
-    return httpMethod("put", path, ...middleware);
+    return enhancedHttpMethod("put", path, ...middleware);
 }
 exports.Put = Put;
+/**
+ * Decorator to allow PATCH HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 function Patch(path, ...middleware) {
-    return httpMethod("patch", path, ...middleware);
+    return enhancedHttpMethod("patch", path, ...middleware);
 }
 exports.Patch = Patch;
+/**
+ * Decorator to allow HEAD HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 function Head(path, ...middleware) {
     return httpMethod("head", path, ...middleware);
 }
 exports.Head = Head;
+/**
+ * Decorator to allow DELETE HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 function Delete(path, ...middleware) {
-    return httpMethod("delete", path, ...middleware);
+    return enhancedHttpMethod("delete", path, ...middleware);
 }
 exports.Delete = Delete;
+function enhancedHttpMethod(method, path, ...middleware) {
+    return (target, key) => {
+        const metadata = {
+            key,
+            method,
+            middleware,
+            path,
+            target,
+        };
+        let metadataList = [];
+        if (!Reflect.hasOwnMetadata(constants_1.METADATA_KEY.controllerMethod, target.constructor)) {
+            Reflect.defineMetadata(constants_1.METADATA_KEY.controllerMethod, metadataList, target.constructor);
+        }
+        else {
+            metadataList = Reflect.getOwnMetadata(constants_1.METADATA_KEY.controllerMethod, target.constructor);
+        }
+        metadataList.push(metadata);
+        const paramsInfo = Reflect.getMetadata("design:paramtypes", target, key) || [];
+        metadataList.forEach((m) => {
+            m.middleware.unshift((req, res, next) => {
+                req.params &&
+                    Object.keys(req.params).forEach((param, idx) => {
+                        const type = paramsInfo[idx];
+                        req.params[param] = convertToType(req.params[param], type);
+                    });
+                next();
+            });
+        });
+    };
+}
 function httpMethod(method, path, ...middleware) {
     return (target, key) => {
         const metadata = {
@@ -68,18 +138,51 @@ function httpMethod(method, path, ...middleware) {
     };
 }
 exports.httpMethod = httpMethod;
-/*
- * Parameter Decorators
+/**
+ * Parameter decorator to inject the request object
+ * @returns ParameterDecorator
  */
 exports.request = paramDecoratorFactory(constants_1.PARAMETER_TYPE.REQUEST);
+/**
+ * Parameter decorator to inject the response object
+ * @returns ParameterDecorator
+ */
 exports.response = paramDecoratorFactory(constants_1.PARAMETER_TYPE.RESPONSE);
+/**
+ * Parameter decorator to inject parameters from the route
+ * @returns ParameterDecorator
+ */
 exports.param = paramDecoratorFactory(constants_1.PARAMETER_TYPE.PARAMS);
+/**
+ * Parameter decorator to inject query parameters
+ * @returns ParameterDecorator
+ */
 exports.query = paramDecoratorFactory(constants_1.PARAMETER_TYPE.QUERY);
+/**
+ * Parameter decorator to inject the request body
+ * @returns ParameterDecorator
+ */
 exports.body = paramDecoratorFactory(constants_1.PARAMETER_TYPE.BODY);
+/**
+ * Parameter decorator to inject the request headers
+ * @returns ParameterDecorator
+ */
 exports.headers = paramDecoratorFactory(constants_1.PARAMETER_TYPE.HEADERS);
+/**
+ * Parameter decorator to inject the request cookies
+ * @returns ParameterDecorator
+ */
 exports.cookies = paramDecoratorFactory(constants_1.PARAMETER_TYPE.COOKIES);
+/**
+ * Parameter decorator next function
+ * @returns ParameterDecorator
+ */
 exports.next = paramDecoratorFactory(constants_1.PARAMETER_TYPE.NEXT);
-exports.Principal = paramDecoratorFactory(constants_1.PARAMETER_TYPE.PRINCIPAL);
+/**
+ * Parameter decorator to inject the principal object obtained from AuthProvider
+ * @returns ParameterDecorator
+ */
+exports.principal = paramDecoratorFactory(constants_1.PARAMETER_TYPE.PRINCIPAL);
 function paramDecoratorFactory(parameterType) {
     return (name) => params(parameterType, name);
 }
@@ -108,3 +211,15 @@ function params(type, parameterName) {
     };
 }
 exports.params = params;
+function convertToType(value, type) {
+    if (type === Number) {
+        return Number(value);
+    }
+    else if (type === String) {
+        return value;
+    }
+    else if (type === Boolean) {
+        return value === "true" || value === "1";
+    }
+    return value;
+}

package/lib/cjs/adapter-express/express-utils/inversify-express-server.js

@@ -22,15 +22,6 @@ var __importStar = (this && this.__importStar) || function (mod) {
     __setModuleDefault(result, mod);
     return result;
 };
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InversifyExpressServer = void 0;
 /* eslint-disable @typescript-eslint/no-unused-vars */
@@ -97,11 +88,11 @@ class InversifyExpressServer {
         // it creates a new httpContext and attaches it to the
         // current request as metadata using Reflect
         this._app.all("*", (req, res, next) => {
-            void (() => __awaiter(this, void 0, void 0, function* () {
-                const httpContext = yield this._createHttpContext(req, res, next);
+            void (async () => {
+                const httpContext = await this._createHttpContext(req, res, next);
                 Reflect.defineMetadata(constants_1.METADATA_KEY.httpContext, httpContext, req);
                 next();
-            }))();
+            })();
         });
         // register server-level middleware before anything else
         if (this._configFn) {
@@ -170,36 +161,34 @@ class InversifyExpressServer {
             target.append(name, typeof headerValue === "number" ? headerValue.toString() : headerValue);
         }
     }
-    handleHttpResponseMessage(message, res) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.copyHeadersTo(message.headers, res);
-            if (message.content !== undefined) {
-                this.copyHeadersTo(message.content.headers, res);
-                res
-                    .status(message.statusCode)
-                    // If the content is a number, ensure we change it to a string, else our content is
-                    // treated as a statusCode rather than as the content of the Response
-                    .send(yield message.content.readAsync());
-            }
-            else {
-                res.sendStatus(message.statusCode);
-            }
-        });
+    async handleHttpResponseMessage(message, res) {
+        this.copyHeadersTo(message.headers, res);
+        if (message.content !== undefined) {
+            this.copyHeadersTo(message.content.headers, res);
+            res
+                .status(message.statusCode)
+                // If the content is a number, ensure we change it to a string, else our content is
+                // treated as a statusCode rather than as the content of the Response
+                .send(await message.content.readAsync());
+        }
+        else {
+            res.sendStatus(message.statusCode);
+        }
     }
     handlerFactory(controllerName, key, parameterMetadata) {
-        return (req, res, next) => __awaiter(this, void 0, void 0, function* () {
+        return async (req, res, next) => {
             try {
                 const args = this.extractParameters(req, res, next, parameterMetadata);
                 const httpContext = this._getHttpContext(req);
                 httpContext.container.bind(constants_1.TYPE.HttpContext).toConstantValue(httpContext);
                 // invoke controller's action
-                const value = yield httpContext.container.getNamed(constants_1.TYPE.Controller, controllerName)[key](...args);
+                const value = await httpContext.container.getNamed(constants_1.TYPE.Controller, controllerName)[key](...args);
                 if (value instanceof httpResponseMessage_1.HttpResponseMessage) {
-                    yield this.handleHttpResponseMessage(value, res);
+                    await this.handleHttpResponseMessage(value, res);
                 }
                 else if ((0, utils_1.instanceOfIHttpActionResult)(value)) {
-                    const httpResponseMessage = yield value.executeAsync();
-                    yield this.handleHttpResponseMessage(httpResponseMessage, res);
+                    const httpResponseMessage = await value.executeAsync();
+                    await this.handleHttpResponseMessage(httpResponseMessage, res);
                 }
                 else if (value instanceof Function) {
                     value();
@@ -214,36 +203,32 @@ class InversifyExpressServer {
             catch (err) {
                 next(err);
             }
-        });
+        };
     }
     _getHttpContext(req) {
         return Reflect.getMetadata(constants_1.METADATA_KEY.httpContext, req);
     }
-    _createHttpContext(req, res, next) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const principal = yield this._getCurrentUser(req, res, next);
-            return {
-                // We use a childContainer for each request so we can be
-                // sure that the binding is unique for each HTTP request
-                container: this._container.createChild(),
-                request: req,
-                response: res,
-                user: principal,
-            };
-        });
+    async _createHttpContext(req, res, next) {
+        const principal = await this._getCurrentUser(req, res, next);
+        return {
+            // We use a childContainer for each request so we can be
+            // sure that the binding is unique for each HTTP request
+            container: this._container.createChild(),
+            request: req,
+            response: res,
+            user: principal,
+        };
     }
-    _getCurrentUser(req, res, next) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (this._AuthProvider !== undefined) {
-                const authProvider = this._container.get(constants_1.TYPE.AuthProvider);
-                return authProvider.getUser(req, res, next);
-            }
-            return Promise.resolve({
-                details: null,
-                isAuthenticated: () => Promise.resolve(false),
-                isInRole: (_role) => Promise.resolve(false),
-                isResourceOwner: (_resourceId) => Promise.resolve(false),
-            });
+    async _getCurrentUser(req, res, next) {
+        if (this._AuthProvider !== undefined) {
+            const authProvider = this._container.get(constants_1.TYPE.AuthProvider);
+            return authProvider.getUser(req, res, next);
+        }
+        return Promise.resolve({
+            details: null,
+            isAuthenticated: () => Promise.resolve(false),
+            isInRole: (_role) => Promise.resolve(false),
+            isResourceOwner: (_resourceId) => Promise.resolve(false),
         });
     }
     extractParameters(req, res, next, params) {
@@ -286,7 +271,7 @@ class InversifyExpressServer {
         return args;
     }
     getParam(source, paramType, injectRoot, name) {
-        const key = paramType === "headers" ? name === null || name === void 0 ? void 0 : name.toLowerCase() : name;
+        const key = paramType === "headers" ? name?.toLowerCase() : name;
         const param = source[paramType];
         if (injectRoot) {
             return param;

package/lib/cjs/adapter-express/express-utils/utils.js

@@ -40,7 +40,7 @@ function getControllerParameterMetadata(constructor) {
     const parameterMetadata = Reflect.getOwnMetadata(constants_1.METADATA_KEY.controllerParameter, constructor);
     const genericMetadata = Reflect.getMetadata(constants_1.METADATA_KEY.controllerParameter, Reflect.getPrototypeOf(constructor));
     if (genericMetadata !== undefined && parameterMetadata !== undefined) {
-        return Object.assign(Object.assign({}, parameterMetadata), genericMetadata);
+        return { ...parameterMetadata, ...genericMetadata };
     }
     if (genericMetadata !== undefined) {
         return genericMetadata;

package/lib/cjs/adapter-express/index.js

@@ -18,4 +18,5 @@ exports.ServerEnvironment = exports.AppExpress = void 0;
 __exportStar(require("./express-utils"), exports);
 var application_express_1 = require("./application-express");
 Object.defineProperty(exports, "AppExpress", { enumerable: true, get: function () { return application_express_1.AppExpress; } });
-Object.defineProperty(exports, "ServerEnvironment", { enumerable: true, get: function () { return application_express_1.ServerEnvironment; } });
+var application_express_types_1 = require("./application-express.types");
+Object.defineProperty(exports, "ServerEnvironment", { enumerable: true, get: function () { return application_express_types_1.ServerEnvironment; } });

package/lib/cjs/types/adapter-express/{application-base.d.ts → application-express.base.d.ts}

@@ -18,37 +18,30 @@
  * @export
  * @abstract
  */
-declare abstract class ApplicationBase {
+export declare abstract class ApplicationBase {
     /**
-     * Method to configure services that should be initialized
-     * before the server starts. It must be implemented by the
-     * extending class to set up necessary services or configurations.
-     * Can return a Promise for async configuration.
+     * Implement this method to set up required services or configurations before
+     * the server starts. This is essential for initializing dependencies or settings
+     * necessary for server operation. Supports asynchronous setup with a Promise.
      *
      * @abstract
      * @returns {void | Promise<void>}
      */
     protected abstract configureServices(): void | Promise<void>;
     /**
-     * Method to configure services or actions that should be executed
-     * after the server starts. It allows the extending class to perform
-     * any necessary operations once the server is up and running.
-     * Can return a Promise for async execution.
+     * Implement this method to execute actions or configurations after the server
+     * has started. Use this for operations that need to run once the server is
+     * operational. Supports asynchronous execution with a Promise.
      *
      * @abstract
      * @returns {void | Promise<void>}
      */
     protected abstract postServerInitialization(): void | Promise<void>;
     /**
-     * Method to perform any necessary actions or cleanup after the server
-     * is shutting down. This might include closing database connections,
-     * stopping background tasks, or other cleanup activities. It provides
-     * a clean exit point for the server.
-     * Can return a Promise for async cleanup.
-     *
-     * @abstract
-     * @returns {void | Promise<void>}
+     * Implement this method to handle cleanup and final actions when the server
+     * is shutting down. Ideal for closing resources, stopping tasks, or other
+     * cleanup procedures to ensure a graceful server shutdown. Supports asynchronous
+     * cleanup with a Promise.
      */
     protected abstract serverShutdown(): void | Promise<void>;
 }
-export { ApplicationBase };

package/lib/cjs/types/adapter-express/application-express.d.ts

@@ -1,37 +1,26 @@
-import express from "express";
-import { Container } from "inversify";
 import { IApplicationMessageToConsole, RenderTemplateOptions } from "@expressots/core";
-import { IApplicationExpress } from "./application-express.interface";
-import { ApplicationBase } from "./application-base";
-/**
- * ExpressHandler Type
- *
- * The ExpressHandler type is a union type that represents various types of Express middleware functions.
- * It can be one of the following types:
- * - express.ErrorRequestHandler: Handles errors in the middleware pipeline.
- * - express.RequestParamHandler: Handles parameters in the middleware pipeline.
- * - express.RequestHandler: General request handler.
- * - undefined: Represents the absence of a handler.
- */
-type ExpressHandler = express.ErrorRequestHandler | express.RequestParamHandler | express.RequestHandler | undefined;
-/**
- * Enum representing possible server environments.
- */
-declare enum ServerEnvironment {
-    Development = "development",
-    Production = "production"
-}
+import { Container } from "inversify";
+import { ApplicationBase } from "./application-express.base";
+import { IWebServer, ServerEnvironment } from "./application-express.types";
 /**
- * The Application class provides a way to configure and manage an Express application.
- * @provide Application
+ * The AppExpress class provides methods for configuring and running an Express application.
+ * @class AppExpress
+ * @implements {IWebServer} - Interface for the WebServer application implementation.
+ * @extends {ApplicationBase} - Base class for the application implementation that provides lifecycle hooks.
+ * @method configure - Configures the InversifyJS container.
+ * @method listen - Start listening on the given port and environment.
+ * @method setGlobalRoutePrefix - Sets the global route prefix for the application.
+ * @method setEngine - Configures the application's view engine based on the provided configuration options.
+ * @method isDevelopment - Verifies if the current environment is development.
  */
-declare class ApplicationExpress extends ApplicationBase implements IApplicationExpress {
+declare class AppExpress extends ApplicationBase implements IWebServer {
     private app;
     private port;
     private environment;
     private container;
-    private middlewares;
     private globalPrefix;
+    private middlewares;
+    private console;
     protected configureServices(): void | Promise<void>;
     protected postServerInitialization(): void | Promise<void>;
     protected serverShutdown(): void | Promise<void>;
@@ -39,6 +28,11 @@ declare class ApplicationExpress extends ApplicationBase implements IApplication
      * Handles process exit by calling serverShutdown and then exiting the process.
      */
     private handleExit;
+    /**
+     * Configures the InversifyJS container.
+     * @param container - The InversifyJS container.
+     */
+    configure(container: Container): Promise<void>;
     /**
      * Configures the Express application with the provided middleware entries.
      * @param app - The Express application instance.
@@ -52,13 +46,6 @@ declare class ApplicationExpress extends ApplicationBase implements IApplication
      * @returns The configured Application instance.
      */
     private init;
-    /**
-     * Create and configure the Express application.
-     * @param container - The InversifyJS container.
-     * @param middlewares - An array of Express middlewares to be applied.
-     * @returns The configured Application instance.
-     */
-    create(container: Container, middlewares?: Array<ExpressHandler>): Promise<ApplicationExpress>;
     /**
      * Start listening on the given port and environment.
      * @param port - The port number to listen on.
@@ -94,12 +81,5 @@ declare class ApplicationExpress extends ApplicationBase implements IApplication
      * @returns A boolean value indicating whether the current environment is development or not.
      */
     protected isDevelopment(): boolean;
-    /**
-     * Verifies if the current environment is production.
-     *
-     * @returns A boolean value indicating whether the current environment is production or not.
-     *
-     */
-    get ExpressApp(): express.Application;
 }
-export { ApplicationExpress as AppExpress, ServerEnvironment };
+export { AppExpress };

package/lib/cjs/types/adapter-express/application-express.interface.d.ts

@@ -1,17 +1,16 @@
 import { IApplicationMessageToConsole, RenderTemplateOptions } from "@expressots/core";
-import { ServerEnvironment } from "./application-express";
+import { ServerEnvironment } from "./application-express.types";
 /**
- * Interface representing the Application class for Expressjs
- * @interface IApplicationExpress
+ * Public Interface for the WebServer application.
  */
-interface IApplicationExpress {
+export interface IWebServerPublic {
     /**
      * Start listening on the given port and environment.
      * @param port - The port number to listen on.
      * @param environment - The server environment.
      * @param consoleMessage - Optional message to display in the console.
      */
-    listen(port: number, environment: ServerEnvironment, consoleMessage?: IApplicationMessageToConsole): Promise<void> | void;
+    listen(port: number, environment: ServerEnvironment, consoleMessage?: IApplicationMessageToConsole): Promise<void>;
     /**
      * Configures the application's view engine based on the provided configuration options.
      *
@@ -25,4 +24,3 @@ interface IApplicationExpress {
      */
     setEngine<T extends RenderTemplateOptions>(options: T): void;
 }
-export { IApplicationExpress };

package/lib/cjs/types/adapter-express/application-express.types.d.ts

@@ -0,0 +1,62 @@
+import express, { Request, Response, NextFunction } from "express";
+import { IApplicationMessageToConsole, RenderTemplateOptions } from "@expressots/core";
+import { Container } from "inversify";
+/**
+ * Interface for the WebServer application implementation.
+ */
+export interface IWebServer {
+    configure(container: Container): Promise<void>;
+    listen(port: number, environment: ServerEnvironment, consoleMessage?: IApplicationMessageToConsole): Promise<void>;
+    setEngine<T extends RenderTemplateOptions>(options: T): void;
+}
+/**
+ * Constructor type for IWebServer.
+ */
+export interface IWebServerConstructor<T extends IWebServer> {
+    new (): T;
+}
+/**
+ * ExpressHandler Type
+ *
+ * The ExpressHandler type is a union type that represents various types of Express middleware functions.
+ * It can be one of the following types:
+ * - express.ErrorRequestHandler: Handles errors in the middleware pipeline.
+ * - express.RequestParamHandler: Handles parameters in the middleware pipeline.
+ * - express.RequestHandler: General request handler.
+ * - undefined: Represents the absence of a handler.
+ */
+export type ExpressHandler = express.ErrorRequestHandler | express.RequestParamHandler | express.RequestHandler | undefined;
+/**
+ * MiddlewareConfig Interface
+ *
+ * The MiddlewareConfig interface specifies the structure for middleware configuration objects.
+ * - path: Optional. The route path for which the middleware is configured.
+ * - middlewares: An array of ExpressHandler types that make up the middleware pipeline for the route specified by 'path'.
+ */
+export type MiddlewareConfig = {
+    path?: string;
+    middlewares: Array<ExpressHandler>;
+};
+/**
+ * Expresso middleware interface.
+ */
+interface IExpressoMiddleware {
+    use(req: Request, res: Response, next: NextFunction): Promise<void> | void;
+}
+/**
+ * Abstract class for creating custom Expresso middleware.
+ * Custom middleware classes should extend this class and implement the use method.
+ *
+ */
+export declare abstract class ExpressoMiddleware implements IExpressoMiddleware {
+    get name(): string;
+    abstract use(req: Request, res: Response, next: NextFunction): Promise<void> | void;
+}
+/**
+ * Enum representing possible server environments.
+ */
+export declare enum ServerEnvironment {
+    Development = "development",
+    Production = "production"
+}
+export {};

package/lib/cjs/types/adapter-express/express-utils/decorators.d.ts

@@ -1,23 +1,99 @@
 import "reflect-metadata";
 import { PARAMETER_TYPE, HTTP_VERBS_ENUM } from "./constants";
-import type { Controller, HandlerDecorator, Middleware } from "./interfaces";
-export declare const injectHttpContext: (target: import("inversify/lib/annotation/decorator_utils").DecoratorTarget<unknown>, targetKey?: string | symbol, indexOrPropertyDescriptor?: number | TypedPropertyDescriptor<any>) => void;
+import type { HandlerDecorator, Middleware } from "./interfaces";
+export declare const injectHttpContext: (target: import("inversify/lib/annotation/decorator_utils").DecoratorTarget<unknown>, targetKey?: string | symbol, indexOrPropertyDescriptor?: number | TypedPropertyDescriptor<unknown>) => void;
+/**
+ * Controller decorator to define a new controller
+ * @param path route path
+ * @param middleware array of middleware to be applied to all routes in the controller
+ */
 export declare function controller(path: string, ...middleware: Array<Middleware>): (target: NewableFunction) => void;
-export declare function all(path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+/**
+ * Decorator to allow accept all HTTP methods
+ * @param path route path, wildcard
+ * @param middleware array of middleware to be applied to all routes defined in path logic
+ */
+export declare function All(path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+/**
+ * Decorator to allow GET HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 export declare function Get(path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+/**
+ * Decorator to allow POST HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 export declare function Post(path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+/**
+ * Decorator to allow PUT HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 export declare function Put(path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+/**
+ * Decorator to allow PATCH HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 export declare function Patch(path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+/**
+ * Decorator to allow HEAD HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 export declare function Head(path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+/**
+ * Decorator to allow DELETE HTTP method
+ * @param path route path
+ * @param middleware array of middleware to be applied to the route
+ */
 export declare function Delete(path: string, ...middleware: Array<Middleware>): HandlerDecorator;
 export declare function httpMethod(method: keyof typeof HTTP_VERBS_ENUM, path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+/**
+ * Parameter decorator to inject the request object
+ * @returns ParameterDecorator
+ */
 export declare const request: () => ParameterDecorator;
+/**
+ * Parameter decorator to inject the response object
+ * @returns ParameterDecorator
+ */
 export declare const response: () => ParameterDecorator;
+/**
+ * Parameter decorator to inject parameters from the route
+ * @returns ParameterDecorator
+ */
 export declare const param: (paramName?: string) => ParameterDecorator;
+/**
+ * Parameter decorator to inject query parameters
+ * @returns ParameterDecorator
+ */
 export declare const query: (queryParamName?: string) => ParameterDecorator;
+/**
+ * Parameter decorator to inject the request body
+ * @returns ParameterDecorator
+ */
 export declare const body: () => ParameterDecorator;
+/**
+ * Parameter decorator to inject the request headers
+ * @returns ParameterDecorator
+ */
 export declare const headers: (headerName?: string) => ParameterDecorator;
+/**
+ * Parameter decorator to inject the request cookies
+ * @returns ParameterDecorator
+ */
 export declare const cookies: (cookieName?: string) => ParameterDecorator;
+/**
+ * Parameter decorator next function
+ * @returns ParameterDecorator
+ */
 export declare const next: () => ParameterDecorator;
-export declare const Principal: () => ParameterDecorator;
-export declare function params(type: PARAMETER_TYPE, parameterName?: string): (target: unknown | Controller, methodName: string | symbol, index: number) => void;
+/**
+ * Parameter decorator to inject the principal object obtained from AuthProvider
+ * @returns ParameterDecorator
+ */
+export declare const principal: () => ParameterDecorator;
+export declare function params(type: PARAMETER_TYPE, parameterName?: string): ParameterDecorator;

package/lib/cjs/types/adapter-express/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./express-utils";
-export { AppExpress, ServerEnvironment } from "./application-express";
-export { IApplicationExpress } from "./application-express.interface";
+export { AppExpress } from "./application-express";
+export { IWebServerPublic } from "./application-express.interface";
+export { IWebServer, IWebServerConstructor, ServerEnvironment } from "./application-express.types";

package/lib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/adapter-express",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@adapter-express)",
   "author": "",
   "main": "./lib/cjs/index.js",
@@ -56,35 +56,36 @@
     "build": "npm run clean && npm run build:cjs && npm run copy",
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "release": "release-it",
+    "prepublish": "npm run build && npm pack",
     "test": "jest",
     "format": "prettier --write \"src/**/*.ts\" --cache",
     "lint": "eslint \"src/**/*.ts\"",
     "lint:fix": "eslint \"src/**/*.ts\" --fix"
   },
   "dependencies": {
-    "dotenv": "^16.0.3",
-    "inversify": "^6.0.1",
-    "inversify-binding-decorators": "^4.0.0",
-    "jest": "^29.5.0",
-    "reflect-metadata": "^0.1.13"
+    "dotenv": "16.4.5",
+    "inversify": "6.0.2",
+    "inversify-binding-decorators": "4.0.0",
+    "jest": "29.5.0",
+    "reflect-metadata": "0.2.2"
   },
   "devDependencies": {
     "@commitlint/cli": "^18.0.0",
-    "@commitlint/config-conventional": "^17.7.0",
-    "@expressots/core": "^2.2.0",
-    "@release-it/conventional-changelog": "^7.0.1",
-    "@types/express": "^4.17.17",
-    "@types/jest": "^29.5.0",
-    "@types/node": "^20.4.9",
-    "@typescript-eslint/eslint-plugin": "^6.6.0",
-    "@typescript-eslint/parser": "^6.6.0",
-    "eslint": "^8.48.0",
-    "eslint-config-prettier": "^9.0.0",
-    "husky": "^8.0.3",
-    "prettier": "^3.0.3",
-    "release-it": "^16.1.5",
-    "ts-jest": "^29.0.5",
-    "typescript": "^5.2.2"
+    "@commitlint/config-conventional": "17.7.0",
+    "@expressots/core": "latest",
+    "@release-it/conventional-changelog": "7.0.1",
+    "@types/express": "4.17.21",
+    "@types/jest": "29.5.0",
+    "@types/node": "20.4.9",
+    "@typescript-eslint/eslint-plugin": "6.6.0",
+    "@typescript-eslint/parser": "6.6.0",
+    "eslint": "8.48.0",
+    "eslint-config-prettier": "9.0.0",
+    "husky": "8.0.3",
+    "prettier": "3.0.3",
+    "release-it": "16.1.5",
+    "ts-jest": "29.0.5",
+    "typescript": "5.2.2"
   },
   "release-it": {
     "git": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/adapter-express",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@adapter-express)",
   "author": "",
   "main": "./lib/cjs/index.js",
@@ -56,35 +56,36 @@
     "build": "npm run clean && npm run build:cjs && npm run copy",
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "release": "release-it",
+    "prepublish": "npm run build && npm pack",
     "test": "jest",
     "format": "prettier --write \"src/**/*.ts\" --cache",
     "lint": "eslint \"src/**/*.ts\"",
     "lint:fix": "eslint \"src/**/*.ts\" --fix"
   },
   "dependencies": {
-    "dotenv": "^16.0.3",
-    "inversify": "^6.0.1",
-    "inversify-binding-decorators": "^4.0.0",
-    "jest": "^29.5.0",
-    "reflect-metadata": "^0.1.13"
+    "dotenv": "16.4.5",
+    "inversify": "6.0.2",
+    "inversify-binding-decorators": "4.0.0",
+    "jest": "29.5.0",
+    "reflect-metadata": "0.2.2"
   },
   "devDependencies": {
     "@commitlint/cli": "^18.0.0",
-    "@commitlint/config-conventional": "^17.7.0",
-    "@expressots/core": "^2.2.0",
-    "@release-it/conventional-changelog": "^7.0.1",
-    "@types/express": "^4.17.17",
-    "@types/jest": "^29.5.0",
-    "@types/node": "^20.4.9",
-    "@typescript-eslint/eslint-plugin": "^6.6.0",
-    "@typescript-eslint/parser": "^6.6.0",
-    "eslint": "^8.48.0",
-    "eslint-config-prettier": "^9.0.0",
-    "husky": "^8.0.3",
-    "prettier": "^3.0.3",
-    "release-it": "^16.1.5",
-    "ts-jest": "^29.0.5",
-    "typescript": "^5.2.2"
+    "@commitlint/config-conventional": "17.7.0",
+    "@expressots/core": "latest",
+    "@release-it/conventional-changelog": "7.0.1",
+    "@types/express": "4.17.21",
+    "@types/jest": "29.5.0",
+    "@types/node": "20.4.9",
+    "@typescript-eslint/eslint-plugin": "6.6.0",
+    "@typescript-eslint/parser": "6.6.0",
+    "eslint": "8.48.0",
+    "eslint-config-prettier": "9.0.0",
+    "husky": "8.0.3",
+    "prettier": "3.0.3",
+    "release-it": "16.1.5",
+    "ts-jest": "29.0.5",
+    "typescript": "5.2.2"
   },
   "release-it": {
     "git": {