vtex-io-http-routes — скилл для Claude Code: HTTP-роуты в VTEX IO

Что делает vtex-io-http-routes

Скилл включается, когда сервису VTEX IO нужны явные HTTP-эндпоинты через роуты в service.json и обработчики в node/. Он разбирает, где проходит граница роута, как собрать цепочку middleware и как описать параметры, query, заголовки и тело запроса прямо у обработчика.

Внутри — правила решений и жёсткие ограничения с примерами кода. Обработчик должен держать контракт явным: если он сразу делегирует вызов, не проверив обязательные параметры, скилл советует остановиться и описать контракт. Повторяющиеся проверки подписи или нормализацию запроса он выносит в middleware, а не копирует по хендлерам. Долгие циклы и пакетные импорты в роуте — повод перенести работу в асинхронный поток и вернуть 202.

Есть рекомендованная раскладка файлов: node/routes/ по доменам вроде orders.ts и webhooks.ts, рядом node/middlewares/. Публичный роут считается внешним контрактом, поэтому расширять его до public без проверки валидации и авторизации не стоит. Скилл не для GraphQL, не для политик в manifest.json и не для настройки рантайма — на этих задачах он не поможет.