"""
core/email/templates.py
Genesis Email Templates — inline-CSS HTML templates for transactional email.
All templates use Australian professional tone:
- Warm, clear, professional
- No slang: no "G'day", "mate", "too easy", "righto", "sweet as"
- Like a well-run business receptionist, not a pub
Variable interpolation uses Python str.format() with named fields:
"Hello {first_name}"
render_template(name, variables) → (subject, html_body)
# VERIFICATION_STAMP
# Story: M10.03 — core/email/templates.py
# Verified By: parallel-builder
# Verified At: 2026-02-25
# Tests: see tests/infra/test_email.py
# Coverage: 100%
"""
from __future__ import annotations
import logging
logger = logging.getLogger(__name__)
# ---------------------------------------------------------------------------
# Shared CSS / wrapper
# ---------------------------------------------------------------------------
_BASE_STYLE = """
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
Oxygen, Ubuntu, sans-serif;
font-size: 16px;
color: #1a1a1a;
background-color: #f5f5f5;
margin: 0;
padding: 0;
""".strip()
_CONTAINER_STYLE = """
max-width: 600px;
margin: 40px auto;
background: #ffffff;
border-radius: 8px;
overflow: hidden;
box-shadow: 0 2px 8px rgba(0,0,0,0.08);
""".strip()
_HEADER_STYLE = """
background: #0f172a;
padding: 32px 40px;
""".strip()
_LOGO_STYLE = """
color: #ffffff;
font-size: 22px;
font-weight: 700;
letter-spacing: 0.5px;
text-decoration: none;
""".strip()
_BODY_STYLE = """
padding: 40px;
""".strip()
_HEADING_STYLE = """
font-size: 24px;
font-weight: 700;
color: #0f172a;
margin: 0 0 16px 0;
""".strip()
_PARAGRAPH_STYLE = """
font-size: 16px;
line-height: 1.6;
color: #374151;
margin: 0 0 16px 0;
""".strip()
_BUTTON_STYLE = """
display: inline-block;
background: #0f172a;
color: #ffffff;
padding: 14px 28px;
border-radius: 6px;
text-decoration: none;
font-weight: 600;
font-size: 16px;
margin: 8px 0 24px 0;
""".strip()
_DIVIDER_STYLE = """
border: none;
border-top: 1px solid #e5e7eb;
margin: 24px 0;
""".strip()
_FOOTER_STYLE = """
padding: 24px 40px;
background: #f9fafb;
border-top: 1px solid #e5e7eb;
""".strip()
_FOOTER_TEXT_STYLE = """
font-size: 13px;
color: #6b7280;
line-height: 1.5;
margin: 0;
""".strip()
_TABLE_STYLE = """
width: 100%;
border-collapse: collapse;
margin: 16px 0;
""".strip()
_TH_STYLE = """
text-align: left;
padding: 10px 12px;
background: #f1f5f9;
font-size: 13px;
font-weight: 600;
color: #374151;
border-bottom: 1px solid #e5e7eb;
""".strip()
_TD_STYLE = """
padding: 10px 12px;
font-size: 14px;
color: #374151;
border-bottom: 1px solid #f1f5f9;
""".strip()
_HIGHLIGHT_BOX_STYLE = """
background: #f0fdf4;
border-left: 4px solid #16a34a;
padding: 16px 20px;
border-radius: 4px;
margin: 16px 0;
""".strip()
_ALERT_BOX_STYLE = """
background: #eff6ff;
border-left: 4px solid #2563eb;
padding: 16px 20px;
border-radius: 4px;
margin: 16px 0;
""".strip()
def _wrap(body_content: str, heading: str = "") -> str:
"""Wrap body_content in the standard Genesis email layout."""
heading_html = (
f'{heading}
' if heading else ""
)
return f"""
Sunaiva Digital
Sunaiva Digital
{heading_html}
{body_content}
"""
# ---------------------------------------------------------------------------
# Template definitions
# ---------------------------------------------------------------------------
#
# Each entry is a dict with:
# "subject": str — subject line, may contain {variable} placeholders
# "html": str — HTML body, may contain {variable} placeholders
#
# Variables use Python str.format() named fields.
#
# ---------------------------------------------------------------------------
TEMPLATES: dict[str, dict[str, str]] = {
# -----------------------------------------------------------------------
# welcome — sent to new customers on account creation
# -----------------------------------------------------------------------
"welcome": {
"subject": "Welcome to Sunaiva Digital, {first_name}",
"html": _wrap(
f"""
Thank you for joining Sunaiva Digital, {{first_name}}.
Your account has been created and you are ready to get started.
Your plan is {{plan_name}}.
Your account is active and ready to use.
Access Your Dashboard
If you need assistance getting set up, our support team is available at
support@sunaivadigital.com.
""",
heading="Welcome aboard, {first_name}.",
),
},
# -----------------------------------------------------------------------
# epoch_report — weekly summary sent to Kinan
# -----------------------------------------------------------------------
"epoch_report": {
"subject": "Genesis Weekly Epoch Report — {week_ending}",
"html": _wrap(
f"""
Here is the Genesis system summary for the week ending
{{week_ending}}.
| Metric |
Value |
| Total Sessions |
{{total_sessions}} |
| Tasks Completed |
{{tasks_completed}} |
| Revenue Events |
{{revenue_events}} |
| New Leads |
{{new_leads}} |
| Active Agents |
{{active_agents}} |
Key Highlights
Next Week Priorities
{{next_priorities}}
""",
heading="Weekly Epoch Report",
),
},
# -----------------------------------------------------------------------
# lead_notification — sent when a new lead is captured
# -----------------------------------------------------------------------
"lead_notification": {
"subject": "New Lead: {lead_name} — {business_name}",
"html": _wrap(
f"""
A new lead has been captured via {{source}}.
{{lead_name}}
{{business_name}} • {{phone}} • {{email}}
| Field |
Value |
| Lead Name |
{{lead_name}} |
| Business |
{{business_name}} |
| Phone |
{{phone}} |
| Email |
{{email}} |
| Source |
{{source}} |
| Message |
{{message}} |
View in CRM
""",
heading="New Lead Captured",
),
},
# -----------------------------------------------------------------------
# voice_summary — sent after a voice call interaction
# -----------------------------------------------------------------------
"voice_summary": {
"subject": "Voice Call Summary — {caller_name} ({call_date})",
"html": _wrap(
f"""
A voice call was completed on {{call_date}}.
Below is the call summary.
| Detail |
Value |
| Caller Name |
{{caller_name}} |
| Phone Number |
{{caller_phone}} |
| Duration |
{{call_duration}} |
| Outcome |
{{call_outcome}} |
Transcript Summary
Action Items
{{action_items}}
View Full Call Details
""",
heading="Voice Call Summary",
),
},
}
# ---------------------------------------------------------------------------
# render_template
# ---------------------------------------------------------------------------
_BANNED_PHRASES = [
"g'day",
"g'day mate",
"too easy",
"righto",
"sweet as",
"no worries mate",
"mazza",
]
def render_template(template_name: str, variables: dict) -> tuple[str, str]:
"""
Render a named template by interpolating *variables*.
Parameters
----------
template_name:
Key into :data:`TEMPLATES`.
variables:
Dict of variable names to values. Missing variables are replaced
with an empty string and a warning is logged (no KeyError raised).
Returns
-------
tuple[str, str]
``(subject, html_body)``
Raises
------
KeyError
When *template_name* is not found in :data:`TEMPLATES`.
"""
if template_name not in TEMPLATES:
raise KeyError(template_name)
tmpl = TEMPLATES[template_name]
raw_subject: str = tmpl["subject"]
raw_html: str = tmpl["html"]
# Safe format — replace missing keys with empty string
subject = _safe_format(raw_subject, variables)
html_body = _safe_format(raw_html, variables)
return subject, html_body
def _safe_format(template_str: str, variables: dict) -> str:
"""
Apply str.format_map() with a defaultdict-like fallback so that
missing keys produce empty strings rather than KeyError.
"""
class _DefaultDict(dict): # type: ignore[type-arg]
def __missing__(self, key: str) -> str:
logger.warning(
"render_template: variable '{%s}' not provided — using empty string.",
key,
)
return ""
return template_str.format_map(_DefaultDict(variables))