autotel 6.4.1 → 7.0.0

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 {

package/dist/tracer-provider.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/tracer-provider.ts
@@ -34,10 +35,6 @@ function getGlobalState() {
 	const initialState = createState();
 	try {
 		const g = globalThis;
-		if (typeof g !== "object" || g === null) {
-			console.warn("[autotel] globalThis is not available, using fallback state");
-			return initialState;
-		}
 		if (!g[AUTOTEL_GLOBAL_SYMBOL]) Object.defineProperty(g, AUTOTEL_GLOBAL_SYMBOL, {
 			value: initialState,
 			writable: false,
@@ -188,8 +185,9 @@ function getAutotelTracerProvider() {
 	if (isolatedTracerProvider) return isolatedTracerProvider;
 	return _opentelemetry_api.trace.getTracerProvider();
 }
-function isForceFlushable(value) {
-	return typeof value === "object" && value !== null && typeof value.forceFlush === "function";
+/** The candidate if it can be force-flushed, or undefined. */
+function asForceFlushable(value) {
+	return require_values.isFunction(require_values.readProperty(value, "forceFlush")) ? value : void 0;
 }
 /**
 * Resolve a tracer provider that can be `forceFlush()`ed, so `flush()` and
@@ -205,14 +203,12 @@ function isForceFlushable(value) {
 * @returns Something with `forceFlush()`, or `undefined` if none is registered.
 */
 function getForceFlushableProvider(sdk) {
-	const candidates = [];
-	const sdkAny = sdk;
-	if (sdkAny && typeof sdkAny.getTracerProvider === "function") candidates.push(sdkAny.getTracerProvider());
+	const candidates = [require_values.asFunction(require_values.readProperty(sdk, "getTracerProvider"))?.call(sdk)];
 	const globalProvider = _opentelemetry_api.trace.getTracerProvider();
 	candidates.push(globalProvider);
-	const proxy = globalProvider;
-	if (proxy && typeof proxy.getDelegate === "function") candidates.push(proxy.getDelegate());
-	return candidates.find(isForceFlushable);
+	const getDelegate = require_values.asFunction(require_values.readProperty(globalProvider, "getDelegate"));
+	if (getDelegate) candidates.push(getDelegate.call(globalProvider));
+	return candidates.map(asForceFlushable).find((found) => found !== void 0);
 }
 /**
 * Gets the OpenTelemetry tracer instance for Autotel.

package/dist/tracer-provider.js

@@ -1,3 +1,4 @@
+import { _ as readProperty, h as isFunction, r as asFunction } from "./values-BenyvWKz.js";
 import { trace } from "@opentelemetry/api";
 
 //#region src/tracer-provider.ts
@@ -33,10 +34,6 @@ function getGlobalState() {
 	const initialState = createState();
 	try {
 		const g = globalThis;
-		if (typeof g !== "object" || g === null) {
-			console.warn("[autotel] globalThis is not available, using fallback state");
-			return initialState;
-		}
 		if (!g[AUTOTEL_GLOBAL_SYMBOL]) Object.defineProperty(g, AUTOTEL_GLOBAL_SYMBOL, {
 			value: initialState,
 			writable: false,
@@ -187,8 +184,9 @@ function getAutotelTracerProvider() {
 	if (isolatedTracerProvider) return isolatedTracerProvider;
 	return trace.getTracerProvider();
 }
-function isForceFlushable(value) {
-	return typeof value === "object" && value !== null && typeof value.forceFlush === "function";
+/** The candidate if it can be force-flushed, or undefined. */
+function asForceFlushable(value) {
+	return isFunction(readProperty(value, "forceFlush")) ? value : void 0;
 }
 /**
 * Resolve a tracer provider that can be `forceFlush()`ed, so `flush()` and
@@ -204,14 +202,12 @@ function isForceFlushable(value) {
 * @returns Something with `forceFlush()`, or `undefined` if none is registered.
 */
 function getForceFlushableProvider(sdk) {
-	const candidates = [];
-	const sdkAny = sdk;
-	if (sdkAny && typeof sdkAny.getTracerProvider === "function") candidates.push(sdkAny.getTracerProvider());
+	const candidates = [asFunction(readProperty(sdk, "getTracerProvider"))?.call(sdk)];
 	const globalProvider = trace.getTracerProvider();
 	candidates.push(globalProvider);
-	const proxy = globalProvider;
-	if (proxy && typeof proxy.getDelegate === "function") candidates.push(proxy.getDelegate());
-	return candidates.find(isForceFlushable);
+	const getDelegate = asFunction(readProperty(globalProvider, "getDelegate"));
+	if (getDelegate) candidates.push(getDelegate.call(globalProvider));
+	return candidates.map(asForceFlushable).find((found) => found !== void 0);
 }
 /**
 * Gets the OpenTelemetry tracer instance for Autotel.

package/dist/validate.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_structured_error = require('./structured-error-CHg7DoIQ.cjs');
-const require_stable_hash = require('./stable-hash-CS9BxvVQ.cjs');
+const require_values = require('./values-DApyq53y.cjs');
+const require_structured_error = require('./structured-error--_wXpd_C.cjs');
+const require_stable_hash = require('./stable-hash-C0pOegH_.cjs');
 const require_metric_helpers = require('./metric-helpers.cjs');
 const require_validation_attributes = require('./validation-attributes.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
@@ -64,16 +65,18 @@ function recordValidationMismatch(mismatch) {
 		const paths = mismatch.issues.map((i) => i.path).filter(Boolean);
 		const codes = [...new Set(mismatch.issues.map((i) => i.code))];
 		const span = _opentelemetry_api.trace.getActiveSpan();
-		if (span) span.setAttributes({
-			[require_validation_attributes.VALIDATION_ATTR.name]: mismatch.name,
-			[require_validation_attributes.VALIDATION_ATTR.boundary]: mismatch.boundary,
-			[require_validation_attributes.VALIDATION_ATTR.mode]: mismatch.mode,
-			[require_validation_attributes.VALIDATION_ATTR.issueCount]: mismatch.issues.length,
-			[require_validation_attributes.VALIDATION_ATTR.issuePaths]: truncate(paths),
-			[require_validation_attributes.VALIDATION_ATTR.issueCodes]: truncate(codes),
-			...mismatch.hash ? { [require_validation_attributes.VALIDATION_ATTR.hash]: mismatch.hash } : {},
-			...mismatch.severity ? { [require_validation_attributes.VALIDATION_ATTR.severity]: mismatch.severity } : {}
-		});
+		if (span) {
+			const attributes = {};
+			attributes[require_validation_attributes.VALIDATION_ATTR.name] = mismatch.name;
+			attributes[require_validation_attributes.VALIDATION_ATTR.boundary] = mismatch.boundary;
+			attributes[require_validation_attributes.VALIDATION_ATTR.mode] = mismatch.mode;
+			attributes[require_validation_attributes.VALIDATION_ATTR.issueCount] = mismatch.issues.length;
+			attributes[require_validation_attributes.VALIDATION_ATTR.issuePaths] = truncate(paths);
+			attributes[require_validation_attributes.VALIDATION_ATTR.issueCodes] = truncate(codes);
+			if (mismatch.hash) attributes[require_validation_attributes.VALIDATION_ATTR.hash] = mismatch.hash;
+			if (mismatch.severity) attributes[require_validation_attributes.VALIDATION_ATTR.severity] = mismatch.severity;
+			span.setAttributes(attributes);
+		}
 		try {
 			counter().add(1, {
 				boundary: mismatch.boundary,
@@ -97,17 +100,16 @@ function formatValidationIssues(error) {
 	return extractRawIssues(error).map((issue) => toSafeIssue(issue));
 }
 function extractRawIssues(error) {
-	if (error && typeof error === "object") {
-		const candidate = error.issues ?? error.errors;
-		if (Array.isArray(candidate)) return candidate.filter((i) => i !== null && typeof i === "object");
-	}
-	return [];
+	const raised = require_values.asRecord(error);
+	const candidate = raised?.issues ?? raised?.errors;
+	if (!Array.isArray(candidate)) return [];
+	return candidate.map((issue) => require_values.asRecord(issue)).filter((issue) => issue !== void 0);
 }
 function toSafeIssue(issue) {
 	const rawPath = issue.path;
-	const path = Array.isArray(rawPath) ? rawPath.map(String).join(".") : typeof rawPath === "string" ? rawPath : "";
-	const code = typeof issue.code === "string" ? issue.code : "invalid";
-	const expected = typeof issue.expected === "string" ? issue.expected : void 0;
+	const path = Array.isArray(rawPath) ? rawPath.map(String).join(".") : require_values.asString(rawPath) ?? "";
+	const code = require_values.asString(issue.code) ?? "invalid";
+	const expected = require_values.asString(issue.expected);
 	return expected ? {
 		path,
 		code,

package/dist/validate.d.cts

@@ -1,4 +1,5 @@
-import { r as SchemaLike } from "./define-event-CGG048HE.cjs";
+import { t as UnknownRecord } from "./values-CeMH-mYG.cjs";
+import { r as SchemaLike } from "./define-event-BNeuKUPv.cjs";
 //#region src/validate.d.ts
 type ValidationMode = 'observe' | 'reject';
 type ValidationSeverity = 'info' | 'warning' | 'error';
@@ -54,7 +55,7 @@ interface DefineValidatorOptions<S> {
   /** `reject` (default): record then throw. `observe`: record then continue. */
   onMismatch?: ValidationMode;
   /** Project the schema to JSON Schema for a stable `validation.hash`. */
-  toJsonSchema?: (schema: S) => unknown;
+  toJsonSchema?: (schema: S) => UnknownRecord;
   severity?: ValidationSeverity;
   /** Build the error thrown in `reject` mode (defaults to a 400 structured error). */
   onReject?: (issues: ValidationIssue[], name: string) => Error;

package/dist/validate.d.ts

@@ -1,4 +1,5 @@
-import { r as SchemaLike } from "./define-event-B2z1SBe7.js";
+import { t as UnknownRecord } from "./values-CeMH-mYG.js";
+import { r as SchemaLike } from "./define-event-Bd8f8mST.js";
 //#region src/validate.d.ts
 type ValidationMode = 'observe' | 'reject';
 type ValidationSeverity = 'info' | 'warning' | 'error';
@@ -54,7 +55,7 @@ interface DefineValidatorOptions<S> {
   /** `reject` (default): record then throw. `observe`: record then continue. */
   onMismatch?: ValidationMode;
   /** Project the schema to JSON Schema for a stable `validation.hash`. */
-  toJsonSchema?: (schema: S) => unknown;
+  toJsonSchema?: (schema: S) => UnknownRecord;
   severity?: ValidationSeverity;
   /** Build the error thrown in `reject` mode (defaults to a 400 structured error). */
   onReject?: (issues: ValidationIssue[], name: string) => Error;

package/dist/validate.js

@@ -1,5 +1,6 @@
-import { t as createStructuredError } from "./structured-error-9--cxBay.js";
-import { t as hashJson } from "./stable-hash-ChFBIhNt.js";
+import { l as asString, s as asRecord } from "./values-BenyvWKz.js";
+import { t as createStructuredError } from "./structured-error-YIuka-FE.js";
+import { t as hashJson } from "./stable-hash-BkoAYVks.js";
 import { createCounter } from "./metric-helpers.js";
 import { VALIDATION_ATTR, VALIDATION_ISSUE_CAP, VALIDATION_METRICS } from "./validation-attributes.js";
 import { trace } from "@opentelemetry/api";
@@ -63,16 +64,18 @@ function recordValidationMismatch(mismatch) {
 		const paths = mismatch.issues.map((i) => i.path).filter(Boolean);
 		const codes = [...new Set(mismatch.issues.map((i) => i.code))];
 		const span = trace.getActiveSpan();
-		if (span) span.setAttributes({
-			[VALIDATION_ATTR.name]: mismatch.name,
-			[VALIDATION_ATTR.boundary]: mismatch.boundary,
-			[VALIDATION_ATTR.mode]: mismatch.mode,
-			[VALIDATION_ATTR.issueCount]: mismatch.issues.length,
-			[VALIDATION_ATTR.issuePaths]: truncate(paths),
-			[VALIDATION_ATTR.issueCodes]: truncate(codes),
-			...mismatch.hash ? { [VALIDATION_ATTR.hash]: mismatch.hash } : {},
-			...mismatch.severity ? { [VALIDATION_ATTR.severity]: mismatch.severity } : {}
-		});
+		if (span) {
+			const attributes = {};
+			attributes[VALIDATION_ATTR.name] = mismatch.name;
+			attributes[VALIDATION_ATTR.boundary] = mismatch.boundary;
+			attributes[VALIDATION_ATTR.mode] = mismatch.mode;
+			attributes[VALIDATION_ATTR.issueCount] = mismatch.issues.length;
+			attributes[VALIDATION_ATTR.issuePaths] = truncate(paths);
+			attributes[VALIDATION_ATTR.issueCodes] = truncate(codes);
+			if (mismatch.hash) attributes[VALIDATION_ATTR.hash] = mismatch.hash;
+			if (mismatch.severity) attributes[VALIDATION_ATTR.severity] = mismatch.severity;
+			span.setAttributes(attributes);
+		}
 		try {
 			counter().add(1, {
 				boundary: mismatch.boundary,
@@ -96,17 +99,16 @@ function formatValidationIssues(error) {
 	return extractRawIssues(error).map((issue) => toSafeIssue(issue));
 }
 function extractRawIssues(error) {
-	if (error && typeof error === "object") {
-		const candidate = error.issues ?? error.errors;
-		if (Array.isArray(candidate)) return candidate.filter((i) => i !== null && typeof i === "object");
-	}
-	return [];
+	const raised = asRecord(error);
+	const candidate = raised?.issues ?? raised?.errors;
+	if (!Array.isArray(candidate)) return [];
+	return candidate.map((issue) => asRecord(issue)).filter((issue) => issue !== void 0);
 }
 function toSafeIssue(issue) {
 	const rawPath = issue.path;
-	const path = Array.isArray(rawPath) ? rawPath.map(String).join(".") : typeof rawPath === "string" ? rawPath : "";
-	const code = typeof issue.code === "string" ? issue.code : "invalid";
-	const expected = typeof issue.expected === "string" ? issue.expected : void 0;
+	const path = Array.isArray(rawPath) ? rawPath.map(String).join(".") : asString(rawPath) ?? "";
+	const code = asString(issue.code) ?? "invalid";
+	const expected = asString(issue.expected);
 	return expected ? {
 		path,
 		code,

package/dist/values-BenyvWKz.js

@@ -0,0 +1,141 @@
+//#region src/values.ts
+/** The value as an object, or undefined when it is anything else. */
+function asRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+/** The string the value carries, or undefined when it carries anything else. */
+function asString(value) {
+	return typeof value === "string" ? value : void 0;
+}
+/**
+* The value as a map of strings - a header bag, say - or undefined when it is
+* not an object at all. Entries whose value is not a string are left out.
+*/
+function asStringRecord(value) {
+	const record = asRecord(value);
+	if (record === void 0) return void 0;
+	const strings = {};
+	for (const [key, entry] of Object.entries(record)) {
+		const text = asString(entry);
+		if (text !== void 0) strings[key] = text;
+	}
+	return strings;
+}
+/** The scalar the value carries - string, number or boolean - or undefined. */
+function asScalar(value) {
+	return asString(value) ?? asNumber(value) ?? asBoolean(value);
+}
+/** The numbers the value carries as a list, or undefined when it is not one. */
+function asNumberArray(value) {
+	return Array.isArray(value) && value.every((v) => asNumber(v) !== void 0) ? value.map(Number) : void 0;
+}
+/** The booleans the value carries as a list, or undefined when it is not one. */
+function asBooleanArray(value) {
+	return Array.isArray(value) && value.every((v) => asBoolean(v) !== void 0) ? value.map(Boolean) : void 0;
+}
+/** The strings the value carries as a list, or undefined when it is not one. */
+function asStringArray(value) {
+	return Array.isArray(value) && value.every((v) => asString(v) !== void 0) ? value.map(String) : void 0;
+}
+/** A string with something in it - a blank one counts as absent. */
+function nonEmptyString(value) {
+	const text = asString(value);
+	return text !== void 0 && text.trim() !== "" ? text : void 0;
+}
+/** The number the value carries, or undefined when it carries anything else. */
+function asNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+/** The boolean the value carries, or undefined when it carries anything else. */
+function asBoolean(value) {
+	return typeof value === "boolean" ? value : void 0;
+}
+/** Whether the value is callable. */
+function isFunction(value) {
+	return typeof value === "function";
+}
+/**
+* A config field that may be given as a value or as a function producing one,
+* resolved to the value.
+*/
+function resolveValue(source) {
+	return typeof source === "function" ? source() : source;
+}
+/**
+* An overloaded first argument that is either a name or an options object,
+* split into the two.
+*/
+function splitNameOrOptions(value) {
+	return typeof value === "string" ? { name: value } : { options: value };
+}
+/** The value as a callable, or undefined when it is not one. */
+function asFunction(value) {
+	if (typeof value !== "function") return void 0;
+	return value;
+}
+/**
+* The value as a plain object - one built from a literal, not an instance of
+* some class that has its own idea of what it is.
+*/
+function asPlainRecord(value) {
+	const record = asRecord(value);
+	return record !== void 0 && Object.getPrototypeOf(record) === Object.prototype ? record : void 0;
+}
+/** One field of a value, when the value is an object at all. */
+function readProperty(source, key) {
+	return asRecord(source)?.[key];
+}
+/**
+* What a value is, for a diagnostic message: the same words `typeof` uses,
+* plus `null` and `array`, which are the two cases `typeof` answers uselessly.
+*/
+function describeValue(value) {
+	if (value === null) return "null";
+	return Array.isArray(value) ? "array" : typeof value;
+}
+/**
+* The Error a caller's callback expects, wrapping whatever was actually
+* thrown - a string, a number, an object with no stack.
+*/
+function toError(cause) {
+	return cause instanceof Error ? cause : new Error(String(cause));
+}
+/**
+* A value as an OTel attribute, or undefined when it cannot be one.
+*
+* OTel accepts scalars and homogeneous arrays of scalars. Anything else - a
+* nested object, a mixed array - is stringified rather than dropped, because
+* a caller that attached it wanted to see it.
+*/
+function toAttributeValue(value) {
+	if (value === void 0 || value === null) return void 0;
+	const scalar = asString(value) ?? asNumber(value) ?? asBoolean(value);
+	if (scalar !== void 0) return scalar;
+	if (Array.isArray(value)) return toAttributeArray(value);
+	return JSON.stringify(value);
+}
+/** The scalars in an array, dropping the entries OTel cannot carry. */
+function toAttributeArray(values) {
+	const strings = values.filter((v) => typeof v === "string");
+	if (strings.length === values.length) return strings;
+	const numbers = values.filter((v) => typeof v === "number");
+	if (numbers.length === values.length) return numbers;
+	const booleans = values.filter((v) => typeof v === "boolean");
+	if (booleans.length === values.length) return booleans;
+	return values.length > 0 ? JSON.stringify(values) : void 0;
+}
+/** Whether a Node-style `process` global exists at all - edge runtimes have none. */
+function hasProcess() {
+	return typeof process !== "undefined";
+}
+/**
+* Whether this build is running outside production, for warnings meant to
+* help during development. `process` is probed because the same code runs in
+* edge runtimes that have no such global.
+*/
+function isDevelopment() {
+	return hasProcess() && process.env.NODE_ENV !== "production";
+}
+
+//#endregion
+export { readProperty as _, asNumberArray as a, toAttributeValue as b, asScalar as c, asStringRecord as d, describeValue as f, nonEmptyString as g, isFunction as h, asNumber as i, asString as l, isDevelopment as m, asBooleanArray as n, asPlainRecord as o, hasProcess as p, asFunction as r, asRecord as s, asBoolean as t, asStringArray as u, resolveValue as v, toError as x, splitNameOrOptions as y };