Aethel.Services.Emissary 1.0.0

Emissary

Version inicial

Emissary es un enviador de correos de sistema con implementacion inicial SMTP, pero abierto a futuras implementaciones basadas en la interface IMailService, es decir, las futuras implementaciones con SendGrid por ejemplo, como cliente de envio de correos de sistema se agregarán a Emissary sin necesidad de cambiar las implementaciones que tengas en los proyectos. Emissary es una capa de abstraccion para los envios empresariales, que se inyecta en los servicios de una aplicacion y centraliza la configuracion de tu instancia, dejando una implementacion limpia, pues solo necesitas especificar el destinatario, el subject y el contenido.

Features

• Implementacion del servicio de correos utilizando MailKit y MimeTypes bajo el capo
• Configuracion centralizada en el startup para configuraciones generales de Emissary y especificas de SMTP
• Se expone solo un metodo para envio de correos empresariales, en el futuro se agregaran los necesarios

Configuracion

Para integrar Emissary solo necesitamos realizar una configuracion cuando lo agregamos a la inyeccion de dependencias de NetCore.

var services = new ServiceCollection();
// some configurations
services.AddEmissary(options =>{
    options.Name = "Sistem Name",
    options.Address = "Server Email Address",
    options.UseSmtpClient(smtp =>{
        smtp.Host = "Smtp hots";
        smtp.Port = Smtp Port;
        smtp.Username = "Username to login";
        smtp.Password = "Password to login"
    });
});

Por el momento, Emissary solo tiene la implementacion de servicio de correos utilizando SMTP, es por eso que la configuracion utiliza SMTP. En futuros releases se agregaran otros clientes y servicios de correo como Sendgrid. Para utilizar el servicio de correo solo basta inyectar en el sitio donde lo vamos a utilizar la interfaz IMailService, y con eso, tendremos acceso al servicio de correos configurado con los datos presentados arriba. Para enviar un mensaje, tan solo debemos de crear el objeto Message que define lo necesario para enviar el mensaje a traves del servicio de correo.

public class SomeClass{
    private readonly IMailService _mailService;
    
    public SomeClass(IMailService mailService){
        _mailService = mailService
    }
    
    public Task SomeMethod(){
    
        // Se ejecuta de forma asincrona por default
        await _mailService.SendSystemEmailAsync(new Message{
            Subject = "Tu asunto",
            Recipient = new Contact{ Name = "Nombre del destinatario", Address = "Direccion del usuario" },
            Content = "Tu contenido en html"
        });
    }
}

Con estos dos pasos podemos enviar los correos de sistema que necesitemos y en caso de cambiar la direccion de correo desde donde envian, pueden manejar estas modificaciones desde el appsettings.

Versiones y fechas de lanzamiento

License

MIT

If it works, learn how it do