autotel-cloudflare 2.12.0 → 2.14.0

package/src/wrappers/cf-attributes.test.ts

@@ -0,0 +1,275 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { instrument } from './instrument';
+import { trace, SpanStatusCode, SpanKind } from '@opentelemetry/api';
+
+describe('CF Attributes extraction via instrument()', () => {
+  let mockTracer: any;
+  let mockSpan: any;
+  let getTracerSpy: any;
+  let capturedSpanOptions: any;
+
+  beforeEach(() => {
+    mockSpan = {
+      spanContext: () => ({
+        traceId: 'test-trace-id',
+        spanId: 'test-span-id',
+        traceFlags: 1,
+      }),
+      setAttribute: vi.fn(),
+      setAttributes: vi.fn(),
+      setStatus: vi.fn(),
+      recordException: vi.fn(),
+      end: vi.fn(),
+      isRecording: () => true,
+      updateName: vi.fn(),
+      addEvent: vi.fn(),
+    };
+
+    capturedSpanOptions = null;
+
+    mockTracer = {
+      startActiveSpan: vi.fn((...args: any[]) => {
+        // startActiveSpan can be called with (name, options, context, fn) or (name, options, fn)
+        // The fetch instrumentation calls it with 4 args: (name, options, parentContext, fn)
+        const fn = args.at(-1);
+        if (args.length >= 2) {
+          capturedSpanOptions = args[1];
+        }
+        return fn(mockSpan);
+      }),
+      setHeadSampler: vi.fn(),
+      forceFlush: vi.fn(async () => {}),
+    };
+
+    getTracerSpy = vi.spyOn(trace, 'getTracer').mockReturnValue(mockTracer as any);
+  });
+
+  afterEach(() => {
+    getTracerSpy.mockRestore();
+  });
+
+  function createMockCtx() {
+    return {
+      waitUntil: vi.fn(),
+      passThroughOnException: vi.fn(),
+    } as any;
+  }
+
+  it('should extract CF attributes when request has .cf object', async () => {
+    const handler = {
+      async fetch(request: Request) {
+        return new Response('OK', { status: 200 });
+      },
+    };
+
+    const instrumented = instrument(handler, {
+      service: { name: 'test-worker' },
+    });
+
+    const request = new Request('http://example.com/test');
+    // Attach .cf properties to the request (Cloudflare Workers runtime does this)
+    Object.defineProperty(request, 'cf', {
+      value: {
+        colo: 'SJC',
+        country: 'US',
+        city: 'San Jose',
+        region: 'California',
+        continent: 'NA',
+        timezone: 'America/Los_Angeles',
+        latitude: '37.3382',
+        longitude: '-121.8863',
+        asn: 13_335,
+        asOrganization: 'Cloudflare Inc',
+        httpProtocol: 'HTTP/2',
+        tlsVersion: 'TLSv1.3',
+        clientTcpRtt: 5,
+      },
+      writable: false,
+      enumerable: true,
+    });
+
+    const env = {} as any;
+    const ctx = createMockCtx();
+
+    await instrumented.fetch!(request, env, ctx);
+
+    expect(capturedSpanOptions).toBeDefined();
+    const attrs = capturedSpanOptions.attributes;
+
+    expect(attrs['cloudflare.colo']).toBe('SJC');
+    expect(attrs['cloudflare.country']).toBe('US');
+    expect(attrs['cloudflare.city']).toBe('San Jose');
+    expect(attrs['cloudflare.region']).toBe('California');
+    expect(attrs['cloudflare.continent']).toBe('NA');
+    expect(attrs['cloudflare.timezone']).toBe('America/Los_Angeles');
+    expect(attrs['cloudflare.latitude']).toBe('37.3382');
+    expect(attrs['cloudflare.longitude']).toBe('-121.8863');
+    expect(attrs['cloudflare.asn']).toBe(13_335);
+    expect(attrs['cloudflare.as_organization']).toBe('Cloudflare Inc');
+    expect(attrs['cloudflare.http_protocol']).toBe('HTTP/2');
+    expect(attrs['cloudflare.tls_version']).toBe('TLSv1.3');
+    expect(attrs['cloudflare.client_tcp_rtt']).toBe(5);
+  });
+
+  it('should extract CF ray_id from cf-ray header', async () => {
+    const handler = {
+      async fetch(request: Request) {
+        return new Response('OK', { status: 200 });
+      },
+    };
+
+    const instrumented = instrument(handler, {
+      service: { name: 'test-worker' },
+    });
+
+    const request = new Request('http://example.com/test', {
+      headers: {
+        'cf-ray': '8a1b2c3d4e5f6-SJC',
+      },
+    });
+    Object.defineProperty(request, 'cf', {
+      value: { colo: 'SJC' },
+      writable: false,
+      enumerable: true,
+    });
+
+    const env = {} as any;
+    const ctx = createMockCtx();
+
+    await instrumented.fetch!(request, env, ctx);
+
+    expect(capturedSpanOptions).toBeDefined();
+    const attrs = capturedSpanOptions.attributes;
+    expect(attrs['cloudflare.ray_id']).toBe('8a1b2c3d4e5f6-SJC');
+    expect(attrs['cloudflare.colo']).toBe('SJC');
+  });
+
+  it('should not include CF attributes when request.cf is undefined', async () => {
+    const handler = {
+      async fetch(request: Request) {
+        return new Response('OK', { status: 200 });
+      },
+    };
+
+    const instrumented = instrument(handler, {
+      service: { name: 'test-worker' },
+    });
+
+    // Standard request without .cf (local dev / Miniflare scenario)
+    const request = new Request('http://example.com/test');
+    const env = {} as any;
+    const ctx = createMockCtx();
+
+    await instrumented.fetch!(request, env, ctx);
+
+    expect(capturedSpanOptions).toBeDefined();
+    const attrs = capturedSpanOptions.attributes;
+
+    // Standard HTTP attributes should still be present
+    expect(attrs['http.request.method']).toBe('GET');
+    expect(attrs['url.full']).toBe('http://example.com/test');
+
+    // No cloudflare.* attributes should be present
+    const cfKeys = Object.keys(attrs).filter(k => k.startsWith('cloudflare.'));
+    expect(cfKeys).toHaveLength(0);
+  });
+
+  it('should correctly map all CF fields to cloudflare.* attribute names', async () => {
+    const handler = {
+      async fetch(request: Request) {
+        return new Response('OK', { status: 200 });
+      },
+    };
+
+    const instrumented = instrument(handler, {
+      service: { name: 'test-worker' },
+    });
+
+    const request = new Request('http://example.com/test', {
+      headers: { 'cf-ray': 'abc123-LAX' },
+    });
+    Object.defineProperty(request, 'cf', {
+      value: {
+        colo: 'LAX',
+        country: 'US',
+        city: 'Los Angeles',
+        region: 'California',
+        continent: 'NA',
+        timezone: 'America/Los_Angeles',
+        latitude: '34.0522',
+        longitude: '-118.2437',
+        asn: 13_335,
+        asOrganization: 'Cloudflare Inc',
+        httpProtocol: 'HTTP/3',
+        tlsVersion: 'TLSv1.3',
+        clientTcpRtt: 10,
+      },
+      writable: false,
+      enumerable: true,
+    });
+
+    const env = {} as any;
+    const ctx = createMockCtx();
+
+    await instrumented.fetch!(request, env, ctx);
+
+    const attrs = capturedSpanOptions.attributes;
+
+    // Verify the exact mapping from CF property names to attribute names
+    const expectedMappings: Record<string, [string, any]> = {
+      'cloudflare.colo': ['colo', 'LAX'],
+      'cloudflare.ray_id': ['cf-ray header', 'abc123-LAX'],
+      'cloudflare.country': ['country', 'US'],
+      'cloudflare.city': ['city', 'Los Angeles'],
+      'cloudflare.region': ['region', 'California'],
+      'cloudflare.continent': ['continent', 'NA'],
+      'cloudflare.timezone': ['timezone', 'America/Los_Angeles'],
+      'cloudflare.latitude': ['latitude', '34.0522'],
+      'cloudflare.longitude': ['longitude', '-118.2437'],
+      'cloudflare.asn': ['asn', 13_335],
+      'cloudflare.as_organization': ['asOrganization', 'Cloudflare Inc'],
+      'cloudflare.http_protocol': ['httpProtocol', 'HTTP/3'],
+      'cloudflare.tls_version': ['tlsVersion', 'TLSv1.3'],
+      'cloudflare.client_tcp_rtt': ['clientTcpRtt', 10],
+    };
+
+    for (const [attrKey, [, expectedValue]] of Object.entries(expectedMappings)) {
+      expect(attrs[attrKey]).toBe(expectedValue);
+    }
+  });
+
+  it('preserves valid falsy numeric CF attributes (0 values)', async () => {
+    const handler = {
+      async fetch(_request: Request) {
+        return new Response('OK', { status: 200 });
+      },
+    };
+
+    const instrumented = instrument(handler, {
+      service: { name: 'test-worker' },
+    });
+
+    const request = new Request('http://example.com/test');
+    Object.defineProperty(request, 'cf', {
+      value: {
+        latitude: 0,
+        longitude: 0,
+        asn: 0,
+        clientTcpRtt: 0,
+      },
+      writable: false,
+      enumerable: true,
+    });
+
+    const env = {} as any;
+    const ctx = createMockCtx();
+
+    await instrumented.fetch!(request, env, ctx);
+
+    const attrs = capturedSpanOptions.attributes;
+    expect(attrs['cloudflare.latitude']).toBe(0);
+    expect(attrs['cloudflare.longitude']).toBe(0);
+    expect(attrs['cloudflare.asn']).toBe(0);
+    expect(attrs['cloudflare.client_tcp_rtt']).toBe(0);
+  });
+});

package/src/wrappers/instrument.ts

@@ -75,6 +75,39 @@ type EmailHandler = (
 /**
  * Create fetch handler instrumentation with config support for postProcess
  */
+/**
+ * Extract Cloudflare-specific attributes from a request
+ */
+function extractCfAttributes(request: Request): Record<string, string | number | boolean> {
+  const cf = (request as any).cf;
+  if (!cf) return {};
+
+  const attrs: Record<string, string | number | boolean> = {};
+  const set = (key: string, value: unknown) => {
+    if (value !== undefined && value !== null) {
+      attrs[key] = value as string | number | boolean;
+    }
+  };
+
+  set('cloudflare.colo', cf.colo);
+  const ray = request.headers.get('cf-ray');
+  if (ray) attrs['cloudflare.ray_id'] = ray;
+  set('cloudflare.country', cf.country);
+  set('cloudflare.city', cf.city);
+  set('cloudflare.region', cf.region);
+  set('cloudflare.continent', cf.continent);
+  set('cloudflare.timezone', cf.timezone);
+  set('cloudflare.latitude', cf.latitude);
+  set('cloudflare.longitude', cf.longitude);
+  set('cloudflare.asn', cf.asn);
+  set('cloudflare.as_organization', cf.asOrganization);
+  set('cloudflare.http_protocol', cf.httpProtocol);
+  set('cloudflare.tls_version', cf.tlsVersion);
+  set('cloudflare.client_tcp_rtt', cf.clientTcpRtt);
+
+  return attrs;
+}
+
 function createFetchInstrumentation(
   config: ResolvedEdgeConfig,
 ): HandlerInstrumentation<Request, Response> {
@@ -82,6 +115,10 @@ function createFetchInstrumentation(
     getInitialSpanInfo: (request: Request): InitialSpanInfo => {
       const url = new URL(request.url);
 
+      const cfAttrs = (config as any).extractCfAttributes === false
+        ? {}
+        : extractCfAttributes(request);
+
       return {
         name: `${request.method} ${url.pathname}`,
         options: {
@@ -89,6 +126,7 @@ function createFetchInstrumentation(
           attributes: {
             'http.request.method': request.method,
             'url.full': request.url,
+            ...cfAttrs,
           },
         },
         context: propagation.extract(api_context.active(), request.headers),

package/dist/chunk-5NL62W4L.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/bindings/common.ts"],"names":[],"mappings":";AAOO,IAAM,iBAAN,MAAqB;AAAA,EAClB,WAA+B,EAAC;AAAA,EAExC,MAAM,OAAA,EAAiC;AACrC,IAAA,IAAA,CAAK,QAAA,CAAS,KAAK,OAAO,CAAA;AAAA,EAC5B;AAAA,EAEA,MAAM,IAAA,GAAsB;AAC1B,IAAA,MAAM,OAAA,CAAQ,UAAA,CAAW,IAAA,CAAK,QAAQ,CAAA;AAAA,EACxC;AACF,CAAA;AAKO,SAAS,sBAAsB,GAAA,EAGpC;AACA,EAAA,MAAM,OAAA,GAAU,IAAI,cAAA,EAAe;AAEnC,EAAA,MAAM,OAAA,GAAU,IAAI,KAAA,CAAM,GAAA,EAAK;AAAA,IAC7B,GAAA,CAAI,QAAQ,IAAA,EAAM;AAChB,MAAA,IAAI,SAAS,WAAA,EAAa;AACxB,QAAA,OAAO,CAAC,OAAA,KAA8B;AACpC,UAAA,OAAA,CAAQ,MAAM,OAAO,CAAA;AACrB,UAAA,OAAO,MAAA,CAAO,UAAU,OAAO,CAAA;AAAA,QACjC,CAAA;AAAA,MACF;AACA,MAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,MAAA,EAAQ,IAAI,CAAA;AAAA,IACjC;AAAA,GACD,CAAA;AAED,EAAA,OAAO,EAAE,GAAA,EAAK,OAAA,EAAS,OAAA,EAAQ;AACjC;AAKA,IAAM,YAAA,0BAAsB,QAAQ,CAAA;AAI7B,SAAS,UAAa,IAAA,EAA6B;AACxD,EAAA,OAAO,IAAA,IAAQ,CAAC,CAAE,IAAA,CAAoB,YAAY,CAAA;AACpD;AAEO,SAAS,OAAyB,IAAA,EAAY;AACnD,EAAA,IAAI,IAAA,IAAQ,SAAA,CAAU,IAAI,CAAA,EAAG;AAC3B,IAAA,OAAO,KAAK,YAAY,CAAA;AAAA,EAC1B,CAAA,MAAO;AACL,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAEO,SAAS,IAAA,CACd,MACA,OAAA,EACY;AACZ,EAAA,MAAM,KAAA,GAAQ,IAAI,KAAA,CAAM,IAAA,EAAM,OAAO,CAAA;AACrC,EAAA,MAAA,CAAO,cAAA,CAAe,OAAO,YAAA,EAAc;AAAA,IACzC,KAAA,EAAO,IAAA;AAAA,IACP,QAAA,EAAU,KAAA;AAAA,IACV,UAAA,EAAY,KAAA;AAAA,IACZ,YAAA,EAAc;AAAA,GACf,CAAA;AACD,EAAA,OAAO,KAAA;AACT","file":"chunk-5NL62W4L.js","sourcesContent":["/**\n * Common instrumentation utilities\n */\n\n/**\n * Promise tracker for waitUntil\n */\nexport class PromiseTracker {\n  private promises: Promise<unknown>[] = [];\n\n  track(promise: Promise<unknown>): void {\n    this.promises.push(promise);\n  }\n\n  async wait(): Promise<void> {\n    await Promise.allSettled(this.promises);\n  }\n}\n\n/**\n * Proxy ExecutionContext to track waitUntil promises\n */\nexport function proxyExecutionContext(ctx: ExecutionContext): {\n  ctx: ExecutionContext;\n  tracker: PromiseTracker;\n} {\n  const tracker = new PromiseTracker();\n\n  const proxied = new Proxy(ctx, {\n    get(target, prop) {\n      if (prop === 'waitUntil') {\n        return (promise: Promise<unknown>) => {\n          tracker.track(promise);\n          return target.waitUntil(promise);\n        };\n      }\n      return Reflect.get(target, prop);\n    },\n  });\n\n  return { ctx: proxied, tracker };\n}\n\n/**\n * Helper to wrap/unwrap proxied objects\n */\nconst unwrapSymbol = Symbol('unwrap');\n\ntype Wrapped<T> = { [unwrapSymbol]: T } & T;\n\nexport function isWrapped<T>(item: T): item is Wrapped<T> {\n  return item && !!(item as Wrapped<T>)[unwrapSymbol];\n}\n\nexport function unwrap<T extends object>(item: T): T {\n  if (item && isWrapped(item)) {\n    return item[unwrapSymbol];\n  } else {\n    return item;\n  }\n}\n\nexport function wrap<T extends object>(\n  item: T,\n  handler: ProxyHandler<T>,\n): Wrapped<T> {\n  const proxy = new Proxy(item, handler) as Wrapped<T>;\n  Object.defineProperty(proxy, unwrapSymbol, {\n    value: item,\n    writable: false,\n    enumerable: false,\n    configurable: false,\n  });\n  return proxy;\n}\n"]}

package/dist/chunk-ADWSZ5GY.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/handlers/durable-objects.ts","../src/handlers/workflows.ts"],"names":["api_context","context","coldStarts","isColdStart","trace","SpanKind","SpanStatusCode","createInitialiser","setConfig"],"mappings":"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","file":"chunk-ADWSZ5GY.js","sourcesContent":["/**\n * Durable Objects instrumentation for Cloudflare Workers\n * \n * Note: This file uses Cloudflare Workers types (DurableObjectId, DurableObjectState, 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\nimport {\n  trace,\n  context as api_context,\n  propagation,\n  SpanStatusCode,\n  SpanKind,\n} from '@opentelemetry/api';\nimport type { ConfigurationOption } from 'autotel-edge';\nimport { createInitialiser, setConfig, WorkerTracer } from 'autotel-edge';\nimport { wrap } from '../bindings/common';\n\n// Durable Object types\ntype DOFetchFn = (request: Request) => Response | Promise<Response>;\ntype DOAlarmFn = () => void | Promise<void>;\n\n/**\n * Track cold starts per DO class\n */\nconst coldStarts = new WeakMap<any, boolean>();\n\nfunction isColdStart(doClass: any): boolean {\n  if (!coldStarts.has(doClass)) {\n    coldStarts.set(doClass, true);\n    return true;\n  }\n  return false;\n}\n\n/**\n * Instrument a Durable Object fetch method\n */\nfunction instrumentDOFetch(\n  fetchFn: DOFetchFn,\n  id: DurableObjectId,\n  doClass: any,\n): DOFetchFn {\n  return async function instrumentedFetch(\n    this: any,\n    request: Request,\n  ): Promise<Response> {\n    const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n    // Extract parent context from request headers\n    const parentContext = propagation.extract(\n      api_context.active(),\n      request.headers,\n    );\n\n    const url = new URL(request.url);\n    const spanName = `DO ${id.name || id.toString()}: ${request.method} ${url.pathname}`;\n\n    return tracer.startActiveSpan(\n      spanName,\n      {\n        kind: SpanKind.SERVER,\n        attributes: {\n          'http.request.method': request.method,\n          'url.full': request.url,\n          'do.id': id.toString(),\n          'do.id.name': id.name || '',\n          'faas.trigger': 'http',\n          'faas.coldstart': isColdStart(doClass),\n        },\n      },\n      parentContext,\n      async (span) => {\n        try {\n          const response = await fetchFn.call(this, request);\n\n          span.setAttributes({\n            'http.response.status_code': response.status,\n          });\n\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\n/**\n * Instrument a Durable Object alarm method\n */\nfunction instrumentDOAlarm(\n  alarmFn: DOAlarmFn,\n  id: DurableObjectId,\n  doClass: any,\n): DOAlarmFn {\n  return async function instrumentedAlarm(this: any): Promise<void> {\n    const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n    const spanName = `DO ${id.name || id.toString()}: alarm`;\n\n    return tracer.startActiveSpan(\n      spanName,\n      {\n        kind: SpanKind.INTERNAL,\n        attributes: {\n          'do.id': id.toString(),\n          'do.id.name': id.name || '',\n          'faas.trigger': 'timer',\n          'faas.coldstart': isColdStart(doClass),\n        },\n      },\n      async (span) => {\n        try {\n          await alarmFn.call(this);\n          span.setStatus({ code: SpanStatusCode.OK });\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/**\n * Instrument a Durable Object instance\n */\nfunction instrumentDOInstance(\n  doInstance: any,\n  state: DurableObjectState,\n  _env: any,\n  doClass: any,\n): any {\n  const instanceHandler: ProxyHandler<any> = {\n    get(target, prop) {\n      const value = Reflect.get(target, prop);\n\n      if (prop === 'fetch' && typeof value === 'function') {\n        return instrumentDOFetch(value.bind(target), state.id, doClass);\n      }\n\n      if (prop === 'alarm' && typeof value === 'function') {\n        return instrumentDOAlarm(value.bind(target), state.id, doClass);\n      }\n\n      // Bind other methods to the target\n      if (typeof value === 'function') {\n        return value.bind(target);\n      }\n\n      return value;\n    },\n  };\n\n  return wrap(doInstance, instanceHandler);\n}\n\n/**\n * Instrument a Durable Object class\n *\n * This wraps the DO class to automatically trace all fetch and alarm calls,\n * as well as initialize the telemetry configuration.\n *\n * **Usage:**\n * ```typescript\n * import { DurableObject } from 'cloudflare:workers'\n * import { instrumentDO } from 'autotel-edge'\n *\n * export class Counter extends DurableObject<Env> {\n *   async fetch(request: Request) {\n *     // Your DO logic here\n *     return new Response('OK')\n *   }\n * }\n *\n * // Wrap the class before exporting\n * export const CounterDO = instrumentDO(Counter, (env: Env) => ({\n *   exporter: {\n *     url: env.OTLP_ENDPOINT,\n *     headers: { 'x-api-key': env.API_KEY }\n *   },\n *   service: {\n *     name: 'my-durable-object',\n *     version: '1.0.0'\n *   }\n * }))\n * ```\n *\n * **What you get:**\n * - 🎯 Automatic spans for fetch() calls with HTTP attributes\n * - ⏰ Automatic spans for alarm() calls\n * - 🥶 Cold start tracking\n * - 🔗 Context propagation from incoming requests\n * - ⚡ Automatic span lifecycle management\n *\n * @param doClass - The Durable Object class to instrument\n * @param config - Configuration or configuration function\n * @returns Instrumented Durable Object class\n */\nexport function instrumentDO<C extends new (state: DurableObjectState, env: any) => any>(\n  doClass: C,\n  config: ConfigurationOption,\n): C {\n  const initialiser = createInitialiser(config);\n\n  const classHandler: ProxyHandler<C> = {\n    construct(target, [state, env]: [DurableObjectState, any]) {\n      // Initialize config for this DO instance\n      const trigger = {\n        id: state.id.toString(),\n        name: state.id.name,\n      };\n      const doConfig = initialiser(env, trigger);\n      const context = setConfig(doConfig);\n\n      // Create the DO instance within the config context\n      const doInstance = api_context.with(context, () => {\n        return new target(state, env);\n      });\n\n      // Instrument the instance\n      return instrumentDOInstance(doInstance, state, env, doClass);\n    },\n  };\n\n  return wrap(doClass, classHandler);\n}\n","/**\n * Cloudflare Workflows instrumentation for autotel-edge\n *\n * Instruments WorkflowEntrypoint classes to automatically trace workflow execution,\n * step operations, retries, and sleeps.\n *\n * Based on Cloudflare Workflows API:\n * https://developers.cloudflare.com/workflows/\n */\n\nimport {\n  trace,\n  context as api_context,\n  SpanStatusCode,\n  SpanKind,\n} from '@opentelemetry/api';\nimport type { ConfigurationOption } from 'autotel-edge';\nimport { createInitialiser, setConfig, WorkerTracer } from 'autotel-edge';\nimport { wrap } from '../bindings/common';\n\n// Workflow types (these would come from @cloudflare/workers-types when available)\ntype WorkflowEvent = any;\ntype WorkflowStep = any;\n\ntype WorkflowRunFn = (\n  event: WorkflowEvent,\n  step: WorkflowStep,\n) => Promise<void> | void;\n\n/**\n * Track cold starts per Workflow class\n */\nconst coldStarts = new WeakMap<any, boolean>();\n\nfunction isColdStart(workflowClass: any): boolean {\n  if (!coldStarts.has(workflowClass)) {\n    coldStarts.set(workflowClass, true);\n    return true;\n  }\n  return false;\n}\n\n/**\n * Proxy the step object to instrument step.do() calls\n */\nfunction instrumentWorkflowStep(\n  step: WorkflowStep,\n  workflowName: string,\n): WorkflowStep {\n  const stepHandler: ProxyHandler<WorkflowStep> = {\n    get(target, prop) {\n      const value = Reflect.get(target, prop);\n\n      // Instrument step.do() to create spans for each workflow step\n      if (prop === 'do' && typeof value === 'function') {\n        return new Proxy(value, {\n          apply: (fnTarget, thisArg, args) => {\n            const [stepName] = args as [string, () => Promise<any>];\n\n            const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n            return tracer.startActiveSpan(\n              `Workflow ${workflowName}: ${stepName}`,\n              {\n                kind: SpanKind.INTERNAL,\n                attributes: {\n                  'workflow.step.name': stepName,\n                  'workflow.name': workflowName,\n                },\n              },\n              async (span) => {\n                try {\n                  const result = await Reflect.apply(fnTarget, thisArg, args);\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:\n                      error instanceof Error ? error.message : String(error),\n                  });\n                  throw error;\n                } finally {\n                  span.end();\n                }\n              },\n            );\n          },\n        });\n      }\n\n      // Instrument step.sleep() to track workflow delays\n      if (prop === 'sleep' && typeof value === 'function') {\n        return new Proxy(value, {\n          apply: (fnTarget, thisArg, args) => {\n            const [sleepName, duration] = args as [string, string | number];\n\n            const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n            return tracer.startActiveSpan(\n              `Workflow ${workflowName}: sleep ${sleepName}`,\n              {\n                kind: SpanKind.INTERNAL,\n                attributes: {\n                  'workflow.sleep.name': sleepName,\n                  'workflow.sleep.duration': String(duration),\n                  'workflow.name': workflowName,\n                },\n              },\n              async (span) => {\n                try {\n                  const result = await Reflect.apply(fnTarget, thisArg, args);\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:\n                      error instanceof Error ? error.message : String(error),\n                  });\n                  throw error;\n                } finally {\n                  span.end();\n                }\n              },\n            );\n          },\n        });\n      }\n\n      // Pass through other step methods\n      if (typeof value === 'function') {\n        return value.bind(target);\n      }\n\n      return value;\n    },\n  };\n\n  return wrap(step, stepHandler);\n}\n\n/**\n * Instrument a Workflow run method\n */\nfunction instrumentWorkflowRun(\n  runFn: WorkflowRunFn,\n  workflowName: string,\n  workflowClass: any,\n): WorkflowRunFn {\n  return async function instrumentedRun(\n    this: any,\n    event: WorkflowEvent,\n    step: WorkflowStep,\n  ): Promise<void> {\n    const tracer = trace.getTracer('autotel-edge') as WorkerTracer;\n\n    // Instrument the step object to track individual operations\n    const instrumentedStep = instrumentWorkflowStep(step, workflowName);\n\n    const spanName = `Workflow ${workflowName}: run`;\n\n    return tracer.startActiveSpan(\n      spanName,\n      {\n        kind: SpanKind.INTERNAL,\n        attributes: {\n          'workflow.name': workflowName,\n          'faas.trigger': 'workflow',\n          'faas.coldstart': isColdStart(workflowClass),\n          // Add workflow event attributes if available\n          ...(event?.workflowId && { 'workflow.id': event.workflowId }),\n          ...(event?.runId && { 'workflow.run_id': event.runId }),\n        },\n      },\n      async (span) => {\n        try {\n          await runFn.call(this, event, instrumentedStep);\n          span.setStatus({ code: SpanStatusCode.OK });\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/**\n * Instrument a Workflow instance\n */\nfunction instrumentWorkflowInstance(\n  workflowInstance: any,\n  workflowName: string,\n  workflowClass: any,\n): any {\n  const instanceHandler: ProxyHandler<any> = {\n    get(target, prop) {\n      const value = Reflect.get(target, prop);\n\n      if (prop === 'run' && typeof value === 'function') {\n        return instrumentWorkflowRun(\n          value.bind(target),\n          workflowName,\n          workflowClass,\n        );\n      }\n\n      // Bind other methods to the target\n      if (typeof value === 'function') {\n        return value.bind(target);\n      }\n\n      return value;\n    },\n  };\n\n  return wrap(workflowInstance, instanceHandler);\n}\n\n/**\n * Instrument a Cloudflare Workflow class\n *\n * This wraps the WorkflowEntrypoint class to automatically trace workflow execution,\n * step operations, retries, and sleeps.\n *\n * **Usage:**\n * ```typescript\n * import { WorkflowEntrypoint } from 'cloudflare:workers'\n * import { instrumentWorkflow } from 'autotel-edge'\n *\n * export class CheckoutWorkflow extends WorkflowEntrypoint {\n *   async run(event, step) {\n *     await step.do('submit payment', async () => {\n *       return await submitToPaymentProcessor(event.params.payment)\n *     })\n *\n *     await step.sleep('wait for feedback', '2 days')\n *\n *     await step.do('send feedback email', sendFeedbackEmail)\n *   }\n * }\n *\n * // Wrap the class before exporting\n * export const CheckoutWorkflowInstrumented = instrumentWorkflow(\n *   CheckoutWorkflow,\n *   'checkout-workflow',\n *   (env: Env) => ({\n *     exporter: {\n *       url: env.OTLP_ENDPOINT,\n *       headers: { 'x-api-key': env.API_KEY }\n *     },\n *     service: {\n *       name: 'checkout-workflow',\n *       version: '1.0.0'\n *     }\n *   })\n * )\n * ```\n *\n * **What you get:**\n * - 🎯 Automatic spans for workflow.run() execution\n * - 📋 Automatic spans for each step.do() operation\n * - ⏸️ Automatic spans for step.sleep() operations\n * - 🔄 Automatic retry tracking (via step.do retries)\n * - 🥶 Cold start tracking\n * - ⚡ Automatic span lifecycle management\n *\n * @param workflowClass - The WorkflowEntrypoint class to instrument\n * @param workflowName - The name of the workflow (used in span names)\n * @param config - Configuration or configuration function\n * @returns Instrumented Workflow class\n */\nexport function instrumentWorkflow<\n  C extends new (...args: any[]) => any,\n>(\n  workflowClass: C,\n  workflowName: string,\n  config: ConfigurationOption,\n): C {\n  const initialiser = createInitialiser(config);\n\n  const classHandler: ProxyHandler<C> = {\n    construct(target, args: any[]) {\n      // Extract env from constructor args (typically last arg)\n      const env = args[args.length - 1] || {};\n\n      // Initialize config for this workflow instance\n      // Use Request as trigger type since workflows don't have a standard Trigger type yet\n      const trigger = new Request('https://workflow.local/run');\n      const workflowConfig = initialiser(env, trigger);\n      const context = setConfig(workflowConfig);\n\n      // Create the workflow instance within the config context\n      const workflowInstance = api_context.with(context, () => {\n        return new target(...args);\n      });\n\n      // Instrument the instance\n      return instrumentWorkflowInstance(\n        workflowInstance,\n        workflowName,\n        workflowClass,\n      );\n    },\n  };\n\n  return wrap(workflowClass, classHandler);\n}\n\n"]}