namespace Zentient.Results.Serialization

Provides a polymorphic System.Text.Json.Serialization.JsonConverterFactory that serializes and deserializes IResult, IResult<T>, Result, and Result<T> instances with full fidelity, preserving status, messages, errors, and encapsulated values.

Enables System.Text.Json to:

• Serialize and deserialize IResult and IResult<T> preserving complete structure.
• Customize serialization details based on JsonSerializerOptions.
• Decouple serialization from concrete implementations such as Result<T>.
• Support transport-safe, protocol-agnostic JSON representations.

var options = new JsonSerializerOptions();
options.Converters.Add(new ResultJsonConverter());

string json = JsonSerializer.Serialize(Result<int>.Success(42, "OK"), options);

public override bool CanConvert(Type typeToConvert)

Determines if the converter supports the specified type.

public override JsonConverter? CreateConverter(Type typeToConvert, JsonSerializerOptions options)

Creates an appropriate JsonConverter instance for the specified result type.

Behavior:

• Returns ResultGenericJsonConverter<T> for generic types (Result<T>, IResult<T>).
• Returns ResultNonGenericJsonConverter for non-generic types (Result, IResult).
• Returns null for unsupported types.

Supports full serialization/deserialization of Result<T> including fields:

• value
• isSuccess
• isFailure
• status
• messages
• errors
• errorMessage (optional)

Handles Result serialization excluding value property but including all other common fields.

• Avoid multiple registrations of ResultJsonConverter in different JsonSerializerOptions instances.
• Honors camelCase naming via configured PropertyNamingPolicy.
• Gracefully handles partial or unknown fields during deserialization.

{
  "value": 100,
  "isSuccess": true,
  "status": { "code": 0, "description": "Success" },
  "messages": ["Completed successfully"]
}