feat: findBy repository shortcuts (Java 21) and reified Query results (Kotlin)

docs/error-handling.md

@@ -49,15 +49,15 @@ When you call `getSingleResult()` on a query that returns zero rows, Storm throw
 
 ```kotlin
 // Throws NoResultException if no user has this email.
-val user = orm.entity(User::class).select(User_.email eq "nobody@example.com").getSingleResult()
+val user = orm.entity(User::class).select(User_.email eq "nobody@example.com").singleResult
 ```
 
-To handle the missing-result case without exceptions, use `getOptionalResult()`:
+To handle the missing-result case without exceptions, use `optionalResult`:
 
 ```kotlin
 val user: User? = orm.entity(User::class)
     .select(User_.email eq "nobody@example.com")
-    .getOptionalResult(User::class)
+    .optionalResult
 ```
 
 Or use the repository's `findById` method:

docs/hydration.md

@@ -90,7 +90,7 @@ val sales = orm.query("""
     SELECT DATE_TRUNC('month', order_date), COUNT(*), SUM(amount)
     FROM orders
     GROUP BY DATE_TRUNC('month', order_date)
-""").getResultList(MonthlySales::class)
+""").resultList<MonthlySales>()
 ```
 
 </TabItem>

docs/security.md

@@ -57,8 +57,8 @@ When using SQL templates directly, embedded values are also parameterized:
 
 ```kotlin
 // Both 'status' and 'minAge' become JDBC parameters.
-val users = orm.query("SELECT * FROM user WHERE status = $status AND age > $minAge")
-    .getResultList(User::class)
+val users = orm.query { "SELECT * FROM user WHERE status = $status AND age > $minAge" }
+    .resultList<User>()
 ```
 
 </TabItem>

docs/sql-templates.md

@@ -72,7 +72,7 @@ val pets = orm.query { """
     SELECT ${PetWithOwner::class}
     FROM ${PetWithOwner::class}
     WHERE ${Owner_.city} = $city
-""" }.getResultList(PetWithOwner::class)
+""" }.resultList<PetWithOwner>()
 ```
 
 </TabItem>
@@ -407,7 +407,7 @@ val users = orm.query { """
     FROM ${User::class}
     WHERE ${User_.city.country.code} = ${"US"}
       AND ${User_.email} LIKE ${"%@example.com"}
-""" }.getResultList(User::class)
+""" }.resultList<User>()
 ```
 
 </TabItem>

pom.xml

@@ -34,7 +34,7 @@
     <developers>
         <developer>
             <name>Leon van Zantvoort</name>
-            <email>storm@zantvoort.biz</email>
+            <email>zantvoort@orm.st</email>
         </developer>
     </developers>
     <scm>

storm-core/src/main/java/st/orm/core/spi/TransactionContext.java

@@ -34,7 +34,7 @@ public interface TransactionContext {
      * when no transaction is currently active.</p>
      *
      * @return a description of the transaction characteristics, or empty if not available.
-     * @since 1.12
+     * @since 1.11
      */
     default Optional<String> describe() {
         return Optional.empty();