@credal/sdk 0.0.30 → 0.1.1

package/dist/esm/api/resources/permissionsService/types/index.mjs

@@ -0,0 +1,10 @@
+export * from "./Group.mjs";
+export * from "./User.mjs";
+export * from "./Principal.mjs";
+export * from "./AuthorizedResource.mjs";
+export * from "./AuthorizedResourceListPage.mjs";
+export * from "./PrincipalListPage.mjs";
+export * from "./CheckResourceAuthorizationResponse.mjs";
+export * from "./ResourceAuthorizationResult.mjs";
+export * from "./CheckBulkResourcesAuthorizationResponse.mjs";
+export * from "./Action.mjs";

package/dist/esm/api/resources/search/client/Client.d.mts

@@ -0,0 +1,62 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Credal from "../../../index.mjs";
+export declare namespace Search {
+    interface Options {
+        environment?: core.Supplier<environments.CredalEnvironment | string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        apiKey?: core.Supplier<core.BearerToken | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional query string parameters to include in the request. */
+        queryParams?: Record<string, unknown>;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+}
+export declare class Search {
+    protected readonly _options: Search.Options;
+    constructor(_options?: Search.Options);
+    /**
+     * Search across all documents in a document collection using the document metadata and contents.
+     *
+     * @param {Credal.SearchDocumentCollectionRequest} request
+     * @param {Search.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.search.searchDocumentCollection({
+     *         collectionId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
+     *         searchQuery: "ABC Corp",
+     *         structuredQueryFilters: [{
+     *                 field: "status",
+     *                 operator: "==",
+     *                 value: "Open"
+     *             }],
+     *         userEmail: "jack@credal.ai",
+     *         searchOptions: {
+     *             maxChunks: 10,
+     *             mergeContents: true,
+     *             threshold: 0.8,
+     *             enableSmartFiltering: true,
+     *             enableQueryExtraction: true,
+     *             enableReranking: true
+     *         }
+     *     })
+     */
+    searchDocumentCollection(request: Credal.SearchDocumentCollectionRequest, requestOptions?: Search.RequestOptions): core.HttpResponsePromise<Credal.SearchDocumentCollectionResponse>;
+    private __searchDocumentCollection;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/dist/esm/api/resources/search/client/Client.mjs

@@ -0,0 +1,107 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as errors from "../../../../errors/index.mjs";
+export class Search {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    /**
+     * Search across all documents in a document collection using the document metadata and contents.
+     *
+     * @param {Credal.SearchDocumentCollectionRequest} request
+     * @param {Search.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.search.searchDocumentCollection({
+     *         collectionId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
+     *         searchQuery: "ABC Corp",
+     *         structuredQueryFilters: [{
+     *                 field: "status",
+     *                 operator: "==",
+     *                 value: "Open"
+     *             }],
+     *         userEmail: "jack@credal.ai",
+     *         searchOptions: {
+     *             maxChunks: 10,
+     *             mergeContents: true,
+     *             threshold: 0.8,
+     *             enableSmartFiltering: true,
+     *             enableQueryExtraction: true,
+     *             enableReranking: true
+     *         }
+     *     })
+     */
+    searchDocumentCollection(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__searchDocumentCollection(request, requestOptions));
+    }
+    __searchDocumentCollection(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CredalEnvironment.Production, "/v0/search/searchDocumentCollection"),
+                method: "POST",
+                headers: mergeHeaders((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.CredalError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                    rawResponse: _response.rawResponse,
+                });
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.CredalError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.CredalTimeoutError("Timeout exceeded when calling POST /v0/search/searchDocumentCollection.");
+                case "unknown":
+                    throw new errors.CredalError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const bearer = (_a = (yield core.Supplier.get(this._options.apiKey))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env["CREDAL_API_KEY"];
+            if (bearer == null) {
+                throw new errors.CredalError({
+                    message: "Please specify a bearer by either passing it in to the constructor or initializing a CREDAL_API_KEY environment variable",
+                });
+            }
+            return `Bearer ${bearer}`;
+        });
+    }
+}

package/dist/esm/api/resources/search/client/index.d.mts

@@ -0,0 +1,2 @@
+export {};
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/search/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/search/client/requests/SearchDocumentCollectionRequest.d.mts

@@ -0,0 +1,36 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Credal from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         collectionId: "82e4b12a-6990-45d4-8ebd-85c00e030c24",
+ *         searchQuery: "ABC Corp",
+ *         structuredQueryFilters: [{
+ *                 field: "status",
+ *                 operator: "==",
+ *                 value: "Open"
+ *             }],
+ *         userEmail: "jack@credal.ai",
+ *         searchOptions: {
+ *             maxChunks: 10,
+ *             mergeContents: true,
+ *             threshold: 0.8,
+ *             enableSmartFiltering: true,
+ *             enableQueryExtraction: true,
+ *             enableReranking: true
+ *         }
+ *     }
+ */
+export interface SearchDocumentCollectionRequest {
+    collectionId: string;
+    searchQuery: string;
+    /** The email of the user making the search request for permissions reduction. */
+    userEmail: string;
+    /** The structured query filters to apply to the search query. */
+    structuredQueryFilters?: Credal.SingleFieldFilter[];
+    searchOptions?: Credal.DocumentCollectionSearchOptions;
+    /** Legacy metadata filter expression to apply to the search query. Use structuredQueryFilters instead. */
+    metadataFilterExpression?: string;
+}

package/dist/esm/api/resources/search/client/requests/SearchDocumentCollectionRequest.mjs

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

package/dist/esm/api/resources/search/client/requests/index.d.mts

@@ -0,0 +1 @@
+export { type SearchDocumentCollectionRequest } from "./SearchDocumentCollectionRequest.mjs";

package/dist/esm/api/resources/search/client/requests/index.mjs

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

package/dist/esm/api/resources/search/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./types/index.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/search/index.mjs

@@ -0,0 +1,2 @@
+export * from "./types/index.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/search/types/DocumentCollectionSearchOptions.mjs

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

package/dist/esm/api/resources/search/types/DocumentCollectionSearchResult.d.mts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Credal from "../../../index.mjs";
+export interface DocumentCollectionSearchResult {
+    documentId: string;
+    documentName: string;
+    documentUrl: string;
+    documentExternalId: string;
+    documentMetadata: Record<string, string>;
+    chunks: Credal.SearchResultChunk[];
+    mergedContents?: string;
+}

package/dist/esm/api/resources/search/types/DocumentCollectionSearchResult.mjs

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

package/dist/esm/api/resources/search/types/SearchDocumentCollectionResponse.d.mts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Credal from "../../../index.mjs";
+export interface SearchDocumentCollectionResponse {
+    searchTermsUsed: string[];
+    structuredFiltersApplied: Credal.SingleFieldFilter[];
+    searchId: string;
+    results: Credal.DocumentCollectionSearchResult[];
+}

package/dist/esm/api/resources/search/types/SearchDocumentCollectionResponse.mjs

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

package/dist/esm/api/resources/search/types/SearchResultChunk.mjs

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

package/dist/esm/api/resources/search/types/SingleFieldFilter.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Credal from "../../../index.mjs";
+export interface SingleFieldFilter {
+    field: string;
+    operator: Credal.Operator;
+    value: string;
+}

package/dist/esm/api/resources/search/types/SingleFieldFilter.mjs

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

package/dist/esm/api/resources/search/types/index.d.mts

@@ -0,0 +1,5 @@
+export * from "./DocumentCollectionSearchOptions.mjs";
+export * from "./SearchDocumentCollectionResponse.mjs";
+export * from "./DocumentCollectionSearchResult.mjs";
+export * from "./SearchResultChunk.mjs";
+export * from "./SingleFieldFilter.mjs";

package/dist/esm/api/resources/search/types/index.mjs

@@ -0,0 +1,5 @@
+export * from "./DocumentCollectionSearchOptions.mjs";
+export * from "./SearchDocumentCollectionResponse.mjs";
+export * from "./DocumentCollectionSearchResult.mjs";
+export * from "./SearchResultChunk.mjs";
+export * from "./SingleFieldFilter.mjs";

package/dist/esm/api/resources/users/client/Client.d.mts

@@ -0,0 +1,57 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Credal from "../../../index.mjs";
+export declare namespace Users {
+    interface Options {
+        environment?: core.Supplier<environments.CredalEnvironment | string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        apiKey?: core.Supplier<core.BearerToken | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        fetcher?: core.FetchFunction;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional query string parameters to include in the request. */
+        queryParams?: Record<string, unknown>;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+    }
+}
+export declare class Users {
+    protected readonly _options: Users.Options;
+    constructor(_options?: Users.Options);
+    /**
+     * Bulk patch metadata for users
+     *
+     * @param {Credal.UserMetadataPatch[]} request
+     * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.users.metadata([{
+     *             metadata: {
+     *                 "State": "NY",
+     *                 "Job Role": "CEO"
+     *             },
+     *             userEmail: "ravin@credal.ai"
+     *         }, {
+     *             metadata: {
+     *                 "State": "NY",
+     *                 "Department": "Engineering"
+     *             },
+     *             userEmail: "jack@credal.ai"
+     *         }])
+     */
+    metadata(request: Credal.UserMetadataPatch[], requestOptions?: Users.RequestOptions): core.HttpResponsePromise<void>;
+    private __metadata;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/dist/esm/api/resources/users/client/Client.mjs

@@ -0,0 +1,99 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as errors from "../../../../errors/index.mjs";
+export class Users {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    /**
+     * Bulk patch metadata for users
+     *
+     * @param {Credal.UserMetadataPatch[]} request
+     * @param {Users.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.users.metadata([{
+     *             metadata: {
+     *                 "State": "NY",
+     *                 "Job Role": "CEO"
+     *             },
+     *             userEmail: "ravin@credal.ai"
+     *         }, {
+     *             metadata: {
+     *                 "State": "NY",
+     *                 "Department": "Engineering"
+     *             },
+     *             userEmail: "jack@credal.ai"
+     *         }])
+     */
+    metadata(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__metadata(request, requestOptions));
+    }
+    __metadata(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const _response = yield ((_a = this._options.fetcher) !== null && _a !== void 0 ? _a : core.fetcher)({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.CredalEnvironment.Production, "/v0/users/metadata"),
+                method: "PATCH",
+                headers: mergeHeaders((_d = this._options) === null || _d === void 0 ? void 0 : _d.headers, mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers),
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: undefined, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                throw new errors.CredalError({
+                    statusCode: _response.error.statusCode,
+                    body: _response.error.body,
+                    rawResponse: _response.rawResponse,
+                });
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.CredalError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.CredalTimeoutError("Timeout exceeded when calling PATCH /v0/users/metadata.");
+                case "unknown":
+                    throw new errors.CredalError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const bearer = (_a = (yield core.Supplier.get(this._options.apiKey))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env["CREDAL_API_KEY"];
+            if (bearer == null) {
+                throw new errors.CredalError({
+                    message: "Please specify a bearer by either passing it in to the constructor or initializing a CREDAL_API_KEY environment variable",
+                });
+            }
+            return `Bearer ${bearer}`;
+        });
+    }
+}

package/dist/esm/api/resources/users/client/index.d.mts

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

package/dist/esm/api/resources/users/client/index.mjs

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

package/dist/esm/api/resources/users/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./types/index.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/users/index.mjs

@@ -0,0 +1,2 @@
+export * from "./types/index.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/users/types/UserMetadataPatch.mjs

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

package/dist/esm/api/resources/users/types/index.d.mts

@@ -0,0 +1 @@
+export * from "./UserMetadataPatch.mjs";

package/dist/esm/api/resources/users/types/index.mjs

@@ -0,0 +1 @@
+export * from "./UserMetadataPatch.mjs";

package/dist/esm/core/auth/BasicAuth.mjs

@@ -0,0 +1,23 @@
+import { base64Decode, base64Encode } from "../base64.mjs";
+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/esm/core/auth/BearerToken.mjs

@@ -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/esm/core/auth/index.d.mts

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

package/dist/esm/core/auth/index.mjs

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

package/dist/esm/core/base64.d.mts

@@ -0,0 +1,2 @@
+export declare function base64Encode(input: string): string;
+export declare function base64Decode(input: string): string;

package/dist/esm/core/base64.mjs

@@ -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/esm/core/fetcher/APIResponse.d.mts

@@ -0,0 +1,20 @@
+import { RawResponse } from "./RawResponse.mjs";
+/**
+ * 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;
+}

package/dist/esm/core/fetcher/APIResponse.mjs

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

package/dist/esm/core/fetcher/BinaryResponse.d.mts

@@ -0,0 +1,20 @@
+import { ResponseWithBody } from "./ResponseWithBody.mjs";
+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;

package/dist/esm/core/fetcher/BinaryResponse.mjs

@@ -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;
+}