chore(release): bump version to 0.7.0 for response modernization

Author: bsayli

README.md

@@ -16,8 +16,11 @@
   <em>End-to-end generics-aware OpenAPI clients — unified <code>{ data, meta }</code> responses without boilerplate.</em>
 </p>
 
-**Modern, type-safe OpenAPI client generation** — powered by **Spring Boot 3.4**, **Java 21**, and **OpenAPI Generator 7.16.0**.
-This repository demonstrates a production-grade architecture where backend and client are fully aligned through generics, enabling nested generic envelopes (ServiceResponse<Page<T>>) and RFC 7807 ProblemDetail (Problem Details for HTTP APIs)–based error handling.
+**Modern, type-safe OpenAPI client generation** — powered by **Spring Boot 3.4**, **Java 21**, and **OpenAPI Generator
+7.16.0**.
+This repository demonstrates a production-grade architecture where backend and client are fully aligned through
+generics, enabling nested generic envelopes (ServiceResponse<Page<T>>) and RFC 7807 ProblemDetail (Problem Details for
+HTTP APIs)–based error handling.
 
 ---
 
@@ -36,14 +39,16 @@ This repository demonstrates a production-grade architecture where backend and c
 * 📘 [Adoption Guides](#-adoption-guides)
 * 🔗 [References & Links](#-references--links)
 
-> *A clean architecture pattern for building generics-aware OpenAPI clients that stay fully type-safe, consistent, and boilerplate-free.*
+> *A clean architecture pattern for building generics-aware OpenAPI clients that stay fully type-safe, consistent, and
+boilerplate-free.*
 
 ---
 
 ## 📦 Modules
 
 * [**customer-service**](customer-service/README.md) — sample backend exposing `/v3/api-docs.yaml` via Springdoc
-* [**customer-service-client**](customer-service-client/README.md) — generated OpenAPI client with generics-aware wrappers
+* [**customer-service-client**](customer-service-client/README.md) — generated OpenAPI client with generics-aware
+  wrappers
 
 ---
 
@@ -54,6 +59,7 @@ When backend APIs wrap payloads in `ServiceResponse<T>` (e.g., the unified `{ da
 the generator produces **duplicated models per endpoint** instead of a single reusable generic base.
 
 This results in:
+
 * ❌ Dozens of almost-identical response classes
 * ❌ Higher maintenance overhead
 * ❌ Harder to evolve a single envelope contract across services
@@ -66,7 +72,8 @@ This project provides a **full-stack pattern** to align Spring Boot services and
 
 ### Server-Side (Producer)
 
-A `Springdoc` customizer automatically scans controller return types and marks generic wrappers (`ServiceResponse<T>`) using vendor extensions:
+A `Springdoc` customizer automatically scans controller return types and marks generic wrappers (`ServiceResponse<T>`)
+using vendor extensions:
 
 ```yaml
 x-api-wrapper: true
@@ -77,15 +84,18 @@ x-data-item: CustomerDto
 
 ### Client-Side (Consumer)
 
-Mustache overlays redefine OpenAPI templates to generate **thin, type-safe wrappers** extending a reusable base class `ServiceClientResponse<T>`.
+Mustache overlays redefine OpenAPI templates to generate **thin, type-safe wrappers** extending a reusable base class
+`ServiceClientResponse<T>`.
 
 **Example generated output:**
 
 ```java
-public class ServiceResponseCustomerDto extends ServiceClientResponse<CustomerDto> {}
+public class ServiceResponseCustomerDto extends ServiceClientResponse<CustomerDto> {
+}
 ```
 
-This pattern supports **nested generics** like `ServiceClientResponse<Page<CustomerDto>>` and maps all error responses into **ProblemDetail** objects.
+This pattern supports **nested generics** like `ServiceClientResponse<Page<CustomerDto>>` and maps all error responses
+into **ProblemDetail** objects.
 
 ---
 
@@ -98,7 +108,7 @@ This pattern supports **nested generics** like `ServiceClientResponse<Page<Custo
 </p>
 
 | Layer                 | Description                                                               |
-| --------------------- | ------------------------------------------------------------------------- |
+|-----------------------|---------------------------------------------------------------------------|
 | **Server (Producer)** | Publishes OpenAPI 3.1 spec with auto-registered wrapper schemas           |
 | **Client (Consumer)** | Uses OpenAPI Generator 7.16.0 + Mustache overlays for generics support    |
 | **Envelope Model**    | Unified `{ data, meta }` response structure                               |
@@ -159,8 +169,16 @@ The unified envelope applies to both single and paged responses. Below is a page
 {
   "data": {
     "content": [
-      { "customerId": 1, "name": "Jane Doe", "email": "[email protected]" },
-      { "customerId": 2, "name": "John Smith", "email": "[email protected]" }
+      {
+        "customerId": 1,
+        "name": "Jane Doe",
+        "email": "[email protected]"
+      },
+      {
+        "customerId": 2,
+        "name": "John Smith",
+        "email": "[email protected]"
+      }
     ],
     "page": 0,
     "size": 5,
@@ -172,7 +190,10 @@ The unified envelope applies to both single and paged responses. Below is a page
   "meta": {
     "serverTime": "2025-01-01T12:34:56Z",
     "sort": [
-      { "field": "CUSTOMER_ID", "direction": "ASC" }
+      {
+        "field": "CUSTOMER_ID",
+        "direction": "ASC"
+      }
     ]
   }
 }
@@ -186,17 +207,20 @@ ServiceClientResponse<Page<CustomerDto>> resp =
                 "Jane", null, 0, 5, SortField.CUSTOMER_ID, SortDirection.ASC);
 
 Page<CustomerDto> page = resp.getData();
-for (CustomerDto c : page.content()) {
+for(
+CustomerDto c :page.
+
+content()){
         // ...
-}
+        }
 ```
 
 ---
 
 ## 🧩 Tech Stack
 
 | Component             | Version | Purpose                               |
-| --------------------- | ------- | ------------------------------------- |
+|-----------------------|---------|---------------------------------------|
 | **Java**              | 21      | Language baseline                     |
 | **Spring Boot**       | 3.4.10  | REST + OpenAPI provider               |
 | **Springdoc**         | 2.8.13  | OpenAPI 3.1 integration               |
@@ -244,8 +268,13 @@ See the detailed integration steps under [`docs/adoption`](docs/adoption):
 ## 🔗 References & Links
 
 * 🌐 [GitHub Pages — Adoption Guides](https://bsayli.github.io/spring-boot-openapi-generics-clients/)
-* 📘 [Medium — Type-Safe Generic API Responses](https://medium.com/@baris.sayli/type-safe-generic-api-responses-with-spring-boot-3-4-openapi-generator-and-custom-templates-ccd93405fb04)
-* 💬 [Dev.to — Type-Safe OpenAPI Clients Without Boilerplate](https://dev.to/barissayli/spring-boot-openapi-generator-type-safe-generic-api-clients-without-boilerplate-3a8f)
+*
+
+📘 [Medium — Type-Safe Generic API Responses](https://medium.com/@baris.sayli/type-safe-generic-api-responses-with-spring-boot-3-4-openapi-generator-and-custom-templates-ccd93405fb04)
+
+*
+
+💬 [Dev.to — Type-Safe OpenAPI Clients Without Boilerplate](https://dev.to/barissayli/spring-boot-openapi-generator-type-safe-generic-api-clients-without-boilerplate-3a8f)
 
 ---
 

customer-service-client/README.md

@@ -36,7 +36,8 @@ mvn -q clean install
 ## ✅ What You Get
 
 * Java client using **OpenAPI Generator 7.16.0** with the **Spring `RestClient`** library.
-* A reusable generic base: `io.github.bsayli.openapi.client.common.ServiceClientResponse<T>` containing `data` and `meta`.
+* A reusable generic base: `io.github.bsayli.openapi.client.common.ServiceClientResponse<T>` containing `data` and
+  `meta`.
 * **Nested generics support**: wrappers such as `ServiceClientResponse<Page<CustomerDto>>`.
 * **RFC 7807 Problem decoding** via `ClientProblemException`.
 * **Spring Boot configuration** for pooled HttpClient5 + `RestClientCustomizer` for error handling.
@@ -46,7 +47,8 @@ mvn -q clean install
 
 ## 🧠 How the Thin Wrappers Are Produced
 
-Server marks wrapper schemas with vendor extensions. The Mustache overlay generates thin wrappers extending the generic base.
+Server marks wrapper schemas with vendor extensions. The Mustache overlay generates thin wrappers extending the generic
+base.
 
 ```mustache
 {{! Generics-aware thin wrapper }}
@@ -85,11 +87,13 @@ public class ServiceClientResponse<T> {
     private ClientMeta meta;
 }
 
-public record ClientMeta(Instant serverTime, List<ClientSort> sort) {}
+public record ClientMeta(Instant serverTime, List<ClientSort> sort) {
+}
 
 public record Page<T>(List<T> content, int page, int size,
                       long totalElements, int totalPages,
-                      boolean hasNext, boolean hasPrev) {}
+                      boolean hasNext, boolean hasPrev) {
+}
 ```
 
 **Problem Exception:**
@@ -106,47 +110,49 @@ public class ClientProblemException extends RuntimeException {
 ## ⚙️ Spring Configuration (Production-Ready)
 
 ```java
+
 @Configuration
 public class CustomerApiClientConfig {
 
-  @Bean
-  RestClientCustomizer problemDetailStatusHandler(ObjectMapper om) {
-    return builder -> builder.defaultStatusHandler(
-      HttpStatusCode::isError,
-      (request, response) -> {
-        ProblemDetail pd = null;
-        try (var is = response.getBody()) {
-          pd = om.readValue(is, ProblemDetail.class);
-        } catch (Exception ignore) {}
-        throw new ClientProblemException(pd, response.getStatusCode().value());
-      });
-  }
-
-  @Bean(destroyMethod = "close")
-  CloseableHttpClient customerHttpClient(
-      @Value("${customer.api.max-connections-total:64}") int maxTotal,
-      @Value("${customer.api.max-connections-per-route:16}") int maxPerRoute) {
-    var cm = PoolingHttpClientConnectionManagerBuilder.create()
-        .setMaxConnTotal(maxTotal)
-        .setMaxConnPerRoute(maxPerRoute)
-        .build();
-    return HttpClients.custom()
-        .setConnectionManager(cm)
-        .evictExpiredConnections()
-        .evictIdleConnections(org.apache.hc.core5.util.TimeValue.ofSeconds(30))
-        .setUserAgent("customer-service-client")
-        .disableAutomaticRetries()
-        .build();
-  }
-
-  @Bean
-  RestClient customerRestClient(RestClient.Builder builder,
-                                HttpComponentsClientHttpRequestFactory rf,
-                                List<RestClientCustomizer> customizers) {
-    builder.requestFactory(rf);
-    if (customizers != null) customizers.forEach(c -> c.customize(builder));
-    return builder.build();
-  }
+    @Bean
+    RestClientCustomizer problemDetailStatusHandler(ObjectMapper om) {
+        return builder -> builder.defaultStatusHandler(
+                HttpStatusCode::isError,
+                (request, response) -> {
+                    ProblemDetail pd = null;
+                    try (var is = response.getBody()) {
+                        pd = om.readValue(is, ProblemDetail.class);
+                    } catch (Exception ignore) {
+                    }
+                    throw new ClientProblemException(pd, response.getStatusCode().value());
+                });
+    }
+
+    @Bean(destroyMethod = "close")
+    CloseableHttpClient customerHttpClient(
+            @Value("${customer.api.max-connections-total:64}") int maxTotal,
+            @Value("${customer.api.max-connections-per-route:16}") int maxPerRoute) {
+        var cm = PoolingHttpClientConnectionManagerBuilder.create()
+                .setMaxConnTotal(maxTotal)
+                .setMaxConnPerRoute(maxPerRoute)
+                .build();
+        return HttpClients.custom()
+                .setConnectionManager(cm)
+                .evictExpiredConnections()
+                .evictIdleConnections(org.apache.hc.core5.util.TimeValue.ofSeconds(30))
+                .setUserAgent("customer-service-client")
+                .disableAutomaticRetries()
+                .build();
+    }
+
+    @Bean
+    RestClient customerRestClient(RestClient.Builder builder,
+                                  HttpComponentsClientHttpRequestFactory rf,
+                                  List<RestClientCustomizer> customizers) {
+        builder.requestFactory(rf);
+        if (customizers != null) customizers.forEach(c -> c.customize(builder));
+        return builder.build();
+    }
 }
 ```
 
@@ -166,23 +172,24 @@ customer.api.read-timeout-seconds=15
 ## 🧩 Adapter Pattern Example
 
 ```java
+
 @Service
 public class CustomerClientAdapterImpl implements CustomerClientAdapter {
-  private final CustomerControllerApi api;
-
-  public CustomerClientAdapterImpl(CustomerControllerApi api) {
-    this.api = api;
-  }
-
-  @Override
-  public ServiceClientResponse<Page<CustomerDto>> getCustomers(
-      String name, String email, Integer page, Integer size,
-      SortField sortBy, SortDirection direction) {
-    return api.getCustomers(
-        name, email, page, size,
-        sortBy != null ? sortBy.value() : SortField.CUSTOMER_ID.value(),
-        direction != null ? direction.value() : SortDirection.ASC.value());
-  }
+    private final CustomerControllerApi api;
+
+    public CustomerClientAdapterImpl(CustomerControllerApi api) {
+        this.api = api;
+    }
+
+    @Override
+    public ServiceClientResponse<Page<CustomerDto>> getCustomers(
+            String name, String email, Integer page, Integer size,
+            SortField sortBy, SortDirection direction) {
+        return api.getCustomers(
+                name, email, page, size,
+                sortBy != null ? sortBy.value() : SortField.CUSTOMER_ID.value(),
+                direction != null ? direction.value() : SortDirection.ASC.value());
+    }
 }
 ```
 
@@ -205,11 +212,12 @@ var serverTime = resp.getMeta().serverTime();
 Error handling:
 
 ```java
-try {
-  customerClientAdapter.getCustomer(999);
-} catch (ClientProblemException ex) {
-  var pd = ex.getProblem();
-  // pd.getTitle(), pd.getDetail(), pd.getErrorCode(), etc.
+try{
+        customerClientAdapter.getCustomer(999);
+}catch(
+ClientProblemException ex){
+var pd = ex.getProblem();
+// pd.getTitle(), pd.getDetail(), pd.getErrorCode(), etc.
 }
 ```
 

customer-service-client/pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>io.github.bsayli</groupId>
     <artifactId>customer-service-client</artifactId>
-    <version>0.6.8</version>
+    <version>0.7.0</version>
     <name>customer-service-client</name>
     <description>Generated client (RestClient) using generics-aware OpenAPI templates</description>
     <packaging>jar</packaging>

customer-service-client/src/main/resources/customer-api-docs.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 info:
   title: Customer Service API
   description: Customer Service API with type-safe generic responses using OpenAPI
-  version: 0.6.8
+  version: 0.7.0
 servers:
   - url: http://localhost:8084/customer-service
     description: Local service URL