@wgtechlabs/log-engine 2.0.0 → 2.1.1

package/dist/{types → cjs/types}/index.d.ts

@@ -2,6 +2,11 @@
  * 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
@@ -48,6 +53,73 @@ export interface LogEntry {
     /** 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 options for the logger
  * Supports both legacy level-based and new mode-based configuration
@@ -60,6 +132,16 @@ export interface LoggerConfig {
     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;
 }
 /**
  * Configuration options for automatic data redaction
@@ -91,25 +173,25 @@ 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?: any): void;
+    debug(message: string, data?: LogData): void;
     /** Log an info message with automatic data redaction */
-    info(message: string, data?: any): void;
+    info(message: string, data?: LogData): void;
     /** Log a warn message with automatic data redaction */
-    warn(message: string, data?: any): void;
+    warn(message: string, data?: LogData): void;
     /** Log an error message with automatic data redaction */
-    error(message: string, data?: any): void;
+    error(message: string, data?: LogData): void;
     /** Log a message with automatic data redaction */
-    log(message: string, data?: any): void;
+    log(message: string, data?: LogData): void;
     /** Log a debug message without redaction */
-    debugRaw(message: string, data?: any): void;
+    debugRaw(message: string, data?: LogData): void;
     /** Log an info message without redaction */
-    infoRaw(message: string, data?: any): void;
+    infoRaw(message: string, data?: LogData): void;
     /** Log a warn message without redaction */
-    warnRaw(message: string, data?: any): void;
+    warnRaw(message: string, data?: LogData): void;
     /** Log an error message without redaction */
-    errorRaw(message: string, data?: any): void;
+    errorRaw(message: string, data?: LogData): void;
     /** Log a message without redaction */
-    logRaw(message: string, data?: any): void;
+    logRaw(message: string, data?: LogData): void;
     /** Configure redaction settings */
     configureRedaction(config: Partial<RedactionConfig>): void;
     /** Reset redaction configuration to defaults */
@@ -135,15 +217,15 @@ export interface ILogEngine {
  */
 export interface ILogEngineWithoutRedaction {
     /** Log a debug message without redaction */
-    debug(message: string, data?: any): void;
+    debug(message: string, data?: LogData): void;
     /** Log an info message without redaction */
-    info(message: string, data?: any): void;
+    info(message: string, data?: LogData): void;
     /** Log a warn message without redaction */
-    warn(message: string, data?: any): void;
+    warn(message: string, data?: LogData): void;
     /** Log an error message without redaction */
-    error(message: string, data?: any): void;
+    error(message: string, data?: LogData): void;
     /** Log a message without redaction */
-    log(message: string, data?: any): void;
+    log(message: string, data?: LogData): void;
 }
 /**
  * Interface for the DataRedactor static class methods
@@ -165,7 +247,7 @@ export interface IDataRedactor {
     /** Test if a field name would be redacted */
     testFieldRedaction(fieldName: string): boolean;
     /** Redact sensitive data from any value */
-    redactData(data: any): any;
+    redactData(data: LogData): LogData;
 }
 /**
  * Interface for the RedactionController methods

package/dist/cjs/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/cjs/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,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,wBAAR,QAAQ,QAWnB;AAED;;;GAGG;AACH,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,uBAAP,OAAO,QAalB"}

package/dist/esm/__tests__/async-test-utils.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Wait for a file to exist with optimized polling
+ */
+export declare function waitForFile(filePath: string, timeoutMs?: number): Promise<void>;
+/**
+ * Wait for multiple files to exist with parallel checking
+ */
+export declare function waitForFiles(filePaths: string[], timeoutMs?: number): Promise<void>;
+/**
+ * Wait for a file to have specific content with optimized polling
+ */
+export declare function waitForFileContent(filePath: string, expectedContent: string | RegExp, timeoutMs?: number): Promise<void>;
+/**
+ * Wait for a directory to be empty with faster polling
+ */
+export declare function waitForDirectoryEmpty(dirPath: string, timeoutMs?: number): Promise<void>;
+/**
+ * Safely remove a file with optimized retry logic
+ */
+export declare function safeRemoveFile(filePath: string, maxRetries?: number): Promise<void>;
+/**
+ * Safely clean up a directory with retry logic
+ */
+export declare function safeCleanupDirectory(dirPath: string): Promise<void>;
+/**
+ * Enhanced mock HTTP handler with faster timeouts and better error handling
+ */
+export declare class MockHttpHandler {
+    private requests;
+    private pendingPromises;
+    private timeoutIds;
+    addRequest(url: string, options: any): void;
+    getRequests(): {
+        url: string;
+        options: any;
+    }[];
+    waitForRequests(count?: number, timeoutMs?: number): Promise<void>;
+    clear(): void;
+}
+/**
+ * Create a test timeout that fails fast instead of hanging
+ */
+export declare function createTestTimeout(timeoutMs?: number): {
+    promise: Promise<never>;
+    cancel: () => void;
+};
+/**
+ * Race a promise against a timeout for fail-fast behavior
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs?: number): Promise<T>;
+//# sourceMappingURL=async-test-utils.d.ts.map

package/dist/esm/__tests__/async-test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-test-utils.d.ts","sourceRoot":"","sources":["../../../src/__tests__/async-test-utils.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CActG;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1G;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB/I;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB/G;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB5F;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBzE;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAIN;IAEV,OAAO,CAAC,eAAe,CAA4B;IACnD,OAAO,CAAC,UAAU,CAAkC;IAEpD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI;IAe3C,WAAW;;;;IAIL,eAAe,CAAC,KAAK,GAAE,MAAU,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC5F,KAAK,IAAI,IAAI;CAUd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,MAAwB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAetH;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,GAAE,MAAwB,GAAG,OAAO,CAAC,CAAC,CAAC,CAiBzG"}

package/dist/esm/__tests__/async-test-utils.js

@@ -0,0 +1,231 @@
+/**
+ * Test utilities for handling async file operations properly
+ * Replaces arbitrary timeouts with proper Promise-based waiting
+ * Optimized for CI environments with faster polling and shorter timeouts
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+// Optimized defaults for CI environments
+const DEFAULT_TIMEOUT = 3000; // Reduced from 5000ms
+const POLL_INTERVAL = 5; // Reduced from 10ms for faster detection
+/**
+ * Wait for a file to exist with optimized polling
+ */
+export async function waitForFile(filePath, timeoutMs = DEFAULT_TIMEOUT) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        try {
+            await fs.promises.access(filePath, fs.constants.F_OK);
+            return; // File exists
+        }
+        catch (error) {
+            // File doesn't exist yet, wait a bit
+            await new Promise(resolve => setTimeout(resolve, POLL_INTERVAL));
+        }
+    }
+    throw new Error(`File ${filePath} did not appear within ${timeoutMs}ms`);
+}
+/**
+ * Wait for multiple files to exist with parallel checking
+ */
+export async function waitForFiles(filePaths, timeoutMs = DEFAULT_TIMEOUT) {
+    await Promise.all(filePaths.map(filePath => waitForFile(filePath, timeoutMs)));
+}
+/**
+ * Wait for a file to have specific content with optimized polling
+ */
+export async function waitForFileContent(filePath, expectedContent, timeoutMs = DEFAULT_TIMEOUT) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        try {
+            const content = await fs.promises.readFile(filePath, 'utf8');
+            if (typeof expectedContent === 'string') {
+                if (content.includes(expectedContent)) {
+                    return;
+                }
+            }
+            else {
+                if (expectedContent.test(content)) {
+                    return;
+                }
+            }
+        }
+        catch (error) {
+            // File might not exist yet or be readable
+        }
+        await new Promise(resolve => setTimeout(resolve, POLL_INTERVAL));
+    }
+    throw new Error(`File ${filePath} did not contain expected content within ${timeoutMs}ms`);
+}
+/**
+ * Wait for a directory to be empty with faster polling
+ */
+export async function waitForDirectoryEmpty(dirPath, timeoutMs = DEFAULT_TIMEOUT) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        try {
+            const files = await fs.promises.readdir(dirPath);
+            if (files.length === 0) {
+                return;
+            }
+        }
+        catch (error) {
+            // Directory might not exist, which is also "empty"
+            return;
+        }
+        await new Promise(resolve => setTimeout(resolve, POLL_INTERVAL));
+    }
+    throw new Error(`Directory ${dirPath} was not empty within ${timeoutMs}ms`);
+}
+/**
+ * Safely remove a file with optimized retry logic
+ */
+export async function safeRemoveFile(filePath, maxRetries = 3) {
+    for (let i = 0; i < maxRetries; i++) {
+        try {
+            await fs.promises.unlink(filePath);
+            return;
+        }
+        catch (error) {
+            if (i === maxRetries - 1) {
+                // Only throw on last retry if it's not a "file not found" error
+                if (error.code !== 'ENOENT') {
+                    throw error;
+                }
+            }
+            else {
+                // Wait a bit before retrying (reduced wait time)
+                await new Promise(resolve => setTimeout(resolve, 10));
+            }
+        }
+    }
+}
+/**
+ * Safely clean up a directory with retry logic
+ */
+export async function safeCleanupDirectory(dirPath) {
+    try {
+        const files = await fs.promises.readdir(dirPath);
+        // Remove all files with retry logic
+        await Promise.all(files.map(file => safeRemoveFile(path.join(dirPath, file))));
+        // Remove the directory itself
+        await fs.promises.rmdir(dirPath);
+    }
+    catch (error) {
+        // Directory might not exist, which is fine
+        if (error.code !== 'ENOENT') {
+            // Try force removal as fallback
+            try {
+                await fs.promises.rm(dirPath, { recursive: true, force: true });
+            }
+            catch (fallbackError) {
+                // Ignore cleanup errors in tests
+            }
+        }
+    }
+}
+/**
+ * Enhanced mock HTTP handler with faster timeouts and better error handling
+ */
+export class MockHttpHandler {
+    constructor() {
+        this.requests = [];
+        this.pendingPromises = [];
+        this.timeoutIds = new Set();
+    }
+    addRequest(url, options) {
+        let resolveRequest;
+        const promise = new Promise(resolve => {
+            resolveRequest = resolve;
+        });
+        this.requests.push({
+            url,
+            options,
+            resolve: resolveRequest
+        });
+        this.pendingPromises.push(promise);
+    }
+    getRequests() {
+        return this.requests.map(({ url, options }) => ({ url, options }));
+    }
+    async waitForRequests(count = 1, timeoutMs = DEFAULT_TIMEOUT) {
+        const startTime = Date.now();
+        // Set up a timeout that will be cleaned up
+        let timeoutId;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                reject(new Error(`Expected ${count} requests but got ${this.requests.length} within ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.timeoutIds.add(timeoutId);
+        });
+        try {
+            while (this.requests.length < count && Date.now() - startTime < timeoutMs) {
+                await new Promise(resolve => {
+                    const id = setTimeout(resolve, POLL_INTERVAL);
+                    this.timeoutIds.add(id);
+                });
+            }
+            if (this.requests.length < count) {
+                throw new Error(`Expected ${count} requests but got ${this.requests.length} within ${timeoutMs}ms`);
+            }
+            // Mark all requests as processed
+            this.requests.forEach(req => req.resolve());
+            // Wait for all pending promises to resolve
+            await Promise.all(this.pendingPromises);
+        }
+        finally {
+            // Clean up the timeout
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                this.timeoutIds.delete(timeoutId);
+            }
+        }
+    }
+    clear() {
+        // Clean up any remaining timeouts
+        for (const timeoutId of this.timeoutIds) {
+            clearTimeout(timeoutId);
+        }
+        this.timeoutIds.clear();
+        this.requests = [];
+        this.pendingPromises = [];
+    }
+}
+/**
+ * Create a test timeout that fails fast instead of hanging
+ */
+export function createTestTimeout(timeoutMs = DEFAULT_TIMEOUT) {
+    let timeoutId;
+    const promise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new Error(`Test timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+    });
+    const cancel = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+    };
+    return { promise, cancel };
+}
+/**
+ * Race a promise against a timeout for fail-fast behavior
+ */
+export async function withTimeout(promise, timeoutMs = DEFAULT_TIMEOUT) {
+    const timeout = createTestTimeout(timeoutMs);
+    try {
+        const result = await Promise.race([
+            promise,
+            timeout.promise
+        ]);
+        // Cancel the timeout since we got a result
+        timeout.cancel();
+        return result;
+    }
+    catch (error) {
+        // Cancel the timeout in case of error
+        timeout.cancel();
+        throw error;
+    }
+}
+//# sourceMappingURL=async-test-utils.js.map

package/dist/esm/__tests__/async-test-utils.js.map

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

package/dist/esm/__tests__/redaction/test-utils.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared test utilities for redaction tests
+ * Common setup, mocks, and helper functions
+ */
+export declare const mockConsole: {
+    log: jest.Mock<any, any, any>;
+    warn: jest.Mock<any, any, any>;
+    error: jest.Mock<any, any, any>;
+};
+export declare const originalConsole: {
+    log: (message?: any, ...optionalParams: any[]) => void;
+    warn: (message?: any, ...optionalParams: any[]) => void;
+    error: (message?: any, ...optionalParams: any[]) => void;
+};
+/**
+ * Setup console mocks for testing
+ */
+export declare function setupConsoleMocks(): void;
+/**
+ * Restore original console methods
+ */
+export declare function restoreConsole(): void;
+/**
+ * Setup environment for testing
+ */
+export declare function setupTestEnvironment(): {
+    originalEnv: NodeJS.ProcessEnv;
+};
+/**
+ * Restore environment after testing
+ */
+export declare function restoreEnvironment(originalEnv: NodeJS.ProcessEnv): void;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/esm/__tests__/redaction/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/redaction/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,WAAW;;;;CAIvB,CAAC;AAGF,eAAO,MAAM,eAAe;;;;CAI3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,WAAW,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,CAGzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAqBvE"}

package/dist/esm/__tests__/redaction/test-utils.js

@@ -0,0 +1,65 @@
+/**
+ * Shared test utilities for redaction tests
+ * Common setup, mocks, and helper functions
+ */
+// Mock console methods to capture output for integration tests
+export const mockConsole = {
+    log: jest.fn(),
+    warn: jest.fn(),
+    error: jest.fn()
+};
+// Store original console methods
+export const originalConsole = {
+    log: console.log,
+    warn: console.warn,
+    error: console.error
+};
+/**
+ * Setup console mocks for testing
+ */
+export function setupConsoleMocks() {
+    jest.clearAllMocks();
+    console.log = mockConsole.log;
+    console.warn = mockConsole.warn;
+    console.error = mockConsole.error;
+}
+/**
+ * Restore original console methods
+ */
+export function restoreConsole() {
+    console.log = originalConsole.log;
+    console.warn = originalConsole.warn;
+    console.error = originalConsole.error;
+}
+/**
+ * Setup environment for testing
+ */
+export function setupTestEnvironment() {
+    const originalEnv = { ...process.env };
+    return { originalEnv };
+}
+/**
+ * Restore environment after testing
+ */
+export function restoreEnvironment(originalEnv) {
+    // Only remove environment variables that were added during the test
+    // (i.e., those not present in the originalEnv)
+    // Create a copy of the keys to avoid mutation during iteration
+    const currentEnvKeys = Object.keys(process.env);
+    for (const key of currentEnvKeys) {
+        if (!Object.prototype.hasOwnProperty.call(originalEnv, key)) {
+            // Safe deletion using explicit type assertion
+            delete process.env[key];
+        }
+    }
+    // Restore or update variables that existed originally
+    // Iterate over originalEnv keys safely
+    const originalEnvKeys = Object.keys(originalEnv);
+    for (const key of originalEnvKeys) {
+        if (Object.prototype.hasOwnProperty.call(originalEnv, key)) {
+            // Safe assignment using explicit access
+            process.env[key] = originalEnv[key];
+        }
+    }
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/esm/__tests__/redaction/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../../../src/__tests__/redaction/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;IACd,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;IACf,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;CACjB,CAAC;AAEF,iCAAiC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,KAAK,EAAE,OAAO,CAAC,KAAK;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,aAAa,EAAE,CAAC;IACrB,OAAO,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC;IAC9B,OAAO,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;IAChC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC;IAClC,OAAO,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC;IACpC,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAA8B;IAC/D,oEAAoE;IACpE,+CAA+C;IAC/C,+DAA+D;IAC/D,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC;YAC5D,8CAA8C;YAC9C,OAAQ,OAAO,CAAC,GAA0C,CAAC,GAAG,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,uCAAuC;IACvC,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjD,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC;YAC3D,wCAAwC;YACvC,OAAO,CAAC,GAA0C,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/esm/__tests__/test-utils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared test utilities for log-engine tests
+ * Provides consistent console mocking and cleanup functionality across all test suites
+ */
+/**
+ * Interface for managing console method mocks during testing
+ * Groups all console spy instances for easy setup and cleanup
+ */
+export interface ConsoleMocks {
+    /** Mock for console.log (used by debug and info methods) */
+    mockConsoleLog: jest.SpyInstance;
+    /** Mock for console.warn (used by warn method) */
+    mockConsoleWarn: jest.SpyInstance;
+    /** Mock for console.error (used by error method) */
+    mockConsoleError: jest.SpyInstance;
+}
+/**
+ * Sets up console mocks for testing log output
+ * Replaces console methods with Jest spies to capture and verify log calls
+ * @returns ConsoleMocks object containing all spy instances
+ */
+export declare const setupConsoleMocks: () => ConsoleMocks;
+/**
+ * Restores console mocks after testing
+ * Cleans up Jest spies and restores original console functionality
+ * @param mocks - The ConsoleMocks object from setupConsoleMocks
+ */
+export declare const restoreConsoleMocks: (mocks: ConsoleMocks) => void;
+/**
+ * Convenience function for setting up console mocks in beforeEach hooks
+ * Identical to setupConsoleMocks but with a more descriptive name for test setup
+ * @returns ConsoleMocks object containing all spy instances
+ */
+export declare const setupConsoleBeforeEach: () => ConsoleMocks;
+/**
+ * Convenience function for restoring console mocks in afterEach hooks
+ * Identical to restoreConsoleMocks but with a more descriptive name for test cleanup
+ * @param mocks - The ConsoleMocks object to restore
+ */
+export declare const restoreConsoleAfterEach: (mocks: ConsoleMocks) => void;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/esm/__tests__/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,cAAc,EAAE,IAAI,CAAC,WAAW,CAAC;IACjC,kDAAkD;IAClD,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC;IAClC,oDAAoD;IACpD,gBAAgB,EAAE,IAAI,CAAC,WAAW,CAAC;CACpC;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAO,YAMpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,YAAY,KAAG,IAIzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAAO,YAEzC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,OAAO,YAAY,KAAG,IAE7D,CAAC"}