infrasynth-backend-kit/infrasynth/api/pagination.py
jcv-dev 551b42eab5 feat: production-hardening pass across the kit
Close the gaps between the documented contract (API-STANDARD, TENANCY,
ENTITLEMENTS) and the implementation, and remove committed build artifacts.

Security:
- verify + process inbound webhooks (HMAC/handler verify, size limit,
  timestamp tolerance, idempotency via InboundEvent.external_id)
- real 2FA login flow (pre-auth challenge; tokens only after verify/recovery)
- wire HybridPermission into security/audit views; add API-key rotate and
  users/<id>/permissions|roles endpoints
- tenant-scoped throttling on by default; webhook replay protection
- verify MercadoPago webhook signatures
- login brute-force guard, configurable password policy, real ALTCHA PoW

Correctness:
- apply verified billing webhooks idempotently (subscription/entitlement/
  invoice/PaymentTransaction); scheduled payment lifecycle jobs
- capture audit update diffs automatically; add audit retention purge
- working notification retries, per-channel rate limits, log retention
- pluggable virus scanner, upload-size limit, pipeline toggle
- feature rollout %/environment targeting; settings-driven registrations
- workflow guards (instance cap, route depth, self-assignment, clone on re-entry)
- wire every previously-dead INFRASYNTH_* setting; drop truly dead ones

Delivery:
- README + CHANGELOG; CI format check + coverage gate
- keep test media out of the tree; untrack .coverage, __pycache__,
  egg-info, docs/ and invoice artifacts
2026-09-24 10:41:21 -05:00

34 lines
1,003 B
Python

"""Opaque cursor pagination (``API-STANDARD.md`` §6)."""
from __future__ import annotations
from typing import Any
from rest_framework.pagination import CursorPagination as DRFCursorPagination
from rest_framework.response import Response
__all__ = ["CursorPagination"]
class CursorPagination(DRFCursorPagination):
"""Cursor pagination with a camelCase ``pageSize`` param and envelope meta.
Defaults to ordering by ``-pk`` so it works on every model out of the box;
views with a preferred ordering override the ``ordering`` attribute.
"""
page_size = 25
max_page_size = 100
page_size_query_param = "pageSize"
cursor_query_param = "cursor"
ordering = "-pk"
def get_paginated_response(self, data: Any) -> Response:
return Response(
{
"next": self.get_next_link(),
"previous": self.get_previous_link(),
"page_size": self.page_size,
"results": data,
}
)