From a62019cd550cebc0f8a5f43ce942385f8dc7b33f Mon Sep 17 00:00:00 2001
From: germondai <germondai@gmail.com>
Date: Fri, 24 Jul 2026 09:17:42 +0200
Subject: [PATCH] refactor(types): add raw response metadata

---
 packages/types/src/index.ts | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/packages/types/src/index.ts b/packages/types/src/index.ts
index 7f51821..44cade1 100644
--- a/packages/types/src/index.ts
+++ b/packages/types/src/index.ts
@@ -48,6 +48,16 @@ export interface ScrapeResult {
   totalMs: number
   captchasSolved?: string[] // captcha types solved during this request (e.g. ['turnstile', 'recaptcha-v2'])
   proxyUsed?: boolean // true if the winning tier routed through a proxy (Tier 3 datacenter pool or Tier 4 residential pool/override)
+  // Raw response payload — populated by all tiers when available. The MITM proxy
+  // (:8192) consumes this; /scrape and FlareSolverr /v1 still rely on `html` only.
+  // Binary content (images, .torrent, videos) MUST use this field — `html` would
+  // corrupt non-UTF8 bytes via normalizeHtml().
+  body?: Uint8Array
+  // Upstream response headers (lowercased keys), preserved verbatim so the proxy
+  // can forward Set-Cookie, Content-Disposition, Content-Range, cache validators, etc.
+  responseHeaders?: Record<string, string>
+  // Convenience: extracted Content-Type header. Same as responseHeaders['content-type'].
+  contentType?: string
 }
 
 export interface SessionData {