resend 6.32.1 → 6.34.0

package/dist/index.mjs

@@ -1,7 +1,39 @@
 import PostalMime from "postal-mime";
 import { Webhook } from "standardwebhooks";
+//#region src/inboxes/agent/interfaces/agent.ts
+const INBOX_AGENT_ACTIONS = [
+	"draft_reply",
+	"forward_thread",
+	"add_labels",
+	"assign_thread",
+	"mark_as_spam",
+	"archive",
+	"move_to_trash"
+];
+const INBOX_AGENT_TONES = [
+	"concise_professional",
+	"concise_casual",
+	"expanded_professional",
+	"expanded_casual"
+];
+//#endregion
+//#region src/inboxes/interfaces/inbox.ts
+const INBOX_MESSAGE_FOLDERS = [
+	"inbox",
+	"archive",
+	"spam",
+	"sent",
+	"trash"
+];
+const MOVE_THREAD_FOLDERS = [
+	"inbox",
+	"archive",
+	"spam",
+	"trash"
+];
+//#endregion
 //#region package.json
-var version = "6.32.1";
+var version = "6.34.0";
 //#endregion
 //#region src/common/utils/build-pagination-query.ts
 function buildPaginationUrl(base, options) {
@@ -237,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);
@@ -326,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 {
@@ -955,6 +999,317 @@ 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 = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.get(`${inboxPath}/agent`, requestOptions);
+	}
+	async update(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { instructions, tone, actions } = options;
+		return this.resend.patch(`${inboxPath}/agent`, {
+			instructions,
+			tone,
+			actions
+		}, requestOptions);
+	}
+};
+//#endregion
+//#region src/inboxes/build-inbox-cursor-query.ts
+function buildInboxCursorUrl(base, options = {}) {
+	const searchParams = new URLSearchParams();
+	for (const [key, value] of Object.entries(options)) {
+		if (value === void 0) continue;
+		searchParams.set(key, Array.isArray(value) ? value.join(",") : String(value));
+	}
+	const queryString = searchParams.toString();
+	return queryString ? `${base}?${queryString}` : base;
+}
+//#endregion
+//#region src/inboxes/drafts/drafts.ts
+var InboxDrafts = class {
+	constructor(resend) {
+		this.resend = resend;
+	}
+	async list(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { limit, after, before } = options;
+		const url = buildInboxCursorUrl(`${inboxPath}/drafts`, {
+			limit,
+			after,
+			before
+		});
+		return this.resend.get(url, requestOptions);
+	}
+	async create(payload, options = {}) {
+		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,
+			reply_to_email_id: replyToEmailId
+		}, options);
+	}
+	async get(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.get(`${inboxPath}/drafts/${options.draftId}`, requestOptions);
+	}
+	async update(options, requestOptions = {}) {
+		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 inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.delete(`${inboxPath}/drafts/${options.draftId}`, void 0, requestOptions);
+	}
+	async send(payload, 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
+//#region src/inboxes/labels/labels.ts
+var InboxLabels = class {
+	constructor(resend) {
+		this.resend = resend;
+	}
+	async list(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.get(`${inboxPath}/labels`, requestOptions);
+	}
+	async create(payload, options = {}) {
+		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 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 inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.delete(`${inboxPath}/labels/${options.labelId}`, void 0, requestOptions);
+	}
+};
+//#endregion
+//#region src/inboxes/threads/emails/emails.ts
+var InboxThreadEmails = class {
+	constructor(resend) {
+		this.resend = resend;
+	}
+	async list(options, requestOptions = {}) {
+		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 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 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,
+			text,
+			subject,
+			reply_all: replyAll,
+			attachments: parseAttachments(attachments),
+			headers
+		}, options);
+	}
+	async forward(payload, options = {}) {
+		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,
+			html,
+			text,
+			subject,
+			attachments: parseAttachments(attachments),
+			headers
+		}, options);
+	}
+};
+//#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 inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { folders, labels, read, limit, after, before } = options;
+		const url = buildInboxCursorUrl(`${inboxPath}/threads`, {
+			folders,
+			labels,
+			read,
+			limit,
+			after,
+			before
+		});
+		return this.resend.get(url, requestOptions);
+	}
+	async search(options, requestOptions = {}) {
+		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,
+			query,
+			from,
+			to,
+			cc,
+			bcc,
+			has_attachment: hasAttachment,
+			start_date: startDate,
+			end_date: endDate,
+			limit,
+			after,
+			before
+		});
+		return this.resend.get(url, requestOptions);
+	}
+	async get(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.get(`${inboxPath}/threads/${options.threadId}`, requestOptions);
+	}
+	async update(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		const { threadId, read, folder } = options;
+		return this.resend.patch(`${inboxPath}/threads/${threadId}`, {
+			read,
+			folder
+		}, requestOptions);
+	}
+	async remove(options, requestOptions = {}) {
+		const inboxPath = buildInboxPath(options);
+		if (!inboxPath) return missingInboxError();
+		return this.resend.delete(`${inboxPath}/threads/${options.threadId}`, void 0, requestOptions);
+	}
+};
+//#endregion
+//#region src/inboxes/inboxes.ts
+var Inboxes = class {
+	constructor(resend) {
+		this.resend = resend;
+		this.threads = new InboxThreads(resend);
+		this.labels = new InboxLabels(resend);
+		this.drafts = new InboxDrafts(resend);
+		this.agent = new InboxAgent(resend);
+	}
+	async create(payload, options = {}) {
+		return this.resend.post("/inboxes", {
+			email_address: payload.emailAddress,
+			name: payload.name,
+			forwarding: payload.forwarding,
+			from_name: payload.fromName
+		}, options);
+	}
+	async list(options = {}, requestOptions = {}) {
+		const url = buildPaginationUrl("/inboxes", options);
+		return this.resend.get(url, requestOptions);
+	}
+	async get(idOrEmail, requestOptions = {}) {
+		return this.resend.get(`/inboxes/${encodeURIComponent(idOrEmail)}`, requestOptions);
+	}
+	async update(idOrEmail, payload, requestOptions = {}) {
+		return this.resend.patch(`/inboxes/${encodeURIComponent(idOrEmail)}`, {
+			name: payload.name,
+			from_name: payload.fromName
+		}, requestOptions);
+	}
+	async remove(idOrEmail, requestOptions = {}) {
+		return this.resend.delete(`/inboxes/${encodeURIComponent(idOrEmail)}`, void 0, requestOptions);
+	}
+};
+//#endregion
 //#region src/logs/logs.ts
 var Logs = class {
 	constructor(resend) {
@@ -1098,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);
@@ -1294,6 +1649,7 @@ var Resend = class {
 		this.domains = new Domains(this);
 		this.emails = new Emails(this);
 		this.events = new Events$1(this);
+		this.inboxes = new Inboxes(this);
 		this.logs = new Logs(this);
 		this.oauthGrants = new OAuthGrants(this);
 		this.suppressions = new Suppressions(this);
@@ -1321,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);
@@ -1450,4 +1815,4 @@ var Resend = class {
 	}
 };
 //#endregion
-export { 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.32.1",
+  "version": "6.34.0",
   "description": "Node.js library for the Resend API",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",

package/readme.md

@@ -174,6 +174,33 @@ await resend.templates
   .publish({ signal });
 ```
 
+## Inboxes
+
+Create an inbox and list its threads:
+
+```js
+const { data: inbox } = await resend.inboxes.create({
+  emailAddress: 'support@example.com',
+  name: 'support',
+});
+
+const { data: threads } = await resend.inboxes.threads.list({
+  inboxId: inbox.id,
+  folders: ['inbox'],
+});
+```
+
+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