FabledCurator/tests/test_api_posts.py

"""FC-3e: /api/posts API tests.

Validates list shape, cursor handling, filter validation, and detail
endpoint. Service-level fixtures are exercised by test_post_feed_service
— here we focus on the HTTP surface (validation, status codes, dict shape).
"""
from datetime import UTC, datetime, timedelta

import pytest

from backend.app.models import Artist, Post, Source

pytestmark = pytest.mark.integration


@pytest.fixture
async def seeded_post(db):
    artist = Artist(name="alice-api", slug="alice-api")
    db.add(artist)
    await db.flush()
    source = Source(
        artist_id=artist.id, platform="patreon",
        url="https://p/alice-api", enabled=True,
    )
    db.add(source)
    await db.flush()
    post = Post(
        source_id=source.id, artist_id=artist.id, external_post_id="API1",
        post_title="Hello", post_url="https://p/alice-api/1",
        post_date=datetime.now(UTC),
        description="<p>hi</p>",
    )
    db.add(post)
    await db.commit()
    return artist, source, post


@pytest.mark.asyncio
async def test_list_returns_items_and_cursor_keys(client, seeded_post):
    resp = await client.get("/api/posts")
    assert resp.status_code == 200
    body = await resp.get_json()
    assert set(body.keys()) == {"items", "next_cursor"}
    assert isinstance(body["items"], list)
    assert body["items"][0]["post_title"] == "Hello"
    assert body["items"][0]["description_plain"] == "hi"


@pytest.mark.asyncio
async def test_list_rejects_malformed_cursor(client):
    resp = await client.get("/api/posts?cursor=garbage!!!")
    assert resp.status_code == 400
    body = await resp.get_json()
    assert body["error"] == "invalid_cursor"


@pytest.mark.asyncio
async def test_list_rejects_unknown_platform(client):
    resp = await client.get("/api/posts?platform=myspace")
    assert resp.status_code == 400
    body = await resp.get_json()
    assert body["error"] == "unknown_platform"


@pytest.mark.asyncio
async def test_list_rejects_non_int_artist_id(client):
    resp = await client.get("/api/posts?artist_id=notanint")
    assert resp.status_code == 400
    body = await resp.get_json()
    assert body["error"] == "invalid_artist_id"


@pytest.mark.asyncio
async def test_list_rejects_limit_out_of_range(client):
    resp = await client.get("/api/posts?limit=0")
    assert resp.status_code == 400
    resp = await client.get("/api/posts?limit=500")
    assert resp.status_code == 400


@pytest.mark.asyncio
async def test_list_filter_propagates_artist(client, seeded_post):
    artist, _, post = seeded_post
    resp = await client.get(f"/api/posts?artist_id={artist.id}")
    assert resp.status_code == 200
    body = await resp.get_json()
    assert len(body["items"]) == 1
    assert body["items"][0]["id"] == post.id


@pytest.mark.asyncio
async def test_list_text_search_propagates(client, seeded_post):
    _, _, post = seeded_post  # title "Hello", description "<p>hi</p>"
    hit = await client.get("/api/posts?q=hello")
    assert hit.status_code == 200
    assert [it["id"] for it in (await hit.get_json())["items"]] == [post.id]
    miss = await client.get("/api/posts?q=zzznope")
    assert (await miss.get_json())["items"] == []


@pytest.mark.asyncio
async def test_detail_200_for_known(client, seeded_post):
    _, _, post = seeded_post
    resp = await client.get(f"/api/posts/{post.id}")
    assert resp.status_code == 200
    body = await resp.get_json()
    assert body["id"] == post.id
    assert "description_full" in body
    assert body["description_full"] == "hi"


@pytest.mark.asyncio
async def test_detail_404_for_unknown(client):
    resp = await client.get("/api/posts/999999")
    assert resp.status_code == 404
    body = await resp.get_json()
    assert body["error"] == "not_found"


@pytest.fixture
async def post_timeline(db):
    """Five posts on distinct dates: posts[0] oldest … posts[4] newest."""
    artist = Artist(name="tl-api", slug="tl-api")
    db.add(artist)
    await db.flush()
    source = Source(
        artist_id=artist.id, platform="patreon",
        url="https://p/tl-api", enabled=True,
    )
    db.add(source)
    await db.flush()
    base = datetime(2026, 1, 1, tzinfo=UTC)
    posts = []
    for i in range(5):
        p = Post(
            source_id=source.id, artist_id=artist.id,
            external_post_id=f"TL{i}",
            post_title=f"post {i}", post_date=base + timedelta(days=i),
        )
        db.add(p)
        posts.append(p)
    await db.commit()
    return artist, source, posts


@pytest.mark.asyncio
async def test_around_returns_window_with_anchor(client, post_timeline):
    _, _, posts = post_timeline
    anchor = posts[2]
    resp = await client.get(f"/api/posts?around={anchor.id}&limit=1")
    assert resp.status_code == 200
    body = await resp.get_json()
    assert set(body.keys()) == {"items", "cursor_older", "cursor_newer", "anchor_id"}
    assert body["anchor_id"] == anchor.id
    # limit=1: one newer + anchor + one older, in feed (desc) order.
    assert [it["id"] for it in body["items"]] == [posts[3].id, posts[2].id, posts[1].id]
    assert body["cursor_older"] is not None   # posts[0] still older
    assert body["cursor_newer"] is not None   # posts[4] still newer


@pytest.mark.asyncio
async def test_around_404_for_unknown(client):
    resp = await client.get("/api/posts?around=999999")
    assert resp.status_code == 404
    assert (await resp.get_json())["error"] == "not_found"


@pytest.mark.asyncio
async def test_direction_newer_walks_forward(client, post_timeline):
    _, _, posts = post_timeline
    around = await client.get(f"/api/posts?around={posts[1].id}&limit=1")
    cursor_newer = (await around.get_json())["cursor_newer"]
    assert cursor_newer is not None
    resp = await client.get(f"/api/posts?cursor={cursor_newer}&direction=newer&limit=5")
    assert resp.status_code == 200
    # Newer than the window's newest (posts[2]) → posts[3], posts[4] in desc order.
    assert [it["id"] for it in (await resp.get_json())["items"]] == [posts[4].id, posts[3].id]


@pytest.mark.asyncio
async def test_rejects_bad_direction(client):
    resp = await client.get("/api/posts?direction=sideways")
    assert resp.status_code == 400
    assert (await resp.get_json())["error"] == "invalid_direction"


@pytest.mark.asyncio
async def test_detail_returns_uncapped_thumbnails(client, db):
    """Feed query caps thumbnails at 6 for previews; detail endpoint
    returns the full list so PostModal can render the masonry grid."""
    from backend.app.models import ImageRecord

    a = Artist(name="yuki-api", slug="yuki-api")
    db.add(a)
    await db.flush()
    s = Source(
        artist_id=a.id, platform="patreon",
        url="https://patreon.com/cw/yuki-api", enabled=True,
    )
    db.add(s)
    await db.flush()
    p = Post(
        source_id=s.id, artist_id=a.id, external_post_id="DETAIL10",
        post_title="big post", description="<p>body</p>",
    )
    db.add(p)
    await db.flush()
    # Seed 10 ImageRecord rows linked to this post via primary_post_id.
    for i in range(10):
        sha = f"y{i:x}".ljust(64, "0")[:64]
        rec = ImageRecord(
            path=f"/images/test-yuki-{i}.jpg",
            sha256=sha,
            size_bytes=1,
            mime="image/jpeg",
            width=64,
            height=64,
            origin="downloaded",
            integrity_status="unknown",
            primary_post_id=p.id,
            artist_id=a.id,
        )
        db.add(rec)
    await db.commit()

    resp = await client.get(f"/api/posts/{p.id}")
    assert resp.status_code == 200
    body = await resp.get_json()
    # Detail returns ALL 10 thumbnails (feed would return 6 + thumbnails_more).
    assert len(body["thumbnails"]) == 10
    assert body["description_full"] == "body"