Add series endpoint parity: /credits, /images, /videos

Movies have separate /credits, /images, /videos sub-endpoints; series
only had /seasons. Adds the matching three for series, reusing the
same cast/crew/creators three-way split series detail already does
(extracted into _split_series_credits so both share it).

Co-Authored-By: Claude Sonnet 5 <[email protected]>

app/services/tv_service.py

@@ -7,19 +7,23 @@ import uuid
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from app.core.ids import aurora_id, parse_aurora_id
+from app.models.credit import Credit
 from app.models.enums import ArtworkType, CompanyType, SeriesStatus
 from app.models.tv import Series
 from app.repositories import polymorphic, tv_repository
-from app.schemas.common import CompanyBriefOut, GenreOut, KeywordOut
+from app.schemas.common import CastCreditOut, CompanyBriefOut, CrewCreditOut, GenreOut, KeywordOut
 from app.schemas.tv import (
     EpisodeBriefOut,
     EpisodeDetailOut,
     SeasonBriefOut,
     SeasonDetailOut,
+    SeriesCreditsOut,
     SeriesDetailOut,
+    SeriesImagesOut,
     SeriesListOut,
     SeriesSeasonsOut,
     SeriesSummaryOut,
+    SeriesVideosOut,
 )
 from app.services.common import primary_artwork_path, split_credits, to_images_out, to_video_out
 
@@ -69,6 +73,16 @@ async def _company_brief(session: AsyncSession, company) -> CompanyBriefOut:
     )
 
 
+def _split_series_credits(
+    credits_: list[Credit],
+) -> tuple[list[CastCreditOut], list[CrewCreditOut], list[CrewCreditOut]]:
+    # Series-level "Creator" credits are their own bucket (section 7),
+    # neither cast nor regular crew.
+    cast, crew = split_credits([c for c in credits_ if c.department != "Creator"])
+    _, creators = split_credits([c for c in credits_ if c.department == "Creator"])
+    return cast, crew, creators
+
+
 async def get_series_detail(session: AsyncSession, series_aurora_id: str) -> SeriesDetailOut:
     series_id = _resolve_id(series_aurora_id, "series", SeriesNotFoundError)
     series = await tv_repository.get_series_by_id(session, series_id)
@@ -87,8 +101,7 @@ async def get_series_detail(session: AsyncSession, series_aurora_id: str) -> Ser
     videos = await polymorphic.get_videos(session, "series", series_id)
     external_ids = await polymorphic.get_external_ids(session, "series", series_id)
 
-    cast, crew = split_credits([c for c in credits_ if c.department != "Creator"])
-    _, creators = split_credits([c for c in credits_ if c.department == "Creator"])
+    cast, crew, creators = _split_series_credits(credits_)
 
     season_briefs = [await _season_brief(session, s) for s in seasons]
     network_briefs = [await _company_brief(session, c) for c, _role in networks]
@@ -135,6 +148,38 @@ async def get_series_seasons(session: AsyncSession, series_aurora_id: str) -> Se
     return SeriesSeasonsOut(id=aurora_id("series", str(series.id)), seasons=briefs)
 
 
+async def get_series_credits(session: AsyncSession, series_aurora_id: str) -> SeriesCreditsOut:
+    series_id = _resolve_id(series_aurora_id, "series", SeriesNotFoundError)
+    series = await tv_repository.get_series_by_id(session, series_id)
+    if series is None:
+        raise SeriesNotFoundError(series_aurora_id)
+    credits_ = await polymorphic.get_credits(session, "series", series_id)
+    cast, crew, creators = _split_series_credits(credits_)
+    return SeriesCreditsOut(
+        id=aurora_id("series", str(series.id)), cast=cast, crew=crew, creators=creators
+    )
+
+
+async def get_series_images(session: AsyncSession, series_aurora_id: str) -> SeriesImagesOut:
+    series_id = _resolve_id(series_aurora_id, "series", SeriesNotFoundError)
+    series = await tv_repository.get_series_by_id(session, series_id)
+    if series is None:
+        raise SeriesNotFoundError(series_aurora_id)
+    artwork = await polymorphic.get_artwork(session, "series", series_id)
+    return SeriesImagesOut(id=aurora_id("series", str(series.id)), images=to_images_out(artwork))
+
+
+async def get_series_videos(session: AsyncSession, series_aurora_id: str) -> SeriesVideosOut:
+    series_id = _resolve_id(series_aurora_id, "series", SeriesNotFoundError)
+    series = await tv_repository.get_series_by_id(session, series_id)
+    if series is None:
+        raise SeriesNotFoundError(series_aurora_id)
+    videos = await polymorphic.get_videos(session, "series", series_id)
+    return SeriesVideosOut(
+        id=aurora_id("series", str(series.id)), videos=[to_video_out(v) for v in videos]
+    )
+
+
 async def get_season_detail(session: AsyncSession, season_aurora_id: str) -> SeasonDetailOut:
     season_id = _resolve_id(season_aurora_id, "season", SeasonNotFoundError)
     season = await tv_repository.get_season_by_id(session, season_id)