autotel 7.2.0 → 7.4.0

package/dist/feature-flags.js

@@ -0,0 +1,198 @@
+import { trace } from "@opentelemetry/api";
+import { logs } from "@opentelemetry/api-logs";
+
+//#region src/feature-flags.ts
+/**
+* Feature flag evaluations, in the vocabulary OpenTelemetry already defined.
+*
+* A flagged rollout splits your traffic into two populations that share a
+* service name, a route and a version. Without the flag on the span there is no
+* way to ask the only question that matters during a rollout — is the new
+* branch slower, or failing more, than the old one — and the usual workaround
+* is to read it in the flag vendor's own dashboard, where the latency and the
+* errors are not.
+*
+* The specification covers this: `feature_flag.key`, `.result.value`,
+* `.result.variant`, `.result.reason`, `.provider.name`, `.context.id`, plus a
+* `feature_flag.evaluation` event. Emitting those means any backend can split
+* any metric by variant, with no vendor in the path.
+*
+* ## Attributes and events both
+*
+* Span attributes hold one flag: a second call overwrites the first. A request
+* that branched on three flags needs one event each, which is what the
+* `feature_flag.evaluation` event is for. Both are recorded — attributes so a
+* single-flag span is filterable without unpacking events, events so a
+* many-flag span keeps them all.
+*
+* ## Record what you branched on
+*
+* Record a flag where the code *reads* it, not where it is fetched. A flag
+* evaluated and ignored explains nothing; the value the request actually took a
+* branch on is the one that explains its behaviour.
+*/
+/** Canonical `feature_flag.*` attribute keys. */
+const FEATURE_FLAG = {
+	KEY: "feature_flag.key",
+	RESULT_VALUE: "feature_flag.result.value",
+	RESULT_VARIANT: "feature_flag.result.variant",
+	RESULT_REASON: "feature_flag.result.reason",
+	PROVIDER_NAME: "feature_flag.provider.name",
+	CONTEXT_ID: "feature_flag.context.id",
+	SET_ID: "feature_flag.set.id",
+	VERSION: "feature_flag.version",
+	/**
+	* Why an evaluation failed. `feature_flag.evaluation.error.message` is the
+	* deprecated spelling of this and is deliberately not emitted — writing both
+	* would double the cardinality to no benefit.
+	*/
+	ERROR_MESSAGE: "feature_flag.error.message"
+};
+/** Canonical event name for one evaluation. */
+const FEATURE_FLAG_EVALUATION_EVENT = "feature_flag.evaluation";
+/**
+* Canonical `feature_flag.result.reason` values. The registry defines them in
+* lower snake case; OpenFeature and most SDKs report them upper-cased, and
+* forwarding that splits every group-by into two buckets meaning the same
+* thing.
+*/
+const FEATURE_FLAG_REASON = [
+	"static",
+	"default",
+	"targeting_match",
+	"split",
+	"cached",
+	"disabled",
+	"unknown",
+	"stale",
+	"error"
+];
+/**
+* A flag value as an attribute.
+*
+* Booleans and numbers are kept as they are: `feature_flag.result.value`
+* permits typed values, and stringifying `true` makes a boolean flag
+* uncomparable with the numeric one next to it. Only a structured value — which
+* no attribute type can hold — is serialised.
+*/
+function asAttributeValue(value) {
+	if (typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value)) return value;
+	try {
+		return JSON.stringify(value) ?? String(value);
+	} catch {
+		return String(value);
+	}
+}
+/** Canonical attributes for one evaluation. Absent fields are omitted. */
+function featureFlagAttributes(evaluation) {
+	const attributes = {
+		[FEATURE_FLAG.KEY]: evaluation.key,
+		[FEATURE_FLAG.RESULT_VALUE]: asAttributeValue(evaluation.value)
+	};
+	const optional = [
+		[FEATURE_FLAG.RESULT_VARIANT, evaluation.variant],
+		[FEATURE_FLAG.RESULT_REASON, evaluation.reason === void 0 ? void 0 : evaluation.reason.toLowerCase()],
+		[FEATURE_FLAG.PROVIDER_NAME, evaluation.provider],
+		[FEATURE_FLAG.CONTEXT_ID, evaluation.contextId],
+		[FEATURE_FLAG.SET_ID, evaluation.setId],
+		[FEATURE_FLAG.VERSION, evaluation.version],
+		[FEATURE_FLAG.ERROR_MESSAGE, evaluation.errorMessage]
+	];
+	for (const [key, value] of optional) if (value !== void 0) attributes[key] = value;
+	return attributes;
+}
+/**
+* Record a flag evaluation on `sink` — as attributes and as a
+* `feature_flag.evaluation` event.
+*
+* A missing sink is a no-op: instrumentation must never be the reason a branch
+* throws, and a flag read outside any span is a legitimate thing to do.
+*/
+function recordFeatureFlag(sink, evaluation) {
+	if (!sink) return;
+	const attributes = featureFlagAttributes(evaluation);
+	sink.setAttributes(attributes);
+	sink.track?.(FEATURE_FLAG_EVALUATION_EVENT, attributes);
+}
+/**
+* Emit the evaluation as an OpenTelemetry **log record**.
+*
+* This is the Logs API model the repository emits events through. The obvious
+* shortcut — `Span.addEvent` on the active span — puts the evaluation somewhere
+* no log or event pipeline will ever look, which is exactly the failure the
+* invariant exists to prevent. `correlated-events` is not a way around it
+* either: that helper prefers `addEvent` when the target has one, so routing
+* through it lands in the same place with more indirection.
+*
+* `logs.getLogger` returns a no-op logger when no `LoggerProvider` is
+* registered, so this costs nothing in an application that exports no logs.
+*/
+function emitEvaluationRecord(attributes) {
+	logs.getLogger("autotel").emit({
+		eventName: FEATURE_FLAG_EVALUATION_EVENT,
+		attributes
+	});
+}
+function evaluationFrom(hookContext, value, extra) {
+	return {
+		key: hookContext.flagKey,
+		value,
+		provider: hookContext.providerMetadata?.name,
+		contextId: hookContext.context?.targetingKey,
+		setId: hookContext.clientMetadata?.name,
+		...extra
+	};
+}
+/**
+* An OpenFeature hook that records every evaluation under the canonical
+* `feature_flag.*` convention.
+*
+* This is the zero-config path: OpenFeature already sits between the
+* application and whichever flag vendor it uses, and it already fires on every
+* evaluation — which is exactly the moment worth recording, because it is the
+* moment the code branched.
+*
+* ```ts
+* import { OpenFeature } from '@openfeature/server-sdk';
+* import { autotelOpenFeatureHook } from 'autotel/feature-flags';
+*
+* OpenFeature.addHooks(autotelOpenFeatureHook());
+* ```
+*
+* A failed evaluation is still recorded, with the default value the code
+* actually used and `reason: 'ERROR'`. The default is what the request behaved
+* as; the failure is why.
+*/
+function autotelOpenFeatureHook(options = {}) {
+	const getSpan = options.getSpan ?? (() => trace.getActiveSpan());
+	const emitLogRecord = options.emitLogRecord ?? emitEvaluationRecord;
+	/**
+	* Attributes onto the span that branched, and the event wherever the sink
+	* says. A sink with no `track` of its own gets a log record — including when
+	* there is no span at all, because the evaluation still happened.
+	*/
+	const record = (evaluation) => {
+		const sink = getSpan();
+		const attributes = featureFlagAttributes(evaluation);
+		sink?.setAttributes(attributes);
+		if (sink?.track) sink.track(FEATURE_FLAG_EVALUATION_EVENT, attributes);
+		else emitLogRecord(attributes);
+	};
+	return {
+		after(hookContext, details) {
+			record(evaluationFrom(hookContext, details.value, {
+				variant: details.variant,
+				reason: details.reason
+			}));
+		},
+		error(hookContext, error) {
+			record(evaluationFrom(hookContext, hookContext.defaultValue, {
+				reason: "error",
+				errorMessage: error instanceof Error ? error.message : String(error)
+			}));
+		}
+	};
+}
+
+//#endregion
+export { FEATURE_FLAG, FEATURE_FLAG_EVALUATION_EVENT, FEATURE_FLAG_REASON, autotelOpenFeatureHook, featureFlagAttributes, recordFeatureFlag };

package/dist/{functional-Doi0hFm3.js → functional-C4js2vTM.js}

@@ -1,7 +1,7 @@
 import { l as asString, m as isDevelopment } from "./values-BenyvWKz.js";
 import { getForceFlushableProvider } from "./tracer-provider.js";
 import { getConfig } from "./config.js";
-import { C as AUTOTEL_SAMPLING_TAIL_EVALUATED, E as AlwaysSampler, F as debugCaptureRequested, G as getContextStorage, H as createTraceContext, K as hasExplicitSpanStatus, R as isForceKept, S as AUTOTEL_SAMPLING_RATE, W as getActiveContextWithBaggage, m as runInOperationContext, q as getEventQueue, r as getSdk, t as getConfig$1, w as AUTOTEL_SAMPLING_TAIL_KEEP } from "./init-DzAdgcFM.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-CsKK9vZO.js";
 import { evidenceAttribute } from "./evidence.js";
 import { setSpanName } from "./trace-helpers.js";
 import { SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
@@ -343,9 +343,11 @@ function runWithTraceContextStorage(fn) {
 	if (storage.getStore()) return fn();
 	return storage.run({ value: context.active() }, 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 sampler = options.sampler || new AlwaysSampler();
+	const resolveSampler = () => options.sampler ?? getConfiguredSampler() ?? FALLBACK_SAMPLER;
 	const spanName = getSpanName(options, fnFactory, variableName);
 	const callCounter = options.withMetrics ? meter.createCounter(`${spanName}.calls`, {
 		description: `Call count for ${spanName}`,
@@ -361,6 +363,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 			args,
 			metadata: {}
 		};
+		const sampler = resolveSampler();
 		const shouldSample = sampler.shouldSample(samplingContext);
 		const sampleRate = sampler.sampleRate?.(samplingContext);
 		const needsTailSampling = sampler.needsTailSampling?.() ?? false;

package/dist/{functional-C925G95W.cjs → functional-DHlD7V0x.cjs}

@@ -2,7 +2,7 @@ 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_init = require('./init-aTZKsAwy.cjs');
+const require_init = require('./init-DmM7dprX.cjs');
 const require_evidence = require('./evidence.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
@@ -346,9 +346,11 @@ function runWithTraceContextStorage(fn) {
 	if (storage.getStore()) return fn();
 	return storage.run({ value: _opentelemetry_api.context.active() }, 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 sampler = options.sampler || new require_init.AlwaysSampler();
+	const resolveSampler = () => options.sampler ?? require_init.getConfiguredSampler() ?? FALLBACK_SAMPLER;
 	const spanName = getSpanName(options, fnFactory, variableName);
 	const callCounter = options.withMetrics ? meter.createCounter(`${spanName}.calls`, {
 		description: `Call count for ${spanName}`,
@@ -364,6 +366,7 @@ function wrapWithTracingSync(fnFactory, options, variableName) {
 			args,
 			metadata: {}
 		};
+		const sampler = resolveSampler();
 		const shouldSample = sampler.shouldSample(samplingContext);
 		const sampleRate = sampler.sampleRate?.(samplingContext);
 		const needsTailSampling = sampler.needsTailSampling?.() ?? false;

package/dist/functional.cjs

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

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-Doi0hFm3.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-C4js2vTM.js";
 
 export { ctx, getActiveTraceContext, instrument, 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-DApyq53y.cjs');
 const require_config = require('./config.cjs');
-const require_init = require('./init-aTZKsAwy.cjs');
+const require_init = require('./init-DmM7dprX.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-BenyvWKz.js";
 import { getConfig } from "./config.js";
-import { W as getActiveContextWithBaggage } from "./init-DzAdgcFM.js";
+import { G as getActiveContextWithBaggage } from "./init-CsKK9vZO.js";
 import { SpanStatusCode, context, propagation } from "@opentelemetry/api";
 
 //#region src/http.ts

package/dist/index.cjs

@@ -3,13 +3,13 @@ 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_structured_error = require('./structured-error--_wXpd_C.cjs');
-const require_init = require('./init-aTZKsAwy.cjs');
+const require_init = require('./init-DmM7dprX.cjs');
 const require_filtering_span_processor = require('./filtering-span-processor.cjs');
 const require_span_name_normalizer = require('./span-name-normalizer.cjs');
 const require_attribute_redacting_processor = require('./attribute-redacting-processor.cjs');
 const require_canonical_log_line_processor = require('./canonical-log-line-processor-DolzdawH.cjs');
 const require_metric = require('./metric.cjs');
-const require_functional = require('./functional-C925G95W.cjs');
+const require_functional = require('./functional-DHlD7V0x.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
 const require_stable_hash = require('./stable-hash-C0pOegH_.cjs');
 const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');

package/dist/index.js

@@ -1,13 +1,13 @@
 import { g as nonEmptyString, i as asNumber, l as asString, r as asFunction, s as asRecord, x as toError } from "./values-BenyvWKz.js";
 import { getAutotelTracer, getAutotelTracerProvider, setAutotelTracerProvider } from "./tracer-provider.js";
 import { a as flattenToAttributes, i as structuredErrorToJSON, n as getStructuredErrorAttributes, o as toAttributeValue, r as recordStructuredError, t as createStructuredError } from "./structured-error-YIuka-FE.js";
-import { $ as getOrCreateCorrelationId, B as resolveSamplingPreset, C as AUTOTEL_SAMPLING_TAIL_EVALUATED, E as AlwaysSampler, H as createTraceContext, I as extractLinksFromBatch, J as track, M as RandomSampler, N as UserIdSampler, P as createLinkFromHeaders, T as AdaptiveSampler, U as defineBaggageSchema, V as samplingPresets, X as generateCorrelationId, Y as CORRELATION_ID_BAGGAGE_KEY, Z as getCorrelationId, a as isInitialized, c as flush, d as getEvents, et as runWithCorrelationId, f as resetEvents, i as init, j as NeverSampler, l as shutdown, m as runInOperationContext, nt as setCorrelationIdInBaggage, o as isLoggerLocked, p as getOperationContext, q as getEventQueue, s as lockLogger, tt as setCorrelationId, u as Event, v as createStringRedactor, w as AUTOTEL_SAMPLING_TAIL_KEEP, x as AUTOTEL_DEBUG_BAGGAGE_KEY, y as BaggageSpanProcessor, z as markForceKept } from "./init-DzAdgcFM.js";
+import { B as markForceKept, D as AlwaysSampler, E as AdaptiveSampler, F as createLinkFromHeaders, H as samplingPresets, J as getEventQueue, L as extractLinksFromBatch, M as NeverSampler, N as RandomSampler, P as UserIdSampler, Q as getCorrelationId, S as AUTOTEL_DEBUG_BAGGAGE_KEY, T as AUTOTEL_SAMPLING_TAIL_KEEP, U as createTraceContext, V as resolveSamplingPreset, W as defineBaggageSchema, X as CORRELATION_ID_BAGGAGE_KEY, Y as track, Z as generateCorrelationId, a as init, b as BaggageSpanProcessor, c as lockLogger, d as Event, et as getOrCreateCorrelationId, f as getEvents, h as runInOperationContext, l as flush, m as getOperationContext, nt as setCorrelationId, o as isInitialized, p as resetEvents, rt as setCorrelationIdInBaggage, s as isLoggerLocked, tt as runWithCorrelationId, u as shutdown, w as AUTOTEL_SAMPLING_TAIL_EVALUATED, y as createStringRedactor } from "./init-CsKK9vZO.js";
 import { FilteringSpanProcessor } from "./filtering-span-processor.js";
 import { NORMALIZER_PATTERNS, NORMALIZER_PRESETS, SpanNameNormalizingProcessor } from "./span-name-normalizer.js";
 import { AttributeRedactingProcessor, REDACTOR_PATTERNS, REDACTOR_PRESETS, builtinPatterns, createAttributeRedactor, createRedactedSpan, normalizeAttributeRedactorConfig } from "./attribute-redacting-processor.js";
 import { n as formatDuration } from "./canonical-log-line-processor-hFUmS__K.js";
 import { Metric, getMetrics, resetMetrics } from "./metric.js";
-import { a as trace$2, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-Doi0hFm3.js";
+import { a as trace$2, c as withTracing, i as span, n as getActiveTraceContext, o as withBaggage, r as instrument, s as withNewContext, t as ctx } from "./functional-C4js2vTM.js";
 import { createDeterministicTraceId, enrichWithTraceContext, finalizeSpan, flattenMetadata, getActiveContext, getActiveSpan, getTraceContext, getTracer, isTracing, resolveTraceUrl, runWithSpan } from "./trace-helpers.js";
 import { t as hashJson } from "./stable-hash-BkoAYVks.js";
 import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";

package/dist/{init-DzAdgcFM.js → init-CsKK9vZO.js}

@@ -782,6 +782,7 @@ function validateEvent(eventName, attributes, config) {
 * Simple, no instantiation needed, auto-attaches trace context
 */
 let eventsQueue = null;
+let warnedNoSubscribers = false;
 /**
 * Build autotel event context for trace correlation
 *
@@ -838,7 +839,13 @@ function getOrCreateQueue() {
 	}
 	if (!eventsQueue) {
 		const config = getConfig();
-		if (!config?.subscribers || config.subscribers.length === 0) return null;
+		if (!config?.subscribers || config.subscribers.length === 0) {
+			if (!warnedNoSubscribers) {
+				warnedNoSubscribers = true;
+				getLogger().warn({}, "[autotel] track() dropped an event: init() configured no subscribers. Events (including gen_ai.evaluation.result and audit events) reach a backend through init({ subscribers: [...] }).");
+			}
+			return null;
+		}
 		eventsQueue = new EventQueue(config.subscribers);
 	}
 	return eventsQueue;
@@ -910,6 +917,7 @@ function getEventQueue() {
 */
 function resetEventQueue() {
 	eventsQueue = null;
+	warnedNoSubscribers = false;
 }
 
 //#endregion
@@ -4212,6 +4220,18 @@ function warnIfNotInitialized(context) {
 	}
 }
 /**
+* The sampler `init()` was configured with, or undefined when it was not.
+*
+* Separate from {@link getDefaultSampler} on purpose: the tracing wrapper needs
+* to know whether a sampler was *chosen*. Falling back to the production preset
+* there would start dropping spans for every app that never asked to sample.
+*
+* @internal
+*/
+function getConfiguredSampler() {
+	return config?.sampler;
+}
+/**
 * @internal Close embedded devtools if running.
 */
 async function _closeEmbeddedDevtools() {
@@ -4228,4 +4248,4 @@ function getSdk() {
 }
 
 //#endregion
-export { getOrCreateCorrelationId as $, KeyTargetRateSampler as A, resolveSamplingPreset as B, AUTOTEL_SAMPLING_TAIL_EVALUATED as C, CompositeSampler as D, AlwaysSampler as E, debugCaptureRequested as F, getContextStorage as G, createTraceContext as H, extractLinksFromBatch as I, track as J, hasExplicitSpanStatus as K, hashUnitInterval as L, RandomSampler as M, UserIdSampler as N, DeterministicSampler as O, createLinkFromHeaders as P, getCorrelationStorage as Q, isForceKept as R, AUTOTEL_SAMPLING_RATE as S, AdaptiveSampler as T, defineBaggageSchema as U, samplingPresets as V, getActiveContextWithBaggage as W, generateCorrelationId as X, CORRELATION_ID_BAGGAGE_KEY as Y, getCorrelationId as Z, loadYamlConfigFromFile as _, isInitialized as a, TailSamplingSpanProcessor as b, flush as c, getEvents as d, runWithCorrelationId as et, resetEvents as f, loadYamlConfig as g, hasYamlConfig as h, init as i, NeverSampler as j, FeatureFlagSampler as k, shutdown as l, runInOperationContext as m, getLogger as n, setCorrelationIdInBaggage as nt, isLoggerLocked as o, getOperationContext as p, getEventQueue as q, getSdk as r, lockLogger as s, getConfig as t, setCorrelationId as tt, Event as u, createStringRedactor as v, AUTOTEL_SAMPLING_TAIL_KEEP as w, AUTOTEL_DEBUG_BAGGAGE_KEY as x, BaggageSpanProcessor as y, markForceKept as z };
+export { getCorrelationStorage as $, FeatureFlagSampler as A, markForceKept as B, AUTOTEL_SAMPLING_RATE as C, AlwaysSampler as D, AdaptiveSampler as E, createLinkFromHeaders as F, getActiveContextWithBaggage as G, samplingPresets as H, debugCaptureRequested as I, getEventQueue as J, getContextStorage as K, extractLinksFromBatch as L, NeverSampler as M, RandomSampler as N, CompositeSampler as O, UserIdSampler as P, getCorrelationId as Q, hashUnitInterval as R, AUTOTEL_DEBUG_BAGGAGE_KEY as S, AUTOTEL_SAMPLING_TAIL_KEEP as T, createTraceContext as U, resolveSamplingPreset as V, defineBaggageSchema as W, CORRELATION_ID_BAGGAGE_KEY as X, track as Y, generateCorrelationId as Z, loadYamlConfig as _, init as a, BaggageSpanProcessor as b, lockLogger as c, Event as d, getOrCreateCorrelationId as et, getEvents as f, hasYamlConfig as g, runInOperationContext as h, getSdk as i, KeyTargetRateSampler as j, DeterministicSampler as k, flush as l, getOperationContext as m, getConfiguredSampler as n, setCorrelationId as nt, isInitialized as o, resetEvents as p, hasExplicitSpanStatus as q, getLogger as r, setCorrelationIdInBaggage as rt, isLoggerLocked as s, getConfig as t, runWithCorrelationId as tt, shutdown as u, loadYamlConfigFromFile as v, AUTOTEL_SAMPLING_TAIL_EVALUATED as w, TailSamplingSpanProcessor as x, createStringRedactor as y, isForceKept as z };

package/dist/{init-aTZKsAwy.cjs → init-DmM7dprX.cjs}

@@ -786,6 +786,7 @@ function validateEvent(eventName, attributes, config) {
 * Simple, no instantiation needed, auto-attaches trace context
 */
 let eventsQueue = null;
+let warnedNoSubscribers = false;
 /**
 * Build autotel event context for trace correlation
 *
@@ -842,7 +843,13 @@ function getOrCreateQueue() {
 	}
 	if (!eventsQueue) {
 		const config = getConfig();
-		if (!config?.subscribers || config.subscribers.length === 0) return null;
+		if (!config?.subscribers || config.subscribers.length === 0) {
+			if (!warnedNoSubscribers) {
+				warnedNoSubscribers = true;
+				getLogger().warn({}, "[autotel] track() dropped an event: init() configured no subscribers. Events (including gen_ai.evaluation.result and audit events) reach a backend through init({ subscribers: [...] }).");
+			}
+			return null;
+		}
 		eventsQueue = new EventQueue(config.subscribers);
 	}
 	return eventsQueue;
@@ -914,6 +921,7 @@ function getEventQueue() {
 */
 function resetEventQueue() {
 	eventsQueue = null;
+	warnedNoSubscribers = false;
 }
 
 //#endregion
@@ -4216,6 +4224,18 @@ function warnIfNotInitialized(context) {
 	}
 }
 /**
+* The sampler `init()` was configured with, or undefined when it was not.
+*
+* Separate from {@link getDefaultSampler} on purpose: the tracing wrapper needs
+* to know whether a sampler was *chosen*. Falling back to the production preset
+* there would start dropping spans for every app that never asked to sample.
+*
+* @internal
+*/
+function getConfiguredSampler() {
+	return config?.sampler;
+}
+/**
 * @internal Close embedded devtools if running.
 */
 async function _closeEmbeddedDevtools() {
@@ -4394,6 +4414,12 @@ Object.defineProperty(exports, 'getConfig', {
     return getConfig;
   }
 });
+Object.defineProperty(exports, 'getConfiguredSampler', {
+  enumerable: true,
+  get: function () {
+    return getConfiguredSampler;
+  }
+});
 Object.defineProperty(exports, 'getContextStorage', {
   enumerable: true,
   get: function () {

package/dist/instrumentation.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_init = require('./init-aTZKsAwy.cjs');
+const require_init = require('./init-DmM7dprX.cjs');
 const require_node_require = require('./node-require-EifOMikz.cjs');
 let _opentelemetry_sdk_node = require("@opentelemetry/sdk-node");
 let _opentelemetry_sdk_trace_base = require("@opentelemetry/sdk-trace-base");

package/dist/instrumentation.js

@@ -1,4 +1,4 @@
-import { b as TailSamplingSpanProcessor, n as getLogger } from "./init-DzAdgcFM.js";
+import { r as getLogger, x as TailSamplingSpanProcessor } from "./init-CsKK9vZO.js";
 import { n as safeRequire, t as requireModule } from "./node-require-DSPjaw_l.js";
 import { NodeSDK } from "@opentelemetry/sdk-node";
 import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";

package/dist/messaging.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_values = require('./values-DApyq53y.cjs');
-const require_init = require('./init-aTZKsAwy.cjs');
-const require_functional = require('./functional-C925G95W.cjs');
+const require_init = require('./init-DmM7dprX.cjs');
+const require_functional = require('./functional-DHlD7V0x.cjs');
 const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');
 const require_trace_factory_validation = require('./trace-factory-validation-Dc8epn87.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");

package/dist/messaging.js

@@ -1,6 +1,6 @@
 import { _ as readProperty, b as toAttributeValue, c as asScalar, g as nonEmptyString, h as isFunction, s as asRecord, v as resolveValue, y as splitNameOrOptions } from "./values-BenyvWKz.js";
-import { I as extractLinksFromBatch, P as createLinkFromHeaders } from "./init-DzAdgcFM.js";
-import { c as withTracing } from "./functional-Doi0hFm3.js";
+import { F as createLinkFromHeaders, L as extractLinksFromBatch } from "./init-CsKK9vZO.js";
+import { c as withTracing } from "./functional-C4js2vTM.js";
 import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";
 import { t as assertTraceFactory } from "./trace-factory-validation-BjVAinz6.js";
 import { SpanKind, context, propagation } from "@opentelemetry/api";

package/dist/sampling.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_init = require('./init-aTZKsAwy.cjs');
+const require_init = require('./init-DmM7dprX.cjs');
 
 exports.AUTOTEL_DEBUG_BAGGAGE_KEY = require_init.AUTOTEL_DEBUG_BAGGAGE_KEY;
 exports.AUTOTEL_SAMPLING_RATE = require_init.AUTOTEL_SAMPLING_RATE;

package/dist/sampling.js

@@ -1,3 +1,3 @@
-import { A as KeyTargetRateSampler, B as resolveSamplingPreset, C as AUTOTEL_SAMPLING_TAIL_EVALUATED, D as CompositeSampler, E as AlwaysSampler, F as debugCaptureRequested, I as extractLinksFromBatch, L as hashUnitInterval, M as RandomSampler, N as UserIdSampler, O as DeterministicSampler, P as createLinkFromHeaders, R as isForceKept, S as AUTOTEL_SAMPLING_RATE, T as AdaptiveSampler, V as samplingPresets, j as NeverSampler, k as FeatureFlagSampler, w as AUTOTEL_SAMPLING_TAIL_KEEP, x as AUTOTEL_DEBUG_BAGGAGE_KEY, z as markForceKept } from "./init-DzAdgcFM.js";
+import { A as FeatureFlagSampler, B as markForceKept, C as AUTOTEL_SAMPLING_RATE, D as AlwaysSampler, E as AdaptiveSampler, F as createLinkFromHeaders, H as samplingPresets, I as debugCaptureRequested, L as extractLinksFromBatch, M as NeverSampler, N as RandomSampler, O as CompositeSampler, P as UserIdSampler, R as hashUnitInterval, S as AUTOTEL_DEBUG_BAGGAGE_KEY, T as AUTOTEL_SAMPLING_TAIL_KEEP, V as resolveSamplingPreset, j as KeyTargetRateSampler, k as DeterministicSampler, w as AUTOTEL_SAMPLING_TAIL_EVALUATED, z as isForceKept } from "./init-CsKK9vZO.js";
 
 export { AUTOTEL_DEBUG_BAGGAGE_KEY, AUTOTEL_SAMPLING_RATE, AUTOTEL_SAMPLING_TAIL_EVALUATED, AUTOTEL_SAMPLING_TAIL_KEEP, AdaptiveSampler, AlwaysSampler, CompositeSampler, DeterministicSampler, FeatureFlagSampler, KeyTargetRateSampler, NeverSampler, RandomSampler, UserIdSampler, createLinkFromHeaders, debugCaptureRequested, extractLinksFromBatch, hashUnitInterval, isForceKept, markForceKept, resolveSamplingPreset, samplingPresets };

package/dist/semantic-helpers.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_values = require('./values-DApyq53y.cjs');
-const require_functional = require('./functional-C925G95W.cjs');
+const require_functional = require('./functional-DHlD7V0x.cjs');
 const require_trace_factory_validation = require('./trace-factory-validation-Dc8epn87.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 

package/dist/semantic-helpers.js

@@ -1,5 +1,5 @@
 import { b as toAttributeValue, g as nonEmptyString, s as asRecord } from "./values-BenyvWKz.js";
-import { c as withTracing } from "./functional-Doi0hFm3.js";
+import { c as withTracing } from "./functional-C4js2vTM.js";
 import { t as assertTraceFactory } from "./trace-factory-validation-BjVAinz6.js";
 import { SpanKind } from "@opentelemetry/api";
 

package/dist/tail-sampling-processor.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_init = require('./init-aTZKsAwy.cjs');
+const require_init = require('./init-DmM7dprX.cjs');
 
 exports.TailSamplingSpanProcessor = require_init.TailSamplingSpanProcessor;

package/dist/tail-sampling-processor.js

@@ -1,3 +1,3 @@
-import { b as TailSamplingSpanProcessor } from "./init-DzAdgcFM.js";
+import { x as TailSamplingSpanProcessor } from "./init-CsKK9vZO.js";
 
 export { TailSamplingSpanProcessor };

package/dist/testing.cjs

@@ -8,6 +8,37 @@ let _opentelemetry_api = require("@opentelemetry/api");
 let node_async_hooks = require("node:async_hooks");
 node_async_hooks = require_rolldown_runtime.__toESM(node_async_hooks, 1);
 
+//#region src/memory-exporter.ts
+function toRecordedSpan(span) {
+	return {
+		name: span.name,
+		traceId: span.spanContext().traceId,
+		spanId: span.spanContext().spanId,
+		parentSpanId: span.parentSpanContext?.spanId,
+		durationMs: span.duration[0] * 1e3 + span.duration[1] / 1e6,
+		attributes: { ...span.attributes },
+		status: span.status
+	};
+}
+function createMemoryExporter() {
+	const collected = [];
+	return {
+		export(spans, resultCallback) {
+			for (const span of spans) collected.push(toRecordedSpan(span));
+			resultCallback({ code: 0 });
+		},
+		async shutdown() {},
+		async forceFlush() {},
+		spans: () => [...collected],
+		findSpan: (name) => collected.find((span) => span.name === name),
+		findSpans: (name) => collected.filter((span) => span.name === name),
+		reset: () => {
+			collected.length = 0;
+		}
+	};
+}
+
+//#endregion
 //#region src/testing.ts
 /**
 * Testing Utilities
@@ -479,6 +510,7 @@ exports.assertTraceDuration = assertTraceDuration;
 exports.assertTraceFailed = assertTraceFailed;
 exports.assertTraceSucceeded = assertTraceSucceeded;
 exports.createEventCollector = require_event_testing.createEventCollector;
+exports.createMemoryExporter = createMemoryExporter;
 exports.createMockLogger = createMockLogger;
 exports.createTraceCollector = createTraceCollector;
 exports.getTraceDuration = getTraceDuration;

package/dist/testing.d.cts

@@ -2,7 +2,32 @@ import { t as UnknownRecord } from "./values-CeMH-mYG.cjs";
 import { s as Logger } from "./logger-S1Fgl0g3.cjs";
 import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-CBtnJXE5.cjs";
 import { SerializedSpan, TestSpanCollector, serializeSpan } from "./test-span-collector.cjs";
+import { SpanExporter } from "@opentelemetry/sdk-trace-base";
 import { Attributes, Link, SpanKind, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
+//#region src/memory-exporter.d.ts
+/** One finished span, flattened to the fields an assertion usually wants. */
+interface RecordedSpan {
+  name: string;
+  traceId: string;
+  spanId: string;
+  parentSpanId: string | undefined;
+  /** Wall-clock duration of the span, in milliseconds. */
+  durationMs: number;
+  attributes: Attributes;
+  status: SpanStatus;
+}
+interface MemoryExporter extends SpanExporter {
+  /** Every span exported so far, in the order it finished. */
+  spans(): RecordedSpan[];
+  /** The first span with this name, or undefined. */
+  findSpan(name: string): RecordedSpan | undefined;
+  /** Every span with this name. */
+  findSpans(name: string): RecordedSpan[];
+  /** Discard what has been collected. */
+  reset(): void;
+}
+declare function createMemoryExporter(): MemoryExporter;
+//#endregion
 //#region src/testing.d.ts
 /**
  * Note: OpenTelemetry exporters and processors have moved to dedicated modules
@@ -290,4 +315,4 @@ declare function getTraceDuration(collector: TraceCollector, operationName: stri
  */
 declare function assertTraceDuration(collector: TraceCollector, operationName: string, maxDurationMs: number): void;
 //#endregion
-export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, type SerializedSpan, SpanMatch, TestSpan, TestSpanCollector, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };
+export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, type MemoryExporter, type RecordedSpan, type SerializedSpan, SpanMatch, TestSpan, TestSpanCollector, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMemoryExporter, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };