autotel-adapters 0.2.19 → 0.3.0

package/src/express.ts

@@ -0,0 +1,169 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import {
+  createDrainPipeline,
+  createStructuredError,
+  parseError,
+  type DrainPipelineOptions,
+  type ParsedError,
+  type PipelineDrainFn,
+  type RequestLogger,
+  type RequestLoggerOptions,
+  type StructuredError,
+  type StructuredErrorInput,
+} from 'autotel';
+import {
+  createAdapterToolkit,
+  createRequestRunner,
+  createUseLogger,
+} from './core';
+
+export interface ExpressRequestLike {
+  method?: string;
+  originalUrl?: string;
+  url?: string;
+  path?: string;
+  route?: { path?: string };
+  headers?: Record<string, string | string[] | undefined>;
+}
+
+export interface ExpressResponseLike {
+  statusCode?: number;
+}
+
+export type ExpressNext = (err?: unknown) => void;
+
+export 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;
+}
+
+const expressLoggerStorage = new AsyncLocalStorage<RequestLogger>();
+
+function headerValue(
+  headers: ExpressRequestLike['headers'],
+  name: string,
+): string | undefined {
+  if (!headers) return undefined;
+  const value = headers[name] ?? headers[name.toLowerCase()];
+  if (Array.isArray(value)) return value[0];
+  return typeof value === 'string' ? value : undefined;
+}
+
+function enrichFromRequest(
+  request?: ExpressRequestLike,
+): Record<string, unknown> | undefined {
+  if (!request) return undefined;
+
+  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<ExpressRequestLike>({
+  adapterName: 'express',
+  enrich: enrichFromRequest,
+});
+
+export function useLogger(
+  request?: ExpressRequestLike,
+  requestLoggerOptions?: RequestLoggerOptions,
+): RequestLogger {
+  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`.
+ */
+export 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> {
+  return async (
+    req: TReq,
+    res: TRes,
+    next?: ExpressNext,
+  ): Promise<TReturn | undefined> => {
+    const spanName =
+      typeof options?.spanName === 'function'
+        ? options.spanName(req)
+        : (options?.spanName ?? `express.${req.method ?? 'request'}`);
+
+    try {
+      return await runRequest<TReturn>(
+        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 }
+              : undefined,
+        },
+      );
+    } catch (error) {
+      if (typeof next === 'function') {
+        next(error);
+        return undefined;
+      }
+      throw error;
+    }
+  };
+}
+
+export function createExpressAdapter(options?: ExpressWithAutotelOptions) {
+  return {
+    withAutotel: <
+      TReq extends ExpressRequestLike,
+      TRes extends ExpressResponseLike,
+      TReturn,
+    >(
+      handler: (
+        req: TReq,
+        res: TRes,
+        next?: ExpressNext,
+      ) => TReturn | Promise<TReturn>,
+    ) => withAutotel(handler, options),
+    useLogger,
+    parseError: (error: unknown): ParsedError => parseError(error),
+    createStructuredError: (input: StructuredErrorInput): StructuredError =>
+      createStructuredError(input),
+    createDrainPipeline: <T = unknown>(
+      drainOptions?: DrainPipelineOptions<T>,
+    ): ((batchDrain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>) =>
+      createDrainPipeline(drainOptions),
+  };
+}
+
+export const expressToolkit = createAdapterToolkit<ExpressRequestLike>({
+  adapterName: 'express',
+  enrich: enrichFromRequest,
+});
+
+export { parseError, createDrainPipeline, createStructuredError };

package/src/fastify.test.ts

@@ -0,0 +1,79 @@
+import { describe, expect, it, vi } from 'vitest';
+import { useLogger, withAutotel } from './fastify';
+import type { FastifyRequestLike, FastifyReplyLike } from './fastify';
+
+const req = (over: Partial<FastifyRequestLike> = {}): FastifyRequestLike => ({
+  method: 'GET',
+  url: '/api/orders',
+  routeOptions: { url: '/api/orders/:id' },
+  id: 'req-1',
+  ...over,
+});
+
+describe('fastify adapter', () => {
+  it('throws a clear error when useLogger is called outside a traced context', () => {
+    expect(() => useLogger(req())).toThrow(
+      '[autotel-adapters/fastify] No active trace context.',
+    );
+  });
+
+  it('runs the handler with a request-scoped logger', async () => {
+    const handler = withAutotel((request, reply: FastifyReplyLike) => {
+      useLogger(request).set({ feature: 'checkout' });
+      reply.statusCode = 201;
+      return { ok: true };
+    });
+
+    await expect(handler(req(), { statusCode: 200 })).resolves.toEqual({
+      ok: true,
+    });
+  });
+
+  it('auto-emits one wide event with route, request id, and status', async () => {
+    const onEmit = vi.fn();
+    const handler = withAutotel(
+      (request, reply: FastifyReplyLike) => {
+        useLogger(request).set({ user: 'u1' });
+        reply.statusCode = 200;
+        return 'done';
+      },
+      { requestLoggerOptions: { onEmit } },
+    );
+
+    await handler(req({ method: 'POST' }), { statusCode: 200 });
+
+    expect(onEmit).toHaveBeenCalledTimes(1);
+    const snapshot = onEmit.mock.calls[0]?.[0] as {
+      context: Record<string, unknown>;
+    };
+    expect(snapshot.context.user).toBe('u1');
+    expect(snapshot.context['http.route']).toBe('/api/orders/:id');
+    expect(snapshot.context['http.request.id']).toBe('req-1');
+    expect(snapshot.context['http.response.status_code']).toBe(200);
+  });
+
+  it('does not emit when autoEmit is false', async () => {
+    const onEmit = vi.fn();
+    const handler = withAutotel(() => 'x', {
+      autoEmit: false,
+      requestLoggerOptions: { onEmit },
+    });
+
+    await handler(req(), { statusCode: 200 });
+    expect(onEmit).not.toHaveBeenCalled();
+  });
+
+  it('records the error, emits, and rethrows for fastify to handle', async () => {
+    const onEmit = vi.fn();
+    const boom = new Error('boom');
+    const handler = withAutotel(
+      () => {
+        throw boom;
+      },
+      { requestLoggerOptions: { onEmit } },
+    );
+
+    await expect(handler(req(), { statusCode: 500 })).rejects.toThrow('boom');
+    expect(onEmit).toHaveBeenCalledTimes(1);
+  });
+});

package/src/fastify.ts

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

package/src/index.ts

@@ -2,5 +2,13 @@ export * from './core';
 export { createNextAdapter, withAutotel } from './next';
 export { createNitroAdapter, withAutotelEventHandler } from './nitro';
 export { createCloudflareAdapter, withAutotelFetch } from './cloudflare';
+export {
+  createExpressAdapter,
+  withAutotel as withAutotelExpress,
+} from './express';
+export {
+  createFastifyAdapter,
+  withAutotel as withAutotelFastify,
+} from './fastify';
 export { honoToolkit } from './hono';
 export { tanstackToolkit } from './tanstack';

package/src/next.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 import { useLogger, withAutotel } from './next';
 
 describe('next adapter', () => {
@@ -19,4 +19,29 @@ describe('next adapter', () => {
       'ok',
     );
   });
+
+  it('auto-emits one wide event by default', async () => {
+    const onEmit = vi.fn();
+    const handler = withAutotel(
+      async (request: { url: string }) => {
+        useLogger(request).set({ feature: 'checkout' });
+        return 'ok';
+      },
+      { requestLoggerOptions: { onEmit } },
+    );
+
+    await handler({ url: 'https://example.com/orders' });
+    expect(onEmit).toHaveBeenCalledTimes(1);
+  });
+
+  it('does not emit when autoEmit is false', async () => {
+    const onEmit = vi.fn();
+    const handler = withAutotel(async () => 'ok', {
+      autoEmit: false,
+      requestLoggerOptions: { onEmit },
+    });
+
+    await handler();
+    expect(onEmit).not.toHaveBeenCalled();
+  });
 });

package/src/next.ts

@@ -27,6 +27,8 @@ export interface NextWithAutotelOptions {
   spanName?: string | ((request?: NextRequestLike) => string);
   requestLoggerOptions?: RequestLoggerOptions;
   enrich?: (request?: NextRequestLike) => Record<string, unknown> | undefined;
+  /** Emit one wide event automatically when the handler settles. Default `true`. */
+  autoEmit?: boolean;
 }
 
 const nextLoggerStorage = new AsyncLocalStorage<RequestLogger>();
@@ -92,7 +94,15 @@ export function withAutotel<TArgs extends unknown[], TReturn>(
         if (custom && Object.keys(custom).length > 0) {
           log.set(custom);
         }
-        return await nextLoggerStorage.run(log, async () => handler(...innerArgs));
+        try {
+          return await nextLoggerStorage.run(log, async () =>
+            handler(...innerArgs),
+          );
+        } finally {
+          if (options?.autoEmit !== false) {
+            log.emitNow();
+          }
+        }
       },
     );
     return await wrapped(...args);

package/src/nitro.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest';
+import { describe, expect, it, vi } from 'vitest';
 import { useLogger, withAutotelEventHandler } from './nitro';
 
 describe('nitro adapter', () => {
@@ -21,4 +21,29 @@ describe('nitro adapter', () => {
       handler({ path: '/orders', context: {} }),
     ).resolves.toMatchObject({ ok: true });
   });
+
+  it('auto-emits one wide event by default', async () => {
+    const onEmit = vi.fn();
+    const handler = withAutotelEventHandler(
+      async (event: { path: string; context: Record<string, unknown> }) => {
+        useLogger(event).set({ route: event.path });
+        return { ok: true };
+      },
+      { requestLoggerOptions: { onEmit } },
+    );
+
+    await handler({ path: '/orders', context: {} });
+    expect(onEmit).toHaveBeenCalledTimes(1);
+  });
+
+  it('does not emit when autoEmit is false', async () => {
+    const onEmit = vi.fn();
+    const handler = withAutotelEventHandler(async () => ({ ok: true }), {
+      autoEmit: false,
+      requestLoggerOptions: { onEmit },
+    });
+
+    await handler({ path: '/x', context: {} });
+    expect(onEmit).not.toHaveBeenCalled();
+  });
 });

package/src/nitro.ts

@@ -17,6 +17,8 @@ export interface NitroWithAutotelOptions {
   spanName?: string | ((event: NitroEventLike) => string);
   requestLoggerOptions?: RequestLoggerOptions;
   enrich?: (event: NitroEventLike) => Record<string, unknown> | undefined;
+  /** Emit one wide event automatically when the handler settles. Default `true`. */
+  autoEmit?: boolean;
 }
 
 function enrichFromEvent(
@@ -78,7 +80,15 @@ export function withAutotelEventHandler<TEvent extends NitroEventLike, TReturn>(
       if (custom && Object.keys(custom).length > 0) {
         log.set(custom);
       }
-      return await nitroLoggerStorage.run(log, async () => handler(innerEvent));
+      try {
+        return await nitroLoggerStorage.run(log, async () =>
+          handler(innerEvent),
+        );
+      } finally {
+        if (options?.autoEmit !== false) {
+          log.emitNow();
+        }
+      }
     });
 
     return await wrapped(event);

package/dist/chunk-AD3QBS5J.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/nitro.ts"],"names":[],"mappings":"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","file":"chunk-AD3QBS5J.js","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport {\n  getRequestLogger,\n  trace,\n  type RequestLogger,\n  type RequestLoggerOptions,\n} from 'autotel';\nimport { createAdapterToolkit, createUseLogger } from './core';\n\nexport interface NitroEventLike {\n  method?: string;\n  path?: string;\n  context?: Record<string, unknown>;\n}\n\nexport interface NitroWithAutotelOptions {\n  spanName?: string | ((event: NitroEventLike) => string);\n  requestLoggerOptions?: RequestLoggerOptions;\n  enrich?: (event: NitroEventLike) => Record<string, unknown> | undefined;\n}\n\nfunction enrichFromEvent(\n  event?: NitroEventLike,\n): Record<string, unknown> | undefined {\n  if (!event) return undefined;\n\n  return {\n    ...(event.method ? { 'http.request.method': event.method } : {}),\n    ...(event.path ? { 'http.route': event.path } : {}),\n    ...(typeof event.context?.requestId === 'string'\n      ? { 'http.request.id': event.context.requestId }\n      : {}),\n  };\n}\n\nconst baseUseLogger = createUseLogger<NitroEventLike>({\n  adapterName: 'nitro',\n  enrich: enrichFromEvent,\n});\nconst nitroLoggerStorage = new AsyncLocalStorage<RequestLogger>();\n\nexport function useLogger(\n  event?: NitroEventLike,\n  serviceOrOptions?: string | RequestLoggerOptions,\n): RequestLogger {\n  const stored = nitroLoggerStorage.getStore();\n  const logger = stored ??\n    (\n    typeof serviceOrOptions === 'string'\n      ? baseUseLogger(event)\n      : baseUseLogger(event, serviceOrOptions)\n    );\n\n  if (typeof serviceOrOptions === 'string' && serviceOrOptions.length > 0) {\n    logger.set({ service: serviceOrOptions });\n  }\n\n  return logger;\n}\n\nexport function withAutotelEventHandler<TEvent extends NitroEventLike, TReturn>(\n  handler: (event: TEvent) => TReturn | Promise<TReturn>,\n  options?: NitroWithAutotelOptions,\n): (event: TEvent) => Promise<TReturn> {\n  return async (event: TEvent): Promise<TReturn> => {\n    const spanName =\n      typeof options?.spanName === 'function'\n        ? options.spanName(event)\n        : (options?.spanName ?? `nitro.${event.method ?? 'request'}`);\n\n    const wrapped = trace({ name: spanName }, (ctx) => async (innerEvent: TEvent) => {\n      const log = getRequestLogger(ctx, options?.requestLoggerOptions);\n      const auto = enrichFromEvent(innerEvent);\n      if (auto && Object.keys(auto).length > 0) {\n        log.set(auto);\n      }\n      const custom = options?.enrich?.(innerEvent);\n      if (custom && Object.keys(custom).length > 0) {\n        log.set(custom);\n      }\n      return await nitroLoggerStorage.run(log, async () => handler(innerEvent));\n    });\n\n    return await wrapped(event);\n  };\n}\n\nexport function createNitroAdapter(options?: NitroWithAutotelOptions) {\n  const toolkit = createAdapterToolkit<NitroEventLike>({\n    adapterName: 'nitro',\n    enrich: (event) => ({\n      ...enrichFromEvent(event),\n      ...(options?.enrich?.(event) ?? {}),\n    }),\n  });\n\n  return {\n    withAutotelEventHandler: <TEvent extends NitroEventLike, TReturn>(\n      handler: (event: TEvent) => TReturn | Promise<TReturn>,\n    ) => withAutotelEventHandler(handler, options),\n    useLogger,\n    parseError: toolkit.parseError,\n    createStructuredError: toolkit.createStructuredError,\n    createDrainPipeline: toolkit.createDrainPipeline,\n  };\n}\n\nexport const nitroToolkit = createAdapterToolkit<NitroEventLike>({\n  adapterName: 'nitro',\n  enrich: enrichFromEvent,\n});\n"]}

package/dist/chunk-CITNYQ2G.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cloudflare.ts"],"names":[],"mappings":"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","file":"chunk-CITNYQ2G.js","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}\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          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"]}

package/dist/chunk-GBSB7IX7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core.ts"],"names":[],"mappings":"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","file":"chunk-GBSB7IX7.js","sourcesContent":["import {\n  createDrainPipeline,\n  createStructuredError,\n  getRequestLogger,\n  parseError,\n  type ParsedError,\n  type RequestLogger,\n  type RequestLoggerOptions,\n  type RequestLogSnapshot,\n  type DrainPipelineOptions,\n  type PipelineDrainFn,\n  type StructuredError,\n  type StructuredErrorInput,\n} from 'autotel';\n\nexport interface AdapterUseLoggerOptions<TContext> {\n  adapterName: string;\n  enrich?: (context: TContext) => Record<string, unknown> | undefined;\n}\n\nexport interface AdapterToolkit<TContext> {\n  useLogger: (\n    context?: TContext,\n    options?: RequestLoggerOptions,\n  ) => RequestLogger;\n  parseError: (error: unknown) => ParsedError;\n  createStructuredError: (input: StructuredErrorInput) => StructuredError;\n  createDrainPipeline: <T = unknown>(\n    options?: DrainPipelineOptions<T>,\n  ) => (drain: (batch: T[]) => void | Promise<void>) => PipelineDrainFn<T>;\n}\n\nexport function createUseLogger<TContext = unknown>(\n  options: AdapterUseLoggerOptions<TContext>,\n) {\n  return function useLogger(\n    context?: TContext,\n    requestLoggerOptions?: RequestLoggerOptions,\n  ): RequestLogger {\n    let logger: RequestLogger;\n    try {\n      logger = getRequestLogger(undefined, requestLoggerOptions);\n    } catch {\n      throw new Error(\n        `[autotel-adapters/${options.adapterName}] No active trace context. ` +\n          `Wrap your handler with autotel trace instrumentation before calling useLogger().`,\n      );\n    }\n\n    if (context && options.enrich) {\n      const extra = options.enrich(context);\n      if (extra && Object.keys(extra).length > 0) {\n        logger.set(extra);\n      }\n    }\n\n    return logger;\n  };\n}\n\nexport function createAdapterToolkit<TContext = unknown>(\n  options: AdapterUseLoggerOptions<TContext>,\n): AdapterToolkit<TContext> {\n  return {\n    useLogger: createUseLogger(options),\n    parseError,\n    createStructuredError,\n    createDrainPipeline,\n  };\n}\n\n/**\n * Description of a single adapter config field. `env` is the ordered list of\n * environment variables to fall back to.\n */\nexport interface ConfigField<T> {\n  key: keyof T & string;\n  env?: string[];\n}\n\nfunction resolveEnv(envKeys?: string[]): string | undefined {\n  if (!envKeys) return undefined;\n  for (const key of envKeys) {\n    const value = process.env[key];\n    if (value) return value;\n  }\n  return undefined;\n}\n\n/**\n * Returns true when at least one env-backed field is not provided via\n * `overrides`, meaning runtime config may still contribute and should be\n * probed to preserve precedence (`overrides > runtime > env`).\n *\n * @example\n * ```ts\n * const FIELDS: ConfigField<MyAdapterConfig>[] = [\n *   { key: 'token', env: ['MY_ADAPTER_TOKEN'] },\n *   { key: 'endpoint', env: ['MY_ADAPTER_URL'] },\n * ]\n *\n * if (shouldProbeRuntime(FIELDS, overrides)) {\n *   runtimeConfig = await loadRuntimeConfig()\n * }\n * ```\n */\nexport function shouldProbeRuntime<T>(\n  fields: ConfigField<T>[],\n  overrides?: Partial<T>,\n): boolean {\n  return fields.some(({ key, env }) => {\n    if (!env || env.length === 0) return false;\n    if (overrides?.[key] !== undefined) return false;\n    return true;\n  });\n}\n\n/**\n * Resolve adapter configuration with the standard priority chain:\n *\n * 1. `overrides` passed to the adapter factory\n * 2. `runtimeConfig.autotel.{namespace}.{key}` (if a probe was performed)\n * 3. `runtimeConfig.{namespace}.{key}` (if a probe was performed)\n * 4. `process.env[envKey]` for each env in `field.env`\n *\n * Pass an async `probe` to defer the runtime config lookup so it is only\n * invoked when runtime resolution is needed (i.e. at least one env-backed\n * field is not set by overrides). Adapters that have no probe target may pass\n * `() => Promise.resolve(undefined)`.\n */\nexport async function resolveAdapterConfig<T>(\n  namespace: string,\n  fields: ConfigField<T>[],\n  overrides: Partial<T> | undefined,\n  probe: () => Promise<Record<string, any> | undefined>,\n): Promise<Partial<T>> {\n  const runtimeConfig = shouldProbeRuntime(fields, overrides)\n    ? await probe()\n    : undefined;\n  const autotelNs = runtimeConfig?.autotel?.[namespace];\n  const rootNs = runtimeConfig?.[namespace];\n\n  const config: Record<string, unknown> = {};\n  for (const { key, env } of fields) {\n    config[key] =\n      overrides?.[key] ??\n      autotelNs?.[key] ??\n      rootNs?.[key] ??\n      resolveEnv(env);\n  }\n\n  return config as Partial<T>;\n}\n\nexport type HeadersLike =\n  | { get(name: string): string | null }\n  | Record<string, string | undefined>;\n\nexport function getHeader(\n  headers: HeadersLike | undefined,\n  name: string,\n): string | undefined {\n  if (!headers) return undefined;\n  if ('get' in headers && typeof headers.get === 'function') {\n    return headers.get(name) ?? undefined;\n  }\n  const dictionary = headers as Record<string, string | undefined>;\n  const value = dictionary[name] ?? dictionary[name.toLowerCase()];\n  return typeof value === 'string' ? value : undefined;\n}\n\nexport type {\n  RequestLogger,\n  RequestLoggerOptions,\n  RequestLogSnapshot,\n  ParsedError,\n  StructuredError,\n  StructuredErrorInput,\n  DrainPipelineOptions,\n  PipelineDrainFn,\n};\n"]}

package/dist/chunk-GPWONOFN.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/next.ts"],"names":[],"mappings":"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","file":"chunk-GPWONOFN.js","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport {\n  createDrainPipeline,\n  getRequestLogger,\n  parseError,\n  trace,\n  createStructuredError,\n  type RequestLogger,\n  type RequestLoggerOptions,\n  type ParsedError,\n  type DrainPipelineOptions,\n  type PipelineDrainFn,\n  type StructuredError,\n  type StructuredErrorInput,\n} from 'autotel';\nimport { createAdapterToolkit, createUseLogger, getHeader } from './core';\n\nexport interface NextRequestLike {\n  method?: string;\n  url?: string;\n  headers?:\n    | { get(name: string): string | null }\n    | Record<string, string | undefined>;\n}\n\nexport interface NextWithAutotelOptions {\n  spanName?: string | ((request?: NextRequestLike) => string);\n  requestLoggerOptions?: RequestLoggerOptions;\n  enrich?: (request?: NextRequestLike) => Record<string, unknown> | undefined;\n}\n\nconst nextLoggerStorage = new AsyncLocalStorage<RequestLogger>();\n\nfunction enrichFromRequest(\n  request?: NextRequestLike,\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  const requestId = getHeader(request.headers, 'x-request-id');\n\n  return {\n    ...(request.method ? { 'http.request.method': request.method } : {}),\n    ...(request.url ? { 'url.full': request.url } : {}),\n    ...(route ? { 'http.route': route } : {}),\n    ...(requestId ? { 'http.request.header.x-request-id': requestId } : {}),\n  };\n}\n\nconst baseUseLogger = createUseLogger<NextRequestLike>({\n  adapterName: 'next',\n  enrich: enrichFromRequest,\n});\n\nexport function useLogger(\n  request?: NextRequestLike,\n  requestLoggerOptions?: RequestLoggerOptions,\n): RequestLogger {\n  const logger = nextLoggerStorage.getStore();\n  if (logger) return logger;\n  return baseUseLogger(request, requestLoggerOptions);\n}\n\nexport function withAutotel<TArgs extends unknown[], TReturn>(\n  handler: (...args: TArgs) => TReturn | Promise<TReturn>,\n  options?: NextWithAutotelOptions,\n): (...args: TArgs) => Promise<TReturn> {\n  return async (...args: TArgs): Promise<TReturn> => {\n    const request = args[0] as NextRequestLike | undefined;\n    const spanName =\n      typeof options?.spanName === 'function'\n        ? options.spanName(request)\n        : (options?.spanName ?? 'next.request');\n\n    const wrapped = trace(\n      { name: spanName },\n      (ctx) => async (...innerArgs: TArgs) => {\n        const innerRequest = innerArgs[0] as NextRequestLike | undefined;\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?.(innerRequest);\n        if (custom && Object.keys(custom).length > 0) {\n          log.set(custom);\n        }\n        return await nextLoggerStorage.run(log, async () => handler(...innerArgs));\n      },\n    );\n    return await wrapped(...args);\n  };\n}\n\nexport function createNextAdapter(options?: NextWithAutotelOptions) {\n  return {\n    withAutotel: <TArgs extends unknown[], TReturn>(\n      handler: (...args: TArgs) => TReturn | Promise<TReturn>,\n    ) => withAutotel(handler, options),\n    useLogger: (\n      request?: NextRequestLike,\n      requestLoggerOptions?: RequestLoggerOptions,\n    ): RequestLogger => useLogger(request, requestLoggerOptions),\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 nextToolkit = createAdapterToolkit<NextRequestLike>({\n  adapterName: 'next',\n  enrich: enrichFromRequest,\n});\n\nexport { parseError, createDrainPipeline, createStructuredError };\n"]}