# ============================================================
# 10. EMPLOYEE LETTERS   /api/people/letters/
# Appointment | Confirmation | Promotion | Relieving & Experience
# ============================================================
from django.http import FileResponse, Http404
from rest_framework.decorators import action
from rest_framework.views import APIView

from .common import CrudBase, PeopleAuthMixin, emp_brief, emp_by_code, err, iso, ok
from .letters import TEMPLATES, _Safe, build_variables, issue_letter, render_pdf
from .models import EmployeeLetter

CARDS = {
    "APPOINTMENT": ("Appointment Letter", "Official job appointment with salary annexure."),
    "CONFIRMATION": ("Confirmation Letter", "Probation completion and permanent status certificate."),
    "PROMOTION": ("Promotion Letter", "Designation upgrade and revised CTC structure."),
    "RELIEVING_EXPERIENCE": ("Relieving & Experience", "Service certificate and formal relieving statement."),
}


def letter_row(l, request=None, with_body=False):
    row = {"id": l.id, "letter_no": l.letter_no, "letter_type": l.letter_type,
           "letter_type_label": dict(EmployeeLetter.TYPES).get(l.letter_type), "employee": emp_brief(l.employee),
           "subject": l.subject, "status": l.status, "issued_on": iso(l.issued_on), "issued_by": l.issued_by,
           "pdf_url": (request.build_absolute_uri(l.pdf_file.url) if request and l.pdf_file else None),
           "download_url": f"/api/people/letters/{l.id}/download/"}
    if with_body:
        row.update(body=l.body, variables=l.variables)
    return row


class LetterViewSet(CrudBase):
    """
    GET  /api/people/letters/types/                 the 4 cards of the Issuance Center
    GET  /api/people/letters/                       ?employee=<code> ?letter_type= ?status= ?search=
    POST /api/people/letters/generate/              {employee_code, letter_type, variables?{}, subject?, body?}
    POST /api/people/letters/preview/               same payload, nothing saved
    GET  /api/people/letters/<id>/                  detail incl. body
    GET  /api/people/letters/<id>/download/         PDF file (send the Bearer token)
    POST /api/people/letters/<id>/update/           {subject?, body?}  re-renders the PDF
    POST /api/people/letters/<id>/revoke/
    POST /api/people/letters/<id>/delete/
    """
    model = EmployeeLetter
    code = "LETTER"
    select = ("employee", "employee__department")
    search_fields = ("letter_no", "subject", "employee__name", "employee__employee_code")

    def build(self, l):
        return letter_row(l, self.request)

    def filter(self, qs, p):
        qs = super().filter(qs, p)
        return qs.filter(letter_type=p["letter_type"]) if p.get("letter_type") else qs

    def retrieve(self, request, pk=None):
        l = self.scope().filter(pk=pk).first()
        if l is None:
            return err("NOT_FOUND", "Letter not found.", 404)
        return ok("LETTER_DETAIL", "Letter.", letter_row(l, request, with_body=True))

    @action(detail=False, methods=["get"])
    def types(self, request):
        return ok("LETTER_TYPES", "Letter types.", [
            {"code": k, "title": v[0], "description": v[1], "default_subject": TEMPLATES[k][0],
             "issued_count": self.scope().filter(letter_type=k, is_active=True).count()} for k, v in CARDS.items()])

    def create(self, request):          # POST /letters/ == generate
        return self.generate(request)

    @action(detail=False, methods=["post"])
    def generate(self, request):
        d = request.data
        try:
            e = emp_by_code(self.company(), d.get("employee_code"))
            l = issue_letter(self.company(), e, (d.get("letter_type") or "").upper(), self.actor(),
                             d.get("variables") if isinstance(d.get("variables"), dict) else None,
                             d.get("subject"), d.get("body"))
        except ValueError as ex:
            return err("VALIDATION", str(ex))
        return ok("LETTER_ISSUED", "Letter generated.", letter_row(l, request, with_body=True), 201)

    @action(detail=False, methods=["post"])
    def preview(self, request):
        d = request.data
        lt = (d.get("letter_type") or "").upper()
        try:
            if lt not in TEMPLATES:
                raise ValueError(f"Invalid letter_type. Allowed: {', '.join(TEMPLATES)}")
            e = emp_by_code(self.company(), d.get("employee_code"))
        except ValueError as ex:
            return err("VALIDATION", str(ex))
        v = build_variables(e, d.get("variables") if isinstance(d.get("variables"), dict) else None)
        s, b = TEMPLATES[lt]
        return ok("LETTER_PREVIEW", "Letter preview (not saved).", {
            "subject": (d.get("subject") or s).format_map(_Safe(v)), "body": (d.get("body") or b).format_map(_Safe(v)),
            "variables": {k: str(x) for k, x in v.items()}})

    def apply(self, l, d, creating):
        if l.status == "Revoked":
            raise ValueError("A revoked letter cannot be edited.")
        if "subject" in d:
            l.subject = d["subject"]
        if "body" in d:
            if not str(d["body"]).strip():
                raise ValueError("body cannot be empty.")
            l.body = d["body"]

    def after_save(self, l, creating):
        from django.core.files.base import ContentFile
        v = l.variables or {}
        pdf = render_pdf(v.get("company_name") or "", v.get("company_address") or "", l.subject or "", l.body, l.letter_no,
                         company=l.company, variables=v)   # ADDITIVE: letterhead format
        l.pdf_file.save(f"{l.letter_no}.pdf", ContentFile(pdf), save=True)

    @action(detail=True, methods=["post"])
    def revoke(self, request, pk=None):
        l = self.scope().filter(pk=pk, is_active=True).first()
        if l is None:
            return err("NOT_FOUND", "Letter not found.", 404)
        l.status, l.updated_by = "Revoked", self.actor()
        l.save()
        return ok("LETTER_REVOKED", "Letter revoked.", letter_row(l, request))

    @action(detail=True, methods=["get"])
    def download(self, request, pk=None):
        l = self.scope().filter(pk=pk, is_active=True).first()
        if l is None or not l.pdf_file:
            raise Http404("Letter PDF not found.")
        return FileResponse(l.pdf_file.open("rb"), as_attachment=True, filename=f"{l.letter_no}.pdf",
                            content_type="application/pdf")
