chore(release): bump version to v1.9.0

app/api/endpoints/catalogs.py

@@ -9,12 +9,7 @@
 
 @router.get("/{token}/catalog/{type}/{id}.json")
 @router.get("/{token}/catalog/{type}/{id}/{extra}.json")
-async def get_catalog(response: Response, type: str, id: str, token: str, extra: str | None = None):
-    """
-    Get catalog recommendations.
-
-    This endpoint delegates all logic to CatalogService facade.
-    """
+async def get_catalog(response: Response, type: str, id: str, token: str, extra: str | None = None) -> dict:
     if type not in ("movie", "series"):
         raise HTTPException(status_code=400, detail="Invalid content type. Must be 'movie' or 'series'.")
 
@@ -29,10 +24,14 @@ async def get_catalog(response: Response, type: str, id: str, token: str, extra:
         for key, value in headers.items():
             response.headers[key] = value
 
+        # if recommendations are none or empty, then set cache header to no-cache
+        if recommendations and not recommendations.get("meta"):
+            response.headers["Cache-Control"] = "no-cache"
+
         return recommendations
 
     except HTTPException:
         raise
     except Exception as e:
         logger.exception(f"[{redact_token(token)}] Error fetching catalog for {type}/{id}: {e}")
-        raise HTTPException(status_code=500, detail=str(e))
+        raise HTTPException(status_code=500, detail=f"Something went wrong. Please try again. Error: {e}")

app/api/endpoints/stats.py

@@ -1,20 +1,17 @@
 from fastapi import APIRouter
 from loguru import logger
 
+from app.api.models.stats import StatsResponse
 from app.services.token_store import token_store
 
-router = APIRouter()
+router = APIRouter(tags=["Stats"])
 
 
 @router.get("/stats")
-async def get_stats() -> dict:
-    """Return lightweight public stats for the homepage.
-
-    Total users is cached for 12 hours inside TokenStore to avoid heavy scans.
-    """
+async def get_stats() -> StatsResponse:
     try:
         total = await token_store.count_users()
     except Exception as exc:
-        logger.warning(f"Failed to get total users: {exc}")
+        logger.error(f"Failed to get total users: {exc}")
         total = 0
-    return {"total_users": total}
+    return StatsResponse(total_users=total)

app/api/endpoints/tokens.py

@@ -29,6 +29,14 @@ class TokenRequest(BaseModel):
     )
     year_min: int = Field(default=2010, description="Minimum release year for TMDB API")
     year_max: int = Field(default=2025, description="Maximum release year for TMDB API")
+    sorting_order: Literal["default", "movies_first", "series_first"] = Field(
+        default="default", description="Order of movies and series catalogs"
+    )
+    simkl_api_key: str | None = Field(default=None, description="Simkl API Key for the user")
+    gemini_api_key: str | None = Field(default=None, description="Gemini API Key for AI features")
+    tmdb_api_key: str | None = Field(
+        default=None, description="TMDB API Key (required for new clients if server has none)"
+    )
 
 
 class TokenResponse(BaseModel):
@@ -94,6 +102,10 @@ async def create_token(payload: TokenRequest, request: Request) -> TokenResponse
         year_min=payload.year_min,
         year_max=payload.year_max,
         popularity=payload.popularity,
+        sorting_order=payload.sorting_order,
+        simkl_api_key=payload.simkl_api_key,
+        gemini_api_key=payload.gemini_api_key,
+        tmdb_api_key=payload.tmdb_api_key,
     )
 
     # 4. Prepare payload to store
@@ -186,7 +198,14 @@ async def check_stremio_identity(payload: TokenRequest):
 
     response = {"user_id": user_id, "email": email, "exists": exists}
     if exists and user_data:
-        response["settings"] = user_data.get("settings")
+        # Reconstruct UserSettings to ensure defaults (like sorting_order) are included for old accounts
+        raw_settings = user_data.get("settings", {})
+        try:
+            user_settings = UserSettings(**raw_settings)
+            response["settings"] = user_settings.model_dump()
+        except Exception as e:
+            logger.warning(f"Failed to normalize settings for user {user_id}: {e}")
+            response["settings"] = raw_settings
     return response
 
 

app/api/endpoints/validation.py

@@ -0,0 +1,71 @@
+from fastapi import APIRouter, HTTPException
+from google import genai
+from loguru import logger
+
+from app.api.models.validation import BaseValidationInput, BaseValidationResponse, PosterRatingValidationInput
+from app.services.poster_ratings.factory import PosterProvider, poster_ratings_factory
+from app.services.simkl import simkl_service
+from app.services.tmdb.client import TMDBClient
+
+router = APIRouter(tags=["Validation"])
+
+
+@router.post("/gemini/validation")
+async def validate_gemini_api_key(data: BaseValidationInput) -> BaseValidationResponse:
+    try:
+        client = genai.Client(api_key=data.api_key.strip())
+        await client.aio.models.list()
+        return BaseValidationResponse(valid=True, message="Gemini API key is valid")
+    except Exception as e:
+        logger.debug(f"Gemini API key validation failed: {e}")
+        return BaseValidationResponse(valid=False, message="Invalid Gemini API key")
+
+
+@router.post("/tmdb/validation")
+async def validate_tmdb_api_key(data: BaseValidationInput) -> BaseValidationResponse:
+    try:
+        client = TMDBClient(api_key=data.api_key.strip(), language="en-US")
+        await client.get("/configuration")
+        await client.close()
+        return BaseValidationResponse(valid=True, message="TMDB API key is valid")
+    except Exception as e:
+        logger.debug(f"TMDB API key validation failed: {e}")
+        return BaseValidationResponse(valid=False, message="Invalid TMDB API key")
+
+
+@router.post("/poster-rating/validate")
+async def validate_poster_rating_api_key(payload: PosterRatingValidationInput) -> BaseValidationResponse:
+    if not payload.api_key or not payload.api_key.strip():
+        return BaseValidationResponse(valid=False, message="API key cannot be empty")
+
+    try:
+        provider_enum = PosterProvider(payload.provider)
+    except ValueError:
+        raise HTTPException(status_code=400, detail=f"Invalid provider: {payload.provider}")
+
+    try:
+        if provider_enum == PosterProvider.RPDB:
+            is_valid = await poster_ratings_factory.rpdb_service.validate_api_key(payload.api_key.strip())
+        elif provider_enum == PosterProvider.TOP_POSTERS:
+            is_valid = await poster_ratings_factory.top_posters_service.validate_api_key(payload.api_key.strip())
+        else:
+            raise HTTPException(status_code=400, detail=f"Unsupported provider: {payload.provider}")
+
+        if is_valid:
+            return BaseValidationResponse(valid=True, message="API key is valid")
+        return BaseValidationResponse(valid=False, message="Invalid API key")
+    except Exception as e:
+        logger.error(f"Validation failed: {str(e)}")
+        raise HTTPException(status_code=500, detail="Validation failed due to an internal error.")
+
+
+@router.post("/simkl/validation")
+async def validate_simkl_api_key(data: BaseValidationInput) -> BaseValidationResponse:
+    try:
+        response = await simkl_service.get_trending(data.api_key)
+        if response:
+            return BaseValidationResponse(valid=True, message="Valid API Key")
+        return BaseValidationResponse(valid=False, message="Invalid API Key")
+    except Exception as e:
+        logger.error(f"Validation failed: {str(e)}")
+        raise HTTPException(status_code=500, detail="Validation failed due to an internal error.")

app/api/models/stats.py

@@ -0,0 +1,5 @@
+from pydantic import BaseModel
+
+
+class StatsResponse(BaseModel):
+    total_users: int

app/api/models/validation.py

@@ -0,0 +1,14 @@
+from pydantic import BaseModel, Field
+
+
+class BaseValidationInput(BaseModel):
+    api_key: str = Field(description="API key to validate")
+
+
+class BaseValidationResponse(BaseModel):
+    valid: bool
+    message: str
+
+
+class PosterRatingValidationInput(BaseValidationInput):
+    provider: str = Field(description="Provider name: 'rpdb' or 'top_posters'")

app/api/main.py → app/api/router.py

@@ -5,9 +5,9 @@
 from .endpoints.health import router as health_router
 from .endpoints.manifest import router as manifest_router
 from .endpoints.meta import router as meta_router
-from .endpoints.poster_rating import router as poster_rating_router
 from .endpoints.stats import router as stats_router
 from .endpoints.tokens import router as tokens_router
+from .endpoints.validation import router as validation_router
 
 api_router = APIRouter()
 
@@ -24,4 +24,4 @@ async def root():
 api_router.include_router(meta_router)
 api_router.include_router(announcement_router)
 api_router.include_router(stats_router)
-api_router.include_router(poster_rating_router)
+api_router.include_router(validation_router)

app/core/app.py

@@ -11,7 +11,7 @@
 from loguru import logger
 
 from app.api.endpoints.meta import fetch_languages_list
-from app.api.main import api_router
+from app.api.router import api_router
 from app.core.settings import get_default_catalogs_for_frontend
 from app.services.redis_service import redis_service
 from app.services.tmdb.genre import movie_genres, series_genres
@@ -106,6 +106,13 @@ async def configure_page(request: Request, _token: str | None = None):
         logger.warning(f"Failed to fetch languages for template: {e}")
         languages = [{"iso_639_1": "en-US", "language": "English", "country": "US"}]
 
+    # Get total users count
+    total_users = 0
+    try:
+        total_users = await token_store.count_users()
+    except Exception as e:
+        logger.warning(f"Failed to get total users for template: {e}")
+
     # Format default catalogs for frontend
     default_catalogs = get_default_catalogs_for_frontend()
 
@@ -117,6 +124,7 @@ async def configure_page(request: Request, _token: str | None = None):
     html_content = template.render(
         request=request,
         app_version=__version__,
+        total_users=total_users,
         app_host=settings.HOST_NAME,
         announcement_html=settings.ANNOUNCEMENT_HTML or "",
         languages=languages,

app/core/base_client.py

@@ -37,28 +37,37 @@ async def _request(self, method: str, url: str, max_tries: int | None = None, **
         """Internal request handler with retry logic."""
         client = await self.get_client()
         tries = max_tries or self.max_retries
-        last_exception = None
 
         for attempt in range(1, tries + 1):
             try:
                 response = await client.request(method, url, **kwargs)
                 response.raise_for_status()
                 return response
             except (httpx.HTTPStatusError, httpx.RequestError) as e:
-                last_exception = e
-                if attempt < tries:
+
+                # Check if the error is retryable
+                is_retryable = True
+                if isinstance(e, httpx.HTTPStatusError):
+                    # Only retry on 429 (Rate Limit) and 5xx (Server Errors)
+                    # 404, 400, 401, etc. are not retryable
+                    is_retryable = e.response.status_code in (429, 500, 502, 503, 504)
+
+                if is_retryable and attempt < tries:
                     wait_time = 0.5 * (2 ** (attempt - 1))  # Exponential backoff
                     logger.warning(
                         f"Request failed ({method} {url}): {str(e)}. "
                         f"Retrying in {wait_time}s... (Attempt {attempt}/{tries})"
                     )
                     await asyncio.sleep(wait_time)
                 else:
-                    logger.error(f"Request failed after {tries} attempts: {str(e)}")
+                    # If not retryable or no more attempts left, log and raise
+                    if not is_retryable:
+                        logger.error(f"Non-retryable request failure ({method} {url}): {str(e)}")
+                    else:
+                        logger.error(f"Request failed after {tries} attempts ({method} {url}): {str(e)}")
+                    raise e
 
-        if last_exception:
-            raise last_exception
-        raise httpx.RequestError("Request failed for unknown reasons")
+        raise httpx.RequestError(f"Request failed for {method} {url} with 0 attempts configured")
 
     async def get(self, url: str, params: dict[str, Any] | None = None, **kwargs) -> dict[str, Any]:
         """Perform a GET request and return the JSON response."""

app/core/settings.py

@@ -35,6 +35,12 @@ class UserSettings(BaseModel):
     popularity: Literal["mainstream", "balanced", "gems", "all"] = Field(
         default="balanced", description="Popularity preference"
     )
+    sorting_order: Literal["default", "movies_first", "series_first"] = Field(
+        default="default", description="Order of movies and series catalogs"
+    )
+    simkl_api_key: str | None = Field(default=None, description="Simkl API Key for the user")
+    gemini_api_key: str | None = Field(default=None, description="Gemini API Key for AI-powered features")
+    tmdb_api_key: str | None = Field(default=None, description="TMDB API Key (used if set; else server config)")
 
 
 # Catalog descriptions for frontend
@@ -155,6 +161,15 @@ def get_default_catalogs_for_frontend() -> list[dict]:
     return catalogs
 
 
+def resolve_tmdb_api_key(user_settings: UserSettings | None) -> str | None:
+    """Use TMDB API key from user settings (Redis) if set, else from server config."""
+    from app.core.config import settings
+
+    if user_settings and user_settings.tmdb_api_key:
+        return user_settings.tmdb_api_key
+    return settings.TMDB_API_KEY
+
+
 class Credentials(BaseModel):
     authKey: str
     email: str

app/core/version.py

@@ -1 +1 @@
-__version__ = "1.8.0"
+__version__ = "1.9.0"

app/models/taste_profile.py

@@ -38,6 +38,7 @@ class TasteProfile(BaseModel):
         default_factory=set,
         description="Set of processed item IDs to prevent double counting",
     )
+    interest_summary: str | None = Field(default=None, description="LLM-generated description of user interests")
 
     class Config:
         """Pydantic configuration."""