feat: implement MappingGenerator indexes filtering

Implement the previously unused $indexes parameter in
MappingGenerator::reload() to allow selective index reloading.

* Add index name filtering logic - skip indexes not in the filter list
* Add file_exists() check before include() to prevent warnings
* Add @mixin annotation to Connection class for better IDE support

When $indexes is null, all indexes are reloaded (default behavior).
When an array is provided, only matching indexes are processed.

Author: josbeir

phpstan.neon

@@ -15,30 +15,23 @@ parameters:
             identifier: trait.unused
             count: 1
             path: src/Datasource/IndexLocatorAwareTrait.php
-
         -
             message: '#^Access to an undefined property Cake\\Datasource\\EntityInterface\:\:\$version\.$#'
             identifier: property.notFound
             count: 1
             path: src/Index.php
-
         -
             message: '#^Method Cake\\ElasticSearch\\Query\:\:all\(\) should return Cake\\Datasource\\ResultSetInterface but returns iterable\.$#'
             identifier: return.type
             count: 1
             path: src/Query.php
-
-
-
-
         -
             message: '#^Method Cake\\ElasticSearch\\Query\:\:find\(\) should return static\(Cake\\ElasticSearch\\Query\<TSubject of array\|Cake\\ElasticSearch\\Document\>\) but returns Cake\\ElasticSearch\\Query\<Cake\\ElasticSearch\\Document\>\.$#'
             identifier: return.type
             count: 1
             path: src/Query.php
-
         -
             message: '#^Class Cake\\ElasticSearch\\ResultSet @implements tag contains incompatible type Cake\\Datasource\\ResultSetInterface&iterable\<T of array\|Cake\\Datasource\\EntityInterface\>\.$#'
             identifier: generics.notCompatible
             count: 1
-            path: src/ResultSet.php
+            path: src/ResultSet.php

src/Datasource/Connection.php

@@ -29,6 +29,10 @@
 use Psr\SimpleCache\CacheInterface;
 use RuntimeException;
 
+/**
+ * @mixin \Elastica\Client
+ * @package Cake\ElasticSearch\Datasource
+ */
 class Connection implements ConnectionInterface
 {
     protected array $_config;

src/TestSuite/Fixture/MappingGenerator.php

@@ -50,7 +50,7 @@ public function __construct(string $file, string $connection)
     /**
      * Drop and re-create indexes defined in the mapping schema file.
      *
-     * @param array<string> $indexes A subset of indexes to reload. Used for testing.
+     * @param array<string>|null $indexes A subset of index names to reload. If null, all indexes are reloaded.
      */
     public function reload(?array $indexes = null): void
     {
@@ -62,6 +62,10 @@ public function reload(?array $indexes = null): void
             ));
         }
 
+        if (!file_exists($this->file)) {
+            throw new RuntimeException(sprintf('The `%s` file does not exist.', $this->file));
+        }
+
         $mappings = include $this->file;
         if (empty($mappings)) {
             throw new RuntimeException(sprintf('The `%s` file did not return any mapping data.', $this->file));
@@ -72,6 +76,11 @@ public function reload(?array $indexes = null): void
                 throw new RuntimeException(sprintf('The mapping at index %s does not have a name.', $i));
             }
 
+            // Skip if indexes filter is provided and this index is not in the list
+            if ($indexes !== null && !in_array($mapping['name'], $indexes, true)) {
+                continue;
+            }
+
             $this->dropIndex($db, $mapping['name']);
             $this->createIndex($db, $mapping);
         }

tests/TestCase/MarshallerTest.php

@@ -142,7 +142,7 @@ public function testOneFieldList(): void
     /**
      * test marshalling with accessibleFields
      */
-    public function testOneAccsesibleFields(): void
+    public function testOneAccessibleFields(): void
     {
         $data = [
             'title' => 'Testing',