@cloudbase/manager-node 5.6.5 → 5.6.6

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## @cloudbase/manager-node v5.6.5 版本发布 🚀(2026-07-28)
+
+- 新增 PostgreSQL 数据库迁移相关 API 与类型定义
+- 新增 统一 SCF/TCBR Agent 日志查询走 CLS searchClsLog
+- 新增 code 入参并完善相关文档与测试
+
+---
+
+## @cloudbase/manager-node v5.6.4 版本发布 🚀(2026-07-23)
+
+- 新增 code 入参并完善相关文档与测试
+- 重构 更新默认 Runtime 为 Nodejs20.19
+- 修复 移除创建云函数时 Timeout 默认值，改为透传 SCF 默认值
+
+---
+
+## @cloudbase/manager-node v5.6.3 版本发布 🚀(2026-07-16)
+
+- 重构 更新默认 Runtime 为 Nodejs20.19
+- 修复 移除创建云函数时 Timeout 默认值，改为透传 SCF 默认值
+
+---
+
 ## @cloudbase/manager-node v5.6.2 版本发布 🚀(2026-07-09)
 
 - 新增 支持镜像部署模式

package/lib/access/index.js

@@ -8,6 +8,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AccessService = void 0;
 const utils_1 = require("../utils");
+/**
+ * HTTP Service（CloudBaseGW）访问服务。
+ * 注意：HTTP Service 模块自 v5.0.0 起已废弃，建议迁移到 EnvService 的域名与路由能力
+ * （如 createHttpServiceRoute / modifyHttpServiceRoute / deleteHttpServiceRoute）。
+ */
 class AccessService {
     constructor(environment) {
         this.environment = environment;

package/lib/cloudApp/index.js

@@ -126,7 +126,7 @@ class CloudAppService {
      * @param params 上传参数
      */
     async uploadCode(params) {
-        const { serviceName, localPath, ignore = [] } = params;
+        const { serviceName, localPath, ignore = [], onPhase } = params;
         // 1. 验证本地路径
         if (!fs_1.default.existsSync(localPath)) {
             throw new error_1.CloudBaseError(`本地路径不存在: ${localPath}`);
@@ -138,20 +138,27 @@ class CloudAppService {
         // 2. 打包本地文件为 ZIP
         const tmpZipPath = path_1.default.join(os_1.default.tmpdir(), `cloudapp-${Date.now()}-${Math.random().toString(36).slice(2)}.zip`);
         const defaultIgnore = ['node_modules/**', '.git/**', '.DS_Store', '**/.DS_Store'];
+        const packStart = Date.now();
         await (0, utils_1.compressToZip)({
             dirPath: localPath,
             outputPath: tmpZipPath,
             ignore: [...defaultIgnore, ...ignore]
         });
+        const zipSize = fs_1.default.statSync(tmpZipPath).size;
+        onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'pack', durationMs: Date.now() - packStart, bytes: zipSize });
         try {
             // 3. 获取上传凭证
+            const credStart = Date.now();
             const cosInfo = await this.describeCosInfo({
                 deployType: params.deployType,
                 serviceName,
                 suffix: '.zip'
             });
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'credential', durationMs: Date.now() - credStart });
             // 4. 读取 ZIP 文件
+            const readStart = Date.now();
             const zipBuffer = fs_1.default.readFileSync(tmpZipPath);
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'read', durationMs: Date.now() - readStart, bytes: zipBuffer.length });
             // 5. 构建请求头
             const headers = {
                 'Content-Type': 'application/zip'
@@ -162,6 +169,7 @@ class CloudAppService {
                 }
             }
             // 6. 使用预签名 URL 上传
+            const putStart = Date.now();
             const response = await (0, http_request_1.fetchStream)(cosInfo.UploadUrl, {
                 method: 'PUT',
                 body: zipBuffer,
@@ -178,6 +186,7 @@ class CloudAppService {
                 }
                 throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
             }
+            onPhase === null || onPhase === void 0 ? void 0 : onPhase({ phase: 'upload', durationMs: Date.now() - putStart, bytes: zipBuffer.length });
             // 7. 返回结果（返回 cosTimestamp，用于创建应用）
             return {
                 cosTimestamp: cosInfo.UnixTimestamp,

package/lib/index.js

@@ -64,6 +64,10 @@ class CloudBase {
     get hosting() {
         return this.currentEnvironment().getHostingService();
     }
+    /**
+     * HTTP Service（CloudBaseGW）访问服务
+     * @deprecated 自 v5.0.0 起 HTTP Service 模块已废弃，请改用 env 下的域名与路由相关 API。
+     */
     get access() {
         return this.currentEnvironment().getAccessService();
     }

package/package.json

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

package/types/access/index.d.ts

@@ -1,6 +1,11 @@
 import { Environment } from '../environment';
 import { ICreateAccessOptions, IApi, IUpdateOptions, IService, IDeleteOptions, IGetOptions, IDomainOptions } from './types';
 import { IResponseInfo } from '../interfaces';
+/**
+ * HTTP Service（CloudBaseGW）访问服务。
+ * 注意：HTTP Service 模块自 v5.0.0 起已废弃，建议迁移到 EnvService 的域名与路由能力
+ * （如 createHttpServiceRoute / modifyHttpServiceRoute / deleteHttpServiceRoute）。
+ */
 export declare class AccessService {
     private tcbService;
     private environment;

package/types/cloudApp/types.d.ts

@@ -299,6 +299,21 @@ export interface IProgressData {
     total: number;
     percent: number;
 }
+/**
+ * 代码上传的分步阶段
+ */
+export type UploadPhase = 'pack' | 'credential' | 'read' | 'upload';
+/**
+ * 单个阶段计时信息（由 uploadCode 的 onPhase 回调触发）
+ */
+export interface IUploadPhaseTiming {
+    /** 阶段名 */
+    phase: UploadPhase;
+    /** 耗时(ms) */
+    durationMs: number;
+    /** 字节数（pack: zip 大小; read/upload: buffer 大小） */
+    bytes?: number;
+}
 /**
  * 上传代码参数
  */
@@ -313,6 +328,8 @@ export interface IUploadCloudAppCodeParams {
     ignore?: string[];
     /** 进度回调 */
     onProgress?: (progress: IProgressData) => void;
+    /** 分步计时回调（各阶段完成时触发，用于 verbose 模式输出耗时） */
+    onPhase?: (timing: IUploadPhaseTiming) => void;
 }
 /**
  * 上传代码结果

package/types/index.d.ts

@@ -56,6 +56,10 @@ declare class CloudBase {
     get storage(): StorageService;
     get database(): DatabaseService;
     get hosting(): HostingService;
+    /**
+     * HTTP Service（CloudBaseGW）访问服务
+     * @deprecated 自 v5.0.0 起 HTTP Service 模块已废弃，请改用 env 下的域名与路由相关 API。
+     */
     get access(): AccessService;
     get mysql(): MysqlService;
     /**