@hunt-labs/bytekit-sdk 0.11.1 → 0.11.3

package/CHANGELOG.md

@@ -10,6 +10,31 @@ today, see [README.md](./README.md), which remains the authoritative usage guide
 
 ## [Unreleased]
 
+## [0.11.3] - 2026-09-21
+
+### Changed
+
+- Regenerated `src/generated/api.d.ts` (#4669): `GET /v1/fetch` and `POST /v1/fetch` document a
+  second `422` condition. A fetch whose retries were exhausted against the target used to answer
+  `503` with code `internal_error` and the message "Fetch service unavailable.", which read as an
+  outage of the API; it now answers `422` with code `blocked` when the target's bot protection
+  refused every attempt and `upstream_error` (message "Failed to fetch URL.") otherwise, and it is
+  still charged nothing. A client that matched that `503` must match `422` and the code instead;
+  the `503` `internal_error` remains only for a deployment whose fetch service endpoint or
+  internal token is not configured.
+  Doc comments only; no SDK signature moves.
+
+## [0.11.2] - 2026-09-18
+
+### Changed
+
+- Regenerated `src/generated/api.d.ts` (#4582): bulk item `billing` is `BillingNode | null`.
+- Regenerated `src/generated/api.d.ts` (#4584): `POST /v1/schema` now rejects slow-path
+  rendering options (`wait_until=networkidle`, `delay_ms`, `wait_for_selector`, cookies, custom
+  headers) with error code `unsupported_option` instead of `unsupported_url`, still HTTP 400.
+  `unsupported_url` is removed from the API and has no other emitter; a client matching on it
+  must match `unsupported_option` for this case. Doc comments only; no SDK signature moves.
+
 ## [0.11.1] - 2026-09-17
 
 ### Changed

package/dist/generated/api.d.ts

@@ -637,7 +637,7 @@ export interface paths {
          * @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`, `delay_ms`,
-         *     `wait_for_selector`) cause a `400 unsupported_url`.
+         *     `wait_for_selector`) cause a `400 unsupported_option`.
          *
          *     Dual-axis billing: a fixed per-request credit charge **plus** the
          *     underlying page's bandwidth, billed exactly like `/v1/scrape`. The
@@ -4110,7 +4110,23 @@ export interface operations {
                 };
             };
             402: components["responses"]["PaymentRequired"];
-            /** @description Validation error (e.g. slow-path-only field). */
+            /**
+             * @description Validation error (e.g. slow-path-only field), or a fetch that failed for a
+             *     target-side reason.
+             *
+             *     Two distinct conditions answer `422`. Read `error.code` to tell them apart.
+             *
+             *     - **`validation_error`** — the request itself was rejected.
+             *     - **`blocked`** or **`upstream_error`** — the fetch ran and the target could not
+             *       be read. `blocked` means the target's bot protection refused every attempt;
+             *       `upstream_error` (message `Failed to fetch URL.`) is any other exhausted-retries
+             *       failure, such as a host that does not resolve. This is a result about the URL,
+             *       not an outage of this API, so it is a `4xx` rather than `502` or `503`. No
+             *       upstream HTTP status was received, so `error.http_status` reports `422`,
+             *       mirroring what was served — unlike the relayed `upstream_error` under `502`
+             *       below, whose status is the target's own. The request transfers no billable
+             *       bytes and is charged nothing (#4669).
+             */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -4157,10 +4173,12 @@ export interface operations {
              *       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).
+             *     - **`internal_error`** (message `Fetch service unavailable.`) — no fetch service
+             *       endpoint could be resolved on this deployment, a fault of this API and not of the
+             *       target. 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). A fetch that ran and failed for a target-side reason
+             *       answers `422` instead (#4669).
              */
             503: {
                 headers: {
@@ -4236,7 +4254,23 @@ export interface operations {
                 };
             };
             402: components["responses"]["PaymentRequired"];
-            /** @description Validation error (e.g. malformed JSON, unsupported fetch format, or slow-path-only field). */
+            /**
+             * @description Validation error (e.g. malformed JSON, unsupported fetch format, or slow-path-only
+             *     field), or a fetch that failed for a target-side reason.
+             *
+             *     Two distinct conditions answer `422`. Read `error.code` to tell them apart.
+             *
+             *     - **`validation_error`** — the request itself was rejected.
+             *     - **`blocked`** or **`upstream_error`** — the fetch ran and the target could not
+             *       be read. `blocked` means the target's bot protection refused every attempt;
+             *       `upstream_error` (message `Failed to fetch URL.`) is any other exhausted-retries
+             *       failure, such as a host that does not resolve. This is a result about the URL,
+             *       not an outage of this API, so it is a `4xx` rather than `502` or `503`. No
+             *       upstream HTTP status was received, so `error.http_status` reports `422`,
+             *       mirroring what was served — unlike the relayed `upstream_error` under `502`
+             *       below, whose status is the target's own. The request transfers no billable
+             *       bytes and is charged nothing (#4669).
+             */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -4283,10 +4317,12 @@ export interface operations {
              *       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).
+             *     - **`internal_error`** (message `Fetch service unavailable.`) — no fetch service
+             *       endpoint could be resolved on this deployment, a fault of this API and not of the
+             *       target. 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). A fetch that ran and failed for a target-side reason
+             *       answers `422` instead (#4669).
              */
             503: {
                 headers: {
@@ -5078,10 +5114,12 @@ export interface operations {
                             credits_charged?: number | null;
                             /**
                              * @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.
+                             *     that composed the multiplier, and the resulting billed bytes. `null`
+                             *     while `status` is not `completed` — the charge is not final yet, and
+                             *     the key is present so an item keeps the same shape on every poll.
+                             *     Omitted for rows that completed before the billing node was persisted.
                              */
-                            billing?: components["schemas"]["BillingNode"];
+                            billing?: components["schemas"]["BillingNode"] | null;
                             error_code: string | null;
                             /** @description Bounded human-readable failure detail. */
                             error_message: string | null;
@@ -5781,7 +5819,7 @@ export interface operations {
                     };
                 };
             };
-            /** @description Invalid URL (`invalid_url`), unsupported model (`unsupported_model`), or slow-path URL (`unsupported_url`). */
+            /** @description Invalid URL (`invalid_url`), unsupported model (`unsupported_model`), or unsupported slow-path option (`unsupported_option`). */
             400: {
                 headers: {
                     [name: string]: unknown;

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

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

package/package.json

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