@mostajs/mailer
v0.1.1
Published
Generic mail dispatcher for @mostajs — driver-based (SMTP, Resend, Postmark, SES, Brevo, Mock, Console), MailLog persistence, idempotence, RGPD audit.
Maintainers
Readme
@mostajs/mailer
Module générique d'envoi d'emails — driver-based (SMTP, Resend, Postmark, SES, Brevo, Mock, Console), MailLog persistant via
@mostajs/orm, idempotence, audit RGPD via@mostajs/audit.
Auteur : Dr Hamid MADANI [email protected] Statut : Design en cours (2026-05-06)
Pré-requis architecturaux
- Persistance via
@mostajs/orm(tableMailLog) - Env via
@mostajs/config(getEnvcascadeMOSTA_ENV) - Audit via
@mostajs/audit(opt-in) - Drivers SMTP : nodemailer en peer dep optionnelle
Documents
| Doc | Contenu |
|-----|---------|
| docs/01-ETAT-ART.md | Comparatif nodemailer / Resend / Postmark / SES / Brevo + features cumulées |
| docs/02-AUDIT.md | Besoins, consumers identifiés, API publique cible |
| docs/03-PLAN-DEV.md | Architecture driver pattern, schémas, phases livraison |
| docs/04-PLAN-TEST.md | Pyramide tests + deliverability + RGPD |
Vision
@mostajs/mailer est l'abstraction unifiante de l'envoi d'emails dans
l'écosystème @mostajs/*. Il ne réimplémente pas SMTP — il consomme les
meilleures libs (nodemailer, SDKs ESP) via un pattern driver, et ajoute
ce que ces libs n'ont pas :
- Persistance
MailLog(audit + idempotence parmessageId) - Hook
@mostajs/audit(traçabilité RGPD) - Mock driver natif pour tests reproductibles
- API stable consommée par
@mostajs/auth,@mostajs/questa, et tout autre module ou app applicative
Consumers
@mostajs/auth/magic-link(remplace l'inline nodemailer actuel)@mostajs/questa(notifications admin sur soumission)- Toute app (
octocloud,orphin, futures)
