@hunt-labs/bytekit-cli 0.9.4 → 0.10.1

package/CHANGELOG.md

@@ -10,6 +10,24 @@ today, see [README.md](./README.md), which remains the authoritative usage guide
 
 ## [Unreleased]
 
+## [0.10.1] - 2026-09-24
+
+### Changed
+
+- A `/v1/search` provider failure now arrives at HTTP `503` instead of `502` (#4891): Cloudflare
+  replaced the API's `502` body with its own plain-text page, so the `search_provider_error` code
+  never reached the CLI. The body is unchanged and the CLI already reads it by shape, not status;
+  only a source comment changed in this package.
+
+## [0.10.0] - 2026-09-14
+
+### Added
+
+- `--solve-challenge` on `scrape create` (#4449). It sends `solve_challenge: true`, which asks
+  the scrape to attempt to clear a Cloudflare challenge; success is not guaranteed. It is billed
+  as a normal browser render. Without the flag the request body is unchanged and carries no
+  `solve_challenge` key.
+
 ## [0.9.4] - 2026-09-10
 
 ### Added

package/README.md

@@ -129,6 +129,7 @@ materialized):
 | `--include-tags <csv>`                                 | Comma-separated HTML tags to keep.                                                                                                                                                  |
 | `--exclude-tags <csv>`                                 | Comma-separated HTML tags to drop.                                                                                                                                                  |
 | `--mobile`                                             | Render with a mobile viewport/user-agent.                                                                                                                                           |
+| `--solve-challenge`                                    | Attempt to clear a Cloudflare challenge; success is not guaranteed. Billed as a normal browser render.                                                                              |
 | `--async`                                              | Queue the scrape and return a job envelope immediately.                                                                                                                             |
 | `--webhook-url <url>`                                  | Webhook notified when an async scrape completes.                                                                                                                                    |
 

package/dist/client.js

@@ -224,8 +224,8 @@ function drainBestEffort(body, abort) {
  *
  * Two error-body shapes exist across the API:
  *   - the canonical unified envelope `{error: {code, message}}` — tested FIRST, so it always wins;
- *   - a flat vendor-masked shape `{error: "<code>"}` (e.g. `/v1/search` 502:
- *     `{"error":"search_provider_error"}`, docs/api/openapi.yaml §/v1/search 502) — the flat form
+ *   - a flat vendor-masked shape `{error: "<code>"}` (e.g. `/v1/search` 503:
+ *     `{"error":"search_provider_error"}`, docs/api/openapi.yaml §/v1/search 503) — the flat form
  *     is strictly a FALLBACK and can never override an envelope (#2541, mirrored here for #2586:
  *     the CLI's own copy of this parser had drifted from the SDK's and still only read the
  *     envelope shape, so a flat 502 rendered `internal_error` instead of `search_provider_error`).

package/dist/commands/scrape.js

@@ -154,6 +154,7 @@ export function makeScrapeCommand(getGlobal) {
         .option('--include-tags <csv>', 'Comma-separated HTML tags to keep (e.g. article,main)')
         .option('--exclude-tags <csv>', 'Comma-separated HTML tags to drop (e.g. nav,footer)')
         .option('--mobile', 'Render with a mobile viewport/user-agent')
+        .option('--solve-challenge', 'Attempt to clear a Cloudflare challenge; success is not guaranteed. Billed as a normal browser render.')
         .option('--raw', 'Print the requested format body raw, with no JSON wrapper')
         .option('-o, --output <file>', 'Write the output to the given file path (implies --raw unless --json is set)')
         .action(async (opts) => {
@@ -221,6 +222,8 @@ export function makeScrapeCommand(getGlobal) {
             body['exclude_tags'] = parseCsv(opts.excludeTags);
         if (opts.mobile === true)
             body['mobile'] = true;
+        if (opts.solveChallenge === true)
+            body['solve_challenge'] = true;
         try {
             // Inside the try: buildClient() throws on a missing key (#2686 item 4) and the throw must reach handleError(). See its doc comment in client.ts.
             const client = buildClient(g);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunt-labs/bytekit-cli",
-  "version": "0.9.4",
+  "version": "0.10.1",
   "description": "ByteKit CLI — wraps @hunt-labs/bytekit-sdk as shell subcommands",
   "license": "MIT",
   "type": "module",
@@ -41,7 +41,7 @@
   ],
   "dependencies": {
     "commander": "^12.0.0",
-    "@hunt-labs/bytekit-sdk": "^0.10.0"
+    "@hunt-labs/bytekit-sdk": "^0.11.6"
   },
   "scripts": {
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",