✨ (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

@ -26,6 +26,11 @@
//!
//! Las pruebas de un mismo binario se ejecutan en paralelo y comparten estos correos: con
//! [`take_to()`] cada prueba recoge sólo los de sus destinatarios, sin llevarse los de otras.
//!
//! Con la *feature* `queue`, los correos de `Email::queue()` sólo llegan aquí cuando se ejecuta el
//! trabajo que vacía la cola. En las pruebas no se ejecuta solo: hay que lanzarlo con
//! `pagetop_cron::run_now("mail.queue")`. Los de [`Email::send_later()`] no esperan al trabajo,
//! pero llegan en segundo plano, como sin la cola.
use pagetop::prelude::*;
@ -85,3 +90,24 @@ pub(crate) fn push(email: Email, envelope_to: Vec<String>, raw: Vec<u8>) {
fn lock() -> MutexGuard<'static, Vec<SentEmail>> {
OUTBOX.lock().unwrap_or_else(PoisonError::into_inner)
}
// Correos completos de la cola de envío pendientes de entregar con este transporte, por su
// identificador en la cola. La cola sólo guarda el mensaje compuesto, y las pruebas necesitan el
// correo completo para consultarlo con `SentEmail::email()`.
#[cfg(feature = "queue")]
static QUEUED: Mutex<Vec<(i32, Email)>> = Mutex::new(Vec::new());
#[cfg(feature = "queue")]
pub(crate) fn hold(id: i32, email: Email) {
QUEUED
.lock()
.unwrap_or_else(PoisonError::into_inner)
.push((id, email));
}
#[cfg(feature = "queue")]
pub(crate) fn release(id: i32) -> Option<Email> {
let mut queued = QUEUED.lock().unwrap_or_else(PoisonError::into_inner);
let index = queued.iter().position(|(queued_id, _)| *queued_id == id)?;
Some(queued.swap_remove(index).1)
}