@inkbox/sdk 0.1.0

package/dist/inkbox.d.ts

@@ -0,0 +1,92 @@
+/**
+ * inkbox/src/inkbox.ts
+ *
+ * Inkbox — org-level entry point for all Inkbox APIs.
+ */
+import { MailboxesResource } from "./mail/resources/mailboxes.js";
+import { MessagesResource } from "./mail/resources/messages.js";
+import { ThreadsResource } from "./mail/resources/threads.js";
+import { SigningKeysResource } from "./signing_keys.js";
+import type { SigningKey } from "./signing_keys.js";
+import { PhoneNumbersResource } from "./phone/resources/numbers.js";
+import { CallsResource } from "./phone/resources/calls.js";
+import { TranscriptsResource } from "./phone/resources/transcripts.js";
+import { IdentitiesResource } from "./identities/resources/identities.js";
+import { AgentIdentity } from "./agent_identity.js";
+import type { AgentIdentitySummary } from "./identities/types.js";
+export interface InkboxOptions {
+    /** Your Inkbox API key (sent as `X-Service-Token`). */
+    apiKey: string;
+    /** Override the API base URL (useful for self-hosting or testing). */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Defaults to 30 000. */
+    timeoutMs?: number;
+}
+/**
+ * Org-level entry point for all Inkbox APIs.
+ *
+ * @example
+ * ```ts
+ * import { Inkbox } from "@inkbox/sdk";
+ *
+ * const inkbox = new Inkbox({ apiKey: process.env.INKBOX_API_KEY! });
+ *
+ * // Create an agent identity
+ * const identity = await inkbox.createIdentity("support-bot");
+ *
+ * // Create and link new channels
+ * const mailbox = await identity.createMailbox({ displayName: "Support Bot" });
+ * const phone   = await identity.provisionPhoneNumber({ type: "toll_free" });
+ *
+ * // Send email directly from the identity
+ * await identity.sendEmail({
+ *   to: ["customer@example.com"],
+ *   subject: "Your order has shipped",
+ *   bodyText: "Tracking number: 1Z999AA10123456784",
+ * });
+ * ```
+ */
+export declare class Inkbox {
+    readonly _mailboxes: MailboxesResource;
+    readonly _messages: MessagesResource;
+    readonly _threads: ThreadsResource;
+    readonly _signingKeys: SigningKeysResource;
+    readonly _numbers: PhoneNumbersResource;
+    readonly _calls: CallsResource;
+    readonly _transcripts: TranscriptsResource;
+    readonly _idsResource: IdentitiesResource;
+    constructor(options: InkboxOptions);
+    /** Org-level mailbox operations (list, get, create, update, delete). */
+    get mailboxes(): MailboxesResource;
+    /** Org-level phone number operations (list, get, provision, release). */
+    get phoneNumbers(): PhoneNumbersResource;
+    /**
+     * Create a new agent identity.
+     *
+     * @param agentHandle - Unique handle for this identity (e.g. `"sales-bot"`).
+     * @returns The created {@link AgentIdentity}.
+     */
+    createIdentity(agentHandle: string): Promise<AgentIdentity>;
+    /**
+     * Get an existing agent identity by handle.
+     *
+     * @param agentHandle - Handle of the identity to fetch.
+     * @returns The {@link AgentIdentity}.
+     */
+    getIdentity(agentHandle: string): Promise<AgentIdentity>;
+    /**
+     * List all agent identities for your organisation.
+     *
+     * @returns Array of {@link AgentIdentitySummary}.
+     */
+    listIdentities(): Promise<AgentIdentitySummary[]>;
+    /**
+     * Create or rotate the org-level webhook signing key.
+     *
+     * The plaintext key is returned once — save it immediately.
+     *
+     * @returns The new {@link SigningKey}.
+     */
+    createSigningKey(): Promise<SigningKey>;
+}
+//# sourceMappingURL=inkbox.d.ts.map

package/dist/inkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inkbox.d.ts","sourceRoot":"","sources":["../src/inkbox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;gBAE9B,OAAO,EAAE,aAAa;IAyBlC,wEAAwE;IACxE,IAAI,SAAS,IAAI,iBAAiB,CAA4B;IAE9D,yEAAyE;IACzE,IAAI,YAAY,IAAI,oBAAoB,CAA0B;IAMlE;;;;;OAKG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQjE;;;;;OAKG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI9D;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAIvD;;;;;;OAMG;IACG,gBAAgB,IAAI,OAAO,CAAC,UAAU,CAAC;CAG9C"}

package/dist/inkbox.js

@@ -0,0 +1,117 @@
+/**
+ * inkbox/src/inkbox.ts
+ *
+ * Inkbox — org-level entry point for all Inkbox APIs.
+ */
+import { HttpTransport } from "./_http.js";
+import { MailboxesResource } from "./mail/resources/mailboxes.js";
+import { MessagesResource } from "./mail/resources/messages.js";
+import { ThreadsResource } from "./mail/resources/threads.js";
+import { SigningKeysResource } from "./signing_keys.js";
+import { PhoneNumbersResource } from "./phone/resources/numbers.js";
+import { CallsResource } from "./phone/resources/calls.js";
+import { TranscriptsResource } from "./phone/resources/transcripts.js";
+import { IdentitiesResource } from "./identities/resources/identities.js";
+import { AgentIdentity } from "./agent_identity.js";
+const DEFAULT_BASE_URL = "https://api.inkbox.ai";
+/**
+ * Org-level entry point for all Inkbox APIs.
+ *
+ * @example
+ * ```ts
+ * import { Inkbox } from "@inkbox/sdk";
+ *
+ * const inkbox = new Inkbox({ apiKey: process.env.INKBOX_API_KEY! });
+ *
+ * // Create an agent identity
+ * const identity = await inkbox.createIdentity("support-bot");
+ *
+ * // Create and link new channels
+ * const mailbox = await identity.createMailbox({ displayName: "Support Bot" });
+ * const phone   = await identity.provisionPhoneNumber({ type: "toll_free" });
+ *
+ * // Send email directly from the identity
+ * await identity.sendEmail({
+ *   to: ["customer@example.com"],
+ *   subject: "Your order has shipped",
+ *   bodyText: "Tracking number: 1Z999AA10123456784",
+ * });
+ * ```
+ */
+export class Inkbox {
+    _mailboxes;
+    _messages;
+    _threads;
+    _signingKeys;
+    _numbers;
+    _calls;
+    _transcripts;
+    _idsResource;
+    constructor(options) {
+        const apiRoot = `${(options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "")}/api/v1`;
+        const ms = options.timeoutMs ?? 30_000;
+        const mailHttp = new HttpTransport(options.apiKey, `${apiRoot}/mail`, ms);
+        const phoneHttp = new HttpTransport(options.apiKey, `${apiRoot}/phone`, ms);
+        const idsHttp = new HttpTransport(options.apiKey, `${apiRoot}/identities`, ms);
+        const apiHttp = new HttpTransport(options.apiKey, apiRoot, ms);
+        this._mailboxes = new MailboxesResource(mailHttp);
+        this._messages = new MessagesResource(mailHttp);
+        this._threads = new ThreadsResource(mailHttp);
+        this._signingKeys = new SigningKeysResource(apiHttp);
+        this._numbers = new PhoneNumbersResource(phoneHttp);
+        this._calls = new CallsResource(phoneHttp);
+        this._transcripts = new TranscriptsResource(phoneHttp);
+        this._idsResource = new IdentitiesResource(idsHttp);
+    }
+    // ------------------------------------------------------------------
+    // Public resource accessors
+    // ------------------------------------------------------------------
+    /** Org-level mailbox operations (list, get, create, update, delete). */
+    get mailboxes() { return this._mailboxes; }
+    /** Org-level phone number operations (list, get, provision, release). */
+    get phoneNumbers() { return this._numbers; }
+    // ------------------------------------------------------------------
+    // Org-level operations
+    // ------------------------------------------------------------------
+    /**
+     * Create a new agent identity.
+     *
+     * @param agentHandle - Unique handle for this identity (e.g. `"sales-bot"`).
+     * @returns The created {@link AgentIdentity}.
+     */
+    async createIdentity(agentHandle) {
+        await this._idsResource.create({ agentHandle });
+        // POST /identities returns summary (no channel fields); fetch detail so
+        // AgentIdentity has a fully-populated _AgentIdentityData.
+        const data = await this._idsResource.get(agentHandle);
+        return new AgentIdentity(data, this);
+    }
+    /**
+     * Get an existing agent identity by handle.
+     *
+     * @param agentHandle - Handle of the identity to fetch.
+     * @returns The {@link AgentIdentity}.
+     */
+    async getIdentity(agentHandle) {
+        return new AgentIdentity(await this._idsResource.get(agentHandle), this);
+    }
+    /**
+     * List all agent identities for your organisation.
+     *
+     * @returns Array of {@link AgentIdentitySummary}.
+     */
+    async listIdentities() {
+        return this._idsResource.list();
+    }
+    /**
+     * Create or rotate the org-level webhook signing key.
+     *
+     * The plaintext key is returned once — save it immediately.
+     *
+     * @returns The new {@link SigningKey}.
+     */
+    async createSigningKey() {
+        return this._signingKeys.createOrRotate();
+    }
+}
+//# sourceMappingURL=inkbox.js.map

package/dist/inkbox.js.map

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

package/dist/mail/resources/mailboxes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * inkbox-mail/resources/mailboxes.ts
+ *
+ * Mailbox CRUD and full-text search.
+ */
+import { HttpTransport } from "../../_http.js";
+import { Mailbox, Message } from "../types.js";
+export declare class MailboxesResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * Create a new mailbox.
+     *
+     * The email address is automatically generated by the server.
+     *
+     * @param options.displayName - Optional human-readable name shown as the sender.
+     */
+    create(options?: {
+        displayName?: string;
+    }): Promise<Mailbox>;
+    /** List all mailboxes for your organisation. */
+    list(): Promise<Mailbox[]>;
+    /**
+     * Get a mailbox by its email address.
+     *
+     * @param emailAddress - Full email address of the mailbox (e.g. `"abc-xyz@inkboxmail.com"`).
+     */
+    get(emailAddress: string): Promise<Mailbox>;
+    /**
+     * Update mutable mailbox fields.
+     *
+     * Only provided fields are applied; omitted fields are left unchanged.
+     * Pass `webhookUrl: null` to unsubscribe from webhooks.
+     *
+     * @param emailAddress - Full email address of the mailbox to update.
+     * @param options.displayName - New human-readable sender name.
+     * @param options.webhookUrl - HTTPS URL to receive webhook events, or `null` to unsubscribe.
+     */
+    update(emailAddress: string, options: {
+        displayName?: string;
+        webhookUrl?: string | null;
+    }): Promise<Mailbox>;
+    /**
+     * Delete a mailbox.
+     *
+     * @param emailAddress - Full email address of the mailbox to delete.
+     */
+    delete(emailAddress: string): Promise<void>;
+    /**
+     * Full-text search across messages in a mailbox.
+     *
+     * @param emailAddress - Full email address of the mailbox to search.
+     * @param options.q - Search query string.
+     * @param options.limit - Maximum number of results (1–100). Defaults to 50.
+     */
+    search(emailAddress: string, options: {
+        q: string;
+        limit?: number;
+    }): Promise<Message[]>;
+}
+//# sourceMappingURL=mailboxes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mailboxes.d.ts","sourceRoot":"","sources":["../../../src/mail/resources/mailboxes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,OAAO,EACP,OAAO,EAMR,MAAM,aAAa,CAAC;AAIrB,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,aAAa;IAEhD;;;;;;OAMG;IACG,MAAM,CAAC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAStE,gDAAgD;IAC1C,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKhC;;;;OAIG;IACG,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjD;;;;;;;;;OASG;IACG,MAAM,CACV,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC5D,OAAO,CAAC,OAAO,CAAC;IAYnB;;;;OAIG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;;;OAMG;IACG,MAAM,CACV,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACrC,OAAO,CAAC,OAAO,EAAE,CAAC;CAOtB"}

package/dist/mail/resources/mailboxes.js

@@ -0,0 +1,83 @@
+/**
+ * inkbox-mail/resources/mailboxes.ts
+ *
+ * Mailbox CRUD and full-text search.
+ */
+import { parseMailbox, parseMessage, } from "../types.js";
+const BASE = "/mailboxes";
+export class MailboxesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create a new mailbox.
+     *
+     * The email address is automatically generated by the server.
+     *
+     * @param options.displayName - Optional human-readable name shown as the sender.
+     */
+    async create(options = {}) {
+        const body = {};
+        if (options.displayName !== undefined) {
+            body["display_name"] = options.displayName;
+        }
+        const data = await this.http.post(BASE, body);
+        return parseMailbox(data);
+    }
+    /** List all mailboxes for your organisation. */
+    async list() {
+        const data = await this.http.get(BASE);
+        return data.map(parseMailbox);
+    }
+    /**
+     * Get a mailbox by its email address.
+     *
+     * @param emailAddress - Full email address of the mailbox (e.g. `"abc-xyz@inkboxmail.com"`).
+     */
+    async get(emailAddress) {
+        const data = await this.http.get(`${BASE}/${emailAddress}`);
+        return parseMailbox(data);
+    }
+    /**
+     * Update mutable mailbox fields.
+     *
+     * Only provided fields are applied; omitted fields are left unchanged.
+     * Pass `webhookUrl: null` to unsubscribe from webhooks.
+     *
+     * @param emailAddress - Full email address of the mailbox to update.
+     * @param options.displayName - New human-readable sender name.
+     * @param options.webhookUrl - HTTPS URL to receive webhook events, or `null` to unsubscribe.
+     */
+    async update(emailAddress, options) {
+        const body = {};
+        if (options.displayName !== undefined) {
+            body["display_name"] = options.displayName;
+        }
+        if ("webhookUrl" in options) {
+            body["webhook_url"] = options.webhookUrl;
+        }
+        const data = await this.http.patch(`${BASE}/${emailAddress}`, body);
+        return parseMailbox(data);
+    }
+    /**
+     * Delete a mailbox.
+     *
+     * @param emailAddress - Full email address of the mailbox to delete.
+     */
+    async delete(emailAddress) {
+        await this.http.delete(`${BASE}/${emailAddress}`);
+    }
+    /**
+     * Full-text search across messages in a mailbox.
+     *
+     * @param emailAddress - Full email address of the mailbox to search.
+     * @param options.q - Search query string.
+     * @param options.limit - Maximum number of results (1–100). Defaults to 50.
+     */
+    async search(emailAddress, options) {
+        const data = await this.http.get(`${BASE}/${emailAddress}/search`, { q: options.q, limit: options.limit ?? 50 });
+        return data.items.map(parseMessage);
+    }
+}
+//# sourceMappingURL=mailboxes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mailboxes.js","sourceRoot":"","sources":["../../../src/mail/resources/mailboxes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAML,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,MAAM,IAAI,GAAG,YAAY,CAAC;AAE1B,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,IAAmB;QAAnB,SAAI,GAAJ,IAAI,CAAe;IAAG,CAAC;IAEpD;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,UAAoC,EAAE;QACjD,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;QAC7C,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAa,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1D,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAe,IAAI,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,YAAoB;QAC5B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAa,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC,CAAC;QACxE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,OAA6D;QAE7D,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;QAC7C,CAAC;QACD,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;QAC3C,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAa,GAAG,IAAI,IAAI,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC;QAChF,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,YAAoB;QAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,OAAsC;QAEtC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9B,GAAG,IAAI,IAAI,YAAY,SAAS,EAChC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,CAC7C,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;CACF"}

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

@@ -0,0 +1,100 @@
+/**
+ * inkbox-mail/resources/messages.ts
+ *
+ * Message operations: list (auto-paginated), get, send, flag updates, delete.
+ */
+import { HttpTransport } from "../../_http.js";
+import { Message, MessageDetail } from "../types.js";
+export declare class MessagesResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * Async iterator over all messages in a mailbox, newest first.
+     *
+     * Pagination is handled automatically — just iterate.
+     *
+     * @example
+     * ```ts
+     * for await (const msg of client.messages.list(emailAddress)) {
+     *   console.log(msg.subject, msg.fromAddress);
+     * }
+     * ```
+     */
+    list(emailAddress: string, options?: {
+        pageSize?: number;
+        direction?: "inbound" | "outbound";
+    }): AsyncGenerator<Message>;
+    /**
+     * Get a message with full body content.
+     *
+     * @param emailAddress - Full email address of the owning mailbox.
+     * @param messageId - UUID of the message.
+     */
+    get(emailAddress: string, messageId: string): Promise<MessageDetail>;
+    /**
+     * Send an email from a mailbox.
+     *
+     * @param emailAddress - Full email address of the sending mailbox.
+     * @param options.to - Primary recipient addresses (at least one required).
+     * @param options.subject - Email subject line.
+     * @param options.bodyText - Plain-text body.
+     * @param options.bodyHtml - HTML body.
+     * @param options.cc - Carbon-copy recipients.
+     * @param options.bcc - Blind carbon-copy recipients.
+     * @param options.inReplyToMessageId - RFC 5322 Message-ID of the message being
+     *   replied to. Threads the reply automatically.
+     * @param options.attachments - Optional file attachments. Each entry must have
+     *   `filename`, `contentType` (MIME type), and `contentBase64` (base64-encoded
+     *   file content). Max total size: 25 MB. Blocked: `.exe`, `.bat`, `.scr`.
+     */
+    send(emailAddress: string, options: {
+        to: string[];
+        subject: string;
+        bodyText?: string;
+        bodyHtml?: string;
+        cc?: string[];
+        bcc?: string[];
+        inReplyToMessageId?: string;
+        attachments?: Array<{
+            filename: string;
+            contentType: string;
+            contentBase64: string;
+        }>;
+    }): Promise<Message>;
+    /**
+     * Update read/starred flags on a message.
+     *
+     * Pass only the flags you want to change; omitted flags are left as-is.
+     */
+    updateFlags(emailAddress: string, messageId: string, flags: {
+        isRead?: boolean;
+        isStarred?: boolean;
+    }): Promise<Message>;
+    /** Mark a message as read. */
+    markRead(emailAddress: string, messageId: string): Promise<Message>;
+    /** Mark a message as unread. */
+    markUnread(emailAddress: string, messageId: string): Promise<Message>;
+    /** Star a message. */
+    star(emailAddress: string, messageId: string): Promise<Message>;
+    /** Unstar a message. */
+    unstar(emailAddress: string, messageId: string): Promise<Message>;
+    /** Delete a message. */
+    delete(emailAddress: string, messageId: string): Promise<void>;
+    /**
+     * Get a presigned URL for a message attachment.
+     *
+     * @param emailAddress - Full email address of the owning mailbox.
+     * @param messageId - UUID of the message.
+     * @param filename - Attachment filename.
+     * @param options.redirect - If `true`, follows the redirect. If `false` (default),
+     *   returns `{ url, filename, expiresIn }`.
+     */
+    getAttachment(emailAddress: string, messageId: string, filename: string, options?: {
+        redirect?: boolean;
+    }): Promise<{
+        url: string;
+        filename: string;
+        expiresIn: number;
+    }>;
+}
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/mail/resources/messages.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,OAAO,EACP,aAAa,EAKd,MAAM,aAAa,CAAC;AAIrB,qBAAa,gBAAgB;IACf,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,CAAC;QAAC,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;KAAE,GAClE,cAAc,CAAC,OAAO,CAAC;IAmB1B;;;;;OAKG;IACG,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAO1E;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CACR,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,WAAW,CAAC,EAAE,KAAK,CAAC;YAClB,QAAQ,EAAE,MAAM,CAAC;YACjB,WAAW,EAAE,MAAM,CAAC;YACpB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC,CAAC;KACJ,GACA,OAAO,CAAC,OAAO,CAAC;IA6BnB;;;;OAIG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/C,OAAO,CAAC,OAAO,CAAC;IAYnB,8BAA8B;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE,gCAAgC;IAC1B,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3E,sBAAsB;IAChB,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE,wBAAwB;IAClB,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE,wBAAwB;IAClB,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE;;;;;;;;OAQG;IACG,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/B,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAMjE"}

package/dist/mail/resources/messages.js

@@ -0,0 +1,141 @@
+/**
+ * inkbox-mail/resources/messages.ts
+ *
+ * Message operations: list (auto-paginated), get, send, flag updates, delete.
+ */
+import { parseMessage, parseMessageDetail, } from "../types.js";
+const DEFAULT_PAGE_SIZE = 50;
+export class MessagesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Async iterator over all messages in a mailbox, newest first.
+     *
+     * Pagination is handled automatically — just iterate.
+     *
+     * @example
+     * ```ts
+     * for await (const msg of client.messages.list(emailAddress)) {
+     *   console.log(msg.subject, msg.fromAddress);
+     * }
+     * ```
+     */
+    async *list(emailAddress, options) {
+        const limit = options?.pageSize ?? DEFAULT_PAGE_SIZE;
+        let cursor;
+        while (true) {
+            const params = { limit, cursor };
+            if (options?.direction !== undefined)
+                params["direction"] = options.direction;
+            const page = await this.http.get(`/mailboxes/${emailAddress}/messages`, params);
+            for (const item of page.items) {
+                yield parseMessage(item);
+            }
+            if (!page.has_more)
+                break;
+            cursor = page.next_cursor ?? undefined;
+        }
+    }
+    /**
+     * Get a message with full body content.
+     *
+     * @param emailAddress - Full email address of the owning mailbox.
+     * @param messageId - UUID of the message.
+     */
+    async get(emailAddress, messageId) {
+        const data = await this.http.get(`/mailboxes/${emailAddress}/messages/${messageId}`);
+        return parseMessageDetail(data);
+    }
+    /**
+     * Send an email from a mailbox.
+     *
+     * @param emailAddress - Full email address of the sending mailbox.
+     * @param options.to - Primary recipient addresses (at least one required).
+     * @param options.subject - Email subject line.
+     * @param options.bodyText - Plain-text body.
+     * @param options.bodyHtml - HTML body.
+     * @param options.cc - Carbon-copy recipients.
+     * @param options.bcc - Blind carbon-copy recipients.
+     * @param options.inReplyToMessageId - RFC 5322 Message-ID of the message being
+     *   replied to. Threads the reply automatically.
+     * @param options.attachments - Optional file attachments. Each entry must have
+     *   `filename`, `contentType` (MIME type), and `contentBase64` (base64-encoded
+     *   file content). Max total size: 25 MB. Blocked: `.exe`, `.bat`, `.scr`.
+     */
+    async send(emailAddress, options) {
+        const recipients = { to: options.to };
+        if (options.cc)
+            recipients["cc"] = options.cc;
+        if (options.bcc)
+            recipients["bcc"] = options.bcc;
+        const body = {
+            recipients,
+            subject: options.subject,
+        };
+        if (options.bodyText !== undefined)
+            body["body_text"] = options.bodyText;
+        if (options.bodyHtml !== undefined)
+            body["body_html"] = options.bodyHtml;
+        if (options.inReplyToMessageId !== undefined) {
+            body["in_reply_to_message_id"] = options.inReplyToMessageId;
+        }
+        if (options.attachments !== undefined) {
+            body["attachments"] = options.attachments.map((a) => ({
+                filename: a.filename,
+                content_type: a.contentType,
+                content_base64: a.contentBase64,
+            }));
+        }
+        const data = await this.http.post(`/mailboxes/${emailAddress}/messages`, body);
+        return parseMessage(data);
+    }
+    /**
+     * Update read/starred flags on a message.
+     *
+     * Pass only the flags you want to change; omitted flags are left as-is.
+     */
+    async updateFlags(emailAddress, messageId, flags) {
+        const body = {};
+        if (flags.isRead !== undefined)
+            body["is_read"] = flags.isRead;
+        if (flags.isStarred !== undefined)
+            body["is_starred"] = flags.isStarred;
+        const data = await this.http.patch(`/mailboxes/${emailAddress}/messages/${messageId}`, body);
+        return parseMessage(data);
+    }
+    /** Mark a message as read. */
+    async markRead(emailAddress, messageId) {
+        return this.updateFlags(emailAddress, messageId, { isRead: true });
+    }
+    /** Mark a message as unread. */
+    async markUnread(emailAddress, messageId) {
+        return this.updateFlags(emailAddress, messageId, { isRead: false });
+    }
+    /** Star a message. */
+    async star(emailAddress, messageId) {
+        return this.updateFlags(emailAddress, messageId, { isStarred: true });
+    }
+    /** Unstar a message. */
+    async unstar(emailAddress, messageId) {
+        return this.updateFlags(emailAddress, messageId, { isStarred: false });
+    }
+    /** Delete a message. */
+    async delete(emailAddress, messageId) {
+        await this.http.delete(`/mailboxes/${emailAddress}/messages/${messageId}`);
+    }
+    /**
+     * Get a presigned URL for a message attachment.
+     *
+     * @param emailAddress - Full email address of the owning mailbox.
+     * @param messageId - UUID of the message.
+     * @param filename - Attachment filename.
+     * @param options.redirect - If `true`, follows the redirect. If `false` (default),
+     *   returns `{ url, filename, expiresIn }`.
+     */
+    async getAttachment(emailAddress, messageId, filename, options) {
+        return this.http.get(`/mailboxes/${emailAddress}/messages/${messageId}/attachments/${filename}`, { redirect: options?.redirect ? "true" : "false" });
+    }
+}
+//# sourceMappingURL=messages.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * inkbox-mail/resources/threads.ts
+ *
+ * Thread operations: list (auto-paginated), get with messages, delete.
+ */
+import { HttpTransport } from "../../_http.js";
+import { Thread, ThreadDetail } from "../types.js";
+export declare class ThreadsResource {
+    private readonly http;
+    constructor(http: HttpTransport);
+    /**
+     * 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);
+     * }
+     * ```
+     */
+    list(emailAddress: string, options?: {
+        pageSize?: number;
+    }): AsyncGenerator<Thread>;
+    /**
+     * Get a thread with all its messages inlined.
+     *
+     * @param emailAddress - Full email address of the owning mailbox.
+     * @param threadId - UUID of the thread.
+     */
+    get(emailAddress: string, threadId: string): Promise<ThreadDetail>;
+    /** Delete a thread. */
+    delete(emailAddress: string, threadId: string): Promise<void>;
+}
+//# sourceMappingURL=threads.d.ts.map