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

package/dist/Logger.d.ts

@@ -4,7 +4,7 @@
  * Sistema de logging profesional con estilos CSS avanzados, temas adaptativos,
  * badges automáticos, contextos temporales y exportación de datos.
  */
-import type { LogLevel, LogTag, Verbosity, ThemeVariant, BannerType, LoggerConfig, ILogHandler, StyleOptions, Bindings, SerializerFn, HookEvent, HookCallback, MiddlewareFn, TransportTarget, TransportRecord, ILogResourceRef, StackInfo } from './types/index.js';
+import type { LogLevel, LogTag, Verbosity, ThemeVariant, BannerType, LoggerConfig, ILogHandler, StyleOptions, Bindings, SerializerFn, HookEvent, HookCallback, MiddlewareFn, TransportTarget, TransportRecord, ILogResourceRef, StackInfo, Span, SpanAttributes } from './types/index.js';
 import { SerializerRegistry } from './serializers/index.js';
 import { HookManager } from './hooks/index.js';
 import { TransportManager } from './transports/index.js';
@@ -648,14 +648,18 @@ export declare class Logger {
      */
     removeTransport(id: string): boolean;
     /**
-     * Fuerza el flush de todos los transports
+     * Fuerza el flush de todos los transports. Antes de flushear, cierra los
+     * spans aún abiertos (`incomplete: true`) y los encola para export — un
+     * span abierto nunca se tira en un flush.
      *
      * @returns Promise que resuelve cuando todos los buffers están vaciados
      *
      */
     flushTransports(): Promise<void>;
     /**
-     * Cierra todos los transports
+     * Cierra todos los transports. Como en {@link flushTransports}, primero
+     * fuerza el cierre de los spans abiertos para que viajen en el flush
+     * final del close.
      *
      * @returns Promise que resuelve cuando todos están cerrados
      *
@@ -856,6 +860,98 @@ export declare class Logger {
      *
      */
     critical(...args: unknown[]): Promise<void>;
+    /**
+     * Emite un **point-span**: un span con `start = end` para completion
+     * signals y eventos puntuales (una operación instantánea, un hito).
+     * No registra contexto activo ni puede leakear — se exporta de inmediato.
+     *
+     * El nombre `event` (y no `trace`) es deliberado: `trace` es un log level
+     * (el -1) y está reservado.
+     *
+     * @param {string} name - Nombre del evento (`job.completed`, `cache.flushed`, ...).
+     * @param {SpanAttributes} [attributes] - Attributes del span.
+     *
+     * @example
+     * logger.event('build.finished', { status: 'ok', durationMs: 4200 });
+     *
+     * @see {@link span} para intervalos con work-block
+     * @see {@link startSpan} para intervalos externally-ended
+     */
+    event(name: string, attributes?: SpanAttributes): void;
+    /**
+     * Ejecuta `fn` dentro de un span de intervalo. El span queda **activo en
+     * el AsyncLocalStorage del módulo** mientras `fn` corre: los logs emitidos
+     * dentro heredan su `traceId`/`spanId`, y los spans hijos lo toman como
+     * `parentSpanId`.
+     *
+     * Al retornar `fn` el span se cierra automáticamente; si `fn` lanza, se
+     * marca `status {code: 2}` con el mensaje del error (`fail`) y la
+     * excepción se relanza intacta.
+     *
+     * @typeParam T - Tipo resuelto por `fn`.
+     * @param {string} name - Nombre de la operación.
+     * @param {(s: Span) => T | Promise<T>} fn - Work-block a medir.
+     * @returns {Promise<T>} Lo que resuelve `fn`.
+     * @throws {unknown} Relanza cualquier error de `fn` tras marcar el span fallido.
+     *
+     * @example
+     * await logger.span('db.migrate', { target: 'v2' }, async (s) => {
+     *   await runMigrations();
+     *   s.set('tables', 14);
+     * });
+     *
+     * @see {@link event} para point-spans
+     * @see {@link startSpan} para spans externally-ended (poll/callback)
+     */
+    span<T>(name: string, fn: (s: Span) => T | Promise<T>): Promise<T>;
+    span<T>(name: string, attributes: SpanAttributes, fn: (s: Span) => T | Promise<T>): Promise<T>;
+    /**
+     * Inicia un span de intervalo **externally-ended**: devuelve el handle y
+     * NO fija contexto ALS (el cierre ocurre fuera del bloque léxico — p.ej.
+     * un `cli.spawn` que se cierra desde un poll o callback externo).
+     *
+     * Si el span no se cierra antes de `flushTransports()` / shutdown, el
+     * flush lo fuerza a cerrar con `incomplete: true` y lo exporta — nunca
+     * se tira.
+     *
+     * @param {string} name - Nombre de la operación.
+     * @param {SpanAttributes} [attributes] - Attributes iniciales.
+     * @returns {Span} Handle con `set`/`end`/`fail` y los ids del span.
+     *
+     * @example
+     * const s = logger.startSpan('spawn.build', { cmd: 'make' });
+     * proc.on('exit', code => {
+     *   if (code === 0) s.end({ exitCode: code });
+     *   else s.fail(new Error(`exit ${code}`));
+     * });
+     *
+     * @see {@link span} para el caso con work-block
+     */
+    startSpan(name: string, attributes?: SpanAttributes): Span;
+    /**
+     * Scope por defecto de los spans emitidos por este logger (el
+     * `globalPrefix`, o `'root'`).
+     * @internal
+     */
+    _spanScopeName(): string;
+    /**
+     * Emite un point-span con scope explícito. Lo consume
+     * {@link ScopedLogger.event}, que pasa su scope compuesto.
+     * @internal
+     */
+    _emitSpanEvent(name: string, attributes: SpanAttributes | undefined, scope: string): void;
+    /**
+     * Crea un span externally-ended con scope explícito. Lo consume
+     * {@link ScopedLogger.startSpan}.
+     * @internal
+     */
+    _startSpan(name: string, attributes: SpanAttributes | undefined, scope: string): Span;
+    /**
+     * Corre `fn` dentro de un span activo en el ALS con scope explícito.
+     * Lo consume {@link ScopedLogger.span}.
+     * @internal
+     */
+    _runSpan<T>(name: string, attributes: SpanAttributes | undefined, scope: string, fn: (s: Span) => T | Promise<T>): Promise<T>;
     /**
      * Muestra datos en formato de tabla. Pasa por la pipeline completa
      * (outputMode-respecting writeOutput + transports + hooks).
@@ -1110,6 +1206,16 @@ export declare function resetDefaultLogger(): void;
  */
 declare const loggerProxy: Logger;
 export default loggerProxy;
+/**
+ * Resuelve los argumentos del overload `span(name, fn?)` /
+ * `span(name, attributes, fn)` a `{ attributes, fn }`.
+ *
+ * @internal Compartido con `ScopedLogger.span`; no es API pública.
+ */
+export declare function resolveSpanArgs<T>(fnOrAttributes: ((s: Span) => T | Promise<T>) | SpanAttributes, maybeFn?: (s: Span) => T | Promise<T>): {
+    attributes: SpanAttributes | undefined;
+    fn: (s: Span) => T | Promise<T>;
+};
 /**
  * Métodos individuales exportados para conveniencia
  * @description Todos los métodos están correctamente enlazados al singleton lazy
@@ -1126,6 +1232,10 @@ 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 event: (name: string, attributes?: SpanAttributes) => void;
+export declare const startSpan: (name: string, attributes?: SpanAttributes) => Span;
+export declare function span<T>(name: string, fn: (s: Span) => T | Promise<T>): Promise<T>;
+export declare function span<T>(name: string, attributes: SpanAttributes, fn: (s: Span) => T | Promise<T>): Promise<T>;
 export declare const setGlobalPrefix: (prefix: string) => void;
 export declare const setVerbosity: (level: Verbosity) => void;
 export declare const addHandler: (handler: ILogHandler) => void;

package/dist/Logger.d.ts.map

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

package/dist/ScopedLogger.d.ts

@@ -1,5 +1,5 @@
 import { Logger } from './Logger.js';
-import type { ISpinnerHandle, IBoxOptions, ITableOptions, CLILogLevel } from './types/index.js';
+import type { ISpinnerHandle, IBoxOptions, ITableOptions, CLILogLevel, Span, SpanAttributes } from './types/index.js';
 /**
  * Logger prefijado por un scope nominal. Mantiene su propio stack de badges
  * y contextos y delega el envío de mensajes al {@link Logger} padre a través
@@ -220,6 +220,43 @@ export declare class ScopedLogger {
      * logger.scope('NET').trace('packet', { bytes });
      */
     trace(...args: unknown[]): void;
+    /**
+     * Emite un point-span con el scope de este logger como
+     * `SpanRecord.scope`. Ver {@link Logger.event}.
+     *
+     * @param {string} name - Nombre del evento.
+     * @param {SpanAttributes} [attributes] - Attributes del span.
+     *
+     * @example
+     * logger.scope('BUILD').event('step.done', { step: 'compile' });
+     */
+    event(name: string, attributes?: SpanAttributes): void;
+    /**
+     * Ejecuta `fn` dentro de un span activo etiquetado con el scope de este
+     * logger. Los logs dentro de `fn` correlacionan con el span vía
+     * `traceId`/`spanId`. Ver {@link Logger.span}.
+     *
+     * @typeParam T - Tipo resuelto por `fn`.
+     * @param {string} name - Nombre de la operación.
+     * @param {(s: Span) => T | Promise<T>} fn - Work-block a medir.
+     * @returns {Promise<T>} Lo que resuelve `fn`.
+     *
+     * @example
+     * await logger.scope('DB').span('migrate', async (s) => {
+     *   await runMigrations();
+     * });
+     */
+    span<T>(name: string, fn: (s: Span) => T | Promise<T>): Promise<T>;
+    span<T>(name: string, attributes: SpanAttributes, fn: (s: Span) => T | Promise<T>): Promise<T>;
+    /**
+     * Inicia un span externally-ended etiquetado con el scope de este
+     * logger. Ver {@link Logger.startSpan}.
+     *
+     * @param {string} name - Nombre de la operación.
+     * @param {SpanAttributes} [attributes] - Attributes iniciales.
+     * @returns {Span} Handle con `set`/`end`/`fail`.
+     */
+    startSpan(name: string, attributes?: SpanAttributes): Span;
     /**
      * Delegación a {@link Logger.step}: dibuja una barra de progreso discreta
      * `current/total` para este scope.

package/dist/ScopedLogger.d.ts.map

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

package/dist/chunks/LogContext-DZasm_P5.cjs

@@ -0,0 +1,141 @@
+//#region src/utils/asyncLocalStorage.ts
+/**
+* Resuelve `AsyncLocalStorage` por capas:
+*   1. global `AsyncLocalStorage` (runtimes/polyfills que lo exponen),
+*   2. `process.getBuiltinModule('async_hooks')` (Node >= 22.3, Bun),
+*   3. `require('node:async_hooks')` (CJS interop),
+*   4. `undefined` → browser estricto: sin correlación (degradación
+*      documentada; el caller decide qué hacer sin ALS).
+*
+* Nota: NO basta con `typeof AsyncLocalStorage !== 'undefined'` — en Node y
+* Bun el constructor NO es global y hay que ir a `node:async_hooks`.
+*/
+function resolveAsyncLocalStorage() {
+	const globalCtor = globalThis.AsyncLocalStorage;
+	if (typeof globalCtor === "function") return new globalCtor();
+	const proc = globalThis;
+	try {
+		const asyncHooks = proc.process?.getBuiltinModule?.("async_hooks");
+		if (asyncHooks?.AsyncLocalStorage) return new asyncHooks.AsyncLocalStorage();
+	} catch {}
+	try {
+		if (typeof require === "function") {
+			const asyncHooks = require("node:async_hooks");
+			if (asyncHooks?.AsyncLocalStorage) return new asyncHooks.AsyncLocalStorage();
+		}
+	} catch {}
+}
+//#endregion
+//#region src/context/LogContext.ts
+const alsInstance = resolveAsyncLocalStorage();
+/**
+* Factory que crea una instancia de {@link LogContext}.
+*
+* @param options - Configuración (ver {@link ILogContextOptions})
+* @returns Una instancia de LogContext lista para usar
+*
+* @example
+* const logContext = createLogContext({
+*   childLoggerFactory: (cfg) => new Logger(cfg),
+*   initialContext: { service: 'orders-api' },
+*   initialResource: { serviceName: 'orders-api', environment: 'prod' }
+* });
+*
+* // Child inmutable con contexto persistente
+* const requestLog = logContext.child({ requestId: 'abc-123' });
+*
+* // Scope transitorio vía ALS (Node; en browser sin ALS es no-op)
+* logContext.withContext({ traceId: 't-9' }, () => {
+*   requestLog.info('procesando orden');
+* });
+*/
+function createLogContext(options) {
+	let context = { ...options.initialContext };
+	let resource = options.initialResource ? { ...options.initialResource } : void 0;
+	const als = options.alsInstance ?? alsInstance;
+	return {
+		getContext() {
+			return { ...context };
+		},
+		withContext(bindings, fn) {
+			if (!als) {
+				if (fn) return fn();
+				return;
+			}
+			if (!fn) return void 0;
+			const merged = {
+				...context,
+				...als.getStore(),
+				...bindings
+			};
+			return als.run(merged, fn);
+		},
+		async withContextAsync(bindings, fn) {
+			if (!als) return fn();
+			const merged = {
+				...context,
+				...als.getStore(),
+				...bindings
+			};
+			return als.run(merged, fn);
+		},
+		clearContext() {
+			context = {};
+			return this;
+		},
+		setResource(res) {
+			resource = {
+				...resource,
+				...res
+			};
+			return this;
+		},
+		child(_extra) {
+			const snapshot = this._getBaseContextRecord();
+			const childLogger = options.childLoggerFactory({});
+			childLogger["__parentSnapshot"] = snapshot;
+			return childLogger;
+		},
+		_getContextRecord() {
+			const base = this._getBaseContextRecord();
+			const alsContext = als?.getStore();
+			if (alsContext && Object.keys(alsContext).length > 0) return {
+				...base,
+				...alsContext
+			};
+			return base;
+		},
+		_getBaseContextRecord() {
+			let base = {};
+			const parentRecord = options.getParentContextRecord?.() ?? null;
+			if (parentRecord && Object.keys(parentRecord).length > 0) base = parentRecord;
+			else if (Object.keys(context).length > 0) base = context;
+			if (Object.keys(context).length > 0) base = {
+				...base,
+				...context
+			};
+			return base;
+		},
+		_getResource() {
+			return resource;
+		},
+		_getAlsStore() {
+			return als?.getStore();
+		}
+	};
+}
+//#endregion
+Object.defineProperty(exports, "createLogContext", {
+	enumerable: true,
+	get: function() {
+		return createLogContext;
+	}
+});
+Object.defineProperty(exports, "resolveAsyncLocalStorage", {
+	enumerable: true,
+	get: function() {
+		return resolveAsyncLocalStorage;
+	}
+});
+
+//# sourceMappingURL=LogContext-DZasm_P5.cjs.map

package/dist/chunks/LogContext-DZasm_P5.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContext-DZasm_P5.cjs","names":[],"sources":["../../src/utils/asyncLocalStorage.ts","../../src/context/LogContext.ts"],"sourcesContent":["/**\n * @fileoverview Resolución compartida de `AsyncLocalStorage` — utilidad\n * interna, NO exportada por el barrel público (`src/utils/index.ts`).\n *\n * Único punto de verdad para resolver `node:async_hooks` por capas. Lo\n * consumen tanto `transports/SpanRuntime.ts` (ALS singleton de spans) como\n * `context/LogContext.ts` (ALS singleton de MDC). Antes había dos copias de\n * este conocimiento: una acertaba (SpanRuntime, la que sigue este archivo) y\n * otra usaba `typeof AsyncLocalStorage !== 'undefined'` — un feature-detect\n * roto, porque en Node y Bun el constructor NO es global, así que esa rama\n * quedaba siempre en `undefined` y el MDC de logs era no-op silencioso fuera\n * del browser.\n */\n\n/**\n * Forma mínima de `AsyncLocalStorage<T>` que necesita este paquete.\n */\nexport interface AsyncLocalStorageLike<T> {\n    run<R>(store: T, fn: () => R): R;\n    getStore(): T | undefined;\n}\n\n/**\n * Resuelve `AsyncLocalStorage` por capas:\n *   1. global `AsyncLocalStorage` (runtimes/polyfills que lo exponen),\n *   2. `process.getBuiltinModule('async_hooks')` (Node >= 22.3, Bun),\n *   3. `require('node:async_hooks')` (CJS interop),\n *   4. `undefined` → browser estricto: sin correlación (degradación\n *      documentada; el caller decide qué hacer sin ALS).\n *\n * Nota: NO basta con `typeof AsyncLocalStorage !== 'undefined'` — en Node y\n * Bun el constructor NO es global y hay que ir a `node:async_hooks`.\n */\nexport function resolveAsyncLocalStorage<T>(): AsyncLocalStorageLike<T> | undefined {\n    const globalCtor = (globalThis as { AsyncLocalStorage?: new () => AsyncLocalStorageLike<T> }).AsyncLocalStorage;\n    if (typeof globalCtor === 'function') {\n        return new globalCtor();\n    }\n\n    const proc = globalThis as {\n        process?: {\n            getBuiltinModule?: (id: string) => { AsyncLocalStorage?: new () => AsyncLocalStorageLike<T> } | undefined;\n        };\n    };\n    try {\n        const asyncHooks = proc.process?.getBuiltinModule?.('async_hooks');\n        if (asyncHooks?.AsyncLocalStorage) {\n            return new asyncHooks.AsyncLocalStorage();\n        }\n    } catch {\n        // getBuiltinModule no disponible — siguiente capa\n    }\n\n    try {\n        if (typeof require === 'function') {\n            // eslint-disable-next-line @typescript-eslint/no-require-imports\n            const asyncHooks = require('node:async_hooks') as { AsyncLocalStorage?: new () => AsyncLocalStorageLike<T> };\n            if (asyncHooks?.AsyncLocalStorage) {\n                return new asyncHooks.AsyncLocalStorage();\n            }\n        }\n    } catch {\n        // ESM puro sin require ni builtin accessor — browser\n    }\n\n    return undefined;\n}\n","/**\n * @fileoverview Bridge de LogContext — gestión de MDC (Mapped Diagnostic Context).\n *\n * Encapsula el contexto estructurado por logger, la creación de child loggers y\n * el merge de resource OTel en cada record emitido.\n *\n * Modelo de API:\n * - `withContext(bindings, fn?)` — si se pasa `fn`, lo ejecuta dentro de un\n *   scope de AsyncLocalStorage mergeando `bindings`. Sin `fn`: no-op (shim de\n *   backwards compat para la vieja forma de setter).\n * - `withContextAsync(bindings, fn)` — variante async callback.\n * - `child(bindings)` — inmutable (patrón canónico de MDC).\n * - Feature-detect de AsyncLocalStorage; en browser sin ALS es no-op.\n */\n\nimport type { ILogResourceRef } from '../types/index.js';\nimport type { LoggerConfig } from '../types/index.js';\nimport { resolveAsyncLocalStorage, type AsyncLocalStorageLike } from '../utils/asyncLocalStorage.js';\n\n/**\n * Snapshot del contexto bound. Lo retorna {@link LogContext.getContext}.\n *\n * Es `Readonly` para marcar contractually que el objeto devuelto es una shallow\n * copy: mutarlo no afecta a los records que emitan futuras llamadas de log.\n */\nexport type ContextSnapshot = Readonly<Record<string, unknown>>;\n\n/**\n * Tipo de la factory function para crear instancias child de Logger.\n *\n * Se inyecta en LogContext para que `child()` pueda instanciar nuevos loggers\n * sin introducir un import circular entre `Logger.ts` y `LogContext.ts`.\n * Retorna `unknown` — la clase Logger concreta la maneja el caller, y la\n * instancia devuelta tiene su campo `context` escrito por LogContext tras la\n * creación.\n */\nexport type ChildLoggerFactory = (config: Partial<LoggerConfig>) => unknown;\n\n/**\n * Shape mínima de una instancia de Logger que LogContext necesita ver.\n *\n * Evita dependencias circulares entre LogContext y Logger. El campo\n * `_parentContextRecord` lo setea el Logger padre después de que\n * `LogContext.child()` retorna, estableciendo la cadena de contextos.\n */\nexport interface ChildLoggerShape {\n    _parentContextRecord?: Record<string, unknown>;\n    /** Campo legacy — ya no es la fuente canónica del contexto. */\n    context?: Record<string, unknown>;\n}\n\n/**\n * Options que se pasan a {@link createLogContext}.\n */\nexport interface ILogContextOptions {\n    /** Pares key-value iniciales del contexto. */\n    initialContext?: Record<string, unknown>;\n    /** Factory para crear instancias child de logger. */\n    childLoggerFactory: ChildLoggerFactory;\n    /** Resource OTel inicial a mergear en cada record emitido. */\n    initialResource?: Partial<ILogResourceRef>;\n    /**\n     * Retorna el record de contexto mergeado del logger padre en el momento\n     * de creación del child. Lo usa `_getContextRecord()` para construir la\n     * cadena de contextos.\n     * @internal\n     */\n    getParentContextRecord?: () => Record<string, unknown>;\n    /**\n     * Instancia de AsyncLocalStorage a usar para el scoping de `withContext`.\n     * @internal\n     */\n    alsInstance?: ALS;\n}\n\n/**\n * Contrato que retorna {@link createLogContext}.\n *\n * Fachada de MDC (Mapped Diagnostic Context) por logger. Combina tres fuentes\n * de contexto:\n * - **base inmutable** vía `child()` (snapshot capturado al crear el child),\n * - **scope transitorio** vía `withContext()` / `withContextAsync()` sobre\n *   AsyncLocalStorage,\n * - **resource OTel** mergeado en cada record.\n *\n * En entornos browser sin `AsyncLocalStorage`, las variantes `withContext*`\n * degradan a no-op: ejecutan `fn` sin scoping (o lo skipan si no hay `fn`).\n * `child()` sigue operativo en browser porque no depende de ALS.\n */\nexport interface LogContext {\n    /**\n     * Snapshot actual del contexto bound.\n     *\n     * @returns Copia inmutable (shallow) del contexto; mutarla no afecta a los\n     * records que emitan futuras llamadas de log.\n     *\n     * @example\n     * const ctx = logContext.getContext();\n     * console.log(ctx.requestId); // 'abc-123'\n     */\n    getContext(): ContextSnapshot;\n\n    /**\n     * Ejecuta `fn` dentro de un scope de AsyncLocalStorage donde `bindings`\n     * se mergean al contexto para todas las llamadas de log dentro de `fn`.\n     *\n     * Si no se pasa `fn` (la vieja forma de setter), es no-op por backwards\n     * compatibility. Para binding persistente prefiere `child()`; para\n     * callbacks async usa `withContextAsync()`.\n     *\n     * **Browser fallback**: sin ALS, ejecuta `fn` directamente sin scoping\n     * (los bindings NO se mergean). Si tampoco hay `fn`, retorna `undefined`.\n     *\n     * @param bindings - Pares key-value a attachar durante la ejecución de `fn`\n     * @param fn - Función sincrónica opcional a ejecutar bajo el scope ALS\n     * @returns El valor de retorno de `fn`, o `undefined` si no se pasa `fn`\n     *\n     * @example\n     * logContext.withContext({ requestId: 'abc-123' }, () => {\n     *   logger.info('procesando'); // el record lleva requestId=abc-123\n     * });\n     * // fuera de fn: requestId ya no está presente en próximos logs\n     *\n     * @see {@link LogContext.withContextAsync} para callbacks async\n     * @see {@link LogContext.child} para binding persistente inmutable (sin ALS)\n     */\n    withContext<R>(bindings: Record<string, unknown>, fn?: () => R): R | undefined;\n\n    /**\n     * Variante async de {@link withContext}. Ejecuta `fn` dentro de un scope\n     * de AsyncLocalStorage para que los bindings queden disponibles a todas las\n     * llamadas de log async dentro de `fn` (incluso tras `await`).\n     *\n     * **Browser fallback**: sin ALS, ejecuta `fn` directamente sin scoping.\n     *\n     * @param bindings - Pares key-value a attachar durante la ejecución de `fn`\n     * @param fn - Función async a ejecutar bajo el scope ALS\n     * @returns El Promise retornado por `fn`\n     *\n     * @example\n     * await logContext.withContextAsync({ traceId }, async () => {\n     *   const user = await fetchUser();\n     *   logger.info('user cargado', { id: user.id });\n     *   // el record lleva el traceId aunque el log ocurra tras un await\n     * });\n     */\n    withContextAsync<R>(bindings: Record<string, unknown>, fn: () => Promise<R>): Promise<R>;\n\n    /**\n     * Droppea todas las keys del contexto bound. Tras esta llamada, los\n     * records emitidos ya no llevan `attributes` hasta que\n     * {@link withContext} o {@link child} restablezcan uno.\n     *\n     * @returns La misma instancia de LogContext, ahora sin contexto\n     *\n     * @example\n     * logContext.clearContext();\n     * logger.info('limpio'); // sin attributes\n     */\n    clearContext(): this;\n\n    /**\n     * Actualiza el resource OTel por defecto (service.name, version,\n     * deployment.environment, ...).\n     *\n     * Se persiste en el campo `resource` de cada record emitido, salvo que el\n     * propio record lo overridee.\n     *\n     * @param resource - Resource OTel parcial a mergear con el actual\n     * @returns La misma instancia de LogContext, para encadenar calls\n     *\n     * @example\n     * logContext.setResource({ serviceName: 'api-gateway', environment: 'prod' });\n     */\n    setResource(resource: Partial<ILogResourceRef>): this;\n\n    /**\n     * Devuelve una copia inmutable de este logger con el contexto extra bound.\n     *\n     * Las llamadas futuras sobre el child emiten con el contexto mergeado, sin\n     * mutar al padre — patrón canónico de MDC.\n     *\n     * A diferencia de {@link withContext}, **no involucra AsyncLocalStorage**:\n     * el binding es persistente y queda capturado en el snapshot del child al\n     * crearse. Por eso `child()` es operativo también en browser sin ALS.\n     *\n     * Los bindings transitorios de ALS activos en el momento de `child()` NO\n     * se bakean en el child — solo se captura el contexto base. ALS se aplica\n     * fresco en cada dispatch vía `_getContextRecord()`.\n     *\n     * @param extra - Pares key-value a attachar (requestId, userId, ...)\n     * @returns Un nuevo Logger con el contexto mergeado\n     *\n     * @example\n     * const requestLog = logContext.child({ requestId: 'abc-123' });\n     * requestLog.info('inicio');   // siempre lleva requestId=abc-123\n     * requestLog.info('fin');\n     * // el logger padre no se ve afectado por estos bindings\n     *\n     * @see {@link LogContext.withContext} para scoping transitorio (ALS)\n     */\n    child(extra: Record<string, unknown>): ChildLoggerShape;\n\n    /**\n     * Record de contexto interno. Expuesto para el ensamblado de TransportRecord\n     * (base + overlay ALS si hay store activo).\n     * @internal\n     */\n    _getContextRecord(): Record<string, unknown>;\n    /**\n     * Retorna el contexto base SIN el overlay de ALS.\n     *\n     * Lo usa `Logger.child()` para capturar el snapshot del contexto padre al\n     * crear un child logger, garantizando que el binding ALS transitorio no\n     * se bakeé en el child.\n     * @internal\n     */\n    _getBaseContextRecord(): Record<string, unknown>;\n    /**\n     * Record de resource interno. Expuesto para el ensamblado de TransportRecord.\n     * @internal\n     */\n    _getResource(): Partial<ILogResourceRef> | undefined;\n    /**\n     * Retorna el store actual de AsyncLocalStorage, si ALS está activo en el\n     * call stack corriente.\n     * @internal\n     */\n    _getAlsStore(): Record<string, unknown> | undefined;\n}\n\n// AsyncLocalStorage type (Node 14+, undefined in browser)\ntype ALS = AsyncLocalStorageLike<Record<string, unknown>>;\n\n// ALS singleton del módulo. Resolución por capas (global →\n// `process.getBuiltinModule` → `require`, undefined en browser) delegada al\n// helper compartido `resolveAsyncLocalStorage` — el mismo que usa el ALS de\n// spans en `transports/SpanRuntime.ts`. Antes esto era\n// `typeof AsyncLocalStorage !== 'undefined'`, un feature-detect roto: ese\n// constructor no es global en node/bun, así que siempre resolvía `undefined`\n// y `withContext`/`withContextAsync` eran no-op silenciosos fuera del browser.\nconst alsInstance: ALS | undefined = resolveAsyncLocalStorage<Record<string, unknown>>();\n\n/**\n * Factory que crea una instancia de {@link LogContext}.\n *\n * @param options - Configuración (ver {@link ILogContextOptions})\n * @returns Una instancia de LogContext lista para usar\n *\n * @example\n * const logContext = createLogContext({\n *   childLoggerFactory: (cfg) => new Logger(cfg),\n *   initialContext: { service: 'orders-api' },\n *   initialResource: { serviceName: 'orders-api', environment: 'prod' }\n * });\n *\n * // Child inmutable con contexto persistente\n * const requestLog = logContext.child({ requestId: 'abc-123' });\n *\n * // Scope transitorio vía ALS (Node; en browser sin ALS es no-op)\n * logContext.withContext({ traceId: 't-9' }, () => {\n *   requestLog.info('procesando orden');\n * });\n */\nexport function createLogContext(options: ILogContextOptions): LogContext {\n    let context: Record<string, unknown> = { ...options.initialContext };\n    let resource: Partial<ILogResourceRef> | undefined = options.initialResource\n        ? { ...options.initialResource }\n        : undefined;\n\n    // Use provided ALS instance or fall back to module-level (browser fallback)\n    const als = options.alsInstance ?? alsInstance;\n\n    return {\n        getContext(): ContextSnapshot {\n            return { ...context };\n        },\n\n        withContext<R>(bindings: Record<string, unknown>, fn?: () => R): R | undefined {\n            // No-op without AsyncLocalStorage (browser fallback)\n            if (!als) {\n                if (fn) return fn();\n                return undefined;\n            }\n            // No fn: backwards-compat no-op setter shim\n            if (!fn) return undefined;\n            // Run fn within AsyncLocalStorage scope, merged with the active\n            // outer scope (if any) so nested withContext calls accumulate\n            // bindings instead of replacing them.\n            const merged = { ...context, ...als.getStore(), ...bindings };\n            return als.run(merged, fn);\n        },\n\n        async withContextAsync<R>(bindings: Record<string, unknown>, fn: () => Promise<R>): Promise<R> {\n            if (!als) return fn();\n            const merged = { ...context, ...als.getStore(), ...bindings };\n            return als.run(merged, fn);\n        },\n\n        clearContext(): typeof this {\n            context = {};\n            return this;\n        },\n\n        setResource(res: Partial<ILogResourceRef>): typeof this {\n            resource = { ...resource, ...res };\n            return this;\n        },\n\n        child(_extra: Record<string, unknown>): ChildLoggerShape {\n            // Creates the child logger via factory. Captures the current\n            // _getBaseContextRecord() snapshot (parent context WITHOUT ALS) at\n            // child-creation time. ALS is transient and should not be baked into\n            // the child's _parentContextRecord — it is applied fresh at dispatch time.\n            // Note: _extra (bindings) are stored by Logger.child() as _bindings.\n            const snapshot = this._getBaseContextRecord();\n            const childLogger = options.childLoggerFactory({}) as ChildLoggerShape;\n            // Store on childLogger for Logger.child() to pick up\n            (childLogger as unknown as Record<string, unknown>)['__parentSnapshot'] = snapshot;\n            return childLogger;\n        },\n\n        _getContextRecord(): Record<string, unknown> {\n            // Returns the full merged context for dispatch purposes.\n            // Base (parent snapshot + own context) plus ALS overlay if active.\n            const base = this._getBaseContextRecord();\n            const alsContext = als?.getStore();\n            if (alsContext && Object.keys(alsContext).length > 0) {\n                return { ...base, ...alsContext };\n            }\n            return base;\n        },\n\n        _getBaseContextRecord(): Record<string, unknown> {\n            // Returns parent context chain + own context (NO ALS overlay).\n            // ALS is applied by _getContextRecord() as a live overlay.\n            let base: Record<string, unknown> = {};\n            const parentRecord = options.getParentContextRecord?.() ?? null;\n            if (parentRecord && Object.keys(parentRecord).length > 0) {\n                base = parentRecord;\n            } else if (Object.keys(context).length > 0) {\n                base = context;\n            }\n            if (Object.keys(context).length > 0) {\n                base = { ...base, ...context };\n            }\n            return base;\n        },\n\n        _getResource(): Partial<ILogResourceRef> | undefined {\n            return resource;\n        },\n\n        _getAlsStore(): Record<string, unknown> | undefined {\n            return als?.getStore();\n        }\n    };\n}\n"],"mappings":";;;;;;;;;;;;AAiCA,SAAgB,2BAAoE;CAChF,MAAM,aAAc,WAA0E;CAC9F,IAAI,OAAO,eAAe,YACtB,OAAO,IAAI,WAAW;CAG1B,MAAM,OAAO;CAKb,IAAI;EACA,MAAM,aAAa,KAAK,SAAS,mBAAmB,aAAa;EACjE,IAAI,YAAY,mBACZ,OAAO,IAAI,WAAW,kBAAkB;CAEhD,QAAQ,CAER;CAEA,IAAI;EACA,IAAI,OAAO,YAAY,YAAY;GAE/B,MAAM,aAAa,QAAQ,kBAAkB;GAC7C,IAAI,YAAY,mBACZ,OAAO,IAAI,WAAW,kBAAkB;EAEhD;CACJ,QAAQ,CAER;AAGJ;;;AC+KA,MAAM,cAA+B,yBAAkD;;;;;;;;;;;;;;;;;;;;;;AAuBvF,SAAgB,iBAAiB,SAAyC;CACtE,IAAI,UAAmC,EAAE,GAAG,QAAQ,eAAe;CACnE,IAAI,WAAiD,QAAQ,kBACvD,EAAE,GAAG,QAAQ,gBAAgB,IAC7B,KAAA;CAGN,MAAM,MAAM,QAAQ,eAAe;CAEnC,OAAO;EACH,aAA8B;GAC1B,OAAO,EAAE,GAAG,QAAQ;EACxB;EAEA,YAAe,UAAmC,IAA6B;GAE3E,IAAI,CAAC,KAAK;IACN,IAAI,IAAI,OAAO,GAAG;IAClB;GACJ;GAEA,IAAI,CAAC,IAAI,OAAO,KAAA;GAIhB,MAAM,SAAS;IAAE,GAAG;IAAS,GAAG,IAAI,SAAS;IAAG,GAAG;GAAS;GAC5D,OAAO,IAAI,IAAI,QAAQ,EAAE;EAC7B;EAEA,MAAM,iBAAoB,UAAmC,IAAkC;GAC3F,IAAI,CAAC,KAAK,OAAO,GAAG;GACpB,MAAM,SAAS;IAAE,GAAG;IAAS,GAAG,IAAI,SAAS;IAAG,GAAG;GAAS;GAC5D,OAAO,IAAI,IAAI,QAAQ,EAAE;EAC7B;EAEA,eAA4B;GACxB,UAAU,CAAC;GACX,OAAO;EACX;EAEA,YAAY,KAA4C;GACpD,WAAW;IAAE,GAAG;IAAU,GAAG;GAAI;GACjC,OAAO;EACX;EAEA,MAAM,QAAmD;GAMrD,MAAM,WAAW,KAAK,sBAAsB;GAC5C,MAAM,cAAc,QAAQ,mBAAmB,CAAC,CAAC;GAEjD,YAAoD,sBAAsB;GAC1E,OAAO;EACX;EAEA,oBAA6C;GAGzC,MAAM,OAAO,KAAK,sBAAsB;GACxC,MAAM,aAAa,KAAK,SAAS;GACjC,IAAI,cAAc,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,GAC/C,OAAO;IAAE,GAAG;IAAM,GAAG;GAAW;GAEpC,OAAO;EACX;EAEA,wBAAiD;GAG7C,IAAI,OAAgC,CAAC;GACrC,MAAM,eAAe,QAAQ,yBAAyB,KAAK;GAC3D,IAAI,gBAAgB,OAAO,KAAK,YAAY,CAAC,CAAC,SAAS,GACnD,OAAO;QACJ,IAAI,OAAO,KAAK,OAAO,CAAC,CAAC,SAAS,GACrC,OAAO;GAEX,IAAI,OAAO,KAAK,OAAO,CAAC,CAAC,SAAS,GAC9B,OAAO;IAAE,GAAG;IAAM,GAAG;GAAQ;GAEjC,OAAO;EACX;EAEA,eAAqD;GACjD,OAAO;EACX;EAEA,eAAoD;GAChD,OAAO,KAAK,SAAS;EACzB;CACJ;AACJ"}

package/dist/chunks/LogContext-Dyzs61XG.js

@@ -0,0 +1,136 @@
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
+	if (typeof require !== "undefined") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
+});
+//#endregion
+//#region src/utils/asyncLocalStorage.ts
+/**
+* Resuelve `AsyncLocalStorage` por capas:
+*   1. global `AsyncLocalStorage` (runtimes/polyfills que lo exponen),
+*   2. `process.getBuiltinModule('async_hooks')` (Node >= 22.3, Bun),
+*   3. `require('node:async_hooks')` (CJS interop),
+*   4. `undefined` → browser estricto: sin correlación (degradación
+*      documentada; el caller decide qué hacer sin ALS).
+*
+* Nota: NO basta con `typeof AsyncLocalStorage !== 'undefined'` — en Node y
+* Bun el constructor NO es global y hay que ir a `node:async_hooks`.
+*/
+function resolveAsyncLocalStorage() {
+	const globalCtor = globalThis.AsyncLocalStorage;
+	if (typeof globalCtor === "function") return new globalCtor();
+	const proc = globalThis;
+	try {
+		const asyncHooks = proc.process?.getBuiltinModule?.("async_hooks");
+		if (asyncHooks?.AsyncLocalStorage) return new asyncHooks.AsyncLocalStorage();
+	} catch {}
+	try {
+		if (typeof __require === "function") {
+			const asyncHooks = __require("node:async_hooks");
+			if (asyncHooks?.AsyncLocalStorage) return new asyncHooks.AsyncLocalStorage();
+		}
+	} catch {}
+}
+//#endregion
+//#region src/context/LogContext.ts
+const alsInstance = resolveAsyncLocalStorage();
+/**
+* Factory que crea una instancia de {@link LogContext}.
+*
+* @param options - Configuración (ver {@link ILogContextOptions})
+* @returns Una instancia de LogContext lista para usar
+*
+* @example
+* const logContext = createLogContext({
+*   childLoggerFactory: (cfg) => new Logger(cfg),
+*   initialContext: { service: 'orders-api' },
+*   initialResource: { serviceName: 'orders-api', environment: 'prod' }
+* });
+*
+* // Child inmutable con contexto persistente
+* const requestLog = logContext.child({ requestId: 'abc-123' });
+*
+* // Scope transitorio vía ALS (Node; en browser sin ALS es no-op)
+* logContext.withContext({ traceId: 't-9' }, () => {
+*   requestLog.info('procesando orden');
+* });
+*/
+function createLogContext(options) {
+	let context = { ...options.initialContext };
+	let resource = options.initialResource ? { ...options.initialResource } : void 0;
+	const als = options.alsInstance ?? alsInstance;
+	return {
+		getContext() {
+			return { ...context };
+		},
+		withContext(bindings, fn) {
+			if (!als) {
+				if (fn) return fn();
+				return;
+			}
+			if (!fn) return void 0;
+			const merged = {
+				...context,
+				...als.getStore(),
+				...bindings
+			};
+			return als.run(merged, fn);
+		},
+		async withContextAsync(bindings, fn) {
+			if (!als) return fn();
+			const merged = {
+				...context,
+				...als.getStore(),
+				...bindings
+			};
+			return als.run(merged, fn);
+		},
+		clearContext() {
+			context = {};
+			return this;
+		},
+		setResource(res) {
+			resource = {
+				...resource,
+				...res
+			};
+			return this;
+		},
+		child(_extra) {
+			const snapshot = this._getBaseContextRecord();
+			const childLogger = options.childLoggerFactory({});
+			childLogger["__parentSnapshot"] = snapshot;
+			return childLogger;
+		},
+		_getContextRecord() {
+			const base = this._getBaseContextRecord();
+			const alsContext = als?.getStore();
+			if (alsContext && Object.keys(alsContext).length > 0) return {
+				...base,
+				...alsContext
+			};
+			return base;
+		},
+		_getBaseContextRecord() {
+			let base = {};
+			const parentRecord = options.getParentContextRecord?.() ?? null;
+			if (parentRecord && Object.keys(parentRecord).length > 0) base = parentRecord;
+			else if (Object.keys(context).length > 0) base = context;
+			if (Object.keys(context).length > 0) base = {
+				...base,
+				...context
+			};
+			return base;
+		},
+		_getResource() {
+			return resource;
+		},
+		_getAlsStore() {
+			return als?.getStore();
+		}
+	};
+}
+//#endregion
+export { resolveAsyncLocalStorage as n, createLogContext as t };
+
+//# sourceMappingURL=LogContext-Dyzs61XG.js.map