add a Sort component

Author: rcarver

Sources/ElasticsearchQueryBuilder/Components.swift

@@ -199,6 +199,22 @@ extension esb {
         }
     }
 
+    /// Adds `sort` block to the query syntax.
+    public struct Sort<Component: ArrayComponent>: DictComponent {
+        var component: Component
+        public init(@QueryArrayBuilder component: () -> Component) {
+            self.component = component()
+        }
+        public func makeDict() -> QueryDict {
+            let values: [QueryDict] = self.component.makeCompactArray()
+            if values.isEmpty {
+                return [:]
+            } else {
+                return [ "sort" :  .array(values.map(QueryValue.dict)) ]
+            }
+        }
+    }
+
     /// Adds `term` block to the query syntax.
     ///
     /// Excludes the component if value is nil.

Tests/ElasticsearchQueryBuilderTests/ComponentTests.swift

@@ -256,6 +256,43 @@ final class BoolTests: XCTestCase {
     }
 }
 
+final class SortTests: XCTestCase {
+    func testBuild() throws {
+        @ElasticsearchQueryBuilder func build() -> some esb.QueryDSL {
+            esb.Sort {
+                esb.Key("_score") {
+                    [ "order": "desc" ]
+                }
+                esb.Key("name") {
+                    [ "order": "asc" ]
+                }
+            }
+        }
+        XCTAssertNoDifference(build().makeQuery(), [
+            "sort": [
+                [
+                    "_score": [ "order": "desc" ]
+                ],
+                [
+                    "name": [ "order": "asc" ]
+                ]
+            ]
+        ])
+    }
+    func testBuildEmpty() throws {
+        @ElasticsearchQueryBuilder func build() -> some esb.QueryDSL {
+            esb.Sort {
+                if false {
+                    esb.Key("_score") {
+                        [ "order": "desc" ]
+                    }
+                }
+            }
+        }
+        XCTAssertNoDifference(build().makeQuery(), [:])
+    }
+}
+
 final class TermTests: XCTestCase {
     func testBuild() throws {
         @ElasticsearchQueryBuilder func build() -> some esb.QueryDSL {