add script to ConstructsAggregations and set default value for params in ScriptAggregation

Author: Miroshnichenko

src/Aggregating/Metrics/ScriptAggregation.php

@@ -12,8 +12,8 @@ class ScriptAggregation implements Aggregation
     public function __construct(
         private readonly string $name,
         private readonly string $aggregationType,
-        private readonly array  $params,
         private readonly string $source,
+        private readonly array  $params = [],
         private readonly string $lang = ScriptLang::PAINLESS,
     ) {
         Assert::stringNotEmpty(trim($name));

src/Concerns/ConstructsAggregations.php

@@ -15,9 +15,11 @@
 use Ensi\LaravelElasticQuery\Aggregating\Metrics\MinAggregation;
 use Ensi\LaravelElasticQuery\Aggregating\Metrics\MinMaxAggregation;
 use Ensi\LaravelElasticQuery\Aggregating\Metrics\RangesAggregation;
+use Ensi\LaravelElasticQuery\Aggregating\Metrics\ScriptAggregation;
 use Ensi\LaravelElasticQuery\Aggregating\Metrics\ValueCountAggregation;
 use Ensi\LaravelElasticQuery\Contracts\Aggregation;
 use Ensi\LaravelElasticQuery\Contracts\Criteria;
+use Ensi\LaravelElasticQuery\Contracts\ScriptLang;
 use Ensi\LaravelElasticQuery\Filtering\BoolQueryBuilder;
 use Ensi\LaravelElasticQuery\Search\Sorting\Sort;
 use Ensi\LaravelElasticQuery\Search\Sorting\SortCollection;
@@ -81,6 +83,18 @@ public function max(string $name, string $field, mixed $missing = null): static
         return $this;
     }
 
+    public function script(
+        string $name,
+        string $aggregationType,
+        string $source,
+        array $params = [],
+        string $lang = ScriptLang::PAINLESS
+    ): static {
+        $this->aggregations->add(new ScriptAggregation($name, $aggregationType, $source, $params, $lang));
+
+        return $this;
+    }
+
     public function count(string $name, string $field): static
     {
         $this->aggregations->add(new ValueCountAggregation($name, $this->absolutePath($field)));

src/Contracts/AggregationsBuilder.php

@@ -25,5 +25,7 @@ public function max(string $name, string $field, mixed $missing = null): static;
 
     public function count(string $path, string $field): static;
 
+    public function script(string $name, string $aggregationType, string $source, array $params = [], string $lang = ScriptLang::PAINLESS): static;
+
     public function nested(string $path, Closure $callback): static;
 }