@wgtechlabs/log-engine 2.1.0 → 2.2.0

package/dist/esm/redaction/redactor.js

@@ -0,0 +1,259 @@
+/**
+ * Core data redaction engine
+ * Handles automatic detection and redaction of sensitive information in log data
+ */
+import { defaultRedactionConfig, RedactionController } from './config.js';
+/**
+ * DataRedactor class - Core redaction logic for processing log data
+ * Automatically detects and redacts sensitive information while preserving structure
+ */
+export class DataRedactor {
+    /**
+       * Update the redaction configuration with new settings
+       * Merges provided config with existing settings and reloads environment variables
+       * @param newConfig - Partial configuration to merge with current settings
+       */
+    static updateConfig(newConfig) {
+        // Reload environment configuration to pick up any changes
+        const envConfig = RedactionController.getEnvironmentConfig();
+        DataRedactor.config = {
+            ...defaultRedactionConfig,
+            ...envConfig,
+            ...newConfig
+        };
+    }
+    /**
+       * Get the current redaction configuration
+       * @returns Deep copy of current redaction configuration
+       */
+    static getConfig() {
+        return {
+            ...DataRedactor.config,
+            sensitiveFields: [...DataRedactor.config.sensitiveFields],
+            contentFields: [...DataRedactor.config.contentFields],
+            customPatterns: DataRedactor.config.customPatterns ? [...DataRedactor.config.customPatterns] : undefined
+        };
+    }
+    /**
+       * Refresh configuration from environment variables
+       * Useful for picking up runtime environment changes
+       */
+    static refreshConfig() {
+        const envConfig = RedactionController.getEnvironmentConfig();
+        DataRedactor.config = {
+            ...defaultRedactionConfig,
+            ...envConfig
+        };
+    }
+    /**
+       * Add custom regex patterns for advanced field detection
+       * @param patterns - Array of regex patterns to add
+       */
+    static addCustomPatterns(patterns) {
+        const currentPatterns = DataRedactor.config.customPatterns || [];
+        DataRedactor.config = {
+            ...DataRedactor.config,
+            customPatterns: [...currentPatterns, ...patterns]
+        };
+    }
+    /**
+       * Clear all custom regex patterns
+       */
+    static clearCustomPatterns() {
+        DataRedactor.config = {
+            ...DataRedactor.config,
+            customPatterns: []
+        };
+    }
+    /**
+       * Add custom sensitive field names to the existing list
+       * @param fields - Array of field names to add
+       */
+    static addSensitiveFields(fields) {
+        DataRedactor.config = {
+            ...DataRedactor.config,
+            sensitiveFields: [...DataRedactor.config.sensitiveFields, ...fields]
+        };
+    }
+    /**
+       * Test if a field name would be redacted with current configuration
+       * @param fieldName - Field name to test
+       * @returns true if field would be redacted, false otherwise
+       */
+    static testFieldRedaction(fieldName) {
+        const testObj = { [fieldName]: 'test-value' };
+        const result = DataRedactor.redactData(testObj); // Use safe property access to prevent object injection
+        if (Object.prototype.hasOwnProperty.call(result, fieldName)) {
+            // Safe access to avoid object injection
+            const value = result[fieldName];
+            return value !== 'test-value';
+        }
+        return false;
+    }
+    /**
+       * Main entry point for data redaction
+       * Processes any type of data and returns a redacted version
+       * @param data - Data to be processed for redaction
+       * @returns Redacted version of the data
+       */
+    static redactData(data) {
+        // Skip processing if redaction is disabled or data is null/undefined
+        if (!DataRedactor.config.enabled || data === null || data === undefined) {
+            return data;
+        }
+        return DataRedactor.processValue(data, new WeakSet(), 0);
+    }
+    /**
+       * Process a value of any type (primitive, object, array)
+       * Recursively handles nested structures when deepRedaction is enabled
+       * Includes circular reference protection and recursion depth limiting
+       * @param value - Value to process
+       * @param visited - Set to track visited objects (prevents circular references)
+       * @param depth - Current recursion depth (prevents stack overflow)
+       * @returns Processed value with redaction applied
+       */
+    static processValue(value, visited = new WeakSet(), depth = 0) {
+        // Check recursion depth limit to prevent stack overflow
+        if (depth >= DataRedactor.MAX_RECURSION_DEPTH) {
+            return '[Max Depth Exceeded]';
+        }
+        // Handle null and undefined
+        if (value === null || value === undefined) {
+            return value;
+        }
+        // Handle arrays - process each element
+        if (Array.isArray(value)) {
+            // Check for circular reference
+            if (visited.has(value)) {
+                return '[Circular Array]';
+            }
+            visited.add(value);
+            const result = value.map(item => DataRedactor.processValue(item, visited, depth + 1));
+            // Keep value in visited set to detect circular references across branches
+            return result;
+        }
+        // Handle objects - process each property
+        if (typeof value === 'object') {
+            // Check for circular reference
+            if (visited.has(value)) {
+                return '[Circular Object]';
+            }
+            visited.add(value);
+            const result = DataRedactor.redactObject(value, visited, depth + 1);
+            // Keep value in visited set to detect circular references across branches
+            return result;
+        }
+        // Handle primitives (string, number, boolean) - return as-is
+        return value;
+    }
+    /**
+       * Process an object and redact sensitive fields
+       * Handles field-level redaction and content truncation
+       * @param obj - Object to process
+       * @param visited - Set to track visited objects (prevents circular references)
+       * @param depth - Current recursion depth (prevents stack overflow)
+       * @returns Object with sensitive fields redacted
+       */
+    static redactObject(obj, visited = new WeakSet(), depth = 0) {
+        // Check recursion depth limit to prevent stack overflow
+        if (depth >= DataRedactor.MAX_REDACT_OBJECT_DEPTH) {
+            return { '[Max Depth Exceeded]': '[Max Depth Exceeded]' };
+        }
+        const redacted = {};
+        for (const [key, value] of Object.entries(obj)) {
+            // Check if this field should be completely redacted
+            if (DataRedactor.isSensitiveField(key)) {
+                Object.defineProperty(redacted, key, { value: DataRedactor.config.redactionText, enumerable: true, writable: true, configurable: true });
+            }
+            else if (DataRedactor.isContentField(key) && typeof value === 'string') {
+                // Check if this field should be truncated (for large content)
+                Object.defineProperty(redacted, key, { value: DataRedactor.truncateContent(value), enumerable: true, writable: true, configurable: true });
+            }
+            else if (DataRedactor.config.deepRedaction && (typeof value === 'object' && value !== null)) {
+                // Recursively process nested objects/arrays if deep redaction is enabled
+                Object.defineProperty(redacted, key, { value: DataRedactor.processValue(value, visited, depth + 1), enumerable: true, writable: true, configurable: true });
+            }
+            else {
+                // Keep the value unchanged
+                Object.defineProperty(redacted, key, { value: value, enumerable: true, writable: true, configurable: true });
+            }
+        }
+        return redacted;
+    }
+    /**
+       * Check if a field name indicates sensitive information
+       * Uses case-insensitive matching with exact and partial matches
+       * Includes smart filtering to avoid false positives and custom patterns
+       * @param fieldName - Field name to check
+       * @returns true if field should be redacted, false otherwise
+       */
+    static isSensitiveField(fieldName) {
+        const lowerField = fieldName.toLowerCase();
+        // Check custom regex patterns first (highest priority)
+        if (DataRedactor.config.customPatterns && DataRedactor.config.customPatterns.length > 0) {
+            for (const pattern of DataRedactor.config.customPatterns) {
+                if (pattern.test(fieldName)) {
+                    return true;
+                }
+            }
+        }
+        return DataRedactor.config.sensitiveFields.some(sensitive => {
+            const lowerSensitive = sensitive.toLowerCase();
+            // Exact match (highest confidence)
+            if (lowerField === lowerSensitive) {
+                return true;
+            }
+            // Field ends with sensitive term (e.g., "userPassword" ends with "password")
+            if (lowerField.endsWith(lowerSensitive)) {
+                return true;
+            }
+            // Field starts with sensitive term (e.g., "passwordHash" starts with "password")
+            if (lowerField.startsWith(lowerSensitive)) {
+                return true;
+            }
+            // Whitelist of short sensitive terms that should always trigger substring matching
+            const shortSensitiveWhitelist = ['pin', 'cvv', 'cvc', 'ssn', 'pwd', 'key', 'jwt', 'dob', 'pii', 'auth', 'csrf'];
+            // Field contains sensitive term - either from whitelist or length >= 5 to avoid false positives
+            if ((shortSensitiveWhitelist.includes(lowerSensitive) || lowerSensitive.length >= 5) &&
+                lowerField.includes(lowerSensitive)) {
+                return true;
+            }
+            // Handle compound words with underscores or camelCase
+            if (lowerField.includes('_' + lowerSensitive) || lowerField.includes(lowerSensitive + '_')) {
+                return true;
+            }
+            return false;
+        });
+    }
+    /**
+       * Check if a field name indicates content that should be truncated
+       * Uses exact case-insensitive matching for content fields
+       * @param fieldName - Field name to check
+       * @returns true if field is a content field, false otherwise
+       */
+    static isContentField(fieldName) {
+        const lowerField = fieldName.toLowerCase();
+        return DataRedactor.config.contentFields.some(content => content.toLowerCase() === lowerField);
+    }
+    /**
+       * Truncate content that exceeds the maximum length
+       * Preserves readability while preventing log bloat
+       * @param content - Content string to potentially truncate
+       * @returns Original content or truncated version with indicator
+       */
+    static truncateContent(content) {
+        if (content.length <= DataRedactor.config.maxContentLength) {
+            return content;
+        }
+        return content.substring(0, DataRedactor.config.maxContentLength) + DataRedactor.config.truncationText;
+    }
+}
+DataRedactor.config = {
+    ...defaultRedactionConfig,
+    ...RedactionController.getEnvironmentConfig()
+};
+// Maximum recursion depth to prevent stack overflow attacks
+DataRedactor.MAX_RECURSION_DEPTH = 100;
+// Slightly lower limit for redactObject to ensure it can be reached
+DataRedactor.MAX_REDACT_OBJECT_DEPTH = 99;
+//# sourceMappingURL=redactor.js.map

package/dist/esm/redaction/redactor.js.map

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

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

@@ -0,0 +1,322 @@
+/**
+ * Type definitions for the Log Engine library
+ * Provides strongly-typed interfaces for configuration and log levels
+ */
+/**
+ * Type for log data - accepts any value since logs can contain literally anything
+ * This is intentionally `any` rather than `unknown` for maximum usability in a logging context
+ */
+export type LogData = any;
+/**
+ * Log levels representing message severity (lowest to highest)
+ * Used for filtering messages based on importance
+ */
+export declare enum LogLevel {
+    /** Detailed diagnostic information, typically only of interest during development */
+    DEBUG = 0,
+    /** General information about application flow and state */
+    INFO = 1,
+    /** Potentially harmful situations that don't prevent operation */
+    WARN = 2,
+    /** Error events that might still allow the application to continue */
+    ERROR = 3,
+    /** Critical messages that always output regardless of configured mode (except when OFF is set) */
+    LOG = 99
+}
+/**
+ * Log modes controlling output behavior and filtering
+ * Determines what messages are displayed based on verbosity requirements
+ */
+export declare enum LogMode {
+    /** Most verbose - shows DEBUG, INFO, WARN, ERROR, LOG messages */
+    DEBUG = 0,
+    /** Balanced - shows INFO, WARN, ERROR, LOG messages */
+    INFO = 1,
+    /** Focused - shows WARN, ERROR, LOG messages */
+    WARN = 2,
+    /** Minimal - shows ERROR, LOG messages */
+    ERROR = 3,
+    /** Critical only - shows LOG messages only */
+    SILENT = 4,
+    /** Complete silence - shows no messages at all */
+    OFF = 5
+}
+/**
+ * Represents a single log entry with timestamp, level, and message
+ * Used internally for structured logging operations
+ */
+export interface LogEntry {
+    /** When the log entry was created */
+    timestamp: Date;
+    /** The severity level of this log entry */
+    level: LogLevel;
+    /** The actual log message content */
+    message: string;
+}
+/**
+ * Output handler function type for custom log output
+ * Receives the log level, formatted message, and optional data
+ */
+export type LogOutputHandler = (level: string, message: string, data?: LogData) => void;
+/**
+ * Built-in output handler types
+ */
+export type BuiltInOutputHandler = 'console' | 'silent' | 'file' | 'http';
+/**
+ * Configuration for file output handler
+ */
+export interface FileOutputConfig {
+    /** File path to write logs to */
+    filePath: string;
+    /** Whether to append to existing file (default: true) */
+    append?: boolean;
+    /** Maximum file size before rotation in bytes (optional) */
+    maxFileSize?: number;
+    /** Number of backup files to keep during rotation (default: 3) */
+    maxBackupFiles?: number;
+    /** Custom format function for file output */
+    formatter?: (level: string, message: string, data?: LogData) => string;
+}
+/**
+ * Configuration for HTTP output handler
+ */
+export interface HttpOutputConfig {
+    /** HTTP endpoint URL to send logs to */
+    url: string;
+    /** HTTP method (default: 'POST') */
+    method?: 'POST' | 'PUT' | 'PATCH';
+    /** Custom headers to include with requests */
+    headers?: Record<string, string>;
+    /** Batch size for sending multiple logs (default: 1) */
+    batchSize?: number;
+    /** Timeout for HTTP requests in ms (default: 5000) */
+    timeout?: number;
+    /** Custom format function for HTTP payload */
+    formatter?: (logs: Array<{
+        level: string;
+        message: string;
+        data?: LogData;
+        timestamp: string;
+    }>) => LogData;
+}
+/**
+ * Configuration object for advanced built-in handlers
+ */
+export interface AdvancedOutputConfig {
+    file?: FileOutputConfig;
+    http?: HttpOutputConfig;
+}
+/**
+ * Enhanced output target - can be built-in handler, custom function, or configured handler object
+ */
+export type EnhancedOutputTarget = BuiltInOutputHandler | LogOutputHandler | {
+    type: 'file';
+    config: FileOutputConfig;
+} | {
+    type: 'http';
+    config: HttpOutputConfig;
+};
+/**
+ * Output target - can be a built-in handler string or custom function
+ */
+export type OutputTarget = BuiltInOutputHandler | LogOutputHandler;
+/**
+ * Configuration for log message formatting
+ * Controls which elements are included in the log output
+ */
+export interface LogFormatConfig {
+    /** Whether to include ISO timestamp (e.g., [2025-05-29T16:57:45.678Z]) */
+    includeIsoTimestamp?: boolean;
+    /** Whether to include local time (e.g., [4:57PM]) */
+    includeLocalTime?: boolean;
+}
+/**
+ * Configuration options for the logger
+ * Supports both legacy level-based and new mode-based configuration
+ */
+export interface LoggerConfig {
+    /** Log mode controlling output behavior (new API) */
+    mode?: LogMode;
+    /** Legacy: Minimum log level to display (backwards compatibility)
+     * Note: If both mode and level are provided, mode takes precedence */
+    level?: LogLevel;
+    /** Optional environment identifier for context (e.g., 'production', 'staging') */
+    environment?: string;
+    /** Custom output handler function to replace console output (backward compatibility) */
+    outputHandler?: LogOutputHandler;
+    /** Array of output targets for multiple simultaneous outputs */
+    outputs?: OutputTarget[];
+    /** Enhanced outputs with advanced configuration support */
+    enhancedOutputs?: EnhancedOutputTarget[];
+    /** Whether to suppress default console output (useful with custom outputHandler) */
+    suppressConsoleOutput?: boolean;
+    /** Advanced configuration for built-in handlers */
+    advancedOutputConfig?: AdvancedOutputConfig;
+    /** Format configuration for customizing log element inclusion */
+    format?: LogFormatConfig;
+}
+/**
+ * Configuration options for automatic data redaction
+ * Controls how sensitive information is processed in log messages
+ */
+export interface RedactionConfig {
+    /** Whether redaction is enabled globally */
+    enabled: boolean;
+    /** List of field names that should be redacted (case-insensitive partial matching) */
+    sensitiveFields: string[];
+    /** List of field names that should be truncated if they exceed maxContentLength */
+    contentFields: string[];
+    /** Maximum length for content fields before truncation occurs */
+    maxContentLength: number;
+    /** Text to replace sensitive field values with */
+    redactionText: string;
+    /** Text to append when content is truncated */
+    truncationText: string;
+    /** Whether to recursively scan nested objects and arrays */
+    deepRedaction: boolean;
+    /** Optional custom regex patterns for advanced field detection */
+    customPatterns?: RegExp[];
+}
+/**
+ * Interface for the LogEngine singleton object
+ * Provides all logging methods with comprehensive TypeScript support
+ */
+export interface ILogEngine {
+    /** Configure the logger with new settings */
+    configure(config: Partial<LoggerConfig>): void;
+    /** Log a debug message with automatic data redaction */
+    debug(message: string, data?: LogData): void;
+    /** Log an info message with automatic data redaction */
+    info(message: string, data?: LogData): void;
+    /** Log a warn message with automatic data redaction */
+    warn(message: string, data?: LogData): void;
+    /** Log an error message with automatic data redaction */
+    error(message: string, data?: LogData): void;
+    /** Log a message with automatic data redaction */
+    log(message: string, data?: LogData): void;
+    /** Log a debug message without redaction */
+    debugRaw(message: string, data?: LogData): void;
+    /** Log an info message without redaction */
+    infoRaw(message: string, data?: LogData): void;
+    /** Log a warn message without redaction */
+    warnRaw(message: string, data?: LogData): void;
+    /** Log an error message without redaction */
+    errorRaw(message: string, data?: LogData): void;
+    /** Log a message without redaction */
+    logRaw(message: string, data?: LogData): void;
+    /** Configure redaction settings */
+    configureRedaction(config: Partial<RedactionConfig>): void;
+    /** Reset redaction configuration to defaults */
+    resetRedactionConfig(): void;
+    /** Refresh redaction configuration from environment variables */
+    refreshRedactionConfig(): void;
+    /** Get current redaction configuration */
+    getRedactionConfig(): RedactionConfig;
+    /** Add custom regex patterns for advanced field detection */
+    addCustomRedactionPatterns(patterns: RegExp[]): void;
+    /** Clear all custom redaction patterns */
+    clearCustomRedactionPatterns(): void;
+    /** Add custom sensitive field names to the existing list */
+    addSensitiveFields(fields: string[]): void;
+    /** Test if a field name would be redacted with current configuration */
+    testFieldRedaction(fieldName: string): boolean;
+    /** Temporarily disable redaction for a specific logging call */
+    withoutRedaction(): ILogEngineWithoutRedaction;
+}
+/**
+ * Interface for LogEngine methods without redaction
+ * Returned by withoutRedaction() method
+ */
+export interface ILogEngineWithoutRedaction {
+    /** Log a debug message without redaction */
+    debug(message: string, data?: LogData): void;
+    /** Log an info message without redaction */
+    info(message: string, data?: LogData): void;
+    /** Log a warn message without redaction */
+    warn(message: string, data?: LogData): void;
+    /** Log an error message without redaction */
+    error(message: string, data?: LogData): void;
+    /** Log a message without redaction */
+    log(message: string, data?: LogData): void;
+}
+/**
+ * Interface for the DataRedactor static class methods
+ * Provides type safety for all redaction operations
+ */
+export interface IDataRedactor {
+    /** Update redaction configuration */
+    updateConfig(newConfig: Partial<RedactionConfig>): void;
+    /** Get current redaction configuration */
+    getConfig(): RedactionConfig;
+    /** Refresh configuration from environment variables */
+    refreshConfig(): void;
+    /** Add custom regex patterns for field detection */
+    addCustomPatterns(patterns: RegExp[]): void;
+    /** Clear all custom regex patterns */
+    clearCustomPatterns(): void;
+    /** Add sensitive field names to the existing list */
+    addSensitiveFields(fields: string[]): void;
+    /** Test if a field name would be redacted */
+    testFieldRedaction(fieldName: string): boolean;
+    /** Redact sensitive data from any value */
+    redactData(data: LogData): LogData;
+}
+/**
+ * Interface for the RedactionController methods
+ * Provides environment-based configuration management
+ */
+export interface IRedactionController {
+    /** Load configuration from environment variables */
+    loadFromEnvironment(): RedactionConfig;
+    /** Reset configuration to default values */
+    resetToDefaults(): RedactionConfig;
+    /** Get currently active configuration */
+    getCurrentConfig(): RedactionConfig;
+}
+/**
+ * Options for configuring redaction behavior
+ * Used for advanced redaction scenarios
+ */
+export interface RedactionOptions {
+    /** Whether to enable deep scanning of nested objects */
+    deep?: boolean;
+    /** Custom patterns to use for this operation */
+    customPatterns?: RegExp[];
+    /** Additional sensitive fields for this operation */
+    additionalSensitiveFields?: string[];
+    /** Override default redaction text */
+    redactionText?: string;
+}
+/**
+ * Result type for field redaction testing
+ * Provides detailed information about redaction decisions
+ */
+export interface FieldRedactionResult {
+    /** Whether the field would be redacted */
+    wouldRedact: boolean;
+    /** Reason for the redaction decision */
+    reason: 'sensitive_field' | 'custom_pattern' | 'not_sensitive';
+    /** Pattern that matched (if applicable) */
+    matchedPattern?: RegExp;
+}
+/**
+ * Environment variable configuration mapping
+ * Documents all supported environment variables
+ */
+export interface EnvironmentConfig {
+    /** LOG_REDACTION_DISABLED - Disable all redaction */
+    LOG_REDACTION_DISABLED?: string;
+    /** LOG_REDACTION_TEXT - Custom redaction text */
+    LOG_REDACTION_TEXT?: string;
+    /** LOG_REDACTION_SENSITIVE_FIELDS - Comma-separated sensitive field names */
+    LOG_REDACTION_SENSITIVE_FIELDS?: string;
+    /** LOG_REDACTION_CONTENT_FIELDS - Comma-separated content field names */
+    LOG_REDACTION_CONTENT_FIELDS?: string;
+    /** LOG_REDACTION_MAX_CONTENT_LENGTH - Maximum length for content fields */
+    LOG_REDACTION_MAX_CONTENT_LENGTH?: string;
+    /** LOG_REDACTION_TRUNCATION_TEXT - Text for truncated content */
+    LOG_REDACTION_TRUNCATION_TEXT?: string;
+    /** LOG_REDACTION_DEEP - Enable deep redaction */
+    LOG_REDACTION_DEEP?: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/esm/types/index.js

@@ -0,0 +1,41 @@
+/**
+ * Type definitions for the Log Engine library
+ * Provides strongly-typed interfaces for configuration and log levels
+ */
+/**
+ * Log levels representing message severity (lowest to highest)
+ * Used for filtering messages based on importance
+ */
+export var LogLevel;
+(function (LogLevel) {
+    /** Detailed diagnostic information, typically only of interest during development */
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    /** General information about application flow and state */
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    /** Potentially harmful situations that don't prevent operation */
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    /** Error events that might still allow the application to continue */
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    /** Critical messages that always output regardless of configured mode (except when OFF is set) */
+    LogLevel[LogLevel["LOG"] = 99] = "LOG";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Log modes controlling output behavior and filtering
+ * Determines what messages are displayed based on verbosity requirements
+ */
+export var LogMode;
+(function (LogMode) {
+    /** Most verbose - shows DEBUG, INFO, WARN, ERROR, LOG messages */
+    LogMode[LogMode["DEBUG"] = 0] = "DEBUG";
+    /** Balanced - shows INFO, WARN, ERROR, LOG messages */
+    LogMode[LogMode["INFO"] = 1] = "INFO";
+    /** Focused - shows WARN, ERROR, LOG messages */
+    LogMode[LogMode["WARN"] = 2] = "WARN";
+    /** Minimal - shows ERROR, LOG messages */
+    LogMode[LogMode["ERROR"] = 3] = "ERROR";
+    /** Critical only - shows LOG messages only */
+    LogMode[LogMode["SILENT"] = 4] = "SILENT";
+    /** Complete silence - shows no messages at all */
+    LogMode[LogMode["OFF"] = 5] = "OFF";
+})(LogMode || (LogMode = {}));
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;;GAGG;AACH,MAAM,CAAN,IAAY,QAWX;AAXD,WAAY,QAAQ;IAChB,qFAAqF;IACrF,yCAAS,CAAA;IACT,2DAA2D;IAC3D,uCAAQ,CAAA;IACR,kEAAkE;IAClE,uCAAQ,CAAA;IACR,sEAAsE;IACtE,yCAAS,CAAA;IACT,kGAAkG;IAClG,sCAAQ,CAAA;AACZ,CAAC,EAXW,QAAQ,KAAR,QAAQ,QAWnB;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,OAaX;AAbD,WAAY,OAAO;IACf,kEAAkE;IAClE,uCAAS,CAAA;IACT,uDAAuD;IACvD,qCAAQ,CAAA;IACR,gDAAgD;IAChD,qCAAQ,CAAA;IACR,0CAA0C;IAC1C,uCAAS,CAAA;IACT,8CAA8C;IAC9C,yCAAU,CAAA;IACV,kDAAkD;IAClD,mCAAO,CAAA;AACX,CAAC,EAbW,OAAO,KAAP,OAAO,QAalB"}