@tengence/track-sdk-web 1.1.14 → 1.2.1

package/dist/utils/helper.d.ts

@@ -44,14 +44,21 @@ export declare const whenReady: (callback: () => void) => void;
  * 格式化并保留两位小数，若值无效则返回 null
  */
 export declare function safeFixed(v: number | undefined): number | null;
+/**
+ * 生成指定字节数的随机 hex 串（2*bytes 个 hex 字符）。
+ * 随机源使用 Web Crypto crypto.getRandomValues（CSPRNG，HTTPS/HTTP 均可用），
+ * 仅当 Web Crypto 完全不可用时退化为 Math.random（理论极罕见，非安全上下文兜底）。
+ * 用于 trace_id / span_id 等 W3C Trace Context 标识。
+ */
 export declare function getIdGenerator(bytes: number): () => string;
 export declare function generateTraceId(): string;
 export declare function generateSpanId(): string;
 /**
- * 生成全局唯一 ID（RFC 4122 v4）
- * 优先使用浏览器原生 crypto.randomUUID()（主流方式，现代浏览器全覆盖），
- * 在不支持或非安全上下文（非 HTTPS）时回退到 32 位 hex 随机串。
- * 用于 event_id / device_id 等需要唯一标识的场景。
+ * 生成无横杠 32 位 hex 的 UUID v4（128bit，CSPRNG，RFC 4122 v4 语义）。
+ * 主路径用 crypto.getRandomValues 直接构造（版本位/变体位正确），
+ * 输出统一去掉横杠 —— 复制分享友好、存储紧凑、URL 无需转义，
+ * 与 collect 服务端兜底 device_id（32hex）形式一致。
+ * 用于 event_id / device_id / session_id 等需要唯一标识的场景。
  */
 export declare function generateId(): string;
 export declare const getErrorKey: (event: ErrorEvent | Event) => "resource" | "cors" | "js";

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@tengence/track-sdk-web",
-  "version": "1.1.14",
+  "version": "1.2.1",
   "description": "tengence web client track sdk",
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
-  "unpkg": "dist/tengence-track-sdk@1.1.14.js",
+  "unpkg": "dist/tengence-track-sdk@1.1.17.js",
   "exports": {
     ".": {
       "import": {
@@ -54,4 +54,4 @@
   "engines": {
     "node": "20"
   }
-}
+}