@upyo/plunk 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,6 +49,40 @@ function createPlunkConfig(config) {
 //#endregion
 //#region src/http-client.ts
 /**
+* Error thrown when a Plunk API request fails.
+*
+* @since 0.5.0
+*/
+var PlunkApiError = class extends Error {
+	/**
+	* HTTP status code returned by Plunk, if the request reached the API.
+	*/
+	statusCode;
+	/**
+	* Retry delay from Plunk's `Retry-After` response header.
+	*/
+	retryAfterMilliseconds;
+	/**
+	* Number of attempts made before this error was produced.
+	*/
+	attempts;
+	/**
+	* Creates a Plunk API error.
+	*
+	* @param message Error message.
+	* @param statusCode HTTP status code returned by Plunk.
+	* @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 = "PlunkApiError";
+		this.statusCode = statusCode;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
+	}
+};
+/**
 * HTTP client wrapper for Plunk API requests.
 *
 * This class handles authentication, request formatting, error handling,
@@ -60,18 +118,18 @@ var PlunkHttpClient = class {
 				const response = await this.makeRequest(url, emailData, signal);
 				return await this.parseResponse(response);
 			} catch (error) {
+				if (isCallerAbort$1(error, signal)) throw error;
 				lastError = error instanceof Error ? error : new Error(String(error));
-				if (error instanceof Error) {
-					if (error.name === "AbortError") throw error;
-					if (error.message.includes("status: 4")) throw this.createPlunkError(error.message, 400);
-				}
+				if (error instanceof Error && error.name === "AbortError") throw error;
+				if (error instanceof PlunkApiError && error.statusCode !== void 0 && error.statusCode >= 400 && error.statusCode < 500) throw new PlunkApiError(error.message, error.statusCode, error.retryAfterMilliseconds, attempt + 1);
 				if (attempt === this.config.retries) break;
 				const delay = Math.min(1e3 * Math.pow(2, attempt), 1e4);
 				await this.sleep(delay);
 			}
 		}
 		const errorMessage = lastError?.message ?? "Unknown error occurred";
-		throw this.createPlunkError(errorMessage);
+		if (lastError instanceof PlunkApiError) throw new PlunkApiError(lastError.message, lastError.statusCode, lastError.retryAfterMilliseconds, this.config.retries + 1);
+		throw new PlunkApiError(errorMessage, void 0, void 0, this.config.retries + 1);
 	}
 	/**
 	* Makes an HTTP request to the Plunk API.
@@ -87,13 +145,24 @@ var PlunkHttpClient = class {
 			"Content-Type": "application/json",
 			...this.config.headers
 		};
-		const response = await fetch(url, {
-			method: "POST",
-			headers,
-			body: JSON.stringify(emailData),
-			signal,
-			...this.config.timeout > 0 && typeof globalThis.AbortSignal?.timeout === "function" ? { signal: AbortSignal.any([signal, AbortSignal.timeout(this.config.timeout)].filter(Boolean)) } : {}
-		});
+		const timeoutController = new AbortController();
+		const timeoutId = this.config.timeout > 0 ? setTimeout(() => timeoutController.abort(), this.config.timeout) : void 0;
+		const combinedSignal = (0, __upyo_core.combineSignals)(timeoutController.signal, signal);
+		let response;
+		try {
+			response = await fetch(url, {
+				method: "POST",
+				headers,
+				body: JSON.stringify(emailData),
+				signal: combinedSignal.signal
+			});
+		} catch (error) {
+			if (isAbortError$1(error) && timeoutController.signal.aborted && !signal?.aborted) throw new Error(`Plunk API request timed out after ${this.config.timeout} ms.`);
+			throw error;
+		} finally {
+			combinedSignal.cleanup();
+			if (timeoutId !== void 0) clearTimeout(timeoutId);
+		}
 		if (!response.ok) {
 			let errorBody;
 			try {
@@ -101,7 +170,7 @@ var PlunkHttpClient = class {
 			} catch {
 				errorBody = "Failed to read error response";
 			}
-			throw new Error(`HTTP ${response.status}: ${response.statusText}. ${errorBody}`);
+			throw new PlunkApiError(`HTTP ${response.status}: ${response.statusText}. ${truncateErrorBody(errorBody)}`, response.status, (0, __upyo_core.parseRetryAfter)(response.headers.get("Retry-After")));
 		}
 		return response;
 	}
@@ -124,19 +193,6 @@ var PlunkHttpClient = class {
 		}
 	}
 	/**
-	* Creates a PlunkError from an error message and optional status code.
-	*
-	* @param message - The error message
-	* @param statusCode - Optional HTTP status code
-	* @returns PlunkError instance
-	*/
-	createPlunkError(message, statusCode) {
-		return {
-			message,
-			statusCode
-		};
-	}
-	/**
 	* Sleeps for the specified number of milliseconds.
 	*
 	* @param ms - Milliseconds to sleep
@@ -146,6 +202,15 @@ var PlunkHttpClient = class {
 		return new Promise((resolve) => setTimeout(resolve, ms));
 	}
 };
+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
@@ -277,6 +342,7 @@ function arrayBufferToBase64(buffer) {
 * ```
 */
 var PlunkTransport = class {
+	id = "plunk";
 	/**
 	* The resolved Plunk configuration used by this transport.
 	*/
@@ -333,14 +399,13 @@ var PlunkTransport = class {
 			const messageId = this.extractMessageId(response, message);
 			return {
 				successful: true,
-				messageId
+				messageId,
+				provider: "plunk"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			return {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			return createPlunkFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -429,6 +494,21 @@ var PlunkTransport = class {
 		return `plunk-${timestamp}-${recipientHash}-${random}`;
 	}
 };
+function createPlunkFailure(message, error) {
+	if (error instanceof PlunkApiError) return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "plunk",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		attempts: error.attempts
+	});
+	return (0, __upyo_core.createFailedReceipt)(message, { provider: "plunk" });
+}
+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.PlunkTransport = PlunkTransport;

package/dist/index.d.cts

@@ -106,7 +106,8 @@ type ResolvedPlunkConfig = Required<PlunkConfig>;
  * }
  * ```
  */
-declare class PlunkTransport implements Transport {
+declare class PlunkTransport implements Transport<"plunk"> {
+  readonly id = "plunk";
   /**
    * The resolved Plunk configuration used by this transport.
    */
@@ -151,7 +152,7 @@ declare class PlunkTransport 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<"plunk">>;
   /**
    * Sends multiple email messages efficiently via Plunk API.
    *
@@ -204,7 +205,7 @@ declare class PlunkTransport 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<"plunk">>;
   /**
    * Extracts or generates a message ID from the Plunk response.
    *
@@ -260,10 +261,9 @@ interface PlunkError {
   readonly details?: unknown;
 }
 /**
- * HTTP client wrapper for Plunk API requests.
+ * Error thrown when a Plunk API request fails.
  *
- * This class handles authentication, request formatting, error handling,
- * and retry logic for the Plunk HTTP API.
+ * @since 0.5.0
  */
 //#endregion
 export { PlunkConfig, PlunkError, PlunkResponse, PlunkTransport, ResolvedPlunkConfig };

package/dist/index.d.ts

@@ -106,7 +106,8 @@ type ResolvedPlunkConfig = Required<PlunkConfig>;
  * }
  * ```
  */
-declare class PlunkTransport implements Transport {
+declare class PlunkTransport implements Transport<"plunk"> {
+  readonly id = "plunk";
   /**
    * The resolved Plunk configuration used by this transport.
    */
@@ -151,7 +152,7 @@ declare class PlunkTransport 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<"plunk">>;
   /**
    * Sends multiple email messages efficiently via Plunk API.
    *
@@ -204,7 +205,7 @@ declare class PlunkTransport 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<"plunk">>;
   /**
    * Extracts or generates a message ID from the Plunk response.
    *
@@ -260,10 +261,9 @@ interface PlunkError {
   readonly details?: unknown;
 }
 /**
- * HTTP client wrapper for Plunk API requests.
+ * Error thrown when a Plunk API request fails.
  *
- * This class handles authentication, request formatting, error handling,
- * and retry logic for the Plunk HTTP API.
+ * @since 0.5.0
  */
 //#endregion
 export { PlunkConfig, PlunkError, PlunkResponse, PlunkTransport, ResolvedPlunkConfig };

package/dist/index.js

@@ -1,3 +1,5 @@
+import { combineSignals, createFailedReceipt, parseRetryAfter } from "@upyo/core";
+
 //#region src/config.ts
 /**
 * Creates a resolved Plunk configuration by applying default values to optional fields.
@@ -24,6 +26,40 @@ function createPlunkConfig(config) {
 //#endregion
 //#region src/http-client.ts
 /**
+* Error thrown when a Plunk API request fails.
+*
+* @since 0.5.0
+*/
+var PlunkApiError = class extends Error {
+	/**
+	* HTTP status code returned by Plunk, if the request reached the API.
+	*/
+	statusCode;
+	/**
+	* Retry delay from Plunk's `Retry-After` response header.
+	*/
+	retryAfterMilliseconds;
+	/**
+	* Number of attempts made before this error was produced.
+	*/
+	attempts;
+	/**
+	* Creates a Plunk API error.
+	*
+	* @param message Error message.
+	* @param statusCode HTTP status code returned by Plunk.
+	* @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 = "PlunkApiError";
+		this.statusCode = statusCode;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
+	}
+};
+/**
 * HTTP client wrapper for Plunk API requests.
 *
 * This class handles authentication, request formatting, error handling,
@@ -59,18 +95,18 @@ var PlunkHttpClient = class {
 				const response = await this.makeRequest(url, emailData, signal);
 				return await this.parseResponse(response);
 			} catch (error) {
+				if (isCallerAbort$1(error, signal)) throw error;
 				lastError = error instanceof Error ? error : new Error(String(error));
-				if (error instanceof Error) {
-					if (error.name === "AbortError") throw error;
-					if (error.message.includes("status: 4")) throw this.createPlunkError(error.message, 400);
-				}
+				if (error instanceof Error && error.name === "AbortError") throw error;
+				if (error instanceof PlunkApiError && error.statusCode !== void 0 && error.statusCode >= 400 && error.statusCode < 500) throw new PlunkApiError(error.message, error.statusCode, error.retryAfterMilliseconds, attempt + 1);
 				if (attempt === this.config.retries) break;
 				const delay = Math.min(1e3 * Math.pow(2, attempt), 1e4);
 				await this.sleep(delay);
 			}
 		}
 		const errorMessage = lastError?.message ?? "Unknown error occurred";
-		throw this.createPlunkError(errorMessage);
+		if (lastError instanceof PlunkApiError) throw new PlunkApiError(lastError.message, lastError.statusCode, lastError.retryAfterMilliseconds, this.config.retries + 1);
+		throw new PlunkApiError(errorMessage, void 0, void 0, this.config.retries + 1);
 	}
 	/**
 	* Makes an HTTP request to the Plunk API.
@@ -86,13 +122,24 @@ var PlunkHttpClient = class {
 			"Content-Type": "application/json",
 			...this.config.headers
 		};
-		const response = await fetch(url, {
-			method: "POST",
-			headers,
-			body: JSON.stringify(emailData),
-			signal,
-			...this.config.timeout > 0 && typeof globalThis.AbortSignal?.timeout === "function" ? { signal: AbortSignal.any([signal, AbortSignal.timeout(this.config.timeout)].filter(Boolean)) } : {}
-		});
+		const timeoutController = new AbortController();
+		const timeoutId = this.config.timeout > 0 ? setTimeout(() => timeoutController.abort(), this.config.timeout) : void 0;
+		const combinedSignal = combineSignals(timeoutController.signal, signal);
+		let response;
+		try {
+			response = await fetch(url, {
+				method: "POST",
+				headers,
+				body: JSON.stringify(emailData),
+				signal: combinedSignal.signal
+			});
+		} catch (error) {
+			if (isAbortError$1(error) && timeoutController.signal.aborted && !signal?.aborted) throw new Error(`Plunk API request timed out after ${this.config.timeout} ms.`);
+			throw error;
+		} finally {
+			combinedSignal.cleanup();
+			if (timeoutId !== void 0) clearTimeout(timeoutId);
+		}
 		if (!response.ok) {
 			let errorBody;
 			try {
@@ -100,7 +147,7 @@ var PlunkHttpClient = class {
 			} catch {
 				errorBody = "Failed to read error response";
 			}
-			throw new Error(`HTTP ${response.status}: ${response.statusText}. ${errorBody}`);
+			throw new PlunkApiError(`HTTP ${response.status}: ${response.statusText}. ${truncateErrorBody(errorBody)}`, response.status, parseRetryAfter(response.headers.get("Retry-After")));
 		}
 		return response;
 	}
@@ -123,19 +170,6 @@ var PlunkHttpClient = class {
 		}
 	}
 	/**
-	* Creates a PlunkError from an error message and optional status code.
-	*
-	* @param message - The error message
-	* @param statusCode - Optional HTTP status code
-	* @returns PlunkError instance
-	*/
-	createPlunkError(message, statusCode) {
-		return {
-			message,
-			statusCode
-		};
-	}
-	/**
 	* Sleeps for the specified number of milliseconds.
 	*
 	* @param ms - Milliseconds to sleep
@@ -145,6 +179,15 @@ var PlunkHttpClient = class {
 		return new Promise((resolve) => setTimeout(resolve, ms));
 	}
 };
+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
@@ -276,6 +319,7 @@ function arrayBufferToBase64(buffer) {
 * ```
 */
 var PlunkTransport = class {
+	id = "plunk";
 	/**
 	* The resolved Plunk configuration used by this transport.
 	*/
@@ -332,14 +376,13 @@ var PlunkTransport = class {
 			const messageId = this.extractMessageId(response, message);
 			return {
 				successful: true,
-				messageId
+				messageId,
+				provider: "plunk"
 			};
 		} catch (error) {
+			if (isCallerAbort(error, options?.signal)) throw error;
 			const errorMessage = error instanceof Error ? error.message : String(error);
-			return {
-				successful: false,
-				errorMessages: [errorMessage]
-			};
+			return createPlunkFailure(errorMessage, error);
 		}
 	}
 	/**
@@ -428,6 +471,21 @@ var PlunkTransport = class {
 		return `plunk-${timestamp}-${recipientHash}-${random}`;
 	}
 };
+function createPlunkFailure(message, error) {
+	if (error instanceof PlunkApiError) return createFailedReceipt(message, {
+		provider: "plunk",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		attempts: error.attempts
+	});
+	return createFailedReceipt(message, { provider: "plunk" });
+}
+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 { PlunkTransport };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/plunk",
-  "version": "0.5.0-dev.86",
+  "version": "0.5.0",
   "description": "Plunk 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"
   }
 }