Verifica delle email per l'onboarding fintech

import hashlib
import os
from datetime import datetime
from mailbeam import Client
from fastapi import HTTPException

mb = Client(api_key=os.environ["MAILBEAM_KEY"])

async def verify_onboarding_email(
    email: str,
    user_id: str,
    consent_given: bool,
) -> dict:
    if not consent_given:
        raise HTTPException(
            status_code=400,
            detail="È richiesto il consenso GDPR prima di verificare l'email."
        )

    result = verifyEmail(email)

    # Registra l'evento di audit: hash dell'email per minimizzare i dati (GDPR)
    await audit_log.write({
        "event": "email_verification",
        "user_id": user_id,
        "email_sha256": hashlib.sha256(email.lower().encode()).hexdigest(),
        "result": result.status,
        "score": result.score,
        "timestamp": datetime.utcnow().isoformat() + "Z",
        # NOTA: l'email in chiaro NON viene salvata nella pista di audit
    })

    if not result.valid:
        raise HTTPException(
            status_code=422,
            detail={
                "code": "EMAIL_INVALID",
                "message": "Non è possibile raggiungere questo indirizzo email.",
                "suggestion": result.suggestion,
            }
        )

    if result.role:
        raise HTTPException(
            status_code=422,
            detail={
                "code": "ROLE_EMAIL",
                "message": "Usa un indirizzo personale, non una casella condivisa.",
            }
        )

    return {"verified": True, "score": result.score}