@minto-ai/tools 1.0.667 → 1.0.669

package/README.md

@@ -805,6 +805,38 @@ await audioPermission.requestPlaybackPermission()
 await audioPermission.requestMicrophonePermission()
 ```
 
+### `getBrowserFingerprint`
+
+> `function getBrowserFingerprint(): string`
+
+生成匿名浏览器指纹，用于区分浏览器匿名用户的唯一 ID。通过收集浏览器环境特征（如 UserAgent、语言、屏幕分辨率、色深、时区、硬件并发、平台，以及 Canvas 渲染指纹等），并使用 MurmurHash3（32 位）生成稳定的十六进制字符串。
+
+#### 参数
+
+- 无
+
+#### 返回
+
+`(string)`: 浏览器指纹 ID（十六进制字符串）。在非浏览器环境（如 Node/SSR）返回空字符串 `''`。
+
+#### 例子
+
+```typescript
+import { getBrowserFingerprint } from '@minto-ai/tools'
+
+// 生成匿名用户唯一ID
+const fingerprint = getBrowserFingerprint()
+console.log(fingerprint) //  例如：'a1b2c3d4'
+
+// 建议：结合本地存储缓存以保持一致性
+localStorage.setItem('anonymous_id', fingerprint)
+```
+
+#### 注意事项
+
+- 指纹可能随浏览器升级、系统变更或渲染差异而变化，适合作为匿名用户的临时唯一标识，不建议用于强身份识别。
+- 隐私增强模式或跨平台差异可能禁用部分特征（如 deviceMemory、Canvas），函数会自动兼容并尽可能生成可辨识的 ID。
+
 ## 工具
 
 ### `getUuid`

package/dist/browser/get-absolute-url.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 将任意格式的 URL 路径规范化为完整的绝对 URL 地址
+ * @param rawUrl - 待规范化的原始 URL 路径，支持空值、相对路径、绝对路径等格式
+ * @returns 规范化后的绝对 URL 字符串，空输入返回空字符串
+ */
+declare function getAbsoluteUrl(rawUrl: string): string;
+export default getAbsoluteUrl;

package/dist/browser/get-browser-fingerprint.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 获取浏览器唯一指纹 ID
+ * 通过收集浏览器特征（UserAgent, Screen, Language, Timezone, Canvas 等）生成哈希值
+ * 注意：此方法生成的 ID 在浏览器环境变化（如升级、窗口大小改变如果包含了窗口大小）时可能会变化，
+ * 但作为匿名用户的临时唯一标识通常足够。
+ *
+ * @returns 浏览器指纹 ID 字符串
+ */
+export declare function getBrowserFingerprint(): string;
+export default getBrowserFingerprint;

package/dist/browser/index.d.ts

@@ -1,7 +1,9 @@
 import { default as copyText } from './copy-text';
 import { default as createAudioPermission } from './create-audio-permission';
+import { default as getAbsoluteUrl } from './get-absolute-url';
+import { default as getBrowserFingerprint } from './get-browser-fingerprint';
 import { default as isAndroid } from './is-android';
 import { default as isIos } from './is-ios';
 import { default as isMobile } from './is-mobile';
 import { default as isPc } from './is-pc';
-export { copyText, createAudioPermission, isAndroid, isIos, isMobile, isPc };
+export { copyText, createAudioPermission, getAbsoluteUrl, getBrowserFingerprint, isAndroid, isIos, isMobile, isPc, };

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

@@ -13754,6 +13754,137 @@ function createAudioPermission() {
   }
   return audioPermissionInstance;
 }
+function getAbsoluteUrl(rawUrl) {
+  if (!rawUrl) {
+    return "";
+  }
+  try {
+    var absoluteUrl = new URL(rawUrl).toString();
+    return absoluteUrl;
+  } catch (_unused) {
+    try {
+      var currentPageUrl = window.location.href;
+      var _absoluteUrl = new URL(rawUrl, currentPageUrl).toString();
+      return _absoluteUrl;
+    } catch (_unused2) {
+      var siteOrigin = window.location.origin;
+      var normalizedPath = rawUrl.startsWith("/") ? rawUrl : "/".concat(rawUrl);
+      var _absoluteUrl2 = "".concat(siteOrigin).concat(normalizedPath).replace(/\/+/g, "/");
+      return _absoluteUrl2;
+    }
+  }
+}
+function murmurHash332Gc(key) {
+  var seed = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : 0;
+  var k1;
+  var h1;
+  var remainder = key.length & 3;
+  var bytes = key.length - remainder;
+  h1 = seed;
+  var c1 = 3432918353;
+  var c2 = 461845907;
+  var i = 0;
+  while (i < bytes) {
+    k1 = key.charCodeAt(i) & 255 | (key.charCodeAt(++i) & 255) << 8 | (key.charCodeAt(++i) & 255) << 16 | (key.charCodeAt(++i) & 255) << 24;
+    ++i;
+    k1 = (k1 & 65535) * c1 + (((k1 >>> 16) * c1 & 65535) << 16) & 4294967295;
+    k1 = k1 << 15 | k1 >>> 17;
+    k1 = (k1 & 65535) * c2 + (((k1 >>> 16) * c2 & 65535) << 16) & 4294967295;
+    h1 ^= k1;
+    h1 = h1 << 13 | h1 >>> 19;
+    var h1b = (h1 & 65535) * 5 + (((h1 >>> 16) * 5 & 65535) << 16) & 4294967295;
+    h1 = (h1b & 65535) + 27492 + (((h1b >>> 16) + 58964 & 65535) << 16);
+  }
+  k1 = 0;
+  if (remainder >= 3) {
+    k1 ^= (key.charCodeAt(i + 2) & 255) << 16;
+  }
+  if (remainder >= 2) {
+    k1 ^= (key.charCodeAt(i + 1) & 255) << 8;
+  }
+  if (remainder >= 1) {
+    k1 ^= key.charCodeAt(i) & 255;
+    k1 = (k1 & 65535) * c1 + (((k1 >>> 16) * c1 & 65535) << 16) & 4294967295;
+    k1 = k1 << 15 | k1 >>> 17;
+    k1 = (k1 & 65535) * c2 + (((k1 >>> 16) * c2 & 65535) << 16) & 4294967295;
+    h1 ^= k1;
+  }
+  h1 ^= key.length;
+  h1 ^= h1 >>> 16;
+  h1 = (h1 & 65535) * 2246822507 + (((h1 >>> 16) * 2246822507 & 65535) << 16) & 4294967295;
+  h1 ^= h1 >>> 13;
+  h1 = (h1 & 65535) * 3266489909 + (((h1 >>> 16) * 3266489909 & 65535) << 16) & 4294967295;
+  h1 ^= h1 >>> 16;
+  return h1 >>> 0;
+}
+function getCanvasFingerprint() {
+  try {
+    var canvas = document.createElement("canvas");
+    var ctx = canvas.getContext("2d");
+    if (!ctx) {
+      return "";
+    }
+    canvas.width = 200;
+    canvas.height = 50;
+    ctx.textBaseline = "top";
+    ctx.font = "14px Arial";
+    ctx.fillStyle = "#f60";
+    ctx.fillRect(125, 1, 62, 20);
+    ctx.fillStyle = "#069";
+    ctx.fillText("Hello, world!", 2, 15);
+    ctx.fillStyle = "rgba(102, 204, 0, 0.7)";
+    ctx.fillText("Hello, world!", 4, 17);
+    ctx.globalCompositeOperation = "multiply";
+    ctx.fillStyle = "rgb(255,0,255)";
+    ctx.beginPath();
+    ctx.arc(50, 50, 50, 0, Math.PI * 2, true);
+    ctx.closePath();
+    ctx.fill();
+    ctx.fillStyle = "rgb(0,255,255)";
+    ctx.beginPath();
+    ctx.arc(100, 50, 50, 0, Math.PI * 2, true);
+    ctx.closePath();
+    ctx.fill();
+    ctx.fillStyle = "rgb(255,255,0)";
+    ctx.beginPath();
+    ctx.arc(75, 100, 50, 0, Math.PI * 2, true);
+    ctx.closePath();
+    ctx.fill();
+    ctx.fillStyle = "rgb(255,0,255)";
+    ctx.arc(75, 75, 75, 0, Math.PI * 2, true);
+    ctx.arc(75, 75, 25, 0, Math.PI * 2, true);
+    ctx.fill("evenodd");
+    return canvas.toDataURL();
+  } catch (_unused) {
+    return "";
+  }
+}
+function getBrowserFingerprint() {
+  if (typeof window === "undefined") {
+    return "";
+  }
+  var _window = window, navigator2 = _window.navigator, screen = _window.screen;
+  var components = [];
+  components.push(navigator2.userAgent);
+  components.push(navigator2.language);
+  components.push("".concat(screen.width, "x").concat(screen.height));
+  components.push("".concat(screen.colorDepth));
+  components.push("".concat((/* @__PURE__ */ new Date()).getTimezoneOffset()));
+  if (navigator2.hardwareConcurrency) {
+    components.push("".concat(navigator2.hardwareConcurrency));
+  }
+  if (navigator2.deviceMemory) {
+    components.push("".concat(navigator2.deviceMemory));
+  }
+  if (navigator2.platform) {
+    components.push(navigator2.platform);
+  }
+  var canvasFingerprint = getCanvasFingerprint();
+  components.push(canvasFingerprint);
+  var fingerprintString = components.join("###");
+  var hash = murmurHash332Gc(fingerprintString);
+  return hash.toString(16);
+}
 function isAndroid() {
   var userAgent2 = navigator.userAgent.toLowerCase();
   return /android/.test(userAgent2);
@@ -14125,33 +14256,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;
           }
-          filePath = updateFilePathQuery(filePath, {
+          throw new Error("下载失败：Base64 数据必须提供文件名");
+        case 1:
+          base64Url = source;
+          if (!source.startsWith("data:")) {
+            base64Url = "data:application/octet-stream;base64,".concat(source);
+          }
+          _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 +16863,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);
 }
@@ -16720,6 +16928,8 @@ export {
   deepFreeze,
   index as default,
   divide2 as divide,
+  getAbsoluteUrl,
+  getBrowserFingerprint,
   getDecimalPlaces,
   getFileIcon,
   getFileName,
@@ -16747,6 +16957,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.667",
+  "version": "1.0.669",
   "description": "明途公共工具库",
   "author": "hcc",
   "license": "ISC",