@upyo/pool 0.5.0-dev.136 → 0.5.0-dev.156

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
 /**
@@ -273,6 +297,7 @@ var SelectorStrategy = class {
 * @since 0.3.0
 */
 var PoolTransport = class {
+	id = "pool";
 	/**
 	* The resolved configuration used by this pool transport.
 	*/
@@ -301,27 +326,54 @@ var PoolTransport = class {
 	*/
 	async send(message, options) {
 		const attemptedIndices = /* @__PURE__ */ new Set();
+		const errorMessages = [];
 		const errors = [];
 		for (let attempt = 0; attempt < this.config.maxRetries; attempt++) {
 			if (options?.signal?.aborted) throw new DOMException("The operation was aborted.", "AbortError");
 			const selection = this.strategy.select(message, this.config.transports, attemptedIndices);
 			if (!selection) break;
 			attemptedIndices.add(selection.index);
+			let abortedByCaller = false;
 			try {
 				const sendOptions = this.createSendOptions(options);
-				const receipt = await selection.entry.transport.send(message, sendOptions);
+				let receipt;
+				try {
+					receipt = await selection.entry.transport.send(message, sendOptions.options);
+				} catch (error) {
+					if (isAbortError(error) && sendOptions.abortedByCaller()) {
+						abortedByCaller = true;
+						throw error;
+					}
+					throw error;
+				} finally {
+					sendOptions.cleanup();
+				}
 				if (receipt.successful) return receipt;
-				errors.push(...receipt.errorMessages);
+				errorMessages.push(...receipt.errorMessages);
+				errors.push(...getReceiptErrors(receipt, selection.entry.transport.id));
 			} catch (error) {
-				if (error instanceof DOMException && error.name === "AbortError") throw error;
-				const errorMessage = error instanceof Error ? error.message : String(error);
-				errors.push(errorMessage);
+				if (isAbortError(error) && abortedByCaller) throw error;
+				const thrownErrors = getThrownReceiptErrors(error, selection.entry.transport.id);
+				if (thrownErrors.length > 0) {
+					errorMessages.push(...thrownErrors.map((item) => item.message));
+					errors.push(...thrownErrors);
+					continue;
+				}
+				const timeoutMessage = "Transport send timed out.";
+				const errorMessage = isAbortError(error) ? timeoutMessage : error instanceof Error ? error.message : String(error);
+				errorMessages.push(errorMessage);
+				errors.push((0, __upyo_core.createReceiptError)(errorMessage, {
+					provider: selection.entry.transport.id,
+					category: isAbortError(error) ? "timeout" : void 0,
+					retryable: isAbortError(error) ? true : void 0
+				}));
 			}
 		}
-		return {
-			successful: false,
-			errorMessages: errors.length > 0 ? errors : ["All transports failed to send the message"]
-		};
+		return (0, __upyo_core.createFailedReceipt)(errorMessages.length > 0 ? errorMessages : ["All transports failed to send the message."], {
+			provider: "pool",
+			errors: errors.length > 0 ? errors : void 0,
+			attempts: attemptedIndices.size
+		});
 	}
 	/**
 	* Sends multiple email messages using the pool strategy.
@@ -376,22 +428,68 @@ var PoolTransport = class {
 	* Creates send options with timeout if configured.
 	*/
 	createSendOptions(options) {
-		if (!this.config.timeout) return options;
+		if (!this.config.timeout) return {
+			options,
+			abortedByCaller: () => options?.signal?.aborted ?? false,
+			cleanup: () => {}
+		};
 		const controller = new AbortController();
-		const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-		if (options?.signal) options.signal.addEventListener("abort", () => {
-			clearTimeout(timeoutId);
+		let abortSource;
+		const timeoutId = setTimeout(() => {
+			abortSource ??= "timeout";
 			controller.abort();
-		});
+		}, this.config.timeout);
+		let cleanup = () => clearTimeout(timeoutId);
+		if (options?.signal) {
+			const abort = () => {
+				abortSource ??= "caller";
+				clearTimeout(timeoutId);
+				controller.abort();
+			};
+			if (options.signal.aborted) abort();
+			else options.signal.addEventListener("abort", abort, { once: true });
+			cleanup = () => {
+				clearTimeout(timeoutId);
+				options.signal?.removeEventListener("abort", abort);
+			};
+		}
 		controller.signal.addEventListener("abort", () => {
 			clearTimeout(timeoutId);
 		});
 		return {
-			...options,
-			signal: controller.signal
+			options: {
+				...options,
+				signal: controller.signal
+			},
+			abortedByCaller: () => abortSource === "caller",
+			cleanup
 		};
 	}
 };
+function getReceiptErrors(receipt, provider) {
+	if (receipt.errors != null && receipt.errors.length > 0) return receipt.errors.map((error) => error.provider == null ? {
+		...error,
+		provider
+	} : error);
+	return receipt.errorMessages.map((message) => (0, __upyo_core.createReceiptError)(message, { provider: receipt.provider ?? provider }));
+}
+function getThrownReceiptErrors(error, provider) {
+	if (isReceiptError(error)) return [error.provider == null ? {
+		...error,
+		provider
+	} : error];
+	if (isFailedReceipt(error)) return getReceiptErrors(error, provider);
+	return [];
+}
+function isReceiptError(value) {
+	return typeof value === "object" && value != null && typeof value.message === "string" && typeof value.code === "string" && typeof value.retryable === "boolean" && typeof value.category === "string";
+}
+function isFailedReceipt(value) {
+	return typeof value === "object" && value != null && value.successful === false && Array.isArray(value.errorMessages);
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 
 //#endregion
 exports.PoolTransport = PoolTransport;

package/dist/index.d.cts

@@ -6,11 +6,11 @@ import { Message, Receipt, Transport, TransportOptions } from "@upyo/core";
  * Result of transport selection by a strategy.
  * @since 0.3.0
  */
-interface TransportSelection {
+interface TransportSelection<TProviderId extends string = string> {
   /**
    * The selected transport entry.
    */
-  readonly entry: ResolvedTransportEntry;
+  readonly entry: ResolvedTransportEntry<TProviderId>;
   /**
    * Index of the selected transport in the original list.
    */
@@ -20,7 +20,7 @@ interface TransportSelection {
  * Base interface for transport selection strategies.
  * @since 0.3.0
  */
-interface Strategy {
+interface Strategy<TProviderId extends string = string> {
   /**
    * Selects a transport for sending a message.
    *
@@ -31,7 +31,7 @@ interface Strategy {
    * @returns The selected transport or `undefined` if no suitable transport is
    *          available.
    */
-  select(message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets any internal state of the strategy.
    */
@@ -53,11 +53,11 @@ type TransportSelector = (message: Message) => boolean;
  * Configuration for a transport entry in the pool.
  * @since 0.3.0
  */
-interface TransportEntry {
+interface TransportEntry<TProviderId extends string = string> {
   /**
    * The transport instance to use.
    */
-  readonly transport: Transport;
+  readonly transport: Transport<TProviderId>;
   /**
    * Weight for weighted distribution strategy.
    * Higher values mean more traffic. Defaults to 1.
@@ -84,16 +84,16 @@ interface TransportEntry {
  * Configuration options for the pool transport.
  * @since 0.3.0
  */
-interface PoolConfig {
+interface PoolConfig<TProviderId extends string = string> {
   /**
    * The strategy to use for selecting transports.
    * Can be a built-in strategy name or a custom Strategy instance.
    */
-  readonly strategy: PoolStrategy | Strategy;
+  readonly strategy: PoolStrategy | Strategy<TProviderId>;
   /**
    * The transports in the pool.
    */
-  readonly transports: readonly TransportEntry[];
+  readonly transports: readonly TransportEntry<TProviderId>[];
   /**
    * Maximum number of retry attempts when a transport fails.
    * Set to 0 to disable retries. Defaults to the number of transports.
@@ -114,9 +114,9 @@ interface PoolConfig {
  * Resolved pool configuration with defaults applied.
  * @since 0.3.0
  */
-interface ResolvedPoolConfig {
-  readonly strategy: PoolStrategy | Strategy;
-  readonly transports: readonly ResolvedTransportEntry[];
+interface ResolvedPoolConfig<TProviderId extends string = string> {
+  readonly strategy: PoolStrategy | Strategy<TProviderId>;
+  readonly transports: readonly ResolvedTransportEntry<TProviderId>[];
   readonly maxRetries: number;
   readonly timeout?: number;
   readonly continueOnSuccess: boolean;
@@ -125,8 +125,8 @@ interface ResolvedPoolConfig {
  * Resolved transport entry with defaults applied.
  * @since 0.3.0
  */
-interface ResolvedTransportEntry {
-  readonly transport: Transport;
+interface ResolvedTransportEntry<TProviderId extends string = string> {
+  readonly transport: Transport<TProviderId>;
   readonly weight: number;
   readonly priority: number;
   readonly selector?: TransportSelector;
@@ -196,11 +196,12 @@ interface ResolvedTransportEntry {
  *
  * @since 0.3.0
  */
-declare class PoolTransport implements Transport, AsyncDisposable {
+declare class PoolTransport<TProviderId extends string = string> implements Transport<TProviderId | "pool">, AsyncDisposable {
+  readonly id = "pool";
   /**
    * The resolved configuration used by this pool transport.
    */
-  readonly config: ResolvedPoolConfig;
+  readonly config: ResolvedPoolConfig<TProviderId>;
   private readonly strategy;
   /**
    * Creates a new PoolTransport instance.
@@ -208,7 +209,7 @@ declare class PoolTransport implements Transport, AsyncDisposable {
    * @param config Configuration options for the pool transport.
    * @throws {Error} If the configuration is invalid.
    */
-  constructor(config: PoolConfig);
+  constructor(config: PoolConfig<TProviderId>);
   /**
    * Sends a single email message using the pool strategy.
    *
@@ -220,7 +221,7 @@ declare class PoolTransport implements Transport, AsyncDisposable {
    * @param options Optional transport options including abort signal.
    * @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<TProviderId | "pool">>;
   /**
    * Sends multiple email messages using the pool strategy.
    *
@@ -231,7 +232,7 @@ declare class PoolTransport implements Transport, AsyncDisposable {
    * @param options Optional transport options including abort signal.
    * @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<TProviderId | "pool">>;
   /**
    * Disposes of all underlying transports that support disposal.
    *
@@ -258,7 +259,7 @@ declare class PoolTransport implements Transport, AsyncDisposable {
  * all enabled transports.
  * @since 0.3.0
  */
-declare class RoundRobinStrategy implements Strategy {
+declare class RoundRobinStrategy<TProviderId extends string = string> implements Strategy<TProviderId> {
   private currentIndex;
   /**
    * Selects the next transport in round-robin order.
@@ -270,7 +271,7 @@ declare class RoundRobinStrategy implements Strategy {
    * @returns The selected transport or `undefined` if all transports have been
    *          attempted.
    */
-  select(_message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(_message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets the round-robin counter to start from the beginning.
    */
@@ -287,7 +288,7 @@ declare class RoundRobinStrategy implements Strategy {
  * messages as a transport with weight 1.
  * @since 0.3.0
  */
-declare class WeightedStrategy implements Strategy {
+declare class WeightedStrategy<TProviderId extends string = string> implements Strategy<TProviderId> {
   /**
    * Selects a transport based on weighted random distribution.
    *
@@ -298,7 +299,7 @@ declare class WeightedStrategy implements Strategy {
    * @returns The selected transport or `undefined` if all transports have been
    *          attempted.
    */
-  select(_message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(_message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets the strategy (no-op for weighted strategy as it's stateless).
    */
@@ -315,7 +316,7 @@ declare class WeightedStrategy implements Strategy {
  * equivalent and one is selected randomly.
  * @since 0.3.0
  */
-declare class PriorityStrategy implements Strategy {
+declare class PriorityStrategy<TProviderId extends string = string> implements Strategy<TProviderId> {
   /**
    * Selects the highest priority transport that hasn't been attempted.
    *
@@ -326,7 +327,7 @@ declare class PriorityStrategy implements Strategy {
    * @returns The selected transport or `undefined` if all transports have been
    *          attempted.
    */
-  select(_message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(_message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets the strategy (no-op for priority strategy as it's stateless).
    */
@@ -343,7 +344,7 @@ declare class PriorityStrategy implements Strategy {
  * one is selected randomly.
  * @since 0.3.0
  */
-declare class SelectorStrategy implements Strategy {
+declare class SelectorStrategy<TProviderId extends string = string> implements Strategy<TProviderId> {
   /**
    * Selects a transport based on selector function matching.
    *
@@ -353,7 +354,7 @@ declare class SelectorStrategy implements Strategy {
    *                         attempted.
    * @returns The selected transport or `undefined` if no transport matches.
    */
-  select(message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets the strategy (no-op for selector strategy as it's stateless).
    */

package/dist/index.d.ts

@@ -6,11 +6,11 @@ import { Message, Receipt, Transport, TransportOptions } from "@upyo/core";
  * Result of transport selection by a strategy.
  * @since 0.3.0
  */
-interface TransportSelection {
+interface TransportSelection<TProviderId extends string = string> {
   /**
    * The selected transport entry.
    */
-  readonly entry: ResolvedTransportEntry;
+  readonly entry: ResolvedTransportEntry<TProviderId>;
   /**
    * Index of the selected transport in the original list.
    */
@@ -20,7 +20,7 @@ interface TransportSelection {
  * Base interface for transport selection strategies.
  * @since 0.3.0
  */
-interface Strategy {
+interface Strategy<TProviderId extends string = string> {
   /**
    * Selects a transport for sending a message.
    *
@@ -31,7 +31,7 @@ interface Strategy {
    * @returns The selected transport or `undefined` if no suitable transport is
    *          available.
    */
-  select(message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets any internal state of the strategy.
    */
@@ -53,11 +53,11 @@ type TransportSelector = (message: Message) => boolean;
  * Configuration for a transport entry in the pool.
  * @since 0.3.0
  */
-interface TransportEntry {
+interface TransportEntry<TProviderId extends string = string> {
   /**
    * The transport instance to use.
    */
-  readonly transport: Transport;
+  readonly transport: Transport<TProviderId>;
   /**
    * Weight for weighted distribution strategy.
    * Higher values mean more traffic. Defaults to 1.
@@ -84,16 +84,16 @@ interface TransportEntry {
  * Configuration options for the pool transport.
  * @since 0.3.0
  */
-interface PoolConfig {
+interface PoolConfig<TProviderId extends string = string> {
   /**
    * The strategy to use for selecting transports.
    * Can be a built-in strategy name or a custom Strategy instance.
    */
-  readonly strategy: PoolStrategy | Strategy;
+  readonly strategy: PoolStrategy | Strategy<TProviderId>;
   /**
    * The transports in the pool.
    */
-  readonly transports: readonly TransportEntry[];
+  readonly transports: readonly TransportEntry<TProviderId>[];
   /**
    * Maximum number of retry attempts when a transport fails.
    * Set to 0 to disable retries. Defaults to the number of transports.
@@ -114,9 +114,9 @@ interface PoolConfig {
  * Resolved pool configuration with defaults applied.
  * @since 0.3.0
  */
-interface ResolvedPoolConfig {
-  readonly strategy: PoolStrategy | Strategy;
-  readonly transports: readonly ResolvedTransportEntry[];
+interface ResolvedPoolConfig<TProviderId extends string = string> {
+  readonly strategy: PoolStrategy | Strategy<TProviderId>;
+  readonly transports: readonly ResolvedTransportEntry<TProviderId>[];
   readonly maxRetries: number;
   readonly timeout?: number;
   readonly continueOnSuccess: boolean;
@@ -125,8 +125,8 @@ interface ResolvedPoolConfig {
  * Resolved transport entry with defaults applied.
  * @since 0.3.0
  */
-interface ResolvedTransportEntry {
-  readonly transport: Transport;
+interface ResolvedTransportEntry<TProviderId extends string = string> {
+  readonly transport: Transport<TProviderId>;
   readonly weight: number;
   readonly priority: number;
   readonly selector?: TransportSelector;
@@ -196,11 +196,12 @@ interface ResolvedTransportEntry {
  *
  * @since 0.3.0
  */
-declare class PoolTransport implements Transport, AsyncDisposable {
+declare class PoolTransport<TProviderId extends string = string> implements Transport<TProviderId | "pool">, AsyncDisposable {
+  readonly id = "pool";
   /**
    * The resolved configuration used by this pool transport.
    */
-  readonly config: ResolvedPoolConfig;
+  readonly config: ResolvedPoolConfig<TProviderId>;
   private readonly strategy;
   /**
    * Creates a new PoolTransport instance.
@@ -208,7 +209,7 @@ declare class PoolTransport implements Transport, AsyncDisposable {
    * @param config Configuration options for the pool transport.
    * @throws {Error} If the configuration is invalid.
    */
-  constructor(config: PoolConfig);
+  constructor(config: PoolConfig<TProviderId>);
   /**
    * Sends a single email message using the pool strategy.
    *
@@ -220,7 +221,7 @@ declare class PoolTransport implements Transport, AsyncDisposable {
    * @param options Optional transport options including abort signal.
    * @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<TProviderId | "pool">>;
   /**
    * Sends multiple email messages using the pool strategy.
    *
@@ -231,7 +232,7 @@ declare class PoolTransport implements Transport, AsyncDisposable {
    * @param options Optional transport options including abort signal.
    * @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<TProviderId | "pool">>;
   /**
    * Disposes of all underlying transports that support disposal.
    *
@@ -258,7 +259,7 @@ declare class PoolTransport implements Transport, AsyncDisposable {
  * all enabled transports.
  * @since 0.3.0
  */
-declare class RoundRobinStrategy implements Strategy {
+declare class RoundRobinStrategy<TProviderId extends string = string> implements Strategy<TProviderId> {
   private currentIndex;
   /**
    * Selects the next transport in round-robin order.
@@ -270,7 +271,7 @@ declare class RoundRobinStrategy implements Strategy {
    * @returns The selected transport or `undefined` if all transports have been
    *          attempted.
    */
-  select(_message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(_message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets the round-robin counter to start from the beginning.
    */
@@ -287,7 +288,7 @@ declare class RoundRobinStrategy implements Strategy {
  * messages as a transport with weight 1.
  * @since 0.3.0
  */
-declare class WeightedStrategy implements Strategy {
+declare class WeightedStrategy<TProviderId extends string = string> implements Strategy<TProviderId> {
   /**
    * Selects a transport based on weighted random distribution.
    *
@@ -298,7 +299,7 @@ declare class WeightedStrategy implements Strategy {
    * @returns The selected transport or `undefined` if all transports have been
    *          attempted.
    */
-  select(_message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(_message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets the strategy (no-op for weighted strategy as it's stateless).
    */
@@ -315,7 +316,7 @@ declare class WeightedStrategy implements Strategy {
  * equivalent and one is selected randomly.
  * @since 0.3.0
  */
-declare class PriorityStrategy implements Strategy {
+declare class PriorityStrategy<TProviderId extends string = string> implements Strategy<TProviderId> {
   /**
    * Selects the highest priority transport that hasn't been attempted.
    *
@@ -326,7 +327,7 @@ declare class PriorityStrategy implements Strategy {
    * @returns The selected transport or `undefined` if all transports have been
    *          attempted.
    */
-  select(_message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(_message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets the strategy (no-op for priority strategy as it's stateless).
    */
@@ -343,7 +344,7 @@ declare class PriorityStrategy implements Strategy {
  * one is selected randomly.
  * @since 0.3.0
  */
-declare class SelectorStrategy implements Strategy {
+declare class SelectorStrategy<TProviderId extends string = string> implements Strategy<TProviderId> {
   /**
    * Selects a transport based on selector function matching.
    *
@@ -353,7 +354,7 @@ declare class SelectorStrategy implements Strategy {
    *                         attempted.
    * @returns The selected transport or `undefined` if no transport matches.
    */
-  select(message: Message, transports: readonly ResolvedTransportEntry[], attemptedIndices: Set<number>): TransportSelection | undefined;
+  select(message: Message, transports: readonly ResolvedTransportEntry<TProviderId>[], attemptedIndices: ReadonlySet<number>): TransportSelection<TProviderId> | undefined;
   /**
    * Resets the strategy (no-op for selector strategy as it's stateless).
    */

package/dist/index.js

@@ -1,3 +1,5 @@
+import { createFailedReceipt, createReceiptError } from "@upyo/core";
+
 //#region src/config.ts
 /**
 * Creates a resolved pool configuration with defaults applied.
@@ -272,6 +274,7 @@ var SelectorStrategy = class {
 * @since 0.3.0
 */
 var PoolTransport = class {
+	id = "pool";
 	/**
 	* The resolved configuration used by this pool transport.
 	*/
@@ -300,27 +303,54 @@ var PoolTransport = class {
 	*/
 	async send(message, options) {
 		const attemptedIndices = /* @__PURE__ */ new Set();
+		const errorMessages = [];
 		const errors = [];
 		for (let attempt = 0; attempt < this.config.maxRetries; attempt++) {
 			if (options?.signal?.aborted) throw new DOMException("The operation was aborted.", "AbortError");
 			const selection = this.strategy.select(message, this.config.transports, attemptedIndices);
 			if (!selection) break;
 			attemptedIndices.add(selection.index);
+			let abortedByCaller = false;
 			try {
 				const sendOptions = this.createSendOptions(options);
-				const receipt = await selection.entry.transport.send(message, sendOptions);
+				let receipt;
+				try {
+					receipt = await selection.entry.transport.send(message, sendOptions.options);
+				} catch (error) {
+					if (isAbortError(error) && sendOptions.abortedByCaller()) {
+						abortedByCaller = true;
+						throw error;
+					}
+					throw error;
+				} finally {
+					sendOptions.cleanup();
+				}
 				if (receipt.successful) return receipt;
-				errors.push(...receipt.errorMessages);
+				errorMessages.push(...receipt.errorMessages);
+				errors.push(...getReceiptErrors(receipt, selection.entry.transport.id));
 			} catch (error) {
-				if (error instanceof DOMException && error.name === "AbortError") throw error;
-				const errorMessage = error instanceof Error ? error.message : String(error);
-				errors.push(errorMessage);
+				if (isAbortError(error) && abortedByCaller) throw error;
+				const thrownErrors = getThrownReceiptErrors(error, selection.entry.transport.id);
+				if (thrownErrors.length > 0) {
+					errorMessages.push(...thrownErrors.map((item) => item.message));
+					errors.push(...thrownErrors);
+					continue;
+				}
+				const timeoutMessage = "Transport send timed out.";
+				const errorMessage = isAbortError(error) ? timeoutMessage : error instanceof Error ? error.message : String(error);
+				errorMessages.push(errorMessage);
+				errors.push(createReceiptError(errorMessage, {
+					provider: selection.entry.transport.id,
+					category: isAbortError(error) ? "timeout" : void 0,
+					retryable: isAbortError(error) ? true : void 0
+				}));
 			}
 		}
-		return {
-			successful: false,
-			errorMessages: errors.length > 0 ? errors : ["All transports failed to send the message"]
-		};
+		return createFailedReceipt(errorMessages.length > 0 ? errorMessages : ["All transports failed to send the message."], {
+			provider: "pool",
+			errors: errors.length > 0 ? errors : void 0,
+			attempts: attemptedIndices.size
+		});
 	}
 	/**
 	* Sends multiple email messages using the pool strategy.
@@ -375,22 +405,68 @@ var PoolTransport = class {
 	* Creates send options with timeout if configured.
 	*/
 	createSendOptions(options) {
-		if (!this.config.timeout) return options;
+		if (!this.config.timeout) return {
+			options,
+			abortedByCaller: () => options?.signal?.aborted ?? false,
+			cleanup: () => {}
+		};
 		const controller = new AbortController();
-		const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-		if (options?.signal) options.signal.addEventListener("abort", () => {
-			clearTimeout(timeoutId);
+		let abortSource;
+		const timeoutId = setTimeout(() => {
+			abortSource ??= "timeout";
 			controller.abort();
-		});
+		}, this.config.timeout);
+		let cleanup = () => clearTimeout(timeoutId);
+		if (options?.signal) {
+			const abort = () => {
+				abortSource ??= "caller";
+				clearTimeout(timeoutId);
+				controller.abort();
+			};
+			if (options.signal.aborted) abort();
+			else options.signal.addEventListener("abort", abort, { once: true });
+			cleanup = () => {
+				clearTimeout(timeoutId);
+				options.signal?.removeEventListener("abort", abort);
+			};
+		}
 		controller.signal.addEventListener("abort", () => {
 			clearTimeout(timeoutId);
 		});
 		return {
-			...options,
-			signal: controller.signal
+			options: {
+				...options,
+				signal: controller.signal
+			},
+			abortedByCaller: () => abortSource === "caller",
+			cleanup
 		};
 	}
 };
+function getReceiptErrors(receipt, provider) {
+	if (receipt.errors != null && receipt.errors.length > 0) return receipt.errors.map((error) => error.provider == null ? {
+		...error,
+		provider
+	} : error);
+	return receipt.errorMessages.map((message) => createReceiptError(message, { provider: receipt.provider ?? provider }));
+}
+function getThrownReceiptErrors(error, provider) {
+	if (isReceiptError(error)) return [error.provider == null ? {
+		...error,
+		provider
+	} : error];
+	if (isFailedReceipt(error)) return getReceiptErrors(error, provider);
+	return [];
+}
+function isReceiptError(value) {
+	return typeof value === "object" && value != null && typeof value.message === "string" && typeof value.code === "string" && typeof value.retryable === "boolean" && typeof value.category === "string";
+}
+function isFailedReceipt(value) {
+	return typeof value === "object" && value != null && value.successful === false && Array.isArray(value.errorMessages);
+}
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 
 //#endregion
 export { PoolTransport, PriorityStrategy, RoundRobinStrategy, SelectorStrategy, WeightedStrategy };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@upyo/pool",
-  "version": "0.5.0-dev.136",
+  "version": "0.5.0-dev.156",
   "description": "Pool transport for Upyo email library—provides load balancing and failover for multiple email providers",
   "keywords": [
     "email",
@@ -56,19 +56,14 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@upyo/core": "0.5.0-dev.136+adacf579"
+    "@upyo/core": "0.5.0-dev.156+edad9790"
   },
   "devDependencies": {
-    "@dotenvx/dotenvx": "^1.47.3",
     "tsdown": "^0.12.7",
     "typescript": "5.8.3",
-    "@upyo/mock": "0.5.0-dev.136+adacf579"
+    "@upyo/mock": "0.5.0-dev.156+edad9790"
   },
   "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 --env-file=.env"
+    "prepublish": "mise run --no-deps :build"
   }
 }