@antglobal/rlog-sdk 0.0.1755855517-dev.11 → 0.0.1755855517-dev.13

package/dist/lib/lib/error.js

@@ -13,12 +13,12 @@ var _rrweb = require("rrweb");
 var _logger = _interopRequireDefault(require("./logger"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-// 存储事件监听器的引用，用于清理
-var eventListeners = [];
-
 // 错误触发器引用（错误采集模式下由 init.ts 注入）
 var errorTriggerInstance = null;
 
+// 标记是否已初始化
+var isInitialized = false;
+
 /**
  * 设置错误触发器实例（错误采集模式下由 init.ts 调用）
  */
@@ -55,156 +55,83 @@ var sendErrorToAnalytics = exports.sendErrorToAnalytics = function sendErrorToAn
   }
 };
 
-// 初始化错误处理
-function initErrorHandler() {
-  _logger.default.log('Error handling is enabled');
-
-  // JavaScript 运行时错误处理
-  var errorHandler = function errorHandler(event) {
-    var errorEvent = event;
-    // 检查是否是资源加载错误
-    if (event.target !== window) {
-      // 资源加载错误
-      var _errorData = {
-        type: 'RESOURCE_ERROR',
-        resourceType: event.target.tagName,
-        url: event.target.src || event.target.href || event.target.src,
-        message: errorEvent.message,
-        userAgent: navigator.userAgent,
-        timestamp: Date.now(),
-        location: window.location.href
-      };
-      sendErrorToAnalytics(_errorData);
-      return false;
-    }
-
-    // JavaScript 运行时错误
-    var message = errorEvent.message,
-      filename = errorEvent.filename,
-      lineno = errorEvent.lineno,
-      colno = errorEvent.colno,
-      error = errorEvent.error;
-    var errorData = {
-      type: 'JS_ERROR',
-      message: message,
-      file: filename,
-      line: lineno,
-      column: colno,
-      stack: error === null || error === void 0 ? void 0 : error.stack,
+/**
+ * JavaScript 运行时错误 & 资源加载错误处理
+ */
+function handleError(event) {
+  var errorEvent = event;
+
+  // 检查是否是资源加载错误
+  if (event.target !== window) {
+    var _errorData = {
+      type: 'RESOURCE_ERROR',
+      resourceType: event.target.tagName,
+      url: event.target.src || event.target.href || event.target.src,
+      message: errorEvent.message,
       userAgent: navigator.userAgent,
       timestamp: Date.now(),
       location: window.location.href
     };
-    sendErrorToAnalytics(errorData);
-
-    // 控制台保留原始错误显示
+    sendErrorToAnalytics(_errorData);
     return false;
-  };
-  window.addEventListener('error', errorHandler, true);
-  eventListeners.push({
-    target: window,
-    type: 'error',
-    listener: errorHandler,
-    options: true
-  });
+  }
 
-  // 拦截未处理的 Promise 错误
-  var unhandledRejectionHandler = function unhandledRejectionHandler(event) {
-    var rejectionEvent = event;
-    var reason = rejectionEvent.reason || 'Unknown rejection';
-    var errorData = {
-      type: 'PROMISE_REJECTION',
-      message: typeof reason === 'string' ? reason : reason.message,
-      stack: _typeof(reason) === 'object' ? reason.stack : null,
-      timestamp: Date.now(),
-      location: window.location.href
-    };
-    sendErrorToAnalytics(errorData);
-    // 阻止默认控制台报错
-    event.preventDefault();
+  // JavaScript 运行时错误
+  var message = errorEvent.message,
+    filename = errorEvent.filename,
+    lineno = errorEvent.lineno,
+    colno = errorEvent.colno,
+    error = errorEvent.error;
+  var errorData = {
+    type: 'JS_ERROR',
+    message: message,
+    file: filename,
+    line: lineno,
+    column: colno,
+    stack: error === null || error === void 0 ? void 0 : error.stack,
+    userAgent: navigator.userAgent,
+    timestamp: Date.now(),
+    location: window.location.href
   };
-  window.addEventListener('unhandledrejection', unhandledRejectionHandler);
-  eventListeners.push({
-    target: window,
-    type: 'unhandledrejection',
-    listener: unhandledRejectionHandler
-  });
+  sendErrorToAnalytics(errorData);
 
-  // 监控页面性能相关事件
-  var loadHandler = function loadHandler() {
-    sendErrorToAnalytics({
-      type: 'PAGE_LOAD',
-      url: window.location.href,
-      timestamp: Date.now()
-    });
-  };
-  window.addEventListener('load', loadHandler);
-  eventListeners.push({
-    target: window,
-    type: 'load',
-    listener: loadHandler
-  });
+  // 控制台保留原始错误显示
+  return false;
+}
 
-  // 监控页面卸载事件
-  var beforeUnloadHandler = function beforeUnloadHandler() {
-    sendErrorToAnalytics({
-      type: 'PAGE_UNLOAD',
-      url: window.location.href,
-      timestamp: Date.now()
-    });
+/**
+ * 未处理的 Promise 错误处理
+ */
+function handleUnhandledRejection(event) {
+  var rejectionEvent = event;
+  var reason = rejectionEvent.reason || 'Unknown rejection';
+  var errorData = {
+    type: 'PROMISE_REJECTION',
+    message: typeof reason === 'string' ? reason : reason.message,
+    stack: _typeof(reason) === 'object' ? reason.stack : null,
+    timestamp: Date.now(),
+    location: window.location.href
   };
-  window.addEventListener('beforeunload', beforeUnloadHandler);
-  eventListeners.push({
-    target: window,
-    type: 'beforeunload',
-    listener: beforeUnloadHandler
-  });
+  sendErrorToAnalytics(errorData);
+  // 阻止默认控制台报错
+  event.preventDefault();
+}
 
-  // 监控网络连接状态变化
-  var onlineHandler = function onlineHandler() {
-    sendErrorToAnalytics({
-      type: 'NETWORK_ONLINE',
-      timestamp: Date.now()
-    });
-  };
-  window.addEventListener('online', onlineHandler);
-  eventListeners.push({
-    target: window,
-    type: 'online',
-    listener: onlineHandler
-  });
-  var offlineHandler = function offlineHandler() {
-    sendErrorToAnalytics({
-      type: 'NETWORK_OFFLINE',
-      timestamp: Date.now()
-    });
-  };
-  window.addEventListener('offline', offlineHandler);
-  eventListeners.push({
-    target: window,
-    type: 'offline',
-    listener: offlineHandler
-  });
+// 初始化错误处理
+function initErrorHandler() {
+  if (isInitialized) return;
+  _logger.default.log('Error handling is enabled');
+  window.addEventListener('error', handleError, true);
+  window.addEventListener('unhandledrejection', handleUnhandledRejection);
+  isInitialized = true;
 }
 
 // 清理错误监听器
 function cleanupErrorHandler() {
+  if (!isInitialized) return;
   _logger.default.log('Cleaning up error handlers');
-
-  // 移除所有注册的事件监听器
-  eventListeners.forEach(function (_ref) {
-    var target = _ref.target,
-      type = _ref.type,
-      listener = _ref.listener,
-      options = _ref.options;
-    try {
-      target.removeEventListener(type, listener, options);
-    } catch (error) {
-      _logger.default.warn("Failed to remove event listener for ".concat(type), error);
-    }
-  });
-
-  // 清空监听器数组
-  eventListeners.length = 0;
+  window.removeEventListener('error', handleError, true);
+  window.removeEventListener('unhandledrejection', handleUnhandledRejection);
+  isInitialized = false;
   _logger.default.log('Error handlers cleaned up successfully');
 }

package/dist/lib/lib/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/lib/init.ts"],"names":[],"mappings":"AAqBA;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,EACrC,OAAO,GAAE,MAAuB,GAC/B,IAAI,CAiDN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CA0DN"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/lib/init.ts"],"names":[],"mappings":"AAqBA;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,EACrC,OAAO,GAAE,MAAuB,GAC/B,IAAI,CAiDN;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAgEN"}

package/dist/lib/lib/init.js

@@ -99,12 +99,12 @@ function initRLog(serv, appId, cdnConfigUrl) {
   (0, _uploader.resetUploadLoop)();
 
   // 设置SDK日志上报接口地址，并自动加入黑名单避免循环上报
-  if (serv) {
-    (0, _net.setSdkLogEndpoint)(serv);
-  }
+  var normalizedServUrl = (0, _net.normalizeUrl)(serv);
+  (0, _net.setSdkLogEndpoint)(normalizedServUrl);
 
   // 初始化配置管理器
   (0, _config.initConfigManager)(cdnConfigUrl).then(function () {
+    var _config$error;
     // 获取配置
     var config = (0, _config.getConfig)();
 
@@ -136,13 +136,20 @@ function initRLog(serv, appId, cdnConfigUrl) {
     // 启动统一上传循环
     // 错误模式下：idle 时跳过上传，uploading 时上传，状态由 ErrorTrigger 控制
     // 全量模式下：持续轮询上传
-    (0, _uploader.startUploadLoop)(serv, appId);
+    (0, _uploader.startUploadLoop)(normalizedServUrl, appId);
 
     // 初始化路由监控
     (0, _routerMonitor.initRouterMonitor)(config.routerMonitor);
 
-    // 初始化错误处理（全量模式和错误模式都启用）
-    (0, _error.initErrorHandler)();
+    // 判断是否启用错误监听上报：
+    // 1. 错误采集模式下强制启用（错误捕获模式必须依赖错误监听初始化）
+    // 2. 非错误模式下，根据用户 error 配置决定，默认不启用
+    var enableError = isErrorMode || ((_config$error = config.error) !== null && _config$error !== void 0 ? _config$error : false);
+    if (enableError) {
+      (0, _error.initErrorHandler)();
+    } else {
+      _logger.default.log('Error handling is disabled by config');
+    }
   }).catch(function (error) {
     _logger.default.error('Failed to initialize SDK', error);
   });

package/dist/lib/lib/net.d.ts

@@ -4,6 +4,7 @@ import { ErrorTrigger } from './error-trigger';
  * 设置网络模块的错误触发器实例
  */
 export declare function setNetErrorTrigger(trigger: ErrorTrigger | null): void;
+export declare function normalizeUrl(url: string): string;
 export declare function shouldRecordUrl(url: string): boolean;
 export declare function watchXhr(r: typeof record): void;
 export declare function restoreXhr(): void;

package/dist/lib/lib/net.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../../../src/lib/net.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAM/C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAErE;AA2ID,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgBpD;AAUD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,MAAM,QAkPxC;AAGD,wBAAgB,UAAU,IAAI,IAAI,CAYjC;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAQrD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAOrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAsBxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD"}
+{"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../../../src/lib/net.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAM/C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAErE;AAgDD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBhD;AAwED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgBpD;AAiCD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,MAAM,QAsPxC;AAGD,wBAAgB,UAAU,IAAI,IAAI,CAiBjC;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAQrD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAOrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAoBxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD"}

package/dist/lib/lib/net.js

@@ -8,6 +8,7 @@ exports.getBlackListUrls = getBlackListUrls;
 exports.getCustomHeaders = getCustomHeaders;
 exports.getSdkLogEndpoint = getSdkLogEndpoint;
 exports.getWhiteListUrls = getWhiteListUrls;
+exports.normalizeUrl = normalizeUrl;
 exports.restoreXhr = restoreXhr;
 exports.setBlackListUrls = setBlackListUrls;
 exports.setCustomHeaders = setCustomHeaders;
@@ -16,6 +17,7 @@ exports.setSdkLogEndpoint = setSdkLogEndpoint;
 exports.setWhiteListUrls = setWhiteListUrls;
 exports.shouldRecordUrl = shouldRecordUrl;
 exports.watchXhr = watchXhr;
+var _rrweb = require("rrweb");
 var _config = require("./config");
 var _logger = _interopRequireDefault(require("./logger"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -170,6 +172,28 @@ function shouldRecordUrl(url) {
   return isUrlInWhitelist(url, whiteListUrls);
 }
 
+// 网络状态变化事件处理
+function handleOnline() {
+  try {
+    _rrweb.record.addCustomEvent('network-status', {
+      type: 'NETWORK_ONLINE',
+      timestamp: Date.now()
+    });
+  } catch (error) {
+    _logger.default.warn('Failed to add NETWORK_ONLINE event (recording may have stopped)', error);
+  }
+}
+function handleOffline() {
+  try {
+    _rrweb.record.addCustomEvent('network-status', {
+      type: 'NETWORK_OFFLINE',
+      timestamp: Date.now()
+    });
+  } catch (error) {
+    _logger.default.warn('Failed to add NETWORK_OFFLINE event (recording may have stopped)', error);
+  }
+}
+
 // 存储原始方法
 var origOpen = XMLHttpRequest.prototype.open;
 var origSend = XMLHttpRequest.prototype.send;
@@ -404,6 +428,10 @@ function watchXhr(r) {
       return _ref3.apply(this, arguments);
     };
   }();
+
+  // 监听网络连接状态变化
+  window.addEventListener('online', handleOnline);
+  window.addEventListener('offline', handleOffline);
 }
 
 // 恢复原始方法
@@ -417,6 +445,10 @@ function restoreXhr() {
   if (origFetch) {
     window.fetch = origFetch;
   }
+
+  // 移除网络状态监听器
+  window.removeEventListener('online', handleOnline);
+  window.removeEventListener('offline', handleOffline);
   isHooked = false;
   _logger.default.log('Network monitoring restored');
 }
@@ -465,7 +497,7 @@ function setSdkLogEndpoint(endpoint) {
     sdkLogEndpoint = endpoint;
 
     // 规范化endpoint路径，确保相对路径也能正确匹配
-    var normalizedEndpoint = endpoint.startsWith('/') ? endpoint : '/' + endpoint;
+    var normalizedEndpoint = normalizeUrl(endpoint);
 
     // 自动将SDK日志上报接口加入黑名单，避免循环上报
     // 同时添加原始路径和规范化路径，确保兼容性

package/dist/lib/lib/router-monitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router-monitor.d.ts","sourceRoot":"","sources":["../../../src/lib/router-monitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,UAAU,CAAC;AAIrD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA2ID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,CAAC,GAAG,IAAI,CAuB3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,QAkCpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;;;EAMlC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,QAG1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,SAyBhC"}
+{"version":3,"file":"router-monitor.d.ts","sourceRoot":"","sources":["../../../src/lib/router-monitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,UAAU,CAAC;AAIrD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA2ID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,CAAC,GAAG,IAAI,CAuB3E;AAuFD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,eAAe,CAAC,QA4CpE;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;;;EAMlC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,QAG1D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,SA8BhC"}

package/dist/lib/lib/router-monitor.js

@@ -178,6 +178,91 @@ function updateRouterConfig(config) {
   }
 }
 
+/**
+ * 处理页面加载事件
+ */
+function handlePageLoad() {
+  try {
+    _rrweb.record.addCustomEvent('page-lifecycle', {
+      type: 'PAGE_LOAD',
+      url: window.location.href,
+      timestamp: Date.now()
+    });
+  } catch (error) {
+    _logger.default.warn('Failed to add PAGE_LOAD event (recording may have stopped)', error);
+  }
+}
+
+/**
+ * 处理页面卸载事件
+ */
+function handlePageUnload() {
+  try {
+    _rrweb.record.addCustomEvent('page-lifecycle', {
+      type: 'PAGE_UNLOAD',
+      url: window.location.href,
+      timestamp: Date.now()
+    });
+  } catch (error) {
+    _logger.default.warn('Failed to add PAGE_UNLOAD event (recording may have stopped)', error);
+  }
+}
+
+/**
+ * 处理页面隐藏事件（移动端友好，替代 beforeunload）
+ * pagehide 在移动端浏览器中比 beforeunload 更可靠
+ */
+function handlePageHide(event) {
+  try {
+    _rrweb.record.addCustomEvent('page-lifecycle', {
+      type: 'PAGE_HIDE',
+      url: window.location.href,
+      timestamp: Date.now(),
+      persisted: event.persisted // 页面是否进入 bfcache
+    });
+  } catch (error) {
+    _logger.default.warn('Failed to add PAGE_HIDE event (recording may have stopped)', error);
+  }
+}
+
+/**
+ * 处理页面显示事件（移动端友好，支持 bfcache 恢复检测）
+ * pageshow 在页面从 bfcache 恢复时也会触发
+ */
+function handlePageShow(event) {
+  try {
+    _rrweb.record.addCustomEvent('page-lifecycle', {
+      type: 'PAGE_SHOW',
+      url: window.location.href,
+      timestamp: Date.now(),
+      persisted: event.persisted // 是否从 bfcache 恢复
+    });
+
+    // 如果是从 bfcache 恢复，重置路由计时器
+    if (event.persisted) {
+      routeStartTime = Date.now();
+    }
+  } catch (error) {
+    _logger.default.warn('Failed to add PAGE_SHOW event (recording may have stopped)', error);
+  }
+}
+
+/**
+ * 处理页面可见性变化事件（移动端切换应用/标签页）
+ */
+function handleVisibilityChange() {
+  try {
+    var isHidden = document.visibilityState === 'hidden';
+    _rrweb.record.addCustomEvent('page-lifecycle', {
+      type: isHidden ? 'PAGE_VISIBILITY_HIDDEN' : 'PAGE_VISIBILITY_VISIBLE',
+      url: window.location.href,
+      timestamp: Date.now()
+    });
+  } catch (error) {
+    _logger.default.warn('Failed to add visibility change event (recording may have stopped)', error);
+  }
+}
+
 /**
  * 初始化路由监控
  */
@@ -213,6 +298,16 @@ function initRouterMonitor(config) {
   if (routerConfig.trackHashChange) {
     window.addEventListener('hashchange', handleHashChange);
   }
+
+  // 监听页面生命周期事件
+  window.addEventListener('load', handlePageLoad);
+  window.addEventListener('beforeunload', handlePageUnload);
+
+  // 监听移动端页面生命周期事件
+  // pagehide/pageshow 在移动端比 beforeunload 更可靠
+  window.addEventListener('pagehide', handlePageHide);
+  window.addEventListener('pageshow', handlePageShow);
+  document.addEventListener('visibilitychange', handleVisibilityChange);
   isInitialized = true;
 }
 
@@ -251,6 +346,11 @@ function stopRouterMonitor() {
   if (typeof window !== 'undefined') {
     window.removeEventListener('popstate', handlePopState);
     window.removeEventListener('hashchange', handleHashChange);
+    window.removeEventListener('load', handlePageLoad);
+    window.removeEventListener('beforeunload', handlePageUnload);
+    window.removeEventListener('pagehide', handlePageHide);
+    window.removeEventListener('pageshow', handlePageShow);
+    document.removeEventListener('visibilitychange', handleVisibilityChange);
   }
 
   // 重置状态

package/dist/lib/lib/upload-worker-manager.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Upload Worker 管理器
+ *
+ * 职责：
+ * - Worker 生命周期管理（创建、销毁、降级）
+ * - 将 Worker 脚本以 inline Blob 方式加载
+ * - 封装 postMessage/onmessage 通信
+ * - 处理 Worker 回传的消息，调用对应的主线程逻辑
+ * - 提供与现有 uploader.ts 相同的对外 API
+ */
+import type { WorkerConfig } from './upload-worker';
+/**
+ * 尝试初始化 Worker 模式
+ * @returns 是否成功启用 Worker 模式
+ */
+export declare function initWorkerUpload(serv: string, appId: string): boolean;
+/**
+ * 销毁 Worker
+ */
+export declare function destroyWorker(): void;
+/**
+ * 是否正在使用 Worker 模式
+ */
+export declare function isUsingWorkerMode(): boolean;
+/**
+ * 设置错误模式上传状态（Worker 模式）
+ */
+export declare function setWorkerErrorModeUploading(uploading: boolean): void;
+/**
+ * 设置错误模式上传时间窗口起点（Worker 模式）
+ */
+export declare function setWorkerErrorModeWindowStart(startTime: number): void;
+/**
+ * 更新 Worker 配置
+ */
+export declare function updateWorkerConfig(config: Partial<WorkerConfig>): void;
+//# sourceMappingURL=upload-worker-manager.d.ts.map

package/dist/lib/lib/upload-worker-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-worker-manager.d.ts","sourceRoot":"","sources":["../../../src/lib/upload-worker-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAgC,MAAM,iBAAiB,CAAC;AAkTlF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA8BrE;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAkBpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAQpE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAKtE"}