"""Decode and quality-check face images (no biometric conclusions)."""

from __future__ import annotations

import base64
import logging
from dataclasses import dataclass

import cv2
import numpy as np

logger = logging.getLogger(__name__)


class FaceImageError(Exception):
    def __init__(self, message: str, *, code: str = "invalid_image") -> None:
        self.code = code
        super().__init__(message)


@dataclass
class DecodedImage:
    bgr: np.ndarray
    width: int
    height: int
    byte_size: int
    content_sha256: str


def decode_base64_image(data_b64: str, *, max_bytes: int) -> DecodedImage:
    if not data_b64 or not str(data_b64).strip():
        raise FaceImageError("Empty image payload", code="invalid_image")
    raw = str(data_b64).strip()
    if "," in raw and raw.lower().startswith("data:"):
        raw = raw.split(",", 1)[1]
    try:
        data = base64.b64decode(raw, validate=False)
    except Exception as exc:  # noqa: BLE001
        raise FaceImageError("Invalid base64 image encoding", code="invalid_image") from exc
    if len(data) < 32:
        raise FaceImageError("Image payload too small", code="invalid_image")
    if len(data) > max_bytes:
        raise FaceImageError(
            f"Image exceeds max size ({max_bytes} bytes)",
            code="image_too_large",
        )
    arr = np.frombuffer(data, dtype=np.uint8)
    bgr = cv2.imdecode(arr, cv2.IMREAD_COLOR)
    if bgr is None or bgr.size == 0:
        raise FaceImageError(
            "Could not decode image bytes (corrupt or unsupported format)",
            code="corrupt_image",
        )
    h, w = bgr.shape[:2]
    import hashlib

    digest = hashlib.sha256(data).hexdigest()
    return DecodedImage(
        bgr=bgr,
        width=int(w),
        height=int(h),
        byte_size=len(data),
        content_sha256=digest,
    )


def assess_image_quality(
    bgr: np.ndarray,
    *,
    min_width: int,
    min_height: int,
    min_laplacian_var: float,
    min_brightness: float,
    max_brightness: float,
) -> list[str]:
    """Return quality warnings (empty if OK). Does not prove liveness."""
    warnings: list[str] = []
    h, w = bgr.shape[:2]
    if w < min_width or h < min_height:
        warnings.append(f"Low resolution ({w}x{h}); min {min_width}x{min_height}")
    gray = cv2.cvtColor(bgr, cv2.COLOR_BGR2GRAY)
    lap_var = float(cv2.Laplacian(gray, cv2.CV_64F).var())
    if lap_var < min_laplacian_var:
        warnings.append(f"Image appears blurry (laplacian_var={lap_var:.1f})")
    brightness = float(np.mean(gray))
    if brightness < min_brightness:
        warnings.append(f"Image too dark (mean={brightness:.1f})")
    if brightness > max_brightness:
        warnings.append(f"Image too bright (mean={brightness:.1f})")
    return warnings
