✨ (mail): Marca los correos como automáticos

Por defecto, los correos llevan `Auto-Submitted: auto-generated` (RFC
3834) para no recibir avisos de ausencia; `with_auto_submitted(false)`
la quita en los que escribe una persona. Añade SentEmail::links() para
seguir en las pruebas los enlaces de los correos.
This commit is contained in:
Manuel Cillero 2026-10-31 21:16:44 +01:00
parent 3c6dea9728
commit d7caf724dd
3 changed files with 110 additions and 4 deletions

View file

@ -5,6 +5,7 @@ use pagetop::prelude::*;
use crate::{Attachment, MailError, MailTemplate, Mailbox, layout, text, transport};
use lettre::Message;
use lettre::message::header::{HeaderName, HeaderValue};
use lettre::message::{MultiPart, MultiPartBuilder, SinglePart};
use std::sync::atomic::{AtomicU64, Ordering};
@ -30,6 +31,10 @@ use std::time::{SystemTime, UNIX_EPOCH};
/// Si no se indica el remitente o la dirección de respuesta se usan los de la configuración
/// (`mail.from` y `mail.reply_to`). Las direcciones se validan al enviar.
///
/// Por defecto, los correos llevan la cabecera `Auto-Submitted: auto-generated`: los envía la
/// aplicación, no una persona, así que no deben recibir respuestas automáticas (avisos de
/// ausencia...). Ver [`with_auto_submitted()`](Self::with_auto_submitted).
///
/// # Ejemplo
///
/// ```rust,no_run
@ -74,6 +79,10 @@ pub struct Email {
attachments: Vec<Attachment>,
#[getters(skip)]
langid: Option<&'static LanguageIdentifier>,
/// Si lleva la cabecera `Auto-Submitted: auto-generated` (por defecto, sí).
#[default = true]
#[getters(copy)]
auto_submitted: bool,
}
impl Email {
@ -231,10 +240,11 @@ impl Email {
}
let from = from.to_lettre()?;
let mut builder = Message::builder()
.message_id(Some(message_id(from.email.domain())))
.from(from)
.subject(self.subject.as_str());
let mut builder = Message::builder().message_id(Some(message_id(from.email.domain())));
if self.auto_submitted {
builder = builder.raw_header(auto_submitted_header());
}
builder = builder.from(from).subject(self.subject.as_str());
if let Some(reply_to) = &self.reply_to {
builder = builder.reply_to(reply_to.to_lettre()?);
}
@ -369,6 +379,20 @@ impl Email {
self.langid = Some(language.langid());
self
}
/// Indica si el correo lleva la cabecera `Auto-Submitted: auto-generated` (RFC 3834), que lo
/// marca como enviado por un programa. Por defecto la llevan todos: así los contestadores
/// automáticos que siguen el RFC (avisos de ausencia, de vacaciones...) no responden a la
/// dirección del remitente.
///
/// Quítala (`false`) en los correos que escribe una persona y que deben tratarse como suyos,
/// como los de un formulario de contacto dirigidos a una dirección de soporte: hay sistemas de
/// atención al cliente que suspenden o rechazan los correos marcados como automáticos, para no
/// abrir incidencias con ellos.
pub fn with_auto_submitted(mut self, auto_submitted: bool) -> Self {
self.auto_submitted = auto_submitted;
self
}
}
// Genera la cabecera `Message-ID`, que los filtros de correo no deseado penalizan si falta. Sólo
@ -384,6 +408,14 @@ fn message_id(domain: &str) -> String {
format!("<{nanos:x}.{count:x}.{:x}@{domain}>", std::process::id())
}
// Cabecera `Auto-Submitted: auto-generated` (ver `Email::with_auto_submitted()`).
fn auto_submitted_header() -> HeaderValue {
HeaderValue::new(
HeaderName::new_from_ascii_str("Auto-Submitted"),
"auto-generated".to_owned(),
)
}
// Parte de un mensaje MIME: simple o compuesta por otras partes.
enum Part {
Single(SinglePart),

View file

@ -60,6 +60,41 @@ impl SentEmail {
.iter()
.any(|to| to.eq_ignore_ascii_case(address.trim()))
}
/// Devuelve las direcciones de los enlaces del HTML (atributos `href`), en el orden en que
/// aparecen y ya sin escapar, para seguirlos en las pruebas (p. ej. un enlace de un solo uso).
///
/// Incluye los del diseño común, si los tiene. Lee los atributos tal como los genera `html!`,
/// entre comillas dobles; los de un documento propio escritos de otra forma no se encuentran.
/// Sin HTML devuelve una lista vacía.
pub fn links(&self) -> Vec<String> {
const ATTR: &str = " href=\"";
let Some(html) = self.email.html() else {
return Vec::new();
};
let mut links = Vec::new();
let mut rest = html.as_str();
// Con el espacio delante no coinciden otros atributos que acaban igual (`data-href`).
while let Some(start) = rest.find(ATTR) {
rest = &rest[start + ATTR.len()..];
let Some(end) = rest.find('"') else {
break;
};
links.push(unescape(&rest[..end]));
rest = &rest[end..];
}
links
}
}
// Deshace el escapado de un valor de atributo HTML generado con `html!`.
fn unescape(value: &str) -> String {
value
.replace("&quot;", "\"")
.replace("&lt;", "<")
.replace("&gt;", ">")
.replace("&#39;", "'")
.replace("&amp;", "&")
}
/// Recoge todos los correos guardados, en el orden en que se enviaron.