bytekit 2.2.0 → 2.4.3

package/dist/utils/async/request-queue.d.ts

@@ -0,0 +1,115 @@
+/**
+ * RequestQueue — Priority-aware, concurrency-limited task queue with AbortSignal cancellation.
+ * Feature: 004-batching-system
+ * Zero external dependencies: AbortController, Map (built-in).
+ */
+/** The three fixed priority lanes for task execution ordering. */
+export type QueuePriority = "high" | "normal" | "low";
+/** Constructor options for {@link RequestQueue}. */
+export interface RequestQueueOptions {
+    /**
+     * Max tasks running simultaneously. Minimum: 1.
+     */
+    concurrency: number;
+    /**
+     * Called when a task rejects. Queue continues executing remaining tasks.
+     * @param error  The rejection reason (cast to Error).
+     * @param id     The task's unique identifier.
+     */
+    onError?: (error: Error, id: string) => void;
+}
+/** Per-task options for {@link RequestQueue.add}. */
+export interface AddOptions {
+    /**
+     * Lane priority. Defaults to `"normal"`.
+     * Tasks in `high` always dequeue before `normal`; `normal` before `low`.
+     */
+    priority?: QueuePriority;
+    /**
+     * External AbortSignal. If it fires before the task starts,
+     * the task is cancelled immediately with {@link QueueAbortError}.
+     * This is the **public consumer cancellation path**.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Thrown when a queued task is cancelled — either via an external AbortSignal
+ * or via the internal `cancel(id)` mechanism.
+ */
+export declare class QueueAbortError extends Error {
+    constructor(message?: string);
+}
+/**
+ * A priority-aware, concurrency-limited task queue with AbortSignal-based cancellation.
+ *
+ * Tasks are organised into three lanes (`high`, `normal`, `low`). At any moment,
+ * at most `concurrency` tasks execute simultaneously. When a slot opens, the
+ * highest-priority queued task is dequeued and started.
+ *
+ * **Consumer cancellation** is done via `AddOptions.signal`.
+ * The `cancel(id)` method is an internal queue-management mechanism.
+ *
+ * @example
+ * ```typescript
+ * const queue = new RequestQueue({ concurrency: 3 });
+ *
+ * const result = await queue.add(
+ *   (signal) => fetch("/api/data", { signal }),
+ *   { priority: "high" }
+ * );
+ * ```
+ */
+export declare class RequestQueue {
+    private readonly _concurrency;
+    private readonly _onError?;
+    private readonly _high;
+    private readonly _normal;
+    private readonly _low;
+    private _running;
+    private readonly _active;
+    private _counter;
+    private _flushWaiters;
+    /**
+     * Creates a new RequestQueue.
+     * @throws {TypeError} if `concurrency` is less than 1.
+     */
+    constructor(options: RequestQueueOptions);
+    /**
+     * Enqueues a task. The task factory receives an internal AbortSignal
+     * that fires when the task is cancelled via `cancel(id)`.
+     *
+     * @returns `Promise<T>` resolving to the task's return value.
+     * @throws {@link QueueAbortError} if cancelled before or during execution.
+     * @throws Whatever the task itself throws.
+     */
+    add<T>(task: (signal: AbortSignal) => Promise<T>, options?: AddOptions): Promise<T>;
+    private _drain;
+    private _notifyFlushWaiters;
+    /**
+     * Cancels a task by ID.
+     * - **Queued task**: removed from its lane; promise rejects with {@link QueueAbortError}.
+     *   Task factory is never called.
+     * - **In-flight task**: internal AbortSignal is fired. The task is responsible
+     *   for reacting to signal abortion and rejecting its promise.
+     *
+     * @returns `true` if the ID was found; `false` otherwise.
+     * @internal Public consumers should use `AddOptions.signal` for cancellation.
+     */
+    cancel(id: string): boolean;
+    /**
+     * Resolves when all currently queued and running tasks have settled.
+     * Tasks added after `flush()` is called are included in the wait.
+     */
+    flush(): Promise<void>;
+    /** @internal Returns IDs of all queued (not yet running) items across all lanes. */
+    _queuedIds(): string[];
+    /** @internal Returns IDs of all currently running items. */
+    _runningIds(): string[];
+    /** Number of tasks waiting to start (across all priority lanes). */
+    get size(): number;
+    /** Number of tasks currently executing. */
+    get running(): number;
+    /** Total active work: `size + running`. */
+    get pending(): number;
+}
+//# sourceMappingURL=request-queue.d.ts.map

package/dist/utils/async/request-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-queue.d.ts","sourceRoot":"","sources":["../../../src/utils/async/request-queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC1B,OAAO,CAAC,EAAE,MAAM;CAI/B;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,aAAa,CAAyB;IAE9C;;;OAGG;gBACS,OAAO,EAAE,mBAAmB;IAQxC;;;;;;;OAOG;IACH,GAAG,CAAC,CAAC,EACD,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACzC,OAAO,CAAC,EAAE,UAAU,GACrB,OAAO,CAAC,CAAC,CAAC;IA2Cb,OAAO,CAAC,MAAM;IAmCd,OAAO,CAAC,mBAAmB;IAO3B;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAoB3B;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,oFAAoF;IACpF,UAAU,IAAI,MAAM,EAAE;IAQtB,4DAA4D;IAC5D,WAAW,IAAI,MAAM,EAAE;IAIvB,oEAAoE;IACpE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,2CAA2C;IAC3C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,2CAA2C;IAC3C,IAAI,OAAO,IAAI,MAAM,CAEpB;CACJ"}

package/dist/utils/async/request-queue.js

@@ -0,0 +1,236 @@
+/**
+ * RequestQueue — Priority-aware, concurrency-limited task queue with AbortSignal cancellation.
+ * Feature: 004-batching-system
+ * Zero external dependencies: AbortController, Map (built-in).
+ */
+/**
+ * Thrown when a queued task is cancelled — either via an external AbortSignal
+ * or via the internal `cancel(id)` mechanism.
+ */
+export class QueueAbortError extends Error {
+    constructor(message) {
+        super(message ?? "Request cancelled");
+        this.name = "QueueAbortError";
+    }
+}
+/**
+ * A priority-aware, concurrency-limited task queue with AbortSignal-based cancellation.
+ *
+ * Tasks are organised into three lanes (`high`, `normal`, `low`). At any moment,
+ * at most `concurrency` tasks execute simultaneously. When a slot opens, the
+ * highest-priority queued task is dequeued and started.
+ *
+ * **Consumer cancellation** is done via `AddOptions.signal`.
+ * The `cancel(id)` method is an internal queue-management mechanism.
+ *
+ * @example
+ * ```typescript
+ * const queue = new RequestQueue({ concurrency: 3 });
+ *
+ * const result = await queue.add(
+ *   (signal) => fetch("/api/data", { signal }),
+ *   { priority: "high" }
+ * );
+ * ```
+ */
+export class RequestQueue {
+    /**
+     * Creates a new RequestQueue.
+     * @throws {TypeError} if `concurrency` is less than 1.
+     */
+    constructor(options) {
+        Object.defineProperty(this, "_concurrency", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_onError", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_high", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "_normal", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "_low", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "_running", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "_active", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "_counter", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "_flushWaiters", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        if (options.concurrency < 1) {
+            throw new TypeError("concurrency must be >= 1");
+        }
+        this._concurrency = options.concurrency;
+        this._onError = options.onError;
+    }
+    /**
+     * Enqueues a task. The task factory receives an internal AbortSignal
+     * that fires when the task is cancelled via `cancel(id)`.
+     *
+     * @returns `Promise<T>` resolving to the task's return value.
+     * @throws {@link QueueAbortError} if cancelled before or during execution.
+     * @throws Whatever the task itself throws.
+     */
+    add(task, options) {
+        const priority = options?.priority ?? "normal";
+        const externalSignal = options?.signal;
+        if (externalSignal?.aborted) {
+            return Promise.reject(new QueueAbortError());
+        }
+        const controller = new AbortController();
+        const id = String(++this._counter);
+        return new Promise((resolve, reject) => {
+            const item = {
+                task,
+                priority,
+                resolve,
+                reject,
+                controller,
+                id,
+            };
+            const lane = priority === "high"
+                ? this._high
+                : priority === "low"
+                    ? this._low
+                    : this._normal;
+            lane.push(item);
+            if (externalSignal) {
+                externalSignal.addEventListener("abort", () => {
+                    this.cancel(id);
+                }, { once: true });
+            }
+            this._drain();
+        });
+    }
+    _drain() {
+        while (this._running < this._concurrency) {
+            const item = this._high.shift() ?? this._normal.shift() ?? this._low.shift();
+            if (!item)
+                break;
+            this._running++;
+            this._active.set(item.id, item);
+            const p = item
+                .task(item.controller.signal)
+                .then((value) => {
+                item.resolve(value);
+            }, (err) => {
+                this._onError?.(err instanceof Error ? err : new Error(String(err)), item.id);
+                item.reject(err);
+            })
+                .finally(() => {
+                this._running--;
+                this._active.delete(item.id);
+                this._drain();
+            });
+            void p;
+        }
+        this._notifyFlushWaiters();
+    }
+    _notifyFlushWaiters() {
+        if (this._running === 0 && this.size === 0) {
+            const waiters = this._flushWaiters.splice(0);
+            for (const w of waiters)
+                w();
+        }
+    }
+    /**
+     * Cancels a task by ID.
+     * - **Queued task**: removed from its lane; promise rejects with {@link QueueAbortError}.
+     *   Task factory is never called.
+     * - **In-flight task**: internal AbortSignal is fired. The task is responsible
+     *   for reacting to signal abortion and rejecting its promise.
+     *
+     * @returns `true` if the ID was found; `false` otherwise.
+     * @internal Public consumers should use `AddOptions.signal` for cancellation.
+     */
+    cancel(id) {
+        for (const lane of [this._high, this._normal, this._low]) {
+            const idx = lane.findIndex((i) => i.id === id);
+            if (idx !== -1) {
+                const [item] = lane.splice(idx, 1);
+                item.reject(new QueueAbortError());
+                this._notifyFlushWaiters();
+                return true;
+            }
+        }
+        const active = this._active.get(id);
+        if (active) {
+            active.controller.abort();
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Resolves when all currently queued and running tasks have settled.
+     * Tasks added after `flush()` is called are included in the wait.
+     */
+    flush() {
+        if (this._running === 0 && this.size === 0) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this._flushWaiters.push(resolve);
+        });
+    }
+    /** @internal Returns IDs of all queued (not yet running) items across all lanes. */
+    _queuedIds() {
+        return [
+            ...this._high.map((i) => i.id),
+            ...this._normal.map((i) => i.id),
+            ...this._low.map((i) => i.id),
+        ];
+    }
+    /** @internal Returns IDs of all currently running items. */
+    _runningIds() {
+        return [...this._active.keys()];
+    }
+    /** Number of tasks waiting to start (across all priority lanes). */
+    get size() {
+        return this._high.length + this._normal.length + this._low.length;
+    }
+    /** Number of tasks currently executing. */
+    get running() {
+        return this._running;
+    }
+    /** Total active work: `size + running`. */
+    get pending() {
+        return this.size + this._running;
+    }
+}
+//# sourceMappingURL=request-queue.js.map

package/dist/utils/async/request-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-queue.js","sourceRoot":"","sources":["../../../src/utils/async/request-queue.ts"],"names":[],"mappings":"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"}

package/dist/utils/async/throttle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/utils/async/throttle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,aAAa,EACb,eAAe,EACf,iBAAiB,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EACtD,EAAE,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC9B,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAkHnC"}
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/utils/async/throttle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,aAAa,EACb,eAAe,EACf,iBAAiB,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EACtD,EAAE,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,eAAoB,GAC9B,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAmHnC"}

package/dist/utils/async/throttle.js

@@ -44,6 +44,7 @@ export function throttleAsync(fn, interval, options = {}) {
      * Executes the pending call if one exists
      */
     const executePending = async () => {
+        /* v8 ignore next 2 — defensive guard against double-dispatch (unreachable via public API) */
         if (pendingArgs === null)
             return;
         const args = pendingArgs;

package/dist/utils/async/throttle.js.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/utils/async/throttle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/utils/async/throttle.ts"],"names":[],"mappings":"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"}

package/dist/utils/core/ApiClient.d.ts

@@ -2,6 +2,9 @@ import { Logger } from "#core/Logger.js";
 import { RetryConfig, CircuitBreakerConfig } from "#core/RetryPolicy.js";
 import { ValidationSchema } from "#core/ResponseValidator.js";
 import { SchemaAdapter } from "./SchemaAdapter.js";
+import { PromisePoolOptions } from "../async/promise-pool.js";
+import { RequestQueueOptions } from "../async/request-queue.js";
+import { BatchOptions } from "../async/request-batcher.js";
 export type QueryParamValue = string | number | boolean | null | undefined;
 export type QueryParam = QueryParamValue | QueryParamValue[] | Record<string, unknown>;
 export type Locale = "en" | "es";
@@ -24,6 +27,12 @@ export interface ApiClientConfig {
     logger?: Logger;
     retryPolicy?: RetryConfig;
     circuitBreaker?: CircuitBreakerConfig;
+    /** Optional pool for limiting concurrent requests. */
+    pool?: PromisePoolOptions;
+    /** Optional request queue for concurrency-limited, priority-aware request execution. */
+    queue?: RequestQueueOptions;
+    /** Optional request batcher for time-window deduplication of identical requests. */
+    batch?: BatchOptions;
 }
 export type RequestBody = Record<string, unknown> | unknown[] | string | FormData | Blob | BufferSource;
 export interface RequestOptions<TResponse = unknown> extends Omit<RequestInit, "body"> {
@@ -32,6 +41,14 @@ export interface RequestOptions<TResponse = unknown> extends Omit<RequestInit, "
     errorLocale?: Locale;
     timeoutMs?: number;
     validateResponse?: ValidationSchema | SchemaAdapter<TResponse>;
+    /**
+     * Optional post-processing pipeline applied to the response body after parsing
+     * and validation. Applied after `validateResponse` (if present) has already run.
+     * If `pipeline.process()` throws, the error propagates as a request error.
+     */
+    pipeline?: {
+        process(data: TResponse): Promise<unknown>;
+    };
     skipRetry?: boolean;
     skipInterceptors?: boolean;
     logHeaders?: boolean;
@@ -109,6 +126,9 @@ export declare class ApiClient {
     private readonly errorMessages;
     private readonly retryPolicy;
     private readonly circuitBreaker;
+    private readonly pool?;
+    private readonly _queue?;
+    private readonly _batcher?;
     /**
      * Creates a new ApiClient instance.
      *
@@ -123,7 +143,7 @@ export declare class ApiClient {
      *
      * @param config Client configuration including baseUrl, headers, and policies.
      */
-    constructor({ baseUrl, baseURL, defaultHeaders, fetchImpl, locale, errorMessages, timeoutMs, interceptors, disableInterceptors, logHeaders, redactHeaderKeys, logger, retryPolicy, circuitBreaker, }: ApiClientConfig);
+    constructor({ baseUrl, baseURL, defaultHeaders, fetchImpl, locale, errorMessages, timeoutMs, interceptors, disableInterceptors, logHeaders, redactHeaderKeys, logger, retryPolicy, circuitBreaker, pool, queue, batch, }: ApiClientConfig);
     get<T>(path: string | URL, options?: RequestOptions<T>): Promise<T>;
     /**
      * POST request - Acepta body directamente o RequestOptions
@@ -177,6 +197,7 @@ export declare class ApiClient {
      */
     private handleRequestError;
     request<T>(path: string | URL, options?: RequestOptions<T>): Promise<T>;
+    private executeRequest;
     /**
      * Normaliza el segundo parámetro de post/put/patch para soportar:
      * 1. Body directo: post("/path", { name: "John" })

package/dist/utils/core/ApiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiClient.d.ts","sourceRoot":"","sources":["../../../src/utils/core/ApiClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ApiClient.d.ts","sourceRoot":"","sources":["../../../src/utils/core/ApiClient.ts"],"names":[],"mappings":"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"}

package/dist/utils/core/ApiClient.js

@@ -3,6 +3,9 @@ import { retry as retryFn } from "../async/retry.js";
 import { RetryPolicy, CircuitBreaker, } from "#core/RetryPolicy.js";
 import { ResponseValidator, } from "#core/ResponseValidator.js";
 import { isSchemaAdapter } from "./SchemaAdapter.js";
+import { PromisePool } from "../async/promise-pool.js";
+import { RequestQueue } from "../async/request-queue.js";
+import { RequestBatcher } from "../async/request-batcher.js";
 export class ApiError extends Error {
     constructor(status, statusText, message, body, isTimeout = false) {
         super(message);
@@ -64,6 +67,7 @@ export class ApiError extends Error {
                 parts.push(`Body: ${bodyStr}`);
             }
             catch {
+                /* v8 ignore next */
                 parts.push(`Body: ${this.body}`);
             }
         }
@@ -127,7 +131,7 @@ export class ApiClient {
      *
      * @param config Client configuration including baseUrl, headers, and policies.
      */
-    constructor({ baseUrl, baseURL, defaultHeaders, fetchImpl, locale = "es", errorMessages, timeoutMs = 15000, interceptors, disableInterceptors = false, logHeaders = false, redactHeaderKeys, logger, retryPolicy, circuitBreaker, }) {
+    constructor({ baseUrl, baseURL, defaultHeaders, fetchImpl, locale = "es", errorMessages, timeoutMs = 15000, interceptors, disableInterceptors = false, logHeaders = false, redactHeaderKeys, logger, retryPolicy, circuitBreaker, pool, queue, batch, }) {
         Object.defineProperty(this, "baseUrl", {
             enumerable: true,
             configurable: true,
@@ -206,6 +210,24 @@ export class ApiClient {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "pool", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_queue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "_batcher", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         // Support both baseUrl and baseURL (common convention)
         const url = baseUrl ?? baseURL;
         if (!url) {
@@ -231,6 +253,9 @@ export class ApiClient {
         this.logger = logger;
         this.retryPolicy = new RetryPolicy(retryPolicy);
         this.circuitBreaker = new CircuitBreaker(circuitBreaker);
+        this.pool = pool ? new PromisePool(pool) : undefined;
+        this._queue = queue ? new RequestQueue(queue) : undefined;
+        this._batcher = batch ? new RequestBatcher(batch) : undefined;
     }
     // -------------------------
     // Core request shortcuts
@@ -400,9 +425,11 @@ export class ApiClient {
      */
     handleRequestError(err, path, method) {
         const pathStr = String(path);
+        /* v8 ignore start */
         if (err instanceof Error && err.name === "AbortError") {
             throw new ApiError(408, "Timeout", "Request timeout", null, true);
         }
+        /* v8 ignore end */
         // Enhanced logging for ApiError
         if (err instanceof ApiError) {
             this.logger?.error("API Request failed", {
@@ -414,12 +441,34 @@ export class ApiClient {
             }, err);
         }
         else {
+            /* v8 ignore next 6 */
             this.logger?.error("Request failed", { path: pathStr, method }, err instanceof Error ? err : new Error(String(err)));
         }
         throw err;
     }
     async request(path, options = {}) {
-        const { validateResponse, skipRetry, skipInterceptors, logHeaders, ...requestOptions } = options;
+        // US4: RequestQueue — concurrency-limited, priority-aware queue
+        if (this._queue) {
+            return this._queue.add((_signal) => this.executeRequest(path, options));
+        }
+        // US4: RequestBatcher — time-window deduplication
+        if (this._batcher) {
+            const pathStr = String(path);
+            const method = (options.method ?? "GET").toUpperCase();
+            const proxyInit = { method };
+            return this._batcher.add(pathStr, proxyInit, (_url, _init) => this.executeRequest(path, options));
+        }
+        // T026: legacy pool support (003) — if a pool is configured, route through it
+        if (this.pool) {
+            const results = await this.pool.run([
+                () => this.executeRequest(path, options),
+            ]);
+            return results[0];
+        }
+        return this.executeRequest(path, options);
+    }
+    async executeRequest(path, options = {}) {
+        const { validateResponse, pipeline, skipRetry, skipInterceptors, logHeaders, ...requestOptions } = options;
         const executeRequest = async () => {
             return this.circuitBreaker.execute(async () => {
                 const { errorLocale, ...rest } = requestOptions;
@@ -430,12 +479,14 @@ export class ApiClient {
                 const headersForLog = shouldLogHeaders
                     ? this.redactHeaders(this.normalizeHeaders(init.headers))
                     : undefined;
+                /* v8 ignore start */
                 this.logger?.debug("HTTP Request", {
                     method: rest.method,
                     url,
                     ...(shouldLogHeaders ? { headers: headersForLog } : {}),
                     body: rest.body,
                 });
+                /* v8 ignore end */
                 try {
                     const response = await this.withTimeout(this.fetchImpl(url, init), timeout, controller);
                     // Response interceptor
@@ -449,7 +500,11 @@ export class ApiClient {
                         throw await this.toApiError(finalResponse, errorLocale);
                     }
                     // Process response
-                    const data = await this.processResponse(finalResponse, validateResponse);
+                    let data = await this.processResponse(finalResponse, validateResponse);
+                    // Apply optional pipeline post-processing
+                    if (pipeline) {
+                        data = await pipeline.process(data);
+                    }
                     this.logger?.debug("HTTP Response", {
                         status: finalResponse.status,
                         url,
@@ -472,7 +527,11 @@ export class ApiClient {
             baseDelay: config.initialDelayMs,
             maxDelay: config.maxDelayMs,
             backoff: "exponential",
-            shouldRetry: (err) => config.shouldRetry?.(err instanceof Error ? err : new Error(String(err)), 0) ?? false,
+            shouldRetry: (err) => 
+            /* v8 ignore next */
+            config.shouldRetry?.(err instanceof Error ? err : new Error(String(err)), 0
+            /* v8 ignore next */
+            ) ?? false,
         });
     }
     // -------------------------
@@ -626,6 +685,7 @@ export class ApiClient {
             if (dict[status])
                 return dict[status];
         }
+        /* v8 ignore next */
         return (GENERIC_ERROR_MESSAGE[this.locale] ?? GENERIC_ERROR_MESSAGE.es)(status, statusText);
     }
     getLocalePreference(override) {