@hemia/email-sender

Una librería ligera y extensible para el envío de correos electrónicos usando Nodemailer, compatible con plantillas EJS y MJML. Soporta múltiples destinatarios, CC, BCC, adjuntos y renderizado dinámico de contenido.

Características

• ✅ Basado en nodemailer
• ✅ Soporte para plantillas HTML (EJS, MJML)
• ✅ Múltiples destinatarios (to, cc, bcc)
• ✅ Adjuntos (attachments)
• ✅ Configuración SMTP flexible
• ✅ Ideal para sistemas de notificación
• ✅ Separación de lógica de renderizado con TemplateManager

Instalación

npm install @hemia/email-sender

Uso básico

import { EmailSender } from '@hemia/email-sender';

const emailSender = new EmailSender({
  host: 'smtp.example.com',
  port: 465,
  secure: true,
  auth: {
    user: '[email protected]',
    pass: 'password123'
  }
});

await emailSender.sendEmail({
  to: '[email protected]',
  subject: 'Asunto del correo',
  template: 'welcome-template.ejs',
  data: { nombre: 'Juan', link: 'https://ejemplo.com' },
  app: 'MiApp'
});

Uso avanzado con CC, BCC y adjuntos

await emailSender.sendEmail({
  to: ['[email protected]', '[email protected]'],
  cc: '[email protected]',
  bcc: ['[email protected]'],
  subject: 'Con adjuntos',
  template: 'invoice.ejs',
  data: { total: '$99.00' },
  attachments: [
    {
      filename: 'factura.pdf',
      path: '/ruta/factura.pdf'
    }
  ]
});

Interfaces disponibles

interface EmailSenderConfig {
  host: string;
  port: number;
  secure: boolean;
  auth: {
    user: string;
    pass: string;
  };
}

interface EmailOptions {
  to: string | string[];
  subject: string;
  template: string;
  data?: Record<string, any>;
  app?: string;
  cc?: string | string[];
  bcc?: string | string[];
  attachments?: {
    filename: string;
    path?: string;
    content?: string | Buffer;
  }[];
}

Estructura de plantillas

templates/
  welcome-template.ejs
  reset-password.ejs

Puedes personalizar el TemplateManager para soportar MJML, EJS u otros motores de renderizado.

Licencia

MIT — © Hemia Technologies

Desarrollado por Hemia Technologies