"""bluesky-pds — recipe-specific functional test (Phase 2 P3).

GETs `/xrpc/com.atproto.server.describeServer` — the public atproto XRPC endpoint that advertises
the PDS's configuration. Asserts the response is JSON with at least one of the documented PDS
config fields (`availableUserDomains` array of hosting domains, OR `inviteCodeRequired` bool).

Non-vacuous: distinguishes a working atproto PDS from a generic HTTP 200 (a misconfigured server
that returns 200 from /xrpc/* but with a non-atproto shape would fail).
"""

from __future__ import annotations

import os
import sys

sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", "..", "runner"))
from harness import http as harness_http  # noqa: E402


def test_describe_server_returns_atproto_envelope(live_app):
    """GET /xrpc/com.atproto.server.describeServer → 200 + atproto config JSON."""
    url = f"https://{live_app}/xrpc/com.atproto.server.describeServer"
    status, body = harness_http.retry_http_get(url, expect_status=200, max_wait=60, interval=3)
    assert status == 200, f"GET {url} HTTP {status} (expected 200)"
    assert isinstance(body, dict), f"describe-server returned non-dict: {type(body).__name__}"
    # At least one of these atproto-spec fields must be present
    expected_any = ("availableUserDomains", "inviteCodeRequired", "links", "did")
    present = [k for k in expected_any if k in body]
    assert present, (
        f"describe-server missing all of {expected_any}; got keys: {sorted(body.keys())[:20]}"
    )