autotel 6.5.0 → 7.0.0

package/dist/{functional-C0uAZq2X.cjs → functional-Da6Yv64r.cjs}

@@ -1,8 +1,9 @@
 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_config = require('./config.cjs');
 const require_sampling = require('./sampling.cjs');
-const require_init = require('./init-CTtHITlX.cjs');
+const require_init = require('./init-D4m5rCmD.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 let node_fs = require("node:fs");
@@ -178,9 +179,9 @@ function getSpanName(options, fn, variableName) {
 	if (options.serviceName) return `${options.serviceName}.${fnName}`;
 	if (fnName !== "anonymous") return fnName;
 	const initConfig = require_init.getConfig();
-	if (typeof process !== "undefined" && process.env.NODE_ENV !== "production" && !unknownSpanNameWarningEmitted && initConfig?.logger?.warn) {
+	if (require_values.isDevelopment() && !unknownSpanNameWarningEmitted && initConfig?.logger?.warn) {
 		unknownSpanNameWarningEmitted = true;
-		initConfig.logger.warn({}, "[autotel] Span name resolved to \"unknown\". Pass an explicit name, for example trace(\"operation.name\", fn).");
+		initConfig.logger.warn({}, "[autotel] Span name resolved to \"unknown\". Use instrument({ key: \"operation.name\", fn }) for a reusable named wrapper.");
 	}
 	return "unknown";
 }
@@ -207,7 +208,7 @@ function createDummyCtx() {
 function serializeCapture(value) {
 	if (value === void 0) return void 0;
 	try {
-		const json = typeof value === "string" ? value : JSON.stringify(value);
+		const json = require_values.asString(value) ?? JSON.stringify(value);
 		if (json === void 0) return void 0;
 		return json.length > CAPTURE_MAX_CHARS ? `${json.slice(0, CAPTURE_MAX_CHARS)}…[truncated]` : json;
 	} catch {
@@ -333,7 +334,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 			const fn = fnFactory(require_init.createTraceContext(span));
 			const argsAttributes = {
 				...captureInputAttrs(args, options.captureInput),
-				...options.attributesFromArgs ? options.attributesFromArgs(args) : {}
+				...options.attributesFromArgs?.(args)
 			};
 			const handleTailSampling = (success, duration, error) => {
 				if (needsTailSampling && sampler.shouldKeepTrace) {
@@ -358,9 +359,9 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 				});
 				const resultAttributes = {
 					...captureOutputAttrs(result, options.captureOutput),
-					...options.attributesFromResult ? options.attributesFromResult(result) : {}
+					...options.attributesFromResult?.(result)
 				};
-				span.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
+				if (!require_init.hasExplicitSpanStatus(span)) span.setStatus({ code: _opentelemetry_api.SpanStatusCode.OK });
 				span.setAttributes({
 					...argsAttributes,
 					...resultAttributes,
@@ -373,8 +374,8 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 				span.end();
 				return result;
 			};
-			const onError = (error) => {
-				finalizeThrownSpan(error, options.isError, {
+			const onError = (cause) => {
+				finalizeThrownSpan(cause, options.isError, {
 					span,
 					spanName,
 					duration: performance.now() - startTime,
@@ -383,7 +384,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 					handleTailSampling,
 					extraAttributes: argsAttributes
 				});
-				throw error;
+				throw cause;
 			};
 			try {
 				callCounter?.add(1, {
@@ -428,6 +429,10 @@ function wrapFactoryWithTracing(factory, options, variableName) {
 function wrapPlainWithTracing(fn, options, variableName) {
 	return wrapWithTracingSync((_ctx) => fn, options, resolveVariableName(fn, variableName));
 }
+/** Run one operation immediately with its span-bound context. */
+function runWithTraceContext(operation, options) {
+	return wrapFactoryWithTracing((ctx) => () => operation(ctx), options)();
+}
 
 //#endregion
 //#region src/functional.ts
@@ -493,7 +498,7 @@ function getCtxValue() {
 *
 * @example
 * ```typescript
-* const getUser = trace('getUser', async (id: string) => {
+* const getUser = trace(async function getUser(id: string) {
 *   getActiveTraceContext()?.setAttribute('user.id', id);
 *   return db.users.find(id);
 * });
@@ -523,7 +528,8 @@ function getActiveTraceContext() {
 * })
 * ```
 */
-const ctx = new Proxy({}, {
+const ctxProxyTarget = {};
+const ctx = new Proxy(ctxProxyTarget, {
 	get(_target, prop) {
 		const ctxValue = getCtxValue();
 		if (!ctxValue) return;
@@ -545,11 +551,17 @@ const ctx = new Proxy({}, {
 		return Object.getOwnPropertyDescriptor(ctxValue, prop);
 	}
 });
-function trace(fnOrNameOrOptions, maybeFn) {
+function traceImpl(fnOrNameOrOptions, maybeFn) {
 	if (typeof fnOrNameOrOptions === "function") return wrapPlainWithTracing(fnOrNameOrOptions, {});
-	if (!maybeFn) throw new Error("trace(name|options, fn): fn is required");
-	return wrapPlainWithTracing(maybeFn, typeof fnOrNameOrOptions === "string" ? { name: fnOrNameOrOptions } : fnOrNameOrOptions);
+	const options = typeof fnOrNameOrOptions === "string" ? { name: fnOrNameOrOptions } : fnOrNameOrOptions;
+	if (maybeFn === void 0) return ((fn) => wrapPlainWithTracing(fn, options));
+	return wrapPlainWithTracing(maybeFn, options);
+}
+function run(nameOrOptions, operation) {
+	if (typeof operation !== "function") throw new TypeError("trace.run(name, operation): operation must be a function");
+	return runWithTraceContext(operation, typeof nameOrOptions === "string" ? { name: nameOrOptions } : nameOrOptions);
 }
+const trace = Object.assign(traceImpl, { run });
 /**
 * Approach 2: withTracing() - Middleware-style composable wrapper
 *

package/dist/{functional-DX7Zvag0.js → functional-uSbNnnxK.js}

@@ -1,7 +1,8 @@
+import { l as asString, m as isDevelopment } from "./values-BenyvWKz.js";
 import { getForceFlushableProvider } from "./tracer-provider.js";
 import { getConfig } from "./config.js";
 import { AUTOTEL_SAMPLING_RATE, AUTOTEL_SAMPLING_TAIL_EVALUATED, AUTOTEL_SAMPLING_TAIL_KEEP, AlwaysSampler } from "./sampling.js";
-import { D as getActiveContextWithBaggage, O as getContextStorage, T as createTraceContext, h as getEventQueue, m as runInOperationContext, r as getSdk, t as getConfig$1 } from "./init-WHYwyItd.js";
+import { D as getActiveContextWithBaggage, O as getContextStorage, T as createTraceContext, h as getEventQueue, k as hasExplicitSpanStatus, m as runInOperationContext, r as getSdk, t as getConfig$1 } from "./init-JtX-KKz_.js";
 import { setSpanName } from "./trace-helpers.js";
 import { SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
 import * as nodeFs from "node:fs";
@@ -175,9 +176,9 @@ function getSpanName(options, fn, variableName) {
 	if (options.serviceName) return `${options.serviceName}.${fnName}`;
 	if (fnName !== "anonymous") return fnName;
 	const initConfig = getConfig$1();
-	if (typeof process !== "undefined" && process.env.NODE_ENV !== "production" && !unknownSpanNameWarningEmitted && initConfig?.logger?.warn) {
+	if (isDevelopment() && !unknownSpanNameWarningEmitted && initConfig?.logger?.warn) {
 		unknownSpanNameWarningEmitted = true;
-		initConfig.logger.warn({}, "[autotel] Span name resolved to \"unknown\". Pass an explicit name, for example trace(\"operation.name\", fn).");
+		initConfig.logger.warn({}, "[autotel] Span name resolved to \"unknown\". Use instrument({ key: \"operation.name\", fn }) for a reusable named wrapper.");
 	}
 	return "unknown";
 }
@@ -204,7 +205,7 @@ function createDummyCtx() {
 function serializeCapture(value) {
 	if (value === void 0) return void 0;
 	try {
-		const json = typeof value === "string" ? value : JSON.stringify(value);
+		const json = asString(value) ?? JSON.stringify(value);
 		if (json === void 0) return void 0;
 		return json.length > CAPTURE_MAX_CHARS ? `${json.slice(0, CAPTURE_MAX_CHARS)}…[truncated]` : json;
 	} catch {
@@ -330,7 +331,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 			const fn = fnFactory(createTraceContext(span));
 			const argsAttributes = {
 				...captureInputAttrs(args, options.captureInput),
-				...options.attributesFromArgs ? options.attributesFromArgs(args) : {}
+				...options.attributesFromArgs?.(args)
 			};
 			const handleTailSampling = (success, duration, error) => {
 				if (needsTailSampling && sampler.shouldKeepTrace) {
@@ -355,9 +356,9 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 				});
 				const resultAttributes = {
 					...captureOutputAttrs(result, options.captureOutput),
-					...options.attributesFromResult ? options.attributesFromResult(result) : {}
+					...options.attributesFromResult?.(result)
 				};
-				span.setStatus({ code: SpanStatusCode.OK });
+				if (!hasExplicitSpanStatus(span)) span.setStatus({ code: SpanStatusCode.OK });
 				span.setAttributes({
 					...argsAttributes,
 					...resultAttributes,
@@ -370,8 +371,8 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 				span.end();
 				return result;
 			};
-			const onError = (error) => {
-				finalizeThrownSpan(error, options.isError, {
+			const onError = (cause) => {
+				finalizeThrownSpan(cause, options.isError, {
 					span,
 					spanName,
 					duration: performance.now() - startTime,
@@ -380,7 +381,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 					handleTailSampling,
 					extraAttributes: argsAttributes
 				});
-				throw error;
+				throw cause;
 			};
 			try {
 				callCounter?.add(1, {
@@ -425,6 +426,10 @@ function wrapFactoryWithTracing(factory, options, variableName) {
 function wrapPlainWithTracing(fn, options, variableName) {
 	return wrapWithTracingSync((_ctx) => fn, options, resolveVariableName(fn, variableName));
 }
+/** Run one operation immediately with its span-bound context. */
+function runWithTraceContext(operation, options) {
+	return wrapFactoryWithTracing((ctx) => () => operation(ctx), options)();
+}
 
 //#endregion
 //#region src/functional.ts
@@ -490,7 +495,7 @@ function getCtxValue() {
 *
 * @example
 * ```typescript
-* const getUser = trace('getUser', async (id: string) => {
+* const getUser = trace(async function getUser(id: string) {
 *   getActiveTraceContext()?.setAttribute('user.id', id);
 *   return db.users.find(id);
 * });
@@ -520,7 +525,8 @@ function getActiveTraceContext() {
 * })
 * ```
 */
-const ctx = new Proxy({}, {
+const ctxProxyTarget = {};
+const ctx = new Proxy(ctxProxyTarget, {
 	get(_target, prop) {
 		const ctxValue = getCtxValue();
 		if (!ctxValue) return;
@@ -542,11 +548,17 @@ const ctx = new Proxy({}, {
 		return Object.getOwnPropertyDescriptor(ctxValue, prop);
 	}
 });
-function trace$1(fnOrNameOrOptions, maybeFn) {
+function traceImpl(fnOrNameOrOptions, maybeFn) {
 	if (typeof fnOrNameOrOptions === "function") return wrapPlainWithTracing(fnOrNameOrOptions, {});
-	if (!maybeFn) throw new Error("trace(name|options, fn): fn is required");
-	return wrapPlainWithTracing(maybeFn, typeof fnOrNameOrOptions === "string" ? { name: fnOrNameOrOptions } : fnOrNameOrOptions);
+	const options = typeof fnOrNameOrOptions === "string" ? { name: fnOrNameOrOptions } : fnOrNameOrOptions;
+	if (maybeFn === void 0) return ((fn) => wrapPlainWithTracing(fn, options));
+	return wrapPlainWithTracing(maybeFn, options);
+}
+function run(nameOrOptions, operation) {
+	if (typeof operation !== "function") throw new TypeError("trace.run(name, operation): operation must be a function");
+	return runWithTraceContext(operation, typeof nameOrOptions === "string" ? { name: nameOrOptions } : nameOrOptions);
 }
+const trace$1 = Object.assign(traceImpl, { run });
 /**
 * Approach 2: withTracing() - Middleware-style composable wrapper
 *

package/dist/functional.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_functional = require('./functional-C0uAZq2X.cjs');
+const require_functional = require('./functional-Da6Yv64r.cjs');
 
 exports.ctx = require_functional.ctx;
 exports.getActiveTraceContext = require_functional.getActiveTraceContext;

package/dist/functional.d.cts

@@ -1,3 +1,3 @@
-import { n as TraceContext } from "./trace-context-IuyoPyNq.cjs";
-import { a as getActiveTraceContext, c as trace, d as withTracing, f as InstrumentOptions, i as ctx, l as withBaggage, m as TracingOptions, 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 { n as TraceContext } from "./trace-context-C1Cn1q0y.cjs";
+import { a as getActiveTraceContext, c as trace, d as withTracing, f as InstrumentOptions, i as ctx, l as withBaggage, m as TracingOptions, 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";
 export { type InstrumentOptions, type SingleInstrumentOptions, SpanOptions, type TraceContext, type TracingOptions, WithBaggageOptions, WithNewContextOptions, ctx, getActiveTraceContext, instrument, span, trace, withBaggage, withNewContext, withTracing };

package/dist/functional.d.ts

@@ -1,3 +1,3 @@
-import { n as TraceContext } from "./trace-context-IuyoPyNq.js";
-import { a as getActiveTraceContext, c as trace, d as withTracing, f as InstrumentOptions, i as ctx, l as withBaggage, m as TracingOptions, 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 { n as TraceContext } from "./trace-context-f89xPJbK.js";
+import { a as getActiveTraceContext, c as trace, d as withTracing, f as InstrumentOptions, i as ctx, l as withBaggage, m as TracingOptions, 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";
 export { type InstrumentOptions, type SingleInstrumentOptions, SpanOptions, type TraceContext, type TracingOptions, WithBaggageOptions, WithNewContextOptions, ctx, getActiveTraceContext, instrument, span, trace, withBaggage, withNewContext, withTracing };

package/dist/functional.js

@@ -1,3 +1,3 @@
-import { a as trace, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-DX7Zvag0.js";
+import { a as trace, 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";
 
 export { ctx, getActiveTraceContext, instrument, span, trace, withBaggage, withNewContext, withTracing };

package/dist/http.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_values = require('./values-DApyq53y.cjs');
 const require_config = require('./config.cjs');
-const require_init = require('./init-CTtHITlX.cjs');
+const require_init = require('./init-D4m5rCmD.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/http.ts
@@ -75,13 +76,13 @@ function HttpInstrumented(options = {}) {
 			constructor(...args) {
 				super(...args);
 				const proto = target.prototype;
-				const methodNames = Object.getOwnPropertyNames(proto).filter((name) => name !== "constructor" && typeof proto[name] === "function" && !name.startsWith("_"));
+				const methodNames = Object.getOwnPropertyNames(proto).filter((name) => name !== "constructor" && require_values.isFunction(require_values.readProperty(proto, name)) && !name.startsWith("_"));
 				for (const methodName of methodNames) {
 					const originalMethod = proto[methodName];
 					if (originalMethod.constructor.name === "AsyncFunction" || originalMethod.toString().startsWith("async ")) {
 						const wrappedMethod = async (...args) => {
 							const tracer = require_config.getConfig().tracer;
-							const url = options.urlExtractor ? options.urlExtractor(args) : args[0];
+							const url = options.urlExtractor ? options.urlExtractor(args) : require_values.asString(args[0]);
 							const method = options.methodExtractor ? options.methodExtractor(methodName, args) : inferHttpMethod(methodName);
 							const spanName = url ? `HTTP ${method} ${extractPath(url)}` : `HTTP ${method}`;
 							return tracer.startActiveSpan(spanName, async (span) => {
@@ -136,7 +137,12 @@ function HttpInstrumented(options = {}) {
 								}
 							});
 						};
-						this[methodName] = wrappedMethod;
+						Object.defineProperty(this, methodName, {
+							value: wrappedMethod,
+							writable: true,
+							enumerable: true,
+							configurable: true
+						});
 					}
 				}
 			}
@@ -207,10 +213,7 @@ function parseUrl(url) {
 	}
 }
 function extractStatusCode(result) {
-	if (result && typeof result === "object") {
-		if ("status" in result && typeof result.status === "number") return result.status;
-		if ("statusCode" in result && typeof result.statusCode === "number") return result.statusCode;
-	}
+	return require_values.asNumber(require_values.readProperty(result, "status")) ?? require_values.asNumber(require_values.readProperty(result, "statusCode"));
 }
 /**
 * Inject trace context into HTTP headers (for distributed tracing)

package/dist/http.js

@@ -1,5 +1,6 @@
+import { _ as readProperty, h as isFunction, i as asNumber, l as asString } from "./values-BenyvWKz.js";
 import { getConfig } from "./config.js";
-import { D as getActiveContextWithBaggage } from "./init-WHYwyItd.js";
+import { D as getActiveContextWithBaggage } from "./init-JtX-KKz_.js";
 import { SpanStatusCode, context, propagation } from "@opentelemetry/api";
 
 //#region src/http.ts
@@ -74,13 +75,13 @@ function HttpInstrumented(options = {}) {
 			constructor(...args) {
 				super(...args);
 				const proto = target.prototype;
-				const methodNames = Object.getOwnPropertyNames(proto).filter((name) => name !== "constructor" && typeof proto[name] === "function" && !name.startsWith("_"));
+				const methodNames = Object.getOwnPropertyNames(proto).filter((name) => name !== "constructor" && isFunction(readProperty(proto, name)) && !name.startsWith("_"));
 				for (const methodName of methodNames) {
 					const originalMethod = proto[methodName];
 					if (originalMethod.constructor.name === "AsyncFunction" || originalMethod.toString().startsWith("async ")) {
 						const wrappedMethod = async (...args) => {
 							const tracer = getConfig().tracer;
-							const url = options.urlExtractor ? options.urlExtractor(args) : args[0];
+							const url = options.urlExtractor ? options.urlExtractor(args) : asString(args[0]);
 							const method = options.methodExtractor ? options.methodExtractor(methodName, args) : inferHttpMethod(methodName);
 							const spanName = url ? `HTTP ${method} ${extractPath(url)}` : `HTTP ${method}`;
 							return tracer.startActiveSpan(spanName, async (span) => {
@@ -135,7 +136,12 @@ function HttpInstrumented(options = {}) {
 								}
 							});
 						};
-						this[methodName] = wrappedMethod;
+						Object.defineProperty(this, methodName, {
+							value: wrappedMethod,
+							writable: true,
+							enumerable: true,
+							configurable: true
+						});
 					}
 				}
 			}
@@ -206,10 +212,7 @@ function parseUrl(url) {
 	}
 }
 function extractStatusCode(result) {
-	if (result && typeof result === "object") {
-		if ("status" in result && typeof result.status === "number") return result.status;
-		if ("statusCode" in result && typeof result.statusCode === "number") return result.statusCode;
-	}
+	return asNumber(readProperty(result, "status")) ?? asNumber(readProperty(result, "statusCode"));
 }
 /**
 * Inject trace context into HTTP headers (for distributed tracing)

package/dist/{index-DolOVX6F.d.ts → index-CwrNAsgk.d.ts}

@@ -1,6 +1,6 @@
-import { n as TraceContext, t as AttributeValue$1 } from "./trace-context-IuyoPyNq.js";
+import { n as TraceContext, t as AttributeValue$1 } from "./trace-context-f89xPJbK.js";
 import { Resource } from "@opentelemetry/resources";
-import { Span } from "@opentelemetry/api";
+import { AttributeValue, Attributes, Span } from "@opentelemetry/api";
 //#region src/attributes/types.d.ts
 interface UserAttrs {
   id?: string;
@@ -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 };