@cloudbase/manager-node 4.10.4 → 4.10.5

package/lib/storage/index.js

@@ -617,21 +617,17 @@ class StorageService {
             Error
         };
     }
-    /**
-     * 获取文件存储权限
-     * READONLY：所有用户可读，仅创建者和管理员可写
-     * PRIVATE：仅创建者及管理员可读写
-     * ADMINWRITE：所有用户可读，仅管理员可写
-     * ADMINONLY：仅管理员可读写
-     * CUSTOM：自定义安全规则
-     * @returns {Promise<{ acl: AclType, rule?: IStorageAclRule }>}
-     */
-    async getStorageAcl() {
+    async getStorageAcl(options) {
         const { bucket, env } = this.getStorageConfig();
         const res = await this.tcbService.request('DescribeStorageSafeRule', {
             EnvId: env,
             Bucket: bucket
         });
+        // 默认行为：返回简单的 AclType（向后兼容）
+        if (!(options === null || options === void 0 ? void 0 : options.withRule)) {
+            return res.AclTag;
+        }
+        // 带规则模式：返回对象
         const result = { acl: res.AclTag };
         if (res.AclTag === 'CUSTOM' && res.Rule) {
             try {

package/package.json

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

package/types/storage/index.d.ts

@@ -227,9 +227,23 @@ export declare class StorageService {
      * ADMINWRITE：所有用户可读，仅管理员可写
      * ADMINONLY：仅管理员可读写
      * CUSTOM：自定义安全规则
-     * @returns {Promise<{ acl: AclType, rule?: IStorageAclRule }>}
-     */
-    getStorageAcl(): Promise<{
+     *
+     * @param options.withRule 是否返回自定义安全规则，默认 false 以保持向后兼容
+     * @returns 不传参数时返回 AclType（向后兼容），传入 { withRule: true } 时返回 { acl: AclType, rule?: IStorageAclRule }
+     *
+     * @example
+     * // 向后兼容的简单用法（返回 AclType）
+     * const acl = await storage.getStorageAcl()
+     * if (acl === 'READONLY') { ... }
+     *
+     * // 获取自定义安全规则（返回对象）
+     * const result = await storage.getStorageAcl({ withRule: true })
+     * console.log(result.acl, result.rule)
+     */
+    getStorageAcl(): Promise<AclType>;
+    getStorageAcl(options: {
+        withRule: true;
+    }): Promise<{
         acl: AclType;
         rule?: IStorageAclRule;
     }>;