logan-logger 1.1.19 → 1.1.21

package/dist/core/types.d.mts

@@ -0,0 +1,170 @@
+/**
+ * Log levels in ascending order of severity.
+ * Used to filter which messages should be logged.
+ */
+export declare enum LogLevel {
+    /** Debug messages - most verbose */
+    DEBUG = 0,
+    /** Informational messages */
+    INFO = 1,
+    /** Warning messages */
+    WARN = 2,
+    /** Error messages */
+    ERROR = 3,
+    /** No messages - silent mode */
+    SILENT = 4
+}
+/**
+ * String representation of log levels.
+ */
+export type LogLevelString = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Supported JavaScript runtime environments.
+ */
+export type RuntimeName = 'node' | 'deno' | 'bun' | 'browser' | 'webworker' | 'unknown';
+/**
+ * Information about the detected JavaScript runtime environment.
+ */
+export interface RuntimeInfo {
+    /** The name of the runtime */
+    name: RuntimeName;
+    /** Version string of the runtime (if available) */
+    version?: string;
+    /** Capabilities supported by this runtime */
+    capabilities: RuntimeCapabilities;
+}
+/**
+ * Capabilities that a runtime may or may not support.
+ */
+export interface RuntimeCapabilities {
+    /** Whether the runtime supports file system operations */
+    fileSystem: boolean;
+    /** Whether the runtime supports colored console output */
+    colorSupport: boolean;
+    /** Whether the runtime provides process information */
+    processInfo: boolean;
+    /** Whether the runtime supports streams */
+    streams: boolean;
+}
+/**
+ * Configuration options for creating a logger instance.
+ */
+export interface LoggerConfig {
+    /** Minimum log level to output */
+    level: LogLevel;
+    /** Output format for log messages */
+    format: 'json' | 'text' | 'custom';
+    /** Whether to include timestamps in log output */
+    timestamp: boolean;
+    /** Whether to colorize log output (if supported) */
+    colorize: boolean;
+    /** Default metadata to include with all log messages */
+    metadata: Record<string, any>;
+    /** Transport configurations for log output */
+    transports?: TransportConfig[];
+}
+/**
+ * Configuration for a specific log transport (output destination).
+ */
+export interface TransportConfig {
+    /** Type of transport */
+    type: 'console' | 'file' | 'http' | 'custom';
+    /** Minimum log level for this transport */
+    level?: LogLevel;
+    /** Transport-specific options */
+    options: Record<string, any>;
+}
+/**
+ * A log message can be a string or a function that returns a string.
+ * Functions enable lazy evaluation for expensive log message generation.
+ */
+export type LogMessage = string | (() => string);
+/**
+ * Internal representation of a log entry.
+ */
+export interface LogEntry {
+    /** When the log entry was created */
+    timestamp: Date;
+    /** Log level of this entry */
+    level: LogLevel;
+    /** The log message */
+    message: string;
+    /** Additional structured data */
+    metadata?: Record<string, any>;
+    /** Runtime that generated this log entry */
+    runtime: RuntimeName;
+}
+/**
+ * Main logger interface providing methods for logging at different levels.
+ * This interface is implemented by all logger implementations across different runtimes.
+ */
+export interface ILogger {
+    /**
+     * Log a debug message. Only shown when log level is DEBUG.
+     * @param message - The message to log (string or lazy function)
+     * @param metadata - Optional structured data to include
+     */
+    debug(message: LogMessage, metadata?: any): void;
+    /**
+     * Log an informational message.
+     * @param message - The message to log (string or lazy function)
+     * @param metadata - Optional structured data to include
+     */
+    info(message: LogMessage, metadata?: any): void;
+    /**
+     * Log a warning message.
+     * @param message - The message to log (string or lazy function)
+     * @param metadata - Optional structured data to include
+     */
+    warn(message: LogMessage, metadata?: any): void;
+    /**
+     * Log an error message.
+     * @param message - The message to log (string or lazy function)
+     * @param metadata - Optional structured data to include
+     */
+    error(message: LogMessage, metadata?: any): void;
+    /**
+     * Log a message at a specific level.
+     * @param level - The log level
+     * @param message - The message to log (string or lazy function)
+     * @param metadata - Optional structured data to include
+     */
+    log(level: LogLevel, message: LogMessage, metadata?: any): void;
+    /**
+     * Set the minimum log level for this logger.
+     * @param level - The minimum log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get the current minimum log level.
+     * @returns The current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Create a child logger with additional metadata.
+     * @param metadata - Additional metadata to include in all child log messages
+     * @returns A new logger instance with the additional metadata
+     */
+    child(metadata: Record<string, any>): ILogger;
+}
+/**
+ * Interface for logger adapters that handle the actual log output.
+ * This abstraction allows different implementations for different runtimes.
+ */
+export interface ILoggerAdapter {
+    /**
+     * Write a log entry to the output destination.
+     * @param entry - The log entry to write
+     */
+    log(entry: LogEntry): void;
+    /**
+     * Set the minimum log level for this adapter.
+     * @param level - The minimum log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get the current minimum log level.
+     * @returns The current log level
+     */
+    getLevel(): LogLevel;
+}

package/dist/deno.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/factory-CluPoiZb.cjs"),t=require("./chunks/browser-Bq67gUmd.cjs"),n=require("./chunks/formatting-Cb_xXgov.cjs");exports.BrowserLogger=t.t,exports.ConsoleGroupLogger=t.n,exports.PerformanceLogger=t.r,exports.createLogger=e.n,exports.createLoggerForEnvironment=e.r,exports.detectRuntime=t.l,exports.filterSensitiveData=t.i,exports.formatLevel=n.t,exports.formatLogEntry=n.n,exports.getDefaultConfig=e.o,exports.isBrowser=t.u,exports.isBun=t.d,exports.isDeno=t.f,exports.isNode=t.p,exports.loadConfigFromEnvironment=e.s,exports.loadConfigFromFile=e.c,exports.mergeConfigs=e.l,exports.safeStringify=t.a,exports.serializeError=t.o;

package/dist/deno.d.cts

@@ -0,0 +1,7 @@
+export { createLogger, createLoggerForEnvironment } from './core/factory.cjs';
+export type { ILogger, LoggerConfig, LogLevel } from './core/types.cjs';
+export { BrowserLogger, ConsoleGroupLogger, PerformanceLogger } from './runtime/browser.cjs';
+export * from './utils/config.cjs';
+export * from './utils/formatting.cjs';
+export * from './utils/runtime.cjs';
+export * from './utils/serialization.cjs';

package/dist/deno.d.mts

@@ -0,0 +1,7 @@
+export { createLogger, createLoggerForEnvironment } from './core/factory.mjs';
+export type { ILogger, LoggerConfig, LogLevel } from './core/types.mjs';
+export { BrowserLogger, ConsoleGroupLogger, PerformanceLogger } from './runtime/browser.mjs';
+export * from './utils/config.mjs';
+export * from './utils/formatting.mjs';
+export * from './utils/runtime.mjs';
+export * from './utils/serialization.mjs';

package/dist/{deno.esm.js → deno.mjs}

@@ -1,4 +1,4 @@
-import { c as e, l as t, n, o as r, r as i, s as a } from "./factory-CG8zWIqv.mjs";
-import { a as o, d as s, f as c, i as l, l as u, n as d, o as f, p, r as m, t as h, u as g } from "./browser-DV_BQqDK.mjs";
-import { n as _, t as v } from "./formatting-DP_57uSR.mjs";
+import { c as e, l as t, n, o as r, r as i, s as a } from "./chunks/factory-2po65gyH.mjs";
+import { a as o, d as s, f as c, i as l, l as u, n as d, o as f, p, r as m, t as h, u as g } from "./chunks/browser-D5QY2oJb.mjs";
+import { n as _, t as v } from "./chunks/formatting-CLctAPm9.mjs";
 export { h as BrowserLogger, d as ConsoleGroupLogger, m as PerformanceLogger, n as createLogger, i as createLoggerForEnvironment, u as detectRuntime, l as filterSensitiveData, v as formatLevel, _ as formatLogEntry, r as getDefaultConfig, g as isBrowser, s as isBun, c as isDeno, p as isNode, a as loadConfigFromEnvironment, e as loadConfigFromFile, t as mergeConfigs, o as safeStringify, f as serializeError };

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/factory-CluPoiZb.cjs"),t=require("./chunks/browser-Bq67gUmd.cjs"),n=require("./chunks/formatting-Cb_xXgov.cjs");var r=e.r(),i={debug:(e,t)=>r.debug(e,t),info:(e,t)=>r.info(e,t),warn:(e,t)=>r.warn(e,t),error:(e,t)=>r.error(e,t)};exports.BaseLogger=t.s,exports.BrowserLogger=t.t,exports.ConsoleGroupLogger=t.n,exports.LogLevel=t.c,exports.LoggerFactory=e.t,exports.PerformanceLogger=t.r,exports.createLogger=e.n,exports.createLoggerForEnvironment=e.r,exports.detectRuntime=t.l,exports.filterSensitiveData=t.i,exports.formatLevel=n.t,exports.formatLogEntry=n.n,exports.getDefaultConfig=e.o,exports.isBrowser=t.u,exports.isBun=t.d,exports.isDeno=t.f,exports.isNode=t.p,exports.loadConfigFromEnvironment=e.s,exports.loadConfigFromFile=e.c,exports.log=i,exports.logLevelToString=e.i,exports.logger=r,exports.mergeConfigs=e.l,exports.safeStringify=t.a,exports.serializeError=t.o,exports.stringToLogLevel=e.a;

package/dist/index.d.cts

@@ -0,0 +1,19 @@
+import { createLogger, createLoggerForEnvironment } from './core/factory.cjs';
+import { ILogger, LogLevel } from './core/types.cjs';
+export * from './core/factory.cjs';
+export * from './core/logger.cjs';
+export * from './core/types.cjs';
+export { BrowserLogger, ConsoleGroupLogger, PerformanceLogger } from './runtime/browser.cjs';
+export * from './utils/config.cjs';
+export * from './utils/formatting.cjs';
+export * from './utils/runtime.cjs';
+export * from './utils/serialization.cjs';
+export declare const logger: ILogger;
+export declare const log: {
+    debug: (message: string, meta?: any) => void;
+    info: (message: string, meta?: any) => void;
+    warn: (message: string, meta?: any) => void;
+    error: (message: string, meta?: any) => void;
+};
+export { createLogger, createLoggerForEnvironment, LogLevel };
+export type { ILogger, ILoggerAdapter, LogEntry, LoggerConfig, LogLevelString, LogMessage, RuntimeCapabilities, RuntimeInfo, RuntimeName, TransportConfig, } from './core/types.cjs';

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import { createLogger, createLoggerForEnvironment } from './core/factory.mjs';
+import { ILogger, LogLevel } from './core/types.mjs';
+export * from './core/factory.mjs';
+export * from './core/logger.mjs';
+export * from './core/types.mjs';
+export { BrowserLogger, ConsoleGroupLogger, PerformanceLogger } from './runtime/browser.mjs';
+export * from './utils/config.mjs';
+export * from './utils/formatting.mjs';
+export * from './utils/runtime.mjs';
+export * from './utils/serialization.mjs';
+export declare const logger: ILogger;
+export declare const log: {
+    debug: (message: string, meta?: any) => void;
+    info: (message: string, meta?: any) => void;
+    warn: (message: string, meta?: any) => void;
+    error: (message: string, meta?: any) => void;
+};
+export { createLogger, createLoggerForEnvironment, LogLevel };
+export type { ILogger, ILoggerAdapter, LogEntry, LoggerConfig, LogLevelString, LogMessage, RuntimeCapabilities, RuntimeInfo, RuntimeName, TransportConfig, } from './core/types.mjs';

package/dist/{index.esm.js → index.mjs}

@@ -1,6 +1,6 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./factory-CG8zWIqv.mjs";
-import { a as l, c as u, d, f, i as p, l as m, n as h, o as g, p as _, r as v, s as y, t as b, u as x } from "./browser-DV_BQqDK.mjs";
-import { n as S, t as C } from "./formatting-DP_57uSR.mjs";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./chunks/factory-2po65gyH.mjs";
+import { a as l, c as u, d, f, i as p, l as m, n as h, o as g, p as _, r as v, s as y, t as b, u as x } from "./chunks/browser-D5QY2oJb.mjs";
+import { n as S, t as C } from "./chunks/formatting-CLctAPm9.mjs";
 //#region src/index.ts
 var w = o(), T = {
 	debug: (e, t) => w.debug(e, t),

package/dist/node.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/factory-CluPoiZb.cjs");exports.NodeLogger=e.u,exports.createLogger=e.n,exports.createLoggerForEnvironment=e.r,exports.createMorganStream=e.d;

package/dist/node.d.cts

@@ -0,0 +1,3 @@
+export { createLogger, createLoggerForEnvironment } from './core/factory.cjs';
+export type { ILogger, LoggerConfig, LogLevel } from './core/types.cjs';
+export { createMorganStream, NodeLogger } from './runtime/node.cjs';

package/dist/node.d.mts

@@ -0,0 +1,3 @@
+export { createLogger, createLoggerForEnvironment } from './core/factory.mjs';
+export type { ILogger, LoggerConfig, LogLevel } from './core/types.mjs';
+export { createMorganStream, NodeLogger } from './runtime/node.mjs';

package/dist/{node.esm.js → node.mjs}

@@ -1,2 +1,2 @@
-import { d as e, n as t, r as n, u as r } from "./factory-CG8zWIqv.mjs";
+import { d as e, n as t, r as n, u as r } from "./chunks/factory-2po65gyH.mjs";
 export { r as NodeLogger, t as createLogger, n as createLoggerForEnvironment, e as createMorganStream };

package/dist/runtime/browser.d.cts

@@ -0,0 +1,31 @@
+import { BaseLogger } from '../core/logger.cjs';
+import { LogEntry, LoggerConfig, LogLevel } from '../core/types.cjs';
+export declare class BrowserLogger extends BaseLogger {
+    constructor(config?: Partial<LoggerConfig>);
+    protected writeLog(entry: LogEntry): void;
+    protected createChild(): BaseLogger;
+    private formatMessage;
+    private getConsoleStyle;
+    private shouldLogInProduction;
+    protected shouldLog(level: LogLevel): boolean;
+}
+export declare class ConsoleGroupLogger extends BrowserLogger {
+    private groupStack;
+    group(label: string): void;
+    groupCollapsed(label: string): void;
+    groupEnd(): void;
+    getCurrentGroupStack(): string[];
+    getCurrentGroupPath(): string;
+    time(label: string): void;
+    timeEnd(label: string): void;
+    trace(message: string, metadata?: any): void;
+    count(label?: string): void;
+    countReset(label?: string): void;
+    table(data: any): void;
+}
+export declare class PerformanceLogger extends BrowserLogger {
+    mark(name: string): void;
+    measure(name: string, startMark?: string, endMark?: string): void;
+    clearMarks(name?: string): void;
+    clearMeasures(name?: string): void;
+}

package/dist/runtime/browser.d.mts

@@ -0,0 +1,31 @@
+import { BaseLogger } from '../core/logger.mjs';
+import { LogEntry, LoggerConfig, LogLevel } from '../core/types.mjs';
+export declare class BrowserLogger extends BaseLogger {
+    constructor(config?: Partial<LoggerConfig>);
+    protected writeLog(entry: LogEntry): void;
+    protected createChild(): BaseLogger;
+    private formatMessage;
+    private getConsoleStyle;
+    private shouldLogInProduction;
+    protected shouldLog(level: LogLevel): boolean;
+}
+export declare class ConsoleGroupLogger extends BrowserLogger {
+    private groupStack;
+    group(label: string): void;
+    groupCollapsed(label: string): void;
+    groupEnd(): void;
+    getCurrentGroupStack(): string[];
+    getCurrentGroupPath(): string;
+    time(label: string): void;
+    timeEnd(label: string): void;
+    trace(message: string, metadata?: any): void;
+    count(label?: string): void;
+    countReset(label?: string): void;
+    table(data: any): void;
+}
+export declare class PerformanceLogger extends BrowserLogger {
+    mark(name: string): void;
+    measure(name: string, startMark?: string, endMark?: string): void;
+    clearMarks(name?: string): void;
+    clearMeasures(name?: string): void;
+}

package/dist/runtime/node.d.cts

@@ -0,0 +1,16 @@
+import { BaseLogger } from '../core/logger.cjs';
+import { LogEntry, LoggerConfig, LogLevel } from '../core/types.cjs';
+export declare class NodeLogger extends BaseLogger {
+    private winston?;
+    constructor(config?: Partial<LoggerConfig>);
+    private initializeWinston;
+    private createWinstonLogger;
+    protected writeLog(entry: LogEntry): void;
+    protected createChild(): BaseLogger;
+    private writeToConsole;
+    private getWinstonLevel;
+    setLevel(level: LogLevel): void;
+}
+export declare function createMorganStream(logger: NodeLogger): {
+    write: (message: string) => void;
+};

package/dist/runtime/node.d.mts

@@ -0,0 +1,16 @@
+import { BaseLogger } from '../core/logger.mjs';
+import { LogEntry, LoggerConfig, LogLevel } from '../core/types.mjs';
+export declare class NodeLogger extends BaseLogger {
+    private winston?;
+    constructor(config?: Partial<LoggerConfig>);
+    private initializeWinston;
+    private createWinstonLogger;
+    protected writeLog(entry: LogEntry): void;
+    protected createChild(): BaseLogger;
+    private writeToConsole;
+    private getWinstonLevel;
+    setLevel(level: LogLevel): void;
+}
+export declare function createMorganStream(logger: NodeLogger): {
+    write: (message: string) => void;
+};

package/dist/utils/config.d.cts

@@ -0,0 +1,5 @@
+import { LoggerConfig } from '../core/types.cjs';
+export declare function getDefaultConfig(): LoggerConfig;
+export declare function loadConfigFromEnvironment(): Partial<LoggerConfig>;
+export declare function loadConfigFromFile(configPath?: string): Promise<Partial<LoggerConfig>>;
+export declare function mergeConfigs(...configs: Partial<LoggerConfig>[]): LoggerConfig;

package/dist/utils/config.d.mts

@@ -0,0 +1,5 @@
+import { LoggerConfig } from '../core/types.mjs';
+export declare function getDefaultConfig(): LoggerConfig;
+export declare function loadConfigFromEnvironment(): Partial<LoggerConfig>;
+export declare function loadConfigFromFile(configPath?: string): Promise<Partial<LoggerConfig>>;
+export declare function mergeConfigs(...configs: Partial<LoggerConfig>[]): LoggerConfig;

package/dist/utils/formatting.d.cts

@@ -0,0 +1,31 @@
+import { LogEntry, LogLevel } from '../core/types.cjs';
+/**
+ * Format a log entry for output in different formats.
+ * @param entry - The log entry to format
+ * @param format - Output format ('json' or 'text')
+ * @returns Formatted log string
+ * @example
+ * ```typescript
+ * const entry: LogEntry = {
+ *   timestamp: new Date(),
+ *   level: LogLevel.INFO,
+ *   message: 'User logged in',
+ *   metadata: { userId: 123 },
+ *   runtime: 'node'
+ * };
+ *
+ * const textFormat = formatLogEntry(entry, 'text');
+ * // Result: "[2024-01-01T12:00:00.000Z] INFO: User logged in {\"userId\":123}"
+ *
+ * const jsonFormat = formatLogEntry(entry, 'json');
+ * // Result: {"timestamp":"2024-01-01T12:00:00.000Z","level":"info","message":"User logged in","metadata":{"userId":123},"runtime":"node"}
+ * ```
+ */
+export declare function formatLogEntry(entry: LogEntry, format?: 'json' | 'text'): string;
+/**
+ * Format log level as a colored string for terminal output.
+ * @param level - The log level to format
+ * @param colorize - Whether to apply ANSI color codes
+ * @returns Formatted level string with optional colors
+ */
+export declare function formatLevel(level: LogLevel, colorize?: boolean): string;

package/dist/utils/formatting.d.mts

@@ -0,0 +1,31 @@
+import { LogEntry, LogLevel } from '../core/types.mjs';
+/**
+ * Format a log entry for output in different formats.
+ * @param entry - The log entry to format
+ * @param format - Output format ('json' or 'text')
+ * @returns Formatted log string
+ * @example
+ * ```typescript
+ * const entry: LogEntry = {
+ *   timestamp: new Date(),
+ *   level: LogLevel.INFO,
+ *   message: 'User logged in',
+ *   metadata: { userId: 123 },
+ *   runtime: 'node'
+ * };
+ *
+ * const textFormat = formatLogEntry(entry, 'text');
+ * // Result: "[2024-01-01T12:00:00.000Z] INFO: User logged in {\"userId\":123}"
+ *
+ * const jsonFormat = formatLogEntry(entry, 'json');
+ * // Result: {"timestamp":"2024-01-01T12:00:00.000Z","level":"info","message":"User logged in","metadata":{"userId":123},"runtime":"node"}
+ * ```
+ */
+export declare function formatLogEntry(entry: LogEntry, format?: 'json' | 'text'): string;
+/**
+ * Format log level as a colored string for terminal output.
+ * @param level - The log level to format
+ * @param colorize - Whether to apply ANSI color codes
+ * @returns Formatted level string with optional colors
+ */
+export declare function formatLevel(level: LogLevel, colorize?: boolean): string;

package/dist/utils/runtime.d.cts

@@ -0,0 +1,31 @@
+import { RuntimeInfo } from '../core/types.cjs';
+/**
+ * Detects the current JavaScript runtime environment and its capabilities.
+ * @returns Information about the detected runtime
+ * @example
+ * ```typescript
+ * const runtime = detectRuntime();
+ * console.log(`Running on: ${runtime.name} ${runtime.version}`);
+ * ```
+ */
+export declare function detectRuntime(): RuntimeInfo;
+/**
+ * Check if the current runtime is Node.js.
+ * @returns True if running in Node.js
+ */
+export declare function isNode(): boolean;
+/**
+ * Check if the current runtime is a browser.
+ * @returns True if running in a browser
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Check if the current runtime is Deno.
+ * @returns True if running in Deno
+ */
+export declare function isDeno(): boolean;
+/**
+ * Check if the current runtime is Bun.
+ * @returns True if running in Bun
+ */
+export declare function isBun(): boolean;

package/dist/utils/runtime.d.mts

@@ -0,0 +1,31 @@
+import { RuntimeInfo } from '../core/types.mjs';
+/**
+ * Detects the current JavaScript runtime environment and its capabilities.
+ * @returns Information about the detected runtime
+ * @example
+ * ```typescript
+ * const runtime = detectRuntime();
+ * console.log(`Running on: ${runtime.name} ${runtime.version}`);
+ * ```
+ */
+export declare function detectRuntime(): RuntimeInfo;
+/**
+ * Check if the current runtime is Node.js.
+ * @returns True if running in Node.js
+ */
+export declare function isNode(): boolean;
+/**
+ * Check if the current runtime is a browser.
+ * @returns True if running in a browser
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Check if the current runtime is Deno.
+ * @returns True if running in Deno
+ */
+export declare function isDeno(): boolean;
+/**
+ * Check if the current runtime is Bun.
+ * @returns True if running in Bun
+ */
+export declare function isBun(): boolean;

package/dist/utils/serialization.d.cts

@@ -0,0 +1,22 @@
+/**
+ * Safely stringify an object to JSON, handling circular references,
+ * Error objects, functions, and other non-serializable values.
+ * @param obj - The object to stringify
+ * @param space - Number of spaces for pretty-printing (optional)
+ * @returns JSON string representation
+ */
+export declare function safeStringify(obj: any, space?: number): string;
+/**
+ * Filter out sensitive data from an object before logging.
+ * @param obj - The object to filter
+ * @param sensitiveKeys - Array of key names to redact (case-insensitive)
+ * @returns A new object with sensitive values replaced with '[REDACTED]'
+ * @example
+ * ```typescript
+ * const data = { username: 'john', password: 'secret123' };
+ * const filtered = filterSensitiveData(data);
+ * // Result: { username: 'john', password: '[REDACTED]' }
+ * ```
+ */
+export declare function filterSensitiveData(obj: any, sensitiveKeys?: string[]): any;
+export declare function serializeError(error: any): any;

package/dist/utils/serialization.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Safely stringify an object to JSON, handling circular references,
+ * Error objects, functions, and other non-serializable values.
+ * @param obj - The object to stringify
+ * @param space - Number of spaces for pretty-printing (optional)
+ * @returns JSON string representation
+ */
+export declare function safeStringify(obj: any, space?: number): string;
+/**
+ * Filter out sensitive data from an object before logging.
+ * @param obj - The object to filter
+ * @param sensitiveKeys - Array of key names to redact (case-insensitive)
+ * @returns A new object with sensitive values replaced with '[REDACTED]'
+ * @example
+ * ```typescript
+ * const data = { username: 'john', password: 'secret123' };
+ * const filtered = filterSensitiveData(data);
+ * // Result: { username: 'john', password: '[REDACTED]' }
+ * ```
+ */
+export declare function filterSensitiveData(obj: any, sensitiveKeys?: string[]): any;
+export declare function serializeError(error: any): any;

package/dist/utils/serialization.d.ts

@@ -19,15 +19,4 @@ export declare function safeStringify(obj: any, space?: number): string;
  * ```
  */
 export declare function filterSensitiveData(obj: any, sensitiveKeys?: string[]): any;
-/**
- * Serialize Error objects to plain objects for logging.
- * @param error - The error to serialize
- * @returns Serialized error object or original value if not an Error
- * @example
- * ```typescript
- * const error = new Error('Something went wrong');
- * const serialized = serializeError(error);
- * // Result: { name: 'Error', message: 'Something went wrong', stack: '...' }
- * ```
- */
 export declare function serializeError(error: any): any;