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

package/dist/ScopedLogger.d.ts

@@ -1,318 +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';
-import type { LoggerConfig, LogLevel } from './types/index.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 declare class ScopedLogger extends Logger {
-    private parentLogger;
-    private scopeName;
-    private badgeList;
-    private contextStack;
-    constructor(parentLogger: Logger, scopeName: string, config?: Partial<LoggerConfig>);
-    /**
-     * 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: string[]): ScopedLogger;
-    /**
-     * 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: string): ScopedLogger;
-    /**
-     * Elimina todos los badges
-     *
-     * @returns {ScopedLogger} Esta instancia para encadenamiento
-     *
-     * @example
-     * api.clearBadges().info('Sin badges');
-     * // [API] Sin badges
-     *
-     * @since 0.3.0
-     */
-    clearBadges(): ScopedLogger;
-    /**
-     * 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: string): ScopedLogger;
-    /**
-     * 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: string): ContextLogger;
-    /**
-     * Sobrescribe el logging principal para incluir badges
-     * @protected
-     * @param {LogLevel} level - Nivel del log
-     * @param {...any} args - Argumentos del log
-     */
-    protected log(level: LogLevel, ...args: any[]): void;
-    /**
-     * Obtiene la cadena de badges formateada
-     * @private
-     * @returns {string} Badges formateados como [BADGE1][BADGE2]
-     */
-    private getBadgeString;
-    /**
-     * Obtiene el prefijo del scope (incluye stack de contexto)
-     * @private
-     * @returns {string} Prefijo completo con contextos
-     */
-    private getScopePrefix;
-    /**
-     * Método interno para añadir contexto
-     * @internal
-     */
-    _pushContext(context: string): void;
-    /**
-     * Método interno para eliminar contexto
-     * @internal
-     */
-    _popContext(): void;
-}
-/**
- * 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 declare class APILogger extends ScopedLogger {
-    constructor(parentLogger: Logger, apiName: string, config?: Partial<LoggerConfig>);
-    /**
-     * 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: string, duration?: number): void;
-    /**
-     * 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: string): void;
-    /**
-     * 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: string): void;
-    /**
-     * 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: string): void;
-}
-/**
- * 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 declare class ComponentLogger extends ScopedLogger {
-    constructor(parentLogger: Logger, componentName: string, config?: Partial<LoggerConfig>);
-    /**
-     * 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: string, message?: string): void;
-    /**
-     * 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: string, to: string, data?: any): void;
-    /**
-     * 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: Record<string, any>): void;
-}
-/**
- * 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 declare class ContextLogger {
-    private parentLogger;
-    private contextName;
-    constructor(parentLogger: ScopedLogger, contextName: string);
-    /**
-     * 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<T>(fn: () => T): T;
-    /**
-     * Run an async function with this context active
-     */
-    runAsync<T>(fn: () => Promise<T>): Promise<T>;
-    /**
-     * Start the context (manual mode)
-     */
-    start(): void;
-    /**
-     * End the context (manual mode)
-     */
-    end(): void;
-    debug(...args: any[]): void;
-    info(...args: any[]): void;
-    warn(...args: any[]): void;
-    error(...args: any[]): void;
-    success(...args: any[]): void;
-    critical(...args: any[]): void;
-}
-//# sourceMappingURL=ScopedLogger.d.ts.map

package/dist/ScopedLogger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ScopedLogger.d.ts","sourceRoot":"","sources":["../src/ScopedLogger.ts"],"names":[],"mappings":"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"}