"""Web-panel audit logging helper. Never raises into the request path."""

from __future__ import annotations

import logging

from accounts.models import AuditLog, UserRole

logger = logging.getLogger(__name__)


def _actor_role_for(user) -> str:
    if getattr(user, 'is_superuser', False):
        return AuditLog.ActorRole.SUPERADMIN
    try:
        role = user.role.role
    except Exception:
        return AuditLog.ActorRole.OTHER
    if role == UserRole.Role.ADMIN:
        return AuditLog.ActorRole.ADMIN
    if role == UserRole.Role.USER:
        return AuditLog.ActorRole.USER
    return AuditLog.ActorRole.OTHER


def _client_ip(request) -> str | None:
    forwarded = (request.META.get('HTTP_X_FORWARDED_FOR') or '').strip()
    if forwarded:
        return forwarded.split(',')[0].strip() or None
    return request.META.get('REMOTE_ADDR') or None


def log_audit(
    request,
    *,
    action: str,
    module: str,
    summary: str,
    object_type: str = '',
    object_id: str | int = '',
    object_repr: str = '',
    metadata: dict | None = None,
):
    """Persist an audit row. Safe to call from views; failures are swallowed."""
    try:
        user = getattr(request, 'user', None)
        if not user or not getattr(user, 'is_authenticated', False):
            return None
        meta = dict(metadata or {})
        ua = (request.META.get('HTTP_USER_AGENT') or '')[:512]
        path = (getattr(request, 'path', '') or '')[:512]
        return AuditLog.objects.create(
            actor=user,
            actor_email=(user.email or user.get_username() or '')[:254],
            actor_username=(user.get_username() or '')[:150],
            actor_role=_actor_role_for(user),
            action=action,
            module=module,
            object_type=(object_type or '')[:64],
            object_id=str(object_id or '')[:64],
            object_repr=(object_repr or '')[:255],
            summary=summary or '',
            metadata=meta,
            ip_address=_client_ip(request),
            user_agent=ua,
            path=path,
        )
    except Exception:
        logger.exception('Failed to write audit log')
        return None
