System.Text.Json

SuperStrong.Types supports System.Text.Json out of the box. No package or setup is required.

Serialization

The source generator annotates every strong type with a [JsonConverter] attribute pointing to the built-in JsonStrongTypeConverter<TStrongType, TPrimitive>:

[JsonConverter(typeof(JsonStrongTypeConverter<OrderId, int>))] // auto-generated
public sealed partial class OrderId;

Serialization writes the underlying primitive:

JsonSerializer.Serialize(OrderId.From(1)); // 1

Deserialization reads it back into the strong type:

JsonSerializer.Deserialize<OrderId>("1"); // OrderId.From(1)

TIP

When reading from JSON, values go through From(...), so they are always validated.