@remit/smtp-service 0.0.20 → 1.0.0

package/package.json

@@ -1,42 +1,42 @@
 {
-  "name": "@remit/smtp-service",
-  "version": "0.0.20",
-  "type": "module",
-  "main": "src/index.ts",
-  "exports": {
-    ".": {
-      "types": "./src/index.ts",
-      "default": "./src/index.ts"
-    },
-    "./message-builder": {
-      "types": "./src/message-builder.ts",
-      "default": "./src/message-builder.ts"
-    },
-    "./test-fake-smtp": {
-      "types": "./src/test-fake-smtp.ts",
-      "default": "./src/test-fake-smtp.ts"
-    }
-  },
-  "scripts": {
-    "test:typecheck": "tsgo --noEmit",
-    "test:run": "node $NODE_TEST_FLAGS --env-file=../../localhost-test-unit.env --experimental-test-coverage --test-coverage-include='src/**' --test-coverage-exclude='src/**/*.test.ts' --test-coverage-exclude='src/**/*.test.tsx' --test-coverage-lines=95 --test 'src/**/*.test.ts'",
-    "test": "npm run test:typecheck && npm run test:run"
-  },
-  "devDependencies": {
-    "@types/node": "*"
-  },
-  "dependencies": {
-    "nodemailer": "^10.0.6",
-    "@remit/data-ports": "*",
-    "@types/nodemailer": "^8.0.1"
-  },
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/remit-mail/reader.git",
-    "directory": "packages/smtp-service"
-  }
+	"name": "@remit/smtp-service",
+	"version": "1.0.0",
+	"type": "module",
+	"main": "src/index.ts",
+	"exports": {
+		".": {
+			"types": "./src/index.ts",
+			"default": "./src/index.ts"
+		},
+		"./message-builder": {
+			"types": "./src/message-builder.ts",
+			"default": "./src/message-builder.ts"
+		},
+		"./test-fake-smtp": {
+			"types": "./src/test-fake-smtp.ts",
+			"default": "./src/test-fake-smtp.ts"
+		}
+	},
+	"scripts": {
+		"test:typecheck": "tsgo --noEmit",
+		"test:run": "node $NODE_TEST_FLAGS --env-file=../../localhost-test-unit.env --experimental-test-coverage --test-coverage-include='src/**' --test-coverage-exclude='src/**/*.test.ts' --test-coverage-exclude='src/**/*.test.tsx' --test-coverage-lines=95 --test 'src/**/*.test.ts'",
+		"test": "npm run test:typecheck && npm run test:run"
+	},
+	"devDependencies": {
+		"@types/node": "*"
+	},
+	"dependencies": {
+		"nodemailer": "^10.0.6",
+		"@remit/data-ports": "*",
+		"@types/nodemailer": "^8.0.1"
+	},
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/remit-mail/reader.git",
+		"directory": "packages/smtp-service"
+	}
 }

package/src/message-builder.test.ts

@@ -367,3 +367,49 @@ describe("renderRawMessage", () => {
 		assert.equal(headerOf(raw, "Bcc"), "hidden@example.com");
 	});
 });
+
+describe("a calendar scheduling message", () => {
+	const ICAL = [
+		"BEGIN:VCALENDAR",
+		"VERSION:2.0",
+		"METHOD:REQUEST",
+		"BEGIN:VEVENT",
+		"UID:meeting@test",
+		"DTSTAMP:20260901T000000Z",
+		"DTSTART:20260907T090000Z",
+		"END:VEVENT",
+		"END:VCALENDAR",
+	].join("\r\n");
+
+	it("carries its iCalendar as a text/calendar part with the iTIP method", async () => {
+		const raw = (
+			await renderRawMessage(
+				buildMailMessage(
+					baseOutbox({
+						subject: "Invitation: Planning",
+						textBody: "Invitation",
+					}),
+					[],
+					{ method: "Request", icalData: ICAL },
+				),
+			)
+		).toString("utf8");
+
+		assert.match(raw, /Content-Type: multipart\/alternative/);
+		assert.match(
+			raw,
+			/Content-Type: text\/calendar; charset=utf-8; method=REQUEST/,
+		);
+		assert.match(raw, /Content-Type: text\/plain/);
+	});
+
+	it("is a plain message when the outbox row carries no part", async () => {
+		const raw = (
+			await renderRawMessage(
+				buildMailMessage(baseOutbox({ textBody: "Hi" }), [], null),
+			)
+		).toString("utf8");
+
+		assert.doesNotMatch(raw, /text\/calendar/);
+	});
+});

package/src/message-builder.ts

@@ -1,4 +1,7 @@
-import type { OutboxMessageItem } from "@remit/data-ports";
+import type {
+	OutboxMessageItem,
+	OutboxSchedulingPartItem,
+} from "@remit/data-ports";
 import { wireMessageId } from "@remit/data-ports/id";
 import nodemailer, { type SendMailOptions } from "nodemailer";
 
@@ -16,6 +19,8 @@ export interface MailMessage {
 	references?: string | undefined;
 	date?: Date | undefined;
 	attachments?: MailAttachment[] | undefined;
+	/** A calendar scheduling message's `text/calendar; method=…` part (RFC 6047). */
+	icalEvent?: { method: string; content: string } | undefined;
 }
 
 export interface MailAttachment {
@@ -47,6 +52,7 @@ const placeAttachment = (
 export const buildMailMessage = (
 	outbox: OutboxMessageItem,
 	attachments?: MailAttachment[],
+	schedulingPart?: Pick<OutboxSchedulingPartItem, "method" | "icalData"> | null,
 ): MailMessage => ({
 	from: formatFrom(outbox.fromAddress, outbox.fromName),
 	to: outbox.toAddresses,
@@ -66,6 +72,12 @@ export const buildMailMessage = (
 	attachments: attachments?.map((attachment) =>
 		placeAttachment(attachment, outbox.htmlBody),
 	),
+	icalEvent: schedulingPart
+		? {
+				method: schedulingPart.method.toUpperCase(),
+				content: schedulingPart.icalData,
+			}
+		: undefined,
 });
 
 export const toNodemailerOptions = (message: MailMessage): SendMailOptions => ({
@@ -88,6 +100,7 @@ export const toNodemailerOptions = (message: MailMessage): SendMailOptions => ({
 		cid: a.cid,
 		contentDisposition: a.contentDisposition,
 	})),
+	icalEvent: message.icalEvent,
 });
 
 /** The same message as RFC822 bytes, for an IMAP APPEND. */