@upyo/lettermint 0.5.0-dev.128 → 0.5.0-dev.154

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
 /**
@@ -33,16 +57,22 @@ function normalizeBaseUrl(baseUrl) {
 */
 var LettermintApiError = class extends Error {
 	statusCode;
+	retryAfterMilliseconds;
+	attempts;
 	/**
 	* Creates a Lettermint API error.
 	*
 	* @param message Error message.
 	* @param statusCode HTTP status code.
+	* @param retryAfterMilliseconds Retry delay from the response.
+	* @param attempts Number of attempts made before this error.
 	*/
-	constructor(message, statusCode) {
+	constructor(message, statusCode, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "LettermintApiError";
 		this.statusCode = statusCode;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
 /**
@@ -51,16 +81,29 @@ var LettermintApiError = class extends Error {
 * @since 0.5.0
 */
 var LettermintTimeoutError = class extends Error {
+	/**
+	* Request timeout in milliseconds.
+	*
+	* @since 0.5.0
+	*/
 	timeout;
 	/**
+	* Number of attempts made before this error was produced.
+	*
+	* @since 0.5.0
+	*/
+	attempts;
+	/**
 	* Creates a Lettermint request timeout error.
 	*
 	* @param timeout Request timeout in milliseconds.
+	* @param attempts Number of attempts made before this error.
 	*/
-	constructor(timeout) {
+	constructor(timeout, attempts) {
 		super(`Lettermint API request timed out after ${timeout} ms.`);
 		this.name = "LettermintTimeoutError";
 		this.timeout = timeout;
+		this.attempts = attempts;
 	}
 };
 /**
@@ -109,7 +152,7 @@ var LettermintHttpClient = class {
 			try {
 				const response = await this.fetchWithAuth(url, body, signal, idempotencyKey);
 				const text = await response.text();
-				if (!response.ok) throw new LettermintApiError(parseErrorMessage(text, response.status), response.status);
+				if (!response.ok) throw new LettermintApiError(parseErrorMessage(text, response.status), response.status, (0, __upyo_core.parseRetryAfter)(response.headers.get("Retry-After")), attempt + 1);
 				try {
 					return JSON.parse(text);
 				} catch (error) {
@@ -119,7 +162,7 @@ var LettermintHttpClient = class {
 				lastError = error instanceof Error ? error : new Error(String(error));
 				if (error instanceof LettermintApiError && !isRetryable(error)) throw error;
 				if (error instanceof Error && error.name === "AbortError" && signal?.aborted) throw error;
-				if (attempt === this.config.retries) throw lastError;
+				if (attempt === this.config.retries) throw withAttempts(lastError, attempt + 1);
 				await sleep(calculateRetryDelay(attempt), signal);
 			}
 		}
@@ -151,6 +194,11 @@ var LettermintHttpClient = class {
 		}
 	}
 };
+function withAttempts(error, attempts) {
+	if (error instanceof LettermintTimeoutError) return new LettermintTimeoutError(error.timeout, attempts);
+	if (error instanceof LettermintApiError) return error;
+	return Object.assign(error, { attempts });
+}
 function isRetryable(error) {
 	return error.statusCode === 408 || error.statusCode === 429 || error.statusCode >= 500;
 }
@@ -348,6 +396,7 @@ const MAX_BATCH_SIZE = 500;
 * @since 0.5.0
 */
 var LettermintTransport = class {
+	id = "lettermint";
 	/**
 	* The resolved Lettermint configuration used by this transport.
 	*/
@@ -379,10 +428,7 @@ var LettermintTransport = class {
 			return responseToReceipt(response);
 		} catch (error) {
 			if (isAbortError(error)) throw error;
-			return {
-				successful: false,
-				errorMessages: [error instanceof Error ? error.message : String(error)]
-			};
+			return createLettermintFailure(error instanceof Error ? error.message : String(error), error);
 		}
 	}
 	/**
@@ -420,10 +466,7 @@ var LettermintTransport = class {
 			batchData.push(await convertMessage(message, this.config));
 			receipts.push(void 0);
 		} catch (error) {
-			receipts.push({
-				successful: false,
-				errorMessages: [error instanceof Error ? error.message : String(error)]
-			});
+			receipts.push(createLettermintFailure(error instanceof Error ? error.message : String(error), error));
 		}
 		if (batchData.length === 0) {
 			for (const receipt of receipts) if (receipt !== void 0) yield receipt;
@@ -450,10 +493,7 @@ var LettermintTransport = class {
 					yield receipt;
 					continue;
 				}
-				yield {
-					successful: false,
-					errorMessages: [errorMessage]
-				};
+				yield { ...createLettermintFailure(errorMessage, error) };
 			}
 		}
 	}
@@ -465,18 +505,47 @@ function hasIdempotencyKey(message) {
 	return message.idempotencyKey != null && message.idempotencyKey !== "";
 }
 function responseToReceipt(response) {
-	if (response?.message_id == null || response.message_id === "") return {
-		successful: false,
-		errorMessages: ["Lettermint response is missing a message ID."]
-	};
+	if (response?.message_id == null || response.message_id === "") return (0, __upyo_core.createFailedReceipt)("Lettermint response is missing a message ID.", {
+		provider: "lettermint",
+		category: "unknown",
+		code: "lettermint.missing_message_id",
+		retryable: false
+	});
 	if (isSuccessfulStatus(response.status)) return {
 		successful: true,
-		messageId: response.message_id
-	};
-	return {
-		successful: false,
-		errorMessages: [`Lettermint reported message status "${response.status}".`]
+		messageId: response.message_id,
+		provider: "lettermint"
 	};
+	return (0, __upyo_core.createFailedReceipt)(`Lettermint reported message status "${response.status}".`, {
+		provider: "lettermint",
+		category: "rejected",
+		code: `lettermint.${response.status}`,
+		retryable: response.status === "soft_bounced"
+	});
+}
+function createLettermintFailure(message, error) {
+	if (error instanceof LettermintApiError) return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "lettermint",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		attempts: error.attempts
+	});
+	if (error instanceof LettermintTimeoutError) return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "lettermint",
+		category: "timeout",
+		code: "timeout",
+		retryable: true,
+		attempts: error.attempts
+	});
+	return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "lettermint",
+		attempts: getErrorAttempts(error)
+	});
+}
+function getErrorAttempts(error) {
+	if (typeof error !== "object" || error == null || !("attempts" in error)) return void 0;
+	const attempts = error.attempts;
+	return typeof attempts === "number" ? attempts : void 0;
 }
 function isSuccessfulStatus(status) {
 	switch (status) {

package/dist/index.d.cts

@@ -126,7 +126,8 @@ declare function createLettermintConfig(config: LettermintConfig): ResolvedLette
  *
  * @since 0.5.0
  */
-declare class LettermintTransport implements Transport {
+declare class LettermintTransport implements Transport<"lettermint"> {
+  readonly id = "lettermint";
   /**
    * The resolved Lettermint configuration used by this transport.
    */
@@ -145,7 +146,7 @@ declare class LettermintTransport implements Transport {
    * @param options Optional transport options including `AbortSignal`.
    * @returns A receipt indicating success or failure.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<"lettermint">>;
   /**
    * Sends multiple email messages via Lettermint batch API.
    *
@@ -155,7 +156,7 @@ declare class LettermintTransport implements Transport {
    * @param options Optional transport options including `AbortSignal`.
    * @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<"lettermint">>;
   private sendBatch;
 }
 //#endregion
@@ -203,13 +204,17 @@ interface LettermintError {
  */
 declare class LettermintApiError extends Error {
   readonly statusCode: number;
+  readonly retryAfterMilliseconds?: number;
+  readonly attempts?: number;
   /**
    * Creates a Lettermint API error.
    *
    * @param message Error message.
    * @param statusCode HTTP status code.
+   * @param retryAfterMilliseconds Retry delay from the response.
+   * @param attempts Number of attempts made before this error.
    */
-  constructor(message: string, statusCode: number);
+  constructor(message: string, statusCode: number, retryAfterMilliseconds?: number, attempts?: number);
 }
 /**
  * Lettermint request timeout error.
@@ -217,13 +222,25 @@ declare class LettermintApiError extends Error {
  * @since 0.5.0
  */
 declare class LettermintTimeoutError extends Error {
+  /**
+   * Request timeout in milliseconds.
+   *
+   * @since 0.5.0
+   */
   readonly timeout: number;
+  /**
+   * Number of attempts made before this error was produced.
+   *
+   * @since 0.5.0
+   */
+  readonly attempts?: number;
   /**
    * Creates a Lettermint request timeout error.
    *
    * @param timeout Request timeout in milliseconds.
+   * @param attempts Number of attempts made before this error.
    */
-  constructor(timeout: number);
+  constructor(timeout: number, attempts?: number);
 }
 /**
  * HTTP client wrapper for Lettermint API requests.

package/dist/index.d.ts

@@ -126,7 +126,8 @@ declare function createLettermintConfig(config: LettermintConfig): ResolvedLette
  *
  * @since 0.5.0
  */
-declare class LettermintTransport implements Transport {
+declare class LettermintTransport implements Transport<"lettermint"> {
+  readonly id = "lettermint";
   /**
    * The resolved Lettermint configuration used by this transport.
    */
@@ -145,7 +146,7 @@ declare class LettermintTransport implements Transport {
    * @param options Optional transport options including `AbortSignal`.
    * @returns A receipt indicating success or failure.
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<"lettermint">>;
   /**
    * Sends multiple email messages via Lettermint batch API.
    *
@@ -155,7 +156,7 @@ declare class LettermintTransport implements Transport {
    * @param options Optional transport options including `AbortSignal`.
    * @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<"lettermint">>;
   private sendBatch;
 }
 //#endregion
@@ -203,13 +204,17 @@ interface LettermintError {
  */
 declare class LettermintApiError extends Error {
   readonly statusCode: number;
+  readonly retryAfterMilliseconds?: number;
+  readonly attempts?: number;
   /**
    * Creates a Lettermint API error.
    *
    * @param message Error message.
    * @param statusCode HTTP status code.
+   * @param retryAfterMilliseconds Retry delay from the response.
+   * @param attempts Number of attempts made before this error.
    */
-  constructor(message: string, statusCode: number);
+  constructor(message: string, statusCode: number, retryAfterMilliseconds?: number, attempts?: number);
 }
 /**
  * Lettermint request timeout error.
@@ -217,13 +222,25 @@ declare class LettermintApiError extends Error {
  * @since 0.5.0
  */
 declare class LettermintTimeoutError extends Error {
+  /**
+   * Request timeout in milliseconds.
+   *
+   * @since 0.5.0
+   */
   readonly timeout: number;
+  /**
+   * Number of attempts made before this error was produced.
+   *
+   * @since 0.5.0
+   */
+  readonly attempts?: number;
   /**
    * Creates a Lettermint request timeout error.
    *
    * @param timeout Request timeout in milliseconds.
+   * @param attempts Number of attempts made before this error.
    */
-  constructor(timeout: number);
+  constructor(timeout: number, attempts?: number);
 }
 /**
  * HTTP client wrapper for Lettermint API requests.

package/dist/index.js

@@ -1,3 +1,5 @@
+import { createFailedReceipt, parseRetryAfter } from "@upyo/core";
+
 //#region src/config.ts
 /**
 * Creates a resolved Lettermint configuration by applying default values.
@@ -32,16 +34,22 @@ function normalizeBaseUrl(baseUrl) {
 */
 var LettermintApiError = class extends Error {
 	statusCode;
+	retryAfterMilliseconds;
+	attempts;
 	/**
 	* Creates a Lettermint API error.
 	*
 	* @param message Error message.
 	* @param statusCode HTTP status code.
+	* @param retryAfterMilliseconds Retry delay from the response.
+	* @param attempts Number of attempts made before this error.
 	*/
-	constructor(message, statusCode) {
+	constructor(message, statusCode, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "LettermintApiError";
 		this.statusCode = statusCode;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
 /**
@@ -50,16 +58,29 @@ var LettermintApiError = class extends Error {
 * @since 0.5.0
 */
 var LettermintTimeoutError = class extends Error {
+	/**
+	* Request timeout in milliseconds.
+	*
+	* @since 0.5.0
+	*/
 	timeout;
 	/**
+	* Number of attempts made before this error was produced.
+	*
+	* @since 0.5.0
+	*/
+	attempts;
+	/**
 	* Creates a Lettermint request timeout error.
 	*
 	* @param timeout Request timeout in milliseconds.
+	* @param attempts Number of attempts made before this error.
 	*/
-	constructor(timeout) {
+	constructor(timeout, attempts) {
 		super(`Lettermint API request timed out after ${timeout} ms.`);
 		this.name = "LettermintTimeoutError";
 		this.timeout = timeout;
+		this.attempts = attempts;
 	}
 };
 /**
@@ -108,7 +129,7 @@ var LettermintHttpClient = class {
 			try {
 				const response = await this.fetchWithAuth(url, body, signal, idempotencyKey);
 				const text = await response.text();
-				if (!response.ok) throw new LettermintApiError(parseErrorMessage(text, response.status), response.status);
+				if (!response.ok) throw new LettermintApiError(parseErrorMessage(text, response.status), response.status, parseRetryAfter(response.headers.get("Retry-After")), attempt + 1);
 				try {
 					return JSON.parse(text);
 				} catch (error) {
@@ -118,7 +139,7 @@ var LettermintHttpClient = class {
 				lastError = error instanceof Error ? error : new Error(String(error));
 				if (error instanceof LettermintApiError && !isRetryable(error)) throw error;
 				if (error instanceof Error && error.name === "AbortError" && signal?.aborted) throw error;
-				if (attempt === this.config.retries) throw lastError;
+				if (attempt === this.config.retries) throw withAttempts(lastError, attempt + 1);
 				await sleep(calculateRetryDelay(attempt), signal);
 			}
 		}
@@ -150,6 +171,11 @@ var LettermintHttpClient = class {
 		}
 	}
 };
+function withAttempts(error, attempts) {
+	if (error instanceof LettermintTimeoutError) return new LettermintTimeoutError(error.timeout, attempts);
+	if (error instanceof LettermintApiError) return error;
+	return Object.assign(error, { attempts });
+}
 function isRetryable(error) {
 	return error.statusCode === 408 || error.statusCode === 429 || error.statusCode >= 500;
 }
@@ -347,6 +373,7 @@ const MAX_BATCH_SIZE = 500;
 * @since 0.5.0
 */
 var LettermintTransport = class {
+	id = "lettermint";
 	/**
 	* The resolved Lettermint configuration used by this transport.
 	*/
@@ -378,10 +405,7 @@ var LettermintTransport = class {
 			return responseToReceipt(response);
 		} catch (error) {
 			if (isAbortError(error)) throw error;
-			return {
-				successful: false,
-				errorMessages: [error instanceof Error ? error.message : String(error)]
-			};
+			return createLettermintFailure(error instanceof Error ? error.message : String(error), error);
 		}
 	}
 	/**
@@ -419,10 +443,7 @@ var LettermintTransport = class {
 			batchData.push(await convertMessage(message, this.config));
 			receipts.push(void 0);
 		} catch (error) {
-			receipts.push({
-				successful: false,
-				errorMessages: [error instanceof Error ? error.message : String(error)]
-			});
+			receipts.push(createLettermintFailure(error instanceof Error ? error.message : String(error), error));
 		}
 		if (batchData.length === 0) {
 			for (const receipt of receipts) if (receipt !== void 0) yield receipt;
@@ -449,10 +470,7 @@ var LettermintTransport = class {
 					yield receipt;
 					continue;
 				}
-				yield {
-					successful: false,
-					errorMessages: [errorMessage]
-				};
+				yield { ...createLettermintFailure(errorMessage, error) };
 			}
 		}
 	}
@@ -464,18 +482,47 @@ function hasIdempotencyKey(message) {
 	return message.idempotencyKey != null && message.idempotencyKey !== "";
 }
 function responseToReceipt(response) {
-	if (response?.message_id == null || response.message_id === "") return {
-		successful: false,
-		errorMessages: ["Lettermint response is missing a message ID."]
-	};
+	if (response?.message_id == null || response.message_id === "") return createFailedReceipt("Lettermint response is missing a message ID.", {
+		provider: "lettermint",
+		category: "unknown",
+		code: "lettermint.missing_message_id",
+		retryable: false
+	});
 	if (isSuccessfulStatus(response.status)) return {
 		successful: true,
-		messageId: response.message_id
-	};
-	return {
-		successful: false,
-		errorMessages: [`Lettermint reported message status "${response.status}".`]
+		messageId: response.message_id,
+		provider: "lettermint"
 	};
+	return createFailedReceipt(`Lettermint reported message status "${response.status}".`, {
+		provider: "lettermint",
+		category: "rejected",
+		code: `lettermint.${response.status}`,
+		retryable: response.status === "soft_bounced"
+	});
+}
+function createLettermintFailure(message, error) {
+	if (error instanceof LettermintApiError) return createFailedReceipt(message, {
+		provider: "lettermint",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		attempts: error.attempts
+	});
+	if (error instanceof LettermintTimeoutError) return createFailedReceipt(message, {
+		provider: "lettermint",
+		category: "timeout",
+		code: "timeout",
+		retryable: true,
+		attempts: error.attempts
+	});
+	return createFailedReceipt(message, {
+		provider: "lettermint",
+		attempts: getErrorAttempts(error)
+	});
+}
+function getErrorAttempts(error) {
+	if (typeof error !== "object" || error == null || !("attempts" in error)) return void 0;
+	const attempts = error.attempts;
+	return typeof attempts === "number" ? attempts : void 0;
 }
 function isSuccessfulStatus(status) {
 	switch (status) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/lettermint",
-  "version": "0.5.0-dev.128",
+  "version": "0.5.0-dev.154",
   "description": "Lettermint transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,18 +53,13 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.5.0-dev.128+6e126027"
+    "@upyo/core": "0.5.0-dev.154+2f72d353"
   },
   "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"
   }
 }