@cloudbase/manager-node 4.11.0-alpha.0 → 4.11.0-alpha.10

package/lib/env/index.js

@@ -508,6 +508,100 @@ class EnvService {
     async describeCreditsUsageDetail(params) {
         return this.cloudService.request('DescribeCreditsUsageDetail', Object.assign({}, params));
     }
+    /**
+     * 查询HTTP访问服务域名路由信息
+     * @param {DescribeHttpServiceRouteParams} params 查询参数
+     * @returns {Promise<DescribeHttpServiceRouteRes>}
+     */
+    async describeHttpServiceRoute(params) {
+        return this.cloudService.request('DescribeHTTPServiceRoute', Object.assign({}, params));
+    }
+    /**
+     * 创建HTTP访问服务域名路由
+     * @param {CreateHttpServiceRouteParams} params 创建参数
+     * @returns {Promise<CreateHttpServiceRouteRes>}
+     */
+    async createHttpServiceRoute(params) {
+        return this.cloudService.request('CreateHTTPServiceRoute', Object.assign({}, params));
+    }
+    /**
+     * 修改HTTP访问服务域名路由
+     * @param {ModifyHttpServiceRouteParams} params 修改参数
+     * @returns {Promise<ModifyHttpServiceRouteRes>}
+     */
+    async modifyHttpServiceRoute(params) {
+        return this.cloudService.request('ModifyHTTPServiceRoute', Object.assign({}, params));
+    }
+    /**
+     * 删除HTTP访问服务域名路由
+     * @param {DeleteHttpServiceRouteParams} params 删除参数
+     * @returns {Promise<DeleteHttpServiceRouteRes>}
+     */
+    async deleteHttpServiceRoute(params) {
+        return this.cloudService.request('DeleteHTTPServiceRoute', Object.assign({}, params));
+    }
+    /**
+     * 绑定自定义域名到HTTP访问服务
+     * 底层调用 CreateHTTPServiceRoute API，专用于域名绑定场景
+     * @param {BindCustomDomainParams} params 绑定参数
+     * @returns {Promise<BindCustomDomainRes>}
+     */
+    async bindCustomDomain(params) {
+        const { EnvId, Domain } = params;
+        // 构建域名参数，设置默认值
+        const domainParam = {
+            Domain: Domain.Domain,
+            CertId: Domain.CertId,
+            AccessType: Domain.AccessType || 'DIRECT',
+            Protocol: Domain.Protocol || 'HTTP_AND_HTTPS',
+            Enable: Domain.Enable !== undefined ? Domain.Enable : true
+        };
+        // 自定义接入类型时需要传入 CustomCname
+        if (domainParam.AccessType === 'CUSTOM' && Domain.CustomCname) {
+            domainParam.CustomCname = Domain.CustomCname;
+        }
+        return this.cloudService.request('CreateHTTPServiceRoute', {
+            EnvId,
+            Domain: domainParam
+        });
+    }
+    /**
+     * 删除自定义域名
+     * 仅当域名下无路由绑定时可删除，否则抛出错误
+     * @param {DeleteCustomDomainParams} params 删除参数
+     * @returns {Promise<DeleteCustomDomainRes>}
+     */
+    async deleteCustomDomain(params) {
+        const { EnvId, Domain } = params;
+        // 先查询域名下是否有路由绑定
+        const queryRes = await this.describeHttpServiceRoute({
+            EnvId,
+            Filters: [
+                {
+                    Name: 'Domain',
+                    Values: [Domain]
+                }
+            ],
+            Limit: 1
+        });
+        // 检查域名是否存在
+        const domains = queryRes.Domains || [];
+        const targetDomain = domains.find(d => d.Domain === Domain);
+        if (!targetDomain) {
+            throw new error_1.CloudBaseError(`域名 ${Domain} 不存在`);
+        }
+        // 检查域名下是否有路由绑定
+        const routes = targetDomain.Routes || [];
+        if (routes.length > 0) {
+            const routePaths = routes.map(r => r.Path).join(', ');
+            throw new error_1.CloudBaseError(`域名 ${Domain} 下还有 ${routes.length} 个路由绑定（${routePaths}），请先删除路由后再删除域名`);
+        }
+        // 无路由绑定，可以删除域名
+        return this.cloudService.request('DeleteHTTPServiceRoute', {
+            EnvId,
+            Domain
+        });
+    }
     // 获取 COS CORS 域名
     async getCOSDomains() {
         const cos = this.getCos();

package/lib/environment.js

@@ -8,6 +8,7 @@ const agent_1 = require("./agent");
 const storage_1 = require("./storage");
 const env_1 = require("./env");
 const common_1 = require("./common");
+const log_1 = require("./log");
 const error_1 = require("./error");
 const constant_1 = require("./constant");
 const utils_1 = require("./utils");
@@ -16,6 +17,9 @@ const third_1 = require("./third");
 const access_1 = require("./access");
 const user_1 = require("./user");
 const cloudBaseRun_1 = require("./cloudBaseRun");
+const mysql_1 = require("./mysql");
+const cloudApp_1 = require("./cloudApp");
+const permission_1 = require("./permission");
 class Environment {
     constructor(context, envId) {
         this.inited = false;
@@ -30,11 +34,15 @@ class Environment {
         this.databaseService = new database_1.DatabaseService(this);
         this.storageService = new storage_1.StorageService(this);
         this.envService = new env_1.EnvService(this);
+        this.logService = new log_1.LogService(this);
         this.hostingService = new hosting_1.HostingService(this);
         this.thirdService = new third_1.ThirdService(this);
         this.accessService = new access_1.AccessService(this);
         this.userService = new user_1.UserService(this);
         this.cloudBaseRunService = new cloudBaseRun_1.CloudBaseRunService(this);
+        this.mysqlService = new mysql_1.MysqlService(this);
+        this.permissionService = new permission_1.PermissionService(this);
+        this.cloudAppService = new cloudApp_1.CloudAppService(this);
     }
     async lazyInit() {
         if (!this.inited) {
@@ -76,6 +84,9 @@ class Environment {
     getEnvService() {
         return this.envService;
     }
+    getLogService() {
+        return this.logService;
+    }
     getHostingService() {
         return this.hostingService;
     }
@@ -91,6 +102,15 @@ class Environment {
     getCloudBaseRunService() {
         return this.cloudBaseRunService;
     }
+    getMysqlService() {
+        return this.mysqlService;
+    }
+    getCloudAppService() {
+        return this.cloudAppService;
+    }
+    getPermissionService() {
+        return this.permissionService;
+    }
     getCommonService(serviceType = 'tcb', serviceVersion) {
         return new common_1.CommonService(this, serviceType, serviceVersion);
     }

package/lib/function/index.js

@@ -488,22 +488,25 @@ class FunctionService {
      * @param {string} qualifier 需要删除的版本号，不填默认删除函数下全部版本。
      * @returns {Promise<IResponseInfo>}
      */
-    async deleteFunction({ name }) {
+    async deleteFunction(name) {
         var _a;
+        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();
         const res = await accessService.getAccessList({
-            name
+            name: funcName
         });
         // 删除绑定的 API 网关
         if (((_a = res === null || res === void 0 ? void 0 : res.APISet) === null || _a === void 0 ? void 0 : _a.length) > 0) {
             await accessService.deleteAccess({
-                name
+                name: funcName
             });
         }
-        await this.scfService.request('DeleteFunction', {
-            FunctionName: name,
+        return await this.scfService.request('DeleteFunction', {
+            FunctionName: funcName,
             Namespace: namespace
         });
     }
@@ -741,10 +744,13 @@ class FunctionService {
             // 注意：dnsCache 需要 'TRUE'/'FALSE' 字符串，在特殊处理阶段处理
             'intranetconfig': 'IntranetConfig',
         };
+        const { TopicId, LogsetId } = this.getClsServiceConfig();
         // 构建参数
         const params = {
             Namespace: namespace,
-            FunctionName: func.name
+            FunctionName: func.name,
+            ClsTopicId: TopicId,
+            ClsLogsetId: LogsetId
         };
         // 白名单字段自动转换（大小写不敏感，统一输出 PascalCase）
         for (const key of Object.keys(func)) {
@@ -918,6 +924,56 @@ class FunctionService {
             });
         }
     }
+    /**
+     * 更新函数代码和配置（带进度信息）
+     * 支持同时更新代码和配置，按顺序执行：等待就绪 → 更新代码 → 等待就绪 → 更新配置 → 等待就绪
+     * @param options 更新选项
+     * @returns 更新结果，包含耗时信息
+     */
+    async updateFunctionWithProgress(options) {
+        const { name, code, config } = options;
+        const startTime = Date.now();
+        const details = [];
+        // codeSecret 在不同阶段可能不同：
+        // - 更新代码前/后：用旧的 codeSecret（函数此时还是旧密钥）
+        // - 更新配置后：如果 config 中带了新 codeSecret，函数密钥已变更，需用新值
+        const oldCodeSecret = (code === null || code === void 0 ? void 0 : code.codeSecret) || (config === null || config === void 0 ? void 0 : config.codeSecret);
+        const newCodeSecret = (config === null || config === void 0 ? void 0 : config.codeSecret) || (code === null || code === void 0 ? void 0 : code.codeSecret);
+        // 1. 等待函数状态就绪（此时函数还是旧密钥）
+        details.push('等待函数状态就绪...');
+        await this.waitFunctionActive(name, oldCodeSecret);
+        details.push(`函数状态就绪 (${Math.round((Date.now() - startTime) / 1000)}s)`);
+        // 2. 更新代码
+        if (code && (code.functionPath || code.base64Code)) {
+            details.push('开始更新代码...');
+            await this.updateFunctionCode(Object.assign({ func: {
+                    name,
+                    // 从 config 取公共字段
+                    runtime: config === null || config === void 0 ? void 0 : config.runtime,
+                    installDependency: config === null || config === void 0 ? void 0 : config.installDependency,
+                    ignore: config === null || config === void 0 ? void 0 : config.ignore,
+                    codeSecret: oldCodeSecret
+                } }, code));
+            details.push(`代码更新完成 (${Math.round((Date.now() - startTime) / 1000)}s)`);
+            // 等待函数再次就绪（代码更新不改变 codeSecret，仍用旧值）
+            await this.waitFunctionActive(name, oldCodeSecret);
+        }
+        // 3. 更新配置
+        if (config) {
+            details.push('开始更新配置...');
+            await this.updateFunctionConfig(Object.assign({ name }, config));
+            details.push(`配置更新完成 (${Math.round((Date.now() - startTime) / 1000)}s)`);
+            // 等待函数再次就绪（配置更新后 codeSecret 可能已变更，用新值）
+            await this.waitFunctionActive(name, newCodeSecret);
+        }
+        const elapsedTime = Date.now() - startTime;
+        details.push(`全部更新完成 (${Math.round(elapsedTime / 1000)}s)`);
+        return {
+            elapsedTime,
+            message: `更新成功，总耗时 ${Math.round(elapsedTime / 1000)}s`,
+            details
+        };
+    }
     /**
      * 调用云函数
      * @param {string} name 云函数名称
@@ -1047,13 +1103,12 @@ class FunctionService {
     async deleteFunctionTrigger(name, triggerName) {
         const { namespace } = this.getFunctionConfig();
         try {
-            await this.scfService.request('DeleteTrigger', {
+            return await this.scfService.request('DeleteTrigger', {
                 FunctionName: name,
                 Namespace: namespace,
                 TriggerName: triggerName,
                 Type: 'timer'
             });
-            (0, utils_1.successLog)(`[${name}] 删除云函数触发器 ${triggerName} 成功！`);
         }
         catch (e) {
             throw new error_1.CloudBaseError(`[${name}] 删除触发器失败：${e.message}`);
@@ -1466,7 +1521,13 @@ class FunctionService {
             }
         });
         return new Promise((resolve, reject) => {
+            // 添加超时保护
+            const timeout = setTimeout(() => {
+                packer.clean();
+                reject(new error_1.CloudBaseError(`[${func.name}] COS 上传超时（60秒）`));
+            }, 60000);
             cos.sliceUploadFile(uploadParams, async (err, data) => {
+                clearTimeout(timeout);
                 // 清理临时文件
                 await packer.clean();
                 if (err) {
@@ -1545,29 +1606,6 @@ class FunctionService {
             UnixTimestamp
         };
     }
-    async createAccessPath(name, path) {
-        const access = this.environment.getAccessService();
-        try {
-            await access.createAccess({
-                name,
-                path
-            });
-        }
-        catch (e) {
-            // 当 Path 存在时，校验 Path 绑定的函数是不是当前函数
-            if (e.code === 'InvalidParameter.APICreated') {
-                const { APISet } = await access.getAccessList({
-                    name
-                });
-                if ((APISet === null || APISet === void 0 ? void 0 : APISet[0].Name) !== name || (APISet === null || APISet === void 0 ? void 0 : APISet[0].Type) !== 1) {
-                    throw e;
-                }
-            }
-            else {
-                throw e;
-            }
-        }
-    }
     async getCodeParams(options, installDependency) {
         const { func, functionPath, functionRootPath, base64Code, deployMode } = options;
         // 直接传入 base64Code 的情况，校验大小
@@ -1620,6 +1658,29 @@ class FunctionService {
             TempCosObjectName: `/${legacyResult.Key}`
         };
     }
+    async createAccessPath(name, path) {
+        const access = this.environment.getAccessService();
+        try {
+            await access.createAccess({
+                name,
+                path
+            });
+        }
+        catch (e) {
+            // 当 Path 存在时，校验 Path 绑定的函数是不是当前函数
+            if (e.code === 'InvalidParameter.APICreated') {
+                const { APISet } = await access.getAccessList({
+                    name
+                });
+                if ((APISet === null || APISet === void 0 ? void 0 : APISet[0].Name) !== name || (APISet === null || APISet === void 0 ? void 0 : APISet[0].Type) !== 1) {
+                    throw e;
+                }
+            }
+            else {
+                throw e;
+            }
+        }
+    }
     // 获取 COS 临时信息
     async getTempCosInfo(name) {
         const { env, appId } = await this.getFunctionConfig();
@@ -1750,6 +1811,9 @@ __decorate([
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "updateFunctionCode", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], FunctionService.prototype, "updateFunctionWithProgress", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "invokeFunction", null);
@@ -1824,10 +1888,10 @@ __decorate([
 ], FunctionService.prototype, "uploadFunctionZipToCos", null);
 __decorate([
     (0, utils_1.preLazy)()
-], FunctionService.prototype, "createAccessPath", null);
+], FunctionService.prototype, "getCodeParams", null);
 __decorate([
     (0, utils_1.preLazy)()
-], FunctionService.prototype, "getCodeParams", null);
+], FunctionService.prototype, "createAccessPath", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "getTempCosInfo", null);

package/lib/index.js

@@ -1,6 +1,7 @@
 "use strict";
 const context_1 = require("./context");
 const environmentManager_1 = require("./environmentManager");
+const docs_1 = require("./docs");
 class CloudBase {
     /**
      * init 初始化 为单例
@@ -66,21 +67,61 @@ class CloudBase {
     get access() {
         return this.currentEnvironment().getAccessService();
     }
+    get mysql() {
+        return this.currentEnvironment().getMysqlService();
+    }
+    /**
+     * 云托管服务（CloudBaseRun）
+     * 提供云托管版本流量配置等能力
+     * @deprecated 请使用 cloudBaseRun 代替，避免与 cloudAppService 混淆
+     */
     get cloudApp() {
         return this.currentEnvironment().getCloudBaseRunService();
     }
+    /**
+     * 云托管服务（CloudBaseRun）
+     * 提供云托管版本流量配置等能力
+     */
+    get cloudBaseRun() {
+        return this.currentEnvironment().getCloudBaseRunService();
+    }
+    /**
+     * 云应用服务（CloudApp 统一部署）
+     * 提供 Web 应用的创建、部署、版本管理等能力
+     */
+    get cloudAppService() {
+        return this.currentEnvironment().getCloudAppService();
+    }
+    /**
+     * 获取云应用服务
+     */
+    getCloudAppService() {
+        return this.currentEnvironment().getCloudAppService();
+    }
     commonService(service, version) {
         return this.currentEnvironment().getCommonService(service, version);
     }
     get env() {
         return this.currentEnvironment().getEnvService();
     }
+    get log() {
+        return this.currentEnvironment().getLogService();
+    }
     get third() {
         return this.currentEnvironment().getThirdService();
     }
     get user() {
         return this.currentEnvironment().getUserService();
     }
+    get permission() {
+        return this.currentEnvironment().getPermissionService();
+    }
+    get docs() {
+        if (!this.docsService) {
+            this.docsService = new docs_1.DocsService();
+        }
+        return this.docsService;
+    }
     getEnvironmentManager() {
         return this.environmentManager;
     }

package/lib/interfaces/cloudApp.interface.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * CloudApp 统一部署服务接口导出
+ */
+__exportStar(require("../cloudApp/types"), exports);

package/lib/interfaces/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./base.interface"), exports);
 __exportStar(require("./storage.interface"), exports);
 __exportStar(require("./cam.interface"), exports);
 __exportStar(require("./billing.interface"), exports);
+__exportStar(require("./cloudApp.interface"), exports);

package/lib/log/index.js

@@ -0,0 +1,105 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogService = void 0;
+exports.isLogServiceEnabled = isLogServiceEnabled;
+const utils_1 = require("../utils");
+__exportStar(require("./types"), exports);
+/**
+ * 纯函数：根据 DescribeEnvs 返回的 LogServices 列表判断日志服务是否已开通。
+ * 已开通条件：至少一个条目有有效的 TopicId。
+ */
+function isLogServiceEnabled(logServices) {
+    if (!logServices || logServices.length === 0)
+        return false;
+    return logServices.some(svc => !!svc.TopicId);
+}
+class LogService {
+    constructor(environment) {
+        this.envId = environment.getEnvId();
+        this.cloudService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+        this.tcbrService = new utils_1.CloudService(environment.cloudBaseContext, 'tcbr', '2022-02-17');
+    }
+    /**
+     * 检查当前环境的日志服务是否已开通
+     *
+     * 通过 DescribeEnvs 接口获取环境信息，判断 LogServices 字段中是否包含有效的
+     * 日志主题（TopicId 不为空）。
+     *
+     * @returns true 表示已开通，false 表示未开通或开通中
+     */
+    async checkLogServiceEnabled() {
+        var _a;
+        const res = await this.cloudService.request('DescribeEnvs', {
+            EnvId: this.envId
+        });
+        const envInfo = (_a = res === null || res === void 0 ? void 0 : res.EnvList) === null || _a === void 0 ? void 0 : _a[0];
+        if (!envInfo) {
+            return false;
+        }
+        const logServices = envInfo.LogServices;
+        if (!logServices || logServices.length === 0) {
+            return false;
+        }
+        // 已开通：LogServiceInfo 中存在有效的日志主题 ID
+        return isLogServiceEnabled(logServices);
+    }
+    /**
+     * 开通环境日志服务（异步操作）
+     *
+     * 调用 CreateEnvResource 接口开通日志资源。
+     * 注意：接口调用成功不代表日志资源立即可用，需通过 checkLogServiceEnabled() 轮询确认。
+     *
+     * @returns 请求 ID
+     */
+    async createLogService() {
+        return this.cloudService.request('CreateEnvResource', {
+            EnvId: this.envId,
+            Resources: ['log']
+        });
+    }
+    /**
+     * 搜索 CLS 日志
+     *
+     * @param params 查询参数，通过 queryString 使用 CLS 原生检索分析语法
+     * @returns 日志搜索结果
+     *
+     * @remarks
+     * - 纯检索结果在 `LogResults.Results` 中
+     * - SQL 分析结果（queryString 含 `| select ...`）在 `LogResults.AnalysisRecords` 中
+     * - 详细的 QueryString 语法参考见 README.md
+     */
+    async searchClsLog(params) {
+        const { queryString, StartTime, EndTime, Limit, Context, Sort, UseLucene, service } = params;
+        const requestService = service === 'tcbr' ? this.tcbrService : this.cloudService;
+        const requestParams = {
+            EnvId: this.envId,
+            StartTime,
+            EndTime,
+            QueryString: queryString,
+            Limit,
+            Context,
+            Sort,
+            UseLucene
+        };
+        // TenantModel 仅 tcb 服务需要，tcbr 不支持该参数
+        if (service !== 'tcbr') {
+            requestParams.TenantModel = 'public';
+        }
+        return requestService.request('SearchClsLog', requestParams);
+    }
+}
+exports.LogService = LogService;

package/lib/log/types.js

@@ -0,0 +1,24 @@
+"use strict";
+// =====================================================
+// CLS 日志字段枚举 & Module 查询 Schema
+// =====================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLS_MODULE_SCHEMA = void 0;
+// =====================================================
+// CLS Module 运行时常量
+// =====================================================
+/**
+ * ClsModuleSchema 的运行时版本，用于动态生成查询条件 / MCP tool description
+ *
+ * - key 与 ClsLogModule 类型保持同步
+ * - eventTypes / logTypes 为字符串数组，空数组表示该维度不可过滤
+ */
+exports.CLS_MODULE_SCHEMA = {
+    database: { label: '云数据库(文档型)', eventTypes: ['MongoSlowQuery'], logTypes: [] },
+    rdb: { label: '云数据库(SQL型)', eventTypes: ['MysqlFreeze', 'MysqlRecover', 'MysqlSlowQuery'], logTypes: [] },
+    model: { label: '数据模型', eventTypes: [], logTypes: [] },
+    workflow: { label: '审批流', eventTypes: [], logTypes: [] },
+    auth: { label: '用户权限', eventTypes: [], logTypes: [] },
+    llm: { label: '大模型', eventTypes: [], logTypes: ['llm-tracelog'] },
+    app: { label: '应用', eventTypes: ['AppProdPub', 'AppProdDel'], logTypes: [] },
+};