"""DMS API — shared DRF pagination classes."""

from __future__ import annotations

from rest_framework.pagination import PageNumberPagination


class DocumentPagination(PageNumberPagination):
    """Default pagination for DMS document list endpoints.

    Clients may override the page size via the ``page_size`` query parameter
    up to ``max_page_size``.
    """

    page_size: int = 25
    page_size_query_param: str = "page_size"
    max_page_size: int = 200