@antglobal/rlog-sdk 0.0.1755855517-dev.14 → 0.0.1755855517-dev.16

package/dist/esm/index.d.ts

@@ -24,6 +24,8 @@ declare function reportError(error: Error | string): void;
 declare const debug: {
     getStorageAdapterType(): string;
     getDeviceId: () => string;
+    getSessionId: () => string;
+    getStorageKey: () => string;
     resetUploadState: typeof forceResetUploadState;
     getStorageState(): Promise<{
         adapterType: string;

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAgB,SAAS,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AAGnE,KAAK,MAAM,GAAG;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,iBAAS,IAAI,CAAC,KAAK,EAAE,MAAM;uBAIL;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;EAI5C;AAED,iBAAS,YAAY,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,QAK1D;AAED,iBAAS,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAEpD;AAED,iBAAS,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGjD;AAED,iBAAS,iBAAiB,IAAI,OAAO,CAKpC;AAED,iBAAS,qBAAqB,IAAI,OAAO,CAIxC;AAED,iBAAS,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAyBhD;AAED,QAAA,MAAM,KAAK;6BACgB,MAAM;;;;;;;;;;CAehC,CAAC;AAGF,OAAO,EAEL,IAAI,EACJ,YAAY,EAEZ,cAAc,EAEd,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EAErB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EAEjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAEjB,WAAW,EACX,mBAAmB,EAEnB,KAAK,GACN,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAgB,SAAS,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAmB,MAAM,aAAa,CAAC;AAQnE,KAAK,MAAM,GAAG;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,iBAAS,IAAI,CAAC,KAAK,EAAE,MAAM;uBAIL;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE;EAI5C;AAED,iBAAS,YAAY,CAAC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,QAK1D;AAED,iBAAS,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAEpD;AAED,iBAAS,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAGjD;AAED,iBAAS,iBAAiB,IAAI,OAAO,CAKpC;AAED,iBAAS,qBAAqB,IAAI,OAAO,CAIxC;AAED,iBAAS,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAyBhD;AAED,QAAA,MAAM,KAAK;6BACgB,MAAM;;;;;;;;;;;;CAiBhC,CAAC;AAGF,OAAO,EAEL,IAAI,EACJ,YAAY,EAEZ,cAAc,EAEd,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EAErB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EAEjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EAEjB,WAAW,EACX,mBAAmB,EAEnB,KAAK,GACN,CAAC"}

package/dist/esm/index.js

@@ -6,12 +6,13 @@ import { initRLog, cancelRlog } from "./lib/init";
 import { setCustomHeaders, getCustomHeaders, setWhiteListUrls, setBlackListUrls, getBlackListUrls, getSdkLogEndpoint, getWhiteListUrls, shouldRecordUrl } from "./lib/net";
 import { record } from 'rrweb';
 import { storage } from "./lib/storage-manager";
-import { getDeviceId } from "./lib/utils";
+import { getDeviceId, getSessionId, getStorageKey } from "./lib/utils";
 import { forceResetUploadState } from "./lib/uploader";
 import { updateRouterConfig, getCurrentRouteInfo, manualRouteChange, stopRouterMonitor } from "./lib/router-monitor";
 import { updateConfig, getConfig } from "./lib/config";
 import { cleanupErrorHandler, getErrorTrigger } from "./lib/error";
 import logger from "./lib/logger";
+import { STORAGE_KEY_CONSUME_ONLY, STORAGE_VALUE_CONSUME_ONLY, EVENT_CUSTOM_ERROR } from "./lib/constants";
 function init(param) {
   initRLog(param.serv, param.appId, param.cdnConfigUrl);
   return {
@@ -36,7 +37,7 @@ function setConsumeOnlyMode(enable) {
   logger.log("Consume only mode ".concat(enable ? 'enabled' : 'disabled'));
 }
 function isConsumeOnlyMode() {
-  return sessionStorage.getItem('RLOG_CONSUME_ONLY') === 'YES' || !!getConfig().consumeOnly;
+  return sessionStorage.getItem(STORAGE_KEY_CONSUME_ONLY) === STORAGE_VALUE_CONSUME_ONLY || !!getConfig().consumeOnly;
 }
 function toggleConsumeOnlyMode() {
   var newMode = !getConfig().consumeOnly;
@@ -47,7 +48,7 @@ function reportError(error) {
   var message = typeof error === 'string' ? error : error.message;
   var stack = _typeof(error) === 'object' && error.stack ? error.stack : undefined;
   try {
-    record.addCustomEvent('custom-error-event', {
+    record.addCustomEvent(EVENT_CUSTOM_ERROR, {
       type: 'CUSTOM_ERROR',
       message: message,
       stack: stack,
@@ -74,15 +75,17 @@ var debug = {
     return storage.getAdapterType();
   },
   getDeviceId: getDeviceId,
+  getSessionId: getSessionId,
+  getStorageKey: getStorageKey,
   resetUploadState: forceResetUploadState,
   getStorageState: function getStorageState() {
     return _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
-      var deviceId;
+      var storageKey;
       return _regeneratorRuntime().wrap(function _callee$(_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
-            deviceId = getDeviceId();
-            return _context.abrupt("return", storage.getStorageState(deviceId));
+            storageKey = getStorageKey();
+            return _context.abrupt("return", storage.getStorageState(storageKey));
           case 2:
           case "end":
             return _context.stop();
@@ -92,12 +95,12 @@ var debug = {
   },
   clearStorage: function clearStorage() {
     return _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
-      var deviceId;
+      var storageKey;
       return _regeneratorRuntime().wrap(function _callee2$(_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
-            deviceId = getDeviceId();
-            return _context2.abrupt("return", storage.clear(deviceId));
+            storageKey = getStorageKey();
+            return _context2.abrupt("return", storage.clear(storageKey));
           case 2:
           case "end":
             return _context2.stop();

package/dist/esm/lib/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/lib/api.ts"],"names":[],"mappings":"AAKA,KAAK,aAAa,GAAG;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAqBF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,GAAG,EAAE,CAAC;CACb,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBzB;AAED,eAAO,MAAM,MAAM,QAAe,aAAa,kBAsC9C,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/lib/api.ts"],"names":[],"mappings":"AASA,KAAK,aAAa,GAAG;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAqBF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,GAAG,EAAE,CAAC;CACb,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBzB;AAED,eAAO,MAAM,MAAM,QAAe,aAAa,kBAsC9C,CAAC"}

package/dist/esm/lib/api.js

@@ -6,22 +6,23 @@ import { generateUUIDCompat } from "./utils";
 import { post } from "./request";
 import { getConfig } from "./config";
 import { getCustomHeaders } from "./net";
+import { STORAGE_KEY_URL_PARAM_PREFIX, DEFAULT_URL_PARAMS_TO_CACHE } from "./constants";
 // 从URL中提取指定参数并存储到sessionStorage中
 var cacheUrlParams = function cacheUrlParams() {
   var config = getConfig();
-  var paramsToCache = config.urlParamsToCache || ['taskId']; // 默认缓存taskId
+  var paramsToCache = config.urlParamsToCache || DEFAULT_URL_PARAMS_TO_CACHE;
   var urlParams = new URLSearchParams(window.location.search);
   paramsToCache.forEach(function (paramName) {
     var paramValue = urlParams.get(paramName);
     if (paramValue) {
-      sessionStorage.setItem("rlog-".concat(paramName), paramValue);
+      sessionStorage.setItem("".concat(STORAGE_KEY_URL_PARAM_PREFIX).concat(paramName), paramValue);
     }
   });
 };
 
 // 获取缓存的参数值
 var getCachedParam = function getCachedParam(paramName) {
-  return sessionStorage.getItem("rlog-".concat(paramName));
+  return sessionStorage.getItem("".concat(STORAGE_KEY_URL_PARAM_PREFIX).concat(paramName));
 };
 
 /**
@@ -43,7 +44,7 @@ export function buildQueryParams(opts) {
 
   // 从配置中获取需要上报的参数名称列表
   var config = getConfig();
-  var paramsToReport = config.urlParamsToCache || ['taskId']; // 默认上报taskId
+  var paramsToReport = config.urlParamsToCache || DEFAULT_URL_PARAMS_TO_CACHE;
 
   // 添加缓存的参数到查询字符串中
   paramsToReport.forEach(function (paramName) {

package/dist/esm/lib/constants.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Rlog SDK 全局常量定义
+ *
+ * 集中管理项目中所有硬编码的常量值，便于统一维护和修改。
+ * 按功能领域分组，每个常量都附带用途说明。
+ */
+/** 设备 ID 的 localStorage 存储键 */
+export declare const STORAGE_KEY_DEVICE_ID = "rlog-deviceId";
+/** 旧版设备标识 key（兼容迁移） */
+export declare const STORAGE_KEY_UTOKEN = "utoken";
+/** IWP 设备标识 key（兼容迁移） */
+export declare const STORAGE_KEY_IWP_DEVICE_TAG = "IWP-iwp-deivceTag";
+/** URL 参数缓存到 sessionStorage 的前缀 */
+export declare const STORAGE_KEY_URL_PARAM_PREFIX = "rlog-";
+/** Session 注册表的 localStorage 存储键 */
+export declare const STORAGE_KEY_SESSION_REGISTRY = "rlog_sessions";
+/** 录制数据存储键前缀 */
+export declare const STORAGE_KEY_DATA_PREFIX = "rlog_data_";
+/** 分布式锁存储键前缀 */
+export declare const STORAGE_KEY_LOCK_PREFIX = "rlog_lock_";
+/** 只采集不上报模式的 sessionStorage 标识键 */
+export declare const STORAGE_KEY_CONSUME_ONLY = "RLOG_CONSUME_ONLY";
+/** 只采集不上报模式的 sessionStorage 标识值 */
+export declare const STORAGE_VALUE_CONSUME_ONLY = "YES";
+/** localStorage 可用性测试键（StorageManager） */
+export declare const STORAGE_TEST_KEY = "__rlog_storage_test__";
+/** localStorage 可用性测试键（SafeStorage） */
+export declare const SAFE_STORAGE_TEST_KEY = "__rlog_safe_storage_test__";
+/** Session 过期时间：1 小时。超过此时间的 session 数据将在下次 SDK 初始化时被清理 */
+export declare const SESSION_MAX_AGE: number;
+/** 孤儿 session 数据的最大有效时间跨度：2 分钟。只有数据时间跨度在此范围内的才被视为"上传周期内的残留数据" */
+export declare const ORPHAN_DATA_MAX_SPAN: number;
+/** 孤儿 session 数据的最大年龄：5 分钟。只有 session 注册时间在此范围内的才被视为"近期的残留数据" */
+export declare const ORPHAN_SESSION_MAX_AGE: number;
+/** 分布式锁超时时间：5 秒 */
+export declare const LOCK_TIMEOUT = 5000;
+/** 分布式锁重试间隔：10 毫秒 */
+export declare const LOCK_RETRY_DELAY = 10;
+/** Worker 就绪超时时间：5 秒。超时后降级到主线程模式 */
+export declare const WORKER_READY_TIMEOUT = 5000;
+/** HTTP 请求默认超时时间：10 秒 */
+export declare const REQUEST_TIMEOUT = 10000;
+/** 上传锁冲突时的延迟重试间隔：100 毫秒 */
+export declare const UPLOAD_RETRY_DELAY = 100;
+/** 存储适配器最大事件存储量 */
+export declare const MAX_STORAGE_EVENTS = 10000;
+/** 分布式锁最大重试次数 */
+export declare const LOCK_MAX_RETRIES = 50;
+/** 全量模式每次拉取事件数量 */
+export declare const PULL_BATCH_SIZE = 100;
+/** 孤儿 session 数据拉取上限 */
+export declare const ORPHAN_PULL_LIMIT = 10000;
+/** 默认缓存的 URL 参数名称列表 */
+export declare const DEFAULT_URL_PARAMS_TO_CACHE: string[];
+/** 上传失败事件名称（CustomEvent + rrweb addCustomEvent） */
+export declare const EVENT_UPLOAD_FAILURE = "rlog-upload-failure";
+/** 自定义错误事件名称 */
+export declare const EVENT_CUSTOM_ERROR = "custom-error-event";
+/** HTTP 请求成功事件名称 */
+export declare const EVENT_HTTP_SUCCESS = "http-success";
+/** HTTP 请求失败事件名称 */
+export declare const EVENT_HTTP_ERROR = "http-error";
+/** 网络状态变化事件名称 */
+export declare const EVENT_NETWORK_STATUS = "network-status";
+/** 路由变化事件名称 */
+export declare const EVENT_ROUTE_CHANGE = "route-change";
+/** 页面生命周期事件名称 */
+export declare const EVENT_PAGE_LIFECYCLE = "page-lifecycle";
+/** 网络监控黑名单域名列表 */
+export declare const BLACK_HOST_NAME: string[];
+/** 网络监控黑名单路径列表 */
+export declare const BLACK_PATH_NAME: string[];
+/** 需要从响应中提取的 HTTP 头字段 */
+export declare const HEADERS_TO_EXTRACT: string[];
+/** 默认白名单 URL 列表（rrweb 录制时设置） */
+export declare const DEFAULT_WHITE_LIST_URLS: string[];
+/** 日志输出统一前缀 */
+export declare const LOG_PREFIX = "[Rlog]";
+/** IndexedDB 数据库名称 */
+export declare const IDB_DB_NAME = "LogStorageDB";
+/** IndexedDB 对象存储名称 */
+export declare const IDB_STORE_NAME = "logs";
+/** IndexedDB 数据库版本号 */
+export declare const IDB_VERSION = 2;
+/** 图片导出格式 */
+export declare const CANVAS_EXPORT_TYPE = "image/webp";
+/** 图片导出质量 */
+export declare const CANVAS_EXPORT_QUALITY = 0.6;
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,+BAA+B;AAC/B,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AAErD,uBAAuB;AACvB,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,yBAAyB;AACzB,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAE9D,mCAAmC;AACnC,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAEpD,oCAAoC;AACpC,eAAO,MAAM,4BAA4B,kBAAkB,CAAC;AAE5D,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,gBAAgB;AAChB,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAEpD,mCAAmC;AACnC,eAAO,MAAM,wBAAwB,sBAAsB,CAAC;AAE5D,mCAAmC;AACnC,eAAO,MAAM,0BAA0B,QAAQ,CAAC;AAEhD,0CAA0C;AAC1C,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD,uCAAuC;AACvC,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAIlE,0DAA0D;AAC1D,eAAO,MAAM,eAAe,QAAqB,CAAC;AAElD,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,QAAgB,CAAC;AAElD,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAEpD,mBAAmB;AACnB,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,qBAAqB;AACrB,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,oCAAoC;AACpC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,yBAAyB;AACzB,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,2BAA2B;AAC3B,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAItC,mBAAmB;AACnB,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,iBAAiB;AACjB,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,mBAAmB;AACnB,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,wBAAwB;AACxB,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,uBAAuB;AACvB,eAAO,MAAM,2BAA2B,UAAa,CAAC;AAItD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAE1D,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,oBAAoB;AACpB,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD,oBAAoB;AACpB,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C,iBAAiB;AACjB,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAErD,eAAe;AACf,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD,iBAAiB;AACjB,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AAIrD,kBAAkB;AAClB,eAAO,MAAM,eAAe,UAQ3B,CAAC;AAEF,kBAAkB;AAClB,eAAO,MAAM,eAAe,UAgB3B,CAAC;AAEF,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,UAAsC,CAAC;AAEtE,gCAAgC;AAChC,eAAO,MAAM,uBAAuB,UAEnC,CAAC;AAIF,eAAe;AACf,eAAO,MAAM,UAAU,WAAW,CAAC;AAInC,sBAAsB;AACtB,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAE1C,uBAAuB;AACvB,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC,uBAAuB;AACvB,eAAO,MAAM,WAAW,IAAI,CAAC;AAI7B,aAAa;AACb,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C,aAAa;AACb,eAAO,MAAM,qBAAqB,MAAM,CAAC"}

package/dist/esm/lib/constants.js

@@ -0,0 +1,145 @@
+/**
+ * Rlog SDK 全局常量定义
+ *
+ * 集中管理项目中所有硬编码的常量值，便于统一维护和修改。
+ * 按功能领域分组，每个常量都附带用途说明。
+ */
+
+// ==================== Storage Key 前缀与标识 ====================
+
+/** 设备 ID 的 localStorage 存储键 */
+export var STORAGE_KEY_DEVICE_ID = 'rlog-deviceId';
+
+/** 旧版设备标识 key（兼容迁移） */
+export var STORAGE_KEY_UTOKEN = 'utoken';
+
+/** IWP 设备标识 key（兼容迁移） */
+export var STORAGE_KEY_IWP_DEVICE_TAG = 'IWP-iwp-deivceTag';
+
+/** URL 参数缓存到 sessionStorage 的前缀 */
+export var STORAGE_KEY_URL_PARAM_PREFIX = 'rlog-';
+
+/** Session 注册表的 localStorage 存储键 */
+export var STORAGE_KEY_SESSION_REGISTRY = 'rlog_sessions';
+
+/** 录制数据存储键前缀 */
+export var STORAGE_KEY_DATA_PREFIX = 'rlog_data_';
+
+/** 分布式锁存储键前缀 */
+export var STORAGE_KEY_LOCK_PREFIX = 'rlog_lock_';
+
+/** 只采集不上报模式的 sessionStorage 标识键 */
+export var STORAGE_KEY_CONSUME_ONLY = 'RLOG_CONSUME_ONLY';
+
+/** 只采集不上报模式的 sessionStorage 标识值 */
+export var STORAGE_VALUE_CONSUME_ONLY = 'YES';
+
+/** localStorage 可用性测试键（StorageManager） */
+export var STORAGE_TEST_KEY = '__rlog_storage_test__';
+
+/** localStorage 可用性测试键（SafeStorage） */
+export var SAFE_STORAGE_TEST_KEY = '__rlog_safe_storage_test__';
+
+// ==================== 时间相关常量（毫秒） ====================
+
+/** Session 过期时间：1 小时。超过此时间的 session 数据将在下次 SDK 初始化时被清理 */
+export var SESSION_MAX_AGE = 1 * 60 * 60 * 1000;
+
+/** 孤儿 session 数据的最大有效时间跨度：2 分钟。只有数据时间跨度在此范围内的才被视为"上传周期内的残留数据" */
+export var ORPHAN_DATA_MAX_SPAN = 2 * 60 * 1000;
+
+/** 孤儿 session 数据的最大年龄：5 分钟。只有 session 注册时间在此范围内的才被视为"近期的残留数据" */
+export var ORPHAN_SESSION_MAX_AGE = 5 * 60 * 1000;
+
+/** 分布式锁超时时间：5 秒 */
+export var LOCK_TIMEOUT = 5000;
+
+/** 分布式锁重试间隔：10 毫秒 */
+export var LOCK_RETRY_DELAY = 10;
+
+/** Worker 就绪超时时间：5 秒。超时后降级到主线程模式 */
+export var WORKER_READY_TIMEOUT = 5000;
+
+/** HTTP 请求默认超时时间：10 秒 */
+export var REQUEST_TIMEOUT = 10000;
+
+/** 上传锁冲突时的延迟重试间隔：100 毫秒 */
+export var UPLOAD_RETRY_DELAY = 100;
+
+// ==================== 容量与限制 ====================
+
+/** 存储适配器最大事件存储量 */
+export var MAX_STORAGE_EVENTS = 10000;
+
+/** 分布式锁最大重试次数 */
+export var LOCK_MAX_RETRIES = 50;
+
+/** 全量模式每次拉取事件数量 */
+export var PULL_BATCH_SIZE = 100;
+
+/** 孤儿 session 数据拉取上限 */
+export var ORPHAN_PULL_LIMIT = 10000;
+
+/** 默认缓存的 URL 参数名称列表 */
+export var DEFAULT_URL_PARAMS_TO_CACHE = ['taskId'];
+
+// ==================== 自定义事件名称 ====================
+
+/** 上传失败事件名称（CustomEvent + rrweb addCustomEvent） */
+export var EVENT_UPLOAD_FAILURE = 'rlog-upload-failure';
+
+/** 自定义错误事件名称 */
+export var EVENT_CUSTOM_ERROR = 'custom-error-event';
+
+/** HTTP 请求成功事件名称 */
+export var EVENT_HTTP_SUCCESS = 'http-success';
+
+/** HTTP 请求失败事件名称 */
+export var EVENT_HTTP_ERROR = 'http-error';
+
+/** 网络状态变化事件名称 */
+export var EVENT_NETWORK_STATUS = 'network-status';
+
+/** 路由变化事件名称 */
+export var EVENT_ROUTE_CHANGE = 'route-change';
+
+/** 页面生命周期事件名称 */
+export var EVENT_PAGE_LIFECYCLE = 'page-lifecycle';
+
+// ==================== 网络监控常量 ====================
+
+/** 网络监控黑名单域名列表 */
+export var BLACK_HOST_NAME = ['arms', 'log', 'marmot-cloud.com', 'alipayobjects.com', 'renderpre.alipay.com', 'nemo-office.alipay.com', 'render.alipay.com'];
+
+/** 网络监控黑名单路径列表 */
+export var BLACK_PATH_NAME = ['r.png', 'dwcookieLogGet.do', 'track', 'spm', 'logstores', 'render', '.json', '.js', '.css', '.wasm', '.png', '.jpg', '.jpeg', '.weapp', '.data'];
+
+/** 需要从响应中提取的 HTTP 头字段 */
+export var HEADERS_TO_EXTRACT = ['sky_trace_id', 'antbank-traceid'];
+
+/** 默认白名单 URL 列表（rrweb 录制时设置） */
+export var DEFAULT_WHITE_LIST_URLS = ['http://alipay-rmsdeploy-image.cn-hangzhou.alipay.aliyun-inc.com'];
+
+// ==================== 日志常量 ====================
+
+/** 日志输出统一前缀 */
+export var LOG_PREFIX = '[Rlog]';
+
+// ==================== IndexedDB 常量 ====================
+
+/** IndexedDB 数据库名称 */
+export var IDB_DB_NAME = 'LogStorageDB';
+
+/** IndexedDB 对象存储名称 */
+export var IDB_STORE_NAME = 'logs';
+
+/** IndexedDB 数据库版本号 */
+export var IDB_VERSION = 2;
+
+// ==================== rrweb 录制默认配置 ====================
+
+/** 图片导出格式 */
+export var CANVAS_EXPORT_TYPE = 'image/webp';
+
+/** 图片导出质量 */
+export var CANVAS_EXPORT_QUALITY = 0.6;

package/dist/esm/lib/drive/indexeddb-adapt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexeddb-adapt.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/indexeddb-adapt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAcrD,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAA8B;;YAMnC,MAAM;YAqDN,QAAQ;YAUR,eAAe;IAwBvB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAgChD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCnD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC1D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAsCtD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,EAAE,CAAC;IAwBjB;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAiC5E"}
+{"version":3,"file":"indexeddb-adapt.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/indexeddb-adapt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAoBrD,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAA8B;;YAMnC,MAAM;YAqDN,QAAQ;YAUR,eAAe;IAwBvB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAgChD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCnD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC1D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAsCtD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,EAAE,CAAC;IAwBjB;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAiC5E"}

package/dist/esm/lib/drive/indexeddb-adapt.js

@@ -15,10 +15,10 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 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); }
 import logger from "../logger";
-var DB_NAME = 'LogStorageDB';
-var STORE_NAME = 'logs';
-var VERSION = 2; // 升级版本号以触发数据库升级
-
+import { IDB_DB_NAME, IDB_STORE_NAME, IDB_VERSION, MAX_STORAGE_EVENTS } from "../constants";
+var DB_NAME = IDB_DB_NAME;
+var STORE_NAME = IDB_STORE_NAME;
+var VERSION = IDB_VERSION;
 export var IndexedDBAdapter = /*#__PURE__*/function () {
   function IndexedDBAdapter() {
     _classCallCheck(this, IndexedDBAdapter);
@@ -199,8 +199,8 @@ export var IndexedDBAdapter = /*#__PURE__*/function () {
                             record.version = (record.version || 1) + 1;
 
                             // 限制最大存储量
-                            if (record.data.length > 10000) {
-                              record.data.splice(0, record.data.length - 10000);
+                            if (record.data.length > MAX_STORAGE_EVENTS) {
+                              record.data.splice(0, record.data.length - MAX_STORAGE_EVENTS);
                             }
                             var putRequest = store.put(record);
                             putRequest.onsuccess = function () {
@@ -261,8 +261,8 @@ export var IndexedDBAdapter = /*#__PURE__*/function () {
                             record.version = (record.version || 1) + 1;
 
                             // 限制最大存储量
-                            if (record.data.length > 10000) {
-                              record.data.splice(0, record.data.length - 10000);
+                            if (record.data.length > MAX_STORAGE_EVENTS) {
+                              record.data.splice(0, record.data.length - MAX_STORAGE_EVENTS);
                             }
                             var putRequest = store.put(record);
                             putRequest.onsuccess = function () {
@@ -324,8 +324,8 @@ export var IndexedDBAdapter = /*#__PURE__*/function () {
                             record.version = (record.version || 1) + 1;
 
                             // 限制最大存储量
-                            if (record.data.length > 10000) {
-                              record.data.splice(0, record.data.length - 10000);
+                            if (record.data.length > MAX_STORAGE_EVENTS) {
+                              record.data.splice(0, record.data.length - MAX_STORAGE_EVENTS);
                             }
                             var putRequest = store.put(record);
                             putRequest.onsuccess = function () {

package/dist/esm/lib/drive/localstorage-adapt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localstorage-adapt.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/localstorage-adapt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAgB;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAgB;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAQ;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAM;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAM;IAEzC;;OAEG;YACW,WAAW;IA8BzB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;YACW,QAAQ;IAuBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIf,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IA8BtD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,EAAE,CAAC;IAgBjB;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB5E"}
+{"version":3,"file":"localstorage-adapt.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/localstorage-adapt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAWrD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAA2B;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAA2B;IACrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAgB;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAoB;IACvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAEvD;;OAEG;YACW,WAAW;IA8BzB;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;YACW,QAAQ;IAuBtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIf,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBhD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IA8BtD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,EAAE,CAAC;IAgBjB;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB5E"}

package/dist/esm/lib/drive/localstorage-adapt.js

@@ -20,6 +20,7 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 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); }
 import { MemoryAdapter } from "./memory-adapt";
 import logger from "../logger";
+import { STORAGE_KEY_LOCK_PREFIX, STORAGE_KEY_DATA_PREFIX, LOCK_TIMEOUT, LOCK_RETRY_DELAY, LOCK_MAX_RETRIES, MAX_STORAGE_EVENTS } from "../constants";
 
 /**
  * 使用锁机制解决localStorage多标签并发问题
@@ -30,7 +31,7 @@ export var LocalStorageAdapter = /*#__PURE__*/function () {
   }
   _createClass(LocalStorageAdapter, [{
     key: "acquireLock",
-    value: // 最多重试50次
+    value: (
     /**
      * 获取分布式锁
      */
@@ -86,6 +87,7 @@ export var LocalStorageAdapter = /*#__PURE__*/function () {
     /**
      * 释放分布式锁
      */
+    )
   }, {
     key: "releaseLock",
     value: function releaseLock(deviceId) {
@@ -183,8 +185,8 @@ export var LocalStorageAdapter = /*#__PURE__*/function () {
                       list.push(data);
 
                       // 限制最大存储量，防止内存溢出
-                      if (list.length > 10000) {
-                        list.splice(0, list.length - 10000);
+                      if (list.length > MAX_STORAGE_EVENTS) {
+                        list.splice(0, list.length - MAX_STORAGE_EVENTS);
                       }
                       localStorage.setItem(key, JSON.stringify(list));
                     case 6:
@@ -233,8 +235,8 @@ export var LocalStorageAdapter = /*#__PURE__*/function () {
                       list.unshift(data);
 
                       // 限制最大存储量
-                      if (list.length > 10000) {
-                        list.splice(0, list.length - 10000);
+                      if (list.length > MAX_STORAGE_EVENTS) {
+                        list.splice(0, list.length - MAX_STORAGE_EVENTS);
                       }
                       localStorage.setItem(key, JSON.stringify(list));
                     case 6:
@@ -283,8 +285,8 @@ export var LocalStorageAdapter = /*#__PURE__*/function () {
                       list.unshift.apply(list, _toConsumableArray(data));
 
                       // 限制最大存储量
-                      if (list.length > 10000) {
-                        list.splice(0, list.length - 10000);
+                      if (list.length > MAX_STORAGE_EVENTS) {
+                        list.splice(0, list.length - MAX_STORAGE_EVENTS);
                       }
                       localStorage.setItem(key, JSON.stringify(list));
                     case 6:
@@ -514,10 +516,8 @@ export var LocalStorageAdapter = /*#__PURE__*/function () {
   }]);
   return LocalStorageAdapter;
 }();
-_defineProperty(LocalStorageAdapter, "LOCK_KEY_PREFIX", 'rlog_lock_');
-_defineProperty(LocalStorageAdapter, "STORAGE_KEY_PREFIX", 'rlog_data_');
-_defineProperty(LocalStorageAdapter, "LOCK_TIMEOUT", 5000);
-// 5秒超时
-_defineProperty(LocalStorageAdapter, "RETRY_DELAY", 10);
-// 10ms重试间隔
-_defineProperty(LocalStorageAdapter, "MAX_RETRIES", 50);
+_defineProperty(LocalStorageAdapter, "LOCK_KEY_PREFIX", STORAGE_KEY_LOCK_PREFIX);
+_defineProperty(LocalStorageAdapter, "STORAGE_KEY_PREFIX", STORAGE_KEY_DATA_PREFIX);
+_defineProperty(LocalStorageAdapter, "LOCK_TIMEOUT", LOCK_TIMEOUT);
+_defineProperty(LocalStorageAdapter, "RETRY_DELAY", LOCK_RETRY_DELAY);
+_defineProperty(LocalStorageAdapter, "MAX_RETRIES", LOCK_MAX_RETRIES);

package/dist/esm/lib/drive/memory-adapt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-adapt.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/memory-adapt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,KAAK,CAAyC;IAEtD,OAAO;WAEO,WAAW,IAAI,aAAa;IAO1C;;OAEG;YACW,WAAW;IAuBnB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IA2BtD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,EAAE,CAAC;IAajB;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB5E"}
+{"version":3,"file":"memory-adapt.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/memory-adapt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;GAEG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAgB;IACvC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,KAAK,CAAyC;IAEtD,OAAO;WAEO,WAAW,IAAI,aAAa;IAO1C;;OAEG;YACW,WAAW;IAuBnB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBhD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IA2BtD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;IACG,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,EAAE,CAAC;IAajB;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB5E"}

package/dist/esm/lib/drive/memory-adapt.js

@@ -14,6 +14,8 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 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); }
+import { MAX_STORAGE_EVENTS } from "../constants";
+
 /**
  * 线程安全的内存适配器
  */
@@ -89,8 +91,8 @@ export var MemoryAdapter = /*#__PURE__*/function () {
                 list.push(data);
 
                 // 限制最大存储量
-                if (list.length > 10000) {
-                  list.splice(0, list.length - 10000);
+                if (list.length > MAX_STORAGE_EVENTS) {
+                  list.splice(0, list.length - MAX_STORAGE_EVENTS);
                 }
               } finally {
                 release();
@@ -126,8 +128,8 @@ export var MemoryAdapter = /*#__PURE__*/function () {
                 list.unshift(data);
 
                 // 限制最大存储量
-                if (list.length > 10000) {
-                  list.splice(0, list.length - 10000);
+                if (list.length > MAX_STORAGE_EVENTS) {
+                  list.splice(0, list.length - MAX_STORAGE_EVENTS);
                 }
               } finally {
                 release();
@@ -163,8 +165,8 @@ export var MemoryAdapter = /*#__PURE__*/function () {
                 list.unshift.apply(list, _toConsumableArray(data));
 
                 // 限制最大存储量
-                if (list.length > 10000) {
-                  list.splice(0, list.length - 10000);
+                if (list.length > MAX_STORAGE_EVENTS) {
+                  list.splice(0, list.length - MAX_STORAGE_EVENTS);
                 }
               } finally {
                 release();

package/dist/esm/lib/drive/safe-storage.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 安全的 KV 存储工具
+ * 提供与 localStorage 相同的 getItem/setItem/removeItem 接口，
+ * 当 localStorage 不可用时自动降级到内存 Map 存储。
+ *
+ * 用途：给 utils.ts 中 deviceId、session 注册表等轻量 KV 场景使用，
+ * 避免直接裸调 localStorage 导致在隐私模式、iframe sandbox 等环境下抛异常。
+ */
+declare class SafeStorage {
+    private memoryFallback;
+    private useMemory;
+    constructor();
+    /**
+     * 检测 localStorage 是否可用
+     */
+    private isLocalStorageAvailable;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+}
+/** 单例导出 */
+export declare const safeStorage: SafeStorage;
+export {};
+//# sourceMappingURL=safe-storage.d.ts.map

package/dist/esm/lib/drive/safe-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-storage.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/safe-storage.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,cAAM,WAAW;IACf,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,SAAS,CAAS;;IAS1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAanC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAazC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAY9B;AAED,WAAW;AACX,eAAO,MAAM,WAAW,aAAoB,CAAC"}