@breadstone-infrastructure/utilities 0.0.12-beta.0

package/Logging/Appenders/TimeStampAppender.d.ts

@@ -0,0 +1,22 @@
+import type { TerminalColorType } from '../../Terminal/TerminalColorType';
+import type { ILogEntry } from '../Interfaces/ILogEntry';
+import { Appender } from './Abstracts/Appender';
+import type { IAppenderConfig } from './Interfaces/IAppenderConfig';
+/**
+ * @public
+ */
+export interface ITimeStampAppenderConfig extends IAppenderConfig {
+    terminalColors: Array<TerminalColorType>;
+}
+/**
+ * @public
+ */
+export declare class TimeStampAppender extends Appender<ITimeStampAppenderConfig> {
+    private _terminalColors;
+    constructor();
+    get terminalColors(): Array<TerminalColorType>;
+    initialize(config: ITimeStampAppenderConfig): void;
+    append(entry: ILogEntry): void;
+    private appendTerminalColor;
+}
+//# sourceMappingURL=TimeStampAppender.d.ts.map

package/Logging/Appenders/TimeStampAppender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeStampAppender.d.ts","sourceRoot":"","sources":["../../../src/Logging/Appenders/TimeStampAppender.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAIpE;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAI7D,cAAc,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;CAG5C;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ,CAAC,wBAAwB,CAAC;IAIrE,OAAO,CAAC,eAAe,CAA2B;;IAelD,IAAW,cAAc,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAEpD;IAMe,UAAU,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI;IAI3D,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAOrC,OAAO,CAAC,mBAAmB;CAW9B"}

package/Logging/Appenders/TimeStampAppender.js

@@ -0,0 +1,44 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeStampAppender = void 0;
+const TerminalColors_1 = require("../../Terminal/TerminalColors");
+const Appender_1 = require("./Abstracts/Appender");
+/**
+ * @public
+ */
+class TimeStampAppender extends Appender_1.Appender {
+    // #region Fields
+    _terminalColors;
+    // #endregion
+    // #region Ctor
+    constructor() {
+        super();
+        this._terminalColors = new Array();
+    }
+    // #endregion
+    // #region Properties
+    get terminalColors() {
+        return this._terminalColors;
+    }
+    // #endregion
+    // #region Methods
+    initialize(config) {
+        this._terminalColors = config.terminalColors;
+    }
+    append(entry) {
+        const date = new Date(entry.timestamp);
+        const dateString = `[${date.toString()}]`;
+        entry.message = `${this.appendTerminalColor(dateString)} ${entry.message ?? ''}`;
+    }
+    appendTerminalColor(value) {
+        if (this._terminalColors) {
+            this._terminalColors.forEach((x) => {
+                value = TerminalColors_1.TerminalColors.format(value, x);
+            });
+        }
+        return value;
+    }
+}
+exports.TimeStampAppender = TimeStampAppender;
+//# sourceMappingURL=TimeStampAppender.js.map

package/Logging/Appenders/TimeStampAppender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeStampAppender.js","sourceRoot":"","sources":["../../../src/Logging/Appenders/TimeStampAppender.ts"],"names":[],"mappings":";AAAA,kBAAkB;;;AAElB,kEAA+D;AAG/D,mDAAgD;AAiBhD;;GAEG;AACH,MAAa,iBAAkB,SAAQ,mBAAkC;IAErE,iBAAiB;IAET,eAAe,CAA2B;IAElD,aAAa;IAEb,eAAe;IAEf;QACI,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,eAAe,GAAG,IAAI,KAAK,EAAqB,CAAC;IAC1D,CAAC;IAED,aAAa;IAEb,qBAAqB;IAErB,IAAW,cAAc;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IAED,aAAa;IAEb,kBAAkB;IAEF,UAAU,CAAC,MAAgC;QACvD,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,cAAc,CAAC;IACjD,CAAC;IAEM,MAAM,CAAC,KAAgB;QAC1B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC;QAE1C,KAAK,CAAC,OAAO,GAAG,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;IACrF,CAAC;IAEO,mBAAmB,CAAC,KAAa;QACrC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC/B,KAAK,GAAG,+BAAc,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5C,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CAIJ;AAjDD,8CAiDC"}

package/Logging/Interfaces/ILogEntry.d.ts

@@ -0,0 +1,13 @@
+import type { LogLevel } from '../LogLevel';
+import type { ILogOptions } from './ILogOptions';
+/**
+ * @public
+ */
+export interface ILogEntry {
+    level: LogLevel;
+    timestamp: number;
+    message?: string;
+    exception?: Error;
+    options?: Partial<ILogOptions>;
+}
+//# sourceMappingURL=ILogEntry.d.ts.map

package/Logging/Interfaces/ILogEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogEntry.d.ts","sourceRoot":"","sources":["../../../src/Logging/Interfaces/ILogEntry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD;;GAEG;AACH,MAAM,WAAW,SAAS;IAItB,KAAK,EAAE,QAAQ,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,SAAS,CAAC,EAAE,KAAK,CAAC;IAElB,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAIlC"}

package/Logging/Interfaces/ILogEntry.js

@@ -0,0 +1,4 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILogEntry.js.map

package/Logging/Interfaces/ILogEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogEntry.js","sourceRoot":"","sources":["../../../src/Logging/Interfaces/ILogEntry.ts"],"names":[],"mappings":";AAAA,kBAAkB"}

package/Logging/Interfaces/ILogOptions.d.ts

@@ -0,0 +1,17 @@
+import type { TerminalColorType } from '../../Terminal/TerminalColorType';
+import type { IAppender } from '../Appenders/Interfaces/IAppender';
+import type { IAppenderConfig } from '../Appenders/Interfaces/IAppenderConfig';
+/**
+ * @public
+ */
+export interface ILogOptions {
+    prefixSpaceLength?: number;
+    suffixSpaceLength?: number;
+    noNewLine?: boolean;
+    appenders?: Array<new () => IAppender<IAppenderConfig>>;
+    /**
+     * override termial color.
+     */
+    color?: TerminalColorType | Array<TerminalColorType>;
+}
+//# sourceMappingURL=ILogOptions.d.ts.map

package/Logging/Interfaces/ILogOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogOptions.d.ts","sourceRoot":"","sources":["../../../src/Logging/Interfaces/ILogOptions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAI/E;;GAEG;AACH,MAAM,WAAW,WAAW;IAIxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,SAAS,CAAC,EAAE,KAAK,CAAC,UAAU,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;IAExD;;OAEG;IACH,KAAK,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;CAIxD"}

package/Logging/Interfaces/ILogOptions.js

@@ -0,0 +1,4 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILogOptions.js.map

package/Logging/Interfaces/ILogOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILogOptions.js","sourceRoot":"","sources":["../../../src/Logging/Interfaces/ILogOptions.ts"],"names":[],"mappings":";AAAA,kBAAkB"}

package/Logging/Interfaces/ILoggerScope.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @public
+ */
+export interface ILoggerScope {
+    destroy(): void;
+}
+//# sourceMappingURL=ILoggerScope.d.ts.map

package/Logging/Interfaces/ILoggerScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILoggerScope.d.ts","sourceRoot":"","sources":["../../../src/Logging/Interfaces/ILoggerScope.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAIzB,OAAO,IAAI,IAAI,CAAC;CAInB"}

package/Logging/Interfaces/ILoggerScope.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILoggerScope.js.map

package/Logging/Interfaces/ILoggerScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILoggerScope.js","sourceRoot":"","sources":["../../../src/Logging/Interfaces/ILoggerScope.ts"],"names":[],"mappings":""}

package/Logging/Interfaces/ILoggerScopeConfig.d.ts

@@ -0,0 +1,9 @@
+import type { TerminalColorType } from '../../Terminal/TerminalColorType';
+/**
+ * @public
+ */
+export interface ILoggerScopeConfig {
+    prefixSpaceLength?: number;
+    color?: TerminalColorType | Array<TerminalColorType>;
+}
+//# sourceMappingURL=ILoggerScopeConfig.d.ts.map

package/Logging/Interfaces/ILoggerScopeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILoggerScopeConfig.d.ts","sourceRoot":"","sources":["../../../src/Logging/Interfaces/ILoggerScopeConfig.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAI/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,KAAK,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC,CAAC;CAIxD"}

package/Logging/Interfaces/ILoggerScopeConfig.js

@@ -0,0 +1,4 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ILoggerScopeConfig.js.map

package/Logging/Interfaces/ILoggerScopeConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILoggerScopeConfig.js","sourceRoot":"","sources":["../../../src/Logging/Interfaces/ILoggerScopeConfig.ts"],"names":[],"mappings":";AAAA,kBAAkB"}

package/Logging/LogLevel.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @public
+ */
+export type LogLevel = 'none' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+//# sourceMappingURL=LogLevel.d.ts.map

package/Logging/LogLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.d.ts","sourceRoot":"","sources":["../../src/Logging/LogLevel.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC"}

package/Logging/LogLevel.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=LogLevel.js.map

package/Logging/LogLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.js","sourceRoot":"","sources":["../../src/Logging/LogLevel.ts"],"names":[],"mappings":""}

package/Logging/Logger.d.ts

@@ -0,0 +1,148 @@
+import type { ILogEntry } from './Interfaces/ILogEntry';
+import type { ILoggerScope } from './Interfaces/ILoggerScope';
+import type { ILoggerScopeConfig } from './Interfaces/ILoggerScopeConfig';
+import type { ILogOptions } from './Interfaces/ILogOptions';
+import { LoggerConfig } from './LoggerConfig';
+import type { LogLevel } from './LogLevel';
+/**
+ * @public
+ */
+export declare class Logger {
+    private static _config;
+    private static _logger;
+    private readonly _name;
+    private readonly _parent;
+    private readonly _config;
+    private _suppressor;
+    private _appender;
+    private _isDebug;
+    private _quiet;
+    private _cb;
+    constructor(name: string, parent?: Logger | null, config?: LoggerConfig);
+    get name(): string;
+    get parent(): Logger | null;
+    /**
+     * Configure the logger.
+     *
+     * @static
+     * @param {LoggerConfig?} config The logger configuration.
+     * @param {boolean} force Override the logger configuration.
+     * @returns {Logger}
+     */
+    static configure(config?: Partial<LoggerConfig>, force?: boolean): Logger;
+    /**
+     * Creates a instance of the logger object.
+     *
+     * @static
+     * @returns {Logger} A logger object
+     */
+    static instance(): Logger;
+    /**
+     * Configure the logger.
+     *
+     * @param {LoggerConfig?} config The logger configuration.
+     */
+    configure(config?: Partial<LoggerConfig>): void;
+    /**
+     * Creates a new child logger instance.
+     *
+     * @public
+     * @param {string} name The logger name
+     * @returns {Logger} A logger object
+     */
+    createChild(name: string, config?: LoggerConfig): Logger;
+    /**
+     * Creates a new logger scope instance.
+     *
+     * @public
+     * @param {string} message The logger scope message.
+     * @returns {ILoggerScope} A logger scope object.
+     */
+    createScope(message?: string, config?: Partial<ILoggerScopeConfig>): ILoggerScope;
+    /**
+     * Add a subscription to each log.
+     *
+     * @public
+     * @param {Function} cb The subsciption callback.
+     */
+    subscribe(cb: (entry: ILogEntry) => void): void;
+    /**
+     * Logs a message.
+     *
+     * @public
+     * @param {LogLevel} level The state
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    log(level: LogLevel, message: string, options?: Partial<ILogOptions>): this;
+    /**
+     * Logs a debug message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logDebug(message: string, options?: ILogOptions): this;
+    /**
+     * Logs a info message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logInfo(message: string, options?: ILogOptions): this;
+    /**
+     * Logs a waring message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logWarning(message: string, options?: ILogOptions): this;
+    /**
+     * Logs a error message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logError(message: string, options?: ILogOptions): this;
+    /**
+     * Logs a fatal message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logFatal(message: string, options?: ILogOptions): this;
+    /**
+     * Logs a neutral message.
+     * Formatting is not removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logNeutral(message: string, options?: ILogOptions): this;
+    /**
+     * @private
+     */
+    private ensure;
+    /**
+     * @private
+     */
+    private logCore;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/Logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/Logging/Logger.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C;;GAEG;AACH,qBAAa,MAAM;IAIf,OAAO,CAAC,MAAM,CAAC,OAAO,CAAe;IACrC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,SAAS,CAA8D;IAC/E,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,GAAG,CAAsC;gBAM9B,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,EAAE,MAAM,CAAC,EAAE,YAAY;IAwBpF,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,MAAM,IAAI,MAAM,GAAG,IAAI,CAEjC;IAMD;;;;;;;OAOG;WACW,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM;IAYhF;;;;;OAKG;WACW,QAAQ,IAAI,MAAM;IAchC;;;;OAIG;IACI,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IA0BtD;;;;;;OAMG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAK/D;;;;;;OAMG;IACI,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,YAAY;IAIxF;;;;;OAKG;IACI,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,IAAI;IAItD;;;;;;;;OAQG;IACI,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAmClF;;;;;;;;OAQG;IACI,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAS7D;;;;;;;;OAQG;IACI,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAS5D;;;;;;;;OAQG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAS/D;;;;;;;;OAQG;IACI,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAS7D;;;;;;;;OAQG;IACI,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAS7D;;;;;;;;OAQG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAI/D;;OAEG;IACH,OAAO,CAAC,MAAM;IAed;;OAEG;IACH,OAAO,CAAC,OAAO;CA6BlB"}

package/Logging/Logger.js

@@ -0,0 +1,326 @@
+"use strict";
+// #region Imports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const TerminalColors_1 = require("../Terminal/TerminalColors");
+const LoggerConfig_1 = require("./LoggerConfig");
+const LoggerScope_1 = require("./LoggerScope");
+const LoggerSuppressor_1 = require("./LoggerSuppressor");
+// #endregion
+/**
+ * @public
+ */
+class Logger {
+    // #region Fields
+    static _config;
+    static _logger;
+    _name;
+    _parent;
+    _config;
+    _suppressor;
+    _appender;
+    _isDebug;
+    _quiet;
+    _cb;
+    // #endregion
+    // #region Ctor
+    constructor(name, parent = null, config) {
+        this._name = name;
+        this._parent = parent;
+        this._suppressor = null;
+        this._cb = null;
+        this._appender = null;
+        this._isDebug = false;
+        this._quiet = false;
+        const path = [];
+        let p = parent;
+        while (p) {
+            path.push(p.name);
+            p = p.parent;
+        }
+        this._config = config ?? null;
+        this.configure(config);
+    }
+    // #endregion
+    // #region Properties
+    get name() {
+        return this._name;
+    }
+    get parent() {
+        return this._parent;
+    }
+    // #endregion
+    // #region Methods
+    /**
+     * Configure the logger.
+     *
+     * @static
+     * @param {LoggerConfig?} config The logger configuration.
+     * @param {boolean} force Override the logger configuration.
+     * @returns {Logger}
+     */
+    static configure(config, force) {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (Logger._config && !force) {
+            throw new Error('The logger is already configured!');
+        }
+        Logger._config = config
+            ? Object.assign(new LoggerConfig_1.LoggerConfig(), config)
+            : new LoggerConfig_1.LoggerConfig();
+        return Logger.instance();
+    }
+    /**
+     * Creates a instance of the logger object.
+     *
+     * @static
+     * @returns {Logger} A logger object
+     */
+    static instance() {
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if (!Logger._logger) {
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            if (!Logger._config) {
+                throw new Error('The logger must be configured, before it would be used!');
+            }
+            return Logger._logger = new Logger('');
+        }
+        return Logger._logger;
+    }
+    /**
+     * Configure the logger.
+     *
+     * @param {LoggerConfig?} config The logger configuration.
+     */
+    configure(config) {
+        if (this._config) {
+            config = Object.assign(this._config, config);
+        }
+        if (config) {
+            this._isDebug = config.isDebug ?? false;
+            this._quiet = config.quiet ?? false;
+            this._suppressor = config.overrideConsole ?? false
+                ? new LoggerSuppressor_1.LoggerSuppressor().suppress()
+                : null;
+            this._appender = (config.appender ?? []).length > 0
+                ? (config.appender ?? []).map((x) => [new x[0](), x[1]])
+                : null;
+        }
+        else {
+            this._isDebug = false;
+            this._quiet = false;
+            this._suppressor = null;
+            this._appender = null;
+        }
+        this._appender?.forEach((x) => {
+            x[0].initialize(x[1]);
+        });
+    }
+    /**
+     * Creates a new child logger instance.
+     *
+     * @public
+     * @param {string} name The logger name
+     * @returns {Logger} A logger object
+     */
+    createChild(name, config) {
+        // Todo: adapt config from parent logger if is not set.
+        return new this.constructor(name, this, config);
+    }
+    /**
+     * Creates a new logger scope instance.
+     *
+     * @public
+     * @param {string} message The logger scope message.
+     * @returns {ILoggerScope} A logger scope object.
+     */
+    createScope(message, config) {
+        return new LoggerScope_1.LoggerScope(message, config);
+    }
+    /**
+     * Add a subscription to each log.
+     *
+     * @public
+     * @param {Function} cb The subsciption callback.
+     */
+    subscribe(cb) {
+        this._cb = cb;
+    }
+    /**
+     * Logs a message.
+     *
+     * @public
+     * @param {LogLevel} level The state
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    log(level, message, options) {
+        if (this._quiet) {
+            return this;
+        }
+        if (level === 'debug' && !this._isDebug) {
+            console.log('log was rejected!!!');
+            return this;
+        }
+        options = this.ensure(options);
+        const entry = {
+            level,
+            message,
+            options,
+            timestamp: Number(Date.now())
+        };
+        this._appender?.forEach(([appender]) => {
+            appender.append(entry);
+        });
+        if (this._suppressor) {
+            this._suppressor.getMethod('log')(entry.message);
+        }
+        else {
+            this.logCore(entry.message ?? '', options);
+        }
+        if (this._cb) {
+            this._cb(entry);
+        }
+        return this;
+    }
+    /**
+     * Logs a debug message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logDebug(message, options) {
+        return this.log('debug', message, {
+            ...{
+                color: 'gray'
+            },
+            ...options
+        });
+    }
+    /**
+     * Logs a info message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logInfo(message, options) {
+        return this.log('info', message, {
+            ...{
+                color: 'blue'
+            },
+            ...options
+        });
+    }
+    /**
+     * Logs a waring message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logWarning(message, options) {
+        return this.log('warn', message, {
+            ...{
+                color: 'yellow'
+            },
+            ...options
+        });
+    }
+    /**
+     * Logs a error message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logError(message, options) {
+        return this.log('error', message, {
+            ...{
+                color: 'red'
+            },
+            ...options
+        });
+    }
+    /**
+     * Logs a fatal message.
+     * Formatting is removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logFatal(message, options) {
+        return this.log('fatal', message, {
+            ...{
+                color: 'red'
+            },
+            ...options
+        });
+    }
+    /**
+     * Logs a neutral message.
+     * Formatting is not removed.
+     *
+     * @public
+     * @param {string} message The message
+     * @param {ILogOptions} options The custom log options
+     * @returns {Logger} A logger object
+     */
+    logNeutral(message, options) {
+        return this.log('none', message, options);
+    }
+    /**
+     * @private
+     */
+    ensure(options) {
+        const defaultOptions = {
+            noNewLine: false,
+            prefixSpaceLength: 0,
+            suffixSpaceLength: 0,
+            appenders: []
+        };
+        return options
+            ? {
+                ...defaultOptions,
+                ...options
+            }
+            : defaultOptions;
+    }
+    /**
+     * @private
+     */
+    logCore(msg, options) {
+        if (options.color) {
+            // eslint-disable-next-line no-control-regex
+            msg = msg.replace(/\x1B\[\d+m/g, '');
+        }
+        const chunkSize = 2000; // Small chunk.
+        const prefix = options.prefixSpaceLength ? ' '.repeat(options.prefixSpaceLength) : '';
+        const suffix = options.suffixSpaceLength ? ' '.repeat(options.suffixSpaceLength) : '';
+        while (msg) {
+            let chunk = msg.slice(0, chunkSize);
+            if (options.color) {
+                const c = Array.isArray(options.color) ? options.color : [options.color];
+                chunk = TerminalColors_1.TerminalColors.format(chunk, ...c);
+            }
+            if (options.noNewLine) {
+                chunk = `${chunk}${options.noNewLine ? '\u001b[2K\u001b[0E' : ''}`;
+            }
+            msg = msg.slice(chunkSize);
+            console.log(`${prefix}${chunk}${suffix}`);
+        }
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=Logger.js.map