@h-ai/storage 0.1.0-alpha5

package/dist/chunk-U427BQIQ.js

@@ -0,0 +1,266 @@
+import { core } from '@h-ai/core';
+
+// src/storage-i18n.ts
+
+// messages/en-US.json
+var en_US_default = {
+  $schema: "https://inlang.com/schema/inlang-message-format",
+  storage_notInitialized: "Storage not initialized, please call storage.init() first",
+  storage_bucketNotExist: "Bucket does not exist",
+  storage_networkError: "Network error",
+  storage_responseBodyEmpty: "Response body is empty",
+  storage_presignUrlFailed: "Failed to generate presigned URL",
+  storage_presignUploadUrlFailed: "Failed to generate presigned upload URL",
+  storage_s3ConfigTypeError: "Config type error: S3 provider only supports type=s3",
+  storage_diskSpaceInsufficient: "Insufficient disk space",
+  storage_localConfigTypeError: "Config type error: Local provider only supports type=local",
+  storage_operationFailed: "Operation failed: {error}",
+  storage_unsupportedType: "Unsupported storage type: {type}",
+  storage_config_bucketRequired: "Bucket is required",
+  storage_config_regionRequired: "Region is required",
+  storage_config_accessKeyIdRequired: "Access Key ID is required",
+  storage_config_secretAccessKeyRequired: "Secret Access Key is required",
+  storage_config_rootRequired: "Root path is required",
+  storage_fileNotFound: "File not found: {key}",
+  storage_permissionDenied: "Permission denied: {key}",
+  storage_pathIsDir: "Path is a directory: {key}",
+  storage_ioError: "IO error: {error}",
+  storage_deleteManyFailed: "Failed to delete {count} files",
+  storage_s3ClientNotInitialized: "S3 client not initialized",
+  storage_s3ConfigNotInitialized: "S3 config not initialized",
+  storage_uploadCanceled: "Upload canceled",
+  storage_downloadCanceled: "Download canceled",
+  storage_uploadFailedStatus: "Upload failed (status {status}): {statusText}",
+  storage_downloadFailedStatus: "Download failed (status {status}): {statusText}",
+  storage_unknownError: "Unknown error",
+  storage_saveFileFailed: "Failed to save file",
+  storage_downloadDefaultFilename: "download",
+  storage_pathTraversal: "Path traversal attack detected",
+  storage_localNotInitialized: "Local storage not initialized",
+  storage_configError: "Storage config validation failed: {error}",
+  storage_metaFileAccess: "Direct access to metadata files is not allowed: {key}"
+};
+
+// messages/zh-CN.json
+var zh_CN_default = {
+  $schema: "https://inlang.com/schema/inlang-message-format",
+  storage_notInitialized: "\u5B58\u50A8\u672A\u521D\u59CB\u5316\uFF0C\u8BF7\u5148\u8C03\u7528 storage.init()",
+  storage_bucketNotExist: "\u5B58\u50A8\u6876\u4E0D\u5B58\u5728",
+  storage_networkError: "\u7F51\u7EDC\u9519\u8BEF",
+  storage_responseBodyEmpty: "\u54CD\u5E94\u4F53\u4E3A\u7A7A",
+  storage_presignUrlFailed: "\u751F\u6210\u7B7E\u540D URL \u5931\u8D25",
+  storage_presignUploadUrlFailed: "\u751F\u6210\u4E0A\u4F20\u7B7E\u540D URL \u5931\u8D25",
+  storage_s3ConfigTypeError: "\u914D\u7F6E\u7C7B\u578B\u9519\u8BEF\uFF1AS3 provider \u4EC5\u652F\u6301 type=s3",
+  storage_diskSpaceInsufficient: "\u78C1\u76D8\u7A7A\u95F4\u4E0D\u8DB3",
+  storage_localConfigTypeError: "\u914D\u7F6E\u7C7B\u578B\u9519\u8BEF\uFF1ALocal provider \u4EC5\u652F\u6301 type=local",
+  storage_operationFailed: "\u64CD\u4F5C\u5931\u8D25: {error}",
+  storage_unsupportedType: "\u4E0D\u652F\u6301\u7684\u5B58\u50A8\u7C7B\u578B\uFF1A{type}",
+  storage_config_bucketRequired: "\u5B58\u50A8\u6876\u4E0D\u80FD\u4E3A\u7A7A",
+  storage_config_regionRequired: "\u533A\u57DF\u4E0D\u80FD\u4E3A\u7A7A",
+  storage_config_accessKeyIdRequired: "Access Key ID \u4E0D\u80FD\u4E3A\u7A7A",
+  storage_config_secretAccessKeyRequired: "Secret Access Key \u4E0D\u80FD\u4E3A\u7A7A",
+  storage_config_rootRequired: "Root \u4E0D\u80FD\u4E3A\u7A7A",
+  storage_fileNotFound: "\u6587\u4EF6\u4E0D\u5B58\u5728: {key}",
+  storage_permissionDenied: "\u6743\u9650\u4E0D\u8DB3: {key}",
+  storage_pathIsDir: "\u8DEF\u5F84\u662F\u76EE\u5F55: {key}",
+  storage_ioError: "IO \u9519\u8BEF: {error}",
+  storage_deleteManyFailed: "\u5220\u9664 {count} \u4E2A\u6587\u4EF6\u5931\u8D25",
+  storage_s3ClientNotInitialized: "S3 \u5BA2\u6237\u7AEF\u672A\u521D\u59CB\u5316",
+  storage_s3ConfigNotInitialized: "S3 \u914D\u7F6E\u672A\u521D\u59CB\u5316",
+  storage_uploadCanceled: "\u4E0A\u4F20\u5DF2\u53D6\u6D88",
+  storage_downloadCanceled: "\u4E0B\u8F7D\u5DF2\u53D6\u6D88",
+  storage_uploadFailedStatus: "\u4E0A\u4F20\u5931\u8D25\uFF08\u72B6\u6001\u7801 {status}\uFF09\uFF1A{statusText}",
+  storage_downloadFailedStatus: "\u4E0B\u8F7D\u5931\u8D25\uFF08\u72B6\u6001\u7801 {status}\uFF09\uFF1A{statusText}",
+  storage_unknownError: "\u672A\u77E5\u9519\u8BEF",
+  storage_saveFileFailed: "\u4FDD\u5B58\u6587\u4EF6\u5931\u8D25",
+  storage_downloadDefaultFilename: "\u4E0B\u8F7D",
+  storage_pathTraversal: "\u68C0\u6D4B\u5230\u8DEF\u5F84\u7A7F\u8D8A\u653B\u51FB",
+  storage_localNotInitialized: "\u672C\u5730\u5B58\u50A8\u672A\u521D\u59CB\u5316",
+  storage_configError: "\u5B58\u50A8\u914D\u7F6E\u6821\u9A8C\u5931\u8D25\uFF1A{error}",
+  storage_metaFileAccess: "\u4E0D\u5141\u8BB8\u76F4\u63A5\u8BBF\u95EE\u5143\u6570\u636E\u6587\u4EF6: {key}"
+};
+
+// src/storage-i18n.ts
+var storageM = core.i18n.createMessageGetter({
+  "zh-CN": zh_CN_default,
+  "en-US": en_US_default
+});
+
+// src/storage-mime.ts
+var MIME_TYPES = {
+  // 图片
+  "jpg": "image/jpeg",
+  "jpeg": "image/jpeg",
+  "png": "image/png",
+  "gif": "image/gif",
+  "webp": "image/webp",
+  "svg": "image/svg+xml",
+  "ico": "image/x-icon",
+  // 文档
+  "pdf": "application/pdf",
+  "doc": "application/msword",
+  "docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  "xls": "application/vnd.ms-excel",
+  "xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  "ppt": "application/vnd.ms-powerpoint",
+  "pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  // 文本
+  "txt": "text/plain",
+  "html": "text/html",
+  "css": "text/css",
+  "js": "text/javascript",
+  "json": "application/json",
+  "xml": "application/xml",
+  "csv": "text/csv",
+  "md": "text/markdown",
+  // 音视频
+  "mp3": "audio/mpeg",
+  "wav": "audio/wav",
+  "mp4": "video/mp4",
+  "webm": "video/webm",
+  "ogg": "audio/ogg",
+  // 压缩包
+  "zip": "application/zip",
+  "rar": "application/x-rar-compressed",
+  "7z": "application/x-7z-compressed",
+  "tar": "application/x-tar",
+  "gz": "application/gzip",
+  // 字体
+  "woff": "font/woff",
+  "woff2": "font/woff2",
+  "ttf": "font/ttf",
+  "otf": "font/otf"
+};
+var MIME_TYPE_DEFAULT = "application/octet-stream";
+
+// src/client/storage-client.ts
+async function uploadWithPresignedUrl(url, data, options = {}) {
+  try {
+    const body = data;
+    if (options.onProgress) {
+      return new Promise((resolve) => {
+        const xhr = new XMLHttpRequest();
+        if (options.abortController) {
+          options.abortController.signal.addEventListener("abort", () => {
+            xhr.abort();
+            resolve({ success: false, error: storageM("storage_uploadCanceled") });
+          });
+        }
+        xhr.upload.addEventListener("progress", (event) => {
+          if (event.lengthComputable && options.onProgress) {
+            options.onProgress({
+              loaded: event.loaded,
+              total: event.total,
+              percent: Math.round(event.loaded / event.total * 100)
+            });
+          }
+        });
+        xhr.addEventListener("load", () => {
+          if (xhr.status >= 200 && xhr.status < 300) {
+            resolve({ success: true });
+          } else {
+            resolve({
+              success: false,
+              error: storageM("storage_uploadFailedStatus", { params: { status: xhr.status, statusText: xhr.statusText } })
+            });
+          }
+        });
+        xhr.addEventListener("error", () => {
+          resolve({ success: false, error: storageM("storage_networkError") });
+        });
+        xhr.open("PUT", url);
+        if (options.contentType) {
+          xhr.setRequestHeader("Content-Type", options.contentType);
+        }
+        xhr.send(body);
+      });
+    }
+    const response = await fetch(url, {
+      method: "PUT",
+      body,
+      headers: options.contentType ? { "Content-Type": options.contentType } : void 0,
+      signal: options.abortController?.signal
+    });
+    if (!response.ok) {
+      return {
+        success: false,
+        error: storageM("storage_uploadFailedStatus", { params: { status: response.status, statusText: response.statusText } })
+      };
+    }
+    return { success: true };
+  } catch (error) {
+    if (error instanceof Error && error.name === "AbortError") {
+      return { success: false, error: storageM("storage_uploadCanceled") };
+    }
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : storageM("storage_unknownError")
+    };
+  }
+}
+async function downloadWithPresignedUrl(url, options = {}) {
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      signal: options.abortController?.signal
+    });
+    if (!response.ok) {
+      return {
+        success: false,
+        error: storageM("storage_downloadFailedStatus", { params: { status: response.status, statusText: response.statusText } })
+      };
+    }
+    const blob = await response.blob();
+    return { success: true, data: blob };
+  } catch (error) {
+    if (error instanceof Error && error.name === "AbortError") {
+      return { success: false, error: storageM("storage_downloadCanceled") };
+    }
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : storageM("storage_unknownError")
+    };
+  }
+}
+async function downloadAndSave(url, options = {}) {
+  const result = await downloadWithPresignedUrl(url, options);
+  if (!result.success || !result.data) {
+    return { success: false, error: result.error };
+  }
+  try {
+    const blobUrl = URL.createObjectURL(result.data);
+    const link = document.createElement("a");
+    link.href = blobUrl;
+    link.download = options.filename || storageM("storage_downloadDefaultFilename");
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(blobUrl);
+    return { success: true };
+  } catch (error) {
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : storageM("storage_saveFileFailed")
+    };
+  }
+}
+function getFileExtension(file) {
+  const name = file.name;
+  const lastDot = name.lastIndexOf(".");
+  return lastDot > -1 ? name.slice(lastDot + 1).toLowerCase() : "";
+}
+function getMimeType(extension) {
+  return MIME_TYPES[extension.toLowerCase()] || MIME_TYPE_DEFAULT;
+}
+function formatFileSize(bytes) {
+  if (bytes === 0)
+    return "0 B";
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  const size = bytes / 1024 ** i;
+  return `${size.toFixed(i > 0 ? 2 : 0)} ${units[i]}`;
+}
+
+export { MIME_TYPES, MIME_TYPE_DEFAULT, downloadAndSave, downloadWithPresignedUrl, formatFileSize, getFileExtension, getMimeType, storageM, uploadWithPresignedUrl };
+//# sourceMappingURL=chunk-U427BQIQ.js.map
+//# sourceMappingURL=chunk-U427BQIQ.js.map

package/dist/chunk-U427BQIQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../messages/en-US.json","../messages/zh-CN.json","../src/storage-i18n.ts","../src/storage-mime.ts","../src/client/storage-client.ts"],"names":[],"mappings":"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","file":"chunk-U427BQIQ.js","sourcesContent":["{\n  \"$schema\": \"https://inlang.com/schema/inlang-message-format\",\n  \"storage_notInitialized\": \"Storage not initialized, please call storage.init() first\",\n  \"storage_bucketNotExist\": \"Bucket does not exist\",\n  \"storage_networkError\": \"Network error\",\n  \"storage_responseBodyEmpty\": \"Response body is empty\",\n  \"storage_presignUrlFailed\": \"Failed to generate presigned URL\",\n  \"storage_presignUploadUrlFailed\": \"Failed to generate presigned upload URL\",\n  \"storage_s3ConfigTypeError\": \"Config type error: S3 provider only supports type=s3\",\n  \"storage_diskSpaceInsufficient\": \"Insufficient disk space\",\n  \"storage_localConfigTypeError\": \"Config type error: Local provider only supports type=local\",\n  \"storage_operationFailed\": \"Operation failed: {error}\",\n  \"storage_unsupportedType\": \"Unsupported storage type: {type}\",\n  \"storage_config_bucketRequired\": \"Bucket is required\",\n  \"storage_config_regionRequired\": \"Region is required\",\n  \"storage_config_accessKeyIdRequired\": \"Access Key ID is required\",\n  \"storage_config_secretAccessKeyRequired\": \"Secret Access Key is required\",\n  \"storage_config_rootRequired\": \"Root path is required\",\n  \"storage_fileNotFound\": \"File not found: {key}\",\n  \"storage_permissionDenied\": \"Permission denied: {key}\",\n  \"storage_pathIsDir\": \"Path is a directory: {key}\",\n  \"storage_ioError\": \"IO error: {error}\",\n  \"storage_deleteManyFailed\": \"Failed to delete {count} files\",\n  \"storage_s3ClientNotInitialized\": \"S3 client not initialized\",\n  \"storage_s3ConfigNotInitialized\": \"S3 config not initialized\",\n  \"storage_uploadCanceled\": \"Upload canceled\",\n  \"storage_downloadCanceled\": \"Download canceled\",\n  \"storage_uploadFailedStatus\": \"Upload failed (status {status}): {statusText}\",\n  \"storage_downloadFailedStatus\": \"Download failed (status {status}): {statusText}\",\n  \"storage_unknownError\": \"Unknown error\",\n  \"storage_saveFileFailed\": \"Failed to save file\",\n  \"storage_downloadDefaultFilename\": \"download\",\n  \"storage_pathTraversal\": \"Path traversal attack detected\",\n  \"storage_localNotInitialized\": \"Local storage not initialized\",\n  \"storage_configError\": \"Storage config validation failed: {error}\",\n  \"storage_metaFileAccess\": \"Direct access to metadata files is not allowed: {key}\"\n}\n","{\n  \"$schema\": \"https://inlang.com/schema/inlang-message-format\",\n  \"storage_notInitialized\": \"存储未初始化，请先调用 storage.init()\",\n  \"storage_bucketNotExist\": \"存储桶不存在\",\n  \"storage_networkError\": \"网络错误\",\n  \"storage_responseBodyEmpty\": \"响应体为空\",\n  \"storage_presignUrlFailed\": \"生成签名 URL 失败\",\n  \"storage_presignUploadUrlFailed\": \"生成上传签名 URL 失败\",\n  \"storage_s3ConfigTypeError\": \"配置类型错误：S3 provider 仅支持 type=s3\",\n  \"storage_diskSpaceInsufficient\": \"磁盘空间不足\",\n  \"storage_localConfigTypeError\": \"配置类型错误：Local provider 仅支持 type=local\",\n  \"storage_operationFailed\": \"操作失败: {error}\",\n  \"storage_unsupportedType\": \"不支持的存储类型：{type}\",\n  \"storage_config_bucketRequired\": \"存储桶不能为空\",\n  \"storage_config_regionRequired\": \"区域不能为空\",\n  \"storage_config_accessKeyIdRequired\": \"Access Key ID 不能为空\",\n  \"storage_config_secretAccessKeyRequired\": \"Secret Access Key 不能为空\",\n  \"storage_config_rootRequired\": \"Root 不能为空\",\n  \"storage_fileNotFound\": \"文件不存在: {key}\",\n  \"storage_permissionDenied\": \"权限不足: {key}\",\n  \"storage_pathIsDir\": \"路径是目录: {key}\",\n  \"storage_ioError\": \"IO 错误: {error}\",\n  \"storage_deleteManyFailed\": \"删除 {count} 个文件失败\",\n  \"storage_s3ClientNotInitialized\": \"S3 客户端未初始化\",\n  \"storage_s3ConfigNotInitialized\": \"S3 配置未初始化\",\n  \"storage_uploadCanceled\": \"上传已取消\",\n  \"storage_downloadCanceled\": \"下载已取消\",\n  \"storage_uploadFailedStatus\": \"上传失败（状态码 {status}）：{statusText}\",\n  \"storage_downloadFailedStatus\": \"下载失败（状态码 {status}）：{statusText}\",\n  \"storage_unknownError\": \"未知错误\",\n  \"storage_saveFileFailed\": \"保存文件失败\",\n  \"storage_downloadDefaultFilename\": \"下载\",\n  \"storage_pathTraversal\": \"检测到路径穿越攻击\",\n  \"storage_localNotInitialized\": \"本地存储未初始化\",\n  \"storage_configError\": \"存储配置校验失败：{error}\",\n  \"storage_metaFileAccess\": \"不允许直接访问元数据文件: {key}\"\n}\n","/**\n * @h-ai/storage — i18n 消息获取器\n *\n * 加载存储模块的中英文翻译文件，提供统一的文案获取函数。\n * 内部使用，不对外导出。\n * @module storage-i18n\n */\n\nimport { core } from '@h-ai/core'\nimport messagesEnUS from '../messages/en-US.json'\nimport messagesZhCN from '../messages/zh-CN.json'\n\n/** 消息键类型（从 zh-CN 翻译文件自动推断） */\ntype StorageMessageKey = keyof typeof messagesZhCN\n\n/**\n * 获取存储模块本地化文案\n *\n * 根据当前 locale 自动选择 zh-CN 或 en-US 的文案，\n * 支持带参数插值（通过 `{ params: { key: value } }`）。\n *\n * @example\n * ```ts\n * storageM('storage_fileNotFound', { params: { key: 'a.txt' } })\n * ```\n */\nexport const storageM = core.i18n.createMessageGetter<StorageMessageKey>({\n  'zh-CN': messagesZhCN,\n  'en-US': messagesEnUS,\n})\n","/**\n * @h-ai/storage — MIME 类型映射\n *\n * 集中维护文件扩展名到 MIME 类型的映射表。 供 local provider 和 client 端共用，避免重复定义。\n * @module storage-mime\n */\n\n/**\n * 文件扩展名 → MIME 类型映射表\n *\n * 键为小写扩展名（不含点号），值为标准 MIME 类型字符串。\n * 未匹配项统一回退到 `application/octet-stream`。\n */\nexport const MIME_TYPES: Record<string, string> = {\n  // 图片\n  'jpg': 'image/jpeg',\n  'jpeg': 'image/jpeg',\n  'png': 'image/png',\n  'gif': 'image/gif',\n  'webp': 'image/webp',\n  'svg': 'image/svg+xml',\n  'ico': 'image/x-icon',\n\n  // 文档\n  'pdf': 'application/pdf',\n  'doc': 'application/msword',\n  'docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  'xls': 'application/vnd.ms-excel',\n  'xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  'ppt': 'application/vnd.ms-powerpoint',\n  'pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n\n  // 文本\n  'txt': 'text/plain',\n  'html': 'text/html',\n  'css': 'text/css',\n  'js': 'text/javascript',\n  'json': 'application/json',\n  'xml': 'application/xml',\n  'csv': 'text/csv',\n  'md': 'text/markdown',\n\n  // 音视频\n  'mp3': 'audio/mpeg',\n  'wav': 'audio/wav',\n  'mp4': 'video/mp4',\n  'webm': 'video/webm',\n  'ogg': 'audio/ogg',\n\n  // 压缩包\n  'zip': 'application/zip',\n  'rar': 'application/x-rar-compressed',\n  '7z': 'application/x-7z-compressed',\n  'tar': 'application/x-tar',\n  'gz': 'application/gzip',\n\n  // 字体\n  'woff': 'font/woff',\n  'woff2': 'font/woff2',\n  'ttf': 'font/ttf',\n  'otf': 'font/otf',\n}\n\n/**\n * MIME 类型默认值（未知扩展名回退）\n */\nexport const MIME_TYPE_DEFAULT = 'application/octet-stream'\n","/**\n * @h-ai/storage — 前端存储客户端\n *\n * 提供前端通过签名 URL 直接上传下载文件的功能。\n * @module storage-client\n */\n\nimport { storageM } from '../storage-i18n.js'\nimport { MIME_TYPE_DEFAULT, MIME_TYPES } from '../storage-mime.js'\n\n// ─── 客户端类型 ───\n\n/**\n * 上传进度回调数据\n *\n * 由 `uploadWithPresignedUrl` 在上传过程中通过 `onProgress` 回调返回。\n */\nexport interface UploadProgress {\n  /** 已上传字节数 */\n  loaded: number\n  /** 总字节数（仅在 lengthComputable 时可靠） */\n  total: number\n  /** 进度百分比 (0–100)，四舍五入到整数 */\n  percent: number\n}\n\n/**\n * 前端上传选项\n *\n * 控制 `uploadWithPresignedUrl` 的行为，包括内容类型、进度监听和取消。\n */\nexport interface ClientUploadOptions {\n  /** 内容类型（设置后会加到请求 Content-Type 头） */\n  contentType?: string\n  /** 进度回调（设置后会使用 XMLHttpRequest；仅 lengthComputable=true 时回调） */\n  onProgress?: (progress: UploadProgress) => void\n  /** AbortController 用于取消上传（abort 后返回 {success: false}） */\n  abortController?: AbortController\n}\n\n/**\n * 前端下载选项\n *\n * 控制 `downloadWithPresignedUrl` / `downloadAndSave` 的行为。\n */\nexport interface ClientDownloadOptions {\n  /** 保存的文件名（仅 downloadAndSave 使用，默认为 'download'） */\n  filename?: string\n  /** AbortController 用于取消下载（abort 后返回 {success: false}） */\n  abortController?: AbortController\n}\n\n// ─── 上传功能 ───\n\n/**\n * 使用签名 URL 上传文件\n *\n * @param url - 后端生成的上传签名 URL\n * @param data - 要上传的数据（File、Blob、ArrayBuffer 或字符串）\n * @param options - 上传选项\n * @returns 上传结果\n *\n * @example\n * ```ts\n * // 获取签名 URL（通常从后端 API 获取）\n * const response = await fetch('/api/storage/presign', {\n *     method: 'POST',\n *     body: JSON.stringify({ key: 'uploads/image.png', contentType: 'image/png' })\n * })\n * const { uploadUrl } = await response.json()\n *\n * // 使用签名 URL 上传\n * const file = document.getElementById('fileInput').files[0]\n * const result = await uploadWithPresignedUrl(uploadUrl, file, {\n *     contentType: 'image/png',\n *     onProgress: (p) => {\n *         // 在此更新进度条：p.percent\n *     }\n * })\n *\n * if (result.success) {\n *     // 上传成功\n * }\n * ```\n */\nexport async function uploadWithPresignedUrl(\n  url: string,\n  data: File | Blob | ArrayBuffer | string,\n  options: ClientUploadOptions = {},\n): Promise<{ success: boolean, error?: string }> {\n  try {\n    // 准备请求体\n    const body: BodyInit = data\n\n    // 使用 XMLHttpRequest 以支持上传进度\n    if (options.onProgress) {\n      return new Promise((resolve) => {\n        const xhr = new XMLHttpRequest()\n\n        // 设置取消控制\n        if (options.abortController) {\n          options.abortController.signal.addEventListener('abort', () => {\n            xhr.abort()\n            resolve({ success: false, error: storageM('storage_uploadCanceled') })\n          })\n        }\n\n        // 监听进度\n        xhr.upload.addEventListener('progress', (event) => {\n          if (event.lengthComputable && options.onProgress) {\n            options.onProgress({\n              loaded: event.loaded,\n              total: event.total,\n              percent: Math.round((event.loaded / event.total) * 100),\n            })\n          }\n        })\n\n        // 监听完成\n        xhr.addEventListener('load', () => {\n          if (xhr.status >= 200 && xhr.status < 300) {\n            resolve({ success: true })\n          }\n          else {\n            resolve({\n              success: false,\n              error: storageM('storage_uploadFailedStatus', { params: { status: xhr.status, statusText: xhr.statusText } }),\n            })\n          }\n        })\n\n        // 监听错误\n        xhr.addEventListener('error', () => {\n          resolve({ success: false, error: storageM('storage_networkError') })\n        })\n\n        // 发送请求\n        xhr.open('PUT', url)\n        if (options.contentType) {\n          xhr.setRequestHeader('Content-Type', options.contentType)\n        }\n        xhr.send(body)\n      })\n    }\n\n    // 不需要进度时使用 fetch\n    const response = await fetch(url, {\n      method: 'PUT',\n      body,\n      headers: options.contentType\n        ? { 'Content-Type': options.contentType }\n        : undefined,\n      signal: options.abortController?.signal,\n    })\n\n    if (!response.ok) {\n      return {\n        success: false,\n        error: storageM('storage_uploadFailedStatus', { params: { status: response.status, statusText: response.statusText } }),\n      }\n    }\n\n    return { success: true }\n  }\n  catch (error) {\n    if (error instanceof Error && error.name === 'AbortError') {\n      return { success: false, error: storageM('storage_uploadCanceled') }\n    }\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : storageM('storage_unknownError'),\n    }\n  }\n}\n\n// ─── 下载功能 ───\n\n/**\n * 使用签名 URL 下载文件\n *\n * @param url - 后端生成的下载签名 URL\n * @param options - 下载选项\n * @returns 下载结果（成功时 data 为 Blob）\n *\n * @example\n * ```ts\n * // 下载为 Blob\n * const result = await downloadWithPresignedUrl(downloadUrl)\n * if (result.success) {\n *     const blob = result.data\n *     // 处理 blob...\n * }\n *\n * // 下载并保存为文件（浏览器环境）\n * await downloadAndSave(downloadUrl, { filename: 'document.pdf' })\n * ```\n */\nexport async function downloadWithPresignedUrl(\n  url: string,\n  options: ClientDownloadOptions = {},\n): Promise<{ success: boolean, data?: Blob, error?: string }> {\n  try {\n    const response = await fetch(url, {\n      method: 'GET',\n      signal: options.abortController?.signal,\n    })\n\n    if (!response.ok) {\n      return {\n        success: false,\n        error: storageM('storage_downloadFailedStatus', { params: { status: response.status, statusText: response.statusText } }),\n      }\n    }\n\n    const blob = await response.blob()\n    return { success: true, data: blob }\n  }\n  catch (error) {\n    if (error instanceof Error && error.name === 'AbortError') {\n      return { success: false, error: storageM('storage_downloadCanceled') }\n    }\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : storageM('storage_unknownError'),\n    }\n  }\n}\n\n/**\n * 下载并保存到本地（浏览器环境）\n *\n * @param url - 下载 URL\n * @param options - 下载选项\n *\n * @example\n * ```ts\n * await downloadAndSave(presignedUrl, {\n *     filename: 'report.pdf'\n * })\n * ```\n */\nexport async function downloadAndSave(\n  url: string,\n  options: ClientDownloadOptions = {},\n): Promise<{ success: boolean, error?: string }> {\n  const result = await downloadWithPresignedUrl(url, options)\n\n  if (!result.success || !result.data) {\n    return { success: false, error: result.error }\n  }\n\n  try {\n    // 创建下载链接\n    const blobUrl = URL.createObjectURL(result.data)\n    const link = document.createElement('a')\n    link.href = blobUrl\n    link.download = options.filename || storageM('storage_downloadDefaultFilename')\n\n    // 触发下载\n    document.body.appendChild(link)\n    link.click()\n    document.body.removeChild(link)\n\n    // 清理 URL\n    URL.revokeObjectURL(blobUrl)\n\n    return { success: true }\n  }\n  catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : storageM('storage_saveFileFailed'),\n    }\n  }\n}\n\n// ─── 辅助功能 ───\n\n/**\n * 从 File 对象获取文件扩展名\n *\n * 取文件名中最后一个 '.' 之后的部分，转为小写。\n * 若文件名无点号或以点号开头且无其他点号，返回空字符串。\n *\n * @param file - 浏览器 File 对象\n * @returns 扩展名（不含点），如 'png'、'tar.gz' 返回 'gz'\n *\n * @example\n * ```ts\n * getFileExtension(new File([], 'photo.PNG'))  // 'png'\n * getFileExtension(new File([], '.gitignore')) // 'gitignore'\n * getFileExtension(new File([], 'noext'))      // ''\n * ```\n */\nexport function getFileExtension(file: File): string {\n  const name = file.name\n  const lastDot = name.lastIndexOf('.')\n  return lastDot > -1 ? name.slice(lastDot + 1).toLowerCase() : ''\n}\n\n/**\n * 根据文件扩展名获取 MIME 类型\n *\n * 内置常见扩展名映射（图片/文档/文本/音视频/压缩包），\n * 未匹配时返回 'application/octet-stream'。\n *\n * @param extension - 文件扩展名（不含点，大小写不敏感）\n * @returns MIME 类型字符串\n *\n * @example\n * ```ts\n * getMimeType('png')  // 'image/png'\n * getMimeType('xyz')  // 'application/octet-stream'\n * ```\n */\nexport function getMimeType(extension: string): string {\n  return MIME_TYPES[extension.toLowerCase()] || MIME_TYPE_DEFAULT\n}\n\n/**\n * 格式化文件大小为人类可读字符串\n *\n * 使用 1024 进制，输出单位为 B/KB/MB/GB/TB。\n * 大于 1 B 时保留 2 位小数。\n *\n * @param bytes - 字节数（非负整数）\n * @returns 格式化后的字符串，如 '0 B'、'1.50 KB'、'2.30 MB'\n *\n * @example\n * ```ts\n * formatFileSize(0)         // '0 B'\n * formatFileSize(1536)      // '1.50 KB'\n * formatFileSize(1048576)   // '1.00 MB'\n * ```\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes === 0)\n    return '0 B'\n\n  const units = ['B', 'KB', 'MB', 'GB', 'TB']\n  const i = Math.floor(Math.log(bytes) / Math.log(1024))\n  const size = bytes / 1024 ** i\n\n  return `${size.toFixed(i > 0 ? 2 : 0)} ${units[i]}`\n}\n"]}

package/dist/client/index.d.ts

@@ -0,0 +1,172 @@
+/**
+ * @h-ai/storage — 前端存储客户端
+ *
+ * 提供前端通过签名 URL 直接上传下载文件的功能。
+ * @module storage-client
+ */
+/**
+ * 上传进度回调数据
+ *
+ * 由 `uploadWithPresignedUrl` 在上传过程中通过 `onProgress` 回调返回。
+ */
+interface UploadProgress {
+    /** 已上传字节数 */
+    loaded: number;
+    /** 总字节数（仅在 lengthComputable 时可靠） */
+    total: number;
+    /** 进度百分比 (0–100)，四舍五入到整数 */
+    percent: number;
+}
+/**
+ * 前端上传选项
+ *
+ * 控制 `uploadWithPresignedUrl` 的行为，包括内容类型、进度监听和取消。
+ */
+interface ClientUploadOptions {
+    /** 内容类型（设置后会加到请求 Content-Type 头） */
+    contentType?: string;
+    /** 进度回调（设置后会使用 XMLHttpRequest；仅 lengthComputable=true 时回调） */
+    onProgress?: (progress: UploadProgress) => void;
+    /** AbortController 用于取消上传（abort 后返回 {success: false}） */
+    abortController?: AbortController;
+}
+/**
+ * 前端下载选项
+ *
+ * 控制 `downloadWithPresignedUrl` / `downloadAndSave` 的行为。
+ */
+interface ClientDownloadOptions {
+    /** 保存的文件名（仅 downloadAndSave 使用，默认为 'download'） */
+    filename?: string;
+    /** AbortController 用于取消下载（abort 后返回 {success: false}） */
+    abortController?: AbortController;
+}
+/**
+ * 使用签名 URL 上传文件
+ *
+ * @param url - 后端生成的上传签名 URL
+ * @param data - 要上传的数据（File、Blob、ArrayBuffer 或字符串）
+ * @param options - 上传选项
+ * @returns 上传结果
+ *
+ * @example
+ * ```ts
+ * // 获取签名 URL（通常从后端 API 获取）
+ * const response = await fetch('/api/storage/presign', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ key: 'uploads/image.png', contentType: 'image/png' })
+ * })
+ * const { uploadUrl } = await response.json()
+ *
+ * // 使用签名 URL 上传
+ * const file = document.getElementById('fileInput').files[0]
+ * const result = await uploadWithPresignedUrl(uploadUrl, file, {
+ *     contentType: 'image/png',
+ *     onProgress: (p) => {
+ *         // 在此更新进度条：p.percent
+ *     }
+ * })
+ *
+ * if (result.success) {
+ *     // 上传成功
+ * }
+ * ```
+ */
+declare function uploadWithPresignedUrl(url: string, data: File | Blob | ArrayBuffer | string, options?: ClientUploadOptions): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * 使用签名 URL 下载文件
+ *
+ * @param url - 后端生成的下载签名 URL
+ * @param options - 下载选项
+ * @returns 下载结果（成功时 data 为 Blob）
+ *
+ * @example
+ * ```ts
+ * // 下载为 Blob
+ * const result = await downloadWithPresignedUrl(downloadUrl)
+ * if (result.success) {
+ *     const blob = result.data
+ *     // 处理 blob...
+ * }
+ *
+ * // 下载并保存为文件（浏览器环境）
+ * await downloadAndSave(downloadUrl, { filename: 'document.pdf' })
+ * ```
+ */
+declare function downloadWithPresignedUrl(url: string, options?: ClientDownloadOptions): Promise<{
+    success: boolean;
+    data?: Blob;
+    error?: string;
+}>;
+/**
+ * 下载并保存到本地（浏览器环境）
+ *
+ * @param url - 下载 URL
+ * @param options - 下载选项
+ *
+ * @example
+ * ```ts
+ * await downloadAndSave(presignedUrl, {
+ *     filename: 'report.pdf'
+ * })
+ * ```
+ */
+declare function downloadAndSave(url: string, options?: ClientDownloadOptions): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * 从 File 对象获取文件扩展名
+ *
+ * 取文件名中最后一个 '.' 之后的部分，转为小写。
+ * 若文件名无点号或以点号开头且无其他点号，返回空字符串。
+ *
+ * @param file - 浏览器 File 对象
+ * @returns 扩展名（不含点），如 'png'、'tar.gz' 返回 'gz'
+ *
+ * @example
+ * ```ts
+ * getFileExtension(new File([], 'photo.PNG'))  // 'png'
+ * getFileExtension(new File([], '.gitignore')) // 'gitignore'
+ * getFileExtension(new File([], 'noext'))      // ''
+ * ```
+ */
+declare function getFileExtension(file: File): string;
+/**
+ * 根据文件扩展名获取 MIME 类型
+ *
+ * 内置常见扩展名映射（图片/文档/文本/音视频/压缩包），
+ * 未匹配时返回 'application/octet-stream'。
+ *
+ * @param extension - 文件扩展名（不含点，大小写不敏感）
+ * @returns MIME 类型字符串
+ *
+ * @example
+ * ```ts
+ * getMimeType('png')  // 'image/png'
+ * getMimeType('xyz')  // 'application/octet-stream'
+ * ```
+ */
+declare function getMimeType(extension: string): string;
+/**
+ * 格式化文件大小为人类可读字符串
+ *
+ * 使用 1024 进制，输出单位为 B/KB/MB/GB/TB。
+ * 大于 1 B 时保留 2 位小数。
+ *
+ * @param bytes - 字节数（非负整数）
+ * @returns 格式化后的字符串，如 '0 B'、'1.50 KB'、'2.30 MB'
+ *
+ * @example
+ * ```ts
+ * formatFileSize(0)         // '0 B'
+ * formatFileSize(1536)      // '1.50 KB'
+ * formatFileSize(1048576)   // '1.00 MB'
+ * ```
+ */
+declare function formatFileSize(bytes: number): string;
+
+export { type ClientDownloadOptions, type ClientUploadOptions, type UploadProgress, downloadAndSave, downloadWithPresignedUrl, formatFileSize, getFileExtension, getMimeType, uploadWithPresignedUrl };

package/dist/client/index.js

@@ -0,0 +1,3 @@
+export { downloadAndSave, downloadWithPresignedUrl, formatFileSize, getFileExtension, getMimeType, uploadWithPresignedUrl } from '../chunk-U427BQIQ.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/node.d.ts

@@ -0,0 +1,37 @@
+export { ClientDownloadOptions, ClientUploadOptions, UploadProgress, downloadAndSave, downloadWithPresignedUrl, formatFileSize, getFileExtension, getMimeType, uploadWithPresignedUrl } from './client/index.js';
+import { StorageFunctions } from './browser.js';
+export { CopyOptions, DirOperations, DownloadOptions, FileMetadata, FileOperations, HaiStorageError, ListOptions, ListResult, LocalConfig, LocalConfigSchema, PresignOperations, PresignOptions, PresignOptionsSchema, PresignUploadOptions, PresignUploadOptionsSchema, S3Config, S3ConfigSchema, StorageConfig, StorageConfigInput, StorageConfigSchema, StorageProvider, StorageType, StorageTypeSchema, UploadOptions } from './browser.js';
+import 'zod';
+import '@h-ai/core';
+import 'node:buffer';
+
+/**
+ * @h-ai/storage — 存储服务主入口
+ *
+ * 提供统一的 `storage` 对象，管理运行时状态与生命周期。
+ * @module storage-main
+ */
+
+/**
+ * 存储服务单例
+ *
+ * 使用前必须先调用 `storage.init()` 初始化，传入 S3 或本地存储配置。
+ * 初始化后通过 `storage.file`、`storage.dir`、`storage.presign` 访问各操作接口。
+ *
+ * @example
+ * ```ts
+ * import { storage } from '@h-ai/storage'
+ *
+ * // 初始化
+ * await storage.init({ type: 'local', root: '/data/uploads' })
+ *
+ * // 上传文件
+ * await storage.file.put('hello.txt', 'Hello World')
+ *
+ * // 关闭连接
+ * await storage.close()
+ * ```
+ */
+declare const storage: StorageFunctions;
+
+export { StorageFunctions, storage };