autotel-adapters 0.3.8 → 0.3.9

package/dist/express.cjs

@@ -1,146 +1,86 @@
-'use strict';
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_core = require('./core.cjs');
+let autotel = require("autotel");
+let node_async_hooks = require("node:async_hooks");
 
-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();
+//#region src/express.ts
+const expressLoggerStorage = new node_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;
+	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 } : {}
-  };
+	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
+const baseUseLogger = require_core.createUseLogger({
+	adapterName: "express",
+	enrich: enrichFromRequest
 });
 function useLogger(request, requestLoggerOptions) {
-  const stored = expressLoggerStorage.getStore();
-  if (stored) return stored;
-  return baseUseLogger(request, requestLoggerOptions);
+	const stored = expressLoggerStorage.getStore();
+	if (stored) return stored;
+	return baseUseLogger(request, requestLoggerOptions);
 }
-var runRequest = createRequestRunner(expressLoggerStorage);
+const runRequest = require_core.createRequestRunner(expressLoggerStorage);
+/**
+* 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`.
+*/
 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;
-    }
-  };
+	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;
+			}
+			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)
-  };
+	return {
+		withAutotel: (handler) => withAutotel(handler, options),
+		useLogger,
+		parseError: (error) => (0, autotel.parseError)(error),
+		createStructuredError: (input) => (0, autotel.createStructuredError)(input),
+		createDrainPipeline: (drainOptions) => (0, autotel.createDrainPipeline)(drainOptions)
+	};
 }
-var expressToolkit = createAdapterToolkit({
-  adapterName: "express",
-  enrich: enrichFromRequest
+const expressToolkit = require_core.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; }
-});
+//#endregion
+exports.createDrainPipeline = autotel.createDrainPipeline;
 exports.createExpressAdapter = createExpressAdapter;
+exports.createStructuredError = autotel.createStructuredError;
 exports.expressToolkit = expressToolkit;
+exports.parseError = autotel.parseError;
 exports.useLogger = useLogger;
 exports.withAutotel = withAutotel;
-//# sourceMappingURL=express.cjs.map
 //# sourceMappingURL=express.cjs.map

package/dist/express.cjs.map

@@ -1 +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"]}
+{"version":3,"file":"express.cjs","names":["AsyncLocalStorage","createUseLogger","createRequestRunner","createAdapterToolkit"],"sources":["../src/express.ts"],"sourcesContent":["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"],"mappings":";;;;;;AA0CA,MAAM,uBAAuB,IAAIA,mCAAiC;AAElE,SAAS,YACP,SACA,MACoB;CACpB,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,QAAQ,QAAQ,SAAS,QAAQ,KAAK,YAAY;CACxD,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM;CACvC,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEA,SAAS,kBACP,SACqC;CACrC,IAAI,CAAC,SAAS,OAAO;CAErB,MAAM,MAAM,QAAQ,eAAe,QAAQ;CAC3C,MAAM,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,QAAQ;CACrD,MAAM,YAAY,YAAY,QAAQ,SAAS,cAAc;CAE7D,OAAO;EACL,GAAI,QAAQ,SAAS,EAAE,uBAAuB,QAAQ,OAAO,IAAI,CAAC;EAClE,GAAI,MAAM,EAAE,YAAY,IAAI,IAAI,CAAC;EACjC,GAAI,QAAQ,EAAE,cAAc,MAAM,IAAI,CAAC;EACvC,GAAI,YAAY,EAAE,mBAAmB,UAAU,IAAI,CAAC;CACtD;AACF;AAEA,MAAM,gBAAgBC,6BAAoC;CACxD,aAAa;CACb,QAAQ;AACV,CAAC;AAED,SAAgB,UACd,SACA,sBACe;CACf,MAAM,SAAS,qBAAqB,SAAS;CAC7C,IAAI,QAAQ,OAAO;CACnB,OAAO,cAAc,SAAS,oBAAoB;AACpD;AAEA,MAAM,aAAaC,iCAAoB,oBAAoB;;;;;;AAO3D,SAAgB,YAKd,SACA,SAC4E;CAC5E,OAAO,OACL,KACA,KACA,SACiC;EACjC,MAAM,WACJ,OAAO,SAAS,aAAa,aACzB,QAAQ,SAAS,GAAG,IACnB,SAAS,YAAY,WAAW,IAAI,UAAU;EAErD,IAAI;GACF,OAAO,MAAM,WACX,WACC,QAAQ;IACP,MAAM,OAAO,kBAAkB,GAAG;IAClC,IAAI,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI,IAAI,IAAI;IACtD,MAAM,SAAS,SAAS,SAAS,GAAG;IACpC,IAAI,UAAU,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,IAAI,MAAM;GAC9D,SACM,QAAQ,KAAK,KAAK,IAAI,GAC5B;IACE,sBAAsB,SAAS;IAC/B,UAAU,SAAS;IACnB,gBACE,IAAI,aACA,EAAE,6BAA6B,IAAI,WAAW,IAC9C;GACR,CACF;EACF,SAAS,OAAO;GACd,IAAI,OAAO,SAAS,YAAY;IAC9B,KAAK,KAAK;IACV;GACF;GACA,MAAM;EACR;CACF;AACF;AAEA,SAAgB,qBAAqB,SAAqC;CACxE,OAAO;EACL,cAKE,YAKG,YAAY,SAAS,OAAO;EACjC;EACA,aAAa,kCAA2C,KAAK;EAC7D,wBAAwB,6CACA,KAAK;EAC7B,sBACE,kDAEoB,YAAY;CACpC;AACF;AAEA,MAAa,iBAAiBC,kCAAyC;CACrE,aAAa;CACb,QAAQ;AACV,CAAC"}

package/dist/express.d.cts

@@ -1,28 +1,27 @@
-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';
+import { AdapterToolkit } from "./core.cjs";
+import { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput, createDrainPipeline, createStructuredError, parseError } from "autotel";
 
+//#region src/express.d.ts
 interface ExpressRequestLike {
-    method?: string;
-    originalUrl?: string;
-    url?: string;
+  method?: string;
+  originalUrl?: string;
+  url?: string;
+  path?: string;
+  route?: {
     path?: string;
-    route?: {
-        path?: string;
-    };
-    headers?: Record<string, string | string[] | undefined>;
+  };
+  headers?: Record<string, string | string[] | undefined>;
 }
 interface ExpressResponseLike {
-    statusCode?: number;
+  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;
+  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;
 /**
@@ -32,12 +31,13 @@ declare function useLogger(request?: ExpressRequestLike, requestLoggerOptions?:
  */
 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>);
+  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 };
+//#endregion
+export { ExpressNext, ExpressRequestLike, ExpressResponseLike, ExpressWithAutotelOptions, createDrainPipeline, createExpressAdapter, createStructuredError, expressToolkit, parseError, useLogger, withAutotel };
+//# sourceMappingURL=express.d.cts.map

package/dist/express.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.cts","names":[],"sources":["../src/express.ts"],"mappings":";;;;UAmBiB,kBAAA;EACf,MAAA;EACA,WAAA;EACA,GAAA;EACA,IAAA;EACA,KAAA;IAAU,IAAA;EAAA;EACV,OAAA,GAAU,MAAM;AAAA;AAAA,UAGD,mBAAA;EACf,UAAU;AAAA;AAAA,KAGA,WAAA,IAAe,GAAa;AAAA,UAEvB,yBAAA;EACf,QAAA,cAAsB,OAAA,EAAS,kBAAA;EAC/B,oBAAA,GAAuB,oBAAA;EACvB,MAAA,IAAU,OAAA,EAAS,kBAAA,KAAuB,MAAA;EATR;EAWlC,QAAA;AAAA;AAAA,iBAqCc,SAAA,CACd,OAAA,GAAU,kBAAA,EACV,oBAAA,GAAuB,oBAAA,GACtB,aAAA;AA/CH;;;;AAAwC;AAAxC,iBA4DgB,WAAA,cACD,kBAAA,eACA,mBAAA,WAGb,OAAA,GAAU,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,IAAA,GAAO,WAAA,KAAgB,OAAA,GAAU,OAAA,CAAQ,OAAA,GACzE,OAAA,GAAU,yBAAA,IACR,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,IAAA,GAAO,WAAA,KAAgB,OAAA,CAAQ,OAAA;AAAA,iBAwCzC,oBAAA,CAAqB,OAAA,GAAU,yBAAA;6BAG5B,kBAAA,eACA,mBAAA,WACN,OAAA,GAGL,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,IAAA,EACL,IAAA,GAAO,WAAA,KACJ,OAAA,GAAU,OAAA,CAAQ,OAAA,OAAQ,GAAA,EAAA,IAAA,EAAA,GAAA,EAAA,IAAA,EAAA,IAAA,GAnDJ,WAAA,KAAW,OAAA,CAAA,OAAA;;kCAsDV,WAAA;iCACC,oBAAA,KAAuB,eAAA;qCAE/B,YAAA,GACN,oBAAA,CAAqB,CAAA,QACjC,UAAA,GAAa,KAAA,EAAO,CAAA,cAAe,OAAA,WAAkB,eAAA,CAAgB,CAAA;AAAA;AAAA,cAKjE,cAAA,EAAc,cAAA,CAAA,kBAAA"}

package/dist/express.d.ts

@@ -1,28 +1,27 @@
-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';
+import { AdapterToolkit } from "./core.js";
+import { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput, createDrainPipeline, createStructuredError, parseError } from "autotel";
 
+//#region src/express.d.ts
 interface ExpressRequestLike {
-    method?: string;
-    originalUrl?: string;
-    url?: string;
+  method?: string;
+  originalUrl?: string;
+  url?: string;
+  path?: string;
+  route?: {
     path?: string;
-    route?: {
-        path?: string;
-    };
-    headers?: Record<string, string | string[] | undefined>;
+  };
+  headers?: Record<string, string | string[] | undefined>;
 }
 interface ExpressResponseLike {
-    statusCode?: number;
+  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;
+  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;
 /**
@@ -32,12 +31,13 @@ declare function useLogger(request?: ExpressRequestLike, requestLoggerOptions?:
  */
 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>);
+  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 };
+//#endregion
+export { ExpressNext, ExpressRequestLike, ExpressResponseLike, ExpressWithAutotelOptions, createDrainPipeline, createExpressAdapter, createStructuredError, expressToolkit, parseError, useLogger, withAutotel };
+//# sourceMappingURL=express.d.ts.map

package/dist/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","names":[],"sources":["../src/express.ts"],"mappings":";;;;UAmBiB,kBAAA;EACf,MAAA;EACA,WAAA;EACA,GAAA;EACA,IAAA;EACA,KAAA;IAAU,IAAA;EAAA;EACV,OAAA,GAAU,MAAM;AAAA;AAAA,UAGD,mBAAA;EACf,UAAU;AAAA;AAAA,KAGA,WAAA,IAAe,GAAa;AAAA,UAEvB,yBAAA;EACf,QAAA,cAAsB,OAAA,EAAS,kBAAA;EAC/B,oBAAA,GAAuB,oBAAA;EACvB,MAAA,IAAU,OAAA,EAAS,kBAAA,KAAuB,MAAA;EATR;EAWlC,QAAA;AAAA;AAAA,iBAqCc,SAAA,CACd,OAAA,GAAU,kBAAA,EACV,oBAAA,GAAuB,oBAAA,GACtB,aAAA;AA/CH;;;;AAAwC;AAAxC,iBA4DgB,WAAA,cACD,kBAAA,eACA,mBAAA,WAGb,OAAA,GAAU,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,IAAA,GAAO,WAAA,KAAgB,OAAA,GAAU,OAAA,CAAQ,OAAA,GACzE,OAAA,GAAU,yBAAA,IACR,GAAA,EAAK,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,IAAA,GAAO,WAAA,KAAgB,OAAA,CAAQ,OAAA;AAAA,iBAwCzC,oBAAA,CAAqB,OAAA,GAAU,yBAAA;6BAG5B,kBAAA,eACA,mBAAA,WACN,OAAA,GAGL,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,IAAA,EACL,IAAA,GAAO,WAAA,KACJ,OAAA,GAAU,OAAA,CAAQ,OAAA,OAAQ,GAAA,EAAA,IAAA,EAAA,GAAA,EAAA,IAAA,EAAA,IAAA,GAnDJ,WAAA,KAAW,OAAA,CAAA,OAAA;;kCAsDV,WAAA;iCACC,oBAAA,KAAuB,eAAA;qCAE/B,YAAA,GACN,oBAAA,CAAqB,CAAA,QACjC,UAAA,GAAa,KAAA,EAAO,CAAA,cAAe,OAAA,WAAkB,eAAA,CAAgB,CAAA;AAAA;AAAA,cAKjE,cAAA,EAAc,cAAA,CAAA,kBAAA"}

package/dist/express.js

@@ -1,4 +1,79 @@
-export { createDrainPipeline, createExpressAdapter, createStructuredError, expressToolkit, parseError, useLogger, withAutotel } from './chunk-2YPL66HM.js';
-import './chunk-DJ2OU3S6.js';
-//# sourceMappingURL=express.js.map
+import { createAdapterToolkit, createRequestRunner, createUseLogger } from "./core.js";
+import { createDrainPipeline, createStructuredError, parseError } from "autotel";
+import { AsyncLocalStorage } from "node:async_hooks";
+
+//#region src/express.ts
+const expressLoggerStorage = new 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 } : {}
+	};
+}
+const baseUseLogger = createUseLogger({
+	adapterName: "express",
+	enrich: enrichFromRequest
+});
+function useLogger(request, requestLoggerOptions) {
+	const stored = expressLoggerStorage.getStore();
+	if (stored) return stored;
+	return baseUseLogger(request, requestLoggerOptions);
+}
+const runRequest = createRequestRunner(expressLoggerStorage);
+/**
+* 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`.
+*/
+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;
+			}
+			throw error;
+		}
+	};
+}
+function createExpressAdapter(options) {
+	return {
+		withAutotel: (handler) => withAutotel(handler, options),
+		useLogger,
+		parseError: (error) => parseError(error),
+		createStructuredError: (input) => createStructuredError(input),
+		createDrainPipeline: (drainOptions) => createDrainPipeline(drainOptions)
+	};
+}
+const expressToolkit = createAdapterToolkit({
+	adapterName: "express",
+	enrich: enrichFromRequest
+});
+
+//#endregion
+export { createDrainPipeline, createExpressAdapter, createStructuredError, expressToolkit, parseError, useLogger, withAutotel };
 //# sourceMappingURL=express.js.map

package/dist/express.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"express.js"}
+{"version":3,"file":"express.js","names":[],"sources":["../src/express.ts"],"sourcesContent":["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"],"mappings":";;;;;AA0CA,MAAM,uBAAuB,IAAI,kBAAiC;AAElE,SAAS,YACP,SACA,MACoB;CACpB,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,QAAQ,QAAQ,SAAS,QAAQ,KAAK,YAAY;CACxD,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO,MAAM;CACvC,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEA,SAAS,kBACP,SACqC;CACrC,IAAI,CAAC,SAAS,OAAO;CAErB,MAAM,MAAM,QAAQ,eAAe,QAAQ;CAC3C,MAAM,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,QAAQ;CACrD,MAAM,YAAY,YAAY,QAAQ,SAAS,cAAc;CAE7D,OAAO;EACL,GAAI,QAAQ,SAAS,EAAE,uBAAuB,QAAQ,OAAO,IAAI,CAAC;EAClE,GAAI,MAAM,EAAE,YAAY,IAAI,IAAI,CAAC;EACjC,GAAI,QAAQ,EAAE,cAAc,MAAM,IAAI,CAAC;EACvC,GAAI,YAAY,EAAE,mBAAmB,UAAU,IAAI,CAAC;CACtD;AACF;AAEA,MAAM,gBAAgB,gBAAoC;CACxD,aAAa;CACb,QAAQ;AACV,CAAC;AAED,SAAgB,UACd,SACA,sBACe;CACf,MAAM,SAAS,qBAAqB,SAAS;CAC7C,IAAI,QAAQ,OAAO;CACnB,OAAO,cAAc,SAAS,oBAAoB;AACpD;AAEA,MAAM,aAAa,oBAAoB,oBAAoB;;;;;;AAO3D,SAAgB,YAKd,SACA,SAC4E;CAC5E,OAAO,OACL,KACA,KACA,SACiC;EACjC,MAAM,WACJ,OAAO,SAAS,aAAa,aACzB,QAAQ,SAAS,GAAG,IACnB,SAAS,YAAY,WAAW,IAAI,UAAU;EAErD,IAAI;GACF,OAAO,MAAM,WACX,WACC,QAAQ;IACP,MAAM,OAAO,kBAAkB,GAAG;IAClC,IAAI,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI,IAAI,IAAI;IACtD,MAAM,SAAS,SAAS,SAAS,GAAG;IACpC,IAAI,UAAU,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,GAAG,IAAI,IAAI,MAAM;GAC9D,SACM,QAAQ,KAAK,KAAK,IAAI,GAC5B;IACE,sBAAsB,SAAS;IAC/B,UAAU,SAAS;IACnB,gBACE,IAAI,aACA,EAAE,6BAA6B,IAAI,WAAW,IAC9C;GACR,CACF;EACF,SAAS,OAAO;GACd,IAAI,OAAO,SAAS,YAAY;IAC9B,KAAK,KAAK;IACV;GACF;GACA,MAAM;EACR;CACF;AACF;AAEA,SAAgB,qBAAqB,SAAqC;CACxE,OAAO;EACL,cAKE,YAKG,YAAY,SAAS,OAAO;EACjC;EACA,aAAa,UAAgC,WAAW,KAAK;EAC7D,wBAAwB,UACtB,sBAAsB,KAAK;EAC7B,sBACE,iBAEA,oBAAoB,YAAY;CACpC;AACF;AAEA,MAAa,iBAAiB,qBAAyC;CACrE,aAAa;CACb,QAAQ;AACV,CAAC"}