Add watch providers (where to stream/rent/buy)

New TMDb integration end to end: append_to_response "watch/providers",
normalizer parsing grouped by country/monetization type, a WatchProvider
catalog entry (external-id keyed, same get_or_create pattern as Company/
Collection/Person) + polymorphic WatchProviderOffering table (new
migration 0002), ingestion write (including provider logos via the
existing Artwork table), and API exposure -- embedded on movie/series
detail plus a dedicated /watch-providers sub-route, shaped to mirror
TMDb's own response for easy porting.

Note: this data comes from JustWatch via TMDb and carries its own
attribution requirement separate from TMDb's general one -- flagged in
docs/api.md, must be satisfied before showing this in the frontend.

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

app/services/tv_service.py

@@ -24,8 +24,10 @@ from app.schemas.tv import (
     SeriesSeasonsOut,
     SeriesSummaryOut,
     SeriesVideosOut,
+    SeriesWatchProvidersOut,
 )
 from app.services.common import (
+    build_watch_providers_out,
     pick_certification,
     primary_artwork_path,
     split_credits,
@@ -109,6 +111,7 @@ async def get_series_detail(session: AsyncSession, series_aurora_id: str) -> Ser
     artwork = await polymorphic.get_artwork(session, "series", series_id)
     videos = await polymorphic.get_videos(session, "series", series_id)
     release_dates = await polymorphic.get_release_dates(session, "series", series_id)
+    watch_provider_rows = await polymorphic.get_watch_providers(session, "series", series_id)
     external_ids = await polymorphic.get_external_ids(session, "series", series_id)
 
     cast, crew, creators = _split_series_credits(credits_)
@@ -145,6 +148,7 @@ async def get_series_detail(session: AsyncSession, series_aurora_id: str) -> Ser
         images=to_images_out(artwork),
         videos=[to_video_out(v) for v in videos],
         release_dates=[to_release_date_out(rd) for rd in release_dates],
+        watch_providers=await build_watch_providers_out(session, watch_provider_rows),
         external_ids=external_ids,
         created_at=series.created_at,
         updated_at=series.updated_at,
@@ -193,6 +197,19 @@ async def get_series_videos(session: AsyncSession, series_aurora_id: str) -> Ser
     )
 
 
+async def get_series_watch_providers(
+    session: AsyncSession, series_aurora_id: str
+) -> SeriesWatchProvidersOut:
+    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)
+    rows = await polymorphic.get_watch_providers(session, "series", series_id)
+    return SeriesWatchProvidersOut(
+        id=aurora_id("series", str(series.id)), results=await build_watch_providers_out(session, rows)
+    )
+
+
 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)