@oxy.so/telemetry 1.2.0 → 2.1.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oxy.so/telemetry",
-  "version": "1.2.0",
-  "description": "Framework-agnostic anonymous activity telemetry primitives for Oxy services.",
+  "version": "2.1.0",
+  "description": "Framework-agnostic anonymous activity telemetry and CloudWatch EMF metrics primitives for Oxy services.",
   "type": "module",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -20,8 +20,8 @@
       "socket": [
         "dist/types/socket.d.ts"
       ],
-      "edge": [
-        "dist/types/edge.d.ts"
+      "metrics": [
+        "dist/types/metrics.d.ts"
       ]
     }
   },
@@ -92,14 +92,14 @@
         "default": "./dist/cjs/socket.js"
       }
     },
-    "./edge": {
+    "./metrics": {
       "import": {
-        "types": "./dist/types/edge.d.ts",
-        "default": "./dist/esm/edge.js"
+        "types": "./dist/types/metrics.d.ts",
+        "default": "./dist/esm/metrics.js"
       },
       "require": {
-        "types": "./dist/types/edge.d.ts",
-        "default": "./dist/cjs/edge.js"
+        "types": "./dist/types/metrics.d.ts",
+        "default": "./dist/cjs/metrics.js"
       }
     }
   },
@@ -109,7 +109,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/oxyhq/sdk",
+    "url": "git+https://github.com/OxyHQ/oxy.git",
     "directory": "packages/telemetry"
   },
   "license": "SEE LICENSE IN LICENSE",
@@ -122,7 +122,7 @@
     "build": "bun run clean && bun run build:cjs && bun run build:esm && bun run build:types",
     "build:cjs": "tsc -p tsconfig.cjs.json && node scripts/mark-cjs.mjs",
     "build:esm": "tsc -p tsconfig.esm.json",
-    "build:types": "tsc -p tsconfig.types.json",
+    "build:types": "tsc -p tsconfig.types.json && node scripts/mark-types-cjs.mjs",
     "clean": "rm -rf dist",
     "typescript": "tsc --noEmit",
     "test": "jest",
@@ -130,7 +130,6 @@
     "prepublishOnly": "node ../../scripts/assert-bun-publish.mjs && bun run typescript && bun run test && bun run build"
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
     "@types/jest": "^30.0.0",
     "jest": "^30.5.1",
     "jest-environment-jsdom": "^30.5.1",

package/src/__tests__/browser.test.ts

@@ -47,8 +47,15 @@ describe('browser telemetry', () => {
   it('rediscovers the edge after a VPN change without reloading the page', async () => {
     let now = 1_000;
     let edge = 'MAD';
-    const fetchTrace = jest.fn(async () => ({ ok: true, text: async () => `colo=${edge}\nip=203.0.113.8\nloc=ES` }));
-    const telemetry = createBrowserTelemetry({ location: { hostname: 'oxy.so', protocol: 'https:' }, now: () => now, fetchTrace });
+    const fetchTrace = jest.fn(async () => ({
+      ok: true,
+      text: async () => `colo=${edge}\nip=203.0.113.8\nloc=ES`,
+    }));
+    const telemetry = createBrowserTelemetry({
+      location: { hostname: 'oxy.so', protocol: 'https:' },
+      now: () => now,
+      fetchTrace,
+    });
     await expect(telemetry.getEdgeRegionHeader()).resolves.toEqual({ 'X-Oxy-Edge-Region': 'mad' });
     edge = 'NRT';
     now += 15_000;
@@ -58,13 +65,19 @@ describe('browser telemetry', () => {
 
   it('retries failed discovery on the next window instead of caching failure for the session', async () => {
     let now = 1_000;
-    const fetchTrace = jest.fn().mockRejectedValueOnce(new Error('offline')).mockResolvedValue({ ok: true, text: async () => 'colo=SYD' });
-    const telemetry = createBrowserTelemetry({ location: { hostname: 'oxy.so', protocol: 'https:' }, now: () => now, fetchTrace });
+    const fetchTrace = jest
+      .fn()
+      .mockRejectedValueOnce(new Error('offline'))
+      .mockResolvedValue({ ok: true, text: async () => 'colo=SYD' });
+    const telemetry = createBrowserTelemetry({
+      location: { hostname: 'oxy.so', protocol: 'https:' },
+      now: () => now,
+      fetchTrace,
+    });
     await expect(telemetry.getEdgeRegionHeader()).resolves.toEqual({});
     now += 15_000;
     await expect(telemetry.getEdgeRegionHeader()).resolves.toEqual({ 'X-Oxy-Edge-Region': 'syd' });
   });
-
 });
 
 describe('peekEdgeRegionHeader', () => {
@@ -75,7 +88,10 @@ describe('peekEdgeRegionHeader', () => {
       now: () => clock,
       location: { hostname: 'app.oxy.so', protocol: 'https:' },
       edgePeekRefreshMs: 1000,
-      fetchTrace: async () => ({ ok: true, text: async () => `colo=${pops.shift()?.toUpperCase()}\n` }),
+      fetchTrace: async () => ({
+        ok: true,
+        text: async () => `colo=${pops.shift()?.toUpperCase()}\n`,
+      }),
     });
 
     expect(telemetry.peekEdgeRegionHeader()).toEqual({});

package/src/__tests__/collector.test.ts

@@ -1,48 +1,95 @@
 /** @jest-environment node */
 import { EventEmitter } from 'node:events';
-import { createTrafficCollector, instrumentTrafficFetch, trafficMiddleware, trafficType, type TrafficAggregate } from '../collector';
+import {
+  createTrafficCollector,
+  instrumentTrafficFetch,
+  trafficMiddleware,
+  trafficType,
+  type TrafficAggregate,
+} from '../collector';
 
 describe('ecosystem activity collector', () => {
   it('reports all products independently of dashboard viewers and counts errors too', async () => {
     const batches: TrafficAggregate[][] = [];
-    const collector = createTrafficCollector(async events => { batches.push(events); });
+    const collector = createTrafficCollector(async (events) => {
+      batches.push(events);
+    });
     for (const service of ['website', 'mention', 'mercaria', 'alia', 'kaana']) {
       const response = new EventEmitter();
-      trafficMiddleware(collector, service, 'us-west-2')({ path: '/api/files/private-id', headers: { 'cf-ray': 'example-NRT', authorization: 'secret' } }, response, () => {});
+      trafficMiddleware(collector, service, 'us-west-2')(
+        {
+          path: '/api/files/private-id',
+          headers: { 'cf-ray': 'example-NRT', authorization: 'secret' },
+        },
+        response,
+        () => {},
+      );
       response.emit('finish');
       response.emit('close');
     }
     await collector.flush();
     expect(batches[0]).toHaveLength(10);
-    expect(batches[0].filter(event => event.direction === 'inbound')).toHaveLength(5);
-    expect(batches[0].every(event => event.activityType === 'media')).toBe(true);
+    expect(batches[0].filter((event) => event.direction === 'inbound')).toHaveLength(5);
+    expect(batches[0].every((event) => event.activityType === 'media')).toBe(true);
     expect(JSON.stringify(batches)).not.toMatch(/private-id|secret|authorization/);
   });
 
   it('keeps scope, direction and category independent for co-located internal services', async () => {
     const batches: TrafficAggregate[][] = [];
-    const collector = createTrafficCollector(async events => { batches.push(events); });
+    const collector = createTrafficCollector(async (events) => {
+      batches.push(events);
+    });
     const response = new EventEmitter();
-    const request = { path: '/v1/chat/completions', headers: { 'x-oxy-source-region': 'us-west-2' }, serviceApp: undefined as undefined | { appName: string } };
-    trafficMiddleware(collector, 'kaana', 'us-west-2')(request, response, () => { request.serviceApp = { appName: 'oxy-api' }; });
+    const request = {
+      path: '/v1/chat/completions',
+      headers: { 'x-oxy-source-region': 'us-west-2' },
+      serviceApp: undefined as undefined | { appName: string },
+    };
+    trafficMiddleware(collector, 'kaana', 'us-west-2')(request, response, () => {
+      request.serviceApp = { appName: 'oxy-api' };
+    });
     response.emit('finish');
     await collector.flush();
     expect(batches[0]).toEqual([
-      expect.objectContaining({ sourceRegion: 'us-west-2', targetRegion: 'us-west-2', sourceService: 'oxy-api', targetService: 'kaana', direction: 'inbound', scope: 'internal', activityType: 'ai' }),
-      expect.objectContaining({ sourceService: 'kaana', targetService: 'oxy-api', direction: 'outbound', scope: 'internal', activityType: 'ai' }),
+      expect.objectContaining({
+        sourceRegion: 'us-west-2',
+        targetRegion: 'us-west-2',
+        sourceService: 'oxy-api',
+        targetService: 'kaana',
+        direction: 'inbound',
+        scope: 'internal',
+        activityType: 'ai',
+      }),
+      expect.objectContaining({
+        sourceService: 'kaana',
+        targetService: 'oxy-api',
+        direction: 'outbound',
+        scope: 'internal',
+        activityType: 'ai',
+      }),
     ]);
   });
 
   it('does not fabricate a response on abort and excludes telemetry control traffic', async () => {
     const batches: TrafficAggregate[][] = [];
-    const collector = createTrafficCollector(async events => { batches.push(events); });
+    const collector = createTrafficCollector(async (events) => {
+      batches.push(events);
+    });
     for (const path of ['/health', '/api/ready', '/platform-stats/stream', '/internal/activity']) {
       const response = new EventEmitter();
-      trafficMiddleware(collector, 'website', 'us-west-2')({ path, headers: {} }, response, () => {});
+      trafficMiddleware(collector, 'website', 'us-west-2')(
+        { path, headers: {} },
+        response,
+        () => {},
+      );
       response.emit('finish');
     }
     const aborted = new EventEmitter();
-    trafficMiddleware(collector, 'mention', 'us-west-2')({ path: '/messages', headers: {} }, aborted, () => {});
+    trafficMiddleware(collector, 'mention', 'us-west-2')(
+      { path: '/messages', headers: {} },
+      aborted,
+      () => {},
+    );
     aborted.emit('close');
     await collector.flush();
     expect(batches[0]).toHaveLength(1);
@@ -51,41 +98,99 @@ describe('ecosystem activity collector', () => {
 
   it('tracks real outgoing calls and only reports the response when one arrived', async () => {
     const batches: TrafficAggregate[][] = [];
-    const collector = createTrafficCollector(async events => { batches.push(events); });
-    const fetcher = instrumentTrafficFetch(jest.fn(async () => new Response('ok', { headers: { 'X-Oxy-Region': 'eu-central-1' } })) as unknown as typeof fetch, collector, 'alia', 'us-west-2', url => url.hostname === 'api.oxy.so' ? { service: 'oxy-api', region: 'us-west-2' } : undefined);
+    const collector = createTrafficCollector(async (events) => {
+      batches.push(events);
+    });
+    const fetcher = instrumentTrafficFetch(
+      jest.fn(
+        async () => new Response('ok', { headers: { 'X-Oxy-Region': 'eu-central-1' } }),
+      ) as unknown as typeof fetch,
+      collector,
+      'alia',
+      'us-west-2',
+      (url) =>
+        url.hostname === 'api.oxy.so' ? { service: 'oxy-api', region: 'us-west-2' } : undefined,
+    );
     await fetcher('https://api.oxy.so/v1/chat/completions');
     await collector.flush();
-    expect(batches[0].map(event => event.direction)).toEqual(['outbound', 'inbound']);
-    expect(batches[0].every(event => event.scope === 'internal')).toBe(true);
+    expect(batches[0].map((event) => event.direction)).toEqual(['outbound', 'inbound']);
+    expect(batches[0].every((event) => event.scope === 'internal')).toBe(true);
     expect(batches[0][0].targetRegion).toBe('eu-central-1');
     expect(batches[0][1].sourceRegion).toBe('eu-central-1');
-    const failed = instrumentTrafficFetch(jest.fn(async () => { throw new Error('offline'); }) as unknown as typeof fetch, collector, 'alia', 'us-west-2', () => undefined);
+    const failed = instrumentTrafficFetch(
+      jest.fn(async () => {
+        throw new Error('offline');
+      }) as unknown as typeof fetch,
+      collector,
+      'alia',
+      'us-west-2',
+      () => undefined,
+    );
     await expect(failed('https://example.com/files')).rejects.toThrow('offline');
     await collector.flush();
     expect(batches[1]).toHaveLength(1);
-    expect(batches[1][0]).toMatchObject({ scope: 'external', direction: 'outbound', activityType: 'media' });
+    expect(batches[1][0]).toMatchObject({
+      scope: 'external',
+      direction: 'outbound',
+      activityType: 'media',
+    });
   });
 
   it('chunks a busy fleet into ingestible batches and preserves fetch extensions', async () => {
     const batches: TrafficAggregate[][] = [];
-    const collector = createTrafficCollector(async events => { batches.push(events); });
-    for (let index = 0; index < 300; index++) collector.record({ region: 'us-west-2', service: `service-${index}`, scope: 'internal', direction: 'inbound', activityType: 'platform' });
+    const collector = createTrafficCollector(async (events) => {
+      batches.push(events);
+    });
+    for (let index = 0; index < 300; index++)
+      collector.record({
+        region: 'us-west-2',
+        service: `service-${index}`,
+        scope: 'internal',
+        direction: 'inbound',
+        activityType: 'platform',
+      });
     await collector.flush();
-    expect(batches.map(batch => batch.length)).toEqual([256, 44]);
+    expect(batches.map((batch) => batch.length)).toEqual([256, 44]);
     const preconnect = jest.fn();
-    const baseFetch = Object.assign(jest.fn(async () => new Response()), { preconnect }) as unknown as typeof fetch;
-    const wrapped = instrumentTrafficFetch(baseFetch, collector, 'website', 'us-west-2', () => undefined);
+    const baseFetch = Object.assign(
+      jest.fn(async () => new Response()),
+      { preconnect },
+    ) as unknown as typeof fetch;
+    const wrapped = instrumentTrafficFetch(
+      baseFetch,
+      collector,
+      'website',
+      'us-west-2',
+      () => undefined,
+    );
     expect((wrapped as typeof baseFetch & { preconnect: unknown }).preconnect).toBe(preconnect);
   });
 
   it('keeps verified internal attribution when a request aborts', async () => {
     const batches: TrafficAggregate[][] = [];
-    const collector = createTrafficCollector(async events => { batches.push(events); });
+    const collector = createTrafficCollector(async (events) => {
+      batches.push(events);
+    });
     const response = new EventEmitter();
-    trafficMiddleware(collector, 'oxy-api', 'us-west-2')({ path: '/messages', headers: { 'x-oxy-source-region': 'eu-west-1' }, serviceApp: { appName: 'mention' } }, response, () => {});
+    trafficMiddleware(collector, 'oxy-api', 'us-west-2')(
+      {
+        path: '/messages',
+        headers: { 'x-oxy-source-region': 'eu-west-1' },
+        serviceApp: { appName: 'mention' },
+      },
+      response,
+      () => {},
+    );
     response.emit('close');
     await collector.flush();
-    expect(batches[0]).toEqual([expect.objectContaining({ scope: 'internal', direction: 'inbound', sourceRegion: 'eu-west-1', sourceService: 'mention' })]);
+    expect(batches[0]).toEqual([
+      expect.objectContaining({
+        scope: 'internal',
+        direction: 'inbound',
+        sourceRegion: 'eu-west-1',
+        sourceService: 'mention',
+      }),
+    ]);
   });
 
   it('classifies versioned media and inference endpoints without retaining the path', () => {

package/src/__tests__/metrics.test.ts

@@ -0,0 +1,45 @@
+import { createEmfPublisher, HTTP_REQUEST_LATENCY, HTTP_RATE_LIMITED } from '../metrics';
+
+describe('EMF publisher', () => {
+  it('folds an interval into one EMF line per series with bounded dimensions', () => {
+    const lines: string[] = [];
+    const publisher = createEmfPublisher({
+      namespace: 'Oxy/Test',
+      service: 'svc',
+      write: (line) => lines.push(line),
+      now: () => 1_000,
+      maxSeries: 2,
+    });
+    const labels = { Route: '/users/:id', StatusClass: '2xx', Caller: 'anonymous' };
+    for (const ms of [10, 10, 200]) publisher.record(HTTP_REQUEST_LATENCY, ms, labels);
+    publisher.record(HTTP_RATE_LIMITED, 1, { Caller: 'service:app' });
+    // A third series exceeds maxSeries and folds into `other`.
+    publisher.record(HTTP_RATE_LIMITED, 1, { Caller: 'service:another' });
+    publisher.stop();
+
+    const [latency, limited, overflow] = lines.map((line) => JSON.parse(line));
+    expect(latency._aws).toEqual({
+      Timestamp: 1_000,
+      CloudWatchMetrics: [
+        {
+          Namespace: 'Oxy/Test',
+          Dimensions: [['Service'], ['Service', 'StatusClass'], ['Service', 'Caller']],
+          Metrics: [{ Name: 'RequestLatency', Unit: 'Milliseconds' }],
+        },
+      ],
+    });
+    expect(latency).toMatchObject({ Service: 'svc', Route: '/users/:id', StatusClass: '2xx' });
+    // Values are ~5 % buckets; Count/Sum/Min/Max stay exact.
+    expect(latency.RequestLatency.Values).toEqual([9.91, 204]);
+    expect(latency.RequestLatency).toMatchObject({
+      Counts: [2, 1],
+      Max: 200,
+      Min: 10,
+      Count: 3,
+      Sum: 220,
+    });
+    expect(limited).toMatchObject({ Caller: 'service:app', RateLimited: 1 });
+    expect(overflow).toMatchObject({ Caller: 'other', RateLimited: 1 });
+    expect(lines).toHaveLength(3);
+  });
+});

package/src/__tests__/server.test.ts

@@ -10,11 +10,13 @@ import {
 
 describe('server telemetry primitives', () => {
   it('prefers a validated forwarded PoP and accepts Cloudflare ray fallback', () => {
-    expect(metadataFromHeaders({
-      'x-oxy-edge-region': 'MAD',
-      'cf-ray': 'deadbeef-CDG',
-      'x-oxy-activity-id': 'anonymous-runtime-a1',
-    })).toEqual({ edgePop: 'mad', activityId: 'anonymous-runtime-a1' });
+    expect(
+      metadataFromHeaders({
+        'x-oxy-edge-region': 'MAD',
+        'cf-ray': 'deadbeef-CDG',
+        'x-oxy-activity-id': 'anonymous-runtime-a1',
+      }),
+    ).toEqual({ edgePop: 'mad', activityId: 'anonymous-runtime-a1' });
     expect(metadataFromHeaders({ 'cf-ray': 'deadbeef-CDG' })).toEqual({ edgePop: 'cdg' });
   });
 

package/src/__tests__/socket.test.ts

@@ -8,22 +8,42 @@ class TestSocket extends EventEmitter {
   nsp = { name: '/messages' };
   incoming = new Set<(event: string) => void>();
   outgoing = new Set<(event: string) => void>();
-  onAny(listener: (event: string) => void) { this.incoming.add(listener); }
-  onAnyOutgoing(listener: (event: string) => void) { this.outgoing.add(listener); }
-  offAny(listener: (event: string) => void) { this.incoming.delete(listener); }
-  offAnyOutgoing(listener: (event: string) => void) { this.outgoing.delete(listener); }
+  onAny(listener: (event: string) => void) {
+    this.incoming.add(listener);
+  }
+  onAnyOutgoing(listener: (event: string) => void) {
+    this.outgoing.add(listener);
+  }
+  offAny(listener: (event: string) => void) {
+    this.incoming.delete(listener);
+  }
+  offAnyOutgoing(listener: (event: string) => void) {
+    this.outgoing.delete(listener);
+  }
 }
 
 describe('socket traffic', () => {
   it('records real application directions and strips event identifiers and payloads', () => {
     const socket = new TestSocket();
     const events: TrafficFlow[] = [];
-    observeTrafficSocket(socket, { record: event => events.push(event) }, 'syra', 'us-west-2');
-    socket.incoming.forEach(listener => listener('player:private-track-id'));
-    socket.outgoing.forEach(listener => listener('message:private-user-id'));
+    observeTrafficSocket(socket, { record: (event) => events.push(event) }, 'syra', 'us-west-2');
+    socket.incoming.forEach((listener) => listener('player:private-track-id'));
+    socket.outgoing.forEach((listener) => listener('message:private-user-id'));
     expect(events).toEqual([
-      expect.objectContaining({ scope: 'external', direction: 'inbound', sourceRegion: 'edge-mad', targetRegion: 'us-west-2', activityType: 'media' }),
-      expect.objectContaining({ scope: 'external', direction: 'outbound', sourceRegion: 'us-west-2', targetRegion: 'edge-mad', activityType: 'communication' }),
+      expect.objectContaining({
+        scope: 'external',
+        direction: 'inbound',
+        sourceRegion: 'edge-mad',
+        targetRegion: 'us-west-2',
+        activityType: 'media',
+      }),
+      expect.objectContaining({
+        scope: 'external',
+        direction: 'outbound',
+        sourceRegion: 'us-west-2',
+        targetRegion: 'edge-mad',
+        activityType: 'communication',
+      }),
     ]);
     expect(JSON.stringify(events)).not.toMatch(/private|authorization|track-id|user-id/);
     socket.emit('disconnect');
@@ -34,11 +54,23 @@ describe('socket traffic', () => {
     const socket = new TestSocket();
     const events: TrafficFlow[] = [];
     let peer: { service: string; region: string } | undefined;
-    const stop = observeTrafficSocket(socket, { record: event => events.push(event) }, 'alia', 'us-west-2', { getPeer: () => peer });
+    const stop = observeTrafficSocket(
+      socket,
+      { record: (event) => events.push(event) },
+      'alia',
+      'us-west-2',
+      { getPeer: () => peer },
+    );
     peer = { service: 'mention', region: 'eu-west-1' };
-    socket.incoming.forEach(listener => listener('agent:update'));
-    expect(events[0]).toMatchObject({ scope: 'internal', sourceService: 'mention', sourceRegion: 'eu-west-1', activityType: 'ai' });
-    stop(); stop();
+    socket.incoming.forEach((listener) => listener('agent:update'));
+    expect(events[0]).toMatchObject({
+      scope: 'internal',
+      sourceService: 'mention',
+      sourceRegion: 'eu-west-1',
+      activityType: 'ai',
+    });
+    stop();
+    stop();
     expect(socket.listenerCount('disconnect')).toBe(0);
   });
 
@@ -61,32 +93,39 @@ describe('real Socket.IO transport', () => {
     const server = createServer();
     const sockets = new Server(server);
     const events: TrafficFlow[] = [];
-    sockets.on('connection', socket => {
-      observeTrafficSocket(socket, { record: flow => events.push(flow) }, 'syra', 'us-west-2');
+    sockets.on('connection', (socket) => {
+      observeTrafficSocket(socket, { record: (flow) => events.push(flow) }, 'syra', 'us-west-2');
       socket.on('player:seek', (_position, acknowledge) => {
         acknowledge('ok');
         sockets.emit('player:state', { privateTrackId: 'never-published' });
       });
     });
-    await new Promise<void>(resolve => server.listen(0, '127.0.0.1', resolve));
+    await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve));
     const address = server.address();
     if (!address || typeof address === 'string') throw new Error('Missing listener');
-    const client = io(`http://127.0.0.1:${address.port}`, { transports: ['websocket'], extraHeaders: { 'X-Oxy-Edge-Region': 'NRT' } });
+    const client = io(`http://127.0.0.1:${address.port}`, {
+      transports: ['websocket'],
+      extraHeaders: { 'X-Oxy-Edge-Region': 'NRT' },
+    });
     try {
-      await new Promise<void>((resolve, reject) => { client.once('connect', resolve); client.once('connect_error', reject); });
-      const received = new Promise<void>(resolve => client.once('player:state', () => resolve()));
+      await new Promise<void>((resolve, reject) => {
+        client.once('connect', resolve);
+        client.once('connect_error', reject);
+      });
+      const received = new Promise<void>((resolve) => client.once('player:state', () => resolve()));
       await client.emitWithAck('player:seek', 42);
       await received;
       expect(events).toHaveLength(2);
-      expect(events.map(flow => [flow.direction, flow.scope, flow.activityType])).toEqual([
-        ['inbound', 'external', 'media'], ['outbound', 'external', 'media'],
+      expect(events.map((flow) => [flow.direction, flow.scope, flow.activityType])).toEqual([
+        ['inbound', 'external', 'media'],
+        ['outbound', 'external', 'media'],
       ]);
       expect(events[0].sourceRegion).toBe('edge-nrt');
       expect(events[1].targetRegion).toBe('edge-nrt');
       expect(JSON.stringify(events)).not.toContain('never-published');
     } finally {
       client.disconnect();
-      await new Promise<void>(resolve => sockets.close(() => resolve()));
+      await new Promise<void>((resolve) => sockets.close(() => resolve()));
     }
   });
 });
@@ -97,21 +136,33 @@ describe('raw WebSocket transport', () => {
     const events: TrafficFlow[] = [];
     const original = jest.fn((_data: unknown, callback: (error?: Error) => void) => callback());
     const socket = Object.assign(new EventEmitter(), { readyState: 1, send: original });
-    const stop = observeTrafficWebSocket(socket, { record: flow => events.push(flow) }, 'alia', 'us-west-2', {
-      activityType: 'ai', getPeer: () => ({ service: 'alia-integrations', region: 'eu-west-1' }),
-    });
+    const stop = observeTrafficWebSocket(
+      socket,
+      { record: (flow) => events.push(flow) },
+      'alia',
+      'us-west-2',
+      {
+        activityType: 'ai',
+        getPeer: () => ({ service: 'alia-integrations', region: 'eu-west-1' }),
+      },
+    );
     const callback = jest.fn();
     socket.send({ privateBody: 'not-recorded' }, callback);
     socket.emit('message', Buffer.from('private-message'));
     expect(original).toHaveBeenCalledWith({ privateBody: 'not-recorded' }, callback);
     expect(callback).toHaveBeenCalledTimes(1);
-    expect(events.map(flow => flow.direction)).toEqual(['outbound', 'inbound']);
-    expect(events.every(flow => flow.scope === 'internal' && flow.activityType === 'ai')).toBe(true);
+    expect(events.map((flow) => flow.direction)).toEqual(['outbound', 'inbound']);
+    expect(events.every((flow) => flow.scope === 'internal' && flow.activityType === 'ai')).toBe(
+      true,
+    );
     expect(JSON.stringify(events)).not.toMatch(/private|not-recorded/);
-    original.mockImplementationOnce(() => { throw new Error('send failed'); });
+    original.mockImplementationOnce(() => {
+      throw new Error('send failed');
+    });
     expect(() => socket.send('', callback)).toThrow('send failed');
     expect(events).toHaveLength(2);
-    stop(); stop();
+    stop();
+    stop();
     expect(socket.send).toBe(original);
     expect(socket.listenerCount('message')).toBe(0);
   });