@x12i/email-service 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/send.js ADDED
@@ -0,0 +1,151 @@
1
+ import { createHash } from "node:crypto";
2
+ import nodemailer from "nodemailer";
3
+ import { smtpAddress } from "./address.js";
4
+ import { CloudflareError } from "./api.js";
5
+ export const classes = ["system", "notification", "transactional", "conversational"];
6
+ export const MAX_RECIPIENTS = 50;
7
+ const reject = (code) => ({ outcome: "rejected", permanent: true, code });
8
+ const unknown = (reason) => ({ outcome: "unknown", reason });
9
+ const normalize = (v) => v.toLowerCase();
10
+ const unsafe = (v) => /[\x00-\x1f\x7f]/.test(v);
11
+ const ref = /^(?:<[^<>\s]+>)(?: +<[^<>\s]+>)*$/;
12
+ const composer = nodemailer.createTransport({
13
+ streamTransport: true, buffer: true, newline: "windows", disableFileAccess: true, disableUrlAccess: true,
14
+ });
15
+ export function outbound(cfg, api, recordEvidence, checkSend) {
16
+ return async function send(req) {
17
+ if (!cfg.sending || !api || req.secretRef !== cfg.secretRef)
18
+ return reject("CF_SENDER_UNAVAILABLE");
19
+ if (!classes.some((c) => c === req.class))
20
+ return reject("CF_CLASS_UNSUPPORTED");
21
+ if (smtpAddress(req.from)?.domain !== cfg.sending.domain)
22
+ return reject("CF_SENDER_NOT_PERMITTED");
23
+ const recipients = [...req.to, ...req.cc, ...req.bcc];
24
+ const addresses = new Set(recipients.map(normalize));
25
+ if (!addresses.size || addresses.size !== recipients.length || addresses.size > MAX_RECIPIENTS ||
26
+ recipients.some((v) => !smtpAddress(v)) || (req.replyTo !== null && !smtpAddress(req.replyTo))) {
27
+ return reject("CF_RECIPIENTS_INVALID");
28
+ }
29
+ const refs = new Map(Object.entries(req.recipientRefs).map(([address, id]) => [normalize(address), id]));
30
+ if (recipients.some((v) => !refs.get(normalize(v))))
31
+ return reject("CF_RECIPIENT_REFS_MISSING");
32
+ const names = new Map(Object.entries(req.recipientNames ?? {}).map(([address, name]) => [normalize(address), name]));
33
+ if ([...names].some(([address, name]) => !addresses.has(address) || !name || name.length > 255 || unsafe(name)))
34
+ return reject("CF_MESSAGE_INVALID");
35
+ if (req.subject.length > 998 || req.fromName.length > 255 || unsafe(req.subject) || unsafe(req.fromName) ||
36
+ req.attachments.some((a) => !a.name || a.name.length > 255 || unsafe(a.name) ||
37
+ !/^[\w!#$&^.+-]+\/[\w!#$&^.+-]+$/.test(a.mime)))
38
+ return reject("CF_MESSAGE_INVALID");
39
+ if (req.calendar && (!["REQUEST", "REPLY", "CANCEL", "PUBLISH"].includes(req.calendar.method) || !req.calendar.content.byteLength))
40
+ return reject("CF_CALENDAR_INVALID");
41
+ if (req.attachments.length > 100 ||
42
+ req.attachments.reduce((sum, a) => sum + a.bytes.byteLength, Buffer.byteLength(req.text) + Buffer.byteLength(req.html ?? "") + (req.calendar?.content.byteLength ?? 0)) > cfg.maxMessageBytes) {
43
+ return reject("CF_MESSAGE_TOO_LARGE");
44
+ }
45
+ const threading = {};
46
+ const headerNames = { "message-id": "messageId", "in-reply-to": "inReplyTo", "references": "references" };
47
+ let headerBytes = 0;
48
+ for (const [name, value] of Object.entries(req.headers)) {
49
+ const key = headerNames[name.toLowerCase()];
50
+ headerBytes += Buffer.byteLength(name) + Buffer.byteLength(value) + 4;
51
+ if (!key || threading[key] || unsafe(value) || !ref.test(value) ||
52
+ (key !== "references" && value.includes(" ")) || headerBytes > 16_000)
53
+ return reject("CF_HEADERS_INVALID");
54
+ threading[key] = value;
55
+ }
56
+ let mime;
57
+ try {
58
+ const composed = await composer.sendMail({
59
+ from: { address: req.from, name: req.fromName },
60
+ to: req.to.length ? req.to.map((address) => ({ address, name: names.get(normalize(address)) ?? "" })) : undefined,
61
+ cc: req.cc.length ? req.cc.map((address) => ({ address, name: names.get(normalize(address)) ?? "" })) : undefined,
62
+ // Bcc is carried only in the Cloudflare API's SMTP envelope, never in MIME.
63
+ ...(req.replyTo && { replyTo: { address: req.replyTo, name: "" } }),
64
+ subject: req.subject,
65
+ text: req.text,
66
+ ...(req.html !== null && { html: req.html }),
67
+ ...threading,
68
+ attachments: req.attachments.map((a) => ({
69
+ filename: a.name, content: Buffer.from(a.bytes), contentType: a.mime, contentDisposition: "attachment",
70
+ })),
71
+ ...(req.calendar && { icalEvent: { method: req.calendar.method, content: Buffer.from(req.calendar.content) } }),
72
+ });
73
+ if (!Buffer.isBuffer(composed.message))
74
+ return reject("CF_MIME_INVALID");
75
+ mime = composed.message;
76
+ }
77
+ catch {
78
+ return reject("CF_MIME_INVALID");
79
+ }
80
+ if (mime.byteLength > cfg.maxMessageBytes)
81
+ return reject("CF_MESSAGE_TOO_LARGE");
82
+ // Recheck the sending domain and any recipient restrictions before dispatch.
83
+ try {
84
+ const rejection = await checkSend(recipients);
85
+ if (rejection)
86
+ return reject(rejection);
87
+ }
88
+ catch {
89
+ return { outcome: "rejected", permanent: false, code: "CF_SENDER_CHECK_UNAVAILABLE" };
90
+ }
91
+ let result;
92
+ try {
93
+ result = await api.result(`/accounts/${cfg.accountId}/email/sending/send_raw`, "POST", {
94
+ from: req.from, recipients, mime_message: mime.toString("utf8"),
95
+ });
96
+ }
97
+ catch (error) {
98
+ if (error instanceof CloudflareError && error.explicitFailure) {
99
+ if (error.status === 429)
100
+ return {
101
+ outcome: "rejected", permanent: false, code: "CF_RATE_LIMITED",
102
+ ...(error.retryAfterSeconds !== undefined && { retryAfterSeconds: error.retryAfterSeconds }),
103
+ };
104
+ if ([400, 401, 403, 413, 422].includes(error.status))
105
+ return reject(`CF_SEND_${error.status}`);
106
+ }
107
+ return unknown("CF_ACCEPTANCE_UNKNOWN");
108
+ }
109
+ if (!result || typeof result.message_id !== "string" || !result.message_id || result.message_id.length > 512 ||
110
+ unsafe(result.message_id))
111
+ return unknown("CF_RESPONSE_INVALID");
112
+ const groups = [
113
+ [result.queued, null],
114
+ [result.delivered, "delivered"],
115
+ [result.permanent_bounces, "bounced"],
116
+ [result.suppressed_recipients ?? [], "rejected"],
117
+ ];
118
+ const unseen = new Set(addresses);
119
+ const events = [];
120
+ const at = new Date().toISOString();
121
+ for (const [group, type] of groups) {
122
+ if (!Array.isArray(group))
123
+ return unknown("CF_RESPONSE_INVALID");
124
+ for (const address of group) {
125
+ if (typeof address !== "string" || !unseen.delete(normalize(address)))
126
+ return unknown("CF_RESPONSE_INVALID");
127
+ const id = refs.get(normalize(address));
128
+ if (type)
129
+ events.push({
130
+ eventId: `cf_${createHash("sha256").update(JSON.stringify([result.message_id, id, type])).digest("hex")}`,
131
+ correlationId: id, at, type, ...(type === "bounced" && { bounceType: "hard" }),
132
+ });
133
+ }
134
+ }
135
+ if (unseen.size)
136
+ return unknown("CF_RESPONSE_INCOMPLETE");
137
+ // Keep per-recipient outcomes even when an application manages its own evidence store.
138
+ if (events.length) {
139
+ if (!recordEvidence)
140
+ return { outcome: "accepted", providerRef: result.message_id, evidence: events };
141
+ try {
142
+ await recordEvidence(events);
143
+ }
144
+ catch {
145
+ return unknown("CF_EVIDENCE_UNAVAILABLE");
146
+ }
147
+ }
148
+ return { outcome: "accepted", providerRef: result.message_id };
149
+ };
150
+ }
151
+ //# sourceMappingURL=send.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"send.js","sourceRoot":"","sources":["../src/send.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ export { domainName, MAX_MESSAGE_BYTES, smtpAddress } from "./address.js";
2
+ export { DELIVERY_ID_PATTERN, MAX_RELAY_PAGE_SIZE, RELAY_PATH, RELAY_TOKEN_PATTERN, relayCursor, type RelayPage } from "./relay.js";
3
+ /** The portion of Cloudflare's email event this handler needs. */
4
+ export interface CloudflareEmailMessage {
5
+ readonly from: string;
6
+ readonly to: string;
7
+ readonly raw: ReadableStream<Uint8Array>;
8
+ readonly rawSize: number;
9
+ setReject(reason: string): void;
10
+ }
11
+ export interface InboundDelivery {
12
+ /** Stable for a replay with the same envelope and raw message bytes. */
13
+ readonly id: string;
14
+ readonly envelope: {
15
+ readonly from: string;
16
+ readonly to: string;
17
+ };
18
+ readonly raw: Uint8Array<ArrayBuffer>;
19
+ }
20
+ export type InboundDisposition = "stored" | "recipient_unknown" | "too_large" | "could_not_place";
21
+ export interface InboundOptions {
22
+ allowedDomains: readonly string[];
23
+ maxMessageBytes?: number;
24
+ /** Return "stored" only after a durable write. Use delivery.id as the idempotency key. */
25
+ deliver(delivery: InboundDelivery): Promise<InboundDisposition>;
26
+ }
27
+ /** Validate the SMTP envelope and wait for the application's durable receipt. */
28
+ export declare function receiveCloudflareEmail(message: CloudflareEmailMessage, options: InboundOptions): Promise<void>;
package/dist/worker.js ADDED
@@ -0,0 +1,44 @@
1
+ import { domainName, MAX_MESSAGE_BYTES, smtpAddress } from "./address.js";
2
+ import { readExact } from "./bytes.js";
3
+ export { domainName, MAX_MESSAGE_BYTES, smtpAddress } from "./address.js";
4
+ export { DELIVERY_ID_PATTERN, MAX_RELAY_PAGE_SIZE, RELAY_PATH, RELAY_TOKEN_PATTERN, relayCursor } from "./relay.js";
5
+ const hex = (bytes) => Array.from(new Uint8Array(bytes), (byte) => byte.toString(16).padStart(2, "0")).join("");
6
+ async function deliveryId(from, to, raw) {
7
+ const rawHash = hex(await crypto.subtle.digest("SHA-256", raw));
8
+ const key = new TextEncoder().encode(JSON.stringify([from.toLowerCase(), to.toLowerCase(), rawHash]));
9
+ return `cf_${hex(await crypto.subtle.digest("SHA-256", key))}`;
10
+ }
11
+ /** Validate the SMTP envelope and wait for the application's durable receipt. */
12
+ export async function receiveCloudflareEmail(message, options) {
13
+ const domains = options.allowedDomains.map((domain) => domainName(domain.trim()));
14
+ const limit = options.maxMessageBytes ?? MAX_MESSAGE_BYTES;
15
+ if (!domains.length || domains.some((domain) => !domain) ||
16
+ !Number.isSafeInteger(limit) || limit < 1 || limit > MAX_MESSAGE_BYTES) {
17
+ throw new Error("Cloudflare email ingress is not configured.");
18
+ }
19
+ const to = smtpAddress(message.to);
20
+ if (!to || !domains.includes(to.domain))
21
+ return message.setReject("Recipient domain is not served here");
22
+ const from = message.from === "" || message.from === "<>" ? "<>" : smtpAddress(message.from)?.address;
23
+ if (!from)
24
+ return message.setReject("Unsupported SMTP sender address");
25
+ if (!Number.isSafeInteger(message.rawSize) || message.rawSize < 1 || message.rawSize > limit) {
26
+ return message.setReject("Message size is outside the allowed range");
27
+ }
28
+ const raw = await readExact(message.raw, message.rawSize);
29
+ if (!raw)
30
+ return message.setReject("Invalid message size");
31
+ const result = await options.deliver({
32
+ id: await deliveryId(from, to.address, raw),
33
+ envelope: { from, to: to.address },
34
+ raw,
35
+ });
36
+ switch (result) {
37
+ case "stored": return;
38
+ case "recipient_unknown": return message.setReject("Recipient is not served here");
39
+ case "too_large": return message.setReject("Message is too large");
40
+ case "could_not_place": return message.setReject("Mail could not be placed");
41
+ default: throw new Error("Mail ingress returned an invalid disposition.");
42
+ }
43
+ }
44
+ //# sourceMappingURL=worker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"worker.js","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,29 @@
1
1
  {
2
2
  "name": "@x12i/email-service",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.0",
4
+ "description": "Send email through Cloudflare and accept Cloudflare Email Routing deliveries into your own mail store.",
5
+ "license": "UNLICENSED",
6
+ "type": "module",
7
+ "engines": { "node": ">=22.13.0" },
8
+ "files": ["dist"],
9
+ "exports": {
10
+ ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" },
11
+ "./worker": { "types": "./dist/worker.d.ts", "import": "./dist/worker.js" }
12
+ },
13
+ "repository": {
14
+ "type": "git",
15
+ "url": "git+ssh://git@github.com/x12i/email-service.git"
16
+ },
17
+ "homepage": "https://www.npmjs.com/package/@x12i/email-service",
18
+ "bugs": {
19
+ "url": "https://github.com/x12i/email-service/issues"
20
+ },
21
+ "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
22
+ "scripts": { "prepack": "tsc -b" },
23
+ "dependencies": {
24
+ "nodemailer": "10.4.0"
25
+ },
26
+ "devDependencies": {
27
+ "@types/nodemailer": "^8.0.2"
28
+ }
29
+ }