@upyo/ses 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
 /**
@@ -56,6 +80,16 @@ var SesHttpClient = class {
 			signal
 		});
 	}
+	/**
+	* Makes an HTTP request to the SES API with retry logic.
+	*
+	* @param url The URL to make the request to.
+	* @param options Fetch options.
+	* @returns Promise that resolves to the parsed response.
+	* @throws {DOMException} If the caller aborts the request.
+	* @throws {SesApiError} If SES returns a client error or all retry attempts
+	*                       are exhausted.
+	*/
 	async makeRequest(url, options) {
 		let lastError = null;
 		for (let attempt = 0; attempt <= this.config.retries; attempt++) try {
@@ -72,16 +106,30 @@ var SesHttpClient = class {
 			} catch {
 				errorData = { message: text || `HTTP ${response.status}` };
 			}
-			throw new SesApiError(errorData.message || `HTTP ${response.status}`, response.status, errorData.errors);
+			throw new SesApiError(errorData.message || `HTTP ${response.status}`, response.status, errorData.errors, (0, __upyo_core.parseRetryAfter)(response.headers.get("Retry-After")), attempt + 1);
 		} catch (error) {
 			lastError = error instanceof Error ? error : new Error(String(error));
+			if (options.signal?.aborted) throw createAbortError(options.signal);
+			if (isAbortError$1(error)) throw error;
 			if (error instanceof SesApiError && error.statusCode && error.statusCode >= 400 && error.statusCode < 500) throw error;
-			if (attempt === this.config.retries) throw error;
+			if (attempt === this.config.retries) {
+				if (lastError instanceof SesApiError) throw lastError;
+				throw new SesApiError(lastError.message, void 0, void 0, void 0, attempt + 1);
+			}
 			const delay = Math.pow(2, attempt) * 1e3;
-			await new Promise((resolve) => setTimeout(resolve, delay));
+			await sleep(delay, options.signal);
 		}
 		throw lastError || /* @__PURE__ */ new Error("Request failed after all retries");
 	}
+	/**
+	* Makes a signed fetch request to the SES API.
+	*
+	* @param url The URL to make the request to.
+	* @param options Fetch options.
+	* @returns Promise that resolves to the fetch response.
+	* @throws {Error} If the configured request timeout is reached.
+	* @throws {DOMException} If the caller aborts the request.
+	*/
 	async fetchWithAuth(url, options) {
 		const credentials = await this.getCredentials();
 		const headers = new Headers(options.headers);
@@ -92,19 +140,18 @@ var SesHttpClient = class {
 		for (const [key, value] of Object.entries(this.config.headers)) signedHeaders.set(key, value);
 		const controller = new AbortController();
 		const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-		let signal = controller.signal;
-		if (options.signal) {
-			signal = options.signal;
-			if (options.signal.aborted) controller.abort();
-			else options.signal.addEventListener("abort", () => controller.abort());
-		}
+		const combinedSignal = (0, __upyo_core.combineSignals)(controller.signal, options.signal);
 		try {
 			return await globalThis.fetch(url, {
 				...options,
 				headers: this.headersToRecord(signedHeaders),
-				signal
+				signal: combinedSignal.signal
 			});
+		} catch (error) {
+			if (isAbortError$1(error) && controller.signal.aborted && !options.signal?.aborted) throw new Error(`SES API request timed out after ${this.config.timeout} ms.`);
+			throw error;
 		} finally {
+			combinedSignal.cleanup();
 			clearTimeout(timeoutId);
 		}
 	}
@@ -190,14 +237,39 @@ var SesHttpClient = class {
 		return record;
 	}
 };
+function isAbortError$1(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
+function sleep(milliseconds, signal) {
+	if (signal?.aborted) return Promise.reject(createAbortError(signal));
+	return new Promise((resolve, reject) => {
+		function abort() {
+			clearTimeout(timeoutId);
+			signal?.removeEventListener("abort", abort);
+			reject(createAbortError(signal));
+		}
+		const timeoutId = setTimeout(() => {
+			signal?.removeEventListener("abort", abort);
+			resolve();
+		}, milliseconds);
+		signal?.addEventListener("abort", abort, { once: true });
+	});
+}
+function createAbortError(signal) {
+	return signal?.reason ?? new DOMException("The operation was aborted.", "AbortError");
+}
 var SesApiError = class extends Error {
 	statusCode;
 	errors;
-	constructor(message, statusCode, errors) {
+	retryAfterMilliseconds;
+	attempts;
+	constructor(message, statusCode, errors, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "SesApiError";
 		this.statusCode = statusCode;
 		this.errors = errors;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
 
@@ -311,6 +383,7 @@ function formatAddress(address) {
 * @since 0.2.0
 */
 var SesTransport = class {
+	id = "ses";
 	/** Resolved configuration with defaults applied */
 	config;
 	/** HTTP client for SES API requests */
@@ -360,14 +433,13 @@ var SesTransport = class {
 			const messageId = this.extractMessageId(response);
 			return {
 				successful: true,
-				messageId
+				messageId,
+				provider: "ses"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			return {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			return createSesFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -430,6 +502,22 @@ var SesTransport = class {
 		return `ses-${timestamp}-${random}`;
 	}
 };
+function createSesFailure(message, error) {
+	if (error instanceof SesApiError) return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "ses",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		providerDetails: error.errors,
+		attempts: error.attempts
+	});
+	return (0, __upyo_core.createFailedReceipt)(message, { provider: "ses" });
+}
+function isCallerAbort(error, signal) {
+	return signal?.aborted === true && (isAbortError(error) || error === signal.reason);
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 
 //#endregion
 exports.SesTransport = SesTransport;

package/dist/index.d.cts

@@ -188,7 +188,8 @@ type ResolvedSesConfig = Required<Omit<SesConfig, "configurationSetName" | "defa
  *
  * @since 0.2.0
  */
-declare class SesTransport implements Transport {
+declare class SesTransport implements Transport<"ses"> {
+  readonly id = "ses";
   /** Resolved configuration with defaults applied */
   config: ResolvedSesConfig;
   /** HTTP client for SES API requests */
@@ -226,7 +227,7 @@ declare class SesTransport implements Transport {
    * @param options Optional transport options (e.g., abort signal).
    * @returns A promise that resolves to a receipt with the result.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<"ses">>;
   /**
    * Sends multiple email messages concurrently through Amazon SES.
    *
@@ -256,7 +257,7 @@ declare class SesTransport implements Transport {
    * @param options Optional transport options (e.g., abort signal).
    * @returns Individual receipts for each message as they complete.
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<"ses">>;
   private sendConcurrent;
   private extractMessageId;
 }

package/dist/index.d.ts

@@ -188,7 +188,8 @@ type ResolvedSesConfig = Required<Omit<SesConfig, "configurationSetName" | "defa
  *
  * @since 0.2.0
  */
-declare class SesTransport implements Transport {
+declare class SesTransport implements Transport<"ses"> {
+  readonly id = "ses";
   /** Resolved configuration with defaults applied */
   config: ResolvedSesConfig;
   /** HTTP client for SES API requests */
@@ -226,7 +227,7 @@ declare class SesTransport implements Transport {
    * @param options Optional transport options (e.g., abort signal).
    * @returns A promise that resolves to a receipt with the result.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<"ses">>;
   /**
    * Sends multiple email messages concurrently through Amazon SES.
    *
@@ -256,7 +257,7 @@ declare class SesTransport implements Transport {
    * @param options Optional transport options (e.g., abort signal).
    * @returns Individual receipts for each message as they complete.
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<"ses">>;
   private sendConcurrent;
   private extractMessageId;
 }

package/dist/index.js

@@ -1,3 +1,5 @@
+import { combineSignals, createFailedReceipt, parseRetryAfter } from "@upyo/core";
+
 //#region src/config.ts
 /**
 * Creates a resolved SES configuration with default values applied.
@@ -55,6 +57,16 @@ var SesHttpClient = class {
 			signal
 		});
 	}
+	/**
+	* Makes an HTTP request to the SES API with retry logic.
+	*
+	* @param url The URL to make the request to.
+	* @param options Fetch options.
+	* @returns Promise that resolves to the parsed response.
+	* @throws {DOMException} If the caller aborts the request.
+	* @throws {SesApiError} If SES returns a client error or all retry attempts
+	*                       are exhausted.
+	*/
 	async makeRequest(url, options) {
 		let lastError = null;
 		for (let attempt = 0; attempt <= this.config.retries; attempt++) try {
@@ -71,16 +83,30 @@ var SesHttpClient = class {
 			} catch {
 				errorData = { message: text || `HTTP ${response.status}` };
 			}
-			throw new SesApiError(errorData.message || `HTTP ${response.status}`, response.status, errorData.errors);
+			throw new SesApiError(errorData.message || `HTTP ${response.status}`, response.status, errorData.errors, parseRetryAfter(response.headers.get("Retry-After")), attempt + 1);
 		} catch (error) {
 			lastError = error instanceof Error ? error : new Error(String(error));
+			if (options.signal?.aborted) throw createAbortError(options.signal);
+			if (isAbortError$1(error)) throw error;
 			if (error instanceof SesApiError && error.statusCode && error.statusCode >= 400 && error.statusCode < 500) throw error;
-			if (attempt === this.config.retries) throw error;
+			if (attempt === this.config.retries) {
+				if (lastError instanceof SesApiError) throw lastError;
+				throw new SesApiError(lastError.message, void 0, void 0, void 0, attempt + 1);
+			}
 			const delay = Math.pow(2, attempt) * 1e3;
-			await new Promise((resolve) => setTimeout(resolve, delay));
+			await sleep(delay, options.signal);
 		}
 		throw lastError || /* @__PURE__ */ new Error("Request failed after all retries");
 	}
+	/**
+	* Makes a signed fetch request to the SES API.
+	*
+	* @param url The URL to make the request to.
+	* @param options Fetch options.
+	* @returns Promise that resolves to the fetch response.
+	* @throws {Error} If the configured request timeout is reached.
+	* @throws {DOMException} If the caller aborts the request.
+	*/
 	async fetchWithAuth(url, options) {
 		const credentials = await this.getCredentials();
 		const headers = new Headers(options.headers);
@@ -91,19 +117,18 @@ var SesHttpClient = class {
 		for (const [key, value] of Object.entries(this.config.headers)) signedHeaders.set(key, value);
 		const controller = new AbortController();
 		const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-		let signal = controller.signal;
-		if (options.signal) {
-			signal = options.signal;
-			if (options.signal.aborted) controller.abort();
-			else options.signal.addEventListener("abort", () => controller.abort());
-		}
+		const combinedSignal = combineSignals(controller.signal, options.signal);
 		try {
 			return await globalThis.fetch(url, {
 				...options,
 				headers: this.headersToRecord(signedHeaders),
-				signal
+				signal: combinedSignal.signal
 			});
+		} catch (error) {
+			if (isAbortError$1(error) && controller.signal.aborted && !options.signal?.aborted) throw new Error(`SES API request timed out after ${this.config.timeout} ms.`);
+			throw error;
 		} finally {
+			combinedSignal.cleanup();
 			clearTimeout(timeoutId);
 		}
 	}
@@ -189,14 +214,39 @@ var SesHttpClient = class {
 		return record;
 	}
 };
+function isAbortError$1(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
+function sleep(milliseconds, signal) {
+	if (signal?.aborted) return Promise.reject(createAbortError(signal));
+	return new Promise((resolve, reject) => {
+		function abort() {
+			clearTimeout(timeoutId);
+			signal?.removeEventListener("abort", abort);
+			reject(createAbortError(signal));
+		}
+		const timeoutId = setTimeout(() => {
+			signal?.removeEventListener("abort", abort);
+			resolve();
+		}, milliseconds);
+		signal?.addEventListener("abort", abort, { once: true });
+	});
+}
+function createAbortError(signal) {
+	return signal?.reason ?? new DOMException("The operation was aborted.", "AbortError");
+}
 var SesApiError = class extends Error {
 	statusCode;
 	errors;
-	constructor(message, statusCode, errors) {
+	retryAfterMilliseconds;
+	attempts;
+	constructor(message, statusCode, errors, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "SesApiError";
 		this.statusCode = statusCode;
 		this.errors = errors;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
 
@@ -310,6 +360,7 @@ function formatAddress(address) {
 * @since 0.2.0
 */
 var SesTransport = class {
+	id = "ses";
 	/** Resolved configuration with defaults applied */
 	config;
 	/** HTTP client for SES API requests */
@@ -359,14 +410,13 @@ var SesTransport = class {
 			const messageId = this.extractMessageId(response);
 			return {
 				successful: true,
-				messageId
+				messageId,
+				provider: "ses"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			return {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			return createSesFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -429,6 +479,22 @@ var SesTransport = class {
 		return `ses-${timestamp}-${random}`;
 	}
 };
+function createSesFailure(message, error) {
+	if (error instanceof SesApiError) return createFailedReceipt(message, {
+		provider: "ses",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		providerDetails: error.errors,
+		attempts: error.attempts
+	});
+	return createFailedReceipt(message, { provider: "ses" });
+}
+function isCallerAbort(error, signal) {
+	return signal?.aborted === true && (isAbortError(error) || error === signal.reason);
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 
 //#endregion
 export { SesTransport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/ses",
-  "version": "0.5.0-dev.86",
+  "version": "0.5.0",
   "description": "Amazon SES transport for Upyo email library",
   "keywords": [
     "email",
@@ -55,18 +55,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"
   }
 }