autotel 6.2.1 → 6.3.0

package/dist/{init-Bu6wR-k_.js → init-Qn4gIW1i.js}

@@ -17,12 +17,12 @@ import { resourceFromAttributes } from "@opentelemetry/resources";
 import { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
 import { context, propagation, trace } from "@opentelemetry/api";
 import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
-import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
 import { BatchLogRecordProcessor } from "@opentelemetry/sdk-logs";
 import { constants } from "node:os";
 import * as nodeAsyncHooks from "node:async_hooks";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { OTLPLogExporter } from "@opentelemetry/exporter-logs-otlp-http";
 
 //#region src/posthog-logs.ts
 var RedactingLogRecordProcessor = class {
@@ -325,6 +325,39 @@ function resolveDevtoolsConfig(config) {
 //#endregion
 //#region src/process-handlers.ts
 let removeOwnedHandlers = [];
+/**
+* Tracked separately from `removeOwnedHandlers` because the exit flush outlives
+* a call to `installProcessHandlers`, which clears that list before installing
+* its own signal listeners.
+*/
+let removeExitFlush;
+/**
+* Shared across every path that can end the process: signals, fatal errors and
+* a clean exit. They can overlap — a container stopping a job that has just
+* finished its work sends SIGTERM while the exit flush is still draining — and
+* a second shutdown would tear down queues the first is still using.
+*/
+let shutdownInFlight;
+/**
+* The clean-exit flush, while it runs. Doubles as the latch that keeps a
+* re-emitted `beforeExit` from flushing twice, and as the thing a shutdown
+* waits on rather than tearing down queues mid-drain.
+*/
+let exitFlushInFlight;
+const DEFAULT_SHUTDOWN_TIMEOUT_MS = 2e3;
+function runShutdownOnce(shutdown, timeoutMs) {
+	if (shutdownInFlight) return shutdownInFlight;
+	let timeoutHandle;
+	const shutdownAttempt = Promise.resolve(exitFlushInFlight).then(shutdown).catch(() => void 0);
+	const timeout = new Promise((resolve) => {
+		timeoutHandle = setTimeout(resolve, timeoutMs);
+		timeoutHandle.unref();
+	});
+	shutdownInFlight = Promise.race([shutdownAttempt, timeout]).then(() => {
+		if (timeoutHandle) clearTimeout(timeoutHandle);
+	});
+	return shutdownInFlight;
+}
 const DEFAULT_SIGNALS = ["SIGTERM", "SIGINT"];
 function signalExitCode(signal) {
 	return 128 + constants.signals[signal];
@@ -343,21 +376,7 @@ function reportFatalError(error, event) {
 }
 function installProcessHandlers(config, shutdown) {
 	uninstallProcessHandlers();
-	let shutdownInFlight;
-	const runShutdownOnce = () => {
-		if (shutdownInFlight) return shutdownInFlight;
-		const timeoutMs = config.shutdownTimeoutMs ?? 2e3;
-		let timeoutHandle;
-		const shutdownAttempt = Promise.resolve().then(shutdown).catch(() => void 0);
-		const timeout = new Promise((resolve) => {
-			timeoutHandle = setTimeout(resolve, timeoutMs);
-			timeoutHandle.unref();
-		});
-		shutdownInFlight = Promise.race([shutdownAttempt, timeout]).then(() => {
-			if (timeoutHandle) clearTimeout(timeoutHandle);
-		});
-		return shutdownInFlight;
-	};
+	const timeoutMs = config.shutdownTimeoutMs ?? DEFAULT_SHUTDOWN_TIMEOUT_MS;
 	let exitScheduled = false;
 	let resolvedExitCode = 0;
 	let fatalLatched = false;
@@ -370,7 +389,7 @@ function installProcessHandlers(config, shutdown) {
 		} else if (!exitScheduled && !fatalLatched) resolvedExitCode = exitCode;
 		if (exitScheduled) return;
 		exitScheduled = true;
-		runShutdownOnce().then(() => {
+		runShutdownOnce(shutdown, timeoutMs).then(() => {
 			process.exit(resolvedExitCode);
 		});
 	};
@@ -401,9 +420,43 @@ function installProcessHandlers(config, shutdown) {
 		});
 	}
 }
+/**
+* Flush telemetry when the process runs to completion.
+*
+* The signal and fatal-error handlers above cover a process that is stopped or
+* that crashes. Neither fires when a script simply finishes: the event loop
+* drains and Node exits, taking whatever the batch span processor was still
+* holding with it. `beforeExit` is the only hook for that case, and it is the
+* one that matters for CLIs, cron jobs, CI steps and serverless handlers.
+*
+* A flush, never a shutdown: `beforeExit` fires on *any* event-loop drain, not
+* only the final one, so tearing the SDK down here would silently kill
+* telemetry in a process that goes on to do more work.
+*/
+function installExitFlush(flushTelemetry, timeoutMs = DEFAULT_SHUTDOWN_TIMEOUT_MS) {
+	removeExitFlush?.();
+	exitFlushInFlight = void 0;
+	const listener = (code) => {
+		if (exitFlushInFlight || shutdownInFlight) return;
+		const deadline = setTimeout(() => {
+			process.exit(process.exitCode ?? code);
+		}, timeoutMs);
+		exitFlushInFlight = flushTelemetry().catch(() => void 0).finally(() => {
+			clearTimeout(deadline);
+		});
+	};
+	process.on("beforeExit", listener);
+	removeExitFlush = () => {
+		process.removeListener("beforeExit", listener);
+		removeExitFlush = void 0;
+	};
+}
 function uninstallProcessHandlers() {
 	for (const removeHandler of removeOwnedHandlers) removeHandler();
 	removeOwnedHandlers = [];
+	removeExitFlush?.();
+	shutdownInFlight = void 0;
+	exitFlushInFlight = void 0;
 }
 
 //#endregion
@@ -911,6 +964,11 @@ function getSubscriberName(subscriber) {
 	return (subscriber.constructor?.name || "unknown").replace(/Subscriber$/i, "").toLowerCase();
 }
 /**
+* Subscribers whose `shutdown()` has run. Terminal for the client they wrap, so
+* a queue rebuilt from the same config must not reuse them.
+*/
+const shutDownSubscribers = /* @__PURE__ */ new WeakSet();
+/**
 * Events queue with batching and backpressure
 *
 * Features:
@@ -932,13 +990,15 @@ var EventQueue = class {
 	observableCleanups = [];
 	subscriberHealthy = /* @__PURE__ */ new Map();
 	constructor(subscribers, config) {
-		this.subscribers = subscribers;
+		const live = subscribers.filter((s) => !shutDownSubscribers.has(s));
+		if (live.length < subscribers.length) getLogger().warn({ subscribers: subscribers.filter((s) => shutDownSubscribers.has(s)).map((s) => getSubscriberName(s)) }, "[autotel] Subscriber already shut down, events will not be delivered; pass new subscriber instances to init()");
+		this.subscribers = live;
 		this.config = {
 			...DEFAULT_CONFIG$2,
 			...config
 		};
 		this.rateLimiter = this.config.rateLimit ? new TokenBucketRateLimiter(this.config.rateLimit) : null;
-		for (const subscriber of subscribers) {
+		for (const subscriber of this.subscribers) {
 			const name = getSubscriberName(subscriber);
 			this.subscriberHealthy.set(name, true);
 		}
@@ -1232,6 +1292,20 @@ var EventQueue = class {
 	async shutdown() {
 		this.isShuttingDown = true;
 		await this.flush();
+		const drains = await Promise.allSettled(this.subscribers.map(async (subscriber) => {
+			if (!subscriber.shutdown) return;
+			shutDownSubscribers.add(subscriber);
+			return subscriber.shutdown();
+		}));
+		for (const [index, drain] of drains.entries()) {
+			if (drain.status !== "rejected") continue;
+			const subscriberName = getSubscriberName(this.subscribers[index]);
+			this.subscriberHealthy.set(subscriberName, false);
+			getLogger().error({
+				subscriber: subscriberName,
+				err: drain.reason
+			}, "[autotel] Subscriber shutdown failed, buffered events may be lost");
+		}
 	}
 	/**
 	* Cleanup observable metric callbacks to prevent memory leaks
@@ -2461,47 +2535,7 @@ async function shutdown() {
 }
 
 //#endregion
-//#region src/init.ts
-/**
-* Simplified initialization for autotel
-*
-* Single init() function with sensible defaults.
-* Replaces initInstrumentation() and separate events config.
-*/
-/**
-* Silent logger (no-op) - used as default when user doesn't provide one.
-* Internal autotel logs are silent by default to avoid spam.
-* Users can import { autotelLogger } from 'autotel/logger' to create their own.
-*/
-const silentLogger = {
-	info: () => {},
-	warn: () => {},
-	error: () => {},
-	debug: () => {}
-};
-/**
-* Adapts an Autotel Sampler to the OTel SDK Sampler interface.
-*/
-function toOtelSampler(sampler) {
-	return {
-		shouldSample(_context, _traceId, spanName, _spanKind, _attributes, links) {
-			const samplingContext = {
-				operationName: spanName,
-				args: [],
-				links
-			};
-			const shouldTrace = sampler.shouldSample(samplingContext);
-			const rate = sampler.sampleRate?.(samplingContext);
-			return {
-				decision: shouldTrace ? SamplingDecision.RECORD_AND_SAMPLED : SamplingDecision.NOT_RECORD,
-				...shouldTrace && rate !== void 0 && rate > 1 ? { attributes: { [AUTOTEL_SAMPLING_RATE]: rate } } : {}
-			};
-		},
-		toString() {
-			return `AutotelSamplerAdapter`;
-		}
-	};
-}
+//#region src/otlp-exporters.ts
 let OTLPTraceExporterPROTO;
 let OTLPMetricExporterPROTO;
 let OTLPLogExporterPROTO;
@@ -2615,62 +2649,9 @@ function formatEndpointUrl(endpoint, signal, protocol) {
 	if (!endpoint.endsWith(`/v1/${signal}`)) return `${endpoint}/v1/${signal}`;
 	return endpoint;
 }
-let initialized = false;
-let locked = false;
-let config = null;
-let sdk = null;
-let warnedOnce = false;
-let logger = silentLogger;
-let validationConfig = null;
-let eventsConfig = null;
-let _stringRedactor = null;
-function acceptsStringRedactor(subscriber) {
-	return typeof subscriber === "object" && subscriber !== null && "setStringRedactor" in subscriber && typeof subscriber.setStringRedactor === "function";
-}
-let _optionalRequire = safeRequire;
-let _devtoolsClose = null;
-const LOG_LEVELS = {
-	debug: 0,
-	info: 1,
-	warn: 2,
-	error: 3
-};
-/**
-* Lock the logger to prevent further `init()` calls.
-* Use this when framework plugins set up instrumentation and you want
-* to prevent accidental re-initialization from user code.
-*/
-function lockLogger() {
-	locked = true;
-}
-/**
-* Check if the logger has been locked.
-*/
-function isLoggerLocked() {
-	return locked;
-}
-function createSilentLogger() {
-	return {
-		info: () => {},
-		warn: () => {},
-		error: () => {},
-		debug: () => {}
-	};
-}
-function wrapLogger(base, silent, minLevel) {
-	if (silent) return createSilentLogger();
-	const threshold = LOG_LEVELS[minLevel];
-	const wrap = (fn, level) => {
-		if (LOG_LEVELS[level] < threshold) return (() => {});
-		return ((...args) => fn(...args));
-	};
-	return {
-		debug: wrap(base.debug, "debug"),
-		info: wrap(base.info, "info"),
-		warn: wrap(base.warn, "warn"),
-		error: wrap(base.error, "error")
-	};
-}
+
+//#endregion
+//#region src/config-resolution.ts
 /**
 * Resolve the effective attribute redactor. Explicit config wins (`false`
 * disables). Otherwise the `AUTOTEL_REDACT_PII` env var controls it, and as a
@@ -2785,106 +2766,347 @@ function destinationSupportsSignal(destination, signal) {
 	return destination.signals ? destination.signals.has(signal) : true;
 }
 /**
-* Initialize autotel - Write Once, Observe Everywhere
-*
-* Follows OpenTelemetry standards: opinionated defaults with full flexibility
-* Idempotent: multiple calls are safe, last one wins
-*
-* @example Minimal setup (OTLP default)
-* ```typescript
-* init({ service: 'my-app' })
-* ```
-*
-* @example With events (observe in PostHog, Mixpanel, etc.)
-* ```typescript
-* import { PostHogSubscriber } from 'autotel-subscribers/posthog';
-*
-* init({
-*   service: 'my-app',
-*   subscribers: [new PostHogSubscriber({ apiKey: '...' })]
-* })
-* ```
-*
-* @example Observe in Jaeger
-* ```typescript
-* import { JaegerExporter } from '@opentelemetry/exporter-jaeger'
-*
-* init({
-*   service: 'my-app',
-*   spanExporter: new JaegerExporter({ endpoint: 'http://localhost:14268/api/traces' })
-* })
-* ```
-*
-* @example Observe in Zipkin
-* ```typescript
-* import { ZipkinExporter } from '@opentelemetry/exporter-zipkin'
-*
-* init({
-*   service: 'my-app',
-*   spanExporter: new ZipkinExporter({ url: 'http://localhost:9411/api/v2/spans' })
-* })
-* ```
-*
-* @example Observe in Datadog
-* ```typescript
-* import { DatadogSpanProcessor } from '@opentelemetry/exporter-datadog'
-*
-* init({
-*   service: 'my-app',
-*   spanProcessor: new DatadogSpanProcessor({ ... })
-* })
-* ```
+* Auto-detect version from package.json
+*/
+function detectVersion() {
+	try {
+		const fs = requireModule("node:fs");
+		return JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, "utf8")).version || "1.0.0";
+	} catch {
+		return "1.0.0";
+	}
+}
+/**
+* Detect hostname for resource attributes.
+* Supports Datadog conventions (DD_HOSTNAME) and falls back to system hostname.
 *
-* @example Console output (dev)
-* ```typescript
-* import { ConsoleSpanExporter, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base'
+* Priority order:
+* 1. DD_HOSTNAME environment variable (Datadog convention)
+* 2. HOSTNAME environment variable (common Unix convention)
+* 3. os.hostname() (system hostname)
 *
-* init({
-*   service: 'my-app',
-*   spanProcessor: new SimpleSpanProcessor(new ConsoleSpanExporter())
-* })
-* ```
+* @returns hostname string or undefined if detection fails
 */
-function init(cfg) {
-	if (locked) return;
-	const envConfig = resolveConfigFromEnv();
-	const yamlConfig = loadYamlConfig() ?? {};
-	const mergedConfig = {
-		...envConfig,
-		...yamlConfig,
-		...cfg,
-		resourceAttributes: {
-			...envConfig.resourceAttributes,
-			...yamlConfig.resourceAttributes,
-			...detectEnvironmentAttributes(),
-			...cfg.resourceAttributes
-		},
-		headers: cfg.headers ?? yamlConfig.headers ?? envConfig.headers
-	};
-	const resolvedRedactor = resolveAttributeRedactor(mergedConfig.attributeRedactor, mergedConfig.environment || process.env.NODE_ENV || "development");
-	if (resolvedRedactor === void 0) mergedConfig.attributeRedactor = void 0;
-	else {
-		const normalizedRedactor = normalizeAttributeRedactorConfig(resolvedRedactor);
-		if (!normalizedRedactor) throw new Error("Invalid attributeRedactor config");
-		mergedConfig.attributeRedactor = normalizedRedactor;
+function detectHostname() {
+	if (process.env.DD_HOSTNAME) return process.env.DD_HOSTNAME;
+	if (process.env.HOSTNAME) return process.env.HOSTNAME;
+	try {
+		return requireModule("node:os").hostname();
+	} catch {
+		return;
 	}
-	const devtoolsConfig = resolveDevtoolsConfig(mergedConfig.devtools);
-	if (devtoolsConfig.enabled && mergedConfig.logs === void 0) mergedConfig.logs = true;
-	const silent = mergedConfig.silent ?? false;
-	const minLevel = mergedConfig.minLevel ?? "info";
-	logger = wrapLogger(mergedConfig.logger || silentLogger, silent, minLevel);
-	if (initialized) logger.warn({}, "[autotel] init() called again - last config wins. This may cause unexpected behavior.");
-	config = mergedConfig;
-	validationConfig = mergedConfig.validation || null;
-	eventsConfig = mergedConfig.events || null;
-	let endpoint = mergedConfig.endpoint ?? devtoolsConfig.endpoint;
-	const version = mergedConfig.version || detectVersion();
-	const environment = mergedConfig.environment || process.env.NODE_ENV || "development";
-	const metricsEnabled = resolveMetricsFlag(mergedConfig.metrics);
-	const logsEnabled = resolveLogsFlag(mergedConfig.logs);
-	if (devtoolsConfig.enabled && devtoolsConfig.embedded) {
-		const devtoolsModule = _optionalRequire("autotel-devtools");
-		if (devtoolsModule?.createDevtools) {
+}
+
+//#endregion
+//#region src/auto-instrumentations.ts
+/**
+* Extract instrumentation class names from instrumentation instances
+* Used to detect duplicates between manual and auto instrumentations
+*/
+function getInstrumentationNames(instrumentations) {
+	const names = /* @__PURE__ */ new Set();
+	if (!instrumentations) return names;
+	for (const instrumentation of instrumentations) if (instrumentation && typeof instrumentation === "object") names.add(instrumentation.constructor.name);
+	return names;
+}
+/**
+* Map common instrumentation class names to their package names
+* Used to disable auto-instrumentations when user provides manual configs
+*/
+const INSTRUMENTATION_CLASS_TO_PACKAGE = {
+	HttpInstrumentation: "@opentelemetry/instrumentation-http",
+	HttpsInstrumentation: "@opentelemetry/instrumentation-http",
+	ExpressInstrumentation: "@opentelemetry/instrumentation-express",
+	FastifyInstrumentation: "@opentelemetry/instrumentation-fastify",
+	MongoDBInstrumentation: "@opentelemetry/instrumentation-mongodb",
+	MongooseInstrumentation: "@opentelemetry/instrumentation-mongoose",
+	PrismaInstrumentation: "@opentelemetry/instrumentation-prisma",
+	PinoInstrumentation: "@opentelemetry/instrumentation-pino",
+	WinstonInstrumentation: "@opentelemetry/instrumentation-winston",
+	RedisInstrumentation: "@opentelemetry/instrumentation-redis",
+	GraphQLInstrumentation: "@opentelemetry/instrumentation-graphql",
+	GrpcInstrumentation: "@opentelemetry/instrumentation-grpc",
+	IORedisInstrumentation: "@opentelemetry/instrumentation-ioredis",
+	KnexInstrumentation: "@opentelemetry/instrumentation-knex",
+	NestJsInstrumentation: "@opentelemetry/instrumentation-nestjs-core",
+	PgInstrumentation: "@opentelemetry/instrumentation-pg",
+	MySQLInstrumentation: "@opentelemetry/instrumentation-mysql",
+	MySQL2Instrumentation: "@opentelemetry/instrumentation-mysql2"
+};
+/**
+* Detect if we're running in ESM mode
+*/
+function isESMMode() {
+	try {
+		const fs = requireModule("node:fs");
+		try {
+			return JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, "utf8")).type === "module";
+		} catch {
+			return false;
+		}
+	} catch {
+		return false;
+	}
+}
+/**
+* Lazy-load auto-instrumentations (optional peer dependency)
+* Only loads when integrations config is truthy, avoiding ~40+ package imports at startup.
+*/
+function loadNodeAutoInstrumentations() {
+	try {
+		return requireModule("@opentelemetry/auto-instrumentations-node").getNodeAutoInstrumentations;
+	} catch {
+		const isESM = isESMMode();
+		const baseMessage = "@opentelemetry/auto-instrumentations-node not found.";
+		if (isESM) throw new Error(`${baseMessage}\n\nESM Setup Required:
+1. Install as a direct dependency: pnpm add @opentelemetry/auto-instrumentations-node
+2. Create instrumentation.mjs with:
+   import 'autotel/register';  // MUST be first!
+   import { init } from 'autotel';
+   import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
+   init({ service: "my-app", instrumentations: getNodeAutoInstrumentations() });
+3. Run with: tsx --import ./instrumentation.mjs src/index.ts
+
+See: https://github.com/jagreehal/autotel#esm-setup`);
+		throw new Error(`${baseMessage} Install it: pnpm add @opentelemetry/auto-instrumentations-node`);
+	}
+}
+/**
+* Injectable loader for testing. Set to override the default loader.
+* @internal
+*/
+let _autoInstrumentationsLoader = null;
+/**
+* Get auto-instrumentations based on simple integration names
+* Excludes instrumentations that are manually provided to avoid conflicts
+*/
+function getAutoInstrumentations(integrations, manualInstrumentationNames = /* @__PURE__ */ new Set()) {
+	if (integrations === false) return [];
+	const getNodeAutoInstrumentations = _autoInstrumentationsLoader ? _autoInstrumentationsLoader() : loadNodeAutoInstrumentations();
+	const exclusionConfig = {};
+	for (const className of manualInstrumentationNames) {
+		const packageName = INSTRUMENTATION_CLASS_TO_PACKAGE[className];
+		if (packageName) exclusionConfig[packageName] = { enabled: false };
+	}
+	if (integrations === true) {
+		if (Object.keys(exclusionConfig).length > 0) return getNodeAutoInstrumentations(exclusionConfig);
+		return getNodeAutoInstrumentations();
+	}
+	if (Array.isArray(integrations)) {
+		const config = { ...exclusionConfig };
+		for (const name of integrations) {
+			const packageName = `@opentelemetry/instrumentation-${name}`;
+			if (!exclusionConfig[packageName]) config[packageName] = { enabled: true };
+		}
+		return getNodeAutoInstrumentations(config);
+	}
+	const config = {
+		...exclusionConfig,
+		...integrations
+	};
+	for (const packageName of Object.keys(exclusionConfig)) if (Object.keys(integrations).find((key) => packageName.includes(key))) config[packageName] = { enabled: false };
+	return getNodeAutoInstrumentations(config);
+}
+
+//#endregion
+//#region src/init.ts
+/**
+* Simplified initialization for autotel
+*
+* Single init() function with sensible defaults.
+* Replaces initInstrumentation() and separate events config.
+*/
+/**
+* Silent logger (no-op) - used as default when user doesn't provide one.
+* Internal autotel logs are silent by default to avoid spam.
+* Users can import { autotelLogger } from 'autotel/logger' to create their own.
+*/
+const silentLogger = {
+	info: () => {},
+	warn: () => {},
+	error: () => {},
+	debug: () => {}
+};
+/**
+* Adapts an Autotel Sampler to the OTel SDK Sampler interface.
+*/
+function toOtelSampler(sampler) {
+	return {
+		shouldSample(_context, _traceId, spanName, _spanKind, _attributes, links) {
+			const samplingContext = {
+				operationName: spanName,
+				args: [],
+				links
+			};
+			const shouldTrace = sampler.shouldSample(samplingContext);
+			const rate = sampler.sampleRate?.(samplingContext);
+			return {
+				decision: shouldTrace ? SamplingDecision.RECORD_AND_SAMPLED : SamplingDecision.NOT_RECORD,
+				...shouldTrace && rate !== void 0 && rate > 1 ? { attributes: { [AUTOTEL_SAMPLING_RATE]: rate } } : {}
+			};
+		},
+		toString() {
+			return `AutotelSamplerAdapter`;
+		}
+	};
+}
+let initialized = false;
+let locked = false;
+let config = null;
+let sdk = null;
+let warnedOnce = false;
+let logger = silentLogger;
+let validationConfig = null;
+let eventsConfig = null;
+let _stringRedactor = null;
+function acceptsStringRedactor(subscriber) {
+	return typeof subscriber === "object" && subscriber !== null && "setStringRedactor" in subscriber && typeof subscriber.setStringRedactor === "function";
+}
+let _optionalRequire = safeRequire;
+let _devtoolsClose = null;
+const LOG_LEVELS = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
+};
+/**
+* Lock the logger to prevent further `init()` calls.
+* Use this when framework plugins set up instrumentation and you want
+* to prevent accidental re-initialization from user code.
+*/
+function lockLogger() {
+	locked = true;
+}
+/**
+* Check if the logger has been locked.
+*/
+function isLoggerLocked() {
+	return locked;
+}
+function createSilentLogger() {
+	return {
+		info: () => {},
+		warn: () => {},
+		error: () => {},
+		debug: () => {}
+	};
+}
+function wrapLogger(base, silent, minLevel) {
+	if (silent) return createSilentLogger();
+	const threshold = LOG_LEVELS[minLevel];
+	const wrap = (fn, level) => {
+		if (LOG_LEVELS[level] < threshold) return (() => {});
+		return ((...args) => fn(...args));
+	};
+	return {
+		debug: wrap(base.debug, "debug"),
+		info: wrap(base.info, "info"),
+		warn: wrap(base.warn, "warn"),
+		error: wrap(base.error, "error")
+	};
+}
+/**
+* Initialize autotel - Write Once, Observe Everywhere
+*
+* Follows OpenTelemetry standards: opinionated defaults with full flexibility
+* Idempotent: multiple calls are safe, last one wins
+*
+* @example Minimal setup (OTLP default)
+* ```typescript
+* init({ service: 'my-app' })
+* ```
+*
+* @example With events (observe in PostHog, Mixpanel, etc.)
+* ```typescript
+* import { PostHogSubscriber } from 'autotel-subscribers/posthog';
+*
+* init({
+*   service: 'my-app',
+*   subscribers: [new PostHogSubscriber({ apiKey: '...' })]
+* })
+* ```
+*
+* @example Observe in Jaeger
+* ```typescript
+* import { JaegerExporter } from '@opentelemetry/exporter-jaeger'
+*
+* init({
+*   service: 'my-app',
+*   spanExporter: new JaegerExporter({ endpoint: 'http://localhost:14268/api/traces' })
+* })
+* ```
+*
+* @example Observe in Zipkin
+* ```typescript
+* import { ZipkinExporter } from '@opentelemetry/exporter-zipkin'
+*
+* init({
+*   service: 'my-app',
+*   spanExporter: new ZipkinExporter({ url: 'http://localhost:9411/api/v2/spans' })
+* })
+* ```
+*
+* @example Observe in Datadog
+* ```typescript
+* import { DatadogSpanProcessor } from '@opentelemetry/exporter-datadog'
+*
+* init({
+*   service: 'my-app',
+*   spanProcessor: new DatadogSpanProcessor({ ... })
+* })
+* ```
+*
+* @example Console output (dev)
+* ```typescript
+* import { ConsoleSpanExporter, SimpleSpanProcessor } from '@opentelemetry/sdk-trace-base'
+*
+* init({
+*   service: 'my-app',
+*   spanProcessor: new SimpleSpanProcessor(new ConsoleSpanExporter())
+* })
+* ```
+*/
+function init(cfg) {
+	if (locked) return;
+	const envConfig = resolveConfigFromEnv();
+	const yamlConfig = loadYamlConfig() ?? {};
+	const mergedConfig = {
+		...envConfig,
+		...yamlConfig,
+		...cfg,
+		resourceAttributes: {
+			...envConfig.resourceAttributes,
+			...yamlConfig.resourceAttributes,
+			...detectEnvironmentAttributes(),
+			...cfg.resourceAttributes
+		},
+		headers: cfg.headers ?? yamlConfig.headers ?? envConfig.headers
+	};
+	const resolvedRedactor = resolveAttributeRedactor(mergedConfig.attributeRedactor, mergedConfig.environment || process.env.NODE_ENV || "development");
+	if (resolvedRedactor === void 0) mergedConfig.attributeRedactor = void 0;
+	else {
+		const normalizedRedactor = normalizeAttributeRedactorConfig(resolvedRedactor);
+		if (!normalizedRedactor) throw new Error("Invalid attributeRedactor config");
+		mergedConfig.attributeRedactor = normalizedRedactor;
+	}
+	const devtoolsConfig = resolveDevtoolsConfig(mergedConfig.devtools);
+	if (devtoolsConfig.enabled && mergedConfig.logs === void 0) mergedConfig.logs = true;
+	const silent = mergedConfig.silent ?? false;
+	const minLevel = mergedConfig.minLevel ?? "info";
+	logger = wrapLogger(mergedConfig.logger || silentLogger, silent, minLevel);
+	if (initialized) logger.warn({}, "[autotel] init() called again - last config wins. This may cause unexpected behavior.");
+	config = mergedConfig;
+	validationConfig = mergedConfig.validation || null;
+	eventsConfig = mergedConfig.events || null;
+	let endpoint = mergedConfig.endpoint ?? devtoolsConfig.endpoint;
+	const version = mergedConfig.version || detectVersion();
+	const environment = mergedConfig.environment || process.env.NODE_ENV || "development";
+	const metricsEnabled = resolveMetricsFlag(mergedConfig.metrics);
+	const logsEnabled = resolveLogsFlag(mergedConfig.logs);
+	if (devtoolsConfig.enabled && devtoolsConfig.embedded) {
+		const devtoolsModule = _optionalRequire("autotel-devtools");
+		if (devtoolsModule?.createDevtools) {
 			const devtoolsInstance = devtoolsModule.createDevtools({
 				port: devtoolsConfig.port,
 				host: devtoolsConfig.host,
@@ -3039,116 +3261,16 @@ function init(cfg) {
 	}
 	initialized = true;
 	const processHandlers = mergedConfig.processHandlers;
-	if (processHandlers) installProcessHandlers(processHandlers === true ? {} : processHandlers, shutdown);
+	const handlersConfig = processHandlers && processHandlers !== true ? processHandlers : {};
+	if (processHandlers) installProcessHandlers(handlersConfig, shutdown);
 	else uninstallProcessHandlers();
-}
-/**
-* Extract instrumentation class names from instrumentation instances
-* Used to detect duplicates between manual and auto instrumentations
-*/
-function getInstrumentationNames(instrumentations) {
-	const names = /* @__PURE__ */ new Set();
-	if (!instrumentations) return names;
-	for (const instrumentation of instrumentations) if (instrumentation && typeof instrumentation === "object") names.add(instrumentation.constructor.name);
-	return names;
-}
-/**
-* Map common instrumentation class names to their package names
-* Used to disable auto-instrumentations when user provides manual configs
-*/
-const INSTRUMENTATION_CLASS_TO_PACKAGE = {
-	HttpInstrumentation: "@opentelemetry/instrumentation-http",
-	HttpsInstrumentation: "@opentelemetry/instrumentation-http",
-	ExpressInstrumentation: "@opentelemetry/instrumentation-express",
-	FastifyInstrumentation: "@opentelemetry/instrumentation-fastify",
-	MongoDBInstrumentation: "@opentelemetry/instrumentation-mongodb",
-	MongooseInstrumentation: "@opentelemetry/instrumentation-mongoose",
-	PrismaInstrumentation: "@opentelemetry/instrumentation-prisma",
-	PinoInstrumentation: "@opentelemetry/instrumentation-pino",
-	WinstonInstrumentation: "@opentelemetry/instrumentation-winston",
-	RedisInstrumentation: "@opentelemetry/instrumentation-redis",
-	GraphQLInstrumentation: "@opentelemetry/instrumentation-graphql",
-	GrpcInstrumentation: "@opentelemetry/instrumentation-grpc",
-	IORedisInstrumentation: "@opentelemetry/instrumentation-ioredis",
-	KnexInstrumentation: "@opentelemetry/instrumentation-knex",
-	NestJsInstrumentation: "@opentelemetry/instrumentation-nestjs-core",
-	PgInstrumentation: "@opentelemetry/instrumentation-pg",
-	MySQLInstrumentation: "@opentelemetry/instrumentation-mysql",
-	MySQL2Instrumentation: "@opentelemetry/instrumentation-mysql2"
-};
-/**
-* Detect if we're running in ESM mode
-*/
-function isESMMode() {
-	try {
-		const fs = requireModule("node:fs");
-		try {
-			return JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, "utf8")).type === "module";
-		} catch {
-			return false;
-		}
-	} catch {
-		return false;
-	}
-}
-/**
-* Lazy-load auto-instrumentations (optional peer dependency)
-* Only loads when integrations config is truthy, avoiding ~40+ package imports at startup.
-*/
-function loadNodeAutoInstrumentations() {
-	try {
-		return requireModule("@opentelemetry/auto-instrumentations-node").getNodeAutoInstrumentations;
-	} catch {
-		const isESM = isESMMode();
-		const baseMessage = "@opentelemetry/auto-instrumentations-node not found.";
-		if (isESM) throw new Error(`${baseMessage}\n\nESM Setup Required:
-1. Install as a direct dependency: pnpm add @opentelemetry/auto-instrumentations-node
-2. Create instrumentation.mjs with:
-   import 'autotel/register';  // MUST be first!
-   import { init } from 'autotel';
-   import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
-   init({ service: "my-app", instrumentations: getNodeAutoInstrumentations() });
-3. Run with: tsx --import ./instrumentation.mjs src/index.ts
-
-See: https://github.com/jagreehal/autotel#esm-setup`);
-		throw new Error(`${baseMessage} Install it: pnpm add @opentelemetry/auto-instrumentations-node`);
-	}
-}
-/**
-* Injectable loader for testing. Set to override the default loader.
-* @internal
-*/
-let _autoInstrumentationsLoader = null;
-/**
-* Get auto-instrumentations based on simple integration names
-* Excludes instrumentations that are manually provided to avoid conflicts
-*/
-function getAutoInstrumentations(integrations, manualInstrumentationNames = /* @__PURE__ */ new Set()) {
-	if (integrations === false) return [];
-	const getNodeAutoInstrumentations = _autoInstrumentationsLoader ? _autoInstrumentationsLoader() : loadNodeAutoInstrumentations();
-	const exclusionConfig = {};
-	for (const className of manualInstrumentationNames) {
-		const packageName = INSTRUMENTATION_CLASS_TO_PACKAGE[className];
-		if (packageName) exclusionConfig[packageName] = { enabled: false };
-	}
-	if (integrations === true) {
-		if (Object.keys(exclusionConfig).length > 0) return getNodeAutoInstrumentations(exclusionConfig);
-		return getNodeAutoInstrumentations();
-	}
-	if (Array.isArray(integrations)) {
-		const config = { ...exclusionConfig };
-		for (const name of integrations) {
-			const packageName = `@opentelemetry/instrumentation-${name}`;
-			if (!exclusionConfig[packageName]) config[packageName] = { enabled: true };
-		}
-		return getNodeAutoInstrumentations(config);
+	if (mergedConfig.flushOnExit !== false) {
+		const timeoutMs = handlersConfig.shutdownTimeoutMs;
+		installExitFlush(() => flush({
+			forShutdown: true,
+			timeout: timeoutMs
+		}), timeoutMs);
 	}
-	const config = {
-		...exclusionConfig,
-		...integrations
-	};
-	for (const packageName of Object.keys(exclusionConfig)) if (Object.keys(integrations).find((key) => packageName.includes(key))) config[packageName] = { enabled: false };
-	return getNodeAutoInstrumentations(config);
 }
 /**
 * Check if autotel has been initialized
@@ -3190,37 +3312,6 @@ function warnIfNotInitialized(context) {
 	}
 }
 /**
-* Auto-detect version from package.json
-*/
-function detectVersion() {
-	try {
-		const fs = requireModule("node:fs");
-		return JSON.parse(fs.readFileSync(`${process.cwd()}/package.json`, "utf8")).version || "1.0.0";
-	} catch {
-		return "1.0.0";
-	}
-}
-/**
-* Detect hostname for resource attributes.
-* Supports Datadog conventions (DD_HOSTNAME) and falls back to system hostname.
-*
-* Priority order:
-* 1. DD_HOSTNAME environment variable (Datadog convention)
-* 2. HOSTNAME environment variable (common Unix convention)
-* 3. os.hostname() (system hostname)
-*
-* @returns hostname string or undefined if detection fails
-*/
-function detectHostname() {
-	if (process.env.DD_HOSTNAME) return process.env.DD_HOSTNAME;
-	if (process.env.HOSTNAME) return process.env.HOSTNAME;
-	try {
-		return requireModule("node:os").hostname();
-	} catch {
-		return;
-	}
-}
-/**
 * @internal Close embedded devtools if running.
 */
 async function _closeEmbeddedDevtools() {