Cosmos.Types.CorreosElectronicos 1.1.1

dotnet add package Cosmos.Types.CorreosElectronicos --version 1.1.1
                    
NuGet\Install-Package Cosmos.Types.CorreosElectronicos -Version 1.1.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Cosmos.Types.CorreosElectronicos" Version="1.1.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Cosmos.Types.CorreosElectronicos" Version="1.1.1" />
                    
Directory.Packages.props
<PackageReference Include="Cosmos.Types.CorreosElectronicos" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Cosmos.Types.CorreosElectronicos --version 1.1.1
                    
#r "nuget: Cosmos.Types.CorreosElectronicos, 1.1.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Cosmos.Types.CorreosElectronicos@1.1.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Cosmos.Types.CorreosElectronicos&version=1.1.1
                    
Install as a Cake Addin
#tool nuget:?package=Cosmos.Types.CorreosElectronicos&version=1.1.1
                    
Install as a Cake Tool

Cosmos.Types.CorreosElectronicos

NuGet

CorreoElectronico — Value Object de correo electrónico para el ERP Cosmos: valida y normaliza la dirección. 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.CorreosElectronicos

Construcción

CorreoElectronico no es de catálogo: su puerta pública es la factory Crear(...) : Result<CorreoElectronico>, que valida sin lanzar y devuelve el patrón EsExitoso / .Valor / .Errores. Es lo correcto para input no confiable (un formulario, una API):

using Cosmos.Types.CorreosElectronicos;

var resultado = CorreoElectronico.Crear("persona@dominio.com");

if (resultado.EsExitoso)
    UsarCorreo(resultado.Valor);
else
    foreach (var error in resultado.Errores)
        Console.WriteLine(error.Codigo);   // V01 (vacío), V02 (formato), V03 (longitud)

La dirección se valida, no se sanea: un espacio interno se rechaza (no se filtra) y el dominio debe estar bien formado (≥2 etiquetas no vacías y un TLD de 2+ letras) bajo la regla V02. Solo se canonicaliza lo cosmético (trim de los bordes y minúsculas).

Forma serializada

{ "valor": "persona@dominio.com" }

La clave es camelCase anclada con [JsonPropertyName]: el wire es determinista e independiente del JsonSerializerOptions del consumidor.

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 valor que ya no cumple las reglas actuales igual se rehidrata.

Dependencias

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

Requiere net10.0.

Documentación

Licencia

Uso interno del ERP Cosmos.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Cosmos.Types.CorreosElectronicos:

Package Downloads
Cosmos.Types.Contactos

Value Object Contacto para el ERP Cosmos: nombre, rol (catálogo embebido de 7 roles) y medios de contacto (correos y/o teléfonos). Diseñado para eventos event-sourced.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.1 112 6/30/2026
1.1.0 110 6/24/2026