Add now-playing and upcoming movie endpoints

Buildable now that release_dates exists: GET /movies/now-playing and
/movies/upcoming filter on release_type="theatrical" per region, windowed
around today. A movie can carry more than one theatrical-type row in the
same region (limited release then wide release both map to "theatrical"
per normalizer._RELEASE_TYPE_MAP) -- collapsed to one row per movie via a
grouped subquery rather than joining ReleaseDate directly, which would
duplicate the movie in the page and inflate the total count.

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

app/repositories/movie_repository.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 import uuid
+from datetime import date, timedelta
 
 from sqlalchemy import func, select
 from sqlalchemy.ext.asyncio import AsyncSession
@@ -12,7 +13,13 @@ from app.models.company import Company, MovieCompany
 from app.models.enums import MovieStatus
 from app.models.genre import Genre, MovieGenre
 from app.models.keyword import Keyword, MovieKeyword
-from app.models.movie import Movie, MovieAlternateTitle, MovieRecommendation
+from app.models.movie import Movie, MovieAlternateTitle, MovieRecommendation, ReleaseDate
+
+# How far back "now playing" looks for a theatrical release -- TMDb's own
+# now_playing window is roughly a month; a movie ages out of "now playing"
+# once its theatrical run is this old, whether or not it has any release
+# still in the future (that's what "upcoming" is for).
+_NOW_PLAYING_WINDOW_DAYS = 45
 
 _MOVIE_SORT_COLUMNS = {
     "popularity": Movie.popularity,
@@ -98,6 +105,84 @@ async def get_movie_recommendation_ids(
     return list(result.scalars().all())
 
 
+async def list_now_playing(
+    session: AsyncSession, *, region: str, limit: int, offset: int
+) -> tuple[list[Movie], int]:
+    """Movies with a theatrical release in `region` within the last
+    _NOW_PLAYING_WINDOW_DAYS, most recent first. A movie can have more than
+    one theatrical-type release_date row in the same region (a limited
+    release then a wide release both map to release_type="theatrical" --
+    see normalizer._RELEASE_TYPE_MAP), so this collapses to each movie's
+    latest one via a grouped subquery rather than joining ReleaseDate
+    directly, which would duplicate the movie in the page and inflate the
+    window-function total_count."""
+
+    today = date.today()
+    window_start = today - timedelta(days=_NOW_PLAYING_WINDOW_DAYS)
+    latest_release = (
+        select(
+            ReleaseDate.entity_id.label("movie_id"),
+            func.max(ReleaseDate.release_date).label("release_date"),
+        )
+        .where(
+            ReleaseDate.entity_type == "movie",
+            ReleaseDate.country_code == region,
+            ReleaseDate.release_type == "theatrical",
+            ReleaseDate.release_date <= today,
+            ReleaseDate.release_date >= window_start,
+        )
+        .group_by(ReleaseDate.entity_id)
+        .subquery()
+    )
+    stmt = (
+        select(Movie, func.count().over().label("total_count"))
+        .join(latest_release, latest_release.c.movie_id == Movie.id)
+        .order_by(latest_release.c.release_date.desc(), Movie.id.asc())
+        .limit(limit)
+        .offset(offset)
+    )
+    rows = (await session.execute(stmt)).all()
+    if not rows:
+        return [], 0
+    return [row[0] for row in rows], rows[0].total_count
+
+
+async def list_upcoming(
+    session: AsyncSession, *, region: str, limit: int, offset: int
+) -> tuple[list[Movie], int]:
+    """Movies with a future theatrical release in `region`, soonest first
+    -- see list_now_playing for why this collapses to one row per movie
+    (here, the earliest upcoming date) rather than joining ReleaseDate
+    directly."""
+
+    today = date.today()
+    earliest_release = (
+        select(
+            ReleaseDate.entity_id.label("movie_id"),
+            func.min(ReleaseDate.release_date).label("release_date"),
+        )
+        .where(
+            ReleaseDate.entity_type == "movie",
+            ReleaseDate.country_code == region,
+            ReleaseDate.release_type == "theatrical",
+            ReleaseDate.release_date > today,
+        )
+        .group_by(ReleaseDate.entity_id)
+        .subquery()
+    )
+    stmt = (
+        select(Movie, func.count().over().label("total_count"))
+        .join(earliest_release, earliest_release.c.movie_id == Movie.id)
+        .order_by(earliest_release.c.release_date.asc(), Movie.id.asc())
+        .limit(limit)
+        .offset(offset)
+    )
+    rows = (await session.execute(stmt)).all()
+    if not rows:
+        return [], 0
+    return [row[0] for row in rows], rows[0].total_count
+
+
 async def list_movies(
     session: AsyncSession,
     *,