framework

Axios HTTP layer for the SDK — contentstackHTTPClient, retries, concurrency, plugins, oauth utilities.

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).
  • Concurrencyconcurrency-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

brand-kit-assistant
contentstack
Advise users on Contentstack Brand Kit concepts, setup, governance, and on-brand AI generation. Route API-specific tasks to the right Brand Kit capability or…
official
cms-assets
contentstack
Консультировать разработчиков по организации, доставке и трансформации ассетов в Contentstack. Охватывать структуру папок, трансформации Image Delivery API, публикацию…
official
cms-branches-aliases
contentstack
Консультировать разработчиков по использованию веток Contentstack для изолированной разработки контента и алиасов для развертывания контента без простоев. Описать стратегию ветвления,…
official
cms-data-modeling-best-practices
contentstack
Помогите разработчикам моделировать контент в Contentstack, используя простейшую переиспользуемую структуру. Навык объясняет, когда использовать типы контента, ссылки, глобальные…
official
cms-entries
contentstack
Advise developers on querying, localizing, versioning, publishing, and structuring Contentstack entries for efficient delivery. Focus on CDA usage, reference…
official
cms-environments-publishing
contentstack
Advise developers on configuring environments, publishing content, using delivery and preview tokens, leveraging the Sync API, and understanding CDN and…
official
cms-live-preview-visual-builder-support-assistant
contentstack
Diagnose and guide Contentstack Live Preview and Visual Builder implementations. Trace preview context, identify the broken contract, and recommend the…
official
cms-localization
contentstack
Advise developers on Contentstack localization: language setup, fallback chains, localized vs unlocalized entries, non-localizable fields, and multi-locale…
official