메뉴
Mental model for the Marketplace SDK — client factory, org-scoped marketplace API, auth, regions, module map
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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
| 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.