Added PersistentModel.any equivalent to Query.first that return the first from an unordered result.

Author: johnclayton

README.md

@@ -177,6 +177,12 @@ let jillQuery = Person.include(#Predicate { $0.name == "Jill" })
 let jill = jillQuery.first(in: modelContainer)
 let lastJill  = jillQuery.last(in: modelContainer)
 ```
+Or any result:
+
+```swift
+let anyone = Person.any(in: modelContainer)
+```
+
 
 #### Fetching all results
 
@@ -212,7 +218,7 @@ let jill = Person
     }
 ```
 
-### Performing queries in a concurrency environment
+### Async fetches
 
 Where SwiftQuery really shines is it's automatic support for performing queries
 in a concurrency environment. The current isolation context is passed in to each function

Sources/SwiftQuery/PersistentModel+Fetch.swift

@@ -2,6 +2,12 @@ import SwiftData
 
 @MainActor
 public extension PersistentModel {
+    /// Builds a query over this model type and invokes ``Query/first(in:)`` on that query.
+    /// This is named `any` rather than `first` because there is no order.
+    static func any(in container: ModelContainer) throws -> Self? {
+        try query().first(in: container)
+    }
+
     /// Builds a query over this model type and invokes ``Query/results(in:)`` on that query.
     static func results(in container: ModelContainer) throws -> [Self] {
         try query().results(in: container)
@@ -37,6 +43,12 @@ public extension PersistentModel {
 }
 
 public extension PersistentModel {
+    /// Builds a query over this model type and invokes ``Query/first(isolation:)`` on that query.
+    /// This is named `any` rather than `first` because there is no order.
+    static func any(isolation: isolated (any ModelActor) = #isolation) throws -> Self? {
+        try query().first()
+    }
+
     /// Builds a query over this model type and invokes ``Query/results(isolation:)`` on that query.
     static func results(isolation: isolated (any ModelActor) = #isolation) throws -> [Self] {
         try query().results()

Tests/SwiftQueryTests/PersistentModelFetchTests.swift

@@ -19,6 +19,11 @@ struct PersistentModelFetchTests {
         try modelContainer.mainContext.save()
     }
 
+    @Test func any() throws {
+        let modelResult = try Person.any(in: modelContainer)
+        #expect(modelResult != nil)
+    }
+
     @Test func results() throws {
         let modelResults = try Person.results(in: modelContainer)
         let directResults = try Query<Person>().results(in: modelContainer)
@@ -90,6 +95,13 @@ struct PersistentModelConcurrentFetchTests {
         try modelContainer.mainContext.save()
     }
 
+    @Test func any() async throws {
+        try await modelContainer.createQueryActor().perform { _ in
+            let modelResult = try Person.any()
+            #expect(modelResult != nil)
+        }
+    }
+
     @Test func results() async throws {
         try await modelContainer.createQueryActor().perform { _ in
             let modelResults = try Person.results()