@softure-ai/mailing 0.2.2 → 0.2.4

package/src/testing/fake-provider.ts

@@ -1,6 +1,6 @@
 // A provider that sends nothing: it captures mail in memory (`provider.sent`) and, with an outbox
 // file, appends each mail as one JSON line for a test in another process (an e2e against
-// `next start`). It honours idempotency keys like a real provider: a repeated key answers the
+// `next start`), attachment bytes as base64. It honours idempotency keys like a real provider: a repeated key answers the
 // first id and captures nothing new.
 import { appendFile } from "node:fs/promises";
 import type { MailProvider, ProviderMessage, ProviderOutcome } from "../contract.js";
@@ -34,6 +34,7 @@ export function fakeMailProvider(options: FakeMailProviderOptions = {}): FakeMai
 
   return {
     name: "fake",
+    supportsAttachments: true,
     get sent() {
       return [...sent];
     },
@@ -54,9 +55,14 @@ export function fakeMailProvider(options: FakeMailProviderOptions = {}): FakeMai
       if (knownId !== undefined) return { status: "sent", id: knownId };
 
       counter += 1;
-      const captured: CapturedMail = { ...message, headers: { ...message.headers }, id: `fake-${String(counter)}-${crypto.randomUUID()}` };
+      const captured: CapturedMail = {
+        ...message,
+        headers: { ...message.headers },
+        ...(message.attachments === undefined ? {} : { attachments: message.attachments.map((attachment) => ({ ...attachment, content: attachment.content.slice() })) }),
+        id: `fake-${String(counter)}-${crypto.randomUUID()}`,
+      };
       if (options.outboxFile !== undefined) {
-        await appendFile(options.outboxFile, `${JSON.stringify(captured)}\n`, "utf8");
+        await appendFile(options.outboxFile, `${JSON.stringify(toOutboxLine(captured))}\n`, "utf8");
       }
       sent.push(captured);
       if (message.idempotencyKey !== null) idsByKey.set(message.idempotencyKey, captured.id);
@@ -64,3 +70,12 @@ export function fakeMailProvider(options: FakeMailProviderOptions = {}): FakeMai
     },
   };
 }
+
+/** A captured mail as one outbox line: attachment bytes as base64 (`readMailOutbox` decodes them). */
+function toOutboxLine(mail: CapturedMail): unknown {
+  if (mail.attachments === undefined) return mail;
+  return {
+    ...mail,
+    attachments: mail.attachments.map((attachment) => ({ ...attachment, content: Buffer.from(attachment.content).toString("base64") })),
+  };
+}

package/src/testing/outbox.ts

@@ -13,6 +13,10 @@ const capturedMailSchema = z.object({
   html: z.string().nullable(),
   headers: z.record(z.string(), z.string()),
   idempotencyKey: z.string().nullable(),
+  // Base64 in the file, bytes again here; lines written before attachments existed have none.
+  attachments: z
+    .array(z.object({ filename: z.string(), contentType: z.string(), content: z.base64().transform((content) => new Uint8Array(Buffer.from(content, "base64"))) }))
+    .optional(),
 });
 
 /** Every mail in the outbox, oldest first, optionally only those to `to`. A missing file is an empty outbox. */
@@ -27,6 +31,12 @@ export async function readMailOutbox(file: string, filter: { readonly to?: strin
   return text
     .split("\n")
     .filter((line) => line !== "")
-    .map((line) => capturedMailSchema.parse(JSON.parse(line)))
+    .map((line) => toCapturedMail(capturedMailSchema.parse(JSON.parse(line))))
     .filter((mail) => filter.to === undefined || mail.to === filter.to);
 }
+
+/** A parsed line without an `attachments: undefined` key, so a mail without attachments equals what was sent. */
+function toCapturedMail(line: z.output<typeof capturedMailSchema>): CapturedMail {
+  const { attachments, ...mail } = line;
+  return attachments === undefined ? mail : { ...mail, attachments };
+}