mavenagi 1.2.39 → 1.2.41

package/{dist → api/resources/voice}/exports.js

@@ -1,4 +1,5 @@
 "use strict";
+// This file was auto-generated by Fern from our API Definition.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,4 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./core/exports"), exports);
+exports.VoiceClient = void 0;
+var Client_1 = require("./client/Client");
+Object.defineProperty(exports, "VoiceClient", { enumerable: true, get: function () { return Client_1.VoiceClient; } });
+__exportStar(require("./client/index"), exports);

package/api/resources/voiceConversations/client/Client.d.ts

@@ -1,22 +1,29 @@
 import type { BaseClientOptions } from "../../../../BaseClient";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient";
 import { VoiceConversationsSocket } from "./Socket";
-export declare namespace VoiceConversations {
-    interface Options extends BaseClientOptions {
-    }
+export declare namespace VoiceConversationsClient {
+    type Options = BaseClientOptions;
     interface ConnectArgs {
-        version?: string | undefined;
+        version?: string;
         Authorization: string;
+        /** WebSocket subprotocols to use for the connection. */
+        protocols?: string | string[];
+        /** Additional query parameters to send with the websocket connect request. */
+        queryParams?: Record<string, unknown>;
         /** Arbitrary headers to send with the websocket connect request. */
         headers?: Record<string, string>;
         /** Enable debug mode on the websocket. Defaults to false. */
         debug?: boolean;
         /** Number of reconnect attempts. Defaults to 30. */
         reconnectAttempts?: number;
+        /** The timeout for establishing the WebSocket connection in seconds. */
+        connectionTimeoutInSeconds?: number;
+        /** A signal to abort the WebSocket connection. */
+        abortSignal?: AbortSignal;
     }
 }
-export declare class VoiceConversations {
-    protected readonly _options: VoiceConversations.Options;
-    constructor(_options: VoiceConversations.Options);
-    connect(args: VoiceConversations.ConnectArgs): Promise<VoiceConversationsSocket>;
-    protected _getAuthorizationHeader(): Promise<string | undefined>;
+export declare class VoiceConversationsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<VoiceConversationsClient.Options>;
+    constructor(options: VoiceConversationsClient.Options);
+    connect(args: VoiceConversationsClient.ConnectArgs): Promise<VoiceConversationsSocket>;
 }

package/api/resources/voiceConversations/client/Client.js

@@ -43,47 +43,39 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VoiceConversations = void 0;
+exports.VoiceConversationsClient = void 0;
+const BaseClient_1 = require("../../../../BaseClient");
 const core = __importStar(require("../../../../core"));
 const headers_1 = require("../../../../core/headers");
 const environments = __importStar(require("../../../../environments"));
 const Socket_1 = require("./Socket");
-class VoiceConversations {
-    constructor(_options) {
-        this._options = _options;
+class VoiceConversationsClient {
+    constructor(options) {
+        this._options = (0, BaseClient_1.normalizeClientOptionsWithAuth)(options);
     }
     connect(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            const { version, headers, debug, reconnectAttempts } = args;
-            const _queryParams = {};
-            if (version != null) {
-                _queryParams.version = version;
-            }
-            const _headers = (0, headers_1.mergeHeaders)((0, headers_1.mergeOnlyDefinedHeaders)({ Authorization: args.Authorization }), headers);
+            var _a, _b, _c;
+            const { version, protocols, queryParams, headers, debug, reconnectAttempts, connectionTimeoutInSeconds, abortSignal, } = args;
+            const _queryParams = {
+                version,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_1.mergeOnlyDefinedHeaders)({ Authorization: args.Authorization }), headers);
             const socket = new core.ReconnectingWebSocket({
-                url: core.url.join((_b = (_a = (yield core.Supplier.get(this._options.baseUrl))) !== null && _a !== void 0 ? _a : (yield core.Supplier.get(this._options.environment))) !== null && _b !== void 0 ? _b : environments.MavenAGIEnvironment.Production, "/v1/voice/conversations"),
-                protocols: [],
-                queryParameters: _queryParams,
+                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.MavenAGIEnvironment.Production, "/v1/voice/conversations"),
+                protocols: protocols !== null && protocols !== void 0 ? protocols : [],
+                queryParameters: Object.assign(Object.assign({}, _queryParams), queryParams),
                 headers: _headers,
-                options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
+                options: {
+                    debug: debug !== null && debug !== void 0 ? debug : false,
+                    maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30,
+                    connectionTimeout: connectionTimeoutInSeconds != null ? connectionTimeoutInSeconds * 1000 : undefined,
+                },
+                abortSignal: abortSignal,
             });
             return new Socket_1.VoiceConversationsSocket({ socket });
         });
     }
-    _getAuthorizationHeader() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
-            const appId = (_a = (yield core.Supplier.get(this._options.appId))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env.MAVENAGI_APP_ID;
-            const appSecret = (_b = (yield core.Supplier.get(this._options.appSecret))) !== null && _b !== void 0 ? _b : process === null || process === void 0 ? void 0 : process.env.MAVENAGI_APP_SECRET;
-            if (appId != null && appSecret != null) {
-                return core.BasicAuth.toAuthorizationHeader({
-                    username: appId,
-                    password: appSecret,
-                });
-            }
-            return undefined;
-        });
-    }
 }
-exports.VoiceConversations = VoiceConversations;
+exports.VoiceConversationsClient = VoiceConversationsClient;

package/api/resources/voiceConversations/client/Socket.d.ts

@@ -21,7 +21,7 @@ export declare class VoiceConversationsSocket {
     private handleError;
     constructor(args: VoiceConversationsSocket.Args);
     /** The current state of the connection; this is one of the readyState constants. */
-    get readyState(): number;
+    get readyState(): core.ReconnectingWebSocket.ReadyState;
     /**
      * @param event - The event to attach to.
      * @param callback - The callback to run when the event is triggered.
@@ -44,5 +44,5 @@ export declare class VoiceConversationsSocket {
     /** Asserts that the websocket is open. */
     private assertSocketIsOpen;
     /** Send a binary payload to the websocket. */
-    protected sendBinary(payload: ArrayBufferLike | Blob | ArrayBufferView): void;
+    protected sendBinary(payload: ArrayBuffer | Blob | ArrayBufferView): void;
 }

package/api/resources/voiceConversations/client/Socket.js

@@ -142,7 +142,7 @@ class VoiceConversationsSocket {
     /** Returns a promise that resolves when the websocket is open. */
     waitForOpen() {
         return __awaiter(this, void 0, void 0, function* () {
-            if (this.socket.readyState === core.ReconnectingWebSocket.OPEN) {
+            if (this.socket.readyState === core.ReconnectingWebSocket.ReadyState.OPEN) {
                 return this.socket;
             }
             return new Promise((resolve, reject) => {
@@ -160,7 +160,7 @@ class VoiceConversationsSocket {
         if (!this.socket) {
             throw new Error("Socket is not connected.");
         }
-        if (this.socket.readyState !== core.ReconnectingWebSocket.OPEN) {
+        if (this.socket.readyState !== core.ReconnectingWebSocket.ReadyState.OPEN) {
             throw new Error("Socket is not open.");
         }
     }

package/api/resources/voiceConversations/exports.d.ts

@@ -0,0 +1,3 @@
+export { VoiceConversationsClient } from "./client/Client";
+export * from "./client/index";
+export { VoiceConversationsSocket } from "./client/Socket";

package/{dist/api/resources/triggers/types/index.js → api/resources/voiceConversations/exports.js}

@@ -1,4 +1,5 @@
 "use strict";
+// This file was auto-generated by Fern from our API Definition.
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -14,10 +15,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./EventTriggerBase"), exports);
-__exportStar(require("./EventTriggerRequest"), exports);
-__exportStar(require("./EventTriggerResponse"), exports);
-__exportStar(require("./EventTriggersSearchRequest"), exports);
-__exportStar(require("./EventTriggersSearchResponse"), exports);
-__exportStar(require("./TriggerField"), exports);
-__exportStar(require("./TriggerPartialUpdate"), exports);
+exports.VoiceConversationsSocket = exports.VoiceConversationsClient = void 0;
+var Client_1 = require("./client/Client");
+Object.defineProperty(exports, "VoiceConversationsClient", { enumerable: true, get: function () { return Client_1.VoiceConversationsClient; } });
+__exportStar(require("./client/index"), exports);
+var Socket_1 = require("./client/Socket");
+Object.defineProperty(exports, "VoiceConversationsSocket", { enumerable: true, get: function () { return Socket_1.VoiceConversationsSocket; } });

package/auth/BasicAuthProvider.d.ts

@@ -0,0 +1,24 @@
+import * as core from "../core";
+declare const USERNAME_PARAM: "appId";
+declare const PASSWORD_PARAM: "appSecret";
+export declare class BasicAuthProvider implements core.AuthProvider {
+    private readonly options;
+    constructor(options: BasicAuthProvider.Options);
+    static canCreate(options: Partial<BasicAuthProvider.Options>): boolean;
+    getAuthRequest({ endpointMetadata, }?: {
+        endpointMetadata?: core.EndpointMetadata;
+    }): Promise<core.AuthRequest>;
+}
+export declare namespace BasicAuthProvider {
+    const AUTH_SCHEME: "Basic";
+    const AUTH_CONFIG_ERROR_MESSAGE: string;
+    const AUTH_CONFIG_ERROR_MESSAGE_USERNAME: string;
+    const AUTH_CONFIG_ERROR_MESSAGE_PASSWORD: string;
+    type Options = AuthOptions;
+    type AuthOptions = {
+        [USERNAME_PARAM]?: core.Supplier<string> | undefined;
+        [PASSWORD_PARAM]?: core.Supplier<string> | undefined;
+    };
+    function createInstance(options: Options): core.AuthProvider;
+}
+export {};

package/auth/BasicAuthProvider.js

@@ -0,0 +1,93 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasicAuthProvider = void 0;
+const core = __importStar(require("../core"));
+const errors = __importStar(require("../errors/index"));
+const USERNAME_PARAM = "appId";
+const PASSWORD_PARAM = "appSecret";
+const ENV_USERNAME = "MAVENAGI_APP_ID";
+const ENV_PASSWORD = "MAVENAGI_APP_SECRET";
+class BasicAuthProvider {
+    constructor(options) {
+        this.options = options;
+    }
+    static canCreate(options) {
+        var _a, _b;
+        return (((options === null || options === void 0 ? void 0 : options[USERNAME_PARAM]) != null || ((_a = process.env) === null || _a === void 0 ? void 0 : _a[ENV_USERNAME]) != null) &&
+            ((options === null || options === void 0 ? void 0 : options[PASSWORD_PARAM]) != null || ((_b = process.env) === null || _b === void 0 ? void 0 : _b[ENV_PASSWORD]) != null));
+    }
+    getAuthRequest() {
+        return __awaiter(this, arguments, void 0, function* ({ endpointMetadata, } = {}) {
+            var _a, _b, _c, _d;
+            const appId = (_a = (yield core.Supplier.get(this.options[USERNAME_PARAM]))) !== null && _a !== void 0 ? _a : (_b = process.env) === null || _b === void 0 ? void 0 : _b[ENV_USERNAME];
+            if (appId == null) {
+                throw new errors.MavenAGIError({ message: BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE_USERNAME });
+            }
+            const appSecret = (_c = (yield core.Supplier.get(this.options[PASSWORD_PARAM]))) !== null && _c !== void 0 ? _c : (_d = process.env) === null || _d === void 0 ? void 0 : _d[ENV_PASSWORD];
+            if (appSecret == null) {
+                throw new errors.MavenAGIError({ message: BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE_PASSWORD });
+            }
+            const authHeader = core.BasicAuth.toAuthorizationHeader({
+                username: appId,
+                password: appSecret,
+            });
+            return {
+                headers: authHeader != null ? { Authorization: authHeader } : {},
+            };
+        });
+    }
+}
+exports.BasicAuthProvider = BasicAuthProvider;
+(function (BasicAuthProvider) {
+    BasicAuthProvider.AUTH_SCHEME = "Basic";
+    BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE = "Please provide username and password when initializing the client";
+    BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE_USERNAME = `Please provide '${USERNAME_PARAM}' when initializing the client, or set the '${ENV_USERNAME}' environment variable`;
+    BasicAuthProvider.AUTH_CONFIG_ERROR_MESSAGE_PASSWORD = `Please provide '${PASSWORD_PARAM}' when initializing the client, or set the '${ENV_PASSWORD}' environment variable`;
+    function createInstance(options) {
+        return new BasicAuthProvider(options);
+    }
+    BasicAuthProvider.createInstance = createInstance;
+})(BasicAuthProvider || (exports.BasicAuthProvider = BasicAuthProvider = {}));

package/auth/index.d.ts

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

package/auth/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasicAuthProvider = void 0;
+var BasicAuthProvider_1 = require("./BasicAuthProvider");
+Object.defineProperty(exports, "BasicAuthProvider", { enumerable: true, get: function () { return BasicAuthProvider_1.BasicAuthProvider; } });

package/core/auth/AuthProvider.d.ts

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

package/core/auth/AuthProvider.js

@@ -1,2 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAuthProvider = isAuthProvider;
+function isAuthProvider(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "getAuthRequest" in value &&
+        typeof value.getAuthRequest === "function");
+}

package/core/auth/BasicAuth.d.ts

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

package/core/auth/BasicAuth.js

@@ -5,10 +5,16 @@ const base64_1 = require("../base64");
 const BASIC_AUTH_HEADER_PREFIX = /^Basic /i;
 exports.BasicAuth = {
     toAuthorizationHeader: (basicAuth) => {
+        var _a, _b;
         if (basicAuth == null) {
             return undefined;
         }
-        const token = (0, base64_1.base64Encode)(`${basicAuth.username}:${basicAuth.password}`);
+        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 = (0, base64_1.base64Encode)(`${username}:${password}`);
         return `Basic ${token}`;
     },
     fromAuthorizationHeader: (header) => {

package/core/auth/BearerToken.d.ts

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

package/core/auth/BearerToken.js

@@ -2,13 +2,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BearerToken = void 0;
 const BEARER_AUTH_HEADER_PREFIX = /^Bearer /i;
+function toAuthorizationHeader(token) {
+    if (token == null) {
+        return undefined;
+    }
+    return `Bearer ${token}`;
+}
 exports.BearerToken = {
-    toAuthorizationHeader: (token) => {
-        if (token == null) {
-            return undefined;
-        }
-        return `Bearer ${token}`;
-    },
+    toAuthorizationHeader: toAuthorizationHeader,
     fromAuthorizationHeader: (header) => {
         return header.replace(BEARER_AUTH_HEADER_PREFIX, "").trim();
     },

package/core/auth/NoOpAuthProvider.d.ts

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

package/core/auth/NoOpAuthProvider.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoOpAuthProvider = void 0;
+class NoOpAuthProvider {
+    getAuthRequest() {
+        return Promise.resolve({ headers: {} });
+    }
+}
+exports.NoOpAuthProvider = NoOpAuthProvider;

package/core/auth/index.d.ts

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

package/core/auth/index.js

@@ -1,7 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BearerToken = exports.BasicAuth = void 0;
+exports.NoOpAuthProvider = exports.BearerToken = exports.BasicAuth = exports.isAuthProvider = void 0;
+var AuthProvider_1 = require("./AuthProvider");
+Object.defineProperty(exports, "isAuthProvider", { enumerable: true, get: function () { return AuthProvider_1.isAuthProvider; } });
 var BasicAuth_1 = require("./BasicAuth");
 Object.defineProperty(exports, "BasicAuth", { enumerable: true, get: function () { return BasicAuth_1.BasicAuth; } });
 var BearerToken_1 = require("./BearerToken");
 Object.defineProperty(exports, "BearerToken", { enumerable: true, get: function () { return BearerToken_1.BearerToken; } });
+var NoOpAuthProvider_1 = require("./NoOpAuthProvider");
+Object.defineProperty(exports, "NoOpAuthProvider", { enumerable: true, get: function () { return NoOpAuthProvider_1.NoOpAuthProvider; } });

package/core/exports.d.ts

@@ -1 +1,3 @@
 export * from "./file/exports";
+export * from "./logging/exports";
+export * from "./websocket/exports";

package/core/exports.js

@@ -15,3 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./file/exports"), exports);
+__exportStar(require("./logging/exports"), exports);
+__exportStar(require("./websocket/exports"), exports);

package/core/fetcher/BinaryResponse.d.ts

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

package/core/fetcher/EndpointSupplier.d.ts

@@ -1,12 +1,12 @@
 import type { EndpointMetadata } from "./EndpointMetadata";
 import type { Supplier } from "./Supplier";
 type EndpointSupplierFn<T> = (arg: {
-    endpointMetadata: EndpointMetadata;
+    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;
+        endpointMetadata?: EndpointMetadata;
     }) => Promise<T>;
 };
 export {};

package/core/fetcher/Fetcher.d.ts

@@ -1,25 +1,33 @@
+import { type LogConfig, type Logger } from "../logging/logger";
 import type { APIResponse } from "./APIResponse";
 import type { EndpointMetadata } from "./EndpointMetadata";
-import { EndpointSupplier } from "./EndpointSupplier";
 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 | EndpointSupplier<string | null | undefined> | null | undefined>;
+        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";
+        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 | TimeoutError | UnknownError;
+    type Error = FailedStatusCodeError | NonJsonError | BodyIsNullError | TimeoutError | UnknownError;
     interface FailedStatusCodeError {
         reason: "status-code";
         statusCode: number;
@@ -30,12 +38,18 @@ export declare namespace Fetcher {
         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>>;