Implements the update documents by function

src/Endpoints/Delegates/HandlesDocuments.php

@@ -139,6 +139,21 @@ public function updateDocumentsNdjsonInBatches(string $documents, ?int $batchSiz
         return $promises;
     }
 
+    /**
+     * This is an EXPERIMENTAL feature, which may break without a major version.
+     * It's available after Meilisearch v1.10.
+     *
+     * More info about the feature: https://github.com/orgs/meilisearch/discussions/762
+     * More info about experimental features in general: https://www.meilisearch.com/docs/reference/api/experimental-features
+     *
+     * @param non-empty-string $function
+     * @param array{filter: non-empty-string|list<non-empty-string>|null, context: array<non-empty-string, mixed>}|null $options
+     */
+    public function updateDocumentsByFunction(string $function, ?array $options)
+    {
+        return $this->http->post(self::PATH.'/'.$this->uid.'/documents/edit', ['function' => $function, ...$options]);
+    }
+
     public function deleteAllDocuments(): array
     {
         return $this->http->delete(self::PATH.'/'.$this->uid.'/documents');

tests/Endpoints/DocumentsTest.php

@@ -281,6 +281,59 @@
         self::assertCount(\count(self::DOCUMENTS), $response);
     }
 
+    public function testUpdateDocumentsByFunction(): void
+    {
+        $http = new Client($this->host, getenv('MEILISEARCH_API_KEY'));
+        $http->patch('/experimental-features', ['editDocumentsByFunction' => true]);
+        $index = $this->createEmptyIndex($this->safeIndexName('movies'));
+        $documentPromise = $index->addDocuments(self::DOCUMENTS);
+        $index->waitForTask($documentPromise['taskUid']);
+
+        $function = '
+            if doc.id % context.modulo == 0 {
+                doc.title = `kefir would read ${doc.title}`;
+            };
+            doc.remove("comment");
+            doc.remove("genre");
+        ';
+        $documentPromise = $index->updateDocumentsByFunction($function, ['context' => ['modulo' => 3]]);
+        $index->waitForTask($documentPromise['taskUid']);
+
+        $documents = $index->getDocuments()->getResults();
+
+        $replacements = [
+            [
+                'id' => 123,
+                'title' => 'kefir would read Pride and Prejudice',
+            ],
+            [
+                'id' => 456,
+                'title' => 'kefir would read Le Petit Prince',
+            ],
+            [
+                'id' => 2,
+                'title' => 'Le Rouge et le Noir',
+            ],
+            [
+                'id' => 1,
+                'title' => 'Alice In Wonderland',
+            ],
+            [
+                'id' => 1344,
+                'title' => 'kefir would read The Hobbit',
+            ],
+            [
+                'id' => 4,
+                'title' => 'Harry Potter and the Half-Blood Prince',
+            ],
+            [
+                'id' => 42,
+                'title' => 'kefir would read The Hitchhiker\'s Guide to the Galaxy',
+            ],
+        ];
+        self::assertSame($replacements, $documents);
+    }
+
     public function testAddDocumentsCsvInBatches(): void
     {
         $index = $this->client->index('documentCsv');