@mks2508/better-logger 5.0.0 → 5.0.2

package/src/constants.ts

@@ -1,313 +0,0 @@
-/**
- * @fileoverview Global constants for Advanced Logger
- */
-
-import type { LogLevel, AdaptiveColors, CLILogLevel, Verbosity } from './types/index.js';
-import type { LevelStyleConfig } from './utils/index.js';
-
-/**
- * Default configuration values
- */
-export const DEFAULT_CONFIG = {
-    verbosity: 'info' as const,
-    enableColors: true,
-    enableTimestamps: true,
-    enableStackTrace: true,
-    theme: 'default' as const,
-    bannerType: 'simple' as const,
-    bufferSize: 1000,
-    autoDetectTheme: true,
-    outputFormat: 'auto' as const,
-} as const;
-
-/**
- * Basic level styles for core module (minimal CSS styling)
- */
-export const LEVEL_STYLES: Record<LogLevel | 'success', LevelStyleConfig> = {
-    debug: {
-        emoji: '🔍',
-        label: 'DEBUG',
-        background: 'linear-gradient(90deg, #6c757d, #495057)',
-        color: '#ffffff',
-        border: '1px solid #6c757d',
-        shadow: '0 2px 4px rgba(108, 117, 125, 0.3)'
-    },
-    info: {
-        emoji: 'ℹ️',
-        label: 'INFO',
-        background: 'linear-gradient(90deg, #007bff, #0056b3)',
-        color: '#ffffff',
-        border: '1px solid #007bff',
-        shadow: '0 2px 4px rgba(0, 123, 255, 0.3)'
-    },
-    warn: {
-        emoji: '⚠️',
-        label: 'WARN',
-        background: 'linear-gradient(90deg, #ffc107, #e0a800)',
-        color: '#000000',
-        border: '1px solid #ffc107',
-        shadow: '0 2px 4px rgba(255, 193, 7, 0.3)'
-    },
-    error: {
-        emoji: '❌',
-        label: 'ERROR',
-        background: 'linear-gradient(90deg, #dc3545, #c82333)',
-        color: '#ffffff',
-        border: '1px solid #dc3545',
-        shadow: '0 2px 4px rgba(220, 53, 69, 0.3)'
-    },
-    critical: {
-        emoji: '🚨',
-        label: 'CRITICAL',
-        background: 'linear-gradient(90deg, #8B0000, #FF0000)',
-        color: '#ffffff',
-        border: '2px solid #FF0000',
-        shadow: '0 4px 8px rgba(255, 0, 0, 0.4)'
-    },
-    success: {
-        emoji: '✅',
-        label: 'SUCCESS',
-        background: 'linear-gradient(90deg, #28a745, #1e7e34)',
-        color: '#ffffff',
-        border: '1px solid #28a745',
-        shadow: '0 2px 4px rgba(40, 167, 69, 0.3)'
-    }
-} as const;
-
-/**
- * Maximum allowed buffer sizes for performance
- */
-export const BUFFER_LIMITS = {
-    MIN_SIZE: 50,
-    DEFAULT_SIZE: 1000,
-    MAX_SIZE: 10000,
-} as const;
-
-/**
- * Export format definitions with extensions
- */
-export const EXPORT_FORMATS = {
-    json: { extension: '.json', mimeType: 'application/json' },
-    csv: { extension: '.csv', mimeType: 'text/csv' },
-    markdown: { extension: '.md', mimeType: 'text/markdown' },
-    plain: { extension: '.txt', mimeType: 'text/plain' },
-    html: { extension: '.html', mimeType: 'text/html' },
-} as const;
-
-/**
- * CLI command definitions
- */
-export const CLI_COMMANDS = {
-    config: 'config',
-    help: 'help',
-    themes: 'themes',
-    banners: 'banners',
-    banner: 'banner',
-    status: 'status',
-    reset: 'reset',
-    demo: 'demo',
-    export: 'export',
-    copy: 'copy',
-    'buffer-size': 'buffer-size',
-    'clear-buffer': 'clear-buffer',
-    'buffer-info': 'buffer-info',
-} as const;
-
-/**
- * Time parsing constants for relative time filters
- */
-export const TIME_UNITS = {
-    ms: 1,
-    s: 1000,
-    m: 60 * 1000,
-    h: 60 * 60 * 1000,
-    d: 24 * 60 * 60 * 1000,
-} as const;
-
-/**
- * Default styling values
- */
-export const STYLE_DEFAULTS = {
-    FONT_FAMILY: 'Monaco, Consolas, monospace',
-    FONT_SIZE: '12px',
-    BORDER_RADIUS: '4px',
-    PADDING: '4px 8px',
-} as const;
-
-/**
- * Level priority mapping for filtering
- */
-export const LEVEL_PRIORITIES: Record<LogLevel, number> = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
-    critical: 4,
-} as const;
-
-/**
- * Adaptive color configurations for DevTools theme compatibility
- */
-export const ADAPTIVE_COLORS = {
-    timestamp: {
-        light: '#666666',
-        dark: '#a0a0a0',
-    },
-    messageText: {
-        light: '#2d3748',
-        dark: '#f7fafc',
-    },
-    prefix: {
-        light: '#2d3748',
-        dark: '#e2e8f0',
-    },
-    prefixBackground: {
-        light: '#2d3748',
-        dark: '#4a5568',
-    },
-    location: {
-        light: '#718096',
-        dark: '#a0aec0',
-    },
-} as const satisfies Record<string, AdaptiveColors>;
-
-/**
- * Presets específicos para diferentes entornos de build
- */
-export const BUILD_PRESETS = {
-    /**
-     * Configuración optimizada para Next.js builds
-     */
-    nextjs: {
-        verbosity: 'info' as const,
-        enableColors: true,
-        enableTimestamps: false,
-        enableStackTrace: false,
-        autoDetectTheme: false,
-        outputFormat: 'build' as const,
-    },
-
-    /**
-     * Configuración para Webpack builds
-     */
-    webpack: {
-        verbosity: 'info' as const,
-        enableColors: true,
-        enableTimestamps: true,
-        enableStackTrace: false,
-        autoDetectTheme: false,
-        outputFormat: 'build' as const,
-    },
-
-    /**
-     * Configuración para CI/CD environments
-     */
-    ci: {
-        verbosity: 'info' as const,
-        enableColors: false,
-        enableTimestamps: true,
-        enableStackTrace: true,
-        autoDetectTheme: false,
-        outputFormat: 'ci' as const,
-    },
-
-    /**
-     * Configuración para desarrollo terminal
-     */
-    terminal: {
-        verbosity: 'debug' as const,
-        enableColors: true,
-        enableTimestamps: true,
-        enableStackTrace: true,
-        autoDetectTheme: false,
-        outputFormat: 'ansi' as const,
-    }
-} as const;
-
-/**
- * Mapeo de variables de entorno a presets
- */
-export const ENVIRONMENT_DETECTION = {
-    // Next.js detection
-    isNextJS: typeof process !== 'undefined' && (
-        process.env.NEXT_RUNTIME ||
-        process.env.NEXT_PUBLIC_VERCEL_ENV ||
-        (process.argv && process.argv.some(arg => arg.includes('next')))
-    ),
-
-    // Webpack detection
-    isWebpack: typeof process !== 'undefined' && (
-        process.env.WEBPACK_ENV ||
-        process.env.WEBPACK_BUILD ||
-        (process.argv && process.argv.some(arg => arg.includes('webpack')))
-    ),
-
-    // CI/CD detection
-    isCI: typeof process !== 'undefined' && (
-        process.env.CI ||
-        process.env.GITHUB_ACTIONS ||
-        process.env.JENKINS_URL ||
-        process.env.GITLAB_CI ||
-        process.env.TRAVIS ||
-        process.env.CIRCLECI
-    ),
-
-    // Build detection
-    isBuild: typeof process !== 'undefined' && (
-        process.env.NODE_ENV === 'production' ||
-        process.env.BUILD_MODE === 'production' ||
-        (process.argv && process.argv.some(arg => arg.includes('build')))
-    ),
-
-    // Terminal with ANSI support
-    isTerminal: typeof process !== 'undefined' && (
-        process.stdout?.isTTY === true &&
-        process.env.TERM !== 'dumb'
-    )
-} as const;
-
-/**
- * Auto-detects the best preset based on current environment
- */
-export function detectEnvironmentPreset(): keyof typeof BUILD_PRESETS {
-    if (ENVIRONMENT_DETECTION.isCI) {
-        return 'ci';
-    }
-
-    if (ENVIRONMENT_DETECTION.isNextJS) {
-        return 'nextjs';
-    }
-
-    if (ENVIRONMENT_DETECTION.isWebpack) {
-        return 'webpack';
-    }
-
-    if (ENVIRONMENT_DETECTION.isTerminal) {
-        return 'terminal';
-    }
-
-    return 'terminal'; // Default fallback
-}
-
-/**
- * Gets the optimal configuration for current environment
- */
-export function getOptimalConfig() {
-    const preset = detectEnvironmentPreset();
-    return {
-        ...DEFAULT_CONFIG,
-        ...BUILD_PRESETS[preset]
-    };
-}
-
-/**
- * CLI log level to internal verbosity mapping
- * @since 5.0.0
- */
-export const CLI_LEVEL_MAP: Record<CLILogLevel, { verbosity: Verbosity; showPrimitives: boolean }> = {
-    silent:  { verbosity: 'silent',  showPrimitives: false },
-    quiet:   { verbosity: 'error',   showPrimitives: false },
-    normal:  { verbosity: 'info',    showPrimitives: true  },
-    verbose: { verbosity: 'debug',   showPrimitives: true  },
-    debug:   { verbosity: 'debug',   showPrimitives: true  },
-} as const;

package/src/core.ts

@@ -1,397 +0,0 @@
-/**
- * @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 types
-import type {
-    LogLevel,
-    Verbosity,
-    LoggerConfig,
-    ILogHandler,
-    LogMetadata,
-    TimerEntry
-} from './types/index.js';
-
-// Core utilities
-import {
-    parseStackTrace,
-    formatTimestamp
-} from './utils/index.js';
-
-// Universal formatting and environment detection
-import {
-    createPlainOutput,
-    createOutput,
-    getConsoleMethod,
-    createLogEntry,
-    formatTablePlain,
-    safeSerialize,
-    detectOptimalFormat,
-    type OutputFormat
-} from './utils/formatting.js';
-
-import {
-    isBrowser,
-    isNode,
-    getRuntimeEnvironment,
-    supportsColors,
-    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 {
-    private config: LoggerConfig;
-    private scopedPrefix?: string;
-    private handlers: ILogHandler[] = [];
-    private timers: Map<string, TimerEntry> = new Map();
-    private groupDepth: number = 0;
-
-    /**
-     * Creates a new CoreLogger instance
-     * @param config - Optional configuration
-     */
-    constructor(config: Partial<LoggerConfig> = {}) {
-        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(): LoggerConfig {
-        return { ...this.config };
-    }
-
-    /**
-     * Sets the global prefix for all log messages
-     */
-    setGlobalPrefix(prefix: string): void {
-        this.config.globalPrefix = prefix;
-    }
-
-    /**
-     * Sets the verbosity level for filtering log output
-     */
-    setVerbosity(level: Verbosity): void {
-        this.config.verbosity = level;
-    }
-
-    /**
-     * Creates a scoped logger with a specific prefix
-     */
-    scope(prefix: string): CoreLogger {
-        const scopedLogger = new CoreLogger(this.config);
-        scopedLogger.scopedPrefix = prefix;
-        scopedLogger.handlers = [...this.handlers];
-        return scopedLogger;
-    }
-
-    /**
-     * Adds a custom log handler for extensibility
-     */
-    addHandler(handler: ILogHandler): void {
-        this.handlers.push(handler);
-    }
-
-    // ===== CORE LOGGING METHODS =====
-
-    /**
-     * Checks if a log level should be output based on current verbosity
-     */
-    private shouldLog(level: LogLevel): boolean {
-        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)
-     */
-    private getEffectivePrefix(): string | undefined {
-        const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);
-        return parts.length > 0 ? parts.join(':') : undefined;
-    }
-
-    /**
-     * Core logging method with universal formatting
-     */
-    private log(level: LogLevel, ...args: any[]): void {
-        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 universal formatting if CSS fails
-                const output = createOutput(level, message, prefix, stackInfo, this.config.outputFormat);
-                console[consoleMethod](output, ...args.slice(1));
-            }
-        } else {
-            // Node.js or browser without colors - use universal formatting
-            const groupIndent = '  '.repeat(this.groupDepth);
-            const output = groupIndent + createOutput(level, message, prefix, stackInfo, this.config.outputFormat);
-            console[consoleMethod](output, ...args.slice(1));
-        }
-
-        // Call custom handlers with structured metadata
-        const logEntry = createLogEntry(level, message, args, prefix, stackInfo);
-        const metadata: LogMetadata = {
-            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: any[]): void {
-        this.log('debug', ...args);
-    }
-
-    /**
-     * Logs informational messages
-     */
-    info(...args: any[]): void {
-        this.log('info', ...args);
-    }
-
-    /**
-     * Logs warning messages
-     */
-    warn(...args: any[]): void {
-        this.log('warn', ...args);
-    }
-
-    /**
-     * Logs error messages
-     */
-    error(...args: any[]): void {
-        this.log('error', ...args);
-    }
-
-    /**
-     * Logs critical errors (highest priority)
-     */
-    critical(...args: any[]): void {
-        this.log('critical', ...args);
-    }
-
-    /**
-     * Logs trace information (detailed debugging)
-     */
-    trace(...args: any[]): void {
-        this.log('debug', ...args);
-        if (this.shouldLog('debug')) {
-            console.trace(...args);
-        }
-    }
-
-    // ===== BASIC ADVANCED FEATURES =====
-
-    /**
-     * Displays data in a table format
-     */
-    table(data: any, columns?: string[]): void {
-        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: string, collapsed: boolean = false): void {
-        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(): void {
-        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: string): void {
-        const startTime = this.getPerformanceNow();
-        const timer: TimerEntry = {
-            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: string): void {
-        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
-     */
-    private getPerformanceNow(): number {
-        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
-const coreLogger = new CoreLogger();
-
-/**
- * Export individual methods for convenience (with proper binding)
- */
-export const debug = (...args: any[]) => coreLogger.debug(...args);
-export const info = (...args: any[]) => coreLogger.info(...args);
-export const warn = (...args: any[]) => coreLogger.warn(...args);
-export const error = (...args: any[]) => coreLogger.error(...args);
-export const critical = (...args: any[]) => coreLogger.critical(...args);
-export const trace = (...args: any[]) => coreLogger.trace(...args);
-export const table = (data: any, columns?: string[]) => coreLogger.table(data, columns);
-export const group = (label: string, collapsed?: boolean) => coreLogger.group(label, collapsed);
-export const groupEnd = () => coreLogger.groupEnd();
-export const time = (label: string) => coreLogger.time(label);
-export const timeEnd = (label: string) => coreLogger.timeEnd(label);
-export const setGlobalPrefix = (prefix: string) => coreLogger.setGlobalPrefix(prefix);
-export const scope = (prefix: string) => coreLogger.scope(prefix);
-export const setVerbosity = (level: Verbosity) => coreLogger.setVerbosity(level);
-export const addHandler = (handler: ILogHandler) => coreLogger.addHandler(handler);
-
-// Export the singleton as default
-export default coreLogger;
-
-// Re-export core types
-export type {
-    LogLevel,
-    Verbosity,
-    LoggerConfig,
-    ILogHandler,
-    LogMetadata
-} from './types/index.js';