Стандарты REST API на NestJS

engineering

api-conventions — это скилл для Claude Code, который стандартизирует проектирование REST-эндпоинтов в проекте MX Space на TypeScript/NestJS. Скилл охватывает полный цикл разработки контроллеров: использование `@ApiController` вместо `@Controller` (с автоматическим префиксом `/api/v{version}` в продакшне), декораторы аутентификации `@Auth()` и `@CurrentUser()`, глобальный `ResponseInterceptor`, оборачивающий ответы в `{ data }` или `{ data, meta }`, а также `transformResponseCase`, конвертирующий поля в snake_case на уровне транспорта. Пагинация строится через `MetaObjectBuilder` и всегда помещается в `meta`, а не в `data`; CRUD-шаблоны реализуются через `BasePgCrudFactory`. Ошибки делятся на бизнес-исключения (`BusinessException` с `ErrorCodeEnum`) и стандартные HTTP-исключения NestJS. Скилл применяется автоматически при написании контроллеров и обработке HTTP-запросов.