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

package/src/handlers/FileLogHandler.ts

@@ -1,169 +0,0 @@
-/**
- * @fileoverview File-based log handler for Advanced Logger
- */
-
-import type { ILogHandler, LogLevel, LogMetadata } from '../types/index.js';
-import { isNode, isBrowser } from '../utils/environment.js';
-import { safeSerialize } from '../utils/formatting.js';
-
-/**
- * Universal file-based log handler for persistent logging
- * Works in both Node.js (real files) and browser (localStorage)
- */
-export class FileLogHandler implements ILogHandler {
-    private filename: string;
-    private maxSize?: number;
-    private fs?: any; // Node.js fs module
-
-    constructor(filename: string = 'app.log', maxSize?: number) {
-        this.filename = filename;
-        this.maxSize = maxSize;
-        
-        // Load Node.js fs module if in Node environment
-        if (isNode) {
-            try {
-                this.fs = require('fs');
-            } catch (error) {
-                console.warn('FileLogHandler: Unable to load fs module:', error);
-            }
-        }
-    }
-
-    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void {
-        const logEntry = {
-            timestamp: metadata.timestamp,
-            level: level.toUpperCase(),
-            prefix: metadata.prefix,
-            message,
-            args: args.slice(1).map(arg => safeSerialize(arg)),
-            location: metadata.stackInfo,
-        };
-
-        const logLine = this.formatLogLine(logEntry);
-
-        if (isNode && this.fs) {
-            this.writeToFileNode(logLine);
-        } else if (isBrowser) {
-            this.writeToFileLocal(logLine);
-        } else {
-            // Fallback - just console output
-            console.log(`[FILE-LOG] ${logLine}`);
-        }
-    }
-
-    /**
-     * Format log entry as a single line for file storage
-     */
-    private formatLogLine(entry: any): string {
-        const parts = [
-            entry.timestamp,
-            `[${entry.level}]`,
-            entry.prefix ? `[${entry.prefix}]` : '',
-            entry.message
-        ].filter(Boolean);
-
-        let line = parts.join(' ');
-        
-        if (entry.args && entry.args.length > 0) {
-            line += ' ' + entry.args.map((arg: any) => 
-                typeof arg === 'object' ? JSON.stringify(arg) : String(arg)
-            ).join(' ');
-        }
-        
-        if (entry.location) {
-            line += ` (${entry.location.file}:${entry.location.line}:${entry.location.column})`;
-        }
-        
-        return line;
-    }
-
-    /**
-     * Write to actual file in Node.js environment
-     */
-    private writeToFileNode(logLine: string): void {
-        if (!this.fs) return;
-
-        try {
-            // Check file size if maxSize is set
-            if (this.maxSize) {
-                try {
-                    const stats = this.fs.statSync(this.filename);
-                    if (stats.size > this.maxSize) {
-                        // Simple rotation: backup current file and start fresh
-                        const backupName = `${this.filename}.bak`;
-                        this.fs.renameSync(this.filename, backupName);
-                    }
-                } catch (error) {
-                    // File doesn't exist yet, that's fine
-                }
-            }
-
-            // Append to file
-            this.fs.appendFileSync(this.filename, logLine + '\n', 'utf8');
-        } catch (error) {
-            console.error('FileLogHandler: Failed to write to file:', error);
-        }
-    }
-
-    /**
-     * Write to localStorage in browser environment
-     */
-    private writeToFileLocal(logLine: string): void {
-        try {
-            const storageKey = `logger_${this.filename}`;
-            const existingLogs = localStorage.getItem(storageKey) || '';
-            
-            let newLogs = existingLogs;
-            if (existingLogs.length > 0) {
-                newLogs += '\n';
-            }
-            newLogs += logLine;
-            
-            // Simple size management - keep last 1000 lines max
-            if (this.maxSize || newLogs.split('\n').length > 1000) {
-                const lines = newLogs.split('\n');
-                const maxLines = this.maxSize ? Math.floor(this.maxSize / 100) : 1000;
-                if (lines.length > maxLines) {
-                    newLogs = lines.slice(-maxLines).join('\n');
-                }
-            }
-            
-            localStorage.setItem(storageKey, newLogs);
-        } catch (error) {
-            console.error('FileLogHandler: Failed to write to localStorage:', error);
-        }
-    }
-
-    /**
-     * Get stored logs (useful for debugging)
-     */
-    getLogs(): string | null {
-        if (isNode && this.fs) {
-            try {
-                return this.fs.readFileSync(this.filename, 'utf8');
-            } catch (error) {
-                return null;
-            }
-        } else if (isBrowser) {
-            const storageKey = `logger_${this.filename}`;
-            return localStorage.getItem(storageKey);
-        }
-        return null;
-    }
-
-    /**
-     * Clear stored logs
-     */
-    clearLogs(): void {
-        if (isNode && this.fs) {
-            try {
-                this.fs.writeFileSync(this.filename, '', 'utf8');
-            } catch (error) {
-                console.error('FileLogHandler: Failed to clear file:', error);
-            }
-        } else if (isBrowser) {
-            const storageKey = `logger_${this.filename}`;
-            localStorage.removeItem(storageKey);
-        }
-    }
-}

package/src/handlers/RemoteLogHandler.ts

@@ -1,42 +0,0 @@
-/**
- * @fileoverview Remote log handler for Advanced Logger
- */
-
-import type { ILogHandler, LogLevel, LogMetadata } from '../types/index.js';
-
-/**
- * Remote log handler for sending logs to external services
- */
-export class RemoteLogHandler implements ILogHandler {
-    private endpoint: string;
-    private apiKey?: string;
-
-    constructor(endpoint: string, apiKey?: string) {
-        this.endpoint = endpoint;
-        this.apiKey = apiKey;
-    }
-
-    async handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): Promise<void> {
-        try {
-            const payload = {
-                timestamp: metadata.timestamp,
-                level,
-                message,
-                prefix: metadata.prefix,
-                location: metadata.stackInfo,
-                additional: args.slice(1),
-            };
-
-            await fetch(this.endpoint, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    ...(this.apiKey && { 'Authorization': `Bearer ${this.apiKey}` }),
-                },
-                body: JSON.stringify(payload),
-            });
-        } catch (error) {
-            // Silently fail to avoid infinite logging loops
-        }
-    }
-}

package/src/handlers/index.ts

@@ -1,8 +0,0 @@
-/**
- * @fileoverview Log handlers exports for Advanced Logger
- */
-
-export { FileLogHandler } from './FileLogHandler.js';
-export { RemoteLogHandler } from './RemoteLogHandler.js';
-export { AnalyticsLogHandler } from './AnalyticsLogHandler.js';
-export { ExportLogHandler } from './ExportLogHandler.js';

package/src/index.ts

@@ -1,209 +0,0 @@
-/**
- * @fileoverview Better Logger - Librería completa con todas las características
- * @version 0.3.0
- * @since 2024
- * 
- * Punto de entrada principal que proporciona la experiencia completa de Better Logger
- * con características avanzadas incluyendo estilos CSS, soporte SVG, animaciones,
- * capacidades de exportación y logging remoto.
- * 
- * @module @mks2508/better-logger
- */
-
-// Main Logger class with all features
-import { Logger } from './Logger.js';
-import type {
-    LogLevel,
-    Verbosity,
-    ThemeVariant,
-    BannerType,
-    StyleOptions,
-    ILogHandler
-} from './types/index.js';
-
-// Create singleton instance with all features enabled
-const logger = new Logger();
-
-/**
- * Clase principal Logger con conjunto completo de características
- * 
- * @example
- * // Importación y uso básico
- * import { Logger } from '@mks2508/better-logger';
- * 
- * const logger = new Logger();
- * logger.preset('cyberpunk');  // Aplicar preset completo
- * logger.info('¡Hola mundo!');
- * 
- * @example
- * // Logger con scope para componentes
- * const auth = logger.component('Auth');
- * auth.info('Usuario autenticando...');
- * auth.success('Login exitoso');
- * 
- * @example
- * // Logger para APIs con badges
- * const api = logger.api('GraphQL');
- * api.badges(['v2', 'cached']).info('Query ejecutada');
- * 
- * @since 0.3.0
- */
-export { Logger };
-
-/**
- * Instancia singleton del logger lista para usar
- * @default
- * 
- * @example
- * // Uso directo sin crear instancia
- * import logger from '@mks2508/better-logger';
- * 
- * logger.info('Aplicación iniciada');
- * logger.success('Conexión establecida');
- * logger.warn('Memoria al 80%');
- * logger.error('Fallo en conexión');
- */
-export default logger;
-
-/**
- * Métodos de logging individuales (enlazados al singleton)
- * 
- * @example
- * // Importar solo los métodos necesarios
- * import { info, error, success } from '@mks2508/better-logger';
- * 
- * info('Proceso iniciado');
- * success('✓ Completado exitosamente');
- * error('Error:', errorDetails);
- * 
- * @since 0.3.0
- */
-export const debug = (...args: any[]) => logger.debug(...args);
-export const info = (...args: any[]) => logger.info(...args);
-export const warn = (...args: any[]) => logger.warn(...args);
-export const error = (...args: any[]) => logger.error(...args);
-export const success = (...args: any[]) => logger.success(...args);
-export const critical = (...args: any[]) => logger.critical(...args);
-export const trace = (...args: any[]) => logger.trace(...args);
-export const table = (data: any, columns?: string[]) => logger.table(data, columns);
-export const group = (label: string, collapsed?: boolean) => logger.group(label, collapsed);
-export const groupEnd = () => logger.groupEnd();
-export const time = (label: string) => logger.time(label);
-export const timeEnd = (label: string) => logger.timeEnd(label);
-export const setGlobalPrefix = (prefix: string) => logger.setGlobalPrefix(prefix);
-export const scope = (prefix: string) => logger.scope(prefix);
-export const setVerbosity = (level: Verbosity) => logger.setVerbosity(level);
-export const addHandler = (handler: ILogHandler) => logger.addHandler(handler);
-export const setTheme = (theme: ThemeVariant) => logger.setTheme(theme);
-export const setBannerType = (bannerType: BannerType) => logger.setBannerType(bannerType);
-export const showBanner = (bannerType?: BannerType) => logger.showBanner(bannerType);
-export const logWithSVG = (message: string, svgContent?: string, options?: StyleOptions) => 
-    logger.logWithSVG(message, svgContent, options);
-export const logAnimated = (message: string, duration?: number) => 
-    logger.logAnimated(message, duration);
-export const cli = (command: string) => logger.cli(command);
-
-// Type exports
-export type {
-    LogLevel,
-    Verbosity,
-    ThemeVariant,
-    BannerType,
-    StyleOptions,
-    ILogHandler,
-    LoggerConfig,
-    LogMetadata,
-    StackInfo,
-    TimerEntry
-} from './types/index.js';
-
-// Styling utilities
-export { 
-    StyleBuilder,
-    StylePresets,
-    THEME_PRESETS,
-    THEME_BANNERS,
-    BANNER_VARIANTS
-} from './styling/index.js';
-
-// Handler exports
-export {
-    FileLogHandler,
-    RemoteLogHandler,
-    AnalyticsLogHandler
-} from './handlers/index.js';
-
-// Constants
-export { DEFAULT_CONFIG } from './constants.js';
-
-// Utility exports
-export {
-    parseStackTrace,
-    formatTimestamp
-} from './utils/index.js';
-
-/**
- * Utilidades de estilo para crear estilos personalizados de consola
- * 
- * @example
- * // Crear estilo personalizado
- * import { createStyle, stylePresets } from '@mks2508/better-logger';
- * 
- * const miEstilo = createStyle()
- *   .bg('linear-gradient(45deg, #ff6b6b, #feca57)')
- *   .color('white')
- *   .padding('10px')
- *   .rounded('8px')
- *   .bold()
- *   .build();
- * 
- * console.log('%cMensaje estilizado', miEstilo);
- * 
- * @example
- * // Usar presets predefinidos
- * console.log('%cÉxito!', stylePresets.success);
- * console.log('%cError!', stylePresets.error);
- * 
- * @since 0.3.0
- */
-import { StyleBuilder, StylePresets } from './styling/index.js';
-
-/**
- * Crea una nueva instancia de StyleBuilder para estilos personalizados de consola
- * 
- * @returns {StyleBuilder} Constructor de estilos encadenable
- * 
- * @example
- * const estilo = createStyle()
- *   .gradient('#667eea', '#764ba2')
- *   .color('white')
- *   .padding('8px 16px')
- *   .rounded('4px')
- *   .shadow('0 2px 4px rgba(0,0,0,0.2)')
- *   .build();
- * 
- * @since 0.3.0
- */
-export const createStyle = () => new StyleBuilder();
-
-/**
- * Presets de estilo predefinidos para casos de uso comunes
- * 
- * @constant {Object} stylePresets
- * 
- * @example
- * console.log('%cOperación exitosa', stylePresets.success);
- * console.log('%cAdvertencia', stylePresets.warning);
- * console.log('%cError crítico', stylePresets.error);
- * console.log('%cInformación', stylePresets.info);
- * console.log('%cDestacado', stylePresets.accent);
- * 
- * @since 0.3.0
- */
-export const stylePresets = {
-    success: StylePresets.success().build(),
-    error: StylePresets.error().build(),
-    warning: StylePresets.warning().build(),
-    info: StylePresets.info().build(),
-    accent: StylePresets.accent().build(),
-};

package/src/main.ts

@@ -1,196 +0,0 @@
-import {
-  debug,
-  info,
-  warn,
-  error,
-  success,
-  critical,
-  table,
-  group,
-  groupEnd,
-  time,
-  timeEnd,
-  trace,
-  scope,
-  cli,
-  setTheme,
-  setBannerType,
-  showBanner,
-  logWithSVG,
-  logAnimated,
-  createStyle,
-  stylePresets
-} from './index.js';
-
-import {
-  demonstrateBanners,
-  demonstrateThemes,
-  demonstrateSVG,
-  demonstrateAnimations,
-  demonstrateCLI,
-  demonstrateExports,
-  demonstrateAllFeatures as demoAllFeatures
-} from './example.js';
-
-console.log('%cBetter Logger Demo Ready! 🚀', 
-  'background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); color: white; padding: 10px 20px; border-radius: 8px; font-weight: bold; font-size: 14px;');
-  
-console.log('📋 Available test functions: testDebug(), testBanners(), testThemes(), and more!');
-console.log('💻 CLI Available: cli("/help") for commands');
-
-function testDebug() {
-  debug("This is a debug message.", { user: "test", id: 123 });
-}
-
-function testInfo() {
-  info("This is an info message with an object.", { data: "payload" });
-}
-
-function testWarn() {
-  warn("This is a warning message about a deprecated API.");
-}
-
-function testError() {
-  error("This is an error message.", new Error("Failed to fetch resource."));
-}
-
-function testSuccess() {
-  success("Operation completed successfully.");
-}
-
-function testCritical() {
-  critical("This is a CRITICAL message. System integrity compromised!");
-}
-
-function testTable() {
-  table([
-    { feature: "Debug Log", status: "Implemented", priority: "Low" },
-    { feature: "Info Log", status: "Implemented", priority: "Medium" },
-    { feature: "Warning Log", status: "Implemented", priority: "High" },
-  ]);
-}
-
-function testGrouping() {
-  group("User Authentication Flow", true); // Start collapsed
-  info("User 'testuser' attempting to log in...");
-  warn("Password nearing expiration.");
-  success("Login successful.");
-  groupEnd();
-}
-
-function testTiming() {
-  time("dataProcessing");
-  setTimeout(() => {
-    timeEnd("dataProcessing");
-  }, 750); // Simulate a 750ms operation
-}
-
-function testScopedLogger() {
-  info("Demonstrating scoped loggers...");
-  const apiLogger = scope("API");
-  apiLogger.info("Fetching user data...");
-  const uiLogger = scope("UI");
-  uiLogger.debug("Rendering user profile component.");
-  apiLogger.success("User data fetched successfully.");
-  apiLogger.error("Failed to update settings.");
-}
-
-function testTrace() {
-  function innerFunction() {
-    function deepFunction() {
-        trace("Trace from a deeply nested function.");
-    }
-    deepFunction();
-  }
-  innerFunction();
-}
-
-// Visual feature tests
-function testBanners() {
-  demonstrateBanners();
-}
-
-function testThemes() {
-  demonstrateThemes();
-}
-
-function testSVG() {
-  demonstrateSVG();
-}
-
-function testAnimations() {
-  demonstrateAnimations();
-}
-
-function testCLI() {
-  demonstrateCLI();
-}
-
-function testExports() {
-  demonstrateExports();
-}
-
-function testAllFeatures() {
-  group("🌟 Demonstrating Core Logger Features");
-  testDebug();
-  testInfo();
-  testWarn();
-  testError();
-  testSuccess();
-  testCritical();
-  testTable();
-  testGrouping();
-  testTiming();
-  testScopedLogger();
-  testTrace();
-  groupEnd();
-  
-  setTimeout(() => {
-    info('🎨 Running visual features demo...');
-    demoAllFeatures();
-  }, 2000);
-}
-
-// Expose functions to global scope for onclick attributes in index.html
-if (typeof window !== 'undefined') {
-  // Core logging tests
-  (window as any).testDebug = testDebug;
-  (window as any).testInfo = testInfo;
-  (window as any).testWarn = testWarn;
-  (window as any).testError = testError;
-  (window as any).testSuccess = testSuccess;
-  (window as any).testCritical = testCritical;
-  (window as any).testTable = testTable;
-  (window as any).testGrouping = testGrouping;
-  (window as any).testTiming = testTiming;
-  (window as any).testScopedLogger = testScopedLogger;
-  (window as any).testTrace = testTrace;
-  (window as any).testAllFeatures = testAllFeatures;
-  
-  // Visual feature tests  
-  (window as any).testBanners = testBanners;
-  (window as any).testThemes = testThemes;
-  (window as any).testSVG = testSVG;
-  (window as any).testAnimations = testAnimations;
-  (window as any).testCLI = testCLI;
-  (window as any).testExports = testExports;
-  
-  // Direct access to library functions
-  (window as any).cli = cli;
-  (window as any).setTheme = setTheme;
-  (window as any).setBannerType = setBannerType;
-  (window as any).showBanner = showBanner;
-  (window as any).logWithSVG = logWithSVG;
-  (window as any).logAnimated = logAnimated;
-  (window as any).createStyle = createStyle;
-  (window as any).stylePresets = stylePresets;
-  
-  // Display welcome info
-  setTimeout(() => {
-    console.log('%c💡 Quick Start Guide', stylePresets.info);
-    console.log('🎨 Visual: testBanners(), testThemes(), testSVG(), testAnimations()');
-    console.log('📊 Core: testTable(), testGrouping(), testTiming(), testTrace()');
-    console.log('💻 CLI: cli("/help") - Try commands like "/theme neon", "/banner ascii"');
-    console.log('🌟 Full Demo: testAllFeatures()');
-  }, 1000);
-}