"""
Send email via SendGrid API. Used for invite links and OTP verification.
"""
import os
import logging
import html
logger = logging.getLogger(__name__)
NIXON_LOGO_URL = "https://nixonlive.com.au/wp-content/uploads/2023/07/nixon-live-logo.png"
def _sendgrid_available() -> bool:
api_key = os.getenv("SENDGRID_API_KEY", "").strip()
return bool(api_key)
def send_invite_email(to_email: str, invite_link: str, role_name: str) -> bool:
"""Send invite email with set-password link. Returns True if sent."""
if not _sendgrid_available():
logger.warning("SENDGRID_API_KEY not set; skipping invite email to %s", to_email)
return False
from_email = os.getenv("EMAIL_FROM", os.getenv("SENDGRID_FROM", "noreply@nixonstats.info"))
subject = "You're invited to Nixon Performance Dashboard"
safe_role = html.escape(role_name)
html_content = f"""
Invite to Nixon Performance Dashboard
|
You've been invited
You have been invited to join the Nixon Performance Dashboard
|
|
Set your password to get started. This link is valid for 7 days.
Set your password
|
|
If you have any issues signing up, contact the development team.
|
|
"""
return _send(to_email, subject, html_content.strip(), from_email)
def send_reset_password_email(to_email: str, reset_link: str) -> bool:
"""Send password reset email with link to reset-password page. Returns True if sent."""
if not _sendgrid_available():
logger.warning("SENDGRID_API_KEY not set; skipping reset email to %s", to_email)
return False
from_email = os.getenv("EMAIL_FROM", os.getenv("SENDGRID_FROM", "noreply@nixonstats.info"))
subject = "Reset your Nixon Performance Dashboard password"
html_content = f"""
Reset your password
|
|
Reset your password
You requested to reset your password for the Nixon Performance Dashboard
|
|
Click the link below to set a new password. This link is valid for 1 hour.
Reset your password
|
|
If you didn't request this, you can safely ignore this email. Your password will remain unchanged.
If you have any issues, contact the development team.
|
|
"""
return _send(to_email, subject, html_content.strip(), from_email)
def send_otp_email(to_email: str, code: str) -> bool:
"""Send 6-digit OTP for re-verification. Returns True if sent."""
if not _sendgrid_available():
logger.warning("SENDGRID_API_KEY not set; skipping OTP email to %s", to_email)
return False
from_email = os.getenv("EMAIL_FROM", os.getenv("SENDGRID_FROM", "noreply@nixonstats.info"))
subject = "Your Nixon Dashboard verification code"
html = f"""
Your verification code is: {code}
Enter this code in the dashboard to continue. It expires in 10 minutes.
If you didn't request this, you can ignore this email.
"""
return _send(to_email, subject, html, from_email)
def _send(to_email: str, subject: str, html_content: str, from_email: str) -> bool:
try:
from sendgrid import SendGridAPIClient
from sendgrid.helpers.mail import Mail
message = Mail(
from_email=from_email,
to_emails=to_email,
subject=subject,
html_content=html_content,
)
sg = SendGridAPIClient(os.getenv("SENDGRID_API_KEY"))
sg.send(message)
logger.info("Email sent to %s: %s", to_email, subject)
return True
except Exception as e:
logger.exception("SendGrid send failed to %s: %s", to_email, e)
return False