resend 6.8.0 → 6.9.1

package/dist/index.cjs

@@ -1,7 +1,8 @@
+let mailparser = require("mailparser");
 let svix = require("svix");
 
 //#region package.json
-var version = "6.8.0";
+var version = "6.9.1";
 
 //#endregion
 //#region src/common/utils/build-pagination-query.ts
@@ -73,13 +74,13 @@ function parseEmailToApiOptions(email) {
 //#endregion
 //#region src/render.ts
 async function render(node) {
-	let render$1;
+	let render;
 	try {
-		({render: render$1} = await import("@react-email/render"));
+		({render} = await import("@react-email/render"));
 	} catch {
 		throw new Error("Failed to render React component. Make sure to install `@react-email/render` or `@react-email/components`.");
 	}
-	return render$1(node);
+	return render(node);
 }
 
 //#endregion
@@ -350,27 +351,40 @@ var Contacts = class {
 		this.segments = new ContactSegments(this.resend);
 	}
 	async create(payload, options = {}) {
-		if (!payload.audienceId) return await this.resend.post("/contacts", {
-			unsubscribed: payload.unsubscribed,
-			email: payload.email,
-			first_name: payload.firstName,
-			last_name: payload.lastName,
-			properties: payload.properties
-		}, options);
-		return await this.resend.post(`/audiences/${payload.audienceId}/contacts`, {
+		if ("audienceId" in payload) {
+			if ("segments" in payload || "topics" in payload) return {
+				data: null,
+				headers: null,
+				error: {
+					message: "`audienceId` is deprecated, and cannot be used together with `segments` or `topics`. Use `segments` instead to add one or more segments to the new contact.",
+					statusCode: null,
+					name: "invalid_parameter"
+				}
+			};
+			return await this.resend.post(`/audiences/${payload.audienceId}/contacts`, {
+				unsubscribed: payload.unsubscribed,
+				email: payload.email,
+				first_name: payload.firstName,
+				last_name: payload.lastName,
+				properties: payload.properties
+			}, options);
+		}
+		return await this.resend.post("/contacts", {
 			unsubscribed: payload.unsubscribed,
 			email: payload.email,
 			first_name: payload.firstName,
 			last_name: payload.lastName,
-			properties: payload.properties
+			properties: payload.properties,
+			segments: payload.segments,
+			topics: payload.topics
 		}, options);
 	}
 	async list(options = {}) {
 		const segmentId = options.segmentId ?? options.audienceId;
 		if (!segmentId) {
-			const queryString$1 = buildPaginationQuery(options);
-			const url$1 = queryString$1 ? `/contacts?${queryString$1}` : "/contacts";
-			return await this.resend.get(url$1);
+			const queryString = buildPaginationQuery(options);
+			const url = queryString ? `/contacts?${queryString}` : "/contacts";
+			return await this.resend.get(url);
 		}
 		const queryString = buildPaginationQuery(options);
 		const url = queryString ? `/segments/${segmentId}/contacts?${queryString}` : `/segments/${segmentId}/contacts`;
@@ -527,6 +541,106 @@ var Receiving = class {
 		const url = queryString ? `/emails/receiving?${queryString}` : "/emails/receiving";
 		return await this.resend.get(url);
 	}
+	async forward(options) {
+		const { emailId, to, from } = options;
+		const passthrough = options.passthrough !== false;
+		const emailResponse = await this.get(emailId);
+		if (emailResponse.error) return {
+			data: null,
+			error: emailResponse.error,
+			headers: emailResponse.headers
+		};
+		const email = emailResponse.data;
+		const originalSubject = email.subject || "(no subject)";
+		if (passthrough) return this.forwardPassthrough(email, {
+			to,
+			from,
+			subject: originalSubject
+		});
+		const forwardSubject = originalSubject.startsWith("Fwd:") ? originalSubject : `Fwd: ${originalSubject}`;
+		return this.forwardWrapped(email, {
+			to,
+			from,
+			subject: forwardSubject,
+			text: "text" in options ? options.text : void 0,
+			html: "html" in options ? options.html : void 0
+		});
+	}
+	async forwardPassthrough(email, options) {
+		const { to, from, subject } = options;
+		if (!email.raw?.download_url) return {
+			data: null,
+			error: {
+				name: "validation_error",
+				message: "Raw email content is not available for this email",
+				statusCode: 400
+			},
+			headers: null
+		};
+		const rawResponse = await fetch(email.raw.download_url);
+		if (!rawResponse.ok) return {
+			data: null,
+			error: {
+				name: "application_error",
+				message: "Failed to download raw email content",
+				statusCode: rawResponse.status
+			},
+			headers: null
+		};
+		const parsed = await (0, mailparser.simpleParser)(await rawResponse.text(), { skipImageLinks: true });
+		const attachments = parsed.attachments.map((attachment) => {
+			const contentId = attachment.contentId ? attachment.contentId.replace(/^<|>$/g, "") : void 0;
+			return {
+				filename: attachment.filename,
+				content: attachment.content.toString("base64"),
+				content_type: attachment.contentType,
+				content_id: contentId || void 0
+			};
+		});
+		return await this.resend.post("/emails", {
+			from,
+			to,
+			subject,
+			text: parsed.text || void 0,
+			html: parsed.html || void 0,
+			attachments: attachments.length > 0 ? attachments : void 0
+		});
+	}
+	async forwardWrapped(email, options) {
+		const { to, from, subject, text, html } = options;
+		if (!email.raw?.download_url) return {
+			data: null,
+			error: {
+				name: "validation_error",
+				message: "Raw email content is not available for this email",
+				statusCode: 400
+			},
+			headers: null
+		};
+		const rawResponse = await fetch(email.raw.download_url);
+		if (!rawResponse.ok) return {
+			data: null,
+			error: {
+				name: "application_error",
+				message: "Failed to download raw email content",
+				statusCode: rawResponse.status
+			},
+			headers: null
+		};
+		const rawEmailContent = await rawResponse.text();
+		return await this.resend.post("/emails", {
+			from,
+			to,
+			subject,
+			text,
+			html,
+			attachments: [{
+				filename: "forwarded_message.eml",
+				content: Buffer.from(rawEmailContent).toString("base64"),
+				content_type: "message/rfc822"
+			}]
+		});
+	}
 };
 
 //#endregion

package/dist/index.d.cts

@@ -361,8 +361,7 @@ interface CreateBatchRequestOptions extends PostOptions, IdempotentRequest {
 }
 type CreateBatchSuccessResponse<Options extends CreateBatchRequestOptions = CreateBatchRequestOptions> = {
   data: {
-    /** The ID of the newly created email. */
-    id: string;
+    /** The ID of the newly created email. */id: string;
   }[];
 } & (Options['batchValidation'] extends 'permissive' ? {
   /**
@@ -575,6 +574,97 @@ type UpdateBroadcastOptions = {
 };
 type UpdateBroadcastResponse = Response<UpdateBroadcastResponseSuccess>;
 //#endregion
+//#region src/contact-properties/interfaces/contact-property.d.ts
+type StringBaseApiContactProperty = {
+  type: 'string';
+  fallback_value: string | null;
+};
+type NumberBaseApiContactProperty = {
+  type: 'number';
+  fallback_value: number | null;
+};
+type ApiContactProperty = {
+  id: string;
+  created_at: string;
+  key: string;
+} & (StringBaseApiContactProperty | NumberBaseApiContactProperty);
+type StringBaseContactProperty = {
+  type: 'string';
+  fallbackValue: string | null;
+};
+type NumberBaseContactProperty = {
+  type: 'number';
+  fallbackValue: number | null;
+};
+type ContactProperty = {
+  id: string;
+  createdAt: string;
+  key: string;
+} & (StringBaseContactProperty | NumberBaseContactProperty);
+//#endregion
+//#region src/contact-properties/interfaces/create-contact-property-options.interface.d.ts
+type StringBaseContactPropertyOptions = {
+  type: 'string';
+  fallbackValue?: string | null;
+};
+type NumberBaseContactPropertyOptions = {
+  type: 'number';
+  fallbackValue?: number | null;
+};
+type CreateContactPropertyOptions = {
+  key: string;
+} & (StringBaseContactPropertyOptions | NumberBaseContactPropertyOptions);
+interface CreateContactPropertyApiOptions {
+  key: string;
+  type: 'string' | 'number';
+  fallback_value?: string | number | null;
+}
+type CreateContactPropertyResponseSuccess = Pick<ContactProperty, 'id'> & {
+  object: 'contact_property';
+};
+type CreateContactPropertyResponse = Response<CreateContactPropertyResponseSuccess>;
+//#endregion
+//#region src/contact-properties/interfaces/delete-contact-property-options.interface.d.ts
+type RemoveContactPropertyResponseSuccess = Pick<ContactProperty, 'id'> & {
+  object: 'contact_property';
+  deleted: boolean;
+};
+type RemoveContactPropertyResponse = Response<RemoveContactPropertyResponseSuccess>;
+//#endregion
+//#region src/contact-properties/interfaces/get-contact-property.interface.d.ts
+type GetContactPropertyResponseSuccess = ApiContactProperty & {
+  object: 'contact_property';
+};
+type GetContactPropertyResponse = Response<ContactProperty & {
+  object: 'contact_property';
+}>;
+//#endregion
+//#region src/contact-properties/interfaces/list-contact-properties-options.interface.d.ts
+type ListContactPropertiesOptions = PaginationOptions;
+type ListContactPropertiesResponseSuccess = {
+  object: 'list';
+  has_more: boolean;
+  data: ApiContactProperty[];
+};
+type ListContactPropertiesResponse = Response<{
+  object: 'list';
+  has_more: boolean;
+  data: ContactProperty[];
+}>;
+//#endregion
+//#region src/contact-properties/interfaces/update-contact-property-options.interface.d.ts
+type UpdateContactPropertyOptions = {
+  id: string;
+  fallbackValue?: string | number | null;
+};
+interface UpdateContactPropertyApiOptions {
+  fallback_value?: string | number | null;
+}
+type UpdateContactPropertyResponseSuccess = Pick<ContactProperty, 'id'> & {
+  object: 'contact_property';
+};
+type UpdateContactPropertyResponse = Response<UpdateContactPropertyResponseSuccess>;
+//#endregion
 //#region src/contacts/interfaces/contact.d.ts
 interface Contact {
   created_at: string;
@@ -616,13 +706,36 @@ type SelectingField = {
 interface CreateContactPropertiesOptions {
   [key: string]: string | number | null;
 }
+interface LegacyCreateContactOptions {
+  /**
+   * @deprecated Use `segments` instead to add one or more segments to the new contact
+   */
+  audienceId: string;
+  email: string;
+  unsubscribed?: boolean;
+  firstName?: string;
+  lastName?: string;
+  properties?: CreateContactPropertiesOptions;
+  segments?: never;
+  topics?: never;
+}
 interface CreateContactOptions {
-  audienceId?: string;
   email: string;
   unsubscribed?: boolean;
   firstName?: string;
   lastName?: string;
   properties?: CreateContactPropertiesOptions;
+  segments?: {
+    id: string;
+  }[];
+  topics?: {
+    id: string;
+    subscription: 'opt_in' | 'opt_out';
+  }[];
+  /**
+   * @deprecated Use `segments` instead to add one or more segments to the new contact
+   */
+  audienceId?: never;
 }
 interface CreateContactRequestOptions extends PostOptions {}
 interface CreateContactResponseSuccess extends Pick<Contact, 'id'> {
@@ -698,6 +811,79 @@ type UpdateContactResponseSuccess = Pick<Contact, 'id'> & {
 };
 type UpdateContactResponse = Response<UpdateContactResponseSuccess>;
 //#endregion
+//#region src/contacts/segments/interfaces/contact-segments.interface.d.ts
+type ContactSegmentsBaseOptions = {
+  contactId: string;
+  email?: never;
+} | {
+  contactId?: never;
+  email: string;
+};
+//#endregion
+//#region src/contacts/segments/interfaces/add-contact-segment.interface.d.ts
+type AddContactSegmentOptions = ContactSegmentsBaseOptions & {
+  segmentId: string;
+};
+interface AddContactSegmentResponseSuccess {
+  id: string;
+}
+type AddContactSegmentResponse = Response<AddContactSegmentResponseSuccess>;
+//#endregion
+//#region src/segments/interfaces/segment.d.ts
+interface Segment {
+  created_at: string;
+  id: string;
+  name: string;
+}
+//#endregion
+//#region src/contacts/segments/interfaces/list-contact-segments.interface.d.ts
+type ListContactSegmentsOptions = PaginationOptions & ContactSegmentsBaseOptions;
+type ListContactSegmentsResponseSuccess = PaginatedData<Segment[]>;
+type ListContactSegmentsResponse = Response<ListContactSegmentsResponseSuccess>;
+//#endregion
+//#region src/contacts/segments/interfaces/remove-contact-segment.interface.d.ts
+type RemoveContactSegmentOptions = ContactSegmentsBaseOptions & {
+  segmentId: string;
+};
+interface RemoveContactSegmentResponseSuccess {
+  id: string;
+  deleted: boolean;
+}
+type RemoveContactSegmentResponse = Response<RemoveContactSegmentResponseSuccess>;
+//#endregion
+//#region src/contacts/topics/interfaces/list-contact-topics.interface.d.ts
+interface ListContactTopicsBaseOptions {
+  id?: string;
+  email?: string;
+}
+type ListContactTopicsOptions = ListContactTopicsBaseOptions & PaginationOptions;
+interface ListContactTopicsRequestOptions extends GetOptions {}
+interface ContactTopic {
+  id: string;
+  name: string;
+  description: string | null;
+  subscription: 'opt_in' | 'opt_out';
+}
+type ListContactTopicsResponseSuccess = PaginatedData<ContactTopic[]>;
+type ListContactTopicsResponse = Response<ListContactTopicsResponseSuccess>;
+//#endregion
+//#region src/contacts/topics/interfaces/update-contact-topics.interface.d.ts
+interface UpdateContactTopicsBaseOptions {
+  id?: string;
+  email?: string;
+}
+interface UpdateContactTopicsOptions extends UpdateContactTopicsBaseOptions {
+  topics: {
+    id: string;
+    subscription: 'opt_in' | 'opt_out';
+  }[];
+}
+interface UpdateContactTopicsRequestOptions extends PatchOptions {}
+interface UpdateContactTopicsResponseSuccess {
+  id: string;
+}
+type UpdateContactTopicsResponse = Response<UpdateContactTopicsResponseSuccess>;
+//#endregion
 //#region src/domains/interfaces/create-domain-options.interface.d.ts
 interface CreateDomainOptions {
   name: string;
@@ -836,6 +1022,26 @@ interface UpdateEmailResponseSuccess {
 }
 type UpdateEmailResponse = Response<UpdateEmailResponseSuccess>;
 //#endregion
+//#region src/emails/receiving/interfaces/forward-receiving-email.interface.d.ts
+interface ForwardReceivingEmailBodyOptions {
+  text: string;
+  html: string;
+}
+interface ForwardReceivingEmailBaseOptions {
+  emailId: string;
+  to: string | string[];
+  from: string;
+}
+type ForwardReceivingEmailOptions = (ForwardReceivingEmailBaseOptions & {
+  passthrough?: true;
+}) | (ForwardReceivingEmailBaseOptions & {
+  passthrough: false;
+} & RequireAtLeastOne<ForwardReceivingEmailBodyOptions>);
+interface ForwardReceivingEmailResponseSuccess {
+  id: string;
+}
+type ForwardReceivingEmailResponse = Response<ForwardReceivingEmailResponseSuccess>;
+//#endregion
 //#region src/emails/receiving/interfaces/get-receiving-email.interface.d.ts
 interface GetReceivingEmailResponseSuccess {
   object: 'email';
@@ -851,6 +1057,10 @@ interface GetReceivingEmailResponseSuccess {
   text: string | null;
   headers: Record<string, string>;
   message_id: string;
+  raw: {
+    download_url: string;
+    expires_at: string;
+  } | null;
   attachments: Array<{
     id: string;
     filename: string;
@@ -864,7 +1074,7 @@ type GetReceivingEmailResponse = Response<GetReceivingEmailResponseSuccess>;
 //#endregion
 //#region src/emails/receiving/interfaces/list-receiving-emails.interface.d.ts
 type ListReceivingEmailsOptions = PaginationOptions;
-type ListReceivingEmail = Omit<GetReceivingEmailResponseSuccess, 'html' | 'text' | 'headers' | 'object'>;
+type ListReceivingEmail = Omit<GetReceivingEmailResponseSuccess, 'html' | 'text' | 'headers' | 'raw' | 'object'>;
 interface ListReceivingEmailsResponseSuccess {
   object: 'list';
   has_more: boolean;
@@ -907,68 +1117,6 @@ declare class Broadcasts {
   update(id: string, payload: UpdateBroadcastOptions): Promise<UpdateBroadcastResponse>;
 }
 //#endregion
-//#region src/contact-properties/interfaces/contact-property.d.ts
-type StringBaseContactProperty = {
-  type: 'string';
-  fallbackValue: string | null;
-};
-type NumberBaseContactProperty = {
-  type: 'number';
-  fallbackValue: number | null;
-};
-type ContactProperty = {
-  id: string;
-  createdAt: string;
-  key: string;
-} & (StringBaseContactProperty | NumberBaseContactProperty);
-//#endregion
-//#region src/contact-properties/interfaces/create-contact-property-options.interface.d.ts
-type StringBaseContactPropertyOptions = {
-  type: 'string';
-  fallbackValue?: string | null;
-};
-type NumberBaseContactPropertyOptions = {
-  type: 'number';
-  fallbackValue?: number | null;
-};
-type CreateContactPropertyOptions = {
-  key: string;
-} & (StringBaseContactPropertyOptions | NumberBaseContactPropertyOptions);
-type CreateContactPropertyResponseSuccess = Pick<ContactProperty, 'id'> & {
-  object: 'contact_property';
-};
-type CreateContactPropertyResponse = Response<CreateContactPropertyResponseSuccess>;
-//#endregion
-//#region src/contact-properties/interfaces/delete-contact-property-options.interface.d.ts
-type RemoveContactPropertyResponseSuccess = Pick<ContactProperty, 'id'> & {
-  object: 'contact_property';
-  deleted: boolean;
-};
-type RemoveContactPropertyResponse = Response<RemoveContactPropertyResponseSuccess>;
-//#endregion
-//#region src/contact-properties/interfaces/get-contact-property.interface.d.ts
-type GetContactPropertyResponse = Response<ContactProperty & {
-  object: 'contact_property';
-}>;
-//#endregion
-//#region src/contact-properties/interfaces/list-contact-properties-options.interface.d.ts
-type ListContactPropertiesOptions = PaginationOptions;
-type ListContactPropertiesResponse = Response<{
-  object: 'list';
-  has_more: boolean;
-  data: ContactProperty[];
-}>;
-//#endregion
-//#region src/contact-properties/interfaces/update-contact-property-options.interface.d.ts
-type UpdateContactPropertyOptions = {
-  id: string;
-  fallbackValue?: string | number | null;
-};
-type UpdateContactPropertyResponseSuccess = Pick<ContactProperty, 'id'> & {
-  object: 'contact_property';
-};
-type UpdateContactPropertyResponse = Response<UpdateContactPropertyResponseSuccess>;
-//#endregion
 //#region src/contact-properties/contact-properties.d.ts
 declare class ContactProperties {
   private readonly resend;
@@ -980,46 +1128,6 @@ declare class ContactProperties {
   remove(id: string): Promise<RemoveContactPropertyResponse>;
 }
 //#endregion
-//#region src/contacts/segments/interfaces/contact-segments.interface.d.ts
-type ContactSegmentsBaseOptions = {
-  contactId: string;
-  email?: never;
-} | {
-  contactId?: never;
-  email: string;
-};
-//#endregion
-//#region src/contacts/segments/interfaces/add-contact-segment.interface.d.ts
-type AddContactSegmentOptions = ContactSegmentsBaseOptions & {
-  segmentId: string;
-};
-interface AddContactSegmentResponseSuccess {
-  id: string;
-}
-type AddContactSegmentResponse = Response<AddContactSegmentResponseSuccess>;
-//#endregion
-//#region src/segments/interfaces/segment.d.ts
-interface Segment {
-  created_at: string;
-  id: string;
-  name: string;
-}
-//#endregion
-//#region src/contacts/segments/interfaces/list-contact-segments.interface.d.ts
-type ListContactSegmentsOptions = PaginationOptions & ContactSegmentsBaseOptions;
-type ListContactSegmentsResponseSuccess = PaginatedData<Segment[]>;
-type ListContactSegmentsResponse = Response<ListContactSegmentsResponseSuccess>;
-//#endregion
-//#region src/contacts/segments/interfaces/remove-contact-segment.interface.d.ts
-type RemoveContactSegmentOptions = ContactSegmentsBaseOptions & {
-  segmentId: string;
-};
-interface RemoveContactSegmentResponseSuccess {
-  id: string;
-  deleted: boolean;
-}
-type RemoveContactSegmentResponse = Response<RemoveContactSegmentResponseSuccess>;
-//#endregion
 //#region src/contacts/segments/contact-segments.d.ts
 declare class ContactSegments {
   private readonly resend;
@@ -1029,37 +1137,6 @@ declare class ContactSegments {
   remove(options: RemoveContactSegmentOptions): Promise<RemoveContactSegmentResponse>;
 }
 //#endregion
-//#region src/contacts/topics/interfaces/list-contact-topics.interface.d.ts
-interface ListContactTopicsBaseOptions {
-  id?: string;
-  email?: string;
-}
-type ListContactTopicsOptions = ListContactTopicsBaseOptions & PaginationOptions;
-interface ContactTopic {
-  id: string;
-  name: string;
-  description: string | null;
-  subscription: 'opt_in' | 'opt_out';
-}
-type ListContactTopicsResponseSuccess = PaginatedData<ContactTopic[]>;
-type ListContactTopicsResponse = Response<ListContactTopicsResponseSuccess>;
-//#endregion
-//#region src/contacts/topics/interfaces/update-contact-topics.interface.d.ts
-interface UpdateContactTopicsBaseOptions {
-  id?: string;
-  email?: string;
-}
-interface UpdateContactTopicsOptions extends UpdateContactTopicsBaseOptions {
-  topics: {
-    id: string;
-    subscription: 'opt_in' | 'opt_out';
-  }[];
-}
-interface UpdateContactTopicsResponseSuccess {
-  id: string;
-}
-type UpdateContactTopicsResponse = Response<UpdateContactTopicsResponseSuccess>;
-//#endregion
 //#region src/contacts/topics/contact-topics.d.ts
 declare class ContactTopics {
   private readonly resend;
@@ -1074,7 +1151,7 @@ declare class Contacts {
   readonly topics: ContactTopics;
   readonly segments: ContactSegments;
   constructor(resend: Resend);
-  create(payload: CreateContactOptions, options?: CreateContactRequestOptions): Promise<CreateContactResponse>;
+  create(payload: CreateContactOptions | LegacyCreateContactOptions, options?: CreateContactRequestOptions): Promise<CreateContactResponse>;
   list(options?: ListContactsOptions): Promise<ListContactsResponse>;
   get(options: GetContactOptions): Promise<GetContactResponse>;
   update(options: UpdateContactOptions): Promise<UpdateContactResponse>;
@@ -1126,6 +1203,9 @@ declare class Receiving {
   constructor(resend: Resend);
   get(id: string): Promise<GetReceivingEmailResponse>;
   list(options?: ListReceivingEmailsOptions): Promise<ListReceivingEmailsResponse>;
+  forward(options: ForwardReceivingEmailOptions): Promise<ForwardReceivingEmailResponse>;
+  private forwardPassthrough;
+  private forwardWrapped;
 }
 //#endregion
 //#region src/emails/emails.d.ts
@@ -1227,6 +1307,7 @@ type TemplateOptionalFieldsForCreation = Partial<Pick<Template, 'subject' | 'tex
   variables?: TemplateVariableCreationOptions[];
 };
 type CreateTemplateOptions = Pick<Template, 'name'> & TemplateOptionalFieldsForCreation & TemplateContentCreationOptions;
+interface CreateTemplateRequestOptions extends PostOptions {}
 interface CreateTemplateResponseSuccess extends Pick<Template, 'id'> {
   object: 'template';
 }
@@ -1260,6 +1341,7 @@ interface GetTemplateResponseSuccess extends Template {
 type GetTemplateResponse = Response<GetTemplateResponseSuccess>;
 //#endregion
 //#region src/templates/interfaces/list-templates.interface.d.ts
+type ListTemplatesOptions = PaginationOptions;
 interface TemplateListItem extends Pick<Template, 'id' | 'name' | 'created_at' | 'updated_at' | 'status' | 'published_at' | 'alias'> {}
 interface ListTemplatesResponseSuccess {
   object: 'list';
@@ -1327,6 +1409,9 @@ type CreateTopicResponseSuccess = Pick<Topic, 'id'>;
 type CreateTopicResponse = Response<CreateTopicResponseSuccess>;
 //#endregion
 //#region src/topics/interfaces/get-contact.interface.d.ts
+interface GetTopicOptions {
+  id: string;
+}
 type GetTopicResponseSuccess = Topic;
 type GetTopicResponse = Response<GetTopicResponseSuccess>;
 //#endregion
@@ -1644,4 +1729,4 @@ declare class Resend {
   delete<T>(path: string, query?: unknown): Promise<Response<T>>;
 }
 //#endregion
-export { ApiKey, Attachment, Broadcast, CancelEmailResponse, CancelEmailResponseSuccess, Contact, ContactCreatedEvent, ContactDeletedEvent, ContactUpdatedEvent, CreateApiKeyOptions, CreateApiKeyRequestOptions, CreateApiKeyResponse, CreateApiKeyResponseSuccess, CreateBatchOptions, CreateBatchRequestOptions, CreateBatchResponse, CreateBatchSuccessResponse, CreateBroadcastOptions, CreateBroadcastRequestOptions, CreateBroadcastResponse, CreateBroadcastResponseSuccess, CreateContactOptions, CreateContactRequestOptions, CreateContactResponse, CreateContactResponseSuccess, CreateDomainOptions, CreateDomainRequestOptions, CreateDomainResponse, CreateDomainResponseSuccess, CreateEmailOptions, CreateEmailRequestOptions, CreateEmailResponse, CreateEmailResponseSuccess, CreateSegmentOptions, CreateSegmentRequestOptions, CreateSegmentResponse, CreateSegmentResponseSuccess, CreateWebhookOptions, CreateWebhookRequestOptions, CreateWebhookResponse, CreateWebhookResponseSuccess, Domain, DomainApiOptions, DomainCapabilities, DomainCapabilityStatus, DomainCreatedEvent, DomainDeletedEvent, DomainDkimRecord, DomainNameservers, DomainRecords, DomainRegion, DomainSpfRecord, DomainStatus, DomainUpdatedEvent, EmailApiAttachment, EmailApiOptions, EmailBouncedEvent, EmailClickedEvent, EmailComplainedEvent, EmailDeliveredEvent, EmailDeliveryDelayedEvent, EmailFailedEvent, EmailOpenedEvent, EmailReceivedEvent, EmailScheduledEvent, EmailSentEvent, EmailSuppressedEvent, type ErrorResponse, GetAttachmentOptions, GetAttachmentResponse, GetAttachmentResponseSuccess, GetBroadcastResponse, GetBroadcastResponseSuccess, GetContactOptions, GetContactResponse, GetContactResponseSuccess, GetDomainResponse, GetDomainResponseSuccess, GetEmailResponse, GetEmailResponseSuccess, GetOptions, GetReceivingEmailResponse, GetReceivingEmailResponseSuccess, GetSegmentResponse, GetSegmentResponseSuccess, GetWebhookResponse, GetWebhookResponseSuccess, IdempotentRequest, ListApiKeysOptions, ListApiKeysResponse, ListApiKeysResponseSuccess, ListAttachmentsApiResponse, ListAttachmentsOptions, ListAttachmentsResponse, ListAttachmentsResponseSuccess, ListBroadcastsOptions, ListBroadcastsResponse, ListBroadcastsResponseSuccess, ListContactsOptions, ListContactsResponse, ListContactsResponseSuccess, ListDomainsOptions, ListDomainsResponse, ListDomainsResponseSuccess, ListReceivingEmail, ListReceivingEmailsOptions, ListReceivingEmailsResponse, ListReceivingEmailsResponseSuccess, ListSegmentsOptions, ListSegmentsResponse, ListSegmentsResponseSuccess, ListWebhooksOptions, ListWebhooksResponse, ListWebhooksResponseSuccess, PaginatedData, PaginationOptions, PatchOptions, PostOptions, PutOptions, ReceivingRecord, RemoveApiKeyResponse, RemoveApiKeyResponseSuccess, RemoveBroadcastResponse, RemoveBroadcastResponseSuccess, RemoveContactOptions, RemoveContactsResponse, RemoveContactsResponseSuccess, RemoveDomainsResponse, RemoveDomainsResponseSuccess, RemoveSegmentResponse, RemoveSegmentResponseSuccess, RemoveWebhookResponse, RemoveWebhookResponseSuccess, RequireAtLeastOne, Resend, type Response, Segment, SelectingField, SendBroadcastOptions, SendBroadcastRequestOptions, SendBroadcastResponse, SendBroadcastResponseSuccess, Tag, UpdateBroadcastOptions, UpdateBroadcastResponse, UpdateBroadcastResponseSuccess, UpdateContactOptions, UpdateContactResponse, UpdateContactResponseSuccess, UpdateDomainsOptions, UpdateDomainsResponse, UpdateDomainsResponseSuccess, UpdateEmailOptions, UpdateEmailResponse, UpdateEmailResponseSuccess, UpdateWebhookOptions, UpdateWebhookResponse, UpdateWebhookResponseSuccess, VerifyDomainsResponse, VerifyDomainsResponseSuccess, Webhook, WebhookEvent, WebhookEventPayload };
+export { AddContactSegmentOptions, AddContactSegmentResponse, AddContactSegmentResponseSuccess, ApiContactProperty, ApiKey, Attachment, Broadcast, CancelEmailResponse, CancelEmailResponseSuccess, Contact, ContactCreatedEvent, ContactDeletedEvent, ContactProperty, ContactSegmentsBaseOptions, ContactTopic, ContactUpdatedEvent, CreateApiKeyOptions, CreateApiKeyRequestOptions, CreateApiKeyResponse, CreateApiKeyResponseSuccess, CreateBatchOptions, CreateBatchRequestOptions, CreateBatchResponse, CreateBatchSuccessResponse, CreateBroadcastOptions, CreateBroadcastRequestOptions, CreateBroadcastResponse, CreateBroadcastResponseSuccess, CreateContactOptions, CreateContactPropertyApiOptions, CreateContactPropertyOptions, CreateContactPropertyResponse, CreateContactPropertyResponseSuccess, CreateContactRequestOptions, CreateContactResponse, CreateContactResponseSuccess, CreateDomainOptions, CreateDomainRequestOptions, CreateDomainResponse, CreateDomainResponseSuccess, CreateEmailOptions, CreateEmailRequestOptions, CreateEmailResponse, CreateEmailResponseSuccess, CreateSegmentOptions, CreateSegmentRequestOptions, CreateSegmentResponse, CreateSegmentResponseSuccess, CreateTemplateOptions, CreateTemplateRequestOptions, CreateTemplateResponse, CreateTemplateResponseSuccess, CreateTopicOptions, CreateTopicResponse, CreateTopicResponseSuccess, CreateWebhookOptions, CreateWebhookRequestOptions, CreateWebhookResponse, CreateWebhookResponseSuccess, Domain, DomainApiOptions, DomainCapabilities, DomainCapabilityStatus, DomainCreatedEvent, DomainDeletedEvent, DomainDkimRecord, DomainNameservers, DomainRecords, DomainRegion, DomainSpfRecord, DomainStatus, DomainUpdatedEvent, DuplicateTemplateResponse, DuplicateTemplateResponseSuccess, EmailApiAttachment, EmailApiOptions, EmailBouncedEvent, EmailClickedEvent, EmailComplainedEvent, EmailDeliveredEvent, EmailDeliveryDelayedEvent, EmailFailedEvent, EmailOpenedEvent, EmailReceivedEvent, EmailScheduledEvent, EmailSentEvent, EmailSuppressedEvent, type ErrorResponse, ForwardReceivingEmailOptions, ForwardReceivingEmailResponse, ForwardReceivingEmailResponseSuccess, GetAttachmentOptions, GetAttachmentResponse, GetAttachmentResponseSuccess, GetBroadcastResponse, GetBroadcastResponseSuccess, GetContactOptions, GetContactPropertyResponse, GetContactPropertyResponseSuccess, GetContactResponse, GetContactResponseSuccess, GetDomainResponse, GetDomainResponseSuccess, GetEmailResponse, GetEmailResponseSuccess, GetOptions, GetReceivingEmailResponse, GetReceivingEmailResponseSuccess, GetSegmentResponse, GetSegmentResponseSuccess, GetTemplateResponse, GetTemplateResponseSuccess, GetTopicOptions, GetTopicResponse, GetTopicResponseSuccess, GetWebhookResponse, GetWebhookResponseSuccess, IdempotentRequest, LegacyCreateContactOptions, ListApiKeysOptions, ListApiKeysResponse, ListApiKeysResponseSuccess, ListAttachmentsApiResponse, ListAttachmentsOptions, ListAttachmentsResponse, ListAttachmentsResponseSuccess, ListBroadcastsOptions, ListBroadcastsResponse, ListBroadcastsResponseSuccess, ListContactPropertiesOptions, ListContactPropertiesResponse, ListContactPropertiesResponseSuccess, ListContactSegmentsOptions, ListContactSegmentsResponse, ListContactSegmentsResponseSuccess, ListContactTopicsOptions, ListContactTopicsRequestOptions, ListContactTopicsResponse, ListContactTopicsResponseSuccess, ListContactsOptions, ListContactsResponse, ListContactsResponseSuccess, ListDomainsOptions, ListDomainsResponse, ListDomainsResponseSuccess, ListReceivingEmail, ListReceivingEmailsOptions, ListReceivingEmailsResponse, ListReceivingEmailsResponseSuccess, ListSegmentsOptions, ListSegmentsResponse, ListSegmentsResponseSuccess, ListTemplatesOptions, ListTemplatesResponse, ListTemplatesResponseSuccess, ListTopicsResponse, ListTopicsResponseSuccess, ListWebhooksOptions, ListWebhooksResponse, ListWebhooksResponseSuccess, PaginatedData, PaginationOptions, PatchOptions, PostOptions, PublishTemplateResponse, PublishTemplateResponseSuccess, PutOptions, ReceivingRecord, RemoveApiKeyResponse, RemoveApiKeyResponseSuccess, RemoveBroadcastResponse, RemoveBroadcastResponseSuccess, RemoveContactOptions, RemoveContactPropertyResponse, RemoveContactPropertyResponseSuccess, RemoveContactSegmentOptions, RemoveContactSegmentResponse, RemoveContactSegmentResponseSuccess, RemoveContactsResponse, RemoveContactsResponseSuccess, RemoveDomainsResponse, RemoveDomainsResponseSuccess, RemoveSegmentResponse, RemoveSegmentResponseSuccess, RemoveTemplateResponse, RemoveTemplateResponseSuccess, RemoveTopicResponse, RemoveTopicResponseSuccess, RemoveWebhookResponse, RemoveWebhookResponseSuccess, RequireAtLeastOne, Resend, type Response, Segment, SelectingField, SendBroadcastOptions, SendBroadcastRequestOptions, SendBroadcastResponse, SendBroadcastResponseSuccess, Tag, Template, TemplateVariable, Topic, UpdateBroadcastOptions, UpdateBroadcastResponse, UpdateBroadcastResponseSuccess, UpdateContactOptions, UpdateContactPropertyApiOptions, UpdateContactPropertyOptions, UpdateContactPropertyResponse, UpdateContactPropertyResponseSuccess, UpdateContactResponse, UpdateContactResponseSuccess, UpdateContactTopicsOptions, UpdateContactTopicsRequestOptions, UpdateContactTopicsResponse, UpdateContactTopicsResponseSuccess, UpdateDomainsOptions, UpdateDomainsResponse, UpdateDomainsResponseSuccess, UpdateEmailOptions, UpdateEmailResponse, UpdateEmailResponseSuccess, UpdateTemplateOptions, UpdateTemplateResponse, UpdateTemplateResponseSuccess, UpdateTopicOptions, UpdateTopicResponse, UpdateTopicResponseSuccess, UpdateWebhookOptions, UpdateWebhookResponse, UpdateWebhookResponseSuccess, VerifyDomainsResponse, VerifyDomainsResponseSuccess, Webhook, WebhookEvent, WebhookEventPayload };