telnyx 7.23.0 → 7.24.0

package/resources/email-events.d.mts

@@ -1,8 +1,6 @@
 import { APIResource } from "../core/resource.mjs";
 import * as EmailEventsAPI from "./email-events.mjs";
-import * as DraftsAPI from "./email-inboxes/drafts.mjs";
 import { APIPromise } from "../core/api-promise.mjs";
-import { EmailCursorPagination, type EmailCursorPaginationParams, PagePromise } from "../core/pagination.mjs";
 import { RequestOptions } from "../internal/request-options.mjs";
 /**
  * Retrieve account-level email events and event statistics.
@@ -10,46 +8,161 @@ import { RequestOptions } from "../internal/request-options.mjs";
 export declare class EmailEvents extends APIResource {
     /**
      * Lists account-level email events sorted oldest first by
-     * `occurred_at asc, id asc`.
+     * `occurred_at asc, id asc`. Each row contains a legacy email.-prefixed event_type
+     * and an additive canonical_event_type. Gateway rejection renders email.failed
+     * with canonical email.gw_reject; ambiguous injection timeout renders
+     * email.injection_timeout in both; MTA expiration renders email.bounced with
+     * canonical email.expired. Message-scoped queued, sending, sandbox, cancelled, and
+     * daily_limit_exceeded rows fan out per durable recipient with stable derived IDs
+     * matching webhook delivery. Scheduled is the cardinality exception: account
+     * polling retains one message-scoped scheduled row with its stored event ID, while
+     * scheduled webhook publication fans out per recipient with derived IDs; reconcile
+     * scheduled events by message ID, event type, and occurrence time rather than
+     * event UUID. Recipient-scoped stored rows retain their stored UUIDs across
+     * polling and webhook delivery. Legacy names are derived from stored rows; an
+     * AdminBounce row stored as failed renders email.failed in polling while its
+     * webhook retains email.bounced, both with canonical email.failed.
      */
-    list(query?: EmailEventListParams | null | undefined, options?: RequestOptions): PagePromise<EmailEventListResponsesEmailCursorPagination, EmailEventListResponse>;
+    list(query?: EmailEventListParams | null | undefined, options?: RequestOptions): APIPromise<EmailEventListResponse>;
     /**
      * Returns counts and rates for email events over a time range. The default start
      * time is 30 days ago.
      */
     retrieveStats(query?: EmailEventRetrieveStatsParams | null | undefined, options?: RequestOptions): APIPromise<EmailEventRetrieveStatsResponse>;
 }
-export type EmailEventListResponsesEmailCursorPagination = EmailCursorPagination<EmailEventListResponse>;
-export type EmailEventType = 'queued' | 'deferred' | 'scheduled' | 'cancelled' | 'sandbox' | 'sending' | 'sent' | 'failed' | 'delivered' | 'bounced' | 'complained' | 'rejected' | 'opened' | 'clicked' | 'unsubscribed' | 'daily_limit_exceeded';
+/**
+ * Bare stored event names returned by message history. In addition to the normal
+ * send and delivery lifecycle, polling can expose suppression, scan, and
+ * quarantine lifecycle rows. Sharp canonical names gw_reject, injection_timeout,
+ * and expired distinguish gateway rejection, ambiguous injection timeout, and MTA
+ * expiration. The failed and bounced names remain valid for system/admin failures
+ * and hard bounces respectively. Existing stored rows retain their original names.
+ */
+export type EmailEventType = 'queued' | 'deferred' | 'scheduled' | 'cancelled' | 'sandbox' | 'sending' | 'sent' | 'failed' | 'delivered' | 'bounced' | 'complained' | 'suppressed' | 'rejected' | 'opened' | 'clicked' | 'unsubscribed' | 'daily_limit_exceeded' | 'scan_deferred' | 'quarantined' | 'quarantine_released' | 'quarantine_release_dispatched' | 'quarantine_rejected' | 'quarantine_expired' | 'gw_reject' | 'injection_timeout' | 'expired';
+export interface EmailWebhookRecipient {
+    email: string;
+    kind?: 'to' | 'cc' | 'bcc';
+    name?: string | null;
+}
 export interface TimeRange {
     from: string | null;
     to: string | null;
 }
 export interface EmailEventListResponse {
-    id: string;
-    email_id: string;
-    occurred_at: string;
-    record_type: 'email_event';
-    type: EmailEventType;
-    /**
-     * Summary of the associated email message. Present when the email_message preload
-     * is available.
-     */
-    email?: EmailEventListResponse.Email;
-    payload?: {
-        [key: string]: unknown;
-    };
+    data: Array<EmailEventListResponse.Data>;
+    meta: EmailEventListResponse.Meta;
 }
 export declare namespace EmailEventListResponse {
     /**
-     * Summary of the associated email message. Present when the email_message preload
-     * is available.
+     * An account-polling event. The envelope is webhook-shaped, but polling preserves
+     * stored-event cardinality: queued, sending, sandbox, cancelled, and
+     * daily_limit_exceeded message events fan out per recipient; scheduled remains one
+     * message-scoped row. Payload fields vary among recipient-scoped, message-scoped,
+     * and minimal fallback rows.
      */
-    interface Email {
-        cc: Array<DraftsAPI.EmailAddress>;
-        from: DraftsAPI.EmailAddress;
-        subject: string;
-        to: Array<DraftsAPI.EmailAddress>;
+    interface Data {
+        /**
+         * Event UUID.
+         */
+        id: string;
+        /**
+         * Additive canonical outcome name, prefixed with `email.`. Gateway rejection is
+         * `email.gw_reject`, ambiguous injection timeout is `email.injection_timeout`, and
+         * MTA expiration is `email.expired`. Unchanged outcomes retain their names.
+         * Existing stored rows are translated only when recorded payload evidence proves
+         * the outcome; a legacy failed row is not guessed or sharpened.
+         */
+        canonical_event_type: string;
+        /**
+         * Legacy customer-visible event name, prefixed with `email.`. Gateway rejections
+         * render `email.failed`; MTA expirations render `email.bounced`. Webhook
+         * subscription allowlists match the legacy name.
+         */
+        event_type: string;
+        occurred_at: string;
+        /**
+         * Payload returned by GET /email_events. Every row includes id, status, and
+         * occurred_at. Recipient-scoped rows also include recipient_id, from, subject, and
+         * exactly one object-valued to, cc, or bcc field. Legacy or message-scoped rows
+         * can omit recipient_id and use object-valued or string-valued to/cc fields,
+         * including an empty string when no address exists; bcc is redacted. If the
+         * related message or recipient cannot be loaded, the minimal fallback can omit
+         * from, subject, and recipient fields. Additional persisted public evidence can be
+         * present.
+         */
+        payload: Data.Payload;
+        /**
+         * Durable email recipient UUID. Present for recipient-scoped events, including
+         * each queued, sending, sandbox, cancelled, and daily_limit_exceeded fan-out
+         * event.
+         */
+        recipient_id?: string;
+    }
+    namespace Data {
+        /**
+         * Payload returned by GET /email_events. Every row includes id, status, and
+         * occurred_at. Recipient-scoped rows also include recipient_id, from, subject, and
+         * exactly one object-valued to, cc, or bcc field. Legacy or message-scoped rows
+         * can omit recipient_id and use object-valued or string-valued to/cc fields,
+         * including an empty string when no address exists; bcc is redacted. If the
+         * related message or recipient cannot be loaded, the minimal fallback can omit
+         * from, subject, and recipient fields. Additional persisted public evidence can be
+         * present.
+         */
+        interface Payload {
+            /**
+             * Email message UUID.
+             */
+            id: string;
+            occurred_at: string;
+            /**
+             * Stored event outcome slug, not the authoritative recipient status. Account
+             * polling returns the stored name, including suppression, scan, and quarantine
+             * lifecycle names. Webhooks retain legacy payload names: gateway rejections use
+             * failed and MTA expirations use bounced. New sharp stored rows can expose
+             * gw_reject, injection_timeout, or expired. Use the envelope canonical_event_type
+             * to identify the outcome across surfaces.
+             */
+            status: 'queued' | 'deferred' | 'scheduled' | 'cancelled' | 'sandbox' | 'sending' | 'sent' | 'failed' | 'delivered' | 'bounced' | 'complained' | 'suppressed' | 'rejected' | 'opened' | 'clicked' | 'unsubscribed' | 'daily_limit_exceeded' | 'scan_deferred' | 'quarantined' | 'quarantine_released' | 'quarantine_release_dispatched' | 'quarantine_rejected' | 'quarantine_expired' | 'gw_reject' | 'injection_timeout' | 'expired';
+            bcc?: EmailEventsAPI.EmailWebhookRecipient | 'redacted';
+            /**
+             * Legacy message-scoped address, or an empty string when absent.
+             */
+            cc?: EmailEventsAPI.EmailWebhookRecipient | string;
+            /**
+             * Sender projection in account event polling. The display name is explicitly null
+             * when the message has no sender name.
+             */
+            from?: Payload.From;
+            /**
+             * Durable email recipient UUID. Present for recipient-scoped events.
+             */
+            recipient_id?: string;
+            subject?: string;
+            /**
+             * Legacy message-scoped address, or an empty string when absent.
+             */
+            to?: EmailEventsAPI.EmailWebhookRecipient | string;
+            [k: string]: unknown;
+        }
+        namespace Payload {
+            /**
+             * Sender projection in account event polling. The display name is explicitly null
+             * when the message has no sender name.
+             */
+            interface From {
+                email: string;
+                name: string | null;
+            }
+        }
+    }
+    interface Meta {
+        page_size: number;
+        time_range: EmailEventsAPI.TimeRange;
+        /**
+         * Cursor for the next page, when more results are available.
+         */
+        page_cursor?: string;
     }
 }
 export interface EmailEventRetrieveStatsResponse {
@@ -126,7 +239,7 @@ export declare namespace EmailEventRetrieveStatsResponse {
         }
     }
 }
-export interface EmailEventListParams extends EmailCursorPaginationParams {
+export interface EmailEventListParams {
     /**
      * Filter events for a specific email message UUID. Invalid UUID values are
      * silently ignored (no filter applied).
@@ -136,12 +249,33 @@ export interface EmailEventListParams extends EmailCursorPaginationParams {
      * Comma-separated list of event types to include. Also accepts repeated query
      * parameters (e.g. event_type=delivered&event_type=bounced). Unknown values return
      * no matches.
+     *
+     * Dual-name compatibility: values are accepted bare or `email.`-prefixed. A legacy
+     * value keeps matching the rows it matched pre-rename — no widening: `failed` also
+     * matches the rows that now store the canonical names of the outcomes it covered
+     * (`gw_reject`, `injection_timeout`, `expired`); `bounced` matches stored
+     * `bounced` rows only (recipient-scoped Expirations stored `failed` pre-rename and
+     * never matched `bounced`, so `expired` is deliberately not a `bounced`
+     * expansion). A canonical value matches its own rows plus legacy rows whose
+     * recorded payload evidence proves that outcome (`expired` also surfaces legacy
+     * `bounced` rows with `bounce_category: transient`). The additive
+     * `canonical_event_type` field in each response row names the canonical outcome.
      */
     event_type?: string | Array<string>;
     /**
      * Inclusive ISO 8601 start timestamp. Defaults to 30 days ago when omitted.
      */
     from?: string;
+    /**
+     * Number of results to return. Defaults to 25; maximum is 100. Invalid values are
+     * clamped to the valid range.
+     */
+    page_size?: number;
+    /**
+     * Opaque URL-safe Base64 cursor returned by a previous event list response. The
+     * legacy `page[after]` and flat `page_cursor` forms are also accepted.
+     */
+    'page[cursor]'?: string;
     /**
      * Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
      * to `from + 30 days`.
@@ -160,6 +294,6 @@ export interface EmailEventRetrieveStatsParams {
     to?: string;
 }
 export declare namespace EmailEvents {
-    export { type EmailEventType as EmailEventType, type TimeRange as TimeRange, type EmailEventListResponse as EmailEventListResponse, type EmailEventRetrieveStatsResponse as EmailEventRetrieveStatsResponse, type EmailEventListResponsesEmailCursorPagination as EmailEventListResponsesEmailCursorPagination, type EmailEventListParams as EmailEventListParams, type EmailEventRetrieveStatsParams as EmailEventRetrieveStatsParams, };
+    export { type EmailEventType as EmailEventType, type EmailWebhookRecipient as EmailWebhookRecipient, type TimeRange as TimeRange, type EmailEventListResponse as EmailEventListResponse, type EmailEventRetrieveStatsResponse as EmailEventRetrieveStatsResponse, type EmailEventListParams as EmailEventListParams, type EmailEventRetrieveStatsParams as EmailEventRetrieveStatsParams, };
 }
 //# sourceMappingURL=email-events.d.mts.map

package/resources/email-events.d.mts.map

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

package/resources/email-events.d.ts

@@ -1,8 +1,6 @@
 import { APIResource } from "../core/resource.js";
 import * as EmailEventsAPI from "./email-events.js";
-import * as DraftsAPI from "./email-inboxes/drafts.js";
 import { APIPromise } from "../core/api-promise.js";
-import { EmailCursorPagination, type EmailCursorPaginationParams, PagePromise } from "../core/pagination.js";
 import { RequestOptions } from "../internal/request-options.js";
 /**
  * Retrieve account-level email events and event statistics.
@@ -10,46 +8,161 @@ import { RequestOptions } from "../internal/request-options.js";
 export declare class EmailEvents extends APIResource {
     /**
      * Lists account-level email events sorted oldest first by
-     * `occurred_at asc, id asc`.
+     * `occurred_at asc, id asc`. Each row contains a legacy email.-prefixed event_type
+     * and an additive canonical_event_type. Gateway rejection renders email.failed
+     * with canonical email.gw_reject; ambiguous injection timeout renders
+     * email.injection_timeout in both; MTA expiration renders email.bounced with
+     * canonical email.expired. Message-scoped queued, sending, sandbox, cancelled, and
+     * daily_limit_exceeded rows fan out per durable recipient with stable derived IDs
+     * matching webhook delivery. Scheduled is the cardinality exception: account
+     * polling retains one message-scoped scheduled row with its stored event ID, while
+     * scheduled webhook publication fans out per recipient with derived IDs; reconcile
+     * scheduled events by message ID, event type, and occurrence time rather than
+     * event UUID. Recipient-scoped stored rows retain their stored UUIDs across
+     * polling and webhook delivery. Legacy names are derived from stored rows; an
+     * AdminBounce row stored as failed renders email.failed in polling while its
+     * webhook retains email.bounced, both with canonical email.failed.
      */
-    list(query?: EmailEventListParams | null | undefined, options?: RequestOptions): PagePromise<EmailEventListResponsesEmailCursorPagination, EmailEventListResponse>;
+    list(query?: EmailEventListParams | null | undefined, options?: RequestOptions): APIPromise<EmailEventListResponse>;
     /**
      * Returns counts and rates for email events over a time range. The default start
      * time is 30 days ago.
      */
     retrieveStats(query?: EmailEventRetrieveStatsParams | null | undefined, options?: RequestOptions): APIPromise<EmailEventRetrieveStatsResponse>;
 }
-export type EmailEventListResponsesEmailCursorPagination = EmailCursorPagination<EmailEventListResponse>;
-export type EmailEventType = 'queued' | 'deferred' | 'scheduled' | 'cancelled' | 'sandbox' | 'sending' | 'sent' | 'failed' | 'delivered' | 'bounced' | 'complained' | 'rejected' | 'opened' | 'clicked' | 'unsubscribed' | 'daily_limit_exceeded';
+/**
+ * Bare stored event names returned by message history. In addition to the normal
+ * send and delivery lifecycle, polling can expose suppression, scan, and
+ * quarantine lifecycle rows. Sharp canonical names gw_reject, injection_timeout,
+ * and expired distinguish gateway rejection, ambiguous injection timeout, and MTA
+ * expiration. The failed and bounced names remain valid for system/admin failures
+ * and hard bounces respectively. Existing stored rows retain their original names.
+ */
+export type EmailEventType = 'queued' | 'deferred' | 'scheduled' | 'cancelled' | 'sandbox' | 'sending' | 'sent' | 'failed' | 'delivered' | 'bounced' | 'complained' | 'suppressed' | 'rejected' | 'opened' | 'clicked' | 'unsubscribed' | 'daily_limit_exceeded' | 'scan_deferred' | 'quarantined' | 'quarantine_released' | 'quarantine_release_dispatched' | 'quarantine_rejected' | 'quarantine_expired' | 'gw_reject' | 'injection_timeout' | 'expired';
+export interface EmailWebhookRecipient {
+    email: string;
+    kind?: 'to' | 'cc' | 'bcc';
+    name?: string | null;
+}
 export interface TimeRange {
     from: string | null;
     to: string | null;
 }
 export interface EmailEventListResponse {
-    id: string;
-    email_id: string;
-    occurred_at: string;
-    record_type: 'email_event';
-    type: EmailEventType;
-    /**
-     * Summary of the associated email message. Present when the email_message preload
-     * is available.
-     */
-    email?: EmailEventListResponse.Email;
-    payload?: {
-        [key: string]: unknown;
-    };
+    data: Array<EmailEventListResponse.Data>;
+    meta: EmailEventListResponse.Meta;
 }
 export declare namespace EmailEventListResponse {
     /**
-     * Summary of the associated email message. Present when the email_message preload
-     * is available.
+     * An account-polling event. The envelope is webhook-shaped, but polling preserves
+     * stored-event cardinality: queued, sending, sandbox, cancelled, and
+     * daily_limit_exceeded message events fan out per recipient; scheduled remains one
+     * message-scoped row. Payload fields vary among recipient-scoped, message-scoped,
+     * and minimal fallback rows.
      */
-    interface Email {
-        cc: Array<DraftsAPI.EmailAddress>;
-        from: DraftsAPI.EmailAddress;
-        subject: string;
-        to: Array<DraftsAPI.EmailAddress>;
+    interface Data {
+        /**
+         * Event UUID.
+         */
+        id: string;
+        /**
+         * Additive canonical outcome name, prefixed with `email.`. Gateway rejection is
+         * `email.gw_reject`, ambiguous injection timeout is `email.injection_timeout`, and
+         * MTA expiration is `email.expired`. Unchanged outcomes retain their names.
+         * Existing stored rows are translated only when recorded payload evidence proves
+         * the outcome; a legacy failed row is not guessed or sharpened.
+         */
+        canonical_event_type: string;
+        /**
+         * Legacy customer-visible event name, prefixed with `email.`. Gateway rejections
+         * render `email.failed`; MTA expirations render `email.bounced`. Webhook
+         * subscription allowlists match the legacy name.
+         */
+        event_type: string;
+        occurred_at: string;
+        /**
+         * Payload returned by GET /email_events. Every row includes id, status, and
+         * occurred_at. Recipient-scoped rows also include recipient_id, from, subject, and
+         * exactly one object-valued to, cc, or bcc field. Legacy or message-scoped rows
+         * can omit recipient_id and use object-valued or string-valued to/cc fields,
+         * including an empty string when no address exists; bcc is redacted. If the
+         * related message or recipient cannot be loaded, the minimal fallback can omit
+         * from, subject, and recipient fields. Additional persisted public evidence can be
+         * present.
+         */
+        payload: Data.Payload;
+        /**
+         * Durable email recipient UUID. Present for recipient-scoped events, including
+         * each queued, sending, sandbox, cancelled, and daily_limit_exceeded fan-out
+         * event.
+         */
+        recipient_id?: string;
+    }
+    namespace Data {
+        /**
+         * Payload returned by GET /email_events. Every row includes id, status, and
+         * occurred_at. Recipient-scoped rows also include recipient_id, from, subject, and
+         * exactly one object-valued to, cc, or bcc field. Legacy or message-scoped rows
+         * can omit recipient_id and use object-valued or string-valued to/cc fields,
+         * including an empty string when no address exists; bcc is redacted. If the
+         * related message or recipient cannot be loaded, the minimal fallback can omit
+         * from, subject, and recipient fields. Additional persisted public evidence can be
+         * present.
+         */
+        interface Payload {
+            /**
+             * Email message UUID.
+             */
+            id: string;
+            occurred_at: string;
+            /**
+             * Stored event outcome slug, not the authoritative recipient status. Account
+             * polling returns the stored name, including suppression, scan, and quarantine
+             * lifecycle names. Webhooks retain legacy payload names: gateway rejections use
+             * failed and MTA expirations use bounced. New sharp stored rows can expose
+             * gw_reject, injection_timeout, or expired. Use the envelope canonical_event_type
+             * to identify the outcome across surfaces.
+             */
+            status: 'queued' | 'deferred' | 'scheduled' | 'cancelled' | 'sandbox' | 'sending' | 'sent' | 'failed' | 'delivered' | 'bounced' | 'complained' | 'suppressed' | 'rejected' | 'opened' | 'clicked' | 'unsubscribed' | 'daily_limit_exceeded' | 'scan_deferred' | 'quarantined' | 'quarantine_released' | 'quarantine_release_dispatched' | 'quarantine_rejected' | 'quarantine_expired' | 'gw_reject' | 'injection_timeout' | 'expired';
+            bcc?: EmailEventsAPI.EmailWebhookRecipient | 'redacted';
+            /**
+             * Legacy message-scoped address, or an empty string when absent.
+             */
+            cc?: EmailEventsAPI.EmailWebhookRecipient | string;
+            /**
+             * Sender projection in account event polling. The display name is explicitly null
+             * when the message has no sender name.
+             */
+            from?: Payload.From;
+            /**
+             * Durable email recipient UUID. Present for recipient-scoped events.
+             */
+            recipient_id?: string;
+            subject?: string;
+            /**
+             * Legacy message-scoped address, or an empty string when absent.
+             */
+            to?: EmailEventsAPI.EmailWebhookRecipient | string;
+            [k: string]: unknown;
+        }
+        namespace Payload {
+            /**
+             * Sender projection in account event polling. The display name is explicitly null
+             * when the message has no sender name.
+             */
+            interface From {
+                email: string;
+                name: string | null;
+            }
+        }
+    }
+    interface Meta {
+        page_size: number;
+        time_range: EmailEventsAPI.TimeRange;
+        /**
+         * Cursor for the next page, when more results are available.
+         */
+        page_cursor?: string;
     }
 }
 export interface EmailEventRetrieveStatsResponse {
@@ -126,7 +239,7 @@ export declare namespace EmailEventRetrieveStatsResponse {
         }
     }
 }
-export interface EmailEventListParams extends EmailCursorPaginationParams {
+export interface EmailEventListParams {
     /**
      * Filter events for a specific email message UUID. Invalid UUID values are
      * silently ignored (no filter applied).
@@ -136,12 +249,33 @@ export interface EmailEventListParams extends EmailCursorPaginationParams {
      * Comma-separated list of event types to include. Also accepts repeated query
      * parameters (e.g. event_type=delivered&event_type=bounced). Unknown values return
      * no matches.
+     *
+     * Dual-name compatibility: values are accepted bare or `email.`-prefixed. A legacy
+     * value keeps matching the rows it matched pre-rename — no widening: `failed` also
+     * matches the rows that now store the canonical names of the outcomes it covered
+     * (`gw_reject`, `injection_timeout`, `expired`); `bounced` matches stored
+     * `bounced` rows only (recipient-scoped Expirations stored `failed` pre-rename and
+     * never matched `bounced`, so `expired` is deliberately not a `bounced`
+     * expansion). A canonical value matches its own rows plus legacy rows whose
+     * recorded payload evidence proves that outcome (`expired` also surfaces legacy
+     * `bounced` rows with `bounce_category: transient`). The additive
+     * `canonical_event_type` field in each response row names the canonical outcome.
      */
     event_type?: string | Array<string>;
     /**
      * Inclusive ISO 8601 start timestamp. Defaults to 30 days ago when omitted.
      */
     from?: string;
+    /**
+     * Number of results to return. Defaults to 25; maximum is 100. Invalid values are
+     * clamped to the valid range.
+     */
+    page_size?: number;
+    /**
+     * Opaque URL-safe Base64 cursor returned by a previous event list response. The
+     * legacy `page[after]` and flat `page_cursor` forms are also accepted.
+     */
+    'page[cursor]'?: string;
     /**
      * Inclusive ISO 8601 end timestamp. When `from` is provided without `to`, defaults
      * to `from + 30 days`.
@@ -160,6 +294,6 @@ export interface EmailEventRetrieveStatsParams {
     to?: string;
 }
 export declare namespace EmailEvents {
-    export { type EmailEventType as EmailEventType, type TimeRange as TimeRange, type EmailEventListResponse as EmailEventListResponse, type EmailEventRetrieveStatsResponse as EmailEventRetrieveStatsResponse, type EmailEventListResponsesEmailCursorPagination as EmailEventListResponsesEmailCursorPagination, type EmailEventListParams as EmailEventListParams, type EmailEventRetrieveStatsParams as EmailEventRetrieveStatsParams, };
+    export { type EmailEventType as EmailEventType, type EmailWebhookRecipient as EmailWebhookRecipient, type TimeRange as TimeRange, type EmailEventListResponse as EmailEventListResponse, type EmailEventRetrieveStatsResponse as EmailEventRetrieveStatsResponse, type EmailEventListParams as EmailEventListParams, type EmailEventRetrieveStatsParams as EmailEventRetrieveStatsParams, };
 }
 //# sourceMappingURL=email-events.d.ts.map

package/resources/email-events.d.ts.map

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

package/resources/email-events.js

@@ -3,20 +3,29 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmailEvents = void 0;
 const resource_1 = require("../core/resource.js");
-const pagination_1 = require("../core/pagination.js");
 /**
  * Retrieve account-level email events and event statistics.
  */
 class EmailEvents extends resource_1.APIResource {
     /**
      * Lists account-level email events sorted oldest first by
-     * `occurred_at asc, id asc`.
+     * `occurred_at asc, id asc`. Each row contains a legacy email.-prefixed event_type
+     * and an additive canonical_event_type. Gateway rejection renders email.failed
+     * with canonical email.gw_reject; ambiguous injection timeout renders
+     * email.injection_timeout in both; MTA expiration renders email.bounced with
+     * canonical email.expired. Message-scoped queued, sending, sandbox, cancelled, and
+     * daily_limit_exceeded rows fan out per durable recipient with stable derived IDs
+     * matching webhook delivery. Scheduled is the cardinality exception: account
+     * polling retains one message-scoped scheduled row with its stored event ID, while
+     * scheduled webhook publication fans out per recipient with derived IDs; reconcile
+     * scheduled events by message ID, event type, and occurrence time rather than
+     * event UUID. Recipient-scoped stored rows retain their stored UUIDs across
+     * polling and webhook delivery. Legacy names are derived from stored rows; an
+     * AdminBounce row stored as failed renders email.failed in polling while its
+     * webhook retains email.bounced, both with canonical email.failed.
      */
     list(query = {}, options) {
-        return this._client.getAPIList('/email_events', (pagination_1.EmailCursorPagination), {
-            query,
-            ...options,
-        });
+        return this._client.get('/email_events', { query, ...options });
     }
     /**
      * Returns counts and rates for email events over a time range. The default start

package/resources/email-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"email-events.js","sourceRoot":"","sources":["../src/resources/email-events.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,sDAA0G;AAG1G;;GAEG;AACH,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;OAGG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA,kCAA6C,CAAA,EAAE;YAC7F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,aAAa,CACX,QAA0D,EAAE,EAC5D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;CACF;AAzBD,kCAyBC"}
+{"version":3,"file":"email-events.js","sourceRoot":"","sources":["../src/resources/email-events.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAK/C;;GAEG;AACH,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,aAAa,CACX,QAA0D,EAAE,EAC5D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;CACF;AAnCD,kCAmCC"}

package/resources/email-events.mjs

@@ -1,19 +1,28 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../core/resource.mjs";
-import { EmailCursorPagination } from "../core/pagination.mjs";
 /**
  * Retrieve account-level email events and event statistics.
  */
 export class EmailEvents extends APIResource {
     /**
      * Lists account-level email events sorted oldest first by
-     * `occurred_at asc, id asc`.
+     * `occurred_at asc, id asc`. Each row contains a legacy email.-prefixed event_type
+     * and an additive canonical_event_type. Gateway rejection renders email.failed
+     * with canonical email.gw_reject; ambiguous injection timeout renders
+     * email.injection_timeout in both; MTA expiration renders email.bounced with
+     * canonical email.expired. Message-scoped queued, sending, sandbox, cancelled, and
+     * daily_limit_exceeded rows fan out per durable recipient with stable derived IDs
+     * matching webhook delivery. Scheduled is the cardinality exception: account
+     * polling retains one message-scoped scheduled row with its stored event ID, while
+     * scheduled webhook publication fans out per recipient with derived IDs; reconcile
+     * scheduled events by message ID, event type, and occurrence time rather than
+     * event UUID. Recipient-scoped stored rows retain their stored UUIDs across
+     * polling and webhook delivery. Legacy names are derived from stored rows; an
+     * AdminBounce row stored as failed renders email.failed in polling while its
+     * webhook retains email.bounced, both with canonical email.failed.
      */
     list(query = {}, options) {
-        return this._client.getAPIList('/email_events', (EmailCursorPagination), {
-            query,
-            ...options,
-        });
+        return this._client.get('/email_events', { query, ...options });
     }
     /**
      * Returns counts and rates for email events over a time range. The default start

package/resources/email-events.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"email-events.mjs","sourceRoot":"","sources":["../src/resources/email-events.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAI/C,OAAO,EAAE,qBAAqB,EAAiD,+BAA2B;AAG1G;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;OAGG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAA,qBAA6C,CAAA,EAAE;YAC7F,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,aAAa,CACX,QAA0D,EAAE,EAC5D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;CACF"}
+{"version":3,"file":"email-events.mjs","sourceRoot":"","sources":["../src/resources/email-events.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAK/C;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CACF,QAAiD,EAAE,EACnD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;OAGG;IACH,aAAa,CACX,QAA0D,EAAE,EAC5D,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;CACF"}