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

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

@@ -18,8 +18,16 @@ export declare class MemoryAdapter implements StorageAdapter {
     pull(deviceId: string, length: number): Promise<any[]>;
     clear(deviceId: string): Promise<void>;
     /**
-     * 获取当前存储状态（调试用）
+     * 按时间范围提取事件（不移除）
      */
-    getStorageState(): Record<string, number>;
+    pullByTimeRange(deviceId: string, startTime: number, endTime: number): Promise<any[]>;
+    /**
+     * 按时间范围移除事件（移除 sinceTime 及之后的所有事件）
+     */
+    removeByTimeRange(deviceId: string, sinceTime: number): Promise<void>;
+    /**
+     * 获取存储的事件数量（非破坏性只读操作）
+     */
+    count(deviceId: string): Promise<number>;
 }
 //# sourceMappingURL=memory-adapt.d.ts.map

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;IACH,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAO1C"}
+{"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;IAqB1D,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;IAiB3E;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAU/C"}

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

@@ -1,10 +1,4 @@
 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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
-function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
-function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
-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; }
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
@@ -14,6 +8,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 +85,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 +122,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();
@@ -147,7 +143,7 @@ export var MemoryAdapter = /*#__PURE__*/function () {
     key: "unshiftBatch",
     value: function () {
       var _unshiftBatch = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee4(deviceId, data) {
-        var release, list;
+        var release, existing, merged;
         return _regeneratorRuntime().wrap(function _callee4$(_context4) {
           while (1) switch (_context4.prev = _context4.next) {
             case 0:
@@ -159,13 +155,12 @@ export var MemoryAdapter = /*#__PURE__*/function () {
                 if (!this.storage.has(deviceId)) {
                   this.storage.set(deviceId, []);
                 }
-                list = this.storage.get(deviceId);
-                list.unshift.apply(list, _toConsumableArray(data));
-
-                // 限制最大存储量
-                if (list.length > 10000) {
-                  list.splice(0, list.length - 10000);
+                existing = this.storage.get(deviceId);
+                merged = data.concat(existing); // 限制最大存储量
+                if (merged.length > MAX_STORAGE_EVENTS) {
+                  merged.splice(0, merged.length - MAX_STORAGE_EVENTS);
                 }
+                this.storage.set(deviceId, merged);
               } finally {
                 release();
               }
@@ -253,17 +248,114 @@ export var MemoryAdapter = /*#__PURE__*/function () {
       return clear;
     }()
     /**
-     * 获取当前存储状态（调试用）
+     * 按时间范围提取事件（不移除）
      */
   }, {
-    key: "getStorageState",
-    value: function getStorageState() {
-      var state = {};
-      this.storage.forEach(function (value, key) {
-        state[key] = value.length;
-      });
-      return state;
-    }
+    key: "pullByTimeRange",
+    value: (function () {
+      var _pullByTimeRange = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee7(deviceId, startTime, endTime) {
+        var release, data;
+        return _regeneratorRuntime().wrap(function _callee7$(_context7) {
+          while (1) switch (_context7.prev = _context7.next) {
+            case 0:
+              _context7.next = 2;
+              return this.acquireLock(deviceId);
+            case 2:
+              release = _context7.sent;
+              _context7.prev = 3;
+              data = this.storage.get(deviceId) || [];
+              return _context7.abrupt("return", data.filter(function (event) {
+                return event.timestamp >= startTime && event.timestamp <= endTime;
+              }));
+            case 6:
+              _context7.prev = 6;
+              release();
+              return _context7.finish(6);
+            case 9:
+            case "end":
+              return _context7.stop();
+          }
+        }, _callee7, this, [[3,, 6, 9]]);
+      }));
+      function pullByTimeRange(_x11, _x12, _x13) {
+        return _pullByTimeRange.apply(this, arguments);
+      }
+      return pullByTimeRange;
+    }()
+    /**
+     * 按时间范围移除事件（移除 sinceTime 及之后的所有事件）
+     */
+    )
+  }, {
+    key: "removeByTimeRange",
+    value: (function () {
+      var _removeByTimeRange = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee8(deviceId, sinceTime) {
+        var release, data, remaining;
+        return _regeneratorRuntime().wrap(function _callee8$(_context8) {
+          while (1) switch (_context8.prev = _context8.next) {
+            case 0:
+              _context8.next = 2;
+              return this.acquireLock(deviceId);
+            case 2:
+              release = _context8.sent;
+              try {
+                data = this.storage.get(deviceId) || []; // 保留 sinceTime 之前的事件
+                remaining = data.filter(function (e) {
+                  return e.timestamp < sinceTime;
+                });
+                if (remaining.length > 0) {
+                  this.storage.set(deviceId, remaining);
+                } else {
+                  this.storage.delete(deviceId);
+                }
+              } finally {
+                release();
+              }
+            case 4:
+            case "end":
+              return _context8.stop();
+          }
+        }, _callee8, this);
+      }));
+      function removeByTimeRange(_x14, _x15) {
+        return _removeByTimeRange.apply(this, arguments);
+      }
+      return removeByTimeRange;
+    }()
+    /**
+     * 获取存储的事件数量（非破坏性只读操作）
+     */
+    )
+  }, {
+    key: "count",
+    value: (function () {
+      var _count = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee9(deviceId) {
+        var release, data;
+        return _regeneratorRuntime().wrap(function _callee9$(_context9) {
+          while (1) switch (_context9.prev = _context9.next) {
+            case 0:
+              _context9.next = 2;
+              return this.acquireLock(deviceId);
+            case 2:
+              release = _context9.sent;
+              _context9.prev = 3;
+              data = this.storage.get(deviceId) || [];
+              return _context9.abrupt("return", data.length);
+            case 6:
+              _context9.prev = 6;
+              release();
+              return _context9.finish(6);
+            case 9:
+            case "end":
+              return _context9.stop();
+          }
+        }, _callee9, this, [[3,, 6, 9]]);
+      }));
+      function count(_x16) {
+        return _count.apply(this, arguments);
+      }
+      return count;
+    }())
   }], [{
     key: "getInstance",
     value: function getInstance() {

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"}

package/dist/esm/lib/drive/safe-storage.js

@@ -0,0 +1,96 @@
+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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+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 logger from "../logger";
+import { SAFE_STORAGE_TEST_KEY } from "../constants";
+
+/**
+ * 安全的 KV 存储工具
+ * 提供与 localStorage 相同的 getItem/setItem/removeItem 接口，
+ * 当 localStorage 不可用时自动降级到内存 Map 存储。
+ *
+ * 用途：给 utils.ts 中 deviceId、session 注册表等轻量 KV 场景使用，
+ * 避免直接裸调 localStorage 导致在隐私模式、iframe sandbox 等环境下抛异常。
+ */
+var SafeStorage = /*#__PURE__*/function () {
+  function SafeStorage() {
+    _classCallCheck(this, SafeStorage);
+    _defineProperty(this, "memoryFallback", new Map());
+    _defineProperty(this, "useMemory", false);
+    this.useMemory = !this.isLocalStorageAvailable();
+    if (this.useMemory) {
+      logger.warn('localStorage 不可用，SafeStorage 已降级为内存存储');
+    }
+  }
+
+  /**
+   * 检测 localStorage 是否可用
+   */
+  _createClass(SafeStorage, [{
+    key: "isLocalStorageAvailable",
+    value: function isLocalStorageAvailable() {
+      try {
+        if (typeof window === 'undefined' || !window.localStorage) {
+          return false;
+        }
+        var testKey = SAFE_STORAGE_TEST_KEY;
+        window.localStorage.setItem(testKey, '1');
+        window.localStorage.removeItem(testKey);
+        return true;
+      } catch (_unused) {
+        return false;
+      }
+    }
+  }, {
+    key: "getItem",
+    value: function getItem(key) {
+      if (this.useMemory) {
+        var _this$memoryFallback$;
+        return (_this$memoryFallback$ = this.memoryFallback.get(key)) !== null && _this$memoryFallback$ !== void 0 ? _this$memoryFallback$ : null;
+      }
+      try {
+        return localStorage.getItem(key);
+      } catch (_unused2) {
+        var _this$memoryFallback$2;
+        // 运行时突然不可用（如存储配额超限），降级到内存
+        this.useMemory = true;
+        return (_this$memoryFallback$2 = this.memoryFallback.get(key)) !== null && _this$memoryFallback$2 !== void 0 ? _this$memoryFallback$2 : null;
+      }
+    }
+  }, {
+    key: "setItem",
+    value: function setItem(key, value) {
+      if (this.useMemory) {
+        this.memoryFallback.set(key, value);
+        return;
+      }
+      try {
+        localStorage.setItem(key, value);
+      } catch (_unused3) {
+        this.useMemory = true;
+        this.memoryFallback.set(key, value);
+      }
+    }
+  }, {
+    key: "removeItem",
+    value: function removeItem(key) {
+      if (this.useMemory) {
+        this.memoryFallback.delete(key);
+        return;
+      }
+      try {
+        localStorage.removeItem(key);
+      } catch (_unused4) {
+        this.useMemory = true;
+        this.memoryFallback.delete(key);
+      }
+    }
+  }]);
+  return SafeStorage;
+}();
+/** 单例导出 */
+export var safeStorage = new SafeStorage();

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

@@ -4,5 +4,25 @@ export interface StorageAdapter {
     unshiftBatch(deviceId: string, data: any[]): Promise<void>;
     pull(deviceId: string, length: number): Promise<any[]>;
     clear?(deviceId: string): Promise<void>;
+    /**
+     * 按时间范围提取事件（用于 error 模式）
+     * @param deviceId 设备 ID
+     * @param startTime 起始时间戳（毫秒），包含
+     * @param endTime 结束时间戳（毫秒），包含
+     * @returns 时间范围内的事件数组
+     */
+    pullByTimeRange?(deviceId: string, startTime: number, endTime: number): Promise<any[]>;
+    /**
+     * 按时间范围移除事件（用于 error 模式）
+     * @param deviceId 设备 ID
+     * @param sinceTime 起始时间戳（毫秒），移除该时间点及之后的所有事件
+     */
+    removeByTimeRange?(deviceId: string, sinceTime: number): Promise<void>;
+    /**
+     * 获取存储的事件数量（非破坏性只读操作）
+     * @param deviceId 设备 ID
+     * @returns 事件数量
+     */
+    count?(deviceId: string): Promise<number>;
 }
 //# sourceMappingURL=storage-interface.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storage-interface.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/storage-interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}
+{"version":3,"file":"storage-interface.d.ts","sourceRoot":"","sources":["../../../../src/lib/drive/storage-interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,KAAK,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;OAMG;IACH,eAAe,CAAC,CACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAElB;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvE;;;;OAIG;IACH,KAAK,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C"}

package/dist/esm/lib/error-trigger.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 错误触发与状态管理
+ *
+ * 状态机：
+ *   idle  →  错误触发  →  uploading  →  afterDuration 内无新错误  →  idle
+ *
+ * idle 阶段：
+ *   - rrweb 事件写入 Storage
+ *   - 上传循环跳过上传，但持续轮询
+ *
+ * 错误触发瞬间：
+ *   1. 设置上传时间窗口起点 = now - beforeDuration
+ *   2. 切换到 uploading 状态，上传循环开始上传
+ *   3. 启动 afterDuration 倒计时
+ *
+ * uploading 阶段：
+ *   - 上传循环持续上传事件
+ *   - 如果期间又有新错误 → 重置 afterDuration 倒计时（延长持续上传）
+ *   - afterDuration 倒计时到期 → 回到 idle
+ *
+ * 统一的上传逻辑由 uploader.ts 中的 startUploadLoop 处理。
+ */
+export interface ErrorInfo {
+    type: string;
+    message?: string;
+    timestamp: number;
+    [key: string]: any;
+}
+export declare class ErrorTrigger {
+    private beforeDuration;
+    private afterDuration;
+    private state;
+    private cooldownTimer;
+    private destroyed;
+    constructor(options?: {
+        beforeDuration?: number;
+        afterDuration?: number;
+    });
+    /**
+     * 当前是否处于持续上传状态
+     */
+    isUploading(): boolean;
+    /**
+     * 接收错误通知
+     *
+     * idle 状态下：
+     *   1. 设置上传窗口起点
+     *   2. 切换到 uploading 状态
+     *   3. 启动 afterDuration 倒计时
+     *
+     * uploading 状态下：
+     *   重置 afterDuration 倒计时（延长持续上传窗口）
+     */
+    onError(errorInfo: ErrorInfo): void;
+    /**
+     * 进入 uploading 状态
+     */
+    private enterUploadingState;
+    /**
+     * 重置 afterDuration 倒计时
+     * 每次有新错误时调用，延长持续上传窗口
+     */
+    private resetCooldown;
+    /**
+     * 退出 uploading 状态，回到 idle
+     */
+    private exitUploadingState;
+    /**
+     * 销毁实例，清理所有定时器
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=error-trigger.d.ts.map

package/dist/esm/lib/error-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-trigger.d.ts","sourceRoot":"","sources":["../../../src/lib/error-trigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;IAG9B,OAAO,CAAC,KAAK,CAAwB;IAGrC,OAAO,CAAC,aAAa,CAA8C;IAGnE,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,GAAE;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;KACnB;IAKN;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAcnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,IAAI,IAAI;CAahB"}

package/dist/esm/lib/error-trigger.js

@@ -0,0 +1,162 @@
+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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+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); }
+/**
+ * 错误触发与状态管理
+ *
+ * 状态机：
+ *   idle  →  错误触发  →  uploading  →  afterDuration 内无新错误  →  idle
+ *
+ * idle 阶段：
+ *   - rrweb 事件写入 Storage
+ *   - 上传循环跳过上传，但持续轮询
+ *
+ * 错误触发瞬间：
+ *   1. 设置上传时间窗口起点 = now - beforeDuration
+ *   2. 切换到 uploading 状态，上传循环开始上传
+ *   3. 启动 afterDuration 倒计时
+ *
+ * uploading 阶段：
+ *   - 上传循环持续上传事件
+ *   - 如果期间又有新错误 → 重置 afterDuration 倒计时（延长持续上传）
+ *   - afterDuration 倒计时到期 → 回到 idle
+ *
+ * 统一的上传逻辑由 uploader.ts 中的 startUploadLoop 处理。
+ */
+
+import { setErrorModeUploading, setErrorModeWindowStart } from "./uploader";
+import logger from "./logger";
+export var ErrorTrigger = /*#__PURE__*/function () {
+  function ErrorTrigger() {
+    var _options$beforeDurati, _options$afterDuratio;
+    var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    _classCallCheck(this, ErrorTrigger);
+    _defineProperty(this, "beforeDuration", void 0);
+    _defineProperty(this, "afterDuration", void 0);
+    // 状态机
+    _defineProperty(this, "state", 'idle');
+    // afterDuration 倒计时定时器
+    _defineProperty(this, "cooldownTimer", null);
+    // 标记是否已销毁
+    _defineProperty(this, "destroyed", false);
+    this.beforeDuration = (_options$beforeDurati = options.beforeDuration) !== null && _options$beforeDurati !== void 0 ? _options$beforeDurati : 30000;
+    this.afterDuration = (_options$afterDuratio = options.afterDuration) !== null && _options$afterDuratio !== void 0 ? _options$afterDuratio : 30000;
+  }
+
+  /**
+   * 当前是否处于持续上传状态
+   */
+  _createClass(ErrorTrigger, [{
+    key: "isUploading",
+    value: function isUploading() {
+      return this.state === 'uploading';
+    }
+
+    /**
+     * 接收错误通知
+     *
+     * idle 状态下：
+     *   1. 设置上传窗口起点
+     *   2. 切换到 uploading 状态
+     *   3. 启动 afterDuration 倒计时
+     *
+     * uploading 状态下：
+     *   重置 afterDuration 倒计时（延长持续上传窗口）
+     */
+  }, {
+    key: "onError",
+    value: function onError(errorInfo) {
+      if (this.destroyed) return;
+      if (this.state === 'idle') {
+        // ===== 首次错误触发 =====
+        this.enterUploadingState(errorInfo.timestamp);
+      } else {
+        // ===== uploading 状态下又有新错误 → 重置 cooldown =====
+        this.resetCooldown();
+      }
+    }
+
+    // ===== 内部方法 =====
+
+    /**
+     * 进入 uploading 状态
+     */
+  }, {
+    key: "enterUploadingState",
+    value: function enterUploadingState(errorTimestamp) {
+      this.state = 'uploading';
+
+      // 1. 设置上传窗口起点（错误时间 - beforeDuration）
+      var windowStart = errorTimestamp - this.beforeDuration;
+      setErrorModeWindowStart(windowStart);
+
+      // 2. 切换上传状态，上传循环开始工作
+      setErrorModeUploading(true);
+
+      // 3. 启动 afterDuration 倒计时
+      this.resetCooldown();
+    }
+
+    /**
+     * 重置 afterDuration 倒计时
+     * 每次有新错误时调用，延长持续上传窗口
+     */
+  }, {
+    key: "resetCooldown",
+    value: function resetCooldown() {
+      var _this = this;
+      if (this.cooldownTimer) {
+        clearTimeout(this.cooldownTimer);
+        this.cooldownTimer = null;
+      }
+      this.cooldownTimer = setTimeout(function () {
+        try {
+          _this.exitUploadingState();
+        } catch (error) {
+          logger.warn('Error in exitUploadingState:', error);
+        }
+      }, this.afterDuration);
+    }
+
+    /**
+     * 退出 uploading 状态，回到 idle
+     */
+  }, {
+    key: "exitUploadingState",
+    value: function exitUploadingState() {
+      // 清理 cooldown 定时器
+      if (this.cooldownTimer) {
+        clearTimeout(this.cooldownTimer);
+        this.cooldownTimer = null;
+      }
+
+      // 切换回 idle 状态，上传循环将跳过上传
+      setErrorModeUploading(false);
+
+      // 回到 idle
+      this.state = 'idle';
+    }
+
+    /**
+     * 销毁实例，清理所有定时器
+     */
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      this.destroyed = true;
+      if (this.cooldownTimer) {
+        clearTimeout(this.cooldownTimer);
+        this.cooldownTimer = null;
+      }
+
+      // 确保上传状态重置
+      setErrorModeUploading(false);
+      this.state = 'idle';
+    }
+  }]);
+  return ErrorTrigger;
+}();

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

@@ -1,3 +1,12 @@
+import { ErrorTrigger } from './error-trigger';
+/**
+ * 设置错误触发器实例（错误采集模式下由 init.ts 调用）
+ */
+export declare function setErrorTrigger(trigger: ErrorTrigger | null): void;
+/**
+ * 获取错误触发器实例
+ */
+export declare function getErrorTrigger(): ErrorTrigger | null;
 export declare const sendErrorToAnalytics: (data: any) => void;
 export declare function initErrorHandler(): void;
 export declare function cleanupErrorHandler(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/lib/error.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,oBAAoB,SAAU,GAAG,SAe7C,CAAC;AAGF,wBAAgB,gBAAgB,SAoJ/B;AAGD,wBAAgB,mBAAmB,SAgBlC"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/lib/error.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAU/C;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAElE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAGD,eAAO,MAAM,oBAAoB,SAAU,GAAG,SAuB7C,CAAC;AA6EF,wBAAgB,gBAAgB,SAO/B;AAGD,wBAAgB,mBAAmB,SAOlC"}