@mks2508/better-logger 5.0.1 → 5.0.2

package/dist/index.d.ts

@@ -0,0 +1,161 @@
+import { Logger } from './Logger.js';
+import { Verbosity, ThemeVariant, BannerType, StyleOptions, ILogHandler, CLILogLevel, IBoxOptions, ITableOptions, SerializerFn, HookEvent, HookCallback, MiddlewareFn, TransportTarget } from './types/index.js';
+import { StyleBuilder } from './styling/index.js';
+/**
+ * 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');
+ */
+declare const _default: Logger;
+export default _default;
+/**
+ * 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 declare const debug: (...args: any[]) => void;
+export declare const info: (...args: any[]) => void;
+export declare const warn: (...args: any[]) => void;
+export declare const error: (...args: any[]) => void;
+export declare const success: (...args: any[]) => void;
+export declare const critical: (...args: any[]) => void;
+export declare const trace: (...args: any[]) => void;
+export declare const table: (data: any, columns?: string[]) => void;
+export declare const group: (label: string, collapsed?: boolean) => void;
+export declare const groupEnd: () => void;
+export declare const time: (label: string) => void;
+export declare const timeEnd: (label: string) => number;
+export declare const setGlobalPrefix: (prefix: string) => void;
+export declare const scope: (name: string) => import('./ScopedLogger.js').ScopedLogger;
+export declare const component: (name: string) => import('./ScopedLogger.js').ComponentLogger;
+export declare const api: (name: string) => import('./ScopedLogger.js').APILogger;
+export declare const badges: (badgeList: string[]) => Logger;
+export declare const badge: (badgeName: string) => Logger;
+export declare const clearBadges: () => Logger;
+export declare const setVerbosity: (level: Verbosity) => void;
+export declare const addHandler: (handler: ILogHandler) => void;
+export declare const setTheme: (theme: ThemeVariant) => void;
+export declare const setBannerType: (bannerType: BannerType) => void;
+export declare const showBanner: (bannerType?: BannerType) => void;
+export declare const logWithSVG: (message: string, svgContent?: string, options?: StyleOptions) => void;
+export declare const logAnimated: (message: string, duration?: number) => void;
+export declare const cli: (command: string) => Promise<void>;
+export declare const step: (current: number, total: number, message: string) => void;
+export declare const spinner: (message: string) => import('./types/core.js').ISpinnerHandle;
+export declare const box: (content: string, options?: IBoxOptions) => void;
+export declare const cliTable: (rows: Record<string, unknown>[], options?: ITableOptions) => void;
+export declare const header: (title: string, subtitle?: string) => void;
+export declare const divider: () => void;
+export declare const blank: () => void;
+export declare const setCLILevel: (level: CLILogLevel) => void;
+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';
+export { StyleBuilder, StylePresets, THEME_PRESETS, THEME_BANNERS, BANNER_VARIANTS } from './styling/index.js';
+export { FileLogHandler, RemoteLogHandler, AnalyticsLogHandler } from './handlers/index.js';
+export { SerializerRegistry } from './serializers/index.js';
+export { HookManager } from './hooks/index.js';
+export { TransportManager, ConsoleTransport, FileTransport, HttpTransport } from './transports/index.js';
+export { StyleCache, getStyleCache } from './styling/StyleCache.js';
+export declare const addSerializer: <T>(type: new (...args: any[]) => T, serializer: SerializerFn<T>, priority?: number) => void;
+export declare const removeSerializer: <T>(type: new (...args: any[]) => T) => boolean;
+export declare const on: (event: HookEvent, callback: HookCallback, priority?: number) => () => void;
+export declare const once: (event: HookEvent, callback: HookCallback, priority?: number) => () => void;
+export declare const off: (event: HookEvent, callback: HookCallback) => boolean;
+export declare const use: (middleware: MiddlewareFn, priority?: number) => () => void;
+export declare const addTransport: (target: TransportTarget) => string;
+export declare const removeTransport: (id: string) => boolean;
+export declare const flushTransports: () => Promise<void>;
+export declare const closeTransports: () => Promise<void>;
+export { ScopedLogger, APILogger, ComponentLogger, ContextLogger } from './ScopedLogger.js';
+export { DEFAULT_CONFIG } from './constants.js';
+export { parseStackTrace, formatTimestamp, detectOptimalFormat, createOutput, createANSIOutput, createBuildOutput, createCIOutput } from './utils/index.js';
+export { ansiStyle, ansiColor, ansiBackground, ansiBold, ansiDim, ansiUnderline, formatLogLevelANSI, formatSuccessANSI, BUILD_FORMATTERS, sanitizeEmojis } from './utils/ansi-colors.js';
+export { BUILD_PRESETS, ENVIRONMENT_DETECTION, detectEnvironmentPreset, getOptimalConfig } from './constants.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 declare const createStyle: () => 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 declare const stylePresets: {
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+    accent: string;
+};
+export { formatWithRightAlign, formatColumns, formatKeyValue, formatBadge, formatTimestamp as formatTimestampExt, formatRelativeTime, formatElapsedTime, resetStartTime, isKeyValueObject, stripAnsi, getVisibleLength, padToWidth, applyLogOptions, } from './terminal/formatter.js';
+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';
+export { TerminalRenderer } from './terminal/terminal-renderer.js';
+export type { ANSIStyle, ChalkLikeInterface } from './terminal/terminal-renderer.js';
+export { getEnvironment, isRunningInTerminal, supportsANSI, getColorCapability, getTerminalWidth, getTerminalHeight, getEnvironmentInfo, } from './utils/environment-detector.js';
+export type { Environment } from './utils/environment-detector.js';
+export { BufferWriter, type BufferEntry } from './writers/index.js';
+export type { OutputWriter, OutputMode } from './types/core.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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