@isnap/sdk 0.1.0

package/dist/resources/messages.d.ts

@@ -0,0 +1,77 @@
+import type { iSnapClient } from '../client.js';
+import type { Message, SendMessageParams, ListMessagesParams, ListMessagesResponse, ListConversationsParams, ListConversationsResponse, ConversationThreadParams, ConversationThreadResponse } from '../types.js';
+export declare class MessagesResource {
+    private client;
+    constructor(client: iSnapClient);
+    /**
+     * Send a new message.
+     *
+     * @param params - Message details (line, recipient, body)
+     * @returns The created message
+     * @throws {iSnapError} On validation or delivery errors
+     *
+     * @example
+     * ```ts
+     * const msg = await client.messages.send({
+     *   line_id: 'ln-1',
+     *   to: '+15551234567',
+     *   body: 'Hello from iSnap!',
+     * });
+     * ```
+     */
+    send(params: SendMessageParams): Promise<Message>;
+    /**
+     * Retrieve a single message by ID.
+     *
+     * @param messageId - The message ID
+     * @returns The message
+     * @throws {iSnapError} If the message is not found
+     *
+     * @example
+     * ```ts
+     * const msg = await client.messages.get('msg-abc123');
+     * ```
+     */
+    get(messageId: string): Promise<Message>;
+    /**
+     * List messages with optional filters and pagination.
+     *
+     * @param params - Optional filters (line_id, status, direction) and pagination
+     * @returns Paginated list of messages
+     *
+     * @example
+     * ```ts
+     * const { messages, total } = await client.messages.list({ status: 'delivered', limit: 50 });
+     * ```
+     */
+    list(params?: ListMessagesParams): Promise<ListMessagesResponse>;
+    /**
+     * List all conversations with optional filters and pagination.
+     *
+     * @param params - Optional line_id filter and pagination
+     * @returns Paginated list of conversations
+     *
+     * @example
+     * ```ts
+     * const { conversations } = await client.messages.listConversations({ line_id: 'ln-1' });
+     * ```
+     */
+    listConversations(params?: ListConversationsParams): Promise<ListConversationsResponse>;
+    /**
+     * Retrieve a full conversation thread by ID, including its messages.
+     *
+     * @param conversationId - The conversation ID
+     * @param params - Optional pagination for messages within the thread
+     * @returns The conversation with paginated messages
+     * @throws {iSnapError} If the conversation is not found
+     *
+     * @example
+     * ```ts
+     * const thread = await client.messages.getConversation('conv-abc123', { page: 1, limit: 25 });
+     * console.log(thread.conversation.contact_number);
+     * console.log(thread.messages.length);
+     * ```
+     */
+    getConversation(conversationId: string, params?: ConversationThreadParams): Promise<ConversationThreadResponse>;
+}
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/resources/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,aAAa,CAAC;AAErB,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD;;;;;;;;;;;OAWG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;;;;;;;;;OAUG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAWtE;;;;;;;;;;OAUG;IACG,iBAAiB,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAS7F;;;;;;;;;;;;;;OAcG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;CAYtH"}

package/dist/resources/messages.js

@@ -0,0 +1,110 @@
+export class MessagesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Send a new message.
+     *
+     * @param params - Message details (line, recipient, body)
+     * @returns The created message
+     * @throws {iSnapError} On validation or delivery errors
+     *
+     * @example
+     * ```ts
+     * const msg = await client.messages.send({
+     *   line_id: 'ln-1',
+     *   to: '+15551234567',
+     *   body: 'Hello from iSnap!',
+     * });
+     * ```
+     */
+    async send(params) {
+        return this.client.request('POST', '/v1/messages', params);
+    }
+    /**
+     * Retrieve a single message by ID.
+     *
+     * @param messageId - The message ID
+     * @returns The message
+     * @throws {iSnapError} If the message is not found
+     *
+     * @example
+     * ```ts
+     * const msg = await client.messages.get('msg-abc123');
+     * ```
+     */
+    async get(messageId) {
+        return this.client.request('GET', `/v1/messages/${messageId}`);
+    }
+    /**
+     * List messages with optional filters and pagination.
+     *
+     * @param params - Optional filters (line_id, status, direction) and pagination
+     * @returns Paginated list of messages
+     *
+     * @example
+     * ```ts
+     * const { messages, total } = await client.messages.list({ status: 'delivered', limit: 50 });
+     * ```
+     */
+    async list(params) {
+        const query = {};
+        if (params?.line_id)
+            query.line_id = params.line_id;
+        if (params?.status)
+            query.status = params.status;
+        if (params?.direction)
+            query.direction = params.direction;
+        if (params?.page)
+            query.page = String(params.page);
+        if (params?.limit)
+            query.limit = String(params.limit);
+        return this.client.request('GET', '/v1/messages', undefined, query);
+    }
+    /**
+     * List all conversations with optional filters and pagination.
+     *
+     * @param params - Optional line_id filter and pagination
+     * @returns Paginated list of conversations
+     *
+     * @example
+     * ```ts
+     * const { conversations } = await client.messages.listConversations({ line_id: 'ln-1' });
+     * ```
+     */
+    async listConversations(params) {
+        const query = {};
+        if (params?.line_id)
+            query.line_id = params.line_id;
+        if (params?.page)
+            query.page = String(params.page);
+        if (params?.limit)
+            query.limit = String(params.limit);
+        return this.client.request('GET', '/v1/messages/conversations', undefined, query);
+    }
+    /**
+     * Retrieve a full conversation thread by ID, including its messages.
+     *
+     * @param conversationId - The conversation ID
+     * @param params - Optional pagination for messages within the thread
+     * @returns The conversation with paginated messages
+     * @throws {iSnapError} If the conversation is not found
+     *
+     * @example
+     * ```ts
+     * const thread = await client.messages.getConversation('conv-abc123', { page: 1, limit: 25 });
+     * console.log(thread.conversation.contact_number);
+     * console.log(thread.messages.length);
+     * ```
+     */
+    async getConversation(conversationId, params) {
+        const query = {};
+        if (params?.page)
+            query.page = String(params.page);
+        if (params?.limit)
+            query.limit = String(params.limit);
+        return this.client.request('GET', `/v1/messages/conversations/${conversationId}`, undefined, query);
+    }
+}
+//# sourceMappingURL=messages.js.map

package/dist/resources/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/resources/messages.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAE3C;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,IAAI,CAAC,MAAyB;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAU,KAAK,EAAE,gBAAgB,SAAS,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,CAAC,MAA2B;QACpC,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,MAAM,EAAE,OAAO;YAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACpD,IAAI,MAAM,EAAE,MAAM;YAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACjD,IAAI,MAAM,EAAE,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAC1D,IAAI,MAAM,EAAE,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAuB,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAAgC;QACtD,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,MAAM,EAAE,OAAO;YAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACpD,IAAI,MAAM,EAAE,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAA4B,KAAK,EAAE,4BAA4B,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAC/G,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,eAAe,CAAC,cAAsB,EAAE,MAAiC;QAC7E,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,MAAM,EAAE,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,MAAM,EAAE,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEtD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CACxB,KAAK,EACL,8BAA8B,cAAc,EAAE,EAC9C,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;CACF"}

package/dist/resources/webhooks.d.ts

@@ -0,0 +1,48 @@
+import type { iSnapClient } from '../client.js';
+import type { Webhook, CreateWebhookParams } from '../types.js';
+export declare class WebhooksResource {
+    private client;
+    constructor(client: iSnapClient);
+    /**
+     * 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
+     * ```
+     */
+    create(params: CreateWebhookParams): Promise<Webhook>;
+    /**
+     * List all registered webhooks.
+     *
+     * @returns Object containing the webhooks array
+     *
+     * @example
+     * ```ts
+     * const { webhooks } = await client.webhooks.list();
+     * ```
+     */
+    list(): Promise<{
+        webhooks: Webhook[];
+    }>;
+    /**
+     * Delete a webhook by ID.
+     *
+     * @param webhookId - The webhook ID to delete
+     * @throws {iSnapError} If the webhook is not found
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.delete('wh-abc123');
+     * ```
+     */
+    delete(webhookId: string): Promise<void>;
+}
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +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"}

package/dist/resources/webhooks.js

@@ -0,0 +1,52 @@
+export class WebhooksResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * 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
+     * ```
+     */
+    async create(params) {
+        return this.client.request('POST', '/v1/webhooks', params);
+    }
+    /**
+     * List all registered webhooks.
+     *
+     * @returns Object containing the webhooks array
+     *
+     * @example
+     * ```ts
+     * const { webhooks } = await client.webhooks.list();
+     * ```
+     */
+    async list() {
+        return this.client.request('GET', '/v1/webhooks');
+    }
+    /**
+     * Delete a webhook by ID.
+     *
+     * @param webhookId - The webhook ID to delete
+     * @throws {iSnapError} If the webhook is not found
+     *
+     * @example
+     * ```ts
+     * await client.webhooks.delete('wh-abc123');
+     * ```
+     */
+    async delete(webhookId) {
+        return this.client.request('DELETE', `/v1/webhooks/${webhookId}`);
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/resources/webhooks.js.map

@@ -0,0 +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"}

package/dist/types.d.ts

@@ -0,0 +1,199 @@
+/** 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`. */
+    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);
+}
+export {};
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,29 @@
+// ── 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';
+    }
+}
+//# 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,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"}

package/dist/webhook-events.d.ts

@@ -0,0 +1,61 @@
+import type { WebhookEvent } from './types.js';
+/**
+ * Parameters for parsing an incoming webhook request.
+ */
+export interface ParseWebhookOptions {
+    /** The webhook secret (from {@link Webhook.secret}). */
+    secret: string;
+    /** The `x-isnap-signature` header value. */
+    signature: string;
+    /** The `x-isnap-timestamp` header value (Unix seconds). */
+    timestamp: string;
+    /** The raw request body string. */
+    body: string;
+}
+/**
+ * Result of parsing a webhook request.
+ */
+export interface ParseWebhookResult {
+    /** Whether the signature was valid and the timestamp was fresh. */
+    verified: boolean;
+    /** The parsed and typed webhook event. Only meaningful when `verified` is `true`. */
+    event: WebhookEvent;
+}
+/**
+ * Verify and parse an incoming webhook request in a single call.
+ *
+ * Combines signature verification with JSON parsing to produce a typed
+ * {@link WebhookEvent} that supports discriminated-union narrowing.
+ *
+ * @param options - Signature, timestamp, secret, and raw body
+ * @returns Object with `verified` flag and the parsed `event`
+ *
+ * @example
+ * ```ts
+ * import { parseWebhook } from '@isnap/sdk';
+ *
+ * app.post('/webhooks/isnap', (req, res) => {
+ *   const { verified, event } = parseWebhook({
+ *     secret: process.env.WEBHOOK_SECRET!,
+ *     signature: req.headers['x-isnap-signature'] as string,
+ *     timestamp: req.headers['x-isnap-timestamp'] as string,
+ *     body: req.body, // raw string
+ *   });
+ *
+ *   if (!verified) return res.status(401).send('Invalid signature');
+ *
+ *   switch (event.event) {
+ *     case 'message.sent':
+ *       console.log('Sent:', event.data.id);
+ *       break;
+ *     case 'message.received':
+ *       console.log('Received:', event.data.body);
+ *       break;
+ *   }
+ *
+ *   res.sendStatus(200);
+ * });
+ * ```
+ */
+export declare function parseWebhook(options: ParseWebhookOptions): ParseWebhookResult;
+//# sourceMappingURL=webhook-events.d.ts.map

package/dist/webhook-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-events.d.ts","sourceRoot":"","sources":["../src/webhook-events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,QAAQ,EAAE,OAAO,CAAC;IAClB,qFAAqF;IACrF,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAK7E"}

package/dist/webhook-events.js

@@ -0,0 +1,44 @@
+import { verifyWebhookSignature } from './webhook-verify.js';
+/**
+ * Verify and parse an incoming webhook request in a single call.
+ *
+ * Combines signature verification with JSON parsing to produce a typed
+ * {@link WebhookEvent} that supports discriminated-union narrowing.
+ *
+ * @param options - Signature, timestamp, secret, and raw body
+ * @returns Object with `verified` flag and the parsed `event`
+ *
+ * @example
+ * ```ts
+ * import { parseWebhook } from '@isnap/sdk';
+ *
+ * app.post('/webhooks/isnap', (req, res) => {
+ *   const { verified, event } = parseWebhook({
+ *     secret: process.env.WEBHOOK_SECRET!,
+ *     signature: req.headers['x-isnap-signature'] as string,
+ *     timestamp: req.headers['x-isnap-timestamp'] as string,
+ *     body: req.body, // raw string
+ *   });
+ *
+ *   if (!verified) return res.status(401).send('Invalid signature');
+ *
+ *   switch (event.event) {
+ *     case 'message.sent':
+ *       console.log('Sent:', event.data.id);
+ *       break;
+ *     case 'message.received':
+ *       console.log('Received:', event.data.body);
+ *       break;
+ *   }
+ *
+ *   res.sendStatus(200);
+ * });
+ * ```
+ */
+export function parseWebhook(options) {
+    const { secret, signature, timestamp, body } = options;
+    const event = JSON.parse(body);
+    const verified = verifyWebhookSignature(secret, signature, timestamp, body);
+    return { verified, event };
+}
+//# sourceMappingURL=webhook-events.js.map

package/dist/webhook-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-events.js","sourceRoot":"","sources":["../src/webhook-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AA2B7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACvD,MAAM,KAAK,GAAiB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC5E,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}