autotel-adapters 0.3.8 → 0.3.10

package/dist/core.cjs

@@ -1,97 +1,117 @@
-'use strict';
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let autotel = require("autotel");
 
-var autotel = require('autotel');
-
-// src/core.ts
+//#region src/core.ts
 function createUseLogger(options) {
-  return function useLogger(context, requestLoggerOptions) {
-    let logger;
-    try {
-      logger = autotel.getRequestLogger(void 0, requestLoggerOptions);
-    } catch {
-      throw new Error(
-        `[autotel-adapters/${options.adapterName}] No active trace context. Wrap your handler with autotel trace instrumentation before calling useLogger().`
-      );
-    }
-    if (context && options.enrich) {
-      const extra = options.enrich(context);
-      if (extra && Object.keys(extra).length > 0) {
-        logger.set(extra);
-      }
-    }
-    return logger;
-  };
+	return function useLogger(context, requestLoggerOptions) {
+		let logger;
+		try {
+			logger = (0, autotel.getRequestLogger)(void 0, requestLoggerOptions);
+		} catch {
+			throw new Error(`[autotel-adapters/${options.adapterName}] No active trace context. Wrap your handler with autotel trace instrumentation before calling useLogger().`);
+		}
+		if (context && options.enrich) {
+			const extra = options.enrich(context);
+			if (extra && Object.keys(extra).length > 0) logger.set(extra);
+		}
+		return logger;
+	};
 }
+/**
+* Build a request runner bound to one framework's logger storage. The returned
+* function opens a span, creates a request logger, runs `handler` inside the
+* storage so `useLogger()` resolves it, records thrown errors, and emits one
+* wide event when the handler settles (unless `autoEmit` is `false`).
+*/
 function createRequestRunner(storage) {
-  return function runRequest(spanName, enrich, handler, options) {
-    const wrapped = autotel.trace(
-      { name: spanName },
-      (ctx) => async () => {
-        const log = autotel.getRequestLogger(ctx, options?.requestLoggerOptions);
-        enrich(log);
-        try {
-          return await storage.run(log, () => handler());
-        } catch (error) {
-          log.error(error instanceof Error ? error : new Error(String(error)));
-          throw error;
-        } finally {
-          if (options?.autoEmit !== false) {
-            log.emitNow(options?.finalize?.());
-          }
-        }
-      }
-    );
-    return wrapped();
-  };
+	return function runRequest(spanName, enrich, handler, options) {
+		return (0, autotel.trace)({ name: spanName }, (ctx) => async () => {
+			const log = (0, autotel.getRequestLogger)(ctx, options?.requestLoggerOptions);
+			enrich(log);
+			try {
+				return await storage.run(log, () => handler());
+			} catch (error) {
+				log.error(error instanceof Error ? error : new Error(String(error)));
+				throw error;
+			} finally {
+				if (options?.autoEmit !== false) log.emitNow(options?.finalize?.());
+			}
+		})();
+	};
 }
 function createAdapterToolkit(options) {
-  return {
-    useLogger: createUseLogger(options),
-    parseError: autotel.parseError,
-    createStructuredError: autotel.createStructuredError,
-    createDrainPipeline: autotel.createDrainPipeline
-  };
+	return {
+		useLogger: createUseLogger(options),
+		parseError: autotel.parseError,
+		createStructuredError: autotel.createStructuredError,
+		createDrainPipeline: autotel.createDrainPipeline
+	};
 }
 function resolveEnv(envKeys) {
-  if (!envKeys) return void 0;
-  for (const key of envKeys) {
-    const value = process.env[key];
-    if (value) return value;
-  }
-  return void 0;
+	if (!envKeys) return void 0;
+	for (const key of envKeys) {
+		const value = process.env[key];
+		if (value) return value;
+	}
 }
+/**
+* Returns true when at least one env-backed field is not provided via
+* `overrides`, meaning runtime config may still contribute and should be
+* probed to preserve precedence (`overrides > runtime > env`).
+*
+* @example
+* ```ts
+* const FIELDS: ConfigField<MyAdapterConfig>[] = [
+*   { key: 'token', env: ['MY_ADAPTER_TOKEN'] },
+*   { key: 'endpoint', env: ['MY_ADAPTER_URL'] },
+* ]
+*
+* if (shouldProbeRuntime(FIELDS, overrides)) {
+*   runtimeConfig = await loadRuntimeConfig()
+* }
+* ```
+*/
 function shouldProbeRuntime(fields, overrides) {
-  return fields.some(({ key, env }) => {
-    if (!env || env.length === 0) return false;
-    if (overrides?.[key] !== void 0) return false;
-    return true;
-  });
+	return fields.some(({ key, env }) => {
+		if (!env || env.length === 0) return false;
+		if (overrides?.[key] !== void 0) return false;
+		return true;
+	});
 }
+/**
+* Resolve adapter configuration with the standard priority chain:
+*
+* 1. `overrides` passed to the adapter factory
+* 2. `runtimeConfig.autotel.{namespace}.{key}` (if a probe was performed)
+* 3. `runtimeConfig.{namespace}.{key}` (if a probe was performed)
+* 4. `process.env[envKey]` for each env in `field.env`
+*
+* Pass an async `probe` to defer the runtime config lookup so it is only
+* invoked when runtime resolution is needed (i.e. at least one env-backed
+* field is not set by overrides). Adapters that have no probe target may pass
+* `() => Promise.resolve(undefined)`.
+*/
 async function resolveAdapterConfig(namespace, fields, overrides, probe) {
-  const runtimeConfig = shouldProbeRuntime(fields, overrides) ? await probe() : void 0;
-  const autotelNs = runtimeConfig?.autotel?.[namespace];
-  const rootNs = runtimeConfig?.[namespace];
-  const config = {};
-  for (const { key, env } of fields) {
-    config[key] = overrides?.[key] ?? autotelNs?.[key] ?? rootNs?.[key] ?? resolveEnv(env);
-  }
-  return config;
+	const runtimeConfig = shouldProbeRuntime(fields, overrides) ? await probe() : void 0;
+	const autotelNs = runtimeConfig?.autotel?.[namespace];
+	const rootNs = runtimeConfig?.[namespace];
+	const config = {};
+	for (const { key, env } of fields) config[key] = overrides?.[key] ?? autotelNs?.[key] ?? rootNs?.[key] ?? resolveEnv(env);
+	return config;
 }
 function getHeader(headers, name) {
-  if (!headers) return void 0;
-  if ("get" in headers && typeof headers.get === "function") {
-    return headers.get(name) ?? void 0;
-  }
-  const dictionary = headers;
-  const value = dictionary[name] ?? dictionary[name.toLowerCase()];
-  return typeof value === "string" ? value : void 0;
+	if (!headers) return void 0;
+	if ("get" in headers && typeof headers.get === "function") return headers.get(name) ?? void 0;
+	const dictionary = headers;
+	const value = dictionary[name] ?? dictionary[name.toLowerCase()];
+	return typeof value === "string" ? value : void 0;
 }
 
+//#endregion
 exports.createAdapterToolkit = createAdapterToolkit;
 exports.createRequestRunner = createRequestRunner;
 exports.createUseLogger = createUseLogger;
 exports.getHeader = getHeader;
 exports.resolveAdapterConfig = resolveAdapterConfig;
 exports.shouldProbeRuntime = shouldProbeRuntime;
-//# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core.ts"],"names":["getRequestLogger","trace","parseError","createStructuredError","createDrainPipeline"],"mappings":"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","file":"core.cjs","sourcesContent":["import type { AsyncLocalStorage } from 'node:async_hooks';\nimport {\n  createDrainPipeline,\n  createStructuredError,\n  getRequestLogger,\n  parseError,\n  trace,\n  type ParsedError,\n  type RequestLogger,\n  type RequestLoggerOptions,\n  type RequestLogSnapshot,\n  type DrainPipelineOptions,\n  type PipelineDrainFn,\n  type StructuredError,\n  type StructuredErrorInput,\n} from 'autotel';\n\nexport interface AdapterUseLoggerOptions<TContext> {\n  adapterName: string;\n  enrich?: (context: TContext) => Record<string, unknown> | undefined;\n}\n\nexport interface AdapterToolkit<TContext> {\n  useLogger: (\n    context?: TContext,\n    options?: RequestLoggerOptions,\n  ) => RequestLogger;\n  parseError: (error: unknown) => ParsedError;\n  createStructuredError: (input: StructuredErrorInput) => StructuredError;\n  createDrainPipeline: <T = unknown>(\n    options?: DrainPipelineOptions<T>,\n  ) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;\n}\n\nexport function createUseLogger<TContext = unknown>(\n  options: AdapterUseLoggerOptions<TContext>,\n) {\n  return function useLogger(\n    context?: TContext,\n    requestLoggerOptions?: RequestLoggerOptions,\n  ): RequestLogger {\n    let logger: RequestLogger;\n    try {\n      logger = getRequestLogger(undefined, requestLoggerOptions);\n    } catch {\n      throw new Error(\n        `[autotel-adapters/${options.adapterName}] No active trace context. ` +\n          `Wrap your handler with autotel trace instrumentation before calling useLogger().`,\n      );\n    }\n\n    if (context && options.enrich) {\n      const extra = options.enrich(context);\n      if (extra && Object.keys(extra).length > 0) {\n        logger.set(extra);\n      }\n    }\n\n    return logger;\n  };\n}\n\nexport interface RequestRunnerOptions {\n  requestLoggerOptions?: RequestLoggerOptions;\n  /** Emit one wide event automatically when the handler settles. Default `true`. */\n  autoEmit?: boolean;\n  /** Fields merged into the wide event at emit time (e.g. response status). */\n  finalize?: () => Record<string, unknown> | undefined;\n}\n\n/**\n * Build a request runner bound to one framework's logger storage. The returned\n * function opens a span, creates a request logger, runs `handler` inside the\n * storage so `useLogger()` resolves it, records thrown errors, and emits one\n * wide event when the handler settles (unless `autoEmit` is `false`).\n */\nexport function createRequestRunner(storage: AsyncLocalStorage<RequestLogger>) {\n  return function runRequest<T>(\n    spanName: string,\n    enrich: (log: RequestLogger) => void,\n    handler: () => T | Promise<T>,\n    options?: RequestRunnerOptions,\n  ): Promise<T> {\n    const wrapped = trace(\n      { name: spanName },\n      (ctx) => async (): Promise<T> => {\n        const log = getRequestLogger(ctx, options?.requestLoggerOptions);\n        enrich(log);\n        try {\n          return await storage.run(log, () => handler());\n        } catch (error) {\n          log.error(error instanceof Error ? error : new Error(String(error)));\n          throw error;\n        } finally {\n          if (options?.autoEmit !== false) {\n            log.emitNow(options?.finalize?.());\n          }\n        }\n      },\n    );\n    return wrapped();\n  };\n}\n\nexport function createAdapterToolkit<TContext = unknown>(\n  options: AdapterUseLoggerOptions<TContext>,\n): AdapterToolkit<TContext> {\n  return {\n    useLogger: createUseLogger(options),\n    parseError,\n    createStructuredError,\n    createDrainPipeline,\n  };\n}\n\n/**\n * Description of a single adapter config field. `env` is the ordered list of\n * environment variables to fall back to.\n */\nexport interface ConfigField<T> {\n  key: keyof T & string;\n  env?: string[];\n}\n\nfunction resolveEnv(envKeys?: string[]): string | undefined {\n  if (!envKeys) return undefined;\n  for (const key of envKeys) {\n    const value = process.env[key];\n    if (value) return value;\n  }\n  return undefined;\n}\n\n/**\n * Returns true when at least one env-backed field is not provided via\n * `overrides`, meaning runtime config may still contribute and should be\n * probed to preserve precedence (`overrides > runtime > env`).\n *\n * @example\n * ```ts\n * const FIELDS: ConfigField<MyAdapterConfig>[] = [\n *   { key: 'token', env: ['MY_ADAPTER_TOKEN'] },\n *   { key: 'endpoint', env: ['MY_ADAPTER_URL'] },\n * ]\n *\n * if (shouldProbeRuntime(FIELDS, overrides)) {\n *   runtimeConfig = await loadRuntimeConfig()\n * }\n * ```\n */\nexport function shouldProbeRuntime<T>(\n  fields: ConfigField<T>[],\n  overrides?: Partial<T>,\n): boolean {\n  return fields.some(({ key, env }) => {\n    if (!env || env.length === 0) return false;\n    if (overrides?.[key] !== undefined) return false;\n    return true;\n  });\n}\n\n/**\n * Resolve adapter configuration with the standard priority chain:\n *\n * 1. `overrides` passed to the adapter factory\n * 2. `runtimeConfig.autotel.{namespace}.{key}` (if a probe was performed)\n * 3. `runtimeConfig.{namespace}.{key}` (if a probe was performed)\n * 4. `process.env[envKey]` for each env in `field.env`\n *\n * Pass an async `probe` to defer the runtime config lookup so it is only\n * invoked when runtime resolution is needed (i.e. at least one env-backed\n * field is not set by overrides). Adapters that have no probe target may pass\n * `() => Promise.resolve(undefined)`.\n */\nexport async function resolveAdapterConfig<T>(\n  namespace: string,\n  fields: ConfigField<T>[],\n  overrides: Partial<T> | undefined,\n  probe: () => Promise<Record<string, any> | undefined>,\n): Promise<Partial<T>> {\n  const runtimeConfig = shouldProbeRuntime(fields, overrides)\n    ? await probe()\n    : undefined;\n  const autotelNs = runtimeConfig?.autotel?.[namespace];\n  const rootNs = runtimeConfig?.[namespace];\n\n  const config: Record<string, unknown> = {};\n  for (const { key, env } of fields) {\n    config[key] =\n      overrides?.[key] ??\n      autotelNs?.[key] ??\n      rootNs?.[key] ??\n      resolveEnv(env);\n  }\n\n  return config as Partial<T>;\n}\n\nexport type HeadersLike =\n  | { get(name: string): string | null }\n  | Record<string, string | undefined>;\n\nexport function getHeader(\n  headers: HeadersLike | undefined,\n  name: string,\n): string | undefined {\n  if (!headers) return undefined;\n  if ('get' in headers && typeof headers.get === 'function') {\n    return headers.get(name) ?? undefined;\n  }\n  const dictionary = headers as Record<string, string | undefined>;\n  const value = dictionary[name] ?? dictionary[name.toLowerCase()];\n  return typeof value === 'string' ? value : undefined;\n}\n\nexport type {\n  RequestLogger,\n  RequestLoggerOptions,\n  RequestLogSnapshot,\n  ParsedError,\n  StructuredError,\n  StructuredErrorInput,\n  DrainPipelineOptions,\n  PipelineDrainFn,\n};\n"]}
+{"version":3,"file":"core.cjs","names":[],"sources":["../src/core.ts"],"sourcesContent":["import type { AsyncLocalStorage } from 'node:async_hooks';\nimport {\n  createDrainPipeline,\n  createStructuredError,\n  getRequestLogger,\n  parseError,\n  trace,\n  type ParsedError,\n  type RequestLogger,\n  type RequestLoggerOptions,\n  type RequestLogSnapshot,\n  type DrainPipelineOptions,\n  type PipelineDrainFn,\n  type StructuredError,\n  type StructuredErrorInput,\n} from 'autotel';\n\nexport interface AdapterUseLoggerOptions<TContext> {\n  adapterName: string;\n  enrich?: (context: TContext) => Record<string, unknown> | undefined;\n}\n\nexport interface AdapterToolkit<TContext> {\n  useLogger: (\n    context?: TContext,\n    options?: RequestLoggerOptions,\n  ) => RequestLogger;\n  parseError: (error: unknown) => ParsedError;\n  createStructuredError: (input: StructuredErrorInput) => StructuredError;\n  createDrainPipeline: <T = unknown>(\n    options?: DrainPipelineOptions<T>,\n  ) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;\n}\n\nexport function createUseLogger<TContext = unknown>(\n  options: AdapterUseLoggerOptions<TContext>,\n) {\n  return function useLogger(\n    context?: TContext,\n    requestLoggerOptions?: RequestLoggerOptions,\n  ): RequestLogger {\n    let logger: RequestLogger;\n    try {\n      logger = getRequestLogger(undefined, requestLoggerOptions);\n    } catch {\n      throw new Error(\n        `[autotel-adapters/${options.adapterName}] No active trace context. ` +\n          `Wrap your handler with autotel trace instrumentation before calling useLogger().`,\n      );\n    }\n\n    if (context && options.enrich) {\n      const extra = options.enrich(context);\n      if (extra && Object.keys(extra).length > 0) {\n        logger.set(extra);\n      }\n    }\n\n    return logger;\n  };\n}\n\nexport interface RequestRunnerOptions {\n  requestLoggerOptions?: RequestLoggerOptions;\n  /** Emit one wide event automatically when the handler settles. Default `true`. */\n  autoEmit?: boolean;\n  /** Fields merged into the wide event at emit time (e.g. response status). */\n  finalize?: () => Record<string, unknown> | undefined;\n}\n\n/**\n * Build a request runner bound to one framework's logger storage. The returned\n * function opens a span, creates a request logger, runs `handler` inside the\n * storage so `useLogger()` resolves it, records thrown errors, and emits one\n * wide event when the handler settles (unless `autoEmit` is `false`).\n */\nexport function createRequestRunner(storage: AsyncLocalStorage<RequestLogger>) {\n  return function runRequest<T>(\n    spanName: string,\n    enrich: (log: RequestLogger) => void,\n    handler: () => T | Promise<T>,\n    options?: RequestRunnerOptions,\n  ): Promise<T> {\n    const wrapped = trace(\n      { name: spanName },\n      (ctx) => async (): Promise<T> => {\n        const log = getRequestLogger(ctx, options?.requestLoggerOptions);\n        enrich(log);\n        try {\n          return await storage.run(log, () => handler());\n        } catch (error) {\n          log.error(error instanceof Error ? error : new Error(String(error)));\n          throw error;\n        } finally {\n          if (options?.autoEmit !== false) {\n            log.emitNow(options?.finalize?.());\n          }\n        }\n      },\n    );\n    return wrapped();\n  };\n}\n\nexport function createAdapterToolkit<TContext = unknown>(\n  options: AdapterUseLoggerOptions<TContext>,\n): AdapterToolkit<TContext> {\n  return {\n    useLogger: createUseLogger(options),\n    parseError,\n    createStructuredError,\n    createDrainPipeline,\n  };\n}\n\n/**\n * Description of a single adapter config field. `env` is the ordered list of\n * environment variables to fall back to.\n */\nexport interface ConfigField<T> {\n  key: keyof T & string;\n  env?: string[];\n}\n\nfunction resolveEnv(envKeys?: string[]): string | undefined {\n  if (!envKeys) return undefined;\n  for (const key of envKeys) {\n    const value = process.env[key];\n    if (value) return value;\n  }\n  return undefined;\n}\n\n/**\n * Returns true when at least one env-backed field is not provided via\n * `overrides`, meaning runtime config may still contribute and should be\n * probed to preserve precedence (`overrides > runtime > env`).\n *\n * @example\n * ```ts\n * const FIELDS: ConfigField<MyAdapterConfig>[] = [\n *   { key: 'token', env: ['MY_ADAPTER_TOKEN'] },\n *   { key: 'endpoint', env: ['MY_ADAPTER_URL'] },\n * ]\n *\n * if (shouldProbeRuntime(FIELDS, overrides)) {\n *   runtimeConfig = await loadRuntimeConfig()\n * }\n * ```\n */\nexport function shouldProbeRuntime<T>(\n  fields: ConfigField<T>[],\n  overrides?: Partial<T>,\n): boolean {\n  return fields.some(({ key, env }) => {\n    if (!env || env.length === 0) return false;\n    if (overrides?.[key] !== undefined) return false;\n    return true;\n  });\n}\n\n/**\n * Resolve adapter configuration with the standard priority chain:\n *\n * 1. `overrides` passed to the adapter factory\n * 2. `runtimeConfig.autotel.{namespace}.{key}` (if a probe was performed)\n * 3. `runtimeConfig.{namespace}.{key}` (if a probe was performed)\n * 4. `process.env[envKey]` for each env in `field.env`\n *\n * Pass an async `probe` to defer the runtime config lookup so it is only\n * invoked when runtime resolution is needed (i.e. at least one env-backed\n * field is not set by overrides). Adapters that have no probe target may pass\n * `() => Promise.resolve(undefined)`.\n */\nexport async function resolveAdapterConfig<T>(\n  namespace: string,\n  fields: ConfigField<T>[],\n  overrides: Partial<T> | undefined,\n  probe: () => Promise<Record<string, any> | undefined>,\n): Promise<Partial<T>> {\n  const runtimeConfig = shouldProbeRuntime(fields, overrides)\n    ? await probe()\n    : undefined;\n  const autotelNs = runtimeConfig?.autotel?.[namespace];\n  const rootNs = runtimeConfig?.[namespace];\n\n  const config: Record<string, unknown> = {};\n  for (const { key, env } of fields) {\n    config[key] =\n      overrides?.[key] ??\n      autotelNs?.[key] ??\n      rootNs?.[key] ??\n      resolveEnv(env);\n  }\n\n  return config as Partial<T>;\n}\n\nexport type HeadersLike =\n  | { get(name: string): string | null }\n  | Record<string, string | undefined>;\n\nexport function getHeader(\n  headers: HeadersLike | undefined,\n  name: string,\n): string | undefined {\n  if (!headers) return undefined;\n  if ('get' in headers && typeof headers.get === 'function') {\n    return headers.get(name) ?? undefined;\n  }\n  const dictionary = headers as Record<string, string | undefined>;\n  const value = dictionary[name] ?? dictionary[name.toLowerCase()];\n  return typeof value === 'string' ? value : undefined;\n}\n\nexport type {\n  RequestLogger,\n  RequestLoggerOptions,\n  RequestLogSnapshot,\n  ParsedError,\n  StructuredError,\n  StructuredErrorInput,\n  DrainPipelineOptions,\n  PipelineDrainFn,\n};\n"],"mappings":";;;;AAkCA,SAAgB,gBACd,SACA;CACA,OAAO,SAAS,UACd,SACA,sBACe;EACf,IAAI;EACJ,IAAI;GACF,uCAA0B,QAAW,oBAAoB;EAC3D,QAAQ;GACN,MAAM,IAAI,MACR,qBAAqB,QAAQ,YAAY,4GAE3C;EACF;EAEA,IAAI,WAAW,QAAQ,QAAQ;GAC7B,MAAM,QAAQ,QAAQ,OAAO,OAAO;GACpC,IAAI,SAAS,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GACvC,OAAO,IAAI,KAAK;EAEpB;EAEA,OAAO;CACT;AACF;;;;;;;AAgBA,SAAgB,oBAAoB,SAA2C;CAC7E,OAAO,SAAS,WACd,UACA,QACA,SACA,SACY;EAkBZ,0BAhBE,EAAE,MAAM,SAAS,IAChB,QAAQ,YAAwB;GAC/B,MAAM,oCAAuB,KAAK,SAAS,oBAAoB;GAC/D,OAAO,GAAG;GACV,IAAI;IACF,OAAO,MAAM,QAAQ,IAAI,WAAW,QAAQ,CAAC;GAC/C,SAAS,OAAO;IACd,IAAI,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CAAC;IACnE,MAAM;GACR,UAAU;IACR,IAAI,SAAS,aAAa,OACxB,IAAI,QAAQ,SAAS,WAAW,CAAC;GAErC;EACF,CAEW,CAAC,CAAC;CACjB;AACF;AAEA,SAAgB,qBACd,SAC0B;CAC1B,OAAO;EACL,WAAW,gBAAgB,OAAO;EAClC;EACA;EACA;CACF;AACF;AAWA,SAAS,WAAW,SAAwC;CAC1D,IAAI,CAAC,SAAS,OAAO;CACrB,KAAK,MAAM,OAAO,SAAS;EACzB,MAAM,QAAQ,QAAQ,IAAI;EAC1B,IAAI,OAAO,OAAO;CACpB;AAEF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,mBACd,QACA,WACS;CACT,OAAO,OAAO,MAAM,EAAE,KAAK,UAAU;EACnC,IAAI,CAAC,OAAO,IAAI,WAAW,GAAG,OAAO;EACrC,IAAI,YAAY,SAAS,QAAW,OAAO;EAC3C,OAAO;CACT,CAAC;AACH;;;;;;;;;;;;;;AAeA,eAAsB,qBACpB,WACA,QACA,WACA,OACqB;CACrB,MAAM,gBAAgB,mBAAmB,QAAQ,SAAS,IACtD,MAAM,MAAM,IACZ;CACJ,MAAM,YAAY,eAAe,UAAU;CAC3C,MAAM,SAAS,gBAAgB;CAE/B,MAAM,SAAkC,CAAC;CACzC,KAAK,MAAM,EAAE,KAAK,SAAS,QACzB,OAAO,OACL,YAAY,QACZ,YAAY,QACZ,SAAS,QACT,WAAW,GAAG;CAGlB,OAAO;AACT;AAMA,SAAgB,UACd,SACA,MACoB;CACpB,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,YAC7C,OAAO,QAAQ,IAAI,IAAI,KAAK;CAE9B,MAAM,aAAa;CACnB,MAAM,QAAQ,WAAW,SAAS,WAAW,KAAK,YAAY;CAC9D,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C"}

package/dist/core.d.cts

@@ -1,24 +1,24 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { RequestLoggerOptions, RequestLogger, ParsedError, StructuredErrorInput, StructuredError, DrainPipelineOptions, PipelineDrainFn } from 'autotel';
-export { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogSnapshot, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput } from 'autotel';
+import { AsyncLocalStorage } from "node:async_hooks";
+import { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogSnapshot, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput } from "autotel";
 
+//#region src/core.d.ts
 interface AdapterUseLoggerOptions<TContext> {
-    adapterName: string;
-    enrich?: (context: TContext) => Record<string, unknown> | undefined;
+  adapterName: string;
+  enrich?: (context: TContext) => Record<string, unknown> | undefined;
 }
 interface AdapterToolkit<TContext> {
-    useLogger: (context?: TContext, options?: RequestLoggerOptions) => RequestLogger;
-    parseError: (error: unknown) => ParsedError;
-    createStructuredError: (input: StructuredErrorInput) => StructuredError;
-    createDrainPipeline: <T = unknown>(options?: DrainPipelineOptions<T>) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;
+  useLogger: (context?: TContext, options?: RequestLoggerOptions) => RequestLogger;
+  parseError: (error: unknown) => ParsedError;
+  createStructuredError: (input: StructuredErrorInput) => StructuredError;
+  createDrainPipeline: <T = unknown>(options?: DrainPipelineOptions<T>) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;
 }
 declare function createUseLogger<TContext = unknown>(options: AdapterUseLoggerOptions<TContext>): (context?: TContext, requestLoggerOptions?: RequestLoggerOptions) => RequestLogger;
 interface RequestRunnerOptions {
-    requestLoggerOptions?: RequestLoggerOptions;
-    /** Emit one wide event automatically when the handler settles. Default `true`. */
-    autoEmit?: boolean;
-    /** Fields merged into the wide event at emit time (e.g. response status). */
-    finalize?: () => Record<string, unknown> | undefined;
+  requestLoggerOptions?: RequestLoggerOptions;
+  /** Emit one wide event automatically when the handler settles. Default `true`. */
+  autoEmit?: boolean;
+  /** Fields merged into the wide event at emit time (e.g. response status). */
+  finalize?: () => Record<string, unknown> | undefined;
 }
 /**
  * Build a request runner bound to one framework's logger storage. The returned
@@ -33,8 +33,8 @@ declare function createAdapterToolkit<TContext = unknown>(options: AdapterUseLog
  * environment variables to fall back to.
  */
 interface ConfigField<T> {
-    key: keyof T & string;
-    env?: string[];
+  key: keyof T & string;
+  env?: string[];
 }
 /**
  * Returns true when at least one env-backed field is not provided via
@@ -69,8 +69,9 @@ declare function shouldProbeRuntime<T>(fields: ConfigField<T>[], overrides?: Par
  */
 declare function resolveAdapterConfig<T>(namespace: string, fields: ConfigField<T>[], overrides: Partial<T> | undefined, probe: () => Promise<Record<string, any> | undefined>): Promise<Partial<T>>;
 type HeadersLike = {
-    get(name: string): string | null;
+  get(name: string): string | null;
 } | Record<string, string | undefined>;
 declare function getHeader(headers: HeadersLike | undefined, name: string): string | undefined;
-
-export { type AdapterToolkit, type AdapterUseLoggerOptions, type ConfigField, type HeadersLike, type RequestRunnerOptions, createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
+//#endregion
+export { AdapterToolkit, AdapterUseLoggerOptions, ConfigField, type DrainPipelineOptions, HeadersLike, type ParsedError, type PipelineDrainFn, type RequestLogSnapshot, type RequestLogger, type RequestLoggerOptions, RequestRunnerOptions, type StructuredError, type StructuredErrorInput, createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
+//# sourceMappingURL=core.d.cts.map

package/dist/core.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.cts","names":[],"sources":["../src/core.ts"],"mappings":";;;;UAiBiB,uBAAA;EACf,WAAA;EACA,MAAA,IAAU,OAAA,EAAS,QAAA,KAAa,MAAM;AAAA;AAAA,UAGvB,cAAA;EACf,SAAA,GACE,OAAA,GAAU,QAAA,EACV,OAAA,GAAU,oBAAA,KACP,aAAA;EACL,UAAA,GAAa,KAAA,cAAmB,WAAA;EAChC,qBAAA,GAAwB,KAAA,EAAO,oBAAA,KAAyB,eAAA;EACxD,mBAAA,gBACE,OAAA,GAAU,oBAAA,CAAqB,CAAA,OAC3B,KAAA,GAAQ,KAAA,EAAO,CAAA,cAAe,OAAA,WAAkB,eAAA,CAAgB,CAAA;AAAA;AAAA,iBAGxD,eAAA,qBACd,OAAA,EAAS,uBAAA,CAAwB,QAAA,KAG/B,OAAA,GAAU,QAAA,EACV,oBAAA,GAAuB,oBAAA,KACtB,aAAA;AAAA,UAsBY,oBAAA;EACf,oBAAA,GAAuB,oBAAA;EA5Ce;EA8CtC,QAAA;EA3C6B;EA6C7B,QAAA,SAAiB,MAAM;AAAA;;;;;;;iBAST,mBAAA,CAAoB,OAAA,EAAS,iBAAA,CAAkB,aAAA,QAE3D,QAAA,UACA,MAAA,GAAS,GAAA,EAAK,aAAA,WACd,OAAA,QAAe,CAAA,GAAI,OAAA,CAAQ,CAAA,GAC3B,OAAA,GAAU,oBAAA,KACT,OAAA,CAAQ,CAAA;AAAA,iBAsBG,oBAAA,qBACd,OAAA,EAAS,uBAAA,CAAwB,QAAA,IAChC,cAAA,CAAe,QAAA;;;;;UAaD,WAAA;EACf,GAAA,QAAW,CAAC;EACZ,GAAA;AAAA;;;;;;;;;;;;;;;;;;iBA6Bc,kBAAA,IACd,MAAA,EAAQ,WAAA,CAAY,CAAA,KACpB,SAAA,GAAY,OAAA,CAAQ,CAAA;;;;;;AAzHmD;AAGzE;;;;;;;iBA4IsB,oBAAA,IACpB,SAAA,UACA,MAAA,EAAQ,WAAA,CAAY,CAAA,KACpB,SAAA,EAAW,OAAA,CAAQ,CAAA,eACnB,KAAA,QAAa,OAAA,CAAQ,MAAA,6BACpB,OAAA,CAAQ,OAAA,CAAQ,CAAA;AAAA,KAmBP,WAAA;EACN,GAAA,CAAI,IAAA;AAAA,IACN,MAAM;AAAA,iBAEM,SAAA,CACd,OAAA,EAAS,WAAW,cACpB,IAAA"}

package/dist/core.d.ts

@@ -1,24 +1,24 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { RequestLoggerOptions, RequestLogger, ParsedError, StructuredErrorInput, StructuredError, DrainPipelineOptions, PipelineDrainFn } from 'autotel';
-export { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogSnapshot, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput } from 'autotel';
+import { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogSnapshot, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput } from "autotel";
+import { AsyncLocalStorage } from "node:async_hooks";
 
+//#region src/core.d.ts
 interface AdapterUseLoggerOptions<TContext> {
-    adapterName: string;
-    enrich?: (context: TContext) => Record<string, unknown> | undefined;
+  adapterName: string;
+  enrich?: (context: TContext) => Record<string, unknown> | undefined;
 }
 interface AdapterToolkit<TContext> {
-    useLogger: (context?: TContext, options?: RequestLoggerOptions) => RequestLogger;
-    parseError: (error: unknown) => ParsedError;
-    createStructuredError: (input: StructuredErrorInput) => StructuredError;
-    createDrainPipeline: <T = unknown>(options?: DrainPipelineOptions<T>) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;
+  useLogger: (context?: TContext, options?: RequestLoggerOptions) => RequestLogger;
+  parseError: (error: unknown) => ParsedError;
+  createStructuredError: (input: StructuredErrorInput) => StructuredError;
+  createDrainPipeline: <T = unknown>(options?: DrainPipelineOptions<T>) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;
 }
 declare function createUseLogger<TContext = unknown>(options: AdapterUseLoggerOptions<TContext>): (context?: TContext, requestLoggerOptions?: RequestLoggerOptions) => RequestLogger;
 interface RequestRunnerOptions {
-    requestLoggerOptions?: RequestLoggerOptions;
-    /** Emit one wide event automatically when the handler settles. Default `true`. */
-    autoEmit?: boolean;
-    /** Fields merged into the wide event at emit time (e.g. response status). */
-    finalize?: () => Record<string, unknown> | undefined;
+  requestLoggerOptions?: RequestLoggerOptions;
+  /** Emit one wide event automatically when the handler settles. Default `true`. */
+  autoEmit?: boolean;
+  /** Fields merged into the wide event at emit time (e.g. response status). */
+  finalize?: () => Record<string, unknown> | undefined;
 }
 /**
  * Build a request runner bound to one framework's logger storage. The returned
@@ -33,8 +33,8 @@ declare function createAdapterToolkit<TContext = unknown>(options: AdapterUseLog
  * environment variables to fall back to.
  */
 interface ConfigField<T> {
-    key: keyof T & string;
-    env?: string[];
+  key: keyof T & string;
+  env?: string[];
 }
 /**
  * Returns true when at least one env-backed field is not provided via
@@ -69,8 +69,9 @@ declare function shouldProbeRuntime<T>(fields: ConfigField<T>[], overrides?: Par
  */
 declare function resolveAdapterConfig<T>(namespace: string, fields: ConfigField<T>[], overrides: Partial<T> | undefined, probe: () => Promise<Record<string, any> | undefined>): Promise<Partial<T>>;
 type HeadersLike = {
-    get(name: string): string | null;
+  get(name: string): string | null;
 } | Record<string, string | undefined>;
 declare function getHeader(headers: HeadersLike | undefined, name: string): string | undefined;
-
-export { type AdapterToolkit, type AdapterUseLoggerOptions, type ConfigField, type HeadersLike, type RequestRunnerOptions, createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
+//#endregion
+export { AdapterToolkit, AdapterUseLoggerOptions, ConfigField, type DrainPipelineOptions, HeadersLike, type ParsedError, type PipelineDrainFn, type RequestLogSnapshot, type RequestLogger, type RequestLoggerOptions, RequestRunnerOptions, type StructuredError, type StructuredErrorInput, createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","names":[],"sources":["../src/core.ts"],"mappings":";;;;UAiBiB,uBAAA;EACf,WAAA;EACA,MAAA,IAAU,OAAA,EAAS,QAAA,KAAa,MAAM;AAAA;AAAA,UAGvB,cAAA;EACf,SAAA,GACE,OAAA,GAAU,QAAA,EACV,OAAA,GAAU,oBAAA,KACP,aAAA;EACL,UAAA,GAAa,KAAA,cAAmB,WAAA;EAChC,qBAAA,GAAwB,KAAA,EAAO,oBAAA,KAAyB,eAAA;EACxD,mBAAA,gBACE,OAAA,GAAU,oBAAA,CAAqB,CAAA,OAC3B,KAAA,GAAQ,KAAA,EAAO,CAAA,cAAe,OAAA,WAAkB,eAAA,CAAgB,CAAA;AAAA;AAAA,iBAGxD,eAAA,qBACd,OAAA,EAAS,uBAAA,CAAwB,QAAA,KAG/B,OAAA,GAAU,QAAA,EACV,oBAAA,GAAuB,oBAAA,KACtB,aAAA;AAAA,UAsBY,oBAAA;EACf,oBAAA,GAAuB,oBAAA;EA5Ce;EA8CtC,QAAA;EA3C6B;EA6C7B,QAAA,SAAiB,MAAM;AAAA;;;;;;;iBAST,mBAAA,CAAoB,OAAA,EAAS,iBAAA,CAAkB,aAAA,QAE3D,QAAA,UACA,MAAA,GAAS,GAAA,EAAK,aAAA,WACd,OAAA,QAAe,CAAA,GAAI,OAAA,CAAQ,CAAA,GAC3B,OAAA,GAAU,oBAAA,KACT,OAAA,CAAQ,CAAA;AAAA,iBAsBG,oBAAA,qBACd,OAAA,EAAS,uBAAA,CAAwB,QAAA,IAChC,cAAA,CAAe,QAAA;;;;;UAaD,WAAA;EACf,GAAA,QAAW,CAAC;EACZ,GAAA;AAAA;;;;;;;;;;;;;;;;;;iBA6Bc,kBAAA,IACd,MAAA,EAAQ,WAAA,CAAY,CAAA,KACpB,SAAA,GAAY,OAAA,CAAQ,CAAA;;;;;;AAzHmD;AAGzE;;;;;;;iBA4IsB,oBAAA,IACpB,SAAA,UACA,MAAA,EAAQ,WAAA,CAAY,CAAA,KACpB,SAAA,EAAW,OAAA,CAAQ,CAAA,eACnB,KAAA,QAAa,OAAA,CAAQ,MAAA,6BACpB,OAAA,CAAQ,OAAA,CAAQ,CAAA;AAAA,KAmBP,WAAA;EACN,GAAA,CAAI,IAAA;AAAA,IACN,MAAM;AAAA,iBAEM,SAAA,CACd,OAAA,EAAS,WAAW,cACpB,IAAA"}

package/dist/core.js

@@ -1,3 +1,111 @@
-export { createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime } from './chunk-DJ2OU3S6.js';
-//# sourceMappingURL=core.js.map
+import { createDrainPipeline, createStructuredError, getRequestLogger, parseError, trace } from "autotel";
+
+//#region src/core.ts
+function createUseLogger(options) {
+	return function useLogger(context, requestLoggerOptions) {
+		let logger;
+		try {
+			logger = getRequestLogger(void 0, requestLoggerOptions);
+		} catch {
+			throw new Error(`[autotel-adapters/${options.adapterName}] No active trace context. Wrap your handler with autotel trace instrumentation before calling useLogger().`);
+		}
+		if (context && options.enrich) {
+			const extra = options.enrich(context);
+			if (extra && Object.keys(extra).length > 0) logger.set(extra);
+		}
+		return logger;
+	};
+}
+/**
+* Build a request runner bound to one framework's logger storage. The returned
+* function opens a span, creates a request logger, runs `handler` inside the
+* storage so `useLogger()` resolves it, records thrown errors, and emits one
+* wide event when the handler settles (unless `autoEmit` is `false`).
+*/
+function createRequestRunner(storage) {
+	return function runRequest(spanName, enrich, handler, options) {
+		return trace({ name: spanName }, (ctx) => async () => {
+			const log = getRequestLogger(ctx, options?.requestLoggerOptions);
+			enrich(log);
+			try {
+				return await storage.run(log, () => handler());
+			} catch (error) {
+				log.error(error instanceof Error ? error : new Error(String(error)));
+				throw error;
+			} finally {
+				if (options?.autoEmit !== false) log.emitNow(options?.finalize?.());
+			}
+		})();
+	};
+}
+function createAdapterToolkit(options) {
+	return {
+		useLogger: createUseLogger(options),
+		parseError,
+		createStructuredError,
+		createDrainPipeline
+	};
+}
+function resolveEnv(envKeys) {
+	if (!envKeys) return void 0;
+	for (const key of envKeys) {
+		const value = process.env[key];
+		if (value) return value;
+	}
+}
+/**
+* Returns true when at least one env-backed field is not provided via
+* `overrides`, meaning runtime config may still contribute and should be
+* probed to preserve precedence (`overrides > runtime > env`).
+*
+* @example
+* ```ts
+* const FIELDS: ConfigField<MyAdapterConfig>[] = [
+*   { key: 'token', env: ['MY_ADAPTER_TOKEN'] },
+*   { key: 'endpoint', env: ['MY_ADAPTER_URL'] },
+* ]
+*
+* if (shouldProbeRuntime(FIELDS, overrides)) {
+*   runtimeConfig = await loadRuntimeConfig()
+* }
+* ```
+*/
+function shouldProbeRuntime(fields, overrides) {
+	return fields.some(({ key, env }) => {
+		if (!env || env.length === 0) return false;
+		if (overrides?.[key] !== void 0) return false;
+		return true;
+	});
+}
+/**
+* Resolve adapter configuration with the standard priority chain:
+*
+* 1. `overrides` passed to the adapter factory
+* 2. `runtimeConfig.autotel.{namespace}.{key}` (if a probe was performed)
+* 3. `runtimeConfig.{namespace}.{key}` (if a probe was performed)
+* 4. `process.env[envKey]` for each env in `field.env`
+*
+* Pass an async `probe` to defer the runtime config lookup so it is only
+* invoked when runtime resolution is needed (i.e. at least one env-backed
+* field is not set by overrides). Adapters that have no probe target may pass
+* `() => Promise.resolve(undefined)`.
+*/
+async function resolveAdapterConfig(namespace, fields, overrides, probe) {
+	const runtimeConfig = shouldProbeRuntime(fields, overrides) ? await probe() : void 0;
+	const autotelNs = runtimeConfig?.autotel?.[namespace];
+	const rootNs = runtimeConfig?.[namespace];
+	const config = {};
+	for (const { key, env } of fields) config[key] = overrides?.[key] ?? autotelNs?.[key] ?? rootNs?.[key] ?? resolveEnv(env);
+	return config;
+}
+function getHeader(headers, name) {
+	if (!headers) return void 0;
+	if ("get" in headers && typeof headers.get === "function") return headers.get(name) ?? void 0;
+	const dictionary = headers;
+	const value = dictionary[name] ?? dictionary[name.toLowerCase()];
+	return typeof value === "string" ? value : void 0;
+}
+
+//#endregion
+export { createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"core.js"}
+{"version":3,"file":"core.js","names":[],"sources":["../src/core.ts"],"sourcesContent":["import type { AsyncLocalStorage } from 'node:async_hooks';\nimport {\n  createDrainPipeline,\n  createStructuredError,\n  getRequestLogger,\n  parseError,\n  trace,\n  type ParsedError,\n  type RequestLogger,\n  type RequestLoggerOptions,\n  type RequestLogSnapshot,\n  type DrainPipelineOptions,\n  type PipelineDrainFn,\n  type StructuredError,\n  type StructuredErrorInput,\n} from 'autotel';\n\nexport interface AdapterUseLoggerOptions<TContext> {\n  adapterName: string;\n  enrich?: (context: TContext) => Record<string, unknown> | undefined;\n}\n\nexport interface AdapterToolkit<TContext> {\n  useLogger: (\n    context?: TContext,\n    options?: RequestLoggerOptions,\n  ) => RequestLogger;\n  parseError: (error: unknown) => ParsedError;\n  createStructuredError: (input: StructuredErrorInput) => StructuredError;\n  createDrainPipeline: <T = unknown>(\n    options?: DrainPipelineOptions<T>,\n  ) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;\n}\n\nexport function createUseLogger<TContext = unknown>(\n  options: AdapterUseLoggerOptions<TContext>,\n) {\n  return function useLogger(\n    context?: TContext,\n    requestLoggerOptions?: RequestLoggerOptions,\n  ): RequestLogger {\n    let logger: RequestLogger;\n    try {\n      logger = getRequestLogger(undefined, requestLoggerOptions);\n    } catch {\n      throw new Error(\n        `[autotel-adapters/${options.adapterName}] No active trace context. ` +\n          `Wrap your handler with autotel trace instrumentation before calling useLogger().`,\n      );\n    }\n\n    if (context && options.enrich) {\n      const extra = options.enrich(context);\n      if (extra && Object.keys(extra).length > 0) {\n        logger.set(extra);\n      }\n    }\n\n    return logger;\n  };\n}\n\nexport interface RequestRunnerOptions {\n  requestLoggerOptions?: RequestLoggerOptions;\n  /** Emit one wide event automatically when the handler settles. Default `true`. */\n  autoEmit?: boolean;\n  /** Fields merged into the wide event at emit time (e.g. response status). */\n  finalize?: () => Record<string, unknown> | undefined;\n}\n\n/**\n * Build a request runner bound to one framework's logger storage. The returned\n * function opens a span, creates a request logger, runs `handler` inside the\n * storage so `useLogger()` resolves it, records thrown errors, and emits one\n * wide event when the handler settles (unless `autoEmit` is `false`).\n */\nexport function createRequestRunner(storage: AsyncLocalStorage<RequestLogger>) {\n  return function runRequest<T>(\n    spanName: string,\n    enrich: (log: RequestLogger) => void,\n    handler: () => T | Promise<T>,\n    options?: RequestRunnerOptions,\n  ): Promise<T> {\n    const wrapped = trace(\n      { name: spanName },\n      (ctx) => async (): Promise<T> => {\n        const log = getRequestLogger(ctx, options?.requestLoggerOptions);\n        enrich(log);\n        try {\n          return await storage.run(log, () => handler());\n        } catch (error) {\n          log.error(error instanceof Error ? error : new Error(String(error)));\n          throw error;\n        } finally {\n          if (options?.autoEmit !== false) {\n            log.emitNow(options?.finalize?.());\n          }\n        }\n      },\n    );\n    return wrapped();\n  };\n}\n\nexport function createAdapterToolkit<TContext = unknown>(\n  options: AdapterUseLoggerOptions<TContext>,\n): AdapterToolkit<TContext> {\n  return {\n    useLogger: createUseLogger(options),\n    parseError,\n    createStructuredError,\n    createDrainPipeline,\n  };\n}\n\n/**\n * Description of a single adapter config field. `env` is the ordered list of\n * environment variables to fall back to.\n */\nexport interface ConfigField<T> {\n  key: keyof T & string;\n  env?: string[];\n}\n\nfunction resolveEnv(envKeys?: string[]): string | undefined {\n  if (!envKeys) return undefined;\n  for (const key of envKeys) {\n    const value = process.env[key];\n    if (value) return value;\n  }\n  return undefined;\n}\n\n/**\n * Returns true when at least one env-backed field is not provided via\n * `overrides`, meaning runtime config may still contribute and should be\n * probed to preserve precedence (`overrides > runtime > env`).\n *\n * @example\n * ```ts\n * const FIELDS: ConfigField<MyAdapterConfig>[] = [\n *   { key: 'token', env: ['MY_ADAPTER_TOKEN'] },\n *   { key: 'endpoint', env: ['MY_ADAPTER_URL'] },\n * ]\n *\n * if (shouldProbeRuntime(FIELDS, overrides)) {\n *   runtimeConfig = await loadRuntimeConfig()\n * }\n * ```\n */\nexport function shouldProbeRuntime<T>(\n  fields: ConfigField<T>[],\n  overrides?: Partial<T>,\n): boolean {\n  return fields.some(({ key, env }) => {\n    if (!env || env.length === 0) return false;\n    if (overrides?.[key] !== undefined) return false;\n    return true;\n  });\n}\n\n/**\n * Resolve adapter configuration with the standard priority chain:\n *\n * 1. `overrides` passed to the adapter factory\n * 2. `runtimeConfig.autotel.{namespace}.{key}` (if a probe was performed)\n * 3. `runtimeConfig.{namespace}.{key}` (if a probe was performed)\n * 4. `process.env[envKey]` for each env in `field.env`\n *\n * Pass an async `probe` to defer the runtime config lookup so it is only\n * invoked when runtime resolution is needed (i.e. at least one env-backed\n * field is not set by overrides). Adapters that have no probe target may pass\n * `() => Promise.resolve(undefined)`.\n */\nexport async function resolveAdapterConfig<T>(\n  namespace: string,\n  fields: ConfigField<T>[],\n  overrides: Partial<T> | undefined,\n  probe: () => Promise<Record<string, any> | undefined>,\n): Promise<Partial<T>> {\n  const runtimeConfig = shouldProbeRuntime(fields, overrides)\n    ? await probe()\n    : undefined;\n  const autotelNs = runtimeConfig?.autotel?.[namespace];\n  const rootNs = runtimeConfig?.[namespace];\n\n  const config: Record<string, unknown> = {};\n  for (const { key, env } of fields) {\n    config[key] =\n      overrides?.[key] ??\n      autotelNs?.[key] ??\n      rootNs?.[key] ??\n      resolveEnv(env);\n  }\n\n  return config as Partial<T>;\n}\n\nexport type HeadersLike =\n  | { get(name: string): string | null }\n  | Record<string, string | undefined>;\n\nexport function getHeader(\n  headers: HeadersLike | undefined,\n  name: string,\n): string | undefined {\n  if (!headers) return undefined;\n  if ('get' in headers && typeof headers.get === 'function') {\n    return headers.get(name) ?? undefined;\n  }\n  const dictionary = headers as Record<string, string | undefined>;\n  const value = dictionary[name] ?? dictionary[name.toLowerCase()];\n  return typeof value === 'string' ? value : undefined;\n}\n\nexport type {\n  RequestLogger,\n  RequestLoggerOptions,\n  RequestLogSnapshot,\n  ParsedError,\n  StructuredError,\n  StructuredErrorInput,\n  DrainPipelineOptions,\n  PipelineDrainFn,\n};\n"],"mappings":";;;AAkCA,SAAgB,gBACd,SACA;CACA,OAAO,SAAS,UACd,SACA,sBACe;EACf,IAAI;EACJ,IAAI;GACF,SAAS,iBAAiB,QAAW,oBAAoB;EAC3D,QAAQ;GACN,MAAM,IAAI,MACR,qBAAqB,QAAQ,YAAY,4GAE3C;EACF;EAEA,IAAI,WAAW,QAAQ,QAAQ;GAC7B,MAAM,QAAQ,QAAQ,OAAO,OAAO;GACpC,IAAI,SAAS,OAAO,KAAK,KAAK,CAAC,CAAC,SAAS,GACvC,OAAO,IAAI,KAAK;EAEpB;EAEA,OAAO;CACT;AACF;;;;;;;AAgBA,SAAgB,oBAAoB,SAA2C;CAC7E,OAAO,SAAS,WACd,UACA,QACA,SACA,SACY;EAkBZ,OAjBgB,MACd,EAAE,MAAM,SAAS,IAChB,QAAQ,YAAwB;GAC/B,MAAM,MAAM,iBAAiB,KAAK,SAAS,oBAAoB;GAC/D,OAAO,GAAG;GACV,IAAI;IACF,OAAO,MAAM,QAAQ,IAAI,WAAW,QAAQ,CAAC;GAC/C,SAAS,OAAO;IACd,IAAI,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC,CAAC;IACnE,MAAM;GACR,UAAU;IACR,IAAI,SAAS,aAAa,OACxB,IAAI,QAAQ,SAAS,WAAW,CAAC;GAErC;EACF,CAEW,CAAC,CAAC;CACjB;AACF;AAEA,SAAgB,qBACd,SAC0B;CAC1B,OAAO;EACL,WAAW,gBAAgB,OAAO;EAClC;EACA;EACA;CACF;AACF;AAWA,SAAS,WAAW,SAAwC;CAC1D,IAAI,CAAC,SAAS,OAAO;CACrB,KAAK,MAAM,OAAO,SAAS;EACzB,MAAM,QAAQ,QAAQ,IAAI;EAC1B,IAAI,OAAO,OAAO;CACpB;AAEF;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,mBACd,QACA,WACS;CACT,OAAO,OAAO,MAAM,EAAE,KAAK,UAAU;EACnC,IAAI,CAAC,OAAO,IAAI,WAAW,GAAG,OAAO;EACrC,IAAI,YAAY,SAAS,QAAW,OAAO;EAC3C,OAAO;CACT,CAAC;AACH;;;;;;;;;;;;;;AAeA,eAAsB,qBACpB,WACA,QACA,WACA,OACqB;CACrB,MAAM,gBAAgB,mBAAmB,QAAQ,SAAS,IACtD,MAAM,MAAM,IACZ;CACJ,MAAM,YAAY,eAAe,UAAU;CAC3C,MAAM,SAAS,gBAAgB;CAE/B,MAAM,SAAkC,CAAC;CACzC,KAAK,MAAM,EAAE,KAAK,SAAS,QACzB,OAAO,OACL,YAAY,QACZ,YAAY,QACZ,SAAS,QACT,WAAW,GAAG;CAGlB,OAAO;AACT;AAMA,SAAgB,UACd,SACA,MACoB;CACpB,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,SAAS,WAAW,OAAO,QAAQ,QAAQ,YAC7C,OAAO,QAAQ,IAAI,IAAI,KAAK;CAE9B,MAAM,aAAa;CACnB,MAAM,QAAQ,WAAW,SAAS,WAAW,KAAK,YAAY;CAC9D,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C"}