snapreq 0.0.9 → 0.0.11

package/build/retry.js

@@ -1,5 +1,6 @@
 // @ts-check
-import { SnapReqHttpError, SnapReqTimeoutError } from "./errors.js";
+import { SnapReqTimeoutError } from "./errors.js";
+import retry from "awaitery/build/retry.js";
 const RETRYABLE_ERROR_CODES = new Set(["ECONNREFUSED", "ECONNRESET", "EHOSTUNREACH", "ENOENT", "ETIMEDOUT", "EPIPE"]);
 const DEFAULT_RETRYABLE_STATUSES = [502, 503, 504];
 /**
@@ -51,45 +52,50 @@ export function normalizeRetryOptions(retry) {
         shouldRetry
     };
 }
-/**
- * @param {number} waitMs - Delay in milliseconds.
- * @returns {Promise<void>} - Resolves after the delay.
- */
-function wait(waitMs) {
-    return new Promise((resolve) => setTimeout(resolve, waitMs));
+class RetryableResponse extends Error {
+    /** @param {import("./response.js").default} response - Retryable response. */
+    constructor(response) {
+        super(`Retryable HTTP status ${response.status}`);
+        this.response = response;
+    }
 }
 /**
  * Runs a request attempt, retrying transient network errors and retryable HTTP
  * statuses. Retries are only used for buffered requests — the caller must not
  * apply this to streamed responses.
- * @param {() => Promise<import("./response.js").default>} attempt - Performs one request attempt.
- * @param {NormalizedRetryOptions} retry - Normalized retry settings.
+ * @param {(signal: AbortSignal | undefined) => Promise<import("./response.js").default>} attempt - Performs one request attempt.
+ * @param {NormalizedRetryOptions} retryOptions - Normalized retry settings.
+ * @param {AbortSignal} [signal] - Caller cancellation signal.
  * @returns {Promise<import("./response.js").default>} - The successful (or final) response.
  */
-export async function runWithRetry(attempt, retry) {
-    for (let tryNumber = 1; tryNumber <= retry.tries; tryNumber += 1) {
-        /** @type {import("./response.js").default} */
-        let response;
-        try {
-            response = await attempt();
-        }
-        catch (error) {
-            if (tryNumber >= retry.tries || !retry.shouldRetry(error, tryNumber))
-                throw error;
-            await wait(retry.waitMs);
-            continue;
-        }
-        if (tryNumber < retry.tries && retry.retryableStatuses.includes(response.status)) {
-            await wait(retry.waitMs);
-            continue;
-        }
-        return response;
+export async function runWithRetry(attempt, retryOptions, signal) {
+    try {
+        return await retry({
+            tries: retryOptions.tries,
+            wait: retryOptions.waitMs,
+            signal,
+            shouldRetry: ({ error, tryNumber }) => {
+                if (error instanceof RetryableResponse) {
+                    // Awaitery calls shouldRetry only when another attempt is available,
+                    // and before its retry delay. The final response therefore remains
+                    // caller-owned while every intermediate body is released promptly.
+                    error.response._abortBody(error);
+                    return true;
+                }
+                return retryOptions.shouldRetry(error, tryNumber);
+            }
+        }, async ({ signal: attemptSignal } = /** @type {any} */ ({})) => {
+            const response = await attempt(attemptSignal);
+            if (retryOptions.retryableStatuses.includes(response.status)) {
+                throw new RetryableResponse(response);
+            }
+            return response;
+        });
+    }
+    catch (error) {
+        if (error instanceof RetryableResponse)
+            return error.response;
+        throw error;
     }
-    throw new SnapReqHttpError({
-        message: "Retry loop exited without a response.",
-        method: "",
-        url: "",
-        status: 0
-    });
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmV0cnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcmV0cnkuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sRUFBQyxnQkFBZ0IsRUFBRSxtQkFBbUIsRUFBQyxNQUFNLGFBQWEsQ0FBQTtBQUVqRSxNQUFNLHFCQUFxQixHQUFHLElBQUksR0FBRyxDQUFDLENBQUMsY0FBYyxFQUFFLFlBQVksRUFBRSxjQUFjLEVBQUUsUUFBUSxFQUFFLFdBQVcsRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFBO0FBQ3JILE1BQU0sMEJBQTBCLEdBQUcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsQ0FBQyxDQUFBO0FBRWxEOzs7Ozs7R0FNRztBQUVIOzs7Ozs7R0FNRztBQUVIOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQixDQUFDLEtBQUs7SUFDekMsSUFBSSxLQUFLLFlBQVksbUJBQW1CO1FBQUUsT0FBTyxJQUFJLENBQUE7SUFFckQsSUFBSSxDQUFDLEtBQUssSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRO1FBQUUsT0FBTyxLQUFLLENBQUE7SUFFckQsSUFBSSxNQUFNLElBQUksS0FBSyxJQUFJLE9BQU8sS0FBSyxDQUFDLElBQUksS0FBSyxRQUFRLElBQUkscUJBQXFCLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO1FBQy9GLE9BQU8sSUFBSSxDQUFBO0lBQ2IsQ0FBQztJQUVELE9BQU8sS0FBSyxZQUFZLEtBQUssSUFBSSxLQUFLLENBQUMsT0FBTyxLQUFLLGdCQUFnQixDQUFBO0FBQ3JFLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSxxQkFBcUIsQ0FBQyxLQUFLO0lBQ3pDLElBQUksQ0FBQyxLQUFLO1FBQUUsT0FBTyxJQUFJLENBQUE7SUFFdkIsTUFBTSxPQUFPLEdBQUcsS0FBSyxLQUFLLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUE7SUFDM0MsTUFBTSxpQkFBaUIsR0FBRyxPQUFPLENBQUMsaUJBQWlCLElBQUksMEJBQTBCLENBQUE7SUFDakYsTUFBTSxXQUFXLEdBQUcsT0FBTyxDQUFDLFdBQVcsSUFBSSxDQUFDLENBQUMsc0JBQXNCLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxxQkFBcUIsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFBO0lBRTNHLE9BQU87UUFDTCxLQUFLLEVBQUUsT0FBTyxDQUFDLEtBQUssSUFBSSxDQUFDO1FBQ3pCLE1BQU0sRUFBRSxPQUFPLENBQUMsTUFBTSxJQUFJLEdBQUc7UUFDN0IsaUJBQWlCO1FBQ2pCLFdBQVc7S0FDWixDQUFBO0FBQ0gsQ0FBQztBQUVEOzs7R0FHRztBQUNILFNBQVMsSUFBSSxDQUFDLE1BQU07SUFDbEIsT0FBTyxJQUFJLE9BQU8sQ0FBQyxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFBO0FBQzlELENBQUM7QUFFRDs7Ozs7OztHQU9HO0FBQ0gsTUFBTSxDQUFDLEtBQUssVUFBVSxZQUFZLENBQUMsT0FBTyxFQUFFLEtBQUs7SUFDL0MsS0FBSyxJQUFJLFNBQVMsR0FBRyxDQUFDLEVBQUUsU0FBUyxJQUFJLEtBQUssQ0FBQyxLQUFLLEVBQUUsU0FBUyxJQUFJLENBQUMsRUFBRSxDQUFDO1FBQ2pFLDhDQUE4QztRQUM5QyxJQUFJLFFBQVEsQ0FBQTtRQUVaLElBQUksQ0FBQztZQUNILFFBQVEsR0FBRyxNQUFNLE9BQU8sRUFBRSxDQUFBO1FBQzVCLENBQUM7UUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1lBQ2YsSUFBSSxTQUFTLElBQUksS0FBSyxDQUFDLEtBQUssSUFBSSxDQUFDLEtBQUssQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLFNBQVMsQ0FBQztnQkFBRSxNQUFNLEtBQUssQ0FBQTtZQUVqRixNQUFNLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUE7WUFDeEIsU0FBUTtRQUNWLENBQUM7UUFFRCxJQUFJLFNBQVMsR0FBRyxLQUFLLENBQUMsS0FBSyxJQUFJLEtBQUssQ0FBQyxpQkFBaUIsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7WUFDakYsTUFBTSxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxDQUFBO1lBQ3hCLFNBQVE7UUFDVixDQUFDO1FBRUQsT0FBTyxRQUFRLENBQUE7SUFDakIsQ0FBQztJQUVELE1BQU0sSUFBSSxnQkFBZ0IsQ0FBQztRQUN6QixPQUFPLEVBQUUsdUNBQXVDO1FBQ2hELE1BQU0sRUFBRSxFQUFFO1FBQ1YsR0FBRyxFQUFFLEVBQUU7UUFDUCxNQUFNLEVBQUUsQ0FBQztLQUNWLENBQUMsQ0FBQTtBQUNKLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmV0cnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvcmV0cnkuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sRUFBQyxtQkFBbUIsRUFBQyxNQUFNLGFBQWEsQ0FBQTtBQUMvQyxPQUFPLEtBQUssTUFBTSx5QkFBeUIsQ0FBQTtBQUUzQyxNQUFNLHFCQUFxQixHQUFHLElBQUksR0FBRyxDQUFDLENBQUMsY0FBYyxFQUFFLFlBQVksRUFBRSxjQUFjLEVBQUUsUUFBUSxFQUFFLFdBQVcsRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFBO0FBQ3JILE1BQU0sMEJBQTBCLEdBQUcsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEdBQUcsQ0FBQyxDQUFBO0FBRWxEOzs7Ozs7R0FNRztBQUVIOzs7Ozs7R0FNRztBQUVIOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQixDQUFDLEtBQUs7SUFDekMsSUFBSSxLQUFLLFlBQVksbUJBQW1CO1FBQUUsT0FBTyxJQUFJLENBQUE7SUFFckQsSUFBSSxDQUFDLEtBQUssSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRO1FBQUUsT0FBTyxLQUFLLENBQUE7SUFFckQsSUFBSSxNQUFNLElBQUksS0FBSyxJQUFJLE9BQU8sS0FBSyxDQUFDLElBQUksS0FBSyxRQUFRLElBQUkscUJBQXFCLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO1FBQy9GLE9BQU8sSUFBSSxDQUFBO0lBQ2IsQ0FBQztJQUVELE9BQU8sS0FBSyxZQUFZLEtBQUssSUFBSSxLQUFLLENBQUMsT0FBTyxLQUFLLGdCQUFnQixDQUFBO0FBQ3JFLENBQUM7QUFFRDs7Ozs7R0FLRztBQUNILE1BQU0sVUFBVSxxQkFBcUIsQ0FBQyxLQUFLO0lBQ3pDLElBQUksQ0FBQyxLQUFLO1FBQUUsT0FBTyxJQUFJLENBQUE7SUFFdkIsTUFBTSxPQUFPLEdBQUcsS0FBSyxLQUFLLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUE7SUFDM0MsTUFBTSxpQkFBaUIsR0FBRyxPQUFPLENBQUMsaUJBQWlCLElBQUksMEJBQTBCLENBQUE7SUFDakYsTUFBTSxXQUFXLEdBQUcsT0FBTyxDQUFDLFdBQVcsSUFBSSxDQUFDLENBQUMsc0JBQXNCLENBQUMsS0FBSyxFQUFFLEVBQUUsQ0FBQyxxQkFBcUIsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFBO0lBRTNHLE9BQU87UUFDTCxLQUFLLEVBQUUsT0FBTyxDQUFDLEtBQUssSUFBSSxDQUFDO1FBQ3pCLE1BQU0sRUFBRSxPQUFPLENBQUMsTUFBTSxJQUFJLEdBQUc7UUFDN0IsaUJBQWlCO1FBQ2pCLFdBQVc7S0FDWixDQUFBO0FBQ0gsQ0FBQztBQUVELE1BQU0saUJBQWtCLFNBQVEsS0FBSztJQUNuQyw4RUFBOEU7SUFDOUUsWUFBWSxRQUFRO1FBQ2xCLEtBQUssQ0FBQyx5QkFBeUIsUUFBUSxDQUFDLE1BQU0sRUFBRSxDQUFDLENBQUE7UUFDakQsSUFBSSxDQUFDLFFBQVEsR0FBRyxRQUFRLENBQUE7SUFDMUIsQ0FBQztDQUNGO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLFlBQVksQ0FBQyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU07SUFDOUQsSUFBSSxDQUFDO1FBQ0gsT0FBTyxNQUFNLEtBQUssQ0FBQztZQUNqQixLQUFLLEVBQUUsWUFBWSxDQUFDLEtBQUs7WUFDekIsSUFBSSxFQUFFLFlBQVksQ0FBQyxNQUFNO1lBQ3pCLE1BQU07WUFDTixXQUFXLEVBQUUsQ0FBQyxFQUFDLEtBQUssRUFBRSxTQUFTLEVBQUMsRUFBRSxFQUFFO2dCQUNsQyxJQUFJLEtBQUssWUFBWSxpQkFBaUIsRUFBRSxDQUFDO29CQUN2QyxxRUFBcUU7b0JBQ3JFLG1FQUFtRTtvQkFDbkUsbUVBQW1FO29CQUNuRSxLQUFLLENBQUMsUUFBUSxDQUFDLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQTtvQkFDaEMsT0FBTyxJQUFJLENBQUE7Z0JBQ2IsQ0FBQztnQkFFRCxPQUFPLFlBQVksQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLFNBQVMsQ0FBQyxDQUFBO1lBQ25ELENBQUM7U0FDRixFQUFFLEtBQUssRUFBRSxFQUFDLE1BQU0sRUFBRSxhQUFhLEVBQUMsR0FBRyxrQkFBa0IsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUU7WUFDN0QsTUFBTSxRQUFRLEdBQUcsTUFBTSxPQUFPLENBQUMsYUFBYSxDQUFDLENBQUE7WUFFN0MsSUFBSSxZQUFZLENBQUMsaUJBQWlCLENBQUMsUUFBUSxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO2dCQUM3RCxNQUFNLElBQUksaUJBQWlCLENBQUMsUUFBUSxDQUFDLENBQUE7WUFDdkMsQ0FBQztZQUVELE9BQU8sUUFBUSxDQUFBO1FBQ2pCLENBQUMsQ0FBQyxDQUFBO0lBQ0osQ0FBQztJQUFDLE9BQU8sS0FBSyxFQUFFLENBQUM7UUFDZixJQUFJLEtBQUssWUFBWSxpQkFBaUI7WUFBRSxPQUFPLEtBQUssQ0FBQyxRQUFRLENBQUE7UUFFN0QsTUFBTSxLQUFLLENBQUE7SUFDYixDQUFDO0FBQ0gsQ0FBQyJ9

package/build/snap-req.d.ts

@@ -1,3 +1,90 @@
+import { SnapReqHttpError } from "./errors.js";
+import SnapReqHeaders from "./headers.js";
+export type CompressionEncoding = import("./request.js").CompressionEncoding;
+export type NormalizedRequest = {
+    /**
+     * - Upper-cased HTTP method.
+     */
+    method: string;
+    /**
+     * - Fully resolved request URL.
+     */
+    url: string;
+    /**
+     * - Request headers.
+     */
+    headers: SnapReqHeaders;
+    /**
+     * - Normalized request body.
+     */
+    body: import("./request.js").NormalizedBody;
+    /**
+     * - Request body compression.
+     */
+    bodyCompression: CompressionEncoding;
+    /**
+     * - Abort signal.
+     */
+    signal?: AbortSignal;
+    /**
+     * - Request timeout in milliseconds.
+     */
+    timeoutMs?: number;
+    /**
+     * - Fetch credentials mode ("omit" | "same-origin" | "include").
+     */
+    credentials?: string;
+};
+export type RequestOptions = {
+    /**
+     * - HTTP method. Defaults to GET.
+     */
+    method?: string;
+    /**
+     * - Request path (joined with the client `baseUrl`) or absolute URL.
+     */
+    path?: string;
+    /**
+     * - Alias for `path`.
+     */
+    url?: string;
+    /**
+     * - Query parameters.
+     */
+    query?: Record<string, string | number | boolean | null | undefined>;
+    /**
+     * - Per-request headers.
+     */
+    headers?: Record<string, string | number> | SnapReqHeaders;
+    /**
+     * - Request body: string, object (JSON), Uint8Array/ArrayBuffer, or a stream/async-iterable.
+     */
+    body?: any;
+    /**
+     * - Compress the request body (Node transport only).
+     */
+    bodyCompression?: CompressionEncoding;
+    /**
+     * - Abort signal for the request.
+     */
+    signal?: AbortSignal;
+    /**
+     * - Request timeout in milliseconds. Set to `0` to disable a client default.
+     */
+    timeoutMs?: number;
+    /**
+     * - Fetch credentials mode.
+     */
+    credentials?: string;
+    /**
+     * - Retry transient failures.
+     */
+    retry?: boolean | import("./retry.js").RetryOptions;
+    /**
+     * - Throw `SnapReqHttpError` on non-2xx responses.
+     */
+    throwOnError?: boolean;
+};
 /**
  * @typedef {import("./request.js").CompressionEncoding} CompressionEncoding
  */
@@ -27,13 +114,6 @@
  * @property {boolean | import("./retry.js").RetryOptions} [retry] - Retry transient failures.
  * @property {boolean} [throwOnError] - Throw `SnapReqHttpError` on non-2xx responses.
  */
-/**
- * @typedef {object} RequestTimeout
- * @property {AbortSignal | undefined} signal - Signal to use for the request.
- * @property {() => void} clear - Clears timeout resources.
- * @property {(response: import("./response.js").default, request: NormalizedRequest) => import("./response.js").default} response - Attaches timeout handling to a response.
- * @property {(error: unknown, request: NormalizedRequest) => unknown} error - Maps a thrown error.
- */
 /**
  * A cross-platform HTTP client with one API across Node, web, Expo and React
  * Native. The right transport is chosen at runtime; features a platform cannot
@@ -41,6 +121,27 @@
  * behaviour.
  */
 export default class SnapReq {
+    baseUrl: string;
+    defaultHeaders: Record<string, string | number> | (() => Record<string, string | number>);
+    defaultRetry: boolean | import("./retry.js").RetryOptions;
+    throwOnError: boolean;
+    timeoutMs: number;
+    credentials: string;
+    _transportPreference: import("./transports/select.js").Transport | import("./transports/select.js").TransportName;
+    _nodeConfig: {
+        socketPath: string;
+        tls: {
+            ca?: string | Buffer;
+            cert?: string | Buffer;
+            key?: string | Buffer;
+            rejectUnauthorized?: boolean;
+        };
+        keepAlive: boolean;
+    };
+    /** @type {Promise<import("./transports/select.js").Transport> | null} */
+    _transportPromise: Promise<import("./transports/select.js").Transport> | null;
+    /** @type {import("./transports/select.js").Transport | null} */
+    _transport: import("./transports/select.js").Transport | null;
     /**
      * @param {object} [config] - Client configuration.
      * @param {string} [config.baseUrl] - Origin (and optional base path) prepended to relative paths.
@@ -71,27 +172,6 @@ export default class SnapReq {
         credentials?: string;
         transport?: import("./transports/select.js").TransportName | import("./transports/select.js").Transport;
     });
-    baseUrl: string;
-    defaultHeaders: Record<string, string | number> | (() => Record<string, string | number>);
-    defaultRetry: boolean | import("./retry.js").RetryOptions;
-    throwOnError: boolean;
-    timeoutMs: number;
-    credentials: string;
-    _transportPreference: import("./transports/select.js").TransportName | import("./transports/select.js").Transport;
-    _nodeConfig: {
-        socketPath: string;
-        tls: {
-            ca?: string | Buffer;
-            cert?: string | Buffer;
-            key?: string | Buffer;
-            rejectUnauthorized?: boolean;
-        };
-        keepAlive: boolean;
-    };
-    /** @type {Promise<import("./transports/select.js").Transport> | null} */
-    _transportPromise: Promise<import("./transports/select.js").Transport> | null;
-    /** @type {import("./transports/select.js").Transport | null} */
-    _transport: import("./transports/select.js").Transport | null;
     /** @returns {Promise<import("./transports/select.js").Transport>} - The resolved transport. */
     _resolveTransport(): Promise<import("./transports/select.js").Transport>;
     /** @returns {Promise<import("./capabilities.js").TransportCapabilities>} - The active transport's capabilities. */
@@ -103,32 +183,12 @@ export default class SnapReq {
      * @returns {NormalizedRequest} - The normalized request.
      */
     _normalize(options: RequestOptions): NormalizedRequest;
-    /**
-     * @param {RequestOptions} options - Request options.
-     * @returns {RequestTimeout} - Timeout handling for one request attempt.
-     */
-    _requestTimeout(options: RequestOptions): RequestTimeout;
-    /**
-     * @param {AbortSignal | undefined} callerSignal - Caller-supplied signal.
-     * @param {AbortSignal} timeoutSignal - Timeout signal.
-     * @returns {{signal: AbortSignal, clear: () => void}} - Signal that aborts when either source aborts.
-     */
-    _composeSignal(callerSignal: AbortSignal | undefined, timeoutSignal: AbortSignal): {
-        signal: AbortSignal;
-        clear: () => void;
-    };
     /**
      * @param {(() => void) | undefined} existing - Existing body-done callback.
      * @param {() => void} next - Callback to add.
      * @returns {() => void} - Combined callback.
      */
     _chainBodyDone(existing: (() => void) | undefined, next: () => void): () => void;
-    /**
-     * @param {((error: unknown) => unknown) | undefined} existing - Existing error mapper.
-     * @param {(error: unknown) => unknown} next - Mapper to add.
-     * @returns {(error: unknown) => unknown} - Combined mapper.
-     */
-    _chainBodyError(existing: ((error: unknown) => unknown) | undefined, next: (error: unknown) => unknown): (error: unknown) => unknown;
     /**
      * Performs a request and buffers nothing eagerly — read the body via the
      * returned response (`json()`, `text()`, `bytes()`). Retries transient
@@ -151,6 +211,14 @@ export default class SnapReq {
      * @returns {Promise<import("./response.js").default>} - Response with timeout handling attached.
      */
     _requestWithTimeout(options: RequestOptions, performRequest: (request: NormalizedRequest) => Promise<import("./response.js").default>): Promise<import("./response.js").default>;
+    /**
+     * @param {unknown} error - Awaitery/transport error.
+     * @param {NormalizedRequest} request - Request metadata.
+     * @param {number | undefined} timeoutMs - Attempt timeout.
+     * @param {AbortSignal | undefined} callerSignal - Caller cancellation.
+     * @returns {unknown} - Stable public Snapreq error.
+     */
+    _requestControlError(error: unknown, request: NormalizedRequest, timeoutMs: number | undefined, callerSignal: AbortSignal | undefined): unknown;
     /**
      * @param {string} path - Request path or absolute URL.
      * @param {RequestOptions} [options] - Request options.
@@ -196,109 +264,4 @@ export default class SnapReq {
      */
     close(): void;
 }
-export type CompressionEncoding = import("./request.js").CompressionEncoding;
-export type NormalizedRequest = {
-    /**
-     * - Upper-cased HTTP method.
-     */
-    method: string;
-    /**
-     * - Fully resolved request URL.
-     */
-    url: string;
-    /**
-     * - Request headers.
-     */
-    headers: SnapReqHeaders;
-    /**
-     * - Normalized request body.
-     */
-    body: import("./request.js").NormalizedBody;
-    /**
-     * - Request body compression.
-     */
-    bodyCompression: CompressionEncoding;
-    /**
-     * - Abort signal.
-     */
-    signal?: AbortSignal;
-    /**
-     * - Request timeout in milliseconds.
-     */
-    timeoutMs?: number;
-    /**
-     * - Fetch credentials mode ("omit" | "same-origin" | "include").
-     */
-    credentials?: string;
-};
-export type RequestOptions = {
-    /**
-     * - HTTP method. Defaults to GET.
-     */
-    method?: string;
-    /**
-     * - Request path (joined with the client `baseUrl`) or absolute URL.
-     */
-    path?: string;
-    /**
-     * - Alias for `path`.
-     */
-    url?: string;
-    /**
-     * - Query parameters.
-     */
-    query?: Record<string, string | number | boolean | null | undefined>;
-    /**
-     * - Per-request headers.
-     */
-    headers?: Record<string, string | number> | SnapReqHeaders;
-    /**
-     * - Request body: string, object (JSON), Uint8Array/ArrayBuffer, or a stream/async-iterable.
-     */
-    body?: any;
-    /**
-     * - Compress the request body (Node transport only).
-     */
-    bodyCompression?: CompressionEncoding;
-    /**
-     * - Abort signal for the request.
-     */
-    signal?: AbortSignal;
-    /**
-     * - Request timeout in milliseconds. Set to `0` to disable a client default.
-     */
-    timeoutMs?: number;
-    /**
-     * - Fetch credentials mode.
-     */
-    credentials?: string;
-    /**
-     * - Retry transient failures.
-     */
-    retry?: boolean | import("./retry.js").RetryOptions;
-    /**
-     * - Throw `SnapReqHttpError` on non-2xx responses.
-     */
-    throwOnError?: boolean;
-};
-export type RequestTimeout = {
-    /**
-     * - Signal to use for the request.
-     */
-    signal: AbortSignal | undefined;
-    /**
-     * - Clears timeout resources.
-     */
-    clear: () => void;
-    /**
-     * - Attaches timeout handling to a response.
-     */
-    response: (response: import("./response.js").default, request: NormalizedRequest) => import("./response.js").default;
-    /**
-     * - Maps a thrown error.
-     */
-    error: (error: unknown, request: NormalizedRequest) => unknown;
-};
-import { SnapReqHttpError } from "./errors.js";
-import SnapReqHeaders from "./headers.js";
 //# sourceMappingURL=snap-req.d.ts.map

package/build/snap-req.d.ts.map

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