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

package/cloudbase-manager-node/.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/cloudbase-manager-node/.editorconfig

@@ -0,0 +1,8 @@
+root = true
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

package/cloudbase-manager-node/.eslintignore

@@ -0,0 +1,3 @@
+lib/
+types/
+node_modules

package/cloudbase-manager-node/.eslintrc.js

@@ -0,0 +1,27 @@
+module.exports = {
+    extends: ['alloy', 'alloy/typescript'],
+    rules: {
+        indent: ['error', 4],
+        semi: ['error', 'never'],
+        complexity: ['error', { max: 40 }],
+        'no-useless-constructor': 'off',
+        '@typescript-eslint/explicit-member-accessibility': 'off',
+        '@typescript-eslint/explicit-function-return-type': 'off',
+        '@typescript-eslint/interface-name-prefix': 'off',
+        '@typescript-eslint/no-useless-constructor': 'off',
+        '@typescript-eslint/no-duplicate-imports': 'off'
+    },
+    env: {
+        es6: true,
+        node: true,
+        jest: true
+    },
+    overrides: [
+        {
+            files: ['*.js'],
+            rules: {
+                '@typescript-eslint/no-var-requires': 'off'
+            }
+        }
+    ]
+}

package/cloudbase-manager-node/.prettierrc.js

@@ -0,0 +1,31 @@
+module.exports = {
+    // 一行最多 100 字符
+    printWidth: 100,
+    // 使用 4 个空格缩进
+    tabWidth: 4,
+    // 不使用缩进符，而使用空格
+    useTabs: false,
+    // 行尾需要有分号
+    semi: false,
+    // 使用单引号
+    singleQuote: true,
+    // 对象的 key 仅在必要时用引号
+    quoteProps: 'as-needed',
+    // 末尾不需要逗号
+    trailingComma: 'none',
+    // 大括号内的首尾需要空格
+    bracketSpacing: true,
+    // 每个文件格式化的范围是文件的全部内容
+    rangeStart: 0,
+    rangeEnd: Infinity,
+    // 不需要写文件开头的 @prettier
+    requirePragma: false,
+    // 不需要自动在文件开头插入 @prettier
+    insertPragma: false,
+    // 使用默认的折行标准
+    proseWrap: 'preserve',
+    // 换行符使用 lf
+    endOfLine: 'lf',
+    // 箭头括号
+    arrowParens: 'avoid'
+}

package/cloudbase-manager-node/CHANGELOG.md

@@ -0,0 +1,109 @@
+# 4.0.0
+- 升级 https-proxy-agent 3->5 修复 https://github.com/TencentCloud/tencentcloud-sdk-nodejs/issues/47
+
+
+# v3.9.2-beta
+-   扩展禁用用户接口为变更用户状态接口
+-   增加修改用户信息接口
+
+# v3.5.0
+
+-   新增获取云开发用户列表接口
+-   新增停用云开发用户接口
+-   新增批量删除云开发用户接口
+
+# v3.4.0
+
+-   增加云接入服务
+-   创建函数支持同时创建云接入
+-   优化请求错误栈
+
+# v3.3.2
+
+-   函数轮询状态时间修复 30s => 300s
+
+# v3.3.0
+
+-   静态托管支持配置重定向规则
+-   新增删除静态托管自定义域名接口
+-   新增获取静态网站配置接口
+-   新增获取域名配置接口
+-   新增域名配置接口
+
+# v3.2.0
+
+-   新增静态托管查询文件，配置文档，绑定自定义域名接口
+
+# v3.1.1
+
+-   优化文件夹删除接口
+-   增加批量上传文件接口
+-   修复静态网站上传单个文件没有回调的问题
+
+# v3.0.0
+
+-   [fix] common 方法改造
+-   [add] 支持数据库 CRUD
+
+# v2.4.1
+
+-   [fix] 修复并行调用 createFunction 接口报错的问题
+-   [add] 支持通过指定函数路径创建函数
+
+# v2.4.0
+
+-   [add] 新增安全来源 API
+-   [fix] 修复云函数环境下取环境变量 bug (入口函数外部调用，未取到报错)
+
+# v2.3.4
+
+-   [fix] 修复函数配置更新问题
+
+# v2.3.2
+
+-   [fix] 修复更新函数 VPC 配置导致无法访问公网的问题
+
+# v2.3.1
+
+-   [fix] 修复创建函数、更新函数代码，代码保护参数遗漏的问题
+
+# v2.3.0
+
+-   [add] 支持文件层
+-   [add] 支持查询修改存储安全规则异步任务状态
+-   [fix] 文档订正
+
+# v2.2.1
+
+-   [fix] 修复查询所有集合信息接口，集合为空时报错
+-   [fix] updateFunctionCode 支持自动安装依赖
+
+# v2.2.0
+
+-   [fix] 修复上传文件夹等接口 `onFileFinish` 参数 TS 定义错误
+-   [add] 创建云函数返回 RequestId 响应值
+-   [add] 支持 L5 选项
+
+# v2.1.0
+
+-   [add] 支持上传或更新函数时 等待依赖安装完成
+-   [add] 支持增量上传函数代码
+-   [add] 新增创建自定义登录私钥
+-   [add] 新增 HTTP Service API
+-   [add] 新增安全规则 API
+
+# v2.0.0
+
+-   [refactor] 重构 storage , function 接口(breaking change)
+-   [add] 支持闭环完成环境创建
+-   [add] 支持函数操作代码保护
+-   [fix] 修复 windows 下上传文件路径 bug
+
+# v1.3.0
+
+-   [add] 支持获取云函数代码下载链接
+
+# v1.2.0
+
+-   [deprecated] env 创建环境功能暂时停用
+-   [add] 支持创建云函数自动安装依赖

package/cloudbase-manager-node/LICENSE

@@ -0,0 +1,6 @@
+ISC License (ISC)
+Copyright <2019> <Tencent Cloud Base>
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/cloudbase-manager-node/README.md

@@ -0,0 +1,46 @@
+# cloudbase-manager-node
+
+云开发 manager-node 支持开发者通过接口形式对云开发提供的云函数、数据库、文件存储等资源进行创建、管理、配置等操作。更多源码内容请参见 [cloudbase-manager-node](https://github.com/TencentCloudBase/cloudbase-manager-node)。
+
+## 安装
+
+npm
+
+```bash
+npm install @cloudbase/manager-node
+```
+
+yarn
+
+```bash
+yarn add @cloudbase/manager-node
+```
+
+## 使用
+
+要在你的代码内使用该模块：
+
+```js
+const CloudBase = require('@cloudbase/manager-node')
+```
+
+或
+
+```js
+import CloudBase from '@cloudbase/manager-node'
+```
+
+初始化
+
+```js
+const app = CloudBase.init({
+    secretId: 'Your SecretId',
+    secretKey: 'Your SecretKey',
+    token: 'Your SecretToken', // 使用临时凭证需要此字段
+    envId: 'Your envId' // 云环境 ID，可在腾讯云-云开发控制台获取
+})
+```
+
+## 文档
+
+请访问新的[文档站点](https://docs.cloudbase.net/api-reference/manager/node/introduction.html)查看详细的文档。

package/cloudbase-manager-node/jest.config.js

@@ -0,0 +1,18 @@
+module.exports = {
+    roots: ['<rootDir>/test'],
+    globals: {
+        'ts-jest': {
+            tsConfig: 'tsconfig.test.json'
+        }
+    },
+    transform: {
+        '^.+\\.ts?$': 'ts-jest'
+    },
+    transformIgnorePatterns: ['node_modules'],
+    testEnvironment: 'node',
+    forceExit: true,
+    // https://github.com/facebook/jest/issues/5164
+    globalSetup: './test/global-setup-hook.ts',
+    // globalTeardown: './test/global-teardown-hook.js',
+    coverageReporters: ['json', 'lcov', 'clover', 'text-summary']
+}

package/cloudbase-manager-node/package.json

@@ -0,0 +1,70 @@
+{
+    "name": "@cloudbase/manager-node",
+    "version": "5.0.2",
+    "description": "The node manage service api for cloudbase.",
+    "main": "lib/index.js",
+    "scripts": {
+        "build": "rimraf lib types && npx tsc",
+        "test:coverage": "jest --runInBand --detectOpenHandles --coverage --testTimeout=100000",
+        "test": "jest --runInBand --detectOpenHandles --testTimeout=100000",
+        "lint": "eslint \"./**/*.ts\"",
+        "lint:fix": "eslint --fix \"./**/*.ts\"",
+        "prepublishOnly": "npm run build",
+        "watch": "rimraf lib types && tsc -w",
+        "link": "node scripts/link.js",
+        "unlink": "node scripts/link.js -d"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/TencentCloudBase/cloudbase-manager-node.git"
+    },
+    "author": "Tencent CloudBase Team",
+    "license": "ISC",
+    "typings": "types/index.d.ts",
+    "devDependencies": {
+        "@lerna/create-symlink": "^6.4.1",
+        "@types/fs-extra": "^11.0.4",
+        "@types/jest": "^24.0.18",
+        "@types/node": "^12.7.4",
+        "@types/node-fetch": "^2.5.0",
+        "@types/unzipper": "^0.10.11",
+        "@typescript-eslint/eslint-plugin": "^3.7.1",
+        "@typescript-eslint/parser": "^3.7.1",
+        "eslint": "^7.6.0",
+        "eslint-config-alloy": "^3.7.4",
+        "husky": "^3.0.5",
+        "jest": "^24.9.0",
+        "lint-staged": "^9.2.5",
+        "rimraf": "^3.0.0",
+        "ts-jest": "^24.1.0",
+        "typescript": "^5.8.3"
+    },
+    "dependencies": {
+        "@cloudbase/database": "^0.6.2",
+        "archiver": "^3.1.1",
+        "cos-nodejs-sdk-v5": "^2.14.0",
+        "del": "^5.1.0",
+        "fs-extra": "^11.3.0",
+        "https-proxy-agent": "^5.0.1",
+        "lodash": "^4.17.21",
+        "make-dir": "^3.0.0",
+        "micromatch": "^4.0.2",
+        "node-fetch": "^2.6.0",
+        "query-string": "^6.8.3",
+        "unzipper": "^0.12.3",
+        "uuid": "^9.0.0",
+        "walkdir": "^0.4.1"
+    },
+    "husky": {
+        "hooks": {
+            "pre-commit": "npm run build && git add . && lint-staged"
+        }
+    },
+    "lint-staged": {
+        "*.ts": [
+            "eslint --fix",
+            "git add"
+        ]
+    },
+    "packageManager": "yarn@1.22.22"
+}

package/cloudbase-manager-node/scripts/link.js

@@ -0,0 +1,98 @@
+/**
+ * Tencent is pleased to support the open source community by making CloudBaseFramework - 云原生一体化部署工具 available.
+ *
+ * Copyright (C) 2020 THL A29 Limited, a Tencent company.  All rights reserved.
+ *
+ * Please refer to license text included with this package for license details.
+ */
+
+const os = require('os')
+const fs = require('fs')
+const fse = require('fs-extra')
+const del = require('del')
+const path = require('path')
+const mkdirp = require('mkdirp')
+const { execSync } = require('child_process')
+const { createSymlink } = require('@lerna/create-symlink')
+
+const globalNpmPath = execSync('npm root -g', {
+    encoding: 'utf-8'
+}).trim()
+// 如果不支持workspace 可以用下面写死
+// const globalNpmPath = '/usr/local/lib/node_modules';
+
+async function main() {
+    const unlink = process.argv?.[2] === '-d'
+    await linkCore(unlink)
+}
+
+async function linkCore(unlink = false) {
+    const jsonString = await fs.readFileSync(path.join(__dirname, '../package.json'))
+    const { name } = JSON.parse(jsonString)
+    await link(path.join(process.cwd()), path.join(globalNpmPath, '@cloudbase/cli'), name, unlink)
+}
+
+function isSymlink(path) {
+    const stats = fs.lstatSync(path)
+    return stats.isSymbolicLink()
+}
+
+// 将 global tcb cli 工具中的 framework-core link 到 packages/framework-core
+async function link(src, dest, packageName, unlink = false) {
+    const prevCwd = process.cwd()
+    const destPlugin = path.join(dest, 'node_modules', '@cloudbase')
+    // 确保目录存在
+    mkdirp.sync(destPlugin)
+    // 切换 cwd
+    process.chdir(destPlugin)
+
+    const pathName = packageName.replace('@cloudbase/', '')
+    const backupPathName = `${pathName}_backup`
+
+    if (unlink) {
+        if (fs.existsSync(pathName) && !isSymlink(pathName)) {
+            console.log(`【失败】${pathName} 不是软链接`, process.cwd())
+            return
+        }
+
+        if (fs.existsSync(pathName) && fs.existsSync(backupPathName)) {
+            // 删除软链接
+            del.sync([pathName])
+
+            // 恢复备份
+            fse.moveSync(backupPathName, pathName)
+
+            // 删除软链接
+            console.log('【成功】删除软链接：', process.cwd())
+        } else {
+            console.info(
+                `不存在 ${pathName} 或 ${backupPathName}，请重装安装 npm i @cloudbase/cli -g`,
+                process.cwd()
+            )
+        }
+    } else {
+        // 创建软链接
+
+        if (fs.existsSync(pathName)) {
+            if (!fs.existsSync(backupPathName)) {
+                // 不存在备份则进行备份
+
+                if (!isSymlink(pathName)) {
+                    // 不是软链接才备份
+                    fse.moveSync(pathName, backupPathName)
+                }
+            } else {
+                // 存在备份则直接删除
+                del.sync([pathName])
+            }
+        }
+
+        await createSymlink(src, pathName, 'junction')
+        console.log('【成功】创建软链接：', process.cwd())
+    }
+
+    // 切回源目录
+    process.chdir(prevCwd)
+}
+
+main()

package/cloudbase-manager-node/tsconfig.json

@@ -0,0 +1,19 @@
+{
+    "compileOnSave": true,
+    "compilerOptions": {
+        "module": "commonjs",
+        "target": "ES2017",
+        "moduleResolution": "node",
+        "outDir": "lib",
+        "removeComments": false,
+        "types": ["node"],
+        "esModuleInterop": true,
+        "declaration": true,
+        "declarationDir": "./types",
+        "experimentalDecorators": true,
+        "newLine": "LF",
+        "skipLibCheck": true
+    },
+    "include": ["src/**/*"],
+    "exclude": ["node_modules", "test"]
+}

package/cloudbase-manager-node/tsconfig.test.json

@@ -0,0 +1,14 @@
+{
+    "compileOnSave": true,
+    "compilerOptions": {
+        "experimentalDecorators": true,
+        "module": "commonjs",
+        "target": "ES2017",
+        "moduleResolution": "node",
+        "outDir": "lib",
+        "types": ["node", "jest"],
+        "esModuleInterop": true
+    },
+    "include": ["src/**/*", "test/**/*"],
+    "exclude": ["node_modules"]
+}

package/jest.config.js

@@ -10,6 +10,7 @@ module.exports = {
     },
     transformIgnorePatterns: ['node_modules'],
     testEnvironment: 'node',
+    forceExit: true,
     // https://github.com/facebook/jest/issues/5164
     globalSetup: './test/global-setup-hook.ts',
     // globalTeardown: './test/global-teardown-hook.js',

package/lib/agent/index.js

@@ -28,14 +28,14 @@ class AgentService {
     }
     // ==================== SCF 云函数部署 ====================
     /**
-     * 创建 SCF Agent
+     * 创建 Agent
      * 支持两种方式：
      * 1. 传入 cwd 代码目录，自动打包上传
      * 2. 传入 ZipFile / CosBucketRegion + TempCosObjectName，直接上传
      * @param params 创建参数
      * @returns Agent 创建结果
      */
-    async createScfAgent(params) {
+    async createAgent(params) {
         const envConfig = this.environment.lazyEnvironmentConfig;
         // 默认会话配置
         const defaultSessionConfig = {
@@ -622,7 +622,7 @@ class AgentService {
 exports.AgentService = AgentService;
 __decorate([
     (0, utils_1.preLazy)()
-], AgentService.prototype, "createScfAgent", null);
+], AgentService.prototype, "createAgent", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], AgentService.prototype, "describeAgentList", null);

package/lib/cloudrun/index.js

@@ -346,34 +346,6 @@ class CloudRunService {
     async getTemplates() {
         return (0, utils_1.fetchTemplates)(['tcbrFunc', 'tcbrContainer']);
     }
-    async _checkFunctionExist(name) {
-        try {
-            await this.detail({
-                serverName: name
-            });
-            return true;
-        }
-        catch (e) {
-            if (e.code === 'ResourceNotFound' ||
-                e.code === 'ResourceNotFound.ServerNotFound' ||
-                // 备注：以下条件当 NotFound 处理（已与 fisheryan 确认过）
-                (e.code === 'InvalidParameter' && e.original.Message === 'service data illegal')) {
-                return false;
-            }
-            throw e;
-        }
-    }
-    _upsertFunction(isNew, data) {
-        const { name, deployInfo, serverConfig } = data;
-        const envConfig = this.environment.lazyEnvironmentConfig;
-        const Items = parseObjectToDiffConfigItem(serverConfig);
-        return this.tcbrService.request(isNew ? 'CreateCloudRunServer' : 'UpdateCloudRunServer', {
-            EnvId: envConfig.EnvId,
-            ServerName: name,
-            DeployInfo: deployInfo,
-            Items,
-        });
-    }
     /**
      * 获取部署记录列表，按部署时间倒序（最新在前）
      */
@@ -408,6 +380,34 @@ class CloudRunService {
             RunId: params.RunId,
         });
     }
+    async _checkFunctionExist(name) {
+        try {
+            await this.detail({
+                serverName: name
+            });
+            return true;
+        }
+        catch (e) {
+            if (e.code === 'ResourceNotFound' ||
+                e.code === 'ResourceNotFound.ServerNotFound' ||
+                // 备注：以下条件当 NotFound 处理（已与 fisheryan 确认过）
+                (e.code === 'InvalidParameter' && e.original.Message === 'service data illegal')) {
+                return false;
+            }
+            throw e;
+        }
+    }
+    _upsertFunction(isNew, data) {
+        const { name, deployInfo, serverConfig } = data;
+        const envConfig = this.environment.lazyEnvironmentConfig;
+        const Items = parseObjectToDiffConfigItem(serverConfig);
+        return this.tcbrService.request(isNew ? 'CreateCloudRunServer' : 'UpdateCloudRunServer', {
+            EnvId: envConfig.EnvId,
+            ServerName: name,
+            DeployInfo: deployInfo,
+            Items,
+        });
+    }
 }
 exports.CloudRunService = CloudRunService;
 __decorate([

package/lib/env/index.js

@@ -508,6 +508,98 @@ 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;
+        // 查询domain下的路由
+        const queryRes = await this.describeHttpServiceRoute({
+            EnvId,
+            Filters: [
+                {
+                    Name: 'Domain',
+                    Values: [Domain]
+                }
+            ]
+        });
+        const domains = queryRes.Domains || [];
+        const targetDomain = domains.find(d => d.Domain === Domain);
+        if (!targetDomain) {
+            throw new error_1.CloudBaseError(`Domain ${Domain} does not exist`);
+        }
+        // 检查是否有路由绑定
+        const routes = targetDomain.Routes || [];
+        if (routes.length > 0) {
+            const routePaths = routes.map(r => r.Path).join(', ');
+            throw new error_1.CloudBaseError(`Domain ${Domain} has ${routes.length} route binding(s) (${routePaths}). Please delete the routes before deleting the domain.`);
+        }
+        // 无路由绑定，可以删除域名
+        return this.cloudService.request('DeleteHTTPServiceRoute', {
+            EnvId,
+            Domain
+        });
+    }
     // 获取 COS CORS 域名
     async getCOSDomains() {
         const cos = this.getCos();

package/lib/function/index.js

@@ -1477,14 +1477,16 @@ class FunctionService {
         });
     }
     /**
-     * 通过scf COS 上传方式（通过 GetTempCosInfo + COS SDK 上传）
+     * 通过 SCF COS 上传方式（通过 GetTempCosInfo + COS SDK 上传）
      * 返回 TempCosObjectName 用于创建/更新函数
      */
-    async uploadFunctionZipToCosLegacy(options, installDependency) {
+    async uploadFunctionZipToCos(options, installDependency) {
         const { func, functionPath, functionRootPath } = options;
-        const { env } = this.getFunctionConfig();
-        const { CloudAppId } = await this.userService.getTcbAccountInfo();
-        const objectPath = `${CloudAppId}/${env}/${func.name}.zip`;
+        const { env, appId } = this.getFunctionConfig();
+        if (!appId) {
+            throw new error_1.CloudBaseError('无法获取 AppId，请确认环境已开通存储服务');
+        }
+        const objectPath = `${appId}/${env}/${func.name}.zip`;
         // 1. 生成存放函数包的临时 Cos 目录
         const { Date: cosDate, Sign } = await this.scfService.request('GetTempCosInfo', {
             ObjectPath: `${objectPath}`
@@ -1545,10 +1547,11 @@ class FunctionService {
         });
     }
     /**
-     * 新的 COS 上传方式（通过 DescribeBuildServiceCosInfo + PUT 上传）
+     * 旧的 COS 上传方式（通过 DescribeBuildServiceCosInfo + PUT 上传）
      * 返回 CosTimestamp 用于创建/更新函数
+     * @deprecated 请使用 uploadFunctionZipToCos 代替
      */
-    async uploadFunctionZipToCos(options, installDependency) {
+    async uploadFunctionZipToCosLegacy(options, installDependency) {
         const { func, functionPath, functionRootPath } = options;
         const { env } = this.getFunctionConfig();
         // 1. 生成存放函数包的临时 Cos 目录
@@ -1649,13 +1652,13 @@ class FunctionService {
                 ZipFile: base64
             };
         }
-        // 默认走 COS 上传
+        // 默认走 COS 上传（GetTempCosInfo + COS SDK）
         console.log(`[${func.name}] 部署方式: COS 上传`);
         const region = this.environment.cloudBaseContext.region || constant_1.SCF_TEMP_COS.DEFAULT_REGION;
-        const legacyResult = await this.uploadFunctionZipToCosLegacy(options, installDependency);
+        const result = await this.uploadFunctionZipToCos(options, installDependency);
         return {
             CosBucketRegion: region,
-            TempCosObjectName: `/${legacyResult.Key}`
+            TempCosObjectName: `/${result.Key}`
         };
     }
     async createAccessPath(name, path) {
@@ -1717,11 +1720,14 @@ class FunctionService {
      * @memberof FunctionService
      */
     getFunctionConfig() {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         const envConfig = this.environment.lazyEnvironmentConfig;
         // Functions 可能为空
         const namespace = ((_b = (_a = envConfig.Functions) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.Namespace) || '';
-        const appId = (_d = (_c = envConfig.Storages) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.AppId;
+        // AppId 可能为空字符串，从 Bucket 名称中提取
+        // COS Bucket 格式: {BucketName}-{APPID}，APPID 为纯数字
+        const storage = (_c = envConfig.Storages) === null || _c === void 0 ? void 0 : _c[0];
+        const appId = (storage === null || storage === void 0 ? void 0 : storage.AppId) || ((_e = (_d = storage === null || storage === void 0 ? void 0 : storage.Bucket) === null || _d === void 0 ? void 0 : _d.match(/-(\d+)$/)) === null || _e === void 0 ? void 0 : _e[1]) || '';
         const { proxy } = this.environment.cloudBaseContext;
         return {
             proxy,
@@ -1882,10 +1888,10 @@ __decorate([
 ], FunctionService.prototype, "getFunctionAlias", null);
 __decorate([
     (0, utils_1.preLazy)()
-], FunctionService.prototype, "uploadFunctionZipToCosLegacy", null);
+], FunctionService.prototype, "uploadFunctionZipToCos", null);
 __decorate([
     (0, utils_1.preLazy)()
-], FunctionService.prototype, "uploadFunctionZipToCos", null);
+], FunctionService.prototype, "uploadFunctionZipToCosLegacy", null);
 __decorate([
     (0, utils_1.preLazy)()
 ], FunctionService.prototype, "getCodeParams", null);

package/lib/permission/index.js

@@ -25,7 +25,9 @@ class PermissionService {
         if (!resourceType || !PERMISSION_BY_RESOURCE[resourceType]) {
             throw new Error('Invalid resourceType');
         }
-        if (typeof resource !== 'string' || resource.trim().length === 0) {
+        const isFunctionResourceType = resourceType === 'function';
+        const hasValidResourceValue = typeof resource === 'string' && resource.trim().length > 0;
+        if (!isFunctionResourceType && !hasValidResourceValue) {
             throw new Error('Invalid resource');
         }
         const allowed = PERMISSION_BY_RESOURCE[resourceType];
@@ -43,12 +45,7 @@ class PermissionService {
             //     throw new Error('securityRule must be a valid JSON string')
             // }
         }
-        const reqData = {
-            EnvId,
-            ResourceType: resourceType,
-            Resource: resource,
-            Permission: permission
-        };
+        const reqData = Object.assign({ EnvId, ResourceType: resourceType, Permission: permission }, (hasValidResourceValue || !isFunctionResourceType ? { Resource: resource } : {}));
         if (permission === 'CUSTOM') {
             reqData.SecurityRule = securityRule;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cloudbase/manager-node",
-    "version": "4.11.0-alpha.9",
+    "version": "5.0.2",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {
@@ -52,7 +52,7 @@
         "node-fetch": "^2.6.0",
         "query-string": "^6.8.3",
         "unzipper": "^0.12.3",
-        "uuid": "^13.0.0",
+        "uuid": "^9.0.0",
         "walkdir": "^0.4.1"
     },
     "husky": {

package/types/agent/index.d.ts

@@ -1,5 +1,5 @@
 import { Environment } from '../environment';
-import { ICreateFunctionAgentParams, ICreateScfAgentParams, ICreateTcbrAgentByImageParams, ICreateTcbrAgentByPackageParams, ICreateTcbrAgentByCodeParams, IDescribeAgentListParams, IDescribeAgentListResponse, IDescribeAgentResponse, IDeleteAgentParams, IDescribeCloudBaseBuildServiceParams, IDescribeCloudBaseBuildServiceResponse, ICreateAgentResponse, IDeleteAgentResponse, ICommonResponse, IUpdateAgentParams, IUpdateScfAgentParams, IUpdateScfAgentResponse, IUpdateTcbrAgentParams, IGetAgentLogsParams } from './type';
+import { ICreateFunctionAgentParams, ICreateAgentParams, ICreateTcbrAgentByImageParams, ICreateTcbrAgentByPackageParams, ICreateTcbrAgentByCodeParams, IDescribeAgentListParams, IDescribeAgentListResponse, IDescribeAgentResponse, IDeleteAgentParams, IDescribeCloudBaseBuildServiceParams, IDescribeCloudBaseBuildServiceResponse, ICreateAgentResponse, IDeleteAgentResponse, ICommonResponse, IUpdateAgentParams, IUpdateScfAgentParams, IUpdateScfAgentResponse, IUpdateTcbrAgentParams, IGetAgentLogsParams } from './type';
 /**
  * Agent 管理类
  * 支持三种部署方式：
@@ -12,14 +12,14 @@ export declare class AgentService {
     private tcbService;
     constructor(environment: Environment);
     /**
-     * 创建 SCF Agent
+     * 创建 Agent
      * 支持两种方式：
      * 1. 传入 cwd 代码目录，自动打包上传
      * 2. 传入 ZipFile / CosBucketRegion + TempCosObjectName，直接上传
      * @param params 创建参数
      * @returns Agent 创建结果
      */
-    createScfAgent(params: ICreateScfAgentParams): Promise<ICreateAgentResponse>;
+    createAgent(params: ICreateAgentParams): Promise<ICreateAgentResponse>;
     /**
      * 查询 Agent 列表
      * @param params 查询参数

package/types/agent/type.d.ts

@@ -28,12 +28,12 @@ export interface ISessionConfig {
     MaxConcurrency?: number;
 }
 /**
- * 创建 SCF Agent 的参数
+ * 创建 Agent 的参数
  * 支持两种方式：
  * 1. 传入 cwd 代码目录，自动打包上传
  * 2. 传入 ZipFile / CosBucketRegion + TempCosObjectName，直接上传
  */
-export interface ICreateScfAgentParams {
+export interface ICreateAgentParams {
     /** Agent 名称 */
     Name: string;
     /** Agent ID，不传则自动生成 */

package/types/cloudrun/index.d.ts

@@ -135,8 +135,6 @@ export declare class CloudRunService {
      * @returns {Promise<ITemplate[]>} 返回模板数组
      */
     getTemplates(): Promise<ITemplate[]>;
-    private _checkFunctionExist;
-    private _upsertFunction;
     /**
      * 获取部署记录列表，按部署时间倒序（最新在前）
      */
@@ -150,6 +148,8 @@ export declare class CloudRunService {
     getProcessLog(params: {
         RunId: string;
     }): Promise<IProcessLogResponse>;
+    private _checkFunctionExist;
+    private _upsertFunction;
 }
 export declare function codeToZip(cwd: string, options?: {
     installDependency?: boolean;

package/types/cloudrun/type.d.ts

@@ -38,10 +38,12 @@ export interface ICloudrunServerBaseInfo {
      */
     CustomDomainName: string;
     /**
-     * 服务状态
-     * @example "running" | "deploying" | "deploy_failed"
+     * 服务状态（来自 DescribeCloudRunServers）
+     * 常见值："creating" | "create_failed" | "freezing" | "freeze_fail" | "froze" |
+     * "unfreezing" | "unfreeze_fail" | "normal" | "deleting" | "delete_failed" | "abnormal"
+     * @example "normal"
      */
-    Status: 'running' | 'deploying' | 'deploy_failed';
+    Status: 'creating' | 'create_failed' | 'freezing' | 'freeze_fail' | 'froze' | 'unfreezing' | 'unfreeze_fail' | 'normal' | 'deleting' | 'delete_failed' | 'abnormal';
     /**
      * 更新时间
      * @example "2022-03-09 14:00:00"

package/types/env/index.d.ts

@@ -1,6 +1,6 @@
 import { Environment } from '../environment';
 import { IResponseInfo, AuthDomain, EnvInfo, LoginConfigItem, ICheckTcbServiceRes, ICreatePostpayRes, EnvBillingInfoItem, PriceResult } from '../interfaces';
-import { CalculatePackageCreatePriceParams, CalculatePackageRenewPriceParams, CalculatePackageModifyPriceParams } from './type';
+import { CalculatePackageCreatePriceParams, CalculatePackageRenewPriceParams, CalculatePackageModifyPriceParams, DescribeHttpServiceRouteParams, DescribeHttpServiceRouteRes, CreateHttpServiceRouteParams, CreateHttpServiceRouteRes, ModifyHttpServiceRouteParams, ModifyHttpServiceRouteRes, DeleteHttpServiceRouteParams, DeleteHttpServiceRouteRes, BindCustomDomainParams, BindCustomDomainRes, DeleteCustomDomainParams, DeleteCustomDomainRes } from './type';
 import { CreateBillingDealParams, CreateEnvParams, BaasPackageInfo, DescribeBaasPackageListParams, ModifyEnvPlanParams, RenewEnvParams, DestroyEnvParams, DescribeEnvsParams, DescribeEnvAccountCircleParams, DescribeEnvAccountCircleRes, DescribeCreditsUsageDetailParams, EnvPkgCreditsUsage } from '../interfaces/tcb.interface';
 type SOURCE = 'miniapp' | 'qcloud';
 interface IDeleteDomainRes {
@@ -264,6 +264,44 @@ export declare class EnvService {
         Usages: EnvPkgCreditsUsage[];
         RequestId: string;
     }>;
+    /**
+     * 查询HTTP访问服务域名路由信息
+     * @param {DescribeHttpServiceRouteParams} params 查询参数
+     * @returns {Promise<DescribeHttpServiceRouteRes>}
+     */
+    describeHttpServiceRoute(params: DescribeHttpServiceRouteParams): Promise<DescribeHttpServiceRouteRes>;
+    /**
+     * 创建HTTP访问服务域名路由
+     * @param {CreateHttpServiceRouteParams} params 创建参数
+     * @returns {Promise<CreateHttpServiceRouteRes>}
+     */
+    createHttpServiceRoute(params: CreateHttpServiceRouteParams): Promise<CreateHttpServiceRouteRes>;
+    /**
+     * 修改HTTP访问服务域名路由
+     * @param {ModifyHttpServiceRouteParams} params 修改参数
+     * @returns {Promise<ModifyHttpServiceRouteRes>}
+     */
+    modifyHttpServiceRoute(params: ModifyHttpServiceRouteParams): Promise<ModifyHttpServiceRouteRes>;
+    /**
+     * 删除HTTP访问服务域名路由
+     * @param {DeleteHttpServiceRouteParams} params 删除参数
+     * @returns {Promise<DeleteHttpServiceRouteRes>}
+     */
+    deleteHttpServiceRoute(params: DeleteHttpServiceRouteParams): Promise<DeleteHttpServiceRouteRes>;
+    /**
+     * 绑定自定义域名到HTTP访问服务
+     * 底层调用 CreateHTTPServiceRoute API，专用于域名绑定场景
+     * @param {BindCustomDomainParams} params 绑定参数
+     * @returns {Promise<BindCustomDomainRes>}
+     */
+    bindCustomDomain(params: BindCustomDomainParams): Promise<BindCustomDomainRes>;
+    /**
+     * 删除自定义域名
+     * 仅当域名下无路由绑定时可删除，否则抛出错误
+     * @param {DeleteCustomDomainParams} params 删除参数
+     * @returns {Promise<DeleteCustomDomainRes>}
+     */
+    deleteCustomDomain(params: DeleteCustomDomainParams): Promise<DeleteCustomDomainRes>;
     private getCOSDomains;
     private modifyCosCorsDomain;
     private getCos;

package/types/env/type.d.ts

@@ -14,3 +14,190 @@ export interface CalculatePackageModifyPriceParams {
     envId: string;
     currency?: 'CNY' | 'USD';
 }
+/**
+ * 客户端限频配置
+ */
+export interface HTTPServiceQPSPerClient {
+    LimitBy?: 'UserID' | 'ClientIP';
+    LimitValue?: number;
+}
+/**
+ * QPS限频策略
+ */
+export interface HTTPServiceRouteQPSPolicy {
+    QPSTotal?: number;
+    QPSPerClient?: HTTPServiceQPSPerClient;
+}
+/**
+ * 路径重写
+ */
+export interface HTTPServicePathRewrite {
+    StaticStorePrefix?: string;
+    Prefix?: string;
+}
+/**
+ * HTTP访问服务路由信息
+ */
+export interface HTTPServiceRoute {
+    Path: string;
+    PathRewrite?: HTTPServicePathRewrite;
+    UpstreamResourceType: 'SCF' | 'CBR' | 'STATIC_STORE' | 'WEB_SCF' | 'LH';
+    UpstreamResourceName: string;
+    EnableSafeDomain: boolean;
+    EnableAuth: boolean;
+    EnablePathTransmission: boolean;
+    QPSPolicy?: HTTPServiceRouteQPSPolicy;
+    Enable: boolean;
+    CreateTime: string;
+    UpdateTime: string;
+}
+/**
+ * 域名路由信息
+ */
+export interface HTTPServiceDomain {
+    Domain: string;
+    DomainType: 'HTTPSERVICE' | 'CBR' | 'ANYSERVICE' | 'AI_AGENT' | 'VM' | 'INTEGRATION_CALLBACK';
+    AccessType: 'DIRECT' | 'CDN' | 'CUSTOM';
+    CertId: string;
+    Protocol: 'HTTP_AND_HTTPS' | 'HTTP_TO_HTTPS' | 'HTTPS_TO_HTTP';
+    Cname: string;
+    IsDefault: boolean;
+    Enable: boolean;
+    Status: 'PROCESSING' | 'FAIL' | 'SUCCESS';
+    DNSStatus: 'OK' | 'INVALID';
+    Routes?: HTTPServiceRoute[];
+    CreateTime: string;
+    UpdateTime: string;
+}
+/**
+ * 过滤条件
+ */
+export interface HTTPServiceRouteFilter {
+    Name?: 'Domain' | 'Path' | 'DomainType' | 'UpstreamResourceType';
+    Values?: string[];
+}
+/**
+ * DescribeHTTPServiceRoute 请求参数
+ */
+export interface DescribeHttpServiceRouteParams {
+    EnvId: string;
+    Filters?: HTTPServiceRouteFilter[];
+    Offset?: number;
+    Limit?: number;
+}
+/**
+ * DescribeHTTPServiceRoute 返回结果
+ */
+export interface DescribeHttpServiceRouteRes {
+    Domains?: HTTPServiceDomain[];
+    OriginDomain: string;
+    TotalCount: number;
+    RequestId: string;
+}
+/**
+ * HTTP访问服务路由参数（创建/修改）
+ */
+export interface HTTPServiceRouteParam {
+    Path: string;
+    UpstreamResourceType?: 'SCF' | 'CBR' | 'STATIC_STORE' | 'WEB_SCF' | 'LH';
+    UpstreamResourceName?: string;
+    PathRewrite?: HTTPServicePathRewrite;
+    EnableSafeDomain?: boolean;
+    EnableAuth?: boolean;
+    EnablePathTransmission?: boolean;
+    QPSPolicy?: HTTPServiceRouteQPSPolicy;
+    Enable?: boolean;
+}
+/**
+ * HTTP访问服务域名参数（创建/修改）
+ */
+export interface HTTPServiceDomainParam {
+    Domain: string;
+    AccessType?: 'DIRECT' | 'CDN' | 'CUSTOM';
+    CertId?: string;
+    Protocol?: 'HTTP_AND_HTTPS' | 'HTTP_TO_HTTPS' | 'HTTPS_TO_HTTP';
+    CustomCname?: string;
+    Enable?: boolean;
+    Routes?: HTTPServiceRouteParam[];
+}
+/**
+ * CreateHTTPServiceRoute 请求参数
+ */
+export interface CreateHttpServiceRouteParams {
+    EnvId: string;
+    Domain: HTTPServiceDomainParam;
+}
+/**
+ * CreateHTTPServiceRoute 返回结果
+ */
+export interface CreateHttpServiceRouteRes {
+    RequestId: string;
+}
+/**
+ * ModifyHTTPServiceRoute 请求参数
+ */
+export interface ModifyHttpServiceRouteParams {
+    EnvId: string;
+    Domain: HTTPServiceDomainParam;
+}
+/**
+ * ModifyHTTPServiceRoute 返回结果
+ */
+export interface ModifyHttpServiceRouteRes {
+    RequestId: string;
+}
+/**
+ * DeleteHTTPServiceRoute 请求参数
+ */
+export interface DeleteHttpServiceRouteParams {
+    EnvId: string;
+    Domain: string;
+    Paths?: string[];
+}
+/**
+ * DeleteHTTPServiceRoute 返回结果
+ */
+export interface DeleteHttpServiceRouteRes {
+    RequestId: string;
+}
+/**
+ * 绑定自定义域名的域名参数
+ * 与 HTTPServiceDomainParam 类似，但不包含 Routes（绑定域名场景）
+ */
+export interface BindCustomDomainDomainParam {
+    Domain: string;
+    CertId: string;
+    AccessType?: 'DIRECT' | 'CDN' | 'CUSTOM';
+    Protocol?: 'HTTP_AND_HTTPS' | 'HTTP_TO_HTTPS' | 'HTTPS_TO_HTTP';
+    Enable?: boolean;
+    CustomCname?: string;
+}
+/**
+ * BindCustomDomain 请求参数
+ * 用于绑定自定义域名到 HTTP 访问服务
+ * 底层调用 CreateHTTPServiceRoute API，但参数配置不同
+ */
+export interface BindCustomDomainParams {
+    EnvId: string;
+    Domain: BindCustomDomainDomainParam;
+}
+/**
+ * BindCustomDomain 返回结果
+ */
+export interface BindCustomDomainRes {
+    RequestId: string;
+}
+/**
+ * DeleteCustomDomain 请求参数
+ * 用于删除自定义域名（仅当域名下无路由绑定时可删除）
+ */
+export interface DeleteCustomDomainParams {
+    EnvId: string;
+    Domain: string;
+}
+/**
+ * DeleteCustomDomain 返回结果
+ */
+export interface DeleteCustomDomainRes {
+    RequestId: string;
+}

package/types/function/index.d.ts

@@ -504,17 +504,18 @@ export declare class FunctionService {
      */
     getFunctionAlias(params: IGetFunctionAlias): Promise<IGetFunctionAliasRes>;
     /**
-     * 通过scf COS 上传方式（通过 GetTempCosInfo + COS SDK 上传）
+     * 通过 SCF COS 上传方式（通过 GetTempCosInfo + COS SDK 上传）
      * 返回 TempCosObjectName 用于创建/更新函数
      */
-    uploadFunctionZipToCosLegacy(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{
+    uploadFunctionZipToCos(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{
         Key: string;
     }>;
     /**
-     * 新的 COS 上传方式（通过 DescribeBuildServiceCosInfo + PUT 上传）
+     * 旧的 COS 上传方式（通过 DescribeBuildServiceCosInfo + PUT 上传）
      * 返回 CosTimestamp 用于创建/更新函数
+     * @deprecated 请使用 uploadFunctionZipToCos 代替
      */
-    uploadFunctionZipToCos(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{
+    uploadFunctionZipToCosLegacy(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{
         UnixTimestamp: string;
     }>;
     getCodeParams(options: IFunctionCode, installDependency: 'TRUE' | 'FALSE'): Promise<{

package/types/permission/types.d.ts

@@ -2,7 +2,7 @@ export type PermissionResourceType = 'function' | 'storage' | 'table' | 'collect
 export type BasePermission = 'READONLY' | 'PRIVATE' | 'ADMINWRITE' | 'ADMINONLY' | 'CUSTOM';
 export interface ModifyResourcePermissionOptions {
     resourceType: PermissionResourceType;
-    resource: string;
+    resource?: string;
     permission: BasePermission;
     securityRule?: string;
 }