@expressots/core 2.3.0 → 2.4.0

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

@@ -1,44 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-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();
-};
-exports.provideTransient = provideTransient;

package/lib/esm/error/app-error.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppError = void 0;
-/**
- * The AppError class extends the built-in Error class in JavaScript,
- * providing additional properties to manage custom application errors.
- * It captures detailed information about the error, including a status code
- * and an optional service identifier, which can be useful for error handling
- * and logging within the application.
- *
- * @extends {Error}
- */
-class AppError extends Error {
-    /**
-     * The HTTP status code associated with the error.
-     * Commonly used to define the HTTP response status code.
-     */
-    statusCode;
-    /**
-     * The service identifier associated with the error.
-     * This property can be used to trace the origin of the error in the application.
-     * It is optional and can be left undefined.
-     */
-    service;
-    /**
-     * @param {string} message - The error message to be displayed.
-     * @param {number} [statusCode=500] - The HTTP status code associated with the error (default: 500).
-     * @param {string} [service] - The service identifier associated with the error.
-     */
-    constructor(message, statusCode = 500, service) {
-        super(message);
-        this.statusCode = statusCode;
-        this.service = service;
-        Error.captureStackTrace(this, this.constructor);
-    }
-}
-exports.AppError = AppError;

package/lib/esm/error/error-handler-middleware.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const app_error_1 = require("./app-error");
-const status_code_1 = require("./status-code");
-/**
- * errorHandler is a custom Express error-handling middleware function.
- * It logs the error, sets the status code, and sends a JSON response containing the status code and error message.
- * @param error - An instance of IAppError containing error details.
- * @param req - The Express request object.
- * @param res - The Express response object.
- * @param next - The Express next function for passing control to the next middleware function.
- */
-function defaultErrorHandler(error, req, res, 
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-next) {
-    if (error instanceof app_error_1.AppError) {
-        res
-            .status(error.statusCode)
-            .json({ statusCode: error.statusCode, error: error.message });
-    }
-    else {
-        res.status(status_code_1.StatusCode.InternalServerError).json({
-            statusCode: status_code_1.StatusCode.InternalServerError,
-            error: "An unexpected error occurred.",
-        });
-    }
-}
-exports.default = defaultErrorHandler;

package/lib/esm/error/index.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppError = exports.Report = exports.StatusCode = void 0;
-var status_code_1 = require("./status-code");
-Object.defineProperty(exports, "StatusCode", { enumerable: true, get: function () { return status_code_1.StatusCode; } });
-var report_1 = require("./report");
-Object.defineProperty(exports, "Report", { enumerable: true, get: function () { return report_1.Report; } });
-var app_error_1 = require("./app-error");
-Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return app_error_1.AppError; } });

package/lib/esm/error/report.js

@@ -1,57 +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 __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var Report_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Report = void 0;
-const inversify_binding_decorators_1 = require("inversify-binding-decorators");
-const logger_service_1 = require("../provider/logger/logger-service");
-const app_error_1 = require("./app-error");
-/**
- * Report class is a utility class to manage and log errors within the application.
- * It is responsible for creating a standardized error object, logging it,
- * and then throwing the error for further handling.
- */
-let Report = class Report {
-    static { Report_1 = this; }
-    static stack;
-    logger;
-    constructor() {
-        this.logger = new logger_service_1.Logger();
-    }
-    /**
-     * The Error method is responsible for generating a standardized error object,
-     * logging the error, and then throwing it for further handling.
-     * The error thrown is of the custom type AppError, which extends the built-in Error class.
-     *
-     * @param error - An instance of Error or a string that describes the error.
-     * @param statusCode - The HTTP status code associated with the error (default is 500).
-     * @param service - The service name associated with the error. If not specified,
-     *                  it defaults to the name of the calling function.
-     *
-     * @throws An object of the custom type AppError, which includes details about the error.
-     */
-    error(error, statusCode, service) {
-        let appError = {};
-        if (error instanceof Error) {
-            appError = new app_error_1.AppError(error.message, statusCode, service);
-        }
-        else {
-            appError = new app_error_1.AppError(error, statusCode, service);
-        }
-        this.logger.error(appError.message, appError.service || "service-undefined");
-        return appError;
-    }
-};
-exports.Report = Report;
-exports.Report = Report = Report_1 = __decorate([
-    (0, inversify_binding_decorators_1.provide)(Report_1),
-    __metadata("design:paramtypes", [])
-], Report);

package/lib/esm/error/status-code.js

@@ -1,89 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StatusCode = void 0;
-/* Http Error Code Response */
-var InformationResponse;
-(function (InformationResponse) {
-    InformationResponse[InformationResponse["Continue"] = 100] = "Continue";
-    InformationResponse[InformationResponse["SwitchingProtocols"] = 101] = "SwitchingProtocols";
-    InformationResponse[InformationResponse["Processing"] = 102] = "Processing";
-    InformationResponse[InformationResponse["eEarlyHints"] = 103] = "eEarlyHints";
-})(InformationResponse || (InformationResponse = {}));
-var SuccessfulResponse;
-(function (SuccessfulResponse) {
-    SuccessfulResponse[SuccessfulResponse["OK"] = 200] = "OK";
-    SuccessfulResponse[SuccessfulResponse["Created"] = 201] = "Created";
-    SuccessfulResponse[SuccessfulResponse["Accepted"] = 202] = "Accepted";
-    SuccessfulResponse[SuccessfulResponse["NonAuthoritativeInformation"] = 203] = "NonAuthoritativeInformation";
-    SuccessfulResponse[SuccessfulResponse["NoContent"] = 204] = "NoContent";
-    SuccessfulResponse[SuccessfulResponse["ResetContent"] = 205] = "ResetContent";
-    SuccessfulResponse[SuccessfulResponse["PartialContent"] = 206] = "PartialContent";
-    SuccessfulResponse[SuccessfulResponse["MultiStatus"] = 207] = "MultiStatus";
-    SuccessfulResponse[SuccessfulResponse["AlreadyReported"] = 208] = "AlreadyReported";
-    SuccessfulResponse[SuccessfulResponse["IMUsed"] = 226] = "IMUsed";
-})(SuccessfulResponse || (SuccessfulResponse = {}));
-var RedirectionMessage;
-(function (RedirectionMessage) {
-    RedirectionMessage[RedirectionMessage["MultipleChoices"] = 300] = "MultipleChoices";
-    RedirectionMessage[RedirectionMessage["MovedPermanently"] = 301] = "MovedPermanently";
-    RedirectionMessage[RedirectionMessage["Found"] = 302] = "Found";
-    RedirectionMessage[RedirectionMessage["SeeOther"] = 303] = "SeeOther";
-    RedirectionMessage[RedirectionMessage["NotModified"] = 304] = "NotModified";
-    RedirectionMessage[RedirectionMessage["TemporaryRedirect"] = 307] = "TemporaryRedirect";
-    RedirectionMessage[RedirectionMessage["PermanentRedirect"] = 308] = "PermanentRedirect";
-})(RedirectionMessage || (RedirectionMessage = {}));
-var ClientErrorResponse;
-(function (ClientErrorResponse) {
-    ClientErrorResponse[ClientErrorResponse["BadRequest"] = 400] = "BadRequest";
-    ClientErrorResponse[ClientErrorResponse["Unauthorized"] = 401] = "Unauthorized";
-    ClientErrorResponse[ClientErrorResponse["PaymentRequired"] = 402] = "PaymentRequired";
-    ClientErrorResponse[ClientErrorResponse["Forbidden"] = 403] = "Forbidden";
-    ClientErrorResponse[ClientErrorResponse["NotFound"] = 404] = "NotFound";
-    ClientErrorResponse[ClientErrorResponse["MethodNotAllowed"] = 405] = "MethodNotAllowed";
-    ClientErrorResponse[ClientErrorResponse["NotAcceptable"] = 406] = "NotAcceptable";
-    ClientErrorResponse[ClientErrorResponse["ProxyAuthenticationRequired"] = 407] = "ProxyAuthenticationRequired";
-    ClientErrorResponse[ClientErrorResponse["RequestTimeout"] = 408] = "RequestTimeout";
-    ClientErrorResponse[ClientErrorResponse["Conflict"] = 409] = "Conflict";
-    ClientErrorResponse[ClientErrorResponse["Gone"] = 410] = "Gone";
-    ClientErrorResponse[ClientErrorResponse["LengthRequired"] = 411] = "LengthRequired";
-    ClientErrorResponse[ClientErrorResponse["PreconditionFailed"] = 412] = "PreconditionFailed";
-    ClientErrorResponse[ClientErrorResponse["PayloadTooLarge"] = 413] = "PayloadTooLarge";
-    ClientErrorResponse[ClientErrorResponse["URITooLong"] = 414] = "URITooLong";
-    ClientErrorResponse[ClientErrorResponse["UnsupportedMediaType"] = 415] = "UnsupportedMediaType";
-    ClientErrorResponse[ClientErrorResponse["RangeNotSatisfiable"] = 416] = "RangeNotSatisfiable";
-    ClientErrorResponse[ClientErrorResponse["ExpectationFailed"] = 417] = "ExpectationFailed";
-    ClientErrorResponse[ClientErrorResponse["ImATeapot"] = 418] = "ImATeapot";
-    ClientErrorResponse[ClientErrorResponse["MisdirectedRequest"] = 421] = "MisdirectedRequest";
-    ClientErrorResponse[ClientErrorResponse["UnprocessableEntity"] = 422] = "UnprocessableEntity";
-    ClientErrorResponse[ClientErrorResponse["Locked"] = 423] = "Locked";
-    ClientErrorResponse[ClientErrorResponse["FailedDependency"] = 424] = "FailedDependency";
-    ClientErrorResponse[ClientErrorResponse["TooEarly"] = 425] = "TooEarly";
-    ClientErrorResponse[ClientErrorResponse["UpgradeRequired"] = 426] = "UpgradeRequired";
-    ClientErrorResponse[ClientErrorResponse["PreconditionRequired"] = 428] = "PreconditionRequired";
-    ClientErrorResponse[ClientErrorResponse["TooManyRequests"] = 429] = "TooManyRequests";
-    ClientErrorResponse[ClientErrorResponse["RequestHeaderFieldsTooLarge"] = 431] = "RequestHeaderFieldsTooLarge";
-    ClientErrorResponse[ClientErrorResponse["UnavailableForLegalReasons"] = 451] = "UnavailableForLegalReasons";
-})(ClientErrorResponse || (ClientErrorResponse = {}));
-var ServerErrorResponse;
-(function (ServerErrorResponse) {
-    ServerErrorResponse[ServerErrorResponse["InternalServerError"] = 500] = "InternalServerError";
-    ServerErrorResponse[ServerErrorResponse["NotImplemented"] = 501] = "NotImplemented";
-    ServerErrorResponse[ServerErrorResponse["BadGateway"] = 502] = "BadGateway";
-    ServerErrorResponse[ServerErrorResponse["ServiceUnavailable"] = 503] = "ServiceUnavailable";
-    ServerErrorResponse[ServerErrorResponse["GatewayTimeout"] = 504] = "GatewayTimeout";
-    ServerErrorResponse[ServerErrorResponse["HTTPVersionNotSupported"] = 505] = "HTTPVersionNotSupported";
-    ServerErrorResponse[ServerErrorResponse["VariantAlsoNegotiates"] = 506] = "VariantAlsoNegotiates";
-    ServerErrorResponse[ServerErrorResponse["InsufficientStorage"] = 507] = "InsufficientStorage";
-    ServerErrorResponse[ServerErrorResponse["LoopDetected"] = 508] = "LoopDetected";
-    ServerErrorResponse[ServerErrorResponse["NotExtended"] = 510] = "NotExtended";
-    ServerErrorResponse[ServerErrorResponse["NetworkAuthenticationRequired"] = 511] = "NetworkAuthenticationRequired";
-})(ServerErrorResponse || (ServerErrorResponse = {}));
-const HttpStatusErrorCode = {
-    ...InformationResponse,
-    ...SuccessfulResponse,
-    ...RedirectionMessage,
-    ...ClientErrorResponse,
-    ...ServerErrorResponse,
-};
-const StatusCode = { ...HttpStatusErrorCode };
-exports.StatusCode = StatusCode;

package/lib/esm/index.mjs

@@ -1,26 +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("./application"), exports);
-__exportStar(require("./common"), exports);
-__exportStar(require("./console"), exports);
-__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/esm/middleware/index.js

@@ -1,29 +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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IMorgan = exports.Middleware = void 0;
-var middleware_service_1 = require("./middleware-service");
-Object.defineProperty(exports, "Middleware", { enumerable: true, get: function () { return middleware_service_1.Middleware; } });
-exports.IMorgan = __importStar(require("./interfaces/morgan.interface"));

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

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

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

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

package/lib/esm/middleware/interfaces/cookie-parser.interface.js

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

package/lib/esm/middleware/interfaces/cookie-session/cookie-session.interface.js

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

package/lib/esm/middleware/interfaces/cookie-session/keygrip.interface.js

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

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

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

package/lib/esm/middleware/interfaces/morgan.interface.js

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

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

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

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

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

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

@@ -1,69 +0,0 @@
-"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 {
-    logger;
-    constructor() {
-        this.logger = new logger_service_1.Logger();
-    }
-    /**
-     * 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.
-     */
-    middlewareRegistry = {
-        cors: "cors",
-        compression: "compression",
-        cookieParser: "cookie-parser",
-        cookieSession: "cookie-session",
-        serveFavicon: "serve-favicon",
-        morgan: "morgan",
-        // Add other middlewares
-    };
-    /**
-     * 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) {
-            this.logger.error(`Middleware ${packageName} not found`, "middleware-resolver");
-            return null;
-        }
-        let hasMiddleware = "";
-        try {
-            hasMiddleware = require.resolve(packageName, { paths: [process.cwd()] });
-        }
-        catch (error) {
-            this.logger.warn(`Middleware [${packageName}] 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;