@minto-ai/tools 1.0.668 → 1.0.670

package/README.md

@@ -805,6 +805,64 @@ 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。
+
+### `getAbsoluteUrl`
+
+> `function getAbsoluteUrl(rawUrl: string): string`
+
+将任意格式的 URL 路径规范化为完整的绝对 URL 地址。
+
+#### 参数
+
+- `rawUrl (string)`: 待规范化的原始 URL 路径，支持空值、相对路径、绝对路径等格式。
+
+#### 返回
+
+`(string)`: 规范化后的绝对 URL 字符串，空输入返回空字符串。
+
+#### 例子
+
+```typescript
+import { getAbsoluteUrl } from '@minto-ai/tools'
+
+// 假设当前页面 URL 为 https://example.com/page
+
+getAbsoluteUrl('/api/data') // 'https://example.com/api/data'
+getAbsoluteUrl('https://other.com/api') // 'https://other.com/api'
+getAbsoluteUrl('') // ''
+```
+
 ## 工具
 
 ### `getUuid`
@@ -866,6 +924,7 @@ await timeDelay(300)
 | `PPTX`   | `pptx` | PowerPoint 演示文稿 (XML 格式) |
 | `XLS`    | `xls`  | Excel 工作簿                   |
 | `XLSX`   | `xlsx` | Excel 工作簿 (XML 格式)        |
+| `JSON`   | `json` | JSON 数据文件                  |
 | `JPG`    | `jpg`  | JPEG 图像                      |
 | `PNG`    | `png`  | PNG 图像                       |
 | `JPEG`   | `jpeg` | JPEG 图像 (另一种扩展名)       |
@@ -923,6 +982,7 @@ await timeDelay(300)
 | `TXT`    | `txt`  | 文本文件                       |
 | `XLS`    | `xls`  | Excel 工作簿                   |
 | `XLSX`   | `xlsx` | Excel 工作簿 (XML 格式)        |
+| `JSON`   | `json` | JSON 数据文件                  |
 
 #### `MusicFileSuffixEnum`
 

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/extends/enum.d.ts

@@ -21,6 +21,7 @@ declare const FileSuffixEnum: {
     readonly MP3: "mp3";
     readonly WAV: "wav";
     readonly TXT: "txt";
+    readonly JSON: "json";
     readonly ZIP: "zip";
     readonly RAR: "rar";
     readonly HTML: "html";
@@ -61,6 +62,7 @@ declare const DocumentFileSuffixEnum: {
     readonly TXT: "txt";
     readonly XLS: "xls";
     readonly XLSX: "xlsx";
+    readonly JSON: "json";
 };
 /**
  * 音乐文件后缀类型枚举

package/dist/file/is-document-file-path.d.ts

@@ -1,5 +1,5 @@
 /**
- * 判断是否是有效的文档文件路径（包含doc、docx、pdf、txt、xls、xlsx）。
+ * 判断是否是有效的文档文件路径（包含doc、docx、pdf、txt、xls、xlsx、json）。
  *
  * @param filePath 文件路径。
  * @returns  是否是有效的文档文件路径。

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);
@@ -13837,6 +13968,7 @@ var FileSuffixEnum = {
   MP3: "mp3",
   WAV: "wav",
   TXT: "txt",
+  JSON: "json",
   ZIP: "zip",
   RAR: "rar",
   HTML: "html"
@@ -13864,7 +13996,8 @@ var DocumentFileSuffixEnum = {
   PDF: FileSuffixEnum.PDF,
   TXT: FileSuffixEnum.TXT,
   XLS: FileSuffixEnum.XLS,
-  XLSX: FileSuffixEnum.XLSX
+  XLSX: FileSuffixEnum.XLSX,
+  JSON: FileSuffixEnum.JSON
 };
 var MusicFileSuffixEnum = {
   MP3: FileSuffixEnum.MP3,
@@ -16797,6 +16930,8 @@ export {
   deepFreeze,
   index as default,
   divide2 as divide,
+  getAbsoluteUrl,
+  getBrowserFingerprint,
   getDecimalPlaces,
   getFileIcon,
   getFileName,

package/package.json

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