Cayaqui.MPS.Email 0.1.1

Cayaqui.MPS.Email

Servicio genérico de Email para .NET 10 con proveedores intercambiables + renderer de templates:

• Azure Communication Services (ACS) — recomendado para stacks Azure-native.
• SMTP (vía MailKit) — útil para Exchange Online, MailHog/Papercut en dev, corporativos.
• Templates Scriban cargados desde IStorageService (convención <key>.subject.txt + <key>.html + <key>.text opcional).
• Inlining CSS automático con PreMailer.Net (compatibilidad Outlook/Gmail).

Distribución propietaria — requiere contrato comercial con Cayaqui. Ver LICENSE.txt.

Dependencia: este paquete requiere Cayaqui.MPS.Storage registrado (AddMpsStorage(...)) para cargar los templates.

Instalación

dotnet add package Cayaqui.MPS.Email
dotnet add package Cayaqui.MPS.Storage

Registro

// ACS con connection string
builder.Services.AddMpsStorage(opt => opt.UseAzureBlob(Configuration["Storage:ConnString"]));
builder.Services.AddMpsEmail(opt =>
    opt.UseAzureCommunicationServices(
        connectionString: Configuration["Acs:ConnString"]!,
        defaultSender:    new EmailAddress("no-reply@cayaqui.com", "MPS")));

// SMTP (Exchange Online / O365)
builder.Services.AddMpsEmail(opt =>
{
    opt.DefaultFrom = new EmailAddress("no-reply@cayaqui.com", "MPS");
    opt.UseSmtp("smtp.office365.com", 587, user, pass, useSsl: true);
});

Uso directo

public class NotificationService(IEmailService email)
{
    public Task NotifyAsync(string userEmail)
        => email.SendAsync(new EmailMessage
        {
            Subject = "Tu reporte está listo",
            HtmlBody = "<p>Hola, tu reporte semanal está adjunto.</p>"
        }.AddTo(new EmailAddress(userEmail)));
}

Uso con templates

1. Subir los templates al container (default email-templates):

email-templates/welcome.subject.txt    → "Bienvenido, {{ user.name }}"
email-templates/welcome.html           → "<h1>Hola {{ user.name }}</h1>..."
email-templates/welcome.text           → "Hola {{ user.name }}..."   (opcional)

2. Enviar:

await email.SendTemplateAsync(
    templateKey: "welcome",
    dataContext: new { user = new { name = "Ana" } },
    message:     new EmailMessage().AddTo("ana@example.com"));

Sintaxis Scriban: {{ user.name }}, {{ for item in items }}...{{ end }}, filtros | upcase, | date.to_string "dd MMM yy", etc.

Nota sobre colecciones: para iteración con {{ for ... }} funciona mejor pasar colecciones como Dictionary<string, object>[] o IDictionary<string, object>[] (Scriban maneja diccionarios nativamente). Anonymous types y POCOs anidados pueden requerir ajustar MemberRenamer/MemberFilter.

Requisitos

• .NET 10.0 o superior
• Cayaqui.MPS.Storage registrado (para templates)
• Cuenta Azure Communication Services (si se usa ACS) o servidor SMTP accesible