@antglobal/rlog-sdk 0.0.1755855517-dev.9 → 1.0.0

package/dist/lib/lib/utils.d.ts

@@ -1,3 +1,78 @@
 export declare const generateUUIDCompat: () => string;
 export declare const getDeviceId: () => string;
+/**
+ * session 过期时间（1小时）
+ * 超过此时间的 session 数据将在下次 SDK 初始化时被清理
+ */
+/**
+ * 获取当前标签页的 sessionId
+ * 首次调用时自动生成并注册
+ */
+export declare const getSessionId: () => string;
+/**
+ * 获取存储用的复合键（deviceId_sessionId）
+ * 用于替代原来单独使用 deviceId 作为存储分区键
+ * 确保多标签页的录制数据互相隔离
+ */
+export declare const getStorageKey: () => string;
+/**
+ * 从注册表中移除指定 sessionId
+ */
+export declare function unregisterSession(sessionId: string): void;
+/**
+ * 清理过期的 session 数据
+ * 在 SDK 初始化时调用，扫描注册表中超过 SESSION_MAX_AGE 的 session，
+ * 删除其对应的存储数据和锁，并从注册表中移除
+ */
+export declare function cleanupStaleSessions(): void;
+/**
+ * 孤儿 session 数据的最大有效时间跨度（默认 2 分钟）
+ * 只有数据时间跨度在此范围内的才被视为"上传周期内的残留数据"，
+ * 超过此范围的可能是其他无关项目或异常数据，不予上传
+ */
+/**
+ * 孤儿 session 数据的最大年龄（默认 5 分钟）
+ * 只有 session 注册时间在此范围内的才被视为"近期的残留数据"，
+ * 超过此范围的可能是长时间未清理的旧数据
+ */
+/**
+ * 孤儿 session 信息
+ */
+export interface OrphanSessionInfo {
+    sessionId: string;
+    storageKey: string;
+}
+/**
+ * 获取所有孤儿 session（注册表中存在但不属于当前标签页的 session）
+ * 仅返回近期的、可能包含残留数据的 session
+ *
+ * 判断条件：
+ * 1. 不是当前标签页的 sessionId
+ * 2. session 注册时间在 ORPHAN_SESSION_MAX_AGE 范围内（排除过老的数据）
+ * 3. 对应的 localStorage 中确实存在数据
+ */
+export declare function getOrphanSessions(): OrphanSessionInfo[];
+/**
+ * 检查孤儿 session 的数据是否在合理的时间跨度内
+ * 用于过滤掉可能是其他无关项目或异常的数据
+ *
+ * @param events 事件数组
+ * @returns 是否在合理范围内
+ */
+export declare function isOrphanDataValid(events: any[]): boolean;
+/**
+ * 清理指定孤儿 session 的数据和注册信息
+ */
+export declare function cleanupOrphanSession(sessionId: string): void;
+/**
+ * 检查值是否为纯对象（非数组、非null）
+ */
+export declare const isPlainObject: (value: any) => value is Record<string, any>;
+/**
+ * 深度合并配置对象
+ * @param target 目标配置（默认配置）
+ * @param source 源配置（新配置）
+ * @returns 合并后的配置
+ */
+export declare const deepMergeConfig: <T extends Record<string, any>>(target: T, source: Partial<T>) => T;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,cAM9B,CAAC;AAEF,eAAO,MAAM,WAAW,cAYvB,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,kBAAkB,cAM9B,CAAC;AAEF,eAAO,MAAM,WAAW,cAYvB,CAAC;AAgBF;;;GAGG;AAGH;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAO,MAM/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAO,MAEhC,CAAC;AAeF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQzD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CA0B3C;AAID;;;;GAIG;AAGH;;;;GAIG;AAGH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,EAAE,CAkCvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CA0BxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAW5D;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,UAAW,GAAG,iCAEvC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,0CAClB,CAAC,UACD,QAAQ,CAAC,CAAC,KACjB,CAsBF,CAAC"}

package/dist/lib/lib/utils.js

@@ -3,7 +3,25 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.getDeviceId = exports.generateUUIDCompat = void 0;
+exports.cleanupOrphanSession = cleanupOrphanSession;
+exports.cleanupStaleSessions = cleanupStaleSessions;
+exports.getDeviceId = exports.generateUUIDCompat = exports.deepMergeConfig = void 0;
+exports.getOrphanSessions = getOrphanSessions;
+exports.getStorageKey = exports.getSessionId = void 0;
+exports.isOrphanDataValid = isOrphanDataValid;
+exports.isPlainObject = void 0;
+exports.unregisterSession = unregisterSession;
+var _safeStorage = require("./drive/safe-storage");
+var _constants = require("./constants");
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+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); }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 var generateUUIDCompat = exports.generateUUIDCompat = function generateUUIDCompat() {
   return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
     var r = Math.random() * 16 | 0;
@@ -12,11 +30,263 @@ var generateUUIDCompat = exports.generateUUIDCompat = function generateUUIDCompa
   });
 };
 var getDeviceId = exports.getDeviceId = function getDeviceId() {
-  var _localStorage, _localStorage2, _localStorage3;
-  if (localStorage.getItem('rlog-deviceId')) {
-    return localStorage.getItem('rlog-deviceId');
+  if (_safeStorage.safeStorage.getItem(_constants.STORAGE_KEY_DEVICE_ID)) {
+    return _safeStorage.safeStorage.getItem(_constants.STORAGE_KEY_DEVICE_ID);
   }
-  var newId = ((_localStorage = localStorage) === null || _localStorage === void 0 ? void 0 : _localStorage.getItem('utoken')) || ((_localStorage2 = localStorage) === null || _localStorage2 === void 0 ? void 0 : _localStorage2.getItem('IWP-iwp-deivceTag')) || generateUUIDCompat();
-  (_localStorage3 = localStorage) === null || _localStorage3 === void 0 || _localStorage3.setItem('rlog-deviceId', newId);
+  var newId = _safeStorage.safeStorage.getItem(_constants.STORAGE_KEY_UTOKEN) || _safeStorage.safeStorage.getItem(_constants.STORAGE_KEY_IWP_DEVICE_TAG) || generateUUIDCompat();
+  _safeStorage.safeStorage.setItem(_constants.STORAGE_KEY_DEVICE_ID, newId);
   return newId;
+};
+
+// ==================== Session 隔离 ====================
+
+/**
+ * 当前标签页的 sessionId（内存中，每次页面加载生成新的）
+ * 用于隔离同域下多个标签页的录制数据
+ */
+var currentSessionId = null;
+
+/**
+ * session 注册表的存储 key
+ * 注册表结构: { [sessionId]: timestamp }
+ */
+var SESSION_REGISTRY_KEY = _constants.STORAGE_KEY_SESSION_REGISTRY;
+
+/**
+ * session 过期时间（1小时）
+ * 超过此时间的 session 数据将在下次 SDK 初始化时被清理
+ */
+// SESSION_MAX_AGE 已从 constants.ts 导入
+
+/**
+ * 获取当前标签页的 sessionId
+ * 首次调用时自动生成并注册
+ */
+var getSessionId = exports.getSessionId = function getSessionId() {
+  if (!currentSessionId) {
+    currentSessionId = generateUUIDCompat();
+    registerSession(currentSessionId);
+  }
+  return currentSessionId;
+};
+
+/**
+ * 获取存储用的复合键（deviceId_sessionId）
+ * 用于替代原来单独使用 deviceId 作为存储分区键
+ * 确保多标签页的录制数据互相隔离
+ */
+var getStorageKey = exports.getStorageKey = function getStorageKey() {
+  return "".concat(getDeviceId(), "_").concat(getSessionId());
+};
+
+/**
+ * 将 sessionId 注册到注册表中
+ */
+function registerSession(sessionId) {
+  try {
+    var registry = JSON.parse(_safeStorage.safeStorage.getItem(SESSION_REGISTRY_KEY) || '{}');
+    registry[sessionId] = Date.now();
+    _safeStorage.safeStorage.setItem(SESSION_REGISTRY_KEY, JSON.stringify(registry));
+  } catch (e) {
+    // 解析失败时静默忽略
+  }
+}
+
+/**
+ * 从注册表中移除指定 sessionId
+ */
+function unregisterSession(sessionId) {
+  try {
+    var registry = JSON.parse(_safeStorage.safeStorage.getItem(SESSION_REGISTRY_KEY) || '{}');
+    delete registry[sessionId];
+    _safeStorage.safeStorage.setItem(SESSION_REGISTRY_KEY, JSON.stringify(registry));
+  } catch (e) {
+    // 解析失败时静默忽略
+  }
+}
+
+/**
+ * 清理过期的 session 数据
+ * 在 SDK 初始化时调用，扫描注册表中超过 SESSION_MAX_AGE 的 session，
+ * 删除其对应的存储数据和锁，并从注册表中移除
+ */
+function cleanupStaleSessions() {
+  try {
+    var registry = JSON.parse(_safeStorage.safeStorage.getItem(SESSION_REGISTRY_KEY) || '{}');
+    var now = Date.now();
+    var deviceId = getDeviceId();
+    var changed = false;
+    for (var _i = 0, _Object$keys = Object.keys(registry); _i < _Object$keys.length; _i++) {
+      var sessionId = _Object$keys[_i];
+      var createdAt = registry[sessionId];
+      if (now - createdAt > _constants.SESSION_MAX_AGE) {
+        // 清理该 session 对应的存储数据和锁
+        var storageKey = "".concat(_constants.STORAGE_KEY_DATA_PREFIX).concat(deviceId, "_").concat(sessionId);
+        var lockKey = "".concat(_constants.STORAGE_KEY_LOCK_PREFIX).concat(deviceId, "_").concat(sessionId);
+        _safeStorage.safeStorage.removeItem(storageKey);
+        _safeStorage.safeStorage.removeItem(lockKey);
+        delete registry[sessionId];
+        changed = true;
+      }
+    }
+    if (changed) {
+      _safeStorage.safeStorage.setItem(SESSION_REGISTRY_KEY, JSON.stringify(registry));
+    }
+  } catch (e) {
+    // 解析失败时静默忽略
+  }
+}
+
+// ==================== 孤儿 Session 残留数据扫描 ====================
+
+/**
+ * 孤儿 session 数据的最大有效时间跨度（默认 2 分钟）
+ * 只有数据时间跨度在此范围内的才被视为"上传周期内的残留数据"，
+ * 超过此范围的可能是其他无关项目或异常数据，不予上传
+ */
+// ORPHAN_DATA_MAX_SPAN 已从 constants.ts 导入
+
+/**
+ * 孤儿 session 数据的最大年龄（默认 5 分钟）
+ * 只有 session 注册时间在此范围内的才被视为"近期的残留数据"，
+ * 超过此范围的可能是长时间未清理的旧数据
+ */
+// ORPHAN_SESSION_MAX_AGE 已从 constants.ts 导入
+
+/**
+ * 孤儿 session 信息
+ */
+
+/**
+ * 获取所有孤儿 session（注册表中存在但不属于当前标签页的 session）
+ * 仅返回近期的、可能包含残留数据的 session
+ *
+ * 判断条件：
+ * 1. 不是当前标签页的 sessionId
+ * 2. session 注册时间在 ORPHAN_SESSION_MAX_AGE 范围内（排除过老的数据）
+ * 3. 对应的 localStorage 中确实存在数据
+ */
+function getOrphanSessions() {
+  try {
+    var registry = JSON.parse(_safeStorage.safeStorage.getItem(SESSION_REGISTRY_KEY) || '{}');
+    var now = Date.now();
+    var deviceId = getDeviceId();
+    var mySessionId = getSessionId();
+    var orphans = [];
+    for (var _i2 = 0, _Object$keys2 = Object.keys(registry); _i2 < _Object$keys2.length; _i2++) {
+      var sessionId = _Object$keys2[_i2];
+      // 跳过当前标签页的 session
+      if (sessionId === mySessionId) continue;
+      var createdAt = registry[sessionId];
+
+      // 跳过过期的 session（由 cleanupStaleSessions 处理）
+      if (now - createdAt > _constants.SESSION_MAX_AGE) continue;
+
+      // 只处理近期的 session（ORPHAN_SESSION_MAX_AGE 范围内）
+      if (now - createdAt > _constants.ORPHAN_SESSION_MAX_AGE) continue;
+      var storageKey = "".concat(deviceId, "_").concat(sessionId);
+      var dataKey = "".concat(_constants.STORAGE_KEY_DATA_PREFIX).concat(storageKey);
+
+      // 检查是否有残留数据
+      var rawData = _safeStorage.safeStorage.getItem(dataKey);
+      if (!rawData || rawData === '[]') continue;
+      orphans.push({
+        sessionId: sessionId,
+        storageKey: storageKey
+      });
+    }
+    return orphans;
+  } catch (e) {
+    return [];
+  }
+}
+
+/**
+ * 检查孤儿 session 的数据是否在合理的时间跨度内
+ * 用于过滤掉可能是其他无关项目或异常的数据
+ *
+ * @param events 事件数组
+ * @returns 是否在合理范围内
+ */
+function isOrphanDataValid(events) {
+  if (!events || events.length === 0) return false;
+
+  // 找到最早和最晚的事件时间戳
+  var minTime = Infinity;
+  var maxTime = -Infinity;
+  var _iterator = _createForOfIteratorHelper(events),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var event = _step.value;
+      if (event && typeof event.timestamp === 'number') {
+        if (event.timestamp < minTime) minTime = event.timestamp;
+        if (event.timestamp > maxTime) maxTime = event.timestamp;
+      }
+    }
+
+    // 如果没有有效的时间戳，不上传
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  if (minTime === Infinity || maxTime === -Infinity) return false;
+
+  // 检查数据时间跨度是否在合理范围内
+  var span = maxTime - minTime;
+  if (span > _constants.ORPHAN_DATA_MAX_SPAN) return false;
+
+  // 检查数据是否太旧（最新事件距今超过 ORPHAN_SESSION_MAX_AGE）
+  var now = Date.now();
+  if (now - maxTime > _constants.ORPHAN_SESSION_MAX_AGE) return false;
+  return true;
+}
+
+/**
+ * 清理指定孤儿 session 的数据和注册信息
+ */
+function cleanupOrphanSession(sessionId) {
+  try {
+    var deviceId = getDeviceId();
+    var storageKey = "".concat(_constants.STORAGE_KEY_DATA_PREFIX).concat(deviceId, "_").concat(sessionId);
+    var lockKey = "".concat(_constants.STORAGE_KEY_LOCK_PREFIX).concat(deviceId, "_").concat(sessionId);
+    _safeStorage.safeStorage.removeItem(storageKey);
+    _safeStorage.safeStorage.removeItem(lockKey);
+    unregisterSession(sessionId);
+  } catch (e) {
+    // 静默忽略
+  }
+}
+
+/**
+ * 检查值是否为纯对象（非数组、非null）
+ */
+var isPlainObject = exports.isPlainObject = function isPlainObject(value) {
+  return value !== null && _typeof(value) === 'object' && !Array.isArray(value);
+};
+
+/**
+ * 深度合并配置对象
+ * @param target 目标配置（默认配置）
+ * @param source 源配置（新配置）
+ * @returns 合并后的配置
+ */
+var deepMergeConfig = exports.deepMergeConfig = function deepMergeConfig(target, source) {
+  var result = _objectSpread({}, target);
+  for (var key in source) {
+    if (source.hasOwnProperty(key)) {
+      var sourceValue = source[key];
+      var targetValue = target[key];
+
+      // 如果两个值都是纯对象，则递归合并
+      if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
+        result[key] = deepMergeConfig(targetValue, sourceValue);
+      } else if (sourceValue !== undefined) {
+        // 其他情况（包括数组、基本类型、null）直接覆盖
+        result[key] = sourceValue;
+      }
+    }
+  }
+  return result;
 };