@langfuse/core 4.0.0-alpha.0

package/dist/api/api/resources/utils/resources/pagination/types/MetaResponse.js

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/api/api/resources/utils/resources/pagination/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./MetaResponse.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/api/resources/utils/resources/pagination/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../src/api/api/resources/utils/resources/pagination/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/api/api/resources/utils/resources/pagination/types/index.js

@@ -0,0 +1 @@
+export * from "./MetaResponse.js";

package/dist/api/core/auth/BasicAuth.d.ts

@@ -0,0 +1,9 @@
+export interface BasicAuth {
+    username: string;
+    password: string;
+}
+export declare const BasicAuth: {
+    toAuthorizationHeader: (basicAuth: BasicAuth | undefined) => string | undefined;
+    fromAuthorizationHeader: (header: string) => BasicAuth;
+};
+//# sourceMappingURL=BasicAuth.d.ts.map

package/dist/api/core/auth/BasicAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicAuth.d.ts","sourceRoot":"","sources":["../../../../src/api/core/auth/BasicAuth.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,eAAO,MAAM,SAAS;uCAEP,SAAS,GAAG,SAAS,KAC/B,MAAM,GAAG,SAAS;sCAOa,MAAM,KAAG,SAAS;CAarD,CAAC"}

package/dist/api/core/auth/BasicAuth.js

@@ -0,0 +1,23 @@
+import { base64Decode, base64Encode } from "../base64.js";
+const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
+export const BasicAuth = {
+    toAuthorizationHeader: (basicAuth) => {
+        if (basicAuth == null) {
+            return undefined;
+        }
+        const token = base64Encode(`${basicAuth.username}:${basicAuth.password}`);
+        return `Basic ${token}`;
+    },
+    fromAuthorizationHeader: (header) => {
+        const credentials = header.replace(BASIC_AUTH_HEADER_PREFIX, "");
+        const decoded = base64Decode(credentials);
+        const [username, password] = decoded.split(":", 2);
+        if (username == null || password == null) {
+            throw new Error("Invalid basic auth");
+        }
+        return {
+            username,
+            password,
+        };
+    },
+};

package/dist/api/core/auth/BearerToken.d.ts

@@ -0,0 +1,6 @@
+export type BearerToken = string;
+export declare const BearerToken: {
+    toAuthorizationHeader: (token: BearerToken | undefined) => string | undefined;
+    fromAuthorizationHeader: (header: string) => BearerToken;
+};
+//# sourceMappingURL=BearerToken.d.ts.map

package/dist/api/core/auth/BearerToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BearerToken.d.ts","sourceRoot":"","sources":["../../../../src/api/core/auth/BearerToken.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAIjC,eAAO,MAAM,WAAW;mCAEb,WAAW,GAAG,SAAS,KAC7B,MAAM,GAAG,SAAS;sCAMa,MAAM,KAAG,WAAW;CAGvD,CAAC"}

package/dist/api/core/auth/BearerToken.js

@@ -0,0 +1,12 @@
+const BEARER_AUTH_HEADER_PREFIX = /^Bearer /i;
+export const BearerToken = {
+    toAuthorizationHeader: (token) => {
+        if (token == null) {
+            return undefined;
+        }
+        return `Bearer ${token}`;
+    },
+    fromAuthorizationHeader: (header) => {
+        return header.replace(BEARER_AUTH_HEADER_PREFIX, "").trim();
+    },
+};

package/dist/api/core/auth/index.d.ts

@@ -0,0 +1,3 @@
+export { BasicAuth } from "./BasicAuth.js";
+export { BearerToken } from "./BearerToken.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/api/core/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/core/auth/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/api/core/auth/index.js

@@ -0,0 +1,2 @@
+export { BasicAuth } from "./BasicAuth.js";
+export { BearerToken } from "./BearerToken.js";

package/dist/api/core/base64.d.ts

@@ -0,0 +1,3 @@
+export declare function base64Encode(input: string): string;
+export declare function base64Decode(input: string): string;
+//# sourceMappingURL=base64.d.ts.map

package/dist/api/core/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../../../src/api/core/base64.ts"],"names":[],"mappings":"AAUA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOlD"}

package/dist/api/core/base64.js

@@ -0,0 +1,22 @@
+function base64ToBytes(base64) {
+    const binString = atob(base64);
+    return Uint8Array.from(binString, (m) => m.codePointAt(0));
+}
+function bytesToBase64(bytes) {
+    const binString = String.fromCodePoint(...bytes);
+    return btoa(binString);
+}
+export function base64Encode(input) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(input, "utf8").toString("base64");
+    }
+    const bytes = new TextEncoder().encode(input);
+    return bytesToBase64(bytes);
+}
+export function base64Decode(input) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(input, "base64").toString("utf8");
+    }
+    const bytes = base64ToBytes(input);
+    return new TextDecoder().decode(bytes);
+}

package/dist/api/core/fetcher/APIResponse.d.ts

@@ -0,0 +1,21 @@
+import { RawResponse } from "./RawResponse.js";
+/**
+ * The response of an API call.
+ * It is a successful response or a failed response.
+ */
+export type APIResponse<Success, Failure> = SuccessfulResponse<Success> | FailedResponse<Failure>;
+export interface SuccessfulResponse<T> {
+    ok: true;
+    body: T;
+    /**
+     * @deprecated Use `rawResponse` instead
+     */
+    headers?: Record<string, any>;
+    rawResponse: RawResponse;
+}
+export interface FailedResponse<T> {
+    ok: false;
+    error: T;
+    rawResponse: RawResponse;
+}
+//# sourceMappingURL=APIResponse.d.ts.map

package/dist/api/core/fetcher/APIResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"APIResponse.d.ts","sourceRoot":"","sources":["../../../../src/api/core/fetcher/APIResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,EAAE,OAAO,IACpC,kBAAkB,CAAC,OAAO,CAAC,GAC3B,cAAc,CAAC,OAAO,CAAC,CAAC;AAE5B,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;IACR;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,EAAE,WAAW,CAAC;CAC1B"}

package/dist/api/core/fetcher/APIResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/api/core/fetcher/BinaryResponse.d.ts

@@ -0,0 +1,21 @@
+import { ResponseWithBody } from "./ResponseWithBody.js";
+export type BinaryResponse = {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */
+    bodyUsed: boolean;
+    /**
+     * Returns a ReadableStream of the response body.
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body)
+     */
+    stream: () => ReadableStream<Uint8Array>;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */
+    arrayBuffer: () => Promise<ArrayBuffer>;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */
+    blob: () => Promise<Blob>;
+    /**
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes)
+     * Some versions of the Fetch API may not support this method.
+     */
+    bytes?(): Promise<Uint8Array>;
+};
+export declare function getBinaryResponse(response: ResponseWithBody): BinaryResponse;
+//# sourceMappingURL=BinaryResponse.d.ts.map

package/dist/api/core/fetcher/BinaryResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryResponse.d.ts","sourceRoot":"","sources":["../../../../src/api/core/fetcher/BinaryResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG;IAC3B,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,MAAM,EAAE,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IACzC,sFAAsF;IACtF,WAAW,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACxC,+EAA+E;IAC/E,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;CAC/B,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAc5E"}

package/dist/api/core/fetcher/BinaryResponse.js

@@ -0,0 +1,14 @@
+export function getBinaryResponse(response) {
+    const binaryResponse = {
+        get bodyUsed() {
+            return response.bodyUsed;
+        },
+        stream: () => response.body,
+        arrayBuffer: response.arrayBuffer.bind(response),
+        blob: response.blob.bind(response),
+    };
+    if ("bytes" in response && typeof response.bytes === "function") {
+        binaryResponse.bytes = response.bytes.bind(response);
+    }
+    return binaryResponse;
+}

package/dist/api/core/fetcher/Fetcher.d.ts

@@ -0,0 +1,41 @@
+import { APIResponse } from "./APIResponse.js";
+import { Supplier } from "./Supplier.js";
+export type FetchFunction = <R = unknown>(args: Fetcher.Args) => Promise<APIResponse<R, Fetcher.Error>>;
+export declare namespace Fetcher {
+    interface Args {
+        url: string;
+        method: string;
+        contentType?: string;
+        headers?: Record<string, string | Supplier<string | undefined> | undefined>;
+        queryParameters?: Record<string, unknown>;
+        body?: unknown;
+        timeoutMs?: number;
+        maxRetries?: number;
+        withCredentials?: boolean;
+        abortSignal?: AbortSignal;
+        requestType?: "json" | "file" | "bytes";
+        responseType?: "json" | "blob" | "sse" | "streaming" | "text" | "arrayBuffer" | "binary-response";
+        duplex?: "half";
+    }
+    type Error = FailedStatusCodeError | NonJsonError | TimeoutError | UnknownError;
+    interface FailedStatusCodeError {
+        reason: "status-code";
+        statusCode: number;
+        body: unknown;
+    }
+    interface NonJsonError {
+        reason: "non-json";
+        statusCode: number;
+        rawBody: string;
+    }
+    interface TimeoutError {
+        reason: "timeout";
+    }
+    interface UnknownError {
+        reason: "unknown";
+        errorMessage: string;
+    }
+}
+export declare function fetcherImpl<R = unknown>(args: Fetcher.Args): Promise<APIResponse<R, Fetcher.Error>>;
+export declare const fetcher: FetchFunction;
+//# sourceMappingURL=Fetcher.d.ts.map

package/dist/api/core/fetcher/Fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fetcher.d.ts","sourceRoot":"","sources":["../../../../src/api/core/fetcher/Fetcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AASzC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,OAAO,EACtC,IAAI,EAAE,OAAO,CAAC,IAAI,KACf,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAE5C,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,UAAiB,IAAI;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC,CAAC;QAC5E,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QACxC,YAAY,CAAC,EACT,MAAM,GACN,MAAM,GACN,KAAK,GACL,WAAW,GACX,MAAM,GACN,aAAa,GACb,iBAAiB,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAED,KAAY,KAAK,GACb,qBAAqB,GACrB,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;IAEjB,UAAiB,qBAAqB;QACpC,MAAM,EAAE,aAAa,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,OAAO,CAAC;KACf;IAED,UAAiB,YAAY;QAC3B,MAAM,EAAE,UAAU,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB;IAED,UAAiB,YAAY;QAC3B,MAAM,EAAE,SAAS,CAAC;KACnB;IAED,UAAiB,YAAY;QAC3B,MAAM,EAAE,SAAS,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;KACtB;CACF;AA0BD,wBAAsB,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3C,IAAI,EAAE,OAAO,CAAC,IAAI,GACjB,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAiFxC;AAED,eAAO,MAAM,OAAO,EAAE,aAA2B,CAAC"}

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

@@ -0,0 +1,101 @@
+import { toJson } from "../json.js";
+import { abortRawResponse, toRawResponse, unknownRawResponse, } from "./RawResponse.js";
+import { Supplier } from "./Supplier.js";
+import { createRequestUrl } from "./createRequestUrl.js";
+import { getErrorResponseBody } from "./getErrorResponseBody.js";
+import { getFetchFn } from "./getFetchFn.js";
+import { getRequestBody } from "./getRequestBody.js";
+import { getResponseBody } from "./getResponseBody.js";
+import { makeRequest } from "./makeRequest.js";
+import { requestWithRetries } from "./requestWithRetries.js";
+async function getHeaders(args) {
+    const newHeaders = {};
+    if (args.body !== undefined && args.contentType != null) {
+        newHeaders["Content-Type"] = args.contentType;
+    }
+    if (args.headers == null) {
+        return newHeaders;
+    }
+    for (const [key, value] of Object.entries(args.headers)) {
+        const result = await Supplier.get(value);
+        if (typeof result === "string") {
+            newHeaders[key] = result;
+            continue;
+        }
+        if (result == null) {
+            continue;
+        }
+        newHeaders[key] = `${result}`;
+    }
+    return newHeaders;
+}
+export async function fetcherImpl(args) {
+    const url = createRequestUrl(args.url, args.queryParameters);
+    const requestBody = await getRequestBody({
+        body: args.body,
+        type: args.requestType === "json" ? "json" : "other",
+    });
+    const fetchFn = await getFetchFn();
+    try {
+        const response = await requestWithRetries(async () => makeRequest(fetchFn, url, args.method, await getHeaders(args), requestBody, args.timeoutMs, args.abortSignal, args.withCredentials, args.duplex), args.maxRetries);
+        if (response.status >= 200 && response.status < 400) {
+            return {
+                ok: true,
+                body: (await getResponseBody(response, args.responseType)),
+                headers: response.headers,
+                rawResponse: toRawResponse(response),
+            };
+        }
+        else {
+            return {
+                ok: false,
+                error: {
+                    reason: "status-code",
+                    statusCode: response.status,
+                    body: await getErrorResponseBody(response),
+                },
+                rawResponse: toRawResponse(response),
+            };
+        }
+    }
+    catch (error) {
+        if (args.abortSignal != null && args.abortSignal.aborted) {
+            return {
+                ok: false,
+                error: {
+                    reason: "unknown",
+                    errorMessage: "The user aborted a request",
+                },
+                rawResponse: abortRawResponse,
+            };
+        }
+        else if (error instanceof Error && error.name === "AbortError") {
+            return {
+                ok: false,
+                error: {
+                    reason: "timeout",
+                },
+                rawResponse: abortRawResponse,
+            };
+        }
+        else if (error instanceof Error) {
+            return {
+                ok: false,
+                error: {
+                    reason: "unknown",
+                    errorMessage: error.message,
+                },
+                rawResponse: unknownRawResponse,
+            };
+        }
+        return {
+            ok: false,
+            error: {
+                reason: "unknown",
+                errorMessage: toJson(error),
+            },
+            rawResponse: unknownRawResponse,
+        };
+    }
+}
+export const fetcher = fetcherImpl;

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

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

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

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

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

@@ -0,0 +1,82 @@
+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 };

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

@@ -0,0 +1,59 @@
+import { 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/api/core/fetcher/HttpResponsePromise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpResponsePromise.d.ts","sourceRoot":"","sources":["../../../../src/api/core/fetcher/HttpResponsePromise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,qBAAa,mBAAmB,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,gBAAgB,CAAyB;IAEjD,OAAO;IAQP;;;;;;OAMG;WACW,YAAY,CACxB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAC3D,CAAC,EACD,EAAE,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC;IAIxD;;;;;OAKG;WACW,iBAAiB,CAC7B,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,EAClC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,mBAAmB,CAAC,CAAC,CAAC;IAM5D;;;;;OAKG;WACW,WAAW,CAAC,CAAC,EACzB,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GACnC,mBAAmB,CAAC,CAAC,CAAC;IAIzB;;;;;OAKG;WACW,YAAY,CAAC,CAAC,EAC1B,QAAQ,EAAE,CACR,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,EAC5C,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,KAC/B,IAAI,GACR,mBAAmB,CAAC,CAAC,CAAC;IAKzB;;;;;OAKG;WACW,UAAU,CAAC,CAAC,EACxB,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,mBAAmB,CAAC,CAAC,CAAC;IAKzB,OAAO,CAAC,MAAM;IAOd,kBAAkB;IACF,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EACjD,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,GAC1E,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAI/B,kBAAkB;IACF,KAAK,CAAC,OAAO,GAAG,KAAK,EACnC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACxE,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;CAG5D"}

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

@@ -0,0 +1,88 @@
+/**
+ * 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;
+    }
+}

package/dist/api/core/fetcher/RawResponse.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The raw response from the fetch call excluding the body.
+ */
+export type RawResponse = Omit<{
+    [K in keyof Response as Response[K] extends Function ? never : K]: Response[K];
+}, "ok" | "body" | "bodyUsed">;
+/**
+ * A raw response indicating that the request was aborted.
+ */
+export declare const abortRawResponse: RawResponse;
+/**
+ * A raw response indicating an unknown error.
+ */
+export declare const unknownRawResponse: RawResponse;
+/**
+ * Converts a `RawResponse` object into a `RawResponse` by extracting its properties,
+ * excluding the `body` and `bodyUsed` fields.
+ *
+ * @param response - The `RawResponse` object to convert.
+ * @returns A `RawResponse` object containing the extracted properties of the input response.
+ */
+export declare function toRawResponse(response: Response): RawResponse;
+/**
+ * Creates a `RawResponse` from a standard `Response` object.
+ */
+export interface WithRawResponse<T> {
+    readonly data: T;
+    readonly rawResponse: RawResponse;
+}
+//# sourceMappingURL=RawResponse.d.ts.map

package/dist/api/core/fetcher/RawResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RawResponse.d.ts","sourceRoot":"","sources":["../../../../src/api/core/fetcher/RawResponse.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B;KACG,CAAC,IAAI,MAAM,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,QAAQ,GAChD,KAAK,GACL,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;CACpB,EACD,IAAI,GAAG,MAAM,GAAG,UAAU,CAC3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAOrB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAOvB,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAS7D;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC"}