resend 6.1.0-canary.0 → 6.1.0

package/dist/index.d.mts

@@ -1,42 +1,43 @@
-import * as React from 'react';
+import * as React$1 from 'react';
 
 interface GetOptions {
     query?: Record<string, unknown>;
+    headers?: HeadersInit;
 }
 
+type PaginationOptions = {
+    /**
+     * Maximum number of items to return (1-100, default: 20)
+     */
+    limit?: number;
+} & ({
+    /**
+     * Get items after this cursor (cannot be used with 'before')
+     */
+    after?: string;
+    before?: never;
+} | {
+    /**
+     * Get items before this cursor (cannot be used with 'after')
+     */
+    before?: string;
+    after?: never;
+});
+
 interface PostOptions {
     query?: {
         [key: string]: unknown;
     };
+    headers?: HeadersInit;
 }
 
 interface PutOptions {
     query?: {
         [key: string]: unknown;
     };
+    headers?: HeadersInit;
 }
 
-type RateLimit = {
-    /**
-     * The maximum amount of requests that can be made in the time window of {@link shouldResetAfter}.
-     */
-    limit: number;
-    /**
-     * The amount of requests that can still be made before hitting {@link RateLimit.limit}.
-     *
-     * Resets after the seconds in {@link RateLimit.shouldResetAfter} go by.
-     */
-    remainingRequests: number;
-    /**
-     * The number of seconds after which the rate limiting will reset,
-     * and {@link RateLimit.remainingRequests} goes back to the value of
-     * {@link RateLimit.limit}.
-     *
-     * @see {@link import('./interfaces').Response.retryAfter}
-     */
-    shouldResetAfter: number;
-};
-
 declare const RESEND_ERROR_CODES_BY_KEY: {
     readonly missing_required_field: 422;
     readonly invalid_idempotency_key: 400;
@@ -47,7 +48,7 @@ declare const RESEND_ERROR_CODES_BY_KEY: {
     readonly invalid_region: 422;
     readonly rate_limit_exceeded: 429;
     readonly missing_api_key: 401;
-    readonly invalid_api_Key: 403;
+    readonly invalid_api_key: 403;
     readonly invalid_from_address: 403;
     readonly validation_error: 403;
     readonly not_found: 404;
@@ -56,26 +57,10 @@ declare const RESEND_ERROR_CODES_BY_KEY: {
     readonly internal_server_error: 500;
 };
 type RESEND_ERROR_CODE_KEY = keyof typeof RESEND_ERROR_CODES_BY_KEY;
-type ErrorResponse = {
-    message: string;
-    name: Exclude<RESEND_ERROR_CODE_KEY, 'rate_limit_exceeded'>;
-} | {
+interface ErrorResponse {
     message: string;
-    name: Extract<RESEND_ERROR_CODE_KEY, 'rate_limit_exceeded'>;
-    /**
-     * Time in seconds.
-     */
-    retryAfter: number;
-};
-type Response<Data> = {
-    data: Data;
-    rateLimiting: RateLimit;
-    error: null;
-} | {
-    data: null;
-    rateLimiting: RateLimit | null;
-    error: ErrorResponse;
-};
+    name: RESEND_ERROR_CODE_KEY;
+}
 
 interface CreateApiKeyOptions {
     name: string;
@@ -88,7 +73,13 @@ interface CreateApiKeyResponseSuccess {
     token: string;
     id: string;
 }
-type CreateApiKeyResponse = Response<CreateApiKeyResponseSuccess>;
+type CreateApiKeyResponse = {
+    data: CreateApiKeyResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface ApiKey {
     created_at: string;
@@ -96,19 +87,28 @@ interface ApiKey {
     name: string;
 }
 
-type ListApiKeysResponseSuccess = Pick<ApiKey, 'name' | 'id' | 'created_at'>[];
-type ListApiKeysResponse = Response<ListApiKeysResponseSuccess>;
+type ListApiKeysOptions = PaginationOptions;
+type ListApiKeysResponseSuccess = {
+    object: 'list';
+    has_more: boolean;
+    data: Pick<ApiKey, 'name' | 'id' | 'created_at'>[];
+};
+type ListApiKeysResponse = {
+    data: ListApiKeysResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 type RemoveApiKeyResponseSuccess = {};
-type RemoveApiKeyResponse = Response<RemoveApiKeyResponseSuccess>;
-
-declare class ApiKeys {
-    private readonly resend;
-    constructor(resend: Resend);
-    create(payload: CreateApiKeyOptions, options?: CreateApiKeyRequestOptions): Promise<CreateApiKeyResponse>;
-    list(): Promise<ListApiKeysResponse>;
-    remove(id: string): Promise<RemoveApiKeyResponse>;
-}
+type RemoveApiKeyResponse = {
+    data: RemoveApiKeyResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface Audience {
     created_at: string;
@@ -124,33 +124,50 @@ interface CreateAudienceRequestOptions extends PostOptions {
 interface CreateAudienceResponseSuccess extends Pick<Audience, 'name' | 'id'> {
     object: 'audience';
 }
-type CreateAudienceResponse = Response<CreateAudienceResponseSuccess>;
+type CreateAudienceResponse = {
+    data: CreateAudienceResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface GetAudienceResponseSuccess extends Pick<Audience, 'id' | 'name' | 'created_at'> {
     object: 'audience';
 }
-type GetAudienceResponse = Response<GetAudienceResponseSuccess>;
+type GetAudienceResponse = {
+    data: GetAudienceResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
+type ListAudiencesOptions = PaginationOptions;
 type ListAudiencesResponseSuccess = {
     object: 'list';
     data: Audience[];
+    has_more: boolean;
+};
+type ListAudiencesResponse = {
+    data: ListAudiencesResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
 };
-type ListAudiencesResponse = Response<ListAudiencesResponseSuccess>;
 
 interface RemoveAudiencesResponseSuccess extends Pick<Audience, 'id'> {
     object: 'audience';
     deleted: boolean;
 }
-type RemoveAudiencesResponse = Response<RemoveAudiencesResponseSuccess>;
-
-declare class Audiences {
-    private readonly resend;
-    constructor(resend: Resend);
-    create(payload: CreateAudienceOptions, options?: CreateAudienceRequestOptions): Promise<CreateAudienceResponse>;
-    list(): Promise<ListAudiencesResponse>;
-    get(id: string): Promise<GetAudienceResponse>;
-    remove(id: string): Promise<RemoveAudiencesResponse>;
-}
+type RemoveAudiencesResponse = {
+    data: RemoveAudiencesResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface IdempotentRequest {
     /**
@@ -171,7 +188,7 @@ interface EmailRenderOptions$1 {
      *
      * @link https://resend.com/docs/api-reference/emails/send-email#body-parameters
      */
-    react: React.ReactNode;
+    react: React$1.ReactNode;
     /**
      * The HTML version of the message.
      *
@@ -255,7 +272,13 @@ interface CreateEmailResponseSuccess {
     /** The ID of the newly created email. */
     id: string;
 }
-type CreateEmailResponse = Response<CreateEmailResponseSuccess>;
+type CreateEmailResponse = {
+    data: CreateEmailResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 interface Attachment {
     /** Content of an attached file. */
     content?: string | Buffer;
@@ -284,22 +307,38 @@ type Tag = {
 
 type CreateBatchOptions = CreateEmailOptions[];
 interface CreateBatchRequestOptions extends PostOptions, IdempotentRequest {
+    /**
+     * @default 'strict'
+     */
+    batchValidation?: 'strict' | 'permissive';
 }
-interface CreateBatchSuccessResponse {
+type CreateBatchSuccessResponse<Options extends CreateBatchRequestOptions = CreateBatchRequestOptions> = {
     data: {
         /** The ID of the newly created email. */
         id: string;
     }[];
-}
-type CreateBatchResponse = Response<CreateBatchSuccessResponse>;
-
-declare class Batch {
-    private readonly resend;
-    private renderAsync?;
-    constructor(resend: Resend);
-    send(payload: CreateBatchOptions, options?: CreateBatchRequestOptions): Promise<CreateBatchResponse>;
-    create(payload: CreateBatchOptions, options?: CreateBatchRequestOptions): Promise<CreateBatchResponse>;
-}
+} & (Options['batchValidation'] extends 'permissive' ? {
+    /**
+     * Only present when header "x-batch-validation" is set to 'permissive'.
+     */
+    errors: {
+        /**
+         * The index of the failed email in the batch
+         */
+        index: number;
+        /**
+         * The error message for the failed email
+         */
+        message: string;
+    }[];
+} : Record<string, never>);
+type CreateBatchResponse<Options extends CreateBatchRequestOptions> = {
+    data: CreateBatchSuccessResponse<Options>;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface EmailRenderOptions {
     /**
@@ -307,7 +346,7 @@ interface EmailRenderOptions {
      *
      * @link https://resend.com/docs/api-reference/broadcasts/create#body-parameters
      */
-    react: React.ReactNode;
+    react: React$1.ReactNode;
     /**
      * The HTML version of the message.
      *
@@ -366,38 +405,13 @@ interface CreateBroadcastResponseSuccess {
     /** The ID of the newly sent broadcasts. */
     id: string;
 }
-type CreateBroadcastResponse = Response<CreateBroadcastResponseSuccess>;
-
-interface Broadcast {
-    id: string;
-    name: string;
-    audience_id: string | null;
-    from: string | null;
-    subject: string | null;
-    reply_to: string[] | null;
-    preview_text: string | null;
-    status: 'draft' | 'sent' | 'queued';
-    created_at: string;
-    scheduled_at: string | null;
-    sent_at: string | null;
-}
-
-interface GetBroadcastResponseSuccess extends Broadcast {
-    object: 'broadcast';
-}
-type GetBroadcastResponse = Response<GetBroadcastResponseSuccess>;
-
-type ListBroadcastsResponseSuccess = {
-    object: 'list';
-    data: Pick<Broadcast, 'id' | 'name' | 'audience_id' | 'status' | 'created_at' | 'scheduled_at' | 'sent_at'>[];
+type CreateBroadcastResponse = {
+    data: CreateBroadcastResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
 };
-type ListBroadcastsResponse = Response<ListBroadcastsResponseSuccess>;
-
-interface RemoveBroadcastResponseSuccess extends Pick<Broadcast, 'id'> {
-    object: 'broadcast';
-    deleted: boolean;
-}
-type RemoveBroadcastResponse = Response<RemoveBroadcastResponseSuccess>;
 
 interface SendBroadcastBaseOptions {
     /**
@@ -416,40 +430,13 @@ interface SendBroadcastResponseSuccess {
     /** The ID of the sent broadcast. */
     id: string;
 }
-type SendBroadcastResponse = Response<SendBroadcastResponseSuccess>;
-
-interface UpdateBroadcastResponseSuccess {
-    id: string;
-}
-interface UpdateBroadcastOptions {
-    name?: string;
-    audienceId?: string;
-    from?: string;
-    html?: string;
-    text?: string;
-    subject?: string;
-    replyTo?: string[];
-    previewText?: string;
-}
-type UpdateBroadcastResponse = Response<UpdateBroadcastResponseSuccess>;
-
-declare class Broadcasts {
-    private readonly resend;
-    private renderAsync?;
-    constructor(resend: Resend);
-    create(payload: CreateBroadcastOptions, options?: CreateBroadcastRequestOptions): Promise<SendBroadcastResponse>;
-    send(id: string, payload?: SendBroadcastOptions): Promise<SendBroadcastResponse>;
-    list(): Promise<ListBroadcastsResponse>;
-    get(id: string): Promise<GetBroadcastResponse>;
-    remove(id: string): Promise<RemoveBroadcastResponse>;
-    update(id: string, payload: UpdateBroadcastOptions): Promise<UpdateBroadcastResponse>;
-}
-
-interface PatchOptions {
-    query?: {
-        [key: string]: unknown;
-    };
-}
+type SendBroadcastResponse = {
+    data: SendBroadcastResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface Contact {
     created_at: string;
@@ -499,7 +486,13 @@ interface CreateContactRequestOptions extends PostOptions {
 interface CreateContactResponseSuccess extends Pick<Contact, 'id'> {
     object: 'contact';
 }
-type CreateContactResponse = Response<CreateContactResponseSuccess>;
+type CreateContactResponse = {
+    data: CreateContactResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 type GetContactOptions = {
     audienceId: string;
@@ -507,16 +500,29 @@ type GetContactOptions = {
 interface GetContactResponseSuccess extends Pick<Contact, 'id' | 'email' | 'created_at' | 'first_name' | 'last_name' | 'unsubscribed'> {
     object: 'contact';
 }
-type GetContactResponse = Response<GetContactResponseSuccess>;
+type GetContactResponse = {
+    data: GetContactResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
-interface ListContactsOptions {
+type ListContactsOptions = {
     audienceId: string;
-}
+} & PaginationOptions;
 interface ListContactsResponseSuccess {
     object: 'list';
     data: Contact[];
+    has_more: boolean;
 }
-type ListContactsResponse = Response<ListContactsResponseSuccess>;
+type ListContactsResponse = {
+    data: ListContactsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 type RemoveContactsResponseSuccess = {
     object: 'contact';
@@ -526,7 +532,13 @@ type RemoveContactsResponseSuccess = {
 type RemoveContactOptions = SelectingField & {
     audienceId: string;
 };
-type RemoveContactsResponse = Response<RemoveContactsResponseSuccess>;
+type RemoveContactsResponse = {
+    data: RemoveContactsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 type UpdateContactOptions = {
     audienceId: string;
@@ -537,17 +549,13 @@ type UpdateContactOptions = {
 type UpdateContactResponseSuccess = Pick<Contact, 'id'> & {
     object: 'contact';
 };
-type UpdateContactResponse = Response<UpdateContactResponseSuccess>;
-
-declare class Contacts {
-    private readonly resend;
-    constructor(resend: Resend);
-    create(payload: CreateContactOptions, options?: CreateContactRequestOptions): Promise<CreateContactResponse>;
-    list(options: ListContactsOptions): Promise<ListContactsResponse>;
-    get(options: GetContactOptions): Promise<GetContactResponse>;
-    update(options: UpdateContactOptions): Promise<UpdateContactResponse>;
-    remove(payload: RemoveContactOptions): Promise<RemoveContactsResponse>;
-}
+type UpdateContactResponse = {
+    data: UpdateContactResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 type DomainRegion = 'us-east-1' | 'eu-west-1' | 'sa-east-1' | 'ap-northeast-1';
 type DomainStatus = 'pending' | 'verified' | 'failed' | 'temporary_failure' | 'not_started';
@@ -592,24 +600,51 @@ interface CreateDomainRequestOptions extends PostOptions {
 interface CreateDomainResponseSuccess extends Pick<Domain, 'name' | 'id' | 'status' | 'created_at' | 'region'> {
     records: DomainRecords[];
 }
-type CreateDomainResponse = Response<CreateDomainResponseSuccess>;
+type CreateDomainResponse = {
+    data: CreateDomainResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface GetDomainResponseSuccess extends Pick<Domain, 'id' | 'name' | 'created_at' | 'region' | 'status'> {
     object: 'domain';
     records: DomainRecords[];
 }
-type GetDomainResponse = Response<GetDomainResponseSuccess>;
+type GetDomainResponse = {
+    data: GetDomainResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
+type ListDomainsOptions = PaginationOptions;
 type ListDomainsResponseSuccess = {
     data: Domain[];
+    object: 'list';
+    has_more: boolean;
+};
+type ListDomainsResponse = {
+    data: ListDomainsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
 };
-type ListDomainsResponse = Response<ListDomainsResponseSuccess>;
 
 type RemoveDomainsResponseSuccess = Pick<Domain, 'id'> & {
     object: 'domain';
     deleted: boolean;
 };
-type RemoveDomainsResponse = Response<RemoveDomainsResponseSuccess>;
+type RemoveDomainsResponse = {
+    data: RemoveDomainsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface UpdateDomainsOptions {
     id: string;
@@ -620,29 +655,24 @@ interface UpdateDomainsOptions {
 type UpdateDomainsResponseSuccess = Pick<Domain, 'id'> & {
     object: 'domain';
 };
-type UpdateDomainsResponse = Response<UpdateDomainsResponseSuccess>;
+type UpdateDomainsResponse = {
+    data: UpdateDomainsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 type VerifyDomainsResponseSuccess = Pick<Domain, 'id'> & {
     object: 'domain';
 };
-type VerifyDomainsResponse = Response<VerifyDomainsResponseSuccess>;
-
-declare class Domains {
-    private readonly resend;
-    constructor(resend: Resend);
-    create(payload: CreateDomainOptions, options?: CreateDomainRequestOptions): Promise<CreateDomainResponse>;
-    list(): Promise<ListDomainsResponse>;
-    get(id: string): Promise<GetDomainResponse>;
-    update(payload: UpdateDomainsOptions): Promise<UpdateDomainsResponse>;
-    remove(id: string): Promise<RemoveDomainsResponse>;
-    verify(id: string): Promise<VerifyDomainsResponse>;
-}
-
-interface CancelEmailResponseSuccess {
-    object: 'email';
-    id: string;
-}
-type CancelEmailResponse = Response<CancelEmailResponseSuccess>;
+type VerifyDomainsResponse = {
+    data: VerifyDomainsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface GetEmailResponseSuccess {
     bcc: string[] | null;
@@ -663,7 +693,176 @@ interface GetEmailResponseSuccess {
     scheduled_at: string | null;
     object: 'email';
 }
-type GetEmailResponse = Response<GetEmailResponseSuccess>;
+type GetEmailResponse = {
+    data: GetEmailResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+declare class ApiKeys {
+    private readonly resend;
+    constructor(resend: Resend);
+    create(payload: CreateApiKeyOptions, options?: CreateApiKeyRequestOptions): Promise<CreateApiKeyResponse>;
+    list(options?: ListApiKeysOptions): Promise<ListApiKeysResponse>;
+    remove(id: string): Promise<RemoveApiKeyResponse>;
+}
+
+declare class Audiences {
+    private readonly resend;
+    constructor(resend: Resend);
+    create(payload: CreateAudienceOptions, options?: CreateAudienceRequestOptions): Promise<CreateAudienceResponse>;
+    list(options?: ListAudiencesOptions): Promise<ListAudiencesResponse>;
+    get(id: string): Promise<GetAudienceResponse>;
+    remove(id: string): Promise<RemoveAudiencesResponse>;
+}
+
+declare class Batch {
+    private readonly resend;
+    constructor(resend: Resend);
+    send<Options extends CreateBatchRequestOptions>(payload: CreateBatchOptions, options?: Options): Promise<CreateBatchResponse<Options>>;
+    create<Options extends CreateBatchRequestOptions>(payload: CreateBatchOptions, options?: Options): Promise<CreateBatchResponse<Options>>;
+}
+
+interface Broadcast {
+    id: string;
+    name: string;
+    audience_id: string | null;
+    from: string | null;
+    subject: string | null;
+    reply_to: string[] | null;
+    preview_text: string | null;
+    status: 'draft' | 'sent' | 'queued';
+    created_at: string;
+    scheduled_at: string | null;
+    sent_at: string | null;
+}
+
+interface GetBroadcastResponseSuccess extends Broadcast {
+    object: 'broadcast';
+}
+type GetBroadcastResponse = {
+    data: GetBroadcastResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+type ListBroadcastsOptions = PaginationOptions;
+type ListBroadcastsResponseSuccess = {
+    object: 'list';
+    has_more: boolean;
+    data: Pick<Broadcast, 'id' | 'name' | 'audience_id' | 'status' | 'created_at' | 'scheduled_at' | 'sent_at'>[];
+};
+type ListBroadcastsResponse = {
+    data: ListBroadcastsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface RemoveBroadcastResponseSuccess extends Pick<Broadcast, 'id'> {
+    object: 'broadcast';
+    deleted: boolean;
+}
+type RemoveBroadcastResponse = {
+    data: RemoveBroadcastResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface UpdateBroadcastResponseSuccess {
+    id: string;
+}
+type UpdateBroadcastOptions = {
+    name?: string;
+    audienceId?: string;
+    from?: string;
+    html?: string;
+    react?: React.ReactNode;
+    text?: string;
+    subject?: string;
+    replyTo?: string[];
+    previewText?: string;
+};
+type UpdateBroadcastResponse = {
+    data: UpdateBroadcastResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+declare class Broadcasts {
+    private readonly resend;
+    constructor(resend: Resend);
+    create(payload: CreateBroadcastOptions, options?: CreateBroadcastRequestOptions): Promise<SendBroadcastResponse>;
+    send(id: string, payload?: SendBroadcastOptions): Promise<SendBroadcastResponse>;
+    list(options?: ListBroadcastsOptions): Promise<ListBroadcastsResponse>;
+    get(id: string): Promise<GetBroadcastResponse>;
+    remove(id: string): Promise<RemoveBroadcastResponse>;
+    update(id: string, payload: UpdateBroadcastOptions): Promise<UpdateBroadcastResponse>;
+}
+
+interface PatchOptions {
+    query?: {
+        [key: string]: unknown;
+    };
+    headers?: HeadersInit;
+}
+
+declare class Contacts {
+    private readonly resend;
+    constructor(resend: Resend);
+    create(payload: CreateContactOptions, options?: CreateContactRequestOptions): Promise<CreateContactResponse>;
+    list(options: ListContactsOptions): Promise<ListContactsResponse>;
+    get(options: GetContactOptions): Promise<GetContactResponse>;
+    update(options: UpdateContactOptions): Promise<UpdateContactResponse>;
+    remove(payload: RemoveContactOptions): Promise<RemoveContactsResponse>;
+}
+
+declare class Domains {
+    private readonly resend;
+    constructor(resend: Resend);
+    create(payload: CreateDomainOptions, options?: CreateDomainRequestOptions): Promise<CreateDomainResponse>;
+    list(options?: ListDomainsOptions): Promise<ListDomainsResponse>;
+    get(id: string): Promise<GetDomainResponse>;
+    update(payload: UpdateDomainsOptions): Promise<UpdateDomainsResponse>;
+    remove(id: string): Promise<RemoveDomainsResponse>;
+    verify(id: string): Promise<VerifyDomainsResponse>;
+}
+
+interface CancelEmailResponseSuccess {
+    object: 'email';
+    id: string;
+}
+type CancelEmailResponse = {
+    data: CancelEmailResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+type ListEmailsOptions = PaginationOptions;
+type ListEmail = Omit<GetEmailResponseSuccess, 'html' | 'text' | 'tags' | 'object'>;
+type ListEmailsResponseSuccess = {
+    object: 'list';
+    has_more: boolean;
+    data: ListEmail[];
+};
+type ListEmailsResponse = {
+    data: ListEmailsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface UpdateEmailOptions {
     id: string;
@@ -673,15 +872,21 @@ interface UpdateEmailResponseSuccess {
     id: string;
     object: 'email';
 }
-type UpdateEmailResponse = Response<UpdateEmailResponseSuccess>;
+type UpdateEmailResponse = {
+    data: UpdateEmailResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 declare class Emails {
     private readonly resend;
-    private renderAsync?;
     constructor(resend: Resend);
     send(payload: CreateEmailOptions, options?: CreateEmailRequestOptions): Promise<CreateEmailResponse>;
     create(payload: CreateEmailOptions, options?: CreateEmailRequestOptions): Promise<CreateEmailResponse>;
     get(id: string): Promise<GetEmailResponse>;
+    list(options?: ListEmailsOptions): Promise<ListEmailsResponse>;
     update(payload: UpdateEmailOptions): Promise<UpdateEmailResponse>;
     cancel(id: string): Promise<CancelEmailResponse>;
 }
@@ -697,12 +902,48 @@ declare class Resend {
     readonly domains: Domains;
     readonly emails: Emails;
     constructor(key?: string | undefined);
-    fetchRequest<T>(path: string, options?: {}): Promise<Response<T>>;
-    post<T>(path: string, entity?: unknown, options?: PostOptions & IdempotentRequest): Promise<Response<T>>;
-    get<T>(path: string, options?: GetOptions): Promise<Response<T>>;
-    put<T>(path: string, entity: unknown, options?: PutOptions): Promise<Response<T>>;
-    patch<T>(path: string, entity: unknown, options?: PatchOptions): Promise<Response<T>>;
-    delete<T>(path: string, query?: unknown): Promise<Response<T>>;
-}
-
-export { Attachment, CreateApiKeyOptions, CreateApiKeyRequestOptions, CreateApiKeyResponse, CreateApiKeyResponseSuccess, CreateAudienceOptions, CreateAudienceRequestOptions, CreateAudienceResponse, CreateAudienceResponseSuccess, CreateBatchOptions, CreateBatchRequestOptions, CreateBatchResponse, CreateBatchSuccessResponse, CreateBroadcastOptions, CreateBroadcastRequestOptions, CreateBroadcastResponse, CreateBroadcastResponseSuccess, CreateContactOptions, CreateContactRequestOptions, CreateContactResponse, CreateContactResponseSuccess, CreateDomainOptions, CreateDomainRequestOptions, CreateDomainResponse, CreateDomainResponseSuccess, CreateEmailOptions, CreateEmailRequestOptions, CreateEmailResponse, CreateEmailResponseSuccess, ErrorResponse, GetAudienceResponse, GetAudienceResponseSuccess, GetContactOptions, GetContactResponse, GetContactResponseSuccess, GetDomainResponse, GetDomainResponseSuccess, GetEmailResponse, GetEmailResponseSuccess, ListApiKeysResponse, ListApiKeysResponseSuccess, ListAudiencesResponse, ListAudiencesResponseSuccess, ListContactsOptions, ListContactsResponse, ListContactsResponseSuccess, ListDomainsResponse, ListDomainsResponseSuccess, RemoveApiKeyResponse, RemoveApiKeyResponseSuccess, RemoveAudiencesResponse, RemoveAudiencesResponseSuccess, RemoveContactOptions, RemoveContactsResponse, RemoveContactsResponseSuccess, RemoveDomainsResponse, RemoveDomainsResponseSuccess, Resend, SendBroadcastOptions, SendBroadcastRequestOptions, SendBroadcastResponse, SendBroadcastResponseSuccess, Tag, UpdateContactOptions, UpdateContactResponse, UpdateContactResponseSuccess, UpdateDomainsOptions, UpdateDomainsResponse, UpdateDomainsResponseSuccess, VerifyDomainsResponse, VerifyDomainsResponseSuccess };
+    fetchRequest<T>(path: string, options?: {}): Promise<{
+        data: T;
+        error: null;
+    } | {
+        data: null;
+        error: ErrorResponse;
+    }>;
+    post<T>(path: string, entity?: unknown, options?: PostOptions & IdempotentRequest): Promise<{
+        data: null;
+        error: ErrorResponse;
+    } | {
+        data: T;
+        error: null;
+    }>;
+    get<T>(path: string, options?: GetOptions): Promise<{
+        data: null;
+        error: ErrorResponse;
+    } | {
+        data: T;
+        error: null;
+    }>;
+    put<T>(path: string, entity: unknown, options?: PutOptions): Promise<{
+        data: null;
+        error: ErrorResponse;
+    } | {
+        data: T;
+        error: null;
+    }>;
+    patch<T>(path: string, entity: unknown, options?: PatchOptions): Promise<{
+        data: null;
+        error: ErrorResponse;
+    } | {
+        data: T;
+        error: null;
+    }>;
+    delete<T>(path: string, query?: unknown): Promise<{
+        data: null;
+        error: ErrorResponse;
+    } | {
+        data: T;
+        error: null;
+    }>;
+}
+
+export { type Attachment, type CreateApiKeyOptions, type CreateApiKeyRequestOptions, type CreateApiKeyResponse, type CreateApiKeyResponseSuccess, type CreateAudienceOptions, type CreateAudienceRequestOptions, type CreateAudienceResponse, type CreateAudienceResponseSuccess, type CreateBatchOptions, type CreateBatchRequestOptions, type CreateBatchResponse, type CreateBatchSuccessResponse, type CreateBroadcastOptions, type CreateBroadcastRequestOptions, type CreateBroadcastResponse, type CreateBroadcastResponseSuccess, type CreateContactOptions, type CreateContactRequestOptions, type CreateContactResponse, type CreateContactResponseSuccess, type CreateDomainOptions, type CreateDomainRequestOptions, type CreateDomainResponse, type CreateDomainResponseSuccess, type CreateEmailOptions, type CreateEmailRequestOptions, type CreateEmailResponse, type CreateEmailResponseSuccess, type ErrorResponse, type GetAudienceResponse, type GetAudienceResponseSuccess, type GetContactOptions, type GetContactResponse, type GetContactResponseSuccess, type GetDomainResponse, type GetDomainResponseSuccess, type GetEmailResponse, type GetEmailResponseSuccess, type ListApiKeysOptions, type ListApiKeysResponse, type ListApiKeysResponseSuccess, type ListAudiencesOptions, type ListAudiencesResponse, type ListAudiencesResponseSuccess, type ListContactsOptions, type ListContactsResponse, type ListContactsResponseSuccess, type ListDomainsOptions, type ListDomainsResponse, type ListDomainsResponseSuccess, type PaginationOptions, type RemoveApiKeyResponse, type RemoveApiKeyResponseSuccess, type RemoveAudiencesResponse, type RemoveAudiencesResponseSuccess, type RemoveContactOptions, type RemoveContactsResponse, type RemoveContactsResponseSuccess, type RemoveDomainsResponse, type RemoveDomainsResponseSuccess, Resend, type SendBroadcastOptions, type SendBroadcastRequestOptions, type SendBroadcastResponse, type SendBroadcastResponseSuccess, type Tag, type UpdateContactOptions, type UpdateContactResponse, type UpdateContactResponseSuccess, type UpdateDomainsOptions, type UpdateDomainsResponse, type UpdateDomainsResponseSuccess, type VerifyDomainsResponse, type VerifyDomainsResponseSuccess };