framework

Tầng HTTP Axios cho SDK — contentstackHTTPClient, retries, concurrency, plugins, các tiện ích 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.

Thêm skills từ contentstack

cms-assets
contentstack
Hướng dẫn các nhà phát triển cách tổ chức, phân phối và chuyển đổi tài nguyên trong Contentstack. Bao gồm cấu trúc thư mục, các phép chuyển đổi của Image Delivery API, xuất bản…
cms-branches-aliases
contentstack
Tư vấn cho nhà phát triển về cách sử dụng Contentstack branches để phát triển nội dung độc lập và aliases để triển khai nội dung không gián đoạn. Bao gồm chiến lược branch,…
cms-data-modeling-best-practices
contentstack
Hướng dẫn các nhà phát triển mô hình hóa nội dung trong Contentstack bằng cấu trúc tái sử dụng đơn giản nhất. Kỹ năng này giải thích khi nào nên sử dụng loại nội dung, tham chiếu, toàn cục…
cms-live-preview-visual-builder-support-assistant
contentstack
Chẩn đoán và hướng dẫn triển khai Contentstack Live Preview và Visual Builder. Theo dõi ngữ cảnh xem trước, xác định hợp đồng bị hỏng, và đề xuất…
cms-releases
contentstack
Tư vấn cho nhà phát triển về cách sử dụng Contentstack Releases để triển khai nội dung đồng bộ và nguyên tử. Bao gồm tạo bản phát hành, quản lý mục, triển khai theo giai đoạn,…
cms-roles-permissions
contentstack
Tư vấn cho các nhà phát triển về việc thiết kế vai trò, quyền hạn, nhóm và quyền truy cập token trong Contentstack. Giải thích vai trò tích hợp sẵn, vai trò tùy chỉnh, việc hợp nhất quyền hạn,…
cms-taxonomy
contentstack
Tư vấn cho nhà phát triển về cách sử dụng Contentstack Taxonomy để phân loại nội dung có cấu trúc, phân cấp và lọc phía phân phối. Bao gồm sự khác biệt giữa taxonomy và tags,…
cms-tokens-authentication
contentstack
Tư vấn cho nhà phát triển cách chọn phương thức xác thực Contentstack và loại token phù hợp cho các trường hợp sử dụng frontend, backend, tự động hóa và ứng dụng bên thứ ba.…