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

package/CHANGELOG.md

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

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);
             }
@@ -1172,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) {
@@ -1185,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);
     }
@@ -1200,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) {
@@ -1227,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;
@@ -1246,7 +1236,7 @@ class FunctionService {
         // 删除指定的层
         Layers.splice(index, 1);
         const apiParams = {
-            Namespace: envId,
+            EnvId: envId,
             FunctionName: functionName,
             Layers: Layers.length > 0
                 ? Layers
@@ -1257,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
         });
     }
@@ -1769,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) || '';
@@ -1786,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/package.json

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

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/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;