@upyo/smtp 0.5.0-dev.184 → 0.5.0-dev.186

package/dist/index.cjs

@@ -669,17 +669,17 @@ var SmtpConnection = class {
 	}
 	async sendMessage(message, signal) {
 		const mailResponse = await this.sendCommand(`MAIL FROM:<${message.envelope.from}>`, signal);
-		if (mailResponse.code !== 250) throw new Error(`MAIL FROM failed: ${mailResponse.message}`);
+		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) {
 			signal?.throwIfAborted();
 			const rcptResponse = await this.sendCommand(`RCPT TO:<${recipient}>`, signal);
-			if (rcptResponse.code !== 250) throw new Error(`RCPT TO failed for ${recipient}: ${rcptResponse.message}`);
+			if (rcptResponse.code !== 250) throw new SmtpResponseError(`RCPT TO failed for ${recipient}: ${rcptResponse.message}`, rcptResponse.code, "RCPT TO", rcptResponse.message);
 		}
 		const dataResponse = await this.sendCommand("DATA", signal);
-		if (dataResponse.code !== 354) throw new Error(`DATA failed: ${dataResponse.message}`);
+		if (dataResponse.code !== 354) throw new SmtpResponseError(`DATA failed: ${dataResponse.message}`, dataResponse.code, "DATA", dataResponse.message);
 		const content = message.raw.replace(/\n\./g, "\n..");
 		const finalResponse = await this.sendCommand(`${content}\r\n.`, signal);
-		if (finalResponse.code !== 250) throw new Error(`Message send failed: ${finalResponse.message}`);
+		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;
 	}
@@ -720,6 +720,40 @@ var SmtpConnection = class {
 	}
 };
 /**
+* Error thrown when an SMTP command receives an unsuccessful server reply.
+*
+* @since 0.5.0
+*/
+var SmtpResponseError = class extends Error {
+	/**
+	* The numeric SMTP reply code returned by the server.
+	*/
+	code;
+	/**
+	* The SMTP command that produced the reply.
+	*/
+	command;
+	/**
+	* The textual SMTP reply returned by the server.
+	*/
+	response;
+	/**
+	* Creates an SMTP response error.
+	*
+	* @param message Human-readable error message.
+	* @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.
+	*/
+	constructor(message, code, command, response) {
+		super(message);
+		this.name = "SmtpResponseError";
+		this.code = code;
+		this.command = command;
+		this.response = response;
+	}
+};
+/**
 * Decodes the Base64 JSON error challenge a server sends after a failed OAuth
 * SASL exchange, falling back to the raw message when it is not valid Base64.
 *
@@ -1300,7 +1334,7 @@ var SmtpTransport = class {
 		} catch (error) {
 			if (connection != null) await this.discardConnection(connection);
 			options?.signal?.throwIfAborted();
-			return createSmtpFailure(error instanceof Error ? error.message : String(error));
+			return createSmtpFailure(error instanceof Error ? error.message : String(error), error);
 		}
 	}
 	/**
@@ -1343,7 +1377,7 @@ var SmtpTransport = class {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			for await (const _ of messages) {
 				options?.signal?.throwIfAborted();
-				yield createSmtpFailure(errorMessage);
+				yield createSmtpFailure(errorMessage, error);
 			}
 			return;
 		}
@@ -1368,7 +1402,7 @@ var SmtpTransport = class {
 				} catch (error) {
 					options?.signal?.throwIfAborted();
 					connectionValid = false;
-					yield createSmtpFailure(error instanceof Error ? error.message : String(error));
+					yield createSmtpFailure(error instanceof Error ? error.message : String(error), error);
 				}
 			}
 			else for (const message of messages) {
@@ -1389,7 +1423,7 @@ var SmtpTransport = class {
 				} catch (error) {
 					options?.signal?.throwIfAborted();
 					connectionValid = false;
-					yield createSmtpFailure(error instanceof Error ? error.message : String(error));
+					yield createSmtpFailure(error instanceof Error ? error.message : String(error), error);
 				}
 			}
 			if (connectionValid) await this.returnConnection(connection);
@@ -1482,12 +1516,40 @@ var SmtpTransport = class {
 		await this.closeAllConnections();
 	}
 };
-function createSmtpFailure(message) {
+function createSmtpFailure(message, error) {
+	if (error instanceof SmtpResponseError) {
+		const classification = classifySmtpReply(error.code);
+		return (0, __upyo_core.createFailedReceipt)(message, {
+			provider: "smtp",
+			code: `smtp.${error.code}`,
+			category: classification.category,
+			retryable: classification.retryable,
+			attempts: 1,
+			providerDetails: {
+				command: error.command,
+				response: error.response
+			}
+		});
+	}
 	return (0, __upyo_core.createFailedReceipt)(message, {
 		provider: "smtp",
 		attempts: 1
 	});
 }
+function classifySmtpReply(code) {
+	if (code >= 400 && code < 500) return {
+		category: "service-unavailable",
+		retryable: true
+	};
+	if (code >= 500 && code < 600) return {
+		category: "rejected",
+		retryable: false
+	};
+	return {
+		category: "unknown",
+		retryable: false
+	};
+}
 
 //#endregion
 exports.SmtpAuthError = SmtpAuthError;

package/dist/index.js

@@ -646,17 +646,17 @@ var SmtpConnection = class {
 	}
 	async sendMessage(message, signal) {
 		const mailResponse = await this.sendCommand(`MAIL FROM:<${message.envelope.from}>`, signal);
-		if (mailResponse.code !== 250) throw new Error(`MAIL FROM failed: ${mailResponse.message}`);
+		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) {
 			signal?.throwIfAborted();
 			const rcptResponse = await this.sendCommand(`RCPT TO:<${recipient}>`, signal);
-			if (rcptResponse.code !== 250) throw new Error(`RCPT TO failed for ${recipient}: ${rcptResponse.message}`);
+			if (rcptResponse.code !== 250) throw new SmtpResponseError(`RCPT TO failed for ${recipient}: ${rcptResponse.message}`, rcptResponse.code, "RCPT TO", rcptResponse.message);
 		}
 		const dataResponse = await this.sendCommand("DATA", signal);
-		if (dataResponse.code !== 354) throw new Error(`DATA failed: ${dataResponse.message}`);
+		if (dataResponse.code !== 354) throw new SmtpResponseError(`DATA failed: ${dataResponse.message}`, dataResponse.code, "DATA", dataResponse.message);
 		const content = message.raw.replace(/\n\./g, "\n..");
 		const finalResponse = await this.sendCommand(`${content}\r\n.`, signal);
-		if (finalResponse.code !== 250) throw new Error(`Message send failed: ${finalResponse.message}`);
+		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;
 	}
@@ -697,6 +697,40 @@ var SmtpConnection = class {
 	}
 };
 /**
+* Error thrown when an SMTP command receives an unsuccessful server reply.
+*
+* @since 0.5.0
+*/
+var SmtpResponseError = class extends Error {
+	/**
+	* The numeric SMTP reply code returned by the server.
+	*/
+	code;
+	/**
+	* The SMTP command that produced the reply.
+	*/
+	command;
+	/**
+	* The textual SMTP reply returned by the server.
+	*/
+	response;
+	/**
+	* Creates an SMTP response error.
+	*
+	* @param message Human-readable error message.
+	* @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.
+	*/
+	constructor(message, code, command, response) {
+		super(message);
+		this.name = "SmtpResponseError";
+		this.code = code;
+		this.command = command;
+		this.response = response;
+	}
+};
+/**
 * Decodes the Base64 JSON error challenge a server sends after a failed OAuth
 * SASL exchange, falling back to the raw message when it is not valid Base64.
 *
@@ -1277,7 +1311,7 @@ var SmtpTransport = class {
 		} catch (error) {
 			if (connection != null) await this.discardConnection(connection);
 			options?.signal?.throwIfAborted();
-			return createSmtpFailure(error instanceof Error ? error.message : String(error));
+			return createSmtpFailure(error instanceof Error ? error.message : String(error), error);
 		}
 	}
 	/**
@@ -1320,7 +1354,7 @@ var SmtpTransport = class {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			for await (const _ of messages) {
 				options?.signal?.throwIfAborted();
-				yield createSmtpFailure(errorMessage);
+				yield createSmtpFailure(errorMessage, error);
 			}
 			return;
 		}
@@ -1345,7 +1379,7 @@ var SmtpTransport = class {
 				} catch (error) {
 					options?.signal?.throwIfAborted();
 					connectionValid = false;
-					yield createSmtpFailure(error instanceof Error ? error.message : String(error));
+					yield createSmtpFailure(error instanceof Error ? error.message : String(error), error);
 				}
 			}
 			else for (const message of messages) {
@@ -1366,7 +1400,7 @@ var SmtpTransport = class {
 				} catch (error) {
 					options?.signal?.throwIfAborted();
 					connectionValid = false;
-					yield createSmtpFailure(error instanceof Error ? error.message : String(error));
+					yield createSmtpFailure(error instanceof Error ? error.message : String(error), error);
 				}
 			}
 			if (connectionValid) await this.returnConnection(connection);
@@ -1459,12 +1493,40 @@ var SmtpTransport = class {
 		await this.closeAllConnections();
 	}
 };
-function createSmtpFailure(message) {
+function createSmtpFailure(message, error) {
+	if (error instanceof SmtpResponseError) {
+		const classification = classifySmtpReply(error.code);
+		return createFailedReceipt(message, {
+			provider: "smtp",
+			code: `smtp.${error.code}`,
+			category: classification.category,
+			retryable: classification.retryable,
+			attempts: 1,
+			providerDetails: {
+				command: error.command,
+				response: error.response
+			}
+		});
+	}
 	return createFailedReceipt(message, {
 		provider: "smtp",
 		attempts: 1
 	});
 }
+function classifySmtpReply(code) {
+	if (code >= 400 && code < 500) return {
+		category: "service-unavailable",
+		retryable: true
+	};
+	if (code >= 500 && code < 600) return {
+		category: "rejected",
+		retryable: false
+	};
+	return {
+		category: "unknown",
+		retryable: false
+	};
+}
 
 //#endregion
 export { SmtpAuthError, SmtpTransport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/smtp",
-  "version": "0.5.0-dev.184",
+  "version": "0.5.0-dev.186",
   "description": "SMTP transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,7 +53,7 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.5.0-dev.184+f9b152b6"
+    "@upyo/core": "0.5.0-dev.186+096ec68f"
   },
   "devDependencies": {
     "tsdown": "^0.12.7",