@cloudbase/manager-node 5.8.9-beta.1 → 5.9.0

package/lib/storage/index.js

@@ -114,7 +114,7 @@ class StorageService {
         const isError = (res) => Object.prototype.toString.call(res) === '[object Error]';
         const firstError = results.find(isError);
         if (firstError) {
-            throw new error_1.CloudBaseError(`计算本地文件摘要失败：${firstError.message}`);
+            (0, error_1.throwFileError)(`计算本地文件摘要失败：${firstError.message}`);
         }
         return results.filter(res => res !== null);
     }
@@ -213,7 +213,7 @@ class StorageService {
                 CopySource: copySource
             });
             if (res.statusCode !== 200) {
-                throw new error_1.CloudBaseError(`备份文件失败：${file.key}`);
+                (0, error_1.throwApiError)(`备份文件失败：${file.key}`);
             }
             return destPath;
         }));
@@ -221,7 +221,7 @@ class StorageService {
         const isError = (res) => Object.prototype.toString.call(res) === '[object Error]';
         const firstError = results.find(isError);
         if (firstError) {
-            throw new error_1.CloudBaseError(`远端备份失败：${firstError.message}`);
+            (0, error_1.throwApiError)(`远端备份失败：${firstError.message}`);
         }
     }
     /**
@@ -246,7 +246,7 @@ class StorageService {
                     CopySource: copySource
                 });
                 if (res.statusCode !== 200) {
-                    throw new error_1.CloudBaseError(`恢复备份文件失败：${key}`);
+                    (0, error_1.throwApiError)(`恢复备份文件失败：${key}`);
                 }
                 return key;
             }));
@@ -254,7 +254,7 @@ class StorageService {
             const isError = (res) => Object.prototype.toString.call(res) === '[object Error]';
             const firstRestoreError = restoreResults.find(isError);
             if (firstRestoreError) {
-                throw new error_1.CloudBaseError(`从备份恢复远端文件失败：${firstRestoreError.message}`);
+                (0, error_1.throwApiError)(`从备份恢复远端文件失败：${firstRestoreError.message}`);
             }
         }
         if (addedKeys.length > 0) {
@@ -418,7 +418,7 @@ class StorageService {
                 });
                 const verifyResult = this.verifyManifest(localManifest, remoteManifest);
                 if (!verifyResult.ok) {
-                    throw new error_1.CloudBaseError(`一致性校验失败：missing=${verifyResult.missing.join(',') || '[]'}; mismatched=${verifyResult.mismatched.join(',') || '[]'}`);
+                    (0, error_1.throwApiError)(`一致性校验失败：missing=${verifyResult.missing.join(',') || '[]'}; mismatched=${verifyResult.mismatched.join(',') || '[]'}`);
                 }
             }
         }
@@ -439,9 +439,9 @@ class StorageService {
                 });
             }
             catch (rollbackError) {
-                throw new error_1.CloudBaseError(`一致性发布失败，且回滚失败，请使用备份人工恢复：${backupPrefix}；原始错误：${error.message}；回滚错误：${rollbackError.message}`);
+                (0, error_1.throwApiError)(`一致性发布失败，且回滚失败，请使用备份人工恢复：${backupPrefix}；原始错误：${error.message}；回滚错误：${rollbackError.message}`);
             }
-            throw new error_1.CloudBaseError(`一致性发布失败，已自动回滚，备份保留于 ${backupPrefix}，确认无误后可调用 cleanupBackup 清理：${error.message}`);
+            (0, error_1.throwApiError)(`一致性发布失败，已自动回滚，备份保留于 ${backupPrefix}，确认无误后可调用 cleanupBackup 清理：${error.message}`);
         }
         // 上传与可选校验均成功后才允许清理远端冗余文件。
         // 删除失败会记录在结果中，不触发已经成功发布内容的回滚。
@@ -530,7 +530,7 @@ class StorageService {
             localFilePath = resolveLocalPath;
         }
         if (!localFilePath) {
-            throw new error_1.CloudBaseError('本地文件不存在！');
+            (0, error_1.throwNotFound)('本地文件不存在！');
         }
         const cos = this.getCos();
         const putObject = util_1.default.promisify(cos.putObject).bind(cos);
@@ -570,7 +570,7 @@ class StorageService {
             });
         }
         if (res.statusCode !== 200) {
-            throw new error_1.CloudBaseError(`上传文件错误：${JSON.stringify(res)}`);
+            (0, error_1.throwApiError)(`上传文件错误：${JSON.stringify(res)}`);
         }
         return res;
     }
@@ -1015,7 +1015,7 @@ class StorageService {
             Body: ''
         });
         if (res.statusCode !== 200) {
-            throw new error_1.CloudBaseError(`创建文件夹失败：${JSON.stringify(res)}`);
+            (0, error_1.throwApiError)(`创建文件夹失败：${JSON.stringify(res)}`);
         }
     }
     /**
@@ -1097,7 +1097,7 @@ class StorageService {
      */
     async getTemporaryUrl(fileList) {
         if (!fileList || !Array.isArray(fileList)) {
-            throw new error_1.CloudBaseError('fileList 必须是非空的数组');
+            (0, error_1.throwInvalidParam)('fileList 必须是非空的数组');
         }
         const files = fileList.map(item => {
             if (typeof item === 'string') {
@@ -1109,7 +1109,7 @@ class StorageService {
         });
         const invalidData = files.find(item => !item.cloudPath || !item.maxAge || typeof item.cloudPath !== 'string');
         if (invalidData) {
-            throw new error_1.CloudBaseError(`非法参数：${JSON.stringify(invalidData)}`);
+            (0, error_1.throwInvalidParam)(`非法参数：${JSON.stringify(invalidData)}`);
         }
         const notExistsFiles = [];
         const checkFileRequests = files.map(file => (async () => {
@@ -1125,7 +1125,7 @@ class StorageService {
         await Promise.all(checkFileRequests);
         // 文件路径不存在
         if (notExistsFiles.length) {
-            throw new error_1.CloudBaseError(`以下文件不存在：${notExistsFiles.join(', ')}`);
+            (0, error_1.throwNotFound)(`以下文件不存在：${notExistsFiles.join(', ')}`);
         }
         const data = files.map(item => ({
             fileid: this.cloudPathToFileId(item.cloudPath),
@@ -1153,11 +1153,11 @@ class StorageService {
      */
     async deleteFile(cloudPathList) {
         if (!cloudPathList || !Array.isArray(cloudPathList)) {
-            throw new error_1.CloudBaseError('fileList必须是非空的数组');
+            (0, error_1.throwInvalidParam)('fileList必须是非空的数组');
         }
         const hasInvalidFileId = cloudPathList.some(file => !file || typeof file !== 'string');
         if (hasInvalidFileId) {
-            throw new error_1.CloudBaseError('fileList的元素必须是非空的字符串');
+            (0, error_1.throwInvalidParam)('fileList的元素必须是非空的字符串');
         }
         const { bucket, env } = this.getStorageConfig();
         const fileIdList = cloudPathList.map(filePath => this.cloudPathToFileId(filePath));
@@ -1170,10 +1170,16 @@ class StorageService {
             },
             method: 'POST'
         });
+        (0, utils_1.assertDataPlaneOk)(res, 'storage.batchDeleteFile');
         const failed = collectBatchDeleteFailures(res.data.delete_list, fileIdList, cloudPathList);
         if (failed.length) {
             const failedList = failed.map(item => `${item.fileId} : ${item.code}`);
             throw new error_1.CloudBaseError(`部分删除文件失败：${JSON.stringify(failedList)}`, {
+                // 稳定码：消费方据此判断「逐项结果可用」，而不是拿「某字段存不存在」猜 SDK 版本。
+                // 与 cloudbase-cli/src/commands/storage/batch-delete.ts 的同名常量**一字不差**（跨仓契约）。
+                code: 'STORAGE_BATCH_DELETE_PARTIAL_FAILED',
+                source: 'manager-node',
+                // 逐项结果放在 meta.failed（v5.8.8 起的既有契约，消费方 batch-delete.ts 按此读取）
                 meta: { failed, total: cloudPathList.length }
             });
         }
@@ -1188,11 +1194,11 @@ class StorageService {
      */
     async deleteFileCustom(cloudPathList, bucket, region) {
         if (!cloudPathList || !Array.isArray(cloudPathList)) {
-            throw new error_1.CloudBaseError('fileList必须是非空的数组');
+            (0, error_1.throwInvalidParam)('fileList必须是非空的数组');
         }
         const hasInvalidFileId = cloudPathList.some(file => !file || typeof file !== 'string');
         if (hasInvalidFileId) {
-            throw new error_1.CloudBaseError('fileList的元素必须是非空的字符串');
+            (0, error_1.throwInvalidParam)('fileList的元素必须是非空的字符串');
         }
         const cos = this.getCos();
         const deleteObject = util_1.default.promisify(cos.deleteObject).bind(cos);
@@ -1218,7 +1224,7 @@ class StorageService {
             Key: (0, storage_config_1.toPhysicalKey)(basePath, cloudPath)
         });
         if (!headers) {
-            throw new error_1.CloudBaseError(`[${cloudPath}] 获取文件信息失败`);
+            (0, error_1.throwApiError)(`[${cloudPath}] 获取文件信息失败`);
         }
         // 文件大小 KB
         const size = Number(Number(headers['content-length']) / 1024).toFixed(2);
@@ -1339,10 +1345,10 @@ class StorageService {
     async setStorageAcl(acl, rule) {
         const validAcl = ['READONLY', 'PRIVATE', 'ADMINWRITE', 'ADMINONLY', 'CUSTOM'];
         if (!validAcl.includes(acl)) {
-            throw new error_1.CloudBaseError(`非法的权限类型: "${acl}", 有效值: ${validAcl.join(', ')}`);
+            (0, error_1.throwInvalidParam)(`非法的权限类型: "${acl}", 有效值: ${validAcl.join(', ')}`);
         }
         if (acl === 'CUSTOM' && !rule) {
-            throw new error_1.CloudBaseError('使用 CUSTOM 权限类型时，必须提供 rule 参数');
+            (0, error_1.throwInvalidParam)('使用 CUSTOM 权限类型时，必须提供 rule 参数');
         }
         const { bucket, env } = this.getStorageConfig();
         const params = {
@@ -1487,7 +1493,7 @@ class StorageService {
             });
         }
         catch (e) {
-            throw new error_1.CloudBaseError(e.message);
+            (0, error_1.throwApiError)(e.message);
         }
     }
     /**
@@ -1503,11 +1509,7 @@ class StorageService {
             },
             method: 'POST'
         });
-        if (res.code) {
-            throw new error_1.CloudBaseError(`${res.code}: ${res.message || ''}`, {
-                requestId: res.requestId
-            });
-        }
+        (0, utils_1.assertDataPlaneOk)(res, 'storage.getUploadMetadata');
         return res.data;
     }
     /**
@@ -1662,7 +1664,7 @@ class StorageService {
             CopySource: copySource
         });
         if (res.statusCode !== 200) {
-            throw new error_1.CloudBaseError(`复制文件失败：${JSON.stringify(res)}`);
+            (0, error_1.throwApiError)(`复制文件失败：${JSON.stringify(res)}`);
         }
         // 4. 返回复制结果
         return {
@@ -1952,19 +1954,19 @@ class StorageService {
     async uploadObject(options) {
         const { bucketId, objectName, localPath, body, contentType, contentLength, cacheControl, metadata, xRobotsTag, upsert = false, usePut = false, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         if (!localPath && !body) {
-            throw new error_1.CloudBaseError('localPath 与 body 至少提供一个');
+            (0, error_1.throwInvalidParam)('localPath 与 body 至少提供一个');
         }
         if (localPath && body) {
-            throw new error_1.CloudBaseError('localPath 与 body 只能二选一');
+            (0, error_1.throwInvalidParam)('localPath 与 body 只能二选一');
         }
         // env / proxy
         const authConfig = this.environment.getAuthConfig();
@@ -1986,7 +1988,7 @@ class StorageService {
             (0, utils_1.checkFullAccess)(resolvedPath, true);
             const stat = fs_1.default.statSync(resolvedPath);
             if (!stat.isFile()) {
-                throw new error_1.CloudBaseError(`localPath 不是文件: ${localPath}`);
+                (0, error_1.throwInvalidParam)(`localPath 不是文件: ${localPath}`);
             }
             fileSize = stat.size;
         }
@@ -1996,8 +1998,8 @@ class StorageService {
         // 文档约束：> 100MB 拒绝
         const LIMIT_100MB = 100 * 1024 * 1024;
         if (fileSize !== undefined && fileSize > LIMIT_100MB) {
-            throw new error_1.CloudBaseError('FileSizeLimitExceeded: 文件大小超过 100MB', {
-                code: 'FileSizeLimitExceeded'
+            throw new error_1.CloudBaseError('文件大小超过 100MB', {
+                code: 'FILE_SIZE_LIMIT_EXCEEDED'
             });
         }
         const finalContentType = this.resolveUploadContentType({
@@ -2044,9 +2046,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2058,7 +2060,7 @@ class StorageService {
             });
         }
         if (!payload || !payload.Id || !payload.Key) {
-            throw new error_1.CloudBaseError('上传成功但响应格式异常：缺少 Id 或 Key');
+            (0, error_1.throwApiError)('上传成功但响应格式异常：缺少 Id 或 Key');
         }
         return {
             Id: payload.Id,
@@ -2072,13 +2074,13 @@ class StorageService {
     async deleteObject(options) {
         const { bucketId, objectName, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2103,9 +2105,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2128,20 +2130,20 @@ class StorageService {
     async deleteObjects(options) {
         const { bucketId, prefixes, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         if (!Array.isArray(prefixes) || prefixes.length === 0) {
-            throw new error_1.CloudBaseError('prefixes 必须是非空数组');
+            (0, error_1.throwInvalidParam)('prefixes 必须是非空数组');
         }
         if (prefixes.length > 20) {
-            throw new error_1.CloudBaseError('prefixes 最多 20 个');
+            (0, error_1.throwInvalidParam)('prefixes 最多 20 个');
         }
         for (const name of prefixes) {
             if (!name || typeof name !== 'string') {
-                throw new error_1.CloudBaseError('prefixes 中的每一项必须是非空字符串');
+                (0, error_1.throwInvalidParam)('prefixes 中的每一项必须是非空字符串');
             }
         }
         const env = this.environment.getEnvId();
@@ -2165,9 +2167,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2179,7 +2181,7 @@ class StorageService {
             });
         }
         if (!Array.isArray(payload)) {
-            throw new error_1.CloudBaseError('批量删除响应格式异常：期望数组');
+            (0, error_1.throwApiError)('批量删除响应格式异常：期望数组');
         }
         return payload;
     }
@@ -2191,29 +2193,29 @@ class StorageService {
     async copyObject(options) {
         const { bucketId, sourceKey, destinationKey, destinationBucket, metadata, userMetadata, copyMetadata, upsert, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!sourceKey || typeof sourceKey !== 'string') {
-            throw new error_1.CloudBaseError('sourceKey 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('sourceKey 必须是非空字符串');
         }
         if (!destinationKey || typeof destinationKey !== 'string') {
-            throw new error_1.CloudBaseError('destinationKey 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('destinationKey 必须是非空字符串');
         }
         if (destinationBucket !== undefined &&
             (typeof destinationBucket !== 'string' || !destinationBucket)) {
-            throw new error_1.CloudBaseError('destinationBucket 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('destinationBucket 必须是非空字符串');
         }
         if (metadata !== undefined && (typeof metadata !== 'object' || metadata === null || Array.isArray(metadata))) {
-            throw new error_1.CloudBaseError('metadata 必须是对象');
+            (0, error_1.throwInvalidParam)('metadata 必须是对象');
         }
         if (userMetadata !== undefined && (typeof userMetadata !== 'object' || userMetadata === null || Array.isArray(userMetadata))) {
-            throw new error_1.CloudBaseError('userMetadata 必须是对象');
+            (0, error_1.throwInvalidParam)('userMetadata 必须是对象');
         }
         if (copyMetadata !== undefined && typeof copyMetadata !== 'boolean') {
-            throw new error_1.CloudBaseError('copyMetadata 必须是布尔值');
+            (0, error_1.throwInvalidParam)('copyMetadata 必须是布尔值');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2254,9 +2256,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2268,7 +2270,7 @@ class StorageService {
             });
         }
         if (!payload || !payload.Id || !payload.Key) {
-            throw new error_1.CloudBaseError('复制成功但响应格式异常：缺少 Id 或 Key');
+            (0, error_1.throwApiError)('复制成功但响应格式异常：缺少 Id 或 Key');
         }
         return payload;
     }
@@ -2279,20 +2281,20 @@ class StorageService {
     async moveObject(options) {
         const { bucketId, sourceKey, destinationKey, destinationBucket, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!sourceKey || typeof sourceKey !== 'string') {
-            throw new error_1.CloudBaseError('sourceKey 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('sourceKey 必须是非空字符串');
         }
         if (!destinationKey || typeof destinationKey !== 'string') {
-            throw new error_1.CloudBaseError('destinationKey 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('destinationKey 必须是非空字符串');
         }
         if (destinationBucket !== undefined &&
             (typeof destinationBucket !== 'string' || !destinationBucket)) {
-            throw new error_1.CloudBaseError('destinationBucket 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('destinationBucket 必须是非空字符串');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2321,9 +2323,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2335,7 +2337,7 @@ class StorageService {
             });
         }
         if (!payload || !payload.Id || !payload.Key) {
-            throw new error_1.CloudBaseError('移动成功但响应格式异常：缺少 Id 或 Key');
+            (0, error_1.throwApiError)('移动成功但响应格式异常：缺少 Id 或 Key');
         }
         return {
             message: payload.message || 'Successfully moved',
@@ -2351,41 +2353,41 @@ class StorageService {
     async listObjects(options) {
         const { bucketId, prefix, limit, cursor, withDelimiter, sortBy, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (prefix !== undefined && typeof prefix !== 'string') {
-            throw new error_1.CloudBaseError('prefix 必须是字符串');
+            (0, error_1.throwInvalidParam)('prefix 必须是字符串');
         }
         if (limit !== undefined) {
             if (!Number.isInteger(limit)) {
-                throw new error_1.CloudBaseError('limit 必须是整数');
+                (0, error_1.throwInvalidParam)('limit 必须是整数');
             }
             if (limit < 1 || limit > 1000) {
-                throw new error_1.CloudBaseError('limit 必须在 1 ~ 1000 之间');
+                (0, error_1.throwInvalidParam)('limit 必须在 1 ~ 1000 之间');
             }
         }
         if (cursor !== undefined && typeof cursor !== 'string') {
-            throw new error_1.CloudBaseError('cursor 必须是字符串');
+            (0, error_1.throwInvalidParam)('cursor 必须是字符串');
         }
         if (withDelimiter !== undefined && typeof withDelimiter !== 'boolean') {
-            throw new error_1.CloudBaseError('withDelimiter 必须是布尔值');
+            (0, error_1.throwInvalidParam)('withDelimiter 必须是布尔值');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         if (sortBy !== undefined) {
             if (typeof sortBy !== 'object' || sortBy === null || Array.isArray(sortBy)) {
-                throw new error_1.CloudBaseError('sortBy 必须是对象');
+                (0, error_1.throwInvalidParam)('sortBy 必须是对象');
             }
             const allowedColumns = ['name', 'created_at', 'updated_at'];
             const allowedOrders = ['asc', 'desc'];
             if (sortBy.column !== undefined && !allowedColumns.includes(sortBy.column)) {
-                throw new error_1.CloudBaseError(`sortBy.column 非法，允许值：${allowedColumns.join('、')}`);
+                (0, error_1.throwInvalidParam)(`sortBy.column 非法，允许值：${allowedColumns.join('、')}`);
             }
             if (sortBy.order !== undefined) {
                 const normalizedOrder = String(sortBy.order).toLowerCase();
                 if (!allowedOrders.includes(normalizedOrder)) {
-                    throw new error_1.CloudBaseError(`sortBy.order 非法，允许值：${allowedOrders.join('、')}`);
+                    (0, error_1.throwInvalidParam)(`sortBy.order 非法，允许值：${allowedOrders.join('、')}`);
                 }
                 sortBy.order = normalizedOrder;
             }
@@ -2422,9 +2424,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2436,7 +2438,7 @@ class StorageService {
             });
         }
         if (!payload || !Array.isArray(payload.objects) || !Array.isArray(payload.folders)) {
-            throw new error_1.CloudBaseError('列出对象成功但响应格式异常：缺少 folders 或 objects 数组');
+            (0, error_1.throwApiError)('列出对象成功但响应格式异常：缺少 folders 或 objects 数组');
         }
         const result = Object.assign({ folders: payload.folders, objects: payload.objects, hasNext: Boolean(payload.hasNext), nextCursor: payload.nextCursor, nextCursorKey: payload.nextCursorKey }, payload);
         return result;
@@ -2448,19 +2450,19 @@ class StorageService {
     async signObject(options) {
         const { bucketId, objectName, expiresIn, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (!Number.isInteger(expiresIn)) {
-            throw new error_1.CloudBaseError('expiresIn 必须是整数');
+            (0, error_1.throwInvalidParam)('expiresIn 必须是整数');
         }
         if (expiresIn < 1) {
-            throw new error_1.CloudBaseError('expiresIn 必须 >= 1');
+            (0, error_1.throwInvalidParam)('expiresIn 必须 >= 1');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2487,9 +2489,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2501,7 +2503,7 @@ class StorageService {
             });
         }
         if (!payload || typeof payload.signedURL !== 'string' || !payload.signedURL) {
-            throw new error_1.CloudBaseError('生成签名 URL 成功但响应格式异常：缺少 signedURL');
+            (0, error_1.throwApiError)('生成签名 URL 成功但响应格式异常：缺少 signedURL');
         }
         return {
             signedURL: payload.signedURL
@@ -2514,27 +2516,27 @@ class StorageService {
     async signObjects(options) {
         const { bucketId, expiresIn, paths, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!Number.isInteger(expiresIn)) {
-            throw new error_1.CloudBaseError('expiresIn 必须是整数');
+            (0, error_1.throwInvalidParam)('expiresIn 必须是整数');
         }
         if (expiresIn < 1) {
-            throw new error_1.CloudBaseError('expiresIn 必须 >= 1');
+            (0, error_1.throwInvalidParam)('expiresIn 必须 >= 1');
         }
         if (!Array.isArray(paths) || paths.length === 0) {
-            throw new error_1.CloudBaseError('paths 必须是非空数组');
+            (0, error_1.throwInvalidParam)('paths 必须是非空数组');
         }
         if (paths.length > 500) {
-            throw new error_1.CloudBaseError('paths 最多 500 个');
+            (0, error_1.throwInvalidParam)('paths 最多 500 个');
         }
         for (const pathItem of paths) {
             if (!pathItem || typeof pathItem !== 'string') {
-                throw new error_1.CloudBaseError('paths 中每一项必须是非空字符串');
+                (0, error_1.throwInvalidParam)('paths 中每一项必须是非空字符串');
             }
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2560,9 +2562,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2574,7 +2576,7 @@ class StorageService {
             });
         }
         if (!Array.isArray(payload)) {
-            throw new error_1.CloudBaseError('批量生成签名 URL 成功但响应格式异常：期望数组');
+            (0, error_1.throwApiError)('批量生成签名 URL 成功但响应格式异常：期望数组');
         }
         return payload;
     }
@@ -2585,16 +2587,16 @@ class StorageService {
     async signUploadObject(options) {
         const { bucketId, objectName, upsert = false, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (typeof upsert !== 'boolean') {
-            throw new error_1.CloudBaseError('upsert 必须是布尔值');
+            (0, error_1.throwInvalidParam)('upsert 必须是布尔值');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2623,9 +2625,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2637,7 +2639,7 @@ class StorageService {
             });
         }
         if (!payload || typeof payload.url !== 'string' || typeof payload.token !== 'string') {
-            throw new error_1.CloudBaseError('生成签名上传 URL 成功但响应格式异常：缺少 url 或 token');
+            (0, error_1.throwApiError)('生成签名上传 URL 成功但响应格式异常：缺少 url 或 token');
         }
         return {
             url: payload.url,
@@ -2651,19 +2653,19 @@ class StorageService {
     async uploadObjectBySign(options) {
         const { bucketId, objectName, token, localPath, body, contentType, contentLength, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (!token || typeof token !== 'string') {
-            throw new error_1.CloudBaseError('token 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('token 必须是非空字符串');
         }
         if (!localPath && !body) {
-            throw new error_1.CloudBaseError('localPath 与 body 至少提供一个');
+            (0, error_1.throwInvalidParam)('localPath 与 body 至少提供一个');
         }
         if (localPath && body) {
-            throw new error_1.CloudBaseError('localPath 与 body 只能二选一');
+            (0, error_1.throwInvalidParam)('localPath 与 body 只能二选一');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2680,7 +2682,7 @@ class StorageService {
             (0, utils_1.checkFullAccess)(resolvedPath, true);
             const stat = fs_1.default.statSync(resolvedPath);
             if (!stat.isFile()) {
-                throw new error_1.CloudBaseError(`localPath 不是文件: ${localPath}`);
+                (0, error_1.throwInvalidParam)(`localPath 不是文件: ${localPath}`);
             }
             fileSize = stat.size;
         }
@@ -2715,9 +2717,9 @@ class StorageService {
             }
             catch (_a) {
                 if (!res.ok) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!res.ok) {
@@ -2729,7 +2731,7 @@ class StorageService {
             });
         }
         if (!payload || typeof payload.Key !== 'string' || !payload.Key) {
-            throw new error_1.CloudBaseError('签名上传成功但响应格式异常：缺少 Key');
+            (0, error_1.throwApiError)('签名上传成功但响应格式异常：缺少 Key');
         }
         return {
             Key: payload.Key
@@ -2742,18 +2744,18 @@ class StorageService {
     async downloadAuthenticatedObject(options) {
         const { bucketId, objectName, method = 'GET', download, ifNoneMatch, ifModifiedSince, range, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         const normalizedMethod = String(method).toUpperCase();
         const allowedMethods = ['GET', 'HEAD'];
         if (!allowedMethods.includes(normalizedMethod)) {
-            throw new error_1.CloudBaseError('method 仅支持 GET 或 HEAD');
+            (0, error_1.throwInvalidParam)('method 仅支持 GET 或 HEAD');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2765,7 +2767,7 @@ class StorageService {
         let url = `https://${envId}.api.tcloudbasegateway.com/v1/storages/object/authenticated/${encodedBucketId}/${encodedObjectName}`;
         if (download !== undefined) {
             if (typeof download !== 'string') {
-                throw new error_1.CloudBaseError('download 必须是字符串');
+                (0, error_1.throwInvalidParam)('download 必须是字符串');
             }
             url += `?download=${encodeURIComponent(download)}`;
         }
@@ -2774,19 +2776,19 @@ class StorageService {
         };
         if (ifNoneMatch !== undefined) {
             if (typeof ifNoneMatch !== 'string') {
-                throw new error_1.CloudBaseError('ifNoneMatch 必须是字符串');
+                (0, error_1.throwInvalidParam)('ifNoneMatch 必须是字符串');
             }
             headers['If-None-Match'] = ifNoneMatch;
         }
         if (ifModifiedSince !== undefined) {
             if (typeof ifModifiedSince !== 'string') {
-                throw new error_1.CloudBaseError('ifModifiedSince 必须是字符串');
+                (0, error_1.throwInvalidParam)('ifModifiedSince 必须是字符串');
             }
             headers['If-Modified-Since'] = ifModifiedSince;
         }
         if (range !== undefined) {
             if (typeof range !== 'string') {
-                throw new error_1.CloudBaseError('range 必须是字符串');
+                (0, error_1.throwInvalidParam)('range 必须是字符串');
             }
             headers.Range = range;
         }
@@ -2803,7 +2805,7 @@ class StorageService {
                     payload = JSON.parse(text);
                 }
                 catch (_a) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
             }
             const code = (payload === null || payload === void 0 ? void 0 : payload.Code) || (payload === null || payload === void 0 ? void 0 : payload.code) || `HTTP_${res.status}`;
@@ -2830,18 +2832,18 @@ class StorageService {
     async downloadObject(options) {
         const { bucketId, objectName, method = 'GET', download, ifNoneMatch, ifModifiedSince, range, accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (accessToken !== undefined && typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是字符串');
         }
         const normalizedMethod = String(method).toUpperCase();
         const allowedMethods = ['GET', 'HEAD'];
         if (!allowedMethods.includes(normalizedMethod)) {
-            throw new error_1.CloudBaseError('method 仅支持 GET 或 HEAD');
+            (0, error_1.throwInvalidParam)('method 仅支持 GET 或 HEAD');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2853,7 +2855,7 @@ class StorageService {
         let url = `https://${envId}.api.tcloudbasegateway.com/v1/storages/object/${encodedBucketId}/${encodedObjectName}`;
         if (download !== undefined) {
             if (typeof download !== 'string') {
-                throw new error_1.CloudBaseError('download 必须是字符串');
+                (0, error_1.throwInvalidParam)('download 必须是字符串');
             }
             url += `?download=${encodeURIComponent(download)}`;
         }
@@ -2863,19 +2865,19 @@ class StorageService {
         }
         if (ifNoneMatch !== undefined) {
             if (typeof ifNoneMatch !== 'string') {
-                throw new error_1.CloudBaseError('ifNoneMatch 必须是字符串');
+                (0, error_1.throwInvalidParam)('ifNoneMatch 必须是字符串');
             }
             headers['If-None-Match'] = ifNoneMatch;
         }
         if (ifModifiedSince !== undefined) {
             if (typeof ifModifiedSince !== 'string') {
-                throw new error_1.CloudBaseError('ifModifiedSince 必须是字符串');
+                (0, error_1.throwInvalidParam)('ifModifiedSince 必须是字符串');
             }
             headers['If-Modified-Since'] = ifModifiedSince;
         }
         if (range !== undefined) {
             if (typeof range !== 'string') {
-                throw new error_1.CloudBaseError('range 必须是字符串');
+                (0, error_1.throwInvalidParam)('range 必须是字符串');
             }
             headers.Range = range;
         }
@@ -2892,7 +2894,7 @@ class StorageService {
                     payload = JSON.parse(text);
                 }
                 catch (_a) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
             }
             const code = (payload === null || payload === void 0 ? void 0 : payload.Code) || (payload === null || payload === void 0 ? void 0 : payload.code) || `HTTP_${res.status}`;
@@ -2919,15 +2921,15 @@ class StorageService {
     async downloadPublicObject(options) {
         const { bucketId, objectName, method = 'GET', download, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         const normalizedMethod = String(method).toUpperCase();
         const allowedMethods = ['GET', 'HEAD'];
         if (!allowedMethods.includes(normalizedMethod)) {
-            throw new error_1.CloudBaseError('method 仅支持 GET 或 HEAD');
+            (0, error_1.throwInvalidParam)('method 仅支持 GET 或 HEAD');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -2939,7 +2941,7 @@ class StorageService {
         let url = `https://${envId}.api.tcloudbasegateway.com/v1/storages/object/public/${encodedBucketId}/${encodedObjectName}`;
         if (download !== undefined) {
             if (typeof download !== 'string') {
-                throw new error_1.CloudBaseError('download 必须是字符串');
+                (0, error_1.throwInvalidParam)('download 必须是字符串');
             }
             url += `?download=${encodeURIComponent(download)}`;
         }
@@ -2955,7 +2957,7 @@ class StorageService {
                     payload = JSON.parse(text);
                 }
                 catch (_a) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
             }
             const code = (payload === null || payload === void 0 ? void 0 : payload.Code) || (payload === null || payload === void 0 ? void 0 : payload.code) || `HTTP_${res.status}`;
@@ -2982,18 +2984,18 @@ class StorageService {
     async downloadObjectBySign(options) {
         const { bucketId, objectName, token, method = 'GET', download, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (!token || typeof token !== 'string') {
-            throw new error_1.CloudBaseError('token 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('token 必须是非空字符串');
         }
         const normalizedMethod = String(method).toUpperCase();
         const allowedMethods = ['GET', 'HEAD'];
         if (!allowedMethods.includes(normalizedMethod)) {
-            throw new error_1.CloudBaseError('method 仅支持 GET 或 HEAD');
+            (0, error_1.throwInvalidParam)('method 仅支持 GET 或 HEAD');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -3005,7 +3007,7 @@ class StorageService {
         let url = `https://${envId}.api.tcloudbasegateway.com/v1/storages/object/sign/${encodedBucketId}/${encodedObjectName}?token=${encodeURIComponent(token)}`;
         if (download !== undefined) {
             if (typeof download !== 'string') {
-                throw new error_1.CloudBaseError('download 必须是字符串');
+                (0, error_1.throwInvalidParam)('download 必须是字符串');
             }
             url += `&download=${encodeURIComponent(download)}`;
         }
@@ -3021,7 +3023,7 @@ class StorageService {
                     payload = JSON.parse(text);
                 }
                 catch (_a) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
             }
             const code = (payload === null || payload === void 0 ? void 0 : payload.Code) || (payload === null || payload === void 0 ? void 0 : payload.code) || `HTTP_${res.status}`;
@@ -3048,18 +3050,18 @@ class StorageService {
     async getObjectInfoAuthenticated(options) {
         const { bucketId, objectName, method = 'GET', accessToken, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         if (!accessToken || typeof accessToken !== 'string') {
-            throw new error_1.CloudBaseError('accessToken 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('accessToken 必须是非空字符串');
         }
         const normalizedMethod = String(method).toUpperCase();
         const allowedMethods = ['GET', 'HEAD'];
         if (!allowedMethods.includes(normalizedMethod)) {
-            throw new error_1.CloudBaseError('method 仅支持 GET 或 HEAD');
+            (0, error_1.throwInvalidParam)('method 仅支持 GET 或 HEAD');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -3084,7 +3086,7 @@ class StorageService {
                     payload = JSON.parse(text);
                 }
                 catch (_a) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
             }
             const code = (payload === null || payload === void 0 ? void 0 : payload.Code) || (payload === null || payload === void 0 ? void 0 : payload.code) || `HTTP_${res.status}`;
@@ -3112,11 +3114,11 @@ class StorageService {
                 payload = JSON.parse(text);
             }
             catch (_b) {
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
-            throw new error_1.CloudBaseError('获取对象元信息成功但响应格式异常：期望 JSON 对象');
+            (0, error_1.throwApiError)('获取对象元信息成功但响应格式异常：期望 JSON 对象');
         }
         return {
             status: res.status,
@@ -3131,10 +3133,10 @@ class StorageService {
     async getObjectInfoPublic(options) {
         const { bucketId, objectName, envId: envIdOverride } = options;
         if (!bucketId || typeof bucketId !== 'string') {
-            throw new error_1.CloudBaseError('bucketId 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('bucketId 必须是非空字符串');
         }
         if (!objectName || typeof objectName !== 'string') {
-            throw new error_1.CloudBaseError('objectName 必须是非空字符串');
+            (0, error_1.throwInvalidParam)('objectName 必须是非空字符串');
         }
         const env = this.environment.getEnvId();
         const envId = envIdOverride || env;
@@ -3156,7 +3158,7 @@ class StorageService {
                     payload = JSON.parse(text);
                 }
                 catch (_a) {
-                    throw new error_1.CloudBaseError(`HTTP_${res.status}: ${text}`);
+                    (0, error_1.throwApiError)(`HTTP_${res.status}: ${text}`);
                 }
             }
             const code = (payload === null || payload === void 0 ? void 0 : payload.Code) || (payload === null || payload === void 0 ? void 0 : payload.code) || `HTTP_${res.status}`;
@@ -3177,11 +3179,11 @@ class StorageService {
                 payload = JSON.parse(text);
             }
             catch (_b) {
-                throw new error_1.CloudBaseError(`响应不是合法 JSON: ${text}`);
+                (0, error_1.throwApiError)(`响应不是合法 JSON: ${text}`);
             }
         }
         if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
-            throw new error_1.CloudBaseError('获取公开对象元信息成功但响应格式异常：期望 JSON 对象');
+            (0, error_1.throwApiError)('获取公开对象元信息成功但响应格式异常：期望 JSON 对象');
         }
         return {
             status: res.status,
@@ -3398,16 +3400,16 @@ class StorageService {
     assertValidContentType(input) {
         const ct = input.trim();
         if (!ct)
-            throw new error_1.CloudBaseError('contentType 不能为空');
+            (0, error_1.throwInvalidParam)('contentType 不能为空');
         // 防 header 注入 / 控制字符
         if (/[\u0000-\u001F\u007F]/.test(ct)) {
-            throw new error_1.CloudBaseError('contentType 非法：包含控制字符');
+            (0, error_1.throwInvalidParam)('contentType 非法：包含控制字符');
         }
         // 只校验主类型（; 后参数放宽）
         const base = ct.split(';', 1)[0].trim();
         const typeSubtypeRe = /^[!#$%&'*+.^_`|~0-9A-Za-z-]+\/[!#$%&'*+.^_`|~0-9A-Za-z-]+$/;
         if (!typeSubtypeRe.test(base)) {
-            throw new error_1.CloudBaseError('contentType 非法：主类型格式不正确');
+            (0, error_1.throwInvalidParam)('contentType 非法：主类型格式不正确');
         }
         return ct;
     }