[release] lib-serde-gson@1.0.0

Add Gson-based JSON serialization library implementing StringEncodingStrategy interface.

Features:
- GsonEncodingStrategy with fluent configuration API (withPrettyPrint, withSerializeNulls, withTypeAdapterFactory)
- Thread-safe lazy Gson initialization with double-checked locking
- Java 8 date/time type adapters (Instant, Duration, OffsetDateTime, LocalDateTime, LocalDate, LocalTime)
- RuntimeTypeAdapterFactory for polymorphic type handling
- GsonSerializable marker interface

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: pditommaso

.github/workflows/build.yml

@@ -80,6 +80,7 @@ jobs:
           bash publish.sh lib-random
           bash publish.sh lib-retry
           bash publish.sh lib-serde
+          bash publish.sh lib-serde-gson
           bash publish.sh lib-serde-moshi
           bash publish.sh lib-serde-jackson
           bash publish.sh lib-trace

.github/workflows/generate-submit-dependencies.yml

@@ -30,6 +30,7 @@ jobs:
           "lib-random",
           "lib-retry",
           "lib-serde",
+          "lib-serde-gson",
           "lib-serde-moshi",
           "lib-serde-jackson",
           "lib-trace",

lib-serde-gson/README.md

@@ -0,0 +1,143 @@
+# lib-serde-gson
+
+Gson-based JSON serialization library implementing the lib-serde `StringEncodingStrategy` interface.
+
+## Installation
+
+```gradle
+dependencies {
+    implementation 'io.seqera:lib-serde-gson:1.0.0'
+}
+```
+
+## Usage
+
+### Basic Usage
+
+```java
+// Create an encoder for your type using anonymous class
+GsonEncodingStrategy<MyData> encoder = new GsonEncodingStrategy<MyData>() {};
+
+// Encode to JSON
+String json = encoder.encode(myData);
+
+// Decode from JSON
+MyData decoded = encoder.decode(json);
+```
+
+### Configuration Options
+
+```java
+GsonEncodingStrategy<MyData> encoder = new GsonEncodingStrategy<MyData>() {}
+    .withPrettyPrint(true)       // Enable pretty printing
+    .withSerializeNulls(true);   // Include null fields in output
+```
+
+### Polymorphic Serialization
+
+Use `RuntimeTypeAdapterFactory` for serializing class hierarchies:
+
+```java
+RuntimeTypeAdapterFactory<Animal> factory = RuntimeTypeAdapterFactory
+    .of(Animal.class, "@type")
+    .registerSubtype(Dog.class, "Dog")
+    .registerSubtype(Cat.class, "Cat");
+
+GsonEncodingStrategy<Animal> encoder = new GsonEncodingStrategy<Animal>() {}
+    .withTypeAdapterFactory(factory);
+
+// Serializes to: {"@type":"Dog","name":"Rex","barkVolume":10}
+String json = encoder.encode(new Dog("Rex", 10));
+
+// Deserializes to correct subtype
+Animal animal = encoder.decode(json); // Returns Dog instance
+```
+
+## Features
+
+- **Type-safe encoding** with automatic generic type inference
+- **Fluent configuration API** for customizing serialization behavior
+- **Thread-safe** lazy Gson initialization with double-checked locking
+- **Java 8 date/time support** with ISO-8601 format:
+  - `Instant` - e.g., `"2025-01-01T00:00:00Z"`
+  - `Duration` - e.g., `"PT1H30M"`
+  - `OffsetDateTime` - e.g., `"2025-01-01T12:00:00+02:00"`
+  - `LocalDateTime` - e.g., `"2025-01-01T12:00:00"`
+  - `LocalDate` - e.g., `"2025-01-01"`
+  - `LocalTime` - e.g., `"12:30:45"`
+- **Polymorphic type handling** via RuntimeTypeAdapterFactory
+- **Null-safe** encode/decode operations
+
+## Type Adapters
+
+The following type adapters are automatically registered:
+
+| Type | Format | Example |
+|------|--------|---------|
+| `Instant` | ISO-8601 | `"2025-01-06T10:30:00Z"` |
+| `Duration` | ISO-8601 | `"PT2H30M"` |
+| `OffsetDateTime` | ISO-8601 | `"2025-01-06T10:30:00+02:00"` |
+| `LocalDateTime` | ISO-8601 | `"2025-01-06T10:30:00"` |
+| `LocalDate` | ISO-8601 | `"2025-01-06"` |
+| `LocalTime` | ISO-8601 | `"10:30:45"` |
+
+### Custom Type Adapters
+
+You can create custom type adapters for your own types by extending `TypeAdapter<T>`:
+
+```java
+import com.google.gson.TypeAdapter;
+import com.google.gson.stream.JsonReader;
+import com.google.gson.stream.JsonToken;
+import com.google.gson.stream.JsonWriter;
+
+public class MoneyAdapter extends TypeAdapter<Money> {
+    @Override
+    public void write(JsonWriter writer, Money value) throws IOException {
+        if (value == null) {
+            writer.nullValue();
+            return;
+        }
+        // Serialize as "100.50 USD"
+        writer.value(value.getAmount() + " " + value.getCurrency());
+    }
+
+    @Override
+    public Money read(JsonReader reader) throws IOException {
+        if (reader.peek() == JsonToken.NULL) {
+            reader.nextNull();
+            return null;
+        }
+        String[] parts = reader.nextString().split(" ");
+        return new Money(new BigDecimal(parts[0]), parts[1]);
+    }
+}
+```
+
+Register the custom adapter using a `TypeAdapterFactory`:
+
+```java
+import com.google.gson.Gson;
+import com.google.gson.TypeAdapter;
+import com.google.gson.TypeAdapterFactory;
+import com.google.gson.reflect.TypeToken;
+
+TypeAdapterFactory moneyFactory = new TypeAdapterFactory() {
+    @Override
+    public <T> TypeAdapter<T> create(Gson gson, TypeToken<T> type) {
+        if (type.getRawType() == Money.class) {
+            return (TypeAdapter<T>) new MoneyAdapter();
+        }
+        return null;
+    }
+};
+
+GsonEncodingStrategy<Order> encoder = new GsonEncodingStrategy<Order>() {}
+    .withTypeAdapterFactory(moneyFactory);
+```
+
+## Dependencies
+
+- `lib-serde` - Base serialization interfaces
+- `lib-lang` - Type utilities for generic type inference
+- `com.google.code.gson:gson` - Google Gson library

lib-serde-gson/VERSION

@@ -0,0 +1 @@
+1.0.0

lib-serde-gson/build.gradle

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2026, Seqera Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+plugins {
+    id 'io.seqera.java-library-conventions'
+}
+
+group = 'io.seqera'
+version = file('VERSION').text.trim()
+
+dependencies {
+    api project(':lib-serde')
+    api project(':lib-lang')
+    api 'com.google.code.gson:gson:2.11.0'
+
+    testImplementation 'org.spockframework:spock-core'
+}

lib-serde-gson/changelog.txt

@@ -0,0 +1,5 @@
+1.0.0 - 6 Jan 2026
+  Initial release with Gson-based serialization
+  GsonEncodingStrategy with fluent configuration API
+  Type adapters for Java 8 date/time types (Instant, Duration, OffsetDateTime, LocalDateTime, LocalDate, LocalTime)
+  RuntimeTypeAdapterFactory for polymorphic type handling