@openreplay/tracker 18.0.17 → 18.1.0-beta.0

package/dist/lib/main/app/index.d.ts

@@ -68,6 +68,14 @@ type AppOptions = {
     localStorage: Storage | null;
     sessionStorage: Storage | null;
     forceSingleTab?: boolean;
+    /**
+     * When a page is restored from the browser's back-forward cache (bfcache),
+     * the tracker resumes the existing session if it was frozen for less than this
+     * many milliseconds, and starts a fresh session otherwise (the previous one has
+     * likely gone stale server-side). Set to 0 to always restart on restore.
+     * @default 1800000 (30 min)
+     */
+    bfcacheRestartThreshold?: number;
     /** Sometimes helps to prevent session breaking due to dict reset */
     disableStringDict?: boolean;
     assistSocketHost?: string;
@@ -168,6 +176,7 @@ export default class App {
     private frameOderNumber;
     private frameLevel;
     private emptyBatchCounter;
+    private lastHiddenAt;
     constructor(projectKey: string, sessionToken: string | undefined, options: Partial<Options>, signalError: (error: string, apis: string[]) => void, insideIframe: boolean);
     /** used by child iframes for crossdomain only */
     parentActive: boolean;
@@ -253,6 +262,7 @@ export default class App {
     private checkNodeId;
     private initWorker;
     private restart;
+    private handlePageShow;
     private handleWorkerMsg;
     private _debug;
     send: (message: Message, urgent?: boolean) => void;
@@ -308,6 +318,7 @@ export default class App {
     orderNumber: number;
     coldStartTs: number;
     singleBuffer: boolean;
+    private getSessionVersionHash;
     private checkSessionToken;
     /**
      * start buffering messages without starting the actual session, which gives

package/dist/lib/main/modules/analytics/batcher.d.ts

@@ -43,7 +43,8 @@ declare class Batcher {
     private paused;
     private onVisibilityChange;
     startAutosend(): void;
-    flush(): void;
+    flush(keepalive?: boolean): void;
+    private requeue;
     stop(): void;
     restart(): void;
 }

package/dist/lib/main/modules/analytics/utils.d.ts

@@ -13,7 +13,7 @@ interface ClientData {
 /**
  * Detects client browser, OS, and device information
  */
-export declare function uaParse(sWindow: Window & typeof globalThis): ClientData;
+export declare function uaParse(sWindow: Window & typeof globalThis, onOsVersionUpdate?: (osVersion: string) => void): ClientData;
 export declare function isObject(item: any): boolean;
 export declare function getUTCOffsetString(): string;
 export {};

package/dist/lib/main/modules/conditionsManager.d.ts

@@ -30,7 +30,8 @@ export default class ConditionsManager {
     trigger(conditionName: string): void;
     processMessage(message: Message): void;
     processFlags(flag: IFeatureFlag[]): void;
-    durationInt: ReturnType<typeof setInterval> | null;
+    durationInts: Array<ReturnType<typeof setInterval>>;
+    private clearDurationInt;
     processDuration(durationMs: number, condName: string): void;
     networkRequest(message: NetworkRequest): void;
     customEvent(message: CustomEvent): void;

package/dist/types/main/app/index.d.ts

@@ -68,6 +68,14 @@ type AppOptions = {
     localStorage: Storage | null;
     sessionStorage: Storage | null;
     forceSingleTab?: boolean;
+    /**
+     * When a page is restored from the browser's back-forward cache (bfcache),
+     * the tracker resumes the existing session if it was frozen for less than this
+     * many milliseconds, and starts a fresh session otherwise (the previous one has
+     * likely gone stale server-side). Set to 0 to always restart on restore.
+     * @default 1800000 (30 min)
+     */
+    bfcacheRestartThreshold?: number;
     /** Sometimes helps to prevent session breaking due to dict reset */
     disableStringDict?: boolean;
     assistSocketHost?: string;
@@ -168,6 +176,7 @@ export default class App {
     private frameOderNumber;
     private frameLevel;
     private emptyBatchCounter;
+    private lastHiddenAt;
     constructor(projectKey: string, sessionToken: string | undefined, options: Partial<Options>, signalError: (error: string, apis: string[]) => void, insideIframe: boolean);
     /** used by child iframes for crossdomain only */
     parentActive: boolean;
@@ -253,6 +262,7 @@ export default class App {
     private checkNodeId;
     private initWorker;
     private restart;
+    private handlePageShow;
     private handleWorkerMsg;
     private _debug;
     send: (message: Message, urgent?: boolean) => void;
@@ -308,6 +318,7 @@ export default class App {
     orderNumber: number;
     coldStartTs: number;
     singleBuffer: boolean;
+    private getSessionVersionHash;
     private checkSessionToken;
     /**
      * start buffering messages without starting the actual session, which gives

package/dist/types/main/modules/analytics/batcher.d.ts

@@ -43,7 +43,8 @@ declare class Batcher {
     private paused;
     private onVisibilityChange;
     startAutosend(): void;
-    flush(): void;
+    flush(keepalive?: boolean): void;
+    private requeue;
     stop(): void;
     restart(): void;
 }

package/dist/types/main/modules/analytics/utils.d.ts

@@ -13,7 +13,7 @@ interface ClientData {
 /**
  * Detects client browser, OS, and device information
  */
-export declare function uaParse(sWindow: Window & typeof globalThis): ClientData;
+export declare function uaParse(sWindow: Window & typeof globalThis, onOsVersionUpdate?: (osVersion: string) => void): ClientData;
 export declare function isObject(item: any): boolean;
 export declare function getUTCOffsetString(): string;
 export {};

package/dist/types/main/modules/conditionsManager.d.ts

@@ -30,7 +30,8 @@ export default class ConditionsManager {
     trigger(conditionName: string): void;
     processMessage(message: Message): void;
     processFlags(flag: IFeatureFlag[]): void;
-    durationInt: ReturnType<typeof setInterval> | null;
+    durationInts: Array<ReturnType<typeof setInterval>>;
+    private clearDurationInt;
     processDuration(durationMs: number, condName: string): void;
     networkRequest(message: NetworkRequest): void;
     customEvent(message: CustomEvent): void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openreplay/tracker",
   "description": "The OpenReplay tracker main package",
-  "version": "18.0.17",
+  "version": "18.1.0-beta.0",
   "keywords": [
     "logging",
     "replay"