"""Unit tests for app payload-rendering helpers — independent of
HTTP plumbing or DB. Pin the response shapes that are CLI contracts.
"""

from __future__ import annotations

from types import SimpleNamespace

import pytest

from controllers.openapi.apps import (  # pyright: ignore[reportPrivateUsage]
    _EMPTY_PARAMETERS,
    app_info_payload,
    parameters_payload,
)
from controllers.service_api.app.error import AppUnavailableError


def _fake_app(**overrides):
    base = {
        "id": "app1",
        "name": "X",
        "description": "d",
        "mode": "chat",
        "author_name": "alice",
        "tags": [SimpleNamespace(name="prod")],
        "updated_at": None,
        "enable_api": True,
        "workflow": None,
        "app_model_config": None,
    }
    base.update(overrides)
    return SimpleNamespace(**base)


def test_app_info_payload_shape():
    payload = app_info_payload(_fake_app())
    assert payload == {
        "id": "app1",
        "name": "X",
        "description": "d",
        "mode": "chat",
        "author": "alice",
        "tags": [{"name": "prod"}],
    }


def test_app_info_payload_handles_missing_description_and_author():
    payload = app_info_payload(_fake_app(description=None, author_name=None))
    assert payload["description"] is None
    assert payload["author"] is None


def test_parameters_payload_raises_app_unavailable_when_no_config():
    with pytest.raises(AppUnavailableError):
        parameters_payload(_fake_app(mode="chat", app_model_config=None))


def test_empty_parameters_constant_matches_describe_fallback_shape():
    """The fallback dict served by /describe when an app has no config
    must match the spec's stated keys (opening_statement, suggested_questions,
    user_input_form, file_upload, system_parameters)."""
    assert set(_EMPTY_PARAMETERS.keys()) == {
        "opening_statement",
        "suggested_questions",
        "user_input_form",
        "file_upload",
        "system_parameters",
    }
    assert _EMPTY_PARAMETERS["suggested_questions"] == []
    assert _EMPTY_PARAMETERS["user_input_form"] == []
    assert _EMPTY_PARAMETERS["opening_statement"] is None
    assert _EMPTY_PARAMETERS["file_upload"] is None
    assert _EMPTY_PARAMETERS["system_parameters"] == {}