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

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