node-appwrite 17.0.0 → 17.1.0

package/dist/services/databases.mjs

@@ -1577,14 +1577,16 @@ var Databases = class {
     );
   }
   /**
-   * Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
-   *
-   * @param {string} databaseId
-   * @param {string} collectionId
-   * @param {object[]} documents
-   * @throws {AppwriteException}
-   * @returns {Promise<Models.DocumentList<Document>>}
-   */
+       * **WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+  
+  Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
+       *
+       * @param {string} databaseId
+       * @param {string} collectionId
+       * @param {object[]} documents
+       * @throws {AppwriteException}
+       * @returns {Promise<Models.DocumentList<Document>>}
+       */
   createDocuments(databaseId, collectionId, documents) {
     if (typeof databaseId === "undefined") {
       throw new AppwriteException('Missing required parameter: "databaseId"');
@@ -1612,8 +1614,9 @@ var Databases = class {
     );
   }
   /**
-       * Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
+       * **WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
   
+  Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
        *
        * @param {string} databaseId
        * @param {string} collectionId
@@ -1628,6 +1631,9 @@ var Databases = class {
     if (typeof collectionId === "undefined") {
       throw new AppwriteException('Missing required parameter: "collectionId"');
     }
+    if (typeof documents === "undefined") {
+      throw new AppwriteException('Missing required parameter: "documents"');
+    }
     const apiPath = "/databases/{databaseId}/collections/{collectionId}/documents".replace("{databaseId}", databaseId).replace("{collectionId}", collectionId);
     const payload = {};
     if (typeof documents !== "undefined") {
@@ -1645,15 +1651,17 @@ var Databases = class {
     );
   }
   /**
-   * Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.
-   *
-   * @param {string} databaseId
-   * @param {string} collectionId
-   * @param {object} data
-   * @param {string[]} queries
-   * @throws {AppwriteException}
-   * @returns {Promise<Models.DocumentList<Document>>}
-   */
+       * **WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+  
+  Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.
+       *
+       * @param {string} databaseId
+       * @param {string} collectionId
+       * @param {object} data
+       * @param {string[]} queries
+       * @throws {AppwriteException}
+       * @returns {Promise<Models.DocumentList<Document>>}
+       */
   updateDocuments(databaseId, collectionId, data, queries) {
     if (typeof databaseId === "undefined") {
       throw new AppwriteException('Missing required parameter: "databaseId"');
@@ -1681,14 +1689,16 @@ var Databases = class {
     );
   }
   /**
-   * Bulk delete documents using queries, if no queries are passed then all documents are deleted.
-   *
-   * @param {string} databaseId
-   * @param {string} collectionId
-   * @param {string[]} queries
-   * @throws {AppwriteException}
-   * @returns {Promise<Models.DocumentList<Document>>}
-   */
+       * **WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+  
+  Bulk delete documents using queries, if no queries are passed then all documents are deleted.
+       *
+       * @param {string} databaseId
+       * @param {string} collectionId
+       * @param {string[]} queries
+       * @throws {AppwriteException}
+       * @returns {Promise<Models.DocumentList<Document>>}
+       */
   deleteDocuments(databaseId, collectionId, queries) {
     if (typeof databaseId === "undefined") {
       throw new AppwriteException('Missing required parameter: "databaseId"');
@@ -1746,6 +1756,51 @@ var Databases = class {
       payload
     );
   }
+  /**
+       * **WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.
+  
+  Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection) API or directly from your database console.
+       *
+       * @param {string} databaseId
+       * @param {string} collectionId
+       * @param {string} documentId
+       * @param {object} data
+       * @param {string[]} permissions
+       * @throws {AppwriteException}
+       * @returns {Promise<Document>}
+       */
+  upsertDocument(databaseId, collectionId, documentId, data, permissions) {
+    if (typeof databaseId === "undefined") {
+      throw new AppwriteException('Missing required parameter: "databaseId"');
+    }
+    if (typeof collectionId === "undefined") {
+      throw new AppwriteException('Missing required parameter: "collectionId"');
+    }
+    if (typeof documentId === "undefined") {
+      throw new AppwriteException('Missing required parameter: "documentId"');
+    }
+    if (typeof data === "undefined") {
+      throw new AppwriteException('Missing required parameter: "data"');
+    }
+    const apiPath = "/databases/{databaseId}/collections/{collectionId}/documents/{documentId}".replace("{databaseId}", databaseId).replace("{collectionId}", collectionId).replace("{documentId}", documentId);
+    const payload = {};
+    if (typeof data !== "undefined") {
+      payload["data"] = data;
+    }
+    if (typeof permissions !== "undefined") {
+      payload["permissions"] = permissions;
+    }
+    const uri = new URL(this.client.config.endpoint + apiPath);
+    const apiHeaders = {
+      "content-type": "application/json"
+    };
+    return this.client.call(
+      "put",
+      uri,
+      apiHeaders,
+      payload
+    );
+  }
   /**
    * Update a document by its unique ID. Using the patch method you can pass only specific fields that will get updated.
    *