@openreplay/tracker 3.4.16 → 3.4.17-beta.0

package/cjs/modules/img.js

@@ -2,7 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const utils_js_1 = require("../utils.js");
 const index_js_1 = require("../messages/index.js");
+const PLACEHOLDER_SRC = "https://static.openreplay.com/tracker/placeholder.jpeg";
 function default_1(app) {
+    function sendPlaceholder(id, node) {
+        app.send(new index_js_1.SetNodeAttribute(id, "src", PLACEHOLDER_SRC));
+        const { width, height } = node.getBoundingClientRect();
+        if (!node.hasAttribute("width")) {
+            app.send(new index_js_1.SetNodeAttribute(id, "width", String(width)));
+        }
+        if (!node.hasAttribute("height")) {
+            app.send(new index_js_1.SetNodeAttribute(id, "height", String(height)));
+        }
+    }
     const sendImgSrc = app.safe(function () {
         const id = app.nodes.getID(this);
         if (id === undefined) {
@@ -17,7 +28,10 @@ function default_1(app) {
                 app.send(new index_js_1.ResourceTiming((0, utils_js_1.timestamp)(), 0, 0, 0, 0, 0, src, 'img'));
             }
         }
-        else if (src.length < 1e5) {
+        else if (src.length >= 1e5 || app.sanitizer.isMasked(id)) {
+            sendPlaceholder(id, this);
+        }
+        else {
             app.send(new index_js_1.SetNodeAttributeURLBased(id, 'src', src, app.getBaseHref()));
         }
     });

package/cjs/modules/input.d.ts

@@ -1,5 +1,6 @@
 import App from "../app/index.js";
-export declare function getInputLabel(node: HTMLInputElement): string;
+declare type TextEditableElement = HTMLInputElement | HTMLTextAreaElement;
+export declare function getInputLabel(node: TextEditableElement): string;
 export declare const enum InputMode {
     Plain = 0,
     Obscured = 1,
@@ -11,3 +12,4 @@ export interface Options {
     defaultInputMode: InputMode;
 }
 export default function (app: App, opts: Partial<Options>): void;
+export {};

package/cjs/modules/input.js

@@ -3,7 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getInputLabel = void 0;
 const utils_js_1 = require("../utils.js");
 const index_js_1 = require("../messages/index.js");
-function isInput(node) {
+function isTextEditable(node) {
+    if (node instanceof HTMLTextAreaElement) {
+        return true;
+    }
     if (!(node instanceof HTMLInputElement)) {
         return false;
     }
@@ -111,7 +114,7 @@ function default_1(app, opts) {
     app.ticker.attach(() => {
         inputValues.forEach((value, id) => {
             const node = app.nodes.getNode(id);
-            if (!isInput(node)) {
+            if (!isTextEditable(node)) {
                 inputValues.delete(id);
                 return;
             }
@@ -142,7 +145,7 @@ function default_1(app, opts) {
         if (id === undefined) {
             return;
         }
-        if (isInput(node)) {
+        if (isTextEditable(node)) {
             inputValues.set(id, node.value);
             sendInputValue(id, node);
             return;

package/cjs/modules/mouse.js

@@ -85,7 +85,7 @@ function default_1(app) {
             tag === 'LI' ||
             target.onclick != null ||
             target.getAttribute('role') === 'button') {
-            const label = app.observer.getInnerTextSecure(target);
+            const label = app.sanitizer.getInnerTextSecure(target);
             return (0, utils_js_1.normSpaces)(label).slice(0, 100);
         }
         return '';

package/lib/app/context.d.ts

@@ -0,0 +1,18 @@
+export interface Window extends globalThis.Window {
+    HTMLInputElement: typeof HTMLInputElement;
+    HTMLLinkElement: typeof HTMLLinkElement;
+    HTMLStyleElement: typeof HTMLStyleElement;
+    SVGStyleElement: typeof SVGStyleElement;
+    HTMLIFrameElement: typeof HTMLIFrameElement;
+    Text: typeof Text;
+    Element: typeof Element;
+    ShadowRoot: typeof ShadowRoot;
+}
+declare type WindowConstructor = Document | Element | Text | ShadowRoot | HTMLInputElement | HTMLLinkElement | HTMLStyleElement | HTMLIFrameElement;
+declare type Constructor<T> = {
+    new (...args: any[]): T;
+    name: string;
+};
+export declare function isInstance<T extends WindowConstructor>(node: Node, constr: Constructor<T>): node is T;
+export declare function inDocument(node: Node): boolean;
+export {};

package/lib/app/context.js

@@ -0,0 +1,43 @@
+// TODO: we need a type expert here so we won't have to ignore the lines
+// TODO: use it everywhere (static function; export from which file? <-- global Window typing required)
+export function isInstance(node, constr) {
+    const doc = node.ownerDocument;
+    if (!doc) { // null if Document
+        return constr.name === 'Document';
+    }
+    let context = 
+    // @ts-ignore (for EI, Safary)
+    doc.parentWindow ||
+        doc.defaultView; // TODO: smart global typing for Window object
+    while (context.parent && context.parent !== context) {
+        // @ts-ignore
+        if (node instanceof context[constr.name]) {
+            return true;
+        }
+        // @ts-ignore
+        context = context.parent;
+    }
+    // @ts-ignore
+    return node instanceof context[constr.name];
+}
+export function inDocument(node) {
+    const doc = node.ownerDocument;
+    if (!doc) {
+        return false;
+    }
+    if (doc.contains(node)) {
+        return true;
+    }
+    let context = 
+    // @ts-ignore (for EI, Safary)
+    doc.parentWindow ||
+        doc.defaultView;
+    while (context.parent && context.parent !== context) {
+        if (context.document.contains(node)) {
+            return true;
+        }
+        // @ts-ignore
+        context = context.parent;
+    }
+    return false;
+}

package/lib/app/index.d.ts

@@ -1,19 +1,21 @@
 import Message from "../messages/message.js";
 import Nodes from "./nodes.js";
-import Observer from "./observer/top_observer.js";
+import Sanitizer from "./sanitizer.js";
 import Ticker from "./ticker.js";
 import type { Options as ObserverOptions } from "./observer/top_observer.js";
+import type { Options as SanitizerOptions } from "./sanitizer.js";
 import type { Options as WebworkerOptions } from "../messages/webworker.js";
 export interface OnStartInfo {
     sessionID: string;
     sessionToken: string;
     userUUID: string;
 }
-export declare type Options = {
+declare type AppOptions = {
     revID: string;
     node_id: string;
     session_token_key: string;
     session_pageno_key: string;
+    session_reset_key: string;
     local_uuid_key: string;
     ingestPoint: string;
     resourceBaseHref: string | null;
@@ -21,7 +23,8 @@ export declare type Options = {
     __debug_report_edp: string | null;
     __debug_log: boolean;
     onStart?: (info: OnStartInfo) => void;
-} & ObserverOptions & WebworkerOptions;
+} & WebworkerOptions;
+export declare type Options = AppOptions & ObserverOptions & SanitizerOptions;
 declare type Callback = () => void;
 declare type CommitCallback = (messages: Array<Message>) => void;
 export declare const DEFAULT_INGEST_POINT = "https://api.openreplay.com/ingest";
@@ -29,8 +32,9 @@ export default class App {
     readonly nodes: Nodes;
     readonly ticker: Ticker;
     readonly projectKey: string;
+    readonly sanitizer: Sanitizer;
     private readonly messages;
-    readonly observer: Observer;
+    private readonly observer;
     private readonly startCallbacks;
     private readonly stopCallbacks;
     private readonly commitCallbacks;
@@ -40,7 +44,7 @@ export default class App {
     private isActive;
     private version;
     private readonly worker?;
-    constructor(projectKey: string, sessionToken: string | null | undefined, opts: Partial<Options>);
+    constructor(projectKey: string, sessionToken: string | null | undefined, options: Partial<Options>);
     private _debug;
     send(message: Message, urgent?: boolean): void;
     private commit;
@@ -58,6 +62,7 @@ export default class App {
     resolveResourceURL(resourceURL: string): string;
     isServiceURL(url: string): boolean;
     active(): boolean;
+    resetNextPageSession(flag: boolean): void;
     private _start;
     start(reset?: boolean): Promise<OnStartInfo>;
     stop(): void;

package/lib/app/index.js

@@ -2,41 +2,41 @@ import { timestamp, log, warn } from "../utils.js";
 import { Timestamp } from "../messages/index.js";
 import Nodes from "./nodes.js";
 import Observer from "./observer/top_observer.js";
+import Sanitizer from "./sanitizer.js";
 import Ticker from "./ticker.js";
 import { deviceMemory, jsHeapSizeLimit } from "../modules/performance.js";
 // TODO: use backendHost only
 export const DEFAULT_INGEST_POINT = 'https://api.openreplay.com/ingest';
 export default class App {
-    constructor(projectKey, sessionToken, opts) {
+    constructor(projectKey, sessionToken, options) {
         this.messages = [];
         this.startCallbacks = [];
         this.stopCallbacks = [];
         this.commitCallbacks = [];
         this._sessionID = null;
         this.isActive = false;
-        this.version = '3.4.16';
+        this.version = '3.4.17-beta.0';
         this.projectKey = projectKey;
         this.options = Object.assign({
             revID: '',
             node_id: '__openreplay_id',
             session_token_key: '__openreplay_token',
             session_pageno_key: '__openreplay_pageno',
+            session_reset_key: '__openreplay_reset',
             local_uuid_key: '__openreplay_uuid',
             ingestPoint: DEFAULT_INGEST_POINT,
             resourceBaseHref: null,
             __is_snippet: false,
             __debug_report_edp: null,
             __debug_log: false,
-            obscureTextEmails: true,
-            obscureTextNumbers: false,
-            captureIFrames: false,
-        }, opts);
+        }, options);
         if (sessionToken != null) {
             sessionStorage.setItem(this.options.session_token_key, sessionToken);
         }
         this.revID = this.options.revID;
+        this.sanitizer = new Sanitizer(this, options);
         this.nodes = new Nodes(this.options.node_id);
-        this.observer = new Observer(this, this.options);
+        this.observer = new Observer(this, options);
         this.ticker = new Ticker(this);
         this.ticker.attach(() => this.commit());
         try {
@@ -178,6 +178,14 @@ export default class App {
     active() {
         return this.isActive;
     }
+    resetNextPageSession(flag) {
+        if (flag) {
+            sessionStorage.setItem(this.options.session_reset_key, 't');
+        }
+        else {
+            sessionStorage.removeItem(this.options.session_reset_key);
+        }
+    }
     _start(reset) {
         if (!this.isActive) {
             if (!this.worker) {
@@ -205,6 +213,8 @@ export default class App {
             // if (tokenIsActive) {
             //   token = null
             // }
+            const sReset = sessionStorage.getItem(this.options.session_reset_key);
+            sessionStorage.removeItem(this.options.session_reset_key);
             return window.fetch(this.options.ingestPoint + '/v1/web/start', {
                 method: 'POST',
                 headers: {
@@ -220,7 +230,7 @@ export default class App {
                     isSnippet: this.options.__is_snippet,
                     deviceMemory,
                     jsHeapSizeLimit,
-                    reset,
+                    reset: reset || sReset !== null,
                 }),
             })
                 .then(r => {
@@ -298,6 +308,7 @@ export default class App {
                 if (this.worker) {
                     this.worker.postMessage("stop");
                 }
+                this.sanitizer.clear();
                 this.observer.disconnect();
                 this.nodes.clear();
                 this.ticker.stop();

package/lib/app/observer/observer.d.ts

@@ -1,25 +1,5 @@
 import App from "../index.js";
-export interface Window extends globalThis.Window {
-    HTMLInputElement: typeof HTMLInputElement;
-    HTMLLinkElement: typeof HTMLLinkElement;
-    HTMLStyleElement: typeof HTMLStyleElement;
-    SVGStyleElement: typeof SVGStyleElement;
-    HTMLIFrameElement: typeof HTMLIFrameElement;
-    Text: typeof Text;
-    Element: typeof Element;
-    ShadowRoot: typeof ShadowRoot;
-}
-declare type WindowConstructor = Document | Element | Text | ShadowRoot | HTMLInputElement | HTMLLinkElement | HTMLStyleElement | HTMLIFrameElement;
-declare type Constructor<T> = {
-    new (...args: any[]): T;
-    name: string;
-};
-export declare function isInstance<T extends WindowConstructor>(node: Node, constr: Constructor<T>): node is T;
-export interface Options {
-    obscureTextEmails: boolean;
-    obscureTextNumbers: boolean;
-}
-export default abstract class Observer<AdditionalOptions = {}> {
+export default abstract class Observer {
     protected readonly app: App;
     protected readonly context: Window;
     private readonly observer;
@@ -29,14 +9,10 @@ export default abstract class Observer<AdditionalOptions = {}> {
     private readonly indexes;
     private readonly attributesList;
     private readonly textSet;
-    private readonly textMasked;
-    protected readonly options: Options & AdditionalOptions;
     private readonly inUpperContext;
-    constructor(app: App, options: Partial<Options> & AdditionalOptions, context?: Window);
+    constructor(app: App, context?: Window);
     private clear;
     private sendNodeAttribute;
-    getInnerTextSecure(el: HTMLElement): string;
-    private checkObscure;
     private sendNodeData;
     private bindNode;
     private bindTree;
@@ -47,4 +23,3 @@ export default abstract class Observer<AdditionalOptions = {}> {
     protected observeRoot(node: Node, beforeCommit: (id?: number) => unknown, nodeToBind?: Node): void;
     disconnect(): void;
 }
-export {};

package/lib/app/observer/observer.js

@@ -1,30 +1,8 @@
-import { stars, hasOpenreplayAttribute } from "../../utils.js";
 import { RemoveNodeAttribute, SetNodeAttribute, SetNodeAttributeURLBased, SetCSSDataURLBased, SetNodeData, CreateTextNode, CreateElementNode, MoveNode, RemoveNode, } from "../../messages/index.js";
+import { isInstance, inDocument } from "../context.js";
 function isSVGElement(node) {
     return node.namespaceURI === 'http://www.w3.org/2000/svg';
 }
-// TODO: we need a type expert here so we won't have to ignore the lines
-// TODO: use it everywhere (static function; export from which file? <-- global Window typing required)
-export function isInstance(node, constr) {
-    const doc = node.ownerDocument;
-    if (!doc) { // null if Document
-        return constr.name === 'Document';
-    }
-    let context = 
-    // @ts-ignore (for EI, Safary)
-    doc.parentWindow ||
-        doc.defaultView; // TODO: smart global typing for Window object
-    while (context.parent && context.parent !== context) {
-        // @ts-ignore
-        if (node instanceof context[constr.name]) {
-            return true;
-        }
-        // @ts-ignore
-        context = context.parent;
-    }
-    // @ts-ignore
-    return node instanceof context[constr.name];
-}
 function isIgnored(node) {
     if (isInstance(node, Text)) {
         return false;
@@ -54,7 +32,7 @@ function isObservable(node) {
     return !isIgnored(node);
 }
 export default class Observer {
-    constructor(app, options, context = window) {
+    constructor(app, context = window) {
         this.app = app;
         this.context = context;
         this.commited = [];
@@ -63,34 +41,12 @@ export default class Observer {
         this.indexes = [];
         this.attributesList = [];
         this.textSet = new Set();
-        this.textMasked = new Set();
-        this.options = Object.assign({
-            obscureTextEmails: true,
-            obscureTextNumbers: false,
-        }, options);
-        this.inUpperContext = context.parent === context;
+        this.inUpperContext = context.parent === context; //TODO: get rid of context here
         this.observer = new MutationObserver(this.app.safe((mutations) => {
             for (const mutation of mutations) {
                 const target = mutation.target;
                 const type = mutation.type;
-                // TODO TODO TODO: move to iframe_observer/remove??? (check if )
-                // Special case
-                // 'childList' on Document might happen in case of iframe. 
-                // TODO: generalize as much as possible
-                // if (isInstance(target, Document) // Also ShadowRoot can be here
-                //     && type === 'childList' 
-                //     //&& new Array(mutation.addedNodes).some(node => isInstance(node, HTMLHtmlElement))
-                // ) {
-                //   const parentFrame = target.defaultView?.frameElement
-                //   if (!parentFrame) { continue }
-                //   this.bindTree(target.documentElement)
-                //   const frameID = this.app.nodes.getID(parentFrame)
-                //   const docID = this.app.nodes.getID(target.documentElement)
-                //   if (frameID === undefined || docID === undefined) { continue }
-                //   this.app.send(CreateIFrameDocument(frameID, docID));
-                //   continue;
-                // }
-                if (!isObservable(target) || !context.document.contains(target)) {
+                if (!isObservable(target) || !inDocument(target)) {
                     continue;
                 }
                 if (type === 'childList') {
@@ -135,7 +91,6 @@ export default class Observer {
         this.indexes.length = 1;
         this.attributesList.length = 0;
         this.textSet.clear();
-        //this.textMasked.clear();
     }
     sendNodeAttribute(id, node, name, value) {
         if (isSVGElement(node)) {
@@ -184,35 +139,14 @@ export default class Observer {
         }
         this.app.send(new SetNodeAttribute(id, name, value));
     }
-    /* TODO:  abstract sanitation */
-    getInnerTextSecure(el) {
-        const id = this.app.nodes.getID(el);
-        if (!id) {
-            return '';
-        }
-        return this.checkObscure(id, el.innerText);
-    }
-    checkObscure(id, data) {
-        if (this.textMasked.has(id)) {
-            return data.replace(/[^\f\n\r\t\v\u00a0\u1680\u2000-\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]/g, '█');
-        }
-        if (this.options.obscureTextNumbers) {
-            data = data.replace(/\d/g, '0');
-        }
-        if (this.options.obscureTextEmails) {
-            data = data.replace(/([^\s]+)@([^\s]+)\.([^\s]+)/g, (...f) => stars(f[1]) + '@' + stars(f[2]) + '.' + stars(f[3]));
-        }
-        return data;
-    }
     sendNodeData(id, parentElement, data) {
         if (isInstance(parentElement, HTMLStyleElement) || isInstance(parentElement, SVGStyleElement)) {
             this.app.send(new SetCSSDataURLBased(id, data, this.app.getBaseHref()));
             return;
         }
-        data = this.checkObscure(id, data);
+        data = this.app.sanitizer.sanitize(id, data);
         this.app.send(new SetNodeData(id, data));
     }
-    /* end TODO:  abstract sanitation */
     bindNode(node) {
         const r = this.app.nodes.registerNode(node);
         const id = r[0];
@@ -264,10 +198,7 @@ export default class Observer {
                 this.unbindNode(node);
                 return false;
             }
-            if (this.textMasked.has(parentID) ||
-                (isInstance(node, Element) && hasOpenreplayAttribute(node, 'masked'))) {
-                this.textMasked.add(id);
-            }
+            this.app.sanitizer.handleNode(id, parentID, node);
         }
         let sibling = node.previousSibling;
         while (sibling !== null) {
@@ -340,8 +271,7 @@ export default class Observer {
         let node;
         for (let id = 0; id < this.recents.length; id++) {
             // TODO: make things/logic nice here.
-            // commit required in any case if recents[id] true or false (in case of unbinding).
-            // ???!?!?R@TW:$HKJ$WLKn
+            // commit required in any case if recents[id] true or false (in case of unbinding) or undefined (in case of attr change).
             if (!this.myNodes[id]) {
                 continue;
             }
@@ -369,8 +299,6 @@ export default class Observer {
     disconnect() {
         this.observer.disconnect();
         this.clear();
-        // to sanitizer
-        this.textMasked.clear();
         this.myNodes.length = 0;
     }
 }

package/lib/app/observer/top_observer.d.ts

@@ -1,10 +1,10 @@
 import Observer from "./observer.js";
-import type { Options as BaseOptions } from "./observer.js";
 import App from "../index.js";
-export interface Options extends Partial<BaseOptions> {
+export interface Options {
     captureIFrames: boolean;
 }
-export default class TopObserver extends Observer<Options> {
+export default class TopObserver extends Observer {
+    private readonly options;
     constructor(app: App, options: Partial<Options>);
     private iframeObservers;
     private handleIframe;

package/lib/app/observer/top_observer.js

@@ -1,15 +1,17 @@
-import Observer, { isInstance } from "./observer.js";
+import Observer from "./observer.js";
+import { isInstance } from "../context.js";
 import IFrameObserver from "./iframe_observer.js";
 import ShadowRootObserver from "./shadow_root_observer.js";
 import { CreateDocument } from "../../messages/index.js";
 const attachShadowNativeFn = Element.prototype.attachShadow;
 export default class TopObserver extends Observer {
     constructor(app, options) {
-        super(app, Object.assign({
-            captureIFrames: false
-        }, options));
+        super(app);
         this.iframeObservers = [];
         this.shadowRootObservers = [];
+        this.options = Object.assign({
+            captureIFrames: false
+        }, options);
         // IFrames
         this.app.nodes.attachNodeCallback(node => {
             if (isInstance(node, HTMLIFrameElement) &&
@@ -38,7 +40,7 @@ export default class TopObserver extends Observer {
             if (!context) {
                 return;
             }
-            const observer = new IFrameObserver(this.app, this.options, context);
+            const observer = new IFrameObserver(this.app, context);
             this.iframeObservers.push(observer);
             observer.observe(iframe);
         });
@@ -46,7 +48,7 @@ export default class TopObserver extends Observer {
         handle();
     }
     handleShadowRoot(shRoot) {
-        const observer = new ShadowRootObserver(this.app, this.options, this.context);
+        const observer = new ShadowRootObserver(this.app, this.context);
         this.shadowRootObservers.push(observer);
         observer.observe(shRoot.host);
     }

package/lib/app/sanitizer.d.ts

@@ -0,0 +1,16 @@
+import App from "./index.js";
+export interface Options {
+    obscureTextEmails: boolean;
+    obscureTextNumbers: boolean;
+}
+export default class Sanitizer {
+    private readonly app;
+    private readonly masked;
+    private readonly options;
+    constructor(app: App, options: Partial<Options>);
+    handleNode(id: number, parentID: number, node: Node): void;
+    sanitize(id: number, data: string): string;
+    isMasked(id: number): boolean;
+    getInnerTextSecure(el: HTMLElement): string;
+    clear(): void;
+}

package/lib/app/sanitizer.js

@@ -1 +1,44 @@
-"use strict";
+import { stars, hasOpenreplayAttribute } from "../utils.js";
+import { isInstance } from "./context.js";
+export default class Sanitizer {
+    constructor(app, options) {
+        this.app = app;
+        this.masked = new Set();
+        this.options = Object.assign({
+            obscureTextEmails: true,
+            obscureTextNumbers: false,
+        }, options);
+    }
+    handleNode(id, parentID, node) {
+        if (this.masked.has(parentID) ||
+            (isInstance(node, Element) && hasOpenreplayAttribute(node, 'masked'))) {
+            this.masked.add(id);
+        }
+    }
+    sanitize(id, data) {
+        if (this.masked.has(id)) {
+            // TODO: is it the best place to put trim() ? Might trimmed spaces be considered in layout in certain cases?
+            return data.trim().replace(/[^\f\n\r\t\v\u00a0\u1680\u2000-\u200a\u2028\u2029\u202f\u205f\u3000\ufeff]/g, '█');
+        }
+        if (this.options.obscureTextNumbers) {
+            data = data.replace(/\d/g, '0');
+        }
+        if (this.options.obscureTextEmails) {
+            data = data.replace(/([^\s]+)@([^\s]+)\.([^\s]+)/g, (...f) => stars(f[1]) + '@' + stars(f[2]) + '.' + stars(f[3]));
+        }
+        return data;
+    }
+    isMasked(id) {
+        return this.masked.has(id);
+    }
+    getInnerTextSecure(el) {
+        const id = this.app.nodes.getID(el);
+        if (!id) {
+            return '';
+        }
+        return this.sanitize(id, el.innerText);
+    }
+    clear() {
+        this.masked.clear();
+    }
+}

package/lib/index.d.ts

@@ -37,4 +37,5 @@ export default class API {
     event(key: string, payload: any, issue?: boolean): void;
     issue(key: string, payload: any): void;
     handleError: (e: Error | ErrorEvent | PromiseRejectionEvent) => void;
+    resetNextPageSession(flag: boolean): void;
 }

package/lib/index.js

@@ -111,7 +111,7 @@ export default class API {
             // no-cors issue only with text/plain or not-set Content-Type
             // req.setRequestHeader("Content-Type", "application/json;charset=UTF-8");
             req.send(JSON.stringify({
-                trackerVersion: '3.4.16',
+                trackerVersion: '3.4.17-beta.0',
                 projectKey: options.projectKey,
                 doNotTrack,
                 // TODO: add precise reason (an exact API missing)
@@ -219,4 +219,10 @@ export default class API {
             this.app.send(new CustomIssue(key, payload));
         }
     }
+    resetNextPageSession(flag) {
+        if (typeof flag !== 'boolean' || !this.app) {
+            return;
+        }
+        this.app.resetNextPageSession(flag);
+    }
 }