@stainlessdev/xray-emitter 0.1.0-dev.3b8d877 → 0.1.0-dev.7eabc37

package/dist/fetch.d.cts

@@ -1,18 +1,55 @@
-export { c as createEmitter } from './emitter-Cdl6H6vk.cjs';
-import { a as XrayEmitter, e as CaptureConfig, f as RedactionConfig, d as XrayContext, R as RequestLog } from './types-Diy-KLjz.cjs';
+export { c as createEmitter } from './emitter-Bi_m_w5h.cjs';
+import { a as XrayEmitter, e as CaptureConfig, f as RedactionConfig, d as XrayContext, R as RequestLog } from './types-BrKvhHbn.cjs';
 import '@opentelemetry/sdk-trace-base';
 
 interface WrapOptions {
+    /**
+     * Explicit route pattern for this handler (for example `/users/:id`).
+     */
     route?: string;
+    /**
+     * Explicit request ID. Skips header lookup/generation when provided.
+     */
     requestId?: string;
+    /**
+     * Per-handler capture overrides.
+     */
     capture?: Partial<CaptureConfig>;
+    /**
+     * Per-handler redaction overrides.
+     */
     redaction?: Partial<RedactionConfig>;
+    /**
+     * Hook called after request context is created.
+     */
     onRequest?: (ctx: XrayContext) => void;
+    /**
+     * Hook called after the request has been finalized and logged.
+     */
     onResponse?: (ctx: XrayContext, log: RequestLog) => void;
+    /**
+     * Hook called when request handling fails.
+     */
     onError?: (ctx: XrayContext, err: unknown) => void;
 }
+/**
+ * Wrap a fetch-style handler with X-ray instrumentation.
+ *
+ * This variant may replace the request/response objects to safely capture
+ * bodies and inject a request ID response header when needed.
+ */
 declare function wrapFetch(handler: (req: Request) => Response | Promise<Response>, xray: XrayEmitter, options?: WrapOptions): (req: Request) => Promise<Response>;
+/**
+ * Wrap a fetch-style handler while preserving original request/response objects
+ * whenever possible.
+ *
+ * If a missing request ID header must be injected and response headers are
+ * immutable, this wrapper may still replace the response object.
+ */
 declare function wrapFetchPreserve(handler: (req: Request) => Response | Promise<Response>, xray: XrayEmitter, options?: WrapOptions): (req: Request) => Promise<Response>;
+/**
+ * Retrieve the `XrayContext` bound to a fetch `Request`.
+ */
 declare function getXrayContext(req: Request): XrayContext | undefined;
 
 export { type WrapOptions, getXrayContext, wrapFetch, wrapFetchPreserve };

package/dist/fetch.d.ts

@@ -1,18 +1,55 @@
-export { c as createEmitter } from './emitter-DnDvQw9i.js';
-import { a as XrayEmitter, e as CaptureConfig, f as RedactionConfig, d as XrayContext, R as RequestLog } from './types-Diy-KLjz.js';
+export { c as createEmitter } from './emitter-Dy7bRGTq.js';
+import { a as XrayEmitter, e as CaptureConfig, f as RedactionConfig, d as XrayContext, R as RequestLog } from './types-BrKvhHbn.js';
 import '@opentelemetry/sdk-trace-base';
 
 interface WrapOptions {
+    /**
+     * Explicit route pattern for this handler (for example `/users/:id`).
+     */
     route?: string;
+    /**
+     * Explicit request ID. Skips header lookup/generation when provided.
+     */
     requestId?: string;
+    /**
+     * Per-handler capture overrides.
+     */
     capture?: Partial<CaptureConfig>;
+    /**
+     * Per-handler redaction overrides.
+     */
     redaction?: Partial<RedactionConfig>;
+    /**
+     * Hook called after request context is created.
+     */
     onRequest?: (ctx: XrayContext) => void;
+    /**
+     * Hook called after the request has been finalized and logged.
+     */
     onResponse?: (ctx: XrayContext, log: RequestLog) => void;
+    /**
+     * Hook called when request handling fails.
+     */
     onError?: (ctx: XrayContext, err: unknown) => void;
 }
+/**
+ * Wrap a fetch-style handler with X-ray instrumentation.
+ *
+ * This variant may replace the request/response objects to safely capture
+ * bodies and inject a request ID response header when needed.
+ */
 declare function wrapFetch(handler: (req: Request) => Response | Promise<Response>, xray: XrayEmitter, options?: WrapOptions): (req: Request) => Promise<Response>;
+/**
+ * Wrap a fetch-style handler while preserving original request/response objects
+ * whenever possible.
+ *
+ * If a missing request ID header must be injected and response headers are
+ * immutable, this wrapper may still replace the response object.
+ */
 declare function wrapFetchPreserve(handler: (req: Request) => Response | Promise<Response>, xray: XrayEmitter, options?: WrapOptions): (req: Request) => Promise<Response>;
+/**
+ * Retrieve the `XrayContext` bound to a fetch `Request`.
+ */
 declare function getXrayContext(req: Request): XrayContext | undefined;
 
 export { type WrapOptions, getXrayContext, wrapFetch, wrapFetchPreserve };

package/dist/fetch.js

@@ -3,8 +3,8 @@ import {
   getXrayContext,
   wrapFetch,
   wrapFetchPreserve
-} from "./chunk-W75UIHEF.js";
-import "./chunk-VRRPTE7W.js";
+} from "./chunk-LJYBYC7N.js";
+import "./chunk-DKHGODGO.js";
 import "./chunk-NTIUR3OC.js";
 import "./chunk-7KT6EPVZ.js";
 export {

package/dist/hono.cjs

@@ -2,8 +2,8 @@
 
 
 
-var _chunkESBHEKC2cjs = require('./chunk-ESBHEKC2.cjs');
-require('./chunk-Q4MTHPUL.cjs');
+var _chunk22W6MSR2cjs = require('./chunk-22W6MSR2.cjs');
+require('./chunk-3LDFK62Q.cjs');
 
 
 var _chunkCPHFCOA5cjs = require('./chunk-CPHFCOA5.cjs');
@@ -11,7 +11,7 @@ require('./chunk-DNBARLGB.cjs');
 
 // src/hono/hono.ts
 function createEmitter2(config, options) {
-  const emitter = _chunkESBHEKC2cjs.createEmitter.call(void 0, config);
+  const emitter = _chunk22W6MSR2cjs.createEmitter.call(void 0, config);
   const middleware = createHonoMiddleware(emitter, options);
   middleware.flush = emitter.flush;
   middleware.shutdown = emitter.shutdown;
@@ -25,9 +25,9 @@ function createHonoMiddleware(xray, options) {
       await next();
       return;
     }
-    const wrapped = _chunkESBHEKC2cjs.wrapFetchPreserve.call(void 0, 
+    const wrapped = _chunk22W6MSR2cjs.wrapFetchPreserve.call(void 0, 
       async (req) => {
-        const ctx = _chunkESBHEKC2cjs.getXrayContext.call(void 0, req);
+        const ctx = _chunk22W6MSR2cjs.getXrayContext.call(void 0, req);
         if (ctx) {
           c.set("xray", ctx);
         }
@@ -67,5 +67,5 @@ function resolveRoutePath(fn, ctx, index) {
 
 
 
-exports.createCoreEmitter = _chunkESBHEKC2cjs.createEmitter; exports.createEmitter = createEmitter2; exports.createHonoMiddleware = createHonoMiddleware;
+exports.createCoreEmitter = _chunk22W6MSR2cjs.createEmitter; exports.createEmitter = createEmitter2; exports.createHonoMiddleware = createHonoMiddleware;
 //# sourceMappingURL=hono.cjs.map

package/dist/hono.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/xray-emitter-js/xray-emitter-js/dist/hono.cjs","../src/hono/hono.ts"],"names":["createEmitter"],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACA;ACmCO,SAASA,cAAAA,CAAc,MAAA,EAA2B,OAAA,EAAwC;AAC/F,EAAA,MAAM,QAAA,EAAU,6CAAA,MAAyB,CAAA;AACzC,EAAA,MAAM,WAAA,EAAa,oBAAA,CAAqB,OAAA,EAAS,OAAO,CAAA;AACxD,EAAA,UAAA,CAAW,MAAA,EAAQ,OAAA,CAAQ,KAAA;AAC3B,EAAA,UAAA,CAAW,SAAA,EAAW,OAAA,CAAQ,QAAA;AAC9B,EAAA,OAAO,UAAA;AACT;AAEO,SAAS,oBAAA,CAAqB,IAAA,EAAmB,OAAA,EAA2C;AACjG,EAAA,MAAM,YAAA,kBAAc,OAAA,2BAAS,WAAA;AAE7B,EAAA,OAAO,MAAA,CAAO,CAAA,EAAG,IAAA,EAAA,GAAS;AACxB,IAAA,MAAM,QAAA,EAAU,CAAA,CAAE,GAAA,CAAI,GAAA;AACtB,IAAA,GAAA,CAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAA,CAAK,CAAA;AACX,MAAA,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,EAAU,iDAAA;AAAA,MACd,MAAA,CAAO,GAAA,EAAA,GAAQ;AACb,QAAA,MAAM,IAAA,EAAM,8CAAA,GAAkB,CAAA;AAC9B,QAAA,GAAA,CAAI,GAAA,EAAK;AACP,UAAA,CAAA,CAAE,GAAA,CAAI,MAAA,EAAQ,GAAG,CAAA;AAAA,QACnB;AAEA,QAAA,IAAI,MAAA,EAAQ,gBAAA,CAAiB,WAAA,EAAa,CAAA,EAAG,CAAA,CAAE,CAAA;AAC/C,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,CAAK,CAAA;AACX,UAAA,OAAO,CAAA,CAAE,GAAA;AAAA,QACX,EAAA,QAAE;AACA,UAAA,GAAA,CAAI,CAAC,KAAA,EAAO;AACV,YAAA,MAAA,EAAQ,gBAAA,CAAiB,WAAA,EAAa,CAAC,CAAA;AAAA,UACzC;AACA,UAAA,GAAA,CAAI,MAAA,GAAS,GAAA,EAAK;AAChB,YAAA,+CAAA,GAAgB,EAAK,KAAK,CAAA;AAAA,UAC5B;AAAA,QACF;AAAA,MACF,CAAA;AAAA,MACA,IAAA;AAAA,MACA;AAAA,IACF,CAAA;AAEA,IAAA,MAAM,SAAA,EAAW,MAAM,OAAA,CAAQ,OAAO,CAAA;AACtC,IAAA,GAAA,CAAI,SAAA,WAAoB,SAAA,GAAY,SAAA,IAAa,CAAA,CAAE,GAAA,EAAK;AACtD,MAAA,CAAA,CAAE,IAAA,EAAM,QAAA;AAAA,IACV;AAAA,EACF,CAAA;AACF;AAEA,SAAS,gBAAA,CACP,EAAA,EACA,GAAA,EACA,KAAA,EACoB;AACpB,EAAA,GAAA,CAAI,CAAC,EAAA,EAAI;AACP,IAAA,OAAO,KAAA,CAAA;AAAA,EACT;AACA,EAAA,IAAI;AACF,IAAA,OAAO,MAAA,IAAU,KAAA,EAAA,EAAY,EAAA,CAAG,GAAG,EAAA,EAAI,EAAA,CAAG,GAAA,EAAK,KAAK,CAAA;AAAA,EACtD,EAAA,UAAQ;AACN,IAAA,OAAO,KAAA,CAAA;AAAA,EACT;AACF;AD3CA;AACE;AACA;AACA;AACF,yJAAC","file":"/home/runner/work/xray-emitter-js/xray-emitter-js/dist/hono.cjs","sourcesContent":[null,"import type { XrayEmitter, XrayContext, XrayRuntimeConfig } from '../core/index';\nimport { setContextRoute } from '../core/internal';\nimport {\n  createEmitter as createFetchEmitter,\n  getXrayContext,\n  wrapFetchPreserve,\n  type WrapOptions,\n} from '../fetch/fetch';\n\nexport { createFetchEmitter as createCoreEmitter };\nexport type {\n  CaptureConfig,\n  RedactionConfig,\n  RequestLog,\n  XrayConfig,\n  XrayContext,\n  XrayEmitter,\n  XrayRuntimeConfig,\n} from '../core/index';\nexport type { WrapOptions } from '../fetch/fetch';\n\n// copy types from Hono to avoid a package dependency\ninterface HonoCompatibleContext {\n  req: { raw: Request };\n  res: Response;\n  set(key: string, value: unknown): void;\n}\n\ntype HonoMiddleware = (\n  c: HonoCompatibleContext,\n  next: () => Promise<void>,\n) => Promise<void | Response>;\n\nexport type HonoXrayEnv = {\n  Variables: { xray?: XrayContext };\n};\n\ntype HonoEmitter = HonoMiddleware & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\nexport interface HonoWrapOptions extends WrapOptions {\n  routePath?(ctx: HonoCompatibleContext, index?: number): string;\n}\n\nexport function createEmitter(config: XrayRuntimeConfig, options?: HonoWrapOptions): HonoEmitter {\n  const emitter = createFetchEmitter(config);\n  const middleware = createHonoMiddleware(emitter, options) as HonoEmitter;\n  middleware.flush = emitter.flush;\n  middleware.shutdown = emitter.shutdown;\n  return middleware;\n}\n\nexport function createHonoMiddleware(xray: XrayEmitter, options?: HonoWrapOptions): HonoMiddleware {\n  const routePathFn = options?.routePath;\n\n  return async (c, next) => {\n    const request = c.req.raw;\n    if (!request) {\n      await next();\n      return;\n    }\n\n    const wrapped = wrapFetchPreserve(\n      async (req) => {\n        const ctx = getXrayContext(req);\n        if (ctx) {\n          c.set('xray', ctx);\n        }\n\n        let route = resolveRoutePath(routePathFn, c, -1);\n        try {\n          await next();\n          return c.res;\n        } finally {\n          if (!route) {\n            route = resolveRoutePath(routePathFn, c);\n          }\n          if (route && ctx) {\n            setContextRoute(ctx, route);\n          }\n        }\n      },\n      xray,\n      options,\n    );\n\n    const response = await wrapped(request);\n    if (response instanceof Response && response !== c.res) {\n      c.res = response;\n    }\n  };\n}\n\nfunction resolveRoutePath(\n  fn: ((ctx: HonoCompatibleContext, index?: number) => string) | undefined,\n  ctx: HonoCompatibleContext,\n  index?: number,\n): string | undefined {\n  if (!fn) {\n    return undefined;\n  }\n  try {\n    return index === undefined ? fn(ctx) : fn(ctx, index);\n  } catch {\n    return undefined;\n  }\n}\n"]}
+{"version":3,"sources":["/home/runner/work/xray-emitter-js/xray-emitter-js/dist/hono.cjs","../src/hono/hono.ts"],"names":["createEmitter"],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACA;AC4CO,SAASA,cAAAA,CAAc,MAAA,EAA2B,OAAA,EAAwC;AAC/F,EAAA,MAAM,QAAA,EAAU,6CAAA,MAAyB,CAAA;AACzC,EAAA,MAAM,WAAA,EAAa,oBAAA,CAAqB,OAAA,EAAS,OAAO,CAAA;AACxD,EAAA,UAAA,CAAW,MAAA,EAAQ,OAAA,CAAQ,KAAA;AAC3B,EAAA,UAAA,CAAW,SAAA,EAAW,OAAA,CAAQ,QAAA;AAC9B,EAAA,OAAO,UAAA;AACT;AAKO,SAAS,oBAAA,CAAqB,IAAA,EAAmB,OAAA,EAA2C;AACjG,EAAA,MAAM,YAAA,kBAAc,OAAA,2BAAS,WAAA;AAE7B,EAAA,OAAO,MAAA,CAAO,CAAA,EAAG,IAAA,EAAA,GAAS;AACxB,IAAA,MAAM,QAAA,EAAU,CAAA,CAAE,GAAA,CAAI,GAAA;AACtB,IAAA,GAAA,CAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAA,CAAK,CAAA;AACX,MAAA,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,QAAA,EAAU,iDAAA;AAAA,MACd,MAAA,CAAO,GAAA,EAAA,GAAQ;AACb,QAAA,MAAM,IAAA,EAAM,8CAAA,GAAkB,CAAA;AAC9B,QAAA,GAAA,CAAI,GAAA,EAAK;AACP,UAAA,CAAA,CAAE,GAAA,CAAI,MAAA,EAAQ,GAAG,CAAA;AAAA,QACnB;AAEA,QAAA,IAAI,MAAA,EAAQ,gBAAA,CAAiB,WAAA,EAAa,CAAA,EAAG,CAAA,CAAE,CAAA;AAC/C,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,CAAK,CAAA;AACX,UAAA,OAAO,CAAA,CAAE,GAAA;AAAA,QACX,EAAA,QAAE;AACA,UAAA,GAAA,CAAI,CAAC,KAAA,EAAO;AACV,YAAA,MAAA,EAAQ,gBAAA,CAAiB,WAAA,EAAa,CAAC,CAAA;AAAA,UACzC;AACA,UAAA,GAAA,CAAI,MAAA,GAAS,GAAA,EAAK;AAChB,YAAA,+CAAA,GAAgB,EAAK,KAAK,CAAA;AAAA,UAC5B;AAAA,QACF;AAAA,MACF,CAAA;AAAA,MACA,IAAA;AAAA,MACA;AAAA,IACF,CAAA;AAEA,IAAA,MAAM,SAAA,EAAW,MAAM,OAAA,CAAQ,OAAO,CAAA;AACtC,IAAA,GAAA,CAAI,SAAA,WAAoB,SAAA,GAAY,SAAA,IAAa,CAAA,CAAE,GAAA,EAAK;AACtD,MAAA,CAAA,CAAE,IAAA,EAAM,QAAA;AAAA,IACV;AAAA,EACF,CAAA;AACF;AAEA,SAAS,gBAAA,CACP,EAAA,EACA,GAAA,EACA,KAAA,EACoB;AACpB,EAAA,GAAA,CAAI,CAAC,EAAA,EAAI;AACP,IAAA,OAAO,KAAA,CAAA;AAAA,EACT;AACA,EAAA,IAAI;AACF,IAAA,OAAO,MAAA,IAAU,KAAA,EAAA,EAAY,EAAA,CAAG,GAAG,EAAA,EAAI,EAAA,CAAG,GAAA,EAAK,KAAK,CAAA;AAAA,EACtD,EAAA,UAAQ;AACN,IAAA,OAAO,KAAA,CAAA;AAAA,EACT;AACF;ADvDA;AACE;AACA;AACA;AACF,yJAAC","file":"/home/runner/work/xray-emitter-js/xray-emitter-js/dist/hono.cjs","sourcesContent":[null,"import type { XrayEmitter, XrayContext, XrayRuntimeConfig } from '../core/index';\nimport { setContextRoute } from '../core/internal';\nimport {\n  createEmitter as createFetchEmitter,\n  getXrayContext,\n  wrapFetchPreserve,\n  type WrapOptions,\n} from '../fetch/fetch';\n\nexport { createFetchEmitter as createCoreEmitter };\nexport type {\n  CaptureConfig,\n  RedactionConfig,\n  RequestLog,\n  XrayConfig,\n  XrayContext,\n  XrayEmitter,\n  XrayRuntimeConfig,\n} from '../core/index';\nexport type { WrapOptions } from '../fetch/fetch';\n\n// copy types from Hono to avoid a package dependency\ninterface HonoCompatibleContext {\n  req: { raw: Request };\n  res: Response;\n  set(key: string, value: unknown): void;\n}\n\ntype HonoMiddleware = (\n  c: HonoCompatibleContext,\n  next: () => Promise<void>,\n) => Promise<void | Response>;\n\n/**\n * Hono env helper that adds `xray` to `c.get(...)` variables.\n */\nexport type HonoXrayEnv = {\n  Variables: { xray?: XrayContext };\n};\n\ntype HonoEmitter = HonoMiddleware & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\nexport interface HonoWrapOptions extends WrapOptions {\n  /**\n   * Optional route resolver used to capture Hono route patterns.\n   */\n  routePath?(ctx: HonoCompatibleContext, index?: number): string;\n}\n\n/**\n * Create Hono middleware and expose `flush()`/`shutdown()` helpers.\n */\nexport function createEmitter(config: XrayRuntimeConfig, options?: HonoWrapOptions): HonoEmitter {\n  const emitter = createFetchEmitter(config);\n  const middleware = createHonoMiddleware(emitter, options) as HonoEmitter;\n  middleware.flush = emitter.flush;\n  middleware.shutdown = emitter.shutdown;\n  return middleware;\n}\n\n/**\n * Create Hono middleware from an existing core `XrayEmitter`.\n */\nexport function createHonoMiddleware(xray: XrayEmitter, options?: HonoWrapOptions): HonoMiddleware {\n  const routePathFn = options?.routePath;\n\n  return async (c, next) => {\n    const request = c.req.raw;\n    if (!request) {\n      await next();\n      return;\n    }\n\n    const wrapped = wrapFetchPreserve(\n      async (req) => {\n        const ctx = getXrayContext(req);\n        if (ctx) {\n          c.set('xray', ctx);\n        }\n\n        let route = resolveRoutePath(routePathFn, c, -1);\n        try {\n          await next();\n          return c.res;\n        } finally {\n          if (!route) {\n            route = resolveRoutePath(routePathFn, c);\n          }\n          if (route && ctx) {\n            setContextRoute(ctx, route);\n          }\n        }\n      },\n      xray,\n      options,\n    );\n\n    const response = await wrapped(request);\n    if (response instanceof Response && response !== c.res) {\n      c.res = response;\n    }\n  };\n}\n\nfunction resolveRoutePath(\n  fn: ((ctx: HonoCompatibleContext, index?: number) => string) | undefined,\n  ctx: HonoCompatibleContext,\n  index?: number,\n): string | undefined {\n  if (!fn) {\n    return undefined;\n  }\n  try {\n    return index === undefined ? fn(ctx) : fn(ctx, index);\n  } catch {\n    return undefined;\n  }\n}\n"]}

package/dist/hono.d.cts

@@ -1,6 +1,6 @@
-import { d as XrayContext, j as XrayRuntimeConfig, a as XrayEmitter } from './types-Diy-KLjz.cjs';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig } from './types-Diy-KLjz.cjs';
-export { c as createCoreEmitter } from './emitter-Cdl6H6vk.cjs';
+import { d as XrayContext, j as XrayRuntimeConfig, a as XrayEmitter } from './types-BrKvhHbn.cjs';
+export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig } from './types-BrKvhHbn.cjs';
+export { c as createCoreEmitter } from './emitter-Bi_m_w5h.cjs';
 import { WrapOptions } from './fetch.cjs';
 import '@opentelemetry/sdk-trace-base';
 
@@ -12,6 +12,9 @@ interface HonoCompatibleContext {
     set(key: string, value: unknown): void;
 }
 type HonoMiddleware = (c: HonoCompatibleContext, next: () => Promise<void>) => Promise<void | Response>;
+/**
+ * Hono env helper that adds `xray` to `c.get(...)` variables.
+ */
 type HonoXrayEnv = {
     Variables: {
         xray?: XrayContext;
@@ -22,9 +25,18 @@ type HonoEmitter = HonoMiddleware & {
     shutdown: XrayEmitter['shutdown'];
 };
 interface HonoWrapOptions extends WrapOptions {
+    /**
+     * Optional route resolver used to capture Hono route patterns.
+     */
     routePath?(ctx: HonoCompatibleContext, index?: number): string;
 }
+/**
+ * Create Hono middleware and expose `flush()`/`shutdown()` helpers.
+ */
 declare function createEmitter(config: XrayRuntimeConfig, options?: HonoWrapOptions): HonoEmitter;
+/**
+ * Create Hono middleware from an existing core `XrayEmitter`.
+ */
 declare function createHonoMiddleware(xray: XrayEmitter, options?: HonoWrapOptions): HonoMiddleware;
 
 export { type HonoWrapOptions, type HonoXrayEnv, WrapOptions, XrayContext, XrayEmitter, XrayRuntimeConfig, createEmitter, createHonoMiddleware };

package/dist/hono.d.ts

@@ -1,6 +1,6 @@
-import { d as XrayContext, j as XrayRuntimeConfig, a as XrayEmitter } from './types-Diy-KLjz.js';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig } from './types-Diy-KLjz.js';
-export { c as createCoreEmitter } from './emitter-DnDvQw9i.js';
+import { d as XrayContext, j as XrayRuntimeConfig, a as XrayEmitter } from './types-BrKvhHbn.js';
+export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig } from './types-BrKvhHbn.js';
+export { c as createCoreEmitter } from './emitter-Dy7bRGTq.js';
 import { WrapOptions } from './fetch.js';
 import '@opentelemetry/sdk-trace-base';
 
@@ -12,6 +12,9 @@ interface HonoCompatibleContext {
     set(key: string, value: unknown): void;
 }
 type HonoMiddleware = (c: HonoCompatibleContext, next: () => Promise<void>) => Promise<void | Response>;
+/**
+ * Hono env helper that adds `xray` to `c.get(...)` variables.
+ */
 type HonoXrayEnv = {
     Variables: {
         xray?: XrayContext;
@@ -22,9 +25,18 @@ type HonoEmitter = HonoMiddleware & {
     shutdown: XrayEmitter['shutdown'];
 };
 interface HonoWrapOptions extends WrapOptions {
+    /**
+     * Optional route resolver used to capture Hono route patterns.
+     */
     routePath?(ctx: HonoCompatibleContext, index?: number): string;
 }
+/**
+ * Create Hono middleware and expose `flush()`/`shutdown()` helpers.
+ */
 declare function createEmitter(config: XrayRuntimeConfig, options?: HonoWrapOptions): HonoEmitter;
+/**
+ * Create Hono middleware from an existing core `XrayEmitter`.
+ */
 declare function createHonoMiddleware(xray: XrayEmitter, options?: HonoWrapOptions): HonoMiddleware;
 
 export { type HonoWrapOptions, type HonoXrayEnv, WrapOptions, XrayContext, XrayEmitter, XrayRuntimeConfig, createEmitter, createHonoMiddleware };

package/dist/hono.js

@@ -2,8 +2,8 @@ import {
   createEmitter,
   getXrayContext,
   wrapFetchPreserve
-} from "./chunk-W75UIHEF.js";
-import "./chunk-VRRPTE7W.js";
+} from "./chunk-LJYBYC7N.js";
+import "./chunk-DKHGODGO.js";
 import {
   setContextRoute
 } from "./chunk-NTIUR3OC.js";

package/dist/hono.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/hono/hono.ts"],"sourcesContent":["import type { XrayEmitter, XrayContext, XrayRuntimeConfig } from '../core/index';\nimport { setContextRoute } from '../core/internal';\nimport {\n  createEmitter as createFetchEmitter,\n  getXrayContext,\n  wrapFetchPreserve,\n  type WrapOptions,\n} from '../fetch/fetch';\n\nexport { createFetchEmitter as createCoreEmitter };\nexport type {\n  CaptureConfig,\n  RedactionConfig,\n  RequestLog,\n  XrayConfig,\n  XrayContext,\n  XrayEmitter,\n  XrayRuntimeConfig,\n} from '../core/index';\nexport type { WrapOptions } from '../fetch/fetch';\n\n// copy types from Hono to avoid a package dependency\ninterface HonoCompatibleContext {\n  req: { raw: Request };\n  res: Response;\n  set(key: string, value: unknown): void;\n}\n\ntype HonoMiddleware = (\n  c: HonoCompatibleContext,\n  next: () => Promise<void>,\n) => Promise<void | Response>;\n\nexport type HonoXrayEnv = {\n  Variables: { xray?: XrayContext };\n};\n\ntype HonoEmitter = HonoMiddleware & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\nexport interface HonoWrapOptions extends WrapOptions {\n  routePath?(ctx: HonoCompatibleContext, index?: number): string;\n}\n\nexport function createEmitter(config: XrayRuntimeConfig, options?: HonoWrapOptions): HonoEmitter {\n  const emitter = createFetchEmitter(config);\n  const middleware = createHonoMiddleware(emitter, options) as HonoEmitter;\n  middleware.flush = emitter.flush;\n  middleware.shutdown = emitter.shutdown;\n  return middleware;\n}\n\nexport function createHonoMiddleware(xray: XrayEmitter, options?: HonoWrapOptions): HonoMiddleware {\n  const routePathFn = options?.routePath;\n\n  return async (c, next) => {\n    const request = c.req.raw;\n    if (!request) {\n      await next();\n      return;\n    }\n\n    const wrapped = wrapFetchPreserve(\n      async (req) => {\n        const ctx = getXrayContext(req);\n        if (ctx) {\n          c.set('xray', ctx);\n        }\n\n        let route = resolveRoutePath(routePathFn, c, -1);\n        try {\n          await next();\n          return c.res;\n        } finally {\n          if (!route) {\n            route = resolveRoutePath(routePathFn, c);\n          }\n          if (route && ctx) {\n            setContextRoute(ctx, route);\n          }\n        }\n      },\n      xray,\n      options,\n    );\n\n    const response = await wrapped(request);\n    if (response instanceof Response && response !== c.res) {\n      c.res = response;\n    }\n  };\n}\n\nfunction resolveRoutePath(\n  fn: ((ctx: HonoCompatibleContext, index?: number) => string) | undefined,\n  ctx: HonoCompatibleContext,\n  index?: number,\n): string | undefined {\n  if (!fn) {\n    return undefined;\n  }\n  try {\n    return index === undefined ? fn(ctx) : fn(ctx, index);\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AA8CO,SAASA,eAAc,QAA2B,SAAwC;AAC/F,QAAM,UAAU,cAAmB,MAAM;AACzC,QAAM,aAAa,qBAAqB,SAAS,OAAO;AACxD,aAAW,QAAQ,QAAQ;AAC3B,aAAW,WAAW,QAAQ;AAC9B,SAAO;AACT;AAEO,SAAS,qBAAqB,MAAmB,SAA2C;AACjG,QAAM,cAAc,SAAS;AAE7B,SAAO,OAAO,GAAG,SAAS;AACxB,UAAM,UAAU,EAAE,IAAI;AACtB,QAAI,CAAC,SAAS;AACZ,YAAM,KAAK;AACX;AAAA,IACF;AAEA,UAAM,UAAU;AAAA,MACd,OAAO,QAAQ;AACb,cAAM,MAAM,eAAe,GAAG;AAC9B,YAAI,KAAK;AACP,YAAE,IAAI,QAAQ,GAAG;AAAA,QACnB;AAEA,YAAI,QAAQ,iBAAiB,aAAa,GAAG,EAAE;AAC/C,YAAI;AACF,gBAAM,KAAK;AACX,iBAAO,EAAE;AAAA,QACX,UAAE;AACA,cAAI,CAAC,OAAO;AACV,oBAAQ,iBAAiB,aAAa,CAAC;AAAA,UACzC;AACA,cAAI,SAAS,KAAK;AAChB,4BAAgB,KAAK,KAAK;AAAA,UAC5B;AAAA,QACF;AAAA,MACF;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,UAAM,WAAW,MAAM,QAAQ,OAAO;AACtC,QAAI,oBAAoB,YAAY,aAAa,EAAE,KAAK;AACtD,QAAE,MAAM;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,iBACP,IACA,KACA,OACoB;AACpB,MAAI,CAAC,IAAI;AACP,WAAO;AAAA,EACT;AACA,MAAI;AACF,WAAO,UAAU,SAAY,GAAG,GAAG,IAAI,GAAG,KAAK,KAAK;AAAA,EACtD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":["createEmitter"]}
+{"version":3,"sources":["../src/hono/hono.ts"],"sourcesContent":["import type { XrayEmitter, XrayContext, XrayRuntimeConfig } from '../core/index';\nimport { setContextRoute } from '../core/internal';\nimport {\n  createEmitter as createFetchEmitter,\n  getXrayContext,\n  wrapFetchPreserve,\n  type WrapOptions,\n} from '../fetch/fetch';\n\nexport { createFetchEmitter as createCoreEmitter };\nexport type {\n  CaptureConfig,\n  RedactionConfig,\n  RequestLog,\n  XrayConfig,\n  XrayContext,\n  XrayEmitter,\n  XrayRuntimeConfig,\n} from '../core/index';\nexport type { WrapOptions } from '../fetch/fetch';\n\n// copy types from Hono to avoid a package dependency\ninterface HonoCompatibleContext {\n  req: { raw: Request };\n  res: Response;\n  set(key: string, value: unknown): void;\n}\n\ntype HonoMiddleware = (\n  c: HonoCompatibleContext,\n  next: () => Promise<void>,\n) => Promise<void | Response>;\n\n/**\n * Hono env helper that adds `xray` to `c.get(...)` variables.\n */\nexport type HonoXrayEnv = {\n  Variables: { xray?: XrayContext };\n};\n\ntype HonoEmitter = HonoMiddleware & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\nexport interface HonoWrapOptions extends WrapOptions {\n  /**\n   * Optional route resolver used to capture Hono route patterns.\n   */\n  routePath?(ctx: HonoCompatibleContext, index?: number): string;\n}\n\n/**\n * Create Hono middleware and expose `flush()`/`shutdown()` helpers.\n */\nexport function createEmitter(config: XrayRuntimeConfig, options?: HonoWrapOptions): HonoEmitter {\n  const emitter = createFetchEmitter(config);\n  const middleware = createHonoMiddleware(emitter, options) as HonoEmitter;\n  middleware.flush = emitter.flush;\n  middleware.shutdown = emitter.shutdown;\n  return middleware;\n}\n\n/**\n * Create Hono middleware from an existing core `XrayEmitter`.\n */\nexport function createHonoMiddleware(xray: XrayEmitter, options?: HonoWrapOptions): HonoMiddleware {\n  const routePathFn = options?.routePath;\n\n  return async (c, next) => {\n    const request = c.req.raw;\n    if (!request) {\n      await next();\n      return;\n    }\n\n    const wrapped = wrapFetchPreserve(\n      async (req) => {\n        const ctx = getXrayContext(req);\n        if (ctx) {\n          c.set('xray', ctx);\n        }\n\n        let route = resolveRoutePath(routePathFn, c, -1);\n        try {\n          await next();\n          return c.res;\n        } finally {\n          if (!route) {\n            route = resolveRoutePath(routePathFn, c);\n          }\n          if (route && ctx) {\n            setContextRoute(ctx, route);\n          }\n        }\n      },\n      xray,\n      options,\n    );\n\n    const response = await wrapped(request);\n    if (response instanceof Response && response !== c.res) {\n      c.res = response;\n    }\n  };\n}\n\nfunction resolveRoutePath(\n  fn: ((ctx: HonoCompatibleContext, index?: number) => string) | undefined,\n  ctx: HonoCompatibleContext,\n  index?: number,\n): string | undefined {\n  if (!fn) {\n    return undefined;\n  }\n  try {\n    return index === undefined ? fn(ctx) : fn(ctx, index);\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAuDO,SAASA,eAAc,QAA2B,SAAwC;AAC/F,QAAM,UAAU,cAAmB,MAAM;AACzC,QAAM,aAAa,qBAAqB,SAAS,OAAO;AACxD,aAAW,QAAQ,QAAQ;AAC3B,aAAW,WAAW,QAAQ;AAC9B,SAAO;AACT;AAKO,SAAS,qBAAqB,MAAmB,SAA2C;AACjG,QAAM,cAAc,SAAS;AAE7B,SAAO,OAAO,GAAG,SAAS;AACxB,UAAM,UAAU,EAAE,IAAI;AACtB,QAAI,CAAC,SAAS;AACZ,YAAM,KAAK;AACX;AAAA,IACF;AAEA,UAAM,UAAU;AAAA,MACd,OAAO,QAAQ;AACb,cAAM,MAAM,eAAe,GAAG;AAC9B,YAAI,KAAK;AACP,YAAE,IAAI,QAAQ,GAAG;AAAA,QACnB;AAEA,YAAI,QAAQ,iBAAiB,aAAa,GAAG,EAAE;AAC/C,YAAI;AACF,gBAAM,KAAK;AACX,iBAAO,EAAE;AAAA,QACX,UAAE;AACA,cAAI,CAAC,OAAO;AACV,oBAAQ,iBAAiB,aAAa,CAAC;AAAA,UACzC;AACA,cAAI,SAAS,KAAK;AAChB,4BAAgB,KAAK,KAAK;AAAA,UAC5B;AAAA,QACF;AAAA,MACF;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAEA,UAAM,WAAW,MAAM,QAAQ,OAAO;AACtC,QAAI,oBAAoB,YAAY,aAAa,EAAE,KAAK;AACtD,QAAE,MAAM;AAAA,IACV;AAAA,EACF;AACF;AAEA,SAAS,iBACP,IACA,KACA,OACoB;AACpB,MAAI,CAAC,IAAI;AACP,WAAO;AAAA,EACT;AACA,MAAI;AACF,WAAO,UAAU,SAAY,GAAG,GAAG,IAAI,GAAG,KAAK,KAAK;AAAA,EACtD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":["createEmitter"]}

package/dist/index.cjs

@@ -2,11 +2,11 @@
 
 
 
-var _chunkQ4MTHPULcjs = require('./chunk-Q4MTHPUL.cjs');
+var _chunk3LDFK62Qcjs = require('./chunk-3LDFK62Q.cjs');
 require('./chunk-DNBARLGB.cjs');
 
 
 
 
-exports.XrayConfigError = _chunkQ4MTHPULcjs.XrayConfigError; exports.createEmitter = _chunkQ4MTHPULcjs.createEmitter; exports.normalizeConfig = _chunkQ4MTHPULcjs.normalizeConfig;
+exports.XrayConfigError = _chunk3LDFK62Qcjs.XrayConfigError; exports.createEmitter = _chunk3LDFK62Qcjs.createEmitter; exports.normalizeConfig = _chunk3LDFK62Qcjs.normalizeConfig;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,7 +1,13 @@
-import { X as XrayConfig, a as XrayEmitter } from './types-Diy-KLjz.cjs';
-export { A as AttributeValue, e as CaptureConfig, C as CapturedBody, E as ExporterConfig, L as LogLevel, b as Logger, N as NormalizedRequest, c as NormalizedResponse, f as RedactionConfig, g as RequestIdConfig, R as RequestLog, h as ResolvedXrayConfig, i as RouteConfig, k as XrayConfigError, d as XrayContext, j as XrayRuntimeConfig, n as normalizeConfig } from './types-Diy-KLjz.cjs';
+import { X as XrayConfig, a as XrayEmitter } from './types-BrKvhHbn.cjs';
+export { A as AttributeValue, e as CaptureConfig, C as CapturedBody, E as ExporterConfig, L as LogLevel, b as Logger, N as NormalizedRequest, c as NormalizedResponse, f as RedactionConfig, g as RequestIdConfig, R as RequestLog, h as ResolvedXrayConfig, i as RouteConfig, k as XrayConfigError, d as XrayContext, j as XrayRuntimeConfig, n as normalizeConfig } from './types-BrKvhHbn.cjs';
 import { SpanExporter } from '@opentelemetry/sdk-trace-base';
 
+/**
+ * Create a runtime-agnostic X-ray emitter with a provided SpanExporter.
+ *
+ * Most applications should use a runtime adapter (`/node`, `/fetch`,
+ * or framework-specific entrypoints) unless they need custom transport logic.
+ */
 declare function createEmitter(config: XrayConfig, exporter: SpanExporter): XrayEmitter;
 
 export { XrayConfig, XrayEmitter, createEmitter };

package/dist/index.d.ts

@@ -1,7 +1,13 @@
-import { X as XrayConfig, a as XrayEmitter } from './types-Diy-KLjz.js';
-export { A as AttributeValue, e as CaptureConfig, C as CapturedBody, E as ExporterConfig, L as LogLevel, b as Logger, N as NormalizedRequest, c as NormalizedResponse, f as RedactionConfig, g as RequestIdConfig, R as RequestLog, h as ResolvedXrayConfig, i as RouteConfig, k as XrayConfigError, d as XrayContext, j as XrayRuntimeConfig, n as normalizeConfig } from './types-Diy-KLjz.js';
+import { X as XrayConfig, a as XrayEmitter } from './types-BrKvhHbn.js';
+export { A as AttributeValue, e as CaptureConfig, C as CapturedBody, E as ExporterConfig, L as LogLevel, b as Logger, N as NormalizedRequest, c as NormalizedResponse, f as RedactionConfig, g as RequestIdConfig, R as RequestLog, h as ResolvedXrayConfig, i as RouteConfig, k as XrayConfigError, d as XrayContext, j as XrayRuntimeConfig, n as normalizeConfig } from './types-BrKvhHbn.js';
 import { SpanExporter } from '@opentelemetry/sdk-trace-base';
 
+/**
+ * Create a runtime-agnostic X-ray emitter with a provided SpanExporter.
+ *
+ * Most applications should use a runtime adapter (`/node`, `/fetch`,
+ * or framework-specific entrypoints) unless they need custom transport logic.
+ */
 declare function createEmitter(config: XrayConfig, exporter: SpanExporter): XrayEmitter;
 
 export { XrayConfig, XrayEmitter, createEmitter };

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   XrayConfigError,
   createEmitter,
   normalizeConfig
-} from "./chunk-VRRPTE7W.js";
+} from "./chunk-DKHGODGO.js";
 import "./chunk-7KT6EPVZ.js";
 export {
   XrayConfigError,

package/dist/internal.d.cts

@@ -1,4 +1,4 @@
-import { C as CapturedBody, b as Logger, L as LogLevel, d as XrayContext, e as CaptureConfig, f as RedactionConfig } from './types-Diy-KLjz.cjs';
+import { C as CapturedBody, b as Logger, L as LogLevel, d as XrayContext, e as CaptureConfig, f as RedactionConfig } from './types-BrKvhHbn.cjs';
 import '@opentelemetry/sdk-trace-base';
 
 declare function makeCapturedBody(bytes: Uint8Array | undefined, totalBytes: number, truncated: boolean, mode: 'text' | 'base64'): CapturedBody | undefined;

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
-import { C as CapturedBody, b as Logger, L as LogLevel, d as XrayContext, e as CaptureConfig, f as RedactionConfig } from './types-Diy-KLjz.js';
+import { C as CapturedBody, b as Logger, L as LogLevel, d as XrayContext, e as CaptureConfig, f as RedactionConfig } from './types-BrKvhHbn.js';
 import '@opentelemetry/sdk-trace-base';
 
 declare function makeCapturedBody(bytes: Uint8Array | undefined, totalBytes: number, truncated: boolean, mode: 'text' | 'base64'): CapturedBody | undefined;

package/dist/next.cjs

@@ -2,14 +2,14 @@
 
 
 
-var _chunkESBHEKC2cjs = require('./chunk-ESBHEKC2.cjs');
-require('./chunk-Q4MTHPUL.cjs');
+var _chunk22W6MSR2cjs = require('./chunk-22W6MSR2.cjs');
+require('./chunk-3LDFK62Q.cjs');
 require('./chunk-CPHFCOA5.cjs');
 require('./chunk-DNBARLGB.cjs');
 
 // src/next/next.ts
 function createEmitter2(config, options) {
-  const emitter = _chunkESBHEKC2cjs.createEmitter.call(void 0, config);
+  const emitter = _chunk22W6MSR2cjs.createEmitter.call(void 0, config);
   const wrap = ((handler) => wrapNextRoute(handler, emitter, options));
   wrap.flush = emitter.flush;
   wrap.shutdown = emitter.shutdown;
@@ -17,7 +17,7 @@ function createEmitter2(config, options) {
 }
 function wrapNextRoute(handler, xray, options) {
   return async (request, context) => {
-    const wrapped = _chunkESBHEKC2cjs.wrapFetchPreserve.call(void 0, (req) => handler(req, context), xray, options);
+    const wrapped = _chunk22W6MSR2cjs.wrapFetchPreserve.call(void 0, (req) => handler(req, context), xray, options);
     return wrapped(request);
   };
 }
@@ -26,5 +26,5 @@ function wrapNextRoute(handler, xray, options) {
 
 
 
-exports.createCoreEmitter = _chunkESBHEKC2cjs.createEmitter; exports.createEmitter = createEmitter2; exports.getXrayContext = _chunkESBHEKC2cjs.getXrayContext; exports.wrapNextRoute = wrapNextRoute;
+exports.createCoreEmitter = _chunk22W6MSR2cjs.createEmitter; exports.createEmitter = createEmitter2; exports.getXrayContext = _chunk22W6MSR2cjs.getXrayContext; exports.wrapNextRoute = wrapNextRoute;
 //# sourceMappingURL=next.cjs.map

package/dist/next.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/xray-emitter-js/xray-emitter-js/dist/next.cjs","../src/next/next.ts"],"names":["createEmitter"],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACA;AC2BO,SAASA,cAAAA,CAAc,MAAA,EAA2B,OAAA,EAAoC;AAC3F,EAAA,MAAM,QAAA,EAAU,6CAAA,MAAyB,CAAA;AACzC,EAAA,MAAM,KAAA,EAAA,CAAQ,CAAC,OAAA,EAAA,GACb,aAAA,CAAc,OAAA,EAAS,OAAA,EAAS,OAAO,CAAA,CAAA;AACzC,EAAA,IAAA,CAAK,MAAA,EAAQ,OAAA,CAAQ,KAAA;AACrB,EAAA,IAAA,CAAK,SAAA,EAAW,OAAA,CAAQ,QAAA;AACxB,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,aAAA,CACd,OAAA,EACA,IAAA,EACA,OAAA,EACoE;AACpE,EAAA,OAAO,MAAA,CAAO,OAAA,EAAS,OAAA,EAAA,GAAY;AACjC,IAAA,MAAM,QAAA,EAAU,iDAAA,CAAmB,GAAA,EAAA,GAAiB,OAAA,CAAQ,GAAA,EAAK,OAAO,CAAA,EAAG,IAAA,EAAM,OAAO,CAAA;AACxF,IAAA,OAAO,OAAA,CAAQ,OAAO,CAAA;AAAA,EACxB,CAAA;AACF;AD/BA;AACE;AACA;AACA;AACA;AACF,sMAAC","file":"/home/runner/work/xray-emitter-js/xray-emitter-js/dist/next.cjs","sourcesContent":[null,"import type { XrayEmitter, XrayRuntimeConfig } from '../core/index';\nimport {\n  createEmitter as createFetchEmitter,\n  getXrayContext,\n  wrapFetchPreserve,\n  type WrapOptions,\n} from '../fetch/fetch';\n\nexport { createFetchEmitter as createCoreEmitter };\nexport type {\n  CaptureConfig,\n  RedactionConfig,\n  RequestLog,\n  XrayConfig,\n  XrayContext,\n  XrayEmitter,\n  XrayRuntimeConfig,\n} from '../core/index';\nexport type { WrapOptions } from '../fetch/fetch';\nexport { getXrayContext };\n\n// copy types from Next.js to avoid a package dependency\ntype NextRouteContext = {\n  params: Promise<Record<string, string | string[]>>;\n};\n\ntype NextRouteHandler = (\n  request: Request,\n  context: NextRouteContext,\n) => Response | Promise<Response>;\n\ntype NextEmitter = ((handler: NextRouteHandler) => ReturnType<typeof wrapNextRoute>) & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\nexport function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): NextEmitter {\n  const emitter = createFetchEmitter(config);\n  const wrap = ((handler: NextRouteHandler) =>\n    wrapNextRoute(handler, emitter, options)) as NextEmitter;\n  wrap.flush = emitter.flush;\n  wrap.shutdown = emitter.shutdown;\n  return wrap;\n}\n\nexport function wrapNextRoute(\n  handler: NextRouteHandler,\n  xray: XrayEmitter,\n  options?: WrapOptions,\n): (request: Request, context: NextRouteContext) => Promise<Response> {\n  return async (request, context) => {\n    const wrapped = wrapFetchPreserve((req: Request) => handler(req, context), xray, options);\n    return wrapped(request);\n  };\n}\n"]}
+{"version":3,"sources":["/home/runner/work/xray-emitter-js/xray-emitter-js/dist/next.cjs","../src/next/next.ts"],"names":["createEmitter"],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACA;AC8BO,SAASA,cAAAA,CAAc,MAAA,EAA2B,OAAA,EAAoC;AAC3F,EAAA,MAAM,QAAA,EAAU,6CAAA,MAAyB,CAAA;AACzC,EAAA,MAAM,KAAA,EAAA,CAAQ,CAAC,OAAA,EAAA,GACb,aAAA,CAAc,OAAA,EAAS,OAAA,EAAS,OAAO,CAAA,CAAA;AACzC,EAAA,IAAA,CAAK,MAAA,EAAQ,OAAA,CAAQ,KAAA;AACrB,EAAA,IAAA,CAAK,SAAA,EAAW,OAAA,CAAQ,QAAA;AACxB,EAAA,OAAO,IAAA;AACT;AAKO,SAAS,aAAA,CACd,OAAA,EACA,IAAA,EACA,OAAA,EACoE;AACpE,EAAA,OAAO,MAAA,CAAO,OAAA,EAAS,OAAA,EAAA,GAAY;AACjC,IAAA,MAAM,QAAA,EAAU,iDAAA,CAAmB,GAAA,EAAA,GAAiB,OAAA,CAAQ,GAAA,EAAK,OAAO,CAAA,EAAG,IAAA,EAAM,OAAO,CAAA;AACxF,IAAA,OAAO,OAAA,CAAQ,OAAO,CAAA;AAAA,EACxB,CAAA;AACF;ADrCA;AACE;AACA;AACA;AACA;AACF,sMAAC","file":"/home/runner/work/xray-emitter-js/xray-emitter-js/dist/next.cjs","sourcesContent":[null,"import type { XrayEmitter, XrayRuntimeConfig } from '../core/index';\nimport {\n  createEmitter as createFetchEmitter,\n  getXrayContext,\n  wrapFetchPreserve,\n  type WrapOptions,\n} from '../fetch/fetch';\n\nexport { createFetchEmitter as createCoreEmitter };\nexport type {\n  CaptureConfig,\n  RedactionConfig,\n  RequestLog,\n  XrayConfig,\n  XrayContext,\n  XrayEmitter,\n  XrayRuntimeConfig,\n} from '../core/index';\nexport type { WrapOptions } from '../fetch/fetch';\nexport { getXrayContext };\n\n// copy types from Next.js to avoid a package dependency\ntype NextRouteContext = {\n  params: Promise<Record<string, string | string[]>>;\n};\n\ntype NextRouteHandler = (\n  request: Request,\n  context: NextRouteContext,\n) => Response | Promise<Response>;\n\ntype NextEmitter = ((handler: NextRouteHandler) => ReturnType<typeof wrapNextRoute>) & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\n/**\n * Create a Next.js App Router wrapper and expose `flush()`/`shutdown()`.\n */\nexport function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): NextEmitter {\n  const emitter = createFetchEmitter(config);\n  const wrap = ((handler: NextRouteHandler) =>\n    wrapNextRoute(handler, emitter, options)) as NextEmitter;\n  wrap.flush = emitter.flush;\n  wrap.shutdown = emitter.shutdown;\n  return wrap;\n}\n\n/**\n * Wrap a Next.js route handler using an existing core `XrayEmitter`.\n */\nexport function wrapNextRoute(\n  handler: NextRouteHandler,\n  xray: XrayEmitter,\n  options?: WrapOptions,\n): (request: Request, context: NextRouteContext) => Promise<Response> {\n  return async (request, context) => {\n    const wrapped = wrapFetchPreserve((req: Request) => handler(req, context), xray, options);\n    return wrapped(request);\n  };\n}\n"]}

package/dist/next.d.cts

@@ -1,6 +1,6 @@
-import { j as XrayRuntimeConfig, a as XrayEmitter } from './types-Diy-KLjz.cjs';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig, d as XrayContext } from './types-Diy-KLjz.cjs';
-export { c as createCoreEmitter } from './emitter-Cdl6H6vk.cjs';
+import { j as XrayRuntimeConfig, a as XrayEmitter } from './types-BrKvhHbn.cjs';
+export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig, d as XrayContext } from './types-BrKvhHbn.cjs';
+export { c as createCoreEmitter } from './emitter-Bi_m_w5h.cjs';
 import { WrapOptions } from './fetch.cjs';
 export { getXrayContext } from './fetch.cjs';
 import '@opentelemetry/sdk-trace-base';
@@ -13,7 +13,13 @@ type NextEmitter = ((handler: NextRouteHandler) => ReturnType<typeof wrapNextRou
     flush: XrayEmitter['flush'];
     shutdown: XrayEmitter['shutdown'];
 };
+/**
+ * Create a Next.js App Router wrapper and expose `flush()`/`shutdown()`.
+ */
 declare function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): NextEmitter;
+/**
+ * Wrap a Next.js route handler using an existing core `XrayEmitter`.
+ */
 declare function wrapNextRoute(handler: NextRouteHandler, xray: XrayEmitter, options?: WrapOptions): (request: Request, context: NextRouteContext) => Promise<Response>;
 
 export { WrapOptions, XrayEmitter, XrayRuntimeConfig, createEmitter, wrapNextRoute };

package/dist/next.d.ts

@@ -1,6 +1,6 @@
-import { j as XrayRuntimeConfig, a as XrayEmitter } from './types-Diy-KLjz.js';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig, d as XrayContext } from './types-Diy-KLjz.js';
-export { c as createCoreEmitter } from './emitter-DnDvQw9i.js';
+import { j as XrayRuntimeConfig, a as XrayEmitter } from './types-BrKvhHbn.js';
+export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig, d as XrayContext } from './types-BrKvhHbn.js';
+export { c as createCoreEmitter } from './emitter-Dy7bRGTq.js';
 import { WrapOptions } from './fetch.js';
 export { getXrayContext } from './fetch.js';
 import '@opentelemetry/sdk-trace-base';
@@ -13,7 +13,13 @@ type NextEmitter = ((handler: NextRouteHandler) => ReturnType<typeof wrapNextRou
     flush: XrayEmitter['flush'];
     shutdown: XrayEmitter['shutdown'];
 };
+/**
+ * Create a Next.js App Router wrapper and expose `flush()`/`shutdown()`.
+ */
 declare function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): NextEmitter;
+/**
+ * Wrap a Next.js route handler using an existing core `XrayEmitter`.
+ */
 declare function wrapNextRoute(handler: NextRouteHandler, xray: XrayEmitter, options?: WrapOptions): (request: Request, context: NextRouteContext) => Promise<Response>;
 
 export { WrapOptions, XrayEmitter, XrayRuntimeConfig, createEmitter, wrapNextRoute };

package/dist/next.js

@@ -2,8 +2,8 @@ import {
   createEmitter,
   getXrayContext,
   wrapFetchPreserve
-} from "./chunk-W75UIHEF.js";
-import "./chunk-VRRPTE7W.js";
+} from "./chunk-LJYBYC7N.js";
+import "./chunk-DKHGODGO.js";
 import "./chunk-NTIUR3OC.js";
 import "./chunk-7KT6EPVZ.js";
 

package/dist/next.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/next/next.ts"],"sourcesContent":["import type { XrayEmitter, XrayRuntimeConfig } from '../core/index';\nimport {\n  createEmitter as createFetchEmitter,\n  getXrayContext,\n  wrapFetchPreserve,\n  type WrapOptions,\n} from '../fetch/fetch';\n\nexport { createFetchEmitter as createCoreEmitter };\nexport type {\n  CaptureConfig,\n  RedactionConfig,\n  RequestLog,\n  XrayConfig,\n  XrayContext,\n  XrayEmitter,\n  XrayRuntimeConfig,\n} from '../core/index';\nexport type { WrapOptions } from '../fetch/fetch';\nexport { getXrayContext };\n\n// copy types from Next.js to avoid a package dependency\ntype NextRouteContext = {\n  params: Promise<Record<string, string | string[]>>;\n};\n\ntype NextRouteHandler = (\n  request: Request,\n  context: NextRouteContext,\n) => Response | Promise<Response>;\n\ntype NextEmitter = ((handler: NextRouteHandler) => ReturnType<typeof wrapNextRoute>) & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\nexport function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): NextEmitter {\n  const emitter = createFetchEmitter(config);\n  const wrap = ((handler: NextRouteHandler) =>\n    wrapNextRoute(handler, emitter, options)) as NextEmitter;\n  wrap.flush = emitter.flush;\n  wrap.shutdown = emitter.shutdown;\n  return wrap;\n}\n\nexport function wrapNextRoute(\n  handler: NextRouteHandler,\n  xray: XrayEmitter,\n  options?: WrapOptions,\n): (request: Request, context: NextRouteContext) => Promise<Response> {\n  return async (request, context) => {\n    const wrapped = wrapFetchPreserve((req: Request) => handler(req, context), xray, options);\n    return wrapped(request);\n  };\n}\n"],"mappings":";;;;;;;;;;AAoCO,SAASA,eAAc,QAA2B,SAAoC;AAC3F,QAAM,UAAU,cAAmB,MAAM;AACzC,QAAM,QAAQ,CAAC,YACb,cAAc,SAAS,SAAS,OAAO;AACzC,OAAK,QAAQ,QAAQ;AACrB,OAAK,WAAW,QAAQ;AACxB,SAAO;AACT;AAEO,SAAS,cACd,SACA,MACA,SACoE;AACpE,SAAO,OAAO,SAAS,YAAY;AACjC,UAAM,UAAU,kBAAkB,CAAC,QAAiB,QAAQ,KAAK,OAAO,GAAG,MAAM,OAAO;AACxF,WAAO,QAAQ,OAAO;AAAA,EACxB;AACF;","names":["createEmitter"]}
+{"version":3,"sources":["../src/next/next.ts"],"sourcesContent":["import type { XrayEmitter, XrayRuntimeConfig } from '../core/index';\nimport {\n  createEmitter as createFetchEmitter,\n  getXrayContext,\n  wrapFetchPreserve,\n  type WrapOptions,\n} from '../fetch/fetch';\n\nexport { createFetchEmitter as createCoreEmitter };\nexport type {\n  CaptureConfig,\n  RedactionConfig,\n  RequestLog,\n  XrayConfig,\n  XrayContext,\n  XrayEmitter,\n  XrayRuntimeConfig,\n} from '../core/index';\nexport type { WrapOptions } from '../fetch/fetch';\nexport { getXrayContext };\n\n// copy types from Next.js to avoid a package dependency\ntype NextRouteContext = {\n  params: Promise<Record<string, string | string[]>>;\n};\n\ntype NextRouteHandler = (\n  request: Request,\n  context: NextRouteContext,\n) => Response | Promise<Response>;\n\ntype NextEmitter = ((handler: NextRouteHandler) => ReturnType<typeof wrapNextRoute>) & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\n/**\n * Create a Next.js App Router wrapper and expose `flush()`/`shutdown()`.\n */\nexport function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): NextEmitter {\n  const emitter = createFetchEmitter(config);\n  const wrap = ((handler: NextRouteHandler) =>\n    wrapNextRoute(handler, emitter, options)) as NextEmitter;\n  wrap.flush = emitter.flush;\n  wrap.shutdown = emitter.shutdown;\n  return wrap;\n}\n\n/**\n * Wrap a Next.js route handler using an existing core `XrayEmitter`.\n */\nexport function wrapNextRoute(\n  handler: NextRouteHandler,\n  xray: XrayEmitter,\n  options?: WrapOptions,\n): (request: Request, context: NextRouteContext) => Promise<Response> {\n  return async (request, context) => {\n    const wrapped = wrapFetchPreserve((req: Request) => handler(req, context), xray, options);\n    return wrapped(request);\n  };\n}\n"],"mappings":";;;;;;;;;;AAuCO,SAASA,eAAc,QAA2B,SAAoC;AAC3F,QAAM,UAAU,cAAmB,MAAM;AACzC,QAAM,QAAQ,CAAC,YACb,cAAc,SAAS,SAAS,OAAO;AACzC,OAAK,QAAQ,QAAQ;AACrB,OAAK,WAAW,QAAQ;AACxB,SAAO;AACT;AAKO,SAAS,cACd,SACA,MACA,SACoE;AACpE,SAAO,OAAO,SAAS,YAAY;AACjC,UAAM,UAAU,kBAAkB,CAAC,QAAiB,QAAQ,KAAK,OAAO,GAAG,MAAM,OAAO;AACxF,WAAO,QAAQ,OAAO;AAAA,EACxB;AACF;","names":["createEmitter"]}

package/dist/node.cjs

@@ -2,13 +2,13 @@
 
 
 
-var _chunkOCXEYDDHcjs = require('./chunk-OCXEYDDH.cjs');
-require('./chunk-Q4MTHPUL.cjs');
+var _chunkBVAENKYEcjs = require('./chunk-BVAENKYE.cjs');
+require('./chunk-3LDFK62Q.cjs');
 require('./chunk-CPHFCOA5.cjs');
 require('./chunk-DNBARLGB.cjs');
 
 
 
 
-exports.createEmitter = _chunkOCXEYDDHcjs.createEmitter; exports.getXrayContext = _chunkOCXEYDDHcjs.getXrayContext; exports.wrapHttpHandler = _chunkOCXEYDDHcjs.wrapHttpHandler;
+exports.createEmitter = _chunkBVAENKYEcjs.createEmitter; exports.getXrayContext = _chunkBVAENKYEcjs.getXrayContext; exports.wrapHttpHandler = _chunkBVAENKYEcjs.wrapHttpHandler;
 //# sourceMappingURL=node.cjs.map

package/dist/node.d.cts

@@ -1,20 +1,61 @@
-import { j as XrayRuntimeConfig, a as XrayEmitter, e as CaptureConfig, f as RedactionConfig, d as XrayContext, R as RequestLog } from './types-Diy-KLjz.cjs';
+import { j as XrayRuntimeConfig, a as XrayEmitter, e as CaptureConfig, f as RedactionConfig, d as XrayContext, R as RequestLog } from './types-BrKvhHbn.cjs';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import '@opentelemetry/sdk-trace-base';
 
+/**
+ * Create a Node runtime emitter using OTLP HTTP transport by default.
+ *
+ * Pass `config.exporter.instance` to provide a custom `SpanExporter`.
+ */
 declare function createEmitter(config: XrayRuntimeConfig): XrayEmitter;
 
+/**
+ * Handler signature for `node:http` request listeners.
+ */
 type NodeHttpHandler = (req: IncomingMessage, res: ServerResponse) => void | Promise<void>;
+/**
+ * Per-handler overrides for `wrapHttpHandler`.
+ */
 interface WrapOptions {
+    /**
+     * Explicit route pattern for this handler (for example `/users/:id`).
+     */
     route?: string;
+    /**
+     * Explicit request ID. Skips header lookup/generation when provided.
+     */
     requestId?: string;
+    /**
+     * Per-handler capture overrides.
+     */
     capture?: Partial<CaptureConfig>;
+    /**
+     * Per-handler redaction overrides.
+     */
     redaction?: Partial<RedactionConfig>;
+    /**
+     * Hook called after request context is created.
+     */
     onRequest?: (ctx: XrayContext) => void;
+    /**
+     * Hook called after the request has been finalized and logged.
+     */
     onResponse?: (ctx: XrayContext, log: RequestLog) => void;
+    /**
+     * Hook called when request handling fails.
+     */
     onError?: (ctx: XrayContext, err: unknown) => void;
 }
+/**
+ * Wrap a `node:http` request handler with X-ray instrumentation.
+ *
+ * The wrapper binds `XrayContext` to both `req` and `res`, captures configured
+ * request/response metadata, and ensures a response request ID header is set.
+ */
 declare function wrapHttpHandler(handler: NodeHttpHandler, xray: XrayEmitter, options?: WrapOptions): NodeHttpHandler;
+/**
+ * Retrieve the `XrayContext` bound to a Node `IncomingMessage`.
+ */
 declare function getXrayContext(req: IncomingMessage): XrayContext | undefined;
 
 export { type NodeHttpHandler, type WrapOptions, createEmitter, getXrayContext, wrapHttpHandler };