resend 6.1.0-canary.1 → 6.1.1

package/dist/index.d.mts

@@ -1,42 +1,17 @@
 import * as React$1 from 'react';
 
-interface GetOptions {
-    query?: Record<string, unknown>;
-}
-
-interface PostOptions {
-    query?: {
-        [key: string]: unknown;
-    };
+interface ApiKey {
+    created_at: string;
+    id: string;
+    name: string;
 }
 
-interface PutOptions {
-    query?: {
-        [key: string]: unknown;
-    };
+interface DomainApiOptions {
+    name: string;
+    region?: string;
+    custom_return_path?: string;
 }
 
-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 +22,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 +31,100 @@ 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'>;
+    name: RESEND_ERROR_CODE_KEY;
+}
+type Tag$1 = {
+    name: string;
+    value: string;
+};
+
+interface EmailApiAttachment {
+    content?: string | Buffer;
+    filename?: string | false | undefined;
+    path?: string;
+    content_type?: string;
+    content_id?: string;
+}
+interface EmailApiOptions {
+    from: string;
+    to: string | string[];
+    subject: string;
+    region?: string;
+    headers?: Record<string, string>;
+    html?: string;
+    text?: string;
+    bcc?: string | string[];
+    cc?: string | string[];
+    reply_to?: string | string[];
+    scheduled_at?: string;
+    tags?: Tag$1[];
+    attachments?: EmailApiAttachment[];
+}
+
+interface GetOptions {
+    query?: Record<string, unknown>;
+    headers?: HeadersInit;
+}
+
+interface IdempotentRequest {
     /**
-     * Time in seconds.
+     * Unique key that ensures the same operation is not processed multiple times.
+     * Allows for safe retries without duplicating operations.
+     * If provided, will be sent as the `Idempotency-Key` header.
      */
-    retryAfter: number;
-};
-type Response<Data> = {
-    data: Data;
-    rateLimiting: RateLimit;
-    error: null;
+    idempotencyKey?: string;
+}
+
+interface List<T> {
+    readonly object: 'list';
+    data: T[];
+}
+
+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;
 } | {
-    data: null;
-    rateLimiting: RateLimit | null;
-    error: ErrorResponse;
-};
+    /**
+     * Get items before this cursor (cannot be used with 'after')
+     */
+    before?: string;
+    after?: never;
+});
+
+interface PatchOptions {
+    query?: {
+        [key: string]: unknown;
+    };
+    headers?: HeadersInit;
+}
+
+interface PostOptions {
+    query?: {
+        [key: string]: unknown;
+    };
+    headers?: HeadersInit;
+}
+
+interface PutOptions {
+    query?: {
+        [key: string]: unknown;
+    };
+    headers?: HeadersInit;
+}
+
+type RequireAtLeastOne<T> = {
+    [K in keyof T]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<keyof T, K>>>;
+}[keyof T];
 
 interface CreateApiKeyOptions {
     name: string;
@@ -88,19 +137,36 @@ interface CreateApiKeyResponseSuccess {
     token: string;
     id: string;
 }
-type CreateApiKeyResponse = Response<CreateApiKeyResponseSuccess>;
-
-interface ApiKey {
-    created_at: string;
-    id: string;
-    name: string;
-}
+type CreateApiKeyResponse = {
+    data: CreateApiKeyResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
-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>;
+type RemoveApiKeyResponse = {
+    data: RemoveApiKeyResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface Audience {
     created_at: string;
@@ -116,37 +182,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>;
-
-interface IdempotentRequest {
-    /**
-     * Unique key that ensures the same operation is not processed multiple times.
-     * Allows for safe retries without duplicating operations.
-     * If provided, will be sent as the `Idempotency-Key` header.
-     */
-    idempotencyKey?: string;
-}
-
-type RequireAtLeastOne<T> = {
-    [K in keyof T]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<keyof T, K>>>;
-}[keyof T];
+type RemoveAudiencesResponse = {
+    data: RemoveAudiencesResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface EmailRenderOptions$1 {
     /**
@@ -238,7 +317,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;
@@ -267,14 +352,52 @@ 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;
     }[];
+} & (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 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;
 }
-type CreateBatchResponse = Response<CreateBatchSuccessResponse>;
 
 interface EmailRenderOptions {
     /**
@@ -341,7 +464,50 @@ interface CreateBroadcastResponseSuccess {
     /** The ID of the newly sent broadcasts. */
     id: string;
 }
-type CreateBroadcastResponse = Response<CreateBroadcastResponseSuccess>;
+type CreateBroadcastResponse = {
+    data: CreateBroadcastResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+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 SendBroadcastBaseOptions {
     /**
@@ -360,7 +526,35 @@ interface SendBroadcastResponseSuccess {
     /** The ID of the sent broadcast. */
     id: string;
 }
-type SendBroadcastResponse = Response<SendBroadcastResponseSuccess>;
+type SendBroadcastResponse = {
+    data: SendBroadcastResponseSuccess;
+    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;
+};
 
 interface Contact {
     created_at: string;
@@ -410,7 +604,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;
@@ -418,16 +618,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';
@@ -437,7 +650,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;
@@ -448,9 +667,16 @@ type UpdateContactOptions = {
 type UpdateContactResponseSuccess = Pick<Contact, 'id'> & {
     object: 'contact';
 };
-type UpdateContactResponse = Response<UpdateContactResponseSuccess>;
+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 DomainNameservers = 'Amazon Route 53' | 'Cloudflare' | 'Digital Ocean' | 'GoDaddy' | 'Google Domains' | 'Namecheap' | 'Unidentified' | 'Vercel';
 type DomainStatus = 'pending' | 'verified' | 'failed' | 'temporary_failure' | 'not_started';
 type DomainRecords = DomainSpfRecord | DomainDkimRecord;
 interface DomainSpfRecord {
@@ -493,24 +719,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;
@@ -521,12 +774,36 @@ 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>;
+type VerifyDomainsResponse = {
+    data: VerifyDomainsResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface CancelEmailResponseSuccess {
+    object: 'email';
+    id: string;
+}
+type CancelEmailResponse = {
+    data: CancelEmailResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 interface GetEmailResponseSuccess {
     bcc: string[] | null;
@@ -547,13 +824,35 @@ interface GetEmailResponseSuccess {
     scheduled_at: string | null;
     object: 'email';
 }
-type GetEmailResponse = Response<GetEmailResponseSuccess>;
+type GetEmailResponse = {
+    data: GetEmailResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface UpdateEmailOptions {
+    id: string;
+    scheduledAt: string;
+}
+interface UpdateEmailResponseSuccess {
+    id: string;
+    object: 'email';
+}
+type UpdateEmailResponse = {
+    data: UpdateEmailResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
 
 declare class ApiKeys {
     private readonly resend;
     constructor(resend: Resend);
     create(payload: CreateApiKeyOptions, options?: CreateApiKeyRequestOptions): Promise<CreateApiKeyResponse>;
-    list(): Promise<ListApiKeysResponse>;
+    list(options?: ListApiKeysOptions): Promise<ListApiKeysResponse>;
     remove(id: string): Promise<RemoveApiKeyResponse>;
 }
 
@@ -561,84 +860,29 @@ declare class Audiences {
     private readonly resend;
     constructor(resend: Resend);
     create(payload: CreateAudienceOptions, options?: CreateAudienceRequestOptions): Promise<CreateAudienceResponse>;
-    list(): Promise<ListAudiencesResponse>;
+    list(options?: ListAudiencesOptions): Promise<ListAudiencesResponse>;
     get(id: string): Promise<GetAudienceResponse>;
     remove(id: string): Promise<RemoveAudiencesResponse>;
 }
 
 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>;
-}
-
-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 ListBroadcastsResponse = Response<ListBroadcastsResponseSuccess>;
-
-interface RemoveBroadcastResponseSuccess extends Pick<Broadcast, 'id'> {
-    object: 'broadcast';
-    deleted: boolean;
+    send<Options extends CreateBatchRequestOptions>(payload: CreateBatchOptions, options?: Options): Promise<CreateBatchResponse<Options>>;
+    create<Options extends CreateBatchRequestOptions>(payload: CreateBatchOptions, options?: Options): Promise<CreateBatchResponse<Options>>;
 }
-type RemoveBroadcastResponse = Response<RemoveBroadcastResponseSuccess>;
-
-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 = 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>;
+    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;
-    };
-}
-
 declare class Contacts {
     private readonly resend;
     constructor(resend: Resend);
@@ -653,36 +897,35 @@ declare class Domains {
     private readonly resend;
     constructor(resend: Resend);
     create(payload: CreateDomainOptions, options?: CreateDomainRequestOptions): Promise<CreateDomainResponse>;
-    list(): Promise<ListDomainsResponse>;
+    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 = Response<CancelEmailResponseSuccess>;
-
-interface UpdateEmailOptions {
-    id: string;
-    scheduledAt: string;
-}
-interface UpdateEmailResponseSuccess {
-    id: string;
-    object: 'email';
-}
-type UpdateEmailResponse = Response<UpdateEmailResponseSuccess>;
+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;
+};
 
 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>;
 }
@@ -698,12 +941,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 { 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 ListApiKeysResponse, type ListApiKeysResponseSuccess, type ListAudiencesResponse, type ListAudiencesResponseSuccess, type ListContactsOptions, type ListContactsResponse, type ListContactsResponseSuccess, type ListDomainsResponse, type ListDomainsResponseSuccess, 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 };
+    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 ApiKey, type Attachment, type Audience, type Broadcast, type CancelEmailResponse, type CancelEmailResponseSuccess, type Contact, 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 Domain, type DomainApiOptions, type DomainDkimRecord, type DomainNameservers, type DomainRecords, type DomainRegion, type DomainSpfRecord, type DomainStatus, type EmailApiAttachment, type EmailApiOptions, type ErrorResponse, type GetAudienceResponse, type GetAudienceResponseSuccess, type GetBroadcastResponse, type GetBroadcastResponseSuccess, type GetContactOptions, type GetContactResponse, type GetContactResponseSuccess, type GetDomainResponse, type GetDomainResponseSuccess, type GetEmailResponse, type GetEmailResponseSuccess, type GetOptions, type IdempotentRequest, type List, type ListApiKeysOptions, type ListApiKeysResponse, type ListApiKeysResponseSuccess, type ListAudiencesOptions, type ListAudiencesResponse, type ListAudiencesResponseSuccess, type ListBroadcastsOptions, type ListBroadcastsResponse, type ListBroadcastsResponseSuccess, type ListContactsOptions, type ListContactsResponse, type ListContactsResponseSuccess, type ListDomainsOptions, type ListDomainsResponse, type ListDomainsResponseSuccess, type PaginationOptions, type PatchOptions, type PostOptions, type PutOptions, type RemoveApiKeyResponse, type RemoveApiKeyResponseSuccess, type RemoveAudiencesResponse, type RemoveAudiencesResponseSuccess, type RemoveBroadcastResponse, type RemoveBroadcastResponseSuccess, type RemoveContactOptions, type RemoveContactsResponse, type RemoveContactsResponseSuccess, type RemoveDomainsResponse, type RemoveDomainsResponseSuccess, type RequireAtLeastOne, Resend, type SelectingField, type SendBroadcastOptions, type SendBroadcastRequestOptions, type SendBroadcastResponse, type SendBroadcastResponseSuccess, type Tag, type UpdateBroadcastOptions, type UpdateBroadcastResponse, type UpdateBroadcastResponseSuccess, type UpdateContactOptions, type UpdateContactResponse, type UpdateContactResponseSuccess, type UpdateDomainsOptions, type UpdateDomainsResponse, type UpdateDomainsResponseSuccess, type UpdateEmailOptions, type UpdateEmailResponse, type UpdateEmailResponseSuccess, type VerifyDomainsResponse, type VerifyDomainsResponseSuccess };