/** * Configuration Diagnostic Logging * * Provides comprehensive logging for configuration operations: * - Configuration sources tracking * - Operation audit trail * - Troubleshooting insights * - Performance metrics * * @module lib/config-logger */ /** * Log level enumeration */ export declare enum LogLevel { DEBUG = "DEBUG", INFO = "INFO", WARN = "WARN", ERROR = "ERROR" } /** * Log entry structure */ export interface LogEntry { timestamp: string; level: LogLevel; operation: string; message: string; data?: Record; source?: string; profileName?: string; duration?: number; } /** * Configuration operation types */ export declare enum ConfigOperation { READ = "read", WRITE = "write", VALIDATE = "validate", MERGE = "merge", SYNC_SECRETS = "sync-secrets", INFER_CONFIG = "infer-config", CREATE_PROFILE = "create-profile", DELETE_PROFILE = "delete-profile" } /** * Configuration logger for diagnostic and audit purposes */ export declare class ConfigLogger { private logFile; private enableConsole; private minLogLevel; /** * Creates a new configuration logger * * @param options - Logger configuration options */ constructor(options?: { logFile?: string; enableConsole?: boolean; minLogLevel?: LogLevel; }); /** * Gets log level priority for comparison * * @param level - Log level * @returns Priority number (higher = more severe) */ private getLogLevelPriority; /** * Checks if log level should be output * * @param level - Log level to check * @returns True if should log */ private shouldLog; /** * Formats log entry for output * * @param entry - Log entry * @returns Formatted log string */ private formatLogEntry; /** * Writes log entry to file and console * * @param entry - Log entry to write */ private writeLog; /** * Logs a debug message * * @param operation - Configuration operation * @param message - Log message * @param data - Additional data */ debug(operation: ConfigOperation | string, message: string, data?: Record): void; /** * Logs an info message * * @param operation - Configuration operation * @param message - Log message * @param data - Additional data */ info(operation: ConfigOperation | string, message: string, data?: Record): void; /** * Logs a warning message * * @param operation - Configuration operation * @param message - Log message * @param data - Additional data */ warn(operation: ConfigOperation | string, message: string, data?: Record): void; /** * Logs an error message * * @param operation - Configuration operation * @param message - Log message * @param data - Additional data */ error(operation: ConfigOperation | string, message: string, data?: Record): void; /** * Logs configuration operation with timing * * @param operation - Configuration operation * @param profileName - Profile name * @param source - Configuration source * @param fn - Function to execute and time * @returns Result of the function */ logOperation(operation: ConfigOperation, profileName: string, source: string, fn: () => Promise | T): Promise; /** * Logs configuration read operation * * @param profileName - Profile name * @param configType - Configuration type * @param success - Whether read was successful * @param source - Configuration source */ logRead(profileName: string, configType: string, success: boolean, source?: string): void; /** * Logs configuration write operation * * @param profileName - Profile name * @param configType - Configuration type * @param success - Whether write was successful * @param source - Configuration source */ logWrite(profileName: string, configType: string, success: boolean, source?: string): void; /** * Logs configuration validation * * @param profileName - Profile name * @param isValid - Whether configuration is valid * @param errors - Validation errors */ logValidation(profileName: string, isValid: boolean, errors?: string[]): void; /** * Logs secrets sync operation * * @param profileName - Profile name * @param secretArn - Secret ARN * @param action - Action performed (created/updated/skipped) */ logSecretsSync(profileName: string, secretArn: string, action: string): void; /** * Gets the log file path * * @returns Log file path */ getLogFile(): string; } /** * Gets or creates the global configuration logger * * @param options - Logger options (only used on first call) * @returns Configuration logger instance */ export declare function getConfigLogger(options?: { logFile?: string; enableConsole?: boolean; minLogLevel?: LogLevel; }): ConfigLogger; /** * Sets the global configuration logger * * @param logger - Logger instance */ export declare function setConfigLogger(logger: ConfigLogger): void; //# sourceMappingURL=config-logger.d.ts.map