@cloudbase/manager-node 5.8.9-beta.1 → 5.9.1

package/.codebuddy/rules/error-code-contract.mdc

@@ -0,0 +1,13 @@
+# 错误码契约（manager-node · 本仓指引）
+
+**规则的唯一来源** → `cloudbase-cli/specs/error-rules.md`（**改规则只改那一处**；本文件只写**本仓差异**）。
+
+## 本仓差异
+
+- **字段**：三仓应有项全有（含 `docs`、`meta`）+ **本仓专属 `meta.failures`**（多项失败明细登记，见 rules §5）
+- **`docs`**：`this.docs = opts.docs ?? resolveErrorDoc(this.code, this.source)`（**类内派生**，依赖本仓 `src/error-docs.ts`）
+  > ⚠️ 映射表**只在本仓并不充分**：TB 侧错误拿不到 `docs` ⇒ 按判据 C 应走**单一来源**（文档站生成）或下沉共享基座；本仓不应成为映射表唯一归属点
+- **机制**：有 `isCloudBaseError` / `isValidErrorCode` / 8 个 helper（含 `throwCredentialError`）；**缺 `errorSourceOf`**（R3 前置，待对齐）
+- **守卫**：`test/error.test.ts`（burn-down 平衡括号 + 码表）、`test/error-no-code-baseline.json`（`{}`）
+- **本仓特殊约定**：错误对象是**对外 API**（CLI / MCP / 第三方 SDK 直接读 `.code` / `.docs` / `.meta`）⇒ 字段增删按 §3 冻结形状处理，不随基座版本漂移
+- **新增自造码 ⇒ 必须同步文档站**：到 `cloudbase-docs` 跑 `node scripts/generate-sdk-error-code-pages.mjs`（分层登记页由生成器产出，**勿手工建页**、**勿加进 `basic.md`**；详见该仓 `.codebuddy/skills/error-code-manager`）

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

@@ -138,7 +138,7 @@ stages:
   - task: 生成并同步 changelog
     cmds:
     - plugin: ci_changelog
-      version: 0.12.0
+      version: 1.1.0
       params:
         to_ref: HEAD
         tag_pattern: ^v(\d+\.\d+\.\d+(?:-[\w.]+)?)$
@@ -174,22 +174,22 @@ stages:
         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\
+          \necho \"\U0001F4E6 写回插件生成的 changelog 并打 tag v${MANAGER_NODE_VERSION}\"\n\
+          echo \"==========================================\"\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\"\
+          \ 版本）\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}\"\
+          \ 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 \"  \
@@ -237,12 +237,19 @@ stages:
   tasks:
   - task: 企微群通知
     cmds:
+    - plugin: cmds
+      params:
+        cmds:
+        - echo "📦 @cloudbase/manager-node v${MANAGER_NODE_VERSION} 发布成功" > ${QCI_WORKSPACE}/wework_message.md
+        - echo "" >> ${QCI_WORKSPACE}/wework_message.md
+        - cat ${QCI_WORKSPACE}/changelog_content.md >> ${QCI_WORKSPACE}/wework_message.md
+        - cat ${QCI_WORKSPACE}/wework_message.md
     - plugin: message_wework_group
       params:
         c_type: text
         env_variable: _WEWORK_GROUP_ID
         mentioned: lucyqzhang;nenneyu
-        content_path: ${QCI_WORKSPACE}/changelog_content.md
+        content_path: ${QCI_WORKSPACE}/wework_message.md
         group_id: ww150005365489083
     if: $RELEASE_TYPE = latest
 version: '2.0'

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## @cloudbase/manager-node v5.9.0 版本发布 🚀(2026-09-28)
+
+- 新增 错误对象契约统一与无 code 抛错清零 + 自造码文档锚点(D5)
+- 新增发布流水线配置
+
+---
+
+
 ## @cloudbase/manager-node v5.8.8 版本发布 🚀(2026-09-18)
 
 - 新增平台版套餐服务 PlatformService

package/changelog_content_en.md

@@ -0,0 +1,16 @@
+## [5.9.0] 2026-09-28
+
+- [Added] Add `ERROR_TYPES` standard error type table (6 entries) and support `type` option in `CloudBaseError` constructor (decides `code` / `source` with priority and cannot be overridden by caller); helpers now reference `ERROR_TYPES`
+- [Added] error-docs: locate self-made codes by layer registry page (returns `/error-code/<layer>#<lowercase-code>` anchor when `source` is `cli` / `toolbox` / `manager-node`); manager-node soft-fallback whitelist collapsed to layer registry page (`ready: true`)
+- [Added] Unify error object contract and clear no-`code` throws: add `CloudBaseError.toJSON()`, `ErrorSource` union type (with `'toolbox'`), `isCloudBaseError` / `isValidErrorCode`; converge 171 raw `throw new Error` to unified helpers, storage batch delete now carries `code` + `source` + `details`
+- [Added] Upgrade `@cloudbase/toolbox` to `~0.9.0`
+- [Added] Update cloud function and cloud run integration tests: replace fixed sleep with polling wait, unify jest timeout to 10 minutes, add `waitUntil` / `waitForSandboxToolSettled` helpers with fast-fail diagnostics on failed states
+- [Fixed] Fix `function` regression where throw-helper was misused in value position (`reject(throwNetError(...))`) causing Promise to never settle; now construct `new CloudBaseError(msg, { type: ERROR_TYPES.netError })` in value position
+- [Fixed] `error`: `toJSON()` normalizes numeric codes to strings (e.g. `876` ⇒ `"876"`) at output layer while `code` on object stays faithful; `NaN` / `±Infinity` fall back to `ERROR`
+- [Fixed] `error`: add ES5 prototype fallback (`Object.setPrototypeOf(this, CloudBaseError.prototype)`) to avoid lost prototype chain under third-party downlevel compilation
+- [Fixed] Address code review fixes: extract `MODEL_STATUS` constant in `aiModel`; fix `authoration` → `authorization` spelling in `environment` / `cloud-api-request`; use truthy checks in `user` validation; change `error: any` → `unknown` in `function` and use `WeakMap` for idempotency marker; use truthy checks for `customConfiguration` / `DNSConfig` in `sandbox` to avoid null pointer
+- [Fixed] `review`: fix empty `failures[0].id` null pointer when deploy report is inconsistent; narrow `description` with `typeof === 'string'` in `permission`; remove `as any` and tighten `isRetryableError` retry logic in `function`
+- [Fixed] `deploy`: downgrade image `latest` tag from block (`fail`) to hint (`warn`) since platform allows `latest` as suboptimal not mandatory failure
+- [Fixed] `error`: change enterprise image guidance idempotency from `message` text dependency to marker flag to avoid duplicate append after text mutation
+- [Fixed] `error`: governance D14/D15/D16/D22 — pass through TCR permission errors; only retry retryable errors in trigger creation; `waitFunctionActive` tolerates creation-phase `NOT_FOUND`; `toJSON()` emits `stack`
+- [Refactor] `error`: rename throw helpers to `throwXxx` form (e.g. `invalidParam` → `throwInvalidParam`) so call sites signal interruption, 494 sites / 35 files

package/changelog_content_zh.md

@@ -0,0 +1,16 @@
+## [5.9.0] 2026-09-28
+
+- [Added] 新增 `ERROR_TYPES` 标准错误类型表（6 条），`CloudBaseError` 构造器支持 `type` 选项（优先决定 `code` / `source` 且不可被调用方覆盖），helper 改引 `ERROR_TYPES`
+- [Added] error-docs：自造码按层登记页定位（`source` 为 `cli` / `toolbox` / `manager-node` 时返回 `/error-code/<layer>#<小写码名>` 锚点），manager-node 软降级白名单收敛为层级登记页（`ready: true`）
+- [Added] 错误对象契约统一与无 `code` 抛错清零：新增 `CloudBaseError.toJSON()`、`ErrorSource` 联合类型（含 `'toolbox'`）、`isCloudBaseError` / `isValidErrorCode` 识别；171 处原生 `throw new Error` 收敛为统一辅助函数，storage 批量删除补 `code` + `source` + `details`
+- [Added] 升级 `@cloudbase/toolbox` 至 `~0.9.0`
+- [Added] 更新云函数与云托管集成测试：轮询等待替代固定 sleep，jest 超时统一抬至 10 分钟，新增 `waitUntil` / `waitForSandboxToolSettled` 等辅助函数并补充失败态快速失败诊断
+- [Fixed] 修复 `function` 模块必抛 helper 误用于值位置（`reject(throwNetError(...))`）导致 Promise 永不 settle 的回归，改为值位置构造 `new CloudBaseError(msg, { type: ERROR_TYPES.netError })`
+- [Fixed] `error`: `toJSON()` 输出层将数值码归一化为字符串（如 `876` ⇒ `"876"`），对象上 `code` 保持保真；`NaN` / `±Infinity` 兜底为 `ERROR`
+- [Fixed] `error`: 补 ES5 原型兜底（`Object.setPrototypeOf(this, CloudBaseError.prototype)`），避免第三方降级编译时丢失原型链
+- [Fixed] 按代码评审修复多处问题：`aiModel` 抽 `MODEL_STATUS` 常量；`environment` / `cloud-api-request` 拼写 `authoration` → `authorization`；`user` 校验改真值判断；`function` 的 `error: any` → `unknown` 并改用 `WeakMap` 缓存幂等标记；`sandbox` 的 `customConfiguration` / `DNSConfig` 改真值判断避免空指针
+- [Fixed] `review`: 响应评审修复 `deploy` 报告不自洽时 `failures[0].id` 空指针；`permission` 的 `description` 改用 `typeof === 'string'` 收窄；`function` 去掉 `as any` 断言并收紧 `isRetryableError` 重试判定
+- [Fixed] `deploy`: 镜像 `latest` 标签由拦截（`fail`）降级为提示（`warn`），平台允许 `latest` 属次优而非必然失败
+- [Fixed] `error`: 企业版镜像排查指引幂等判断由依赖 `message` 文本改为标记位，避免文本被改动后重复追加
+- [Fixed] `error`: 治理 D14/D15/D16/D22 — TCR 权限错误透传上游；触发器创建仅重试可重试错误；`waitFunctionActive` 容忍创建期 `NOT_FOUND`；`toJSON()` 输出 `stack`
+- [Refactor] `error`: 抛错 helper 统一改名为 `throwXxx` 形态（如 `invalidParam` → `throwInvalidParam`），调用点即知会中断，共 494 处 / 35 文件

package/lib/agent/index.js

@@ -13,6 +13,7 @@ exports.AgentService = void 0;
 const cloudrun_1 = require("../cloudrun");
 const type_1 = require("../cloudrun/type");
 const utils_1 = require("../utils");
+const error_1 = require("../error");
 const path_1 = __importDefault(require("path"));
 /**
  * Agent 管理类
@@ -254,7 +255,7 @@ class AgentService {
         // 1. 查询 Agent 获取类型
         const agentListRes = await this.describeAgentList({ AgentId });
         if (!agentListRes.AgentList || agentListRes.AgentList.length === 0) {
-            throw new Error(`Agent ${AgentId} 不存在`);
+            (0, error_1.throwNotFound)(`Agent ${AgentId} 不存在`);
         }
         const agentInfo = agentListRes.AgentList[0];
         const agentType = agentInfo.AgentType;
@@ -273,7 +274,7 @@ class AgentService {
             });
         }
         else {
-            throw new Error(`不支持的 Agent 类型: ${agentType}`);
+            (0, error_1.throwInvalidParam)(`不支持的 Agent 类型: ${agentType}`);
         }
     }
     /**
@@ -333,7 +334,7 @@ class AgentService {
         // 1. 查询 Agent 获取类型
         const agentListRes = await this.describeAgentList({ AgentId });
         if (!agentListRes.AgentList || agentListRes.AgentList.length === 0) {
-            throw new Error(`Agent ${AgentId} 不存在`);
+            (0, error_1.throwNotFound)(`Agent ${AgentId} 不存在`);
         }
         const agentInfo = agentListRes.AgentList[0];
         const agentType = agentInfo.AgentType;
@@ -368,7 +369,7 @@ class AgentService {
             });
         }
         else {
-            throw new Error(`不支持的 Agent 类型: ${agentType}`);
+            (0, error_1.throwInvalidParam)(`不支持的 Agent 类型: ${agentType}`);
         }
     }
     // ==================== TCBR 云托管（内部方法，暂不对外暴露） ====================
@@ -592,7 +593,7 @@ class AgentService {
         const envConfig = this.environment.lazyEnvironmentConfig;
         // 判断 params.BotId 的数据格式是否为 ibot-xxx-xxx 的格式
         if (!/^ibot-[a-z0-9_]+-[a-z0-9_]+$/.test(BotId)) {
-            throw new Error('BotId格式应为"ibot-xxx-xxx"，其中 xxx 仅支持小写字母、数字或下划线');
+            (0, error_1.throwInvalidParam)('BotId格式应为"ibot-xxx-xxx"，其中 xxx 仅支持小写字母、数字或下划线');
         }
         // 获取函数型云托管服务的名称：ibot-xxx-xxx 中的 ibot-xxx
         const serverName = BotId.split('-').slice(0, 2).join('-');

package/lib/aiModel/index.js

@@ -8,6 +8,14 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiModelService = void 0;
 const utils_1 = require("../utils");
+const error_1 = require("../error");
+/** AI 模型分组状态（CreateAIModel / UpdateAIModel 协议值） */
+const MODEL_STATUS = {
+    /** 启用 */
+    enabled: 1,
+    /** 禁用 */
+    disabled: 2
+};
 class AiModelService {
     constructor(environment) {
         this.environment = environment;
@@ -20,13 +28,15 @@ class AiModelService {
         const { EnvId } = this.environment.lazyEnvironmentConfig;
         const { envId, groupName, baseUrl, models, remark, status, secret } = options;
         if (!groupName || groupName.trim().length === 0) {
-            throw new Error('groupName is required');
+            (0, error_1.throwInvalidParam)('groupName is required');
         }
         if (groupName.toLowerCase().startsWith('cloudbase')) {
-            throw new Error('groupName cannot start with cloudbase');
+            (0, error_1.throwInvalidParam)('groupName cannot start with cloudbase');
         }
-        if (status !== undefined && status !== 1 && status !== 2) {
-            throw new Error('status must be 1 or 2');
+        if (status !== undefined &&
+            status !== MODEL_STATUS.enabled &&
+            status !== MODEL_STATUS.disabled) {
+            (0, error_1.throwInvalidParam)(`status must be ${MODEL_STATUS.enabled} or ${MODEL_STATUS.disabled}`);
         }
         return this.tcbService.request('CreateAIModel', Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ EnvId: envId || EnvId, GroupName: groupName }, (baseUrl !== undefined ? { BaseUrl: baseUrl } : {})), (models !== undefined ? { Models: models } : {})), (remark !== undefined ? { Remark: remark } : {})), (status !== undefined ? { Status: status } : {})), (secret !== undefined ? { Secret: secret } : {})));
     }
@@ -37,10 +47,12 @@ class AiModelService {
         const { EnvId } = this.environment.lazyEnvironmentConfig;
         const { envId, groupName, baseUrl, models, remark, status, secret } = options;
         if (!groupName || groupName.trim().length === 0) {
-            throw new Error('groupName is required');
+            (0, error_1.throwInvalidParam)('groupName is required');
         }
-        if (status !== undefined && status !== 1 && status !== 2) {
-            throw new Error('status must be 1 or 2');
+        if (status !== undefined &&
+            status !== MODEL_STATUS.enabled &&
+            status !== MODEL_STATUS.disabled) {
+            (0, error_1.throwInvalidParam)(`status must be ${MODEL_STATUS.enabled} or ${MODEL_STATUS.disabled}`);
         }
         return this.tcbService.request('UpdateAIModel', Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ EnvId: envId || EnvId, GroupName: groupName }, (baseUrl !== undefined ? { BaseUrl: baseUrl } : {})), (models !== undefined ? { Models: models } : {})), (remark !== undefined ? { Remark: remark } : {})), (status !== undefined ? { Status: status } : {})), (secret !== undefined ? { Secret: secret } : {})));
     }
@@ -51,11 +63,11 @@ class AiModelService {
         const { EnvId } = this.environment.lazyEnvironmentConfig;
         const { envId, groupNames } = options;
         if (!Array.isArray(groupNames) || groupNames.length === 0) {
-            throw new Error('groupNames is required');
+            (0, error_1.throwInvalidParam)('groupNames is required');
         }
         const invalidGroupName = groupNames.find(item => typeof item !== 'string' || item.trim().length === 0);
         if (invalidGroupName !== undefined) {
-            throw new Error('groupNames contains invalid item');
+            (0, error_1.throwInvalidParam)('groupNames contains invalid item');
         }
         return this.tcbService.request('DeleteAIModel', {
             EnvId: envId || EnvId,

package/lib/cloudApp/index.js

@@ -133,11 +133,11 @@ class CloudAppService {
         const { serviceName, localPath, ignore = [], excludeNodeModules = true, onPhase } = params;
         // 1. 验证本地路径
         if (!fs_1.default.existsSync(localPath)) {
-            throw new error_1.CloudBaseError(`本地路径不存在: ${localPath}`);
+            (0, error_1.throwNotFound)(`本地路径不存在: ${localPath}`);
         }
         const stat = fs_1.default.statSync(localPath);
         if (!stat.isDirectory()) {
-            throw new error_1.CloudBaseError(`localPath 必须是目录: ${localPath}`);
+            (0, error_1.throwInvalidParam)(`localPath 必须是目录: ${localPath}`);
         }
         // 2. 打包本地文件为 ZIP（node_modules 按场景决定是否排除）
         const tmpZipPath = path_1.default.join(os_1.default.tmpdir(), `cloudapp-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`);
@@ -193,7 +193,7 @@ class CloudAppService {
                 catch (_a) {
                     // 解析失败时 errorDetail 保持空串，不影响主错误抛出
                 }
-                throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
+                (0, error_1.throwApiError)(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
             }
             onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'upload', durationMs: Date.now() - putStart, bytes: zipBuffer.length });
             // 7. 返回结果（返回 cosTimestamp，用于创建应用）
@@ -226,7 +226,7 @@ class CloudAppService {
     validateRequiredParams(params, fields) {
         for (const field of fields) {
             if (!params[field]) {
-                throw new error_1.CloudBaseError(`${field} 是必填参数`);
+                (0, error_1.throwInvalidParam)(`${field} 是必填参数`);
             }
         }
     }

package/lib/cloudrun/index.js

@@ -15,6 +15,7 @@ exports.parseObjectToDiffConfigItem = parseObjectToDiffConfigItem;
 const archiver_1 = __importDefault(require("archiver"));
 const fs_extra_1 = require("fs-extra");
 const path_1 = __importDefault(require("path"));
+const error_1 = require("../error");
 const utils_1 = require("../utils");
 const type_1 = require("./type");
 /**
@@ -46,7 +47,7 @@ class CloudRunService {
         const templates = await this.getTemplates();
         const templateData = templates.find(item => item.identifier === template);
         if (!templateData || !templateData.zipFileStore) {
-            throw new Error(`未找到匹配的模板: ${template}`);
+            (0, error_1.throwNotFound)(`未找到匹配的模板: ${template}`);
         }
         // 2. 下载并解压模板到目标目录
         const downloadUrl = templateData.zipFileStore;
@@ -75,7 +76,7 @@ class CloudRunService {
         const cloudRunServerDetailRes = await this.detail({ serverName });
         const version = (_b = (_a = cloudRunServerDetailRes.OnlineVersionInfos) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.VersionName;
         if (!version) {
-            throw new Error('未找到云托管服务版本');
+            (0, error_1.throwNotFound)('未找到云托管服务版本');
         }
         /**
          * 获取下载地址
@@ -89,7 +90,7 @@ class CloudRunService {
             await (0, utils_1.downloadAndExtractRemoteZip)(cloudBaseBuildServiceRes === null || cloudBaseBuildServiceRes === void 0 ? void 0 : cloudBaseBuildServiceRes.DownloadUrl, path_1.default.resolve(targetPath));
         }
         else {
-            throw new Error(`云托管代码下载地址为空（请求ID: ${cloudBaseBuildServiceRes.RequestId}）`);
+            (0, error_1.throwApiError)(`云托管代码下载地址为空（请求ID: ${cloudBaseBuildServiceRes.RequestId}）`);
         }
     }
     /**
@@ -116,7 +117,7 @@ class CloudRunService {
         const serverName = (_a = params === null || params === void 0 ? void 0 : params.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
         const status = (_b = params === null || params === void 0 ? void 0 : params.Status) === null || _b === void 0 ? void 0 : _b.trim();
         if (!serverName) {
-            throw new Error('Missing required parameters: ServerName');
+            (0, error_1.throwInvalidParam)('Missing required parameters: ServerName');
         }
         return this.tcbrService.request('DescribeReleaseOrder', Object.assign({ EnvId: envConfig.EnvId, ServerName: serverName }, (status ? { Status: status } : {})));
     }
@@ -148,7 +149,7 @@ class CloudRunService {
     async setTraffic(serverName, stablePercent, canaryPercent) {
         // 校验比例之和是否为100%
         if (stablePercent + canaryPercent !== 100) {
-            throw new Error('稳定版本流量比例和灰度版本流量比例之和必须等于 100');
+            (0, error_1.throwInvalidParam)('稳定版本流量比例和灰度版本流量比例之和必须等于 100');
         }
         const envConfig = this.environment.lazyEnvironmentConfig;
         const { Task } = await this.tcbrService.request('DescribeServerManageTask', {
@@ -159,7 +160,7 @@ class CloudRunService {
         // 判断是否存在灰度版本
         const isGary = (Task === null || Task === void 0 ? void 0 : Task.ReleaseType) === type_1.ReleaseTypeEnum.GRAY && (Task === null || Task === void 0 ? void 0 : Task.Status) === 'running';
         if (!isGary) {
-            throw new Error('不存在灰度中的版本或灰度版本部署未完成');
+            (0, error_1.throwApiError)('不存在灰度中的版本或灰度版本部署未完成');
         }
         // 获取当前版本和灰度版本
         const { ReleaseOrderInfo } = await this.tcbrService.request('DescribeReleaseOrder', {
@@ -242,13 +243,13 @@ class CloudRunService {
         const rollbackVersionName = (_c = params === null || params === void 0 ? void 0 : params.RollbackVersionName) === null || _c === void 0 ? void 0 : _c.trim();
         const operatorRemark = (_d = params === null || params === void 0 ? void 0 : params.OperatorRemark) === null || _d === void 0 ? void 0 : _d.trim();
         if (!serverName) {
-            throw new Error('Missing required parameters: ServerName');
+            (0, error_1.throwInvalidParam)('Missing required parameters: ServerName');
         }
         if (!currentVersionName) {
-            throw new Error('Missing required parameters: CurrentVersionName');
+            (0, error_1.throwInvalidParam)('Missing required parameters: CurrentVersionName');
         }
         if (!rollbackVersionName) {
-            throw new Error('Missing required parameters: RollbackVersionName');
+            (0, error_1.throwInvalidParam)('Missing required parameters: RollbackVersionName');
         }
         return this.tcbrService.request('SubmitServerRollback', Object.assign({ EnvId: envConfig.EnvId, ServerName: serverName, CurrentVersionName: currentVersionName, RollbackVersionName: rollbackVersionName }, (operatorRemark ? { OperatorRemark: operatorRemark } : {})));
     }
@@ -262,17 +263,17 @@ class CloudRunService {
         const envConfig = this.environment.lazyEnvironmentConfig;
         const operatorRemark = (_a = params === null || params === void 0 ? void 0 : params.OperatorRemark) === null || _a === void 0 ? void 0 : _a.trim();
         if (!Array.isArray(params === null || params === void 0 ? void 0 : params.SimpleVersions) || params.SimpleVersions.length === 0) {
-            throw new Error('Missing required parameters: SimpleVersions');
+            (0, error_1.throwInvalidParam)('Missing required parameters: SimpleVersions');
         }
         const simpleVersions = params.SimpleVersions.map((item, index) => {
             var _a, _b, _c;
             const serverName = (_a = item === null || item === void 0 ? void 0 : item.ServerName) === null || _a === void 0 ? void 0 : _a.trim();
             const versionName = (_b = item === null || item === void 0 ? void 0 : item.VersionName) === null || _b === void 0 ? void 0 : _b.trim();
             if (!serverName) {
-                throw new Error(`Invalid SimpleVersions[${index}].ServerName`);
+                (0, error_1.throwInvalidParam)(`Invalid SimpleVersions[${index}].ServerName`);
             }
             if (!versionName) {
-                throw new Error(`Invalid SimpleVersions[${index}].VersionName`);
+                (0, error_1.throwInvalidParam)(`Invalid SimpleVersions[${index}].VersionName`);
             }
             return {
                 EnvId: ((_c = item === null || item === void 0 ? void 0 : item.EnvId) === null || _c === void 0 ? void 0 : _c.trim()) || envConfig.EnvId,
@@ -294,10 +295,10 @@ class CloudRunService {
         const versionName = (_b = params === null || params === void 0 ? void 0 : params.VersionName) === null || _b === void 0 ? void 0 : _b.trim();
         const channel = (_c = params === null || params === void 0 ? void 0 : params.Channel) === null || _c === void 0 ? void 0 : _c.trim();
         if (!serverName) {
-            throw new Error('Missing required parameters: ServerName');
+            (0, error_1.throwInvalidParam)('Missing required parameters: ServerName');
         }
         if (!versionName) {
-            throw new Error('Missing required parameters: VersionName');
+            (0, error_1.throwInvalidParam)('Missing required parameters: VersionName');
         }
         return this.tcbrService.request('DescribeVersionDetail', Object.assign({ EnvId: envConfig.EnvId, ServerName: serverName, VersionName: versionName }, (channel ? { Channel: channel } : {})));
     }
@@ -359,7 +360,7 @@ class CloudRunService {
          * 参数校验和默认值设置
          */
         if (!serverName) {
-            throw new Error('Missing required parameters: serviceName');
+            (0, error_1.throwInvalidParam)('Missing required parameters: serviceName');
         }
         // 获取当前环境配置(包含EnvId)
         const envConfig = this.environment.lazyEnvironmentConfig;

package/lib/common/index.js

@@ -30,7 +30,7 @@ class CommonService {
     async call(options) {
         const { Action, Param = {} } = options;
         if (!Action) {
-            throw new error_1.CloudBaseError('缺少必填参数 Action');
+            (0, error_1.throwInvalidParam)('缺少必填参数 Action');
         }
         const res = await this.commonService.request(Action, Object.assign({}, Param));
         return res;

package/lib/database/index.js

@@ -201,7 +201,7 @@ class DatabaseService {
             fileType = path_1.default.extname(filePath).substring(1);
         }
         else {
-            throw new error_1.CloudBaseError('Miss file.filePath or file.objectKey');
+            (0, error_1.throwInvalidParam)('Miss file.filePath or file.objectKey');
         }
         if (file['FileType']) {
             fileType = file['FileType'];
@@ -217,7 +217,7 @@ class DatabaseService {
             fileType = path_1.default.extname(filePath).substring(1);
         }
         else {
-            throw new error_1.CloudBaseError('Miss file.filePath or file.objectKey');
+            (0, error_1.throwInvalidParam)('Miss file.filePath or file.objectKey');
         }
         if (file['FileType']) {
             fileType = file['FileType'];
@@ -334,17 +334,17 @@ class DatabaseService {
         var _a;
         const { EnvId, Migrations, IncludeAll } = options;
         if (!Array.isArray(Migrations) || Migrations.length === 0) {
-            throw new error_1.CloudBaseError('Migrations 至少需要 1 条');
+            (0, error_1.throwInvalidParam)('Migrations 至少需要 1 条');
         }
         for (const migration of Migrations) {
             if (!/^\d{14}$/.test(migration.Version)) {
-                throw new error_1.CloudBaseError('Migration.Version 必须是 14 位数字');
+                (0, error_1.throwInvalidParam)('Migration.Version 必须是 14 位数字');
             }
             if (!/^[a-z_]+$/.test(migration.Name)) {
-                throw new error_1.CloudBaseError('Migration.Name 只允许小写字母和下划线');
+                (0, error_1.throwInvalidParam)('Migration.Name 只允许小写字母和下划线');
             }
             if (!((_a = migration.Query) === null || _a === void 0 ? void 0 : _a.trim())) {
-                throw new error_1.CloudBaseError('Migration.Query 不能为空');
+                (0, error_1.throwInvalidParam)('Migration.Query 不能为空');
             }
         }
         return this.dbOpService.request('PreviewPGUserMigrations', Object.assign({ EnvId: EnvId || this.envId, Migrations }, (IncludeAll !== undefined ? { IncludeAll } : {})));
@@ -358,24 +358,24 @@ class DatabaseService {
         var _a;
         const { EnvId, Migrations, LockTimeoutMs, StatementTimeoutMs, IncludeAll } = options;
         if (!Array.isArray(Migrations) || Migrations.length === 0) {
-            throw new error_1.CloudBaseError('Migrations 至少需要 1 条');
+            (0, error_1.throwInvalidParam)('Migrations 至少需要 1 条');
         }
         for (const migration of Migrations) {
             if (!/^\d{14}$/.test(migration.Version)) {
-                throw new error_1.CloudBaseError('Migration.Version 必须是 14 位数字');
+                (0, error_1.throwInvalidParam)('Migration.Version 必须是 14 位数字');
             }
             if (!/^[a-z_]+$/.test(migration.Name)) {
-                throw new error_1.CloudBaseError('Migration.Name 只允许小写字母和下划线');
+                (0, error_1.throwInvalidParam)('Migration.Name 只允许小写字母和下划线');
             }
             if (!((_a = migration.Query) === null || _a === void 0 ? void 0 : _a.trim())) {
-                throw new error_1.CloudBaseError('Migration.Query 不能为空');
+                (0, error_1.throwInvalidParam)('Migration.Query 不能为空');
             }
         }
         if (LockTimeoutMs !== undefined && LockTimeoutMs < 0) {
-            throw new error_1.CloudBaseError('LockTimeoutMs 不能小于 0');
+            (0, error_1.throwInvalidParam)('LockTimeoutMs 不能小于 0');
         }
         if (StatementTimeoutMs !== undefined && StatementTimeoutMs < 0) {
-            throw new error_1.CloudBaseError('StatementTimeoutMs 不能小于 0');
+            (0, error_1.throwInvalidParam)('StatementTimeoutMs 不能小于 0');
         }
         return this.dbOpService.request('PushPGUserMigrations', Object.assign(Object.assign(Object.assign({ EnvId: EnvId || this.envId, Migrations }, (LockTimeoutMs !== undefined ? { LockTimeoutMs } : {})), (StatementTimeoutMs !== undefined ? { StatementTimeoutMs } : {})), (IncludeAll !== undefined ? { IncludeAll } : {})));
     }
@@ -387,19 +387,19 @@ class DatabaseService {
     async repairPGUserMigrationHistory(options) {
         const { EnvId, MigrationVersion, Name, Status, Reason, Query } = options;
         if (!/^\d{14}$/.test(MigrationVersion)) {
-            throw new error_1.CloudBaseError('MigrationVersion 必须是 14 位数字');
+            (0, error_1.throwInvalidParam)('MigrationVersion 必须是 14 位数字');
         }
         if (!/^[a-z_]+$/.test(Name)) {
-            throw new error_1.CloudBaseError('Name 只允许小写字母和下划线');
+            (0, error_1.throwInvalidParam)('Name 只允许小写字母和下划线');
         }
         if (Status !== 'applied' && Status !== 'reverted') {
-            throw new error_1.CloudBaseError('Status 只允许 applied 或 reverted');
+            (0, error_1.throwInvalidParam)('Status 只允许 applied 或 reverted');
         }
         if (!(Reason === null || Reason === void 0 ? void 0 : Reason.trim())) {
-            throw new error_1.CloudBaseError('Reason 不能为空');
+            (0, error_1.throwInvalidParam)('Reason 不能为空');
         }
         if (Status === 'applied' && !(Query === null || Query === void 0 ? void 0 : Query.trim())) {
-            throw new error_1.CloudBaseError('Status=applied 时 Query 不能为空');
+            (0, error_1.throwInvalidParam)('Status=applied 时 Query 不能为空');
         }
         const params = {
             EnvId: EnvId || this.envId,
@@ -421,10 +421,10 @@ class DatabaseService {
     async listPGUserMigrations(options = {}) {
         const { EnvId, Limit, Offset } = options;
         if (Limit !== undefined && (Limit < 1 || Limit > 500)) {
-            throw new error_1.CloudBaseError('Limit 取值范围为 [1, 500]');
+            (0, error_1.throwInvalidParam)('Limit 取值范围为 [1, 500]');
         }
         if (Offset !== undefined && Offset < 0) {
-            throw new error_1.CloudBaseError('Offset 不能小于 0');
+            (0, error_1.throwInvalidParam)('Offset 不能小于 0');
         }
         return this.dbOpService.request('ListPGUserMigrations', Object.assign(Object.assign({ EnvId: EnvId || this.envId }, (Limit !== undefined ? { Limit } : {})), (Offset !== undefined ? { Offset } : {})));
     }
@@ -436,7 +436,7 @@ class DatabaseService {
     async listAllPGUserMigrations(options = {}) {
         const { EnvId, PageSize = 500 } = options;
         if (PageSize < 1 || PageSize > 500) {
-            throw new error_1.CloudBaseError('PageSize 取值范围为 [1, 500]');
+            (0, error_1.throwInvalidParam)('PageSize 取值范围为 [1, 500]');
         }
         const migrations = [];
         let offset = 0;
@@ -474,7 +474,7 @@ class DatabaseService {
     async describePGUserMigration(options) {
         const { EnvId, MigrationVersion } = options;
         if (!/^\d{14}$/.test(MigrationVersion)) {
-            throw new error_1.CloudBaseError('MigrationVersion 必须是 14 位数字');
+            (0, error_1.throwInvalidParam)('MigrationVersion 必须是 14 位数字');
         }
         return this.dbOpService.request('DescribePGUserMigration', {
             EnvId: EnvId || this.envId,
@@ -489,7 +489,7 @@ class DatabaseService {
     async describeTaskResult(options) {
         const { EnvId, TaskId } = options;
         if (!(TaskId === null || TaskId === void 0 ? void 0 : TaskId.trim())) {
-            throw new error_1.CloudBaseError('TaskId 不能为空');
+            (0, error_1.throwInvalidParam)('TaskId 不能为空');
         }
         return this.dbOpService.request('DescribeTaskResult', {
             EnvId: EnvId || this.envId,
@@ -501,7 +501,7 @@ class DatabaseService {
         const currEnv = this.environment;
         const instanceId = (_c = (_b = (_a = currEnv.lazyEnvironmentConfig) === null || _a === void 0 ? void 0 : _a.Databases) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.InstanceId;
         if (!instanceId) {
-            throw new error_1.CloudBaseError('当前环境未开通文档型数据库');
+            (0, error_1.throwApiError)('当前环境未开通文档型数据库');
         }
         return instanceId;
     }