autotel 6.5.0 → 7.0.0

package/dist/test-span-collector.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_values = require('./values-DApyq53y.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/test-span-collector.ts
@@ -66,17 +67,23 @@ var TestSpanCollector = class {
 function hrTimeToMs(hr) {
 	return hr[0] * 1e3 + hr[1] / 1e6;
 }
-function isSerializable(v) {
-	if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") return true;
-	if (Array.isArray(v) && v.length > 0) {
-		const t = typeof v[0];
-		return (t === "string" || t === "number" || t === "boolean") && v.every((e) => typeof e === t);
-	}
-	return false;
+/**
+* An attribute value in the form that survives a round trip through JSON: a
+* scalar, or a list whose entries are all the same kind of scalar. Anything
+* else - a mixed list, an empty one - is left out of the serialized span.
+*/
+function asSerializable(value) {
+	const scalar = require_values.asScalar(value);
+	if (scalar !== void 0) return scalar;
+	if (!Array.isArray(value) || value.length === 0) return void 0;
+	return require_values.asStringArray(value) ?? require_values.asNumberArray(value) ?? require_values.asBooleanArray(value);
 }
 function serializeSpan(span) {
 	const attrs = {};
-	for (const [k, v] of Object.entries(span.attributes)) if (isSerializable(v)) attrs[k] = v;
+	for (const [k, v] of Object.entries(span.attributes)) {
+		const serializable = asSerializable(v);
+		if (serializable !== void 0) attrs[k] = serializable;
+	}
 	return {
 		spanId: span.spanContext().spanId,
 		parentSpanId: span.parentSpanContext?.spanId || void 0,

package/dist/test-span-collector.js

@@ -1,3 +1,4 @@
+import { a as asNumberArray, c as asScalar, n as asBooleanArray, u as asStringArray } from "./values-BenyvWKz.js";
 import { SpanStatusCode } from "@opentelemetry/api";
 
 //#region src/test-span-collector.ts
@@ -65,17 +66,23 @@ var TestSpanCollector = class {
 function hrTimeToMs(hr) {
 	return hr[0] * 1e3 + hr[1] / 1e6;
 }
-function isSerializable(v) {
-	if (typeof v === "string" || typeof v === "number" || typeof v === "boolean") return true;
-	if (Array.isArray(v) && v.length > 0) {
-		const t = typeof v[0];
-		return (t === "string" || t === "number" || t === "boolean") && v.every((e) => typeof e === t);
-	}
-	return false;
+/**
+* An attribute value in the form that survives a round trip through JSON: a
+* scalar, or a list whose entries are all the same kind of scalar. Anything
+* else - a mixed list, an empty one - is left out of the serialized span.
+*/
+function asSerializable(value) {
+	const scalar = asScalar(value);
+	if (scalar !== void 0) return scalar;
+	if (!Array.isArray(value) || value.length === 0) return void 0;
+	return asStringArray(value) ?? asNumberArray(value) ?? asBooleanArray(value);
 }
 function serializeSpan(span) {
 	const attrs = {};
-	for (const [k, v] of Object.entries(span.attributes)) if (isSerializable(v)) attrs[k] = v;
+	for (const [k, v] of Object.entries(span.attributes)) {
+		const serializable = asSerializable(v);
+		if (serializable !== void 0) attrs[k] = serializable;
+	}
 	return {
 		spanId: span.spanContext().spanId,
 		parentSpanId: span.parentSpanContext?.spanId || void 0,

package/dist/testing.cjs

@@ -1,5 +1,6 @@
 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_config = require('./config.cjs');
 const require_event_testing = require('./event-testing.cjs');
 const require_test_span_collector = require('./test-span-collector.cjs');
@@ -100,7 +101,7 @@ function createTraceCollector() {
 				return this;
 			},
 			addEvent(name, attributesOrStartTime, startTime) {
-				const attributes = attributesOrStartTime && !Array.isArray(attributesOrStartTime) && typeof attributesOrStartTime === "object" ? attributesOrStartTime : void 0;
+				const attributes = require_values.asRecord(attributesOrStartTime);
 				spanData.events.push({
 					name,
 					attributes
@@ -149,14 +150,10 @@ function createTraceCollector() {
 			return createMockSpan(name, startTime, parent, options);
 		},
 		startActiveSpan(name, optionsOrFn, contextOrFn, fn) {
-			const callback = (() => {
-				if (typeof optionsOrFn === "function") return optionsOrFn;
-				if (typeof contextOrFn === "function") return contextOrFn;
-				if (fn) return fn;
-				throw new Error("startActiveSpan requires a callback");
-			})();
+			const callback = typeof optionsOrFn === "function" ? optionsOrFn : typeof contextOrFn === "function" ? contextOrFn : fn;
+			if (!callback) throw new Error("startActiveSpan requires a callback");
 			const startTime = performance.now();
-			const suppliedContext = typeof optionsOrFn === "function" ? _opentelemetry_api.context.active() : typeof contextOrFn === "function" || contextOrFn === void 0 ? _opentelemetry_api.context.active() : contextOrFn;
+			const suppliedContext = typeof optionsOrFn === "function" || typeof contextOrFn === "function" || contextOrFn === void 0 ? _opentelemetry_api.context.active() : contextOrFn;
 			const parent = _opentelemetry_api.trace.getSpan(suppliedContext)?.spanContext() ?? activeMockSpanStorage.getStore()?.spanContext();
 			const mockSpan = createMockSpan(name, startTime, parent, typeof optionsOrFn === "function" ? void 0 : optionsOrFn);
 			const ctx = _opentelemetry_api.trace.setSpan(suppliedContext, mockSpan);
@@ -329,15 +326,15 @@ function createMockLogger() {
 	const logs = [];
 	const createLogMethod = (level) => {
 		return (objOrMsg, msg) => {
-			if (typeof objOrMsg === "string") logs.push({
-				level,
-				message: objOrMsg,
-				extra: void 0
-			});
-			else logs.push({
+			const message = require_values.asString(objOrMsg);
+			logs.push(message === void 0 ? {
 				level,
 				message: msg || "",
-				extra: objOrMsg
+				extra: require_values.asRecord(objOrMsg)
+			} : {
+				level,
+				message,
+				extra: void 0
 			});
 		};
 	};
@@ -346,16 +343,17 @@ function createMockLogger() {
 		warn: createLogMethod("warn"),
 		debug: createLogMethod("debug"),
 		error(objOrMsg, msg) {
-			if (typeof objOrMsg === "string") {
+			const message = require_values.asString(objOrMsg);
+			if (message !== void 0) {
 				logs.push({
 					level: "error",
-					message: objOrMsg,
+					message,
 					extra: void 0,
 					error: void 0
 				});
 				return;
 			}
-			const { err, ...rest } = objOrMsg;
+			const { err, ...rest } = require_values.asRecord(objOrMsg) ?? {};
 			logs.push({
 				level: "error",
 				message: msg || "",

package/dist/testing.d.cts

@@ -1,5 +1,6 @@
-import { s as Logger } from "./logger-CN4xpzMd.cjs";
-import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-D0qWfqAy.cjs";
+import { t as UnknownRecord } from "./values-CeMH-mYG.cjs";
+import { s as Logger } from "./logger-S1Fgl0g3.cjs";
+import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-CBtnJXE5.cjs";
 import { SerializedSpan, TestSpanCollector, serializeSpan } from "./test-span-collector.cjs";
 import { Attributes, Link, SpanKind, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
 //#region src/testing.d.ts
@@ -60,7 +61,7 @@ interface SpanMatch {
   spanId?: string;
   parentSpanId?: string;
   kind?: SpanKind;
-  attributes?: Record<string, unknown>;
+  attributes?: Attributes;
 }
 /**
  * In-memory trace collector for testing
@@ -71,7 +72,7 @@ interface TraceCollector {
   /** Get spans matching a name */
   getSpansByName(name: string): TestSpan[];
   /** Get spans matching attributes */
-  getSpansByAttributes(attributes: Record<string, unknown>): TestSpan[];
+  getSpansByAttributes(attributes: Attributes): TestSpan[];
   /** Get spans belonging to a trace */
   getSpansByTraceId(traceId: string): TestSpan[];
   /** Get spans without a recorded parent */
@@ -135,7 +136,7 @@ declare function assertTraceCreated(collector: TraceCollector, operationName: st
   minCount?: number;
   maxCount?: number;
   status?: SpanStatusCode;
-  attributes?: Record<string, unknown>;
+  attributes?: Attributes;
 }): void;
 /**
  * Assert that no errors were logged
@@ -199,7 +200,7 @@ interface LogCollector {
 interface LogEntry {
   level: 'info' | 'warn' | 'error' | 'debug';
   message: string;
-  extra?: Record<string, unknown>;
+  extra?: UnknownRecord;
   error?: Error;
 }
 /**

package/dist/testing.d.ts

@@ -1,5 +1,6 @@
-import { s as Logger } from "./logger-CN4xpzMd.js";
-import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-CA2mIx1E.js";
+import { t as UnknownRecord } from "./values-CeMH-mYG.js";
+import { s as Logger } from "./logger-S1Fgl0g3.js";
+import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-CkPgV3Ii.js";
 import { SerializedSpan, TestSpanCollector, serializeSpan } from "./test-span-collector.js";
 import { Attributes, Link, SpanKind, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
 //#region src/testing.d.ts
@@ -60,7 +61,7 @@ interface SpanMatch {
   spanId?: string;
   parentSpanId?: string;
   kind?: SpanKind;
-  attributes?: Record<string, unknown>;
+  attributes?: Attributes;
 }
 /**
  * In-memory trace collector for testing
@@ -71,7 +72,7 @@ interface TraceCollector {
   /** Get spans matching a name */
   getSpansByName(name: string): TestSpan[];
   /** Get spans matching attributes */
-  getSpansByAttributes(attributes: Record<string, unknown>): TestSpan[];
+  getSpansByAttributes(attributes: Attributes): TestSpan[];
   /** Get spans belonging to a trace */
   getSpansByTraceId(traceId: string): TestSpan[];
   /** Get spans without a recorded parent */
@@ -135,7 +136,7 @@ declare function assertTraceCreated(collector: TraceCollector, operationName: st
   minCount?: number;
   maxCount?: number;
   status?: SpanStatusCode;
-  attributes?: Record<string, unknown>;
+  attributes?: Attributes;
 }): void;
 /**
  * Assert that no errors were logged
@@ -199,7 +200,7 @@ interface LogCollector {
 interface LogEntry {
   level: 'info' | 'warn' | 'error' | 'debug';
   message: string;
-  extra?: Record<string, unknown>;
+  extra?: UnknownRecord;
   error?: Error;
 }
 /**

package/dist/testing.js

@@ -1,3 +1,4 @@
+import { l as asString, s as asRecord } from "./values-BenyvWKz.js";
 import { configure } from "./config.js";
 import { assertEventTracked, assertOutcomeTracked, createEventCollector } from "./event-testing.js";
 import { TestSpanCollector, serializeSpan } from "./test-span-collector.js";
@@ -97,7 +98,7 @@ function createTraceCollector() {
 				return this;
 			},
 			addEvent(name, attributesOrStartTime, startTime) {
-				const attributes = attributesOrStartTime && !Array.isArray(attributesOrStartTime) && typeof attributesOrStartTime === "object" ? attributesOrStartTime : void 0;
+				const attributes = asRecord(attributesOrStartTime);
 				spanData.events.push({
 					name,
 					attributes
@@ -146,14 +147,10 @@ function createTraceCollector() {
 			return createMockSpan(name, startTime, parent, options);
 		},
 		startActiveSpan(name, optionsOrFn, contextOrFn, fn) {
-			const callback = (() => {
-				if (typeof optionsOrFn === "function") return optionsOrFn;
-				if (typeof contextOrFn === "function") return contextOrFn;
-				if (fn) return fn;
-				throw new Error("startActiveSpan requires a callback");
-			})();
+			const callback = typeof optionsOrFn === "function" ? optionsOrFn : typeof contextOrFn === "function" ? contextOrFn : fn;
+			if (!callback) throw new Error("startActiveSpan requires a callback");
 			const startTime = performance.now();
-			const suppliedContext = typeof optionsOrFn === "function" ? context.active() : typeof contextOrFn === "function" || contextOrFn === void 0 ? context.active() : contextOrFn;
+			const suppliedContext = typeof optionsOrFn === "function" || typeof contextOrFn === "function" || contextOrFn === void 0 ? context.active() : contextOrFn;
 			const parent = trace.getSpan(suppliedContext)?.spanContext() ?? activeMockSpanStorage.getStore()?.spanContext();
 			const mockSpan = createMockSpan(name, startTime, parent, typeof optionsOrFn === "function" ? void 0 : optionsOrFn);
 			const ctx = trace.setSpan(suppliedContext, mockSpan);
@@ -326,15 +323,15 @@ function createMockLogger() {
 	const logs = [];
 	const createLogMethod = (level) => {
 		return (objOrMsg, msg) => {
-			if (typeof objOrMsg === "string") logs.push({
-				level,
-				message: objOrMsg,
-				extra: void 0
-			});
-			else logs.push({
+			const message = asString(objOrMsg);
+			logs.push(message === void 0 ? {
 				level,
 				message: msg || "",
-				extra: objOrMsg
+				extra: asRecord(objOrMsg)
+			} : {
+				level,
+				message,
+				extra: void 0
 			});
 		};
 	};
@@ -343,16 +340,17 @@ function createMockLogger() {
 		warn: createLogMethod("warn"),
 		debug: createLogMethod("debug"),
 		error(objOrMsg, msg) {
-			if (typeof objOrMsg === "string") {
+			const message = asString(objOrMsg);
+			if (message !== void 0) {
 				logs.push({
 					level: "error",
-					message: objOrMsg,
+					message,
 					extra: void 0,
 					error: void 0
 				});
 				return;
 			}
-			const { err, ...rest } = objOrMsg;
+			const { err, ...rest } = asRecord(objOrMsg) ?? {};
 			logs.push({
 				level: "error",
 				message: msg || "",

package/dist/{trace-context-IuyoPyNq.d.cts → trace-context-C1Cn1q0y.d.cts}

@@ -1,3 +1,4 @@
+import { t as UnknownRecord } from "./values-CeMH-mYG.cjs";
 import { AttributeValue, Attributes, BaggageEntry, Context, Link, Span, SpanStatusCode } from "@opentelemetry/api";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/trace-context.d.ts
@@ -44,21 +45,21 @@ interface SpanMethods {
    * Replaces the deprecated `recordException` (OTEP 4430). Accepts `unknown`
    * so it can be called directly with the value caught from a `catch` block.
    */
-  recordError(error: unknown): void;
+  recordError(cause: unknown): void;
   /**
    * Emit a tracked event correlated to this span. Equivalent to the standalone
    * `track(event, data)` but reads naturally on `ctx`. Replaces the deprecated
    * `ctx.addEvent` (OTEP 4430) — events become correlated logs rather than
    * span events.
    */
-  track<Events extends Record<string, unknown> = Record<string, unknown>>(event: keyof Events & string, data?: Events[keyof Events & string]): void;
+  track<Events extends UnknownRecord = UnknownRecord>(event: keyof Events & string, data?: Events[keyof Events & string]): void;
 }
 /**
  * Baggage methods available on trace context
  *
  * @template TBaggage - Optional type for typed baggage (defaults to undefined for untyped)
  */
-interface BaggageMethods<TBaggage extends Record<string, unknown> | undefined = undefined> {
+interface BaggageMethods<TBaggage extends UnknownRecord | undefined = undefined> {
   /**
    * Get a baggage entry by key
    * @param key - Baggage key
@@ -104,14 +105,14 @@ interface BaggageMethods<TBaggage extends Record<string, unknown> | undefined =
    *
    * @internal
    */
-  getTypedBaggage?: TBaggage extends Record<string, unknown> ? <T extends TBaggage>(namespace?: string) => Partial<T> | undefined : never;
+  getTypedBaggage?: TBaggage extends UnknownRecord ? <T extends TBaggage>(namespace?: string) => Partial<T> | undefined : never;
   /**
    * Set typed baggage (only available when TBaggage is defined)
    * This is used internally by defineBaggageSchema()
    *
    * @internal
    */
-  setTypedBaggage?: TBaggage extends Record<string, unknown> ? <T extends TBaggage>(namespace: string | undefined, value: Partial<T>) => void : never;
+  setTypedBaggage?: TBaggage extends UnknownRecord ? <T extends TBaggage>(namespace: string | undefined, value: Partial<T>) => void : never;
 }
 /**
  * Complete trace context that merges base context, span methods, and baggage methods
@@ -140,7 +141,7 @@ interface BaggageMethods<TBaggage extends Record<string, unknown> | undefined =
  * });
  * ```
  */
-type TraceContext<TBaggage extends Record<string, unknown> | undefined = undefined> = TraceContextBase & SpanMethods & BaggageMethods<TBaggage>;
+type TraceContext<TBaggage extends UnknownRecord | undefined = undefined> = TraceContextBase & SpanMethods & BaggageMethods<TBaggage>;
 /**
  * Define a typed baggage schema for type-safe baggage operations
  *
@@ -179,7 +180,7 @@ type TraceContext<TBaggage extends Record<string, unknown> | undefined = undefin
  * });
  * ```
  */
-declare function defineBaggageSchema<T extends Record<string, unknown>>(namespace?: string): {
+declare function defineBaggageSchema<T extends UnknownRecord>(namespace?: string): {
   /**
    * Get typed baggage from context
    * @param ctx - Trace context

package/dist/{trace-context-IuyoPyNq.d.ts → trace-context-f89xPJbK.d.ts}

@@ -1,3 +1,4 @@
+import { t as UnknownRecord } from "./values-CeMH-mYG.js";
 import { AttributeValue, Attributes, BaggageEntry, Context, Link, Span, SpanStatusCode } from "@opentelemetry/api";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/trace-context.d.ts
@@ -44,21 +45,21 @@ interface SpanMethods {
    * Replaces the deprecated `recordException` (OTEP 4430). Accepts `unknown`
    * so it can be called directly with the value caught from a `catch` block.
    */
-  recordError(error: unknown): void;
+  recordError(cause: unknown): void;
   /**
    * Emit a tracked event correlated to this span. Equivalent to the standalone
    * `track(event, data)` but reads naturally on `ctx`. Replaces the deprecated
    * `ctx.addEvent` (OTEP 4430) — events become correlated logs rather than
    * span events.
    */
-  track<Events extends Record<string, unknown> = Record<string, unknown>>(event: keyof Events & string, data?: Events[keyof Events & string]): void;
+  track<Events extends UnknownRecord = UnknownRecord>(event: keyof Events & string, data?: Events[keyof Events & string]): void;
 }
 /**
  * Baggage methods available on trace context
  *
  * @template TBaggage - Optional type for typed baggage (defaults to undefined for untyped)
  */
-interface BaggageMethods<TBaggage extends Record<string, unknown> | undefined = undefined> {
+interface BaggageMethods<TBaggage extends UnknownRecord | undefined = undefined> {
   /**
    * Get a baggage entry by key
    * @param key - Baggage key
@@ -104,14 +105,14 @@ interface BaggageMethods<TBaggage extends Record<string, unknown> | undefined =
    *
    * @internal
    */
-  getTypedBaggage?: TBaggage extends Record<string, unknown> ? <T extends TBaggage>(namespace?: string) => Partial<T> | undefined : never;
+  getTypedBaggage?: TBaggage extends UnknownRecord ? <T extends TBaggage>(namespace?: string) => Partial<T> | undefined : never;
   /**
    * Set typed baggage (only available when TBaggage is defined)
    * This is used internally by defineBaggageSchema()
    *
    * @internal
    */
-  setTypedBaggage?: TBaggage extends Record<string, unknown> ? <T extends TBaggage>(namespace: string | undefined, value: Partial<T>) => void : never;
+  setTypedBaggage?: TBaggage extends UnknownRecord ? <T extends TBaggage>(namespace: string | undefined, value: Partial<T>) => void : never;
 }
 /**
  * Complete trace context that merges base context, span methods, and baggage methods
@@ -140,7 +141,7 @@ interface BaggageMethods<TBaggage extends Record<string, unknown> | undefined =
  * });
  * ```
  */
-type TraceContext<TBaggage extends Record<string, unknown> | undefined = undefined> = TraceContextBase & SpanMethods & BaggageMethods<TBaggage>;
+type TraceContext<TBaggage extends UnknownRecord | undefined = undefined> = TraceContextBase & SpanMethods & BaggageMethods<TBaggage>;
 /**
  * Define a typed baggage schema for type-safe baggage operations
  *
@@ -179,7 +180,7 @@ type TraceContext<TBaggage extends Record<string, unknown> | undefined = undefin
  * });
  * ```
  */
-declare function defineBaggageSchema<T extends Record<string, unknown>>(namespace?: string): {
+declare function defineBaggageSchema<T extends UnknownRecord>(namespace?: string): {
   /**
    * Get typed baggage from context
    * @param ctx - Trace context

package/dist/trace-helpers.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_node_require = require('./node-require-PFqDihze.cjs');
+const require_values = require('./values-DApyq53y.cjs');
+const require_node_require = require('./node-require-EifOMikz.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/trace-helpers.ts
@@ -379,10 +380,9 @@ function runWithSpan(span, fn) {
 * }
 * ```
 */
-function finalizeSpan(span, error) {
-	if (error) {
-		if (error instanceof Error) span.recordException(error);
-		else span.recordException(new Error(String(error)));
+function finalizeSpan(span, cause) {
+	if (cause) {
+		span.recordException(require_values.toError(cause));
 		span.setStatus({ code: _opentelemetry_api.SpanStatusCode.ERROR });
 	} else span.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
 	span.end();
@@ -593,21 +593,24 @@ function flattenMetadata(metadata, prefix = "metadata") {
 		for (const [key, value] of Object.entries(obj)) {
 			if (value == null) continue;
 			const attributeKey = `${currentPrefix}.${key}`;
-			if (typeof value === "string") {
-				flattened[attributeKey] = value;
+			const text = require_values.asString(value);
+			if (text !== void 0) {
+				flattened[attributeKey] = text;
 				continue;
 			}
-			if (typeof value === "number" || typeof value === "boolean") {
-				flattened[attributeKey] = String(value);
+			const scalar = require_values.asNumber(value) ?? require_values.asBoolean(value);
+			if (scalar !== void 0) {
+				flattened[attributeKey] = String(scalar);
 				continue;
 			}
-			if (typeof value === "object" && value !== null && value.constructor === Object) {
-				if (seen.has(value)) {
+			const nested = require_values.asPlainRecord(value);
+			if (nested !== void 0) {
+				if (seen.has(nested)) {
 					flattened[attributeKey] = "<circular-reference>";
 					continue;
 				}
-				seen.add(value);
-				flatten(value, attributeKey);
+				seen.add(nested);
+				flatten(nested, attributeKey);
 				continue;
 			}
 			try {

package/dist/trace-helpers.d.cts

@@ -1,3 +1,4 @@
+import { t as UnknownRecord } from "./values-CeMH-mYG.cjs";
 import { Context, Span, Tracer } from "@opentelemetry/api";
 //#region src/trace-helpers.d.ts
 /**
@@ -78,7 +79,7 @@ declare function getTraceContext(): TraceContext | null;
  * // { userId: '123' } - no trace fields added
  * ```
  */
-declare function enrichWithTraceContext<T extends Record<string, unknown>>(obj: T): T;
+declare function enrichWithTraceContext<T extends UnknownRecord>(obj: T): T;
 /**
  * Check if currently in a trace context
  *
@@ -303,7 +304,7 @@ declare function runWithSpan<T>(span: Span, fn: () => T): T;
  * }
  * ```
  */
-declare function finalizeSpan(span: Span, error?: unknown): void;
+declare function finalizeSpan(span: Span, cause?: unknown): void;
 /**
  * Creates a deterministic trace ID from a seed string.
  *
@@ -495,6 +496,10 @@ declare function createDeterministicTraceId(seed: string): Promise<string>;
  * // => 'https://grafana.example.com/explore?traceId=abc123'
  */
 declare function resolveTraceUrl(template: string | undefined, traceId: string): string | undefined;
-declare function flattenMetadata(metadata: Record<string, unknown>, prefix?: string): Record<string, string>;
+/** Flattened metadata: every leaf rendered as the string an attribute holds. */
+interface FlatMetadata {
+  [key: string]: string;
+}
+declare function flattenMetadata(metadata: UnknownRecord, prefix?: string): FlatMetadata;
 //#endregion
-export { TraceContext, createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan, setSpanName };
+export { FlatMetadata, TraceContext, createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan, setSpanName };

package/dist/trace-helpers.d.ts

@@ -1,3 +1,4 @@
+import { t as UnknownRecord } from "./values-CeMH-mYG.js";
 import { Context, Span, Tracer } from "@opentelemetry/api";
 //#region src/trace-helpers.d.ts
 /**
@@ -78,7 +79,7 @@ declare function getTraceContext(): TraceContext | null;
  * // { userId: '123' } - no trace fields added
  * ```
  */
-declare function enrichWithTraceContext<T extends Record<string, unknown>>(obj: T): T;
+declare function enrichWithTraceContext<T extends UnknownRecord>(obj: T): T;
 /**
  * Check if currently in a trace context
  *
@@ -303,7 +304,7 @@ declare function runWithSpan<T>(span: Span, fn: () => T): T;
  * }
  * ```
  */
-declare function finalizeSpan(span: Span, error?: unknown): void;
+declare function finalizeSpan(span: Span, cause?: unknown): void;
 /**
  * Creates a deterministic trace ID from a seed string.
  *
@@ -495,6 +496,10 @@ declare function createDeterministicTraceId(seed: string): Promise<string>;
  * // => 'https://grafana.example.com/explore?traceId=abc123'
  */
 declare function resolveTraceUrl(template: string | undefined, traceId: string): string | undefined;
-declare function flattenMetadata(metadata: Record<string, unknown>, prefix?: string): Record<string, string>;
+/** Flattened metadata: every leaf rendered as the string an attribute holds. */
+interface FlatMetadata {
+  [key: string]: string;
+}
+declare function flattenMetadata(metadata: UnknownRecord, prefix?: string): FlatMetadata;
 //#endregion
-export { TraceContext, createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan, setSpanName };
+export { FlatMetadata, TraceContext, createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan, setSpanName };

package/dist/trace-helpers.js

@@ -1,4 +1,5 @@
-import { t as requireModule } from "./node-require-vROmTeJ8.js";
+import { i as asNumber, l as asString, o as asPlainRecord, t as asBoolean, x as toError } from "./values-BenyvWKz.js";
+import { t as requireModule } from "./node-require-DSPjaw_l.js";
 import { SpanStatusCode, context, trace } from "@opentelemetry/api";
 
 //#region src/trace-helpers.ts
@@ -378,10 +379,9 @@ function runWithSpan(span, fn) {
 * }
 * ```
 */
-function finalizeSpan(span, error) {
-	if (error) {
-		if (error instanceof Error) span.recordException(error);
-		else span.recordException(new Error(String(error)));
+function finalizeSpan(span, cause) {
+	if (cause) {
+		span.recordException(toError(cause));
 		span.setStatus({ code: SpanStatusCode.ERROR });
 	} else span.setStatus({ code: SpanStatusCode.OK });
 	span.end();
@@ -592,21 +592,24 @@ function flattenMetadata(metadata, prefix = "metadata") {
 		for (const [key, value] of Object.entries(obj)) {
 			if (value == null) continue;
 			const attributeKey = `${currentPrefix}.${key}`;
-			if (typeof value === "string") {
-				flattened[attributeKey] = value;
+			const text = asString(value);
+			if (text !== void 0) {
+				flattened[attributeKey] = text;
 				continue;
 			}
-			if (typeof value === "number" || typeof value === "boolean") {
-				flattened[attributeKey] = String(value);
+			const scalar = asNumber(value) ?? asBoolean(value);
+			if (scalar !== void 0) {
+				flattened[attributeKey] = String(scalar);
 				continue;
 			}
-			if (typeof value === "object" && value !== null && value.constructor === Object) {
-				if (seen.has(value)) {
+			const nested = asPlainRecord(value);
+			if (nested !== void 0) {
+				if (seen.has(nested)) {
 					flattened[attributeKey] = "<circular-reference>";
 					continue;
 				}
-				seen.add(value);
-				flatten(value, attributeKey);
+				seen.add(nested);
+				flatten(nested, attributeKey);
 				continue;
 			}
 			try {