autotel-cloudflare 2.19.0 → 3.0.0

package/README.md

@@ -8,6 +8,7 @@
 
 ## Features
 
+- ✅ **Cloudflare native tracing (automatic)** - `trace()`/`span()` nest inside Cloudflare's native trace waterfall when enabled; no duplicate spans, no exporter code
 - ✅ **Native Cloudflare OTel integration** - Works with `wrangler.toml` destinations
 - ✅ **Complete bindings coverage** - KV, R2, D1, DO, AI, Vectorize, Hyperdrive, and more
 - ✅ **Multiple API styles** - `instrument()`, `wrapModule()`, `wrapDurableObject()`, functional
@@ -27,6 +28,46 @@ The package direction is to make Cloudflare observability feel the same across W
 
 See [docs/CLOUDFLARE-DX.md](../../docs/CLOUDFLARE-DX.md) for the design target and review rules.
 
+## Cloudflare native tracing (automatic)
+
+Cloudflare Workers ship [native tracing](https://developers.cloudflare.com/workers/observability/traces/): enable it in Wrangler and Cloudflare instruments fetch/KV/R2/D1/handlers and exports OTLP to any backend — no exporter code. autotel integrates **automatically**: the same `trace()`/`span()`/`enterSpan()` code nests inside Cloudflare's native waterfall when native tracing is on, and falls back to autotel's own OTLP pipeline everywhere else (other edge runtimes, native off, local `wrangler dev`).
+
+```toml
+# wrangler.toml — that's the only setup
+[observability.traces]
+enabled = true
+```
+
+When native tracing is active, autotel **defers to the platform**: it does not proxy-instrument bindings (no duplicate spans) and does not run its own exporter. It routes your custom spans to `tracing.enterSpan()` and surfaces the `cf-ray` id as `ctx.correlationId` + a `correlation.id` span attribute. Controlled by `nativeTracing: 'auto' | 'on' | 'off'` (default `'auto'`).
+
+### Same code, both modes — captured evidence
+
+This is real output from [`apps/cloudflare-example`](../../apps/cloudflare-example) (`node scripts/capture-evidence.mjs`). Identical business logic, two runtimes:
+
+```text
+# autotel OTLP pipeline (local dev / non-Workers / nativeTracing:'off')
+• GET /orders
+  • order.price            order.id=ORD-1 order.total=120
+    • order.subtotal       order.subtotal=100
+      • KV MY_KV: get       db.system=cloudflare-kv db.operation=get   ← autotel-instrumented
+    • order.total          order.total=120
+  • user.create            user.duplicate=true
+    • db.checkDuplicate
+  • payment.charge [ERROR]  exception.message="card declined"
+
+# Cloudflare native tracing (autotel → ctx.tracing.enterSpan)
+• order.price [OK]       correlation.id=8f1c2d3e…-LHR  order.id=ORD-1 order.total=120
+  • order.subtotal       correlation.id=8f1c2d3e…-LHR  order.subtotal=100
+  • order.total          correlation.id=8f1c2d3e…-LHR  order.total=120
+• user.create            correlation.id=8f1c2d3e…-LHR  user.duplicate=true
+  • db.checkDuplicate
+• payment.charge [ERROR] error=true exception.message="card declined"  correlation.id=8f1c2d3e…-LHR
+```
+
+Note the native tree has **no `KV MY_KV: get` span** — Cloudflare emits that natively (your custom spans nest above it on deploy), so there are no duplicates.
+
+Full details, degradation map, and the forward-compatible trace-id story: [docs/CLOUDFLARE-NATIVE-TRACING.md](../../docs/CLOUDFLARE-NATIVE-TRACING.md).
+
 ## Installation
 
 ```bash

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import { a as instrumentQueueProducer, c as instrumentAI, d as instrumentKV, f as instrumentR2, i as instrumentAnalyticsEngine, l as instrumentBindings, n as instrumentRateLimiter, o as instrumentHyperdrive, p as instrumentServiceBinding, r as instrumentImages, s as instrumentVectorize, t as instrumentBrowserRendering, u as instrumentD1 } from "./bindings-xEZcXo5r.js";
 import { n as instrumentDO, t as instrumentWorkflow } from "./handlers-C_VojUeA.js";
 import { a as createWorkersLogger, c as getRequestLogger, i as WorkersLoggerOptions, l as getWorkflowLogger, n as ExecutionLogger, o as getActorLogger, r as ExecutionLoggerOptions, s as getQueueLogger, t as ExecutionLogSnapshot } from "./execution-logger-tgQmJeeU.js";
+import { n as isNativeTracingAvailable, t as getNativeTracerFromCtx } from "./native-tracing-DSo5mody.js";
 import { ConfigurationOption } from "autotel-edge";
 export * from "autotel-edge";
 
@@ -102,5 +103,5 @@ declare function instrumentGlobalFetch(): void;
  */
 declare function instrumentGlobalCache(): void;
 //#endregion
-export { type DefineWorkerFetchOptions, type ExecutionLogSnapshot, type ExecutionLogger, type ExecutionLoggerOptions, type WorkerFetchHandler, type WorkersLoggerOptions, createWorkersLogger, defineWorkerFetch, getActorLogger, getQueueLogger, getRequestLogger, getWorkflowLogger, instrument, instrumentAI, instrumentAnalyticsEngine, instrumentBindings, instrumentBrowserRendering, instrumentD1, instrumentDO, instrumentGlobalCache, instrumentGlobalFetch, instrumentHyperdrive, instrumentImages, instrumentKV, instrumentQueueProducer, instrumentR2, instrumentRateLimiter, instrumentServiceBinding, instrumentVectorize, instrumentWorkflow, wrapDurableObject, wrapModule };
+export { type DefineWorkerFetchOptions, type ExecutionLogSnapshot, type ExecutionLogger, type ExecutionLoggerOptions, type WorkerFetchHandler, type WorkersLoggerOptions, createWorkersLogger, defineWorkerFetch, getActorLogger, getNativeTracerFromCtx, getQueueLogger, getRequestLogger, getWorkflowLogger, instrument, instrumentAI, instrumentAnalyticsEngine, instrumentBindings, instrumentBrowserRendering, instrumentD1, instrumentDO, instrumentGlobalCache, instrumentGlobalFetch, instrumentHyperdrive, instrumentImages, instrumentKV, instrumentQueueProducer, instrumentR2, instrumentRateLimiter, instrumentServiceBinding, instrumentVectorize, instrumentWorkflow, isNativeTracingAvailable, wrapDurableObject, wrapModule };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/wrappers/instrument.ts","../src/wrappers/wrap-module.ts","../src/wrappers/wrap-do.ts","../src/wrappers/define-worker-fetch.ts","../src/global/fetch.ts","../src/global/cache.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA0qB0B;;;;AC3oB1B;iBDwoBgB,UAAA,sBACd,OAAA,EAAS,eAAA,CAAgB,CAAA,EAAG,CAAA,EAAG,CAAA,GAC/B,MAAA,EAAQ,mBAAA,GACP,eAAA,CAAgB,CAAA,EAAG,CAAA,EAAG,CAAA;;;;;;;;;;;iBC3oBT,UAAA,sBACd,MAAA,EAAQ,mBAAA,EACR,OAAA,EAAS,eAAA,CAAgB,CAAA,EAAG,CAAA,EAAG,CAAA,IAC9B,eAAA,CAAgB,CAAA,EAAG,CAAA,EAAG,CAAA;;;;;;;;;;;iBCNT,iBAAA,WAA4B,aAAA,EAC1C,MAAA,EAAQ,mBAAA,EACR,OAAA,OAAc,KAAA,EAAO,kBAAA,EAAoB,GAAA,UAAa,CAAA,QAChD,KAAA,EAAO,kBAAA,EAAoB,GAAA,UAAa,CAAA;;;KCDpC,wBAAA,GAA2B,oBAAoB;AAAA,KAE/C,kBAAA,OACV,OAAA,EAAS,OAAA,EACT,GAAA,EAAK,CAAA,EACL,GAAA,EAAK,gBAAA,EACL,GAAA,EAAK,eAAA,KACF,QAAA,GAAW,OAAA,CAAQ,QAAA;;;;;;iBAOR,iBAAA,cACd,MAAA,EAAQ,mBAAA,EACR,OAAA,EAAS,kBAAA,CAAmB,CAAA,GAC5B,aAAA,GAAe,wBAAA;EACZ,KAAA,GAAQ,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,CAAA,EAAG,GAAA,EAAK,gBAAA,KAAqB,OAAA,CAAQ,QAAA;AAAA;;;;;;;;;;;AHunBzE;;;;;;;;;iBI9mBgB,qBAAA;;;;;;;;;;;AJ8mBhB;;;;;;;;AAAA,iBKzhBgB,qBAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/wrappers/instrument.ts","../src/wrappers/wrap-module.ts","../src/wrappers/wrap-do.ts","../src/wrappers/define-worker-fetch.ts","../src/global/fetch.ts","../src/global/cache.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAwvB0B;;;;iBAHV,UAAA,sBACd,OAAA,EAAS,eAAA,CAAgB,CAAA,EAAG,CAAA,EAAG,CAAA,GAC/B,MAAA,EAAQ,mBAAA,GACP,eAAA,CAAgB,CAAA,EAAG,CAAA,EAAG,CAAA;;;;;;;;;;;iBCztBT,UAAA,sBACd,MAAA,EAAQ,mBAAA,EACR,OAAA,EAAS,eAAA,CAAgB,CAAA,EAAG,CAAA,EAAG,CAAA,IAC9B,eAAA,CAAgB,CAAA,EAAG,CAAA,EAAG,CAAA;;;;;;;;;;;iBCNT,iBAAA,WAA4B,aAAA,EAC1C,MAAA,EAAQ,mBAAA,EACR,OAAA,OAAc,KAAA,EAAO,kBAAA,EAAoB,GAAA,UAAa,CAAA,QAChD,KAAA,EAAO,kBAAA,EAAoB,GAAA,UAAa,CAAA;;;KCDpC,wBAAA,GAA2B,oBAAoB;AAAA,KAE/C,kBAAA,OACV,OAAA,EAAS,OAAA,EACT,GAAA,EAAK,CAAA,EACL,GAAA,EAAK,gBAAA,EACL,GAAA,EAAK,eAAA,KACF,QAAA,GAAW,OAAA,CAAQ,QAAA;;;;;;iBAOR,iBAAA,cACd,MAAA,EAAQ,mBAAA,EACR,OAAA,EAAS,kBAAA,CAAmB,CAAA,GAC5B,aAAA,GAAe,wBAAA;EACZ,KAAA,GAAQ,OAAA,EAAS,OAAA,EAAS,GAAA,EAAK,CAAA,EAAG,GAAA,EAAK,gBAAA,KAAqB,OAAA,CAAQ,QAAA;AAAA;;;;;;;;;;;;AHqsBzE;;;;;;;;AAAA,iBI5rBgB,qBAAA;;;;;;;;;;;;AJ4rBhB;;;;;;;iBKvmBgB,qBAAA"}

package/dist/index.js

@@ -1,8 +1,9 @@
 import { a as getWorkflowLogger, i as getRequestLogger, n as getActorLogger, r as getQueueLogger, t as createWorkersLogger } from "./execution-logger-BxmgP8jF.js";
+import { n as isNativeTracingAvailable, t as getNativeTracerFromCtx } from "./native-tracing-D0EyAtsF.js";
 import { a as wrap, i as unwrap, n as proxyExecutionContext } from "./common-DiWH6nmG.js";
 import { a as instrumentKV, c as instrumentImages, d as instrumentHyperdrive, f as instrumentVectorize, i as instrumentD1, l as instrumentAnalyticsEngine, n as instrumentRateLimiter, o as instrumentR2, p as instrumentAI, r as instrumentBindings, s as instrumentServiceBinding, t as instrumentBrowserRendering, u as instrumentQueueProducer } from "./bindings-C10RI6Il.js";
 import { n as instrumentDO, t as instrumentWorkflow } from "./handlers-CMg9l_T-.js";
-import { WorkerTracer, WorkerTracerProvider, createInitialiser, getActiveConfig, getServiceForPath, setConfig, shouldInstrumentPath } from "autotel-edge";
+import { WorkerTracer, WorkerTracerProvider, createInitialiser, ensureGlobalContextManager, getActiveConfig, getServiceForPath, setConfig, shouldInstrumentPath, withNativeTracer } from "autotel-edge";
 import { SpanKind, SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
 import { resourceFromAttributes } from "@opentelemetry/resources";
 
@@ -516,6 +517,39 @@ function createHandlerFlow(instrumentation) {
 		});
 	};
 }
+let warnedMissingNative = false;
+/**
+* Resolve whether this invocation should use Cloudflare's native tracer.
+*
+* - `nativeTracing: 'off'` → never use native (always autotel's OTLP pipeline).
+* - `nativeTracing: 'on'`  → require native; warn once and fall back if absent.
+* - `nativeTracing: 'auto'` (default) → use native when `ctx.tracing` exists.
+*/
+function resolveNativeTracer(config, ctx, trigger) {
+	const mode = config.nativeTracing ?? "auto";
+	if (mode === "off") return null;
+	const nativeTracer = getNativeTracerFromCtx(ctx, (trigger instanceof Request ? trigger.headers.get("cf-ray") : null) ?? crypto.randomUUID());
+	if (!nativeTracer && mode === "on" && !warnedMissingNative) {
+		warnedMissingNative = true;
+		console.warn("[autotel-cloudflare] nativeTracing is 'on' but Cloudflare native tracing was not detected. Enable observability.traces in your Wrangler config (and use a recent compatibility_date). Falling back to the autotel OTLP exporter.");
+	}
+	return nativeTracer;
+}
+/**
+* Run a handler in native-tracing mode.
+*
+* Cloudflare already creates the root handler span and instruments platform
+* operations (fetch / KV / R2 / D1 / DO), so autotel defers entirely: no
+* binding proxies (avoids duplicate spans), no provider/exporter, no manual
+* flush. We install the native tracer into the active context so that the
+* user's `span()` / `trace()` / `enterSpan()` calls nest inside Cloudflare's
+* native waterfall and are exported by the platform.
+*/
+function runWithNativeTracing(handlerFn, trigger, env, ctx, config, nativeTracer) {
+	ensureGlobalContextManager();
+	const nativeContext = withNativeTracer(nativeTracer, setConfig(config));
+	return context.with(nativeContext, () => handlerFn(trigger, env, ctx));
+}
 /**
 * Create handler proxy
 */
@@ -523,6 +557,8 @@ function createHandlerProxy(_handler, handlerFn, initialiser, instrumentation) {
 	return (trigger, env, ctx) => {
 		const config = initialiser(env, trigger);
 		if (config.instrumentation.disabled) return handlerFn(trigger, env, ctx);
+		const nativeTracer = resolveNativeTracer(config, ctx, trigger);
+		if (nativeTracer) return runWithNativeTracing(handlerFn, trigger, env, ctx, config, nativeTracer);
 		const instrumentedEnv = instrumentBindings(env);
 		const configContext = setConfig(config);
 		initProvider(config);
@@ -551,6 +587,8 @@ function createHandlerProxyWithConfig(_handler, handlerFn, initialiser, createIn
 				exclude: fetchCfg.exclude
 			})) return handlerFn(trigger, env, ctx);
 		}
+		const nativeTracer = resolveNativeTracer(config, ctx, trigger);
+		if (nativeTracer) return runWithNativeTracing(handlerFn, trigger, env, ctx, config, nativeTracer);
 		const instrumentedEnv = instrumentBindings(env);
 		const configContext = setConfig(config);
 		initProvider(config);
@@ -698,5 +736,5 @@ function defineWorkerFetch(config, handler, loggerOptions = {}) {
 }
 
 //#endregion
-export { createWorkersLogger, defineWorkerFetch, getActorLogger, getQueueLogger, getRequestLogger, getWorkflowLogger, instrument, instrumentAI, instrumentAnalyticsEngine, instrumentBindings, instrumentBrowserRendering, instrumentD1, instrumentDO, instrumentGlobalCache, instrumentGlobalFetch, instrumentHyperdrive, instrumentImages, instrumentKV, instrumentQueueProducer, instrumentR2, instrumentRateLimiter, instrumentServiceBinding, instrumentVectorize, instrumentWorkflow, wrapDurableObject, wrapModule };
+export { createWorkersLogger, defineWorkerFetch, getActorLogger, getNativeTracerFromCtx, getQueueLogger, getRequestLogger, getWorkflowLogger, instrument, instrumentAI, instrumentAnalyticsEngine, instrumentBindings, instrumentBrowserRendering, instrumentD1, instrumentDO, instrumentGlobalCache, instrumentGlobalFetch, instrumentHyperdrive, instrumentImages, instrumentKV, instrumentQueueProducer, instrumentR2, instrumentRateLimiter, instrumentServiceBinding, instrumentVectorize, instrumentWorkflow, isNativeTracingAvailable, wrapDurableObject, wrapModule };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["api_context","api_context","context"],"sources":["../src/global/fetch.ts","../src/global/cache.ts","../src/wrappers/instrument.ts","../src/wrappers/wrap-module.ts","../src/wrappers/wrap-do.ts","../src/wrappers/define-worker-fetch.ts"],"sourcesContent":["/**\n * Global fetch() instrumentation for autotel-edge\n *\n * Automatically traces all outgoing fetch() calls with:\n * - HTTP method, URL, status code\n * - Request/response headers\n * - Automatic context propagation\n * - Error tracking\n */\n\nimport {\n  trace,\n  context as api_context,\n  propagation,\n  SpanStatusCode,\n  SpanKind,\n} from '@opentelemetry/api';\nimport { getActiveConfig, WorkerTracer } from 'autotel-edge';\n\n/**\n * Gather HTTP request attributes following OpenTelemetry semantic conventions\n */\nfunction gatherRequestAttributes(request: Request): Record<string, any> {\n  const url = new URL(request.url);\n  const config = getActiveConfig();\n  const redactQuery = config?.dataSafety?.redactQueryParams === true;\n\n  return {\n    'http.request.method': request.method.toUpperCase(),\n    'url.full': redactQuery ? `${url.origin}${url.pathname}` : request.url,\n    'url.scheme': url.protocol.replace(':', ''),\n    'server.address': url.host,\n    'url.path': url.pathname,\n    'url.query': redactQuery ? (url.search ? '[REDACTED]' : '') : url.search,\n    'network.protocol.name': 'http',\n    'user_agent.original': request.headers.get('user-agent') || undefined,\n  };\n}\n\n/**\n * Gather HTTP response attributes\n */\nfunction gatherResponseAttributes(response: Response): Record<string, any> {\n  return {\n    'http.response.status_code': response.status,\n    'http.response.body.size': response.headers.get('content-length') || undefined,\n  };\n}\n\n/**\n * Instrument the global fetch function\n *\n * This wraps globalThis.fetch to automatically create spans for all outgoing HTTP requests.\n *\n * **Note:** This is called automatically when the library is initialized with\n * `instrumentation.instrumentGlobalFetch: true` (default).\n */\nexport function instrumentGlobalFetch(): void {\n  const originalFetch = globalThis.fetch;\n\n  const instrumentedFetch = function fetch(\n    input: RequestInfo | URL,\n    init?: RequestInit,\n  ): Promise<Response> {\n    const request = new Request(input, init);\n\n    // Skip non-HTTP requests\n    if (!request.url.startsWith('http')) {\n      return originalFetch(input, init);\n    }\n\n    // Skip if no active config (not initialized yet)\n    const config = getActiveConfig();\n    if (!config) {\n      return originalFetch(input, init);\n    }\n\n    const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n    const url = new URL(request.url);\n    const spanName = `${request.method} ${url.host}`;\n\n    return tracer.startActiveSpan(\n      spanName,\n      {\n        kind: SpanKind.CLIENT,\n        attributes: gatherRequestAttributes(request),\n      },\n      async (span) => {\n        try {\n          // Inject trace context into request headers for distributed tracing\n          const shouldIncludeContext =\n            typeof config.fetch?.includeTraceContext === 'function'\n              ? config.fetch.includeTraceContext(request)\n              : (config.fetch?.includeTraceContext ?? true);\n\n          if (shouldIncludeContext) {\n            propagation.inject(api_context.active(), request.headers, {\n              set: (headers, key, value) => {\n                if (typeof value === 'string') {\n                  headers.set(key, value);\n                }\n              },\n            });\n          }\n\n          // Make the actual fetch call\n          const response = await originalFetch(request);\n\n          // Add response attributes\n          span.setAttributes(gatherResponseAttributes(response));\n\n          // Set span status based on response\n          if (response.ok) {\n            span.setStatus({ code: SpanStatusCode.OK });\n          } else {\n            span.setStatus({ code: SpanStatusCode.ERROR });\n          }\n\n          return response;\n        } catch (error) {\n          span.recordException(error as Error);\n          span.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: error instanceof Error ? error.message : String(error),\n          });\n          throw error;\n        } finally {\n          span.end();\n        }\n      },\n    );\n  };\n\n  // Replace global fetch\n  globalThis.fetch = instrumentedFetch as typeof fetch;\n}\n","/**\n * Global Cache API instrumentation for Cloudflare Workers\n *\n * Automatically traces cache operations:\n * - cache.match() - Read from cache\n * - cache.put() - Write to cache\n * - cache.delete() - Delete from cache\n */\n\nimport { trace, SpanStatusCode, SpanKind } from '@opentelemetry/api';\nimport { wrap } from '../bindings/common';\nimport { WorkerTracer } from 'autotel-edge';\n\ntype CacheOperation = 'match' | 'put' | 'delete';\n\n/**\n * Sanitize URL for span attributes (remove query params that might contain sensitive data)\n */\nfunction sanitizeURL(url: string): string {\n  const u = new URL(url);\n  return `${u.protocol}//${u.host}${u.pathname}`;\n}\n\n/**\n * Instrument a cache method (match, put, delete)\n */\nfunction instrumentCacheMethod<T extends Function>(\n  fn: T,\n  cacheName: string,\n  operation: CacheOperation,\n): T {\n  const handler: ProxyHandler<T> = {\n    async apply(target, thisArg, argArray) {\n      const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n      // Extract URL from first argument (Request or string)\n      const firstArg = argArray[0];\n      const url =\n        firstArg instanceof Request\n          ? firstArg.url\n          : typeof firstArg === 'string'\n            ? firstArg\n            : undefined;\n\n      const spanName = `Cache ${cacheName}.${operation}`;\n\n      return tracer.startActiveSpan(\n        spanName,\n        {\n          kind: SpanKind.CLIENT,\n          attributes: {\n            'cache.name': cacheName,\n            'cache.operation': operation,\n            'cache.key': url ? sanitizeURL(url) : undefined,\n          },\n        },\n        async (span) => {\n          try {\n            const result = await Reflect.apply(target, thisArg, argArray);\n\n            // For match operations, record whether it was a hit or miss\n            if (operation === 'match') {\n              span.setAttribute('cache.hit', !!result);\n            }\n\n            span.setStatus({ code: SpanStatusCode.OK });\n            return result;\n          } catch (error) {\n            span.recordException(error as Error);\n            span.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: error instanceof Error ? error.message : String(error),\n            });\n            throw error;\n          } finally {\n            span.end();\n          }\n        },\n      );\n    },\n  };\n\n  return wrap(fn, handler);\n}\n\n/**\n * Instrument a Cache instance\n */\nfunction instrumentCache(cache: Cache, cacheName: string): Cache {\n  const handler: ProxyHandler<Cache> = {\n    get(target, prop) {\n      const value = Reflect.get(target, prop);\n\n      // Instrument the cache operation methods\n      if (\n        (prop === 'match' || prop === 'put' || prop === 'delete') &&\n        typeof value === 'function'\n      ) {\n        return instrumentCacheMethod(\n          value.bind(target),\n          cacheName,\n          prop as CacheOperation,\n        );\n      }\n\n      // Bind other methods to preserve `this` context\n      if (typeof value === 'function') {\n        return value.bind(target);\n      }\n\n      return value;\n    },\n  };\n\n  return wrap(cache, handler);\n}\n\n/**\n * Instrument caches.open()\n */\nfunction instrumentCachesOpen(\n  openFn: CacheStorage['open'],\n): CacheStorage['open'] {\n  const handler: ProxyHandler<CacheStorage['open']> = {\n    async apply(target, thisArg, argArray) {\n      const cacheName = argArray[0];\n      const cache = await Reflect.apply(target, thisArg, argArray);\n      return instrumentCache(cache, cacheName);\n    },\n  };\n\n  return wrap(openFn, handler);\n}\n\n/**\n * Instrument the global caches API\n *\n * This wraps globalThis.caches to automatically create spans for all cache operations.\n *\n * **Note:** This is called automatically when the library is initialized with\n * `instrumentation.instrumentGlobalCache: true` (default).\n */\nexport function instrumentGlobalCache(): void {\n  const handler: ProxyHandler<typeof caches> = {\n    get(target, prop) {\n      if (prop === 'default') {\n        // Wrap the default cache\n        return instrumentCache(target.default, 'default');\n      } else if (prop === 'open') {\n        // Wrap the open method\n        const openFn = Reflect.get(target, prop);\n        if (typeof openFn === 'function') {\n          return instrumentCachesOpen(openFn.bind(target));\n        }\n      }\n\n      return Reflect.get(target, prop);\n    },\n  };\n\n  // Replace global caches\n  // @ts-ignore - TypeScript doesn't like reassigning globalThis.caches\n  globalThis.caches = wrap(caches, handler);\n}\n","/**\n * Handler instrumentation for Cloudflare Workers\n * \n * Note: This file uses Cloudflare Workers types (ExportedHandler, Request, Response, etc.)\n * which are globally available via @cloudflare/workers-types when listed in tsconfig.json.\n * These types are devDependencies only - they're not runtime dependencies.\n * At runtime, Cloudflare Workers runtime provides the actual implementations.\n * \n * Provides automatic OpenTelemetry tracing for:\n * - HTTP handlers (fetch)\n * - Scheduled/cron handlers\n * - Queue handlers (with message tracking)\n * - Email handlers\n * - Auto-instrumentation of Cloudflare bindings (KV, R2, D1, Service Bindings)\n * - Global fetch and cache instrumentation\n * - Post-processor support for span customization\n * - Tail sampling support\n * - Cold start tracking\n */\n\nimport {\n  trace,\n  context as api_context,\n  propagation,\n  SpanStatusCode,\n  SpanKind,\n} from '@opentelemetry/api';\nimport { resourceFromAttributes } from '@opentelemetry/resources';\nimport type {\n  ConfigurationOption,\n  ResolvedEdgeConfig,\n  Trigger,\n  HandlerInstrumentation,\n  InitialSpanInfo,\n  ReadableSpan,\n  RouteServiceConfig,\n} from 'autotel-edge';\nimport {\n  createInitialiser,\n  setConfig,\n  getActiveConfig,\n  getServiceForPath,\n  shouldInstrumentPath,\n  type Initialiser,\n  WorkerTracerProvider,\n  WorkerTracer,\n} from 'autotel-edge';\nimport { proxyExecutionContext, unwrap, wrap, type PromiseTracker } from '../bindings/common';\nimport { instrumentGlobalFetch } from '../global/fetch';\nimport { instrumentGlobalCache } from '../global/cache';\nimport { instrumentBindings } from '../bindings/bindings';\nimport type { Attributes, Span, TextMapGetter } from '@opentelemetry/api';\n\n// Web API Headers objects require .get() — property access via defaultTextMapGetter won't work\nconst headersGetter: TextMapGetter<Headers> = {\n  get: (carrier, key) => carrier.get(key) ?? undefined,\n  keys: (carrier) => [...carrier.keys()],\n};\n\ntype FetchHandler = (\n  request: Request,\n  env: any,\n  ctx: ExecutionContext,\n) => Response | Promise<Response>;\n\ntype ScheduledHandler = (\n  event: ScheduledController,\n  env: any,\n  ctx: ExecutionContext,\n) => void | Promise<void>;\n\ntype QueueHandler = (\n  batch: MessageBatch,\n  env: any,\n  ctx: ExecutionContext,\n) => void | Promise<void>;\n\ntype EmailHandler = (\n  message: ForwardableEmailMessage,\n  env: any,\n  ctx: ExecutionContext,\n) => void | Promise<void>;\n\n/**\n * Create fetch handler instrumentation with config support for postProcess\n */\n/**\n * Extract Cloudflare-specific attributes from a request\n */\nfunction extractCfAttributes(request: Request): Record<string, string | number | boolean> {\n  const cf = (request as any).cf;\n  if (!cf) return {};\n\n  const attrs: Record<string, string | number | boolean> = {};\n  const set = (key: string, value: unknown) => {\n    if (value !== undefined && value !== null) {\n      attrs[key] = value as string | number | boolean;\n    }\n  };\n\n  set('cloudflare.colo', cf.colo);\n  const ray = request.headers.get('cf-ray');\n  if (ray) attrs['cloudflare.ray_id'] = ray;\n  set('cloudflare.country', cf.country);\n  set('cloudflare.city', cf.city);\n  set('cloudflare.region', cf.region);\n  set('cloudflare.continent', cf.continent);\n  set('cloudflare.timezone', cf.timezone);\n  set('cloudflare.latitude', cf.latitude);\n  set('cloudflare.longitude', cf.longitude);\n  set('cloudflare.asn', cf.asn);\n  set('cloudflare.as_organization', cf.asOrganization);\n  set('cloudflare.http_protocol', cf.httpProtocol);\n  set('cloudflare.tls_version', cf.tlsVersion);\n  set('cloudflare.client_tcp_rtt', cf.clientTcpRtt);\n\n  return attrs;\n}\n\nfunction createFetchInstrumentation(\n  config: ResolvedEdgeConfig,\n): HandlerInstrumentation<Request, Response> {\n  return {\n    getInitialSpanInfo: (request: Request): InitialSpanInfo => {\n      const url = new URL(request.url);\n      const routeService = getServiceForPath(\n        url.pathname,\n        config.handlers.fetch.routes as Record<string, RouteServiceConfig> | undefined,\n      );\n\n      const cfAttrs = (config as any).extractCfAttributes === false\n        ? {}\n        : extractCfAttributes(request);\n\n      return {\n        name: `${request.method} ${url.pathname}`,\n        options: {\n          kind: SpanKind.SERVER,\n          attributes: {\n            'http.request.method': request.method,\n            'url.full': request.url,\n            ...(routeService ? { 'service.name': routeService, 'autotel.route.service': routeService } : {}),\n            ...cfAttrs,\n          },\n        },\n        context: propagation.extract(api_context.active(), request.headers, headersGetter),\n      };\n    },\n    getAttributesFromResult: (response: Response) => ({\n      'http.response.status_code': response.status,\n    }),\n    executionSucces: (span: Span, trigger: Request, result: Response) => {\n      // Override span status for server errors (5xx)\n      if (result.status >= 500) {\n        span.setStatus({ code: SpanStatusCode.ERROR });\n      }\n\n      // Call postProcess callback if configured\n      if (config.handlers.fetch.postProcess) {\n        const readableSpan = span as unknown as ReadableSpan;\n        config.handlers.fetch.postProcess(span, {\n          request: trigger,\n          response: result,\n          readable: readableSpan,\n        });\n      }\n    },\n  };\n}\n\n/**\n * Scheduled handler instrumentation\n */\nconst scheduledInstrumentation: HandlerInstrumentation<ScheduledController, void> = {\n  getInitialSpanInfo: (event: ScheduledController): InitialSpanInfo => {\n    return {\n      name: `scheduledHandler ${event.cron || 'unknown'}`,\n      options: {\n        kind: SpanKind.INTERNAL,\n        attributes: {\n          'faas.trigger': 'timer',\n          'faas.cron': event.cron || 'unknown',\n          'faas.scheduled_time': new Date(event.scheduledTime).toISOString(),\n        },\n      },\n    };\n  },\n};\n\n/**\n * Tracks message status counts for queue processing\n */\nclass MessageStatusCount {\n  succeeded = 0;\n  failed = 0;\n  implicitly_acked = 0;\n  implicitly_retried = 0;\n  readonly total: number;\n\n  constructor(total: number) {\n    this.total = total;\n  }\n\n  ack() {\n    this.succeeded = this.succeeded + 1;\n  }\n\n  ackRemaining() {\n    this.implicitly_acked = this.total - this.succeeded - this.failed;\n    this.succeeded = this.total - this.failed;\n  }\n\n  retry() {\n    this.failed = this.failed + 1;\n  }\n\n  retryRemaining() {\n    this.implicitly_retried = this.total - this.succeeded - this.failed;\n    this.failed = this.total - this.succeeded;\n  }\n\n  toAttributes(): Attributes {\n    return {\n      'queue.messages_count': this.total,\n      'queue.messages_success': this.succeeded,\n      'queue.messages_failed': this.failed,\n      'queue.batch_success': this.succeeded === this.total,\n      'queue.implicitly_acked': this.implicitly_acked,\n      'queue.implicitly_retried': this.implicitly_retried,\n    };\n  }\n}\n\n/**\n * Add event to active span\n */\nfunction addQueueEvent(name: string, msg?: Message, delaySeconds?: number) {\n  const attrs: Attributes = {};\n  if (msg) {\n    attrs['queue.message_id'] = msg.id;\n    attrs['queue.message_timestamp'] = msg.timestamp.toISOString();\n    // Add attempts if available (from Cloudflare Queues API)\n    if ('attempts' in msg && typeof msg.attempts === 'number') {\n      attrs['queue.message_attempts'] = msg.attempts;\n    }\n  }\n  if (delaySeconds !== undefined) {\n    attrs['queue.retry_delay_seconds'] = delaySeconds;\n  }\n  trace.getActiveSpan()?.addEvent(name, attrs);\n}\n\n/**\n * Proxy a queue message to track ack/retry operations\n */\nfunction proxyQueueMessage<Q>(msg: Message<Q>, count: MessageStatusCount): Message<Q> {\n  const msgHandler: ProxyHandler<Message<Q>> = {\n    get: (target, prop) => {\n      if (prop === 'ack') {\n        const ackFn = Reflect.get(target, prop);\n        return new Proxy(ackFn, {\n          apply: (fnTarget) => {\n            addQueueEvent('messageAck', msg);\n            count.ack();\n            Reflect.apply(fnTarget, msg, []);\n          },\n        });\n      } else if (prop === 'retry') {\n        const retryFn = Reflect.get(target, prop);\n        return new Proxy(retryFn, {\n          apply: (fnTarget, _thisArg, args) => {\n            // Extract delay and content type from retry options if provided\n            const retryOptions = args[0] as\n              | { delaySeconds?: number; contentType?: string }\n              | undefined;\n            const delaySeconds = retryOptions?.delaySeconds;\n\n            addQueueEvent('messageRetry', msg, delaySeconds);\n\n            // Add content type attribute if provided\n            if (retryOptions?.contentType) {\n              const span = trace.getActiveSpan();\n              if (span) {\n                span.setAttribute('queue.message.content_type', retryOptions.contentType);\n              }\n            }\n\n            count.retry();\n            const result = Reflect.apply(fnTarget, msg, args);\n            return result;\n          },\n        });\n      } else {\n        return Reflect.get(target, prop, msg);\n      }\n    },\n  };\n  return wrap(msg, msgHandler);\n}\n\n/**\n * Proxy MessageBatch to track ackAll/retryAll operations\n */\nfunction proxyMessageBatch(batch: MessageBatch, count: MessageStatusCount): MessageBatch {\n  const batchHandler: ProxyHandler<MessageBatch> = {\n    get: (target, prop) => {\n      if (prop === 'messages') {\n        const messages = Reflect.get(target, prop);\n        const messagesHandler: ProxyHandler<MessageBatch['messages']> = {\n          get: (target, prop) => {\n            if (typeof prop === 'string' && !isNaN(parseInt(prop))) {\n              const message = Reflect.get(target, prop);\n              return proxyQueueMessage(message, count);\n            } else {\n              return Reflect.get(target, prop);\n            }\n          },\n        };\n        return wrap(messages, messagesHandler);\n      } else if (prop === 'ackAll') {\n        const ackFn = Reflect.get(target, prop);\n        return new Proxy(ackFn, {\n          apply: (fnTarget) => {\n            addQueueEvent('ackAll');\n            count.ackRemaining();\n            Reflect.apply(fnTarget, batch, []);\n          },\n        });\n      } else if (prop === 'retryAll') {\n        const retryFn = Reflect.get(target, prop);\n        return new Proxy(retryFn, {\n          apply: (fnTarget, _thisArg, args) => {\n            // Extract delay from retryAll options if provided\n            const retryOptions = args[0] as { delaySeconds?: number } | undefined;\n            const delaySeconds = retryOptions?.delaySeconds;\n\n            addQueueEvent('retryAll', undefined, delaySeconds);\n            count.retryRemaining();\n            Reflect.apply(fnTarget, batch, args);\n          },\n        });\n      }\n      return Reflect.get(target, prop);\n    },\n  };\n  return wrap(batch, batchHandler);\n}\n\n/**\n * Queue handler instrumentation with message tracking\n */\nclass QueueInstrumentation implements HandlerInstrumentation<MessageBatch, void> {\n  private count?: MessageStatusCount;\n\n  getInitialSpanInfo(batch: MessageBatch): InitialSpanInfo {\n    return {\n      name: `queueHandler ${batch.queue || 'unknown'}`,\n      options: {\n        kind: SpanKind.CONSUMER,\n        attributes: {\n          'faas.trigger': 'pubsub',\n          'queue.name': batch.queue || 'unknown',\n        },\n      },\n    };\n  }\n\n  instrumentTrigger(batch: MessageBatch): MessageBatch {\n    this.count = new MessageStatusCount(batch.messages.length);\n    return proxyMessageBatch(batch, this.count);\n  }\n\n  executionSucces(span: Span, _trigger: MessageBatch, _result: void) {\n    if (this.count) {\n      this.count.ackRemaining();\n      span.setAttributes(this.count.toAttributes());\n    }\n  }\n\n  executionFailed(span: Span, _trigger: MessageBatch, _error?: any) {\n    if (this.count) {\n      this.count.retryRemaining();\n      span.setAttributes(this.count.toAttributes());\n    }\n  }\n}\n\n/**\n * Converts email headers into OpenTelemetry attributes.\n * When dataSafety.emailHeaderAllowlist is configured, only allowed headers are captured.\n */\nfunction headerAttributes(message: { headers: Headers }): Record<string, string> {\n  const attrs: Record<string, string> = {};\n  if (message.headers instanceof Headers) {\n    const config = getActiveConfig();\n    const allowlist: string[] | undefined = config?.dataSafety?.emailHeaderAllowlist;\n    for (const [key, value] of message.headers.entries()) {\n      if (allowlist && !allowlist.includes(key.toLowerCase())) {\n        continue;\n      }\n      attrs[`email.header.${key}`] = value;\n    }\n  }\n  return attrs;\n}\n\n/**\n * Email handler instrumentation\n */\nconst emailInstrumentation: HandlerInstrumentation<ForwardableEmailMessage, void> = {\n  getInitialSpanInfo: (message: ForwardableEmailMessage): InitialSpanInfo => {\n    const attributes: Record<string, string> = {\n      'faas.trigger': 'other',\n      'messaging.destination.name': message.to || 'unknown',\n    };\n\n    // Add message ID if available\n    if ('headers' in message && message.headers instanceof Headers) {\n      const messageId = message.headers.get('Message-Id');\n      if (messageId) {\n        attributes['rpc.message.id'] = messageId;\n      }\n      // Add all headers as attributes\n      Object.assign(attributes, headerAttributes(message));\n    }\n\n    return {\n      name: `emailHandler ${message.to || 'unknown'}`,\n      options: {\n        kind: SpanKind.CONSUMER,\n        attributes,\n      },\n    };\n  },\n};\n\n\n/**\n * Export spans after request completes\n */\nasync function exportSpans(\n  traceId: string,\n  tracker: PromiseTracker | undefined,\n  ctx: ExecutionContext,\n) {\n  const tracer = trace.getTracer('autotel-edge');\n  if (tracer instanceof WorkerTracer) {\n    try {\n      // scheduler is available on ExecutionContext at runtime\n      const ctxWithScheduler = ctx as ExecutionContext & { scheduler?: { wait(ms: number): Promise<void> } };\n      if (ctxWithScheduler.scheduler) {\n        await ctxWithScheduler.scheduler.wait(1);\n      }\n      await tracker?.wait();\n      await tracer.forceFlush(traceId);\n    } catch (error) {\n      // Silently handle exporter errors to prevent worker crashes\n      // Exporter failures should not affect the worker's ability to process requests\n      // In production, consider logging to a monitoring service\n      console.error('[autotel-edge] Failed to export spans:', error);\n    }\n  }\n}\n\n/**\n * Create handler flow with instrumentation\n */\nfunction createHandlerFlow<T extends Trigger, E, R>(\n  instrumentation: HandlerInstrumentation<T, R>,\n) {\n  return (\n    handlerFn: (trigger: T, env: E, ctx: ExecutionContext) => R | Promise<R>,\n    [trigger, env, context]: [T, E, ExecutionContext],\n  ) => {\n    const { ctx: proxiedCtx, tracker } = proxyExecutionContext(context);\n\n    const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n    const { name, options, context: spanContext } =\n      instrumentation.getInitialSpanInfo(trigger);\n\n    // Add cold start tracking\n    if (options.attributes) {\n      options.attributes['faas.coldstart'] = coldStart;\n    } else {\n      options.attributes = { 'faas.coldstart': coldStart };\n    }\n    coldStart = false;\n\n    const parentContext = spanContext || api_context.active();\n\n    // Instrument trigger if supported (e.g., for queue handler)\n    const instrumentedTrigger = instrumentation.instrumentTrigger\n      ? instrumentation.instrumentTrigger(trigger)\n      : trigger;\n\n    return tracer.startActiveSpan(name, options, parentContext, async (span) => {\n      try {\n        const result = await handlerFn(instrumentedTrigger, env, proxiedCtx);\n\n        if (instrumentation.getAttributesFromResult) {\n          const attributes = instrumentation.getAttributesFromResult(result);\n          span.setAttributes(attributes);\n        }\n\n        // Set default OK status; executionSucces may override (e.g. HTTP 5xx)\n        span.setStatus({ code: SpanStatusCode.OK });\n\n        if (instrumentation.executionSucces) {\n          instrumentation.executionSucces(span, trigger, result);\n        }\n        return result;\n      } catch (error) {\n        span.recordException(error as Error);\n        span.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : String(error),\n        });\n        if (instrumentation.executionFailed) {\n          instrumentation.executionFailed(span, trigger, error);\n        }\n        throw error;\n      } finally {\n        span.end();\n        context.waitUntil(exportSpans(span.spanContext().traceId, tracker, context));\n      }\n    });\n  };\n}\n\n/**\n * Create handler proxy\n */\nfunction createHandlerProxy<T extends Trigger, E, R>(\n  _handler: unknown,\n  handlerFn: (trigger: T, env: E, ctx: ExecutionContext) => R | Promise<R>,\n  initialiser: Initialiser,\n  instrumentation: HandlerInstrumentation<T, R>,\n): (trigger: T, env: E, ctx: ExecutionContext) => ReturnType<typeof handlerFn> {\n  return (trigger: T, env: E, ctx: ExecutionContext) => {\n    const config = initialiser(env, trigger);\n    \n    // Check if instrumentation is disabled (useful for local dev)\n    if (config.instrumentation.disabled) {\n      // Return handler as-is without instrumentation\n      return handlerFn(trigger, env, ctx);\n    }\n    \n    // Auto-instrument Cloudflare bindings in the environment\n    const instrumentedEnv = instrumentBindings(env as Record<string, any>) as E;\n    \n    const configContext = setConfig(config);\n\n    // Initialize provider on first call\n    initProvider(config);\n\n    const flowFn = createHandlerFlow<T, E, R>(instrumentation);\n\n    // Execute the handler flow within the config context\n    return api_context.with(configContext, () => {\n      return flowFn(handlerFn, [trigger, instrumentedEnv, ctx]) as ReturnType<typeof handlerFn>;\n    });\n  };\n}\n\n/**\n * Create handler proxy with dynamic instrumentation (for fetch with postProcess)\n */\nfunction createHandlerProxyWithConfig<T extends Trigger, E, R>(\n  _handler: unknown,\n  handlerFn: (trigger: T, env: E, ctx: ExecutionContext) => R | Promise<R>,\n  initialiser: Initialiser,\n  createInstrumentation: (config: ResolvedEdgeConfig) => HandlerInstrumentation<T, R>,\n): (trigger: T, env: E, ctx: ExecutionContext) => ReturnType<typeof handlerFn> {\n  return (trigger: T, env: E, ctx: ExecutionContext) => {\n    const config = initialiser(env, trigger);\n    \n    // Check if instrumentation is disabled (useful for local dev)\n    if (config.instrumentation.disabled) {\n      // Return handler as-is without instrumentation\n      return handlerFn(trigger, env, ctx);\n    }\n\n    if (trigger instanceof Request) {\n      const pathname = new URL(trigger.url).pathname;\n      const fetchCfg = config.handlers.fetch;\n      if (\n        !shouldInstrumentPath(pathname, {\n          include: fetchCfg.include,\n          exclude: fetchCfg.exclude,\n        })\n      ) {\n        return handlerFn(trigger, env, ctx) as ReturnType<typeof handlerFn>;\n      }\n    }\n    \n    // Auto-instrument Cloudflare bindings in the environment\n    const instrumentedEnv = instrumentBindings(env as Record<string, any>) as E;\n    \n    const configContext = setConfig(config);\n\n    // Initialize provider on first call\n    initProvider(config);\n\n    // Create instrumentation with config\n    const instrumentation = createInstrumentation(config);\n    const flowFn = createHandlerFlow<T, E, R>(instrumentation);\n\n    // Execute the handler flow within the config context\n    return api_context.with(configContext, () => {\n      return flowFn(handlerFn, [trigger, instrumentedEnv, ctx]) as ReturnType<typeof handlerFn>;\n    });\n  };\n}\n\nlet providerInitialized = false;\nlet coldStart = true;\n\n/**\n * Initialize the tracer provider\n */\nfunction initProvider(config: ResolvedEdgeConfig): void {\n  if (providerInitialized) return;\n\n  // Install global instrumentations\n  if (config.instrumentation.instrumentGlobalFetch) {\n    instrumentGlobalFetch();\n  }\n  if (config.instrumentation.instrumentGlobalCache) {\n    instrumentGlobalCache();\n  }\n\n  // Set up propagator\n  propagation.setGlobalPropagator(config.propagator);\n\n  // Create resource\n  const resource = resourceFromAttributes({\n    'service.name': config.service.name,\n    'service.version': config.service.version,\n    'service.namespace': config.service.namespace,\n    'cloud.provider': 'cloudflare',\n    'cloud.platform': 'cloudflare.workers',\n    'telemetry.sdk.name': 'autotel-edge',\n    'telemetry.sdk.language': 'js',\n  });\n\n  // Create and register provider\n  const provider = new WorkerTracerProvider(config.spanProcessors, resource);\n  provider.register();\n\n  // Set head sampler on tracer\n  const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n  tracer.setHeadSampler(config.sampling.headSampler);\n\n  providerInitialized = true;\n}\n\n/**\n * Instrument a Cloudflare Workers handler\n *\n * @example\n * ```typescript\n * import { instrument } from 'autotel-edge'\n *\n * const handler = {\n *   async fetch(request, env, ctx) {\n *     return new Response('Hello World')\n *   }\n * }\n *\n * export default instrument(handler, {\n *   exporter: {\n *     url: env.OTLP_ENDPOINT,\n *     headers: { 'x-api-key': env.API_KEY }\n *   },\n *   service: { name: 'my-worker' }\n * })\n * ```\n */\nexport function instrument<E, Q = any, C = any>(\n  handler: ExportedHandler<E, Q, C>,\n  config: ConfigurationOption,\n): ExportedHandler<E, Q, C> {\n  const initialiser = createInitialiser(config);\n\n  if (handler.fetch) {\n    const fetcher = unwrap(handler.fetch) as FetchHandler;\n    // Create fetch instrumentation with config support\n    handler.fetch = createHandlerProxyWithConfig(\n      handler,\n      fetcher,\n      initialiser,\n      createFetchInstrumentation,\n    );\n  }\n\n  if (handler.scheduled) {\n    const scheduled = unwrap(handler.scheduled) as ScheduledHandler;\n    handler.scheduled = createHandlerProxy(\n      handler,\n      scheduled,\n      initialiser,\n      scheduledInstrumentation,\n    );\n  }\n\n  if (handler.queue) {\n    const queue = unwrap(handler.queue) as QueueHandler;\n    handler.queue = createHandlerProxy(\n      handler,\n      queue,\n      initialiser,\n      new QueueInstrumentation(),\n    );\n  }\n\n  if (handler.email) {\n    const email = unwrap(handler.email) as EmailHandler;\n    handler.email = createHandlerProxy(\n      handler,\n      email,\n      initialiser,\n      emailInstrumentation,\n    );\n  }\n\n  return handler;\n}\n","/**\n * workers-honeycomb-logger style wrapper API\n *\n * @example\n * ```typescript\n * import { wrapModule } from 'autotel-cloudflare'\n *\n * const handler = {\n *   async fetch(req, env, ctx) {\n *     return new Response('Hello')\n *   }\n * }\n *\n * export default wrapModule(\n *   { service: { name: 'my-worker' } },\n *   handler\n * )\n * ```\n */\n\nimport { instrument } from './instrument';\nimport type { ConfigurationOption } from 'autotel-edge';\n\n/**\n * Wrap a Cloudflare Workers module-style handler\n * Alternative API style inspired by workers-honeycomb-logger\n *\n * @param config Configuration (can be static object or function)\n * @param handler The worker handler to wrap\n * @returns Instrumented handler\n */\nexport function wrapModule<E, Q = any, C = any>(\n  config: ConfigurationOption,\n  handler: ExportedHandler<E, Q, C>,\n): ExportedHandler<E, Q, C> {\n  return instrument(handler, config);\n}\n","/**\n * Durable Object wrapper\n *\n * @example\n * ```typescript\n * import { wrapDurableObject } from 'autotel-cloudflare'\n *\n * class Counter implements DurableObject {\n *   async fetch(request: Request) {\n *     return new Response('count')\n *   }\n * }\n *\n * export default wrapDurableObject({ service: { name: 'counter-do' } }, Counter)\n * ```\n */\n\nimport { instrumentDO } from '../handlers/durable-objects';\nimport type { ConfigurationOption } from 'autotel-edge';\n\n/**\n * Wrap a Durable Object class with instrumentation\n * Alternative API style inspired by workers-honeycomb-logger\n *\n * @param config Configuration (can be static object or function)\n * @param doClass The Durable Object class to wrap\n * @returns Instrumented Durable Object class\n */\nexport function wrapDurableObject<T extends DurableObject>(\n  config: ConfigurationOption,\n  doClass: new (state: DurableObjectState, env: any) => T,\n): new (state: DurableObjectState, env: any) => T {\n  return instrumentDO(doClass, config);\n}\n","/**\n * Ergonomic wrapper for Cloudflare Workers `fetch` handlers.\n *\n * `defineWorkerFetch` instruments the handler the same way `instrument()` does\n * (so span exports already flush via `ctx.waitUntil`), and additionally injects\n * a request-scoped `ExecutionLogger` as the fourth argument — pre-populated\n * with method, path, cf-ray and `request.cf` context.\n *\n * Use this instead of `wrapModule` / `instrument` when your handler wants the\n * logger handed in directly rather than reaching for `getRequestLogger()`.\n *\n * @example\n * ```ts\n * import { defineWorkerFetch } from 'autotel-cloudflare'\n *\n * export default defineWorkerFetch(\n *   { service: { name: 'my-worker' } },\n *   async (request, env, ctx, log) => {\n *     log.set({ route: '/health' })\n *     log.emitNow({ status: 200 })\n *     return new Response('ok')\n *   },\n * )\n * ```\n */\nimport type { ConfigurationOption } from 'autotel-edge';\nimport { instrument } from './instrument';\nimport { createWorkersLogger, type WorkersLoggerOptions } from '../execution-logger';\nimport type { ExecutionLogger } from '../execution-logger';\n\nexport type DefineWorkerFetchOptions = WorkersLoggerOptions;\n\nexport type WorkerFetchHandler<E> = (\n  request: Request,\n  env: E,\n  ctx: ExecutionContext,\n  log: ExecutionLogger,\n) => Response | Promise<Response>;\n\n/**\n * Wrap a Workers fetch handler so:\n *   - the handler is instrumented (spans, propagation, waitUntil export flush)\n *   - the handler receives a request-scoped logger as its fourth argument\n */\nexport function defineWorkerFetch<E = unknown>(\n  config: ConfigurationOption,\n  handler: WorkerFetchHandler<E>,\n  loggerOptions: DefineWorkerFetchOptions = {},\n): { fetch: (request: Request, env: E, ctx: ExecutionContext) => Promise<Response> } {\n  const wrapped = instrument(\n    {\n      fetch(request: Request, env: E, ctx: ExecutionContext) {\n        const log = createWorkersLogger(request, loggerOptions);\n        return handler(request, env, ctx, log);\n      },\n    },\n    config,\n  );\n\n  return {\n    fetch(request, env, ctx) {\n      return Promise.resolve(\n        (wrapped.fetch as unknown as (\n          req: Request,\n          env: E,\n          ctx: ExecutionContext,\n        ) => Response | Promise<Response>)(request, env, ctx),\n      );\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["api_context","api_context","context"],"sources":["../src/global/fetch.ts","../src/global/cache.ts","../src/wrappers/instrument.ts","../src/wrappers/wrap-module.ts","../src/wrappers/wrap-do.ts","../src/wrappers/define-worker-fetch.ts"],"sourcesContent":["/**\n * Global fetch() instrumentation for autotel-edge\n *\n * Automatically traces all outgoing fetch() calls with:\n * - HTTP method, URL, status code\n * - Request/response headers\n * - Automatic context propagation\n * - Error tracking\n */\n\nimport {\n  trace,\n  context as api_context,\n  propagation,\n  SpanStatusCode,\n  SpanKind,\n} from '@opentelemetry/api';\nimport { getActiveConfig, WorkerTracer } from 'autotel-edge';\n\n/**\n * Gather HTTP request attributes following OpenTelemetry semantic conventions\n */\nfunction gatherRequestAttributes(request: Request): Record<string, any> {\n  const url = new URL(request.url);\n  const config = getActiveConfig();\n  const redactQuery = config?.dataSafety?.redactQueryParams === true;\n\n  return {\n    'http.request.method': request.method.toUpperCase(),\n    'url.full': redactQuery ? `${url.origin}${url.pathname}` : request.url,\n    'url.scheme': url.protocol.replace(':', ''),\n    'server.address': url.host,\n    'url.path': url.pathname,\n    'url.query': redactQuery ? (url.search ? '[REDACTED]' : '') : url.search,\n    'network.protocol.name': 'http',\n    'user_agent.original': request.headers.get('user-agent') || undefined,\n  };\n}\n\n/**\n * Gather HTTP response attributes\n */\nfunction gatherResponseAttributes(response: Response): Record<string, any> {\n  return {\n    'http.response.status_code': response.status,\n    'http.response.body.size': response.headers.get('content-length') || undefined,\n  };\n}\n\n/**\n * Instrument the global fetch function\n *\n * This wraps globalThis.fetch to automatically create spans for all outgoing HTTP requests.\n *\n * **Note:** This is called automatically when the library is initialized with\n * `instrumentation.instrumentGlobalFetch: true` (default).\n */\nexport function instrumentGlobalFetch(): void {\n  const originalFetch = globalThis.fetch;\n\n  const instrumentedFetch = function fetch(\n    input: RequestInfo | URL,\n    init?: RequestInit,\n  ): Promise<Response> {\n    const request = new Request(input, init);\n\n    // Skip non-HTTP requests\n    if (!request.url.startsWith('http')) {\n      return originalFetch(input, init);\n    }\n\n    // Skip if no active config (not initialized yet)\n    const config = getActiveConfig();\n    if (!config) {\n      return originalFetch(input, init);\n    }\n\n    const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n    const url = new URL(request.url);\n    const spanName = `${request.method} ${url.host}`;\n\n    return tracer.startActiveSpan(\n      spanName,\n      {\n        kind: SpanKind.CLIENT,\n        attributes: gatherRequestAttributes(request),\n      },\n      async (span) => {\n        try {\n          // Inject trace context into request headers for distributed tracing\n          const shouldIncludeContext =\n            typeof config.fetch?.includeTraceContext === 'function'\n              ? config.fetch.includeTraceContext(request)\n              : (config.fetch?.includeTraceContext ?? true);\n\n          if (shouldIncludeContext) {\n            propagation.inject(api_context.active(), request.headers, {\n              set: (headers, key, value) => {\n                if (typeof value === 'string') {\n                  headers.set(key, value);\n                }\n              },\n            });\n          }\n\n          // Make the actual fetch call\n          const response = await originalFetch(request);\n\n          // Add response attributes\n          span.setAttributes(gatherResponseAttributes(response));\n\n          // Set span status based on response\n          if (response.ok) {\n            span.setStatus({ code: SpanStatusCode.OK });\n          } else {\n            span.setStatus({ code: SpanStatusCode.ERROR });\n          }\n\n          return response;\n        } catch (error) {\n          span.recordException(error as Error);\n          span.setStatus({\n            code: SpanStatusCode.ERROR,\n            message: error instanceof Error ? error.message : String(error),\n          });\n          throw error;\n        } finally {\n          span.end();\n        }\n      },\n    );\n  };\n\n  // Replace global fetch\n  globalThis.fetch = instrumentedFetch as typeof fetch;\n}\n","/**\n * Global Cache API instrumentation for Cloudflare Workers\n *\n * Automatically traces cache operations:\n * - cache.match() - Read from cache\n * - cache.put() - Write to cache\n * - cache.delete() - Delete from cache\n */\n\nimport { trace, SpanStatusCode, SpanKind } from '@opentelemetry/api';\nimport { wrap } from '../bindings/common';\nimport { WorkerTracer } from 'autotel-edge';\n\ntype CacheOperation = 'match' | 'put' | 'delete';\n\n/**\n * Sanitize URL for span attributes (remove query params that might contain sensitive data)\n */\nfunction sanitizeURL(url: string): string {\n  const u = new URL(url);\n  return `${u.protocol}//${u.host}${u.pathname}`;\n}\n\n/**\n * Instrument a cache method (match, put, delete)\n */\nfunction instrumentCacheMethod<T extends Function>(\n  fn: T,\n  cacheName: string,\n  operation: CacheOperation,\n): T {\n  const handler: ProxyHandler<T> = {\n    async apply(target, thisArg, argArray) {\n      const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n      // Extract URL from first argument (Request or string)\n      const firstArg = argArray[0];\n      const url =\n        firstArg instanceof Request\n          ? firstArg.url\n          : typeof firstArg === 'string'\n            ? firstArg\n            : undefined;\n\n      const spanName = `Cache ${cacheName}.${operation}`;\n\n      return tracer.startActiveSpan(\n        spanName,\n        {\n          kind: SpanKind.CLIENT,\n          attributes: {\n            'cache.name': cacheName,\n            'cache.operation': operation,\n            'cache.key': url ? sanitizeURL(url) : undefined,\n          },\n        },\n        async (span) => {\n          try {\n            const result = await Reflect.apply(target, thisArg, argArray);\n\n            // For match operations, record whether it was a hit or miss\n            if (operation === 'match') {\n              span.setAttribute('cache.hit', !!result);\n            }\n\n            span.setStatus({ code: SpanStatusCode.OK });\n            return result;\n          } catch (error) {\n            span.recordException(error as Error);\n            span.setStatus({\n              code: SpanStatusCode.ERROR,\n              message: error instanceof Error ? error.message : String(error),\n            });\n            throw error;\n          } finally {\n            span.end();\n          }\n        },\n      );\n    },\n  };\n\n  return wrap(fn, handler);\n}\n\n/**\n * Instrument a Cache instance\n */\nfunction instrumentCache(cache: Cache, cacheName: string): Cache {\n  const handler: ProxyHandler<Cache> = {\n    get(target, prop) {\n      const value = Reflect.get(target, prop);\n\n      // Instrument the cache operation methods\n      if (\n        (prop === 'match' || prop === 'put' || prop === 'delete') &&\n        typeof value === 'function'\n      ) {\n        return instrumentCacheMethod(\n          value.bind(target),\n          cacheName,\n          prop as CacheOperation,\n        );\n      }\n\n      // Bind other methods to preserve `this` context\n      if (typeof value === 'function') {\n        return value.bind(target);\n      }\n\n      return value;\n    },\n  };\n\n  return wrap(cache, handler);\n}\n\n/**\n * Instrument caches.open()\n */\nfunction instrumentCachesOpen(\n  openFn: CacheStorage['open'],\n): CacheStorage['open'] {\n  const handler: ProxyHandler<CacheStorage['open']> = {\n    async apply(target, thisArg, argArray) {\n      const cacheName = argArray[0];\n      const cache = await Reflect.apply(target, thisArg, argArray);\n      return instrumentCache(cache, cacheName);\n    },\n  };\n\n  return wrap(openFn, handler);\n}\n\n/**\n * Instrument the global caches API\n *\n * This wraps globalThis.caches to automatically create spans for all cache operations.\n *\n * **Note:** This is called automatically when the library is initialized with\n * `instrumentation.instrumentGlobalCache: true` (default).\n */\nexport function instrumentGlobalCache(): void {\n  const handler: ProxyHandler<typeof caches> = {\n    get(target, prop) {\n      if (prop === 'default') {\n        // Wrap the default cache\n        return instrumentCache(target.default, 'default');\n      } else if (prop === 'open') {\n        // Wrap the open method\n        const openFn = Reflect.get(target, prop);\n        if (typeof openFn === 'function') {\n          return instrumentCachesOpen(openFn.bind(target));\n        }\n      }\n\n      return Reflect.get(target, prop);\n    },\n  };\n\n  // Replace global caches\n  // @ts-ignore - TypeScript doesn't like reassigning globalThis.caches\n  globalThis.caches = wrap(caches, handler);\n}\n","/**\n * Handler instrumentation for Cloudflare Workers\n * \n * Note: This file uses Cloudflare Workers types (ExportedHandler, Request, Response, etc.)\n * which are globally available via @cloudflare/workers-types when listed in tsconfig.json.\n * These types are devDependencies only - they're not runtime dependencies.\n * At runtime, Cloudflare Workers runtime provides the actual implementations.\n * \n * Provides automatic OpenTelemetry tracing for:\n * - HTTP handlers (fetch)\n * - Scheduled/cron handlers\n * - Queue handlers (with message tracking)\n * - Email handlers\n * - Auto-instrumentation of Cloudflare bindings (KV, R2, D1, Service Bindings)\n * - Global fetch and cache instrumentation\n * - Post-processor support for span customization\n * - Tail sampling support\n * - Cold start tracking\n */\n\nimport {\n  trace,\n  context as api_context,\n  propagation,\n  SpanStatusCode,\n  SpanKind,\n} from '@opentelemetry/api';\nimport { resourceFromAttributes } from '@opentelemetry/resources';\nimport type {\n  ConfigurationOption,\n  ResolvedEdgeConfig,\n  Trigger,\n  HandlerInstrumentation,\n  InitialSpanInfo,\n  ReadableSpan,\n  RouteServiceConfig,\n} from 'autotel-edge';\nimport {\n  createInitialiser,\n  setConfig,\n  getActiveConfig,\n  getServiceForPath,\n  shouldInstrumentPath,\n  withNativeTracer,\n  ensureGlobalContextManager,\n  type Initialiser,\n  type NativeTracer,\n  WorkerTracerProvider,\n  WorkerTracer,\n} from 'autotel-edge';\nimport { getNativeTracerFromCtx } from '../native/native-tracing';\nimport { proxyExecutionContext, unwrap, wrap, type PromiseTracker } from '../bindings/common';\nimport { instrumentGlobalFetch } from '../global/fetch';\nimport { instrumentGlobalCache } from '../global/cache';\nimport { instrumentBindings } from '../bindings/bindings';\nimport type { Attributes, Span, TextMapGetter } from '@opentelemetry/api';\n\n// Web API Headers objects require .get() — property access via defaultTextMapGetter won't work\nconst headersGetter: TextMapGetter<Headers> = {\n  get: (carrier, key) => carrier.get(key) ?? undefined,\n  keys: (carrier) => [...carrier.keys()],\n};\n\ntype FetchHandler = (\n  request: Request,\n  env: any,\n  ctx: ExecutionContext,\n) => Response | Promise<Response>;\n\ntype ScheduledHandler = (\n  event: ScheduledController,\n  env: any,\n  ctx: ExecutionContext,\n) => void | Promise<void>;\n\ntype QueueHandler = (\n  batch: MessageBatch,\n  env: any,\n  ctx: ExecutionContext,\n) => void | Promise<void>;\n\ntype EmailHandler = (\n  message: ForwardableEmailMessage,\n  env: any,\n  ctx: ExecutionContext,\n) => void | Promise<void>;\n\n/**\n * Create fetch handler instrumentation with config support for postProcess\n */\n/**\n * Extract Cloudflare-specific attributes from a request\n */\nfunction extractCfAttributes(request: Request): Record<string, string | number | boolean> {\n  const cf = (request as any).cf;\n  if (!cf) return {};\n\n  const attrs: Record<string, string | number | boolean> = {};\n  const set = (key: string, value: unknown) => {\n    if (value !== undefined && value !== null) {\n      attrs[key] = value as string | number | boolean;\n    }\n  };\n\n  set('cloudflare.colo', cf.colo);\n  const ray = request.headers.get('cf-ray');\n  if (ray) attrs['cloudflare.ray_id'] = ray;\n  set('cloudflare.country', cf.country);\n  set('cloudflare.city', cf.city);\n  set('cloudflare.region', cf.region);\n  set('cloudflare.continent', cf.continent);\n  set('cloudflare.timezone', cf.timezone);\n  set('cloudflare.latitude', cf.latitude);\n  set('cloudflare.longitude', cf.longitude);\n  set('cloudflare.asn', cf.asn);\n  set('cloudflare.as_organization', cf.asOrganization);\n  set('cloudflare.http_protocol', cf.httpProtocol);\n  set('cloudflare.tls_version', cf.tlsVersion);\n  set('cloudflare.client_tcp_rtt', cf.clientTcpRtt);\n\n  return attrs;\n}\n\nfunction createFetchInstrumentation(\n  config: ResolvedEdgeConfig,\n): HandlerInstrumentation<Request, Response> {\n  return {\n    getInitialSpanInfo: (request: Request): InitialSpanInfo => {\n      const url = new URL(request.url);\n      const routeService = getServiceForPath(\n        url.pathname,\n        config.handlers.fetch.routes as Record<string, RouteServiceConfig> | undefined,\n      );\n\n      const cfAttrs = (config as any).extractCfAttributes === false\n        ? {}\n        : extractCfAttributes(request);\n\n      return {\n        name: `${request.method} ${url.pathname}`,\n        options: {\n          kind: SpanKind.SERVER,\n          attributes: {\n            'http.request.method': request.method,\n            'url.full': request.url,\n            ...(routeService ? { 'service.name': routeService, 'autotel.route.service': routeService } : {}),\n            ...cfAttrs,\n          },\n        },\n        context: propagation.extract(api_context.active(), request.headers, headersGetter),\n      };\n    },\n    getAttributesFromResult: (response: Response) => ({\n      'http.response.status_code': response.status,\n    }),\n    executionSucces: (span: Span, trigger: Request, result: Response) => {\n      // Override span status for server errors (5xx)\n      if (result.status >= 500) {\n        span.setStatus({ code: SpanStatusCode.ERROR });\n      }\n\n      // Call postProcess callback if configured\n      if (config.handlers.fetch.postProcess) {\n        const readableSpan = span as unknown as ReadableSpan;\n        config.handlers.fetch.postProcess(span, {\n          request: trigger,\n          response: result,\n          readable: readableSpan,\n        });\n      }\n    },\n  };\n}\n\n/**\n * Scheduled handler instrumentation\n */\nconst scheduledInstrumentation: HandlerInstrumentation<ScheduledController, void> = {\n  getInitialSpanInfo: (event: ScheduledController): InitialSpanInfo => {\n    return {\n      name: `scheduledHandler ${event.cron || 'unknown'}`,\n      options: {\n        kind: SpanKind.INTERNAL,\n        attributes: {\n          'faas.trigger': 'timer',\n          'faas.cron': event.cron || 'unknown',\n          'faas.scheduled_time': new Date(event.scheduledTime).toISOString(),\n        },\n      },\n    };\n  },\n};\n\n/**\n * Tracks message status counts for queue processing\n */\nclass MessageStatusCount {\n  succeeded = 0;\n  failed = 0;\n  implicitly_acked = 0;\n  implicitly_retried = 0;\n  readonly total: number;\n\n  constructor(total: number) {\n    this.total = total;\n  }\n\n  ack() {\n    this.succeeded = this.succeeded + 1;\n  }\n\n  ackRemaining() {\n    this.implicitly_acked = this.total - this.succeeded - this.failed;\n    this.succeeded = this.total - this.failed;\n  }\n\n  retry() {\n    this.failed = this.failed + 1;\n  }\n\n  retryRemaining() {\n    this.implicitly_retried = this.total - this.succeeded - this.failed;\n    this.failed = this.total - this.succeeded;\n  }\n\n  toAttributes(): Attributes {\n    return {\n      'queue.messages_count': this.total,\n      'queue.messages_success': this.succeeded,\n      'queue.messages_failed': this.failed,\n      'queue.batch_success': this.succeeded === this.total,\n      'queue.implicitly_acked': this.implicitly_acked,\n      'queue.implicitly_retried': this.implicitly_retried,\n    };\n  }\n}\n\n/**\n * Add event to active span\n */\nfunction addQueueEvent(name: string, msg?: Message, delaySeconds?: number) {\n  const attrs: Attributes = {};\n  if (msg) {\n    attrs['queue.message_id'] = msg.id;\n    attrs['queue.message_timestamp'] = msg.timestamp.toISOString();\n    // Add attempts if available (from Cloudflare Queues API)\n    if ('attempts' in msg && typeof msg.attempts === 'number') {\n      attrs['queue.message_attempts'] = msg.attempts;\n    }\n  }\n  if (delaySeconds !== undefined) {\n    attrs['queue.retry_delay_seconds'] = delaySeconds;\n  }\n  trace.getActiveSpan()?.addEvent(name, attrs);\n}\n\n/**\n * Proxy a queue message to track ack/retry operations\n */\nfunction proxyQueueMessage<Q>(msg: Message<Q>, count: MessageStatusCount): Message<Q> {\n  const msgHandler: ProxyHandler<Message<Q>> = {\n    get: (target, prop) => {\n      if (prop === 'ack') {\n        const ackFn = Reflect.get(target, prop);\n        return new Proxy(ackFn, {\n          apply: (fnTarget) => {\n            addQueueEvent('messageAck', msg);\n            count.ack();\n            Reflect.apply(fnTarget, msg, []);\n          },\n        });\n      } else if (prop === 'retry') {\n        const retryFn = Reflect.get(target, prop);\n        return new Proxy(retryFn, {\n          apply: (fnTarget, _thisArg, args) => {\n            // Extract delay and content type from retry options if provided\n            const retryOptions = args[0] as\n              | { delaySeconds?: number; contentType?: string }\n              | undefined;\n            const delaySeconds = retryOptions?.delaySeconds;\n\n            addQueueEvent('messageRetry', msg, delaySeconds);\n\n            // Add content type attribute if provided\n            if (retryOptions?.contentType) {\n              const span = trace.getActiveSpan();\n              if (span) {\n                span.setAttribute('queue.message.content_type', retryOptions.contentType);\n              }\n            }\n\n            count.retry();\n            const result = Reflect.apply(fnTarget, msg, args);\n            return result;\n          },\n        });\n      } else {\n        return Reflect.get(target, prop, msg);\n      }\n    },\n  };\n  return wrap(msg, msgHandler);\n}\n\n/**\n * Proxy MessageBatch to track ackAll/retryAll operations\n */\nfunction proxyMessageBatch(batch: MessageBatch, count: MessageStatusCount): MessageBatch {\n  const batchHandler: ProxyHandler<MessageBatch> = {\n    get: (target, prop) => {\n      if (prop === 'messages') {\n        const messages = Reflect.get(target, prop);\n        const messagesHandler: ProxyHandler<MessageBatch['messages']> = {\n          get: (target, prop) => {\n            if (typeof prop === 'string' && !isNaN(parseInt(prop))) {\n              const message = Reflect.get(target, prop);\n              return proxyQueueMessage(message, count);\n            } else {\n              return Reflect.get(target, prop);\n            }\n          },\n        };\n        return wrap(messages, messagesHandler);\n      } else if (prop === 'ackAll') {\n        const ackFn = Reflect.get(target, prop);\n        return new Proxy(ackFn, {\n          apply: (fnTarget) => {\n            addQueueEvent('ackAll');\n            count.ackRemaining();\n            Reflect.apply(fnTarget, batch, []);\n          },\n        });\n      } else if (prop === 'retryAll') {\n        const retryFn = Reflect.get(target, prop);\n        return new Proxy(retryFn, {\n          apply: (fnTarget, _thisArg, args) => {\n            // Extract delay from retryAll options if provided\n            const retryOptions = args[0] as { delaySeconds?: number } | undefined;\n            const delaySeconds = retryOptions?.delaySeconds;\n\n            addQueueEvent('retryAll', undefined, delaySeconds);\n            count.retryRemaining();\n            Reflect.apply(fnTarget, batch, args);\n          },\n        });\n      }\n      return Reflect.get(target, prop);\n    },\n  };\n  return wrap(batch, batchHandler);\n}\n\n/**\n * Queue handler instrumentation with message tracking\n */\nclass QueueInstrumentation implements HandlerInstrumentation<MessageBatch, void> {\n  private count?: MessageStatusCount;\n\n  getInitialSpanInfo(batch: MessageBatch): InitialSpanInfo {\n    return {\n      name: `queueHandler ${batch.queue || 'unknown'}`,\n      options: {\n        kind: SpanKind.CONSUMER,\n        attributes: {\n          'faas.trigger': 'pubsub',\n          'queue.name': batch.queue || 'unknown',\n        },\n      },\n    };\n  }\n\n  instrumentTrigger(batch: MessageBatch): MessageBatch {\n    this.count = new MessageStatusCount(batch.messages.length);\n    return proxyMessageBatch(batch, this.count);\n  }\n\n  executionSucces(span: Span, _trigger: MessageBatch, _result: void) {\n    if (this.count) {\n      this.count.ackRemaining();\n      span.setAttributes(this.count.toAttributes());\n    }\n  }\n\n  executionFailed(span: Span, _trigger: MessageBatch, _error?: any) {\n    if (this.count) {\n      this.count.retryRemaining();\n      span.setAttributes(this.count.toAttributes());\n    }\n  }\n}\n\n/**\n * Converts email headers into OpenTelemetry attributes.\n * When dataSafety.emailHeaderAllowlist is configured, only allowed headers are captured.\n */\nfunction headerAttributes(message: { headers: Headers }): Record<string, string> {\n  const attrs: Record<string, string> = {};\n  if (message.headers instanceof Headers) {\n    const config = getActiveConfig();\n    const allowlist: string[] | undefined = config?.dataSafety?.emailHeaderAllowlist;\n    for (const [key, value] of message.headers.entries()) {\n      if (allowlist && !allowlist.includes(key.toLowerCase())) {\n        continue;\n      }\n      attrs[`email.header.${key}`] = value;\n    }\n  }\n  return attrs;\n}\n\n/**\n * Email handler instrumentation\n */\nconst emailInstrumentation: HandlerInstrumentation<ForwardableEmailMessage, void> = {\n  getInitialSpanInfo: (message: ForwardableEmailMessage): InitialSpanInfo => {\n    const attributes: Record<string, string> = {\n      'faas.trigger': 'other',\n      'messaging.destination.name': message.to || 'unknown',\n    };\n\n    // Add message ID if available\n    if ('headers' in message && message.headers instanceof Headers) {\n      const messageId = message.headers.get('Message-Id');\n      if (messageId) {\n        attributes['rpc.message.id'] = messageId;\n      }\n      // Add all headers as attributes\n      Object.assign(attributes, headerAttributes(message));\n    }\n\n    return {\n      name: `emailHandler ${message.to || 'unknown'}`,\n      options: {\n        kind: SpanKind.CONSUMER,\n        attributes,\n      },\n    };\n  },\n};\n\n\n/**\n * Export spans after request completes\n */\nasync function exportSpans(\n  traceId: string,\n  tracker: PromiseTracker | undefined,\n  ctx: ExecutionContext,\n) {\n  const tracer = trace.getTracer('autotel-edge');\n  if (tracer instanceof WorkerTracer) {\n    try {\n      // scheduler is available on ExecutionContext at runtime\n      const ctxWithScheduler = ctx as ExecutionContext & { scheduler?: { wait(ms: number): Promise<void> } };\n      if (ctxWithScheduler.scheduler) {\n        await ctxWithScheduler.scheduler.wait(1);\n      }\n      await tracker?.wait();\n      await tracer.forceFlush(traceId);\n    } catch (error) {\n      // Silently handle exporter errors to prevent worker crashes\n      // Exporter failures should not affect the worker's ability to process requests\n      // In production, consider logging to a monitoring service\n      console.error('[autotel-edge] Failed to export spans:', error);\n    }\n  }\n}\n\n/**\n * Create handler flow with instrumentation\n */\nfunction createHandlerFlow<T extends Trigger, E, R>(\n  instrumentation: HandlerInstrumentation<T, R>,\n) {\n  return (\n    handlerFn: (trigger: T, env: E, ctx: ExecutionContext) => R | Promise<R>,\n    [trigger, env, context]: [T, E, ExecutionContext],\n  ) => {\n    const { ctx: proxiedCtx, tracker } = proxyExecutionContext(context);\n\n    const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n    const { name, options, context: spanContext } =\n      instrumentation.getInitialSpanInfo(trigger);\n\n    // Add cold start tracking\n    if (options.attributes) {\n      options.attributes['faas.coldstart'] = coldStart;\n    } else {\n      options.attributes = { 'faas.coldstart': coldStart };\n    }\n    coldStart = false;\n\n    const parentContext = spanContext || api_context.active();\n\n    // Instrument trigger if supported (e.g., for queue handler)\n    const instrumentedTrigger = instrumentation.instrumentTrigger\n      ? instrumentation.instrumentTrigger(trigger)\n      : trigger;\n\n    return tracer.startActiveSpan(name, options, parentContext, async (span) => {\n      try {\n        const result = await handlerFn(instrumentedTrigger, env, proxiedCtx);\n\n        if (instrumentation.getAttributesFromResult) {\n          const attributes = instrumentation.getAttributesFromResult(result);\n          span.setAttributes(attributes);\n        }\n\n        // Set default OK status; executionSucces may override (e.g. HTTP 5xx)\n        span.setStatus({ code: SpanStatusCode.OK });\n\n        if (instrumentation.executionSucces) {\n          instrumentation.executionSucces(span, trigger, result);\n        }\n        return result;\n      } catch (error) {\n        span.recordException(error as Error);\n        span.setStatus({\n          code: SpanStatusCode.ERROR,\n          message: error instanceof Error ? error.message : String(error),\n        });\n        if (instrumentation.executionFailed) {\n          instrumentation.executionFailed(span, trigger, error);\n        }\n        throw error;\n      } finally {\n        span.end();\n        context.waitUntil(exportSpans(span.spanContext().traceId, tracker, context));\n      }\n    });\n  };\n}\n\nlet warnedMissingNative = false;\n\n/**\n * Resolve whether this invocation should use Cloudflare's native tracer.\n *\n * - `nativeTracing: 'off'` → never use native (always autotel's OTLP pipeline).\n * - `nativeTracing: 'on'`  → require native; warn once and fall back if absent.\n * - `nativeTracing: 'auto'` (default) → use native when `ctx.tracing` exists.\n */\nfunction resolveNativeTracer(\n  config: ResolvedEdgeConfig,\n  ctx: ExecutionContext,\n  trigger: Trigger,\n): NativeTracer | null {\n  const mode = config.nativeTracing ?? 'auto';\n  if (mode === 'off') {\n    return null;\n  }\n  // Correlation id: prefer Cloudflare's ray id (also stamped on the native root\n  // span + carried by the workers logger), so logs/spans/dashboard share a key.\n  // Fall back to a per-invocation uuid for non-fetch triggers.\n  const rayId = trigger instanceof Request ? trigger.headers.get('cf-ray') : null;\n  const correlationId = rayId ?? crypto.randomUUID();\n  const nativeTracer = getNativeTracerFromCtx(ctx, correlationId);\n  if (!nativeTracer && mode === 'on' && !warnedMissingNative) {\n    warnedMissingNative = true;\n    console.warn(\n      \"[autotel-cloudflare] nativeTracing is 'on' but Cloudflare native tracing was not detected. \" +\n        'Enable observability.traces in your Wrangler config (and use a recent compatibility_date). ' +\n        'Falling back to the autotel OTLP exporter.',\n    );\n  }\n  return nativeTracer;\n}\n\n/**\n * Run a handler in native-tracing mode.\n *\n * Cloudflare already creates the root handler span and instruments platform\n * operations (fetch / KV / R2 / D1 / DO), so autotel defers entirely: no\n * binding proxies (avoids duplicate spans), no provider/exporter, no manual\n * flush. We install the native tracer into the active context so that the\n * user's `span()` / `trace()` / `enterSpan()` calls nest inside Cloudflare's\n * native waterfall and are exported by the platform.\n */\nfunction runWithNativeTracing<T extends Trigger, E, R>(\n  handlerFn: (trigger: T, env: E, ctx: ExecutionContext) => R | Promise<R>,\n  trigger: T,\n  env: E,\n  ctx: ExecutionContext,\n  config: ResolvedEdgeConfig,\n  nativeTracer: NativeTracer,\n): R | Promise<R> {\n  // Register the context manager (we skip initProvider in native mode) so the\n  // native tracer propagates through OTel context into span()/trace() — without\n  // it, getActiveNativeTracer() returns null and custom spans never route to\n  // enterSpan. Bindings are NOT proxied: Cloudflare instruments them natively.\n  ensureGlobalContextManager();\n  const nativeContext = withNativeTracer(nativeTracer, setConfig(config));\n  return api_context.with(nativeContext, () => handlerFn(trigger, env, ctx));\n}\n\n/**\n * Create handler proxy\n */\nfunction createHandlerProxy<T extends Trigger, E, R>(\n  _handler: unknown,\n  handlerFn: (trigger: T, env: E, ctx: ExecutionContext) => R | Promise<R>,\n  initialiser: Initialiser,\n  instrumentation: HandlerInstrumentation<T, R>,\n): (trigger: T, env: E, ctx: ExecutionContext) => ReturnType<typeof handlerFn> {\n  return (trigger: T, env: E, ctx: ExecutionContext) => {\n    const config = initialiser(env, trigger);\n\n    // Check if instrumentation is disabled (useful for local dev)\n    if (config.instrumentation.disabled) {\n      // Return handler as-is without instrumentation\n      return handlerFn(trigger, env, ctx);\n    }\n\n    // Prefer Cloudflare native tracing when available — defer to the platform.\n    const nativeTracer = resolveNativeTracer(config, ctx, trigger);\n    if (nativeTracer) {\n      return runWithNativeTracing(handlerFn, trigger, env, ctx, config, nativeTracer);\n    }\n\n    // Auto-instrument Cloudflare bindings in the environment\n    const instrumentedEnv = instrumentBindings(env as Record<string, any>) as E;\n\n    const configContext = setConfig(config);\n\n    // Initialize provider on first call\n    initProvider(config);\n\n    const flowFn = createHandlerFlow<T, E, R>(instrumentation);\n\n    // Execute the handler flow within the config context\n    return api_context.with(configContext, () => {\n      return flowFn(handlerFn, [trigger, instrumentedEnv, ctx]) as ReturnType<typeof handlerFn>;\n    });\n  };\n}\n\n/**\n * Create handler proxy with dynamic instrumentation (for fetch with postProcess)\n */\nfunction createHandlerProxyWithConfig<T extends Trigger, E, R>(\n  _handler: unknown,\n  handlerFn: (trigger: T, env: E, ctx: ExecutionContext) => R | Promise<R>,\n  initialiser: Initialiser,\n  createInstrumentation: (config: ResolvedEdgeConfig) => HandlerInstrumentation<T, R>,\n): (trigger: T, env: E, ctx: ExecutionContext) => ReturnType<typeof handlerFn> {\n  return (trigger: T, env: E, ctx: ExecutionContext) => {\n    const config = initialiser(env, trigger);\n    \n    // Check if instrumentation is disabled (useful for local dev)\n    if (config.instrumentation.disabled) {\n      // Return handler as-is without instrumentation\n      return handlerFn(trigger, env, ctx);\n    }\n\n    if (trigger instanceof Request) {\n      const pathname = new URL(trigger.url).pathname;\n      const fetchCfg = config.handlers.fetch;\n      if (\n        !shouldInstrumentPath(pathname, {\n          include: fetchCfg.include,\n          exclude: fetchCfg.exclude,\n        })\n      ) {\n        return handlerFn(trigger, env, ctx) as ReturnType<typeof handlerFn>;\n      }\n    }\n\n    // Prefer Cloudflare native tracing when available — defer to the platform.\n    const nativeTracer = resolveNativeTracer(config, ctx, trigger);\n    if (nativeTracer) {\n      return runWithNativeTracing(handlerFn, trigger, env, ctx, config, nativeTracer) as ReturnType<typeof handlerFn>;\n    }\n\n    // Auto-instrument Cloudflare bindings in the environment\n    const instrumentedEnv = instrumentBindings(env as Record<string, any>) as E;\n\n    const configContext = setConfig(config);\n\n    // Initialize provider on first call\n    initProvider(config);\n\n    // Create instrumentation with config\n    const instrumentation = createInstrumentation(config);\n    const flowFn = createHandlerFlow<T, E, R>(instrumentation);\n\n    // Execute the handler flow within the config context\n    return api_context.with(configContext, () => {\n      return flowFn(handlerFn, [trigger, instrumentedEnv, ctx]) as ReturnType<typeof handlerFn>;\n    });\n  };\n}\n\nlet providerInitialized = false;\nlet coldStart = true;\n\n/**\n * Initialize the tracer provider\n */\nfunction initProvider(config: ResolvedEdgeConfig): void {\n  if (providerInitialized) return;\n\n  // Install global instrumentations\n  if (config.instrumentation.instrumentGlobalFetch) {\n    instrumentGlobalFetch();\n  }\n  if (config.instrumentation.instrumentGlobalCache) {\n    instrumentGlobalCache();\n  }\n\n  // Set up propagator\n  propagation.setGlobalPropagator(config.propagator);\n\n  // Create resource\n  const resource = resourceFromAttributes({\n    'service.name': config.service.name,\n    'service.version': config.service.version,\n    'service.namespace': config.service.namespace,\n    'cloud.provider': 'cloudflare',\n    'cloud.platform': 'cloudflare.workers',\n    'telemetry.sdk.name': 'autotel-edge',\n    'telemetry.sdk.language': 'js',\n  });\n\n  // Create and register provider\n  const provider = new WorkerTracerProvider(config.spanProcessors, resource);\n  provider.register();\n\n  // Set head sampler on tracer\n  const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n  tracer.setHeadSampler(config.sampling.headSampler);\n\n  providerInitialized = true;\n}\n\n/**\n * Instrument a Cloudflare Workers handler\n *\n * @example\n * ```typescript\n * import { instrument } from 'autotel-edge'\n *\n * const handler = {\n *   async fetch(request, env, ctx) {\n *     return new Response('Hello World')\n *   }\n * }\n *\n * export default instrument(handler, {\n *   exporter: {\n *     url: env.OTLP_ENDPOINT,\n *     headers: { 'x-api-key': env.API_KEY }\n *   },\n *   service: { name: 'my-worker' }\n * })\n * ```\n */\nexport function instrument<E, Q = any, C = any>(\n  handler: ExportedHandler<E, Q, C>,\n  config: ConfigurationOption,\n): ExportedHandler<E, Q, C> {\n  const initialiser = createInitialiser(config);\n\n  if (handler.fetch) {\n    const fetcher = unwrap(handler.fetch) as FetchHandler;\n    // Create fetch instrumentation with config support\n    handler.fetch = createHandlerProxyWithConfig(\n      handler,\n      fetcher,\n      initialiser,\n      createFetchInstrumentation,\n    );\n  }\n\n  if (handler.scheduled) {\n    const scheduled = unwrap(handler.scheduled) as ScheduledHandler;\n    handler.scheduled = createHandlerProxy(\n      handler,\n      scheduled,\n      initialiser,\n      scheduledInstrumentation,\n    );\n  }\n\n  if (handler.queue) {\n    const queue = unwrap(handler.queue) as QueueHandler;\n    handler.queue = createHandlerProxy(\n      handler,\n      queue,\n      initialiser,\n      new QueueInstrumentation(),\n    );\n  }\n\n  if (handler.email) {\n    const email = unwrap(handler.email) as EmailHandler;\n    handler.email = createHandlerProxy(\n      handler,\n      email,\n      initialiser,\n      emailInstrumentation,\n    );\n  }\n\n  return handler;\n}\n","/**\n * workers-honeycomb-logger style wrapper API\n *\n * @example\n * ```typescript\n * import { wrapModule } from 'autotel-cloudflare'\n *\n * const handler = {\n *   async fetch(req, env, ctx) {\n *     return new Response('Hello')\n *   }\n * }\n *\n * export default wrapModule(\n *   { service: { name: 'my-worker' } },\n *   handler\n * )\n * ```\n */\n\nimport { instrument } from './instrument';\nimport type { ConfigurationOption } from 'autotel-edge';\n\n/**\n * Wrap a Cloudflare Workers module-style handler\n * Alternative API style inspired by workers-honeycomb-logger\n *\n * @param config Configuration (can be static object or function)\n * @param handler The worker handler to wrap\n * @returns Instrumented handler\n */\nexport function wrapModule<E, Q = any, C = any>(\n  config: ConfigurationOption,\n  handler: ExportedHandler<E, Q, C>,\n): ExportedHandler<E, Q, C> {\n  return instrument(handler, config);\n}\n","/**\n * Durable Object wrapper\n *\n * @example\n * ```typescript\n * import { wrapDurableObject } from 'autotel-cloudflare'\n *\n * class Counter implements DurableObject {\n *   async fetch(request: Request) {\n *     return new Response('count')\n *   }\n * }\n *\n * export default wrapDurableObject({ service: { name: 'counter-do' } }, Counter)\n * ```\n */\n\nimport { instrumentDO } from '../handlers/durable-objects';\nimport type { ConfigurationOption } from 'autotel-edge';\n\n/**\n * Wrap a Durable Object class with instrumentation\n * Alternative API style inspired by workers-honeycomb-logger\n *\n * @param config Configuration (can be static object or function)\n * @param doClass The Durable Object class to wrap\n * @returns Instrumented Durable Object class\n */\nexport function wrapDurableObject<T extends DurableObject>(\n  config: ConfigurationOption,\n  doClass: new (state: DurableObjectState, env: any) => T,\n): new (state: DurableObjectState, env: any) => T {\n  return instrumentDO(doClass, config);\n}\n","/**\n * Ergonomic wrapper for Cloudflare Workers `fetch` handlers.\n *\n * `defineWorkerFetch` instruments the handler the same way `instrument()` does\n * (so span exports already flush via `ctx.waitUntil`), and additionally injects\n * a request-scoped `ExecutionLogger` as the fourth argument — pre-populated\n * with method, path, cf-ray and `request.cf` context.\n *\n * Use this instead of `wrapModule` / `instrument` when your handler wants the\n * logger handed in directly rather than reaching for `getRequestLogger()`.\n *\n * @example\n * ```ts\n * import { defineWorkerFetch } from 'autotel-cloudflare'\n *\n * export default defineWorkerFetch(\n *   { service: { name: 'my-worker' } },\n *   async (request, env, ctx, log) => {\n *     log.set({ route: '/health' })\n *     log.emitNow({ status: 200 })\n *     return new Response('ok')\n *   },\n * )\n * ```\n */\nimport type { ConfigurationOption } from 'autotel-edge';\nimport { instrument } from './instrument';\nimport { createWorkersLogger, type WorkersLoggerOptions } from '../execution-logger';\nimport type { ExecutionLogger } from '../execution-logger';\n\nexport type DefineWorkerFetchOptions = WorkersLoggerOptions;\n\nexport type WorkerFetchHandler<E> = (\n  request: Request,\n  env: E,\n  ctx: ExecutionContext,\n  log: ExecutionLogger,\n) => Response | Promise<Response>;\n\n/**\n * Wrap a Workers fetch handler so:\n *   - the handler is instrumented (spans, propagation, waitUntil export flush)\n *   - the handler receives a request-scoped logger as its fourth argument\n */\nexport function defineWorkerFetch<E = unknown>(\n  config: ConfigurationOption,\n  handler: WorkerFetchHandler<E>,\n  loggerOptions: DefineWorkerFetchOptions = {},\n): { fetch: (request: Request, env: E, ctx: ExecutionContext) => Promise<Response> } {\n  const wrapped = instrument(\n    {\n      fetch(request: Request, env: E, ctx: ExecutionContext) {\n        const log = createWorkersLogger(request, loggerOptions);\n        return handler(request, env, ctx, log);\n      },\n    },\n    config,\n  );\n\n  return {\n    fetch(request, env, ctx) {\n      return Promise.resolve(\n        (wrapped.fetch as unknown as (\n          req: Request,\n          env: E,\n          ctx: ExecutionContext,\n        ) => Response | Promise<Response>)(request, env, ctx),\n      );\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAS,wBAAwB,SAAuC;CACtE,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;CAE/B,MAAM,cADS,gBACU,CAAC,EAAE,YAAY,sBAAsB;CAE9D,OAAO;EACL,uBAAuB,QAAQ,OAAO,YAAY;EAClD,YAAY,cAAc,GAAG,IAAI,SAAS,IAAI,aAAa,QAAQ;EACnE,cAAc,IAAI,SAAS,QAAQ,KAAK,EAAE;EAC1C,kBAAkB,IAAI;EACtB,YAAY,IAAI;EAChB,aAAa,cAAe,IAAI,SAAS,eAAe,KAAM,IAAI;EAClE,yBAAyB;EACzB,uBAAuB,QAAQ,QAAQ,IAAI,YAAY,KAAK;CAC9D;AACF;;;;AAKA,SAAS,yBAAyB,UAAyC;CACzE,OAAO;EACL,6BAA6B,SAAS;EACtC,2BAA2B,SAAS,QAAQ,IAAI,gBAAgB,KAAK;CACvE;AACF;;;;;;;;;AAUA,SAAgB,wBAA8B;CAC5C,MAAM,gBAAgB,WAAW;CA4EjC,WAAW,QAAQ,SA1EgB,MACjC,OACA,MACmB;EACnB,MAAM,UAAU,IAAI,QAAQ,OAAO,IAAI;EAGvC,IAAI,CAAC,QAAQ,IAAI,WAAW,MAAM,GAChC,OAAO,cAAc,OAAO,IAAI;EAIlC,MAAM,SAAS,gBAAgB;EAC/B,IAAI,CAAC,QACH,OAAO,cAAc,OAAO,IAAI;EAGlC,MAAM,SAAS,MAAM,UAAU,cAAc;EAC7C,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;EAC/B,MAAM,WAAW,GAAG,QAAQ,OAAO,GAAG,IAAI;EAE1C,OAAO,OAAO,gBACZ,UACA;GACE,MAAM,SAAS;GACf,YAAY,wBAAwB,OAAO;EAC7C,GACA,OAAO,SAAS;GACd,IAAI;IAOF,IAJE,OAAO,OAAO,OAAO,wBAAwB,aACzC,OAAO,MAAM,oBAAoB,OAAO,IACvC,OAAO,OAAO,uBAAuB,MAG1C,YAAY,OAAOA,QAAY,OAAO,GAAG,QAAQ,SAAS,EACxD,MAAM,SAAS,KAAK,UAAU;KAC5B,IAAI,OAAO,UAAU,UACnB,QAAQ,IAAI,KAAK,KAAK;IAE1B,EACF,CAAC;IAIH,MAAM,WAAW,MAAM,cAAc,OAAO;IAG5C,KAAK,cAAc,yBAAyB,QAAQ,CAAC;IAGrD,IAAI,SAAS,IACX,KAAK,UAAU,EAAE,MAAM,eAAe,GAAG,CAAC;SAE1C,KAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;IAG/C,OAAO;GACT,SAAS,OAAO;IACd,KAAK,gBAAgB,KAAc;IACnC,KAAK,UAAU;KACb,MAAM,eAAe;KACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;IAChE,CAAC;IACD,MAAM;GACR,UAAU;IACR,KAAK,IAAI;GACX;EACF,CACF;CACF;AAIF;;;;;;;;;;;;;;;ACrHA,SAAS,YAAY,KAAqB;CACxC,MAAM,IAAI,IAAI,IAAI,GAAG;CACrB,OAAO,GAAG,EAAE,SAAS,IAAI,EAAE,OAAO,EAAE;AACtC;;;;AAKA,SAAS,sBACP,IACA,WACA,WACG;CAoDH,OAAO,KAAK,IAAI,EAlDd,MAAM,MAAM,QAAQ,SAAS,UAAU;EACrC,MAAM,SAAS,MAAM,UAAU,cAAc;EAG7C,MAAM,WAAW,SAAS;EAC1B,MAAM,MACJ,oBAAoB,UAChB,SAAS,MACT,OAAO,aAAa,WAClB,WACA;EAER,MAAM,WAAW,SAAS,UAAU,GAAG;EAEvC,OAAO,OAAO,gBACZ,UACA;GACE,MAAM,SAAS;GACf,YAAY;IACV,cAAc;IACd,mBAAmB;IACnB,aAAa,MAAM,YAAY,GAAG,IAAI;GACxC;EACF,GACA,OAAO,SAAS;GACd,IAAI;IACF,MAAM,SAAS,MAAM,QAAQ,MAAM,QAAQ,SAAS,QAAQ;IAG5D,IAAI,cAAc,SAChB,KAAK,aAAa,aAAa,CAAC,CAAC,MAAM;IAGzC,KAAK,UAAU,EAAE,MAAM,eAAe,GAAG,CAAC;IAC1C,OAAO;GACT,SAAS,OAAO;IACd,KAAK,gBAAgB,KAAc;IACnC,KAAK,UAAU;KACb,MAAM,eAAe;KACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;IAChE,CAAC;IACD,MAAM;GACR,UAAU;IACR,KAAK,IAAI;GACX;EACF,CACF;CACF,EAGoB,CAAC;AACzB;;;;AAKA,SAAS,gBAAgB,OAAc,WAA0B;CA0B/D,OAAO,KAAK,OAAO,EAxBjB,IAAI,QAAQ,MAAM;EAChB,MAAM,QAAQ,QAAQ,IAAI,QAAQ,IAAI;EAGtC,KACG,SAAS,WAAW,SAAS,SAAS,SAAS,aAChD,OAAO,UAAU,YAEjB,OAAO,sBACL,MAAM,KAAK,MAAM,GACjB,WACA,IACF;EAIF,IAAI,OAAO,UAAU,YACnB,OAAO,MAAM,KAAK,MAAM;EAG1B,OAAO;CACT,EAGuB,CAAC;AAC5B;;;;AAKA,SAAS,qBACP,QACsB;CAStB,OAAO,KAAK,QAAQ,EAPlB,MAAM,MAAM,QAAQ,SAAS,UAAU;EACrC,MAAM,YAAY,SAAS;EAE3B,OAAO,gBAAgB,MADH,QAAQ,MAAM,QAAQ,SAAS,QAAQ,GAC7B,SAAS;CACzC,EAGwB,CAAC;AAC7B;;;;;;;;;AAUA,SAAgB,wBAA8B;CAoB5C,WAAW,SAAS,KAAK,QAAQ,EAlB/B,IAAI,QAAQ,MAAM;EAChB,IAAI,SAAS,WAEX,OAAO,gBAAgB,OAAO,SAAS,SAAS;OAC3C,IAAI,SAAS,QAAQ;GAE1B,MAAM,SAAS,QAAQ,IAAI,QAAQ,IAAI;GACvC,IAAI,OAAO,WAAW,YACpB,OAAO,qBAAqB,OAAO,KAAK,MAAM,CAAC;EAEnD;EAEA,OAAO,QAAQ,IAAI,QAAQ,IAAI;CACjC,EAKqC,CAAC;AAC1C;;;;;;;;;;;;;;;;;;;;;;;ACzGA,MAAM,gBAAwC;CAC5C,MAAM,SAAS,QAAQ,QAAQ,IAAI,GAAG,KAAK;CAC3C,OAAO,YAAY,CAAC,GAAG,QAAQ,KAAK,CAAC;AACvC;;;;;;;AAgCA,SAAS,oBAAoB,SAA6D;CACxF,MAAM,KAAM,QAAgB;CAC5B,IAAI,CAAC,IAAI,OAAO,CAAC;CAEjB,MAAM,QAAmD,CAAC;CAC1D,MAAM,OAAO,KAAa,UAAmB;EAC3C,IAAI,UAAU,UAAa,UAAU,MACnC,MAAM,OAAO;CAEjB;CAEA,IAAI,mBAAmB,GAAG,IAAI;CAC9B,MAAM,MAAM,QAAQ,QAAQ,IAAI,QAAQ;CACxC,IAAI,KAAK,MAAM,uBAAuB;CACtC,IAAI,sBAAsB,GAAG,OAAO;CACpC,IAAI,mBAAmB,GAAG,IAAI;CAC9B,IAAI,qBAAqB,GAAG,MAAM;CAClC,IAAI,wBAAwB,GAAG,SAAS;CACxC,IAAI,uBAAuB,GAAG,QAAQ;CACtC,IAAI,uBAAuB,GAAG,QAAQ;CACtC,IAAI,wBAAwB,GAAG,SAAS;CACxC,IAAI,kBAAkB,GAAG,GAAG;CAC5B,IAAI,8BAA8B,GAAG,cAAc;CACnD,IAAI,4BAA4B,GAAG,YAAY;CAC/C,IAAI,0BAA0B,GAAG,UAAU;CAC3C,IAAI,6BAA6B,GAAG,YAAY;CAEhD,OAAO;AACT;AAEA,SAAS,2BACP,QAC2C;CAC3C,OAAO;EACL,qBAAqB,YAAsC;GACzD,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;GAC/B,MAAM,eAAe,kBACnB,IAAI,UACJ,OAAO,SAAS,MAAM,MACxB;GAEA,MAAM,UAAW,OAAe,wBAAwB,QACpD,CAAC,IACD,oBAAoB,OAAO;GAE/B,OAAO;IACL,MAAM,GAAG,QAAQ,OAAO,GAAG,IAAI;IAC/B,SAAS;KACP,MAAM,SAAS;KACf,YAAY;MACV,uBAAuB,QAAQ;MAC/B,YAAY,QAAQ;MACpB,GAAI,eAAe;OAAE,gBAAgB;OAAc,yBAAyB;MAAa,IAAI,CAAC;MAC9F,GAAG;KACL;IACF;IACA,SAAS,YAAY,QAAQC,QAAY,OAAO,GAAG,QAAQ,SAAS,aAAa;GACnF;EACF;EACA,0BAA0B,cAAwB,EAChD,6BAA6B,SAAS,OACxC;EACA,kBAAkB,MAAY,SAAkB,WAAqB;GAEnE,IAAI,OAAO,UAAU,KACnB,KAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;GAI/C,IAAI,OAAO,SAAS,MAAM,aAAa;IACrC,MAAM,eAAe;IACrB,OAAO,SAAS,MAAM,YAAY,MAAM;KACtC,SAAS;KACT,UAAU;KACV,UAAU;IACZ,CAAC;GACH;EACF;CACF;AACF;;;;AAKA,MAAM,2BAA8E,EAClF,qBAAqB,UAAgD;CACnE,OAAO;EACL,MAAM,oBAAoB,MAAM,QAAQ;EACxC,SAAS;GACP,MAAM,SAAS;GACf,YAAY;IACV,gBAAgB;IAChB,aAAa,MAAM,QAAQ;IAC3B,uBAAuB,IAAI,KAAK,MAAM,aAAa,CAAC,CAAC,YAAY;GACnE;EACF;CACF;AACF,EACF;;;;AAKA,IAAM,qBAAN,MAAyB;CACvB,YAAY;CACZ,SAAS;CACT,mBAAmB;CACnB,qBAAqB;CACrB,AAAS;CAET,YAAY,OAAe;EACzB,KAAK,QAAQ;CACf;CAEA,MAAM;EACJ,KAAK,YAAY,KAAK,YAAY;CACpC;CAEA,eAAe;EACb,KAAK,mBAAmB,KAAK,QAAQ,KAAK,YAAY,KAAK;EAC3D,KAAK,YAAY,KAAK,QAAQ,KAAK;CACrC;CAEA,QAAQ;EACN,KAAK,SAAS,KAAK,SAAS;CAC9B;CAEA,iBAAiB;EACf,KAAK,qBAAqB,KAAK,QAAQ,KAAK,YAAY,KAAK;EAC7D,KAAK,SAAS,KAAK,QAAQ,KAAK;CAClC;CAEA,eAA2B;EACzB,OAAO;GACL,wBAAwB,KAAK;GAC7B,0BAA0B,KAAK;GAC/B,yBAAyB,KAAK;GAC9B,uBAAuB,KAAK,cAAc,KAAK;GAC/C,0BAA0B,KAAK;GAC/B,4BAA4B,KAAK;EACnC;CACF;AACF;;;;AAKA,SAAS,cAAc,MAAc,KAAe,cAAuB;CACzE,MAAM,QAAoB,CAAC;CAC3B,IAAI,KAAK;EACP,MAAM,sBAAsB,IAAI;EAChC,MAAM,6BAA6B,IAAI,UAAU,YAAY;EAE7D,IAAI,cAAc,OAAO,OAAO,IAAI,aAAa,UAC/C,MAAM,4BAA4B,IAAI;CAE1C;CACA,IAAI,iBAAiB,QACnB,MAAM,+BAA+B;CAEvC,MAAM,cAAc,CAAC,EAAE,SAAS,MAAM,KAAK;AAC7C;;;;AAKA,SAAS,kBAAqB,KAAiB,OAAuC;CA0CpF,OAAO,KAAK,KAAK,EAxCf,MAAM,QAAQ,SAAS;EACrB,IAAI,SAAS,OAAO;GAClB,MAAM,QAAQ,QAAQ,IAAI,QAAQ,IAAI;GACtC,OAAO,IAAI,MAAM,OAAO,EACtB,QAAQ,aAAa;IACnB,cAAc,cAAc,GAAG;IAC/B,MAAM,IAAI;IACV,QAAQ,MAAM,UAAU,KAAK,CAAC,CAAC;GACjC,EACF,CAAC;EACH,OAAO,IAAI,SAAS,SAAS;GAC3B,MAAM,UAAU,QAAQ,IAAI,QAAQ,IAAI;GACxC,OAAO,IAAI,MAAM,SAAS,EACxB,QAAQ,UAAU,UAAU,SAAS;IAEnC,MAAM,eAAe,KAAK;IAG1B,MAAM,eAAe,cAAc;IAEnC,cAAc,gBAAgB,KAAK,YAAY;IAG/C,IAAI,cAAc,aAAa;KAC7B,MAAM,OAAO,MAAM,cAAc;KACjC,IAAI,MACF,KAAK,aAAa,8BAA8B,aAAa,WAAW;IAE5E;IAEA,MAAM,MAAM;IAEZ,OADe,QAAQ,MAAM,UAAU,KAAK,IAChC;GACd,EACF,CAAC;EACH,OACE,OAAO,QAAQ,IAAI,QAAQ,MAAM,GAAG;CAExC,EAEwB,CAAC;AAC7B;;;;AAKA,SAAS,kBAAkB,OAAqB,OAAyC;CA0CvF,OAAO,KAAK,OAAO,EAxCjB,MAAM,QAAQ,SAAS;EACrB,IAAI,SAAS,YAYX,OAAO,KAXU,QAAQ,IAAI,QAAQ,IAWlB,GAAG,EATpB,MAAM,QAAQ,SAAS;GACrB,IAAI,OAAO,SAAS,YAAY,CAAC,MAAM,SAAS,IAAI,CAAC,GAEnD,OAAO,kBADS,QAAQ,IAAI,QAAQ,IACL,GAAG,KAAK;QAEvC,OAAO,QAAQ,IAAI,QAAQ,IAAI;EAEnC,EAEkC,CAAC;OAChC,IAAI,SAAS,UAAU;GAC5B,MAAM,QAAQ,QAAQ,IAAI,QAAQ,IAAI;GACtC,OAAO,IAAI,MAAM,OAAO,EACtB,QAAQ,aAAa;IACnB,cAAc,QAAQ;IACtB,MAAM,aAAa;IACnB,QAAQ,MAAM,UAAU,OAAO,CAAC,CAAC;GACnC,EACF,CAAC;EACH,OAAO,IAAI,SAAS,YAAY;GAC9B,MAAM,UAAU,QAAQ,IAAI,QAAQ,IAAI;GACxC,OAAO,IAAI,MAAM,SAAS,EACxB,QAAQ,UAAU,UAAU,SAAS;IAGnC,MAAM,eADe,KAAK,EACO,EAAE;IAEnC,cAAc,YAAY,QAAW,YAAY;IACjD,MAAM,eAAe;IACrB,QAAQ,MAAM,UAAU,OAAO,IAAI;GACrC,EACF,CAAC;EACH;EACA,OAAO,QAAQ,IAAI,QAAQ,IAAI;CACjC,EAE4B,CAAC;AACjC;;;;AAKA,IAAM,uBAAN,MAAiF;CAC/E,AAAQ;CAER,mBAAmB,OAAsC;EACvD,OAAO;GACL,MAAM,gBAAgB,MAAM,SAAS;GACrC,SAAS;IACP,MAAM,SAAS;IACf,YAAY;KACV,gBAAgB;KAChB,cAAc,MAAM,SAAS;IAC/B;GACF;EACF;CACF;CAEA,kBAAkB,OAAmC;EACnD,KAAK,QAAQ,IAAI,mBAAmB,MAAM,SAAS,MAAM;EACzD,OAAO,kBAAkB,OAAO,KAAK,KAAK;CAC5C;CAEA,gBAAgB,MAAY,UAAwB,SAAe;EACjE,IAAI,KAAK,OAAO;GACd,KAAK,MAAM,aAAa;GACxB,KAAK,cAAc,KAAK,MAAM,aAAa,CAAC;EAC9C;CACF;CAEA,gBAAgB,MAAY,UAAwB,QAAc;EAChE,IAAI,KAAK,OAAO;GACd,KAAK,MAAM,eAAe;GAC1B,KAAK,cAAc,KAAK,MAAM,aAAa,CAAC;EAC9C;CACF;AACF;;;;;AAMA,SAAS,iBAAiB,SAAuD;CAC/E,MAAM,QAAgC,CAAC;CACvC,IAAI,QAAQ,mBAAmB,SAAS;EAEtC,MAAM,YADS,gBAC8B,CAAC,EAAE,YAAY;EAC5D,KAAK,MAAM,CAAC,KAAK,UAAU,QAAQ,QAAQ,QAAQ,GAAG;GACpD,IAAI,aAAa,CAAC,UAAU,SAAS,IAAI,YAAY,CAAC,GACpD;GAEF,MAAM,gBAAgB,SAAS;EACjC;CACF;CACA,OAAO;AACT;;;;AAKA,MAAM,uBAA8E,EAClF,qBAAqB,YAAsD;CACzE,MAAM,aAAqC;EACzC,gBAAgB;EAChB,8BAA8B,QAAQ,MAAM;CAC9C;CAGA,IAAI,aAAa,WAAW,QAAQ,mBAAmB,SAAS;EAC9D,MAAM,YAAY,QAAQ,QAAQ,IAAI,YAAY;EAClD,IAAI,WACF,WAAW,oBAAoB;EAGjC,OAAO,OAAO,YAAY,iBAAiB,OAAO,CAAC;CACrD;CAEA,OAAO;EACL,MAAM,gBAAgB,QAAQ,MAAM;EACpC,SAAS;GACP,MAAM,SAAS;GACf;EACF;CACF;AACF,EACF;;;;AAMA,eAAe,YACb,SACA,SACA,KACA;CACA,MAAM,SAAS,MAAM,UAAU,cAAc;CAC7C,IAAI,kBAAkB,cACpB,IAAI;EAEF,MAAM,mBAAmB;EACzB,IAAI,iBAAiB,WACnB,MAAM,iBAAiB,UAAU,KAAK,CAAC;EAEzC,MAAM,SAAS,KAAK;EACpB,MAAM,OAAO,WAAW,OAAO;CACjC,SAAS,OAAO;EAId,QAAQ,MAAM,0CAA0C,KAAK;CAC/D;AAEJ;;;;AAKA,SAAS,kBACP,iBACA;CACA,QACE,WACA,CAAC,SAAS,KAAKC,eACZ;EACH,MAAM,EAAE,KAAK,YAAY,YAAY,sBAAsBA,SAAO;EAElE,MAAM,SAAS,MAAM,UAAU,cAAc;EAE7C,MAAM,EAAE,MAAM,SAAS,SAAS,gBAC9B,gBAAgB,mBAAmB,OAAO;EAG5C,IAAI,QAAQ,YACV,QAAQ,WAAW,oBAAoB;OAEvC,QAAQ,aAAa,EAAE,kBAAkB,UAAU;EAErD,YAAY;EAEZ,MAAM,gBAAgB,eAAeD,QAAY,OAAO;EAGxD,MAAM,sBAAsB,gBAAgB,oBACxC,gBAAgB,kBAAkB,OAAO,IACzC;EAEJ,OAAO,OAAO,gBAAgB,MAAM,SAAS,eAAe,OAAO,SAAS;GAC1E,IAAI;IACF,MAAM,SAAS,MAAM,UAAU,qBAAqB,KAAK,UAAU;IAEnE,IAAI,gBAAgB,yBAAyB;KAC3C,MAAM,aAAa,gBAAgB,wBAAwB,MAAM;KACjE,KAAK,cAAc,UAAU;IAC/B;IAGA,KAAK,UAAU,EAAE,MAAM,eAAe,GAAG,CAAC;IAE1C,IAAI,gBAAgB,iBAClB,gBAAgB,gBAAgB,MAAM,SAAS,MAAM;IAEvD,OAAO;GACT,SAAS,OAAO;IACd,KAAK,gBAAgB,KAAc;IACnC,KAAK,UAAU;KACb,MAAM,eAAe;KACrB,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;IAChE,CAAC;IACD,IAAI,gBAAgB,iBAClB,gBAAgB,gBAAgB,MAAM,SAAS,KAAK;IAEtD,MAAM;GACR,UAAU;IACR,KAAK,IAAI;IACT,UAAQ,UAAU,YAAY,KAAK,YAAY,CAAC,CAAC,SAAS,SAASC,SAAO,CAAC;GAC7E;EACF,CAAC;CACH;AACF;AAEA,IAAI,sBAAsB;;;;;;;;AAS1B,SAAS,oBACP,QACA,KACA,SACqB;CACrB,MAAM,OAAO,OAAO,iBAAiB;CACrC,IAAI,SAAS,OACX,OAAO;CAOT,MAAM,eAAe,uBAAuB,MAF9B,mBAAmB,UAAU,QAAQ,QAAQ,IAAI,QAAQ,IAAI,SAC5C,OAAO,WAAW,CACa;CAC9D,IAAI,CAAC,gBAAgB,SAAS,QAAQ,CAAC,qBAAqB;EAC1D,sBAAsB;EACtB,QAAQ,KACN,kOAGF;CACF;CACA,OAAO;AACT;;;;;;;;;;;AAYA,SAAS,qBACP,WACA,SACA,KACA,KACA,QACA,cACgB;CAKhB,2BAA2B;CAC3B,MAAM,gBAAgB,iBAAiB,cAAc,UAAU,MAAM,CAAC;CACtE,OAAOD,QAAY,KAAK,qBAAqB,UAAU,SAAS,KAAK,GAAG,CAAC;AAC3E;;;;AAKA,SAAS,mBACP,UACA,WACA,aACA,iBAC6E;CAC7E,QAAQ,SAAY,KAAQ,QAA0B;EACpD,MAAM,SAAS,YAAY,KAAK,OAAO;EAGvC,IAAI,OAAO,gBAAgB,UAEzB,OAAO,UAAU,SAAS,KAAK,GAAG;EAIpC,MAAM,eAAe,oBAAoB,QAAQ,KAAK,OAAO;EAC7D,IAAI,cACF,OAAO,qBAAqB,WAAW,SAAS,KAAK,KAAK,QAAQ,YAAY;EAIhF,MAAM,kBAAkB,mBAAmB,GAA0B;EAErE,MAAM,gBAAgB,UAAU,MAAM;EAGtC,aAAa,MAAM;EAEnB,MAAM,SAAS,kBAA2B,eAAe;EAGzD,OAAOA,QAAY,KAAK,qBAAqB;GAC3C,OAAO,OAAO,WAAW;IAAC;IAAS;IAAiB;GAAG,CAAC;EAC1D,CAAC;CACH;AACF;;;;AAKA,SAAS,6BACP,UACA,WACA,aACA,uBAC6E;CAC7E,QAAQ,SAAY,KAAQ,QAA0B;EACpD,MAAM,SAAS,YAAY,KAAK,OAAO;EAGvC,IAAI,OAAO,gBAAgB,UAEzB,OAAO,UAAU,SAAS,KAAK,GAAG;EAGpC,IAAI,mBAAmB,SAAS;GAC9B,MAAM,WAAW,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;GACtC,MAAM,WAAW,OAAO,SAAS;GACjC,IACE,CAAC,qBAAqB,UAAU;IAC9B,SAAS,SAAS;IAClB,SAAS,SAAS;GACpB,CAAC,GAED,OAAO,UAAU,SAAS,KAAK,GAAG;EAEtC;EAGA,MAAM,eAAe,oBAAoB,QAAQ,KAAK,OAAO;EAC7D,IAAI,cACF,OAAO,qBAAqB,WAAW,SAAS,KAAK,KAAK,QAAQ,YAAY;EAIhF,MAAM,kBAAkB,mBAAmB,GAA0B;EAErE,MAAM,gBAAgB,UAAU,MAAM;EAGtC,aAAa,MAAM;EAInB,MAAM,SAAS,kBADS,sBAAsB,MACU,CAAC;EAGzD,OAAOA,QAAY,KAAK,qBAAqB;GAC3C,OAAO,OAAO,WAAW;IAAC;IAAS;IAAiB;GAAG,CAAC;EAC1D,CAAC;CACH;AACF;AAEA,IAAI,sBAAsB;AAC1B,IAAI,YAAY;;;;AAKhB,SAAS,aAAa,QAAkC;CACtD,IAAI,qBAAqB;CAGzB,IAAI,OAAO,gBAAgB,uBACzB,sBAAsB;CAExB,IAAI,OAAO,gBAAgB,uBACzB,sBAAsB;CAIxB,YAAY,oBAAoB,OAAO,UAAU;CAGjD,MAAM,WAAW,uBAAuB;EACtC,gBAAgB,OAAO,QAAQ;EAC/B,mBAAmB,OAAO,QAAQ;EAClC,qBAAqB,OAAO,QAAQ;EACpC,kBAAkB;EAClB,kBAAkB;EAClB,sBAAsB;EACtB,0BAA0B;CAC5B,CAAC;CAID,IADqB,qBAAqB,OAAO,gBAAgB,QAC1D,CAAC,CAAC,SAAS;CAIlB,AADe,MAAM,UAAU,cAC1B,CAAC,CAAC,eAAe,OAAO,SAAS,WAAW;CAEjD,sBAAsB;AACxB;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,WACd,SACA,QAC0B;CAC1B,MAAM,cAAc,kBAAkB,MAAM;CAE5C,IAAI,QAAQ,OAGV,QAAQ,QAAQ,6BACd,SAHc,OAAO,QAAQ,KAIvB,GACN,aACA,0BACF;CAGF,IAAI,QAAQ,WAEV,QAAQ,YAAY,mBAClB,SAFgB,OAAO,QAAQ,SAGvB,GACR,aACA,wBACF;CAGF,IAAI,QAAQ,OAEV,QAAQ,QAAQ,mBACd,SAFY,OAAO,QAAQ,KAGvB,GACJ,aACA,IAAI,qBAAqB,CAC3B;CAGF,IAAI,QAAQ,OAEV,QAAQ,QAAQ,mBACd,SAFY,OAAO,QAAQ,KAGvB,GACJ,aACA,oBACF;CAGF,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACtwBA,SAAgB,WACd,QACA,SAC0B;CAC1B,OAAO,WAAW,SAAS,MAAM;AACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACRA,SAAgB,kBACd,QACA,SACgD;CAChD,OAAO,aAAa,SAAS,MAAM;AACrC;;;;;;;;;ACWA,SAAgB,kBACd,QACA,SACA,gBAA0C,CAAC,GACwC;CACnF,MAAM,UAAU,WACd,EACE,MAAM,SAAkB,KAAQ,KAAuB;EAErD,OAAO,QAAQ,SAAS,KAAK,KADjB,oBAAoB,SAAS,aACL,CAAC;CACvC,EACF,GACA,MACF;CAEA,OAAO,EACL,MAAM,SAAS,KAAK,KAAK;EACvB,OAAO,QAAQ,QACZ,QAAQ,MAI0B,SAAS,KAAK,GAAG,CACtD;CACF,EACF;AACF"}

package/dist/native-tracing-D0EyAtsF.js

@@ -0,0 +1,33 @@
+//#region src/native/native-tracing.ts
+function readTracing(carrier) {
+	const tracing = carrier?.tracing;
+	return typeof tracing?.enterSpan === "function" ? tracing : void 0;
+}
+/**
+* Returns `true` when Cloudflare native custom-span tracing is available on the
+* given ExecutionContext (i.e. tracing is enabled for this Worker).
+*/
+function isNativeTracingAvailable(ctx) {
+	return readTracing(ctx) !== void 0;
+}
+/**
+* Wrap Cloudflare's `ctx.tracing` as an autotel {@link NativeTracer}, or return
+* `null` when native tracing is unavailable on this context.
+*
+* @param correlationId Optional per-request id (e.g. the `cf-ray` header)
+* surfaced as `ctx.correlationId` and a `correlation.id` span attribute, so
+* logs, custom spans, and the Cloudflare dashboard share one queryable key
+* today — before Cloudflare exposes in-code trace/span ids.
+*/
+function getNativeTracerFromCtx(ctx, correlationId) {
+	const tracing = readTracing(ctx);
+	if (!tracing) return null;
+	return {
+		correlationId,
+		enterSpan: (name, callback) => tracing.enterSpan(name, callback)
+	};
+}
+
+//#endregion
+export { isNativeTracingAvailable as n, getNativeTracerFromCtx as t };
+//# sourceMappingURL=native-tracing-D0EyAtsF.js.map

package/dist/native-tracing-D0EyAtsF.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-tracing-D0EyAtsF.js","names":[],"sources":["../src/native/native-tracing.ts"],"sourcesContent":["/**\n * Cloudflare native tracing adapter\n *\n * Bridges Cloudflare Workers' built-in custom-span API\n * (`ctx.tracing.enterSpan()` / `import { tracing } from \"cloudflare:workers\"`)\n * to autotel-edge's runtime-agnostic {@link NativeTracer} seam.\n *\n * When a Worker has tracing enabled (`observability.traces.enabled = true` in\n * Wrangler) the runtime exposes `ctx.tracing`. The handler wrappers detect it,\n * wrap it as a {@link NativeTracer}, and install it into the active context with\n * `withNativeTracer()`. From then on every autotel `span()` / `trace()` /\n * `enterSpan()` call — including deep inside utility functions and libraries —\n * automatically routes to Cloudflare's native tracer and nests inside the\n * platform's trace waterfall (fetch / KV / R2 / D1 / handler spans), exported\n * by Cloudflare to whichever destination is configured in Wrangler.\n *\n * No `cloudflare:workers` import is required here: the native tracer travels\n * through autotel's AsyncLocalStorage context, so code without access to `ctx`\n * still picks it up via `getActiveNativeTracer()`.\n */\n\nimport type { NativeTracer, NativeSpanHandle } from 'autotel-edge';\n\n/**\n * Cloudflare's native custom-span surface. Declared locally because it is not\n * yet present in `@cloudflare/workers-types`. Structurally compatible with\n * autotel-edge's {@link NativeSpanHandle}.\n */\ninterface CloudflareSpan {\n  readonly isTraced: boolean;\n  setAttribute(key: string, value: string | number | boolean | undefined): void;\n}\n\n/**\n * Cloudflare's `tracing` object, available as `ctx.tracing` on the\n * ExecutionContext and as the `tracing` export of `cloudflare:workers`.\n */\ninterface CloudflareTracing {\n  enterSpan<T, A extends unknown[]>(\n    name: string,\n    callback: (span: CloudflareSpan, ...args: A) => T,\n    ...args: A\n  ): T;\n}\n\ntype MaybeTracingCarrier = { tracing?: CloudflareTracing } | null | undefined;\n\nfunction readTracing(carrier: unknown): CloudflareTracing | undefined {\n  const tracing = (carrier as MaybeTracingCarrier)?.tracing;\n  return typeof tracing?.enterSpan === 'function' ? tracing : undefined;\n}\n\n/**\n * Returns `true` when Cloudflare native custom-span tracing is available on the\n * given ExecutionContext (i.e. tracing is enabled for this Worker).\n */\nexport function isNativeTracingAvailable(ctx: unknown): boolean {\n  return readTracing(ctx) !== undefined;\n}\n\n/**\n * Wrap Cloudflare's `ctx.tracing` as an autotel {@link NativeTracer}, or return\n * `null` when native tracing is unavailable on this context.\n *\n * @param correlationId Optional per-request id (e.g. the `cf-ray` header)\n * surfaced as `ctx.correlationId` and a `correlation.id` span attribute, so\n * logs, custom spans, and the Cloudflare dashboard share one queryable key\n * today — before Cloudflare exposes in-code trace/span ids.\n */\nexport function getNativeTracerFromCtx(\n  ctx: unknown,\n  correlationId?: string,\n): NativeTracer | null {\n  const tracing = readTracing(ctx);\n  if (!tracing) {\n    return null;\n  }\n  return {\n    correlationId,\n    enterSpan: <T>(name: string, callback: (span: NativeSpanHandle) => T): T =>\n      tracing.enterSpan(name, callback as (span: CloudflareSpan) => T),\n  };\n}\n"],"mappings":";AA+CA,SAAS,YAAY,SAAiD;CACpE,MAAM,UAAW,SAAiC;CAClD,OAAO,OAAO,SAAS,cAAc,aAAa,UAAU;AAC9D;;;;;AAMA,SAAgB,yBAAyB,KAAuB;CAC9D,OAAO,YAAY,GAAG,MAAM;AAC9B;;;;;;;;;;AAWA,SAAgB,uBACd,KACA,eACqB;CACrB,MAAM,UAAU,YAAY,GAAG;CAC/B,IAAI,CAAC,SACH,OAAO;CAET,OAAO;EACL;EACA,YAAe,MAAc,aAC3B,QAAQ,UAAU,MAAM,QAAuC;CACnE;AACF"}

package/dist/native-tracing-DSo5mody.d.ts

@@ -0,0 +1,21 @@
+import { NativeTracer } from "autotel-edge";
+
+//#region src/native/native-tracing.d.ts
+/**
+ * Returns `true` when Cloudflare native custom-span tracing is available on the
+ * given ExecutionContext (i.e. tracing is enabled for this Worker).
+ */
+declare function isNativeTracingAvailable(ctx: unknown): boolean;
+/**
+ * Wrap Cloudflare's `ctx.tracing` as an autotel {@link NativeTracer}, or return
+ * `null` when native tracing is unavailable on this context.
+ *
+ * @param correlationId Optional per-request id (e.g. the `cf-ray` header)
+ * surfaced as `ctx.correlationId` and a `correlation.id` span attribute, so
+ * logs, custom spans, and the Cloudflare dashboard share one queryable key
+ * today — before Cloudflare exposes in-code trace/span ids.
+ */
+declare function getNativeTracerFromCtx(ctx: unknown, correlationId?: string): NativeTracer | null;
+//#endregion
+export { isNativeTracingAvailable as n, getNativeTracerFromCtx as t };
+//# sourceMappingURL=native-tracing-DSo5mody.d.ts.map

package/dist/native-tracing-DSo5mody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-tracing-DSo5mody.d.ts","names":[],"sources":["../src/native/native-tracing.ts"],"mappings":";;;;;;;iBAwDgB,wBAAA,CAAyB,GAAY;;;;;;;;;;iBAarC,sBAAA,CACd,GAAA,WACA,aAAA,YACC,YAAY"}

package/dist/native.d.ts

@@ -0,0 +1,2 @@
+import { n as isNativeTracingAvailable, t as getNativeTracerFromCtx } from "./native-tracing-DSo5mody.js";
+export { getNativeTracerFromCtx, isNativeTracingAvailable };

package/dist/native.js

@@ -0,0 +1,3 @@
+import { n as isNativeTracingAvailable, t as getNativeTracerFromCtx } from "./native-tracing-D0EyAtsF.js";
+
+export { getNativeTracerFromCtx, isNativeTracingAvailable };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autotel-cloudflare",
-  "version": "2.19.0",
+  "version": "3.0.0",
   "description": "The #1 OpenTelemetry package for Cloudflare Workers - complete bindings coverage, native CF OTel integration, advanced sampling",
   "type": "module",
   "main": "./dist/index.js",
@@ -43,6 +43,10 @@
       "types": "./dist/agents.d.ts",
       "import": "./dist/agents.js"
     },
+    "./native": {
+      "types": "./dist/native.d.ts",
+      "import": "./dist/native.js"
+    },
     "./parse-error": {
       "types": "./dist/parse-error.d.ts",
       "import": "./dist/parse-error.js"
@@ -77,7 +81,7 @@
   },
   "peerDependencies": {
     "@cloudflare/workers-types": "^4.20260607.1",
-    "autotel-edge": "3.16.15"
+    "autotel-edge": "3.17.0"
   },
   "peerDependenciesMeta": {
     "autotel-edge": {
@@ -93,7 +97,7 @@
     "typescript": "^6.0.3",
     "vitest": "^4.1.8",
     "vitest-mock-extended": "^4.0.0",
-    "autotel-edge": "3.16.15"
+    "autotel-edge": "3.17.0"
   },
   "repository": {
     "type": "git",

package/src/index.ts

@@ -81,3 +81,11 @@ export {
 
 // Global instrumentations
 export { instrumentGlobalFetch, instrumentGlobalCache } from './global';
+
+// Cloudflare native tracing helpers (auto-wired by the handler wrappers;
+// exported for manual detection). `enterSpan` is re-exported from autotel-edge
+// above via `export * from 'autotel-edge'`.
+export {
+  isNativeTracingAvailable,
+  getNativeTracerFromCtx,
+} from './native/native-tracing';

package/src/native/native-tracing.test.ts

@@ -0,0 +1,54 @@
+import { describe, it, expect, vi } from 'vitest';
+import {
+  isNativeTracingAvailable,
+  getNativeTracerFromCtx,
+} from './native-tracing';
+
+function ctxWithTracing() {
+  const enterSpan = vi.fn((_name: string, cb: (s: any) => unknown) =>
+    cb({ isTraced: true, setAttribute: vi.fn() }),
+  );
+  return { tracing: { enterSpan }, waitUntil() {}, passThroughOnException() {} };
+}
+
+describe('isNativeTracingAvailable', () => {
+  it('is true when ctx.tracing.enterSpan is a function', () => {
+    expect(isNativeTracingAvailable(ctxWithTracing())).toBe(true);
+  });
+
+  it('is false for a plain ExecutionContext (tracing disabled / old runtime)', () => {
+    expect(isNativeTracingAvailable({ waitUntil() {} })).toBe(false);
+  });
+
+  it('is false for null/undefined or malformed tracing', () => {
+    expect(isNativeTracingAvailable(undefined)).toBe(false);
+    expect(isNativeTracingAvailable(null)).toBe(false);
+    expect(isNativeTracingAvailable({ tracing: {} })).toBe(false);
+    expect(isNativeTracingAvailable({ tracing: { enterSpan: 123 } })).toBe(false);
+  });
+});
+
+describe('getNativeTracerFromCtx', () => {
+  it('returns null when native tracing is unavailable', () => {
+    expect(getNativeTracerFromCtx({ waitUntil() {} })).toBeNull();
+  });
+
+  it('wraps ctx.tracing.enterSpan as a NativeTracer', () => {
+    const ctx = ctxWithTracing();
+    const tracer = getNativeTracerFromCtx(ctx);
+    expect(tracer).not.toBeNull();
+
+    const result = tracer!.enterSpan('work', (span) => {
+      span.setAttribute('k', 'v');
+      return 7;
+    });
+
+    expect(result).toBe(7);
+    expect(ctx.tracing.enterSpan).toHaveBeenCalledWith('work', expect.any(Function));
+  });
+
+  it('attaches the supplied correlation id to the tracer', () => {
+    const tracer = getNativeTracerFromCtx(ctxWithTracing(), 'ray-xyz');
+    expect(tracer?.correlationId).toBe('ray-xyz');
+  });
+});

package/src/native/native-tracing.ts

@@ -0,0 +1,83 @@
+/**
+ * Cloudflare native tracing adapter
+ *
+ * Bridges Cloudflare Workers' built-in custom-span API
+ * (`ctx.tracing.enterSpan()` / `import { tracing } from "cloudflare:workers"`)
+ * to autotel-edge's runtime-agnostic {@link NativeTracer} seam.
+ *
+ * When a Worker has tracing enabled (`observability.traces.enabled = true` in
+ * Wrangler) the runtime exposes `ctx.tracing`. The handler wrappers detect it,
+ * wrap it as a {@link NativeTracer}, and install it into the active context with
+ * `withNativeTracer()`. From then on every autotel `span()` / `trace()` /
+ * `enterSpan()` call — including deep inside utility functions and libraries —
+ * automatically routes to Cloudflare's native tracer and nests inside the
+ * platform's trace waterfall (fetch / KV / R2 / D1 / handler spans), exported
+ * by Cloudflare to whichever destination is configured in Wrangler.
+ *
+ * No `cloudflare:workers` import is required here: the native tracer travels
+ * through autotel's AsyncLocalStorage context, so code without access to `ctx`
+ * still picks it up via `getActiveNativeTracer()`.
+ */
+
+import type { NativeTracer, NativeSpanHandle } from 'autotel-edge';
+
+/**
+ * Cloudflare's native custom-span surface. Declared locally because it is not
+ * yet present in `@cloudflare/workers-types`. Structurally compatible with
+ * autotel-edge's {@link NativeSpanHandle}.
+ */
+interface CloudflareSpan {
+  readonly isTraced: boolean;
+  setAttribute(key: string, value: string | number | boolean | undefined): void;
+}
+
+/**
+ * Cloudflare's `tracing` object, available as `ctx.tracing` on the
+ * ExecutionContext and as the `tracing` export of `cloudflare:workers`.
+ */
+interface CloudflareTracing {
+  enterSpan<T, A extends unknown[]>(
+    name: string,
+    callback: (span: CloudflareSpan, ...args: A) => T,
+    ...args: A
+  ): T;
+}
+
+type MaybeTracingCarrier = { tracing?: CloudflareTracing } | null | undefined;
+
+function readTracing(carrier: unknown): CloudflareTracing | undefined {
+  const tracing = (carrier as MaybeTracingCarrier)?.tracing;
+  return typeof tracing?.enterSpan === 'function' ? tracing : undefined;
+}
+
+/**
+ * Returns `true` when Cloudflare native custom-span tracing is available on the
+ * given ExecutionContext (i.e. tracing is enabled for this Worker).
+ */
+export function isNativeTracingAvailable(ctx: unknown): boolean {
+  return readTracing(ctx) !== undefined;
+}
+
+/**
+ * Wrap Cloudflare's `ctx.tracing` as an autotel {@link NativeTracer}, or return
+ * `null` when native tracing is unavailable on this context.
+ *
+ * @param correlationId Optional per-request id (e.g. the `cf-ray` header)
+ * surfaced as `ctx.correlationId` and a `correlation.id` span attribute, so
+ * logs, custom spans, and the Cloudflare dashboard share one queryable key
+ * today — before Cloudflare exposes in-code trace/span ids.
+ */
+export function getNativeTracerFromCtx(
+  ctx: unknown,
+  correlationId?: string,
+): NativeTracer | null {
+  const tracing = readTracing(ctx);
+  if (!tracing) {
+    return null;
+  }
+  return {
+    correlationId,
+    enterSpan: <T>(name: string, callback: (span: NativeSpanHandle) => T): T =>
+      tracing.enterSpan(name, callback as (span: CloudflareSpan) => T),
+  };
+}

package/src/native.ts

@@ -0,0 +1,12 @@
+/**
+ * autotel-cloudflare/native
+ *
+ * Cloudflare native tracing helpers. Most users never need this entry point —
+ * the handler wrappers (`instrument`, `wrapModule`, `defineWorkerFetch`,
+ * `wrapDurableObject`) auto-detect and wire up native tracing for you. Import
+ * from here only when you want to detect native tracing yourself.
+ */
+export {
+  isNativeTracingAvailable,
+  getNativeTracerFromCtx,
+} from './native/native-tracing';

package/src/wrappers/instrument.ts

@@ -41,10 +41,14 @@ import {
   getActiveConfig,
   getServiceForPath,
   shouldInstrumentPath,
+  withNativeTracer,
+  ensureGlobalContextManager,
   type Initialiser,
+  type NativeTracer,
   WorkerTracerProvider,
   WorkerTracer,
 } from 'autotel-edge';
+import { getNativeTracerFromCtx } from '../native/native-tracing';
 import { proxyExecutionContext, unwrap, wrap, type PromiseTracker } from '../bindings/common';
 import { instrumentGlobalFetch } from '../global/fetch';
 import { instrumentGlobalCache } from '../global/cache';
@@ -528,6 +532,68 @@ function createHandlerFlow<T extends Trigger, E, R>(
   };
 }
 
+let warnedMissingNative = false;
+
+/**
+ * Resolve whether this invocation should use Cloudflare's native tracer.
+ *
+ * - `nativeTracing: 'off'` → never use native (always autotel's OTLP pipeline).
+ * - `nativeTracing: 'on'`  → require native; warn once and fall back if absent.
+ * - `nativeTracing: 'auto'` (default) → use native when `ctx.tracing` exists.
+ */
+function resolveNativeTracer(
+  config: ResolvedEdgeConfig,
+  ctx: ExecutionContext,
+  trigger: Trigger,
+): NativeTracer | null {
+  const mode = config.nativeTracing ?? 'auto';
+  if (mode === 'off') {
+    return null;
+  }
+  // Correlation id: prefer Cloudflare's ray id (also stamped on the native root
+  // span + carried by the workers logger), so logs/spans/dashboard share a key.
+  // Fall back to a per-invocation uuid for non-fetch triggers.
+  const rayId = trigger instanceof Request ? trigger.headers.get('cf-ray') : null;
+  const correlationId = rayId ?? crypto.randomUUID();
+  const nativeTracer = getNativeTracerFromCtx(ctx, correlationId);
+  if (!nativeTracer && mode === 'on' && !warnedMissingNative) {
+    warnedMissingNative = true;
+    console.warn(
+      "[autotel-cloudflare] nativeTracing is 'on' but Cloudflare native tracing was not detected. " +
+        'Enable observability.traces in your Wrangler config (and use a recent compatibility_date). ' +
+        'Falling back to the autotel OTLP exporter.',
+    );
+  }
+  return nativeTracer;
+}
+
+/**
+ * Run a handler in native-tracing mode.
+ *
+ * Cloudflare already creates the root handler span and instruments platform
+ * operations (fetch / KV / R2 / D1 / DO), so autotel defers entirely: no
+ * binding proxies (avoids duplicate spans), no provider/exporter, no manual
+ * flush. We install the native tracer into the active context so that the
+ * user's `span()` / `trace()` / `enterSpan()` calls nest inside Cloudflare's
+ * native waterfall and are exported by the platform.
+ */
+function runWithNativeTracing<T extends Trigger, E, R>(
+  handlerFn: (trigger: T, env: E, ctx: ExecutionContext) => R | Promise<R>,
+  trigger: T,
+  env: E,
+  ctx: ExecutionContext,
+  config: ResolvedEdgeConfig,
+  nativeTracer: NativeTracer,
+): R | Promise<R> {
+  // Register the context manager (we skip initProvider in native mode) so the
+  // native tracer propagates through OTel context into span()/trace() — without
+  // it, getActiveNativeTracer() returns null and custom spans never route to
+  // enterSpan. Bindings are NOT proxied: Cloudflare instruments them natively.
+  ensureGlobalContextManager();
+  const nativeContext = withNativeTracer(nativeTracer, setConfig(config));
+  return api_context.with(nativeContext, () => handlerFn(trigger, env, ctx));
+}
+
 /**
  * Create handler proxy
  */
@@ -539,16 +605,22 @@ function createHandlerProxy<T extends Trigger, E, R>(
 ): (trigger: T, env: E, ctx: ExecutionContext) => ReturnType<typeof handlerFn> {
   return (trigger: T, env: E, ctx: ExecutionContext) => {
     const config = initialiser(env, trigger);
-    
+
     // Check if instrumentation is disabled (useful for local dev)
     if (config.instrumentation.disabled) {
       // Return handler as-is without instrumentation
       return handlerFn(trigger, env, ctx);
     }
-    
+
+    // Prefer Cloudflare native tracing when available — defer to the platform.
+    const nativeTracer = resolveNativeTracer(config, ctx, trigger);
+    if (nativeTracer) {
+      return runWithNativeTracing(handlerFn, trigger, env, ctx, config, nativeTracer);
+    }
+
     // Auto-instrument Cloudflare bindings in the environment
     const instrumentedEnv = instrumentBindings(env as Record<string, any>) as E;
-    
+
     const configContext = setConfig(config);
 
     // Initialize provider on first call
@@ -593,10 +665,16 @@ function createHandlerProxyWithConfig<T extends Trigger, E, R>(
         return handlerFn(trigger, env, ctx) as ReturnType<typeof handlerFn>;
       }
     }
-    
+
+    // Prefer Cloudflare native tracing when available — defer to the platform.
+    const nativeTracer = resolveNativeTracer(config, ctx, trigger);
+    if (nativeTracer) {
+      return runWithNativeTracing(handlerFn, trigger, env, ctx, config, nativeTracer) as ReturnType<typeof handlerFn>;
+    }
+
     // Auto-instrument Cloudflare bindings in the environment
     const instrumentedEnv = instrumentBindings(env as Record<string, any>) as E;
-    
+
     const configContext = setConfig(config);
 
     // Initialize provider on first call

package/src/wrappers/native-instrument.test.ts

@@ -0,0 +1,153 @@
+import { describe, it, expect, vi } from 'vitest';
+import { instrument } from './instrument';
+import { span } from 'autotel-edge';
+import { isWrapped } from '../bindings/common';
+
+/**
+ * A KV-shaped binding so instrumentBindings() would proxy it in the OTLP path.
+ * In native mode we must NOT proxy it (Cloudflare traces KV natively) — these
+ * tests assert that the handler receives the original, unwrapped binding and
+ * that user spans route to ctx.tracing.enterSpan instead of the OTel pipeline.
+ */
+function fakeKv() {
+  return {
+    get: vi.fn(async () => 'value'),
+    put: vi.fn(async () => {}),
+    delete: vi.fn(async () => {}),
+    list: vi.fn(async () => ({ keys: [] })),
+  };
+}
+
+function nativeCtx() {
+  const enteredSpans: string[] = [];
+  const waitUntil = vi.fn();
+  const ctx = {
+    waitUntil,
+    passThroughOnException() {},
+    tracing: {
+      enterSpan: vi.fn((name: string, cb: (s: any) => unknown) => {
+        enteredSpans.push(name);
+        return cb({ isTraced: true, setAttribute: vi.fn() });
+      }),
+    },
+  };
+  return { ctx, enteredSpans, waitUntil };
+}
+
+const baseConfig = {
+  service: { name: 'native-test' },
+  exporter: { url: 'http://localhost:4318/v1/traces' },
+} as const;
+
+describe('instrument() with Cloudflare native tracing (auto)', () => {
+  it('defers binding instrumentation to the platform (no proxy wrapping)', async () => {
+    const { ctx } = nativeCtx();
+    const kv = fakeKv();
+    let seenBinding: unknown;
+
+    const handler = instrument(
+      {
+        async fetch(_req, env: { MY_KV: ReturnType<typeof fakeKv> }) {
+          seenBinding = env.MY_KV;
+          await env.MY_KV.get('k');
+          return new Response('ok');
+        },
+      },
+      baseConfig,
+    );
+
+    await handler.fetch!(new Request('https://x/'), { MY_KV: kv }, ctx as never);
+
+    // Handler received the ORIGINAL binding, not an autotel proxy.
+    expect(seenBinding).toBe(kv);
+    expect(isWrapped(seenBinding)).toBe(false);
+    // No "KV ...: get" span was created via the native tracer.
+    expect(
+      ctx.tracing.enterSpan.mock.calls.some(([name]) =>
+        String(name).startsWith('KV '),
+      ),
+    ).toBe(false);
+  });
+
+  it('surfaces the cf-ray header as a correlation.id span attribute', async () => {
+    const attrs: Record<string, unknown> = {};
+    const ctx = {
+      waitUntil() {},
+      passThroughOnException() {},
+      tracing: {
+        enterSpan: vi.fn((_name: string, cb: (s: any) => unknown) =>
+          cb({
+            isTraced: true,
+            setAttribute(k: string, v: unknown) {
+              attrs[k] = v;
+            },
+          }),
+        ),
+      },
+    };
+
+    const handler = instrument(
+      { async fetch() { return span('work', () => new Response('ok')); } },
+      baseConfig,
+    );
+
+    const req = new Request('https://x/', { headers: { 'cf-ray': 'ray-7f' } });
+    await handler.fetch!(req, {}, ctx as never);
+    expect(attrs['correlation.id']).toBe('ray-7f');
+  });
+
+  it('routes user span() calls to ctx.tracing.enterSpan', async () => {
+    const { ctx, enteredSpans } = nativeCtx();
+
+    const handler = instrument(
+      {
+        async fetch() {
+          return span('user.work', (s) => {
+            s.setAttribute('ok', true);
+            return new Response('done');
+          });
+        },
+      },
+      baseConfig,
+    );
+
+    const res = await handler.fetch!(new Request('https://x/'), {}, ctx as never);
+    expect(await res.text()).toBe('done');
+    expect(enteredSpans).toContain('user.work');
+  });
+
+  it('does not run the OTLP export flow (no waitUntil) in native mode', async () => {
+    const { ctx, waitUntil } = nativeCtx();
+    const handler = instrument(
+      { async fetch() { return new Response('ok'); } },
+      baseConfig,
+    );
+    await handler.fetch!(new Request('https://x/'), {}, ctx as never);
+    expect(waitUntil).not.toHaveBeenCalled();
+  });
+});
+
+describe('instrument() with nativeTracing: "off"', () => {
+  it('ignores ctx.tracing and uses the autotel pipeline (proxies bindings)', async () => {
+    const { ctx } = nativeCtx();
+    const kv = fakeKv();
+    let seenBinding: unknown;
+
+    const handler = instrument(
+      {
+        async fetch(_req, env: { MY_KV: ReturnType<typeof fakeKv> }) {
+          seenBinding = env.MY_KV;
+          return new Response('ok');
+        },
+      },
+      { ...baseConfig, nativeTracing: 'off' },
+    );
+
+    await handler.fetch!(new Request('https://x/'), { MY_KV: kv }, ctx as never);
+
+    // OTLP path proxies the binding, so the handler sees a wrapped object.
+    expect(isWrapped(seenBinding)).toBe(true);
+    // Native tracer was never used.
+    expect(ctx.tracing.enterSpan).not.toHaveBeenCalled();
+  });
+});