resend 6.1.1 → 6.1.2-preview-templates.0

package/dist/index.d.mts

@@ -48,9 +48,9 @@ interface EmailApiAttachment {
     content_id?: string;
 }
 interface EmailApiOptions {
-    from: string;
+    from?: string;
     to: string | string[];
-    subject: string;
+    subject?: string;
     region?: string;
     headers?: Record<string, string>;
     html?: string;
@@ -61,6 +61,10 @@ interface EmailApiOptions {
     scheduled_at?: string;
     tags?: Tag$1[];
     attachments?: EmailApiAttachment[];
+    template?: {
+        id: string;
+        variables?: Record<string, string | number | boolean>;
+    };
 }
 
 interface GetOptions {
@@ -77,11 +81,6 @@ interface IdempotentRequest {
     idempotencyKey?: string;
 }
 
-interface List<T> {
-    readonly object: 'list';
-    data: T[];
-}
-
 type PaginationOptions = {
     /**
      * Maximum number of items to return (1-100, default: 20)
@@ -247,6 +246,16 @@ interface EmailRenderOptions$1 {
      */
     text: string;
 }
+interface EmailTemplateOptions {
+    template: {
+        id: string;
+        variables?: Record<string, string | number | boolean>;
+    };
+}
+interface CreateEmailBaseOptionsWithTemplate extends Omit<CreateEmailBaseOptions, 'from' | 'subject'> {
+    from?: string;
+    subject?: string;
+}
 interface CreateEmailBaseOptions {
     /**
      * Filename and content of attachments (max 40mb per email)
@@ -310,7 +319,13 @@ interface CreateEmailBaseOptions {
      */
     scheduledAt?: string;
 }
-type CreateEmailOptions = RequireAtLeastOne<EmailRenderOptions$1> & CreateEmailBaseOptions;
+type CreateEmailOptions = ((RequireAtLeastOne<EmailRenderOptions$1> & CreateEmailBaseOptions) & {
+    template?: never;
+}) | ((EmailTemplateOptions & CreateEmailBaseOptionsWithTemplate) & {
+    react?: never;
+    html?: never;
+    text?: never;
+});
 interface CreateEmailRequestOptions extends PostOptions, IdempotentRequest {
 }
 interface CreateEmailResponseSuccess {
@@ -930,6 +945,180 @@ declare class Emails {
     cancel(id: string): Promise<CancelEmailResponse>;
 }
 
+interface Template {
+    id: string;
+    name: string;
+    subject: string | null;
+    html: string;
+    text: string | null;
+    status: 'draft' | 'published';
+    variables: TemplateVariable[] | null;
+    alias: string | null;
+    from: string | null;
+    reply_to: string[] | null;
+    published_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+type TemplateVariableListFallbackType = string[] | number[] | boolean[] | Record<string, unknown>[];
+interface TemplateVariable {
+    key: string;
+    fallback_value: string | number | boolean | Record<string, unknown> | TemplateVariableListFallbackType | null;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'list';
+    created_at: string;
+    updated_at: string;
+}
+
+type TemplateContentCreationOptions = RequireAtLeastOne<{
+    html: string;
+    react: React.ReactNode;
+}>;
+type TemplateVariableCreationOptions = Pick<TemplateVariable, 'key' | 'type'> & ({
+    type: 'string';
+    fallbackValue?: string | null;
+} | {
+    type: 'number';
+    fallbackValue?: number | null;
+} | {
+    type: 'boolean';
+    fallbackValue?: boolean | null;
+} | {
+    type: 'object';
+    fallbackValue: Record<string, unknown>;
+} | {
+    type: 'list';
+    fallbackValue: TemplateVariableListFallbackType;
+});
+type TemplateOptionalFieldsForCreation = Partial<Pick<Template, 'subject' | 'text' | 'alias' | 'from'>> & {
+    replyTo?: string[] | string;
+    variables?: TemplateVariableCreationOptions[];
+};
+type CreateTemplateOptions = Pick<Template, 'name'> & TemplateOptionalFieldsForCreation & TemplateContentCreationOptions;
+interface CreateTemplateResponseSuccess extends Pick<Template, 'id'> {
+    object: 'template';
+}
+type CreateTemplateResponse = {
+    data: CreateTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface DuplicateTemplateResponseSuccess extends Pick<Template, 'id'> {
+    object: 'template';
+}
+type DuplicateTemplateResponse = {
+    data: DuplicateTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface PublishTemplateResponseSuccess extends Pick<Template, 'id'> {
+    object: 'template';
+}
+type PublishTemplateResponse = {
+    data: PublishTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+declare class ChainableTemplateResult<T extends CreateTemplateResponse | DuplicateTemplateResponse> implements PromiseLike<T> {
+    private readonly promise;
+    private readonly publishFn;
+    constructor(promise: Promise<T>, publishFn: (id: string) => Promise<PublishTemplateResponse>);
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+    publish(): Promise<PublishTemplateResponse>;
+}
+
+interface GetTemplateResponseSuccess extends Template {
+    object: 'template';
+}
+type GetTemplateResponse = {
+    data: GetTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface TemplateListItem extends Pick<Template, 'id' | 'name' | 'created_at' | 'updated_at' | 'status' | 'published_at' | 'alias'> {
+}
+interface ListTemplatesResponseSuccess {
+    object: 'list';
+    data: TemplateListItem[];
+    has_more: boolean;
+}
+type ListTemplatesResponse = {
+    data: ListTemplatesResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface RemoveTemplateResponseSuccess {
+    object: 'template';
+    id: string;
+    deleted: boolean;
+}
+type RemoveTemplateResponse = {
+    data: RemoveTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+type TemplateVariableUpdateOptions = Pick<TemplateVariable, 'key' | 'type'> & ({
+    type: 'string';
+    fallbackValue?: string | null;
+} | {
+    type: 'number';
+    fallbackValue?: number | null;
+} | {
+    type: 'boolean';
+    fallbackValue?: boolean | null;
+} | {
+    type: 'object';
+    fallbackValue: Record<string, unknown>;
+} | {
+    type: 'list';
+    fallbackValue: TemplateVariableListFallbackType;
+});
+interface UpdateTemplateOptions extends Partial<Pick<Template, 'name' | 'subject' | 'html' | 'text' | 'from' | 'alias'>> {
+    variables?: TemplateVariableUpdateOptions[];
+    replyTo?: string[] | string;
+}
+interface UpdateTemplateResponseSuccess extends Pick<Template, 'id'> {
+    object: 'template';
+}
+type UpdateTemplateResponse = {
+    data: UpdateTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+declare class Templates {
+    private readonly resend;
+    private renderAsync?;
+    constructor(resend: Resend);
+    create(payload: CreateTemplateOptions): ChainableTemplateResult<CreateTemplateResponse>;
+    private performCreate;
+    remove(identifier: string): Promise<RemoveTemplateResponse>;
+    get(identifier: string): Promise<GetTemplateResponse>;
+    list(options?: PaginationOptions): Promise<ListTemplatesResponse>;
+    duplicate(identifier: string): ChainableTemplateResult<DuplicateTemplateResponse>;
+    publish(identifier: string): Promise<PublishTemplateResponse>;
+    update(identifier: string, payload: UpdateTemplateOptions): Promise<UpdateTemplateResponse>;
+}
+
 declare class Resend {
     readonly key?: string | undefined;
     private readonly headers;
@@ -940,6 +1129,7 @@ declare class Resend {
     readonly contacts: Contacts;
     readonly domains: Domains;
     readonly emails: Emails;
+    readonly templates: Templates;
     constructor(key?: string | undefined);
     fetchRequest<T>(path: string, options?: {}): Promise<{
         data: T;
@@ -985,4 +1175,4 @@ declare class Resend {
     }>;
 }
 
-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 };
+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 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 };

package/dist/index.d.ts

@@ -48,9 +48,9 @@ interface EmailApiAttachment {
     content_id?: string;
 }
 interface EmailApiOptions {
-    from: string;
+    from?: string;
     to: string | string[];
-    subject: string;
+    subject?: string;
     region?: string;
     headers?: Record<string, string>;
     html?: string;
@@ -61,6 +61,10 @@ interface EmailApiOptions {
     scheduled_at?: string;
     tags?: Tag$1[];
     attachments?: EmailApiAttachment[];
+    template?: {
+        id: string;
+        variables?: Record<string, string | number | boolean>;
+    };
 }
 
 interface GetOptions {
@@ -77,11 +81,6 @@ interface IdempotentRequest {
     idempotencyKey?: string;
 }
 
-interface List<T> {
-    readonly object: 'list';
-    data: T[];
-}
-
 type PaginationOptions = {
     /**
      * Maximum number of items to return (1-100, default: 20)
@@ -247,6 +246,16 @@ interface EmailRenderOptions$1 {
      */
     text: string;
 }
+interface EmailTemplateOptions {
+    template: {
+        id: string;
+        variables?: Record<string, string | number | boolean>;
+    };
+}
+interface CreateEmailBaseOptionsWithTemplate extends Omit<CreateEmailBaseOptions, 'from' | 'subject'> {
+    from?: string;
+    subject?: string;
+}
 interface CreateEmailBaseOptions {
     /**
      * Filename and content of attachments (max 40mb per email)
@@ -310,7 +319,13 @@ interface CreateEmailBaseOptions {
      */
     scheduledAt?: string;
 }
-type CreateEmailOptions = RequireAtLeastOne<EmailRenderOptions$1> & CreateEmailBaseOptions;
+type CreateEmailOptions = ((RequireAtLeastOne<EmailRenderOptions$1> & CreateEmailBaseOptions) & {
+    template?: never;
+}) | ((EmailTemplateOptions & CreateEmailBaseOptionsWithTemplate) & {
+    react?: never;
+    html?: never;
+    text?: never;
+});
 interface CreateEmailRequestOptions extends PostOptions, IdempotentRequest {
 }
 interface CreateEmailResponseSuccess {
@@ -930,6 +945,180 @@ declare class Emails {
     cancel(id: string): Promise<CancelEmailResponse>;
 }
 
+interface Template {
+    id: string;
+    name: string;
+    subject: string | null;
+    html: string;
+    text: string | null;
+    status: 'draft' | 'published';
+    variables: TemplateVariable[] | null;
+    alias: string | null;
+    from: string | null;
+    reply_to: string[] | null;
+    published_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+type TemplateVariableListFallbackType = string[] | number[] | boolean[] | Record<string, unknown>[];
+interface TemplateVariable {
+    key: string;
+    fallback_value: string | number | boolean | Record<string, unknown> | TemplateVariableListFallbackType | null;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'list';
+    created_at: string;
+    updated_at: string;
+}
+
+type TemplateContentCreationOptions = RequireAtLeastOne<{
+    html: string;
+    react: React.ReactNode;
+}>;
+type TemplateVariableCreationOptions = Pick<TemplateVariable, 'key' | 'type'> & ({
+    type: 'string';
+    fallbackValue?: string | null;
+} | {
+    type: 'number';
+    fallbackValue?: number | null;
+} | {
+    type: 'boolean';
+    fallbackValue?: boolean | null;
+} | {
+    type: 'object';
+    fallbackValue: Record<string, unknown>;
+} | {
+    type: 'list';
+    fallbackValue: TemplateVariableListFallbackType;
+});
+type TemplateOptionalFieldsForCreation = Partial<Pick<Template, 'subject' | 'text' | 'alias' | 'from'>> & {
+    replyTo?: string[] | string;
+    variables?: TemplateVariableCreationOptions[];
+};
+type CreateTemplateOptions = Pick<Template, 'name'> & TemplateOptionalFieldsForCreation & TemplateContentCreationOptions;
+interface CreateTemplateResponseSuccess extends Pick<Template, 'id'> {
+    object: 'template';
+}
+type CreateTemplateResponse = {
+    data: CreateTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface DuplicateTemplateResponseSuccess extends Pick<Template, 'id'> {
+    object: 'template';
+}
+type DuplicateTemplateResponse = {
+    data: DuplicateTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface PublishTemplateResponseSuccess extends Pick<Template, 'id'> {
+    object: 'template';
+}
+type PublishTemplateResponse = {
+    data: PublishTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+declare class ChainableTemplateResult<T extends CreateTemplateResponse | DuplicateTemplateResponse> implements PromiseLike<T> {
+    private readonly promise;
+    private readonly publishFn;
+    constructor(promise: Promise<T>, publishFn: (id: string) => Promise<PublishTemplateResponse>);
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+    publish(): Promise<PublishTemplateResponse>;
+}
+
+interface GetTemplateResponseSuccess extends Template {
+    object: 'template';
+}
+type GetTemplateResponse = {
+    data: GetTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface TemplateListItem extends Pick<Template, 'id' | 'name' | 'created_at' | 'updated_at' | 'status' | 'published_at' | 'alias'> {
+}
+interface ListTemplatesResponseSuccess {
+    object: 'list';
+    data: TemplateListItem[];
+    has_more: boolean;
+}
+type ListTemplatesResponse = {
+    data: ListTemplatesResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+interface RemoveTemplateResponseSuccess {
+    object: 'template';
+    id: string;
+    deleted: boolean;
+}
+type RemoveTemplateResponse = {
+    data: RemoveTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+type TemplateVariableUpdateOptions = Pick<TemplateVariable, 'key' | 'type'> & ({
+    type: 'string';
+    fallbackValue?: string | null;
+} | {
+    type: 'number';
+    fallbackValue?: number | null;
+} | {
+    type: 'boolean';
+    fallbackValue?: boolean | null;
+} | {
+    type: 'object';
+    fallbackValue: Record<string, unknown>;
+} | {
+    type: 'list';
+    fallbackValue: TemplateVariableListFallbackType;
+});
+interface UpdateTemplateOptions extends Partial<Pick<Template, 'name' | 'subject' | 'html' | 'text' | 'from' | 'alias'>> {
+    variables?: TemplateVariableUpdateOptions[];
+    replyTo?: string[] | string;
+}
+interface UpdateTemplateResponseSuccess extends Pick<Template, 'id'> {
+    object: 'template';
+}
+type UpdateTemplateResponse = {
+    data: UpdateTemplateResponseSuccess;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+
+declare class Templates {
+    private readonly resend;
+    private renderAsync?;
+    constructor(resend: Resend);
+    create(payload: CreateTemplateOptions): ChainableTemplateResult<CreateTemplateResponse>;
+    private performCreate;
+    remove(identifier: string): Promise<RemoveTemplateResponse>;
+    get(identifier: string): Promise<GetTemplateResponse>;
+    list(options?: PaginationOptions): Promise<ListTemplatesResponse>;
+    duplicate(identifier: string): ChainableTemplateResult<DuplicateTemplateResponse>;
+    publish(identifier: string): Promise<PublishTemplateResponse>;
+    update(identifier: string, payload: UpdateTemplateOptions): Promise<UpdateTemplateResponse>;
+}
+
 declare class Resend {
     readonly key?: string | undefined;
     private readonly headers;
@@ -940,6 +1129,7 @@ declare class Resend {
     readonly contacts: Contacts;
     readonly domains: Domains;
     readonly emails: Emails;
+    readonly templates: Templates;
     constructor(key?: string | undefined);
     fetchRequest<T>(path: string, options?: {}): Promise<{
         data: T;
@@ -985,4 +1175,4 @@ declare class Resend {
     }>;
 }
 
-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 };
+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 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 };

package/dist/index.js

@@ -84,7 +84,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // package.json
-var version = "6.1.1";
+var version = "6.1.2-preview-templates.0";
 
 // src/common/utils/build-pagination-query.ts
 function buildPaginationQuery(options) {
@@ -198,7 +198,11 @@ function parseEmailToApiOptions(email) {
     subject: email.subject,
     tags: email.tags,
     text: email.text,
-    to: email.to
+    to: email.to,
+    template: email.template ? {
+      id: email.template.id,
+      variables: email.template.variables
+    } : void 0
   };
 }
 
@@ -210,7 +214,7 @@ function render(node) {
     }).catch(() => {
       reject(
         Error(
-          "Failed to render React component. Make sure to install `@react-email/render`"
+          "Failed to render React component. Make sure to install `@react-email/render` or `@react-email/components`."
         )
       );
     });
@@ -553,6 +557,150 @@ var Emails = class {
   }
 };
 
+// src/common/utils/get-pagination-query-properties.ts
+function getPaginationQueryProperties(options = {}) {
+  const query = new URLSearchParams();
+  if (options.before) query.set("before", options.before);
+  if (options.after) query.set("after", options.after);
+  if (options.limit) query.set("limit", options.limit.toString());
+  return query.size > 0 ? `?${query.toString()}` : "";
+}
+
+// src/common/utils/parse-template-to-api-options.ts
+function parseVariables(variables) {
+  return variables == null ? void 0 : variables.map((variable) => ({
+    key: variable.key,
+    type: variable.type,
+    fallback_value: variable.fallbackValue
+  }));
+}
+function parseTemplateToApiOptions(template) {
+  return {
+    name: "name" in template ? template.name : void 0,
+    subject: template.subject,
+    html: template.html,
+    text: template.text,
+    alias: template.alias,
+    from: template.from,
+    reply_to: template.replyTo,
+    variables: parseVariables(template.variables)
+  };
+}
+
+// src/templates/chainable-template-result.ts
+var ChainableTemplateResult = class {
+  constructor(promise, publishFn) {
+    this.promise = promise;
+    this.publishFn = publishFn;
+  }
+  // If user calls `then` or only awaits for the result of create() or duplicate(), the behavior should be
+  // exactly as if they called create() or duplicate() directly. This will act as a normal promise
+  // biome-ignore lint/suspicious/noThenProperty: This class intentionally implements PromiseLike
+  then(onfulfilled, onrejected) {
+    return this.promise.then(onfulfilled, onrejected);
+  }
+  publish() {
+    return __async(this, null, function* () {
+      const { data, error } = yield this.promise;
+      if (error) {
+        return {
+          data: null,
+          error
+        };
+      }
+      const publishResult = yield this.publishFn(data.id);
+      return publishResult;
+    });
+  }
+};
+
+// src/templates/templates.ts
+var Templates = class {
+  constructor(resend) {
+    this.resend = resend;
+  }
+  create(payload) {
+    const createPromise = this.performCreate(payload);
+    return new ChainableTemplateResult(createPromise, this.publish.bind(this));
+  }
+  // This creation process is being done separately from the public create so that
+  // the user can chain the publish operation after the create operation. Otherwise, due
+  // to the async nature of the renderAsync, the return type would be
+  // Promise<ChainableTemplateResult<CreateTemplateResponse>> which wouldn't be chainable.
+  performCreate(payload) {
+    return __async(this, null, function* () {
+      if (payload.react) {
+        if (!this.renderAsync) {
+          try {
+            const { renderAsync } = yield import("@react-email/render");
+            this.renderAsync = renderAsync;
+          } catch (e) {
+            throw new Error(
+              "Failed to render React component. Make sure to install `@react-email/render`"
+            );
+          }
+        }
+        payload.html = yield this.renderAsync(
+          payload.react
+        );
+      }
+      return this.resend.post(
+        "/templates",
+        parseTemplateToApiOptions(payload)
+      );
+    });
+  }
+  remove(identifier) {
+    return __async(this, null, function* () {
+      const data = yield this.resend.delete(
+        `/templates/${identifier}`
+      );
+      return data;
+    });
+  }
+  get(identifier) {
+    return __async(this, null, function* () {
+      const data = yield this.resend.get(
+        `/templates/${identifier}`
+      );
+      return data;
+    });
+  }
+  list() {
+    return __async(this, arguments, function* (options = {}) {
+      return this.resend.get(
+        `/templates${getPaginationQueryProperties(options)}`
+      );
+    });
+  }
+  duplicate(identifier) {
+    const promiseDuplicate = this.resend.post(
+      `/templates/${identifier}/duplicate`
+    );
+    return new ChainableTemplateResult(
+      promiseDuplicate,
+      this.publish.bind(this)
+    );
+  }
+  publish(identifier) {
+    return __async(this, null, function* () {
+      const data = yield this.resend.post(
+        `/templates/${identifier}/publish`
+      );
+      return data;
+    });
+  }
+  update(identifier, payload) {
+    return __async(this, null, function* () {
+      const data = yield this.resend.patch(
+        `/templates/${identifier}`,
+        parseTemplateToApiOptions(payload)
+      );
+      return data;
+    });
+  }
+};
+
 // src/resend.ts
 var defaultBaseUrl = "https://api.resend.com";
 var defaultUserAgent = `resend-node:${version}`;
@@ -568,6 +716,7 @@ var Resend = class {
     this.contacts = new Contacts(this);
     this.domains = new Domains(this);
     this.emails = new Emails(this);
+    this.templates = new Templates(this);
     if (!key) {
       if (typeof process !== "undefined" && process.env) {
         this.key = process.env.RESEND_API_KEY;

package/dist/index.mjs

@@ -51,7 +51,7 @@ var __async = (__this, __arguments, generator) => {
 };
 
 // package.json
-var version = "6.1.1";
+var version = "6.1.2-preview-templates.0";
 
 // src/common/utils/build-pagination-query.ts
 function buildPaginationQuery(options) {
@@ -165,7 +165,11 @@ function parseEmailToApiOptions(email) {
     subject: email.subject,
     tags: email.tags,
     text: email.text,
-    to: email.to
+    to: email.to,
+    template: email.template ? {
+      id: email.template.id,
+      variables: email.template.variables
+    } : void 0
   };
 }
 
@@ -177,7 +181,7 @@ function render(node) {
     }).catch(() => {
       reject(
         Error(
-          "Failed to render React component. Make sure to install `@react-email/render`"
+          "Failed to render React component. Make sure to install `@react-email/render` or `@react-email/components`."
         )
       );
     });
@@ -520,6 +524,150 @@ var Emails = class {
   }
 };
 
+// src/common/utils/get-pagination-query-properties.ts
+function getPaginationQueryProperties(options = {}) {
+  const query = new URLSearchParams();
+  if (options.before) query.set("before", options.before);
+  if (options.after) query.set("after", options.after);
+  if (options.limit) query.set("limit", options.limit.toString());
+  return query.size > 0 ? `?${query.toString()}` : "";
+}
+
+// src/common/utils/parse-template-to-api-options.ts
+function parseVariables(variables) {
+  return variables == null ? void 0 : variables.map((variable) => ({
+    key: variable.key,
+    type: variable.type,
+    fallback_value: variable.fallbackValue
+  }));
+}
+function parseTemplateToApiOptions(template) {
+  return {
+    name: "name" in template ? template.name : void 0,
+    subject: template.subject,
+    html: template.html,
+    text: template.text,
+    alias: template.alias,
+    from: template.from,
+    reply_to: template.replyTo,
+    variables: parseVariables(template.variables)
+  };
+}
+
+// src/templates/chainable-template-result.ts
+var ChainableTemplateResult = class {
+  constructor(promise, publishFn) {
+    this.promise = promise;
+    this.publishFn = publishFn;
+  }
+  // If user calls `then` or only awaits for the result of create() or duplicate(), the behavior should be
+  // exactly as if they called create() or duplicate() directly. This will act as a normal promise
+  // biome-ignore lint/suspicious/noThenProperty: This class intentionally implements PromiseLike
+  then(onfulfilled, onrejected) {
+    return this.promise.then(onfulfilled, onrejected);
+  }
+  publish() {
+    return __async(this, null, function* () {
+      const { data, error } = yield this.promise;
+      if (error) {
+        return {
+          data: null,
+          error
+        };
+      }
+      const publishResult = yield this.publishFn(data.id);
+      return publishResult;
+    });
+  }
+};
+
+// src/templates/templates.ts
+var Templates = class {
+  constructor(resend) {
+    this.resend = resend;
+  }
+  create(payload) {
+    const createPromise = this.performCreate(payload);
+    return new ChainableTemplateResult(createPromise, this.publish.bind(this));
+  }
+  // This creation process is being done separately from the public create so that
+  // the user can chain the publish operation after the create operation. Otherwise, due
+  // to the async nature of the renderAsync, the return type would be
+  // Promise<ChainableTemplateResult<CreateTemplateResponse>> which wouldn't be chainable.
+  performCreate(payload) {
+    return __async(this, null, function* () {
+      if (payload.react) {
+        if (!this.renderAsync) {
+          try {
+            const { renderAsync } = yield import("@react-email/render");
+            this.renderAsync = renderAsync;
+          } catch (e) {
+            throw new Error(
+              "Failed to render React component. Make sure to install `@react-email/render`"
+            );
+          }
+        }
+        payload.html = yield this.renderAsync(
+          payload.react
+        );
+      }
+      return this.resend.post(
+        "/templates",
+        parseTemplateToApiOptions(payload)
+      );
+    });
+  }
+  remove(identifier) {
+    return __async(this, null, function* () {
+      const data = yield this.resend.delete(
+        `/templates/${identifier}`
+      );
+      return data;
+    });
+  }
+  get(identifier) {
+    return __async(this, null, function* () {
+      const data = yield this.resend.get(
+        `/templates/${identifier}`
+      );
+      return data;
+    });
+  }
+  list() {
+    return __async(this, arguments, function* (options = {}) {
+      return this.resend.get(
+        `/templates${getPaginationQueryProperties(options)}`
+      );
+    });
+  }
+  duplicate(identifier) {
+    const promiseDuplicate = this.resend.post(
+      `/templates/${identifier}/duplicate`
+    );
+    return new ChainableTemplateResult(
+      promiseDuplicate,
+      this.publish.bind(this)
+    );
+  }
+  publish(identifier) {
+    return __async(this, null, function* () {
+      const data = yield this.resend.post(
+        `/templates/${identifier}/publish`
+      );
+      return data;
+    });
+  }
+  update(identifier, payload) {
+    return __async(this, null, function* () {
+      const data = yield this.resend.patch(
+        `/templates/${identifier}`,
+        parseTemplateToApiOptions(payload)
+      );
+      return data;
+    });
+  }
+};
+
 // src/resend.ts
 var defaultBaseUrl = "https://api.resend.com";
 var defaultUserAgent = `resend-node:${version}`;
@@ -535,6 +683,7 @@ var Resend = class {
     this.contacts = new Contacts(this);
     this.domains = new Domains(this);
     this.emails = new Emails(this);
+    this.templates = new Templates(this);
     if (!key) {
       if (typeof process !== "undefined" && process.env) {
         this.key = process.env.RESEND_API_KEY;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend",
-  "version": "6.1.1",
+  "version": "6.1.2-preview-templates.0",
   "description": "Node.js library for the Resend API",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -23,6 +23,16 @@
       }
     }
   },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "format": "biome format --write .",
+    "format:apply": "biome check --write .",
+    "format:check": "biome format .",
+    "lint": "biome check .",
+    "prepublishOnly": "pnpm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/resendlabs/resend-node.git"
@@ -34,7 +44,7 @@
   },
   "homepage": "https://github.com/resendlabs/resend-node#readme",
   "peerDependencies": {
-    "@react-email/render": "^1.1.0"
+    "@react-email/render": "*"
   },
   "peerDependenciesMeta": {
     "@react-email/render": {
@@ -51,13 +61,5 @@
     "vitest": "3.2.4",
     "vitest-fetch-mock": "0.4.5"
   },
-  "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts",
-    "format": "biome format --write .",
-    "format:apply": "biome check --write .",
-    "format:check": "biome format .",
-    "lint": "biome check .",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  }
-}
+  "packageManager": "pnpm@10.17.1"
+}