@upyo/jmap 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/errors.ts
 /**
@@ -8,12 +32,16 @@ var JmapApiError = class extends Error {
 	statusCode;
 	responseBody;
 	jmapErrorType;
-	constructor(message, statusCode, responseBody, jmapErrorType) {
+	retryAfterMilliseconds;
+	attempts;
+	constructor(message, statusCode, responseBody, jmapErrorType, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "JmapApiError";
 		this.statusCode = statusCode;
 		this.responseBody = responseBody;
 		this.jmapErrorType = jmapErrorType;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
 /**
@@ -64,13 +92,13 @@ async function uploadBlob(config, uploadUrl, accountId, blob, signal) {
 	for (const [key, value] of Object.entries(config.headers)) headers[key] = value;
 	const controller = new AbortController();
 	const timeoutId = setTimeout(() => controller.abort(), config.timeout);
-	const combinedSignal = signal ? combineSignals(signal, controller.signal) : controller.signal;
+	const combinedSignal = (0, __upyo_core.combineSignals)(controller.signal, signal);
 	try {
 		const response = await fetch(url, {
 			method: "POST",
 			headers,
 			body: blob,
-			signal: combinedSignal
+			signal: combinedSignal.signal
 		});
 		if (!response.ok) {
 			const body = await response.text();
@@ -79,23 +107,10 @@ async function uploadBlob(config, uploadUrl, accountId, blob, signal) {
 		const result = await response.json();
 		return result;
 	} finally {
+		combinedSignal.cleanup();
 		clearTimeout(timeoutId);
 	}
 }
-/**
-* Combine multiple abort signals into one.
-*/
-function combineSignals(...signals) {
-	const controller = new AbortController();
-	for (const signal of signals) {
-		if (signal.aborted) {
-			controller.abort(signal.reason);
-			break;
-		}
-		signal.addEventListener("abort", () => controller.abort(signal.reason), { once: true });
-	}
-	return controller.signal;
-}
 
 //#endregion
 //#region src/config.ts
@@ -144,7 +159,7 @@ var JmapHttpClient = class {
 		const response = await this.fetchWithAuth(this.config.sessionUrl, { method: "GET" }, signal);
 		if (!response.ok) {
 			const text = await response.text();
-			throw new JmapApiError(`Session fetch failed: ${response.status}`, response.status, text);
+			throw new JmapApiError(`Session fetch failed: ${response.status}`, response.status, text, void 0, (0, __upyo_core.parseRetryAfter)(response.headers.get("Retry-After")), 1);
 		}
 		return await response.json();
 	}
@@ -169,23 +184,28 @@ var JmapHttpClient = class {
 				}, signal);
 				if (!response.ok) {
 					const text = await response.text();
-					const error = new JmapApiError(`JMAP request failed: ${response.status}`, response.status, text);
+					const error = new JmapApiError(`JMAP request failed: ${response.status}`, response.status, text, void 0, (0, __upyo_core.parseRetryAfter)(response.headers.get("Retry-After")), attempt + 1);
 					if (response.status >= 400 && response.status < 500) throw error;
 					throw error;
 				}
 				return await response.json();
 			} catch (error) {
-				if (error instanceof Error && error.name === "AbortError") throw error;
+				if (isCallerAbort(error, signal)) throw error;
 				if (error instanceof JmapApiError && error.statusCode !== void 0) {
 					if (error.statusCode >= 400 && error.statusCode < 500) throw error;
 				}
 				lastError = error instanceof Error ? error : new Error(String(error));
-				if (attempt === this.config.retries) throw error;
+				if (attempt === this.config.retries) {
+					if (error instanceof JmapApiError) throw error;
+					if (isAbortError$1(error)) throw new JmapApiError("JMAP request timed out.", void 0, void 0, void 0, void 0, attempt + 1);
+					throw new JmapApiError(lastError.message, void 0, void 0, void 0, void 0, attempt + 1);
+				}
 				const delay = Math.pow(2, attempt) * 1e3;
 				await new Promise((resolve) => setTimeout(resolve, delay));
 			}
 		}
-		throw lastError || /* @__PURE__ */ new Error("Request failed after all retries");
+		if (lastError != null) throw lastError;
+		throw new Error("Request failed after all retries");
 	}
 	/**
 	* Makes an authenticated fetch request.
@@ -231,6 +251,12 @@ var JmapHttpClient = class {
 		}
 	}
 };
+function isCallerAbort(error, signal) {
+	return signal?.aborted === true && (isAbortError$1(error) || error === signal.reason);
+}
+function isAbortError$1(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 
 //#endregion
 //#region src/message-converter.ts
@@ -443,6 +469,7 @@ const JMAP_CAPABILITIES = {
 * @since 0.4.0
 */
 var JmapTransport = class {
+	id = "jmap";
 	config;
 	httpClient;
 	cachedSession = null;
@@ -460,19 +487,22 @@ var JmapTransport = class {
 	* @param message The message to send.
 	* @param options Optional transport options.
 	* @returns A receipt indicating success or failure.
+	* @throws The abort reason or an `AbortError` when the caller aborts the
+	*         operation.
 	* @since 0.4.0
 	*/
 	async send(message, options) {
 		const signal = options?.signal;
+		signal?.throwIfAborted();
 		try {
-			signal?.throwIfAborted();
 			const session = await this.getSession(signal);
 			signal?.throwIfAborted();
 			const accountId = this.config.accountId ?? findMailAccount(session);
-			if (!accountId) return {
-				successful: false,
-				errorMessages: ["No mail-capable account found in JMAP session"]
-			};
+			if (!accountId) return createJmapFailure("No mail-capable account found in JMAP session", void 0, {
+				category: "configuration",
+				code: "jmap.no_mail_account",
+				retryable: false
+			});
 			const draftsMailboxId = await this.getDraftsMailboxId(session, accountId, signal);
 			signal?.throwIfAborted();
 			const identityId = await this.getIdentityId(session, accountId, message.sender.address, signal);
@@ -507,18 +537,14 @@ var JmapTransport = class {
 			}, signal);
 			return this.parseResponse(response);
 		} catch (error) {
-			if (error instanceof Error && error.name === "AbortError") return {
-				successful: false,
-				errorMessages: [`Request aborted: ${error.message}`]
-			};
-			if (error instanceof JmapApiError) return {
-				successful: false,
-				errorMessages: [error.message]
-			};
-			return {
-				successful: false,
-				errorMessages: [error instanceof Error ? error.message : String(error)]
-			};
+			if (signal?.aborted) throw getAbortReason(signal, error);
+			if (error instanceof Error && error.name === "AbortError") return createJmapFailure(`Request aborted: ${error.message}`, error, {
+				category: "timeout",
+				code: "abort",
+				retryable: true
+			});
+			if (error instanceof JmapApiError) return createJmapFailure(error.message, error);
+			return createJmapFailure(error instanceof Error ? error.message : String(error), error);
 		}
 	}
 	/**
@@ -526,6 +552,8 @@ var JmapTransport = class {
 	* @param messages The messages to send.
 	* @param options Optional transport options.
 	* @yields Receipts for each message.
+	* @throws The abort reason or an `AbortError` when the caller aborts the
+	*         operation.
 	* @since 0.4.0
 	*/
 	async *sendMany(messages, options) {
@@ -543,10 +571,11 @@ var JmapTransport = class {
 			processingStage = "account discovery";
 			const accountId = this.config.accountId ?? findMailAccount(session);
 			if (!accountId) {
-				for (let i = 0; i < messageArray.length; i++) yield {
-					successful: false,
-					errorMessages: ["No mail-capable account found in JMAP session"]
-				};
+				for (let i = 0; i < messageArray.length; i++) yield createJmapFailure("No mail-capable account found in JMAP session", void 0, {
+					category: "configuration",
+					code: "jmap.no_mail_account",
+					retryable: false
+				});
 				return;
 			}
 			processingStage = "mailbox discovery";
@@ -604,13 +633,16 @@ var JmapTransport = class {
 			}, signal);
 			for (let i = 0; i < messageArray.length; i++) yield this.parseBatchResponseForIndex(response, i);
 		} catch (error) {
+			if (signal?.aborted) throw getAbortReason(signal, error);
+			const timeoutOverride = error instanceof Error && error.name === "AbortError" ? {
+				category: "timeout",
+				code: "abort",
+				retryable: true
+			} : void 0;
 			const baseMessage = error instanceof Error && error.name === "AbortError" ? `Request aborted: ${error.message}` : error instanceof JmapApiError ? error.message : error instanceof Error ? error.message : String(error);
 			let detailedMessage = `Failed during ${processingStage}: ${baseMessage}`;
 			if (processingStage === "attachment upload" && attachmentsUploadedCount > 0) detailedMessage += ` (${attachmentsUploadedCount}/${messageArray.length} messages had attachments uploaded before failure)`;
-			for (let i = 0; i < messageArray.length; i++) yield {
-				successful: false,
-				errorMessages: [detailedMessage]
-			};
+			for (let i = 0; i < messageArray.length; i++) yield createJmapFailure(detailedMessage, error, timeoutOverride);
 		}
 	}
 	/**
@@ -768,14 +800,17 @@ var JmapTransport = class {
 			if (submissionResult.notCreated) for (const [key, error] of Object.entries(submissionResult.notCreated)) errors.push(`Email submission failed (${key}): ${error.type}${error.description ? ` - ${error.description}` : ""}`);
 			if (submissionResult.created?.submission) return {
 				successful: true,
-				messageId: submissionResult.created.submission.id
+				messageId: submissionResult.created.submission.id,
+				provider: "jmap"
 			};
 		}
 		if (errors.length === 0) errors.push("Unknown error: No submission result received");
-		return {
-			successful: false,
-			errorMessages: errors
-		};
+		return (0, __upyo_core.createFailedReceipt)(errors, {
+			provider: "jmap",
+			category: "rejected",
+			code: "jmap.submission_failed",
+			retryable: false
+		});
 	}
 	/**
 	* Parses the JMAP batch response to extract receipt for a specific index.
@@ -805,16 +840,53 @@ var JmapTransport = class {
 			}
 			if (submissionResult.created?.[subKey]) return {
 				successful: true,
-				messageId: submissionResult.created[subKey].id
+				messageId: submissionResult.created[subKey].id,
+				provider: "jmap"
 			};
 		}
 		if (errors.length === 0) errors.push("Unknown error: No submission result received");
-		return {
-			successful: false,
-			errorMessages: errors
-		};
+		return (0, __upyo_core.createFailedReceipt)(errors, {
+			provider: "jmap",
+			category: "rejected",
+			code: "jmap.submission_failed",
+			retryable: false
+		});
 	}
 };
+function createJmapFailure(message, error, override = {}) {
+	const attempts = getAttemptCount(error);
+	if (error instanceof JmapApiError) return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "jmap",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		attempts,
+		providerDetails: {
+			responseBody: error.responseBody,
+			jmapErrorType: error.jmapErrorType
+		},
+		category: override.category,
+		code: override.code,
+		retryable: override.retryable
+	});
+	return (0, __upyo_core.createFailedReceipt)(message, {
+		provider: "jmap",
+		attempts,
+		category: override.category,
+		code: override.code,
+		retryable: override.retryable
+	});
+}
+function getAttemptCount(error) {
+	if (error instanceof JmapApiError) return error.attempts ?? 1;
+	if (typeof error === "object" && error !== null && "attempts" in error && typeof error.attempts === "number") return error.attempts;
+	return 1;
+}
+function getAbortReason(signal, fallback) {
+	return signal.reason ?? (isAbortError(fallback) ? fallback : void 0) ?? new DOMException("The operation was aborted.", "AbortError");
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 
 //#endregion
 exports.JMAP_ERROR_TYPES = JMAP_ERROR_TYPES;

package/dist/index.d.cts

@@ -103,7 +103,8 @@ declare function createJmapConfig(config: JmapConfig): ResolvedJmapConfig;
  * JMAP transport for sending emails via JMAP protocol (RFC 8620/8621).
  * @since 0.4.0
  */
-declare class JmapTransport implements Transport {
+declare class JmapTransport implements Transport<"jmap"> {
+  readonly id = "jmap";
   readonly config: ResolvedJmapConfig;
   private readonly httpClient;
   private cachedSession;
@@ -118,17 +119,21 @@ declare class JmapTransport implements Transport {
    * @param message The message to send.
    * @param options Optional transport options.
    * @returns A receipt indicating success or failure.
+   * @throws The abort reason or an `AbortError` when the caller aborts the
+   *         operation.
    * @since 0.4.0
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<"jmap">>;
   /**
    * Sends multiple messages in a single batched JMAP request.
    * @param messages The messages to send.
    * @param options Optional transport options.
    * @yields Receipts for each message.
+   * @throws The abort reason or an `AbortError` when the caller aborts the
+   *         operation.
    * @since 0.4.0
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<"jmap">>;
   /**
    * Gets or refreshes the JMAP session.
    * @param signal Optional abort signal.
@@ -207,7 +212,9 @@ declare class JmapApiError extends Error {
   readonly statusCode?: number;
   readonly responseBody?: string;
   readonly jmapErrorType?: string;
-  constructor(message: string, statusCode?: number, responseBody?: string, jmapErrorType?: string);
+  readonly retryAfterMilliseconds?: number;
+  readonly attempts?: number;
+  constructor(message: string, statusCode?: number, responseBody?: string, jmapErrorType?: string, retryAfterMilliseconds?: number, attempts?: number);
 }
 /**
  * JMAP-specific error types from RFC 8620.

package/dist/index.d.ts

@@ -103,7 +103,8 @@ declare function createJmapConfig(config: JmapConfig): ResolvedJmapConfig;
  * JMAP transport for sending emails via JMAP protocol (RFC 8620/8621).
  * @since 0.4.0
  */
-declare class JmapTransport implements Transport {
+declare class JmapTransport implements Transport<"jmap"> {
+  readonly id = "jmap";
   readonly config: ResolvedJmapConfig;
   private readonly httpClient;
   private cachedSession;
@@ -118,17 +119,21 @@ declare class JmapTransport implements Transport {
    * @param message The message to send.
    * @param options Optional transport options.
    * @returns A receipt indicating success or failure.
+   * @throws The abort reason or an `AbortError` when the caller aborts the
+   *         operation.
    * @since 0.4.0
    */
-  send(message: Message, options?: TransportOptions): Promise<Receipt>;
+  send(message: Message, options?: TransportOptions): Promise<Receipt<"jmap">>;
   /**
    * Sends multiple messages in a single batched JMAP request.
    * @param messages The messages to send.
    * @param options Optional transport options.
    * @yields Receipts for each message.
+   * @throws The abort reason or an `AbortError` when the caller aborts the
+   *         operation.
    * @since 0.4.0
    */
-  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt>;
+  sendMany(messages: Iterable<Message> | AsyncIterable<Message>, options?: TransportOptions): AsyncIterable<Receipt<"jmap">>;
   /**
    * Gets or refreshes the JMAP session.
    * @param signal Optional abort signal.
@@ -207,7 +212,9 @@ declare class JmapApiError extends Error {
   readonly statusCode?: number;
   readonly responseBody?: string;
   readonly jmapErrorType?: string;
-  constructor(message: string, statusCode?: number, responseBody?: string, jmapErrorType?: string);
+  readonly retryAfterMilliseconds?: number;
+  readonly attempts?: number;
+  constructor(message: string, statusCode?: number, responseBody?: string, jmapErrorType?: string, retryAfterMilliseconds?: number, attempts?: number);
 }
 /**
  * JMAP-specific error types from RFC 8620.

package/dist/index.js

@@ -1,3 +1,5 @@
+import { combineSignals, createFailedReceipt, parseRetryAfter } from "@upyo/core";
+
 //#region src/errors.ts
 /**
 * Error class for JMAP API errors.
@@ -7,12 +9,16 @@ var JmapApiError = class extends Error {
 	statusCode;
 	responseBody;
 	jmapErrorType;
-	constructor(message, statusCode, responseBody, jmapErrorType) {
+	retryAfterMilliseconds;
+	attempts;
+	constructor(message, statusCode, responseBody, jmapErrorType, retryAfterMilliseconds, attempts) {
 		super(message);
 		this.name = "JmapApiError";
 		this.statusCode = statusCode;
 		this.responseBody = responseBody;
 		this.jmapErrorType = jmapErrorType;
+		this.retryAfterMilliseconds = retryAfterMilliseconds;
+		this.attempts = attempts;
 	}
 };
 /**
@@ -63,13 +69,13 @@ async function uploadBlob(config, uploadUrl, accountId, blob, signal) {
 	for (const [key, value] of Object.entries(config.headers)) headers[key] = value;
 	const controller = new AbortController();
 	const timeoutId = setTimeout(() => controller.abort(), config.timeout);
-	const combinedSignal = signal ? combineSignals(signal, controller.signal) : controller.signal;
+	const combinedSignal = combineSignals(controller.signal, signal);
 	try {
 		const response = await fetch(url, {
 			method: "POST",
 			headers,
 			body: blob,
-			signal: combinedSignal
+			signal: combinedSignal.signal
 		});
 		if (!response.ok) {
 			const body = await response.text();
@@ -78,23 +84,10 @@ async function uploadBlob(config, uploadUrl, accountId, blob, signal) {
 		const result = await response.json();
 		return result;
 	} finally {
+		combinedSignal.cleanup();
 		clearTimeout(timeoutId);
 	}
 }
-/**
-* Combine multiple abort signals into one.
-*/
-function combineSignals(...signals) {
-	const controller = new AbortController();
-	for (const signal of signals) {
-		if (signal.aborted) {
-			controller.abort(signal.reason);
-			break;
-		}
-		signal.addEventListener("abort", () => controller.abort(signal.reason), { once: true });
-	}
-	return controller.signal;
-}
 
 //#endregion
 //#region src/config.ts
@@ -143,7 +136,7 @@ var JmapHttpClient = class {
 		const response = await this.fetchWithAuth(this.config.sessionUrl, { method: "GET" }, signal);
 		if (!response.ok) {
 			const text = await response.text();
-			throw new JmapApiError(`Session fetch failed: ${response.status}`, response.status, text);
+			throw new JmapApiError(`Session fetch failed: ${response.status}`, response.status, text, void 0, parseRetryAfter(response.headers.get("Retry-After")), 1);
 		}
 		return await response.json();
 	}
@@ -168,23 +161,28 @@ var JmapHttpClient = class {
 				}, signal);
 				if (!response.ok) {
 					const text = await response.text();
-					const error = new JmapApiError(`JMAP request failed: ${response.status}`, response.status, text);
+					const error = new JmapApiError(`JMAP request failed: ${response.status}`, response.status, text, void 0, parseRetryAfter(response.headers.get("Retry-After")), attempt + 1);
 					if (response.status >= 400 && response.status < 500) throw error;
 					throw error;
 				}
 				return await response.json();
 			} catch (error) {
-				if (error instanceof Error && error.name === "AbortError") throw error;
+				if (isCallerAbort(error, signal)) throw error;
 				if (error instanceof JmapApiError && error.statusCode !== void 0) {
 					if (error.statusCode >= 400 && error.statusCode < 500) throw error;
 				}
 				lastError = error instanceof Error ? error : new Error(String(error));
-				if (attempt === this.config.retries) throw error;
+				if (attempt === this.config.retries) {
+					if (error instanceof JmapApiError) throw error;
+					if (isAbortError$1(error)) throw new JmapApiError("JMAP request timed out.", void 0, void 0, void 0, void 0, attempt + 1);
+					throw new JmapApiError(lastError.message, void 0, void 0, void 0, void 0, attempt + 1);
+				}
 				const delay = Math.pow(2, attempt) * 1e3;
 				await new Promise((resolve) => setTimeout(resolve, delay));
 			}
 		}
-		throw lastError || /* @__PURE__ */ new Error("Request failed after all retries");
+		if (lastError != null) throw lastError;
+		throw new Error("Request failed after all retries");
 	}
 	/**
 	* Makes an authenticated fetch request.
@@ -230,6 +228,12 @@ var JmapHttpClient = class {
 		}
 	}
 };
+function isCallerAbort(error, signal) {
+	return signal?.aborted === true && (isAbortError$1(error) || error === signal.reason);
+}
+function isAbortError$1(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 
 //#endregion
 //#region src/message-converter.ts
@@ -442,6 +446,7 @@ const JMAP_CAPABILITIES = {
 * @since 0.4.0
 */
 var JmapTransport = class {
+	id = "jmap";
 	config;
 	httpClient;
 	cachedSession = null;
@@ -459,19 +464,22 @@ var JmapTransport = class {
 	* @param message The message to send.
 	* @param options Optional transport options.
 	* @returns A receipt indicating success or failure.
+	* @throws The abort reason or an `AbortError` when the caller aborts the
+	*         operation.
 	* @since 0.4.0
 	*/
 	async send(message, options) {
 		const signal = options?.signal;
+		signal?.throwIfAborted();
 		try {
-			signal?.throwIfAborted();
 			const session = await this.getSession(signal);
 			signal?.throwIfAborted();
 			const accountId = this.config.accountId ?? findMailAccount(session);
-			if (!accountId) return {
-				successful: false,
-				errorMessages: ["No mail-capable account found in JMAP session"]
-			};
+			if (!accountId) return createJmapFailure("No mail-capable account found in JMAP session", void 0, {
+				category: "configuration",
+				code: "jmap.no_mail_account",
+				retryable: false
+			});
 			const draftsMailboxId = await this.getDraftsMailboxId(session, accountId, signal);
 			signal?.throwIfAborted();
 			const identityId = await this.getIdentityId(session, accountId, message.sender.address, signal);
@@ -506,18 +514,14 @@ var JmapTransport = class {
 			}, signal);
 			return this.parseResponse(response);
 		} catch (error) {
-			if (error instanceof Error && error.name === "AbortError") return {
-				successful: false,
-				errorMessages: [`Request aborted: ${error.message}`]
-			};
-			if (error instanceof JmapApiError) return {
-				successful: false,
-				errorMessages: [error.message]
-			};
-			return {
-				successful: false,
-				errorMessages: [error instanceof Error ? error.message : String(error)]
-			};
+			if (signal?.aborted) throw getAbortReason(signal, error);
+			if (error instanceof Error && error.name === "AbortError") return createJmapFailure(`Request aborted: ${error.message}`, error, {
+				category: "timeout",
+				code: "abort",
+				retryable: true
+			});
+			if (error instanceof JmapApiError) return createJmapFailure(error.message, error);
+			return createJmapFailure(error instanceof Error ? error.message : String(error), error);
 		}
 	}
 	/**
@@ -525,6 +529,8 @@ var JmapTransport = class {
 	* @param messages The messages to send.
 	* @param options Optional transport options.
 	* @yields Receipts for each message.
+	* @throws The abort reason or an `AbortError` when the caller aborts the
+	*         operation.
 	* @since 0.4.0
 	*/
 	async *sendMany(messages, options) {
@@ -542,10 +548,11 @@ var JmapTransport = class {
 			processingStage = "account discovery";
 			const accountId = this.config.accountId ?? findMailAccount(session);
 			if (!accountId) {
-				for (let i = 0; i < messageArray.length; i++) yield {
-					successful: false,
-					errorMessages: ["No mail-capable account found in JMAP session"]
-				};
+				for (let i = 0; i < messageArray.length; i++) yield createJmapFailure("No mail-capable account found in JMAP session", void 0, {
+					category: "configuration",
+					code: "jmap.no_mail_account",
+					retryable: false
+				});
 				return;
 			}
 			processingStage = "mailbox discovery";
@@ -603,13 +610,16 @@ var JmapTransport = class {
 			}, signal);
 			for (let i = 0; i < messageArray.length; i++) yield this.parseBatchResponseForIndex(response, i);
 		} catch (error) {
+			if (signal?.aborted) throw getAbortReason(signal, error);
+			const timeoutOverride = error instanceof Error && error.name === "AbortError" ? {
+				category: "timeout",
+				code: "abort",
+				retryable: true
+			} : void 0;
 			const baseMessage = error instanceof Error && error.name === "AbortError" ? `Request aborted: ${error.message}` : error instanceof JmapApiError ? error.message : error instanceof Error ? error.message : String(error);
 			let detailedMessage = `Failed during ${processingStage}: ${baseMessage}`;
 			if (processingStage === "attachment upload" && attachmentsUploadedCount > 0) detailedMessage += ` (${attachmentsUploadedCount}/${messageArray.length} messages had attachments uploaded before failure)`;
-			for (let i = 0; i < messageArray.length; i++) yield {
-				successful: false,
-				errorMessages: [detailedMessage]
-			};
+			for (let i = 0; i < messageArray.length; i++) yield createJmapFailure(detailedMessage, error, timeoutOverride);
 		}
 	}
 	/**
@@ -767,14 +777,17 @@ var JmapTransport = class {
 			if (submissionResult.notCreated) for (const [key, error] of Object.entries(submissionResult.notCreated)) errors.push(`Email submission failed (${key}): ${error.type}${error.description ? ` - ${error.description}` : ""}`);
 			if (submissionResult.created?.submission) return {
 				successful: true,
-				messageId: submissionResult.created.submission.id
+				messageId: submissionResult.created.submission.id,
+				provider: "jmap"
 			};
 		}
 		if (errors.length === 0) errors.push("Unknown error: No submission result received");
-		return {
-			successful: false,
-			errorMessages: errors
-		};
+		return createFailedReceipt(errors, {
+			provider: "jmap",
+			category: "rejected",
+			code: "jmap.submission_failed",
+			retryable: false
+		});
 	}
 	/**
 	* Parses the JMAP batch response to extract receipt for a specific index.
@@ -804,16 +817,53 @@ var JmapTransport = class {
 			}
 			if (submissionResult.created?.[subKey]) return {
 				successful: true,
-				messageId: submissionResult.created[subKey].id
+				messageId: submissionResult.created[subKey].id,
+				provider: "jmap"
 			};
 		}
 		if (errors.length === 0) errors.push("Unknown error: No submission result received");
-		return {
-			successful: false,
-			errorMessages: errors
-		};
+		return createFailedReceipt(errors, {
+			provider: "jmap",
+			category: "rejected",
+			code: "jmap.submission_failed",
+			retryable: false
+		});
 	}
 };
+function createJmapFailure(message, error, override = {}) {
+	const attempts = getAttemptCount(error);
+	if (error instanceof JmapApiError) return createFailedReceipt(message, {
+		provider: "jmap",
+		statusCode: error.statusCode,
+		retryAfterMilliseconds: error.retryAfterMilliseconds,
+		attempts,
+		providerDetails: {
+			responseBody: error.responseBody,
+			jmapErrorType: error.jmapErrorType
+		},
+		category: override.category,
+		code: override.code,
+		retryable: override.retryable
+	});
+	return createFailedReceipt(message, {
+		provider: "jmap",
+		attempts,
+		category: override.category,
+		code: override.code,
+		retryable: override.retryable
+	});
+}
+function getAttemptCount(error) {
+	if (error instanceof JmapApiError) return error.attempts ?? 1;
+	if (typeof error === "object" && error !== null && "attempts" in error && typeof error.attempts === "number") return error.attempts;
+	return 1;
+}
+function getAbortReason(signal, fallback) {
+	return signal.reason ?? (isAbortError(fallback) ? fallback : void 0) ?? new DOMException("The operation was aborted.", "AbortError");
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 
 //#endregion
 export { JMAP_ERROR_TYPES, JmapApiError, JmapTransport, createJmapConfig, isCapabilityError, uploadBlob };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/jmap",
-  "version": "0.5.0-dev.86",
+  "version": "0.5.0",
   "description": "JMAP transport for Upyo email library",
   "keywords": [
     "email",
@@ -53,19 +53,14 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.5.0-dev.86+2a12a704"
+    "@upyo/core": "0.5.0"
   },
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.47.3",
     "jmap-rfc-types": "^0.1.2",
     "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_JOBS=1 deno test --allow-env --allow-net --env-file=.env"
+    "prepublish": "mise run --no-deps :build"
   }
 }