autotel 7.10.1 → 8.1.0

package/dist/{init-BvUtwZNx.js → init-D4TpmUIg.js}

@@ -1,15 +1,15 @@
-import { _ as readProperty, d as asStringRecord, f as describeValue, h as isFunction, i as asNumber, l as asString, r as asFunction, s as asRecord, t as asBoolean } from "./values-xBtdXtjA.js";
+import { d as asStringRecord, f as describeValue, g as isFunction, i as asNumber, l as asString, r as asFunction, s as asRecord, t as asBoolean, v as readProperty } from "./values-Dm0yEC5p.js";
 import { getForceFlushableProvider } from "./tracer-provider.js";
 import { getConfig as getConfig$1 } from "./config.js";
-import { a as flattenToAttributes, o as toAttributeValue, r as recordStructuredError } from "./structured-error-Y9y-1Pae.js";
-import { n as safeRequire, t as requireModule } from "./node-require-CkK_xzL-.js";
+import { a as flattenToAttributes, o as toAttributeValue, r as recordStructuredError } from "./structured-error-UEtlg9Uu.js";
+import { n as safeRequire, t as requireModule } from "./node-require-CY0YUdvZ.js";
 import { FilteringSpanProcessor } from "./filtering-span-processor.js";
 import { PolicyLogRecordProcessor, policySpanFilter, setPolicies, watchPolicyFile } from "./policy.js";
 import { SpanNameNormalizingProcessor } from "./span-name-normalizer.js";
 import { AttributeRedactingProcessor, REDACTOR_PRESETS, normalizeAttributeRedactorConfig } from "./attribute-redacting-processor.js";
 import { t as PrettyConsoleExporter } from "./pretty-console-exporter-DqKl_q9z.js";
-import { t as CanonicalLogLineProcessor } from "./canonical-log-line-processor-BQ6NeZAk.js";
-import { n as subscribeChannel } from "./channel-BobQKsZd.js";
+import { t as CanonicalLogLineProcessor } from "./canonical-log-line-processor-naZRETyk.js";
+import { n as subscribeChannel } from "./channel-BNFp4Sfq.js";
 import { resetMetrics } from "./metric.js";
 import { DiagConsoleLogger, DiagLogLevel, TraceFlags, context, createContextKey, diag, metrics, propagation, trace } from "@opentelemetry/api";
 import { logs } from "@opentelemetry/api-logs";
@@ -1959,15 +1959,15 @@ const silentLogger = {
 function wrapLogger(base, silent, minLevel) {
 	if (silent) return silentLogger;
 	const threshold = LOG_LEVELS[minLevel];
-	const wrap = (fn, level) => {
+	const wrap = (level) => {
 		if (LOG_LEVELS[level] < threshold) return (() => {});
-		return ((...args) => fn(...args));
+		return ((...args) => base[level](...args));
 	};
 	return {
-		debug: wrap(base.debug, "debug"),
-		info: wrap(base.info, "info"),
-		warn: wrap(base.warn, "warn"),
-		error: wrap(base.error, "error")
+		debug: wrap("debug"),
+		info: wrap("info"),
+		warn: wrap("warn"),
+		error: wrap("error")
 	};
 }
 
@@ -2168,6 +2168,47 @@ var RequestAttributesSpanProcessor = class {
 	}
 };
 
+//#endregion
+//#region src/enriched-span-processor.ts
+/**
+* `spanEnrichers` in front of the processors that export, as one processor.
+*
+* Spans reach the enrichers first, as they would in a flat list. The
+* difference is flush and shutdown: the SDK runs those on every processor at
+* once, so an enricher that ends a span of its own while it drains (an async
+* judgment, say) would hand it to an exporter that had already closed. Here the
+* enrichers drain first and the exporters flush after them.
+*/
+var EnrichedSpanProcessor = class {
+	enrichers;
+	downstream;
+	/** Every processor in call order: the enrichers, then the rest. */
+	processors;
+	constructor(enrichers, downstream) {
+		this.enrichers = enrichers;
+		this.downstream = downstream;
+		this.processors = [...enrichers, ...downstream];
+	}
+	onStart(span, parentContext) {
+		for (const processor of this.processors) processor.onStart(span, parentContext);
+	}
+	onEnd(span) {
+		for (const processor of this.processors) processor.onEnd(span);
+	}
+	forceFlush() {
+		return this.drainThenRun((p) => p.forceFlush());
+	}
+	shutdown() {
+		return this.drainThenRun((p) => p.shutdown());
+	}
+	async drainThenRun(run) {
+		const drained = await Promise.allSettled(this.enrichers.map(async (p) => run(p)));
+		await Promise.all(this.downstream.map(run));
+		const failed = drained.find((r) => r.status === "rejected");
+		if (failed) throw failed.reason;
+	}
+};
+
 //#endregion
 //#region src/redact-values.ts
 /** Standalone string redaction for use outside the span processor pipeline. */
@@ -4137,20 +4178,68 @@ function toPackageName(name) {
 	return name.startsWith("@opentelemetry/instrumentation-") ? name : `@opentelemetry/instrumentation-${name}`;
 }
 /**
-* Detect if we're running in ESM mode
+* Whether the app's entry runs as ESM: its extension when it has an explicit
+* one (`.mjs`/`.cjs`, and `.mts`/`.cts` under tsx), else the cwd
+* package.json's `type`.
 */
-function isESMMode() {
+function isESMMode(entry = process.argv[1] ?? "") {
+	if (/\.c[jt]s$/.test(entry)) return false;
+	if (/\.m[jt]s$/.test(entry)) return true;
 	try {
 		const fs = requireModule("node:fs");
-		try {
-			return JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, "utf8")).type === "module";
-		} catch {
-			return false;
-		}
+		return JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, "utf8")).type === "module";
 	} catch {
 		return false;
 	}
 }
+/** Set by `autotel/register` so `init()` can tell the ESM hook is in place. */
+const REGISTER_FLAG = Symbol.for("autotel.register");
+/**
+* Whether the OTel ESM loader hook is registered: by `autotel/register`, or
+* by pointing node at a `hook.mjs` directly.
+*/
+function isEsmHookLoaded(flags = `${process.execArgv.join(" ")} ${process.env.NODE_OPTIONS ?? ""}`) {
+	return globalThis[REGISTER_FLAG] === true || flags.includes("hook.mjs");
+}
+const LOGGER_PACKAGES = [
+	"pino",
+	"winston",
+	"bunyan"
+];
+function loadedModulePaths() {
+	try {
+		const { createRequire } = requireModule("node:module");
+		return Object.entries(createRequire(`${process.cwd()}/`).cache).filter(([, mod]) => mod?.loaded).map(([path]) => path);
+	} catch {
+		return [];
+	}
+}
+/**
+* Names in the array form that loaded nothing: a typo, or a library
+* auto-instrumentations-node has no instrumentation for (`fastify`, `next`).
+* Upstream only reports these through `diag`, which is silent by default.
+* Names a manual instrumentation replaced are not missing.
+*/
+function missingInstrumentations(names, loaded, manualInstrumentationNames = /* @__PURE__ */ new Set()) {
+	const loadedNames = new Set(loaded.map((i) => i.instrumentationName));
+	const replaced = new Set([...manualInstrumentationNames].map((className) => INSTRUMENTATION_CLASS_TO_PACKAGE.get(className)));
+	return names.filter((name) => {
+		const packageName = toPackageName(name);
+		return !loadedNames.has(packageName) && !replaced.has(packageName);
+	});
+}
+/**
+* Logger packages the config instruments that were already loaded when
+* `init()` ran. Instrumentations patch a package as it loads, so these never
+* get trace context: the logger module was imported before `init()`.
+*/
+function loggersLoadedBeforeInit(integrations, loadedPaths = loadedModulePaths()) {
+	if (integrations === false) return [];
+	const requested = integrations === true ? LOGGER_PACKAGES : Array.isArray(integrations) ? integrations : Object.entries(integrations).filter(([, options]) => options.enabled !== false).map(([name]) => name);
+	const wanted = new Set(requested.map((name) => toPackageName(name)));
+	const paths = loadedPaths.map((path) => path.replaceAll("\\", "/"));
+	return LOGGER_PACKAGES.filter((name) => wanted.has(toPackageName(name)) && paths.some((path) => path.includes(`/node_modules/${name}/`)));
+}
 /**
 * Lazy-load auto-instrumentations (optional peer dependency)
 * Only loads when integrations config is truthy, avoiding ~40+ package imports at startup.
@@ -4179,11 +4268,12 @@ See: https://github.com/jagreehal/autotel#esm-setup`);
 * @internal
 */
 let _autoInstrumentationsLoader = null;
+const HTTP_PACKAGE = "@opentelemetry/instrumentation-http";
 /**
 * Get auto-instrumentations based on simple integration names
 * Excludes instrumentations that are manually provided to avoid conflicts
 */
-function getAutoInstrumentations(integrations, manualInstrumentationNames = /* @__PURE__ */ new Set()) {
+function getAutoInstrumentations(integrations, manualInstrumentationNames = /* @__PURE__ */ new Set(), ignoredServerPorts = []) {
 	if (integrations === false) return [];
 	const getNodeAutoInstrumentations = _autoInstrumentationsLoader ? _autoInstrumentationsLoader() : loadNodeAutoInstrumentations();
 	const exclusionConfig = {};
@@ -4198,7 +4288,18 @@ function getAutoInstrumentations(integrations, manualInstrumentationNames = /* @
 		if (packageName in exclusionConfig) continue;
 		config[packageName] = options;
 	}
-	return getNodeAutoInstrumentations(withAutotelDefaults(config));
+	const http = config[HTTP_PACKAGE] ?? {};
+	if (ignoredServerPorts.length > 0 && http.enabled !== false) {
+		const userHook = http.ignoreIncomingRequestHook;
+		config[HTTP_PACKAGE] = {
+			...http,
+			ignoreIncomingRequestHook: (request) => ignoredServerPorts.includes(request.socket?.localPort ?? -1) || (userHook?.(request) ?? false)
+		};
+	}
+	const resolved = withAutotelDefaults(config);
+	if (!Array.isArray(integrations)) return getNodeAutoInstrumentations(resolved);
+	const listed = new Set(Object.keys(config).filter((name) => config[name]?.enabled === true));
+	return getNodeAutoInstrumentations(new Proxy(resolved, { get: (target, name) => typeof name === "string" && listed.has(name) ? target[name] : { enabled: false } }));
 }
 
 //#endregion
@@ -4363,6 +4464,10 @@ function init(cfg) {
 	const minLevel = mergedConfig.minLevel ?? "info";
 	const baseLogger = mergedConfig.logger || silentLogger;
 	logger = wrapLogger(baseLogger, silent, minLevel);
+	const setupWarn = (msg) => {
+		if (mergedConfig.logger) logger.warn({}, msg);
+		else if (!silent) console.warn(msg);
+	};
 	if (initialized) logger.warn({}, "[autotel] init() called again - last config wins. This may cause unexpected behavior.");
 	config = mergedConfig;
 	validationConfig = mergedConfig.validation || null;
@@ -4371,19 +4476,24 @@ function init(cfg) {
 	const version = mergedConfig.version || detectVersion();
 	const environment = mergedConfig.environment || process.env.NODE_ENV || "development";
 	const metricsEnabled = resolveMetricsFlag(mergedConfig.metrics);
-	const canonicalLogger = mergedConfig.canonicalLogLines?.logger ?? mergedConfig.logger;
+	const canonicalLogger = mergedConfig.canonicalLogLines?.logger;
 	const hasCanonicalLogger = Array.isArray(canonicalLogger) ? canonicalLogger.length > 0 : canonicalLogger !== void 0;
 	const canonicalUsesOtel = mergedConfig.canonicalLogLines?.enabled === true && (mergedConfig.canonicalLogLines.otel ?? !hasCanonicalLogger);
 	const logsEnabled = resolveLogsFlag(mergedConfig.logs ?? (canonicalUsesOtel ? true : "auto"));
+	let devtoolsPort;
 	if (devtoolsConfig.enabled && devtoolsConfig.embedded) {
 		const devtoolsModule = _optionalRequire("autotel-devtools");
 		if (devtoolsModule?.createDevtools) {
+			if (devtoolsConfig.port === 0) throw new Error("[autotel] devtools.embedded needs a fixed devtools.port; 0 is not supported");
 			const devtoolsInstance = devtoolsModule.createDevtools({
 				port: devtoolsConfig.port,
 				host: devtoolsConfig.host,
-				verbose: devtoolsConfig.verbose
+				verbose: devtoolsConfig.verbose,
+				maxPortTries: 1
 			});
+			devtoolsInstance.ready?.catch((error) => setupWarn(`[autotel] autotel-devtools could not start (${error instanceof Error ? error.message : String(error)}). Telemetry is still sent to ${endpoint}; free the port or set devtools.port.`));
 			_devtoolsClose = devtoolsInstance.close;
+			devtoolsPort = devtoolsInstance.port;
 			endpoint = `http://${devtoolsConfig.host}:${devtoolsInstance.port}`;
 			logger.info({}, `[autotel] autotel-devtools embedded server started at ${endpoint}`);
 		} else logger.warn({}, "[autotel] devtools.embedded requested but autotel-devtools is not installed. Falling back to endpoint-only mode.");
@@ -4455,7 +4565,7 @@ function init(cfg) {
 	}
 	if (mergedConfig.spanFilter && spanProcessors.length > 0) spanProcessors = spanProcessors.map((processor) => new FilteringSpanProcessor(processor, { filter: mergedConfig.spanFilter }));
 	if (spanProcessors.length > 0) spanProcessors.unshift(new RequestAttributesSpanProcessor());
-	if (mergedConfig.spanEnrichers && mergedConfig.spanEnrichers.length > 0) spanProcessors.unshift(...mergedConfig.spanEnrichers);
+	if (mergedConfig.spanEnrichers && mergedConfig.spanEnrichers.length > 0) spanProcessors = [new EnrichedSpanProcessor(mergedConfig.spanEnrichers, spanProcessors)];
 	const metricReaders = [];
 	if (configuredMetricReaders && configuredMetricReaders.length > 0) metricReaders.push(...configuredMetricReaders);
 	else if (metricsEnabled) for (const destination of otlpDestinations) {
@@ -4496,17 +4606,22 @@ function init(cfg) {
 	if (mergedConfig.policies && logRecordProcessors) logRecordProcessors = logRecordProcessors.map((processor) => new PolicyLogRecordProcessor(processor));
 	let finalInstrumentations = mergedConfig.instrumentations ? [...mergedConfig.instrumentations] : [];
 	if (mergedConfig.autoInstrumentations !== void 0 && mergedConfig.autoInstrumentations !== false) {
-		if (isESMMode()) logger.info({}, "[autotel] ESM mode detected. For auto-instrumentation to work:\n  1. Install @opentelemetry/auto-instrumentations-node as a direct dependency\n  2. Import autotel/register FIRST in your instrumentation file\n  3. Use getNodeAutoInstrumentations() directly instead of autoInstrumentations\n  See: https://github.com/jagreehal/autotel#esm-setup");
+		if (isESMMode() && !isEsmHookLoaded()) setupWarn("[autotel] ESM app without the OTel loader hook: packages loaded with `import` (pino, express, ...) will not be instrumented. Start node with `--import autotel/register`. See: https://github.com/jagreehal/autotel#esm-setup");
+		for (const name of loggersLoadedBeforeInit(mergedConfig.autoInstrumentations)) setupWarn(`[autotel] ${name} was loaded before init(), so its logs get no trace context. Run init() first, and don't create your ${name} logger in the module that calls it.`);
 		try {
 			const manualInstrumentationNames = getInstrumentationNames(mergedConfig.instrumentations ?? []);
 			if (manualInstrumentationNames.size > 0) {
 				const manualNames = [...manualInstrumentationNames].join(", ");
 				logger.info({}, `[autotel] Detected manual instrumentations (${manualNames}). These will take precedence over auto-instrumentations. Tip: Set autoInstrumentations:false if you want full manual control, or remove manual configs to use auto-instrumentations.`);
 			}
-			const autoInstrumentations = getAutoInstrumentations(mergedConfig.autoInstrumentations, manualInstrumentationNames);
+			const autoInstrumentations = getAutoInstrumentations(mergedConfig.autoInstrumentations, manualInstrumentationNames, devtoolsPort === void 0 ? [] : [devtoolsPort]);
+			if (Array.isArray(mergedConfig.autoInstrumentations)) {
+				const missing = missingInstrumentations(mergedConfig.autoInstrumentations, autoInstrumentations ?? [], manualInstrumentationNames);
+				if (missing.length > 0) setupWarn(`[autotel] autoInstrumentations: no instrumentation loaded for ${missing.join(", ")}. Check the spelling; @opentelemetry/auto-instrumentations-node has none for some libraries (fastify, next).`);
+			}
 			if (autoInstrumentations && autoInstrumentations.length > 0) finalInstrumentations = [...finalInstrumentations, ...autoInstrumentations];
 		} catch (error) {
-			logger.warn({}, `[autotel] Failed to configure auto-instrumentations: ${error instanceof Error ? error.message : String(error)}`);
+			setupWarn(`[autotel] Failed to configure auto-instrumentations: ${error instanceof Error ? error.message : String(error)}`);
 		}
 	}
 	const autotelSampler = mergedConfig.sampler ?? (mergedConfig.sampling ? resolveSamplingPreset(mergedConfig.sampling) : void 0);
@@ -4623,4 +4738,4 @@ function getSdk() {
 }
 
 //#endregion
-export { generateCorrelationId as $, CompositeSampler as A, hashUnitInterval as B, TailSamplingSpanProcessor as C, AUTOTEL_SAMPLING_TAIL_KEEP as D, AUTOTEL_SAMPLING_TAIL_EVALUATED as E, RandomSampler as F, createTraceContext as G, markForceKept as H, UserIdSampler as I, getActiveContextWithBaggage as J, defineBaggageSchema as K, createLinkFromHeaders as L, FeatureFlagSampler as M, KeyTargetRateSampler as N, AdaptiveSampler as O, NeverSampler as P, CORRELATION_ID_BAGGAGE_KEY as Q, debugCaptureRequested as R, BaggageSpanProcessor as S, AUTOTEL_SAMPLING_RATE as T, resolveSamplingPreset as U, isForceKept as V, samplingPresets as W, getEventQueue as X, getContextStorage as Y, track as Z, loadYamlConfig as _, init as a, setCorrelationIdInBaggage as at, getRequestSpanIn as b, lockLogger as c, Event as d, getCorrelationId as et, getEvents as f, hasYamlConfig as g, runInOperationContext as h, getSdk as i, setCorrelationId as it, DeterministicSampler as j, AlwaysSampler as k, flush as l, getOperationContext as m, getConfiguredSampler as n, getOrCreateCorrelationId as nt, isInitialized as o, resetEvents as p, explicitSpanStatus as q, getLogger as r, runWithCorrelationId as rt, isLoggerLocked as s, getConfig as t, getCorrelationStorage as tt, shutdown as u, loadYamlConfigFromFile as v, AUTOTEL_DEBUG_BAGGAGE_KEY as w, rememberRequestAttributes as x, createStringRedactor as y, extractLinksFromBatch as z };
+export { CORRELATION_ID_BAGGAGE_KEY as $, AlwaysSampler as A, extractLinksFromBatch as B, BaggageSpanProcessor as C, AUTOTEL_SAMPLING_TAIL_EVALUATED as D, AUTOTEL_SAMPLING_RATE as E, NeverSampler as F, samplingPresets as G, isForceKept as H, RandomSampler as I, explicitSpanStatus as J, createTraceContext as K, UserIdSampler as L, DeterministicSampler as M, FeatureFlagSampler as N, AUTOTEL_SAMPLING_TAIL_KEEP as O, KeyTargetRateSampler as P, track as Q, createLinkFromHeaders as R, rememberRequestAttributes as S, AUTOTEL_DEBUG_BAGGAGE_KEY as T, markForceKept as U, hashUnitInterval as V, resolveSamplingPreset as W, getContextStorage as X, getActiveContextWithBaggage as Y, getEventQueue as Z, loadYamlConfig as _, init as a, setCorrelationId as at, EnrichedSpanProcessor as b, lockLogger as c, Event as d, generateCorrelationId as et, getEvents as f, hasYamlConfig as g, runInOperationContext as h, getSdk as i, runWithCorrelationId as it, CompositeSampler as j, AdaptiveSampler as k, flush as l, getOperationContext as m, getConfiguredSampler as n, getCorrelationStorage as nt, isInitialized as o, setCorrelationIdInBaggage as ot, resetEvents as p, defineBaggageSchema as q, getLogger as r, getOrCreateCorrelationId as rt, isLoggerLocked as s, getConfig as t, getCorrelationId as tt, shutdown as u, loadYamlConfigFromFile as v, TailSamplingSpanProcessor as w, getRequestSpanIn as x, createStringRedactor as y, debugCaptureRequested as z };

package/dist/{init-Cx1-ejLn.cjs → init-DlJvp1WH.cjs}

@@ -1,16 +1,16 @@
 const require_rolldown_runtime = require('./rolldown-runtime-C24Yb2bl.cjs');
-const require_values = require('./values-AxGpgYBA.cjs');
+const require_values = require('./values-9A6nOyZm.cjs');
 const require_tracer_provider = require('./tracer-provider.cjs');
 const require_config = require('./config.cjs');
-const require_structured_error = require('./structured-error-DynjWTTu.cjs');
-const require_node_require = require('./node-require-BPsB09eC.cjs');
+const require_structured_error = require('./structured-error-Ci8s_M6u.cjs');
+const require_node_require = require('./node-require-BotQNkYw.cjs');
 const require_filtering_span_processor = require('./filtering-span-processor.cjs');
 const require_policy = require('./policy.cjs');
 const require_span_name_normalizer = require('./span-name-normalizer.cjs');
 const require_attribute_redacting_processor = require('./attribute-redacting-processor.cjs');
 const require_pretty_console_exporter = require('./pretty-console-exporter-CMzlrRNg.cjs');
-const require_canonical_log_line_processor = require('./canonical-log-line-processor-BU03jJeA.cjs');
-const require_channel = require('./channel-D0eaVqn3.cjs');
+const require_canonical_log_line_processor = require('./canonical-log-line-processor-DScNq1g8.cjs');
+const require_channel = require('./channel-3MV-4Aqv.cjs');
 const require_metric = require('./metric.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 let _opentelemetry_api_logs = require("@opentelemetry/api-logs");
@@ -1964,15 +1964,15 @@ const silentLogger = {
 function wrapLogger(base, silent, minLevel) {
 	if (silent) return silentLogger;
 	const threshold = LOG_LEVELS[minLevel];
-	const wrap = (fn, level) => {
+	const wrap = (level) => {
 		if (LOG_LEVELS[level] < threshold) return (() => {});
-		return ((...args) => fn(...args));
+		return ((...args) => base[level](...args));
 	};
 	return {
-		debug: wrap(base.debug, "debug"),
-		info: wrap(base.info, "info"),
-		warn: wrap(base.warn, "warn"),
-		error: wrap(base.error, "error")
+		debug: wrap("debug"),
+		info: wrap("info"),
+		warn: wrap("warn"),
+		error: wrap("error")
 	};
 }
 
@@ -2173,6 +2173,47 @@ var RequestAttributesSpanProcessor = class {
 	}
 };
 
+//#endregion
+//#region src/enriched-span-processor.ts
+/**
+* `spanEnrichers` in front of the processors that export, as one processor.
+*
+* Spans reach the enrichers first, as they would in a flat list. The
+* difference is flush and shutdown: the SDK runs those on every processor at
+* once, so an enricher that ends a span of its own while it drains (an async
+* judgment, say) would hand it to an exporter that had already closed. Here the
+* enrichers drain first and the exporters flush after them.
+*/
+var EnrichedSpanProcessor = class {
+	enrichers;
+	downstream;
+	/** Every processor in call order: the enrichers, then the rest. */
+	processors;
+	constructor(enrichers, downstream) {
+		this.enrichers = enrichers;
+		this.downstream = downstream;
+		this.processors = [...enrichers, ...downstream];
+	}
+	onStart(span, parentContext) {
+		for (const processor of this.processors) processor.onStart(span, parentContext);
+	}
+	onEnd(span) {
+		for (const processor of this.processors) processor.onEnd(span);
+	}
+	forceFlush() {
+		return this.drainThenRun((p) => p.forceFlush());
+	}
+	shutdown() {
+		return this.drainThenRun((p) => p.shutdown());
+	}
+	async drainThenRun(run) {
+		const drained = await Promise.allSettled(this.enrichers.map(async (p) => run(p)));
+		await Promise.all(this.downstream.map(run));
+		const failed = drained.find((r) => r.status === "rejected");
+		if (failed) throw failed.reason;
+	}
+};
+
 //#endregion
 //#region src/redact-values.ts
 /** Standalone string redaction for use outside the span processor pipeline. */
@@ -4142,20 +4183,68 @@ function toPackageName(name) {
 	return name.startsWith("@opentelemetry/instrumentation-") ? name : `@opentelemetry/instrumentation-${name}`;
 }
 /**
-* Detect if we're running in ESM mode
+* Whether the app's entry runs as ESM: its extension when it has an explicit
+* one (`.mjs`/`.cjs`, and `.mts`/`.cts` under tsx), else the cwd
+* package.json's `type`.
 */
-function isESMMode() {
+function isESMMode(entry = process.argv[1] ?? "") {
+	if (/\.c[jt]s$/.test(entry)) return false;
+	if (/\.m[jt]s$/.test(entry)) return true;
 	try {
 		const fs = require_node_require.requireModule("node:fs");
-		try {
-			return JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, "utf8")).type === "module";
-		} catch {
-			return false;
-		}
+		return JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, "utf8")).type === "module";
 	} catch {
 		return false;
 	}
 }
+/** Set by `autotel/register` so `init()` can tell the ESM hook is in place. */
+const REGISTER_FLAG = Symbol.for("autotel.register");
+/**
+* Whether the OTel ESM loader hook is registered: by `autotel/register`, or
+* by pointing node at a `hook.mjs` directly.
+*/
+function isEsmHookLoaded(flags = `${process.execArgv.join(" ")} ${process.env.NODE_OPTIONS ?? ""}`) {
+	return globalThis[REGISTER_FLAG] === true || flags.includes("hook.mjs");
+}
+const LOGGER_PACKAGES = [
+	"pino",
+	"winston",
+	"bunyan"
+];
+function loadedModulePaths() {
+	try {
+		const { createRequire } = require_node_require.requireModule("node:module");
+		return Object.entries(createRequire(`${process.cwd()}/`).cache).filter(([, mod]) => mod?.loaded).map(([path]) => path);
+	} catch {
+		return [];
+	}
+}
+/**
+* Names in the array form that loaded nothing: a typo, or a library
+* auto-instrumentations-node has no instrumentation for (`fastify`, `next`).
+* Upstream only reports these through `diag`, which is silent by default.
+* Names a manual instrumentation replaced are not missing.
+*/
+function missingInstrumentations(names, loaded, manualInstrumentationNames = /* @__PURE__ */ new Set()) {
+	const loadedNames = new Set(loaded.map((i) => i.instrumentationName));
+	const replaced = new Set([...manualInstrumentationNames].map((className) => INSTRUMENTATION_CLASS_TO_PACKAGE.get(className)));
+	return names.filter((name) => {
+		const packageName = toPackageName(name);
+		return !loadedNames.has(packageName) && !replaced.has(packageName);
+	});
+}
+/**
+* Logger packages the config instruments that were already loaded when
+* `init()` ran. Instrumentations patch a package as it loads, so these never
+* get trace context: the logger module was imported before `init()`.
+*/
+function loggersLoadedBeforeInit(integrations, loadedPaths = loadedModulePaths()) {
+	if (integrations === false) return [];
+	const requested = integrations === true ? LOGGER_PACKAGES : Array.isArray(integrations) ? integrations : Object.entries(integrations).filter(([, options]) => options.enabled !== false).map(([name]) => name);
+	const wanted = new Set(requested.map((name) => toPackageName(name)));
+	const paths = loadedPaths.map((path) => path.replaceAll("\\", "/"));
+	return LOGGER_PACKAGES.filter((name) => wanted.has(toPackageName(name)) && paths.some((path) => path.includes(`/node_modules/${name}/`)));
+}
 /**
 * Lazy-load auto-instrumentations (optional peer dependency)
 * Only loads when integrations config is truthy, avoiding ~40+ package imports at startup.
@@ -4184,11 +4273,12 @@ See: https://github.com/jagreehal/autotel#esm-setup`);
 * @internal
 */
 let _autoInstrumentationsLoader = null;
+const HTTP_PACKAGE = "@opentelemetry/instrumentation-http";
 /**
 * Get auto-instrumentations based on simple integration names
 * Excludes instrumentations that are manually provided to avoid conflicts
 */
-function getAutoInstrumentations(integrations, manualInstrumentationNames = /* @__PURE__ */ new Set()) {
+function getAutoInstrumentations(integrations, manualInstrumentationNames = /* @__PURE__ */ new Set(), ignoredServerPorts = []) {
 	if (integrations === false) return [];
 	const getNodeAutoInstrumentations = _autoInstrumentationsLoader ? _autoInstrumentationsLoader() : loadNodeAutoInstrumentations();
 	const exclusionConfig = {};
@@ -4203,7 +4293,18 @@ function getAutoInstrumentations(integrations, manualInstrumentationNames = /* @
 		if (packageName in exclusionConfig) continue;
 		config[packageName] = options;
 	}
-	return getNodeAutoInstrumentations(withAutotelDefaults(config));
+	const http = config[HTTP_PACKAGE] ?? {};
+	if (ignoredServerPorts.length > 0 && http.enabled !== false) {
+		const userHook = http.ignoreIncomingRequestHook;
+		config[HTTP_PACKAGE] = {
+			...http,
+			ignoreIncomingRequestHook: (request) => ignoredServerPorts.includes(request.socket?.localPort ?? -1) || (userHook?.(request) ?? false)
+		};
+	}
+	const resolved = withAutotelDefaults(config);
+	if (!Array.isArray(integrations)) return getNodeAutoInstrumentations(resolved);
+	const listed = new Set(Object.keys(config).filter((name) => config[name]?.enabled === true));
+	return getNodeAutoInstrumentations(new Proxy(resolved, { get: (target, name) => typeof name === "string" && listed.has(name) ? target[name] : { enabled: false } }));
 }
 
 //#endregion
@@ -4368,6 +4469,10 @@ function init(cfg) {
 	const minLevel = mergedConfig.minLevel ?? "info";
 	const baseLogger = mergedConfig.logger || silentLogger;
 	logger = wrapLogger(baseLogger, silent, minLevel);
+	const setupWarn = (msg) => {
+		if (mergedConfig.logger) logger.warn({}, msg);
+		else if (!silent) console.warn(msg);
+	};
 	if (initialized) logger.warn({}, "[autotel] init() called again - last config wins. This may cause unexpected behavior.");
 	config = mergedConfig;
 	validationConfig = mergedConfig.validation || null;
@@ -4376,19 +4481,24 @@ function init(cfg) {
 	const version = mergedConfig.version || detectVersion();
 	const environment = mergedConfig.environment || process.env.NODE_ENV || "development";
 	const metricsEnabled = resolveMetricsFlag(mergedConfig.metrics);
-	const canonicalLogger = mergedConfig.canonicalLogLines?.logger ?? mergedConfig.logger;
+	const canonicalLogger = mergedConfig.canonicalLogLines?.logger;
 	const hasCanonicalLogger = Array.isArray(canonicalLogger) ? canonicalLogger.length > 0 : canonicalLogger !== void 0;
 	const canonicalUsesOtel = mergedConfig.canonicalLogLines?.enabled === true && (mergedConfig.canonicalLogLines.otel ?? !hasCanonicalLogger);
 	const logsEnabled = resolveLogsFlag(mergedConfig.logs ?? (canonicalUsesOtel ? true : "auto"));
+	let devtoolsPort;
 	if (devtoolsConfig.enabled && devtoolsConfig.embedded) {
 		const devtoolsModule = _optionalRequire("autotel-devtools");
 		if (devtoolsModule?.createDevtools) {
+			if (devtoolsConfig.port === 0) throw new Error("[autotel] devtools.embedded needs a fixed devtools.port; 0 is not supported");
 			const devtoolsInstance = devtoolsModule.createDevtools({
 				port: devtoolsConfig.port,
 				host: devtoolsConfig.host,
-				verbose: devtoolsConfig.verbose
+				verbose: devtoolsConfig.verbose,
+				maxPortTries: 1
 			});
+			devtoolsInstance.ready?.catch((error) => setupWarn(`[autotel] autotel-devtools could not start (${error instanceof Error ? error.message : String(error)}). Telemetry is still sent to ${endpoint}; free the port or set devtools.port.`));
 			_devtoolsClose = devtoolsInstance.close;
+			devtoolsPort = devtoolsInstance.port;
 			endpoint = `http://${devtoolsConfig.host}:${devtoolsInstance.port}`;
 			logger.info({}, `[autotel] autotel-devtools embedded server started at ${endpoint}`);
 		} else logger.warn({}, "[autotel] devtools.embedded requested but autotel-devtools is not installed. Falling back to endpoint-only mode.");
@@ -4460,7 +4570,7 @@ function init(cfg) {
 	}
 	if (mergedConfig.spanFilter && spanProcessors.length > 0) spanProcessors = spanProcessors.map((processor) => new require_filtering_span_processor.FilteringSpanProcessor(processor, { filter: mergedConfig.spanFilter }));
 	if (spanProcessors.length > 0) spanProcessors.unshift(new RequestAttributesSpanProcessor());
-	if (mergedConfig.spanEnrichers && mergedConfig.spanEnrichers.length > 0) spanProcessors.unshift(...mergedConfig.spanEnrichers);
+	if (mergedConfig.spanEnrichers && mergedConfig.spanEnrichers.length > 0) spanProcessors = [new EnrichedSpanProcessor(mergedConfig.spanEnrichers, spanProcessors)];
 	const metricReaders = [];
 	if (configuredMetricReaders && configuredMetricReaders.length > 0) metricReaders.push(...configuredMetricReaders);
 	else if (metricsEnabled) for (const destination of otlpDestinations) {
@@ -4501,17 +4611,22 @@ function init(cfg) {
 	if (mergedConfig.policies && logRecordProcessors) logRecordProcessors = logRecordProcessors.map((processor) => new require_policy.PolicyLogRecordProcessor(processor));
 	let finalInstrumentations = mergedConfig.instrumentations ? [...mergedConfig.instrumentations] : [];
 	if (mergedConfig.autoInstrumentations !== void 0 && mergedConfig.autoInstrumentations !== false) {
-		if (isESMMode()) logger.info({}, "[autotel] ESM mode detected. For auto-instrumentation to work:\n  1. Install @opentelemetry/auto-instrumentations-node as a direct dependency\n  2. Import autotel/register FIRST in your instrumentation file\n  3. Use getNodeAutoInstrumentations() directly instead of autoInstrumentations\n  See: https://github.com/jagreehal/autotel#esm-setup");
+		if (isESMMode() && !isEsmHookLoaded()) setupWarn("[autotel] ESM app without the OTel loader hook: packages loaded with `import` (pino, express, ...) will not be instrumented. Start node with `--import autotel/register`. See: https://github.com/jagreehal/autotel#esm-setup");
+		for (const name of loggersLoadedBeforeInit(mergedConfig.autoInstrumentations)) setupWarn(`[autotel] ${name} was loaded before init(), so its logs get no trace context. Run init() first, and don't create your ${name} logger in the module that calls it.`);
 		try {
 			const manualInstrumentationNames = getInstrumentationNames(mergedConfig.instrumentations ?? []);
 			if (manualInstrumentationNames.size > 0) {
 				const manualNames = [...manualInstrumentationNames].join(", ");
 				logger.info({}, `[autotel] Detected manual instrumentations (${manualNames}). These will take precedence over auto-instrumentations. Tip: Set autoInstrumentations:false if you want full manual control, or remove manual configs to use auto-instrumentations.`);
 			}
-			const autoInstrumentations = getAutoInstrumentations(mergedConfig.autoInstrumentations, manualInstrumentationNames);
+			const autoInstrumentations = getAutoInstrumentations(mergedConfig.autoInstrumentations, manualInstrumentationNames, devtoolsPort === void 0 ? [] : [devtoolsPort]);
+			if (Array.isArray(mergedConfig.autoInstrumentations)) {
+				const missing = missingInstrumentations(mergedConfig.autoInstrumentations, autoInstrumentations ?? [], manualInstrumentationNames);
+				if (missing.length > 0) setupWarn(`[autotel] autoInstrumentations: no instrumentation loaded for ${missing.join(", ")}. Check the spelling; @opentelemetry/auto-instrumentations-node has none for some libraries (fastify, next).`);
+			}
 			if (autoInstrumentations && autoInstrumentations.length > 0) finalInstrumentations = [...finalInstrumentations, ...autoInstrumentations];
 		} catch (error) {
-			logger.warn({}, `[autotel] Failed to configure auto-instrumentations: ${error instanceof Error ? error.message : String(error)}`);
+			setupWarn(`[autotel] Failed to configure auto-instrumentations: ${error instanceof Error ? error.message : String(error)}`);
 		}
 	}
 	const autotelSampler = mergedConfig.sampler ?? (mergedConfig.sampling ? resolveSamplingPreset(mergedConfig.sampling) : void 0);
@@ -4688,6 +4803,12 @@ Object.defineProperty(exports, 'DeterministicSampler', {
     return DeterministicSampler;
   }
 });
+Object.defineProperty(exports, 'EnrichedSpanProcessor', {
+  enumerable: true,
+  get: function () {
+    return EnrichedSpanProcessor;
+  }
+});
 Object.defineProperty(exports, 'Event', {
   enumerable: true,
   get: function () {