@upyo/smtp 0.6.0-dev.269 → 0.6.0-dev.272

package/README.md

@@ -26,6 +26,7 @@ Features
  -  HTML and plain text email support
  -  File attachments (regular and inline)
  -  Multiple recipients (To, CC, BCC)
+ -  SMTP PIPELINING for faster multi-recipient delivery
  -  Custom headers
  -  Priority levels
  -  Comprehensive testing utilities

package/dist/index.cjs

@@ -361,6 +361,16 @@ var OAuth2TokenManager = class {
 
 //#endregion
 //#region src/smtp-connection.ts
+var SmtpPipelineTerminatedError = class extends Error {
+	responseIndex;
+	response;
+	constructor(responseIndex, response) {
+		super("SMTP pipeline terminated by the server.");
+		this.name = "SmtpPipelineTerminatedError";
+		this.responseIndex = responseIndex;
+		this.response = response;
+	}
+};
 /**
 * The maximum length of an SMTP command line, including the terminating CRLF,
 * as specified by RFC 5321 §4.5.3.1.4.
@@ -513,30 +523,59 @@ var SmtpConnection = class {
 		});
 	}
 	sendCommand(command, signal) {
+		return this.sendCommands([command], signal).then((responses) => responses[0]);
+	}
+	/**
+	* Sends a group of commands in one write and reads one reply per command.
+	*
+	* SMTP multiline replies are kept together and complete replies are matched
+	* to commands by their position in the returned array, as required for
+	* command pipelining by RFC 2920.
+	*/
+	sendCommands(commands, signal) {
 		if (!this.socket) throw new Error("Not connected");
 		signal?.throwIfAborted();
 		return new Promise((resolve, reject) => {
 			let buffer = "";
-			const timeout = setTimeout(() => {
+			let responseLines = [];
+			const responses = [];
+			const startTimeout = () => setTimeout(() => {
+				cleanup();
 				reject(/* @__PURE__ */ new Error("Command timeout"));
 			}, this.config.socketTimeout);
+			let timeout = startTimeout();
+			const resetTimeout = () => {
+				clearTimeout(timeout);
+				timeout = startTimeout();
+			};
 			const onData = (data) => {
 				buffer += data.toString();
 				const lines = buffer.split("\r\n");
 				const incompleteLine = lines.pop() || "";
-				for (let i = 0; i < lines.length; i++) {
-					const line = lines[i];
+				for (const line of lines) {
+					responseLines.push(line);
 					if (line.length >= 4 && line[3] === " ") {
 						const code = parseInt(line.substring(0, 3), 10);
 						const message = line.substring(4);
-						const fullResponse = lines.slice(0, i + 1).join("\r\n");
-						cleanup();
-						resolve({
+						const response = {
 							code,
 							message,
-							raw: fullResponse
-						});
-						return;
+							raw: responseLines.join("\r\n")
+						};
+						const responseIndex = responses.length;
+						responses.push(response);
+						responseLines = [];
+						if (responses.length === commands.length) {
+							cleanup();
+							resolve(responses);
+							return;
+						}
+						if (response.code === 421) {
+							cleanup();
+							reject(new SmtpPipelineTerminatedError(responseIndex, response));
+							return;
+						}
+						resetTimeout();
 					}
 				}
 				buffer = incompleteLine;
@@ -545,14 +584,35 @@ var SmtpConnection = class {
 				cleanup();
 				reject(error);
 			};
+			const onClose = () => {
+				cleanup();
+				const responseIndex = responses.findIndex((response) => response.code >= 400);
+				if (responseIndex >= 0) {
+					reject(new SmtpPipelineTerminatedError(responseIndex, responses[responseIndex]));
+					return;
+				}
+				reject(/* @__PURE__ */ new Error("Connection closed before all command responses."));
+			};
+			const onAbort = () => {
+				cleanup();
+				try {
+					signal?.throwIfAborted();
+				} catch (error) {
+					reject(error);
+				}
+			};
 			const cleanup = () => {
 				clearTimeout(timeout);
 				this.socket?.off("data", onData);
 				this.socket?.off("error", onError);
+				this.socket?.off("close", onClose);
+				signal?.removeEventListener("abort", onAbort);
 			};
 			this.socket.on("data", onData);
 			this.socket.on("error", onError);
-			this.socket.write(command + "\r\n");
+			this.socket.on("close", onClose);
+			signal?.addEventListener("abort", onAbort, { once: true });
+			this.socket.write(commands.map((command) => `${command}\r\n`).join(""));
 		});
 	}
 	greeting(signal) {
@@ -593,8 +653,14 @@ var SmtpConnection = class {
 	}
 	async ehlo(signal) {
 		const response = await this.sendCommand(`EHLO ${this.config.localName}`, signal);
+		if (response.code === 500 || response.code === 502) {
+			const heloResponse = await this.sendCommand(`HELO ${this.config.localName}`, signal);
+			if (heloResponse.code !== 250) throw new Error(`HELO failed: ${heloResponse.message}`);
+			this.capabilities = [];
+			return;
+		}
 		if (response.code !== 250) throw new Error(`EHLO failed: ${response.message}`);
-		this.capabilities = response.raw.split("\r\n").filter((line) => line.startsWith("250-") || line.startsWith("250 ")).map((line) => line.substring(4)).filter((line) => line.length > 0);
+		this.capabilities = response.raw.split("\r\n").filter((line) => line.startsWith("250-") || line.startsWith("250 ")).slice(1).map((line) => line.substring(4)).filter((line) => line.length > 0);
 	}
 	async starttls(signal) {
 		if (!this.socket) throw new Error("Not connected");
@@ -747,12 +813,43 @@ var SmtpConnection = class {
 		throw new SmtpAuthError(`${mechanism} authentication failed: ${response.message}`);
 	}
 	async sendMessage(message, signal) {
-		const mailResponse = await this.sendCommand(`MAIL FROM:<${message.envelope.from}>`, signal);
+		const mailCommand = `MAIL FROM:<${message.envelope.from}>`;
+		const recipientCommands = message.envelope.to.map((recipient) => `RCPT TO:<${recipient}>`);
+		const pipelining = this.capabilities.some((capability) => /^PIPELINING(?:\s|$)/i.test(capability));
+		let mailResponse;
+		let recipientResponses;
+		if (pipelining) try {
+			const envelopeResponses = await this.sendCommands([mailCommand, ...recipientCommands], signal);
+			mailResponse = envelopeResponses[0];
+			recipientResponses = envelopeResponses.slice(1);
+		} catch (error) {
+			if (!(error instanceof SmtpPipelineTerminatedError)) throw error;
+			const { response, responseIndex } = error;
+			if (responseIndex === 0) throw new SmtpResponseError(`MAIL FROM failed: ${response.message}`, response.code, "MAIL FROM", response.message);
+			const recipient = message.envelope.to[responseIndex - 1];
+			throw new SmtpResponseError(`RCPT TO failed for ${recipient}: ${response.message}`, response.code, "RCPT TO", response.message);
+		}
+		else {
+			mailResponse = await this.sendCommand(mailCommand, signal);
+			recipientResponses = [];
+		}
 		if (mailResponse.code !== 250) throw new SmtpResponseError(`MAIL FROM failed: ${mailResponse.message}`, mailResponse.code, "MAIL FROM", mailResponse.message);
-		for (const recipient of message.envelope.to) {
+		const rejectedRecipients = [];
+		for (const [index, recipient] of message.envelope.to.entries()) {
 			signal?.throwIfAborted();
-			const rcptResponse = await this.sendCommand(`RCPT TO:<${recipient}>`, signal);
-			if (rcptResponse.code !== 250) throw new SmtpResponseError(`RCPT TO failed for ${recipient}: ${rcptResponse.message}`, rcptResponse.code, "RCPT TO", rcptResponse.message);
+			const rcptResponse = pipelining ? recipientResponses[index] : await this.sendCommand(recipientCommands[index], signal);
+			if (rcptResponse.code === 421) throw new SmtpResponseError(`RCPT TO failed for ${recipient}: ${rcptResponse.message}`, rcptResponse.code, "RCPT TO", rcptResponse.message);
+			if (rcptResponse.code !== 250 && rcptResponse.code !== 251) rejectedRecipients.push({
+				recipient,
+				code: rcptResponse.code,
+				response: rcptResponse.message,
+				retryable: rcptResponse.code >= 400 && rcptResponse.code < 500
+			});
+		}
+		if (rejectedRecipients.length > 0 && rejectedRecipients.length === message.envelope.to.length) {
+			const rejection = rejectedRecipients.find((item) => item.retryable) ?? rejectedRecipients[0];
+			const details = rejectedRecipients.map((item) => `${item.recipient}: ${item.code} ${item.response}`).join("; ");
+			throw new SmtpResponseError(`RCPT TO failed for every recipient: ${details}`, rejection.code, "RCPT TO", rejection.response, rejectedRecipients);
 		}
 		const dataResponse = await this.sendCommand("DATA", signal);
 		if (dataResponse.code !== 354) throw new SmtpResponseError(`DATA failed: ${dataResponse.message}`, dataResponse.code, "DATA", dataResponse.message);
@@ -760,7 +857,10 @@ var SmtpConnection = class {
 		const finalResponse = await this.sendCommand(`${content}\r\n.`, signal);
 		if (finalResponse.code !== 250) throw new SmtpResponseError(`Message send failed: ${finalResponse.message}`, finalResponse.code, "DATA_END", finalResponse.message);
 		const messageId = this.extractMessageId(finalResponse.message);
-		return messageId;
+		return {
+			messageId,
+			rejectedRecipients
+		};
 	}
 	extractMessageId(response) {
 		const match = response.match(/(?:Message-ID:|id=)[\s<]*([^>\s]+)/i);
@@ -816,6 +916,8 @@ var SmtpResponseError = class extends Error {
 	* The textual SMTP reply returned by the server.
 	*/
 	response;
+	/** Recipient-level failures collected for an unsuccessful transaction. */
+	rejectedRecipients;
 	/**
 	* Creates an SMTP response error.
 	*
@@ -823,13 +925,16 @@ var SmtpResponseError = class extends Error {
 	* @param code The numeric SMTP reply code.
 	* @param command The SMTP command that produced the reply.
 	* @param response The textual SMTP reply returned by the server.
+	* @param rejectedRecipients Recipient-level failures collected for the
+	*                           transaction.
 	*/
-	constructor(message, code, command, response) {
+	constructor(message, code, command, response, rejectedRecipients) {
 		super(message);
 		this.name = "SmtpResponseError";
 		this.code = code;
 		this.command = command;
 		this.response = response;
+		this.rejectedRecipients = rejectedRecipients;
 	}
 };
 /**
@@ -1131,6 +1236,15 @@ function arrayBufferToBase64(buffer) {
 
 //#endregion
 //#region src/message-converter.ts
+/**
+* Converts a message to its SMTP envelope and wire representation.
+*
+* @param message The message to convert.
+* @param dkimConfig Optional DKIM signing configuration.
+* @returns The converted SMTP message.
+* @throws {RangeError} If a header contains a token that cannot be folded
+* within the RFC 5322 hard line-length limit.
+*/
 async function convertMessage(message, dkimConfig) {
 	const envelope = {
 		from: message.sender.address,
@@ -1162,11 +1276,11 @@ async function buildRawMessage(message) {
 	const hasHtml = "html" in message.content;
 	const hasText = "text" in message.content;
 	const isMultipart = hasAttachments || hasHtml && hasText;
-	lines.push(`From: ${encodeAddress(message.sender)}`);
-	lines.push(`To: ${message.recipients.map(encodeAddress).join(", ")}`);
-	if (message.ccRecipients.length > 0) lines.push(`Cc: ${message.ccRecipients.map(encodeAddress).join(", ")}`);
-	if (message.replyRecipients.length > 0) lines.push(`Reply-To: ${message.replyRecipients.map(encodeAddress).join(", ")}`);
-	lines.push(`Subject: ${encodeHeaderValue(message.subject)}`);
+	lines.push(foldHeader("From", encodeAddress(message.sender)));
+	lines.push(foldHeader("To", message.recipients.map(encodeAddress).join(", ")));
+	if (message.ccRecipients.length > 0) lines.push(foldHeader("Cc", message.ccRecipients.map(encodeAddress).join(", ")));
+	if (message.replyRecipients.length > 0) lines.push(foldHeader("Reply-To", message.replyRecipients.map(encodeAddress).join(", ")));
+	lines.push(foldHeader("Subject", encodeHeaderValue(message.subject, true)));
 	lines.push(`Date: ${(/* @__PURE__ */ new Date()).toUTCString()}`);
 	lines.push(`Message-ID: <${generateMessageId()}>`);
 	if (message.priority !== "normal") {
@@ -1174,7 +1288,7 @@ async function buildRawMessage(message) {
 		lines.push(`X-Priority: ${priorityValue}`);
 		lines.push(`X-MSMail-Priority: ${message.priority === "high" ? "High" : "Low"}`);
 	}
-	for (const [key, value] of message.headers) lines.push(`${key}: ${encodeHeaderValue(value)}`);
+	for (const [key, value] of message.headers) lines.push(foldHeader(key, encodeHeaderValue(value)));
 	lines.push("MIME-Version: 1.0");
 	if (isMultipart) {
 		lines.push(`Content-Type: multipart/mixed; boundary="${boundary}"`);
@@ -1213,12 +1327,12 @@ async function buildRawMessage(message) {
 		for (const attachment of message.attachments) {
 			lines.push("");
 			lines.push(`--${boundary}`);
-			lines.push(`Content-Type: ${attachment.contentType}; name="${attachment.filename}"`);
+			lines.push(foldHeader("Content-Type", `${attachment.contentType}; ${encodeMimeParameter("name", attachment.filename)}`));
 			lines.push("Content-Transfer-Encoding: base64");
 			if (attachment.inline) {
-				lines.push(`Content-Disposition: inline; filename="${attachment.filename}"`);
+				lines.push(foldHeader("Content-Disposition", `inline; ${encodeMimeParameter("filename", attachment.filename)}`));
 				lines.push(`Content-ID: <${attachment.contentId}>`);
-			} else lines.push(`Content-Disposition: attachment; filename="${attachment.filename}"`);
+			} else lines.push(foldHeader("Content-Disposition", `attachment; ${encodeMimeParameter("filename", attachment.filename)}`));
 			lines.push("");
 			lines.push(encodeBase64(await attachment.content));
 		}
@@ -1247,32 +1361,85 @@ function generateMessageId() {
 }
 function encodeAddress(address) {
 	if (address.name == null) return address.address;
-	const encodedDisplayName = encodeHeaderValue(address.name);
+	const encodedDisplayName = encodeHeaderValue(address.name, true);
 	return `${encodedDisplayName} <${address.address}>`;
 }
-function encodeHeaderValue(value) {
-	if (!/^[\x20-\x7E]*$/.test(value)) {
-		const utf8Bytes = new TextEncoder().encode(value);
-		const base64 = node_buffer.Buffer.from(utf8Bytes).toString("base64");
+function encodeHeaderValue(value, encodeLongAsciiWords = false) {
+	const hasLongWord = value.split(/\s+/).some((word) => word.length > 60);
+	if (!/^[\x20-\x7E]*$/.test(value) || encodeLongAsciiWords && hasLongWord) {
+		const encodeWord = (text) => {
+			const utf8Bytes = new TextEncoder().encode(text);
+			const base64 = node_buffer.Buffer.from(utf8Bytes).toString("base64");
+			return `=?UTF-8?B?${base64}?=`;
+		};
 		const maxEncodedLength = 75;
-		const encodedWord = `=?UTF-8?B?${base64}?=`;
+		const encodedWord = encodeWord(value);
 		if (encodedWord.length <= maxEncodedLength) return encodedWord;
 		const words = [];
-		let currentBase64 = "";
-		for (let i = 0; i < base64.length; i += 4) {
-			const chunk = base64.slice(i, i + 4);
-			const testWord = `=?UTF-8?B?${currentBase64}${chunk}?=`;
-			if (testWord.length <= maxEncodedLength) currentBase64 += chunk;
+		let currentText = "";
+		for (const character of value) {
+			const candidate = currentText + character;
+			if (encodeWord(candidate).length <= maxEncodedLength) currentText = candidate;
 			else {
-				if (currentBase64) words.push(`=?UTF-8?B?${currentBase64}?=`);
-				currentBase64 = chunk;
+				if (currentText.length > 0) words.push(encodeWord(currentText));
+				currentText = character;
 			}
 		}
-		if (currentBase64) words.push(`=?UTF-8?B?${currentBase64}?=`);
+		if (currentText.length > 0) words.push(encodeWord(currentText));
 		return words.join(" ");
 	}
 	return value;
 }
+function encodeMimeParameter(name, value) {
+	const escapedValue = value.replace(/[\\"]/g, "\\$&");
+	const quotedParameter = `${name}="${escapedValue}"`;
+	if (/^[\x20-\x7E]*$/.test(value) && quotedParameter.length <= 60) return quotedParameter;
+	const encodedBytes = Array.from(new TextEncoder().encode(value), (byte) => {
+		const character = String.fromCharCode(byte);
+		return /^[A-Za-z0-9!#$&+.^_`|~-]$/.test(character) ? character : `%${byte.toString(16).toUpperCase().padStart(2, "0")}`;
+	});
+	const segments = [];
+	let segment = "";
+	for (const encodedByte of encodedBytes) {
+		if (segment.length + encodedByte.length > 45) {
+			segments.push(segment);
+			segment = "";
+		}
+		segment += encodedByte;
+	}
+	if (segment.length > 0 || segments.length === 0) segments.push(segment);
+	return segments.map((part, index) => `${name}*${index}*=${index === 0 ? "UTF-8''" : ""}${part}`).join("; ");
+}
+function foldHeader(name, value) {
+	const recommendedLineLength = 78;
+	const lines = [];
+	let prefix = `${name}: `;
+	let remaining = value;
+	while (prefix.length + remaining.length > recommendedLineLength) {
+		const availableLength = recommendedLineLength - prefix.length;
+		let breakIndex = -1;
+		for (let index = Math.min(availableLength, remaining.length - 1); index >= 0; index--) if (remaining[index] === " " || remaining[index] === "	") {
+			breakIndex = index;
+			break;
+		}
+		if (breakIndex < 0) {
+			for (let index = Math.max(availableLength + 1, 0); index < remaining.length; index++) if (remaining[index] === " " || remaining[index] === "	") {
+				breakIndex = index;
+				break;
+			}
+		}
+		if (breakIndex < 0) break;
+		let whitespaceEnd = breakIndex + 1;
+		while (whitespaceEnd < remaining.length && (remaining[whitespaceEnd] === " " || remaining[whitespaceEnd] === "	")) whitespaceEnd++;
+		if (whitespaceEnd === remaining.length) break;
+		lines.push(prefix + remaining.slice(0, breakIndex));
+		prefix = remaining.slice(breakIndex, whitespaceEnd);
+		remaining = remaining.slice(whitespaceEnd);
+	}
+	lines.push(prefix + remaining);
+	if (lines.some((line) => line.length > 998)) throw new RangeError(`Header field ${name} contains a token too long to fold.`);
+	return lines.join("\r\n");
+}
 function encodeQuotedPrintable(text) {
 	const utf8Bytes = new TextEncoder().encode(text);
 	let result = "";
@@ -1403,12 +1570,13 @@ var SmtpTransport = class {
 			options?.signal?.throwIfAborted();
 			const smtpMessage = await convertMessage(message, this.config.dkim);
 			options?.signal?.throwIfAborted();
-			const messageId = await connection.sendMessage(smtpMessage, options?.signal);
+			const result = await connection.sendMessage(smtpMessage, options?.signal);
 			await this.returnConnection(connection);
 			return {
 				successful: true,
-				messageId,
-				provider: "smtp"
+				messageId: result.messageId,
+				provider: "smtp",
+				rejectedRecipients: result.rejectedRecipients
 			};
 		} catch (error) {
 			if (connection != null) await this.discardConnection(connection);
@@ -1472,11 +1640,12 @@ var SmtpTransport = class {
 				try {
 					const smtpMessage = await convertMessage(message, this.config.dkim);
 					options?.signal?.throwIfAborted();
-					const messageId = await connection.sendMessage(smtpMessage, options?.signal);
+					const result = await connection.sendMessage(smtpMessage, options?.signal);
 					yield {
 						successful: true,
-						messageId,
-						provider: "smtp"
+						messageId: result.messageId,
+						provider: "smtp",
+						rejectedRecipients: result.rejectedRecipients
 					};
 				} catch (error) {
 					options?.signal?.throwIfAborted();
@@ -1493,11 +1662,12 @@ var SmtpTransport = class {
 				try {
 					const smtpMessage = await convertMessage(message, this.config.dkim);
 					options?.signal?.throwIfAborted();
-					const messageId = await connection.sendMessage(smtpMessage, options?.signal);
+					const result = await connection.sendMessage(smtpMessage, options?.signal);
 					yield {
 						successful: true,
-						messageId,
-						provider: "smtp"
+						messageId: result.messageId,
+						provider: "smtp",
+						rejectedRecipients: result.rejectedRecipients
 					};
 				} catch (error) {
 					options?.signal?.throwIfAborted();
@@ -1606,7 +1776,8 @@ function createSmtpFailure(message, error) {
 			attempts: 1,
 			providerDetails: {
 				command: error.command,
-				response: error.response
+				response: error.response,
+				rejectedRecipients: error.rejectedRecipients
 			}
 		});
 	}

package/dist/index.d.cts

@@ -417,6 +417,41 @@ interface SmtpTlsOptions {
  * used internally by the SMTP transport implementation.
  */
 //#endregion
+//#region src/smtp-receipt.d.ts
+/**
+ * An SMTP envelope recipient that the server rejected during an otherwise
+ * successful delivery.
+ *
+ * @since 0.5.3
+ */
+interface SmtpRejectedRecipient {
+  /** The rejected recipient address. */
+  readonly recipient: string;
+  /** The three-digit SMTP reply code. */
+  readonly code: number;
+  /** The SMTP server's reply text. */
+  readonly response: string;
+  /** Whether retrying delivery to this recipient may succeed. */
+  readonly retryable: boolean;
+}
+/**
+ * A receipt returned by {@link SmtpTransport}.
+ *
+ * Successful receipts list any recipients rejected before the message was
+ * delivered to the remaining accepted recipients.  Callers can retry delivery
+ * to entries marked as retryable without redelivering to accepted recipients.
+ *
+ * @since 0.5.3
+ */
+type SmtpReceipt = (Extract<Receipt<"smtp">, {
+  readonly successful: true;
+}> & {
+  /** Recipients excluded from an otherwise successful delivery. */
+  readonly rejectedRecipients: readonly SmtpRejectedRecipient[];
+}) | Extract<Receipt<"smtp">, {
+  readonly successful: false;
+}>;
+//#endregion
 //#region src/smtp-transport.d.ts
 /**
  * SMTP transport implementation for sending emails via SMTP protocol.
@@ -504,7 +539,7 @@ declare class SmtpTransport implements Transport<"smtp">, AsyncDisposable {
    * @throws {DOMException} If the operation is aborted through
    *                        `options.signal`.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt<"smtp">>;
+  send(message: Message, options?: TransportOptions): Promise<SmtpReceipt>;
   /**
    * Sends multiple email messages efficiently using a single SMTP connection.
    *
@@ -535,7 +570,7 @@ declare class SmtpTransport implements Transport<"smtp">, AsyncDisposable {
    * @throws {DOMException} If the operation is aborted through
    *                        `options.signal`.
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<"smtp">>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<SmtpReceipt>;
   private getConnection;
   private connectAndSetup;
   private returnConnection;
@@ -600,4 +635,4 @@ declare class SmtpAuthError extends Error {
  */
 
 //#endregion
-export { DkimAlgorithm, DkimCanonicalization, DkimConfig, DkimSignature, DkimSigningFailureAction, OAuth2TokenProvider, SmtpAuth, SmtpAuthError, SmtpConfig, SmtpOAuth2Auth, SmtpOAuth2RefreshAuth, SmtpOAuth2TokenAuth, SmtpTlsOptions, SmtpTransport, SmtpUserPassAuth };
+export { DkimAlgorithm, DkimCanonicalization, DkimConfig, DkimSignature, DkimSigningFailureAction, OAuth2TokenProvider, SmtpAuth, SmtpAuthError, SmtpConfig, SmtpOAuth2Auth, SmtpOAuth2RefreshAuth, SmtpOAuth2TokenAuth, SmtpReceipt, SmtpRejectedRecipient, SmtpTlsOptions, SmtpTransport, SmtpUserPassAuth };

package/dist/index.d.ts

@@ -417,6 +417,41 @@ interface SmtpTlsOptions {
  * used internally by the SMTP transport implementation.
  */
 //#endregion
+//#region src/smtp-receipt.d.ts
+/**
+ * An SMTP envelope recipient that the server rejected during an otherwise
+ * successful delivery.
+ *
+ * @since 0.5.3
+ */
+interface SmtpRejectedRecipient {
+  /** The rejected recipient address. */
+  readonly recipient: string;
+  /** The three-digit SMTP reply code. */
+  readonly code: number;
+  /** The SMTP server's reply text. */
+  readonly response: string;
+  /** Whether retrying delivery to this recipient may succeed. */
+  readonly retryable: boolean;
+}
+/**
+ * A receipt returned by {@link SmtpTransport}.
+ *
+ * Successful receipts list any recipients rejected before the message was
+ * delivered to the remaining accepted recipients.  Callers can retry delivery
+ * to entries marked as retryable without redelivering to accepted recipients.
+ *
+ * @since 0.5.3
+ */
+type SmtpReceipt = (Extract<Receipt<"smtp">, {
+  readonly successful: true;
+}> & {
+  /** Recipients excluded from an otherwise successful delivery. */
+  readonly rejectedRecipients: readonly SmtpRejectedRecipient[];
+}) | Extract<Receipt<"smtp">, {
+  readonly successful: false;
+}>;
+//#endregion
 //#region src/smtp-transport.d.ts
 /**
  * SMTP transport implementation for sending emails via SMTP protocol.
@@ -504,7 +539,7 @@ declare class SmtpTransport implements Transport<"smtp">, AsyncDisposable {
    * @throws {DOMException} If the operation is aborted through
    *                        `options.signal`.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt<"smtp">>;
+  send(message: Message, options?: TransportOptions): Promise<SmtpReceipt>;
   /**
    * Sends multiple email messages efficiently using a single SMTP connection.
    *
@@ -535,7 +570,7 @@ declare class SmtpTransport implements Transport<"smtp">, AsyncDisposable {
    * @throws {DOMException} If the operation is aborted through
    *                        `options.signal`.
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<"smtp">>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<SmtpReceipt>;
   private getConnection;
   private connectAndSetup;
   private returnConnection;
@@ -600,4 +635,4 @@ declare class SmtpAuthError extends Error {
  */
 
 //#endregion
-export { DkimAlgorithm, DkimCanonicalization, DkimConfig, DkimSignature, DkimSigningFailureAction, OAuth2TokenProvider, SmtpAuth, SmtpAuthError, SmtpConfig, SmtpOAuth2Auth, SmtpOAuth2RefreshAuth, SmtpOAuth2TokenAuth, SmtpTlsOptions, SmtpTransport, SmtpUserPassAuth };
+export { DkimAlgorithm, DkimCanonicalization, DkimConfig, DkimSignature, DkimSigningFailureAction, OAuth2TokenProvider, SmtpAuth, SmtpAuthError, SmtpConfig, SmtpOAuth2Auth, SmtpOAuth2RefreshAuth, SmtpOAuth2TokenAuth, SmtpReceipt, SmtpRejectedRecipient, SmtpTlsOptions, SmtpTransport, SmtpUserPassAuth };

package/dist/index.js

@@ -338,6 +338,16 @@ var OAuth2TokenManager = class {
 
 //#endregion
 //#region src/smtp-connection.ts
+var SmtpPipelineTerminatedError = class extends Error {
+	responseIndex;
+	response;
+	constructor(responseIndex, response) {
+		super("SMTP pipeline terminated by the server.");
+		this.name = "SmtpPipelineTerminatedError";
+		this.responseIndex = responseIndex;
+		this.response = response;
+	}
+};
 /**
 * The maximum length of an SMTP command line, including the terminating CRLF,
 * as specified by RFC 5321 §4.5.3.1.4.
@@ -490,30 +500,59 @@ var SmtpConnection = class {
 		});
 	}
 	sendCommand(command, signal) {
+		return this.sendCommands([command], signal).then((responses) => responses[0]);
+	}
+	/**
+	* Sends a group of commands in one write and reads one reply per command.
+	*
+	* SMTP multiline replies are kept together and complete replies are matched
+	* to commands by their position in the returned array, as required for
+	* command pipelining by RFC 2920.
+	*/
+	sendCommands(commands, signal) {
 		if (!this.socket) throw new Error("Not connected");
 		signal?.throwIfAborted();
 		return new Promise((resolve, reject) => {
 			let buffer = "";
-			const timeout = setTimeout(() => {
+			let responseLines = [];
+			const responses = [];
+			const startTimeout = () => setTimeout(() => {
+				cleanup();
 				reject(/* @__PURE__ */ new Error("Command timeout"));
 			}, this.config.socketTimeout);
+			let timeout = startTimeout();
+			const resetTimeout = () => {
+				clearTimeout(timeout);
+				timeout = startTimeout();
+			};
 			const onData = (data) => {
 				buffer += data.toString();
 				const lines = buffer.split("\r\n");
 				const incompleteLine = lines.pop() || "";
-				for (let i = 0; i < lines.length; i++) {
-					const line = lines[i];
+				for (const line of lines) {
+					responseLines.push(line);
 					if (line.length >= 4 && line[3] === " ") {
 						const code = parseInt(line.substring(0, 3), 10);
 						const message = line.substring(4);
-						const fullResponse = lines.slice(0, i + 1).join("\r\n");
-						cleanup();
-						resolve({
+						const response = {
 							code,
 							message,
-							raw: fullResponse
-						});
-						return;
+							raw: responseLines.join("\r\n")
+						};
+						const responseIndex = responses.length;
+						responses.push(response);
+						responseLines = [];
+						if (responses.length === commands.length) {
+							cleanup();
+							resolve(responses);
+							return;
+						}
+						if (response.code === 421) {
+							cleanup();
+							reject(new SmtpPipelineTerminatedError(responseIndex, response));
+							return;
+						}
+						resetTimeout();
 					}
 				}
 				buffer = incompleteLine;
@@ -522,14 +561,35 @@ var SmtpConnection = class {
 				cleanup();
 				reject(error);
 			};
+			const onClose = () => {
+				cleanup();
+				const responseIndex = responses.findIndex((response) => response.code >= 400);
+				if (responseIndex >= 0) {
+					reject(new SmtpPipelineTerminatedError(responseIndex, responses[responseIndex]));
+					return;
+				}
+				reject(/* @__PURE__ */ new Error("Connection closed before all command responses."));
+			};
+			const onAbort = () => {
+				cleanup();
+				try {
+					signal?.throwIfAborted();
+				} catch (error) {
+					reject(error);
+				}
+			};
 			const cleanup = () => {
 				clearTimeout(timeout);
 				this.socket?.off("data", onData);
 				this.socket?.off("error", onError);
+				this.socket?.off("close", onClose);
+				signal?.removeEventListener("abort", onAbort);
 			};
 			this.socket.on("data", onData);
 			this.socket.on("error", onError);
-			this.socket.write(command + "\r\n");
+			this.socket.on("close", onClose);
+			signal?.addEventListener("abort", onAbort, { once: true });
+			this.socket.write(commands.map((command) => `${command}\r\n`).join(""));
 		});
 	}
 	greeting(signal) {
@@ -570,8 +630,14 @@ var SmtpConnection = class {
 	}
 	async ehlo(signal) {
 		const response = await this.sendCommand(`EHLO ${this.config.localName}`, signal);
+		if (response.code === 500 || response.code === 502) {
+			const heloResponse = await this.sendCommand(`HELO ${this.config.localName}`, signal);
+			if (heloResponse.code !== 250) throw new Error(`HELO failed: ${heloResponse.message}`);
+			this.capabilities = [];
+			return;
+		}
 		if (response.code !== 250) throw new Error(`EHLO failed: ${response.message}`);
-		this.capabilities = response.raw.split("\r\n").filter((line) => line.startsWith("250-") || line.startsWith("250 ")).map((line) => line.substring(4)).filter((line) => line.length > 0);
+		this.capabilities = response.raw.split("\r\n").filter((line) => line.startsWith("250-") || line.startsWith("250 ")).slice(1).map((line) => line.substring(4)).filter((line) => line.length > 0);
 	}
 	async starttls(signal) {
 		if (!this.socket) throw new Error("Not connected");
@@ -724,12 +790,43 @@ var SmtpConnection = class {
 		throw new SmtpAuthError(`${mechanism} authentication failed: ${response.message}`);
 	}
 	async sendMessage(message, signal) {
-		const mailResponse = await this.sendCommand(`MAIL FROM:<${message.envelope.from}>`, signal);
+		const mailCommand = `MAIL FROM:<${message.envelope.from}>`;
+		const recipientCommands = message.envelope.to.map((recipient) => `RCPT TO:<${recipient}>`);
+		const pipelining = this.capabilities.some((capability) => /^PIPELINING(?:\s|$)/i.test(capability));
+		let mailResponse;
+		let recipientResponses;
+		if (pipelining) try {
+			const envelopeResponses = await this.sendCommands([mailCommand, ...recipientCommands], signal);
+			mailResponse = envelopeResponses[0];
+			recipientResponses = envelopeResponses.slice(1);
+		} catch (error) {
+			if (!(error instanceof SmtpPipelineTerminatedError)) throw error;
+			const { response, responseIndex } = error;
+			if (responseIndex === 0) throw new SmtpResponseError(`MAIL FROM failed: ${response.message}`, response.code, "MAIL FROM", response.message);
+			const recipient = message.envelope.to[responseIndex - 1];
+			throw new SmtpResponseError(`RCPT TO failed for ${recipient}: ${response.message}`, response.code, "RCPT TO", response.message);
+		}
+		else {
+			mailResponse = await this.sendCommand(mailCommand, signal);
+			recipientResponses = [];
+		}
 		if (mailResponse.code !== 250) throw new SmtpResponseError(`MAIL FROM failed: ${mailResponse.message}`, mailResponse.code, "MAIL FROM", mailResponse.message);
-		for (const recipient of message.envelope.to) {
+		const rejectedRecipients = [];
+		for (const [index, recipient] of message.envelope.to.entries()) {
 			signal?.throwIfAborted();
-			const rcptResponse = await this.sendCommand(`RCPT TO:<${recipient}>`, signal);
-			if (rcptResponse.code !== 250) throw new SmtpResponseError(`RCPT TO failed for ${recipient}: ${rcptResponse.message}`, rcptResponse.code, "RCPT TO", rcptResponse.message);
+			const rcptResponse = pipelining ? recipientResponses[index] : await this.sendCommand(recipientCommands[index], signal);
+			if (rcptResponse.code === 421) throw new SmtpResponseError(`RCPT TO failed for ${recipient}: ${rcptResponse.message}`, rcptResponse.code, "RCPT TO", rcptResponse.message);
+			if (rcptResponse.code !== 250 && rcptResponse.code !== 251) rejectedRecipients.push({
+				recipient,
+				code: rcptResponse.code,
+				response: rcptResponse.message,
+				retryable: rcptResponse.code >= 400 && rcptResponse.code < 500
+			});
+		}
+		if (rejectedRecipients.length > 0 && rejectedRecipients.length === message.envelope.to.length) {
+			const rejection = rejectedRecipients.find((item) => item.retryable) ?? rejectedRecipients[0];
+			const details = rejectedRecipients.map((item) => `${item.recipient}: ${item.code} ${item.response}`).join("; ");
+			throw new SmtpResponseError(`RCPT TO failed for every recipient: ${details}`, rejection.code, "RCPT TO", rejection.response, rejectedRecipients);
 		}
 		const dataResponse = await this.sendCommand("DATA", signal);
 		if (dataResponse.code !== 354) throw new SmtpResponseError(`DATA failed: ${dataResponse.message}`, dataResponse.code, "DATA", dataResponse.message);
@@ -737,7 +834,10 @@ var SmtpConnection = class {
 		const finalResponse = await this.sendCommand(`${content}\r\n.`, signal);
 		if (finalResponse.code !== 250) throw new SmtpResponseError(`Message send failed: ${finalResponse.message}`, finalResponse.code, "DATA_END", finalResponse.message);
 		const messageId = this.extractMessageId(finalResponse.message);
-		return messageId;
+		return {
+			messageId,
+			rejectedRecipients
+		};
 	}
 	extractMessageId(response) {
 		const match = response.match(/(?:Message-ID:|id=)[\s<]*([^>\s]+)/i);
@@ -793,6 +893,8 @@ var SmtpResponseError = class extends Error {
 	* The textual SMTP reply returned by the server.
 	*/
 	response;
+	/** Recipient-level failures collected for an unsuccessful transaction. */
+	rejectedRecipients;
 	/**
 	* Creates an SMTP response error.
 	*
@@ -800,13 +902,16 @@ var SmtpResponseError = class extends Error {
 	* @param code The numeric SMTP reply code.
 	* @param command The SMTP command that produced the reply.
 	* @param response The textual SMTP reply returned by the server.
+	* @param rejectedRecipients Recipient-level failures collected for the
+	*                           transaction.
 	*/
-	constructor(message, code, command, response) {
+	constructor(message, code, command, response, rejectedRecipients) {
 		super(message);
 		this.name = "SmtpResponseError";
 		this.code = code;
 		this.command = command;
 		this.response = response;
+		this.rejectedRecipients = rejectedRecipients;
 	}
 };
 /**
@@ -1108,6 +1213,15 @@ function arrayBufferToBase64(buffer) {
 
 //#endregion
 //#region src/message-converter.ts
+/**
+* Converts a message to its SMTP envelope and wire representation.
+*
+* @param message The message to convert.
+* @param dkimConfig Optional DKIM signing configuration.
+* @returns The converted SMTP message.
+* @throws {RangeError} If a header contains a token that cannot be folded
+* within the RFC 5322 hard line-length limit.
+*/
 async function convertMessage(message, dkimConfig) {
 	const envelope = {
 		from: message.sender.address,
@@ -1139,11 +1253,11 @@ async function buildRawMessage(message) {
 	const hasHtml = "html" in message.content;
 	const hasText = "text" in message.content;
 	const isMultipart = hasAttachments || hasHtml && hasText;
-	lines.push(`From: ${encodeAddress(message.sender)}`);
-	lines.push(`To: ${message.recipients.map(encodeAddress).join(", ")}`);
-	if (message.ccRecipients.length > 0) lines.push(`Cc: ${message.ccRecipients.map(encodeAddress).join(", ")}`);
-	if (message.replyRecipients.length > 0) lines.push(`Reply-To: ${message.replyRecipients.map(encodeAddress).join(", ")}`);
-	lines.push(`Subject: ${encodeHeaderValue(message.subject)}`);
+	lines.push(foldHeader("From", encodeAddress(message.sender)));
+	lines.push(foldHeader("To", message.recipients.map(encodeAddress).join(", ")));
+	if (message.ccRecipients.length > 0) lines.push(foldHeader("Cc", message.ccRecipients.map(encodeAddress).join(", ")));
+	if (message.replyRecipients.length > 0) lines.push(foldHeader("Reply-To", message.replyRecipients.map(encodeAddress).join(", ")));
+	lines.push(foldHeader("Subject", encodeHeaderValue(message.subject, true)));
 	lines.push(`Date: ${(/* @__PURE__ */ new Date()).toUTCString()}`);
 	lines.push(`Message-ID: <${generateMessageId()}>`);
 	if (message.priority !== "normal") {
@@ -1151,7 +1265,7 @@ async function buildRawMessage(message) {
 		lines.push(`X-Priority: ${priorityValue}`);
 		lines.push(`X-MSMail-Priority: ${message.priority === "high" ? "High" : "Low"}`);
 	}
-	for (const [key, value] of message.headers) lines.push(`${key}: ${encodeHeaderValue(value)}`);
+	for (const [key, value] of message.headers) lines.push(foldHeader(key, encodeHeaderValue(value)));
 	lines.push("MIME-Version: 1.0");
 	if (isMultipart) {
 		lines.push(`Content-Type: multipart/mixed; boundary="${boundary}"`);
@@ -1190,12 +1304,12 @@ async function buildRawMessage(message) {
 		for (const attachment of message.attachments) {
 			lines.push("");
 			lines.push(`--${boundary}`);
-			lines.push(`Content-Type: ${attachment.contentType}; name="${attachment.filename}"`);
+			lines.push(foldHeader("Content-Type", `${attachment.contentType}; ${encodeMimeParameter("name", attachment.filename)}`));
 			lines.push("Content-Transfer-Encoding: base64");
 			if (attachment.inline) {
-				lines.push(`Content-Disposition: inline; filename="${attachment.filename}"`);
+				lines.push(foldHeader("Content-Disposition", `inline; ${encodeMimeParameter("filename", attachment.filename)}`));
 				lines.push(`Content-ID: <${attachment.contentId}>`);
-			} else lines.push(`Content-Disposition: attachment; filename="${attachment.filename}"`);
+			} else lines.push(foldHeader("Content-Disposition", `attachment; ${encodeMimeParameter("filename", attachment.filename)}`));
 			lines.push("");
 			lines.push(encodeBase64(await attachment.content));
 		}
@@ -1224,32 +1338,85 @@ function generateMessageId() {
 }
 function encodeAddress(address) {
 	if (address.name == null) return address.address;
-	const encodedDisplayName = encodeHeaderValue(address.name);
+	const encodedDisplayName = encodeHeaderValue(address.name, true);
 	return `${encodedDisplayName} <${address.address}>`;
 }
-function encodeHeaderValue(value) {
-	if (!/^[\x20-\x7E]*$/.test(value)) {
-		const utf8Bytes = new TextEncoder().encode(value);
-		const base64 = Buffer.from(utf8Bytes).toString("base64");
+function encodeHeaderValue(value, encodeLongAsciiWords = false) {
+	const hasLongWord = value.split(/\s+/).some((word) => word.length > 60);
+	if (!/^[\x20-\x7E]*$/.test(value) || encodeLongAsciiWords && hasLongWord) {
+		const encodeWord = (text) => {
+			const utf8Bytes = new TextEncoder().encode(text);
+			const base64 = Buffer.from(utf8Bytes).toString("base64");
+			return `=?UTF-8?B?${base64}?=`;
+		};
 		const maxEncodedLength = 75;
-		const encodedWord = `=?UTF-8?B?${base64}?=`;
+		const encodedWord = encodeWord(value);
 		if (encodedWord.length <= maxEncodedLength) return encodedWord;
 		const words = [];
-		let currentBase64 = "";
-		for (let i = 0; i < base64.length; i += 4) {
-			const chunk = base64.slice(i, i + 4);
-			const testWord = `=?UTF-8?B?${currentBase64}${chunk}?=`;
-			if (testWord.length <= maxEncodedLength) currentBase64 += chunk;
+		let currentText = "";
+		for (const character of value) {
+			const candidate = currentText + character;
+			if (encodeWord(candidate).length <= maxEncodedLength) currentText = candidate;
 			else {
-				if (currentBase64) words.push(`=?UTF-8?B?${currentBase64}?=`);
-				currentBase64 = chunk;
+				if (currentText.length > 0) words.push(encodeWord(currentText));
+				currentText = character;
 			}
 		}
-		if (currentBase64) words.push(`=?UTF-8?B?${currentBase64}?=`);
+		if (currentText.length > 0) words.push(encodeWord(currentText));
 		return words.join(" ");
 	}
 	return value;
 }
+function encodeMimeParameter(name, value) {
+	const escapedValue = value.replace(/[\\"]/g, "\\$&");
+	const quotedParameter = `${name}="${escapedValue}"`;
+	if (/^[\x20-\x7E]*$/.test(value) && quotedParameter.length <= 60) return quotedParameter;
+	const encodedBytes = Array.from(new TextEncoder().encode(value), (byte) => {
+		const character = String.fromCharCode(byte);
+		return /^[A-Za-z0-9!#$&+.^_`|~-]$/.test(character) ? character : `%${byte.toString(16).toUpperCase().padStart(2, "0")}`;
+	});
+	const segments = [];
+	let segment = "";
+	for (const encodedByte of encodedBytes) {
+		if (segment.length + encodedByte.length > 45) {
+			segments.push(segment);
+			segment = "";
+		}
+		segment += encodedByte;
+	}
+	if (segment.length > 0 || segments.length === 0) segments.push(segment);
+	return segments.map((part, index) => `${name}*${index}*=${index === 0 ? "UTF-8''" : ""}${part}`).join("; ");
+}
+function foldHeader(name, value) {
+	const recommendedLineLength = 78;
+	const lines = [];
+	let prefix = `${name}: `;
+	let remaining = value;
+	while (prefix.length + remaining.length > recommendedLineLength) {
+		const availableLength = recommendedLineLength - prefix.length;
+		let breakIndex = -1;
+		for (let index = Math.min(availableLength, remaining.length - 1); index >= 0; index--) if (remaining[index] === " " || remaining[index] === "	") {
+			breakIndex = index;
+			break;
+		}
+		if (breakIndex < 0) {
+			for (let index = Math.max(availableLength + 1, 0); index < remaining.length; index++) if (remaining[index] === " " || remaining[index] === "	") {
+				breakIndex = index;
+				break;
+			}
+		}
+		if (breakIndex < 0) break;
+		let whitespaceEnd = breakIndex + 1;
+		while (whitespaceEnd < remaining.length && (remaining[whitespaceEnd] === " " || remaining[whitespaceEnd] === "	")) whitespaceEnd++;
+		if (whitespaceEnd === remaining.length) break;
+		lines.push(prefix + remaining.slice(0, breakIndex));
+		prefix = remaining.slice(breakIndex, whitespaceEnd);
+		remaining = remaining.slice(whitespaceEnd);
+	}
+	lines.push(prefix + remaining);
+	if (lines.some((line) => line.length > 998)) throw new RangeError(`Header field ${name} contains a token too long to fold.`);
+	return lines.join("\r\n");
+}
 function encodeQuotedPrintable(text) {
 	const utf8Bytes = new TextEncoder().encode(text);
 	let result = "";
@@ -1380,12 +1547,13 @@ var SmtpTransport = class {
 			options?.signal?.throwIfAborted();
 			const smtpMessage = await convertMessage(message, this.config.dkim);
 			options?.signal?.throwIfAborted();
-			const messageId = await connection.sendMessage(smtpMessage, options?.signal);
+			const result = await connection.sendMessage(smtpMessage, options?.signal);
 			await this.returnConnection(connection);
 			return {
 				successful: true,
-				messageId,
-				provider: "smtp"
+				messageId: result.messageId,
+				provider: "smtp",
+				rejectedRecipients: result.rejectedRecipients
 			};
 		} catch (error) {
 			if (connection != null) await this.discardConnection(connection);
@@ -1449,11 +1617,12 @@ var SmtpTransport = class {
 				try {
 					const smtpMessage = await convertMessage(message, this.config.dkim);
 					options?.signal?.throwIfAborted();
-					const messageId = await connection.sendMessage(smtpMessage, options?.signal);
+					const result = await connection.sendMessage(smtpMessage, options?.signal);
 					yield {
 						successful: true,
-						messageId,
-						provider: "smtp"
+						messageId: result.messageId,
+						provider: "smtp",
+						rejectedRecipients: result.rejectedRecipients
 					};
 				} catch (error) {
 					options?.signal?.throwIfAborted();
@@ -1470,11 +1639,12 @@ var SmtpTransport = class {
 				try {
 					const smtpMessage = await convertMessage(message, this.config.dkim);
 					options?.signal?.throwIfAborted();
-					const messageId = await connection.sendMessage(smtpMessage, options?.signal);
+					const result = await connection.sendMessage(smtpMessage, options?.signal);
 					yield {
 						successful: true,
-						messageId,
-						provider: "smtp"
+						messageId: result.messageId,
+						provider: "smtp",
+						rejectedRecipients: result.rejectedRecipients
 					};
 				} catch (error) {
 					options?.signal?.throwIfAborted();
@@ -1583,7 +1753,8 @@ function createSmtpFailure(message, error) {
 			attempts: 1,
 			providerDetails: {
 				command: error.command,
-				response: error.response
+				response: error.response,
+				rejectedRecipients: error.rejectedRecipients
 			}
 		});
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/smtp",
-  "version": "0.6.0-dev.269",
+  "version": "0.6.0-dev.272",
   "description": "SMTP transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,7 +53,7 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.6.0-dev.269+e9149444"
+    "@upyo/core": "0.6.0-dev.272+71461772"
   },
   "devDependencies": {
     "tsdown": "^0.12.7",