@minto-ai/tools 1.0.666 → 1.0.668

package/dist/file/single-download-file.d.ts

@@ -1,9 +1,12 @@
 /**
- * 下载单个文件。该函数通过指定的文件路径下载文件，并允许自定义下载文件的名称。
+ * 单文件下载
+ * @param source 下载源，支持 Base64 字符串或 URL
+ * @param fileName 下载文件名
+ * - 当 source 为 Base64 字符串时，必须提供文件名
+ * - 当 source 为 URL 且为文件路径时，若未提供文件名，则默认使用 URL 路径中的文件名
+ * - 当 source 为 URL 且不为文件路径时，传入的文件名参数无效，将使用服务器响应头中的文件名
  *
- * @param filePath 文件路径。
- * @param fileName 下载时保存的文件名（可选）。如果未提供，将自动从 第一个参数`filePath` 提取文件名。
- * @returns 返回一个 Promise，在文件下载完成后。
+ * @returns Promise<void> 下载完成后解析的 Promise
  */
-declare function singleDownloadFile(filePath: string, fileName?: string): Promise<void>;
+declare function singleDownloadFile(source: string, fileName?: string): Promise<void>;
 export default singleDownloadFile;

package/dist/index.js

@@ -14125,33 +14125,117 @@ function isVideoFilePath(filePath) {
   var fileSuffix = getFileSuffix(filePath);
   return Object.values(VideoFileSuffixEnum).includes(fileSuffix);
 }
+var DATA_URI_PREFIX = "data:";
+var BASE64_MARKER = ";base64,";
+var BASE64_REGEX = /^[A-Z0-9+/]+={0,2}$/i;
+function isValidBase64(value) {
+  if (!isString$1(value)) {
+    return false;
+  }
+  var str = value.trim();
+  if (!str) {
+    return false;
+  }
+  if (str.startsWith(DATA_URI_PREFIX)) {
+    var markerIndex = str.indexOf(BASE64_MARKER);
+    if (markerIndex === -1) {
+      return false;
+    }
+    str = str.slice(markerIndex + BASE64_MARKER.length);
+  }
+  var content = str.replace(/\s+/g, "");
+  if (content.length % 4 !== 0) {
+    return false;
+  }
+  return BASE64_REGEX.test(content);
+}
+var URL_REGEX = /^https?:\/\/(?:[\w-]+:[\w-]+@)?(?:localhost|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}|(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d))(?::\d{1,5})?(?:\/[^\s?#]*)?(?:\?[^\s#]*)?(?:#\S*)?$/i;
+function isValidUrl(value) {
+  if (!isString$1(value)) {
+    return false;
+  }
+  return URL_REGEX.test(value.trim());
+}
 function singleDownloadFile(_x, _x2) {
   return _singleDownloadFile.apply(this, arguments);
 }
 function _singleDownloadFile() {
-  _singleDownloadFile = _asyncToGenerator(/* @__PURE__ */ _regenerator().m(function _callee(filePath, fileName) {
-    var _yield$axios$get, data2;
+  _singleDownloadFile = _asyncToGenerator(/* @__PURE__ */ _regenerator().m(function _callee(source, fileName) {
+    var base64Url, response, blob, downloadName, requestUrl, _response, link2, _t, _t2;
     return _regenerator().w(function(_context) {
-      while (1) switch (_context.n) {
+      while (1) switch (_context.p = _context.n) {
         case 0:
-          if (!fileName) {
-            fileName = getFileName(filePath);
+          if (!isValidBase64(source)) {
+            _context.n = 6;
+            break;
+          }
+          if (fileName) {
+            _context.n = 1;
+            break;
+          }
+          throw new Error("下载失败：Base64 数据必须提供文件名");
+        case 1:
+          base64Url = source;
+          if (!source.startsWith("data:")) {
+            base64Url = "data:application/octet-stream;base64,".concat(source);
           }
-          filePath = updateFilePathQuery(filePath, {
+          _context.p = 2;
+          _context.n = 3;
+          return fetch(base64Url);
+        case 3:
+          response = _context.v;
+          _context.n = 4;
+          return response.blob();
+        case 4:
+          blob = _context.v;
+          FileSaver.saveAs(blob, fileName);
+          return _context.a(2);
+        case 5:
+          _context.p = 5;
+          _t = _context.v;
+          console.error("Base64 下载失败：", _t);
+          throw _t;
+        case 6:
+          if (!isValidUrl(source)) {
+            _context.n = 11;
+            break;
+          }
+          if (!isFilePath(source)) {
+            _context.n = 10;
+            break;
+          }
+          downloadName = fileName || getFileName(source) || "download";
+          requestUrl = updateFilePathQuery(source, {
             "response-content-type": "application/octet-stream"
           });
-          _context.n = 1;
-          return axios.get(filePath, {
+          _context.p = 7;
+          _context.n = 8;
+          return axios.get(requestUrl, {
             responseType: "blob"
           });
-        case 1:
-          _yield$axios$get = _context.v;
-          data2 = _yield$axios$get.data;
-          FileSaver.saveAs(data2, fileName);
-        case 2:
+        case 8:
+          _response = _context.v;
+          FileSaver.saveAs(_response.data, downloadName);
+          return _context.a(2);
+        case 9:
+          _context.p = 9;
+          _t2 = _context.v;
+          console.error("文件资源下载失败：", _t2);
+          throw _t2;
+        case 10:
+          link2 = document.createElement("a");
+          link2.href = source;
+          link2.style.display = "none";
+          document.body.appendChild(link2);
+          link2.click();
+          document.body.removeChild(link2);
+          return _context.a(2);
+        case 11:
+          throw new Error("下载失败：无效的下载源 (非有效 Base64 或 URL)");
+        case 12:
           return _context.a(2);
       }
-    }, _callee);
+    }, _callee, null, [[7, 9], [2, 5]]);
   }));
   return _singleDownloadFile.apply(this, arguments);
 }
@@ -16648,13 +16732,6 @@ function useTheme() {
     toggleTheme
   };
 }
-function isValidUrl(url) {
-  if (!isString$1(url)) {
-    return false;
-  }
-  var urlPattern = /^https?:\/\/(?:[\w-]+:[\w-]+@)?(?:localhost|(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}|(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d))(?::\d{1,5})?(?:\/[^\s?#]*)?(?:\?[^\s#]*)?(?:#\S*)?$/i;
-  return urlPattern.test(url.trim());
-}
 function createWebSocket(url) {
   return new WebSocket(url);
 }
@@ -16747,6 +16824,7 @@ export {
   isPptFilePath,
   isString$1 as isString,
   isUndefined,
+  isValidBase64,
   isValidUrl,
   isVideoFilePath,
   isWebSocketSupported,

package/dist/validator/index.d.ts

@@ -1,2 +1,3 @@
+import { isValidBase64 } from './is-valid-base64';
 import { default as isValidUrl } from './is-valid-url';
-export { isValidUrl, };
+export { isValidBase64, isValidUrl, };

package/dist/validator/is-valid-base64.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 校验是否为有效的 Base64 字符串
+ * @param value 待校验的字符串
+ * @returns 是否为有效的 Base64 字符串
+ */
+export declare function isValidBase64(value: string): boolean;

package/dist/validator/is-valid-url.d.ts

@@ -1,7 +1,7 @@
 /**
- * 检查给定的URL是否符合标准网页地址格式。
- * @param url - 需要验证的URL字符串。
- * @returns 如果URL格式合格，返回true；否则返回false。
+ * 检查给定的字符串是否符合标准网页地址格式。
+ * @param value - 需要验证的字符串。
+ * @returns 如果字符串格式合格，返回true；否则返回false。
  */
-export declare function isValidUrl(url: string): boolean;
+export declare function isValidUrl(value: string): boolean;
 export default isValidUrl;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@minto-ai/tools",
   "type": "module",
-  "version": "1.0.666",
+  "version": "1.0.668",
   "description": "明途公共工具库",
   "author": "hcc",
   "license": "ISC",