resend 6.33.0 → 6.34.0

package/dist/index.mjs

@@ -7,8 +7,14 @@ const INBOX_AGENT_ACTIONS = [
 	"add_labels",
 	"assign_thread",
 	"mark_as_spam",
-	"archive_thread",
-	"delete_thread"
+	"archive",
+	"move_to_trash"
+];
+const INBOX_AGENT_TONES = [
+	"concise_professional",
+	"concise_casual",
+	"expanded_professional",
+	"expanded_casual"
 ];
 //#endregion
 //#region src/inboxes/interfaces/inbox.ts
@@ -27,7 +33,7 @@ const MOVE_THREAD_FOLDERS = [
 ];
 //#endregion
 //#region package.json
-var version = "6.33.0";
+var version = "6.34.0";
 //#endregion
 //#region src/common/utils/build-pagination-query.ts
 function buildPaginationUrl(base, options) {
@@ -263,11 +269,12 @@ var Batch$1 = class {
 	async create(payload, requestOptions) {
 		const emails = [];
 		for (const email of payload) {
-			if (email.react) {
-				email.html = await render(email.react);
-				email.react = void 0;
+			const body = { ...email };
+			if (body.react) {
+				body.html = await render(body.react);
+				body.react = void 0;
 			}
-			emails.push(parseEmailToApiOptions(email));
+			emails.push(parseEmailToApiOptions(body));
 		}
 		const headers = new Headers({ "x-batch-validation": requestOptions?.batchValidation ?? "strict" });
 		for (const [key, value] of new Headers(requestOptions?.headers || void 0)) headers.set(key, value);
@@ -352,6 +359,17 @@ function buildRecipientsQuery(options) {
 	return searchParams.toString();
 }
 //#endregion
+//#region src/common/utils/has-dot-segment.ts
+const DOT_SEGMENT = /^(?:\.|%2e){1,2}$/i;
+/**
+* Whether a request path contains a `.` or `..` segment. URL parsing resolves
+* these (even when percent-encoded), so the request would reach another path.
+*/
+function hasDotSegment(requestPath) {
+	const [pathname] = requestPath.split(/[?#]/);
+	return pathname.split("/").some((segment) => DOT_SEGMENT.test(segment));
+}
+//#endregion
 //#region src/common/utils/parse-contact-properties-to-api-options.ts
 function parseContactPropertyFromApi(contactProperty) {
 	return {
@@ -981,20 +999,39 @@ var Events$1 = class {
 	}
 };
 //#endregion
+//#region src/inboxes/build-inbox-path.ts
+function buildInboxPath(selector) {
+	const idOrEmail = selector?.inboxId ?? selector?.emailAddress;
+	return idOrEmail ? `/inboxes/${encodeURIComponent(idOrEmail)}` : void 0;
+}
+const missingInboxError = () => ({
+	data: null,
+	headers: null,
+	error: {
+		message: "Missing `inboxId` or `emailAddress` field.",
+		statusCode: null,
+		name: "missing_required_field"
+	}
+});
+//#endregion
 //#region src/inboxes/agent/agent.ts
 var InboxAgent = class {
 	constructor(resend) {
 		this.resend = resend;
 	}
 	async get(options, requestOptions = {}) {
-		return this.resend.get(`/inboxes/${options.inboxId}/agent`, requestOptions);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.get(`${inboxPath}/agent`, requestOptions);
 	}
 	async update(options, requestOptions = {}) {
-		const { inboxId, instructions, tone, enabledActions } = options;
-		return this.resend.patch(`/inboxes/${inboxId}/agent`, {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { instructions, tone, actions } = options;
+		return this.resend.patch(`${inboxPath}/agent`, {
 			instructions,
 			tone,
-			enabled_actions: enabledActions
+			actions
 		}, requestOptions);
 	}
 };
@@ -1016,8 +1053,10 @@ var InboxDrafts = class {
 		this.resend = resend;
 	}
 	async list(options, requestOptions = {}) {
-		const { inboxId, limit, after, before } = options;
-		const url = buildInboxCursorUrl(`/inboxes/${inboxId}/drafts`, {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { limit, after, before } = options;
+		const url = buildInboxCursorUrl(`${inboxPath}/drafts`, {
 			limit,
 			after,
 			before
@@ -1025,8 +1064,10 @@ var InboxDrafts = class {
 		return this.resend.get(url, requestOptions);
 	}
 	async create(payload, options = {}) {
-		const { inboxId, threadId, replyToEmailId, attachments, ...content } = payload;
-		return this.resend.post(`/inboxes/${inboxId}/drafts`, {
+		const inboxPath = buildInboxPath(payload);
+		if (!inboxPath) return missingInboxError();
+		const { inboxId, emailAddress, threadId, replyToEmailId, attachments, ...content } = payload;
+		return this.resend.post(`${inboxPath}/drafts`, {
 			...content,
 			attachments: parseAttachments(attachments),
 			thread_id: threadId,
@@ -1034,23 +1075,29 @@ var InboxDrafts = class {
 		}, options);
 	}
 	async get(options, requestOptions = {}) {
-		const { inboxId, draftId } = options;
-		return this.resend.get(`/inboxes/${inboxId}/drafts/${draftId}`, requestOptions);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.get(`${inboxPath}/drafts/${options.draftId}`, requestOptions);
 	}
 	async update(options, requestOptions = {}) {
-		const { inboxId, draftId, attachments, ...content } = options;
-		return this.resend.patch(`/inboxes/${inboxId}/drafts/${draftId}`, {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { inboxId, emailAddress, draftId, attachments, ...content } = options;
+		return this.resend.patch(`${inboxPath}/drafts/${draftId}`, {
 			...content,
 			attachments: attachments === null ? null : parseAttachments(attachments)
 		}, requestOptions);
 	}
 	async remove(options, requestOptions = {}) {
-		const { inboxId, draftId } = options;
-		return this.resend.delete(`/inboxes/${inboxId}/drafts/${draftId}`, void 0, requestOptions);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.delete(`${inboxPath}/drafts/${options.draftId}`, void 0, requestOptions);
 	}
 	async send(payload, options = {}) {
-		const { inboxId, draftId, headers } = payload;
-		return this.resend.post(`/inboxes/${inboxId}/drafts/${draftId}/send`, headers ? { headers } : void 0, options);
+		const inboxPath = buildInboxPath(payload);
+		if (!inboxPath) return missingInboxError();
+		const { draftId, headers } = payload;
+		return this.resend.post(`${inboxPath}/drafts/${draftId}/send`, headers ? { headers } : void 0, options);
 	}
 };
 //#endregion
@@ -1060,25 +1107,32 @@ var InboxLabels = class {
 		this.resend = resend;
 	}
 	async list(options, requestOptions = {}) {
-		return this.resend.get(`/inboxes/${options.inboxId}/labels`, requestOptions);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.get(`${inboxPath}/labels`, requestOptions);
 	}
 	async create(payload, options = {}) {
-		const { inboxId, name, color } = payload;
-		return this.resend.post(`/inboxes/${inboxId}/labels`, {
+		const inboxPath = buildInboxPath(payload);
+		if (!inboxPath) return missingInboxError();
+		const { name, color } = payload;
+		return this.resend.post(`${inboxPath}/labels`, {
 			name,
 			color
 		}, options);
 	}
 	async update(options, requestOptions = {}) {
-		const { inboxId, labelId, name, color } = options;
-		return this.resend.patch(`/inboxes/${inboxId}/labels/${labelId}`, {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { labelId, name, color } = options;
+		return this.resend.patch(`${inboxPath}/labels/${labelId}`, {
 			name,
 			color
 		}, requestOptions);
 	}
 	async remove(options, requestOptions = {}) {
-		const { inboxId, labelId } = options;
-		return this.resend.delete(`/inboxes/${inboxId}/labels/${labelId}`, void 0, requestOptions);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.delete(`${inboxPath}/labels/${options.labelId}`, void 0, requestOptions);
 	}
 };
 //#endregion
@@ -1088,17 +1142,23 @@ var InboxThreadEmails = class {
 		this.resend = resend;
 	}
 	async list(options, requestOptions = {}) {
-		const { inboxId, threadId, ...pagination } = options;
-		const url = buildPaginationUrl(`/inboxes/${inboxId}/threads/${threadId}/emails`, pagination);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { inboxId, emailAddress, threadId, ...pagination } = options;
+		const url = buildPaginationUrl(`${inboxPath}/threads/${threadId}/emails`, pagination);
 		return this.resend.get(url, requestOptions);
 	}
 	async get(options, requestOptions = {}) {
-		const { inboxId, threadId, emailId } = options;
-		return this.resend.get(`/inboxes/${inboxId}/threads/${threadId}/emails/${emailId}`, requestOptions);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { threadId, emailId } = options;
+		return this.resend.get(`${inboxPath}/threads/${threadId}/emails/${emailId}`, requestOptions);
 	}
 	async reply(payload, options = {}) {
-		const { inboxId, threadId, emailId, cc, bcc, html, text, subject, replyAll, attachments, headers } = payload;
-		return this.resend.post(`/inboxes/${inboxId}/threads/${threadId}/emails/${emailId}/reply`, {
+		const inboxPath = buildInboxPath(payload);
+		if (!inboxPath) return missingInboxError();
+		const { threadId, emailId, cc, bcc, html, text, subject, replyAll, attachments, headers } = payload;
+		return this.resend.post(`${inboxPath}/threads/${threadId}/emails/${emailId}/reply`, {
 			cc,
 			bcc,
 			html,
@@ -1110,8 +1170,10 @@ var InboxThreadEmails = class {
 		}, options);
 	}
 	async forward(payload, options = {}) {
-		const { inboxId, threadId, emailId, to, cc, bcc, html, text, subject, attachments, headers } = payload;
-		return this.resend.post(`/inboxes/${inboxId}/threads/${threadId}/emails/${emailId}/forward`, {
+		const inboxPath = buildInboxPath(payload);
+		if (!inboxPath) return missingInboxError();
+		const { threadId, emailId, to, cc, bcc, html, text, subject, attachments, headers } = payload;
+		return this.resend.post(`${inboxPath}/threads/${threadId}/emails/${emailId}/forward`, {
 			to,
 			cc,
 			bcc,
@@ -1124,15 +1186,43 @@ var InboxThreadEmails = class {
 	}
 };
 //#endregion
+//#region src/inboxes/threads/labels/labels.ts
+var InboxThreadLabels = class {
+	constructor(resend) {
+		this.resend = resend;
+	}
+	async add(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { threadId, labels } = options;
+		return this.resend.post(`${inboxPath}/threads/${threadId}/labels`, { labels }, requestOptions);
+	}
+	async set(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { threadId, labels } = options;
+		return this.resend.put(`${inboxPath}/threads/${threadId}/labels`, { labels }, requestOptions);
+	}
+	async remove(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { threadId, labelId } = options;
+		return this.resend.delete(`${inboxPath}/threads/${threadId}/labels/${labelId}`, void 0, requestOptions);
+	}
+};
+//#endregion
 //#region src/inboxes/threads/threads.ts
 var InboxThreads = class {
 	constructor(resend) {
 		this.resend = resend;
 		this.emails = new InboxThreadEmails(resend);
+		this.labels = new InboxThreadLabels(resend);
 	}
 	async list(options, requestOptions = {}) {
-		const { inboxId, folders, labels, read, limit, after, before } = options;
-		const url = buildInboxCursorUrl(`/inboxes/${inboxId}/threads`, {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { folders, labels, read, limit, after, before } = options;
+		const url = buildInboxCursorUrl(`${inboxPath}/threads`, {
 			folders,
 			labels,
 			read,
@@ -1143,8 +1233,10 @@ var InboxThreads = class {
 		return this.resend.get(url, requestOptions);
 	}
 	async search(options, requestOptions = {}) {
-		const { inboxId, folders, labels, read, query, from, to, cc, bcc, hasAttachment, startDate, endDate, limit, after, before } = options;
-		const url = buildInboxCursorUrl(`/inboxes/${inboxId}/threads/search`, {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { folders, labels, read, query, from, to, cc, bcc, hasAttachment, startDate, endDate, limit, after, before } = options;
+		const url = buildInboxCursorUrl(`${inboxPath}/threads/search`, {
 			folders,
 			labels,
 			read,
@@ -1163,21 +1255,23 @@ var InboxThreads = class {
 		return this.resend.get(url, requestOptions);
 	}
 	async get(options, requestOptions = {}) {
-		const { inboxId, threadId } = options;
-		return this.resend.get(`/inboxes/${inboxId}/threads/${threadId}`, requestOptions);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.get(`${inboxPath}/threads/${options.threadId}`, requestOptions);
 	}
 	async update(options, requestOptions = {}) {
-		const { inboxId, threadId, read, folder, addLabelIds, removeLabelIds } = options;
-		return this.resend.patch(`/inboxes/${inboxId}/threads/${threadId}`, {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { threadId, read, folder } = options;
+		return this.resend.patch(`${inboxPath}/threads/${threadId}`, {
 			read,
-			folder,
-			add_label_ids: addLabelIds,
-			remove_label_ids: removeLabelIds
+			folder
 		}, requestOptions);
 	}
 	async remove(options, requestOptions = {}) {
-		const { inboxId, threadId } = options;
-		return this.resend.delete(`/inboxes/${inboxId}/threads/${threadId}`, void 0, requestOptions);
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.delete(`${inboxPath}/threads/${options.threadId}`, void 0, requestOptions);
 	}
 };
 //#endregion
@@ -1205,14 +1299,14 @@ var Inboxes = class {
 	async get(idOrEmail, requestOptions = {}) {
 		return this.resend.get(`/inboxes/${encodeURIComponent(idOrEmail)}`, requestOptions);
 	}
-	async update(id, payload, requestOptions = {}) {
-		return this.resend.patch(`/inboxes/${id}`, {
+	async update(idOrEmail, payload, requestOptions = {}) {
+		return this.resend.patch(`/inboxes/${encodeURIComponent(idOrEmail)}`, {
 			name: payload.name,
 			from_name: payload.fromName
 		}, requestOptions);
 	}
-	async remove(id, requestOptions = {}) {
-		return this.resend.delete(`/inboxes/${id}`, void 0, requestOptions);
+	async remove(idOrEmail, requestOptions = {}) {
+		return this.resend.delete(`/inboxes/${encodeURIComponent(idOrEmail)}`, void 0, requestOptions);
 	}
 };
 //#endregion
@@ -1359,10 +1453,10 @@ var ChainableTemplateResult = class {
 		return this.promise.then(onfulfilled, onrejected);
 	}
 	async publish(requestOptions = {}) {
-		const { data, error } = await this.promise;
+		const { data, error, headers } = await this.promise;
 		if (error) return {
 			data: null,
-			headers: null,
+			headers,
 			error
 		};
 		return this.publishFn(data.id, requestOptions);
@@ -1583,6 +1677,15 @@ var Resend = class {
 		});
 	}
 	async fetchRequest(path, options = {}) {
+		if (hasDotSegment(path)) return {
+			data: null,
+			error: {
+				message: "Path parameters cannot be `.` or `..`.",
+				statusCode: null,
+				name: "invalid_parameter"
+			},
+			headers: null
+		};
 		const { signal } = options;
 		try {
 			const response = await fetch(`${this.baseUrl}${path}`, options);
@@ -1712,4 +1815,4 @@ var Resend = class {
 	}
 };
 //#endregion
-export { INBOX_AGENT_ACTIONS, INBOX_MESSAGE_FOLDERS, MOVE_THREAD_FOLDERS, Resend };
+export { INBOX_AGENT_ACTIONS, INBOX_AGENT_TONES, INBOX_MESSAGE_FOLDERS, MOVE_THREAD_FOLDERS, Resend };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resend",
-  "version": "6.33.0",
+  "version": "6.34.0",
   "description": "Node.js library for the Resend API",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",

package/readme.md

@@ -190,6 +190,17 @@ const { data: threads } = await resend.inboxes.threads.list({
 });
 ```
 
+Every inbox method also accepts the inbox email address instead of its ID:
+
+```js
+const { data: threads } = await resend.inboxes.threads.list({
+  emailAddress: 'support@example.com',
+  folders: ['inbox'],
+});
+
+await resend.inboxes.update('support@example.com', { fromName: 'Support' });
+```
+
 ## License
 
 MIT License