@cloudbase/manager-node 5.6.3 → 5.6.5

package/lib/agent/index.js

@@ -313,10 +313,11 @@ class AgentService {
     // ==================== 日志查询方法 ====================
     /**
      * 获取 Agent 调用日志（自动判断类型）
+     *
+     * SCF / TCBR 均直接走 CLS `searchClsLog`，返回 CLS 原始检索结果 `ISearchClsLogResponse`。
+     * 分页请透传上次返回的 `LogResults.Context` 到入参 `context`。
      * @param params 查询参数
-     * @returns 日志结果，根据 Agent 类型返回不同结构：
-     *   - SCF: IFunctionLogDetailRes[]
-     *   - TCBR: ISearchClsLogResponse
+     * @returns CLS 检索结果 ISearchClsLogResponse
      * @example
      * ```typescript
      * const logs = await agentService.getAgentLogs({
@@ -336,25 +337,18 @@ class AgentService {
         }
         const agentInfo = agentListRes.AgentList[0];
         const agentType = agentInfo.AgentType;
-        // 2. 根据 Agent 类型获取日志
-        if (agentType === 'scf') {
-            const functionService = this.environment.getFunctionService();
-            return functionService.getCompleteFunctionLogs({
-                name: AgentId,
-                offset: params.offset,
-                limit: params.limit,
-                startTime: params.startTime,
-                endTime: params.endTime,
-                requestId: params.requestId
-            });
-        }
-        else if (agentType === 'tcbr') {
+        //    scf / tcbr 均直接走 CLS searchClsLog（getFunctionLogs 系列接口已下线）
+        if (agentType === 'scf' || agentType === 'tcbr') {
             const logService = this.environment.getLogService();
-            const { startTime, endTime, limit = 100, requestId } = params;
+            const { startTime, endTime, limit = 100, requestId, context, sort } = params;
             // 构建查询语句
-            let queryString = `SCF_FunctionName:${AgentId}`;
+            // 采用双引号短语检索保证精确匹配（AgentId/RequestId 含 '-' 会被分词，
+            // 不加引号会因分词命中相似 ID 的其它日志）；并对入参做转义，避免检索语法被注入。
+            // CLS 双引号短语检索下需转义 '"'、'*' 与 '\\'。
+            const escapeClsPhrase = (value) => value.replace(/["*\\]/g, '\\$&');
+            let queryString = `SCF_FunctionName:"${escapeClsPhrase(AgentId)}"`;
             if (requestId) {
-                queryString += ` AND SCF_RequestId:${requestId}`;
+                queryString += ` AND SCF_RequestId:"${escapeClsPhrase(requestId)}"`;
             }
             // 辅助函数：格式化时间
             const formatDateTime = (date) => {
@@ -368,7 +362,9 @@ class AgentService {
                 StartTime: startTime || defaultStartTime,
                 EndTime: endTime || defaultEndTime,
                 queryString: queryString,
-                Limit: limit > 100 ? 100 : limit
+                Limit: limit > 100 ? 100 : limit,
+                Context: context,
+                Sort: sort
             });
         }
         else {

package/lib/database/index.js

@@ -329,6 +329,177 @@ class DatabaseService {
         }
         return this.dbOpService.request('ExecutePGSql', params);
     }
+    /**
+     * 预览 PG 用户 migrations 的远端执行计划（不实际执行 SQL）
+     * @param options 预览参数
+     * @returns 预览结果（Pending、Applied、Conflicts、Executable）
+     */
+    async previewPGUserMigrations(options) {
+        var _a;
+        const { EnvId, Migrations, IncludeAll } = options;
+        if (!Array.isArray(Migrations) || Migrations.length === 0) {
+            throw new error_1.CloudBaseError('Migrations 至少需要 1 条');
+        }
+        for (const migration of Migrations) {
+            if (!/^\d{14}$/.test(migration.Version)) {
+                throw new error_1.CloudBaseError('Migration.Version 必须是 14 位数字');
+            }
+            if (!/^[a-z_]+$/.test(migration.Name)) {
+                throw new error_1.CloudBaseError('Migration.Name 只允许小写字母和下划线');
+            }
+            if (!((_a = migration.Query) === null || _a === void 0 ? void 0 : _a.trim())) {
+                throw new error_1.CloudBaseError('Migration.Query 不能为空');
+            }
+        }
+        return this.dbOpService.request('PreviewPGUserMigrations', Object.assign({ EnvId: EnvId || this.envId, Migrations }, (IncludeAll !== undefined ? { IncludeAll } : {})));
+    }
+    /**
+     * 批量应用 PG 用户 migrations
+     * @param options 批量 migration 参数
+     * @returns 任务信息（TaskId、RequestId）
+     */
+    async pushPGUserMigrations(options) {
+        var _a;
+        const { EnvId, Migrations, LockTimeoutMs, StatementTimeoutMs, IncludeAll } = options;
+        if (!Array.isArray(Migrations) || Migrations.length === 0) {
+            throw new error_1.CloudBaseError('Migrations 至少需要 1 条');
+        }
+        for (const migration of Migrations) {
+            if (!/^\d{14}$/.test(migration.Version)) {
+                throw new error_1.CloudBaseError('Migration.Version 必须是 14 位数字');
+            }
+            if (!/^[a-z_]+$/.test(migration.Name)) {
+                throw new error_1.CloudBaseError('Migration.Name 只允许小写字母和下划线');
+            }
+            if (!((_a = migration.Query) === null || _a === void 0 ? void 0 : _a.trim())) {
+                throw new error_1.CloudBaseError('Migration.Query 不能为空');
+            }
+        }
+        if (LockTimeoutMs !== undefined && LockTimeoutMs < 0) {
+            throw new error_1.CloudBaseError('LockTimeoutMs 不能小于 0');
+        }
+        if (StatementTimeoutMs !== undefined && StatementTimeoutMs < 0) {
+            throw new error_1.CloudBaseError('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 } : {})));
+    }
+    /**
+     * 修复 PG 用户 migration history，仅维护 user_schema_migrations 记录，不执行 SQL
+     * @param options 修复参数
+     * @returns RequestId
+     */
+    async repairPGUserMigrationHistory(options) {
+        const { EnvId, MigrationVersion, Name, Status, Reason, Query } = options;
+        if (!/^\d{14}$/.test(MigrationVersion)) {
+            throw new error_1.CloudBaseError('MigrationVersion 必须是 14 位数字');
+        }
+        if (!/^[a-z_]+$/.test(Name)) {
+            throw new error_1.CloudBaseError('Name 只允许小写字母和下划线');
+        }
+        if (Status !== 'applied' && Status !== 'reverted') {
+            throw new error_1.CloudBaseError('Status 只允许 applied 或 reverted');
+        }
+        if (!(Reason === null || Reason === void 0 ? void 0 : Reason.trim())) {
+            throw new error_1.CloudBaseError('Reason 不能为空');
+        }
+        if (Status === 'applied' && !(Query === null || Query === void 0 ? void 0 : Query.trim())) {
+            throw new error_1.CloudBaseError('Status=applied 时 Query 不能为空');
+        }
+        const params = {
+            EnvId: EnvId || this.envId,
+            MigrationVersion,
+            Name,
+            Status,
+            Reason
+        };
+        if (Status === 'applied') {
+            params.Query = Query;
+        }
+        return this.dbOpService.request('RepairPGUserMigrationHistory', params);
+    }
+    /**
+     * 查询目标环境已应用的用户 migration 列表
+     * @param options 查询参数（EnvId 可选、Limit、Offset）
+     * @returns 已应用 migration 列表、总数量、最新版本号
+     */
+    async listPGUserMigrations(options = {}) {
+        const { EnvId, Limit, Offset } = options;
+        if (Limit !== undefined && (Limit < 1 || Limit > 500)) {
+            throw new error_1.CloudBaseError('Limit 取值范围为 [1, 500]');
+        }
+        if (Offset !== undefined && Offset < 0) {
+            throw new error_1.CloudBaseError('Offset 不能小于 0');
+        }
+        return this.dbOpService.request('ListPGUserMigrations', Object.assign(Object.assign({ EnvId: EnvId || this.envId }, (Limit !== undefined ? { Limit } : {})), (Offset !== undefined ? { Offset } : {})));
+    }
+    /**
+     * 查询目标环境全部已应用的用户 migration 列表
+     * @param options 查询参数（EnvId 可选、PageSize）
+     * @returns 已应用 migration 列表、总数量、最新版本号
+     */
+    async listAllPGUserMigrations(options = {}) {
+        const { EnvId, PageSize = 500 } = options;
+        if (PageSize < 1 || PageSize > 500) {
+            throw new error_1.CloudBaseError('PageSize 取值范围为 [1, 500]');
+        }
+        const migrations = [];
+        let offset = 0;
+        let latestVersion = '';
+        let total = 0;
+        let requestId = '';
+        while (true) {
+            const page = await this.listPGUserMigrations({
+                EnvId,
+                Limit: PageSize,
+                Offset: offset
+            });
+            const pageMigrations = page.Migrations || [];
+            migrations.push(...pageMigrations);
+            latestVersion = page.LatestVersion || latestVersion;
+            total += pageMigrations.length;
+            requestId = page.RequestId || requestId;
+            if (pageMigrations.length < PageSize) {
+                break;
+            }
+            offset += PageSize;
+        }
+        return {
+            Total: total,
+            LatestVersion: latestVersion,
+            Migrations: migrations,
+            RequestId: requestId
+        };
+    }
+    /**
+     * 查询目标环境指定 migration 详情
+     * @param options 查询参数（EnvId 可选、MigrationVersion 必填）
+     * @returns migration 详情（Version、Name、Query）
+     */
+    async describePGUserMigration(options) {
+        const { EnvId, MigrationVersion } = options;
+        if (!/^\d{14}$/.test(MigrationVersion)) {
+            throw new error_1.CloudBaseError('MigrationVersion 必须是 14 位数字');
+        }
+        return this.dbOpService.request('DescribePGUserMigration', {
+            EnvId: EnvId || this.envId,
+            MigrationVersion
+        });
+    }
+    /**
+     * 查询任务结果
+     * @param options 查询参数（EnvId 可选、TaskId 必填）
+     * @returns 任务状态详情（TaskType、Status、Phase、Reason 等）
+     */
+    async describeTaskResult(options) {
+        const { EnvId, TaskId } = options;
+        if (!(TaskId === null || TaskId === void 0 ? void 0 : TaskId.trim())) {
+            throw new error_1.CloudBaseError('TaskId 不能为空');
+        }
+        return this.dbOpService.request('DescribeTaskResult', {
+            EnvId: EnvId || this.envId,
+            TaskId
+        });
+    }
 }
 exports.DatabaseService = DatabaseService;
 DatabaseService.tcbServiceVersion = {
@@ -372,3 +543,24 @@ __decorate([
 __decorate([
     preLazy()
 ], DatabaseService.prototype, "executePGSql", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "previewPGUserMigrations", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "pushPGUserMigrations", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "repairPGUserMigrationHistory", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "listPGUserMigrations", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "listAllPGUserMigrations", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "describePGUserMigration", null);
+__decorate([
+    preLazy()
+], DatabaseService.prototype, "describeTaskResult", null);

package/lib/database/type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/function/index.js

@@ -290,7 +290,7 @@ class FunctionService {
     async createFunction(funcParam) {
         var _a, _b, _c;
         const { namespace } = this.getFunctionConfig();
-        const { func, functionRootPath, force = false, base64Code, codeSecret, functionPath, deployMode } = funcParam;
+        const { func, functionRootPath, force = false, base64Code, codeSecret, functionPath, deployMode, code } = funcParam;
         const funcName = func.name;
         const { TopicId, LogsetId } = this.getClsServiceConfig();
         const params = configToParams({
@@ -304,20 +304,30 @@ class FunctionService {
                 ClsLogsetId: LogsetId
             }
         });
+        const customCode = code;
+        const customImageCode = customCode === null || customCode === void 0 ? void 0 : customCode.ImageConfig;
+        const funcImageCode = (_a = params.Code) === null || _a === void 0 ? void 0 : _a.ImageConfig;
         // 根据部署方式处理 Code 参数
-        // 优先使用显式指定的 deployMode，如果未指定但存在 imageConfig 则认为是镜像部署
-        const isImageDeploy = deployMode === 'image' || (!deployMode && ((_a = params.Code) === null || _a === void 0 ? void 0 : _a.ImageConfig));
+        // 优先级：deployMode=image > 显式传入 code > 原有自动打包逻辑（base64Code/functionPath/functionRootPath）
+        const isImageDeploy = deployMode === 'image' || Boolean(customImageCode) || (!deployMode && Boolean(funcImageCode));
         if (isImageDeploy) {
-            // 镜像部署：Code 参数已在 configToParams 中通过 imageConfig 设置
+            // 镜像部署优先使用显式 code.ImageConfig；未传时回退到 func.imageConfig（configToParams 生成）
+            if (customImageCode) {
+                params.Code = customCode;
+            }
             if (!((_c = (_b = params.Code) === null || _b === void 0 ? void 0 : _b.ImageConfig) === null || _c === void 0 ? void 0 : _c.ImageUri)) {
                 throw new error_1.CloudBaseError('镜像部署需要配置 imageConfig.imageUri');
             }
-            // 镜像部署的特殊配置
-            // 镜像函数不需要 Handler
+            // 镜像函数不需要 Handler / InstallDependency
             delete params.Handler;
-            // 镜像函数不需要安装依赖
             delete params.InstallDependency;
         }
+        else if (customCode) {
+            if (base64Code || functionPath || functionRootPath) {
+                console.warn(`[${funcName}] 检测到同时传入 code 与本地打包参数，已优先使用 code 参数`);
+            }
+            params.Code = customCode;
+        }
         else {
             // 代码部署：通过 getCodeParams 获取代码参数
             params.Code = await this.getCodeParams({
@@ -372,7 +382,8 @@ class FunctionService {
                         functionPath,
                         functionRootPath,
                         codeSecret: codeSecret,
-                        deployMode: isImageDeploy ? 'image' : undefined
+                        deployMode: isImageDeploy ? 'image' : deployMode,
+                        code
                     });
                     // 等待函数状态正常
                     await this.waitFunctionActive(funcName, codeSecret);
@@ -612,48 +623,27 @@ class FunctionService {
         return data;
     }
     /**
-     * 获取函数日志
-     * @deprecated 请使用 getFunctionLogsV2 代替
-     * @param {{
-    *         name: string
-    *         offset: number
-    *         limit: number
-    *         order: string
-    *         orderBy: string
-    *         startTime: string
-    *         endTime: string
-    *         requestId: string
-    *     }} options
-    * @returns {Promise<IFunctionLogRes>}
-    */
-    async getFunctionLogs(options) {
-        let { name, offset = 0, limit = 10, order, orderBy, startTime, endTime, requestId } = options;
-        const { namespace } = this.getFunctionConfig();
-        if (startTime && !endTime) {
-            // 自动补 endTime 为 startTime + 1d
-            endTime = (0, utils_1.formatTimeByMs)(new Date(startTime).getTime() + 24 * 3600 * 1000);
-        }
-        if (endTime && !startTime) {
-            // 自动补 startTime 为 endTime - 1d
-            startTime = (0, utils_1.formatTimeByMs)(new Date(endTime).getTime() - 24 * 3600 * 1000);
-        }
-        const params = {
-            Namespace: namespace,
-            FunctionName: name,
-            Offset: offset,
-            Limit: limit,
-            Order: order,
-            OrderBy: orderBy,
-            StartTime: startTime,
-            EndTime: endTime,
-            FunctionRequestId: requestId
-        };
-        const res = await this.scfService.request('GetFunctionLogs', params);
-        return res;
+ * 获取函数日志
+ * @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 列表
- * @param {{
+    * 获取函数日志 ID 列表
+    * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
+    * @param {{
     *         name: string
     *         offset: number
     *         limit: number
@@ -664,28 +654,12 @@ class FunctionService {
     *     }} options
     * @returns {Promise<IFunctionLogResV2>}
     */
-    async getFunctionLogsV2(options) {
-        let { name, offset = 0, limit = 10, startTime, endTime, requestId, qualifier } = options;
-        const { env } = this.getFunctionConfig();
-        ({ startTime, endTime } = (0, utils_1.getCompleteTimeRange)({
-            startTime,
-            endTime
-        }));
-        const params = {
-            EnvId: env,
-            FunctionName: name,
-            Offset: offset,
-            Limit: limit,
-            StartTime: startTime,
-            EndTime: endTime,
-            LogRequestId: requestId,
-            Qualifier: qualifier || "$LATEST" // 云函数版本，不传则用 $LATEST
-        };
-        const res = await this.tcbService.request('GetFunctionLogs', params);
-        return res;
+    async getFunctionLogsV2(_options) {
+        throw new error_1.CloudBaseError('getFunctionLogsV2 已废弃：底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
  * 根据函数日志 ID 查询日志详情
+ * @deprecated 底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
  * @param {{
     *         startTime: string
     *         endTime: string
@@ -693,46 +667,18 @@ class FunctionService {
     *     }} options
     * @returns {Promise<IFunctionLogDetailRes>}
     */
-    async getFunctionLogDetail(options) {
-        let { logRequestId, startTime, endTime } = options;
-        ({ startTime, endTime } = (0, utils_1.getCompleteTimeRange)({
-            startTime,
-            endTime
-        }));
-        const params = {
-            StartTime: startTime,
-            LogRequestId: logRequestId,
-            EndTime: endTime
-        };
-        const res = await this.tcbService.request('GetFunctionLogDetail', params);
-        return res;
+    async getFunctionLogDetail(_options) {
+        throw new error_1.CloudBaseError('getFunctionLogDetail 已废弃：底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
      * 获取函数的完整调用日志
      * 该方法会自动完成两步操作：1. 获取日志请求ID列表。 2. 根据ID列表获取每条日志的详细内容。
+     * @deprecated 底层 GetFunctionLogs/GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
      * @param {IFunctionLogOptionsV2} options - 查询选项
      * @returns {Promise<IFunctionLogDetailRes[]>} 返回包含完整日志详情的数组
      */
-    async getCompleteFunctionLogs(options) {
-        // 调用 getFunctionLogsV2 获取日志请求ID列表
-        const { name } = options;
-        const logs = await this.getFunctionLogsV2(options);
-        // 如果没有日志，直接返回空数组
-        if (logs.LogList.length === 0) {
-            return [];
-        }
-        const detailPromises = logs.LogList.map(async (log) => {
-            // 对每一个日志ID，调用 getFunctionLogDetail
-            const res = await this.getFunctionLogDetail({
-                logRequestId: log.RequestId,
-                startTime: options.startTime,
-                endTime: options.endTime
-            });
-            return Object.assign(Object.assign({}, res), { RetCode: log.RetCode, FunctionName: name });
-        });
-        // 并发执行所有详情查询，等待它们全部完成
-        const detailedLogs = await Promise.all(detailPromises);
-        return detailedLogs;
+    async getCompleteFunctionLogs(_options) {
+        throw new error_1.CloudBaseError('getCompleteFunctionLogs 已废弃：底层 GetFunctionLogs/GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志');
     }
     /**
      * 更新云函数配置
@@ -877,7 +823,7 @@ class FunctionService {
      * @memberof FunctionService
      */
     async updateFunctionCode(funcParam) {
-        const { func, functionRootPath, base64Code, codeSecret, functionPath, deployMode } = funcParam;
+        const { func, functionRootPath, base64Code, codeSecret, functionPath, deployMode, code } = funcParam;
         const funcName = func.name;
         const { namespace } = this.getFunctionConfig();
         // 镜像部署：使用镜像配置更新函数代码
@@ -904,6 +850,10 @@ class FunctionService {
                 });
             }
         }
+        const customCode = code;
+        if (customCode && (base64Code || functionPath || functionRootPath)) {
+            console.warn(`[${funcName}] 检测到同时传入 code 与本地打包参数，已优先使用 code 参数`);
+        }
         // 代码部署：原有逻辑
         let installDependency;
         // Node 函数默认安装依赖
@@ -912,7 +862,7 @@ class FunctionService {
         if (func.installDependency !== undefined) {
             installDependency = toBooleanString(func.installDependency);
         }
-        const codeParams = await this.getCodeParams({
+        const codeParams = customCode || await this.getCodeParams({
             func,
             functionPath,
             functionRootPath,

package/package.json

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

package/types/agent/index.d.ts

@@ -1,5 +1,6 @@
 import { Environment } from '../environment';
 import { ICreateFunctionAgentParams, ICreateAgentParams, ICreateTcbrAgentByImageParams, ICreateTcbrAgentByPackageParams, ICreateTcbrAgentByCodeParams, IDescribeAgentListParams, IDescribeAgentListResponse, IDescribeAgentResponse, IDeleteAgentParams, IDescribeCloudBaseBuildServiceParams, IDescribeCloudBaseBuildServiceResponse, ICreateAgentResponse, IDeleteAgentResponse, ICommonResponse, IUpdateAgentParams, IUpdateScfAgentParams, IUpdateScfAgentResponse, IUpdateTcbrAgentParams, IGetAgentLogsParams } from './type';
+import { ISearchClsLogResponse } from '../log';
 /**
  * Agent 管理类
  * 支持三种部署方式：
@@ -64,10 +65,11 @@ export declare class AgentService {
     updateScfAgent(params: IUpdateScfAgentParams): Promise<IUpdateScfAgentResponse>;
     /**
      * 获取 Agent 调用日志（自动判断类型）
+     *
+     * SCF / TCBR 均直接走 CLS `searchClsLog`，返回 CLS 原始检索结果 `ISearchClsLogResponse`。
+     * 分页请透传上次返回的 `LogResults.Context` 到入参 `context`。
      * @param params 查询参数
-     * @returns 日志结果，根据 Agent 类型返回不同结构：
-     *   - SCF: IFunctionLogDetailRes[]
-     *   - TCBR: ISearchClsLogResponse
+     * @returns CLS 检索结果 ISearchClsLogResponse
      * @example
      * ```typescript
      * const logs = await agentService.getAgentLogs({
@@ -78,7 +80,7 @@ export declare class AgentService {
      * })
      * ```
      */
-    getAgentLogs(params: IGetAgentLogsParams): Promise<any>;
+    getAgentLogs(params: IGetAgentLogsParams): Promise<ISearchClsLogResponse>;
     /**
      * 通过镜像创建 TCBR Agent
      * @internal 暂不对外暴露，后续版本开放

package/types/agent/type.d.ts

@@ -372,16 +372,18 @@ export interface IDeleteAgentResponse {
 export interface IGetAgentLogsParams {
     /** Agent ID */
     AgentId: string;
-    /** 偏移量，默认 0 */
-    offset?: number;
-    /** 返回数量，默认 10 */
+    /** 单次返回条数，默认 100，最大 100 */
     limit?: number;
-    /** 开始时间，如 "2024-01-01 00:00:00" */
+    /** 开始时间，如 "2024-01-01 00:00:00"，默认最近 1 小时 */
     startTime?: string;
-    /** 结束时间，如 "2024-01-01 23:59:59" */
+    /** 结束时间，如 "2024-01-01 23:59:59"，默认当前时间 */
     endTime?: string;
-    /** 按 RequestId 筛选（仅 SCF Agent） */
+    /** 按 RequestId 筛选 */
     requestId?: string;
+    /** 分页游标，透传上次返回的 LogResults.Context 获取下一页 */
+    context?: string;
+    /** 按时间排序：'asc' 升序 / 'desc' 降序（默认 desc） */
+    sort?: 'asc' | 'desc';
 }
 /**
  * @deprecated 请使用 ICreateTcbrAgentByCodeParams

package/types/database/index.d.ts

@@ -1,5 +1,6 @@
 import { IServiceVersion, IExistsRes, CreateIndex, DropIndex, IndexInfo, TableInfo, Pager, IResponseInfo, CollectionDispension } from '../interfaces/';
 import { Environment } from '../environment';
+import { IDescribePGUserMigrationOptions, IDescribePGUserMigrationResult, IDescribeTaskResultOptions, IDescribeTaskResultResult, IListAllPGUserMigrationsOptions, IListPGUserMigrationsOptions, IListPGUserMigrationsResult, IPreviewPGUserMigrationsOptions, IPreviewPGUserMigrationsResult, IPushPGUserMigrationsOptions, IPushPGUserMigrationsResult, IRepairPGUserMigrationHistoryOptions } from './type';
 interface IDatabaseConfig {
     Tag: string;
 }
@@ -226,5 +227,47 @@ export declare class DatabaseService {
      * console.log(res.Rows)    // ['["1","Alice"]']
      */
     executePGSql(options: IExecutePGSqlOptions): Promise<IExecutePGSqlResult>;
+    /**
+     * 预览 PG 用户 migrations 的远端执行计划（不实际执行 SQL）
+     * @param options 预览参数
+     * @returns 预览结果（Pending、Applied、Conflicts、Executable）
+     */
+    previewPGUserMigrations(options: IPreviewPGUserMigrationsOptions): Promise<IPreviewPGUserMigrationsResult>;
+    /**
+     * 批量应用 PG 用户 migrations
+     * @param options 批量 migration 参数
+     * @returns 任务信息（TaskId、RequestId）
+     */
+    pushPGUserMigrations(options: IPushPGUserMigrationsOptions): Promise<IPushPGUserMigrationsResult>;
+    /**
+     * 修复 PG 用户 migration history，仅维护 user_schema_migrations 记录，不执行 SQL
+     * @param options 修复参数
+     * @returns RequestId
+     */
+    repairPGUserMigrationHistory(options: IRepairPGUserMigrationHistoryOptions): Promise<IResponseInfo>;
+    /**
+     * 查询目标环境已应用的用户 migration 列表
+     * @param options 查询参数（EnvId 可选、Limit、Offset）
+     * @returns 已应用 migration 列表、总数量、最新版本号
+     */
+    listPGUserMigrations(options?: IListPGUserMigrationsOptions): Promise<IListPGUserMigrationsResult>;
+    /**
+     * 查询目标环境全部已应用的用户 migration 列表
+     * @param options 查询参数（EnvId 可选、PageSize）
+     * @returns 已应用 migration 列表、总数量、最新版本号
+     */
+    listAllPGUserMigrations(options?: IListAllPGUserMigrationsOptions): Promise<IListPGUserMigrationsResult>;
+    /**
+     * 查询目标环境指定 migration 详情
+     * @param options 查询参数（EnvId 可选、MigrationVersion 必填）
+     * @returns migration 详情（Version、Name、Query）
+     */
+    describePGUserMigration(options: IDescribePGUserMigrationOptions): Promise<IDescribePGUserMigrationResult>;
+    /**
+     * 查询任务结果
+     * @param options 查询参数（EnvId 可选、TaskId 必填）
+     * @returns 任务状态详情（TaskType、Status、Phase、Reason 等）
+     */
+    describeTaskResult(options: IDescribeTaskResultOptions): Promise<IDescribeTaskResultResult>;
 }
 export {};

package/types/database/type.d.ts

@@ -0,0 +1,212 @@
+/**
+ * PushPGUserMigrations 的单条 migration 输入
+ */
+export interface IPGUserMigrationInput {
+    /** migration 版本，14 位数字时间串，如 20260526000000 */
+    Version: string;
+    /** migration 名称，仅允许小写字母和下划线 */
+    Name: string;
+    /** 要执行的 SQL */
+    Query: string;
+    /** 回滚 SQL（可选） */
+    Rollback?: string;
+}
+/**
+ * 批量应用 PG 用户 migrations 请求参数
+ */
+export interface IPushPGUserMigrationsOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** migration 列表（至少 1 条） */
+    Migrations: IPGUserMigrationInput[];
+    /** 获取数据库锁最长等待时间（毫秒） */
+    LockTimeoutMs?: number;
+    /** 单条 SQL 最长执行时间（毫秒） */
+    StatementTimeoutMs?: number;
+    /** 是否允许 out-of-order local migrations */
+    IncludeAll?: boolean;
+}
+/**
+ * 批量应用 PG 用户 migrations 返回参数
+ */
+export interface IPushPGUserMigrationsResult {
+    /** 请求唯一 ID */
+    RequestId: string;
+    /** 异步任务 ID，可用于查询任务进度 */
+    TaskId: string;
+}
+/**
+ * 预览 PG 用户 migrations 请求参数
+ */
+export interface IPreviewPGUserMigrationsOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** migration 列表（至少 1 条） */
+    Migrations: IPGUserMigrationInput[];
+    /** 是否允许 out-of-order local migrations */
+    IncludeAll?: boolean;
+}
+/**
+ * migration 计划项
+ */
+export interface IPGUserMigrationPlanItem {
+    /** migration 版本 */
+    Version: string;
+    /** migration 名称 */
+    Name: string;
+    /** 当前状态（例如 applied / pending） */
+    Status?: string;
+    /** 状态原因（例如 checksum_matched） */
+    Reason?: string;
+    /** migration 内容校验和 */
+    Checksum?: string;
+    /** 来源标记（响应字段，服务端可能返回） */
+    Source?: string;
+}
+/**
+ * migration 冲突项
+ */
+export interface IPGUserMigrationConflict {
+    /** 发生冲突的 migration 版本 */
+    Version: string;
+    /** 本地 migration 名称 */
+    Name?: string;
+    /** 远端（数据库已应用）migration 名称 */
+    RemoteName?: string;
+    /** 本次 SQL 计算出来的 checksum */
+    LocalChecksum?: string;
+    /** 数据库中已应用 migration 的 checksum */
+    RemoteChecksum?: string;
+    /** 冲突原因（如 checksum_mismatch） */
+    Reason?: string;
+    /** 冲突详情信息 */
+    Message?: string;
+    /** 兼容服务端未来扩展字段 */
+    [key: string]: any;
+}
+/**
+ * 预览 PG 用户 migrations 返回参数
+ */
+export interface IPreviewPGUserMigrationsResult {
+    /** 将要执行的 migration 列表 */
+    Pending: IPGUserMigrationPlanItem[] | null;
+    /** 已经应用过的 migration 列表 */
+    Applied: IPGUserMigrationPlanItem[] | null;
+    /** checksum 冲突列表 */
+    Conflicts: IPGUserMigrationConflict[] | null;
+    /** 是否可直接执行（当前主要表示无 checksum 冲突） */
+    Executable: boolean;
+    /** 请求唯一 ID */
+    RequestId: string;
+}
+/**
+ * 已应用的 PG 用户 migration 摘要项
+ */
+export interface IPGUserMigrationSummary {
+    /** migration 版本号，14 位数字时间串（如 20260526000000） */
+    Version: string;
+    /** migration 名称 */
+    Name: string;
+}
+/**
+ * 查询已应用 PG 用户 migrations 请求参数
+ */
+export interface IListPGUserMigrationsOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** 查询条数，取值范围 [1, 500]，默认 100 */
+    Limit?: number;
+    /** 分页偏移，默认 0 */
+    Offset?: number;
+}
+/**
+ * 查询全部已应用 PG 用户 migrations 请求参数
+ */
+export interface IListAllPGUserMigrationsOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** 内部翻页每页大小，取值范围 [1, 500]，默认 500 */
+    PageSize?: number;
+}
+/**
+ * 查询已应用 PG 用户 migrations 返回参数
+ */
+export interface IListPGUserMigrationsResult {
+    /** 总数量 */
+    Total: number;
+    /** 已应用的最新版本号，14 位数字时间串 */
+    LatestVersion: string;
+    /** 已应用 migration 列表 */
+    Migrations: IPGUserMigrationSummary[];
+    /** 请求唯一 ID */
+    RequestId: string;
+}
+/**
+ * 查询单条 PG 用户 migration 详情请求参数
+ */
+export interface IDescribePGUserMigrationOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** migration 版本号，14 位数字时间串（如 20260526000000） */
+    MigrationVersion: string;
+}
+/**
+ * 查询单条 PG 用户 migration 详情返回参数
+ */
+export interface IDescribePGUserMigrationResult {
+    /** migration 版本号，14 位数字时间串 */
+    Version: string;
+    /** migration 名称（仅小写字母和下划线） */
+    Name: string;
+    /** migration SQL */
+    Query: string;
+    /** 请求唯一 ID */
+    RequestId: string;
+}
+/**
+ * 查询任务结果请求参数
+ */
+export interface IDescribeTaskResultOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** 任务 ID */
+    TaskId: string;
+}
+/**
+ * 查询任务结果返回参数
+ */
+export interface IDescribeTaskResultResult {
+    /** 任务 ID */
+    TaskId: string;
+    /** 任务类型（如 PGUserMigration） */
+    TaskType: string;
+    /** 任务状态：Failed / Succeed / Accepted / Running */
+    Status: 'Failed' | 'Succeed' | 'Accepted' | 'Running' | string;
+    /** 当前步骤 */
+    Phase: string;
+    /** 失败原因（成功时可能为空） */
+    Reason: string;
+    /** 创建时间（ISO 8601） */
+    CreatedAt: string;
+    /** 最后更新时间（ISO 8601） */
+    UpdatedAt: string;
+    /** 请求唯一 ID */
+    RequestId: string;
+}
+/**
+ * 修复 PG 用户 migration history 请求参数
+ */
+export interface IRepairPGUserMigrationHistoryOptions {
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+    /** migration 版本，14 位数字时间串，如 20260526000000 */
+    MigrationVersion: string;
+    /** migration 版本名，仅允许小写字母和下划线 */
+    Name: string;
+    /** 修复状态：applied（写入 history）或 reverted（删除 history） */
+    Status: 'applied' | 'reverted';
+    /** 修复原因 */
+    Reason: string;
+    /** applied 时建议传入对应 SQL，reverted 时可不传 */
+    Query?: string;
+}

package/types/function/index.d.ts

@@ -1,6 +1,6 @@
 import { Environment } from '../environment';
 import { IResponseInfo, ICloudFunction, ICloudFunctionV2, IFunctionLogOptions, ICloudFunctionTrigger, IFunctionInvokeRes, IFunctionLogRes, IFunctionDownloadUrlRes, IFunctionLogDetailOptions, IFunctionLogDetailRes, IFunctionLogOptionsV2, IFunctionLogResV2 } from '../interfaces';
-import { IFunctionInfo } from './types';
+import { IFunctionInfo, IFunctionCode as IScfFunctionCode } from './types';
 export interface IFunctionCode {
     func: ICloudFunction;
     functionRootPath?: string;
@@ -18,6 +18,7 @@ export interface ICreateFunctionParam {
     functionPath?: string;
     codeSecret?: string;
     deployMode?: 'cos' | 'zip' | 'image';
+    code?: IScfFunctionCode;
 }
 export interface IUpdateFunctionCodeParam {
     func: ICloudFunction;
@@ -26,6 +27,7 @@ export interface IUpdateFunctionCodeParam {
     base64Code?: string;
     codeSecret?: string;
     deployMode?: 'cos' | 'zip' | 'image';
+    code?: IScfFunctionCode;
 }
 export interface IUpdateFunctionIncrementalCodeParam {
     func: ICloudFunction;
@@ -309,24 +311,25 @@ export declare class FunctionService {
         codeSecret: any;
     }): Promise<IFunctionInfo[]>;
     /**
-     * 获取函数日志
-     * @deprecated 请使用 getFunctionLogsV2 代替
-     * @param {{
-    *         name: string
-    *         offset: number
-    *         limit: number
-    *         order: string
-    *         orderBy: string
-    *         startTime: string
-    *         endTime: string
-    *         requestId: string
-    *     }} options
-    * @returns {Promise<IFunctionLogRes>}
-    */
-    getFunctionLogs(options: IFunctionLogOptions): Promise<IFunctionLogRes>;
-    /**
- * 获取函数日志 ID 列表
+ * 获取函数日志
+ * @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>}
+ */
+    getFunctionLogs(_options: IFunctionLogOptions): Promise<IFunctionLogRes>;
+    /**
+    * 获取函数日志 ID 列表
+    * @deprecated 底层 GetFunctionLogs 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
+    * @param {{
     *         name: string
     *         offset: number
     *         limit: number
@@ -337,9 +340,10 @@ export declare class FunctionService {
     *     }} options
     * @returns {Promise<IFunctionLogResV2>}
     */
-    getFunctionLogsV2(options: IFunctionLogOptionsV2): Promise<IFunctionLogResV2>;
+    getFunctionLogsV2(_options: IFunctionLogOptionsV2): Promise<IFunctionLogResV2>;
     /**
  * 根据函数日志 ID 查询日志详情
+ * @deprecated 底层 GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
  * @param {{
     *         startTime: string
     *         endTime: string
@@ -347,14 +351,15 @@ export declare class FunctionService {
     *     }} options
     * @returns {Promise<IFunctionLogDetailRes>}
     */
-    getFunctionLogDetail(options: IFunctionLogDetailOptions): Promise<IFunctionLogDetailRes>;
+    getFunctionLogDetail(_options: IFunctionLogDetailOptions): Promise<IFunctionLogDetailRes>;
     /**
      * 获取函数的完整调用日志
      * 该方法会自动完成两步操作：1. 获取日志请求ID列表。 2. 根据ID列表获取每条日志的详细内容。
+     * @deprecated 底层 GetFunctionLogs/GetFunctionLogDetail 接口已下线，请使用 env.getLogService().searchClsLog() 查询云函数日志
      * @param {IFunctionLogOptionsV2} options - 查询选项
      * @returns {Promise<IFunctionLogDetailRes[]>} 返回包含完整日志详情的数组
      */
-    getCompleteFunctionLogs(options: IFunctionLogOptionsV2): Promise<IFunctionLogDetailRes[]>;
+    getCompleteFunctionLogs(_options: IFunctionLogOptionsV2): Promise<IFunctionLogDetailRes[]>;
     /**
      * 更新云函数配置
      * @param {ICloudFunction} func 云函数配置