@isnap/sdk 0.1.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,236 @@
+# @isnap/sdk
+
+[![CI](https://github.com/isnap-dev/isnap-node/actions/workflows/ci.yml/badge.svg)](https://github.com/isnap-dev/isnap-node/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@isnap/sdk.svg)](https://www.npmjs.com/package/@isnap/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Official Node.js/TypeScript SDK for the [iSnap](https://isnap.dev) messaging API. Zero runtime dependencies.
+
+## Installation
+
+```bash
+npm install @isnap/sdk
+```
+
+## Quick Start
+
+```ts
+import { init } from '@isnap/sdk';
+
+const client = init({ apiKey: 'isnap_your_api_key' });
+
+const msg = await client.messages.send({
+  line_id: 'ln-1',
+  to: '+15551234567',
+  body: 'Hello from iSnap!',
+});
+
+console.log(msg.id, msg.status);
+```
+
+## Messages
+
+```ts
+// Send a message
+const msg = await client.messages.send({
+  line_id: 'ln-1',
+  to: '+15551234567',
+  body: 'Hello!',
+  channel: 'sms',              // optional: 'auto' | 'imessage' | 'sms' | 'whatsapp'
+  webhook_url: 'https://...',  // optional: delivery status callback
+  metadata: { order_id: '42' },
+});
+
+// Get a message by ID
+const message = await client.messages.get('msg-abc123');
+
+// List messages with filters
+const { messages, total } = await client.messages.list({
+  status: 'delivered',
+  direction: 'outbound',
+  page: 1,
+  limit: 50,
+});
+
+// List conversations
+const { conversations } = await client.messages.listConversations({
+  line_id: 'ln-1',
+});
+
+// Get a full conversation thread
+const thread = await client.messages.getConversation('conv-abc123', {
+  page: 1,
+  limit: 25,
+});
+console.log(thread.conversation.contact_number);
+console.log(thread.messages);
+```
+
+## Lines
+
+```ts
+// List lines with filters
+const { lines } = await client.lines.list({
+  type: 'iphone',
+  area_code: '415',
+});
+
+// Get a line by ID
+const line = await client.lines.get('ln-abc123');
+console.log(line.phone_number, line.status);
+```
+
+## Webhooks
+
+### Managing webhook endpoints
+
+```ts
+// Create a webhook
+const wh = await client.webhooks.create({
+  url: 'https://example.com/webhooks/isnap',
+  events: ['message.sent', 'message.delivered', 'message.received'],
+});
+// Save wh.secret for signature verification
+
+// List webhooks
+const { webhooks } = await client.webhooks.list();
+
+// Delete a webhook
+await client.webhooks.delete('wh-abc123');
+```
+
+### Receiving webhooks
+
+Use `parseWebhook` to verify signatures and get typed events in one call:
+
+```ts
+import { parseWebhook } from '@isnap/sdk';
+// or: import { parseWebhook } from '@isnap/sdk/webhooks';
+
+app.post('/webhooks/isnap', express.text({ type: '*/*' }), (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,
+  });
+
+  if (!verified) return res.status(401).send('Invalid signature');
+
+  switch (event.event) {
+    case 'message.sent':
+      console.log('Sent:', event.data.id);
+      break;
+    case 'message.delivered':
+      console.log('Delivered:', event.data.id);
+      break;
+    case 'message.received':
+      console.log('Inbound:', event.data.from_number, event.data.body);
+      break;
+    case 'message.read':
+      console.log('Read:', event.data.id);
+      break;
+    case 'message.failed':
+      console.log('Failed:', event.data.id, event.data.error_message);
+      break;
+  }
+
+  res.sendStatus(200);
+});
+```
+
+You can also verify signatures manually:
+
+```ts
+import { verifyWebhookSignature } from '@isnap/sdk';
+
+const valid = verifyWebhookSignature(
+  secret,
+  req.headers['x-isnap-signature'],
+  req.headers['x-isnap-timestamp'],
+  req.body,
+);
+```
+
+## Pagination
+
+Use the `paginate` async generator to iterate over large collections:
+
+```ts
+import { init, paginate } from '@isnap/sdk';
+
+const client = init({ apiKey: 'isnap_your_key' });
+
+// Iterate over all delivered messages
+for await (const msg of paginate(
+  (p) => client.messages.list(p),
+  { status: 'delivered' },
+  'messages',
+)) {
+  console.log(msg.id, msg.body);
+}
+
+// Iterate over all conversations
+for await (const conv of paginate(
+  (p) => client.messages.listConversations(p),
+  { line_id: 'ln-1' },
+  'conversations',
+)) {
+  console.log(conv.contact_number, conv.message_count);
+}
+```
+
+## Error Handling
+
+```ts
+import { iSnapError, RateLimitError } from '@isnap/sdk';
+
+try {
+  await client.messages.send({ line_id: 'ln-1', to: '+15551234567', body: 'Hello' });
+} catch (err) {
+  if (err instanceof RateLimitError) {
+    console.log(`Rate limited — retry after ${err.retryAfter}s`);
+  } else if (err instanceof iSnapError) {
+    console.log(`API error ${err.statusCode}: ${err.message} (${err.code})`);
+  }
+}
+```
+
+### Retry configuration
+
+The client automatically retries on 429 responses. Customize the behavior:
+
+```ts
+const client = init({
+  apiKey: 'isnap_your_key',
+  maxRetries: 5,        // default: 3
+  retryDelayMs: 2000,   // default: 5000 (fallback when no Retry-After header)
+});
+```
+
+## TypeScript
+
+All types are exported from the main entry point:
+
+```ts
+import type {
+  Message,
+  SendMessageParams,
+  Line,
+  Webhook,
+  Conversation,
+  ConversationThreadResponse,
+  WebhookEvent,
+  WebhookEventType,
+  MessageSentEvent,
+  iSnapConfig,
+} from '@isnap/sdk';
+```
+
+## Contributing
+
+Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](LICENSE)

package/dist/client.d.ts

@@ -0,0 +1,61 @@
+import type { iSnapConfig } from './types.js';
+import { MessagesResource } from './resources/messages.js';
+import { LinesResource } from './resources/lines.js';
+import { WebhooksResource } from './resources/webhooks.js';
+/**
+ * The iSnap SDK client. Provides access to all API resources.
+ *
+ * @example
+ * ```ts
+ * import { init } from '@isnap/sdk';
+ *
+ * const client = init({ apiKey: 'isnap_your_key' });
+ * const msg = await client.messages.send({ line_id: 'ln-1', to: '+15551234567', body: 'Hello' });
+ * ```
+ */
+export declare class iSnapClient {
+    private apiKey;
+    private baseUrl;
+    private maxRetries;
+    private retryDelayMs;
+    /** Message sending, retrieval, and conversation management. */
+    messages: MessagesResource;
+    /** Phone line listing and lookup. */
+    lines: LinesResource;
+    /** Webhook endpoint management. */
+    webhooks: WebhooksResource;
+    constructor(config: iSnapConfig);
+    /**
+     * Send an HTTP request to the iSnap API.
+     *
+     * Handles authorization, JSON serialization, rate-limit retries, and error mapping.
+     *
+     * @param method - HTTP method (GET, POST, DELETE, etc.)
+     * @param path - API path (e.g. `/v1/messages`)
+     * @param body - Optional request body (will be JSON-stringified)
+     * @param query - Optional query parameters
+     * @returns Parsed JSON response
+     * @throws {iSnapError} On non-2xx responses
+     * @throws {RateLimitError} When rate-limited after exhausting retries
+     */
+    request<T>(method: string, path: string, body?: unknown, query?: Record<string, string>): Promise<T>;
+}
+/**
+ * Create a new iSnap SDK client.
+ *
+ * @param config - API key and optional settings
+ * @returns A configured {@link iSnapClient} instance
+ *
+ * @example
+ * ```ts
+ * import { init } from '@isnap/sdk';
+ *
+ * const client = init({
+ *   apiKey: 'isnap_your_key',
+ *   maxRetries: 5,
+ *   retryDelayMs: 2000,
+ * });
+ * ```
+ */
+export declare function init(config: iSnapConfig): iSnapClient;
+//# 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":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;IAE7B,+DAA+D;IACxD,QAAQ,EAAE,gBAAgB,CAAC;IAClC,qCAAqC;IAC9B,KAAK,EAAE,aAAa,CAAC;IAC5B,mCAAmC;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;gBAEtB,MAAM,EAAE,WAAW;IAW/B;;;;;;;;;;;;OAYG;IACG,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAsD3G;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAErD"}

package/dist/client.js

@@ -0,0 +1,115 @@
+import { iSnapError, RateLimitError } from './types.js';
+import { MessagesResource } from './resources/messages.js';
+import { LinesResource } from './resources/lines.js';
+import { WebhooksResource } from './resources/webhooks.js';
+/**
+ * The iSnap SDK client. Provides access to all API resources.
+ *
+ * @example
+ * ```ts
+ * import { init } from '@isnap/sdk';
+ *
+ * const client = init({ apiKey: 'isnap_your_key' });
+ * const msg = await client.messages.send({ line_id: 'ln-1', to: '+15551234567', body: 'Hello' });
+ * ```
+ */
+export class iSnapClient {
+    apiKey;
+    baseUrl;
+    maxRetries;
+    retryDelayMs;
+    /** Message sending, retrieval, and conversation management. */
+    messages;
+    /** Phone line listing and lookup. */
+    lines;
+    /** Webhook endpoint management. */
+    webhooks;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = (config.baseUrl ?? 'https://api.isnap.dev').replace(/\/$/, '');
+        this.maxRetries = config.maxRetries ?? 3;
+        this.retryDelayMs = config.retryDelayMs ?? 5000;
+        this.messages = new MessagesResource(this);
+        this.lines = new LinesResource(this);
+        this.webhooks = new WebhooksResource(this);
+    }
+    /**
+     * Send an HTTP request to the iSnap API.
+     *
+     * Handles authorization, JSON serialization, rate-limit retries, and error mapping.
+     *
+     * @param method - HTTP method (GET, POST, DELETE, etc.)
+     * @param path - API path (e.g. `/v1/messages`)
+     * @param body - Optional request body (will be JSON-stringified)
+     * @param query - Optional query parameters
+     * @returns Parsed JSON response
+     * @throws {iSnapError} On non-2xx responses
+     * @throws {RateLimitError} When rate-limited after exhausting retries
+     */
+    async request(method, path, body, query) {
+        let url = `${this.baseUrl}${path}`;
+        if (query) {
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== '')
+                    params.set(key, value);
+            }
+            const qs = params.toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const headers = {
+            Authorization: this.apiKey,
+        };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            const res = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            if (res.status === 429) {
+                const retryAfterHeader = res.headers.get('Retry-After');
+                const retryAfter = retryAfterHeader !== null
+                    ? parseInt(retryAfterHeader, 10)
+                    : this.retryDelayMs / 1000;
+                if (attempt < this.maxRetries) {
+                    await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000));
+                    continue;
+                }
+                throw new RateLimitError(`Rate limit exceeded`, retryAfter);
+            }
+            if (!res.ok) {
+                const err = await res.json().catch(() => ({ message: `HTTP ${res.status}` }));
+                throw new iSnapError(err.message || `HTTP ${res.status}`, res.status, err.code);
+            }
+            if (res.status === 204)
+                return undefined;
+            return res.json();
+        }
+        throw new iSnapError('Max retries exceeded', 429);
+    }
+}
+/**
+ * Create a new iSnap SDK client.
+ *
+ * @param config - API key and optional settings
+ * @returns A configured {@link iSnapClient} instance
+ *
+ * @example
+ * ```ts
+ * import { init } from '@isnap/sdk';
+ *
+ * const client = init({
+ *   apiKey: 'isnap_your_key',
+ *   maxRetries: 5,
+ *   retryDelayMs: 2000,
+ * });
+ * ```
+ */
+export function init(config) {
+    return new iSnapClient(config);
+}
+//# 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,11 @@
+export { iSnapClient, init } from './client.js';
+export { MessagesResource } from './resources/messages.js';
+export { LinesResource } from './resources/lines.js';
+export { WebhooksResource } from './resources/webhooks.js';
+export type { iSnapConfig, Message, SendMessageParams, ListMessagesParams, ListMessagesResponse, Line, ListLinesParams, ListLinesResponse, Webhook, CreateWebhookParams, Conversation, ListConversationsParams, ListConversationsResponse, ConversationThreadParams, ConversationThreadResponse, WebhookEventType, WebhookEvent, MessageSentEvent, MessageDeliveredEvent, MessageReadEvent, MessageFailedEvent, MessageReceivedEvent, } from './types.js';
+export { iSnapError, RateLimitError } from './types.js';
+export { verifyWebhookSignature } from './webhook-verify.js';
+export { parseWebhook } from './webhook-events.js';
+export type { ParseWebhookOptions, ParseWebhookResult } from './webhook-events.js';
+export { paginate } from './paginate.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,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,WAAW,EACX,OAAO,EACP,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,IAAI,EACJ,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { iSnapClient, init } from './client.js';
+export { MessagesResource } from './resources/messages.js';
+export { LinesResource } from './resources/lines.js';
+export { WebhooksResource } from './resources/webhooks.js';
+export { iSnapError, RateLimitError } from './types.js';
+export { verifyWebhookSignature } from './webhook-verify.js';
+export { parseWebhook } from './webhook-events.js';
+export { paginate } from './paginate.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,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAyB3D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/paginate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Generic async generator that paginates over any SDK list endpoint.
+ *
+ * Yields individual items from each page until all pages have been consumed.
+ *
+ * @param fetcher - A function that accepts `{ page, limit }` and returns a paginated response
+ * @param params - Initial pagination parameters (defaults: `page = 1`, `limit = 100`)
+ * @param dataKey - The key in the response object that holds the array of items
+ *
+ * @example
+ * ```ts
+ * import { init, paginate } from '@isnap/sdk';
+ *
+ * const client = init({ apiKey: 'isnap_your_key' });
+ *
+ * for await (const msg of paginate(
+ *   (p) => client.messages.list(p),
+ *   { status: 'delivered' },
+ *   'messages',
+ * )) {
+ *   console.log(msg.id, msg.body);
+ * }
+ * ```
+ */
+export declare function paginate<TItem, TParams extends {
+    page?: number;
+    limit?: number;
+}, TKey extends string>(fetcher: (params: TParams) => Promise<{
+    total: number;
+    page: number;
+    limit: number;
+} & Record<TKey, TItem[]>>, params: TParams, dataKey: TKey): AsyncGenerator<TItem, void, undefined>;
+//# sourceMappingURL=paginate.d.ts.map

package/dist/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../src/paginate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAuB,QAAQ,CAC7B,KAAK,EACL,OAAO,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EACjD,IAAI,SAAS,MAAM,EAEnB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAC7G,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,IAAI,GACZ,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAkBxC"}

package/dist/paginate.js

@@ -0,0 +1,40 @@
+/**
+ * Generic async generator that paginates over any SDK list endpoint.
+ *
+ * Yields individual items from each page until all pages have been consumed.
+ *
+ * @param fetcher - A function that accepts `{ page, limit }` and returns a paginated response
+ * @param params - Initial pagination parameters (defaults: `page = 1`, `limit = 100`)
+ * @param dataKey - The key in the response object that holds the array of items
+ *
+ * @example
+ * ```ts
+ * import { init, paginate } from '@isnap/sdk';
+ *
+ * const client = init({ apiKey: 'isnap_your_key' });
+ *
+ * for await (const msg of paginate(
+ *   (p) => client.messages.list(p),
+ *   { status: 'delivered' },
+ *   'messages',
+ * )) {
+ *   console.log(msg.id, msg.body);
+ * }
+ * ```
+ */
+export async function* paginate(fetcher, params, dataKey) {
+    let page = params.page ?? 1;
+    const limit = params.limit ?? 100;
+    while (true) {
+        const response = await fetcher({ ...params, page, limit });
+        const items = response[dataKey];
+        for (const item of items) {
+            yield item;
+        }
+        if (items.length < limit || page * limit >= response.total) {
+            break;
+        }
+        page++;
+    }
+}
+//# sourceMappingURL=paginate.js.map

package/dist/paginate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../src/paginate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,QAAQ,CAK7B,OAA6G,EAC7G,MAAe,EACf,OAAa;IAEb,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAC;IAElC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,KAAK,EAAa,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC;QACb,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC3D,MAAM;QACR,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC;AACH,CAAC"}

package/dist/resources/lines.d.ts

@@ -0,0 +1,33 @@
+import type { iSnapClient } from '../client.js';
+import type { Line, ListLinesParams, ListLinesResponse } from '../types.js';
+export declare class LinesResource {
+    private client;
+    constructor(client: iSnapClient);
+    /**
+     * List phone lines with optional filters and pagination.
+     *
+     * @param params - Optional filters (type, area_code) and pagination
+     * @returns Paginated list of lines
+     *
+     * @example
+     * ```ts
+     * const { lines } = await client.lines.list({ type: 'iphone', limit: 10 });
+     * ```
+     */
+    list(params?: ListLinesParams): Promise<ListLinesResponse>;
+    /**
+     * Retrieve a single line by ID.
+     *
+     * @param lineId - The line ID
+     * @returns The line
+     * @throws {iSnapError} If the line is not found
+     *
+     * @example
+     * ```ts
+     * const line = await client.lines.get('ln-abc123');
+     * console.log(line.phone_number);
+     * ```
+     */
+    get(lineId: string): Promise<Line>;
+}
+//# sourceMappingURL=lines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../src/resources/lines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE5E,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEvC;;;;;;;;;;OAUG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUhE;;;;;;;;;;;;OAYG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/dist/resources/lines.js

@@ -0,0 +1,46 @@
+export class LinesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * List phone lines with optional filters and pagination.
+     *
+     * @param params - Optional filters (type, area_code) and pagination
+     * @returns Paginated list of lines
+     *
+     * @example
+     * ```ts
+     * const { lines } = await client.lines.list({ type: 'iphone', limit: 10 });
+     * ```
+     */
+    async list(params) {
+        const query = {};
+        if (params?.type)
+            query.type = params.type;
+        if (params?.area_code)
+            query.area_code = params.area_code;
+        if (params?.page)
+            query.page = String(params.page);
+        if (params?.limit)
+            query.limit = String(params.limit);
+        return this.client.request('GET', '/lines', undefined, query);
+    }
+    /**
+     * Retrieve a single line by ID.
+     *
+     * @param lineId - The line ID
+     * @returns The line
+     * @throws {iSnapError} If the line is not found
+     *
+     * @example
+     * ```ts
+     * const line = await client.lines.get('ln-abc123');
+     * console.log(line.phone_number);
+     * ```
+     */
+    async get(lineId) {
+        return this.client.request('GET', `/lines/${lineId}`);
+    }
+}
+//# sourceMappingURL=lines.js.map

package/dist/resources/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../src/resources/lines.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,aAAa;IACJ;IAApB,YAAoB,MAAmB;QAAnB,WAAM,GAAN,MAAM,CAAa;IAAG,CAAC;IAE3C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,CAAC,MAAwB;QACjC,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,MAAM,EAAE,IAAI;YAAE,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAC3C,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,CAAoB,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACnF,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAO,KAAK,EAAE,UAAU,MAAM,EAAE,CAAC,CAAC;IAC9D,CAAC;CACF"}