La vérification d'e-mails pour 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="Consentement RGPD requis avant la vérification de l'e-mail."
        )
    result = verifyEmail(email)
    # Écriture de l'événement d'audit — e-mail haché pour la minimisation RGPD
    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",
        # NOTE : l'e-mail brut n'est PAS stocké dans le journal d'audit
    })
    if not result.valid:
        raise HTTPException(
            status_code=422,
            detail={
                "code": "EMAIL_INVALID",
                "message": "Cette adresse e-mail n'est pas joignable.",
                "suggestion": result.suggestion,
            }
        )
    if result.role:
        raise HTTPException(
            status_code=422,
            detail={
                "code": "ROLE_EMAIL",
                "message": "Utilisez une adresse personnelle, pas une boîte partagée.",
            }
        )
    return {"verified": True, "score": result.score}