autotel 6.4.1 → 7.0.0

package/dist/{index-BPcxVucm.d.cts → index-DQHf4cNl.d.cts}

@@ -1,5 +1,5 @@
-import { n as TraceContext, t as AttributeValue$1 } from "./trace-context-IuyoPyNq.cjs";
-import { Span } from "@opentelemetry/api";
+import { n as TraceContext, t as AttributeValue$1 } from "./trace-context-C1Cn1q0y.cjs";
+import { AttributeValue, Attributes, Span } from "@opentelemetry/api";
 import { Resource } from "@opentelemetry/resources";
 //#region src/attributes/types.d.ts
 interface UserAttrs {
@@ -201,7 +201,7 @@ declare const attrs: {
     readonly roles: (value: string[]) => {
       "user.roles": string[];
     };
-    readonly data: (data: UserAttrs) => Record<string, unknown>;
+    readonly data: (data: UserAttrs) => Attributes;
   };
   readonly session: {
     readonly id: (value: string) => {
@@ -210,7 +210,7 @@ declare const attrs: {
     readonly previousId: (value: string) => {
       "session.previous_id": string;
     };
-    readonly data: (data: SessionAttrs) => Record<string, unknown>;
+    readonly data: (data: SessionAttrs) => Attributes;
   };
   readonly device: {
     readonly id: (value: string) => {
@@ -225,7 +225,7 @@ declare const attrs: {
     readonly modelName: (value: string) => {
       "device.model.name": string;
     };
-    readonly data: (data: DeviceAttrs) => Record<string, unknown>;
+    readonly data: (data: DeviceAttrs) => Attributes;
   };
   readonly http: {
     readonly request: {
@@ -262,8 +262,8 @@ declare const attrs: {
     readonly connectionState: (value: string) => {
       "http.connection.state": string;
     };
-    readonly server: (data: HTTPServerAttrs) => Record<string, unknown>;
-    readonly client: (data: HTTPClientAttrs) => Record<string, unknown>;
+    readonly server: (data: HTTPServerAttrs) => Attributes;
+    readonly client: (data: HTTPClientAttrs) => Attributes;
   };
   readonly db: {
     readonly client: {
@@ -294,7 +294,7 @@ declare const attrs: {
       readonly rowsReturned: (value: number) => {
         "db.response.returned_rows": number;
       };
-      readonly data: (data: DBAttrs) => Record<string, unknown>;
+      readonly data: (data: DBAttrs) => Attributes;
     };
   };
   readonly service: {
@@ -307,7 +307,7 @@ declare const attrs: {
     readonly version: (value: string) => {
       "service.version": string;
     };
-    readonly data: (data: ServiceAttrs) => Record<string, unknown>;
+    readonly data: (data: ServiceAttrs) => Attributes;
   };
   readonly network: {
     readonly peerAddress: (value: string) => {
@@ -325,7 +325,7 @@ declare const attrs: {
     readonly protocolVersion: (value: string) => {
       "network.protocol.version": string;
     };
-    readonly data: (data: NetworkAttrs) => Record<string, unknown>;
+    readonly data: (data: NetworkAttrs) => Attributes;
   };
   readonly server: {
     readonly address: (value: string) => {
@@ -337,7 +337,7 @@ declare const attrs: {
     readonly socketAddress: (value: string) => {
       "server.socket.address": string;
     };
-    readonly data: (data: ServerAddressAttrs) => Record<string, unknown>;
+    readonly data: (data: ServerAddressAttrs) => Attributes;
   };
   readonly url: {
     readonly scheme: (value: string) => {
@@ -355,7 +355,7 @@ declare const attrs: {
     readonly fragment: (value: string) => {
       "url.fragment": string;
     };
-    readonly data: (data: URLAttrs) => Record<string, unknown>;
+    readonly data: (data: URLAttrs) => Attributes;
   };
   readonly error: {
     readonly type: (value: string) => {
@@ -370,7 +370,7 @@ declare const attrs: {
     readonly code: (value: string | number) => {
       "error.code": string | number;
     };
-    readonly data: (data: ErrorAttrs) => Record<string, unknown>;
+    readonly data: (data: ErrorAttrs) => Attributes;
   };
   readonly exception: {
     readonly escaped: (value: boolean) => {
@@ -388,7 +388,7 @@ declare const attrs: {
     readonly moduleName: (value: string) => {
       "exception.module": string;
     };
-    readonly data: (data: ExceptionAttrs) => Record<string, unknown>;
+    readonly data: (data: ExceptionAttrs) => Attributes;
   };
   readonly process: {
     readonly pid: (value: number) => {
@@ -403,7 +403,7 @@ declare const attrs: {
     readonly owner: (value: string) => {
       "process.owner": string;
     };
-    readonly data: (data: ProcessAttrs) => Record<string, unknown>;
+    readonly data: (data: ProcessAttrs) => Attributes;
   };
   readonly thread: {
     readonly id: (value: number) => {
@@ -426,7 +426,7 @@ declare const attrs: {
     readonly tag: (value: string) => {
       "container.image.tag": string;
     };
-    readonly data: (data: ContainerAttrs) => Record<string, unknown>;
+    readonly data: (data: ContainerAttrs) => Attributes;
   };
   readonly k8s: {
     readonly podName: (value: string) => {
@@ -458,7 +458,7 @@ declare const attrs: {
     readonly platform: (value: string) => {
       "cloud.platform": string;
     };
-    readonly data: (data: CloudAttrs) => Record<string, unknown>;
+    readonly data: (data: CloudAttrs) => Attributes;
   };
   readonly faas: {
     readonly name: (value: string) => {
@@ -504,7 +504,7 @@ declare const attrs: {
     readonly conversationId: (value: string) => {
       "messaging.conversation_id": string;
     };
-    readonly data: (data: MessagingAttrs) => Record<string, unknown>;
+    readonly data: (data: MessagingAttrs) => Attributes;
   };
   readonly rpc: {
     readonly system: (value: string) => {
@@ -588,10 +588,6 @@ declare const attrs: {
 };
 //#endregion
 //#region src/attributes/validators.d.ts
-/**
- * Attribute validation, PII detection, and guardrails
- * Provides safe-by-default attribute handling with configurable policies
- */
 interface AttributeGuardrails {
   /** How to handle PII in attributes */
   pii?: 'allow' | 'redact' | 'hash' | 'block';
@@ -609,9 +605,9 @@ interface AttributePolicy {
   /** Custom deprecation warnings for specific attributes */
   deprecatedWarnings?: Record<string, string>;
 }
-declare function validateAttribute(key: string, value: unknown, policy?: AttributePolicy): unknown;
+declare function validateAttribute(key: string, value: AttributeValue | undefined, policy?: AttributePolicy): AttributeValue | undefined;
 declare function checkDeprecatedAttribute(key: string, policy?: AttributePolicy): string | null;
-declare function autoRedactPII(attributes: Record<string, unknown>, policy?: AttributePolicy): Record<string, unknown>;
+declare function autoRedactPII(attributes: Attributes, policy?: AttributePolicy): Attributes;
 declare function defaultGuardrails(): AttributeGuardrails;
 //#endregion
 //#region src/attributes/attachers.d.ts
@@ -670,7 +666,7 @@ declare function transaction(spanOrContext: TraceContext, config: {
 type AttributeSetter = {
   setAttributes: (attrs: Record<string, AttributeValue$1>) => void;
 };
-declare function mergeAttrs(...attrSets: Array<Record<string, unknown> | undefined>): Record<string, unknown>;
-declare function safeSetAttributes(span: AttributeSetter, attrs: Record<string, unknown>, policy?: AttributePolicy): void;
+declare function mergeAttrs(...attrSets: Array<Attributes | undefined>): Attributes;
+declare function safeSetAttributes(span: AttributeSetter, attrs: Attributes, policy?: AttributePolicy): void;
 //#endregion
 export { ExceptionAttrs as A, PeerAttrs as B, CloudAttrs as C, DeploymentAttrs as D, DBAttrs as E, HTTPServerAttrs as F, SessionAttrs as G, RPCAttrs as H, K8sAttrs as I, URLAttrs as J, TLSAttrs as K, MessagingAttrs as L, FeatureFlagAttrs as M, GraphQLAttrs as N, DeviceAttrs as O, HTTPClientAttrs as P, NetworkAttrs as R, ClientAttrs as S, ContainerAttrs as T, ServerAddressAttrs as U, ProcessAttrs as V, ServiceAttrs as W, UserAttrs as Y, autoRedactPII as _, httpClient as a, validateAttribute as b, mergeServiceResource as c, setError as d, setException as f, AttributePolicy as g, AttributeGuardrails as h, dbClient as i, FaaSAttrs as j, ErrorAttrs as k, request as l, setUser as m, safeSetAttributes as n, httpServer as o, setSession as p, ThreadAttrs as q, transaction as r, identify as s, mergeAttrs as t, setDevice as u, checkDeprecatedAttribute as v, CodeAttrs as w, attrs as x, defaultGuardrails as y, OTelAttrs as z };

package/dist/index.cjs

@@ -1,25 +1,26 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
+const require_values = require('./values-DApyq53y.cjs');
 const require_tracer_provider = require('./tracer-provider.cjs');
 const require_sampling = require('./sampling.cjs');
-const require_init = require('./init-BnxHAi2M.cjs');
+const require_init = require('./init-D4m5rCmD.cjs');
 const require_filtering_span_processor = require('./filtering-span-processor.cjs');
 const require_span_name_normalizer = require('./span-name-normalizer.cjs');
 const require_attribute_redacting_processor = require('./attribute-redacting-processor.cjs');
-const require_canonical_log_line_processor = require('./canonical-log-line-processor-DxtBGZIi.cjs');
-const require_structured_error = require('./structured-error-CHg7DoIQ.cjs');
+const require_canonical_log_line_processor = require('./canonical-log-line-processor-DolzdawH.cjs');
+const require_structured_error = require('./structured-error--_wXpd_C.cjs');
 const require_metric = require('./metric.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
-const require_functional = require('./functional-qZxRcIBp.cjs');
-const require_stable_hash = require('./stable-hash-CS9BxvVQ.cjs');
-const require_correlated_events = require('./correlated-events-kSwLo3mi.cjs');
+const require_functional = require('./functional-Da6Yv64r.cjs');
+const require_stable_hash = require('./stable-hash-C0pOegH_.cjs');
+const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');
 const require_parse_error = require('./parse-error.cjs');
 const require_drain_pipeline = require('./drain-pipeline.cjs');
 const require_metric_helpers = require('./metric-helpers.cjs');
 const require_semantic_helpers = require('./semantic-helpers.cjs');
 const require_registry = require('./registry-DYgvb62e.cjs');
 const require_semantic_conventions = require('./semantic-conventions.cjs');
-const require_attributes = require('./attributes-aDmJYral.cjs');
+const require_attributes = require('./attributes-Cxys8tgr.cjs');
 const require_messaging = require('./messaging.cjs');
 const require_business_baggage = require('./business-baggage.cjs');
 const require_workflow = require('./workflow.cjs');
@@ -86,7 +87,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 = require_values.asRecord(sourceVal);
+		const targetRecord = require_values.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;
 	}
@@ -157,7 +160,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 = require_values.toError(error);
 			require_structured_error.recordStructuredError(activeContext, err);
 			addLogEvent("error", err.message, fields);
 			if (fields) {
@@ -196,8 +199,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 = require_values.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 = _opentelemetry_api.trace.getTracer("autotel.request-logger");
 			const lifecycle = forkOptions?.lifecycle;
 			tracer.startActiveSpan(`request.fork:${label}`, (childSpan) => {
@@ -215,8 +218,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(require_values.toError(error_));
 						childLog.emitNow();
 					}).finally(() => {
 						try {
@@ -319,8 +321,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 (!require_values.asRecord(error)) return void 0;
+	const stored = error[catalogCodeKey];
+	return require_values.asString(stored) ?? require_values.asNumber(stored);
 }
 /** True when `error` was produced by any autotel error catalog. */
 function isCatalogError(error) {
@@ -339,23 +342,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 = require_values.asFunction(entry.message);
+		const whyFor = require_values.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)) : require_values.asString(entry.message) ?? "";
+			const why = whyFor ? String(whyFor(params)) : require_values.asString(entry.why);
 			const error = require_structured_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,
@@ -386,12 +391,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 = require_values.asFunction(entry.message);
 		const descriptor = ((params) => {
-			const message = typeof entry.message === "function" ? entry.message(params) : entry.message;
+			const message = auditMessageFor ? String(auditMessageFor(params)) : require_values.asString(entry.message);
 			return Object.freeze({
 				action,
 				severity,
-				...message === void 0 ? {} : { message }
+				message
 			});
 		});
 		Object.defineProperty(descriptor, "action", {
@@ -479,15 +485,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 = require_values.asRecord(sourceVal);
+		const targetRecord = require_values.asRecord(target[key]);
+		if (sourceRecord && targetRecord) mergeInto(targetRecord, sourceRecord);
 		else target[key] = sourceVal;
 	}
 }
@@ -501,11 +505,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 = require_values.asRecord(event[def.field]);
+		if (options.overwrite || !existing) {
+			event[def.field] = computed;
 			return;
 		}
-		mergeInto(ctx.event[def.field], computed);
+		mergeInto(existing, computed);
 	};
 }
 

package/dist/index.d.cts

@@ -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.cjs";
-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-BPcxVucm.cjs";
-import { n as TraceContext$1, r as defineBaggageSchema, t as AttributeValue$2 } from "./trace-context-IuyoPyNq.cjs";
+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.cjs";
+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-DQHf4cNl.cjs";
+import { t as UnknownRecord } from "./values-CeMH-mYG.cjs";
+import { n as TraceContext$1, r as defineBaggageSchema, t as AttributeValue$2 } from "./trace-context-C1Cn1q0y.cjs";
 import { BaggageError, BaggageFieldDefinition, BaggageFieldType, BusinessBaggage, BusinessBaggageValues, SafeBaggageOptions, SafeBaggageSchema, createSafeBaggageSchema } from "./business-baggage.cjs";
 import { CORRELATION_ID_BAGGAGE_KEY, generateCorrelationId, getCorrelationId, getOrCreateCorrelationId, runWithCorrelationId, setCorrelationId, setCorrelationIdInBaggage } from "./correlation-id.cjs";
-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-BR9fkSwx.cjs";
-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-e6jw5zQj.cjs";
+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-CmRdnXUi.cjs";
+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-CJn2zY4o.cjs";
 import { DrainPipelineOptions, PipelineDrainFn, createDrainPipeline } from "./drain-pipeline.cjs";
-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.cjs";
+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.cjs";
 import { Event, EventsOptions, getEvents, resetEvents } from "./event.cjs";
 import { n as FilteringSpanProcessorOptions, r as SpanFilterPredicate, t as FilteringSpanProcessor } from "./filtering-span-processor-BpDagWNa.cjs";
-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-Cc7-vvzj.cjs";
+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-DrlL1eis.cjs";
 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.cjs";
-import "./canonical-log-line-processor-B4WgG-VS.cjs";
-import { i as defineEvent, n as DefinedEvent, r as SchemaLike, t as DefineEventOptions } from "./define-event-CGG048HE.cjs";
+import "./canonical-log-line-processor-l0Aqe6yp.cjs";
+import { i as defineEvent, n as DefinedEvent, r as SchemaLike, t as DefineEventOptions } from "./define-event-BNeuKUPv.cjs";
 import { ParsedError, parseError } from "./parse-error.cjs";
 import { Metric, MetricsOptions, getMetrics, resetMetrics } from "./metric.cjs";
 import { createCounter, createHistogram, createObservableGauge, createUpDownCounter, getMeter } from "./metric-helpers.cjs";
@@ -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
 /**