用途:这是 Contentstack Marketplace SDK 的心智模型文档,帮助开发者理解该 JavaScript SDK 的整体结构与各模块职责,而非面向终端用户的功能介绍。
主要能力与结构:contentstack.client(options)(位于 lib/contentstack.js)创建一个基于 axios 的 HTTP 客户端,指向 Developer Hub 主机(通过 @contentstack/utils 与 region 决定),随后由 contentstackClient(lib/contentstackClient.js)包装。认证方面,可传入 authtoken 和/或 authorization,或调用 login 在共享 axios 默认值上设置 authtoken;可选的 refreshToken 回调支持令牌轮换。Marketplace 入口为 client.marketplace(organization_uid),返回 lib/marketplace/index.js,包含 apps(app()、findAllApps 等)、installations、hosting/deployments、webhooks、app/oauth 下的 OAuth、授权辅助方法以及 app requests。
修改位置:客户端默认值、User-Agent、region 到主机的映射在 lib/contentstack.js 与 lib/core/region.js;登录/登出与 marketplace 根在 lib/contentstackClient.js;axios、重试(429)、超时、查询编码在 lib/core/contentstackHTTPClient.js;请求排队在 lib/core/concurrency-queue.js;错误结构在 lib/core/contentstackError.js;Marketplace 资源在 lib/marketplace//*.js;公开 TypeScript 类型在 types//*.d.ts。
使用方式:下游应用通过 import contentstack from '@contentstack/marketplace-sdk' 使用(见 README)。构建后的 main 字段指向 dist/node/...,如需可分发变更应编辑 lib/ 并运行 npm run build。
限制与注意:文档应针对 Contentstack Marketplace / Developer Hub API 描述行为,不应将其记录为 CDA;仅在准确描述 authtoken / 管理式认证时提及 CMA 风格令牌。具体功能、收费、平台与效果等资料暂未提供。