@cloudbase/manager-node 5.3.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.3.0",
+    "version": "5.4.0-beta.1",
     "description": "The node manage service api for cloudbase.",
     "main": "lib/index.js",
     "scripts": {

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/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 配置
      */

package/types/storage/type.d.ts

@@ -0,0 +1,431 @@
+export interface IUploadObjectHttpOptions {
+    /** Bucket ID */
+    bucketId: string;
+    /** 对象名，支持路径，例如 folder/file.png */
+    objectName: string;
+    /**
+     * 文件来源（二选一）：
+     * - localPath：本地文件绝对/相对路径
+     * - body：Buffer 或可读流
+     */
+    localPath?: string;
+    body?: Buffer | NodeJS.ReadableStream;
+    /** MIME 类型，默认 application/octet-stream */
+    contentType?: string;
+    /** 文件字节数；不传时若为 localPath/Buffer 会自动推断 */
+    contentLength?: number;
+    /**
+     * 缓存控制；传 number 自动转换为 max-age=<value>，传 string 直接作为 Cache-Control 头值
+     */
+    cacheControl?: number | string;
+    /** 自定义 metadata（JSON 对象），将以 Base64 编码后放入 X-Metadata 头 */
+    metadata?: Record<string, any>;
+    /** 爬虫指令（X-Robots-Tag 头） */
+    xRobotsTag?: string;
+    /** POST 时是否允许覆盖（x-upsert: true） */
+    upsert?: boolean;
+    /** 使用 PUT 方法（始终覆盖，等价于 x-upsert: true） */
+    usePut?: boolean;
+    /**
+     * 鉴权令牌（Bearer Token），支持以下三种类型之一：
+     * - access_token：登录态访问令牌
+     * - apiKey：服务端管理员访问凭证（JWT 格式，可由 env.createApiKey 创建，长期有效）
+     * - publishableKey：前端匿名访问凭证
+     *
+     * 调用时以 `Authorization: Bearer <token>` 形式传递。
+     * ⚠️ apiKey 严禁在客户端使用。
+     */
+    accessToken: string;
+    /** 可选覆盖 envId，不传则取当前环境 */
+    envId?: string;
+}
+export interface IUploadObjectHttpResult {
+    Id: string;
+    Key: string;
+}
+/** 删除单个对象参数 */
+export interface IDeleteObjectHttpOptions {
+    /** Bucket ID */
+    bucketId: string;
+    /** 对象名，支持路径，例如 folder/file.png */
+    objectName: string;
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 删除单个对象响应 */
+export interface IDeleteObjectHttpResult {
+    message: string;
+}
+/** 批量删除对象参数 */
+export interface IDeleteObjectsHttpOptions {
+    /** Bucket ID */
+    bucketId: string;
+    /**
+     * 要删除的对象名列表，1 ~ 20 个。
+     * ⚠️ 官方文档字段名为 `prefixes`，但本质是完整 object name 的精确匹配（非前缀匹配）
+     */
+    prefixes: string[];
+    /** Bearer Token */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 批量删除对象响应（单条） */
+export interface IDeletedObjectInfo {
+    name: string;
+    bucket_id: string;
+    owner_id: string;
+    [key: string]: any;
+}
+/** 复制对象参数 */
+export interface ICopyObjectHttpOptions {
+    /** 源 Bucket ID */
+    bucketId: string;
+    /** 源对象名 */
+    sourceKey: string;
+    /** 目标对象名 */
+    destinationKey: string;
+    /** 目标 Bucket ID，默认与源 Bucket 相同 */
+    destinationBucket?: string;
+    /**
+     * 系统 metadata（对应 DB 列 storage.objects.metadata），
+     * 仅在 copyMetadata=false 时生效：以源 metadata 为底，与请求 metadata 合并（同 key 覆盖）。
+     * COS 后端实际会识别的字段：cacheControl / mimetype / contentType。
+     * 通过 body.metadata 字段传递。
+     */
+    metadata?: Record<string, any>;
+    /**
+     * 用户自定义 metadata（对应 DB 列 storage.objects.user_metadata），
+     * 仅在 copyMetadata=false 时生效：**整体替换**目标对象的 user_metadata（不是合并）。
+     * 通过 x-metadata Header 传递，内部会 Base64(JSON) 编码。
+     */
+    userMetadata?: Record<string, any>;
+    /**
+     * 是否复制源对象的 metadata，默认 true。
+     * - true：直接继承源对象 metadata / user_metadata，请求里的 metadata 和 userMetadata 均被忽略
+     * - false：
+     *   · metadata 字段（若传）与源 metadata 合并
+     *   · userMetadata 字段（若传）整体替换源 user_metadata
+     */
+    copyMetadata?: boolean;
+    /** 是否允许覆盖目标位置已有对象（x-upsert: "true"） */
+    upsert?: boolean;
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 复制对象响应 */
+export interface ICopyObjectHttpResult {
+    Id: string;
+    Key: string;
+    name: string;
+    bucket_id: string;
+    owner_id: string;
+    version: string;
+    id: string;
+    updated_at: string;
+    created_at: string;
+    last_accessed_at: string;
+    metadata: Record<string, any>;
+    user_metadata: Record<string, any>;
+    [key: string]: any;
+}
+/** 移动对象参数 */
+export interface IMoveObjectHttpOptions {
+    /** 源 Bucket ID */
+    bucketId: string;
+    /** 源对象名 */
+    sourceKey: string;
+    /** 目标对象名 */
+    destinationKey: string;
+    /** 目标 Bucket ID，默认与源 Bucket 相同 */
+    destinationBucket?: string;
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 移动对象响应 */
+export interface IMoveObjectHttpResult {
+    message: string;
+    Id: string;
+    Key: string;
+}
+export type IListObjectsSortColumn = 'name' | 'created_at' | 'updated_at';
+export type IListObjectsSortOrder = 'asc' | 'desc';
+/** 列出对象参数 */
+export interface IListObjectsHttpOptions {
+    /** Bucket ID（Path 参数） */
+    bucketId: string;
+    /** 路径前缀 */
+    prefix?: string;
+    /** 分页限制，1 ~ 1000 */
+    limit?: number;
+    /** 游标（由上一次响应的 nextCursor 提供） */
+    cursor?: string;
+    /** 是否使用 / 作为分隔符区分文件夹 */
+    withDelimiter?: boolean;
+    /** 排序选项 */
+    sortBy?: {
+        /** 允许值：name、created_at、updated_at */
+        column?: IListObjectsSortColumn;
+        /** 排序方向：asc（默认）、desc */
+        order?: IListObjectsSortOrder;
+    };
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 列表中的“文件夹”条目 */
+export interface IListObjectsFolderItem {
+    key: string;
+    name: string;
+    id: string | null;
+    updated_at: string | null;
+    created_at: string | null;
+    last_accessed_at: string | null;
+    metadata: Record<string, any> | null;
+}
+/** 列表中的“对象/文件”条目 */
+export interface IListObjectsObjectItem {
+    name: string;
+    id: string;
+    updated_at: string;
+    created_at: string;
+    last_accessed_at: string;
+    metadata: Record<string, any>;
+    [key: string]: any;
+}
+/** 列出对象响应 */
+export interface IListObjectsHttpResult {
+    folders: IListObjectsFolderItem[];
+    objects: IListObjectsObjectItem[];
+    hasNext: boolean;
+    nextCursor?: string;
+    nextCursorKey?: string;
+    [key: string]: any;
+}
+/** 生成签名下载 URL 参数 */
+export interface ISignObjectHttpOptions {
+    /** Bucket ID（Path 参数） */
+    bucketId: string;
+    /** 对象名称（Path 参数） */
+    objectName: string;
+    /** 过期时间（秒），必须 >= 1 */
+    expiresIn: number;
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 生成签名下载 URL 响应 */
+export interface ISignObjectHttpResult {
+    signedURL: string;
+}
+/** 批量生成签名 URL 参数 */
+export interface ISignObjectsHttpOptions {
+    /** Bucket ID（Path 参数） */
+    bucketId: string;
+    /** 过期时间（秒），必须 >= 1 */
+    expiresIn: number;
+    /** 对象名称列表，不能为空，最多 500 个 */
+    paths: string[];
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 批量签名结果条目 */
+export interface ISignedObjectItem {
+    path: string;
+    signedURL: string | null;
+    error: string | null;
+    [key: string]: any;
+}
+/** 批量生成签名 URL 响应 */
+export type ISignObjectsHttpResult = ISignedObjectItem[];
+/** 生成签名上传 URL 参数 */
+export interface ISignUploadObjectHttpOptions {
+    /** Bucket ID（Path 参数） */
+    bucketId: string;
+    /** 对象名称（Path 参数） */
+    objectName: string;
+    /** "true" 时允许覆盖（x-upsert: true） */
+    upsert?: boolean;
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 生成签名上传 URL 响应 */
+export interface ISignUploadObjectHttpResult {
+    url: string;
+    token: string;
+}
+/** 通过签名 URL 上传参数 */
+export interface IUploadObjectBySignHttpOptions {
+    /** Bucket ID（Path 参数） */
+    bucketId: string;
+    /** 对象名称（Path 参数） */
+    objectName: string;
+    /** 签名上传 token（Query 参数） */
+    token: string;
+    /** 文件来源（二选一）：localPath 或 body */
+    localPath?: string;
+    body?: Buffer | NodeJS.ReadableStream;
+    /** MIME 类型，默认 application/octet-stream */
+    contentType?: string;
+    /** 文件字节数；不传时若为 localPath/Buffer 会自动推断 */
+    contentLength?: number;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 通过签名 URL 上传响应 */
+export interface IUploadObjectBySignHttpResult {
+    Key: string;
+}
+/** 下载方法，仅支持 GET / HEAD */
+export type IDownloadObjectHttpMethod = 'GET' | 'HEAD';
+/** 下载对象公共参数 */
+export interface IDownloadObjectBaseHttpOptions {
+    /** Bucket ID（Path 参数） */
+    bucketId: string;
+    /** 对象名称（Path 参数） */
+    objectName: string;
+    /** HTTP 方法：GET 返回文件流；HEAD 仅返回响应头 */
+    method?: IDownloadObjectHttpMethod;
+    /** Query 参数：存在时触发浏览器下载，值作为下载文件名 */
+    download?: string;
+    /** 条件请求头：ETag 校验 */
+    ifNoneMatch?: string;
+    /** 条件请求头：修改时间校验 */
+    ifModifiedSince?: string;
+    /** 范围请求头（断点续传） */
+    range?: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 下载对象（需认证）参数 */
+export interface IDownloadAuthenticatedObjectHttpOptions extends IDownloadObjectBaseHttpOptions {
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+}
+/** 下载对象（可选认证）参数 */
+export interface IDownloadObjectHttpOptions extends IDownloadObjectBaseHttpOptions {
+    /** Bearer Token（可选；不传时仅 public bucket 可访问） */
+    accessToken?: string;
+}
+/** 下载公开对象参数 */
+export interface IDownloadPublicObjectHttpOptions {
+    /** Bucket ID（Path 参数，必须为 public bucket） */
+    bucketId: string;
+    /** 对象名称（Path 参数） */
+    objectName: string;
+    /** HTTP 方法：GET 返回文件流；HEAD 仅返回响应头 */
+    method?: IDownloadObjectHttpMethod;
+    /** Query 参数：存在时触发浏览器下载，值作为下载文件名 */
+    download?: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 通过签名 URL 下载对象参数 */
+export interface IDownloadObjectBySignHttpOptions {
+    /** Bucket ID（Path 参数） */
+    bucketId: string;
+    /** 对象名称（Path 参数） */
+    objectName: string;
+    /** 签名 token（Query 参数，必填） */
+    token: string;
+    /** HTTP 方法：GET 返回文件流；HEAD 仅返回响应头 */
+    method?: IDownloadObjectHttpMethod;
+    /** Query 参数：存在时触发浏览器下载，值作为下载文件名 */
+    download?: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** Storage 响应头（小写 key） */
+export interface IStorageResponseHeaders {
+    /** 是否支持 Range 请求（断点续传） */
+    'accept-ranges'?: string;
+    /** 缓存控制（HTTP 响应级别） */
+    'cache-control'?: string;
+    /** 响应体字节数 */
+    'content-length'?: string;
+    /** MIME 类型 */
+    'content-type'?: string;
+    /** 响应时间（GMT） */
+    'date'?: string;
+    /** 响应体 ETag */
+    etag?: string;
+    /** 对象最后修改时间 */
+    'last-modified'?: string;
+    /** 服务器标识 */
+    server?: string;
+    /** CloudBase 请求追踪 ID */
+    'x-cloudbase-request-id'?: string;
+    /** 通用请求追踪 ID */
+    'x-request-id'?: string;
+    /** 爬虫指令 */
+    'x-robots-tag'?: string;
+    /** 其他未枚举的头 */
+    [key: string]: string | undefined;
+}
+/** 下载对象响应（GET 返回流；HEAD 的 body 为 null） */
+export interface IDownloadObjectHttpResult {
+    /** HTTP 状态码，例如 200 / 206 / 304 */
+    status: number;
+    /** 响应头（小写 key） */
+    headers: IStorageResponseHeaders;
+    /** GET 时为可读流，HEAD 时为 null */
+    body: NodeJS.ReadableStream | null;
+}
+/** 对象元信息（GET 响应 JSON） */
+export interface IObjectInfoHttpPayload {
+    id: string;
+    name: string;
+    version: string;
+    bucket_id: string;
+    size: number;
+    content_type: string;
+    cache_control: string;
+    etag: string;
+    metadata: Record<string, any>;
+    last_modified: string;
+    created_at: string;
+    [key: string]: any;
+}
+/** 获取对象元信息（需认证）参数 */
+export interface IGetObjectInfoAuthenticatedHttpOptions {
+    /** Bucket ID（Path 参数） */
+    bucketId: string;
+    /** 对象名称（Path 参数） */
+    objectName: string;
+    /** HTTP 方法：GET 返回 JSON；HEAD 仅返回响应头 */
+    method?: IDownloadObjectHttpMethod;
+    /** Bearer Token（access_token / apiKey / publishableKey 均可） */
+    accessToken: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 获取公开对象元信息参数（仅支持 GET） */
+export interface IGetObjectInfoPublicHttpOptions {
+    /** Bucket ID（Path 参数，必须为 public bucket） */
+    bucketId: string;
+    /** 对象名称（Path 参数） */
+    objectName: string;
+    /** 可选覆盖 envId */
+    envId?: string;
+}
+/** 获取对象元信息响应（HEAD 不返回 body） */
+export interface IGetObjectInfoHttpResult {
+    /** HTTP 状态码，例如 200 / 304 */
+    status: number;
+    /** 响应头（小写 key） */
+    headers: IStorageResponseHeaders;
+    /** GET 时返回 JSON；HEAD 时为 null */
+    body: IObjectInfoHttpPayload | null;
+}

package/cloudbase-manager-node/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "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

@@ -1,8 +0,0 @@
-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

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

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

@@ -1,27 +0,0 @@
-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

@@ -1,31 +0,0 @@
-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'
-}