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

package/dist/transports/HttpTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpTransport.d.ts","sourceRoot":"","sources":["../../src/transports/HttpTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,eAAe,EACf,gBAAgB,EAEhB,kBAAkB,EAElB,YAAY,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AASD;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAU;IAE/B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,MAAM,CAAS;IAEvB,kGAAkG;IAClG,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC;gBAE5B,OAAO,CAAC,EAAE,oBAAoB;IAkB1C,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,OAAO,IAAI,OAAO;IAIlB,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAepC;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM;IAI3D;;;;OAIG;IACH,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOhD,OAAO,CAAC,mBAAmB;IAgBrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAiCd,aAAa;IA4ErB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}
+{"version":3,"file":"HttpTransport.d.ts","sourceRoot":"","sources":["../../src/transports/HttpTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,eAAe,EACf,gBAAgB,EAEhB,kBAAkB,EAElB,YAAY,EACf,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC1D,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IACpD,iGAAiG;IACjG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAU;IAE/B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAiC;IACpD,OAAO,CAAC,MAAM,CAAS;IAEvB,+GAA+G;IAC/G,SAAS,CAAC,OAAO,EAAE,oBAAoB,CAAC;IAExC;;;;;;;;;;;;;;;;OAgBG;gBACS,OAAO,CAAC,EAAE,oBAAoB;IAkB1C,gEAAgE;IAChE,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,8GAA8G;IAC9G,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,OAAO,IAAI,OAAO;IAIlB;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAepC;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM;IAI3D;;;;OAIG;IACH,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAOhD,OAAO,CAAC,mBAAmB;IAgB3B;;;;;;;;;;;;;OAaG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAiCd,aAAa;IA4E3B;;;;;;;;;;;OAWG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ/B"}

package/dist/transports/OtlpTraceTransport.d.ts

@@ -0,0 +1,118 @@
+import type { SpanRecord, TransportRecord } from '../types/index.js';
+import { HttpTransport } from './HttpTransport.js';
+import { type OtlpAttributeValue, type OtlpTransportOptions } from './OtlpTransport.js';
+/**
+ * Opciones de configuración para {@link OtlpTraceTransport}. Hereda todas las
+ * opciones de {@link OtlpTransportOptions} (endpoint, serviceName,
+ * ingestKeyEnvVar, batching, retry, ...) porque el transport de traces espeja
+ * al de logs.
+ */
+export interface OtlpTraceTransportOptions extends OtlpTransportOptions {
+    /**
+     * Versión del scope que emite los spans (`scopeSpans[].scope.version`).
+     * Opcional: si se omite, el bloque `scope` se emite sin `version` en vez
+     * de inventar una.
+     */
+    scopeVersion?: string;
+}
+/**
+ * Shape del body JSON de un request OTLP/HTTP para traces. Coincide con el
+ * JSON mapping del proto `TracesData` para `/v1/traces`. Ver
+ * https://opentelemetry.io/docs/specs/otlp/#json-protobuf-encoding
+ */
+interface OtlpTracesPayload {
+    resourceSpans: Array<{
+        resource: {
+            attributes: Array<{
+                key: string;
+                value: {
+                    stringValue: string;
+                };
+            }>;
+        };
+        scopeSpans: Array<{
+            scope: {
+                name: string;
+                version?: string;
+            };
+            spans: Array<OtlpSpan>;
+        }>;
+    }>;
+}
+/**
+ * Span individual dentro del payload OTLP. Mappea 1:1 los campos del
+ * `SpanRecord` al proto `Span` de la spec OTel Trace.
+ * @see https://opentelemetry.io/docs/specs/otel/trace/api/#span
+ */
+interface OtlpSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    name: string;
+    kind: number;
+    startTimeUnixNano: string;
+    endTimeUnixNano: string;
+    attributes?: Array<{
+        key: string;
+        value: OtlpAttributeValue;
+    }>;
+    status?: {
+        code: number;
+        message?: string;
+    };
+}
+/**
+ * Transport OTLP/HTTP para traces (spans) — POST a `<endpoint>/v1/traces`.
+ *
+ * Espeja {@link OtlpTransport} (que va a `/v1/logs`): hereda de
+ * {@link HttpTransport} el batch, retry con backoff, buffer acotado, close
+ * asincrónico y el hook on-error. Solo cambia la shape del payload y acepta
+ * exclusivamente records de kind `'span'` (`accepts = ['span']`): el
+ * {@link TransportManager} garantiza que jamás recibe un log record.
+ *
+ * @example
+ * ```ts
+ * logger.addTransport({
+ *   target: new OtlpTraceTransport({
+ *     endpoint: 'https://otelcollector.example.com:4318',
+ *     serviceName: 'my-app',
+ *     scopeVersion: '1.2.3'
+ *   })
+ * });
+ *
+ * await logger.span('db.query', { table: 'users' }, async () => {
+ *   await db.select();
+ * });
+ * ```
+ */
+export declare class OtlpTraceTransport extends HttpTransport {
+    readonly name = "otlp-trace";
+    /** Este transport SOLO acepta spans — jamás recibe log records. */
+    readonly accepts: readonly ["span"];
+    private readonly resource;
+    private readonly scopeVersion;
+    /** Resuelto al construir. Nunca se loguea, nunca se escribe a source. */
+    private readonly ingestKeyValue;
+    constructor(options: OtlpTraceTransportOptions);
+    /**
+     * Construye el payload JSON OTLP/HTTP a partir de los spans bufferizados.
+     * Un bloque `resourceSpans` por batch. Expuesto para tests y subclasses.
+     *
+     * @param spans - Spans a serializar dentro del payload.
+     * @returns Objeto `TracesData` listo para `JSON.stringify`.
+     */
+    buildPayload(spans: SpanRecord[]): OtlpTracesPayload;
+    /**
+     * Serializa un batch al body JSON del request OTLP/HTTP. Override de
+     * {@link HttpTransport.serializeBody}.
+     */
+    protected serializeBody(records: TransportRecord[]): string;
+    /**
+     * Construye los headers del request. Agrega `signoz-ingestion-key` con el
+     * valor resuelto al construir.
+     */
+    protected buildHeaders(): Record<string, string>;
+    private toOtlpSpan;
+}
+export {};
+//# sourceMappingURL=OtlpTraceTransport.d.ts.map

package/dist/transports/OtlpTraceTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtlpTraceTransport.d.ts","sourceRoot":"","sources":["../../src/transports/OtlpTraceTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAgB,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,aAAa,EAA6B,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAIH,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC5B,MAAM,oBAAoB,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACnE;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,UAAU,iBAAiB;IACvB,aAAa,EAAE,KAAK,CAAC;QACjB,QAAQ,EAAE;YACN,UAAU,EAAE,KAAK,CAAC;gBAAE,GAAG,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE;oBAAE,WAAW,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAC,CAAC;SACtE,CAAC;QACF,UAAU,EAAE,KAAK,CAAC;YACd,KAAK,EAAE;gBACH,IAAI,EAAE,MAAM,CAAC;gBACb,OAAO,CAAC,EAAE,MAAM,CAAC;aACpB,CAAC;YACF,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;SAC1B,CAAC,CAAC;KACN,CAAC,CAAC;CACN;AAED;;;;GAIG;AACH,UAAU,QAAQ;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACjD,SAAkB,IAAI,gBAAgB;IAEtC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,oBAAqB;IAErC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAExC,OAAO,EAAE,yBAAyB;IAsC9C;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,iBAAiB;IAuBpD;;;OAGG;cACgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM;IAMpE;;;OAGG;cACgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQzD,OAAO,CAAC,UAAU;CA+BrB"}

package/dist/transports/OtlpTransport.d.ts

@@ -1,53 +1,52 @@
 import type { TransportRecord, HookLogEntry } from '../types/index.js';
 import { HttpTransport } from './HttpTransport.js';
 /**
- * Options for {@link OtlpTransport}.
- *
+ * Opciones de configuración para {@link OtlpTransport}.
  */
 export interface OtlpTransportOptions {
     /**
-     * OTLP/HTTP collector base URL, e.g. `https://collector.example.com:4318`.
-     * The transport POSTs to `<endpoint>/v1/logs`.
+     * URL base del collector OTLP/HTTP, p.ej. `https://collector.example.com:4318`.
+     * El transport hace POST a `<endpoint>/v1/logs`.
      */
     endpoint: string;
-    /** `service.name` resource attribute. Required by OTel spec. */
+    /** Atributo de resource `service.name`. Requerido por la spec OTel. */
     serviceName: string;
-    /** `service.version` resource attribute. Recommended. */
+    /** Atributo de resource `service.version`. Recomendado. */
     serviceVersion?: string;
-    /** `deployment.environment` resource attribute (production/staging/dev). */
+    /** Atributo de resource `deployment.environment` (production/staging/dev). */
     environment?: string;
-    /** Extra resource attributes merged into the resource block. */
+    /** Atributos de resource adicionales que se merguean en el bloque `resource`. */
     resourceAttributes?: Record<string, string>;
     /**
-     * Name of an env var whose value is sent as the `signoz-ingestion-key`
-     * header. The transport reads `process.env[ingestKeyEnvVar]` at
-     * construction time — never from a string literal. If the env var is
-     * unset, the header is silently omitted (OTLP collector uses default
-     * no-auth path).
+     * Nombre de la env var cuyo valor se envía como header
+     * `signoz-ingestion-key`. El transport lee `process.env[ingestKeyEnvVar]`
+     * al construirse — nunca desde un string literal. Si la env var no está
+     * seteada, el header se omite silenciosamente (el collector OTLP usa el
+     * path default sin auth).
      */
     ingestKeyEnvVar?: string;
-    /** Extra headers merged in (Authorization, custom X-*). */
+    /** Headers extra que se merguean (Authorization, X-* custom). */
     headers?: Record<string, string>;
-    /** Batch size (records per POST). Default 50. */
+    /** Tamaño del batch (records por POST). Default 50. */
     batchSize?: number;
-    /** Flush interval in ms. */
+    /** Intervalo de flush en ms. */
     flushInterval?: number;
-    /** Hard cap on buffered records. Default 10_000. */
+    /** Tope duro de records bufferizados. Default 10_000. */
     maxBufferSize?: number;
-    /** Max retry attempts per batch. Default 3. */
+    /** Reintentos máximos por batch. Default 3. */
     maxRetries?: number;
-    /** Initial backoff in ms. Default 250. */
+    /** Backoff inicial en ms. Default 250. */
     initialBackoffMs?: number;
-    /** Backoff ceiling in ms. Default 5_000. */
+    /** Techo de backoff en ms. Default 5_000. */
     maxBackoffMs?: number;
-    /** Per-fetch timeout in ms. Default 10_000. */
+    /** Timeout por fetch en ms. Default 10_000. */
     fetchTimeoutMs?: number;
-    /** Hook fired on transport failure (drop, retry exhaustion, ...). */
+    /** Hook que se dispara ante falla del transport (drop, agotamiento de reintentos, ...). */
     onError?: (entry: HookLogEntry) => void | Promise<void>;
 }
 /**
- * Shape of the OTLP/HTTP JSON request body. Matches the `LogsData` proto
- * JSON mapping for `/v1/logs`. See
+ * Shape del body JSON de un request OTLP/HTTP. Coincide con el JSON mapping
+ * del proto `LogsData` para `/v1/logs`. Ver
  * https://opentelemetry.io/docs/specs/otlp/#json-protobuf-encoding
  */
 interface OtlpLogsPayload {
@@ -69,6 +68,12 @@ interface OtlpLogsPayload {
         }>;
     }>;
 }
+/**
+ * Registro individual de log dentro del payload OTLP. Mappea mensaje,
+ * severidad, timestamp (en nanosegundos), atributos y contexto de trace al
+ * formato `LogRecord` definido por la spec OTel Logs.
+ * @see https://opentelemetry.io/docs/specs/otel/logs/data-model/
+ */
 interface OtlpLogRecord {
     timeUnixNano: string;
     observedTimeUnixNano: string;
@@ -84,7 +89,13 @@ interface OtlpLogRecord {
     traceId?: string;
     spanId?: string;
 }
-type OtlpAttributeValue = {
+/**
+ * Unión discriminada que representa un `AnyValue` de OTel para atributos de
+ * log. Soporta string, int, double, bool y arrays anidados (homogéneos o
+ * mixtos).
+ * @see https://opentelemetry.io/docs/specs/otel/common/
+ */
+export type OtlpAttributeValue = {
     stringValue: string;
 } | {
     intValue: number;
@@ -98,12 +109,13 @@ type OtlpAttributeValue = {
     };
 };
 /**
- * OTLP/HTTP transport for SigNoz (or any OTLP-compliant backend).
+ * Transport OTLP/HTTP para SigNoz (o cualquier backend compatible con OTLP).
  *
- * Extends {@link HttpTransport} — inherits retry, bounded buffer, status
- * check, async close, and the on-error hook. Overrides only the payload
- * shape and the request headers.
+ * Extiende {@link HttpTransport} — hereda retry, buffer acotado, status check,
+ * close asincrónico y el hook on-error. Overridea únicamente la shape del
+ * payload y los headers del request.
  *
+ * @example
  * ```ts
  * logger.addTransport({
  *   target: new OtlpTransport({
@@ -115,34 +127,65 @@ type OtlpAttributeValue = {
  *   })
  * });
  * ```
- *
  */
 export declare class OtlpTransport extends HttpTransport {
     readonly name = "otlp";
     private readonly resource;
-    /** Resolved at construction. Never logged, never written to source. */
+    /** Resuelto al construir. Nunca se loguea, nunca se escribe a source. */
     private readonly ingestKeyValue;
     constructor(options: OtlpTransportOptions);
     /**
-     * Builds the OTLP/HTTP JSON payload from the currently buffered records.
-     * One `resourceLogs` block per batch (matches OTel collector batching
-     * guidance). Exposed for tests + custom transport subclasses.
+     * Construye el payload JSON OTLP/HTTP a partir de los records bufferizados.
+     * Un bloque `resourceLogs` por batch (sigue la guía de batching del
+     * collector OTel). Expuesto para tests y para subclasses custom de transport.
      *
+     * @param records - Records de log a serializar dentro del payload.
+     * @returns Objeto `LogsData` listo para `JSON.stringify`.
+     * @see {@link OtlpLogsPayload}
      */
     buildPayload(records: TransportRecord[]): OtlpLogsPayload;
     /**
-     * Serialises a batch into the OTLP/HTTP JSON request body. Overrides
+     * Serializa un batch al body JSON del request OTLP/HTTP. Override de
      * {@link HttpTransport.serializeBody}.
      *
+     * @param records - Records del batch a serializar.
+     * @returns String JSON listo para usar como `body` del fetch POST.
      */
     protected serializeBody(records: TransportRecord[]): string;
     /**
-     * Builds request headers. Adds `signoz-ingestion-key` from the value
-     * resolved at construction time (never logged, never written to source).
+     * Construye los headers del request. Agrega `signoz-ingestion-key` con el
+     * valor resuelto al construir (nunca se loguea, nunca se escribe a source).
      *
+     * @returns Record de headers a merguear en el fetch.
      */
     protected buildHeaders(): Record<string, string>;
     private toLogRecord;
 }
+/**
+ * Quita la barra final de un endpoint si la lleva.
+ *
+ * @internal Compartido con {@link OtlpTraceTransport}; no es API pública.
+ */
+export declare function stripTrailingSlash(value: string): string;
+/**
+ * Lee la ingest API key desde `process.env[name]`. Devuelve `undefined`
+ * silenciosamente si `process` no está disponible (bundles estrictos de
+ * browser) o si la variable no está seteada. Nunca throwea, nunca loguea
+ * el valor.
+ *
+ * @internal Helper del constructor de {@link OtlpTransport} y
+ *   {@link OtlpTraceTransport}; no es API pública.
+ * @param envVarName - Nombre de la env var a leer.
+ * @returns Valor de la key, o `undefined` si no está disponible.
+ */
+export declare function readIngestKey(envVarName: string | undefined): string | undefined;
+/**
+ * Convierte un valor JS a un `AnyValue` de OTel. Compartido con
+ * {@link OtlpTraceTransport} para serializar attributes de span con el mismo
+ * mapping.
+ *
+ * @internal Exportado para reuse entre transports OTLP; no es API pública.
+ */
+export declare function toOtlpAttribute(value: unknown): OtlpAttributeValue | null;
 export {};
 //# sourceMappingURL=OtlpTransport.d.ts.map

package/dist/transports/OtlpTransport.d.ts.map

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

package/dist/transports/SpanRuntime.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview SpanRuntime — runtime de spans del trio API
+ * `event` / `span` / `startSpan`.
+ *
+ * Vive en transports/ porque es la extensión del pipeline de dispatch: los
+ * {@link SpanRecord} que produce viajan por el {@link TransportManager} junto
+ * a los log records, enrutados por kind (`accepts`).
+ *
+ * Tres responsabilidades:
+ *   - **ALS singleton del módulo**: un único `AsyncLocalStorage<SpanRecord>`
+ *     compartido por TODAS las instancias de Logger — "qué instancia lleva el
+ *     span" es ambiguo con MDC por-instancia, el span activo es una propiedad
+ *     del call stack, no del logger.
+ *   - **Generación de ids** conforme a W3C Trace Context (traceId 16 bytes →
+ *     32 hex, spanId 8 bytes → 16 hex) vía `crypto.getRandomValues`.
+ *   - **Leak-safety**: registry de spans abiertos; en flush/shutdown se
+ *     fuerzan a `end()` con `incomplete: true` y se exportan — nunca se tiran.
+ */
+import type { Span, SpanAttributes, SpanRecord } from '../types/index.js';
+/**
+ * Span activo en el call stack corriente (dentro de `span(fn)`), si lo hay.
+ * Lo consumen la correlación log→span (`TransportRecord.traceId/spanId`) y la
+ * resolución de `parentSpanId` en spans hijos.
+ */
+export declare function getActiveSpan(): SpanRecord | undefined;
+/**
+ * Ejecuta `fn` con `record` como span activo. Sin ALS disponible (browser),
+ * ejecuta `fn` directamente — sin correlación pero funcional.
+ */
+export declare function runWithActiveSpan<R>(record: SpanRecord, fn: () => R): R;
+/** Nanosegundos Unix actuales como string decimal (formato OTLP). */
+export declare function nowUnixNano(): string;
+/** Trace id W3C: 16 bytes → 32 chars hex. */
+export declare function generateTraceId(): string;
+/** Span id W3C: 8 bytes → 16 chars hex. */
+export declare function generateSpanId(): string;
+/**
+ * Crea el record de span y su {@link Span} handle. El handle registra el
+ * span en el registry de abiertos; `onEnd` se invoca una única vez, con el
+ * record final (duración real o `incomplete: true`), para su export al
+ * pipeline de transports.
+ *
+ * `end()` solo fija `endTimeUnixNano` si no se fijó antes — así los
+ * point-spans (`event()`) pueden fijar `end = start` exacto.
+ *
+ * @param name - Nombre de la operación.
+ * @param attributes - Attributes iniciales (copia propia del record).
+ * @param scope - Scope del logger emisor.
+ * @param onEnd - Callback de export; recibe el record cerrado.
+ * @returns El record (para el ALS store) y el handle del span.
+ */
+export declare function createSpan(name: string, attributes: SpanAttributes | undefined, scope: string, onEnd: (record: SpanRecord) => void): {
+    record: SpanRecord;
+    span: Span;
+};
+/**
+ * Emite un point-span (`event()`): start = end exactamente, sin registro en
+ * abiertos tras el cierre — no hay leak posible. El `parentSpanId` se resuelve
+ * contra el span activo si existe, pero NO fija contexto ALS.
+ */
+export declare function emitEventSpan(name: string, attributes: SpanAttributes | undefined, scope: string, onEnd: (record: SpanRecord) => void): void;
+/**
+ * Fuerza el cierre de todos los spans abiertos (`incomplete: true`) y los
+ * exporta vía el `onEnd` de cada uno. Lo invocan `flushTransports()` /
+ * `closeTransports()` / `cleanup()` ANTES del flush real — un span abierto
+ * nunca se tira en shutdown.
+ *
+ * @returns Los records forzados a cerrar (para diagnóstico/tests).
+ */
+export declare function forceCloseOpenSpans(): SpanRecord[];
+/** Número de spans actualmente abiertos (expuesto para tests/diagnóstico). */
+export declare function openSpanCount(): number;
+//# sourceMappingURL=SpanRuntime.d.ts.map

package/dist/transports/SpanRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpanRuntime.d.ts","sourceRoot":"","sources":["../../src/transports/SpanRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAiB1E;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,SAAS,CAEtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvE;AAED,qEAAqE;AACrE,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAyBD,6CAA6C;AAC7C,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAmBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CACtB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,cAAc,GAAG,SAAS,EACtC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GACpC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,CAkEpC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,cAAc,GAAG,SAAS,EACtC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,GACpC,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,EAAE,CAOlD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/transports/TransportBridge.d.ts

@@ -1,37 +1,43 @@
 /**
- * @fileoverview TransportBridge — TransportManager facade.
- * Encapsulates transport lifecycle: add, remove, flush, close.
+ * @fileoverview TransportBridge — facade de TransportManager.
+ * Encapsula el lifecycle de transports: add, remove, flush, close.
+ *
+ * @internal
  */
 import type { TransportTarget } from '../types/index.js';
 import { TransportManager } from '../transports/index.js';
 /**
- * Result of adding a transport.
+ * Resultado de añadir un transport.
  */
 export interface AddTransportResult {
-    /** Unique transport ID. */
+    /** ID único del transport. */
     id: string;
-    /** The TransportManager instance (created on first add). */
+    /** La instancia de TransportManager (creada al primer add). */
     manager: TransportManager;
 }
 /**
- * Bridge for transport lifecycle management.
+ * Bridge para la gestión del lifecycle de transports.
+ *
+ * @internal
  */
 export interface TransportBridge {
-    /** Adds a transport and returns its ID. */
+    /** Añade un transport y devuelve su ID. */
     addTransport(target: TransportTarget): string;
-    /** Removes a transport by ID. Returns true if removed. */
+    /** Elimina un transport por ID. Devuelve `true` si se eliminó. */
     removeTransport(id: string): boolean;
-    /** Forces flush of all transport buffers. */
+    /** Fuerza el flush de todos los buffers de transports. */
     flushTransports(): Promise<void>;
-    /** Closes all transports gracefully. */
+    /** Cierra todos los transports de forma graceful. */
     closeTransports(): Promise<void>;
-    /** Returns the underlying manager (or undefined if never used). */
+    /** Devuelve el manager subyacente (o `undefined` si nunca se usó). */
     getTransportManager(): TransportManager | undefined;
-    /** Writes a transport record (fire-and-forget). No-op if manager not initialized. */
+    /** Escribe un transport record (fire-and-forget). No-op si el manager no está inicializado. */
     writeRecord(record: Parameters<TransportManager['write']>[0]): void;
 }
 /**
- * Creates a TransportBridge instance.
+ * Crea una instancia de {@link TransportBridge}.
+ *
+ * @internal
  */
 export declare function createTransportBridge(): TransportBridge;
 //# sourceMappingURL=TransportBridge.d.ts.map

package/dist/transports/TransportBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransportBridge.d.ts","sourceRoot":"","sources":["../../src/transports/TransportBridge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,OAAO,EAAE,gBAAgB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,2CAA2C;IAC3C,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IAC9C,0DAA0D;IAC1D,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,6CAA6C;IAC7C,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,wCAAwC;IACxC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,mEAAmE;IACnE,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAAC;IACpD,qFAAqF;IACrF,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAiCvD"}
+{"version":3,"file":"TransportBridge.d.ts","sourceRoot":"","sources":["../../src/transports/TransportBridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,OAAO,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,2CAA2C;IAC3C,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IAC9C,kEAAkE;IAClE,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,0DAA0D;IAC1D,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,qDAAqD;IACrD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,sEAAsE;IACtE,mBAAmB,IAAI,gBAAgB,GAAG,SAAS,CAAC;IACpD,+FAA+F;IAC/F,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CACvE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAiCvD"}