@wgtechlabs/log-engine 1.2.1 → 2.0.0

package/dist/formatter.js

@@ -1,103 +0,0 @@
-"use strict";
-/**
- * Log message formatter that provides colorized console output with timestamps
- * Handles ANSI color codes and structured log message formatting
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogFormatter = void 0;
-const types_1 = require("./types");
-/**
- * LogFormatter class responsible for formatting log messages with colors and timestamps
- * Creates readable, colored console output with ISO timestamps and local time
- */
-class LogFormatter {
-    /**
-     * Formats a log message with timestamp, level indicator, and appropriate coloring
-     * Creates a structured log entry: [ISO_TIMESTAMP][LOCAL_TIME][LEVEL]: message
-     * @param level - The log level to format for
-     * @param message - The message content to format
-     * @returns Formatted string with ANSI colors and timestamps
-     */
-    static format(level, message) {
-        const now = new Date();
-        const isoTimestamp = now.toISOString();
-        const timeString = now.toLocaleTimeString('en-US', {
-            hour: 'numeric',
-            minute: '2-digit',
-            hour12: true
-        }).replace(/\s+/g, '');
-        const levelName = this.getLevelName(level);
-        const levelColor = this.getLevelColor(level);
-        // Apply colors to each component for better readability
-        const coloredTimestamp = `${this.colors.gray}[${isoTimestamp}]${this.colors.reset}`;
-        const coloredTimeString = `${this.colors.cyan}[${timeString}]${this.colors.reset}`;
-        const coloredLevel = `${levelColor}[${levelName}]${this.colors.reset}`;
-        return `${coloredTimestamp}${coloredTimeString}${coloredLevel}: ${message}`;
-    }
-    /**
-     * 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
-     * @returns Formatted string with ANSI colors, timestamps, and LOG ENGINE prefix
-     */
-    static formatSystemMessage(message) {
-        const now = new Date();
-        const isoTimestamp = now.toISOString();
-        const timeString = now.toLocaleTimeString('en-US', {
-            hour: 'numeric',
-            minute: '2-digit',
-            hour12: true
-        }).replace(/\s+/g, '');
-        // Apply colors to each component for better readability
-        const coloredTimestamp = `${LogFormatter.colors.gray}[${isoTimestamp}]${LogFormatter.colors.reset}`;
-        const coloredTimeString = `${LogFormatter.colors.cyan}[${timeString}]${LogFormatter.colors.reset}`;
-        const coloredLogEngine = `${LogFormatter.colors.yellow}[LOG ENGINE]${LogFormatter.colors.reset}`;
-        const coloredMessage = `${LogFormatter.colors.yellow}${message}${LogFormatter.colors.reset}`;
-        return `${coloredTimestamp}${coloredTimeString}${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 types_1.LogLevel.DEBUG: return 'DEBUG';
-            case types_1.LogLevel.INFO: return 'INFO';
-            case types_1.LogLevel.WARN: return 'WARN';
-            case types_1.LogLevel.ERROR: return 'ERROR';
-            case types_1.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 types_1.LogLevel.DEBUG: return this.colors.magenta; // Purple for debug info
-            case types_1.LogLevel.INFO: return this.colors.blue; // Blue for general info
-            case types_1.LogLevel.WARN: return this.colors.yellow; // Yellow for warnings
-            case types_1.LogLevel.ERROR: return this.colors.red; // Red for errors
-            case types_1.LogLevel.LOG: return this.colors.green; // Green for always-on log messages
-            default: return this.colors.white; // White for unknown levels
-        }
-    }
-}
-exports.LogFormatter = LogFormatter;
-// ANSI color codes for terminal output styling
-LogFormatter.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)
-};

package/dist/logger.d.ts

@@ -1,72 +0,0 @@
-/**
- * Core Logger class that handles log message output with configurable levels
- * Supports DEBUG, INFO, WARN, ERROR, and LOG levels with intelligent filtering
- * LOG level always outputs regardless of configuration
- * Uses colorized console output with timestamps for better readability
- */
-import { LoggerConfig } from './types';
-/**
- * Logger class responsible for managing log output and configuration
- * Provides mode-based filtering and formatted console output
- */
-export declare class Logger {
-    private config;
-    /**
-     * Updates logger configuration with new settings
-     * Merges provided config with existing settings (partial update)
-     * Supports backwards compatibility by mapping level to mode with deprecation warnings
-     * @param config - Partial configuration object to apply
-     */
-    configure(config: Partial<LoggerConfig>): void;
-    /**
-     * Maps LogLevel values to severity ranks for consistent comparison
-     * This prevents issues if enum numeric values change in the future
-     */
-    private static readonly SEVERITY_RANKS;
-    /**
-     * Maps LogMode values to minimum severity rank required for output
-     * This defines the filtering threshold for each mode
-     */
-    private static readonly MODE_THRESHOLDS;
-    /**
-     * Determines if a message should be logged based on current log mode
-     * Messages are shown only if their level is appropriate for the configured mode
-     * LOG level is special - it always outputs regardless of configured mode (except when OFF is set)
-     * OFF mode disables all logging including LOG level messages
-     * @param level - The log level of the message to check
-     * @returns true if message should be logged, false otherwise
-     */
-    private shouldLog;
-    /**
-     * Log a debug message with DEBUG level formatting
-     * Uses console.log for output with purple/magenta coloring
-     * @param message - The debug message to log
-     */
-    debug(message: string): void;
-    /**
-     * Log an informational message with INFO level formatting
-     * Uses console.log for output with blue coloring
-     * @param message - The info message to log
-     */
-    info(message: string): void;
-    /**
-     * Log a warning message with WARN level formatting
-     * Uses console.warn for output with yellow coloring
-     * @param message - The warning message to log
-     */
-    warn(message: string): void;
-    /**
-     * Log an error message with ERROR level formatting
-     * Uses console.error for output with red coloring
-     * @param message - The error message to log
-     */
-    error(message: string): void;
-    /**
-     * Log a critical message that always outputs (LOG level)
-     * Uses console.log for output with green coloring
-     * Always shown regardless of configured log level
-     * @param message - The critical log message to log
-     */
-    log(message: string): void;
-}
-//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAqB,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1D;;;GAGG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,MAAM,CAEZ;IAEF;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAmC9C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAMpC;IAEF;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAOrC;IAEF;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAajB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO3B;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO3B;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAM7B"}

package/dist/logger.js

@@ -1,158 +0,0 @@
-"use strict";
-/**
- * Core Logger class that handles log message output with configurable levels
- * Supports DEBUG, INFO, WARN, ERROR, and LOG levels with intelligent filtering
- * LOG level always outputs regardless of configuration
- * Uses colorized console output with timestamps for better readability
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Logger = void 0;
-const types_1 = require("./types");
-const formatter_1 = require("./formatter");
-/**
- * Logger class responsible for managing log output and configuration
- * Provides mode-based filtering and formatted console output
- */
-class Logger {
-    constructor() {
-        // Internal configuration state with sensible defaults
-        this.config = {
-            mode: types_1.LogMode.INFO
-        };
-    }
-    /**
-     * Updates logger configuration with new settings
-     * Merges provided config with existing settings (partial update)
-     * Supports backwards compatibility by mapping level to mode with deprecation warnings
-     * @param config - Partial configuration object to apply
-     */
-    configure(config) {
-        // Handle backwards compatibility - if level is provided but mode is not
-        if (config.level !== undefined && config.mode === undefined) {
-            // Only show deprecation warning in non-test environments
-            if (process.env.NODE_ENV !== 'test') {
-                console.warn(formatter_1.LogFormatter.formatSystemMessage('⚠️  DEPRECATION WARNING: The "level" configuration is deprecated and will be removed in v2.0.0. Please use "mode" instead.'));
-                console.warn(formatter_1.LogFormatter.formatSystemMessage('   Migration: LogEngine.configure({ level: LogLevel.DEBUG }) → LogEngine.configure({ mode: LogMode.DEBUG })'));
-                console.warn(formatter_1.LogFormatter.formatSystemMessage('   See: https://github.com/wgtechlabs/log-engine#migration-guide-loglevel--logmode'));
-            }
-            // Map legacy level values to new LogMode values (including SILENT=4, OFF=5)
-            // This provides backwards compatibility for all legacy values
-            const levelValue = config.level;
-            const levelToModeMap = {
-                [types_1.LogLevel.DEBUG]: types_1.LogMode.DEBUG, // 0 -> 0
-                [types_1.LogLevel.INFO]: types_1.LogMode.INFO, // 1 -> 1
-                [types_1.LogLevel.WARN]: types_1.LogMode.WARN, // 2 -> 2
-                [types_1.LogLevel.ERROR]: types_1.LogMode.ERROR, // 3 -> 3
-                [types_1.LogLevel.LOG]: types_1.LogMode.SILENT, // 99 -> 4 (preserves critical-only behavior)
-                4: types_1.LogMode.SILENT, // Legacy SILENT -> 4
-                5: types_1.LogMode.OFF // Legacy OFF -> 5
-            };
-            const mappedMode = levelToModeMap[levelValue];
-            if (mappedMode === undefined) {
-                throw new Error(`Invalid LogLevel value: ${config.level}. Valid values are: DEBUG(0), INFO(1), WARN(2), ERROR(3), LOG(99), or use LogMode instead.`);
-            }
-            this.config = { ...this.config, mode: mappedMode };
-        }
-        else {
-            // Normal configuration update
-            this.config = { ...this.config, ...config };
-        }
-    }
-    /**
-     * Determines if a message should be logged based on current log mode
-     * Messages are shown only if their level is appropriate for the configured mode
-     * LOG level is special - it always outputs regardless of configured mode (except when OFF is set)
-     * OFF mode disables all logging including LOG level messages
-     * @param level - The log level of the message to check
-     * @returns true if message should be logged, false otherwise
-     */
-    shouldLog(level) {
-        const currentMode = this.config.mode !== undefined ? this.config.mode : types_1.LogMode.INFO;
-        // Get the severity rank for the message level
-        const messageSeverity = Logger.SEVERITY_RANKS[level];
-        // Get the minimum severity threshold for the current mode
-        const modeThreshold = Logger.MODE_THRESHOLDS[currentMode];
-        // Allow the message if its severity meets or exceeds the mode threshold
-        return messageSeverity >= modeThreshold;
-    }
-    /**
-     * Log a debug message with DEBUG level formatting
-     * Uses console.log for output with purple/magenta coloring
-     * @param message - The debug message to log
-     */
-    debug(message) {
-        if (this.shouldLog(types_1.LogLevel.DEBUG)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.DEBUG, message);
-            console.log(formatted);
-        }
-    }
-    /**
-     * Log an informational message with INFO level formatting
-     * Uses console.log for output with blue coloring
-     * @param message - The info message to log
-     */
-    info(message) {
-        if (this.shouldLog(types_1.LogLevel.INFO)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.INFO, message);
-            console.log(formatted);
-        }
-    }
-    /**
-     * Log a warning message with WARN level formatting
-     * Uses console.warn for output with yellow coloring
-     * @param message - The warning message to log
-     */
-    warn(message) {
-        if (this.shouldLog(types_1.LogLevel.WARN)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.WARN, message);
-            console.warn(formatted);
-        }
-    }
-    /**
-     * Log an error message with ERROR level formatting
-     * Uses console.error for output with red coloring
-     * @param message - The error message to log
-     */
-    error(message) {
-        if (this.shouldLog(types_1.LogLevel.ERROR)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.ERROR, message);
-            console.error(formatted);
-        }
-    }
-    /**
-     * Log a critical message that always outputs (LOG level)
-     * Uses console.log for output with green coloring
-     * Always shown regardless of configured log level
-     * @param message - The critical log message to log
-     */
-    log(message) {
-        if (this.shouldLog(types_1.LogLevel.LOG)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.LOG, message);
-            console.log(formatted);
-        }
-    }
-}
-exports.Logger = Logger;
-/**
- * Maps LogLevel values to severity ranks for consistent comparison
- * This prevents issues if enum numeric values change in the future
- */
-Logger.SEVERITY_RANKS = {
-    [types_1.LogLevel.DEBUG]: 0,
-    [types_1.LogLevel.INFO]: 1,
-    [types_1.LogLevel.WARN]: 2,
-    [types_1.LogLevel.ERROR]: 3,
-    [types_1.LogLevel.LOG]: 99 // Special case - always outputs (except when OFF)
-};
-/**
- * Maps LogMode values to minimum severity rank required for output
- * This defines the filtering threshold for each mode
- */
-Logger.MODE_THRESHOLDS = {
-    [types_1.LogMode.DEBUG]: 0, // Shows DEBUG and above
-    [types_1.LogMode.INFO]: 1, // Shows INFO and above
-    [types_1.LogMode.WARN]: 2, // Shows WARN and above
-    [types_1.LogMode.ERROR]: 3, // Shows ERROR and above
-    [types_1.LogMode.SILENT]: 99, // Only shows LOG messages
-    [types_1.LogMode.OFF]: 100 // Shows nothing
-};