✨ (mail): Añade cola de envío persistente

Nueva feature `queue`, con `pagetop-seaorm` y `pagetop-cron`: los
correos se guardan ya compuestos en la tabla `mail_queue` y el trabajo
`mail.queue` los envía por lotes, con reintentos de espera creciente y
reserva por fila para varias instancias (entrega «al menos una vez»).

- `Email::queue()` sólo guarda el correo; `send_later()` lo guarda y lo
  intenta enseguida, o lo deja para el lote si hay demasiados en espera.
- SMTP con el transporte síncrono de `lettre` en `spawn_blocking`, con
  `timeout_secs` en cada lectura y escritura del socket.
- Turnos de envío y límites configurables para todos los transportes:
  envíos simultáneos, correos en espera, tiempo máximo de entrega y
  espera máxima entre intentos, validados al arrancar.
- Nuevos errores `Timeout`, `Overloaded`, `Interrupted`, `OutOfRange` y
  `Queue`; `MailError` pasa a ser `#[non_exhaustive]`.
This commit is contained in:
Manuel Cillero 2026-10-31 00:49:46 +01:00
parent 86d9f0e213
commit 4c8eee3585
18 changed files with 1488 additions and 60 deletions

View file

@ -15,8 +15,18 @@ rust-version.workspace = true
license.workspace = true
authors.workspace = true
[package.metadata.docs.rs]
# Documenta también la API de la cola de envío (`Email::queue()`, `MailError::Queue`).
features = ["queue"]
[features]
# Cola de envío persistente en la base de datos, con reintentos y envío por lotes.
queue = ["dep:pagetop-cron", "dep:pagetop-seaorm"]
[dependencies]
pagetop.workspace = true
pagetop-cron = { workspace = true, optional = true }
pagetop-seaorm = { workspace = true, optional = true }
mime_guess.workspace = true
serde.workspace = true
thiserror.workspace = true
@ -33,3 +43,10 @@ features = [
"file-transport",
"tokio1-native-tls",
]
[dev-dependencies]
pagetop-seaorm = { workspace = true, features = ["sqlite"] }
[[test]]
name = "queue"
required-features = ["queue"]