# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause """Authenticated incoming and outgoing Webmention management.""" import uuid import sqlalchemy as sa from flask import abort, flash, redirect, render_template, request, url_for from flask.typing import ResponseReturnValue from flask_login import login_required from sqlalchemy.orm import selectinload from .. import forms from ..extensions import db from ..models import ReceivedWebmention, SentWebmention, Source from ..tasks.receiver import verify_webmention from ..tasks.scanner import manual_scan_sources from ..tasks.sender import send_webmention from .blueprint import root_page def validate_admin_action() -> None: """Reject invalid administrative action forms with HTTP 400. Abort the request when the posted form does not pass CSRF or other validation. """ if not forms.AdminActionForm().validate_on_submit(): abort(400) @root_page.route("/received") @login_required def received() -> ResponseReturnValue: """Display received Webmentions. :returns: Rendered page containing the paginated received Webmentions. """ webmentions = db.paginate( sa.select(ReceivedWebmention).order_by(ReceivedWebmention.uuid.desc()), per_page=25, ) return render_template( "received.html", title="Received Webmentions", webmentions=webmentions, action_form=forms.AdminActionForm(), ) @root_page.post("/received//delete") @login_required def delete_received_webmention(identifier: uuid.UUID) -> ResponseReturnValue: """Delete a received Webmention. :param identifier: Identifier of the Webmention to delete. :returns: Redirect response to the received Webmentions view. """ validate_admin_action() webmention = db.get_or_404(ReceivedWebmention, identifier) db.session.delete(webmention) db.session.commit() flash(f"Webmention {webmention.uuid} deleted.", "success") return redirect( url_for("root.received", page=request.args.get("page", 1, type=int)) ) @root_page.post("/received//reverify") @login_required def reverify_received_webmention(identifier: uuid.UUID) -> ResponseReturnValue: """Queue a received Webmention for reverification. The Webmention status is reset before a new verification task is queued. :param identifier: Identifier of the Webmention to reverify. :returns: Redirect response to the received Webmentions view. """ validate_admin_action() webmention = db.get_or_404(ReceivedWebmention, identifier) webmention.reset_for_verification() db.session.commit() verify_webmention(identifier) flash(f"Webmention {webmention.uuid} queued for reverification.", "success") return redirect( url_for("root.received", page=request.args.get("page", 1, type=int)) ) @root_page.route("/sent") @login_required def sent() -> ResponseReturnValue: """Display sources with sent Webmentions. :returns: Rendered page containing the paginated source list. """ sources = db.paginate( sa.select(Source) .options(selectinload(Source.sent_webmentions)) .order_by(Source.last_seen_at.desc()), per_page=25, ) return render_template( "sent.html", title="Sent Webmentions", sources=sources, action_form=forms.AdminActionForm(), ) @root_page.post("/sent/rescan") @login_required def rescan_sent_sources() -> ResponseReturnValue: """Queue a manual scan of sent Webmention sources. :returns: Redirect response to the sent Webmentions view. """ validate_admin_action() manual_scan_sources() flash("Source rescan queued.", "success") return redirect(url_for("root.sent")) @root_page.route("/sent/") @login_required def sent_source(source_identifier: uuid.UUID) -> ResponseReturnValue: """Display the sent Webmentions associated with a source. :param source_identifier: Identifier of the source to display. :returns: Rendered source details page. """ source = db.get_or_404(Source, source_identifier) webmentions = db.paginate( sa.select(SentWebmention) .where(SentWebmention.source_id == source.uuid) .order_by(SentWebmention.target, SentWebmention.uuid), per_page=25, ) return render_template( "sent_source.html", title="Sent Webmentions", source=source, webmentions=webmentions, action_form=forms.AdminActionForm(), ) @root_page.post("/sent///resend") @login_required def resend_sent_webmention( source_identifier: uuid.UUID, webmention_identifier: uuid.UUID ) -> ResponseReturnValue: """Queue an outgoing Webmention to be sent again. The current desired source revision is reopened for processing so the sender task does not treat the Webmention as already completed. Historical successful-send fields are preserved, while result fields from the previous attempt are cleared. :param source_identifier: Identifier of the source owning the Webmention. :param webmention_identifier: Identifier of the sent Webmention to resend. :returns: Redirect response to the source details view. """ validate_admin_action() webmention = db.get_or_404(SentWebmention, webmention_identifier) if webmention.source_id != source_identifier: abort(404) # Requeue the existing desired revision instead of inventing a new source # revision. send_webmention() otherwise exits when this revision has already # been processed. webmention.resend() db.session.commit() send_webmention(webmention_identifier) flash(f"Webmention {webmention.uuid} queued for resend.", "success") return redirect(url_for("root.sent_source", source_identifier=source_identifier))