"""Shared API schemas used across all endpoints."""

from typing import Any, Literal

from pydantic import BaseModel


class APIEnvelope(BaseModel):
    """Standard JSON envelope for all API responses."""

    status: Literal["success", "error"]
    data: Any | None = None
    error: str | None = None