@ai-sdk/xai 4.0.51 → 4.0.53

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @ai-sdk/xai
 
+## 4.0.53
+
+### Patch Changes
+
+- Updated dependencies [6bcc0f8]
+  - @ai-sdk/provider-utils@5.0.36
+
+## 4.0.52
+
+### Patch Changes
+
+- f1513f0: feat(xai): implement `getFileMetadata`, `downloadFile` (streaming), and `deleteFile` on the xAI files interface, support `expiresAfter` upload TTLs (integer 3600–2592000 seconds, emitted before the file part as xAI requires) and streaming uploads via `{ type: 'stream' }` data, expose `byteSize`/`createdAt`/`expiresAt` on upload results, and thread `abortSignal`/`headers` through all file operations; blank and dot-segment file ids are rejected/encoded so they cannot retarget request paths
+- Updated dependencies [5190b67]
+  - @ai-sdk/provider@4.0.10
+  - @ai-sdk/provider-utils@5.0.35
+
 ## 4.0.51
 
 ### Patch Changes

package/dist/index.d.ts

@@ -248,6 +248,7 @@ declare const xaiFilesOptionsSchema: _ai_sdk_provider_utils.LazySchema<{
     [x: string]: unknown;
     teamId?: string | undefined;
     filePath?: string | undefined;
+    expiresAfter?: number | undefined;
 }>;
 type XaiFilesOptions = InferSchema<typeof xaiFilesOptionsSchema>;
 

package/dist/index.js

@@ -1270,12 +1270,22 @@ var xaiFilesResponseSchema = lazySchema(
       object: z7.string().nullish(),
       bytes: z7.number().nullish(),
       created_at: z7.number().nullish(),
+      expires_at: z7.number().nullish(),
       filename: z7.string().nullish(),
       purpose: z7.string().nullish(),
       status: z7.string().nullish()
     })
   )
 );
+var xaiFileDeleteResponseSchema = lazySchema(
+  () => zodSchema(
+    z7.object({
+      id: z7.string(),
+      object: z7.string().nullish(),
+      deleted: z7.boolean()
+    })
+  )
+);
 
 // src/responses/xai-responses-language-model.ts
 import {
@@ -4319,15 +4329,22 @@ var xaiTools = {
 };
 
 // src/version.ts
-var VERSION = true ? "4.0.51" : "0.0.0-test";
+var VERSION = true ? "4.0.53" : "0.0.0-test";
 
 // src/files/xai-files.ts
+import {
+  InvalidArgumentError as InvalidArgumentError2
+} from "@ai-sdk/provider";
 import {
   combineHeaders as combineHeaders5,
   convertInlineFileDataToUint8Array,
+  createBinaryStreamResponseHandler,
   createJsonResponseHandler as createJsonResponseHandler5,
+  deleteFromApi,
+  getFromApi as getFromApi3,
   parseProviderOptions as parseProviderOptions6,
-  postFormDataToApi as postFormDataToApi2
+  postFormDataToApi as postFormDataToApi2,
+  postMultipartStreamToApi
 } from "@ai-sdk/provider-utils";
 
 // src/files/xai-files-options.ts
@@ -4340,12 +4357,22 @@ var xaiFilesOptionsSchema = lazySchema8(
   () => zodSchema8(
     z19.looseObject({
       teamId: z19.string().optional(),
-      filePath: z19.string().optional()
+      filePath: z19.string().optional(),
+      /**
+       * TTL in seconds measured from upload time; xAI accepts integers
+       * between 3600 (1 hour) and 2592000 (30 days) inclusive.
+       * Omit to keep the file until it is deleted.
+       */
+      expiresAfter: z19.number().int().min(3600).max(2592e3).optional()
     })
   )
 );
 
 // src/files/xai-files.ts
+function encodePathSegment(value) {
+  const encodedValue = encodeURIComponent(value);
+  return encodedValue === "." ? "%252E" : encodedValue === ".." ? "%252E%252E" : encodedValue;
+}
 var XaiFiles = class {
   constructor(config) {
     this.config = config;
@@ -4354,55 +4381,205 @@ var XaiFiles = class {
   get provider() {
     return this.config.provider;
   }
+  getFileId(file) {
+    const fileId = file.xai;
+    if (fileId == null || fileId.trim() === "") {
+      throw new InvalidArgumentError2({
+        argument: "file",
+        message: "file reference is missing an 'xai' file id."
+      });
+    }
+    return fileId;
+  }
+  getHeaders(headers) {
+    return combineHeaders5(this.config.headers(), headers);
+  }
   async uploadFile({
     data,
     mediaType,
     filename,
+    abortSignal,
+    headers,
     providerOptions
   }) {
     var _a, _b;
-    const xaiOptions = await parseProviderOptions6({
-      provider: "xai",
-      providerOptions,
-      schema: xaiFilesOptionsSchema
-    });
-    const fileBytes = convertInlineFileDataToUint8Array(data);
-    const blob = new Blob([fileBytes], {
-      type: mediaType
-    });
-    const formData = new FormData();
-    if (filename != null) {
-      formData.append("file", blob, filename);
-    } else {
-      formData.append("file", blob);
+    let xaiOptions;
+    try {
+      xaiOptions = await parseProviderOptions6({
+        provider: "xai",
+        providerOptions,
+        schema: xaiFilesOptionsSchema
+      });
+    } catch (error) {
+      if (data.type === "stream") {
+        await data.stream.cancel(error).catch(() => {
+        });
+      }
+      throw error;
     }
-    if ((xaiOptions == null ? void 0 : xaiOptions.teamId) != null) {
-      formData.append("team_id", xaiOptions.teamId);
+    const requestHeaders = this.getHeaders(headers);
+    const url = `${this.config.baseURL}/files`;
+    let response;
+    if (data.type === "stream") {
+      const parts = [];
+      if ((xaiOptions == null ? void 0 : xaiOptions.expiresAfter) != null) {
+        parts.push({
+          type: "field",
+          name: "expires_after",
+          value: String(xaiOptions.expiresAfter)
+        });
+      }
+      if ((xaiOptions == null ? void 0 : xaiOptions.teamId) != null) {
+        parts.push({
+          type: "field",
+          name: "team_id",
+          value: xaiOptions.teamId
+        });
+      }
+      parts.push({
+        type: "file",
+        name: "file",
+        filename,
+        mediaType,
+        content: data.stream
+      });
+      ({ value: response } = await postMultipartStreamToApi({
+        url,
+        headers: requestHeaders,
+        parts,
+        failedResponseHandler: xaiFailedResponseHandler,
+        successfulResponseHandler: createJsonResponseHandler5(
+          xaiFilesResponseSchema
+        ),
+        abortSignal,
+        fetch: this.config.fetch
+      }));
+    } else {
+      const fileBytes = convertInlineFileDataToUint8Array(data);
+      const blob = new Blob([fileBytes], {
+        type: mediaType
+      });
+      const formData = new FormData();
+      if ((xaiOptions == null ? void 0 : xaiOptions.expiresAfter) != null) {
+        formData.append("expires_after", String(xaiOptions.expiresAfter));
+      }
+      if ((xaiOptions == null ? void 0 : xaiOptions.teamId) != null) {
+        formData.append("team_id", xaiOptions.teamId);
+      }
+      if (filename != null) {
+        formData.append("file", blob, filename);
+      } else {
+        formData.append("file", blob);
+      }
+      ({ value: response } = await postFormDataToApi2({
+        url,
+        headers: requestHeaders,
+        formData,
+        failedResponseHandler: xaiFailedResponseHandler,
+        successfulResponseHandler: createJsonResponseHandler5(
+          xaiFilesResponseSchema
+        ),
+        abortSignal,
+        fetch: this.config.fetch
+      }));
     }
-    const { value: response } = await postFormDataToApi2({
-      url: `${this.config.baseURL}/files`,
-      headers: combineHeaders5(this.config.headers()),
-      formData,
+    return {
+      warnings: [],
+      providerReference: { xai: response.id },
+      ...((_a = response.filename) != null ? _a : filename) ? { filename: (_b = response.filename) != null ? _b : filename } : {},
+      ...mediaType != null ? { mediaType } : {},
+      ...response.bytes != null ? { byteSize: response.bytes } : {},
+      ...response.created_at != null ? { createdAt: new Date(response.created_at * 1e3) } : {},
+      ...response.expires_at != null ? { expiresAt: new Date(response.expires_at * 1e3) } : {},
+      providerMetadata: {
+        xai: this.toFileMetadata(response)
+      }
+    };
+  }
+  async getFileMetadata({
+    file,
+    abortSignal,
+    headers
+  }) {
+    const fileId = this.getFileId(file);
+    const { value: response } = await getFromApi3({
+      url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}`,
+      headers: this.getHeaders(headers),
       failedResponseHandler: xaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler5(
         xaiFilesResponseSchema
       ),
-      fetch: this.config.fetch
+      abortSignal,
+      fetch: this.config.fetch,
+      validateUrl: false
     });
     return {
       warnings: [],
       providerReference: { xai: response.id },
-      ...((_a = response.filename) != null ? _a : filename) ? { filename: (_b = response.filename) != null ? _b : filename } : {},
-      ...mediaType != null ? { mediaType } : {},
+      ...response.filename != null ? { filename: response.filename } : {},
+      ...response.bytes != null ? { byteSize: response.bytes } : {},
+      ...response.created_at != null ? { createdAt: new Date(response.created_at * 1e3) } : {},
+      ...response.expires_at != null ? { expiresAt: new Date(response.expires_at * 1e3) } : {},
       providerMetadata: {
-        xai: {
-          ...response.filename != null ? { filename: response.filename } : {},
-          ...response.bytes != null ? { bytes: response.bytes } : {},
-          ...response.created_at != null ? { createdAt: response.created_at } : {}
-        }
+        xai: this.toFileMetadata(response)
       }
     };
   }
+  async downloadFile({
+    file,
+    abortSignal,
+    headers
+  }) {
+    var _a;
+    const fileId = this.getFileId(file);
+    const { value: content, responseHeaders } = await getFromApi3({
+      url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}/content`,
+      headers: this.getHeaders(headers),
+      failedResponseHandler: xaiFailedResponseHandler,
+      successfulResponseHandler: createBinaryStreamResponseHandler(),
+      abortSignal,
+      fetch: this.config.fetch,
+      validateUrl: false
+    });
+    const mediaType = (_a = responseHeaders == null ? void 0 : responseHeaders["content-type"]) == null ? void 0 : _a.split(";")[0].trim();
+    return {
+      warnings: [],
+      content,
+      ...mediaType ? { mediaType } : {}
+    };
+  }
+  async deleteFile({
+    file,
+    abortSignal,
+    headers
+  }) {
+    const fileId = this.getFileId(file);
+    const { value: response } = await deleteFromApi({
+      url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}`,
+      headers: this.getHeaders(headers),
+      failedResponseHandler: xaiFailedResponseHandler,
+      successfulResponseHandler: createJsonResponseHandler5(
+        xaiFileDeleteResponseSchema
+      ),
+      abortSignal,
+      fetch: this.config.fetch
+    });
+    return {
+      warnings: [],
+      providerReference: { xai: response.id },
+      deleted: response.deleted
+    };
+  }
+  toFileMetadata(response) {
+    return {
+      ...response.filename != null ? { filename: response.filename } : {},
+      ...response.purpose != null ? { purpose: response.purpose } : {},
+      ...response.bytes != null ? { bytes: response.bytes } : {},
+      ...response.created_at != null ? { createdAt: response.created_at } : {},
+      ...response.status != null ? { status: response.status } : {},
+      ...response.expires_at != null ? { expiresAt: response.expires_at } : {}
+    };
+  }
 };
 
 // src/xai-video-model.ts
@@ -4415,7 +4592,7 @@ import {
   convertUint8ArrayToBase64,
   createJsonResponseHandler as createJsonResponseHandler6,
   extractResponseHeaders as extractResponseHeaders2,
-  getFromApi as getFromApi3,
+  getFromApi as getFromApi4,
   getTopLevelMediaType as getTopLevelMediaType3,
   parseProviderOptions as parseProviderOptions7,
   postJsonToApi as postJsonToApi5,
@@ -4447,7 +4624,7 @@ var xaiVideoModelOptionsSchema = lazySchema9(
 );
 
 // src/xai-video-model.ts
-function encodePathSegment(value) {
+function encodePathSegment2(value) {
   const encodedValue = encodeURIComponent(value);
   return encodedValue === "." ? "%252E" : encodedValue === ".." ? "%252E%252E" : encodedValue;
 }
@@ -4770,8 +4947,8 @@ var XaiVideoModel = class {
     const currentDate = (_c = (_b = (_a = this.config._internal) == null ? void 0 : _a.currentDate) == null ? void 0 : _b.call(_a)) != null ? _c : /* @__PURE__ */ new Date();
     const { requestId } = options.operation;
     const baseURL = (_d = this.config.baseURL) != null ? _d : "https://api.x.ai/v1";
-    const { value: statusResponse, responseHeaders } = await getFromApi3({
-      url: `${baseURL}/videos/${encodePathSegment(requestId)}`,
+    const { value: statusResponse, responseHeaders } = await getFromApi4({
+      url: `${baseURL}/videos/${encodePathSegment2(requestId)}`,
       validateUrl: false,
       headers: combineHeaders6(this.config.headers(), options.headers),
       successfulResponseHandler: xaiVideoStatusResponseHandler,
@@ -5162,7 +5339,7 @@ var xaiSpeechTimestampsResponseSchema = z23.object({
 
 // src/xai-transcription-model.ts
 import {
-  InvalidArgumentError as InvalidArgumentError2
+  InvalidArgumentError as InvalidArgumentError3
 } from "@ai-sdk/provider";
 import {
   combineHeaders as combineHeaders8,
@@ -5366,7 +5543,7 @@ var XaiTranscriptionModel = class _XaiTranscriptionModel {
       schema: xaiTranscriptionModelOptionsSchema
     });
     if ((xaiOptions == null ? void 0 : xaiOptions.multichannel) === true && xaiOptions.channels == null) {
-      throw new InvalidArgumentError2({
+      throw new InvalidArgumentError3({
         argument: "providerOptions",
         message: "providerOptions.xai.channels is required when providerOptions.xai.multichannel is true"
       });