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

package/src/types/core.ts

@@ -1,236 +0,0 @@
-/**
- * @fileoverview Definiciones de tipos principales para Better Logger
- * @version 0.3.0
- * @since 2024
- */
-
-/**
- * Niveles de log soportados en orden jerárquico (debug < info < warn < error < critical)
- * 
- * @constant {Object} LOG_LEVELS
- * @property {number} debug - Nivel 0: Información de depuración detallada
- * @property {number} info - Nivel 1: Mensajes informativos generales
- * @property {number} warn - Nivel 2: Advertencias que no detienen la ejecución
- * @property {number} error - Nivel 3: Errores que pueden afectar funcionalidad
- * @property {number} critical - Nivel 4: Errores críticos que requieren atención inmediata
- * 
- * @example
- * // Verificar si un nivel debe mostrarse
- * if (LOG_LEVELS[currentLevel] >= LOG_LEVELS.warn) {
- *   // Mostrar solo warn, error y critical
- * }
- */
-export const LOG_LEVELS = {
-    debug: 0,
-    info: 1,
-    warn: 2,
-    error: 3,
-    critical: 4,
-} as const;
-
-/**
- * Tipo de nivel de log derivado de las claves de LOG_LEVELS
- * @typedef {'debug' | 'info' | 'warn' | 'error' | 'critical'} LogLevel
- */
-export type LogLevel = keyof typeof LOG_LEVELS;
-
-/**
- * Tipo de nivel de verbosidad para filtrar logs
- * @typedef {LogLevel | 'silent'} Verbosity
- * @description 'silent' desactiva completamente todos los logs
- */
-export type Verbosity = LogLevel | 'silent';
-
-/**
- * Variantes de tema para diferentes estilos visuales
- * @typedef {'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk'} ThemeVariant
- * 
- * @description
- * - default: Tema adaptativo automático (claro/oscuro)
- * - dark: Tema oscuro con colores vibrantes
- * - light: Tema claro con colores suaves
- * - neon: Colores neón brillantes con efectos de resplandor
- * - minimal: Diseño minimalista y limpio
- * - cyberpunk: Estilo futurista con neón y efectos
- */
-export type ThemeVariant = 'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk';
-
-/**
- * Detección de tema de DevTools del navegador
- * @typedef {'light' | 'dark'} DevToolsTheme
- */
-export type DevToolsTheme = 'light' | 'dark';
-
-/**
- * Tipos de banner para diferentes enfoques visuales
- * @typedef {'simple' | 'ascii' | 'unicode' | 'svg' | 'animated'} BannerType
- * 
- * @description
- * - simple: Texto simple sin decoración
- * - ascii: Arte ASCII tradicional
- * - unicode: Caracteres Unicode decorativos
- * - svg: Gráfico SVG embebido
- * - animated: Banner con animación CSS
- */
-export type BannerType = 'simple' | 'ascii' | 'unicode' | 'svg' | 'animated';
-
-/**
- * Formatos de exportación para datos de log
- * @typedef {'json' | 'csv' | 'markdown' | 'plain' | 'html'} ExportFormat
- * 
- * @description
- * - json: Formato JSON estructurado
- * - csv: Valores separados por comas para Excel/Sheets
- * - markdown: Formato Markdown para documentación
- * - plain: Texto plano sin formato
- * - html: HTML con estilos para visualización web
- */
-export type ExportFormat = 'json' | 'csv' | 'markdown' | 'plain' | 'html';
-
-/**
- * Interfaz de configuración para instancias del logger
- * 
- * @interface LoggerConfig
- * @since 0.3.0
- * 
- * @example
- * const config: LoggerConfig = {
- *   globalPrefix: 'MiApp',
- *   verbosity: 'info',
- *   enableColors: true,
- *   enableTimestamps: true,
- *   enableStackTrace: false,
- *   theme: 'cyberpunk',
- *   bannerType: 'animated',
- *   bufferSize: 500,
- *   autoDetectTheme: true
- * };
- */
-export interface LoggerConfig {
-    globalPrefix?: string;
-    verbosity: Verbosity;
-    enableColors: boolean;
-    enableTimestamps: boolean;
-    enableStackTrace: boolean;
-    theme?: ThemeVariant;
-    bannerType?: BannerType;
-    bufferSize?: number;
-    autoDetectTheme?: boolean;
-}
-
-/**
- * Información parseada del stack trace
- * 
- * @interface StackInfo
- * @description Contiene la ubicación exacta donde se originó el log
- */
-export interface StackInfo {
-    file: string;
-    line: number;
-    column: number;
-    function?: string;
-}
-
-/**
- * Entrada de temporizador para medición de rendimiento
- * 
- * @interface TimerEntry
- * @description Usado internamente para rastrear temporizadores activos
- */
-export interface TimerEntry {
-    label: string;
-    startTime: number;
-}
-
-/**
- * Opciones para estilizar componentes
- * 
- * @interface StyleOptions
- * @description Configuración de dimensiones y espaciado para elementos visuales
- */
-export interface StyleOptions {
-    width?: number;
-    height?: number;
-    padding?: string;
-}
-
-/**
- * Configuración de colores adaptativos para temas claro/oscuro
- * 
- * @interface AdaptiveColors
- * @description Define colores que se ajustan automáticamente al tema del navegador
- */
-export interface AdaptiveColors {
-    light: string;
-    dark: string;
-}
-
-/**
- * Configuración de espaciado para elementos del log
- * @typedef {'compact' | 'normal' | 'spacious'} SpacingType
- * 
- * @description
- * - compact: Espaciado mínimo para más densidad
- * - normal: Espaciado estándar balanceado
- * - spacious: Espaciado amplio para mejor legibilidad
- */
-export type SpacingType = 'compact' | 'normal' | 'spacious';
-
-/**
- * Configuración de layout para la estructura del log
- * 
- * @interface LogLayout
- * @description Define cómo se organizan visualmente los elementos del log
- */
-export interface LogLayout {
-    spacing: SpacingType;
-    innerPadding?: string;
-    outerMargin?: string;
-    separator?: string;
-}
-
-/**
- * Configuración para partes individuales del log
- * 
- * @interface LogPartConfig
- * @description Permite personalizar cada elemento del log por separado
- * 
- * @example
- * const timestampConfig: LogPartConfig = {
- *   show: true,
- *   color: '#888',
- *   font: 'Monaco',
- *   size: '11px'
- * };
- */
-export interface LogPartConfig {
-    show?: boolean;
-    style?: string;
-    font?: string;
-    size?: string;
-    color?: string; // Automatically adaptive by default
-    background?: string;
-    padding?: string;
-    margin?: string;
-    border?: string;
-    shadow?: string;
-    uppercase?: boolean;
-}
-
-/**
- * Configuración completa de estilos del log
- * 
- * @interface LogStyles
- * @description Agrupa todas las opciones de estilo en una sola configuración
- * @since 0.3.0
- */
-export interface LogStyles {
-    layout?: LogLayout;
-    timestamp?: LogPartConfig;
-    level?: LogPartConfig;
-    prefix?: LogPartConfig;
-    message?: LogPartConfig;
-    location?: LogPartConfig;
-    backdrop?: string;
-    transparency?: number;
-}

package/src/types/handlers.ts

@@ -1,95 +0,0 @@
-/**
- * @fileoverview Handler and metadata type definitions for Advanced Logger
- */
-
-import type { LogLevel, StackInfo } from './core.js';
-
-/**
- * Metadata associated with each log entry
- */
-export interface LogMetadata {
-    timestamp: string;
-    level: LogLevel;
-    prefix?: string;
-    stackInfo?: StackInfo;
-    group?: string;
-}
-
-/**
- * Interface for custom log handlers (extensibility)
- */
-export interface ILogHandler {
-    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
-}
-
-/**
- * Stored log entry for export functionality
- */
-export interface LogEntry {
-    id: string;
-    timestamp: string;
-    level: LogLevel;
-    prefix?: string;
-    message: string;
-    args: any[];
-    location?: StackInfo;
-    groupInfo?: {
-        depth: number;
-        groupName?: string;
-    };
-}
-
-/**
- * Export filter options
- */
-export interface ExportFilters {
-    levels?: LogLevel[];
-    since?: Date | string | number; // Date, ISO string, or hours ago
-    until?: Date | string | number;
-    prefixes?: string[];
-    excludePrefixes?: string[];
-    withStackTrace?: boolean;
-    errorsOnly?: boolean;
-    last?: number;
-    first?: number;
-    search?: string;
-    groupBy?: 'level' | 'prefix' | 'hour' | 'date';
-}
-
-/**
- * Export options for different formats
- */
-export interface ExportOptions {
-    minimal?: boolean;
-    compact?: boolean;
-    styled?: boolean;
-    includeMetadata?: boolean;
-    groupBy?: ExportFilters['groupBy'];
-}
-
-/**
- * Export result with metadata
- */
-export interface ExportResult {
-    format: string;
-    data: string;
-    metadata: {
-        totalLogs: number;
-        filteredLogs: number;
-        exportedAt: string;
-        filters?: ExportFilters;
-        options?: ExportOptions;
-    };
-}
-
-/**
- * Buffer statistics for log management
- */
-export interface BufferStats {
-    size: number;
-    maxSize: number;
-    usage: number; // percentage
-    oldestLog?: Date;
-    newestLog?: Date;
-    levelCounts: Record<LogLevel, number>;
-}

package/src/types/index.ts

@@ -1,35 +0,0 @@
-/**
- * @fileoverview Type definitions exports for Advanced Logger
- */
-
-// Core types
-export type {
-    LogLevel,
-    Verbosity,
-    ThemeVariant,
-    DevToolsTheme,
-    BannerType,
-    ExportFormat,
-    LoggerConfig,
-    StackInfo,
-    TimerEntry,
-    StyleOptions,
-    AdaptiveColors,
-    SpacingType,
-    LogLayout,
-    LogPartConfig,
-    LogStyles,
-} from './core.js';
-
-export { LOG_LEVELS } from './core.js';
-
-// Handler types
-export type {
-    LogMetadata,
-    ILogHandler,
-    LogEntry,
-    ExportFilters,
-    ExportOptions,
-    ExportResult,
-    BufferStats,
-} from './handlers.js';

package/src/typescript.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="32" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path fill="#007ACC" d="M0 128v128h256V0H0z"></path><path fill="#FFF" d="m56.612 128.85l-.081 10.483h33.32v94.68h23.568v-94.68h33.321v-10.28c0-5.69-.122-10.444-.284-10.566c-.122-.162-20.4-.244-44.983-.203l-44.74.122l-.121 10.443Zm149.955-10.742c6.501 1.625 11.459 4.51 16.01 9.224c2.357 2.52 5.851 7.111 6.136 8.208c.08.325-11.053 7.802-17.798 11.988c-.244.162-1.22-.894-2.317-2.52c-3.291-4.795-6.745-6.867-12.028-7.233c-7.76-.528-12.759 3.535-12.718 10.321c0 1.992.284 3.17 1.097 4.795c1.707 3.536 4.876 5.649 14.832 9.956c18.326 7.883 26.168 13.084 31.045 20.48c5.445 8.249 6.664 21.415 2.966 31.208c-4.063 10.646-14.14 17.879-28.323 20.276c-4.388.772-14.79.65-19.504-.203c-10.28-1.828-20.033-6.908-26.047-13.572c-2.357-2.6-6.949-9.387-6.664-9.874c.122-.163 1.178-.813 2.356-1.504c1.138-.65 5.446-3.129 9.509-5.485l7.355-4.267l1.544 2.276c2.154 3.29 6.867 7.801 9.712 9.305c8.167 4.307 19.383 3.698 24.909-1.26c2.357-2.153 3.332-4.388 3.332-7.68c0-2.966-.366-4.266-1.91-6.501c-1.99-2.845-6.054-5.242-17.595-10.24c-13.206-5.69-18.895-9.224-24.096-14.832c-3.007-3.25-5.852-8.452-7.03-12.8c-.975-3.617-1.22-12.678-.447-16.335c2.723-12.76 12.353-21.659 26.25-24.3c4.51-.853 14.994-.528 19.424.569Z"></path></svg>

package/src/utils/environment.ts

@@ -1,94 +0,0 @@
-/**
- * @fileoverview Environment detection utilities for Universal Logger
- */
-
-/**
- * Checks if running in Node.js environment
- */
-export const isNode = typeof process !== 'undefined' && 
-                      process.versions && 
-                      process.versions.node;
-
-/**
- * Checks if running in browser environment
- */
-export const isBrowser = typeof window !== 'undefined' && 
-                          typeof document !== 'undefined';
-
-/**
- * Checks if running in web worker environment
- */
-export const isWebWorker = typeof self !== 'undefined' && 
-                            typeof (self as any).importScripts === 'function';
-
-/**
- * Checks if running in Deno environment
- */
-export const isDeno = typeof globalThis !== 'undefined' && 
-                      'Deno' in globalThis;
-
-/**
- * Gets the current runtime environment
- */
-export function getRuntimeEnvironment(): 'node' | 'browser' | 'webworker' | 'deno' | 'unknown' {
-    if (isNode) return 'node';
-    if (isBrowser) return 'browser';
-    if (isWebWorker) return 'webworker';
-    if (isDeno) return 'deno';
-    return 'unknown';
-}
-
-/**
- * Checks if colors/styling should be supported in current environment
- */
-export function supportsColors(): boolean {
-    if (isBrowser) {
-        // Browser always supports CSS colors
-        return true;
-    }
-    
-    if (isNode) {
-        // Check if Node.js supports colors
-        return process.stdout?.isTTY === true || 
-               process.env.FORCE_COLOR === '1' ||
-               process.env.FORCE_COLOR === 'true';
-    }
-    
-    return false;
-}
-
-/**
- * Checks if CSS styling is supported (browser-only feature)
- */
-export function supportsCSSColors(): boolean {
-    return isBrowser;
-}
-
-/**
- * Checks if ANSI colors are supported (terminal environments)
- */
-export function supportsANSIColors(): boolean {
-    if (isNode) {
-        return process.stdout?.isTTY === true || 
-               process.env.FORCE_COLOR === '1' ||
-               process.env.FORCE_COLOR === 'true';
-    }
-    
-    return false;
-}
-
-/**
- * Gets environment-specific information
- */
-export function getEnvironmentInfo() {
-    const env = getRuntimeEnvironment();
-    
-    return {
-        runtime: env,
-        supportsColors: supportsColors(),
-        supportsCSSColors: supportsCSSColors(),
-        supportsANSIColors: supportsANSIColors(),
-        isProduction: isNode ? process.env.NODE_ENV === 'production' : false,
-        version: isNode ? process.versions.node : (isBrowser ? navigator.userAgent : 'unknown')
-    };
-}

package/src/utils/formatting.ts

@@ -1,142 +0,0 @@
-/**
- * @fileoverview Formatting utilities for Universal Logger
- */
-
-import type { LogLevel, StackInfo } from '../types/index.js';
-import { formatTimestamp } from './timestamps.js';
-
-/**
- * Creates plain text output for any environment
- * No colors, no styling - maximum compatibility
- */
-export function createPlainOutput(
-    level: LogLevel,
-    message: string,
-    prefix?: string,
-    stackInfo?: StackInfo | null
-): string {
-    const timestamp = formatTimestamp();
-    const timeStr = timestamp.slice(11, 23); // HH:MM:SS.mmm
-    
-    let output = `[${timeStr}] [${level.toUpperCase()}]`;
-    
-    if (prefix) {
-        output += ` [${prefix}]`;
-    }
-    
-    output += ` ${message}`;
-    
-    if (stackInfo) {
-        output += ` (${stackInfo.file}:${stackInfo.line}:${stackInfo.column})`;
-    }
-    
-    return output;
-}
-
-/**
- * Gets the appropriate log method for the level
- * Uses different console methods for better semantics
- */
-export function getConsoleMethod(level: LogLevel): 'log' | 'info' | 'warn' | 'error' {
-    switch (level) {
-        case 'debug':
-            return 'log';
-        case 'info':
-            return 'info';
-        case 'warn':
-            return 'warn';
-        case 'error':
-        case 'critical':
-            return 'error';
-        default:
-            return 'log';
-    }
-}
-
-/**
- * Create a simple log entry object for handlers
- */
-export function createLogEntry(
-    level: LogLevel,
-    message: string,
-    args: any[],
-    prefix?: string,
-    stackInfo?: StackInfo | null
-) {
-    return {
-        timestamp: formatTimestamp(),
-        level: level.toUpperCase(),
-        prefix,
-        message,
-        args: args.slice(1), // Exclude the first message argument
-        location: stackInfo ? {
-            file: stackInfo.file,
-            line: stackInfo.line,
-            column: stackInfo.column,
-            function: stackInfo.function
-        } : undefined,
-        raw: args
-    };
-}
-
-/**
- * Format data for table display in plain text
- */
-export function formatTablePlain(data: any, columns?: string[]): string {
-    try {
-        if (Array.isArray(data)) {
-            if (data.length === 0) return '[Empty Array]';
-            
-            // Simple array formatting
-            if (typeof data[0] !== 'object') {
-                return data.map((item, i) => `${i}: ${item}`).join('\n');
-            }
-            
-            // Object array formatting
-            const keys = columns || Object.keys(data[0] || {});
-            const header = keys.join('\t');
-            const rows = data.map(item => 
-                keys.map(key => String(item[key] || '')).join('\t')
-            );
-            
-            return [header, ...rows].join('\n');
-        }
-        
-        if (typeof data === 'object' && data !== null) {
-            // Simple object formatting
-            return Object.entries(data)
-                .map(([key, value]) => `${key}: ${value}`)
-                .join('\n');
-        }
-        
-        return String(data);
-    } catch (error) {
-        return `[Error formatting table: ${error}]`;
-    }
-}
-
-/**
- * Safe object serialization for logging
- */
-export function safeSerialize(obj: any, maxDepth: number = 3, currentDepth: number = 0): any {
-    if (currentDepth >= maxDepth) {
-        return '[Max Depth Reached]';
-    }
-    
-    if (obj === null) return null;
-    if (obj === undefined) return '[undefined]';
-    if (typeof obj === 'function') return '[Function]';
-    if (obj instanceof Error) return `[Error: ${obj.message}]`;
-    if (obj instanceof Date) return obj.toISOString();
-    if (typeof obj !== 'object') return obj;
-    
-    if (Array.isArray(obj)) {
-        return obj.map(item => safeSerialize(item, maxDepth, currentDepth + 1));
-    }
-    
-    const result: any = {};
-    for (const [key, value] of Object.entries(obj)) {
-        result[key] = safeSerialize(value, maxDepth, currentDepth + 1);
-    }
-    return result;
-}

package/src/utils/index.ts

@@ -1,21 +0,0 @@
-/**
- * @fileoverview Utility functions exports for Advanced Logger
- */
-
-export { parseStackTrace } from './stackTrace.js';
-export { 
-    formatTimestamp, 
-    parseRelativeTime, 
-    parseTimeInput, 
-    formatDisplayTime 
-} from './timestamps.js';
-export { 
-    createStyledOutput, 
-    generateLogId, 
-    escapeHtml, 
-    safeStringify,
-    detectDevToolsTheme,
-    getAdaptiveColor,
-    setupThemeChangeListener,
-    type LevelStyleConfig 
-} from './output.js';