agentic-qe 3.3.3 → 3.3.4

package/v3/dist/logging/console-logger.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Agentic QE v3 - Console Logger Implementation
+ * Milestone 2.7: Structured Logging Facade
+ *
+ * Default logger implementation that outputs to console with:
+ * - Level filtering
+ * - Domain prefixing
+ * - Timestamp formatting
+ * - Structured context formatting
+ * - Error stack trace handling
+ */
+import { Logger, LogLevel, LogContext } from './logger.js';
+/**
+ * Configuration options for ConsoleLogger
+ */
+export interface ConsoleLoggerConfig {
+    /** Include timestamps in log output */
+    includeTimestamp: boolean;
+    /** Include log level name in output */
+    includeLevel: boolean;
+    /** Format for timestamps (iso or short) */
+    timestampFormat: 'iso' | 'short';
+    /** Pretty print context objects with indentation */
+    prettyPrint: boolean;
+    /** Maximum depth for context object stringification */
+    maxContextDepth: number;
+}
+/**
+ * Default configuration for ConsoleLogger
+ */
+export declare const DEFAULT_CONSOLE_LOGGER_CONFIG: ConsoleLoggerConfig;
+/**
+ * Console-based Logger implementation
+ *
+ * Outputs formatted log messages to the console with level filtering.
+ * Messages below the configured level threshold are silently ignored.
+ */
+export declare class ConsoleLogger implements Logger {
+    private readonly domain;
+    private readonly level;
+    private readonly config;
+    private readonly inheritedContext;
+    constructor(domain: string, level?: LogLevel, config?: Partial<ConsoleLoggerConfig>, inheritedContext?: LogContext);
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: Error, context?: LogContext): void;
+    isEnabled(level: LogLevel): boolean;
+    getDomain(): string;
+    child(context: LogContext): Logger;
+    /**
+     * Format and output a log message to the appropriate console method
+     */
+    private output;
+    /**
+     * Format a log message with all configured components
+     */
+    private format;
+    /**
+     * Format current timestamp according to configuration
+     */
+    private formatTimestamp;
+    /**
+     * Format log level with consistent width
+     */
+    private formatLevel;
+    /**
+     * Merge inherited context with provided context
+     */
+    private mergeContext;
+    /**
+     * Format context object for display
+     */
+    private formatContext;
+    /**
+     * Create a JSON replacer that handles circular references and depth limiting
+     */
+    private createReplacer;
+}
+/**
+ * No-op Logger implementation for use when logging is disabled
+ *
+ * All methods do nothing, providing zero overhead when logging is turned off.
+ */
+export declare class NullLogger implements Logger {
+    private readonly domain;
+    constructor(domain?: string);
+    debug(_message: string, _context?: LogContext): void;
+    info(_message: string, _context?: LogContext): void;
+    warn(_message: string, _context?: LogContext): void;
+    error(_message: string, _error?: Error, _context?: LogContext): void;
+    isEnabled(_level: LogLevel): boolean;
+    getDomain(): string;
+    child(_context: LogContext): Logger;
+}
+//# sourceMappingURL=console-logger.d.ts.map

package/v3/dist/logging/console-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.d.ts","sourceRoot":"","sources":["../../src/logging/console-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,UAAU,EAEX,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,eAAe,EAAE,KAAK,GAAG,OAAO,CAAC;IACjC,oDAAoD;IACpD,WAAW,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAM3C,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAa;gBAG5C,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,QAAwB,EAC/B,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EACzC,gBAAgB,GAAE,UAAe;IAQnC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAMlD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAMjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAMjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI;IAsBjE,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAInC,SAAS,IAAI,MAAM;IAInB,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM;IASlC;;OAEG;IACH,OAAO,CAAC,MAAM;IAmBd;;OAEG;IACH,OAAO,CAAC,MAAM;IA4Bd;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,cAAc;CA2CvB;AAED;;;;GAIG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,GAAE,MAAe;IAInC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAIpD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAInD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAInD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI;IAIpE,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAIpC,SAAS,IAAI,MAAM;IAInB,KAAK,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM;CAGpC"}

package/v3/dist/logging/console-logger.js

@@ -0,0 +1,247 @@
+/**
+ * Agentic QE v3 - Console Logger Implementation
+ * Milestone 2.7: Structured Logging Facade
+ *
+ * Default logger implementation that outputs to console with:
+ * - Level filtering
+ * - Domain prefixing
+ * - Timestamp formatting
+ * - Structured context formatting
+ * - Error stack trace handling
+ */
+import { LogLevel, LOG_LEVEL_NAMES, } from './logger.js';
+/**
+ * Default configuration for ConsoleLogger
+ */
+export const DEFAULT_CONSOLE_LOGGER_CONFIG = {
+    includeTimestamp: true,
+    includeLevel: true,
+    timestampFormat: 'short',
+    prettyPrint: false,
+    maxContextDepth: 3,
+};
+/**
+ * Console-based Logger implementation
+ *
+ * Outputs formatted log messages to the console with level filtering.
+ * Messages below the configured level threshold are silently ignored.
+ */
+export class ConsoleLogger {
+    domain;
+    level;
+    config;
+    inheritedContext;
+    constructor(domain, level = LogLevel.INFO, config = {}, inheritedContext = {}) {
+        this.domain = domain;
+        this.level = level;
+        this.config = { ...DEFAULT_CONSOLE_LOGGER_CONFIG, ...config };
+        this.inheritedContext = inheritedContext;
+    }
+    debug(message, context) {
+        if (this.level <= LogLevel.DEBUG) {
+            this.output(LogLevel.DEBUG, message, context);
+        }
+    }
+    info(message, context) {
+        if (this.level <= LogLevel.INFO) {
+            this.output(LogLevel.INFO, message, context);
+        }
+    }
+    warn(message, context) {
+        if (this.level <= LogLevel.WARN) {
+            this.output(LogLevel.WARN, message, context);
+        }
+    }
+    error(message, error, context) {
+        if (this.level <= LogLevel.ERROR) {
+            const errorContext = { ...context };
+            if (error) {
+                errorContext.errorName = error.name;
+                errorContext.errorMessage = error.message;
+                if (error.stack) {
+                    errorContext.stack = error.stack;
+                }
+                // Capture any additional properties on the error
+                // Use type assertion for ES2022 Error.cause compatibility
+                const errorWithCause = error;
+                if (errorWithCause.cause !== undefined) {
+                    errorContext.cause = String(errorWithCause.cause);
+                }
+            }
+            this.output(LogLevel.ERROR, message, errorContext);
+        }
+    }
+    isEnabled(level) {
+        return this.level <= level;
+    }
+    getDomain() {
+        return this.domain;
+    }
+    child(context) {
+        return new ConsoleLogger(this.domain, this.level, this.config, { ...this.inheritedContext, ...context });
+    }
+    /**
+     * Format and output a log message to the appropriate console method
+     */
+    output(level, message, context) {
+        const formattedMessage = this.format(level, message, context);
+        switch (level) {
+            case LogLevel.DEBUG:
+                console.debug(formattedMessage);
+                break;
+            case LogLevel.INFO:
+                console.info(formattedMessage);
+                break;
+            case LogLevel.WARN:
+                console.warn(formattedMessage);
+                break;
+            case LogLevel.ERROR:
+                console.error(formattedMessage);
+                break;
+        }
+    }
+    /**
+     * Format a log message with all configured components
+     */
+    format(level, message, context) {
+        const parts = [];
+        // Add timestamp if configured
+        if (this.config.includeTimestamp) {
+            parts.push(this.formatTimestamp());
+        }
+        // Add level if configured
+        if (this.config.includeLevel) {
+            parts.push(this.formatLevel(level));
+        }
+        // Add domain
+        parts.push(`[${this.domain}]`);
+        // Add message
+        parts.push(message);
+        // Add context if provided
+        const mergedContext = this.mergeContext(context);
+        if (mergedContext && Object.keys(mergedContext).length > 0) {
+            parts.push(this.formatContext(mergedContext));
+        }
+        return parts.join(' ');
+    }
+    /**
+     * Format current timestamp according to configuration
+     */
+    formatTimestamp() {
+        const now = new Date();
+        if (this.config.timestampFormat === 'iso') {
+            return `[${now.toISOString()}]`;
+        }
+        // Short format: HH:MM:SS.mmm
+        const hours = String(now.getHours()).padStart(2, '0');
+        const minutes = String(now.getMinutes()).padStart(2, '0');
+        const seconds = String(now.getSeconds()).padStart(2, '0');
+        const millis = String(now.getMilliseconds()).padStart(3, '0');
+        return `[${hours}:${minutes}:${seconds}.${millis}]`;
+    }
+    /**
+     * Format log level with consistent width
+     */
+    formatLevel(level) {
+        const name = LOG_LEVEL_NAMES[level];
+        return `[${name.padEnd(5)}]`;
+    }
+    /**
+     * Merge inherited context with provided context
+     */
+    mergeContext(context) {
+        if (!context && Object.keys(this.inheritedContext).length === 0) {
+            return undefined;
+        }
+        return {
+            ...this.inheritedContext,
+            ...context,
+        };
+    }
+    /**
+     * Format context object for display
+     */
+    formatContext(context) {
+        try {
+            if (this.config.prettyPrint) {
+                return '\n' + JSON.stringify(context, this.createReplacer(), 2);
+            }
+            return JSON.stringify(context, this.createReplacer());
+        }
+        catch {
+            return '[unserializable context]';
+        }
+    }
+    /**
+     * Create a JSON replacer that handles circular references and depth limiting
+     */
+    createReplacer() {
+        const seen = new WeakSet();
+        let depth = 0;
+        return (_key, value) => {
+            // Handle depth limiting
+            if (typeof value === 'object' && value !== null) {
+                if (depth >= this.config.maxContextDepth) {
+                    return '[object]';
+                }
+                // Handle circular references
+                if (seen.has(value)) {
+                    return '[circular]';
+                }
+                seen.add(value);
+                depth++;
+            }
+            // Handle special types
+            if (value instanceof Error) {
+                return {
+                    name: value.name,
+                    message: value.message,
+                    stack: value.stack,
+                };
+            }
+            if (typeof value === 'bigint') {
+                return value.toString();
+            }
+            if (typeof value === 'function') {
+                return '[function]';
+            }
+            if (typeof value === 'symbol') {
+                return value.toString();
+            }
+            return value;
+        };
+    }
+}
+/**
+ * No-op Logger implementation for use when logging is disabled
+ *
+ * All methods do nothing, providing zero overhead when logging is turned off.
+ */
+export class NullLogger {
+    domain;
+    constructor(domain = 'null') {
+        this.domain = domain;
+    }
+    debug(_message, _context) {
+        // No-op
+    }
+    info(_message, _context) {
+        // No-op
+    }
+    warn(_message, _context) {
+        // No-op
+    }
+    error(_message, _error, _context) {
+        // No-op
+    }
+    isEnabled(_level) {
+        return false;
+    }
+    getDomain() {
+        return this.domain;
+    }
+    child(_context) {
+        return this;
+    }
+}
+//# sourceMappingURL=console-logger.js.map

package/v3/dist/logging/console-logger.js.map

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

package/v3/dist/logging/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Agentic QE v3 - Logging Module
+ * Milestone 2.7: Structured Logging Facade
+ *
+ * Centralized logging infrastructure for consistent log formatting,
+ * level filtering, and domain-specific configuration.
+ *
+ * Usage:
+ * ```typescript
+ * import { LoggerFactory, LogLevel } from '../logging';
+ *
+ * // Configure (typically at application startup)
+ * LoggerFactory.setLevel(LogLevel.DEBUG);
+ * // Or from environment
+ * LoggerFactory.initFromEnv();
+ *
+ * // Create domain-specific loggers
+ * const logger = LoggerFactory.create('queen-coordinator');
+ *
+ * // Log messages
+ * logger.info('Task submitted', { taskId: 'task-123', priority: 'high' });
+ * logger.debug('Processing details', { step: 1, duration: 42 });
+ * logger.warn('Resource limit approaching', { usage: 0.85 });
+ * logger.error('Task failed', error, { taskId: 'task-123' });
+ *
+ * // Check if level is enabled (avoid expensive message construction)
+ * if (logger.isEnabled(LogLevel.DEBUG)) {
+ *   logger.debug('Expensive debug info', { data: computeExpensiveData() });
+ * }
+ *
+ * // Create child logger with additional context
+ * const childLogger = logger.child({ requestId: 'req-456' });
+ * childLogger.info('Processing request'); // includes requestId in all messages
+ * ```
+ */
+export type { Logger, LogContext } from './logger.js';
+export { LogLevel, LOG_LEVEL_NAMES, parseLogLevel, isLogger } from './logger.js';
+export type { ConsoleLoggerConfig } from './console-logger.js';
+export { ConsoleLogger, NullLogger, DEFAULT_CONSOLE_LOGGER_CONFIG } from './console-logger.js';
+export type { LoggerFactoryConfig, LoggerProvider } from './logger-factory.js';
+export { LoggerFactory, createLogger, getLogger } from './logger-factory.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAG/F,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/v3/dist/logging/index.js

@@ -0,0 +1,39 @@
+/**
+ * Agentic QE v3 - Logging Module
+ * Milestone 2.7: Structured Logging Facade
+ *
+ * Centralized logging infrastructure for consistent log formatting,
+ * level filtering, and domain-specific configuration.
+ *
+ * Usage:
+ * ```typescript
+ * import { LoggerFactory, LogLevel } from '../logging';
+ *
+ * // Configure (typically at application startup)
+ * LoggerFactory.setLevel(LogLevel.DEBUG);
+ * // Or from environment
+ * LoggerFactory.initFromEnv();
+ *
+ * // Create domain-specific loggers
+ * const logger = LoggerFactory.create('queen-coordinator');
+ *
+ * // Log messages
+ * logger.info('Task submitted', { taskId: 'task-123', priority: 'high' });
+ * logger.debug('Processing details', { step: 1, duration: 42 });
+ * logger.warn('Resource limit approaching', { usage: 0.85 });
+ * logger.error('Task failed', error, { taskId: 'task-123' });
+ *
+ * // Check if level is enabled (avoid expensive message construction)
+ * if (logger.isEnabled(LogLevel.DEBUG)) {
+ *   logger.debug('Expensive debug info', { data: computeExpensiveData() });
+ * }
+ *
+ * // Create child logger with additional context
+ * const childLogger = logger.child({ requestId: 'req-456' });
+ * childLogger.info('Processing request'); // includes requestId in all messages
+ * ```
+ */
+export { LogLevel, LOG_LEVEL_NAMES, parseLogLevel, isLogger } from './logger.js';
+export { ConsoleLogger, NullLogger, DEFAULT_CONSOLE_LOGGER_CONFIG } from './console-logger.js';
+export { LoggerFactory, createLogger, getLogger } from './logger-factory.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIjF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAI/F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}

package/v3/dist/logging/logger-factory.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Agentic QE v3 - Logger Factory
+ * Milestone 2.7: Structured Logging Facade
+ *
+ * Factory for creating domain-specific loggers with centralized configuration.
+ * Supports runtime level changes and custom logger implementations.
+ */
+import { Logger, LogLevel, LogContext } from './logger.js';
+import { ConsoleLoggerConfig } from './console-logger.js';
+/**
+ * Configuration options for LoggerFactory
+ */
+export interface LoggerFactoryConfig {
+    /** Default log level for all loggers */
+    defaultLevel: LogLevel;
+    /** Domain-specific log level overrides */
+    domainLevels: Map<string, LogLevel>;
+    /** Console logger configuration */
+    consoleConfig: Partial<ConsoleLoggerConfig>;
+    /** Whether to use NullLogger for completely silent operation */
+    silent: boolean;
+}
+/**
+ * Custom logger provider function type
+ * Allows injecting custom logger implementations
+ */
+export type LoggerProvider = (domain: string, level: LogLevel, context?: LogContext) => Logger;
+/**
+ * LoggerFactory - Centralized logger creation and configuration
+ *
+ * Usage:
+ * ```typescript
+ * import { LoggerFactory } from '../logging';
+ *
+ * // Set global log level
+ * LoggerFactory.setLevel(LogLevel.DEBUG);
+ *
+ * // Create domain-specific logger
+ * const logger = LoggerFactory.create('queen-coordinator');
+ *
+ * // Use logger
+ * logger.info('Task submitted', { taskId, priority });
+ * logger.error('Task failed', error, { taskId });
+ * ```
+ */
+export declare class LoggerFactory {
+    private static config;
+    private static customProvider;
+    private static instances;
+    /**
+     * Set the global default log level
+     * Affects all loggers created after this call
+     */
+    static setLevel(level: LogLevel): void;
+    /**
+     * Set log level from environment variable or string
+     * Convenience method for configuration from env vars
+     */
+    static setLevelFromString(level: string): void;
+    /**
+     * Get the current global log level
+     */
+    static getLevel(): LogLevel;
+    /**
+     * Set log level for a specific domain
+     * Allows fine-grained control over logging verbosity
+     */
+    static setDomainLevel(domain: string, level: LogLevel): void;
+    /**
+     * Get the log level for a specific domain
+     * Returns domain-specific level or falls back to default
+     */
+    static getDomainLevel(domain: string): LogLevel;
+    /**
+     * Clear domain-specific level, reverting to default
+     */
+    static clearDomainLevel(domain: string): void;
+    /**
+     * Configure console logger options
+     */
+    static configure(config: Partial<ConsoleLoggerConfig>): void;
+    /**
+     * Enable silent mode (all logging disabled)
+     */
+    static setSilent(silent: boolean): void;
+    /**
+     * Check if silent mode is enabled
+     */
+    static isSilent(): boolean;
+    /**
+     * Register a custom logger provider
+     * Useful for testing or custom logging backends
+     */
+    static setProvider(provider: LoggerProvider | null): void;
+    /**
+     * Create a logger for a specific domain
+     *
+     * @param domain - The domain/namespace for the logger (e.g., 'queen-coordinator', 'test-generation')
+     * @param context - Optional default context to include in all log messages
+     * @returns Logger instance configured for the domain
+     */
+    static create(domain: string, context?: LogContext): Logger;
+    /**
+     * Get a logger (alias for create)
+     * Follows common logging library naming conventions
+     */
+    static getLogger(domain: string, context?: LogContext): Logger;
+    /**
+     * Reset factory to default configuration
+     * Useful for testing
+     */
+    static reset(): void;
+    /**
+     * Initialize from environment variables
+     *
+     * Supported env vars:
+     * - LOG_LEVEL: Global log level (DEBUG, INFO, WARN, ERROR, SILENT)
+     * - LOG_TIMESTAMP: Include timestamps (true/false)
+     * - LOG_PRETTY: Pretty print context (true/false)
+     */
+    static initFromEnv(): void;
+    /**
+     * Get statistics about logger instances
+     */
+    static getStats(): {
+        cachedLoggers: number;
+        domains: string[];
+        domainOverrides: number;
+        currentLevel: LogLevel;
+        silent: boolean;
+    };
+}
+/**
+ * Convenience function to create a logger
+ * Shorthand for LoggerFactory.create()
+ */
+export declare function createLogger(domain: string, context?: LogContext): Logger;
+/**
+ * Get logger for a class or module
+ * Extracts domain name from class name or uses provided string
+ */
+export declare function getLogger(domainOrClass: string | {
+    name: string;
+}, context?: LogContext): Logger;
+//# sourceMappingURL=logger-factory.d.ts.map

package/v3/dist/logging/logger-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-factory.d.ts","sourceRoot":"","sources":["../../src/logging/logger-factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,MAAM,EACN,QAAQ,EACR,UAAU,EAEX,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,mBAAmB,EAGpB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,YAAY,EAAE,QAAQ,CAAC;IACvB,0CAA0C;IAC1C,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,gEAAgE;IAChE,MAAM,EAAE,OAAO,CAAC;CACjB;AAYD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC;AAE/F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAsD;IAC3E,OAAO,CAAC,MAAM,CAAC,cAAc,CAA+B;IAC5D,OAAO,CAAC,MAAM,CAAC,SAAS,CAAkC;IAE1D;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAMtC;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9C;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,QAAQ;IAI3B;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI;IAM5D;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAI/C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK7C;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI;IAS5D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAKvC;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,OAAO;IAI1B;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI;IAKzD;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM;IAyB3D;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM;IAI9D;;;OAGG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAWpB;;;;;;;OAOG;IACH,MAAM,CAAC,WAAW,IAAI,IAAI;IAiB1B;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,QAAQ,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC;KACjB;CASF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAGhG"}