npm - @c9up/rover - Versions diffs - 0.1.3 - Mend

@c9up/rover 0.1.3

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.

Files changed (119) hide show

package/LICENSE +21 -0
package/README.md +91 -0
package/dist/BaseMail.d.ts +28 -0
package/dist/BaseMail.d.ts.map +1 -0
package/dist/BaseMail.js +42 -0
package/dist/BaseMail.js.map +1 -0
package/dist/Mail.d.ts +166 -0
package/dist/Mail.d.ts.map +1 -0
package/dist/Mail.js +451 -0
package/dist/Mail.js.map +1 -0
package/dist/MessageBuilder.d.ts +38 -0
package/dist/MessageBuilder.d.ts.map +1 -0
package/dist/MessageBuilder.js +70 -0
package/dist/MessageBuilder.js.map +1 -0
package/dist/RoverError.d.ts +30 -0
package/dist/RoverError.d.ts.map +1 -0
package/dist/RoverError.js +33 -0
package/dist/RoverError.js.map +1 -0
package/dist/RoverProvider.d.ts +24 -0
package/dist/RoverProvider.d.ts.map +1 -0
package/dist/RoverProvider.js +51 -0
package/dist/RoverProvider.js.map +1 -0
package/dist/config.d.ts +4 -0
package/dist/config.d.ts.map +1 -0
package/dist/config.js +4 -0
package/dist/config.js.map +1 -0
package/dist/index.d.ts +9 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +7 -0
package/dist/index.js.map +1 -0
package/dist/queue/MailJob.d.ts +41 -0
package/dist/queue/MailJob.d.ts.map +1 -0
package/dist/queue/MailJob.js +75 -0
package/dist/queue/MailJob.js.map +1 -0
package/dist/retry.d.ts +20 -0
package/dist/retry.d.ts.map +1 -0
package/dist/retry.js +101 -0
package/dist/retry.js.map +1 -0
package/dist/services/main.d.ts +20 -0
package/dist/services/main.d.ts.map +1 -0
package/dist/services/main.js +33 -0
package/dist/services/main.js.map +1 -0
package/dist/templating/SimpleTemplate.d.ts +7 -0
package/dist/templating/SimpleTemplate.d.ts.map +1 -0
package/dist/templating/SimpleTemplate.js +192 -0
package/dist/templating/SimpleTemplate.js.map +1 -0
package/dist/templating/loadNapi.d.ts +21 -0
package/dist/templating/loadNapi.d.ts.map +1 -0
package/dist/templating/loadNapi.js +115 -0
package/dist/templating/loadNapi.js.map +1 -0
package/dist/testing/FakeMail.d.ts +31 -0
package/dist/testing/FakeMail.d.ts.map +1 -0
package/dist/testing/FakeMail.js +90 -0
package/dist/testing/FakeMail.js.map +1 -0
package/dist/transports/MailgunTransport.d.ts +7 -0
package/dist/transports/MailgunTransport.d.ts.map +1 -0
package/dist/transports/MailgunTransport.js +149 -0
package/dist/transports/MailgunTransport.js.map +1 -0
package/dist/transports/ResendTransport.d.ts +7 -0
package/dist/transports/ResendTransport.d.ts.map +1 -0
package/dist/transports/ResendTransport.js +111 -0
package/dist/transports/ResendTransport.js.map +1 -0
package/dist/transports/SendGridTransport.d.ts +7 -0
package/dist/transports/SendGridTransport.d.ts.map +1 -0
package/dist/transports/SendGridTransport.js +165 -0
package/dist/transports/SendGridTransport.js.map +1 -0
package/dist/transports/SesTransport.d.ts +7 -0
package/dist/transports/SesTransport.d.ts.map +1 -0
package/dist/transports/SesTransport.js +334 -0
package/dist/transports/SesTransport.js.map +1 -0
package/dist/transports/fetchError.d.ts +13 -0
package/dist/transports/fetchError.d.ts.map +1 -0
package/dist/transports/fetchError.js +35 -0
package/dist/transports/fetchError.js.map +1 -0
package/dist/webhooks/context.d.ts +35 -0
package/dist/webhooks/context.d.ts.map +1 -0
package/dist/webhooks/context.js +7 -0
package/dist/webhooks/context.js.map +1 -0
package/dist/webhooks/mailgun.d.ts +13 -0
package/dist/webhooks/mailgun.d.ts.map +1 -0
package/dist/webhooks/mailgun.js +102 -0
package/dist/webhooks/mailgun.js.map +1 -0
package/dist/webhooks/resend.d.ts +16 -0
package/dist/webhooks/resend.d.ts.map +1 -0
package/dist/webhooks/resend.js +121 -0
package/dist/webhooks/resend.js.map +1 -0
package/dist/webhooks/sendgrid.d.ts +13 -0
package/dist/webhooks/sendgrid.d.ts.map +1 -0
package/dist/webhooks/sendgrid.js +104 -0
package/dist/webhooks/sendgrid.js.map +1 -0
package/index.darwin-arm64.node +0 -0
package/index.darwin-x64.node +0 -0
package/index.linux-arm64-gnu.node +0 -0
package/index.linux-x64-gnu.node +0 -0
package/index.win32-x64-msvc.node +0 -0
package/package.json +97 -0
package/scripts/copy-napi.mjs +62 -0
package/src/BaseMail.ts +52 -0
package/src/Mail.ts +663 -0
package/src/MessageBuilder.ts +101 -0
package/src/RoverError.ts +44 -0
package/src/RoverProvider.ts +72 -0
package/src/config.ts +7 -0
package/src/index.ts +30 -0
package/src/queue/MailJob.ts +131 -0
package/src/retry.ts +135 -0
package/src/services/main.ts +41 -0
package/src/templating/SimpleTemplate.ts +240 -0
package/src/templating/loadNapi.ts +169 -0
package/src/testing/FakeMail.ts +112 -0
package/src/transports/MailgunTransport.ts +204 -0
package/src/transports/ResendTransport.ts +147 -0
package/src/transports/SendGridTransport.ts +246 -0
package/src/transports/SesTransport.ts +394 -0
package/src/transports/fetchError.ts +42 -0
package/src/webhooks/context.ts +41 -0
package/src/webhooks/mailgun.ts +134 -0
package/src/webhooks/resend.ts +164 -0
package/src/webhooks/sendgrid.ts +133 -0

package/dist/webhooks/resend.js ADDED Viewed

@@ -0,0 +1,121 @@
+import { Buffer } from "node:buffer";
+import { createHmac, timingSafeEqual } from "node:crypto";
+/**
+ * Parse a provider-supplied `created_at` into an epoch-ms timestamp,
+ * falling back to "now" for anything unparseable. Without the
+ * `Number.isFinite` guard, a malformed value like `"not-a-date"`
+ * yields `new Date(...).getTime()` === `NaN`, which then leaks into
+ * the `mail.*` event payload and breaks any consumer that sorts,
+ * persists, or numerically compares the timestamp.
+ */
+function parseTimestamp(raw) {
+    if (raw !== undefined && raw !== "") {
+        const t = new Date(raw).getTime();
+        if (Number.isFinite(t))
+            return t;
+    }
+    return Date.now();
+}
+/**
+ * Resend event → Rover event. Only map events that correspond to durable,
+ * decision-grade outcomes. `email.delivery_delayed` is intermediate (not a
+ * final failure) and `email.complained` is a deliverability signal (not a
+ * delivery failure) — both are dropped to keep the event bus signal-dense.
+ */
+const EVENT_MAP = {
+    "email.delivered": "mail.delivered",
+    "email.bounced": "mail.bounced",
+};
+export function createResendWebhookHandler(options) {
+    if (!options.secret) {
+        throw new Error("createResendWebhookHandler: secret is required for HMAC verification.");
+    }
+    const secretRaw = options.secret.startsWith("whsec_")
+        ? options.secret.slice(6)
+        : options.secret;
+    const keyBytes = Buffer.from(secretRaw, "base64");
+    const emitter = options.emitter;
+    const maxAgeSeconds = options.maxAgeSeconds ?? 300;
+    return async (ctx, _next) => {
+        const raw = await Promise.resolve(ctx.request.rawBody());
+        const id = ctx.request.header("svix-id");
+        const timestamp = ctx.request.header("svix-timestamp");
+        const signatureHeader = ctx.request.header("svix-signature");
+        if (!id || !timestamp || !signatureHeader) {
+            ctx.response.status(401).json({ error: "missing_signature" });
+            return;
+        }
+        const tsSeconds = Number(timestamp);
+        if (!Number.isFinite(tsSeconds)) {
+            ctx.response.status(401).json({ error: "invalid_signature" });
+            return;
+        }
+        const nowSeconds = Date.now() / 1000;
+        if (Math.abs(nowSeconds - tsSeconds) > maxAgeSeconds) {
+            ctx.response.status(401).json({ error: "stale_signature" });
+            return;
+        }
+        if (!verifySvixSignature(raw, id, timestamp, signatureHeader, keyBytes)) {
+            ctx.response.status(401).json({ error: "invalid_signature" });
+            return;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(raw.toString("utf8"));
+        }
+        catch {
+            ctx.response.status(400).json({ error: "invalid_json" });
+            return;
+        }
+        emitMappedEvent(emitter, payload);
+        ctx.response.status(200).json({ ok: true });
+    };
+}
+/**
+ * Verify a Svix signature header. Svix signs `<id>.<timestamp>.<body>` and emits
+ * a space-separated list of `v1,<base64sig>` candidates — accept if any matches
+ * (constant-time compare).
+ */
+function verifySvixSignature(raw, id, timestamp, signatureHeader, keyBytes) {
+    const toSign = Buffer.concat([
+        Buffer.from(`${id}.${timestamp}.`, "utf8"),
+        raw,
+    ]);
+    const expected = createHmac("sha256", keyBytes)
+        .update(toSign)
+        .digest("base64");
+    for (const part of signatureHeader.split(" ")) {
+        const [scheme, sig] = part.split(",");
+        if (scheme !== "v1" || !sig)
+            continue;
+        const sigBuf = Buffer.from(sig, "base64");
+        const expBuf = Buffer.from(expected, "base64");
+        if (sigBuf.length !== expBuf.length)
+            continue;
+        if (timingSafeEqual(sigBuf, expBuf))
+            return true;
+    }
+    return false;
+}
+/** Map a Resend payload to a mail event and emit it; emitter throws are swallowed. */
+function emitMappedEvent(emitter, payload) {
+    const mapped = payload.type ? EVENT_MAP[payload.type] : undefined;
+    if (!mapped)
+        return;
+    const to = Array.isArray(payload.data?.to)
+        ? (payload.data.to[0] ?? "")
+        : (payload.data?.to ?? "");
+    try {
+        emitter.emit(mapped, {
+            messageId: payload.data?.email_id ?? "",
+            to,
+            reason: payload.data?.reason,
+            timestamp: parseTimestamp(payload.data?.created_at),
+        });
+    }
+    catch {
+        // Emitter failures must not flip the webhook response; providers will
+        // replay on non-2xx and flood the bus.
+    }
+}
+//# sourceMappingURL=resend.js.map

package/dist/webhooks/resend.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"resend.js","sourceRoot":"","sources":["../../src/webhooks/resend.ts"],"names":[],"mappings":"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"}

package/dist/webhooks/sendgrid.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import type { WebhookEmitter, WebhookMiddleware } from "./context.js";
+export interface SendGridWebhookOptions {
+    /** Base64-DER or PEM-encoded Ed25519 public key, as shown in the SendGrid dashboard. */
+    publicKey: string;
+    emitter: WebhookEmitter;
+    /**
+     * Maximum age in seconds for a signed payload (default 300 = 5 minutes).
+     * Set to `Number.POSITIVE_INFINITY` to disable (not recommended).
+     */
+    maxAgeSeconds?: number;
+}
+export declare function createSendGridWebhookHandler(options: SendGridWebhookOptions): WebhookMiddleware;
+//# sourceMappingURL=sendgrid.d.ts.map

package/dist/webhooks/sendgrid.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"sendgrid.d.ts","sourceRoot":"","sources":["../../src/webhooks/sendgrid.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,cAAc,EAEd,iBAAiB,EACjB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,sBAAsB;IACtC,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAkBD,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,sBAAsB,GAC7B,iBAAiB,CA8EnB"}

package/dist/webhooks/sendgrid.js ADDED Viewed

@@ -0,0 +1,104 @@
+import { Buffer } from "node:buffer";
+import { createPublicKey, verify } from "node:crypto";
+const EVENT_MAP = {
+    delivered: "mail.delivered",
+    bounce: "mail.bounced",
+    dropped: "mail.failed",
+    deferred: "mail.failed",
+    blocked: "mail.failed",
+};
+export function createSendGridWebhookHandler(options) {
+    if (!options.publicKey) {
+        throw new Error("createSendGridWebhookHandler: publicKey is required for Ed25519 verification.");
+    }
+    const pemKey = toPem(options.publicKey);
+    const key = createPublicKey(pemKey);
+    const emitter = options.emitter;
+    const maxAgeSeconds = options.maxAgeSeconds ?? 300;
+    return async (ctx, _next) => {
+        const raw = await Promise.resolve(ctx.request.rawBody());
+        const signature = ctx.request.header("x-twilio-email-event-webhook-signature");
+        const timestamp = ctx.request.header("x-twilio-email-event-webhook-timestamp");
+        if (!signature || !timestamp) {
+            ctx.response.status(401).json({ error: "missing_signature" });
+            return;
+        }
+        const tsSeconds = Number(timestamp);
+        if (!Number.isFinite(tsSeconds)) {
+            ctx.response.status(401).json({ error: "invalid_signature" });
+            return;
+        }
+        const nowSeconds = Date.now() / 1000;
+        if (Math.abs(nowSeconds - tsSeconds) > maxAgeSeconds) {
+            ctx.response.status(401).json({ error: "stale_signature" });
+            return;
+        }
+        const payloadToVerify = Buffer.concat([
+            Buffer.from(timestamp, "utf8"),
+            raw,
+        ]);
+        let sigBytes;
+        try {
+            sigBytes = Buffer.from(signature, "base64");
+        }
+        catch {
+            ctx.response.status(401).json({ error: "invalid_signature" });
+            return;
+        }
+        const ok = verify(null, payloadToVerify, key, sigBytes);
+        if (!ok) {
+            ctx.response.status(401).json({ error: "invalid_signature" });
+            return;
+        }
+        let events;
+        try {
+            events = JSON.parse(raw.toString("utf8"));
+        }
+        catch {
+            ctx.response.status(400).json({ error: "invalid_json" });
+            return;
+        }
+        if (!Array.isArray(events)) {
+            ctx.response.status(400).json({ error: "expected_event_array" });
+            return;
+        }
+        for (const ev of events) {
+            if (!ev.event)
+                continue;
+            const mapped = EVENT_MAP[ev.event];
+            if (!mapped)
+                continue;
+            try {
+                emitter.emit(mapped, {
+                    messageId: ev.sg_message_id ?? "",
+                    to: ev.email ?? "",
+                    reason: ev.reason,
+                    timestamp: normaliseTimestamp(ev.timestamp),
+                });
+            }
+            catch {
+                // Never let emitter failures flip the webhook response.
+            }
+        }
+        ctx.response.status(200).json({ ok: true });
+    };
+}
+function toPem(key) {
+    const normalised = key.replace(/\r\n/g, "\n");
+    if (normalised.includes("BEGIN PUBLIC KEY"))
+        return normalised;
+    const der = normalised.replace(/\s/g, "");
+    return `-----BEGIN PUBLIC KEY-----\n${der}\n-----END PUBLIC KEY-----`;
+}
+function normaliseTimestamp(ts) {
+    // Guard non-finite values (NaN / ±Infinity): a malformed `timestamp`
+    // field in the webhook JSON would otherwise multiply into NaN and
+    // leak into the emitted mail.* event, breaking consumers that sort
+    // / persist / compare timestamps numerically.
+    if (ts === undefined || !Number.isFinite(ts))
+        return Date.now();
+    if (ts > 1e12)
+        return ts;
+    return ts * 1000;
+}
+//# sourceMappingURL=sendgrid.js.map

package/dist/webhooks/sendgrid.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"sendgrid.js","sourceRoot":"","sources":["../../src/webhooks/sendgrid.ts"],"names":[],"mappings":"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"}

package/index.darwin-arm64.node ADDED Viewed

Binary file

package/index.darwin-x64.node ADDED Viewed

Binary file

package/index.linux-arm64-gnu.node ADDED Viewed

Binary file

package/index.linux-x64-gnu.node ADDED Viewed

Binary file

package/index.win32-x64-msvc.node ADDED Viewed

Binary file

package/package.json ADDED Viewed

@@ -0,0 +1,97 @@
+{
+  "name": "@c9up/rover",
+  "version": "0.1.3",
+  "description": "Mail transport for Ream — SMTP, log, and pluggable transports",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/RoverProvider.d.ts",
+      "import": "./dist/RoverProvider.js"
+    },
+    "./services/main": {
+      "types": "./dist/services/main.d.ts",
+      "import": "./dist/services/main.js"
+    },
+    "./transports/mailgun": {
+      "types": "./dist/transports/MailgunTransport.d.ts",
+      "import": "./dist/transports/MailgunTransport.js"
+    },
+    "./transports/sendgrid": {
+      "types": "./dist/transports/SendGridTransport.d.ts",
+      "import": "./dist/transports/SendGridTransport.js"
+    },
+    "./transports/ses": {
+      "types": "./dist/transports/SesTransport.d.ts",
+      "import": "./dist/transports/SesTransport.js"
+    },
+    "./transports/resend": {
+      "types": "./dist/transports/ResendTransport.d.ts",
+      "import": "./dist/transports/ResendTransport.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/FakeMail.d.ts",
+      "import": "./dist/testing/FakeMail.js"
+    },
+    "./webhooks/mailgun": {
+      "types": "./dist/webhooks/mailgun.d.ts",
+      "import": "./dist/webhooks/mailgun.js"
+    },
+    "./webhooks/sendgrid": {
+      "types": "./dist/webhooks/sendgrid.d.ts",
+      "import": "./dist/webhooks/sendgrid.js"
+    },
+    "./webhooks/resend": {
+      "types": "./dist/webhooks/resend.d.ts",
+      "import": "./dist/webhooks/resend.js"
+    }
+  },
+  "dependencies": {
+    "@sendgrid/mail": "^8.1.3",
+    "form-data": "^4.0.1",
+    "mailgun.js": "^13.0.1",
+    "nodemailer": "^8.0.5"
+  },
+  "devDependencies": {
+    "@types/node": "*",
+    "@types/nodemailer": "^7.0.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "peerDependencies": {
+    "@c9up/ream": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@c9up/ream": {
+      "optional": true
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md",
+    "LICENSE",
+    "index.*.node",
+    "scripts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/C9up/rover.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:napi": "cargo build --release -p rover-template-engine-napi && node scripts/copy-napi.mjs",
+    "test": "vitest run",
+    "lint": "biome check src/",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/scripts/copy-napi.mjs ADDED Viewed

@@ -0,0 +1,62 @@
+import { copyFileSync, existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { arch, env, platform } from 'node:process'
+import { fileURLToPath } from 'node:url'
+const here = dirname(fileURLToPath(import.meta.url))
+const root = join(here, '..')
+const CRATE = 'rover_template_engine_napi'
+const TAG = '[rover:napi]'
+// Rust target triple -> { suffix, os }. Set CARGO_BUILD_TARGET to cross-compile
+// (e.g. build x86_64-apple-darwin on an arm64 macOS runner so we don't depend
+// on the scarce macos-13 Intel runners). Unset falls back to host platform.
+const tripleMap = {
+  'x86_64-unknown-linux-gnu': { suffix: 'linux-x64-gnu', os: 'linux' },
+  'aarch64-unknown-linux-gnu': { suffix: 'linux-arm64-gnu', os: 'linux' },
+  'x86_64-apple-darwin': { suffix: 'darwin-x64', os: 'darwin' },
+  'aarch64-apple-darwin': { suffix: 'darwin-arm64', os: 'darwin' },
+  'x86_64-pc-windows-msvc': { suffix: 'win32-x64-msvc', os: 'win32' },
+}
+const hostSuffixMap = {
+  'linux-x64': 'linux-x64-gnu',
+  'linux-arm64': 'linux-arm64-gnu',
+  'darwin-x64': 'darwin-x64',
+  'darwin-arm64': 'darwin-arm64',
+  'win32-x64': 'win32-x64-msvc',
+}
+const triple = env.CARGO_BUILD_TARGET ?? ''
+let suffix
+let os
+let releaseDir
+if (triple) {
+  const entry = tripleMap[triple]
+  if (!entry) throw new Error(`${TAG} unsupported CARGO_BUILD_TARGET: ${triple}`)
+  suffix = entry.suffix
+  os = entry.os
+  releaseDir = join(root, 'target', triple, 'release')
+} else {
+  suffix = hostSuffixMap[`${platform}-${arch}`]
+  os = platform
+  releaseDir = join(root, 'target', 'release')
+  if (!suffix) throw new Error(`${TAG} unsupported platform/arch: ${platform}-${arch}`)
+}
+const candidates =
+  os === 'win32'
+    ? [join(releaseDir, `${CRATE}.dll`), join(releaseDir, `lib${CRATE}.dll`)]
+    : os === 'darwin'
+      ? [join(releaseDir, `lib${CRATE}.dylib`)]
+      : [join(releaseDir, `lib${CRATE}.so`)]
+const source = candidates.find((candidate) => existsSync(candidate))
+if (!source) {
+  throw new Error(
+    `${TAG} native library not found. Looked for:\n${candidates.map((p) => `- ${p}`).join('\n')}`,
+  )
+}
+const target = join(root, `index.${suffix}.node`)
+copyFileSync(source, target)
+console.log(`${TAG} copied ${source} -> ${target}`)

package/src/BaseMail.ts ADDED Viewed

@@ -0,0 +1,52 @@
+import { type MailMessage, MessageBuilder } from "./MessageBuilder.js";
+export type MailAddress = string | { address: string; name: string };
+/**
+ * Abstract base for class-based mail messages (Adonis parity).
+ *
+ *   class WelcomeMail extends BaseMail {
+ *     from = { address: "noreply@acme.com", name: "Acme" };
+ *     subject = "Welcome!";
+ *     constructor(private user: User) { super(); }
+ *     async prepare() {
+ *       this.message.to(this.user.email).html(...);
+ *     }
+ *   }
+ *
+ *   await mail.send(new WelcomeMail(user));
+ */
+export abstract class BaseMail {
+	protected readonly message: MessageBuilder = new MessageBuilder();
+	from?: MailAddress;
+	subject?: string;
+	constructor() {
+		if (new.target === BaseMail) {
+			throw new Error(
+				"BaseMail is abstract and cannot be instantiated directly",
+			);
+		}
+	}
+	abstract prepare(): void | Promise<void>;
+	async build(): Promise<MailMessage> {
+		if (this.from !== undefined) {
+			this.message.from(formatAddress(this.from));
+		}
+		if (this.subject !== undefined) {
+			this.message.subject(this.subject);
+		}
+		await this.prepare();
+		return this.message.build();
+	}
+}
+function formatAddress(addr: MailAddress): string {
+	if (typeof addr === "string") {
+		return addr;
+	}
+	return `"${addr.name}" <${addr.address}>`;
+}