@mks2508/better-logger 5.0.0 → 5.0.2

package/src/types/core.ts

@@ -1,417 +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';
-
-/**
- * Formatos de salida para diferentes entornos
- * @typedef {'auto' | 'plain' | 'ansi' | 'build' | 'ci'} OutputFormat
- *
- * @description
- * - auto: Detección automática basada en entorno (recomendado)
- * - plain: Texto plano sin colores (máxima compatibilidad)
- * - ansi: Colores ANSI para terminales modernos
- * - build: Formato optimizado para builds (Next.js, webpack, etc.)
- * - ci: Formato optimizado para CI/CD (sin emojis, texto simple)
- */
-export type OutputFormat = 'auto' | 'plain' | 'ansi' | 'build' | 'ci';
-
-/**
- * Output modes for controlling where logs are written
- * @typedef {'console' | 'silent' | 'custom'} OutputMode
- *
- * @description
- * - console: Standard console.log output (default)
- * - silent: No output at all
- * - custom: Use custom OutputWriter for advanced scenarios
- */
-export type OutputMode = 'console' | 'silent' | 'custom';
-
-/**
- * Custom output writer interface for redirecting log output
- *
- * @interface OutputWriter
- * @since 4.0.0
- *
- * @description
- * Allows redirecting log output to custom destinations like:
- * - DraftLog for CLI spinners with concurrent logging
- * - Buffers for collecting logs during operations
- * - Custom streams or transports
- *
- * @example
- * class BufferWriter implements OutputWriter {
- *   private buffer: string[] = [];
- *
- *   write(message: string, level: LogLevel, styles: string[]): void {
- *     this.buffer.push(message);
- *   }
- *
- *   flush(): void {
- *     this.buffer.forEach(msg => console.log(msg));
- *     this.buffer = [];
- *   }
- * }
- */
-export interface OutputWriter {
-    write(message: string, level: LogLevel, styles: string[]): void;
-    flush?(): void;
-}
-
-/**
- * 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;
-    outputFormat?: OutputFormat;
-    /** Output mode: 'console' (default), 'silent', or 'custom' @since 4.0.0 */
-    outputMode?: OutputMode;
-    /** Custom writer when outputMode is 'custom' @since 4.0.0 */
-    outputWriter?: OutputWriter;
-    /** CLI verbosity level for controlling primitive output @since 5.0.0 */
-    cliLevel?: CLILogLevel;
-}
-
-/**
- * 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;
-}
-
-export interface TimerResult {
-    label: string;
-    duration: number;
-    startTime: number;
-    endTime: number;
-}
-
-export interface IScopedLogger {
-    debug(...args: any[]): void;
-    info(...args: any[]): void;
-    warn(...args: any[]): void;
-    error(...args: any[]): void;
-    success(...args: any[]): void;
-    critical(...args: any[]): void;
-    trace(...args: any[]): void;
-
-    badges(badges: string[]): this;
-    badge(badge: string): this;
-    clearBadges(): this;
-
-    time(label: string): void;
-    timeEnd(label: string): number | undefined;
-
-    style(presetName: string): this;
-}
-
-export interface IAPILogger extends IScopedLogger {
-    slow(message: string, duration?: number): void;
-    rateLimit(message: string): void;
-    auth(message: string): void;
-    deprecated(message: string): void;
-}
-
-export interface IComponentLogger extends IScopedLogger {
-    lifecycle(event: string, message?: string): void;
-    stateChange(from: string, to: string, data?: any): void;
-    propsChange(changes: Record<string, any>): void;
-}
-
-export interface Bindings {
-    scope?: string;
-    badges?: string[];
-    type?: 'scope' | 'api' | 'component';
-    context?: string[];
-}
-
-export type BadgeStyle = 'brackets' | 'rounded' | 'plain' | 'unicode' | 'pill';
-
-export type TimestampFormat = 'iso' | 'time' | 'timeMs' | 'relative' | 'elapsed' | 'date' | 'custom';
-
-export type ColumnAlign = 'left' | 'right' | 'center';
-
-export interface ColumnConfig {
-    content: string;
-    width?: number;
-    align?: ColumnAlign;
-    color?: string;
-}
-
-export interface LogOptions {
-    rightAlign?: string;
-    columns?: ColumnConfig[];
-    maxWidth?: number;
-    keyValue?: boolean;
-    badgeStyle?: BadgeStyle;
-    timestampFormat?: TimestampFormat;
-}
-
-// ===== CLI PRIMITIVES (v5.0) =====
-
-/**
- * CLI verbosity levels for controlling primitive output
- * @since 5.0.0
- */
-export type CLILogLevel = 'silent' | 'quiet' | 'normal' | 'verbose' | 'debug';
-
-/**
- * Handle returned by logger.spinner() for controlling spinner lifecycle
- * @since 5.0.0
- */
-export interface ISpinnerHandle {
-    /** Start the spinner animation */
-    start(): void;
-    /** Stop the spinner without a status message */
-    stop(): void;
-    /** Stop the spinner with a success message */
-    succeed(msg?: string): void;
-    /** Stop the spinner with a failure message */
-    fail(msg?: string): void;
-    /** Update the spinner text while running */
-    text(msg: string): void;
-}
-
-/**
- * Options for logger.box() output
- * @since 5.0.0
- */
-export interface IBoxOptions {
-    /** Title displayed in the top border */
-    title?: string;
-    /** Color of the border (hex, CSS name, or ANSI name) */
-    borderColor?: string;
-    /** Border character style */
-    borderStyle?: 'single' | 'double' | 'rounded' | 'bold';
-    /** Inner padding lines (default: 0) */
-    padding?: number;
-}
-
-/**
- * Options for logger.cliTable() output
- * @since 5.0.0
- */
-export interface ITableOptions {
-    /** Column names to display (overrides auto-detection) */
-    columns?: string[];
-    /** Header labels (defaults to column names) */
-    head?: string[];
-}

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/hooks.ts

@@ -1,45 +0,0 @@
-import type { LogLevel, StackInfo } from './core.js';
-
-export interface HookLogEntry {
-    level: LogLevel;
-    message: string;
-    args: any[];
-    timestamp: string;
-    prefix?: string;
-    stackInfo?: StackInfo;
-    correlationId?: string;
-    context?: Record<string, any>;
-    [key: string]: any;
-}
-
-export type HookEvent = 'beforeLog' | 'afterLog' | 'onError';
-
-export type HookCallback = (entry: HookLogEntry) => void | HookLogEntry | Promise<void | HookLogEntry>;
-
-export type MiddlewareFn = (
-    entry: HookLogEntry,
-    next: () => void | Promise<void>
-) => void | Promise<void>;
-
-export interface HookRegistration {
-    id: string;
-    event: HookEvent;
-    callback: HookCallback;
-    priority: number;
-    once: boolean;
-}
-
-export interface MiddlewareRegistration {
-    id: string;
-    fn: MiddlewareFn;
-    priority: number;
-}
-
-export interface IHookManager {
-    on(event: HookEvent, callback: HookCallback, priority?: number): () => void;
-    once(event: HookEvent, callback: HookCallback, priority?: number): () => void;
-    off(event: HookEvent, callback: HookCallback): boolean;
-    use(middleware: MiddlewareFn, priority?: number): () => void;
-    emit(event: HookEvent, entry: HookLogEntry): Promise<HookLogEntry>;
-    process(entry: HookLogEntry): Promise<HookLogEntry>;
-}

package/src/types/index.ts

@@ -1,83 +0,0 @@
-/**
- * @fileoverview Type definitions exports for Advanced Logger
- */
-
-// Core types
-export type {
-    LogLevel,
-    Verbosity,
-    ThemeVariant,
-    DevToolsTheme,
-    BannerType,
-    ExportFormat,
-    OutputFormat,
-    LoggerConfig,
-    StackInfo,
-    TimerEntry,
-    TimerResult,
-    StyleOptions,
-    AdaptiveColors,
-    SpacingType,
-    LogLayout,
-    LogPartConfig,
-    LogStyles,
-    IScopedLogger,
-    IAPILogger,
-    IComponentLogger,
-    Bindings,
-    BadgeStyle,
-    TimestampFormat,
-    ColumnAlign,
-    ColumnConfig,
-    LogOptions,
-    CLILogLevel,
-    ISpinnerHandle,
-    IBoxOptions,
-    ITableOptions,
-} from './core.js';
-
-export { LOG_LEVELS } from './core.js';
-
-// Handler types
-export type {
-    LogMetadata,
-    ILogHandler,
-    LogEntry,
-    ExportFilters,
-    ExportOptions,
-    ExportResult,
-    BufferStats,
-} from './handlers.js';
-
-// Serializer types
-export type {
-    SerializerFn,
-    SerializerContext,
-    SerializerEntry,
-    SerializerConfig,
-    ISerializerRegistry,
-} from './serializers.js';
-
-// Hook types
-export type {
-    HookLogEntry,
-    HookEvent,
-    HookCallback,
-    MiddlewareFn,
-    HookRegistration,
-    MiddlewareRegistration,
-    IHookManager,
-} from './hooks.js';
-
-// Transport types
-export type {
-    TransportRecord,
-    TransportOptions,
-    TransportTarget,
-    ITransport,
-    IBufferedTransport,
-    ITransportManager,
-} from './transports.js';
-
-// Style Cache types
-export type { StyleCacheConfig } from '../styling/StyleCache.js';

package/src/types/serializers.ts

@@ -1,30 +0,0 @@
-import type { LogLevel } from './core.js';
-
-export type SerializerFn<T = any> = (value: T, context: SerializerContext) => any;
-
-export interface SerializerContext {
-    depth: number;
-    maxDepth: number;
-    path: string[];
-    seen: WeakSet<object>;
-}
-
-export interface SerializerEntry<T = any> {
-    type: new (...args: any[]) => T;
-    serializer: SerializerFn<T>;
-    priority: number;
-}
-
-export interface SerializerConfig {
-    maxDepth?: number;
-    circular?: 'error' | 'skip' | 'placeholder';
-    preserveUndefined?: boolean;
-}
-
-export interface ISerializerRegistry {
-    add<T>(type: new (...args: any[]) => T, serializer: SerializerFn<T>, priority?: number): void;
-    remove<T>(type: new (...args: any[]) => T): boolean;
-    has<T>(type: new (...args: any[]) => T): boolean;
-    serialize(value: any, config?: SerializerConfig): any;
-    getAll(): SerializerEntry[];
-}