# ============================================================
# ADDITIVE: shared helpers for the platform panel views
# ============================================================

import logging
from functools import wraps

from django.contrib import messages
from django.core.paginator import Paginator
from django.shortcuts import redirect

from .models import SuperAdminAuditLog
from .platform_permissions import has_platform_permission
from .views import superadmin_required

logger = logging.getLogger(__name__)


def client_ip(request):
    fwd = request.META.get("HTTP_X_FORWARDED_FOR")
    if fwd:
        return fwd.split(",")[0].strip()
    return request.META.get("REMOTE_ADDR")


def actor_label(request):
    p = request.superadmin_profile
    return f"superadmin:{p.pk}"


def platform_permission_required(code):
    """Session login + active SuperAdminProfile + role permission."""
    def deco(view):
        @wraps(view)
        def inner(request, *args, **kwargs):
            if not has_platform_permission(request.user, code):
                messages.error(request, "You do not have permission for that action.")
                return redirect("superadmin_profile")
            return view(request, *args, **kwargs)
        return superadmin_required(inner)
    return deco


def write_audit(request, action, company=None, description=""):
    """Unlike older call sites this passes the SuperAdminProfile and logs failures."""
    try:
        SuperAdminAuditLog.objects.create(
            superadmin=request.superadmin_profile,
            company=company,
            action=action,
            description=(description or "")[:2000],
            ip_address=client_ip(request),
            created_by=actor_label(request),
        )
    except Exception:
        logger.exception("SuperAdmin audit log write failed (%s)", action)


def paginate(request, qs, per_page=20):
    page = Paginator(qs, per_page).get_page(request.GET.get("page"))
    params = request.GET.copy()
    params.pop("page", None)
    return page, params.urlencode()
