@upyo/smtp 0.6.0-dev.299 → 0.6.0-dev.303

package/dist/index.cjs

@@ -563,6 +563,37 @@ var SmtpPipelineTerminatedError = class extends Error {
 	}
 };
 /**
+* An authentication failure backed by an SMTP server reply.
+*
+* This keeps {@link SmtpAuthError} as the public authentication error while
+* retaining the reply fields needed to build structured transport receipts.
+*
+* @since 0.6.0
+*/
+var SmtpAuthResponseError = class extends SmtpAuthError {
+	/** The numeric SMTP reply code returned by the server. */
+	code;
+	/** The authentication command that produced the reply. */
+	command;
+	/** The textual SMTP reply returned by the server. */
+	response;
+	/**
+	* Creates an authentication response error.
+	*
+	* @param message A human-readable description of the authentication failure.
+	* @param code The numeric SMTP reply code.
+	* @param command The authentication command that produced the reply.
+	* @param response The textual SMTP reply returned by the server.
+	*/
+	constructor(message, code, command, response) {
+		super(message);
+		this.name = "SmtpAuthResponseError";
+		this.code = code;
+		this.command = command;
+		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.
 */
@@ -866,11 +897,11 @@ var SmtpConnection = class {
 		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}`);
+			if (heloResponse.code !== 250) throw new SmtpResponseError(`HELO failed: ${heloResponse.message}`, heloResponse.code, "HELO", heloResponse.message);
 			this.capabilities = [];
 			return;
 		}
-		if (response.code !== 250) throw new Error(`EHLO failed: ${response.message}`);
+		if (response.code !== 250) throw new SmtpResponseError(`EHLO failed: ${response.message}`, response.code, "EHLO", response.message);
 		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) {
@@ -878,7 +909,7 @@ var SmtpConnection = class {
 		if (this.socket instanceof node_tls.TLSSocket) throw new Error("Connection is already using TLS");
 		signal?.throwIfAborted();
 		const response = await this.sendCommand("STARTTLS", signal);
-		if (response.code !== 220) throw new Error(`STARTTLS failed: ${response.message}`);
+		if (response.code !== 220) throw new SmtpResponseError(`STARTTLS failed: ${response.message}`, response.code, "STARTTLS", response.message);
 		signal?.throwIfAborted();
 		return new Promise((resolve, reject) => {
 			const timeout = setTimeout(() => {
@@ -951,16 +982,16 @@ var SmtpConnection = class {
 		const { user, pass } = auth;
 		const credentials = btoa(`\0${user}\0${pass}`);
 		const response = await this.sendCommand(`AUTH PLAIN ${credentials}`, signal);
-		if (response.code !== 235) throw new Error(`Authentication failed: ${response.message}`);
+		if (response.code !== 235) throw new SmtpAuthResponseError(`Authentication failed: ${response.message}`, response.code, "AUTH PLAIN", response.message);
 	}
 	async authLogin(auth, signal) {
 		const { user, pass } = auth;
 		let response = await this.sendCommand("AUTH LOGIN", signal);
-		if (response.code !== 334) throw new Error(`AUTH LOGIN failed: ${response.message}`);
+		if (response.code !== 334) throw new SmtpAuthResponseError(`AUTH LOGIN failed: ${response.message}`, response.code, "AUTH LOGIN", response.message);
 		response = await this.sendCommand(btoa(user), signal);
-		if (response.code !== 334) throw new Error(`Username authentication failed: ${response.message}`);
+		if (response.code !== 334) throw new SmtpAuthResponseError(`Username authentication failed: ${response.message}`, response.code, "AUTH LOGIN", response.message);
 		response = await this.sendCommand(btoa(pass), signal);
-		if (response.code !== 235) throw new Error(`Password authentication failed: ${response.message}`);
+		if (response.code !== 235) throw new SmtpAuthResponseError(`Password authentication failed: ${response.message}`, response.code, "AUTH LOGIN", response.message);
 	}
 	/**
 	* Resolves an OAuth 2.0 access token via the connection's token manager,
@@ -1012,16 +1043,19 @@ var SmtpConnection = class {
 	async finishOAuth2(response, mechanism, continuation, signal) {
 		if (response.code === 235) return;
 		if (response.code === 334) {
+			let finalResponse;
 			let finalMessage = "";
 			try {
-				const final = await this.sendCommand(continuation, signal);
-				finalMessage = ` (${final.message})`;
+				finalResponse = await this.sendCommand(continuation, signal);
+				finalMessage = ` (${finalResponse.message})`;
 			} catch {
 				signal?.throwIfAborted();
 			}
-			throw new SmtpAuthError(`${mechanism} authentication failed: ${decodeOAuth2Challenge(response.message)}${finalMessage}`);
+			const message = `${mechanism} authentication failed: ${decodeOAuth2Challenge(response.message)}${finalMessage}`;
+			if (finalResponse != null) throw new SmtpAuthResponseError(message, finalResponse.code, `AUTH ${mechanism}`, finalResponse.message);
+			throw new SmtpAuthError(message);
 		}
-		throw new SmtpAuthError(`${mechanism} authentication failed: ${response.message}`);
+		throw new SmtpAuthResponseError(`${mechanism} authentication failed: ${response.message}`, response.code, `AUTH ${mechanism}`, response.message);
 	}
 	async sendMessage(message, signal) {
 		signal?.throwIfAborted();
@@ -1949,7 +1983,7 @@ var SmtpTransport = class {
 		await connection.connect(signal);
 		signal?.throwIfAborted();
 		const greeting = await connection.greeting(signal);
-		if (greeting.code !== 220) throw new Error(`Server greeting failed: ${greeting.message}`);
+		if (greeting.code !== 220) throw new SmtpResponseError(`Server greeting failed: ${greeting.message}`, greeting.code, "GREETING", greeting.message);
 		signal?.throwIfAborted();
 		await connection.ehlo(signal);
 		signal?.throwIfAborted();
@@ -2049,7 +2083,7 @@ function createSmtpFailure(message, error) {
 		attempts: 1,
 		providerDetails: { missingCapability: error.missingCapability }
 	});
-	if (error instanceof SmtpResponseError) {
+	if (error instanceof SmtpResponseError || error instanceof SmtpAuthResponseError) {
 		const enhancedStatusCode = parseEnhancedSmtpStatusCode(error.code, error.response);
 		const classification = classifySmtpReply(error.code, enhancedStatusCode);
 		return (0, __upyo_core.createFailedReceipt)(message, {
@@ -2061,7 +2095,7 @@ function createSmtpFailure(message, error) {
 			providerDetails: {
 				command: error.command,
 				response: error.response,
-				rejectedRecipients: error.rejectedRecipients,
+				rejectedRecipients: error instanceof SmtpResponseError ? error.rejectedRecipients : void 0,
 				...enhancedStatusCode == null ? {} : { enhancedStatusCode }
 			}
 		});

package/dist/index.js

@@ -540,6 +540,37 @@ var SmtpPipelineTerminatedError = class extends Error {
 	}
 };
 /**
+* An authentication failure backed by an SMTP server reply.
+*
+* This keeps {@link SmtpAuthError} as the public authentication error while
+* retaining the reply fields needed to build structured transport receipts.
+*
+* @since 0.6.0
+*/
+var SmtpAuthResponseError = class extends SmtpAuthError {
+	/** The numeric SMTP reply code returned by the server. */
+	code;
+	/** The authentication command that produced the reply. */
+	command;
+	/** The textual SMTP reply returned by the server. */
+	response;
+	/**
+	* Creates an authentication response error.
+	*
+	* @param message A human-readable description of the authentication failure.
+	* @param code The numeric SMTP reply code.
+	* @param command The authentication command that produced the reply.
+	* @param response The textual SMTP reply returned by the server.
+	*/
+	constructor(message, code, command, response) {
+		super(message);
+		this.name = "SmtpAuthResponseError";
+		this.code = code;
+		this.command = command;
+		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.
 */
@@ -843,11 +874,11 @@ var SmtpConnection = class {
 		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}`);
+			if (heloResponse.code !== 250) throw new SmtpResponseError(`HELO failed: ${heloResponse.message}`, heloResponse.code, "HELO", heloResponse.message);
 			this.capabilities = [];
 			return;
 		}
-		if (response.code !== 250) throw new Error(`EHLO failed: ${response.message}`);
+		if (response.code !== 250) throw new SmtpResponseError(`EHLO failed: ${response.message}`, response.code, "EHLO", response.message);
 		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) {
@@ -855,7 +886,7 @@ var SmtpConnection = class {
 		if (this.socket instanceof TLSSocket) throw new Error("Connection is already using TLS");
 		signal?.throwIfAborted();
 		const response = await this.sendCommand("STARTTLS", signal);
-		if (response.code !== 220) throw new Error(`STARTTLS failed: ${response.message}`);
+		if (response.code !== 220) throw new SmtpResponseError(`STARTTLS failed: ${response.message}`, response.code, "STARTTLS", response.message);
 		signal?.throwIfAborted();
 		return new Promise((resolve, reject) => {
 			const timeout = setTimeout(() => {
@@ -928,16 +959,16 @@ var SmtpConnection = class {
 		const { user, pass } = auth;
 		const credentials = btoa(`\0${user}\0${pass}`);
 		const response = await this.sendCommand(`AUTH PLAIN ${credentials}`, signal);
-		if (response.code !== 235) throw new Error(`Authentication failed: ${response.message}`);
+		if (response.code !== 235) throw new SmtpAuthResponseError(`Authentication failed: ${response.message}`, response.code, "AUTH PLAIN", response.message);
 	}
 	async authLogin(auth, signal) {
 		const { user, pass } = auth;
 		let response = await this.sendCommand("AUTH LOGIN", signal);
-		if (response.code !== 334) throw new Error(`AUTH LOGIN failed: ${response.message}`);
+		if (response.code !== 334) throw new SmtpAuthResponseError(`AUTH LOGIN failed: ${response.message}`, response.code, "AUTH LOGIN", response.message);
 		response = await this.sendCommand(btoa(user), signal);
-		if (response.code !== 334) throw new Error(`Username authentication failed: ${response.message}`);
+		if (response.code !== 334) throw new SmtpAuthResponseError(`Username authentication failed: ${response.message}`, response.code, "AUTH LOGIN", response.message);
 		response = await this.sendCommand(btoa(pass), signal);
-		if (response.code !== 235) throw new Error(`Password authentication failed: ${response.message}`);
+		if (response.code !== 235) throw new SmtpAuthResponseError(`Password authentication failed: ${response.message}`, response.code, "AUTH LOGIN", response.message);
 	}
 	/**
 	* Resolves an OAuth 2.0 access token via the connection's token manager,
@@ -989,16 +1020,19 @@ var SmtpConnection = class {
 	async finishOAuth2(response, mechanism, continuation, signal) {
 		if (response.code === 235) return;
 		if (response.code === 334) {
+			let finalResponse;
 			let finalMessage = "";
 			try {
-				const final = await this.sendCommand(continuation, signal);
-				finalMessage = ` (${final.message})`;
+				finalResponse = await this.sendCommand(continuation, signal);
+				finalMessage = ` (${finalResponse.message})`;
 			} catch {
 				signal?.throwIfAborted();
 			}
-			throw new SmtpAuthError(`${mechanism} authentication failed: ${decodeOAuth2Challenge(response.message)}${finalMessage}`);
+			const message = `${mechanism} authentication failed: ${decodeOAuth2Challenge(response.message)}${finalMessage}`;
+			if (finalResponse != null) throw new SmtpAuthResponseError(message, finalResponse.code, `AUTH ${mechanism}`, finalResponse.message);
+			throw new SmtpAuthError(message);
 		}
-		throw new SmtpAuthError(`${mechanism} authentication failed: ${response.message}`);
+		throw new SmtpAuthResponseError(`${mechanism} authentication failed: ${response.message}`, response.code, `AUTH ${mechanism}`, response.message);
 	}
 	async sendMessage(message, signal) {
 		signal?.throwIfAborted();
@@ -1926,7 +1960,7 @@ var SmtpTransport = class {
 		await connection.connect(signal);
 		signal?.throwIfAborted();
 		const greeting = await connection.greeting(signal);
-		if (greeting.code !== 220) throw new Error(`Server greeting failed: ${greeting.message}`);
+		if (greeting.code !== 220) throw new SmtpResponseError(`Server greeting failed: ${greeting.message}`, greeting.code, "GREETING", greeting.message);
 		signal?.throwIfAborted();
 		await connection.ehlo(signal);
 		signal?.throwIfAborted();
@@ -2026,7 +2060,7 @@ function createSmtpFailure(message, error) {
 		attempts: 1,
 		providerDetails: { missingCapability: error.missingCapability }
 	});
-	if (error instanceof SmtpResponseError) {
+	if (error instanceof SmtpResponseError || error instanceof SmtpAuthResponseError) {
 		const enhancedStatusCode = parseEnhancedSmtpStatusCode(error.code, error.response);
 		const classification = classifySmtpReply(error.code, enhancedStatusCode);
 		return createFailedReceipt(message, {
@@ -2038,7 +2072,7 @@ function createSmtpFailure(message, error) {
 			providerDetails: {
 				command: error.command,
 				response: error.response,
-				rejectedRecipients: error.rejectedRecipients,
+				rejectedRecipients: error instanceof SmtpResponseError ? error.rejectedRecipients : void 0,
 				...enhancedStatusCode == null ? {} : { enhancedStatusCode }
 			}
 		});

package/package.json

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