@wgtechlabs/log-engine 2.0.0 → 2.1.0

package/dist/logger/config.js

@@ -19,18 +19,18 @@ class LoggerConfigManager {
         };
     }
     /**
-     * Get current configuration
-     * @returns Current logger configuration
-     */
+       * Get current configuration
+       * @returns Current logger configuration
+       */
     getConfig() {
         return { ...this.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
-     */
+       * 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
+       */
     updateConfig(config) {
         // Handle backwards compatibility - if level is provided but mode is not
         if (config.level !== undefined && config.mode === undefined) {
@@ -40,6 +40,7 @@ class LoggerConfigManager {
             // Normal configuration update
             // If mode is present, remove legacy level property to avoid conflicts
             if (config.mode !== undefined && config.level !== undefined) {
+                // eslint-disable-next-line @typescript-eslint/no-unused-vars
                 const { level, ...configWithoutLevel } = config;
                 this.config = { ...this.config, ...configWithoutLevel };
             }
@@ -49,9 +50,9 @@ class LoggerConfigManager {
         }
     }
     /**
-     * Handle legacy level-based configuration with deprecation warnings
-     * @param config - Configuration containing legacy level property
-     */
+       * Handle legacy level-based configuration with deprecation warnings
+       * @param config - Configuration containing legacy level property
+       */
     handleLegacyLevelConfig(config) {
         // Map legacy level values to new LogMode values and validate first
         const levelValue = config.level;
@@ -66,34 +67,36 @@ class LoggerConfigManager {
         }
         // Merge existing config with all keys from the passed config, and override mode with mapped value
         // Remove the legacy 'level' property to avoid conflicts with the new 'mode' property
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
         const { level, ...configWithoutLevel } = config;
         this.config = { ...this.config, ...configWithoutLevel, mode: mappedMode };
     }
     /**
-     * Map legacy LogLevel values to LogMode values
-     * @param levelValue - Legacy level value
-     * @returns Corresponding LogMode or undefined if invalid
-     */
+       * Map legacy LogLevel values to LogMode values
+       * @param levelValue - Legacy level value
+       * @returns Corresponding LogMode or undefined if invalid
+       */
     mapLevelToMode(levelValue) {
-        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
-        };
-        return levelToModeMap[levelValue];
+        // Use switch statement to avoid object injection
+        switch (levelValue) {
+            case types_1.LogLevel.DEBUG: return types_1.LogMode.DEBUG; // 0 -> 0
+            case types_1.LogLevel.INFO: return types_1.LogMode.INFO; // 1 -> 1
+            case types_1.LogLevel.WARN: return types_1.LogMode.WARN; // 2 -> 2
+            case types_1.LogLevel.ERROR: return types_1.LogMode.ERROR; // 3 -> 3
+            case types_1.LogLevel.LOG: return types_1.LogMode.SILENT; // 99 -> 4 (preserves critical-only behavior)
+            case 4: return types_1.LogMode.SILENT; // Legacy SILENT -> 4
+            case 5: return types_1.LogMode.OFF; // Legacy OFF -> 5
+            default: return undefined;
+        }
     }
     /**
-     * Create deprecation warning message using LogFormatter
-     * Outputs formatted deprecation warning messages to console
-     */
+       * Create deprecation warning message using LogFormatter
+       * Outputs formatted deprecation warning messages to console
+       */
     createDeprecationWarning() {
         // Import LogFormatter to format system messages properly
         const { LogFormatter } = require('../formatter');
-        console.warn(LogFormatter.formatSystemMessage('⚠️  DEPRECATION WARNING: The "level" configuration is deprecated and will be removed in v2.0.0. Please use "mode" instead.'));
+        console.warn(LogFormatter.formatSystemMessage('⚠️  DEPRECATION WARNING: The "level" configuration is deprecated and will be removed in v3.0.0. Please use "mode" instead.'));
         console.warn(LogFormatter.formatSystemMessage('   Migration: LogEngine.configure({ level: LogLevel.DEBUG }) → LogEngine.configure({ mode: LogMode.DEBUG })'));
         console.warn(LogFormatter.formatSystemMessage('   See: https://github.com/wgtechlabs/log-engine#migration-guide-loglevel--logmode'));
     }

package/dist/logger/core.d.ts

@@ -5,7 +5,7 @@
  * Uses colorized console output with timestamps for better readability
  * Includes automatic data redaction for sensitive information
  */
-import { LoggerConfig } from '../types';
+import { LoggerConfig, LogData } from '../types';
 /**
  * Logger class responsible for managing log output and configuration
  * Provides mode-based filtering and formatted console output
@@ -13,96 +13,140 @@ import { LoggerConfig } from '../types';
 export declare class Logger {
     private configManager;
     /**
-     * Logger constructor - sets up environment-based auto-configuration
-     */
+       * Logger constructor - sets up environment-based auto-configuration
+       */
     constructor();
     /**
-     * Updates logger configuration with new settings
-     * Also updates redaction configuration based on environment
-     * @param config - Partial configuration object to apply
-     */
+       * Built-in output handlers for common use cases
+       */
+    private getBuiltInHandler;
+    /**
+       * Process a single output target with error handling
+       * @param output - Single output target to process
+       * @param level - Log level
+       * @param rawMessage - Original unformatted message
+       * @param formattedMessage - Formatted message for console-based outputs
+       * @param data - Optional data
+       * @param isEnhanced - Whether this is an enhanced output (supports configured handler objects)
+       */
+    private processSingleOutput;
+    /**
+       * Process multiple output targets
+       * @param outputs - Array of output targets to process
+       * @param level - Log level
+       * @param rawMessage - Original unformatted message
+       * @param formattedMessage - Formatted message for console-based outputs
+       * @param data - Optional data
+       */
+    private processOutputs;
+    /**
+       * Process enhanced output targets
+       * @param enhancedOutputs - Array of enhanced output targets to process
+       * @param level - Log level
+       * @param rawMessage - Original unformatted message
+       * @param formattedMessage - Formatted message for console-based outputs
+       * @param data - Optional data
+       */
+    private processEnhancedOutputs;
+    /**
+       * Updates logger configuration with new settings
+       * Also updates redaction configuration based on environment
+       * @param config - Partial configuration object to apply
+       */
     configure(config: Partial<LoggerConfig>): void;
     /**
-     * Get current logger configuration
-     * @returns Current logger configuration
-     */
+       * Get current logger configuration
+       * @returns Current logger configuration
+       */
     getConfig(): LoggerConfig;
     /**
-     * Determines if a message should be logged based on current log mode
-     * @param level - The log level of the message to check
-     * @returns true if message should be logged, false otherwise
-     */
+       * Determines if a message should be logged based on current log mode
+       * @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
-     * 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: string, data?: any): void;
-    /**
-     * 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: string, data?: any): void;
-    /**
-     * 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: string, data?: any): void;
-    /**
-     * 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: string, data?: any): void;
-    /**
-     * Log a message with LOG level formatting (always outputs unless mode is OFF)
-     * Uses console.log for output with green coloring
-     * LOG level bypasses normal filtering and always outputs (except when OFF is set)
-     * Automatically redacts sensitive data when provided
-     * @param message - The log message to output
-     * @param data - Optional data object to log (will be redacted)
-     */
-    log(message: string, data?: any): void;
-    /**
-     * Log a debug message without data redaction
-     * @param message - The debug message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    debugRaw(message: string, data?: any): void;
-    /**
-     * Log an info message without data redaction
-     * @param message - The info message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    infoRaw(message: string, data?: any): void;
-    /**
-     * Log a warning message without data redaction
-     * @param message - The warning message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    warnRaw(message: string, data?: any): void;
-    /**
-     * Log an error message without data redaction
-     * @param message - The error message to log
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    errorRaw(message: string, data?: any): void;
-    /**
-     * Log a message without data redaction (always outputs unless mode is OFF)
-     * @param message - The log message to output
-     * @param data - Optional data object to log (no redaction applied)
-     */
-    logRaw(message: string, data?: any): void;
+       * Writes log output using configured output handler or default console methods
+       * Supports single output handler, multiple outputs, and enhanced outputs
+       * Priority: outputs > enhancedOutputs > outputHandler > default console
+       * @param level - The log level as a string
+       * @param rawMessage - The original unformatted message
+       * @param formattedMessage - The pre-formatted message to output
+       * @param data - Optional data object that was logged
+       * @param isError - Whether this is an error level message (for console.error)
+       * @param isWarn - Whether this is a warning level message (for console.warn)
+       */
+    private writeToOutput;
+    /**
+       * 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: string, data?: LogData): void;
+    /**
+       * 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: string, data?: LogData): void;
+    /**
+       * 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: string, data?: LogData): void;
+    /**
+       * 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: string, data?: LogData): void;
+    /**
+       * Log a message with LOG level formatting (always outputs unless mode is OFF)
+       * Uses console.log for output with green coloring
+       * LOG level bypasses normal filtering and always outputs (except when OFF is set)
+       * Automatically redacts sensitive data when provided
+       * @param message - The log message to output
+       * @param data - Optional data object to log (will be redacted)
+       */
+    log(message: string, data?: LogData): void;
+    /**
+       * Log a debug message without data redaction
+       * @param message - The debug message to log
+       * @param data - Optional data object to log (no redaction applied)
+       */
+    debugRaw(message: string, data?: LogData): void;
+    /**
+       * Log an info message without data redaction
+       * @param message - The info message to log
+       * @param data - Optional data object to log (no redaction applied)
+       */
+    infoRaw(message: string, data?: LogData): void;
+    /**
+       * Log a warning message without data redaction
+       * @param message - The warning message to log
+       * @param data - Optional data object to log (no redaction applied)
+       */
+    warnRaw(message: string, data?: LogData): void;
+    /**
+       * Log an error message without data redaction
+       * @param message - The error message to log
+       * @param data - Optional data object to log (no redaction applied)
+       */
+    errorRaw(message: string, data?: LogData): void;
+    /**
+       * Log a message without data redaction (always outputs unless mode is OFF)
+       * @param message - The log message to output
+       * @param data - Optional data object to log (no redaction applied)
+       */
+    logRaw(message: string, data?: LogData): void;
 }
 //# sourceMappingURL=core.d.ts.map

package/dist/logger/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/logger/core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqB,YAAY,EAAE,MAAM,UAAU,CAAC;AAM3D;;;GAGG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,aAAa,CAAsB;IAE3C;;OAEG;;IAKH;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAU9C;;;OAGG;IACH,SAAS,IAAI,YAAY;IAIzB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAMjB;;;;;;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;IAStC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO3C;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO1C;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO1C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAO3C;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAM5C"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/logger/core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqB,YAAY,EAAwD,OAAO,EAAE,MAAM,UAAU,CAAC;AAO1H;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,aAAa,CAAsB;IAE3C;;SAEK;;IAKL;;SAEK;IAEL,OAAO,CAAC,iBAAiB;IAsCzB;;;;;;;;SAQK;IACL,OAAO,CAAC,mBAAmB;IA6C3B;;;;;;;SAOK;IACL,OAAO,CAAC,cAAc;IAMtB;;;;;;;SAOK;IACL,OAAO,CAAC,sBAAsB;IAM9B;;;;SAIK;IACL,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAU9C;;;SAGK;IACL,SAAS,IAAI,YAAY;IAIzB;;;;SAIK;IACL,OAAO,CAAC,SAAS;IAMjB;;;;;;;;;;SAUK;IACL,OAAO,CAAC,aAAa;IAkDrB;;;;;;SAMK;IACL,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAQ5C;;;;;;SAMK;IACL,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAQ3C;;;;;;SAMK;IACL,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAQ3C;;;;;;SAMK;IACL,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAQ5C;;;;;;;SAOK;IACL,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAS1C;;;;SAIK;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAO/C;;;;SAIK;IACL,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAO9C;;;;SAIK;IACL,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAO9C;;;;SAIK;IACL,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAO/C;;;;SAIK;IACL,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;CAM9C"}