Merge pull request #20 from ensi-platform/task-107572

Task 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,34 @@
+<?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,
+            ]),
+        ]];
+    }
+}

src/Suggesting/Request/Concerns/WithMaxEdits.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Ensi\LaravelElasticQuery\Suggesting\Request\Concerns;
+
+use Webmozart\Assert\Assert;
+
+trait WithMaxEdits
+{
+    protected ?int $maxEdits = null;
+
+    public function maxEdits(int $maxEdits): static
+    {
+        Assert::range($maxEdits, 1, 2);
+
+        $this->maxEdits = $maxEdits;
+
+        return $this;
+    }
+}

src/Suggesting/Request/Concerns/WithMaxInspections.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Ensi\LaravelElasticQuery\Suggesting\Request\Concerns;
+
+trait WithMaxInspections
+{
+    protected ?int $maxInspections = null;
+
+    public function maxInspections(int $maxInspections): static
+    {
+        $this->maxInspections = $maxInspections;
+
+        return $this;
+    }
+}

src/Suggesting/Request/Concerns/WithMaxTermFreq.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Ensi\LaravelElasticQuery\Suggesting\Request\Concerns;
+
+trait WithMaxTermFreq
+{
+    protected ?int $maxTermFreq = null;
+
+    public function maxTermFreq(int $maxTermFreq): static
+    {
+        $this->maxTermFreq = $maxTermFreq;
+
+        return $this;
+    }
+}

src/Suggesting/Request/Concerns/WithMinDocFreq.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Ensi\LaravelElasticQuery\Suggesting\Request\Concerns;
+
+trait WithMinDocFreq
+{
+    protected ?int $minDocFreq = null;
+
+    public function minDocFreq(int $minDocFreq): static
+    {
+        $this->minDocFreq = $minDocFreq;
+
+        return $this;
+    }
+}

src/Suggesting/Request/Concerns/WithMinWordLength.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Ensi\LaravelElasticQuery\Suggesting\Request\Concerns;
+
+trait WithMinWordLength
+{
+    protected ?int $minWordLength = null;
+
+    public function minWordLength(int $minWordLength): static
+    {
+        $this->minWordLength = $minWordLength;
+
+        return $this;
+    }
+}

src/Suggesting/Request/Concerns/WithPrefixLength.php

@@ -0,0 +1,15 @@
+<?php
+
+namespace Ensi\LaravelElasticQuery\Suggesting\Request\Concerns;
+
+trait WithPrefixLength
+{
+    protected ?int $prefixLength = null;
+
+    public function prefixLength(int $prefixLength): static
+    {
+        $this->prefixLength = $prefixLength;
+
+        return $this;
+    }
+}