feat(query): add geo bounding box query

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

Author: Spamercz

doc/02-query-objects.md

@@ -441,6 +441,22 @@ new \Spameri\ElasticQuery\Query\GeoDistance(
 );
 ```
 
+##### GeoBoundingBox Query
+Match documents whose geo_point falls inside a top-left/bottom-right rectangle.
+- Class: `\Spameri\ElasticQuery\Query\GeoBoundingBox`
+- [Documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-bounding-box-query.html)
+- [Implementation](https://github.com/Spameri/ElasticQuery/blob/master/src/Query/GeoBoundingBox.php)
+
+```php
+new \Spameri\ElasticQuery\Query\GeoBoundingBox(
+	field: 'location',
+	topLeftLat: 40.73,
+	topLeftLon: -74.1,
+	bottomRightLat: 40.01,
+	bottomRightLon: -71.12,
+);
+```
+
 ---
 
 ## Boolean Query Collections

src/Query/GeoBoundingBox.php

@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace Spameri\ElasticQuery\Query;
+
+/**
+ * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-geo-bounding-box-query.html
+ */
+class GeoBoundingBox implements \Spameri\ElasticQuery\Query\LeafQueryInterface
+{
+
+	public function __construct(
+		private string $field,
+		private float $topLeftLat,
+		private float $topLeftLon,
+		private float $bottomRightLat,
+		private float $bottomRightLon,
+		private string|null $type = null,
+	)
+	{
+	}
+
+
+	public function key(): string
+	{
+		return 'geo_bounding_box_' . $this->field;
+	}
+
+
+	/**
+	 * @return array<string, array<string, mixed>>
+	 */
+	public function toArray(): array
+	{
+		$body = [
+			$this->field => [
+				'top_left' => [
+					'lat' => $this->topLeftLat,
+					'lon' => $this->topLeftLon,
+				],
+				'bottom_right' => [
+					'lat' => $this->bottomRightLat,
+					'lon' => $this->bottomRightLon,
+				],
+			],
+		];
+
+		if ($this->type !== null) {
+			$body['type'] = $this->type;
+		}
+
+		return [
+			'geo_bounding_box' => $body,
+		];
+	}
+
+}

tests/SpameriTests/ElasticQuery/Query/GeoBoundingBox.phpt

@@ -0,0 +1,64 @@
+<?php declare(strict_types = 1);
+
+namespace SpameriTests\ElasticQuery\Query;
+
+require_once __DIR__ . '/../../bootstrap.php';
+
+
+class GeoBoundingBox extends \Tester\TestCase
+{
+
+	private const INDEX = 'spameri_test_query_geo_bounding_box';
+
+
+	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
+	{
+		$gbb = new \Spameri\ElasticQuery\Query\GeoBoundingBox(
+			field: 'location',
+			topLeftLat: 40.73,
+			topLeftLon: -74.1,
+			bottomRightLat: 40.01,
+			bottomRightLon: -71.12,
+		);
+
+		$array = $gbb->toArray();
+
+		\Tester\Assert::same(40.73, $array['geo_bounding_box']['location']['top_left']['lat']);
+		\Tester\Assert::same(-71.12, $array['geo_bounding_box']['location']['bottom_right']['lon']);
+	}
+
+
+	public function testKey(): void
+	{
+		$gbb = new \Spameri\ElasticQuery\Query\GeoBoundingBox('location', 1, 1, 0, 0);
+
+		\Tester\Assert::same('geo_bounding_box_location', $gbb->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 GeoBoundingBox())->run();