@mistralai/mistralai 1.7.3 → 1.7.4

package/README.md

@@ -256,6 +256,33 @@ We have dedicated SDKs for the following providers:
 * [appendStream](docs/sdks/conversations/README.md#appendstream) - Append new entries to an existing conversation.
 * [restartStream](docs/sdks/conversations/README.md#restartstream) - Restart a conversation starting from a given entry.
 
+#### [beta.libraries](docs/sdks/libraries/README.md)
+
+* [list](docs/sdks/libraries/README.md#list) - List all libraries you have access to.
+* [create](docs/sdks/libraries/README.md#create) - Create a new Library.
+* [get](docs/sdks/libraries/README.md#get) - Detailed information about a specific Library.
+* [delete](docs/sdks/libraries/README.md#delete) - Delete a library and all of it's document.
+* [update](docs/sdks/libraries/README.md#update) - Update a library.
+
+#### [beta.libraries.accesses](docs/sdks/accesses/README.md)
+
+* [list](docs/sdks/accesses/README.md#list) - List all of the access to this library.
+* [updateOrCreate](docs/sdks/accesses/README.md#updateorcreate) - Create or update an access level.
+* [delete](docs/sdks/accesses/README.md#delete) - Delete an access level.
+
+#### [beta.libraries.documents](docs/sdks/documents/README.md)
+
+* [list](docs/sdks/documents/README.md#list) - List document in a given library.
+* [upload](docs/sdks/documents/README.md#upload) - Upload a new document.
+* [get](docs/sdks/documents/README.md#get) - Retrieve the metadata of a specific document.
+* [update](docs/sdks/documents/README.md#update) - Update the metadata of a specific document.
+* [delete](docs/sdks/documents/README.md#delete) - Delete a document.
+* [textContent](docs/sdks/documents/README.md#textcontent) - Retrieve the text content of a specific document.
+* [status](docs/sdks/documents/README.md#status) - Retrieve the processing status of a specific document.
+* [getSignedUrl](docs/sdks/documents/README.md#getsignedurl) - Retrieve the signed URL of a specific document.
+* [extractedTextSignedUrl](docs/sdks/documents/README.md#extractedtextsignedurl) - Retrieve the signed URL of text extracted from a given document.
+* [reprocess](docs/sdks/documents/README.md#reprocess) - Reprocess a document.
+
 ### [chat](docs/sdks/chat/README.md)
 
 * [complete](docs/sdks/chat/README.md#complete) - Chat Completion
@@ -372,8 +399,11 @@ const mistral = new Mistral({
 });
 
 async function run() {
-  const result = await mistral.files.upload({
-    file: await openAsBlob("example.file"),
+  const result = await mistral.beta.libraries.documents.upload({
+    libraryId: "6886a454-7910-4a2b-b98a-ab61ec65fc41",
+    requestBody: {
+      file: await openAsBlob("example.file"),
+    },
   });
 
   // Handle the result
@@ -698,6 +728,24 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`betaConversationsRestartStream`](docs/sdks/conversations/README.md#restartstream) - Restart a conversation starting from a given entry.
 - [`betaConversationsStart`](docs/sdks/conversations/README.md#start) - Create a conversation and append entries to it.
 - [`betaConversationsStartStream`](docs/sdks/conversations/README.md#startstream) - Create a conversation and append entries to it.
+- [`betaLibrariesAccessesDelete`](docs/sdks/accesses/README.md#delete) - Delete an access level.
+- [`betaLibrariesAccessesList`](docs/sdks/accesses/README.md#list) - List all of the access to this library.
+- [`betaLibrariesAccessesUpdateOrCreate`](docs/sdks/accesses/README.md#updateorcreate) - Create or update an access level.
+- [`betaLibrariesCreate`](docs/sdks/libraries/README.md#create) - Create a new Library.
+- [`betaLibrariesDelete`](docs/sdks/libraries/README.md#delete) - Delete a library and all of it's document.
+- [`betaLibrariesDocumentsDelete`](docs/sdks/documents/README.md#delete) - Delete a document.
+- [`betaLibrariesDocumentsExtractedTextSignedUrl`](docs/sdks/documents/README.md#extractedtextsignedurl) - Retrieve the signed URL of text extracted from a given document.
+- [`betaLibrariesDocumentsGet`](docs/sdks/documents/README.md#get) - Retrieve the metadata of a specific document.
+- [`betaLibrariesDocumentsGetSignedUrl`](docs/sdks/documents/README.md#getsignedurl) - Retrieve the signed URL of a specific document.
+- [`betaLibrariesDocumentsList`](docs/sdks/documents/README.md#list) - List document in a given library.
+- [`betaLibrariesDocumentsReprocess`](docs/sdks/documents/README.md#reprocess) - Reprocess a document.
+- [`betaLibrariesDocumentsStatus`](docs/sdks/documents/README.md#status) - Retrieve the processing status of a specific document.
+- [`betaLibrariesDocumentsTextContent`](docs/sdks/documents/README.md#textcontent) - Retrieve the text content of a specific document.
+- [`betaLibrariesDocumentsUpdate`](docs/sdks/documents/README.md#update) - Update the metadata of a specific document.
+- [`betaLibrariesDocumentsUpload`](docs/sdks/documents/README.md#upload) - Upload a new document.
+- [`betaLibrariesGet`](docs/sdks/libraries/README.md#get) - Detailed information about a specific Library.
+- [`betaLibrariesList`](docs/sdks/libraries/README.md#list) - List all libraries you have access to.
+- [`betaLibrariesUpdate`](docs/sdks/libraries/README.md#update) - Update a library.
 - [`chatComplete`](docs/sdks/chat/README.md#complete) - Chat Completion
 - [`chatStream`](docs/sdks/chat/README.md#stream) - Stream chat completion
 - [`classifiersClassify`](docs/sdks/classifiers/README.md#classify) - Classifications

package/docs/sdks/accesses/README.md

@@ -0,0 +1,263 @@
+# Accesses
+(*beta.libraries.accesses*)
+
+## Overview
+
+### Available Operations
+
+* [list](#list) - List all of the access to this library.
+* [updateOrCreate](#updateorcreate) - Create or update an access level.
+* [delete](#delete) - Delete an access level.
+
+## list
+
+Given a library, list all of the Entity that have access and to what level.
+
+### Example Usage
+
+```typescript
+import { Mistral } from "@mistralai/mistralai";
+
+const mistral = new Mistral({
+  apiKey: process.env["MISTRAL_API_KEY"] ?? "",
+});
+
+async function run() {
+  const result = await mistral.beta.libraries.accesses.list({
+    libraryId: "c8a232aa-0b11-4b8a-b005-71e9e705d0e6",
+  });
+
+  // Handle the result
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { MistralCore } from "@mistralai/mistralai/core.js";
+import { betaLibrariesAccessesList } from "@mistralai/mistralai/funcs/betaLibrariesAccessesList.js";
+
+// Use `MistralCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const mistral = new MistralCore({
+  apiKey: process.env["MISTRAL_API_KEY"] ?? "",
+});
+
+async function run() {
+  const res = await betaLibrariesAccessesList(mistral, {
+    libraryId: "c8a232aa-0b11-4b8a-b005-71e9e705d0e6",
+  });
+
+  if (!res.ok) {
+    throw res.error;
+  }
+
+  const { value: result } = res;
+
+  // Handle the result
+  console.log(result);
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.LibrariesShareListV1Request](../../models/operations/librariessharelistv1request.md)                                                                               | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.ListSharingOut](../../models/components/listsharingout.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.SDKError            | 4XX, 5XX                   | \*/\*                      |
+
+## updateOrCreate
+
+Given a library id, you can create or update the access level of an entity. You have to be owner of the library to share a library. An owner cannot change their own role. A library cannot be shared outside of the organization.
+
+### Example Usage
+
+```typescript
+import { Mistral } from "@mistralai/mistralai";
+
+const mistral = new Mistral({
+  apiKey: process.env["MISTRAL_API_KEY"] ?? "",
+});
+
+async function run() {
+  const result = await mistral.beta.libraries.accesses.updateOrCreate({
+    libraryId: "e24dc3a8-24c6-4b2e-8108-3f00cec89687",
+    sharingIn: {
+      orgId: "9543b76d-ef36-4022-8fc2-3cdec423babe",
+      level: "Editor",
+      shareWithUuid: "5c2bae94-726a-4824-98ee-0429525e4adf",
+      shareWithType: "Org",
+    },
+  });
+
+  // Handle the result
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { MistralCore } from "@mistralai/mistralai/core.js";
+import { betaLibrariesAccessesUpdateOrCreate } from "@mistralai/mistralai/funcs/betaLibrariesAccessesUpdateOrCreate.js";
+
+// Use `MistralCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const mistral = new MistralCore({
+  apiKey: process.env["MISTRAL_API_KEY"] ?? "",
+});
+
+async function run() {
+  const res = await betaLibrariesAccessesUpdateOrCreate(mistral, {
+    libraryId: "e24dc3a8-24c6-4b2e-8108-3f00cec89687",
+    sharingIn: {
+      orgId: "9543b76d-ef36-4022-8fc2-3cdec423babe",
+      level: "Editor",
+      shareWithUuid: "5c2bae94-726a-4824-98ee-0429525e4adf",
+      shareWithType: "Org",
+    },
+  });
+
+  if (!res.ok) {
+    throw res.error;
+  }
+
+  const { value: result } = res;
+
+  // Handle the result
+  console.log(result);
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.LibrariesShareCreateV1Request](../../models/operations/librariessharecreatev1request.md)                                                                           | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.SharingOut](../../models/components/sharingout.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.SDKError            | 4XX, 5XX                   | \*/\*                      |
+
+## delete
+
+Given a library id, you can delete the access level of an entity. An owner cannot delete it's own access. You have to be the owner of the library to delete an acces other than yours.
+
+### Example Usage
+
+```typescript
+import { Mistral } from "@mistralai/mistralai";
+
+const mistral = new Mistral({
+  apiKey: process.env["MISTRAL_API_KEY"] ?? "",
+});
+
+async function run() {
+  const result = await mistral.beta.libraries.accesses.delete({
+    libraryId: "460ea4f9-1d0d-46c0-ba7e-bf643773e381",
+    sharingDelete: {
+      orgId: "8b6fe91a-a0b1-4b3e-ab7b-e83a32f2399e",
+      shareWithUuid: "7aa10743-a04f-44af-84fe-b54259caa1ba",
+      shareWithType: "Workspace",
+    },
+  });
+
+  // Handle the result
+  console.log(result);
+}
+
+run();
+```
+
+### Standalone function
+
+The standalone function version of this method:
+
+```typescript
+import { MistralCore } from "@mistralai/mistralai/core.js";
+import { betaLibrariesAccessesDelete } from "@mistralai/mistralai/funcs/betaLibrariesAccessesDelete.js";
+
+// Use `MistralCore` for best tree-shaking performance.
+// You can create one instance of it to use across an application.
+const mistral = new MistralCore({
+  apiKey: process.env["MISTRAL_API_KEY"] ?? "",
+});
+
+async function run() {
+  const res = await betaLibrariesAccessesDelete(mistral, {
+    libraryId: "460ea4f9-1d0d-46c0-ba7e-bf643773e381",
+    sharingDelete: {
+      orgId: "8b6fe91a-a0b1-4b3e-ab7b-e83a32f2399e",
+      shareWithUuid: "7aa10743-a04f-44af-84fe-b54259caa1ba",
+      shareWithType: "Workspace",
+    },
+  });
+
+  if (!res.ok) {
+    throw res.error;
+  }
+
+  const { value: result } = res;
+
+  // Handle the result
+  console.log(result);
+}
+
+run();
+```
+
+### Parameters
+
+| Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.LibrariesShareDeleteV1Request](../../models/operations/librariessharedeletev1request.md)                                                                           | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
+| `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
+| `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
+| `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
+
+### Response
+
+**Promise\<[components.SharingOut](../../models/components/sharingout.md)\>**
+
+### Errors
+
+| Error Type                 | Status Code                | Content Type               |
+| -------------------------- | -------------------------- | -------------------------- |
+| errors.HTTPValidationError | 422                        | application/json           |
+| errors.SDKError            | 4XX, 5XX                   | \*/\*                      |