telnyx 7.12.0 → 7.13.0

package/resources/email-messages/email-messages.js

@@ -0,0 +1,186 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailMessages = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const RecipientsAPI = tslib_1.__importStar(require("./recipients.js"));
+const recipients_1 = require("./recipients.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+/**
+ * Send and manage email messages. Legacy `/v2/emails` routes are aliases for these endpoints.
+ */
+class EmailMessages extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.recipients = new RecipientsAPI.Recipients(this._client);
+    }
+    /**
+     * Permanently deletes every email in the authenticated account sent from or to the
+     * supplied address, including retained events whose parent message has expired.
+     * Events and durable recipients are deleted immediately with each message. The
+     * operation never searches or reports matches in another account. The legacy
+     * `/v2/emails` DELETE route is a backward-compatible alias.
+     *
+     * @example
+     * ```ts
+     * await client.emailMessages.deleteAll({
+     *   address: 'dev@stainless.com',
+     * });
+     * ```
+     */
+    deleteAll(params, options) {
+        const { address } = params;
+        return this._client.delete('/email_messages', {
+            query: { address },
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Lists messages sorted newest first by `created_at desc, id desc`. No filters
+     * other than cursor pagination are implemented. The legacy `/v2/emails` GET route
+     * is a backward-compatible alias for this operation.
+     *
+     * @example
+     * ```ts
+     * const emailMessages = await client.emailMessages.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/email_messages', { query, ...options });
+    }
+    /**
+     * Queues, schedules, or sandbox-sends an email message. The legacy `/v2/emails`
+     * POST route is a backward-compatible alias for this operation.
+     *
+     * `subject` is required unless `template_id` is supplied. When using
+     * `template_id`, do not also provide `subject`, `html_body`, or `text_body`; the
+     * template is rendered with `template_variables`.
+     *
+     * Note: template lookup failures (not found, wrong account) return 400, not 404.
+     *
+     * @example
+     * ```ts
+     * const emailMessageResponse =
+     *   await client.emailMessages.create({
+     *     from: 'sender@example.com',
+     *     to: ['recipient@example.com'],
+     *     subject: 'Hello from Telnyx',
+     *     text_body: 'This is a test email.',
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/email_messages', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Creates up to 50 email messages in a single request.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emailMessages.batch({
+     *   messages: [
+     *     {
+     *       from: 'sender@example.com',
+     *       to: ['recipient1@example.com'],
+     *       subject: 'Hello 1',
+     *       text_body: 'Message 1',
+     *     },
+     *     {
+     *       from: 'sender@example.com',
+     *       to: ['recipient2@example.com'],
+     *       subject: 'Hello 2',
+     *       text_body: 'Message 2',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    batch(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/email_messages/batch', {
+            body,
+            ...options,
+            headers: (0, headers_1.buildHeaders)([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Lists events for a single message sorted oldest first by
+     * `occurred_at asc, id asc`. The legacy `/v2/emails/{id}/events` GET route is a
+     * backward-compatible alias.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emailMessages.retrieveEvents(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    retrieveEvents(emailID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/email_messages/${emailID}/events`, { query, ...options });
+    }
+    /**
+     * Cancels a scheduled email and returns it with status `cancelled`. The legacy
+     * `/v2/emails/{id}/schedule` DELETE route is an alias.
+     *
+     * @example
+     * ```ts
+     * const emailMessageResponse =
+     *   await client.emailMessages.deleteSchedule(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    deleteSchedule(emailID, options) {
+        return this._client.delete((0, path_1.path) `/email_messages/${emailID}/schedule`, options);
+    }
+    /**
+     * Permanently deletes an account-scoped email message, its events, its durable
+     * recipients, and unshared attachment objects. Returns 404 when the message does
+     * not exist in the authenticated account. The legacy `/v2/emails/{id}` DELETE
+     * route is a backward-compatible alias.
+     *
+     * @example
+     * ```ts
+     * await client.emailMessages.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete((0, path_1.path) `/email_messages/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * The legacy `/v2/emails/{id}` GET route is a backward-compatible alias for this
+     * operation.
+     *
+     * @example
+     * ```ts
+     * const emailMessage = await client.emailMessages.retrieve(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get((0, path_1.path) `/email_messages/${id}`, options);
+    }
+}
+exports.EmailMessages = EmailMessages;
+EmailMessages.Recipients = recipients_1.Recipients;
+//# sourceMappingURL=email-messages.js.map

package/resources/email-messages/email-messages.js.map

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

package/resources/email-messages/email-messages.mjs

@@ -0,0 +1,181 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as RecipientsAPI from "./recipients.mjs";
+import { Recipients, } from "./recipients.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+/**
+ * Send and manage email messages. Legacy `/v2/emails` routes are aliases for these endpoints.
+ */
+export class EmailMessages extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.recipients = new RecipientsAPI.Recipients(this._client);
+    }
+    /**
+     * Permanently deletes every email in the authenticated account sent from or to the
+     * supplied address, including retained events whose parent message has expired.
+     * Events and durable recipients are deleted immediately with each message. The
+     * operation never searches or reports matches in another account. The legacy
+     * `/v2/emails` DELETE route is a backward-compatible alias.
+     *
+     * @example
+     * ```ts
+     * await client.emailMessages.deleteAll({
+     *   address: 'dev@stainless.com',
+     * });
+     * ```
+     */
+    deleteAll(params, options) {
+        const { address } = params;
+        return this._client.delete('/email_messages', {
+            query: { address },
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Lists messages sorted newest first by `created_at desc, id desc`. No filters
+     * other than cursor pagination are implemented. The legacy `/v2/emails` GET route
+     * is a backward-compatible alias for this operation.
+     *
+     * @example
+     * ```ts
+     * const emailMessages = await client.emailMessages.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/email_messages', { query, ...options });
+    }
+    /**
+     * Queues, schedules, or sandbox-sends an email message. The legacy `/v2/emails`
+     * POST route is a backward-compatible alias for this operation.
+     *
+     * `subject` is required unless `template_id` is supplied. When using
+     * `template_id`, do not also provide `subject`, `html_body`, or `text_body`; the
+     * template is rendered with `template_variables`.
+     *
+     * Note: template lookup failures (not found, wrong account) return 400, not 404.
+     *
+     * @example
+     * ```ts
+     * const emailMessageResponse =
+     *   await client.emailMessages.create({
+     *     from: 'sender@example.com',
+     *     to: ['recipient@example.com'],
+     *     subject: 'Hello from Telnyx',
+     *     text_body: 'This is a test email.',
+     *   });
+     * ```
+     */
+    create(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/email_messages', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Creates up to 50 email messages in a single request.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emailMessages.batch({
+     *   messages: [
+     *     {
+     *       from: 'sender@example.com',
+     *       to: ['recipient1@example.com'],
+     *       subject: 'Hello 1',
+     *       text_body: 'Message 1',
+     *     },
+     *     {
+     *       from: 'sender@example.com',
+     *       to: ['recipient2@example.com'],
+     *       subject: 'Hello 2',
+     *       text_body: 'Message 2',
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    batch(params, options) {
+        const { 'Idempotency-Key': idempotencyKey, ...body } = params;
+        return this._client.post('/email_messages/batch', {
+            body,
+            ...options,
+            headers: buildHeaders([
+                { ...(idempotencyKey != null ? { 'Idempotency-Key': idempotencyKey } : undefined) },
+                options?.headers,
+            ]),
+        });
+    }
+    /**
+     * Lists events for a single message sorted oldest first by
+     * `occurred_at asc, id asc`. The legacy `/v2/emails/{id}/events` GET route is a
+     * backward-compatible alias.
+     *
+     * @example
+     * ```ts
+     * const response = await client.emailMessages.retrieveEvents(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    retrieveEvents(emailID, query = {}, options) {
+        return this._client.get(path `/email_messages/${emailID}/events`, { query, ...options });
+    }
+    /**
+     * Cancels a scheduled email and returns it with status `cancelled`. The legacy
+     * `/v2/emails/{id}/schedule` DELETE route is an alias.
+     *
+     * @example
+     * ```ts
+     * const emailMessageResponse =
+     *   await client.emailMessages.deleteSchedule(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    deleteSchedule(emailID, options) {
+        return this._client.delete(path `/email_messages/${emailID}/schedule`, options);
+    }
+    /**
+     * Permanently deletes an account-scoped email message, its events, its durable
+     * recipients, and unshared attachment objects. Returns 404 when the message does
+     * not exist in the authenticated account. The legacy `/v2/emails/{id}` DELETE
+     * route is a backward-compatible alias.
+     *
+     * @example
+     * ```ts
+     * await client.emailMessages.delete(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    delete(id, options) {
+        return this._client.delete(path `/email_messages/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * The legacy `/v2/emails/{id}` GET route is a backward-compatible alias for this
+     * operation.
+     *
+     * @example
+     * ```ts
+     * const emailMessage = await client.emailMessages.retrieve(
+     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     * );
+     * ```
+     */
+    retrieve(id, options) {
+        return this._client.get(path `/email_messages/${id}`, options);
+    }
+}
+EmailMessages.Recipients = Recipients;
+//# sourceMappingURL=email-messages.mjs.map

package/resources/email-messages/email-messages.mjs.map

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

package/resources/email-messages/index.d.mts

@@ -0,0 +1,3 @@
+export { EmailMessages, type AttachmentRequest, type EmailAddressInput, type MessageEvent, type TrackingSettings, type EmailMessageRetrieveResponse, type EmailMessageListResponse, type EmailMessageBatchResponse, type EmailMessageRetrieveEventsResponse, type EmailMessageDeleteAllParams, type EmailMessageListParams, type EmailMessageCreateParams, type EmailMessageBatchParams, type EmailMessageRetrieveEventsParams, } from "./email-messages.mjs";
+export { Recipients, type EmailRecipient, type RecipientRetrieveResponse, type RecipientListResponse, type RecipientListParams, type RecipientRetrieveParams, } from "./recipients.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/email-messages/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/email-messages/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,GACtC,6BAAyB;AAC1B,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,yBAAqB"}

package/resources/email-messages/index.d.ts

@@ -0,0 +1,3 @@
+export { EmailMessages, type AttachmentRequest, type EmailAddressInput, type MessageEvent, type TrackingSettings, type EmailMessageRetrieveResponse, type EmailMessageListResponse, type EmailMessageBatchResponse, type EmailMessageRetrieveEventsResponse, type EmailMessageDeleteAllParams, type EmailMessageListParams, type EmailMessageCreateParams, type EmailMessageBatchParams, type EmailMessageRetrieveEventsParams, } from "./email-messages.js";
+export { Recipients, type EmailRecipient, type RecipientRetrieveResponse, type RecipientListResponse, type RecipientListParams, type RecipientRetrieveParams, } from "./recipients.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/email-messages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/email-messages/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,kCAAkC,EACvC,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,gCAAgC,GACtC,4BAAyB;AAC1B,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,wBAAqB"}

package/resources/email-messages/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Recipients = exports.EmailMessages = void 0;
+var email_messages_1 = require("./email-messages.js");
+Object.defineProperty(exports, "EmailMessages", { enumerable: true, get: function () { return email_messages_1.EmailMessages; } });
+var recipients_1 = require("./recipients.js");
+Object.defineProperty(exports, "Recipients", { enumerable: true, get: function () { return recipients_1.Recipients; } });
+//# sourceMappingURL=index.js.map

package/resources/email-messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/email-messages/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sDAe0B;AAdxB,+GAAA,aAAa,OAAA;AAef,8CAOsB;AANpB,wGAAA,UAAU,OAAA"}

package/resources/email-messages/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { EmailMessages, } from "./email-messages.mjs";
+export { Recipients, } from "./recipients.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/email-messages/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/email-messages/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,aAAa,GAcd,6BAAyB;AAC1B,OAAO,EACL,UAAU,GAMX,yBAAqB"}

package/resources/email-messages/recipients.d.mts

@@ -0,0 +1,118 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+/**
+ * Send and manage email messages. Legacy `/v2/emails` routes are aliases for these endpoints.
+ */
+export declare class Recipients extends APIResource {
+    /**
+     * Lists per-recipient delivery states for a single message with cursor pagination.
+     * Each recipient has an independent status, billable flag, and lifecycle
+     * timestamps. BCC recipient addresses are redacted (returned as null) to protect
+     * BCC privacy. Default page size is 25, maximum is 100.
+     *
+     * @example
+     * ```ts
+     * const recipients =
+     *   await client.emailMessages.recipients.list(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    list(emailID: string, query?: RecipientListParams | null | undefined, options?: RequestOptions): APIPromise<RecipientListResponse>;
+    /**
+     * Returns the current delivery state of a single recipient, including status,
+     * billable flag, SMTP detail, and lifecycle timestamps. BCC recipient addresses
+     * are redacted (returned as null).
+     *
+     * @example
+     * ```ts
+     * const recipient =
+     *   await client.emailMessages.recipients.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { email_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     *   );
+     * ```
+     */
+    retrieve(recipientID: string, params: RecipientRetrieveParams, options?: RequestOptions): APIPromise<RecipientRetrieveResponse>;
+}
+export interface EmailRecipient {
+    /**
+     * Recipient UUID.
+     */
+    id: string;
+    /**
+     * Recipient email address. Null for BCC recipients (redacted for privacy).
+     */
+    address: string | null;
+    /**
+     * Whether this recipient's delivery is billable (set on queue acceptance).
+     */
+    billable: boolean;
+    kind: 'to' | 'cc' | 'bcc';
+    /**
+     * Parent email message UUID.
+     */
+    message_id: string;
+    record_type: 'email_recipient';
+    /**
+     * Current per-recipient delivery status.
+     */
+    status: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled';
+    delivered_at?: string | null;
+    failed_at?: string | null;
+    sent_at?: string | null;
+    /**
+     * SMTP response code when available (e.g. 550 for bounces).
+     */
+    smtp_code?: number | null;
+    /**
+     * SMTP response message when available.
+     */
+    smtp_response?: string | null;
+}
+export interface RecipientRetrieveResponse {
+    data: EmailRecipient;
+}
+export interface RecipientListResponse {
+    data: Array<EmailRecipient>;
+    meta: RecipientListResponse.Meta;
+}
+export declare namespace RecipientListResponse {
+    interface Meta {
+        page_size: number;
+        /**
+         * Cursor for the next page. Absent when there are no more results.
+         */
+        page_cursor?: string | null;
+    }
+}
+export interface RecipientListParams {
+    /**
+     * Filter recipients by address kind.
+     */
+    kind?: 'to' | 'cc' | 'bcc';
+    /**
+     * Opaque URL-safe Base64 cursor returned by a previous list response.
+     */
+    page_cursor?: string;
+    /**
+     * Number of results to return. Defaults to 25; maximum is 100. Invalid values are
+     * clamped to the valid range.
+     */
+    page_size?: number;
+    /**
+     * Filter recipients by status.
+     */
+    status?: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled';
+}
+export interface RecipientRetrieveParams {
+    /**
+     * Email message UUID.
+     */
+    email_id: string;
+}
+export declare namespace Recipients {
+    export { type EmailRecipient as EmailRecipient, type RecipientRetrieveResponse as RecipientRetrieveResponse, type RecipientListResponse as RecipientListResponse, type RecipientListParams as RecipientListParams, type RecipientRetrieveParams as RecipientRetrieveParams, };
+}
+//# sourceMappingURL=recipients.d.mts.map

package/resources/email-messages/recipients.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipients.d.mts","sourceRoot":"","sources":["../../src/resources/email-messages/recipients.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,mCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,2CAAuC;AAGhE;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAIzC;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,iBAAiB,CAAC;IAE/B;;OAEG;IACH,MAAM,EACF,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAE5B,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC;CAClC;AAED,yBAAiB,qBAAqB,CAAC;IACrC,UAAiB,IAAI;QACnB,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EACH,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

package/resources/email-messages/recipients.d.ts

@@ -0,0 +1,118 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+/**
+ * Send and manage email messages. Legacy `/v2/emails` routes are aliases for these endpoints.
+ */
+export declare class Recipients extends APIResource {
+    /**
+     * Lists per-recipient delivery states for a single message with cursor pagination.
+     * Each recipient has an independent status, billable flag, and lifecycle
+     * timestamps. BCC recipient addresses are redacted (returned as null) to protect
+     * BCC privacy. Default page size is 25, maximum is 100.
+     *
+     * @example
+     * ```ts
+     * const recipients =
+     *   await client.emailMessages.recipients.list(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *   );
+     * ```
+     */
+    list(emailID: string, query?: RecipientListParams | null | undefined, options?: RequestOptions): APIPromise<RecipientListResponse>;
+    /**
+     * Returns the current delivery state of a single recipient, including status,
+     * billable flag, SMTP detail, and lifecycle timestamps. BCC recipient addresses
+     * are redacted (returned as null).
+     *
+     * @example
+     * ```ts
+     * const recipient =
+     *   await client.emailMessages.recipients.retrieve(
+     *     '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
+     *     { email_id: '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e' },
+     *   );
+     * ```
+     */
+    retrieve(recipientID: string, params: RecipientRetrieveParams, options?: RequestOptions): APIPromise<RecipientRetrieveResponse>;
+}
+export interface EmailRecipient {
+    /**
+     * Recipient UUID.
+     */
+    id: string;
+    /**
+     * Recipient email address. Null for BCC recipients (redacted for privacy).
+     */
+    address: string | null;
+    /**
+     * Whether this recipient's delivery is billable (set on queue acceptance).
+     */
+    billable: boolean;
+    kind: 'to' | 'cc' | 'bcc';
+    /**
+     * Parent email message UUID.
+     */
+    message_id: string;
+    record_type: 'email_recipient';
+    /**
+     * Current per-recipient delivery status.
+     */
+    status: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled';
+    delivered_at?: string | null;
+    failed_at?: string | null;
+    sent_at?: string | null;
+    /**
+     * SMTP response code when available (e.g. 550 for bounces).
+     */
+    smtp_code?: number | null;
+    /**
+     * SMTP response message when available.
+     */
+    smtp_response?: string | null;
+}
+export interface RecipientRetrieveResponse {
+    data: EmailRecipient;
+}
+export interface RecipientListResponse {
+    data: Array<EmailRecipient>;
+    meta: RecipientListResponse.Meta;
+}
+export declare namespace RecipientListResponse {
+    interface Meta {
+        page_size: number;
+        /**
+         * Cursor for the next page. Absent when there are no more results.
+         */
+        page_cursor?: string | null;
+    }
+}
+export interface RecipientListParams {
+    /**
+     * Filter recipients by address kind.
+     */
+    kind?: 'to' | 'cc' | 'bcc';
+    /**
+     * Opaque URL-safe Base64 cursor returned by a previous list response.
+     */
+    page_cursor?: string;
+    /**
+     * Number of results to return. Defaults to 25; maximum is 100. Invalid values are
+     * clamped to the valid range.
+     */
+    page_size?: number;
+    /**
+     * Filter recipients by status.
+     */
+    status?: 'queued' | 'sending' | 'sent' | 'deferred' | 'delivered' | 'bounced' | 'failed' | 'gw_reject' | 'cancelled';
+}
+export interface RecipientRetrieveParams {
+    /**
+     * Email message UUID.
+     */
+    email_id: string;
+}
+export declare namespace Recipients {
+    export { type EmailRecipient as EmailRecipient, type RecipientRetrieveResponse as RecipientRetrieveResponse, type RecipientListResponse as RecipientListResponse, type RecipientListParams as RecipientListParams, type RecipientRetrieveParams as RecipientRetrieveParams, };
+}
+//# sourceMappingURL=recipients.d.ts.map

package/resources/email-messages/recipients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipients.d.ts","sourceRoot":"","sources":["../../src/resources/email-messages/recipients.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAGhE;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC;;;;;;;;;;;;;OAaG;IACH,IAAI,CACF,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EAClD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,qBAAqB,CAAC;IAIpC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CACN,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAIzC;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE,iBAAiB,CAAC;IAE/B;;OAEG;IACH,MAAM,EACF,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;IAEhB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAE5B,IAAI,EAAE,qBAAqB,CAAC,IAAI,CAAC;CAClC;AAED,yBAAiB,qBAAqB,CAAC;IACrC,UAAiB,IAAI;QACnB,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EACH,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,WAAW,GACX,SAAS,GACT,QAAQ,GACR,WAAW,GACX,WAAW,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}