meily

Meily 📧

Meily es un paquete minimalista para el envío de correos electrónicos en Node.js utilizando nodemailer, con soporte para plantillas HTML basadas en Handlebars y una sintaxis fluida y sencilla.

🚀 Instalación

npm install meily

⚙️ Configuración

Meily depende de los siguientes valores de entorno, que debes definir en tu archivo .env:

Variable	Descripción
MAIL_HOST	Servidor SMTP (ej. smtp.gmail.com)
MAIL_PORT	Puerto SMTP (generalmente 465 o 587)
MAIL_FROM	Correo emisor por defecto
MAIL_PASSWORD	Contraseña o token de la cuenta emisor

✉️ Ejemplo Básico de Uso

import { Mail } from 'meily';
import { env } from 'arrowy-env';

Mail.from('[e-mail]')
  .to('[e-mail]')
  .subject('Asunto del correo')
  .content('<h1>Hola, este es un correo de prueba</h1>')
  .send();

🛠️ Envío de plantillas HTML con Datos

Puedes enviar correos utilizando archivos .html:

import { Mail } from 'meily';

await Mail.from('[e-mail]')
    .to('[e-mail]')
    .html('./reporte.html')
    .data({
        empleados: empleados,
        fecha: '2022-01-01'
    })
    .subject('Envío de reporte anual')
    .send();

Mail.from('[e-mail]')
  .to('[e-mail]')
  .cc('[e-mail]')
  .bcc('[e-mail]')
  .subject('Correo con adjunto')
  .content('<p>Se adjunta el documento solicitado.</p>')
  .attachments([
    { filename: 'documento.pdf', path: './ruta/documento.pdf' }
  ])
  .send();

✅ Métodos Disponibles

Método	Descripción
from(emisor)	Define el remitente (aunque se usa MAIL_FROM por defecto)
to(destinatario)	Destinatario del correo
cc(copia)	Copia visible
bcc(copia)	Copia oculta
subject(asunto)	Asunto del correo
content(html)	Contenido HTML directo
html(rutaHtml)	Ruta a plantilla .html para usar con Handlebars
data(objeto)	Datos a inyectar en la plantilla
attachments(archivos)	Adjuntos como array de objetos { filename, path }
send()	Envía el correo

✅ Handlebars disponibles

Variable	Ejemplo	Descripción
asset	{{asset 'img/logo.png'}}	Ruta relativa a la carpeta public

🐞 Manejo de Errores y Respuesta

Por defecto, los errores se lanzan automáticamente y los envíos exitosos se imprimen en consola. Si deseas personalizar este comportamiento:

Mail.from(env('MAIL_FROM'))
  .to('[e-mail]')
  .subject('Correo')
  .content('<p>Prueba</p>')
  .onSuccess(info => console.log('Enviado:', info.response))
  .onError(error => console.error('Error al enviar:', error))
  .send();

📦 Dependencias

nodemailer arrowy-env handlebars fs

📝 Licencia

MIT © 2025 Cristian Guzmán