@cloudbase/manager-node 5.8.0-beta.2 → 5.8.1

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## @cloudbase/manager-node v5.8.0 版本发布 🚀(2026-08-20)
+
+- 新增 声明式部署编排（hosting 本地构建/gateway 域名绑定/certId 自动查询）
+- 新增 增加 HTTP 服务路由预校验和 SSL 证书查询能力
+- 新增 统一镜像配置校验契约
+- 新增 完善企业版 TCR 云构建链路
+- 新增 补强 Python 部署上下文与检查
+- 新增 validate explicit personal TCR credentials
+- 新增 纳入 database 迁移到声明式编排
+- 重构 降低配置守卫圈复杂度
+- 重构 统一 FunctionDeployer 并迁移镜像部署实现
+- 修复 clarify local default tag
+- 修复 improve cloud build preflight and TCR guidance
+- 修复 移除自动删除重建授权语义
+- 修复 python deploy lint
+- 修复 让云端镜像构建配置真实生效
+- 修复 处理 HTTP 协议规划器 AI 类型安全评审
+- 修复默认 HTTP 协议被误判为需要重建
+- 修复 修正 image 策略 imageType 字段路径导致个人版镜像误判
+- 补充 codeSecret 统一部署契约回归
+
+---
+
+## @cloudbase/manager-node v5.7.0 版本发布 🚀(2026-08-13)
+
+
+
+---
+
 ## @cloudbase/manager-node v5.6.8 版本发布 🚀(2026-08-11)
 
 - 新增 封装 DescribeReleaseOrder 接口

package/lib/env/index.js

@@ -28,6 +28,7 @@ class EnvService {
         this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
         this.commonService = environment.getCommonService('lowcode', '2021-01-08');
         this.billingService = new billing_1.BillingService(environment.cloudBaseContext);
+        this.certificateCloudService = new utils_1.CloudService(environment.cloudBaseContext, 'ssl', '2019-12-05');
         this.tokenCache = new Map();
     }
     /**
@@ -769,6 +770,23 @@ class EnvService {
     async describeCreditsUsageDetail(params) {
         return this.cloudService.request('DescribeCreditsUsageDetail', Object.assign({}, params));
     }
+    /**
+     * 获取当前凭证有权限访问的 SSL 证书列表。
+     *
+     * 证书用于自定义域名 HTTPS 配置，本接口不依赖 CloudBase 环境信息。
+     * @param {DescribeCertificatesParams} params 查询参数
+     * @returns {Promise<DescribeCertificatesRes>}
+     */
+    async describeCertificates(params = {}) {
+        if (params.Offset !== undefined && (!Number.isInteger(params.Offset) || params.Offset < 0)) {
+            throw new error_1.CloudBaseError('Offset 必须是大于等于 0 的整数');
+        }
+        if (params.Limit !== undefined &&
+            (!Number.isInteger(params.Limit) || params.Limit < 1 || params.Limit > 1000)) {
+            throw new error_1.CloudBaseError('Limit 必须是 1 至 1000 的整数');
+        }
+        return this.certificateCloudService.request('DescribeCertificates', params);
+    }
     /**
      * 查询HTTP访问服务域名路由信息
      * @param {DescribeHttpServiceRouteParams} params 查询参数
@@ -777,6 +795,15 @@ class EnvService {
     async describeHttpServiceRoute(params) {
         return this.cloudService.request('DescribeHTTPServiceRoute', Object.assign({}, params));
     }
+    /**
+     * 校验HTTP访问服务域名路由
+     * 此操作为只读预检，不会创建任何资源。
+     * @param {VerifyHttpServiceRouteParams} params 校验参数
+     * @returns {Promise<VerifyHttpServiceRouteRes>}
+     */
+    async verifyHttpServiceRoute(params) {
+        return this.cloudService.request('VerifyHTTPServiceRoute', Object.assign({}, params));
+    }
     /**
      * 创建HTTP访问服务域名路由
      * @param {CreateHttpServiceRouteParams} params 创建参数

package/lib/function/index.js

@@ -126,7 +126,9 @@ function formatImageDeploymentErrorMessage(error, imageConfig) {
     const isEnterprise = (imageConfig === null || imageConfig === void 0 ? void 0 : imageConfig.imageType) === 'enterprise';
     const isEnterpriseImageNotFound = haystack.includes('resourcenotfound.image') ||
         haystack.includes('describe images enterprise resource not found');
-    if (!isEnterprise || !isEnterpriseImageNotFound || message.includes(exports.ENTERPRISE_IMAGE_REGION_GUIDANCE)) {
+    if (!isEnterprise ||
+        !isEnterpriseImageNotFound ||
+        message.includes(exports.ENTERPRISE_IMAGE_REGION_GUIDANCE)) {
         return message;
     }
     return `${message}\n提示：${exports.ENTERPRISE_IMAGE_REGION_GUIDANCE}`;
@@ -140,25 +142,25 @@ function configToParams(options) {
     // key: 小写用于匹配，value: PascalCase 用于输出
     const AUTO_CONVERT_FIELDS = {
         // 基础配置
-        'description': 'Description',
-        'memorysize': 'MemorySize',
-        'timeout': 'Timeout',
-        'runtime': 'Runtime',
-        'type': 'Type', // Event/HTTP
-        'role': 'Role',
+        description: 'Description',
+        memorysize: 'MemorySize',
+        timeout: 'Timeout',
+        runtime: 'Runtime',
+        type: 'Type', // Event/HTTP
+        role: 'Role',
         // 日志配置
-        'clslogsetid': 'ClsLogsetId',
-        'clstopicid': 'ClsTopicId',
+        clslogsetid: 'ClsLogsetId',
+        clstopicid: 'ClsTopicId',
         // 高级配置
-        'deadletterconfig': 'DeadLetterConfig',
-        'publicnetconfig': 'PublicNetConfig',
-        'cfsconfig': 'CfsConfig',
-        'inittimeout': 'InitTimeout',
-        'tags': 'Tags',
+        deadletterconfig: 'DeadLetterConfig',
+        publicnetconfig: 'PublicNetConfig',
+        cfsconfig: 'CfsConfig',
+        inittimeout: 'InitTimeout',
+        tags: 'Tags',
         // 注意：asyncRunEnable/traceEnable/autoDeployClsTopicIndex/autoCreateClsTopic/dnsCache
         // 需要 'TRUE'/'FALSE' 字符串，在特殊处理阶段处理
-        'protocoltype': 'ProtocolType', // WS
-        'intranetconfig': 'IntranetConfig',
+        protocoltype: 'ProtocolType', // WS
+        intranetconfig: 'IntranetConfig'
     };
     let params = Object.assign(Object.assign({}, baseParams), { FunctionName: func.name });
     // 第一阶段：白名单字段自动转换（大小写不敏感，统一输出 PascalCase）
@@ -184,11 +186,11 @@ function configToParams(options) {
     // 3. 需要 'TRUE'/'FALSE' 字符串的布尔字段统一处理（大小写不敏感）
     // key: 小写用于匹配，value: PascalCase 用于输出
     const BOOLEAN_STRING_FIELDS = {
-        'asyncrunenable': 'AsyncRunEnable', // 异步属性
-        'traceenable': 'TraceEnable', // 事件追踪
-        'autodeployclstopicindex': 'AutoDeployClsTopicIndex', // 自动创建 CLS 索引
-        'autocreateclstopic': 'AutoCreateClsTopic', // 自动创建 CLS 主题
-        'dnscache': 'DnsCache', // Dns 缓存
+        asyncrunenable: 'AsyncRunEnable', // 异步属性
+        traceenable: 'TraceEnable', // 事件追踪
+        autodeployclstopicindex: 'AutoDeployClsTopicIndex', // 自动创建 CLS 索引
+        autocreateclstopic: 'AutoCreateClsTopic', // 自动创建 CLS 主题
+        dnscache: 'DnsCache' // Dns 缓存
     };
     for (const key of Object.keys(func)) {
         const lowerKey = key.toLowerCase();
@@ -352,7 +354,7 @@ class FunctionService {
         // ENABLE_TCBF 开启时，runtime 适配 tcb 风格
         if (this.useTcbFunctionApi) {
             if (!func.runtime) {
-                params.Runtime = 'Node.js 24.14';
+                params.Runtime = 'Nodejs24.14';
             }
         }
         const customCode = code;
@@ -360,7 +362,9 @@ class FunctionService {
         const funcImageCode = (_a = params.Code) === null || _a === void 0 ? void 0 : _a.ImageConfig;
         // 根据部署方式处理 Code 参数
         // 优先级：deployMode=image > 显式传入 code > 原有自动打包逻辑（base64Code/functionPath/functionRootPath）
-        const isImageDeploy = deployMode === 'image' || Boolean(customImageCode) || (!deployMode && Boolean(funcImageCode));
+        const isImageDeploy = deployMode === 'image' ||
+            Boolean(customImageCode) ||
+            (!deployMode && Boolean(funcImageCode));
         if (isImageDeploy) {
             // 镜像部署优先使用显式 code.ImageConfig；未传时回退到 func.imageConfig（configToParams 生成）
             if (customImageCode) {
@@ -580,9 +584,7 @@ class FunctionService {
      */
     async deleteFunction(name) {
         var _a;
-        const funcName = typeof name === 'string'
-            ? name
-            : name === null || name === void 0 ? void 0 : name.name;
+        const funcName = typeof name === 'string' ? name : name === null || name === void 0 ? void 0 : name.name;
         const { namespace } = this.getFunctionConfig();
         // 检测是否绑定了 API 网关
         const accessService = this.environment.getAccessService();
@@ -682,50 +684,50 @@ class FunctionService {
         return data;
     }
     /**
- * 获取函数日志
- * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
- * @param {{
- *         name: string
- *         offset: number
- *         limit: number
- *         order: string
- *         orderBy: string
- *         startTime: string
- *         endTime: string
- *         requestId: string
- *     }} options
- * @returns {Promise<IFunctionLogRes>}
- */
+     * 获取函数日志
+     * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
+     * @param {{
+     *         name: string
+     *         offset: number
+     *         limit: number
+     *         order: string
+     *         orderBy: string
+     *         startTime: string
+     *         endTime: string
+     *         requestId: string
+     *     }} options
+     * @returns {Promise<IFunctionLogRes>}
+     */
     async getFunctionLogs(_options) {
         throw new error_1.CloudBaseError('getFunctionLogs 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
-    * 获取函数日志 ID 列表
-    * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
-    * @param {{
-    *         name: string
-    *         offset: number
-    *         limit: number
-    *         startTime: string
-    *         endTime: string
-    *         requestId: string
-    *         qualifier: string
-    *     }} options
-    * @returns {Promise<IFunctionLogResV2>}
-    */
+     * 获取函数日志 ID 列表
+     * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
+     * @param {{
+     *         name: string
+     *         offset: number
+     *         limit: number
+     *         startTime: string
+     *         endTime: string
+     *         requestId: string
+     *         qualifier: string
+     *     }} options
+     * @returns {Promise<IFunctionLogResV2>}
+     */
     async getFunctionLogsV2(_options) {
         throw new error_1.CloudBaseError('getFunctionLogsV2 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
- * 根据函数日志 ID 查询日志详情
- * @deprecated 底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
- * @param {{
-    *         startTime: string
-    *         endTime: string
-    *         logRequestId: string
-    *     }} options
-    * @returns {Promise<IFunctionLogDetailRes>}
-    */
+     * 根据函数日志 ID 查询日志详情
+     * @deprecated 底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
+     * @param {{
+     *         startTime: string
+     *         endTime: string
+     *         logRequestId: string
+     *     }} options
+     * @returns {Promise<IFunctionLogDetailRes>}
+     */
     async getFunctionLogDetail(_options) {
         throw new error_1.CloudBaseError('getFunctionLogDetail 已废弃：底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
@@ -752,22 +754,22 @@ class FunctionService {
         // 注意：Runtime, Handler, Code, Type, ProtocolType 只能在 CreateFunction 时指定
         // key: 小写用于匹配，value: PascalCase 用于输出
         const UPDATE_CONFIG_FIELDS = {
-            'description': 'Description',
-            'memorysize': 'MemorySize',
-            'timeout': 'Timeout',
-            'role': 'Role',
+            description: 'Description',
+            memorysize: 'MemorySize',
+            timeout: 'Timeout',
+            role: 'Role',
             // 日志配置
-            'clslogsetid': 'ClsLogsetId',
-            'clstopicid': 'ClsTopicId',
+            clslogsetid: 'ClsLogsetId',
+            clstopicid: 'ClsTopicId',
             // 高级配置
-            'deadletterconfig': 'DeadLetterConfig',
-            'publicnetconfig': 'PublicNetConfig',
-            'cfsconfig': 'CfsConfig',
-            'inittimeout': 'InitTimeout',
+            deadletterconfig: 'DeadLetterConfig',
+            publicnetconfig: 'PublicNetConfig',
+            cfsconfig: 'CfsConfig',
+            inittimeout: 'InitTimeout',
             // 注意：asyncRunEnable/traceEnable/autoDeployClsTopicIndex/autoCreateClsTopic
             // 只能在 CreateFunction 时设置，UpdateFunctionConfiguration 不支持
             // 注意：dnsCache 需要 'TRUE'/'FALSE' 字符串，在特殊处理阶段处理
-            'intranetconfig': 'IntranetConfig',
+            intranetconfig: 'IntranetConfig'
         };
         const { TopicId, LogsetId } = this.getClsServiceConfig();
         // 构建参数
@@ -923,13 +925,14 @@ class FunctionService {
         if (func.installDependency !== undefined) {
             installDependency = toBooleanString(func.installDependency);
         }
-        const codeParams = customCode || await this.getCodeParams({
-            func,
-            functionPath,
-            functionRootPath,
-            base64Code,
-            deployMode
-        }, installDependency);
+        const codeParams = customCode ||
+            (await this.getCodeParams({
+                func,
+                functionPath,
+                functionRootPath,
+                base64Code,
+                deployMode
+            }, installDependency));
         const params = {
             FunctionName: funcName,
             [this.namespaceParamKey]: namespace,
@@ -1246,10 +1249,14 @@ class FunctionService {
         const apiParams = {
             Namespace: envId,
             FunctionName: functionName,
-            Layers: Layers.length > 0 ? Layers : [{
-                    LayerName: '',
-                    LayerVersion: 0
-                }]
+            Layers: Layers.length > 0
+                ? Layers
+                : [
+                    {
+                        LayerName: '',
+                        LayerVersion: 0
+                    }
+                ]
         };
         return this.scfService.request('UpdateFunctionConfiguration', apiParams);
     }
@@ -1348,7 +1355,7 @@ class FunctionService {
         let param = {
             Limit: limit,
             Offset: offset,
-            SearchKey: searchKey,
+            SearchKey: searchKey
             // SearchSrc: `TCB_${env}`
         };
         if (runtime) {
@@ -1557,7 +1564,7 @@ class FunctionService {
             Bucket: `${regionPrefix}tempcos-${constant_1.SCF_TEMP_COS.APPID}`,
             Key: tempCosObjectName,
             Region: region,
-            FilePath: zipFilePath,
+            FilePath: zipFilePath
         };
         const cos = new cos_nodejs_sdk_v5_1.default({
             getAuthorization: function (options, callback) {
@@ -1657,7 +1664,7 @@ class FunctionService {
         // 直接传入 base64Code 的情况，校验大小
         // ZipFile 上传大小上限 1.5MB，base64 编码后长度约为原始大小的 4/3
         const MAX_ZIP_SIZE = 1.5 * 1024 * 1024; // 1.5MB
-        const MAX_BASE64_LENGTH = Math.floor(MAX_ZIP_SIZE * 4 / 3); // ≈ 2097152
+        const MAX_BASE64_LENGTH = Math.floor((MAX_ZIP_SIZE * 4) / 3); // ≈ 2097152
         if ((base64Code === null || base64Code === void 0 ? void 0 : base64Code.length) > MAX_BASE64_LENGTH) {
             throw new error_1.CloudBaseError('ZipFile 上传不能大于 1.5MB，请使用 COS 上传方式');
         }
@@ -1771,10 +1778,10 @@ class FunctionService {
         // 兜底从 Storages[0] 的 AppId 或 Bucket 名提取
         // COS Bucket 格式: {BucketName}-{APPID}，APPID 为纯数字
         const storage = (_c = envConfig.Storages) === null || _c === void 0 ? void 0 : _c[0];
-        const appId = ((_d = envConfig.UserInfo) === null || _d === void 0 ? void 0 : _d.AppId)
-            || (storage === null || storage === void 0 ? void 0 : storage.AppId)
-            || ((_f = (_e = storage === null || storage === void 0 ? void 0 : storage.Bucket) === null || _e === void 0 ? void 0 : _e.match(/-(\d+)$/)) === null || _f === void 0 ? void 0 : _f[1])
-            || '';
+        const appId = ((_d = envConfig.UserInfo) === null || _d === void 0 ? void 0 : _d.AppId) ||
+            (storage === null || storage === void 0 ? void 0 : storage.AppId) ||
+            ((_f = (_e = storage === null || storage === void 0 ? void 0 : storage.Bucket) === null || _e === void 0 ? void 0 : _e.match(/-(\d+)$/)) === null || _f === void 0 ? void 0 : _f[1]) ||
+            '';
         const { proxy } = this.environment.cloudBaseContext;
         return {
             proxy,

package/lib/hosting/index.js

@@ -131,7 +131,7 @@ class HostingService {
      * @param options
      */
     async uploadFiles(options) {
-        const { localPath, cloudPath, files = [], onProgress, onFileFinish, parallel = 20, ignore = ['.DS_Store'], retryCount, retryInterval } = options;
+        const { localPath, cloudPath, entryFiles, files = [], onProgress, onFileFinish, parallel = 20, ignore = ['.DS_Store'], retryCount, retryInterval, verify = false, safe = false, prune = false } = options;
         const hosting = await this.checkStatus();
         const { Bucket, Regoin } = hosting;
         const storageService = await this.environment.getStorageService();
@@ -142,9 +142,29 @@ class HostingService {
             // 检查路径是否存在
             (0, utils_1.checkReadable)(resolvePath, true);
             if ((0, utils_1.isDirectory)(resolvePath)) {
+                if (safe || verify || prune) {
+                    return storageService.uploadDirectoryConsistent({
+                        localPath: resolvePath,
+                        cloudPath,
+                        entries: entryFiles,
+                        bucket: Bucket,
+                        region: Regoin,
+                        onProgress,
+                        onFileFinish,
+                        fileId: false,
+                        ignore,
+                        parallel,
+                        retryCount,
+                        retryInterval,
+                        verify,
+                        safe,
+                        prune
+                    });
+                }
                 return storageService.uploadDirectoryCustom({
                     localPath: resolvePath,
                     cloudPath,
+                    entryFiles,
                     bucket: Bucket,
                     region: Regoin,
                     onProgress,

package/lib/storage/helper.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.md5File = md5File;
+exports.splitEntryUploadFiles = splitEntryUploadFiles;
+const fs_1 = __importDefault(require("fs"));
+const crypto_1 = __importDefault(require("crypto"));
+const path_1 = __importDefault(require("path"));
+/**
+ * 流式计算文件 MD5（32 位小写十六进制），不将整个文件读入内存
+ */
+function md5File(filePath) {
+    return new Promise((resolve, reject) => {
+        const hash = crypto_1.default.createHash('md5');
+        const stream = fs_1.default.createReadStream(filePath);
+        stream.on('data', chunk => hash.update(chunk));
+        stream.on('error', reject);
+        stream.on('end', () => resolve(hash.digest('hex')));
+    });
+}
+/**
+ * 将目录上传文件拆分为资源组和入口组，确保入口文件最后上传
+ */
+function splitEntryUploadFiles(files, entryFiles) {
+    // 是否有自定义入口文件
+    const hasCustomEntryFiles = Array.isArray(entryFiles);
+    // 规范化入口文件路径，去除前导斜线
+    const normalizedEntryFiles = (entryFiles || [])
+        .map(item => String(item || '').trim().replace(/\\/g, '/').replace(/^\/+/, ''))
+        .filter(Boolean);
+    const resourceFiles = [];
+    const entryUploadFiles = [];
+    files.forEach(file => {
+        const normalizedCloudPath = file.cloudPath.replace(/\\/g, '/').replace(/^\/+/, '');
+        // 判断当前文件是否为入口文件
+        const isEntryFile = hasCustomEntryFiles
+            ? normalizedEntryFiles.some(entryFile => normalizedCloudPath === entryFile ||
+                normalizedCloudPath.endsWith(`/${entryFile}`))
+            : path_1.default.posix.basename(normalizedCloudPath) === 'index.html';
+        if (isEntryFile) {
+            entryUploadFiles.push(file);
+            return;
+        }
+        resourceFiles.push(file);
+    });
+    return {
+        resourceFiles,
+        entryUploadFiles
+    };
+}