agentic-qe 3.3.2 → 3.3.4

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"}

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

@@ -0,0 +1,218 @@
+/**
+ * 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 { LogLevel, parseLogLevel, } from './logger.js';
+import { ConsoleLogger, NullLogger, DEFAULT_CONSOLE_LOGGER_CONFIG, } from './console-logger.js';
+/**
+ * Default factory configuration
+ */
+const DEFAULT_FACTORY_CONFIG = {
+    defaultLevel: LogLevel.INFO,
+    domainLevels: new Map(),
+    consoleConfig: DEFAULT_CONSOLE_LOGGER_CONFIG,
+    silent: false,
+};
+/**
+ * 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 class LoggerFactory {
+    static config = { ...DEFAULT_FACTORY_CONFIG };
+    static customProvider = null;
+    static instances = new Map();
+    /**
+     * Set the global default log level
+     * Affects all loggers created after this call
+     */
+    static setLevel(level) {
+        this.config.defaultLevel = level;
+        // Clear cached instances so new ones pick up the new level
+        this.instances.clear();
+    }
+    /**
+     * Set log level from environment variable or string
+     * Convenience method for configuration from env vars
+     */
+    static setLevelFromString(level) {
+        this.setLevel(parseLogLevel(level));
+    }
+    /**
+     * Get the current global log level
+     */
+    static getLevel() {
+        return this.config.defaultLevel;
+    }
+    /**
+     * Set log level for a specific domain
+     * Allows fine-grained control over logging verbosity
+     */
+    static setDomainLevel(domain, level) {
+        this.config.domainLevels.set(domain, level);
+        // Remove cached instance if exists
+        this.instances.delete(domain);
+    }
+    /**
+     * Get the log level for a specific domain
+     * Returns domain-specific level or falls back to default
+     */
+    static getDomainLevel(domain) {
+        return this.config.domainLevels.get(domain) ?? this.config.defaultLevel;
+    }
+    /**
+     * Clear domain-specific level, reverting to default
+     */
+    static clearDomainLevel(domain) {
+        this.config.domainLevels.delete(domain);
+        this.instances.delete(domain);
+    }
+    /**
+     * Configure console logger options
+     */
+    static configure(config) {
+        this.config.consoleConfig = {
+            ...this.config.consoleConfig,
+            ...config,
+        };
+        // Clear cached instances
+        this.instances.clear();
+    }
+    /**
+     * Enable silent mode (all logging disabled)
+     */
+    static setSilent(silent) {
+        this.config.silent = silent;
+        this.instances.clear();
+    }
+    /**
+     * Check if silent mode is enabled
+     */
+    static isSilent() {
+        return this.config.silent;
+    }
+    /**
+     * Register a custom logger provider
+     * Useful for testing or custom logging backends
+     */
+    static setProvider(provider) {
+        this.customProvider = provider;
+        this.instances.clear();
+    }
+    /**
+     * 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, context) {
+        // Check cache first (only for loggers without custom context)
+        if (!context && this.instances.has(domain)) {
+            return this.instances.get(domain);
+        }
+        const level = this.getDomainLevel(domain);
+        let logger;
+        if (this.config.silent) {
+            logger = new NullLogger(domain);
+        }
+        else if (this.customProvider) {
+            logger = this.customProvider(domain, level, context);
+        }
+        else {
+            logger = new ConsoleLogger(domain, level, this.config.consoleConfig, context);
+        }
+        // Cache only loggers without custom context
+        if (!context) {
+            this.instances.set(domain, logger);
+        }
+        return logger;
+    }
+    /**
+     * Get a logger (alias for create)
+     * Follows common logging library naming conventions
+     */
+    static getLogger(domain, context) {
+        return this.create(domain, context);
+    }
+    /**
+     * Reset factory to default configuration
+     * Useful for testing
+     */
+    static reset() {
+        this.config = {
+            defaultLevel: LogLevel.INFO,
+            domainLevels: new Map(),
+            consoleConfig: { ...DEFAULT_CONSOLE_LOGGER_CONFIG },
+            silent: false,
+        };
+        this.customProvider = null;
+        this.instances.clear();
+    }
+    /**
+     * 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() {
+        const level = process.env.LOG_LEVEL;
+        if (level) {
+            this.setLevelFromString(level);
+        }
+        const timestamp = process.env.LOG_TIMESTAMP;
+        if (timestamp !== undefined) {
+            this.configure({ includeTimestamp: timestamp.toLowerCase() === 'true' });
+        }
+        const pretty = process.env.LOG_PRETTY;
+        if (pretty !== undefined) {
+            this.configure({ prettyPrint: pretty.toLowerCase() === 'true' });
+        }
+    }
+    /**
+     * Get statistics about logger instances
+     */
+    static getStats() {
+        return {
+            cachedLoggers: this.instances.size,
+            domains: Array.from(this.instances.keys()),
+            domainOverrides: this.config.domainLevels.size,
+            currentLevel: this.config.defaultLevel,
+            silent: this.config.silent,
+        };
+    }
+}
+/**
+ * Convenience function to create a logger
+ * Shorthand for LoggerFactory.create()
+ */
+export function createLogger(domain, context) {
+    return LoggerFactory.create(domain, context);
+}
+/**
+ * Get logger for a class or module
+ * Extracts domain name from class name or uses provided string
+ */
+export function getLogger(domainOrClass, context) {
+    const domain = typeof domainOrClass === 'string' ? domainOrClass : domainOrClass.name;
+    return LoggerFactory.create(domain, context);
+}
+//# sourceMappingURL=logger-factory.js.map

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

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

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

@@ -0,0 +1,89 @@
+/**
+ * Agentic QE v3 - Logger Interface
+ * Milestone 2.7: Structured Logging Facade
+ *
+ * Provides a centralized logging abstraction to replace direct console.log calls
+ * throughout services, enabling consistent log formatting, level filtering,
+ * and future extensibility (file logging, remote logging, etc.).
+ */
+/**
+ * Log levels ordered by verbosity (lower = more verbose)
+ */
+export declare enum LogLevel {
+    /** Detailed debugging information for development */
+    DEBUG = 0,
+    /** General informational messages about application flow */
+    INFO = 1,
+    /** Warning conditions that are not errors but may need attention */
+    WARN = 2,
+    /** Error conditions that should be investigated */
+    ERROR = 3,
+    /** No logging - completely silent */
+    SILENT = 4
+}
+/**
+ * String representation of log levels for display
+ */
+export declare const LOG_LEVEL_NAMES: Record<LogLevel, string>;
+/**
+ * Parse a string to LogLevel (case-insensitive)
+ */
+export declare function parseLogLevel(level: string): LogLevel;
+/**
+ * Contextual metadata that can be attached to log entries
+ */
+export type LogContext = Record<string, unknown>;
+/**
+ * Logger interface defining the contract for all logger implementations
+ *
+ * Each method accepts:
+ * - message: The log message (human-readable)
+ * - context: Optional structured data for machine parsing
+ *
+ * The error() method additionally accepts an Error object for stack trace logging.
+ */
+export interface Logger {
+    /**
+     * Log detailed debugging information
+     * Use for development-time diagnostics that would be too verbose in production
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Log general informational messages
+     * Use for significant events in normal application flow
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Log warning conditions
+     * Use for recoverable issues that may need attention
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Log error conditions
+     * Use for failures that require investigation
+     *
+     * @param message - Human-readable error description
+     * @param error - Optional Error object for stack trace
+     * @param context - Optional structured metadata
+     */
+    error(message: string, error?: Error, context?: LogContext): void;
+    /**
+     * Check if a given log level is enabled
+     * Useful for avoiding expensive log message construction
+     */
+    isEnabled(level: LogLevel): boolean;
+    /**
+     * Get the domain/namespace this logger is associated with
+     */
+    getDomain(): string;
+    /**
+     * Create a child logger with additional context
+     * The child inherits the parent's configuration but adds context to all messages
+     */
+    child(context: LogContext): Logger;
+}
+/**
+ * Type guard to check if an object implements Logger interface
+ */
+export declare function isLogger(obj: unknown): obj is Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,qDAAqD;IACrD,KAAK,IAAI;IACT,4DAA4D;IAC5D,IAAI,IAAI;IACR,oEAAoE;IACpE,IAAI,IAAI;IACR,mDAAmD;IACnD,KAAK,IAAI;IACT,qCAAqC;IACrC,MAAM,IAAI;CACX;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAMpD,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAmBrD;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEnD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAElD;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAElD;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAElE;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IAEpC;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAcpD"}

package/v3/dist/logging/logger.js

@@ -0,0 +1,74 @@
+/**
+ * Agentic QE v3 - Logger Interface
+ * Milestone 2.7: Structured Logging Facade
+ *
+ * Provides a centralized logging abstraction to replace direct console.log calls
+ * throughout services, enabling consistent log formatting, level filtering,
+ * and future extensibility (file logging, remote logging, etc.).
+ */
+/**
+ * Log levels ordered by verbosity (lower = more verbose)
+ */
+export var LogLevel;
+(function (LogLevel) {
+    /** Detailed debugging information for development */
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    /** General informational messages about application flow */
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    /** Warning conditions that are not errors but may need attention */
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    /** Error conditions that should be investigated */
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    /** No logging - completely silent */
+    LogLevel[LogLevel["SILENT"] = 4] = "SILENT";
+})(LogLevel || (LogLevel = {}));
+/**
+ * String representation of log levels for display
+ */
+export const LOG_LEVEL_NAMES = {
+    [LogLevel.DEBUG]: 'DEBUG',
+    [LogLevel.INFO]: 'INFO',
+    [LogLevel.WARN]: 'WARN',
+    [LogLevel.ERROR]: 'ERROR',
+    [LogLevel.SILENT]: 'SILENT',
+};
+/**
+ * Parse a string to LogLevel (case-insensitive)
+ */
+export function parseLogLevel(level) {
+    const normalized = level.toUpperCase();
+    switch (normalized) {
+        case 'DEBUG':
+            return LogLevel.DEBUG;
+        case 'INFO':
+            return LogLevel.INFO;
+        case 'WARN':
+        case 'WARNING':
+            return LogLevel.WARN;
+        case 'ERROR':
+            return LogLevel.ERROR;
+        case 'SILENT':
+        case 'NONE':
+        case 'OFF':
+            return LogLevel.SILENT;
+        default:
+            return LogLevel.INFO;
+    }
+}
+/**
+ * Type guard to check if an object implements Logger interface
+ */
+export function isLogger(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const candidate = obj;
+    return (typeof candidate.debug === 'function' &&
+        typeof candidate.info === 'function' &&
+        typeof candidate.warn === 'function' &&
+        typeof candidate.error === 'function' &&
+        typeof candidate.isEnabled === 'function' &&
+        typeof candidate.getDomain === 'function' &&
+        typeof candidate.child === 'function');
+}
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,QAWX;AAXD,WAAY,QAAQ;IAClB,qDAAqD;IACrD,yCAAS,CAAA;IACT,4DAA4D;IAC5D,uCAAQ,CAAA;IACR,oEAAoE;IACpE,uCAAQ,CAAA;IACR,mDAAmD;IACnD,yCAAS,CAAA;IACT,qCAAqC;IACrC,2CAAU,CAAA;AACZ,CAAC,EAXW,QAAQ,KAAR,QAAQ,QAWnB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACvB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IACvB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IACzB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,KAAK,CAAC;QACxB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,OAAO,QAAQ,CAAC,MAAM,CAAC;QACzB;YACE,OAAO,QAAQ,CAAC,IAAI,CAAC;IACzB,CAAC;AACH,CAAC;AA+DD;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAY;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,SAAS,GAAG,GAA8B,CAAC;IACjD,OAAO,CACL,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU;QACrC,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU;QACpC,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU;QACpC,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU;QACrC,OAAO,SAAS,CAAC,SAAS,KAAK,UAAU;QACzC,OAAO,SAAS,CAAC,SAAS,KAAK,UAAU;QACzC,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,CACtC,CAAC;AACJ,CAAC"}