contentstack-javascript-marketplace

Mental model for the Marketplace SDK — client factory, org-scoped marketplace API, auth, regions, module map

npx skills add https://github.com/contentstack/contentstack-marketplace-sdk --skill contentstack-javascript-marketplace

Contentstack JavaScript Marketplace SDK

Mental model

  1. contentstack.client(options) (lib/contentstack.js) creates an axios-based HTTP client pointed at the Developer Hub host (via @contentstack/utils + region), then wraps it with contentstackClient (lib/contentstackClient.js).
  2. Auth: Pass authtoken and/or authorization, or call login to set authtoken on shared axios defaults. Optional refreshToken callback supports rotation.
  3. Marketplace entry: client.marketplace(organization_uid) returns lib/marketplace/index.js — apps (app(), findAllApps, …), installations, hosting/deployments, webhooks, OAuth under app/oauth, authorization helpers, app requests.

Where to change things

ConcernPrimary paths
Client defaults, User-Agent, region → hostlib/contentstack.js, lib/core/region.js
Login / logout / marketplace rootlib/contentstackClient.js
Axios, retries (429), timeout, query encodinglib/core/contentstackHTTPClient.js
Request queuinglib/core/concurrency-queue.js
Error shapelib/core/contentstackError.js
Marketplace resourceslib/marketplace/**/*.js
Public TypeScript typestypes/**/*.d.ts

Docs alignment

Describe behavior against Contentstack Marketplace / Developer Hub APIs. Do not document this package as CDA. Mention CMA-style tokens only when describing authtoken / management-style auth accurately.

Integration reminder

Downstream apps use @contentstack/marketplace-sdk with import contentstack from '@contentstack/marketplace-sdk' (see README). The built main field points to dist/node/... — edit lib/ and run npm run build for distributable 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