@rk911/tracker-sdk 1.6.7 → 1.6.9

package/core/compat.js

@@ -308,7 +308,7 @@ export function createPageStayMixin(tracker) {
 
         var config = tracker.getConfig()
         // 最小停留阈值：iOS 前后台抖动会产生大量 1~2s 的碎停留，默认 2000ms 过滤噪音
-        var minDuration = (config.pageStay || {}).minStayDuration || 2000
+        var minDuration = (config.pageStay || {}).minStayDuration || 500
         if (duration < minDuration) return
 
         var maxDuration = (config.pageStay || {}).maxStayDuration || 1800000

package/core/config.js

@@ -26,7 +26,7 @@ const DEFAULT_CONFIG = {
   pageStay: {
     heartbeatInterval: 5000,
     maxStayDuration: 1800000,
-    minStayDuration: 2000,
+    minStayDuration: 500,
   },
 
   // 曝光插件配置
@@ -44,6 +44,11 @@ const DEFAULT_CONFIG = {
     milestone: false,   // 是否只在 25/50/75/100% 里程碑时上报
   },
 
+  // API 监听插件配置
+  apiWatch: {
+    maxResponseDataLength: 1024, // API 响应体最大截断长度，0 表示不截断全量上报
+  },
+
   // 采样率 0-1，1 表示全量采集，0.5 表示 50% 的会话被采集
   // 采用会话级别采样，同一个 session 内所有事件要么全采要么全不采
   sampling: 1,

package/core/session.js

@@ -10,6 +10,9 @@ export class SessionManager {
     this.sequence = 0
     this.userId = null
     this.deviceId = null
+    this.isNativeSessionId = false
+    this.isNativeDeviceId = false
+    this.isNativeUserId = false
     this._storageKey = config.session.storageKey || '_tracker_session'
     this._renewListeners = []
 
@@ -32,6 +35,7 @@ export class SessionManager {
   getSessionId() {
     if (!this.sessionId || this._isExpired()) {
       var wasRenew = !!this.sessionId
+      this.isNativeSessionId = false
       this._createNew()
       if (wasRenew) this._notifyRenew()
     }
@@ -56,15 +60,34 @@ export class SessionManager {
     this._save()
   }
 
-  setUser(userId) {
+  setUser(userId, isNative = false) {
     this.userId = userId
+    this.isNativeUserId = !!isNative
+    if (userId && !isNative) {
+      this.adapter.setStorage('userId', userId)
+    }
     this._save()
   }
 
-  setDeviceId(deviceId) {
-    this.deviceId = deviceId
-    this.adapter.setStorage(DEVICE_ID_KEY, deviceId)
-    this._save()
+  setDeviceId(deviceId, isNative = false) {
+    if (deviceId) {
+      this.deviceId = deviceId
+      this.isNativeDeviceId = !!isNative
+      if (!isNative) {
+        this.adapter.setStorage(DEVICE_ID_KEY, deviceId)
+        this.adapter.setStorage('deviceId', deviceId)
+      }
+      this._save()
+    }
+  }
+
+  setSessionId(sessionId, isNative = false) {
+    if (sessionId) {
+      this.sessionId = sessionId
+      this.isNativeSessionId = !!isNative
+      this.lastActivityTime = this.adapter.getTimestamp()
+      this._save()
+    }
   }
 
   getUserId() {
@@ -95,13 +118,14 @@ export class SessionManager {
       startTime: this.startTime,
       lastActivityTime: this.lastActivityTime,
       sequence: this.sequence,
+      isNativeSessionId: !!this.isNativeSessionId,
     }
     this.adapter.setSessionStorage(this._storageKey, data)
   }
 
   _restore() {
     var data = this.adapter.getSessionStorage(this._storageKey)
-    if (data && data.sessionId) {
+    if (data && data.sessionId && !data.isNativeSessionId) {
       this.sessionId = data.sessionId
       this.startTime = data.startTime
       this.lastActivityTime = data.lastActivityTime

package/core/tracker.js

@@ -200,12 +200,24 @@ export class Tracker {
 
   // ---- 用户标识 ----
 
-  setUser(userId) {
-    this.session.setUser(userId)
+  setUser(userId, isNative = false) {
+    this.session.setUser(userId, isNative)
   }
 
-  setDeviceId(deviceId) {
-    this.session.setDeviceId(deviceId)
+  setDeviceId(deviceId, isNative = false) {
+    this.session.setDeviceId(deviceId, isNative)
+  }
+
+  setSessionId(sessionId, isNative = false) {
+    this.session.setSessionId(sessionId, isNative)
+  }
+
+  getDeviceId() {
+    return this.session.getDeviceId()
+  }
+
+  getSessionId() {
+    return this.session.getSessionId()
   }
 
   setUserProperties(properties) {
@@ -224,6 +236,22 @@ export class Tracker {
         this._referrer = this._currentPage
       }
       this._currentPage = newPage
+      if (this._pageRouteUpdateListeners) {
+        this._pageRouteUpdateListeners.forEach(function (fn) {
+          try {
+            fn(newPage)
+          } catch (e) {}
+        })
+      }
+    }
+  }
+
+  onPageRouteUpdate(fn) {
+    if (!this._pageRouteUpdateListeners) {
+      this._pageRouteUpdateListeners = []
+    }
+    if (typeof fn === 'function') {
+      this._pageRouteUpdateListeners.push(fn)
     }
   }
 

package/index.js

@@ -89,6 +89,15 @@ export function createTracker(config) {
   var adapter = createAdapter(platform, config)
   trackerInstance = new Tracker(config, adapter)
 
+  // 触发 onBeforeInit 钩子（必须在插件注册与首屏事件触发前执行，以便同步/异步注入 Native 上下文）
+  if (typeof config.onBeforeInit === 'function') {
+    try {
+      config.onBeforeInit(trackerInstance)
+    } catch (e) {
+      console.warn('[TrackerSDK] onBeforeInit error:', e)
+    }
+  }
+
   // 注册插件
   var pluginNames = config.plugins || []
   pluginNames.forEach(function (pluginName) {
@@ -125,7 +134,14 @@ export function getTracker() {
 function registerDeviceIfNeeded(tracker) {
   var adapter = tracker.getAdapter()
   var config = tracker.getConfig()
-  var existingId = adapter.getStorage('deviceId')
+  var session = tracker.getSession()
+
+  // 如果是由 App/Native 动态注入的临时 DeviceID，跳过 H5 本地注册逻辑
+  if (session.isNativeDeviceId && session.getDeviceId()) {
+    return
+  }
+
+  var existingId = session.getDeviceId() || adapter.getStorage('deviceId') || adapter.getStorage('_tracker_device_id')
   if (existingId) {
     tracker.setDeviceId(existingId)
     return
@@ -188,6 +204,12 @@ function registerDeviceIfNeeded(tracker) {
  * 不依赖内存缓存，确保清除存储后不会残留旧用户、切换账号后能及时更新
  */
 function _ensureUserId(tracker) {
+  var session = tracker.getSession()
+  // 如果当前 userId 是由 Native 拼接注入的临时账号，不被 H5 本地 Cookie/Storage 覆写
+  if (session.isNativeUserId && session.getUserId()) {
+    return
+  }
+
   var adapter = tracker.getAdapter()
   // 从源头实时读取（登录页写入了 uni.setStorageSync('userId', ...)）
   var uid = adapter.getStorage('userId')

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@rk911/tracker-sdk",
-  "version": "1.6.7",
+  "version": "1.6.9",
   "description": "人康多端埋点 SDK — 自动化采集 + 手动埋点兼容",
   "main": "index.js",
   "module": "index.js",
+  "type": "module",
   "files": [
     "index.js",
     "core/",

package/plugins/api-watch.js

@@ -181,9 +181,12 @@ export class ApiWatchPlugin {
       return '[含base64内联数据,已省略 ' + str.length + ' 字节]'
     }
 
-    var MAX = 1024
-    if (str.length > MAX) {
-      return str.substring(0, MAX) + '...[已截断,共' + str.length + '字节]'
+    var config = this.tracker ? this.tracker.getConfig() : {}
+    var apiWatchConfig = (config && config.apiWatch) || {}
+    var maxLen = apiWatchConfig.maxResponseDataLength !== undefined ? apiWatchConfig.maxResponseDataLength : 1024
+
+    if (maxLen > 0 && str.length > maxLen) {
+      return str.substring(0, maxLen) + '...[已截断,共' + str.length + '字节]'
     }
     return str
   }

package/plugins/js-error.js

@@ -152,8 +152,8 @@ export class JsErrorPlugin {
   _handleRejection(event) {
     if (!this.tracker || !event) return
 
-    var reason = event.reason || event
-    var message = reason ? (reason.message || String(reason)) : 'Unknown rejection'
+    var reason = event.reason !== undefined ? event.reason : event
+    var message = this._formatErrorMessage(reason)
     var stack = (reason && reason.stack) ? reason.stack.substring(0, 1000) : ''
     var fingerprint = 'rejection|' + message
 
@@ -172,6 +172,20 @@ export class JsErrorPlugin {
     })
   }
 
+  _formatErrorMessage(err) {
+    if (!err) return 'Unknown error'
+    if (typeof err === 'string') return err
+    if (err.message && typeof err.message === 'string') return err.message
+    if (err.errMsg && typeof err.errMsg === 'string') return err.errMsg
+    if (err.msg && typeof err.msg === 'string') return err.msg
+    if (err.error && typeof err.error === 'string') return err.error
+    try {
+      var str = JSON.stringify(err)
+      if (str && str !== '{}') return str
+    } catch (e) {}
+    return String(err)
+  }
+
   _handleResourceError(event) {
     if (!this.tracker || !event || !event.target) return
 

package/plugins/page-view.js

@@ -15,6 +15,12 @@ export class PageViewPlugin {
     var self = this
 
     if (platform === 'web' || platform === 'app') {
+      // 联动：当页面 onLoad/onShow 主动 updatePageRoute 时，同步立刻触发 page_view，
+      // 保证页面返回/重定向等场景下 page_view 序列号与时间戳仍绝对领先于 api_request
+      tracker.onPageRouteUpdate(function (newPage) {
+        self._reportPageView()
+      })
+
       adapter.onRouteChange(function () {
         // 取消上一次未完成的检测（防止 pushState+hashchange 双触发）
         if (self._pendingTimer) {
@@ -103,54 +109,48 @@ export class PageViewPlugin {
     this.tracker.updatePageRoute(currentPage)
 
     var self = this
-    // 代次令牌：每次进入生成新代次，旧的 title 重试链检测到代次变化即中止
-    // 防止导航交叠时，未完成的重试链把过期路由的 page_view 发出去
     var myGen = (this._pvGen = (this._pvGen || 0) + 1)
-    var titleAttempts = 0
-    var prevTitle = ''
-    function reportWithTitle() {
-      if (myGen !== self._pvGen) return
-      var title = typeof document !== 'undefined' ? document.title : ''
-      // 第一轮：无论 title 有无值，都等一个 tick 让框架有机会更新
-      if (titleAttempts === 0) {
-        prevTitle = title
-        titleAttempts++
-        setTimeout(reportWithTitle, 50)
-        return
-      }
-      // title 为空：继续等
-      if (!title && titleAttempts < 10) {
-        titleAttempts++
-        setTimeout(reportWithTitle, 50)
-        return
-      }
-      // title 在两次检查间发生变化：说明框架刚更新了，再等一轮确认稳定
-      if (title !== prevTitle && titleAttempts < 10) {
-        prevTitle = title
-        titleAttempts++
-        setTimeout(reportWithTitle, 50)
-        return
-      }
-      // 兜底：如果 title 在所有重试后仍未变化（框架未更新 document.title），
-      // 尝试从 uni-app 页面栈读取 navigationBarTitle
-      if (titleAttempts >= 10 && title === prevTitle) {
+
+    function getBestTitle() {
+      var t = typeof document !== 'undefined' ? document.title : ''
+      if (!t) {
         try {
           var pages = getCurrentPages()
-          var cur = pages[pages.length - 1]
-          var stackTitle = (cur && cur.$page && cur.$page.meta && cur.$page.meta.navigationBar
-            ? cur.$page.meta.navigationBar.titleText : '') || ''
-          if (stackTitle) title = stackTitle
+          if (pages && pages.length) {
+            var cur = pages[pages.length - 1]
+            t = (cur && cur.$page && cur.$page.meta && cur.$page.meta.navigationBar
+              ? cur.$page.meta.navigationBar.titleText : '') || ''
+          }
         } catch (e) {}
       }
-      self._lastTitle = title
-      self.tracker.track('page_view', {
-        pageRoute: currentPage,
-        page: currentPage,
-        pageTitle: title,
-        timestamp: entryTimestamp,
-      })
+      return t
+    }
+
+    // 立刻同步触发 page_view 打点，保证 page_view 序列号和时间戳严格领先于该页面后续发起的 api_request
+    var initialTitle = getBestTitle()
+    self._lastTitle = initialTitle
+    self.tracker.track('page_view', {
+      pageRoute: currentPage,
+      page: currentPage,
+      pageTitle: initialTitle,
+      timestamp: entryTimestamp,
+    })
+
+    // 若首帧标题尚空，开启轻量轮询更新本地标题记录
+    if (!initialTitle && typeof document !== 'undefined') {
+      var attempts = 0
+      function pollTitle() {
+        if (myGen !== self._pvGen) return
+        var t = getBestTitle()
+        if (t) {
+          self._lastTitle = t
+        } else if (attempts < 5) {
+          attempts++
+          setTimeout(pollTitle, 50)
+        }
+      }
+      setTimeout(pollTitle, 50)
     }
-    reportWithTitle()
   }
 
   // 供 mixin 调用（小程序端）