Add options to indexing endpoints

Author: jasonbosco

docker-compose.yml

@@ -2,7 +2,7 @@ version: '3.5'
 
 services:
     typesense:
-        image: typesense/typesense:0.19.0.rc18
+        image: typesense/typesense:0.20.0.rc39
         environment:
             TYPESENSE_DATA_DIR: /data
             TYPESENSE_API_KEY: xyz

examples/collection_operations.php

@@ -118,14 +118,17 @@
                     'Suzanne Collins',
                 ],
                 'average_rating' => 4.6,
-                'publication_year' => 2008,
+                'publication_year' => "2008",
                 'publication_year_facet' => '2008',
                 'authors_facet' => [
                     'Suzanne Collins',
                 ],
                 'title' => 'The Hunger Games',
                 'image_url' => 'https://images.gr-assets.com/books/1447303603m/2767052.jpg',
                 'ratings_count' => 4780653,
+            ],
+            [
+                'dirty_values' => 'coerce_or_reject',
             ]
         )
     );

src/Document.php

@@ -69,13 +69,14 @@ public function retrieve(): array
 
     /**
      * @param array $partialDocument
+     * @param array $options
      *
      * @return array
      * @throws TypesenseClientError|HttpClientException
      */
-    public function update(array $partialDocument): array
+    public function update(array $partialDocument, array $options = []): array
     {
-        return $this->apiCall->patch($this->endpointPath(), $partialDocument);
+        return $this->apiCall->patch($this->endpointPath(), $partialDocument, true, $options);
     }
 
     /**

src/Documents.php

@@ -51,40 +51,59 @@ public function __construct(string $collectionName, ApiCall $apiCall)
      */
     private function endPointPath(string $action = ''): string
     {
-        return sprintf('%s/%s/%s/%s', Collections::RESOURCE_PATH, $this->collectionName, static::RESOURCE_PATH, $action);
+        return sprintf(
+            '%s/%s/%s/%s',
+            Collections::RESOURCE_PATH,
+            $this->collectionName,
+            static::RESOURCE_PATH,
+            $action
+        );
     }
 
     /**
      * @param array $document
+     * @param array $options
      *
      * @return array
      * @throws TypesenseClientError|HttpClientException
      */
-    public function create(array $document): array
+    public function create(array $document, array $options = []): array
     {
-        return $this->apiCall->post($this->endPointPath(''), $document, true);
+        return $this->apiCall->post($this->endPointPath(''), $document, true, $options);
     }
 
     /**
      * @param array $document
+     * @param array $options
      *
      * @return array
      * @throws TypesenseClientError|HttpClientException
      */
-    public function upsert(array $document): array
+    public function upsert(array $document, array $options = []): array
     {
-        return $this->apiCall->post($this->endPointPath(''), $document, true, ['action' => 'upsert']);
+        return $this->apiCall->post(
+            $this->endPointPath(''),
+            $document,
+            true,
+            array_merge($options, ['action' => 'upsert'])
+        );
     }
 
     /**
      * @param array $document
+     * @param array $options
      *
      * @return array
      * @throws TypesenseClientError|HttpClientException
      */
-    public function update(array $document): array
+    public function update(array $document, array $options = []): array
     {
-        return $this->apiCall->post($this->endPointPath(''), $document, true, ['action' => 'update']);
+        return $this->apiCall->post(
+            $this->endPointPath(''),
+            $document,
+            true,
+            array_merge($options, ['action' => 'update'])
+        );
     }
 
     /**
@@ -109,8 +128,7 @@ public function createMany(array $documents, array $options = []): array
      *
      * @return string|array
      * @throws TypesenseClientError
-     * @throws GuzzleException
-     * @throws \JsonException
+     * @throws \JsonException|HttpClientException
      */
     public function import($documents, array $options = [])
     {