Support sending and receiving strongly typed IDs as strings in REST endpoints

tjementum commented 2 weeks ago

Summary & Motivation

Update REST endpoints to support sending and receiving strongly typed IDs as strings in JSON request bodies and responses. Previously, strongly typed IDs were only supported on endpoint routes, like group.MapGet("/{id}", (UserId id) => { });.

In JSON request and response bodies, they were sent in an object format:

"id": {
  "value": "usr_01JBQ59BD2SMRX0HQN7FTJM7F8"
}

With this update, strongly typed IDs can now be represented as simple strings in JSON:

"id": "usr_01JBQ59BD2SMRX0HQN7FTJM7F8"

This change enables full compatibility with the OpenAPI JSON-to-TypeScript converter, which already supports strongly typed IDs, achieving strong typing throughout the entire application.