whereNestedFieldExists

Author: pdphilip

src/Eloquent/Docs/ModelDocs.php

@@ -82,6 +82,10 @@
  * @method static $this whereNotNestedObject($column, $query, $filterInnerHits = false, $options = [])
  * @method static $this orWhereNestedObject($column, $query, $filterInnerHits = false, $options = [])
  * @method static $this orWhereNotNestedObject($column, $query, $filterInnerHits = false, $options = [])
+ * @method static $this whereNestedFieldExists(string $path, string $boolean = 'and', bool $not = false)
+ * @method static $this whereNestedFieldDoesntExist(string $path)
+ * @method static $this orWhereNestedFieldExists(string $path)
+ * @method static $this orWhereNestedFieldDoesntExist(string $path)
  *-----------------------------------
  * @method static $this whereFieldExists($column, $boolean = 'and', $not = false)
  * @method static $this whereFieldDoesntExist($column)

src/Query/Concerns/BuildsNestedQueries.php

@@ -130,6 +130,43 @@ public function filterNested($column, $query, $options = [])
         return $this;
     }
 
+    // ----------------------------------------------------------------------
+    // Nested Field Exists
+    // Use when you want "this nested path has at least one document" without
+    // any inner conditions. Explicit, no mapping lookup, no detection cost.
+    // ----------------------------------------------------------------------
+
+    public function whereNestedFieldExists(string $path, string $boolean = 'and', bool $not = false): self
+    {
+        // Stored as 'path' (not 'column') to bypass the where-loop's automatic
+        // parent-field prepending — the path here is the nested path itself,
+        // not a field inside a nested context.
+        $this->wheres[] = [
+            'type' => 'NestedFieldExists',
+            'path' => $path,
+            'boolean' => $boolean,
+            'not' => $not,
+            'options' => [],
+        ];
+
+        return $this;
+    }
+
+    public function whereNestedFieldDoesntExist(string $path): self
+    {
+        return $this->whereNestedFieldExists($path, 'and', true);
+    }
+
+    public function orWhereNestedFieldExists(string $path): self
+    {
+        return $this->whereNestedFieldExists($path, 'or', false);
+    }
+
+    public function orWhereNestedFieldDoesntExist(string $path): self
+    {
+        return $this->whereNestedFieldExists($path, 'or', true);
+    }
+
     /**
      * Order by a field within nested objects.
      */

src/Query/Grammar/Concerns/CompilesWheres.php

@@ -287,6 +287,18 @@ protected function compileWhereNested(Builder $builder, array $where): array
         return reset($compiled);
     }
 
+    /**
+     * Nested field exists - "this nested path has at least one document".
+     * No mapping lookup; the path is whatever the caller passed.
+     */
+    protected function compileWhereNestedFieldExists(Builder $builder, array $where): array
+    {
+        $path = $where['path'];
+        $query = DslFactory::nested($path, ['query' => DslFactory::exists($path)]);
+
+        return $this->applyOptionsToClause($query, $where);
+    }
+
     /**
      * Nested object query - query nested document type
      */

tests/QueryElasticsearchSpecificTest.php

@@ -253,6 +253,35 @@
         ->and($mustNot['nested']['query'])->toBe(['exists' => ['field' => 'comments.country']]);
 });
 
+it('whereNestedFieldExists emits nested+exists for the path itself', function () {
+    $dsl = Post::whereNestedFieldExists('comments')->toDsl();
+
+    $clause = $dsl['body']['query'];
+    expect($clause)->toHaveKey('nested')
+        ->and($clause['nested']['path'])->toBe('comments')
+        ->and($clause['nested']['query'])->toBe(['exists' => ['field' => 'comments']]);
+});
+
+it('whereNestedFieldExists matches posts that have nested entries', function () {
+    expect(Post::whereNestedFieldExists('comments')->count())->toBe(4);
+});
+
+it('whereNestedFieldDoesntExist wraps nested inside must_not', function () {
+    $dsl = Post::whereNestedFieldDoesntExist('comments')->toDsl();
+
+    $mustNot = $dsl['body']['query']['bool']['must_not'][0];
+    expect($mustNot)->toHaveKey('nested')
+        ->and($mustNot['nested']['path'])->toBe('comments')
+        ->and($mustNot['nested']['query'])->toBe(['exists' => ['field' => 'comments']]);
+});
+
+it('orWhereNestedFieldExists composes with other clauses', function () {
+    $dsl = Post::where('status', 99)->orWhereNestedFieldExists('comments')->toDsl();
+
+    $should = $dsl['body']['query']['bool']['should'] ?? null;
+    expect($should)->not->toBeNull();
+});
+
 it('can search with field boosting', function () {
     $users = User::search('John', 'best_fields', ['name' => 5, 'description' => 1])->get();
     expect($users)->toHaveCount(2)