#107572

Author: MsNatali

src/Concerns/DecoratesBoolQuery.php

@@ -5,6 +5,7 @@
 use Closure;
 use Ensi\LaravelElasticQuery\Contracts\MatchOptions;
 use Ensi\LaravelElasticQuery\Contracts\MultiMatchOptions;
+use Ensi\LaravelElasticQuery\Contracts\WildcardOptions;
 use Ensi\LaravelElasticQuery\Filtering\BoolQueryBuilder;
 use Illuminate\Contracts\Support\Arrayable;
 use Illuminate\Support\Traits\ForwardsCalls;
@@ -84,4 +85,11 @@ public function whereMultiMatch(array $fields, string $query, string|MultiMatchO
 
         return $this;
     }
+
+    public function whereWildcard(string $field, string $query, ?WildcardOptions $options = null): static
+    {
+        $this->forwardCallTo($this->boolQuery(), __FUNCTION__, func_get_args());
+
+        return $this;
+    }
 }

src/Contracts/WildcardOptions.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Ensi\LaravelElasticQuery\Contracts;
+
+class WildcardOptions
+{
+    public function __construct(private array $options = [])
+    {
+    }
+
+    public static function make(
+        ?float $boost = null,
+        ?bool $caseInsensitive = null,
+        ?string $rewrite = null,
+    ): static {
+        $options = [];
+        if (!is_null($boost)) {
+            $options['boost'] = $boost;
+        }
+        if (!is_null($caseInsensitive)) {
+            $options['case_insensitive'] = $caseInsensitive;
+        }
+        if (!is_null($rewrite)) {
+            $options['rewrite'] = $rewrite;
+        }
+        return new static($options);
+    }
+
+    public function toArray(): array
+    {
+        return $this->options;
+    }
+}

src/Filtering/BoolQueryBuilder.php

@@ -8,13 +8,15 @@
 use Ensi\LaravelElasticQuery\Contracts\Criteria;
 use Ensi\LaravelElasticQuery\Contracts\MatchOptions;
 use Ensi\LaravelElasticQuery\Contracts\MultiMatchOptions;
+use Ensi\LaravelElasticQuery\Contracts\WildcardOptions;
 use Ensi\LaravelElasticQuery\Filtering\Criterias\Exists;
 use Ensi\LaravelElasticQuery\Filtering\Criterias\MultiMatch;
 use Ensi\LaravelElasticQuery\Filtering\Criterias\Nested;
 use Ensi\LaravelElasticQuery\Filtering\Criterias\OneMatch;
 use Ensi\LaravelElasticQuery\Filtering\Criterias\RangeBound;
 use Ensi\LaravelElasticQuery\Filtering\Criterias\Term;
 use Ensi\LaravelElasticQuery\Filtering\Criterias\Terms;
+use Ensi\LaravelElasticQuery\Filtering\Criterias\Wildcard;
 use Illuminate\Contracts\Support\Arrayable;
 use stdClass;
 
@@ -165,6 +167,13 @@ public function whereMultiMatch(array $fields, string $query, string|MultiMatchO
         return $this;
     }
 
+    public function whereWildcard(string $field, string $query, ?WildcardOptions $options = null): static
+    {
+        $this->must->add(new Wildcard($this->absolutePath($field), $query, $options ?: new WildcardOptions()));
+
+        return $this;
+    }
+
     protected function addNestedCriteria(string $nested, Closure $filter, CriteriaCollection $target): static
     {
         $path = $this->absolutePath($nested);

src/Filtering/Criterias/Wildcard.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Ensi\LaravelElasticQuery\Filtering\Criterias;
+
+use Ensi\LaravelElasticQuery\Contracts\Criteria;
+use Ensi\LaravelElasticQuery\Contracts\WildcardOptions;
+
+class Wildcard implements Criteria
+{
+    public function __construct(private string $field, private string $query, private WildcardOptions $options)
+    {
+    }
+
+    public function toDSL(): array
+    {
+        return ['wildcard' => [
+            $this->field => array_merge($this->options->toArray(), [
+                'value' => $this->query,
+            ])
+        ]];
+    }
+}

tests/Unit/Filtering/BoolQueryTest.php

@@ -6,6 +6,7 @@
 use Ensi\LaravelElasticQuery\Contracts\MatchOptions;
 use Ensi\LaravelElasticQuery\Contracts\MatchType;
 use Ensi\LaravelElasticQuery\Contracts\MultiMatchOptions;
+use Ensi\LaravelElasticQuery\Contracts\WildcardOptions;
 use Ensi\LaravelElasticQuery\Filtering\BoolQueryBuilder;
 use Ensi\LaravelElasticQuery\Tests\AssertsArray;
 use Ensi\LaravelElasticQuery\Tests\Unit\UnitTestCase;
@@ -181,4 +182,23 @@ public function provideMultiMatch(): array
             ],
         ];
     }
+
+    /**
+     * @dataProvider provideWildcard
+     */
+    public function testWildcard(?WildcardOptions $options, array $expected): void
+    {
+        $dsl = BoolQueryBuilder::make()->whereWildcard('foo', '%value%', $options)->toDSL();
+
+        $this->assertArrayFragment(['wildcard' => ['foo' => array_merge(['value' => '%value%'], $expected)]], $dsl);
+    }
+
+    public function provideWildcard(): array
+    {
+        return [
+            'empty options' => [WildcardOptions::make(0, false), ['boost' => 0, 'case_insensitive' => false]],
+            'full options' => [WildcardOptions::make(0.5, true), ['boost' => 0.5, 'case_insensitive' => true]],
+            'rewrite options' => [WildcardOptions::make(rewrite: 'constant_score'), ['rewrite' => 'constant_score']],
+        ];
+    }
 }