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

package/dist/transports-module.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Entry point for ./transports subpath.
+ * Transport classes: FileTransport, HttpTransport, OtlpTransport, ConsoleTransport.
+ */
+export { TransportManager } from './transports/index.js';
+export { ConsoleTransport } from './transports/index.js';
+export { FileTransport, type FileTransportOptions } from './transports/index.js';
+export { HttpTransport, type HttpTransportOptions } from './transports/index.js';
+export { OtlpTransport, type OtlpTransportOptions } from './transports/index.js';
+//# sourceMappingURL=transports-module.d.ts.map

package/dist/transports-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports-module.d.ts","sourceRoot":"","sources":["../src/transports-module.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/transports.cjs

@@ -0,0 +1,7 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_transports = require("./chunks/transports-yK6CL0Ml.cjs");
+exports.ConsoleTransport = require_transports.ConsoleTransport;
+exports.FileTransport = require_transports.FileTransport;
+exports.HttpTransport = require_transports.HttpTransport;
+exports.OtlpTransport = require_transports.OtlpTransport;
+exports.TransportManager = require_transports.TransportManager;

package/dist/transports.js

@@ -0,0 +1,2 @@
+import { a as ConsoleTransport, i as FileTransport, n as OtlpTransport, r as HttpTransport, t as TransportManager } from "./chunks/transports-BGfwwakw.js";
+export { ConsoleTransport, FileTransport, HttpTransport, OtlpTransport, TransportManager };

package/dist/types/core.d.ts

@@ -1,12 +1,9 @@
 /**
- * @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)
+ * Niveles de log soportados en orden jerárquico
+ * (trace < debug < info < warn < error < critical)
  *
  * @constant {Object} LOG_LEVELS
+ * @property {number} trace - Nivel -1: Trazas muy verbosas (alineado con OTel TRACE severity 1-4)
  * @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
@@ -20,6 +17,7 @@
  * }
  */
 export declare const LOG_LEVELS: {
+    readonly trace: -1;
     readonly debug: 0;
     readonly info: 1;
     readonly warn: 2;
@@ -28,9 +26,21 @@ export declare const LOG_LEVELS: {
 };
 /**
  * Tipo de nivel de log derivado de las claves de LOG_LEVELS
- * @typedef {'debug' | 'info' | 'warn' | 'error' | 'critical'} LogLevel
+ * @typedef {'trace' | 'debug' | 'info' | 'warn' | 'error' | 'critical'} LogLevel
  */
 export type LogLevel = keyof typeof LOG_LEVELS;
+/**
+ * Tag especial de "nivel" usado por `success()` — mapea a severidad INFO de OTel.
+ * Vive fuera del union `LogLevel` estándar para que las comparaciones internas
+ * de nivel (trace < debug < info < warn < error < critical) no se vean alteradas.
+ */
+export declare const SUCCESS_LEVEL: "success";
+/**
+ * Tags aceptados por la familia `log()` y los métodos visuales (`success()`
+ * emite a severidad INFO pero usa styling de success). Útil para transports
+ * que necesitan distinguir "success" de logs info genéricos.
+ */
+export type LogTag = LogLevel | typeof SUCCESS_LEVEL;
 /**
  * Tipo de nivel de verbosidad para filtrar logs
  * @typedef {LogLevel | 'silent'} Verbosity
@@ -80,10 +90,75 @@ export type BannerType = 'simple' | 'ascii' | 'unicode' | 'svg' | 'animated';
  */
 export type ExportFormat = 'json' | 'csv' | 'markdown' | 'plain' | 'html';
 /**
- * Interfaz de configuración para instancias del logger
+ * 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';
+/**
+ * Modos de output para controlar dónde se escriben los logs.
+ * @typedef {'console' | 'silent' | 'custom'} OutputMode
  *
- * @interface LoggerConfig
- * @since 0.3.0
+ * @description
+ * - console: Output estándar vía `console.log` (default)
+ * - silent: Sin output
+ * - custom: Usa un `OutputWriter` custom para escenarios avanzados
+ */
+export type OutputMode = 'console' | 'silent' | 'custom';
+/**
+ * Interfaz de output writer custom para redirigir el output de logs.
+ *
+ * @interface OutputWriter
+ *
+ * @description
+ * Permite redirigir el output de logs a destinos custom como:
+ * - DraftLog para CLI spinners con logging concurrente
+ * - Buffers para colectar logs durante operaciones
+ * - Streams o transports custom
+ *
+ * @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;
+}
+/**
+ * Shape mínima de recurso OTel — duplicada aquí para evitar un import
+ * circular con `./transports.js`. El `ILogResource` canónico vive en
+ * `./transports.js`; ambos shapes se mantienen sincronizados vía el
+ * contrato público (service.name + version opcional + environment opcional).
+ */
+export interface ILogResourceRef {
+    'service.name': string;
+    'service.version'?: string;
+    'deployment.environment'?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Configuración de una instancia de `Logger`. Los campos booleanos activan
+ * o desactivan features visuales (colores, timestamps, stack traces); los
+ * campos selectores controlan tema, banner y formato de salida. Todos los
+ * campos son opcionales salvo `verbosity`, `enableColors` y
+ * `enableTimestamps`, que el constructor del logger rellena desde
+ * `DEFAULT_CONFIG` cuando no se proveen.
  *
  * @example
  * const config: LoggerConfig = {
@@ -108,6 +183,18 @@ export interface LoggerConfig {
     bannerType?: BannerType;
     bufferSize?: number;
     autoDetectTheme?: boolean;
+    outputFormat?: OutputFormat;
+    /** Modo de output: 'console' (default), 'silent' o 'custom'. */
+    outputMode?: OutputMode;
+    /** Writer custom cuando outputMode es 'custom'. */
+    outputWriter?: OutputWriter;
+    /** Nivel de verbosidad CLI para controlar el output primitivo. */
+    cliLevel?: CLILogLevel;
+    /**
+     * Recurso OTel por defecto adjuntado a cada record que no lo sobreescriba.
+     * Se setea una vez por proceso (service.name, service.version, deployment.environment).
+     */
+    resource?: Partial<ILogResourceRef>;
 }
 /**
  * Información parseada del stack trace
@@ -163,10 +250,11 @@ export interface AdaptiveColors {
  */
 export type SpacingType = 'compact' | 'normal' | 'spacious';
 /**
- * Configuración de layout para la estructura del log
+ * Layout de la línea de log: spacing entre elementos, padding interior,
+ * margen externo y separador entre partes. Lo consume el renderer para
+ * estructurar la salida visual.
  *
  * @interface LogLayout
- * @description Define cómo se organizan visualmente los elementos del log
  */
 export interface LogLayout {
     spacing: SpacingType;
@@ -175,10 +263,11 @@ export interface LogLayout {
     separator?: string;
 }
 /**
- * Configuración para partes individuales del log
+ * Estilo de un elemento individual del log (timestamp, level, prefix,
+ * mensaje, location). Cada campo es opcional y se aplica solo al elemento
+ * seleccionado sin tocar el resto de la línea.
  *
  * @interface LogPartConfig
- * @description Permite personalizar cada elemento del log por separado
  *
  * @example
  * const timestampConfig: LogPartConfig = {
@@ -202,11 +291,11 @@ export interface LogPartConfig {
     uppercase?: boolean;
 }
 /**
- * Configuración completa de estilos del log
+ * Estilos globales del log: layout, configuración por elemento (timestamp,
+ * level, prefix, mensaje, location) y props visuales de fondo (backdrop,
+ * transparency).
  *
  * @interface LogStyles
- * @description Agrupa todas las opciones de estilo en una sola configuración
- * @since 0.3.0
  */
 export interface LogStyles {
     layout?: LogLayout;
@@ -218,4 +307,193 @@ export interface LogStyles {
     backdrop?: string;
     transparency?: number;
 }
+/**
+ * Resultado de un timer completado. Lo retorna internamente `Logger.timeEnd`
+ * y lo pasan los hooks en `extra` para mediciones de rendimiento.
+ *
+ * @property label - Etiqueta con la que se registró el timer vía `time(label)`.
+ * @property duration - Milisegundos transcurridos entre `startTime` y `endTime`.
+ * @property startTime - Marca temporal de inicio (`performance.now()` o `Date.now()`).
+ * @property endTime - Marca temporal de fin.
+ */
+export interface TimerResult {
+    label: string;
+    duration: number;
+    startTime: number;
+    endTime: number;
+}
+/**
+ * Contrato del logger retornado por los factory de scope (`Logger.component`,
+ * `Logger.scope`). Expone los métodos de log por nivel más una API fluida
+ * para badges, timers y estilos.
+ *
+ * Los métodos de log (`debug`, `info`, ...) devuelven `void`; los métodos de
+ * configuración (`badges`, `badge`, `clearBadges`, `style`) devuelven `this`
+ * para permitir encadenamiento.
+ *
+ * @example
+ * const auth = logger.component('Auth');
+ * auth.badge('JWT').info('Token validado');
+ * auth.style('cyberpunk').success('Login OK');
+ */
+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;
+}
+/**
+ * Logger especializado para servicios API. Extiende {@link IScopedLogger} con
+ * verbosidades específicas de backend: latencia (`slow`), rate limiting
+ * (`rateLimit`), fallos de credenciales (`auth`) y endpoints legacy
+ * (`deprecated`).
+ */
+export interface IAPILogger extends IScopedLogger {
+    slow(message: string, duration?: number): void;
+    rateLimit(message: string): void;
+    auth(message: string): void;
+    deprecated(message: string): void;
+}
+/**
+ * Logger especializado para componentes UI. Extiende {@link IScopedLogger}
+ * con verbosidades de lifecycle: montaje/desmontaje (`lifecycle`), cambios
+ * de estado (`stateChange`) y diffs de props (`propsChange`). Útil para
+ * depurar re-renders y flujos de componentes sin inundar el log de ruido.
+ */
+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;
+}
+/**
+ * Bindings inmutables que viajan con un logger scoped/child. Definen la
+ * "identidad" del logger para filtrado, agrupación y atribución en
+ * transports. Se propagan a través de `child()` y se merguean al construir
+ * el {@link TransportRecord} que reciben los transports.
+ *
+ * @property scope - Etiqueta lógica del scope (p.ej. `"Auth"`, `"API:Users"`).
+ * @property badges - Lista de badges a renderizar junto al mensaje.
+ * @property type - Categoría del logger: `'scope'` (genérico), `'api'` (verbosidades HTTP), `'component'` (UI lifecycle).
+ * @property context - Cadena jerárquica de contexto (parent → child) para traces anidados.
+ */
+export interface Bindings {
+    scope?: string;
+    badges?: string[];
+    type?: 'scope' | 'api' | 'component';
+    context?: string[];
+}
+/**
+ * Estilo visual del wrapper de un badge.
+ *
+ * - `'brackets'` — `[badge]`
+ * - `'rounded'` — `(badge)`
+ * - `'plain'` — `badge` (sin wrapper)
+ * - `'unicode'` — `「badge」`
+ * - `'pill'` — badge con fondo redondeado estilo pill (CSS)
+ */
+export type BadgeStyle = 'brackets' | 'rounded' | 'plain' | 'unicode' | 'pill';
+/**
+ * Formato de renderizado del timestamp en la línea de log.
+ *
+ * - `'iso'` — `2026-07-05T12:34:56.789Z` (default, sortable)
+ * - `'time'` — `12:34:56`
+ * - `'timeMs'` — `12:34:56.789`
+ * - `'relative'` — tiempo relativo al momento de carga del logger
+ * - `'elapsed'` — `+1.2s` transcurrido desde el primer log de la sesión
+ * - `'date'` — `2026-07-05 12:34:56` (local)
+ * - `'custom'` — delega al formateador custom registrado en el logger
+ */
+export type TimestampFormat = 'iso' | 'time' | 'timeMs' | 'relative' | 'elapsed' | 'date' | 'custom';
+/**
+ * Alineación horizontal de una celda dentro de una columna de
+ * `Logger.cliTable`.
+ */
+export type ColumnAlign = 'left' | 'right' | 'center';
+/**
+ * Definición de una columna para `Logger.cliTable`. `content` es la fuente
+ * del valor (clave del row o string fijo); los demás campos controlan layout
+ * y color.
+ *
+ * @property content - Clave del row a renderizar, o string fijo para todas las filas.
+ * @property width - Ancho fijo en caracteres; si se omite, se auto-detecta del contenido.
+ * @property align - Alineación del contenido dentro de la celda.
+ * @property color - Color del texto (hex, nombre CSS o nombre ANSI).
+ */
+export interface ColumnConfig {
+    content: string;
+    width?: number;
+    align?: ColumnAlign;
+    color?: string;
+}
+/**
+ * Opciones de presentación aplicables a un log individual. Controlan layout
+ * multi-columna, ancho máximo, modo clave-valor, estilo de badge y formato
+ * de timestamp — todo sin alterar el `LoggerConfig` global del logger.
+ *
+ * @property rightAlign - Texto alineado a la derecha del mensaje principal (p.ej. duración).
+ * @property columns - Definición de columnas para modo tabla.
+ * @property maxWidth - Ancho máximo del mensaje antes de truncar/wrap.
+ * @property keyValue - Si `true`, renderiza los argumentos como `clave: valor`.
+ * @property badgeStyle - Override del estilo de badge para esta entrada.
+ * @property timestampFormat - Override del formato de timestamp para esta entrada.
+ */
+export interface LogOptions {
+    rightAlign?: string;
+    columns?: ColumnConfig[];
+    maxWidth?: number;
+    keyValue?: boolean;
+    badgeStyle?: BadgeStyle;
+    timestampFormat?: TimestampFormat;
+}
+/**
+ * Niveles de verbosidad CLI para controlar el output primitivo.
+ */
+export type CLILogLevel = 'silent' | 'quiet' | 'normal' | 'verbose' | 'debug';
+/**
+ * Handle retornado por `logger.spinner()` para controlar el ciclo de vida
+ * del spinner.
+ */
+export interface ISpinnerHandle {
+    /** Arranca la animación del spinner. */
+    start(): void;
+    /** Detiene el spinner sin mensaje de status. */
+    stop(): void;
+    /** Detiene el spinner con un mensaje de success. */
+    succeed(msg?: string): void;
+    /** Detiene el spinner con un mensaje de failure. */
+    fail(msg?: string): void;
+    /** Actualiza el texto del spinner mientras corre. */
+    text(msg: string): void;
+}
+/**
+ * Opciones para el output de `logger.box()`.
+ */
+export interface IBoxOptions {
+    /** Título mostrado en el borde superior. */
+    title?: string;
+    /** Color del borde (hex, nombre CSS o nombre ANSI). */
+    borderColor?: string;
+    /** Estilo de caracteres del borde. */
+    borderStyle?: 'single' | 'double' | 'rounded' | 'bold';
+    /** Líneas de padding interior (default: 0). */
+    padding?: number;
+}
+/**
+ * Opciones para el output de `logger.cliTable()`.
+ */
+export interface ITableOptions {
+    /** Nombres de columnas a mostrar (sobreescribe la auto-detección). */
+    columns?: string[];
+    /** Labels del header (default: nombres de columnas). */
+    head?: string[];
+}
 //# sourceMappingURL=core.d.ts.map

package/dist/types/core.d.ts.map

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

package/dist/types/handlers.d.ts

@@ -18,71 +18,4 @@ export interface LogMetadata {
 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;
-    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;
-    oldestLog?: Date;
-    newestLog?: Date;
-    levelCounts: Record<LogLevel, number>;
-}
 //# sourceMappingURL=handlers.d.ts.map

package/dist/types/handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/types/handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CACtF;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,OAAO,CAAC,EAAE,aAAa,CAAC;KAC3B,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;CACzC"}
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/types/handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CACtF"}

package/dist/types/hooks.d.ts

@@ -0,0 +1,138 @@
+import type { LogLevel, StackInfo } from './core.js';
+/**
+ * Payload que recibe cada callback de hook. Los hooks pueden devolver un
+ * partial de este objeto para sobreescribir campos individuales; el manager
+ * mergea el resultado de vuelta a la cadena del entry.
+ */
+export interface HookLogEntry {
+    level: LogLevel;
+    message: string;
+    args: unknown[];
+    timestamp: string;
+    prefix?: string;
+    stackInfo?: StackInfo;
+    correlationId?: string;
+    context?: Record<string, unknown>;
+    /**
+     * Evento de hook de origen cuando se emite desde un path de fallo interno
+     * (p.ej. error de flush en transport → dispara `onError` con `hookEvent: 'beforeLog'`).
+     */
+    hookEvent?: HookEvent;
+    /** Excepción capturada, si el hook se disparó por un error lanzado. */
+    error?: Error;
+    /**
+     * Payload estructurado específico del hook. Lo usan los transports para
+     * exponer records dropeados, response codes, retry counts, etc.
+     */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Eventos de hook que el {@link IHookManager} despacha en el pipeline de log.
+ *
+ * - `'beforeLog'` — antes de despachar el log a transports/handlers. El
+ *   callback puede mutar o reemplazar campos del {@link HookLogEntry} y el
+ *   resultado se propaga a los siguientes hooks y al log final.
+ * - `'afterLog'` — después de que el log se ha escrito. Solo efectivo para
+ *   side-effects (métricas, telemetría); mutar el entry aquí no cambia el
+ *   output ya emitido.
+ * - `'onError'` — cuando un transport o un hook lanza, o cuando un batch
+ *   agota reintentos. El callback recibe `entry.error` (la excepción) y
+ *   `entry.extra` (payload estructurado: dropped, status, retryCount, ...).
+ */
+export type HookEvent = 'beforeLog' | 'afterLog' | 'onError';
+/**
+ * Firma del callback de hook. Los hooks async se awaitan en orden de prioridad;
+ * devolver un partial object sobreescribe los campos del entry para los hooks
+ * siguientes y para la llamada final al log.
+ */
+export type HookCallback = (entry: HookLogEntry) => void | Partial<HookLogEntry> | Promise<void | Partial<HookLogEntry>>;
+/**
+ * Middleware estilo Koa para el pipeline de hooks.
+ *
+ * Recibe el {@link HookLogEntry} y una función `next()` que invoca al
+ * siguiente middleware en la cadena de prioridad. Si el middleware NO llama
+ * `next()`, corta la cadena y el log se descarta (útil para filtrado
+ * avanzado, sampling o redacción que decide no emitir).
+ *
+ * Se registra vía {@link IHookManager.use} y corre antes que cualquier
+ * callback de evento {@link HookEvent}, lo que lo hace ideal para
+ * cross-cutting concerns: correlación de trazas, redacción de PII,
+ * enriquecimiento con atributos globales, etc.
+ *
+ * @example
+ * // Descarta logs marcados como privados
+ * const privacyFilter: MiddlewareFn = (entry, next) => {
+ *   if (entry.context?.private === true) return; // no llama next() → se descarta
+ *   return next();
+ * };
+ */
+export type MiddlewareFn = (entry: HookLogEntry, next: () => void | Promise<void>) => void | Promise<void>;
+/**
+ * Registro interno de un callback de hook suscrito a un {@link HookEvent}.
+ *
+ * El manager construye este record al registrar un callback vía `on()` /
+ * `once()`; los usuarios normalmente no instancian este tipo directamente.
+ * Útil para inspección del estado del manager en tests y depuración.
+ *
+ * @property id - Identificador único asignado por el manager (usado por el unsubscribe handle).
+ * @property event - Evento al que está suscrito el callback.
+ * @property callback - Función invocada cuando se emite el evento.
+ * @property priority - Orden de ejecución (mayor = antes). Empates respetan orden de registro.
+ * @property once - Si `true`, el manager lo des-registra tras la primera invocación.
+ */
+export interface HookRegistration {
+    id: string;
+    event: HookEvent;
+    callback: HookCallback;
+    priority: number;
+    once: boolean;
+}
+/**
+ * Registro interno de un middleware en la cadena del manager. Análogo a
+ * {@link HookRegistration} pero para la capa de {@link MiddlewareFn}, que
+ * corre antes que los callbacks de evento.
+ *
+ * @property id - Identificador único asignado por el manager.
+ * @property fn - Middleware registrado vía `use()`.
+ * @property priority - Orden dentro de la cadena (mayor = más al inicio).
+ */
+export interface MiddlewareRegistration {
+    id: string;
+    fn: MiddlewareFn;
+    priority: number;
+}
+/**
+ * Contrato del manager de hooks.
+ *
+ * Orquesta el pipeline de middleware + eventos que envuelve cada llamada a
+ * `log()`. Permite suscribirse a puntos del ciclo de vida del log
+ * (`beforeLog`, `afterLog`, `onError`), transformar el {@link HookLogEntry}
+ * en vuelo, y registrar middleware estilo Koa para cross-cutting concerns
+ * (sampling, redacción de PII, enriquecimiento con correlación).
+ *
+ * Los métodos `on` / `once` / `use` devuelven una función de unsubscribe
+ * (patrón `Disposable`) para limpieza explícita — llamarla remueve el
+ * registro sin necesidad de pasar el callback original.
+ *
+ * @example
+ * const hooks: IHookManager = createManager();
+ * // Redacta campos sensibles antes de loguear
+ * hooks.on('beforeLog', (entry) => {
+ *   if (entry.context?.password) {
+ *     return { context: { ...entry.context, password: '***' } };
+ *   }
+ * });
+ * // Métricas de error de transport
+ * hooks.on('onError', async (entry) => {
+ *   metrics.increment('log.transport.error');
+ * });
+ */
+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>;
+}
+//# sourceMappingURL=hooks.d.ts.map

package/dist/types/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/types/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,uEAAuE;IACvE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;AAEzH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,YAAY,GAAG,CACvB,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,gBAAgB;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,YAAY,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,YAAY;IACzB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC5E,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC9E,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC;IACvD,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAAC;IAC7D,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnE,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACvD"}

package/dist/types/index.d.ts

@@ -1,7 +1,11 @@
 /**
  * @fileoverview Type definitions exports for Advanced Logger
  */
-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';
-export type { LogMetadata, ILogHandler, LogEntry, ExportFilters, ExportOptions, ExportResult, BufferStats, } from './handlers.js';
+export type { LogLevel, LogTag, Verbosity, ThemeVariant, DevToolsTheme, BannerType, OutputFormat, LoggerConfig, StackInfo, TimerEntry, TimerResult, StyleOptions, AdaptiveColors, SpacingType, LogLayout, LogPartConfig, LogStyles, IScopedLogger, IAPILogger, IComponentLogger, Bindings, BadgeStyle, TimestampFormat, ColumnAlign, ColumnConfig, LogOptions, CLILogLevel, ISpinnerHandle, IBoxOptions, ITableOptions, ILogResourceRef, } from './core.js';
+export { LOG_LEVELS, SUCCESS_LEVEL } from './core.js';
+export type { LogMetadata, ILogHandler, } from './handlers.js';
+export type { SerializerFn, SerializerContext, SerializerEntry, SerializerConfig, ISerializerRegistry, } from './serializers.js';
+export type { HookLogEntry, HookEvent, HookCallback, MiddlewareFn, HookRegistration, MiddlewareRegistration, IHookManager, } from './hooks.js';
+export type { TransportRecord, TransportOptions, TransportTarget, ITransport, IBufferedTransport, ITransportManager, ILogResource, ILogAttributes, LogAttributeValue, } from './transports.js';
+export { LOG_LEVEL_TO_SEVERITY_NUMBER, LOG_LEVEL_TO_SEVERITY_TEXT, } from './transports.js';
 //# sourceMappingURL=index.d.ts.map