"""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

import pytest
from sqlalchemy.orm import Session

from controllers.openapi.apps import (  # pyright: ignore[reportPrivateUsage]
    _EMPTY_PARAMETERS,
    _is_listable,
    parameters_payload,
)
from controllers.service_api.app.error import AppUnavailableError
from models.model import App, AppMode, IconType


def _app(*, mode: AppMode = AppMode.CHAT) -> App:
    return App(
        id="app1",
        tenant_id="tenant-1",
        name="X",
        description="d",
        mode=mode,
        icon_type=IconType.EMOJI,
        icon="robot",
        icon_background="#FFFFFF",
        enable_site=False,
        enable_api=True,
        max_active_requests=0,
    )


def test_parameters_payload_raises_app_unavailable_when_no_config(unbound_session: Session):
    app = _app()

    with pytest.raises(AppUnavailableError):
        parameters_payload(app, session=unbound_session)


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"] == {}


@pytest.mark.parametrize(
    "mode",
    [AppMode.COMPLETION, AppMode.CHAT, AppMode.ADVANCED_CHAT, AppMode.WORKFLOW, AppMode.AGENT_CHAT],
)
def test_is_listable_accepts_supported_app_types(mode):
    assert _is_listable(_app(mode=mode)) is True


@pytest.mark.parametrize("mode", [AppMode.AGENT, AppMode.CHANNEL, AppMode.RAG_PIPELINE])
def test_is_listable_hides_non_app_modes(mode):
    assert _is_listable(_app(mode=mode)) is False