Update CHANGELOG

Author: pdphilip

CHANGELOG.md

@@ -2,6 +2,48 @@
 
 All notable changes to this `laravel-elasticsearch` package will be documented in this file.
 
+## v5.2.0 - 2025-10-24
+
+This release is compatible with Laravel 10, 11 & 12
+
+### New Feature: Query String Queries
+
+This release introduces Query String Queries, bringing full Elasticsearch `query_string` syntax support directly into your Eloquent-style queries.
+
+- Method: `searchQueryString(query, $fields = null, $options = [])` and related methods (`orSearchQueryString`, `searchNotQueryString`, etc.)
+- Supports all `query_string` features — logical operators, wildcards, fuzziness, ranges, regex, boosting, field scoping, and more
+- Includes a dedicated `QueryStringOptions` class for fluent option configuration or array-based parameters
+- [See Tests](https://github.com/pdphilip/laravel-elasticsearch/blob/main/tests/QueryStringTest.php)
+- [Full documentation](https://elasticsearch.pdphilip.com/eloquent/query-string-queries/)
+
+Example:
+
+```php
+Product::searchQueryString('status:(active OR pending) name:(full text search)^2')->get();
+Product::searchQueryString('price:[5 TO 19}')->get();
+
+// vanilla optional, +pizza required, -ice forbidden
+Product::searchQueryString('vanilla +pizza -ice', function (QueryStringOptions $options) {
+    $options->type('cross_fields')->fuzziness(2);
+})->get();
+
+//etc
+
+```
+### Ordering enhancement: unmapped_type
+
+- You can now add an `unmapped_type` flag to your ordering query #88
+
+```php
+Product::query()->orderBy('name', 'desc', ['unmapped_type' => 'keyword'])->get();
+
+```
+### Bugfix
+
+- Fixed issue where limit values were being reset on bucket aggregations #84
+
+**Full Changelog**: https://github.com/pdphilip/laravel-elasticsearch/compare/v5.1.0...v5.2.0
+
 ## v5.1.0 - 2025-08-20
 
 This release is compatible with Laravel 10, 11 & 12
@@ -14,6 +56,7 @@ Appends the `track_total_hits` parameter to the DSL query, setting value to `tru
 $products = Product::limit(5)->withTrackTotalHits(true)->get();
 $totalHits = $products->getQueryMeta()->getTotalHits();
 
+
 ```
 This can be set by default for all queries by updating the connection config in `database.php`:
 
@@ -27,6 +70,7 @@ This can be set by default for all queries by updating the connection config in
     ],
 ],
 
+
 ```
 #### 2. New feature, `createOrFail(array $attributes)`
 
@@ -39,6 +83,7 @@ Product::createOrFail([
     'price' => 30,
 ]);
 
+
 ```
 #### 3. New feature `withRefresh(bool|string $refresh)`
 
@@ -57,6 +102,7 @@ Product::withRefresh('wait_for')->create([
     'price' => 30,
 ]);
 
+
 ```
 ### PRS
 
@@ -165,6 +211,7 @@ People::bulkInsert([
 
 
 
+
 ```
 Returns:
 
@@ -190,6 +237,7 @@ Returns:
 
 
 
+
 ```
 #### 2. Bug fix: `distinct()` aggregation now appends `searchAfter` key in meta
 
@@ -230,6 +278,7 @@ with Laravel’s Eloquent. It lays a solid, future-proof foundation for everythi
 
 
 
+
 ```
 ### Breaking Changes
 
@@ -262,6 +311,7 @@ with Laravel’s Eloquent. It lays a solid, future-proof foundation for everythi
 
 
 
+  
   ```
 
 #### 3. Queries
@@ -281,6 +331,7 @@ with Laravel’s Eloquent. It lays a solid, future-proof foundation for everythi
 
 
 
+  
   ```
 - `orderByRandom()` Removed
 
@@ -301,6 +352,7 @@ with Laravel’s Eloquent. It lays a solid, future-proof foundation for everythi
 
 
 
+  
   ```
 - Legacy Search Methods Removed
   All `{xx}->search()` methods been removed. Use `{multi_match}->get()` instead.
@@ -326,6 +378,7 @@ with Laravel’s Eloquent. It lays a solid, future-proof foundation for everythi
 
 
 
+  
   ```
 - `Schema::hasIndex` has been removed. Use `Schema::hasTable` or `Schema::indexExists` instead.
 
@@ -395,6 +448,7 @@ Connection::on('elasticsearch')->elastic()->{clientMethod}();
 
 
 
+
 ```
 ### What's Changed