@hunt-labs/bytekit-sdk 0.3.0 → 0.4.0

package/dist/resources/account.js

@@ -5,9 +5,14 @@ export class AccountResource {
         this.client = client;
         this.apiKeys = new ApiKeysResource(client);
     }
-    /** GET /v1/account — get the authenticated account */
-    get() {
-        return this.client.request('GET', '/v1/account');
+    /**
+     * GET /v1/account — get the authenticated account.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    get(requestOptions) {
+        return this.client.request('GET', '/v1/account', undefined, requestOptions);
     }
 }
 class ApiKeysResource {
@@ -21,20 +26,20 @@ class ApiKeysResource {
      * `opts` is optional: the spec declares the request body itself as optional,
      * so `create()` with no arguments is valid and sends no body.
      */
-    create(opts) {
-        return this.client.request('POST', '/v1/account/api-keys', opts);
+    create(opts, requestOptions) {
+        return this.client.request('POST', '/v1/account/api-keys', opts, requestOptions);
     }
     /** GET /v1/account/api-keys — list all API keys for the account */
-    list() {
-        return this.client.request('GET', '/v1/account/api-keys');
+    list(requestOptions) {
+        return this.client.request('GET', '/v1/account/api-keys', undefined, requestOptions);
     }
     /** GET /v1/account/api-keys/{id} — get an API key by ID */
-    get(id) {
-        return this.client.request('GET', `/v1/account/api-keys/${id}`);
+    get(id, requestOptions) {
+        return this.client.request('GET', `/v1/account/api-keys/${id}`, undefined, requestOptions);
     }
     /** PATCH /v1/account/api-keys/{id} — update an API key */
-    update(id, opts) {
-        return this.client.request('PATCH', `/v1/account/api-keys/${id}`, opts);
+    update(id, opts, requestOptions) {
+        return this.client.request('PATCH', `/v1/account/api-keys/${id}`, opts, requestOptions);
     }
     /**
      * DELETE /v1/account/api-keys/{id} — revoke an API key (idempotent).
@@ -47,11 +52,11 @@ class ApiKeysResource {
      * to `undefined` before it would parse the body as JSON (#2450), so this
      * method resolves cleanly on the gateway's empty 204 body.
      */
-    revoke(id) {
-        return this.client.request('DELETE', `/v1/account/api-keys/${id}`);
+    revoke(id, requestOptions) {
+        return this.client.request('DELETE', `/v1/account/api-keys/${id}`, undefined, requestOptions);
     }
     /** POST /v1/account/api-keys/{id}/reveal — reveal the plaintext API key value */
-    reveal(id) {
-        return this.client.request('POST', `/v1/account/api-keys/${id}/reveal`);
+    reveal(id, requestOptions) {
+        return this.client.request('POST', `/v1/account/api-keys/${id}/reveal`, undefined, requestOptions);
     }
 }

package/dist/resources/bulk.d.ts

@@ -1,4 +1,4 @@
-import type { ByteKit } from '../client.js';
+import type { ByteKit, RequestOptions } from '../client.js';
 import type { operations } from '../generated/api.js';
 import type { BulkId } from '../types.js';
 /** Body of POST /v1/bulk. */
@@ -15,17 +15,22 @@ export declare class BulkResource {
     private readonly client;
     readonly screenshots: BulkScreenshotsResource;
     constructor(client: ByteKit);
-    /** POST /v1/bulk — create a bulk screenshots job */
-    create(opts: BulkCreateRequest): Promise<BulkCreateResponse>;
+    /**
+     * POST /v1/bulk — create a bulk screenshots job.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    create(opts: BulkCreateRequest, requestOptions?: RequestOptions): Promise<BulkCreateResponse>;
     /** GET /v1/bulk/{id} — get a bulk job status */
-    get(id: BulkId): Promise<BulkGetResponse>;
+    get(id: BulkId, requestOptions?: RequestOptions): Promise<BulkGetResponse>;
     /** DELETE /v1/bulk/{id} — cancel an in-flight bulk job */
-    cancel(id: BulkId): Promise<BulkCancelResponse>;
+    cancel(id: BulkId, requestOptions?: RequestOptions): Promise<BulkCancelResponse>;
 }
 declare class BulkScreenshotsResource {
     private readonly client;
     constructor(client: ByteKit);
     /** GET /v1/bulk/{id}/screenshots — list screenshots in a bulk job */
-    list(id: BulkId): Promise<ListBulkScreenshotsResponse>;
+    list(id: BulkId, requestOptions?: RequestOptions): Promise<ListBulkScreenshotsResponse>;
 }
 export {};

package/dist/resources/bulk.js

@@ -5,17 +5,22 @@ export class BulkResource {
         this.client = client;
         this.screenshots = new BulkScreenshotsResource(client);
     }
-    /** POST /v1/bulk — create a bulk screenshots job */
-    create(opts) {
-        return this.client.request('POST', '/v1/bulk', opts);
+    /**
+     * POST /v1/bulk — create a bulk screenshots job.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    create(opts, requestOptions) {
+        return this.client.request('POST', '/v1/bulk', opts, requestOptions);
     }
     /** GET /v1/bulk/{id} — get a bulk job status */
-    get(id) {
-        return this.client.request('GET', `/v1/bulk/${id}`);
+    get(id, requestOptions) {
+        return this.client.request('GET', `/v1/bulk/${id}`, undefined, requestOptions);
     }
     /** DELETE /v1/bulk/{id} — cancel an in-flight bulk job */
-    cancel(id) {
-        return this.client.request('DELETE', `/v1/bulk/${id}`);
+    cancel(id, requestOptions) {
+        return this.client.request('DELETE', `/v1/bulk/${id}`, undefined, requestOptions);
     }
 }
 class BulkScreenshotsResource {
@@ -24,7 +29,7 @@ class BulkScreenshotsResource {
         this.client = client;
     }
     /** GET /v1/bulk/{id}/screenshots — list screenshots in a bulk job */
-    list(id) {
-        return this.client.request('GET', `/v1/bulk/${id}/screenshots`);
+    list(id, requestOptions) {
+        return this.client.request('GET', `/v1/bulk/${id}/screenshots`, undefined, requestOptions);
     }
 }

package/dist/resources/fetch.d.ts

@@ -1,4 +1,4 @@
-import type { ByteKit } from '../client.js';
+import type { ByteKit, RequestOptions } from '../client.js';
 import type { operations } from '../generated/api.js';
 import type { BulkId } from '../types.js';
 /** Body of POST /v1/fetch/bulk. */
@@ -56,14 +56,29 @@ export interface FetchOpts {
      */
     custom?: Record<string, unknown>;
 }
+/**
+ * The query params `GET /v1/fetch` accepts, in serialization order.
+ *
+ * This is the single source of truth for BOTH halves of the GET path: the
+ * {@link FetchGetOpts} key set and the query string the builder emits. Keeping
+ * them derived from one list is what makes "accepted by the type but dropped by
+ * the serializer" — the #2539 bug — unrepresentable. The list itself is pinned to
+ * 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"];
+type FetchGetQueryKey = (typeof FETCH_GET_QUERY_KEYS)[number];
 /**
  * Options accepted by `fetch.get` (GET /v1/fetch).
  *
- * Identical to {@link FetchOpts} minus `custom`: the spec's `GET /v1/fetch` has
- * no `custom` query param, so it is excluded here — passing it is a compile
- * error rather than a silently-dropped option (#2481).
+ * A strict subset of {@link FetchOpts}: only the five 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.
  */
-export type FetchGetOpts = Omit<FetchOpts, 'custom'>;
+export type FetchGetOpts = Pick<FetchOpts, FetchGetQueryKey>;
 /** Cache-lookup outcome reported in the `X-Fetch-Cache` response header. */
 export type FetchCacheStatus = 'hit' | 'miss' | 'bypass';
 /**
@@ -71,7 +86,7 @@ export type FetchCacheStatus = 'hit' | 'miss' | 'bypass';
  *
  * `/v1/fetch` returns the fetched content AS the response body (text/html,
  * text/markdown, or raw binary passthrough) with metadata carried in `X-Fetch-*`
- * response headers — it is NOT a JSON envelope. `body` is therefore the raw
+ * 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
  * `headers` (e.g. `X-Fetch-Duration-Ms`, `X-Fetch-Waf-Vendor`).
@@ -104,7 +119,7 @@ export interface FetchResult {
     custom: string | null;
     /** The response `Content-Type` (e.g. `text/html`), or `null` if absent. */
     contentType: string | null;
-    /** The full response headers, for any `X-Fetch-*` value not surfaced above. */
+    /** The full header set on the response, for any `X-Fetch-*` value not surfaced above. */
     headers: Headers;
 }
 export declare class FetchResource {
@@ -117,26 +132,40 @@ export declare class FetchResource {
      * Resolves a `FetchResult` — the raw content body plus `X-Fetch-*` metadata.
      * The body is returned verbatim — a JSON-serving upstream comes back as the
      * raw JSON string, not a parsed object.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`. It matters most here: the gateway's own ceiling for a
+     * fetch is 60 s, so without a per-call budget a slow upstream holds the caller for
+     * the constructor default (2 minutes) rather than a duration the caller chose.
      */
-    create(opts: FetchOpts): Promise<FetchResult>;
+    create(opts: FetchOpts, requestOptions?: RequestOptions): Promise<FetchResult>;
     /**
      * GET /v1/fetch — fetch URL content via query params.
      *
      * Resolves a `FetchResult` — the raw content body plus `X-Fetch-*` metadata.
      *
-     * `custom` is intentionally absent from the accepted opts: the spec's
-     * `GET /v1/fetch` has no `custom` query param and the value was never
-     * serialized, so passing it is a compile error rather than a silent drop
-     * (#2481). Use `create()` (POST) when you need to echo a `custom` payload.
+     * 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.
+     *
+     * The query string is built by iterating `FETCH_GET_QUERY_KEYS`, the same list
+     * `FetchGetOpts` is derived from, so every accepted option is necessarily
+     * serialized.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`. As on `create`, the gateway's own ceiling for a fetch is
+     * 60 s, so a per-call budget is what keeps a slow upstream from holding the caller
+     * for the constructor default.
      */
-    get(opts: FetchGetOpts): Promise<FetchResult>;
+    get(opts: FetchGetOpts, requestOptions?: RequestOptions): Promise<FetchResult>;
 }
 declare class FetchBulkResource {
     private readonly client;
     constructor(client: ByteKit);
     /** POST /v1/fetch/bulk — create a bulk fetch job */
-    create(opts: FetchBulkCreateRequest): Promise<FetchBulkCreateResponse>;
+    create(opts: FetchBulkCreateRequest, requestOptions?: RequestOptions): Promise<FetchBulkCreateResponse>;
     /** GET /v1/fetch/bulk/{id} — get a bulk fetch job */
-    get(id: BulkId): Promise<FetchBulkGetResponse>;
+    get(id: BulkId, requestOptions?: RequestOptions): Promise<FetchBulkGetResponse>;
 }
 export {};

package/dist/resources/fetch.js

@@ -1,5 +1,16 @@
+/**
+ * The query params `GET /v1/fetch` accepts, in serialization order.
+ *
+ * This is the single source of truth for BOTH halves of the GET path: the
+ * {@link FetchGetOpts} key set and the query string the builder emits. Keeping
+ * them derived from one list is what makes "accepted by the type but dropped by
+ * the serializer" — the #2539 bug — unrepresentable. The list itself is pinned to
+ * 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 CACHE_STATUSES = ['hit', 'miss', 'bypass'];
-/** Build a typed {@link FetchResult} from a raw body + response headers. */
+/** Build a typed {@link FetchResult} from a raw body + its header set. */
 function toFetchResult(raw) {
     const { body, bytes, headers } = raw;
     const creditsRaw = headers.get('X-Fetch-Credits-Charged');
@@ -31,32 +42,42 @@ export class FetchResource {
      * Resolves a `FetchResult` — the raw content body plus `X-Fetch-*` metadata.
      * The body is returned verbatim — a JSON-serving upstream comes back as the
      * raw JSON string, not a parsed object.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`. It matters most here: the gateway's own ceiling for a
+     * fetch is 60 s, so without a per-call budget a slow upstream holds the caller for
+     * the constructor default (2 minutes) rather than a duration the caller chose.
      */
-    async create(opts) {
-        return toFetchResult(await this.client.requestRaw('POST', '/v1/fetch', opts));
+    async create(opts, requestOptions) {
+        return toFetchResult(await this.client.requestRaw('POST', '/v1/fetch', opts, requestOptions));
     }
     /**
      * GET /v1/fetch — fetch URL content via query params.
      *
      * Resolves a `FetchResult` — the raw content body plus `X-Fetch-*` metadata.
      *
-     * `custom` is intentionally absent from the accepted opts: the spec's
-     * `GET /v1/fetch` has no `custom` query param and the value was never
-     * serialized, so passing it is a compile error rather than a silent drop
-     * (#2481). Use `create()` (POST) when you need to echo a `custom` payload.
+     * 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.
+     *
+     * The query string is built by iterating `FETCH_GET_QUERY_KEYS`, the same list
+     * `FetchGetOpts` is derived from, so every accepted option is necessarily
+     * serialized.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`. As on `create`, the gateway's own ceiling for a fetch is
+     * 60 s, so a per-call budget is what keeps a slow upstream from holding the caller
+     * for the constructor default.
      */
-    async get(opts) {
+    async get(opts, requestOptions) {
         const params = new URLSearchParams();
-        params.set('url', opts.url);
-        if (opts.format !== undefined)
-            params.set('format', opts.format);
-        if (opts.country !== undefined)
-            params.set('country', opts.country);
-        if (opts.timeout_ms !== undefined)
-            params.set('timeout_ms', String(opts.timeout_ms));
-        if (opts.cache_ttl !== undefined)
-            params.set('cache_ttl', String(opts.cache_ttl));
-        return toFetchResult(await this.client.requestRaw('GET', `/v1/fetch?${params.toString()}`));
+        for (const key of FETCH_GET_QUERY_KEYS) {
+            const value = opts[key];
+            if (value !== undefined)
+                params.set(key, String(value));
+        }
+        return toFetchResult(await this.client.requestRaw('GET', `/v1/fetch?${params.toString()}`, undefined, requestOptions));
     }
 }
 class FetchBulkResource {
@@ -65,11 +86,11 @@ class FetchBulkResource {
         this.client = client;
     }
     /** POST /v1/fetch/bulk — create a bulk fetch job */
-    create(opts) {
-        return this.client.request('POST', '/v1/fetch/bulk', opts);
+    create(opts, requestOptions) {
+        return this.client.request('POST', '/v1/fetch/bulk', opts, requestOptions);
     }
     /** GET /v1/fetch/bulk/{id} — get a bulk fetch job */
-    get(id) {
-        return this.client.request('GET', `/v1/fetch/bulk/${id}`);
+    get(id, requestOptions) {
+        return this.client.request('GET', `/v1/fetch/bulk/${id}`, undefined, requestOptions);
     }
 }

package/dist/resources/monitors.d.ts

@@ -1,20 +1,39 @@
-import type { ByteKit } from '../client.js';
+import type { ByteKit, RequestOptions } from '../client.js';
 import type { operations } from '../generated/api.js';
 import type { MonitorId } from '../types.js';
 /**
  * Query params of GET /v1/monitors — all optional, omitted when unset.
  *
- * A `type` alias (not an `interface`) so it carries an implicit index signature and stays
- * assignable to {@link toQueryString}'s `Record<string, string | number | undefined>` param
- * (interfaces do not get the implicit index signature; type aliases do).
+ * DERIVED from the generated `listMonitors` query type (#2547), never hand-authored:
+ * `status` was previously typed a bare `string`, so a typo like `'activee'` compiled and
+ * only failed as a 422 on the wire. Deriving it pins the filter to the spec enum, exactly
+ * as {@link ListWebhookDeliveriesParams} does for `/v1/webhook-deliveries`.
+ *
+ * Still a `type` alias (not an `interface`) so it carries an implicit index signature and
+ * stays assignable to {@link toQueryString}'s `Record<string, string | number | undefined>`
+ * param (interfaces do not get the implicit index signature; type aliases do).
+ */
+export type ListMonitorsParams = NonNullable<operations['listMonitors']['parameters']['query']>;
+/**
+ * Lifecycle status a monitor can be filtered by — the spec enum behind
+ * {@link ListMonitorsParams.status}. Exported so callers (and the CLI) can name it.
+ */
+export type MonitorStatus = NonNullable<ListMonitorsParams['status']>;
+/** The `createMonitor` request body exactly as the OpenAPI spec declares it. */
+type MonitorRequestSpec = operations['createMonitor']['requestBody']['content']['application/json'];
+/**
+ * Body of POST /v1/monitors — `url`, `interval_type`, `webhook_url` required,
+ * every other field optional.
+ *
+ * Same `defaultNonNullable` drift documented on `ScreenshotCreateRequest`
+ * (screenshots.ts:12-31, follow-up #2540): the spec's
+ * `required: [url, interval_type, webhook_url]` is narrow, but `type`,
+ * `change_threshold`, and `notify_on` carry `default:` and `openapi-typescript`
+ * v7 promotes them to non-optional in the generated type. Relaxed here so the
+ * spec-minimal `create(...)` compiles — still DERIVED from the operation type,
+ * never hand-authored.
  */
-export type ListMonitorsParams = {
-    limit?: number;
-    cursor?: string;
-    status?: string;
-};
-/** Body of POST /v1/monitors. */
-export type MonitorCreateRequest = operations['createMonitor']['requestBody']['content']['application/json'];
+export type MonitorCreateRequest = Partial<MonitorRequestSpec> & Pick<MonitorRequestSpec, 'url' | 'interval_type' | 'webhook_url'>;
 /** 201 payload of POST /v1/monitors. */
 export type MonitorCreateResponse = operations['createMonitor']['responses'][201]['content']['application/json'];
 /** 200 payload of GET /v1/monitors — the paginated monitor list. */
@@ -35,18 +54,18 @@ export declare class MonitorsResource {
      * POST /v1/monitors — create a page-change monitor (screenshot or scrape capture).
      * First-capture behavior is the same for both types: the first capture is a silent baseline (has_change=false, change_pct=null) with no change_detected webhook, whether the monitor is `scrape` or `screenshot`. From the second capture onward both types diff against the previous capture.
      */
-    create(opts: MonitorCreateRequest): Promise<MonitorCreateResponse>;
+    create(opts: MonitorCreateRequest, requestOptions?: RequestOptions): Promise<MonitorCreateResponse>;
     /**
      * GET /v1/monitors — list monitors for the account.
      *
      * `params` is optional and each key is omitted-when-absent, so `list()` with no argument
      * serializes the bare `/v1/monitors` URL unchanged — existing zero-arg callers are unaffected.
      */
-    list(params?: ListMonitorsParams): Promise<ListMonitorsResponse>;
+    list(params?: ListMonitorsParams, requestOptions?: RequestOptions): Promise<ListMonitorsResponse>;
     /** GET /v1/monitors/{id} — get a monitor by ID */
-    get(id: MonitorId): Promise<MonitorResponse>;
+    get(id: MonitorId, requestOptions?: RequestOptions): Promise<MonitorResponse>;
     /** PATCH /v1/monitors/{id} — update a monitor */
-    update(id: MonitorId, opts: MonitorUpdateRequest): Promise<UpdateMonitorResponse>;
+    update(id: MonitorId, opts: MonitorUpdateRequest, requestOptions?: RequestOptions): Promise<UpdateMonitorResponse>;
     /**
      * DELETE /v1/monitors/{id} — delete a monitor.
      *
@@ -55,12 +74,12 @@ export declare class MonitorsResource {
      * from — hence `Promise<void>`. `client.request()` short-circuits the empty
      * body to `undefined` before it would parse as JSON (#2450).
      */
-    delete(id: MonitorId): Promise<void>;
+    delete(id: MonitorId, requestOptions?: RequestOptions): Promise<void>;
 }
 declare class MonitorCapturesResource {
     private readonly client;
     constructor(client: ByteKit);
     /** GET /v1/monitors/{id}/captures — list captures for a monitor */
-    list(id: MonitorId): Promise<ListMonitorCapturesResponse>;
+    list(id: MonitorId, requestOptions?: RequestOptions): Promise<ListMonitorCapturesResponse>;
 }
 export {};

package/dist/resources/monitors.js

@@ -10,8 +10,8 @@ export class MonitorsResource {
      * POST /v1/monitors — create a page-change monitor (screenshot or scrape capture).
      * First-capture behavior is the same for both types: the first capture is a silent baseline (has_change=false, change_pct=null) with no change_detected webhook, whether the monitor is `scrape` or `screenshot`. From the second capture onward both types diff against the previous capture.
      */
-    create(opts) {
-        return this.client.request('POST', '/v1/monitors', opts);
+    create(opts, requestOptions) {
+        return this.client.request('POST', '/v1/monitors', opts, requestOptions);
     }
     /**
      * GET /v1/monitors — list monitors for the account.
@@ -19,16 +19,16 @@ export class MonitorsResource {
      * `params` is optional and each key is omitted-when-absent, so `list()` with no argument
      * serializes the bare `/v1/monitors` URL unchanged — existing zero-arg callers are unaffected.
      */
-    list(params) {
-        return this.client.request('GET', `/v1/monitors${toQueryString(params)}`);
+    list(params, requestOptions) {
+        return this.client.request('GET', `/v1/monitors${toQueryString(params)}`, undefined, requestOptions);
     }
     /** GET /v1/monitors/{id} — get a monitor by ID */
-    get(id) {
-        return this.client.request('GET', `/v1/monitors/${id}`);
+    get(id, requestOptions) {
+        return this.client.request('GET', `/v1/monitors/${id}`, undefined, requestOptions);
     }
     /** PATCH /v1/monitors/{id} — update a monitor */
-    update(id, opts) {
-        return this.client.request('PATCH', `/v1/monitors/${id}`, opts);
+    update(id, opts, requestOptions) {
+        return this.client.request('PATCH', `/v1/monitors/${id}`, opts, requestOptions);
     }
     /**
      * DELETE /v1/monitors/{id} — delete a monitor.
@@ -38,8 +38,8 @@ export class MonitorsResource {
      * from — hence `Promise<void>`. `client.request()` short-circuits the empty
      * body to `undefined` before it would parse as JSON (#2450).
      */
-    delete(id) {
-        return this.client.request('DELETE', `/v1/monitors/${id}`);
+    delete(id, requestOptions) {
+        return this.client.request('DELETE', `/v1/monitors/${id}`, undefined, requestOptions);
     }
 }
 class MonitorCapturesResource {
@@ -48,7 +48,7 @@ class MonitorCapturesResource {
         this.client = client;
     }
     /** GET /v1/monitors/{id}/captures — list captures for a monitor */
-    list(id) {
-        return this.client.request('GET', `/v1/monitors/${id}/captures`);
+    list(id, requestOptions) {
+        return this.client.request('GET', `/v1/monitors/${id}/captures`, undefined, requestOptions);
     }
 }

package/dist/resources/scrape.d.ts

@@ -1,5 +1,5 @@
 import type { ByteKit, RequestOptions } from '../client.js';
-import type { operations } from '../generated/api.js';
+import type { components, 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,12 +26,22 @@ 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?: Array<Record<string, unknown>>;
+    /** 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`. */
@@ -127,9 +137,14 @@ export declare class ScrapeResource {
 declare class ScrapeBulkResource {
     private readonly client;
     constructor(client: ByteKit);
-    /** POST /v1/scrape/bulk — create a bulk scrape job */
-    create(opts: ScrapeBulkCreateRequest): Promise<ScrapeBulkCreateResponse>;
+    /**
+     * POST /v1/scrape/bulk — create a bulk scrape job.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    create(opts: ScrapeBulkCreateRequest, requestOptions?: RequestOptions): Promise<ScrapeBulkCreateResponse>;
     /** GET /v1/scrape/bulk/{id} — get a bulk scrape job */
-    get(id: BulkId): Promise<ScrapeBulkGetResponse>;
+    get(id: BulkId, requestOptions?: RequestOptions): Promise<ScrapeBulkGetResponse>;
 }
 export {};

package/dist/resources/scrape.js

@@ -43,12 +43,17 @@ class ScrapeBulkResource {
     constructor(client) {
         this.client = client;
     }
-    /** POST /v1/scrape/bulk — create a bulk scrape job */
-    create(opts) {
-        return this.client.request('POST', '/v1/scrape/bulk', opts);
+    /**
+     * POST /v1/scrape/bulk — create a bulk scrape job.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    create(opts, requestOptions) {
+        return this.client.request('POST', '/v1/scrape/bulk', opts, requestOptions);
     }
     /** GET /v1/scrape/bulk/{id} — get a bulk scrape job */
-    get(id) {
-        return this.client.request('GET', `/v1/scrape/bulk/${id}`);
+    get(id, requestOptions) {
+        return this.client.request('GET', `/v1/scrape/bulk/${id}`, undefined, requestOptions);
     }
 }

package/dist/resources/screenshots.d.ts

@@ -1,4 +1,4 @@
-import type { ByteKit } from '../client.js';
+import type { ApiResponse, ByteKit, RequestOptions } from '../client.js';
 import type { operations } from '../generated/api.js';
 import type { ScreenshotId } from '../types.js';
 /** The `createScreenshot` request body exactly as the OpenAPI spec declares it. */
@@ -55,16 +55,44 @@ export declare class ScreenshotsResource {
      * param on `createScreenshot`, distinct from scrape where `async` is a body field. `params` is
      * optional and `async` omitted-when-absent: `create(opts)` with no second argument posts to the
      * bare `/v1/screenshots` URL unchanged — existing single-arg callers are unaffected.
+     *
+     * `requestOptions` is the THIRD positional parameter (after `params`) so both existing call
+     * shapes stay unaffected. It carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
      */
     create(opts: ScreenshotCreateRequest, params?: {
         async?: boolean;
-    }): Promise<ScreenshotCreateResponse>;
+    }, requestOptions?: RequestOptions): Promise<ScreenshotCreateResponse>;
     /**
      * GET /v1/screenshots/{id} — poll a screenshot by ID.
      *
      * A terminal-`failed` screenshot returns the `Error` envelope on a 200
      * (issue #2027), so narrow the result before reading `image_url`.
      */
-    get(id: ScreenshotId): Promise<ScreenshotGetResponse>;
+    get(id: ScreenshotId, requestOptions?: RequestOptions): Promise<ScreenshotGetResponse>;
+    /**
+     * POST /v1/screenshots, returning the header set alongside the body (#2547).
+     *
+     * Same request as `screenshots.create` — same method, path, body and
+     * `RequestOptions` precedence — and `data` is exactly what `create()` resolves to.
+     * `create()`'s own return type is UNCHANGED; this is an additive sibling.
+     *
+     * The spec documents the `X-Screenshot-*` family (`ID`, `Status`, `URL`,
+     * `Credits-Charged`, `Duration-Ms`, `Created-At`, `Completed-At`, `Expires-At`,
+     * `Status-Code`, `Cache`, `Cache-Age`) plus `X-Raw-Bytes` / `X-Billable-Bytes` /
+     * `X-Billing-Multiplier`; every one of them is on `headers`.
+     */
+    createWithResponse(opts: ScreenshotCreateRequest, params?: {
+        async?: boolean;
+    }, requestOptions?: RequestOptions): Promise<ApiResponse<ScreenshotCreateResponse>>;
+    /**
+     * GET /v1/screenshots/{id}, returning the header set alongside the body (#2547).
+     *
+     * Same request as `screenshots.get`, and `data` is exactly what `get()`
+     * resolves to (including the #2027 failed-envelope arm). `get()`'s own return type is
+     * UNCHANGED; this is an additive sibling. The documented `X-Screenshot-*`,
+     * `X-Raw-Bytes`, `X-Billable-Bytes` and `X-Billing-Multiplier` headers are on `headers`.
+     */
+    getWithResponse(id: ScreenshotId, requestOptions?: RequestOptions): Promise<ApiResponse<ScreenshotGetResponse>>;
 }
 export {};