@hunt-labs/bytekit-sdk 0.1.0

package/dist/allowlist.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Canonical list of SDK methods included in the v0.1 public surface.
+ *
+ * Derived from operations annotated with `x-sdk-scope: v0.1` in
+ * docs/api/openapi.yaml. The parity test (src/parity.test.ts) enforces
+ * bidirectional coverage: every spec operation must appear here, and every
+ * entry here must appear in the spec.
+ *
+ * To add a method: annotate the operation in the spec first, then add it here.
+ */
+export declare const V01_METHODS: readonly ["scrape.create", "scrape.get", "screenshots.create", "screenshots.get", "bulk.create", "bulk.get", "bulk.cancel", "bulk.screenshots.list", "scrape.bulk.create", "scrape.bulk.get", "fetch.create", "fetch.get", "fetch.bulk.create", "fetch.bulk.get", "monitors.create", "monitors.list", "monitors.get", "monitors.update", "monitors.delete", "monitors.captures.list", "sitemap.create", "sitemap.get", "search.query", "account.get"];
+export type V01Method = (typeof V01_METHODS)[number];
+//# sourceMappingURL=allowlist.d.ts.map

package/dist/allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../src/allowlist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,ubA0Bd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/allowlist.js

@@ -0,0 +1,38 @@
+/**
+ * Canonical list of SDK methods included in the v0.1 public surface.
+ *
+ * Derived from operations annotated with `x-sdk-scope: v0.1` in
+ * docs/api/openapi.yaml. The parity test (src/parity.test.ts) enforces
+ * bidirectional coverage: every spec operation must appear here, and every
+ * entry here must appear in the spec.
+ *
+ * To add a method: annotate the operation in the spec first, then add it here.
+ */
+export const V01_METHODS = [
+    'scrape.create',
+    'scrape.get',
+    'screenshots.create',
+    'screenshots.get',
+    // recordings.create / recordings.get removed — endpoint deactivated (issue #1762).
+    'bulk.create',
+    'bulk.get',
+    'bulk.cancel',
+    'bulk.screenshots.list',
+    'scrape.bulk.create',
+    'scrape.bulk.get',
+    'fetch.create',
+    'fetch.get',
+    'fetch.bulk.create',
+    'fetch.bulk.get',
+    'monitors.create',
+    'monitors.list',
+    'monitors.get',
+    'monitors.update',
+    'monitors.delete',
+    'monitors.captures.list',
+    'sitemap.create',
+    'sitemap.get',
+    'search.query',
+    'account.get',
+];
+//# sourceMappingURL=allowlist.js.map

package/dist/allowlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.js","sourceRoot":"","sources":["../src/allowlist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe;IACf,YAAY;IACZ,oBAAoB;IACpB,iBAAiB;IACjB,mFAAmF;IACnF,aAAa;IACb,UAAU;IACV,aAAa;IACb,uBAAuB;IACvB,oBAAoB;IACpB,iBAAiB;IACjB,cAAc;IACd,WAAW;IACX,mBAAmB;IACnB,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,wBAAwB;IACxB,gBAAgB;IAChB,aAAa;IACb,cAAc;IACd,aAAa;CACL,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+import { ScrapeResource } from './resources/scrape.js';
+import { ScreenshotsResource } from './resources/screenshots.js';
+import { RecordingsResource } from './resources/recordings.js';
+import { BulkResource } from './resources/bulk.js';
+import { FetchResource } from './resources/fetch.js';
+import { MonitorsResource } from './resources/monitors.js';
+import { SitemapResource } from './resources/sitemap.js';
+import { SearchResource } from './resources/search.js';
+import { AccountResource } from './resources/account.js';
+export interface RapidCrawlOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+/** Thrown when the API responds with a 4xx or 5xx status code. */
+export declare class RapidCrawlError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export declare class RapidCrawl {
+    private readonly apiKey;
+    private readonly baseUrl;
+    readonly scrape: ScrapeResource;
+    readonly screenshots: ScreenshotsResource;
+    readonly recordings: RecordingsResource;
+    readonly bulk: BulkResource;
+    readonly fetch: FetchResource;
+    readonly monitors: MonitorsResource;
+    readonly sitemap: SitemapResource;
+    readonly search: SearchResource;
+    readonly account: AccountResource;
+    constructor(options: RapidCrawlOptions);
+    /**
+     * Make an authenticated JSON request to the RapidCrawl API.
+     *
+     * Throws `RapidCrawlError` on 4xx/5xx responses.
+     */
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIzD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kEAAkE;AAClE,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1D;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEtB,OAAO,EAAE,iBAAiB;IActC;;;;OAIG;IACG,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CA+B3E"}

package/dist/client.js

@@ -0,0 +1,81 @@
+import { ScrapeResource } from './resources/scrape.js';
+import { ScreenshotsResource } from './resources/screenshots.js';
+import { RecordingsResource } from './resources/recordings.js';
+import { BulkResource } from './resources/bulk.js';
+import { FetchResource } from './resources/fetch.js';
+import { MonitorsResource } from './resources/monitors.js';
+import { SitemapResource } from './resources/sitemap.js';
+import { SearchResource } from './resources/search.js';
+import { AccountResource } from './resources/account.js';
+const DEFAULT_BASE_URL = 'https://api.bytekit.com';
+/** Thrown when the API responds with a 4xx or 5xx status code. */
+export class RapidCrawlError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.name = 'RapidCrawlError';
+        this.status = status;
+        this.code = code;
+    }
+}
+export class RapidCrawl {
+    apiKey;
+    baseUrl;
+    scrape;
+    screenshots;
+    recordings;
+    bulk;
+    fetch;
+    monitors;
+    sitemap;
+    search;
+    account;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.scrape = new ScrapeResource(this);
+        this.screenshots = new ScreenshotsResource(this);
+        this.recordings = new RecordingsResource(this);
+        this.bulk = new BulkResource(this);
+        this.fetch = new FetchResource(this);
+        this.monitors = new MonitorsResource(this);
+        this.sitemap = new SitemapResource(this);
+        this.search = new SearchResource(this);
+        this.account = new AccountResource(this);
+    }
+    /**
+     * Make an authenticated JSON request to the RapidCrawl API.
+     *
+     * Throws `RapidCrawlError` on 4xx/5xx responses.
+     */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const init = {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+        };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, init);
+        if (!response.ok) {
+            let code = 'internal_error';
+            let message = response.statusText;
+            try {
+                const json = (await response.json());
+                code = json.error?.code ?? code;
+                message = json.error?.message ?? message;
+            }
+            catch {
+                // leave defaults
+            }
+            throw new RapidCrawlError(response.status, code, message);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { RapidCrawl, RapidCrawlError } from './client.js';
+export type { RapidCrawlOptions } from './client.js';
+export { V01_METHODS } from './allowlist.js';
+export type { V01Method } from './allowlist.js';
+export type { ScrapeId, ScreenshotId, RecordingId, BulkId, MonitorId, SitemapId, ApiKeyId, SearchType, SearchDateRange, SearchOpts, SearchResult, SearchResultImage, SearchResponse, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,MAAM,EACN,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACV,eAAe,EACf,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { RapidCrawl, RapidCrawlError } from './client.js';
+export { V01_METHODS } from './allowlist.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/resources/account.d.ts

@@ -0,0 +1,33 @@
+import type { RapidCrawl } from '../client.js';
+import type { operations } from '../generated/api.js';
+import type { ApiKeyId } from '../types.js';
+/**
+ * 200 payload of POST /v1/account/api-keys/{id}/reveal — `{ key: string }`.
+ * Derived from the generated OpenAPI types so it stays in sync with the spec.
+ */
+export type RevealApiKeyResponse = operations['revealApiKey']['responses'][200]['content']['application/json'];
+export declare class AccountResource {
+    private readonly client;
+    readonly apiKeys: ApiKeysResource;
+    constructor(client: RapidCrawl);
+    /** GET /v1/account — get the authenticated account */
+    get(): Promise<unknown>;
+}
+declare class ApiKeysResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** POST /v1/account/api-keys — create a new API key */
+    create(opts: Record<string, unknown>): Promise<unknown>;
+    /** GET /v1/account/api-keys — list all API keys for the account */
+    list(): Promise<unknown>;
+    /** GET /v1/account/api-keys/{id} — get an API key by ID */
+    get(id: ApiKeyId): Promise<unknown>;
+    /** PATCH /v1/account/api-keys/{id} — update an API key */
+    update(id: ApiKeyId, opts: Record<string, unknown>): Promise<unknown>;
+    /** DELETE /v1/account/api-keys/{id} — revoke an API key (idempotent) */
+    revoke(id: ApiKeyId): Promise<unknown>;
+    /** POST /v1/account/api-keys/{id}/reveal — reveal the plaintext API key value */
+    reveal(id: ApiKeyId): Promise<RevealApiKeyResponse>;
+}
+export {};
+//# sourceMappingURL=account.d.ts.map

package/dist/resources/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/resources/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC9B,UAAU,CAAC,cAAc,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAE9E,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEL,MAAM,EAAE,UAAU;IAI/C,sDAAsD;IACtD,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;CAGxB;AAED,cAAM,eAAe;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,uDAAuD;IACvD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,mEAAmE;IACnE,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,2DAA2D;IAC3D,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAInC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE,wEAAwE;IACxE,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,iFAAiF;IACjF,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAGpD"}

package/dist/resources/account.js

@@ -0,0 +1,43 @@
+export class AccountResource {
+    client;
+    apiKeys;
+    constructor(client) {
+        this.client = client;
+        this.apiKeys = new ApiKeysResource(client);
+    }
+    /** GET /v1/account — get the authenticated account */
+    get() {
+        return this.client.request('GET', '/v1/account');
+    }
+}
+class ApiKeysResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** POST /v1/account/api-keys — create a new API key */
+    create(opts) {
+        return this.client.request('POST', '/v1/account/api-keys', opts);
+    }
+    /** GET /v1/account/api-keys — list all API keys for the account */
+    list() {
+        return this.client.request('GET', '/v1/account/api-keys');
+    }
+    /** GET /v1/account/api-keys/{id} — get an API key by ID */
+    get(id) {
+        return this.client.request('GET', `/v1/account/api-keys/${id}`);
+    }
+    /** PATCH /v1/account/api-keys/{id} — update an API key */
+    update(id, opts) {
+        return this.client.request('PATCH', `/v1/account/api-keys/${id}`, opts);
+    }
+    /** DELETE /v1/account/api-keys/{id} — revoke an API key (idempotent) */
+    revoke(id) {
+        return this.client.request('DELETE', `/v1/account/api-keys/${id}`);
+    }
+    /** POST /v1/account/api-keys/{id}/reveal — reveal the plaintext API key value */
+    reveal(id) {
+        return this.client.request('POST', `/v1/account/api-keys/${id}/reveal`);
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/resources/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/resources/account.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,eAAe;IAGG;IAFpB,OAAO,CAAkB;IAElC,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QAC7C,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,sDAAsD;IACtD,GAAG;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,eAAe;IACU;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,uDAAuD;IACvD,MAAM,CAAC,IAA6B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,mEAAmE;IACnE,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IAC5D,CAAC;IAED,2DAA2D;IAC3D,GAAG,CAAC,EAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAC,EAAY,EAAE,IAA6B;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,wBAAwB,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,wEAAwE;IACxE,MAAM,CAAC,EAAY;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAwB,EAAE,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,iFAAiF;IACjF,MAAM,CAAC,EAAY;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAuB,MAAM,EAAE,wBAAwB,EAAE,SAAS,CAAC,CAAC;IAChG,CAAC;CACF"}

package/dist/resources/bulk.d.ts

@@ -0,0 +1,21 @@
+import type { RapidCrawl } from '../client.js';
+import type { BulkId } from '../types.js';
+export declare class BulkResource {
+    private readonly client;
+    readonly screenshots: BulkScreenshotsResource;
+    constructor(client: RapidCrawl);
+    /** POST /v1/bulk — create a bulk screenshots job */
+    create(opts: Record<string, unknown>): Promise<unknown>;
+    /** GET /v1/bulk/{id} — get a bulk job status */
+    get(id: BulkId): Promise<unknown>;
+    /** DELETE /v1/bulk/{id} — cancel an in-flight bulk job */
+    cancel(id: BulkId): Promise<unknown>;
+}
+declare class BulkScreenshotsResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** GET /v1/bulk/{id}/screenshots — list screenshots in a bulk job */
+    list(id: BulkId): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=bulk.d.ts.map

package/dist/resources/bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.d.ts","sourceRoot":"","sources":["../../src/resources/bulk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;gBAEjB,MAAM,EAAE,UAAU;IAI/C,oDAAoD;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,gDAAgD;IAChD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrC;AAED,cAAM,uBAAuB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,qEAAqE;IACrE,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGnC"}

package/dist/resources/bulk.js

@@ -0,0 +1,31 @@
+export class BulkResource {
+    client;
+    screenshots;
+    constructor(client) {
+        this.client = client;
+        this.screenshots = new BulkScreenshotsResource(client);
+    }
+    /** POST /v1/bulk — create a bulk screenshots job */
+    create(opts) {
+        return this.client.request('POST', '/v1/bulk', opts);
+    }
+    /** GET /v1/bulk/{id} — get a bulk job status */
+    get(id) {
+        return this.client.request('GET', `/v1/bulk/${id}`);
+    }
+    /** DELETE /v1/bulk/{id} — cancel an in-flight bulk job */
+    cancel(id) {
+        return this.client.request('DELETE', `/v1/bulk/${id}`);
+    }
+}
+class BulkScreenshotsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** GET /v1/bulk/{id}/screenshots — list screenshots in a bulk job */
+    list(id) {
+        return this.client.request('GET', `/v1/bulk/${id}/screenshots`);
+    }
+}
+//# sourceMappingURL=bulk.js.map

package/dist/resources/bulk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk.js","sourceRoot":"","sources":["../../src/resources/bulk.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IAGM;IAFpB,WAAW,CAA0B;IAE9C,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QAC7C,IAAI,CAAC,WAAW,GAAG,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,oDAAoD;IACpD,MAAM,CAAC,IAA6B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,gDAAgD;IAChD,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;CACF;AAED,MAAM,uBAAuB;IACE;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,qEAAqE;IACrE,IAAI,CAAC,EAAU;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/resources/fetch.d.ts

@@ -0,0 +1,55 @@
+import type { RapidCrawl } from '../client.js';
+import type { BulkId } from '../types.js';
+/**
+ * Options for fetch endpoints.
+ *
+ * fetch.create (POST /v1/fetch) and fetch.get (GET /v1/fetch) are NOT
+ * ID-based — they operate directly on URL content.
+ */
+export interface FetchOpts {
+    url: string;
+    format?: string;
+    country?: string;
+    timeout_ms?: number;
+    /**
+     * How long a freshly fetched URL may be served from cache. Matches the
+     * OpenAPI `FetchRequest.cache_ttl` schema: a duration string (`"48h"`,
+     * `"2d"`, up to `168h` / `7d`) or the integer `0` to disable caching.
+     * Defaults to `"48h"` server-side when omitted.
+     */
+    cache_ttl?: string | 0;
+    /**
+     * User-supplied JSON payload, base64-encoded into the `X-Fetch-Custom`
+     * response header so callers can correlate the response to caller-side
+     * state. Capped at 4096 UTF-8 bytes after JSON serialization. Does NOT
+     * affect cache-key inputs.
+     */
+    custom?: Record<string, unknown>;
+}
+export declare class FetchResource {
+    private readonly client;
+    readonly bulk: FetchBulkResource;
+    constructor(client: RapidCrawl);
+    /**
+     * POST /v1/fetch — fetch URL content via POST body.
+     *
+     * Returns content directly (not ID-based).
+     */
+    create(opts: FetchOpts): Promise<unknown>;
+    /**
+     * GET /v1/fetch — fetch URL content via query params.
+     *
+     * Returns content directly (not ID-based).
+     */
+    get(opts: FetchOpts): Promise<unknown>;
+}
+declare class FetchBulkResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** POST /v1/fetch/bulk — create a bulk fetch job */
+    create(opts: Record<string, unknown>): Promise<unknown>;
+    /** GET /v1/fetch/bulk/{id} — get a bulk fetch job */
+    get(id: BulkId): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=fetch.d.ts.map

package/dist/resources/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/resources/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAEJ,MAAM,EAAE,UAAU;IAI/C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzC;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CASvC;AAED,cAAM,iBAAiB;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,oDAAoD;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,qDAAqD;IACrD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGlC"}

package/dist/resources/fetch.js

@@ -0,0 +1,49 @@
+export class FetchResource {
+    client;
+    bulk;
+    constructor(client) {
+        this.client = client;
+        this.bulk = new FetchBulkResource(client);
+    }
+    /**
+     * POST /v1/fetch — fetch URL content via POST body.
+     *
+     * Returns content directly (not ID-based).
+     */
+    create(opts) {
+        return this.client.request('POST', '/v1/fetch', opts);
+    }
+    /**
+     * GET /v1/fetch — fetch URL content via query params.
+     *
+     * Returns content directly (not ID-based).
+     */
+    get(opts) {
+        const params = new URLSearchParams();
+        params.set('url', opts.url);
+        if (opts.format !== undefined)
+            params.set('format', opts.format);
+        if (opts.country !== undefined)
+            params.set('country', opts.country);
+        if (opts.timeout_ms !== undefined)
+            params.set('timeout_ms', String(opts.timeout_ms));
+        if (opts.cache_ttl !== undefined)
+            params.set('cache_ttl', String(opts.cache_ttl));
+        return this.client.request('GET', `/v1/fetch?${params.toString()}`);
+    }
+}
+class FetchBulkResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** POST /v1/fetch/bulk — create a bulk fetch job */
+    create(opts) {
+        return this.client.request('POST', '/v1/fetch/bulk', opts);
+    }
+    /** GET /v1/fetch/bulk/{id} — get a bulk fetch job */
+    get(id) {
+        return this.client.request('GET', `/v1/fetch/bulk/${id}`);
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/resources/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/resources/fetch.ts"],"names":[],"mappings":"AA8BA,MAAM,OAAO,aAAa;IAGK;IAFpB,IAAI,CAAoB;IAEjC,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAe;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAe;QACjB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QACrF,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,aAAa,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AAED,MAAM,iBAAiB;IACQ;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,oDAAoD;IACpD,MAAM,CAAC,IAA6B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,qDAAqD;IACrD,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/resources/monitors.d.ts

@@ -0,0 +1,28 @@
+import type { RapidCrawl } from '../client.js';
+import type { MonitorId } from '../types.js';
+export declare class MonitorsResource {
+    private readonly client;
+    readonly captures: MonitorCapturesResource;
+    constructor(client: RapidCrawl);
+    /**
+     * POST /v1/monitors — create a page-change monitor (screenshot or scrape capture).
+     * First-capture behavior is the same for both types: the first capture is a silent baseline (has_change=false, change_pct=null) with no change_detected webhook, whether the monitor is `scrape` or `screenshot`. From the second capture onward both types diff against the previous capture.
+     */
+    create(opts: Record<string, unknown>): Promise<unknown>;
+    /** GET /v1/monitors — list all monitors for the account */
+    list(): Promise<unknown>;
+    /** GET /v1/monitors/{id} — get a monitor by ID */
+    get(id: MonitorId): Promise<unknown>;
+    /** PATCH /v1/monitors/{id} — update a monitor */
+    update(id: MonitorId, opts: Record<string, unknown>): Promise<unknown>;
+    /** DELETE /v1/monitors/{id} — delete a monitor */
+    delete(id: MonitorId): Promise<unknown>;
+}
+declare class MonitorCapturesResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** GET /v1/monitors/{id}/captures — list captures for a monitor */
+    list(id: MonitorId): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=monitors.d.ts.map

package/dist/resources/monitors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitors.d.ts","sourceRoot":"","sources":["../../src/resources/monitors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;gBAEd,MAAM,EAAE,UAAU;IAI/C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,2DAA2D;IAC3D,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,kDAAkD;IAClD,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpC,iDAAiD;IACjD,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAItE,kDAAkD;IAClD,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CAGxC;AAED,cAAM,uBAAuB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,mEAAmE;IACnE,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/resources/monitors.js

@@ -0,0 +1,42 @@
+export class MonitorsResource {
+    client;
+    captures;
+    constructor(client) {
+        this.client = client;
+        this.captures = new MonitorCapturesResource(client);
+    }
+    /**
+     * POST /v1/monitors — create a page-change monitor (screenshot or scrape capture).
+     * First-capture behavior is the same for both types: the first capture is a silent baseline (has_change=false, change_pct=null) with no change_detected webhook, whether the monitor is `scrape` or `screenshot`. From the second capture onward both types diff against the previous capture.
+     */
+    create(opts) {
+        return this.client.request('POST', '/v1/monitors', opts);
+    }
+    /** GET /v1/monitors — list all monitors for the account */
+    list() {
+        return this.client.request('GET', '/v1/monitors');
+    }
+    /** GET /v1/monitors/{id} — get a monitor by ID */
+    get(id) {
+        return this.client.request('GET', `/v1/monitors/${id}`);
+    }
+    /** PATCH /v1/monitors/{id} — update a monitor */
+    update(id, opts) {
+        return this.client.request('PATCH', `/v1/monitors/${id}`, opts);
+    }
+    /** DELETE /v1/monitors/{id} — delete a monitor */
+    delete(id) {
+        return this.client.request('DELETE', `/v1/monitors/${id}`);
+    }
+}
+class MonitorCapturesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** GET /v1/monitors/{id}/captures — list captures for a monitor */
+    list(id) {
+        return this.client.request('GET', `/v1/monitors/${id}/captures`);
+    }
+}
+//# sourceMappingURL=monitors.js.map

package/dist/resources/monitors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitors.js","sourceRoot":"","sources":["../../src/resources/monitors.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IAGE;IAFpB,QAAQ,CAA0B;IAE3C,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,IAA6B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,2DAA2D;IAC3D,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACpD,CAAC;IAED,kDAAkD;IAClD,GAAG,CAAC,EAAa;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,iDAAiD;IACjD,MAAM,CAAC,EAAa,EAAE,IAA6B;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,kDAAkD;IAClD,MAAM,CAAC,EAAa;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,uBAAuB;IACE;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,mEAAmE;IACnE,IAAI,CAAC,EAAa;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,WAAW,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/resources/recordings.d.ts

@@ -0,0 +1,11 @@
+import type { RapidCrawl } from '../client.js';
+import type { RecordingId } from '../types.js';
+export declare class RecordingsResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** POST /v1/recordings — start a recording */
+    create(opts: Record<string, unknown>): Promise<unknown>;
+    /** GET /v1/recordings/{id} — poll a recording by ID */
+    get(id: RecordingId): Promise<unknown>;
+}
+//# sourceMappingURL=recordings.d.ts.map

package/dist/resources/recordings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordings.d.ts","sourceRoot":"","sources":["../../src/resources/recordings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,8CAA8C;IAC9C,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,uDAAuD;IACvD,GAAG,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CAGvC"}

package/dist/resources/recordings.js

@@ -0,0 +1,15 @@
+export class RecordingsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** POST /v1/recordings — start a recording */
+    create(opts) {
+        return this.client.request('POST', '/v1/recordings', opts);
+    }
+    /** GET /v1/recordings/{id} — poll a recording by ID */
+    get(id) {
+        return this.client.request('GET', `/v1/recordings/${id}`);
+    }
+}
+//# sourceMappingURL=recordings.js.map

package/dist/resources/recordings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordings.js","sourceRoot":"","sources":["../../src/resources/recordings.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,8CAA8C;IAC9C,MAAM,CAAC,IAA6B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,EAAe;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/resources/scrape.d.ts

@@ -0,0 +1,69 @@
+import type { RapidCrawl } from '../client.js';
+import type { ScrapeId, BulkId } from '../types.js';
+/** Markdown processing mode for the pipeline. */
+export type MarkdownMode = 'article' | 'raw' | 'llm';
+/** Link rendering style in the markdown output. */
+export type MarkdownLinks = 'inline' | 'references' | 'none';
+/** Options for POST /v1/scrape. */
+export interface ScrapeOpts {
+    url: string;
+    formats?: Array<'raw_html' | 'html' | 'markdown' | 'links' | 'images'>;
+    country?: string;
+    cookies?: Array<Record<string, unknown>>;
+    headers?: Record<string, string>;
+    delay_ms?: number;
+    timeout_ms?: number;
+    async?: boolean;
+    webhook_url?: string;
+    events?: Array<'queued' | 'completed' | 'failed'>;
+    /** Markdown processing mode. article=article extraction (default), raw=minimal cleanup, llm=compact LLM-optimised output. */
+    markdown_mode?: MarkdownMode;
+    /** BM25 query string for relevance-ranked content filtering. Omit or leave empty to disable. */
+    markdown_query?: string;
+    /** Link rendering style in the markdown output. */
+    markdown_links?: MarkdownLinks;
+    /** Collapse excessive whitespace for a more compact output. */
+    markdown_compact?: boolean;
+    /** Filter low-signal images from the markdown output. */
+    markdown_filter_images?: boolean;
+    /** When true, `formats.links` and `formats.images` return `ScrapeScoredLink[]` / `ScrapeScoredImage[]` (rich objects) instead of `string[]`, and a top-level `tables` array is included. Only effective when `markdown` is in `formats`. */
+    markdown_include_media?: boolean;
+    /** When true, the response includes markdown-pipeline and tag-filter warnings. `artifact_unavailable` may appear independently when a requested persisted format cannot be rehydrated. */
+    markdown_include_warnings?: boolean;
+    /** When true, the response includes a top-level `stats` object with `ScrapeStats` (chars, tokens, blocks). Only effective when `markdown` is in `formats`. */
+    markdown_include_stats?: boolean;
+    /**
+     * How long a freshly fetched URL may be served from cache. `'0'`/`0` skips the
+     * cache read (the result is still written), `'Nh'`/`'Nd'` set a TTL (capped at
+     * 168h / 7d). Default `'48h'`. Honoured on both the synchronous and asynchronous
+     * paths; the async success envelope reports the outcome via the `cache` field.
+     */
+    cache_ttl?: string | 0;
+    /**
+     * User-supplied JSON payload, echoed back on the success envelope so callers
+     * can correlate the response to caller-side state (job IDs, batch metadata).
+     * Capped at 4096 UTF-8 bytes after JSON serialization. Does NOT affect
+     * cache-key inputs — two requests differing only in `custom` share the same
+     * cache slot.
+     */
+    custom?: Record<string, unknown>;
+}
+export declare class ScrapeResource {
+    private readonly client;
+    readonly bulk: ScrapeBulkResource;
+    constructor(client: RapidCrawl);
+    /** POST /v1/scrape — create a scrape job */
+    create(opts: ScrapeOpts): Promise<unknown>;
+    /** GET /v1/scrape/{id} — poll a scrape by ID */
+    get(id: ScrapeId): Promise<unknown>;
+}
+declare class ScrapeBulkResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** POST /v1/scrape/bulk — create a bulk scrape job */
+    create(opts: Record<string, unknown>): Promise<unknown>;
+    /** GET /v1/scrape/bulk/{id} — get a bulk scrape job */
+    get(id: BulkId): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=scrape.d.ts.map

package/dist/resources/scrape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/resources/scrape.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpD,iDAAiD;AACjD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,CAAC;AAErD,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAC;AAE7D,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC,CAAC;IAClD,6HAA6H;IAC7H,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,gGAAgG;IAChG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,yDAAyD;IACzD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,4OAA4O;IAC5O,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,0LAA0L;IAC1L,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,8JAA8J;IAC9J,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACvB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;gBAEL,MAAM,EAAE,UAAU;IAI/C,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C,gDAAgD;IAChD,GAAG,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpC;AAED,cAAM,kBAAkB;IACV,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,sDAAsD;IACtD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,uDAAuD;IACvD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGlC"}

package/dist/resources/scrape.js

@@ -0,0 +1,31 @@
+export class ScrapeResource {
+    client;
+    bulk;
+    constructor(client) {
+        this.client = client;
+        this.bulk = new ScrapeBulkResource(client);
+    }
+    /** POST /v1/scrape — create a scrape job */
+    create(opts) {
+        return this.client.request('POST', '/v1/scrape', opts);
+    }
+    /** GET /v1/scrape/{id} — poll a scrape by ID */
+    get(id) {
+        return this.client.request('GET', `/v1/scrape/${id}`);
+    }
+}
+class ScrapeBulkResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** POST /v1/scrape/bulk — create a bulk scrape job */
+    create(opts) {
+        return this.client.request('POST', '/v1/scrape/bulk', opts);
+    }
+    /** GET /v1/scrape/bulk/{id} — get a bulk scrape job */
+    get(id) {
+        return this.client.request('GET', `/v1/scrape/bulk/${id}`);
+    }
+}
+//# sourceMappingURL=scrape.js.map

package/dist/resources/scrape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.js","sourceRoot":"","sources":["../../src/resources/scrape.ts"],"names":[],"mappings":"AAsDA,MAAM,OAAO,cAAc;IAGI;IAFpB,IAAI,CAAqB;IAElC,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,IAAgB;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,gDAAgD;IAChD,GAAG,CAAC,EAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;CACF;AAED,MAAM,kBAAkB;IACO;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,sDAAsD;IACtD,MAAM,CAAC,IAA6B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,uDAAuD;IACvD,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/resources/screenshots.d.ts

@@ -0,0 +1,11 @@
+import type { RapidCrawl } from '../client.js';
+import type { ScreenshotId } from '../types.js';
+export declare class ScreenshotsResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** POST /v1/screenshots — capture a screenshot */
+    create(opts: Record<string, unknown>): Promise<unknown>;
+    /** GET /v1/screenshots/{id} — poll a screenshot by ID */
+    get(id: ScreenshotId): Promise<unknown>;
+}
+//# sourceMappingURL=screenshots.d.ts.map

package/dist/resources/screenshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots.d.ts","sourceRoot":"","sources":["../../src/resources/screenshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,kDAAkD;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,yDAAyD;IACzD,GAAG,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;CAGxC"}

package/dist/resources/screenshots.js

@@ -0,0 +1,15 @@
+export class ScreenshotsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** POST /v1/screenshots — capture a screenshot */
+    create(opts) {
+        return this.client.request('POST', '/v1/screenshots', opts);
+    }
+    /** GET /v1/screenshots/{id} — poll a screenshot by ID */
+    get(id) {
+        return this.client.request('GET', `/v1/screenshots/${id}`);
+    }
+}
+//# sourceMappingURL=screenshots.js.map

package/dist/resources/screenshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots.js","sourceRoot":"","sources":["../../src/resources/screenshots.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,kDAAkD;IAClD,MAAM,CAAC,IAA6B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,yDAAyD;IACzD,GAAG,CAAC,EAAgB;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/resources/search.d.ts

@@ -0,0 +1,9 @@
+import type { RapidCrawl } from '../client.js';
+import type { SearchOpts, SearchResponse } from '../types.js';
+export declare class SearchResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** POST /v1/search — run a web search and return ranked organic results. */
+    query(opts: SearchOpts): Promise<SearchResponse>;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/resources/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9D,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,4EAA4E;IAC5E,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC;CAGjD"}

package/dist/resources/search.js

@@ -0,0 +1,11 @@
+export class SearchResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** POST /v1/search — run a web search and return ranked organic results. */
+    query(opts) {
+        return this.client.request('POST', '/v1/search', opts);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/resources/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/resources/search.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,4EAA4E;IAC5E,KAAK,CAAC,IAAgB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAiB,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/resources/sitemap.d.ts

@@ -0,0 +1,11 @@
+import type { RapidCrawl } from '../client.js';
+import type { SitemapId } from '../types.js';
+export declare class SitemapResource {
+    private readonly client;
+    constructor(client: RapidCrawl);
+    /** POST /v1/sitemap — start a sitemap crawl */
+    create(opts: Record<string, unknown>): Promise<unknown>;
+    /** GET /v1/sitemap/{id} — get a sitemap job by ID */
+    get(id: SitemapId): Promise<unknown>;
+}
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/resources/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../../src/resources/sitemap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C,+CAA+C;IAC/C,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,qDAAqD;IACrD,GAAG,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrC"}

package/dist/resources/sitemap.js

@@ -0,0 +1,15 @@
+export class SitemapResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** POST /v1/sitemap — start a sitemap crawl */
+    create(opts) {
+        return this.client.request('POST', '/v1/sitemap', opts);
+    }
+    /** GET /v1/sitemap/{id} — get a sitemap job by ID */
+    get(id) {
+        return this.client.request('GET', `/v1/sitemap/${id}`);
+    }
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/resources/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../../src/resources/sitemap.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,+CAA+C;IAC/C,MAAM,CAAC,IAA6B;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,qDAAqD;IACrD,GAAG,CAAC,EAAa;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Prefixed-ID branded types for all RapidCrawl resource identifiers.
+ *
+ * These mirror the `ss_`, `rec_`, `bulk_`, etc. prefixes used at the API
+ * boundary (internal rows use raw UUIDs).
+ */
+export type ScrapeId = `sc_${string}`;
+export type ScreenshotId = `ss_${string}`;
+export type RecordingId = `rec_${string}`;
+export type BulkId = `bulk_${string}`;
+export type MonitorId = `mon_${string}`;
+export type SitemapId = `sm_${string}`;
+export type ApiKeyId = `ak_${string}`;
+/** Which search index to query. `web` (default), `news`, or `images`. */
+export type SearchType = 'web' | 'news' | 'images';
+/** Recency window for search results (maps to the upstream time filter). */
+export type SearchDateRange = 'any' | 'hour' | 'day' | 'week' | 'month' | 'year';
+/** Options for POST /v1/search. */
+export interface SearchOpts {
+    /** The search query. */
+    query: string;
+    /**
+     * Which search index to query. `web` (default) returns ranked organic
+     * results; `news` returns news articles (populating `source`/`image`);
+     * `images` returns image results (populating `source`/`domain` and a fuller
+     * `image` object). Omit for the default web search.
+     */
+    type?: SearchType;
+    /** Maximum number of organic results to return (1–100, default 10). */
+    limit?: number;
+    /** Two-letter country code to localize results (e.g. `us`, `de`). */
+    country?: string;
+    /** Two-letter ISO-639-1 language code for results (e.g. `en`, `fr`). */
+    language?: string;
+    /**
+     * Restrict results to a recency window: `any` (default, no filter), `hour`,
+     * `day`, `week`, `month`, or `year`. Applies to every `type`.
+     */
+    date_range?: SearchDateRange;
+}
+/**
+ * Image attached to a search result. For `news` results this is the thumbnail
+ * (only `url`); for `images` results it is the full image, additionally
+ * carrying its dimensions and a thumbnail URL + dimensions. Each field past
+ * `url` is present only when the provider reports it.
+ */
+export interface SearchResultImage {
+    /** URL of the image (thumbnail for `news`, full image for `images`). */
+    url: string;
+    /** Source image width in pixels (`images` only). */
+    width?: number;
+    /** Source image height in pixels (`images` only). */
+    height?: number;
+    /** URL of the thumbnail image (`images` only). */
+    thumbnail_url?: string;
+    /** Thumbnail width in pixels (`images` only). */
+    thumbnail_width?: number;
+    /** Thumbnail height in pixels (`images` only). */
+    thumbnail_height?: number;
+}
+/** A single ranked organic search result. */
+export interface SearchResult {
+    /** 1-based rank of the result. */
+    position: number;
+    title: string;
+    url: string;
+    /** Short text excerpt for the result. Omitted for `images` results. */
+    snippet: string;
+    /** Published date when the provider reports one, else `null`. */
+    date: string | null;
+    /** Publisher / source name. Present for `news` and `images` results. */
+    source?: string;
+    /** Hosting-page domain of the result. Present only for `images` results. */
+    domain?: string;
+    /** Image attached to the result (present for `news` and `images` results). */
+    image?: SearchResultImage;
+}
+/** Response from POST /v1/search. */
+export interface SearchResponse {
+    /** Stable search identifier (prefixed `sr_`). */
+    id: string;
+    query: string;
+    results: SearchResult[];
+    /** Related query suggestions; empty when none are returned. */
+    related_searches: string[];
+    /** Credits consumed by this search call. */
+    credits_used: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,MAAM,EAAE,CAAC;AACtC,MAAM,MAAM,YAAY,GAAG,MAAM,MAAM,EAAE,CAAC;AAC1C,MAAM,MAAM,WAAW,GAAG,OAAO,MAAM,EAAE,CAAC;AAC1C,MAAM,MAAM,MAAM,GAAG,QAAQ,MAAM,EAAE,CAAC;AACtC,MAAM,MAAM,SAAS,GAAG,OAAO,MAAM,EAAE,CAAC;AACxC,MAAM,MAAM,SAAS,GAAG,MAAM,MAAM,EAAE,CAAC;AACvC,MAAM,MAAM,QAAQ,GAAG,MAAM,MAAM,EAAE,CAAC;AAEtC,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnD,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjF,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Prefixed-ID branded types for all RapidCrawl resource identifiers.
+ *
+ * These mirror the `ss_`, `rec_`, `bulk_`, etc. prefixes used at the API
+ * boundary (internal rows use raw UUIDs).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@hunt-labs/bytekit-sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for the ByteKit API",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hunt-Labs-Inc/ByteKit.git",
+    "directory": "packages/sdk-typescript"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "openapi-typescript": "7.13.0",
+    "tsx": "*",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.11.0",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "gen:types": "openapi-typescript ../../docs/api/openapi.yaml -o src/generated/api.d.ts",
+    "gen:types-check": "pnpm gen:types && git diff --exit-code src/generated/api.d.ts",
+    "generate:docs": "tsx scripts/generate-docs.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}