@humeai/audio-decisions 0.0.1 → 0.1.0

package/dist/esm/audio-helpers/wav.mjs

@@ -0,0 +1,161 @@
+// Maintained by hand and listed in .fernignore, so SDK regeneration leaves it in place.
+import { dataView, hasBytes, writeAscii } from "./bytes.mjs";
+import { UnsupportedAudioError } from "./errors.mjs";
+const CONVERT_COMMAND = "ffmpeg -i input.wav -c:a pcm_s16le output.wav";
+const PCM = 0x0001;
+const IEEE_FLOAT = 0x0003;
+const EXTENSIBLE = 0xfffe;
+// An extensible header's subformat GUID is the format tag it stands for followed by these bytes.
+const SUBFORMAT_GUID_SUFFIX = [0x00, 0x00, 0x00, 0x00, 0x10, 0x00, 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71];
+// Writers that cannot seek back to fill in the size, such as ffmpeg writing to a pipe, leave this.
+const UNKNOWN_SIZE = 0xffffffff;
+const SAMPLE_WIDTHS = {
+    [PCM]: [1, 2, 3, 4],
+    [IEEE_FLOAT]: [4, 8],
+};
+const EXTENSIBLE_FMT_BYTES = 40;
+// Chunks are at least 1 ms long, so at this rate every chunk holds at least one sample.
+const MIN_SAMPLE_RATE = 1000;
+// The resampling filter grows with the sample rate, so without a limit a few bytes of header could
+// demand gigabytes. No recording format in common use goes above this rate.
+const MAX_SAMPLE_RATE = 768000;
+export function isWav(data) {
+    return hasBytes(data, 0, "RIFF") || hasBytes(data, 0, "RF64");
+}
+export function parseWav(data) {
+    if (hasBytes(data, 0, "RF64")) {
+        throw unsupported("RF64 files are not supported");
+    }
+    if (data.length < 12 || !hasBytes(data, 0, "RIFF") || !hasBytes(data, 8, "WAVE")) {
+        throw unsupported("no RIFF WAVE header");
+    }
+    const view = dataView(data);
+    const riffSize = view.getUint32(4, true);
+    let offset = 12;
+    let format;
+    for (;;) {
+        if (offset + 8 > data.length) {
+            throw unsupported("no data chunk");
+        }
+        const isData = hasBytes(data, offset, "data");
+        const isFmt = hasBytes(data, offset, "fmt ");
+        let size = view.getUint32(offset + 4, true);
+        offset += 8;
+        if (isData) {
+            if (format === undefined) {
+                throw unsupported("the data chunk comes before the fmt chunk");
+            }
+            const available = data.length - offset;
+            // Writers such as libsndfile fill in the sizes only when they close the file, so a recording
+            // that was never closed declares no audio in a RIFF chunk that ends before it. Any other file
+            // that declares no audio has none, including one whose RIFF size is unknown, because chunks
+            // such as metadata can follow the data.
+            const unclosed = size === 0 && 8 + riffSize <= offset;
+            // A file cut short is read as far as it goes, up to its last whole sample.
+            size = unclosed || size === UNKNOWN_SIZE ? available : Math.min(size, available);
+            return Object.assign(Object.assign({}, format), { dataStart: offset, sampleCount: Math.floor(size / format.frameBytes) });
+        }
+        if (isFmt) {
+            format = parseFormat(data.subarray(offset, offset + Math.min(size, EXTENSIBLE_FMT_BYTES)));
+        }
+        // Chunks with an odd size are followed by a padding byte.
+        offset += size + (size % 2);
+    }
+}
+/** Describes samples that start at offset 0 of their own buffer. */
+export function samplesWav({ channels, sampleRate, sampleWidth, isFloat, sampleCount, }) {
+    const fmt = fmtBody(isFloat ? IEEE_FLOAT : PCM, channels, sampleRate, sampleWidth, sampleWidth * 8, new Uint8Array(0));
+    return {
+        fmt,
+        channels,
+        channelMask: 0,
+        sampleRate,
+        sampleWidth,
+        isFloat,
+        dataStart: 0,
+        sampleCount,
+        frameBytes: sampleWidth * channels,
+    };
+}
+/** Builds a WAV file holding samples `start` to `end` and none of the source's other chunks. */
+export function wavChunk(data, wav, start, end) {
+    const first = wav.dataStart + start * wav.frameBytes;
+    const size = (end - start) * wav.frameBytes;
+    const padding = size % 2;
+    const headerBytes = 12 + 8 + wav.fmt.length + 8;
+    const chunk = new Uint8Array(headerBytes + size + padding);
+    const view = dataView(chunk);
+    writeAscii(chunk, 0, "RIFF");
+    view.setUint32(4, headerBytes - 8 + size + padding, true);
+    writeAscii(chunk, 8, "WAVEfmt ");
+    view.setUint32(16, wav.fmt.length, true);
+    chunk.set(wav.fmt, 20);
+    writeAscii(chunk, 20 + wav.fmt.length, "data");
+    view.setUint32(24 + wav.fmt.length, size, true);
+    chunk.set(data.subarray(first, first + size), headerBytes);
+    return chunk;
+}
+function parseFormat(body) {
+    if (body.length < 16) {
+        throw unsupported("the fmt chunk is too short");
+    }
+    const view = dataView(body);
+    const headerTag = view.getUint16(0, true);
+    const channels = view.getUint16(2, true);
+    const sampleRate = view.getUint32(4, true);
+    const blockAlign = view.getUint16(12, true);
+    const bits = view.getUint16(14, true);
+    let tag = headerTag;
+    if (tag === EXTENSIBLE) {
+        if (body.length < EXTENSIBLE_FMT_BYTES ||
+            SUBFORMAT_GUID_SUFFIX.some((byte, index) => body[26 + index] !== byte)) {
+            throw unsupported("unknown extensible subformat");
+        }
+        tag = view.getUint16(24, true);
+    }
+    const widths = SAMPLE_WIDTHS[tag];
+    if (widths === undefined) {
+        throw unsupported(`format tag 0x${tag.toString(16).toUpperCase().padStart(4, "0")} is compressed or unknown`);
+    }
+    const sampleWidth = (bits + 7) >> 3;
+    if (!widths.includes(sampleWidth) || (tag === IEEE_FLOAT && bits !== sampleWidth * 8)) {
+        throw unsupported(`${bits}-bit ${tag === PCM ? "PCM" : "floating point"}`);
+    }
+    // Some writers leave the block size at 0 or 1, so it is recomputed for the chunks. A block larger
+    // than one sample per channel means padded samples, which would be cut in the wrong places. The
+    // recomputed block size must fit the header's 16 bits, and the byte rate its 32 bits.
+    const frameBytes = sampleWidth * channels;
+    if (channels < 1 || blockAlign > frameBytes || frameBytes > 0xffff || sampleRate * frameBytes > 0xffffffff) {
+        throw unsupported("the fmt chunk is inconsistent");
+    }
+    if (sampleRate < MIN_SAMPLE_RATE) {
+        throw unsupported(`${sampleRate} Hz is below the minimum of ${MIN_SAMPLE_RATE} Hz`);
+    }
+    if (sampleRate > MAX_SAMPLE_RATE) {
+        throw unsupported(`${sampleRate} Hz is above the maximum of ${MAX_SAMPLE_RATE} Hz`);
+    }
+    const extension = headerTag === EXTENSIBLE ? body.subarray(16, EXTENSIBLE_FMT_BYTES) : new Uint8Array(0);
+    const fmt = fmtBody(headerTag, channels, sampleRate, sampleWidth, bits, extension);
+    const channelMask = headerTag === EXTENSIBLE ? view.getUint32(20, true) : 0;
+    return { fmt, channels, channelMask, sampleRate, sampleWidth, isFloat: tag === IEEE_FLOAT, frameBytes };
+}
+function fmtBody(headerTag, channels, sampleRate, sampleWidth, bits, extension) {
+    const frameBytes = sampleWidth * channels;
+    // Formats other than PCM declare the size of their header extension, which is empty here.
+    const extensionBytes = headerTag === EXTENSIBLE ? extension.length : headerTag === PCM ? 0 : 2;
+    const fmt = new Uint8Array(16 + extensionBytes);
+    const view = dataView(fmt);
+    view.setUint16(0, headerTag, true);
+    view.setUint16(2, channels, true);
+    view.setUint32(4, sampleRate, true);
+    view.setUint32(8, sampleRate * frameBytes, true);
+    view.setUint16(12, frameBytes, true);
+    view.setUint16(14, bits, true);
+    if (headerTag === EXTENSIBLE) {
+        fmt.set(extension, 16);
+    }
+    return fmt;
+}
+function unsupported(reason) {
+    return new UnsupportedAudioError(`The audio is not a supported WAV file (${reason}). Convert it first, for example with: ${CONVERT_COMMAND}`);
+}

package/dist/esm/auth/HeaderAuthProvider.d.mts

@@ -0,0 +1,20 @@
+import * as core from "../core/index.mjs";
+declare const PARAM_KEY: "apiKey";
+export declare class HeaderAuthProvider implements core.AuthProvider {
+    private readonly options;
+    constructor(options: HeaderAuthProvider.Options);
+    static canCreate(options: Partial<HeaderAuthProvider.Options>): boolean;
+    getAuthRequest({ endpointMetadata, }?: {
+        endpointMetadata?: core.EndpointMetadata;
+    }): Promise<core.AuthRequest>;
+}
+export declare namespace HeaderAuthProvider {
+    const AUTH_SCHEME: "ApiKey";
+    const AUTH_CONFIG_ERROR_MESSAGE: string;
+    type Options = AuthOptions;
+    type AuthOptions = {
+        [PARAM_KEY]?: core.Supplier<string> | undefined;
+    };
+    function createInstance(options: Options): core.AuthProvider;
+}
+export {};

package/dist/esm/auth/HeaderAuthProvider.mjs

@@ -0,0 +1,46 @@
+// 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 core from "../core/index.mjs";
+import * as errors from "../errors/index.mjs";
+const PARAM_KEY = "apiKey";
+const ENV_HEADER_KEY = "HUME_API_KEY";
+const HEADER_NAME = "X-Hume-Api-Key";
+export class HeaderAuthProvider {
+    constructor(options) {
+        this.options = options;
+    }
+    static canCreate(options) {
+        var _a;
+        return (options === null || options === void 0 ? void 0 : options[PARAM_KEY]) != null || ((_a = process.env) === null || _a === void 0 ? void 0 : _a[ENV_HEADER_KEY]) != null;
+    }
+    getAuthRequest() {
+        return __awaiter(this, arguments, void 0, function* ({ endpointMetadata, } = {}) {
+            var _a, _b;
+            const headerValue = (_a = (yield core.Supplier.get(this.options[PARAM_KEY]))) !== null && _a !== void 0 ? _a : (_b = process.env) === null || _b === void 0 ? void 0 : _b[ENV_HEADER_KEY];
+            if (headerValue == null) {
+                throw new errors.DecisionsError({
+                    message: HeaderAuthProvider.AUTH_CONFIG_ERROR_MESSAGE,
+                });
+            }
+            return {
+                headers: { [HEADER_NAME]: headerValue },
+            };
+        });
+    }
+}
+(function (HeaderAuthProvider) {
+    HeaderAuthProvider.AUTH_SCHEME = "ApiKey";
+    HeaderAuthProvider.AUTH_CONFIG_ERROR_MESSAGE = `Please provide '${PARAM_KEY}' when initializing the client, or set the '${ENV_HEADER_KEY}' environment variable`;
+    function createInstance(options) {
+        return new HeaderAuthProvider(options);
+    }
+    HeaderAuthProvider.createInstance = createInstance;
+})(HeaderAuthProvider || (HeaderAuthProvider = {}));

package/dist/esm/auth/index.d.mts

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

package/dist/esm/auth/index.mjs

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

package/dist/esm/core/auth/AuthProvider.d.mts

@@ -0,0 +1,8 @@
+import type { EndpointMetadata } from "../fetcher/EndpointMetadata.mjs";
+import type { AuthRequest } from "./AuthRequest.mjs";
+export interface AuthProvider {
+    getAuthRequest(arg?: {
+        endpointMetadata?: EndpointMetadata;
+    }): Promise<AuthRequest>;
+}
+export declare function isAuthProvider(value: unknown): value is AuthProvider;

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

@@ -0,0 +1,6 @@
+export function isAuthProvider(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "getAuthRequest" in value &&
+        typeof value.getAuthRequest === "function");
+}

package/dist/esm/core/auth/AuthRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Request parameters for authentication requests.
+ */
+export interface AuthRequest {
+    /**
+     * The headers to be included in the request.
+     */
+    headers: Record<string, string>;
+}

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

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

package/dist/esm/core/auth/BasicAuth.d.mts

@@ -0,0 +1,8 @@
+export interface BasicAuth {
+    username?: string;
+    password?: string;
+}
+export declare const BasicAuth: {
+    toAuthorizationHeader: (basicAuth: BasicAuth | undefined) => string | undefined;
+    fromAuthorizationHeader: (header: string) => BasicAuth;
+};

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

@@ -0,0 +1,30 @@
+import { base64Decode, base64Encode } from "../base64.mjs";
+const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
+export const BasicAuth = {
+    toAuthorizationHeader: (basicAuth) => {
+        var _a, _b;
+        if (basicAuth == null) {
+            return undefined;
+        }
+        const username = (_a = basicAuth.username) !== null && _a !== void 0 ? _a : "";
+        const password = (_b = basicAuth.password) !== null && _b !== void 0 ? _b : "";
+        if (username === "" && password === "") {
+            return undefined;
+        }
+        const token = base64Encode(`${username}:${password}`);
+        return `Basic ${token}`;
+    },
+    fromAuthorizationHeader: (header) => {
+        const credentials = header.replace(BASIC_AUTH_HEADER_PREFIX, "");
+        const decoded = base64Decode(credentials);
+        const [username, ...passwordParts] = decoded.split(":");
+        const password = passwordParts.length > 0 ? passwordParts.join(":") : undefined;
+        if (username == null || password == null) {
+            throw new Error("Invalid basic auth");
+        }
+        return {
+            username,
+            password,
+        };
+    },
+};

package/dist/esm/core/auth/BearerToken.d.mts

@@ -0,0 +1,7 @@
+export type BearerToken = string;
+declare function toAuthorizationHeader(token: string | undefined): string | undefined;
+export declare const BearerToken: {
+    toAuthorizationHeader: typeof toAuthorizationHeader;
+    fromAuthorizationHeader: (header: string) => BearerToken;
+};
+export {};

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

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

package/dist/esm/core/auth/NoOpAuthProvider.d.mts

@@ -0,0 +1,5 @@
+import type { AuthProvider } from "./AuthProvider.mjs";
+import type { AuthRequest } from "./AuthRequest.mjs";
+export declare class NoOpAuthProvider implements AuthProvider {
+    getAuthRequest(): Promise<AuthRequest>;
+}

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

@@ -0,0 +1,5 @@
+export class NoOpAuthProvider {
+    getAuthRequest() {
+        return Promise.resolve({ headers: {} });
+    }
+}

package/dist/esm/core/auth/index.d.mts

@@ -0,0 +1,5 @@
+export { type AuthProvider, isAuthProvider } from "./AuthProvider.mjs";
+export type { AuthRequest } from "./AuthRequest.mjs";
+export { BasicAuth } from "./BasicAuth.mjs";
+export { BearerToken } from "./BearerToken.mjs";
+export { NoOpAuthProvider } from "./NoOpAuthProvider.mjs";

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

@@ -0,0 +1,4 @@
+export { isAuthProvider } from "./AuthProvider.mjs";
+export { BasicAuth } from "./BasicAuth.mjs";
+export { BearerToken } from "./BearerToken.mjs";
+export { NoOpAuthProvider } from "./NoOpAuthProvider.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/exports.d.mts

@@ -0,0 +1,2 @@
+export * from "./file/exports.mjs";
+export * from "./logging/exports.mjs";

package/dist/esm/core/exports.mjs

@@ -0,0 +1,2 @@
+export * from "./file/exports.mjs";
+export * from "./logging/exports.mjs";

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

@@ -0,0 +1,20 @@
+import type { 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,19 @@
+export type BinaryResponse = {
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */
+    bodyUsed: Response["bodyUsed"];
+    /**
+     * Returns a ReadableStream of the response body.
+     * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body)
+     */
+    stream: () => Response["body"];
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */
+    arrayBuffer: () => ReturnType<Response["arrayBuffer"]>;
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */
+    blob: () => ReturnType<Response["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: Response): 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;
+}

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

@@ -0,0 +1,13 @@
+export type SecuritySchemeKey = string;
+/**
+ * A collection of security schemes, where the key is the name of the security scheme and the value is the list of scopes required for that scheme.
+ * All schemes in the collection must be satisfied for authentication to be successful.
+ */
+export type SecuritySchemeCollection = Record<SecuritySchemeKey, AuthScope[]>;
+export type AuthScope = string;
+export type EndpointMetadata = {
+    /**
+     * An array of security scheme collections. Each collection represents an alternative way to authenticate.
+     */
+    security?: SecuritySchemeCollection[];
+};

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

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

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

@@ -0,0 +1,12 @@
+import type { EndpointMetadata } from "./EndpointMetadata.mjs";
+import type { Supplier } from "./Supplier.mjs";
+type EndpointSupplierFn<T> = (arg: {
+    endpointMetadata?: EndpointMetadata;
+}) => T | Promise<T>;
+export type EndpointSupplier<T> = Supplier<T> | EndpointSupplierFn<T>;
+export declare const EndpointSupplier: {
+    get: <T>(supplier: EndpointSupplier<T>, arg: {
+        endpointMetadata?: EndpointMetadata;
+    }) => Promise<T>;
+};
+export {};

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

@@ -0,0 +1,19 @@
+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());
+    });
+};
+export const EndpointSupplier = {
+    get: (supplier, arg) => __awaiter(void 0, void 0, void 0, function* () {
+        if (typeof supplier === "function") {
+            return supplier(arg);
+        }
+        else {
+            return supplier;
+        }
+    }),
+};

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

@@ -0,0 +1,56 @@
+import { type LogConfig, type Logger } from "../logging/logger.mjs";
+import type { APIResponse } from "./APIResponse.mjs";
+import type { EndpointMetadata } from "./EndpointMetadata.mjs";
+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, unknown>;
+        /**
+         * @deprecated Prefer `queryString` (produced by `core.url.queryBuilder()`).
+         * Retained for backwards compatibility with custom fetchers and callers that
+         * still construct request args with a query-parameter object.
+         */
+        queryParameters?: Record<string, unknown>;
+        queryString?: string;
+        body?: unknown;
+        timeoutMs?: number;
+        maxRetries?: number;
+        withCredentials?: boolean;
+        abortSignal?: AbortSignal;
+        requestType?: "json" | "file" | "bytes" | "form" | "other";
+        responseType?: "json" | "blob" | "sse" | "streaming" | "text" | "arrayBuffer" | "binary-response";
+        duplex?: "half";
+        endpointMetadata?: EndpointMetadata;
+        fetchFn?: typeof fetch;
+        logging?: LogConfig | Logger;
+    }
+    type Error = FailedStatusCodeError | NonJsonError | BodyIsNullError | TimeoutError | UnknownError;
+    interface FailedStatusCodeError {
+        reason: "status-code";
+        statusCode: number;
+        body: unknown;
+    }
+    interface NonJsonError {
+        reason: "non-json";
+        statusCode: number;
+        rawBody: string;
+    }
+    interface BodyIsNullError {
+        reason: "body-is-null";
+        statusCode: number;
+    }
+    interface TimeoutError {
+        reason: "timeout";
+        cause?: unknown;
+    }
+    interface UnknownError {
+        reason: "unknown";
+        errorMessage: string;
+        cause?: unknown;
+    }
+}
+export declare function fetcherImpl<R = unknown>(args: Fetcher.Args): Promise<APIResponse<R, Fetcher.Error>>;
+export declare const fetcher: FetchFunction;