@agentcomms/resend 0.15.1 → 0.16.0

package/dist/index.mjs

@@ -1,5 +1,204 @@
-import { At as RESEND_API_ORIGIN, Dt as PACKAGE_NAME, Mt as ROUTES, Nt as VERSION, Ot as RESEND_CALLER, jt as RESEND_DOWNLOAD_ORIGIN, kt as REFUSED } from "./send-BcM5UKMt.mjs";
-import { t as createResendMcpServer } from "./server-EV5f6d28.mjs";
+import { Bt as RESEND_DOWNLOAD_ORIGIN, Et as stripInvisible, H as CommsError, Ht as VERSION, It as PACKAGE_NAME, Lt as RESEND_CALLER, N as resendRequest, P as ResendContext, Rt as REFUSED, Vt as ROUTES, b as readBody, ft as neutralise, h as resendId, pt as newBoundary, v as addressesOf, y as attachmentRisks, z as keyPermissionOf, zt as RESEND_API_ORIGIN } from "./send-BwyJM23a.mjs";
+import { t as createResendMcpServer } from "./server-BFAo5PpV.mjs";
+//#region src/operations/events.ts
+const BODY_LIMIT = 2e4;
+const STATUS = /* @__PURE__ */ new Set([
+	"scheduled",
+	"sent",
+	"delivered",
+	"delivery_delayed",
+	"bounced",
+	"complained",
+	"opened",
+	"clicked",
+	"failed",
+	"suppressed",
+	"canceled",
+	"queued"
+]);
+/**
+* Converts the already-capped body produced by the Resend reader into the
+* event representation.  `bodyTruncated` is that reader's fact: this layer
+* must not recompute it from Unicode code points.
+*/
+function normaliseResendEventBody(value, bodyTruncated) {
+	let body = value;
+	if (bodyTruncated && body.charCodeAt(body.length - 1) >= 55296 && body.charCodeAt(body.length - 1) <= 56319) body = body.slice(0, -1);
+	for (let index = 0; index < body.length; index += 1) {
+		const code = body.charCodeAt(index);
+		if (code >= 55296 && code <= 56319) {
+			const next = body.charCodeAt(index + 1);
+			if (!(next >= 56320 && next <= 57343)) throw new CommsError("BAD_DATA", "Resend body is not a Unicode scalar sequence");
+			index += 1;
+		} else if (code >= 56320 && code <= 57343) throw new CommsError("BAD_DATA", "Resend body is not a Unicode scalar sequence");
+	}
+	if ([...body].length > BODY_LIMIT) throw new CommsError("BAD_DATA", "Resend body exceeds the Unicode code-point limit");
+	return {
+		body,
+		bodyTruncated
+	};
+}
+function text(value) {
+	return typeof value === "string" ? value : null;
+}
+function cleanText(value) {
+	return neutralise(stripInvisible(typeof value === "string" ? value : "").text).text;
+}
+function cleanAddress(entry) {
+	return {
+		address: cleanText(entry.address),
+		name: entry.name === "" ? null : cleanText(entry.name)
+	};
+}
+function unwrapReadBody(value) {
+	const firstNewline = value.indexOf("\n");
+	const finalNewline = value.lastIndexOf("\n<");
+	if (firstNewline < 0 || finalNewline <= firstNewline) throw new CommsError("BAD_DATA", "Resend read body did not have its expected untrusted-content envelope");
+	return value.slice(firstNewline + 1, finalNewline);
+}
+function cleanBody(entry, emailId) {
+	const read = readBody(text(entry.html), text(entry.text), {
+		account: "resend-event-reader",
+		id: emailId,
+		boundary: newBoundary()
+	});
+	return normaliseResendEventBody(unwrapReadBody(read.body), read.truncated);
+}
+function receivedCandidate(entry) {
+	const emailId = resendId(entry.id, "received email id");
+	const receivedAt = text(entry.created_at);
+	if (receivedAt === null) throw new CommsError("BAD_DATA", "Resend received detail has no received time");
+	const from = addressesOf(entry.from)[0];
+	const attachments = (Array.isArray(entry.attachments) ? entry.attachments : []).map((value) => {
+		const attachment = value;
+		const rawFilename = typeof attachment.filename === "string" ? attachment.filename : "";
+		const filename = cleanText(rawFilename);
+		return {
+			id: cleanText(attachment.id),
+			filename,
+			contentType: text(attachment.content_type) === null ? null : cleanText(attachment.content_type),
+			size: typeof attachment.size === "number" && Number.isSafeInteger(attachment.size) ? attachment.size : null,
+			inline: attachment.content_disposition === "inline",
+			riskFlags: [...new Set(attachmentRisks(rawFilename))].sort()
+		};
+	});
+	const auth = entry.authentication ?? null;
+	const body = cleanBody(entry, emailId);
+	return {
+		emailId,
+		receivedAt,
+		subject: cleanText(entry.subject),
+		body: body.body,
+		bodyTruncated: body.bodyTruncated,
+		attachments,
+		attachmentCount: attachments.length,
+		from: from === void 0 ? null : cleanAddress(from),
+		replyTo: addressesOf(entry.reply_to).map(cleanAddress),
+		to: addressesOf(entry.to).map((entry) => cleanText(entry.address)),
+		cc: addressesOf(entry.cc).map((entry) => cleanText(entry.address)),
+		receivedFor: addressesOf(entry.received_for).map((entry) => cleanText(entry.address)),
+		messageId: text(entry.message_id) === null ? null : cleanText(entry.message_id),
+		authentication: auth ? {
+			spf: text(auth.spf),
+			dkim: text(auth.dkim),
+			dmarc: text(auth.dmarc),
+			evaluatedBy: "resend"
+		} : {
+			spf: null,
+			dkim: null,
+			dmarc: null,
+			evaluatedBy: null
+		}
+	};
+}
+function sentItem(entry) {
+	const id = resendId(entry.id, "sent email id");
+	const lastEvent = text(entry.last_event);
+	if (lastEvent === null || !STATUS.has(lastEvent)) throw new CommsError("BAD_DATA", "Resend sent detail has an unsupported status");
+	const from = addressesOf(entry.from)[0];
+	return {
+		id,
+		lastEvent,
+		from: from === void 0 ? null : cleanAddress(from),
+		to: addressesOf(entry.to).map((address) => cleanText(address.address)),
+		cc: addressesOf(entry.cc).map((address) => cleanText(address.address)),
+		bcc: addressesOf(entry.bcc).map((address) => cleanText(address.address)),
+		subject: cleanText(entry.subject),
+		createdAt: text(entry.created_at),
+		scheduledAt: text(entry.scheduled_at),
+		messageId: text(entry.message_id) === null ? null : cleanText(entry.message_id)
+	};
+}
+async function readable(context, name, accountId, work) {
+	const named = accountId === void 0 ? await context.accounts.require(name) : await context.accounts.findById(accountId) ?? (() => {
+		throw new CommsError("CONFIG", "the Resend event account identity changed before its provider call", { details: {
+			reason: "ACCOUNT_CHANGED",
+			accountId
+		} });
+	})();
+	if (accountId !== void 0 && named.account.id !== accountId) throw new CommsError("CONFIG", "the Resend event account identity changed before its provider call", { details: {
+		reason: "ACCOUNT_CHANGED",
+		accountId
+	} });
+	if (keyPermissionOf(named.account) !== "full_access") throw new CommsError("SOURCE_UNAVAILABLE", "Resend event polling requires a full-access key");
+	return work(await context.transport(named));
+}
+/** A structural read adapter: no permit, no sender, and each request is labelled background-event. */
+function createResendEventReader(context, account, accountId) {
+	return {
+		async listReceived(after) {
+			return readable(context, account, accountId, async (transport) => {
+				const page = await resendRequest(transport, "GET", "/emails/receiving", {
+					query: {
+						limit: 100,
+						after
+					},
+					throttlePriority: "background-event"
+				});
+				const emails = (page.data ?? []).map((entry) => ({ id: resendId(entry.id, "received email id") }));
+				return {
+					emails,
+					next: page.has_more === true ? emails.at(-1)?.id ?? null : null
+				};
+			});
+		},
+		async getReceived(id) {
+			const emailId = resendId(id, "received email id");
+			try {
+				return await readable(context, account, accountId, async (transport) => {
+					return {
+						kind: "candidate",
+						candidate: receivedCandidate(await resendRequest(transport, "GET", `/emails/receiving/${emailId}`, { throttlePriority: "background-event" }))
+					};
+				});
+			} catch (error) {
+				if (error instanceof CommsError && error.code === "NOT_FOUND") return { kind: "vanished" };
+				throw error;
+			}
+		},
+		async listSent(after) {
+			return readable(context, account, accountId, async (transport) => {
+				const page = await resendRequest(transport, "GET", "/emails", {
+					query: {
+						limit: 100,
+						after
+					},
+					throttlePriority: "background-event"
+				});
+				const emails = (page.data ?? []).map(sentItem);
+				return {
+					emails,
+					next: page.has_more === true ? emails.at(-1)?.id ?? null : null
+				};
+			});
+		}
+	};
+}
+/** Opens Resend's guarded, read-only context for the held event owner. */
+function createResendEventReaderForPaths(input) {
+	return createResendEventReader(new ResendContext({ pathOverrides: input.pathOverrides }), input.account, input.accountId);
+}
+//#endregion
 //#region src/index.ts
 /**
 * The library entry of `@agentcomms/resend`.
@@ -12,4 +211,4 @@ import { t as createResendMcpServer } from "./server-EV5f6d28.mjs";
 * call grants nothing.
 */
 //#endregion
-export { PACKAGE_NAME, REFUSED, RESEND_API_ORIGIN, RESEND_CALLER, RESEND_DOWNLOAD_ORIGIN, ROUTES, VERSION, createResendMcpServer };
+export { PACKAGE_NAME, REFUSED, RESEND_API_ORIGIN, RESEND_CALLER, RESEND_DOWNLOAD_ORIGIN, ROUTES, VERSION, createResendEventReader, createResendEventReaderForPaths, createResendMcpServer, normaliseResendEventBody };