@expressots/adapter-express 1.5.0 → 1.7.0

package/lib/CHANGELOG.md

@@ -1,5 +1,42 @@
 
 
+## [1.7.0](https://github.com/expressots/adapter-express/compare/1.6.0...1.7.0) (2024-07-23)
+
+
+### Features
+
+* add @Render decorator ([522d6e2](https://github.com/expressots/adapter-express/commit/522d6e27163b1ec638a9d5328fb3bf5f81054c5c))
+* add pug engine support ([a879f96](https://github.com/expressots/adapter-express/commit/a879f9642dccd74a49b9188a25fcd1bbf30eb8ba))
+* bump husky from 9.0.11 to 9.1.1 ([7c1678a](https://github.com/expressots/adapter-express/commit/7c1678abf4a78e52483fff190524c5658dba1100))
+* bump vite from 5.3.3 to 5.3.4 ([86f51a3](https://github.com/expressots/adapter-express/commit/86f51a3f5f920fcc7a760730e877ae830fa574e5))
+
+
+### Bug Fixes
+
+* add options to ejs and hbs support ([b52ce5c](https://github.com/expressots/adapter-express/commit/b52ce5c3860ea7d859534d96cee030dbc4ffc19c))
+
+## [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)
 
 
@@ -119,4 +156,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 pug_config_1 = require("./render/pug/pug.config");
 /**
  * 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,26 @@ 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;
+                case engine_1.Engine.PUG:
+                    await (0, pug_config_1.setEnginePug)(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 +178,20 @@ 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) {
+        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/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_ROUTING_ROOT_PATH = exports.NO_CONTROLLERS_FOUND = exports.DUPLICATED_CONTROLLER_NAME = exports.HTTP_VERBS_ENUM = exports.PARAMETER_TYPE = exports.HTTP_CODE_METADATA = exports.METADATA_KEY = exports.TYPE = void 0;
+exports.DEFAULT_ROUTING_ROOT_PATH = exports.NO_CONTROLLERS_FOUND = exports.DUPLICATED_CONTROLLER_NAME = exports.HTTP_VERBS_ENUM = exports.PARAMETER_TYPE = exports.RENDER_METADATA_KEY = exports.HTTP_CODE_METADATA = exports.METADATA_KEY = exports.TYPE = void 0;
 exports.TYPE = {
     AuthProvider: Symbol.for("AuthProvider"),
     Controller: Symbol.for("Controller"),
@@ -17,6 +17,7 @@ exports.HTTP_CODE_METADATA = {
     statusCode: "inversify-express-utils:statuscode",
     path: "inversify-express-utils:path",
 };
+exports.RENDER_METADATA_KEY = Symbol("Render");
 var PARAMETER_TYPE;
 (function (PARAMETER_TYPE) {
     PARAMETER_TYPE[PARAMETER_TYPE["REQUEST"] = 0] = "REQUEST";

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

@@ -1,6 +1,19 @@
 "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;
+exports.Render = Render;
+exports.getRenderMetadata = getRenderMetadata;
 require("reflect-metadata");
 const inversify_1 = require("inversify");
 const constants_1 = require("./constants");
@@ -37,7 +50,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
@@ -65,7 +77,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
@@ -74,7 +85,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
@@ -83,7 +93,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
@@ -92,7 +101,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
@@ -101,7 +109,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
@@ -110,7 +117,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
@@ -119,7 +125,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
@@ -128,7 +133,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
@@ -219,7 +223,6 @@ function httpMethod(method, path, ...middleware) {
         metadataList.push(metadata);
     };
 }
-exports.httpMethod = httpMethod;
 /**
  * Parameter decorator to inject the request object
  * @returns ParameterDecorator
@@ -300,7 +303,21 @@ function params(type, parameterName) {
         Reflect.defineMetadata(constants_1.METADATA_KEY.controllerParameter, metadataList, target.constructor);
     };
 }
-exports.params = params;
+/**
+ * Render decorator to define the template and default data for a route
+ * @param template The template to render
+ * @param defaultData The default data to pass to the template
+ * @returns
+ */
+function Render(template, defaultData) {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(constants_1.RENDER_METADATA_KEY, { template, defaultData }, target, propertyKey);
+    };
+}
+function getRenderMetadata(target, propertyKey) {
+    return Reflect.getMetadata(constants_1.RENDER_METADATA_KEY, target, propertyKey) || {};
+}
 /**
  * Converts a string value to the specified type.
  * @param value The value to convert.

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

@@ -30,6 +30,7 @@ const base_middleware_1 = require("./base-middleware");
 const utils_1 = require("./utils");
 const constants_1 = require("./constants");
 const httpResponseMessage_1 = require("./httpResponseMessage");
+const decorators_1 = require("./decorators");
 class InversifyExpressServer {
     /**
      * Wrapper for the express server.
@@ -182,8 +183,14 @@ class InversifyExpressServer {
                 const httpContext = this._getHttpContext(req);
                 httpContext.container.bind(constants_1.TYPE.HttpContext).toConstantValue(httpContext);
                 // invoke controller's action
-                const value = await httpContext.container.getNamed(constants_1.TYPE.Controller, controllerName)[key](...args);
-                if (value instanceof httpResponseMessage_1.HttpResponseMessage) {
+                const controller = httpContext.container.getNamed(constants_1.TYPE.Controller, controllerName);
+                const value = await controller[key](...args);
+                const { template, defaultData } = (0, decorators_1.getRenderMetadata)(controller, key);
+                if (template) {
+                    const data = value || defaultData || {};
+                    res.render(template, data);
+                }
+                else if (value instanceof httpResponseMessage_1.HttpResponseMessage) {
                     await this.handleHttpResponseMessage(value, res);
                 }
                 else if ((0, utils_1.instanceOfIHttpActionResult)(value)) {
@@ -194,10 +201,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,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEngineEjs = setEngineEjs;
+const path_1 = require("path");
+const resolve_render_1 = require("../resolve-render");
+/**
+ * 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) {
+    (0, resolve_render_1.packageResolver)("ejs");
+    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,15 @@
+"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["PUG"] = "pug";
+})(Engine || (exports.Engine = Engine = {}));

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

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEngineHandlebars = setEngineHandlebars;
+const path_1 = require("path");
+const core_1 = require("@expressots/core");
+const resolve_render_1 = require("../resolve-render");
+/**
+ * Handlebars defaults
+ * @type {HandlebarsOptions}
+ * @constant
+ * @default
+ */
+const HANDLEBARS_DEFAULTS = {
+    viewEngine: "hbs",
+    viewsDir: (0, path_1.join)(process.cwd(), "views"),
+    partialsDir: (0, path_1.join)(process.cwd(), "views/partials"),
+};
+/**
+ * Default partials directory
+ */
+const DEFAULT_PARTIALS_DIR = (0, path_1.join)(process.cwd(), "views/partials");
+/**
+ * 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 {
+        const hbs = (0, resolve_render_1.packageResolver)("hbs");
+        hbs.registerPartials(options.partialsDir || DEFAULT_PARTIALS_DIR);
+        app.set("view engine", options.viewEngine || HANDLEBARS_DEFAULTS.viewEngine);
+        app.set("views", options.viewsDir || HANDLEBARS_DEFAULTS.viewsDir);
+    }
+    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/pug/pug.config.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEnginePug = setEnginePug;
+const path_1 = require("path");
+const resolve_render_1 = require("../resolve-render");
+/**
+ * Pug defaults
+ * @type {PugOptions}
+ * @constant
+ * @default
+ */
+const PUG_DEFAULTS = {
+    viewEngine: "pug",
+    viewsDir: (0, path_1.join)(process.cwd(), "views"),
+};
+/**
+ * Set Pug as the view engine
+ * @param {express.Application} app - The express application
+ * @param {PugOptions} [options=PUG_DEFAULTS] - The pug options
+ */
+async function setEnginePug(app, options = PUG_DEFAULTS) {
+    (0, resolve_render_1.packageResolver)("pug");
+    app.set("view engine", options.viewEngine || PUG_DEFAULTS.viewEngine);
+    app.set("views", options.viewsDir || PUG_DEFAULTS.viewsDir);
+}

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/constants.d.ts

@@ -14,6 +14,7 @@ export declare const HTTP_CODE_METADATA: {
     statusCode: string;
     path: string;
 };
+export declare const RENDER_METADATA_KEY: unique symbol;
 export declare enum PARAMETER_TYPE {
     REQUEST = 0,
     RESPONSE = 1,

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
@@ -121,3 +121,14 @@ export declare const principal: () => ParameterDecorator;
  * @returns ParameterDecorator
  */
 export declare function params(type: PARAMETER_TYPE, parameterName?: string): ParameterDecorator;
+/**
+ * Render decorator to define the template and default data for a route
+ * @param template The template to render
+ * @param defaultData The default data to pass to the template
+ * @returns
+ */
+export declare function Render(template: string, defaultData?: Record<string, unknown>): MethodDecorator;
+export declare function getRenderMetadata(target: object, propertyKey: string | symbol): {
+    template?: string;
+    defaultData?: Record<string, unknown>;
+};

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,28 @@
+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",
+    PUG = "pug"
+}
+/**
+ * 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 = {
+    viewEngine?: string;
+    viewsDir?: string;
+    partialsDir?: string;
+};
+/**
+ * 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,4 @@
+export { EjsOptions as EJS } from "./ejs/ejs.config";
+export { HandlebarsOptions as HBS } from "./handlebars/hbs.config";
+export { PugOptions as PUG } from "./pug/pug.config";
+export { Engine } from "./engine";

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

@@ -0,0 +1,17 @@
+import { Application } from "express";
+/**
+ * Pug options
+ * @typedef {Object} PugOptions
+ * @property {string} viewEngine - The view engine to be used
+ * @property {string} viewsDir - The path to the views folder
+ */
+export type PugOptions = {
+    viewEngine?: string;
+    viewsDir?: string;
+};
+/**
+ * Set Pug as the view engine
+ * @param {express.Application} app - The express application
+ * @param {PugOptions} [options=PUG_DEFAULTS] - The pug options
+ */
+export declare function setEnginePug(app: Application, options?: PugOptions): Promise<void>;

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.5.0",
+  "version": "1.7.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/cli": "19.2.1",
     "@commitlint/config-conventional": "19.2.2",
-    "@expressots/core": "latest",
-    "@release-it/conventional-changelog": "7.0.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",
+    "@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.2",
-    "release-it": "16.3.0",
-    "ts-jest": "29.0.5",
-    "typescript": "5.2.2",
-    "vite": "^5.2.8",
-    "vite-tsconfig-paths": "^4.3.2",
-    "vitest": "^1.4.0"
+    "husky": "9.1.1",
+    "prettier": "3.3.3",
+    "release-it": "17.6.0",
+    "typescript": "5.5.3",
+    "vite": "5.3.4",
+    "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.5.0",
+  "version": "1.7.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/cli": "19.2.1",
     "@commitlint/config-conventional": "19.2.2",
-    "@expressots/core": "latest",
-    "@release-it/conventional-changelog": "7.0.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",
+    "@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.2",
-    "release-it": "16.3.0",
-    "ts-jest": "29.0.5",
-    "typescript": "5.2.2",
-    "vite": "^5.2.8",
-    "vite-tsconfig-paths": "^4.3.2",
-    "vitest": "^1.4.0"
+    "husky": "9.1.1",
+    "prettier": "3.3.3",
+    "release-it": "17.6.0",
+    "typescript": "5.5.3",
+    "vite": "5.3.4",
+    "vite-tsconfig-paths": "4.3.2",
+    "vitest": "2.0.3"
   },
   "release-it": {
     "git": {