@wgtechlabs/log-engine 2.0.0 → 2.1.1

package/dist/{formatter/message-formatter.js → cjs/formatter/message-formatter.cjs}

@@ -5,28 +5,28 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageFormatter = void 0;
-const types_1 = require("../types");
-const colors_1 = require("./colors");
-const timestamp_1 = require("./timestamp");
-const data_formatter_1 = require("./data-formatter");
+const types_1 = require("../types/index.cjs");
+const colors_1 = require("./colors.cjs");
+const timestamp_1 = require("./timestamp.cjs");
+const data_formatter_1 = require("./data-formatter.cjs");
 /**
  * Core message formatter class
  * Provides the main formatting functionality for log messages
  */
 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
-     * @returns Formatted string with ANSI colors and timestamps
-     */
+       * 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
+       * @returns Formatted string with ANSI colors and timestamps
+       */
     static format(level, message, data) {
         const { isoTimestamp, timeString } = (0, timestamp_1.getTimestampComponents)();
         const timestamp = (0, timestamp_1.formatTimestamp)(isoTimestamp, timeString, colors_1.colorScheme);
-        const levelName = this.getLevelName(level);
-        const levelColor = this.getLevelColor(level);
+        const levelName = MessageFormatter.getLevelName(level);
+        const levelColor = MessageFormatter.getLevelColor(level);
         const coloredLevel = `${levelColor}[${levelName}]${colors_1.colors.reset}`;
         // Format the base message
         let formattedMessage = `${timestamp}${coloredLevel}: ${message}`;
@@ -40,11 +40,11 @@ class MessageFormatter {
         return formattedMessage + colors_1.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
-     * @returns Formatted string with ANSI colors, timestamps, and LOG ENGINE prefix
-     */
+       * 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 { isoTimestamp, timeString } = (0, timestamp_1.getTimestampComponents)();
         const timestamp = (0, timestamp_1.formatTimestamp)(isoTimestamp, timeString, colors_1.colorScheme);
@@ -53,10 +53,10 @@ class MessageFormatter {
         return `${timestamp}${coloredLogEngine}: ${coloredMessage}`;
     }
     /**
-     * Converts LogLevel enum to human-readable string
-     * @param level - The LogLevel to convert
-     * @returns String representation of the log level
-     */
+       * 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';
@@ -68,11 +68,11 @@ class MessageFormatter {
         }
     }
     /**
-     * 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
-     */
+       * 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 colors_1.colors.magenta; // Purple for debug info
@@ -85,3 +85,4 @@ class MessageFormatter {
     }
 }
 exports.MessageFormatter = MessageFormatter;
+//# sourceMappingURL=message-formatter.js.map

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

@@ -0,0 +1,41 @@
+/**
+ * Core message formatting functionality
+ * Handles the main log message formatting with colors, timestamps, and levels
+ */
+import { LogLevel, LogData } from '../types';
+/**
+ * Core message formatter class
+ * Provides the main formatting functionality for log messages
+ */
+export declare 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
+       * @returns Formatted string with ANSI colors and timestamps
+       */
+    static format(level: LogLevel, message: string, data?: LogData): 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
+       * @returns Formatted string with ANSI colors, timestamps, and LOG ENGINE prefix
+       */
+    static formatSystemMessage(message: string): 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/cjs/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,MAAM,UAAU,CAAC;AAK7C;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;;;;;;SAOK;IACL,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM;IAsBvE;;;;;SAKK;IACL,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAUnD;;;;SAIK;IACL,OAAO,CAAC,MAAM,CAAC,YAAY;IAW3B;;;;;SAKK;IACL,OAAO,CAAC,MAAM,CAAC,aAAa;CAU7B"}

package/dist/cjs/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/{formatter/timestamp.js → cjs/formatter/timestamp.cjs}

@@ -37,3 +37,4 @@ function formatTimestamp(isoTimestamp, timeString, colors) {
     const coloredTimeString = `${colors.timeString}[${timeString}]${colors.reset}`;
     return `${coloredTimestamp}${coloredTimeString}`;
 }
+//# sourceMappingURL=timestamp.js.map

package/dist/cjs/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/cjs/formatter/timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../../src/formatter/timestamp.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAOH,wDAgBC;AAUD,0CASC;AAxCD;;;;GAIG;AACH,SAAgB,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,SAAgB,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"}

package/dist/cjs/index.cjs

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * Main LogEngine module - provides a comprehensive logging solution
+ * with mode-based filtering, colorized output, and automatic data redaction
+ *
+ * Features a modular architecture with separate modules for:
+ * - Logger: Core logging functionality with environment-based configuration
+ * - Formatter: Message formatting with ANSI colors and timestamps
+ * - Redaction: Automatic sensitive data protection with customizable patterns
+ *
+ * @example
+ * ```typescript
+ * import { LogEngine, LogMode } from '@wgtechlabs/log-engine';
+ *
+ * // Configure logging mode
+ * LogEngine.configure({ mode: LogMode.DEBUG });
+ *
+ * // Log with automatic redaction
+ * LogEngine.info('User login', { username: 'john', password: 'secret123' });
+ * // Output: [2025-06-18T...][3:45PM][INFO]: User login { username: 'john', password: '[REDACTED]' }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedactionController = exports.defaultRedactionConfig = exports.DataRedactor = exports.LogLevel = exports.LogMode = exports.LogEngine = void 0;
+const logger_1 = require("./logger/index.cjs");
+const redaction_1 = require("./redaction/index.cjs");
+// Create a singleton logger instance
+const logger = new logger_1.Logger();
+/**
+ * LogEngine - The main interface for logging operations
+ * Provides a simple, intuitive API for all logging needs with security-first design
+ */
+exports.LogEngine = {
+    /**
+       * Configure the logger with new settings
+       * @param config - Configuration object containing logger settings
+       * @example
+       * ```typescript
+       * LogEngine.configure({ mode: LogMode.PRODUCTION });
+       * ```
+       */
+    configure: (config) => logger.configure(config),
+    // Standard logging methods with automatic redaction
+    /**
+       * Log a debug message with automatic data redaction
+       * Only shown in DEVELOPMENT mode
+       * @param message - The debug message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.debug('Processing user data', { userId: 123, email: 'user@example.com' });
+       * ```
+       */
+    debug: (message, data) => logger.debug(message, data),
+    /**
+       * Log an info message with automatic data redaction
+       * Shown in DEVELOPMENT and PRODUCTION modes
+       * @param message - The info message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.info('User login successful', { username: 'john' });
+       * ```
+       */
+    info: (message, data) => logger.info(message, data),
+    /**
+       * Log a warning message with automatic data redaction
+       * Shown in DEVELOPMENT and PRODUCTION modes
+       * @param message - The warning message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.warn('API rate limit approaching', { requestsRemaining: 10 });
+       * ```
+       */
+    warn: (message, data) => logger.warn(message, data),
+    /**
+       * Log an error message with automatic data redaction
+       * Shown in DEVELOPMENT and PRODUCTION modes
+       * @param message - The error message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.error('Database connection failed', { host: 'localhost', port: 5432 });
+       * ```
+       */
+    error: (message, data) => logger.error(message, data),
+    /**
+       * Log a critical message with automatic data redaction
+       * Always shown regardless of mode (except OFF)
+       * @param message - The critical log message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.log('Application starting', { version: '1.0.0' });
+       * ```
+       */
+    log: (message, data) => logger.log(message, data),
+    // Raw methods that bypass redaction (use with caution)
+    /**
+       * 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) => logger.debugRaw(message, data),
+    /**
+       * 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) => logger.infoRaw(message, data),
+    /**
+       * 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) => logger.warnRaw(message, data),
+    /**
+       * 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) => logger.errorRaw(message, data),
+    /**
+       * 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) => logger.logRaw(message, data),
+    // Redaction configuration methods
+    /**
+       * Configure data redaction settings
+       * @param config - Partial redaction configuration to apply
+       */
+    configureRedaction: (config) => redaction_1.DataRedactor.updateConfig(config),
+    /**
+       * Refresh redaction configuration from environment variables
+       * Useful for picking up runtime environment changes
+       */
+    refreshRedactionConfig: () => redaction_1.DataRedactor.refreshConfig(),
+    /**
+       * Reset redaction configuration to defaults
+       */
+    resetRedactionConfig: () => redaction_1.DataRedactor.updateConfig(redaction_1.defaultRedactionConfig),
+    /**
+       * Get current redaction configuration
+       * @returns Current redaction configuration
+       */
+    getRedactionConfig: () => redaction_1.DataRedactor.getConfig(),
+    // Advanced redaction methods
+    /**
+       * Add custom regex patterns for advanced field detection
+       * @param patterns - Array of regex patterns to add
+       */
+    addCustomRedactionPatterns: (patterns) => redaction_1.DataRedactor.addCustomPatterns(patterns),
+    /**
+       * Clear all custom redaction patterns
+       */
+    clearCustomRedactionPatterns: () => redaction_1.DataRedactor.clearCustomPatterns(),
+    /**
+       * Add custom sensitive field names to the existing list
+       * @param fields - Array of field names to add
+       */
+    addSensitiveFields: (fields) => redaction_1.DataRedactor.addSensitiveFields(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
+       */
+    testFieldRedaction: (fieldName) => redaction_1.DataRedactor.testFieldRedaction(fieldName),
+    /**
+       * Temporarily disable redaction for a specific logging call
+       * @returns LogEngine instance with redaction bypassed
+       * @example
+       * ```typescript
+       * LogEngine.withoutRedaction().info('Debug data', sensitiveObject);
+       * ```
+       */
+    withoutRedaction: () => ({
+        debug: (message, data) => logger.debugRaw(message, data),
+        info: (message, data) => logger.infoRaw(message, data),
+        warn: (message, data) => logger.warnRaw(message, data),
+        error: (message, data) => logger.errorRaw(message, data),
+        log: (message, data) => logger.logRaw(message, data)
+    })
+};
+// Re-export types and utilities for external use
+var types_1 = require("./types/index.cjs");
+Object.defineProperty(exports, "LogMode", { enumerable: true, get: function () { return types_1.LogMode; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return types_1.LogLevel; } });
+var redaction_2 = require("./redaction/index.cjs");
+Object.defineProperty(exports, "DataRedactor", { enumerable: true, get: function () { return redaction_2.DataRedactor; } });
+Object.defineProperty(exports, "defaultRedactionConfig", { enumerable: true, get: function () { return redaction_2.defaultRedactionConfig; } });
+Object.defineProperty(exports, "RedactionController", { enumerable: true, get: function () { return redaction_2.RedactionController; } });
+// Default export for convenience
+exports.default = exports.LogEngine;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Main LogEngine module - provides a comprehensive logging solution
+ * with mode-based filtering, colorized output, and automatic data redaction
+ *
+ * Features a modular architecture with separate modules for:
+ * - Logger: Core logging functionality with environment-based configuration
+ * - Formatter: Message formatting with ANSI colors and timestamps
+ * - Redaction: Automatic sensitive data protection with customizable patterns
+ *
+ * @example
+ * ```typescript
+ * import { LogEngine, LogMode } from '@wgtechlabs/log-engine';
+ *
+ * // Configure logging mode
+ * LogEngine.configure({ mode: LogMode.DEBUG });
+ *
+ * // Log with automatic redaction
+ * LogEngine.info('User login', { username: 'john', password: 'secret123' });
+ * // Output: [2025-06-18T...][3:45PM][INFO]: User login { username: 'john', password: '[REDACTED]' }
+ * ```
+ */
+import type { LoggerConfig, RedactionConfig, ILogEngineWithoutRedaction, LogData } from './types';
+/**
+ * LogEngine - The main interface for logging operations
+ * Provides a simple, intuitive API for all logging needs with security-first design
+ */
+export declare const LogEngine: {
+    /**
+       * Configure the logger with new settings
+       * @param config - Configuration object containing logger settings
+       * @example
+       * ```typescript
+       * LogEngine.configure({ mode: LogMode.PRODUCTION });
+       * ```
+       */
+    configure: (config: Partial<LoggerConfig>) => void;
+    /**
+       * Log a debug message with automatic data redaction
+       * Only shown in DEVELOPMENT mode
+       * @param message - The debug message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.debug('Processing user data', { userId: 123, email: 'user@example.com' });
+       * ```
+       */
+    debug: (message: string, data?: LogData) => void;
+    /**
+       * Log an info message with automatic data redaction
+       * Shown in DEVELOPMENT and PRODUCTION modes
+       * @param message - The info message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.info('User login successful', { username: 'john' });
+       * ```
+       */
+    info: (message: string, data?: LogData) => void;
+    /**
+       * Log a warning message with automatic data redaction
+       * Shown in DEVELOPMENT and PRODUCTION modes
+       * @param message - The warning message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.warn('API rate limit approaching', { requestsRemaining: 10 });
+       * ```
+       */
+    warn: (message: string, data?: LogData) => void;
+    /**
+       * Log an error message with automatic data redaction
+       * Shown in DEVELOPMENT and PRODUCTION modes
+       * @param message - The error message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.error('Database connection failed', { host: 'localhost', port: 5432 });
+       * ```
+       */
+    error: (message: string, data?: LogData) => void;
+    /**
+       * Log a critical message with automatic data redaction
+       * Always shown regardless of mode (except OFF)
+       * @param message - The critical log message to log
+       * @param data - Optional data object to log (sensitive data will be redacted)
+       * @example
+       * ```typescript
+       * LogEngine.log('Application starting', { version: '1.0.0' });
+       * ```
+       */
+    log: (message: string, data?: LogData) => void;
+    /**
+       * 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: string, data?: LogData) => void;
+    /**
+       * 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: string, data?: LogData) => void;
+    /**
+       * 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: string, data?: LogData) => void;
+    /**
+       * 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: string, data?: LogData) => void;
+    /**
+       * 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: string, data?: LogData) => void;
+    /**
+       * Configure data redaction settings
+       * @param config - Partial redaction configuration to apply
+       */
+    configureRedaction: (config: Partial<RedactionConfig>) => void;
+    /**
+       * Refresh redaction configuration from environment variables
+       * Useful for picking up runtime environment changes
+       */
+    refreshRedactionConfig: () => void;
+    /**
+       * Reset redaction configuration to defaults
+       */
+    resetRedactionConfig: () => void;
+    /**
+       * Get current redaction configuration
+       * @returns Current redaction configuration
+       */
+    getRedactionConfig: () => RedactionConfig;
+    /**
+       * Add custom regex patterns for advanced field detection
+       * @param patterns - Array of regex patterns to add
+       */
+    addCustomRedactionPatterns: (patterns: RegExp[]) => void;
+    /**
+       * Clear all custom redaction patterns
+       */
+    clearCustomRedactionPatterns: () => void;
+    /**
+       * Add custom sensitive field names to the existing list
+       * @param fields - Array of field names to add
+       */
+    addSensitiveFields: (fields: string[]) => void;
+    /**
+       * 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
+       */
+    testFieldRedaction: (fieldName: string) => boolean;
+    /**
+       * Temporarily disable redaction for a specific logging call
+       * @returns LogEngine instance with redaction bypassed
+       * @example
+       * ```typescript
+       * LogEngine.withoutRedaction().info('Debug data', sensitiveObject);
+       * ```
+       */
+    withoutRedaction: () => ILogEngineWithoutRedaction;
+};
+export { LogMode, LogLevel } from './types';
+export type { LoggerConfig, RedactionConfig, LogOutputHandler, BuiltInOutputHandler, OutputTarget, FileOutputConfig, HttpOutputConfig, AdvancedOutputConfig, EnhancedOutputTarget } from './types';
+export { DataRedactor, defaultRedactionConfig, RedactionController } from './redaction';
+export default LogEngine;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,0BAA0B,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMlG;;;GAGG;AACH,eAAO,MAAM,SAAS;IACpB;;;;;;;SAOK;wBACe,OAAO,CAAC,YAAY,CAAC,KAAG,IAAI;IAGhD;;;;;;;;;SASK;qBACY,MAAM,SAAS,OAAO,KAAG,IAAI;IAE9C;;;;;;;;;SASK;oBACW,MAAM,SAAS,OAAO,KAAG,IAAI;IAE7C;;;;;;;;;SASK;oBACW,MAAM,SAAS,OAAO,KAAG,IAAI;IAE7C;;;;;;;;;SASK;qBACY,MAAM,SAAS,OAAO,KAAG,IAAI;IAE9C;;;;;;;;;SASK;mBACU,MAAM,SAAS,OAAO,KAAG,IAAI;IAG5C;;;;;SAKK;wBACe,MAAM,SAAS,OAAO,KAAG,IAAI;IAEjD;;;;;SAKK;uBACc,MAAM,SAAS,OAAO,KAAG,IAAI;IAEhD;;;;;SAKK;uBACc,MAAM,SAAS,OAAO,KAAG,IAAI;IAEhD;;;;;SAKK;wBACe,MAAM,SAAS,OAAO,KAAG,IAAI;IAEjD;;;;;SAKK;sBACa,MAAM,SAAS,OAAO,KAAG,IAAI;IAG/C;;;SAGK;iCACwB,OAAO,CAAC,eAAe,CAAC,KAAG,IAAI;IAE5D;;;SAGK;kCACuB,IAAI;IAEhC;;SAEK;gCACqB,IAAI;IAE9B;;;SAGK;8BACmB,eAAe;IAGvC;;;SAGK;2CACkC,MAAM,EAAE,KAAG,IAAI;IAEtD;;SAEK;wCAC6B,IAAI;IAEtC;;;SAGK;iCACwB,MAAM,EAAE,KAAG,IAAI;IAE5C;;;;SAIK;oCAC2B,MAAM,KAAG,OAAO;IAEhD;;;;;;;SAOK;4BACiB,0BAA0B;CAOjD,CAAC;AAGF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EAEZ,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGxF,eAAe,SAAS,CAAC"}

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,qCAAkC;AAElC,2CAAmE;AAEnE,qCAAqC;AACrC,MAAM,MAAM,GAAG,IAAI,eAAM,EAAE,CAAC;AAE5B;;;GAGG;AACU,QAAA,SAAS,GAAG;IACvB;;;;;;;SAOK;IACL,SAAS,EAAE,CAAC,MAA6B,EAAQ,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;IAE5E,oDAAoD;IACpD;;;;;;;;;SASK;IACL,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;IAE7E;;;;;;;;;SASK;IACL,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;IAE3E;;;;;;;;;SASK;IACL,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;IAE3E;;;;;;;;;SASK;IACL,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC;IAE7E;;;;;;;;;SASK;IACL,GAAG,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC;IAEzE,uDAAuD;IACvD;;;;;SAKK;IACL,QAAQ,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAEnF;;;;;SAKK;IACL,OAAO,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;IAEjF;;;;;SAKK;IACL,OAAO,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;IAEjF;;;;;SAKK;IACL,QAAQ,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAEnF;;;;;SAKK;IACL,MAAM,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;IAE/E,kCAAkC;IAClC;;;SAGK;IACL,kBAAkB,EAAE,CAAC,MAAgC,EAAQ,EAAE,CAAC,wBAAY,CAAC,YAAY,CAAC,MAAM,CAAC;IAEjG;;;SAGK;IACL,sBAAsB,EAAE,GAAS,EAAE,CAAC,wBAAY,CAAC,aAAa,EAAE;IAEhE;;SAEK;IACL,oBAAoB,EAAE,GAAS,EAAE,CAAC,wBAAY,CAAC,YAAY,CAAC,kCAAsB,CAAC;IAEnF;;;SAGK;IACL,kBAAkB,EAAE,GAAoB,EAAE,CAAC,wBAAY,CAAC,SAAS,EAAE;IAEnE,6BAA6B;IAC7B;;;SAGK;IACL,0BAA0B,EAAE,CAAC,QAAkB,EAAQ,EAAE,CAAC,wBAAY,CAAC,iBAAiB,CAAC,QAAQ,CAAC;IAElG;;SAEK;IACL,4BAA4B,EAAE,GAAS,EAAE,CAAC,wBAAY,CAAC,mBAAmB,EAAE;IAE5E;;;SAGK;IACL,kBAAkB,EAAE,CAAC,MAAgB,EAAQ,EAAE,CAAC,wBAAY,CAAC,kBAAkB,CAAC,MAAM,CAAC;IAEvF;;;;SAIK;IACL,kBAAkB,EAAE,CAAC,SAAiB,EAAW,EAAE,CAAC,wBAAY,CAAC,kBAAkB,CAAC,SAAS,CAAC;IAE9F;;;;;;;SAOK;IACL,gBAAgB,EAAE,GAA+B,EAAE,CAAC,CAAC;QACnD,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;QAChF,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;QAC9E,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;QAC9E,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;QAChF,GAAG,EAAE,CAAC,OAAe,EAAE,IAAc,EAAQ,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;KAC7E,CAAC;CACH,CAAC;AAEF,iDAAiD;AACjD,iCAA4C;AAAnC,gGAAA,OAAO,OAAA;AAAE,iGAAA,QAAQ,OAAA;AAa1B,yCAAwF;AAA/E,yGAAA,YAAY,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAElE,iCAAiC;AACjC,kBAAe,iBAAS,CAAC"}