@isnap/sdk 0.1.0 → 1.1.0-next.49

package/dist/resources/webhooks.d.ts

@@ -1,48 +1,58 @@
-import type { iSnapClient } from '../client.js';
-import type { Webhook, CreateWebhookParams } from '../types.js';
-export declare class WebhooksResource {
-    private client;
-    constructor(client: iSnapClient);
+import type { components, paths } from '../generated/openapi.js';
+import type { RequestOptions } from '../types.js';
+import { BaseResource } from './base.js';
+export type Webhook = components['schemas']['WebhookV1'];
+export type WebhookList = components['schemas']['WebhookList'];
+export type WebhookRotateSecret = components['schemas']['WebhookRotateSecret'];
+export type WebhookDelivery = components['schemas']['WebhookDeliveryV1'];
+export type WebhookDeliveryReplay = components['schemas']['WebhookDeliveryReplay'];
+export type WebhookEventItem = components['schemas']['WebhookEventItem'];
+export type CreateWebhookBody = NonNullable<paths['/v1/webhooks']['post']['requestBody']>['content']['application/json'];
+export type UpdateWebhookBody = NonNullable<paths['/v1/webhooks/{id}']['patch']['requestBody']>['content']['application/json'];
+export type ListDeliveriesQuery = NonNullable<paths['/v1/webhooks/{id}/deliveries']['get']['parameters']['query']>;
+export type ListEventsQuery = paths['/v1/webhooks/events']['get']['parameters']['query'];
+export declare class WebhooksResource extends BaseResource {
+    /** `GET /v1/webhooks` — list all webhook subscriptions for the calling account. */
+    list(opts?: RequestOptions): Promise<WebhookList>;
     /**
-     * Register a new webhook endpoint.
-     *
-     * @param params - Webhook URL and optional event filter
-     * @returns The created webhook (includes the `secret` for signature verification)
-     *
-     * @example
-     * ```ts
-     * const wh = await client.webhooks.create({
-     *   url: 'https://example.com/webhooks/isnap',
-     *   events: ['message.sent', 'message.delivered'],
-     * });
-     * console.log(wh.secret); // save this for verification
-     * ```
+     * `POST /v1/webhooks` — create a subscription. Plaintext `secret` is
+     * returned ONCE in the create response; persist it then. Subsequent
+     * GETs do not include it.
      */
-    create(params: CreateWebhookParams): Promise<Webhook>;
+    create(body: CreateWebhookBody, opts?: RequestOptions): Promise<Webhook>;
+    /** `GET /v1/webhooks/{id}` — fetch a single webhook subscription. */
+    get(id: string, opts?: RequestOptions): Promise<Webhook>;
+    /** `PATCH /v1/webhooks/{id}` — partial update of url / events / line_ids / active flag. */
+    update(id: string, body: UpdateWebhookBody, opts?: RequestOptions): Promise<Webhook>;
+    /** `DELETE /v1/webhooks/{id}` — delete a subscription. Returns 204. */
+    delete(id: string, opts?: RequestOptions): Promise<void>;
     /**
-     * List all registered webhooks.
-     *
-     * @returns Object containing the webhooks array
-     *
-     * @example
-     * ```ts
-     * const { webhooks } = await client.webhooks.list();
-     * ```
+     * `POST /v1/webhooks/{id}/rotate-secret` — mint a new `whs_*` secret.
+     * Old secret stays valid for 5 minutes (`old_secret_expires_at`) so the
+     * caller can roll their verification code without dropping events.
+     * Plaintext secret is returned ONCE.
      */
-    list(): Promise<{
-        webhooks: Webhook[];
-    }>;
+    rotateSecret(id: string, opts?: RequestOptions): Promise<WebhookRotateSecret>;
     /**
-     * Delete a webhook by ID.
-     *
-     * @param webhookId - The webhook ID to delete
-     * @throws {iSnapError} If the webhook is not found
+     * `GET /v1/webhooks/{id}/deliveries` — cursor-paginated AsyncIterable
+     * over delivery attempts for a subscription. Filters: status (pending/
+     * success/failed), event type, since/until timestamps.
+     */
+    deliveries(id: string, filters?: Omit<ListDeliveriesQuery, 'cursor'>, opts?: RequestOptions): AsyncIterable<WebhookDelivery>;
+    /**
+     * `POST /v1/webhooks/{id}/deliveries/{delivery_id}/replay` — re-fire a
+     * past delivery. Server preserves the original `event_id` so consumers
+     * still dedupe.
+     */
+    replay(webhookId: string, deliveryId: string, opts?: RequestOptions): Promise<WebhookDeliveryReplay>;
+    /**
+     * `GET /v1/webhooks/events` — cursor-paginated reconciliation pull.
+     * Returns events that would have been delivered to the caller's
+     * subscriptions within the 72h retention window. Used to recover from
+     * webhook outages without missing signal.
      *
-     * @example
-     * ```ts
-     * await client.webhooks.delete('wh-abc123');
-     * ```
+     * `since` is required by the contract.
      */
-    delete(webhookId: string): Promise<void>;
+    events(filters: Omit<NonNullable<ListEventsQuery>, 'cursor'>, opts?: RequestOptions): AsyncIterable<WebhookEventItem>;
 }
 //# sourceMappingURL=webhooks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEhE,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D;;;;;;;;;OASG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAI9C;;;;;;;;;;OAUG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG/C"}
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"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"}

package/dist/resources/webhooks.js

@@ -1,52 +1,65 @@
-export class WebhooksResource {
-    client;
-    constructor(client) {
-        this.client = client;
+import { paginate } from '../pagination.js';
+import { BaseResource } from './base.js';
+export class WebhooksResource extends BaseResource {
+    /** `GET /v1/webhooks` — list all webhook subscriptions for the calling account. */
+    list(opts) {
+        return this.client.request('GET', '/v1/webhooks', undefined, opts);
     }
     /**
-     * Register a new webhook endpoint.
-     *
-     * @param params - Webhook URL and optional event filter
-     * @returns The created webhook (includes the `secret` for signature verification)
-     *
-     * @example
-     * ```ts
-     * const wh = await client.webhooks.create({
-     *   url: 'https://example.com/webhooks/isnap',
-     *   events: ['message.sent', 'message.delivered'],
-     * });
-     * console.log(wh.secret); // save this for verification
-     * ```
+     * `POST /v1/webhooks` — create a subscription. Plaintext `secret` is
+     * returned ONCE in the create response; persist it then. Subsequent
+     * GETs do not include it.
      */
-    async create(params) {
-        return this.client.request('POST', '/v1/webhooks', params);
+    create(body, opts) {
+        return this.client.request('POST', '/v1/webhooks', body, opts);
+    }
+    /** `GET /v1/webhooks/{id}` — fetch a single webhook subscription. */
+    get(id, opts) {
+        return this.client.request('GET', `/v1/webhooks/${encodeURIComponent(id)}`, undefined, opts);
+    }
+    /** `PATCH /v1/webhooks/{id}` — partial update of url / events / line_ids / active flag. */
+    update(id, body, opts) {
+        return this.client.request('PATCH', `/v1/webhooks/${encodeURIComponent(id)}`, body, opts);
+    }
+    /** `DELETE /v1/webhooks/{id}` — delete a subscription. Returns 204. */
+    delete(id, opts) {
+        return this.client.request('DELETE', `/v1/webhooks/${encodeURIComponent(id)}`, undefined, opts);
     }
     /**
-     * List all registered webhooks.
-     *
-     * @returns Object containing the webhooks array
-     *
-     * @example
-     * ```ts
-     * const { webhooks } = await client.webhooks.list();
-     * ```
+     * `POST /v1/webhooks/{id}/rotate-secret` — mint a new `whs_*` secret.
+     * Old secret stays valid for 5 minutes (`old_secret_expires_at`) so the
+     * caller can roll their verification code without dropping events.
+     * Plaintext secret is returned ONCE.
      */
-    async list() {
-        return this.client.request('GET', '/v1/webhooks');
+    rotateSecret(id, opts) {
+        return this.client.request('POST', `/v1/webhooks/${encodeURIComponent(id)}/rotate-secret`, undefined, opts);
     }
     /**
-     * Delete a webhook by ID.
-     *
-     * @param webhookId - The webhook ID to delete
-     * @throws {iSnapError} If the webhook is not found
+     * `GET /v1/webhooks/{id}/deliveries` — cursor-paginated AsyncIterable
+     * over delivery attempts for a subscription. Filters: status (pending/
+     * success/failed), event type, since/until timestamps.
+     */
+    deliveries(id, filters = {}, opts) {
+        return paginate((cursor) => this.client.request('GET', `/v1/webhooks/${encodeURIComponent(id)}/deliveries`, undefined, { ...opts, query: { ...filters, cursor } }), { signal: opts?.signal });
+    }
+    /**
+     * `POST /v1/webhooks/{id}/deliveries/{delivery_id}/replay` — re-fire a
+     * past delivery. Server preserves the original `event_id` so consumers
+     * still dedupe.
+     */
+    replay(webhookId, deliveryId, opts) {
+        return this.client.request('POST', `/v1/webhooks/${encodeURIComponent(webhookId)}/deliveries/${encodeURIComponent(deliveryId)}/replay`, undefined, opts);
+    }
+    /**
+     * `GET /v1/webhooks/events` — cursor-paginated reconciliation pull.
+     * Returns events that would have been delivered to the caller's
+     * subscriptions within the 72h retention window. Used to recover from
+     * webhook outages without missing signal.
      *
-     * @example
-     * ```ts
-     * await client.webhooks.delete('wh-abc123');
-     * ```
+     * `since` is required by the contract.
      */
-    async delete(webhookId) {
-        return this.client.request('DELETE', `/v1/webhooks/${webhookId}`);
+    events(filters, opts) {
+        return paginate((cursor) => this.client.request('GET', '/v1/webhooks/events', undefined, { ...opts, query: { ...filters, cursor } }), { signal: opts?.signal });
     }
 }
 //# sourceMappingURL=webhooks.js.map

package/dist/resources/webhooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAE3C;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA0B,KAAK,EAAE,cAAc,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAO,QAAQ,EAAE,gBAAgB,SAAS,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF"}
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/resources/webhooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAoBxC,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD,mFAAmF;IACnF,IAAI,CAAC,IAAqB;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAc,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,CAAA;IACjF,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAuB,EAAE,IAAqB;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACzE,CAAC;IAED,qEAAqE;IACrE,GAAG,CAAC,EAAU,EAAE,IAAqB;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACxC,SAAS,EACT,IAAI,CACL,CAAA;IACH,CAAC;IAED,2FAA2F;IAC3F,MAAM,CAAC,EAAU,EAAE,IAAuB,EAAE,IAAqB;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,OAAO,EACP,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACxC,IAAI,EACJ,IAAI,CACL,CAAA;IACH,CAAC;IAED,uEAAuE;IACvE,MAAM,CAAC,EAAU,EAAE,IAAqB;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,QAAQ,EACR,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACxC,SAAS,EACT,IAAI,CACL,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,EAAU,EAAE,IAAqB;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,gBAAgB,EACtD,SAAS,EACT,IAAI,CACL,CAAA;IACH,CAAC;IAED;;;;OAIG;IACH,UAAU,CACR,EAAU,EACV,UAA+C,EAAE,EACjD,IAAqB;QAErB,OAAO,QAAQ,CACb,CAAC,MAAM,EAAE,EAAE,CACT,IAAI,CAAC,MAAM,CAAC,OAAO,CACjB,KAAK,EACL,gBAAgB,kBAAkB,CAAC,EAAE,CAAC,aAAa,EACnD,SAAS,EACT,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,EAAE,CAC3C,EACH,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CACzB,CAAA;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CACJ,SAAiB,EACjB,UAAkB,EAClB,IAAqB;QAErB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,MAAM,EACN,gBAAgB,kBAAkB,CAAC,SAAS,CAAC,eAAe,kBAAkB,CAAC,UAAU,CAAC,SAAS,EACnG,SAAS,EACT,IAAI,CACL,CAAA;IACH,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CACJ,OAAqD,EACrD,IAAqB;QAErB,OAAO,QAAQ,CACb,CAAC,MAAM,EAAE,EAAE,CACT,IAAI,CAAC,MAAM,CAAC,OAAO,CACjB,KAAK,EACL,qBAAqB,EACrB,SAAS,EACT,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,EAAE,CAC3C,EACH,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CACzB,CAAA;IACH,CAAC;CACF"}

package/dist/retry.d.ts

@@ -0,0 +1,14 @@
+export interface RetryInfo {
+    attempt: number;
+    nextDelayMs: number;
+    error: unknown;
+}
+export interface RetryConfig {
+    maxRetries: number;
+    onRetry?: (info: RetryInfo) => void;
+    signal?: AbortSignal;
+}
+export declare function isRetryable(err: unknown): boolean;
+export declare function computeBackoff(attempt: number, err: unknown): number;
+export declare function withRetries<T>(fn: () => Promise<T>, config: RetryConfig): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;IACnC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAKD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOjD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAKpE;AAED,wBAAsB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAoB1F"}

package/dist/retry.js

@@ -0,0 +1,47 @@
+import { APIConnectionError, InternalServerError, QuotaExceededError, RateLimitError, ServiceUnavailableError } from './errors.js';
+import { sleep } from './internal/sleep.js';
+const BASE_DELAY_MS = 250;
+const JITTER_MS = 100;
+export function isRetryable(err) {
+    if (err instanceof QuotaExceededError)
+        return false;
+    if (err instanceof APIConnectionError)
+        return true;
+    if (err instanceof InternalServerError)
+        return true;
+    if (err instanceof ServiceUnavailableError)
+        return true;
+    if (err instanceof RateLimitError)
+        return true;
+    return false;
+}
+export function computeBackoff(attempt, err) {
+    if (err instanceof RateLimitError && typeof err.retryAfter === 'number' && err.retryAfter > 0) {
+        return err.retryAfter * 1000;
+    }
+    return BASE_DELAY_MS * Math.pow(2, attempt) + Math.random() * JITTER_MS;
+}
+export async function withRetries(fn, config) {
+    let lastError;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        if (config.signal?.aborted) {
+            throw new APIConnectionError('Request aborted before attempt', {
+                cause: config.signal.reason
+            });
+        }
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            const isLast = attempt === config.maxRetries;
+            if (isLast || !isRetryable(err))
+                throw err;
+            const nextDelayMs = computeBackoff(attempt, err);
+            config.onRetry?.({ attempt, nextDelayMs, error: err });
+            await sleep(nextDelayMs, config.signal, 'Request aborted during retry backoff');
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAc3C,MAAM,aAAa,GAAG,GAAG,CAAA;AACzB,MAAM,SAAS,GAAG,GAAG,CAAA;AAErB,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,GAAG,YAAY,kBAAkB;QAAE,OAAO,KAAK,CAAA;IACnD,IAAI,GAAG,YAAY,kBAAkB;QAAE,OAAO,IAAI,CAAA;IAClD,IAAI,GAAG,YAAY,mBAAmB;QAAE,OAAO,IAAI,CAAA;IACnD,IAAI,GAAG,YAAY,uBAAuB;QAAE,OAAO,IAAI,CAAA;IACvD,IAAI,GAAG,YAAY,cAAc;QAAE,OAAO,IAAI,CAAA;IAC9C,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,GAAY;IAC1D,IAAI,GAAG,YAAY,cAAc,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAC9F,OAAO,GAAG,CAAC,UAAU,GAAG,IAAI,CAAA;IAC9B,CAAC;IACD,OAAO,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAA;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,EAAoB,EAAE,MAAmB;IAC5E,IAAI,SAAkB,CAAA;IACtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC9D,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,kBAAkB,CAAC,gCAAgC,EAAE;gBAC7D,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;aAC5B,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,CAAA;YACf,MAAM,MAAM,GAAG,OAAO,KAAK,MAAM,CAAC,UAAU,CAAA;YAC5C,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAA;YAC1C,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAChD,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;YACtD,MAAM,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,sCAAsC,CAAC,CAAA;QACjF,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAA;AACjB,CAAC"}

package/dist/types.d.ts

@@ -1,199 +1,33 @@
-/** A message sent or received through a line. */
-export interface Message {
-    id: string;
-    line_id: string;
-    direction: string;
-    from_number: string;
-    to_number: string;
-    body: string;
-    channel: string;
-    status: string;
-    error_code: string | null;
-    error_message: string | null;
-    metadata: unknown;
-    queued_at: string;
-    sent_at: string | null;
-    delivered_at: string | null;
-    read_at: string | null;
-    failed_at: string | null;
-    created_at: string;
-}
-/** Parameters for sending a new message. */
-export interface SendMessageParams {
-    /** The line ID to send the message from. */
-    line_id: string;
-    /** Recipient phone number in E.164 format. */
-    to: string;
-    /** Message body text. */
-    body: string;
-    /** Messaging channel. Defaults to `'auto'`. */
-    channel?: 'auto' | 'imessage' | 'sms' | 'whatsapp';
-    /** Optional webhook URL to receive delivery status updates. */
-    webhook_url?: string;
-    /** Arbitrary key-value metadata attached to the message. */
-    metadata?: Record<string, unknown>;
-}
-/** Filter/pagination parameters for listing messages. */
-export interface ListMessagesParams {
-    line_id?: string;
-    status?: 'queued' | 'sent' | 'delivered' | 'read' | 'failed';
-    direction?: 'outbound' | 'inbound';
-    page?: number;
-    limit?: number;
-}
-/** Paginated list of messages. */
-export interface ListMessagesResponse {
-    messages: Message[];
-    total: number;
-    page: number;
-    limit: number;
-}
-/** A conversation thread between a line and a contact. */
-export interface Conversation {
-    id: string;
-    line_id: string;
-    contact_number: string;
-    last_message_at: string;
-    message_count: number;
-    created_at: string;
-}
-/** Filter/pagination parameters for listing conversations. */
-export interface ListConversationsParams {
-    line_id?: string;
-    page?: number;
-    limit?: number;
-}
-/** Paginated list of conversations. */
-export interface ListConversationsResponse {
-    conversations: Conversation[];
-    total: number;
-    page: number;
-    limit: number;
-}
-/** Pagination parameters for retrieving a conversation thread. */
-export interface ConversationThreadParams {
-    /** Page number (1-based). */
-    page?: number;
-    /** Number of messages per page. */
-    limit?: number;
-}
-/** A conversation thread with its messages. */
-export interface ConversationThreadResponse {
-    conversation: Conversation;
-    messages: Message[];
-    total: number;
-    page: number;
-    limit: number;
-}
-/** A phone line (iPhone or Android). */
-export interface Line {
-    id: string;
-    phone_number: string;
-    area_code: string;
-    type: string;
-    capabilities: unknown;
-    status: string;
-    monthly_price: number;
-    activated_at: string | null;
-    created_at: string;
-}
-/** Paginated list of lines. */
-export interface ListLinesResponse {
-    lines: Line[];
-    total: number;
-    page: number;
-    limit: number;
-}
-/** Filter/pagination parameters for listing lines. */
-export interface ListLinesParams {
-    type?: string;
-    area_code?: string;
-    page?: number;
-    limit?: number;
-}
-/** A registered webhook endpoint. */
-export interface Webhook {
-    id: string;
-    url: string;
-    events: string[];
-    active: boolean;
-    failure_count: number;
-    last_success_at: string | null;
-    last_failure_at: string | null;
-    created_at: string;
-    secret?: string;
-}
-/** Parameters for creating a webhook. */
-export interface CreateWebhookParams {
-    /** The URL to receive webhook events. */
-    url: string;
-    /** Event types to subscribe to. Defaults to all events. */
-    events?: string[];
-}
-/** All supported webhook event types. */
-export type WebhookEventType = 'message.sent' | 'message.delivered' | 'message.read' | 'message.failed' | 'message.received';
-/** Base shape shared by all webhook events. */
-interface WebhookEventBase {
-    webhook_id: string;
-    timestamp: string;
-}
-/** Fired when a message is successfully sent. */
-export interface MessageSentEvent extends WebhookEventBase {
-    event: 'message.sent';
-    data: Message;
-}
-/** Fired when a message is delivered to the recipient. */
-export interface MessageDeliveredEvent extends WebhookEventBase {
-    event: 'message.delivered';
-    data: Message;
-}
-/** Fired when a message is read by the recipient. */
-export interface MessageReadEvent extends WebhookEventBase {
-    event: 'message.read';
-    data: Message;
-}
-/** Fired when a message fails to send. */
-export interface MessageFailedEvent extends WebhookEventBase {
-    event: 'message.failed';
-    data: Message;
-}
-/** Fired when an inbound message is received. */
-export interface MessageReceivedEvent extends WebhookEventBase {
-    event: 'message.received';
-    data: Message;
-}
-/** Discriminated union of all webhook event types. Switch on `event.event` for type narrowing. */
-export type WebhookEvent = MessageSentEvent | MessageDeliveredEvent | MessageReadEvent | MessageFailedEvent | MessageReceivedEvent;
-/** Configuration for the iSnap SDK client. */
-export interface iSnapConfig {
-    /** Your iSnap API key (starts with `isnap_`). */
-    apiKey: string;
-    /** Override the base API URL. Defaults to `https://api.isnap.dev`. */
-    baseUrl?: string;
-    /** Maximum number of automatic retries on 429 responses. Defaults to `3`. */
+export type HttpMethod = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
+export interface ErrorIssue {
+    path: string;
+    message: string;
+    code: string;
+}
+export interface ErrorEnvelope {
+    status: number;
+    code: string;
+    message: string;
+    retry_after?: number;
+    issues?: ErrorIssue[];
+}
+export interface ResponseEnvelope<T = unknown> {
+    success: boolean;
+    data: T | null;
+    error: ErrorEnvelope | null;
+    trace_id?: string;
+    request_id?: string;
+}
+export interface RequestOptions {
+    idempotencyKey?: string;
+    signal?: AbortSignal;
     maxRetries?: number;
-    /** Fallback delay in milliseconds between retries when no `Retry-After` header is present. Defaults to `5000`. */
-    retryDelayMs?: number;
-}
-/** Error returned by the iSnap API. */
-export declare class iSnapError extends Error {
-    /** HTTP status code. */
-    statusCode: number;
-    /** Machine-readable error code (e.g. `'RATE_LIMITED'`). */
-    code?: string | undefined;
-    constructor(message: string, 
-    /** HTTP status code. */
-    statusCode: number, 
-    /** Machine-readable error code (e.g. `'RATE_LIMITED'`). */
-    code?: string | undefined);
-}
-/** Thrown when the API returns 429 Too Many Requests after exhausting retries. */
-export declare class RateLimitError extends iSnapError {
-    /** Seconds to wait before retrying. */
-    retryAfter: number;
-    constructor(message: string, 
-    /** Seconds to wait before retrying. */
-    retryAfter: number);
+    query?: Record<string, string | number | boolean | undefined | null>;
+    /**
+     * Extra headers to merge into the request. SDK defaults (User-Agent,
+     * Accept, Content-Type) can be overridden; SDK-managed Authorization and
+     * Idempotency-Key always win regardless of what is set here.
+     */
+    headers?: HeadersInit;
 }
-export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;AAEpE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAA;IACd,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;IACpE;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAA;CACtB"}

package/dist/types.js

@@ -1,29 +1,2 @@
-// ── Message ──────────────────────────────────────────────────────────────────
-// ── Errors ───────────────────────────────────────────────────────────────────
-/** Error returned by the iSnap API. */
-export class iSnapError extends Error {
-    statusCode;
-    code;
-    constructor(message, 
-    /** HTTP status code. */
-    statusCode, 
-    /** Machine-readable error code (e.g. `'RATE_LIMITED'`). */
-    code) {
-        super(message);
-        this.statusCode = statusCode;
-        this.code = code;
-        this.name = 'iSnapError';
-    }
-}
-/** Thrown when the API returns 429 Too Many Requests after exhausting retries. */
-export class RateLimitError extends iSnapError {
-    retryAfter;
-    constructor(message, 
-    /** Seconds to wait before retrying. */
-    retryAfter) {
-        super(message, 429, 'RATE_LIMITED');
-        this.retryAfter = retryAfter;
-        this.name = 'RateLimitError';
-    }
-}
+export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AA8NhF,gFAAgF;AAEhF,uCAAuC;AACvC,MAAM,OAAO,UAAW,SAAQ,KAAK;IAI1B;IAEA;IALT,YACE,OAAe;IACf,wBAAwB;IACjB,UAAkB;IACzB,2DAA2D;IACpD,IAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,eAAU,GAAV,UAAU,CAAQ;QAElB,SAAI,GAAJ,IAAI,CAAS;QAGpB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,kFAAkF;AAClF,MAAM,OAAO,cAAe,SAAQ,UAAU;IAInC;IAHT,YACE,OAAe;IACf,uCAAuC;IAChC,UAAkB;QAEzB,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;QAF7B,eAAU,GAAV,UAAU,CAAQ;QAGzB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+export declare const SDK_VERSION = "1.0.0";
+export declare const MIN_API_VERSION = "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,UAAU,CAAA;AAelC,eAAO,MAAM,eAAe,UAAU,CAAA"}

package/dist/version.js

@@ -0,0 +1,20 @@
+// SDK version. Bumped INDEPENDENTLY of the API contract version per
+// industry standard (Stripe, Twilio, OpenAI, AWS): SDK semver tracks SDK
+// changes (new methods, retry logic, type fixes), API semver tracks the
+// contract surface. Synced with `package.json` by the release flow.
+export const SDK_VERSION = '1.0.0';
+// Minimum API version the SDK considers compatible. Reference-only
+// today: the client does NOT yet fetch `/v1/version` at first request,
+// and there is no `IncompatibleApiVersionError` thrown on a lower
+// backend. The runtime precheck (and the corresponding error type) is a
+// follow-up — until it ships, this constant is documentation that
+// downstream tooling can read but the client itself does not enforce.
+//
+// Bump this when the SDK starts using a feature that requires a specific
+// backend version (e.g. a new endpoint added in API minor X.Y.0 — the
+// SDK that wraps it sets MIN_API_VERSION to X.Y.0). Within a major
+// version (1.x), the API stays additive (oasdiff
+// `--deprecation-days-stable 30` enforced in CI), so a 1.0.0 SDK keeps
+// working against any 1.x backend without raising the floor.
+export const MIN_API_VERSION = '1.0.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,yEAAyE;AACzE,wEAAwE;AACxE,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA;AAElC,mEAAmE;AACnE,uEAAuE;AACvE,kEAAkE;AAClE,wEAAwE;AACxE,kEAAkE;AAClE,sEAAsE;AACtE,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,mEAAmE;AACnE,iDAAiD;AACjD,uEAAuE;AACvE,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAA"}

package/dist/webhooks/parse.d.ts

@@ -0,0 +1,15 @@
+import type { WebhookEventBase } from './types.js';
+/**
+ * Parse a raw webhook delivery body into a typed envelope. Throws
+ * `WebhookSignatureError` if the body is not valid JSON or doesn't carry
+ * the §4.1 envelope shape (`event_id`, `event_type`, `data`). Use
+ * `verifyWebhook` for the full HMAC + replay-window verification — this
+ * is the parsing-only half for cases where verification happened
+ * out-of-band (e.g. behind a trusted gateway).
+ *
+ * **Consumers MUST dedupe by `event.event_id`** — webhook delivery is
+ * at-least-once, so retries replay the same envelope. Without dedup,
+ * processing the same event twice produces duplicate side-effects.
+ */
+export declare function parseWebhookEvent(rawBody: string): WebhookEventBase;
+//# sourceMappingURL=parse.d.ts.map

package/dist/webhooks/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/webhooks/parse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAiCnE"}