@mks2508/better-logger 0.14.0-alpha.2 → 0.18.2-alpha.2

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sources":["../src/core.ts"],"sourcesContent":["/**\n * @fileoverview Core Logger Module - Minimal logging without advanced features\n * @version 0.0.1\n * \n * This module provides the essential logging functionality without visual enhancements,\n * SVG support, or advanced styling. Perfect for lightweight applications or server-side usage.\n */\n\n// Core types\nimport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata,\n    TimerEntry\n} from './types/index.js';\n\n// Core utilities\nimport {\n    parseStackTrace,\n    formatTimestamp\n} from './utils/index.js';\n\n// Universal formatting and environment detection\nimport {\n    createPlainOutput,\n    getConsoleMethod,\n    createLogEntry,\n    formatTablePlain,\n    safeSerialize\n} from './utils/formatting.js';\n\nimport {\n    isBrowser,\n    isNode,\n    getRuntimeEnvironment,\n    supportsColors,\n    supportsCSSColors\n} from './utils/environment.js';\n\nimport { createStyledOutput } from './utils/output.js';\n\n// Constants\nimport { DEFAULT_CONFIG, LEVEL_STYLES } from './constants.js';\n\n/**\n * Minimal Logger class with core functionality only\n * \n * @example\n * ```typescript\n * import { CoreLogger } from '@mks2508/better-logger/core';\n * \n * const logger = new CoreLogger();\n * logger.info('Hello world');\n * logger.error('Something went wrong', error);\n * ```\n */\nexport class CoreLogger {\n    private config: LoggerConfig;\n    private scopedPrefix?: string;\n    private handlers: ILogHandler[] = [];\n    private timers: Map<string, TimerEntry> = new Map();\n    private groupDepth: number = 0;\n\n    /**\n     * Creates a new CoreLogger instance\n     * @param config - Optional configuration\n     */\n    constructor(config: Partial<LoggerConfig> = {}) {\n        this.config = {\n            ...DEFAULT_CONFIG,\n            ...config,\n            // Auto-configure based on environment\n            enableColors: config.enableColors ?? (isBrowser ? true : false),\n            enableTimestamps: config.enableTimestamps ?? true,\n            enableStackTrace: config.enableStackTrace ?? false,\n            autoDetectTheme: config.autoDetectTheme ?? true\n        };\n    }\n\n    // ===== CONFIGURATION METHODS =====\n\n    /**\n     * Get current configuration\n     */\n    getConfig(): LoggerConfig {\n        return { ...this.config };\n    }\n\n    /**\n     * Sets the global prefix for all log messages\n     */\n    setGlobalPrefix(prefix: string): void {\n        this.config.globalPrefix = prefix;\n    }\n\n    /**\n     * Sets the verbosity level for filtering log output\n     */\n    setVerbosity(level: Verbosity): void {\n        this.config.verbosity = level;\n    }\n\n    /**\n     * Creates a scoped logger with a specific prefix\n     */\n    scope(prefix: string): CoreLogger {\n        const scopedLogger = new CoreLogger(this.config);\n        scopedLogger.scopedPrefix = prefix;\n        scopedLogger.handlers = [...this.handlers];\n        return scopedLogger;\n    }\n\n    /**\n     * Adds a custom log handler for extensibility\n     */\n    addHandler(handler: ILogHandler): void {\n        this.handlers.push(handler);\n    }\n\n    // ===== CORE LOGGING METHODS =====\n\n    /**\n     * Checks if a log level should be output based on current verbosity\n     */\n    private shouldLog(level: LogLevel): boolean {\n        if (this.config.verbosity === 'silent') return false;\n        const levels = { debug: 0, info: 1, warn: 2, error: 3, critical: 4 };\n        return levels[level] >= levels[this.config.verbosity];\n    }\n\n    /**\n     * Gets the effective prefix (global + scoped)\n     */\n    private getEffectivePrefix(): string | undefined {\n        const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);\n        return parts.length > 0 ? parts.join(':') : undefined;\n    }\n\n    /**\n     * Core logging method with universal formatting\n     */\n    private log(level: LogLevel, ...args: any[]): void {\n        if (!this.shouldLog(level)) return;\n\n        const prefix = this.getEffectivePrefix();\n        const message = String(args[0] || '');\n        const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;\n        const consoleMethod = getConsoleMethod(level);\n        \n        // Choose formatting based on environment and configuration\n        if (isBrowser && this.config.enableColors && supportsCSSColors()) {\n            // Browser with CSS styling\n            try {\n                const [format, ...styles] = createStyledOutput(\n                    level,\n                    LEVEL_STYLES,\n                    prefix,\n                    message,\n                    stackInfo,\n                    this.config.autoDetectTheme\n                );\n                console[consoleMethod](format, ...styles, ...args.slice(1));\n            } catch (error) {\n                // Fallback to plain text if CSS fails\n                const output = createPlainOutput(level, message, prefix, stackInfo);\n                console[consoleMethod](output, ...args.slice(1));\n            }\n        } else {\n            // Node.js or browser without colors - use plain text\n            const groupIndent = '  '.repeat(this.groupDepth);\n            const output = groupIndent + createPlainOutput(level, message, prefix, stackInfo);\n            console[consoleMethod](output, ...args.slice(1));\n        }\n\n        // Call custom handlers with structured metadata\n        const logEntry = createLogEntry(level, message, args, prefix, stackInfo);\n        const metadata: LogMetadata = {\n            timestamp: logEntry.timestamp,\n            level,\n            prefix,\n            stackInfo: logEntry.location,\n        };\n\n        this.handlers.forEach(handler => {\n            try {\n                handler.handle(level, message, args, metadata);\n            } catch (error) {\n                console.error('Log handler failed:', error);\n            }\n        });\n    }\n\n    /**\n     * Logs debug information (lowest priority)\n     */\n    debug(...args: any[]): void {\n        this.log('debug', ...args);\n    }\n\n    /**\n     * Logs informational messages\n     */\n    info(...args: any[]): void {\n        this.log('info', ...args);\n    }\n\n    /**\n     * Logs warning messages\n     */\n    warn(...args: any[]): void {\n        this.log('warn', ...args);\n    }\n\n    /**\n     * Logs error messages\n     */\n    error(...args: any[]): void {\n        this.log('error', ...args);\n    }\n\n    /**\n     * Logs critical errors (highest priority)\n     */\n    critical(...args: any[]): void {\n        this.log('critical', ...args);\n    }\n\n    /**\n     * Logs trace information (detailed debugging)\n     */\n    trace(...args: any[]): void {\n        this.log('debug', ...args);\n        if (this.shouldLog('debug')) {\n            console.trace(...args);\n        }\n    }\n\n    // ===== BASIC ADVANCED FEATURES =====\n\n    /**\n     * Displays data in a table format\n     */\n    table(data: any, columns?: string[]): void {\n        if (!this.shouldLog('info')) return;\n\n        const prefix = this.getEffectivePrefix();\n        const tableHeader = `[TABLE]${prefix ? ` [${prefix}]` : ''}:`;\n        \n        if (isBrowser && typeof console.table === 'function') {\n            // Browser has native table support\n            console.log(tableHeader);\n            if (columns) {\n                console.table(data, columns);\n            } else {\n                console.table(data);\n            }\n        } else {\n            // Node.js or fallback - use plain text formatting\n            console.log(tableHeader);\n            const tableText = formatTablePlain(data, columns);\n            console.log(tableText);\n        }\n    }\n\n    /**\n     * Starts a collapsible group in the console\n     */\n    group(label: string, collapsed: boolean = false): void {\n        const prefix = this.getEffectivePrefix();\n        const fullLabel = `${prefix ? `[${prefix}] ` : ''}${label}`;\n        \n        if (isBrowser && console.group && console.groupCollapsed) {\n            // Browser supports native grouping\n            if (collapsed) {\n                console.groupCollapsed(fullLabel);\n            } else {\n                console.group(fullLabel);\n            }\n        } else {\n            // Node.js fallback - just log the group label\n            const groupStart = '┌─ ' + fullLabel;\n            console.log(groupStart);\n        }\n        \n        this.groupDepth++;\n    }\n\n    /**\n     * Ends the current console group\n     */\n    groupEnd(): void {\n        if (this.groupDepth > 0) {\n            if (isBrowser && console.groupEnd) {\n                console.groupEnd();\n            } else {\n                // Node.js fallback - log group end\n                const groupEnd = '└─ (end group)';\n                console.log(groupEnd);\n            }\n            this.groupDepth--;\n        }\n    }\n\n    /**\n     * Starts a timer with the given label\n     */\n    time(label: string): void {\n        const startTime = this.getPerformanceNow();\n        const timer: TimerEntry = {\n            label,\n            startTime,\n        };\n        this.timers.set(label, timer);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer started: ${label}`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Ends a timer and logs the elapsed time\n     */\n    timeEnd(label: string): void {\n        const timer = this.timers.get(label);\n        if (!timer) {\n            this.warn(`Timer '${label}' does not exist`);\n            return;\n        }\n\n        const elapsed = this.getPerformanceNow() - timer.startTime;\n        this.timers.delete(label);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer ended: ${label} - ${elapsed.toFixed(2)}ms`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Gets performance.now() or fallback for older environments\n     */\n    private getPerformanceNow(): number {\n        if (typeof performance !== 'undefined' && performance.now) {\n            return performance.now();\n        }\n        \n        if (isNode && process.hrtime) {\n            // Node.js high-resolution time\n            const [seconds, nanoseconds] = process.hrtime();\n            return seconds * 1000 + nanoseconds / 1000000;\n        }\n        \n        // Fallback to Date.now()\n        return Date.now();\n    }\n}\n\n// Create and export singleton instance for convenience\nconst coreLogger = new CoreLogger();\n\n/**\n * Export individual methods for convenience (with proper binding)\n */\nexport const debug = (...args: any[]) => coreLogger.debug(...args);\nexport const info = (...args: any[]) => coreLogger.info(...args);\nexport const warn = (...args: any[]) => coreLogger.warn(...args);\nexport const error = (...args: any[]) => coreLogger.error(...args);\nexport const critical = (...args: any[]) => coreLogger.critical(...args);\nexport const trace = (...args: any[]) => coreLogger.trace(...args);\nexport const table = (data: any, columns?: string[]) => coreLogger.table(data, columns);\nexport const group = (label: string, collapsed?: boolean) => coreLogger.group(label, collapsed);\nexport const groupEnd = () => coreLogger.groupEnd();\nexport const time = (label: string) => coreLogger.time(label);\nexport const timeEnd = (label: string) => coreLogger.timeEnd(label);\nexport const setGlobalPrefix = (prefix: string) => coreLogger.setGlobalPrefix(prefix);\nexport const scope = (prefix: string) => coreLogger.scope(prefix);\nexport const setVerbosity = (level: Verbosity) => coreLogger.setVerbosity(level);\nexport const addHandler = (handler: ILogHandler) => coreLogger.addHandler(handler);\n\n// Export the singleton as default\nexport default coreLogger;\n\n// Re-export core types\nexport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata\n} from './types/index.js';"],"names":["error","groupEnd"],"mappings":"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"}
+{"version":3,"file":"core.js","names":[],"sources":["../src/core.ts"],"sourcesContent":["/**\n * @fileoverview Módulo Core Logger — logging minimal sin features avanzadas\n *\n * Provee la funcionalidad esencial de logging sin mejoras visuales,\n * soporte SVG ni styling avanzado. Adecuado para apps ligeras o uso server-side.\n */\n\n// Tipos core\nimport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata,\n    TimerEntry\n} from './types/index.js';\n\n// Utilidades core\nimport {\n    parseStackTrace,\n    formatTimestamp\n} from './utils/index.js';\n\n// Formato universal y detección de entorno\nimport {\n    createPlainOutput,\n    getConsoleMethod,\n    createLogEntry,\n    formatTablePlain,\n    safeSerialize,\n    type OutputFormat\n} from './utils/formatting.js';\n\nimport {\n    isBrowser,\n    isNode\n} from './utils/environment-detector.js';\n\nimport { createStyledOutput } from './utils/output.js';\n\n// Constantes\nimport { DEFAULT_CONFIG, LEVEL_STYLES } from './constants.js';\nimport { LOG_LEVELS } from './types/core.js';\n\n/**\n * Logger minimal con solo la funcionalidad core.\n *\n * @example\n * ```typescript\n * import { CoreLogger } from '@mks2508/better-logger/core';\n *\n * const logger = new CoreLogger();\n * logger.info('Hello world');\n * logger.error('Something went wrong', error);\n * ```\n */\nexport class CoreLogger {\n    private config: LoggerConfig;\n    private scopedPrefix?: string;\n    private handlers: ILogHandler[] = [];\n    private timers: Map<string, TimerEntry> = new Map();\n    private groupDepth: number = 0;\n\n    /**\n     * Crea una nueva instancia de CoreLogger.\n     * @param config - Configuración opcional.\n     */\n    constructor(config: Partial<LoggerConfig> = {}) {\n        this.config = {\n            ...DEFAULT_CONFIG,\n            ...config,\n            // Auto-configurar según entorno\n            enableColors: config.enableColors ?? (isBrowser ? true : false),\n            enableTimestamps: config.enableTimestamps ?? true,\n            enableStackTrace: config.enableStackTrace ?? false,\n            autoDetectTheme: config.autoDetectTheme ?? true,\n            outputFormat: config.outputFormat ?? 'auto'\n        };\n    }\n\n    // ===== MÉTODOS DE CONFIGURACIÓN =====\n\n    /**\n     * Obtiene la configuración actual.\n     */\n    getConfig(): LoggerConfig {\n        return { ...this.config };\n    }\n\n    /**\n     * Define el prefijo global para todos los mensajes de log.\n     * @param prefix - Prefijo a aplicar a todos los mensajes.\n     */\n    setGlobalPrefix(prefix: string): void {\n        this.config.globalPrefix = prefix;\n    }\n\n    /**\n     * Define el nivel de verbosity para filtrar la salida de log.\n     * @param level - Nivel de verbosity.\n     */\n    setVerbosity(level: Verbosity): void {\n        this.config.verbosity = level;\n    }\n\n    /**\n     * Crea un logger con scope y un prefijo específico.\n     * @param prefix - Prefijo del scope.\n     * @returns Nueva instancia de CoreLogger con el prefijo asignado.\n     */\n    scope(prefix: string): CoreLogger {\n        const scopedLogger = new CoreLogger(this.config);\n        scopedLogger.scopedPrefix = prefix;\n        scopedLogger.handlers = [...this.handlers];\n        return scopedLogger;\n    }\n\n    /**\n     * Añade un handler personalizado para extensibilidad.\n     * @param handler - Handler que implementa la interfaz ILogHandler.\n     */\n    addHandler(handler: ILogHandler): void {\n        this.handlers.push(handler);\n    }\n\n    // ===== MÉTODOS CORE DE LOGGING =====\n\n    /**\n     * Comprueba si un nivel debe emitirse según el verbosity actual.\n     * @param level - Nivel a evaluar.\n     * @returns `true` si el nivel debe emitirse.\n     */\n    private shouldLog(level: LogLevel): boolean {\n        if (this.config.verbosity === 'silent') return false;\n        const verbosity = this.config.verbosity as LogLevel;\n        return LOG_LEVELS[level] >= LOG_LEVELS[verbosity];\n    }\n\n    /**\n     * Obtiene el prefijo efectivo (global + scope).\n     * @returns Prefijo combinado o `undefined` si no hay ninguno.\n     */\n    private getEffectivePrefix(): string | undefined {\n        const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);\n        return parts.length > 0 ? parts.join(':') : undefined;\n    }\n\n    /**\n     * Método principal de log con formato universal.\n     * @param level - Nivel del mensaje.\n     * @param args - Argumentos del mensaje.\n     */\n    private log(level: LogLevel, ...args: unknown[]): void {\n        if (!this.shouldLog(level)) return;\n\n        const prefix = this.getEffectivePrefix();\n        const message = String(args[0] || '');\n        const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;\n        const consoleMethod = getConsoleMethod(level);\n\n        // Elegir formato según entorno y configuración\n        if (isBrowser && this.config.enableColors) {\n            // Browser con styling CSS\n            try {\n                const [format, ...styles] = createStyledOutput(\n                    level,\n                    LEVEL_STYLES,\n                    prefix,\n                    message,\n                    stackInfo,\n                    this.config.autoDetectTheme\n                );\n                console[consoleMethod](format, ...styles, ...args.slice(1));\n            } catch (error) {\n                // Fallback a formato plano si falla el CSS\n                const output = createPlainOutput(level, message, prefix, stackInfo);\n                console[consoleMethod](output, ...args.slice(1));\n            }\n        } else {\n            // Node.js o browser sin colores: formato plano\n            const groupIndent = '  '.repeat(this.groupDepth);\n            const output = groupIndent + createPlainOutput(level, message, prefix, stackInfo);\n            console[consoleMethod](output, ...args.slice(1));\n        }\n\n        // Llama a los handlers con metadata estructurada\n        const logEntry = createLogEntry(level, message, args, prefix, stackInfo);\n        const metadata: LogMetadata = {\n            timestamp: logEntry.timestamp,\n            level,\n            prefix,\n            stackInfo: logEntry.location,\n        };\n\n        this.handlers.forEach(handler => {\n            try {\n                handler.handle(level, message, args, metadata);\n            } catch (error) {\n                console.error('Log handler failed:', error);\n            }\n        });\n    }\n\n    /**\n     * Emite mensajes de debug (prioridad más baja).\n     * @param args - Argumentos del mensaje.\n     */\n    debug(...args: unknown[]): void {\n        this.log('debug', ...args);\n    }\n\n    /**\n     * Emite mensajes informativos.\n     * @param args - Argumentos del mensaje.\n     */\n    info(...args: unknown[]): void {\n        this.log('info', ...args);\n    }\n\n    /**\n     * Emite mensajes de advertencia.\n     * @param args - Argumentos del mensaje.\n     */\n    warn(...args: unknown[]): void {\n        this.log('warn', ...args);\n    }\n\n    /**\n     * Emite mensajes de error.\n     * @param args - Argumentos del mensaje.\n     */\n    error(...args: unknown[]): void {\n        this.log('error', ...args);\n    }\n\n    /**\n     * Emite errores críticos (prioridad más alta).\n     * @param args - Argumentos del mensaje.\n     */\n    critical(...args: unknown[]): void {\n        this.log('critical', ...args);\n    }\n\n    /**\n     * Emite información de trace (debugging detallado).\n     * @param args - Argumentos del mensaje.\n     */\n    trace(...args: unknown[]): void {\n        this.log('debug', ...args);\n        if (this.shouldLog('debug')) {\n            console.trace(...args);\n        }\n    }\n\n    // ===== FEATURES AVANZADAS BÁSICAS =====\n\n    /**\n     * Muestra datos en formato tabla.\n     * @param data - Datos a mostrar.\n     * @param columns - Columnas opcionales a incluir.\n     */\n    table(data: any, columns?: string[]): void {\n        if (!this.shouldLog('info')) return;\n\n        const prefix = this.getEffectivePrefix();\n        const tableHeader = `[TABLE]${prefix ? ` [${prefix}]` : ''}:`;\n        \n        if (isBrowser && typeof console.table === 'function') {\n            // Browser con soporte nativo de table\n            console.log(tableHeader);\n            if (columns) {\n                console.table(data, columns);\n            } else {\n                console.table(data);\n            }\n        } else {\n            // Node.js o fallback: formato de texto plano\n            console.log(tableHeader);\n            const tableText = formatTablePlain(data, columns);\n            console.log(tableText);\n        }\n    }\n\n    /**\n     * Inicia un grupo colapsable en la console.\n     * @param label - Etiqueta del grupo.\n     * @param collapsed - Si el grupo inicia colapsado.\n     */\n    group(label: string, collapsed: boolean = false): void {\n        const prefix = this.getEffectivePrefix();\n        const fullLabel = `${prefix ? `[${prefix}] ` : ''}${label}`;\n        \n        if (isBrowser && console.group && console.groupCollapsed) {\n            // Browser soporta grouping nativo\n            if (collapsed) {\n                console.groupCollapsed(fullLabel);\n            } else {\n                console.group(fullLabel);\n            }\n        } else {\n            // Fallback Node.js: solo emite el label del grupo\n            const groupStart = '┌─ ' + fullLabel;\n            console.log(groupStart);\n        }\n        \n        this.groupDepth++;\n    }\n\n    /**\n     * Cierra el grupo actual de la console.\n     */\n    groupEnd(): void {\n        if (this.groupDepth > 0) {\n            if (isBrowser && console.groupEnd) {\n                console.groupEnd();\n            } else {\n                // Fallback Node.js: emite el cierre del grupo\n                const groupEnd = '└─ (end group)';\n                console.log(groupEnd);\n            }\n            this.groupDepth--;\n        }\n    }\n\n    /**\n     * Inicia un timer con el label indicado.\n     * @param label - Identificador del timer.\n     */\n    time(label: string): void {\n        const startTime = this.getPerformanceNow();\n        const timer: TimerEntry = {\n            label,\n            startTime,\n        };\n        this.timers.set(label, timer);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer started: ${label}`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Detiene un timer y emite el tiempo transcurrido.\n     * @param label - Identificador del timer previamente iniciado.\n     */\n    timeEnd(label: string): void {\n        const timer = this.timers.get(label);\n        if (!timer) {\n            this.warn(`Timer '${label}' does not exist`);\n            return;\n        }\n\n        const elapsed = this.getPerformanceNow() - timer.startTime;\n        this.timers.delete(label);\n        \n        const prefix = this.getEffectivePrefix();\n        const message = `Timer ended: ${label} - ${elapsed.toFixed(2)}ms`;\n        const output = createPlainOutput('info', message, prefix);\n        console.log(output);\n    }\n\n    /**\n     * Obtiene `performance.now()` o un fallback para entornos antiguos.\n     * @returns Timestamp en milisegundos.\n     */\n    private getPerformanceNow(): number {\n        if (typeof performance !== 'undefined' && performance.now) {\n            return performance.now();\n        }\n        \n        if (isNode && process.hrtime) {\n            // Node.js high-resolution time\n            const [seconds, nanoseconds] = process.hrtime();\n            return seconds * 1000 + nanoseconds / 1000000;\n        }\n        \n        // Fallback a Date.now()\n        return Date.now();\n    }\n}\n\n// Crea y exporta una instancia singleton por conveniencia\nconst coreLogger = new CoreLogger();\n\n/**\n * Exporta métodos individuales por conveniencia (con binding correcto).\n */\nexport const debug = (...args: any[]) => coreLogger.debug(...args);\nexport const info = (...args: any[]) => coreLogger.info(...args);\nexport const warn = (...args: any[]) => coreLogger.warn(...args);\nexport const error = (...args: any[]) => coreLogger.error(...args);\nexport const critical = (...args: any[]) => coreLogger.critical(...args);\nexport const trace = (...args: any[]) => coreLogger.trace(...args);\nexport const table = (data: any, columns?: string[]) => coreLogger.table(data, columns);\nexport const group = (label: string, collapsed?: boolean) => coreLogger.group(label, collapsed);\nexport const groupEnd = () => coreLogger.groupEnd();\nexport const time = (label: string) => coreLogger.time(label);\nexport const timeEnd = (label: string) => coreLogger.timeEnd(label);\nexport const setGlobalPrefix = (prefix: string) => coreLogger.setGlobalPrefix(prefix);\nexport const scope = (prefix: string) => coreLogger.scope(prefix);\nexport const setVerbosity = (level: Verbosity) => coreLogger.setVerbosity(level);\nexport const addHandler = (handler: ILogHandler) => coreLogger.addHandler(handler);\n\n// Exporta el singleton como default\nexport default coreLogger;\n\n// Re-exporta tipos core\nexport type {\n    LogLevel,\n    Verbosity,\n    LoggerConfig,\n    ILogHandler,\n    LogMetadata\n} from './types/index.js';"],"mappings":"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"}

package/dist/hooks/HookBridge.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview HookBridge — facade de HookManager.
+ * Encapsula registro de hooks, middleware pipeline y emisión de eventos.
+ *
+ * @internal
+ */
+import type { HookEvent, HookCallback, MiddlewareFn } from '../types/index.js';
+import { HookManager } from './index.js';
+/**
+ * Bridge para la gestión de hooks y middleware.
+ *
+ * @internal
+ */
+export interface HookBridge {
+    /** Registra un hook para un evento. Devuelve función de unsubscribe. */
+    on(event: HookEvent, callback: HookCallback, priority?: number): () => void;
+    /** Registra un hook one-time. Devuelve función de unsubscribe. */
+    once(event: HookEvent, callback: HookCallback, priority?: number): () => void;
+    /** Elimina un hook registrado. Devuelve `true` si se eliminó. */
+    off(event: HookEvent, callback: HookCallback): boolean;
+    /** Añade middleware al pipeline. Devuelve función de unsubscribe. */
+    use(middleware: MiddlewareFn, priority?: number): () => void;
+    /** Devuelve el HookManager subyacente. */
+    getHookManager(): HookManager;
+}
+/**
+ * Crea una instancia de {@link HookBridge}.
+ *
+ * @internal
+ */
+export declare function createHookBridge(): HookBridge;
+//# sourceMappingURL=HookBridge.d.ts.map

package/dist/hooks/HookBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookBridge.d.ts","sourceRoot":"","sources":["../../src/hooks/HookBridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACvB,wEAAwE;IACxE,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC5E,kEAAkE;IAClE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC9E,iEAAiE;IACjE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC;IACvD,qEAAqE;IACrE,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7D,0CAA0C;IAC1C,cAAc,IAAI,WAAW,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAwB7C"}

package/dist/hooks/HookManager.d.ts

@@ -0,0 +1,319 @@
+import type { HookLogEntry, HookEvent, HookCallback, MiddlewareFn, IHookManager } from '../types/index.js';
+/**
+ * Implementación por defecto de {@link IHookManager} que orquesta el ciclo de
+ * vida de los hooks del logger: `beforeLog`, `afterLog` y `onError`.
+ *
+ * Permite:
+ * - Registrar callbacks por evento con **prioridad** (mayor número = se
+ *   ejecuta primero; las registraciones se ordenan descendentemente).
+ * - Encadenar middlewares sobre el entry previo al dispatch.
+ * - Propagar mutaciones: cada hook puede retornar un partial de
+ *   {@link HookLogEntry} que se mergea al entry actual antes del siguiente hook.
+ * - Acotar la recursión de `onError` con un guard de profundidad
+ *   ({@link MAX_ONERROR_DEPTH}) para que un hook que lanza no loopée para
+ *   siempre.
+ *
+ * El flujo típico lo orquesta el logger vía {@link process} (emite `beforeLog`
+ * + ejecuta middlewares) y {@link afterProcess} (emite `afterLog`).
+ *
+ * @example
+ * ```ts
+ * const hooks = new HookManager();
+ *
+ * // Mayor prioridad => corre primero
+ * hooks.on('beforeLog', (entry) => {
+ *   return { ...entry, attributes: { ...entry.attributes, traced: true } };
+ * }, 90);
+ *
+ * hooks.on('afterLog', (entry) => {
+ *   metrics.increment('log_emitted', { level: entry.level });
+ * });
+ *
+ * hooks.on('onError', (entry) => {
+ *   telemetry.capture(entry.error);
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Middleware que añade timestamp si falta y delega al siguiente
+ * hooks.use(async (entry, next) => {
+ *   if (!entry.time) entry.time = Date.now();
+ *   await next();
+ * });
+ * ```
+ *
+ * @see {@link IHookManager}
+ * @see {@link HookEvent}
+ */
+export declare class HookManager implements IHookManager {
+    private hooks;
+    private middlewares;
+    /**
+     * Lleva el conteo de la profundidad de recursión actual por cada evento de
+     * hook, para que las cadenas de `onError` que lanzan excepciones no puedan
+     * loopéar para siempre. Se resetea cuando el `emit` externo retorna.
+     */
+    private _onErrorDepth;
+    constructor();
+    /**
+     * Registra un callback persistente para un evento. Se ejecuta en cada
+     * emisión hasta que se cancele con la función devuelta o con {@link off}.
+     *
+     * Los hooks se ordenan por `priority` **descendente**: mayor número =
+     * se ejecuta primero. Misma prioridad respeta el orden de registro.
+     *
+     * @param event - Uno de `'beforeLog' | 'afterLog' | 'onError'`.
+     * @param callback - Función asíncrona que recibe el {@link HookLogEntry}
+     *   actual y puede retornar un partial para mutar el entry que verán los
+     *   hooks siguientes.
+     * @param priority - Peso de ordenamiento. Default `50`. Mayor = primero.
+     * @returns {() => void} Función de cancelación; llamarla desregistra el hook.
+     *
+     * @example
+     * ```ts
+     * const off = hooks.on('beforeLog', async (entry) => {
+     *   return { attributes: { ...entry.attributes, requestId: getReqId() } };
+     * }, 80);
+     *
+     * // ...en shutdown:
+     * off();
+     * ```
+     *
+     * @see {@link once} para hooks de un solo disparo.
+     * @see {@link off} para desregistro por referencia de callback.
+     */
+    on(event: HookEvent, callback: HookCallback, priority?: number): () => void;
+    /**
+     * Igual que {@link on}, pero el hook se auto-desregistra después del primer
+     * disparo exitoso. Útil para setup one-shot (warm-up de caché, captura del
+     * primer log, ...).
+     *
+     * Si el callback lanza, el hook NO se elimina (la excepción se deriva a
+     * `onError`); la limpieza solo ocurre cuando el callback retorna sin Throw.
+     *
+     * @param event - Evento a escuchar.
+     * @param callback - Handler que se ejecutará una sola vez.
+     * @param priority - Peso de ordenamiento (mayor = primero). Default `50`.
+     * @returns {() => void} Cancelación manual por si se quiere retirar antes
+     *   del primer disparo.
+     *
+     * @example
+     * ```ts
+     * hooks.once('afterLog', async (entry) => {
+     *   console.log('Primer log emitido:', entry.msg);
+     * });
+     * ```
+     *
+     * @see {@link on}
+     */
+    once(event: HookEvent, callback: HookCallback, priority?: number): () => void;
+    /**
+     * Desregistra un hook por referencia de callback. Solo elimina la primera
+     * coincidencia encontrada para el evento.
+     *
+     * Para hooks registrados con {@link on} o {@link once} es preferible usar
+     * la función de cancelación devuelta (que usa el id interno y es O(n) más
+     * directa). `off` es útil cuando se perdió la referencia al cancelador o
+     * cuando se integra con APIs que piden un método `removeListener(cb)`.
+     *
+     * @param event - Evento del que se quiere desregistrar.
+     * @param callback - Misma referencia de función pasada a {@link on}/{@link once}.
+     * @returns {boolean} `true` si se eliminó un hook, `false` si no había match.
+     *
+     * @example
+     * ```ts
+     * const handler = async (entry) => { /* ... *\/ };
+     * hooks.on('afterLog', handler);
+     * hooks.off('afterLog', handler); // true
+     * ```
+     *
+     * @see {@link on}
+     */
+    off(event: HookEvent, callback: HookCallback): boolean;
+    private removeHook;
+    /**
+     * Registra un middleware que se encadena sobre el {@link HookLogEntry}
+     * **antes** de que se emita el log al resto del pipeline. Los middlewares
+     * corren después del evento `beforeLog` y se ejecutan en cascada vía `next()`.
+     *
+     * Cada middleware recibe `(entry, next)` y debe llamar a `next()` para
+     * ceder el control al siguiente. Si NO llama a `next()`, corta la cadena
+     * (patrón short-circuit).
+     *
+     * Ordenamiento: `priority` descendente (mayor = primero), igual que los
+     * hooks. La secuencia respetada es la del sort, no la del orden de
+     * llamada a `use`.
+     *
+     * @param middleware - Función `(entry, next) => Promise<void>`.
+     * @param priority - Peso de ordenamiento. Default `50`.
+     * @returns {() => void} Función de cancelación para retirar el middleware.
+     *
+     * @example
+     * ```ts
+     * // PII redaction: enmascara passwords antes de loguear
+     * hooks.use(async (entry, next) => {
+     *   if (entry.attributes?.password) {
+     *     entry.attributes.password = '***';
+     *   }
+     *   await next();
+     * }, 90);
+     *
+     * // Short-circuit: si es level=debug y env=prod, no baja
+     * const stop = hooks.use(async (entry, next) => {
+     *   if (entry.level === 'debug' && ENV === 'production') return;
+     *   await next();
+     * }, 100);
+     * ```
+     *
+     * @see {@link process} para el orquestador que ejecuta la cadena.
+     */
+    use(middleware: MiddlewareFn, priority?: number): () => void;
+    /**
+     * Emite un evento a todos sus hooks registrados, en orden de prioridad, y
+     * retorna el entry resultante tras aplicar todos los mutations.
+     *
+     * Cada hook puede retornar un partial de {@link HookLogEntry}; ese partial
+     * se mergea sobre el entry actual antes de invocar al siguiente hook, así
+     * los hooks se encadenan como una pipeline de transformaciones.
+     *
+     * Manejo de errores:
+     * - Si un hook de `beforeLog`/`afterLog` lanza, la excepción se captura y
+     *   se re-emite como evento `onError` con el campo `error` poblado.
+     * - Si un hook de `onError` lanza, **NO** se re-emite (rompería el ciclo);
+     *   se loguea a `console.error` y se traga.
+     * - Guard de reentrancia: si `onError` se re-entra más de
+     *   {@link MAX_ONERROR_DEPTH} veces, se corta y se loguea el entry al
+     *   console. Previene loops infinitos por errores en cascada.
+     *
+     * Los hooks marcados como `once` se eliminan tras un disparo exitoso.
+     *
+     * @param event - Evento a emitir.
+     * @param entry - Entry inicial; no se muta in-place (se clona por nivel).
+     * @returns {Promise<HookLogEntry>} Entry transformado tras todos los hooks.
+     *
+     * @example
+     * ```ts
+     * const enriched = await hooks.emit('beforeLog', rawEntry);
+     * // enriched.attributes puede traer merges de varios hooks
+     * ```
+     *
+     * @see {@link on}
+     * @see {@link once}
+     * @see {@link MAX_ONERROR_DEPTH}
+     */
+    emit(event: HookEvent, entry: HookLogEntry): Promise<HookLogEntry>;
+    /**
+     * Orquesta el pipeline pre-emit de un log. Orden de ejecución:
+     *
+     * 1. Emite `beforeLog` (todos sus hooks corren en orden de prioridad y
+     *    pueden mutar el entry vía return partial).
+     * 2. Si hay middlewares registrados ({@link use}), los ejecuta en cascada
+     *    sobre el entry ya enriquecido por los hooks de `beforeLog`.
+     *
+     * Es el punto de entrada que el logger invoca **antes** de despachar el
+     * record a los transports. El entry devuelto es el que finalmente se loguea.
+     *
+     * No emite `afterLog`; para eso usar {@link afterProcess} una vez que el
+     * dispatch al transport haya terminado.
+     *
+     * @param entry - Entry crudo entrante al pipeline.
+     * @returns {Promise<HookLogEntry>} Entry final listo para mandar a transports.
+     *
+     * @example
+     * ```ts
+     * const processed = await hooks.process(rawEntry);
+     * await transport.write(processed);
+     * await hooks.afterProcess(processed);
+     * ```
+     *
+     * @see {@link afterProcess}
+     * @see {@link use}
+     */
+    process(entry: HookLogEntry): Promise<HookLogEntry>;
+    /**
+     * Emite el evento `afterLog` con el entry ya procesado y dispatcheado a
+     * los transports. Pensado para side-effects post-log: métricas, audit
+     * trail, flush de buffers externos, etc.
+     *
+     * Los hooks de `afterLog` pueden retornar un partial pero el entry ya se
+     * ha publicado, así que la mutación no tiene efecto sobre el log emitido;
+     * solo queda disponible en el return de {@link emit}, que aquí se descarta.
+     *
+     * @param entry - Entry final (mismo objeto devuelto por {@link process}).
+     * @returns {Promise<void>} Resuelve cuando todos los hooks terminaron.
+     *
+     * @example
+     * ```ts
+     * hooks.on('afterLog', async (entry) => {
+     *   metrics.increment('logs_total', { level: entry.level });
+     * });
+     *
+     * const processed = await hooks.process(rawEntry);
+     * await transport.write(processed);
+     * await hooks.afterProcess(processed); // dispara métricas
+     * ```
+     *
+     * @see {@link process}
+     */
+    afterProcess(entry: HookLogEntry): Promise<void>;
+    /**
+     * Vacía todos los hooks y middlewares registrados. Útil para resetear el
+     * estado entre tests o en hot-reload.
+     *
+     * Afecta a los tres eventos (`beforeLog`, `afterLog`, `onError`) y a la
+     * pila de middlewares. Las funciones de cancelación devueltas por
+     * {@link on}/{@link once}/{@link use} se vuelven no-ops pero pueden
+     * llamarse sin error.
+     *
+     * @example
+     * ```ts
+     * afterEach(() => hooks.clear());
+     * ```
+     */
+    clear(): void;
+    /**
+     * Snapshot del estado interno para observabilidad y debugging.
+     *
+     * @returns {Object} stats
+     * @returns {Record<HookEvent, number>} stats.hooks - Conteo de hooks
+     *   registrados por evento (`beforeLog`, `afterLog`, `onError`).
+     * @returns {number} stats.middlewares - Total de middlewares activos.
+     *
+     * @example
+     * ```ts
+     * const stats = hooks.getStats();
+     * // { hooks: { beforeLog: 2, afterLog: 1, onError: 3 }, middlewares: 1 }
+     * if (stats.hooks.onError === 0) {
+     *   console.warn('Sin handlers onError registrados');
+     * }
+     * ```
+     */
+    getStats(): {
+        hooks: Record<HookEvent, number>;
+        middlewares: number;
+    };
+}
+/**
+ * Devuelve la instancia singleton de {@link HookManager} compartida por todo
+ * el proceso. La crea perezosamente en la primera llamada.
+ *
+ * Pensada como hook manager por defecto del logger; los consumidores que
+ * necesiten aislamiento (tests, múltiples loggers con pipelines distintos)
+ * deben instanciar su propio `new HookManager()` en lugar de usar este shared.
+ *
+ * @returns {HookManager} La instancia singleton.
+ *
+ * @example
+ * ```ts
+ * import { getDefaultHookManager } from '@mks2508/better-logger/hooks';
+ *
+ * getDefaultHookManager().on('onError', async (entry) => {
+ *   telemetry.capture(entry.error);
+ * });
+ * ```
+ *
+ * @see {@link HookManager}
+ */
+export declare function getDefaultHookManager(): HookManager;
+//# sourceMappingURL=HookManager.d.ts.map

package/dist/hooks/HookManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookManager.d.ts","sourceRoot":"","sources":["../../src/hooks/HookManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,YAAY,EAGZ,YAAY,EACf,MAAM,mBAAmB,CAAC;AA2B3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC5C,OAAO,CAAC,KAAK,CAAiD;IAC9D,OAAO,CAAC,WAAW,CAAgC;IACnD;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAqC;;IAQ1D;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,IAAI;IAgB/E;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,IAAI;IAgBjF;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO;IAYtD,OAAO,CAAC,UAAU;IAUlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,IAAI;IAkBhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAmDxE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBzD;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;;;;;;;;;;;OAaG;IACH,KAAK,IAAI,IAAI;IAKb;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CAUxE;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAKnD"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Hooks subpath barrel.
+ * Exports: HookManager, createHookBridge, HookBridge, on, once, off, use
+ */
+export { HookManager, getDefaultHookManager } from './HookManager.js';
+export { createHookBridge, type HookBridge } from './HookBridge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/hooks-module.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Entry point for ./hooks subpath.
+ * Hook manager: HookManager, createHookBridge, beforeLog, on, once, off, use.
+ */
+export { HookManager, getDefaultHookManager } from './hooks/index.js';
+export { createHookBridge, type HookBridge } from './hooks/index.js';
+//# sourceMappingURL=hooks-module.d.ts.map

package/dist/hooks-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-module.d.ts","sourceRoot":"","sources":["../src/hooks-module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/hooks.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_HookBridge = require("./chunks/HookBridge-C-AvXmPD.cjs");
+exports.HookManager = require_HookBridge.HookManager;
+exports.createHookBridge = require_HookBridge.createHookBridge;
+exports.getDefaultHookManager = require_HookBridge.getDefaultHookManager;

package/dist/hooks.js

@@ -0,0 +1,2 @@
+import { n as HookManager, r as getDefaultHookManager, t as createHookBridge } from "./chunks/HookBridge-CI2PH79S.js";
+export { HookManager, createHookBridge, getDefaultHookManager };