Bump version to 1.1.1 and update references across all modules. Include changelog updates with bug fixes and enhancements.

Author: Splatcrafter

CHANGELOG.md

@@ -6,6 +6,37 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ---
 
+## [1.1.1] - 2025-09-01
+
+### Bug Fixes
+
+- Fixed `TransientObjectException` when persisting entities with cyclic associations by introducing a safe pre-persist
+  traversal (depth limit + identity-based cycle guard).
+- Correct handling for `asIdOnly` to-one relations: the builder now assigns identifiers via a robust `writeId(...)`
+  path (tries `setId(...)` first, then falls back to the `id` field), preventing transient references from being
+  flushed.
+- Reflection utilities hardened:
+    - `getFieldValue(...)` prefers JavaBean getters (`getX`/`isX`) and falls back to hierarchical field lookup.
+    - `setFieldReflect(...)` walks superclasses and no-ops on access errors instead of throwing.
+
+### Enhancements
+
+- Clearer diagnostics during builder generation (defaults provider checks, missing no-arg constructor, and generated API
+  name conflicts).
+- Safer `SpringPersistAdapter.save(...)`: repository-first; falls back to `EntityManager.persist/merge` based on runtime
+  identifier presence.
+
+### Compatibility
+
+- No breaking changes to generated builder APIs; no migration required.
+
+### Tests
+
+- Added/updated integration tests covering:
+    - `withRoleId(...)` wiring to an existing FK without creating phantom entities.
+    - cyclic supervisor relations to verify traversal + cycle guard do not produce transient flush errors.
+    - collection setter assignability (`Collection` vs `List`) for generated builders.
+
 ## [1.1.0] - 2025-09-01
 
 ### Improvements
@@ -27,11 +58,15 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 ## [1.0.1] - 2025-09-01
 
 ### Bug Fixes
+
 - Replaced falsely implemented Splatgames.de internal validations library with `java.util.Objects` for null checks.
 
 ### Enhancements
+
 - Added NOTICE file to the project root to comply with Apache-2.0 license requirements.
 
 ## [1.0.0] - 2025-08-31
+
 ### 🎉 Initial Release
+
 - First stable release of the project.

README.md

@@ -1,6 +1,6 @@
 ![License](https://img.shields.io/badge/license-MIT-red)
 ![Maven Central](https://img.shields.io/maven-central/v/de.splatgames.aether/aether-generators)
-![Version](https://img.shields.io/badge/version-1.1.0-green)
+![Version](https://img.shields.io/badge/version-1.1.1-green)
 
 # Aether Generators 🚀
 
@@ -17,6 +17,7 @@ support realistic test workflows.
 and optional multi‑output (e.g. `EmployeeDto`, `TransactionDto`).
 
 ✅ **MVC Builder Generator**: Generates `*Builder` for your entities with a clean testing API:
+
 - `transient()` and `persistent()` modes
 - `create()` / `createMany(n)`
 - `withX(...)` fluent setters
@@ -35,44 +36,49 @@ and optional multi‑output (e.g. `EmployeeDto`, `TransactionDto`).
 Aether Generators is available via **Maven** and **Gradle**.
 
 #### **Maven**
+
 > 🎉 All Aether products are available on **Maven Central** – no extra repository required!
 
 ```xml
+
 <dependency>
     <groupId>de.splatgames.aether</groupId>
     <artifactId>aether-generators</artifactId>
-    <version>1.1.0</version>
+    <version>1.1.1</version>
 </dependency>
 ```
 
 #### **Gradle**
 
 ```groovy
 dependencies {
-    implementation 'de.splatgames.aether:aether-generators:1.1.0'
+    implementation 'de.splatgames.aether:aether-generators:1.1.1'
 }
 ```
 
-> ℹ️ Fine‑grained usage per module (e.g., `aether-mvc-annotations`, `aether-mvc-runtime`, `aether-mvc-processor`) is supported; the umbrella artifact provides an easy start.
+> ℹ️ Fine‑grained usage per module (e.g., `aether-mvc-annotations`, `aether-mvc-runtime`, `aether-mvc-processor`) is
+> supported; the umbrella artifact provides an easy start.
 
 ---
 
 ## 🚀 Quick Start
 
 **1. Annotate your entity**
+
 ```java
 import de.splatgames.aether.mvcbuilder.annotations.MvcBuilder;
 
 @MvcBuilder
 public class Role {
-  private Long id;            // ignored by builder if annotated accordingly
-  private String name;
-  private boolean isDefault;
-  // @ManyToMany List<Permission> permissions;
+    private Long id;            // ignored by builder if annotated accordingly
+    private String name;
+    private boolean isDefault;
+    // @ManyToMany List<Permission> permissions;
 }
 ```
 
 **2. Use the generated builder in tests**
+
 ```java
 // Transient object (no DB writes)
 var role = new RoleBuilder()
@@ -89,23 +95,25 @@ var persisted = new RoleBuilder(new SpringPersistAdapter(ctx), new RoleDefaults(
 ```
 
 **3. Enable annotation processing (Maven)**
+
 ```xml
+
 <plugin>
-  <groupId>org.apache.maven.plugins</groupId>
-  <artifactId>maven-compiler-plugin</artifactId>
-  <version>3.11.0</version>
-  <configuration>
-    <parameters>true</parameters>
-    <release>17</release>
-  </configuration>
+    <groupId>org.apache.maven.plugins</groupId>
+    <artifactId>maven-compiler-plugin</artifactId>
+    <version>3.11.0</version>
+    <configuration>
+        <parameters>true</parameters>
+        <release>17</release>
+    </configuration>
 </plugin>
 ```
 
 ---
 
 ## 📢 Latest Release
 
-- 🚀 **Version:** `1.1.0`
+- 🚀 **Version:** `1.1.1`
 - 📅 **Release Date:** `September 1, 2025`
 - 📦 **Available on**:
   [![Maven Central](https://img.shields.io/maven-central/v/de.splatgames.aether/aether-generators)](https://search.maven.org/artifact/de.splatgames.aether/aether-generators)

aether-generators-bom/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>de.splatgames.aether</groupId>
         <artifactId>aether-generators</artifactId>
-        <version>1.1.0</version>
+        <version>1.1.1</version>
     </parent>
 
     <artifactId>aether-generators-bom</artifactId>

aether-generators-dto/aether-generators-dto-annotations/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>de.splatgames.aether</groupId>
         <artifactId>aether-generators-dto</artifactId>
-        <version>1.1.0</version>
+        <version>1.1.1</version>
     </parent>
 
     <artifactId>aether-generators-dto-annotations</artifactId>

aether-generators-dto/aether-generators-dto-annotations/src/main/java/de/splatgames/aether/generators/dto/annotations/Dto.java

@@ -89,7 +89,7 @@
  *     <dependency>
  *       <groupId>de.splatgames.aether</groupId>
  *       <artifactId>aether-generators-bom</artifactId>
- *       <version>1.1.0</version>
+ *       <version>1.1.1</version>
  *       <type>pom</type>
  *       <scope>import</scope>
  *     </dependency>
@@ -116,7 +116,7 @@
  *           <path>
  *             <groupId>de.splatgames.aether</groupId>
  *             <artifactId>aether-generators-dto-processor</artifactId>
- *             <version>1.1.0</version>
+ *             <version>1.1.1</version>
  *           </path>
  *         </annotationProcessorPaths>
  *         <generatedSourcesDirectory>

aether-generators-dto/aether-generators-dto-annotations/src/main/java/de/splatgames/aether/generators/dto/annotations/package-info.java

@@ -51,7 +51,7 @@
  *     <dependency>
  *       <groupId>de.splatgames.aether</groupId>
  *       <artifactId>aether-generators-bom</artifactId>
- *       <version>1.1.0</version>
+ *       <version>1.1.1</version>
  *       <type>pom</type>
  *       <scope>import</scope>
  *     </dependency>

aether-generators-dto/aether-generators-dto-examples/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>de.splatgames.aether</groupId>
         <artifactId>aether-generators-dto</artifactId>
-        <version>1.1.0</version>
+        <version>1.1.1</version>
     </parent>
 
     <artifactId>aether-generators-dto-examples</artifactId>

aether-generators-dto/aether-generators-dto-processor/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>de.splatgames.aether</groupId>
         <artifactId>aether-generators-dto</artifactId>
-        <version>1.1.0</version>
+        <version>1.1.1</version>
     </parent>
 
     <artifactId>aether-generators-dto-processor</artifactId>

aether-generators-dto/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>de.splatgames.aether</groupId>
         <artifactId>aether-generators</artifactId>
-        <version>1.1.0</version>
+        <version>1.1.1</version>
     </parent>
 
     <artifactId>aether-generators-dto</artifactId>

aether-generators-mvc/aether-generators-mvc-adapter-spring/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>de.splatgames.aether</groupId>
         <artifactId>aether-generators-mvc</artifactId>
-        <version>1.1.0</version>
+        <version>1.1.1</version>
     </parent>
 
     <artifactId>aether-generators-mvc-adapter-spring</artifactId>