Cosmos.Types.Paises 1.1.1

Cosmos.Types.Paises

Pais — Value Object de país para el ERP Cosmos, con catálogo embebido de 195 países (código ISO, nombre, indicativo telefónico, moneda). Viaja dentro de eventos event-sourced (JSONB) aguas abajo, por lo que su forma serializada es un contrato estable.

Instalación

dotnet add package Cosmos.Types.Paises

Construcción

Pais es un VO de catálogo: su puerta pública es Obtener(...), que lanza ArgumentException si el código no existe o no está activo. Es la forma correcta para un código confiable (un literal del dev, un valor ya validado aguas arriba):

using Cosmos.Types.Paises;

var colombia = Pais.Obtener("CO");   // lanza ArgumentException si "CO" no existe/activo

La factory Crear(...) : Result<Pais> (que valida sin lanzar) es internal: no está disponible para el consumidor. Un Pais solo se obtiene por Obtener, lo que garantiza que todo Pais tipado en tu código es válido por construcción.

Forma serializada

{ "codigo": "CO" }

Las claves son camelCase ancladas con [JsonPropertyName]: el wire es determinista e independiente del JsonSerializerOptions del consumidor. Los datos descriptivos (Nombre, IndicativoTelefonico, MonedaPrincipal) son accessors derivados del catálogo, marcados [JsonIgnore]: no viajan en el evento.

Rehidratación (deserialización)

No requiere setup: ni JsonConverter ni JsonSerializerContext registrados; basta el STJ por defecto. Al deserializar un evento histórico el VO se rehidrata crudo ([JsonConstructor]), sin validar — un código que ya no figura en el catálogo igual se rehidrata. En ese estado poison los accessors derivados resuelven a null sin lanzar (pais.Nombre == null).

Listado

Para poblar un selector en un frontend usá Pais.Listar() — devuelve los mismos Pais que consume la escritura, así que el valor elegido fluye directo a las factories tipadas. Las etiquetas de display no viajan serializadas, por lo que el backend consumidor proyecta su propio DTO de API:

var paisesDto = Pais.Listar().Select(pais => new { pais.Codigo, pais.Nombre });

Dependencias

• Cosmos.Types.Abstractions (kernel: Result<T>)

Requiere net10.0.

Documentación

• Convenciones de los nuggets

Licencia

Uso interno del ERP Cosmos.