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

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.
 */
@@ -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();
@@ -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.
 */
@@ -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();
@@ -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.301",
   "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.301+877ca1c9"
   },
   "devDependencies": {
     "tsdown": "^0.12.7",