@expressots/adapter-express 1.4.0 → 1.6.0

package/lib/CHANGELOG.md

@@ -1,5 +1,54 @@
 
 
+## [1.6.0](https://github.com/expressots/adapter-express/compare/1.5.0...1.6.0) (2024-07-17)
+
+
+### Features
+
+* add render support for EJS and HBS ([8618655](https://github.com/expressots/adapter-express/commit/861865564bcdb2d90d7a083bf19f76918e810744))
+* adjust version of core package ([a699bd4](https://github.com/expressots/adapter-express/commit/a699bd4e24fd86474f2c678798abcdd311bce0f1))
+* bump @types/node from 20.14.9 to 20.14.10 ([9a1291b](https://github.com/expressots/adapter-express/commit/9a1291b7c5174d68e079f2b46b0cd140cf4332c1))
+* bump @typescript-eslint/eslint-plugin from 7.15.0 to 7.16.1 ([e7d3c9a](https://github.com/expressots/adapter-express/commit/e7d3c9aea3e260417af7a77694e0c0511e0307b7))
+* bump @typescript-eslint/parser from 7.15.0 to 7.16.1 ([2a99945](https://github.com/expressots/adapter-express/commit/2a99945f749015301b7e53d9bbfa151aa9adb0f6))
+* bump prettier from 3.3.2 to 3.3.3 ([d7de72a](https://github.com/expressots/adapter-express/commit/d7de72a87b8ca503ff37d6ce0974ceb53af51dfe))
+* bump release-it from 17.4.1 to 17.6.0 ([c36aeb6](https://github.com/expressots/adapter-express/commit/c36aeb6a51e446bb3757421fe613fd3202dfaf16))
+* bump typescript from 5.2.2 to 5.5.3 ([53f9f96](https://github.com/expressots/adapter-express/commit/53f9f96f65d2b4652126f7f42c2b9774f0db7328))
+* bump vitest and @vitest/coverage-v8 ([b2dae7e](https://github.com/expressots/adapter-express/commit/b2dae7e4e247e288a5fe8fefe135e47925b2f122))
+* bump vitest and @vitest/coverage-v8 ([b3221eb](https://github.com/expressots/adapter-express/commit/b3221eba32cc85e304fef1cb98389dcae0566c24))
+* linter adjust ([e43d222](https://github.com/expressots/adapter-express/commit/e43d2221ec3f869d60dc2b967ab325e3aaecc97b))
+
+
+### Bug Fixes
+
+* bump node version 18.18 and removed deprecated install in husky ([778ed79](https://github.com/expressots/adapter-express/commit/778ed79c3595fd239656d8182623635a8fff16d0))
+
+## [1.5.0](https://github.com/expressots/adapter-express/compare/1.4.0...1.5.0) (2024-06-11)
+
+
+### Features
+
+* bump @commitlint/config-conventional from 17.7.0 to 19.2.2 ([c4db260](https://github.com/expressots/adapter-express/commit/c4db260694b492e5744dc7c59ce4edae23053ec8))
+* bump @release-it/conventional-changelog from 7.0.1 to 7.0.2 ([d063fd9](https://github.com/expressots/adapter-express/commit/d063fd9ff2b405eb69197b70cad72334d814b6bf))
+* bump eslint-config-prettier from 9.0.0 to 9.1.0 ([20ca753](https://github.com/expressots/adapter-express/commit/20ca753e4297889506af98e6caa5b1f374aded59))
+* bump husky from 8.0.3 to 9.0.11 ([8cb065e](https://github.com/expressots/adapter-express/commit/8cb065e49e209b2a6ab56d07a712df30596350ca))
+* bump prettier from 3.0.3 to 3.3.1 ([872c7ba](https://github.com/expressots/adapter-express/commit/872c7ba7072c1cfb36a7efe74be0b41f6aea541b))
+* bump prettier from 3.3.1 to 3.3.2 ([5edd349](https://github.com/expressots/adapter-express/commit/5edd3490f1a6fa48a65694a9c146c2ec69a264d3))
+* bump release-it from 16.1.5 to 16.3.0 ([5febf25](https://github.com/expressots/adapter-express/commit/5febf2517dec9857d59ec189829262dafcc63fbd))
+
+
+### Bug Fixes
+
+* decorator method case confict fix ([cdf0fbd](https://github.com/expressots/adapter-express/commit/cdf0fbd6c864a0e538372dc102664538112f0e30))
+* init commit ([55359bf](https://github.com/expressots/adapter-express/commit/55359bf31acfdf0186f6916cd0dc1897d1f24cd2))
+* patch issue where not using http decorator shows incorrect code ([975e451](https://github.com/expressots/adapter-express/commit/975e45112181088bcb9d8f1487e8272deb49d3df))
+* remove comments and logs for prod build ([cd0151b](https://github.com/expressots/adapter-express/commit/cd0151be92f1cb73b6040a72db6d4f1268ae6cfc))
+* remove unused method param in find param pattern ([fd40872](https://github.com/expressots/adapter-express/commit/fd4087276672a6b3c34563736892e4065a497bfa))
+
+
+### Code Refactoring
+
+* without and with decor in the same route conflict ([469f65e](https://github.com/expressots/adapter-express/commit/469f65e9248aefe5db084608684ca211204c2f5b))
+
 ## [1.4.0](https://github.com/expressots/adapter-express/compare/1.3.0...1.4.0) (2024-06-07)
 
 
@@ -92,4 +141,4 @@
 
 ### Bug Fixes
 
-* testing commitlint ([0e78653](https://github.com/expressots/<<repo_name>>/commit/0e786539402f69fdca3fe5b684d850e523db7698))
+* testing commitlint ([0e78653](https://github.com/expressots/<<repo_name>>/commit/0e786539402f69fdca3fe5b684d850e523db7698))

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

@@ -15,8 +15,12 @@ const inversify_binding_decorators_1 = require("inversify-binding-decorators");
 const process_1 = __importDefault(require("process"));
 const application_express_base_1 = require("./application-express.base");
 const application_express_types_1 = require("./application-express.types");
-const inversify_express_server_1 = require("./express-utils/inversify-express-server");
 const http_status_middleware_1 = require("./express-utils/http-status-middleware");
+const inversify_express_server_1 = require("./express-utils/inversify-express-server");
+const ejs_config_1 = require("./render/ejs/ejs.config");
+const engine_1 = require("./render/engine");
+const hbs_config_1 = require("./render/handlebars/hbs.config");
+const resolve_render_1 = require("./render/resolve-render");
 /**
  * The AppExpress class provides methods for configuring and running an Express application.
  * @class AppExpress
@@ -34,6 +38,7 @@ let AppExpress = class AppExpress extends application_express_base_1.Application
         this.logger = new core_1.Logger();
         this.globalPrefix = "/";
         this.middlewares = [];
+        this.renderOptions = {};
     }
     configureServices() { }
     postServerInitialization() { }
@@ -122,6 +127,7 @@ let AppExpress = class AppExpress extends application_express_base_1.Application
      */
     async listen(port, environment, consoleMessage) {
         await this.init();
+        await this.configEngine();
         this.port = port || 3000;
         this.environment = environment;
         this.app.set("env", environment);
@@ -145,6 +151,23 @@ let AppExpress = class AppExpress extends application_express_base_1.Application
     setGlobalRoutePrefix(prefix) {
         this.globalPrefix = prefix;
     }
+    /**
+     * Configures the application's view engine based on the provided configuration options.
+     */
+    async configEngine() {
+        if (this.renderOptions.engine) {
+            switch (this.renderOptions.engine) {
+                case engine_1.Engine.HBS:
+                    await (0, hbs_config_1.setEngineHandlebars)(this.app, this.renderOptions.options);
+                    break;
+                case engine_1.Engine.EJS:
+                    await (0, ejs_config_1.setEngineEjs)(this.app, this.renderOptions.options);
+                    break;
+                default:
+                    throw new Error("Unsupported engine type!");
+            }
+        }
+    }
     /**
      * Configures the application's view engine based on the provided configuration options.
      *
@@ -152,16 +175,21 @@ let AppExpress = class AppExpress extends application_express_base_1.Application
      * @method setEngine
      * @template T - A generic type extending from RenderTemplateOptions.
      *
-     * @param {T} options - An object of type T (must be an object that extends RenderTemplateOptions)
-     *                      that provides the configuration options for setting the view engine.
-     *                      This includes the extension name, view path, and the engine function itself.
+     * @param {Engine} engine - The view engine to set
+     * @param {EngineOptions} [options] - The configuration options for the view engine
      */
-    setEngine(options) {
-        if ("extName" in options) {
-            const { extName, viewPath, engine } = options;
-            this.app.engine(extName, engine);
-            this.app.set("view engine", extName);
-            this.app.set("views", viewPath);
+    async setEngine(engine, options) {
+        (0, resolve_render_1.packageResolver)(engine, options);
+        try {
+            if (options) {
+                this.renderOptions = { engine, options };
+            }
+            else {
+                this.renderOptions = { engine };
+            }
+        }
+        catch (error) {
+            this.logger.error(error.message, "adapter-express");
         }
     }
     /**

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

@@ -1,6 +1,17 @@
 "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.Http = exports.controller = exports.injectHttpContext = void 0;
+exports.principal = exports.next = exports.cookies = exports.headers = exports.body = exports.query = exports.param = exports.response = exports.request = exports.injectHttpContext = void 0;
+exports.controller = controller;
+exports.Http = Http;
+exports.All = All;
+exports.Get = Get;
+exports.Post = Post;
+exports.Put = Put;
+exports.Patch = Patch;
+exports.Head = Head;
+exports.Delete = Delete;
+exports.httpMethod = httpMethod;
+exports.params = params;
 require("reflect-metadata");
 const inversify_1 = require("inversify");
 const constants_1 = require("./constants");
@@ -17,16 +28,14 @@ function controller(path, ...middleware) {
             path,
             target,
         };
-        const pathMetadata = Reflect.getOwnMetadata(constants_1.HTTP_CODE_METADATA.path, Reflect);
-        const statusCodeMetadata = Reflect.getOwnMetadata(constants_1.HTTP_CODE_METADATA.statusCode, Reflect);
-        let statusCodePathMapping = Reflect.getOwnMetadata(constants_1.HTTP_CODE_METADATA.httpCode, Reflect);
-        if (!statusCodePathMapping) {
-            statusCodePathMapping = {};
-        }
+        const pathMetadata = Reflect.getOwnMetadata(constants_1.HTTP_CODE_METADATA.path, Reflect) || {};
+        const statusCodeMetadata = Reflect.getOwnMetadata(constants_1.HTTP_CODE_METADATA.statusCode, Reflect) || {};
+        const statusCodePathMapping = Reflect.getOwnMetadata(constants_1.HTTP_CODE_METADATA.httpCode, Reflect) || {};
         for (const key in pathMetadata) {
             if (statusCodeMetadata && statusCodeMetadata[key]) {
-                const realPath = pathMetadata[key] === "/" ? path : `${path}${pathMetadata[key]}`;
-                statusCodePathMapping[realPath] = statusCodeMetadata[key];
+                const realPath = pathMetadata[key]["path"] === "/" ? path : `${path}${pathMetadata[key]["path"]}`;
+                statusCodePathMapping[`${realPath}/-${pathMetadata[key]["method"].toLowerCase()}`] =
+                    statusCodeMetadata[key];
             }
         }
         Reflect.defineMetadata(constants_1.HTTP_CODE_METADATA.httpCode, statusCodePathMapping, Reflect);
@@ -39,7 +48,6 @@ function controller(path, ...middleware) {
         Reflect.defineMetadata(constants_1.METADATA_KEY.controller, newMetadata, Reflect);
     };
 }
-exports.controller = controller;
 /**
  * Http decorator to define the status code for a route
  * @param code
@@ -67,7 +75,6 @@ function Http(code) {
         Reflect.defineMetadata(constants_1.HTTP_CODE_METADATA.statusCode, httpCodeMetadata, Reflect);
     };
 }
-exports.Http = Http;
 /**
  * Decorator to allow accept all HTTP methods
  * @param path route path, wildcard
@@ -76,7 +83,6 @@ exports.Http = Http;
 function All(path, ...middleware) {
     return httpMethod("all", path, ...middleware);
 }
-exports.All = All;
 /**
  * Decorator to allow GET HTTP method
  * @param path route path
@@ -85,7 +91,6 @@ exports.All = All;
 function Get(path, ...middleware) {
     return enhancedHttpMethod("get", path, ...middleware);
 }
-exports.Get = Get;
 /**
  * Decorator to allow POST HTTP method
  * @param path route path
@@ -94,7 +99,6 @@ exports.Get = Get;
 function Post(path, ...middleware) {
     return httpMethod("post", path, ...middleware);
 }
-exports.Post = Post;
 /**
  * Decorator to allow PUT HTTP method
  * @param path route path
@@ -103,7 +107,6 @@ exports.Post = Post;
 function Put(path, ...middleware) {
     return enhancedHttpMethod("put", path, ...middleware);
 }
-exports.Put = Put;
 /**
  * Decorator to allow PATCH HTTP method
  * @param path route path
@@ -112,7 +115,6 @@ exports.Put = Put;
 function Patch(path, ...middleware) {
     return enhancedHttpMethod("patch", path, ...middleware);
 }
-exports.Patch = Patch;
 /**
  * Decorator to allow HEAD HTTP method
  * @param path route path
@@ -121,7 +123,6 @@ exports.Patch = Patch;
 function Head(path, ...middleware) {
     return httpMethod("head", path, ...middleware);
 }
-exports.Head = Head;
 /**
  * Decorator to allow DELETE HTTP method
  * @param path route path
@@ -130,7 +131,6 @@ exports.Head = Head;
 function Delete(path, ...middleware) {
     return enhancedHttpMethod("delete", path, ...middleware);
 }
-exports.Delete = Delete;
 /**
  * Decorator to allow OPTIONS HTTP method
  * @param path route path
@@ -148,11 +148,17 @@ function enhancedHttpMethod(method, path, ...middleware) {
         let metadataList = [];
         let pathMetadata = Reflect.getOwnMetadata(constants_1.HTTP_CODE_METADATA.path, Reflect);
         if (pathMetadata) {
-            pathMetadata[key] = path;
+            pathMetadata[key] = {
+                path,
+                method,
+            };
         }
         else {
             pathMetadata = {};
-            pathMetadata[key] = path;
+            pathMetadata[key] = {
+                path,
+                method,
+            };
         }
         Reflect.defineMetadata(constants_1.HTTP_CODE_METADATA.path, pathMetadata, Reflect);
         if (!Reflect.hasOwnMetadata(constants_1.METADATA_KEY.controllerMethod, target.constructor)) {
@@ -193,11 +199,17 @@ function httpMethod(method, path, ...middleware) {
         let metadataList = [];
         let pathMetadata = Reflect.getOwnMetadata(constants_1.HTTP_CODE_METADATA.path, Reflect);
         if (pathMetadata) {
-            pathMetadata[key] = path;
+            pathMetadata[key] = {
+                path,
+                method,
+            };
         }
         else {
             pathMetadata = {};
-            pathMetadata[key] = path;
+            pathMetadata[key] = {
+                path,
+                method,
+            };
         }
         Reflect.defineMetadata(constants_1.HTTP_CODE_METADATA.path, pathMetadata, Reflect);
         if (!Reflect.hasOwnMetadata(constants_1.METADATA_KEY.controllerMethod, target.constructor)) {
@@ -209,7 +221,6 @@ function httpMethod(method, path, ...middleware) {
         metadataList.push(metadata);
     };
 }
-exports.httpMethod = httpMethod;
 /**
  * Parameter decorator to inject the request object
  * @returns ParameterDecorator
@@ -290,7 +301,6 @@ function params(type, parameterName) {
         Reflect.defineMetadata(constants_1.METADATA_KEY.controllerParameter, metadataList, target.constructor);
     };
 }
-exports.params = params;
 /**
  * Converts a string value to the specified type.
  * @param value The value to convert.

package/lib/cjs/adapter-express/express-utils/http-status-middleware.js

@@ -12,18 +12,47 @@ class HttpStatusCodeMiddleware extends core_1.ExpressoMiddleware {
     use(req, res, next) {
         const statusCodeMapping = Reflect.getMetadata(constants_1.HTTP_CODE_METADATA.httpCode, Reflect);
         let path = req.path.endsWith("/") ? req.path.slice(0, -1) : req.path;
+        const formattedMethod = req.method.toLowerCase();
         if (path === "/" || path === "") {
             path = "/";
         }
+        path = `${path}/-${formattedMethod}`;
         const statusCode = statusCodeMapping[path];
         if (statusCode) {
             res.status(statusCode);
         }
         else {
-            this.setDefaultStatusCode(req, res);
+            const patternMatchStatusCode = this.findMatchingParameterPath(path, statusCodeMapping);
+            if (patternMatchStatusCode) {
+                res.status(patternMatchStatusCode);
+            }
+            else {
+                this.setDefaultStatusCode(req, res);
+            }
         }
         next();
     }
+    /**
+     * Find the matching parameter path.
+     * @param path - The path to match.
+     * @param mapping - The mapping to check.
+     * @param method - The method to check.
+     * @returns The status code if found, otherwise null.
+     **/
+    findMatchingParameterPath(path, mapping) {
+        for (const pathCode in mapping) {
+            const patternCheck = new RegExp("^" + pathCode.replace(/:[^\s/]+/g, "([^/]+)") + "$");
+            if (patternCheck.test(path)) {
+                return mapping[pathCode];
+            }
+        }
+        return null;
+    }
+    /**
+     * Set the default status code based on the request method.
+     * @param req - The request object.
+     * @param res - The response object.
+     **/
     setDefaultStatusCode(req, res) {
         switch (req.method.toLowerCase()) {
             case "get":
@@ -35,6 +64,9 @@ class HttpStatusCodeMiddleware extends core_1.ExpressoMiddleware {
             case "put":
                 res.statusCode = 204;
                 break;
+            case "patch":
+                res.statusCode = 204;
+                break;
             case "delete":
                 res.statusCode = 204;
                 break;

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

@@ -194,10 +194,9 @@ class InversifyExpressServer {
                     value();
                 }
                 else if (!res.headersSent) {
-                    if (value === undefined) {
-                        res.status(204);
+                    if (value !== undefined) {
+                        res.send(value);
                     }
-                    res.send(value);
                 }
             }
             catch (err) {

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

@@ -1,6 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.instanceOfIHttpActionResult = exports.cleanUpMetadata = exports.getControllerParameterMetadata = exports.getControllerMethodMetadata = exports.getControllerMetadata = exports.getControllersFromMetadata = exports.getControllersFromContainer = void 0;
+exports.getControllersFromContainer = getControllersFromContainer;
+exports.getControllersFromMetadata = getControllersFromMetadata;
+exports.getControllerMetadata = getControllerMetadata;
+exports.getControllerMethodMetadata = getControllerMethodMetadata;
+exports.getControllerParameterMetadata = getControllerParameterMetadata;
+exports.cleanUpMetadata = cleanUpMetadata;
+exports.instanceOfIHttpActionResult = instanceOfIHttpActionResult;
 const constants_1 = require("./constants");
 function getControllersFromContainer(container, forceControllers) {
     if (container.isBound(constants_1.TYPE.Controller)) {
@@ -13,17 +19,14 @@ function getControllersFromContainer(container, forceControllers) {
         return [];
     }
 }
-exports.getControllersFromContainer = getControllersFromContainer;
 function getControllersFromMetadata() {
     const arrayOfControllerMetadata = Reflect.getMetadata(constants_1.METADATA_KEY.controller, Reflect) || [];
     return arrayOfControllerMetadata.map((metadata) => metadata.target);
 }
-exports.getControllersFromMetadata = getControllersFromMetadata;
 function getControllerMetadata(constructor) {
     const controllerMetadata = Reflect.getOwnMetadata(constants_1.METADATA_KEY.controller, constructor);
     return controllerMetadata;
 }
-exports.getControllerMetadata = getControllerMetadata;
 function getControllerMethodMetadata(constructor) {
     const methodMetadata = Reflect.getOwnMetadata(constants_1.METADATA_KEY.controllerMethod, constructor);
     const genericMetadata = Reflect.getMetadata(constants_1.METADATA_KEY.controllerMethod, Reflect.getPrototypeOf(constructor));
@@ -35,7 +38,6 @@ function getControllerMethodMetadata(constructor) {
     }
     return methodMetadata;
 }
-exports.getControllerMethodMetadata = getControllerMethodMetadata;
 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));
@@ -47,12 +49,9 @@ function getControllerParameterMetadata(constructor) {
     }
     return parameterMetadata;
 }
-exports.getControllerParameterMetadata = getControllerParameterMetadata;
 function cleanUpMetadata() {
     Reflect.defineMetadata(constants_1.METADATA_KEY.controller, [], Reflect);
 }
-exports.cleanUpMetadata = cleanUpMetadata;
 function instanceOfIHttpActionResult(value) {
     return value != null && typeof value.executeAsync === "function";
 }
-exports.instanceOfIHttpActionResult = instanceOfIHttpActionResult;

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

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

package/lib/cjs/adapter-express/render/ejs/ejs.config.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEngineEjs = setEngineEjs;
+const path_1 = require("path");
+/**
+ * Ejs defaults
+ * @type {EjsOptions}
+ * @constant
+ * @default
+ */
+const EJS_DEFAULTS = {
+    viewsDir: (0, path_1.join)(process.cwd(), "views"),
+    viewEngine: "ejs",
+    serverOptions: {},
+};
+/**
+ * Set Ejs as the view engine
+ * @param {Application} app - The express application
+ * @param {EjsOptions} [options=EJS_DEFAULTS] - The ejs options
+ */
+async function setEngineEjs(app, options = EJS_DEFAULTS) {
+    app.set("view engine", options.viewEngine || EJS_DEFAULTS.viewEngine);
+    app.set("views", options.viewsDir || EJS_DEFAULTS.viewsDir);
+    if (Array.isArray(options.viewsDir)) {
+        options.viewsDir.forEach((dir) => {
+            app.set("views", dir);
+        });
+    }
+    if (options.serverOptions) {
+        app.locals = {
+            ...app.locals,
+            ...options.serverOptions,
+        };
+    }
+}

package/lib/cjs/adapter-express/render/ejs/ejs.types.js

@@ -0,0 +1,3 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/adapter-express/render/engine.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Engine = void 0;
+/**
+ * The supported view engines.
+ * @enum {string}
+ * @readonly
+ * @public
+ */
+var Engine;
+(function (Engine) {
+    Engine["HBS"] = "hbs";
+    Engine["EJS"] = "ejs";
+})(Engine || (exports.Engine = Engine = {}));

package/lib/cjs/adapter-express/render/handlebars/hbs.config.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEngineHandlebars = setEngineHandlebars;
+const path_1 = require("path");
+const core_1 = require("@expressots/core");
+/**
+ * Handlebars defaults
+ * @type {HandlebarsOptions}
+ * @constant
+ * @default
+ */
+const HANDLEBARS_DEFAULTS = {
+    viewsDir: (0, path_1.join)(process.cwd(), "views"),
+    viewEngine: "hbs",
+    serverOptions: {},
+};
+/**
+ * Set Handlebars as the view engine
+ * @param {express.Application} app - The express application
+ * @param {HandlebarsOptions} [options=HANDLEBARS_DEFAULTS] - The handlebars options
+ */
+async function setEngineHandlebars(app, options = HANDLEBARS_DEFAULTS) {
+    const logger = new core_1.Logger();
+    try {
+        app.set("view engine", options.viewEngine || HANDLEBARS_DEFAULTS.viewEngine);
+        app.set("views", options.viewsDir || HANDLEBARS_DEFAULTS.viewsDir);
+        if (Array.isArray(options.viewsDir)) {
+            options.viewsDir.forEach((dir) => {
+                app.set("views", dir);
+            });
+        }
+        if (options.serverOptions) {
+            app.locals = {
+                ...app.locals,
+                ...options.serverOptions,
+            };
+        }
+    }
+    catch (error) {
+        logger.error(error.message, "handlebars-config");
+    }
+}

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

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Engine = void 0;
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "Engine", { enumerable: true, get: function () { return engine_1.Engine; } });

package/lib/cjs/adapter-express/render/resolve-render.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packageResolver = packageResolver;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const core_1 = require("@expressots/core");
+/**
+ * Resolve package from the current working directory.
+ * @param packageName
+ * @param options
+ * @returns
+ */
+function packageResolver(packageName, ...options) {
+    const logger = new core_1.Logger();
+    try {
+        const hasPackage = require.resolve(packageName, {
+            paths: [process.cwd()],
+        });
+        if (hasPackage) {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const packageResolved = require(hasPackage);
+            if (typeof packageResolved === "function") {
+                return packageResolved(...options);
+            }
+            if (packageResolved.default && typeof packageResolved.default === "function") {
+                return packageResolved.default(...options);
+            }
+            return packageResolved;
+        }
+    }
+    catch (error) {
+        logger.warn(`Package [${packageName}] not installed. Please install it using your package manager.`, "package-resolver");
+    }
+}

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

@@ -1,8 +1,9 @@
-import { IApplicationMessageToConsole, RenderTemplateOptions } from "@expressots/core";
+import { IApplicationMessageToConsole } from "@expressots/core";
 import express from "express";
 import { Container } from "inversify";
 import { ApplicationBase } from "./application-express.base";
 import { IWebServer, ServerEnvironment } from "./application-express.types";
+import { Engine, EngineOptions } from "./render/engine";
 /**
  * The AppExpress class provides methods for configuring and running an Express application.
  * @class AppExpress
@@ -23,6 +24,7 @@ declare class AppExpress extends ApplicationBase implements IWebServer {
     private globalPrefix;
     private middlewares;
     private console;
+    private renderOptions;
     protected configureServices(): void | Promise<void>;
     protected postServerInitialization(): void | Promise<void>;
     protected serverShutdown(): void | Promise<void>;
@@ -65,6 +67,10 @@ declare class AppExpress extends ApplicationBase implements IWebServer {
      *
      */
     setGlobalRoutePrefix(prefix: string): void;
+    /**
+     * Configures the application's view engine based on the provided configuration options.
+     */
+    private configEngine;
     /**
      * Configures the application's view engine based on the provided configuration options.
      *
@@ -72,11 +78,10 @@ declare class AppExpress extends ApplicationBase implements IWebServer {
      * @method setEngine
      * @template T - A generic type extending from RenderTemplateOptions.
      *
-     * @param {T} options - An object of type T (must be an object that extends RenderTemplateOptions)
-     *                      that provides the configuration options for setting the view engine.
-     *                      This includes the extension name, view path, and the engine function itself.
+     * @param {Engine} engine - The view engine to set
+     * @param {EngineOptions} [options] - The configuration options for the view engine
      */
-    setEngine<T extends RenderTemplateOptions>(options: T): void;
+    setEngine<T extends EngineOptions>(engine: Engine, options?: T): Promise<void>;
     /**
      * Verifies if the current environment is development.
      *

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

@@ -1,5 +1,5 @@
+import { IApplicationMessageToConsole } from "@expressots/core";
 import express from "express";
-import { IApplicationMessageToConsole, RenderTemplateOptions } from "@expressots/core";
 import { ServerEnvironment } from "./application-express.types";
 /**
  * Public Interface for the WebServer application.
@@ -12,18 +12,6 @@ export interface IWebServerPublic {
      * @param consoleMessage - Optional message to display in the console.
      */
     listen(port: number, environment: ServerEnvironment, consoleMessage?: IApplicationMessageToConsole): Promise<void>;
-    /**
-     * Configures the application's view engine based on the provided configuration options.
-     *
-     * @public
-     * @method setEngine
-     * @template T - A generic type extending from RenderTemplateOptions.
-     *
-     * @param {T} options - An object of type T (must be an object that extends RenderTemplateOptions)
-     *                      that provides the configuration options for setting the view engine.
-     *                      This includes the extension name, view path, and the engine function itself.
-     */
-    setEngine<T extends RenderTemplateOptions>(options: T): void;
     /**
      * Get the underlying HTTP server. (default: Express.js)
      * @returns The underlying HTTP server after initialization.

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

@@ -1,13 +1,14 @@
 import express, { Request, Response, NextFunction } from "express";
-import { IApplicationMessageToConsole, RenderTemplateOptions } from "@expressots/core";
+import { IApplicationMessageToConsole } from "@expressots/core";
 import { Container } from "inversify";
+import { Engine, EngineOptions } from "./render/engine";
 /**
  * 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;
+    setEngine<T extends EngineOptions>(engine: Engine, options?: T): Promise<void>;
 }
 /**
  * Constructor type for IWebServer.

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

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { OutgoingHttpHeaders } from "node:http";
 export declare abstract class HttpContent {
     private _headers;

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

@@ -1,7 +1,7 @@
 import "reflect-metadata";
 import { PARAMETER_TYPE, HTTP_VERBS_ENUM } from "./constants";
 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;
+export declare const injectHttpContext: (target: import("inversify/lib/annotation/decorator_utils").DecoratorTarget<unknown>, targetKey?: string | symbol | undefined, indexOrPropertyDescriptor?: number | TypedPropertyDescriptor<unknown>) => void;
 /**
  * Controller decorator to define a new controller
  * @param path route path

package/lib/cjs/types/adapter-express/express-utils/http-status-middleware.d.ts

@@ -7,5 +7,18 @@ import { ExpressoMiddleware } from "@expressots/core";
  */
 export declare class HttpStatusCodeMiddleware extends ExpressoMiddleware {
     use(req: Request, res: Response, next: NextFunction): void | Promise<void>;
+    /**
+     * Find the matching parameter path.
+     * @param path - The path to match.
+     * @param mapping - The mapping to check.
+     * @param method - The method to check.
+     * @returns The status code if found, otherwise null.
+     **/
+    private findMatchingParameterPath;
+    /**
+     * Set the default status code based on the request method.
+     * @param req - The request object.
+     * @param res - The response object.
+     **/
     private setDefaultStatusCode;
 }

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

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import type { OutgoingHttpHeaders } from "node:http";
 import { HttpContent } from "./content/httpContent";
 export declare class HttpResponseMessage {

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

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

package/lib/cjs/types/adapter-express/render/ejs/ejs.config.d.ts

@@ -0,0 +1,21 @@
+import { Application } from "express";
+import { Options } from "./ejs.types";
+/**
+ * Ejs options
+ * @typedef {Object} EjsOptions
+ * @property {string | Array<string>} viewsDir - The path to the views folder
+ * @property {string} viewEngine - The view engine
+ * @property {ejs.Options} [serverOptions] - The server options
+ *
+ */
+export type EjsOptions = {
+    viewsDir?: string | Array<string>;
+    viewEngine?: string;
+    serverOptions?: Options;
+};
+/**
+ * Set Ejs as the view engine
+ * @param {Application} app - The express application
+ * @param {EjsOptions} [options=EJS_DEFAULTS] - The ejs options
+ */
+export declare function setEngineEjs(app: Application, options?: EjsOptions): Promise<void>;

package/lib/cjs/types/adapter-express/render/ejs/ejs.types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * An object where {@link filename} is the final parsed path or {@link template} is the content of the included template
+ */
+export type IncluderResult = {
+    filename: string;
+    template?: never;
+} | {
+    template: string;
+    filename?: never;
+};
+/**
+ * @param originalPath the path as it appears in the include statement
+ * @param parsedPath the previously resolved path
+ *
+ * @return An {@link IncluderResult} object containing the filename or template data.
+ */
+type IncluderCallback = (originalPath: string, parsedPath: string) => IncluderResult;
+/**
+ * Escapes a string using HTML/XML escaping rules.
+ *
+ * Returns the empty string for `null` or `undefined`.
+ *
+ * @param markup Input string
+ * @return Escaped string
+ */
+type EscapeCallback = (markup?: any) => string;
+export interface Options {
+    /**
+     * Log the generated JavaScript source for the EJS template to the console.
+     *
+     * @default false
+     */
+    debug?: boolean | undefined;
+    /**
+     * Include additional runtime debugging information in generated template
+     * functions.
+     *
+     * @default true
+     */
+    compileDebug?: boolean | undefined;
+    /**
+     * Whether or not to use `with () {}` construct in the generated template
+     * functions. If set to `false`, data is still accessible through the object
+     * whose name is specified by `ejs.localsName` (defaults to `locals`).
+     *
+     * @default true
+     */
+    _with?: boolean | undefined;
+    /**
+     * Whether to run in strict mode or not.
+     * Enforces `_with=false`.
+     *
+     * @default false
+     */
+    strict?: boolean | undefined;
+    /**
+     * An array of local variables that are always destructured from `localsName`,
+     * available even in strict mode.
+     *
+     * @default []
+     */
+    destructuredLocals?: Array<string> | undefined;
+    /**
+     * Remove all safe-to-remove whitespace, including leading and trailing
+     * whitespace. It also enables a safer version of `-%>` line slurping for all
+     * scriptlet tags (it does not strip new lines of tags in the middle of a
+     * line).
+     *
+     * @default false
+     */
+    rmWhitespace?: boolean | undefined;
+    /**
+     * Whether or not to compile a `ClientFunction` that can be rendered
+     * in the browser without depending on ejs.js. Otherwise, a `TemplateFunction`
+     * will be compiled.
+     *
+     * @default false
+     */
+    client?: boolean | undefined;
+    /**
+     * The escaping function used with `<%=` construct. It is used in rendering
+     * and is `.toString()`ed in the generation of client functions.
+     *
+     * @default ejs.escapeXML
+     */
+    escape?: EscapeCallback | undefined;
+    /**
+     * The filename of the template. Required for inclusion and caching unless
+     * you are using `renderFile`. Also used for error reporting.
+     *
+     * @default undefined
+     */
+    filename?: string | undefined;
+    /**
+     * The path to templates root(s). When this is set, absolute paths for includes
+     * (/filename.ejs) will be relative to the templates root(s).
+     *
+     * @default undefined
+     */
+    root?: Array<string> | string | undefined;
+    /**
+     * The opening delimiter for all statements. This allows you to clearly delinate
+     * the difference between template code and existing delimiters. (It is recommended
+     * to synchronize this with the closeDelimiter property.)
+     *
+     * @default ejs.openDelimiter
+     */
+    openDelimiter?: string | undefined;
+    /**
+     * The closing delimiter for all statements. This allows to to clearly delinate
+     * the difference between template code and existing delimiters. (It is recommended
+     * to synchronize this with the openDelimiter property.)
+     *
+     * @default ejs.closeDelimiter
+     */
+    closeDelimiter?: string | undefined;
+    /**
+     * Character to use with angle brackets for open/close
+     * @default '%'
+     */
+    delimiter?: string | undefined;
+    /**
+     * Whether or not to enable caching of template functions. Beware that
+     * the options of compilation are not checked as being the same, so
+     * special handling is required if, for example, you want to cache client
+     * and regular functions of the same file.
+     *
+     * Requires `filename` to be set. Only works with rendering function.
+     *
+     * @default false
+     */
+    cache?: boolean | undefined;
+    /**
+     * The Object to which `this` is set during rendering.
+     *
+     * @default this
+     */
+    context?: any;
+    /**
+     * Whether or not to create an async function instead of a regular function.
+     * This requires language support.
+     *
+     * @default false
+     */
+    async?: boolean | undefined;
+    /**
+     * Make sure to set this to 'false' in order to skip UglifyJS parsing,
+     * when using ES6 features (`const`, etc) as UglifyJS doesn't understand them.
+     * @default true
+     */
+    beautify?: boolean | undefined;
+    /**
+     * Name to use for the object storing local variables when not using `with` or destructuring.
+     *
+     * @default ejs.localsName
+     */
+    localsName?: string | undefined;
+    /** Set to a string (e.g., 'echo' or 'print') for a function to print output inside scriptlet tags. */
+    outputFunctionName?: string | undefined;
+    /**
+     * An array of paths to use when resolving includes with relative paths
+     */
+    views?: Array<string> | undefined;
+    /**
+     * Custom function to handle EJS includes
+     */
+    includer?: IncluderCallback;
+}
+export {};

package/lib/cjs/types/adapter-express/render/engine.d.ts

@@ -0,0 +1,27 @@
+import { EjsOptions } from "./ejs/ejs.config";
+import { HandlebarsOptions } from "./handlebars/hbs.config";
+/**
+ * The configuration options for the view engine.
+ * @typedef {HandlebarsOptions | EjsOptions} EngineOptions
+ * @private
+ */
+export type RenderOptions = {
+    engine: Engine;
+    options?: EngineOptions;
+};
+/**
+ * The supported view engines.
+ * @enum {string}
+ * @readonly
+ * @public
+ */
+export declare enum Engine {
+    HBS = "hbs",
+    EJS = "ejs"
+}
+/**
+ * The configuration options for the view engine.
+ * @typedef {HandlebarsOptions | EjsOptions} EngineOptions
+ * @public
+ */
+export type EngineOptions = HandlebarsOptions | EjsOptions;

package/lib/cjs/types/adapter-express/render/handlebars/hbs.config.d.ts

@@ -0,0 +1,20 @@
+import express from "express";
+/**
+ * Handlebars options
+ * @typedef {Object} HandlebarsOptions
+ * @property {string} viewsDir - The path to the views folder
+ * @property {string} viewEngine - The view engine to be used
+ * @property {ConfigOptions} [serverOptions] - The server options
+ *
+ */
+export type HandlebarsOptions = {
+    viewsDir?: string | Array<string>;
+    viewEngine?: string;
+    serverOptions?: unknown;
+};
+/**
+ * Set Handlebars as the view engine
+ * @param {express.Application} app - The express application
+ * @param {HandlebarsOptions} [options=HANDLEBARS_DEFAULTS] - The handlebars options
+ */
+export declare function setEngineHandlebars(app: express.Application, options?: HandlebarsOptions): Promise<void>;

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

@@ -0,0 +1,3 @@
+export { EjsOptions as EJS } from "./ejs/ejs.config";
+export { HandlebarsOptions as HBS } from "./handlebars/hbs.config";
+export { Engine } from "./engine";

package/lib/cjs/types/adapter-express/render/resolve-render.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolve package from the current working directory.
+ * @param packageName
+ * @param options
+ * @returns
+ */
+export declare function packageResolver(packageName: string, ...options: Array<any>): any;

package/lib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/adapter-express",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@adapter-express)",
   "author": "",
   "main": "./lib/cjs/index.js",
@@ -47,10 +47,10 @@
     "server-side"
   ],
   "engines": {
-    "node": ">=18.10.0"
+    "node": ">=18.18.0"
   },
   "scripts": {
-    "prepare": "husky install",
+    "prepare": "husky",
     "clean": "node scripts/rm.js lib",
     "copy": "node scripts/copy.js package.json README.md CHANGELOG.md lib",
     "build": "npm run clean && npm run build:cjs && npm run copy",
@@ -73,25 +73,24 @@
   },
   "devDependencies": {
     "@codecov/vite-plugin": "^0.0.1-beta.6",
-    "@commitlint/cli": "18.0.0",
-    "@commitlint/config-conventional": "17.7.0",
-    "@expressots/core": "latest",
-    "@release-it/conventional-changelog": "7.0.1",
+    "@commitlint/cli": "19.2.1",
+    "@commitlint/config-conventional": "19.2.2",
+    "@expressots/core": "2.15.0",
+    "@release-it/conventional-changelog": "8.0.1",
     "@types/express": "4.17.21",
-    "@types/node": "20.4.9",
-    "@typescript-eslint/eslint-plugin": "6.6.0",
-    "@typescript-eslint/parser": "6.6.0",
-    "@vitest/coverage-v8": "^1.4.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",
-    "vite": "^5.2.8",
-    "vite-tsconfig-paths": "^4.3.2",
-    "vitest": "^1.4.0"
+    "@types/node": "20.14.10",
+    "@typescript-eslint/eslint-plugin": "7.16.1",
+    "@typescript-eslint/parser": "7.16.1",
+    "@vitest/coverage-v8": "2.0.3",
+    "eslint": "8.57.0",
+    "eslint-config-prettier": "9.1.0",
+    "husky": "9.0.11",
+    "prettier": "3.3.3",
+    "release-it": "17.6.0",
+    "typescript": "5.5.3",
+    "vite": "5.3.3",
+    "vite-tsconfig-paths": "4.3.2",
+    "vitest": "2.0.3"
   },
   "release-it": {
     "git": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/adapter-express",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@adapter-express)",
   "author": "",
   "main": "./lib/cjs/index.js",
@@ -47,10 +47,10 @@
     "server-side"
   ],
   "engines": {
-    "node": ">=18.10.0"
+    "node": ">=18.18.0"
   },
   "scripts": {
-    "prepare": "husky install",
+    "prepare": "husky",
     "clean": "node scripts/rm.js lib",
     "copy": "node scripts/copy.js package.json README.md CHANGELOG.md lib",
     "build": "npm run clean && npm run build:cjs && npm run copy",
@@ -73,25 +73,24 @@
   },
   "devDependencies": {
     "@codecov/vite-plugin": "^0.0.1-beta.6",
-    "@commitlint/cli": "18.0.0",
-    "@commitlint/config-conventional": "17.7.0",
-    "@expressots/core": "latest",
-    "@release-it/conventional-changelog": "7.0.1",
+    "@commitlint/cli": "19.2.1",
+    "@commitlint/config-conventional": "19.2.2",
+    "@expressots/core": "2.15.0",
+    "@release-it/conventional-changelog": "8.0.1",
     "@types/express": "4.17.21",
-    "@types/node": "20.4.9",
-    "@typescript-eslint/eslint-plugin": "6.6.0",
-    "@typescript-eslint/parser": "6.6.0",
-    "@vitest/coverage-v8": "^1.4.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",
-    "vite": "^5.2.8",
-    "vite-tsconfig-paths": "^4.3.2",
-    "vitest": "^1.4.0"
+    "@types/node": "20.14.10",
+    "@typescript-eslint/eslint-plugin": "7.16.1",
+    "@typescript-eslint/parser": "7.16.1",
+    "@vitest/coverage-v8": "2.0.3",
+    "eslint": "8.57.0",
+    "eslint-config-prettier": "9.1.0",
+    "husky": "9.0.11",
+    "prettier": "3.3.3",
+    "release-it": "17.6.0",
+    "typescript": "5.5.3",
+    "vite": "5.3.3",
+    "vite-tsconfig-paths": "4.3.2",
+    "vitest": "2.0.3"
   },
   "release-it": {
     "git": {