npm - autotel-cloudflare - Versions diffs - 3.1.0 → 4.0.0 - Mend

autotel-cloudflare 3.1.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (76) hide show

package/dist/agents.d.ts.map +1 -1
package/dist/agents.js +7 -0
package/dist/agents.js.map +1 -1
package/package.json +8 -4
package/src/actors/alarms.ts +0 -225
package/src/actors/index.ts +0 -36
package/src/actors/instrument-actor.test.ts +0 -179
package/src/actors/instrument-actor.ts +0 -574
package/src/actors/sockets.ts +0 -217
package/src/actors/storage.ts +0 -263
package/src/actors/traced-handler.ts +0 -300
package/src/actors/types.ts +0 -98
package/src/actors.ts +0 -50
package/src/agents/agent.ts +0 -327
package/src/agents/base.ts +0 -26
package/src/agents/index.ts +0 -46
package/src/agents/mcp.ts +0 -38
package/src/agents/observability.ts +0 -145
package/src/agents/otel-observability.test.ts +0 -269
package/src/agents/otel-observability.ts +0 -557
package/src/agents/types.ts +0 -61
package/src/agents.ts +0 -87
package/src/bindings/ai.test.ts +0 -170
package/src/bindings/ai.ts +0 -73
package/src/bindings/analytics-engine.test.ts +0 -175
package/src/bindings/analytics-engine.ts +0 -78
package/src/bindings/bindings-cache.test.ts +0 -80
package/src/bindings/bindings-detection.test.ts +0 -235
package/src/bindings/bindings-this-binding.test.ts +0 -294
package/src/bindings/bindings.ts +0 -720
package/src/bindings/browser-rendering.test.ts +0 -160
package/src/bindings/browser-rendering.ts +0 -70
package/src/bindings/common.ts +0 -84
package/src/bindings/hyperdrive.test.ts +0 -176
package/src/bindings/hyperdrive.ts +0 -74
package/src/bindings/images.test.ts +0 -262
package/src/bindings/images.ts +0 -182
package/src/bindings/index.ts +0 -20
package/src/bindings/queue-producer.test.ts +0 -224
package/src/bindings/queue-producer.ts +0 -105
package/src/bindings/rate-limiter.test.ts +0 -140
package/src/bindings/rate-limiter.ts +0 -69
package/src/bindings/vectorize.test.ts +0 -362
package/src/bindings/vectorize.ts +0 -86
package/src/bindings.ts +0 -6
package/src/events.ts +0 -6
package/src/execution-logger.test.ts +0 -127
package/src/execution-logger.ts +0 -112
package/src/global/cache.test.ts +0 -292
package/src/global/cache.ts +0 -164
package/src/global/fetch.test.ts +0 -399
package/src/global/fetch.ts +0 -136
package/src/global/index.ts +0 -7
package/src/handlers/durable-objects.test.ts +0 -524
package/src/handlers/durable-objects.ts +0 -250
package/src/handlers/index.ts +0 -6
package/src/handlers/workflows.test.ts +0 -411
package/src/handlers/workflows.ts +0 -345
package/src/handlers.ts +0 -6
package/src/index.ts +0 -91
package/src/logger.ts +0 -15
package/src/native/native-tracing.test.ts +0 -54
package/src/native/native-tracing.ts +0 -83
package/src/native.ts +0 -12
package/src/parse-error.ts +0 -1
package/src/sampling.ts +0 -6
package/src/testing.ts +0 -6
package/src/wrappers/cf-attributes.test.ts +0 -334
package/src/wrappers/define-worker-fetch.test.ts +0 -102
package/src/wrappers/define-worker-fetch.ts +0 -71
package/src/wrappers/index.ts +0 -13
package/src/wrappers/instrument.integration.test.ts +0 -578
package/src/wrappers/instrument.ts +0 -806
package/src/wrappers/native-instrument.test.ts +0 -153
package/src/wrappers/wrap-do.ts +0 -34
package/src/wrappers/wrap-module.ts +0 -37

package/src/bindings/browser-rendering.test.ts DELETED Viewed

@@ -1,160 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { instrumentBrowserRendering } from './browser-rendering';
-import { trace, SpanStatusCode, SpanKind } from '@opentelemetry/api';
-describe('Browser Rendering Instrumentation', () => {
-  let mockTracer: any;
-  let mockSpan: any;
-  let getTracerSpy: any;
-  let mockBrowser: 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(),
-    };
-    mockTracer = {
-      startActiveSpan: vi.fn((name, options, fn) => {
-        return fn(mockSpan);
-      }),
-    };
-    getTracerSpy = vi.spyOn(trace, 'getTracer').mockReturnValue(mockTracer as any);
-    mockBrowser = {
-      fetch: vi.fn(async () => new Response('<html></html>', { status: 200 })),
-      someOtherMethod: vi.fn(() => 'passthrough-value'),
-    };
-  });
-  afterEach(() => {
-    getTracerSpy.mockRestore();
-  });
-  describe('fetch()', () => {
-    it('should create span with correct attributes', async () => {
-      const instrumented = instrumentBrowserRendering(mockBrowser, 'my-browser');
-      await instrumented.fetch('https://example.com/page');
-      expect(mockTracer.startActiveSpan).toHaveBeenCalledTimes(1);
-      const [spanName, spanOptions] = mockTracer.startActiveSpan.mock.calls[0];
-      expect(spanName).toBe('BrowserRendering my-browser: fetch');
-      expect(spanOptions.kind).toBe(SpanKind.CLIENT);
-      expect(spanOptions.attributes['browser.system']).toBe('cloudflare-browser-rendering');
-      expect(spanOptions.attributes['url.full']).toBe('https://example.com/page');
-    });
-    it('should record http.response.status_code', async () => {
-      mockBrowser.fetch = vi.fn(async () => new Response('Not Found', { status: 404 }));
-      const instrumented = instrumentBrowserRendering(mockBrowser, 'my-browser');
-      await instrumented.fetch('https://example.com/missing');
-      expect(mockSpan.setAttribute).toHaveBeenCalledWith('http.response.status_code', 404);
-      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: SpanStatusCode.OK });
-      expect(mockSpan.end).toHaveBeenCalled();
-    });
-    it('should handle errors by recording exception and rethrowing', async () => {
-      const error = new Error('Browser rendering failed');
-      mockBrowser.fetch = vi.fn(async () => {
-        throw error;
-      });
-      const instrumented = instrumentBrowserRendering(mockBrowser, 'my-browser');
-      await expect(instrumented.fetch('https://example.com/broken')).rejects.toThrow('Browser rendering failed');
-      expect(mockSpan.recordException).toHaveBeenCalledWith(error);
-      expect(mockSpan.setStatus).toHaveBeenCalledWith({
-        code: SpanStatusCode.ERROR,
-        message: 'Browser rendering failed',
-      });
-      expect(mockSpan.end).toHaveBeenCalled();
-    });
-    it('should use default binding name when none provided', async () => {
-      const instrumented = instrumentBrowserRendering(mockBrowser);
-      await instrumented.fetch('https://example.com/page');
-      const spanName = mockTracer.startActiveSpan.mock.calls[0][0];
-      expect(spanName).toBe('BrowserRendering browser: fetch');
-    });
-    it('should handle URL objects as input', async () => {
-      const instrumented = instrumentBrowserRendering(mockBrowser, 'my-browser');
-      const url = new URL('https://example.com/rendered-page');
-      await instrumented.fetch(url);
-      const spanOptions = mockTracer.startActiveSpan.mock.calls[0][1];
-      expect(spanOptions.attributes['url.full']).toBe('https://example.com/rendered-page');
-    });
-    it('should handle Request objects as input', async () => {
-      const instrumented = instrumentBrowserRendering(mockBrowser, 'my-browser');
-      const request = new Request('https://example.com/request-page');
-      await instrumented.fetch(request);
-      const spanOptions = mockTracer.startActiveSpan.mock.calls[0][1];
-      expect(spanOptions.attributes['url.full']).toBe('https://example.com/request-page');
-    });
-    it('should set OK status and end span on success', async () => {
-      const instrumented = instrumentBrowserRendering(mockBrowser, 'my-browser');
-      const result = await instrumented.fetch('https://example.com/page');
-      expect(result).toBeInstanceOf(Response);
-      expect(mockSpan.setAttribute).toHaveBeenCalledWith('http.response.status_code', 200);
-      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: SpanStatusCode.OK });
-      expect(mockSpan.end).toHaveBeenCalled();
-    });
-  });
-  describe('this-binding', () => {
-    it('should invoke fetch() with original object as this, not the proxy', async () => {
-      let receivedThis: any;
-      const mockBrowserObj = {
-        fetch: vi.fn(async function(this: any) {
-          // eslint-disable-next-line unicorn/no-this-assignment, @typescript-eslint/no-this-alias
-          receivedThis = this;
-          return new Response('ok', { status: 200 });
-        }),
-      };
-      const instrumented = instrumentBrowserRendering(mockBrowserObj, 'test');
-      await instrumented.fetch('https://example.com');
-      expect(receivedThis).toBe(mockBrowserObj);
-    });
-  });
-  describe('Non-instrumented methods', () => {
-    it('should pass through non-instrumented methods unchanged', () => {
-      const instrumented = instrumentBrowserRendering(mockBrowser, 'my-browser');
-      const result = instrumented.someOtherMethod();
-      expect(result).toBe('passthrough-value');
-      expect(mockBrowser.someOtherMethod).toHaveBeenCalled();
-      // No span should be created for non-instrumented methods
-      expect(mockTracer.startActiveSpan).not.toHaveBeenCalled();
-    });
-  });
-});

package/src/bindings/browser-rendering.ts DELETED Viewed

@@ -1,70 +0,0 @@
-/**
- * Browser Rendering binding instrumentation
- */
-import {
-  trace,
-  SpanKind,
-  SpanStatusCode,
-} from '@opentelemetry/api';
-import type { WorkerTracer } from 'autotel-edge';
-import { wrap, setAttr } from './common';
-interface BrowserRenderingLike {
-  fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
-}
-/**
- * Instrument Browser Rendering binding (manual only — not auto-detected)
- */
-export function instrumentBrowserRendering<T extends BrowserRenderingLike>(browser: T, bindingName?: string): T {
-  const name = bindingName || 'browser';
-  const handler: ProxyHandler<T> = {
-    get(target, prop) {
-      const value = Reflect.get(target, prop);
-      if (prop === 'fetch' && typeof value === 'function') {
-        return new Proxy(value, {
-          apply: (fnTarget, _thisArg, args) => {
-            const [input] = args as [RequestInfo | URL, RequestInit | undefined];
-            const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
-            const tracer = trace.getTracer('autotel-edge') as WorkerTracer;
-            return tracer.startActiveSpan(
-              `BrowserRendering ${name}: fetch`,
-              {
-                kind: SpanKind.CLIENT,
-                attributes: {
-                  'browser.system': 'cloudflare-browser-rendering',
-                  'url.full': url,
-                },
-              },
-              async (span) => {
-                try {
-                  const result = await Reflect.apply(fnTarget, target, args);
-                  setAttr(span, 'http.response.status_code', result?.status);
-                  span.setStatus({ code: SpanStatusCode.OK });
-                  return result;
-                } catch (error) {
-                  span.recordException(error as Error);
-                  span.setStatus({
-                    code: SpanStatusCode.ERROR,
-                    message: error instanceof Error ? error.message : String(error),
-                  });
-                  throw error;
-                } finally {
-                  span.end();
-                }
-              },
-            );
-          },
-        });
-      }
-      return value;
-    },
-  };
-  return wrap(browser, handler);
-}

package/src/bindings/common.ts DELETED Viewed

@@ -1,84 +0,0 @@
-/**
- * Common instrumentation utilities
- */
-/**
- * Promise tracker for waitUntil
- */
-export class PromiseTracker {
-  private promises: Promise<unknown>[] = [];
-  track(promise: Promise<unknown>): void {
-    this.promises.push(promise);
-  }
-  async wait(): Promise<void> {
-    await Promise.allSettled(this.promises);
-  }
-}
-/**
- * Proxy ExecutionContext to track waitUntil promises
- */
-export function proxyExecutionContext(ctx: ExecutionContext): {
-  ctx: ExecutionContext;
-  tracker: PromiseTracker;
-} {
-  const tracker = new PromiseTracker();
-  const proxied = new Proxy(ctx, {
-    get(target, prop) {
-      if (prop === 'waitUntil') {
-        return (promise: Promise<unknown>) => {
-          tracker.track(promise);
-          return target.waitUntil(promise);
-        };
-      }
-      return Reflect.get(target, prop);
-    },
-  });
-  return { ctx: proxied, tracker };
-}
-/**
- * Helper to wrap/unwrap proxied objects
- */
-const unwrapSymbol = Symbol('unwrap');
-type Wrapped<T> = { [unwrapSymbol]: T } & T;
-export function isWrapped<T>(item: T): item is Wrapped<T> {
-  return item && !!(item as Wrapped<T>)[unwrapSymbol];
-}
-export function unwrap<T extends object>(item: T): T {
-  if (item && isWrapped(item)) {
-    return item[unwrapSymbol];
-  } else {
-    return item;
-  }
-}
-/**
- * Set attribute only if value is defined and non-null
- */
-export function setAttr(span: { setAttribute: (key: string, value: any) => void }, key: string, value: unknown): void {
-  if (value !== undefined && value !== null) {
-    span.setAttribute(key, value);
-  }
-}
-export function wrap<T extends object>(
-  item: T,
-  handler: ProxyHandler<T>,
-): Wrapped<T> {
-  const proxy = new Proxy(item, handler) as Wrapped<T>;
-  Object.defineProperty(proxy, unwrapSymbol, {
-    value: item,
-    writable: false,
-    enumerable: false,
-    configurable: false,
-  });
-  return proxy;
-}

package/src/bindings/hyperdrive.test.ts DELETED Viewed

@@ -1,176 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { instrumentHyperdrive } from './hyperdrive';
-import { trace, SpanStatusCode, SpanKind } from '@opentelemetry/api';
-describe('Hyperdrive Binding Instrumentation', () => {
-  let mockTracer: any;
-  let mockSpan: any;
-  let getTracerSpy: 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(),
-    };
-    mockTracer = {
-      startActiveSpan: vi.fn((name, options, fn) => {
-        return fn(mockSpan);
-      }),
-    };
-    getTracerSpy = vi.spyOn(trace, 'getTracer').mockReturnValue(mockTracer as any);
-  });
-  afterEach(() => {
-    getTracerSpy.mockRestore();
-  });
-  function createMockHyperdrive(overrides: Partial<Hyperdrive> = {}): Hyperdrive {
-    return {
-      connect: vi.fn(async () => ({} as Socket)),
-      connectionString: 'postgresql://user:secret-password@db.example.com:5432/mydb',
-      host: 'db.example.com',
-      port: 5432,
-      user: 'user',
-      password: 'secret-password',
-      database: 'mydb',
-      ...overrides,
-    } as unknown as Hyperdrive;
-  }
-  describe('connect()', () => {
-    it('should create span with correct attributes', async () => {
-      const mockHyperdrive = createMockHyperdrive();
-      const instrumented = instrumentHyperdrive(mockHyperdrive, 'my-db');
-      await instrumented.connect();
-      expect(mockTracer.startActiveSpan).toHaveBeenCalledTimes(1);
-      const [spanName, options] = mockTracer.startActiveSpan.mock.calls[0];
-      expect(spanName).toBe('Hyperdrive my-db: connect');
-      expect(options.kind).toBe(SpanKind.CLIENT);
-      expect(options.attributes['db.system']).toBe('cloudflare-hyperdrive');
-      expect(options.attributes['db.operation']).toBe('connect');
-      expect(options.attributes['server.address']).toBe('db.example.com');
-      expect(options.attributes['server.port']).toBe(5432);
-      expect(options.attributes['db.user']).toBe('user');
-    });
-    it('should handle errors correctly', async () => {
-      const connectError = new Error('Connection refused');
-      const mockHyperdrive = createMockHyperdrive({
-        connect: vi.fn(async () => {
-          throw connectError;
-        }) as any,
-      });
-      const instrumented = instrumentHyperdrive(mockHyperdrive, 'my-db');
-      await expect(instrumented.connect()).rejects.toThrow('Connection refused');
-      expect(mockSpan.recordException).toHaveBeenCalledWith(connectError);
-      expect(mockSpan.setStatus).toHaveBeenCalledWith({
-        code: SpanStatusCode.ERROR,
-        message: 'Connection refused',
-      });
-      expect(mockSpan.end).toHaveBeenCalled();
-    });
-    it('should set OK status and end span on success', async () => {
-      const mockSocket = { readable: true } as unknown as Socket;
-      const mockHyperdrive = createMockHyperdrive({
-        connect: vi.fn(async () => mockSocket) as any,
-      });
-      const instrumented = instrumentHyperdrive(mockHyperdrive, 'my-db');
-      const result = await instrumented.connect();
-      expect(result).toBe(mockSocket);
-      expect(mockSpan.setStatus).toHaveBeenCalledWith({ code: SpanStatusCode.OK });
-      expect(mockSpan.end).toHaveBeenCalled();
-    });
-    it('should use default binding name when none provided', async () => {
-      const mockHyperdrive = createMockHyperdrive();
-      const instrumented = instrumentHyperdrive(mockHyperdrive);
-      await instrumented.connect();
-      const [spanName] = mockTracer.startActiveSpan.mock.calls[0];
-      expect(spanName).toBe('Hyperdrive hyperdrive: connect');
-    });
-  });
-  describe('this-binding', () => {
-    it('should invoke connect() with original object as this, not the proxy', async () => {
-      let receivedThis: any;
-      const mockHyperdrive = {
-        connect: vi.fn(async function(this: any) {
-          // eslint-disable-next-line unicorn/no-this-assignment, @typescript-eslint/no-this-alias
-          receivedThis = this;
-          return {} as Socket;
-        }),
-        connectionString: 'postgresql://user:pass@host:5432/db',
-        host: 'host',
-        port: 5432,
-        user: 'user',
-        password: 'pass',
-        database: 'db',
-      } as unknown as Hyperdrive;
-      const instrumented = instrumentHyperdrive(mockHyperdrive, 'test');
-      await instrumented.connect();
-      expect(receivedThis).toBe(mockHyperdrive);
-    });
-  });
-  describe('non-instrumented properties', () => {
-    it('should pass through non-instrumented properties', () => {
-      const mockHyperdrive = createMockHyperdrive();
-      const instrumented = instrumentHyperdrive(mockHyperdrive, 'my-db');
-      expect(instrumented.connectionString).toBe('postgresql://user:secret-password@db.example.com:5432/mydb');
-      expect(instrumented.host).toBe('db.example.com');
-      expect(instrumented.port).toBe(5432);
-      expect(instrumented.user).toBe('user');
-      expect(instrumented.database).toBe('mydb');
-    });
-  });
-  describe('security', () => {
-    it('should never record password as an attribute', async () => {
-      const mockHyperdrive = createMockHyperdrive({
-        password: 'super-secret-password',
-      });
-      const instrumented = instrumentHyperdrive(mockHyperdrive, 'my-db');
-      await instrumented.connect();
-      const [, options] = mockTracer.startActiveSpan.mock.calls[0];
-      // Verify password is not in the attributes
-      const attributeKeys = Object.keys(options.attributes);
-      for (const key of attributeKeys) {
-        expect(options.attributes[key]).not.toBe('super-secret-password');
-      }
-      expect(options.attributes['db.password']).toBeUndefined();
-      expect(options.attributes['password']).toBeUndefined();
-      // Also verify setAttribute was not called with the password
-      for (const call of mockSpan.setAttribute.mock.calls) {
-        expect(call[1]).not.toBe('super-secret-password');
-      }
-    });
-  });
-});

package/src/bindings/hyperdrive.ts DELETED Viewed

@@ -1,74 +0,0 @@
-/**
- * Hyperdrive binding instrumentation
- */
-import {
-  trace,
-  SpanKind,
-  SpanStatusCode,
-} from '@opentelemetry/api';
-import type { WorkerTracer } from 'autotel-edge';
-import { wrap, setAttr } from './common';
-/**
- * Instrument Hyperdrive binding
- */
-export function instrumentHyperdrive<T extends Hyperdrive>(hyperdrive: T, bindingName?: string): T {
-  const name = bindingName || 'hyperdrive';
-  const handler: ProxyHandler<T> = {
-    get(target, prop) {
-      const value = Reflect.get(target, prop);
-      if (prop === 'connect' && typeof value === 'function') {
-        return new Proxy(value, {
-          apply: (fnTarget, _thisArg, args) => {
-            const tracer = trace.getTracer('autotel-edge') as WorkerTracer;
-            const attributes: Record<string, string | number> = {
-              'db.system': 'cloudflare-hyperdrive',
-              'db.operation': 'connect',
-            };
-            // Extract connection info safely (never record password)
-            try {
-              setAttr({ setAttribute: (k: string, v: any) => { if (v !== undefined && v !== null) attributes[k] = v; } }, 'server.address', target.host);
-              setAttr({ setAttribute: (k: string, v: any) => { if (v !== undefined && v !== null) attributes[k] = v; } }, 'server.port', target.port);
-              setAttr({ setAttribute: (k: string, v: any) => { if (v !== undefined && v !== null) attributes[k] = v; } }, 'db.user', target.user);
-            } catch {
-              // Properties may not be accessible in all environments
-            }
-            return tracer.startActiveSpan(
-              `Hyperdrive ${name}: connect`,
-              {
-                kind: SpanKind.CLIENT,
-                attributes,
-              },
-              async (span) => {
-                try {
-                  const result = await Reflect.apply(fnTarget, target, args);
-                  span.setStatus({ code: SpanStatusCode.OK });
-                  return result;
-                } catch (error) {
-                  span.recordException(error as Error);
-                  span.setStatus({
-                    code: SpanStatusCode.ERROR,
-                    message: error instanceof Error ? error.message : String(error),
-                  });
-                  throw error;
-                } finally {
-                  span.end();
-                }
-              },
-            );
-          },
-        });
-      }
-      return value;
-    },
-  };
-  return wrap(hyperdrive, handler);
-}