@expressots/adapter-express 1.6.0 → 1.8.0

package/lib/CHANGELOG.md

@@ -1,5 +1,42 @@
 
 
+## [1.8.0](https://github.com/expressots/adapter-express/compare/1.7.0...1.8.0) (2024-08-13)
+
+
+### Features
+
+* add expressots middleware in decorators ([055ead9](https://github.com/expressots/adapter-express/commit/055ead94334dd5ea735ddf04a16a322d56d566cc))
+* add FileUpload decorator ([a4f62b1](https://github.com/expressots/adapter-express/commit/a4f62b1cd377625c55218069599a7a262493e3f5))
+
+
+### Bug Fixes
+
+* adjust error msgs and package resolver ([34a0fcd](https://github.com/expressots/adapter-express/commit/34a0fcde6e637130e328733f48130408fa881a67))
+* adjust isExpressoMiddleware function param types ([edc0888](https://github.com/expressots/adapter-express/commit/edc0888489df4c9f33a5b97af0820ce8f90904e9))
+* return message ([32d656e](https://github.com/expressots/adapter-express/commit/32d656ec2b05a807599e428c9bd0389849c2165d))
+
+
+### Code Refactoring
+
+* bump expresso core deps & remove husky deprecated code ([a9b243f](https://github.com/expressots/adapter-express/commit/a9b243fd35b877c839da2871401574cf30db808e))
+* httpMethod to Method decorator ([5e853a0](https://github.com/expressots/adapter-express/commit/5e853a04358430e9e6f658bf0d0b68b7e2708a24))
+* remove unnecessary comments ([72c4a15](https://github.com/expressots/adapter-express/commit/72c4a157055fffdfbaad19a69ea124ca0eb7fa13))
+
+## [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)
 
 

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

@@ -20,7 +20,7 @@ const inversify_express_server_1 = require("./express-utils/inversify-express-se
 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");
+const pug_config_1 = require("./render/pug/pug.config");
 /**
  * The AppExpress class provides methods for configuring and running an Express application.
  * @class AppExpress
@@ -163,6 +163,9 @@ let AppExpress = class AppExpress extends application_express_base_1.Application
                 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!");
             }
@@ -179,7 +182,6 @@ let AppExpress = class AppExpress extends application_express_base_1.Application
      * @param {EngineOptions} [options] - The configuration options for the view engine
      */
     async setEngine(engine, options) {
-        (0, resolve_render_1.packageResolver)(engine, options);
         try {
             if (options) {
                 this.renderOptions = { engine, options };

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

@@ -10,11 +10,16 @@ exports.Put = Put;
 exports.Patch = Patch;
 exports.Head = Head;
 exports.Delete = Delete;
-exports.httpMethod = httpMethod;
+exports.Method = Method;
 exports.params = params;
+exports.Render = Render;
+exports.getRenderMetadata = getRenderMetadata;
+exports.FileUpload = FileUpload;
 require("reflect-metadata");
 const inversify_1 = require("inversify");
 const constants_1 = require("./constants");
+const resolver_multer_1 = require("./resolver-multer");
+const core_1 = require("@expressots/core");
 exports.injectHttpContext = (0, inversify_1.inject)(constants_1.TYPE.HttpContext);
 /**
  * Controller decorator to define a new controller
@@ -81,7 +86,7 @@ function Http(code) {
  * @param middleware array of middleware to be applied to all routes defined in path logic
  */
 function All(path, ...middleware) {
-    return httpMethod("all", path, ...middleware);
+    return Method("all", path, ...middleware);
 }
 /**
  * Decorator to allow GET HTTP method
@@ -97,7 +102,7 @@ function Get(path, ...middleware) {
  * @param middleware array of middleware to be applied to the route
  */
 function Post(path, ...middleware) {
-    return httpMethod("post", path, ...middleware);
+    return Method("post", path, ...middleware);
 }
 /**
  * Decorator to allow PUT HTTP method
@@ -121,7 +126,7 @@ function Patch(path, ...middleware) {
  * @param middleware array of middleware to be applied to the route
  */
 function Head(path, ...middleware) {
-    return httpMethod("head", path, ...middleware);
+    return Method("head", path, ...middleware);
 }
 /**
  * Decorator to allow DELETE HTTP method
@@ -187,7 +192,7 @@ function enhancedHttpMethod(method, path, ...middleware) {
  * @param path route path
  * @param middleware array of middleware to be applied to the route
  */
-function httpMethod(method, path, ...middleware) {
+function Method(method, path, ...middleware) {
     return (target, key) => {
         const metadata = {
             key,
@@ -301,6 +306,21 @@ function params(type, parameterName) {
         Reflect.defineMetadata(constants_1.METADATA_KEY.controllerParameter, metadataList, target.constructor);
     };
 }
+/**
+ * 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.
@@ -319,3 +339,87 @@ function convertToType(value, type) {
     }
     return value;
 }
+/**
+ * File upload decorator to handle file uploads
+ * @param options
+ * @param multerOptions
+ * @default { none: true }
+ * @returns MethodDecorator
+ */
+function FileUpload(options, multerOptions) {
+    const multer = (0, resolver_multer_1.packageResolver)("multer");
+    /* eslint-disable @typescript-eslint/no-explicit-any */
+    let upload;
+    let method = "none";
+    if (multer) {
+        if (options === undefined) {
+            options = { none: true };
+        }
+        upload = multer(multerOptions);
+        method = inferMulterMethod(options);
+    }
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        /* eslint-disable @typescript-eslint/no-explicit-any */
+        descriptor.value = function (...args) {
+            const req = args[0];
+            const res = args[1];
+            // const next = args[2] as NextFunction;
+            const multerMiddleware = getMulterMiddleware(upload, options, method);
+            multerMiddleware(req, res, (err) => {
+                if (err) {
+                    return res.status(400).json({ error: err.message });
+                }
+                return originalMethod.apply(this, args);
+            });
+        };
+    };
+}
+/**
+ * Infer the multer method to use based on the provided options
+ * @param options
+ * @returns
+ */
+function inferMulterMethod(options) {
+    const report = new core_1.Report();
+    if (options.none)
+        return "none";
+    if (options.any)
+        return "any";
+    if (Array.isArray(options))
+        return "fields";
+    if (options.fieldName && options.maxCount !== undefined)
+        return "array";
+    if (options.fieldName)
+        return "single";
+    throw report.error("Invalid options provided for FileUpload.", core_1.StatusCode.InternalServerError, "multer-decorator");
+}
+/**
+ * Get the multer middleware based on the method
+ * @param upload
+ * @param options
+ * @param method
+ * @returns
+ */
+function getMulterMiddleware(upload, options, method) {
+    const report = new core_1.Report();
+    switch (method) {
+        case "single":
+            return upload.single(options.fieldName);
+        case "array":
+            return upload.array(options.fieldName, options.maxCount);
+        case "fields": {
+            const fieldsOptions = options.map((opt) => ({
+                name: opt.fieldName,
+                maxCount: opt.maxCount,
+            }));
+            return upload.fields(fieldsOptions);
+        }
+        case "none":
+            return upload.none();
+        case "any":
+            return upload.any();
+        default:
+            throw report.error(`Unsupported Multer method: ${method}`, core_1.StatusCode.InternalServerError, "multer-decorator");
+    }
+}

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.
@@ -125,22 +126,32 @@ class InversifyExpressServer {
             const methodMetadata = (0, utils_1.getControllerMethodMetadata)(controller.constructor);
             const parameterMetadata = (0, utils_1.getControllerParameterMetadata)(controller.constructor);
             if (controllerMetadata && methodMetadata) {
-                const controllerMiddleware = this.resolveMidleware(...controllerMetadata.middleware);
+                const controllerMiddleware = this.resolveMiddleware(...controllerMetadata.middleware);
                 methodMetadata.forEach((metadata) => {
                     let paramList = [];
                     if (parameterMetadata) {
                         paramList = parameterMetadata[metadata.key] || [];
                     }
                     const handler = this.handlerFactory(controllerMetadata.target.name, metadata.key, paramList);
-                    const routeMiddleware = this.resolveMidleware(...metadata.middleware);
+                    const routeMiddleware = this.resolveMiddleware(...metadata.middleware);
                     this._router[metadata.method](`${controllerMetadata.path}${metadata.path}`, ...controllerMiddleware, ...routeMiddleware, handler);
                 });
             }
         });
         this._app.use(this._routingConfig.rootPath, this._router);
     }
-    resolveMidleware(...middleware) {
+    isExpressoMiddleware(middlewareItem) {
+        return (typeof middlewareItem === "object" &&
+            "use" in middlewareItem &&
+            typeof middlewareItem.use === "function");
+    }
+    resolveMiddleware(...middleware) {
         return middleware.map((middlewareItem) => {
+            if (this.isExpressoMiddleware(middlewareItem)) {
+                return (req, res, next) => {
+                    middlewareItem.use(req, res, next);
+                };
+            }
             if (!this._container.isBound(middlewareItem)) {
                 return middlewareItem;
             }
@@ -182,8 +193,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)) {

package/lib/cjs/adapter-express/express-utils/resolver-multer.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) {
+    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;
+            }
+            if (packageResolved.default && typeof packageResolved.default === "function") {
+                return packageResolved.default;
+            }
+            return packageResolved;
+        }
+    }
+    catch (error) {
+        logger.warn(`Package [${packageName}] not installed. Please install it using your package manager.`, "package-resolver");
+    }
+}

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

@@ -2,6 +2,7 @@
 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}
@@ -19,6 +20,7 @@ const EJS_DEFAULTS = {
  * @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)) {

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

@@ -11,4 +11,5 @@ 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

@@ -3,6 +3,7 @@ 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}
@@ -10,10 +11,14 @@ const core_1 = require("@expressots/core");
  * @default
  */
 const HANDLEBARS_DEFAULTS = {
-    viewsDir: (0, path_1.join)(process.cwd(), "views"),
     viewEngine: "hbs",
-    serverOptions: {},
+    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
@@ -22,19 +27,10 @@ const HANDLEBARS_DEFAULTS = {
 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);
-        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/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/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/decorators.d.ts

@@ -70,7 +70,7 @@ export declare function Delete(path: string, ...middleware: Array<Middleware>):
  * @param path route path
  * @param middleware array of middleware to be applied to the route
  */
-export declare function httpMethod(method: keyof typeof HTTP_VERBS_ENUM, path: string, ...middleware: Array<Middleware>): HandlerDecorator;
+export declare function Method(method: keyof typeof HTTP_VERBS_ENUM, path: string, ...middleware: Array<Middleware>): HandlerDecorator;
 /**
  * Parameter decorator to inject the request object
  * @returns ParameterDecorator
@@ -121,3 +121,62 @@ 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>;
+};
+export interface StorageEngine {
+    _handleFile(req: unknown, file: MulterFile, callback: (error?: Error | null, info?: Partial<MulterFile>) => void): void;
+    _removeFile(req: unknown, file: MulterFile, callback: (error: Error | null) => void): void;
+}
+export interface MulterFile {
+    fieldname: string;
+    originalname: string;
+    encoding: string;
+    mimetype: string;
+    size: number;
+    destination?: string;
+    filename?: string;
+    path?: string;
+    buffer?: Buffer;
+}
+export interface MulterLimits {
+    fieldNameSize?: number;
+    fieldSize?: number;
+    fields?: number;
+    fileSize?: number;
+    files?: number;
+    parts?: number;
+    headerPairs?: number;
+}
+export interface MulterOptions {
+    dest?: string;
+    storage?: StorageEngine;
+    limits?: MulterLimits;
+    fileFilter?: FileFilter;
+}
+export type FileFilterCallback = (error: Error | null, acceptFile: boolean) => void;
+export type FileFilter = (req: unknown, file: MulterFile, callback: FileFilterCallback) => void;
+type FieldOptions = {
+    fieldName: string;
+    maxCount?: number;
+};
+/**
+ * File upload decorator to handle file uploads
+ * @param options
+ * @param multerOptions
+ * @default { none: true }
+ * @returns MethodDecorator
+ */
+export declare function FileUpload(options?: FieldOptions | Array<FieldOptions> | {
+    none?: boolean;
+    any?: boolean;
+}, multerOptions?: MulterOptions): MethodDecorator;
+export {};

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

@@ -12,7 +12,10 @@ interface ConstructorFunction<T = Record<string, unknown>> {
     prototype: Prototype<T>;
 }
 export type DecoratorTarget<T = unknown> = ConstructorFunction<T> | Prototype<T>;
-export type Middleware = string | symbol | RequestHandler;
+export interface IExpressoMiddleware {
+    use(req: Request, res: Response, next: NextFunction): Promise<void> | void;
+}
+export type Middleware = string | symbol | RequestHandler | IExpressoMiddleware;
 export type ControllerHandler = (...params: Array<unknown>) => unknown;
 export type BaseController = Record<string, ControllerHandler>;
 export interface Controller {

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

@@ -46,7 +46,8 @@ export declare class InversifyExpressServer {
      */
     build(): express.Application;
     private registerControllers;
-    private resolveMidleware;
+    private isExpressoMiddleware;
+    private resolveMiddleware;
     private copyHeadersTo;
     private handleHttpResponseMessage;
     private handlerFactory;

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

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

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

@@ -17,7 +17,8 @@ export type RenderOptions = {
  */
 export declare enum Engine {
     HBS = "hbs",
-    EJS = "ejs"
+    EJS = "ejs",
+    PUG = "pug"
 }
 /**
  * The configuration options for the view engine.

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

@@ -8,9 +8,9 @@ import express from "express";
  *
  */
 export type HandlebarsOptions = {
-    viewsDir?: string | Array<string>;
     viewEngine?: string;
-    serverOptions?: unknown;
+    viewsDir?: string;
+    partialsDir?: string;
 };
 /**
  * Set Handlebars as the view engine

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

@@ -1,3 +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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/adapter-express",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@adapter-express)",
   "author": "",
   "main": "./lib/cjs/index.js",
@@ -75,7 +75,7 @@
     "@codecov/vite-plugin": "^0.0.1-beta.6",
     "@commitlint/cli": "19.2.1",
     "@commitlint/config-conventional": "19.2.2",
-    "@expressots/core": "2.15.0",
+    "@expressots/core": "2.16.0",
     "@release-it/conventional-changelog": "8.0.1",
     "@types/express": "4.17.21",
     "@types/node": "20.14.10",
@@ -84,11 +84,11 @@
     "@vitest/coverage-v8": "2.0.3",
     "eslint": "8.57.0",
     "eslint-config-prettier": "9.1.0",
-    "husky": "9.0.11",
+    "husky": "9.1.1",
     "prettier": "3.3.3",
     "release-it": "17.6.0",
     "typescript": "5.5.3",
-    "vite": "5.3.3",
+    "vite": "5.3.4",
     "vite-tsconfig-paths": "4.3.2",
     "vitest": "2.0.3"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/adapter-express",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@adapter-express)",
   "author": "",
   "main": "./lib/cjs/index.js",
@@ -75,7 +75,7 @@
     "@codecov/vite-plugin": "^0.0.1-beta.6",
     "@commitlint/cli": "19.2.1",
     "@commitlint/config-conventional": "19.2.2",
-    "@expressots/core": "2.15.0",
+    "@expressots/core": "2.16.0",
     "@release-it/conventional-changelog": "8.0.1",
     "@types/express": "4.17.21",
     "@types/node": "20.14.10",
@@ -84,11 +84,11 @@
     "@vitest/coverage-v8": "2.0.3",
     "eslint": "8.57.0",
     "eslint-config-prettier": "9.1.0",
-    "husky": "9.0.11",
+    "husky": "9.1.1",
     "prettier": "3.3.3",
     "release-it": "17.6.0",
     "typescript": "5.5.3",
-    "vite": "5.3.3",
+    "vite": "5.3.4",
     "vite-tsconfig-paths": "4.3.2",
     "vitest": "2.0.3"
   },