litescrape-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Litescrape
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,283 @@
+# litescrape-sdk
+
+TypeScript and JavaScript SDK for the [Litescrape API](https://litescrape.com): validated,
+concurrent, retrying calls to all 34 search, maps, reviews, Google Play, and Apple App Store
+endpoints, with results returned in input order.
+
+Follows the contracts and behavior of the [Python SDK](https://github.com/litescrape/litescrape-sdk)
+v0.5.2. Supports Node.js 22.13+ with ESM, CommonJS, and TypeScript declarations. This is a
+server-side SDK: keep your API key on the server.
+
+Until the first npm release, install from GitHub with an account that has repository access
+(npm builds the package during installation):
+
+```sh
+npm install git+https://github.com/litescrape/litescrape-sdk-ts.git
+```
+
+After publication, the npm package name is `litescrape-sdk`:
+
+```sh
+npm install litescrape-sdk
+```
+
+```typescript
+import { GoogleMaps, scrape } from "litescrape-sdk";
+
+// Set LITESCRAPE_API_KEY in your environment, or pass { apiKey: "ls_live_..." }.
+const results = await scrape([
+  { endpoint: "google_search", q: "coffee grinders", gl: "us" },
+  new GoogleMaps({ q: "coffee", type: "search", ll: "@40.745,-73.988,14z" }),
+]);
+
+for (const result of results) {
+  console.log(result.ok, result.data ?? result.error);
+}
+```
+
+CommonJS: `const { GoogleMaps, scrape } = require("litescrape-sdk");`.
+All network calls return promises. `ascrape` is an alias of `scrape`.
+
+## Requests and results
+
+Pass plain objects with an `endpoint` discriminator or construct typed request objects such as
+`new GoogleSearch({ q: "coffee" })`. Constructors and `scrape` validate at runtime; unknown
+parameters, invalid values, missing required fields, and incompatible parameter combinations
+are rejected. Every input is validated before the first HTTP call. A `ValidationError` contains
+`problems`, an array of `[inputIndex, message]` pairs. `parseRequest(unknown)` validates external input.
+
+`REQUEST_TYPES` maps every endpoint slug to its request constructor. Constructors expose `path`
+and `parameters`; instances expose immutable normalized fields, `path`, and `queryParams()`.
+Use strings or `bigint` for numeric IDs larger than JavaScript's safe integer range. Store IDs
+are strictly strings, matching the Python Store contracts.
+
+Each `Result` has `index`, `request`, `ok`, `data`, `error`, `statusCode`, `requestId`, `attempts`,
+`elapsed` (seconds), and `jobId` (empty outside batch mode). `raiseForError()` throws the error or
+returns the data. Response data is a `Record<string, unknown>`; provider response fields are not
+validated or discarded.
+
+The Python names `query_params()`, `raise_for_error()`, `status_code`, `request_id`, `job_id`,
+`error_code`, and `retry_after` are also available. SDK options use camelCase; provider parameters
+retain their API spelling, such as `place_id`, `fast_mode`, and `safeSearch`.
+
+```typescript
+import { keyStatus } from "litescrape-sdk";
+
+const status = await keyStatus(); // Unbilled GET /api/keys/status
+console.log(status.remaining_calls, status.concurrency_limit);
+```
+
+`key_status` and `akey_status` are aliases of `keyStatus` and take the same options object.
+
+## Options
+
+```typescript
+await scrape(requests, {
+  apiKey: process.env.LITESCRAPE_API_KEY,
+  baseUrl: "https://api.litescrape.com",
+  attempts: 5,
+  concurrency: 10,
+  timeout: 120,
+  requestTimeout: 15,
+  signal: AbortSignal.timeout(60_000),
+  onProgress: (completed, total, result) => console.log(completed, total, result.ok),
+});
+```
+
+| Option           | Default                                              | Meaning                                                                                                                        |
+| ---------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `apiKey`         | `LITESCRAPE_API_KEY`                                 | Bearer key.                                                                                                                    |
+| `baseUrl`        | `LITESCRAPE_API_URL` or `https://api.litescrape.com` | API URL.                                                                                                                       |
+| `attempts`       | `5`                                                  | Total attempts per HTTP operation; `1` disables retries.                                                                       |
+| `concurrency`    | Key limit, or `25`; batch mode `32`                  | Synchronous calls can lower, never raise, the key limit. Batch submission/poll concurrency is independent of server execution. |
+| `timeout`        | `120`                                                | HTTP transport timeout in seconds for each attempt, including reading its body.                                                |
+| `requestTimeout` | Omitted                                              | Default server deadline in seconds: greater than zero, at most 90.                                                             |
+| `batched`        | `false`                                              | Submit durable server jobs, then poll.                                                                                         |
+| `useCache`       | `false`                                              | Recover saved durable jobs; requires `batched: true`.                                                                          |
+| `cachePath`      | See below                                            | SQLite job cache.                                                                                                              |
+| `signal`         | Omitted                                              | Abort local requests, queued work, retries, and polling.                                                                       |
+| `onProgress`     | Omitted                                              | Called once per result in completion order. Returned results remain in input order.                                            |
+| `fetch`          | Native `fetch`                                       | Custom fetch-compatible transport, including for tests.                                                                        |
+
+There is no automatic terminal progress bar. `keyStatus` accepts `apiKey`, `baseUrl`, `attempts`,
+`timeout`, `signal`, and `fetch`.
+
+Before synchronous scrapes, the SDK checks the key's balance and concurrency limit. Too few
+remaining calls raises `PaymentRequiredError` before scraping. Overlapping `scrape` calls in the
+same Node.js runtime share the key limit. Worker threads and separate processes have independent
+limits. The server remains the final authority on concurrency.
+
+Retries cover connection failures, transport timeouts, unusable success bodies, HTTP 429/5xx,
+retryable envelopes, and the Python SDK's transient-capacity error codes. Other 400/401/402/403/404/422
+responses are not retried unless the API explicitly marks them retryable. Backoff grows exponentially
+with jitter and honors `Retry-After`, capped at 30 seconds. A 401, 402, or `api_key_disabled` error stops
+unsent synchronous work. Each affected item still gets a `Result`.
+
+Per-item failures appear as `Result.error`. Setup/status failures reject the entire call. Exported
+errors are `LitescrapeError`, `ValidationError`, `TransportError`, `APIError`, `AuthenticationError`,
+`PaymentRequiredError`, `NotFoundError`, `RateLimitError`, and `RequestDeadlineExceededError`.
+API errors preserve `statusCode`, `errorCode`, `requestId`, `retryable`, `retryAfter`, and `body`.
+Cancellation rejects with the abort signal's reason. A thrown `onProgress` callback rejects the call;
+avoid throwing from progress callbacks.
+
+Only successful API attempts are billed. A synchronous response lost in transit may already have
+been billed, and retrying can incur another charge. Use durable batches for idempotent submission.
+
+## Durable batches and recovery
+
+Requires an API deployment with durable batch support. The SDK saves the entire workload's
+submission intentions and batch IDs in a SQLite transaction before sending the first input, saves
+acknowledged job IDs, submits all inputs, and then polls. Accepted jobs keep running if your process
+exits or your connection drops. Results are retained for 24 hours after completion.
+
+```typescript
+import { GoogleSearch, scrape } from "litescrape-sdk";
+
+const queries = [new GoogleSearch({ q: "coffee grinders" }), new GoogleSearch({ q: "espresso machines" })];
+const options = { batched: true, cachePath: "./my-batch.sqlite3" };
+const results = await scrape(queries, options);
+
+// After a crash or disconnect, rerun with the same inputs, key, and cache path:
+const recovered = await scrape(queries, { ...options, useCache: true });
+for (const result of recovered) console.log(result.jobId, result.data ?? result.error);
+```
+
+`useCache: false` creates fresh jobs. `useCache: true` matches by API key, API URL, endpoint, normalized
+parameters, and the occurrence number of duplicate inputs. Distinct inputs can be reordered.
+Submission retries and recovery after a lost acknowledgement reuse their idempotency key and batch
+ID. Replacements are created only after the server confirms a job is missing or expired; a polling
+outage does not authorize another charge. Keep separate cache files for independently resumable batches.
+
+The default cache is `~/.cache/litescrape/jobs-ts.sqlite3`, overridden by `LITESCRAPE_JOB_CACHE` or
+`cachePath`. It stores request fingerprints and job/submission IDs, without raw API keys, query text,
+or responses. The TypeScript and Python cache files are separate and are not interchangeable.
+Batch storage uses Node's built-in [SQLite module](https://nodejs.org/api/sqlite.html), which may emit
+an experimental-feature warning on Node 22/24. No native npm add-on is needed.
+
+New jobs reserve one credit; terminal failures refund that reservation. Polling and retrying the same
+submission do not consume more credits. Batch mode skips the synchronous balance check, so previously
+paid jobs can be recovered with zero credits. Check each result for submission errors, including
+insufficient credits. `attempts` controls submission/poll transport retries; provider retries and
+execution capacity are managed by the server. `Result.attempts` reports the final HTTP operation's
+attempt count, matching Python; it is not a sum of polls or server worker attempts.
+
+## Google Search fast mode and request deadlines
+
+`new GoogleSearch({ q: "coffee", fast_mode: true })` requests organic results plus metadata and
+parameters. It skips AI Overview and other response groups. The default returns the full response;
+fast mode is unavailable on `GoogleAiOverview`.
+
+```typescript
+import { GoogleSearch, RequestDeadlineExceededError, scrape } from "litescrape-sdk";
+
+const [result] = await scrape([new GoogleSearch({ q: "coffee grinders", timeout: 10 })], {
+  requestTimeout: 15,
+  attempts: 1,
+});
+if (result.error instanceof RequestDeadlineExceededError) {
+  console.log(result.error.requestId, result.error.retryable, result.error.message);
+} else {
+  console.log(result.raiseForError());
+}
+```
+
+An item's `timeout` overrides `requestTimeout`; both accept fractional seconds greater than zero
+and at most 90. The server deadline covers each synchronous attempt from gateway receipt through
+admission, scraping, and billing. Expiry returns HTTP 503 `request_deadline_exceeded`, is retryable,
+and that attempt is not charged. In batch mode it limits each worker attempt after queueing.
+
+SDK queueing, the status check, transport, backoff, and the full workload are outside that server
+deadline. The SDK option `timeout` remains the HTTP transport timeout; keep it longer than the server
+deadline. A `TransportError` alone does not establish whether an attempt was billed.
+
+## Endpoints
+
+| Request class               | Endpoint slug                   |
+| --------------------------- | ------------------------------- |
+| `GoogleSearch`              | `google_search`                 |
+| `GoogleAiOverview`          | `google_ai_overview`            |
+| `GoogleAiMode`              | `google_ai_mode`                |
+| `GoogleAds`                 | `google_ads`                    |
+| `GoogleShopping`            | `google_shopping`               |
+| `GoogleShoppingProduct`     | `google_shopping_product`       |
+| `GoogleLocal`               | `google_local`                  |
+| `GoogleMaps`                | `google_maps`                   |
+| `GoogleMapsLiveFootTraffic` | `google_maps_live_foot_traffic` |
+| `GoogleMapsPosts`           | `google_maps_posts`             |
+| `GoogleMapsPhoto`           | `google_maps_photo`             |
+| `GoogleMapsWebResults`      | `google_maps_web_results`       |
+| `GoogleReviews`             | `google_reviews`                |
+| `GoogleContributorReviews`  | `google_contributor_reviews`    |
+| `BingSearch`                | `bing_search`                   |
+| `BingMaps`                  | `bing_maps`                     |
+| `DuckDuckGoSearch`          | `duckduckgo_search`             |
+| `DuckDuckGoMaps`            | `duckduckgo_maps`               |
+| `YelpSearch`                | `yelp_search`                   |
+| `YelpReviews`               | `yelp_reviews`                  |
+| `TripadvisorSearch`         | `tripadvisor_search`            |
+| `TripadvisorPlace`          | `tripadvisor_place`             |
+| `TripadvisorReviews`        | `tripadvisor_reviews`           |
+| `AppleMapsPlaces`           | `apple_maps_places`             |
+| `AppleMapsReviews`          | `apple_maps_reviews`            |
+| `GooglePlayApps`            | `google_play_apps`              |
+| `GooglePlayGames`           | `google_play_games`             |
+| `GooglePlayBooks`           | `google_play_books`             |
+| `GooglePlayMovies`          | `google_play_movies`            |
+| `GooglePlayProduct`         | `google_play_product`           |
+| `GooglePlayReviews`         | `google_play_reviews`           |
+| `AppleAppStoreSearch`       | `apple_app_store_search`        |
+| `AppleAppStoreProduct`      | `apple_app_store_product`       |
+| `AppleAppStoreReviews`      | `apple_app_store_reviews`       |
+
+## Store APIs (Alpha)
+
+All nine Store operations use your existing key. Fields depend on the storefront's response.
+
+```typescript
+import { GooglePlayApps, GooglePlayProduct, AppleAppStoreSearch, scrape } from "litescrape-sdk";
+
+const results = await scrape([
+  new GooglePlayApps({ q: "coffee", hl: "en", gl: "us" }),
+  new GooglePlayProduct({ product_id: "com.duolingo" }),
+  new AppleAppStoreSearch({ term: "coffee", country: "us", num: 10 }),
+]);
+```
+
+Follow `litescrape_pagination.next` or use returned continuation tokens with the same operation and
+parameters. Google Play's `chart`, `next_page_token`, `section_page_token`, and `see_more_token` are
+mutually exclusive. Queries exclude category filters and charts. Apps/games charts require an omitted
+device or `store_device: "phone"`; omit `store_device` with a query or category. Games queries use shared
+Android app search; omit `q` or choose `games_category` to browse games.
+
+Search text is limited to 2,048 UTF-8 bytes; Apple terms also have a 4,096 URL-encoded-byte limit.
+Apple review pages start at one; exhausted pages return an empty list. Successful pages consume one
+call. `search_metadata.raw_file` and `prettify_file`, when present, link to authenticated response
+artifacts. Download them with the same bearer key; downloads are unbilled.
+
+See the [API reference](https://litescrape.com/docs) for provider parameters and response groups.
+
+## Development and releases
+
+```sh
+npm ci
+npm run check
+npm pack
+npm run test:package
+```
+
+`npm run format` formats the source. Tests use local mock transports and a loopback HTTP server;
+they require no API key or paid requests. The tests include all 34 endpoint allowlists, the Python
+SDK's 547 Store boundary cases, recovery/idempotency scenarios, cancellation, ESM/CommonJS consumers,
+and positive/negative TypeScript type checks. CI runs on Linux and Windows, including Node 22.13,
+22, 24, and 26. The package smoke test installs the tarball into a fresh consumer without build scripts.
+
+Update both `package.json` and `src/version.ts` for a release; regenerate the lockfile. A `v*` tag
+triggers tests, package verification, and the publish workflow, which requires the tag to match the
+package version. No tag or npm release is created by normal pushes.
+
+Before the first automated release, publish the initial package with an authorized npm account,
+then configure [npm trusted publishing](https://docs.npmjs.com/trusted-publishers/) for GitHub repository
+`litescrape/litescrape-sdk-ts`, workflow `publish.yml`, and environment `npm`. Configure that GitHub
+environment as desired. Subsequent tagged releases use OIDC; no npm token is stored in this
+repository. The workflow enables provenance when the source repository is public and disables it
+while the repository is private, as required by npm.

package/dist/cjs/batch.d.ts

@@ -0,0 +1,12 @@
+import type { AnyRequest } from "./models.js";
+import { Result } from "./result.js";
+import { type RuntimeOptions } from "./runtime.js";
+interface BatchOptions extends RuntimeOptions {
+    concurrency?: number;
+    useCache: boolean;
+    cachePath?: string;
+    onResult: (result: Result) => void;
+}
+export declare function runBatch(items: readonly AnyRequest[], options: BatchOptions): Promise<Result[]>;
+export {};
+//# sourceMappingURL=batch.d.ts.map

package/dist/cjs/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/batch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,UAAU,YAAa,SAAQ,cAAc;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAGD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuIrG"}

package/dist/cjs/batch.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBatch = runBatch;
+const errors_js_1 = require("./errors.js");
+const cache_js_1 = require("./cache.js");
+const result_js_1 = require("./result.js");
+const runtime_js_1 = require("./runtime.js");
+async function runBatch(items, options) {
+    options.signal?.throwIfAborted();
+    const cache = new cache_js_1.JobCache(options.cachePath);
+    const keys = (0, cache_js_1.cacheKeys)(items, options.apiKey, options.baseUrl);
+    const limit = options.concurrency ?? 32;
+    const semaphores = [new runtime_js_1.Semaphore(limit)];
+    const started = performance.now();
+    const batchKey = (0, cache_js_1.newId)();
+    const indices = items.map((_, i) => i);
+    const results = new Array(items.length);
+    try {
+        const entries = cache.prepareMany(keys, options.useCache, batchKey, items.length);
+        const pollOnce = (jobId) => (0, runtime_js_1.requestWithRetries)(`/api/batch/jobs/${encodeURIComponent(jobId)}`, { ...options, semaphores });
+        const replace = (index) => cache.prepareMany([keys[index]], false, batchKey, items.length)[0];
+        const submit = async (index, replaceExpired = false) => {
+            let entry = replaceExpired ? replace(index) : entries[index];
+            if (entry.job_id) {
+                const outcome = await pollOnce(entry.job_id);
+                // Only positive evidence of expiry/missing jobs permits a fresh reservation.
+                if ((!outcome.error && outcome.data?.state !== "expired") ||
+                    (outcome.error && ![404, 410].includes(outcome.statusCode ?? 0)))
+                    return { entry, outcome };
+                entry = replace(index);
+            }
+            const outcome = await (0, runtime_js_1.requestWithRetries)(items[index].path + "/async", {
+                ...options,
+                semaphores,
+                method: "POST",
+                body: items[index].queryParams(),
+                acceptedStatuses: [200, 202],
+                headers: {
+                    "Idempotency-Key": entry.submission,
+                    "X-Litescrape-Batch-ID": entry.batch_key,
+                    "X-Litescrape-Batch-Size": String(entry.batch_size),
+                },
+            });
+            if (!outcome.error) {
+                const job = outcome.data;
+                if (typeof job.job_id !== "string" || !job.job_id)
+                    outcome.error = new errors_js_1.TransportError("Batch submission returned no job ID.", { retryable: true });
+                else {
+                    entry.job_id = job.job_id;
+                    cache.save(keys[index], entry.submission, job.job_id, job.expires_at);
+                    if (job.state === "expired" && options.useCache && !replaceExpired)
+                        return submit(index, true);
+                }
+            }
+            return { entry, outcome };
+        };
+        const submissions = new Array(items.length);
+        await (0, runtime_js_1.each)(indices, limit, async (index) => {
+            submissions[index] = await submit(index);
+        });
+        const resolve = (index, { entry, outcome }) => {
+            if (!outcome.error) {
+                const job = outcome.data;
+                if (typeof job.job_id !== "string" || !job.job_id || job.job_id !== entry.job_id) {
+                    outcome.error = new errors_js_1.TransportError("Batch job returned an invalid job ID.", { retryable: false });
+                }
+                else if (job.state === "succeeded" || job.state === "failed") {
+                    const status = job.status_code;
+                    const payload = job.response;
+                    if (typeof status !== "number" ||
+                        !Number.isInteger(status) ||
+                        status < 100 ||
+                        status > 599 ||
+                        !(0, errors_js_1.isObject)(payload) ||
+                        (job.state === "succeeded") !== (status === 200)) {
+                        outcome.error = new errors_js_1.TransportError("Batch job returned an invalid response.", {
+                            retryable: false,
+                        });
+                    }
+                    else {
+                        cache.save(keys[index], entry.submission, job.job_id, job.expires_at);
+                        return new result_js_1.Result(index, items[index], {
+                            data: status === 200 ? payload : null,
+                            error: status === 200 ? null : (0, errors_js_1.apiError)(status, payload),
+                            statusCode: status,
+                            requestId: job.job_id,
+                            attempts: outcome.attempts,
+                        }, (performance.now() - started) / 1000, job.job_id);
+                    }
+                }
+                else if (job.state === "expired") {
+                    outcome.error = new errors_js_1.APIError("The retained batch response expired.", {
+                        statusCode: 410,
+                        errorCode: "job_expired",
+                        requestId: entry.job_id ?? "",
+                    });
+                    outcome.statusCode = 410;
+                }
+                else if (job.state === "queued" || job.state === "running")
+                    return null;
+                else
+                    outcome.error = new errors_js_1.TransportError("Batch job returned an unknown state.", { retryable: false });
+            }
+            return new result_js_1.Result(index, items[index], { ...outcome, data: null, requestId: entry.job_id ?? outcome.requestId }, (performance.now() - started) / 1000, entry.job_id ?? "");
+        };
+        let pending = indices;
+        let polls = 0;
+        while (pending.length) {
+            await (0, runtime_js_1.each)(pending, limit, async (index) => {
+                let result = resolve(index, submissions[index]);
+                if (!result) {
+                    const entry = submissions[index].entry;
+                    submissions[index] = { entry, outcome: await pollOnce(entry.job_id) };
+                    result = resolve(index, submissions[index]);
+                }
+                if (result) {
+                    results[index] = result;
+                    options.onResult(result);
+                }
+            });
+            pending = pending.filter((index) => !results[index]);
+            if (pending.length)
+                await (0, runtime_js_1.sleep)((0, runtime_js_1.backoff)(++polls), options.signal);
+        }
+        return results;
+    }
+    finally {
+        cache.close();
+    }
+}
+//# sourceMappingURL=batch.js.map

package/dist/cjs/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.js","sourceRoot":"","sources":["../../src/batch.ts"],"names":[],"mappings":"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"}

package/dist/cjs/cache.d.ts

@@ -0,0 +1,21 @@
+import type { AnyRequest } from "./models.js";
+export interface CacheEntry {
+    submission: string;
+    job_id: string | null;
+    batch_key: string;
+    batch_size: number;
+}
+export declare const newId: () => string;
+/** Fingerprints include the key, origin, all parameters, and duplicate occurrence. */
+export declare function cacheKeys(items: readonly AnyRequest[], apiKey: string, baseUrl: string): string[];
+/** SQLite FULL commits persist the entire workload before its first POST. */
+export declare class JobCache {
+    readonly path: string;
+    private readonly db;
+    constructor(path?: string);
+    private transaction;
+    prepareMany(keys: readonly string[], useCache: boolean, batchKey: string, batchSize: number): CacheEntry[];
+    save(key: string, submission: string, jobId: string, expiresAt?: unknown): void;
+    close(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cjs/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,eAAO,MAAM,KAAK,QAAO,MAA0C,CAAC;AAGpE,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAejG;AAED,6EAA6E;AAC7E,qBAAa,QAAQ;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;IAElC,YAAY,IAAI,CAAC,EAAE,MAAM,EAyBxB;IAED,OAAO,CAAC,WAAW;IAYnB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAgCzG;IAED,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAK9E;IAED,KAAK,IAAI,IAAI,CAEZ;CACF"}

package/dist/cjs/cache.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobCache = exports.newId = void 0;
+exports.cacheKeys = cacheKeys;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_sqlite_1 = require("node:sqlite");
+const newId = () => (0, node_crypto_1.randomUUID)().replaceAll("-", "");
+exports.newId = newId;
+const hash = (value) => (0, node_crypto_1.createHash)("sha256").update(value).digest("hex");
+/** Fingerprints include the key, origin, all parameters, and duplicate occurrence. */
+function cacheKeys(items, apiKey, baseUrl) {
+    const identity = hash(apiKey);
+    const occurrences = new Map();
+    return items.map((item) => {
+        const params = item.queryParams();
+        const sorted = Object.fromEntries(Object.keys(params)
+            .sort()
+            .map((key) => [key, params[key]]));
+        const canonical = JSON.stringify([identity, baseUrl, item.path, sorted]);
+        const occurrence = occurrences.get(canonical) ?? 0;
+        occurrences.set(canonical, occurrence + 1);
+        return hash(`${canonical}:${occurrence}`);
+    });
+}
+/** SQLite FULL commits persist the entire workload before its first POST. */
+class JobCache {
+    path;
+    db;
+    constructor(path) {
+        this.path = (0, node_path_1.resolve)(path || process.env.LITESCRAPE_JOB_CACHE || (0, node_path_1.join)((0, node_os_1.homedir)(), ".cache", "litescrape", "jobs-ts.sqlite3"));
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(this.path), { recursive: true, mode: 0o700 });
+        this.db = new node_sqlite_1.DatabaseSync(this.path);
+        try {
+            if (process.platform !== "win32")
+                (0, node_fs_1.chmodSync)(this.path, 0o600);
+            this.db.exec(`PRAGMA busy_timeout=30000; PRAGMA journal_mode=WAL; PRAGMA synchronous=FULL;
+        CREATE TABLE IF NOT EXISTS jobs (
+          cache_key TEXT PRIMARY KEY, submission TEXT NOT NULL, job_id TEXT,
+          expires_at TEXT, updated_at REAL NOT NULL
+        );`);
+            this.transaction(() => {
+                const columns = this.db
+                    .prepare("PRAGMA table_info(jobs)")
+                    .all()
+                    .map((row) => row.name);
+                if (!columns.includes("batch_key"))
+                    this.db.exec("ALTER TABLE jobs ADD COLUMN batch_key TEXT");
+                if (!columns.includes("batch_size"))
+                    this.db.exec("ALTER TABLE jobs ADD COLUMN batch_size INTEGER");
+            });
+        }
+        catch (error) {
+            this.db.close();
+            throw error;
+        }
+    }
+    transaction(operation) {
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            const result = operation();
+            this.db.exec("COMMIT");
+            return result;
+        }
+        catch (error) {
+            this.db.exec("ROLLBACK");
+            throw error;
+        }
+    }
+    prepareMany(keys, useCache, batchKey, batchSize) {
+        return this.transaction(() => keys.map((key) => {
+            const row = this.db
+                .prepare("SELECT submission,job_id,batch_key,batch_size FROM jobs WHERE cache_key=?")
+                .get(key);
+            if (useCache && row) {
+                if (!row.batch_key) {
+                    row.batch_key = batchKey;
+                    row.batch_size = batchSize;
+                    this.db
+                        .prepare("UPDATE jobs SET batch_key=?,batch_size=? WHERE cache_key=?")
+                        .run(batchKey, batchSize, key);
+                }
+                return row;
+            }
+            const entry = {
+                submission: (0, exports.newId)(),
+                job_id: null,
+                batch_key: batchKey,
+                batch_size: batchSize,
+            };
+            this.db
+                .prepare(`INSERT INTO jobs(cache_key,submission,updated_at,batch_key,batch_size) VALUES (?,?,?,?,?)
+        ON CONFLICT(cache_key) DO UPDATE SET submission=excluded.submission,job_id=NULL,expires_at=NULL,
+          updated_at=excluded.updated_at,batch_key=excluded.batch_key,batch_size=excluded.batch_size`)
+                .run(key, entry.submission, Date.now() / 1000, batchKey, batchSize);
+            return entry;
+        }));
+    }
+    save(key, submission, jobId, expiresAt) {
+        // A concurrent fresh run can replace a slot; its submission must not be overwritten.
+        this.db
+            .prepare("UPDATE jobs SET job_id=?,expires_at=?,updated_at=? WHERE cache_key=? AND submission=?")
+            .run(jobId, typeof expiresAt === "string" ? expiresAt : null, Date.now() / 1000, key, submission);
+    }
+    close() {
+        this.db.close();
+    }
+}
+exports.JobCache = JobCache;
+//# sourceMappingURL=cache.js.map

package/dist/cjs/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"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"}