[10.x] Add Typesense engine

composer.json

@@ -25,6 +25,7 @@
     },
     "require-dev": {
         "algolia/algoliasearch-client-php": "^3.2",
+        "typesense/typesense-php": "^4.9",
         "meilisearch/meilisearch-php": "^1.0",
         "mockery/mockery": "^1.0",
         "orchestra/testbench": "^7.0|^8.0",
@@ -54,7 +55,8 @@
     },
     "suggest": {
         "algolia/algoliasearch-client-php": "Required to use the Algolia engine (^3.2).",
-        "meilisearch/meilisearch-php": "Required to use the Meilisearch engine (^1.0)."
+        "meilisearch/meilisearch-php": "Required to use the Meilisearch engine (^1.0).",
+        "typesense/typesense-php": "Required to use the Typesense engine (^4.9)."
     },
     "config": {
         "sort-packages": true,

config/scout.php

@@ -11,7 +11,8 @@
     | using Laravel Scout. This connection is used when syncing all models
     | to the search service. You should adjust this based on your needs.
     |
-    | Supported: "algolia", "meilisearch", "database", "collection", "null"
+    | Supported: "algolia", "meilisearch", "typesense",
+    |            "database", "collection", "null"
     |
     */
 
@@ -139,4 +140,63 @@
         ],
     ],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Typesense Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Here you may configure your Typesense settings. Typesense is an open
+    | source search engine using minimal configuration. Below, you will
+    | state the host, key, and schema configuration for the instance.
+    |
+    */
+
+    'typesense' => [
+        'client-settings' => [
+            'api_key' => env('TYPESENSE_API_KEY', 'xyz'),
+            'nodes' => [
+                [
+                    'host' => env('TYPESENSE_HOST', 'localhost'),
+                    'port' => env('TYPESENSE_PORT', '8108'),
+                    'path' => env('TYPESENSE_PATH', ''),
+                    'protocol' => env('TYPESENSE_PROTOCOL', 'http'),
+                ],
+            ],
+            'nearest_node' => [
+                'host' => env('TYPESENSE_HOST', 'localhost'),
+                'port' => env('TYPESENSE_PORT', '8108'),
+                'path' => env('TYPESENSE_PATH', ''),
+                'protocol' => env('TYPESENSE_PROTOCOL', 'http'),
+            ],
+            'connection_timeout_seconds' => env('TYPESENSE_CONNECTION_TIMEOUT_SECONDS', 2),
+            'healthcheck_interval_seconds' => env('TYPESENSE_HEALTHCHECK_INTERVAL_SECONDS', 30),
+            'num_retries' => env('TYPESENSE_NUM_RETRIES', 3),
+            'retry_interval_seconds' => env('TYPESENSE_RETRY_INTERVAL_SECONDS', 1),
+        ],
+        'model-settings' => [
+            // User::class => [
+            //     'collection-schema' => [
+            //         'fields' => [
+            //             [
+            //                 'name' => 'id',
+            //                 'type' => 'string',
+            //             ],
+            //             [
+            //                 'name' => 'name',
+            //                 'type' => 'string',
+            //             ],
+            //             [
+            //                 'name' => 'created_at',
+            //                 'type' => 'int64',
+            //             ],
+            //         ],
+            //         'default_sorting_field' => 'created_at',
+            //     ],
+            //     'search-parameters' => [
+            //         'query_by' => 'name'
+            //     ],
+            // ],
+        ],
+    ],
+
 ];

src/EngineManager.php

@@ -12,8 +12,10 @@
 use Laravel\Scout\Engines\DatabaseEngine;
 use Laravel\Scout\Engines\MeilisearchEngine;
 use Laravel\Scout\Engines\NullEngine;
+use Laravel\Scout\Engines\TypesenseEngine;
 use Meilisearch\Client as MeilisearchClient;
 use Meilisearch\Meilisearch;
+use Typesense\Client as Typesense;
 
 class EngineManager extends Manager
 {
@@ -138,6 +140,34 @@ protected function ensureMeilisearchClientIsInstalled()
         throw new Exception('Please install the suggested Meilisearch client: meilisearch/meilisearch-php.');
     }
 
+    /**
+     * Create a Typesense engine instance.
+     *
+     * @return \Laravel\Scout\Engines\TypesenseEngine
+     *
+     * @throws \Typesense\Exceptions\ConfigError
+     */
+    public function createTypesenseDriver()
+    {
+        $this->ensureTypesenseClientIsInstalled();
+
+        return new TypesenseEngine(new Typesense(config('scout.typesense.client-settings')));
+    }
+
+    /**
+     * Ensure the Typesense client is installed.
+     *
+     * @return void
+     *
+     * @throws Exception
+     */
+    protected function ensureTypesenseClientIsInstalled()
+    {
+        if (! class_exists(Typesense::class)) {
+            throw new Exception('Please install the suggested Typesense client: typesense/typesense-php.');
+        }
+    }
+
     /**
      * Create a database engine instance.
      *