Files
Aurora-Core/app/schemas/tv.py
T
NixReaperandClaude Sonnet 5 20f5e82d1b
CI / lint (push) Canceled after 0s
CI / typecheck (push) Canceled after 0s
CI / unit-tests (push) Canceled after 0s
CI / integration-tests (push) Canceled after 0s
CI / container-build (push) Canceled after 0s
CI / dependency-audit (push) Canceled after 0s
Add GET /movies and GET /series browse/discover endpoints
The complement to /search for browsing without a query: paginated,
filterable (genre, year, status) and sortable (popularity,
release/air date, rating, title) listings. Offset-based pagination
rather than the Aurora ID cursor scheme, since sorting by
popularity/rating/date doesn't line up with creation-order cursors.

Total count is computed via a window function in the same query as
the page of results, avoiding a second round trip per request. An
invalid filter (malformed genre id, unknown status) is a 422 via a
per-service InvalidMovieFilterError/InvalidSeriesFilterError, caught
before any DB query runs.

build_movie_summary/build_series_summary refactored to share their
row-to-summary logic with the new list path, avoiding a redundant
get_by_id lookup when the row is already in hand.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
2026-09-05 09:01:11 -05:00

132 lines
3.1 KiB
Python

"""Series/season/episode response schemas."""
from __future__ import annotations
from datetime import date, datetime
from pydantic import BaseModel
from app.schemas.common import (
CastCreditOut,
CompanyBriefOut,
CrewCreditOut,
GenreOut,
ImagesOut,
KeywordOut,
VideoOut,
)
class SeriesSummaryOut(BaseModel):
id: str
type: str = "series"
title: str
original_title: str | None = None
overview: str | None = None
first_air_date: date | None = None
poster_path: str | None = None
popularity: float | None = None
vote_average: float | None = None
class SeasonBriefOut(BaseModel):
id: str
season_number: int
title: str | None = None
episode_count: int | None = None
air_date: date | None = None
poster_path: str | None = None
class SeriesDetailOut(BaseModel):
id: str
type: str = "series"
title: str
original_title: str | None = None
overview: str | None = None
tagline: str | None = None
status: str
original_language: str | None = None
first_air_date: date | None = None
last_air_date: date | None = None
number_of_seasons: int | None = None
number_of_episodes: int | None = None
popularity: float | None = None
vote_average: float | None = None
vote_count: int | None = None
genres: list[GenreOut] = []
keywords: list[KeywordOut] = []
creators: list[CrewCreditOut] = []
cast: list[CastCreditOut] = []
crew: list[CrewCreditOut] = []
networks: list[CompanyBriefOut] = []
companies: list[CompanyBriefOut] = []
seasons: list[SeasonBriefOut] = []
images: ImagesOut = ImagesOut()
videos: list[VideoOut] = []
external_ids: dict[str, str] = {}
created_at: datetime
updated_at: datetime
class SeriesSeasonsOut(BaseModel):
id: str
seasons: list[SeasonBriefOut] = []
class SeriesListOut(BaseModel):
page: int
page_size: int
total_results: int
total_pages: int
results: list[SeriesSummaryOut] = []
class EpisodeBriefOut(BaseModel):
id: str
episode_number: int
title: str | None = None
air_date: date | None = None
still_path: str | None = None
class SeasonDetailOut(BaseModel):
id: str
type: str = "season"
series_id: str
season_number: int
title: str | None = None
overview: str | None = None
air_date: date | None = None
episode_count: int | None = None
episodes: list[EpisodeBriefOut] = []
images: ImagesOut = ImagesOut()
external_ids: dict[str, str] = {}
created_at: datetime
updated_at: datetime
class EpisodeDetailOut(BaseModel):
id: str
type: str = "episode"
series_id: str
season_id: str
season_number: int
episode_number: int
title: str | None = None
overview: str | None = None
air_date: date | None = None
runtime: int | None = None
cast: list[CastCreditOut] = []
guest_stars: list[CastCreditOut] = []
crew: list[CrewCreditOut] = []
images: ImagesOut = ImagesOut()
external_ids: dict[str, str] = {}
created_at: datetime
updated_at: datetime