@cloudbase/manager-node 4.11.0-alpha.8 → 4.11.0-alpha.9

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(TCB_BASE_URL=https://tcb.pre.tencentcloudapi.woa.com npm test -- --testPathPattern=cloudApp 2>&1)",
+      "Bash(TCB_BASE_URL=https://tcb.pre.tencentcloudapi.woa.com npm test 2>&1)",
+      "Bash(TCB_BASE_URL=https://tcb.pre.tencentcloudapi.woa.com npm test -- --testPathPattern=cloudApp --testNamePattern=\"获取版本列表\")"
+    ]
+  }
+}

package/lib/cloudApp/index.js

@@ -0,0 +1,243 @@
+"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 __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CloudAppService = void 0;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const error_1 = require("../error");
+const utils_1 = require("../utils");
+const http_request_1 = require("../utils/http-request");
+__exportStar(require("./types"), exports);
+/**
+ * CloudApp 统一部署服务
+ * 提供 Web 应用的创建、查询、删除、版本管理等功能
+ */
+class CloudAppService {
+    constructor(environment) {
+        this.environment = environment;
+        this.tcbService = new utils_1.CloudService(environment.cloudBaseContext, 'tcb', '2018-06-08');
+    }
+    // =========== 应用管理 API ===========
+    /**
+     * 创建/更新 CloudApp 应用
+     * @param params 创建参数
+     */
+    async createApp(params) {
+        const { envId } = this.getEnvInfo();
+        this.validateRequiredParams(params, ['serviceName', 'deployType']);
+        return this.tcbService.request('CreateCloudApp', (0, utils_1.upperCaseObjKey)(Object.assign(Object.assign({}, params), { envId: params.envId || envId })));
+    }
+    /**
+     * 获取 CloudApp 应用列表
+     * @param params 查询参数
+     */
+    async describeAppList(params) {
+        const { envId } = this.getEnvInfo();
+        return this.tcbService.request('DescribeCloudAppList', (0, utils_1.upperCaseObjKey)(Object.assign(Object.assign({}, params), { envId: params.envId || envId })));
+    }
+    /**
+     * 获取 CloudApp 应用详情
+     * @param params 查询参数
+     */
+    async describeAppInfo(params) {
+        const { envId } = this.getEnvInfo();
+        this.validateRequiredParams(params, ['serviceName', 'deployType']);
+        return this.tcbService.request('DescribeCloudAppInfo', (0, utils_1.upperCaseObjKey)(Object.assign(Object.assign({}, params), { envId: params.envId || envId })));
+    }
+    /**
+     * 删除 CloudApp 应用
+     * @param params 删除参数
+     */
+    async deleteApp(params) {
+        const { envId } = this.getEnvInfo();
+        this.validateRequiredParams(params, ['serviceName', 'deployType']);
+        return this.tcbService.request('DeleteCloudApp', (0, utils_1.upperCaseObjKey)(Object.assign(Object.assign({}, params), { envId: params.envId || envId })));
+    }
+    // =========== 版本管理 API ===========
+    /**
+     * 获取 CloudApp 版本详情
+     * 不指定 versionName 或 buildId 时返回最新版本
+     * @param params 查询参数
+     */
+    async describeAppVersion(params) {
+        const { envId } = this.getEnvInfo();
+        this.validateRequiredParams(params, ['serviceName', 'deployType']);
+        return this.tcbService.request('DescribeCloudAppVersion', (0, utils_1.upperCaseObjKey)(Object.assign(Object.assign({}, params), { envId: params.envId || envId })));
+    }
+    /**
+     * 获取 CloudApp 版本列表
+     * @param params 查询参数
+     */
+    async describeAppVersionList(params) {
+        const { envId } = this.getEnvInfo();
+        this.validateRequiredParams(params, ['serviceName', 'deployType']);
+        return this.tcbService.request('DescribeCloudAppVersionList', (0, utils_1.upperCaseObjKey)(Object.assign(Object.assign({}, params), { envId: params.envId || envId })));
+    }
+    /**
+     * 删除 CloudApp 版本
+     * @param params 删除参数
+     */
+    async deleteAppVersion(params) {
+        const { envId } = this.getEnvInfo();
+        this.validateRequiredParams(params, ['serviceName', 'deployType', 'versionName']);
+        return this.tcbService.request('DeleteCloudAppVersion', (0, utils_1.upperCaseObjKey)(Object.assign(Object.assign({}, params), { envId: params.envId || envId })));
+    }
+    // =========== COS 上传相关 API ===========
+    /**
+     * 获取 CloudApp COS 上传信息（预签名 URL）
+     * @param params 查询参数
+     */
+    async describeCosInfo(params) {
+        const { envId } = this.getEnvInfo();
+        this.validateRequiredParams(params, ['serviceName', 'deployType']);
+        return this.tcbService.request('DescribeCloudAppCosInfo', (0, utils_1.upperCaseObjKey)(Object.assign(Object.assign({}, params), { envId: params.envId || envId, suffix: params.suffix || '.zip' })));
+    }
+    // =========== 辅助方法 ===========
+    /**
+     * 上传本地代码到 COS
+     * 自动打包 ZIP 并上传到预签名 URL
+     *
+     * 注意：此方法不依赖应用是否已创建，可在创建应用前调用
+     * 返回的 cosTimestamp 用于 createApp 时传入 staticConfig.cosTimestamp
+     *
+     * @param params 上传参数
+     */
+    async uploadCode(params) {
+        const { serviceName, localPath, ignore = [] } = params;
+        // 1. 验证本地路径
+        if (!fs_1.default.existsSync(localPath)) {
+            throw new error_1.CloudBaseError(`本地路径不存在: ${localPath}`);
+        }
+        const stat = fs_1.default.statSync(localPath);
+        if (!stat.isDirectory()) {
+            throw new error_1.CloudBaseError(`localPath 必须是目录: ${localPath}`);
+        }
+        // 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'];
+        await (0, utils_1.compressToZip)({
+            dirPath: localPath,
+            outputPath: tmpZipPath,
+            ignore: [...defaultIgnore, ...ignore]
+        });
+        try {
+            // 3. 获取上传凭证
+            const cosInfo = await this.describeCosInfo({
+                deployType: params.deployType,
+                serviceName,
+                suffix: '.zip'
+            });
+            // 4. 读取 ZIP 文件
+            const zipBuffer = fs_1.default.readFileSync(tmpZipPath);
+            // 5. 构建请求头
+            const headers = {
+                'Content-Type': 'application/zip'
+            };
+            if (cosInfo.UploadHeaders && cosInfo.UploadHeaders.length > 0) {
+                for (const h of cosInfo.UploadHeaders) {
+                    headers[h.Key] = h.Value;
+                }
+            }
+            // 6. 使用预签名 URL 上传
+            const response = await (0, http_request_1.fetchStream)(cosInfo.UploadUrl, {
+                method: 'PUT',
+                body: zipBuffer,
+                headers
+            });
+            if (!response.ok) {
+                let errorDetail = '';
+                try {
+                    const responseText = await response.text();
+                    errorDetail = responseText ? ` - ${responseText.substring(0, 500)}` : '';
+                }
+                catch (_a) {
+                    // 解析失败时 errorDetail 保持空串，不影响主错误抛出
+                }
+                throw new error_1.CloudBaseError(`上传失败: ${response.status} ${response.statusText}${errorDetail}`);
+            }
+            // 7. 返回结果（返回 cosTimestamp，用于创建应用）
+            return {
+                cosTimestamp: cosInfo.UnixTimestamp,
+                unixTimestamp: cosInfo.UnixTimestamp
+            };
+        }
+        finally {
+            // 8. 清理临时文件
+            if (fs_1.default.existsSync(tmpZipPath)) {
+                fs_1.default.unlinkSync(tmpZipPath);
+            }
+        }
+    }
+    /**
+     * 获取环境信息
+     */
+    getEnvInfo() {
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        return {
+            envId: envConfig.EnvId
+        };
+    }
+    /**
+     * 校验必填参数
+     * @param params 参数对象
+     * @param fields 必填字段列表
+     */
+    validateRequiredParams(params, fields) {
+        for (const field of fields) {
+            if (!params[field]) {
+                throw new error_1.CloudBaseError(`${field} 是必填参数`);
+            }
+        }
+    }
+}
+exports.CloudAppService = CloudAppService;
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "createApp", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "describeAppList", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "describeAppInfo", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "deleteApp", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "describeAppVersion", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "describeAppVersionList", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "deleteAppVersion", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "describeCosInfo", null);
+__decorate([
+    (0, utils_1.preLazy)()
+], CloudAppService.prototype, "uploadCode", null);

package/lib/cloudApp/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * CloudApp 统一部署服务类型定义
+ * 支持 static-hosting（静态托管）和 http-function（预留）两种部署类型
+ *
+ * 命名规范：
+ * - 入参接口（IXxxParams）：camelCase，通过 upperCaseObjKey 转换后透传给 API
+ * - 返回值接口（IXxxResult）：PascalCase，与 API 响应字段保持一致
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/environment.js

@@ -18,6 +18,7 @@ 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) {
@@ -41,6 +42,7 @@ class Environment {
         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) {
@@ -103,6 +105,9 @@ class Environment {
     getMysqlService() {
         return this.mysqlService;
     }
+    getCloudAppService() {
+        return this.cloudAppService;
+    }
     getPermissionService() {
         return this.permissionService;
     }

package/lib/index.js

@@ -70,9 +70,34 @@ class CloudBase {
     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);
     }

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/package.json

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

package/types/cloudApp/index.d.ts

@@ -0,0 +1,73 @@
+import { Environment } from '../environment';
+import { ICreateCloudAppParams, ICreateCloudAppResult, IDescribeCloudAppListParams, IDescribeCloudAppListResult, IDescribeCloudAppInfoParams, IDescribeCloudAppInfoResult, IDeleteCloudAppParams, IDeleteCloudAppResult, IDescribeCloudAppVersionParams, IDescribeCloudAppVersionResult, IDescribeCloudAppVersionListParams, IDescribeCloudAppVersionListResult, IDeleteCloudAppVersionParams, IDeleteCloudAppVersionResult, IDescribeCloudAppCosInfoParams, IDescribeCloudAppCosInfoResult, IUploadCloudAppCodeParams, IUploadCloudAppCodeResult } from './types';
+export * from './types';
+/**
+ * CloudApp 统一部署服务
+ * 提供 Web 应用的创建、查询、删除、版本管理等功能
+ */
+export declare class CloudAppService {
+    private tcbService;
+    private environment;
+    constructor(environment: Environment);
+    /**
+     * 创建/更新 CloudApp 应用
+     * @param params 创建参数
+     */
+    createApp(params: ICreateCloudAppParams): Promise<ICreateCloudAppResult>;
+    /**
+     * 获取 CloudApp 应用列表
+     * @param params 查询参数
+     */
+    describeAppList(params: IDescribeCloudAppListParams): Promise<IDescribeCloudAppListResult>;
+    /**
+     * 获取 CloudApp 应用详情
+     * @param params 查询参数
+     */
+    describeAppInfo(params: IDescribeCloudAppInfoParams): Promise<IDescribeCloudAppInfoResult>;
+    /**
+     * 删除 CloudApp 应用
+     * @param params 删除参数
+     */
+    deleteApp(params: IDeleteCloudAppParams): Promise<IDeleteCloudAppResult>;
+    /**
+     * 获取 CloudApp 版本详情
+     * 不指定 versionName 或 buildId 时返回最新版本
+     * @param params 查询参数
+     */
+    describeAppVersion(params: IDescribeCloudAppVersionParams): Promise<IDescribeCloudAppVersionResult>;
+    /**
+     * 获取 CloudApp 版本列表
+     * @param params 查询参数
+     */
+    describeAppVersionList(params: IDescribeCloudAppVersionListParams): Promise<IDescribeCloudAppVersionListResult>;
+    /**
+     * 删除 CloudApp 版本
+     * @param params 删除参数
+     */
+    deleteAppVersion(params: IDeleteCloudAppVersionParams): Promise<IDeleteCloudAppVersionResult>;
+    /**
+     * 获取 CloudApp COS 上传信息（预签名 URL）
+     * @param params 查询参数
+     */
+    describeCosInfo(params: IDescribeCloudAppCosInfoParams): Promise<IDescribeCloudAppCosInfoResult>;
+    /**
+     * 上传本地代码到 COS
+     * 自动打包 ZIP 并上传到预签名 URL
+     *
+     * 注意：此方法不依赖应用是否已创建，可在创建应用前调用
+     * 返回的 cosTimestamp 用于 createApp 时传入 staticConfig.cosTimestamp
+     *
+     * @param params 上传参数
+     */
+    uploadCode(params: IUploadCloudAppCodeParams): Promise<IUploadCloudAppCodeResult>;
+    /**
+     * 获取环境信息
+     */
+    private getEnvInfo;
+    /**
+     * 校验必填参数
+     * @param params 参数对象
+     * @param fields 必填字段列表
+     */
+    private validateRequiredParams;
+}

package/types/cloudApp/types.d.ts

@@ -0,0 +1,325 @@
+/**
+ * CloudApp 统一部署服务类型定义
+ * 支持 static-hosting（静态托管）和 http-function（预留）两种部署类型
+ *
+ * 命名规范：
+ * - 入参接口（IXxxParams）：camelCase，通过 upperCaseObjKey 转换后透传给 API
+ * - 返回值接口（IXxxResult）：PascalCase，与 API 响应字段保持一致
+ */
+/**
+ * 部署类型
+ * - static-hosting: 静态托管部署
+ * - http-function: HTTP 云函数部署（预留）
+ */
+export type DeployType = 'static-hosting' | 'http-function';
+/**
+ * 构建类型
+ * - GIT: 从 Git 仓库构建
+ * - ZIP: 从 ZIP 包构建
+ * - TEMPLATE: 从模板构建
+ */
+export type BuildType = 'GIT' | 'ZIP' | 'TEMPLATE';
+/**
+ * 构建状态
+ */
+export type BuildStatus = 'BUILDING' | 'SUCCESS' | 'FAILED';
+/**
+ * 构建命令配置（入参）
+ */
+export interface IStaticCmd {
+    buildCmd?: string;
+    installCmd?: string;
+    deployCmd?: string;
+}
+/**
+ * 静态环境变量配置（入参）
+ */
+export interface IStaticEnv {
+    variables?: Array<{
+        key: string;
+        value: string;
+    }>;
+}
+/**
+ * 静态托管配置（入参）
+ */
+export interface IStaticConfig {
+    /** 框架类型：vue、react、nextjs 等 */
+    framework?: string;
+    /** Node.js 版本，默认 20 */
+    nodeJsVersion?: string;
+    /** 访问路径 */
+    appPath?: string;
+    /** 构建目录 */
+    buildPath?: string;
+    /** ZIP 文件地址（BuildType=ZIP/TEMPLATE 时使用） */
+    zipFileUrl?: string;
+    /** COS 时间戳（通过 uploadCode 上传后获取，BuildType=ZIP 时使用） */
+    cosTimestamp?: string;
+    /** COS 文件后缀 */
+    cosSuffix?: string;
+    /** 代码源平台：github、gitlab、gitee */
+    codeSource?: string;
+    /** 代码仓库 */
+    codeRepo?: string;
+    /** 代码分支 */
+    codeBranch?: string;
+    /** 构建命令配置 */
+    staticCmd?: IStaticCmd;
+    /** 构建环境变量 */
+    staticEnv?: IStaticEnv;
+}
+/**
+ * 静态托管构建命令配置（API 响应）
+ */
+export interface StaticCmd {
+    BuildCmd?: string;
+    InstallCmd?: string;
+    DeployCmd?: string;
+}
+/**
+ * 静态托管环境变量配置（API 响应，对应文档 StaticEnvironment）
+ */
+export interface StaticEnv {
+    /** 环境变量数组，可能为 null */
+    Variables?: Array<{
+        Key: string;
+        Value: string;
+    }> | null;
+}
+/**
+ * 静态托管配置（API 响应，对应文档 StaticConfig）
+ * 被 CreateCloudApp、DescribeCloudAppVersion、DescribeCloudAppVersionList 引用
+ * 注意：所有字段均可能返回 null
+ */
+export interface CloudAppStaticConfig {
+    /** 框架类型：vue、react、nextjs 等 */
+    Framework?: string | null;
+    /** Node.js 版本，默认 20 */
+    NodeJsVersion?: string | null;
+    /** 访问路径 */
+    AppPath?: string | null;
+    /** 构建目录 */
+    BuildPath?: string | null;
+    /** ZIP 文件地址（BuildType=ZIP/TEMPLATE 时使用） */
+    ZipFileUrl?: string | null;
+    /** COS 时间戳 */
+    CosTimestamp?: string | null;
+    /** COS 文件后缀 */
+    CosSuffix?: string | null;
+    /** 代码源平台：github、gitlab、gitee */
+    CodeSource?: string | null;
+    /** 代码仓库 */
+    CodeRepo?: string | null;
+    /** 代码分支 */
+    CodeBranch?: string | null;
+    /** 构建命令配置 */
+    StaticCmd?: StaticCmd | null;
+    /** 构建环境变量 */
+    StaticEnv?: StaticEnv | null;
+}
+/**
+ * 应用列表项（API 响应 CloudAppServiceItem）
+ */
+export interface CloudAppServiceItem {
+    ServiceName: string;
+    DeployType: string;
+    Framework?: string;
+    Domain?: string;
+    AppPath?: string;
+    CreateTime: string;
+    LatestVersionName?: string;
+    LatestStatus?: string;
+    LatestBuildTime?: string;
+}
+/** @deprecated 请使用 CloudAppServiceItem */
+export type CloudAppItem = CloudAppServiceItem;
+/**
+ * 版本信息（API 响应 CloudAppVersionItem）
+ */
+export interface CloudAppVersion {
+    VersionName: string;
+    BuildId: string;
+    BuildType?: string;
+    Status: string;
+    Framework?: string;
+    BuildTime?: string;
+    StaticConfig?: CloudAppStaticConfig;
+}
+export interface ICreateCloudAppParams {
+    /** 环境 ID（可选，默认从 Environment 获取） */
+    envId?: string;
+    /** 部署类型：static-hosting / http-function */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 构建类型：GIT / ZIP / TEMPLATE */
+    buildType?: BuildType;
+    /** 静态托管配置（deployType 为 static-hosting 时使用） */
+    staticConfig?: IStaticConfig;
+}
+export interface ICreateCloudAppResult {
+    ServiceName: string;
+    BuildId: string;
+    VersionName: string;
+    RequestId: string;
+}
+export interface IDescribeCloudAppListParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 页码（从 1 开始） */
+    pageNo?: number;
+    /** 每页大小 */
+    pageSize?: number;
+    /** 搜索关键字，按应用名模糊搜索 */
+    searchKey?: string;
+}
+export interface IDescribeCloudAppListResult {
+    Total: number;
+    ServiceList: CloudAppServiceItem[];
+    RequestId: string;
+}
+export interface IDescribeCloudAppInfoParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+}
+export interface IDescribeCloudAppInfoResult {
+    ServiceName: string;
+    DeployType: string;
+    Framework?: string;
+    Domain?: string;
+    AppPath?: string;
+    CreateTime: string;
+    LatestVersionName?: string;
+    LatestStatus?: string;
+    LatestBuildTime?: string;
+    RequestId: string;
+}
+export interface IDeleteCloudAppParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+}
+export interface IDeleteCloudAppResult {
+    Result: boolean;
+    RequestId: string;
+}
+export interface IDescribeCloudAppVersionParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 版本名称（与 buildId 二选一） */
+    versionName?: string;
+    /** 构建 ID（与 versionName 二选一） */
+    buildId?: string;
+}
+export interface IDescribeCloudAppVersionResult {
+    BuildType: string;
+    BuildId: string;
+    Status: BuildStatus;
+    Framework?: string;
+    StaticConfig?: CloudAppStaticConfig;
+    BuildTime?: string;
+    RequestId: string;
+}
+export interface IDescribeCloudAppVersionListParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 页码（从 1 开始） */
+    pageNo?: number;
+    /** 每页大小 */
+    pageSize?: number;
+}
+export interface IDescribeCloudAppVersionListResult {
+    Total: number;
+    VersionList: CloudAppVersion[] | null;
+    RequestId: string;
+}
+export interface IDeleteCloudAppVersionParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 版本名称 */
+    versionName: string;
+}
+export interface IDeleteCloudAppVersionResult {
+    Result: boolean;
+    RequestId: string;
+}
+export interface IDescribeCloudAppCosInfoParams {
+    /** 环境 ID（可选） */
+    envId?: string;
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** Unix 时间戳（用于指定文件路径，不传则自动生成） */
+    unixTimestamp?: string;
+    /** 文件后缀（默认 .zip） */
+    suffix?: string;
+    /** 是否需要下载 URL */
+    needDownload?: boolean;
+}
+export interface CosHeader {
+    Key: string;
+    Value: string;
+}
+export interface IDescribeCloudAppCosInfoResult {
+    UploadUrl: string;
+    UploadHeaders?: CosHeader[];
+    DownloadUrl?: string;
+    DownloadHeaders?: CosHeader[];
+    UnixTimestamp: string;
+    RequestId: string;
+}
+/**
+ * 上传进度信息
+ */
+export interface IProgressData {
+    loaded: number;
+    total: number;
+    percent: number;
+}
+/**
+ * 上传代码参数
+ */
+export interface IUploadCloudAppCodeParams {
+    /** 部署类型 */
+    deployType: DeployType;
+    /** 服务名称 */
+    serviceName: string;
+    /** 本地文件夹路径 */
+    localPath: string;
+    /** 忽略的文件/目录模式 */
+    ignore?: string[];
+    /** 进度回调 */
+    onProgress?: (progress: IProgressData) => void;
+}
+/**
+ * 上传代码结果
+ */
+export interface IUploadCloudAppCodeResult {
+    /** COS 时间戳（用于 createApp 时传入 staticConfig.cosTimestamp） */
+    cosTimestamp: string;
+    /** Unix 时间戳（与 cosTimestamp 相同） */
+    unixTimestamp: string;
+}

package/types/environment.d.ts

@@ -13,6 +13,7 @@ import { AccessService } from './access';
 import { UserService } from './user';
 import { CloudBaseRunService } from './cloudBaseRun';
 import { MysqlService } from './mysql';
+import { CloudAppService } from './cloudApp';
 import { EnvInfo } from './interfaces';
 import { PermissionService } from './permission';
 export declare class Environment {
@@ -35,6 +36,7 @@ export declare class Environment {
     private cloudBaseRunService;
     private mysqlService;
     private permissionService;
+    private cloudAppService;
     constructor(context: CloudBaseContext, envId: string);
     lazyInit(): Promise<any>;
     getEnvId(): string;
@@ -52,6 +54,7 @@ export declare class Environment {
     getUserService(): UserService;
     getCloudBaseRunService(): CloudBaseRunService;
     getMysqlService(): MysqlService;
+    getCloudAppService(): CloudAppService;
     getPermissionService(): PermissionService;
     getCommonService(serviceType: string, serviceVersion: any): CommonService;
     getServicesEnvInfo(): Promise<any>;

package/types/index.d.ts

@@ -16,6 +16,7 @@ import { CloudBaseRunService } from './cloudBaseRun';
 import { MysqlService } from './mysql';
 import { DocsService } from './docs';
 import { PermissionService } from './permission';
+import { CloudAppService } from './cloudApp';
 interface CloudBaseConfig {
     secretId?: string;
     secretKey?: string;
@@ -53,7 +54,26 @@ declare class CloudBase {
     get hosting(): HostingService;
     get access(): AccessService;
     get mysql(): MysqlService;
+    /**
+     * 云托管服务（CloudBaseRun）
+     * 提供云托管版本流量配置等能力
+     * @deprecated 请使用 cloudBaseRun 代替，避免与 cloudAppService 混淆
+     */
     get cloudApp(): CloudBaseRunService;
+    /**
+     * 云托管服务（CloudBaseRun）
+     * 提供云托管版本流量配置等能力
+     */
+    get cloudBaseRun(): CloudBaseRunService;
+    /**
+     * 云应用服务（CloudApp 统一部署）
+     * 提供 Web 应用的创建、部署、版本管理等能力
+     */
+    get cloudAppService(): CloudAppService;
+    /**
+     * 获取云应用服务
+     */
+    getCloudAppService(): CloudAppService;
     commonService(service?: string, version?: string): CommonService;
     get env(): EnvService;
     get log(): LogService;

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

@@ -0,0 +1,4 @@
+/**
+ * CloudApp 统一部署服务接口导出
+ */
+export * from '../cloudApp/types';

package/types/interfaces/index.d.ts

@@ -5,3 +5,4 @@ export * from './base.interface';
 export * from './storage.interface';
 export * from './cam.interface';
 export * from './billing.interface';
+export * from './cloudApp.interface';