contentstack-javascript-marketplace

作成者: contentstack

Marketplace SDKのメンタルモデル — クライアントファクトリ、組織スコープのマーケットプレイスAPI、認証、リージョン、モジュールマップ

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.

contentstackのその他のスキル

cms-assets
contentstack
開発者がContentstackでアセットを整理、配信、変換する方法についてアドバイスします。フォルダ構造、Image Delivery API変換、公開について取り上げます…
cms-branches-aliases
contentstack
Contentstackのブランチを使用した分離されたコンテンツ開発と、エイリアスを使用したダウンタイムゼロのコンテンツデプロイについて開発者にアドバイスします。ブランチ戦略、…
cms-data-modeling-best-practices
contentstack
開発者がContentstackでコンテンツをモデリングする際、最もシンプルで再利用可能な構造を用いるよう導きます。このスキルでは、コンテンツタイプ、参照、グローバル…をいつ使用すべきかを説明します。
cms-live-preview-visual-builder-support-assistant
contentstack
Contentstack Live PreviewおよびVisual Builderの実装を診断し、ガイドします。プレビューコンテキストを追跡し、壊れたコントラクトを特定して、推奨…
cms-releases
contentstack
Contentstack Releasesを使用した、調整されたアトミックなコンテンツデプロイについて開発者にアドバイスします。リリース作成、アイテム管理、段階的デプロイをカバーします…
cms-roles-permissions
contentstack
Contentstackにおけるロール、権限、チーム、トークンアクセスの設計について開発者に助言します。組み込みロール、カスタムロール、権限のマージ、…について説明します。
cms-taxonomy
contentstack
開発者に対し、構造化された階層的なコンテンツ分類と配信側フィルタリングのためのContentstack Taxonomyの使用についてアドバイスします。タクソノミーとタグの比較、…
cms-tokens-authentication
contentstack
フロントエンド、バックエンド、自動化、およびサードパーティアプリのユースケースに適したContentstack認証方法とトークンタイプの選択について、開発者にアドバイスします。…