`Dropdown::items()` devuelve `dropdown::Items`, cuyo `render()` sólo
pinta un encabezado si su grupo tiene algún elemento visible, y un
separador sólo entre elementos visibles. Lo aprovecha cualquier tema
que pinte el menú con `items().render()`.
Las rutas se declaran con su acceso en un enum que implementa Endpoint y
se montan con `routes.endpoint()`. Convertidas en Route, `nav::Item`,
`dropdown::Item` y `Button::anchor()` no se muestran a quien no cumple
el acceso, sin repetir el permiso. `to()` rellena el parámetro de la
ruta.
Un envío anónimo a una ruta que sólo admite POST llevaba, tras iniciar
sesión, a un 405 en blanco. Ahora vuelve a la página del Referer, si es
del mismo Host, y avisa de que el envío no se ha guardado.
Las pruebas de los ajustes que sólo usan la API pública pasan de
global.rs y del config.rs de pagetop-cron a `tests/`. En el código sólo
quedan las que prueban algo privado y la de reference.toml.
Una página del panel muestra la configuración del correo, sin las
credenciales, y envía un correo de prueba esperando el resultado,
para comprobar el transporte en producción. Exige el permiso
`mail:send_test`.
pagetop-user deja de depender de pagetop-admin: declara sus páginas
en el panel del núcleo y monta sus rutas con su acceso. Quita las
comprobaciones que repetían el permiso de la ruta y, con la acción
AnonymousDenied, ofrece el inicio de sesión a un usuario anónimo
sin acceso, también en las peticiones HTMX.
El panel pasa al núcleo y pagetop-admin se queda con los ajustes
guardados en la base de datos: DeclareConfigForms, ConfigForm y la
tabla settings. Un campo obligatorio vacío ya no se guarda, y un
fallo al guardar se muestra con los mensajes del núcleo.
- CSRF sin tokens en el núcleo: se rechazan con 403 las peticiones que
cambian estado si el navegador indica otro origen (`Sec-Fetch-Site`, y
`Origin` frente a `Host`), con el criterio de Go. Sin interruptor.
- Nuevo `[server] trusted_origins`, validado y normalizado al arrancar.
- (user): `max_ip_failed_logins` limita por IP los logins fallidos; el
intento se anota antes de Argon2 para que no se salte en paralelo.
- (user): avisos para la página siguiente tras registro, verificación,
restablecimiento de contraseña y cambio de email.
- `flows.rs` ignora las marcas de componentes aplazados al comparar.
- Componentes aplazados: `Component::is_deferred()` deja una marca
`<!-- placeholder ... -->` y `Page::render()` los renderiza al final
del `<body>`, en su sitio. Si no generan nada, la marca se queda.
- `Region` empieza `Content` con un `Messages` aplazado, que recoge
todos los mensajes de la página. Las aplicaciones ya no tienen que
añadirlo.
- `Messages` retira los mensajes que muestra y admite `with_deferred()`.
- `ResponseExt::with_message()` deja mensajes para la página siguiente
en una cookie técnica de vida corta, que sólo se crea si se usa.
- Basic y Bootsier ocultan las regiones vacías con `.region:empty`.
- `max_email_changes` en `email_change_window_secs`: una cuenta no puede
usar el cambio de email para enviar confirmaciones a muchas
direcciones ajenas, aunque reparta las peticiones entre muchas IP.
- El límite por cuenta se aplica al crear el token (`TokenKind::limit()`
para los dos límites): guarda primero y cuenta después, así las
peticiones simultáneas no lo superan; rechazado, el enlace anterior
sigue valiendo. Sustituye a `count_tokens_since()`.
- El cambio de email crea el token antes de guardar la dirección
pendiente, para que un rechazo no anule el cambio en curso.
- Mensaje de `TooManyRequests` genérico, válido para los límites por
cuenta y por IP.
- Límite de solicitudes por dirección IP para registros, recuperaciones
de contraseña y cambios de email (`max_ip_requests`).
- Avisa del cambio de contraseña, propio o de un administrador.
- El email propio se cambia en /user/email con la contraseña actual y no
se aplica hasta confirmarlo desde un enlace ligado a esa dirección.
- Cambiar el email o la contraseña anula los enlaces antiguos, y los
fallos de la contraseña actual cuentan para el bloqueo de la cuenta.
- `Referrer-Policy: no-referrer` en las páginas con token en la URL.
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.
Las variables PAGETOP_<SECCIÓN>__<CLAVE> sobrescriben cualquier ajuste
de los archivos, como última capa de la cascada (p. ej.
PAGETOP_DATABASE__DB_PASS para db_pass de [database]).
- `web::Upload` guarda los archivos de un envío multipart en disco por
trozos, con nombre aleatorio, extensiones y tamaño máximo por archivo.
`receive()` deserializa además los campos de texto con serde_qs.
- `web::Download` sirve un archivo subido con rangos y peticiones
condicionales, inline sólo para tipos pasivos y con nosniff.
- `form::File`, componente para elegir archivos, y soporte en Bootsier.
- Límite del cuerpo según el tipo de contenido: `server.max_body_size`
baja a 2 MiB y el nuevo `upload.max_request_size` (32 MiB) se aplica
sólo a multipart/form-data.
Añade `max_password_resets` (3; 0 = sin límite) y
`password_reset_window_secs` (3600) en [user]. Alcanzado el límite no se
envía el correo y la respuesta es la misma, para no revelar si la cuenta
existe.
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]`.
- Trabajos programados con expresiones cron (croner), `fixed_rate()` y
`fixed_delay()`, declarados con la acción `DeclareCronJobs` y
ajustables por su clave en `[cron.jobs."clave"]`.
- Control de solapamiento, tiempo máximo, zona horaria por trabajo,
ejecución al arrancar y bajo demanda con `run_now()`.
- Modo `external` sin estado, para réplicas y escalado a cero:
`POST /cron` con `Authorization: Bearer`, ventanas alineadas de
`trigger_interval_secs` y respuesta al terminar los trabajos.
- Estado con `jobs()`/`job()`, acción `AfterJobRun` y parada ordenada
con `JobContext::is_stopping()`.
- Envía por correo la recuperación de contraseña y, con
`require_email_verification`, la verificación de cuentas nuevas, que
se confirma con un botón (los escáneres de correo abren los enlaces).
- Nueva política de nombres de usuario (`identity_policy`): sin `@`, sin
distinguir mayúsculas y sin nombres confusables (UTS #39). Email
validado con pagetop-mail.
- Tokens de un solo uso atómicos y ligados al usuario. Los correos a
direcciones sin verificar no incluyen datos elegidos por el usuario.
- Bloqueo por intentos fallidos con su ventana de recuento, y el mismo
tiempo de respuesta exista o no la cuenta. Argon2 en `spawn_blocking`.
- Límites de longitud del nombre visible y de los roles, y botones sólo
con el permiso que exigen. Más correcciones en formularios y búsqueda.
`Extension::initialize()` devuelve `Result<(), BoxError>`; `BoxError` es
un nuevo alias. Si una extensión falla, `prepare()` registra el error
con sus causas, vuelca las trazas, lo repite en stderr y termina con
código 1, sin panic! ni cambiar su firma.
- Nuevo atributo `#[settings]`: valores por defecto en los campos (tipos
comprobados al compilar y documentados); claves desconocidas y valores
no válidos rechazados. Sustituye a `include_config!`, que se elimina.
- `LazySettings<T>::new()` declara los ajustes de una sección, y
`Extension::settings()` los carga al arrancar, en orden; un error de
configuración o una sección reclamada dos veces detiene el arranque.
- Aviso de secciones que no corresponden a ninguna extensión.
- Bootsier: [dev] bootsier_static_dir pasa a [bootsier] static_dir.
- ServeEmbedded envía ETag (del contenido) y `Cache-Control: no-cache`,
y responde 304 sin cuerpo si el recurso no ha cambiado.
- Los archivos servidos desde disco añaden también `no-cache`.
- Nuevo `Extension::configure_static_files()`: sus rutas se montan tras
el middleware y no resuelven la sesión. Movidos los estáticos del
núcleo, Bootsier, Aliner y HTMX.
- La sesión caduca tras un tiempo sin uso, no desde el login, y se
prorroga como mucho cada `write_interval_secs`; la cookie de
"recordarme" se renueva con ella.
- Nueva subsección `[user.session]` con `cookie_name` ("pagetop"),
`secure_cookie`, `idle_secs`, `remember_idle_secs` y
`write_interval_secs`.
Label y Help generan el marcado común de los campos de formulario. La
etiqueta con la marca opcional de obligatorio y el texto de ayuda, con
sus enlaces de accesibilidad.
Nuevo `form:📅:Field` (fecha, hora y fecha y hora) que muestra el
valor en el formato del idioma efectivo (dd/mm/aaaa, mm/dd/yyyy...) y no
con el selector nativo, que sigue el formato del navegador. Contextual
añade `parse_date()`, `parse_time()` y `parse_datetime()` para leer lo
escrito.
Los traits con los que Bootsier añade métodos a componentes del núcleo
pasan de `<Componente>Bootsier` a `<Componente>BsExt`. SelectBootsier
se confundiría con componentes como SelectLanguage.
- Nuevas opciones `app.timezone_regions`, `app.timezone_order` y
`app.timezone_per_user` para limitar y ordenar las regiones ofrecidas
y decidir si cada usuario puede tener su propia zona horaria.
- Añade `TzRegion` y `TimezoneOrder`; `Timezone::supported_by_region()`
devuelve ahora `TzRegion` y excluye los alias de la base IANA que
repiten otra zona (tzdata 2025b).
- Añade `Timezone::is_supported_in()` para validar con otras regiones.
- `SelectTimezone` admite `with_regions()`, `with_order()` y
`with_utc_offset()`, muestra nombres legibles y conserva la zona
actual aunque ya no se ofrezca.
- `app.timezone` se resuelve sin distinguir mayúsculas.
- pagetop-user no ofrece idioma ni zona horaria si no se aplican y
conserva lo guardado; acepta la zona actual aunque ya no se ofrezca.