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

package/dist/ScopedLogger.js

@@ -1,426 +0,0 @@
-/**
- * @fileoverview ScopedLogger con badges y logging contextual
- * @version 0.3.0
- * @since 2024
- *
- * Proporciona loggers especializados con contexto, badges automáticos
- * y características avanzadas para componentes y APIs.
- */
-import { Logger } from './Logger.js';
-/**
- * Logger con scope mejorado con badges y API simplificada
- *
- * @class ScopedLogger
- * @extends Logger
- * @description Logger contextual que añade prefijos y badges automáticamente
- *
- * @example
- * const dbLogger = logger.scope('Database');
- * dbLogger.info('Conectando...'); // [Database] Conectando...
- *
- * // Con badges personalizados
- * dbLogger.badge('SLOW').warn('Query lenta detectada');
- * // [SLOW] [Database] Query lenta detectada
- *
- * @since 0.3.0
- */
-export class ScopedLogger extends Logger {
-    parentLogger;
-    scopeName;
-    badgeList = [];
-    contextStack = [];
-    constructor(parentLogger, scopeName, config) {
-        // Initialize with parent's config plus any overrides
-        super({ ...parentLogger.getConfig(), ...config });
-        this.parentLogger = parentLogger;
-        this.scopeName = scopeName;
-        // Inherit parent's handlers
-        const parentHandlers = parentLogger.getHandlers();
-        parentHandlers.forEach(handler => this.addHandler(handler));
-    }
-    /**
-     * Añade múltiples badges a este logger con scope
-     *
-     * @param {string[]} badges - Array de badges a añadir
-     * @returns {ScopedLogger} Esta instancia para encadenamiento
-     *
-     * @example
-     * const api = logger.scope('API');
-     * api.badges(['v2', 'beta', 'cached'])
-     *    .info('Respuesta desde caché');
-     * // [v2] [beta] [cached] [API] Respuesta desde caché
-     *
-     * @since 0.3.0
-     */
-    badges(badges) {
-        this.badgeList = [...badges];
-        return this;
-    }
-    /**
-     * Añade un badge individual
-     *
-     * @param {string} badge - Badge a añadir
-     * @returns {ScopedLogger} Esta instancia para encadenamiento
-     *
-     * @example
-     * dbLogger.badge('SLOW').warn('Query tardó 3s');
-     * // [SLOW] [Database] Query tardó 3s
-     *
-     * @since 0.3.0
-     */
-    badge(badge) {
-        if (!this.badgeList.includes(badge)) {
-            this.badgeList.push(badge);
-        }
-        return this;
-    }
-    /**
-     * Elimina todos los badges
-     *
-     * @returns {ScopedLogger} Esta instancia para encadenamiento
-     *
-     * @example
-     * api.clearBadges().info('Sin badges');
-     * // [API] Sin badges
-     *
-     * @since 0.3.0
-     */
-    clearBadges() {
-        this.badgeList = [];
-        return this;
-    }
-    /**
-     * Establece un preset de estilo para este logger con scope
-     *
-     * @param {string} presetName - Nombre del preset a aplicar
-     * @returns {ScopedLogger} Esta instancia para encadenamiento
-     *
-     * @example
-     * const errorLogger = logger.scope('ErrorHandler')
-     *   .style('cyberpunk');
-     *
-     * @since 0.3.0
-     */
-    style(presetName) {
-        this.setTheme(presetName); // Will be updated when we implement presets
-        return this;
-    }
-    /**
-     * Crea un contexto temporal que se limpia automáticamente
-     *
-     * @param {string} contextName - Nombre del contexto
-     * @returns {ContextLogger} Logger con contexto temporal
-     *
-     * @example
-     * const db = logger.scope('Database');
-     *
-     * // Contexto temporal para una operación
-     * db.context('Migration').run(() => {
-     *   db.info('Iniciando migración');
-     *   db.success('Tablas creadas');
-     * });
-     * // Contexto automáticamente limpiado
-     *
-     * @since 0.3.0
-     */
-    context(contextName) {
-        return new ContextLogger(this, contextName);
-    }
-    /**
-     * Sobrescribe el logging principal para incluir badges
-     * @protected
-     * @param {LogLevel} level - Nivel del log
-     * @param {...any} args - Argumentos del log
-     */
-    log(level, ...args) {
-        // Build the enhanced message with badges
-        const badges = this.getBadgeString();
-        const scopePrefix = this.getScopePrefix();
-        let enhancedMessage = '';
-        if (badges)
-            enhancedMessage += badges + ' ';
-        if (scopePrefix)
-            enhancedMessage += `[${scopePrefix}] `;
-        if (args.length > 0) {
-            enhancedMessage += String(args[0]);
-            // Replace the first argument with our enhanced message
-            args[0] = enhancedMessage;
-        }
-        // Call parent's log method
-        super.log(level, ...args);
-    }
-    /**
-     * Obtiene la cadena de badges formateada
-     * @private
-     * @returns {string} Badges formateados como [BADGE1][BADGE2]
-     */
-    getBadgeString() {
-        if (this.badgeList.length === 0)
-            return '';
-        return this.badgeList.map(badge => `[${badge}]`).join('');
-    }
-    /**
-     * Obtiene el prefijo del scope (incluye stack de contexto)
-     * @private
-     * @returns {string} Prefijo completo con contextos
-     */
-    getScopePrefix() {
-        const parts = [this.scopeName, ...this.contextStack].filter(Boolean);
-        return parts.join(':');
-    }
-    /**
-     * Método interno para añadir contexto
-     * @internal
-     */
-    _pushContext(context) {
-        this.contextStack.push(context);
-    }
-    /**
-     * Método interno para eliminar contexto
-     * @internal
-     */
-    _popContext() {
-        this.contextStack.pop();
-    }
-}
-/**
- * Logger específico para APIs con badges comunes de API
- *
- * @class APILogger
- * @extends ScopedLogger
- * @description Logger especializado para endpoints y servicios API
- *
- * @example
- * const api = logger.api('REST');
- * api.info('GET /users');
- * // [API] [REST] GET /users
- *
- * api.slow('Query lenta', 3500);
- * // [API] [SLOW] [REST] Query lenta (3500ms)
- *
- * @since 0.3.0
- */
-export class APILogger extends ScopedLogger {
-    constructor(parentLogger, apiName, config) {
-        super(parentLogger, `API:${apiName}`, config);
-        this.badge('API');
-    }
-    /**
-     * Registra operaciones lentas
-     *
-     * @param {string} message - Mensaje sobre la operación lenta
-     * @param {number} duration - Duración en milisegundos (opcional)
-     *
-     * @example
-     * api.slow('Query compleja', 5000);
-     * api.slow('Procesamiento pesado');
-     *
-     * @since 0.3.0
-     */
-    slow(message, duration) {
-        this.badge('SLOW');
-        const msg = duration ? `${message} (${duration}ms)` : message;
-        this.warn(msg);
-    }
-    /**
-     * Registra límites de tasa alcanzados
-     *
-     * @param {string} message - Mensaje sobre el límite
-     *
-     * @example
-     * api.rateLimit('Límite excedido: 100 req/min');
-     *
-     * @since 0.3.0
-     */
-    rateLimit(message) {
-        this.badge('RATE_LIMIT');
-        this.warn(message);
-    }
-    /**
-     * Registra problemas de autenticación
-     *
-     * @param {string} message - Mensaje de autenticación
-     *
-     * @example
-     * api.auth('Token inválido o expirado');
-     * api.auth('Credenciales incorrectas');
-     *
-     * @since 0.3.0
-     */
-    auth(message) {
-        this.badge('AUTH');
-        this.error(message);
-    }
-    /**
-     * Registra advertencias de deprecación
-     *
-     * @param {string} message - Mensaje de deprecación
-     *
-     * @example
-     * api.deprecated('Este endpoint será eliminado en v2.0');
-     * api.deprecated('Usar /v2/users en lugar de /users');
-     *
-     * @since 0.3.0
-     */
-    deprecated(message) {
-        this.badge('DEPRECATED');
-        this.warn(message);
-    }
-}
-/**
- * Logger específico para componentes de UI
- *
- * @class ComponentLogger
- * @extends ScopedLogger
- * @description Logger especializado para componentes con eventos de ciclo de vida
- *
- * @example
- * const authForm = logger.component('AuthForm');
- * authForm.lifecycle('mounted');
- * authForm.stateChange('idle', 'loading');
- *
- * @since 0.3.0
- */
-export class ComponentLogger extends ScopedLogger {
-    constructor(parentLogger, componentName, config) {
-        super(parentLogger, componentName, config);
-        this.badge('COMPONENT');
-    }
-    /**
-     * Registra eventos del ciclo de vida del componente
-     *
-     * @param {string} event - Nombre del evento (mounted, unmounted, updated, etc)
-     * @param {string} message - Mensaje adicional (opcional)
-     *
-     * @example
-     * component.lifecycle('mounted', 'Componente listo');
-     * component.lifecycle('beforeDestroy');
-     *
-     * @since 0.3.0
-     */
-    lifecycle(event, message) {
-        this.badge('LIFECYCLE');
-        const msg = message ? `${event}: ${message}` : event;
-        this.info(msg);
-    }
-    /**
-     * Registra cambios de estado
-     *
-     * @param {string} from - Estado anterior
-     * @param {string} to - Estado nuevo
-     * @param {any} data - Datos adicionales (opcional)
-     *
-     * @example
-     * component.stateChange('idle', 'loading');
-     * component.stateChange('loading', 'error', { code: 404 });
-     *
-     * @since 0.3.0
-     */
-    stateChange(from, to, data) {
-        this.badge('STATE');
-        const msg = `${from} → ${to}`;
-        if (data) {
-            this.info(msg, data);
-        }
-        else {
-            this.info(msg);
-        }
-    }
-    /**
-     * Registra cambios en las propiedades
-     *
-     * @param {Record<string, any>} changes - Objeto con los cambios
-     *
-     * @example
-     * component.propsChange({
-     *   user: newUser,
-     *   isActive: true
-     * });
-     *
-     * @since 0.3.0
-     */
-    propsChange(changes) {
-        this.badge('PROPS');
-        this.debug('Props changed:', changes);
-    }
-}
-/**
- * Logger de contexto temporal que se limpia automáticamente
- *
- * @class ContextLogger
- * @description Proporciona un contexto temporal para operaciones agrupadas
- *
- * @example
- * const db = logger.scope('Database');
- *
- * // El contexto se limpia automáticamente al finalizar
- * db.context('Transaction').run(() => {
- *   db.info('Iniciando transacción');
- *   db.success('Transacción completada');
- * });
- *
- * @since 0.3.0
- */
-export class ContextLogger {
-    parentLogger;
-    contextName;
-    constructor(parentLogger, contextName) {
-        this.parentLogger = parentLogger;
-        this.contextName = contextName;
-    }
-    /**
-     * Ejecuta una función con este contexto activo
-     *
-     * @template T - Tipo de retorno de la función
-     * @param {Function} fn - Función a ejecutar
-     * @returns {T} Resultado de la función
-     *
-     * @example
-     * const result = logger.context('Process').run(() => {
-     *   logger.info('Procesando...');
-     *   return processData();
-     * });
-     *
-     * @since 0.3.0
-     */
-    run(fn) {
-        this.parentLogger._pushContext(this.contextName);
-        try {
-            return fn();
-        }
-        finally {
-            this.parentLogger._popContext();
-        }
-    }
-    /**
-     * Run an async function with this context active
-     */
-    async runAsync(fn) {
-        this.parentLogger._pushContext(this.contextName);
-        try {
-            return await fn();
-        }
-        finally {
-            this.parentLogger._popContext();
-        }
-    }
-    /**
-     * Start the context (manual mode)
-     */
-    start() {
-        this.parentLogger._pushContext(this.contextName);
-    }
-    /**
-     * End the context (manual mode)
-     */
-    end() {
-        this.parentLogger._popContext();
-    }
-    // Delegate logging methods to parent with context
-    debug(...args) { this.parentLogger.debug(...args); }
-    info(...args) { this.parentLogger.info(...args); }
-    warn(...args) { this.parentLogger.warn(...args); }
-    error(...args) { this.parentLogger.error(...args); }
-    success(...args) { this.parentLogger.success(...args); }
-    critical(...args) { this.parentLogger.critical(...args); }
-}

package/dist/cli/CommandProcessor.d.ts

@@ -1,103 +0,0 @@
-/**
- * @fileoverview CLI Command processor for Advanced Logger
- */
-import type { Logger } from '../Logger.js';
-/**
- * Base interface for CLI commands
- */
-export interface ICommand {
-    name: string;
-    description: string;
-    usage: string;
-    category?: string;
-    aliases?: string[];
-    execute(args: string, logger: Logger): void | Promise<void>;
-}
-/**
- * Plugin interface for extending CLI functionality
- */
-export interface ICLIPlugin {
-    name: string;
-    version: string;
-    description: string;
-    commands: ICommand[];
-    initialize?(processor: CommandProcessor, logger: Logger): void;
-    cleanup?(): void;
-}
-/**
- * Command history entry
- */
-interface HistoryEntry {
-    command: string;
-    timestamp: Date;
-    success: boolean;
-}
-/**
- * CLI command processor
- */
-export declare class CommandProcessor {
-    private commands;
-    private aliases;
-    private plugins;
-    private history;
-    private maxHistorySize;
-    private isInteractiveMode;
-    /**
-     * Register a command
-     */
-    registerCommand(command: ICommand): void;
-    /**
-     * Register a plugin
-     */
-    registerPlugin(plugin: ICLIPlugin, logger?: Logger): void;
-    /**
-     * Unregister a plugin
-     */
-    unregisterPlugin(pluginName: string): void;
-    /**
-     * Get all registered commands
-     */
-    getCommands(): ICommand[];
-    /**
-     * Get a specific command
-     */
-    getCommand(name: string): ICommand | undefined;
-    /**
-     * Get command history
-     */
-    getHistory(): HistoryEntry[];
-    /**
-     * Clear command history
-     */
-    clearHistory(): void;
-    /**
-     * Get registered plugins
-     */
-    getPlugins(): ICLIPlugin[];
-    /**
-     * Enter interactive mode
-     */
-    enterInteractiveMode(logger: Logger): void;
-    /**
-     * Exit interactive mode
-     */
-    exitInteractiveMode(): void;
-    /**
-     * Setup browser interactive mode
-     */
-    private setupBrowserInteractiveMode;
-    /**
-     * Process a CLI command
-     */
-    processCommand(commandString: string, logger: Logger): Promise<void>;
-    /**
-     * Add command to history
-     */
-    private addToHistory;
-    /**
-     * Get command suggestions for partial matches
-     */
-    getSuggestions(partial: string): string[];
-}
-export {};
-//# sourceMappingURL=CommandProcessor.d.ts.map

package/dist/cli/CommandProcessor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CommandProcessor.d.ts","sourceRoot":"","sources":["../../src/cli/CommandProcessor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,UAAU,CAAC,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,OAAO,CAAC,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,YAAY;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,iBAAiB,CAAkB;IAE3C;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI;IAWxC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBzD;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAsB1C;;OAEG;IACH,WAAW,IAAI,QAAQ,EAAE;IAIzB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAc9C;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU1C;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IASnC;;OAEG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC1E;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;CAI5C"}

package/dist/cli/CommandProcessor.js

@@ -1,184 +0,0 @@
-/**
- * @fileoverview CLI Command processor for Advanced Logger
- */
-/**
- * CLI command processor
- */
-export class CommandProcessor {
-    commands = new Map();
-    aliases = new Map();
-    plugins = new Map();
-    history = [];
-    maxHistorySize = 100;
-    isInteractiveMode = false;
-    /**
-     * Register a command
-     */
-    registerCommand(command) {
-        this.commands.set(command.name, command);
-        // Register aliases
-        if (command.aliases) {
-            for (const alias of command.aliases) {
-                this.aliases.set(alias, command.name);
-            }
-        }
-    }
-    /**
-     * Register a plugin
-     */
-    registerPlugin(plugin, logger) {
-        if (this.plugins.has(plugin.name)) {
-            throw new Error(`Plugin ${plugin.name} is already registered`);
-        }
-        this.plugins.set(plugin.name, plugin);
-        // Register plugin commands
-        for (const command of plugin.commands) {
-            this.registerCommand(command);
-        }
-        // Initialize plugin
-        if (plugin.initialize && logger) {
-            plugin.initialize(this, logger);
-        }
-    }
-    /**
-     * Unregister a plugin
-     */
-    unregisterPlugin(pluginName) {
-        const plugin = this.plugins.get(pluginName);
-        if (!plugin)
-            return;
-        // Remove plugin commands
-        for (const command of plugin.commands) {
-            this.commands.delete(command.name);
-            if (command.aliases) {
-                for (const alias of command.aliases) {
-                    this.aliases.delete(alias);
-                }
-            }
-        }
-        // Cleanup plugin
-        if (plugin.cleanup) {
-            plugin.cleanup();
-        }
-        this.plugins.delete(pluginName);
-    }
-    /**
-     * Get all registered commands
-     */
-    getCommands() {
-        return Array.from(this.commands.values());
-    }
-    /**
-     * Get a specific command
-     */
-    getCommand(name) {
-        // Check direct command name
-        let command = this.commands.get(name);
-        if (command)
-            return command;
-        // Check aliases
-        const aliasTarget = this.aliases.get(name);
-        if (aliasTarget) {
-            return this.commands.get(aliasTarget);
-        }
-        return undefined;
-    }
-    /**
-     * Get command history
-     */
-    getHistory() {
-        return [...this.history];
-    }
-    /**
-     * Clear command history
-     */
-    clearHistory() {
-        this.history = [];
-    }
-    /**
-     * Get registered plugins
-     */
-    getPlugins() {
-        return Array.from(this.plugins.values());
-    }
-    /**
-     * Enter interactive mode
-     */
-    enterInteractiveMode(logger) {
-        this.isInteractiveMode = true;
-        logger.info('🔧 Interactive CLI mode activated. Type /exit to quit, /help for commands.');
-        // Set up browser console listener for interactive commands
-        if (typeof window !== 'undefined') {
-            this.setupBrowserInteractiveMode(logger);
-        }
-    }
-    /**
-     * Exit interactive mode
-     */
-    exitInteractiveMode() {
-        this.isInteractiveMode = false;
-    }
-    /**
-     * Setup browser interactive mode
-     */
-    setupBrowserInteractiveMode(logger) {
-        // Add global CLI function for browser usage
-        window.cli = (commandString) => {
-            return this.processCommand(`/${commandString}`, logger);
-        };
-        logger.info('💡 Use cli("command") to execute CLI commands in browser console.');
-    }
-    /**
-     * Process a CLI command
-     */
-    async processCommand(commandString, logger) {
-        if (!commandString.startsWith('/')) {
-            logger.error('Invalid command. Commands must start with /');
-            this.addToHistory(commandString, false);
-            return;
-        }
-        const parts = commandString.slice(1).split(' ');
-        const commandName = parts[0] || '';
-        const args = parts.slice(1).join(' ');
-        const command = this.getCommand(commandName);
-        if (!command) {
-            logger.error(`Unknown command: ${commandName}. Type /help for available commands.`);
-            // Suggest similar commands
-            const suggestions = this.getSuggestions(commandName);
-            if (suggestions.length > 0) {
-                logger.info(`📋 Did you mean: ${suggestions.slice(0, 3).join(', ')}?`);
-            }
-            this.addToHistory(commandString, false);
-            return;
-        }
-        try {
-            await command.execute(args || '', logger);
-            this.addToHistory(commandString, true);
-        }
-        catch (error) {
-            logger.error(`Command '${commandName}' failed:`, error);
-            this.addToHistory(commandString, false);
-        }
-    }
-    /**
-     * Add command to history
-     */
-    addToHistory(command, success) {
-        this.history.unshift({
-            command,
-            timestamp: new Date(),
-            success
-        });
-        // Limit history size
-        if (this.history.length > this.maxHistorySize) {
-            this.history = this.history.slice(0, this.maxHistorySize);
-        }
-    }
-    /**
-     * Get command suggestions for partial matches
-     */
-    getSuggestions(partial) {
-        const commandNames = Array.from(this.commands.keys());
-        return commandNames.filter(name => name.startsWith(partial));
-    }
-}