framework

Couche HTTP Axios pour le SDK — contentstackHTTPClient, retries, concurrency, plugins, utilitaires 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.

Plus de skills de contentstack

cms-assets
contentstack
Conseiller les développeurs sur l'organisation, la livraison et la transformation des assets dans Contentstack. Couvrir la structure des dossiers, les transformations de l'API de livraison d'images, la publication…
cms-branches-aliases
contentstack
Conseiller les développeurs sur l'utilisation des branches Contentstack pour le développement de contenu isolé et des alias pour des déploiements de contenu sans temps d'arrêt. Couvrir la stratégie de branche,…
cms-data-modeling-best-practices
contentstack
Guidez les développeurs pour modéliser le contenu dans Contentstack en utilisant la structure réutilisable la plus simple. La compétence explique quand utiliser les types de contenu, les références, les éléments globaux…
cms-live-preview-visual-builder-support-assistant
contentstack
Diagnostiquer et guider les implémentations de Contentstack Live Preview et Visual Builder. Retracer le contexte d'aperçu, identifier le contrat rompu et recommander le…
cms-releases
contentstack
Conseiller les développeurs sur l'utilisation de Contentstack Releases pour un déploiement coordonné et atomique de contenu. Couvrir la création de releases, la gestion des éléments, le déploiement par étapes,…
cms-roles-permissions
contentstack
Conseiller les développeurs sur la conception des rôles, des permissions, des équipes et de l'accès par jeton dans Contentstack. Expliquer les rôles intégrés, les rôles personnalisés, la fusion des permissions,…
cms-taxonomy
contentstack
Conseiller les développeurs sur l'utilisation de Contentstack Taxonomy pour la classification structurée et hiérarchique du contenu et le filtrage côté livraison. Couvre la taxonomie par rapport aux balises,…
cms-tokens-authentication
contentstack
Conseiller les développeurs sur le choix de la méthode d'authentification Contentstack et du type de jeton adaptés aux cas d'utilisation frontend, backend, d'automatisation et d'applications tierces.…