""" E-postutsending for TeeCup. I dag kun magic-link-innlogging. Egne, uavhengige SMTP-credentials fra teeoff (ADR-009) -- se .env (TEECUP_SMTP_SERVER/PORT/USER/PASS, TEECUP_FROM_EMAIL). `smtplib` er synkron, så selve sendingen kjøres i en tråd (asyncio.to_thread) for ikke å blokkere event loop-en -- samme mønster som teeoffs egen, fungerende magic-link-utsending. Håndterer BEGGE vanlige SMTP-tilkoblingsmåter siden porten ikke er antatt på forhånd: implisitt TLS (SMTP_SSL, typisk port 465) eller STARTTLS på en vanlig tilkobling (typisk port 587/25). """ import smtplib from asyncio import to_thread from email.message import EmailMessage from .config import settings def _send_sync(to_email: str, subject: str, body: str) -> None: msg = EmailMessage() msg["Subject"] = subject msg["From"] = settings.FROM_EMAIL msg["To"] = to_email msg.set_content(body) if settings.SMTP_PORT == 465: with smtplib.SMTP_SSL(settings.SMTP_SERVER, settings.SMTP_PORT) as smtp: smtp.login(settings.SMTP_USER, settings.SMTP_PASS) smtp.send_message(msg) else: with smtplib.SMTP(settings.SMTP_SERVER, settings.SMTP_PORT) as smtp: smtp.starttls() smtp.login(settings.SMTP_USER, settings.SMTP_PASS) smtp.send_message(msg) _TEMPLATES = { "nb": { "subject": "Logg inn på TeeCup", "body": ( "Hei,\n\n" "Åpne denne lenken for å logge inn på TeeCup innen {minutes} minutter:\n\n" "{link}\n\n" "Fungerer ikke lenken? Lim inn denne koden manuelt i stedet:\n" "{token}\n\n" "Ba du ikke om dette, kan du se bort fra e-posten.\n" ), }, "en": { "subject": "Log in to TeeCup", "body": ( "Hi,\n\n" "Open this link to log in to TeeCup within {minutes} minutes:\n\n" "{link}\n\n" "Link not working? Paste this code in manually instead:\n" "{token}\n\n" "If you didn't request this, you can ignore this email.\n" ), }, } async def send_magic_link_email(to_email: str, raw_token: str, locale: str = "nb") -> None: """Sender en klikkbar innloggingslenke (pluss selve koden som fallback). `locale` valideres allerede av Pydantic (Literal["nb","en"]) på vei inn i routeren, men faller trygt tilbake til "nb" her også hvis den skulle komme fra et annet kall uten den garantien. """ template = _TEMPLATES.get(locale, _TEMPLATES["nb"]) subject = template["subject"] link = f"{settings.PUBLIC_BASE_URL}/verify?token={raw_token}" body = template["body"].format( minutes=settings.MAGIC_LINK_MAX_AGE_MINUTES, token=raw_token, link=link ) await to_thread(_send_sync, to_email, subject, body) _TWO_FACTOR_TEMPLATES = { "nb": { "subject": "Din engangskode for TeeCup", "body": ( "Hei,\n\n" "Engangskoden din er: {code}\n\n" "Den er gyldig i 5 minutter. Ba du ikke om dette, kan du se bort fra e-posten.\n" ), }, "en": { "subject": "Your TeeCup one-time code", "body": ( "Hi,\n\n" "Your one-time code is: {code}\n\n" "It is valid for 5 minutes. If you didn't request this, you can ignore this email.\n" ), }, } async def send_two_factor_code_email(to_email: str, code: str, locale: str = "nb") -> None: """ADR-021 Beslutning C: e-post-2FA-engangskode. Samme leveringsmønster som magic-link (smtplib i egen tråd).""" template = _TWO_FACTOR_TEMPLATES.get(locale, _TWO_FACTOR_TEMPLATES["nb"]) body = template["body"].format(code=code) await to_thread(_send_sync, to_email, template["subject"], body) _INVITATION_TEMPLATES = { "nb": { "subject": "Du er invitert til {org} på TeeCup", "body": ( "Hei,\n\n" "{inviter} har invitert deg til å bli {role} i {org} på TeeCup.\n\n" "Logg inn med denne e-postadressen på {link} for å godta invitasjonen " "-- den kobles automatisk til kontoen din ved innlogging.\n" ), }, "en": { "subject": "You're invited to {org} on TeeCup", "body": ( "Hi,\n\n" "{inviter} has invited you to become {role} of {org} on TeeCup.\n\n" "Log in with this email address at {link} to accept the invitation " "-- it's linked to your account automatically on login.\n" ), }, } _ROLE_LABELS_NB = {"owner": "eier", "admin": "administrator", "member": "medlem"} _ROLE_LABELS_EN = {"owner": "an owner", "admin": "an administrator", "member": "a member"} async def send_organization_invitation_email( to_email: str, org_name: str, role: str, inviter_name: str, locale: str = "nb" ) -> None: """ADR-022 Beslutning B: ingen klikkbar aksept-lenke -- invitasjonen godtas automatisk ved neste innlogging med matchende e-post (samme mønster som spiller-e-post-kobling, ADR-017).""" template = _INVITATION_TEMPLATES.get(locale, _INVITATION_TEMPLATES["nb"]) role_label = (_ROLE_LABELS_NB if locale == "nb" else _ROLE_LABELS_EN).get(role, role) subject = template["subject"].format(org=org_name) body = template["body"].format( inviter=inviter_name, role=role_label, org=org_name, link=settings.PUBLIC_BASE_URL ) await to_thread(_send_sync, to_email, subject, body) _EMAIL_CHANGE_TEMPLATES = { "nb": { "subject": "Bekreft ny e-postadresse for TeeCup", "body": ( "Hei,\n\n" "Noen ba om å endre TeeCup-kontoens e-postadresse til denne adressen. " "Åpne lenken under innen {minutes} minutter for å bekrefte:\n\n" "{link}\n\n" "Ba du ikke om dette selv, kan du se bort fra e-posten -- ingenting " "endres uten at lenken åpnes.\n" ), }, "en": { "subject": "Confirm your new TeeCup email address", "body": ( "Hi,\n\n" "Someone requested changing this TeeCup account's email address to this " "address. Open the link below within {minutes} minutes to confirm:\n\n" "{link}\n\n" "If you didn't request this yourself, you can ignore this email -- " "nothing changes unless the link is opened.\n" ), }, } async def send_email_change_confirmation(to_email: str, raw_token: str, locale: str = "nb") -> None: """ADR-031-oppfølging: e-post er innloggings-identifikatoren, kan derfor ikke endres med en enkel PATCH -- den NYE adressen må bevise eierskap FØR selve kontoen endres. Samme token-i-lenke-mønster som magic-link.""" template = _EMAIL_CHANGE_TEMPLATES.get(locale, _EMAIL_CHANGE_TEMPLATES["nb"]) link = f"{settings.PUBLIC_BASE_URL}/verify-email?token={raw_token}" body = template["body"].format(minutes=settings.MAGIC_LINK_MAX_AGE_MINUTES, link=link) await to_thread(_send_sync, to_email, template["subject"], body) _SECONDARY_EMAIL_TEMPLATES = { "nb": { "subject": "Bekreft ekstra e-postadresse for TeeCup", "body": ( "Hei,\n\n" "Noen la til denne adressen som en EKSTRA (sekundær) e-postadresse på " "en TeeCup-konto -- kontoens hovedadresse endres IKKE. Åpne lenken " "under innen {minutes} minutter for å bekrefte at du eier denne " "adressen:\n\n" "{link}\n\n" "Ba du ikke om dette selv, kan du se bort fra e-posten -- ingenting " "legges til uten at lenken åpnes.\n" ), }, "en": { "subject": "Confirm an additional TeeCup email address", "body": ( "Hi,\n\n" "Someone added this address as an ADDITIONAL (secondary) email on a " "TeeCup account -- the account's primary address is NOT changed. Open " "the link below within {minutes} minutes to confirm you own this " "address:\n\n" "{link}\n\n" "If you didn't request this yourself, you can ignore this email -- " "nothing is added unless the link is opened.\n" ), }, } async def send_secondary_email_verification(to_email: str, raw_token: str, locale: str = "nb") -> None: """Én person, flere e-postadresser (notert i FEATURE_BACKLOG.md) -- kun det enkle tilfellet (fri, ukrevd adresse). Samme token-i-lenke-mønster som send_email_change_confirmation, egen mal siden budskapet er reelt forskjellig ("legges til" vs. "endres til").""" template = _SECONDARY_EMAIL_TEMPLATES.get(locale, _SECONDARY_EMAIL_TEMPLATES["nb"]) link = f"{settings.PUBLIC_BASE_URL}/verify-email?token={raw_token}&kind=secondary" body = template["body"].format(minutes=settings.MAGIC_LINK_MAX_AGE_MINUTES, link=link) await to_thread(_send_sync, to_email, template["subject"], body) _NOTIFICATION_TEMPLATES = { "nb": { "subject": "Nytt varsel fra TeeCup", "body": ( "Hei,\n\n" "{message}\n\n" "Se det i TeeCup:\n{link}\n\n" "Du får denne e-posten fordi du har valgt å motta e-post for " "denne typen varsler. Du kan endre dette når som helst under " "Konto i TeeCup.\n" ), }, "en": { "subject": "New notification from TeeCup", "body": ( "Hi,\n\n" "{message}\n\n" "View it in TeeCup:\n{link}\n\n" "You're receiving this because you opted in to email for this " "notification type. You can change this anytime under Account " "in TeeCup.\n" ), }, } async def send_notification_email(to_email: str, message: str, link_path: str, locale: str = "nb") -> None: """E-post-fallback for det in-app varslingssenteret (FEATURE_BACKLOG.md, 2026-07-28 oppfølging) -- kun sendt når mottakeren selv har valgt inn for akkurat DENNE varseltypen (`user_notification_email_pref`, migrasjon 033), se `create_notification()` i `app/routers/notifications.py`. `message` er allerede en ferdig, norsk tekst (samme snapshot-prinsipp som selve in-app-varselet) -- kun ramme-teksten (emne/hilsen/lenkeforklaring) er tospråklig her, ikke selve budskapet.""" template = _NOTIFICATION_TEMPLATES.get(locale, _NOTIFICATION_TEMPLATES["nb"]) link = f"{settings.PUBLIC_BASE_URL}{link_path}" body = template["body"].format(message=message, link=link) await to_thread(_send_sync, to_email, template["subject"], body) _SESSION_INVITATION_TEMPLATES = { "nb": { "subject": "Din runde i {tournament} er registrert i TeeCup", "body": ( "Hei {name},\n\n" "{summary}\n\n" "Åpne lenken under innen {minutes} minutter for å logge deg rett inn og se mer, " "eller følge med videre:\n\n" "{link}\n\n" "Fungerer ikke lenken? Lim inn denne koden manuelt i stedet:\n" "{token}\n\n" "Fikk du denne uventet? Arrangøren av turneringen har registrert deg som spiller " "i TeeCup -- se bort fra e-posten hvis dette ikke stemmer.\n" ), }, "en": { "subject": "Your round in {tournament} has been recorded in TeeCup", "body": ( "Hi {name},\n\n" "{summary}\n\n" "Open the link below within {minutes} minutes to log straight in and see more, " "or keep following along:\n\n" "{link}\n\n" "Link not working? Paste this code in manually instead:\n" "{token}\n\n" "Got this unexpectedly? The tournament organizer registered you as a player in " "TeeCup -- ignore this email if that's not right.\n" ), }, } async def send_session_result_email( to_email: str, player_name: str, tournament_name: str, summary: str, raw_token: str, locale: str = "nb" ) -> None: """FEATURE_BACKLOG.md "Midlertidige spillere + automatisk etter-runde- invitasjon" (avklart 2026-07-28, økt-nivå) -- en organisator sender dette til spillere UTEN egen konto ennå (player.user_id IS NULL) etter en økt. `summary` er en allerede ferdig, norsk tekst (samme snapshot- prinsipp som varsel-meldinger) som beskriver matchresultatet -- bygget av kalleren (app/routers/tournaments.py), ikke her. Samme ekte klikkbare magic-link-mønster som send_magic_link_email (ikke bare en "logg inn senere"-henvisning som organisasjonsinvitasjonen, siden dette er en engangs, direkte innloggingslenke).""" template = _SESSION_INVITATION_TEMPLATES.get(locale, _SESSION_INVITATION_TEMPLATES["nb"]) link = f"{settings.PUBLIC_BASE_URL}/verify?token={raw_token}" subject = template["subject"].format(tournament=tournament_name) body = template["body"].format( name=player_name, summary=summary, minutes=settings.MAGIC_LINK_MAX_AGE_MINUTES, link=link, token=raw_token, ) await to_thread(_send_sync, to_email, subject, body) async def send_new_account_alert_email(to_email: str, new_user_email: str, display_name: str) -> None: """Driftsvarsel til appens eier (2026-07-30) hver gang en HELT NY TeeCup-konto opprettes (app/routers/auth.py sin verify_magic_link -- den ENESTE plassen en app_user-rad noensinne settes inn). Alltid norsk -- et internt driftsvarsel til én fast, kjent mottaker, ikke en brukervendt i18n-tekst.""" subject = "Ny TeeCup-konto opprettet" body = ( f"Hei,\n\n" f"En ny konto ble nettopp opprettet i TeeCup:\n\n" f"E-post: {new_user_email}\n" f"Navn: {display_name}\n" ) await to_thread(_send_sync, to_email, subject, body)