@yozz.app/smtp 0.1.2 → 0.1.3

package/README.md

@@ -14,7 +14,7 @@ keywords, AUTH PLAIN / LOGIN, the MAIL / RCPT / DATA sequence and dot-stuffing.
 TLS, certificates or the vault. STARTTLS is not spoken: the transport is already TLS (465).
 
 `buildMessage` turns composer fields into 7-bit bytes: RFC 2047 headers, 7bit or quoted-printable bodies,
-`multipart/alternative` when an HTML rendering is given, `In-Reply-To` + `References` for replies.
+`multipart/alternative` when an HTML rendering is given, `In-Reply-To` + the folded `References` chain for replies.
 
 ## Tests
 

package/dist/index.d.mts

@@ -77,8 +77,25 @@ type MessageInput = {
   readonly messageId: string;
   readonly text: string; /** When present the message is `multipart/alternative`, text first. */
   readonly html?: string;
-  readonly inReplyTo?: string; /** When present the whole message becomes `multipart/mixed`: the body first, then each file. */
+  readonly inReplyTo?: string;
+  /**
+   * The parent's `References` followed by its Message-ID, oldest first — the chain RFC 5322 §3.6.4
+   * asks a reply to carry. Without it a client that threads on References alone (and the base
+   * subject is a guess, not a rule) sees a reply to a reply as a new conversation. Defaults to
+   * `[inReplyTo]`, which is what a first reply's chain is anyway.
+   */
+  readonly references?: readonly string[]; /** When present the whole message becomes `multipart/mixed`: the body first, then each file. */
   readonly attachments?: readonly MessageAttachment[];
+  /**
+   * Headers this client owns, appended after the standard block.
+   *
+   * YOZZ no longer uses this. It stamped `X-Yozz-Draft` here to find its own copies again without
+   * trusting a Message-ID a provider may rewrite, and that failed on a more basic point: a server
+   * need only index the headers IMAP names, so `SEARCH HEADER` on a private one can answer the
+   * empty list for a message that carries it (docs/knowledge/forwardemail-api.md). The field stays
+   * because a message builder should be able to set a header; do not build a LOOKUP on one.
+   */
+  readonly extraHeaders?: readonly (readonly [string, string])[];
 };
 type MessageAttachment = {
   readonly filename: string;

package/dist/index.mjs

@@ -435,7 +435,16 @@ const buildMessage = (input) => {
 	const cc = input.cc ?? [];
 	if (cc.length > 0) headers.push(["Cc", cc.join(", ")]);
 	headers.push(["Subject", encodeHeaderText(input.subject)], ["Date", formatDate(input.date)], ["Message-ID", input.messageId], ["MIME-Version", "1.0"]);
-	if (input.inReplyTo !== void 0) headers.push(["In-Reply-To", input.inReplyTo], ["References", input.inReplyTo]);
+	if (input.inReplyTo !== void 0) headers.push(["In-Reply-To", input.inReplyTo]);
+	const references = input.references ?? (input.inReplyTo === void 0 ? [] : [input.inReplyTo]);
+	if (references.length > 0) {
+		for (const id of references) assertNoLineBreak("References", id);
+		headers.push(["References", references.join("\r\n ")]);
+	}
+	for (const [name, value] of input.extraHeaders ?? []) {
+		assertNoLineBreak(name, value);
+		headers.push([name, value]);
+	}
 	for (const { filename, mimeType } of input.attachments ?? []) {
 		assertNoLineBreak("filename", filename);
 		assertNoLineBreak("Content-Type", mimeType);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yozz.app/smtp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Transport-agnostic SMTP client core plus an RFC 5322 message builder.",
   "license": "MIT",
   "homepage": "https://github.com/fishballapp/yozz",
@@ -31,8 +31,8 @@
   "devDependencies": {
     "@types/node": "^24.0.0",
     "tsdown": "^0.22.3",
-    "@yozz.app/tls": "0.1.2",
-    "@yozz.app/x509": "0.1.2"
+    "@yozz.app/tls": "0.1.3",
+    "@yozz.app/x509": "0.1.3"
   },
   "scripts": {
     "build": "tsdown src/index.ts --format esm --dts",