feat(query): add script score query

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Spamercz

doc/02-query-objects.md

@@ -490,6 +490,20 @@ new \Spameri\ElasticQuery\Query\GeoBoundingBox(
 
 ---
 
+##### ScriptScore Query
+Re-score matching documents using a Painless script.
+- Class: `\Spameri\ElasticQuery\Query\ScriptScore`
+- [Documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-script-score-query.html)
+- [Implementation](https://github.com/Spameri/ElasticQuery/blob/master/src/Query/ScriptScore.php)
+
+```php
+new \Spameri\ElasticQuery\Query\ScriptScore(
+	query: new \Spameri\ElasticQuery\Query\MatchAll(),
+	source: "doc['my_field'].value * 2",
+	minScore: 0.5,
+);
+```
+
 ##### Script Query
 Filter documents with a Painless boolean script.
 - Class: `\Spameri\ElasticQuery\Query\Script`

src/Query/ScriptScore.php

@@ -0,0 +1,63 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace Spameri\ElasticQuery\Query;
+
+/**
+ * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-script-score-query.html
+ */
+class ScriptScore implements \Spameri\ElasticQuery\Query\LeafQueryInterface
+{
+
+	/**
+	 * @param array<string, mixed> $params
+	 */
+	public function __construct(
+		private \Spameri\ElasticQuery\Query\LeafQueryInterface $query,
+		private string $source,
+		private string $lang = 'painless',
+		private array $params = [],
+		private float|null $minScore = null,
+		private float $boost = 1.0,
+	)
+	{
+	}
+
+
+	public function key(): string
+	{
+		return 'script_score_' . $this->query->key();
+	}
+
+
+	/**
+	 * @return array<string, array<string, mixed>>
+	 */
+	public function toArray(): array
+	{
+		$script = [
+			'source' => $this->source,
+			'lang' => $this->lang,
+		];
+
+		if ($this->params !== []) {
+			$script['params'] = $this->params;
+		}
+
+		$body = [
+			'query' => $this->query->toArray(),
+			'script' => $script,
+			'boost' => $this->boost,
+		];
+
+		if ($this->minScore !== null) {
+			$body['min_score'] = $this->minScore;
+		}
+
+		return [
+			'script_score' => $body,
+		];
+	}
+
+}

tests/SpameriTests/ElasticQuery/Query/ScriptScore.phpt

@@ -0,0 +1,65 @@
+<?php declare(strict_types = 1);
+
+namespace SpameriTests\ElasticQuery\Query;
+
+require_once __DIR__ . '/../../bootstrap.php';
+
+
+class ScriptScore extends \Tester\TestCase
+{
+
+	private const INDEX = 'spameri_test_query_script_score';
+
+
+	public function setUp(): void
+	{
+		$ch = \curl_init();
+		\curl_setopt($ch, \CURLOPT_URL, \ELASTICSEARCH_HOST . '/' . self::INDEX);
+		\curl_setopt($ch, \CURLOPT_RETURNTRANSFER, 1);
+		\curl_setopt($ch, \CURLOPT_CUSTOMREQUEST, 'PUT');
+		\curl_setopt($ch, \CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
+
+		\curl_exec($ch);
+	}
+
+
+	public function testToArray(): void
+	{
+		$ss = new \Spameri\ElasticQuery\Query\ScriptScore(
+			query: new \Spameri\ElasticQuery\Query\MatchAll(),
+			source: "doc['my_field'].value * 2",
+			minScore: 0.5,
+		);
+
+		$array = $ss->toArray();
+
+		\Tester\Assert::same("doc['my_field'].value * 2", $array['script_score']['script']['source']);
+		\Tester\Assert::same(0.5, $array['script_score']['min_score']);
+	}
+
+
+	public function testKey(): void
+	{
+		$ss = new \Spameri\ElasticQuery\Query\ScriptScore(
+			query: new \Spameri\ElasticQuery\Query\MatchAll(),
+			source: '_score',
+		);
+
+		\Tester\Assert::same('script_score_match_all', $ss->key());
+	}
+
+
+	public function tearDown(): void
+	{
+		$ch = \curl_init();
+		\curl_setopt($ch, \CURLOPT_URL, \ELASTICSEARCH_HOST . '/' . self::INDEX);
+		\curl_setopt($ch, \CURLOPT_RETURNTRANSFER, 1);
+		\curl_setopt($ch, \CURLOPT_CUSTOMREQUEST, 'DELETE');
+		\curl_setopt($ch, \CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
+
+		\curl_exec($ch);
+	}
+
+}
+
+(new ScriptScore())->run();