@cloudbase/manager-node 5.8.5 → 5.8.7-beta.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## @cloudbase/manager-node v5.8.6 版本发布 🚀(2026-09-09)
+
+- 新增 hosting 本地构建拆分 npm install 并导出构建能力供 CLI 复用
+
+---
+
+## @cloudbase/manager-node v5.8.5 版本发布 🚀(2026-09-07)
+
+- 新增 deploy 支持自定义 OpenAccessTypes 访问类型（默认值兜底，兼容存量调用）
+
+---
+
 ## @cloudbase/manager-node v5.8.4 版本发布 🚀(2026-09-02)
 
 - 新增 move declarative image config preparation to manager

package/lib/deploy/StaticDeployer.js

@@ -52,7 +52,8 @@ class StaticDeployer {
     /**
      * hosting 部署（固定静态流程，不写版本记录）
      *
-     * 支持本地构建（对齐 Netlify）：buildCommand 非空时自动执行 install + build 后上传产物；
+     * 支持本地构建：buildCommand 非空时自动执行 build 后上传产物（依赖由用户自行安装，
+     * 不代为执行 npm install）；
      * 纯静态（buildCommand 空/未配置且无法检测框架）时直接上传 outputDir（默认 root，保持现状）。
      * 访问地址 = https://{CdnDomain}{deployPath}（与 tcb hosting deploy 一致）
      */
@@ -63,7 +64,7 @@ class StaticDeployer {
         const cloudPath = config.deployPath || '/';
         // 1. 解析构建命令：显式 buildCommand > framework 映射 > package.json 自动探测 > null（纯静态）
         const buildCommand = (0, framework_1.resolveBuildCommand)(config, root);
-        // 2. 有构建命令 → 本地构建（install + build）；纯静态 → 跳过构建直接上传
+        // 2. 有构建命令 → 本地构建（仅 build，依赖由用户自行安装）；纯静态 → 跳过构建直接上传
         if (buildCommand) {
             this.runLocalBuild(root, Object.assign(Object.assign({}, config), { buildCommand }), config.envVariables);
         }
@@ -188,34 +189,27 @@ class StaticDeployer {
         }
     }
     /**
-     * 本地构建（install + build）
+     * 本地构建（仅执行 buildCommand，不安装依赖）
+     *
+     * 只跑用户的构建命令，依赖由用户自行安装（对齐业界：Vercel/Netlify/Cloudflare
+     * 均不在本地构建时代装依赖）。installCommand 不再被本地执行 —— CLI 侧通过
+     * installCommand: '' 已可跳过云端安装；本地一律不装。
      *
-     * - installCommand：默认 npm install，显式空字符串跳过安装
      * - buildCommand：由调用方保证非空（hosting 经 resolveBuildCommand 判定；app local 由 if 判定）
      * - envVariables：注入构建进程环境变量（值统一转字符串）
      */
     runLocalBuild(projectPath, config, envVariables) {
-        var _a;
-        const installCommand = (_a = config.installCommand) !== null && _a !== void 0 ? _a : 'npm install';
         const buildCommand = config.buildCommand || '';
         const env = Object.assign(Object.assign({}, process.env), stringifyEnvValues(envVariables));
-        const commands = [];
-        if (installCommand) {
-            commands.push({ cmd: installCommand, label: '安装依赖' });
-        }
-        if (buildCommand) {
-            commands.push({ cmd: buildCommand, label: '构建' });
-        }
         try {
-            for (const { cmd } of commands) {
-                (0, child_process_1.execSync)(cmd, { cwd: projectPath, stdio: 'inherit', env });
+            if (buildCommand) {
+                (0, child_process_1.execSync)(buildCommand, { cwd: projectPath, stdio: 'inherit', env });
             }
         }
         catch (e) {
             const detail = ((e === null || e === void 0 ? void 0 : e.stderr) || (e === null || e === void 0 ? void 0 : e.stdout) || (e === null || e === void 0 ? void 0 : e.message) || String(e)).toString().trim();
-            const executed = commands.map(c => c.cmd).join('」或「');
-            throw new error_1.CloudBaseError(`本地构建失败：在 ${projectPath} 执行「${executed}」失败。\n` +
-                `请先在项目目录手动执行该命令排查原因（常见原因：npm registry 网络不可达、依赖安装权限、lockfile 不一致）。\n` +
+            throw new error_1.CloudBaseError(`本地构建失败：在 ${projectPath} 执行「${buildCommand}」失败。\n` +
+                `请先在项目目录手动执行该命令排查原因（常见原因：构建脚本报错、依赖未安装、lockfile 不一致）。\n` +
                 (detail ? `原始错误：${detail.slice(0, 500)}` : ''));
         }
     }

package/lib/deploy/framework.js

@@ -38,8 +38,10 @@ exports.detectFramework = detectFramework;
 exports.resolveBuildCommand = resolveBuildCommand;
 exports.resolveOutputDir = resolveOutputDir;
 exports.resolveHostingOutputDir = resolveHostingOutputDir;
+exports.buildHostingItem = buildHostingItem;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
 /**
  * 框架 → 默认构建命令映射（hosting 本地构建 / app 云端构建复用）
  */
@@ -228,3 +230,35 @@ function resolveHostingOutputDir(config, root, readPkgFile = defaultReadPkgFile)
     }
     return config.outputDir ? path.resolve(root, config.outputDir) : root;
 }
+/**
+ * 本地构建单个 hosting 项（仅执行 buildCommand，不安装依赖，不上传）
+ *
+ * 从 StaticDeployer.runLocalBuild 提炼的纯函数版：不依赖 Environment，
+ * 供 CLI 的 tcb app build 与任何需要「只构建不上传」的调用方复用，
+ * 避免各端各自复制推断/执行逻辑。buildCommand 为空 → 直接返回 null。
+ *
+ * @param config   hosting 项配置（framework/buildCommand/outputDir，root 单独传参）
+ * @param root     项目目录（绝对路径）
+ * @returns 构建产物目录（resolveHostingOutputDir 结果）；无可构建命令返回 null
+ * @throws 构建失败时（含 stderr 摘要）
+ */
+function buildHostingItem(config, root, envVariables) {
+    const buildCommand = resolveBuildCommand(config, root);
+    if (!buildCommand) {
+        return null;
+    }
+    const env = Object.assign({}, process.env);
+    if (envVariables) {
+        for (const [key, value] of Object.entries(envVariables)) {
+            env[key] = String(value);
+        }
+    }
+    try {
+        (0, child_process_1.execSync)(buildCommand, { cwd: root, stdio: 'inherit', env });
+    }
+    catch (e) {
+        const detail = ((e === null || e === void 0 ? void 0 : e.stderr) || (e === null || e === void 0 ? void 0 : e.stdout) || (e === null || e === void 0 ? void 0 : e.message) || String(e)).toString().trim();
+        throw new Error(`本地构建失败：在 ${root} 执行「${buildCommand}」失败。\n${detail.slice(0, 500)}`);
+    }
+    return resolveHostingOutputDir(config, root);
+}

package/lib/env/index.js

@@ -828,6 +828,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，专用于域名绑定场景

package/lib/function/index.js

@@ -275,18 +275,6 @@ class FunctionService {
         this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
         this.userService = environment.getUserService();
     }
-    // 是否启用 TCB 函数接口（ENABLE_TCBF 为真时开启：true/1/yes/on，大小写不敏感）
-    get useTcbFunctionApi() {
-        return parseEnvBoolean(process.env.ENABLE_TCBF);
-    }
-    // 函数操作使用的 CloudService 实例：开关开启走 tcb，否则走 scf
-    get functionCloudService() {
-        return this.useTcbFunctionApi ? this.tcbService : this.scfService;
-    }
-    // namespace 参数名：tcb 用 EnvId，scf 用 Namespace
-    get namespaceParamKey() {
-        return this.useTcbFunctionApi ? 'EnvId' : 'Namespace';
-    }
     /**
      * 增量更新函数代码
      * @param {IUpdateFunctionIncrementalCodeParam} funcParam
@@ -332,12 +320,12 @@ class FunctionService {
      */
     async createFunction(funcParam) {
         var _a, _b, _c;
-        const { namespace } = this.getFunctionConfig();
+        const { namespace, backend } = this.getFunctionConfig();
         const { func, functionRootPath, force = false, base64Code, codeSecret, functionPath, deployMode, code } = funcParam;
         const funcName = func.name;
         const { TopicId, LogsetId } = this.getClsServiceConfig();
         const baseParams = {
-            [this.namespaceParamKey]: namespace,
+            EnvId: namespace,
             Stamp: 'MINI_QCBASE',
             ClsTopicId: TopicId,
             ClsLogsetId: LogsetId
@@ -351,11 +339,9 @@ class FunctionService {
             codeSecret,
             baseParams
         });
-        // ENABLE_TCBF 开启时，runtime 适配 tcb 风格
-        if (this.useTcbFunctionApi) {
-            if (!func.runtime) {
-                params.Runtime = 'Nodejs24.14';
-            }
+        // 统一走 tcb；默认 runtime 按环境函数后端类型设置
+        if (!func.runtime) {
+            params.Runtime = backend === 'tcb' ? 'Nodejs24.14' : 'Nodejs20.19';
         }
         const customCode = code;
         const customImageCode = customCode === null || customCode === void 0 ? void 0 : customCode.ImageConfig;
@@ -395,7 +381,7 @@ class FunctionService {
         }
         try {
             // 创建云函数
-            const res = await this.functionCloudService.request('CreateFunction', params);
+            const res = await this.tcbService.request('CreateFunction', params);
             // 等待函数状态正常
             await this.waitFunctionActive(funcName, codeSecret);
             // 创建函数触发器、失败自动重试
@@ -597,9 +583,9 @@ class FunctionService {
                 name: funcName
             });
         }
-        return await this.functionCloudService.request('DeleteFunction', {
+        return await this.tcbService.request('DeleteFunction', {
             FunctionName: funcName,
-            [this.namespaceParamKey]: namespace
+            EnvId: namespace
         });
     }
     /**
@@ -630,12 +616,13 @@ class FunctionService {
         const params = {
             FunctionName: name,
             ShowCode: 'TRUE',
-            [this.namespaceParamKey]: namespace
+            EnvId: namespace,
+            Namespace: namespace
         };
         if (codeSecret) {
             params.CodeSecret = codeSecret;
         }
-        const data = await this.functionCloudService.request('GetFunction', params);
+        const data = await this.tcbService.request('GetFunction', params);
         // 解析 VPC 配置
         const { VpcId = '', SubnetId = '' } = data.VpcConfig || {};
         if (VpcId && SubnetId) {
@@ -774,7 +761,7 @@ class FunctionService {
         const { TopicId, LogsetId } = this.getClsServiceConfig();
         // 构建参数
         const params = {
-            [this.namespaceParamKey]: namespace,
+            EnvId: namespace,
             FunctionName: func.name,
             ClsTopicId: TopicId,
             ClsLogsetId: LogsetId
@@ -787,10 +774,8 @@ class FunctionService {
                 continue;
             params[pascalKey] = toPascalCaseKeys(func[key]);
         }
-        // 特殊处理：安装依赖标志（支持 boolean | string）
-        // 注意：ENABLE_TCBF 开启时，InstallDependency 属于 UpdateFunctionCode 的参数，
-        // tcb 的 UpdateFunctionConfiguration 不认，故跳过
-        if (func.installDependency !== undefined && !this.useTcbFunctionApi) {
+        // 特殊处理：安装依赖标志（仅透传用户显式指定的值）
+        if (func.installDependency !== undefined) {
             params.InstallDependency = toBooleanString(func.installDependency);
         }
         // 特殊处理：L5 配置（支持 boolean | string）
@@ -870,7 +855,7 @@ class FunctionService {
                     console.warn(`[${func.name}] 触发器更新失败：${triggerError.message}`);
                 }
             }
-            return this.functionCloudService.request('UpdateFunctionConfiguration', params);
+            return this.tcbService.request('UpdateFunctionConfiguration', params);
         }
         catch (e) {
             throw new error_1.CloudBaseError(`[${func.name}] 更新函数配置失败：${e.message}`, {
@@ -893,7 +878,8 @@ class FunctionService {
         if (deployMode === 'image') {
             const params = {
                 FunctionName: funcName,
-                [this.namespaceParamKey]: namespace,
+                EnvId: namespace,
+                Namespace: namespace,
                 Code: {
                     ImageConfig: buildImageConfig(func.imageConfig)
                 }
@@ -904,7 +890,7 @@ class FunctionService {
             try {
                 // 等待函数状态正常
                 await this.waitFunctionActive(funcName, codeSecret);
-                return await this.functionCloudService.request('UpdateFunctionCode', params);
+                return await this.tcbService.request('UpdateFunctionCode', params);
             }
             catch (e) {
                 throw new error_1.CloudBaseError(`[${funcName}] 函数代码更新失败：${formatImageDeploymentErrorMessage(e, func.imageConfig)}`, {
@@ -921,6 +907,11 @@ class FunctionService {
         let installDependency;
         // Node 函数默认安装依赖
         installDependency = isNodeFunction(func.runtime) ? 'TRUE' : 'FALSE';
+        // Nodejs22 及以上默认不支持云端自动安装依赖，默认 FALSE（installDependency 可覆盖）
+        const nodejsVer = /^Nodejs(\d+)/i.exec(func.runtime || '');
+        if (nodejsVer && Number(nodejsVer[1]) >= 22) {
+            installDependency = 'FALSE';
+        }
         // 是否安装依赖，选项可以覆盖（支持 boolean | string）
         if (func.installDependency !== undefined) {
             installDependency = toBooleanString(func.installDependency);
@@ -935,7 +926,8 @@ class FunctionService {
             }, installDependency));
         const params = {
             FunctionName: funcName,
-            [this.namespaceParamKey]: namespace,
+            EnvId: namespace,
+            Namespace: namespace,
             Handler: func.handler || 'index.main',
             InstallDependency: installDependency,
             Code: codeParams
@@ -947,7 +939,7 @@ class FunctionService {
             // 等待函数状态正常
             await this.waitFunctionActive(funcName, codeSecret);
             // 更新云函数代码
-            const res = await this.functionCloudService.request('UpdateFunctionCode', params);
+            const res = await this.tcbService.request('UpdateFunctionCode', params);
             if (installDependency && func.isWaitInstall === true) {
                 await this.waitFunctionActive(funcName, codeSecret);
             }
@@ -1154,9 +1146,8 @@ class FunctionService {
         const { functions, envId } = options;
         const promises = functions.map(func => (async () => {
             try {
-                func.triggers.forEach(async (trigger) => {
-                    await this.deleteFunctionTrigger(func.name, trigger.name);
-                });
+                await Promise.all(func.triggers.map(trigger => this.deleteFunctionTrigger(func.name, trigger.name)));
+                (0, utils_1.successLog)(`[${func.name}] 删除云函数触发器成功！`);
             }
             catch (e) {
                 throw new error_1.CloudBaseError(e.message);
@@ -1173,11 +1164,10 @@ class FunctionService {
         const { destPath, envId, functionName, codeSecret, qualifier } = options;
         // 检验路径是否存在
         (0, utils_1.checkFullAccess)(destPath, true);
-        // 获取下载链接：ENABLE_TCBF 开启走 tcb 的 DownloadFunction，否则走 scf 的 GetFunctionAddress
-        const action = this.useTcbFunctionApi ? 'DownloadFunction' : 'GetFunctionAddress';
         const params = {
             FunctionName: functionName,
-            [this.namespaceParamKey]: envId
+            EnvId: envId,
+            Qualifier: '$LATEST'
         };
         // 指定版本时透传 Qualifier；默认 $LATEST 与现状一致
         if (qualifier) {
@@ -1186,7 +1176,7 @@ class FunctionService {
         if (codeSecret) {
             params.CodeSecret = codeSecret;
         }
-        const { Url } = await this.functionCloudService.request(action, params);
+        const { Url } = await this.tcbService.request('DownloadFunction', params);
         // 下载文件
         return (0, utils_1.downloadAndExtractRemoteZip)(Url, destPath);
     }
@@ -1201,15 +1191,14 @@ class FunctionService {
         const { namespace } = this.getFunctionConfig();
         const params = {
             FunctionName: functionName,
-            [this.namespaceParamKey]: namespace
+            EnvId: namespace,
+            Qualifier: '$LATEST'
         };
         if (codeSecret) {
             params.CodeSecret = codeSecret;
         }
         try {
-            // ENABLE_TCBF 开启走 tcb 的 DownloadFunction，否则走 scf 的 GetFunctionAddress
-            const action = this.useTcbFunctionApi ? 'DownloadFunction' : 'GetFunctionAddress';
-            const { Url, CodeSha256, RequestId } = await this.functionCloudService.request(action, params);
+            const { Url, CodeSha256, RequestId } = await this.tcbService.request('DownloadFunction', params);
             return { Url, RequestId, CodeSha256 };
         }
         catch (e) {
@@ -1228,9 +1217,9 @@ class FunctionService {
             LayerName: layerName,
             LayerVersion: layerVersion
         });
-        const res = await this.scfService.request('UpdateFunctionConfiguration', {
+        const res = await this.tcbService.request('UpdateFunctionConfiguration', {
             Layers,
-            Namespace: envId,
+            EnvId: envId,
             FunctionName: functionName
         });
         return res;
@@ -1247,7 +1236,7 @@ class FunctionService {
         // 删除指定的层
         Layers.splice(index, 1);
         const apiParams = {
-            Namespace: envId,
+            EnvId: envId,
             FunctionName: functionName,
             Layers: Layers.length > 0
                 ? Layers
@@ -1258,14 +1247,14 @@ class FunctionService {
                     }
                 ]
         };
-        return this.scfService.request('UpdateFunctionConfiguration', apiParams);
+        return this.tcbService.request('UpdateFunctionConfiguration', apiParams);
     }
     // 更新云函数层
     async updateFunctionLayer(options) {
         const { envId, functionName, layers } = options;
-        return this.scfService.request('UpdateFunctionConfiguration', {
+        return this.tcbService.request('UpdateFunctionConfiguration', {
             Layers: layers,
-            Namespace: envId,
+            EnvId: envId,
             FunctionName: functionName
         });
     }
@@ -1770,7 +1759,7 @@ class FunctionService {
      * @memberof FunctionService
      */
     getFunctionConfig() {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         const envConfig = this.environment.lazyEnvironmentConfig;
         // Functions 可能为空
         const namespace = ((_b = (_a = envConfig.Functions) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.Namespace) || '';
@@ -1787,7 +1776,8 @@ class FunctionService {
             proxy,
             appId,
             namespace,
-            env: envConfig.EnvId
+            env: envConfig.EnvId,
+            backend: ((_h = (_g = envConfig.Functions) === null || _g === void 0 ? void 0 : _g[0]) === null || _h === void 0 ? void 0 : _h.Backend) || 'scf'
         };
     }
     /**

package/lib/index.js

@@ -4,6 +4,7 @@ const environmentManager_1 = require("./environmentManager");
 const docs_1 = require("./docs");
 const projectValidator_1 = require("./projectValidator");
 const DeployOrchestrator_1 = require("./deploy/DeployOrchestrator");
+const framework_1 = require("./deploy/framework");
 class CloudBase {
     /**
      * init 初始化 为单例
@@ -188,4 +189,15 @@ class CloudBase {
         return this.context.isInternalEndpoint();
     }
 }
+// export = 模块只能通过 namespace 合并附加类型（TS 惯用法，规则见下）
+// eslint-disable-next-line @typescript-eslint/no-namespace
+(function (CloudBase) {
+    /**
+     * 声明式 hosting 构建推断与执行（CLI 侧 tcb app build / hosting 中立化复用，
+     * 避免各端复制同一套 framework 推断逻辑）。均为纯函数，不依赖环境上下文。
+     */
+    CloudBase.resolveHostingBuildCommand = framework_1.resolveBuildCommand;
+    CloudBase.resolveHostingOutputDir = framework_1.resolveHostingOutputDir;
+    CloudBase.buildHosting = framework_1.buildHostingItem;
+})(CloudBase || (CloudBase = {}));
 module.exports = CloudBase;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "5.8.5",
+    "version": "5.8.7-beta.0",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

package/types/deploy/StaticDeployer.d.ts

@@ -69,7 +69,8 @@ export declare class StaticDeployer {
     /**
      * hosting 部署（固定静态流程，不写版本记录）
      *
-     * 支持本地构建（对齐 Netlify）：buildCommand 非空时自动执行 install + build 后上传产物；
+     * 支持本地构建：buildCommand 非空时自动执行 build 后上传产物（依赖由用户自行安装，
+     * 不代为执行 npm install）；
      * 纯静态（buildCommand 空/未配置且无法检测框架）时直接上传 outputDir（默认 root，保持现状）。
      * 访问地址 = https://{CdnDomain}{deployPath}（与 tcb hosting deploy 一致）
      */
@@ -94,9 +95,12 @@ export declare class StaticDeployer {
      */
     private resolveHostingUrl;
     /**
-     * 本地构建（install + build）
+     * 本地构建（仅执行 buildCommand，不安装依赖）
+     *
+     * 只跑用户的构建命令，依赖由用户自行安装（对齐业界：Vercel/Netlify/Cloudflare
+     * 均不在本地构建时代装依赖）。installCommand 不再被本地执行 —— CLI 侧通过
+     * installCommand: '' 已可跳过云端安装；本地一律不装。
      *
-     * - installCommand：默认 npm install，显式空字符串跳过安装
      * - buildCommand：由调用方保证非空（hosting 经 resolveBuildCommand 判定；app local 由 if 判定）
      * - envVariables：注入构建进程环境变量（值统一转字符串）
      */

package/types/deploy/framework.d.ts

@@ -61,3 +61,16 @@ export declare function resolveOutputDir(config: IHostingOutputConfig, root: str
  *    - outputDir 未配置回退 root（纯静态直传）
  */
 export declare function resolveHostingOutputDir(config: IHostingOutputConfig, root: string, readPkgFile?: ReadPkgFile): string;
+/**
+ * 本地构建单个 hosting 项（仅执行 buildCommand，不安装依赖，不上传）
+ *
+ * 从 StaticDeployer.runLocalBuild 提炼的纯函数版：不依赖 Environment，
+ * 供 CLI 的 tcb app build 与任何需要「只构建不上传」的调用方复用，
+ * 避免各端各自复制推断/执行逻辑。buildCommand 为空 → 直接返回 null。
+ *
+ * @param config   hosting 项配置（framework/buildCommand/outputDir，root 单独传参）
+ * @param root     项目目录（绝对路径）
+ * @returns 构建产物目录（resolveHostingOutputDir 结果）；无可构建命令返回 null
+ * @throws 构建失败时（含 stderr 摘要）
+ */
+export declare function buildHostingItem(config: IHostingOutputConfig, root: string, envVariables?: Record<string, string | number | boolean>): string | null;

package/types/env/index.d.ts

@@ -1,6 +1,6 @@
 import { Environment } from '../environment';
 import { IResponseInfo, AuthDomain, EnvInfo, LoginConfigItem, ICheckTcbServiceRes, ICreatePostpayRes, EnvBillingInfoItem, PriceResult } from '../interfaces';
-import { CalculatePackageCreatePriceParams, CalculatePackageRenewPriceParams, CalculatePackageModifyPriceParams, DescribeHttpServiceRouteParams, DescribeHttpServiceRouteRes, VerifyHttpServiceRouteParams, VerifyHttpServiceRouteRes, CreateHttpServiceRouteParams, CreateHttpServiceRouteRes, ModifyHttpServiceRouteParams, ModifyHttpServiceRouteRes, DeleteHttpServiceRouteParams, DeleteHttpServiceRouteRes, BindCustomDomainParams, BindCustomDomainRes, DeleteCustomDomainParams, DeleteCustomDomainRes, DescribeCertificatesParams, DescribeCertificatesRes } from './type';
+import { CalculatePackageCreatePriceParams, CalculatePackageRenewPriceParams, CalculatePackageModifyPriceParams, DescribeHttpServiceRouteParams, DescribeHttpServiceRouteRes, VerifyHttpServiceRouteParams, VerifyHttpServiceRouteRes, CreateHttpServiceRouteParams, CreateHttpServiceRouteRes, ModifyHttpServiceRouteParams, ModifyHttpServiceRouteRes, DeleteHttpServiceRouteParams, DeleteHttpServiceRouteRes, PurgeHttpServiceCacheParams, PurgeHttpServiceCacheRes, DescribeHttpServiceCachePurgeTaskParams, DescribeHttpServiceCachePurgeTaskRes, BindCustomDomainParams, BindCustomDomainRes, DeleteCustomDomainParams, DeleteCustomDomainRes, DescribeCertificatesParams, DescribeCertificatesRes } from './type';
 import { CreateBillingDealParams, CreateEnvParams, BaasPackageInfo, DescribeBaasPackageListParams, ModifyEnvPlanParams, RenewEnvParams, DestroyEnvParams, DescribeEnvsParams, DescribeEnvInfoParams, DescribeEnvInfoResponse, DescribeEnvAccountCircleParams, DescribeEnvAccountCircleRes, DescribeCreditsUsageDetailParams, EnvPkgCreditsUsage } from '../interfaces/tcb.interface';
 type SOURCE = 'miniapp' | 'qcloud';
 interface IDeleteDomainRes {
@@ -922,6 +922,21 @@ export declare class EnvService {
      * @returns {Promise<DeleteHttpServiceRouteRes>}
      */
     deleteHttpServiceRoute(params: DeleteHttpServiceRouteParams): Promise<DeleteHttpServiceRouteRes>;
+    /**
+     * 清除HTTP访问服务域名缓存
+     * 支持 CDN 和 EO 两种缓存类型。CDN 仅支持 PURGE_URL 刷新方式；PURGE_PREFIX / PURGE_HOST 仅 EO 支持
+     * 清除缓存后会生成任务ID，可通过 DescribeHTTPServiceCachePurgeTask 查询任务进度和详细信息
+     * @param {PurgeHttpServiceCacheParams} params 清除缓存参数
+     * @returns {Promise<PurgeHttpServiceCacheRes>}
+     */
+    purgeHttpServiceCache(params: PurgeHttpServiceCacheParams): Promise<PurgeHttpServiceCacheRes>;
+    /**
+     * 查询HTTP访问服务域名缓存清除任务详情
+     * 通过 purgeHttpServiceCache 清除域名缓存后，可传入任务ID查询清除任务状态、时间、缓存类型等信息；也可不传任务ID查询历史任务记录
+     * @param {DescribeHttpServiceCachePurgeTaskParams} params 查询参数
+     * @returns {Promise<DescribeHttpServiceCachePurgeTaskRes>}
+     */
+    describeHttpServiceCachePurgeTask(params: DescribeHttpServiceCachePurgeTaskParams): Promise<DescribeHttpServiceCachePurgeTaskRes>;
     /**
      * 绑定自定义域名到HTTP访问服务
      * 底层调用 CreateHTTPServiceRoute API，专用于域名绑定场景

package/types/env/type.d.ts

@@ -414,6 +414,62 @@ export interface DeleteHttpServiceRouteParams {
 export interface DeleteHttpServiceRouteRes {
     RequestId: string;
 }
+/**
+ * PurgeHTTPServiceCache 请求参数
+ * 用于清除HTTP访问服务域名缓存，支持 CDN 和 EO 两种缓存类型
+ */
+export interface PurgeHttpServiceCacheParams {
+    EnvId: string;
+    Domain: string;
+    CacheType: 'CDN' | 'EO';
+    PurgeType: 'PURGE_URL' | 'PURGE_PREFIX' | 'PURGE_HOST';
+    Targets: string[];
+}
+/**
+ * PurgeHTTPServiceCache 返回结果
+ */
+export interface PurgeHttpServiceCacheRes {
+    CacheType: 'CDN' | 'EO';
+    TaskId: string;
+    RequestId: string;
+}
+/**
+ * 缓存清除任务详情
+ */
+export interface HTTPServiceCachePurgeTask {
+    TaskId: string;
+    CacheType: 'CDN' | 'EO';
+    Status: 'PROCESSING' | 'SUCCESS' | 'FAILED' | 'TIMEOUT' | 'CANCELED';
+    PurgeType: 'PURGE_URL' | 'PURGE_PREFIX' | 'PURGE_HOST';
+    Method: 'INVALIDATE' | 'DELETE';
+    Targets: string[];
+    FailReason?: string;
+    CreateTime: string;
+    UpdateTime: string;
+}
+/**
+ * DescribeHTTPServiceCachePurgeTask 请求参数
+ * 用于查询HTTPService域名缓存清除任务详情
+ */
+export interface DescribeHttpServiceCachePurgeTaskParams {
+    EnvId: string;
+    Domain: string;
+    CacheType: 'CDN' | 'EO';
+    TaskId?: string;
+    PurgeType?: 'PURGE_URL' | 'PURGE_PREFIX' | 'PURGE_HOST';
+    StartTime?: string;
+    EndTime?: string;
+    Offset?: number;
+    Limit?: number;
+}
+/**
+ * DescribeHTTPServiceCachePurgeTask 返回结果
+ */
+export interface DescribeHttpServiceCachePurgeTaskRes {
+    Tasks: HTTPServiceCachePurgeTask[];
+    TotalCount: number;
+    RequestId: string;
+}
 /**
  * 绑定自定义域名的域名参数
  * 与 HTTPServiceDomainParam 类似，但不包含 Routes（绑定域名场景）

package/types/function/index.d.ts

@@ -235,9 +235,6 @@ export declare class FunctionService {
     private tcbService;
     private userService;
     constructor(environment: Environment);
-    private get useTcbFunctionApi();
-    private get functionCloudService();
-    private get namespaceParamKey();
     /**
      * 增量更新函数代码
      * @param {IUpdateFunctionIncrementalCodeParam} funcParam

package/types/function/types.d.ts

@@ -225,6 +225,7 @@ export interface IFunctionUpdateAttribute {
     Timeout?: number;
     UseGpu?: 'FALSE' | 'TRUE';
     Namespace?: string;
+    EnvId?: string;
     Environment?: {
         Variables: IEnvVariable[];
     };

package/types/index.d.ts

@@ -25,6 +25,7 @@ import { IntegrationService } from './integration';
 import { MonitorService } from './monitor';
 import { ProjectValidator } from './projectValidator';
 import { DeployOrchestrator } from './deploy/DeployOrchestrator';
+import { resolveBuildCommand as frameworkResolveBuildCommand, resolveHostingOutputDir as frameworkResolveHostingOutputDir, buildHostingItem as frameworkBuildHostingItem } from './deploy/framework';
 interface CloudBaseConfig {
     secretId?: string;
     secretKey?: string;
@@ -127,5 +128,12 @@ declare class CloudBase {
 }
 declare namespace CloudBase {
     type RequestFn = CloudApiRequestFn;
+    /**
+     * 声明式 hosting 构建推断与执行（CLI 侧 tcb app build / hosting 中立化复用，
+     * 避免各端复制同一套 framework 推断逻辑）。均为纯函数，不依赖环境上下文。
+     */
+    const resolveHostingBuildCommand: typeof frameworkResolveBuildCommand;
+    const resolveHostingOutputDir: typeof frameworkResolveHostingOutputDir;
+    const buildHosting: typeof frameworkBuildHostingItem;
 }
 export = CloudBase;

package/types/interfaces/tcb.interface.d.ts

@@ -155,6 +155,7 @@ export interface EnvInfo {
 export interface FunctionInfo {
     Namespace?: string;
     Region?: string;
+    Backend?: string;
 }
 export interface DatabasesInfo {
     InstanceId?: string;