@upyo/mailtrap 0.6.0-dev.368 → 0.6.0

package/README.md

@@ -3,6 +3,8 @@
 @upyo/mailtrap
 ==============
 
+*This transport is introduced in Upyo 0.6.0.*
+
 [![JSR][JSR badge]][JSR]
 [![npm][npm badge]][npm]
 

package/dist/index.cjs

@@ -127,6 +127,31 @@ var MailtrapTimeoutError = class extends Error {
 	}
 };
 /**
+* Failure to read a successful Mailtrap response after the request was accepted.
+* Retrying the request could send the message again.
+*
+* @since 0.6.0
+*/
+var MailtrapResponseError = class extends Error {
+	/**
+	* Number of attempts made before this error was produced.
+	*
+	* @since 0.6.0
+	*/
+	attempts;
+	/**
+	* Creates an error for an unreadable successful response.
+	*
+	* @param cause The response body error, including a possible timeout.
+	* @param attempts Number of attempts made before this error.
+	*/
+	constructor(cause, attempts) {
+		super(cause instanceof Error ? cause.message : String(cause), { cause });
+		this.name = "MailtrapResponseError";
+		this.attempts = attempts;
+	}
+};
+/**
 * HTTP client wrapper for Mailtrap API requests.
 *
 * @since 0.6.0
@@ -182,6 +207,7 @@ var MailtrapHttpClient = class {
 				}
 			} catch (error) {
 				lastError = error instanceof Error ? error : new Error(String(error));
+				if (error instanceof MailtrapResponseError) throw new MailtrapResponseError(error.cause, attempt + 1);
 				if (error instanceof MailtrapApiError && !isRetryable(error)) throw error;
 				if (error instanceof Error && error.name === "AbortError" && signal?.aborted) throw error;
 				if (attempt === this.config.retries) throw withAttempts(lastError, attempt + 1);
@@ -206,8 +232,9 @@ var MailtrapHttpClient = class {
 		const timeoutController = new AbortController();
 		const timeoutId = this.config.timeout > 0 ? setTimeout(() => timeoutController.abort(), this.config.timeout) : void 0;
 		const requestSignal = (0, __upyo_core.combineSignals)(timeoutController.signal, signal);
+		let response;
 		try {
-			const response = await globalThis.fetch(url, {
+			response = await globalThis.fetch(url, {
 				method: "POST",
 				headers,
 				body: JSON.stringify(body),
@@ -219,8 +246,11 @@ var MailtrapHttpClient = class {
 				text
 			};
 		} catch (error) {
-			if (error instanceof Error && error.name === "AbortError" && timeoutController.signal.aborted && !signal?.aborted) throw new MailtrapTimeoutError(this.config.timeout);
-			throw error;
+			signal?.throwIfAborted();
+			let cause = error;
+			if (error instanceof Error && error.name === "AbortError" && timeoutController.signal.aborted && !signal?.aborted) cause = new MailtrapTimeoutError(this.config.timeout);
+			if (response?.ok) throw new MailtrapResponseError(cause);
+			throw cause;
 		} finally {
 			requestSignal.cleanup();
 			if (timeoutId !== void 0) clearTimeout(timeoutId);
@@ -401,7 +431,7 @@ function uint8ArrayToBase64(bytes) {
 	if (nativeToBase64 != null) return nativeToBase64();
 	const bufferBase64 = getBufferBase64(bytes);
 	if (bufferBase64 != null) return bufferBase64;
-	const chunkSize = 32768;
+	const chunkSize = 4096;
 	const chunks = [];
 	for (let offset = 0; offset < bytes.length; offset += chunkSize) chunks.push(String.fromCharCode(...bytes.subarray(offset, offset + chunkSize)));
 	return btoa(chunks.join(""));
@@ -608,6 +638,15 @@ function toReceipt(response, options) {
 	};
 }
 function createMailtrapFailure(message, error) {
+	if (error instanceof MailtrapResponseError) return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "mailtrap",
+		...error.cause instanceof MailtrapTimeoutError ? {
+			category: "timeout",
+			code: "timeout"
+		} : {},
+		retryable: false,
+		attempts: error.attempts
+	});
 	if (error instanceof MailtrapApiError) return (0, __upyo_core.createFailedReceipt)(message, {
 		provider: "mailtrap",
 		statusCode: error.statusCode,
@@ -644,6 +683,7 @@ function isCallerAbort(error, signal) {
 
 //#endregion
 exports.MailtrapApiError = MailtrapApiError;
+exports.MailtrapResponseError = MailtrapResponseError;
 exports.MailtrapTimeoutError = MailtrapTimeoutError;
 exports.MailtrapTransport = MailtrapTransport;
 exports.createMailtrapConfig = createMailtrapConfig;

package/dist/index.d.cts

@@ -315,10 +315,31 @@ declare class MailtrapTimeoutError extends Error {
    */
   constructor(timeout: number, attempts?: number);
 }
+/**
+ * Failure to read a successful Mailtrap response after the request was accepted.
+ * Retrying the request could send the message again.
+ *
+ * @since 0.6.0
+ */
+declare class MailtrapResponseError extends Error {
+  /**
+   * Number of attempts made before this error was produced.
+   *
+   * @since 0.6.0
+   */
+  readonly attempts?: number;
+  /**
+   * Creates an error for an unreadable successful response.
+   *
+   * @param cause The response body error, including a possible timeout.
+   * @param attempts Number of attempts made before this error.
+   */
+  constructor(cause: unknown, attempts?: number);
+}
 /**
  * HTTP client wrapper for Mailtrap API requests.
  *
  * @since 0.6.0
  */
 //#endregion
-export { MailtrapAddress, MailtrapApiError, MailtrapAttachment, MailtrapBatchItemResponse, MailtrapBatchResponse, MailtrapConfig, MailtrapEmail, MailtrapError, MailtrapSendResponse, MailtrapTimeoutError, MailtrapTransport, ResolvedMailtrapConfig, createMailtrapConfig };
+export { MailtrapAddress, MailtrapApiError, MailtrapAttachment, MailtrapBatchItemResponse, MailtrapBatchResponse, MailtrapConfig, MailtrapEmail, MailtrapError, MailtrapResponseError, MailtrapSendResponse, MailtrapTimeoutError, MailtrapTransport, ResolvedMailtrapConfig, createMailtrapConfig };

package/dist/index.d.ts

@@ -315,10 +315,31 @@ declare class MailtrapTimeoutError extends Error {
    */
   constructor(timeout: number, attempts?: number);
 }
+/**
+ * Failure to read a successful Mailtrap response after the request was accepted.
+ * Retrying the request could send the message again.
+ *
+ * @since 0.6.0
+ */
+declare class MailtrapResponseError extends Error {
+  /**
+   * Number of attempts made before this error was produced.
+   *
+   * @since 0.6.0
+   */
+  readonly attempts?: number;
+  /**
+   * Creates an error for an unreadable successful response.
+   *
+   * @param cause The response body error, including a possible timeout.
+   * @param attempts Number of attempts made before this error.
+   */
+  constructor(cause: unknown, attempts?: number);
+}
 /**
  * HTTP client wrapper for Mailtrap API requests.
  *
  * @since 0.6.0
  */
 //#endregion
-export { MailtrapAddress, MailtrapApiError, MailtrapAttachment, MailtrapBatchItemResponse, MailtrapBatchResponse, MailtrapConfig, MailtrapEmail, MailtrapError, MailtrapSendResponse, MailtrapTimeoutError, MailtrapTransport, ResolvedMailtrapConfig, createMailtrapConfig };
+export { MailtrapAddress, MailtrapApiError, MailtrapAttachment, MailtrapBatchItemResponse, MailtrapBatchResponse, MailtrapConfig, MailtrapEmail, MailtrapError, MailtrapResponseError, MailtrapSendResponse, MailtrapTimeoutError, MailtrapTransport, ResolvedMailtrapConfig, createMailtrapConfig };

package/dist/index.js

@@ -104,6 +104,31 @@ var MailtrapTimeoutError = class extends Error {
 	}
 };
 /**
+* Failure to read a successful Mailtrap response after the request was accepted.
+* Retrying the request could send the message again.
+*
+* @since 0.6.0
+*/
+var MailtrapResponseError = class extends Error {
+	/**
+	* Number of attempts made before this error was produced.
+	*
+	* @since 0.6.0
+	*/
+	attempts;
+	/**
+	* Creates an error for an unreadable successful response.
+	*
+	* @param cause The response body error, including a possible timeout.
+	* @param attempts Number of attempts made before this error.
+	*/
+	constructor(cause, attempts) {
+		super(cause instanceof Error ? cause.message : String(cause), { cause });
+		this.name = "MailtrapResponseError";
+		this.attempts = attempts;
+	}
+};
+/**
 * HTTP client wrapper for Mailtrap API requests.
 *
 * @since 0.6.0
@@ -159,6 +184,7 @@ var MailtrapHttpClient = class {
 				}
 			} catch (error) {
 				lastError = error instanceof Error ? error : new Error(String(error));
+				if (error instanceof MailtrapResponseError) throw new MailtrapResponseError(error.cause, attempt + 1);
 				if (error instanceof MailtrapApiError && !isRetryable(error)) throw error;
 				if (error instanceof Error && error.name === "AbortError" && signal?.aborted) throw error;
 				if (attempt === this.config.retries) throw withAttempts(lastError, attempt + 1);
@@ -183,8 +209,9 @@ var MailtrapHttpClient = class {
 		const timeoutController = new AbortController();
 		const timeoutId = this.config.timeout > 0 ? setTimeout(() => timeoutController.abort(), this.config.timeout) : void 0;
 		const requestSignal = combineSignals(timeoutController.signal, signal);
+		let response;
 		try {
-			const response = await globalThis.fetch(url, {
+			response = await globalThis.fetch(url, {
 				method: "POST",
 				headers,
 				body: JSON.stringify(body),
@@ -196,8 +223,11 @@ var MailtrapHttpClient = class {
 				text
 			};
 		} catch (error) {
-			if (error instanceof Error && error.name === "AbortError" && timeoutController.signal.aborted && !signal?.aborted) throw new MailtrapTimeoutError(this.config.timeout);
-			throw error;
+			signal?.throwIfAborted();
+			let cause = error;
+			if (error instanceof Error && error.name === "AbortError" && timeoutController.signal.aborted && !signal?.aborted) cause = new MailtrapTimeoutError(this.config.timeout);
+			if (response?.ok) throw new MailtrapResponseError(cause);
+			throw cause;
 		} finally {
 			requestSignal.cleanup();
 			if (timeoutId !== void 0) clearTimeout(timeoutId);
@@ -378,7 +408,7 @@ function uint8ArrayToBase64(bytes) {
 	if (nativeToBase64 != null) return nativeToBase64();
 	const bufferBase64 = getBufferBase64(bytes);
 	if (bufferBase64 != null) return bufferBase64;
-	const chunkSize = 32768;
+	const chunkSize = 4096;
 	const chunks = [];
 	for (let offset = 0; offset < bytes.length; offset += chunkSize) chunks.push(String.fromCharCode(...bytes.subarray(offset, offset + chunkSize)));
 	return btoa(chunks.join(""));
@@ -585,6 +615,15 @@ function toReceipt(response, options) {
 	};
 }
 function createMailtrapFailure(message, error) {
+	if (error instanceof MailtrapResponseError) return createFailedReceipt(message, {
+		provider: "mailtrap",
+		...error.cause instanceof MailtrapTimeoutError ? {
+			category: "timeout",
+			code: "timeout"
+		} : {},
+		retryable: false,
+		attempts: error.attempts
+	});
 	if (error instanceof MailtrapApiError) return createFailedReceipt(message, {
 		provider: "mailtrap",
 		statusCode: error.statusCode,
@@ -620,4 +659,4 @@ function isCallerAbort(error, signal) {
 }
 
 //#endregion
-export { MailtrapApiError, MailtrapTimeoutError, MailtrapTransport, createMailtrapConfig };
+export { MailtrapApiError, MailtrapResponseError, MailtrapTimeoutError, MailtrapTransport, createMailtrapConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/mailtrap",
-  "version": "0.6.0-dev.368",
+  "version": "0.6.0",
   "description": "Mailtrap transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,7 +53,7 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.6.0-dev.368+609357ef"
+    "@upyo/core": "0.6.0"
   },
   "devDependencies": {
     "tsdown": "^0.12.7",