autotel 7.6.2 → 7.7.1

package/dist/attributes.d.cts

@@ -1,2 +1,2 @@
-import { A as ExceptionAttrs, B as PeerAttrs, C as CloudAttrs, D as DeploymentAttrs, E as DBAttrs, F as HTTPServerAttrs, G as SessionAttrs, H as RPCAttrs, I as K8sAttrs, J as URLAttrs, K as TLSAttrs, L as MessagingAttrs, M as FeatureFlagAttrs, N as GraphQLAttrs, O as DeviceAttrs, P as HTTPClientAttrs, R as NetworkAttrs, S as ClientAttrs, T as ContainerAttrs, U as ServerAddressAttrs, V as ProcessAttrs, W as ServiceAttrs, Y as UserAttrs, _ as autoRedactPII, a as httpClient, b as validateAttribute, c as mergeServiceResource, d as setError, f as setException, g as AttributePolicy, h as AttributeGuardrails, i as dbClient, j as FaaSAttrs, k as ErrorAttrs, l as request, m as setUser, n as safeSetAttributes, o as httpServer, p as setSession, q as ThreadAttrs, r as transaction, s as identify, t as mergeAttrs, u as setDevice, v as checkDeprecatedAttribute, w as CodeAttrs, x as attrs, y as defaultGuardrails, z as OTelAttrs } from "./index-Y7If_wH4.cjs";
+import { A as ExceptionAttrs, B as PeerAttrs, C as CloudAttrs, D as DeploymentAttrs, E as DBAttrs, F as HTTPServerAttrs, G as SessionAttrs, H as RPCAttrs, I as K8sAttrs, J as URLAttrs, K as TLSAttrs, L as MessagingAttrs, M as FeatureFlagAttrs, N as GraphQLAttrs, O as DeviceAttrs, P as HTTPClientAttrs, R as NetworkAttrs, S as ClientAttrs, T as ContainerAttrs, U as ServerAddressAttrs, V as ProcessAttrs, W as ServiceAttrs, Y as UserAttrs, _ as autoRedactPII, a as httpClient, b as validateAttribute, c as mergeServiceResource, d as setError, f as setException, g as AttributePolicy, h as AttributeGuardrails, i as dbClient, j as FaaSAttrs, k as ErrorAttrs, l as request, m as setUser, n as safeSetAttributes, o as httpServer, p as setSession, q as ThreadAttrs, r as transaction, s as identify, t as mergeAttrs, u as setDevice, v as checkDeprecatedAttribute, w as CodeAttrs, x as attrs, y as defaultGuardrails, z as OTelAttrs } from "./index-8bFU4kmd.cjs";
 export { type AttributeGuardrails, type AttributePolicy, type ClientAttrs, type CloudAttrs, type CodeAttrs, type ContainerAttrs, type DBAttrs, type DeploymentAttrs, type DeviceAttrs, type ErrorAttrs, type ExceptionAttrs, type FaaSAttrs, type FeatureFlagAttrs, type GraphQLAttrs, type HTTPClientAttrs, type HTTPServerAttrs, type K8sAttrs, type MessagingAttrs, type NetworkAttrs, type OTelAttrs, type PeerAttrs, type ProcessAttrs, type RPCAttrs, type ServerAddressAttrs, type ServiceAttrs, type SessionAttrs, type TLSAttrs, type ThreadAttrs, type URLAttrs, type UserAttrs, attrs, autoRedactPII, checkDeprecatedAttribute, dbClient, defaultGuardrails, httpClient, httpServer, identify, mergeAttrs, mergeServiceResource, request, safeSetAttributes, setDevice, setError, setException, setSession, setUser, transaction, validateAttribute };

package/dist/attributes.d.ts

@@ -1,2 +1,2 @@
-import { A as ExceptionAttrs, B as PeerAttrs, C as CloudAttrs, D as DeploymentAttrs, E as DBAttrs, F as HTTPServerAttrs, G as SessionAttrs, H as RPCAttrs, I as K8sAttrs, J as URLAttrs, K as TLSAttrs, L as MessagingAttrs, M as FeatureFlagAttrs, N as GraphQLAttrs, O as DeviceAttrs, P as HTTPClientAttrs, R as NetworkAttrs, S as ClientAttrs, T as ContainerAttrs, U as ServerAddressAttrs, V as ProcessAttrs, W as ServiceAttrs, Y as UserAttrs, _ as autoRedactPII, a as httpClient, b as validateAttribute, c as mergeServiceResource, d as setError, f as setException, g as AttributePolicy, h as AttributeGuardrails, i as dbClient, j as FaaSAttrs, k as ErrorAttrs, l as request, m as setUser, n as safeSetAttributes, o as httpServer, p as setSession, q as ThreadAttrs, r as transaction, s as identify, t as mergeAttrs, u as setDevice, v as checkDeprecatedAttribute, w as CodeAttrs, x as attrs, y as defaultGuardrails, z as OTelAttrs } from "./index-CsoeCsGL.js";
+import { A as ExceptionAttrs, B as PeerAttrs, C as CloudAttrs, D as DeploymentAttrs, E as DBAttrs, F as HTTPServerAttrs, G as SessionAttrs, H as RPCAttrs, I as K8sAttrs, J as URLAttrs, K as TLSAttrs, L as MessagingAttrs, M as FeatureFlagAttrs, N as GraphQLAttrs, O as DeviceAttrs, P as HTTPClientAttrs, R as NetworkAttrs, S as ClientAttrs, T as ContainerAttrs, U as ServerAddressAttrs, V as ProcessAttrs, W as ServiceAttrs, Y as UserAttrs, _ as autoRedactPII, a as httpClient, b as validateAttribute, c as mergeServiceResource, d as setError, f as setException, g as AttributePolicy, h as AttributeGuardrails, i as dbClient, j as FaaSAttrs, k as ErrorAttrs, l as request, m as setUser, n as safeSetAttributes, o as httpServer, p as setSession, q as ThreadAttrs, r as transaction, s as identify, t as mergeAttrs, u as setDevice, v as checkDeprecatedAttribute, w as CodeAttrs, x as attrs, y as defaultGuardrails, z as OTelAttrs } from "./index-o_6YjZhV.js";
 export { type AttributeGuardrails, type AttributePolicy, type ClientAttrs, type CloudAttrs, type CodeAttrs, type ContainerAttrs, type DBAttrs, type DeploymentAttrs, type DeviceAttrs, type ErrorAttrs, type ExceptionAttrs, type FaaSAttrs, type FeatureFlagAttrs, type GraphQLAttrs, type HTTPClientAttrs, type HTTPServerAttrs, type K8sAttrs, type MessagingAttrs, type NetworkAttrs, type OTelAttrs, type PeerAttrs, type ProcessAttrs, type RPCAttrs, type ServerAddressAttrs, type ServiceAttrs, type SessionAttrs, type TLSAttrs, type ThreadAttrs, type URLAttrs, type UserAttrs, attrs, autoRedactPII, checkDeprecatedAttribute, dbClient, defaultGuardrails, httpClient, httpServer, identify, mergeAttrs, mergeServiceResource, request, safeSetAttributes, setDevice, setError, setException, setSession, setUser, transaction, validateAttribute };

package/dist/auto.cjs

@@ -1,5 +1,5 @@
 const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
-const require_init = require('./init-zGVUHByM.cjs');
+const require_init = require('./init-BYXDCfRL.cjs');
 let node_module = require("node:module");
 node_module = require_rolldown_runtime.__toESM(node_module, 1);
 let import_in_the_middle = require("import-in-the-middle");

package/dist/auto.js

@@ -1,4 +1,4 @@
-import { _ as loadYamlConfig, a as init } from "./init-Dwj1goyE.js";
+import { _ as loadYamlConfig, a as init } from "./init-Dyq6WtsO.js";
 import * as nodeModule from "node:module";
 import { createAddHookMessageChannel } from "import-in-the-middle";
 

package/dist/business-baggage.d.cts

@@ -1,4 +1,4 @@
-import { n as TraceContext } from "./trace-context-C1Cn1q0y.cjs";
+import { n as TraceContext } from "./trace-context-f7Xq0Q2q.cjs";
 //#region src/business-baggage.d.ts
 /**
  * Supported field types in baggage schema

package/dist/business-baggage.d.ts

@@ -1,4 +1,4 @@
-import { n as TraceContext } from "./trace-context-f89xPJbK.js";
+import { n as TraceContext } from "./trace-context-CqCblIQE.js";
 //#region src/business-baggage.d.ts
 /**
  * Supported field types in baggage schema

package/dist/correlation-id.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_init = require('./init-zGVUHByM.cjs');
+const require_init = require('./init-BYXDCfRL.cjs');
 
 exports.CORRELATION_ID_BAGGAGE_KEY = require_init.CORRELATION_ID_BAGGAGE_KEY;
 exports.generateCorrelationId = require_init.generateCorrelationId;

package/dist/correlation-id.js

@@ -1,3 +1,3 @@
-import { $ as getCorrelationStorage, Q as getCorrelationId, X as CORRELATION_ID_BAGGAGE_KEY, Z as generateCorrelationId, et as getOrCreateCorrelationId, nt as setCorrelationId, rt as setCorrelationIdInBaggage, tt as runWithCorrelationId } from "./init-Dwj1goyE.js";
+import { $ as getCorrelationStorage, Q as getCorrelationId, X as CORRELATION_ID_BAGGAGE_KEY, Z as generateCorrelationId, et as getOrCreateCorrelationId, nt as setCorrelationId, rt as setCorrelationIdInBaggage, tt as runWithCorrelationId } from "./init-Dyq6WtsO.js";
 
 export { CORRELATION_ID_BAGGAGE_KEY, generateCorrelationId, getCorrelationId, getCorrelationStorage, getOrCreateCorrelationId, runWithCorrelationId, setCorrelationId, setCorrelationIdInBaggage };

package/dist/db.cjs

@@ -171,7 +171,6 @@ function instrumentDatabase(client, options) {
 	const target = clientMembers(client);
 	if (target[INSTRUMENTED_SYMBOL]) return client;
 	const { dbSystem, dbName, methods, skipMethods = [], sanitizeQuery = true, slowQueryThresholdMs = 1e3 } = options;
-	const tracer = require_config.getConfig().tracer;
 	const methodsToInstrument = methods || extractDatabaseMethods(client);
 	const skipSet = new Set(skipMethods);
 	for (const methodName of methodsToInstrument) {
@@ -184,6 +183,7 @@ function instrumentDatabase(client, options) {
 			const operation = inferDbOperation(methodName);
 			const table = inferTableName(methodName);
 			const spanName = table ? `${dbSystem}.${operation} ${table}` : `${dbSystem}.${operation}`;
+			const { tracer } = require_config.getConfig();
 			return tracer.startActiveSpan(spanName, async (span) => {
 				const startTime = performance.now();
 				try {

package/dist/db.js

@@ -170,7 +170,6 @@ function instrumentDatabase(client, options) {
 	const target = clientMembers(client);
 	if (target[INSTRUMENTED_SYMBOL]) return client;
 	const { dbSystem, dbName, methods, skipMethods = [], sanitizeQuery = true, slowQueryThresholdMs = 1e3 } = options;
-	const tracer = getConfig().tracer;
 	const methodsToInstrument = methods || extractDatabaseMethods(client);
 	const skipSet = new Set(skipMethods);
 	for (const methodName of methodsToInstrument) {
@@ -183,6 +182,7 @@ function instrumentDatabase(client, options) {
 			const operation = inferDbOperation(methodName);
 			const table = inferTableName(methodName);
 			const spanName = table ? `${dbSystem}.${operation} ${table}` : `${dbSystem}.${operation}`;
+			const { tracer } = getConfig();
 			return tracer.startActiveSpan(spanName, async (span) => {
 				const startTime = performance.now();
 				try {

package/dist/decorators.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_values = require('./values-tm4bi0FF.cjs');
 const require_config = require('./config.cjs');
-const require_init = require('./init-zGVUHByM.cjs');
+const require_init = require('./init-BYXDCfRL.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/decorators.ts

package/dist/decorators.d.cts

@@ -1,5 +1,5 @@
-import { n as TraceContext } from "./trace-context-C1Cn1q0y.cjs";
-import { m as TracingOptions } from "./functional-CgWcRXGX.cjs";
+import { n as TraceContext } from "./trace-context-f7Xq0Q2q.cjs";
+import { h as TracingOptions } from "./functional-C4mjgtJb.cjs";
 //#region src/decorators.d.ts
 /**
  * Options for @Trace method decorator

package/dist/decorators.d.ts

@@ -1,5 +1,5 @@
-import { n as TraceContext } from "./trace-context-f89xPJbK.js";
-import { m as TracingOptions } from "./functional-RFFpQzAV.js";
+import { n as TraceContext } from "./trace-context-CqCblIQE.js";
+import { h as TracingOptions } from "./functional-DN_ztd9C.js";
 //#region src/decorators.d.ts
 /**
  * Options for @Trace method decorator

package/dist/decorators.js

@@ -1,6 +1,6 @@
 import { y as splitNameOrOptions } from "./values-xBtdXtjA.js";
 import { getConfig } from "./config.js";
-import { U as createTraceContext } from "./init-Dwj1goyE.js";
+import { U as createTraceContext } from "./init-Dyq6WtsO.js";
 import { SpanStatusCode } from "@opentelemetry/api";
 
 //#region src/decorators.ts

package/dist/event.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_init = require('./init-zGVUHByM.cjs');
+const require_init = require('./init-BYXDCfRL.cjs');
 
 exports.Event = require_init.Event;
 exports.getEvents = require_init.getEvents;

package/dist/event.js

@@ -1,3 +1,3 @@
-import { d as Event, f as getEvents, p as resetEvents } from "./init-Dwj1goyE.js";
+import { d as Event, f as getEvents, p as resetEvents } from "./init-Dyq6WtsO.js";
 
 export { Event, getEvents, resetEvents };

package/dist/{functional-CgWcRXGX.d.cts → functional-C4mjgtJb.d.cts}

@@ -1,4 +1,4 @@
-import { n as TraceContext } from "./trace-context-C1Cn1q0y.cjs";
+import { n as TraceContext } from "./trace-context-f7Xq0Q2q.cjs";
 import { m as Sampler } from "./sampling-Er217Mge.cjs";
 import { Attributes, Span, SpanKind } from "@opentelemetry/api";
 //#region src/functional-wrapper.d.ts
@@ -144,6 +144,29 @@ type BaggageValues = Record<string, string | number | boolean>;
  */
 declare function getActiveTraceContext<TBaggage extends BaggageValues | undefined = undefined>(): TraceContext<TBaggage> | undefined;
 declare const ctx: TraceContext;
+/**
+ * The ambient {@link ctx}, aimed at the **request** span rather than at
+ * whatever span the calling code happens to be inside.
+ *
+ * Framework instrumentation nests spans per layer - express opens one per
+ * middleware and per route handler - so `ctx.setAttribute()` from a shared
+ * middleware records on a span that ends the moment `next()` fires. Attributes
+ * that describe the request as a whole (the authenticated user, the tenant, the
+ * plan) belong on the request span, which is what a backend shows as the
+ * resource and what a canonical log line is built from.
+ *
+ * Falls back to the active span outside a request, and no-ops when nothing is
+ * active at all, exactly as `ctx` does.
+ *
+ * @example
+ * ```typescript
+ * app.use((req, _res, next) => {
+ *   requestCtx.setAttributes({ user: req.user });  // user.id, user.plan, ...
+ *   next();
+ * });
+ * ```
+ */
+declare const requestCtx: TraceContext;
 /**
  * Wrap a plain function with a traced wrapper, or run one named operation
  * immediately with {@link trace.run}.
@@ -450,4 +473,4 @@ interface WithBaggageOptions<T = unknown> {
  */
 declare function withBaggage<T = unknown>(options: WithBaggageOptions<T>): T | Promise<T>;
 //#endregion
-export { getActiveTraceContext as a, trace$1 as c, withTracing as d, InstrumentOptions as f, ctx as i, withBaggage as l, TracingOptions as m, WithBaggageOptions as n, instrument as o, SingleInstrumentOptions as p, WithNewContextOptions as r, span as s, SpanOptions as t, withNewContext as u };
+export { getActiveTraceContext as a, span as c, withNewContext as d, withTracing as f, TracingOptions as h, ctx as i, trace$1 as l, SingleInstrumentOptions as m, WithBaggageOptions as n, instrument as o, InstrumentOptions as p, WithNewContextOptions as r, requestCtx as s, SpanOptions as t, withBaggage as u };

package/dist/{functional-RFFpQzAV.d.ts → functional-DN_ztd9C.d.ts}

@@ -1,4 +1,4 @@
-import { n as TraceContext } from "./trace-context-f89xPJbK.js";
+import { n as TraceContext } from "./trace-context-CqCblIQE.js";
 import { m as Sampler } from "./sampling-DBng4Foa.js";
 import { Attributes, Span, SpanKind } from "@opentelemetry/api";
 //#region src/functional-wrapper.d.ts
@@ -144,6 +144,29 @@ type BaggageValues = Record<string, string | number | boolean>;
  */
 declare function getActiveTraceContext<TBaggage extends BaggageValues | undefined = undefined>(): TraceContext<TBaggage> | undefined;
 declare const ctx: TraceContext;
+/**
+ * The ambient {@link ctx}, aimed at the **request** span rather than at
+ * whatever span the calling code happens to be inside.
+ *
+ * Framework instrumentation nests spans per layer - express opens one per
+ * middleware and per route handler - so `ctx.setAttribute()` from a shared
+ * middleware records on a span that ends the moment `next()` fires. Attributes
+ * that describe the request as a whole (the authenticated user, the tenant, the
+ * plan) belong on the request span, which is what a backend shows as the
+ * resource and what a canonical log line is built from.
+ *
+ * Falls back to the active span outside a request, and no-ops when nothing is
+ * active at all, exactly as `ctx` does.
+ *
+ * @example
+ * ```typescript
+ * app.use((req, _res, next) => {
+ *   requestCtx.setAttributes({ user: req.user });  // user.id, user.plan, ...
+ *   next();
+ * });
+ * ```
+ */
+declare const requestCtx: TraceContext;
 /**
  * Wrap a plain function with a traced wrapper, or run one named operation
  * immediately with {@link trace.run}.
@@ -450,4 +473,4 @@ interface WithBaggageOptions<T = unknown> {
  */
 declare function withBaggage<T = unknown>(options: WithBaggageOptions<T>): T | Promise<T>;
 //#endregion
-export { getActiveTraceContext as a, trace$1 as c, withTracing as d, InstrumentOptions as f, ctx as i, withBaggage as l, TracingOptions as m, WithBaggageOptions as n, instrument as o, SingleInstrumentOptions as p, WithNewContextOptions as r, span as s, SpanOptions as t, withNewContext as u };
+export { getActiveTraceContext as a, span as c, withNewContext as d, withTracing as f, TracingOptions as h, ctx as i, trace$1 as l, SingleInstrumentOptions as m, WithBaggageOptions as n, instrument as o, InstrumentOptions as p, WithNewContextOptions as r, requestCtx as s, SpanOptions as t, withBaggage as u };

package/dist/{functional-DzIFi7ml.js → functional-S9IJNlBn.js}

@@ -1,10 +1,10 @@
-import { l as asString, m as isDevelopment } from "./values-xBtdXtjA.js";
+import { _ as readProperty, h as isFunction, l as asString, m as isDevelopment } from "./values-xBtdXtjA.js";
 import { getForceFlushableProvider } from "./tracer-provider.js";
 import { getConfig } from "./config.js";
-import { C as AUTOTEL_SAMPLING_RATE, D as AlwaysSampler, G as getActiveContextWithBaggage, I as debugCaptureRequested, J as getEventQueue, K as getContextStorage, T as AUTOTEL_SAMPLING_TAIL_KEEP, U as createTraceContext, h as runInOperationContext, i as getSdk, n as getConfiguredSampler, q as hasExplicitSpanStatus, t as getConfig$1, w as AUTOTEL_SAMPLING_TAIL_EVALUATED, z as isForceKept } from "./init-Dwj1goyE.js";
+import { C as AUTOTEL_SAMPLING_RATE, D as AlwaysSampler, G as getActiveContextWithBaggage, I as debugCaptureRequested, J as getEventQueue, K as getContextStorage, T as AUTOTEL_SAMPLING_TAIL_KEEP, U as createTraceContext, h as runInOperationContext, i as getSdk, n as getConfiguredSampler, q as hasExplicitSpanStatus, t as getConfig$1, w as AUTOTEL_SAMPLING_TAIL_EVALUATED, z as isForceKept } from "./init-Dyq6WtsO.js";
 import { evidenceAttribute } from "./evidence.js";
 import { setSpanName } from "./trace-helpers.js";
-import { SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
+import { SpanStatusCode, context, createContextKey, propagation, trace } from "@opentelemetry/api";
 import * as nodeFs from "node:fs";
 import * as nodeUrl from "node:url";
 
@@ -346,7 +346,7 @@ function runWithTraceContextStorage(fn) {
 /** Used when neither the wrapper nor `init()` chose a sampler. */
 const FALLBACK_SAMPLER = new AlwaysSampler();
 function wrapWithTracingSync(fnFactory, options, variableName) {
-	const { tracer, meter } = getConfig();
+	const { meter } = getConfig();
 	const resolveSampler = () => options.sampler ?? getConfiguredSampler() ?? FALLBACK_SAMPLER;
 	const spanName = getSpanName(options, fnFactory, variableName);
 	const callCounter = options.withMetrics ? meter.createCounter(`${spanName}.calls`, {
@@ -376,6 +376,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 		const spanOptions = {};
 		if (options.startNewRoot) spanOptions.root = true;
 		if (options.spanKind !== void 0) spanOptions.kind = options.spanKind;
+		const { tracer } = getConfig();
 		return tracer.startActiveSpan(spanName, spanOptions, getActiveContextWithBaggage(), (span) => runInOperationContext(spanName, () => runWithTraceContextStorage(() => {
 			let shouldKeepSpan = true;
 			setSpanName(span, spanName);
@@ -579,27 +580,111 @@ function getActiveTraceContext() {
 * ```
 */
 const ctxProxyTarget = {};
-const ctx = new Proxy(ctxProxyTarget, {
-	get(_target, prop) {
-		const ctxValue = getCtxValue();
-		if (!ctxValue) return;
-		return ctxValue[prop];
-	},
-	has(_target, prop) {
-		const ctxValue = getCtxValue();
-		if (!ctxValue) return false;
-		return prop in ctxValue;
-	},
-	ownKeys() {
-		const ctxValue = getCtxValue();
-		if (!ctxValue) return [];
-		return Object.keys(ctxValue);
-	},
-	getOwnPropertyDescriptor(_target, prop) {
-		const ctxValue = getCtxValue();
-		if (!ctxValue) return;
-		return Object.getOwnPropertyDescriptor(ctxValue, prop);
-	}
+/**
+* What the methods do when no span is active - which is what a real
+* `NonRecordingSpan` does too, and the reason instrumentation can never be the
+* thing that throws: the same `ctx.setAttribute()` call runs under `vitest` and
+* under a plain `node server.js`, where nothing preloaded the SDK.
+*
+* Only these names get a callable fallback. A blanket no-op would answer `then`
+* as well, which would turn `ctx` into a thenable that never resolves.
+* `functional.test.ts` asserts this list against a live context, so a new
+* member cannot quietly go missing from it.
+*/
+const noop = () => {};
+const INACTIVE_CTX_METHODS = {
+	setAttribute: noop,
+	setAttributes: noop,
+	setStatus: noop,
+	recordException: noop,
+	addEvent: noop,
+	addLink: noop,
+	addLinks: noop,
+	updateName: noop,
+	recordError: noop,
+	track: noop,
+	isRecording: () => false,
+	getBaggage: () => void 0,
+	setBaggage: (_key, value) => value,
+	deleteBaggage: noop,
+	getAllBaggage: () => /* @__PURE__ */ new Map(),
+	getTypedBaggage: () => void 0,
+	setTypedBaggage: noop
+};
+/** A `ctx`-shaped view of whatever context `resolve` finds at access time. */
+function createCtxProxy(resolve) {
+	return new Proxy(ctxProxyTarget, {
+		get(_target, prop) {
+			const ctxValue = resolve();
+			if (!ctxValue) return typeof prop === "string" ? INACTIVE_CTX_METHODS[prop] : void 0;
+			return ctxValue[prop];
+		},
+		has(_target, prop) {
+			const ctxValue = resolve();
+			if (!ctxValue) return typeof prop === "string" && prop in INACTIVE_CTX_METHODS;
+			return prop in ctxValue;
+		},
+		ownKeys() {
+			const ctxValue = resolve();
+			return Object.keys(ctxValue ?? INACTIVE_CTX_METHODS);
+		},
+		getOwnPropertyDescriptor(_target, prop) {
+			const ctxValue = resolve();
+			if (!ctxValue) {
+				const fallback = typeof prop === "string" ? INACTIVE_CTX_METHODS[prop] : void 0;
+				return fallback === void 0 ? void 0 : {
+					value: fallback,
+					writable: false,
+					enumerable: true,
+					configurable: true
+				};
+			}
+			return Object.getOwnPropertyDescriptor(ctxValue, prop);
+		}
+	});
+}
+const ctx = createCtxProxy(getCtxValue);
+/**
+* The key `@opentelemetry/core` publishes RPC metadata under. `createContextKey`
+* is `Symbol.for`, so this reads exactly what `instrumentation-http` (and every
+* framework instrumentation that renames the route) wrote, without taking a
+* dependency on core.
+*/
+const RPC_METADATA_KEY = createContextKey("OpenTelemetry SDK Context Key RPC_METADATA");
+/**
+* The span the current request is being recorded on, or the active span when
+* there is no request - a queue consumer or a cron job has none, and an
+* attribute belongs somewhere real rather than nowhere.
+*/
+function getRequestSpan() {
+	const requestSpan = readProperty(context.active().getValue(RPC_METADATA_KEY), "span");
+	return isFunction(readProperty(requestSpan, "spanContext")) ? requestSpan : trace.getActiveSpan();
+}
+/**
+* The ambient {@link ctx}, aimed at the **request** span rather than at
+* whatever span the calling code happens to be inside.
+*
+* Framework instrumentation nests spans per layer - express opens one per
+* middleware and per route handler - so `ctx.setAttribute()` from a shared
+* middleware records on a span that ends the moment `next()` fires. Attributes
+* that describe the request as a whole (the authenticated user, the tenant, the
+* plan) belong on the request span, which is what a backend shows as the
+* resource and what a canonical log line is built from.
+*
+* Falls back to the active span outside a request, and no-ops when nothing is
+* active at all, exactly as `ctx` does.
+*
+* @example
+* ```typescript
+* app.use((req, _res, next) => {
+*   requestCtx.setAttributes({ user: req.user });  // user.id, user.plan, ...
+*   next();
+* });
+* ```
+*/
+const requestCtx = createCtxProxy(() => {
+	const span = getRequestSpan();
+	return span ? createTraceContext(span) : null;
 });
 function traceImpl(fnOrNameOrOptions, maybeFn) {
 	if (typeof fnOrNameOrOptions === "function") return wrapPlainWithTracing(fnOrNameOrOptions, {});
@@ -838,4 +923,4 @@ function withBaggage(options) {
 }
 
 //#endregion
-export { trace$1 as a, withTracing as c, span as i, getActiveTraceContext as n, withBaggage as o, instrument as r, withNewContext as s, ctx as t };
+export { span as a, withNewContext as c, requestCtx as i, withTracing as l, getActiveTraceContext as n, trace$1 as o, instrument as r, withBaggage as s, ctx as t };

package/dist/{functional-uOagkiCk.cjs → functional-UIJ0CaTV.cjs}

@@ -2,7 +2,7 @@ const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
 const require_values = require('./values-tm4bi0FF.cjs');
 const require_tracer_provider = require('./tracer-provider.cjs');
 const require_config = require('./config.cjs');
-const require_init = require('./init-zGVUHByM.cjs');
+const require_init = require('./init-BYXDCfRL.cjs');
 const require_evidence = require('./evidence.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
@@ -349,7 +349,7 @@ function runWithTraceContextStorage(fn) {
 /** Used when neither the wrapper nor `init()` chose a sampler. */
 const FALLBACK_SAMPLER = new require_init.AlwaysSampler();
 function wrapWithTracingSync(fnFactory, options, variableName) {
-	const { tracer, meter } = require_config.getConfig();
+	const { meter } = require_config.getConfig();
 	const resolveSampler = () => options.sampler ?? require_init.getConfiguredSampler() ?? FALLBACK_SAMPLER;
 	const spanName = getSpanName(options, fnFactory, variableName);
 	const callCounter = options.withMetrics ? meter.createCounter(`${spanName}.calls`, {
@@ -379,6 +379,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 		const spanOptions = {};
 		if (options.startNewRoot) spanOptions.root = true;
 		if (options.spanKind !== void 0) spanOptions.kind = options.spanKind;
+		const { tracer } = require_config.getConfig();
 		return tracer.startActiveSpan(spanName, spanOptions, require_init.getActiveContextWithBaggage(), (span) => require_init.runInOperationContext(spanName, () => runWithTraceContextStorage(() => {
 			let shouldKeepSpan = true;
 			require_trace_helpers.setSpanName(span, spanName);
@@ -582,27 +583,111 @@ function getActiveTraceContext() {
 * ```
 */
 const ctxProxyTarget = {};
-const ctx = new Proxy(ctxProxyTarget, {
-	get(_target, prop) {
-		const ctxValue = getCtxValue();
-		if (!ctxValue) return;
-		return ctxValue[prop];
-	},
-	has(_target, prop) {
-		const ctxValue = getCtxValue();
-		if (!ctxValue) return false;
-		return prop in ctxValue;
-	},
-	ownKeys() {
-		const ctxValue = getCtxValue();
-		if (!ctxValue) return [];
-		return Object.keys(ctxValue);
-	},
-	getOwnPropertyDescriptor(_target, prop) {
-		const ctxValue = getCtxValue();
-		if (!ctxValue) return;
-		return Object.getOwnPropertyDescriptor(ctxValue, prop);
-	}
+/**
+* What the methods do when no span is active - which is what a real
+* `NonRecordingSpan` does too, and the reason instrumentation can never be the
+* thing that throws: the same `ctx.setAttribute()` call runs under `vitest` and
+* under a plain `node server.js`, where nothing preloaded the SDK.
+*
+* Only these names get a callable fallback. A blanket no-op would answer `then`
+* as well, which would turn `ctx` into a thenable that never resolves.
+* `functional.test.ts` asserts this list against a live context, so a new
+* member cannot quietly go missing from it.
+*/
+const noop = () => {};
+const INACTIVE_CTX_METHODS = {
+	setAttribute: noop,
+	setAttributes: noop,
+	setStatus: noop,
+	recordException: noop,
+	addEvent: noop,
+	addLink: noop,
+	addLinks: noop,
+	updateName: noop,
+	recordError: noop,
+	track: noop,
+	isRecording: () => false,
+	getBaggage: () => void 0,
+	setBaggage: (_key, value) => value,
+	deleteBaggage: noop,
+	getAllBaggage: () => /* @__PURE__ */ new Map(),
+	getTypedBaggage: () => void 0,
+	setTypedBaggage: noop
+};
+/** A `ctx`-shaped view of whatever context `resolve` finds at access time. */
+function createCtxProxy(resolve) {
+	return new Proxy(ctxProxyTarget, {
+		get(_target, prop) {
+			const ctxValue = resolve();
+			if (!ctxValue) return typeof prop === "string" ? INACTIVE_CTX_METHODS[prop] : void 0;
+			return ctxValue[prop];
+		},
+		has(_target, prop) {
+			const ctxValue = resolve();
+			if (!ctxValue) return typeof prop === "string" && prop in INACTIVE_CTX_METHODS;
+			return prop in ctxValue;
+		},
+		ownKeys() {
+			const ctxValue = resolve();
+			return Object.keys(ctxValue ?? INACTIVE_CTX_METHODS);
+		},
+		getOwnPropertyDescriptor(_target, prop) {
+			const ctxValue = resolve();
+			if (!ctxValue) {
+				const fallback = typeof prop === "string" ? INACTIVE_CTX_METHODS[prop] : void 0;
+				return fallback === void 0 ? void 0 : {
+					value: fallback,
+					writable: false,
+					enumerable: true,
+					configurable: true
+				};
+			}
+			return Object.getOwnPropertyDescriptor(ctxValue, prop);
+		}
+	});
+}
+const ctx = createCtxProxy(getCtxValue);
+/**
+* The key `@opentelemetry/core` publishes RPC metadata under. `createContextKey`
+* is `Symbol.for`, so this reads exactly what `instrumentation-http` (and every
+* framework instrumentation that renames the route) wrote, without taking a
+* dependency on core.
+*/
+const RPC_METADATA_KEY = (0, _opentelemetry_api.createContextKey)("OpenTelemetry SDK Context Key RPC_METADATA");
+/**
+* The span the current request is being recorded on, or the active span when
+* there is no request - a queue consumer or a cron job has none, and an
+* attribute belongs somewhere real rather than nowhere.
+*/
+function getRequestSpan() {
+	const requestSpan = require_values.readProperty(_opentelemetry_api.context.active().getValue(RPC_METADATA_KEY), "span");
+	return require_values.isFunction(require_values.readProperty(requestSpan, "spanContext")) ? requestSpan : _opentelemetry_api.trace.getActiveSpan();
+}
+/**
+* The ambient {@link ctx}, aimed at the **request** span rather than at
+* whatever span the calling code happens to be inside.
+*
+* Framework instrumentation nests spans per layer - express opens one per
+* middleware and per route handler - so `ctx.setAttribute()` from a shared
+* middleware records on a span that ends the moment `next()` fires. Attributes
+* that describe the request as a whole (the authenticated user, the tenant, the
+* plan) belong on the request span, which is what a backend shows as the
+* resource and what a canonical log line is built from.
+*
+* Falls back to the active span outside a request, and no-ops when nothing is
+* active at all, exactly as `ctx` does.
+*
+* @example
+* ```typescript
+* app.use((req, _res, next) => {
+*   requestCtx.setAttributes({ user: req.user });  // user.id, user.plan, ...
+*   next();
+* });
+* ```
+*/
+const requestCtx = createCtxProxy(() => {
+	const span = getRequestSpan();
+	return span ? require_init.createTraceContext(span) : null;
 });
 function traceImpl(fnOrNameOrOptions, maybeFn) {
 	if (typeof fnOrNameOrOptions === "function") return wrapPlainWithTracing(fnOrNameOrOptions, {});
@@ -859,6 +944,12 @@ Object.defineProperty(exports, 'instrument', {
     return instrument;
   }
 });
+Object.defineProperty(exports, 'requestCtx', {
+  enumerable: true,
+  get: function () {
+    return requestCtx;
+  }
+});
 Object.defineProperty(exports, 'span', {
   enumerable: true,
   get: function () {

package/dist/functional.cjs

@@ -1,9 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_functional = require('./functional-uOagkiCk.cjs');
+const require_functional = require('./functional-UIJ0CaTV.cjs');
 
 exports.ctx = require_functional.ctx;
 exports.getActiveTraceContext = require_functional.getActiveTraceContext;
 exports.instrument = require_functional.instrument;
+exports.requestCtx = require_functional.requestCtx;
 exports.span = require_functional.span;
 exports.trace = require_functional.trace;
 exports.withBaggage = require_functional.withBaggage;

package/dist/functional.d.cts

@@ -1,3 +1,3 @@
-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-CgWcRXGX.cjs";
-export { type InstrumentOptions, type SingleInstrumentOptions, SpanOptions, type TraceContext, type TracingOptions, WithBaggageOptions, WithNewContextOptions, ctx, getActiveTraceContext, instrument, span, trace, withBaggage, withNewContext, withTracing };
+import { n as TraceContext } from "./trace-context-f7Xq0Q2q.cjs";
+import { a as getActiveTraceContext, c as span, d as withNewContext, f as withTracing, h as TracingOptions, i as ctx, l as trace, m as SingleInstrumentOptions, n as WithBaggageOptions, o as instrument, p as InstrumentOptions, r as WithNewContextOptions, s as requestCtx, t as SpanOptions, u as withBaggage } from "./functional-C4mjgtJb.cjs";
+export { type InstrumentOptions, type SingleInstrumentOptions, SpanOptions, type TraceContext, type TracingOptions, WithBaggageOptions, WithNewContextOptions, ctx, getActiveTraceContext, instrument, requestCtx, span, trace, withBaggage, withNewContext, withTracing };

package/dist/functional.d.ts

@@ -1,3 +1,3 @@
-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-RFFpQzAV.js";
-export { type InstrumentOptions, type SingleInstrumentOptions, SpanOptions, type TraceContext, type TracingOptions, WithBaggageOptions, WithNewContextOptions, ctx, getActiveTraceContext, instrument, span, trace, withBaggage, withNewContext, withTracing };
+import { n as TraceContext } from "./trace-context-CqCblIQE.js";
+import { a as getActiveTraceContext, c as span, d as withNewContext, f as withTracing, h as TracingOptions, i as ctx, l as trace, m as SingleInstrumentOptions, n as WithBaggageOptions, o as instrument, p as InstrumentOptions, r as WithNewContextOptions, s as requestCtx, t as SpanOptions, u as withBaggage } from "./functional-DN_ztd9C.js";
+export { type InstrumentOptions, type SingleInstrumentOptions, SpanOptions, type TraceContext, type TracingOptions, WithBaggageOptions, WithNewContextOptions, ctx, getActiveTraceContext, instrument, requestCtx, 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-DzIFi7ml.js";
+import { a as span, c as withNewContext, i as requestCtx, l as withTracing, n as getActiveTraceContext, o as trace, r as instrument, s as withBaggage, t as ctx } from "./functional-S9IJNlBn.js";
 
-export { ctx, getActiveTraceContext, instrument, span, trace, withBaggage, withNewContext, withTracing };
+export { ctx, getActiveTraceContext, instrument, requestCtx, span, trace, withBaggage, withNewContext, withTracing };

package/dist/http.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_values = require('./values-tm4bi0FF.cjs');
 const require_config = require('./config.cjs');
-const require_init = require('./init-zGVUHByM.cjs');
+const require_init = require('./init-BYXDCfRL.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 
 //#region src/http.ts

package/dist/http.js

@@ -1,6 +1,6 @@
 import { _ as readProperty, h as isFunction, i as asNumber, l as asString } from "./values-xBtdXtjA.js";
 import { getConfig } from "./config.js";
-import { G as getActiveContextWithBaggage } from "./init-Dwj1goyE.js";
+import { G as getActiveContextWithBaggage } from "./init-Dyq6WtsO.js";
 import { SpanStatusCode, context, propagation } from "@opentelemetry/api";
 
 //#region src/http.ts