@tengence/track-sdk-web 1.1.3 → 1.1.14

package/dist/utils/helper.d.ts

@@ -47,8 +47,22 @@ export declare function safeFixed(v: number | undefined): number | null;
 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 等需要唯一标识的场景。
+ */
+export declare function generateId(): string;
 export declare const getErrorKey: (event: ErrorEvent | Event) => "resource" | "cors" | "js";
 export declare const getErrorUuid: (str: string) => string;
 export declare const isChromeExtensionError: (event: ErrorEvent) => boolean;
 export declare function shouldSample(probability: number): boolean;
 export declare function isVisible(element: Element): boolean;
+/**
+ * 浏览器全局隐私控制信号（GPC，Global Privacy Control）：
+ * 用户在浏览器层选择"不出售/不分享我的数据"时，navigator.globalPrivacyControl === true；
+ * 不支持或未开启时为 undefined/false → 返回 false。读取零成本（单布尔），
+ * init 时读取一次 + 每次 report 前复查（浏览器无 GPC 变化事件）。
+ */
+export declare function isGpcActive(): boolean;

package/dist/utils/logger.d.ts

@@ -1,7 +1,7 @@
 import { ReportData } from "@/interface";
 /**
  * 彩色打印埋点数据
- * @param method 上报方式 (SendBeacon | XHR)
+ * @param method 上报方式（Fetch / XHR / RealTimeFetch 等）
  * @param data 上报数据数组
  */
-export declare const logTrackData: (method: 'SendBeacon' | 'XHR', data: ReportData[]) => void;
+export declare const logTrackData: (method: string, data: ReportData[]) => void;

package/dist/utils/md5.d.ts

@@ -5,6 +5,8 @@ interface HasherState {
     state: number[];
 }
 export declare class Md5 {
+    private static selfTested;
+    private static selfTest;
     /**
      * Hash a UTF-8 string on the spot
      * @param str String to hash

package/dist/utils/request.d.ts

@@ -1,24 +1,40 @@
 type RequestMethod = "GET" | "POST";
+/**
+ * 鉴权错误（401/403），供上层识别并触发 token 刷新
+ */
+export declare class AuthError extends Error {
+    status: number;
+    constructor(status: number, message?: string);
+}
 interface AjaxOptions {
     method: RequestMethod;
     url: string;
     data?: any;
     headers?: Record<string, string>;
     withCredentials?: boolean;
+    timeoutMs?: number;
 }
 /**
- * 是否支持sendBeacon
+ * ajax请求（XHR，作为 fetch 不可用时的回退）
+ * @param {AjaxOptions} params 请求配置
  */
-export declare const isSupportBeacon = true;
+export declare const ajax: <T>({ method, url, data, headers, withCredentials, timeoutMs, }: AjaxOptions) => Promise<T>;
 /**
- * ajax请求
- * @param {AjaxOptions} params 请求配置
+ * 无鉴权 JSON POST（供 SDK 内部换取 accessToken 使用，不携带 Authorization 头）
+ * 与 postJsonWithAuth 相同的 fetch 优先、网络失败回退 XHR 策略。
+ * HTTP 状态错误（服务端已响应）直接抛出，不回退 XHR。
+ * @param url 请求地址（鉴权地址）
+ * @param payload 请求体（如 {"module":"track"}）
+ * @param timeoutMs 请求超时（毫秒，G2；默认 10s 由调用方传 options.requestTimeout）
  */
-export declare const ajax: <T>({ method, url, data, headers, withCredentials, }: AjaxOptions) => Promise<T>;
+export declare const postJson: <T>(url: string, payload: any, timeoutMs?: number) => Promise<T>;
 /**
- * sendBeacon请求
- * @param {string} url 接口地址
- * @param {BodyInit | null} data 请求数据
+ * 带 Bearer 鉴权的 JSON POST：优先 fetch keepalive，不支持/网络失败时回退 XHR。
+ * 彻底弃用 sendBeacon（无法携带 Authorization 头）。
+ * @param url 上报地址
+ * @param payload 上报数据
+ * @param credential accessToken 或 apiKey（作为 Bearer）
+ * @param timeoutMs 请求超时（毫秒，G2）；0/undefined 不设超时（页面卸载补发路径）
  */
-export declare const sendBeacon: (url: string, data?: BodyInit | null) => boolean;
+export declare const postJsonWithAuth: <T>(url: string, payload: any, credential?: string, timeoutMs?: number) => Promise<T>;
 export {};

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@tengence/track-sdk-web",
-  "version": "1.1.3",
+  "version": "1.1.14",
   "description": "tengence web client track sdk",
   "main": "dist/index.mjs",
   "module": "dist/index.mjs",
+  "unpkg": "dist/tengence-track-sdk@1.1.14.js",
   "exports": {
     ".": {
       "import": {
@@ -14,13 +15,22 @@
   },
   "scripts": {
     "build": "rollup --c rollup.config.ts --configPlugin typescript",
-    "release": "npm publish --access public --registry https://registry.npmjs.org/"
+    "release": "npm publish --access public --registry https://registry.npmjs.org/",
+    "deploy": "node scripts/deploy.mjs",
+    "publish:all": "npm run build && npm run release && npm run deploy",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "node scripts/smoke-test.mjs",
+    "typecheck": "tsc --noEmit"
   },
   "private": false,
   "author": "tengence",
   "license": "ISC",
   "devDependencies": {
+    "@babel/core": "^7.29.7",
+    "@babel/preset-env": "^7.29.7",
     "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-babel": "^7.1.0",
     "@rollup/plugin-commonjs": "^28.0.1",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.3.0",
@@ -28,10 +38,14 @@
     "@rollup/plugin-typescript": "^12.1.1",
     "@types/node": "^22.13.1",
     "cors": "^2.8.5",
+    "dotenv": "^17.4.2",
     "express": "^4.21.2",
+    "jsdom": "^30.1.3",
     "rollup": "^4.34.6",
+    "ssh2": "^1.17.0",
     "tslib": "^2.8.0",
     "typescript": "^4.9.5",
+    "vitest": "^5.0.5",
     "web-vitals": "^5.1.0"
   },
   "files": [