From a231913ab273f427697f2d27d615b495f6e160bb Mon Sep 17 00:00:00 2001 From: Dennis Fink Date: Sun, 25 Oct 2026 20:47:14 +0100 Subject: feat(receiver): add email notifications for new webmentions Send an email after a newly received Webmention is successfully verified, with SMTP delivery configurable through Flask-Mail. Avoid notifications for resubmissions and manual reverification, and keep the persisted verification result unchanged if notification enqueueing fails. --- webmentions_ssg/tasks/notifications.py | 36 ++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 webmentions_ssg/tasks/notifications.py (limited to 'webmentions_ssg/tasks/notifications.py') diff --git a/webmentions_ssg/tasks/notifications.py b/webmentions_ssg/tasks/notifications.py new file mode 100644 index 0000000..473216b --- /dev/null +++ b/webmentions_ssg/tasks/notifications.py @@ -0,0 +1,36 @@ +# SPDX-FileCopyrightText: 2026 Dennis Fink +# +# SPDX-License-Identifier: BSD-3-Clause + +import uuid + +from flask import current_app +from flask_mail import Message + +from .. import DATABASE as db +from .. import HUEY as huey +from .. import MAIL as mail +from ..models import ReceivedWebmention + + +@huey.task(retries=2, retry_delay=60) +def send_webmention_notification(webmention_uuid: uuid.UUID) -> None: + """Send an email when a received webmention has been verified.""" + recipient = current_app.config.get("WEBMENTIONS_SSG_NOTIFICATION_EMAIL") + if not recipient: + return + + webmention = db.session.get(ReceivedWebmention, webmention_uuid) + if webmention is None or webmention.status != "verified": + return + + message = Message( + subject="New verified webmention", + recipients=[recipient], + body=( + "A received webmention has been verified.\n\n" + f"Source: {webmention.source}\n" + f"Target: {webmention.target}\n" + ), + ) + mail.send(message) -- cgit v1.3.1