@cloudbase/manager-node 5.8.8-beta.0 → 5.8.9-beta.0

package/.coding-ci-publish-beta.yaml

@@ -0,0 +1,316 @@
+stages:
+- stage: 安装依赖
+  tasks:
+  - task: 安装依赖
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - 'bash -lc ''
+
+          set -e
+
+          export NVM_DIR="$HOME/.nvm"
+
+          [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
+
+          nvm install 22.14.0
+
+          nvm use 22.14.0
+
+          node -v
+
+          npm -v
+
+          npm install
+
+          '''
+- stage: 创建发布分支
+  tasks:
+  - task: 创建发布分支
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - set -e
+        - echo "🌿 基于 ${QCI_REPO_BRANCH} 创建发布分支 release/${MANAGER_NODE_VERSION}"
+        - git config --global user.email "cloudbase-ci-bot@tencent.com"
+        - git config --global user.name "cloudbase-ci-bot"
+        - git fetch origin ${QCI_REPO_BRANCH}
+        - git checkout -B release/${MANAGER_NODE_VERSION} origin/${QCI_REPO_BRANCH}
+        - git push origin release/${MANAGER_NODE_VERSION} --force
+        - echo "✅ 发布分支 release/${MANAGER_NODE_VERSION} 已创建并推送"
+- stage: 更新版本号
+  tasks:
+  - task: 更新版本号
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - "bash -lc ' \nset -e \nexport NVM_DIR=\"$HOME/.nvm\"\n[ -s \"$NVM_DIR/nvm.sh\"\
+          \ ] && . \"$NVM_DIR/nvm.sh\"\nnvm use 22.14.0\necho \"\U0001F4DD 更新 package.json\
+          \ version -> ${MANAGER_NODE_VERSION}\"\n# 配置 git \ngit config --global user.email\
+          \ \"cloudbase-ci-bot@tencent.com\"\ngit config --global user.name \"cloudbase-ci-bot\"\
+          \n# 切换到 release 分支 \ngit fetch origin release/${MANAGER_NODE_VERSION} \n\
+          git checkout release/${MANAGER_NODE_VERSION}\n# 更新版本号 \nnpm version ${MANAGER_NODE_VERSION}\
+          \ --no-git-tag-version --allow-same-version\n# 提交版本号变更 \ngit add package.json\
+          \ \ngit commit -m \"chore(release): bump version to ${MANAGER_NODE_VERSION}\"\
+          \ || echo \"版本号无变更\" \ngit push origin release/${MANAGER_NODE_VERSION} \n\
+          '"
+- stage: Lint 检查
+  tasks:
+  - task: Lint 检查
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - npm run lint
+- stage: 构建
+  tasks:
+  - task: 构建
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - npm run build
+- stage: 产物检查
+  tasks:
+  - task: 产物检查
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - '# 脚本内容默认是单行命令执行。'
+        - '    # 如需增加多行命令，请在开始和结束用"--"标识，例如：'
+        - '    # --'
+        - '    # if !(command -v unzip)'
+        - '    # then'
+        - '    #   yum install -y unzip'
+        - '    # fi'
+        - '    # --'
+        - '    # sh hello.sh'
+        - '# 检查构建产物是否存在'
+        - "if [ ! -f \"lib/index.js\" ]; then\n  echo \"❌ 构建产物 lib/index.js 不存在\"\n\
+          \  exit 1\nfi"
+        - "if [ ! -f \"types/index.d.ts\" ]; then\n  echo \"❌ 类型声明文件 types/index.d.ts\
+          \ 不存在\"\n  exit 1\nfi"
+        - '# 输出当前版本号供后续阶段使用'
+        - 'echo "当前发布版本: $(node -p "require(''./package.json'').version")"'
+    artifacts:
+    - ./lib/**
+- prompt:
+  - msg: 人工审批
+    detail: '欢迎使用发布流水线，请确认以下信息：
+
+      构建触发人: $QCI_TRIGGER
+
+      分支: $QCI_REPO_BRANCH
+
+      提交时间：${QCI_COMMIT_DATE}
+
+      开发人员：${QCI_COMMIT_AUTHOR}
+
+      提交信息：${QCI_COMMIT_MESSAGE}
+
+      发布版本：${MANAGER_NODE_VERSION}
+
+      请确认版本号和变更内容，审批通过后将会自动发布到 npmjs.com'
+    timeout_status: 6
+    env: {}
+    to: nenneyu;lucyqzhang;royhyang
+    if: $RELEASE_TYPE = latest
+- stage: npm 发布
+  tasks:
+  - task: npm 发布
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - '# 设置 npm registry'
+        - npm config set registry https://registry.npmjs.org
+        - '# 使用凭据注入的 NPM_TOKEN 进行认证'
+        - echo "//registry.npmjs.org/:_authToken=${YARN_NPM_AUTH_TOKEN}" > ~/.npmrc
+        - npm whoami
+        - cat ~/.npmrc
+        - npm publish --access public --tag ${RELEASE_TYPE}
+- stage: 生成并同步 changelog（docs）
+  tasks:
+  - task: 生成并同步 changelog
+    cmds:
+    - plugin: ci_changelog
+      version: 0.12.0
+      params:
+        to_ref: HEAD
+        tag_pattern: ^v(\d+\.\d+\.\d+(?:-[\w.]+)?)$
+        enable_ai_summarize: true
+        ai_model: hy3
+        bilingual: true
+        enable_docs_sync: true
+        docs_base_branch: master
+        docs_branch_prefix: docs/manager-node-changelog-v
+        commit_message: 'docs(manager-node): sync changelog for v${version}'
+        force_push: true
+        output_zh_path: $QCI_WORKSPACE/changelog_content.md
+        output_en_path: $QCI_WORKSPACE/changelog_content_en.md
+        enable_repo_changelog: false
+        repo_base_branch: master
+        repo_branch_prefix: changelog/v
+        repo_changelog_path: CHANGELOG.md
+        repo_commit_message: 'docs: update CHANGELOG.md for v${version}'
+        repo_force_push: true
+        main_package_path: package.json
+        ai_api_url: ${AI_API_URL}
+        ai_api_key: ${AI_API_KEY}
+        docs_repo: https://git.woa.com/QBase/cloudbase-docs.git
+        zh_path: docs/api-reference/manager/node/changelog.md
+        en_path: i18n/en/docusaurus-plugin-content-docs/current/api-reference/manager/node/changelog.md
+        repo_repo: https://git.woa.com/QBase/server-side-sdk/cloudbase-manager-node.git
+- stage: 生成changelog并打tag
+  tasks:
+  - task: 生成changelog并打tag
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - "bash -lc '\nset -e\nexport NVM_DIR=\"$HOME/.nvm\"\n[ -s \"$NVM_DIR/nvm.sh\"\
+          \ ] && . \"$NVM_DIR/nvm.sh\"\nnvm use 22.14.0\necho \"==========================================\"\
+          \necho \"\U0001F4E6 写回插件生成的 changelog 并打 tag v${MANAGER_NODE_VERSION}\"\
+          \necho \"==========================================\"\n# 配置 git\ngit config --global\
+          \ user.email \"cloudbase-ci-bot@tencent.com\"\ngit config --global user.name\
+          \ \"cloudbase-ci-bot\"\n# 切换到 release 分支\ngit fetch origin release/${MANAGER_NODE_VERSION}\n\
+          git checkout release/${MANAGER_NODE_VERSION}\n# 1. 写回插件生成的 changelog（仅 latest\
+          \ 版本）\necho \"\"\necho \"\U0001F4DD Step 1: 写回插件产物到 CHANGELOG.md\"\nif [ \"$RELEASE_TYPE\"\
+          \ = \"latest\" ]; then\n    if [ ! -f \"${QCI_WORKSPACE}/changelog_content.md\"\
+          \ ]; then\n        echo \"❌ 插件产物 ${QCI_WORKSPACE}/changelog_content.md 不存在\"\
+          \n        exit 1\n    fi\n    cat \"${QCI_WORKSPACE}/changelog_content.md\"\
+          \ CHANGELOG.md > CHANGELOG.md.new\n    mv CHANGELOG.md.new CHANGELOG.md\n\
+          \    # 2. 提交 changelog\n    echo \"\"\n    echo \"\U0001F4DD Step 2: 提交变更\"\
+          \n    git add CHANGELOG.md\n    git commit -m \"docs(release): changelog\
+          \ for v${MANAGER_NODE_VERSION}\" || echo \"没有需要提交的变更\"\nelse\n    echo\
+          \ \"⏭️  RELEASE_TYPE !== latest，跳过 CHANGELOG.md 写回\"\nfi\n# 3. 打 tag\necho\
+          \ \"\"\necho \"\U0001F3F7️  Step 3: 创建 tag v${MANAGER_NODE_VERSION}\"\
+          \ngit tag -a \"v${MANAGER_NODE_VERSION}\" -m \"Release v${MANAGER_NODE_VERSION}\"\
+          \n# 4. 推送分支和 tag\necho \"\"\necho \"\U0001F680 Step 4: 推送到远程\"\ngit push\
+          \ origin release/${MANAGER_NODE_VERSION}\ngit push origin \"v${MANAGER_NODE_VERSION}\"\
+          \necho \"\"\necho \"✅ 完成！\"\necho \"   - changelog.md: 已更新\"\necho \"  \
+          \ - tag: v${MANAGER_NODE_VERSION}\"\n'"
+      label: 命令行脚本
+- stage: 创建合并请求
+  tasks:
+  - task: 创建合并请求
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - 'if [[ ${RELEASE_TYPE} = "latest" ]]; then
+
+          echo "🔀 合并 release/${MANAGER_NODE_VERSION} 到 master"
+
+          # 配置 git（CI 机器人身份，使用 CI 内置 git 凭据）
+
+          git config --global user.email "cloudbase-ci-bot@tencent.com"
+
+          git config --global user.name "cloudbase-ci-bot"
+
+          # 拉取最新 master 和 release 分支
+
+          git fetch origin master
+
+          git fetch origin release/${MANAGER_NODE_VERSION}
+
+          # 切到 master 并合并 release 分支
+
+          git checkout master
+
+          git merge --no-ff origin/release/${MANAGER_NODE_VERSION} -m "chore(release):
+          v${MANAGER_NODE_VERSION}"
+
+          # 直接推送到 master（不走 MR）
+
+          git push origin master
+
+          echo "✅ 已合并并推送到 master"
+
+          fi'
+    if: $RELEASE_TYPE = latest
+- stage: 企微群通知
+  tasks:
+  - task: 企微群通知
+    cmds:
+    - plugin: message_wework_group
+      params:
+        c_type: text
+        env_variable: _WEWORK_GROUP_ID
+        mentioned: lucyqzhang;nenneyu
+        content_path: ${QCI_WORKSPACE}/changelog_content.md
+        group_id: ww150005365489083
+    if: $RELEASE_TYPE = latest
+version: '2.0'
+worker:
+  label: JOB_MATRIX_DEVCLOUD
+  language: node_js-20.18.0
+  tools:
+  - envs: []
+    name: ''
+    version: ''
+is_auto_interrupt: true
+env:
+  AI_API_KEY:
+    type: string
+    secret: vur44V/GjXswyJwv3aHGdaDKqwJRyWz+gTxPKzwIX57Q74Fhm3GML5a9yiFzkd/VsqTGvgPcRWM8995Erfj8je3c1ScSb8hTjAU89NF6pOHoPVFr5qyIsOYk35e6wS4jUXZ3Er3o/UWzWzcb28UBzHFz5X/MQtYrGKsmv4/ahaUjf1gI7tiFqJcjQPe7KLq0wbuUjiFUiBteTe+hrMiNpzBNbmyw/34TWIWr6MhLFRNqrn0gp8Dbch0T8jqf2RAl6bM42OGsUXSf42/aSHLeCL6r4FAAW2nV8QrtN4il976WzGego+pKMziofQVCq6Ol46t4tVsal074k3a47R/IgC0XYsTCdIevrAdcNyK/jhwhcaw2EOCmVBC0KZ2s3fUhzRe1IDUKEVxkRykdn5Zb2dRysI3rU+HqjGDBkbKNAD0iDLH8aoafVFi1Sl+9TxnhbG2p/gzcrDLwNR4jEarWA8Na7himZS2S7uVNuS28W1gYxkjmgnm5AqxXcB0K+SUDcRyLACzmTNLZmac4lh5z69hJk1t2mzTzXvfXGxCMuF8XXNRlQLCNs3/7xD4ibJUonL7w2F1DnUXRQN7KPdp7fIXFAG7vSao69efATK1za4KdyZOvRr4q8nwhY5uyGoMfDfmt8gRo9uDP+wnZkJNdshmf8VDNOpfzoEm4pljcI8mZo/QM/sH31ZoY2QfhLJTLquSaZhPgD1hP4OjpUCPLNNHnBfAeEJsXMiutBilbAk+xo8i/RUU+6+CGh1KOrhZQEycdx6xqdCF5WBM85jLclpMw0bWYR8aRgy2ABWCsiFqTbpO8y8IufgxZG95mp5xLs0toi6stDFG9eCJ7CFbZDKluypIxSYiv/k8vNe152KYTTrERps7Y3ox5D5ofDdZGkXULeBoC0ZGorpS2Vs2yujRnoCSN0vV8GjliosMSX0wuyh3060vFJjOOX10YP1MA9UikH3uayrTWlviI4oqZROpKryYnxRkVgcKpiyyHWidfhrRX8efh3RCIRmcBi62r5gXG2JTCYSoft92u173KadcDtY6DCdzLCSwi4jl+BEytbPNfdD/xVsqJ0mRUzxjwpfJe9DywTouytttvW541hzZrG8jblkftZIVfGfg/7wwcWHAYzmkwVyDHNOIqdBxBl270jcCT6TPb6RrW7myHfJLdxfREqmIyGd7RMKq8uf953b237HsBR36f7PoAjXH2nXZgtshwbZBAVbH6dwbwP8tsy+RYPp7JGWcCpovdh7229ZOalZFIDKwcM+MgaanMNbMuKStKeOmLskbXaDXNZ7AUfEkjFhJdXHnkSVViwooRb5dF9loC+6SAlis+kwe+t9K+supJ6OThYQ3G72crl01SJsx4qVgAmoRqw4LBEuDYHRfwC6O7UcmVgKQyRWxJHsmhRqE3f/lGuIoLXpujmWtZN4JmzodRLBv4gSRRqILIAe32jOBHvRULNY0qAOcvsDdsG3/lKDLzuRM3HkFINseIG1VMsVmfG3jnbX+OjcM1DtTxnwVcwLTCvNMjlpQEEV6P4wd2PSjXZl0b/ia1IZV6O8LMEqBQV9bPRFHcceeAXXRnCkHFkieGLAbTKNkTWsoeaphLZ9/g8XaklAbrAJTP3/9eKdYEOkEI8QOlXNskW/0VU+9XW8Hbpaz/PRetyPDvDQ6KMBurbDXxceQeeqiYslv1GjGB2/DAiyA=
+  AI_API_URL: https://test-6g2rfs50c69b7fb8.api.tcloudbasegateway.com/v1/ai/cloudbase/chat/completions
+  MANAGER_NODE_VERSION:
+    value: ''
+    type: string
+    require: true
+  RELEASE_TYPE:
+    value: beta
+    type: select
+    option: beta;latest
+  YARN_NPM_AUTH_TOKEN:
+    type: string
+    readonly: true
+    secret: xd064H3Sd1KJSDSb8UamBMLnSps8RGqvpx40l2QlN2BrirV2I5KGEYVvmJo6o9q7vt86EHlDRT5UyTIIi1golfQ3UEAYDzEUF+/nAIW93rQYeFbiHx/kZV9zuhAMeK35gM7B+IlqZoPbEIFjinnmduOUrC8BFqK+9ei23GF8POw=
+finally:
+  success:
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - "# 清理分支\nif [ \"$RELEASE_TYPE\" = \"beta\" ]; then\n    echo \"\U0001F9F9\
+          \ 清理 beta 分支\"\n    git checkout master  \n    git branch -d release/${MANAGER_NODE_VERSION}\
+          \ \n    git push origin --delete release/${MANAGER_NODE_VERSION} \n    echo\
+          \ \"✅ beta 分支已清理\"\nelse\n    echo \"⏭️  RELEASE_TYPE !== beta，跳过分支清理\"\n\
+          fi"
+      label: 清理分支
+    - plugin: message_wework_single
+      params:
+        c_type: text
+        content: '📦 @cloudbase/manager-node v${MANAGER_NODE_VERSION} 发布成功
+
+          提交: ${QCI_COMMIT_MESSAGE}
+
+          tag: v${MANAGER_NODE_VERSION}'
+        to: nenneyu;lucyqzhang
+  failure:
+    cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - "# 清理分支\nif [ \"$RELEASE_TYPE\" = \"beta\" ]; then\n    echo \"\U0001F9F9\
+          \ 清理 beta 分支\"\n    git checkout master  \n    git branch -d release/${MANAGER_NODE_VERSION}\
+          \ \n    git push origin --delete release/${MANAGER_NODE_VERSION} \n    echo\
+          \ \"✅ beta 分支已清理\"\nelse\n    echo \"⏭️  RELEASE_TYPE !== beta，跳过分支清理\"\n\
+          fi"
+      label: 清理分支
+    - plugin: message_wework_single
+      params:
+        c_type: text
+        content: '📦 @cloudbase/manager-node v${MANAGER_NODE_VERSION} 发布失败
+
+          提交: ${QCI_COMMIT_MESSAGE}
+
+          tag: v${MANAGER_NODE_VERSION}'
+        to: lucyqzhang;nenneyu
+maximum_builds: 1
+tapd_workspace_id: '20422223'

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## @cloudbase/manager-node v5.8.8 版本发布 🚀(2026-09-18)
+
+- 新增平台版套餐服务 PlatformService
+- 新增 兼容共享 COS 桶（ExternalStorage）环境
+
+---
+
+## @cloudbase/manager-node v5.8.7 版本发布 🚀(2026-09-14)
+
+- 新增 HTTP 服务缓存刷新相关 API
+- 重构 移除 ENABLE_TCBF 开关，统一走 TCB 函数接口
+
+---
+
 ## @cloudbase/manager-node v5.8.6 版本发布 🚀(2026-09-09)
 
 - 新增 hosting 本地构建拆分 npm install 并导出构建能力供 CLI 复用

package/lib/env/index.js

@@ -829,6 +829,25 @@ class EnvService {
     async deleteHttpServiceRoute(params) {
         return this.cloudService.request('DeleteHTTPServiceRoute', Object.assign({}, params));
     }
+    /**
+     * 清除HTTP访问服务域名缓存
+     * 支持 CDN 和 EO 两种缓存类型。CDN 仅支持 PURGE_URL 刷新方式；PURGE_PREFIX / PURGE_HOST 仅 EO 支持
+     * 清除缓存后会生成任务ID，可通过 DescribeHTTPServiceCachePurgeTask 查询任务进度和详细信息
+     * @param {PurgeHttpServiceCacheParams} params 清除缓存参数
+     * @returns {Promise<PurgeHttpServiceCacheRes>}
+     */
+    async purgeHttpServiceCache(params) {
+        return this.cloudService.request('PurgeHTTPServiceCache', Object.assign({}, params));
+    }
+    /**
+     * 查询HTTP访问服务域名缓存清除任务详情
+     * 通过 purgeHttpServiceCache 清除域名缓存后，可传入任务ID查询清除任务状态、时间、缓存类型等信息；也可不传任务ID查询历史任务记录
+     * @param {DescribeHttpServiceCachePurgeTaskParams} params 查询参数
+     * @returns {Promise<DescribeHttpServiceCachePurgeTaskRes>}
+     */
+    async describeHttpServiceCachePurgeTask(params) {
+        return this.cloudService.request('DescribeHTTPServiceCachePurgeTask', Object.assign({}, params));
+    }
     /**
      * 绑定自定义域名到HTTP访问服务
      * 底层调用 CreateHTTPServiceRoute API，专用于域名绑定场景
@@ -906,7 +925,9 @@ class EnvService {
     async modifyCosCorsDomain(domain, deleted = false) {
         var _a, _b, _c;
         const storage = (_b = (_a = this.environment.lazyEnvironmentConfig) === null || _a === void 0 ? void 0 : _a.Storages) === null || _b === void 0 ? void 0 : _b[0];
-        if (!(storage === null || storage === void 0 ? void 0 : storage.Bucket) && ((_c = storage === null || storage === void 0 ? void 0 : storage.ExternalStorage) === null || _c === void 0 ? void 0 : _c.Enabled) === true) {
+        // 环境未开通云存储（Storages 为空）时同样跳过：此时 getStorageConfig() 会抛错，
+        // 而调用方未 await 本方法，抛出即为未处理的 Promise rejection
+        if (!storage || (!storage.Bucket && ((_c = storage.ExternalStorage) === null || _c === void 0 ? void 0 : _c.Enabled) === true)) {
             return;
         }
         const cos = this.getCos();

package/lib/environment.js

@@ -25,6 +25,7 @@ const sandbox_1 = require("./sandbox");
 const aiModel_1 = require("./aiModel");
 const monitor_1 = require("./monitor");
 const integration_1 = require("./integration");
+const platform_1 = require("./platform");
 class Environment {
     constructor(context, envId) {
         this.inited = false;
@@ -52,6 +53,7 @@ class Environment {
         this.aiModelService = new aiModel_1.AiModelService(this);
         this.monitorService = new monitor_1.MonitorService(this);
         this.integrationService = new integration_1.IntegrationService(this);
+        this.platformService = new platform_1.PlatformService(this);
     }
     async lazyInit() {
         if (!this.inited) {
@@ -142,6 +144,12 @@ class Environment {
     getIntegrationService() {
         return this.integrationService;
     }
+    /**
+     * 获取平台版套餐服务
+     */
+    getPlatformService() {
+        return this.platformService;
+    }
     getCommonService(serviceType = 'tcb', serviceVersion) {
         return new common_1.CommonService(this, serviceType, serviceVersion);
     }

package/lib/error.js

@@ -5,12 +5,13 @@ class CloudBaseError extends Error {
     constructor(message, options = {}) {
         super();
         this.name = 'CloudBaseError';
-        const { code = '', action = '', original = null, requestId = '' } = options;
+        const { code = '', action = '', original = null, requestId = '', meta } = options;
         this.message = action ? `[${action}] ${message}` : message;
         this.original = original;
         this.code = code;
         this.requestId = requestId;
         this.action = action;
+        this.meta = meta;
     }
 }
 exports.CloudBaseError = CloudBaseError;

package/lib/hosting/index.js

@@ -459,9 +459,10 @@ class HostingService {
      * 获取配置
      */
     getHostingConfig() {
-        var _a;
+        var _a, _b;
         const envConfig = this.environment.lazyEnvironmentConfig;
-        const appId = (_a = envConfig.Storages[0]) === null || _a === void 0 ? void 0 : _a.AppId;
+        // 环境未开通云存储时 Storages 为空，取 appId 不应崩溃（托管信息不依赖 appId）
+        const appId = (_b = (_a = envConfig.Storages) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.AppId;
         const { proxy } = this.environment.cloudBaseContext;
         return {
             appId,

package/lib/index.js

@@ -151,6 +151,13 @@ class CloudBase {
     get monitor() {
         return this.currentEnvironment().getMonitorService();
     }
+    /**
+     * 平台版套餐服务
+     * 提供平台版套餐查询、环境管理、资源用量及 HTTP 访问服务路由等能力
+     */
+    get platform() {
+        return this.currentEnvironment().getPlatformService();
+    }
     get docs() {
         if (!this.docsService) {
             this.docsService = new docs_1.DocsService();

package/lib/platform/index.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlatformService = void 0;
+const error_1 = require("../error");
+const utils_1 = require("../utils");
+/**
+ * 平台版服务
+ * 提供平台版套餐查询、资源用量统计、环境生命周期管理及 HTTP 访问服务路由管理能力
+ */
+class PlatformService {
+    constructor(environment) {
+        this.environment = environment;
+        this.envId = environment.getEnvId();
+        this.cloudService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+    }
+    /**
+     * 查询在售的平台版套餐列表
+     * 返回当前可购买的平台版套餐，包括计费下单配置（BillTags）、套餐规格（Spec）等商品信息，
+     * 用于购买前的套餐查询，不涉及用户已购资源。
+     * @param {DescribePlatformPackageListParams} params 查询参数，可通过 PackageId 查询指定套餐
+     * @returns {Promise<DescribePlatformPackageListRes>} 在售套餐列表
+     */
+    async describePlatformPackageList(params = {}) {
+        return this.cloudService.request('DescribePlatformPackageList', Object.assign({}, params));
+    }
+    /**
+     * 查询当前账号下的平台版资源实例列表
+     * 返回已购平台版资源的计费信息（购买与过期时间、计费状态、自动续费），
+     * 以及存储、日志、静态托管等底层资源明细。
+     * @param {DescribePlatformsParams} params 查询参数，PlatformIds 指定实例（缺省分页返回全部），Limit 取值 [10, 100]
+     * @returns {Promise<DescribePlatformsRes>} 平台版资源列表及总数
+     * @throws {CloudBaseError} Limit 非法时抛出，须为 10 至 100 的整数
+     */
+    async describePlatforms(params = {}) {
+        const { Limit } = params;
+        if (Limit !== undefined && (!Number.isInteger(Limit) || Limit < 10 || Limit > 100)) {
+            throw new error_1.CloudBaseError('Limit 必须是 10 至 100 的整数');
+        }
+        return this.cloudService.request('DescribePlatforms', Object.assign({}, params));
+    }
+    /**
+     * 查询平台版资源当前所处的计费周期
+     * 平台版资源点按月结算，计费周期自购买日起算，每个周期各享有一笔抵扣额度。
+     * 例如 2026-01-05 购买 3 个月（2026-04-05 到期），则三个周期分别为
+     * 01-05 ~ 02-05、02-06 ~ 03-05、03-06 ~ 04-05。
+     * @param {DescribePlatformAccountCircleParams} params 查询参数，WithHistoryCircle 为 true 时附带返回最近两个历史周期
+     * @returns {Promise<DescribePlatformAccountCircleRes>} 当前周期起止时间及是否过期
+     */
+    async describePlatformAccountCircle(params) {
+        return this.cloudService.request('DescribePlatformAccountCircle', Object.assign({}, params));
+    }
+    /**
+     * 查询平台版资源的资源点用量汇总
+     * 返回指定时间范围内的资源点用量统计，包括套餐内抵扣、资源包抵扣、
+     * 按量上报、原价消耗四类总量的每日明细。
+     * @param {DescribePlatformCreditsUsageParams} params 查询参数，StartDate/EndDate 格式为 'YYYY-MM-DD'
+     * @returns {Promise<DescribePlatformCreditsUsageRes>} 四类用量总量及每日明细
+     */
+    async describePlatformCreditsUsage(params) {
+        return this.cloudService.request('DescribePlatformCreditsUsage', Object.assign({}, params));
+    }
+    /**
+     * 查询平台版资源的资源点用量明细
+     * 按模块（Usages）→ 指标（MetricUsageDetail）→ 每日明细（ValueDetailList）三个层级，
+     * 返回各模块的资源点用量及原始用量明细。
+     * @param {DescribePlatformCreditsUsageDetailParams} params 查询参数，Modules 指定查询的模块（如 FLEXDB、SCF、AI、COS 等）
+     * @returns {Promise<DescribePlatformCreditsUsageDetailRes>} 各模块的用量明细数据
+     */
+    async describePlatformCreditsUsageDetail(params) {
+        return this.cloudService.request('DescribePlatformCreditsUsageDetail', Object.assign({}, params));
+    }
+    /**
+     * 查询平台版下各环境的资源点用量排行
+     * 按 TimeRange 指定的时间范围返回各环境的资源点用量排序，
+     * 排行数据由后台定时计算，可能存在小时级延迟。
+     * @param {DescribePlatformEnvCreditsRankingParams} params 查询参数，TimeRange 缺省为 Today（近 1 天）
+     * @returns {Promise<DescribePlatformEnvCreditsRankingRes>} 环境用量排行列表及分页信息
+     */
+    async describePlatformEnvCreditsRanking(params = {}) {
+        return this.cloudService.request('DescribePlatformEnvCreditsRanking', Object.assign({}, params));
+    }
+    /**
+     * 查询平台版环境内各资源类型的用量
+     * 按资源类型（存储、函数、数据库等）返回各指标的用量及按日明细，
+     * 包括资源点用量与原始用量值及对应单位。
+     * @param {DescribePlatformEnvUsageParams} params 查询参数，EnvId 缺省时使用当前环境，ResourceTypes 指定资源类型
+     * @returns {Promise<DescribePlatformEnvUsageRes>} 资源用量明细及资源点总量
+     */
+    async describePlatformEnvUsage(params) {
+        return this.cloudService.request('DescribePlatformEnvUsage', Object.assign(Object.assign({}, params), { EnvId: params.EnvId || this.envId }));
+    }
+    /**
+     * 创建平台版环境
+     * 在已购平台版资源下开通新环境。
+     * @param {CreatePlatformEnvParams} params 创建参数，ReqKey 为幂等键，可用于防止重复创建
+     * @returns {Promise<CreatePlatformEnvRes>} 新创建环境的 EnvId
+     */
+    async createPlatformEnv(params) {
+        return this.cloudService.request('CreatePlatformEnv', Object.assign({}, params));
+    }
+    /**
+     * 修改平台版环境状态
+     * 支持启用/禁用环境，以及云存储（Storage）、FlexDB 资源的状态变更，未传入的资源不做更新。
+     * @param {ModifyPlatformEnvParams} params 修改参数，EnvId 缺省时使用当前环境
+     * @returns {Promise<ModifyPlatformEnvRes>} 环境的最终状态
+     * @throws {CloudBaseError} Status 非法时抛出，仅支持 ENABLE / DISABLE
+     */
+    async modifyPlatformEnv(params) {
+        const { Status } = params;
+        const validStatus = ['ENABLE', 'DISABLE'];
+        if (Status !== undefined && !validStatus.includes(Status)) {
+            throw new error_1.CloudBaseError(`Invalid Status value: ${Status}. Only support 'ENABLE', 'DISABLE'`);
+        }
+        return this.cloudService.request('ModifyPlatformEnv', Object.assign(Object.assign({}, params), { EnvId: params.EnvId || this.envId }));
+    }
+    /**
+     * 删除平台版环境
+     * 删除操作不可逆，须显式指定目标环境 ID。
+     * @param {DestroyPlatformEnvParams} params 删除参数，EnvId 为必填
+     * @returns {Promise<DestroyPlatformEnvRes>} 请求执行结果
+     */
+    async destroyPlatformEnv(params) {
+        return this.cloudService.request('DestroyPlatformEnv', Object.assign({}, params));
+    }
+    /**
+     * 校验 HTTP 访问服务路由配置（预检）
+     * 创建路由前的只读预检，覆盖域名归属权、证书、配额、路由冲突、域名占用等检查项，
+     * 不创建任何资源。Passed 为 true 时可调用 createPlatformHttpServiceRoute 正式创建；
+     * 为 false 时根据各检查项的 Code 定位并修正问题。
+     * 预检通过不代表创建必然成功，但预检不通过则创建必然失败。
+     * @param {VerifyPlatformHTTPServiceRouteParams} params 校验参数，包含待校验的域名路由信息
+     * @returns {Promise<VerifyPlatformHTTPServiceRouteRes>} 整体校验结果及各检查项明细
+     */
+    async verifyPlatformHttpServiceRoute(params) {
+        return this.cloudService.request('VerifyPlatformHTTPServiceRoute', Object.assign({}, params));
+    }
+    /**
+     * 创建 HTTP 访问服务路由
+     * 不传 Domain.Routes 时仅创建域名信息。域名与路由均为异步下发，创建后需调用
+     * describePlatformHttpServiceRoute 轮询域名状态，直到 SUCCESS 或 FAIL（FAIL 可删除后重新创建）；
+     * 下发完成前访问域名可能返回 404 或 HTTPS 握手失败。
+     * @param {CreatePlatformHTTPServiceRouteParams} params 创建参数
+     * @returns {Promise<CreatePlatformHTTPServiceRouteRes>} 域名归属权验证指引（归属校验未通过时返回）
+     */
+    async createPlatformHttpServiceRoute(params) {
+        return this.cloudService.request('CreatePlatformHTTPServiceRoute', Object.assign({}, params));
+    }
+    /**
+     * 修改 HTTP 访问服务路由
+     * 增量更新，对应字段未传入则不修改。
+     * @param {ModifyPlatformHTTPServiceRouteParams} params 修改参数，包含目标域名及待更新的路由信息
+     * @returns {Promise<ModifyPlatformHTTPServiceRouteRes>} 请求执行结果
+     */
+    async modifyPlatformHttpServiceRoute(params) {
+        return this.cloudService.request('ModifyPlatformHTTPServiceRoute', Object.assign({}, params));
+    }
+    /**
+     * 删除 HTTP 访问服务路由
+     * Paths 为空时删除域名及其下全部路由，非空时仅删除指定路径的路由。
+     * @param {DeletePlatformHTTPServiceRouteParams} params 删除参数，Paths 缺省时删除整个域名
+     * @returns {Promise<DeletePlatformHTTPServiceRouteRes>} 请求执行结果
+     */
+    async deletePlatformHttpServiceRoute(params) {
+        return this.cloudService.request('DeletePlatformHTTPServiceRoute', Object.assign({}, params));
+    }
+    /**
+     * 查询 HTTP 访问服务路由
+     * 返回各域名及其路由信息列表、自定义接入的源站域名及域名总数，
+     * 支持按 Domain、Path、DomainType、UpstreamResourceType 过滤及分页。
+     * @param {DescribePlatformHTTPServiceRouteParams} params 查询参数，Limit 默认 20、最大 1000
+     * @returns {Promise<DescribePlatformHTTPServiceRouteRes>} 域名路由列表及域名总数
+     */
+    async describePlatformHttpServiceRoute(params) {
+        return this.cloudService.request('DescribePlatformHTTPServiceRoute', Object.assign({}, params));
+    }
+}
+exports.PlatformService = PlatformService;

package/lib/platform/type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });