@hunt-labs/bytekit-sdk 0.11.14 → 0.11.15

package/CHANGELOG.md

@@ -10,6 +10,20 @@ today, see [README.md](./README.md), which remains the authoritative usage guide
 
 ## [Unreleased]
 
+## [0.11.15] - 2026-11-04
+
+### Changed
+
+- **New internal `GET /v1/bulk/concurrency` operation (#3718).** The generated `getBulkConcurrency`
+  types record a read-only operation that returns `{ active, limit }`: the account's in-use bulk
+  concurrency slots (`null` when the slot count cannot be read) and the plan cap, for the dashboard's
+  bulk playground. It is `x-sdk-scope: internal` and adds no SDK method, so no published method
+  signature moves; `GET /v1/bulk` is unchanged.
+- **`device_scale_factor` accepts only `1` (#5630).** The generated `ScreenshotRequest` and the bulk
+  `defaults` types narrow `device_scale_factor` from `1 | 2 | null` to `1 | null`. The API now answers
+  `2` (or any other value) with a 422 `validation_error`; omitting the field still means `null`.
+  Regenerated `src/generated/api.d.ts`.
+
 ## [0.11.14] - 2026-10-27
 
 ### Added

package/dist/generated/api.d.ts

@@ -465,6 +465,33 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/bulk/concurrency": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get bulk concurrency usage
+         * @description Returns how many of the account's bulk concurrency slots are in use and
+         *     the plan cap they count against, so a dashboard can tell a bulk job that
+         *     is waiting on the cap from one that is stalled. `active` is a live
+         *     approximation of dispatched bulk children: a slot whose release never
+         *     arrived drops out of the count after 5 minutes. It is for display only
+         *     and never decides a job's state or progress, which come from the job's
+         *     own counters, nor enforcement or billing. Authenticates with an API key
+         *     or a dashboard session, like the other `/v1/bulk` operations.
+         */
+        get: operations["getBulkConcurrency"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/bulk/{id}": {
         parameters: {
             query?: never;
@@ -2318,10 +2345,11 @@ export interface components {
             /** @default false */
             dark_mode: boolean;
             /**
+             * @description Pixel density. Only `1` is supported; any other value is a 422 `validation_error`.
              * @default null
              * @enum {integer|null}
              */
-            device_scale_factor: 1 | 2 | null;
+            device_scale_factor: 1 | null;
             /** @default false */
             include_html: boolean;
             /** @default US */
@@ -3713,7 +3741,7 @@ export interface operations {
                     "X-Screenshot-Status"?: string;
                     /** @description The originally requested URL. */
                     "X-Screenshot-URL"?: string;
-                    /** @description Legacy credit weight for this capture (1, 2 or 4, doubling for `full_page` and again for retina/mobile). It is recorded for reporting only — screenshots are billed on bandwidth, not credits: the charge is the Phase 1 wire bytes x 1.5, and zero when Phase 1 is skipped or fails. */
+                    /** @description Legacy credit weight for this capture (1, 2 or 4, doubling for `full_page` and again for mobile). It is recorded for reporting only — screenshots are billed on bandwidth, not credits: the charge is the Phase 1 wire bytes x 1.5, and zero when Phase 1 is skipped or fails. */
                     "X-Screenshot-Credits-Charged"?: number;
                     /** @description Handler elapsed time in milliseconds. */
                     "X-Screenshot-Duration-Ms"?: number;
@@ -3754,7 +3782,7 @@ export interface operations {
                     "X-Screenshot-Status"?: string;
                     /** @description The originally requested URL. */
                     "X-Screenshot-URL"?: string;
-                    /** @description Legacy credit weight for this capture (1, 2 or 4, doubling for `full_page` and again for retina/mobile). It is recorded for reporting only — screenshots are billed on bandwidth, not credits: the charge is the Phase 1 wire bytes x 1.5, and zero when Phase 1 is skipped or fails. */
+                    /** @description Legacy credit weight for this capture (1, 2 or 4, doubling for `full_page` and again for mobile). It is recorded for reporting only — screenshots are billed on bandwidth, not credits: the charge is the Phase 1 wire bytes x 1.5, and zero when Phase 1 is skipped or fails. */
                     "X-Screenshot-Credits-Charged"?: number;
                     /** @description Handler elapsed time in milliseconds. */
                     "X-Screenshot-Duration-Ms"?: number;
@@ -4057,6 +4085,22 @@ export interface operations {
             };
             401: components["responses"]["Unauthorized"];
             402: components["responses"]["PaymentRequired"];
+            /**
+             * @description `unsupported_content_type`, in two cases:
+             *     - The `url` path ends in `.pdf`: the path, lowercased, ends in `.pdf`; the query string and
+             *       fragment are not looked at. It is refused before anything is drawn. A PDF served from
+             *       another path, or reached through a redirect, is not caught by this check.
+             *     - The page was fetched (or served from cache) and its content type cannot produce the
+             *       requested formats. The charge is refunded.
+             */
+            415: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /**
              * @description Validation error. A `json` format entry whose `schema` the extractor cannot take is
              *     refused with `schema_incompatible`, before anything is drawn.
@@ -4325,6 +4369,20 @@ 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 Items refused at intake and not queued, by their index in `items` or `urls`.
+                         *     An item is refused with `unsupported_content_type` when its URL path, lowercased,
+                         *     ends in `.pdf` (the query string and fragment are not looked at). Refused items
+                         *     are not counted in `total` and nothing is reserved for them. Empty when every
+                         *     item was accepted.
+                         */
+                        rejected: {
+                            index: number;
+                            url: string;
+                            /** @enum {string} */
+                            code: "unsupported_content_type";
+                            message: string;
+                        }[];
                     };
                 };
             };
@@ -4380,9 +4438,25 @@ export interface operations {
                 };
             };
             /**
-             * @description Validation error. `bulk_too_large` is returned when the item count
-             *     exceeds the account plan's `max_bulk_size` cap (also surfaced as
-             *     `max_bulk_size` on `GET /v1/account`).
+             * @description `unsupported_content_type`: every item in the batch was refused because its URL path ends in
+             *     `.pdf` (the path, lowercased; the query string and fragment are not looked at). Nothing is
+             *     queued or billed. `details.rejected` lists each item as `{ index, url, code, message }`.
+             *     When only some items are refused the batch is accepted with `202` and those items are
+             *     listed in `rejected` instead.
+             */
+            415: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /**
+             * @description Validation error. `bulk_too_large` is returned when the count of
+             *     accepted items exceeds the account plan's `max_bulk_size` cap (also
+             *     surfaced as `max_bulk_size` on `GET /v1/account`). Items refused
+             *     for a `.pdf` path are listed in `rejected` and do not count.
              */
             422: {
                 headers: {
@@ -5261,8 +5335,7 @@ export interface operations {
                  *         "country": "US",
                  *         "formats": [
                  *           "raw"
-                 *         ],
-                 *         "device_scale_factor": 2
+                 *         ]
                  *       },
                  *       "metadata": {
                  *         "campaign": "q3"
@@ -5366,10 +5439,11 @@ export interface operations {
                             height: number;
                         } | null;
                         /**
+                         * @description Pixel density. Only `1` is supported; any other value is a 422 `validation_error`.
                          * @default null
                          * @enum {integer|null}
                          */
-                        device_scale_factor?: 1 | 2 | null;
+                        device_scale_factor?: 1 | null;
                     };
                     /**
                      * Format: uri
@@ -5495,6 +5569,32 @@ export interface operations {
             };
         };
     };
+    getBulkConcurrency: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful response. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description Bulk slots in use right now. `0` is a real zero (nothing running). `null` means the slot count could not be read right now; it is not zero. */
+                        active: number | null;
+                        /** @description The plan's maximum concurrency, the cap `active` counts against. */
+                        limit: number;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+        };
+    };
     getBulk: {
         parameters: {
             query?: never;
@@ -5841,6 +5941,21 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /**
+             * @description `unsupported_content_type`: a `scrape` monitor whose `url` path ends in `.pdf` is refused
+             *     before it is stored. The check is on the URL only: the path, lowercased, ends in `.pdf`;
+             *     the query string and fragment are not looked at. A PDF served from another path, or reached
+             *     through a redirect, is not caught here — its polls fail as `unsupported_content_type` and
+             *     count toward auto-suspension. A `screenshot` monitor is not affected.
+             */
+            415: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Validation error. */
             422: {
                 headers: {
@@ -5977,6 +6092,21 @@ export interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
+            /**
+             * @description `unsupported_content_type`: a `scrape` monitor whose `url` path ends in `.pdf` is refused
+             *     before it is stored. The check is on the URL only: the path, lowercased, ends in `.pdf`;
+             *     the query string and fragment are not looked at. A PDF served from another path, or reached
+             *     through a redirect, is not caught here — its polls fail as `unsupported_content_type` and
+             *     count toward auto-suspension. A `screenshot` monitor is not affected.
+             */
+            415: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
             /** @description Validation error. */
             422: {
                 headers: {

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.11.14";
+export declare const SDK_VERSION = "0.11.15";

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.11.14';
+export const SDK_VERSION = '0.11.15';

package/package.json

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