ai 7.0.98 → 7.0.100

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # ai
 
+## 7.0.100
+
+### Patch Changes
+
+- 6431635: feat(ai): expose typed AI SDK errors for UI transport and completion failures
+- Updated dependencies [23a0fff]
+  - @ai-sdk/gateway@4.0.81
+
+## 7.0.99
+
+### Patch Changes
+
+- 615ac89: feat(ai): use InvalidArgumentError for utility input validation
+- Updated dependencies [7f76d83]
+  - @ai-sdk/gateway@4.0.80
+
 ## 7.0.98
 
 ### Patch Changes

package/dist/index.d.ts

@@ -7052,7 +7052,9 @@ interface EmbedManyResult {
  * @param abortSignal - An optional abort signal that can be used to cancel the call.
  * @param headers - Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
  *
- * @param maxParallelCalls - Maximum number of concurrent requests. Default: Infinity.
+ * @param maxParallelCalls - Maximum number of concurrent requests when a request is split into
+ * multiple model calls. Must be greater than 0 when the model supports parallel calls.
+ * Default: Infinity.
  *
  * @param telemetry - Optional telemetry configuration.
  * @param runtimeContext - User-defined runtime context passed to callbacks and, when explicitly included, telemetry.
@@ -7108,7 +7110,8 @@ declare function embedMany<RUNTIME_CONTEXT extends Context = Context>({ model: m
      */
     providerOptions?: ProviderOptions;
     /**
-     * Maximum number of concurrent requests.
+     * Maximum number of concurrent requests when a request is split into multiple model calls.
+     * Must be greater than 0 when the model supports parallel calls.
      *
      * @default Infinity
      */
@@ -7516,9 +7519,11 @@ declare class UnsupportedModelVersionError extends AISDKError {
 
 declare const symbol$5: unique symbol;
 /**
- * Error thrown when a UI message stream contains invalid or out-of-sequence chunks.
+ * Error thrown when a UI message stream reports an error or contains invalid
+ * or out-of-sequence chunks.
  *
  * This typically occurs when:
+ * - An error chunk is received
  * - A delta chunk is received without a corresponding start chunk
  * - An end chunk is received without a corresponding start chunk
  * - A tool invocation is not found for the given toolCallId
@@ -7532,7 +7537,8 @@ declare class UIMessageStreamError extends AISDKError {
      */
     readonly chunkType: string;
     /**
-     * The ID associated with the failing chunk (part ID or toolCallId).
+     * The ID associated with the failing chunk (part ID or toolCallId), or an
+     * empty string when the chunk does not have an ID.
      */
     readonly chunkId: string;
     constructor({ chunkType, chunkId, message, }: {
@@ -7887,6 +7893,8 @@ declare function createDownload(options?: {
 
 /**
  * Converts a data URL of type text/* to a text string.
+ *
+ * @throws {InvalidArgumentError} If the data URL is malformed or cannot be decoded.
  */
 declare function getTextFromDataUrl(dataUrl: string): string;
 

package/dist/index.js

@@ -1178,7 +1178,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.98" : "0.0.0-test";
+var VERSION = true ? "7.0.100" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({
@@ -13639,7 +13639,11 @@ function getEmbeddingModelMaxInputBytesPerCall(model) {
 // src/util/split-array.ts
 function splitArray(array3, chunkSize) {
   if (chunkSize <= 0) {
-    throw new Error("chunkSize must be greater than 0");
+    throw new InvalidArgumentError({
+      parameter: "chunkSize",
+      value: chunkSize,
+      message: "chunkSize must be greater than 0"
+    });
   }
   const result = [];
   for (let i = 0; i < array3.length; i += chunkSize) {
@@ -14737,12 +14741,20 @@ function getTextFromDataUrl(dataUrl) {
   const [header, base64Content] = dataUrl.split(",");
   const mediaType = header.split(";")[0].split(":")[1];
   if (mediaType == null || base64Content == null) {
-    throw new Error("Invalid data URL format");
+    throw new InvalidArgumentError({
+      parameter: "dataUrl",
+      value: dataUrl,
+      message: "Invalid data URL format"
+    });
   }
   try {
     return atob2(base64Content);
   } catch (e) {
-    throw new Error(`Error decoding data URL`);
+    throw new InvalidArgumentError({
+      parameter: "dataUrl",
+      value: dataUrl,
+      message: "Error decoding data URL"
+    });
   }
 }
 
@@ -18962,6 +18974,26 @@ import {
   withUserAgentSuffix as withUserAgentSuffix16,
   getRuntimeEnvironmentUserAgent as getRuntimeEnvironmentUserAgent2
 } from "@ai-sdk/provider-utils";
+import { EmptyResponseBodyError as EmptyResponseBodyError2 } from "@ai-sdk/provider";
+
+// src/ui/create-ui-api-call-error.ts
+import { APICallError as APICallError3 } from "@ai-sdk/provider";
+async function createUIApiCallError({
+  response,
+  url,
+  fallbackMessage
+}) {
+  const responseBody = await response.text();
+  return new APICallError3({
+    message: responseBody || fallbackMessage,
+    url,
+    // UI requests can contain prompts, messages, and other sensitive values.
+    // Keep them out of client-facing error objects.
+    requestBodyValues: void 0,
+    statusCode: response.status,
+    responseBody
+  });
+}
 
 // src/ui/process-text-stream.ts
 async function processTextStream({
@@ -19021,12 +19053,16 @@ async function callCompletionApi({
       throw err;
     });
     if (!response.ok) {
-      throw new Error(
-        await response.text() || "Failed to fetch the chat response."
-      );
+      throw await createUIApiCallError({
+        response,
+        url: api,
+        fallbackMessage: "Failed to fetch the chat response."
+      });
     }
     if (!response.body) {
-      throw new Error("The response body is empty.");
+      throw new EmptyResponseBodyError2({
+        message: "The response body is empty."
+      });
     }
     let result = "";
     switch (streamProtocol) {
@@ -19056,7 +19092,11 @@ async function callCompletionApi({
                   result += streamPart.delta;
                   setCompletion(result);
                 } else if (streamPart.type === "error") {
-                  throw new Error(streamPart.errorText);
+                  throw new UIMessageStreamError({
+                    chunkType: "error",
+                    chunkId: "",
+                    message: streamPart.errorText
+                  });
                 }
               }
             })
@@ -19069,7 +19109,11 @@ async function callCompletionApi({
       }
       default: {
         const exhaustiveCheck = streamProtocol;
-        throw new Error(`Unknown stream protocol: ${exhaustiveCheck}`);
+        throw new InvalidArgumentError({
+          parameter: "streamProtocol",
+          value: exhaustiveCheck,
+          message: `Unknown stream protocol: ${exhaustiveCheck}`
+        });
       }
     }
     if (onFinish) {
@@ -19099,12 +19143,16 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/ui/convert-file-list-to-file-ui-parts.ts
+import { UnsupportedFunctionalityError as UnsupportedFunctionalityError6 } from "@ai-sdk/provider";
 async function convertFileListToFileUIParts(files) {
   if (files == null) {
     return [];
   }
   if (!globalThis.FileList || !(files instanceof globalThis.FileList)) {
-    throw new Error("FileList is not supported in the current environment");
+    throw new UnsupportedFunctionalityError6({
+      functionality: "FileList",
+      message: "FileList is not supported in the current environment"
+    });
   }
   return Promise.all(
     Array.from(files).map(async (file) => {
@@ -19136,6 +19184,7 @@ import {
   normalizeHeaders,
   resolve as resolve2
 } from "@ai-sdk/provider-utils";
+import { EmptyResponseBodyError as EmptyResponseBodyError3 } from "@ai-sdk/provider";
 var HttpChatTransport = class {
   constructor({
     api = "/api/chat",
@@ -19200,12 +19249,16 @@ var HttpChatTransport = class {
       signal: abortSignal
     });
     if (!response.ok) {
-      throw new Error(
-        await response.text() || "Failed to fetch the chat response."
-      );
+      throw await createUIApiCallError({
+        response,
+        url: api,
+        fallbackMessage: "Failed to fetch the chat response."
+      });
     }
     if (!response.body) {
-      throw new Error("The response body is empty.");
+      throw new EmptyResponseBodyError3({
+        message: "The response body is empty."
+      });
     }
     return this.processResponseStream(response.body);
   }
@@ -19240,12 +19293,16 @@ var HttpChatTransport = class {
       return null;
     }
     if (!response.ok) {
-      throw new Error(
-        await response.text() || "Failed to fetch the chat response."
-      );
+      throw await createUIApiCallError({
+        response,
+        url: api,
+        fallbackMessage: "Failed to fetch the chat response."
+      });
     }
     if (!response.body) {
-      throw new Error("The response body is empty.");
+      throw new EmptyResponseBodyError3({
+        message: "The response body is empty."
+      });
     }
     return this.processResponseStream(response.body);
   }
@@ -19335,12 +19392,18 @@ var AbstractChat = class {
           (m) => m.id === message.messageId
         );
         if (messageIndex === -1) {
-          throw new Error(`message with id ${message.messageId} not found`);
+          throw new InvalidArgumentError({
+            parameter: "message.messageId",
+            value: message.messageId,
+            message: `message with id ${message.messageId} not found`
+          });
         }
         if (this.state.messages[messageIndex].role !== "user") {
-          throw new Error(
-            `message with id ${message.messageId} is not a user message`
-          );
+          throw new InvalidArgumentError({
+            parameter: "message.messageId",
+            value: message.messageId,
+            message: `message with id ${message.messageId} is not a user message`
+          });
         }
         this.state.messages = this.state.messages.slice(0, messageIndex + 1);
         this.state.replaceMessage(messageIndex, {
@@ -19373,7 +19436,11 @@ var AbstractChat = class {
     } = {}) => {
       const messageIndex = messageId == null ? this.state.messages.length - 1 : this.state.messages.findIndex((message) => message.id === messageId);
       if (messageIndex === -1) {
-        throw new Error(`message ${messageId} not found`);
+        throw new InvalidArgumentError({
+          parameter: "messageId",
+          value: messageId,
+          message: `message ${messageId} not found`
+        });
       }
       this.state.messages = this.state.messages.slice(
         0,