Files
upbeatBytes/goodnews/email_send.py
T
thejayman77 427210ac3e User feedback + expanded privacy-respecting admin stats
Feedback:
- feedback table; POST /api/feedback (anonymous-ok, optional category/email,
  honeypot + per-day flood cap) stores + emails the admin; GET /api/admin/feedback.
- Shared feedback store + FeedbackModal; a speech-bubble opens it from the desktop
  header, the mobile top bar (logo moves left), the footer, and /account. Feedback
  section in /admin.

Stats (additive, same privacy model — no IP/UA/referrer/raw terms):
- Event vocab: summary_viewed (fired on /a load), full_story (card → source),
  not_today/less_like_this/hide_topic, replace_used/replace_none, paywall_replace,
  paywalled_source_open. Card title/image opens /a (no double-count); history
  records via keepalive so it survives the nav.
- Dashboard: Accounts card (counts only), reading funnel (summary→source rate),
  emotional-mix & friction, paywall, returning-visitor buckets. (Health metrics
  deferred to a future monitoring dashboard.) 131 tests pass.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-05 12:58:49 +00:00

88 lines
3.1 KiB
Python

"""Minimal transactional email over SMTP (magic-link sign-in).
Config comes from the environment (GOODNEWS_SMTP_*), supplied to the API
container via its env_file. STARTTLS submission; plain-text with a simple HTML
alternative. No third-party email API — just the configured relay.
"""
from __future__ import annotations
import os
import smtplib
import ssl
from email.message import EmailMessage
from html import escape
def smtp_configured() -> bool:
return bool(os.environ.get("GOODNEWS_SMTP_HOST"))
def _cfg() -> dict:
return {
"host": os.environ.get("GOODNEWS_SMTP_HOST", ""),
"port": int(os.environ.get("GOODNEWS_SMTP_PORT", "587")),
"user": os.environ.get("GOODNEWS_SMTP_USER", ""),
"password": os.environ.get("GOODNEWS_SMTP_PASSWORD", ""),
"sender": os.environ.get("GOODNEWS_SMTP_FROM", "Upbeat Bytes <hello@upbeatbytes.com>"),
}
def send_email(to: str, subject: str, text: str, html: str | None = None) -> None:
"""Send one message. Raises on failure (caller decides how loud to be)."""
cfg = _cfg()
if not cfg["host"]:
raise RuntimeError("SMTP not configured (set GOODNEWS_SMTP_HOST)")
msg = EmailMessage()
msg["From"] = cfg["sender"]
msg["To"] = to
msg["Subject"] = subject
msg.set_content(text)
if html:
msg.add_alternative(html, subtype="html")
context = ssl.create_default_context()
with smtplib.SMTP(cfg["host"], cfg["port"], timeout=20) as server:
server.ehlo()
server.starttls(context=context)
server.ehlo()
if cfg["user"]:
server.login(cfg["user"], cfg["password"])
server.send_message(msg)
def send_feedback(to: str, category: str, message: str, contact: str | None, who: str) -> None:
"""Notify the admin of new user feedback (plain text is plenty here)."""
subject = f"Upbeat Bytes feedback · {category}"
reply = contact or "(none given)"
text = (
f"New feedback ({category})\n"
f"From: {who}\n"
f"Reply to: {reply}\n\n"
f"{message}\n"
)
send_email(to, subject, text)
def send_magic_link(to: str, link: str) -> None:
"""Send a calm, single-purpose sign-in email."""
subject = "Your Upbeat Bytes sign-in link"
text = (
"Welcome back to Upbeat Bytes.\n\n"
f"Tap to sign in:\n{link}\n\n"
"This link works once and expires in 15 minutes.\n"
"If you didn't request it, you can safely ignore this email."
)
safe = escape(link, quote=True)
html = (
'<div style="font-family:-apple-system,Segoe UI,Roboto,Helvetica,Arial,sans-serif;'
'color:#16263a;line-height:1.6">'
"<p>Welcome back to <strong>Upbeat Bytes</strong>.</p>"
f'<p><a href="{safe}" style="display:inline-block;background:#0083ad;color:#fff;'
'text-decoration:none;padding:11px 20px;border-radius:999px;font-weight:600">'
"Sign in</a></p>"
'<p style="color:#5d6b78;font-size:14px">This link works once and expires in 15 minutes. '
"If you didn't request it, you can safely ignore this email.</p>"
"</div>"
)
send_email(to, subject, text, html)