ai 7.0.88 → 7.0.89

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # ai
 
+## 7.0.89
+
+### Patch Changes
+
+- 5190b67: feat(provider): extend the FilesV4 interface with optional `getFileMetadata`, `downloadFile` (streaming), and `deleteFile` operations, plus `abortSignal`/`headers` call options and a `{ type: 'stream' }` upload data variant; upload results now expose `byteSize`, `createdAt`, and `expiresAt` (also surfaced by the core `uploadFile()` helper, which now forwards `abortSignal`/`headers`); add `postMultipartStreamToApi` (streaming multipart uploads with deterministic part ordering and failure-path stream teardown), `deleteFromApi`, and `createBinaryStreamResponseHandler` to provider-utils
+- Updated dependencies [5190b67]
+  - @ai-sdk/provider@4.0.10
+  - @ai-sdk/provider-utils@5.0.35
+  - @ai-sdk/gateway@4.0.71
+
 ## 7.0.88
 
 ### Patch Changes

package/dist/index.d.ts

@@ -9609,6 +9609,18 @@ interface UploadFileResult {
     readonly providerReference: ProviderReference;
     readonly mediaType?: string;
     readonly filename?: string;
+    /**
+     * The size of the uploaded file in bytes, if reported by the provider.
+     */
+    readonly byteSize?: number;
+    /**
+     * When the file was created, if reported by the provider.
+     */
+    readonly createdAt?: Date;
+    /**
+     * When the provider will delete the file (retention expiry), if reported.
+     */
+    readonly expiresAt?: Date;
     readonly providerMetadata?: ProviderMetadata;
     readonly warnings: Array<Warning>;
 }
@@ -9617,15 +9629,25 @@ interface UploadFileResult {
  * Uploads a file using a files API interface.
  *
  * @param api - The Files API interface to use for uploading.
- * @param data - The file data to upload (tagged `{ type: 'data' | 'text' }`).
+ * @param data - The file data to upload (tagged `{ type: 'data' | 'text' | 'stream' }`).
+ * Stream data is sent without buffering by providers that support streaming
+ * uploads (others reject with `UnsupportedFunctionalityError`); the provider
+ * consumes the stream — any failed upload, including validation failures
+ * before a request is made, cancels it. Do not reuse it.
  * @param mediaType - Optional IANA media type. Auto-detected from file bytes
- * when omitted (falls back to `text/plain` for the `text` variant).
- * @param filename - Optional filename for the uploaded file.
+ * when omitted (falls back to `text/plain` for the `text` variant and
+ * `application/octet-stream` for the `stream` variant, which cannot be sniffed).
+ * @param filename - Optional filename for the uploaded file. Multipart-based
+ * providers default it to `"blob"` when omitted.
+ * @param abortSignal - Optional signal to cancel the upload.
+ * @param headers - Optional additional HTTP headers for the request.
  * @param providerOptions - Additional provider-specific options.
  *
- * @returns A result object containing the provider reference and optional metadata.
+ * @returns A result object containing the provider reference, optional
+ * metadata, and — when reported by the provider — `byteSize`, `createdAt`,
+ * and `expiresAt` (the provider-applied retention expiry).
  */
-declare function uploadFile({ api, data: dataArg, mediaType: mediaTypeArg, filename, providerOptions, }: {
+declare function uploadFile({ api, data: dataArg, mediaType: mediaTypeArg, filename, abortSignal, headers, providerOptions, }: {
     /**
      * The files API interface to use for uploading.
      * Can be a `FilesV4` instance or a `ProviderV4` instance with a `files()` method.

package/dist/index.js

@@ -1176,7 +1176,7 @@ import {
 } from "@ai-sdk/provider-utils";
 
 // src/version.ts
-var VERSION = true ? "7.0.88" : "0.0.0-test";
+var VERSION = true ? "7.0.89" : "0.0.0-test";
 
 // src/util/download/download.ts
 var download = async ({
@@ -19017,26 +19017,42 @@ async function uploadFile({
   data: dataArg,
   mediaType: mediaTypeArg,
   filename,
+  abortSignal,
+  headers,
   providerOptions
 }) {
   var _a25;
   const data = dataArg instanceof Uint8Array || typeof dataArg === "string" ? { type: "data", data: dataArg } : dataArg;
-  const mediaType = mediaTypeArg != null ? mediaTypeArg : data.type === "text" ? "text/plain" : (_a25 = detectMediaType6({ data: data.data })) != null ? _a25 : isLikelyText(data.data) ? "text/plain" : "application/octet-stream";
-  const filesApi = "uploadFile" in api ? api : typeof api.files === "function" ? api.files() : (() => {
-    throw new Error(
-      "The provider does not support file uploads. Make sure it exposes a files() method."
-    );
-  })();
-  const result = await filesApi.uploadFile({
-    data,
-    mediaType,
-    filename,
-    providerOptions
-  });
+  const mediaType = mediaTypeArg != null ? mediaTypeArg : data.type === "text" ? "text/plain" : data.type === "stream" ? "application/octet-stream" : (_a25 = detectMediaType6({ data: data.data })) != null ? _a25 : isLikelyText(data.data) ? "text/plain" : "application/octet-stream";
+  let result;
+  try {
+    const filesApi = "uploadFile" in api ? api : typeof api.files === "function" ? api.files() : (() => {
+      throw new Error(
+        "The provider does not support file uploads. Make sure it exposes a files() method."
+      );
+    })();
+    result = await filesApi.uploadFile({
+      data,
+      mediaType,
+      filename,
+      abortSignal,
+      headers,
+      providerOptions
+    });
+  } catch (error) {
+    if (data.type === "stream") {
+      await data.stream.cancel(error).catch(() => {
+      });
+    }
+    throw error;
+  }
   return new DefaultUploadFileResult({
     providerReference: result.providerReference,
     mediaType: result.mediaType,
     filename: result.filename,
+    byteSize: result.byteSize,
+    createdAt: result.createdAt,
+    expiresAt: result.expiresAt,
     providerMetadata: result.providerMetadata,
     warnings: result.warnings
   });
@@ -19046,6 +19062,9 @@ var DefaultUploadFileResult = class {
     this.providerReference = options.providerReference;
     this.mediaType = options.mediaType;
     this.filename = options.filename;
+    this.byteSize = options.byteSize;
+    this.createdAt = options.createdAt;
+    this.expiresAt = options.expiresAt;
     this.providerMetadata = options.providerMetadata;
     this.warnings = options.warnings;
   }