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

package/dist/core.js

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