@mks2508/better-logger 5.0.0 → 5.0.2

package/src/index.ts

@@ -1,395 +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,
-    CLILogLevel,
-    IBoxOptions,
-    ITableOptions,
-} from './types/index.js';
-
-// Lazy singleton - se inicializa solo cuando se necesita
-let _logger: Logger | null = null;
-
-function getLogger(): Logger {
-    if (!_logger) {
-        _logger = new Logger();
-    }
-    return _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 getLogger();
-
-/**
- * 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[]) => getLogger().debug(...args);
-export const info = (...args: any[]) => getLogger().info(...args);
-export const warn = (...args: any[]) => getLogger().warn(...args);
-export const error = (...args: any[]) => getLogger().error(...args);
-export const success = (...args: any[]) => getLogger().success(...args);
-export const critical = (...args: any[]) => getLogger().critical(...args);
-export const trace = (...args: any[]) => getLogger().trace(...args);
-export const table = (data: any, columns?: string[]) => getLogger().table(data, columns);
-export const group = (label: string, collapsed?: boolean) => getLogger().group(label, collapsed);
-export const groupEnd = () => getLogger().groupEnd();
-export const time = (label: string) => getLogger().time(label);
-export const timeEnd = (label: string) => getLogger().timeEnd(label);
-export const setGlobalPrefix = (prefix: string) => getLogger().setGlobalPrefix(prefix);
-export const scope = (name: string) => getLogger().scope(name);
-export const component = (name: string) => getLogger().component(name);
-export const api = (name: string) => getLogger().api(name);
-export const badges = (badgeList: string[]) => getLogger().badges(badgeList);
-export const badge = (badgeName: string) => getLogger().badge(badgeName);
-export const clearBadges = () => getLogger().clearBadges();
-export const setVerbosity = (level: Verbosity) => getLogger().setVerbosity(level);
-export const addHandler = (handler: ILogHandler) => getLogger().addHandler(handler);
-export const setTheme = (theme: ThemeVariant) => getLogger().setTheme(theme);
-export const setBannerType = (bannerType: BannerType) => getLogger().setBannerType(bannerType);
-export const showBanner = (bannerType?: BannerType) => getLogger().showBanner(bannerType);
-export const logWithSVG = (message: string, svgContent?: string, options?: StyleOptions) => 
-    getLogger().logWithSVG(message, svgContent, options);
-export const logAnimated = (message: string, duration?: number) => 
-    getLogger().logAnimated(message, duration);
-export const cli = (command: string) => getLogger().cli(command);
-
-// CLI Primitives (v5.0)
-export const step = (current: number, total: number, message: string) => getLogger().step(current, total, message);
-export const spinner = (message: string) => getLogger().spinner(message);
-export const box = (content: string, options?: IBoxOptions) => getLogger().box(content, options);
-export const cliTable = (rows: Record<string, unknown>[], options?: ITableOptions) => getLogger().cliTable(rows, options);
-export const header = (title: string, subtitle?: string) => getLogger().header(title, subtitle);
-export const divider = () => getLogger().divider();
-export const blank = () => getLogger().blank();
-export const setCLILevel = (level: CLILogLevel) => getLogger().setCLILevel(level);
-
-// Type exports
-export type {
-    LogLevel,
-    Verbosity,
-    ThemeVariant,
-    BannerType,
-    StyleOptions,
-    ILogHandler,
-    LoggerConfig,
-    LogMetadata,
-    StackInfo,
-    TimerEntry,
-    TimerResult,
-    OutputFormat,
-    IScopedLogger,
-    IAPILogger,
-    IComponentLogger,
-    Bindings,
-    SerializerFn,
-    SerializerContext,
-    SerializerConfig,
-    ISerializerRegistry,
-    HookLogEntry,
-    HookEvent,
-    HookCallback,
-    MiddlewareFn,
-    IHookManager,
-    TransportRecord,
-    TransportOptions,
-    TransportTarget,
-    ITransport,
-    StyleCacheConfig,
-    BadgeStyle,
-    TimestampFormat,
-    ColumnAlign,
-    ColumnConfig,
-    LogOptions,
-    CLILogLevel,
-    ISpinnerHandle,
-    IBoxOptions,
-    ITableOptions,
-} 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';
-
-// Serializers
-export { SerializerRegistry } from './serializers/index.js';
-
-// Hooks & Middleware
-export { HookManager } from './hooks/index.js';
-
-// Transports
-export {
-    TransportManager,
-    ConsoleTransport,
-    FileTransport,
-    HttpTransport
-} from './transports/index.js';
-
-// Style Cache
-export { StyleCache, getStyleCache } from './styling/StyleCache.js';
-
-// Enterprise feature function exports
-import type { SerializerFn, HookEvent, HookCallback, MiddlewareFn, TransportTarget } from './types/index.js';
-export const addSerializer = <T>(
-    type: new (...args: any[]) => T,
-    serializer: SerializerFn<T>,
-    priority?: number
-) => getLogger().addSerializer(type, serializer, priority);
-export const removeSerializer = <T>(type: new (...args: any[]) => T) =>
-    getLogger().removeSerializer(type);
-export const on = (event: HookEvent, callback: HookCallback, priority?: number) =>
-    getLogger().on(event, callback, priority);
-export const once = (event: HookEvent, callback: HookCallback, priority?: number) =>
-    getLogger().once(event, callback, priority);
-export const off = (event: HookEvent, callback: HookCallback) =>
-    getLogger().off(event, callback);
-export const use = (middleware: MiddlewareFn, priority?: number) =>
-    getLogger().use(middleware, priority);
-export const addTransport = (target: TransportTarget) =>
-    getLogger().addTransport(target);
-export const removeTransport = (id: string) =>
-    getLogger().removeTransport(id);
-export const flushTransports = () =>
-    getLogger().flushTransports();
-export const closeTransports = () =>
-    getLogger().closeTransports();
-
-// Scoped loggers
-export {
-    ScopedLogger,
-    APILogger,
-    ComponentLogger,
-    ContextLogger
-} from './ScopedLogger.js';
-
-// Constants
-export { DEFAULT_CONFIG } from './constants.js';
-
-// Utility exports
-export {
-    parseStackTrace,
-    formatTimestamp,
-    detectOptimalFormat,
-    createOutput,
-    createANSIOutput,
-    createBuildOutput,
-    createCIOutput
-} from './utils/index.js';
-
-// ANSI color utilities
-export {
-    ansiStyle,
-    ansiColor,
-    ansiBackground,
-    ansiBold,
-    ansiDim,
-    ansiUnderline,
-    formatLogLevelANSI,
-    formatSuccessANSI,
-    BUILD_FORMATTERS,
-    sanitizeEmojis
-} from './utils/ansi-colors.js';
-
-// Environment detection and presets
-export {
-    BUILD_PRESETS,
-    ENVIRONMENT_DETECTION,
-    detectEnvironmentPreset,
-    getOptimalConfig
-} from './constants.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(),
-};
-
-// Terminal formatting utilities
-export {
-    formatWithRightAlign,
-    formatColumns,
-    formatKeyValue,
-    formatBadge,
-    formatTimestamp as formatTimestampExt,
-    formatRelativeTime,
-    formatElapsedTime,
-    resetStartTime,
-    isKeyValueObject,
-    stripAnsi,
-    getVisibleLength,
-    padToWidth,
-    applyLogOptions,
-} from './terminal/formatter.js';
-
-// Color converter utilities
-export {
-    hexToRgb,
-    rgbToHex,
-    hexTo256,
-    colorToHex,
-    getANSIForeground,
-    getANSIBackground,
-    getANSI256Foreground,
-    getANSI256Background,
-    cssColorToANSI,
-    ANSI,
-} from './terminal/color-converter.js';
-
-export type { RGB, ColorCapability } from './terminal/color-converter.js';
-
-// Terminal renderer
-export { TerminalRenderer } from './terminal/terminal-renderer.js';
-export type { ANSIStyle, ChalkLikeInterface } from './terminal/terminal-renderer.js';
-
-// Environment detection
-export {
-    getEnvironment,
-    isRunningInTerminal,
-    supportsANSI,
-    getColorCapability,
-    getTerminalWidth,
-    getTerminalHeight,
-    getEnvironmentInfo,
-} from './utils/environment-detector.js';
-
-export type { Environment } from './utils/environment-detector.js';
-
-// Output writers for custom log destinations
-export { BufferWriter, type BufferEntry } from './writers/index.js';
-export type { OutputWriter, OutputMode } from './types/core.js';

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);
-}