"""API schemas for posts.

This module defines Pydantic schemas for request/response validation
in the posts API endpoints.
"""

from datetime import datetime
from uuid import UUID

from pydantic import BaseModel, ConfigDict, Field


class PostBaseSchema(BaseModel):
    """Base schema for posts.

    Contains common fields shared across post schemas.

    Attributes:
        title: Post title (3-200 characters).
        content: Post content (10-50000 characters).
    """

    model_config = ConfigDict(from_attributes=True)

    title: str = Field(..., min_length=3, max_length=200)
    content: str = Field(..., min_length=10, max_length=50000)


class PostCreateSchema(PostBaseSchema):
    """Schema for creating a post.

    Extends base schema with creation-specific fields.

    Attributes:
        tags: List of tags for categorization.
    """

    tags: list[str] = Field(default_factory=list)


class PostUpdateSchema(BaseModel):
    """Schema for updating a post.

    All fields are optional for partial updates.

    Attributes:
        title: Optional new title.
        content: Optional new content.
        tags: Optional new tags list.
    """

    model_config = ConfigDict(from_attributes=True)

    title: str | None = Field(None, min_length=3, max_length=200)
    content: str | None = Field(None, min_length=10, max_length=50000)
    tags: list[str] | None = None


class PostResponseSchema(BaseModel):
    """Schema for post response.

    Complete post data for API responses.

    Attributes:
        id: Unique post identifier.
        title: Post title.
        content: Post content.
        slug: URL-friendly slug.
        author_id: Author identifier.
        published: Publication status.
        tags: List of tags.
        created_at: Creation timestamp.
        updated_at: Last update timestamp.
    """

    model_config = ConfigDict(from_attributes=True)

    id: UUID
    title: str
    content: str
    slug: str
    author_id: str
    published: bool
    tags: list[str]
    created_at: datetime
    updated_at: datetime


class PostListResponseSchema(BaseModel):
    """Schema for list of posts response.

    Paginated response for list endpoints.

    Attributes:
        items: List of post items.
        total: Total number of items.
    """

    items: list[PostResponseSchema]
    total: int


class PostSearchSchema(BaseModel):
    """Schema for searching posts.

    Search query parameters.

    Attributes:
        query: Search query string (1-100 characters).
    """

    query: str = Field(..., min_length=1, max_length=100)


class PostPublishSchema(BaseModel):
    """Schema for publishing/unpublishing a post.

    Publication status toggle.

    Attributes:
        published: Desired publication status.
    """

    published: bool