@expressots/core 2.1.0 → 2.2.0

package/lib/CHANGELOG.md

@@ -1,18 +1,43 @@
 
 
-## [2.1.0](https://github.com/expressots/expressots/compare/2.0.0...2.1.0) (2023-09-16)
+## [2.2.0](https://github.com/expressots/expressots/compare/2.1.0...2.2.0) (2023-09-21)
 
 
 ### Features
 
-* add cookie-parser middleware ([2fe9377](https://github.com/expressots/expressots/commit/2fe93776423355503211a0d96f2b1952e3bc6320))
-* add cookie-parser middleware ([a53a0c2](https://github.com/expressots/expressots/commit/a53a0c2e23dafc188286cd0ff5a6145cf3416ad0))
-* add cookie-session middleware ([323c2d3](https://github.com/expressots/expressots/commit/323c2d32c5e4a9c78f19fe47807f323139fb306a))
-* add cookie-session middleware ([60ac1fa](https://github.com/expressots/expressots/commit/60ac1fa36b2a8388983be0ab8f2d8a1696089d78))
+* add middleware based routing ([3d7720e](https://github.com/expressots/expressots/commit/3d7720e21807117333d60e7f2b7bb01789b96060))
+* add serve-favicon middleware ([024bdc4](https://github.com/expressots/expressots/commit/024bdc4d8d4f9890175975d052ca09c5b4e245cf))
+* add serve-favicon middleware ([0733697](https://github.com/expressots/expressots/commit/0733697ed66a7133e60ec6fa09bdaeb0bf1985d7))
 
 
 ### Bug Fixes
 
+* add chore message to pre-commit hook ([45ae428](https://github.com/expressots/expressots/commit/45ae428652bb6e4f49cb2a6334686be0dee3669d))
+* add middleware validation based on path ([7035153](https://github.com/expressots/expressots/commit/7035153dededd3ca7c5159544f4ab79baee2c4d7))
+* re-write cp, mv and rm improving performance ([68d68ad](https://github.com/expressots/expressots/commit/68d68ad11385ca783fa5c51e3092937a6f898ac6))
+* update contribute_howto doc ([4bf6e12](https://github.com/expressots/expressots/commit/4bf6e121091e894a7675ff78959ab4647ec04f6d))
+* update contribute_howto doc ([fbbe47d](https://github.com/expressots/expressots/commit/fbbe47d6df76211fadd736fab864aa41e0313ec9))
+* update templates for v2 scaffold ([74811f3](https://github.com/expressots/expressots/commit/74811f3ac54610be7367de75f37363dc0c107dbc))
+
+
+### Build System
+
+* **scripts:** add cross platform build scripts ([e6cecbc](https://github.com/expressots/expressots/commit/e6cecbc6b7a309f00aa6cd60f6d8207dc8d4c5cb))
+* **scripts:** add cross platform build scripts ([8b5c133](https://github.com/expressots/expressots/commit/8b5c133e4e28d67b8a7edca5b04bfe04a6d12540))
+
+## [2.1.0](https://github.com/expressots/expressots/compare/2.0.0...2.1.0) (2023-09-16)
+
+
+### Features
+
+* add cookie-parser middleware ([2fe9377](https://github.com/expressots/expressots/commit/2fe93776423355503211a0d96f2b1952e3bc6320))
+* add cookie-parser middleware ([a53a0c2](https://github.com/expressots/expressots/commit/a53a0c2e23dafc188286cd0ff5a6145cf3416ad0))
+* add cookie-session middleware ([323c2d3](https://github.com/expressots/expressots/commit/323c2d32c5e4a9c78f19fe47807f323139fb306a))
+* add cookie-session middleware ([60ac1fa](https://github.com/expressots/expressots/commit/60ac1fa36b2a8388983be0ab8f2d8a1696089d78))
+
+
+### Bug Fixes
+
 * create folder for interface and print pck name instead of curated name ([2a47508](https://github.com/expressots/expressots/commit/2a47508f5170950ddd8b471fffc8d43a8fb57e32))
 
 ## [2.0.0](https://github.com/expressots/expressots/compare/1.9.1...2.0.0) (2023-09-14)

package/lib/cjs/middleware/interfaces/serve-favicon.interface.js

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

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

@@ -19,6 +19,7 @@ class MiddlewareResolver {
             compression: "compression",
             cookieParser: "cookie-parser",
             cookieSession: "cookie-session",
+            serveFavicon: "serve-favicon",
             // Add other middlewares
         };
         this.logger = new logger_service_1.Logger();

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

@@ -25,7 +25,7 @@ const middleware_resolver_1 = require("./middleware-resolver");
  */
 let Middleware = Middleware_1 = class Middleware {
     constructor() {
-        this.middlewares = [];
+        this.middlewarePipeline = [];
         this.logger = new logger_service_1.Logger();
     }
     /**
@@ -36,8 +36,12 @@ let Middleware = Middleware_1 = class Middleware {
      * @returns A boolean value indicating whether the middleware exists or not.
      */
     middlewareExists(middlewareName) {
-        const middlewares = this.getMiddlewares();
-        const middlewareIndex = middlewares.findIndex((m) => m.name === middlewareName);
+        const middlewareIndex = this.middlewarePipeline.findIndex((m) => {
+            var _a;
+            return typeof m.middleware === "object"
+                ? m.middleware.middlewares.some((mw) => (mw === null || mw === void 0 ? void 0 : mw.name) === middlewareName)
+                : ((_a = m.middleware) === null || _a === void 0 ? void 0 : _a.name) === middlewareName;
+        });
         return middlewareIndex !== -1;
     }
     /**
@@ -51,7 +55,10 @@ let Middleware = Middleware_1 = class Middleware {
             this.logger.warn(`[jsonParser] already exists. Skipping...`, "configure-service");
         }
         else {
-            this.middlewares.push(express_1.default.json(options));
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware: express_1.default.json(options),
+            });
         }
     }
     /**
@@ -63,7 +70,10 @@ let Middleware = Middleware_1 = class Middleware {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("cors", options);
         const middlewareExist = this.middlewareExists("cors");
         if (middleware && !middlewareExist) {
-            this.middlewares.push(middleware);
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
         }
     }
     /**
@@ -75,7 +85,10 @@ let Middleware = Middleware_1 = class Middleware {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("compression", options);
         const middlewareExist = this.middlewareExists("compression");
         if (middleware && !middlewareExist) {
-            this.middlewares.push(middleware);
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
         }
     }
     /**
@@ -88,7 +101,10 @@ let Middleware = Middleware_1 = class Middleware {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("cookieParser", secret, options);
         const middlewareExist = this.middlewareExists("cookieParser");
         if (middleware && !middlewareExist) {
-            this.middlewares.push(middleware);
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
         }
     }
     /**
@@ -100,7 +116,27 @@ let Middleware = Middleware_1 = class Middleware {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("cookieSession", options);
         const middlewareExist = this.middlewareExists("cookieSession");
         if (middleware && !middlewareExist) {
-            this.middlewares.push(middleware);
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
+        }
+    }
+    /**
+     * Adds a middleware to serve the favicon to the middleware collection.
+     * The favicon is the icon that is displayed in the browser tab for the application.
+     *
+     * @param path - The path to the favicon file.
+     * @param options - Optional configuration options for serving the favicon. Defines the behavior of the favicon middleware like cache control, custom headers, etc.
+     */
+    addServeFavicon(path, options) {
+        const middleware = (0, middleware_resolver_1.middlewareResolver)("serveFavicon", path, options);
+        const middlewareExist = this.middlewareExists("serveFavicon");
+        if (middleware && !middlewareExist) {
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
         }
     }
     /**
@@ -129,7 +165,10 @@ let Middleware = Middleware_1 = class Middleware {
             this.logger.warn(`[serveStatic] already exists. Skipping...`, "configure-service");
         }
         else {
-            this.middlewares.push(express_1.default.static(root, options));
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware: express_1.default.static(root, options),
+            });
         }
     }
     /**
@@ -138,22 +177,60 @@ let Middleware = Middleware_1 = class Middleware {
      * @param middleware - The Express request handler function to be added to the middleware collection.
      *
      */
-    addMiddleware(middleware) {
-        const middlewareExist = this.middlewareExists(middleware.name);
-        if (middlewareExist) {
-            this.logger.warn(`[${middleware.name}] already exists. Skipping...`, "configure-service");
+    addMiddleware(...middleware) {
+        let config;
+        if (typeof middleware[0] === "string") {
+            const [path, ...middlewares] = middleware;
+            config = {
+                path,
+                middlewares: middlewares,
+            };
+        }
+        else {
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            config = {
+                middlewares: middleware,
+            };
+        }
+        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 {
+                this.middlewarePipeline.push({
+                    timestamp: new Date(),
+                    middleware: config,
+                });
+            }
         }
         else {
-            this.middlewares.push(middleware);
+            config.middlewares.forEach((m) => {
+                const middlewareName = (m === null || m === void 0 ? void 0 : m.name) || "anonymous";
+                const middlewareExist = this.middlewareExists(middlewareName);
+                console.log(middlewareExist);
+                if (middlewareExist) {
+                    this.logger.warn(`[${middlewareName}] already exists. Skipping...`, "configure-service");
+                }
+                else {
+                    this.middlewarePipeline.push({
+                        timestamp: new Date(),
+                        middleware: config,
+                    });
+                }
+            });
         }
     }
     /**
-     * Retrieves all the middlewares that have been added to the collection.
+     * Retrieves middleware pipeline in the order they were added.
      *
      * @returns An array of Express request handlers representing the middlewares.
      */
-    getMiddlewares() {
-        return this.middlewares;
+    getMiddlewarePipeline() {
+        return this.middlewarePipeline.sort((a, b) => {
+            return a.timestamp.getTime() - b.timestamp.getTime();
+        });
     }
     /**
      * Gets the configured error handler middleware.

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

@@ -5,4 +5,5 @@ export { CompressionOptions } from "./interfaces/compression.interface";
 export { CookieSessionOptions } from "./interfaces/cookie-session/cookie-session.interface";
 export { Keygrip } from "./interfaces/cookie-session/keygrip.interface";
 export { CookieParserOptions } from "./interfaces/cookie-parser.interface";
+export { ServeFaviconOptions } from "./interfaces/serve-favicon.interface";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC"}

package/lib/cjs/types/middleware/interfaces/serve-favicon.interface.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ServeFaviconOptions defines the available options for configuring the serve-favicon middleware.
+ */
+interface ServeFaviconOptions {
+    /**
+     * The cache-control max-age directive in ms, defaulting to 1 year.
+     * This can also be a string accepted by the `ms` module.
+     */
+    maxAge?: number | string | undefined;
+}
+export { ServeFaviconOptions };
+//# sourceMappingURL=serve-favicon.interface.d.ts.map

package/lib/cjs/types/middleware/interfaces/serve-favicon.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-favicon.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/middleware/interfaces/serve-favicon.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,UAAU,mBAAmB;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"middleware-resolver.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-resolver.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAqE9B;;;;;;;GAOG;AACH,iBAAS,kBAAkB,CACzB,UAAU,EAAE,MAAM,EAClB,GAAG,OAAO,EAAE,GAAG,GACd,OAAO,CAAC,cAAc,GAAG,IAAI,CAG/B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"middleware-resolver.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-resolver.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAsE9B;;;;;;;GAOG;AACH,iBAAS,kBAAkB,CACzB,UAAU,EAAE,MAAM,EAClB,GAAG,OAAO,EAAE,GAAG,GACd,OAAO,CAAC,cAAc,GAAG,IAAI,CAG/B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

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

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import express from "express";
 import { OptionsJson } from "./interfaces/body-parser.interface";
 import { CompressionOptions } from "./interfaces/compression.interface";
@@ -5,7 +6,47 @@ import { CorsOptions } from "./interfaces/cors.interface";
 import { CookieParserOptions } from "./interfaces/cookie-parser.interface";
 import { ServeStaticOptions } from "./interfaces/serve-static.interface";
 import { CookieSessionOptions } from "./interfaces/cookie-session/cookie-session.interface";
+import { ServeFaviconOptions } from "./interfaces/serve-favicon.interface";
+/**
+ * ExpressHandler Type
+ *
+ * The ExpressHandler type is a union type that represents various types of Express middleware functions.
+ * It can be one of the following types:
+ * - express.ErrorRequestHandler: Handles errors in the middleware pipeline.
+ * - express.RequestParamHandler: Handles parameters in the middleware pipeline.
+ * - express.RequestHandler: General request handler.
+ * - undefined: Represents the absence of a handler.
+ */
 type ExpressHandler = express.ErrorRequestHandler | express.RequestParamHandler | express.RequestHandler | undefined;
+/**
+ * MiddlewareArgs 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.
+ */
+type MiddlewareArgs = string | ExpressHandler;
+/**
+ * MiddlewareConfig Interface
+ *
+ * The MiddlewareConfig interface specifies the structure for middleware configuration objects.
+ * - path: Optional. The route path for which the middleware is configured.
+ * - middlewares: An array of ExpressHandler types that make up the middleware pipeline for the route specified by 'path'.
+ */
+type MiddlewareConfig = {
+    path?: string;
+    middlewares: Array<ExpressHandler>;
+};
+/**
+ * MiddlewarePipeline Interface
+ *
+ * The MiddlewarePipeline interface represents the metadata and actual middleware to be executed in a middleware pipeline.
+ * - timestamp: The date and time at which the middleware was added to the pipeline.
+ * - middleware: Can be either an ExpressHandler function or a MiddlewareConfig object defining a more complex middleware setup.
+ */
+interface MiddlewarePipeline {
+    timestamp: Date;
+    middleware: ExpressHandler | MiddlewareConfig;
+}
 /**
  * Interface for configuring and managing middlewares in the application.
  * Provides methods to be added automatically in the application without the need to import packages.
@@ -43,6 +84,14 @@ interface IMiddleware {
      * @param options - Optional configuration options for Cookie Session. Defines the behavior of cookie sessions like the name of the cookie, keys to sign the cookie, etc.
      */
     addCookieSession(options: CookieSessionOptions): void;
+    /**
+     * Adds a middleware to serve the favicon to the middleware collection.
+     * The favicon is the icon that is displayed in the browser tab for the application.
+     *
+     * @param path - The path to the favicon file.
+     * @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;
     /**
      * Configures the error handling middleware for the application.
      *
@@ -63,13 +112,13 @@ interface IMiddleware {
      * @param middleware - The Express request handler function to be added to the middleware collection.
      *
      */
-    addMiddleware(middleware: express.RequestHandler): void;
+    addMiddleware(...middleware: Array<MiddlewareArgs>): void;
     /**
-     * Retrieves all the middlewares that have been added.
+     * Retrieves middleware pipeline in the order they were added.
      *
      * @returns An array of Express request handlers representing the middlewares.
      */
-    getMiddlewares(): Array<express.RequestHandler>;
+    getMiddlewarePipeline(): Array<MiddlewarePipeline>;
     /**
      * Gets the configured error handler middleware.
      *
@@ -85,7 +134,7 @@ interface IMiddleware {
  * @see IConfigure
  */
 declare class Middleware implements IMiddleware {
-    private middlewares;
+    private middlewarePipeline;
     private errorHandler;
     private logger;
     /**
@@ -127,6 +176,14 @@ declare class Middleware implements IMiddleware {
      * @param options - Optional configuration options for Cookie Session. Defines the behavior of cookie sessions like the name of the cookie, keys to sign the cookie, etc.
      */
     addCookieSession(options: CookieSessionOptions): void;
+    /**
+     * Adds a middleware to serve the favicon to the middleware collection.
+     * The favicon is the icon that is displayed in the browser tab for the application.
+     *
+     * @param path - The path to the favicon file.
+     * @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;
     /**
      * Configures the error handling middleware for the application.
      *
@@ -147,13 +204,13 @@ declare class Middleware implements IMiddleware {
      * @param middleware - The Express request handler function to be added to the middleware collection.
      *
      */
-    addMiddleware(middleware: express.RequestHandler): void;
+    addMiddleware(...middleware: Array<MiddlewareArgs>): void;
     /**
-     * Retrieves all the middlewares that have been added to the collection.
+     * Retrieves middleware pipeline in the order they were added.
      *
      * @returns An array of Express request handlers representing the middlewares.
      */
-    getMiddlewares(): Array<express.RequestHandler>;
+    getMiddlewarePipeline(): Array<MiddlewarePipeline>;
     /**
      * Gets the configured error handler middleware.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"middleware-service.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"middleware-service.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-service.ts"],"names":[],"mappings":"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"}

package/lib/esm/middleware/interfaces/serve-favicon.interface.js

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

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

@@ -22,6 +22,7 @@ class MiddlewareResolver {
         compression: "compression",
         cookieParser: "cookie-parser",
         cookieSession: "cookie-session",
+        serveFavicon: "serve-favicon",
         // Add other middlewares
     };
     /**

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

@@ -24,7 +24,7 @@ const middleware_resolver_1 = require("./middleware-resolver");
  * @see IConfigure
  */
 let Middleware = Middleware_1 = class Middleware {
-    middlewares = [];
+    middlewarePipeline = [];
     errorHandler;
     logger = new logger_service_1.Logger();
     /**
@@ -35,8 +35,9 @@ let Middleware = Middleware_1 = class Middleware {
      * @returns A boolean value indicating whether the middleware exists or not.
      */
     middlewareExists(middlewareName) {
-        const middlewares = this.getMiddlewares();
-        const middlewareIndex = middlewares.findIndex((m) => m.name === 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;
     }
     /**
@@ -50,7 +51,10 @@ let Middleware = Middleware_1 = class Middleware {
             this.logger.warn(`[jsonParser] already exists. Skipping...`, "configure-service");
         }
         else {
-            this.middlewares.push(express_1.default.json(options));
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware: express_1.default.json(options),
+            });
         }
     }
     /**
@@ -62,7 +66,10 @@ let Middleware = Middleware_1 = class Middleware {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("cors", options);
         const middlewareExist = this.middlewareExists("cors");
         if (middleware && !middlewareExist) {
-            this.middlewares.push(middleware);
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
         }
     }
     /**
@@ -74,7 +81,10 @@ let Middleware = Middleware_1 = class Middleware {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("compression", options);
         const middlewareExist = this.middlewareExists("compression");
         if (middleware && !middlewareExist) {
-            this.middlewares.push(middleware);
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
         }
     }
     /**
@@ -87,7 +97,10 @@ let Middleware = Middleware_1 = class Middleware {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("cookieParser", secret, options);
         const middlewareExist = this.middlewareExists("cookieParser");
         if (middleware && !middlewareExist) {
-            this.middlewares.push(middleware);
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
         }
     }
     /**
@@ -99,7 +112,27 @@ let Middleware = Middleware_1 = class Middleware {
         const middleware = (0, middleware_resolver_1.middlewareResolver)("cookieSession", options);
         const middlewareExist = this.middlewareExists("cookieSession");
         if (middleware && !middlewareExist) {
-            this.middlewares.push(middleware);
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
+        }
+    }
+    /**
+     * Adds a middleware to serve the favicon to the middleware collection.
+     * The favicon is the icon that is displayed in the browser tab for the application.
+     *
+     * @param path - The path to the favicon file.
+     * @param options - Optional configuration options for serving the favicon. Defines the behavior of the favicon middleware like cache control, custom headers, etc.
+     */
+    addServeFavicon(path, options) {
+        const middleware = (0, middleware_resolver_1.middlewareResolver)("serveFavicon", path, options);
+        const middlewareExist = this.middlewareExists("serveFavicon");
+        if (middleware && !middlewareExist) {
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware,
+            });
         }
     }
     /**
@@ -128,7 +161,10 @@ let Middleware = Middleware_1 = class Middleware {
             this.logger.warn(`[serveStatic] already exists. Skipping...`, "configure-service");
         }
         else {
-            this.middlewares.push(express_1.default.static(root, options));
+            this.middlewarePipeline.push({
+                timestamp: new Date(),
+                middleware: express_1.default.static(root, options),
+            });
         }
     }
     /**
@@ -137,22 +173,60 @@ let Middleware = Middleware_1 = class Middleware {
      * @param middleware - The Express request handler function to be added to the middleware collection.
      *
      */
-    addMiddleware(middleware) {
-        const middlewareExist = this.middlewareExists(middleware.name);
-        if (middlewareExist) {
-            this.logger.warn(`[${middleware.name}] already exists. Skipping...`, "configure-service");
+    addMiddleware(...middleware) {
+        let config;
+        if (typeof middleware[0] === "string") {
+            const [path, ...middlewares] = middleware;
+            config = {
+                path,
+                middlewares: middlewares,
+            };
+        }
+        else {
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            config = {
+                middlewares: middleware,
+            };
+        }
+        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 {
+                this.middlewarePipeline.push({
+                    timestamp: new Date(),
+                    middleware: config,
+                });
+            }
         }
         else {
-            this.middlewares.push(middleware);
+            config.middlewares.forEach((m) => {
+                const middlewareName = m?.name || "anonymous";
+                const middlewareExist = this.middlewareExists(middlewareName);
+                console.log(middlewareExist);
+                if (middlewareExist) {
+                    this.logger.warn(`[${middlewareName}] already exists. Skipping...`, "configure-service");
+                }
+                else {
+                    this.middlewarePipeline.push({
+                        timestamp: new Date(),
+                        middleware: config,
+                    });
+                }
+            });
         }
     }
     /**
-     * Retrieves all the middlewares that have been added to the collection.
+     * Retrieves middleware pipeline in the order they were added.
      *
      * @returns An array of Express request handlers representing the middlewares.
      */
-    getMiddlewares() {
-        return this.middlewares;
+    getMiddlewarePipeline() {
+        return this.middlewarePipeline.sort((a, b) => {
+            return a.timestamp.getTime() - b.timestamp.getTime();
+        });
     }
     /**
      * Gets the configured error handler middleware.

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

@@ -5,4 +5,5 @@ export { CompressionOptions } from "./interfaces/compression.interface";
 export { CookieSessionOptions } from "./interfaces/cookie-session/cookie-session.interface";
 export { Keygrip } from "./interfaces/cookie-session/keygrip.interface";
 export { CookieParserOptions } from "./interfaces/cookie-parser.interface";
+export { ServeFaviconOptions } from "./interfaces/serve-favicon.interface";
 //# sourceMappingURL=index.d.ts.map

package/lib/esm/types/middleware/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,+CAA+C,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC"}

package/lib/esm/types/middleware/interfaces/serve-favicon.interface.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ServeFaviconOptions defines the available options for configuring the serve-favicon middleware.
+ */
+interface ServeFaviconOptions {
+    /**
+     * The cache-control max-age directive in ms, defaulting to 1 year.
+     * This can also be a string accepted by the `ms` module.
+     */
+    maxAge?: number | string | undefined;
+}
+export { ServeFaviconOptions };
+//# sourceMappingURL=serve-favicon.interface.d.ts.map

package/lib/esm/types/middleware/interfaces/serve-favicon.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-favicon.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/middleware/interfaces/serve-favicon.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,UAAU,mBAAmB;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/lib/esm/types/middleware/middleware-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware-resolver.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-resolver.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAqE9B;;;;;;;GAOG;AACH,iBAAS,kBAAkB,CACzB,UAAU,EAAE,MAAM,EAClB,GAAG,OAAO,EAAE,GAAG,GACd,OAAO,CAAC,cAAc,GAAG,IAAI,CAG/B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"middleware-resolver.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-resolver.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAsE9B;;;;;;;GAOG;AACH,iBAAS,kBAAkB,CACzB,UAAU,EAAE,MAAM,EAClB,GAAG,OAAO,EAAE,GAAG,GACd,OAAO,CAAC,cAAc,GAAG,IAAI,CAG/B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

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

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 import express from "express";
 import { OptionsJson } from "./interfaces/body-parser.interface";
 import { CompressionOptions } from "./interfaces/compression.interface";
@@ -5,7 +6,47 @@ import { CorsOptions } from "./interfaces/cors.interface";
 import { CookieParserOptions } from "./interfaces/cookie-parser.interface";
 import { ServeStaticOptions } from "./interfaces/serve-static.interface";
 import { CookieSessionOptions } from "./interfaces/cookie-session/cookie-session.interface";
+import { ServeFaviconOptions } from "./interfaces/serve-favicon.interface";
+/**
+ * ExpressHandler Type
+ *
+ * The ExpressHandler type is a union type that represents various types of Express middleware functions.
+ * It can be one of the following types:
+ * - express.ErrorRequestHandler: Handles errors in the middleware pipeline.
+ * - express.RequestParamHandler: Handles parameters in the middleware pipeline.
+ * - express.RequestHandler: General request handler.
+ * - undefined: Represents the absence of a handler.
+ */
 type ExpressHandler = express.ErrorRequestHandler | express.RequestParamHandler | express.RequestHandler | undefined;
+/**
+ * MiddlewareArgs 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.
+ */
+type MiddlewareArgs = string | ExpressHandler;
+/**
+ * MiddlewareConfig Interface
+ *
+ * The MiddlewareConfig interface specifies the structure for middleware configuration objects.
+ * - path: Optional. The route path for which the middleware is configured.
+ * - middlewares: An array of ExpressHandler types that make up the middleware pipeline for the route specified by 'path'.
+ */
+type MiddlewareConfig = {
+    path?: string;
+    middlewares: Array<ExpressHandler>;
+};
+/**
+ * MiddlewarePipeline Interface
+ *
+ * The MiddlewarePipeline interface represents the metadata and actual middleware to be executed in a middleware pipeline.
+ * - timestamp: The date and time at which the middleware was added to the pipeline.
+ * - middleware: Can be either an ExpressHandler function or a MiddlewareConfig object defining a more complex middleware setup.
+ */
+interface MiddlewarePipeline {
+    timestamp: Date;
+    middleware: ExpressHandler | MiddlewareConfig;
+}
 /**
  * Interface for configuring and managing middlewares in the application.
  * Provides methods to be added automatically in the application without the need to import packages.
@@ -43,6 +84,14 @@ interface IMiddleware {
      * @param options - Optional configuration options for Cookie Session. Defines the behavior of cookie sessions like the name of the cookie, keys to sign the cookie, etc.
      */
     addCookieSession(options: CookieSessionOptions): void;
+    /**
+     * Adds a middleware to serve the favicon to the middleware collection.
+     * The favicon is the icon that is displayed in the browser tab for the application.
+     *
+     * @param path - The path to the favicon file.
+     * @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;
     /**
      * Configures the error handling middleware for the application.
      *
@@ -63,13 +112,13 @@ interface IMiddleware {
      * @param middleware - The Express request handler function to be added to the middleware collection.
      *
      */
-    addMiddleware(middleware: express.RequestHandler): void;
+    addMiddleware(...middleware: Array<MiddlewareArgs>): void;
     /**
-     * Retrieves all the middlewares that have been added.
+     * Retrieves middleware pipeline in the order they were added.
      *
      * @returns An array of Express request handlers representing the middlewares.
      */
-    getMiddlewares(): Array<express.RequestHandler>;
+    getMiddlewarePipeline(): Array<MiddlewarePipeline>;
     /**
      * Gets the configured error handler middleware.
      *
@@ -85,7 +134,7 @@ interface IMiddleware {
  * @see IConfigure
  */
 declare class Middleware implements IMiddleware {
-    private middlewares;
+    private middlewarePipeline;
     private errorHandler;
     private logger;
     /**
@@ -127,6 +176,14 @@ declare class Middleware implements IMiddleware {
      * @param options - Optional configuration options for Cookie Session. Defines the behavior of cookie sessions like the name of the cookie, keys to sign the cookie, etc.
      */
     addCookieSession(options: CookieSessionOptions): void;
+    /**
+     * Adds a middleware to serve the favicon to the middleware collection.
+     * The favicon is the icon that is displayed in the browser tab for the application.
+     *
+     * @param path - The path to the favicon file.
+     * @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;
     /**
      * Configures the error handling middleware for the application.
      *
@@ -147,13 +204,13 @@ declare class Middleware implements IMiddleware {
      * @param middleware - The Express request handler function to be added to the middleware collection.
      *
      */
-    addMiddleware(middleware: express.RequestHandler): void;
+    addMiddleware(...middleware: Array<MiddlewareArgs>): void;
     /**
-     * Retrieves all the middlewares that have been added to the collection.
+     * Retrieves middleware pipeline in the order they were added.
      *
      * @returns An array of Express request handlers representing the middlewares.
      */
-    getMiddlewares(): Array<express.RequestHandler>;
+    getMiddlewarePipeline(): Array<MiddlewarePipeline>;
     /**
      * Gets the configured error handler middleware.
      *

package/lib/esm/types/middleware/middleware-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware-service.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-service.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAI9B,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAE5F,KAAK,cAAc,GACf,OAAO,CAAC,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,GAC3B,OAAO,CAAC,cAAc,GACtB,SAAS,CAAC;AAEd;;;GAGG;AACH,UAAU,WAAW;IACnB;;;;;OAKG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE3C;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAErC;;;;OAIG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEnD;;;;;OAKG;IACH,eAAe,CACb,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,EAC3C,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI,CAAC;IAER;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEtD;;;;OAIG;IACH,eAAe,CAAC,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAExD;;;;OAIG;IACH,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAEhD;;;;OAIG;IACH,eAAe,IAAI,cAAc,CAAC;CACnC;AAED;;;;;;GAMG;AACH,cACM,UAAW,YAAW,WAAW;IACrC,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,MAAM,CAAwB;IAEtC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;;OAIG;IACI,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAajD;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IASpC;;;;OAIG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAUlD;;;;;OAKG;IACH,eAAe,CACb,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,EAC3C,OAAO,CAAC,EAAE,mBAAmB,GAAG,SAAS,GACxC,IAAI;IAUP;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAUrD;;;;OAIG;IACH,eAAe,CAAC,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI;IAQrD;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAa7D;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,GAAG,IAAI;IAavD;;;;OAIG;IACI,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;IAItD;;;;OAIG;IACI,eAAe,IAAI,cAAc;CAGzC;AAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"middleware-service.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-service.ts"],"names":[],"mappings":"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"}

package/lib/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/core",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@core)",
   "author": "Richard Zampieri",
   "main": "./lib/cjs/index.js",
@@ -51,13 +51,11 @@
   },
   "scripts": {
     "prepare": "husky install",
-    "win-clean": "if exist lib (del /q lib\\*)",
-    "linux-clean": "rm -rf lib/*",
-    "win-cpy": "xcopy package.json lib\\ && xcopy README.md lib\\ && xcopy CHANGELOG.md lib\\ /Y",
-    "linux-cpy": "cp package.json README.md CHANGELOG.md lib/",
-    "build:win": "npm run win-clean && npm run build:esm && npm run build:cjs && npm run win-cpy",
-    "build:linux": "npm run linux-clean && npm run build:esm && npm run build:cjs && npm run linux-cpy",
-    "build:esm": "tsc -p tsconfig.esm.json && mv lib/esm/index.js lib/esm/index.mjs ",
+    "clean": "node scripts/rm.js lib",
+    "copy": "node scripts/copy.js package.json README.md CHANGELOG.md lib",
+    "rename:esm": "node scripts/mv.js lib/esm/index.js lib/esm/index.mjs",
+    "build": "npm run clean && npm run build:esm && npm run build:cjs && npm run copy",
+    "build:esm": "tsc -p tsconfig.esm.json && npm run rename:esm",
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "release": "release-it",
     "coverage": "vitest run --coverage",
@@ -145,6 +143,10 @@
             {
               "type": "ci",
               "section": "Continuous Integrations"
+            },
+            {
+              "type": "chore",
+              "hidden": true
             }
           ]
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressots/core",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Expressots - modern, fast, lightweight nodejs web framework (@core)",
   "author": "Richard Zampieri",
   "main": "./lib/cjs/index.js",
@@ -51,13 +51,11 @@
   },
   "scripts": {
     "prepare": "husky install",
-    "win-clean": "if exist lib (del /q lib\\*)",
-    "linux-clean": "rm -rf lib/*",
-    "win-cpy": "xcopy package.json lib\\ && xcopy README.md lib\\ && xcopy CHANGELOG.md lib\\ /Y",
-    "linux-cpy": "cp package.json README.md CHANGELOG.md lib/",
-    "build:win": "npm run win-clean && npm run build:esm && npm run build:cjs && npm run win-cpy",
-    "build:linux": "npm run linux-clean && npm run build:esm && npm run build:cjs && npm run linux-cpy",
-    "build:esm": "tsc -p tsconfig.esm.json && mv lib/esm/index.js lib/esm/index.mjs ",
+    "clean": "node scripts/rm.js lib",
+    "copy": "node scripts/copy.js package.json README.md CHANGELOG.md lib",
+    "rename:esm": "node scripts/mv.js lib/esm/index.js lib/esm/index.mjs",
+    "build": "npm run clean && npm run build:esm && npm run build:cjs && npm run copy",
+    "build:esm": "tsc -p tsconfig.esm.json && npm run rename:esm",
     "build:cjs": "tsc -p tsconfig.cjs.json",
     "release": "release-it",
     "coverage": "vitest run --coverage",
@@ -145,6 +143,10 @@
             {
               "type": "ci",
               "section": "Continuous Integrations"
+            },
+            {
+              "type": "chore",
+              "hidden": true
             }
           ]
         }