@wgtechlabs/log-engine 1.3.0 → 2.1.0

package/dist/logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqB,YAAY,EAAE,MAAM,SAAS,CAAC;AAI1D;;;GAGG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,MAAM,CAEZ;IAEF;;OAEG;;IAMH;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAyC9C;;;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;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAQxC;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAQvC;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAQvC;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAQxC;;;;;;;OAOG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAQtC;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO3C;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO1C;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO1C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO3C;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAM5C"}

package/dist/logger.js

@@ -1,265 +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
- * Includes automatic data redaction for sensitive information
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Logger = void 0;
-const types_1 = require("./types");
-const formatter_1 = require("./formatter");
-const redaction_1 = require("./redaction");
-/**
- * Logger class responsible for managing log output and configuration
- * Provides mode-based filtering and formatted console output
- */
-class Logger {
-    /**
-     * Logger constructor - sets up environment-based auto-configuration
-     */
-    constructor() {
-        // Internal configuration state with sensible defaults
-        this.config = {
-            mode: types_1.LogMode.INFO
-        };
-        // Set initial mode based on NODE_ENV for auto-configuration
-        this.config.mode = this.getEnvironmentMode();
-    }
-    /**
-     * Determines the appropriate log mode based on NODE_ENV
-     * @returns LogMode appropriate for current environment
-     */
-    getEnvironmentMode() {
-        const nodeEnv = process.env.NODE_ENV;
-        switch (nodeEnv) {
-            case 'development':
-                return types_1.LogMode.DEBUG; // Verbose logging for development
-            case 'production':
-                return types_1.LogMode.INFO; // Important info and above for production
-            case 'staging':
-                return types_1.LogMode.WARN; // Focused logging for staging
-            case 'test':
-                return types_1.LogMode.ERROR; // Minimal logging during tests
-            default:
-                return types_1.LogMode.INFO; // Default fallback for unknown environments
-        }
-    }
-    /**
-     * 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
-     * Also updates redaction configuration based on environment
-     * @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 };
-        }
-        // Update redaction configuration based on current environment
-        redaction_1.DataRedactor.updateConfig({
-            ...redaction_1.defaultRedactionConfig,
-            ...redaction_1.RedactionController.getEnvironmentConfig()
-        });
-    }
-    /**
-     * 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
-     * Automatically redacts sensitive data when provided
-     * @param message - The debug message to log
-     * @param data - Optional data object to log (will be redacted)
-     */
-    debug(message, data) {
-        if (this.shouldLog(types_1.LogLevel.DEBUG)) {
-            const processedData = redaction_1.DataRedactor.redactData(data);
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.DEBUG, message, processedData);
-            console.log(formatted);
-        }
-    }
-    /**
-     * Log an informational message with INFO level formatting
-     * Uses console.log for output with blue coloring
-     * Automatically redacts sensitive data when provided
-     * @param message - The info message to log
-     * @param data - Optional data object to log (will be redacted)
-     */
-    info(message, data) {
-        if (this.shouldLog(types_1.LogLevel.INFO)) {
-            const processedData = redaction_1.DataRedactor.redactData(data);
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.INFO, message, processedData);
-            console.log(formatted);
-        }
-    }
-    /**
-     * Log a warning message with WARN level formatting
-     * Uses console.warn for output with yellow coloring
-     * Automatically redacts sensitive data when provided
-     * @param message - The warning message to log
-     * @param data - Optional data object to log (will be redacted)
-     */
-    warn(message, data) {
-        if (this.shouldLog(types_1.LogLevel.WARN)) {
-            const processedData = redaction_1.DataRedactor.redactData(data);
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.WARN, message, processedData);
-            console.warn(formatted);
-        }
-    }
-    /**
-     * Log an error message with ERROR level formatting
-     * Uses console.error for output with red coloring
-     * Automatically redacts sensitive data when provided
-     * @param message - The error message to log
-     * @param data - Optional data object to log (will be redacted)
-     */
-    error(message, data) {
-        if (this.shouldLog(types_1.LogLevel.ERROR)) {
-            const processedData = redaction_1.DataRedactor.redactData(data);
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.ERROR, message, processedData);
-            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
-     * Automatically redacts sensitive data when provided
-     * @param message - The critical log message to log
-     * @param data - Optional data object to log (will be redacted)
-     */
-    log(message, data) {
-        if (this.shouldLog(types_1.LogLevel.LOG)) {
-            const processedData = redaction_1.DataRedactor.redactData(data);
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.LOG, message, processedData);
-            console.log(formatted);
-        }
-    }
-    /**
-     * Log a debug message without redaction (use with caution)
-     * Bypasses automatic data redaction for debugging purposes
-     * @param message - The debug message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    debugRaw(message, data) {
-        if (this.shouldLog(types_1.LogLevel.DEBUG)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.DEBUG, message, data);
-            console.log(formatted);
-        }
-    }
-    /**
-     * Log an info message without redaction (use with caution)
-     * Bypasses automatic data redaction for debugging purposes
-     * @param message - The info message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    infoRaw(message, data) {
-        if (this.shouldLog(types_1.LogLevel.INFO)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.INFO, message, data);
-            console.log(formatted);
-        }
-    }
-    /**
-     * Log a warning message without redaction (use with caution)
-     * Bypasses automatic data redaction for debugging purposes
-     * @param message - The warning message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    warnRaw(message, data) {
-        if (this.shouldLog(types_1.LogLevel.WARN)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.WARN, message, data);
-            console.warn(formatted);
-        }
-    }
-    /**
-     * Log an error message without redaction (use with caution)
-     * Bypasses automatic data redaction for debugging purposes
-     * @param message - The error message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    errorRaw(message, data) {
-        if (this.shouldLog(types_1.LogLevel.ERROR)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.ERROR, message, data);
-            console.error(formatted);
-        }
-    }
-    /**
-     * Log a critical message without redaction (use with caution)
-     * Bypasses automatic data redaction for debugging purposes
-     * @param message - The critical log message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    logRaw(message, data) {
-        if (this.shouldLog(types_1.LogLevel.LOG)) {
-            const formatted = formatter_1.LogFormatter.format(types_1.LogLevel.LOG, message, data);
-            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
-};