TypeScript first
Перший SDK логічно робити для TypeScript, бо ним користуються web/mobile команди і ним простіше покрити типи OpenAPI.
Як SDK мають зʼявлятися без фальшивих пакетів, ручного drift і небезпечних default-поведінок.
SDK не замінює API contract. Він тільки зручно обгортає реалізовані endpoints і повторює їхні scopes, pagination та errors.
Перший SDK логічно робити для TypeScript, бо ним користуються web/mobile команди і ним простіше покрити типи OpenAPI.
SDK має генеруватися з OpenAPI або typed contract, щоб не розходитись із backend endpoint-ами.
Публічно не показуємо npm/composer/pip пакети, якщо вони реально не опубліковані і не підтримуються.
SDK має явно обробляти pagination, 401/403/429 і не робити нескінченних повторів без контролю клієнта.
Документація SDK має показувати, які scopes потрібні для кожного методу, щоб розробник не давав зайві права.
PHP і Python доцільні після стабілізації read/write public API і реальних запитів від інтеграторів.
Покажемо Limvero на прикладі ресторану, схожого на ваш: точки, меню, POS, кухню, QR-меню, склад, лояльність і тарифи.