@hunt-labs/bytekit-sdk 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -10,6 +10,42 @@ today, see [README.md](./README.md), which remains the authoritative usage guide
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-08-20
+
+### Removed
+
+- **BREAKING: the `cookies` and `headers` request-body fields are gone from every capture
+  endpoint** (#3242) — `/v1/scrape`, `/v1/scrape/bulk`, `/v1/screenshots`, `/v1/recordings` and
+  `/v1/schema`. A request that carries either field is rejected with `400 validation_error`; it
+  is not ignored, and there is no deprecation window, feature flag, or compatibility header.
+  `ScrapeOpts.cookies`, `ScrapeOpts.headers` and the exported `ScrapeCookie` type are removed
+  from the SDK surface, so a call that still passes them no longer compiles.
+
+  ```ts
+  // before — compiled, and the values were forwarded to the target site
+  await client.scrape.create({ url, cookies: [{ name: 'session', value: 'abc' }] });
+  // after — does not compile; the same body over raw HTTP is a 400 validation_error
+  await client.scrape.create({ url });
+  ```
+
+  ByteKit continues to manage its own cookie jar and request headers internally; what was removed
+  is the caller's ability to inject or override them.
+
+### Changed
+
+- **The generated types now declare the `503` response of `GET`/`POST /v1/fetch`** (#3372).
+  `/v1/fetch` answers `503` on two conditions and both carry the ordinary `Error` envelope, so
+  a typed consumer reading `operations['getFetch']['responses']` / `['postFetch']` can handle it
+  instead of meeting an undeclared status at runtime. Read `error.code` to tell the two apart,
+  because they disagree about `error.http_status`:
+  - `upstream_error` — the target returned HTTP `502`, relayed at `503` because Cloudflare
+    replaces a clean origin 502 with its own error page. `error.http_status` stays `502`, the
+    **true upstream status**, and is the only surviving record of what the target answered.
+  - `internal_error` (`Fetch service unavailable.`) — the fetch service was unreachable. There
+    is no upstream, so `error.http_status` reports `503`, matching what was served.
+
+  No runtime behaviour changes, and every other documented `/v1/fetch` status is unaffected.
+
 ## [0.8.0] - 2026-08-19
 
 ### Removed

package/dist/generated/api.d.ts

@@ -272,8 +272,9 @@ export interface paths {
         };
         /**
          * Fetch a URL (GET)
-         * @description Direct HTTP fetch. The response body IS the content; metadata is returned in X-Fetch-* headers.
-         *     Omit `format` for raw passthrough. Use `format=markdown` or `format=html` for conversion.
+         * @description Direct HTTP fetch. Successful responses return the upstream response bytes verbatim;
+         *     metadata is returned in X-Fetch-* headers. Non-2xx upstream responses use the
+         *     `upstream_error` JSON envelope with the upstream HTTP status.
          */
         get: operations["getFetch"];
         put?: never;
@@ -303,7 +304,7 @@ export interface paths {
         /**
          * Bulk fetch URLs
          * @description Enqueues multiple URLs for HTTP fetching. Results delivered via webhook.
-         *     Does not support options that require page rendering (cookies, wait_for_selector, etc.).
+         *     Does not support options that require page rendering (wait_for_selector, etc.).
          *
          *     **Limits:** request bodies are guarded in a two-tier shape. A streamed body
          *     with no `Content-Length` header is capped at 2 MB before your API key
@@ -588,8 +589,8 @@ export interface paths {
          * Schema-driven structured extraction
          * @description Fetches `url` and extracts structured JSON conforming to the supplied
          *     JSON Schema (draft 2020-12) using an LLM. Fast-path only — slow-path
-         *     rendering options (`wait_until=networkidle`, `cookies`, `delay_ms`,
-         *     custom `headers`, `wait_for_selector`) cause a `400 unsupported_url`.
+         *     rendering options (`wait_until=networkidle`, `delay_ms`,
+         *     `wait_for_selector`) cause a `400 unsupported_url`.
          *
          *     Dual-axis billing: a fixed per-request credit charge **plus** the
          *     underlying page's bandwidth, billed exactly like `/v1/scrape`. The
@@ -1041,7 +1042,7 @@ export interface paths {
         /**
          * Query scrape by URL (deprecated)
          * @deprecated
-         * @description Use GET /v1/fetch?url=...&format=markdown instead.
+         * @description Use GET /v1/fetch?url=... instead.
          */
         get: operations["queryScrapeLegacy"];
         put?: never;
@@ -1404,14 +1405,6 @@ export interface components {
                 details?: unknown;
             };
         };
-        Cookie: {
-            name: string;
-            value: string;
-            domain?: string;
-            path?: string;
-            secure?: boolean;
-            httpOnly?: boolean;
-        };
         Viewport: {
             width: number;
             height: number;
@@ -1534,12 +1527,6 @@ export interface components {
             formats: ("raw_html" | "html" | "markdown" | "links" | "images")[];
             /** @default US */
             country: string;
-            /** @default [] */
-            cookies: components["schemas"]["Cookie"][];
-            /** @default {} */
-            headers: {
-                [key: string]: string;
-            };
             /** @default 0 */
             delay_ms: number;
             /** @default 30000 */
@@ -1914,8 +1901,6 @@ export interface components {
         FetchRequest: {
             /** Format: uri */
             url: string;
-            /** @enum {string} */
-            format?: "markdown" | "html";
             /** @default US */
             country: string;
             /** @default 60000 */
@@ -1932,37 +1917,6 @@ export interface components {
             custom: {
                 [key: string]: unknown;
             };
-            /**
-             * @description Markdown processing mode. Only used when format=markdown.
-             * @enum {string}
-             */
-            markdown_mode?: "article" | "raw" | "llm";
-            /** @description BM25 query string for relevance-ranked filtering. Only used when format=markdown. */
-            markdown_query?: string;
-            /**
-             * @description Link rendering style. Only used when format=markdown.
-             * @enum {string}
-             */
-            markdown_links?: "inline" | "references" | "none" | "text";
-            /**
-             * @description Image retention mode. Only used when format=markdown.
-             * @enum {string}
-             */
-            markdown_images?: "inline" | "references" | "none" | "text";
-            /** @description Append a Links footer to the markdown output. Only used when format=markdown. */
-            with_links_summary?: boolean;
-            /** @description Append an Images footer to the markdown output. Only used when format=markdown. */
-            with_images_summary?: boolean;
-            /** @description Compact whitespace output. Only used when format=markdown. */
-            markdown_compact?: boolean;
-            /** @description Filter low-signal images. Only used when format=markdown. */
-            markdown_filter_images?: boolean;
-            /** @description When true, `formats.links` and `formats.images` return `ScrapeScoredLink[]` / `ScrapeScoredImage[]` (rich objects) instead of `string[]`, and a top-level `tables` array is included. Only used when format=markdown. */
-            markdown_include_media?: boolean;
-            /** @description When true, enables markdown-pipeline and tag-filter warnings for affected html and markdown requests. Artifact availability warnings such as `artifact_unavailable` may appear independently of this flag. */
-            markdown_include_warnings?: boolean;
-            /** @description When true, includes a top-level `stats` object with `ScrapeStats` (chars, tokens, blocks). Only used when format=markdown. */
-            markdown_include_stats?: boolean;
         };
         ScreenshotRequest: {
             /** Format: uri */
@@ -2000,12 +1954,6 @@ export interface components {
             scroll: boolean;
             /** @default null */
             clip: components["schemas"]["Clip"] | null;
-            /** @default {} */
-            headers: {
-                [key: string]: string;
-            };
-            /** @default [] */
-            cookies: components["schemas"]["Cookie"][];
             /** @default false */
             dark_mode: boolean;
             /**
@@ -2125,12 +2073,6 @@ export interface components {
             /** @default 0 */
             delay_ms: number;
             scroll?: components["schemas"]["ScrollOptions"];
-            /** @default {} */
-            headers: {
-                [key: string]: string;
-            };
-            /** @default [] */
-            cookies: components["schemas"]["Cookie"][];
             /** @default false */
             dark_mode: boolean;
             /** @default US */
@@ -2699,7 +2641,6 @@ export interface components {
          */
         ClientSurfaceMarker: string;
         FetchUrl: string;
-        FetchFormat: "markdown" | "html";
         FetchCountry: string;
         FetchTimeoutMs: number;
         /** @description How long a freshly fetched URL may be served from cache. `0` skips the cache read; cache-eligible fresh results are still written with the default 7-day TTL so later non-zero-TTL callers can HIT. Safety-classified WAF husks remain live-only and are not written. Accepts `Nh` (hours, up to 168h), `Nd` (days, up to 7d), or the integer `0`. Examples: `0`, `48h`, `2d`. Invalid values receive a 422 validation_error with an actionable message. */
@@ -2739,11 +2680,9 @@ export interface components {
         XFetchURL: string;
         /**
          * @description Byte length of the response body served on this request (integer as string) — NOT the
-         *     billing basis. On a passthrough request (no `format`) the body is the relayed upstream
-         *     payload, so this equals the upstream wire byte count. With `format=html` or
-         *     `format=markdown` the body is the transformed document, so this is the transformed byte
-         *     count and is typically far smaller than what is billed. Billing always reads the upstream
-         *     compressed wire bytes from `X-Raw-Bytes` / `X-Billable-Bytes`, on every path.
+         *     billing basis. The body is always the upstream response bytes, so this equals the upstream wire byte
+         *     count. Billing always reads the upstream compressed wire bytes from `X-Raw-Bytes` /
+         *     `X-Billable-Bytes`, on every path.
          */
         XFetchContentLength: string;
         XFetchCreditsCharged: string;
@@ -3625,10 +3564,6 @@ export interface operations {
                         url: string;
                         formats?: ("raw_html" | "html" | "markdown" | "links" | "images")[];
                         country?: string;
-                        cookies?: components["schemas"]["Cookie"][];
-                        headers?: {
-                            [key: string]: string;
-                        };
                         delay_ms?: number;
                         timeout_ms?: number;
                         metadata?: components["schemas"]["Metadata"];
@@ -3663,10 +3598,6 @@ export interface operations {
                         formats?: ("raw_html" | "html" | "markdown" | "links" | "images")[];
                         /** @default US */
                         country?: string;
-                        cookies?: components["schemas"]["Cookie"][];
-                        headers?: {
-                            [key: string]: string;
-                        };
                         /** @default 0 */
                         delay_ms?: number;
                         /** @default 30000 */
@@ -3726,7 +3657,7 @@ export interface operations {
                         completed_at: string | null;
                         /** @description Always null on the create response — the job has not been billed yet (routes/scrape-bulk.ts builds the 202 body from a partial job row). Fractional when populated (credits are NUMERIC(10,2)); the numeric branch is unreachable on this path and exists only so the 202 and 200 bodies share one shape. */
                         total_credits_charged: number | null;
-                        /** @description Estimated credits at submission time. Null in GET responses. Fractional — markdown/html formats weigh 0.5 credits each (scrape-shared/src/credits.ts), so a one-item markdown job is 1.5. */
+                        /** @description Estimated credits at submission time. Null in GET responses. Fetch-bulk items use the raw fetch bandwidth billing factor. */
                         estimated_credits: number | null;
                         /** @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported) */
                         webhook_url: string;
@@ -3826,7 +3757,6 @@ export interface operations {
         parameters: {
             query: {
                 url: components["parameters"]["FetchUrl"];
-                format?: components["parameters"]["FetchFormat"];
                 country?: components["parameters"]["FetchCountry"];
                 timeout_ms?: components["parameters"]["FetchTimeoutMs"];
                 /** @description How long a freshly fetched URL may be served from cache. `0` skips the cache read; cache-eligible fresh results are still written with the default 7-day TTL so later non-zero-TTL callers can HIT. Safety-classified WAF husks remain live-only and are not written. Accepts `Nh` (hours, up to 168h), `Nd` (days, up to 7d), or the integer `0`. Examples: `0`, `48h`, `2d`. Invalid values receive a 422 validation_error with an actionable message. */
@@ -3860,16 +3790,14 @@ export interface operations {
                     "X-Raw-Bytes"?: number;
                     /** @description Chargeable bytes after applying the billing multiplier. Equals round(X-Raw-Bytes × X-Billing-Multiplier). */
                     "X-Billable-Bytes"?: number;
-                    /** @description Bandwidth cost multiplier applied to X-Raw-Bytes. A markdown fetch bills as fetch_md (miss 1.5, hit 0.75); a raw fetch bills 1.0 on a miss, 0.5 on a cache hit. Single `/v1/fetch` returns the fetched bytes as the body, so it carries no `billing` node — this header trio is the ONLY billing surface here. Items under `GET /v1/fetch/bulk/{id}` do carry the node. */
+                    /** @description Bandwidth cost multiplier applied to X-Raw-Bytes. Single `/v1/fetch` returns the fetched bytes as the body, so it carries no `billing` node — this header trio is the ONLY billing surface here. Items under `GET /v1/fetch/bulk/{id}` do carry the node. */
                     "X-Billing-Multiplier"?: number;
                     /** @description Back-compat duplicate of `X-Billing-Multiplier` — identical value on every path. Prefer `X-Billing-Multiplier`; this alias is retained for clients that read the `X-Fetch-*` header family. */
                     "X-Fetch-Billing-Multiplier"?: number;
                     [name: string]: unknown;
                 };
                 content: {
-                    "*/*": string;
-                    "text/markdown": string;
-                    "text/html": string;
+                    "text/plain": string;
                 };
             };
             /** @description Invalid URL (`invalid_url`) or oversized request. */
@@ -3881,7 +3809,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Validation error (e.g. unsupported `format`, slow-path-only field, or `format=html` against a non-HTML content type). */
+            /** @description Validation error (e.g. slow-path-only field). */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -3900,10 +3828,14 @@ export interface operations {
                 };
             };
             /**
-             * @description Fetch service unavailable, content transform failed, or a non-2xx upstream
-             *     response relayed as the unified Error envelope. On an upstream relay the HTTP
-             *     status equals the upstream status (code `upstream_error`), so any 4xx/5xx the
-             *     target returns surfaces here as an Error envelope rather than a raw body (#1462).
+             * @description Content transform failed, or a non-2xx upstream response relayed as the unified
+             *     Error envelope. On an upstream relay the HTTP status equals the upstream status
+             *     (code `upstream_error`), so any 4xx/5xx the target returns surfaces here as an
+             *     Error envelope rather than a raw body (#1462).
+             *
+             *     **One divergence.** An upstream `502` is relayed at HTTP `503`, not `502` — see
+             *     the `503` response below. A fetch service that cannot be reached also answers
+             *     `503`, not `502` (#3373); this status no longer covers that condition.
              */
             502: {
                 headers: {
@@ -3913,6 +3845,30 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /**
+             * @description Two distinct conditions answer `503`, and they disagree about what the body's
+             *     `error.http_status` reports. Read `error.code` to tell them apart.
+             *
+             *     - **`upstream_error`** — the target returned HTTP `502`, relayed here as `503`.
+             *       Cloudflare fronts this API and replaces a clean origin 502 with its own generic
+             *       `text/plain` error page, discarding the envelope before it reaches you, while a
+             *       503 is passed through unchanged. The body's `error.http_status` still reports
+             *       the **true upstream status**, `502` — not `503` — and is the only surviving
+             *       record of what the target answered, so the body rather than the HTTP status is
+             *       authoritative here (#3355).
+             *     - **`internal_error`** (message `Fetch service unavailable.`) — the fetch service
+             *       could not be reached at all. There is no upstream status to preserve: the `503`
+             *       is this API's own choice of wire status, so the body's `error.http_status`
+             *       reports `503`, mirroring what was served (#3373).
+             */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     postFetch: {
@@ -3926,10 +3882,7 @@ export interface operations {
             content: {
                 /**
                  * @example {
-                 *       "url": "https://example.com",
-                 *       "format": "markdown",
-                 *       "markdown_mode": "article",
-                 *       "markdown_links": "inline"
+                 *       "url": "https://example.com"
                  *     }
                  */
                 "application/json": components["schemas"]["FetchRequest"];
@@ -3958,16 +3911,14 @@ export interface operations {
                     "X-Raw-Bytes"?: number;
                     /** @description Chargeable bytes after applying the billing multiplier. Equals round(X-Raw-Bytes × X-Billing-Multiplier). */
                     "X-Billable-Bytes"?: number;
-                    /** @description Bandwidth cost multiplier applied to X-Raw-Bytes. A markdown fetch bills as fetch_md (miss 1.5, hit 0.75); a raw fetch bills 1.0 on a miss, 0.5 on a cache hit. Single `/v1/fetch` returns the fetched bytes as the body, so it carries no `billing` node — this header trio is the ONLY billing surface here. Items under `GET /v1/fetch/bulk/{id}` do carry the node. */
+                    /** @description Bandwidth cost multiplier applied to X-Raw-Bytes. Single `/v1/fetch` returns the fetched bytes as the body, so it carries no `billing` node — this header trio is the ONLY billing surface here. Items under `GET /v1/fetch/bulk/{id}` do carry the node. */
                     "X-Billing-Multiplier"?: number;
                     /** @description Back-compat duplicate of `X-Billing-Multiplier` — identical value on every path. Prefer `X-Billing-Multiplier`; this alias is retained for clients that read the `X-Fetch-*` header family. */
                     "X-Fetch-Billing-Multiplier"?: number;
                     [name: string]: unknown;
                 };
                 content: {
-                    "*/*": string;
-                    "text/markdown": string;
-                    "text/html": string;
+                    "text/plain": string;
                 };
             };
             /** @description Invalid URL (`invalid_url`) or oversized request body. */
@@ -3979,7 +3930,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Validation error (e.g. malformed JSON, unsupported `format`, slow-path-only field, or `format=html` against a non-HTML content type). */
+            /** @description Validation error (e.g. malformed JSON, unsupported fetch format, or slow-path-only field). */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -3998,10 +3949,14 @@ export interface operations {
                 };
             };
             /**
-             * @description Fetch service unavailable, content transform failed, or a non-2xx upstream
-             *     response relayed as the unified Error envelope. On an upstream relay the HTTP
-             *     status equals the upstream status (code `upstream_error`), so any 4xx/5xx the
-             *     target returns surfaces here as an Error envelope rather than a raw body (#1462).
+             * @description Content transform failed, or a non-2xx upstream response relayed as the unified
+             *     Error envelope. On an upstream relay the HTTP status equals the upstream status
+             *     (code `upstream_error`), so any 4xx/5xx the target returns surfaces here as an
+             *     Error envelope rather than a raw body (#1462).
+             *
+             *     **One divergence.** An upstream `502` is relayed at HTTP `503`, not `502` — see
+             *     the `503` response below. A fetch service that cannot be reached also answers
+             *     `503`, not `502` (#3373); this status no longer covers that condition.
              */
             502: {
                 headers: {
@@ -4011,6 +3966,30 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /**
+             * @description Two distinct conditions answer `503`, and they disagree about what the body's
+             *     `error.http_status` reports. Read `error.code` to tell them apart.
+             *
+             *     - **`upstream_error`** — the target returned HTTP `502`, relayed here as `503`.
+             *       Cloudflare fronts this API and replaces a clean origin 502 with its own generic
+             *       `text/plain` error page, discarding the envelope before it reaches you, while a
+             *       503 is passed through unchanged. The body's `error.http_status` still reports
+             *       the **true upstream status**, `502` — not `503` — and is the only surviving
+             *       record of what the target answered, so the body rather than the HTTP status is
+             *       authoritative here (#3355).
+             *     - **`internal_error`** (message `Fetch service unavailable.`) — the fetch service
+             *       could not be reached at all. There is no upstream status to preserve: the `503`
+             *       is this API's own choice of wire status, so the body's `error.http_status`
+             *       reports `503`, mirroring what was served (#3373).
+             */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
         };
     };
     createFetchBulk: {
@@ -4026,14 +4005,10 @@ export interface operations {
                     urls: (string | {
                         /** Format: uri */
                         url: string;
-                        /** @enum {string} */
-                        format?: "markdown" | "html";
                         country?: string;
                         cache_ttl?: string;
                     })[];
                     defaults?: {
-                        /** @enum {string} */
-                        format?: "markdown" | "html";
                         /** @default US */
                         country?: string;
                         /** @default 48h */
@@ -4070,7 +4045,7 @@ export interface operations {
                         completed_at: string | null;
                         /** @description Always null on the create response — the job has not been billed yet (routes/fetch-bulk.ts builds the 202 body from a partial job row). Fractional when populated (credits are NUMERIC(10,2)); the numeric branch is unreachable on this path and exists only so the 202 and 200 bodies share one shape. */
                         total_credits_charged: number | null;
-                        /** @description Estimated credits at submission time. Null in GET responses. Fractional — markdown/html formats weigh 0.5 credits each (scrape-shared/src/credits.ts), so a one-item markdown job is 1.5. */
+                        /** @description Estimated credits at submission time. Null in GET responses. Fetch items are raw passthrough requests and use the raw fetch bandwidth billing factor. */
                         estimated_credits: number | null;
                         /** @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported) */
                         webhook_url: string;
@@ -4427,7 +4402,7 @@ export interface operations {
                         completed_at: string | null;
                         /** @description Always null on the create response — the job has not been billed yet (routes/bulk.ts builds the 202 body from a partial job row). Fractional when populated (credits are NUMERIC(10,2)); the numeric branch is unreachable on this path and exists only so the 202 and 200 bodies share one shape. */
                         total_credits_charged: number | null;
-                        /** @description Estimated credits at submission time. Null in GET responses. Fractional — markdown/html formats weigh 0.5 credits each (scrape-shared/src/credits.ts), so a one-item markdown job is 1.5. */
+                        /** @description Estimated credits at submission time. Null in GET responses. Fetch-bulk items use the raw fetch bandwidth billing factor. */
                         estimated_credits: number | null;
                         /** @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported) */
                         webhook_url: string;
@@ -5248,18 +5223,8 @@ export interface operations {
                      * @enum {string}
                      */
                     wait_until?: "load" | "domcontentloaded" | "networkidle";
-                    /** @default [] */
-                    cookies?: {
-                        name: string;
-                        value: string;
-                        domain: string;
-                    }[];
                     /** @default 0 */
                     delay_ms?: number;
-                    /** @default {} */
-                    headers?: {
-                        [key: string]: string;
-                    };
                     /**
                      * @description Two-letter country code, upper-cased. `null` is coerced to `US`.
                      * @default US
@@ -5624,9 +5589,9 @@ export interface operations {
                             status_code?: number | null;
                             /** @description Raw upstream bytes the request carried (the billing base before the multiplier). null while pending/failed. */
                             raw_bytes?: number | null;
-                            /** @description Billable bytes — raw_bytes × billing_multiplier, rounded. Mirrors the X-Billable-Bytes response header. null while pending/failed. */
+                            /** @description The bytes this request was BILLED — the same amount its own response reported in `X-Billable-Bytes`. For a scrape or fetch request this is the settled decomposition replayed as it was recorded at completion, so it already carries every factor that applied: the endpoint factor (`scrape` 1.0, `scrape_md` 1.5, `fetch` 1.0, `fetch_md` 1.5, a monitor run 1.0), the cache-hit ×0.5, and the clean-markdown ×3. Screenshots and recordings are `raw_bytes` × the fixed 1.5 Phase-1 render factor whatever capture options they carried — capture billing composes no discount factor, so that product is exact. It is NOT `raw_bytes` × `billing_multiplier`: that field reports a CREDIT count, a different quantity from the byte factors above, and on a recordings row their product is not bytes at all. One residual: a scrape or fetch row completed before the decomposition was recorded is reconstructed from its endpoint and cache-hit factors, which leaves a markdown `/v1/fetch` request of that vintage reported at 1.0 rather than 1.5 — nothing on such a row distinguishes it. That population ages out of this feed's retention window and is not backfilled. null while pending/failed (the row has no byte basis yet). */
                             billable_bytes?: number | null;
-                            /** @description BASE billing multiplier persisted for this request — the settled `credits_charged` factor, and the same factor `billable_bytes` above is derived from. Its scale is not uniform and is not a rate you can carry from one row to another: each endpoint persists its own credit unit, and the single and bulk paths of the same endpoint may persist different factors for identical options. Read this as the factor this one row settled at, and see that endpoint's own pricing for what it charges. This is a LOGS ROW field and is NOT the scrape response envelope field — the envelope carries no flat `billing_multiplier` at all; its billing surface is the `billing` node (see BillingNode). This row reports only the base settled factor, so it can differ from `billing.multiplier` and from the X-Billing-Multiplier response header, both of which report the composed real-endpoint value. null while pending/failed. */
+                            /** @description BASE billing multiplier persisted for this request — the settled `credits_charged` factor. It is NOT what `billable_bytes` above is derived from: that field reports settled BYTES, and multiplying `raw_bytes` by this credit count does not give the amount billed. Its scale is not uniform and is not a rate you can carry from one row to another: each endpoint persists its own credit unit, and the single and bulk paths of the same endpoint may persist different factors for identical options. Read this as the factor this one row settled at, and see https://bytekit.com/docs/billing/credits for what each endpoint charges. This is a LOGS ROW field and is NOT the scrape response envelope field — the envelope carries no flat `billing_multiplier` at all; its billing surface is the `billing` node (see BillingNode). This row reports only the base settled factor, so it can differ from `billing.multiplier` and from the X-Billing-Multiplier response header, both of which report the composed real-endpoint value. null while pending/failed. */
                             billing_multiplier?: number | null;
                             duration_ms?: number | null;
                             /** @description How the request originated (single/bulk/monitor). */

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export type { ByteKitOptions, RequestOptions, ApiResponse, ConnectionErrorCode,
 export { V01_METHODS } from './allowlist.js';
 export type { V01Method } from './allowlist.js';
 export type { ScrapeId, ScreenshotId, BulkId, MonitorId, SitemapId, ApiKeyId, WebhookDeliveryId, SearchType, SearchDateRange, SearchOpts, SearchResult, SearchResultImage, SearchResponse, } from './types.js';
-export type { ScrapeCookie, ScrapeOpts, MarkdownMode, MarkdownLinks, MarkdownImages, TokenEncoding, ScrapeCreateResponse, ScrapeGetResponse, ScrapeBulkCreateRequest, ScrapeBulkCreateResponse, ScrapeBulkGetResponse, } from './resources/scrape.js';
+export type { ScrapeOpts, MarkdownMode, MarkdownLinks, MarkdownImages, TokenEncoding, ScrapeCreateResponse, ScrapeGetResponse, ScrapeBulkCreateRequest, ScrapeBulkCreateResponse, ScrapeBulkGetResponse, } from './resources/scrape.js';
 export type { ScreenshotCreateRequest, ScreenshotCreateResponse, ScreenshotGetResponse, } from './resources/screenshots.js';
 export type { FetchOpts, FetchGetOpts, FetchResult, FetchCacheStatus, FetchBulkCreateRequest, FetchBulkCreateResponse, FetchBulkGetResponse, } from './resources/fetch.js';
 export type { MonitorCreateRequest, MonitorCreateResponse, ListMonitorsParams, MonitorStatus, ListMonitorsResponse, MonitorResponse, MonitorUpdateRequest, UpdateMonitorResponse, ListMonitorCapturesResponse, } from './resources/monitors.js';

package/dist/resources/fetch.d.ts

@@ -15,32 +15,8 @@ export type FetchBulkGetResponse = operations['getFetchBulk']['responses'][200][
  */
 export interface FetchOpts {
     url: string;
-    /** Output format. `'markdown'` runs the HTML→markdown pipeline; `'html'` returns raw HTML. Narrowed to the spec union — off-spec values (e.g. `'pdf'`) are rejected at compile time. */
-    format?: 'markdown' | 'html';
     country?: string;
     timeout_ms?: number;
-    /** Markdown processing mode. Only used when `format=markdown`. article/raw/llm. */
-    markdown_mode?: 'article' | 'raw' | 'llm';
-    /** BM25 query string for relevance-ranked filtering. Only used when `format=markdown`. */
-    markdown_query?: string;
-    /** Link rendering style. Only used when `format=markdown`. */
-    markdown_links?: 'inline' | 'references' | 'none' | 'text';
-    /** Image retention mode. Only used when `format=markdown`. */
-    markdown_images?: 'inline' | 'references' | 'none' | 'text';
-    /** Append a `Links:` footer to the markdown output. Only used when `format=markdown`. */
-    with_links_summary?: boolean;
-    /** Append an `Images:` footer to the markdown output. Only used when `format=markdown`. */
-    with_images_summary?: boolean;
-    /** Compact whitespace output. Only used when `format=markdown`. */
-    markdown_compact?: boolean;
-    /** Filter low-signal images. Only used when `format=markdown`. */
-    markdown_filter_images?: boolean;
-    /** When true, `formats.links`/`formats.images` return rich objects and a top-level `tables` array is included. Only used when `format=markdown`. */
-    markdown_include_media?: boolean;
-    /** When true, enables markdown-pipeline and tag-filter warnings for affected html/markdown requests. */
-    markdown_include_warnings?: boolean;
-    /** When true, includes a top-level `stats` object (chars, tokens, blocks). Only used when `format=markdown`. */
-    markdown_include_stats?: boolean;
     /**
      * How long a freshly fetched URL may be served from cache. Matches the
      * OpenAPI `FetchRequest.cache_ttl` schema: a duration string (`"48h"`,
@@ -66,17 +42,15 @@ export interface FetchOpts {
  * the generated `getFetch` query type by `_AssertFetchGetQueryKeysCoverSpec`
  * below, so it cannot drift away from the spec silently.
  */
-declare const FETCH_GET_QUERY_KEYS: readonly ["url", "format", "country", "timeout_ms", "cache_ttl"];
+declare const FETCH_GET_QUERY_KEYS: readonly ["url", "country", "timeout_ms", "cache_ttl"];
 type FetchGetQueryKey = (typeof FETCH_GET_QUERY_KEYS)[number];
 /**
  * Options accepted by `fetch.get` (GET /v1/fetch).
  *
- * A strict subset of {@link FetchOpts}: only the five params the spec's
+ * A strict subset of {@link FetchOpts}: only the four params the spec's
  * `GET /v1/fetch` actually declares. Everything else on the POST body —
- * `custom` (#2481) and the eleven `markdown_*` / `with_*` tuning fields (#2539) —
- * has no GET query param and was silently dropped by the query builder, so it is
- * excluded here and passing it is a compile error. Use `create()` (POST) for
- * those.
+ * `custom` has no GET query param and is excluded here; passing it is a compile
+ * error. Use `create()` (POST) for custom metadata.
  */
 export type FetchGetOpts = Pick<FetchOpts, FetchGetQueryKey>;
 /** Cache-lookup outcome reported in the `X-Fetch-Cache` response header. */
@@ -84,8 +58,8 @@ export type FetchCacheStatus = 'hit' | 'miss' | 'bypass';
 /**
  * The result of `fetch.create` / `fetch.get`.
  *
- * `/v1/fetch` returns the fetched content AS the response body (text/html,
- * text/markdown, or raw binary passthrough) with metadata carried in `X-Fetch-*`
+ * `/v1/fetch` returns the fetched content AS the response body, including its
+ * original media type and raw bytes, with metadata carried in `X-Fetch-*`
  * headers on the response — it is NOT a JSON envelope. `body` is therefore the raw
  * content string, never a parsed object, and the named fields decode the
  * headers the docs call out. Anything not surfaced here is available on
@@ -144,10 +118,8 @@ export declare class FetchResource {
      *
      * Resolves a `FetchResult` — the raw content body plus `X-Fetch-*` metadata.
      *
-     * Accepts only the five params the spec declares for this endpoint. `custom`
-     * (#2481) and the `markdown_*` / `with_*` tuning fields (#2539) are POST-body
-     * options with no GET query param — they were silently dropped by this builder,
-     * so they are now compile errors instead. Use `create()` (POST) for those.
+     * Accepts only the four params the spec declares for this endpoint. `custom`
+     * is a POST-body option with no GET query param; use `create()` for custom metadata.
      *
      * The query string is built by iterating `FETCH_GET_QUERY_KEYS`, the same list
      * `FetchGetOpts` is derived from, so every accepted option is necessarily

package/dist/resources/fetch.js

@@ -9,7 +9,7 @@ import { buildPath } from '../client.js';
  * the generated `getFetch` query type by `_AssertFetchGetQueryKeysCoverSpec`
  * below, so it cannot drift away from the spec silently.
  */
-const FETCH_GET_QUERY_KEYS = ['url', 'format', 'country', 'timeout_ms', 'cache_ttl'];
+const FETCH_GET_QUERY_KEYS = ['url', 'country', 'timeout_ms', 'cache_ttl'];
 const CACHE_STATUSES = ['hit', 'miss', 'bypass'];
 /** Build a typed {@link FetchResult} from a raw body + its header set. */
 function toFetchResult(raw) {
@@ -60,10 +60,8 @@ export class FetchResource {
      *
      * Resolves a `FetchResult` — the raw content body plus `X-Fetch-*` metadata.
      *
-     * Accepts only the five params the spec declares for this endpoint. `custom`
-     * (#2481) and the `markdown_*` / `with_*` tuning fields (#2539) are POST-body
-     * options with no GET query param — they were silently dropped by this builder,
-     * so they are now compile errors instead. Use `create()` (POST) for those.
+     * Accepts only the four params the spec declares for this endpoint. `custom`
+     * is a POST-body option with no GET query param; use `create()` for custom metadata.
      *
      * The query string is built by iterating `FETCH_GET_QUERY_KEYS`, the same list
      * `FetchGetOpts` is derived from, so every accepted option is necessarily

package/dist/resources/scrape.d.ts

@@ -1,5 +1,5 @@
 import type { ByteKit, RequestOptions } from '../client.js';
-import type { components, operations } from '../generated/api.js';
+import type { operations } from '../generated/api.js';
 import type { ScrapeId, BulkId } from '../types.js';
 /**
  * Response of POST /v1/scrape — a 200 sync success envelope or a 202 queued
@@ -26,23 +26,11 @@ export type MarkdownLinks = 'inline' | 'references' | 'none' | 'text';
 export type MarkdownImages = 'inline' | 'references' | 'none' | 'text';
 /** Tokenizer encoding hint for `token_budget`. */
 export type TokenEncoding = 'cl100k_base' | 'o200k_base';
-/**
- * A cookie to set before loading the page — the spec's `Cookie` schema verbatim
- * (`name` and `value` required; `domain`, `path`, `secure`, `httpOnly` optional).
- *
- * DERIVED from the generated schema (#2547), never hand-authored: `cookies` was
- * previously an open bag of untyped records, so a nameless cookie compiled and only
- * failed as a 422 on the wire.
- */
-export type ScrapeCookie = components['schemas']['Cookie'];
 /** Options for POST /v1/scrape. */
 export interface ScrapeOpts {
     url: string;
     formats?: Array<'raw_html' | 'html' | 'markdown' | 'links' | 'images'>;
     country?: string;
-    /** Cookies to set before loading the page. `name` and `value` are required (spec `Cookie` schema). */
-    cookies?: ScrapeCookie[];
-    headers?: Record<string, string>;
     delay_ms?: number;
     /** SERVER-side scrape budget in ms — how long the gateway may spend on the scrape itself. For the CLIENT-side abort budget (when this SDK gives up on the wire), see `RequestOptions.requestTimeoutMs`. */
     timeout_ms?: number;

package/dist/version.d.ts

@@ -5,4 +5,4 @@
  * outbound request carries — see the emit site in `client.ts`. The header name is spelled
  * only there, so issue #2905's pre-merge gate 1 counts exactly one occurrence in `src/`.
  */
-export declare const SDK_VERSION = "0.8.0";
+export declare const SDK_VERSION = "0.9.0";

package/dist/version.js

@@ -9,4 +9,4 @@
  * outbound request carries — see the emit site in `client.ts`. The header name is spelled
  * only there, so issue #2905's pre-merge gate 1 counts exactly one occurrence in `src/`.
  */
-export const SDK_VERSION = '0.8.0';
+export const SDK_VERSION = '0.9.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunt-labs/bytekit-sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Official TypeScript SDK for the ByteKit API",
   "license": "MIT",
   "type": "module",