@cloudbase/manager-node 5.2.0 → 5.4.0-beta.1

package/lib/storage/type.js

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

package/package.json

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

package/types/aiModel/index.d.ts

@@ -0,0 +1,27 @@
+import { Environment } from '../environment';
+import { CreateAIModelOptions, CreateAIModelResp, UpdateAIModelOptions, UpdateAIModelResp, DeleteAIModelOptions, DeleteAIModelResp, DescribeAIModelsOptions, DescribeAIModelsResp, DescribeManagedAIModelListOptions, DescribeManagedAIModelListResp } from './type';
+export declare class AiModelService {
+    private environment;
+    private tcbService;
+    constructor(environment: Environment);
+    /**
+     * 创建 AI 模型配置分组
+     */
+    createAIModel(options: CreateAIModelOptions): Promise<CreateAIModelResp>;
+    /**
+     * 更新 AI 模型配置分组
+     */
+    updateAIModel(options: UpdateAIModelOptions): Promise<UpdateAIModelResp>;
+    /**
+     * 删除 AI 模型配置分组，支持批量删除
+     */
+    deleteAIModel(options: DeleteAIModelOptions): Promise<DeleteAIModelResp>;
+    /**
+     * 查询指定云开发环境下已配置的 AI 模型分组列表
+     */
+    describeAIModels(options?: DescribeAIModelsOptions): Promise<DescribeAIModelsResp>;
+    /**
+     * 查询云开发平台支持的托管类型 AI 模型列表
+     */
+    describeManagedAIModelList(options?: DescribeManagedAIModelListOptions): Promise<DescribeManagedAIModelListResp>;
+}

package/types/aiModel/type.d.ts

@@ -0,0 +1,205 @@
+import { IResponseInfo } from '../interfaces';
+/** 模型状态，1：开启，2：关闭 */
+export type AIModelStatus = 1 | 2;
+/** AI 模型信息 */
+export interface AIModel {
+    /** 模型名，示例值：huanyuan-v1 */
+    Model?: string;
+    /** 是否开启 MCP，示例值：false */
+    EnableMCP?: boolean;
+    /** 标签 */
+    Tags?: string[];
+}
+/** AI 模型密钥信息 */
+export interface AIModelSecret {
+    /** 密钥来源，示例值：custom */
+    SecretSource?: string;
+    /** 密钥 ID，和 SecretKey 一一对应 */
+    SecretId?: string;
+    /** 密钥 Key，和 SecretId 一一对应 */
+    SecretKey?: string;
+    /** ApiKey，SecretKey 和 ApiKey 二选一 */
+    ApiKey?: string;
+}
+/** AI 模型分组类型 */
+export type AIModelGroupType = 'builtin' | 'custom';
+/** AI 模型分组信息 */
+export interface AIModelGroup {
+    /**
+     * 模型分组
+     * 枚举值：
+     * - hunyuan-exp
+     * - hunyuan-image
+     * - deepseek
+     * - cloudbase
+     * - custom-xxxx
+     */
+    GroupName?: string;
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Models?: AIModel[] | null;
+    /** 模型类型：builtin 内置模型分组类别，custom 用户自定义模型分组类别 */
+    Type?: AIModelGroupType;
+    /** 原始模型类型：builtin 内置模型类型，custom 用户自定义模型类型 */
+    OriginType?: AIModelGroupType;
+    /** 备注 */
+    Remark?: string;
+    /** 模型地址 */
+    BaseUrl?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    Status?: AIModelStatus;
+    /**
+     * 模型密钥
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Secret?: AIModelSecret | null;
+    /** 创建时间，ISO8601 格式 */
+    CreateTime?: string;
+    /** 更新时间，ISO8601 格式 */
+    UpdateTime?: string;
+}
+/** 托管 AI 模型计费类型 */
+export type ManagedAIModelChargingType = 'Uniform' | 'Tiered';
+/** 托管 AI 模型参数规格 */
+export interface ManagedAIModelSpec {
+    /** 最大输入 Token，示例值：192k */
+    MaxInputToken?: string;
+    /** 最大输出 Token，示例值：32k */
+    MaxOutputToken?: string;
+    /** 上下文长度，示例值：128k */
+    ContextLength?: string;
+}
+/** 托管 AI 模型计费信息 */
+export interface ManagedAIModelChargingInfo {
+    /** 计费类型：Uniform 固定计费，Tiered 分段计费 */
+    Type?: ManagedAIModelChargingType;
+    /** 分组名称，示例值：0-16k */
+    Name?: string;
+    /** 输入 Token 价格，示例值：1.2 */
+    InputPrice?: string;
+    /** 输出 Token 价格，示例值：4 */
+    OutputPrice?: string;
+    /** 命中缓存价格，示例值：0.4 */
+    CachePrice?: string;
+    /** 计费单位，示例值：千tokens */
+    InputOutputUnit?: string;
+}
+/** 托管型 AI 模型信息 */
+export interface ManagedAIModel {
+    /** 模型名，示例值：hy3-preview */
+    Model?: string;
+    /** 是否开启 MCP，示例值：true */
+    EnableMCP?: boolean;
+    /** 模型规格 */
+    ModelSpec?: ManagedAIModelSpec;
+    /** 模型计费信息 */
+    ModelChargingInfo?: ManagedAIModelChargingInfo[];
+}
+/** 云开发内置 AI 模型分组信息 */
+export interface ManagedAIModelGroup {
+    /** 模型分组，示例值：cloudbase */
+    GroupName?: string;
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Models?: ManagedAIModel[] | null;
+    /** 备注，示例值：腾讯云开发 */
+    Remark?: string;
+}
+/**
+ * CreateAIModel 用户入参
+ */
+export interface CreateAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /**
+     * 分组名
+     * 入参限制：不允许以 cloudbase 为前缀
+     */
+    groupName: string;
+    /** 模型服务地址，示例值：http://xxx */
+    baseUrl?: string;
+    /** 模型名列表 */
+    models?: AIModel[];
+    /** 分组备注 */
+    remark?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    status?: AIModelStatus;
+    /** 模型密钥 */
+    secret?: AIModelSecret;
+}
+/** CreateAIModel 返回结果 */
+export interface CreateAIModelResp extends IResponseInfo {
+    /** 创建数量 */
+    Count: number;
+}
+/**
+ * UpdateAIModel 用户入参
+ */
+export interface UpdateAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /** 分组名 */
+    groupName: string;
+    /** 模型地址，示例值：http://xxx */
+    baseUrl?: string;
+    /**
+     * 模型名列表
+     * 注意：Models 列表更新采用全量替换
+     */
+    models?: AIModel[];
+    /** 备注 */
+    remark?: string;
+    /** 模型状态，1：开启，2：关闭 */
+    status?: AIModelStatus;
+    /** 模型密钥 */
+    secret?: AIModelSecret;
+}
+/** UpdateAIModel 返回结果 */
+export interface UpdateAIModelResp extends IResponseInfo {
+    /** 更新数量 */
+    Count: number;
+}
+/**
+ * DeleteAIModel 用户入参
+ */
+export interface DeleteAIModelOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+    /** 分组名列表 */
+    groupNames: string[];
+}
+/** DeleteAIModel 返回结果 */
+export interface DeleteAIModelResp extends IResponseInfo {
+    /** 成功删除数量 */
+    Count: number;
+}
+/** DescribeAIModels 用户入参 */
+export interface DescribeAIModelsOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+}
+/** DescribeAIModels 返回结果 */
+export interface DescribeAIModelsResp extends IResponseInfo {
+    /**
+     * 模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    AIModels: AIModelGroup[] | null;
+}
+/** DescribeManagedAIModelList 用户入参 */
+export interface DescribeManagedAIModelListOptions {
+    /** 环境 ID。不传则使用当前环境 ID */
+    envId?: string;
+}
+/** DescribeManagedAIModelList 返回结果 */
+export interface DescribeManagedAIModelListResp extends IResponseInfo {
+    /**
+     * 托管模型列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    ManagedAIModelList: ManagedAIModelGroup[] | null;
+}

package/types/database/index.d.ts

@@ -47,6 +47,33 @@ interface IRunCommandsResult extends IResponseInfo {
     /** 返回结果，每个元素是一个 JSON 字符串 */
     Data: string[];
 }
+/** ExecutePGSql 请求参数 */
+interface IExecutePGSqlOptions {
+    /** 要执行的 SQL 语句 */
+    Sql: string;
+    /** 指定 role 执行 SQL（可选） */
+    Role?: string;
+    /** 云开发环境 ID（可选，不传则自动使用当前环境 ID） */
+    EnvId?: string;
+}
+/** ExecutePGSql 返回结果 */
+interface IExecutePGSqlResult extends IResponseInfo {
+    /** 影响行数 */
+    AffectedRows: number;
+    /**
+     * 字段名列表
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Columns: string[] | null;
+    /**
+     * 数据行。每一行数据都是一个 JSON 串，
+     * 将 JSON 进行反序列化将得到每列的值（值可能是 null 或字符串）
+     * 注意：此字段可能返回 null，表示取不到有效值
+     */
+    Rows: string[] | null;
+    /** SQL 执行耗时（单位：毫秒） */
+    ExecutionTimeMs: number;
+}
 interface ICollectionInfo extends IResponseInfo {
     Collections: Array<TableInfo>;
     Pager: Pager;
@@ -174,5 +201,29 @@ export declare class DatabaseService {
      * @returns 执行结果，Data 为 JSON 字符串数组
      */
     runCommands(options: IRunCommandsOptions): Promise<IRunCommandsResult>;
+    /**
+     * 在 PostgreSQL 数据库上执行 SQL 语句
+     *
+     * @param options 执行参数
+     * @param options.Sql 要执行的 SQL 语句
+     * @param options.Role 指定 role 执行 SQL（可选）
+     * @param options.EnvId 环境 ID（可选，不传则自动使用当前环境 ID）
+     * @returns 执行结果，包含影响行数、字段列表、数据行及执行耗时
+     *
+     * @example
+     * // 创建表
+     * const res = await database.executePGSql({
+     *     Sql: 'CREATE TABLE users (id SERIAL PRIMARY KEY, name TEXT NOT NULL)'
+     * })
+     *
+     * @example
+     * // 查询数据
+     * const res = await database.executePGSql({
+     *     Sql: "SELECT * FROM users WHERE id = 1"
+     * })
+     * console.log(res.Columns) // ['id', 'name']
+     * console.log(res.Rows)    // ['["1","Alice"]']
+     */
+    executePGSql(options: IExecutePGSqlOptions): Promise<IExecutePGSqlResult>;
 }
 export {};

package/types/environment.d.ts

@@ -17,6 +17,7 @@ import { CloudAppService } from './cloudApp';
 import { EnvInfo } from './interfaces';
 import { PermissionService } from './permission';
 import { SandboxService } from './sandbox';
+import { AiModelService } from './aiModel';
 export declare class Environment {
     inited: boolean;
     cloudBaseContext: CloudBaseContext;
@@ -39,6 +40,7 @@ export declare class Environment {
     private permissionService;
     private cloudAppService;
     private sandboxService;
+    private aiModelService;
     constructor(context: CloudBaseContext, envId: string);
     lazyInit(): Promise<any>;
     getEnvId(): string;
@@ -59,6 +61,7 @@ export declare class Environment {
     getCloudAppService(): CloudAppService;
     getPermissionService(): PermissionService;
     getSandboxService(): SandboxService;
+    getAiModelService(): AiModelService;
     getCommonService(serviceType: string, serviceVersion: any): CommonService;
     getServicesEnvInfo(): Promise<any>;
     getAuthConfig(): {

package/types/index.d.ts

@@ -18,6 +18,7 @@ import { DocsService } from './docs';
 import { PermissionService } from './permission';
 import { SandboxService } from './sandbox';
 import { CloudAppService } from './cloudApp';
+import { AiModelService } from './aiModel';
 interface CloudBaseConfig {
     secretId?: string;
     secretKey?: string;
@@ -82,6 +83,7 @@ declare class CloudBase {
     get user(): UserService;
     get permission(): PermissionService;
     get sandbox(): SandboxService;
+    get aiModel(): AiModelService;
     get docs(): DocsService;
     getEnvironmentManager(): EnvironmentManager;
     getManagerConfig(): CloudBaseConfig;

package/types/storage/index.d.ts

@@ -1,5 +1,6 @@
 import { Environment } from '../environment';
 import { IUploadMetadata, IListFileInfo, IFileInfo, ITempUrlInfo, IResponseInfo } from '../interfaces';
+import { IUploadObjectHttpOptions, IUploadObjectHttpResult, IDeleteObjectHttpOptions, IDeleteObjectHttpResult, IDeleteObjectsHttpOptions, IDeletedObjectInfo, ICopyObjectHttpOptions, ICopyObjectHttpResult, IMoveObjectHttpOptions, IMoveObjectHttpResult, IListObjectsHttpOptions, IListObjectsHttpResult, ISignObjectHttpOptions, ISignObjectHttpResult, ISignObjectsHttpOptions, ISignObjectsHttpResult, ISignUploadObjectHttpOptions, ISignUploadObjectHttpResult, IUploadObjectBySignHttpOptions, IUploadObjectBySignHttpResult, IDownloadAuthenticatedObjectHttpOptions, IDownloadObjectHttpOptions, IDownloadPublicObjectHttpOptions, IDownloadObjectBySignHttpOptions, IDownloadObjectHttpResult, IGetObjectInfoAuthenticatedHttpOptions, IGetObjectInfoPublicHttpOptions, IGetObjectInfoHttpResult } from './type';
 export interface IProgressData {
     loaded: number;
     total: number;
@@ -448,6 +449,86 @@ export declare class StorageService {
      * @returns 搜索结果数组（包含文件和目录）
      */
     searchFiles(options: ISearchOptions): Promise<ISearchResult[]>;
+    /**
+     * 通过 CloudBase HTTP API 上传对象（Binary 直传）
+     * POST/PUT /v1/storages/object/:bucketId/*objectName
+     */
+    uploadObject(options: IUploadObjectHttpOptions): Promise<IUploadObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 删除单个对象
+     * DELETE /v1/storages/object/:bucketId/*objectName
+     */
+    deleteObject(options: IDeleteObjectHttpOptions): Promise<IDeleteObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 批量删除对象（单次最多 20 个）
+     * DELETE /v1/storages/object/:bucketId
+     */
+    deleteObjects(options: IDeleteObjectsHttpOptions): Promise<IDeletedObjectInfo[]>;
+    /**
+     * 通过 CloudBase HTTP API 复制对象
+     * POST /v1/storages/object/copy
+     */
+    copyObject(options: ICopyObjectHttpOptions): Promise<ICopyObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 移动对象（复制后删除源对象，由服务端一次性完成）
+     * POST /v1/storages/object/move
+     */
+    moveObject(options: IMoveObjectHttpOptions): Promise<IMoveObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 列出对象
+     * POST /v1/storages/object/list/:bucketId
+     */
+    listObjects(options: IListObjectsHttpOptions): Promise<IListObjectsHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 生成签名下载 URL
+     * POST /v1/storages/object/sign/:bucketId/*objectName
+     */
+    signObject(options: ISignObjectHttpOptions): Promise<ISignObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 批量生成签名下载 URL
+     * POST /v1/storages/object/sign/:bucketId
+     */
+    signObjects(options: ISignObjectsHttpOptions): Promise<ISignObjectsHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 生成签名上传 URL
+     * POST /v1/storages/object/upload/sign/:bucketId/*objectName
+     */
+    signUploadObject(options: ISignUploadObjectHttpOptions): Promise<ISignUploadObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 使用签名 URL 上传对象（无需 Authorization）
+     * PUT /v1/storages/object/upload/sign/:bucketId/*objectName?token=xxx
+     */
+    uploadObjectBySign(options: IUploadObjectBySignHttpOptions): Promise<IUploadObjectBySignHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 下载对象（需认证）
+     * GET/HEAD /v1/storages/object/authenticated/:bucketId/*objectName
+     */
+    downloadAuthenticatedObject(options: IDownloadAuthenticatedObjectHttpOptions): Promise<IDownloadObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 下载对象（可选认证）
+     * GET/HEAD /v1/storages/object/:bucketId/*objectName
+     */
+    downloadObject(options: IDownloadObjectHttpOptions): Promise<IDownloadObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 下载公开对象（无需认证）
+     * GET/HEAD /v1/storages/object/public/:bucketId/*objectName
+     */
+    downloadPublicObject(options: IDownloadPublicObjectHttpOptions): Promise<IDownloadObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 使用签名 URL 下载对象（无需 Authorization）
+     * GET/HEAD /v1/storages/object/sign/:bucketId/*objectName?token=xxx
+     */
+    downloadObjectBySign(options: IDownloadObjectBySignHttpOptions): Promise<IDownloadObjectHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 获取对象元信息（需认证）
+     * GET/HEAD /v1/storages/object/info/authenticated/:bucketId/*objectName
+     */
+    getObjectInfoAuthenticated(options: IGetObjectInfoAuthenticatedHttpOptions): Promise<IGetObjectInfoHttpResult>;
+    /**
+     * 通过 CloudBase HTTP API 获取公开对象元信息（无需认证）
+     * GET /v1/storages/object/info/public/:bucketId/*objectName
+     */
+    getObjectInfoPublic(options: IGetObjectInfoPublicHttpOptions): Promise<IGetObjectInfoHttpResult>;
     /**
      * 获取 COS 配置
      */