@webcrawl/curl-impersonate 1.3.0 → 1.3.2

package/dist/fetch.d.ts

@@ -12,6 +12,8 @@ export interface ImpersonateFetchResult {
     contentType: string;
     /** Decompressed body bytes (the binary handles gzip/br/zstd itself). */
     body: Uint8Array;
+    /** Decompressed body size in bytes (body.length) — for bandwidth accounting. */
+    bytes: number;
 }
 export declare class ResourceTooLargeError extends Error {
     readonly bytes: number;
@@ -33,6 +35,12 @@ export interface ImpersonateFetchOptions {
     timeoutMs?: number;
     /** Declared-length guard before the body is accepted. */
     maxBytes?: number;
+    /**
+     * HTTP(S) proxy URL (credentials embedded, `http://user:pass@host:port`).
+     * Routes the hop through e.g. a residential proxy so the target sees a
+     * clean egress IP while the TLS fingerprint stays a real Chrome's.
+     */
+    proxy?: string;
 }
 /** Resolved binary path or null when the tier is unavailable. Memoized. */
 export declare function resolveBinary(): Promise<string | null>;

package/dist/fetch.js

@@ -89,7 +89,7 @@ export async function impersonateFetch(url, options = {}) {
     if (!bin) {
         throw new ImpersonateUnavailableError("curl-impersonate binary unavailable");
     }
-    const { profile = DEFAULT_IMPERSONATE_PROFILE, headers = {}, timeoutMs = 12_000, maxBytes, } = options;
+    const { profile = DEFAULT_IMPERSONATE_PROFILE, headers = {}, timeoutMs = 12_000, maxBytes, proxy, } = options;
     const navHeaders = profileHeaders(profile, headers);
     const headerArgs = Object.entries(navHeaders).flatMap(([k, v]) => ["-H", `${k}: ${v}`]);
     const dir = mkdtempSync(join(tmpdir(), "webcrawl-imp-"));
@@ -107,6 +107,7 @@ export async function impersonateFetch(url, options = {}) {
                 "-w", "%{http_code}",
                 url,
                 ...headerArgs,
+                ...(proxy ? ["-x", proxy] : []),
             ], { stdio: ["ignore", "pipe", "pipe"] });
             let stdout = "";
             let stderr = "";
@@ -158,6 +159,7 @@ export async function impersonateFetch(url, options = {}) {
                 .trim()
                 .toLowerCase(),
             body,
+            bytes: body.byteLength,
         };
     }
     finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webcrawl/curl-impersonate",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Zero-dependency curl-impersonate fetch for Node.js — pinned lexiforest binary, Chrome TLS/HTTP2 fingerprint impersonation (chrome150 default), automatic per-platform download with sha256 verification",
   "type": "module",
   "license": "MIT",