@hunt-labs/bytekit-sdk 0.3.0 → 0.5.0

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 {};

package/dist/resources/screenshots.js

@@ -10,10 +10,14 @@ export 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, params) {
+    create(opts, params, requestOptions) {
         const suffix = params?.async === true ? '?async=true' : '';
-        return this.client.request('POST', `/v1/screenshots${suffix}`, opts);
+        return this.client.request('POST', `/v1/screenshots${suffix}`, opts, requestOptions);
     }
     /**
      * GET /v1/screenshots/{id} — poll a screenshot by ID.
@@ -21,7 +25,34 @@ export class ScreenshotsResource {
      * A terminal-`failed` screenshot returns the `Error` envelope on a 200
      * (issue #2027), so narrow the result before reading `image_url`.
      */
-    get(id) {
-        return this.client.request('GET', `/v1/screenshots/${id}`);
+    get(id, requestOptions) {
+        return this.client.request('GET', `/v1/screenshots/${id}`, undefined, requestOptions);
+    }
+    /**
+     * 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, params, requestOptions) {
+        const suffix = params?.async === true ? '?async=true' : '';
+        return this.client.requestWithResponse('POST', `/v1/screenshots${suffix}`, opts, requestOptions);
+    }
+    /**
+     * 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, requestOptions) {
+        return this.client.requestWithResponse('GET', `/v1/screenshots/${id}`, undefined, requestOptions);
     }
 }

package/dist/resources/search.d.ts

@@ -1,8 +1,13 @@
-import type { ByteKit } from '../client.js';
+import type { ByteKit, RequestOptions } from '../client.js';
 import type { SearchOpts, SearchResponse } from '../types.js';
 export declare class SearchResource {
     private readonly client;
     constructor(client: ByteKit);
-    /** POST /v1/search — run a web search and return ranked organic results. */
-    query(opts: SearchOpts): Promise<SearchResponse>;
+    /**
+     * POST /v1/search — run a web search and return ranked organic results.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    query(opts: SearchOpts, requestOptions?: RequestOptions): Promise<SearchResponse>;
 }

package/dist/resources/search.js

@@ -3,8 +3,13 @@ export class SearchResource {
     constructor(client) {
         this.client = client;
     }
-    /** POST /v1/search — run a web search and return ranked organic results. */
-    query(opts) {
-        return this.client.request('POST', '/v1/search', opts);
+    /**
+     * POST /v1/search — run a web search and return ranked organic results.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    query(opts, requestOptions) {
+        return this.client.request('POST', '/v1/search', opts, requestOptions);
     }
 }

package/dist/resources/sitemap.d.ts

@@ -1,8 +1,20 @@
-import type { ByteKit } from '../client.js';
+import type { ApiResponse, ByteKit, RequestOptions } from '../client.js';
 import type { operations } from '../generated/api.js';
 import type { SitemapId } from '../types.js';
-/** Body of POST /v1/sitemap. */
-export type SitemapCreateRequest = operations['createSitemap']['requestBody']['content']['application/json'];
+/** The `createSitemap` request body exactly as the OpenAPI spec declares it. */
+type SitemapRequestSpec = operations['createSitemap']['requestBody']['content']['application/json'];
+/**
+ * Body of POST /v1/sitemap — `url` is required, every other field optional.
+ *
+ * Same `defaultNonNullable` drift documented on `ScreenshotCreateRequest`
+ * (screenshots.ts:12-31, follow-up #2540): the spec says `required: [url]`
+ * (openapi.yaml `SitemapRequest`) but 7 sibling fields carry `default:`, which
+ * `openapi-typescript` v7's `defaultNonNullable` transform promotes to
+ * non-optional in the generated type. Relaxed here so the spec-minimal
+ * `create({ url })` compiles — still DERIVED from the operation type, never
+ * hand-authored.
+ */
+export type SitemapCreateRequest = Partial<SitemapRequestSpec> & Pick<SitemapRequestSpec, 'url'>;
 /** 202 payload of POST /v1/sitemap — sitemap crawls are always async. */
 export type SitemapCreateResponse = operations['createSitemap']['responses'][202]['content']['application/json'];
 /** 200 payload of GET /v1/sitemap/{id}. */
@@ -10,8 +22,25 @@ export type SitemapGetResponse = operations['getSitemap']['responses'][200]['con
 export declare class SitemapResource {
     private readonly client;
     constructor(client: ByteKit);
-    /** POST /v1/sitemap — start a sitemap crawl */
-    create(opts: SitemapCreateRequest): Promise<SitemapCreateResponse>;
+    /**
+     * POST /v1/sitemap — start a sitemap crawl.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    create(opts: SitemapCreateRequest, requestOptions?: RequestOptions): Promise<SitemapCreateResponse>;
     /** GET /v1/sitemap/{id} — get a sitemap job by ID */
-    get(id: SitemapId): Promise<SitemapGetResponse>;
+    get(id: SitemapId, requestOptions?: RequestOptions): Promise<SitemapGetResponse>;
+    /**
+     * GET /v1/sitemap/{id}, returning the header set alongside the body (#2547).
+     *
+     * Same request as `sitemap.get` — same method, path and `RequestOptions`
+     * precedence — and `data` is exactly what `get()` resolves to. `get()`'s own return type
+     * is UNCHANGED; this is an additive sibling, not a replacement.
+     *
+     * The spec documents `X-Sitemap-ID`, `X-Raw-Bytes`, `X-Billing-Multiplier` and
+     * `X-Billable-Bytes` on this endpoint's 200; every one of them is on `headers`.
+     */
+    getWithResponse(id: SitemapId, requestOptions?: RequestOptions): Promise<ApiResponse<SitemapGetResponse>>;
 }
+export {};

package/dist/resources/sitemap.js

@@ -3,12 +3,30 @@ export class SitemapResource {
     constructor(client) {
         this.client = client;
     }
-    /** POST /v1/sitemap — start a sitemap crawl */
-    create(opts) {
-        return this.client.request('POST', '/v1/sitemap', opts);
+    /**
+     * POST /v1/sitemap — start a sitemap crawl.
+     *
+     * `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/sitemap', opts, requestOptions);
     }
     /** GET /v1/sitemap/{id} — get a sitemap job by ID */
-    get(id) {
-        return this.client.request('GET', `/v1/sitemap/${id}`);
+    get(id, requestOptions) {
+        return this.client.request('GET', `/v1/sitemap/${id}`, undefined, requestOptions);
+    }
+    /**
+     * GET /v1/sitemap/{id}, returning the header set alongside the body (#2547).
+     *
+     * Same request as `sitemap.get` — same method, path and `RequestOptions`
+     * precedence — and `data` is exactly what `get()` resolves to. `get()`'s own return type
+     * is UNCHANGED; this is an additive sibling, not a replacement.
+     *
+     * The spec documents `X-Sitemap-ID`, `X-Raw-Bytes`, `X-Billing-Multiplier` and
+     * `X-Billable-Bytes` on this endpoint's 200; every one of them is on `headers`.
+     */
+    getWithResponse(id, requestOptions) {
+        return this.client.requestWithResponse('GET', `/v1/sitemap/${id}`, undefined, requestOptions);
     }
 }

package/dist/resources/usage.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';
 /** 200 payload of GET /v1/usage — current billing period usage summary. */
 export type GetUsageResponse = operations['getUsage']['responses'][200]['content']['application/json'];
@@ -16,16 +16,21 @@ export type GetUsageByEndpointResponse = operations['getUsageByEndpoint']['respo
 export declare class UsageResource {
     private readonly client;
     constructor(client: ByteKit);
-    /** GET /v1/usage — get current billing period usage. */
-    get(): Promise<GetUsageResponse>;
+    /**
+     * GET /v1/usage — get current billing period usage.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    get(requestOptions?: RequestOptions): Promise<GetUsageResponse>;
     /**
      * GET /v1/usage/daily — get daily usage breakdown.
      * Default range is the last 30 days; max range is 366 days.
      */
-    daily(params?: GetUsageDailyParams): Promise<GetUsageDailyResponse>;
+    daily(params?: GetUsageDailyParams, requestOptions?: RequestOptions): Promise<GetUsageDailyResponse>;
     /**
      * GET /v1/usage/by-endpoint — get per-endpoint bandwidth breakdown.
      * Default range is the last 30 days; max range is 366 days.
      */
-    byEndpoint(params?: GetUsageByEndpointParams): Promise<GetUsageByEndpointResponse>;
+    byEndpoint(params?: GetUsageByEndpointParams, requestOptions?: RequestOptions): Promise<GetUsageByEndpointResponse>;
 }

package/dist/resources/usage.js

@@ -4,22 +4,27 @@ export class UsageResource {
     constructor(client) {
         this.client = client;
     }
-    /** GET /v1/usage — get current billing period usage. */
-    get() {
-        return this.client.request('GET', '/v1/usage');
+    /**
+     * GET /v1/usage — get current billing period usage.
+     *
+     * `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/usage', undefined, requestOptions);
     }
     /**
      * GET /v1/usage/daily — get daily usage breakdown.
      * Default range is the last 30 days; max range is 366 days.
      */
-    daily(params) {
-        return this.client.request('GET', `/v1/usage/daily${toQueryString(params)}`);
+    daily(params, requestOptions) {
+        return this.client.request('GET', `/v1/usage/daily${toQueryString(params)}`, undefined, requestOptions);
     }
     /**
      * GET /v1/usage/by-endpoint — get per-endpoint bandwidth breakdown.
      * Default range is the last 30 days; max range is 366 days.
      */
-    byEndpoint(params) {
-        return this.client.request('GET', `/v1/usage/by-endpoint${toQueryString(params)}`);
+    byEndpoint(params, requestOptions) {
+        return this.client.request('GET', `/v1/usage/by-endpoint${toQueryString(params)}`, undefined, requestOptions);
     }
 }

package/dist/resources/webhooks.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 { WebhookDeliveryId } from '../types.js';
 /**
@@ -13,8 +13,13 @@ export type RetryWebhookDeliveryResponse = operations['retryWebhookDelivery']['r
 export declare class WebhooksResource {
     private readonly client;
     constructor(client: ByteKit);
-    /** GET /v1/webhook-deliveries — list webhook deliveries. */
-    list(params?: ListWebhookDeliveriesParams): Promise<ListWebhookDeliveriesResponse>;
+    /**
+     * GET /v1/webhook-deliveries — list webhook deliveries.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    list(params?: ListWebhookDeliveriesParams, requestOptions?: RequestOptions): Promise<ListWebhookDeliveriesResponse>;
     /** POST /v1/webhook-deliveries/{id}/retry — requeue a failed or exhausted delivery. */
-    retry(id: WebhookDeliveryId): Promise<RetryWebhookDeliveryResponse>;
+    retry(id: WebhookDeliveryId, requestOptions?: RequestOptions): Promise<RetryWebhookDeliveryResponse>;
 }

package/dist/resources/webhooks.js

@@ -4,12 +4,17 @@ export class WebhooksResource {
     constructor(client) {
         this.client = client;
     }
-    /** GET /v1/webhook-deliveries — list webhook deliveries. */
-    list(params) {
-        return this.client.request('GET', `/v1/webhook-deliveries${toQueryString(params)}`);
+    /**
+     * GET /v1/webhook-deliveries — list webhook deliveries.
+     *
+     * `requestOptions` carries the CLIENT-side abort budget (`requestTimeoutMs`) and an
+     * optional caller `signal`; both override the constructor's `timeoutMs` default.
+     */
+    list(params, requestOptions) {
+        return this.client.request('GET', `/v1/webhook-deliveries${toQueryString(params)}`, undefined, requestOptions);
     }
     /** POST /v1/webhook-deliveries/{id}/retry — requeue a failed or exhausted delivery. */
-    retry(id) {
-        return this.client.request('POST', `/v1/webhook-deliveries/${id}/retry`);
+    retry(id, requestOptions) {
+        return this.client.request('POST', `/v1/webhook-deliveries/${id}/retry`, undefined, requestOptions);
     }
 }

package/package.json

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