autotel 6.5.0 → 7.0.1

package/dist/{functional-AT22vCw6.d.ts → functional-DXy1cHFF.d.ts}

@@ -1,6 +1,6 @@
-import { n as TraceContext } from "./trace-context-IuyoPyNq.js";
-import { p as Sampler } from "./sampling-CP3e7-Yr.js";
-import { Span, SpanKind } from "@opentelemetry/api";
+import { n as TraceContext } from "./trace-context-f89xPJbK.js";
+import { p as Sampler } from "./sampling-CM5S2Lp3.js";
+import { Attributes, Span, SpanKind } from "@opentelemetry/api";
 //#region src/functional-wrapper.d.ts
 type WrappedFunction<TArgs extends unknown[], TReturn> = (...args: TArgs) => TReturn | Promise<TReturn>;
 /**
@@ -35,9 +35,10 @@ interface TracingOptions<TArgs extends unknown[] = unknown[], TReturn = unknown>
    */
   withMetrics?: boolean;
   /** Extract attributes from function arguments. */
-  attributesFromArgs?: (args: TArgs) => Record<string, unknown>;
+  attributesFromArgs?: (args: TArgs) => Attributes;
   /** Extract attributes from the function result. */
-  attributesFromResult?: (result: TReturn) => Record<string, unknown>;
+  /** Receives the resolved value when the function returns a Promise. */
+  attributesFromResult?: (result: Awaited<TReturn>) => Attributes;
   /**
    * Capture arguments on the span as the truncated JSON `autotel.input`
    * attribute. One argument is captured directly; multiple arguments are an
@@ -72,7 +73,7 @@ interface TracingOptions<TArgs extends unknown[] = unknown[], TReturn = unknown>
    * as `redirect()` and `notFound()`.
    * @default every throw is treated as an error
    */
-  isError?: (error: unknown) => boolean;
+  isError?: (cause: unknown) => boolean;
 }
 /** Options for `instrument()` batch instrumentation. */
 interface InstrumentOptions<T extends Record<string, AnyInstrumentable> = Record<string, AnyInstrumentable>> extends TracingOptions {
@@ -95,6 +96,33 @@ interface SingleInstrumentOptions<TFunction extends AnyInstrumentable = AnyInstr
 }
 //#endregion
 //#region src/functional.d.ts
+/**
+ * Complete trace context containing trace identifiers and span methods
+ *
+ * The ctx parameter in trace() functions provides:
+ * - traceId, spanId, correlationId from the active span
+ * - Span manipulation methods (setAttribute, setAttributes, setStatus, recordException)
+ *
+ * For custom context, access it directly in your functions (standard OpenTelemetry pattern).
+ *
+ * @example
+ * ```typescript
+ * import { trace } from 'autotel'
+ *
+ * export const createUser = withTracing({})((ctx) => async (data: CreateUserData) => {
+ *   // Get custom context directly (standard OTel approach)
+ *   const userId = getCurrentUserId()
+ *   const tenantId = getCurrentTenant()
+ *
+ *   // Use ctx for span operations and trace IDs
+ *   ctx.setAttribute('user.id', data.id)
+ *   ctx.setAttribute('user.tenant', tenantId)
+ *   console.log(ctx.traceId)  // Trace IDs available
+ * })
+ * ```
+ */
+/** Baggage entries: values that survive the W3C baggage header. */
+type BaggageValues = Record<string, string | number | boolean>;
 /**
  * Get the autotel {@link TraceContext} for the currently active span.
  *
@@ -105,7 +133,7 @@ interface SingleInstrumentOptions<TFunction extends AnyInstrumentable = AnyInstr
  *
  * @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);
  * });
@@ -114,34 +142,17 @@ interface SingleInstrumentOptions<TFunction extends AnyInstrumentable = AnyInstr
  * @see getActiveSpan for the raw OpenTelemetry span
  * @see getRequestLogger which reads the active context when called with no args
  */
-declare function getActiveTraceContext<TBaggage extends Record<string, unknown> | undefined = undefined>(): TraceContext<TBaggage> | undefined;
-/**
- * Context object that lazily evaluates the active span on property access
- *
- * Access trace context directly without function call syntax.
- *
- * @example
- * ```typescript
- * import { trace, ctx } from 'autotel'
- *
- * export const createUser = trace(async (data) => {
- *   // Direct property access - no function call!
- *   if (ctx.traceId) {
- *     ctx.setAttribute('user.id', data.id)
- *     console.log('Trace:', ctx.traceId)
- *   }
- * })
- * ```
- */
+declare function getActiveTraceContext<TBaggage extends BaggageValues | undefined = undefined>(): TraceContext<TBaggage> | undefined;
 declare const ctx: TraceContext;
 /**
- * Wrap a plain function with automatic tracing. The function receives its real
- * arguments; no context parameter is injected. Use
- * {@link getActiveTraceContext} inside the function, or use {@link withTracing}
- * for the explicit `(ctx) => (...args) => result` factory form.
+ * Wrap a plain function with a traced wrapper, or run one named operation
+ * immediately with {@link trace.run}.
  *
- * `trace()` never executes or inspects the function during wrapper
- * construction.
+ * Every `trace(...)` call returns a **wrapper**. Nothing runs until you call
+ * what you get back, so a `trace()` call can never execute your function at
+ * module load. Reach the span from inside the body through the ambient
+ * {@link ctx} - it resolves at any depth, so a helper three frames down sees
+ * the same span without being handed anything.
  *
  * @example Auto-inferred name
  * ```typescript
@@ -150,24 +161,70 @@ declare const ctx: TraceContext;
  * })
  * ```
  *
- * @example Ambient context access
+ * @example Explicit name
  * ```typescript
- * export const createUser = trace(async (data) => {
- *   getActiveTraceContext()?.setAttribute('user.id', data.id)
+ * export const createUser = trace('user.create', async (data) => {
  *   return await db.users.create(data)
  * })
  * ```
  *
- * @example Explicit name
+ * @example Ambient context, at any depth
  * ```typescript
+ * import { trace, ctx } from 'autotel'
+ *
  * export const createUser = trace('user.create', async (data) => {
+ *   ctx.setAttribute('user.id', data.id)
  *   return await db.users.create(data)
  * })
  * ```
+ *
+ * @example Curried, for a shared configuration
+ * ```typescript
+ * const traced = trace({ serviceName: 'users' })
+ * export const createUser = traced(async (data) => db.users.create(data))
+ * ```
+ *
+ * @example One operation, run now - see {@link trace.run}
+ * ```typescript
+ * const user = await trace.run('user.create', async (ctx) => {
+ *   ctx.setAttribute('user.id', input.id)
+ *   return db.users.create(input)
+ * })
+ * ```
+ */
+declare function traceImpl<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function traceImpl<TArgs extends unknown[], TReturn>(name: string, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function traceImpl<TArgs extends unknown[], TReturn>(options: TracingOptions<TArgs, TReturn>, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function traceImpl(name: string): <TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
+declare function traceImpl<TArgs extends unknown[], TReturn>(options: TracingOptions<TArgs, TReturn>): (fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
+/**
+ * Run one named operation immediately and return its result, with the
+ * {@link TraceContext} passed in.
+ *
+ * This is the counterpart to {@link trace}: `trace(...)` always hands back a
+ * wrapper to call later, `trace.run(...)` runs the operation now. Keeping them
+ * under separate names is deliberate - a single call shape that sometimes
+ * wrapped and sometimes ran is what made dispatch depend on a callback's
+ * parameter name, which a minifier is free to rewrite (#166).
+ *
+ * The body can equally read the ambient {@link ctx}; the parameter is here for
+ * when an explicit binding reads better.
+ *
+ * @example
+ * ```typescript
+ * const user = await trace.run('user.create', async (ctx) => {
+ *   ctx.setAttribute('user.id', input.id)
+ *   return db.users.create(input)
+ * })
+ * ```
  */
-declare function trace$1<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-declare function trace$1<TArgs extends unknown[], TReturn>(name: string, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
-declare function trace$1<TArgs extends unknown[], TReturn>(options: TracingOptions<TArgs, TReturn>, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
+declare function run<TReturn>(name: string, operation: (ctx: TraceContext) => Promise<TReturn>): Promise<TReturn>;
+declare function run<TReturn>(name: string, operation: (ctx: TraceContext) => TReturn): TReturn;
+declare function run<TReturn>(options: TracingOptions<[], TReturn>, operation: (ctx: TraceContext) => Promise<TReturn>): Promise<TReturn>;
+declare function run<TReturn>(options: TracingOptions<[], TReturn>, operation: (ctx: TraceContext) => TReturn): TReturn;
+declare const trace$1: typeof traceImpl & {
+  run: typeof run;
+};
 /**
  * Approach 2: withTracing() - Middleware-style composable wrapper
  *

package/dist/{functional-DX7Zvag0.js → functional-nS5U4KCQ.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-DDyaLzeg.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-C2ONG9PK.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-nS5U4KCQ.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-C5aHRqi2.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-DDyaLzeg.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 };