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

.code-samples.meilisearch.yaml

@@ -288,7 +288,7 @@ update_displayed_attributes_1: |-
   ]);
 reset_displayed_attributes_1: |-
   $client->index('movies')->resetDisplayedAttributes();
-get_typo_tolerance_1:
+get_typo_tolerance_1: |-
   $client->index('books')->getTypoTolerance();
 update_typo_tolerance_1: |-
   $client->index('books')->updateTypoTolerance([
@@ -775,3 +775,19 @@ update_localized_attribute_settings_1: |-
   ]);
 reset_localized_attribute_settings_1: |-
   $client->index('INDEX_NAME')->resetLocalizedAttributes();
+get_facet_search_settings_1: |-
+  $client->index('INDEX_NAME')->getFacetSearch();
+update_facet_search_settings_1: |-
+  $client->index('INDEX_NAME')->updateFacetSearch(false);
+reset_facet_search_settings_1: |-
+  $client->index('INDEX_NAME')->resetFacetSearch();
+get_prefix_search_settings_1: |-
+  $client->index('INDEX_NAME')->getPrefixSearch();
+update_prefix_search_settings_1: |-
+  $client->index('INDEX_NAME')->updatePrefixSearch('disabled');
+reset_prefix_search_settings_1: |-
+  $client->index('INDEX_NAME')->resetPrefixSearch();
+get_all_batches_1: |-
+  $client->getBatches();
+get_batch_1: |-
+  $client->getBatch(BATCH_UID);

src/Client.php

@@ -4,6 +4,8 @@
 
 namespace Meilisearch;
 
+use Meilisearch\Endpoints\Batches;
+use Meilisearch\Endpoints\Delegates\HandlesBatches;
 use Meilisearch\Endpoints\Delegates\HandlesDumps;
 use Meilisearch\Endpoints\Delegates\HandlesIndex;
 use Meilisearch\Endpoints\Delegates\HandlesKeys;
@@ -34,6 +36,7 @@ class Client
     use HandlesSnapshots;
     use HandlesSystem;
     use HandlesMultiSearch;
+    use HandlesBatches;
 
     /**
      * @param array<int, string> $clientAgents
@@ -52,6 +55,7 @@ public function __construct(
         $this->version = new Version($this->http);
         $this->stats = new Stats($this->http);
         $this->tasks = new Tasks($this->http);
+        $this->batches = new Batches($this->http);
         $this->keys = new Keys($this->http);
         $this->dumps = new Dumps($this->http);
         $this->snapshots = new Snapshots($this->http);

src/Contracts/BatchesQuery.php

@@ -0,0 +1,68 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Contracts;
+
+use Meilisearch\Endpoints\Delegates\TasksQueryTrait;
+
+class BatchesQuery
+{
+    use TasksQueryTrait;
+
+    private ?int $from = null;
+
+    /**
+     * @var non-negative-int|null
+     */
+    private ?int $limit = null;
+
+    private ?bool $reverse = null;
+
+    /**
+     * @return $this
+     */
+    public function setFrom(int $from): self
+    {
+        $this->from = $from;
+
+        return $this;
+    }
+
+    /**
+     * @return $this
+     */
+    public function setLimit(int $limit): self
+    {
+        $this->limit = $limit;
+
+        return $this;
+    }
+
+    /**
+     * @return $this
+     */
+    public function setReverse(bool $reverse): self
+    {
+        $this->reverse = $reverse;
+
+        return $this;
+    }
+
+    public function toArray(): array
+    {
+        return array_filter(
+            array_merge(
+                $this->baseArray(),
+                [
+                    'from' => $this->from,
+                    'limit' => $this->limit,
+                    'reverse' => (null !== $this->reverse ? ($this->reverse ? 'true' : 'false') : null),
+                ]
+            ),
+            static function ($item) {
+                return null !== $item;
+            }
+        );
+    }
+}

src/Contracts/BatchesResults.php

@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Contracts;
+
+class BatchesResults extends Data
+{
+    /**
+     * @var non-negative-int
+     */
+    private int $next;
+
+    /**
+     * @var non-negative-int
+     */
+    private int $limit;
+
+    /**
+     * @var non-negative-int
+     */
+    private int $from;
+
+    /**
+     * @var non-negative-int
+     */
+    private int $total;
+
+    public function __construct(array $params)
+    {
+        parent::__construct($params['results']);
+
+        $this->from = $params['from'] ?? 0;
+        $this->limit = $params['limit'] ?? 0;
+        $this->next = $params['next'] ?? 0;
+        $this->total = $params['total'] ?? 0;
+    }
+
+    /**
+     * @return array<int, array>
+     */
+    public function getResults(): array
+    {
+        return $this->data;
+    }
+
+    /**
+     * @return non-negative-int
+     */
+    public function getNext(): int
+    {
+        return $this->next;
+    }
+
+    /**
+     * @return non-negative-int
+     */
+    public function getLimit(): int
+    {
+        return $this->limit;
+    }
+
+    /**
+     * @return non-negative-int
+     */
+    public function getFrom(): int
+    {
+        return $this->from;
+    }
+
+    /**
+     * @return non-negative-int
+     */
+    public function getTotal(): int
+    {
+        return $this->total;
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'results' => $this->data,
+            'next' => $this->next,
+            'limit' => $this->limit,
+            'from' => $this->from,
+            'total' => $this->total,
+        ];
+    }
+
+    public function count(): int
+    {
+        return \count($this->data);
+    }
+}

src/Contracts/TasksQuery.php

@@ -22,6 +22,10 @@ class TasksQuery
      */
     private ?array $canceledBy = null;
 
+    private ?int $batchUid = null;
+
+    private ?bool $reverse = null;
+
     /**
      * @return $this
      */
@@ -54,6 +58,23 @@ public function setLimit(int $limit): self
         return $this;
     }
 
+    /**
+     * @return $this
+     */
+    public function setBatchUid(int $batchUid): self
+    {
+        $this->batchUid = $batchUid;
+
+        return $this;
+    }
+
+    public function setReverse(bool $reverse): self
+    {
+        $this->reverse = $reverse;
+
+        return $this;
+    }
+
     public function toArray(): array
     {
         return array_filter(
@@ -63,8 +84,13 @@ public function toArray(): array
                     'from' => $this->from,
                     'limit' => $this->limit,
                     'canceledBy' => $this->formatArray($this->canceledBy),
+                    'batchUid' => $this->batchUid,
+                    'reverse' => (null !== $this->reverse ? ($this->reverse ? 'true' : 'false') : null),
                 ]
-            ), static function ($item) { return null !== $item; }
+            ),
+            static function ($item) {
+                return null !== $item;
+            }
         );
     }
 }

src/Endpoints/Batches.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Endpoints;
+
+use Meilisearch\Contracts\Endpoint;
+
+class Batches extends Endpoint
+{
+    protected const PATH = '/batches';
+
+    public function get($batchUid): array
+    {
+        return $this->http->get(self::PATH.'/'.$batchUid);
+    }
+
+    public function all(array $query = []): array
+    {
+        return $this->http->get(self::PATH.'/', $query);
+    }
+}

src/Endpoints/Delegates/HandlesBatches.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Meilisearch\Endpoints\Delegates;
+
+use Meilisearch\Contracts\BatchesQuery;
+use Meilisearch\Contracts\BatchesResults;
+use Meilisearch\Endpoints\Batches;
+
+trait HandlesBatches
+{
+    protected Batches $batches;
+
+    public function getBatch($uid): array
+    {
+        return $this->batches->get($uid);
+    }
+
+    public function getBatches(?BatchesQuery $options = null): BatchesResults
+    {
+        $query = null !== $options ? $options->toArray() : [];
+
+        $response = $this->batches->all($query);
+
+        return new BatchesResults($response);
+    }
+}

src/Endpoints/Delegates/HandlesSettings.php

@@ -421,4 +421,60 @@ public function resetEmbedders(): array
     {
         return $this->http->delete(self::PATH.'/'.$this->uid.'/settings/embedders');
     }
+
+    // Settings - Facet Search
+
+    /**
+     * @since Meilisearch v1.12.0
+     */
+    public function getFacetSearch(): bool
+    {
+        return $this->http->get(self::PATH.'/'.$this->uid.'/settings/facet-search');
+    }
+
+    /**
+     * @since Meilisearch v1.12.0
+     */
+    public function updateFacetSearch(bool $facetSearch): array
+    {
+        return $this->http->put(self::PATH.'/'.$this->uid.'/settings/facet-search', $facetSearch);
+    }
+
+    /**
+     * @since Meilisearch v1.12.0
+     */
+    public function resetFacetSearch(): array
+    {
+        return $this->http->delete(self::PATH.'/'.$this->uid.'/settings/facet-search');
+    }
+
+    // Settings - Prefix Search
+
+    /**
+     * @return 'indexingTime'|'disabled'
+     *
+     * @since Meilisearch v1.12.0
+     */
+    public function getPrefixSearch(): string
+    {
+        return $this->http->get(self::PATH.'/'.$this->uid.'/settings/prefix-search');
+    }
+
+    /**
+     * @param 'indexingTime'|'disabled' $prefixSearch
+     *
+     * @since Meilisearch v1.12.0
+     */
+    public function updatePrefixSearch(string $prefixSearch): array
+    {
+        return $this->http->put(self::PATH.'/'.$this->uid.'/settings/prefix-search', $prefixSearch);
+    }
+
+    /**
+     * @since Meilisearch v1.12.0
+     */
+    public function resetPrefixSearch(): array
+    {
+        return $this->http->delete(self::PATH.'/'.$this->uid.'/settings/prefix-search');
+    }
 }