@buoy-gg/network 7.0.41 → 7.0.43

package/lib/module/network/utils/networkListener.js

@@ -1,1344 +1,7 @@
-"use strict";
+"use strict";import{resolveRequestUrl as U}from"./resolveRequestUrl";import{nextRequestId as B}from"./requestId";import{runConditionXhr as Y}from"../conditions/xhr";import{snapshotNetworkCondition as z}from"../conditions/store";import{throwIfAborted as G,waitBeforeDispatch as K}from"../conditions/wait";import{overrideForRequest as j}from"../overrides/engine";import{runOverride as V,hasPendingStandardRequest as W}from"../overrides/applyToXhr";import{canSynthesizeResponse as Q,synthesizeFetchError as Z,synthesizeResponse as ee}from"../overrides/applyToFetch";import{markForOutcome as J}from"../overrides/types";import{httpStatusText as te,xhrCompletionKind as se}from"./httpCompletion";import{realNow as _}from"./realNow";let O;function $(b){const e=globalThis.__buoyHeaderInjectors;if(!e||e.length===0)return void 0;let t;for(const s of e){try{const c=s(b);if(c)t={...t,...c}}catch{}}return t}function ne(){if(O!==void 0)return O;O=null;try{if(typeof __DEV__!=="undefined"&&!__DEV__)return O;const b=require("react-native");const e=b?.NativeModules?.SourceCode;const t=e?.getConstants?.().scriptURL??e?.scriptURL;if(typeof t==="string"&&/^https?:\/\//.test(t)){const s=new URL(t);O=`${s.protocol}//${s.host}`}}catch{O=null}return O}let D=false;function re(b){const e={};if(!b)return e;if(typeof Headers!=="undefined"&&b instanceof Headers)b.forEach((t,s)=>{e[s]=t});else if(Array.isArray(b))for(const[t,s]of b)e[t]=s;else Object.assign(e,b);return e}export const BUOY_FETCH_INTERCEPTOR_FLAG="__buoyNetworkFetchIntercepted";export const BUOY_XHR_INTERCEPTOR_FLAG="__buoyNetworkXhrIntercepted";const oe=["text/event-stream","application/x-ndjson","application/stream+json"];const P="[streaming\u2026]";function ie(b){if(!b)return false;const e=b.toLowerCase();return oe.some(t=>e.includes(t))}const ae="__BUOY_INTERNAL_HOSTS__";function ce(b){const e=globalThis[ae];if(!(e instanceof Set)||e.size===0)return false;let t;try{t=new URL(b).host.toLowerCase()}catch{return false}for(const s of e){if(typeof s==="string"&&s&&t===s.toLowerCase())return true}return false}class de{listeners=[];isListening=false;patchedFetch=null;patchedXHROpen=null;patchedXHRSend=null;patchedXHRSetRequestHeader=null;fetchGeneration=0;xhrGeneration=0;constructor(){this.originalFetch=globalThis.fetch;this.originalXHROpen=XMLHttpRequest.prototype.open;this.originalXHRSend=XMLHttpRequest.prototype.send;this.originalXHRSetRequestHeader=XMLHttpRequest.prototype.setRequestHeader}shouldIgnoreUrl(e){try{const t=new URL(e);if(t.hostname==="keygen.sh"||t.hostname.endsWith(".keygen.sh"))return true;if((t.hostname==="buoy.gg"||t.hostname==="www.buoy.gg")&&t.pathname.startsWith("/api/license"))return true;const s=t.hostname==="localhost"||t.hostname==="127.0.0.1"||t.hostname==="10.0.2.2";if(s&&["8081","8802"].includes(t.port))return true;const c=ne();if(c&&`${t.protocol}//${t.host}`===c)return true}catch{return false}return ce(e)}emit(e){this.listeners.forEach(t=>{try{t(e)}catch(s){}})}parseUrl(e){let t=null;const s=e.indexOf("?");if(s>-1){t={};e.substring(s+1).split("&").forEach(c=>{const[a,r]=c.split("=");if(a&&r!==void 0){t[a]=decodeURIComponent(r.replace(/\+/g," "))}})}return{url:s>-1?e.substring(0,s):e,params:t}}async readStreamedBody(e,t=256*1024){const s=e.body;if(!s||typeof s.getReader!=="function"){const f=await e.text();return f.length>t?{body:`${f.slice(0,t)}
 
-import { resolveRequestUrl } from "./resolveRequestUrl";
-import { nextRequestId } from "./requestId";
-import { runConditionXhr } from "../conditions/xhr";
-import { snapshotNetworkCondition } from "../conditions/store";
-import { throwIfAborted, waitBeforeDispatch } from "../conditions/wait";
-/**
- * Network listener using Reactotron-style event pattern
- * Simple and reliable network interception for React Native
- */
+... [truncated]`,size:f.length}:{body:f,size:f.length}}const c=s.getReader();const a=new TextDecoder;let r="";let u=0;let g=false;try{for(;;){const{done:f,value:i}=await c.read();if(f)break;u+=i?.byteLength??0;if(!g){r+=a.decode(i,{stream:true});if(u>=t){r=`${r.slice(0,t)}
 
-import { overrideForRequest } from "../overrides/engine";
-import { runOverride, hasPendingStandardRequest } from "../overrides/applyToXhr";
-import { canSynthesizeResponse, synthesizeFetchError, synthesizeResponse } from "../overrides/applyToFetch";
-import { markForOutcome } from "../overrides/types";
-import { httpStatusText, xhrCompletionKind } from "./httpCompletion";
-let devOrigin;
+... [truncated]`;g=true;break}}}if(!g)r+=a.decode()}finally{try{void Promise.resolve(c.cancel()).catch(()=>{})}catch{}try{c.releaseLock()}catch{}}return{body:r,size:u}}async processResponseBody(e,t=1024*1024){try{const s=e.headers.get("content-length");if(s){const r=parseInt(s,10);if(!isNaN(r)&&r>t){return{body:`[Response too large: ${this.formatBytes(r)}]`,size:r,truncated:true}}}const c=await e.text();const a=c.length;if(a>t){const r=c.substring(0,t);const u=a-t;return{body:`${r}
 
-/**
- * Headers another Buoy tool adds to a request inside our wrapper.
- *
- * Impersonate patches fetch/XHR at boot, so this listener usually wraps it
- * and records the request before the impersonation header is added. The
- * request on the wire carried the header and the Network row did not. Tools
- * that add headers register a function here, keyed by URL, so the row shows
- * what was actually sent.
- */
-function injectedHeaders(url) {
-  const injectors = globalThis.__buoyHeaderInjectors;
-  if (!injectors || injectors.length === 0) return undefined;
-  let out;
-  for (const inject of injectors) {
-    try {
-      const h = inject(url);
-      if (h) out = {
-        ...out,
-        ...h
-      };
-    } catch {
-      /* a broken injector must not break capture */
-    }
-  }
-  return out;
-}
-
-/**
- * Origin of the Metro dev server this JS bundle was loaded from, read once from
- * the bundle URL React Native reports. `null` in release builds (the bundle is
- * a file) and anywhere react-native isn't present.
- */
-function devServerOrigin() {
-  if (devOrigin !== undefined) return devOrigin;
-  devOrigin = null;
-  try {
-    if (typeof __DEV__ !== "undefined" && !__DEV__) return devOrigin;
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const rn = require("react-native");
-    const sc = rn?.NativeModules?.SourceCode;
-    const url = sc?.getConstants?.().scriptURL ?? sc?.scriptURL;
-    if (typeof url === "string" && /^https?:\/\//.test(url)) {
-      const u = new URL(url);
-      devOrigin = `${u.protocol}//${u.host}`;
-    }
-  } catch {
-    devOrigin = null;
-  }
-  return devOrigin;
-}
-
-/**
- * True only while `originalFetch` is being CALLED (not awaited).
- *
- * Overrides hook both `fetch` and `XMLHttpRequest`, because Expo's native
- * `expo/fetch` bypasses XHR while bare RN's whatwg-fetch polyfill runs straight
- * through it. On bare RN that means one `fetch()` would otherwise be overridden
- * twice — a doubled delay and a doubled hit count.
- *
- * whatwg-fetch creates and sends its XHR synchronously inside the Promise
- * executor, so a flag raised across the call expression alone is enough to
- * cover the inner `send()` without leaking across the await.
- */
-let insideFetchHandoff = false;
-
-// Extended XMLHttpRequest interface for monkey-patching
-
-// Event types for network operations
-
-/**
- * Markers stamped on the installed interceptor functions so their presence in
- * the live chain stays detectable even after another tool wraps them.
- * Cooperating patchers (@buoy-gg/impersonate) copy every `__buoy*` marker from
- * the function they wrap onto their own wrapper; a global fetch/XHR WITHOUT
- * the marker therefore means our interceptor was clobbered — some runtime
- * re-assigned `globalThis.fetch` over it (Expo's winter runtime, React Native
- * DevTools' network panel, a second dev server's tooling, hot-reload churn all
- * do this in the wild) — and capture must re-install. See startListening.
- */
-export const BUOY_FETCH_INTERCEPTOR_FLAG = "__buoyNetworkFetchIntercepted";
-export const BUOY_XHR_INTERCEPTOR_FLAG = "__buoyNetworkXhrIntercepted";
-/**
- * Network traffic interceptor for React Native applications
- *
- * This class intercepts both fetch and XMLHttpRequest operations to provide
- * comprehensive network monitoring capabilities. It uses method swizzling to
- * wrap native networking APIs while preserving their original functionality.
- *
- * @example
- * ```typescript
- * // Start monitoring network traffic
- * startNetworkListener();
- *
- * // Add a listener for network events
- * const unsubscribe = addNetworkListener((event) => {
- *   if (event.type === 'response') {
- *     console.log(`${event.request.method} ${event.request.url}: ${event.response?.status}`);
- *   }
- * });
- *
- * // Stop monitoring and cleanup
- * unsubscribe();
- * stopNetworkListener();
- * ```
- *
- * @performance Uses lazy singleton pattern to minimize memory footprint
- * @performance Includes URL filtering to ignore development traffic
- */
-/**
- * Hosts another Buoy package has claimed as its own traffic.
- *
- * A GLOBAL, not an import: `@buoy-gg/network` cannot depend on `agent-core`
- * (Ask Buoy is optional and this package is older), and `agent-core` ships
- * with no dependencies at all. `registerSelfEndpoint` in agent-core writes the
- * set; this reads it. Absent, undefined or the wrong shape all mean "nothing
- * to exclude", so nothing breaks in an app without Ask Buoy.
- *
- * WHY IT IS NOT ENOUGH TO FILTER LATER. The interceptor reads the response
- * body — `await processResponseBody(response.clone())` — BEFORE handing the
- * response back. On a streamed reply that resolves only at EOF, so an
- * intercepted model endpoint delivers its whole answer at once and Ask Buoy
- * cannot stream a word. Ignoring the URL is what keeps the socket the
- * caller's. It also keeps override rules off model traffic, which a broad
- * user-authored rule would otherwise rewrite.
- */
-/**
- * Content types whose body arrives over time rather than all at once.
- *
- * These are the ones where reading the clone before returning the response
- * changes the CALLER's behaviour instead of merely observing it.
- */
-const STREAMED_CONTENT_TYPES = ["text/event-stream", "application/x-ndjson", "application/stream+json"];
-const STREAMING_PLACEHOLDER = "[streaming\u2026]";
-function isStreamedContentType(contentType) {
-  if (!contentType) return false;
-  const lower = contentType.toLowerCase();
-  return STREAMED_CONTENT_TYPES.some(t => lower.includes(t));
-}
-const INTERNAL_HOSTS_KEY = "__BUOY_INTERNAL_HOSTS__";
-function isInternalBuoyHost(url) {
-  const hosts = globalThis[INTERNAL_HOSTS_KEY];
-  if (!(hosts instanceof Set) || hosts.size === 0) return false;
-  let authority;
-  try {
-    authority = new URL(url).host.toLowerCase();
-  } catch {
-    return false;
-  }
-  for (const host of hosts) {
-    if (typeof host === "string" && host && authority === host.toLowerCase()) return true;
-  }
-  return false;
-}
-class NetworkListener {
-  listeners = [];
-  isListening = false;
-
-  // Store original methods
-
-  /**
-   * The wrappers currently installed by THIS instance, for identity checks:
-   * `stopListening` restores a global only when it is still literally ours —
-   * assigning our saved original over someone who patched after us would wipe
-   * their interceptor exactly the way this class gets wiped (see below).
-   */
-  patchedFetch = null;
-  patchedXHROpen = null;
-  patchedXHRSend = null;
-  patchedXHRSetRequestHeader = null;
-
-  /**
-   * Bumped on every (re)install and on stop. Each wrapper closes over the
-   * generation it was born with and goes silent (pure pass-through — no emit,
-   * no counter bump) once a newer generation exists, so a wrapper stranded
-   * inside another tool's chain can never double-report a request.
-   */
-  fetchGeneration = 0;
-  xhrGeneration = 0;
-  constructor() {
-    // Store original methods
-    this.originalFetch = globalThis.fetch;
-    this.originalXHROpen = XMLHttpRequest.prototype.open;
-    this.originalXHRSend = XMLHttpRequest.prototype.send;
-    this.originalXHRSetRequestHeader = XMLHttpRequest.prototype.setRequestHeader;
-  }
-
-  /**
-   * Check if URL should be ignored from network monitoring
-   *
-   * Filters out development-related URLs like Metro bundler, debugger proxy,
-   * and symbolication requests to reduce noise in the network logs.
-   *
-   * @param url - The URL to check
-   * @returns True if the URL should be ignored
-   */
-  shouldIgnoreUrl(url) {
-    try {
-      const parsed = new URL(url);
-      if (parsed.hostname === "keygen.sh" || parsed.hostname.endsWith(".keygen.sh")) return true;
-      // Buoy's own license endpoint (7.0.39+): the same traffic, new address.
-      if ((parsed.hostname === "buoy.gg" || parsed.hostname === "www.buoy.gg") && parsed.pathname.startsWith("/api/license")) return true;
-      const local = parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1" || parsed.hostname === "10.0.2.2";
-      if (local && ["8081", "8802"].includes(parsed.port)) return true;
-      // The dev server this bundle actually came from, whatever its host and
-      // port (a LAN address, --port 8082…): Metro's own traffic — symbolicate,
-      // logs, HMR, the bundle — is not the app's.
-      const dev = devServerOrigin();
-      if (dev && `${parsed.protocol}//${parsed.host}` === dev) return true;
-    } catch {
-      return false;
-    }
-    return isInternalBuoyHost(url);
-  }
-
-  // Emit event to all listeners
-  emit(event) {
-    this.listeners.forEach(listener => {
-      try {
-        listener(event);
-      } catch (error) {
-        // Error in event listener - continuing with others
-      }
-    });
-  }
-
-  /**
-   * Parse URL to extract query parameters and clean URL
-   *
-   * @param url - The URL to parse
-   * @returns Object containing cleaned URL and parsed query parameters
-   *
-   * @performance Uses manual parsing instead of URL constructor for better performance
-   */
-  parseUrl(url) {
-    let params = null;
-    const queryParamIdx = url.indexOf("?");
-    if (queryParamIdx > -1) {
-      params = {};
-      url.substring(queryParamIdx + 1).split("&").forEach(pair => {
-        const [key, value] = pair.split("=");
-        if (key && value !== undefined) {
-          params[key] = decodeURIComponent(value.replace(/\+/g, " "));
-        }
-      });
-    }
-    return {
-      url: queryParamIdx > -1 ? url.substring(0, queryParamIdx) : url,
-      params
-    };
-  }
-
-  /**
-   * Process response body with size limits to prevent memory issues
-   * @param response - The Response object to process
-   * @param maxSize - Maximum body size in bytes (default: 1MB)
-   * @returns Object containing body, size, and truncation status
-   */
-  /**
-   * Read a streamed body in the background, with a hard ceiling.
-   *
-   * Deliberately not `processResponseBody`: that one calls `.text()`, which
-   * accumulates the WHOLE body before it checks the size, so a long-lived SSE
-   * stream would grow unbounded in memory with nothing to stop it. This stops
-   * at the cap and cancels the reader, and a runtime with no `body` (React
-   * Native's own fetch) falls back to `.text()` — that response was never
-   * streaming there in the first place.
-   */
-  async readStreamedBody(response, maxSize = 256 * 1024) {
-    const body = response.body;
-    if (!body || typeof body.getReader !== "function") {
-      const text = await response.text();
-      return text.length > maxSize ? {
-        body: `${text.slice(0, maxSize)}\n\n... [truncated]`,
-        size: text.length
-      } : {
-        body: text,
-        size: text.length
-      };
-    }
-    const reader = body.getReader();
-    const decoder = new TextDecoder();
-    let out = "";
-    let size = 0;
-    let capped = false;
-    try {
-      for (;;) {
-        const {
-          done,
-          value
-        } = await reader.read();
-        if (done) break;
-        size += value?.byteLength ?? 0;
-        if (!capped) {
-          out += decoder.decode(value, {
-            stream: true
-          });
-          if (size >= maxSize) {
-            out = `${out.slice(0, maxSize)}\n\n... [truncated]`;
-            capped = true;
-            break;
-          }
-        }
-      }
-      if (!capped) out += decoder.decode();
-    } finally {
-      try {
-        void Promise.resolve(reader.cancel()).catch(() => {});
-      } catch {
-        /* already gone */
-      }
-      try {
-        reader.releaseLock();
-      } catch {
-        /* already released */
-      }
-    }
-    return {
-      body: out,
-      size
-    };
-  }
-  async processResponseBody(response, maxSize = 1024 * 1024 // 1MB default
-  ) {
-    try {
-      // Check Content-Length header first
-      const contentLength = response.headers.get("content-length");
-      if (contentLength) {
-        const size = parseInt(contentLength, 10);
-        if (!isNaN(size) && size > maxSize) {
-          return {
-            body: `[Response too large: ${this.formatBytes(size)}]`,
-            size,
-            truncated: true
-          };
-        }
-      }
-
-      // Read the response text
-      const text = await response.text();
-      const size = text.length;
-
-      // Check if text exceeds max size
-      if (size > maxSize) {
-        const preview = text.substring(0, maxSize);
-        const omitted = size - maxSize;
-        return {
-          body: `${preview}\n\n... [truncated, ${this.formatBytes(omitted)} omitted]`,
-          size,
-          truncated: true
-        };
-      }
-
-      // Try to parse as JSON
-      try {
-        return {
-          body: JSON.parse(text),
-          size,
-          truncated: false
-        };
-      } catch {
-        // Return as text if not JSON
-        return {
-          body: text,
-          size,
-          truncated: false
-        };
-      }
-    } catch (error) {
-      return {
-        body: "~~~ unable to read body ~~~",
-        size: 0,
-        truncated: false
-      };
-    }
-  }
-
-  /**
-   * Format bytes into human-readable format
-   * @param bytes - Number of bytes
-   * @returns Formatted string (e.g., "1.5 MB")
-   */
-  formatBytes(bytes) {
-    if (bytes === 0) return "0 B";
-    const k = 1024;
-    const sizes = ["B", "KB", "MB", "GB"];
-    const i = Math.floor(Math.log(bytes) / Math.log(k));
-    return `${Math.round(bytes / Math.pow(k, i) * 100) / 100} ${sizes[i]}`;
-  }
-
-  /**
-   * Handle XMLHttpRequest response processing
-   * This method processes the response and emits appropriate events
-   */
-  handleXHRResponse(xhr, requestId, cleanUrl, method, requestHeaders, requestData, params, startTime, isError = false, clientType = "xhr", override, condition) {
-    const duration = startTime ? Date.now() - startTime : 0;
-
-    // XHR's duration was ALREADY total (measured at readyState 4 / load), so
-    // only the split is new. `_buoyTtfb` is stamped at HEADERS_RECEIVED; it is
-    // absent for a request that failed before any headers arrived, and the
-    // breakdown is then correctly omitted rather than faked as 0.
-    const ttfb = xhr._buoyTtfb;
-    const timings = ttfb === undefined ? undefined : {
-      ttfb,
-      download: Math.max(0, duration - ttfb)
-    };
-    if (isError || xhr.status === 0) {
-      // Network error or aborted request
-      this.emit({
-        type: "error",
-        timestamp: new Date(),
-        duration,
-        request: {
-          id: requestId || "unknown",
-          url: cleanUrl,
-          method,
-          headers: requestHeaders,
-          data: requestData,
-          params: params || undefined,
-          client: clientType
-        },
-        error: {
-          message: isError ? "Request failed" : "Network error or request aborted"
-        },
-        override,
-        condition
-      });
-      return;
-    }
-
-    // Parse response
-    let body;
-    let responseSize = 0;
-    try {
-      const response = xhr.response;
-
-      // Debug logging to help diagnose responseType issues
-
-      // Try different ways to get response based on responseType
-      if (xhr.responseType === "json" && response) {
-        // Response is already parsed as JSON
-        body = response;
-        responseSize = JSON.stringify(response).length;
-      } else if (xhr.responseType === "" || xhr.responseType === "text") {
-        // Only access responseText when responseType allows it
-        if (xhr.responseText) {
-          responseSize = xhr.responseText.length;
-          try {
-            body = JSON.parse(xhr.responseText);
-          } catch {
-            body = xhr.responseText;
-          }
-        }
-      } else if (xhr.responseType === "arraybuffer") {
-        // For arraybuffer, try to decode as text and parse as JSON
-        // This is common for Axios requests that return JSON
-        if (response) {
-          try {
-            const text = new TextDecoder("utf-8").decode(response);
-            responseSize = text.length;
-            try {
-              body = JSON.parse(text);
-            } catch {
-              // Not JSON, return as text
-              body = text;
-            }
-          } catch (decodeError) {
-            // Failed to decode, show placeholder
-            body = `[arraybuffer response - ${response.byteLength || 0} bytes]`;
-            responseSize = response.byteLength || 0;
-          }
-        } else {
-          body = `[arraybuffer response - no data]`;
-          responseSize = 0;
-        }
-      } else if (xhr.responseType === "blob") {
-        // For blob responses, we can't synchronously read the content
-        // Note: In React Native, most JSON responses shouldn't be blobs
-        // but if they are, we show metadata
-        if (response instanceof Blob) {
-          body = `[blob response - ${response.size} bytes, type: ${response.type || "unknown"}]`;
-          responseSize = response.size;
-        } else if (response) {
-          // Sometimes response might not be a Blob object but still have data
-          // Try to handle it as an object
-          try {
-            body = typeof response === "string" ? JSON.parse(response) : response;
-            responseSize = JSON.stringify(body).length;
-          } catch {
-            body = `[blob response - unable to parse]`;
-            responseSize = 0;
-          }
-        } else {
-          body = `[blob response - no data]`;
-          responseSize = 0;
-        }
-      } else if (response) {
-        // Fallback: try to handle the response regardless of responseType
-        // This catches cases where Axios sets an unexpected responseType
-        if (typeof response === "string") {
-          body = response;
-          responseSize = response.length;
-          // Try to parse as JSON if it's a string
-          try {
-            body = JSON.parse(response);
-          } catch {
-            // Not JSON, keep as string
-          }
-        } else if (typeof response === "object") {
-          // Already an object, use it directly
-          body = response;
-          responseSize = JSON.stringify(response).length;
-        } else {
-          body = String(response);
-          responseSize = String(response).length;
-        }
-      }
-    } catch (error) {
-      // Failed to parse response
-      body = "~~~ unable to read body ~~~";
-    }
-
-    // Parse response headers
-    const responseHeaders = {};
-    try {
-      const headerString = xhr.getAllResponseHeaders();
-      if (headerString) {
-        headerString.split("\r\n").forEach(line => {
-          if (line) {
-            const colonIndex = line.indexOf(": ");
-            if (colonIndex > 0) {
-              const key = line.substring(0, colonIndex).toLowerCase();
-              const value = line.substring(colonIndex + 2);
-              responseHeaders[key] = value;
-            }
-          }
-        });
-      }
-    } catch {
-      // Ignore header parsing errors
-    }
-
-    // Emit response or error based on status. A 4xx/5xx is a completed HTTP
-    // response, not a transport error — RN XHR leaves statusText empty, which
-    // used to become `event.error = "HTTP 500: "` and MCP `ERR HTTP 500: no error`.
-    if (xhrCompletionKind(xhr.status) === "response") {
-      this.emit({
-        type: "response",
-        timestamp: new Date(),
-        duration,
-        timings,
-        request: {
-          id: requestId || "unknown",
-          url: cleanUrl,
-          method,
-          headers: requestHeaders,
-          data: requestData,
-          params: params || undefined,
-          client: clientType
-        },
-        response: {
-          status: xhr.status,
-          statusText: httpStatusText(xhr.status, xhr.statusText),
-          headers: responseHeaders,
-          body,
-          size: responseSize
-        },
-        override,
-        condition
-      });
-    } else {
-      this.emit({
-        type: "error",
-        timestamp: new Date(),
-        duration,
-        request: {
-          id: requestId || "unknown",
-          url: cleanUrl,
-          method,
-          headers: requestHeaders,
-          data: requestData,
-          params: params || undefined,
-          client: clientType
-        },
-        response: {
-          status: xhr.status,
-          statusText: xhr.statusText,
-          headers: responseHeaders,
-          body,
-          size: responseSize
-        },
-        error: {
-          message: "Network Error"
-        },
-        override,
-        condition
-      });
-    }
-  }
-
-  /** Is our fetch interceptor still reachable through the global chain? */
-  isFetchInterceptionLive() {
-    return globalThis.fetch[BUOY_FETCH_INTERCEPTOR_FLAG] === true;
-  }
-
-  /** Is our XHR interceptor still reachable through the prototype chain? */
-  isXhrInterceptionLive() {
-    return XMLHttpRequest.prototype.send[BUOY_XHR_INTERCEPTOR_FLAG] === true;
-  }
-
-  /**
-   * Both halves of the interceptor are reachable — requests actually flow
-   * through capture. `isListening` alone cannot promise that (see
-   * startListening); diagnostics should report THIS.
-   */
-  isInterceptionLive() {
-    return this.isFetchInterceptionLive() && this.isXhrInterceptionLive();
-  }
-
-  /**
-   * Start (or repair) interception by swizzling fetch and XMLHttpRequest.
-   *
-   * NOT guarded by a plain `isListening` flag: `globalThis.fetch` gets
-   * re-assigned in the wild — Expo's winter runtime, React Native DevTools'
-   * network panel, a second dev server's tooling, hot-reload churn. When that
-   * happens the flag still says "listening" while every request bypasses
-   * capture, and a flag-only guard makes the outage PERMANENT (observed as
-   * "No network events" forever with `interceptorInstalled: true`). So this
-   * verifies each interceptor is actually reachable (marker check) and
-   * re-installs whichever half was clobbered, wrapping the CURRENT global so
-   * whatever replaced us keeps working underneath. When both halves are live
-   * this costs two property reads.
-   *
-   * @performance Uses method swizzling for minimal runtime overhead
-   * @performance Includes request deduplication through ignored URL patterns
-   */
-  startListening() {
-    const fetchLive = this.isListening && this.isFetchInterceptionLive();
-    const xhrLive = this.isListening && this.isXhrInterceptionLive();
-    if (fetchLive && xhrLive) {
-      return;
-    }
-    if (!fetchLive) {
-      this.installFetchInterceptor();
-    }
-    if (!xhrLive) {
-      this.installXhrInterceptor();
-    }
-    this.isListening = true;
-    if (__DEV__) {
-      // Network listener has started monitoring fetch and XMLHttpRequest operations
-    }
-  }
-
-  /** Swizzle `globalThis.fetch`, wrapping whatever is installed right now. */
-  installFetchInterceptor() {
-    const self = this;
-    // The pass-through is the CURRENT global (not the construction-time one):
-    // re-installing after a clobber must call through the replacement, and a
-    // stale generation must replay the chain exactly as it stood beneath it.
-    const passthroughFetch = globalThis.fetch.bind(globalThis);
-    this.originalFetch = globalThis.fetch;
-    const generation = ++this.fetchGeneration;
-    const wrappedFetch = async (input, init) => {
-      const url = resolveRequestUrl(typeof input === "string" ? input : input instanceof URL ? input.href : input.url);
-
-      // A newer install supersedes this wrapper. If it is still stranded in
-      // another tool's chain it must pass through silently, or one request
-      // would be reported once per stranded generation.
-      if (generation !== self.fetchGeneration) {
-        return passthroughFetch(input, init);
-      }
-
-      // Skip ignored URLs
-      if (self.shouldIgnoreUrl(url)) {
-        return passthroughFetch(input, init);
-      }
-      const startTime = Date.now();
-      const requestId = nextRequestId("fetch");
-      const inputRequest = typeof input === "object" && "method" in input ? input : undefined;
-      const method = init?.method ?? inputRequest?.method ?? "GET";
-      const signal = init?.signal !== undefined ? init.signal : inputRequest?.signal;
-      throwIfAborted(signal);
-      const condition = snapshotNetworkCondition(url);
-      const {
-        url: cleanUrl,
-        params
-      } = self.parseUrl(url);
-
-      // Parse request headers
-      let requestHeaders = {};
-      const headers = init?.headers ?? inputRequest?.headers;
-      if (headers) {
-        if (headers instanceof Headers) {
-          headers.forEach((value, key) => {
-            requestHeaders[key] = value;
-          });
-        } else if (Array.isArray(headers)) {
-          headers.forEach(([key, value]) => {
-            requestHeaders[key] = value;
-          });
-        } else {
-          requestHeaders = {
-            ...headers
-          };
-        }
-      }
-      Object.assign(requestHeaders, injectedHeaders(url));
-
-      // Parse request body
-      // Explicitly typed: the late emit for a streamed reply reads this from
-      // inside a callback, which defeats the inference it used to rely on.
-      let requestData;
-      if (init?.body) {
-        if (typeof init.body === "string") {
-          try {
-            requestData = JSON.parse(init.body);
-          } catch {
-            requestData = init.body;
-          }
-        } else {
-          requestData = init.body;
-        }
-      }
-
-      // Determine client type from X-Request-Client header or default to fetch
-      const clientType = requestHeaders["X-Request-Client"] || requestHeaders["x-request-client"] || "fetch";
-
-      /**
-       * Response overrides, fetch side.
-       *
-       * Needed even though `send` below also resolves them: Expo installs a
-       * NATIVE `expo/fetch` as `globalThis.fetch`, which never constructs an
-       * XMLHttpRequest, so the XHR hook alone would never see these requests.
-       * Skipped when `canSynthesizeResponse()` is false so a runtime without a
-       * `Response` global degrades to a real request rather than a broken one.
-       */
-      const outcome = condition?.profile !== "offline" && canSynthesizeResponse() ? overrideForRequest(url, method) : null;
-      const override = outcome ? markForOutcome(outcome) : undefined;
-
-      // Emit request event
-      self.emit({
-        type: "request",
-        timestamp: new Date(),
-        request: {
-          id: requestId || "unknown",
-          url: cleanUrl,
-          method,
-          headers: requestHeaders,
-          data: requestData,
-          params: params || undefined,
-          client: clientType
-        },
-        override,
-        condition
-      });
-
-      // Clone before dispatch; inspect the body without delaying or consuming the app's upload.
-      if (init?.body === undefined && inputRequest?.body && !inputRequest.bodyUsed) {
-        try {
-          const bodyCopy = inputRequest.clone();
-          void self.readStreamedBody(bodyCopy).then(({
-            body
-          }) => {
-            try {
-              requestData = JSON.parse(body);
-            } catch {
-              requestData = body;
-            }
-            self.emit({
-              type: "request-body",
-              timestamp: new Date(),
-              request: {
-                id: requestId || "unknown",
-                url: cleanUrl,
-                method,
-                data: requestData,
-                client: clientType
-              }
-            });
-          }).catch(() => {});
-        } catch {
-          // An unreadable body must not prevent the app's request.
-        }
-      }
-      try {
-        if (condition || outcome) await waitBeforeDispatch((condition?.delayMs ?? 0) + (outcome?.delayMs ?? 0), signal);
-        throwIfAborted(signal);
-        if (condition?.profile === "offline") throw new TypeError("Network request failed (Buoy Offline)");
-        if (outcome?.kind === "fail") throw synthesizeFetchError(outcome);
-        let response;
-        if (outcome?.kind === "respond") {
-          response = synthesizeResponse(url, outcome);
-        } else {
-          // The flag spans the CALL only — see `insideFetchHandoff`. It has
-          // to be cleared before the await, or it would still be raised for
-          // every unrelated request that starts while this one is in flight.
-          const previousFetchHandoff = insideFetchHandoff;
-          insideFetchHandoff = true;
-          let pending;
-          try {
-            pending = passthroughFetch(input, init);
-          } finally {
-            insideFetchHandoff = previousFetchHandoff;
-          }
-          response = await pending;
-        }
-        // A fetch promise resolves when the HEADERS arrive, not the body — so
-        // this is time-to-first-byte, and it is where `duration` used to stop.
-        // That silently excluded download time, making an identical request
-        // look faster through fetch than through XHR.
-        const ttfb = Date.now() - startTime;
-
-        /**
-         * A STREAMED reply is never awaited here.
-         *
-         * `processResponseBody` reads the clone to the end, and for
-         * `text/event-stream` the end is when the server finishes — seconds
-         * later, for an LLM. Awaiting it made the interceptor hold the
-         * response back until then, so every consumer of a streaming endpoint
-         * inside an app with capture on received the whole thing at once and
-         * could not stream a word of it. The row is emitted now with what is
-         * known, and the body is filled in when the stream closes: the store
-         * merges a second `response` event onto the same request id.
-         */
-        const streamed = typeof response.body?.getReader === "function" || isStreamedContentType(response.headers?.get?.("content-type"));
-
-        // Clone response to read body with size limits
-        const responseClone = response.clone();
-        const {
-          body,
-          size: responseSize
-        } = streamed ? {
-          body: STREAMING_PLACEHOLDER,
-          size: 0
-        } : await self.processResponseBody(responseClone);
-
-        // Now the body is in — this is the comparable, total number.
-        const duration = Date.now() - startTime;
-
-        /**
-         * The split is only real on platforms whose fetch resolves at HEADERS.
-         *
-         * React Native's does NOT: `fetch` there is the whatwg-fetch polyfill
-         * over XMLHttpRequest, and it resolves inside `xhr.onload` — readyState
-         * 4, i.e. after the entire body. On device this `ttfb` is therefore the
-         * total and the download phase collapses to ~0, so claiming a "0ms
-         * download" would be asserting a measurement we never made.
-         *
-         * Omitting is the right answer rather than a problem: RN's fetch runs
-         * through XMLHttpRequest, so the XHR interceptor below sees readyState 2
-         * and supplies a genuine TTFB for those requests anyway. Where fetch is
-         * native (web, Node), the gap is real and we keep it.
-         *
-         * Verified both ways against a server that flushes headers then holds
-         * the body 250ms: native fetch → 16ms / 251ms; resolve-at-end → the
-         * download phase vanishes, which is what this guard catches.
-         */
-        const download = Math.max(0, duration - ttfb);
-        const timings = download > 0 ? {
-          ttfb,
-          download
-        } : undefined;
-
-        // Parse response headers
-        const responseHeaders = {};
-        response.headers.forEach((value, key) => {
-          responseHeaders[key.toLowerCase()] = value;
-        });
-
-        // Emit response event
-        self.emit({
-          type: "response",
-          timestamp: new Date(),
-          duration,
-          timings,
-          request: {
-            id: requestId || "unknown",
-            url: cleanUrl,
-            method,
-            headers: requestHeaders,
-            data: requestData,
-            params: params || undefined,
-            client: clientType
-          },
-          response: {
-            status: response.status,
-            statusText: response.statusText,
-            headers: responseHeaders,
-            body,
-            size: responseSize
-          },
-          override,
-          condition
-        });
-        if (streamed) {
-          // Bounded, cancelled at the cap, and never awaited by the caller.
-          void self.readStreamedBody(responseClone).then(late => {
-            let capturedBody = late.body;
-            if (response.headers?.get?.("content-type")?.includes("json")) {
-              try {
-                capturedBody = JSON.parse(late.body);
-              } catch {/* Partial or malformed JSON stays text. */}
-            }
-            self.emit({
-              type: "response",
-              timestamp: new Date(),
-              duration: Date.now() - startTime,
-              timings,
-              request: {
-                id: requestId || "unknown",
-                url: cleanUrl,
-                method,
-                headers: requestHeaders,
-                data: requestData,
-                params: params || undefined,
-                client: clientType
-              },
-              response: {
-                status: response.status,
-                statusText: response.statusText,
-                headers: responseHeaders,
-                body: capturedBody,
-                size: late.size
-              },
-              override,
-              condition
-            });
-          }).catch(() => {
-            /* the caller's response is unaffected either way */
-          });
-        }
-        return response;
-      } catch (error) {
-        const duration = Date.now() - startTime;
-
-        // Emit error event
-        self.emit({
-          type: "error",
-          timestamp: new Date(),
-          duration,
-          request: {
-            id: requestId || "unknown",
-            url: cleanUrl,
-            method,
-            headers: requestHeaders,
-            data: requestData,
-            params: params || undefined,
-            client: clientType
-          },
-          error: {
-            message: error instanceof Error ? error.message : "Network error",
-            stack: error instanceof Error ? error.stack : undefined
-          },
-          override,
-          condition
-        });
-        throw error;
-      }
-    };
-    wrappedFetch[BUOY_FETCH_INTERCEPTOR_FLAG] = true;
-    this.patchedFetch = wrappedFetch;
-    globalThis.fetch = this.patchedFetch;
-  }
-
-  /** Swizzle the XHR prototype methods, wrapping whatever is installed now. */
-  installXhrInterceptor() {
-    const self = this;
-    // Same contract as the fetch half: pass through to the CURRENT methods.
-    const passthroughOpen = XMLHttpRequest.prototype.open;
-    const passthroughSend = XMLHttpRequest.prototype.send;
-    const passthroughSetRequestHeader = XMLHttpRequest.prototype.setRequestHeader;
-    this.originalXHROpen = passthroughOpen;
-    this.originalXHRSend = passthroughSend;
-    this.originalXHRSetRequestHeader = passthroughSetRequestHeader;
-    const generation = ++this.xhrGeneration;
-    const pendingCapture = new WeakMap();
-    const patchedOpen = function (method, url, async, user, password) {
-      // Native validation runs before replacing metadata or capture listeners.
-      const result = passthroughOpen.call(this, method, url, async ?? true, user, password);
-      if (generation === self.xhrGeneration) {
-        pendingCapture.get(this)?.();
-        const xhr = this;
-        xhr._buoyRequestId = nextRequestId("xhr");
-        xhr._method = method;
-        xhr._url = resolveRequestUrl(url);
-        xhr._buoyStartTime = Date.now();
-        xhr._requestHeaders = {};
-      }
-      return result;
-    };
-
-    // Track request headers
-    const patchedSetRequestHeader = function (header, value) {
-      const xhr = this;
-      if (generation === self.xhrGeneration && xhr._requestHeaders) {
-        xhr._requestHeaders[header] = value;
-      }
-      return passthroughSetRequestHeader.call(this, header, value);
-    };
-    const patchedSend = function (
-    // @ts-ignore - this does exist on native
-    data) {
-      // Superseded generation: silent pass-through (see the fetch wrapper).
-      if (generation !== self.xhrGeneration || insideFetchHandoff) {
-        return passthroughSend.call(this, data);
-      }
-      if (hasPendingStandardRequest(this)) throw new DOMException("The request has already been sent.", "InvalidStateError");
-      if (this.readyState !== 1 || this._sent) {
-        return passthroughSend.call(this, data);
-      }
-      const xhr = this;
-      const requestId = xhr._buoyRequestId;
-      const method = xhr._method || "GET";
-      const url = xhr._url || "";
-      const startTime = Date.now();
-      xhr._buoyStartTime = startTime;
-      xhr._buoyTtfb = undefined;
-      const requestHeaders = xhr._requestHeaders || {};
-      Object.assign(requestHeaders, injectedHeaders(url));
-
-      // Skip ignored URLs
-      if (self.shouldIgnoreUrl(url)) {
-        return passthroughSend.call(this, data);
-      }
-      const {
-        url: cleanUrl,
-        params
-      } = self.parseUrl(url);
-
-      // Parse request data
-      let requestData;
-      if (data) {
-        if (typeof data === "string") {
-          try {
-            requestData = JSON.parse(data);
-          } catch {
-            requestData = data;
-          }
-        } else {
-          requestData = data;
-        }
-      }
-
-      // Determine client type. Honor an explicit X-Request-Client header first.
-      // Otherwise sniff axios via its default Accept header and fall back to
-      // "xhr" — defaulting to "axios" misclassified every raw XMLHttpRequest.
-      const explicitClient = requestHeaders["X-Request-Client"] || requestHeaders["x-request-client"];
-      const acceptHeader = requestHeaders["Accept"] || requestHeaders["accept"] || "";
-      const looksLikeAxios = acceptHeader.includes("application/json") && acceptHeader.includes("text/plain") && acceptHeader.includes("*/*");
-      const clientType = explicitClient || (looksLikeAxios ? "axios" : "xhr");
-
-      /**
-       * Response overrides.
-       *
-       * This is the layer that covers `axios` and raw XMLHttpRequest. It also
-       * covers `fetch` on BARE React Native, where the whatwg-fetch polyfill
-       * runs through XHR — which is why the fetch wrapper raises
-       * `insideFetchHandoff` around its pass-through, so one request can't
-       * be overridden twice.
-       *
-       * Matching uses the raw `url` (query string included), which is what the
-       * developer sees in the list and writes into a rule. No-ops in production
-       * builds; see `overrideForRequest`.
-       */
-      const condition = snapshotNetworkCondition(url);
-      const outcome = condition?.profile === "offline" ? null : overrideForRequest(url, method);
-      const override = outcome ? markForOutcome(outcome) : undefined;
-
-      // Emit request event
-      self.emit({
-        type: "request",
-        timestamp: new Date(),
-        request: {
-          id: requestId || "unknown",
-          url: cleanUrl,
-          method,
-          headers: requestHeaders,
-          data: requestData,
-          params: params || undefined,
-          client: clientType
-        },
-        override,
-        condition
-      });
-
-      // Track if we've already processed this request to avoid duplicate events
-      let processed = false;
-      const processResponse = (isError = false) => {
-        if (processed) return;
-        processed = true;
-        self.handleXHRResponse(this, requestId || "unknown", cleanUrl, method, requestHeaders, requestData, params, startTime || 0, isError, clientType, override, condition);
-        // Clean up event listeners after processing to prevent memory leaks
-        cleanup();
-      };
-
-      // Cleanup function to remove event listeners
-      const cleanup = () => {
-        pendingCapture.delete(this);
-        this.removeEventListener("load", loadListener);
-        this.removeEventListener("error", errorListener);
-        this.removeEventListener("abort", abortListener);
-        this.removeEventListener("readystatechange", readyStateListener);
-      };
-      pendingCapture.set(this, cleanup);
-
-      // Use addEventListener to listen to events WITHOUT replacing user handlers
-      // This is critical because React Native's XMLHttpRequest uses EventTarget
-      // with getters/setters that shouldn't be overridden
-
-      const loadListener = () => {
-        processResponse(false);
-      };
-      const errorListener = () => {
-        processResponse(true);
-      };
-      const abortListener = () => {
-        processResponse(true);
-      };
-      const readyStateListener = () => {
-        // HEADERS_RECEIVED — the XHR equivalent of a fetch promise resolving.
-        // This listener is already attached for the readyState-4 fallback, and
-        // readystatechange fires whether or not we look at it, so capturing
-        // TTFB here costs one comparison and one clock read.
-        if (this.readyState === 2) {
-          const xhr = this;
-          if (xhr._buoyTtfb === undefined && xhr._buoyStartTime) {
-            xhr._buoyTtfb = Date.now() - xhr._buoyStartTime;
-          }
-        }
-        if (this.readyState === 4 && !processed) {
-          processResponse(false);
-        }
-      };
-
-      // Add event listeners that will fire alongside user handlers
-      this.addEventListener("load", loadListener);
-      this.addEventListener("error", errorListener);
-      this.addEventListener("abort", abortListener);
-      this.addEventListener("readystatechange", readyStateListener);
-      if (condition) {
-        runConditionXhr(this, url, condition, outcome, () => passthroughSend.call(this, data));
-        return;
-      }
-      if (outcome) {
-        // Listeners are attached above FIRST: `runOverride` drives the same
-        // readyState transitions a real response would, and the interceptor has
-        // to see them (readyState 2 is where TTFB is stamped).
-        const handled = runOverride(this, url, outcome, () => passthroughSend.call(this, data));
-        // `handled` is false only where this isn't React Native's own
-        // XMLHttpRequest and can't be driven by hand. Fall through and send for
-        // real rather than dropping the request on the floor.
-        if (handled) return;
-      }
-      return passthroughSend.call(this, data);
-    };
-    patchedSend[BUOY_XHR_INTERCEPTOR_FLAG] = true;
-    this.patchedXHROpen = patchedOpen;
-    this.patchedXHRSend = patchedSend;
-    this.patchedXHRSetRequestHeader = patchedSetRequestHeader;
-    XMLHttpRequest.prototype.open = this.patchedXHROpen;
-    XMLHttpRequest.prototype.send = this.patchedXHRSend;
-    XMLHttpRequest.prototype.setRequestHeader = this.patchedXHRSetRequestHeader;
-  }
-
-  /**
-   * Stop listening and restore original networking methods
-   *
-   * This method restores the original fetch and XMLHttpRequest implementations,
-   * effectively disabling network monitoring.
-   */
-  stopListening() {
-    if (!this.isListening) {
-      return;
-    }
-
-    // Silence any of our wrappers stranded inside another tool's chain — they
-    // check the generation on every call and now pass through without emitting.
-    this.fetchGeneration++;
-    this.xhrGeneration++;
-
-    // Restore ONLY what is still literally ours. If another tool patched after
-    // us (impersonate, a debugger), assigning our saved originals would wipe
-    // ITS interceptor — the exact injury startListening defends against.
-    if (this.patchedFetch && globalThis.fetch === this.patchedFetch) {
-      globalThis.fetch = this.originalFetch;
-    }
-    if (this.patchedXHROpen && XMLHttpRequest.prototype.open === this.patchedXHROpen) {
-      XMLHttpRequest.prototype.open = this.originalXHROpen;
-    }
-    if (this.patchedXHRSend && XMLHttpRequest.prototype.send === this.patchedXHRSend) {
-      XMLHttpRequest.prototype.send = this.originalXHRSend;
-    }
-    if (this.patchedXHRSetRequestHeader && XMLHttpRequest.prototype.setRequestHeader === this.patchedXHRSetRequestHeader) {
-      XMLHttpRequest.prototype.setRequestHeader = this.originalXHRSetRequestHeader;
-    }
-    this.patchedFetch = null;
-    this.patchedXHROpen = null;
-    this.patchedXHRSend = null;
-    this.patchedXHRSetRequestHeader = null;
-    this.isListening = false;
-    if (__DEV__) {
-      // Network listener has stopped monitoring and restored original methods
-    }
-  }
-
-  /**
-   * Add a listener for network events
-   *
-   * @param listener - Callback function to handle network events
-   * @returns Unsubscribe function to remove the listener
-   */
-  addListener(listener) {
-    this.listeners.push(listener);
-
-    // Return unsubscribe function
-    return () => {
-      const index = this.listeners.indexOf(listener);
-      if (index > -1) {
-        this.listeners.splice(index, 1);
-      }
-    };
-  }
-
-  // Remove all listeners
-  removeAllListeners() {
-    this.listeners = [];
-  }
-
-  // Check if currently listening
-  get isActive() {
-    return this.isListening;
-  }
-
-  // Get number of active listeners
-  get listenerCount() {
-    return this.listeners.length;
-  }
-}
-
-/**
- * Lazy singleton instance holder for NetworkListener
- *
- * This pattern ensures only one NetworkListener instance exists throughout
- * the application lifecycle while deferring instantiation until first use.
- */
-let _networkListener = null;
-
-/**
- * Get or create the singleton NetworkListener instance
- *
- * @returns The singleton NetworkListener instance
- */
-const getNetworkListener = () => {
-  if (!_networkListener) {
-    _networkListener = new NetworkListener();
-  }
-  return _networkListener;
-};
-
-/**
- * Access function for the singleton NetworkListener instance
- *
- * @returns Function that returns the NetworkListener instance
- */
-export const networkListener = getNetworkListener;
-
-/**
- * Start network traffic monitoring
- *
- * @example
- * ```typescript
- * startNetworkListener();
- * console.log('Network monitoring started');
- * ```
- */
-export const startNetworkListener = () => getNetworkListener().startListening();
-
-/**
- * Stop network traffic monitoring
- */
-export const stopNetworkListener = () => _networkListener?.stopListening();
-
-/**
- * Add a listener for network events
- *
- * @param listener - Callback function to handle network events
- * @returns Unsubscribe function to remove the listener
- *
- * @example
- * ```typescript
- * const unsubscribe = addNetworkListener((event) => {
- *   console.log(`Network ${event.type}:`, event.request.url);
- * });
- *
- * // Later...
- * unsubscribe();
- * ```
- */
-export const addNetworkListener = listener => getNetworkListener().addListener(listener);
-
-/**
- * Remove all registered network event listeners
- */
-export const removeAllNetworkListeners = () => _networkListener?.removeAllListeners();
-
-/**
- * Check if network monitoring is currently active
- *
- * @returns True if currently intercepting network traffic
- */
-export const isNetworkListening = () => _networkListener?.isActive ?? false;
-
-/**
- * Get the number of registered network event listeners
- *
- * @returns Number of active listeners
- */
-export const getNetworkListenerCount = () => _networkListener?.listenerCount ?? 0;
-
-/**
- * Whether both interceptors are actually reachable through the live global
- * chain — the honest version of `isNetworkListening` (whose flag stays true
- * even after another tool re-assigns `globalThis.fetch` over the wrapper).
- */
-export const isNetworkInterceptionLive = () => _networkListener?.isInterceptionLive() ?? false;
+... [truncated, ${this.formatBytes(u)} omitted]`,size:a,truncated:true}}try{return{body:JSON.parse(c),size:a,truncated:false}}catch{return{body:c,size:a,truncated:false}}}catch(s){return{body:"~~~ unable to read body ~~~",size:0,truncated:false}}}formatBytes(e){if(e===0)return"0 B";const t=1024;const s=["B","KB","MB","GB"];const c=Math.floor(Math.log(e)/Math.log(t));return`${Math.round(e/Math.pow(t,c)*100)/100} ${s[c]}`}handleXHRResponse(e,t,s,c,a,r,u,g,f=false,i="xhr",d,L){const m=g?_()-g:0;const l=e._buoyTtfb;const q=l===void 0?void 0:{ttfb:l,download:Math.max(0,m-l)};if(f||e.status===0){this.emit({type:"error",timestamp:new Date,duration:m,request:{id:t||"unknown",url:s,method:c,headers:a,data:r,params:u||void 0,client:i},error:{message:f?"Request failed":"Network error or request aborted"},override:d,condition:L});return}let n;let p=0;try{const o=e.response;if(e.responseType==="json"&&o){n=o;p=JSON.stringify(o).length}else if(e.responseType===""||e.responseType==="text"){if(e.responseText){p=e.responseText.length;try{n=JSON.parse(e.responseText)}catch{n=e.responseText}}}else if(e.responseType==="arraybuffer"){if(o){try{const y=new TextDecoder("utf-8").decode(o);p=y.length;try{n=JSON.parse(y)}catch{n=y}}catch(y){n=`[arraybuffer response - ${o.byteLength||0} bytes]`;p=o.byteLength||0}}else{n=`[arraybuffer response - no data]`;p=0}}else if(e.responseType==="blob"){if(o instanceof Blob){n=`[blob response - ${o.size} bytes, type: ${o.type||"unknown"}]`;p=o.size}else if(o){try{n=typeof o==="string"?JSON.parse(o):o;p=JSON.stringify(n).length}catch{n=`[blob response - unable to parse]`;p=0}}else{n=`[blob response - no data]`;p=0}}else if(o){if(typeof o==="string"){n=o;p=o.length;try{n=JSON.parse(o)}catch{}}else if(typeof o==="object"){n=o;p=JSON.stringify(o).length}else{n=String(o);p=String(o).length}}}catch(o){n="~~~ unable to read body ~~~"}const R={};try{const o=e.getAllResponseHeaders();if(o){o.split("\r\n").forEach(y=>{if(y){const w=y.indexOf(": ");if(w>0){const h=y.substring(0,w).toLowerCase();const H=y.substring(w+2);R[h]=H}}})}}catch{}if(se(e.status)==="response"){this.emit({type:"response",timestamp:new Date,duration:m,timings:q,request:{id:t||"unknown",url:s,method:c,headers:a,data:r,params:u||void 0,client:i},response:{status:e.status,statusText:te(e.status,e.statusText),headers:R,body:n,size:p},override:d,condition:L})}else{this.emit({type:"error",timestamp:new Date,duration:m,request:{id:t||"unknown",url:s,method:c,headers:a,data:r,params:u||void 0,client:i},response:{status:e.status,statusText:e.statusText,headers:R,body:n,size:p},error:{message:"Network Error"},override:d,condition:L})}}isFetchInterceptionLive(){return globalThis.fetch[BUOY_FETCH_INTERCEPTOR_FLAG]===true}isXhrInterceptionLive(){return XMLHttpRequest.prototype.send[BUOY_XHR_INTERCEPTOR_FLAG]===true}isInterceptionLive(){return this.isFetchInterceptionLive()&&this.isXhrInterceptionLive()}startListening(){const e=this.isListening&&this.isFetchInterceptionLive();const t=this.isListening&&this.isXhrInterceptionLive();if(e&&t){return}if(!e){this.installFetchInterceptor()}if(!t){this.installXhrInterceptor()}this.isListening=true;if(__DEV__){}}installFetchInterceptor(){const e=this;const t=globalThis.fetch.bind(globalThis);this.originalFetch=globalThis.fetch;const s=++this.fetchGeneration;const c=async(a,r)=>{const u=U(typeof a==="string"?a:a instanceof URL?a.href:a.url);if(s!==e.fetchGeneration){return t(a,r)}if(e.shouldIgnoreUrl(u)){return t(a,r)}const g=_();const f=B("fetch");const i=typeof a==="object"&&"method"in a?a:void 0;const d=r?.method??i?.method??"GET";const L=r?.signal!==void 0?r.signal:i?.signal;G(L);const m=z(u);const{url:l,params:q}=e.parseUrl(u);let n={};const p=r?.headers??i?.headers;if(p){if(p instanceof Headers){p.forEach((h,H)=>{n[H]=h})}else if(Array.isArray(p)){p.forEach(([h,H])=>{n[h]=H})}else{n={...p}}}Object.assign(n,$(u));let R;if(r?.body){if(typeof r.body==="string"){try{R=JSON.parse(r.body)}catch{R=r.body}}else{R=r.body}}const o=n["X-Request-Client"]||n["x-request-client"]||"fetch";const y=m?.profile!=="offline"&&Q()?j(u,d,n):null;const w=y?J(y):void 0;e.emit({type:"request",timestamp:new Date,request:{id:f||"unknown",url:l,method:d,headers:n,data:R,params:q||void 0,client:o},override:w,condition:m});if(r?.body===void 0&&i?.body&&!i.bodyUsed){try{const h=i.clone();void e.readStreamedBody(h).then(({body:H})=>{try{R=JSON.parse(H)}catch{R=H}e.emit({type:"request-body",timestamp:new Date,request:{id:f||"unknown",url:l,method:d,data:R,client:o}})}).catch(()=>{})}catch{}}try{if(m||y)await K((m?.delayMs??0)+(y?.delayMs??0),L);G(L);if(m?.profile==="offline")throw new TypeError("Network request failed (Buoy Offline)");if(y?.kind==="fail")throw Z(y);let h;if(y?.kind==="respond"){h=ee(u,y)}else{const T=D;D=true;let X;try{X=t(a,r)}finally{D=T}h=await X}const H=_()-g;const S=typeof h.body?.getReader==="function"||ie(h.headers?.get?.("content-type"));const E=h.clone();const{body:F,size:I}=S?{body:P,size:0}:await e.processResponseBody(E);const x=_()-g;const C=Math.max(0,x-H);const M=C>0?{ttfb:H,download:C}:void 0;const N={};h.headers.forEach((T,X)=>{N[X.toLowerCase()]=T});e.emit({type:"response",timestamp:new Date,duration:x,timings:M,request:{id:f||"unknown",url:l,method:d,headers:n,data:R,params:q||void 0,client:o},response:{status:h.status,statusText:h.statusText,headers:N,body:F,size:I},override:w,condition:m});if(S){void e.readStreamedBody(E).then(T=>{let X=T.body;if(h.headers?.get?.("content-type")?.includes("json")){try{X=JSON.parse(T.body)}catch{}}e.emit({type:"response",timestamp:new Date,duration:_()-g,timings:M,request:{id:f||"unknown",url:l,method:d,headers:n,data:R,params:q||void 0,client:o},response:{status:h.status,statusText:h.statusText,headers:N,body:X,size:T.size},override:w,condition:m})}).catch(()=>{})}return h}catch(h){const H=_()-g;e.emit({type:"error",timestamp:new Date,duration:H,request:{id:f||"unknown",url:l,method:d,headers:n,data:R,params:q||void 0,client:o},error:{message:h instanceof Error?h.message:"Network error",stack:h instanceof Error?h.stack:void 0},override:w,condition:m});throw h}};c[BUOY_FETCH_INTERCEPTOR_FLAG]=true;this.patchedFetch=c;globalThis.fetch=this.patchedFetch}installXhrInterceptor(){const e=this;const t=XMLHttpRequest.prototype.open;const s=XMLHttpRequest.prototype.send;const c=XMLHttpRequest.prototype.setRequestHeader;this.originalXHROpen=t;this.originalXHRSend=s;this.originalXHRSetRequestHeader=c;const a=++this.xhrGeneration;const r=new WeakMap;const u=function(i,d,L,m,l){const q=t.call(this,i,d,L??true,m,l);if(a===e.xhrGeneration){r.get(this)?.();const n=this;n._buoyRequestId=B("xhr");n._method=i;n._url=U(d);n._buoyStartTime=_();n._requestHeaders={}}return q};const g=function(i,d){const L=this;if(a===e.xhrGeneration&&L._requestHeaders){L._requestHeaders[i]=d}return c.call(this,i,d)};const f=function(i){if(a!==e.xhrGeneration||D){return s.call(this,i)}if(W(this))throw new DOMException("The request has already been sent.","InvalidStateError");if(this.readyState!==1||this._sent){return s.call(this,i)}const d=this;const L=d._buoyRequestId;const m=d._method||"GET";const l=d._url||"";const q=_();d._buoyStartTime=q;d._buoyTtfb=void 0;const n=d._requestHeaders||{};Object.assign(n,$(l));if(e.shouldIgnoreUrl(l)){return s.call(this,i)}const{url:p,params:R}=e.parseUrl(l);let o;if(i){if(typeof i==="string"){try{o=JSON.parse(i)}catch{o=i}}else{o=i}}const y=n["X-Request-Client"]||n["x-request-client"];const w=n["Accept"]||n["accept"]||"";const h=w.includes("application/json")&&w.includes("text/plain")&&w.includes("*/*");const H=y||(h?"axios":"xhr");const S=z(l);const E=S?.profile==="offline"?null:j(l,m,n);const F=E?J(E):void 0;e.emit({type:"request",timestamp:new Date,request:{id:L||"unknown",url:p,method:m,headers:n,data:o,params:R||void 0,client:H},override:F,condition:S});let I=false;const x=(v=false)=>{if(I)return;I=true;e.handleXHRResponse(this,L||"unknown",p,m,n,o,R,q||0,v,H,F,S);C()};const C=()=>{r.delete(this);this.removeEventListener("load",M);this.removeEventListener("error",N);this.removeEventListener("abort",T);this.removeEventListener("readystatechange",X)};r.set(this,C);const M=()=>{x(false)};const N=()=>{x(true)};const T=()=>{x(true)};const X=()=>{if(this.readyState===2){const v=this;if(v._buoyTtfb===void 0&&v._buoyStartTime){v._buoyTtfb=_()-v._buoyStartTime}}if(this.readyState===4&&!I){x(false)}};this.addEventListener("load",M);this.addEventListener("error",N);this.addEventListener("abort",T);this.addEventListener("readystatechange",X);if(S){Y(this,l,S,E,()=>s.call(this,i));return}if(E){const v=V(this,l,E,()=>s.call(this,i));if(v)return}return s.call(this,i)};f[BUOY_XHR_INTERCEPTOR_FLAG]=true;this.patchedXHROpen=u;this.patchedXHRSend=f;this.patchedXHRSetRequestHeader=g;XMLHttpRequest.prototype.open=this.patchedXHROpen;XMLHttpRequest.prototype.send=this.patchedXHRSend;XMLHttpRequest.prototype.setRequestHeader=this.patchedXHRSetRequestHeader}stopListening(){if(!this.isListening){return}this.fetchGeneration++;this.xhrGeneration++;if(this.patchedFetch&&globalThis.fetch===this.patchedFetch){globalThis.fetch=this.originalFetch}if(this.patchedXHROpen&&XMLHttpRequest.prototype.open===this.patchedXHROpen){XMLHttpRequest.prototype.open=this.originalXHROpen}if(this.patchedXHRSend&&XMLHttpRequest.prototype.send===this.patchedXHRSend){XMLHttpRequest.prototype.send=this.originalXHRSend}if(this.patchedXHRSetRequestHeader&&XMLHttpRequest.prototype.setRequestHeader===this.patchedXHRSetRequestHeader){XMLHttpRequest.prototype.setRequestHeader=this.originalXHRSetRequestHeader}this.patchedFetch=null;this.patchedXHROpen=null;this.patchedXHRSend=null;this.patchedXHRSetRequestHeader=null;this.isListening=false;if(__DEV__){}}adoptEarlyRequests(){const e=globalThis.__BUOY_EARLY_NETWORK__;if(e?.version!==1)return;for(const t of e.adopt()){try{if(t.kind==="fetch")this.adoptEarlyFetch(t);else this.adoptEarlyXhr(t)}catch{}}}adoptEarlyFetch(e){const{input:t,init:s}=e;const c=typeof t==="object"&&"method"in t?t:void 0;const a=U(typeof t==="string"?t:t instanceof URL?t.href:t.url);if(this.shouldIgnoreUrl(a))return;const r=B("fetch");const u=s?.method??c?.method??"GET";const{url:g,params:f}=this.parseUrl(a);const i=re(s?.headers??c?.headers);let d=s?.body;if(typeof d==="string"){try{d=JSON.parse(d)}catch{}}const L=i["X-Request-Client"]||i["x-request-client"]||"fetch";const m=()=>({id:r,url:g,method:u,headers:i,data:d,params:f||void 0,client:L});this.emit({type:"request",timestamp:new Date(e.start),request:m()});if(e.requestCopy){void this.readStreamedBody(e.requestCopy).then(({body:l})=>{try{d=JSON.parse(l)}catch{d=l}this.emit({type:"request-body",timestamp:new Date,request:{id:r,url:g,method:u,data:d,client:L}})}).catch(()=>{})}void e.settled.then(async({response:l,clone:q,error:n,headersAt:p})=>{if(!l){this.emit({type:"error",timestamp:new Date,duration:p-e.start,request:m(),error:{message:n instanceof Error?n.message:"Network error",stack:n instanceof Error?n.stack:void 0}});return}const{body:R,size:o}=q?await this.processResponseBody(q):{body:P,size:0};const y=Math.max(0,_()-e.start);const w=p-e.start;const h={};l.headers.forEach((H,S)=>{h[S.toLowerCase()]=H});this.emit({type:"response",timestamp:new Date,duration:y,timings:y>w?{ttfb:w,download:y-w}:void 0,request:m(),response:{status:l.status,statusText:l.statusText,headers:h,body:R,size:o}})})}adoptEarlyXhr(e){const t=U(e.url);if(this.shouldIgnoreUrl(t))return;const s=B("xhr");const c=e.method.toUpperCase();const{url:a,params:r}=this.parseUrl(t);let u=e.body;if(typeof u==="string"){try{u=JSON.parse(u)}catch{}}const g=e.headers["X-Request-Client"]||e.headers["x-request-client"]||"xhr";this.emit({type:"request",timestamp:new Date(e.start),request:{id:s,url:a,method:c,headers:e.headers,data:u,params:r||void 0,client:g}});const f=e.xhr;const i=()=>{const d=(f._buoyEarlyEnd??_())-e.start;this.handleXHRResponse(f,s,a,c,e.headers,u,r,_()-d,false,g)};if(f.readyState===4)i();else f.addEventListener("loadend",i,{once:true})}addListener(e){this.listeners.push(e);return()=>{const t=this.listeners.indexOf(e);if(t>-1){this.listeners.splice(t,1)}}}removeAllListeners(){this.listeners=[]}get isActive(){return this.isListening}get listenerCount(){return this.listeners.length}}let k=null;const A=()=>{if(!k){k=new de}return k};export const networkListener=A;export const startNetworkListener=()=>A().startListening();export const stopNetworkListener=()=>k?.stopListening();export const addNetworkListener=b=>A().addListener(b);export const removeAllNetworkListeners=()=>k?.removeAllListeners();export const isNetworkListening=()=>k?.isActive??false;export const getNetworkListenerCount=()=>k?.listenerCount??0;export const isNetworkInterceptionLive=()=>k?.isInterceptionLive()??false;