@decaf-ts/logging 0.10.4 → 0.10.6

package/lib/esm/types.d.ts

@@ -9,6 +9,7 @@ import { LoggingMode, LogLevel } from "./constants";
 export type StringLike = string | {
     toString: () => string;
 };
+export type LogMeta = Record<string, unknown>;
 /**
  * @description A generic function signature for loosely typed callbacks.
  * @summary This type covers variadic functions where the arguments and return types are not constrained, which enables the logging layer to accept any callable.
@@ -69,21 +70,21 @@ export interface Logger extends Impersonatable<Logger, [
      * @param {StringLike} msg - Message or payload to emit.
      * @return {void}
      */
-    benchmark(msg: StringLike): void;
+    benchmark(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a `way too verbose` or a silly message.
      * @summary Emits playful or extremely verbose details at the `silly` log level.
      * @param {StringLike} msg - Message or payload to emit.
      * @return {void}
      */
-    silly(msg: StringLike): void;
+    silly(msg: StringLike, verbosity?: number | LogMeta, meta?: LogMeta): void;
     /**
      * @description Logs developer trace messages.
      * @summary Emits playful or extremely verbose details at the `silly` log level.
      * @param {StringLike} msg - Message or payload to emit.
      * @return {void}
      */
-    trace(msg: StringLike): void;
+    trace(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a verbose message.
      * @summary Writes diagnostic output governed by the configured verbosity threshold.
@@ -91,14 +92,14 @@ export interface Logger extends Impersonatable<Logger, [
      * @param {number} [verbosity] - Verbosity level required for the message to pass through.
      * @return {void}
      */
-    verbose(msg: StringLike, verbosity?: number): void;
+    verbose(msg: StringLike, verbosityOrMeta?: number | LogMeta, meta?: LogMeta): void;
     /**
      * @description Logs an info message.
      * @summary Emits general informational events that describe application progress.
      * @param {StringLike} msg - Message or payload to emit.
      * @return {void}
      */
-    info(msg: StringLike): void;
+    info(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs an error message.
      * @summary Records errors and exceptions, including optional stack traces.
@@ -106,21 +107,21 @@ export interface Logger extends Impersonatable<Logger, [
      * @param {Error} [e] - Optional secondary error or cause.
      * @return {void}
      */
-    error(msg: StringLike | Error, e?: Error): void;
+    error(msg: StringLike | Error, error?: Error | LogMeta, meta?: LogMeta): void;
     /**
      * @description Logs a debug message.
      * @summary Emits fine-grained diagnostic details useful during development and troubleshooting.
      * @param {StringLike} msg - Message or payload to emit.
      * @return {void}
      */
-    debug(msg: StringLike): void;
+    debug(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a debug message.
      * @summary Emits fine-grained diagnostic details useful during development and troubleshooting.
      * @param {StringLike} msg - Message or payload to emit.
      * @return {void}
      */
-    warn(msg: StringLike): void;
+    warn(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Creates a new logger for a specific method or context.
      * @summary Produces a scoped logger that formats entries using the derived context and overrides supplied configuration.
@@ -206,6 +207,7 @@ export type LoggingConfig<TRANSPORT = object> = {
     timestamp?: boolean;
     timestampFormat?: string;
     context?: boolean;
+    meta?: boolean;
     theme?: Theme;
     format: LoggingMode;
     pattern: string;

package/lib/esm/winston/winston.d.ts

@@ -1,5 +1,5 @@
 import winston from "winston";
-import { Logger, LoggerFactory, LoggingConfig, StringLike } from "../types";
+import { Logger, LoggerFactory, LogMeta, LoggingConfig, StringLike } from "../types";
 import { MiniLogger } from "../logging";
 import { LogLevel } from "../constants";
 /**
@@ -32,7 +32,7 @@ export declare class WinstonLogger extends MiniLogger implements Logger {
      * @param {Error} [error] - An optional stack trace to include in the log.
      * @return {void}
      */
-    protected log(level: LogLevel, msg: StringLike | Error, error?: Error): void;
+    protected log(level: LogLevel, msg: StringLike | Error, error?: Error, meta?: LogMeta): void;
 }
 /**
  * @description A factory function for creating Winston loggers.

package/lib/esm/winston/winston.js

@@ -44,10 +44,10 @@ export class WinstonLogger extends MiniLogger {
      * @param {Error} [error] - An optional stack trace to include in the log.
      * @return {void}
      */
-    log(level, msg, error) {
+    log(level, msg, error, meta) {
         const logData = {
             level: level,
-            message: this.createLog(level, msg, error),
+            message: this.createLog(level, msg, error, meta),
         };
         if (this.config("correlationId"))
             logData["correlationId"] = this.config("correlationId");

package/lib/esm/winston/winston.js.map

@@ -1 +1 @@
-{"version":3,"file":"winston.js","sourceRoot":"","sources":["../../../src/winston/winston.ts"],"names":[],"mappings":"AAAA,OAAO,OAAoC,MAAM,SAAS,CAAC;AAG3D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,wBAAmB;AAGjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAG3C,YAAY,IAAa,EAAE,IAA6B;QACtD,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAC1B,EAAE,EACF,OAAO,CAAC,SAAS,EAAE,EACnB,IAAI,CAAC,IAAI,IAAI,EAAE,CACY,CAAC;QAE9B,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CACtC,MAAM,CAAC,UAAsC,IAAI,SAAS,CAC5D,CAAC;QACF,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACxD,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAChE,CAAC;QAEF,MAAM,aAAa,GAAkB;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU;YACV,MAAM,EAAE,WAAW;SACpB,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC;IAEO,iBAAiB,CAAC,UAAwB;QAChD,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC;QACvD,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACgB,GAAG,CACpB,KAAe,EACf,GAAuB,EACvB,KAAa;QAEb,MAAM,OAAO,GAAa;YACxB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC;SAC3C,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;YAC9B,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB,CAC3C,OAAgB,EAChB,IAA6B;AAC7B,6DAA6D;AAC7D,GAAG,KAAY,EACA,EAAE,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC"}
+{"version":3,"file":"winston.js","sourceRoot":"","sources":["../../../src/winston/winston.ts"],"names":[],"mappings":"AAAA,OAAO,OAAoC,MAAM,SAAS,CAAC;AAS3D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,wBAAmB;AAGjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAG3C,YAAY,IAAa,EAAE,IAA6B;QACtD,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAC1B,EAAE,EACF,OAAO,CAAC,SAAS,EAAE,EACnB,IAAI,CAAC,IAAI,IAAI,EAAE,CACY,CAAC;QAE9B,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CACtC,MAAM,CAAC,UAAsC,IAAI,SAAS,CAC5D,CAAC;QACF,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACxD,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAChE,CAAC;QAEF,MAAM,aAAa,GAAkB;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU;YACV,MAAM,EAAE,WAAW;SACpB,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC;IAEO,iBAAiB,CAAC,UAAwB;QAChD,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM;YAAE,OAAO,UAAU,CAAC;QACvD,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;;;OAOG;IACgB,GAAG,CACpB,KAAe,EACf,GAAuB,EACvB,KAAa,EACb,IAAc;QAEd,MAAM,OAAO,GAAa;YACxB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC;SACjD,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;YAC9B,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAkB,CAC3C,OAAgB,EAChB,IAA6B;AAC7B,6DAA6D;AAC7D,GAAG,KAAY,EACA,EAAE,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC"}

package/lib/index.cjs

@@ -39,7 +39,7 @@ __exportStar(require("styled-string-builder"), exports);
  * @type {string}
  * @memberOf module:Logging
  */
-exports.VERSION = "0.10.3";
+exports.VERSION = "0.10.5";
 /**
  * @description Current package version string.
  * @summary Stores the package version for diagnostics and compatibility checks.

package/lib/logging.cjs

@@ -145,7 +145,7 @@ class MiniLogger {
      * @param {Error} [error] - Optional error to extract stack trace to include in the log.
      * @return {string} A formatted log string with all components.
      */
-    createLog(level, message, error) {
+    createLog(level, message, error, meta) {
         const log = {};
         const style = this.config("style");
         const separator = this.config("separator");
@@ -193,6 +193,12 @@ class MiniLogger {
                 ? message
                 : message.message;
         log.message = msg;
+        const showMeta = Boolean(this.config("meta"));
+        const metaPayload = showMeta && meta ? meta : undefined;
+        const metaString = metaPayload ? this.formatMeta(metaPayload) : undefined;
+        if (metaPayload) {
+            log.meta = metaPayload;
+        }
         if (error || message instanceof Error) {
             const stack = style
                 ? Logging.theme((error?.stack || message.stack), "stack", level)
@@ -202,8 +208,8 @@ class MiniLogger {
         switch (this.config("format")) {
             case "json":
                 return JSON.stringify(log);
-            case "raw":
-                return this.config("pattern")
+            case "raw": {
+                const generated = this.config("pattern")
                     .split(" ")
                     .map((s) => {
                     if (!s.match(/\{.*?}/g))
@@ -215,10 +221,21 @@ class MiniLogger {
                 })
                     .filter((s) => s)
                     .join(" ");
+                return metaString ? `${generated} ${metaString}` : generated;
+            }
             default:
                 throw new Error(`Unsupported logging format: ${this.config("format")}`);
         }
     }
+    formatMeta(meta) {
+        try {
+            return JSON.stringify(meta);
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        }
+        catch (err) {
+            return String(meta);
+        }
+    }
     /**
      * @description Logs a message with the specified log level.
      * @summary Checks if the message should be logged based on the current log level, then uses the appropriate console method to output the formatted log.
@@ -227,7 +244,7 @@ class MiniLogger {
      * @param {Error} [error] - Optional stack trace to include in the log.
      * @return {void}
      */
-    log(level, msg, error) {
+    log(level, msg, error, meta) {
         const confLvl = this.config("level");
         if (constants_1.NumericLogLevels[confLvl] < constants_1.NumericLogLevels[level])
             return;
@@ -237,9 +254,9 @@ class MiniLogger {
                 method = console.log;
                 break;
             case constants_1.LogLevel.info:
+            case constants_1.LogLevel.verbose:
                 method = console.log;
                 break;
-            case constants_1.LogLevel.verbose:
             case constants_1.LogLevel.debug:
                 method = console.debug;
                 break;
@@ -258,84 +275,105 @@ class MiniLogger {
             default:
                 throw new Error("Invalid log level");
         }
-        method(this.createLog(level, msg, error));
+        method(this.createLog(level, msg, error, meta));
     }
     /**
      * @description Logs a message at the benchmark level.
      * @summary Logs a message at the benchmark level if the current verbosity setting allows it.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    benchmark(msg) {
-        this.log(constants_1.LogLevel.benchmark, msg);
+    benchmark(msg, meta) {
+        this.log(constants_1.LogLevel.benchmark, msg, undefined, meta);
     }
     /**
      * @description Logs a message at the silly level.
      * @summary Logs a message at the silly level if the current verbosity setting allows it.
      * @param {StringLike} msg - The message to be logged.
      * @param {number} [verbosity=0] - The verbosity level of the message.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    silly(msg, verbosity = 0) {
+    silly(msg, verbosityOrMeta = 0, meta) {
+        const verbosity = typeof verbosityOrMeta === "number" ? verbosityOrMeta : 0;
+        const payloadMeta = typeof verbosityOrMeta === "number" ? meta : verbosityOrMeta;
         if (this.config("verbose") >= verbosity)
-            this.log(constants_1.LogLevel.silly, msg);
+            this.log(constants_1.LogLevel.silly, msg, undefined, payloadMeta);
     }
     /**
      * @description Logs a message at the verbose level.
      * @summary Logs a message at the verbose level if the current verbosity setting allows it.
      * @param {StringLike} msg - The message to be logged.
      * @param {number} [verbosity=0] - The verbosity level of the message.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    verbose(msg, verbosity = 0) {
+    verbose(msg, verbosityOrMeta = 0, meta) {
+        const verbosity = typeof verbosityOrMeta === "number" ? verbosityOrMeta : 0;
+        const payloadMeta = typeof verbosityOrMeta === "number" ? meta : verbosityOrMeta;
         if (this.config("verbose") >= verbosity)
-            this.log(constants_1.LogLevel.verbose, msg);
+            this.log(constants_1.LogLevel.verbose, msg, undefined, payloadMeta);
     }
     /**
      * @description Logs a message at the info level.
      * @summary Logs a message at the info level for general application information.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    info(msg) {
-        this.log(constants_1.LogLevel.info, msg);
+    info(msg, meta) {
+        this.log(constants_1.LogLevel.info, msg, undefined, meta);
     }
     /**
      * @description Logs a message at the debug level.
      * @summary Logs a message at the debug level for detailed troubleshooting information.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    debug(msg) {
-        this.log(constants_1.LogLevel.debug, msg);
+    debug(msg, meta) {
+        this.log(constants_1.LogLevel.debug, msg, undefined, meta);
     }
     /**
      * @description Logs a message at the error level.
      * @summary Logs a message at the error level for errors and exceptions.
      * @param {StringLike | Error} msg - The message to be logged or an Error object.
-     * @param {Error} [e] - Optional error to include in the log.
+     * @param {Error|object} [e] - Optional error or metadata to include in the log.
+     * @param {object} [meta] - Optional metadata to include with the entry when an error is supplied.
      * @return {void}
      */
-    error(msg, e) {
-        this.log(constants_1.LogLevel.error, msg, e);
+    error(msg, e, meta) {
+        let errorCandidate;
+        let payloadMeta;
+        if (e instanceof Error) {
+            errorCandidate = e;
+            payloadMeta = meta;
+        }
+        else {
+            payloadMeta = e;
+        }
+        this.log(constants_1.LogLevel.error, msg, errorCandidate, payloadMeta);
     }
     /**
      * @description Logs a message at the warning level.
      * @summary Logs a message at the warning level for potential issues.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    warn(msg) {
-        this.log(constants_1.LogLevel.warn, msg);
+    warn(msg, meta) {
+        this.log(constants_1.LogLevel.warn, msg, undefined, meta);
     }
     /**
      * @description Logs a message at the trace level.
      * @summary Logs a message at the trace level for tracing code execution.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    trace(msg) {
-        this.log(constants_1.LogLevel.trace, msg);
+    trace(msg, meta) {
+        this.log(constants_1.LogLevel.trace, msg, undefined, meta);
     }
     /**
      * @description Updates the logger configuration.
@@ -477,75 +515,84 @@ class Logging {
      * @description Logs a verbose message.
      * @summary Delegates the verbose logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
-     * @param {number} [verbosity=0] - The verbosity level of the message.
+     * @param {number|object} [verbosity] - The verbosity level or metadata object.
+     * @param {object} [meta] - Optional metadata applied when a verbosity level is provided.
      * @return {void}
      */
-    static verbose(msg, verbosity = 0) {
-        return this.get().verbose(msg, verbosity);
+    static verbose(msg, verbosityOrMeta = 0, meta) {
+        return this.get().verbose(msg, verbosityOrMeta, meta);
     }
     /**
      * @description Logs an info message.
      * @summary Delegates the info logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static info(msg) {
-        return this.get().info(msg);
+    static info(msg, meta) {
+        return this.get().info(msg, meta);
     }
     /**
      * @description Logs a trace message.
      * @summary Delegates the trace logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static trace(msg) {
-        return this.get().trace(msg);
+    static trace(msg, meta) {
+        return this.get().trace(msg, meta);
     }
     /**
      * @description Logs a debug message.
      * @summary Delegates the debug logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static debug(msg) {
-        return this.get().debug(msg);
+    static debug(msg, meta) {
+        return this.get().debug(msg, meta);
     }
     /**
      * @description Logs a benchmark message.
      * @summary Delegates the benchmark logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static benchmark(msg) {
-        return this.get().benchmark(msg);
+    static benchmark(msg, meta) {
+        return this.get().benchmark(msg, meta);
     }
     /**
      * @description Logs a silly message.
      * @summary Delegates the silly logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {number|object} [verbosity] - The verbosity level or metadata object.
+     * @param {object} [meta] - Optional metadata applied when a verbosity level is provided.
      * @return {void}
      */
-    static silly(msg) {
-        return this.get().silly(msg);
+    static silly(msg, verbosityOrMeta = 0, meta) {
+        return this.get().silly(msg, verbosityOrMeta, meta);
     }
     /**
      * @description Logs a warning message.
      * @summary Delegates the warning logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static warn(msg) {
-        return this.get().warn(msg);
+    static warn(msg, meta) {
+        return this.get().warn(msg, meta);
     }
     /**
      * @description Logs an error message.
      * @summary Delegates the error logging to the global logger instance.
      * @param {StringLike | Error} msg - The message to be logged.
-     * @param {Error} [e] - Optional error to include in the log.
+     * @param {Error|object} [e] - Optional error or metadata to include in the log.
+     * @param {object} [meta] - Optional metadata to include with the entry when an error is supplied.
      * @return {void}
      */
-    static error(msg, e) {
-        return this.get().error(msg, e);
+    static error(msg, e, meta) {
+        return this.get().error(msg, e, meta);
     }
     /**
      * @description Creates a logger for a specific object or context.

package/lib/logging.d.ts

@@ -1,4 +1,4 @@
-import { LoggerFactory, LoggingConfig, LoggingContext, StringLike, Theme, Logger } from "./types";
+import { LoggerFactory, LoggingConfig, LoggingContext, LogMeta, StringLike, Theme, Logger } from "./types";
 import { LogLevel } from "./constants";
 import { LoggedEnvironment } from "./environment";
 export declare const ROOT_CONTEXT_SYMBOL: unique symbol;
@@ -46,7 +46,8 @@ export declare class MiniLogger implements Logger {
      * @param {Error} [error] - Optional error to extract stack trace to include in the log.
      * @return {string} A formatted log string with all components.
      */
-    protected createLog(level: LogLevel, message: StringLike | Error, error?: Error): string;
+    protected createLog(level: LogLevel, message: StringLike | Error, error?: Error, meta?: LogMeta): string;
+    private formatMeta;
     /**
      * @description Logs a message with the specified log level.
      * @summary Checks if the message should be logged based on the current log level, then uses the appropriate console method to output the formatted log.
@@ -55,66 +56,74 @@ export declare class MiniLogger implements Logger {
      * @param {Error} [error] - Optional stack trace to include in the log.
      * @return {void}
      */
-    protected log(level: LogLevel, msg: StringLike | Error, error?: Error): void;
+    protected log(level: LogLevel, msg: StringLike | Error, error?: Error, meta?: LogMeta): void;
     /**
      * @description Logs a message at the benchmark level.
      * @summary Logs a message at the benchmark level if the current verbosity setting allows it.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    benchmark(msg: StringLike): void;
+    benchmark(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a message at the silly level.
      * @summary Logs a message at the silly level if the current verbosity setting allows it.
      * @param {StringLike} msg - The message to be logged.
      * @param {number} [verbosity=0] - The verbosity level of the message.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    silly(msg: StringLike, verbosity?: number): void;
+    silly(msg: StringLike, verbosityOrMeta?: number | LogMeta, meta?: LogMeta): void;
     /**
      * @description Logs a message at the verbose level.
      * @summary Logs a message at the verbose level if the current verbosity setting allows it.
      * @param {StringLike} msg - The message to be logged.
      * @param {number} [verbosity=0] - The verbosity level of the message.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    verbose(msg: StringLike, verbosity?: number): void;
+    verbose(msg: StringLike, verbosityOrMeta?: number | LogMeta, meta?: LogMeta): void;
     /**
      * @description Logs a message at the info level.
      * @summary Logs a message at the info level for general application information.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    info(msg: StringLike): void;
+    info(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a message at the debug level.
      * @summary Logs a message at the debug level for detailed troubleshooting information.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    debug(msg: StringLike): void;
+    debug(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a message at the error level.
      * @summary Logs a message at the error level for errors and exceptions.
      * @param {StringLike | Error} msg - The message to be logged or an Error object.
-     * @param {Error} [e] - Optional error to include in the log.
+     * @param {Error|object} [e] - Optional error or metadata to include in the log.
+     * @param {object} [meta] - Optional metadata to include with the entry when an error is supplied.
      * @return {void}
      */
-    error(msg: StringLike | Error, e?: Error): void;
+    error(msg: StringLike | Error, e?: Error | LogMeta, meta?: LogMeta): void;
     /**
      * @description Logs a message at the warning level.
      * @summary Logs a message at the warning level for potential issues.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    warn(msg: StringLike): void;
+    warn(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a message at the trace level.
      * @summary Logs a message at the trace level for tracing code execution.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    trace(msg: StringLike): void;
+    trace(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Updates the logger configuration.
      * @summary Merges the provided configuration with the existing configuration.
@@ -236,60 +245,69 @@ export declare class Logging {
      * @description Logs a verbose message.
      * @summary Delegates the verbose logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
-     * @param {number} [verbosity=0] - The verbosity level of the message.
+     * @param {number|object} [verbosity] - The verbosity level or metadata object.
+     * @param {object} [meta] - Optional metadata applied when a verbosity level is provided.
      * @return {void}
      */
-    static verbose(msg: StringLike, verbosity?: number): void;
+    static verbose(msg: StringLike, verbosityOrMeta?: number | LogMeta, meta?: LogMeta): void;
     /**
      * @description Logs an info message.
      * @summary Delegates the info logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static info(msg: StringLike): void;
+    static info(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a trace message.
      * @summary Delegates the trace logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static trace(msg: StringLike): void;
+    static trace(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a debug message.
      * @summary Delegates the debug logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static debug(msg: StringLike): void;
+    static debug(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a benchmark message.
      * @summary Delegates the benchmark logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static benchmark(msg: StringLike): void;
+    static benchmark(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs a silly message.
      * @summary Delegates the silly logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {number|object} [verbosity] - The verbosity level or metadata object.
+     * @param {object} [meta] - Optional metadata applied when a verbosity level is provided.
      * @return {void}
      */
-    static silly(msg: StringLike): void;
+    static silly(msg: StringLike, verbosityOrMeta?: number | LogMeta, meta?: LogMeta): void;
     /**
      * @description Logs a warning message.
      * @summary Delegates the warning logging to the global logger instance.
      * @param {StringLike} msg - The message to be logged.
+     * @param {object} [meta] - Optional metadata to include with the entry.
      * @return {void}
      */
-    static warn(msg: StringLike): void;
+    static warn(msg: StringLike, meta?: LogMeta): void;
     /**
      * @description Logs an error message.
      * @summary Delegates the error logging to the global logger instance.
      * @param {StringLike | Error} msg - The message to be logged.
-     * @param {Error} [e] - Optional error to include in the log.
+     * @param {Error|object} [e] - Optional error or metadata to include in the log.
+     * @param {object} [meta] - Optional metadata to include with the entry when an error is supplied.
      * @return {void}
      */
-    static error(msg: StringLike | Error, e?: Error): void;
+    static error(msg: StringLike | Error, e?: Error | LogMeta, meta?: LogMeta): void;
     /**
      * @description Creates a logger for a specific object or context.
      * @summary Creates a new logger instance for the given object or context using the factory function.