Custom Types

Execution Workflow

1. Define the domain type and its canonical wire representation.
2. Register type decoders/encoders at the appropriate layer.
3. Ensure OpenAPI schema generation remains accurate for custom values.
4. Add round-trip tests for decode, business usage, and encode output.

Implementation Rules

• Keep serialization behavior stable and backward compatible.
• Fail fast with actionable error messages on invalid input.
• Avoid ambiguous representations that vary by locale/timezone.
• Keep custom type support centralized to prevent drift.

Example Pattern