Email for professionals and teams
import { forwardedMarker, getAccountForwardingDestination, isForwardedMarkerValid, MAILFLARE_FORWARDED_HEADER } from "@/lib/email/account-forwarding";
import { resolveIncomingMail } from "@/lib/email/incoming";
import { inboundStorageKey } from "@/lib/email/inbound-id";
import type { InboundQueueMessage } from "@/lib/email/inbound";
import type { IntakeActions, IntakeInput, IntakeResult } from "@/lib/email/intake-types";
/**
* What the Worker `email` handler does, for runtimes that hand us the whole
* message as bytes (an SMTP listener, or the Cloudflare relay webhook):
* resolve domain rules, act on reject and forward through the supplied
* callbacks, then store the raw MIME and enqueue it for parsing.
*/
export async function intakeIncomingMail(env: CloudflareEnv, input: IntakeInput, actions: IntakeActions): Promise<IntakeResult> {
const alreadyForwarded = await isForwardedMarkerValid(env, input.headers[MAILFLARE_FORWARDED_HEADER.toLowerCase()] ?? input.headers[MAILFLARE_FORWARDED_HEADER]);
const marker = { [MAILFLARE_FORWARDED_HEADER]: await forwardedMarker(env) };
const decision = await resolveIncomingMail(env, input.from, input.to, {
subject: input.headers.subject,
alreadyForwarded,
});
if (decision?.action === "reject") {
const reason = decision.rejectReason ?? "Message rejected by routing rule";
await actions.reject?.(reason);
return { action: "reject", reason };
}
let forwardedTo: string | null = null;
if (decision?.action === "forward" && decision.forwardTo) {
const forwarded = await actions.forward?.(decision.forwardTo, marker);
if (forwarded) forwardedTo = decision.forwardTo;
if (forwarded && !decision.keepCopy) return { action: "forward", forwardedTo };
}
if (!alreadyForwarded) {
const destination = await getAccountForwardingDestination(env, input.to);
if (destination) await actions.forward?.(destination, marker);
}
// A relay retry replays the same bytes, so key the object on a content hash
// (scoped by mailbox): the consumer dedupes by `(mailboxId, rawR2Key)`.
const rawR2Key = await inboundStorageKey(input.raw, decision?.mailbox?.mailboxId);
await env.BUCKET.put(rawR2Key, input.raw, {
httpMetadata: { contentType: "message/rfc822" },
customMetadata: { from: input.from, to: input.to },
});
const payload: InboundQueueMessage = { from: input.from, to: input.to, rawR2Key, headers: input.headers, verdicts: input.verdicts, senderIp: input.senderIp };
await env.INBOUND_QUEUE.send(payload);
return { action: "store", rawR2Key, forwardedTo };
}