Package Exports

@mostajs/mailer
@mostajs/mailer/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@mostajs/mailer) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

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 drmdh@msn.com Statut : Design en cours (2026-05-06)

Pré-requis architecturaux

Persistance via @mostajs/orm (table MailLog)
Env via @mostajs/config (getEnv cascade MOSTA_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 par messageId)
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)