@upyo/resend 0.5.0-dev.86 → 0.5.0

package/dist/index.cjs

@@ -1,3 +1,27 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const __upyo_core = __toESM(require("@upyo/core"));
 
 //#region src/config.ts
 /**
@@ -25,14 +49,37 @@ function createResendConfig(config) {
 //#endregion
 //#region src/http-client.ts
 /**
-* Resend API error class for handling API-specific errors.
+* Error thrown when a Resend API request fails.
+*
+* @since 0.5.0
 */
 var ResendApiError = class extends Error {
+	/**
+	* HTTP status code returned by Resend, if the request reached the API.
+	*/
 	statusCode;
-	constructor(message, statusCode) {
+	/**
+	* Retry delay from Resend's `Retry-After` response header.
+	*/
+	retryAfterMilliseconds;
+	/**
+	* Number of attempts made before this error was produced.
+	*/
+	attempts;
+	/**
+	* Creates a Resend API error.
+	*
+	* @param message Error message.
+	* @param statusCode HTTP status code returned by Resend.
+	* @param retryAfterMilliseconds Retry delay from the response.
+	* @param attempts Number of attempts made before this error.
+	*/
+	constructor(message, statusCode, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "ResendApiError";
 		this.statusCode = statusCode;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
 /**
@@ -102,7 +149,10 @@ var ResendHttpClient = class {
 					const errorBody = JSON.parse(text);
 					errorMessage = errorBody.message;
 				} catch {}
-				throw new ResendApiError(errorMessage || text || `HTTP ${response.status}`, response.status);
+				const parsedErrorMessage = errorMessage === "" ? void 0 : errorMessage;
+				const responseMessage = truncateErrorBody(text);
+				const fallbackMessage = responseMessage === "" ? void 0 : responseMessage;
+				throw new ResendApiError(parsedErrorMessage ?? fallbackMessage ?? `HTTP ${response.status}`, response.status, (0, __upyo_core.parseRetryAfter)(response.headers.get("Retry-After")), attempt + 1);
 			}
 			try {
 				return JSON.parse(text);
@@ -110,10 +160,14 @@ var ResendHttpClient = class {
 				throw new Error(`Invalid JSON response from Resend API: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
 			}
 		} catch (error) {
+			if (isCallerAbort$1(error, options.signal)) throw error;
 			lastError = error instanceof Error ? error : new Error(String(error));
-			if (error instanceof ResendApiError && error.statusCode >= 400 && error.statusCode < 500) throw error;
+			if (error instanceof ResendApiError && error.statusCode !== void 0 && error.statusCode >= 400 && error.statusCode < 500) throw error;
 			if (error instanceof Error && error.name === "AbortError") throw error;
-			if (attempt === this.config.retries) throw lastError;
+			if (attempt === this.config.retries) {
+				if (lastError instanceof ResendApiError) throw lastError;
+				throw new ResendApiError(lastError.message, void 0, void 0, attempt + 1);
+			}
 			const backoffMs = Math.min(1e3 * Math.pow(2, attempt), 1e4);
 			await new Promise((resolve) => setTimeout(resolve, backoffMs));
 		}
@@ -132,26 +186,32 @@ var ResendHttpClient = class {
 		for (const [key, value] of Object.entries(this.config.headers)) headers.set(key, value);
 		const controller = new AbortController();
 		const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-		let signal;
-		if (options.signal) {
-			const combinedController = new AbortController();
-			const onAbort = () => combinedController.abort();
-			options.signal.addEventListener("abort", onAbort, { once: true });
-			controller.signal.addEventListener("abort", onAbort, { once: true });
-			signal = combinedController.signal;
-		} else signal = controller.signal;
+		const combinedSignal = (0, __upyo_core.combineSignals)(controller.signal, options.signal);
 		try {
 			const response = await fetch(url, {
 				...options,
 				headers,
-				signal
+				signal: combinedSignal.signal
 			});
 			return response;
+		} catch (error) {
+			if (isAbortError$1(error) && controller.signal.aborted && !options.signal?.aborted) throw new Error(`Resend API request timed out after ${this.config.timeout} ms.`);
+			throw error;
 		} finally {
+			combinedSignal.cleanup();
 			clearTimeout(timeoutId);
 		}
 	}
 };
+function isAbortError$1(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
+function isCallerAbort$1(error, signal) {
+	return signal?.aborted === true && (isAbortError$1(error) || error === signal.reason);
+}
+function truncateErrorBody(text) {
+	return text.length > 500 ? `${text.slice(0, 500)}...` : text;
+}
 
 //#endregion
 //#region src/message-converter.ts
@@ -339,6 +399,7 @@ function generateIdempotencyKey() {
 * ```
 */
 var ResendTransport = class {
+	id = "resend";
 	/**
 	* The resolved Resend configuration used by this transport.
 	*/
@@ -396,14 +457,13 @@ var ResendTransport = class {
 			const response = await this.httpClient.sendMessage(emailData, options?.signal, idempotencyKey);
 			return {
 				successful: true,
-				messageId: response.id
+				messageId: response.id,
+				provider: "resend"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			return {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			return createResendFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -512,14 +572,13 @@ var ResendTransport = class {
 			const response = await this.httpClient.sendBatch(batchData, options?.signal, idempotencyKey);
 			for (const result of response.data) yield {
 				successful: true,
-				messageId: result.id
+				messageId: result.id,
+				provider: "resend"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			for (let i = 0; i < messages.length; i++) yield {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			for (let i = 0; i < messages.length; i++) yield createResendFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -549,6 +608,21 @@ var ResendTransport = class {
 		return chunks;
 	}
 };
+function createResendFailure(message, error) {
+	if (error instanceof ResendApiError) return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "resend",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		attempts: error.attempts
+	});
+	return (0, __upyo_core.createFailedReceipt)(message, { provider: "resend" });
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
+function isCallerAbort(error, signal) {
+	return signal?.aborted === true && (isAbortError(error) || error === signal.reason);
+}
 
 //#endregion
 exports.ResendTransport = ResendTransport;

package/dist/index.d.cts

@@ -99,7 +99,8 @@ type ResolvedResendConfig = Required<ResendConfig>;
  * }
  * ```
  */
-declare class ResendTransport implements Transport {
+declare class ResendTransport implements Transport<"resend"> {
+  readonly id = "resend";
   /**
    * The resolved Resend configuration used by this transport.
    */
@@ -145,7 +146,7 @@ declare class ResendTransport implements Transport {
    * @returns A promise that resolves to a receipt indicating success or
    *          failure.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<"resend">>;
   /**
    * Sends multiple email messages efficiently via Resend API.
    *
@@ -200,7 +201,7 @@ declare class ResendTransport implements Transport {
    *                cancellation.
    * @returns An async iterable of receipts, one for each message.
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<"resend">>;
   /**
    * Optimized batch sending that chooses the best strategy based on message features.
    *
@@ -274,11 +275,32 @@ interface ResendError {
   name?: string;
 }
 /**
- * Resend API error class for handling API-specific errors.
+ * Error thrown when a Resend API request fails.
+ *
+ * @since 0.5.0
  */
 declare class ResendApiError extends Error {
-  readonly statusCode: number;
-  constructor(message: string, statusCode: number);
+  /**
+   * HTTP status code returned by Resend, if the request reached the API.
+   */
+  readonly statusCode?: number;
+  /**
+   * Retry delay from Resend's `Retry-After` response header.
+   */
+  readonly retryAfterMilliseconds?: number;
+  /**
+   * Number of attempts made before this error was produced.
+   */
+  readonly attempts?: number;
+  /**
+   * Creates a Resend API error.
+   *
+   * @param message Error message.
+   * @param statusCode HTTP status code returned by Resend.
+   * @param retryAfterMilliseconds Retry delay from the response.
+   * @param attempts Number of attempts made before this error.
+   */
+  constructor(message: string, statusCode?: number, retryAfterMilliseconds?: number, attempts?: number);
 }
 /**
  * HTTP client wrapper for Resend API requests.

package/dist/index.d.ts

@@ -99,7 +99,8 @@ type ResolvedResendConfig = Required<ResendConfig>;
  * }
  * ```
  */
-declare class ResendTransport implements Transport {
+declare class ResendTransport implements Transport<"resend"> {
+  readonly id = "resend";
   /**
    * The resolved Resend configuration used by this transport.
    */
@@ -145,7 +146,7 @@ declare class ResendTransport implements Transport {
    * @returns A promise that resolves to a receipt indicating success or
    *          failure.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<"resend">>;
   /**
    * Sends multiple email messages efficiently via Resend API.
    *
@@ -200,7 +201,7 @@ declare class ResendTransport implements Transport {
    *                cancellation.
    * @returns An async iterable of receipts, one for each message.
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<"resend">>;
   /**
    * Optimized batch sending that chooses the best strategy based on message features.
    *
@@ -274,11 +275,32 @@ interface ResendError {
   name?: string;
 }
 /**
- * Resend API error class for handling API-specific errors.
+ * Error thrown when a Resend API request fails.
+ *
+ * @since 0.5.0
  */
 declare class ResendApiError extends Error {
-  readonly statusCode: number;
-  constructor(message: string, statusCode: number);
+  /**
+   * HTTP status code returned by Resend, if the request reached the API.
+   */
+  readonly statusCode?: number;
+  /**
+   * Retry delay from Resend's `Retry-After` response header.
+   */
+  readonly retryAfterMilliseconds?: number;
+  /**
+   * Number of attempts made before this error was produced.
+   */
+  readonly attempts?: number;
+  /**
+   * Creates a Resend API error.
+   *
+   * @param message Error message.
+   * @param statusCode HTTP status code returned by Resend.
+   * @param retryAfterMilliseconds Retry delay from the response.
+   * @param attempts Number of attempts made before this error.
+   */
+  constructor(message: string, statusCode?: number, retryAfterMilliseconds?: number, attempts?: number);
 }
 /**
  * HTTP client wrapper for Resend API requests.

package/dist/index.js

@@ -1,3 +1,5 @@
+import { combineSignals, createFailedReceipt, parseRetryAfter } from "@upyo/core";
+
 //#region src/config.ts
 /**
 * Creates a resolved Resend configuration by applying default values to optional fields.
@@ -24,14 +26,37 @@ function createResendConfig(config) {
 //#endregion
 //#region src/http-client.ts
 /**
-* Resend API error class for handling API-specific errors.
+* Error thrown when a Resend API request fails.
+*
+* @since 0.5.0
 */
 var ResendApiError = class extends Error {
+	/**
+	* HTTP status code returned by Resend, if the request reached the API.
+	*/
 	statusCode;
-	constructor(message, statusCode) {
+	/**
+	* Retry delay from Resend's `Retry-After` response header.
+	*/
+	retryAfterMilliseconds;
+	/**
+	* Number of attempts made before this error was produced.
+	*/
+	attempts;
+	/**
+	* Creates a Resend API error.
+	*
+	* @param message Error message.
+	* @param statusCode HTTP status code returned by Resend.
+	* @param retryAfterMilliseconds Retry delay from the response.
+	* @param attempts Number of attempts made before this error.
+	*/
+	constructor(message, statusCode, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "ResendApiError";
 		this.statusCode = statusCode;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
 /**
@@ -101,7 +126,10 @@ var ResendHttpClient = class {
 					const errorBody = JSON.parse(text);
 					errorMessage = errorBody.message;
 				} catch {}
-				throw new ResendApiError(errorMessage || text || `HTTP ${response.status}`, response.status);
+				const parsedErrorMessage = errorMessage === "" ? void 0 : errorMessage;
+				const responseMessage = truncateErrorBody(text);
+				const fallbackMessage = responseMessage === "" ? void 0 : responseMessage;
+				throw new ResendApiError(parsedErrorMessage ?? fallbackMessage ?? `HTTP ${response.status}`, response.status, parseRetryAfter(response.headers.get("Retry-After")), attempt + 1);
 			}
 			try {
 				return JSON.parse(text);
@@ -109,10 +137,14 @@ var ResendHttpClient = class {
 				throw new Error(`Invalid JSON response from Resend API: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
 			}
 		} catch (error) {
+			if (isCallerAbort$1(error, options.signal)) throw error;
 			lastError = error instanceof Error ? error : new Error(String(error));
-			if (error instanceof ResendApiError && error.statusCode >= 400 && error.statusCode < 500) throw error;
+			if (error instanceof ResendApiError && error.statusCode !== void 0 && error.statusCode >= 400 && error.statusCode < 500) throw error;
 			if (error instanceof Error && error.name === "AbortError") throw error;
-			if (attempt === this.config.retries) throw lastError;
+			if (attempt === this.config.retries) {
+				if (lastError instanceof ResendApiError) throw lastError;
+				throw new ResendApiError(lastError.message, void 0, void 0, attempt + 1);
+			}
 			const backoffMs = Math.min(1e3 * Math.pow(2, attempt), 1e4);
 			await new Promise((resolve) => setTimeout(resolve, backoffMs));
 		}
@@ -131,26 +163,32 @@ var ResendHttpClient = class {
 		for (const [key, value] of Object.entries(this.config.headers)) headers.set(key, value);
 		const controller = new AbortController();
 		const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-		let signal;
-		if (options.signal) {
-			const combinedController = new AbortController();
-			const onAbort = () => combinedController.abort();
-			options.signal.addEventListener("abort", onAbort, { once: true });
-			controller.signal.addEventListener("abort", onAbort, { once: true });
-			signal = combinedController.signal;
-		} else signal = controller.signal;
+		const combinedSignal = combineSignals(controller.signal, options.signal);
 		try {
 			const response = await fetch(url, {
 				...options,
 				headers,
-				signal
+				signal: combinedSignal.signal
 			});
 			return response;
+		} catch (error) {
+			if (isAbortError$1(error) && controller.signal.aborted && !options.signal?.aborted) throw new Error(`Resend API request timed out after ${this.config.timeout} ms.`);
+			throw error;
 		} finally {
+			combinedSignal.cleanup();
 			clearTimeout(timeoutId);
 		}
 	}
 };
+function isAbortError$1(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
+function isCallerAbort$1(error, signal) {
+	return signal?.aborted === true && (isAbortError$1(error) || error === signal.reason);
+}
+function truncateErrorBody(text) {
+	return text.length > 500 ? `${text.slice(0, 500)}...` : text;
+}
 
 //#endregion
 //#region src/message-converter.ts
@@ -338,6 +376,7 @@ function generateIdempotencyKey() {
 * ```
 */
 var ResendTransport = class {
+	id = "resend";
 	/**
 	* The resolved Resend configuration used by this transport.
 	*/
@@ -395,14 +434,13 @@ var ResendTransport = class {
 			const response = await this.httpClient.sendMessage(emailData, options?.signal, idempotencyKey);
 			return {
 				successful: true,
-				messageId: response.id
+				messageId: response.id,
+				provider: "resend"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			return {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			return createResendFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -511,14 +549,13 @@ var ResendTransport = class {
 			const response = await this.httpClient.sendBatch(batchData, options?.signal, idempotencyKey);
 			for (const result of response.data) yield {
 				successful: true,
-				messageId: result.id
+				messageId: result.id,
+				provider: "resend"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			for (let i = 0; i < messages.length; i++) yield {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			for (let i = 0; i < messages.length; i++) yield createResendFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -548,6 +585,21 @@ var ResendTransport = class {
 		return chunks;
 	}
 };
+function createResendFailure(message, error) {
+	if (error instanceof ResendApiError) return createFailedReceipt(message, {
+		provider: "resend",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		attempts: error.attempts
+	});
+	return createFailedReceipt(message, { provider: "resend" });
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
+function isCallerAbort(error, signal) {
+	return signal?.aborted === true && (isAbortError(error) || error === signal.reason);
+}
 
 //#endregion
 export { ResendTransport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/resend",
-  "version": "0.5.0-dev.86",
+  "version": "0.5.0",
   "description": "Resend transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,18 +53,13 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.5.0-dev.86+2a12a704"
+    "@upyo/core": "0.5.0"
   },
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.47.3",
     "tsdown": "^0.12.7",
     "typescript": "5.8.3"
   },
   "scripts": {
-    "build": "tsdown",
-    "prepublish": "tsdown",
-    "test": "tsdown && dotenvx run --ignore=MISSING_ENV_FILE -- node --experimental-transform-types --test",
-    "test:bun": "tsdown && bun test --timeout=30000 --env-file=.env",
-    "test:deno": "deno test --allow-env --allow-net --env-file=.env"
+    "prepublish": "mise run --no-deps :build"
   }
 }