@inkbox/sdk 0.1.0

package/dist/mail/resources/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../../src/mail/resources/threads.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAGL,MAAM,EACN,YAAY,EAGb,MAAM,aAAa,CAAC;AAIrB,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;;;;;;OAWG;IACI,IAAI,CACT,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9B,cAAc,CAAC,MAAM,CAAC;IAiBzB;;;;;OAKG;IACG,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAOxE,uBAAuB;IACjB,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpE"}

package/dist/mail/resources/threads.js

@@ -0,0 +1,53 @@
+/**
+ * inkbox-mail/resources/threads.ts
+ *
+ * Thread operations: list (auto-paginated), get with messages, delete.
+ */
+import { parseThread, parseThreadDetail, } from "../types.js";
+const DEFAULT_PAGE_SIZE = 50;
+export class ThreadsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Async iterator over all threads in a mailbox, most recent activity first.
+     *
+     * Pagination is handled automatically — just iterate.
+     *
+     * @example
+     * ```ts
+     * for await (const thread of client.threads.list(emailAddress)) {
+     *   console.log(thread.subject, thread.messageCount);
+     * }
+     * ```
+     */
+    async *list(emailAddress, options) {
+        const limit = options?.pageSize ?? DEFAULT_PAGE_SIZE;
+        let cursor;
+        while (true) {
+            const page = await this.http.get(`/mailboxes/${emailAddress}/threads`, { limit, cursor });
+            for (const item of page.items) {
+                yield parseThread(item);
+            }
+            if (!page.has_more)
+                break;
+            cursor = page.next_cursor ?? undefined;
+        }
+    }
+    /**
+     * Get a thread with all its messages inlined.
+     *
+     * @param emailAddress - Full email address of the owning mailbox.
+     * @param threadId - UUID of the thread.
+     */
+    async get(emailAddress, threadId) {
+        const data = await this.http.get(`/mailboxes/${emailAddress}/threads/${threadId}`);
+        return parseThreadDetail(data);
+    }
+    /** Delete a thread. */
+    async delete(emailAddress, threadId) {
+        await this.http.delete(`/mailboxes/${emailAddress}/threads/${threadId}`);
+    }
+}
+//# sourceMappingURL=threads.js.map

package/dist/mail/resources/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../../src/mail/resources/threads.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAKL,WAAW,EACX,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,CAAC,IAAI,CACT,YAAoB,EACpB,OAA+B;QAE/B,MAAM,KAAK,GAAG,OAAO,EAAE,QAAQ,IAAI,iBAAiB,CAAC;QACrD,IAAI,MAA0B,CAAC;QAE/B,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,cAAc,YAAY,UAAU,EACpC,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,MAAM;YAC1B,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,YAAoB,EAAE,QAAgB;QAC9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,cAAc,YAAY,YAAY,QAAQ,EAAE,CACjD,CAAC;QACF,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,MAAM,CAAC,YAAoB,EAAE,QAAgB;QACjD,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,YAAY,YAAY,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/mail/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * inkbox-mail TypeScript SDK — public types.
+ */
+export interface Mailbox {
+    id: string;
+    emailAddress: string;
+    displayName: string | null;
+    webhookUrl: string | null;
+    /** "active" | "paused" | "deleted" */
+    status: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Message {
+    id: string;
+    mailboxId: string;
+    threadId: string | null;
+    /** RFC 5322 Message-ID header value */
+    messageId: string;
+    fromAddress: string;
+    toAddresses: string[];
+    ccAddresses: string[] | null;
+    subject: string | null;
+    /** First ~200 characters of the plain-text body */
+    snippet: string | null;
+    direction: "inbound" | "outbound";
+    status: string;
+    isRead: boolean;
+    isStarred: boolean;
+    hasAttachments: boolean;
+    createdAt: Date;
+}
+export interface MessageDetail extends Message {
+    bodyText: string | null;
+    bodyHtml: string | null;
+    bccAddresses: string[] | null;
+    /** RFC 5322 In-Reply-To header value */
+    inReplyTo: string | null;
+    /** RFC 5322 References header values */
+    references: string[] | null;
+    attachmentMetadata: Record<string, unknown>[] | null;
+    sesMessageId: string | null;
+    updatedAt: Date;
+}
+export interface Thread {
+    id: string;
+    mailboxId: string;
+    subject: string | null;
+    /** "active" | "paused" | "deleted" */
+    status: string;
+    messageCount: number;
+    lastMessageAt: Date;
+    createdAt: Date;
+}
+export interface ThreadDetail extends Thread {
+    /** All messages in the thread, oldest-first */
+    messages: Message[];
+}
+export interface RawMailbox {
+    id: string;
+    email_address: string;
+    display_name: string | null;
+    webhook_url: string | null;
+    status: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface RawMessage {
+    id: string;
+    mailbox_id: string;
+    thread_id: string | null;
+    message_id: string;
+    from_address: string;
+    to_addresses: string[];
+    cc_addresses: string[] | null;
+    subject: string | null;
+    snippet: string | null;
+    direction: string;
+    status: string;
+    is_read: boolean;
+    is_starred: boolean;
+    has_attachments: boolean;
+    created_at: string;
+    body_text?: string | null;
+    body_html?: string | null;
+    bcc_addresses?: string[] | null;
+    in_reply_to?: string | null;
+    references?: string[] | null;
+    attachment_metadata?: Record<string, unknown>[] | null;
+    ses_message_id?: string | null;
+    updated_at?: string;
+}
+export interface RawThread {
+    id: string;
+    mailbox_id: string;
+    subject: string | null;
+    status: string;
+    message_count: number;
+    last_message_at: string;
+    created_at: string;
+    messages?: RawMessage[];
+}
+export interface RawCursorPage<T> {
+    items: T[];
+    next_cursor: string | null;
+    has_more: boolean;
+}
+export declare function parseMailbox(r: RawMailbox): Mailbox;
+export declare function parseMessage(r: RawMessage): Message;
+export declare function parseMessageDetail(r: RawMessage): MessageDetail;
+export declare function parseThread(r: RawThread): Thread;
+export declare function parseThreadDetail(r: RawThread): ThreadDetail;
+//# sourceMappingURL=types.d.ts.map

package/dist/mail/types.d.ts.map

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

package/dist/mail/types.js

@@ -0,0 +1,65 @@
+/**
+ * inkbox-mail TypeScript SDK — public types.
+ */
+// ---- parsers ----
+export function parseMailbox(r) {
+    return {
+        id: r.id,
+        emailAddress: r.email_address,
+        displayName: r.display_name,
+        webhookUrl: r.webhook_url,
+        status: r.status,
+        createdAt: new Date(r.created_at),
+        updatedAt: new Date(r.updated_at),
+    };
+}
+export function parseMessage(r) {
+    return {
+        id: r.id,
+        mailboxId: r.mailbox_id,
+        threadId: r.thread_id,
+        messageId: r.message_id,
+        fromAddress: r.from_address,
+        toAddresses: r.to_addresses,
+        ccAddresses: r.cc_addresses ?? null,
+        subject: r.subject,
+        snippet: r.snippet,
+        direction: r.direction,
+        status: r.status,
+        isRead: r.is_read,
+        isStarred: r.is_starred,
+        hasAttachments: r.has_attachments,
+        createdAt: new Date(r.created_at),
+    };
+}
+export function parseMessageDetail(r) {
+    return {
+        ...parseMessage(r),
+        bodyText: r.body_text ?? null,
+        bodyHtml: r.body_html ?? null,
+        bccAddresses: r.bcc_addresses ?? null,
+        inReplyTo: r.in_reply_to ?? null,
+        references: r.references ?? null,
+        attachmentMetadata: r.attachment_metadata ?? null,
+        sesMessageId: r.ses_message_id ?? null,
+        updatedAt: new Date(r.updated_at),
+    };
+}
+export function parseThread(r) {
+    return {
+        id: r.id,
+        mailboxId: r.mailbox_id,
+        subject: r.subject,
+        status: r.status,
+        messageCount: r.message_count,
+        lastMessageAt: new Date(r.last_message_at),
+        createdAt: new Date(r.created_at),
+    };
+}
+export function parseThreadDetail(r) {
+    return {
+        ...parseThread(r),
+        messages: (r.messages ?? []).map(parseMessage),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/mail/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mail/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsHH,oBAAoB;AAEpB,MAAM,UAAU,YAAY,CAAC,CAAa;IACxC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,WAAW,EAAE,CAAC,CAAC,YAAY;QAC3B,UAAU,EAAE,CAAC,CAAC,WAAW;QACzB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;QACjC,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAa;IACxC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,QAAQ,EAAE,CAAC,CAAC,SAAS;QACrB,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,WAAW,EAAE,CAAC,CAAC,YAAY;QAC3B,WAAW,EAAE,CAAC,CAAC,YAAY;QAC3B,WAAW,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI;QACnC,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,SAAS,EAAE,CAAC,CAAC,SAAmC;QAChD,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,MAAM,EAAE,CAAC,CAAC,OAAO;QACjB,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,cAAc,EAAE,CAAC,CAAC,eAAe;QACjC,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAa;IAC9C,OAAO;QACL,GAAG,YAAY,CAAC,CAAC,CAAC;QAClB,QAAQ,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;QAC7B,QAAQ,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;QAC7B,YAAY,EAAE,CAAC,CAAC,aAAa,IAAI,IAAI;QACrC,SAAS,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;QAChC,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;QAChC,kBAAkB,EAAE,CAAC,CAAC,mBAAmB,IAAI,IAAI;QACjD,YAAY,EAAE,CAAC,CAAC,cAAc,IAAI,IAAI;QACtC,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAW,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAY;IACtC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,SAAS,EAAE,CAAC,CAAC,UAAU;QACvB,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,aAAa,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC;QAC1C,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAY;IAC5C,OAAO;QACL,GAAG,WAAW,CAAC,CAAC,CAAC;QACjB,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/phone/resources/calls.d.ts

@@ -0,0 +1,45 @@
+/**
+ * inkbox-phone/resources/calls.ts
+ *
+ * Call operations: list, get, place.
+ */
+import { HttpTransport } from "../../_http.js";
+import { PhoneCall, PhoneCallWithRateLimit } from "../types.js";
+export declare class CallsResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * List calls for a phone number, newest first.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param options.limit - Max results (1–200). Defaults to 50.
+     * @param options.offset - Pagination offset. Defaults to 0.
+     */
+    list(phoneNumberId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<PhoneCall[]>;
+    /**
+     * Get a single call by ID.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param callId - UUID of the call.
+     */
+    get(phoneNumberId: string, callId: string): Promise<PhoneCall>;
+    /**
+     * Place an outbound call.
+     *
+     * @param options.fromNumber - E.164 number to call from. Must belong to your org and be active.
+     * @param options.toNumber - E.164 number to call.
+     * @param options.clientWebsocketUrl - WebSocket URL (wss://) for audio bridging.
+     * @param options.webhookUrl - Custom webhook URL for call lifecycle events.
+     * @returns The created call record with current rate limit info.
+     */
+    place(options: {
+        fromNumber: string;
+        toNumber: string;
+        clientWebsocketUrl?: string;
+        webhookUrl?: string;
+    }): Promise<PhoneCallWithRateLimit>;
+}
+//# sourceMappingURL=calls.d.ts.map

package/dist/phone/resources/calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../../src/phone/resources/calls.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,SAAS,EACT,sBAAsB,EAKvB,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;OAMG;IACG,IAAI,CACR,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,SAAS,EAAE,CAAC;IAQvB;;;;;OAKG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAOpE;;;;;;;;OAQG;IACG,KAAK,CAAC,OAAO,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAcpC"}

package/dist/phone/resources/calls.js

@@ -0,0 +1,57 @@
+/**
+ * inkbox-phone/resources/calls.ts
+ *
+ * Call operations: list, get, place.
+ */
+import { parsePhoneCall, parsePhoneCallWithRateLimit, } from "../types.js";
+export class CallsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List calls for a phone number, newest first.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param options.limit - Max results (1–200). Defaults to 50.
+     * @param options.offset - Pagination offset. Defaults to 0.
+     */
+    async list(phoneNumberId, options) {
+        const data = await this.http.get(`/numbers/${phoneNumberId}/calls`, { limit: options?.limit ?? 50, offset: options?.offset ?? 0 });
+        return data.map(parsePhoneCall);
+    }
+    /**
+     * Get a single call by ID.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param callId - UUID of the call.
+     */
+    async get(phoneNumberId, callId) {
+        const data = await this.http.get(`/numbers/${phoneNumberId}/calls/${callId}`);
+        return parsePhoneCall(data);
+    }
+    /**
+     * Place an outbound call.
+     *
+     * @param options.fromNumber - E.164 number to call from. Must belong to your org and be active.
+     * @param options.toNumber - E.164 number to call.
+     * @param options.clientWebsocketUrl - WebSocket URL (wss://) for audio bridging.
+     * @param options.webhookUrl - Custom webhook URL for call lifecycle events.
+     * @returns The created call record with current rate limit info.
+     */
+    async place(options) {
+        const body = {
+            from_number: options.fromNumber,
+            to_number: options.toNumber,
+        };
+        if (options.clientWebsocketUrl !== undefined) {
+            body["client_websocket_url"] = options.clientWebsocketUrl;
+        }
+        if (options.webhookUrl !== undefined) {
+            body["webhook_url"] = options.webhookUrl;
+        }
+        const data = await this.http.post("/place-call", body);
+        return parsePhoneCallWithRateLimit(data);
+    }
+}
+//# sourceMappingURL=calls.js.map

package/dist/phone/resources/calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calls.js","sourceRoot":"","sources":["../../../src/phone/resources/calls.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAKL,cAAc,EACd,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,aAAqB,EACrB,OAA6C;QAE7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,YAAY,aAAa,QAAQ,EACjC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,CAC9D,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,aAAqB,EAAE,MAAc;QAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,YAAY,aAAa,UAAU,MAAM,EAAE,CAC5C,CAAC;QACF,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,CAAC,OAKX;QACC,MAAM,IAAI,GAA4B;YACpC,WAAW,EAAE,OAAO,CAAC,UAAU;YAC/B,SAAS,EAAE,OAAO,CAAC,QAAQ;SAC5B,CAAC;QACF,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;QAC5D,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QAC3C,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAA4B,aAAa,EAAE,IAAI,CAAC,CAAC;QAClF,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/phone/resources/numbers.d.ts

@@ -0,0 +1,61 @@
+/**
+ * inkbox-phone/resources/numbers.ts
+ *
+ * Phone number CRUD, provisioning, release, and transcript search.
+ */
+import { HttpTransport } from "../../_http.js";
+import { PhoneNumber, PhoneTranscript } from "../types.js";
+export declare class PhoneNumbersResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /** List all phone numbers for your organisation. */
+    list(): Promise<PhoneNumber[]>;
+    /** Get a phone number by ID. */
+    get(phoneNumberId: string): Promise<PhoneNumber>;
+    /**
+     * Update phone number settings. Only provided fields are updated.
+     * Pass a field as `null` to clear it.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param options.incomingCallAction - `"auto_accept"`, `"auto_reject"`, or `"webhook"`.
+     * @param options.clientWebsocketUrl - WebSocket URL (wss://) for audio bridging.
+     * @param options.incomingCallWebhookUrl - Webhook URL called for incoming calls when action is `"webhook"`.
+     */
+    update(phoneNumberId: string, options: {
+        incomingCallAction?: string;
+        clientWebsocketUrl?: string | null;
+        incomingCallWebhookUrl?: string | null;
+    }): Promise<PhoneNumber>;
+    /**
+     * Provision a new phone number and link it to an agent identity.
+     *
+     * @param options.agentHandle - Handle of the agent identity to assign this number to.
+     * @param options.type - `"toll_free"` or `"local"`. Defaults to `"toll_free"`.
+     * @param options.state - US state abbreviation (e.g. `"NY"`). Only valid for `local` numbers.
+     */
+    provision(options: {
+        agentHandle: string;
+        type?: string;
+        state?: string;
+    }): Promise<PhoneNumber>;
+    /**
+     * Release a phone number.
+     *
+     * @param phoneNumberId - UUID of the phone number to release.
+     */
+    release(phoneNumberId: string): Promise<void>;
+    /**
+     * Full-text search across transcripts for a phone number.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param options.q - Search query string.
+     * @param options.party - Filter by speaker: `"local"` or `"remote"`.
+     * @param options.limit - Maximum number of results (1–200). Defaults to 50.
+     */
+    searchTranscripts(phoneNumberId: string, options: {
+        q: string;
+        party?: string;
+        limit?: number;
+    }): Promise<PhoneTranscript[]>;
+}
+//# sourceMappingURL=numbers.d.ts.map

package/dist/phone/resources/numbers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.d.ts","sourceRoot":"","sources":["../../../src/phone/resources/numbers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,WAAW,EACX,eAAe,EAKhB,MAAM,aAAa,CAAC;AAIrB,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD,oDAAoD;IAC9C,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKpC,gCAAgC;IAC1B,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOtD;;;;;;;;OAQG;IACG,MAAM,CACV,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE;QACP,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACxC,GACA,OAAO,CAAC,WAAW,CAAC;IAkBvB;;;;;;OAMG;IACG,SAAS,CAAC,OAAO,EAAE;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,WAAW,CAAC;IAYxB;;;;OAIG;IACG,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;;;;;;OAOG;IACG,iBAAiB,CACrB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,eAAe,EAAE,CAAC;CAO9B"}

package/dist/phone/resources/numbers.js

@@ -0,0 +1,85 @@
+/**
+ * inkbox-phone/resources/numbers.ts
+ *
+ * Phone number CRUD, provisioning, release, and transcript search.
+ */
+import { parsePhoneNumber, parsePhoneTranscript, } from "../types.js";
+const BASE = "/numbers";
+export class PhoneNumbersResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List all phone numbers for your organisation. */
+    async list() {
+        const data = await this.http.get(BASE);
+        return data.map(parsePhoneNumber);
+    }
+    /** Get a phone number by ID. */
+    async get(phoneNumberId) {
+        const data = await this.http.get(`${BASE}/${phoneNumberId}`);
+        return parsePhoneNumber(data);
+    }
+    /**
+     * Update phone number settings. Only provided fields are updated.
+     * Pass a field as `null` to clear it.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param options.incomingCallAction - `"auto_accept"`, `"auto_reject"`, or `"webhook"`.
+     * @param options.clientWebsocketUrl - WebSocket URL (wss://) for audio bridging.
+     * @param options.incomingCallWebhookUrl - Webhook URL called for incoming calls when action is `"webhook"`.
+     */
+    async update(phoneNumberId, options) {
+        const body = {};
+        if (options.incomingCallAction !== undefined) {
+            body["incoming_call_action"] = options.incomingCallAction;
+        }
+        if ("clientWebsocketUrl" in options) {
+            body["client_websocket_url"] = options.clientWebsocketUrl;
+        }
+        if ("incomingCallWebhookUrl" in options) {
+            body["incoming_call_webhook_url"] = options.incomingCallWebhookUrl;
+        }
+        const data = await this.http.patch(`${BASE}/${phoneNumberId}`, body);
+        return parsePhoneNumber(data);
+    }
+    /**
+     * Provision a new phone number and link it to an agent identity.
+     *
+     * @param options.agentHandle - Handle of the agent identity to assign this number to.
+     * @param options.type - `"toll_free"` or `"local"`. Defaults to `"toll_free"`.
+     * @param options.state - US state abbreviation (e.g. `"NY"`). Only valid for `local` numbers.
+     */
+    async provision(options) {
+        const body = {
+            agent_handle: options.agentHandle,
+            type: options.type ?? "toll_free",
+        };
+        if (options.state !== undefined) {
+            body["state"] = options.state;
+        }
+        const data = await this.http.post(BASE, body);
+        return parsePhoneNumber(data);
+    }
+    /**
+     * Release a phone number.
+     *
+     * @param phoneNumberId - UUID of the phone number to release.
+     */
+    async release(phoneNumberId) {
+        await this.http.delete(`${BASE}/${phoneNumberId}`);
+    }
+    /**
+     * Full-text search across transcripts for a phone number.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param options.q - Search query string.
+     * @param options.party - Filter by speaker: `"local"` or `"remote"`.
+     * @param options.limit - Maximum number of results (1–200). Defaults to 50.
+     */
+    async searchTranscripts(phoneNumberId, options) {
+        const data = await this.http.get(`${BASE}/${phoneNumberId}/search`, { q: options.q, party: options.party, limit: options.limit ?? 50 });
+        return data.map(parsePhoneTranscript);
+    }
+}
+//# sourceMappingURL=numbers.js.map

package/dist/phone/resources/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../../src/phone/resources/numbers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAKL,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,MAAM,IAAI,GAAG,UAAU,CAAC;AAExB,MAAM,OAAO,oBAAoB;IACF;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD,oDAAoD;IACpD,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAmB,IAAI,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,GAAG,CAAC,aAAqB;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,GAAG,IAAI,IAAI,aAAa,EAAE,CAC3B,CAAC;QACF,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CACV,aAAqB,EACrB,OAIC;QAED,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;QAC5D,CAAC;QACD,IAAI,oBAAoB,IAAI,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;QAC5D,CAAC;QACD,IAAI,wBAAwB,IAAI,OAAO,EAAE,CAAC;YACxC,IAAI,CAAC,2BAA2B,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAChC,GAAG,IAAI,IAAI,aAAa,EAAE,EAC1B,IAAI,CACL,CAAC;QACF,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CAAC,OAIf;QACC,MAAM,IAAI,GAA4B;YACpC,YAAY,EAAE,OAAO,CAAC,WAAW;YACjC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,WAAW;SAClC,CAAC;QACF,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAiB,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9D,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,aAAqB;QACjC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,aAAa,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,iBAAiB,CACrB,aAAqB,EACrB,OAAsD;QAEtD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,GAAG,IAAI,IAAI,aAAa,SAAS,EACjC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,CACnE,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/phone/resources/transcripts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * inkbox-phone/resources/transcripts.ts
+ *
+ * Transcript retrieval.
+ */
+import { HttpTransport } from "../../_http.js";
+import { PhoneTranscript } from "../types.js";
+export declare class TranscriptsResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * List all transcript segments for a call, ordered by sequence number.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param callId - UUID of the call.
+     */
+    list(phoneNumberId: string, callId: string): Promise<PhoneTranscript[]>;
+}
+//# sourceMappingURL=transcripts.d.ts.map

package/dist/phone/resources/transcripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcripts.d.ts","sourceRoot":"","sources":["../../../src/phone/resources/transcripts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,eAAe,EAGhB,MAAM,aAAa,CAAC;AAErB,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;OAKG;IACG,IAAI,CACR,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,EAAE,CAAC;CAM9B"}

package/dist/phone/resources/transcripts.js

@@ -0,0 +1,23 @@
+/**
+ * inkbox-phone/resources/transcripts.ts
+ *
+ * Transcript retrieval.
+ */
+import { parsePhoneTranscript, } from "../types.js";
+export class TranscriptsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List all transcript segments for a call, ordered by sequence number.
+     *
+     * @param phoneNumberId - UUID of the phone number.
+     * @param callId - UUID of the call.
+     */
+    async list(phoneNumberId, callId) {
+        const data = await this.http.get(`/numbers/${phoneNumberId}/calls/${callId}/transcripts`);
+        return data.map(parsePhoneTranscript);
+    }
+}
+//# sourceMappingURL=transcripts.js.map

package/dist/phone/resources/transcripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcripts.js","sourceRoot":"","sources":["../../../src/phone/resources/transcripts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAGL,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAErB,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CACR,aAAqB,EACrB,MAAc;QAEd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,YAAY,aAAa,UAAU,MAAM,cAAc,CACxD,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;CACF"}