Menu
Mental model for the Marketplace SDK — client factory, org-scoped marketplace API, auth, regions, module map
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | contentstack-javascript-marketplace |
| description | Mental model for the Marketplace SDK — client factory, org-scoped marketplace API, auth, regions, module map |
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).authtoken and/or authorization, or call login to set authtoken on shared axios defaults. Optional refreshToken callback supports rotation.client.marketplace(organization_uid) returns lib/marketplace/index.js — apps (app(), findAllApps, …), installations, hosting/deployments, webhooks, OAuth under app/oauth, authorization helpers, app requests.| Concern | Primary paths |
|---|---|
| Client defaults, User-Agent, region → host | lib/contentstack.js, lib/core/region.js |
| Login / logout / marketplace root | lib/contentstackClient.js |
| Axios, retries (429), timeout, query encoding | lib/core/contentstackHTTPClient.js |
| Request queuing | lib/core/concurrency-queue.js |
| Error shape | lib/core/contentstackError.js |
| Marketplace resources | lib/marketplace/**/*.js |
| Public TypeScript types | types/**/*.d.ts |
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.
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.
Use when reviewing PRs for contentstack-marketplace-sdk—API, bundles, tests, and npm publish impact.
Use for npm scripts, CI, and release flow in contentstack-marketplace-sdk.
Use for Babel presets, Webpack configs, and multi-target builds in contentstack-marketplace-sdk.
Use for Marketplace client behavior, public methods in lib/, and axios/@contentstack/utils usage.
Use for Mocha/NYC unit tests, API tests, and Jest TypeScript tests in contentstack-marketplace-sdk.
HTTP stack for marketplace-sdk — Axios wrapper, retries, concurrency, params serialization, logging hook