@stainlessdev/xray-emitter 0.1.0-dev.2c5bc4c → 0.1.0-dev.7eabc37

package/dist/hono.d.ts

@@ -1,6 +1,6 @@
-import { d as XrayContext, j as XrayRuntimeConfig, a as XrayEmitter } from './types-Z1nirh-F.js';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig } from './types-Z1nirh-F.js';
-export { c as createCoreEmitter } from './emitter-CScYhwGA.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,12 +2,12 @@ import {
   createEmitter,
   getXrayContext,
   wrapFetchPreserve
-} from "./chunk-ZP5OEA4I.js";
-import "./chunk-TSCMZ5TV.js";
+} from "./chunk-LJYBYC7N.js";
+import "./chunk-DKHGODGO.js";
 import {
   setContextRoute
-} from "./chunk-6UH43LVD.js";
-import "./chunk-YVMMCTXW.js";
+} from "./chunk-NTIUR3OC.js";
+import "./chunk-7KT6EPVZ.js";
 
 // src/hono/hono.ts
 function createEmitter2(config, options) {

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 _chunkXO6YWDFLcjs = require('./chunk-XO6YWDFL.cjs');
-require('./chunk-JKW6E4L3.cjs');
+var _chunk3LDFK62Qcjs = require('./chunk-3LDFK62Q.cjs');
+require('./chunk-DNBARLGB.cjs');
 
 
 
 
-exports.XrayConfigError = _chunkXO6YWDFLcjs.XrayConfigError; exports.createEmitter = _chunkXO6YWDFLcjs.createEmitter; exports.normalizeConfig = _chunkXO6YWDFLcjs.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-Z1nirh-F.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-Z1nirh-F.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-Z1nirh-F.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-Z1nirh-F.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,8 +2,8 @@ import {
   XrayConfigError,
   createEmitter,
   normalizeConfig
-} from "./chunk-TSCMZ5TV.js";
-import "./chunk-YVMMCTXW.js";
+} from "./chunk-DKHGODGO.js";
+import "./chunk-7KT6EPVZ.js";
 export {
   XrayConfigError,
   createEmitter,

package/dist/internal.cjs

@@ -12,7 +12,7 @@
 
 
 
-var _chunkGNSXLLECcjs = require('./chunk-GNSXLLEC.cjs');
+var _chunkCPHFCOA5cjs = require('./chunk-CPHFCOA5.cjs');
 
 
 
@@ -20,7 +20,7 @@ var _chunkGNSXLLECcjs = require('./chunk-GNSXLLEC.cjs');
 
 
 
-var _chunkJKW6E4L3cjs = require('./chunk-JKW6E4L3.cjs');
+var _chunkDNBARLGBcjs = require('./chunk-DNBARLGB.cjs');
 
 
 
@@ -41,5 +41,5 @@ var _chunkJKW6E4L3cjs = require('./chunk-JKW6E4L3.cjs');
 
 
 
-exports.LimitedBuffer = _chunkGNSXLLECcjs.LimitedBuffer; exports.bindContextToObject = _chunkGNSXLLECcjs.bindContextToObject; exports.generateRequestId = _chunkJKW6E4L3cjs.generateRequestId; exports.getXrayContextFromObject = _chunkGNSXLLECcjs.getXrayContextFromObject; exports.headerTokenList = _chunkGNSXLLECcjs.headerTokenList; exports.headerValuesFromFetchHeaders = _chunkGNSXLLECcjs.headerValuesFromFetchHeaders; exports.headerValuesFromFetchHeadersWithLimit = _chunkGNSXLLECcjs.headerValuesFromFetchHeadersWithLimit; exports.headerValuesFromNodeHeaders = _chunkGNSXLLECcjs.headerValuesFromNodeHeaders; exports.isWebsocketUpgrade = _chunkGNSXLLECcjs.isWebsocketUpgrade; exports.isWebsocketUpgradeFetch = _chunkGNSXLLECcjs.isWebsocketUpgradeFetch; exports.logWithLevel = _chunkJKW6E4L3cjs.logWithLevel; exports.makeCapturedBody = _chunkJKW6E4L3cjs.makeCapturedBody; exports.setCaptureOverride = _chunkGNSXLLECcjs.setCaptureOverride; exports.setContextRequestId = _chunkGNSXLLECcjs.setContextRequestId; exports.setContextRoute = _chunkGNSXLLECcjs.setContextRoute; exports.setRedactionOverride = _chunkGNSXLLECcjs.setRedactionOverride; exports.uuidv7 = _chunkJKW6E4L3cjs.uuidv7; exports.uuidv7base48 = _chunkJKW6E4L3cjs.uuidv7base48; exports.uuidv7base62 = _chunkJKW6E4L3cjs.uuidv7base62;
+exports.LimitedBuffer = _chunkCPHFCOA5cjs.LimitedBuffer; exports.bindContextToObject = _chunkCPHFCOA5cjs.bindContextToObject; exports.generateRequestId = _chunkDNBARLGBcjs.generateRequestId; exports.getXrayContextFromObject = _chunkCPHFCOA5cjs.getXrayContextFromObject; exports.headerTokenList = _chunkCPHFCOA5cjs.headerTokenList; exports.headerValuesFromFetchHeaders = _chunkCPHFCOA5cjs.headerValuesFromFetchHeaders; exports.headerValuesFromFetchHeadersWithLimit = _chunkCPHFCOA5cjs.headerValuesFromFetchHeadersWithLimit; exports.headerValuesFromNodeHeaders = _chunkCPHFCOA5cjs.headerValuesFromNodeHeaders; exports.isWebsocketUpgrade = _chunkCPHFCOA5cjs.isWebsocketUpgrade; exports.isWebsocketUpgradeFetch = _chunkCPHFCOA5cjs.isWebsocketUpgradeFetch; exports.logWithLevel = _chunkDNBARLGBcjs.logWithLevel; exports.makeCapturedBody = _chunkDNBARLGBcjs.makeCapturedBody; exports.setCaptureOverride = _chunkCPHFCOA5cjs.setCaptureOverride; exports.setContextRequestId = _chunkCPHFCOA5cjs.setContextRequestId; exports.setContextRoute = _chunkCPHFCOA5cjs.setContextRoute; exports.setRedactionOverride = _chunkCPHFCOA5cjs.setRedactionOverride; exports.uuidv7 = _chunkDNBARLGBcjs.uuidv7; exports.uuidv7base48 = _chunkDNBARLGBcjs.uuidv7base48; exports.uuidv7base62 = _chunkDNBARLGBcjs.uuidv7base62;
 //# sourceMappingURL=internal.cjs.map

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-Z1nirh-F.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-Z1nirh-F.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/internal.js

@@ -12,7 +12,7 @@ import {
   setContextRequestId,
   setContextRoute,
   setRedactionOverride
-} from "./chunk-6UH43LVD.js";
+} from "./chunk-NTIUR3OC.js";
 import {
   generateRequestId,
   logWithLevel,
@@ -20,7 +20,7 @@ import {
   uuidv7,
   uuidv7base48,
   uuidv7base62
-} from "./chunk-YVMMCTXW.js";
+} from "./chunk-7KT6EPVZ.js";
 export {
   LimitedBuffer,
   bindContextToObject,

package/dist/next.cjs

@@ -2,14 +2,14 @@
 
 
 
-var _chunkDBI3HXNRcjs = require('./chunk-DBI3HXNR.cjs');
-require('./chunk-XO6YWDFL.cjs');
-require('./chunk-GNSXLLEC.cjs');
-require('./chunk-JKW6E4L3.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 = _chunkDBI3HXNRcjs.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 = _chunkDBI3HXNRcjs.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 = _chunkDBI3HXNRcjs.createEmitter; exports.createEmitter = createEmitter2; exports.getXrayContext = _chunkDBI3HXNRcjs.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-Z1nirh-F.cjs';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig, d as XrayContext } from './types-Z1nirh-F.cjs';
-export { c as createCoreEmitter } from './emitter-BqfrGIod.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-Z1nirh-F.js';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig, d as XrayContext } from './types-Z1nirh-F.js';
-export { c as createCoreEmitter } from './emitter-CScYhwGA.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,10 +2,10 @@ import {
   createEmitter,
   getXrayContext,
   wrapFetchPreserve
-} from "./chunk-ZP5OEA4I.js";
-import "./chunk-TSCMZ5TV.js";
-import "./chunk-6UH43LVD.js";
-import "./chunk-YVMMCTXW.js";
+} from "./chunk-LJYBYC7N.js";
+import "./chunk-DKHGODGO.js";
+import "./chunk-NTIUR3OC.js";
+import "./chunk-7KT6EPVZ.js";
 
 // src/next/next.ts
 function createEmitter2(config, options) {

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 _chunk2HW4AEKBcjs = require('./chunk-2HW4AEKB.cjs');
-require('./chunk-XO6YWDFL.cjs');
-require('./chunk-GNSXLLEC.cjs');
-require('./chunk-JKW6E4L3.cjs');
+var _chunkBVAENKYEcjs = require('./chunk-BVAENKYE.cjs');
+require('./chunk-3LDFK62Q.cjs');
+require('./chunk-CPHFCOA5.cjs');
+require('./chunk-DNBARLGB.cjs');
 
 
 
 
-exports.createEmitter = _chunk2HW4AEKBcjs.createEmitter; exports.getXrayContext = _chunk2HW4AEKBcjs.getXrayContext; exports.wrapHttpHandler = _chunk2HW4AEKBcjs.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-Z1nirh-F.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 };

package/dist/node.d.ts

@@ -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-Z1nirh-F.js';
+import { j as XrayRuntimeConfig, a as XrayEmitter, e as CaptureConfig, f as RedactionConfig, d as XrayContext, R as RequestLog } from './types-BrKvhHbn.js';
 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 };

package/dist/node.js

@@ -2,10 +2,10 @@ import {
   createEmitter,
   getXrayContext,
   wrapHttpHandler
-} from "./chunk-WTHVUHGI.js";
-import "./chunk-TSCMZ5TV.js";
-import "./chunk-6UH43LVD.js";
-import "./chunk-YVMMCTXW.js";
+} from "./chunk-ZCC372UX.js";
+import "./chunk-DKHGODGO.js";
+import "./chunk-NTIUR3OC.js";
+import "./chunk-7KT6EPVZ.js";
 export {
   createEmitter,
   getXrayContext,

package/dist/remix.cjs

@@ -2,14 +2,14 @@
 
 
 
-var _chunkDBI3HXNRcjs = require('./chunk-DBI3HXNR.cjs');
-require('./chunk-XO6YWDFL.cjs');
-require('./chunk-GNSXLLEC.cjs');
-require('./chunk-JKW6E4L3.cjs');
+var _chunk22W6MSR2cjs = require('./chunk-22W6MSR2.cjs');
+require('./chunk-3LDFK62Q.cjs');
+require('./chunk-CPHFCOA5.cjs');
+require('./chunk-DNBARLGB.cjs');
 
 // src/remix/remix.ts
 function createEmitter2(config, options) {
-  const emitter = _chunkDBI3HXNRcjs.createEmitter.call(void 0, config);
+  const emitter = _chunk22W6MSR2cjs.createEmitter.call(void 0, config);
   const wrap = ((handler) => wrapRemixRequestHandler(handler, emitter, options));
   wrap.flush = emitter.flush;
   wrap.shutdown = emitter.shutdown;
@@ -17,7 +17,7 @@ function createEmitter2(config, options) {
 }
 function wrapRemixRequestHandler(handler, xray, options) {
   return (request, loadContext) => {
-    const wrapped = _chunkDBI3HXNRcjs.wrapFetchPreserve.call(void 0, (req) => handler(req, loadContext), xray, options);
+    const wrapped = _chunk22W6MSR2cjs.wrapFetchPreserve.call(void 0, (req) => handler(req, loadContext), xray, options);
     return wrapped(request);
   };
 }
@@ -26,5 +26,5 @@ function wrapRemixRequestHandler(handler, xray, options) {
 
 
 
-exports.createCoreEmitter = _chunkDBI3HXNRcjs.createEmitter; exports.createEmitter = createEmitter2; exports.getXrayContext = _chunkDBI3HXNRcjs.getXrayContext; exports.wrapRemixRequestHandler = wrapRemixRequestHandler;
+exports.createCoreEmitter = _chunk22W6MSR2cjs.createEmitter; exports.createEmitter = createEmitter2; exports.getXrayContext = _chunk22W6MSR2cjs.getXrayContext; exports.wrapRemixRequestHandler = wrapRemixRequestHandler;
 //# sourceMappingURL=remix.cjs.map

package/dist/remix.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/xray-emitter-js/xray-emitter-js/dist/remix.cjs","../src/remix/remix.ts"],"names":["createEmitter"],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACA;ACoBO,SAASA,cAAAA,CAAc,MAAA,EAA2B,OAAA,EAAqC;AAC5F,EAAA,MAAM,QAAA,EAAU,6CAAA,MAAyB,CAAA;AACzC,EAAA,MAAM,KAAA,EAAA,CAAQ,CAAC,OAAA,EAAA,GACb,uBAAA,CAAwB,OAAA,EAAS,OAAA,EAAS,OAAO,CAAA,CAAA;AACnD,EAAA,IAAA,CAAK,MAAA,EAAQ,OAAA,CAAQ,KAAA;AACrB,EAAA,IAAA,CAAK,SAAA,EAAW,OAAA,CAAQ,QAAA;AACxB,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,uBAAA,CACd,OAAA,EACA,IAAA,EACA,OAAA,EACgB;AAChB,EAAA,OAAO,CAAC,OAAA,EAAS,WAAA,EAAA,GAAgB;AAC/B,IAAA,MAAM,QAAA,EAAU,iDAAA,CAAmB,GAAA,EAAA,GAAiB,OAAA,CAAQ,GAAA,EAAK,WAAW,CAAA,EAAG,IAAA,EAAM,OAAO,CAAA;AAC5F,IAAA,OAAO,OAAA,CAAQ,OAAO,CAAA;AAAA,EACxB,CAAA;AACF;ADxBA;AACE;AACA;AACA;AACA;AACF,0NAAC","file":"/home/runner/work/xray-emitter-js/xray-emitter-js/dist/remix.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 type from react-router to avoid a package dependency\ntype RequestHandler = (request: Request, loadContext?: unknown) => Response | Promise<Response>;\n\ntype RemixEmitter = ((handler: RequestHandler) => RequestHandler) & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\nexport function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): RemixEmitter {\n  const emitter = createFetchEmitter(config);\n  const wrap = ((handler: RequestHandler) =>\n    wrapRemixRequestHandler(handler, emitter, options)) as RemixEmitter;\n  wrap.flush = emitter.flush;\n  wrap.shutdown = emitter.shutdown;\n  return wrap;\n}\n\nexport function wrapRemixRequestHandler(\n  handler: RequestHandler,\n  xray: XrayEmitter,\n  options?: WrapOptions,\n): RequestHandler {\n  return (request, loadContext) => {\n    const wrapped = wrapFetchPreserve((req: Request) => handler(req, loadContext), xray, options);\n    return wrapped(request);\n  };\n}\n"]}
+{"version":3,"sources":["/home/runner/work/xray-emitter-js/xray-emitter-js/dist/remix.cjs","../src/remix/remix.ts"],"names":["createEmitter"],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B,gCAA6B;AAC7B;AACA;ACwBO,SAASA,cAAAA,CAAc,MAAA,EAA2B,OAAA,EAAqC;AAC5F,EAAA,MAAM,QAAA,EAAU,6CAAA,MAAyB,CAAA;AACzC,EAAA,MAAM,KAAA,EAAA,CAAQ,CAAC,OAAA,EAAA,GACb,uBAAA,CAAwB,OAAA,EAAS,OAAA,EAAS,OAAO,CAAA,CAAA;AACnD,EAAA,IAAA,CAAK,MAAA,EAAQ,OAAA,CAAQ,KAAA;AACrB,EAAA,IAAA,CAAK,SAAA,EAAW,OAAA,CAAQ,QAAA;AACxB,EAAA,OAAO,IAAA;AACT;AAKO,SAAS,uBAAA,CACd,OAAA,EACA,IAAA,EACA,OAAA,EACgB;AAChB,EAAA,OAAO,CAAC,OAAA,EAAS,WAAA,EAAA,GAAgB;AAC/B,IAAA,MAAM,QAAA,EAAU,iDAAA,CAAmB,GAAA,EAAA,GAAiB,OAAA,CAAQ,GAAA,EAAK,WAAW,CAAA,EAAG,IAAA,EAAM,OAAO,CAAA;AAC5F,IAAA,OAAO,OAAA,CAAQ,OAAO,CAAA;AAAA,EACxB,CAAA;AACF;AD/BA;AACE;AACA;AACA;AACA;AACF,0NAAC","file":"/home/runner/work/xray-emitter-js/xray-emitter-js/dist/remix.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 type from react-router to avoid a package dependency\ntype RequestHandler = (request: Request, loadContext?: unknown) => Response | Promise<Response>;\n\ntype RemixEmitter = ((handler: RequestHandler) => RequestHandler) & {\n  flush: XrayEmitter['flush'];\n  shutdown: XrayEmitter['shutdown'];\n};\n\n/**\n * Create a Remix/React Router request-handler wrapper and expose\n * `flush()`/`shutdown()`.\n */\nexport function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): RemixEmitter {\n  const emitter = createFetchEmitter(config);\n  const wrap = ((handler: RequestHandler) =>\n    wrapRemixRequestHandler(handler, emitter, options)) as RemixEmitter;\n  wrap.flush = emitter.flush;\n  wrap.shutdown = emitter.shutdown;\n  return wrap;\n}\n\n/**\n * Wrap a Remix request handler using an existing core `XrayEmitter`.\n */\nexport function wrapRemixRequestHandler(\n  handler: RequestHandler,\n  xray: XrayEmitter,\n  options?: WrapOptions,\n): RequestHandler {\n  return (request, loadContext) => {\n    const wrapped = wrapFetchPreserve((req: Request) => handler(req, loadContext), xray, options);\n    return wrapped(request);\n  };\n}\n"]}

package/dist/remix.d.cts

@@ -1,6 +1,6 @@
-import { j as XrayRuntimeConfig, a as XrayEmitter } from './types-Z1nirh-F.cjs';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig, d as XrayContext } from './types-Z1nirh-F.cjs';
-export { c as createCoreEmitter } from './emitter-BqfrGIod.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';
@@ -10,7 +10,14 @@ type RemixEmitter = ((handler: RequestHandler) => RequestHandler) & {
     flush: XrayEmitter['flush'];
     shutdown: XrayEmitter['shutdown'];
 };
+/**
+ * Create a Remix/React Router request-handler wrapper and expose
+ * `flush()`/`shutdown()`.
+ */
 declare function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): RemixEmitter;
+/**
+ * Wrap a Remix request handler using an existing core `XrayEmitter`.
+ */
 declare function wrapRemixRequestHandler(handler: RequestHandler, xray: XrayEmitter, options?: WrapOptions): RequestHandler;
 
 export { WrapOptions, XrayEmitter, XrayRuntimeConfig, createEmitter, wrapRemixRequestHandler };

package/dist/remix.d.ts

@@ -1,6 +1,6 @@
-import { j as XrayRuntimeConfig, a as XrayEmitter } from './types-Z1nirh-F.js';
-export { e as CaptureConfig, f as RedactionConfig, R as RequestLog, X as XrayConfig, d as XrayContext } from './types-Z1nirh-F.js';
-export { c as createCoreEmitter } from './emitter-CScYhwGA.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';
@@ -10,7 +10,14 @@ type RemixEmitter = ((handler: RequestHandler) => RequestHandler) & {
     flush: XrayEmitter['flush'];
     shutdown: XrayEmitter['shutdown'];
 };
+/**
+ * Create a Remix/React Router request-handler wrapper and expose
+ * `flush()`/`shutdown()`.
+ */
 declare function createEmitter(config: XrayRuntimeConfig, options?: WrapOptions): RemixEmitter;
+/**
+ * Wrap a Remix request handler using an existing core `XrayEmitter`.
+ */
 declare function wrapRemixRequestHandler(handler: RequestHandler, xray: XrayEmitter, options?: WrapOptions): RequestHandler;
 
 export { WrapOptions, XrayEmitter, XrayRuntimeConfig, createEmitter, wrapRemixRequestHandler };

package/dist/remix.js

@@ -2,10 +2,10 @@ import {
   createEmitter,
   getXrayContext,
   wrapFetchPreserve
-} from "./chunk-ZP5OEA4I.js";
-import "./chunk-TSCMZ5TV.js";
-import "./chunk-6UH43LVD.js";
-import "./chunk-YVMMCTXW.js";
+} from "./chunk-LJYBYC7N.js";
+import "./chunk-DKHGODGO.js";
+import "./chunk-NTIUR3OC.js";
+import "./chunk-7KT6EPVZ.js";
 
 // src/remix/remix.ts
 function createEmitter2(config, options) {