@wgtechlabs/log-engine 2.1.0 → 2.2.0

package/dist/esm/__tests__/test-utils.js

@@ -0,0 +1,42 @@
+/**
+ * Shared test utilities for log-engine tests
+ * Provides consistent console mocking and cleanup functionality across all test suites
+ */
+/**
+ * Sets up console mocks for testing log output
+ * Replaces console methods with Jest spies to capture and verify log calls
+ * @returns ConsoleMocks object containing all spy instances
+ */
+export const setupConsoleMocks = () => {
+    const mockConsoleLog = jest.spyOn(console, 'log').mockImplementation();
+    const mockConsoleWarn = jest.spyOn(console, 'warn').mockImplementation();
+    const mockConsoleError = jest.spyOn(console, 'error').mockImplementation();
+    return { mockConsoleLog, mockConsoleWarn, mockConsoleError };
+};
+/**
+ * Restores console mocks after testing
+ * Cleans up Jest spies and restores original console functionality
+ * @param mocks - The ConsoleMocks object from setupConsoleMocks
+ */
+export const restoreConsoleMocks = (mocks) => {
+    mocks.mockConsoleLog.mockRestore();
+    mocks.mockConsoleWarn.mockRestore();
+    mocks.mockConsoleError.mockRestore();
+};
+/**
+ * Convenience function for setting up console mocks in beforeEach hooks
+ * Identical to setupConsoleMocks but with a more descriptive name for test setup
+ * @returns ConsoleMocks object containing all spy instances
+ */
+export const setupConsoleBeforeEach = () => {
+    return setupConsoleMocks();
+};
+/**
+ * Convenience function for restoring console mocks in afterEach hooks
+ * Identical to restoreConsoleMocks but with a more descriptive name for test cleanup
+ * @param mocks - The ConsoleMocks object to restore
+ */
+export const restoreConsoleAfterEach = (mocks) => {
+    restoreConsoleMocks(mocks);
+};
+//# sourceMappingURL=test-utils.js.map

package/dist/esm/__tests__/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAiB,EAAE;IAClD,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACvE,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,EAAE,CAAC;IACzE,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,EAAE,CAAC;IAE3E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,CAAC;AAC/D,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAmB,EAAQ,EAAE;IAC/D,KAAK,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC;IACnC,KAAK,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;IACpC,KAAK,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC;AACvC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAiB,EAAE;IACvD,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAmB,EAAQ,EAAE;IACnE,mBAAmB,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC,CAAC"}

package/dist/esm/formatter/colors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ANSI color codes and color management for terminal output
+ * Provides consistent color definitions used throughout the formatting system
+ */
+/**
+ * ANSI color codes for terminal output styling
+ * Used to create colorized console output with consistent theming
+ */
+export declare const colors: {
+    readonly reset: "\u001B[0m";
+    readonly dim: "\u001B[2m";
+    readonly red: "\u001B[31m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly magenta: "\u001B[35m";
+    readonly cyan: "\u001B[36m";
+    readonly white: "\u001B[37m";
+    readonly gray: "\u001B[90m";
+    readonly green: "\u001B[32m";
+};
+/**
+ * Color scheme configuration
+ * Maps semantic meanings to specific colors for consistent theming
+ */
+export declare const colorScheme: {
+    readonly timestamp: "\u001B[90m";
+    readonly timeString: "\u001B[36m";
+    readonly system: "\u001B[33m";
+    readonly data: "\u001B[2m";
+    readonly reset: "\u001B[0m";
+};
+//# sourceMappingURL=colors.d.ts.map

package/dist/esm/formatter/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/formatter/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;CAWT,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;CAMd,CAAC"}

package/dist/esm/formatter/colors.js

@@ -0,0 +1,32 @@
+/**
+ * ANSI color codes and color management for terminal output
+ * Provides consistent color definitions used throughout the formatting system
+ */
+/**
+ * ANSI color codes for terminal output styling
+ * Used to create colorized console output with consistent theming
+ */
+export const colors = {
+    reset: '\x1b[0m', // Reset all formatting
+    dim: '\x1b[2m', // Dim/faded text
+    red: '\x1b[31m', // Red text (errors)
+    yellow: '\x1b[33m', // Yellow text (warnings)
+    blue: '\x1b[34m', // Blue text (info)
+    magenta: '\x1b[35m', // Magenta text (debug)
+    cyan: '\x1b[36m', // Cyan text (timestamps)
+    white: '\x1b[37m', // White text (default)
+    gray: '\x1b[90m', // Gray text (timestamps)
+    green: '\x1b[32m' // Green text (log level)
+};
+/**
+ * Color scheme configuration
+ * Maps semantic meanings to specific colors for consistent theming
+ */
+export const colorScheme = {
+    timestamp: colors.gray,
+    timeString: colors.cyan,
+    system: colors.yellow,
+    data: colors.dim,
+    reset: colors.reset
+};
+//# sourceMappingURL=colors.js.map

package/dist/esm/formatter/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/formatter/colors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,SAAS,EAAO,uBAAuB;IAC9C,GAAG,EAAE,SAAS,EAAS,iBAAiB;IACxC,GAAG,EAAE,UAAU,EAAQ,oBAAoB;IAC3C,MAAM,EAAE,UAAU,EAAK,yBAAyB;IAChD,IAAI,EAAE,UAAU,EAAO,mBAAmB;IAC1C,OAAO,EAAE,UAAU,EAAI,uBAAuB;IAC9C,IAAI,EAAE,UAAU,EAAO,yBAAyB;IAChD,KAAK,EAAE,UAAU,EAAM,uBAAuB;IAC9C,IAAI,EAAE,UAAU,EAAO,yBAAyB;IAChD,KAAK,EAAE,UAAU,CAAM,yBAAyB;CACxC,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC,IAAI;IACtB,UAAU,EAAE,MAAM,CAAC,IAAI;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC,GAAG;IAChB,KAAK,EAAE,MAAM,CAAC,KAAK;CACX,CAAC"}

package/dist/esm/formatter/data-formatter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Data formatting utilities for log output
+ * Handles serialization and formatting of data objects in log messages
+ */
+import { LogData } from '../types';
+/**
+ * Converts input data to a readable string suitable for log output.
+ *
+ * Returns 'null' for `null`, an empty string for `undefined`, the value itself for strings, and string representations for numbers and booleans. For other types, attempts JSON serialization; if serialization fails, returns '[Object]'.
+ *
+ * @param data - The value to format for logging
+ * @returns The formatted string representation of the input data
+ */
+export declare function formatData(data: LogData): string;
+/**
+ * Applies color styling to a formatted data string using the provided color codes.
+ *
+ * @param dataString - The string to be styled; if falsy, an empty string is returned.
+ * @param colors - An object containing `data` (the color code prefix) and `reset` (the color code suffix).
+ * @returns The styled data string with color codes applied, or an empty string if `dataString` is falsy.
+ */
+export declare function styleData(dataString: string, colors: {
+    data: string;
+    reset: string;
+}): string;
+//# sourceMappingURL=data-formatter.d.ts.map

package/dist/esm/formatter/data-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-formatter.d.ts","sourceRoot":"","sources":["../../../src/formatter/data-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CA2BhD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAM7F"}

package/dist/esm/formatter/data-formatter.js

@@ -0,0 +1,50 @@
+/**
+ * Data formatting utilities for log output
+ * Handles serialization and formatting of data objects in log messages
+ */
+/**
+ * Converts input data to a readable string suitable for log output.
+ *
+ * Returns 'null' for `null`, an empty string for `undefined`, the value itself for strings, and string representations for numbers and booleans. For other types, attempts JSON serialization; if serialization fails, returns '[Object]'.
+ *
+ * @param data - The value to format for logging
+ * @returns The formatted string representation of the input data
+ */
+export function formatData(data) {
+    if (data === null) {
+        return 'null';
+    }
+    if (data === undefined) {
+        return '';
+    }
+    if (typeof data === 'string') {
+        return data;
+    }
+    if (typeof data === 'number' || typeof data === 'boolean') {
+        return String(data);
+    }
+    if (typeof data === 'symbol') {
+        return data.toString();
+    }
+    try {
+        return JSON.stringify(data, null, 0);
+    }
+    catch {
+        // Fallback for objects that can't be stringified (e.g., circular references)
+        return '[Object]';
+    }
+}
+/**
+ * Applies color styling to a formatted data string using the provided color codes.
+ *
+ * @param dataString - The string to be styled; if falsy, an empty string is returned.
+ * @param colors - An object containing `data` (the color code prefix) and `reset` (the color code suffix).
+ * @returns The styled data string with color codes applied, or an empty string if `dataString` is falsy.
+ */
+export function styleData(dataString, colors) {
+    if (!dataString) {
+        return '';
+    }
+    return ` ${colors.data}${dataString}${colors.reset}`;
+}
+//# sourceMappingURL=data-formatter.js.map

package/dist/esm/formatter/data-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-formatter.js","sourceRoot":"","sources":["../../../src/formatter/data-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,MAAuC;IACnF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,IAAI,GAAG,UAAU,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;AACvD,CAAC"}

package/dist/esm/formatter/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Formatter module exports
+ * Provides centralized access to all formatting functionality
+ */
+export { MessageFormatter } from './message-formatter';
+export { colors, colorScheme } from './colors';
+export { getTimestampComponents, formatTimestamp } from './timestamp';
+export { formatData, styleData } from './data-formatter';
+export { MessageFormatter as LogFormatter } from './message-formatter';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/formatter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formatter/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/formatter/index.js

@@ -0,0 +1,11 @@
+/**
+ * Formatter module exports
+ * Provides centralized access to all formatting functionality
+ */
+export { MessageFormatter } from './message-formatter.js';
+export { colors, colorScheme } from './colors.js';
+export { getTimestampComponents, formatTimestamp } from './timestamp.js';
+export { formatData, styleData } from './data-formatter.js';
+// Backward compatibility - maintain the original LogFormatter class interface
+export { MessageFormatter as LogFormatter } from './message-formatter.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/formatter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/formatter/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEzD,8EAA8E;AAC9E,OAAO,EAAE,gBAAgB,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/formatter/message-formatter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Core message formatting functionality
+ * Handles the main log message formatting with colors, timestamps, and levels
+ */
+import { LogLevel, LogData, LogFormatConfig } from '../types';
+/**
+ * Core message formatter class
+ * Provides the main formatting functionality for log messages
+ */
+export declare class MessageFormatter {
+    /**
+     * Default format configuration to avoid object recreation on every call
+     */
+    private static readonly DEFAULT_FORMAT_CONFIG;
+    /**
+       * Formats a log message with timestamp, level indicator, and appropriate coloring
+       * Creates a structured log entry: [ISO_TIMESTAMP][LOCAL_TIME][LEVEL]: message [data]
+       * @param level - The log level to format for
+       * @param message - The message content to format
+       * @param data - Optional data object to include in the log output
+       * @param formatConfig - Optional format configuration to control element inclusion
+       * @returns Formatted string with ANSI colors and timestamps
+       */
+    static format(level: LogLevel, message: string, data?: LogData, formatConfig?: LogFormatConfig): string;
+    /**
+       * Formats a Log Engine system message with [LOG ENGINE] prefix instead of log levels
+       * Used for internal messages like deprecation warnings that should be distinguished from user logs
+       * @param message - The system message content to format
+       * @param formatConfig - Optional format configuration to control element inclusion
+       * @returns Formatted string with ANSI colors, timestamps, and LOG ENGINE prefix
+       */
+    static formatSystemMessage(message: string, formatConfig?: LogFormatConfig): string;
+    /**
+       * Converts LogLevel enum to human-readable string
+       * @param level - The LogLevel to convert
+       * @returns String representation of the log level
+       */
+    private static getLevelName;
+    /**
+       * Maps LogLevel to appropriate ANSI color code
+       * Colors help quickly identify message severity in console output
+       * @param level - The LogLevel to get color for
+       * @returns ANSI color escape sequence
+       */
+    private static getLevelColor;
+}
+//# sourceMappingURL=message-formatter.d.ts.map

package/dist/esm/formatter/message-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-formatter.d.ts","sourceRoot":"","sources":["../../../src/formatter/message-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAK9D;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAG3C;IAEF;;;;;;;;SAQK;IACL,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,eAAe,GAAG,MAAM;IA0CvG;;;;;;SAMK;IACL,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,eAAe,GAAG,MAAM;IA8BnF;;;;SAIK;IACL,OAAO,CAAC,MAAM,CAAC,YAAY;IAW3B;;;;;SAKK;IACL,OAAO,CAAC,MAAM,CAAC,aAAa;CAU7B"}

package/dist/esm/formatter/message-formatter.js

@@ -0,0 +1,133 @@
+/**
+ * Core message formatting functionality
+ * Handles the main log message formatting with colors, timestamps, and levels
+ */
+import { LogLevel } from '../types/index.js';
+import { colors, colorScheme } from './colors.js';
+import { getTimestampComponents, formatTimestamp } from './timestamp.js';
+import { formatData, styleData } from './data-formatter.js';
+/**
+ * Core message formatter class
+ * Provides the main formatting functionality for log messages
+ */
+export class MessageFormatter {
+    /**
+       * Formats a log message with timestamp, level indicator, and appropriate coloring
+       * Creates a structured log entry: [ISO_TIMESTAMP][LOCAL_TIME][LEVEL]: message [data]
+       * @param level - The log level to format for
+       * @param message - The message content to format
+       * @param data - Optional data object to include in the log output
+       * @param formatConfig - Optional format configuration to control element inclusion
+       * @returns Formatted string with ANSI colors and timestamps
+       */
+    static format(level, message, data, formatConfig) {
+        // Merge provided format configuration with the default configuration
+        const config = {
+            ...MessageFormatter.DEFAULT_FORMAT_CONFIG,
+            ...formatConfig
+        };
+        // Build timestamp string conditionally
+        let timestamp = '';
+        if (config.includeIsoTimestamp || config.includeLocalTime) {
+            const { isoTimestamp, timeString } = getTimestampComponents();
+            if (config.includeIsoTimestamp && config.includeLocalTime) {
+                // Both timestamps included
+                timestamp = formatTimestamp(isoTimestamp, timeString, colorScheme);
+            }
+            else if (config.includeIsoTimestamp) {
+                // Only ISO timestamp
+                timestamp = `${colorScheme.timestamp}[${isoTimestamp}]${colors.reset}`;
+            }
+            else if (config.includeLocalTime) {
+                // Only local time
+                timestamp = `${colorScheme.timeString}[${timeString}]${colors.reset}`;
+            }
+        }
+        const levelName = MessageFormatter.getLevelName(level);
+        const levelColor = MessageFormatter.getLevelColor(level);
+        const coloredLevel = `${levelColor}[${levelName}]${colors.reset}`;
+        // Format the base message (level is always included as per requirements)
+        let formattedMessage = `${timestamp}${coloredLevel}: ${message}`;
+        // Append data if provided
+        if (data !== undefined) {
+            const dataString = formatData(data);
+            const styledData = styleData(dataString, colorScheme);
+            formattedMessage += styledData;
+        }
+        // Always reset colors at the end of the entire log line
+        return formattedMessage + colors.reset;
+    }
+    /**
+       * Formats a Log Engine system message with [LOG ENGINE] prefix instead of log levels
+       * Used for internal messages like deprecation warnings that should be distinguished from user logs
+       * @param message - The system message content to format
+       * @param formatConfig - Optional format configuration to control element inclusion
+       * @returns Formatted string with ANSI colors, timestamps, and LOG ENGINE prefix
+       */
+    static formatSystemMessage(message, formatConfig) {
+        // Merge provided format configuration with the default configuration
+        const config = {
+            ...MessageFormatter.DEFAULT_FORMAT_CONFIG,
+            ...formatConfig
+        };
+        // Build timestamp string conditionally
+        let timestamp = '';
+        if (config.includeIsoTimestamp || config.includeLocalTime) {
+            const { isoTimestamp, timeString } = getTimestampComponents();
+            if (config.includeIsoTimestamp && config.includeLocalTime) {
+                // Both timestamps included
+                timestamp = formatTimestamp(isoTimestamp, timeString, colorScheme);
+            }
+            else if (config.includeIsoTimestamp) {
+                // Only ISO timestamp
+                timestamp = `${colorScheme.timestamp}[${isoTimestamp}]${colors.reset}`;
+            }
+            else if (config.includeLocalTime) {
+                // Only local time
+                timestamp = `${colorScheme.timeString}[${timeString}]${colors.reset}`;
+            }
+        }
+        const coloredLogEngine = `${colorScheme.system}[LOG ENGINE]${colors.reset}`;
+        const coloredMessage = `${colorScheme.system}${message}${colors.reset}`;
+        return `${timestamp}${coloredLogEngine}: ${coloredMessage}`;
+    }
+    /**
+       * Converts LogLevel enum to human-readable string
+       * @param level - The LogLevel to convert
+       * @returns String representation of the log level
+       */
+    static getLevelName(level) {
+        switch (level) {
+            case LogLevel.DEBUG: return 'DEBUG';
+            case LogLevel.INFO: return 'INFO';
+            case LogLevel.WARN: return 'WARN';
+            case LogLevel.ERROR: return 'ERROR';
+            case LogLevel.LOG: return 'LOG';
+            default: return 'UNKNOWN';
+        }
+    }
+    /**
+       * Maps LogLevel to appropriate ANSI color code
+       * Colors help quickly identify message severity in console output
+       * @param level - The LogLevel to get color for
+       * @returns ANSI color escape sequence
+       */
+    static getLevelColor(level) {
+        switch (level) {
+            case LogLevel.DEBUG: return colors.magenta; // Purple for debug info
+            case LogLevel.INFO: return colors.blue; // Blue for general info
+            case LogLevel.WARN: return colors.yellow; // Yellow for warnings
+            case LogLevel.ERROR: return colors.red; // Red for errors
+            case LogLevel.LOG: return colors.green; // Green for always-on log messages
+            default: return colors.white; // White for unknown levels
+        }
+    }
+}
+/**
+ * Default format configuration to avoid object recreation on every call
+ */
+MessageFormatter.DEFAULT_FORMAT_CONFIG = {
+    includeIsoTimestamp: true,
+    includeLocalTime: true
+};
+//# sourceMappingURL=message-formatter.js.map

package/dist/esm/formatter/message-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-formatter.js","sourceRoot":"","sources":["../../../src/formatter/message-formatter.ts"],"names":[],"mappings":"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"}

package/dist/esm/formatter/timestamp.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Timestamp formatting utilities
+ * Handles ISO timestamp and local time formatting for log messages
+ */
+/**
+ * Generates the current timestamp as both an ISO 8601 string and a compact US English local time string.
+ *
+ * @returns An object containing `isoTimestamp` (ISO 8601 format) and `timeString` (localized time string without spaces)
+ */
+export declare function getTimestampComponents(): {
+    isoTimestamp: string;
+    timeString: string;
+};
+/**
+ * Returns a formatted string combining an ISO timestamp and a local time string, each wrapped with specified color codes for console output.
+ *
+ * @param isoTimestamp - The ISO 8601 formatted timestamp to display
+ * @param timeString - The local time string to display
+ * @param colors - An object containing color codes for the timestamp, time string, and reset sequence
+ * @returns The combined, colorized timestamp string suitable for log messages
+ */
+export declare function formatTimestamp(isoTimestamp: string, timeString: string, colors: {
+    timestamp: string;
+    timeString: string;
+    reset: string;
+}): string;
+//# sourceMappingURL=timestamp.d.ts.map

package/dist/esm/formatter/timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../../src/formatter/timestamp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CAClB,CAaJ;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/D,MAAM,CAKR"}

package/dist/esm/formatter/timestamp.js

@@ -0,0 +1,36 @@
+/**
+ * Timestamp formatting utilities
+ * Handles ISO timestamp and local time formatting for log messages
+ */
+/**
+ * Generates the current timestamp as both an ISO 8601 string and a compact US English local time string.
+ *
+ * @returns An object containing `isoTimestamp` (ISO 8601 format) and `timeString` (localized time string without spaces)
+ */
+export function getTimestampComponents() {
+    const now = new Date();
+    const isoTimestamp = now.toISOString();
+    const timeString = now.toLocaleTimeString('en-US', {
+        hour: 'numeric',
+        minute: '2-digit',
+        hour12: true
+    }).replace(/\s+/g, '');
+    return {
+        isoTimestamp,
+        timeString
+    };
+}
+/**
+ * Returns a formatted string combining an ISO timestamp and a local time string, each wrapped with specified color codes for console output.
+ *
+ * @param isoTimestamp - The ISO 8601 formatted timestamp to display
+ * @param timeString - The local time string to display
+ * @param colors - An object containing color codes for the timestamp, time string, and reset sequence
+ * @returns The combined, colorized timestamp string suitable for log messages
+ */
+export function formatTimestamp(isoTimestamp, timeString, colors) {
+    const coloredTimestamp = `${colors.timestamp}[${isoTimestamp}]${colors.reset}`;
+    const coloredTimeString = `${colors.timeString}[${timeString}]${colors.reset}`;
+    return `${coloredTimestamp}${coloredTimeString}`;
+}
+//# sourceMappingURL=timestamp.js.map

package/dist/esm/formatter/timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../../src/formatter/timestamp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IAIpC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,YAAY,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACjD,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,IAAI;KACb,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEvB,OAAO;QACL,YAAY;QACZ,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAoB,EACpB,UAAkB,EAClB,MAAgE;IAEhE,MAAM,gBAAgB,GAAG,GAAG,MAAM,CAAC,SAAS,IAAI,YAAY,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/E,MAAM,iBAAiB,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,UAAU,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;IAE/E,OAAO,GAAG,gBAAgB,GAAG,iBAAiB,EAAE,CAAC;AACnD,CAAC"}