autotel 6.4.1 → 7.0.0

package/dist/index.d.ts

@@ -1,18 +1,19 @@
-import { a as AttributeRedactorPreset, c as REDACTOR_PATTERNS, d as builtinPatterns, f as createAttributeRedactor, i as AttributeRedactorFn, l as REDACTOR_PRESETS, m as normalizeAttributeRedactorConfig, n as AttributeRedactingProcessorOptions, o as BuiltinPatternName, p as createRedactedSpan, r as AttributeRedactorConfig, s as MaskFn, t as AttributeRedactingProcessor, u as ValuePatternConfig } from "./attribute-redacting-processor-Pk7lAzWd.js";
-import { A as ExceptionAttrs, B as PeerAttrs, C as CloudAttrs, D as DeploymentAttrs, E as DBAttrs, F as HTTPServerAttrs, G as SessionAttrs, H as RPCAttrs, I as K8sAttrs, J as URLAttrs, K as TLSAttrs, L as MessagingAttrs, M as FeatureFlagAttrs, N as GraphQLAttrs, O as DeviceAttrs, P as HTTPClientAttrs, R as NetworkAttrs, S as ClientAttrs, T as ContainerAttrs, U as ServerAddressAttrs, V as ProcessAttrs, W as ServiceAttrs, Y as UserAttrs, _ as autoRedactPII, a as httpClient, b as validateAttribute, c as mergeServiceResource, d as setError, f as setException, g as AttributePolicy, h as AttributeGuardrails, i as dbClient, j as FaaSAttrs, k as ErrorAttrs, l as request, m as setUser, n as safeSetAttributes, o as httpServer, p as setSession, q as ThreadAttrs, s as identify, t as mergeAttrs, u as setDevice, w as CodeAttrs, x as attrs, z as OTelAttrs } from "./index-DolOVX6F.js";
-import { n as TraceContext$1, r as defineBaggageSchema, t as AttributeValue$2 } from "./trace-context-IuyoPyNq.js";
+import { a as AttributeRedactorPreset, c as REDACTOR_PATTERNS, d as builtinPatterns, f as createAttributeRedactor, i as AttributeRedactorFn, l as REDACTOR_PRESETS, m as normalizeAttributeRedactorConfig, n as AttributeRedactingProcessorOptions, o as BuiltinPatternName, p as createRedactedSpan, r as AttributeRedactorConfig, s as MaskFn, t as AttributeRedactingProcessor, u as ValuePatternConfig } from "./attribute-redacting-processor-CvBE0z1p.js";
+import { A as ExceptionAttrs, B as PeerAttrs, C as CloudAttrs, D as DeploymentAttrs, E as DBAttrs, F as HTTPServerAttrs, G as SessionAttrs, H as RPCAttrs, I as K8sAttrs, J as URLAttrs, K as TLSAttrs, L as MessagingAttrs, M as FeatureFlagAttrs, N as GraphQLAttrs, O as DeviceAttrs, P as HTTPClientAttrs, R as NetworkAttrs, S as ClientAttrs, T as ContainerAttrs, U as ServerAddressAttrs, V as ProcessAttrs, W as ServiceAttrs, Y as UserAttrs, _ as autoRedactPII, a as httpClient, b as validateAttribute, c as mergeServiceResource, d as setError, f as setException, g as AttributePolicy, h as AttributeGuardrails, i as dbClient, j as FaaSAttrs, k as ErrorAttrs, l as request, m as setUser, n as safeSetAttributes, o as httpServer, p as setSession, q as ThreadAttrs, s as identify, t as mergeAttrs, u as setDevice, w as CodeAttrs, x as attrs, z as OTelAttrs } from "./index-CwrNAsgk.js";
+import { t as UnknownRecord } from "./values-CeMH-mYG.js";
+import { n as TraceContext$1, r as defineBaggageSchema, t as AttributeValue$2 } from "./trace-context-f89xPJbK.js";
 import { BaggageError, BaggageFieldDefinition, BaggageFieldType, BusinessBaggage, BusinessBaggageValues, SafeBaggageOptions, SafeBaggageSchema, createSafeBaggageSchema } from "./business-baggage.js";
 import { CORRELATION_ID_BAGGAGE_KEY, generateCorrelationId, getCorrelationId, getOrCreateCorrelationId, runWithCorrelationId, setCorrelationId, setCorrelationIdInBaggage } from "./correlation-id.js";
-import { _ as createLinkFromHeaders, a as AlwaysSampler, b as resolveSamplingPreset, f as RandomSampler, g as UserIdSampler, h as SamplingPreset, i as AdaptiveSampler, m as SamplingContext, n as AUTOTEL_SAMPLING_TAIL_EVALUATED, p as Sampler, r as AUTOTEL_SAMPLING_TAIL_KEEP, u as NeverSampler, v as extractLinksFromBatch, x as samplingPresets } from "./sampling-CP3e7-Yr.js";
-import { a as getActiveTraceContext, c as trace$2, d as withTracing, f as InstrumentOptions, i as ctx, l as withBaggage, n as WithBaggageOptions, o as instrument, p as SingleInstrumentOptions, r as WithNewContextOptions, s as span, t as SpanOptions, u as withNewContext } from "./functional-AT22vCw6.js";
+import { _ as createLinkFromHeaders, a as AlwaysSampler, b as resolveSamplingPreset, f as RandomSampler, g as UserIdSampler, h as SamplingPreset, i as AdaptiveSampler, m as SamplingContext, n as AUTOTEL_SAMPLING_TAIL_EVALUATED, p as Sampler, r as AUTOTEL_SAMPLING_TAIL_KEEP, u as NeverSampler, v as extractLinksFromBatch, x as samplingPresets } from "./sampling-CM5S2Lp3.js";
+import { a as getActiveTraceContext, c as trace$2, d as withTracing, f as InstrumentOptions, i as ctx, l as withBaggage, n as WithBaggageOptions, o as instrument, p as SingleInstrumentOptions, r as WithNewContextOptions, s as span, t as SpanOptions, u as withNewContext } from "./functional-DXy1cHFF.js";
 import { DrainPipelineOptions, PipelineDrainFn, createDrainPipeline } from "./drain-pipeline.js";
-import { a as EventSubscriber, c as OutcomeStatus, i as EventSchemaMetadata, n as EventAttributes, o as EventTrackingOptions, s as FunnelStatus, t as AutotelEventContext } from "./event-subscriber-CWh8sTGh.js";
+import { a as EventSchemaMetadata, c as FunnelStatus, l as OutcomeStatus, n as EventAttributeValue, o as EventSubscriber, r as EventAttributes, s as EventTrackingOptions, t as AutotelEventContext } from "./event-subscriber-DMACQA-1.js";
 import { Event, EventsOptions, getEvents, resetEvents } from "./event.js";
 import { n as FilteringSpanProcessorOptions, r as SpanFilterPredicate, t as FilteringSpanProcessor } from "./filtering-span-processor-BpDagWNa.js";
-import { a as AutotelConfig, c as StringRedactor, i as lockLogger, l as createStringRedactor, n as isInitialized, r as isLoggerLocked, s as ProcessHandlersConfig, t as init } from "./init-CsODvlau.js";
+import { a as AutotelConfig, c as StringRedactor, i as lockLogger, l as createStringRedactor, n as isInitialized, r as isLoggerLocked, s as ProcessHandlersConfig, t as init } from "./init-BgnYi2sm.js";
 import { a as SpanNameNormalizerPreset, i as SpanNameNormalizerFn, n as NORMALIZER_PRESETS, o as SpanNameNormalizingProcessor, r as SpanNameNormalizerConfig, s as SpanNameNormalizingProcessorOptions, t as NORMALIZER_PATTERNS } from "./span-name-normalizer-CN1-8C76.js";
-import "./canonical-log-line-processor-CL_J7gb5.js";
-import { i as defineEvent, n as DefinedEvent, r as SchemaLike, t as DefineEventOptions } from "./define-event-B2z1SBe7.js";
+import "./canonical-log-line-processor-cPB4Axk-.js";
+import { i as defineEvent, n as DefinedEvent, r as SchemaLike, t as DefineEventOptions } from "./define-event-Bd8f8mST.js";
 import { ParsedError, parseError } from "./parse-error.js";
 import { Metric, MetricsOptions, getMetrics, resetMetrics } from "./metric.js";
 import { createCounter, createHistogram, createObservableGauge, createUpDownCounter, getMeter } from "./metric-helpers.js";
@@ -390,14 +391,14 @@ declare function shutdown(): Promise<void>;
 //#region src/request-logger.d.ts
 declare function runWithRequestContext<T>(ctx: TraceContext$1, fn: () => T): T;
 interface RequestLogger {
-  set(fields: Record<string, unknown>): void;
+  set(fields: UnknownRecord): void;
   /** Set snapshot severity without adding a log event or exception. */
   setLevel(level: RequestLogLevel): void;
-  info(message: string, fields?: Record<string, unknown>): void;
-  warn(message: string, fields?: Record<string, unknown>): void;
-  error(error: Error | string, fields?: Record<string, unknown>): void;
-  getContext(): Record<string, unknown>;
-  emitNow(overrides?: Record<string, unknown>): RequestLogSnapshot;
+  info(message: string, fields?: UnknownRecord): void;
+  warn(message: string, fields?: UnknownRecord): void;
+  error(error: Error | string, fields?: UnknownRecord): void;
+  getContext(): UnknownRecord;
+  emitNow(overrides?: UnknownRecord): RequestLogSnapshot;
   fork(label: string, fn: () => void | Promise<void>, options?: ForkOptions): void;
 }
 type RequestLogLevel = 'debug' | 'info' | 'warn' | 'error';
@@ -406,7 +407,7 @@ interface RequestLogSnapshot {
   traceId: string;
   spanId: string;
   correlationId: string;
-  context: Record<string, unknown>;
+  context: UnknownRecord;
 }
 interface RequestLoggerOptions {
   /** Callback invoked by emitNow() for manual fan-out. */
@@ -457,10 +458,10 @@ interface StructuredErrorInput {
   code?: string | number;
   status?: number;
   cause?: unknown;
-  details?: Record<string, unknown>;
+  details?: UnknownRecord;
   name?: string;
   /** Backend-only context. Omitted from toJSON() and never serialized to clients. */
-  internal?: Record<string, unknown>;
+  internal?: UnknownRecord;
 }
 interface StructuredError extends Error {
   why?: string;
@@ -468,16 +469,24 @@ interface StructuredError extends Error {
   link?: string;
   code?: string | number;
   status?: number;
-  details?: Record<string, unknown>;
+  details?: UnknownRecord;
   /** Backend-only context. Omitted from toJSON() and never serialized to clients. */
-  readonly internal?: Record<string, unknown>;
+  readonly internal?: UnknownRecord;
 }
 declare function createStructuredError(input: StructuredErrorInput): StructuredError;
-declare function structuredErrorToJSON(error: StructuredError): Record<string, unknown>;
-declare function getStructuredErrorAttributes(error: Error): Record<string, AttributeValue$2>;
+declare function structuredErrorToJSON(error: StructuredError): UnknownRecord;
+/** The `error.*` attributes a failure contributes to a span. */
+type ErrorAttributes = Record<string, AttributeValue$2>;
+declare function getStructuredErrorAttributes(error: Error): ErrorAttributes;
 declare function recordStructuredError(ctx: Pick<TraceContext$1, 'setAttributes' | 'setStatus'>, error: Error): void;
 //#endregion
 //#region src/error-catalog.d.ts
+/**
+ * Structured fields attached to a log line or an error. They are serialized by
+ * whatever sink receives them, so a value that cannot survive JSON has no
+ * meaning here - which is what EventAttributeValue names.
+ */
+type LogFields = Record<string, EventAttributeValue>;
 /** Definition of a single error in a catalog. */
 interface ErrorCatalogEntry {
   /**
@@ -501,9 +510,9 @@ interface ErrorCatalogEntry {
 /** Per-call options passed alongside (or instead of) typed params. */
 interface ErrorBuildOptions {
   cause?: unknown;
-  details?: Record<string, unknown>;
+  details?: LogFields;
   /** Backend-only context. Never serialized to clients. */
-  internal?: Record<string, unknown>;
+  internal?: LogFields;
 }
 type ParamsOf<E> = E extends {
   message: (params: infer P) => string;
@@ -563,15 +572,21 @@ declare function defineAuditCatalog<const T extends Record<string, AuditCatalogE
 //#endregion
 //#region src/flatten-attributes.d.ts
 /**
- * Convert an unknown value to an OTel-compatible AttributeValue.
- * Returns undefined when the value cannot be represented.
+ * Convert a value that arrived from outside to an OTel-compatible
+ * AttributeValue. Returns undefined when the value cannot be represented -
+ * which is how flattenToAttributes below learns it has an object to descend
+ * into rather than a leaf to record.
  */
 declare function toAttributeValue(value: unknown): AttributeValue$2 | undefined;
+/** A flat, dot-notation attribute bag: what a nested object flattens to. */
+interface FlatAttributes {
+  [key: string]: AttributeValue$2;
+}
 /**
  * Recursively flatten a nested object into dot-notation OTel attributes.
  * Includes circular reference protection via WeakSet.
  */
-declare function flattenToAttributes(fields: Record<string, unknown>, prefix?: string): Record<string, AttributeValue$2>;
+declare function flattenToAttributes(fields: UnknownRecord, prefix?: string): FlatAttributes;
 //#endregion
 //#region src/drain-toolkit.d.ts
 interface DrainOptions<TContext, TConfig, TPayload = TContext> {
@@ -600,7 +615,7 @@ declare function defineDrain<TContext, TConfig, TPayload = TContext>(options: Dr
 declare function defineHttpDrain<TContext, TConfig, TPayload = TContext>(options: HttpDrainOptions<TContext, TConfig, TPayload>): (ctx: TContext | TContext[]) => Promise<void>;
 //#endregion
 //#region src/enricher-toolkit.d.ts
-interface EnrichContext<TEvent extends Record<string, unknown>> {
+interface EnrichContext<TEvent extends UnknownRecord> {
   event: TEvent;
   request?: {
     method?: string;
@@ -612,7 +627,7 @@ interface EnrichContext<TEvent extends Record<string, unknown>> {
   };
   headers?: Record<string, string>;
 }
-interface EnricherDefinition<TEvent extends Record<string, unknown>, TValue extends object> {
+interface EnricherDefinition<TEvent extends UnknownRecord, TValue extends object> {
   /** Stable identifier used in error logs. */
   name: string;
   /** Top-level field to merge computed values into. */
@@ -624,7 +639,7 @@ interface EnricherOptions {
   /** Replace existing field value instead of merge. Default false. */
   overwrite?: boolean;
 }
-declare function defineEnricher<TEvent extends Record<string, unknown>, TValue extends object>(def: EnricherDefinition<TEvent, TValue>, options?: EnricherOptions): (ctx: EnrichContext<TEvent>) => void;
+declare function defineEnricher<TEvent extends UnknownRecord, TValue extends object>(def: EnricherDefinition<TEvent, TValue>, options?: EnricherOptions): (ctx: EnrichContext<TEvent>) => void;
 //#endregion
 //#region src/pretty-log-formatter.d.ts
 /**

package/dist/index.js

@@ -1,23 +1,24 @@
+import { g as nonEmptyString, i as asNumber, l as asString, r as asFunction, s as asRecord, x as toError } from "./values-BenyvWKz.js";
 import { getAutotelTracer, getAutotelTracerProvider, setAutotelTracerProvider } from "./tracer-provider.js";
 import { AUTOTEL_SAMPLING_TAIL_EVALUATED, AUTOTEL_SAMPLING_TAIL_KEEP, AdaptiveSampler, AlwaysSampler, NeverSampler, RandomSampler, UserIdSampler, createLinkFromHeaders, extractLinksFromBatch, resolveSamplingPreset, samplingPresets } from "./sampling.js";
-import { A as BaggageSpanProcessor, C as setCorrelationId, E as defineBaggageSchema, S as runWithCorrelationId, T as createTraceContext, _ as CORRELATION_ID_BAGGAGE_KEY, a as isInitialized, c as flush, d as getEvents, f as resetEvents, g as track, h as getEventQueue, i as init, k as createStringRedactor, l as shutdown, m as runInOperationContext, o as isLoggerLocked, p as getOperationContext, s as lockLogger, u as Event, v as generateCorrelationId, w as setCorrelationIdInBaggage, x as getOrCreateCorrelationId, y as getCorrelationId } from "./init-BxfZ3Vbw.js";
+import { A as createStringRedactor, C as setCorrelationId, E as defineBaggageSchema, S as runWithCorrelationId, T as createTraceContext, _ as CORRELATION_ID_BAGGAGE_KEY, a as isInitialized, c as flush, d as getEvents, f as resetEvents, g as track, h as getEventQueue, i as init, j as BaggageSpanProcessor, l as shutdown, m as runInOperationContext, o as isLoggerLocked, p as getOperationContext, s as lockLogger, u as Event, v as generateCorrelationId, w as setCorrelationIdInBaggage, x as getOrCreateCorrelationId, y as getCorrelationId } from "./init-JtX-KKz_.js";
 import { FilteringSpanProcessor } from "./filtering-span-processor.js";
 import { NORMALIZER_PATTERNS, NORMALIZER_PRESETS, SpanNameNormalizingProcessor } from "./span-name-normalizer.js";
 import { AttributeRedactingProcessor, REDACTOR_PATTERNS, REDACTOR_PRESETS, builtinPatterns, createAttributeRedactor, createRedactedSpan, normalizeAttributeRedactorConfig } from "./attribute-redacting-processor.js";
-import { n as formatDuration } from "./canonical-log-line-processor-B0vq_QR6.js";
-import { a as flattenToAttributes, i as structuredErrorToJSON, n as getStructuredErrorAttributes, o as toAttributeValue, r as recordStructuredError, t as createStructuredError } from "./structured-error-9--cxBay.js";
+import { n as formatDuration } from "./canonical-log-line-processor-hFUmS__K.js";
+import { a as flattenToAttributes, i as structuredErrorToJSON, n as getStructuredErrorAttributes, o as toAttributeValue, r as recordStructuredError, t as createStructuredError } from "./structured-error-YIuka-FE.js";
 import { Metric, getMetrics, resetMetrics } from "./metric.js";
 import { createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan } from "./trace-helpers.js";
-import { a as trace$2, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-0o9xSedq.js";
-import { t as hashJson } from "./stable-hash-ChFBIhNt.js";
-import { t as emitCorrelatedEvent } from "./correlated-events-Bzh5y-UB.js";
+import { a as trace$2, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-uSbNnnxK.js";
+import { t as hashJson } from "./stable-hash-BkoAYVks.js";
+import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";
 import { parseError } from "./parse-error.js";
 import { createDrainPipeline } from "./drain-pipeline.js";
 import { createCounter, createHistogram, createObservableGauge, createUpDownCounter, getMeter } from "./metric-helpers.js";
 import { traceDB, traceHTTP, traceMessaging } from "./semantic-helpers.js";
 import { C as URLAttributes, d as HTTPAttributes, y as ServiceAttributes } from "./registry-DVSmWg6Y.js";
 import { httpRequestHeaderAttribute, httpResponseHeaderAttribute } from "./semantic-conventions.js";
-import { a as identify, c as setDevice, d as setSession, f as setUser, h as autoRedactPII, i as httpServer, l as setError, m as safeSetAttributes, n as dbClient, o as mergeServiceResource, p as mergeAttrs, r as httpClient, s as request, u as setException, v as validateAttribute, y as attrs } from "./attributes-B7wix2VG.js";
+import { a as identify, c as setDevice, d as setSession, f as setUser, h as autoRedactPII, i as httpServer, l as setError, m as safeSetAttributes, n as dbClient, o as mergeServiceResource, p as mergeAttrs, r as httpClient, s as request, u as setException, v as validateAttribute, y as attrs } from "./attributes-Dt4YUYbP.js";
 import { traceConsumer, traceProducer } from "./messaging.js";
 import { BusinessBaggage, createSafeBaggageSchema } from "./business-baggage.js";
 import { getCurrentWorkflowContext, isInWorkflow, traceStep, traceWorkflow } from "./workflow.js";
@@ -83,7 +84,9 @@ function mergeInto$1(target, source) {
 		const sourceVal = source[key];
 		if (sourceVal === void 0) continue;
 		const targetVal = target[key];
-		if (sourceVal !== null && typeof sourceVal === "object" && !Array.isArray(sourceVal) && targetVal !== null && typeof targetVal === "object" && !Array.isArray(targetVal)) mergeInto$1(targetVal, sourceVal);
+		const sourceRecord = asRecord(sourceVal);
+		const targetRecord = asRecord(targetVal);
+		if (sourceRecord && targetRecord) mergeInto$1(targetRecord, sourceRecord);
 		else if (Array.isArray(targetVal) && Array.isArray(sourceVal)) target[key] = [...targetVal, ...sourceVal];
 		else target[key] = sourceVal;
 	}
@@ -154,7 +157,7 @@ function getRequestLogger(ctx, options) {
 			const keys = fields ? [...Object.keys(fields), "error"] : ["error"];
 			sealCheck("log.error()", keys);
 			if (emitted) return;
-			const err = typeof error === "string" ? new Error(error) : error;
+			const err = toError(error);
 			recordStructuredError(activeContext, err);
 			addLogEvent("error", err.message, fields);
 			if (fields) {
@@ -193,8 +196,8 @@ function getRequestLogger(ctx, options) {
 			return snapshot;
 		},
 		fork(label, fn, forkOptions) {
-			const parentRequestId = activeContext.correlationId;
-			if (typeof parentRequestId !== "string" || parentRequestId.length === 0) throw new Error("[autotel] log.fork() requires the parent logger to have a correlationId. Ensure the request was created by autotel middleware.");
+			const parentRequestId = nonEmptyString(activeContext.correlationId);
+			if (parentRequestId === void 0) throw new Error("[autotel] log.fork() requires the parent logger to have a correlationId. Ensure the request was created by autotel middleware.");
 			const tracer = trace$1.getTracer("autotel.request-logger");
 			const lifecycle = forkOptions?.lifecycle;
 			tracer.startActiveSpan(`request.fork:${label}`, (childSpan) => {
@@ -212,8 +215,7 @@ function getRequestLogger(ctx, options) {
 					Promise.resolve().then(() => fn()).then(() => {
 						childLog.emitNow();
 					}).catch((error_) => {
-						const error = error_ instanceof Error ? error_ : new Error(String(error_));
-						childLog.error(error);
+						childLog.error(toError(error_));
 						childLog.emitNow();
 					}).finally(() => {
 						try {
@@ -316,8 +318,9 @@ function createNoopRequestLogger() {
 */
 const catalogCodeKey = Symbol.for("autotel.catalog.code");
 function readCatalogCode(error) {
-	if (error === null || typeof error !== "object") return void 0;
-	return error[catalogCodeKey];
+	if (!asRecord(error)) return void 0;
+	const stored = error[catalogCodeKey];
+	return asString(stored) ?? asNumber(stored);
 }
 /** True when `error` was produced by any autotel error catalog. */
 function isCatalogError(error) {
@@ -336,23 +339,25 @@ function defineErrorCatalog(namespace, entries) {
 	const catalog = {};
 	for (const [key, entry] of Object.entries(entries)) {
 		const code = entry.code ?? `${namespace}.${key}`;
-		const usesParams = typeof entry.message === "function" || typeof entry.why === "function";
+		const messageFor = asFunction(entry.message);
+		const whyFor = asFunction(entry.why);
+		const usesParams = Boolean(messageFor || whyFor);
 		const builder = ((paramsOrOptions, maybeOptions) => {
 			const params = usesParams ? paramsOrOptions : void 0;
 			const options = usesParams ? maybeOptions : paramsOrOptions;
-			const message = typeof entry.message === "function" ? entry.message(params) : entry.message;
-			const why = typeof entry.why === "function" ? entry.why(params) : entry.why;
+			const message = messageFor ? String(messageFor(params)) : asString(entry.message) ?? "";
+			const why = whyFor ? String(whyFor(params)) : asString(entry.why);
 			const error = createStructuredError({
 				message,
 				name: entry.name ?? key,
 				code,
-				...entry.status === void 0 ? {} : { status: entry.status },
-				...why === void 0 ? {} : { why },
-				...entry.fix === void 0 ? {} : { fix: entry.fix },
-				...entry.link === void 0 ? {} : { link: entry.link },
-				...options?.cause === void 0 ? {} : { cause: options.cause },
-				...options?.details === void 0 ? {} : { details: options.details },
-				...options?.internal === void 0 ? {} : { internal: options.internal }
+				status: entry.status,
+				why,
+				fix: entry.fix,
+				link: entry.link,
+				cause: options?.cause,
+				details: options?.details,
+				internal: options?.internal
 			});
 			Object.defineProperty(error, catalogCodeKey, {
 				value: code,
@@ -383,12 +388,13 @@ function defineAuditCatalog(namespace, entries) {
 	for (const [key, entry] of Object.entries(entries)) {
 		const action = entry.action ?? `${namespace}.${key}`;
 		const severity = entry.severity ?? "info";
+		const auditMessageFor = asFunction(entry.message);
 		const descriptor = ((params) => {
-			const message = typeof entry.message === "function" ? entry.message(params) : entry.message;
+			const message = auditMessageFor ? String(auditMessageFor(params)) : asString(entry.message);
 			return Object.freeze({
 				action,
 				severity,
-				...message === void 0 ? {} : { message }
+				message
 			});
 		});
 		Object.defineProperty(descriptor, "action", {
@@ -476,15 +482,13 @@ function defineHttpDrain(options) {
 
 //#endregion
 //#region src/enricher-toolkit.ts
-function isPlainObject(value) {
-	return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 function mergeInto(target, source) {
 	for (const key in source) {
 		const sourceVal = source[key];
 		if (sourceVal === void 0) continue;
-		const targetVal = target[key];
-		if (isPlainObject(sourceVal) && isPlainObject(targetVal)) mergeInto(targetVal, sourceVal);
+		const sourceRecord = asRecord(sourceVal);
+		const targetRecord = asRecord(target[key]);
+		if (sourceRecord && targetRecord) mergeInto(targetRecord, sourceRecord);
 		else target[key] = sourceVal;
 	}
 }
@@ -498,11 +502,13 @@ function defineEnricher(def, options = {}) {
 			return;
 		}
 		if (!computed) return;
-		if (options.overwrite || !isPlainObject(ctx.event[def.field])) {
-			ctx.event[def.field] = computed;
+		const event = ctx.event;
+		const existing = asRecord(event[def.field]);
+		if (options.overwrite || !existing) {
+			event[def.field] = computed;
 			return;
 		}
-		mergeInto(ctx.event[def.field], computed);
+		mergeInto(existing, computed);
 	};
 }
 

package/dist/{init-CsODvlau.d.ts → init-BgnYi2sm.d.ts}

@@ -1,13 +1,13 @@
-import { a as AttributeRedactorPreset, r as AttributeRedactorConfig } from "./attribute-redacting-processor-Pk7lAzWd.js";
-import { s as Logger } from "./logger-CN4xpzMd.js";
-import { h as SamplingPreset, p as Sampler } from "./sampling-CP3e7-Yr.js";
-import { a as EventSubscriber } from "./event-subscriber-CWh8sTGh.js";
+import { a as AttributeRedactorPreset, r as AttributeRedactorConfig } from "./attribute-redacting-processor-CvBE0z1p.js";
+import { s as Logger } from "./logger-S1Fgl0g3.js";
+import { h as SamplingPreset, p as Sampler } from "./sampling-CM5S2Lp3.js";
+import { o as EventSubscriber } from "./event-subscriber-DMACQA-1.js";
 import { r as SpanFilterPredicate } from "./filtering-span-processor-BpDagWNa.js";
 import { r as Policy } from "./policy-CbpP4tFH.js";
 import { r as SpanNameNormalizerConfig } from "./span-name-normalizer-CN1-8C76.js";
-import { t as CanonicalLogLineOptions } from "./canonical-log-line-processor-CL_J7gb5.js";
+import { t as CanonicalLogLineOptions } from "./canonical-log-line-processor-cPB4Axk-.js";
 import { NodeSDK, NodeSDKConfiguration } from "@opentelemetry/sdk-node";
-import { SpanExporter, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import { ReadableSpan, SpanExporter, SpanProcessor } from "@opentelemetry/sdk-trace-base";
 import { Resource } from "@opentelemetry/resources";
 import { Attributes } from "@opentelemetry/api";
 import { MetricReader } from "@opentelemetry/sdk-metrics";
@@ -223,6 +223,73 @@ interface ProcessHandlersConfig {
   shutdownTimeoutMs?: number;
 }
 //#endregion
+//#region src/canonical-log-lines-config.d.ts
+/**
+ * Emit completed spans as canonical wide-event logs.
+ *
+ * Each span (or only each root span) becomes one comprehensive log record with
+ * all span attributes. This provides high-cardinality, structured events
+ * without scattering logging calls throughout a request.
+ *
+ * @example One canonical log line per request
+ * ```typescript
+ * init({
+ *   service: 'checkout-api',
+ *   canonicalLogLines: {
+ *     enabled: true,
+ *     rootSpansOnly: true,
+ *   },
+ * });
+ * ```
+ *
+ * @example Custom logger and message
+ * ```typescript
+ * const logger = pino();
+ * init({
+ *   service: 'checkout-api',
+ *   logger,
+ *   canonicalLogLines: {
+ *     enabled: true,
+ *     logger,
+ *     messageFormat: (span) => {
+ *       const status = span.status.code === 2 ? 'ERROR' : 'SUCCESS';
+ *       return `${span.name} [${status}]`;
+ *     },
+ *   },
+ * });
+ * ```
+ */
+interface CanonicalLogLinesConfig {
+  enabled: boolean;
+  /** Logger to use for emitting canonical log lines (defaults to OTel Logs API). */
+  logger?: Logger;
+  /** Only emit canonical log lines for root spans (default: false). */
+  rootSpansOnly?: boolean;
+  /** Minimum log level for canonical log lines (default: 'info'). */
+  minLevel?: 'debug' | 'info' | 'warn' | 'error';
+  /** Custom message format (default: uses the span name). */
+  messageFormat?: (span: ReadableSpan) => string;
+  /** Whether to include resource attributes (default: true). */
+  includeResourceAttributes?: boolean;
+  /** Predicate to decide whether to emit (runs after the event is built). */
+  shouldEmit?: CanonicalLogLineOptions['shouldEmit'];
+  /**
+   * Declarative tail sampling conditions (OR logic).
+   * Ignored when `shouldEmit` is provided.
+   * @example keep: [{ status: 500 }, { durationMs: 1000 }]
+   */
+  keep?: CanonicalLogLineOptions['keep'];
+  /** Callback invoked after emit for custom fan-out. */
+  drain?: CanonicalLogLineOptions['drain'];
+  /** Handler for drain failures. */
+  onDrainError?: CanonicalLogLineOptions['onDrainError'];
+  /**
+   * Pretty-print canonical log lines to console.
+   * Defaults to true when NODE_ENV is 'development'.
+   */
+  pretty?: boolean;
+}
+//#endregion
 //#region src/otlp-exporters.d.ts
 type OtlpSignal = 'traces' | 'metrics' | 'logs';
 interface OtlpDestinationConfig {
@@ -465,6 +532,24 @@ interface AutotelConfig {
    * ```
    */
   spanProcessors?: SpanProcessor[];
+  /**
+   * Span processors that decorate spans on the way out, running before every
+   * exporting processor.
+   *
+   * Unlike {@link spanProcessors}, which replaces the pipeline autotel would
+   * have built, these are added to it. Use them for processors that enrich
+   * rather than export, so `destinations` keeps working:
+   *
+   * @example
+   * ```typescript
+   * init({
+   *   service: 'support-agent',
+   *   destinations: [{ endpoint: `${langfuseUrl}/api/public/otel`, headers }],
+   *   spanEnrichers: [langfuseCompatibility({ tags: ['production'] })],
+   * })
+   * ```
+   */
+  spanEnrichers?: SpanProcessor[];
   /**
    * Custom span processor for traces (single-item alias of spanProcessors)
    * @deprecated Use spanProcessors for consistency with other multi-value config fields
@@ -1105,89 +1190,8 @@ interface AutotelConfig {
     enabled: boolean;
     options?: Record<string, unknown>;
   };
-  /**
-   * Canonical log lines - automatically emit spans as wide events (canonical log lines)
-   *
-   * When enabled, each span (or root span only) is automatically emitted as a
-   * comprehensive log record with ALL span attributes. This implements the
-   * "canonical log line" pattern: one comprehensive event per request with all context.
-   *
-   * **Benefits:**
-   * - One log line per request with all context (wide event)
-   * - High-cardinality, high-dimensionality data for powerful queries
-   * - Automatic - no manual logging needed
-   * - Queryable as structured data instead of string search
-   *
-   * @example Basic usage (one canonical log line per request)
-   * ```typescript
-   * init({
-   *   service: 'checkout-api',
-   *   canonicalLogLines: {
-   *     enabled: true,
-   *     rootSpansOnly: true, // One canonical log line per request
-   *   },
-   * });
-   * ```
-   *
-   * @example With custom logger
-   * ```typescript
-   * import pino from 'pino';
-   * const logger = pino();
-   * init({
-   *   service: 'my-app',
-   *   logger,
-   *   canonicalLogLines: {
-   *     enabled: true,
-   *     logger, // Use Pino for canonical log lines
-   *     rootSpansOnly: true,
-   *   },
-   * });
-   * ```
-   *
-   * @example Custom message format
-   * ```typescript
-   * init({
-   *   service: 'my-app',
-   *   canonicalLogLines: {
-   *     enabled: true,
-   *     messageFormat: (span) => {
-   *       const status = span.status.code === 2 ? 'ERROR' : 'SUCCESS';
-   *       return `${span.name} [${status}]`;
-   *     },
-   *   },
-   * });
-   * ```
-   */
-  canonicalLogLines?: {
-    enabled: boolean;
-    /** Logger to use for emitting canonical log lines (defaults to OTel Logs API) */
-    logger?: Logger;
-    /** Only emit canonical log lines for root spans (default: false) */
-    rootSpansOnly?: boolean;
-    /** Minimum log level for canonical log lines (default: 'info') */
-    minLevel?: 'debug' | 'info' | 'warn' | 'error';
-    /** Custom message format (default: uses span name) */
-    messageFormat?: (span: import('@opentelemetry/sdk-trace-base').ReadableSpan) => string;
-    /** Whether to include resource attributes (default: true) */
-    includeResourceAttributes?: boolean;
-    /** Predicate to decide whether to emit (runs after event is built). */
-    shouldEmit?: CanonicalLogLineOptions['shouldEmit'];
-    /**
-     * Declarative tail sampling conditions (OR logic).
-     * Ignored when `shouldEmit` is provided.
-     * @example keep: [{ status: 500 }, { durationMs: 1000 }]
-     */
-    keep?: CanonicalLogLineOptions['keep'];
-    /** Callback invoked after emit for custom fan-out. */
-    drain?: CanonicalLogLineOptions['drain'];
-    /** Handler for drain failures. */
-    onDrainError?: CanonicalLogLineOptions['onDrainError'];
-    /**
-     * Pretty-print canonical log lines to console.
-     * Defaults to true when NODE_ENV is 'development'.
-     */
-    pretty?: boolean;
-  };
+  /** Emit completed spans as canonical wide-event logs. */
+  canonicalLogLines?: CanonicalLogLinesConfig;
   /**
    * Suppress console output while keeping OTel exporters running.
    * Useful for platforms like GCP Cloud Run / AWS Lambda where stdout
@@ -1229,7 +1233,7 @@ declare function isLoggerLocked(): boolean;
  *
  * @example With events (observe in PostHog, Mixpanel, etc.)
  * ```typescript
- * import { PostHogSubscriber } from 'autotel-subscribers/posthog';
+ * import { PostHogSubscriber } from 'autotel-posthog/subscriber';
  *
  * init({
  *   service: 'my-app',