@ai-sdk/provider-utils 2.1.2 → 2.1.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-sdk/provider-utils
 
+## 2.1.3
+
+### Patch Changes
+
+- 39e5c1f: feat (provider-utils): add getFromApi and response handlers for binary responses and status-code errors
+
 ## 2.1.2
 
 ### Patch Changes

package/dist/index.d.mts

@@ -54,43 +54,6 @@ declare const generateId: (size?: number) => string;
 
 declare function getErrorMessage(error: unknown | undefined): string;
 
-declare function isAbortError(error: unknown): error is Error;
-
-declare function loadApiKey({ apiKey, environmentVariableName, apiKeyParameterName, description, }: {
-    apiKey: string | undefined;
-    environmentVariableName: string;
-    apiKeyParameterName?: string;
-    description: string;
-}): string;
-
-/**
- * Loads an optional `string` setting from the environment or a parameter.
- *
- * @param settingValue - The setting value.
- * @param environmentVariableName - The environment variable name.
- * @returns The setting value.
- */
-declare function loadOptionalSetting({ settingValue, environmentVariableName, }: {
-    settingValue: string | undefined;
-    environmentVariableName: string;
-}): string | undefined;
-
-/**
- * Loads a `string` setting from the environment or a parameter.
- *
- * @param settingValue - The setting value.
- * @param environmentVariableName - The environment variable name.
- * @param settingName - The setting name.
- * @param description - The description of the setting.
- * @returns The setting value.
- */
-declare function loadSetting({ settingValue, environmentVariableName, settingName, description, }: {
-    settingValue: string | undefined;
-    environmentVariableName: string;
-    settingName: string;
-    description: string;
-}): string;
-
 /**
  * Used to mark validator functions so we can support both Zod and custom schemas.
  */
@@ -194,6 +157,58 @@ declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage,
 declare const createEventSourceResponseHandler: <T>(chunkSchema: ZodSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
 declare const createJsonStreamResponseHandler: <T>(chunkSchema: ZodSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
 declare const createJsonResponseHandler: <T>(responseSchema: ZodSchema<T>) => ResponseHandler<T>;
+declare const createBinaryResponseHandler: () => ResponseHandler<Uint8Array>;
+declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
+
+declare const getFromApi: <T>({ url, headers, successfulResponseHandler, failedResponseHandler, abortSignal, fetch, }: {
+    url: string;
+    headers?: Record<string, string | undefined>;
+    failedResponseHandler: ResponseHandler<Error>;
+    successfulResponseHandler: ResponseHandler<T>;
+    abortSignal?: AbortSignal;
+    fetch?: FetchFunction;
+}) => Promise<{
+    value: T;
+    rawValue?: unknown;
+    responseHeaders?: Record<string, string>;
+}>;
+
+declare function isAbortError(error: unknown): error is Error;
+
+declare function loadApiKey({ apiKey, environmentVariableName, apiKeyParameterName, description, }: {
+    apiKey: string | undefined;
+    environmentVariableName: string;
+    apiKeyParameterName?: string;
+    description: string;
+}): string;
+
+/**
+ * Loads an optional `string` setting from the environment or a parameter.
+ *
+ * @param settingValue - The setting value.
+ * @param environmentVariableName - The environment variable name.
+ * @returns The setting value.
+ */
+declare function loadOptionalSetting({ settingValue, environmentVariableName, }: {
+    settingValue: string | undefined;
+    environmentVariableName: string;
+}): string | undefined;
+
+/**
+ * Loads a `string` setting from the environment or a parameter.
+ *
+ * @param settingValue - The setting value.
+ * @param environmentVariableName - The environment variable name.
+ * @param settingName - The setting name.
+ * @param description - The description of the setting.
+ * @returns The setting value.
+ */
+declare function loadSetting({ settingValue, environmentVariableName, settingName, description, }: {
+    settingValue: string | undefined;
+    environmentVariableName: string;
+    settingName: string;
+    description: string;
+}): string;
 
 declare const postJsonToApi: <T>({ url, headers, body, failedResponseHandler, successfulResponseHandler, abortSignal, fetch, }: {
     url: string;
@@ -312,4 +327,4 @@ interface ToolResult<NAME extends string, ARGS, RESULT> {
     result: RESULT;
 }
 
-export { type FetchFunction, type IDGenerator, type ParseResult, type Resolvable, type ResponseHandler, type ToolCall, type ToolResult, type ValidationResult, type Validator, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertUint8ArrayToBase64, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, extractResponseHeaders, generateId, getErrorMessage, isAbortError, isParsableJson, isValidator, loadApiKey, loadOptionalSetting, loadSetting, parseJSON, postJsonToApi, postToApi, resolve, safeParseJSON, safeValidateTypes, validateTypes, validator, validatorSymbol, withoutTrailingSlash, zodValidator };
+export { type FetchFunction, type IDGenerator, type ParseResult, type Resolvable, type ResponseHandler, type ToolCall, type ToolResult, type ValidationResult, type Validator, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createStatusCodeErrorResponseHandler, extractResponseHeaders, generateId, getErrorMessage, getFromApi, isAbortError, isParsableJson, isValidator, loadApiKey, loadOptionalSetting, loadSetting, parseJSON, postJsonToApi, postToApi, resolve, safeParseJSON, safeValidateTypes, validateTypes, validator, validatorSymbol, withoutTrailingSlash, zodValidator };

package/dist/index.d.ts

@@ -54,43 +54,6 @@ declare const generateId: (size?: number) => string;
 
 declare function getErrorMessage(error: unknown | undefined): string;
 
-declare function isAbortError(error: unknown): error is Error;
-
-declare function loadApiKey({ apiKey, environmentVariableName, apiKeyParameterName, description, }: {
-    apiKey: string | undefined;
-    environmentVariableName: string;
-    apiKeyParameterName?: string;
-    description: string;
-}): string;
-
-/**
- * Loads an optional `string` setting from the environment or a parameter.
- *
- * @param settingValue - The setting value.
- * @param environmentVariableName - The environment variable name.
- * @returns The setting value.
- */
-declare function loadOptionalSetting({ settingValue, environmentVariableName, }: {
-    settingValue: string | undefined;
-    environmentVariableName: string;
-}): string | undefined;
-
-/**
- * Loads a `string` setting from the environment or a parameter.
- *
- * @param settingValue - The setting value.
- * @param environmentVariableName - The environment variable name.
- * @param settingName - The setting name.
- * @param description - The description of the setting.
- * @returns The setting value.
- */
-declare function loadSetting({ settingValue, environmentVariableName, settingName, description, }: {
-    settingValue: string | undefined;
-    environmentVariableName: string;
-    settingName: string;
-    description: string;
-}): string;
-
 /**
  * Used to mark validator functions so we can support both Zod and custom schemas.
  */
@@ -194,6 +157,58 @@ declare const createJsonErrorResponseHandler: <T>({ errorSchema, errorToMessage,
 declare const createEventSourceResponseHandler: <T>(chunkSchema: ZodSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
 declare const createJsonStreamResponseHandler: <T>(chunkSchema: ZodSchema<T>) => ResponseHandler<ReadableStream<ParseResult<T>>>;
 declare const createJsonResponseHandler: <T>(responseSchema: ZodSchema<T>) => ResponseHandler<T>;
+declare const createBinaryResponseHandler: () => ResponseHandler<Uint8Array>;
+declare const createStatusCodeErrorResponseHandler: () => ResponseHandler<APICallError>;
+
+declare const getFromApi: <T>({ url, headers, successfulResponseHandler, failedResponseHandler, abortSignal, fetch, }: {
+    url: string;
+    headers?: Record<string, string | undefined>;
+    failedResponseHandler: ResponseHandler<Error>;
+    successfulResponseHandler: ResponseHandler<T>;
+    abortSignal?: AbortSignal;
+    fetch?: FetchFunction;
+}) => Promise<{
+    value: T;
+    rawValue?: unknown;
+    responseHeaders?: Record<string, string>;
+}>;
+
+declare function isAbortError(error: unknown): error is Error;
+
+declare function loadApiKey({ apiKey, environmentVariableName, apiKeyParameterName, description, }: {
+    apiKey: string | undefined;
+    environmentVariableName: string;
+    apiKeyParameterName?: string;
+    description: string;
+}): string;
+
+/**
+ * Loads an optional `string` setting from the environment or a parameter.
+ *
+ * @param settingValue - The setting value.
+ * @param environmentVariableName - The environment variable name.
+ * @returns The setting value.
+ */
+declare function loadOptionalSetting({ settingValue, environmentVariableName, }: {
+    settingValue: string | undefined;
+    environmentVariableName: string;
+}): string | undefined;
+
+/**
+ * Loads a `string` setting from the environment or a parameter.
+ *
+ * @param settingValue - The setting value.
+ * @param environmentVariableName - The environment variable name.
+ * @param settingName - The setting name.
+ * @param description - The description of the setting.
+ * @returns The setting value.
+ */
+declare function loadSetting({ settingValue, environmentVariableName, settingName, description, }: {
+    settingValue: string | undefined;
+    environmentVariableName: string;
+    settingName: string;
+    description: string;
+}): string;
 
 declare const postJsonToApi: <T>({ url, headers, body, failedResponseHandler, successfulResponseHandler, abortSignal, fetch, }: {
     url: string;
@@ -312,4 +327,4 @@ interface ToolResult<NAME extends string, ARGS, RESULT> {
     result: RESULT;
 }
 
-export { type FetchFunction, type IDGenerator, type ParseResult, type Resolvable, type ResponseHandler, type ToolCall, type ToolResult, type ValidationResult, type Validator, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertUint8ArrayToBase64, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, extractResponseHeaders, generateId, getErrorMessage, isAbortError, isParsableJson, isValidator, loadApiKey, loadOptionalSetting, loadSetting, parseJSON, postJsonToApi, postToApi, resolve, safeParseJSON, safeValidateTypes, validateTypes, validator, validatorSymbol, withoutTrailingSlash, zodValidator };
+export { type FetchFunction, type IDGenerator, type ParseResult, type Resolvable, type ResponseHandler, type ToolCall, type ToolResult, type ValidationResult, type Validator, asValidator, combineHeaders, convertAsyncIteratorToReadableStream, convertBase64ToUint8Array, convertUint8ArrayToBase64, createBinaryResponseHandler, createEventSourceResponseHandler, createIdGenerator, createJsonErrorResponseHandler, createJsonResponseHandler, createJsonStreamResponseHandler, createStatusCodeErrorResponseHandler, extractResponseHeaders, generateId, getErrorMessage, getFromApi, isAbortError, isParsableJson, isValidator, loadApiKey, loadOptionalSetting, loadSetting, parseJSON, postJsonToApi, postToApi, resolve, safeParseJSON, safeValidateTypes, validateTypes, validator, validatorSymbol, withoutTrailingSlash, zodValidator };

package/dist/index.js

@@ -35,14 +35,17 @@ __export(src_exports, {
   convertAsyncIteratorToReadableStream: () => convertAsyncIteratorToReadableStream,
   convertBase64ToUint8Array: () => convertBase64ToUint8Array,
   convertUint8ArrayToBase64: () => convertUint8ArrayToBase64,
+  createBinaryResponseHandler: () => createBinaryResponseHandler,
   createEventSourceResponseHandler: () => createEventSourceResponseHandler,
   createIdGenerator: () => createIdGenerator,
   createJsonErrorResponseHandler: () => createJsonErrorResponseHandler,
   createJsonResponseHandler: () => createJsonResponseHandler,
   createJsonStreamResponseHandler: () => createJsonStreamResponseHandler,
+  createStatusCodeErrorResponseHandler: () => createStatusCodeErrorResponseHandler,
   extractResponseHeaders: () => extractResponseHeaders,
   generateId: () => generateId,
   getErrorMessage: () => getErrorMessage,
+  getFromApi: () => getFromApi,
   isAbortError: () => isAbortError,
   isParsableJson: () => isParsableJson,
   isValidator: () => isValidator,
@@ -149,13 +152,104 @@ function getErrorMessage(error) {
   return JSON.stringify(error);
 }
 
+// src/get-from-api.ts
+var import_provider2 = require("@ai-sdk/provider");
+
+// src/remove-undefined-entries.ts
+function removeUndefinedEntries(record) {
+  return Object.fromEntries(
+    Object.entries(record).filter(([_key, value]) => value != null)
+  );
+}
+
 // src/is-abort-error.ts
 function isAbortError(error) {
   return error instanceof Error && (error.name === "AbortError" || error.name === "TimeoutError");
 }
 
+// src/get-from-api.ts
+var getOriginalFetch = () => globalThis.fetch;
+var getFromApi = async ({
+  url,
+  headers = {},
+  successfulResponseHandler,
+  failedResponseHandler,
+  abortSignal,
+  fetch = getOriginalFetch()
+}) => {
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      headers: removeUndefinedEntries(headers),
+      signal: abortSignal
+    });
+    const responseHeaders = extractResponseHeaders(response);
+    if (!response.ok) {
+      let errorInformation;
+      try {
+        errorInformation = await failedResponseHandler({
+          response,
+          url,
+          requestBodyValues: {}
+        });
+      } catch (error) {
+        if (isAbortError(error) || import_provider2.APICallError.isInstance(error)) {
+          throw error;
+        }
+        throw new import_provider2.APICallError({
+          message: "Failed to process error response",
+          cause: error,
+          statusCode: response.status,
+          url,
+          responseHeaders,
+          requestBodyValues: {}
+        });
+      }
+      throw errorInformation.value;
+    }
+    try {
+      return await successfulResponseHandler({
+        response,
+        url,
+        requestBodyValues: {}
+      });
+    } catch (error) {
+      if (error instanceof Error) {
+        if (isAbortError(error) || import_provider2.APICallError.isInstance(error)) {
+          throw error;
+        }
+      }
+      throw new import_provider2.APICallError({
+        message: "Failed to process successful response",
+        cause: error,
+        statusCode: response.status,
+        url,
+        responseHeaders,
+        requestBodyValues: {}
+      });
+    }
+  } catch (error) {
+    if (isAbortError(error)) {
+      throw error;
+    }
+    if (error instanceof TypeError && error.message === "fetch failed") {
+      const cause = error.cause;
+      if (cause != null) {
+        throw new import_provider2.APICallError({
+          message: `Cannot connect to API: ${cause.message}`,
+          cause,
+          url,
+          isRetryable: true,
+          requestBodyValues: {}
+        });
+      }
+    }
+    throw error;
+  }
+};
+
 // src/load-api-key.ts
-var import_provider2 = require("@ai-sdk/provider");
+var import_provider3 = require("@ai-sdk/provider");
 function loadApiKey({
   apiKey,
   environmentVariableName,
@@ -166,23 +260,23 @@ function loadApiKey({
     return apiKey;
   }
   if (apiKey != null) {
-    throw new import_provider2.LoadAPIKeyError({
+    throw new import_provider3.LoadAPIKeyError({
       message: `${description} API key must be a string.`
     });
   }
   if (typeof process === "undefined") {
-    throw new import_provider2.LoadAPIKeyError({
+    throw new import_provider3.LoadAPIKeyError({
       message: `${description} API key is missing. Pass it using the '${apiKeyParameterName}' parameter. Environment variables is not supported in this environment.`
     });
   }
   apiKey = process.env[environmentVariableName];
   if (apiKey == null) {
-    throw new import_provider2.LoadAPIKeyError({
+    throw new import_provider3.LoadAPIKeyError({
       message: `${description} API key is missing. Pass it using the '${apiKeyParameterName}' parameter or the ${environmentVariableName} environment variable.`
     });
   }
   if (typeof apiKey !== "string") {
-    throw new import_provider2.LoadAPIKeyError({
+    throw new import_provider3.LoadAPIKeyError({
       message: `${description} API key must be a string. The value of the ${environmentVariableName} environment variable is not a string.`
     });
   }
@@ -208,7 +302,7 @@ function loadOptionalSetting({
 }
 
 // src/load-setting.ts
-var import_provider3 = require("@ai-sdk/provider");
+var import_provider4 = require("@ai-sdk/provider");
 function loadSetting({
   settingValue,
   environmentVariableName,
@@ -219,23 +313,23 @@ function loadSetting({
     return settingValue;
   }
   if (settingValue != null) {
-    throw new import_provider3.LoadSettingError({
+    throw new import_provider4.LoadSettingError({
       message: `${description} setting must be a string.`
     });
   }
   if (typeof process === "undefined") {
-    throw new import_provider3.LoadSettingError({
+    throw new import_provider4.LoadSettingError({
       message: `${description} setting is missing. Pass it using the '${settingName}' parameter. Environment variables is not supported in this environment.`
     });
   }
   settingValue = process.env[environmentVariableName];
   if (settingValue == null) {
-    throw new import_provider3.LoadSettingError({
+    throw new import_provider4.LoadSettingError({
       message: `${description} setting is missing. Pass it using the '${settingName}' parameter or the ${environmentVariableName} environment variable.`
     });
   }
   if (typeof settingValue !== "string") {
-    throw new import_provider3.LoadSettingError({
+    throw new import_provider4.LoadSettingError({
       message: `${description} setting must be a string. The value of the ${environmentVariableName} environment variable is not a string.`
     });
   }
@@ -243,11 +337,11 @@ function loadSetting({
 }
 
 // src/parse-json.ts
-var import_provider5 = require("@ai-sdk/provider");
+var import_provider6 = require("@ai-sdk/provider");
 var import_secure_json_parse = __toESM(require("secure-json-parse"));
 
 // src/validate-types.ts
-var import_provider4 = require("@ai-sdk/provider");
+var import_provider5 = require("@ai-sdk/provider");
 
 // src/validator.ts
 var validatorSymbol = Symbol.for("vercel.ai.validator");
@@ -274,7 +368,7 @@ function validateTypes({
 }) {
   const result = safeValidateTypes({ value, schema: inputSchema });
   if (!result.success) {
-    throw import_provider4.TypeValidationError.wrap({ value, cause: result.error });
+    throw import_provider5.TypeValidationError.wrap({ value, cause: result.error });
   }
   return result.value;
 }
@@ -293,12 +387,12 @@ function safeValidateTypes({
     }
     return {
       success: false,
-      error: import_provider4.TypeValidationError.wrap({ value, cause: result.error })
+      error: import_provider5.TypeValidationError.wrap({ value, cause: result.error })
     };
   } catch (error) {
     return {
       success: false,
-      error: import_provider4.TypeValidationError.wrap({ value, cause: error })
+      error: import_provider5.TypeValidationError.wrap({ value, cause: error })
     };
   }
 }
@@ -315,10 +409,10 @@ function parseJSON({
     }
     return validateTypes({ value, schema });
   } catch (error) {
-    if (import_provider5.JSONParseError.isInstance(error) || import_provider5.TypeValidationError.isInstance(error)) {
+    if (import_provider6.JSONParseError.isInstance(error) || import_provider6.TypeValidationError.isInstance(error)) {
       throw error;
     }
-    throw new import_provider5.JSONParseError({ text, cause: error });
+    throw new import_provider6.JSONParseError({ text, cause: error });
   }
 }
 function safeParseJSON({
@@ -335,7 +429,7 @@ function safeParseJSON({
   } catch (error) {
     return {
       success: false,
-      error: import_provider5.JSONParseError.isInstance(error) ? error : new import_provider5.JSONParseError({ text, cause: error })
+      error: import_provider6.JSONParseError.isInstance(error) ? error : new import_provider6.JSONParseError({ text, cause: error })
     };
   }
 }
@@ -349,17 +443,8 @@ function isParsableJson(input) {
 }
 
 // src/post-to-api.ts
-var import_provider6 = require("@ai-sdk/provider");
-
-// src/remove-undefined-entries.ts
-function removeUndefinedEntries(record) {
-  return Object.fromEntries(
-    Object.entries(record).filter(([_key, value]) => value != null)
-  );
-}
-
-// src/post-to-api.ts
-var getOriginalFetch = () => globalThis.fetch;
+var import_provider7 = require("@ai-sdk/provider");
+var getOriginalFetch2 = () => globalThis.fetch;
 var postJsonToApi = async ({
   url,
   headers,
@@ -390,7 +475,7 @@ var postToApi = async ({
   successfulResponseHandler,
   failedResponseHandler,
   abortSignal,
-  fetch = getOriginalFetch()
+  fetch = getOriginalFetch2()
 }) => {
   try {
     const response = await fetch(url, {
@@ -409,10 +494,10 @@ var postToApi = async ({
           requestBodyValues: body.values
         });
       } catch (error) {
-        if (isAbortError(error) || import_provider6.APICallError.isInstance(error)) {
+        if (isAbortError(error) || import_provider7.APICallError.isInstance(error)) {
           throw error;
         }
-        throw new import_provider6.APICallError({
+        throw new import_provider7.APICallError({
           message: "Failed to process error response",
           cause: error,
           statusCode: response.status,
@@ -431,11 +516,11 @@ var postToApi = async ({
       });
     } catch (error) {
       if (error instanceof Error) {
-        if (isAbortError(error) || import_provider6.APICallError.isInstance(error)) {
+        if (isAbortError(error) || import_provider7.APICallError.isInstance(error)) {
           throw error;
         }
       }
-      throw new import_provider6.APICallError({
+      throw new import_provider7.APICallError({
         message: "Failed to process successful response",
         cause: error,
         statusCode: response.status,
@@ -451,7 +536,7 @@ var postToApi = async ({
     if (error instanceof TypeError && error.message === "fetch failed") {
       const cause = error.cause;
       if (cause != null) {
-        throw new import_provider6.APICallError({
+        throw new import_provider7.APICallError({
           message: `Cannot connect to API: ${cause.message}`,
           cause,
           url,
@@ -474,7 +559,7 @@ async function resolve(value) {
 }
 
 // src/response-handler.ts
-var import_provider7 = require("@ai-sdk/provider");
+var import_provider8 = require("@ai-sdk/provider");
 var import_stream = require("eventsource-parser/stream");
 var createJsonErrorResponseHandler = ({
   errorSchema,
@@ -486,7 +571,7 @@ var createJsonErrorResponseHandler = ({
   if (responseBody.trim() === "") {
     return {
       responseHeaders,
-      value: new import_provider7.APICallError({
+      value: new import_provider8.APICallError({
         message: response.statusText,
         url,
         requestBodyValues,
@@ -504,7 +589,7 @@ var createJsonErrorResponseHandler = ({
     });
     return {
       responseHeaders,
-      value: new import_provider7.APICallError({
+      value: new import_provider8.APICallError({
         message: errorToMessage(parsedError),
         url,
         requestBodyValues,
@@ -518,7 +603,7 @@ var createJsonErrorResponseHandler = ({
   } catch (parseError) {
     return {
       responseHeaders,
-      value: new import_provider7.APICallError({
+      value: new import_provider8.APICallError({
         message: response.statusText,
         url,
         requestBodyValues,
@@ -533,7 +618,7 @@ var createJsonErrorResponseHandler = ({
 var createEventSourceResponseHandler = (chunkSchema) => async ({ response }) => {
   const responseHeaders = extractResponseHeaders(response);
   if (response.body == null) {
-    throw new import_provider7.EmptyResponseBodyError({});
+    throw new import_provider8.EmptyResponseBodyError({});
   }
   return {
     responseHeaders,
@@ -557,7 +642,7 @@ var createEventSourceResponseHandler = (chunkSchema) => async ({ response }) =>
 var createJsonStreamResponseHandler = (chunkSchema) => async ({ response }) => {
   const responseHeaders = extractResponseHeaders(response);
   if (response.body == null) {
-    throw new import_provider7.EmptyResponseBodyError({});
+    throw new import_provider8.EmptyResponseBodyError({});
   }
   let buffer = "";
   return {
@@ -589,7 +674,7 @@ var createJsonResponseHandler = (responseSchema) => async ({ response, url, requ
   });
   const responseHeaders = extractResponseHeaders(response);
   if (!parsedResult.success) {
-    throw new import_provider7.APICallError({
+    throw new import_provider8.APICallError({
       message: "Invalid JSON response",
       cause: parsedResult.error,
       statusCode: response.status,
@@ -605,6 +690,51 @@ var createJsonResponseHandler = (responseSchema) => async ({ response, url, requ
     rawValue: parsedResult.rawValue
   };
 };
+var createBinaryResponseHandler = () => async ({ response, url, requestBodyValues }) => {
+  const responseHeaders = extractResponseHeaders(response);
+  if (!response.body) {
+    throw new import_provider8.APICallError({
+      message: "Response body is empty",
+      url,
+      requestBodyValues,
+      statusCode: response.status,
+      responseHeaders,
+      responseBody: void 0
+    });
+  }
+  try {
+    const buffer = await response.arrayBuffer();
+    return {
+      responseHeaders,
+      value: new Uint8Array(buffer)
+    };
+  } catch (error) {
+    throw new import_provider8.APICallError({
+      message: "Failed to read response as array buffer",
+      url,
+      requestBodyValues,
+      statusCode: response.status,
+      responseHeaders,
+      responseBody: void 0,
+      cause: error
+    });
+  }
+};
+var createStatusCodeErrorResponseHandler = () => async ({ response, url, requestBodyValues }) => {
+  const responseHeaders = extractResponseHeaders(response);
+  const responseBody = await response.text();
+  return {
+    responseHeaders,
+    value: new import_provider8.APICallError({
+      message: response.statusText,
+      url,
+      requestBodyValues,
+      statusCode: response.status,
+      responseHeaders,
+      responseBody
+    })
+  };
+};
 
 // src/uint8-utils.ts
 var { btoa, atob } = globalThis;
@@ -632,14 +762,17 @@ function withoutTrailingSlash(url) {
   convertAsyncIteratorToReadableStream,
   convertBase64ToUint8Array,
   convertUint8ArrayToBase64,
+  createBinaryResponseHandler,
   createEventSourceResponseHandler,
   createIdGenerator,
   createJsonErrorResponseHandler,
   createJsonResponseHandler,
   createJsonStreamResponseHandler,
+  createStatusCodeErrorResponseHandler,
   extractResponseHeaders,
   generateId,
   getErrorMessage,
+  getFromApi,
   isAbortError,
   isParsableJson,
   isValidator,