@hunt-labs/bytekit-sdk 0.11.11 → 0.11.12

package/CHANGELOG.md

@@ -10,6 +10,23 @@ today, see [README.md](./README.md), which remains the authoritative usage guide
 
 ## [Unreleased]
 
+## [0.11.12] - 2026-10-20
+
+### Added
+
+- **`ScrapeJsonFormat` is now exported from the package entry (#5455).** The type of the
+  `{ type: 'json', schema, model?, prompt? }` entry in `ScrapeOpts['formats']`, which the
+  `scrape.create` reference already names, was module-private; it now imports from
+  `@hunt-labs/bytekit-sdk`. Type-only; no runtime or method signature moves.
+
+### Changed
+
+- **`artifact_warnings` on a `/v1/bulk/{id}/screenshots` scrape item now documents the extraction
+  warnings (#5458).** The field also carries the `json` extraction's own warning codes
+  (whether or not the output validated), after any `artifact_unavailable` entry; its description said it reported
+  artifact reference failures only. Regenerated `src/generated/api.d.ts`; description text only,
+  no SDK method signature moves.
+
 ## [0.11.11] - 2026-10-14
 
 ### Changed

package/dist/generated/api.d.ts

@@ -5716,7 +5716,7 @@ export interface operations {
                             markdown?: string | null;
                             /** @description `type: scrape` only. Pre-signed download URL for the markdown rendering of the page, valid for 600 seconds (10 minutes) from the moment this response was generated — the same signing TTL as `content_url` and `image_url` above. A new signature is minted on every poll for a completed item with a markdown key. For every other item the stored value is returned unchanged — `null` while no markdown has been stored, and otherwise a private, unsigned storage URL that returns 401 on download. No `artifact_warnings` entry is raised for this field; unlike `GET /v1/fetch/bulk/{id}`, this endpoint reports no `artifact_unavailable` when signing fails. */
                             markdown_url?: string | null;
-                            /** @description `type: scrape` only. Exact requested artifact values or signed references. `raw`, `markdown`, `links` and `images` are always present; unrequested or unavailable values are null, with nonfatal reference failures in `artifact_warnings`. `json` is present only on an item that requested a `json` format. */
+                            /** @description `type: scrape` only. Exact requested artifact values or signed references. `raw`, `markdown`, `links` and `images` are always present; unrequested or unavailable values are null, with nonfatal warnings in `artifact_warnings`. `json` is present only on an item that requested a `json` format. */
                             artifacts?: {
                                 raw: string | null;
                                 markdown: string | null;
@@ -5727,7 +5727,7 @@ export interface operations {
                                 links: null | (string | components["schemas"]["ScrapeScoredLink"])[];
                                 images: null | (string | components["schemas"]["ScrapeScoredImage"])[];
                             };
-                            /** @description Nonfatal artifact reference failures for this scrape item. */
+                            /** @description Nonfatal warnings for this scrape item. An `artifact_unavailable` entry reports a requested artifact whose reference failed, and comes first. For a `json` format, the extraction's own warning codes follow, with `element: null`, whether or not the output validated (`content_truncated` can accompany a validated result); `artifacts.json` is still returned as stored. */
                             artifact_warnings?: components["schemas"]["ScrapeWarning"][];
                         } | {
                             /** @description Prefixed id — `ss_` / `rec_` / `sc_` per `type`. The same stable identity the ordinary item carries. */

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 { ScrapeOpts, MarkdownMode, MarkdownLinks, MarkdownImages, TokenEncoding, ScrapeCreateResponse, ScrapeGetResponse, ScrapeBulkCreateRequest, ScrapeBulkCreateResponse, ScrapeBulkGetResponse, } from './resources/scrape.js';
+export type { ScrapeOpts, MarkdownMode, MarkdownLinks, MarkdownImages, TokenEncoding, ScrapeJsonFormat, 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/scrape.d.ts

@@ -49,7 +49,7 @@ export type MarkdownImages = 'inline' | 'references' | 'none' | 'text';
 /** Tokenizer encoding hint for `token_budget`. */
 export type TokenEncoding = 'cl100k_base' | 'o200k_base';
 /** The `{ type: 'json', schema }` entry of `formats`, typed from the spec. */
-type ScrapeJsonFormat = components['schemas']['ScrapeRequestJsonFormat'];
+export type ScrapeJsonFormat = components['schemas']['ScrapeRequestJsonFormat'];
 /** Options for POST /v1/scrape. */
 export interface ScrapeOpts {
     url: string;

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

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

package/package.json

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