@oxy.so/telemetry 1.2.0 → 2.0.0

package/dist/cjs/browser.js

@@ -26,9 +26,9 @@ function createUuid(cryptoApi) {
 function eligibleLocation(location) {
     if (!location || (location.protocol !== 'https:' && location.protocol !== 'http:'))
         return false;
-    return location.hostname !== 'localhost'
-        && location.hostname !== '127.0.0.1'
-        && location.hostname !== '[::1]';
+    return (location.hostname !== 'localhost' &&
+        location.hostname !== '127.0.0.1' &&
+        location.hostname !== '[::1]');
 }
 function createBrowserTelemetry(options = {}) {
     let activityId = null;
@@ -41,7 +41,9 @@ function createBrowserTelemetry(options = {}) {
         if (!hasInjectedBrowser && !hasBrowserRuntime)
             return {};
         const now = (options.now ?? Date.now)();
-        if (!activityId || now < activityIdCreatedAt || now - activityIdCreatedAt >= (options.activityIdRotationMs ?? exports.DEFAULT_ACTIVITY_ID_ROTATION_MS)) {
+        if (!activityId ||
+            now < activityIdCreatedAt ||
+            now - activityIdCreatedAt >= (options.activityIdRotationMs ?? exports.DEFAULT_ACTIVITY_ID_ROTATION_MS)) {
             activityId = createUuid(options.crypto ?? globalThis.crypto);
             if (!activityId)
                 return {};
@@ -58,7 +60,11 @@ function createBrowserTelemetry(options = {}) {
         try {
             const response = await (options.fetchTrace
                 ? options.fetchTrace(controller.signal)
-                : fetch('/cdn-cgi/trace', { cache: 'no-store', credentials: 'omit', signal: controller.signal }));
+                : fetch('/cdn-cgi/trace', {
+                    cache: 'no-store',
+                    credentials: 'omit',
+                    signal: controller.signal,
+                }));
             if (!response.ok)
                 return null;
             const match = (await response.text()).match(/^colo=([a-z]{3})$/im);
@@ -73,7 +79,9 @@ function createBrowserTelemetry(options = {}) {
     };
     const getEdgeRegionHeader = async () => {
         const now = (options.now ?? Date.now)();
-        if (!edgePopPromise || now < edgePopReadAt || now - edgePopReadAt >= (options.edgeCacheMs ?? exports.DEFAULT_EDGE_CACHE_MS)) {
+        if (!edgePopPromise ||
+            now < edgePopReadAt ||
+            now - edgePopReadAt >= (options.edgeCacheMs ?? exports.DEFAULT_EDGE_CACHE_MS)) {
             edgePopReadAt = now;
             edgePopPromise = discoverEdgePop();
         }
@@ -85,7 +93,9 @@ function createBrowserTelemetry(options = {}) {
     let peekInFlight = false;
     const peekEdgeRegionHeader = () => {
         const now = (options.now ?? Date.now)();
-        if (!peekInFlight && (now < peekRefreshAt || now - peekRefreshAt >= (options.edgePeekRefreshMs ?? exports.DEFAULT_EDGE_PEEK_REFRESH_MS))) {
+        if (!peekInFlight &&
+            (now < peekRefreshAt ||
+                now - peekRefreshAt >= (options.edgePeekRefreshMs ?? exports.DEFAULT_EDGE_PEEK_REFRESH_MS))) {
             peekRefreshAt = now;
             peekInFlight = true;
             void discoverEdgePop()
@@ -104,7 +114,7 @@ function createBrowserTelemetry(options = {}) {
         getEdgeRegionHeader,
         peekEdgeRegionHeader,
         async getHeaders() {
-            return { ...await getEdgeRegionHeader(), ...getActivityIdHeader() };
+            return { ...(await getEdgeRegionHeader()), ...getActivityIdHeader() };
         },
     };
 }

package/dist/cjs/collector.js

@@ -9,11 +9,34 @@ exports.infrastructureLocation = infrastructureLocation;
 exports.normalizeInfrastructureRegion = normalizeInfrastructureRegion;
 const server_js_1 = require("./server.js");
 const TYPES = {
-    auth: 'identity', session: 'identity', users: 'identity', profiles: 'identity', accounts: 'identity',
-    ai: 'ai', inference: 'ai', models: 'ai', chat: 'ai', completions: 'ai',
-    stream: 'media', tracks: 'media', episodes: 'media', recordings: 'media', rooms: 'media',
-    messages: 'communication', notifications: 'communication', mail: 'communication',
-    media: 'media', files: 'media', assets: 'media', upload: 'media', uploads: 'media', cdn: 'media', storage: 'media', images: 'media', audio: 'media', videos: 'media',
+    auth: 'identity',
+    session: 'identity',
+    users: 'identity',
+    profiles: 'identity',
+    accounts: 'identity',
+    ai: 'ai',
+    inference: 'ai',
+    models: 'ai',
+    chat: 'ai',
+    completions: 'ai',
+    stream: 'media',
+    tracks: 'media',
+    episodes: 'media',
+    recordings: 'media',
+    rooms: 'media',
+    messages: 'communication',
+    notifications: 'communication',
+    mail: 'communication',
+    media: 'media',
+    files: 'media',
+    assets: 'media',
+    upload: 'media',
+    uploads: 'media',
+    cdn: 'media',
+    storage: 'media',
+    images: 'media',
+    audio: 'media',
+    videos: 'media',
 };
 function trafficType(path) {
     const parts = path.split('?')[0].split('/').filter(Boolean);
@@ -43,7 +66,12 @@ function createTrafficCollector(publish, now = Date.now) {
             if (pending.size === 0)
                 return;
             const emittedAt = new Date(now()).toISOString();
-            const events = [...pending.values()].map(({ flow, requests, startedAt }) => ({ ...flow, requests, windowStartedAt: new Date(startedAt).toISOString(), emittedAt }));
+            const events = [...pending.values()].map(({ flow, requests, startedAt }) => ({
+                ...flow,
+                requests,
+                windowStartedAt: new Date(startedAt).toISOString(),
+                emittedAt,
+            }));
             pending.clear();
             flushing = (async () => {
                 for (let offset = 0; offset < events.length; offset += 256)
@@ -63,7 +91,10 @@ function trafficMiddleware(collector, service, region) {
         response.setHeader?.('X-Oxy-Region', region);
         const path = request.path ?? request.url ?? '/';
         // Never report collection itself, probes or the dashboard transport.
-        if (/^\/(?:api\/)?(?:health|ready|live|platform-stats|platform-activity|platform-infrastructure|infra-status)(?:\/|$)/.test(path) || path.startsWith('/internal/activity') || path.startsWith('/auth/service-token') || path.startsWith('/cdn-cgi/')) {
+        if (/^\/(?:api\/)?(?:health|ready|live|platform-stats|platform-activity|platform-infrastructure|infra-status)(?:\/|$)/.test(path) ||
+            path.startsWith('/internal/activity') ||
+            path.startsWith('/auth/service-token') ||
+            path.startsWith('/cdn-cgi/')) {
             next();
             return;
         }
@@ -72,11 +103,28 @@ function trafficMiddleware(collector, service, region) {
         let finished = false;
         const inboundFlow = () => {
             // Read service identity AFTER the route's shared auth middleware resolved it.
-            const name = request.serviceApp?.appName?.toLowerCase().replace(/[^a-z0-9-]/g, '-').slice(0, 40);
+            const name = request.serviceApp?.appName
+                ?.toLowerCase()
+                .replace(/[^a-z0-9-]/g, '-')
+                .slice(0, 40);
             const internal = Boolean(name);
             const forwardedRegion = request.headers['x-oxy-source-region'];
-            const peerRegion = internal ? normalizeInfrastructureRegion(forwardedRegion) : edgePop ? `edge-${edgePop}` : undefined;
-            return { region, service, activityType, scope: internal ? 'internal' : 'external', direction: 'inbound', sourceRegion: peerRegion, targetRegion: region, sourceService: name, targetService: service };
+            const peerRegion = internal
+                ? normalizeInfrastructureRegion(forwardedRegion)
+                : edgePop
+                    ? `edge-${edgePop}`
+                    : undefined;
+            return {
+                region,
+                service,
+                activityType,
+                scope: internal ? 'internal' : 'external',
+                direction: 'inbound',
+                sourceRegion: peerRegion,
+                targetRegion: region,
+                sourceService: name,
+                targetService: service,
+            };
         };
         const finish = () => {
             if (finished)
@@ -84,7 +132,14 @@ function trafficMiddleware(collector, service, region) {
             finished = true;
             const flow = inboundFlow();
             collector.record(flow);
-            collector.record({ ...flow, direction: 'outbound', sourceRegion: region, targetRegion: flow.sourceRegion, sourceService: service, targetService: flow.sourceService });
+            collector.record({
+                ...flow,
+                direction: 'outbound',
+                sourceRegion: region,
+                targetRegion: flow.sourceRegion,
+                sourceService: service,
+                targetService: flow.sourceService,
+            });
         };
         response.once('finish', finish);
         // Failed/aborted requests are still real inbound activity. Do not invent a
@@ -102,13 +157,21 @@ function instrumentTrafficFetch(fetcher, collector, service, region, resolveEndp
     return Object.assign(async (input, init) => {
         const url = new URL(typeof input === 'string' ? input : input instanceof URL ? input.href : input.url);
         // Collection/auth control traffic cannot generate a feedback loop.
-        if (url.pathname.startsWith('/internal/activity') || url.pathname.startsWith('/auth/service-token') || url.pathname === '/platform-infrastructure')
+        if (url.pathname.startsWith('/internal/activity') ||
+            url.pathname.startsWith('/auth/service-token') ||
+            url.pathname === '/platform-infrastructure')
             return fetcher(input, init);
         const peer = resolveEndpoint(url);
         const flow = {
-            service, region, scope: peer ? 'internal' : 'external', direction: 'outbound',
-            activityType: trafficType(url.pathname), sourceRegion: region, targetRegion: peer?.region,
-            sourceService: service, targetService: peer?.service,
+            service,
+            region,
+            scope: peer ? 'internal' : 'external',
+            direction: 'outbound',
+            activityType: trafficType(url.pathname),
+            sourceRegion: region,
+            targetRegion: peer?.region,
+            sourceService: service,
+            targetService: peer?.service,
         };
         const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
         if (peer)
@@ -121,23 +184,43 @@ function instrumentTrafficFetch(fetcher, collector, service, region, resolveEndp
             collector.record({ ...flow, targetRegion: undefined });
             throw error;
         }
-        const targetRegion = peer ? normalizeInfrastructureRegion(response.headers.get('X-Oxy-Region') ?? undefined) : undefined;
+        const targetRegion = peer
+            ? normalizeInfrastructureRegion(response.headers.get('X-Oxy-Region') ?? undefined)
+            : undefined;
         collector.record({ ...flow, targetRegion });
-        collector.record({ ...flow, direction: 'inbound', sourceRegion: targetRegion, targetRegion: region, sourceService: peer?.service, targetService: service });
+        collector.record({
+            ...flow,
+            direction: 'inbound',
+            sourceRegion: targetRegion,
+            targetRegion: region,
+            sourceService: peer?.service,
+            targetService: service,
+        });
         return response;
     }, fetcher);
 }
 // Exact deployed API hosts; an arbitrary caller-supplied hostname cannot claim
 // to be an internal service. Region is infrastructure metadata, never IP geo.
 const OXY_API_SERVICES = {
-    'api.oxy.so': 'oxy-api', 'api.website.oxy.so': 'website',
-    'website-api.oxy.so': 'website', 'api.mention.earth': 'mention',
-    'api.mercaria.co': 'mercaria', 'api.alia.onl': 'alia', 'kaana.ai': 'kaana',
-    'api.homiio.com': 'homiio', 'api.syra.fm': 'syra',
-    'mention.earth': 'mention', 'mcp.mention.earth': 'mention-mcp',
-    'api.clarity.surf': 'clarity', 'api.peable.to': 'peable',
-    'api.crowdsource.oxy.so': 'crowdsource', 'api.moovo.now': 'moovo',
-    'api.allo.you': 'allo', 'api.noted.oxy.so': 'noted', 'api.schedio.app': 'schedio', 'api.tnp.network': 'tnp-api',
+    'api.oxy.so': 'oxy-api',
+    'api.website.oxy.so': 'website',
+    'website-api.oxy.so': 'website',
+    'api.mention.earth': 'mention',
+    'api.mercaria.co': 'mercaria',
+    'api.alia.onl': 'alia',
+    'kaana.ai': 'kaana',
+    'api.homiio.com': 'homiio',
+    'api.syra.fm': 'syra',
+    'mention.earth': 'mention',
+    'mcp.mention.earth': 'mention-mcp',
+    'api.clarity.surf': 'clarity',
+    'api.peable.to': 'peable',
+    'api.crowdsource.oxy.so': 'crowdsource',
+    'api.moovo.now': 'moovo',
+    'api.allo.you': 'allo',
+    'api.noted.oxy.so': 'noted',
+    'api.schedio.app': 'schedio',
+    'api.tnp.network': 'tnp-api',
 };
 function resolveOxyServiceEndpoint(url) {
     const service = OXY_API_SERVICES[url.hostname];
@@ -174,7 +257,9 @@ const REGION_LOCATIONS = {
     'me-central-1': { label: 'UAE', coordinates: [54.37, 24.45] },
     'il-central-1': { label: 'Tel Aviv', coordinates: [34.78, 32.09] },
 };
-function infrastructureLocation(region) { return REGION_LOCATIONS[region]; }
+function infrastructureLocation(region) {
+    return REGION_LOCATIONS[region];
+}
 function normalizeInfrastructureRegion(value) {
     return typeof value === 'string' && /^[a-z]{2}(?:-[a-z]+)+-\d$/.test(value) ? value : undefined;
 }

package/dist/cjs/server.js

@@ -17,7 +17,9 @@ function firstHeaderValue(value) {
     return typeof first === 'string' ? first : undefined;
 }
 function normalizeEdgePop(value) {
-    return firstHeaderValue(value)?.match(/^[a-z]{3}$/i)?.[0]?.toLowerCase();
+    return firstHeaderValue(value)
+        ?.match(/^[a-z]{3}$/i)?.[0]
+        ?.toLowerCase();
 }
 function normalizeActivityId(value) {
     const candidate = firstHeaderValue(value);

package/dist/cjs/socket.js

@@ -6,11 +6,26 @@ exports.observeTrafficWebSocket = observeTrafficWebSocket;
 const collector_js_1 = require("./collector.js");
 const server_js_1 = require("./server.js");
 const CATEGORIES = {
-    auth: 'identity', session: 'identity', user: 'identity', profile: 'identity',
-    chat: 'ai', agent: 'ai', inference: 'ai', completion: 'ai',
-    message: 'communication', notification: 'communication', typing: 'communication',
-    media: 'media', audio: 'media', video: 'media', stream: 'media', player: 'media',
-    track: 'media', playback: 'media', playlist: 'media', room: 'media',
+    auth: 'identity',
+    session: 'identity',
+    user: 'identity',
+    profile: 'identity',
+    chat: 'ai',
+    agent: 'ai',
+    inference: 'ai',
+    completion: 'ai',
+    message: 'communication',
+    notification: 'communication',
+    typing: 'communication',
+    media: 'media',
+    audio: 'media',
+    video: 'media',
+    stream: 'media',
+    player: 'media',
+    track: 'media',
+    playback: 'media',
+    playlist: 'media',
+    room: 'media',
 };
 /** Event names are reduced locally to five categories; payloads are never read. */
 function socketTrafficType(event) {
@@ -32,9 +47,16 @@ function observeTrafficSocket(socket, collector, service, region, options = {})
         const peer = options.getPeer?.();
         const peerService = peer && /^[a-z][a-z0-9-]{0,39}$/.test(peer.service) ? peer.service : undefined;
         const edgePop = (0, server_js_1.metadataFromHeaders)(socket.handshake.headers).edgePop;
-        const peerRegion = peerService ? (0, collector_js_1.normalizeInfrastructureRegion)(peer?.region) : edgePop ? `edge-${edgePop}` : undefined;
+        const peerRegion = peerService
+            ? (0, collector_js_1.normalizeInfrastructureRegion)(peer?.region)
+            : edgePop
+                ? `edge-${edgePop}`
+                : undefined;
         collector.record({
-            region, service, scope: peerService ? 'internal' : 'external', direction,
+            region,
+            service,
+            scope: peerService ? 'internal' : 'external',
+            direction,
             activityType: socketTrafficType(event),
             sourceRegion: direction === 'inbound' ? peerRegion : region,
             targetRegion: direction === 'inbound' ? region : peerRegion,
@@ -66,9 +88,16 @@ function observeTrafficWebSocket(socket, collector, service, region, options = {
         const peer = options.getPeer?.();
         const peerService = peer && /^[a-z][a-z0-9-]{0,39}$/.test(peer.service) ? peer.service : undefined;
         const edgePop = (0, server_js_1.metadataFromHeaders)(options.headers ?? {}).edgePop;
-        const peerRegion = peerService ? (0, collector_js_1.normalizeInfrastructureRegion)(peer?.region) : edgePop ? `edge-${edgePop}` : undefined;
+        const peerRegion = peerService
+            ? (0, collector_js_1.normalizeInfrastructureRegion)(peer?.region)
+            : edgePop
+                ? `edge-${edgePop}`
+                : undefined;
         collector.record({
-            service, region, scope: peerService ? 'internal' : 'external', direction,
+            service,
+            region,
+            scope: peerService ? 'internal' : 'external',
+            direction,
             activityType: options.activityType ?? 'communication',
             sourceRegion: direction === 'inbound' ? peerRegion : region,
             targetRegion: direction === 'inbound' ? region : peerRegion,

package/dist/esm/browser.js

@@ -22,9 +22,9 @@ function createUuid(cryptoApi) {
 function eligibleLocation(location) {
     if (!location || (location.protocol !== 'https:' && location.protocol !== 'http:'))
         return false;
-    return location.hostname !== 'localhost'
-        && location.hostname !== '127.0.0.1'
-        && location.hostname !== '[::1]';
+    return (location.hostname !== 'localhost' &&
+        location.hostname !== '127.0.0.1' &&
+        location.hostname !== '[::1]');
 }
 export function createBrowserTelemetry(options = {}) {
     let activityId = null;
@@ -37,7 +37,9 @@ export function createBrowserTelemetry(options = {}) {
         if (!hasInjectedBrowser && !hasBrowserRuntime)
             return {};
         const now = (options.now ?? Date.now)();
-        if (!activityId || now < activityIdCreatedAt || now - activityIdCreatedAt >= (options.activityIdRotationMs ?? DEFAULT_ACTIVITY_ID_ROTATION_MS)) {
+        if (!activityId ||
+            now < activityIdCreatedAt ||
+            now - activityIdCreatedAt >= (options.activityIdRotationMs ?? DEFAULT_ACTIVITY_ID_ROTATION_MS)) {
             activityId = createUuid(options.crypto ?? globalThis.crypto);
             if (!activityId)
                 return {};
@@ -54,7 +56,11 @@ export function createBrowserTelemetry(options = {}) {
         try {
             const response = await (options.fetchTrace
                 ? options.fetchTrace(controller.signal)
-                : fetch('/cdn-cgi/trace', { cache: 'no-store', credentials: 'omit', signal: controller.signal }));
+                : fetch('/cdn-cgi/trace', {
+                    cache: 'no-store',
+                    credentials: 'omit',
+                    signal: controller.signal,
+                }));
             if (!response.ok)
                 return null;
             const match = (await response.text()).match(/^colo=([a-z]{3})$/im);
@@ -69,7 +75,9 @@ export function createBrowserTelemetry(options = {}) {
     };
     const getEdgeRegionHeader = async () => {
         const now = (options.now ?? Date.now)();
-        if (!edgePopPromise || now < edgePopReadAt || now - edgePopReadAt >= (options.edgeCacheMs ?? DEFAULT_EDGE_CACHE_MS)) {
+        if (!edgePopPromise ||
+            now < edgePopReadAt ||
+            now - edgePopReadAt >= (options.edgeCacheMs ?? DEFAULT_EDGE_CACHE_MS)) {
             edgePopReadAt = now;
             edgePopPromise = discoverEdgePop();
         }
@@ -81,7 +89,9 @@ export function createBrowserTelemetry(options = {}) {
     let peekInFlight = false;
     const peekEdgeRegionHeader = () => {
         const now = (options.now ?? Date.now)();
-        if (!peekInFlight && (now < peekRefreshAt || now - peekRefreshAt >= (options.edgePeekRefreshMs ?? DEFAULT_EDGE_PEEK_REFRESH_MS))) {
+        if (!peekInFlight &&
+            (now < peekRefreshAt ||
+                now - peekRefreshAt >= (options.edgePeekRefreshMs ?? DEFAULT_EDGE_PEEK_REFRESH_MS))) {
             peekRefreshAt = now;
             peekInFlight = true;
             void discoverEdgePop()
@@ -100,7 +110,7 @@ export function createBrowserTelemetry(options = {}) {
         getEdgeRegionHeader,
         peekEdgeRegionHeader,
         async getHeaders() {
-            return { ...await getEdgeRegionHeader(), ...getActivityIdHeader() };
+            return { ...(await getEdgeRegionHeader()), ...getActivityIdHeader() };
         },
     };
 }

package/dist/esm/collector.js

@@ -1,10 +1,33 @@
 import { metadataFromHeaders } from './server.js';
 const TYPES = {
-    auth: 'identity', session: 'identity', users: 'identity', profiles: 'identity', accounts: 'identity',
-    ai: 'ai', inference: 'ai', models: 'ai', chat: 'ai', completions: 'ai',
-    stream: 'media', tracks: 'media', episodes: 'media', recordings: 'media', rooms: 'media',
-    messages: 'communication', notifications: 'communication', mail: 'communication',
-    media: 'media', files: 'media', assets: 'media', upload: 'media', uploads: 'media', cdn: 'media', storage: 'media', images: 'media', audio: 'media', videos: 'media',
+    auth: 'identity',
+    session: 'identity',
+    users: 'identity',
+    profiles: 'identity',
+    accounts: 'identity',
+    ai: 'ai',
+    inference: 'ai',
+    models: 'ai',
+    chat: 'ai',
+    completions: 'ai',
+    stream: 'media',
+    tracks: 'media',
+    episodes: 'media',
+    recordings: 'media',
+    rooms: 'media',
+    messages: 'communication',
+    notifications: 'communication',
+    mail: 'communication',
+    media: 'media',
+    files: 'media',
+    assets: 'media',
+    upload: 'media',
+    uploads: 'media',
+    cdn: 'media',
+    storage: 'media',
+    images: 'media',
+    audio: 'media',
+    videos: 'media',
 };
 export function trafficType(path) {
     const parts = path.split('?')[0].split('/').filter(Boolean);
@@ -34,7 +57,12 @@ export function createTrafficCollector(publish, now = Date.now) {
             if (pending.size === 0)
                 return;
             const emittedAt = new Date(now()).toISOString();
-            const events = [...pending.values()].map(({ flow, requests, startedAt }) => ({ ...flow, requests, windowStartedAt: new Date(startedAt).toISOString(), emittedAt }));
+            const events = [...pending.values()].map(({ flow, requests, startedAt }) => ({
+                ...flow,
+                requests,
+                windowStartedAt: new Date(startedAt).toISOString(),
+                emittedAt,
+            }));
             pending.clear();
             flushing = (async () => {
                 for (let offset = 0; offset < events.length; offset += 256)
@@ -54,7 +82,10 @@ export function trafficMiddleware(collector, service, region) {
         response.setHeader?.('X-Oxy-Region', region);
         const path = request.path ?? request.url ?? '/';
         // Never report collection itself, probes or the dashboard transport.
-        if (/^\/(?:api\/)?(?:health|ready|live|platform-stats|platform-activity|platform-infrastructure|infra-status)(?:\/|$)/.test(path) || path.startsWith('/internal/activity') || path.startsWith('/auth/service-token') || path.startsWith('/cdn-cgi/')) {
+        if (/^\/(?:api\/)?(?:health|ready|live|platform-stats|platform-activity|platform-infrastructure|infra-status)(?:\/|$)/.test(path) ||
+            path.startsWith('/internal/activity') ||
+            path.startsWith('/auth/service-token') ||
+            path.startsWith('/cdn-cgi/')) {
             next();
             return;
         }
@@ -63,11 +94,28 @@ export function trafficMiddleware(collector, service, region) {
         let finished = false;
         const inboundFlow = () => {
             // Read service identity AFTER the route's shared auth middleware resolved it.
-            const name = request.serviceApp?.appName?.toLowerCase().replace(/[^a-z0-9-]/g, '-').slice(0, 40);
+            const name = request.serviceApp?.appName
+                ?.toLowerCase()
+                .replace(/[^a-z0-9-]/g, '-')
+                .slice(0, 40);
             const internal = Boolean(name);
             const forwardedRegion = request.headers['x-oxy-source-region'];
-            const peerRegion = internal ? normalizeInfrastructureRegion(forwardedRegion) : edgePop ? `edge-${edgePop}` : undefined;
-            return { region, service, activityType, scope: internal ? 'internal' : 'external', direction: 'inbound', sourceRegion: peerRegion, targetRegion: region, sourceService: name, targetService: service };
+            const peerRegion = internal
+                ? normalizeInfrastructureRegion(forwardedRegion)
+                : edgePop
+                    ? `edge-${edgePop}`
+                    : undefined;
+            return {
+                region,
+                service,
+                activityType,
+                scope: internal ? 'internal' : 'external',
+                direction: 'inbound',
+                sourceRegion: peerRegion,
+                targetRegion: region,
+                sourceService: name,
+                targetService: service,
+            };
         };
         const finish = () => {
             if (finished)
@@ -75,7 +123,14 @@ export function trafficMiddleware(collector, service, region) {
             finished = true;
             const flow = inboundFlow();
             collector.record(flow);
-            collector.record({ ...flow, direction: 'outbound', sourceRegion: region, targetRegion: flow.sourceRegion, sourceService: service, targetService: flow.sourceService });
+            collector.record({
+                ...flow,
+                direction: 'outbound',
+                sourceRegion: region,
+                targetRegion: flow.sourceRegion,
+                sourceService: service,
+                targetService: flow.sourceService,
+            });
         };
         response.once('finish', finish);
         // Failed/aborted requests are still real inbound activity. Do not invent a
@@ -93,13 +148,21 @@ export function instrumentTrafficFetch(fetcher, collector, service, region, reso
     return Object.assign(async (input, init) => {
         const url = new URL(typeof input === 'string' ? input : input instanceof URL ? input.href : input.url);
         // Collection/auth control traffic cannot generate a feedback loop.
-        if (url.pathname.startsWith('/internal/activity') || url.pathname.startsWith('/auth/service-token') || url.pathname === '/platform-infrastructure')
+        if (url.pathname.startsWith('/internal/activity') ||
+            url.pathname.startsWith('/auth/service-token') ||
+            url.pathname === '/platform-infrastructure')
             return fetcher(input, init);
         const peer = resolveEndpoint(url);
         const flow = {
-            service, region, scope: peer ? 'internal' : 'external', direction: 'outbound',
-            activityType: trafficType(url.pathname), sourceRegion: region, targetRegion: peer?.region,
-            sourceService: service, targetService: peer?.service,
+            service,
+            region,
+            scope: peer ? 'internal' : 'external',
+            direction: 'outbound',
+            activityType: trafficType(url.pathname),
+            sourceRegion: region,
+            targetRegion: peer?.region,
+            sourceService: service,
+            targetService: peer?.service,
         };
         const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));
         if (peer)
@@ -112,23 +175,43 @@ export function instrumentTrafficFetch(fetcher, collector, service, region, reso
             collector.record({ ...flow, targetRegion: undefined });
             throw error;
         }
-        const targetRegion = peer ? normalizeInfrastructureRegion(response.headers.get('X-Oxy-Region') ?? undefined) : undefined;
+        const targetRegion = peer
+            ? normalizeInfrastructureRegion(response.headers.get('X-Oxy-Region') ?? undefined)
+            : undefined;
         collector.record({ ...flow, targetRegion });
-        collector.record({ ...flow, direction: 'inbound', sourceRegion: targetRegion, targetRegion: region, sourceService: peer?.service, targetService: service });
+        collector.record({
+            ...flow,
+            direction: 'inbound',
+            sourceRegion: targetRegion,
+            targetRegion: region,
+            sourceService: peer?.service,
+            targetService: service,
+        });
         return response;
     }, fetcher);
 }
 // Exact deployed API hosts; an arbitrary caller-supplied hostname cannot claim
 // to be an internal service. Region is infrastructure metadata, never IP geo.
 const OXY_API_SERVICES = {
-    'api.oxy.so': 'oxy-api', 'api.website.oxy.so': 'website',
-    'website-api.oxy.so': 'website', 'api.mention.earth': 'mention',
-    'api.mercaria.co': 'mercaria', 'api.alia.onl': 'alia', 'kaana.ai': 'kaana',
-    'api.homiio.com': 'homiio', 'api.syra.fm': 'syra',
-    'mention.earth': 'mention', 'mcp.mention.earth': 'mention-mcp',
-    'api.clarity.surf': 'clarity', 'api.peable.to': 'peable',
-    'api.crowdsource.oxy.so': 'crowdsource', 'api.moovo.now': 'moovo',
-    'api.allo.you': 'allo', 'api.noted.oxy.so': 'noted', 'api.schedio.app': 'schedio', 'api.tnp.network': 'tnp-api',
+    'api.oxy.so': 'oxy-api',
+    'api.website.oxy.so': 'website',
+    'website-api.oxy.so': 'website',
+    'api.mention.earth': 'mention',
+    'api.mercaria.co': 'mercaria',
+    'api.alia.onl': 'alia',
+    'kaana.ai': 'kaana',
+    'api.homiio.com': 'homiio',
+    'api.syra.fm': 'syra',
+    'mention.earth': 'mention',
+    'mcp.mention.earth': 'mention-mcp',
+    'api.clarity.surf': 'clarity',
+    'api.peable.to': 'peable',
+    'api.crowdsource.oxy.so': 'crowdsource',
+    'api.moovo.now': 'moovo',
+    'api.allo.you': 'allo',
+    'api.noted.oxy.so': 'noted',
+    'api.schedio.app': 'schedio',
+    'api.tnp.network': 'tnp-api',
 };
 export function resolveOxyServiceEndpoint(url) {
     const service = OXY_API_SERVICES[url.hostname];
@@ -165,7 +248,9 @@ const REGION_LOCATIONS = {
     'me-central-1': { label: 'UAE', coordinates: [54.37, 24.45] },
     'il-central-1': { label: 'Tel Aviv', coordinates: [34.78, 32.09] },
 };
-export function infrastructureLocation(region) { return REGION_LOCATIONS[region]; }
+export function infrastructureLocation(region) {
+    return REGION_LOCATIONS[region];
+}
 export function normalizeInfrastructureRegion(value) {
     return typeof value === 'string' && /^[a-z]{2}(?:-[a-z]+)+-\d$/.test(value) ? value : undefined;
 }

package/dist/esm/server.js

@@ -7,7 +7,9 @@ function firstHeaderValue(value) {
     return typeof first === 'string' ? first : undefined;
 }
 export function normalizeEdgePop(value) {
-    return firstHeaderValue(value)?.match(/^[a-z]{3}$/i)?.[0]?.toLowerCase();
+    return firstHeaderValue(value)
+        ?.match(/^[a-z]{3}$/i)?.[0]
+        ?.toLowerCase();
 }
 export function normalizeActivityId(value) {
     const candidate = firstHeaderValue(value);