framework

HTTP-слой Axios для SDK — contentstackHTTPClient, повторные попытки, конкурентность, плагины, утилиты oauth.

npx skills add https://github.com/contentstack/contentstack-management-javascript --skill framework

Framework – HTTP / config / transport – Contentstack Management JavaScript SDK

When to use

  • Changing lib/core/ request behavior: retries, base URL, interceptors, concurrency, OAuth helpers.
  • Debugging HTTP-level issues (429, timeouts, headers).

Instructions

The SDK isolates HTTP and cross-cutting behavior under lib/core/. Use this when changing requests, retries, auth headers, or queueing — not when only adjusting a single stack resource’s URL path.

Key modules

FileResponsibility
contentstackHTTPClient.jsBuilds axios instance: baseURL, paramsSerializer (qs + JSON query), interceptors, retry behavior, ConcurrencyQueue, logHandler, retryCondition (e.g. 429)
concurrency-queue.jsLimits parallel in-flight requests (maxRequests)
contentstackError.jsMaps axios errors to enriched Error objects (redacts tokens in logged config)
errorMessages.jsUser-facing error string helpers
oauthHandler.jsOAuth-related behavior used by contentstackClient
pkceStorage.jsPKCE storage for OAuth flows
Util.jsHost checks, user agent, plugin normalization

When to change this layer

  • New global header, auth scheme, or base URL rule → HTTP client / lib/contentstack.js bootstrap.
  • Retry policy, 429, timeout defaults → contentstackHTTPClient.js (and JSDoc on client() options).
  • Concurrency → concurrency-queue.js + options from client().

Tests

  • test/unit/ContentstackHTTPClient-test.js, concurrency-Queue-test.js, contentstackError-test.js, Util-test — extend when behavior changes.

Больше skills от contentstack

cms-assets
contentstack
Консультировать разработчиков по организации, доставке и трансформации ассетов в Contentstack. Охватывать структуру папок, трансформации Image Delivery API, публикацию…
cms-branches-aliases
contentstack
Консультировать разработчиков по использованию веток Contentstack для изолированной разработки контента и алиасов для развертывания контента без простоев. Описать стратегию ветвления,…
cms-data-modeling-best-practices
contentstack
Помогите разработчикам моделировать контент в Contentstack, используя простейшую переиспользуемую структуру. Навык объясняет, когда использовать типы контента, ссылки, глобальные…
cms-live-preview-visual-builder-support-assistant
contentstack
Диагностика и сопровождение внедрений Contentstack Live Preview и Visual Builder. Прослеживание контекста предпросмотра, выявление нарушенного контракта и рекомендация…
cms-releases
contentstack
Консультировать разработчиков по использованию Contentstack Releases для скоординированного атомарного развертывания контента. Охватывать создание релизов, управление элементами, поэтапное развертывание,…
cms-roles-permissions
contentstack
Консультировать разработчиков по проектированию ролей, разрешений, команд и доступа по токенам в Contentstack. Объяснять встроенные роли, пользовательские роли, объединение разрешений,…
cms-taxonomy
contentstack
Консультирование разработчиков по использованию Contentstack Taxonomy для структурированной иерархической классификации контента и фильтрации на стороне доставки. Охватывает таксономию в сравнении с тегами,…
cms-tokens-authentication
contentstack
Консультировать разработчиков по выбору подходящего метода аутентификации Contentstack и типа токена для сценариев использования во внешнем интерфейсе, внутреннем интерфейсе, автоматизации и сторонних приложениях.…