@expressots/adapter-express 1.1.0 → 1.2.0

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

@@ -1,152 +0,0 @@
-"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 };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServerEnvironment = exports.AppExpress = void 0;
-const inversify_binding_decorators_1 = require("inversify-binding-decorators");
-const process_1 = __importDefault(require("process"));
-const core_1 = require("@expressots/core");
-const inversify_express_server_1 = require("./express-utils/inversify-express-server");
-const application_base_1 = require("./application-base");
-/**
- * Enum representing possible server environments.
- */
-var ServerEnvironment;
-(function (ServerEnvironment) {
-    ServerEnvironment["Development"] = "development";
-    ServerEnvironment["Production"] = "production";
-})(ServerEnvironment || (exports.ServerEnvironment = ServerEnvironment = {}));
-/**
- * The Application class provides a way to configure and manage an Express application.
- * @provide Application
- */
-let ApplicationExpress = class ApplicationExpress extends application_base_1.ApplicationBase {
-    app;
-    port;
-    environment;
-    container;
-    middlewares = [];
-    configureServices() { }
-    postServerInitialization() { }
-    serverShutdown() { }
-    /**
-     * Handles process exit by calling serverShutdown and then exiting the process.
-     */
-    handleExit() {
-        this.serverShutdown();
-        process_1.default.exit(0);
-    }
-    /**
-     * Create and configure the Express application.
-     * @param container - The InversifyJS container.
-     * @param middlewares - An array of Express middlewares to be applied.
-     * @returns The configured Application instance.
-     */
-    async create(container, middlewares = []) {
-        this.container = container;
-        await Promise.resolve(this.configureServices());
-        const middleware = container.get(core_1.Middleware);
-        const sortedMiddlewarePipeline = middleware.getMiddlewarePipeline();
-        const pipeline = sortedMiddlewarePipeline.map((entry) => entry.middleware);
-        this.middlewares.push(...middlewares, ...pipeline);
-        const allMiddlewareEntries = [...this.middlewares];
-        const expressServer = new inversify_express_server_1.InversifyExpressServer(container);
-        expressServer.setConfig((app) => {
-            allMiddlewareEntries.forEach((entry) => {
-                if (typeof entry === "function") {
-                    app.use(entry);
-                }
-                else {
-                    const { path, middlewares } = entry;
-                    middlewares.forEach((middleware) => {
-                        if (path) {
-                            app.use(path, middleware);
-                        }
-                        else {
-                            app.use(middleware);
-                        }
-                    });
-                }
-            });
-        });
-        expressServer.setErrorConfig((app) => {
-            if (middleware.getErrorHandler()) {
-                app.use(middleware.getErrorHandler());
-            }
-        });
-        this.app = expressServer.build();
-        return this;
-    }
-    /**
-     * Start listening on the given port and environment.
-     * @param port - The port number to listen on.
-     * @param environment - The server environment.
-     * @param consoleMessage - Optional message to display in the console.
-     */
-    async listen(port, environment, consoleMessage) {
-        this.port = port;
-        this.environment = environment;
-        this.app.set("env", environment);
-        this.app.listen(this.port, () => {
-            const console = this.container.get(core_1.Console);
-            console.messageServer(this.port, this.environment, consoleMessage);
-            ["SIGTERM", "SIGHUP", "SIGBREAK", "SIGQUIT", "SIGINT"].forEach((signal) => {
-                process_1.default.on(signal, this.handleExit.bind(this));
-            });
-        });
-        await Promise.resolve(this.postServerInitialization());
-    }
-    /**
-     * Configures the application's view engine based on the provided configuration options.
-     *
-     * @public
-     * @method setEngine
-     * @template T - A generic type extending from RenderTemplateOptions.
-     *
-     * @param {T} options - An object of type T (must be an object that extends RenderTemplateOptions)
-     *                      that provides the configuration options for setting the view engine.
-     *                      This includes the extension name, view path, and the engine function itself.
-     */
-    setEngine(options) {
-        if ("extName" in options) {
-            const { extName, viewPath, engine } = options;
-            this.app.engine(extName, engine);
-            this.app.set("view engine", extName);
-            this.app.set("views", viewPath);
-        }
-    }
-    /**
-     * Verifies if the current environment is development.
-     *
-     * @returns A boolean value indicating whether the current environment is development or not.
-     */
-    isDevelopment() {
-        if (this.app) {
-            return this.app.get("env") === ServerEnvironment.Development;
-        }
-        this.container
-            .get(core_1.Logger)
-            .error("isDevelopment() method must be called on `PostServerInitialization`", "application");
-        return false;
-    }
-    /**
-     * Verifies if the current environment is production.
-     *
-     * @returns A boolean value indicating whether the current environment is production or not.
-     *
-     */
-    get ExpressApp() {
-        return this.app;
-    }
-};
-exports.AppExpress = ApplicationExpress;
-exports.AppExpress = ApplicationExpress = __decorate([
-    (0, inversify_binding_decorators_1.provide)(ApplicationExpress)
-], ApplicationExpress);

package/lib/esm/adapter-express/express-utils/base-middleware.js

@@ -1,22 +0,0 @@
-"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;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseMiddleware = void 0;
-const inversify_1 = require("inversify");
-let BaseMiddleware = class BaseMiddleware {
-    // httpContext is initialized when the middleware is invoked
-    // see resolveMiddleware in server.ts for more details
-    httpContext;
-    bind(serviceIdentifier) {
-        return this.httpContext.container.bind(serviceIdentifier);
-    }
-};
-exports.BaseMiddleware = BaseMiddleware;
-exports.BaseMiddleware = BaseMiddleware = __decorate([
-    (0, inversify_1.injectable)()
-], BaseMiddleware);

package/lib/esm/adapter-express/express-utils/constants.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_ROUTING_ROOT_PATH = exports.NO_CONTROLLERS_FOUND = exports.DUPLICATED_CONTROLLER_NAME = exports.HTTP_VERBS_ENUM = exports.PARAMETER_TYPE = exports.METADATA_KEY = exports.TYPE = void 0;
-exports.TYPE = {
-    AuthProvider: Symbol.for("AuthProvider"),
-    Controller: Symbol.for("Controller"),
-    HttpContext: Symbol.for("HttpContext"),
-};
-exports.METADATA_KEY = {
-    controller: "inversify-express-utils:controller",
-    controllerMethod: "inversify-express-utils:controller-method",
-    controllerParameter: "inversify-express-utils:controller-parameter",
-    httpContext: "inversify-express-utils:httpcontext",
-};
-var PARAMETER_TYPE;
-(function (PARAMETER_TYPE) {
-    PARAMETER_TYPE[PARAMETER_TYPE["REQUEST"] = 0] = "REQUEST";
-    PARAMETER_TYPE[PARAMETER_TYPE["RESPONSE"] = 1] = "RESPONSE";
-    PARAMETER_TYPE[PARAMETER_TYPE["PARAMS"] = 2] = "PARAMS";
-    PARAMETER_TYPE[PARAMETER_TYPE["QUERY"] = 3] = "QUERY";
-    PARAMETER_TYPE[PARAMETER_TYPE["BODY"] = 4] = "BODY";
-    PARAMETER_TYPE[PARAMETER_TYPE["HEADERS"] = 5] = "HEADERS";
-    PARAMETER_TYPE[PARAMETER_TYPE["COOKIES"] = 6] = "COOKIES";
-    PARAMETER_TYPE[PARAMETER_TYPE["NEXT"] = 7] = "NEXT";
-    PARAMETER_TYPE[PARAMETER_TYPE["PRINCIPAL"] = 8] = "PRINCIPAL";
-})(PARAMETER_TYPE || (exports.PARAMETER_TYPE = PARAMETER_TYPE = {}));
-var HTTP_VERBS_ENUM;
-(function (HTTP_VERBS_ENUM) {
-    HTTP_VERBS_ENUM["all"] = "ALL";
-    HTTP_VERBS_ENUM["connect"] = "CONNECT";
-    HTTP_VERBS_ENUM["delete"] = "DELETE";
-    HTTP_VERBS_ENUM["get"] = "GET";
-    HTTP_VERBS_ENUM["head"] = "HEAD";
-    HTTP_VERBS_ENUM["options"] = "OPTIONS";
-    HTTP_VERBS_ENUM["patch"] = "PATCH";
-    HTTP_VERBS_ENUM["post"] = "POST";
-    HTTP_VERBS_ENUM["propfind"] = "PROPFIND";
-    HTTP_VERBS_ENUM["put"] = "PUT";
-    HTTP_VERBS_ENUM["trace"] = "TRACE";
-})(HTTP_VERBS_ENUM || (exports.HTTP_VERBS_ENUM = HTTP_VERBS_ENUM = {}));
-const DUPLICATED_CONTROLLER_NAME = (name) => `Two controllers cannot have the same name: ${name}`;
-exports.DUPLICATED_CONTROLLER_NAME = DUPLICATED_CONTROLLER_NAME;
-exports.NO_CONTROLLERS_FOUND = "No controllers" +
-    "have been found! Please ensure that you have register" +
-    "at least one Controller.";
-exports.DEFAULT_ROUTING_ROOT_PATH = "/";

package/lib/esm/adapter-express/express-utils/content/httpContent.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpContent = void 0;
-class HttpContent {
-    _headers = {};
-    get headers() {
-        return this._headers;
-    }
-}
-exports.HttpContent = HttpContent;

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

@@ -1,110 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.params = exports.Principal = exports.next = exports.cookies = exports.headers = exports.body = exports.query = exports.param = exports.response = exports.request = exports.httpMethod = exports.Delete = exports.Head = exports.Patch = exports.Put = exports.Post = exports.Get = exports.all = exports.controller = exports.injectHttpContext = void 0;
-require("reflect-metadata");
-const inversify_1 = require("inversify");
-const constants_1 = require("./constants");
-exports.injectHttpContext = (0, inversify_1.inject)(constants_1.TYPE.HttpContext);
-function controller(path, ...middleware) {
-    return (target) => {
-        const currentMetadata = {
-            middleware,
-            path,
-            target,
-        };
-        (0, inversify_1.decorate)((0, inversify_1.injectable)(), target);
-        Reflect.defineMetadata(constants_1.METADATA_KEY.controller, currentMetadata, target);
-        const previousMetadata = Reflect.getMetadata(constants_1.METADATA_KEY.controller, Reflect) || [];
-        const newMetadata = [currentMetadata, ...previousMetadata];
-        Reflect.defineMetadata(constants_1.METADATA_KEY.controller, newMetadata, Reflect);
-    };
-}
-exports.controller = controller;
-function all(path, ...middleware) {
-    return httpMethod("all", path, ...middleware);
-}
-exports.all = all;
-function Get(path, ...middleware) {
-    return httpMethod("get", path, ...middleware);
-}
-exports.Get = Get;
-function Post(path, ...middleware) {
-    return httpMethod("post", path, ...middleware);
-}
-exports.Post = Post;
-function Put(path, ...middleware) {
-    return httpMethod("put", path, ...middleware);
-}
-exports.Put = Put;
-function Patch(path, ...middleware) {
-    return httpMethod("patch", path, ...middleware);
-}
-exports.Patch = Patch;
-function Head(path, ...middleware) {
-    return httpMethod("head", path, ...middleware);
-}
-exports.Head = Head;
-function Delete(path, ...middleware) {
-    return httpMethod("delete", path, ...middleware);
-}
-exports.Delete = Delete;
-function httpMethod(method, path, ...middleware) {
-    return (target, key) => {
-        const metadata = {
-            key,
-            method,
-            middleware,
-            path,
-            target,
-        };
-        let metadataList = [];
-        if (!Reflect.hasOwnMetadata(constants_1.METADATA_KEY.controllerMethod, target.constructor)) {
-            Reflect.defineMetadata(constants_1.METADATA_KEY.controllerMethod, metadataList, target.constructor);
-        }
-        else {
-            metadataList = Reflect.getOwnMetadata(constants_1.METADATA_KEY.controllerMethod, target.constructor);
-        }
-        metadataList.push(metadata);
-    };
-}
-exports.httpMethod = httpMethod;
-/*
- * Parameter Decorators
- */
-exports.request = paramDecoratorFactory(constants_1.PARAMETER_TYPE.REQUEST);
-exports.response = paramDecoratorFactory(constants_1.PARAMETER_TYPE.RESPONSE);
-exports.param = paramDecoratorFactory(constants_1.PARAMETER_TYPE.PARAMS);
-exports.query = paramDecoratorFactory(constants_1.PARAMETER_TYPE.QUERY);
-exports.body = paramDecoratorFactory(constants_1.PARAMETER_TYPE.BODY);
-exports.headers = paramDecoratorFactory(constants_1.PARAMETER_TYPE.HEADERS);
-exports.cookies = paramDecoratorFactory(constants_1.PARAMETER_TYPE.COOKIES);
-exports.next = paramDecoratorFactory(constants_1.PARAMETER_TYPE.NEXT);
-exports.Principal = paramDecoratorFactory(constants_1.PARAMETER_TYPE.PRINCIPAL);
-function paramDecoratorFactory(parameterType) {
-    return (name) => params(parameterType, name);
-}
-function params(type, parameterName) {
-    return (target, methodName, index) => {
-        let metadataList = {};
-        let parameterMetadataList = [];
-        const parameterMetadata = {
-            index,
-            injectRoot: parameterName === undefined,
-            parameterName,
-            type,
-        };
-        if (!Reflect.hasOwnMetadata(constants_1.METADATA_KEY.controllerParameter, target.constructor)) {
-            parameterMetadataList.unshift(parameterMetadata);
-        }
-        else {
-            metadataList = Reflect.getOwnMetadata(constants_1.METADATA_KEY.controllerParameter, target.constructor);
-            if (metadataList[methodName]) {
-                parameterMetadataList = metadataList[methodName] || [];
-            }
-            parameterMetadataList.unshift(parameterMetadata);
-        }
-        metadataList[methodName] = parameterMetadataList;
-        Reflect.defineMetadata(constants_1.METADATA_KEY.controllerParameter, metadataList, target.constructor);
-    };
-}
-exports.params = params;

package/lib/esm/adapter-express/express-utils/httpResponseMessage.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpResponseMessage = void 0;
-class HttpResponseMessage {
-    _content;
-    _headers = {};
-    get headers() {
-        return this._headers;
-    }
-    set headers(headers) {
-        this._headers = headers;
-    }
-    get content() {
-        return this._content;
-    }
-    set content(value) {
-        this._content = value;
-    }
-    _statusCode;
-    get statusCode() {
-        return this._statusCode;
-    }
-    set statusCode(code) {
-        if (code < 0 || code > 999) {
-            throw new Error(`${code} is not a valid status code`);
-        }
-        this._statusCode = code;
-    }
-    constructor(statusCode = 200) {
-        this.statusCode = statusCode;
-    }
-}
-exports.HttpResponseMessage = HttpResponseMessage;

package/lib/esm/adapter-express/express-utils/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./decorators"), exports);

package/lib/esm/adapter-express/express-utils/interfaces.js

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