@cichol/logger 4.0.0-alpha.5 → 4.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cichol/logger",
-    "version": "4.0.0-alpha.5",
+    "version": "4.1.0",
     "description": "A logger based on `winston` for personal projects.",
     "homepage": "https://github.com/morrighan/packages",
     "bugs": {
@@ -33,20 +33,20 @@
     },
     "dependencies": {
         "bluebird": "^3.7.2",
-        "chalk": "^4.1.2",
+        "chalk": "^5.3.0",
         "cli-highlight": "^2.1.11",
-        "cls-rtracer": "^2.6.0",
+        "cls-rtracer": "^2.6.3",
         "lodash": "^4.17.21",
-        "luxon": "^2.3.0",
+        "luxon": "^3.5.0",
         "morgan": "^1.10.0",
-        "pretty-bytes": "^5.6.0",
-        "pretty-ms": "^7.0.1",
-        "reflect-metadata": "^0.1.13",
-        "winston": "^3.3.3"
+        "pretty-bytes": "^6.1.1",
+        "pretty-ms": "^9.1.0",
+        "reflect-metadata": "^0.2.2",
+        "winston": "^3.14.2"
     },
     "engines": {
-        "node": "^14.18.3 || ^16.13.2",
-        "npm": "^8.3.1"
+        "node": "^20.13.1",
+        "npm": "^10.8.0"
     },
     "publishConfig": {
         "registry": "https://registry.npmjs.org/",

package/releases/cjs.js

@@ -31,10 +31,7 @@ var prettyMs = require('pretty-ms');
 var cluster = require('cluster');
 require('worker_threads');
 
-function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
-
-function _interopNamespace(e) {
-    if (e && e.__esModule) return e;
+function _interopNamespaceDefault(e) {
     var n = Object.create(null);
     if (e) {
         Object.keys(e).forEach(function (k) {
@@ -47,35 +44,11 @@ function _interopNamespace(e) {
             }
         });
     }
-    n["default"] = e;
+    n.default = e;
     return Object.freeze(n);
 }
 
-var _Symbol__default = /*#__PURE__*/_interopDefaultLegacy(_Symbol);
-var _filterInstanceProperty__default = /*#__PURE__*/_interopDefaultLegacy(_filterInstanceProperty);
-var _mapInstanceProperty__default = /*#__PURE__*/_interopDefaultLegacy(_mapInstanceProperty);
-var _trimInstanceProperty__default = /*#__PURE__*/_interopDefaultLegacy(_trimInstanceProperty);
-var _Reflect$hasOwnMetadata__default = /*#__PURE__*/_interopDefaultLegacy(_Reflect$hasOwnMetadata);
-var _Reflect$getOwnMetadata__default = /*#__PURE__*/_interopDefaultLegacy(_Reflect$getOwnMetadata);
-var _Reflect$defineMetadata__default = /*#__PURE__*/_interopDefaultLegacy(_Reflect$defineMetadata);
-var Promise__default = /*#__PURE__*/_interopDefaultLegacy(Promise$1);
-var lodash__default = /*#__PURE__*/_interopDefaultLegacy(lodash);
-var morgan__default = /*#__PURE__*/_interopDefaultLegacy(morgan);
-var winston__namespace = /*#__PURE__*/_interopNamespace(winston);
-var _findInstanceProperty__default = /*#__PURE__*/_interopDefaultLegacy(_findInstanceProperty);
-var _Reflect$apply__default = /*#__PURE__*/_interopDefaultLegacy(_Reflect$apply);
-var chalk__default = /*#__PURE__*/_interopDefaultLegacy(chalk);
-var rTracer__default = /*#__PURE__*/_interopDefaultLegacy(rTracer);
-var _Map__default = /*#__PURE__*/_interopDefaultLegacy(_Map);
-var process__default = /*#__PURE__*/_interopDefaultLegacy(process);
-var _Symbol$for__default = /*#__PURE__*/_interopDefaultLegacy(_Symbol$for);
-var _startsWithInstanceProperty__default = /*#__PURE__*/_interopDefaultLegacy(_startsWithInstanceProperty);
-var _sliceInstanceProperty__default = /*#__PURE__*/_interopDefaultLegacy(_sliceInstanceProperty);
-var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
-var highlight__default = /*#__PURE__*/_interopDefaultLegacy(highlight);
-var prettyBytes__default = /*#__PURE__*/_interopDefaultLegacy(prettyBytes);
-var prettyMs__default = /*#__PURE__*/_interopDefaultLegacy(prettyMs);
-var cluster__default = /*#__PURE__*/_interopDefaultLegacy(cluster);
+var winston__namespace = /*#__PURE__*/_interopNamespaceDefault(winston);
 
 const LoggingLevel = {
   // Critical levels. (It will crash the process)
@@ -94,16 +67,18 @@ const LoggingLevel = {
   Debug: 5
 };
 
-const colorizerMap = new _Map__default["default"](); // Helpers.
+// Constants.
+const colorizerMap = new _Map();
 
+// Helpers.
 function createScheme(options) {
   const nextIndex = colorizerMap.size;
-  const colorizer = chalk__default["default"].bgHex(options.background).hex(options.foreground);
+  const colorizer = chalk.bgHex(options.background).hex(options.foreground);
   colorizerMap.set(nextIndex, colorizer);
   return nextIndex;
-} // Color definitions.
-
+}
 
+// Color definitions.
 const ColorValue = {
   // Basic colors.
   White: '#FFFFFF',
@@ -143,87 +118,77 @@ const ColorScheme = {
   })
 };
 function getChalkOf(colorSet) {
-  return colorizerMap.get(colorSet) ?? chalk__default["default"];
+  return colorizerMap.get(colorSet) ?? chalk;
 }
+
 /* eslint-enable no-use-before-define */
 
 // Node.js built-in APIs.
 
+// Constants.
 const {
   isTTY
-} = process__default["default"].stdout;
+} = process.stdout;
 const isNotOnCLI = !isTTY;
 function decorateLabel(label, scheme) {
   if (isNotOnCLI) {
     return label;
   }
-
   const chalk = getChalkOf(scheme);
   const decoratedLabel = chalk.bold(` ${label} `);
   return decoratedLabel;
 }
 
-// Constants.
-const rootPath = process__default["default"].cwd();
-const conjunction = ` ${chalk__default["default"].blue('──')} `;
-
-const splat = _Symbol$for__default["default"]('splat'); // Handler metadata.
+// Type definitions.
 
+// Constants.
+const rootPath = process.cwd();
+const conjunction = ` ${chalk.blue('──')} `;
+const splat = _Symbol$for('splat');
 
+// Handler metadata.
 const name$8 = 'error';
 const level$8 = LoggingLevel.Error;
 const label$8 = decorateLabel('ERROR', ColorScheme.Critical);
-
 function mapLocationOfErrorThrown(filename) {
-  let target = path__default["default"].relative(rootPath, filename);
-
-  if (_startsWithInstanceProperty__default["default"](target).call(target, 'node_modules')) {
-    target = chalk__default["default"].gray(target).replace(/node_modules[\\/]([^\\/]+)(.*)/, (matches, moduleName, trailing) => `node_modules${path__default["default"].sep}${chalk__default["default"].bold.underline(moduleName)}${chalk__default["default"].gray(trailing)}` // eslint-disable-line max-len
+  let target = path.relative(rootPath, filename);
+  if (_startsWithInstanceProperty(target).call(target, 'node_modules')) {
+    target = chalk.gray(target).replace(/node_modules[\\/]([^\\/]+)(.*)/, (matches, moduleName, trailing) => `node_modules${path.sep}${chalk.bold.underline(moduleName)}${chalk.gray(trailing)}` // eslint-disable-line max-len
     );
   } else {
-    target = `${chalk__default["default"].gray(path__default["default"].dirname(target) + path__default["default"].sep)}${chalk__default["default"].bold.underline(path__default["default"].basename(target))}`;
+    target = `${chalk.gray(path.dirname(target) + path.sep)}${chalk.bold.underline(path.basename(target))}`;
   }
-
   return target;
 }
-
 function handle$1(data) {
   var _context, _context2, _context3;
-
   const {
     [splat]: [error] = []
   } = data;
-
   if (!(error instanceof Error)) {
     return undefined;
   }
-
   const {
     name,
     message,
     stack: rawStack = ''
   } = error;
-
-  const stack = _mapInstanceProperty__default["default"](_context = _mapInstanceProperty__default["default"](_context2 = _mapInstanceProperty__default["default"](_context3 = _sliceInstanceProperty__default["default"](rawStack).call(rawStack, name.length + message.length + 3).split('\n')).call(_context3, line => line.replace(/^\s+at /g, ''))).call(_context2, line => path__default["default"].isAbsolute(line) ? `<anonymous>${conjunction}${mapLocationOfErrorThrown(line)}` : line)).call(_context, line => line.replace(/^(.+) \((.+)\)$/, (matches, contextName, rawLocation) => {
+  const stack = _mapInstanceProperty(_context = _mapInstanceProperty(_context2 = _mapInstanceProperty(_context3 = _sliceInstanceProperty(rawStack).call(rawStack, name.length + message.length + 3).split('\n')).call(_context3, line => line.replace(/^\s+at /g, ''))).call(_context2, line => path.isAbsolute(line) ? `<anonymous>${conjunction}${mapLocationOfErrorThrown(line)}` : line)).call(_context, line => line.replace(/^(.+) \((.+)\)$/, (matches, contextName, rawLocation) => {
     let location;
-
     if (rawLocation === '<anonymous>') {
-      location = chalk__default["default"].gray(rawLocation);
+      location = chalk.gray(rawLocation);
     } else {
       const [filename, line, column] = rawLocation.split(':');
-
-      if (path__default["default"].isAbsolute(filename)) {
-        const target = mapLocationOfErrorThrown(path__default["default"].relative(rootPath, filename));
-        const trailing = chalk__default["default"].gray(`:${line}:${column}`);
+      if (path.isAbsolute(filename)) {
+        const target = mapLocationOfErrorThrown(path.relative(rootPath, filename));
+        const trailing = chalk.gray(`:${line}:${column}`);
         location = target + trailing;
       } else {
-        location = chalk__default["default"].gray(`https://github.com/${chalk__default["default"].bold.underline('nodejs')}/node/blob/${process.version}/lib/${filename}#L${line}`); // eslint-disable-line max-len
+        location = chalk.gray(`https://github.com/${chalk.bold.underline('nodejs')}/node/blob/${process.version}/lib/${filename}#L${line}`); // eslint-disable-line max-len
       }
     }
-
     return `${contextName}${conjunction}${location}`;
   })).join('\n');
-
   const label = decorateLabel(name, ColorScheme.Critical);
   const payload = `${message}\n\n${stack}\n`;
   return {
@@ -234,28 +199,30 @@ function handle$1(data) {
 
 var ErrorHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$8,
-    level: level$8,
+    default: handle$1,
     label: label$8,
-    'default': handle$1
+    level: level$8,
+    name: name$8
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$7 = 'fatal';
 const level$7 = LoggingLevel.Fatal;
 const label$7 = decorateLabel('FATAL', ColorScheme.Critical);
 
 var FatalHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$7,
-    level: level$7,
+    default: handle$1,
     label: label$7,
-    'default': handle$1
+    level: level$7,
+    name: name$7
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$6 = 'warning';
 const level$6 = LoggingLevel.Warning;
 const label$6 = decorateLabel('WARNING', ColorScheme.Warning);
@@ -263,14 +230,15 @@ var warning = null;
 
 var WarningHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$6,
-    level: level$6,
+    default: warning,
     label: label$6,
-    'default': warning
+    level: level$6,
+    name: name$6
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$5 = 'notice';
 const level$5 = LoggingLevel.Notice;
 const label$5 = decorateLabel('NOTICE', ColorScheme.Regular);
@@ -278,14 +246,15 @@ var notice = null;
 
 var NoticeHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$5,
-    level: level$5,
+    default: notice,
     label: label$5,
-    'default': notice
+    level: level$5,
+    name: name$5
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$4 = 'info';
 const level$4 = LoggingLevel.Info;
 const label$4 = decorateLabel('INFO', ColorScheme.Regular);
@@ -293,14 +262,15 @@ var info = null;
 
 var InfoHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$4,
-    level: level$4,
+    default: info,
     label: label$4,
-    'default': info
+    level: level$4,
+    name: name$4
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$3 = 'http';
 const level$3 = LoggingLevel.Http;
 const label$3 = decorateLabel('HTTP', ColorScheme.Http);
@@ -308,20 +278,22 @@ var http = null;
 
 var HttpHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$3,
-    level: level$3,
+    default: http,
     label: label$3,
-    'default': http
+    level: level$3,
+    name: name$3
 });
 
 // Highlight.js
 
+// Type definitions.
+
 // Handler metadata.
 const name$2 = 'query';
 const level$2 = LoggingLevel.Query;
 const label$2 = decorateLabel('QUERY', ColorScheme.Query);
 function handle(data) {
-  const payload = highlight__default["default"](data.message, {
+  const payload = highlight(data.message, {
     language: 'sql'
   });
   return {
@@ -332,14 +304,15 @@ function handle(data) {
 
 var QueryHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$2,
-    level: level$2,
+    default: handle,
     label: label$2,
-    'default': handle
+    level: level$2,
+    name: name$2
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$1 = 'verbose';
 const level$1 = LoggingLevel.Verbose;
 const label$1 = decorateLabel('VERBOSE', ColorScheme.Loud);
@@ -347,14 +320,15 @@ var verbose = null;
 
 var VerboseHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$1,
-    level: level$1,
+    default: verbose,
     label: label$1,
-    'default': verbose
+    level: level$1,
+    name: name$1
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name = 'debug';
 const level = LoggingLevel.Debug;
 const label = decorateLabel('DEBUG', ColorScheme.Loud);
@@ -362,47 +336,43 @@ var debug = null;
 
 var DebugHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name,
-    level: level,
+    default: debug,
     label: label,
-    'default': debug
+    level: level,
+    name: name
 });
 
 // Handler implementations.
 const handlers = [FatalHandler, ErrorHandler, WarningHandler, NoticeHandler, InfoHandler, HttpHandler, QueryHandler, VerboseHandler, DebugHandler];
 
 var formatForCLI = winston.format.printf(data => {
-  const timestamp = chalk__default["default"].gray(luxon.DateTime.now().toISO({
+  const timestamp = chalk.gray(luxon.DateTime.now().toISO({
     includeOffset: true
   }));
-
-  const handler = _findInstanceProperty__default["default"](handlers).call(handlers, ({
+  const handler = _findInstanceProperty(handlers).call(handlers, ({
     name
   }) => name === data.level);
-
   const fallback = {
     label: handler?.label,
     payload: data.message
   };
+  const performHandle = handler?.default ?? (() => fallback);
 
-  const performHandle = handler?.default ?? (() => fallback); // Execute handler and then, get decorated payload.
-
-
+  // Execute handler and then, get decorated payload.
   const {
     label,
     payload
-  } = _Reflect$apply__default["default"](performHandle, undefined, [data]) ?? fallback;
+  } = _Reflect$apply(performHandle, undefined, [data]) ?? fallback;
   let extraFingerprint;
-
   if (handler?.level === LoggingLevel.Http) {
-    extraFingerprint = data.transactionId ? `(Transaction-ID = ${data.transactionId})` : `(Request-ID = ${rTracer__default["default"].id()})`;
+    extraFingerprint = data.transactionId ? `(Transaction-ID = ${data.transactionId})` : `(Request-ID = ${rTracer.id()})`;
   }
-
   return `${label} ${timestamp}${extraFingerprint ? ` ${extraFingerprint}` : ''}\n${payload}`;
 });
 
 // Node.js built-in APIs.
 
+// Type definitions.
 const ExecutionMode = {
   DevelopmentMode: 'development',
   ProductionMode: 'production'
@@ -413,81 +383,78 @@ const ClusteringMode = {
 };
 // Exportings.
 const executionMode = process.env.NODE_ENV ?? ExecutionMode.DevelopmentMode;
-cluster__default["default"].isPrimary ?? cluster__default["default"].isMaster ? ClusteringMode.MasterProcess : ClusteringMode.WorkerProcess;
+cluster.isPrimary ?? cluster.isMaster ? ClusteringMode.MasterProcess : ClusteringMode.WorkerProcess;
 
 // Node.js built-in APIs.
 
+// Type definitions.
+
 // Helpers.
 function decorateStatusCode(statusCode) {
   const groupOfCode = Math.floor(Number(statusCode) / 100) * 100;
   const baseMessage = `${statusCode} ${http$1.STATUS_CODES[statusCode]}`;
-
   switch (groupOfCode) {
     case 200:
       {
-        return chalk__default["default"].green(baseMessage);
+        return chalk.green(baseMessage);
       }
-
     case 300:
       {
-        return chalk__default["default"].magenta(baseMessage);
+        return chalk.magenta(baseMessage);
       }
-
     case 400:
     case 500:
       {
-        return chalk__default["default"].red(baseMessage);
+        return chalk.red(baseMessage);
       }
-
     default:
       {
-        return chalk__default["default"].gray(baseMessage);
+        return chalk.gray(baseMessage);
       }
   }
 }
-
 function formatForMorgan(tokens, request, response) {
   function _(token, ...subArgs) {
     // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     return tokens[token](request, response, ...subArgs);
-  } // Raw values.
-
+  }
 
+  // Raw values.
   const method = _('method');
-
   const URL = _('url');
-
   const httpVersion = `HTTP/${_('http-version')}`;
   const statusCode = Number(_('status'));
   const contentLength = Number(_('res', 'content-length') ?? -1);
-  const responseTime = Number(_('response-time') ?? -1); // Decorated values.
+  const responseTime = Number(_('response-time') ?? -1);
 
-  const $method = chalk__default["default"].bold(method);
-  const $version = chalk__default["default"].rgb(98, 177, 255)(httpVersion);
+  // Decorated values.
+  const $method = chalk.bold(method);
+  const $version = chalk.rgb(98, 177, 255)(httpVersion);
   const $statusCode = decorateStatusCode(statusCode);
-  const $contentLength = contentLength >= 0 ? prettyBytes__default["default"](contentLength) : '? B';
-  const $responseTime = responseTime >= 0 ? prettyMs__default["default"](responseTime) : ''; // Additional information.
+  const $contentLength = contentLength >= 0 ? prettyBytes(contentLength) : '? B';
+  const $responseTime = responseTime >= 0 ? prettyMs(responseTime) : '';
 
+  // Additional information.
   const metadata = `(${$contentLength}, ${$responseTime})`;
   return [`→ ${$method} ${URL} ${$version}`, `← ${$version} ${$statusCode} ${metadata}`].join('\n');
 }
-
-var formatForMorgan$1 = executionMode === ExecutionMode.DevelopmentMode ? formatForMorgan : morgan__default["default"].combined;
+var formatForMorgan$1 = executionMode === ExecutionMode.DevelopmentMode ? formatForMorgan : morgan.combined;
 
 var _context, _context2;
 
+// Type definitions.
+
 // Transports.
 const {
   Console: ConsoleTransport
-} = winston__namespace.transports; // Keys in order to access private properties.
-
-const KeyOfInstance = _Symbol__default["default"]('@cichol/logger::classes/logger::Instance');
-
-const KeyOfPassport = _Symbol__default["default"]('@cichol/logger::classes/logger::Passport');
+} = winston__namespace.transports;
 
+// Keys in order to access private properties.
+const KeyOfInstance = _Symbol('@cichol/logger::classes/logger::Instance');
+const KeyOfPassport = _Symbol('@cichol/logger::classes/logger::Passport');
 class Logger {
   #logger = winston__namespace.createLogger({
-    levels: _filterInstanceProperty__default["default"](_context = _mapInstanceProperty__default["default"](_context2 = lodash__default["default"](handlers)).call(_context2, ({
+    levels: _filterInstanceProperty(_context = _mapInstanceProperty(_context2 = lodash(handlers)).call(_context2, ({
       name,
       level
     }) => [name, level])).call(_context, ([, level]) => typeof level === 'number').fromPairs().value(),
@@ -497,37 +464,33 @@ class Logger {
     })],
     exitOnError: false
   });
-  #morgan = morgan__default["default"](formatForMorgan$1, {
+  #morgan = morgan(formatForMorgan$1, {
     stream: new stream.PassThrough({
       objectMode: true
     }).on('data', data => {
-      this.log('http', _trimInstanceProperty__default["default"](data).call(data));
+      this.log('http', _trimInstanceProperty(data).call(data));
     })
   });
-
   constructor(passport) {
     if (passport !== KeyOfPassport) {
       throw new ReferenceError('Logger class cannot be constructed in directly');
     }
   }
-
   static get instance() {
     if (this !== Logger) {
       throw new ReferenceError('Logger class is not inheritable');
     }
-
-    if (_Reflect$hasOwnMetadata__default["default"](KeyOfInstance, Logger)) {
-      return _Reflect$getOwnMetadata__default["default"](KeyOfInstance, Logger);
+    if (_Reflect$hasOwnMetadata(KeyOfInstance, Logger)) {
+      return _Reflect$getOwnMetadata(KeyOfInstance, Logger);
     }
-
     const instance = new Logger(KeyOfPassport);
-
     try {
       return instance;
     } finally {
-      _Reflect$defineMetadata__default["default"](KeyOfInstance, instance, Logger);
+      _Reflect$defineMetadata(KeyOfInstance, instance, Logger);
     }
   }
+
   /**
    * Logging message with specific level.
    *
@@ -536,38 +499,47 @@ class Logger {
    * @param args Additional metadata.
    */
 
+  /**
+   * Logging HTTP I/O.
+   *
+   * @param request Node.js built-in `IncomingMessage` instance from `http` module.
+   * @param response Node.js built-in `ServerResponse` instance from `http` module.
+   */
+
+  /**
+   * Logging errors in detail.
+   *
+   * @param error
+   */
 
   log(...args) {
     const logger = this.#logger;
     const morgan = this.#morgan;
-
     switch (true) {
       case args.length >= 2 && args[0] instanceof http$1.IncomingMessage && args[1] instanceof http$1.ServerResponse:
         {
           const [request, response] = args;
-          return Promise__default["default"].fromCallback(callback => morgan(request, response, callback));
+          return Promise$1.fromCallback(callback => morgan(request, response, callback));
         }
-
       case args.length >= 1 && args[0] instanceof Error:
         {
-          const [error, ...data] = args; // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+          const [error, ...data] = args;
 
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
           logger.log('error', error.message, error, ...data);
           return undefined;
         }
-
       default:
         {
-          const [level, message, ...data] = args; // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+          const [level, message, ...data] = args;
 
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
           logger.log(level, message, ...data);
           return undefined;
         }
     }
   }
-
 }
-
 var logger = Logger.instance;
 
 module.exports = logger;

package/releases/esm.js

@@ -47,16 +47,18 @@ const LoggingLevel = {
   Debug: 5
 };
 
-const colorizerMap = new _Map(); // Helpers.
+// Constants.
+const colorizerMap = new _Map();
 
+// Helpers.
 function createScheme(options) {
   const nextIndex = colorizerMap.size;
   const colorizer = chalk.bgHex(options.background).hex(options.foreground);
   colorizerMap.set(nextIndex, colorizer);
   return nextIndex;
-} // Color definitions.
-
+}
 
+// Color definitions.
 const ColorValue = {
   // Basic colors.
   White: '#FFFFFF',
@@ -98,10 +100,12 @@ const ColorScheme = {
 function getChalkOf(colorSet) {
   return colorizerMap.get(colorSet) ?? chalk;
 }
+
 /* eslint-enable no-use-before-define */
 
 // Node.js built-in APIs.
 
+// Constants.
 const {
   isTTY
 } = process.stdout;
@@ -110,61 +114,51 @@ function decorateLabel(label, scheme) {
   if (isNotOnCLI) {
     return label;
   }
-
   const chalk = getChalkOf(scheme);
   const decoratedLabel = chalk.bold(` ${label} `);
   return decoratedLabel;
 }
 
+// Type definitions.
+
 // Constants.
 const rootPath = process.cwd();
 const conjunction = ` ${chalk.blue('──')} `;
+const splat = _Symbol$for('splat');
 
-const splat = _Symbol$for('splat'); // Handler metadata.
-
-
+// Handler metadata.
 const name$8 = 'error';
 const level$8 = LoggingLevel.Error;
 const label$8 = decorateLabel('ERROR', ColorScheme.Critical);
-
 function mapLocationOfErrorThrown(filename) {
   let target = path.relative(rootPath, filename);
-
   if (_startsWithInstanceProperty(target).call(target, 'node_modules')) {
     target = chalk.gray(target).replace(/node_modules[\\/]([^\\/]+)(.*)/, (matches, moduleName, trailing) => `node_modules${path.sep}${chalk.bold.underline(moduleName)}${chalk.gray(trailing)}` // eslint-disable-line max-len
     );
   } else {
     target = `${chalk.gray(path.dirname(target) + path.sep)}${chalk.bold.underline(path.basename(target))}`;
   }
-
   return target;
 }
-
 function handle$1(data) {
   var _context, _context2, _context3;
-
   const {
     [splat]: [error] = []
   } = data;
-
   if (!(error instanceof Error)) {
     return undefined;
   }
-
   const {
     name,
     message,
     stack: rawStack = ''
   } = error;
-
   const stack = _mapInstanceProperty(_context = _mapInstanceProperty(_context2 = _mapInstanceProperty(_context3 = _sliceInstanceProperty(rawStack).call(rawStack, name.length + message.length + 3).split('\n')).call(_context3, line => line.replace(/^\s+at /g, ''))).call(_context2, line => path.isAbsolute(line) ? `<anonymous>${conjunction}${mapLocationOfErrorThrown(line)}` : line)).call(_context, line => line.replace(/^(.+) \((.+)\)$/, (matches, contextName, rawLocation) => {
     let location;
-
     if (rawLocation === '<anonymous>') {
       location = chalk.gray(rawLocation);
     } else {
       const [filename, line, column] = rawLocation.split(':');
-
       if (path.isAbsolute(filename)) {
         const target = mapLocationOfErrorThrown(path.relative(rootPath, filename));
         const trailing = chalk.gray(`:${line}:${column}`);
@@ -173,10 +167,8 @@ function handle$1(data) {
         location = chalk.gray(`https://github.com/${chalk.bold.underline('nodejs')}/node/blob/${version}/lib/${filename}#L${line}`); // eslint-disable-line max-len
       }
     }
-
     return `${contextName}${conjunction}${location}`;
   })).join('\n');
-
   const label = decorateLabel(name, ColorScheme.Critical);
   const payload = `${message}\n\n${stack}\n`;
   return {
@@ -187,28 +179,30 @@ function handle$1(data) {
 
 var ErrorHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$8,
-    level: level$8,
+    default: handle$1,
     label: label$8,
-    'default': handle$1
+    level: level$8,
+    name: name$8
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$7 = 'fatal';
 const level$7 = LoggingLevel.Fatal;
 const label$7 = decorateLabel('FATAL', ColorScheme.Critical);
 
 var FatalHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$7,
-    level: level$7,
+    default: handle$1,
     label: label$7,
-    'default': handle$1
+    level: level$7,
+    name: name$7
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$6 = 'warning';
 const level$6 = LoggingLevel.Warning;
 const label$6 = decorateLabel('WARNING', ColorScheme.Warning);
@@ -216,14 +210,15 @@ var warning = null;
 
 var WarningHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$6,
-    level: level$6,
+    default: warning,
     label: label$6,
-    'default': warning
+    level: level$6,
+    name: name$6
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$5 = 'notice';
 const level$5 = LoggingLevel.Notice;
 const label$5 = decorateLabel('NOTICE', ColorScheme.Regular);
@@ -231,14 +226,15 @@ var notice = null;
 
 var NoticeHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$5,
-    level: level$5,
+    default: notice,
     label: label$5,
-    'default': notice
+    level: level$5,
+    name: name$5
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$4 = 'info';
 const level$4 = LoggingLevel.Info;
 const label$4 = decorateLabel('INFO', ColorScheme.Regular);
@@ -246,14 +242,15 @@ var info = null;
 
 var InfoHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$4,
-    level: level$4,
+    default: info,
     label: label$4,
-    'default': info
+    level: level$4,
+    name: name$4
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$3 = 'http';
 const level$3 = LoggingLevel.Http;
 const label$3 = decorateLabel('HTTP', ColorScheme.Http);
@@ -261,14 +258,16 @@ var http = null;
 
 var HttpHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$3,
-    level: level$3,
+    default: http,
     label: label$3,
-    'default': http
+    level: level$3,
+    name: name$3
 });
 
 // Highlight.js
 
+// Type definitions.
+
 // Handler metadata.
 const name$2 = 'query';
 const level$2 = LoggingLevel.Query;
@@ -285,14 +284,15 @@ function handle(data) {
 
 var QueryHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$2,
-    level: level$2,
+    default: handle,
     label: label$2,
-    'default': handle
+    level: level$2,
+    name: name$2
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name$1 = 'verbose';
 const level$1 = LoggingLevel.Verbose;
 const label$1 = decorateLabel('VERBOSE', ColorScheme.Loud);
@@ -300,14 +300,15 @@ var verbose = null;
 
 var VerboseHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name$1,
-    level: level$1,
+    default: verbose,
     label: label$1,
-    'default': verbose
+    level: level$1,
+    name: name$1
 });
 
 // Local helpers.
 
+// Handler metadata.
 const name = 'debug';
 const level = LoggingLevel.Debug;
 const label = decorateLabel('DEBUG', ColorScheme.Loud);
@@ -315,10 +316,10 @@ var debug = null;
 
 var DebugHandler = /*#__PURE__*/Object.freeze({
     __proto__: null,
-    name: name,
-    level: level,
+    default: debug,
     label: label,
-    'default': debug
+    level: level,
+    name: name
 });
 
 // Handler implementations.
@@ -328,34 +329,30 @@ var formatForCLI = format.printf(data => {
   const timestamp = chalk.gray(DateTime.now().toISO({
     includeOffset: true
   }));
-
   const handler = _findInstanceProperty(handlers).call(handlers, ({
     name
   }) => name === data.level);
-
   const fallback = {
     label: handler?.label,
     payload: data.message
   };
+  const performHandle = handler?.default ?? (() => fallback);
 
-  const performHandle = handler?.default ?? (() => fallback); // Execute handler and then, get decorated payload.
-
-
+  // Execute handler and then, get decorated payload.
   const {
     label,
     payload
   } = _Reflect$apply(performHandle, undefined, [data]) ?? fallback;
   let extraFingerprint;
-
   if (handler?.level === LoggingLevel.Http) {
     extraFingerprint = data.transactionId ? `(Transaction-ID = ${data.transactionId})` : `(Request-ID = ${rTracer.id()})`;
   }
-
   return `${label} ${timestamp}${extraFingerprint ? ` ${extraFingerprint}` : ''}\n${payload}`;
 });
 
 // Node.js built-in APIs.
 
+// Type definitions.
 const ExecutionMode = {
   DevelopmentMode: 'development',
   ProductionMode: 'production'
@@ -370,74 +367,71 @@ cluster.isPrimary ?? cluster.isMaster ? ClusteringMode.MasterProcess : Clusterin
 
 // Node.js built-in APIs.
 
+// Type definitions.
+
 // Helpers.
 function decorateStatusCode(statusCode) {
   const groupOfCode = Math.floor(Number(statusCode) / 100) * 100;
   const baseMessage = `${statusCode} ${STATUS_CODES[statusCode]}`;
-
   switch (groupOfCode) {
     case 200:
       {
         return chalk.green(baseMessage);
       }
-
     case 300:
       {
         return chalk.magenta(baseMessage);
       }
-
     case 400:
     case 500:
       {
         return chalk.red(baseMessage);
       }
-
     default:
       {
         return chalk.gray(baseMessage);
       }
   }
 }
-
 function formatForMorgan(tokens, request, response) {
   function _(token, ...subArgs) {
     // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     return tokens[token](request, response, ...subArgs);
-  } // Raw values.
-
+  }
 
+  // Raw values.
   const method = _('method');
-
   const URL = _('url');
-
   const httpVersion = `HTTP/${_('http-version')}`;
   const statusCode = Number(_('status'));
   const contentLength = Number(_('res', 'content-length') ?? -1);
-  const responseTime = Number(_('response-time') ?? -1); // Decorated values.
+  const responseTime = Number(_('response-time') ?? -1);
 
+  // Decorated values.
   const $method = chalk.bold(method);
   const $version = chalk.rgb(98, 177, 255)(httpVersion);
   const $statusCode = decorateStatusCode(statusCode);
   const $contentLength = contentLength >= 0 ? prettyBytes(contentLength) : '? B';
-  const $responseTime = responseTime >= 0 ? prettyMs(responseTime) : ''; // Additional information.
+  const $responseTime = responseTime >= 0 ? prettyMs(responseTime) : '';
 
+  // Additional information.
   const metadata = `(${$contentLength}, ${$responseTime})`;
   return [`→ ${$method} ${URL} ${$version}`, `← ${$version} ${$statusCode} ${metadata}`].join('\n');
 }
-
 var formatForMorgan$1 = executionMode === ExecutionMode.DevelopmentMode ? formatForMorgan : morgan.combined;
 
 var _context, _context2;
 
+// Type definitions.
+
 // Transports.
 const {
   Console: ConsoleTransport
-} = winston.transports; // Keys in order to access private properties.
+} = winston.transports;
 
+// Keys in order to access private properties.
 const KeyOfInstance = _Symbol('@cichol/logger::classes/logger::Instance');
-
 const KeyOfPassport = _Symbol('@cichol/logger::classes/logger::Passport');
-
 class Logger {
   #logger = winston.createLogger({
     levels: _filterInstanceProperty(_context = _mapInstanceProperty(_context2 = lodash(handlers)).call(_context2, ({
@@ -457,30 +451,26 @@ class Logger {
       this.log('http', _trimInstanceProperty(data).call(data));
     })
   });
-
   constructor(passport) {
     if (passport !== KeyOfPassport) {
       throw new ReferenceError('Logger class cannot be constructed in directly');
     }
   }
-
   static get instance() {
     if (this !== Logger) {
       throw new ReferenceError('Logger class is not inheritable');
     }
-
     if (_Reflect$hasOwnMetadata(KeyOfInstance, Logger)) {
       return _Reflect$getOwnMetadata(KeyOfInstance, Logger);
     }
-
     const instance = new Logger(KeyOfPassport);
-
     try {
       return instance;
     } finally {
       _Reflect$defineMetadata(KeyOfInstance, instance, Logger);
     }
   }
+
   /**
    * Logging message with specific level.
    *
@@ -489,38 +479,47 @@ class Logger {
    * @param args Additional metadata.
    */
 
+  /**
+   * Logging HTTP I/O.
+   *
+   * @param request Node.js built-in `IncomingMessage` instance from `http` module.
+   * @param response Node.js built-in `ServerResponse` instance from `http` module.
+   */
+
+  /**
+   * Logging errors in detail.
+   *
+   * @param error
+   */
 
   log(...args) {
     const logger = this.#logger;
     const morgan = this.#morgan;
-
     switch (true) {
       case args.length >= 2 && args[0] instanceof IncomingMessage && args[1] instanceof ServerResponse:
         {
           const [request, response] = args;
           return Promise$1.fromCallback(callback => morgan(request, response, callback));
         }
-
       case args.length >= 1 && args[0] instanceof Error:
         {
-          const [error, ...data] = args; // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+          const [error, ...data] = args;
 
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
           logger.log('error', error.message, error, ...data);
           return undefined;
         }
-
       default:
         {
-          const [level, message, ...data] = args; // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+          const [level, message, ...data] = args;
 
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
           logger.log(level, message, ...data);
           return undefined;
         }
     }
   }
-
 }
-
 var logger = Logger.instance;
 
 export { logger as default };

package/types/classes/logger.d.ts

@@ -1,33 +0,0 @@
-/// <reference types="node" />
-import 'reflect-metadata';
-import { IncomingMessage as HttpRequest, ServerResponse as HttpResponse } from 'http';
-import Promise from 'bluebird';
-import type { LoggingLevelName } from '../handlers';
-declare class Logger {
-    #private;
-    private constructor();
-    static get instance(): Logger;
-    /**
-     * Logging message with specific level.
-     *
-     * @param level
-     * @param message
-     * @param args Additional metadata.
-     */
-    log(level: LoggingLevelName, message: string, ...args: any[]): void;
-    /**
-     * Logging HTTP I/O.
-     *
-     * @param request Node.js built-in `IncomingMessage` instance from `http` module.
-     * @param response Node.js built-in `ServerResponse` instance from `http` module.
-     */
-    log(request: HttpRequest, response: HttpResponse): Promise<void>;
-    /**
-     * Logging errors in detail.
-     *
-     * @param error
-     */
-    log(error: Error): void;
-}
-declare const _default: Logger;
-export default _default;

package/types/formatters/command-line.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("logform").Format;
-export default _default;

package/types/formatters/morgan.d.ts

@@ -1,8 +0,0 @@
-/// <reference types="node" />
-import { IncomingMessage as HttpRequest, ServerResponse as HttpResponse } from 'http';
-import morgan from 'morgan';
-declare module 'morgan' {
-    const combined: morgan.FormatFn;
-}
-declare const _default: morgan.FormatFn<HttpRequest, HttpResponse>;
-export default _default;

package/types/handlers/debug.d.ts

@@ -1,5 +0,0 @@
-export declare const name = "debug";
-export declare const level: 5;
-export declare const label: "DEBUG";
-declare const _default: null;
-export default _default;

package/types/handlers/error.d.ts

@@ -1,13 +0,0 @@
-declare type LoggingData = {
-    level: string;
-    message: string;
-} & Record<PropertyKey, any>;
-declare type HandledData = {
-    label: string;
-    payload: string;
-};
-export declare const name = "error";
-export declare const level: 1;
-export declare const label: "ERROR";
-export default function handle(data: LoggingData): HandledData | undefined;
-export {};

package/types/handlers/fatal.d.ts

@@ -1,4 +0,0 @@
-export declare const name = "fatal";
-export declare const level: 0;
-export declare const label: "FATAL";
-export { default } from './error';

package/types/handlers/http.d.ts

@@ -1,5 +0,0 @@
-export declare const name = "http";
-export declare const level: 4;
-export declare const label: "HTTP";
-declare const _default: null;
-export default _default;

package/types/handlers/index.d.ts

@@ -1,12 +0,0 @@
-import * as FatalHandler from './fatal';
-import * as ErrorHandler from './error';
-import * as WarningHandler from './warning';
-import * as NoticeHandler from './notice';
-import * as InfoHandler from './info';
-import * as HttpHandler from './http';
-import * as QueryHandler from './query';
-import * as VerboseHandler from './verbose';
-import * as DebugHandler from './debug';
-declare const handlers: (typeof FatalHandler | typeof ErrorHandler | typeof WarningHandler | typeof NoticeHandler | typeof InfoHandler | typeof HttpHandler | typeof QueryHandler | typeof VerboseHandler | typeof DebugHandler)[];
-export declare type LoggingLevelName = (typeof handlers extends (infer T)[] ? T : never)['name'];
-export default handlers;

package/types/handlers/info.d.ts

@@ -1,5 +0,0 @@
-export declare const name = "info";
-export declare const level: 3;
-export declare const label: "INFO";
-declare const _default: null;
-export default _default;

package/types/handlers/notice.d.ts

@@ -1,5 +0,0 @@
-export declare const name = "notice";
-export declare const level: 3;
-export declare const label: "NOTICE";
-declare const _default: null;
-export default _default;

package/types/handlers/query.d.ts

@@ -1,13 +0,0 @@
-declare type LoggingData = {
-    level: string;
-    message: string;
-} & Record<PropertyKey, any>;
-declare type HandledData = {
-    label: string;
-    payload: string;
-};
-export declare const name = "query";
-export declare const level: 4;
-export declare const label: "QUERY";
-export default function handle(data: LoggingData): HandledData | undefined;
-export {};

package/types/handlers/verbose.d.ts

@@ -1,5 +0,0 @@
-export declare const name = "verbose";
-export declare const level: 5;
-export declare const label: "VERBOSE";
-declare const _default: null;
-export default _default;

package/types/handlers/warning.d.ts

@@ -1,5 +0,0 @@
-export declare const name = "warning";
-export declare const level: 2;
-export declare const label: "WARNING";
-declare const _default: null;
-export default _default;

package/types/helpers/color-scheme.d.ts

@@ -1,12 +0,0 @@
-import { Chalk } from 'chalk';
-declare const ColorScheme: {
-    readonly Critical: number;
-    readonly Warning: number;
-    readonly Regular: number;
-    readonly Http: number;
-    readonly Query: number;
-    readonly Loud: number;
-};
-declare type ColorScheme = typeof ColorScheme[keyof typeof ColorScheme];
-export declare function getChalkOf(colorSet: ColorScheme): Chalk;
-export default ColorScheme;

package/types/helpers/constants.d.ts

@@ -1,18 +0,0 @@
-export declare const ExecutionMode: {
-    readonly DevelopmentMode: "development";
-    readonly ProductionMode: "production";
-};
-export declare const ClusteringMode: {
-    readonly MasterProcess: 0;
-    readonly WorkerProcess: 1;
-};
-export declare const ThreadingMode: {
-    readonly MainThread: 0;
-    readonly WorkerThread: 1;
-};
-export declare type ExecutionMode = typeof ExecutionMode[keyof typeof ExecutionMode];
-export declare type ClusteringMode = typeof ClusteringMode[keyof typeof ClusteringMode];
-export declare type ThreadingMode = typeof ThreadingMode[keyof typeof ThreadingMode];
-export declare const executionMode: ExecutionMode;
-export declare const clusteringMode: ClusteringMode;
-export declare const threadingMode: ThreadingMode;

package/types/helpers/label-decorator.d.ts

@@ -1,2 +0,0 @@
-import ColorScheme from './color-scheme';
-export default function decorateLabel<T extends string>(label: T, scheme: ColorScheme): T;

package/types/helpers/logging-level.d.ts

@@ -1,13 +0,0 @@
-declare const LoggingLevel: {
-    readonly Fatal: 0;
-    readonly Error: 1;
-    readonly Warning: 2;
-    readonly Notice: 3;
-    readonly Info: 3;
-    readonly Http: 4;
-    readonly Query: 4;
-    readonly Verbose: 5;
-    readonly Debug: 5;
-};
-declare type LoggingLevel = typeof LoggingLevel[keyof typeof LoggingLevel];
-export default LoggingLevel;

package/types/index.d.ts

@@ -1 +0,0 @@
-export { default } from './classes/logger';