browserscale-ts 1.9.0 → 1.10.0

package/dist/internal/convert.js

@@ -306,7 +306,8 @@ export function networkExchangeFromProto(e) {
         initiatorUrl: e.initiatorUrl,
         requestHeaders: e.requestHeaders.map(headerFromProto),
         requestHeadersAreWire: e.requestHeadersAreWire,
-        requestBody: e.requestBody,
+        requestBodyId: e.requestBodyId,
+        requestBodySize: Number(e.requestBodySize),
         requestBodyTruncated: e.requestBodyTruncated,
         hasResponse: e.hasResponse,
         statusCode: e.statusCode,
@@ -317,9 +318,9 @@ export function networkExchangeFromProto(e) {
         servedFrom: e.servedFrom,
         responseHeaders: e.responseHeaders.map(headerFromProto),
         responseHeadersAreWire: e.responseHeadersAreWire,
-        responseBody: e.responseBody,
+        responseBodyId: e.responseBodyId,
+        responseBodySize: Number(e.responseBodySize),
         responseBodyTruncated: e.responseBodyTruncated,
-        responseBodyCaptured: e.responseBodyCaptured,
         encodedDataLength: Number(e.encodedDataLength),
         error: e.error,
     };

package/dist/network-capture.d.ts

@@ -52,8 +52,8 @@ export declare class NetworkCapture {
     get error(): Error | null;
     /**
      * How many exchanges the server discarded because this reader fell behind.
-     * Anything above zero means the log has holes: make the handler cheaper,
-     * narrow `patterns`, or stop capturing bodies.
+     * Anything above zero means the log has holes: make the handler cheaper or
+     * narrow `patterns`.
      */
     get dropped(): number;
     /**

package/dist/network-capture.js

@@ -57,8 +57,8 @@ export class NetworkCapture {
     }
     /**
      * How many exchanges the server discarded because this reader fell behind.
-     * Anything above zero means the log has holes: make the handler cheaper,
-     * narrow `patterns`, or stop capturing bodies.
+     * Anything above zero means the log has holes: make the handler cheaper or
+     * narrow `patterns`.
      */
     get dropped() {
         return this.droppedCount;

package/dist/types.d.ts

@@ -142,10 +142,16 @@ export interface NetworkExchange {
      */
     requestHeadersAreWire: boolean;
     /**
-     * Inline body only. File and streamed uploads set requestBodyTruncated
-     * instead of appearing here.
+     * Names the request body; read it with {@link CloudBrowser.readNetworkBody}.
+     * Empty when the request had no body. Bodies never travel with the exchange.
+     */
+    requestBodyId: string;
+    /** Bytes kept for the request body. */
+    requestBodySize: number;
+    /**
+     * Part of the request body is missing: it hit the per-body cap, or it was a
+     * file or streamed upload, which are not kept.
      */
-    requestBody: Uint8Array;
     requestBodyTruncated: boolean;
     /** False when the request failed before any response arrived; see error. */
     hasResponse: boolean;
@@ -159,26 +165,49 @@ export interface NetworkExchange {
     responseHeaders: Header[];
     responseHeadersAreWire: boolean;
     /**
-     * Populated only when body capture was requested for this URL and applied;
-     * check responseBodyCaptured to tell an empty body from an uncaptured one.
-     * Binary content does not survive the browser boundary intact — see
+     * Names the response body; read it with {@link CloudBrowser.readNetworkBody}.
+     * Empty when body capture did not apply to this exchange — see
      * {@link NetworkCaptureOptions.bodies}.
      */
-    responseBody: Uint8Array;
+    responseBodyId: string;
+    /** Bytes kept for the response body, after content decoding. */
+    responseBodySize: number;
+    /**
+     * The kept body is shorter than the one the page received: it hit the
+     * per-body cap or the load ended early.
+     */
     responseBodyTruncated: boolean;
-    responseBodyCaptured: boolean;
     /** Bytes on the wire, not body size; 0 for a response served from cache. */
     encodedDataLength: number;
     /** Net error name (e.g. "net::ERR_ABORTED"), empty on success. */
     error: string;
 }
-/** How much of a response body a network capture keeps. */
+/** One range of a captured body, from {@link CloudBrowser.readNetworkBodyRange}. */
+export interface NetworkBodyRange {
+    /** The bytes read; empty past the end of the body. */
+    data: Uint8Array;
+    /** Bytes kept for the body as a whole. */
+    totalSize: number;
+    /** Matches the exchange's truncated flag for this body. */
+    truncated: boolean;
+}
+/** A whole captured body, from {@link CloudBrowser.readNetworkBody}. */
+export interface NetworkBody {
+    data: Uint8Array;
+    /** The kept body is shorter than the original; see the exchange's flag. */
+    truncated: boolean;
+}
+/**
+ * Which response bodies a network capture keeps. Kept bodies are not part of
+ * the exchange; read them with {@link CloudBrowser.readNetworkBody}.
+ */
 export type NetworkBodies = "none" | "text" | "all";
 /**
  * Configures {@link CloudBrowser.captureNetwork}.
  *
- * There is deliberately no byte-cap option: buffer sizes bound memory on a
- * machine shared with other sessions, so the server owns them.
+ * There is deliberately no byte-cap option: kept bodies are stored on a
+ * machine shared with other sessions, so the server owns the quota. When a
+ * session's bodies exceed it, the oldest are dropped first.
  */
 export interface NetworkCaptureOptions {
     /**
@@ -189,9 +218,8 @@ export interface NetworkCaptureOptions {
     patterns?: string[];
     /**
      * Response-body capture. `"text"` keeps bodies whose MIME type is textual,
-     * `"all"` keeps every body — but binary payloads (images, fonts, video) do
-     * not cross the browser boundary intact, so prefer `"text"` unless you know
-     * the bodies are textual. Defaults to `"none"`, headers and status only.
+     * `"all"` keeps every body, binary included. Defaults to `"none"`, headers
+     * and status only. Request bodies are kept whenever a request has one.
      */
     bodies?: NetworkBodies;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserscale-ts",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Official SDK for browserscale — undetected stealth browsers in the cloud. Rent real Chromium sessions with unique fingerprints, built-in proxies, captcha solving, human-like input and live video — scale web scraping and automation without running a single browser yourself.",
   "main": "dist/index.js",
   "type": "module",