@upyo/sendgrid 0.5.0-dev.87 → 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
 /**
@@ -61,6 +85,9 @@ var SendGridHttpClient = class {
 	* @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 {SendGridApiError} If SendGrid returns a client error or all retry
+	*                            attempts are exhausted.
 	*/
 	async makeRequest(url, options) {
 		let lastError = null;
@@ -78,13 +105,17 @@ var SendGridHttpClient = class {
 			} catch {
 				errorData = { message: text || `HTTP ${response.status}` };
 			}
-			throw new SendGridApiError(errorData.message || `HTTP ${response.status}`, response.status, errorData.errors);
+			throw new SendGridApiError(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 (isCallerAbort$1(error, options.signal)) throw error;
 			if (error instanceof SendGridApiError && 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 SendGridApiError) throw lastError;
+				throw new SendGridApiError(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");
 	}
@@ -94,6 +125,8 @@ var SendGridHttpClient = class {
 	* @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 headers = new Headers(options.headers);
@@ -101,19 +134,18 @@ var SendGridHttpClient = 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 = 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,
-				signal
+				signal: combinedSignal.signal
 			});
+		} catch (error) {
+			if (isAbortError$1(error) && controller.signal.aborted && !options.signal?.aborted) throw new Error(`SendGrid API request timed out after ${this.config.timeout} ms.`);
+			throw error;
 		} finally {
+			combinedSignal.cleanup();
 			clearTimeout(timeoutId);
 		}
 	}
@@ -130,18 +162,69 @@ var SendGridHttpClient = class {
 	}
 };
 /**
-* Custom error class for SendGrid API errors.
+* Error thrown when a SendGrid API request fails.
+*
+* @since 0.5.0
 */
 var SendGridApiError = class extends Error {
+	/**
+	* HTTP status code returned by SendGrid, if the request reached the API.
+	*/
 	statusCode;
+	/**
+	* Provider-supplied SendGrid error details.
+	*/
 	errors;
-	constructor(message, statusCode, errors) {
+	/**
+	* Retry delay from SendGrid's `Retry-After` response header.
+	*/
+	retryAfterMilliseconds;
+	/**
+	* Number of attempts made before this error was produced.
+	*/
+	attempts;
+	/**
+	* Creates a SendGrid API error.
+	*
+	* @param message Error message.
+	* @param statusCode HTTP status code returned by SendGrid.
+	* @param errors Provider-supplied SendGrid error details.
+	* @param retryAfterMilliseconds Retry delay from the response.
+	* @param attempts Number of attempts made before this error.
+	*/
+	constructor(message, statusCode, errors, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "SendGridApiError";
 		this.statusCode = statusCode;
 		this.errors = errors;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
+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 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");
+}
 
 //#endregion
 //#region src/message-converter.ts
@@ -312,6 +395,7 @@ function isStandardHeader(headerName) {
 * ```
 */
 var SendGridTransport = class {
+	id = "sendgrid";
 	/**
 	* The resolved SendGrid configuration used by this transport.
 	*/
@@ -368,14 +452,13 @@ var SendGridTransport = class {
 			const messageId = this.extractMessageId(response);
 			return {
 				successful: true,
-				messageId
+				messageId,
+				provider: "sendgrid"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			return {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			return createSendGridFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -459,6 +542,22 @@ var SendGridTransport = class {
 		return `sendgrid-${timestamp}-${random}`;
 	}
 };
+function createSendGridFailure(message, error) {
+	if (error instanceof SendGridApiError) return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "sendgrid",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		providerDetails: error.errors,
+		attempts: error.attempts
+	});
+	return (0, __upyo_core.createFailedReceipt)(message, { provider: "sendgrid" });
+}
+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.SendGridApiError = SendGridApiError;

package/dist/index.d.cts

@@ -123,7 +123,8 @@ type ResolvedSendGridConfig = Required<SendGridConfig>;
  * }
  * ```
  */
-declare class SendGridTransport implements Transport {
+declare class SendGridTransport implements Transport<"sendgrid"> {
+  readonly id = "sendgrid";
   /**
    * The resolved SendGrid configuration used by this transport.
    */
@@ -168,7 +169,7 @@ declare class SendGridTransport 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<"sendgrid">>;
   /**
    * Sends multiple email messages efficiently via SendGrid API.
    *
@@ -221,7 +222,7 @@ declare class SendGridTransport 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<"sendgrid">>;
   /**
    * Extracts or generates a message ID from the SendGrid response.
    *
@@ -237,20 +238,45 @@ declare class SendGridTransport implements Transport {
 //#region src/http-client.d.ts
 
 /**
- * Custom error class for SendGrid API errors.
+ * Error thrown when a SendGrid API request fails.
+ *
+ * @since 0.5.0
  */
 declare class SendGridApiError extends Error {
+  /**
+   * HTTP status code returned by SendGrid, if the request reached the API.
+   */
   readonly statusCode?: number;
+  /**
+   * Provider-supplied SendGrid error details.
+   */
   readonly errors?: {
     readonly message: string;
     readonly field?: string;
     readonly help?: string;
   }[];
+  /**
+   * Retry delay from SendGrid's `Retry-After` response header.
+   */
+  readonly retryAfterMilliseconds?: number;
+  /**
+   * Number of attempts made before this error was produced.
+   */
+  readonly attempts?: number;
+  /**
+   * Creates a SendGrid API error.
+   *
+   * @param message Error message.
+   * @param statusCode HTTP status code returned by SendGrid.
+   * @param errors Provider-supplied SendGrid error details.
+   * @param retryAfterMilliseconds Retry delay from the response.
+   * @param attempts Number of attempts made before this error.
+   */
   constructor(message: string, statusCode?: number, errors?: Array<{
     message: string;
     field?: string;
     help?: string;
-  }>);
+  }>, retryAfterMilliseconds?: number, attempts?: number);
 }
 //#endregion
 export { SendGridApiError, SendGridConfig, SendGridTransport };

package/dist/index.d.ts

@@ -123,7 +123,8 @@ type ResolvedSendGridConfig = Required<SendGridConfig>;
  * }
  * ```
  */
-declare class SendGridTransport implements Transport {
+declare class SendGridTransport implements Transport<"sendgrid"> {
+  readonly id = "sendgrid";
   /**
    * The resolved SendGrid configuration used by this transport.
    */
@@ -168,7 +169,7 @@ declare class SendGridTransport 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<"sendgrid">>;
   /**
    * Sends multiple email messages efficiently via SendGrid API.
    *
@@ -221,7 +222,7 @@ declare class SendGridTransport 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<"sendgrid">>;
   /**
    * Extracts or generates a message ID from the SendGrid response.
    *
@@ -237,20 +238,45 @@ declare class SendGridTransport implements Transport {
 //#region src/http-client.d.ts
 
 /**
- * Custom error class for SendGrid API errors.
+ * Error thrown when a SendGrid API request fails.
+ *
+ * @since 0.5.0
  */
 declare class SendGridApiError extends Error {
+  /**
+   * HTTP status code returned by SendGrid, if the request reached the API.
+   */
   readonly statusCode?: number;
+  /**
+   * Provider-supplied SendGrid error details.
+   */
   readonly errors?: {
     readonly message: string;
     readonly field?: string;
     readonly help?: string;
   }[];
+  /**
+   * Retry delay from SendGrid's `Retry-After` response header.
+   */
+  readonly retryAfterMilliseconds?: number;
+  /**
+   * Number of attempts made before this error was produced.
+   */
+  readonly attempts?: number;
+  /**
+   * Creates a SendGrid API error.
+   *
+   * @param message Error message.
+   * @param statusCode HTTP status code returned by SendGrid.
+   * @param errors Provider-supplied SendGrid error details.
+   * @param retryAfterMilliseconds Retry delay from the response.
+   * @param attempts Number of attempts made before this error.
+   */
   constructor(message: string, statusCode?: number, errors?: Array<{
     message: string;
     field?: string;
     help?: string;
-  }>);
+  }>, retryAfterMilliseconds?: number, attempts?: number);
 }
 //#endregion
 export { SendGridApiError, SendGridConfig, SendGridTransport };

package/dist/index.js

@@ -1,3 +1,5 @@
+import { combineSignals, createFailedReceipt, parseRetryAfter } from "@upyo/core";
+
 //#region src/config.ts
 /**
 * Creates a resolved SendGrid configuration by applying default values to optional fields.
@@ -60,6 +62,9 @@ var SendGridHttpClient = class {
 	* @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 {SendGridApiError} If SendGrid returns a client error or all retry
+	*                            attempts are exhausted.
 	*/
 	async makeRequest(url, options) {
 		let lastError = null;
@@ -77,13 +82,17 @@ var SendGridHttpClient = class {
 			} catch {
 				errorData = { message: text || `HTTP ${response.status}` };
 			}
-			throw new SendGridApiError(errorData.message || `HTTP ${response.status}`, response.status, errorData.errors);
+			throw new SendGridApiError(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 (isCallerAbort$1(error, options.signal)) throw error;
 			if (error instanceof SendGridApiError && 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 SendGridApiError) throw lastError;
+				throw new SendGridApiError(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");
 	}
@@ -93,6 +102,8 @@ var SendGridHttpClient = class {
 	* @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 headers = new Headers(options.headers);
@@ -100,19 +111,18 @@ var SendGridHttpClient = 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 = 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,
-				signal
+				signal: combinedSignal.signal
 			});
+		} catch (error) {
+			if (isAbortError$1(error) && controller.signal.aborted && !options.signal?.aborted) throw new Error(`SendGrid API request timed out after ${this.config.timeout} ms.`);
+			throw error;
 		} finally {
+			combinedSignal.cleanup();
 			clearTimeout(timeoutId);
 		}
 	}
@@ -129,18 +139,69 @@ var SendGridHttpClient = class {
 	}
 };
 /**
-* Custom error class for SendGrid API errors.
+* Error thrown when a SendGrid API request fails.
+*
+* @since 0.5.0
 */
 var SendGridApiError = class extends Error {
+	/**
+	* HTTP status code returned by SendGrid, if the request reached the API.
+	*/
 	statusCode;
+	/**
+	* Provider-supplied SendGrid error details.
+	*/
 	errors;
-	constructor(message, statusCode, errors) {
+	/**
+	* Retry delay from SendGrid's `Retry-After` response header.
+	*/
+	retryAfterMilliseconds;
+	/**
+	* Number of attempts made before this error was produced.
+	*/
+	attempts;
+	/**
+	* Creates a SendGrid API error.
+	*
+	* @param message Error message.
+	* @param statusCode HTTP status code returned by SendGrid.
+	* @param errors Provider-supplied SendGrid error details.
+	* @param retryAfterMilliseconds Retry delay from the response.
+	* @param attempts Number of attempts made before this error.
+	*/
+	constructor(message, statusCode, errors, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "SendGridApiError";
 		this.statusCode = statusCode;
 		this.errors = errors;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
+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 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");
+}
 
 //#endregion
 //#region src/message-converter.ts
@@ -311,6 +372,7 @@ function isStandardHeader(headerName) {
 * ```
 */
 var SendGridTransport = class {
+	id = "sendgrid";
 	/**
 	* The resolved SendGrid configuration used by this transport.
 	*/
@@ -367,14 +429,13 @@ var SendGridTransport = class {
 			const messageId = this.extractMessageId(response);
 			return {
 				successful: true,
-				messageId
+				messageId,
+				provider: "sendgrid"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			return {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			return createSendGridFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -458,6 +519,22 @@ var SendGridTransport = class {
 		return `sendgrid-${timestamp}-${random}`;
 	}
 };
+function createSendGridFailure(message, error) {
+	if (error instanceof SendGridApiError) return createFailedReceipt(message, {
+		provider: "sendgrid",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		providerDetails: error.errors,
+		attempts: error.attempts
+	});
+	return createFailedReceipt(message, { provider: "sendgrid" });
+}
+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 { SendGridApiError, SendGridTransport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/sendgrid",
-  "version": "0.5.0-dev.87",
+  "version": "0.5.0",
   "description": "SendGrid transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,18 +53,13 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.5.0-dev.87+50b9f2d4"
+    "@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"
   }
 }