"""Unit tests for the escalation-tier signature used by dead-letter keying.

``escalation_tiers_signature`` fingerprints the runtime escalation config so a
dead-lettered document becomes retryable when a new tier appears (e.g. an
operator enables OCR). It must be settings-derived (role-independent) and must
change when OCR is toggled.
"""

from __future__ import annotations

from types import SimpleNamespace

import pytest

from nextcloud_mcp_server.document_processors.escalation import (
    escalation_tiers_signature,
)

pytestmark = pytest.mark.unit


def _settings(
    *, ocr: bool, ocr_incluster: bool = False, engine: str = "pypdfium2"
) -> SimpleNamespace:
    return SimpleNamespace(
        document_ocr_enabled=ocr,
        document_ocr_incluster_enabled=ocr_incluster,
        document_tier1_engine=engine,
    )


def test_signature_is_stable_for_same_config() -> None:
    assert escalation_tiers_signature(
        _settings(ocr=False)
    ) == escalation_tiers_signature(_settings(ocr=False))


def test_enabling_ocr_changes_signature() -> None:
    # Enabling OCR adds an escalation tier -> previously dead-lettered docs retry.
    assert escalation_tiers_signature(
        _settings(ocr=False)
    ) != escalation_tiers_signature(_settings(ocr=True))


def test_enabling_ocr_incluster_changes_signature() -> None:
    # Enabling the in-cluster (tier2) rung adds an escalation tier independently of
    # the upstream rung -> previously dead-lettered scanned docs become retryable.
    assert escalation_tiers_signature(
        _settings(ocr=False, ocr_incluster=False)
    ) != escalation_tiers_signature(_settings(ocr=False, ocr_incluster=True))


def test_tier1_engine_change_changes_signature() -> None:
    assert escalation_tiers_signature(
        _settings(ocr=False, engine="pypdfium2")
    ) != escalation_tiers_signature(_settings(ocr=False, engine="pymupdf"))