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

package/dist/core.js

@@ -1,317 +1,291 @@
-/**
- * @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
-        };
+import { D as DEFAULT_CONFIG, a as isBrowser, p as parseStackTrace, s as supportsCSSColors, c as createStyledOutput, L as LEVEL_STYLES, i as isNode } from "./chunks/environment-wXLQvk5g.js";
+import { o as getConsoleMethod, c as createOutput, p as createLogEntry, q as formatTablePlain, r as createPlainOutput } from "./chunks/formatting-DIhpRCCk.js";
+class CoreLogger {
+  config;
+  scopedPrefix;
+  handlers = [];
+  timers = /* @__PURE__ */ 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,
+      outputFormat: config.outputFormat ?? "auto"
+    };
+  }
+  // ===== 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(":") : void 0;
+  }
+  /**
+   * 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);
+    if (isBrowser && this.config.enableColors && supportsCSSColors()) {
+      try {
+        const [format, ...styles] = createStyledOutput(
+          level,
+          LEVEL_STYLES,
+          prefix,
+          message,
+          stackInfo,
+          this.config.autoDetectTheme
+        );
+        console[consoleMethod](format, ...styles, ...args.slice(1));
+      } catch (error2) {
+        const output = createOutput(level, message, prefix, stackInfo, this.config.outputFormat);
+        console[consoleMethod](output, ...args.slice(1));
+      }
+    } else {
+      const groupIndent = "  ".repeat(this.groupDepth);
+      const output = groupIndent + createOutput(level, message, prefix, stackInfo, this.config.outputFormat);
+      console[consoleMethod](output, ...args.slice(1));
     }
-    // ===== CONFIGURATION METHODS =====
-    /**
-     * Get current configuration
-     */
-    getConfig() {
-        return { ...this.config };
+    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 (error2) {
+        console.error("Log handler failed:", error2);
+      }
+    });
+  }
+  /**
+   * 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);
     }
-    /**
-     * Sets the global prefix for all log messages
-     */
-    setGlobalPrefix(prefix) {
-        this.config.globalPrefix = prefix;
+  }
+  // ===== 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") {
+      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);
     }
-    /**
-     * Sets the verbosity level for filtering log output
-     */
-    setVerbosity(level) {
-        this.config.verbosity = level;
+  }
+  /**
+   * 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) {
+      if (collapsed) {
+        console.groupCollapsed(fullLabel);
+      } else {
+        console.group(fullLabel);
+      }
+    } else {
+      const groupStart = "┌─ " + fullLabel;
+      console.log(groupStart);
     }
-    /**
-     * 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;
+    this.groupDepth++;
+  }
+  /**
+   * Ends the current console group
+   */
+  groupEnd() {
+    if (this.groupDepth > 0) {
+      if (isBrowser && console.groupEnd) {
+        console.groupEnd();
+      } else {
+        const groupEnd2 = "└─ (end group)";
+        console.log(groupEnd2);
+      }
+      this.groupDepth--;
     }
-    /**
-     * Adds a custom log handler for extensibility
-     */
-    addHandler(handler) {
-        this.handlers.push(handler);
+  }
+  /**
+   * 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;
     }
-    // ===== 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];
+    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();
     }
-    /**
-     * 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();
+    if (isNode && process.hrtime) {
+      const [seconds, nanoseconds] = process.hrtime();
+      return seconds * 1e3 + nanoseconds / 1e6;
     }
+    return Date.now();
+  }
 }
-// Create and export singleton instance for convenience
 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;
+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);
+export {
+  CoreLogger,
+  addHandler,
+  critical,
+  debug,
+  coreLogger as default,
+  error,
+  group,
+  groupEnd,
+  info,
+  scope,
+  setGlobalPrefix,
+  setVerbosity,
+  table,
+  time,
+  timeEnd,
+  trace,
+  warn
+};
+//# sourceMappingURL=core.js.map