@spare-technologies/spare-api 1.0.0-beta.7

package/dist/core/fetcher/Fetcher.js

@@ -0,0 +1,307 @@
+import { toJson } from "../json.js";
+import { createLogger } from "../logging/logger.js";
+import { createRequestUrl } from "./createRequestUrl.js";
+import { EndpointSupplier } from "./EndpointSupplier.js";
+import { getErrorResponseBody } from "./getErrorResponseBody.js";
+import { getFetchFn } from "./getFetchFn.js";
+import { getRequestBody } from "./getRequestBody.js";
+import { getResponseBody } from "./getResponseBody.js";
+import { Headers } from "./Headers.js";
+import { makeRequest } from "./makeRequest.js";
+import { abortRawResponse, toRawResponse, unknownRawResponse } from "./RawResponse.js";
+import { requestWithRetries } from "./requestWithRetries.js";
+const SENSITIVE_HEADERS = new Set([
+    "authorization",
+    "www-authenticate",
+    "x-api-key",
+    "api-key",
+    "apikey",
+    "x-api-token",
+    "x-auth-token",
+    "auth-token",
+    "cookie",
+    "set-cookie",
+    "proxy-authorization",
+    "proxy-authenticate",
+    "x-csrf-token",
+    "x-xsrf-token",
+    "x-session-token",
+    "x-access-token",
+]);
+function redactHeaders(headers) {
+    const filtered = {};
+    for (const [key, value] of headers instanceof Headers ? headers.entries() : Object.entries(headers)) {
+        if (SENSITIVE_HEADERS.has(key.toLowerCase())) {
+            filtered[key] = "[REDACTED]";
+        }
+        else {
+            filtered[key] = value;
+        }
+    }
+    return filtered;
+}
+const SENSITIVE_QUERY_PARAMS = new Set([
+    "api_key",
+    "api-key",
+    "apikey",
+    "token",
+    "access_token",
+    "access-token",
+    "auth_token",
+    "auth-token",
+    "password",
+    "passwd",
+    "secret",
+    "api_secret",
+    "api-secret",
+    "apisecret",
+    "key",
+    "session",
+    "session_id",
+    "session-id",
+]);
+function redactQueryParameters(queryParameters) {
+    if (queryParameters == null) {
+        return undefined;
+    }
+    const redacted = {};
+    for (const [key, value] of Object.entries(queryParameters)) {
+        redacted[key] = SENSITIVE_QUERY_PARAMS.has(key.toLowerCase()) ? "[REDACTED]" : value;
+    }
+    return redacted;
+}
+function redactUrl(url) {
+    const protocolIndex = url.indexOf("://");
+    if (protocolIndex === -1)
+        return url;
+    const afterProtocol = protocolIndex + 3;
+    // Find the first delimiter that marks the end of the authority section
+    const pathStart = url.indexOf("/", afterProtocol);
+    let queryStart = url.indexOf("?", afterProtocol);
+    let fragmentStart = url.indexOf("#", afterProtocol);
+    const firstDelimiter = Math.min(pathStart === -1 ? url.length : pathStart, queryStart === -1 ? url.length : queryStart, fragmentStart === -1 ? url.length : fragmentStart);
+    // Find the LAST @ before the delimiter (handles multiple @ in credentials)
+    let atIndex = -1;
+    for (let i = afterProtocol; i < firstDelimiter; i++) {
+        if (url[i] === "@") {
+            atIndex = i;
+        }
+    }
+    if (atIndex !== -1) {
+        url = `${url.slice(0, afterProtocol)}[REDACTED]@${url.slice(atIndex + 1)}`;
+    }
+    // Recalculate queryStart since url might have changed
+    queryStart = url.indexOf("?");
+    if (queryStart === -1)
+        return url;
+    fragmentStart = url.indexOf("#", queryStart);
+    const queryEnd = fragmentStart !== -1 ? fragmentStart : url.length;
+    const queryString = url.slice(queryStart + 1, queryEnd);
+    if (queryString.length === 0)
+        return url;
+    // FAST PATH: Quick check if any sensitive keywords present
+    // Using indexOf is faster than regex for simple substring matching
+    const lower = queryString.toLowerCase();
+    const hasSensitive = lower.includes("token") ||
+        lower.includes("key") ||
+        lower.includes("password") ||
+        lower.includes("passwd") ||
+        lower.includes("secret") ||
+        lower.includes("session") ||
+        lower.includes("auth");
+    if (!hasSensitive) {
+        return url;
+    }
+    // SLOW PATH: Parse and redact
+    const redactedParams = [];
+    const params = queryString.split("&");
+    for (const param of params) {
+        const equalIndex = param.indexOf("=");
+        if (equalIndex === -1) {
+            redactedParams.push(param);
+            continue;
+        }
+        const key = param.slice(0, equalIndex);
+        let shouldRedact = SENSITIVE_QUERY_PARAMS.has(key.toLowerCase());
+        if (!shouldRedact && key.includes("%")) {
+            try {
+                const decodedKey = decodeURIComponent(key);
+                shouldRedact = SENSITIVE_QUERY_PARAMS.has(decodedKey.toLowerCase());
+            }
+            catch { }
+        }
+        redactedParams.push(shouldRedact ? `${key}=[REDACTED]` : param);
+    }
+    return url.slice(0, queryStart + 1) + redactedParams.join("&") + url.slice(queryEnd);
+}
+async function getHeaders(args) {
+    const newHeaders = new Headers();
+    newHeaders.set("Accept", args.responseType === "json"
+        ? "application/json"
+        : args.responseType === "text"
+            ? "text/plain"
+            : args.responseType === "sse"
+                ? "text/event-stream"
+                : "*/*");
+    if (args.body !== undefined && args.contentType != null) {
+        newHeaders.set("Content-Type", args.contentType);
+    }
+    if (args.headers == null) {
+        return newHeaders;
+    }
+    for (const [key, value] of Object.entries(args.headers)) {
+        const result = await EndpointSupplier.get(value, { endpointMetadata: args.endpointMetadata ?? {} });
+        if (typeof result === "string") {
+            newHeaders.set(key, result);
+            continue;
+        }
+        if (result == null) {
+            continue;
+        }
+        newHeaders.set(key, `${result}`);
+    }
+    return newHeaders;
+}
+export async function fetcherImpl(args) {
+    let url = args.url;
+    if (args.queryString != null && args.queryString.length > 0) {
+        url = `${url}?${args.queryString}`;
+    }
+    else {
+        url = createRequestUrl(args.url, args.queryParameters);
+    }
+    const requestBody = await getRequestBody({
+        body: args.body,
+        type: args.requestType ?? "other",
+    });
+    const fetchFn = args.fetchFn ?? (await getFetchFn());
+    const headers = await getHeaders(args);
+    const logger = createLogger(args.logging);
+    if (logger.isDebug()) {
+        const metadata = {
+            method: args.method,
+            url: redactUrl(url),
+            headers: redactHeaders(headers),
+            queryParameters: redactQueryParameters(args.queryParameters),
+            hasBody: requestBody != null,
+        };
+        logger.debug("Making HTTP request", metadata);
+    }
+    try {
+        const response = await requestWithRetries(async () => makeRequest(fetchFn, url, args.method, headers, requestBody, args.timeoutMs, args.abortSignal, args.withCredentials, args.duplex, args.responseType === "streaming" || args.responseType === "sse"), args.maxRetries);
+        if (response.status >= 200 && response.status < 400) {
+            if (logger.isDebug()) {
+                const metadata = {
+                    method: args.method,
+                    url: redactUrl(url),
+                    statusCode: response.status,
+                    responseHeaders: redactHeaders(response.headers),
+                };
+                logger.debug("HTTP request succeeded", metadata);
+            }
+            const body = await getResponseBody(response, args.responseType);
+            return {
+                ok: true,
+                body: body,
+                headers: response.headers,
+                rawResponse: toRawResponse(response),
+            };
+        }
+        else {
+            if (logger.isError()) {
+                const metadata = {
+                    method: args.method,
+                    url: redactUrl(url),
+                    statusCode: response.status,
+                    responseHeaders: redactHeaders(Object.fromEntries(response.headers.entries())),
+                };
+                logger.error("HTTP request failed with error status", metadata);
+            }
+            return {
+                ok: false,
+                error: {
+                    reason: "status-code",
+                    statusCode: response.status,
+                    body: await getErrorResponseBody(response),
+                },
+                rawResponse: toRawResponse(response),
+            };
+        }
+    }
+    catch (error) {
+        if (args.abortSignal?.aborted) {
+            if (logger.isError()) {
+                const metadata = {
+                    method: args.method,
+                    url: redactUrl(url),
+                };
+                logger.error("HTTP request was aborted", metadata);
+            }
+            return {
+                ok: false,
+                error: {
+                    reason: "unknown",
+                    errorMessage: "The user aborted a request",
+                    cause: error,
+                },
+                rawResponse: abortRawResponse,
+            };
+        }
+        else if (error instanceof Error && error.name === "AbortError") {
+            if (logger.isError()) {
+                const metadata = {
+                    method: args.method,
+                    url: redactUrl(url),
+                    timeoutMs: args.timeoutMs,
+                };
+                logger.error("HTTP request timed out", metadata);
+            }
+            return {
+                ok: false,
+                error: {
+                    reason: "timeout",
+                    cause: error,
+                },
+                rawResponse: abortRawResponse,
+            };
+        }
+        else if (error instanceof Error) {
+            if (logger.isError()) {
+                const metadata = {
+                    method: args.method,
+                    url: redactUrl(url),
+                    errorMessage: error.message,
+                };
+                logger.error("HTTP request failed with error", metadata);
+            }
+            return {
+                ok: false,
+                error: {
+                    reason: "unknown",
+                    errorMessage: error.message,
+                    cause: error,
+                },
+                rawResponse: unknownRawResponse,
+            };
+        }
+        if (logger.isError()) {
+            const metadata = {
+                method: args.method,
+                url: redactUrl(url),
+                error: toJson(error),
+            };
+            logger.error("HTTP request failed with unknown error", metadata);
+        }
+        return {
+            ok: false,
+            error: {
+                reason: "unknown",
+                errorMessage: toJson(error),
+                cause: error,
+            },
+            rawResponse: unknownRawResponse,
+        };
+    }
+}
+export const fetcher = fetcherImpl;
+//# sourceMappingURL=Fetcher.js.map

package/dist/core/fetcher/Fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fetcher.js","sourceRoot":"","sources":["../../../core/fetcher/Fetcher.ts"],"names":[],"mappings":"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","sourcesContent":["import { toJson } from \"../json.js\";\nimport { createLogger, type LogConfig, type Logger } from \"../logging/logger.js\";\nimport type { APIResponse } from \"./APIResponse.js\";\nimport { createRequestUrl } from \"./createRequestUrl.js\";\nimport type { EndpointMetadata } from \"./EndpointMetadata.js\";\nimport { EndpointSupplier } from \"./EndpointSupplier.js\";\nimport { getErrorResponseBody } from \"./getErrorResponseBody.js\";\nimport { getFetchFn } from \"./getFetchFn.js\";\nimport { getRequestBody } from \"./getRequestBody.js\";\nimport { getResponseBody } from \"./getResponseBody.js\";\nimport { Headers } from \"./Headers.js\";\nimport { makeRequest } from \"./makeRequest.js\";\nimport { abortRawResponse, toRawResponse, unknownRawResponse } from \"./RawResponse.js\";\nimport { requestWithRetries } from \"./requestWithRetries.js\";\n\nexport type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;\n\nexport declare namespace Fetcher {\n    export interface Args {\n        url: string;\n        method: string;\n        contentType?: string;\n        headers?: Record<string, unknown>;\n        /**\n         * @deprecated Prefer `queryString` (produced by `core.url.queryBuilder()`).\n         * Retained for backwards compatibility with custom fetchers and callers that\n         * still construct request args with a query-parameter object.\n         */\n        queryParameters?: Record<string, unknown>;\n        queryString?: string;\n        body?: unknown;\n        timeoutMs?: number;\n        maxRetries?: number;\n        withCredentials?: boolean;\n        abortSignal?: AbortSignal;\n        requestType?: \"json\" | \"file\" | \"bytes\" | \"form\" | \"other\";\n        responseType?: \"json\" | \"blob\" | \"sse\" | \"streaming\" | \"text\" | \"arrayBuffer\" | \"binary-response\";\n        duplex?: \"half\";\n        endpointMetadata?: EndpointMetadata;\n        fetchFn?: typeof fetch;\n        logging?: LogConfig | Logger;\n    }\n\n    export type Error = FailedStatusCodeError | NonJsonError | BodyIsNullError | TimeoutError | UnknownError;\n\n    export interface FailedStatusCodeError {\n        reason: \"status-code\";\n        statusCode: number;\n        body: unknown;\n    }\n\n    export interface NonJsonError {\n        reason: \"non-json\";\n        statusCode: number;\n        rawBody: string;\n    }\n\n    export interface BodyIsNullError {\n        reason: \"body-is-null\";\n        statusCode: number;\n    }\n\n    export interface TimeoutError {\n        reason: \"timeout\";\n        cause?: unknown;\n    }\n\n    export interface UnknownError {\n        reason: \"unknown\";\n        errorMessage: string;\n        cause?: unknown;\n    }\n}\n\nconst SENSITIVE_HEADERS = new Set([\n    \"authorization\",\n    \"www-authenticate\",\n    \"x-api-key\",\n    \"api-key\",\n    \"apikey\",\n    \"x-api-token\",\n    \"x-auth-token\",\n    \"auth-token\",\n    \"cookie\",\n    \"set-cookie\",\n    \"proxy-authorization\",\n    \"proxy-authenticate\",\n    \"x-csrf-token\",\n    \"x-xsrf-token\",\n    \"x-session-token\",\n    \"x-access-token\",\n]);\n\nfunction redactHeaders(headers: Headers | Record<string, string>): Record<string, string> {\n    const filtered: Record<string, string> = {};\n    for (const [key, value] of headers instanceof Headers ? headers.entries() : Object.entries(headers)) {\n        if (SENSITIVE_HEADERS.has(key.toLowerCase())) {\n            filtered[key] = \"[REDACTED]\";\n        } else {\n            filtered[key] = value;\n        }\n    }\n    return filtered;\n}\n\nconst SENSITIVE_QUERY_PARAMS = new Set([\n    \"api_key\",\n    \"api-key\",\n    \"apikey\",\n    \"token\",\n    \"access_token\",\n    \"access-token\",\n    \"auth_token\",\n    \"auth-token\",\n    \"password\",\n    \"passwd\",\n    \"secret\",\n    \"api_secret\",\n    \"api-secret\",\n    \"apisecret\",\n    \"key\",\n    \"session\",\n    \"session_id\",\n    \"session-id\",\n]);\n\nfunction redactQueryParameters(\n    queryParameters: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined {\n    if (queryParameters == null) {\n        return undefined;\n    }\n    const redacted: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(queryParameters)) {\n        redacted[key] = SENSITIVE_QUERY_PARAMS.has(key.toLowerCase()) ? \"[REDACTED]\" : value;\n    }\n    return redacted;\n}\n\nfunction redactUrl(url: string): string {\n    const protocolIndex = url.indexOf(\"://\");\n    if (protocolIndex === -1) return url;\n\n    const afterProtocol = protocolIndex + 3;\n\n    // Find the first delimiter that marks the end of the authority section\n    const pathStart = url.indexOf(\"/\", afterProtocol);\n    let queryStart = url.indexOf(\"?\", afterProtocol);\n    let fragmentStart = url.indexOf(\"#\", afterProtocol);\n\n    const firstDelimiter = Math.min(\n        pathStart === -1 ? url.length : pathStart,\n        queryStart === -1 ? url.length : queryStart,\n        fragmentStart === -1 ? url.length : fragmentStart,\n    );\n\n    // Find the LAST @ before the delimiter (handles multiple @ in credentials)\n    let atIndex = -1;\n    for (let i = afterProtocol; i < firstDelimiter; i++) {\n        if (url[i] === \"@\") {\n            atIndex = i;\n        }\n    }\n\n    if (atIndex !== -1) {\n        url = `${url.slice(0, afterProtocol)}[REDACTED]@${url.slice(atIndex + 1)}`;\n    }\n\n    // Recalculate queryStart since url might have changed\n    queryStart = url.indexOf(\"?\");\n    if (queryStart === -1) return url;\n\n    fragmentStart = url.indexOf(\"#\", queryStart);\n    const queryEnd = fragmentStart !== -1 ? fragmentStart : url.length;\n    const queryString = url.slice(queryStart + 1, queryEnd);\n\n    if (queryString.length === 0) return url;\n\n    // FAST PATH: Quick check if any sensitive keywords present\n    // Using indexOf is faster than regex for simple substring matching\n    const lower = queryString.toLowerCase();\n    const hasSensitive =\n        lower.includes(\"token\") ||\n        lower.includes(\"key\") ||\n        lower.includes(\"password\") ||\n        lower.includes(\"passwd\") ||\n        lower.includes(\"secret\") ||\n        lower.includes(\"session\") ||\n        lower.includes(\"auth\");\n\n    if (!hasSensitive) {\n        return url;\n    }\n\n    // SLOW PATH: Parse and redact\n    const redactedParams: string[] = [];\n    const params = queryString.split(\"&\");\n\n    for (const param of params) {\n        const equalIndex = param.indexOf(\"=\");\n        if (equalIndex === -1) {\n            redactedParams.push(param);\n            continue;\n        }\n\n        const key = param.slice(0, equalIndex);\n        let shouldRedact = SENSITIVE_QUERY_PARAMS.has(key.toLowerCase());\n\n        if (!shouldRedact && key.includes(\"%\")) {\n            try {\n                const decodedKey = decodeURIComponent(key);\n                shouldRedact = SENSITIVE_QUERY_PARAMS.has(decodedKey.toLowerCase());\n            } catch {}\n        }\n\n        redactedParams.push(shouldRedact ? `${key}=[REDACTED]` : param);\n    }\n\n    return url.slice(0, queryStart + 1) + redactedParams.join(\"&\") + url.slice(queryEnd);\n}\n\nasync function getHeaders(args: Fetcher.Args): Promise<Headers> {\n    const newHeaders: Headers = new Headers();\n\n    newHeaders.set(\n        \"Accept\",\n        args.responseType === \"json\"\n            ? \"application/json\"\n            : args.responseType === \"text\"\n              ? \"text/plain\"\n              : args.responseType === \"sse\"\n                ? \"text/event-stream\"\n                : \"*/*\",\n    );\n    if (args.body !== undefined && args.contentType != null) {\n        newHeaders.set(\"Content-Type\", args.contentType);\n    }\n\n    if (args.headers == null) {\n        return newHeaders;\n    }\n\n    for (const [key, value] of Object.entries(args.headers)) {\n        const result = await EndpointSupplier.get(value, { endpointMetadata: args.endpointMetadata ?? {} });\n        if (typeof result === \"string\") {\n            newHeaders.set(key, result);\n            continue;\n        }\n        if (result == null) {\n            continue;\n        }\n        newHeaders.set(key, `${result}`);\n    }\n    return newHeaders;\n}\n\nexport async function fetcherImpl<R = unknown>(args: Fetcher.Args): Promise<APIResponse<R, Fetcher.Error>> {\n    let url = args.url;\n    if (args.queryString != null && args.queryString.length > 0) {\n        url = `${url}?${args.queryString}`;\n    } else {\n        url = createRequestUrl(args.url, args.queryParameters);\n    }\n    const requestBody: BodyInit | undefined = await getRequestBody({\n        body: args.body,\n        type: args.requestType ?? \"other\",\n    });\n    const fetchFn = args.fetchFn ?? (await getFetchFn());\n    const headers = await getHeaders(args);\n    const logger = createLogger(args.logging);\n\n    if (logger.isDebug()) {\n        const metadata = {\n            method: args.method,\n            url: redactUrl(url),\n            headers: redactHeaders(headers),\n            queryParameters: redactQueryParameters(args.queryParameters),\n            hasBody: requestBody != null,\n        };\n        logger.debug(\"Making HTTP request\", metadata);\n    }\n\n    try {\n        const response = await requestWithRetries(\n            async () =>\n                makeRequest(\n                    fetchFn,\n                    url,\n                    args.method,\n                    headers,\n                    requestBody,\n                    args.timeoutMs,\n                    args.abortSignal,\n                    args.withCredentials,\n                    args.duplex,\n                    args.responseType === \"streaming\" || args.responseType === \"sse\",\n                ),\n            args.maxRetries,\n        );\n\n        if (response.status >= 200 && response.status < 400) {\n            if (logger.isDebug()) {\n                const metadata = {\n                    method: args.method,\n                    url: redactUrl(url),\n                    statusCode: response.status,\n                    responseHeaders: redactHeaders(response.headers),\n                };\n                logger.debug(\"HTTP request succeeded\", metadata);\n            }\n            const body = await getResponseBody(response, args.responseType);\n            return {\n                ok: true,\n                body: body as R,\n                headers: response.headers,\n                rawResponse: toRawResponse(response),\n            };\n        } else {\n            if (logger.isError()) {\n                const metadata = {\n                    method: args.method,\n                    url: redactUrl(url),\n                    statusCode: response.status,\n                    responseHeaders: redactHeaders(Object.fromEntries(response.headers.entries())),\n                };\n                logger.error(\"HTTP request failed with error status\", metadata);\n            }\n            return {\n                ok: false,\n                error: {\n                    reason: \"status-code\",\n                    statusCode: response.status,\n                    body: await getErrorResponseBody(response),\n                },\n                rawResponse: toRawResponse(response),\n            };\n        }\n    } catch (error) {\n        if (args.abortSignal?.aborted) {\n            if (logger.isError()) {\n                const metadata = {\n                    method: args.method,\n                    url: redactUrl(url),\n                };\n                logger.error(\"HTTP request was aborted\", metadata);\n            }\n            return {\n                ok: false,\n                error: {\n                    reason: \"unknown\",\n                    errorMessage: \"The user aborted a request\",\n                    cause: error,\n                },\n                rawResponse: abortRawResponse,\n            };\n        } else if (error instanceof Error && error.name === \"AbortError\") {\n            if (logger.isError()) {\n                const metadata = {\n                    method: args.method,\n                    url: redactUrl(url),\n                    timeoutMs: args.timeoutMs,\n                };\n                logger.error(\"HTTP request timed out\", metadata);\n            }\n            return {\n                ok: false,\n                error: {\n                    reason: \"timeout\",\n                    cause: error,\n                },\n                rawResponse: abortRawResponse,\n            };\n        } else if (error instanceof Error) {\n            if (logger.isError()) {\n                const metadata = {\n                    method: args.method,\n                    url: redactUrl(url),\n                    errorMessage: error.message,\n                };\n                logger.error(\"HTTP request failed with error\", metadata);\n            }\n            return {\n                ok: false,\n                error: {\n                    reason: \"unknown\",\n                    errorMessage: error.message,\n                    cause: error,\n                },\n                rawResponse: unknownRawResponse,\n            };\n        }\n\n        if (logger.isError()) {\n            const metadata = {\n                method: args.method,\n                url: redactUrl(url),\n                error: toJson(error),\n            };\n            logger.error(\"HTTP request failed with unknown error\", metadata);\n        }\n        return {\n            ok: false,\n            error: {\n                reason: \"unknown\",\n                errorMessage: toJson(error),\n                cause: error,\n            },\n            rawResponse: unknownRawResponse,\n        };\n    }\n}\n\nexport const fetcher: FetchFunction = fetcherImpl;\n"]}

package/dist/core/fetcher/Headers.d.ts

@@ -0,0 +1,3 @@
+declare let Headers: typeof globalThis.Headers;
+export { Headers };
+//# sourceMappingURL=Headers.d.ts.map

package/dist/core/fetcher/Headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Headers.d.ts","sourceRoot":"","sources":["../../../core/fetcher/Headers.ts"],"names":[],"mappings":"AAAA,QAAA,IAAI,OAAO,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC;AA4FvC,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/core/fetcher/Headers.js

@@ -0,0 +1,83 @@
+let Headers;
+if (typeof globalThis.Headers !== "undefined") {
+    Headers = globalThis.Headers;
+}
+else {
+    Headers = class Headers {
+        constructor(init) {
+            this.headers = new Map();
+            if (init) {
+                if (init instanceof Headers) {
+                    init.forEach((value, key) => this.append(key, value));
+                }
+                else if (Array.isArray(init)) {
+                    for (const [key, value] of init) {
+                        if (typeof key === "string" && typeof value === "string") {
+                            this.append(key, value);
+                        }
+                        else {
+                            throw new TypeError("Each header entry must be a [string, string] tuple");
+                        }
+                    }
+                }
+                else {
+                    for (const [key, value] of Object.entries(init)) {
+                        if (typeof value === "string") {
+                            this.append(key, value);
+                        }
+                        else {
+                            throw new TypeError("Header values must be strings");
+                        }
+                    }
+                }
+            }
+        }
+        append(name, value) {
+            const key = name.toLowerCase();
+            const existing = this.headers.get(key) || [];
+            this.headers.set(key, [...existing, value]);
+        }
+        delete(name) {
+            const key = name.toLowerCase();
+            this.headers.delete(key);
+        }
+        get(name) {
+            const key = name.toLowerCase();
+            const values = this.headers.get(key);
+            return values ? values.join(", ") : null;
+        }
+        has(name) {
+            const key = name.toLowerCase();
+            return this.headers.has(key);
+        }
+        set(name, value) {
+            const key = name.toLowerCase();
+            this.headers.set(key, [value]);
+        }
+        forEach(callbackfn, thisArg) {
+            const boundCallback = thisArg ? callbackfn.bind(thisArg) : callbackfn;
+            this.headers.forEach((values, key) => boundCallback(values.join(", "), key, this));
+        }
+        getSetCookie() {
+            return this.headers.get("set-cookie") || [];
+        }
+        *entries() {
+            for (const [key, values] of this.headers.entries()) {
+                yield [key, values.join(", ")];
+            }
+        }
+        *keys() {
+            yield* this.headers.keys();
+        }
+        *values() {
+            for (const values of this.headers.values()) {
+                yield values.join(", ");
+            }
+        }
+        [Symbol.iterator]() {
+            return this.entries();
+        }
+    };
+}
+export { Headers };
+//# sourceMappingURL=Headers.js.map

package/dist/core/fetcher/Headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Headers.js","sourceRoot":"","sources":["../../../core/fetcher/Headers.ts"],"names":[],"mappings":"AAAA,IAAI,OAAkC,CAAC;AAEvC,IAAI,OAAO,UAAU,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;IAC5C,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;AACjC,CAAC;KAAM,CAAC;IACJ,OAAO,GAAG,MAAM,OAAO;QAGnB,YAAY,IAAkB;YAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;YAEzB,IAAI,IAAI,EAAE,CAAC;gBACP,IAAI,IAAI,YAAY,OAAO,EAAE,CAAC;oBAC1B,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;gBAC1D,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;wBAC9B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;4BACvD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;wBAC5B,CAAC;6BAAM,CAAC;4BACJ,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;wBAC9E,CAAC;oBACL,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACJ,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;4BAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;wBAC5B,CAAC;6BAAM,CAAC;4BACJ,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;wBACzD,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,MAAM,CAAC,IAAY,EAAE,KAAa;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,CAAC,IAAY;YACf,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAED,GAAG,CAAC,IAAY;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,CAAC;QAED,GAAG,CAAC,IAAY;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,GAAG,CAAC,IAAY,EAAE,KAAa;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,CAAC,UAAiE,EAAE,OAAiB;YACxF,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;YACtE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QACvF,CAAC;QAED,YAAY;YACR,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;QAED,CAAC,OAAO;YACJ,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjD,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACnC,CAAC;QACL,CAAC;QAED,CAAC,IAAI;YACD,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,CAAC,MAAM;YACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACzC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACL,CAAC;QAED,CAAC,MAAM,CAAC,QAAQ,CAAC;YACb,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;KACJ,CAAC;AACN,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC","sourcesContent":["let Headers: typeof globalThis.Headers;\n\nif (typeof globalThis.Headers !== \"undefined\") {\n    Headers = globalThis.Headers;\n} else {\n    Headers = class Headers implements Headers {\n        private headers: Map<string, string[]>;\n\n        constructor(init?: HeadersInit) {\n            this.headers = new Map();\n\n            if (init) {\n                if (init instanceof Headers) {\n                    init.forEach((value, key) => this.append(key, value));\n                } else if (Array.isArray(init)) {\n                    for (const [key, value] of init) {\n                        if (typeof key === \"string\" && typeof value === \"string\") {\n                            this.append(key, value);\n                        } else {\n                            throw new TypeError(\"Each header entry must be a [string, string] tuple\");\n                        }\n                    }\n                } else {\n                    for (const [key, value] of Object.entries(init)) {\n                        if (typeof value === \"string\") {\n                            this.append(key, value);\n                        } else {\n                            throw new TypeError(\"Header values must be strings\");\n                        }\n                    }\n                }\n            }\n        }\n\n        append(name: string, value: string): void {\n            const key = name.toLowerCase();\n            const existing = this.headers.get(key) || [];\n            this.headers.set(key, [...existing, value]);\n        }\n\n        delete(name: string): void {\n            const key = name.toLowerCase();\n            this.headers.delete(key);\n        }\n\n        get(name: string): string | null {\n            const key = name.toLowerCase();\n            const values = this.headers.get(key);\n            return values ? values.join(\", \") : null;\n        }\n\n        has(name: string): boolean {\n            const key = name.toLowerCase();\n            return this.headers.has(key);\n        }\n\n        set(name: string, value: string): void {\n            const key = name.toLowerCase();\n            this.headers.set(key, [value]);\n        }\n\n        forEach(callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: unknown): void {\n            const boundCallback = thisArg ? callbackfn.bind(thisArg) : callbackfn;\n            this.headers.forEach((values, key) => boundCallback(values.join(\", \"), key, this));\n        }\n\n        getSetCookie(): string[] {\n            return this.headers.get(\"set-cookie\") || [];\n        }\n\n        *entries(): HeadersIterator<[string, string]> {\n            for (const [key, values] of this.headers.entries()) {\n                yield [key, values.join(\", \")];\n            }\n        }\n\n        *keys(): HeadersIterator<string> {\n            yield* this.headers.keys();\n        }\n\n        *values(): HeadersIterator<string> {\n            for (const values of this.headers.values()) {\n                yield values.join(\", \");\n            }\n        }\n\n        [Symbol.iterator](): HeadersIterator<[string, string]> {\n            return this.entries();\n        }\n    };\n}\n\nexport { Headers };\n"]}

package/dist/core/fetcher/HttpResponsePromise.d.ts

@@ -0,0 +1,59 @@
+import type { WithRawResponse } from "./RawResponse.js";
+/**
+ * A promise that returns the parsed response and lets you retrieve the raw response too.
+ */
+export declare class HttpResponsePromise<T> extends Promise<T> {
+    private innerPromise;
+    private unwrappedPromise;
+    private constructor();
+    /**
+     * Creates an `HttpResponsePromise` from a function that returns a promise.
+     *
+     * @param fn - A function that returns a promise resolving to a `WithRawResponse` object.
+     * @param args - Arguments to pass to the function.
+     * @returns An `HttpResponsePromise` instance.
+     */
+    static fromFunction<F extends (...args: never[]) => Promise<WithRawResponse<T>>, T>(fn: F, ...args: Parameters<F>): HttpResponsePromise<T>;
+    /**
+     * Creates a function that returns an `HttpResponsePromise` from a function that returns a promise.
+     *
+     * @param fn - A function that returns a promise resolving to a `WithRawResponse` object.
+     * @returns A function that returns an `HttpResponsePromise` instance.
+     */
+    static interceptFunction<F extends (...args: never[]) => Promise<WithRawResponse<T>>, T = Awaited<ReturnType<F>>["data"]>(fn: F): (...args: Parameters<F>) => HttpResponsePromise<T>;
+    /**
+     * Creates an `HttpResponsePromise` from an existing promise.
+     *
+     * @param promise - A promise resolving to a `WithRawResponse` object.
+     * @returns An `HttpResponsePromise` instance.
+     */
+    static fromPromise<T>(promise: Promise<WithRawResponse<T>>): HttpResponsePromise<T>;
+    /**
+     * Creates an `HttpResponsePromise` from an executor function.
+     *
+     * @param executor - A function that takes resolve and reject callbacks to create a promise.
+     * @returns An `HttpResponsePromise` instance.
+     */
+    static fromExecutor<T>(executor: (resolve: (value: WithRawResponse<T>) => void, reject: (reason?: unknown) => void) => void): HttpResponsePromise<T>;
+    /**
+     * Creates an `HttpResponsePromise` from a resolved result.
+     *
+     * @param result - A `WithRawResponse` object to resolve immediately.
+     * @returns An `HttpResponsePromise` instance.
+     */
+    static fromResult<T>(result: WithRawResponse<T>): HttpResponsePromise<T>;
+    private unwrap;
+    /** @inheritdoc */
+    then<TResult1 = T, TResult2 = never>(onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    /** @inheritdoc */
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<T | TResult>;
+    /** @inheritdoc */
+    finally(onfinally?: (() => void) | null): Promise<T>;
+    /**
+     * Retrieves the data and raw response.
+     *
+     * @returns A promise resolving to a `WithRawResponse` object.
+     */
+    withRawResponse(): Promise<WithRawResponse<T>>;
+}
+//# sourceMappingURL=HttpResponsePromise.d.ts.map

package/dist/core/fetcher/HttpResponsePromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpResponsePromise.d.ts","sourceRoot":"","sources":["../../../core/fetcher/HttpResponsePromise.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;GAEG;AACH,qBAAa,mBAAmB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,gBAAgB,CAAyB;IAEjD,OAAO;IAQP;;;;;;OAMG;WACW,YAAY,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EACrF,EAAE,EAAE,CAAC,EACL,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GACvB,mBAAmB,CAAC,CAAC,CAAC;IAIzB;;;;;OAKG;WACW,iBAAiB,CAC3B,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAC3D,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EACpC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,mBAAmB,CAAC,CAAC,CAAC;IAM5D;;;;;OAKG;WACW,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC;IAI1F;;;;;OAKG;WACW,YAAY,CAAC,CAAC,EACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,GACrG,mBAAmB,CAAC,CAAC,CAAC;IAKzB;;;;;OAKG;WACW,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC;IAK/E,OAAO,CAAC,MAAM;IAOd,kBAAkB;IACF,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAC/C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EACrE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAC5E,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAI/B,kBAAkB;IACF,KAAK,CAAC,OAAO,GAAG,KAAK,EACjC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAC1E,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC;IAIvB,kBAAkB;IACF,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpE;;;;OAIG;IACU,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAG9D"}

package/dist/core/fetcher/HttpResponsePromise.js

@@ -0,0 +1,89 @@
+/**
+ * A promise that returns the parsed response and lets you retrieve the raw response too.
+ */
+export class HttpResponsePromise extends Promise {
+    constructor(promise) {
+        // Initialize with a no-op to avoid premature parsing
+        super((resolve) => {
+            resolve(undefined);
+        });
+        this.innerPromise = promise;
+    }
+    /**
+     * Creates an `HttpResponsePromise` from a function that returns a promise.
+     *
+     * @param fn - A function that returns a promise resolving to a `WithRawResponse` object.
+     * @param args - Arguments to pass to the function.
+     * @returns An `HttpResponsePromise` instance.
+     */
+    static fromFunction(fn, ...args) {
+        return new HttpResponsePromise(fn(...args));
+    }
+    /**
+     * Creates a function that returns an `HttpResponsePromise` from a function that returns a promise.
+     *
+     * @param fn - A function that returns a promise resolving to a `WithRawResponse` object.
+     * @returns A function that returns an `HttpResponsePromise` instance.
+     */
+    static interceptFunction(fn) {
+        return (...args) => {
+            return HttpResponsePromise.fromPromise(fn(...args));
+        };
+    }
+    /**
+     * Creates an `HttpResponsePromise` from an existing promise.
+     *
+     * @param promise - A promise resolving to a `WithRawResponse` object.
+     * @returns An `HttpResponsePromise` instance.
+     */
+    static fromPromise(promise) {
+        return new HttpResponsePromise(promise);
+    }
+    /**
+     * Creates an `HttpResponsePromise` from an executor function.
+     *
+     * @param executor - A function that takes resolve and reject callbacks to create a promise.
+     * @returns An `HttpResponsePromise` instance.
+     */
+    static fromExecutor(executor) {
+        const promise = new Promise(executor);
+        return new HttpResponsePromise(promise);
+    }
+    /**
+     * Creates an `HttpResponsePromise` from a resolved result.
+     *
+     * @param result - A `WithRawResponse` object to resolve immediately.
+     * @returns An `HttpResponsePromise` instance.
+     */
+    static fromResult(result) {
+        const promise = Promise.resolve(result);
+        return new HttpResponsePromise(promise);
+    }
+    unwrap() {
+        if (!this.unwrappedPromise) {
+            this.unwrappedPromise = this.innerPromise.then(({ data }) => data);
+        }
+        return this.unwrappedPromise;
+    }
+    /** @inheritdoc */
+    then(onfulfilled, onrejected) {
+        return this.unwrap().then(onfulfilled, onrejected);
+    }
+    /** @inheritdoc */
+    catch(onrejected) {
+        return this.unwrap().catch(onrejected);
+    }
+    /** @inheritdoc */
+    finally(onfinally) {
+        return this.unwrap().finally(onfinally);
+    }
+    /**
+     * Retrieves the data and raw response.
+     *
+     * @returns A promise resolving to a `WithRawResponse` object.
+     */
+    async withRawResponse() {
+        return await this.innerPromise;
+    }
+}
+//# sourceMappingURL=HttpResponsePromise.js.map

package/dist/core/fetcher/HttpResponsePromise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpResponsePromise.js","sourceRoot":"","sources":["../../../core/fetcher/HttpResponsePromise.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,mBAAuB,SAAQ,OAAU;IAIlD,YAAoB,OAAoC;QACpD,qDAAqD;QACrD,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE;YACd,OAAO,CAAC,SAAyB,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAChC,CAAC;IAED;;;;;;OAMG;IACI,MAAM,CAAC,YAAY,CACtB,EAAK,EACL,GAAG,IAAmB;QAEtB,OAAO,IAAI,mBAAmB,CAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,iBAAiB,CAG7B,EAAK;QACH,OAAO,CAAC,GAAG,IAAmB,EAA0B,EAAE;YACtD,OAAO,mBAAmB,CAAC,WAAW,CAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,WAAW,CAAI,OAAoC;QAC7D,OAAO,IAAI,mBAAmB,CAAI,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,YAAY,CACtB,QAAoG;QAEpG,MAAM,OAAO,GAAG,IAAI,OAAO,CAAqB,QAAQ,CAAC,CAAC;QAC1D,OAAO,IAAI,mBAAmB,CAAI,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,UAAU,CAAI,MAA0B;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,IAAI,mBAAmB,CAAI,OAAO,CAAC,CAAC;IAC/C,CAAC;IAEO,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC;IAED,kBAAkB;IACF,IAAI,CAChB,WAAqE,EACrE,UAA2E;QAE3E,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,kBAAkB;IACF,KAAK,CACjB,UAAyE;QAEzE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3C,CAAC;IAED,kBAAkB;IACF,OAAO,CAAC,SAA+B;QACnD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe;QACxB,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC;IACnC,CAAC;CACJ","sourcesContent":["import type { WithRawResponse } from \"./RawResponse.js\";\n\n/**\n * A promise that returns the parsed response and lets you retrieve the raw response too.\n */\nexport class HttpResponsePromise<T> extends Promise<T> {\n    private innerPromise: Promise<WithRawResponse<T>>;\n    private unwrappedPromise: Promise<T> | undefined;\n\n    private constructor(promise: Promise<WithRawResponse<T>>) {\n        // Initialize with a no-op to avoid premature parsing\n        super((resolve) => {\n            resolve(undefined as unknown as T);\n        });\n        this.innerPromise = promise;\n    }\n\n    /**\n     * Creates an `HttpResponsePromise` from a function that returns a promise.\n     *\n     * @param fn - A function that returns a promise resolving to a `WithRawResponse` object.\n     * @param args - Arguments to pass to the function.\n     * @returns An `HttpResponsePromise` instance.\n     */\n    public static fromFunction<F extends (...args: never[]) => Promise<WithRawResponse<T>>, T>(\n        fn: F,\n        ...args: Parameters<F>\n    ): HttpResponsePromise<T> {\n        return new HttpResponsePromise<T>(fn(...args));\n    }\n\n    /**\n     * Creates a function that returns an `HttpResponsePromise` from a function that returns a promise.\n     *\n     * @param fn - A function that returns a promise resolving to a `WithRawResponse` object.\n     * @returns A function that returns an `HttpResponsePromise` instance.\n     */\n    public static interceptFunction<\n        F extends (...args: never[]) => Promise<WithRawResponse<T>>,\n        T = Awaited<ReturnType<F>>[\"data\"],\n    >(fn: F): (...args: Parameters<F>) => HttpResponsePromise<T> {\n        return (...args: Parameters<F>): HttpResponsePromise<T> => {\n            return HttpResponsePromise.fromPromise<T>(fn(...args));\n        };\n    }\n\n    /**\n     * Creates an `HttpResponsePromise` from an existing promise.\n     *\n     * @param promise - A promise resolving to a `WithRawResponse` object.\n     * @returns An `HttpResponsePromise` instance.\n     */\n    public static fromPromise<T>(promise: Promise<WithRawResponse<T>>): HttpResponsePromise<T> {\n        return new HttpResponsePromise<T>(promise);\n    }\n\n    /**\n     * Creates an `HttpResponsePromise` from an executor function.\n     *\n     * @param executor - A function that takes resolve and reject callbacks to create a promise.\n     * @returns An `HttpResponsePromise` instance.\n     */\n    public static fromExecutor<T>(\n        executor: (resolve: (value: WithRawResponse<T>) => void, reject: (reason?: unknown) => void) => void,\n    ): HttpResponsePromise<T> {\n        const promise = new Promise<WithRawResponse<T>>(executor);\n        return new HttpResponsePromise<T>(promise);\n    }\n\n    /**\n     * Creates an `HttpResponsePromise` from a resolved result.\n     *\n     * @param result - A `WithRawResponse` object to resolve immediately.\n     * @returns An `HttpResponsePromise` instance.\n     */\n    public static fromResult<T>(result: WithRawResponse<T>): HttpResponsePromise<T> {\n        const promise = Promise.resolve(result);\n        return new HttpResponsePromise<T>(promise);\n    }\n\n    private unwrap(): Promise<T> {\n        if (!this.unwrappedPromise) {\n            this.unwrappedPromise = this.innerPromise.then(({ data }) => data);\n        }\n        return this.unwrappedPromise;\n    }\n\n    /** @inheritdoc */\n    public override then<TResult1 = T, TResult2 = never>(\n        onfulfilled?: ((value: T) => TResult1 | PromiseLike<TResult1>) | null,\n        onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n    ): Promise<TResult1 | TResult2> {\n        return this.unwrap().then(onfulfilled, onrejected);\n    }\n\n    /** @inheritdoc */\n    public override catch<TResult = never>(\n        onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null,\n    ): Promise<T | TResult> {\n        return this.unwrap().catch(onrejected);\n    }\n\n    /** @inheritdoc */\n    public override finally(onfinally?: (() => void) | null): Promise<T> {\n        return this.unwrap().finally(onfinally);\n    }\n\n    /**\n     * Retrieves the data and raw response.\n     *\n     * @returns A promise resolving to a `WithRawResponse` object.\n     */\n    public async withRawResponse(): Promise<WithRawResponse<T>> {\n        return await this.innerPromise;\n    }\n}\n"]}