"""Text utilities for the Mail plugin.

Extracted from services.py as part of the God-object split (BUG-018 pilot).
Re-exported by ``app.plugins.builtins.mail.services``.
"""

from __future__ import annotations

import re


def extract_email_addresses(text: str) -> list[str]:
    """Extract email addresses from a text string."""
    if not text:
        return []
    return re.findall(r"[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}", text)


def _strip_html(html: str) -> str:
    """Simple HTML to text conversion for plain text fallback."""
    if not html:
        return ""
    # Remove tags
    text = re.sub(r"<[^>]+>", "", html)
    # Replace HTML entities
    text = (
        text.replace("&nbsp;", " ")
        .replace("&amp;", "&")
        .replace("&lt;", "<")
        .replace("&gt;", ">")
        .replace("&quot;", '"')
        .replace("&#39;", "'")
    )
    # Collapse whitespace
    return re.sub(r"\s+", " ", text).strip()