@hunt-labs/bytekit-sdk 0.2.0 → 0.3.0

package/dist/resources/usage.js

@@ -0,0 +1,25 @@
+import { toQueryString } from './query-string.js';
+export class UsageResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** GET /v1/usage — get current billing period usage. */
+    get() {
+        return this.client.request('GET', '/v1/usage');
+    }
+    /**
+     * GET /v1/usage/daily — get daily usage breakdown.
+     * Default range is the last 30 days; max range is 366 days.
+     */
+    daily(params) {
+        return this.client.request('GET', `/v1/usage/daily${toQueryString(params)}`);
+    }
+    /**
+     * GET /v1/usage/by-endpoint — get per-endpoint bandwidth breakdown.
+     * Default range is the last 30 days; max range is 366 days.
+     */
+    byEndpoint(params) {
+        return this.client.request('GET', `/v1/usage/by-endpoint${toQueryString(params)}`);
+    }
+}

package/dist/resources/webhooks.d.ts

@@ -0,0 +1,20 @@
+import type { ByteKit } from '../client.js';
+import type { operations } from '../generated/api.js';
+import type { WebhookDeliveryId } from '../types.js';
+/**
+ * Query params of GET /v1/webhook-deliveries.
+ * Derived from the generated OpenAPI types so it stays in sync with the spec.
+ */
+export type ListWebhookDeliveriesParams = NonNullable<operations['listWebhookDeliveries']['parameters']['query']>;
+/** 200 payload of GET /v1/webhook-deliveries. */
+export type ListWebhookDeliveriesResponse = operations['listWebhookDeliveries']['responses'][200]['content']['application/json'];
+/** 200 payload of POST /v1/webhook-deliveries/{id}/retry. */
+export type RetryWebhookDeliveryResponse = operations['retryWebhookDelivery']['responses'][200]['content']['application/json'];
+export declare class WebhooksResource {
+    private readonly client;
+    constructor(client: ByteKit);
+    /** GET /v1/webhook-deliveries — list webhook deliveries. */
+    list(params?: ListWebhookDeliveriesParams): Promise<ListWebhookDeliveriesResponse>;
+    /** POST /v1/webhook-deliveries/{id}/retry — requeue a failed or exhausted delivery. */
+    retry(id: WebhookDeliveryId): Promise<RetryWebhookDeliveryResponse>;
+}

package/dist/resources/webhooks.js

@@ -0,0 +1,15 @@
+import { toQueryString } from './query-string.js';
+export class WebhooksResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** GET /v1/webhook-deliveries — list webhook deliveries. */
+    list(params) {
+        return this.client.request('GET', `/v1/webhook-deliveries${toQueryString(params)}`);
+    }
+    /** POST /v1/webhook-deliveries/{id}/retry — requeue a failed or exhausted delivery. */
+    retry(id) {
+        return this.client.request('POST', `/v1/webhook-deliveries/${id}/retry`);
+    }
+}

package/dist/types.d.ts

@@ -1,16 +1,16 @@
 /**
- * Prefixed-ID branded types for all RapidCrawl resource identifiers.
+ * Prefixed-ID branded types for all ByteKit 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}`;
+export type WebhookDeliveryId = `wh_${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). */
@@ -66,8 +66,11 @@ export interface SearchResult {
     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;
+    /**
+     * Published date when the provider reports one, else `null`. Present for
+     * `web`/`news` results; omitted entirely (`undefined`) for `images` results.
+     */
+    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. */

package/dist/types.js

@@ -1,5 +1,5 @@
 /**
- * Prefixed-ID branded types for all RapidCrawl resource identifiers.
+ * Prefixed-ID branded types for all ByteKit resource identifiers.
  *
  * These mirror the `ss_`, `rec_`, `bulk_`, etc. prefixes used at the API
  * boundary (internal rows use raw UUIDs).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunt-labs/bytekit-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Official TypeScript SDK for the ByteKit API",
   "license": "MIT",
   "type": "module",
@@ -22,14 +22,9 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
-  "devDependencies": {
-    "openapi-typescript": "7.13.0",
-    "tsx": "*",
-    "typescript": "^5.4.5",
-    "vitest": "^1.6.0"
-  },
   "engines": {
     "node": ">=18"
   },
@@ -49,10 +44,11 @@
   ],
   "homepage": "https://bytekit.com/docs",
   "bugs": {
-    "email": "support@bytekit.com"
+    "email": "support@bytekit.com",
+    "url": "https://bytekit.com/contact"
   },
   "scripts": {
-    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc && mkdir -p dist/generated && cp src/generated/api.d.ts dist/generated/api.d.ts",
+    "build": "rm -rf dist tsconfig.tsbuildinfo tsconfig.build.tsbuildinfo && tsc -p tsconfig.build.json && mkdir -p dist/generated && cp src/generated/api.d.ts dist/generated/api.d.ts",
     "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",

package/dist/resources/recordings.d.ts

@@ -1,10 +0,0 @@
-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>;
-}

package/dist/resources/recordings.js

@@ -1,14 +0,0 @@
-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}`);
-    }
-}

package/dist/test-helpers/signal-aware-never-resolver.d.ts

@@ -1,9 +0,0 @@
-/**
- * A `fetch` mock that never settles until the request's own signal aborts.
- *
- * Shared between `client.test.ts` and `resources/__tests__/scrape.test.ts` (#2424 code review
- * cr-3) — both suites need a `fetch` stand-in that hangs forever except for reacting to the
- * abort signal the SDK attaches, so timeout/abort-ordering tests can assert on elapsed time and
- * error code without a real network call.
- */
-export declare function signalAwareNeverResolver(): (url: string, init: RequestInit) => Promise<Response>;

package/dist/test-helpers/signal-aware-never-resolver.js

@@ -1,25 +0,0 @@
-// Test-only fixture, compiled like any other `src` file (not excluded from the tsc build):
-// excluding it broke ESLint's typed-lint project-service resolution (it requires every linted
-// file to be part of the tsconfig `include` set). The tradeoff is a small compiled fixture
-// landing in `dist/test-helpers/` alongside the package's real exports — negligible, and no
-// consumer imports it (it's not re-exported from `index.ts`).
-/**
- * A `fetch` mock that never settles until the request's own signal aborts.
- *
- * Shared between `client.test.ts` and `resources/__tests__/scrape.test.ts` (#2424 code review
- * cr-3) — both suites need a `fetch` stand-in that hangs forever except for reacting to the
- * abort signal the SDK attaches, so timeout/abort-ordering tests can assert on elapsed time and
- * error code without a real network call.
- */
-export function signalAwareNeverResolver() {
-    return (_url, init) => new Promise((_resolve, reject) => {
-        const signal = init.signal;
-        if (!signal)
-            return; // hangs — only used by tests that always pass a signal
-        if (signal.aborted) {
-            reject(signal.reason);
-            return;
-        }
-        signal.addEventListener('abort', () => reject(signal.reason));
-    });
-}