@antglobal/rlog-sdk 0.0.1755855517-dev.9 → 0.0.1781493462-dev.2

package/dist/lib/lib/upload-worker.js

@@ -0,0 +1,33 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getUploadWorkerCode = getUploadWorkerCode;
+var _constants = require("./constants");
+/**
+ * Upload Worker 脚本
+ *
+ * 在 Web Worker 中执行上传任务，将 JSON 序列化 + FormData 构建 + XHR 上传
+ * 从主线程移到 Worker 线程，避免阻塞 UI。
+ *
+ * 通信协议：
+ *   主线程 → Worker: WorkerCommand
+ *   Worker → 主线程: WorkerMessage
+ */
+
+// ==================== 类型定义 ====================
+
+// 主线程 → Worker
+
+// Worker → 主线程
+
+// ==================== Worker 代码（字符串形式） ====================
+
+/**
+ * 返回 Worker 脚本的源代码字符串
+ * 用于通过 Blob URL 内联创建 Worker
+ */
+function getUploadWorkerCode() {
+  return "\n'use strict';\n\n// ===== Worker \u5185\u90E8\u72B6\u6001 =====\nvar config = null;\nvar pollTimer = null;\nvar isRunning = false;\nvar failureCountMap = {};\n\n// ===== UUID \u751F\u6210 =====\nfunction generateUUID() {\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {\n    var r = (Math.random() * 16) | 0;\n    var v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n// ===== \u6784\u5EFA\u4E0A\u4F20 URL =====\nfunction buildUploadUrl(serv, queryParams) {\n  var params = [];\n  for (var key in queryParams) {\n    if (queryParams.hasOwnProperty(key) && queryParams[key] != null && queryParams[key] !== '') {\n      params.push(encodeURIComponent(key) + '=' + encodeURIComponent(queryParams[key]));\n    }\n  }\n  var queryString = params.join('&');\n  return serv + (queryString ? '?' + queryString : '');\n}\n\n// ===== \u6267\u884C\u4E0A\u4F20 =====\nfunction performUpload(msg) {\n  var batchId = msg.batchId;\n  var events = msg.events;\n  var queryParams = msg.queryParams;\n  var customHeaders = msg.customHeaders;\n\n  try {\n    // JSON \u5E8F\u5217\u5316\u5728 Worker \u4E2D\u6267\u884C\uFF0C\u4E0D\u963B\u585E\u4E3B\u7EBF\u7A0B\n    var jsonStr = JSON.stringify(events);\n    var blob = new Blob([jsonStr], { type: 'application/json' });\n    var formData = new FormData();\n    formData.append('file', blob, generateUUID() + '.json');\n\n    var url = buildUploadUrl(config ? config.serv : '', queryParams);\n\n    var xhr = new XMLHttpRequest();\n    xhr.open('POST', url, true);\n    xhr.timeout = ".concat(_constants.REQUEST_TIMEOUT, ";\n\n    // \u8BBE\u7F6E\u81EA\u5B9A\u4E49\u8BF7\u6C42\u5934\n    if (customHeaders) {\n      for (var key in customHeaders) {\n        if (customHeaders.hasOwnProperty(key)) {\n          xhr.setRequestHeader(key, customHeaders[key]);\n        }\n      }\n    }\n\n    xhr.onreadystatechange = function() {\n      if (xhr.readyState === 4) {\n        if (xhr.status >= 200 && xhr.status < 300) {\n          // \u68C0\u67E5\u4E1A\u52A1\u5C42 success \u5B57\u6BB5\n          var uploadSuccess = true;\n          var errorMessage = '';\n          try {\n            var responseData = JSON.parse(xhr.responseText);\n            if (responseData && typeof responseData === 'object' && responseData.success === false) {\n              uploadSuccess = false;\n              errorMessage = responseData.errorMessage || 'Upload failed with success=false';\n            }\n          } catch(e) {\n            // \u65E0\u6CD5\u89E3\u6790 JSON\uFF0C\u89C6\u4E3A\u6210\u529F\n          }\n\n          if (uploadSuccess) {\n            // \u4E0A\u4F20\u6210\u529F\uFF0C\u91CD\u7F6E\u5931\u8D25\u8BA1\u6570\n            var batchKey = config ? (config.appId + '_' + config.storageKey) : batchId;\n            delete failureCountMap[batchKey];\n            self.postMessage({ type: 'UPLOAD_SUCCESS', batchId: batchId });\n          } else {\n            handleFailure(batchId, errorMessage);\n          }\n        } else {\n          handleFailure(batchId, 'HTTP ' + xhr.status + ': ' + xhr.statusText);\n        }\n      }\n    };\n\n    xhr.onerror = function() {\n      handleFailure(batchId, 'Network error');\n    };\n\n    xhr.ontimeout = function() {\n      handleFailure(batchId, 'Request timeout');\n    };\n\n    xhr.send(formData);\n  } catch (e) {\n    handleFailure(batchId, 'Upload exception: ' + (e.message || String(e)));\n  }\n}\n\n// ===== \u5904\u7406\u4E0A\u4F20\u5931\u8D25 =====\nfunction handleFailure(batchId, errorMessage) {\n  var batchKey = config ? (config.appId + '_' + config.storageKey) : batchId;\n  var currentCount = failureCountMap[batchKey] || 0;\n  var newCount = currentCount + 1;\n  failureCountMap[batchKey] = newCount;\n\n  var maxRetry = (config && config.maxRetryCount) ? config.maxRetryCount : 3;\n\n  if (newCount >= maxRetry) {\n    // \u8FBE\u5230\u6700\u5927\u91CD\u8BD5\u6B21\u6570\n    delete failureCountMap[batchKey];\n    self.postMessage({\n      type: 'MAX_RETRY_REACHED',\n      batchId: batchId,\n      error: errorMessage\n    });\n  } else {\n    self.postMessage({\n      type: 'UPLOAD_FAILURE',\n      batchId: batchId,\n      error: errorMessage,\n      failureCount: newCount\n    });\n  }\n}\n\n// ===== \u8F6E\u8BE2\u8C03\u5EA6 =====\nfunction startPolling() {\n  if (pollTimer) {\n    clearInterval(pollTimer);\n  }\n\n  var interval = (config && config.uploadInterval) ? config.uploadInterval : 2000;\n\n  pollTimer = setInterval(function() {\n    if (!isRunning) return;\n\n    // \u5411\u4E3B\u7EBF\u7A0B\u8BF7\u6C42\u6570\u636E\u6279\u6B21\n    // \u4E3B\u7EBF\u7A0B\u4F1A\u6839\u636E\u5F53\u524D\u6A21\u5F0F\uFF08full/error\uFF09\u548C\u72B6\u6001\u51B3\u5B9A\u662F\u5426\u63D0\u4F9B\u6570\u636E\n    self.postMessage({\n      type: 'REQUEST_BATCH'\n    });\n  }, interval);\n}\n\nfunction stopPolling() {\n  if (pollTimer) {\n    clearInterval(pollTimer);\n    pollTimer = null;\n  }\n}\n\n// ===== \u6E05\u7406 =====\nfunction cleanup() {\n  isRunning = false;\n  stopPolling();\n  failureCountMap = {};\n  config = null;\n}\n\n// ===== \u6D88\u606F\u5904\u7406 =====\nself.onmessage = function(e) {\n  var msg = e.data;\n  if (!msg || !msg.type) return;\n\n  switch (msg.type) {\n    case 'START':\n      config = msg.config;\n      isRunning = true;\n      failureCountMap = {};\n      startPolling();\n      break;\n\n    case 'STOP':\n      cleanup();\n      break;\n\n    case 'UPLOAD_BATCH':\n      if (isRunning) {\n        performUpload(msg);\n      }\n      break;\n\n    case 'UPDATE_CONFIG':\n      if (msg.config) {\n        for (var key in msg.config) {\n          if (msg.config.hasOwnProperty(key) && config) {\n            config[key] = msg.config[key];\n          }\n        }\n        // \u5982\u679C uploadInterval \u53D8\u4E86\uFF0C\u91CD\u542F\u8F6E\u8BE2\n        if (msg.config.uploadInterval && isRunning) {\n          startPolling();\n        }\n      }\n      break;\n\n    case 'SET_ERROR_MODE_UPLOADING':\n      // \u72B6\u6001\u7531\u4E3B\u7EBF\u7A0B\u7BA1\u7406\uFF0CWorker \u4EC5\u63A5\u6536\u6307\u4EE4\u4FDD\u6301\u534F\u8BAE\u517C\u5BB9\n      break;\n  }\n};\n\n// Worker \u5C31\u7EEA\u901A\u77E5\nself.postMessage({ type: 'READY' });\n");
+}

package/dist/lib/lib/uploader.d.ts

@@ -1,11 +1,32 @@
+/**
+ * 设置 SDK 取消回调（由 init.ts 在启动上传循环前注入）
+ */
+export declare function setCancelCallback(callback: (() => void) | null): void;
+/**
+ * 设置错误模式上传状态
+ * 由 ErrorTrigger 调用：错误触发时设置为 true，cooldown 结束时设置为 false
+ * 自动分发到 Worker 模式或主线程模式
+ */
+export declare function setErrorModeUploading(uploading: boolean): void;
+/**
+ * 设置错误模式上传时间窗口起点
+ * 由 ErrorTrigger 调用，记录错误触发前的时间窗口起点
+ * 自动分发到 Worker 模式或主线程模式
+ */
+export declare function setErrorModeWindowStart(startTime: number): void;
 /**
  * 启动数据上传循环
+ * 优先尝试 Worker 模式，失败则降级到主线程模式
+ *
+ * 全量模式：持续轮询上传
+ * 错误模式：idle 时跳过上传，uploading 时轮询上传（由 ErrorTrigger 控制状态）
  * @param serv 服务器地址
  * @param appId 应用ID
  */
 export declare function startUploadLoop(serv: string, appId: string): void;
 /**
  * 取消上传循环
+ * 同时处理 Worker 模式和主线程模式
  */
 export declare function cancelUploadLoop(): void;
 /**
@@ -16,4 +37,26 @@ export declare function resetUploadLoop(): void;
  * 强制重置上传状态（用于测试）
  */
 export declare function forceResetUploadState(): void;
+/**
+ * 扫描并回收孤儿 session 的残留数据
+ *
+ * 在多页面应用（MPA）中，当用户从页面 A 导航到页面 B 时：
+ * - 页面 A 的上传循环被中断，storage 中可能还有未上传的事件数据
+ * - 页面 B 生成新的 sessionId，只会读取自己的数据
+ * - 页面 A 的残留数据成为"孤儿数据"
+ *
+ * 此函数在上传循环启动前调用（await），将孤儿数据合并到当前 session 的
+ * storage 队列头部，确保上传循环启动时数据已就位。
+ *
+ * 优势：
+ * - 不额外发起上传请求，复用现有上传循环
+ * - 孤儿数据在前、当前数据在后，时序天然连贯
+ * - 自动复用上传循环的重试机制
+ *
+ * 安全策略：
+ * 1. 只处理近期的 session（5 分钟内注册的）
+ * 2. 只回收时间跨度合理的数据（2 分钟内，即上传周期内的残留）
+ * 3. 回收失败不影响当前页面的正常录制和上传
+ */
+export declare function flushOrphanSessions(): Promise<void>;
 //# sourceMappingURL=uploader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"uploader.d.ts","sourceRoot":"","sources":["../../../src/lib/uploader.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CA8IjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}
+{"version":3,"file":"uploader.d.ts","sourceRoot":"","sources":["../../../src/lib/uploader.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAErE;AAmBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM/D;AA4PD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAmBjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAcvC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAetC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiDzD"}