@expressots/core 1.9.0 → 2.0.0

package/lib/CHANGELOG.md

@@ -1,39 +1,67 @@
+## [2.0.0](https://github.com/expressots/expressots/compare/1.9.1...2.0.0) (2023-09-14)
 
+### Features
 
-## [1.9.0](https://github.com/expressots/expressots/compare/1.8.1...1.9.0) (2023-09-12)
-
-
-### Features
-
-* add pck resolver & remove chalk dependency ([6bbd415](https://github.com/expressots/expressots/commit/6bbd415937159e419116b6ade8f9852c3251fbf4))
-* bump vitest from 0.34.3 to 0.34.4 ([#92](https://github.com/expressots/expressots/issues/92)) ([89dc682](https://github.com/expressots/expressots/commit/89dc682c7047897f01fd7770591b6ffea689d137))
-
-
-### Bug Fixes
-
-* disable console.spec to be refactored ([22a54bd](https://github.com/expressots/expressots/commit/22a54bdb7f0c2032d3b0e0f935ce48d73e665e84))
-* dto validator json structure per property ([a8fbe40](https://github.com/expressots/expressots/commit/a8fbe409647140e867f930a882fd395df45d6de7))
-* export console for testing ([d3f2c07](https://github.com/expressots/expressots/commit/d3f2c07ca2df0176fabed04172ce4ff684c91c9c))
-* opinionated template logger.error function ([073f4e1](https://github.com/expressots/expressots/commit/073f4e154732fa3fed9492ec772c36894bc3cf48))
-* replace dto interface for class opinionated template ([3e99d7c](https://github.com/expressots/expressots/commit/3e99d7c5492ff64701e754ec845a0410da442296))
-* use new report utility in usecases ([#91](https://github.com/expressots/expressots/issues/91)) ([d1477b2](https://github.com/expressots/expressots/commit/d1477b24f932e354fb55373e8e73fe9155289486))
-
-
-### Code Refactoring
-
-* update type from any to number ([#90](https://github.com/expressots/expressots/issues/90)) ([5e34a44](https://github.com/expressots/expressots/commit/5e34a44d8bd353b8d3834f198f36bf73aa521845))
+- add middleware resolver ([23b8d9f](https://github.com/expressots/expressots/commit/23b8d9ff8f0c8b4bb893f4fd0d7f39afcb7dd1cd))
+- add app factory
+- add services layer
+- add middleware interfaces for cors, compression, bodyparser and generic middleware
+- add configurable error handler
+- separate expressjs from core library in its own library called adapter-express
+- created provider mechanism to share resources between multiple adapters
+- eliminate chalk, inversify utils dependencies
+- create a logger system using stdout
 
-## [1.8.1](https://github.com/expressots/expressots/compare/1.8.0...1.8.1) (2023-09-10)
+### Code Refactoring
+
+- refactor error handling
+- remove winston lib for loggin ([5868bc9](https://github.com/expressots/expressots/commit/5868bc949f2242f0a9bfe5483642bb3878cc0156))
+- removing unnecessary dependencies ([fdd43e0](https://github.com/expressots/expressots/commit/fdd43e0f280024b8e4b53f392ea56842a091898e))
 
+## [1.9.1](https://github.com/expressots/expressots/compare/1.9.0...1.9.1) (2023-09-14)
 
 ### Bug Fixes
 
-* add generic in memory db and virtual table analysis ([#86](https://github.com/expressots/expressots/issues/86)) ([29541f9](https://github.com/expressots/expressots/commit/29541f997e47c8ac5f8cafbb0195c34c904454f4))
+- add peer dependency @expressots/adapter-express ([874db40](https://github.com/expressots/expressots/commit/874db402af7bac8d5ac638fc206f3daf9f707fc3))
+- change esm config to modeule interop ([32f04b5](https://github.com/expressots/expressots/commit/32f04b5bc7da6c515df70b0156f2f5cadd5526ac))
+- change esm config to modeule interop ([978b168](https://github.com/expressots/expressots/commit/978b1685aa18c0573313ee96049159a1c95c4d87))
+- opinionated template app provider services ([bcb55ca](https://github.com/expressots/expressots/commit/bcb55caf1e5a0ff053b5aaf89a79ef4537b38161))
+- using adapter-express dependency ([84b0348](https://github.com/expressots/expressots/commit/84b03486193632b84e46e670bd44c6f8a01ebaa4))
+
+### Code Refactoring
+
+- create express adapter platform ([784beaa](https://github.com/expressots/expressots/commit/784beaaea9247e304abada8ebd33c673199e35f9))
+- expose app base class for adapter ([36d8dec](https://github.com/expressots/expressots/commit/36d8dec0435a2456d1b9e1d5dca5bfb8956cfdea))
 
+## [1.9.0](https://github.com/expressots/expressots/compare/1.8.1...1.9.0) (2023-09-12)
+
+### Features
+
+- add pck resolver & remove chalk dependency ([6bbd415](https://github.com/expressots/expressots/commit/6bbd415937159e419116b6ade8f9852c3251fbf4))
+- bump vitest from 0.34.3 to 0.34.4 ([#92](https://github.com/expressots/expressots/issues/92)) ([89dc682](https://github.com/expressots/expressots/commit/89dc682c7047897f01fd7770591b6ffea689d137))
+
+### Bug Fixes
+
+- disable console.spec to be refactored ([22a54bd](https://github.com/expressots/expressots/commit/22a54bdb7f0c2032d3b0e0f935ce48d73e665e84))
+- dto validator json structure per property ([a8fbe40](https://github.com/expressots/expressots/commit/a8fbe409647140e867f930a882fd395df45d6de7))
+- export console for testing ([d3f2c07](https://github.com/expressots/expressots/commit/d3f2c07ca2df0176fabed04172ce4ff684c91c9c))
+- opinionated template logger.error function ([073f4e1](https://github.com/expressots/expressots/commit/073f4e154732fa3fed9492ec772c36894bc3cf48))
+- replace dto interface for class opinionated template ([3e99d7c](https://github.com/expressots/expressots/commit/3e99d7c5492ff64701e754ec845a0410da442296))
+- use new report utility in usecases ([#91](https://github.com/expressots/expressots/issues/91)) ([d1477b2](https://github.com/expressots/expressots/commit/d1477b24f932e354fb55373e8e73fe9155289486))
+
+### Code Refactoring
+
+- update type from any to number ([#90](https://github.com/expressots/expressots/issues/90)) ([5e34a44](https://github.com/expressots/expressots/commit/5e34a44d8bd353b8d3834f198f36bf73aa521845))
+
+## [1.8.1](https://github.com/expressots/expressots/compare/1.8.0...1.8.1) (2023-09-10)
+
+### Bug Fixes
+
+- add generic in memory db and virtual table analysis ([#86](https://github.com/expressots/expressots/issues/86)) ([29541f9](https://github.com/expressots/expressots/commit/29541f997e47c8ac5f8cafbb0195c34c904454f4))
 
 ### Continuous Integrations
 
-* config test workflow and setup vitest ([#88](https://github.com/expressots/expressots/issues/88)) ([67316ce](https://github.com/expressots/expressots/commit/67316cece977f04f9750a5a5af6cd88dfc695e0d))
+- config test workflow and setup vitest ([#88](https://github.com/expressots/expressots/issues/88)) ([67316ce](https://github.com/expressots/expressots/commit/67316cece977f04f9750a5a5af6cd88dfc695e0d))
 
 ## [1.8.0](https://github.com/expressots/expressots/compare/1.7.0...1.8.0) (2023-09-05)
 
@@ -270,4 +298,4 @@
 
 ### Bug Fixes
 
-- fix pipeline for tag name ([b9ec52d](https://github.com/expressots/expressots/commit/b9ec52dc065763185f69364d8f083b1a95fa37e0))
+- fix pipeline for tag name ([b9ec52d](https://github.com/expressots/expressots/commit/b9ec52dc065763185f69364d8f083b1a95fa37e0))

package/lib/cjs/application/application-factory.js

@@ -0,0 +1,83 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppFactory = void 0;
+const logger_service_1 = require("../provider/logger/logger-service");
+const adapter_express_1 = require("@expressots/adapter-express");
+//import { AppFastify } from "./fastify/application-fastify";
+//import { IApplicationFastify } from "./fastify/application-fastify.interface";
+//import { Handler } from "@fastify/middie";
+/**
+ * AppFactory Class
+ *
+ * Responsible for creating an instance of the Application,
+ * either using a custom application type or with provided middlewares.
+ */
+class AppFactory {
+    /* public static async create(
+      container: Container,
+      middlewares: Array<express.RequestHandler>,
+      httpServerFactory?: new () => AppFastify,
+    ): Promise<AppFastify>; */
+    /**
+     * Implementation of the create method, handling both overloads.
+     * @param container - InversifyJS container to resolve dependencies.
+     * @param appTypeOrMiddlewares - Custom application class or array of middlewares.
+     * @returns Instance of the application.
+     */
+    static create(container, appTypeOrMiddlewares, httpServerFactory /*| AppFastify*/) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let app /*| AppFastify*/ = {}; /*| AppFastify*/
+            if (this.isOpinionated(appTypeOrMiddlewares)) {
+                switch (httpServerFactory) {
+                    case adapter_express_1.AppExpress:
+                        app = container.resolve(appTypeOrMiddlewares);
+                        app.create(container);
+                        return app;
+                    /* case AppFastify:
+                      app = container.resolve(appTypeOrMiddlewares as new () => AppFastify);
+                      await app.create(container);
+                      return app as IApplicationFastify; */
+                    default:
+                        app = container.resolve(appTypeOrMiddlewares);
+                        app.create(container);
+                        return app;
+                }
+            }
+            else {
+                switch (httpServerFactory) {
+                    case adapter_express_1.AppExpress:
+                        app = container.get(adapter_express_1.AppExpress);
+                        app.create(container, appTypeOrMiddlewares);
+                        return app;
+                    /* case AppFastify:
+                      app = container.get<AppFastify>(AppFastify);
+                      await app.create(container, appTypeOrMiddlewares as Array<Handler>);
+                      return app as AppFastify; */
+                    default:
+                        app = container.get(adapter_express_1.AppExpress);
+                        app.create(container, appTypeOrMiddlewares);
+                        return app;
+                }
+            }
+        });
+    }
+    /**
+     * Checks if the provided parameter is a custom application type.
+     * @param appTypeOrMiddlewares - Custom application class or array of middlewares.
+     * @returns True if the provided parameter is a custom application type.
+     */
+    static isOpinionated(appTypeOrMiddlewares) {
+        return typeof appTypeOrMiddlewares === "function";
+    }
+}
+exports.AppFactory = AppFactory;
+AppFactory.logger = new logger_service_1.Logger();

package/lib/cjs/application/index.js

@@ -1,9 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppContainer = exports.ServerEnvironment = exports.Application = exports.AppInstance = void 0;
-var application_1 = require("./application");
-Object.defineProperty(exports, "AppInstance", { enumerable: true, get: function () { return application_1.AppInstance; } });
-Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return application_1.Application; } });
-Object.defineProperty(exports, "ServerEnvironment", { enumerable: true, get: function () { return application_1.ServerEnvironment; } });
+exports.AppFactory = exports.AppContainer = void 0;
 var app_container_1 = require("./app-container");
 Object.defineProperty(exports, "AppContainer", { enumerable: true, get: function () { return app_container_1.AppContainer; } });
+var application_factory_1 = require("./application-factory");
+Object.defineProperty(exports, "AppFactory", { enumerable: true, get: function () { return application_factory_1.AppFactory; } });

package/lib/cjs/controller/base-controller.js

@@ -5,9 +5,6 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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 __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -27,13 +24,6 @@ const inversify_binding_decorators_1 = require("inversify-binding-decorators");
  * @provide BaseController
  */
 let BaseController = BaseController_1 = class BaseController {
-    /**
-     * Constructs a new BaseController instance with a specified service name.
-     * @param serviceName - The name of the service associated with the controller.
-     */
-    constructor(serviceName = "") {
-        this.serviceName = serviceName;
-    }
     /**
      * Calls an asynchronous use case and sends an appropriate response based on the result.
      * @param useCase - A promise representing the asynchronous use case to call.
@@ -92,6 +82,5 @@ let BaseController = BaseController_1 = class BaseController {
 };
 exports.BaseController = BaseController;
 exports.BaseController = BaseController = BaseController_1 = __decorate([
-    (0, inversify_binding_decorators_1.provide)(BaseController_1),
-    __metadata("design:paramtypes", [String])
+    (0, inversify_binding_decorators_1.provide)(BaseController_1)
 ], BaseController);

package/lib/cjs/decorator/scope-binding.js

@@ -4,10 +4,40 @@ exports.provideTransient = exports.provideSingleton = void 0;
 /* eslint-disable @typescript-eslint/explicit-function-return-type */
 /* eslint-disable @typescript-eslint/no-explicit-any */
 const inversify_binding_decorators_1 = require("inversify-binding-decorators");
+/**
+ * Provides a singleton binding for the given identifier.
+ *
+ * @remarks
+ * Singleton binding ensures that the same instance of a dependency is reused within the entire container.
+ *
+ * @param identifier - The identifier (e.g., symbol, string, class) for the dependency being registered.
+ * @returns A fluent interface for further configuring the binding.
+ *
+ * @example
+ * ```typescript
+ * @provideSingleton(ServiceIdentifier)
+ * class MyService {}
+ * ```
+ */
 const provideSingleton = (identifier) => {
     return (0, inversify_binding_decorators_1.fluentProvide)(identifier).inSingletonScope().done();
 };
 exports.provideSingleton = provideSingleton;
+/**
+ * Provides a transient binding for the given identifier.
+ *
+ * @remarks
+ * Transient binding ensures that a new instance of a dependency is created every time it is resolved.
+ *
+ * @param identifier - The identifier (e.g., symbol, string, class) for the dependency being registered.
+ * @returns A fluent interface for further configuring the binding.
+ *
+ * @example
+ * ```typescript
+ * @provideTransient(ServiceIdentifier)
+ * class MyService {}
+ * ```
+ */
 const provideTransient = (identifier) => {
     return (0, inversify_binding_decorators_1.fluentProvide)(identifier).inTransientScope().done();
 };

package/lib/cjs/index.js

@@ -21,5 +21,6 @@ __exportStar(require("./container-module"), exports);
 __exportStar(require("./controller"), exports);
 __exportStar(require("./decorator"), exports);
 __exportStar(require("./error"), exports);
+__exportStar(require("./middleware"), exports);
 __exportStar(require("./provider"), exports);
 __exportStar(require("./render"), exports);

package/lib/cjs/middleware/index.js

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

package/lib/cjs/middleware/interfaces/body-parser.interface.js

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

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

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

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

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

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

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

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.middlewareResolver = void 0;
+const logger_service_1 = require("../provider/logger/logger-service");
+/**
+ * MiddlewareResolver class is responsible for resolving and retrieving Express middlewares
+ * by their names. It maintains a registry of available middlewares and provides
+ * a method to retrieve them by their name. If a middleware is not installed, it logs
+ * an informative message.
+ */
+class MiddlewareResolver {
+    constructor() {
+        /**
+         * A registry object mapping middleware names to their corresponding package names.
+         * It is used to identify and require the middleware from the current working directory.
+         */
+        this.middlewareRegistry = {
+            cors: "cors",
+            compression: "compression",
+            // Add other middlewares
+        };
+        this.logger = new logger_service_1.Logger();
+    }
+    /**
+     * Retrieves a middleware by its name and optionally configures it with provided options.
+     *
+     * @param {string} middlewareName - The name of the middleware to be retrieved.
+     * @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.
+     */
+    getMiddleware(middlewareName, ...options) {
+        const packageName = this.middlewareRegistry[middlewareName];
+        if (!packageName) {
+            console.error(`Middleware ${middlewareName} not found`);
+            return null;
+        }
+        let hasMiddleware = "";
+        try {
+            hasMiddleware = require.resolve(packageName, { paths: [process.cwd()] });
+        }
+        catch (error) {
+            this.logger.warn(`Middleware [${middlewareName}] not installed. Please install it using your package manager.`, "middleware-resolver");
+        }
+        if (hasMiddleware) {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const middleware = require(hasMiddleware);
+            return middleware(...options) || middleware.default(...options);
+        }
+        return null;
+    }
+}
+/**
+ * A utility function that wraps the creation and retrieval of middleware.
+ * It creates a new instance of MiddlewareResolver and calls the getMiddleware method.
+ *
+ * @param {string} middleware - The name of the middleware to be retrieved.
+ * @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.
+ */
+function middlewareResolver(middleware, ...options) {
+    const resolver = new MiddlewareResolver();
+    return resolver.getMiddleware(middleware, ...options);
+}
+exports.middlewareResolver = middlewareResolver;

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

@@ -0,0 +1,145 @@
+"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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var Middleware_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Middleware = 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");
+/**
+ * Singleton class that implements the IConfigure interface.
+ * Manages the middleware configuration for the application,
+ * including adding Body Parser and retrieving all configured middlewares.
+ *
+ * @see IConfigure
+ */
+let Middleware = Middleware_1 = class Middleware {
+    constructor() {
+        this.middlewares = [];
+        this.logger = new logger_service_1.Logger();
+    }
+    /**
+     * Checks if a middleware with the given name exists in the middleware collection.
+     *
+     * @param middlewareName - The name of the middleware to be checked.
+     *
+     * @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);
+        return middlewareIndex !== -1;
+    }
+    /**
+     * Adds a Body Parser middleware to the middleware collection using the given options.
+     *
+     * @param options - Optional configuration options for the JSON body parser.
+     */
+    addBodyParser(options) {
+        const middlewareExist = this.middlewareExists("jsonParser");
+        if (middlewareExist) {
+            this.logger.warn(`[jsonParser] already exists. Skipping...`, "configure-service");
+        }
+        else {
+            this.middlewares.push(express_1.default.json(options));
+        }
+    }
+    /**
+     * Adds Cross-Origin Resource Sharing (CORS) middleware to enable or control cross-origin requests.
+     *
+     * @param options - Optional configuration options for CORS. Defines the behavior of CORS requests like allowed origins, methods, headers, etc.
+     */
+    addCors(options) {
+        const middleware = (0, middleware_resolver_1.middlewareResolver)("cors", options);
+        const middlewareExist = this.middlewareExists("cors");
+        if (middleware && !middlewareExist) {
+            this.middlewares.push(middleware);
+        }
+    }
+    /**
+     * Adds Compression middleware to reduce the size of the response body and improve the speed of the client-server communication.
+     *
+     * @param options - Optional configuration options for Compression. Allows fine-tuning the compression behavior, such as setting the compression level, threshold, and filter functions to determine which requests should be compressed.
+     */
+    addCompression(options) {
+        const middleware = (0, middleware_resolver_1.middlewareResolver)("compression", options);
+        const middlewareExist = this.middlewareExists("compression");
+        if (middleware && !middlewareExist) {
+            this.middlewares.push(middleware);
+        }
+    }
+    /**
+     * Configures the error handling middleware for the application.
+     *
+     * @param errorHandling - The Express error handler function that takes care of processing errors and formulating the response.
+     */
+    setErrorHandler(errorHandling) {
+        if (!errorHandling) {
+            this.errorHandler = error_handler_middleware_1.default;
+        }
+        else {
+            this.errorHandler = errorHandling;
+        }
+    }
+    /**
+     * Adds a middleware to serve static files from the specified root directory.
+     * Allows the application to serve files like images, CSS, JavaScript, etc.
+     *
+     * @param root - The root directory from which the static assets are to be served.
+     * @param options - Optional configuration options for serving static files. Defines behavior like cache control, custom headers, etc.
+     */
+    serveStatic(root, options) {
+        const middlewareExist = this.middlewareExists("serveStatic");
+        if (middlewareExist) {
+            this.logger.warn(`[serveStatic] already exists. Skipping...`, "configure-service");
+        }
+        else {
+            this.middlewares.push(express_1.default.static(root, options));
+        }
+    }
+    /**
+     * Adds a middleware to the middleware collection.
+     *
+     * @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");
+        }
+        else {
+            this.middlewares.push(middleware);
+        }
+    }
+    /**
+     * Retrieves all the middlewares that have been added to the collection.
+     *
+     * @returns An array of Express request handlers representing the middlewares.
+     */
+    getMiddlewares() {
+        return this.middlewares;
+    }
+    /**
+     * Gets the configured error handler middleware.
+     *
+     * @returns The error handler middleware.
+     */
+    getErrorHandler() {
+        return this.errorHandler;
+    }
+};
+exports.Middleware = Middleware;
+exports.Middleware = Middleware = Middleware_1 = __decorate([
+    (0, index_1.provideSingleton)(Middleware_1)
+], Middleware);

package/lib/cjs/provider/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidateDTO = exports.EnvValidatorProvider = exports.Logger = exports.Provider = void 0;
+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");
 Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_service_1.Logger; } });
 var env_validator_provider_1 = require("./environment/env-validator.provider");
-Object.defineProperty(exports, "EnvValidatorProvider", { enumerable: true, get: function () { return env_validator_provider_1.EnvValidatorProvider; } });
+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; } });

package/lib/cjs/types/application/application-factory.d.ts

@@ -0,0 +1,34 @@
+import express from "express";
+import { Container } from "inversify";
+import { AppExpress, IApplicationExpress } from "@expressots/adapter-express";
+/**
+ * AppFactory Class
+ *
+ * Responsible for creating an instance of the Application,
+ * either using a custom application type or with provided middlewares.
+ */
+declare class AppFactory {
+    private static logger;
+    /**
+     * Creates an instance of the application using a custom application type.
+     * @param container - InversifyJS container to resolve dependencies.
+     * @param CustomAppType - Custom application class extending Application.
+     * @returns Instance of the application.
+     */
+    static create(container: Container, CustomAppType: new () => AppExpress, httpServerFactory?: new () => AppExpress): Promise<IApplicationExpress>;
+    /**
+     * Creates an instance of the application with provided middlewares.
+     * @param container - InversifyJS container to resolve dependencies.
+     * @param middlewares - Array of Express middlewares to be applied.
+     * @returns Instance of the application.
+     */
+    static create(container: Container, middlewares: Array<express.RequestHandler>, httpServerFactory?: new () => AppExpress): Promise<AppExpress>;
+    /**
+     * Checks if the provided parameter is a custom application type.
+     * @param appTypeOrMiddlewares - Custom application class or array of middlewares.
+     * @returns True if the provided parameter is a custom application type.
+     */
+    private static isOpinionated;
+}
+export { AppFactory };
+//# sourceMappingURL=application-factory.d.ts.map

package/lib/cjs/types/application/application-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-factory.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/application/application-factory.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAK9E;;;;;GAKG;AACH,cAAM,UAAU;IACd,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwB;IAC7C;;;;;OAKG;WACiB,MAAM,CACxB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,UAAU,UAAU,EACnC,iBAAiB,CAAC,EAAE,UAAU,UAAU,GACvC,OAAO,CAAC,mBAAmB,CAAC;IAO/B;;;;;OAKG;WACiB,MAAM,CACxB,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAC1C,iBAAiB,CAAC,EAAE,UAAU,UAAU,GACvC,OAAO,CAAC,UAAU,CAAC;IA+DtB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAK7B;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -1,3 +1,3 @@
-export { AppInstance, Application, ServerEnvironment } from "./application";
 export { AppContainer } from "./app-container";
+export { AppFactory } from "./application-factory";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/application/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/application/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/cjs/types/controller/base-controller.d.ts

@@ -1,31 +1,25 @@
 import { Response } from "express";
-import { interfaces } from "inversify-express-utils";
+import { Controller } from "@expressots/adapter-express";
 /**
  * The BaseController class is an abstract base class for controllers.
  * It provides methods for handling use case calls and sending appropriate responses.
  * @provide BaseController
  */
-declare abstract class BaseController implements interfaces.Controller {
-    private serviceName;
-    /**
-     * Constructs a new BaseController instance with a specified service name.
-     * @param serviceName - The name of the service associated with the controller.
-     */
-    constructor(serviceName?: string);
+declare abstract class BaseController implements Controller {
     /**
      * Calls an asynchronous use case and sends an appropriate response based on the result.
      * @param useCase - A promise representing the asynchronous use case to call.
      * @param res - The Express response object.
      * @param successStatusCode - The HTTP status code to return upon successful execution.
      */
-    protected callUseCaseAsync(useCase: Promise<any>, res: any, successStatusCode: number): Promise<any>;
+    protected callUseCaseAsync(useCase: Promise<any>, res: Response, successStatusCode: number): Promise<any>;
     /**
      * Calls a use case and sends an appropriate response based on the result.
      * @param useCase - The use case to call.
      * @param res - The Express response object.
      * @param successStatusCode - The HTTP status code to return upon successful execution.
      */
-    protected callUseCase(useCase: any, res: any, successStatusCode: number): any;
+    protected callUseCase(useCase: any, res: Response, successStatusCode: number): any;
     /**
      * Synchronously renders a template with the given options using the Express `Response` object's render method.
      *

package/lib/cjs/types/controller/base-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-controller.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/controller/base-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD;;;;GAIG;AACH,uBACe,cAAe,YAAW,UAAU,CAAC,UAAU;IAC5D,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;gBACS,WAAW,GAAE,MAAW;IAIpC;;;;;OAKG;cACa,gBAAgB,CAC9B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,GAAG,EAAE,GAAG,EACR,iBAAiB,EAAE,MAAM;IAK3B;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,iBAAiB,EAAE,MAAM;IAIvE;;;;;;;;;;OAUG;IACH,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,GAAG,IAAI;IAI5E;;;;;;;;;;OAUG;IACH,SAAS,CAAC,kBAAkB,CAC1B,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,KAAK,GACX,OAAO,CAAC,MAAM,CAAC;CAUnB;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"base-controller.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/controller/base-controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD;;;;GAIG;AACH,uBACe,cAAe,YAAW,UAAU;IACjD;;;;;OAKG;cACa,gBAAgB,CAC9B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,EACrB,GAAG,EAAE,QAAQ,EACb,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,GAAG,CAAC;IAIf;;;;;OAKG;IACH,SAAS,CAAC,WAAW,CACnB,OAAO,EAAE,GAAG,EACZ,GAAG,EAAE,QAAQ,EACb,iBAAiB,EAAE,MAAM,GACxB,GAAG;IAIN;;;;;;;;;;OAUG;IACH,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,GAAG,IAAI;IAI5E;;;;;;;;;;OAUG;IACH,SAAS,CAAC,kBAAkB,CAC1B,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,KAAK,GACX,OAAO,CAAC,MAAM,CAAC;CAUnB;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}