Support nested fields in vectorSearch (#1912)

Author: paulinevos

generator/mql-specifications

@@ -190,6 +190,7 @@
   <file src="src/Builder/Stage/VectorSearchStage.php">
     <MixedArgumentTypeCoercion>
       <code><![CDATA[$filter]]></code>
+      <code><![CDATA[$parentFilter]]></code>
     </MixedArgumentTypeCoercion>
   </file>
   <file src="src/Builder/Type/CombinedFieldQuery.php">

psalm-baseline.xml

@@ -4,6 +4,8 @@
 
 namespace MongoDB\Tests\Builder\Stage;
 
+use DateTimeImmutable;
+use DateTimeZone;
 use MongoDB\Builder\Pipeline;
 use MongoDB\Builder\Query;
 use MongoDB\Builder\Stage;
@@ -83,11 +85,44 @@ public function testENN(): void
         $this->assertSamePipeline(Pipelines::VectorSearchENN, $pipeline);
     }
 
+    public function testNestedField(): void
+    {
+        $pipeline = new Pipeline(
+            Stage::vectorSearch(
+                index: 'vector_index',
+                limit: 5,
+                path: 'reviews.comments_embedding',
+                queryVector: [0.010745884850621223, -0.035673413425683975, -0.09298479557037354],
+                filter: Query::query(...['reviews.date' => Query::gte(new DateTimeImmutable('2000-01-01', new DateTimeZone('UTC')))]),
+                numCandidates: 100,
+                nestedOptions: ['scoreMode' => 'avg'],
+                parentFilter: Query::query(
+                    ...['address.country' => Query::in(['United States'])],
+                    bedrooms: [Query::gte(2), Query::lte(3)],
+                    property_type: Query::in(['House', 'Apartment']),
+                ),
+            ),
+            Stage::project(
+                ...['reviews.comments' => 1],
+                _id: 0,
+                name: 1,
+                address: 1,
+                neighborhood_overview: 1,
+                bedrooms: 1,
+                property_type: 1,
+                score: ['$meta' => 'vectorSearchScore'],
+            ),
+        );
+
+        $this->assertSamePipeline(Pipelines::VectorSearchNestedField, $pipeline);
+    }
+
     public function testStoredSource(): void
     {
         $pipeline = new Pipeline(
             Stage::vectorSearch(
                 index: 'vector_index',
+                limit: 10,
                 path: 'plot_embedding',
                 queryVector: [-0.03994801267981529, -0.016522614285349846, -0.008775344118475914],
                 filter: Query::and(
@@ -101,7 +136,6 @@ public function testStoredSource(): void
                         genres: Query::in(['Action', 'Drama', 'Comedy']),
                     ),
                 ),
-                limit: 10,
                 numCandidates: 1000,
                 returnStoredSource: true,
             ),