autotel-adapters 0.3.18 → 1.0.0

package/README.md

@@ -12,8 +12,21 @@ Composable framework adapters and DX helpers for `autotel`.
 - `autotel-adapters/next`
 - `autotel-adapters/nitro`
 - `autotel-adapters/cloudflare`
+- `autotel-adapters/express`
+- `autotel-adapters/fastify`
+- `autotel-adapters/nestjs`
+- `autotel-adapters/sveltekit`
+- `autotel-adapters/elysia`
+- `autotel-adapters/toolkit` (custom framework integrations)
+- `autotel-adapters/toolkit/storage` (edge-safe ALS helper)
 - `autotel-adapters/core` (build your own adapter)
 
+## Custom frameworks
+
+Use `defineFrameworkIntegration()` from `autotel-adapters/toolkit` to wire a new HTTP framework. See `examples/community-framework-skeleton/` for a minimal skeleton.
+
+Toolkit options include route `include` / `exclude`, per-route `service`, serverless `waitUntil`, streaming `finishResponse`, and request-level `keep` callbacks.
+
 ## When to use `withAutotel` vs `useLogger` alone
 
 Each adapter exports two patterns. Choose based on whether you already have

package/dist/cloudflare.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_integration = require('./integration-Dd8Pi7jc.cjs');
 const require_core = require('./core.cjs');
 let autotel = require("autotel");
 
@@ -34,41 +35,55 @@ function useLogger(request, requestLoggerOptions) {
 	}
 	return baseUseLogger(request, requestLoggerOptions);
 }
+function resolvePath(request) {
+	if (!request.url) return "/";
+	try {
+		return new URL(request.url).pathname;
+	} catch {
+		return request.url;
+	}
+}
+function createIntegration() {
+	return require_integration.defineFrameworkIntegration({
+		name: "cloudflare",
+		extractRequest: ({ request }) => ({
+			method: request.method ?? "GET",
+			path: resolvePath(request),
+			headers: request.headers,
+			requestId: require_core.getHeader(request.headers, "x-request-id") ?? require_core.getHeader(request.headers, "cf-ray")
+		}),
+		attachLogger: ({ request }, logger) => {
+			requestLoggers.set(request, logger);
+		},
+		extractWaitUntil: ({ executionContext }) => {
+			return typeof executionContext.waitUntil === "function" ? executionContext.waitUntil.bind(executionContext) : void 0;
+		}
+	});
+}
+const integration = createIntegration();
+function resolveSpanName(request, env, options) {
+	if (typeof options?.spanName === "function") return options.spanName(request, env);
+	return options?.spanName ?? `cloudflare.${request.method ?? "request"}`;
+}
 function withAutotelFetch(handler, options) {
 	return async (request, env, executionContext) => {
-		return await (0, autotel.trace)({ name: typeof options?.spanName === "function" ? options.spanName(request, env) : options?.spanName ?? `cloudflare.${request.method ?? "request"}` }, (ctx) => async (innerRequest, innerEnv, innerExecutionContext) => {
-			const log = (0, autotel.getRequestLogger)(ctx, options?.requestLoggerOptions);
-			const auto = enrichFromRequest(innerRequest);
-			if (auto && Object.keys(auto).length > 0) log.set(auto);
-			const custom = options?.enrich?.(innerRequest, innerEnv, innerExecutionContext);
-			if (custom && Object.keys(custom).length > 0) log.set(custom);
-			requestLoggers.set(innerRequest, log);
-			try {
-				return await handler(innerRequest, innerEnv, innerExecutionContext);
-			} finally {
-				if (options?.autoEmit !== false) log.emitNow();
-				requestLoggers.delete(innerRequest);
-			}
-		})(request, env, executionContext);
+		const ctx = {
+			request,
+			env,
+			executionContext
+		};
+		try {
+			return await integration.runTraced(ctx, require_integration.buildTracedOptions(options, resolveSpanName(request, env, options)), async (handle) => require_integration.runWithIntegratedHandle(handle, options, async () => {
+				require_integration.applyLoggerEnrichment(handle.logger, enrichFromRequest(request), options?.enrichRequest?.(request, env, executionContext));
+				return handler(request, env, executionContext);
+			}));
+		} finally {
+			requestLoggers.delete(request);
+		}
 	};
 }
-function createCloudflareAdapter(options) {
-	return {
-		withAutotelFetch: (handler) => withAutotelFetch(handler, options),
-		useLogger,
-		parseError: (error) => (0, autotel.parseError)(error),
-		createStructuredError: (input) => (0, autotel.createStructuredError)(input),
-		createDrainPipeline: (drainOptions) => (0, autotel.createDrainPipeline)(drainOptions)
-	};
-}
-const cloudflareToolkit = require_core.createAdapterToolkit({
-	adapterName: "cloudflare",
-	enrich: enrichFromRequest
-});
 
 //#endregion
-exports.cloudflareToolkit = cloudflareToolkit;
-exports.createCloudflareAdapter = createCloudflareAdapter;
 exports.createDrainPipeline = autotel.createDrainPipeline;
 exports.createStructuredError = autotel.createStructuredError;
 exports.parseError = autotel.parseError;

package/dist/cloudflare.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.cjs","names":["getHeader","createUseLogger","createAdapterToolkit"],"sources":["../src/cloudflare.ts"],"sourcesContent":["import {\n  createDrainPipeline,\n  createStructuredError,\n  getRequestLogger,\n  parseError,\n  trace,\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 { createAdapterToolkit, createUseLogger, getHeader } from './core';\n\nexport interface CloudflareRequestLike {\n  method?: string;\n  url?: string;\n  headers?:\n    | { get(name: string): string | null }\n    | Record<string, string | undefined>;\n  cf?: Record<string, unknown>;\n}\n\nexport interface CloudflareExecutionContextLike {\n  waitUntil?: (promise: Promise<unknown>) => void;\n  passThroughOnException?: () => void;\n}\n\nexport interface CloudflareWithAutotelOptions<TEnv = unknown> {\n  spanName?: string | ((request: CloudflareRequestLike, env: TEnv) => string);\n  requestLoggerOptions?: RequestLoggerOptions;\n  enrich?: (\n    request: CloudflareRequestLike,\n    env: TEnv,\n    ctx: CloudflareExecutionContextLike,\n  ) => Record<string, unknown> | undefined;\n  /** Emit one wide event automatically when the handler settles. Default `true`. */\n  autoEmit?: boolean;\n}\n\nconst requestLoggers = new WeakMap<object, RequestLogger>();\n\nfunction enrichFromRequest(\n  request?: CloudflareRequestLike,\n): Record<string, unknown> | undefined {\n  if (!request) return undefined;\n\n  let route = '/';\n  if (request.url) {\n    try {\n      route = new URL(request.url).pathname;\n    } catch {\n      route = request.url;\n    }\n  }\n\n  const requestId =\n    getHeader(request.headers, 'x-request-id') ??\n    getHeader(request.headers, 'cf-ray');\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    ...(request.cf?.country ? { 'cloudflare.country': request.cf.country } : {}),\n    ...(request.cf?.colo ? { 'cloudflare.colo': request.cf.colo } : {}),\n    ...(request.cf?.city ? { 'cloudflare.city': request.cf.city } : {}),\n  };\n}\n\nconst baseUseLogger = createUseLogger<CloudflareRequestLike>({\n  adapterName: 'cloudflare',\n  enrich: enrichFromRequest,\n});\n\nexport function useLogger(\n  request?: CloudflareRequestLike,\n  requestLoggerOptions?: RequestLoggerOptions,\n): RequestLogger {\n  if (request) {\n    const existing = requestLoggers.get(request as object);\n    if (existing) return existing;\n  }\n  return baseUseLogger(request, requestLoggerOptions);\n}\n\nexport function withAutotelFetch<\n  TEnv,\n  TRequest extends CloudflareRequestLike,\n  TContext extends CloudflareExecutionContextLike,\n  TReturn,\n>(\n  handler: (\n    request: TRequest,\n    env: TEnv,\n    ctx: TContext,\n  ) => TReturn | Promise<TReturn>,\n  options?: CloudflareWithAutotelOptions<TEnv>,\n): (\n  request: TRequest,\n  env: TEnv,\n  ctx: TContext,\n) => Promise<TReturn> {\n  return async (\n    request: TRequest,\n    env: TEnv,\n    executionContext: TContext,\n  ): Promise<TReturn> => {\n    const spanName =\n      typeof options?.spanName === 'function'\n        ? options.spanName(request, env)\n        : (options?.spanName ?? `cloudflare.${request.method ?? 'request'}`);\n\n    const wrapped = trace(\n      { name: spanName },\n      (ctx) => async (\n        innerRequest: TRequest,\n        innerEnv: TEnv,\n        innerExecutionContext: TContext,\n      ) => {\n        const log = getRequestLogger(ctx, options?.requestLoggerOptions);\n        const auto = enrichFromRequest(innerRequest);\n        if (auto && Object.keys(auto).length > 0) {\n          log.set(auto);\n        }\n        const custom = options?.enrich?.(\n          innerRequest,\n          innerEnv,\n          innerExecutionContext,\n        );\n        if (custom && Object.keys(custom).length > 0) {\n          log.set(custom);\n        }\n\n        requestLoggers.set(innerRequest as object, log);\n        try {\n          return await handler(innerRequest, innerEnv, innerExecutionContext);\n        } finally {\n          if (options?.autoEmit !== false) {\n            log.emitNow();\n          }\n          requestLoggers.delete(innerRequest as object);\n        }\n      },\n    );\n\n    return await wrapped(request, env, executionContext);\n  };\n}\n\nexport function createCloudflareAdapter<TEnv = unknown>(\n  options?: CloudflareWithAutotelOptions<TEnv>,\n) {\n  return {\n    withAutotelFetch: <\n      TRequest extends CloudflareRequestLike,\n      TContext extends CloudflareExecutionContextLike,\n      TReturn,\n    >(\n      handler: (\n        request: TRequest,\n        env: TEnv,\n        ctx: TContext,\n      ) => TReturn | Promise<TReturn>,\n    ) => withAutotelFetch(handler, options),\n    useLogger,\n    parseError: (error: unknown): ParsedError => parseError(error),\n    createStructuredError: (\n      input: StructuredErrorInput,\n    ): StructuredError => 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 cloudflareToolkit = createAdapterToolkit<CloudflareRequestLike>({\n  adapterName: 'cloudflare',\n  enrich: enrichFromRequest,\n});\n\nexport { parseError, createDrainPipeline, createStructuredError };\n"],"mappings":";;;;;AA0CA,MAAM,iCAAiB,IAAI,QAA+B;AAE1D,SAAS,kBACP,SACqC;CACrC,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI,QAAQ;CACZ,IAAI,QAAQ,KACV,IAAI;EACF,QAAQ,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;CAC/B,QAAQ;EACN,QAAQ,QAAQ;CAClB;CAGF,MAAM,YACJA,uBAAU,QAAQ,SAAS,cAAc,KACzCA,uBAAU,QAAQ,SAAS,QAAQ;CAErC,OAAO;EACL,GAAI,QAAQ,SAAS,EAAE,uBAAuB,QAAQ,OAAO,IAAI,CAAC;EAClE,GAAI,QAAQ,MAAM,EAAE,YAAY,QAAQ,IAAI,IAAI,CAAC;EACjD,GAAI,QAAQ,EAAE,cAAc,MAAM,IAAI,CAAC;EACvC,GAAI,YAAY,EAAE,mBAAmB,UAAU,IAAI,CAAC;EACpD,GAAI,QAAQ,IAAI,UAAU,EAAE,sBAAsB,QAAQ,GAAG,QAAQ,IAAI,CAAC;EAC1E,GAAI,QAAQ,IAAI,OAAO,EAAE,mBAAmB,QAAQ,GAAG,KAAK,IAAI,CAAC;EACjE,GAAI,QAAQ,IAAI,OAAO,EAAE,mBAAmB,QAAQ,GAAG,KAAK,IAAI,CAAC;CACnE;AACF;AAEA,MAAM,gBAAgBC,6BAAuC;CAC3D,aAAa;CACb,QAAQ;AACV,CAAC;AAED,SAAgB,UACd,SACA,sBACe;CACf,IAAI,SAAS;EACX,MAAM,WAAW,eAAe,IAAI,OAAiB;EACrD,IAAI,UAAU,OAAO;CACvB;CACA,OAAO,cAAc,SAAS,oBAAoB;AACpD;AAEA,SAAgB,iBAMd,SAKA,SAKoB;CACpB,OAAO,OACL,SACA,KACA,qBACqB;EAuCrB,OAAO,yBAhCL,EAAE,MALF,OAAO,SAAS,aAAa,aACzB,QAAQ,SAAS,SAAS,GAAG,IAC5B,SAAS,YAAY,cAAc,QAAQ,UAAU,YAGzC,IAChB,QAAQ,OACP,cACA,UACA,0BACG;GACH,MAAM,oCAAuB,KAAK,SAAS,oBAAoB;GAC/D,MAAM,OAAO,kBAAkB,YAAY;GAC3C,IAAI,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,GACrC,IAAI,IAAI,IAAI;GAEd,MAAM,SAAS,SAAS,SACtB,cACA,UACA,qBACF;GACA,IAAI,UAAU,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,GACzC,IAAI,IAAI,MAAM;GAGhB,eAAe,IAAI,cAAwB,GAAG;GAC9C,IAAI;IACF,OAAO,MAAM,QAAQ,cAAc,UAAU,qBAAqB;GACpE,UAAU;IACR,IAAI,SAAS,aAAa,OACxB,IAAI,QAAQ;IAEd,eAAe,OAAO,YAAsB;GAC9C;EACF,CAGiB,CAAC,CAAC,SAAS,KAAK,gBAAgB;CACrD;AACF;AAEA,SAAgB,wBACd,SACA;CACA,OAAO;EACL,mBAKE,YAKG,iBAAiB,SAAS,OAAO;EACtC;EACA,aAAa,kCAA2C,KAAK;EAC7D,wBACE,6CAC0C,KAAK;EACjD,sBACE,kDAEoB,YAAY;CACpC;AACF;AAEA,MAAa,oBAAoBC,kCAA4C;CAC3E,aAAa;CACb,QAAQ;AACV,CAAC"}
+{"version":3,"file":"cloudflare.cjs","names":["getHeader","createUseLogger","defineFrameworkIntegration","buildTracedOptions","runWithIntegratedHandle"],"sources":["../src/cloudflare.ts"],"sourcesContent":["import {\n  createDrainPipeline,\n  createStructuredError,\n  parseError,\n  type RequestLogger,\n  type RequestLoggerOptions,\n} from 'autotel';\nimport {\n  createUseLogger,\n  getHeader,\n  type FrameworkHandlerOptions,\n} from './core';\nimport {\n  applyLoggerEnrichment,\n  defineFrameworkIntegration,\n  runWithIntegratedHandle,\n  buildTracedOptions,\n} from './toolkit/integration';\n\nexport interface CloudflareRequestLike {\n  method?: string;\n  url?: string;\n  headers?:\n    | { get(name: string): string | null }\n    | Record<string, string | undefined>;\n  cf?: Record<string, unknown>;\n}\n\nexport interface CloudflareExecutionContextLike {\n  waitUntil?: (promise: Promise<unknown>) => void;\n  passThroughOnException?: () => void;\n}\n\nexport interface CloudflareHandlerContext<\n  TEnv,\n  TRequest extends CloudflareRequestLike,\n  TContext extends CloudflareExecutionContextLike,\n> {\n  request: TRequest;\n  env: TEnv;\n  executionContext: TContext;\n}\n\nexport interface CloudflareWithAutotelOptions<TEnv = unknown>\n  extends Omit<FrameworkHandlerOptions, 'spanName'> {\n  spanName?: string | ((request: CloudflareRequestLike, env: TEnv) => string);\n  enrichRequest?: (\n    request: CloudflareRequestLike,\n    env: TEnv,\n    ctx: CloudflareExecutionContextLike,\n  ) => Record<string, unknown> | undefined;\n}\n\nconst requestLoggers = new WeakMap<object, RequestLogger>();\n\nfunction enrichFromRequest(\n  request?: CloudflareRequestLike,\n): Record<string, unknown> | undefined {\n  if (!request) return undefined;\n\n  let route = '/';\n  if (request.url) {\n    try {\n      route = new URL(request.url).pathname;\n    } catch {\n      route = request.url;\n    }\n  }\n\n  const requestId =\n    getHeader(request.headers, 'x-request-id') ??\n    getHeader(request.headers, 'cf-ray');\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    ...(request.cf?.country ? { 'cloudflare.country': request.cf.country } : {}),\n    ...(request.cf?.colo ? { 'cloudflare.colo': request.cf.colo } : {}),\n    ...(request.cf?.city ? { 'cloudflare.city': request.cf.city } : {}),\n  };\n}\n\nconst baseUseLogger = createUseLogger<CloudflareRequestLike>({\n  adapterName: 'cloudflare',\n  enrich: enrichFromRequest,\n});\n\nexport function useLogger(\n  request?: CloudflareRequestLike,\n  requestLoggerOptions?: RequestLoggerOptions,\n): RequestLogger {\n  if (request) {\n    const existing = requestLoggers.get(request as object);\n    if (existing) return existing;\n  }\n  return baseUseLogger(request, requestLoggerOptions);\n}\n\nfunction resolvePath(request: CloudflareRequestLike): string {\n  if (!request.url) return '/';\n  try {\n    return new URL(request.url).pathname;\n  } catch {\n    return request.url;\n  }\n}\n\nfunction createIntegration<TEnv>() {\n  return defineFrameworkIntegration<\n    CloudflareHandlerContext<TEnv, CloudflareRequestLike, CloudflareExecutionContextLike>\n  >({\n    name: 'cloudflare',\n    extractRequest: ({ request }) => ({\n      method: request.method ?? 'GET',\n      path: resolvePath(request),\n      headers: request.headers,\n      requestId:\n        getHeader(request.headers, 'x-request-id') ??\n        getHeader(request.headers, 'cf-ray'),\n    }),\n    attachLogger: ({ request }, logger) => {\n      requestLoggers.set(request as object, logger);\n    },\n    extractWaitUntil: ({ executionContext }) => {\n      const waitUntil =\n        typeof executionContext.waitUntil === 'function'\n          ? executionContext.waitUntil.bind(executionContext)\n          : undefined;\n      return waitUntil;\n    },\n  });\n}\n\nconst integration = createIntegration<unknown>();\n\nfunction resolveSpanName<TEnv>(\n  request: CloudflareRequestLike,\n  env: TEnv,\n  options?: CloudflareWithAutotelOptions<TEnv>,\n): string {\n  if (typeof options?.spanName === 'function') {\n    return options.spanName(request, env);\n  }\n  return options?.spanName ?? `cloudflare.${request.method ?? 'request'}`;\n}\n\nexport function withAutotelFetch<\n  TEnv,\n  TRequest extends CloudflareRequestLike,\n  TContext extends CloudflareExecutionContextLike,\n  TReturn,\n>(\n  handler: (\n    request: TRequest,\n    env: TEnv,\n    ctx: TContext,\n  ) => TReturn | Promise<TReturn>,\n  options?: CloudflareWithAutotelOptions<TEnv>,\n): (\n  request: TRequest,\n  env: TEnv,\n  ctx: TContext,\n) => Promise<TReturn> {\n  return async (\n    request: TRequest,\n    env: TEnv,\n    executionContext: TContext,\n  ): Promise<TReturn> => {\n    const ctx = { request, env, executionContext };\n    try {\n      return await integration.runTraced(\n        ctx,\n        buildTracedOptions(options, resolveSpanName(request, env, options)),\n        async (handle) =>\n          runWithIntegratedHandle(handle, options, async () => {\n            applyLoggerEnrichment(\n              handle.logger,\n              enrichFromRequest(request),\n              options?.enrichRequest?.(request, env, executionContext),\n            );\n            return handler(request, env, executionContext);\n          }),\n      );\n    } finally {\n      requestLoggers.delete(request as object);\n    }\n  };\n}\n\nexport { parseError, createDrainPipeline, createStructuredError };\n"],"mappings":";;;;;;AAqDA,MAAM,iCAAiB,IAAI,QAA+B;AAE1D,SAAS,kBACP,SACqC;CACrC,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI,QAAQ;CACZ,IAAI,QAAQ,KACV,IAAI;EACF,QAAQ,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;CAC/B,QAAQ;EACN,QAAQ,QAAQ;CAClB;CAGF,MAAM,YACJA,uBAAU,QAAQ,SAAS,cAAc,KACzCA,uBAAU,QAAQ,SAAS,QAAQ;CAErC,OAAO;EACL,GAAI,QAAQ,SAAS,EAAE,uBAAuB,QAAQ,OAAO,IAAI,CAAC;EAClE,GAAI,QAAQ,MAAM,EAAE,YAAY,QAAQ,IAAI,IAAI,CAAC;EACjD,GAAI,QAAQ,EAAE,cAAc,MAAM,IAAI,CAAC;EACvC,GAAI,YAAY,EAAE,mBAAmB,UAAU,IAAI,CAAC;EACpD,GAAI,QAAQ,IAAI,UAAU,EAAE,sBAAsB,QAAQ,GAAG,QAAQ,IAAI,CAAC;EAC1E,GAAI,QAAQ,IAAI,OAAO,EAAE,mBAAmB,QAAQ,GAAG,KAAK,IAAI,CAAC;EACjE,GAAI,QAAQ,IAAI,OAAO,EAAE,mBAAmB,QAAQ,GAAG,KAAK,IAAI,CAAC;CACnE;AACF;AAEA,MAAM,gBAAgBC,6BAAuC;CAC3D,aAAa;CACb,QAAQ;AACV,CAAC;AAED,SAAgB,UACd,SACA,sBACe;CACf,IAAI,SAAS;EACX,MAAM,WAAW,eAAe,IAAI,OAAiB;EACrD,IAAI,UAAU,OAAO;CACvB;CACA,OAAO,cAAc,SAAS,oBAAoB;AACpD;AAEA,SAAS,YAAY,SAAwC;CAC3D,IAAI,CAAC,QAAQ,KAAK,OAAO;CACzB,IAAI;EACF,OAAO,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;CAC9B,QAAQ;EACN,OAAO,QAAQ;CACjB;AACF;AAEA,SAAS,oBAA0B;CACjC,OAAOC,+CAEL;EACA,MAAM;EACN,iBAAiB,EAAE,eAAe;GAChC,QAAQ,QAAQ,UAAU;GAC1B,MAAM,YAAY,OAAO;GACzB,SAAS,QAAQ;GACjB,WACEF,uBAAU,QAAQ,SAAS,cAAc,KACzCA,uBAAU,QAAQ,SAAS,QAAQ;EACvC;EACA,eAAe,EAAE,WAAW,WAAW;GACrC,eAAe,IAAI,SAAmB,MAAM;EAC9C;EACA,mBAAmB,EAAE,uBAAuB;GAK1C,OAHE,OAAO,iBAAiB,cAAc,aAClC,iBAAiB,UAAU,KAAK,gBAAgB,IAChD;EAER;CACF,CAAC;AACH;AAEA,MAAM,cAAc,kBAA2B;AAE/C,SAAS,gBACP,SACA,KACA,SACQ;CACR,IAAI,OAAO,SAAS,aAAa,YAC/B,OAAO,QAAQ,SAAS,SAAS,GAAG;CAEtC,OAAO,SAAS,YAAY,cAAc,QAAQ,UAAU;AAC9D;AAEA,SAAgB,iBAMd,SAKA,SAKoB;CACpB,OAAO,OACL,SACA,KACA,qBACqB;EACrB,MAAM,MAAM;GAAE;GAAS;GAAK;EAAiB;EAC7C,IAAI;GACF,OAAO,MAAM,YAAY,UACvB,KACAG,uCAAmB,SAAS,gBAAgB,SAAS,KAAK,OAAO,CAAC,GAClE,OAAO,WACLC,4CAAwB,QAAQ,SAAS,YAAY;IACnD,0CACE,OAAO,QACP,kBAAkB,OAAO,GACzB,SAAS,gBAAgB,SAAS,KAAK,gBAAgB,CACzD;IACA,OAAO,QAAQ,SAAS,KAAK,gBAAgB;GAC/C,CAAC,CACL;EACF,UAAU;GACR,eAAe,OAAO,OAAiB;EACzC;CACF;AACF"}

package/dist/cloudflare.d.cts

@@ -1,5 +1,5 @@
-import { AdapterToolkit } from "./core.cjs";
-import { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput, createDrainPipeline, createStructuredError, parseError } from "autotel";
+import { n as FrameworkHandlerOptions } from "./integration-7--zN-83.cjs";
+import { RequestLogger, RequestLoggerOptions, createDrainPipeline, createStructuredError, parseError } from "autotel";
 
 //#region src/cloudflare.d.ts
 interface CloudflareRequestLike {
@@ -14,23 +14,17 @@ interface CloudflareExecutionContextLike {
   waitUntil?: (promise: Promise<unknown>) => void;
   passThroughOnException?: () => void;
 }
-interface CloudflareWithAutotelOptions<TEnv = unknown> {
+interface CloudflareHandlerContext<TEnv, TRequest extends CloudflareRequestLike, TContext extends CloudflareExecutionContextLike> {
+  request: TRequest;
+  env: TEnv;
+  executionContext: TContext;
+}
+interface CloudflareWithAutotelOptions<TEnv = unknown> extends Omit<FrameworkHandlerOptions, 'spanName'> {
   spanName?: string | ((request: CloudflareRequestLike, env: TEnv) => string);
-  requestLoggerOptions?: RequestLoggerOptions;
-  enrich?: (request: CloudflareRequestLike, env: TEnv, ctx: CloudflareExecutionContextLike) => Record<string, unknown> | undefined;
-  /** Emit one wide event automatically when the handler settles. Default `true`. */
-  autoEmit?: boolean;
+  enrichRequest?: (request: CloudflareRequestLike, env: TEnv, ctx: CloudflareExecutionContextLike) => Record<string, unknown> | undefined;
 }
 declare function useLogger(request?: CloudflareRequestLike, requestLoggerOptions?: RequestLoggerOptions): RequestLogger;
 declare function withAutotelFetch<TEnv, TRequest extends CloudflareRequestLike, TContext extends CloudflareExecutionContextLike, TReturn>(handler: (request: TRequest, env: TEnv, ctx: TContext) => TReturn | Promise<TReturn>, options?: CloudflareWithAutotelOptions<TEnv>): (request: TRequest, env: TEnv, ctx: TContext) => Promise<TReturn>;
-declare function createCloudflareAdapter<TEnv = unknown>(options?: CloudflareWithAutotelOptions<TEnv>): {
-  withAutotelFetch: <TRequest extends CloudflareRequestLike, TContext extends CloudflareExecutionContextLike, TReturn>(handler: (request: TRequest, env: TEnv, ctx: TContext) => TReturn | Promise<TReturn>) => (request: TRequest, env: TEnv, ctx: TContext) => 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 cloudflareToolkit: AdapterToolkit<CloudflareRequestLike>;
 //#endregion
-export { CloudflareExecutionContextLike, CloudflareRequestLike, CloudflareWithAutotelOptions, cloudflareToolkit, createCloudflareAdapter, createDrainPipeline, createStructuredError, parseError, useLogger, withAutotelFetch };
+export { CloudflareExecutionContextLike, CloudflareHandlerContext, CloudflareRequestLike, CloudflareWithAutotelOptions, createDrainPipeline, createStructuredError, parseError, useLogger, withAutotelFetch };
 //# sourceMappingURL=cloudflare.d.cts.map

package/dist/cloudflare.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.cts","names":[],"sources":["../src/cloudflare.ts"],"mappings":";;;;UAgBiB,qBAAA;EACf,MAAA;EACA,GAAA;EACA,OAAA;IACM,GAAA,CAAI,IAAA;EAAA,IACN,MAAA;EACJ,EAAA,GAAK,MAAM;AAAA;AAAA,UAGI,8BAAA;EACf,SAAA,IAAa,OAAA,EAAS,OAAO;EAC7B,sBAAA;AAAA;AAAA,UAGe,4BAAA;EACf,QAAA,cAAsB,OAAA,EAAS,qBAAA,EAAuB,GAAA,EAAK,IAAA;EAC3D,oBAAA,GAAuB,oBAAA;EACvB,MAAA,IACE,OAAA,EAAS,qBAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,8BAAA,KACF,MAAA;EAfM;EAiBX,QAAA;AAAA;AAAA,iBAuCc,SAAA,CACd,OAAA,GAAU,qBAAA,EACV,oBAAA,GAAuB,oBAAA,GACtB,aAAA;AAAA,iBAQa,gBAAA,wBAEG,qBAAA,mBACA,8BAAA,WAGjB,OAAA,GACE,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,GAAU,OAAA,CAAQ,OAAA,GACvB,OAAA,GAAU,4BAAA,CAA6B,IAAA,KAEvC,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,CAAQ,OAAA;AAAA,iBAgDG,uBAAA,iBACd,OAAA,GAAU,4BAAA,CAA6B,IAAA;sCAIlB,qBAAA,mBACA,8BAAA,WACV,OAAA,GAGL,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,GAAU,OAAA,CAAQ,OAAA,OAAQ,OAAA,EAAA,QAAA,EAAA,GAAA,EAAA,IAAA,EAAA,GAAA,EAAA,QAAA,KAAA,OAAA,CAAA,OAAA;;kCAGH,WAAA;iCAErB,oBAAA,KACN,eAAA;qCACoB,YAAA,GACN,oBAAA,CAAqB,CAAA,QACjC,UAAA,GAAa,KAAA,EAAO,CAAA,cAAe,OAAA,WAAkB,eAAA,CAAgB,CAAA;AAAA;AAAA,cAKjE,iBAAA,EAAiB,cAAA,CAAA,qBAAA"}
+{"version":3,"file":"cloudflare.d.cts","names":[],"sources":["../src/cloudflare.ts"],"mappings":";;;;UAmBiB,qBAAA;EACf,MAAA;EACA,GAAA;EACA,OAAA;IACM,GAAA,CAAI,IAAA;EAAA,IACN,MAAA;EACJ,EAAA,GAAK,MAAM;AAAA;AAAA,UAGI,8BAAA;EACf,SAAA,IAAa,OAAA,EAAS,OAAO;EAC7B,sBAAA;AAAA;AAAA,UAGe,wBAAA,wBAEE,qBAAA,mBACA,8BAAA;EAEjB,OAAA,EAAS,QAAA;EACT,GAAA,EAAK,IAAA;EACL,gBAAA,EAAkB,QAAA;AAAA;AAAA,UAGH,4BAAA,yBACP,IAAA,CAAK,uBAAA;EACb,QAAA,cAAsB,OAAA,EAAS,qBAAA,EAAuB,GAAA,EAAK,IAAA;EAC3D,aAAA,IACE,OAAA,EAAS,qBAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,8BAAA,KACF,MAAA;AAAA;AAAA,iBAuCS,SAAA,CACd,OAAA,GAAU,qBAAA,EACV,oBAAA,GAAuB,oBAAA,GACtB,aAAA;AAAA,iBAwDa,gBAAA,wBAEG,qBAAA,mBACA,8BAAA,WAGjB,OAAA,GACE,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,GAAU,OAAA,CAAQ,OAAA,GACvB,OAAA,GAAU,4BAAA,CAA6B,IAAA,KAEvC,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,CAAQ,OAAA"}

package/dist/cloudflare.d.ts

@@ -1,5 +1,5 @@
-import { AdapterToolkit } from "./core.js";
-import { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput, createDrainPipeline, createStructuredError, parseError } from "autotel";
+import { n as FrameworkHandlerOptions } from "./integration-CaG_l5xr.js";
+import { RequestLogger, RequestLoggerOptions, createDrainPipeline, createStructuredError, parseError } from "autotel";
 
 //#region src/cloudflare.d.ts
 interface CloudflareRequestLike {
@@ -14,23 +14,17 @@ interface CloudflareExecutionContextLike {
   waitUntil?: (promise: Promise<unknown>) => void;
   passThroughOnException?: () => void;
 }
-interface CloudflareWithAutotelOptions<TEnv = unknown> {
+interface CloudflareHandlerContext<TEnv, TRequest extends CloudflareRequestLike, TContext extends CloudflareExecutionContextLike> {
+  request: TRequest;
+  env: TEnv;
+  executionContext: TContext;
+}
+interface CloudflareWithAutotelOptions<TEnv = unknown> extends Omit<FrameworkHandlerOptions, 'spanName'> {
   spanName?: string | ((request: CloudflareRequestLike, env: TEnv) => string);
-  requestLoggerOptions?: RequestLoggerOptions;
-  enrich?: (request: CloudflareRequestLike, env: TEnv, ctx: CloudflareExecutionContextLike) => Record<string, unknown> | undefined;
-  /** Emit one wide event automatically when the handler settles. Default `true`. */
-  autoEmit?: boolean;
+  enrichRequest?: (request: CloudflareRequestLike, env: TEnv, ctx: CloudflareExecutionContextLike) => Record<string, unknown> | undefined;
 }
 declare function useLogger(request?: CloudflareRequestLike, requestLoggerOptions?: RequestLoggerOptions): RequestLogger;
 declare function withAutotelFetch<TEnv, TRequest extends CloudflareRequestLike, TContext extends CloudflareExecutionContextLike, TReturn>(handler: (request: TRequest, env: TEnv, ctx: TContext) => TReturn | Promise<TReturn>, options?: CloudflareWithAutotelOptions<TEnv>): (request: TRequest, env: TEnv, ctx: TContext) => Promise<TReturn>;
-declare function createCloudflareAdapter<TEnv = unknown>(options?: CloudflareWithAutotelOptions<TEnv>): {
-  withAutotelFetch: <TRequest extends CloudflareRequestLike, TContext extends CloudflareExecutionContextLike, TReturn>(handler: (request: TRequest, env: TEnv, ctx: TContext) => TReturn | Promise<TReturn>) => (request: TRequest, env: TEnv, ctx: TContext) => 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 cloudflareToolkit: AdapterToolkit<CloudflareRequestLike>;
 //#endregion
-export { CloudflareExecutionContextLike, CloudflareRequestLike, CloudflareWithAutotelOptions, cloudflareToolkit, createCloudflareAdapter, createDrainPipeline, createStructuredError, parseError, useLogger, withAutotelFetch };
+export { CloudflareExecutionContextLike, CloudflareHandlerContext, CloudflareRequestLike, CloudflareWithAutotelOptions, createDrainPipeline, createStructuredError, parseError, useLogger, withAutotelFetch };
 //# sourceMappingURL=cloudflare.d.ts.map

package/dist/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","names":[],"sources":["../src/cloudflare.ts"],"mappings":";;;;UAgBiB,qBAAA;EACf,MAAA;EACA,GAAA;EACA,OAAA;IACM,GAAA,CAAI,IAAA;EAAA,IACN,MAAA;EACJ,EAAA,GAAK,MAAM;AAAA;AAAA,UAGI,8BAAA;EACf,SAAA,IAAa,OAAA,EAAS,OAAO;EAC7B,sBAAA;AAAA;AAAA,UAGe,4BAAA;EACf,QAAA,cAAsB,OAAA,EAAS,qBAAA,EAAuB,GAAA,EAAK,IAAA;EAC3D,oBAAA,GAAuB,oBAAA;EACvB,MAAA,IACE,OAAA,EAAS,qBAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,8BAAA,KACF,MAAA;EAfM;EAiBX,QAAA;AAAA;AAAA,iBAuCc,SAAA,CACd,OAAA,GAAU,qBAAA,EACV,oBAAA,GAAuB,oBAAA,GACtB,aAAA;AAAA,iBAQa,gBAAA,wBAEG,qBAAA,mBACA,8BAAA,WAGjB,OAAA,GACE,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,GAAU,OAAA,CAAQ,OAAA,GACvB,OAAA,GAAU,4BAAA,CAA6B,IAAA,KAEvC,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,CAAQ,OAAA;AAAA,iBAgDG,uBAAA,iBACd,OAAA,GAAU,4BAAA,CAA6B,IAAA;sCAIlB,qBAAA,mBACA,8BAAA,WACV,OAAA,GAGL,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,GAAU,OAAA,CAAQ,OAAA,OAAQ,OAAA,EAAA,QAAA,EAAA,GAAA,EAAA,IAAA,EAAA,GAAA,EAAA,QAAA,KAAA,OAAA,CAAA,OAAA;;kCAGH,WAAA;iCAErB,oBAAA,KACN,eAAA;qCACoB,YAAA,GACN,oBAAA,CAAqB,CAAA,QACjC,UAAA,GAAa,KAAA,EAAO,CAAA,cAAe,OAAA,WAAkB,eAAA,CAAgB,CAAA;AAAA;AAAA,cAKjE,iBAAA,EAAiB,cAAA,CAAA,qBAAA"}
+{"version":3,"file":"cloudflare.d.ts","names":[],"sources":["../src/cloudflare.ts"],"mappings":";;;;UAmBiB,qBAAA;EACf,MAAA;EACA,GAAA;EACA,OAAA;IACM,GAAA,CAAI,IAAA;EAAA,IACN,MAAA;EACJ,EAAA,GAAK,MAAM;AAAA;AAAA,UAGI,8BAAA;EACf,SAAA,IAAa,OAAA,EAAS,OAAO;EAC7B,sBAAA;AAAA;AAAA,UAGe,wBAAA,wBAEE,qBAAA,mBACA,8BAAA;EAEjB,OAAA,EAAS,QAAA;EACT,GAAA,EAAK,IAAA;EACL,gBAAA,EAAkB,QAAA;AAAA;AAAA,UAGH,4BAAA,yBACP,IAAA,CAAK,uBAAA;EACb,QAAA,cAAsB,OAAA,EAAS,qBAAA,EAAuB,GAAA,EAAK,IAAA;EAC3D,aAAA,IACE,OAAA,EAAS,qBAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,8BAAA,KACF,MAAA;AAAA;AAAA,iBAuCS,SAAA,CACd,OAAA,GAAU,qBAAA,EACV,oBAAA,GAAuB,oBAAA,GACtB,aAAA;AAAA,iBAwDa,gBAAA,wBAEG,qBAAA,mBACA,8BAAA,WAGjB,OAAA,GACE,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,GAAU,OAAA,CAAQ,OAAA,GACvB,OAAA,GAAU,4BAAA,CAA6B,IAAA,KAEvC,OAAA,EAAS,QAAA,EACT,GAAA,EAAK,IAAA,EACL,GAAA,EAAK,QAAA,KACF,OAAA,CAAQ,OAAA"}

package/dist/cloudflare.js

@@ -1,5 +1,6 @@
-import { createAdapterToolkit, createUseLogger, getHeader } from "./core.js";
-import { createDrainPipeline, createStructuredError, getRequestLogger, parseError, trace } from "autotel";
+import { a as runWithIntegratedHandle, i as defineFrameworkIntegration, n as buildTracedOptions, t as applyLoggerEnrichment } from "./integration-BRVGyxPG.js";
+import { createUseLogger, getHeader } from "./core.js";
+import { createDrainPipeline, createStructuredError, parseError } from "autotel";
 
 //#region src/cloudflare.ts
 const requestLoggers = /* @__PURE__ */ new WeakMap();
@@ -33,38 +34,54 @@ function useLogger(request, requestLoggerOptions) {
 	}
 	return baseUseLogger(request, requestLoggerOptions);
 }
+function resolvePath(request) {
+	if (!request.url) return "/";
+	try {
+		return new URL(request.url).pathname;
+	} catch {
+		return request.url;
+	}
+}
+function createIntegration() {
+	return defineFrameworkIntegration({
+		name: "cloudflare",
+		extractRequest: ({ request }) => ({
+			method: request.method ?? "GET",
+			path: resolvePath(request),
+			headers: request.headers,
+			requestId: getHeader(request.headers, "x-request-id") ?? getHeader(request.headers, "cf-ray")
+		}),
+		attachLogger: ({ request }, logger) => {
+			requestLoggers.set(request, logger);
+		},
+		extractWaitUntil: ({ executionContext }) => {
+			return typeof executionContext.waitUntil === "function" ? executionContext.waitUntil.bind(executionContext) : void 0;
+		}
+	});
+}
+const integration = createIntegration();
+function resolveSpanName(request, env, options) {
+	if (typeof options?.spanName === "function") return options.spanName(request, env);
+	return options?.spanName ?? `cloudflare.${request.method ?? "request"}`;
+}
 function withAutotelFetch(handler, options) {
 	return async (request, env, executionContext) => {
-		return await trace({ name: typeof options?.spanName === "function" ? options.spanName(request, env) : options?.spanName ?? `cloudflare.${request.method ?? "request"}` }, (ctx) => async (innerRequest, innerEnv, innerExecutionContext) => {
-			const log = getRequestLogger(ctx, options?.requestLoggerOptions);
-			const auto = enrichFromRequest(innerRequest);
-			if (auto && Object.keys(auto).length > 0) log.set(auto);
-			const custom = options?.enrich?.(innerRequest, innerEnv, innerExecutionContext);
-			if (custom && Object.keys(custom).length > 0) log.set(custom);
-			requestLoggers.set(innerRequest, log);
-			try {
-				return await handler(innerRequest, innerEnv, innerExecutionContext);
-			} finally {
-				if (options?.autoEmit !== false) log.emitNow();
-				requestLoggers.delete(innerRequest);
-			}
-		})(request, env, executionContext);
+		const ctx = {
+			request,
+			env,
+			executionContext
+		};
+		try {
+			return await integration.runTraced(ctx, buildTracedOptions(options, resolveSpanName(request, env, options)), async (handle) => runWithIntegratedHandle(handle, options, async () => {
+				applyLoggerEnrichment(handle.logger, enrichFromRequest(request), options?.enrichRequest?.(request, env, executionContext));
+				return handler(request, env, executionContext);
+			}));
+		} finally {
+			requestLoggers.delete(request);
+		}
 	};
 }
-function createCloudflareAdapter(options) {
-	return {
-		withAutotelFetch: (handler) => withAutotelFetch(handler, options),
-		useLogger,
-		parseError: (error) => parseError(error),
-		createStructuredError: (input) => createStructuredError(input),
-		createDrainPipeline: (drainOptions) => createDrainPipeline(drainOptions)
-	};
-}
-const cloudflareToolkit = createAdapterToolkit({
-	adapterName: "cloudflare",
-	enrich: enrichFromRequest
-});
 
 //#endregion
-export { cloudflareToolkit, createCloudflareAdapter, createDrainPipeline, createStructuredError, parseError, useLogger, withAutotelFetch };
+export { createDrainPipeline, createStructuredError, parseError, useLogger, withAutotelFetch };
 //# sourceMappingURL=cloudflare.js.map

package/dist/cloudflare.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.js","names":[],"sources":["../src/cloudflare.ts"],"sourcesContent":["import {\n  createDrainPipeline,\n  createStructuredError,\n  getRequestLogger,\n  parseError,\n  trace,\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 { createAdapterToolkit, createUseLogger, getHeader } from './core';\n\nexport interface CloudflareRequestLike {\n  method?: string;\n  url?: string;\n  headers?:\n    | { get(name: string): string | null }\n    | Record<string, string | undefined>;\n  cf?: Record<string, unknown>;\n}\n\nexport interface CloudflareExecutionContextLike {\n  waitUntil?: (promise: Promise<unknown>) => void;\n  passThroughOnException?: () => void;\n}\n\nexport interface CloudflareWithAutotelOptions<TEnv = unknown> {\n  spanName?: string | ((request: CloudflareRequestLike, env: TEnv) => string);\n  requestLoggerOptions?: RequestLoggerOptions;\n  enrich?: (\n    request: CloudflareRequestLike,\n    env: TEnv,\n    ctx: CloudflareExecutionContextLike,\n  ) => Record<string, unknown> | undefined;\n  /** Emit one wide event automatically when the handler settles. Default `true`. */\n  autoEmit?: boolean;\n}\n\nconst requestLoggers = new WeakMap<object, RequestLogger>();\n\nfunction enrichFromRequest(\n  request?: CloudflareRequestLike,\n): Record<string, unknown> | undefined {\n  if (!request) return undefined;\n\n  let route = '/';\n  if (request.url) {\n    try {\n      route = new URL(request.url).pathname;\n    } catch {\n      route = request.url;\n    }\n  }\n\n  const requestId =\n    getHeader(request.headers, 'x-request-id') ??\n    getHeader(request.headers, 'cf-ray');\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    ...(request.cf?.country ? { 'cloudflare.country': request.cf.country } : {}),\n    ...(request.cf?.colo ? { 'cloudflare.colo': request.cf.colo } : {}),\n    ...(request.cf?.city ? { 'cloudflare.city': request.cf.city } : {}),\n  };\n}\n\nconst baseUseLogger = createUseLogger<CloudflareRequestLike>({\n  adapterName: 'cloudflare',\n  enrich: enrichFromRequest,\n});\n\nexport function useLogger(\n  request?: CloudflareRequestLike,\n  requestLoggerOptions?: RequestLoggerOptions,\n): RequestLogger {\n  if (request) {\n    const existing = requestLoggers.get(request as object);\n    if (existing) return existing;\n  }\n  return baseUseLogger(request, requestLoggerOptions);\n}\n\nexport function withAutotelFetch<\n  TEnv,\n  TRequest extends CloudflareRequestLike,\n  TContext extends CloudflareExecutionContextLike,\n  TReturn,\n>(\n  handler: (\n    request: TRequest,\n    env: TEnv,\n    ctx: TContext,\n  ) => TReturn | Promise<TReturn>,\n  options?: CloudflareWithAutotelOptions<TEnv>,\n): (\n  request: TRequest,\n  env: TEnv,\n  ctx: TContext,\n) => Promise<TReturn> {\n  return async (\n    request: TRequest,\n    env: TEnv,\n    executionContext: TContext,\n  ): Promise<TReturn> => {\n    const spanName =\n      typeof options?.spanName === 'function'\n        ? options.spanName(request, env)\n        : (options?.spanName ?? `cloudflare.${request.method ?? 'request'}`);\n\n    const wrapped = trace(\n      { name: spanName },\n      (ctx) => async (\n        innerRequest: TRequest,\n        innerEnv: TEnv,\n        innerExecutionContext: TContext,\n      ) => {\n        const log = getRequestLogger(ctx, options?.requestLoggerOptions);\n        const auto = enrichFromRequest(innerRequest);\n        if (auto && Object.keys(auto).length > 0) {\n          log.set(auto);\n        }\n        const custom = options?.enrich?.(\n          innerRequest,\n          innerEnv,\n          innerExecutionContext,\n        );\n        if (custom && Object.keys(custom).length > 0) {\n          log.set(custom);\n        }\n\n        requestLoggers.set(innerRequest as object, log);\n        try {\n          return await handler(innerRequest, innerEnv, innerExecutionContext);\n        } finally {\n          if (options?.autoEmit !== false) {\n            log.emitNow();\n          }\n          requestLoggers.delete(innerRequest as object);\n        }\n      },\n    );\n\n    return await wrapped(request, env, executionContext);\n  };\n}\n\nexport function createCloudflareAdapter<TEnv = unknown>(\n  options?: CloudflareWithAutotelOptions<TEnv>,\n) {\n  return {\n    withAutotelFetch: <\n      TRequest extends CloudflareRequestLike,\n      TContext extends CloudflareExecutionContextLike,\n      TReturn,\n    >(\n      handler: (\n        request: TRequest,\n        env: TEnv,\n        ctx: TContext,\n      ) => TReturn | Promise<TReturn>,\n    ) => withAutotelFetch(handler, options),\n    useLogger,\n    parseError: (error: unknown): ParsedError => parseError(error),\n    createStructuredError: (\n      input: StructuredErrorInput,\n    ): StructuredError => 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 cloudflareToolkit = createAdapterToolkit<CloudflareRequestLike>({\n  adapterName: 'cloudflare',\n  enrich: enrichFromRequest,\n});\n\nexport { parseError, createDrainPipeline, createStructuredError };\n"],"mappings":";;;;AA0CA,MAAM,iCAAiB,IAAI,QAA+B;AAE1D,SAAS,kBACP,SACqC;CACrC,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI,QAAQ;CACZ,IAAI,QAAQ,KACV,IAAI;EACF,QAAQ,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;CAC/B,QAAQ;EACN,QAAQ,QAAQ;CAClB;CAGF,MAAM,YACJ,UAAU,QAAQ,SAAS,cAAc,KACzC,UAAU,QAAQ,SAAS,QAAQ;CAErC,OAAO;EACL,GAAI,QAAQ,SAAS,EAAE,uBAAuB,QAAQ,OAAO,IAAI,CAAC;EAClE,GAAI,QAAQ,MAAM,EAAE,YAAY,QAAQ,IAAI,IAAI,CAAC;EACjD,GAAI,QAAQ,EAAE,cAAc,MAAM,IAAI,CAAC;EACvC,GAAI,YAAY,EAAE,mBAAmB,UAAU,IAAI,CAAC;EACpD,GAAI,QAAQ,IAAI,UAAU,EAAE,sBAAsB,QAAQ,GAAG,QAAQ,IAAI,CAAC;EAC1E,GAAI,QAAQ,IAAI,OAAO,EAAE,mBAAmB,QAAQ,GAAG,KAAK,IAAI,CAAC;EACjE,GAAI,QAAQ,IAAI,OAAO,EAAE,mBAAmB,QAAQ,GAAG,KAAK,IAAI,CAAC;CACnE;AACF;AAEA,MAAM,gBAAgB,gBAAuC;CAC3D,aAAa;CACb,QAAQ;AACV,CAAC;AAED,SAAgB,UACd,SACA,sBACe;CACf,IAAI,SAAS;EACX,MAAM,WAAW,eAAe,IAAI,OAAiB;EACrD,IAAI,UAAU,OAAO;CACvB;CACA,OAAO,cAAc,SAAS,oBAAoB;AACpD;AAEA,SAAgB,iBAMd,SAKA,SAKoB;CACpB,OAAO,OACL,SACA,KACA,qBACqB;EAuCrB,OAAO,MAjCS,MACd,EAAE,MALF,OAAO,SAAS,aAAa,aACzB,QAAQ,SAAS,SAAS,GAAG,IAC5B,SAAS,YAAY,cAAc,QAAQ,UAAU,YAGzC,IAChB,QAAQ,OACP,cACA,UACA,0BACG;GACH,MAAM,MAAM,iBAAiB,KAAK,SAAS,oBAAoB;GAC/D,MAAM,OAAO,kBAAkB,YAAY;GAC3C,IAAI,QAAQ,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,GACrC,IAAI,IAAI,IAAI;GAEd,MAAM,SAAS,SAAS,SACtB,cACA,UACA,qBACF;GACA,IAAI,UAAU,OAAO,KAAK,MAAM,CAAC,CAAC,SAAS,GACzC,IAAI,IAAI,MAAM;GAGhB,eAAe,IAAI,cAAwB,GAAG;GAC9C,IAAI;IACF,OAAO,MAAM,QAAQ,cAAc,UAAU,qBAAqB;GACpE,UAAU;IACR,IAAI,SAAS,aAAa,OACxB,IAAI,QAAQ;IAEd,eAAe,OAAO,YAAsB;GAC9C;EACF,CAGiB,CAAC,CAAC,SAAS,KAAK,gBAAgB;CACrD;AACF;AAEA,SAAgB,wBACd,SACA;CACA,OAAO;EACL,mBAKE,YAKG,iBAAiB,SAAS,OAAO;EACtC;EACA,aAAa,UAAgC,WAAW,KAAK;EAC7D,wBACE,UACoB,sBAAsB,KAAK;EACjD,sBACE,iBAEA,oBAAoB,YAAY;CACpC;AACF;AAEA,MAAa,oBAAoB,qBAA4C;CAC3E,aAAa;CACb,QAAQ;AACV,CAAC"}
+{"version":3,"file":"cloudflare.js","names":[],"sources":["../src/cloudflare.ts"],"sourcesContent":["import {\n  createDrainPipeline,\n  createStructuredError,\n  parseError,\n  type RequestLogger,\n  type RequestLoggerOptions,\n} from 'autotel';\nimport {\n  createUseLogger,\n  getHeader,\n  type FrameworkHandlerOptions,\n} from './core';\nimport {\n  applyLoggerEnrichment,\n  defineFrameworkIntegration,\n  runWithIntegratedHandle,\n  buildTracedOptions,\n} from './toolkit/integration';\n\nexport interface CloudflareRequestLike {\n  method?: string;\n  url?: string;\n  headers?:\n    | { get(name: string): string | null }\n    | Record<string, string | undefined>;\n  cf?: Record<string, unknown>;\n}\n\nexport interface CloudflareExecutionContextLike {\n  waitUntil?: (promise: Promise<unknown>) => void;\n  passThroughOnException?: () => void;\n}\n\nexport interface CloudflareHandlerContext<\n  TEnv,\n  TRequest extends CloudflareRequestLike,\n  TContext extends CloudflareExecutionContextLike,\n> {\n  request: TRequest;\n  env: TEnv;\n  executionContext: TContext;\n}\n\nexport interface CloudflareWithAutotelOptions<TEnv = unknown>\n  extends Omit<FrameworkHandlerOptions, 'spanName'> {\n  spanName?: string | ((request: CloudflareRequestLike, env: TEnv) => string);\n  enrichRequest?: (\n    request: CloudflareRequestLike,\n    env: TEnv,\n    ctx: CloudflareExecutionContextLike,\n  ) => Record<string, unknown> | undefined;\n}\n\nconst requestLoggers = new WeakMap<object, RequestLogger>();\n\nfunction enrichFromRequest(\n  request?: CloudflareRequestLike,\n): Record<string, unknown> | undefined {\n  if (!request) return undefined;\n\n  let route = '/';\n  if (request.url) {\n    try {\n      route = new URL(request.url).pathname;\n    } catch {\n      route = request.url;\n    }\n  }\n\n  const requestId =\n    getHeader(request.headers, 'x-request-id') ??\n    getHeader(request.headers, 'cf-ray');\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    ...(request.cf?.country ? { 'cloudflare.country': request.cf.country } : {}),\n    ...(request.cf?.colo ? { 'cloudflare.colo': request.cf.colo } : {}),\n    ...(request.cf?.city ? { 'cloudflare.city': request.cf.city } : {}),\n  };\n}\n\nconst baseUseLogger = createUseLogger<CloudflareRequestLike>({\n  adapterName: 'cloudflare',\n  enrich: enrichFromRequest,\n});\n\nexport function useLogger(\n  request?: CloudflareRequestLike,\n  requestLoggerOptions?: RequestLoggerOptions,\n): RequestLogger {\n  if (request) {\n    const existing = requestLoggers.get(request as object);\n    if (existing) return existing;\n  }\n  return baseUseLogger(request, requestLoggerOptions);\n}\n\nfunction resolvePath(request: CloudflareRequestLike): string {\n  if (!request.url) return '/';\n  try {\n    return new URL(request.url).pathname;\n  } catch {\n    return request.url;\n  }\n}\n\nfunction createIntegration<TEnv>() {\n  return defineFrameworkIntegration<\n    CloudflareHandlerContext<TEnv, CloudflareRequestLike, CloudflareExecutionContextLike>\n  >({\n    name: 'cloudflare',\n    extractRequest: ({ request }) => ({\n      method: request.method ?? 'GET',\n      path: resolvePath(request),\n      headers: request.headers,\n      requestId:\n        getHeader(request.headers, 'x-request-id') ??\n        getHeader(request.headers, 'cf-ray'),\n    }),\n    attachLogger: ({ request }, logger) => {\n      requestLoggers.set(request as object, logger);\n    },\n    extractWaitUntil: ({ executionContext }) => {\n      const waitUntil =\n        typeof executionContext.waitUntil === 'function'\n          ? executionContext.waitUntil.bind(executionContext)\n          : undefined;\n      return waitUntil;\n    },\n  });\n}\n\nconst integration = createIntegration<unknown>();\n\nfunction resolveSpanName<TEnv>(\n  request: CloudflareRequestLike,\n  env: TEnv,\n  options?: CloudflareWithAutotelOptions<TEnv>,\n): string {\n  if (typeof options?.spanName === 'function') {\n    return options.spanName(request, env);\n  }\n  return options?.spanName ?? `cloudflare.${request.method ?? 'request'}`;\n}\n\nexport function withAutotelFetch<\n  TEnv,\n  TRequest extends CloudflareRequestLike,\n  TContext extends CloudflareExecutionContextLike,\n  TReturn,\n>(\n  handler: (\n    request: TRequest,\n    env: TEnv,\n    ctx: TContext,\n  ) => TReturn | Promise<TReturn>,\n  options?: CloudflareWithAutotelOptions<TEnv>,\n): (\n  request: TRequest,\n  env: TEnv,\n  ctx: TContext,\n) => Promise<TReturn> {\n  return async (\n    request: TRequest,\n    env: TEnv,\n    executionContext: TContext,\n  ): Promise<TReturn> => {\n    const ctx = { request, env, executionContext };\n    try {\n      return await integration.runTraced(\n        ctx,\n        buildTracedOptions(options, resolveSpanName(request, env, options)),\n        async (handle) =>\n          runWithIntegratedHandle(handle, options, async () => {\n            applyLoggerEnrichment(\n              handle.logger,\n              enrichFromRequest(request),\n              options?.enrichRequest?.(request, env, executionContext),\n            );\n            return handler(request, env, executionContext);\n          }),\n      );\n    } finally {\n      requestLoggers.delete(request as object);\n    }\n  };\n}\n\nexport { parseError, createDrainPipeline, createStructuredError };\n"],"mappings":";;;;;AAqDA,MAAM,iCAAiB,IAAI,QAA+B;AAE1D,SAAS,kBACP,SACqC;CACrC,IAAI,CAAC,SAAS,OAAO;CAErB,IAAI,QAAQ;CACZ,IAAI,QAAQ,KACV,IAAI;EACF,QAAQ,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;CAC/B,QAAQ;EACN,QAAQ,QAAQ;CAClB;CAGF,MAAM,YACJ,UAAU,QAAQ,SAAS,cAAc,KACzC,UAAU,QAAQ,SAAS,QAAQ;CAErC,OAAO;EACL,GAAI,QAAQ,SAAS,EAAE,uBAAuB,QAAQ,OAAO,IAAI,CAAC;EAClE,GAAI,QAAQ,MAAM,EAAE,YAAY,QAAQ,IAAI,IAAI,CAAC;EACjD,GAAI,QAAQ,EAAE,cAAc,MAAM,IAAI,CAAC;EACvC,GAAI,YAAY,EAAE,mBAAmB,UAAU,IAAI,CAAC;EACpD,GAAI,QAAQ,IAAI,UAAU,EAAE,sBAAsB,QAAQ,GAAG,QAAQ,IAAI,CAAC;EAC1E,GAAI,QAAQ,IAAI,OAAO,EAAE,mBAAmB,QAAQ,GAAG,KAAK,IAAI,CAAC;EACjE,GAAI,QAAQ,IAAI,OAAO,EAAE,mBAAmB,QAAQ,GAAG,KAAK,IAAI,CAAC;CACnE;AACF;AAEA,MAAM,gBAAgB,gBAAuC;CAC3D,aAAa;CACb,QAAQ;AACV,CAAC;AAED,SAAgB,UACd,SACA,sBACe;CACf,IAAI,SAAS;EACX,MAAM,WAAW,eAAe,IAAI,OAAiB;EACrD,IAAI,UAAU,OAAO;CACvB;CACA,OAAO,cAAc,SAAS,oBAAoB;AACpD;AAEA,SAAS,YAAY,SAAwC;CAC3D,IAAI,CAAC,QAAQ,KAAK,OAAO;CACzB,IAAI;EACF,OAAO,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;CAC9B,QAAQ;EACN,OAAO,QAAQ;CACjB;AACF;AAEA,SAAS,oBAA0B;CACjC,OAAO,2BAEL;EACA,MAAM;EACN,iBAAiB,EAAE,eAAe;GAChC,QAAQ,QAAQ,UAAU;GAC1B,MAAM,YAAY,OAAO;GACzB,SAAS,QAAQ;GACjB,WACE,UAAU,QAAQ,SAAS,cAAc,KACzC,UAAU,QAAQ,SAAS,QAAQ;EACvC;EACA,eAAe,EAAE,WAAW,WAAW;GACrC,eAAe,IAAI,SAAmB,MAAM;EAC9C;EACA,mBAAmB,EAAE,uBAAuB;GAK1C,OAHE,OAAO,iBAAiB,cAAc,aAClC,iBAAiB,UAAU,KAAK,gBAAgB,IAChD;EAER;CACF,CAAC;AACH;AAEA,MAAM,cAAc,kBAA2B;AAE/C,SAAS,gBACP,SACA,KACA,SACQ;CACR,IAAI,OAAO,SAAS,aAAa,YAC/B,OAAO,QAAQ,SAAS,SAAS,GAAG;CAEtC,OAAO,SAAS,YAAY,cAAc,QAAQ,UAAU;AAC9D;AAEA,SAAgB,iBAMd,SAKA,SAKoB;CACpB,OAAO,OACL,SACA,KACA,qBACqB;EACrB,MAAM,MAAM;GAAE;GAAS;GAAK;EAAiB;EAC7C,IAAI;GACF,OAAO,MAAM,YAAY,UACvB,KACA,mBAAmB,SAAS,gBAAgB,SAAS,KAAK,OAAO,CAAC,GAClE,OAAO,WACL,wBAAwB,QAAQ,SAAS,YAAY;IACnD,sBACE,OAAO,QACP,kBAAkB,OAAO,GACzB,SAAS,gBAAgB,SAAS,KAAK,gBAAgB,CACzD;IACA,OAAO,QAAQ,SAAS,KAAK,gBAAgB;GAC/C,CAAC,CACL;EACF,UAAU;GACR,eAAe,OAAO,OAAiB;EACzC;CACF;AACF"}

package/dist/core.cjs

@@ -1,5 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_integration = require('./integration-Dd8Pi7jc.cjs');
 let autotel = require("autotel");
+let autotel_edge = require("autotel-edge");
 
 //#region src/core.ts
 function createUseLogger(options) {
@@ -25,8 +27,10 @@ function createUseLogger(options) {
 */
 function createRequestRunner(storage) {
 	return function runRequest(spanName, enrich, handler, options) {
+		if (options?.path && !(0, autotel_edge.shouldInstrumentPath)(options.path, options)) return Promise.resolve(handler());
+		const loggerOptions = require_integration.mergeRequestLoggerOptions(options?.requestLoggerOptions, options?.waitUntil);
 		return (0, autotel.trace)({ name: spanName }, (ctx) => async () => {
-			const log = (0, autotel.getRequestLogger)(ctx, options?.requestLoggerOptions);
+			const log = (0, autotel.getRequestLogger)(ctx, loggerOptions);
 			enrich(log);
 			try {
 				return await storage.run(log, () => handler());
@@ -39,14 +43,6 @@ function createRequestRunner(storage) {
 		})();
 	};
 }
-function createAdapterToolkit(options) {
-	return {
-		useLogger: createUseLogger(options),
-		parseError: autotel.parseError,
-		createStructuredError: autotel.createStructuredError,
-		createDrainPipeline: autotel.createDrainPipeline
-	};
-}
 function resolveEnv(envKeys) {
 	if (!envKeys) return void 0;
 	for (const key of envKeys) {
@@ -108,10 +104,10 @@ function getHeader(headers, name) {
 }
 
 //#endregion
-exports.createAdapterToolkit = createAdapterToolkit;
 exports.createRequestRunner = createRequestRunner;
 exports.createUseLogger = createUseLogger;
 exports.getHeader = getHeader;
 exports.resolveAdapterConfig = resolveAdapterConfig;
 exports.shouldProbeRuntime = shouldProbeRuntime;
+exports.toRouteAdapterOptions = require_integration.toRouteAdapterOptions;
 //# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

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

package/dist/core.d.cts

@@ -1,20 +1,18 @@
-import { AsyncLocalStorage } from "node:async_hooks";
+import { _ as RouteAdapterOptions, f as toRouteAdapterOptions, n as FrameworkHandlerOptions, o as IntegratedCompletionOptions } from "./integration-7--zN-83.cjs";
 import { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogSnapshot, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput } from "autotel";
+import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/core.d.ts
+type BaseAdapterOptions = RouteAdapterOptions;
 interface AdapterUseLoggerOptions<TContext> {
   adapterName: string;
   enrich?: (context: TContext) => Record<string, unknown> | undefined;
 }
-interface AdapterToolkit<TContext> {
-  useLogger: (context?: TContext, options?: RequestLoggerOptions) => RequestLogger;
-  parseError: (error: unknown) => ParsedError;
-  createStructuredError: (input: StructuredErrorInput) => StructuredError;
-  createDrainPipeline: <T = unknown>(options?: DrainPipelineOptions<T>) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;
-}
 declare function createUseLogger<TContext = unknown>(options: AdapterUseLoggerOptions<TContext>): (context?: TContext, requestLoggerOptions?: RequestLoggerOptions) => RequestLogger;
-interface RequestRunnerOptions {
+interface RequestRunnerOptions extends RouteAdapterOptions {
   requestLoggerOptions?: RequestLoggerOptions;
+  /** HTTP route used for include/exclude filtering. */
+  path?: string;
   /** 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). */
@@ -27,7 +25,6 @@ interface RequestRunnerOptions {
  * 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
  * environment variables to fall back to.
@@ -73,5 +70,5 @@ type HeadersLike = {
 } | Record<string, string | undefined>;
 declare function getHeader(headers: HeadersLike | undefined, name: string): string | undefined;
 //#endregion
-export { AdapterToolkit, AdapterUseLoggerOptions, ConfigField, type DrainPipelineOptions, HeadersLike, type ParsedError, type PipelineDrainFn, type RequestLogSnapshot, type RequestLogger, type RequestLoggerOptions, RequestRunnerOptions, type StructuredError, type StructuredErrorInput, createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
+export { AdapterUseLoggerOptions, BaseAdapterOptions, ConfigField, type DrainPipelineOptions, type FrameworkHandlerOptions, HeadersLike, type IntegratedCompletionOptions, type ParsedError, type PipelineDrainFn, type RequestLogSnapshot, type RequestLogger, type RequestLoggerOptions, RequestRunnerOptions, type RouteAdapterOptions, type StructuredError, type StructuredErrorInput, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime, toRouteAdapterOptions };
 //# sourceMappingURL=core.d.cts.map

package/dist/core.d.cts.map

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

package/dist/core.d.ts

@@ -1,20 +1,18 @@
+import { _ as RouteAdapterOptions, f as toRouteAdapterOptions, n as FrameworkHandlerOptions, o as IntegratedCompletionOptions } from "./integration-CaG_l5xr.js";
 import { DrainPipelineOptions, ParsedError, PipelineDrainFn, RequestLogSnapshot, RequestLogger, RequestLoggerOptions, StructuredError, StructuredErrorInput } from "autotel";
 import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/core.d.ts
+type BaseAdapterOptions = RouteAdapterOptions;
 interface AdapterUseLoggerOptions<TContext> {
   adapterName: string;
   enrich?: (context: TContext) => Record<string, unknown> | undefined;
 }
-interface AdapterToolkit<TContext> {
-  useLogger: (context?: TContext, options?: RequestLoggerOptions) => RequestLogger;
-  parseError: (error: unknown) => ParsedError;
-  createStructuredError: (input: StructuredErrorInput) => StructuredError;
-  createDrainPipeline: <T = unknown>(options?: DrainPipelineOptions<T>) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;
-}
 declare function createUseLogger<TContext = unknown>(options: AdapterUseLoggerOptions<TContext>): (context?: TContext, requestLoggerOptions?: RequestLoggerOptions) => RequestLogger;
-interface RequestRunnerOptions {
+interface RequestRunnerOptions extends RouteAdapterOptions {
   requestLoggerOptions?: RequestLoggerOptions;
+  /** HTTP route used for include/exclude filtering. */
+  path?: string;
   /** 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). */
@@ -27,7 +25,6 @@ interface RequestRunnerOptions {
  * 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
  * environment variables to fall back to.
@@ -73,5 +70,5 @@ type HeadersLike = {
 } | Record<string, string | undefined>;
 declare function getHeader(headers: HeadersLike | undefined, name: string): string | undefined;
 //#endregion
-export { AdapterToolkit, AdapterUseLoggerOptions, ConfigField, type DrainPipelineOptions, HeadersLike, type ParsedError, type PipelineDrainFn, type RequestLogSnapshot, type RequestLogger, type RequestLoggerOptions, RequestRunnerOptions, type StructuredError, type StructuredErrorInput, createAdapterToolkit, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime };
+export { AdapterUseLoggerOptions, BaseAdapterOptions, ConfigField, type DrainPipelineOptions, type FrameworkHandlerOptions, HeadersLike, type IntegratedCompletionOptions, type ParsedError, type PipelineDrainFn, type RequestLogSnapshot, type RequestLogger, type RequestLoggerOptions, RequestRunnerOptions, type RouteAdapterOptions, type StructuredError, type StructuredErrorInput, createRequestRunner, createUseLogger, getHeader, resolveAdapterConfig, shouldProbeRuntime, toRouteAdapterOptions };
 //# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

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