@hunt-labs/bytekit-sdk 0.8.0 → 0.9.1

package/CHANGELOG.md

@@ -10,6 +10,68 @@ today, see [README.md](./README.md), which remains the authoritative usage guide
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-08-25
+
+### Fixed
+
+- The generated `paths` type for the `200` of `GET /v1/scrape/bulk/{id}` now declares `items`
+  (#3632). The route builds one body and varies only the status code, so the terminal `200`
+  has always carried the per-URL scrape envelopes — but only the `202` documented them, so
+  `scrape.bulk.get()` typed the results away at exactly the poll that has them. Types only:
+  the field was already on the wire, and server behavior is unchanged.
+
+- The generated `paths` types now describe the `202` that `GET /v1/scrape/bulk/{id}`,
+  `GET /v1/fetch/bulk/{id}` and `GET /v1/bulk/{id}` already serve while a bulk job is
+  non-terminal (#3533). Each of the three returns 202 with the job envelope until the job is
+  terminal and 200 afterwards, but only the 200 was declared, so anything typed off the spec
+  had no shape for the response the very first poll receives. Types only: `scrape.bulk.get()`,
+  `fetch.bulk.get()` and `bulk.get()` already resolved the body on any 2xx, and server behavior
+  is unchanged.
+
+### Changed
+
+- The generated `topup_balance_bytes` description on `GET /v1/usage` now states that the value is
+  the remaining purchased top-up bytes, already net of any overage consumed against them (#3459).
+  Types only: the field's name, type and wire format are unchanged. The server previously
+  subtracted the consumed overage a second time when computing this value, so the number a client
+  reads is larger than before for accounts that ran past their included allowance.
+
+## [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 */
@@ -2205,6 +2147,7 @@ export interface components {
              * @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported)
              */
             webhook_url: string;
+            /** @description HMAC secret used to sign webhook deliveries. Each delivery carries `X-Webhook-Timestamp` and `X-Webhook-Signature` (`sha256=` + the hex HMAC-SHA256 of `timestamp.body`). See https://bytekit.com/docs/guides/webhooks for verification code. */
             webhook_secret?: string;
             /** @description Max 20 headers. Keys must match /^[A-Za-z0-9-]+$/ and not be reserved. */
             webhook_headers?: {
@@ -2234,6 +2177,7 @@ export interface components {
              * @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported)
              */
             webhook_url?: string;
+            /** @description HMAC secret used to sign webhook deliveries. Each delivery carries `X-Webhook-Timestamp` and `X-Webhook-Signature` (`sha256=` + the hex HMAC-SHA256 of `timestamp.body`). See https://bytekit.com/docs/guides/webhooks for verification code. */
             webhook_secret?: string;
             webhook_headers?: {
                 [key: string]: string;
@@ -2294,7 +2238,7 @@ export interface components {
         };
         MonitorCreateResponse: components["schemas"]["MonitorResponse"] & {
             /**
-             * @description The webhook signing secret — returned **once** at creation time only. Subsequent GET requests omit this field. Always present on a create response (`webhook_url` is required on create). Format: 64 lowercase hex characters (32 bytes of entropy).
+             * @description The webhook signing secret — returned **once** at creation time only. Subsequent GET requests omit this field. Always present on a create response (`webhook_url` is required on create). Format: 64 lowercase hex characters (32 bytes of entropy). Use it to verify the `X-Webhook-Signature` header on each delivery — see https://bytekit.com/docs/guides/webhooks.
              * @example a3f1b2c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2
              */
             webhook_secret?: string;
@@ -2343,7 +2287,10 @@ export interface components {
              * @description Optional webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported). When omitted, no `sitemap.completed`/`sitemap.failed` webhook is delivered and the job is poll-only via `GET /v1/sitemap/{id}`. When present, delivery is unchanged. `webhook_secret` is ignored when `webhook_url` is absent.
              */
             webhook_url?: string;
-            /** @default null */
+            /**
+             * @description HMAC secret used to sign webhook deliveries. Each delivery carries `X-Webhook-Timestamp` and `X-Webhook-Signature` (`sha256=` + the hex HMAC-SHA256 of `timestamp.body`). See https://bytekit.com/docs/guides/webhooks for verification code.
+             * @default null
+             */
             webhook_secret: string | null;
             /**
              * @description Max 90 days.
@@ -2580,7 +2527,10 @@ export interface components {
             };
             /** Format: date-time */
             cancelled_at: string | null;
-            /** Format: date-time */
+            /**
+             * Format: date-time
+             * @description Reserved, and always `null` today: it reflects the account's cancellation grace deadline, which no current code path sets. It is not the payment-failure grace period — that deadline is tracked per invoice (7 days from the failed payment) in `billing_dunning_graces` and is not exposed on this response.
+             */
             grace_period_expires_at: string | null;
             /** Format: date-time */
             created_at: string;
@@ -2665,6 +2615,7 @@ export interface components {
             purchased_topup_bytes: number;
             /** @description Bytes remaining in starter-grant lots, after active refund reservations. Purchased top-up bytes are excluded. */
             granted_topup_bytes: number;
+            /** @description Unspent subscription allowance carried over from earlier billing periods: bytes remaining in allowance lots granted before the current period started, after active refund reservations. Carried value is spent before the current period's allowance, so this falls to `0` before `limit_bytes` reaches the current allowance alone. */
             rollover_bytes: number;
         };
         CreditBalance: {
@@ -2677,6 +2628,7 @@ export interface components {
             purchased_topup_credits: number;
             /** @description Credits remaining in starter-grant lots, after active refund reservations. Purchased top-up credits are excluded. */
             granted_topup_credits: number;
+            /** @description Always `0`. Search credits do not carry over between billing periods; the field is retained for contract stability and will not become non-zero without an announced plan change. */
             rollover_credits: number;
         };
     };
@@ -2699,7 +2651,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 +2690,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 +3574,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 +3608,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 */
@@ -3688,6 +3629,7 @@ export interface operations {
                      * @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported)
                      */
                     webhook_url: string;
+                    /** @description HMAC secret used to sign webhook deliveries. Each delivery carries `X-Webhook-Timestamp` and `X-Webhook-Signature` (`sha256=` + the hex HMAC-SHA256 of `timestamp.body`). See https://bytekit.com/docs/guides/webhooks for verification code. */
                     webhook_secret?: string;
                     metadata?: components["schemas"]["Metadata"];
                     /**
@@ -3726,7 +3668,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;
@@ -3808,6 +3750,43 @@ export interface operations {
                         estimated_credits: number | null;
                         /** @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported) */
                         webhook_url: string;
+                        /** @description Rehydrated per-URL scrape envelopes — the terminal page of results (default 100 rows, `?limit=` up to 500). `routes/scrape-bulk.ts` spreads this key into the SAME body on both status branches, so it is present here exactly as it is on the 202; on the 200 the entries carry their final success or error envelopes (issue #3632). */
+                        items: components["schemas"]["ScrapeEnvelope"][];
+                    };
+                };
+            };
+            /**
+             * @description Bulk job still processing. `routes/scrape-bulk.ts` ends the poll handler
+             *     with `status: isTerminal ? 200 : 202` over an identical body, so this is
+             *     the SAME envelope the 200 documents — only the status code and the
+             *     reachable `status` values differ. Keep polling until you get a 200
+             *     (issue #3533).
+             */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example bulk_01j9abc123 */
+                        id: string;
+                        /** @enum {string} */
+                        status: "processing";
+                        total: number;
+                        completed: number;
+                        failed: number;
+                        /** Format: date-time */
+                        created_at: string;
+                        /** Format: date-time */
+                        completed_at: string | null;
+                        /** @description Total credits billed for the job. Null until the job is billed. Fractional — credits are NUMERIC(10,2). */
+                        total_credits_charged: number | null;
+                        /** @description Null in GET responses (computed at submission time only). */
+                        estimated_credits: number | null;
+                        /** @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported) */
+                        webhook_url: string;
+                        /** @description Rehydrated per-URL scrape envelopes — the same page the 200 returns (default 100 rows, `?limit=` up to 500). While the job is non-terminal most entries carry the `queued` envelope. */
+                        items: components["schemas"]["ScrapeEnvelope"][];
                     };
                 };
             };
@@ -3826,7 +3805,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 +3838,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 +3857,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 +3876,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 +3893,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 +3930,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 +3959,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 +3978,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 +3997,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 +4014,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 +4053,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 */
@@ -4044,6 +4067,7 @@ export interface operations {
                      * @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported)
                      */
                     webhook_url: string;
+                    /** @description HMAC secret used to sign webhook deliveries. Each delivery carries `X-Webhook-Timestamp` and `X-Webhook-Signature` (`sha256=` + the hex HMAC-SHA256 of `timestamp.body`). See https://bytekit.com/docs/guides/webhooks for verification code. */
                     webhook_secret?: string;
                     metadata?: components["schemas"]["Metadata"];
                 };
@@ -4070,7 +4094,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;
@@ -4179,6 +4203,72 @@ export interface operations {
                     };
                 };
             };
+            /**
+             * @description Bulk job still processing. `routes/fetch-bulk.ts` ends the poll handler
+             *     with `status: isTerminal ? 200 : 202` over an identical body, so this is
+             *     the SAME envelope the 200 documents — only the status code and the
+             *     reachable `status` values differ. Keep polling until you get a 200; a
+             *     **cancelled** job stays on this branch forever (issue #3533).
+             *
+             *     Item `content_url` values are pre-signed exactly as on the 200 — a fresh
+             *     600-second signature on every poll.
+             */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example bulk_01j9abc123 */
+                        id: string;
+                        /** @enum {string} */
+                        status: "processing" | "cancelled";
+                        total: number;
+                        completed: number;
+                        failed: number;
+                        /** Format: date-time */
+                        created_at: string;
+                        /** Format: date-time */
+                        completed_at: string | null;
+                        /** @description Total credits billed for the job. Null until the job is billed. Fractional — credits are NUMERIC(10,2). */
+                        total_credits_charged: number | null;
+                        /** @description Null in GET responses (computed at submission time only). */
+                        estimated_credits: number | null;
+                        /** @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported) */
+                        webhook_url: string;
+                        /** @description Per-URL fetch items, oldest first, capped at 500 (listBulkFetchItemsWithLatestAttempt). */
+                        items: {
+                            /**
+                             * @description Scrape-row id, `sc_`-prefixed. Fetch-bulk items are rows of the same resource sync `/v1/scrape` returns, so they share its prefix. Not to be confused with the `ft_`-prefixed `X-Fetch-ID` correlation header on sync `/v1/fetch`, which identifies a request rather than a stored item.
+                             * @example sc_01j9abc123
+                             */
+                            id: string;
+                            /** Format: uri */
+                            url: string;
+                            /** @enum {string} */
+                            status: "pending" | "processing" | "completed" | "failed" | "cancelled";
+                            content_type: string | null;
+                            content_length: number | null;
+                            /** @description Pre-signed download URL for the fetched body, valid for 600 seconds (10 minutes) from the moment this response was generated — matching the signing TTL of `image_url` on `GET /v1/bulk/{id}/screenshots`. A new signature is minted on every poll. Null for items with no stored body; a completed item whose object cannot be signed falls back to the unsigned stored URL, which returns 401 on download. */
+                            content_url: string | null;
+                            waf_vendor: string | null;
+                            cache_hit: boolean;
+                            /**
+                             * @description Itemised account of this item's charge — the basis, the named factors
+                             *     that composed the multiplier, and the resulting billed bytes. Omitted
+                             *     for rows that completed before the billing node was persisted.
+                             */
+                            billing?: components["schemas"]["BillingNode"];
+                            error_code: string | null;
+                            error_message: string | null;
+                            /** Format: date-time */
+                            created_at: string;
+                            /** Format: date-time */
+                            completed_at: string | null;
+                        }[];
+                    };
+                };
+            };
             /** @description Resource not found. */
             404: {
                 headers: {
@@ -4401,6 +4491,7 @@ export interface operations {
                      * @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported)
                      */
                     webhook_url: string;
+                    /** @description HMAC secret used to sign webhook deliveries. Each delivery carries `X-Webhook-Timestamp` and `X-Webhook-Signature` (`sha256=` + the hex HMAC-SHA256 of `timestamp.body`). See https://bytekit.com/docs/guides/webhooks for verification code. */
                     webhook_secret?: string;
                     metadata?: components["schemas"]["Metadata"];
                 };
@@ -4427,7 +4518,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;
@@ -4516,6 +4607,38 @@ export interface operations {
                     };
                 };
             };
+            /**
+             * @description Bulk job still processing. `routes/bulk.ts` ends the poll handler with
+             *     `status: isTerminal ? 200 : 202` over an identical body, so this is the
+             *     SAME envelope the 200 documents — only the status code and the reachable
+             *     `status` values differ. Keep polling until you get a 200 (issue #3533).
+             */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @example bulk_01j9abc123 */
+                        id: string;
+                        /** @enum {string} */
+                        status: "processing";
+                        total: number;
+                        completed: number;
+                        failed: number;
+                        /** Format: date-time */
+                        created_at: string;
+                        /** Format: date-time */
+                        completed_at: string | null;
+                        /** @description Total credits billed for the job. Null until the job is billed. Fractional — credits are NUMERIC(10,2). */
+                        total_credits_charged: number | null;
+                        /** @description Null in GET responses (computed at submission time only). */
+                        estimated_credits: number | null;
+                        /** @description Webhook endpoint URL (HTTPS only; http:// rejected with 400 invalid_url, reason scheme_unsupported) */
+                        webhook_url: string;
+                    };
+                };
+            };
             /** @description Resource not found. */
             404: {
                 headers: {
@@ -5144,7 +5267,7 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Payment required — the account is out of credits. */
+            /** @description Payment required. Either the account is out of credits (`quota_exceeded`), or a custom overage-enabled plan would cross its configured overage spending cap (`spending_cap_reached`). */
             402: {
                 headers: {
                     [name: string]: unknown;
@@ -5248,18 +5371,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
@@ -5433,7 +5546,7 @@ export interface operations {
                         plan_type: "payg" | "subscription";
                         /** @description Total top-up spend in cents for this billing period. Present only in dual/bytes billing mode. */
                         topup_spent_cents?: number;
-                        /** @description Remaining top-up bytes: max(0, topup_bytes − max(0, bytes_used − included_bytes − rollover_bytes)). Present only in dual/bytes billing mode. */
+                        /** @description Remaining purchased top-up bytes, already net of any overage consumed against them. Equal to topup_bytes. Present only in dual/bytes billing mode. */
                         topup_balance_bytes?: number;
                         /** @description Days elapsed since period_start. */
                         period_days_elapsed: number;
@@ -5443,9 +5556,13 @@ export interface operations {
                         bytes_bulk: number;
                         bytes_scrape: number;
                         bytes_monitor: number;
+                        /** @description The spendable byte budget for this period, summed over the account's value lots: the allowance granted for the current period, plus unspent allowance carried over from earlier periods, plus purchased top-up and starter-grant bytes. Carried-over value is spent first, so this figure falls as it is consumed. */
                         bytes_limit: number;
+                        /** @description Bytes still available across every active lot, after active refund reservations. */
                         bytes_remaining: number;
+                        /** @description Unspent allowance carried over from earlier billing periods. */
                         rollover_bytes: number;
+                        /** @description Bytes remaining in purchased top-up and starter-grant lots. Subscription allowance is excluded. */
                         topup_bytes: number;
                         /** @description Total API requests in the current billing period. */
                         request_count: number;
@@ -5624,9 +5741,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). */
@@ -6063,7 +6180,7 @@ export interface operations {
                             /** @description Whether the authenticated account's plan supports bandwidth top-up purchases. False for free and PAYG plans. The frontend should disable or hide the Buy Bandwidth affordance when this is false. */
                             available: boolean;
                         };
-                        /** @description The number of bandwidth bytes included in the account's current plan allotment (before any rollover or top-up bytes). Use this value instead of computing plan allotment client-side from `limit_bytes - rollover_bytes - topup_bytes`. */
+                        /** @description The bandwidth allotment configured on the account's current plan (before any rollover or top-up bytes). Use this value instead of computing the plan allotment client-side from `limit_bytes - rollover_bytes - topup_bytes`: the allowance actually granted is the lot written when the period's invoice was paid, so the two can differ before the first paid invoice of a plan. */
                         included_bytes?: number;
                         /** @description Number of automatic top-up transactions (bandwidth and credit) that have been triggered in the current calendar month. Includes both pending and completed transactions. */
                         triggers_this_month?: number;

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.1";

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.1';

package/package.json

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