@expressots/core 2.6.0 → 2.8.0

package/lib/CHANGELOG.md

@@ -1,5 +1,54 @@
 
 
+## [2.8.0](https://github.com/expressots/expressots/compare/2.7.0...2.8.0) (2024-3-5)
+
+
+### Features
+
+* add middleware handler, config and expresso ([df60183](https://github.com/expressots/expressots/commit/df601837a771662723f25f185622de8c912f6721))
+* add provide annotation to abstract class ExpressMiddleware ([49e762e](https://github.com/expressots/expressots/commit/49e762e035053d67a977d54d9f448334e931134b))
+* Added it into options wiring ([58e58c1](https://github.com/expressots/expressots/commit/58e58c11693d8dfc8e235bbc5b8d62aa35493ec9))
+* Added multer middleware for expressots ([522db5d](https://github.com/expressots/expressots/commit/522db5d58dd4521fd03528cf4178cbbc951a0537))
+* bump @commitlint/cli from 17.8.1 to 18.0.0 ([4ddcbd4](https://github.com/expressots/expressots/commit/4ddcbd49ffe65cfa7a15b253515bb7f3446046ee))
+* bump @commitlint/config-conventional from 17.8.1 to 18.0.0 ([91e1237](https://github.com/expressots/expressots/commit/91e12370f9736188805df20d4f7da378720ac43b))
+* bump husky from 8.0.3 to 9.0.11 ([#170](https://github.com/expressots/expressots/issues/170)) ([342983f](https://github.com/expressots/expressots/commit/342983fe59d6ccc409f887f7a1c8f65c9469a8d7))
+* bump prettier from 3.0.3 to 3.1.1 ([#145](https://github.com/expressots/expressots/issues/145)) ([2e7b812](https://github.com/expressots/expressots/commit/2e7b81226c65468edacae51407ce56c78c66a85b))
+* bump prettier from 3.1.1 to 3.2.5 ([#166](https://github.com/expressots/expressots/issues/166)) ([49c148c](https://github.com/expressots/expressots/commit/49c148c2fae6b4e0260650fbbcf559c69075d9bc))
+* bump reflect-metadata from 0.1.14 to 0.2.1 ([#148](https://github.com/expressots/expressots/issues/148)) ([f444982](https://github.com/expressots/expressots/commit/f444982ccbedb75f3c26b982a2a5d5d336857aae))
+* bump vite from 4.4.11 to 4.5.0 ([344161c](https://github.com/expressots/expressots/commit/344161cdf0cd7f54ffaa069023241aaea04d7c5d))
+* comments addressed ([8c3f55a](https://github.com/expressots/expressots/commit/8c3f55a901874c1e9c33d415157fa0a2beab9c56))
+* correct expresso middleware path ([0879c10](https://github.com/expressots/expressots/commit/0879c104810256f5143dcb2206579debaf0e6a97))
+* Include multer as resolver ([056d4d9](https://github.com/expressots/expressots/commit/056d4d99801f9f4af2932bcee333a1fa652b45a8))
+* remove getmiddleware pipeline from interface ([0577527](https://github.com/expressots/expressots/commit/057752754e257552eddebf031cf977f663b093ed))
+* Remove multer dependency / Added dynamic multer usage behavior ([6a4530b](https://github.com/expressots/expressots/commit/6a4530be243c961e5bfe50340d2c41742332e186))
+* Remove multer dependency with interface defined ([5a0acd2](https://github.com/expressots/expressots/commit/5a0acd228166efc2de8f4be7078c21ed6fd34634))
+* Remove multer dependency with interface defined ([8133621](https://github.com/expressots/expressots/commit/8133621108bb7f2017088d59ae6145da8606ebf7))
+* update reflect metadata on templates ([#152](https://github.com/expressots/expressots/issues/152)) ([75a3312](https://github.com/expressots/expressots/commit/75a33122e0f468b9e28040b8e7eb6747252e4c6b))
+
+
+### Bug Fixes
+
+* interface types and middleware return multer ([b5223fd](https://github.com/expressots/expressots/commit/b5223fdc22eaaf1cb9b315b2aa77ad0e615e8ed3))
+* remove codesee build ([#177](https://github.com/expressots/expressots/issues/177)) ([812e06d](https://github.com/expressots/expressots/commit/812e06da1b91cc7a4b0685ec70b0f0de1bd4517b))
+
+## [2.7.0](https://github.com/expressots/expressots/compare/2.6.0...2.7.0) (2023-10-17)
+
+
+### Features
+
+* add db in memory as provider ([b656f22](https://github.com/expressots/expressots/commit/b656f2297e0e985dd5184c611f795edddf6c5b2d))
+* modify IMemoryDB interface name ([fd1d440](https://github.com/expressots/expressots/commit/fd1d440eb947f377955bfc2a969d3e7ca4ffaa3e))
+
+
+### Bug Fixes
+
+* remove db in memory from template opinionated ([0516c8c](https://github.com/expressots/expressots/commit/0516c8c4e9c0e1a4b8aae3fab5842136a0565a39))
+
+
+### Tests
+
+* improve collocation and fix console tests ([52bdf98](https://github.com/expressots/expressots/commit/52bdf98cfcbbffc58841b1b67c6ce2a1f6fe308b))
+
 ## [2.6.0](https://github.com/expressots/expressots/compare/2.5.0...2.6.0) (2023-10-09)
 
 

package/lib/cjs/middleware/index.js

@@ -23,7 +23,10 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IMorgan = exports.Middleware = void 0;
+exports.IMorgan = exports.multer = exports.ExpressoMiddleware = exports.Middleware = void 0;
 var middleware_service_1 = require("./middleware-service");
 Object.defineProperty(exports, "Middleware", { enumerable: true, get: function () { return middleware_service_1.Middleware; } });
+Object.defineProperty(exports, "ExpressoMiddleware", { enumerable: true, get: function () { return middleware_service_1.ExpressoMiddleware; } });
+var multer_interface_1 = require("./interfaces/multer.interface");
+Object.defineProperty(exports, "multer", { enumerable: true, get: function () { return multer_interface_1.multer; } });
 exports.IMorgan = __importStar(require("./interfaces/morgan.interface"));

package/lib/cjs/middleware/interfaces/multer.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/middleware/middleware-resolver.js

@@ -26,6 +26,7 @@ class MiddlewareResolver {
         morgan: "morgan",
         helmet: "helmet",
         rateLimit: "express-rate-limit",
+        multer: "multer",
         session: "express-session",
         // Add other middlewares
     };

package/lib/cjs/middleware/middleware-service.js

@@ -8,14 +8,42 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var Middleware_1;
+var ExpressoMiddleware_1, Middleware_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Middleware = void 0;
+exports.Middleware = exports.ExpressoMiddleware = void 0;
 const express_1 = __importDefault(require("express"));
 const index_1 = require("../decorator/index");
 const error_handler_middleware_1 = __importDefault(require("../error/error-handler-middleware"));
 const logger_service_1 = require("../provider/logger/logger-service");
 const middleware_resolver_1 = require("./middleware-resolver");
+const inversify_binding_decorators_1 = require("inversify-binding-decorators");
+/**
+ * Abstract class for creating custom Expresso middleware.
+ * Custom middleware classes should extend this class and implement the use method.
+ *
+ */
+let ExpressoMiddleware = exports.ExpressoMiddleware = ExpressoMiddleware_1 = class ExpressoMiddleware {
+    get name() {
+        return this.constructor.name;
+    }
+};
+exports.ExpressoMiddleware = ExpressoMiddleware = ExpressoMiddleware_1 = __decorate([
+    (0, inversify_binding_decorators_1.provide)(ExpressoMiddleware_1)
+], ExpressoMiddleware);
+/**
+ * MiddlewareType Enum
+ *
+ * The MiddlewareType enum represents the various types of middleware that can be added to the middleware collection.
+ * - Config: Middleware configuration object.
+ * - ExpressHandler: Express request handler function.
+ * - IExpressoMiddleware: Custom Expresso middleware.
+ */
+var MiddlewareType;
+(function (MiddlewareType) {
+    MiddlewareType[MiddlewareType["Config"] = 0] = "Config";
+    MiddlewareType[MiddlewareType["ExpressHandler"] = 1] = "ExpressHandler";
+    MiddlewareType[MiddlewareType["IExpressoMiddleware"] = 2] = "IExpressoMiddleware";
+})(MiddlewareType || (MiddlewareType = {}));
 /**
  * Singleton class that implements the IConfigure interface.
  * Manages the middleware configuration for the application,
@@ -27,6 +55,25 @@ let Middleware = Middleware_1 = class Middleware {
     middlewarePipeline = [];
     errorHandler;
     logger = new logger_service_1.Logger();
+    /**
+     * Retrieves the type of the middleware.
+     *
+     * @param middleware - The middleware to be checked.
+     *
+     * @returns The type of the middleware.
+     */
+    getMiddlewareType(middleware) {
+        // eslint-disable-next-line no-prototype-builtins
+        if (middleware?.hasOwnProperty("path")) {
+            return MiddlewareType.Config;
+        }
+        else if (middleware instanceof Function) {
+            return MiddlewareType.ExpressHandler;
+        }
+        else {
+            return MiddlewareType.IExpressoMiddleware;
+        }
+    }
     /**
      * Checks if a middleware with the given name exists in the middleware collection.
      *
@@ -35,10 +82,15 @@ let Middleware = Middleware_1 = class Middleware {
      * @returns A boolean value indicating whether the middleware exists or not.
      */
     middlewareExists(middlewareName) {
-        const middlewareIndex = this.middlewarePipeline.findIndex((m) => typeof m.middleware === "object"
-            ? m.middleware.middlewares.some((mw) => mw?.name === middlewareName)
-            : m.middleware?.name === middlewareName);
-        return middlewareIndex !== -1;
+        return this.middlewarePipeline.some((m) => {
+            if (m.middleware instanceof Function) {
+                return m.middleware.name === middlewareName;
+            }
+            else if (m.middleware instanceof Object) {
+                return m.middleware.path === middlewareName;
+            }
+            return false;
+        });
     }
     addRateLimiter(options) {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("rateLimit", options);
@@ -161,6 +213,14 @@ let Middleware = Middleware_1 = class Middleware {
             });
         }
     }
+    setupMulter(options) {
+        const multerMiddleware = (0, middleware_resolver_1.middlewareResolver)("multer", options);
+        const middlewareExist = this.middlewareExists("multer");
+        if (multerMiddleware && !middlewareExist) {
+            return multerMiddleware;
+        }
+        return null;
+    }
     /**
      * Adds a middleware to enhance security by setting various HTTP headers.
      *
@@ -226,55 +286,141 @@ let Middleware = Middleware_1 = class Middleware {
         }
     }
     /**
-     * Adds a middleware to the middleware collection.
-     *
-     * @param middleware - The Express request handler function to be added to the middleware collection.
-     *
+     * Helper method to add middleware configuration objects to the middleware collection.
+     * @param middleware - The middleware configuration object to be added to the middleware collection.
+     * @returns void
      */
-    addMiddleware(...middleware) {
-        let config;
-        if (typeof middleware[0] === "string") {
-            const [path, ...middlewares] = middleware;
-            config = {
-                path,
-                middlewares: middlewares,
-            };
+    addConfigMiddleware(middleware) {
+        // eslint-disable-next-line no-case-declarations
+        const config = middleware;
+        let routeExists = false;
+        if (config.middlewares.length === 0) {
+            this.logger.warn(`No middlewares in the route [${config.path}]. Skipping...`, "configure-service");
+            return;
         }
-        else {
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
-            config = {
-                middlewares: middleware,
-            };
+        if (this.middlewarePipeline.length === 0) {
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware: config,
+            });
         }
-        if (config.path) {
-            // verify if middleware if path already exists
-            const middlewareIndex = this.middlewarePipeline.findIndex((m) => typeof m.middleware === "object" && m.middleware.path === config.path);
-            if (middlewareIndex !== -1) {
-                this.logger.warn(`[${config.path}] route already exists. Skipping...`, "configure-service");
-            }
-            else {
+        else {
+            this.middlewarePipeline.forEach((m) => {
+                if (m.middleware.path === config.path) {
+                    this.logger.warn(`[${config.path}] route already exists. Skipping...`, "configure-service");
+                    routeExists = true;
+                }
+            });
+            if (!routeExists) {
                 this.middlewarePipeline.push({
                     timestamp: new Date(),
                     middleware: config,
                 });
             }
         }
-        else {
-            config.middlewares.forEach((m) => {
-                const middlewareName = m?.name || "anonymous";
-                const middlewareExist = this.middlewareExists(middlewareName);
-                if (middlewareExist) {
-                    this.logger.warn(`[${middlewareName}] already exists. Skipping...`, "configure-service");
+    }
+    /**
+     * Helper method to add express request handler functions to the middleware collection.
+     * @param middleware - The express request handler function to be added to the middleware collection.
+     * @returns void
+     */
+    addExpressHandlerMiddleware(middleware) {
+        let middlewareExists = false;
+        if (this.middlewarePipeline.length === 0) {
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
+            return;
+        }
+        this.middlewarePipeline.forEach((m) => {
+            const mType = this.getMiddlewareType(m.middleware);
+            if (mType === MiddlewareType.ExpressHandler) {
+                if (m.middleware?.name === middleware?.name) {
+                    this.logger.warn(`[${middleware?.name}] already exists. Skipping...`, "configure-service");
+                    middlewareExists = true;
+                    return;
                 }
-                else {
-                    this.middlewarePipeline.push({
-                        timestamp: new Date(),
-                        middleware: config,
-                    });
+            }
+        });
+        if (!middlewareExists) {
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
+        }
+    }
+    /**
+     * Helper method to add custom Expresso middleware to the middleware collection.
+     * @param middleware - The custom Expresso middleware to be added to the middleware collection.
+     * @returns void
+     */
+    addIExpressoMiddleware(middleware) {
+        let middlewareExists = false;
+        if (this.middlewarePipeline.length === 0) {
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
+            return;
+        }
+        this.middlewarePipeline.forEach((m) => {
+            const mType = this.getMiddlewareType(m.middleware);
+            if (mType === MiddlewareType.IExpressoMiddleware) {
+                if (m.middleware.constructor.name ===
+                    middleware.constructor.name) {
+                    this.logger.warn(`[${middleware.constructor.name}] already exists. Skipping...`, "configure-service");
+                    middlewareExists = true;
+                    return;
                 }
+            }
+        });
+        if (!middlewareExists) {
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
             });
         }
     }
+    /**
+     * Adds a middleware to the middleware collection.
+     *
+     * @param options - The Express request handler function to be added to the middleware collection, or a middleware configuration object
+     * that is composed by a route and an expressjs handler, or a custom Expresso middleware.
+     *
+     * @example Express Handler
+     *  const middleware = (req, res, next) => {
+     *    // Your middleware logic here
+     *    next();
+     *  }
+     *
+     * @example Middleware Configuration Object
+     *  const middleware = {
+     *    path: "/",
+     *    middlewares: [] // Array of Express Handlers
+     *  }
+     *
+     * @example Expresso Middleware
+     *  class CustomMiddleware implements IExpressoMiddleware {
+     *    use(req: Request, res: Response, next: NextFunction): Promise<void> | void {
+     *    // Your middleware logic here
+     *      next();
+     *    }
+     *  }
+     */
+    addMiddleware(options) {
+        switch (this.getMiddlewareType(options)) {
+            case MiddlewareType.Config:
+                this.addConfigMiddleware(options);
+                break;
+            case MiddlewareType.ExpressHandler:
+                this.addExpressHandlerMiddleware(options);
+                break;
+            case MiddlewareType.IExpressoMiddleware:
+                this.addIExpressoMiddleware(options);
+                break;
+        }
+    }
     /**
      * Retrieves middleware pipeline in the order they were added.
      *
@@ -285,6 +431,39 @@ let Middleware = Middleware_1 = class Middleware {
             return a.timestamp.getTime() - b.timestamp.getTime();
         });
     }
+    /**
+     * View middleware pipeline formatted.
+     * @returns void
+     */
+    viewMiddlewarePipeline() {
+        const sortedMiddlewarePipeline = this.getMiddlewarePipeline();
+        const formattedPipeline = sortedMiddlewarePipeline.map((m) => {
+            const middlewareType = this.getMiddlewareType(m.middleware);
+            if (middlewareType === MiddlewareType.Config) {
+                const middlewareNames = m.middleware.middlewares.map((mw) => mw?.name || "Anonymous");
+                return {
+                    timestamp: m.timestamp.toISOString(),
+                    path: m.middleware.path,
+                    middleware: `[${middlewareNames.join(", ")}]`,
+                };
+            }
+            else if (middlewareType === MiddlewareType.IExpressoMiddleware) {
+                return {
+                    timestamp: m.timestamp.toISOString(),
+                    path: m.middleware.path ?? "Global",
+                    middleware: m.middleware.constructor.name,
+                };
+            }
+            else {
+                return {
+                    timestamp: m.timestamp.toISOString(),
+                    path: "Global",
+                    middleware: m.middleware?.name,
+                };
+            }
+        });
+        console.table(formattedPipeline);
+    }
     /**
      * Gets the configured error handler middleware.
      *

package/lib/cjs/provider/db-in-memory/db-in-memory.provider.js

@@ -0,0 +1,75 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var InMemoryDB_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryDB = void 0;
+const decorator_1 = require("../../decorator");
+/**
+ * InMemoryDB Class
+ *
+ * This class and its methods offer functionalities to simulate an in-memory database.
+ * It is particularly useful for developers starting with ExpressoTS without any database connection.
+ *
+ * @decorator @provideSingleton(InMemoryDB)
+ */
+let InMemoryDB = exports.InMemoryDB = InMemoryDB_1 = class InMemoryDB {
+    tables = {};
+    /**
+     * getTable Method
+     *
+     * Retrieves a table by its name from the in-memory database.
+     *
+     * @param tableName - The name of the table to retrieve.
+     * @returns {IEntity[]} - An array of entities.
+     */
+    getTable(tableName) {
+        if (!this.tables[tableName]) {
+            this.tables[tableName] = [];
+        }
+        return this.tables[tableName];
+    }
+    /**
+     * showTables Method
+     *
+     * Prints a list of all tables in the in-memory database to the standard output.
+     */
+    showTables() {
+        if (!this.tables) {
+            process.stdout.write("No tables exist.");
+            return;
+        }
+        process.stdout.write("List of tables:");
+        for (const tableName in this.tables) {
+            process.stdout.write(`\n- ${tableName}`);
+        }
+    }
+    /**
+     * printTable Method
+     *
+     * Prints all records in a specific table to the console.
+     * If the table doesn't exist or is empty, it notifies the user.
+     *
+     * @param tableName - The name of the table to print.
+     */
+    printTable(tableName) {
+        if (!this.tables) {
+            process.stdout.write("No tables exist.");
+            return;
+        }
+        const table = this.getTable(tableName);
+        if (table.length === 0) {
+            process.stdout.write(`Table '${tableName}' is empty.`);
+            return;
+        }
+        process.stdout.write(`\nRecords in table '${tableName}':\n`);
+        console.table(table);
+    }
+};
+exports.InMemoryDB = InMemoryDB = InMemoryDB_1 = __decorate([
+    (0, decorator_1.provideSingleton)(InMemoryDB_1)
+], InMemoryDB);

package/lib/cjs/provider/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidateDTO = exports.Env = exports.Logger = exports.Provider = void 0;
+exports.InMemoryDB = exports.ValidateDTO = exports.Env = exports.Logger = exports.Provider = void 0;
 var provider_service_1 = require("./provider-service");
 Object.defineProperty(exports, "Provider", { enumerable: true, get: function () { return provider_service_1.Provider; } });
 var logger_service_1 = require("./logger/logger-service");
@@ -9,3 +9,5 @@ var env_validator_provider_1 = require("./environment/env-validator.provider");
 Object.defineProperty(exports, "Env", { enumerable: true, get: function () { return env_validator_provider_1.EnvValidatorProvider; } });
 var dto_validator_provider_1 = require("./dto-validator/dto-validator.provider");
 Object.defineProperty(exports, "ValidateDTO", { enumerable: true, get: function () { return dto_validator_provider_1.ValidateDTO; } });
+var db_in_memory_provider_1 = require("./db-in-memory/db-in-memory.provider");
+Object.defineProperty(exports, "InMemoryDB", { enumerable: true, get: function () { return db_in_memory_provider_1.InMemoryDB; } });

package/lib/cjs/types/middleware/index.d.ts

@@ -1,4 +1,4 @@
-export { IMiddleware, Middleware } from "./middleware-service";
+export { IMiddleware, Middleware, ExpressHandler, ExpressoMiddleware, MiddlewareOptions, } from "./middleware-service";
 export { OptionsJson } from "./interfaces/body-parser.interface";
 export { CorsOptions } from "./interfaces/cors.interface";
 export { CompressionOptions } from "./interfaces/compression.interface";
@@ -9,4 +9,5 @@ export { Keygrip } from "./interfaces/cookie-session/keygrip.interface";
 export { CookieParserOptions } from "./interfaces/cookie-parser.interface";
 export { ServeFaviconOptions } from "./interfaces/serve-favicon.interface";
 export { RateLimitOptions } from "./interfaces/express-rate-limit.interface";
+export { multer } from "./interfaces/multer.interface";
 export * as IMorgan from "./interfaces/morgan.interface";

package/lib/cjs/types/middleware/interfaces/express-session.interface.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="express-serve-static-core" />
 import { Request } from "express";
 interface SessionData {
     cookie: Cookie;

package/lib/cjs/types/middleware/interfaces/multer.interface.d.ts

@@ -0,0 +1,255 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { RequestHandler } from "express";
+import { Readable } from "stream";
+declare global {
+    namespace Express {
+        namespace Multer {
+            /** Object containing file metadata and access information. */
+            interface File {
+                /** Name of the form field associated with this file. */
+                fieldname: string;
+                /** Name of the file on the uploader's computer. */
+                originalname: string;
+                /**
+                 * Value of the `Content-Transfer-Encoding` header for this file.
+                 * @deprecated since July 2015
+                 * @see RFC 7578, Section 4.7
+                 */
+                encoding: string;
+                /** Value of the `Content-Type` header for this file. */
+                mimetype: string;
+                /** Size of the file in bytes. */
+                size: number;
+                /**
+                 * A readable stream of this file. Only available to the `_handleFile`
+                 * callback for custom `StorageEngine`s.
+                 */
+                stream: Readable;
+                /** `DiskStorage` only: Directory to which this file has been uploaded. */
+                destination: string;
+                /** `DiskStorage` only: Name of this file within `destination`. */
+                filename: string;
+                /** `DiskStorage` only: Full path to the uploaded file. */
+                path: string;
+                /** `MemoryStorage` only: A Buffer containing the entire file. */
+                buffer: Buffer;
+            }
+        }
+        interface Request {
+            /** `Multer.File` object populated by `single()` middleware. */
+            file?: Multer.File | undefined;
+            /**
+             * Array or dictionary of `Multer.File` object populated by `array()`,
+             * `fields()`, and `any()` middleware.
+             */
+            files?: {
+                [fieldname: string]: Multer.File[];
+            } | Multer.File[] | undefined;
+        }
+    }
+}
+export declare namespace multer {
+    /**
+     * @see {@link https://github.com/expressjs/multer#api}
+     */
+    interface Multer {
+        /**
+         * Returns middleware that processes a single file associated with the
+         * given form field.
+         *
+         * The `Request` object will be populated with a `file` object containing
+         * information about the processed file.
+         *
+         * @param fieldName Name of the multipart form field to process.
+         */
+        single(fieldName: string): RequestHandler;
+        /**
+         * Returns middleware that processes multiple files sharing the same field
+         * name.
+         *
+         * The `Request` object will be populated with a `files` array containing
+         * an information object for each processed file.
+         *
+         * @param fieldName Shared name of the multipart form fields to process.
+         * @param maxCount Optional. Maximum number of files to process. (default: Infinity)
+         * @throws `MulterError('LIMIT_UNEXPECTED_FILE')` if more than `maxCount` files are associated with `fieldName`
+         */
+        array(fieldName: string, maxCount?: number): RequestHandler;
+        /**
+         * Returns middleware that processes multiple files associated with the
+         * given form fields.
+         *
+         * The `Request` object will be populated with a `files` object which
+         * maps each field name to an array of the associated file information
+         * objects.
+         *
+         * @param fields Array of `Field` objects describing multipart form fields to process.
+         * @throws `MulterError('LIMIT_UNEXPECTED_FILE')` if more than `maxCount` files are associated with `fieldName` for any field.
+         */
+        fields(fields: ReadonlyArray<Field>): RequestHandler;
+        /**
+         * Returns middleware that processes all files contained in the multipart
+         * request.
+         *
+         * The `Request` object will be populated with a `files` array containing
+         * an information object for each processed file.
+         */
+        any(): RequestHandler;
+        /**
+         * Returns middleware that accepts only non-file multipart form fields.
+         *
+         * @throws `MulterError('LIMIT_UNEXPECTED_FILE')` if any file is encountered.
+         */
+        none(): RequestHandler;
+    }
+    /**
+     * Returns a `StorageEngine` implementation configured to store files on
+     * the local file system.
+     *
+     * A string or function may be specified to determine the destination
+     * directory, and a function to determine filenames. If no options are set,
+     * files will be stored in the system's temporary directory with random 32
+     * character filenames.
+     */
+    function diskStorage(options: DiskStorageOptions): StorageEngine;
+    /**
+     * Returns a `StorageEngine` implementation configured to store files in
+     * memory as `Buffer` objects.
+     */
+    function memoryStorage(): StorageEngine;
+    type ErrorCode = "LIMIT_PART_COUNT" | "LIMIT_FILE_SIZE" | "LIMIT_FILE_COUNT" | "LIMIT_FIELD_KEY" | "LIMIT_FIELD_VALUE" | "LIMIT_FIELD_COUNT" | "LIMIT_UNEXPECTED_FILE";
+    class MulterError extends Error {
+        constructor(code: ErrorCode, field?: string);
+        /** Name of the MulterError constructor. */
+        name: string;
+        /** Identifying error code. */
+        code: ErrorCode;
+        /** Descriptive error message. */
+        message: string;
+        /** Name of the multipart form field associated with this error. */
+        field?: string | undefined;
+    }
+    /**
+     * a function to control which files should be uploaded and which should be skipped
+     * pass a boolean to indicate if the file should be accepted
+     * pass an error if something goes wrong
+     */
+    interface FileFilterCallback {
+        (error: Error): void;
+        (error: null, acceptFile: boolean): void;
+    }
+    /** Options for initializing a Multer instance. */
+    interface Options {
+        /**
+         * A `StorageEngine` responsible for processing files uploaded via Multer.
+         * Takes precedence over `dest`.
+         */
+        storage?: StorageEngine | undefined;
+        /**
+         * The destination directory for uploaded files. If `storage` is not set
+         * and `dest` is, Multer will create a `DiskStorage` instance configured
+         * to store files at `dest` with random filenames.
+         *
+         * Ignored if `storage` is set.
+         */
+        dest?: string | undefined;
+        /**
+         * An object specifying various limits on incoming data. This object is
+         * passed to Busboy directly, and the details of properties can be found
+         * at https://github.com/mscdex/busboy#busboy-methods.
+         */
+        limits?: {
+            /** Maximum size of each form field name in bytes. (Default: 100) */
+            fieldNameSize?: number | undefined;
+            /** Maximum size of each form field value in bytes. (Default: 1048576) */
+            fieldSize?: number | undefined;
+            /** Maximum number of non-file form fields. (Default: Infinity) */
+            fields?: number | undefined;
+            /** Maximum size of each file in bytes. (Default: Infinity) */
+            fileSize?: number | undefined;
+            /** Maximum number of file fields. (Default: Infinity) */
+            files?: number | undefined;
+            /** Maximum number of parts (non-file fields + files). (Default: Infinity) */
+            parts?: number | undefined;
+            /** Maximum number of headers. (Default: 2000) */
+            headerPairs?: number | undefined;
+        } | undefined;
+        /** Preserve the full path of the original filename rather than the basename. (Default: false) */
+        preservePath?: boolean | undefined;
+        /**
+         * Optional function to control which files are uploaded. This is called
+         * for every file that is processed.
+         *
+         * @param req The Express `Request` object.
+         * @param file Object containing information about the processed file.
+         * @param callback  a function to control which files should be uploaded and which should be skipped.
+         */
+        fileFilter?(req: Request, file: File, callback: FileFilterCallback): void;
+    }
+    /**
+     * Implementations of this interface are responsible for storing files
+     * encountered by Multer and returning information on how to access them
+     * once stored. Implementations must also provide a method for removing
+     * files in the event that an error occurs.
+     */
+    interface StorageEngine {
+        /**
+         * Store the file described by `file`, then invoke the callback with
+         * information about the stored file.
+         *
+         * File contents are available as a stream via `file.stream`. Information
+         * passed to the callback will be merged with `file` for subsequent
+         * middleware.
+         *
+         * @param req The Express `Request` object.
+         * @param file Object with `stream`, `fieldname`, `originalname`, `encoding`, and `mimetype` defined.
+         * @param callback Callback to specify file information.
+         */
+        _handleFile(req: Request, file: File, callback: (error?: any, info?: Partial<File>) => void): void;
+        /**
+         * Remove the file described by `file`, then invoke the callback with.
+         *
+         * `file` contains all the properties available to `_handleFile`, as
+         * well as those returned by `_handleFile`.
+         *
+         * @param req The Express `Request` object.
+         * @param file Object containing information about the processed file.
+         * @param callback Callback to indicate completion.
+         */
+        _removeFile(req: Request, file: Express.Multer.File, callback: (error: Error | null) => void): void;
+    }
+    interface DiskStorageOptions {
+        /**
+         * A string or function that determines the destination path for uploaded
+         * files. If a string is passed and the directory does not exist, Multer
+         * attempts to create it recursively. If neither a string or a function
+         * is passed, the destination defaults to `os.tmpdir()`.
+         *
+         * @param req The Express `Request` object.
+         * @param file Object containing information about the processed file.
+         * @param callback Callback to determine the destination path.
+         */
+        destination?: string | ((req: Request, file: Express.Multer.File, callback: (error: Error | null, destination: string) => void) => void) | undefined;
+        /**
+         * A function that determines the name of the uploaded file. If nothing
+         * is passed, Multer will generate a 32 character pseudorandom hex string
+         * with no extension.
+         *
+         * @param req The Express `Request` object.
+         * @param file Object containing information about the processed file.
+         * @param callback Callback to determine the name of the uploaded file.
+         */
+        filename?(req: Request, file: Express.Multer.File, callback: (error: Error | null, filename: string) => void): void;
+    }
+    /**
+     * An object describing a field name and the maximum number of files with
+     * that field name to accept.
+     */
+    interface Field {
+        /** The field name. */
+        name: string;
+        /** Optional maximum number of files per field to accept. (Default: Infinity) */
+        maxCount?: number | undefined;
+    }
+}

package/lib/cjs/types/middleware/middleware-resolver.d.ts

@@ -1,4 +1,4 @@
-import express from "express";
+import { ExpressHandler } from "./middleware-service";
 /**
  * A utility function that wraps the creation and retrieval of middleware.
  * It creates a new instance of MiddlewareResolver and calls the getMiddleware method.
@@ -7,5 +7,5 @@ import express from "express";
  * @param {...any} options - Optional arguments to configure the middleware.
  * @returns {express.RequestHandler | null} - Returns the configured middleware or null if not found or not installed.
  */
-declare function middlewareResolver(middleware: string, ...options: any): express.RequestHandler | null;
+declare function middlewareResolver(middleware: string, ...options: any): ExpressHandler | null;
 export { middlewareResolver };

package/lib/cjs/types/middleware/middleware-service.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import express from "express";
+import express, { Request, Response, NextFunction } from "express";
 import { OptionsJson } from "./interfaces/body-parser.interface";
 import { CompressionOptions } from "./interfaces/compression.interface";
 import { CorsOptions } from "./interfaces/cors.interface";
@@ -10,6 +10,7 @@ import { ServeFaviconOptions } from "./interfaces/serve-favicon.interface";
 import { FormatFn, OptionsMorgan } from "./interfaces/morgan.interface";
 import { RateLimitOptions } from "./interfaces/express-rate-limit.interface";
 import { OptionsHelmet } from "./interfaces/helmet.interface";
+import { multer } from "./interfaces/multer.interface";
 import { SessionOptions } from "./interfaces/express-session.interface";
 /**
  * ExpressHandler Type
@@ -21,14 +22,29 @@ import { SessionOptions } from "./interfaces/express-session.interface";
  * - express.RequestHandler: General request handler.
  * - undefined: Represents the absence of a handler.
  */
-type ExpressHandler = express.ErrorRequestHandler | express.RequestParamHandler | express.RequestHandler | undefined;
+export type ExpressHandler = express.ErrorRequestHandler | express.RequestParamHandler | express.RequestHandler | undefined;
 /**
- * MiddlewareArgs Type
+ * Expresso middleware interface.
+ */
+interface IExpressoMiddleware {
+    use(req: Request, res: Response, next: NextFunction): Promise<void> | void;
+}
+/**
+ * Abstract class for creating custom Expresso middleware.
+ * Custom middleware classes should extend this class and implement the use method.
+ *
+ */
+export declare abstract class ExpressoMiddleware implements IExpressoMiddleware {
+    get name(): string;
+    abstract use(req: Request, res: Response, next: NextFunction): Promise<void> | void;
+}
+/**
+ * MiddlewareOptions Type
  *
- * The MiddlewareArgs type represents arguments that can be passed to a middleware function.
- * It can either be a string (a route or path) or an instance of ExpressHandler.
+ * The MiddlewareOptions type represents arguments that can be passed to a middleware function.
+ * It can either be a expressjs request handler function, a middleware configuration object that is composed by a route and an expressjs handler or
  */
-type MiddlewareArgs = string | ExpressHandler;
+export type MiddlewareOptions = ExpressHandler | MiddlewareConfig | IExpressoMiddleware;
 /**
  * MiddlewareConfig Interface
  *
@@ -38,7 +54,7 @@ type MiddlewareArgs = string | ExpressHandler;
  */
 type MiddlewareConfig = {
     path?: string;
-    middlewares: Array<ExpressHandler>;
+    middlewares: Array<ExpressHandler | IExpressoMiddleware>;
 };
 /**
  * MiddlewarePipeline Interface
@@ -49,7 +65,7 @@ type MiddlewareConfig = {
  */
 interface MiddlewarePipeline {
     timestamp: Date;
-    middleware: ExpressHandler | MiddlewareConfig;
+    middleware: ExpressHandler | MiddlewareConfig | IExpressoMiddleware;
 }
 /**
  * Interface for configuring and managing middlewares in the application.
@@ -134,16 +150,35 @@ interface IMiddleware {
     /**
      * Adds a middleware to the middleware collection.
      *
-     * @param middleware - The Express request handler function to be added to the middleware collection.
-     *
+     * @param options - The Express request handler function to be added to the middleware collection, or a middleware configuration object
+     * that is composed by a route and an expressjs handler, or a custom Expresso middleware.
+     *
+     * @example Express Handler
+     *  const middleware = (req, res, next) => {
+     *  // Your middleware logic here
+     *  next();
+     * }
+     *
+     * @example Middleware Configuration Object
+     * const middleware = {
+     *  path: "/",
+     *  middlewares: [] // Array of Express Handlers
+     * }
+     *
+     * @example Expresso Middleware
+     * class CustomMiddleware implements IExpressoMiddleware {
+     *  use(req: Request, res: Response, next: NextFunction): Promise<void> | void {
+     *   // Your middleware logic here
+     *   next();
+     *  }
+     * }
      */
-    addMiddleware(...middleware: Array<MiddlewareArgs>): void;
+    addMiddleware(options: MiddlewareOptions): void;
     /**
-     * Retrieves middleware pipeline in the order they were added.
-     *
-     * @returns An array of Express request handlers representing the middlewares.
+     * View middleware pipeline formatted.
+     * @returns void
      */
-    getMiddlewarePipeline(): Array<MiddlewarePipeline>;
+    viewMiddlewarePipeline(): void;
     /**
      * Gets the configured error handler middleware.
      *
@@ -157,6 +192,12 @@ interface IMiddleware {
      * @returns The configuration options for Helmet middleware.
      */
     addHelmet(options?: OptionsHelmet): void;
+    /**
+     * Adds Multer middleware for handling multipart/form-data, typically used for file uploads.
+     *
+     * @param options - Optional configuration options for Multer.
+     */
+    setupMulter(options?: multer.Options): multer.Multer;
 }
 /**
  * Singleton class that implements the IConfigure interface.
@@ -169,6 +210,14 @@ declare class Middleware implements IMiddleware {
     private middlewarePipeline;
     private errorHandler;
     private logger;
+    /**
+     * Retrieves the type of the middleware.
+     *
+     * @param middleware - The middleware to be checked.
+     *
+     * @returns The type of the middleware.
+     */
+    private getMiddlewareType;
     /**
      * Checks if a middleware with the given name exists in the middleware collection.
      *
@@ -224,6 +273,7 @@ declare class Middleware implements IMiddleware {
      * @param options - Optional configuration options for serving the favicon. Defines the behavior of the favicon middleware like cache control, custom headers, etc.
      */
     addServeFavicon(path: string | Buffer, options?: ServeFaviconOptions): void;
+    setupMulter(options?: multer.Options): multer.Multer;
     /**
      * Adds a middleware to enhance security by setting various HTTP headers.
      *
@@ -252,19 +302,62 @@ declare class Middleware implements IMiddleware {
      * @param options - Optional configuration options for serving static files. Defines behavior like cache control, custom headers, etc.
      */
     serveStatic(root: string, options?: ServeStaticOptions): void;
+    /**
+     * Helper method to add middleware configuration objects to the middleware collection.
+     * @param middleware - The middleware configuration object to be added to the middleware collection.
+     * @returns void
+     */
+    private addConfigMiddleware;
+    /**
+     * Helper method to add express request handler functions to the middleware collection.
+     * @param middleware - The express request handler function to be added to the middleware collection.
+     * @returns void
+     */
+    private addExpressHandlerMiddleware;
+    /**
+     * Helper method to add custom Expresso middleware to the middleware collection.
+     * @param middleware - The custom Expresso middleware to be added to the middleware collection.
+     * @returns void
+     */
+    private addIExpressoMiddleware;
     /**
      * Adds a middleware to the middleware collection.
      *
-     * @param middleware - The Express request handler function to be added to the middleware collection.
-     *
+     * @param options - The Express request handler function to be added to the middleware collection, or a middleware configuration object
+     * that is composed by a route and an expressjs handler, or a custom Expresso middleware.
+     *
+     * @example Express Handler
+     *  const middleware = (req, res, next) => {
+     *    // Your middleware logic here
+     *    next();
+     *  }
+     *
+     * @example Middleware Configuration Object
+     *  const middleware = {
+     *    path: "/",
+     *    middlewares: [] // Array of Express Handlers
+     *  }
+     *
+     * @example Expresso Middleware
+     *  class CustomMiddleware implements IExpressoMiddleware {
+     *    use(req: Request, res: Response, next: NextFunction): Promise<void> | void {
+     *    // Your middleware logic here
+     *      next();
+     *    }
+     *  }
      */
-    addMiddleware(...middleware: Array<MiddlewareArgs>): void;
+    addMiddleware(options: MiddlewareOptions): void;
     /**
      * Retrieves middleware pipeline in the order they were added.
      *
      * @returns An array of Express request handlers representing the middlewares.
      */
     getMiddlewarePipeline(): Array<MiddlewarePipeline>;
+    /**
+     * View middleware pipeline formatted.
+     * @returns void
+     */
+    viewMiddlewarePipeline(): void;
     /**
      * Gets the configured error handler middleware.
      *

package/lib/cjs/types/provider/db-in-memory/db-in-memory.provider.d.ts

@@ -0,0 +1,38 @@
+export interface IMemoryDBEntity {
+    id: string;
+}
+/**
+ * InMemoryDB Class
+ *
+ * This class and its methods offer functionalities to simulate an in-memory database.
+ * It is particularly useful for developers starting with ExpressoTS without any database connection.
+ *
+ * @decorator @provideSingleton(InMemoryDB)
+ */
+export declare class InMemoryDB {
+    private tables;
+    /**
+     * getTable Method
+     *
+     * Retrieves a table by its name from the in-memory database.
+     *
+     * @param tableName - The name of the table to retrieve.
+     * @returns {IEntity[]} - An array of entities.
+     */
+    getTable(tableName: string): Array<IMemoryDBEntity>;
+    /**
+     * showTables Method
+     *
+     * Prints a list of all tables in the in-memory database to the standard output.
+     */
+    showTables(): void;
+    /**
+     * printTable Method
+     *
+     * Prints all records in a specific table to the console.
+     * If the table doesn't exist or is empty, it notifies the user.
+     *
+     * @param tableName - The name of the table to print.
+     */
+    printTable(tableName: string): void;
+}

package/lib/cjs/types/provider/index.d.ts

@@ -2,3 +2,4 @@ export { Provider, IProvider } from "./provider-service";
 export { Logger } from "./logger/logger-service";
 export { EnvValidatorProvider as Env } from "./environment/env-validator.provider";
 export { ValidateDTO } from "./dto-validator/dto-validator.provider";
+export { InMemoryDB, IMemoryDBEntity, } from "./db-in-memory/db-in-memory.provider";

package/lib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/core",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@core)",
   "author": "Richard Zampieri",
   "main": "./lib/cjs/index.js",
@@ -69,11 +69,11 @@
   "dependencies": {
     "inversify": "^6.0.1",
     "inversify-binding-decorators": "^4.0.0",
-    "reflect-metadata": "^0.1.13"
+    "reflect-metadata": "^0.2.1"
   },
   "devDependencies": {
-    "@commitlint/cli": "^17.7.1",
-    "@commitlint/config-conventional": "^17.7.0",
+    "@commitlint/cli": "^18.0.0",
+    "@commitlint/config-conventional": "^18.0.0",
     "@expressots/adapter-express": "latest",
     "@release-it/conventional-changelog": "^7.0.1",
     "@types/express": "^4.17.17",
@@ -83,12 +83,12 @@
     "@vitest/coverage-v8": "^0.34.6",
     "eslint": "^8.48.0",
     "eslint-config-prettier": "^9.0.0",
-    "husky": "^8.0.3",
-    "prettier": "3.0.3",
+    "husky": "^9.0.11",
+    "prettier": "3.2.5",
     "release-it": "^16.1.5",
     "ts-jest": "^29.0.5",
     "typescript": "^5.0.3",
-    "vite": "4.4.11",
+    "vite": "4.5.0",
     "vitest": "0.34.6"
   },
   "release-it": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/core",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@core)",
   "author": "Richard Zampieri",
   "main": "./lib/cjs/index.js",
@@ -69,11 +69,11 @@
   "dependencies": {
     "inversify": "^6.0.1",
     "inversify-binding-decorators": "^4.0.0",
-    "reflect-metadata": "^0.1.13"
+    "reflect-metadata": "^0.2.1"
   },
   "devDependencies": {
-    "@commitlint/cli": "^17.7.1",
-    "@commitlint/config-conventional": "^17.7.0",
+    "@commitlint/cli": "^18.0.0",
+    "@commitlint/config-conventional": "^18.0.0",
     "@expressots/adapter-express": "latest",
     "@release-it/conventional-changelog": "^7.0.1",
     "@types/express": "^4.17.17",
@@ -83,12 +83,12 @@
     "@vitest/coverage-v8": "^0.34.6",
     "eslint": "^8.48.0",
     "eslint-config-prettier": "^9.0.0",
-    "husky": "^8.0.3",
-    "prettier": "3.0.3",
+    "husky": "^9.0.11",
+    "prettier": "3.2.5",
     "release-it": "^16.1.5",
     "ts-jest": "^29.0.5",
     "typescript": "^5.0.3",
-    "vite": "4.4.11",
+    "vite": "4.5.0",
     "vitest": "0.34.6"
   },
   "release-it": {