"""请求 / 响应 Pydantic 模型。"""
from typing import Any

from pydantic import BaseModel, Field


class SearchRequest(BaseModel):
    """搜索请求体（POST 用）。"""

    query: str = Field(..., min_length=1, description="搜索关键词")
    locale: str | None = Field(default=None, description="语言代码，留空使用默认")
    page: int = Field(default=1, ge=1)
    per_page: int = Field(default=25, ge=1, le=100)


class SearchResponse(BaseModel):
    """统一响应信封。"""

    success: bool
    query: str
    count: int
    page: int
    per_page: int
    next_page: str | None = None
    sec_ids_used: list[int]
    results: list[dict[str, Any]]
    error: str | None = None


class CacheStatus(BaseModel):
    """缓存状态。"""

    sec_ids_count: int
    last_updated_at: str | None
    next_refresh_at: str | None