@expressots/core 1.8.1 → 1.9.0

package/lib/CHANGELOG.md

@@ -1,15 +1,38 @@
 
 
-## [1.8.1](https://github.com/expressots/expressots/compare/1.8.0...1.8.1) (2023-09-10)
+## [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
 
-* 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))
+* 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))
 
 
-### Continuous Integrations
+### 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))
 
 ## [1.8.0](https://github.com/expressots/expressots/compare/1.7.0...1.8.0) (2023-09-05)

package/lib/cjs/common/color-service.provider.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bgColorCodes = exports.colorCodes = exports.ColorStyle = void 0;
+/**
+ * Mapping of text color codes.
+ *
+ * @remarks
+ * Defines the ANSI escape codes for the corresponding colors in the terminal.
+ */
+const colorCodes = {
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    white: "\x1b[37m",
+    black: "\x1b[30m",
+    none: "\x1b[0m",
+};
+exports.colorCodes = colorCodes;
+/**
+ * ANSI escape color codes mapping for different background colors.
+ */
+const bgColorCodes = {
+    red: "\x1b[41m",
+    green: "\x1b[42m",
+    yellow: "\x1b[43m",
+    blue: "\x1b[44m",
+    white: "\x1b[47m",
+    black: "\x1b[40m",
+    none: "\x1b[0m",
+};
+exports.bgColorCodes = bgColorCodes;
+/**
+ * Enum representing possible color styles for console output.
+ *
+ * @remarks
+ * Enum values correspond to the string representations of colors.
+ */
+var ColorStyle;
+(function (ColorStyle) {
+    ColorStyle["None"] = "none";
+    ColorStyle["Yellow"] = "yellow";
+    ColorStyle["Blue"] = "blue";
+    ColorStyle["Green"] = "green";
+    ColorStyle["Red"] = "red";
+})(ColorStyle || (exports.ColorStyle = ColorStyle = {}));

package/lib/cjs/common/package-resolver.provider.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.packageResolver = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const logger_service_1 = require("../provider/logger/logger-service");
+/**
+ * Resolve package from the current working directory.
+ * @param packageName
+ * @param options
+ * @returns
+ */
+function packageResolver(packageName, ...options) {
+    const logger = new logger_service_1.Logger();
+    try {
+        const hasPackage = require.resolve(packageName, {
+            paths: [process.cwd()],
+        });
+        if (hasPackage) {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const packageResolved = require(hasPackage);
+            if (typeof packageResolved === "function") {
+                return packageResolved(...options);
+            }
+            if (packageResolved.default &&
+                typeof packageResolved.default === "function") {
+                return packageResolved.default(...options);
+            }
+            return packageResolved;
+        }
+    }
+    catch (error) {
+        logger.warn(`Package [${packageName}] not installed. Please install it using your package manager.`, "package-resolver");
+    }
+}
+exports.packageResolver = packageResolver;

package/lib/cjs/console/console.js

@@ -14,25 +14,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 var Console_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Console = void 0;
-const chalk_1 = __importDefault(require("chalk"));
 const inversify_binding_decorators_1 = require("inversify-binding-decorators");
-/**
- * Enum representing possible color styles for console output.
- */
-var ColorStyle;
-(function (ColorStyle) {
-    ColorStyle[ColorStyle["None"] = 0] = "None";
-    ColorStyle[ColorStyle["Yellow"] = 1] = "Yellow";
-    ColorStyle[ColorStyle["Blue"] = 2] = "Blue";
-    ColorStyle[ColorStyle["Green"] = 3] = "Green";
-    ColorStyle[ColorStyle["Red"] = 4] = "Red";
-})(ColorStyle || (ColorStyle = {}));
+const color_service_provider_1 = require("../common/color-service.provider");
 /**
  * The Console class provides methods for displaying styled messages in the console.
  * @provide Console
@@ -45,16 +31,9 @@ let Console = Console_1 = class Console {
      */
     printColor(message, colorStyle) {
         return __awaiter(this, void 0, void 0, function* () {
-            switch (colorStyle) {
-                case ColorStyle.Yellow:
-                    return console.log(chalk_1.default.bgYellow.black(message));
-                case ColorStyle.Blue:
-                    return console.log(chalk_1.default.bgBlue.black(message));
-                case ColorStyle.Green:
-                    return console.log(chalk_1.default.bgGreen.black(message));
-                case ColorStyle.Red:
-                    return console.log(chalk_1.default.bgRed.black(message));
-            }
+            const textColor = "black";
+            const bgColor = colorStyle;
+            console.log(`${color_service_provider_1.bgColorCodes[bgColor]}${color_service_provider_1.colorCodes[textColor]}${message}\x1b[0m`);
         });
     }
     /**
@@ -63,27 +42,25 @@ let Console = Console_1 = class Console {
      * @param environment - The server environment.
      * @param consoleMessage - Optional application message details for console output.
      */
-    messageServer(
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    port, environment, consoleMessage) {
+    messageServer(port, environment, consoleMessage) {
         return __awaiter(this, void 0, void 0, function* () {
             const appConsoleMessage = {
                 appName: (consoleMessage === null || consoleMessage === void 0 ? void 0 : consoleMessage.appName) || "Application",
                 appVersion: (consoleMessage === null || consoleMessage === void 0 ? void 0 : consoleMessage.appVersion) || "not provided",
             };
-            let terminalColor = ColorStyle.None;
+            let terminalColor = color_service_provider_1.ColorStyle.None;
             switch (environment.toLowerCase()) {
                 case "development":
-                    terminalColor = ColorStyle.Yellow;
+                    terminalColor = color_service_provider_1.ColorStyle.Yellow;
                     break;
                 case "staging":
-                    terminalColor = ColorStyle.Blue;
+                    terminalColor = color_service_provider_1.ColorStyle.Blue;
                     break;
                 case "production":
-                    terminalColor = ColorStyle.Green;
+                    terminalColor = color_service_provider_1.ColorStyle.Green;
                     break;
                 default:
-                    terminalColor = ColorStyle.Red;
+                    terminalColor = color_service_provider_1.ColorStyle.Red;
                     break;
             }
             this.printColor(`${appConsoleMessage.appName} version ${appConsoleMessage.appVersion} is running on ` +

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

@@ -21,7 +21,6 @@ var BaseController_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseController = void 0;
 const inversify_binding_decorators_1 = require("inversify-binding-decorators");
-const logger_1 = require("../logger");
 /**
  * The BaseController class is an abstract base class for controllers.
  * It provides methods for handling use case calls and sending appropriate responses.
@@ -84,7 +83,6 @@ let BaseController = BaseController_1 = class BaseController {
         return new Promise((resolve, reject) => {
             res.render(template, options, (err, compiled) => {
                 if (err) {
-                    (0, logger_1.log)(logger_1.LogLevel.Error, err.message, "base-controller");
                     reject(err);
                 }
                 resolve(compiled);

package/lib/cjs/error/report.js

@@ -5,10 +5,14 @@ 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 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.
@@ -16,19 +20,22 @@ const app_error_1 = require("./app-error");
  * and then throwing the error for further handling.
  */
 let Report = Report_1 = class Report {
+    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 IAppError, which extends the built-in Error class.
+     * 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 IAppError, which includes details about the error.
+     * @throws An object of the custom type AppError, which includes details about the error.
      */
-    Error(error, statusCode, service) {
+    error(error, statusCode, service) {
         let appError = {};
         if (error instanceof Error) {
             appError = new app_error_1.AppError(error.message, statusCode, service);
@@ -36,10 +43,12 @@ let Report = Report_1 = class Report {
         else {
             appError = new app_error_1.AppError(error, statusCode, service);
         }
-        throw appError;
+        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)
+    (0, inversify_binding_decorators_1.provide)(Report_1),
+    __metadata("design:paramtypes", [])
 ], Report);

package/lib/cjs/index.js

@@ -20,7 +20,6 @@ __exportStar(require("./console"), exports);
 __exportStar(require("./container-module"), exports);
 __exportStar(require("./controller"), exports);
 __exportStar(require("./decorator"), exports);
-__exportStar(require("./environment"), exports);
 __exportStar(require("./error"), exports);
-__exportStar(require("./logger"), exports);
+__exportStar(require("./provider"), exports);
 __exportStar(require("./render"), exports);

package/lib/cjs/provider/dto-validator/dto-validator.provider.js

@@ -0,0 +1,62 @@
+"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.ValidateDTO = void 0;
+require("reflect-metadata");
+const status_code_1 = require("../../error/status-code");
+const package_resolver_provider_1 = require("../../common/package-resolver.provider");
+const logger_service_1 = require("../logger/logger-service");
+/**
+ * Validate the DTO using class-validator and class-transformer.
+ * @param type - The type of the DTO to validate.
+ * @returns A RequestHandler function.
+ * @throws An exception if the DTO is invalid.
+ *
+ */
+function ValidateDTO(type) {
+    return (req, res, next) => __awaiter(this, void 0, void 0, function* () {
+        const logger = new logger_service_1.Logger();
+        const classValidator = (0, package_resolver_provider_1.packageResolver)("class-validator");
+        const classTransformer = (0, package_resolver_provider_1.packageResolver)("class-transformer");
+        if (!classValidator || !classTransformer) {
+            return next();
+        }
+        try {
+            const errors = yield classValidator.validate(classTransformer.plainToClass(type, req.body));
+            if (errors.length > 0) {
+                const DTO = errors.reduce((acc, error) => {
+                    if (error.constraints) {
+                        const propertyName = error.property;
+                        if (!acc.some((e) => e.property === propertyName)) {
+                            acc.push({ property: propertyName, messages: [] });
+                        }
+                        const target = acc.find((e) => e.property === propertyName);
+                        target.messages.push(...Object.values(error.constraints));
+                    }
+                    return acc;
+                }, []);
+                res.status(status_code_1.StatusCode.BadRequest).json({
+                    errorCode: status_code_1.StatusCode.BadRequest,
+                    errorMessage: "Bad Request",
+                    DTO,
+                });
+            }
+            else {
+                next();
+            }
+        }
+        catch (error) {
+            logger.error(`An exception occurred while validating the DTO: ${error}`, "validate-dto-provider");
+            next(error);
+        }
+    });
+}
+exports.ValidateDTO = ValidateDTO;

package/lib/cjs/{environment/env-validator.js → provider/environment/env-validator.provider.js}

@@ -5,31 +5,36 @@ 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 __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 var EnvValidatorProvider_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Environments = void 0;
+exports.EnvValidatorProvider = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const dotenv_1 = __importDefault(require("dotenv"));
 const inversify_binding_decorators_1 = require("inversify-binding-decorators");
-const logger_1 = require("../logger");
+const logger_service_1 = require("../logger/logger-service");
 /**
  * The EnvValidatorProvider class provides utility methods for working with environment variables.
  * It validates, loads, and retrieves environment variables from the .env file.
  * @provide EnvValidatorProvider
  */
 let EnvValidatorProvider = EnvValidatorProvider_1 = class EnvValidatorProvider {
+    constructor() {
+        this.logger = new logger_service_1.Logger();
+    }
     /**
      * Retrieves the value of an environment variable, or a default value if the variable is not set.
      * @param key - The key of the environment variable.
      * @param defaultValue - The default value to return if the environment variable is not set.
      * @returns The value of the environment variable, or the default value if not set.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    static get(key, defaultValue = undefined) {
+    get(key, defaultValue = undefined) {
         var _a;
         return (_a = process.env[key]) !== null && _a !== void 0 ? _a : defaultValue;
     }
@@ -37,12 +42,12 @@ let EnvValidatorProvider = EnvValidatorProvider_1 = class EnvValidatorProvider {
      * Validates and loads all environment variables from the .env file.
      * If the .env file does not exist or any environment variables are not set, the process will exit with an error.
      */
-    static checkAll() {
+    checkAll() {
         // Get the full path of the .env file
         const envFilePath = path_1.default.join(process.cwd(), ".", ".env");
         // Check if the .env file exists
         if (!fs_1.default.existsSync(envFilePath)) {
-            (0, logger_1.log)(logger_1.LogLevel.Info, "Environment file .env is not defined.", "env-validator-provider");
+            this.logger.error("Environment file .env is not defined.", "env-validator-provider");
             process.exit(1);
         }
         // Load the environment variables from the .env file
@@ -54,7 +59,7 @@ let EnvValidatorProvider = EnvValidatorProvider_1 = class EnvValidatorProvider {
             for (const key of Object.keys(dotEnvParsed)) {
                 // Check if the environment variable is not defined or is an empty string
                 if (!process.env[key] || process.env[key] === "") {
-                    (0, logger_1.log)(logger_1.LogLevel.Info, `Environment variable ${key} is not defined.`, "env-validator-provider");
+                    this.logger.error(`Environment variable ${key} is not defined.`, "env-validator-provider");
                     hasError = true;
                 }
             }
@@ -64,9 +69,10 @@ let EnvValidatorProvider = EnvValidatorProvider_1 = class EnvValidatorProvider {
         }
     }
 };
-exports.Environments = EnvValidatorProvider;
-exports.Environments = EnvValidatorProvider = EnvValidatorProvider_1 = __decorate([
-    (0, inversify_binding_decorators_1.provide)(EnvValidatorProvider_1)
+exports.EnvValidatorProvider = EnvValidatorProvider;
+exports.EnvValidatorProvider = EnvValidatorProvider = EnvValidatorProvider_1 = __decorate([
+    (0, inversify_binding_decorators_1.provide)(EnvValidatorProvider_1),
+    __metadata("design:paramtypes", [])
 ], EnvValidatorProvider);
 String.prototype.AsBoolean = function () {
     switch (this.toLowerCase().trim()) {

package/lib/cjs/provider/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidateDTO = exports.EnvValidatorProvider = 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; } });
+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/provider/logger/logger-service.js

@@ -0,0 +1,114 @@
+"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 Logger_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const inversify_binding_decorators_1 = require("inversify-binding-decorators");
+const color_service_provider_1 = require("../../common/color-service.provider");
+/**
+ * Applies a specified color to a text string.
+ *
+ * @param text - The text to be colored.
+ * @param color - The color to be applied.
+ * @returns The colored text.
+ */
+function colorText(text, color) {
+    return `${color_service_provider_1.colorCodes[color]}${text}\x1b[0m`;
+}
+/**
+ * Class that provides logging functionality with colorized text.
+ */
+let Logger = Logger_1 = class Logger {
+    constructor() {
+        this.pid = process.pid;
+    }
+    /**
+     * Formats the log message with color, timestamps, and log levels.
+     *
+     * @param logLevel - The level of the log (e.g. INFO, WARN).
+     * @param message - The main log message.
+     * @param module - Optional module name.
+     * @returns The formatted log message.
+     */
+    formatMessage(logLevel = "NONE", message, module) {
+        const localDate = new Date();
+        const options = {
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            second: "2-digit",
+        };
+        const timestamp = colorText(localDate.toLocaleString(undefined, options).replace(",", ""), "white");
+        let logColor;
+        switch (logLevel) {
+            case "INFO":
+                logColor = "blue";
+                break;
+            case "WARN":
+                logColor = "yellow";
+                break;
+            case "ERROR":
+                logColor = "red";
+                break;
+            default:
+                logColor = "none";
+                break;
+        }
+        const formattedLogLevel = colorText(logLevel.padEnd(5, " "), logColor);
+        if (logLevel === "NONE") {
+            return `${colorText("[ExpressoTS]", "none")} ${timestamp} ${colorText("[PID:" + this.pid + "]", "none")} ${formattedLogLevel} [${colorText(module || "", "none")}] ${colorText(message, logColor)}\n`;
+        }
+        return `${colorText("[ExpressoTS]", "green")} ${timestamp} ${colorText("[PID:" + this.pid + "]", "green")} ${formattedLogLevel} [${colorText(module || "", "green")}] ${colorText(message, logColor)}\n`;
+    }
+    /**
+     * Logs a generic message.
+     *
+     * @param message - The message to log.
+     * @param module - Optional module name.
+     */
+    msg(message, module) {
+        process.stdout.write(this.formatMessage("NONE", message, module));
+    }
+    /**
+     * Logs an informational message.
+     *
+     * @param message - The message to log.
+     * @param module - Optional module name.
+     */
+    info(message, module) {
+        process.stdout.write(this.formatMessage("INFO", message, module));
+    }
+    /**
+     * Logs a warning message.
+     *
+     * @param message - The message to log.
+     * @param module - Optional module name.
+     */
+    warn(message, module) {
+        process.stdout.write(this.formatMessage("WARN", message, module));
+    }
+    /**
+     * Logs an error message.
+     *
+     * @param message - The message to log.
+     * @param module - Optional module name.
+     */
+    error(message, module) {
+        process.stderr.write(this.formatMessage("ERROR", message, module));
+    }
+};
+exports.Logger = Logger;
+exports.Logger = Logger = Logger_1 = __decorate([
+    (0, inversify_binding_decorators_1.provide)(Logger_1),
+    __metadata("design:paramtypes", [])
+], Logger);

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

@@ -0,0 +1,36 @@
+"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 Provider_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Provider = void 0;
+const decorator_1 = require("../decorator");
+const logger_service_1 = require("./logger/logger-service");
+const env_validator_provider_1 = require("./environment/env-validator.provider");
+/**
+ * Class responsible for providing singleton instances of various services.
+ *
+ * This class implements the IProvider interface and is decorated with a
+ * singleton provider to ensure a single instance is reused.
+ */
+let Provider = Provider_1 = class Provider {
+    /**
+     * Initializes the instances of the various providers.
+     */
+    constructor() {
+        this.envValidator = new env_validator_provider_1.EnvValidatorProvider();
+        this.logger = new logger_service_1.Logger();
+    }
+};
+exports.Provider = Provider;
+exports.Provider = Provider = Provider_1 = __decorate([
+    (0, decorator_1.provideSingleton)(Provider_1),
+    __metadata("design:paramtypes", [])
+], Provider);

package/lib/cjs/types/common/color-service.provider.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Type representing supported text colors.
+ */
+type Color = "red" | "green" | "yellow" | "blue" | "white" | "black" | "none";
+/**
+ * Mapping of text color codes.
+ *
+ * @remarks
+ * Defines the ANSI escape codes for the corresponding colors in the terminal.
+ */
+declare const colorCodes: Record<Color, string>;
+/**
+ * ANSI escape color codes mapping for different background colors.
+ */
+declare const bgColorCodes: Record<Color, string>;
+/**
+ * Enum representing possible color styles for console output.
+ *
+ * @remarks
+ * Enum values correspond to the string representations of colors.
+ */
+declare enum ColorStyle {
+    None = "none",
+    Yellow = "yellow",
+    Blue = "blue",
+    Green = "green",
+    Red = "red"
+}
+export { Color, ColorStyle, colorCodes, bgColorCodes };
+//# sourceMappingURL=color-service.provider.d.ts.map

package/lib/cjs/types/common/color-service.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-service.provider.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/common/color-service.provider.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,KAAK,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9E;;;;;GAKG;AACH,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAQrC,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAQvC,CAAC;AAEF;;;;;GAKG;AACH,aAAK,UAAU;IACb,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;CACZ;AAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC"}

package/lib/cjs/types/common/package-resolver.provider.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolve package from the current working directory.
+ * @param packageName
+ * @param options
+ * @returns
+ */
+declare function packageResolver(packageName: string, ...options: Array<any>): any;
+export { packageResolver };
+//# sourceMappingURL=package-resolver.provider.d.ts.map

package/lib/cjs/types/common/package-resolver.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-resolver.provider.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/common/package-resolver.provider.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CA8BzE;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/lib/cjs/types/console/console.d.ts

@@ -22,7 +22,7 @@ declare class Console {
      * @param environment - The server environment.
      * @param consoleMessage - Optional application message details for console output.
      */
-    messageServer(port: any, environment: string, consoleMessage?: IApplicationMessageToConsole): Promise<void>;
+    messageServer(port: number, environment: string, consoleMessage?: IApplicationMessageToConsole): Promise<void>;
 }
 export { Console, IApplicationMessageToConsole };
 //# sourceMappingURL=console.d.ts.map