autotel-adapters 0.2.20 → 0.3.0

package/dist/core.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core.ts"],"names":["getRequestLogger","parseError","createStructuredError","createDrainPipeline"],"mappings":";;;;;AAgCO,SAAS,gBACd,OAAA,EACA;AACA,EAAA,OAAO,SAAS,SAAA,CACd,OAAA,EACA,oBAAA,EACe;AACf,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAA,GAASA,wBAAA,CAAiB,QAAW,oBAAoB,CAAA;AAAA,IAC3D,CAAA,CAAA,MAAQ;AACN,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,kBAAA,EAAqB,QAAQ,WAAW,CAAA,2GAAA;AAAA,OAE1C;AAAA,IACF;AAEA,IAAA,IAAI,OAAA,IAAW,QAAQ,MAAA,EAAQ;AAC7B,MAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,MAAA,CAAO,OAAO,CAAA;AACpC,MAAA,IAAI,SAAS,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,CAAE,SAAS,CAAA,EAAG;AAC1C,QAAA,MAAA,CAAO,IAAI,KAAK,CAAA;AAAA,MAClB;AAAA,IACF;AAEA,IAAA,OAAO,MAAA;AAAA,EACT,CAAA;AACF;AAEO,SAAS,qBACd,OAAA,EAC0B;AAC1B,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,gBAAgB,OAAO,CAAA;AAAA,gBAClCC,kBAAA;AAAA,2BACAC,6BAAA;AAAA,yBACAC;AAAA,GACF;AACF;AAWA,SAAS,WAAW,OAAA,EAAwC;AAC1D,EAAA,IAAI,CAAC,SAAS,OAAO,MAAA;AACrB,EAAA,KAAA,MAAW,OAAO,OAAA,EAAS;AACzB,IAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,GAAA,CAAI,GAAG,CAAA;AAC7B,IAAA,IAAI,OAAO,OAAO,KAAA;AAAA,EACpB;AACA,EAAA,OAAO,MAAA;AACT;AAmBO,SAAS,kBAAA,CACd,QACA,SAAA,EACS;AACT,EAAA,OAAO,OAAO,IAAA,CAAK,CAAC,EAAE,GAAA,EAAK,KAAI,KAAM;AACnC,IAAA,IAAI,CAAC,GAAA,IAAO,GAAA,CAAI,MAAA,KAAW,GAAG,OAAO,KAAA;AACrC,IAAA,IAAI,SAAA,GAAY,GAAG,CAAA,KAAM,MAAA,EAAW,OAAO,KAAA;AAC3C,IAAA,OAAO,IAAA;AAAA,EACT,CAAC,CAAA;AACH;AAeA,eAAsB,oBAAA,CACpB,SAAA,EACA,MAAA,EACA,SAAA,EACA,KAAA,EACqB;AACrB,EAAA,MAAM,gBAAgB,kBAAA,CAAmB,MAAA,EAAQ,SAAS,CAAA,GACtD,MAAM,OAAM,GACZ,MAAA;AACJ,EAAA,MAAM,SAAA,GAAY,aAAA,EAAe,OAAA,GAAU,SAAS,CAAA;AACpD,EAAA,MAAM,MAAA,GAAS,gBAAgB,SAAS,CAAA;AAExC,EAAA,MAAM,SAAkC,EAAC;AACzC,EAAA,KAAA,MAAW,EAAE,GAAA,EAAK,GAAA,EAAI,IAAK,MAAA,EAAQ;AACjC,IAAA,MAAA,CAAO,GAAG,CAAA,GACR,SAAA,GAAY,GAAG,CAAA,IACf,SAAA,GAAY,GAAG,CAAA,IACf,MAAA,GAAS,GAAG,CAAA,IACZ,UAAA,CAAW,GAAG,CAAA;AAAA,EAClB;AAEA,EAAA,OAAO,MAAA;AACT;AAMO,SAAS,SAAA,CACd,SACA,IAAA,EACoB;AACpB,EAAA,IAAI,CAAC,SAAS,OAAO,MAAA;AACrB,EAAA,IAAI,KAAA,IAAS,OAAA,IAAW,OAAO,OAAA,CAAQ,QAAQ,UAAA,EAAY;AACzD,IAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,IAAI,CAAA,IAAK,MAAA;AAAA,EAC9B;AACA,EAAA,MAAM,UAAA,GAAa,OAAA;AACnB,EAAA,MAAM,QAAQ,UAAA,CAAW,IAAI,KAAK,UAAA,CAAW,IAAA,CAAK,aAAa,CAAA;AAC/D,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,MAAA;AAC7C","file":"core.cjs","sourcesContent":["import {\n  createDrainPipeline,\n  createStructuredError,\n  getRequestLogger,\n  parseError,\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 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,"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"]}

package/dist/core.d.cts

@@ -1,3 +1,4 @@
+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';
 
@@ -12,6 +13,20 @@ interface AdapterToolkit<TContext> {
     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;
+}
+/**
+ * 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`).
+ */
+declare function createRequestRunner(storage: AsyncLocalStorage<RequestLogger>): <T>(spanName: string, enrich: (log: RequestLogger) => void, handler: () => T | Promise<T>, options?: RequestRunnerOptions) => Promise<T>;
 declare function createAdapterToolkit<TContext = unknown>(options: AdapterUseLoggerOptions<TContext>): AdapterToolkit<TContext>;
 /**
  * Description of a single adapter config field. `env` is the ordered list of
@@ -58,4 +73,4 @@ type HeadersLike = {
 } | Record<string, string | undefined>;
 declare function getHeader(headers: HeadersLike | undefined, name: string): string | undefined;
 
-export { type AdapterToolkit, type AdapterUseLoggerOptions, type ConfigField, type HeadersLike, createAdapterToolkit, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
+export { type AdapterToolkit, type AdapterUseLoggerOptions, type ConfigField, type HeadersLike, type RequestRunnerOptions, createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };

package/dist/core.d.ts

@@ -1,3 +1,4 @@
+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';
 
@@ -12,6 +13,20 @@ interface AdapterToolkit<TContext> {
     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;
+}
+/**
+ * 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`).
+ */
+declare function createRequestRunner(storage: AsyncLocalStorage<RequestLogger>): <T>(spanName: string, enrich: (log: RequestLogger) => void, handler: () => T | Promise<T>, options?: RequestRunnerOptions) => Promise<T>;
 declare function createAdapterToolkit<TContext = unknown>(options: AdapterUseLoggerOptions<TContext>): AdapterToolkit<TContext>;
 /**
  * Description of a single adapter config field. `env` is the ordered list of
@@ -58,4 +73,4 @@ type HeadersLike = {
 } | Record<string, string | undefined>;
 declare function getHeader(headers: HeadersLike | undefined, name: string): string | undefined;
 
-export { type AdapterToolkit, type AdapterUseLoggerOptions, type ConfigField, type HeadersLike, createAdapterToolkit, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
+export { type AdapterToolkit, type AdapterUseLoggerOptions, type ConfigField, type HeadersLike, type RequestRunnerOptions, createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };

package/dist/core.js

@@ -1,3 +1,3 @@
-export { createAdapterToolkit, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime } from './chunk-GBSB7IX7.js';
+export { createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime } from './chunk-DJ2OU3S6.js';
 //# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/express.cjs

@@ -0,0 +1,146 @@
+'use strict';
+
+var async_hooks = require('async_hooks');
+var autotel = require('autotel');
+
+// src/express.ts
+function createUseLogger(options) {
+  return function useLogger2(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;
+  };
+}
+function createRequestRunner(storage) {
+  return function runRequest2(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();
+  };
+}
+function createAdapterToolkit(options) {
+  return {
+    useLogger: createUseLogger(options),
+    parseError: autotel.parseError,
+    createStructuredError: autotel.createStructuredError,
+    createDrainPipeline: autotel.createDrainPipeline
+  };
+}
+
+// src/express.ts
+var expressLoggerStorage = new async_hooks.AsyncLocalStorage();
+function headerValue(headers, name) {
+  if (!headers) return void 0;
+  const value = headers[name] ?? headers[name.toLowerCase()];
+  if (Array.isArray(value)) return value[0];
+  return typeof value === "string" ? value : void 0;
+}
+function enrichFromRequest(request) {
+  if (!request) return void 0;
+  const url = request.originalUrl ?? request.url;
+  const route = request.route?.path ?? request.path ?? url;
+  const requestId = headerValue(request.headers, "x-request-id");
+  return {
+    ...request.method ? { "http.request.method": request.method } : {},
+    ...url ? { "url.full": url } : {},
+    ...route ? { "http.route": route } : {},
+    ...requestId ? { "http.request.id": requestId } : {}
+  };
+}
+var baseUseLogger = createUseLogger({
+  adapterName: "express",
+  enrich: enrichFromRequest
+});
+function useLogger(request, requestLoggerOptions) {
+  const stored = expressLoggerStorage.getStore();
+  if (stored) return stored;
+  return baseUseLogger(request, requestLoggerOptions);
+}
+var runRequest = createRequestRunner(expressLoggerStorage);
+function withAutotel(handler, options) {
+  return async (req, res, next) => {
+    const spanName = typeof options?.spanName === "function" ? options.spanName(req) : options?.spanName ?? `express.${req.method ?? "request"}`;
+    try {
+      return await runRequest(
+        spanName,
+        (log) => {
+          const auto = enrichFromRequest(req);
+          if (auto && Object.keys(auto).length > 0) log.set(auto);
+          const custom = options?.enrich?.(req);
+          if (custom && Object.keys(custom).length > 0) log.set(custom);
+        },
+        () => handler(req, res, next),
+        {
+          requestLoggerOptions: options?.requestLoggerOptions,
+          autoEmit: options?.autoEmit,
+          finalize: () => res.statusCode ? { "http.response.status_code": res.statusCode } : void 0
+        }
+      );
+    } catch (error) {
+      if (typeof next === "function") {
+        next(error);
+        return void 0;
+      }
+      throw error;
+    }
+  };
+}
+function createExpressAdapter(options) {
+  return {
+    withAutotel: (handler) => withAutotel(handler, options),
+    useLogger,
+    parseError: (error) => autotel.parseError(error),
+    createStructuredError: (input) => autotel.createStructuredError(input),
+    createDrainPipeline: (drainOptions) => autotel.createDrainPipeline(drainOptions)
+  };
+}
+var expressToolkit = createAdapterToolkit({
+  adapterName: "express",
+  enrich: enrichFromRequest
+});
+
+Object.defineProperty(exports, "createDrainPipeline", {
+  enumerable: true,
+  get: function () { return autotel.createDrainPipeline; }
+});
+Object.defineProperty(exports, "createStructuredError", {
+  enumerable: true,
+  get: function () { return autotel.createStructuredError; }
+});
+Object.defineProperty(exports, "parseError", {
+  enumerable: true,
+  get: function () { return autotel.parseError; }
+});
+exports.createExpressAdapter = createExpressAdapter;
+exports.expressToolkit = expressToolkit;
+exports.useLogger = useLogger;
+exports.withAutotel = withAutotel;
+//# sourceMappingURL=express.cjs.map
+//# sourceMappingURL=express.cjs.map

package/dist/express.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts","../src/express.ts"],"names":["useLogger","getRequestLogger","runRequest","trace","parseError","createStructuredError","createDrainPipeline","AsyncLocalStorage"],"mappings":"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","file":"express.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","import { AsyncLocalStorage } from 'node:async_hooks';\nimport {\n  createDrainPipeline,\n  createStructuredError,\n  parseError,\n  type DrainPipelineOptions,\n  type ParsedError,\n  type PipelineDrainFn,\n  type RequestLogger,\n  type RequestLoggerOptions,\n  type StructuredError,\n  type StructuredErrorInput,\n} from 'autotel';\nimport {\n  createAdapterToolkit,\n  createRequestRunner,\n  createUseLogger,\n} from './core';\n\nexport interface ExpressRequestLike {\n  method?: string;\n  originalUrl?: string;\n  url?: string;\n  path?: string;\n  route?: { path?: string };\n  headers?: Record<string, string | string[] | undefined>;\n}\n\nexport interface ExpressResponseLike {\n  statusCode?: number;\n}\n\nexport type ExpressNext = (err?: unknown) => void;\n\nexport interface ExpressWithAutotelOptions {\n  spanName?: string | ((request: ExpressRequestLike) => string);\n  requestLoggerOptions?: RequestLoggerOptions;\n  enrich?: (request: ExpressRequestLike) => Record<string, unknown> | undefined;\n  /** Emit one wide event automatically when the handler settles. Default `true`. */\n  autoEmit?: boolean;\n}\n\nconst expressLoggerStorage = new AsyncLocalStorage<RequestLogger>();\n\nfunction headerValue(\n  headers: ExpressRequestLike['headers'],\n  name: string,\n): string | undefined {\n  if (!headers) return undefined;\n  const value = headers[name] ?? headers[name.toLowerCase()];\n  if (Array.isArray(value)) return value[0];\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction enrichFromRequest(\n  request?: ExpressRequestLike,\n): Record<string, unknown> | undefined {\n  if (!request) return undefined;\n\n  const url = request.originalUrl ?? request.url;\n  const route = request.route?.path ?? request.path ?? url;\n  const requestId = headerValue(request.headers, 'x-request-id');\n\n  return {\n    ...(request.method ? { 'http.request.method': request.method } : {}),\n    ...(url ? { 'url.full': url } : {}),\n    ...(route ? { 'http.route': route } : {}),\n    ...(requestId ? { 'http.request.id': requestId } : {}),\n  };\n}\n\nconst baseUseLogger = createUseLogger<ExpressRequestLike>({\n  adapterName: 'express',\n  enrich: enrichFromRequest,\n});\n\nexport function useLogger(\n  request?: ExpressRequestLike,\n  requestLoggerOptions?: RequestLoggerOptions,\n): RequestLogger {\n  const stored = expressLoggerStorage.getStore();\n  if (stored) return stored;\n  return baseUseLogger(request, requestLoggerOptions);\n}\n\nconst runRequest = createRequestRunner(expressLoggerStorage);\n\n/**\n * Wrap an Express route handler. Each request opens a span, gets a\n * request-scoped logger (via `useLogger(req)`), and emits one wide event when\n * the handler settles. Thrown errors are recorded and forwarded to `next`.\n */\nexport function withAutotel<\n  TReq extends ExpressRequestLike,\n  TRes extends ExpressResponseLike,\n  TReturn,\n>(\n  handler: (req: TReq, res: TRes, next?: ExpressNext) => TReturn | Promise<TReturn>,\n  options?: ExpressWithAutotelOptions,\n): (req: TReq, res: TRes, next?: ExpressNext) => Promise<TReturn | undefined> {\n  return async (\n    req: TReq,\n    res: TRes,\n    next?: ExpressNext,\n  ): Promise<TReturn | undefined> => {\n    const spanName =\n      typeof options?.spanName === 'function'\n        ? options.spanName(req)\n        : (options?.spanName ?? `express.${req.method ?? 'request'}`);\n\n    try {\n      return await runRequest<TReturn>(\n        spanName,\n        (log) => {\n          const auto = enrichFromRequest(req);\n          if (auto && Object.keys(auto).length > 0) log.set(auto);\n          const custom = options?.enrich?.(req);\n          if (custom && Object.keys(custom).length > 0) log.set(custom);\n        },\n        () => handler(req, res, next),\n        {\n          requestLoggerOptions: options?.requestLoggerOptions,\n          autoEmit: options?.autoEmit,\n          finalize: () =>\n            res.statusCode\n              ? { 'http.response.status_code': res.statusCode }\n              : undefined,\n        },\n      );\n    } catch (error) {\n      if (typeof next === 'function') {\n        next(error);\n        return undefined;\n      }\n      throw error;\n    }\n  };\n}\n\nexport function createExpressAdapter(options?: ExpressWithAutotelOptions) {\n  return {\n    withAutotel: <\n      TReq extends ExpressRequestLike,\n      TRes extends ExpressResponseLike,\n      TReturn,\n    >(\n      handler: (\n        req: TReq,\n        res: TRes,\n        next?: ExpressNext,\n      ) => TReturn | Promise<TReturn>,\n    ) => withAutotel(handler, options),\n    useLogger,\n    parseError: (error: unknown): ParsedError => parseError(error),\n    createStructuredError: (input: StructuredErrorInput): StructuredError =>\n      createStructuredError(input),\n    createDrainPipeline: <T = unknown>(\n      drainOptions?: DrainPipelineOptions<T>,\n    ): ((batchDrain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>) =>\n      createDrainPipeline(drainOptions),\n  };\n}\n\nexport const expressToolkit = createAdapterToolkit<ExpressRequestLike>({\n  adapterName: 'express',\n  enrich: enrichFromRequest,\n});\n\nexport { parseError, createDrainPipeline, createStructuredError };\n"]}

package/dist/express.d.cts

@@ -0,0 +1,43 @@
+import { AdapterToolkit } from './core.cjs';
+import { RequestLoggerOptions, RequestLogger, ParsedError, StructuredErrorInput, StructuredError, DrainPipelineOptions, PipelineDrainFn } from 'autotel';
+export { createDrainPipeline, createStructuredError, parseError } from 'autotel';
+import 'node:async_hooks';
+
+interface ExpressRequestLike {
+    method?: string;
+    originalUrl?: string;
+    url?: string;
+    path?: string;
+    route?: {
+        path?: string;
+    };
+    headers?: Record<string, string | string[] | undefined>;
+}
+interface ExpressResponseLike {
+    statusCode?: number;
+}
+type ExpressNext = (err?: unknown) => void;
+interface ExpressWithAutotelOptions {
+    spanName?: string | ((request: ExpressRequestLike) => string);
+    requestLoggerOptions?: RequestLoggerOptions;
+    enrich?: (request: ExpressRequestLike) => Record<string, unknown> | undefined;
+    /** Emit one wide event automatically when the handler settles. Default `true`. */
+    autoEmit?: boolean;
+}
+declare function useLogger(request?: ExpressRequestLike, requestLoggerOptions?: RequestLoggerOptions): RequestLogger;
+/**
+ * Wrap an Express route handler. Each request opens a span, gets a
+ * request-scoped logger (via `useLogger(req)`), and emits one wide event when
+ * the handler settles. Thrown errors are recorded and forwarded to `next`.
+ */
+declare function withAutotel<TReq extends ExpressRequestLike, TRes extends ExpressResponseLike, TReturn>(handler: (req: TReq, res: TRes, next?: ExpressNext) => TReturn | Promise<TReturn>, options?: ExpressWithAutotelOptions): (req: TReq, res: TRes, next?: ExpressNext) => Promise<TReturn | undefined>;
+declare function createExpressAdapter(options?: ExpressWithAutotelOptions): {
+    withAutotel: <TReq extends ExpressRequestLike, TRes extends ExpressResponseLike, TReturn>(handler: (req: TReq, res: TRes, next?: ExpressNext) => TReturn | Promise<TReturn>) => (req: TReq, res: TRes, next?: ExpressNext) => Promise<TReturn | undefined>;
+    useLogger: typeof useLogger;
+    parseError: (error: unknown) => ParsedError;
+    createStructuredError: (input: StructuredErrorInput) => StructuredError;
+    createDrainPipeline: <T = unknown>(drainOptions?: DrainPipelineOptions<T>) => ((batchDrain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>);
+};
+declare const expressToolkit: AdapterToolkit<ExpressRequestLike>;
+
+export { type ExpressNext, type ExpressRequestLike, type ExpressResponseLike, type ExpressWithAutotelOptions, createExpressAdapter, expressToolkit, useLogger, withAutotel };

package/dist/express.d.ts

@@ -0,0 +1,43 @@
+import { AdapterToolkit } from './core.js';
+import { RequestLoggerOptions, RequestLogger, ParsedError, StructuredErrorInput, StructuredError, DrainPipelineOptions, PipelineDrainFn } from 'autotel';
+export { createDrainPipeline, createStructuredError, parseError } from 'autotel';
+import 'node:async_hooks';
+
+interface ExpressRequestLike {
+    method?: string;
+    originalUrl?: string;
+    url?: string;
+    path?: string;
+    route?: {
+        path?: string;
+    };
+    headers?: Record<string, string | string[] | undefined>;
+}
+interface ExpressResponseLike {
+    statusCode?: number;
+}
+type ExpressNext = (err?: unknown) => void;
+interface ExpressWithAutotelOptions {
+    spanName?: string | ((request: ExpressRequestLike) => string);
+    requestLoggerOptions?: RequestLoggerOptions;
+    enrich?: (request: ExpressRequestLike) => Record<string, unknown> | undefined;
+    /** Emit one wide event automatically when the handler settles. Default `true`. */
+    autoEmit?: boolean;
+}
+declare function useLogger(request?: ExpressRequestLike, requestLoggerOptions?: RequestLoggerOptions): RequestLogger;
+/**
+ * Wrap an Express route handler. Each request opens a span, gets a
+ * request-scoped logger (via `useLogger(req)`), and emits one wide event when
+ * the handler settles. Thrown errors are recorded and forwarded to `next`.
+ */
+declare function withAutotel<TReq extends ExpressRequestLike, TRes extends ExpressResponseLike, TReturn>(handler: (req: TReq, res: TRes, next?: ExpressNext) => TReturn | Promise<TReturn>, options?: ExpressWithAutotelOptions): (req: TReq, res: TRes, next?: ExpressNext) => Promise<TReturn | undefined>;
+declare function createExpressAdapter(options?: ExpressWithAutotelOptions): {
+    withAutotel: <TReq extends ExpressRequestLike, TRes extends ExpressResponseLike, TReturn>(handler: (req: TReq, res: TRes, next?: ExpressNext) => TReturn | Promise<TReturn>) => (req: TReq, res: TRes, next?: ExpressNext) => Promise<TReturn | undefined>;
+    useLogger: typeof useLogger;
+    parseError: (error: unknown) => ParsedError;
+    createStructuredError: (input: StructuredErrorInput) => StructuredError;
+    createDrainPipeline: <T = unknown>(drainOptions?: DrainPipelineOptions<T>) => ((batchDrain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>);
+};
+declare const expressToolkit: AdapterToolkit<ExpressRequestLike>;
+
+export { type ExpressNext, type ExpressRequestLike, type ExpressResponseLike, type ExpressWithAutotelOptions, createExpressAdapter, expressToolkit, useLogger, withAutotel };

package/dist/express.js

@@ -0,0 +1,4 @@
+export { createDrainPipeline, createExpressAdapter, createStructuredError, expressToolkit, parseError, useLogger, withAutotel } from './chunk-2YPL66HM.js';
+import './chunk-DJ2OU3S6.js';
+//# sourceMappingURL=express.js.map
+//# sourceMappingURL=express.js.map

package/dist/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"express.js"}

package/dist/fastify.cjs

@@ -0,0 +1,137 @@
+'use strict';
+
+var async_hooks = require('async_hooks');
+var autotel = require('autotel');
+
+// src/fastify.ts
+function createUseLogger(options) {
+  return function useLogger2(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;
+  };
+}
+function createRequestRunner(storage) {
+  return function runRequest2(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();
+  };
+}
+function createAdapterToolkit(options) {
+  return {
+    useLogger: createUseLogger(options),
+    parseError: autotel.parseError,
+    createStructuredError: autotel.createStructuredError,
+    createDrainPipeline: autotel.createDrainPipeline
+  };
+}
+
+// src/fastify.ts
+var fastifyLoggerStorage = new async_hooks.AsyncLocalStorage();
+function headerValue(headers, name) {
+  if (!headers) return void 0;
+  const value = headers[name] ?? headers[name.toLowerCase()];
+  if (Array.isArray(value)) return value[0];
+  return typeof value === "string" ? value : void 0;
+}
+function enrichFromRequest(request) {
+  if (!request) return void 0;
+  const route = request.routeOptions?.url ?? request.routerPath ?? request.url;
+  const requestId = request.id ?? headerValue(request.headers, "x-request-id");
+  return {
+    ...request.method ? { "http.request.method": request.method } : {},
+    ...request.url ? { "url.full": request.url } : {},
+    ...route ? { "http.route": route } : {},
+    ...requestId ? { "http.request.id": requestId } : {}
+  };
+}
+var baseUseLogger = createUseLogger({
+  adapterName: "fastify",
+  enrich: enrichFromRequest
+});
+function useLogger(request, requestLoggerOptions) {
+  const stored = fastifyLoggerStorage.getStore();
+  if (stored) return stored;
+  return baseUseLogger(request, requestLoggerOptions);
+}
+var runRequest = createRequestRunner(fastifyLoggerStorage);
+function withAutotel(handler, options) {
+  return (request, reply) => {
+    const spanName = typeof options?.spanName === "function" ? options.spanName(request) : options?.spanName ?? `fastify.${request.method ?? "request"}`;
+    return runRequest(
+      spanName,
+      (log) => {
+        const auto = enrichFromRequest(request);
+        if (auto && Object.keys(auto).length > 0) log.set(auto);
+        const custom = options?.enrich?.(request);
+        if (custom && Object.keys(custom).length > 0) log.set(custom);
+      },
+      () => handler(request, reply),
+      {
+        requestLoggerOptions: options?.requestLoggerOptions,
+        autoEmit: options?.autoEmit,
+        finalize: () => reply.statusCode ? { "http.response.status_code": reply.statusCode } : void 0
+      }
+    );
+  };
+}
+function createFastifyAdapter(options) {
+  return {
+    withAutotel: (handler) => withAutotel(handler, options),
+    useLogger,
+    parseError: (error) => autotel.parseError(error),
+    createStructuredError: (input) => autotel.createStructuredError(input),
+    createDrainPipeline: (drainOptions) => autotel.createDrainPipeline(drainOptions)
+  };
+}
+var fastifyToolkit = createAdapterToolkit({
+  adapterName: "fastify",
+  enrich: enrichFromRequest
+});
+
+Object.defineProperty(exports, "createDrainPipeline", {
+  enumerable: true,
+  get: function () { return autotel.createDrainPipeline; }
+});
+Object.defineProperty(exports, "createStructuredError", {
+  enumerable: true,
+  get: function () { return autotel.createStructuredError; }
+});
+Object.defineProperty(exports, "parseError", {
+  enumerable: true,
+  get: function () { return autotel.parseError; }
+});
+exports.createFastifyAdapter = createFastifyAdapter;
+exports.fastifyToolkit = fastifyToolkit;
+exports.useLogger = useLogger;
+exports.withAutotel = withAutotel;
+//# sourceMappingURL=fastify.cjs.map
+//# sourceMappingURL=fastify.cjs.map

package/dist/fastify.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts","../src/fastify.ts"],"names":["useLogger","getRequestLogger","runRequest","trace","parseError","createStructuredError","createDrainPipeline","AsyncLocalStorage"],"mappings":"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","file":"fastify.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","import { AsyncLocalStorage } from 'node:async_hooks';\nimport {\n  createDrainPipeline,\n  createStructuredError,\n  parseError,\n  type DrainPipelineOptions,\n  type ParsedError,\n  type PipelineDrainFn,\n  type RequestLogger,\n  type RequestLoggerOptions,\n  type StructuredError,\n  type StructuredErrorInput,\n} from 'autotel';\nimport {\n  createAdapterToolkit,\n  createRequestRunner,\n  createUseLogger,\n} from './core';\n\nexport interface FastifyRequestLike {\n  method?: string;\n  url?: string;\n  routeOptions?: { url?: string };\n  routerPath?: string;\n  id?: string;\n  headers?: Record<string, string | string[] | undefined>;\n}\n\nexport interface FastifyReplyLike {\n  statusCode?: number;\n}\n\nexport interface FastifyWithAutotelOptions {\n  spanName?: string | ((request: FastifyRequestLike) => string);\n  requestLoggerOptions?: RequestLoggerOptions;\n  enrich?: (request: FastifyRequestLike) => Record<string, unknown> | undefined;\n  /** Emit one wide event automatically when the handler settles. Default `true`. */\n  autoEmit?: boolean;\n}\n\nconst fastifyLoggerStorage = new AsyncLocalStorage<RequestLogger>();\n\nfunction headerValue(\n  headers: FastifyRequestLike['headers'],\n  name: string,\n): string | undefined {\n  if (!headers) return undefined;\n  const value = headers[name] ?? headers[name.toLowerCase()];\n  if (Array.isArray(value)) return value[0];\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction enrichFromRequest(\n  request?: FastifyRequestLike,\n): Record<string, unknown> | undefined {\n  if (!request) return undefined;\n\n  const route = request.routeOptions?.url ?? request.routerPath ?? request.url;\n  const requestId = request.id ?? headerValue(request.headers, 'x-request-id');\n\n  return {\n    ...(request.method ? { 'http.request.method': request.method } : {}),\n    ...(request.url ? { 'url.full': request.url } : {}),\n    ...(route ? { 'http.route': route } : {}),\n    ...(requestId ? { 'http.request.id': requestId } : {}),\n  };\n}\n\nconst baseUseLogger = createUseLogger<FastifyRequestLike>({\n  adapterName: 'fastify',\n  enrich: enrichFromRequest,\n});\n\nexport function useLogger(\n  request?: FastifyRequestLike,\n  requestLoggerOptions?: RequestLoggerOptions,\n): RequestLogger {\n  const stored = fastifyLoggerStorage.getStore();\n  if (stored) return stored;\n  return baseUseLogger(request, requestLoggerOptions);\n}\n\nconst runRequest = createRequestRunner(fastifyLoggerStorage);\n\n/**\n * Wrap a Fastify route handler. Each request opens a span, gets a\n * request-scoped logger (via `useLogger(request)`), and emits one wide event\n * when the handler settles. Thrown errors are recorded, then rethrown for\n * Fastify's error handling.\n */\nexport function withAutotel<\n  TReq extends FastifyRequestLike,\n  TRes extends FastifyReplyLike,\n  TReturn,\n>(\n  handler: (request: TReq, reply: TRes) => TReturn | Promise<TReturn>,\n  options?: FastifyWithAutotelOptions,\n): (request: TReq, reply: TRes) => Promise<TReturn> {\n  return (request: TReq, reply: TRes): Promise<TReturn> => {\n    const spanName =\n      typeof options?.spanName === 'function'\n        ? options.spanName(request)\n        : (options?.spanName ?? `fastify.${request.method ?? 'request'}`);\n\n    return runRequest<TReturn>(\n      spanName,\n      (log) => {\n        const auto = enrichFromRequest(request);\n        if (auto && Object.keys(auto).length > 0) log.set(auto);\n        const custom = options?.enrich?.(request);\n        if (custom && Object.keys(custom).length > 0) log.set(custom);\n      },\n      () => handler(request, reply),\n      {\n        requestLoggerOptions: options?.requestLoggerOptions,\n        autoEmit: options?.autoEmit,\n        finalize: () =>\n          reply.statusCode\n            ? { 'http.response.status_code': reply.statusCode }\n            : undefined,\n      },\n    );\n  };\n}\n\nexport function createFastifyAdapter(options?: FastifyWithAutotelOptions) {\n  return {\n    withAutotel: <\n      TReq extends FastifyRequestLike,\n      TRes extends FastifyReplyLike,\n      TReturn,\n    >(\n      handler: (request: TReq, reply: TRes) => TReturn | Promise<TReturn>,\n    ) => withAutotel(handler, options),\n    useLogger,\n    parseError: (error: unknown): ParsedError => parseError(error),\n    createStructuredError: (input: StructuredErrorInput): StructuredError =>\n      createStructuredError(input),\n    createDrainPipeline: <T = unknown>(\n      drainOptions?: DrainPipelineOptions<T>,\n    ): ((batchDrain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>) =>\n      createDrainPipeline(drainOptions),\n  };\n}\n\nexport const fastifyToolkit = createAdapterToolkit<FastifyRequestLike>({\n  adapterName: 'fastify',\n  enrich: enrichFromRequest,\n});\n\nexport { parseError, createDrainPipeline, createStructuredError };\n"]}

package/dist/fastify.d.cts

@@ -0,0 +1,43 @@
+import { AdapterToolkit } from './core.cjs';
+import { RequestLoggerOptions, RequestLogger, ParsedError, StructuredErrorInput, StructuredError, DrainPipelineOptions, PipelineDrainFn } from 'autotel';
+export { createDrainPipeline, createStructuredError, parseError } from 'autotel';
+import 'node:async_hooks';
+
+interface FastifyRequestLike {
+    method?: string;
+    url?: string;
+    routeOptions?: {
+        url?: string;
+    };
+    routerPath?: string;
+    id?: string;
+    headers?: Record<string, string | string[] | undefined>;
+}
+interface FastifyReplyLike {
+    statusCode?: number;
+}
+interface FastifyWithAutotelOptions {
+    spanName?: string | ((request: FastifyRequestLike) => string);
+    requestLoggerOptions?: RequestLoggerOptions;
+    enrich?: (request: FastifyRequestLike) => Record<string, unknown> | undefined;
+    /** Emit one wide event automatically when the handler settles. Default `true`. */
+    autoEmit?: boolean;
+}
+declare function useLogger(request?: FastifyRequestLike, requestLoggerOptions?: RequestLoggerOptions): RequestLogger;
+/**
+ * Wrap a Fastify route handler. Each request opens a span, gets a
+ * request-scoped logger (via `useLogger(request)`), and emits one wide event
+ * when the handler settles. Thrown errors are recorded, then rethrown for
+ * Fastify's error handling.
+ */
+declare function withAutotel<TReq extends FastifyRequestLike, TRes extends FastifyReplyLike, TReturn>(handler: (request: TReq, reply: TRes) => TReturn | Promise<TReturn>, options?: FastifyWithAutotelOptions): (request: TReq, reply: TRes) => Promise<TReturn>;
+declare function createFastifyAdapter(options?: FastifyWithAutotelOptions): {
+    withAutotel: <TReq extends FastifyRequestLike, TRes extends FastifyReplyLike, TReturn>(handler: (request: TReq, reply: TRes) => TReturn | Promise<TReturn>) => (request: TReq, reply: TRes) => Promise<TReturn>;
+    useLogger: typeof useLogger;
+    parseError: (error: unknown) => ParsedError;
+    createStructuredError: (input: StructuredErrorInput) => StructuredError;
+    createDrainPipeline: <T = unknown>(drainOptions?: DrainPipelineOptions<T>) => ((batchDrain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>);
+};
+declare const fastifyToolkit: AdapterToolkit<FastifyRequestLike>;
+
+export { type FastifyReplyLike, type FastifyRequestLike, type FastifyWithAutotelOptions, createFastifyAdapter, fastifyToolkit, useLogger, withAutotel };