@openreplay/tracker 3.6.3 → 4.0.0

package/lib/app/observer/observer.js

@@ -1,5 +1,5 @@
-import { RemoveNodeAttribute, SetNodeAttribute, SetNodeAttributeURLBased, SetCSSDataURLBased, SetNodeData, CreateTextNode, CreateElementNode, MoveNode, RemoveNode, } from "../../common/messages.js";
-import { isRootNode, isTextNode, isElementNode, isSVGElement, hasTag, } from "../guards.js";
+import { RemoveNodeAttribute, SetNodeAttribute, SetNodeAttributeURLBased, SetCSSDataURLBased, SetNodeData, CreateTextNode, CreateElementNode, MoveNode, RemoveNode, } from '../messages.gen.js';
+import { isRootNode, isTextNode, isElementNode, isSVGElement, hasTag } from '../guards.js';
 function isIgnored(node) {
     if (isTextNode(node)) {
         return false;
@@ -11,13 +11,9 @@ function isIgnored(node) {
     if (tag === 'LINK') {
         const rel = node.getAttribute('rel');
         const as = node.getAttribute('as');
-        return !((rel === null || rel === void 0 ? void 0 : rel.includes('stylesheet')) || as === "style" || as === "font");
+        return !((rel === null || rel === void 0 ? void 0 : rel.includes('stylesheet')) || as === 'style' || as === 'font');
     }
-    return (tag === 'SCRIPT' ||
-        tag === 'NOSCRIPT' ||
-        tag === 'META' ||
-        tag === 'TITLE' ||
-        tag === 'BASE');
+    return (tag === 'SCRIPT' || tag === 'NOSCRIPT' || tag === 'META' || tag === 'TITLE' || tag === 'BASE');
 }
 function isObservable(node) {
     if (isRootNode(node)) {
@@ -30,17 +26,11 @@ function isObservable(node) {
     - fix unbinding logic + send all removals first (ensure sequence is correct)
     - use document as a 0-node in the upper context (should be updated in player at first)
 */
-/*
-  Nikita:
-    - rn we only send unbind event for parent (all child nodes will be cut in the live replay anyways)
-      to prevent sending 1k+ unbinds for child nodes and making replay file bigger than it should be
-*/
 var RecentsType;
 (function (RecentsType) {
     RecentsType[RecentsType["New"] = 0] = "New";
     RecentsType[RecentsType["Removed"] = 1] = "Removed";
     RecentsType[RecentsType["Changed"] = 2] = "Changed";
-    RecentsType[RecentsType["RemovedChild"] = 3] = "RemovedChild";
 })(RecentsType || (RecentsType = {}));
 export default class Observer {
     constructor(app, isTopContext = false) {
@@ -52,7 +42,8 @@ export default class Observer {
         this.attributesMap = new Map();
         this.textSet = new Set();
         this.observer = new MutationObserver(this.app.safe((mutations) => {
-            for (const mutation of mutations) { // mutations order is sequential
+            for (const mutation of mutations) {
+                // mutations order is sequential
                 const target = mutation.target;
                 const type = mutation.type;
                 if (!isObservable(target)) {
@@ -60,7 +51,10 @@ export default class Observer {
                 }
                 if (type === 'childList') {
                     for (let i = 0; i < mutation.removedNodes.length; i++) {
-                        this.bindTree(mutation.removedNodes[i], true);
+                        // Should be the same as bindTree(mutation.removedNodes[i]), but logic needs to be be untied
+                        if (isObservable(mutation.removedNodes[i])) {
+                            this.bindNode(mutation.removedNodes[i]);
+                        }
                     }
                     for (let i = 0; i < mutation.addedNodes.length; i++) {
                         this.bindTree(mutation.addedNodes[i]);
@@ -81,7 +75,7 @@ export default class Observer {
                     }
                     let attr = this.attributesMap.get(id);
                     if (attr === undefined) {
-                        this.attributesMap.set(id, attr = new Set());
+                        this.attributesMap.set(id, (attr = new Set()));
                     }
                     attr.add(name);
                     continue;
@@ -107,16 +101,16 @@ export default class Observer {
                 name = name.substr(6);
             }
             if (value === null) {
-                this.app.send(new RemoveNodeAttribute(id, name));
+                this.app.send(RemoveNodeAttribute(id, name));
             }
             else if (name === 'href') {
                 if (value.length > 1e5) {
                     value = '';
                 }
-                this.app.send(new SetNodeAttributeURLBased(id, name, value, this.app.getBaseHref()));
+                this.app.send(SetNodeAttributeURLBased(id, name, value, this.app.getBaseHref()));
             }
             else {
-                this.app.send(new SetNodeAttribute(id, name, value));
+                this.app.send(SetNodeAttribute(id, name, value));
             }
             return;
         }
@@ -129,72 +123,75 @@ export default class Observer {
             return;
         }
         if (name === 'value' &&
-            hasTag(node, "INPUT") &&
+            hasTag(node, 'INPUT') &&
             node.type !== 'button' &&
             node.type !== 'reset' &&
             node.type !== 'submit') {
             return;
         }
         if (value === null) {
-            this.app.send(new RemoveNodeAttribute(id, name));
+            this.app.send(RemoveNodeAttribute(id, name));
             return;
         }
-        if (name === 'style' || name === 'href' && hasTag(node, "LINK")) {
-            this.app.send(new SetNodeAttributeURLBased(id, name, value, this.app.getBaseHref()));
+        if (name === 'style' || (name === 'href' && hasTag(node, 'LINK'))) {
+            this.app.send(SetNodeAttributeURLBased(id, name, value, this.app.getBaseHref()));
             return;
         }
         if (name === 'href' || value.length > 1e5) {
             value = '';
         }
-        this.app.send(new SetNodeAttribute(id, name, value));
+        this.app.send(SetNodeAttribute(id, name, value));
     }
     sendNodeData(id, parentElement, data) {
-        if (hasTag(parentElement, "STYLE") || hasTag(parentElement, "style")) {
-            this.app.send(new SetCSSDataURLBased(id, data, this.app.getBaseHref()));
+        if (hasTag(parentElement, 'STYLE') || hasTag(parentElement, 'style')) {
+            this.app.send(SetCSSDataURLBased(id, data, this.app.getBaseHref()));
             return;
         }
         data = this.app.sanitizer.sanitize(id, data);
-        this.app.send(new SetNodeData(id, data));
+        this.app.send(SetNodeData(id, data));
     }
     bindNode(node) {
         const [id, isNew] = this.app.nodes.registerNode(node);
         if (isNew) {
             this.recents.set(id, RecentsType.New);
         }
-        else if (this.recents.get(id) !== RecentsType.New) { // can we do just `else` here?
+        else if (this.recents.get(id) !== RecentsType.New) {
             this.recents.set(id, RecentsType.Removed);
         }
     }
-    unbindChildNode(node) {
-        const [id] = this.app.nodes.registerNode(node);
-        this.recents.set(id, RecentsType.RemovedChild);
-    }
-    bindTree(node, isChildUnbinding = false) {
+    bindTree(node) {
         if (!isObservable(node)) {
             return;
         }
         this.bindNode(node);
         const walker = document.createTreeWalker(node, NodeFilter.SHOW_ELEMENT + NodeFilter.SHOW_TEXT, {
-            acceptNode: (node) => isIgnored(node)
-                || (this.app.nodes.getID(node) !== undefined && !isChildUnbinding)
+            acceptNode: (node) => isIgnored(node) || this.app.nodes.getID(node) !== undefined
                 ? NodeFilter.FILTER_REJECT
                 : NodeFilter.FILTER_ACCEPT,
         }, 
         // @ts-ignore
         false);
         while (walker.nextNode()) {
-            if (isChildUnbinding) {
-                this.unbindChildNode(walker.currentNode);
-            }
-            else {
-                this.bindNode(walker.currentNode);
-            }
+            this.bindNode(walker.currentNode);
         }
     }
-    unbindNode(node) {
+    unbindTree(node) {
         const id = this.app.nodes.unregisterNode(node);
         if (id !== undefined && this.recents.get(id) === RecentsType.Removed) {
-            this.app.send(new RemoveNode(id));
+            // Sending RemoveNode only for parent to maintain
+            this.app.send(RemoveNode(id));
+            // Unregistering all the children in order to clear the memory
+            const walker = document.createTreeWalker(node, NodeFilter.SHOW_ELEMENT + NodeFilter.SHOW_TEXT, {
+                acceptNode: (node) => isIgnored(node) || this.app.nodes.getID(node) === undefined
+                    ? NodeFilter.FILTER_REJECT
+                    : NodeFilter.FILTER_ACCEPT,
+            }, 
+            // @ts-ignore
+            false);
+            while (walker.nextNode()) {
+                this.app.nodes.unregisterNode(walker.currentNode);
+            }
+            // MBTODO: count and send RemovedNodesCount (for the page crash detection in heuristics)
         }
     }
     // A top-consumption function on the infinite lists test. (~1% of performance resources)
@@ -207,20 +204,20 @@ export default class Observer {
         // Disable parent check for the upper context HTMLHtmlElement, because it is root there... (before)
         // TODO: get rid of "special" cases (there is an issue with CreateDocument altered behaviour though)
         // TODO: Clean the logic (though now it workd fine)
-        if (!hasTag(node, "HTML") || !this.isTopContext) {
+        if (!hasTag(node, 'HTML') || !this.isTopContext) {
             if (parent === null) {
                 // Sometimes one observation contains attribute mutations for the removimg node, which gets ignored here.
-                // That shouldn't affect the visual rendering ( should it? )
-                this.unbindNode(node);
+                // That shouldn't affect the visual rendering ( should it? maybe when transition applied? )
+                this.unbindTree(node);
                 return false;
             }
             parentID = this.app.nodes.getID(parent);
             if (parentID === undefined) {
-                this.unbindNode(node);
+                this.unbindTree(node);
                 return false;
             }
             if (!this.commitNode(parentID)) {
-                this.unbindNode(node);
+                this.unbindTree(node);
                 return false;
             }
             this.app.sanitizer.handleNode(id, parentID, node);
@@ -259,7 +256,7 @@ export default class Observer {
                         el.style.width = width + 'px';
                         el.style.height = height + 'px';
                     }
-                    this.app.send(new CreateElementNode(id, parentID, index, el.tagName, isSVGElement(node)));
+                    this.app.send(CreateElementNode(id, parentID, index, el.tagName, isSVGElement(node)));
                 }
                 for (let i = 0; i < el.attributes.length; i++) {
                     const attr = el.attributes[i];
@@ -268,13 +265,13 @@ export default class Observer {
             }
             else if (isTextNode(node)) {
                 // for text node id != 0, hence parentID !== undefined and parent is Element
-                this.app.send(new CreateTextNode(id, parentID, index));
+                this.app.send(CreateTextNode(id, parentID, index));
                 this.sendNodeData(id, parent, node.data);
             }
             return true;
         }
         if (recentsType === RecentsType.Removed && parentID !== undefined) {
-            this.app.send(new MoveNode(id, parentID, index));
+            this.app.send(MoveNode(id, parentID, index));
         }
         const attr = this.attributesMap.get(id);
         if (attr !== undefined) {
@@ -315,7 +312,8 @@ export default class Observer {
         });
         this.clear();
     }
-    // ISSSUE
+    // ISSSUE (nodeToBinde should be the same as node. Look at the comment about 0-node at the beginning of the file.)
+    // TODO: use one observer instance for all iframes/shadowRoots (composition instiad of inheritance)
     observeRoot(node, beforeCommit, nodeToBind = node) {
         this.observer.observe(node, {
             childList: true,

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

@@ -1,4 +1,4 @@
-import Observer from "./observer.js";
+import Observer from './observer.js';
 export default class ShadowRootObserver extends Observer {
     observe(el: Element): void;
 }

package/lib/app/observer/shadow_root_observer.js

@@ -1,5 +1,5 @@
-import Observer from "./observer.js";
-import { CreateIFrameDocument } from "../../common/messages.js";
+import Observer from './observer.js';
+import { CreateIFrameDocument } from '../messages.gen.js';
 export default class ShadowRootObserver extends Observer {
     observe(el) {
         const shRoot = el.shadowRoot;
@@ -9,7 +9,7 @@ export default class ShadowRootObserver extends Observer {
         } // log
         this.observeRoot(shRoot, (rootID) => {
             if (rootID === undefined) {
-                console.log("OpenReplay: Shadow Root was not bound");
+                console.log('OpenReplay: Shadow Root was not bound');
                 return;
             }
             this.app.send(CreateIFrameDocument(hostID, rootID));

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

@@ -1,11 +1,21 @@
-import Observer from "./observer.js";
-import App from "../index.js";
+import Observer from './observer.js';
+import App from '../index.js';
 export interface Options {
     captureIFrames: boolean;
 }
+declare type Context = Window & typeof globalThis;
+declare type ContextCallback = (context: Context) => void;
+declare type Offset = {
+    top: number;
+    left: number;
+};
 export default class TopObserver extends Observer {
     private readonly options;
     constructor(app: App, options: Partial<Options>);
+    private readonly contextCallbacks;
+    private readonly contextsSet;
+    attachContextCallback(cb: ContextCallback): void;
+    getDocumentOffset(doc: Document): Offset;
     private iframeObservers;
     private handleIframe;
     private shadowRootObservers;
@@ -13,3 +23,4 @@ export default class TopObserver extends Observer {
     observe(): void;
     disconnect(): void;
 }
+export {};

package/lib/app/observer/top_observer.js

@@ -1,52 +1,86 @@
-import Observer from "./observer.js";
-import { isElementNode, hasTag, } from "../guards.js";
-import IFrameObserver from "./iframe_observer.js";
-import ShadowRootObserver from "./shadow_root_observer.js";
-import { CreateDocument } from "../../common/messages.js";
+import Observer from './observer.js';
+import { isElementNode, hasTag } from '../guards.js';
+import IFrameObserver from './iframe_observer.js';
+import ShadowRootObserver from './shadow_root_observer.js';
+import { CreateDocument } from '../messages.gen.js';
 import { IN_BROWSER, hasOpenreplayAttribute } from '../../utils.js';
+function isPatchedDocument(doc) {
+    // @ts-ignore
+    return typeof doc.__openreplay__getOffset === 'function';
+}
 const attachShadowNativeFn = IN_BROWSER ? Element.prototype.attachShadow : () => new ShadowRoot();
 export default class TopObserver extends Observer {
     constructor(app, options) {
         super(app, true);
+        this.contextCallbacks = [];
+        // Attached once per Tracker instance
+        this.contextsSet = new Set();
         this.iframeObservers = [];
         this.shadowRootObservers = [];
         this.options = Object.assign({
-            captureIFrames: true
+            captureIFrames: true,
         }, options);
         // IFrames
-        this.app.nodes.attachNodeCallback(node => {
-            if (hasTag(node, "IFRAME") &&
-                ((this.options.captureIFrames && !hasOpenreplayAttribute(node, "obscured"))
-                    || hasOpenreplayAttribute(node, "capture"))) {
+        this.app.nodes.attachNodeCallback((node) => {
+            if (hasTag(node, 'IFRAME') &&
+                ((this.options.captureIFrames && !hasOpenreplayAttribute(node, 'obscured')) ||
+                    hasOpenreplayAttribute(node, 'capture'))) {
                 this.handleIframe(node);
             }
         });
         // ShadowDOM
-        this.app.nodes.attachNodeCallback(node => {
+        this.app.nodes.attachNodeCallback((node) => {
             if (isElementNode(node) && node.shadowRoot !== null) {
                 this.handleShadowRoot(node.shadowRoot);
             }
         });
     }
+    attachContextCallback(cb) {
+        this.contextCallbacks.push(cb);
+    }
+    // Le truc
+    getDocumentOffset(doc) {
+        if (isPatchedDocument(doc)) {
+            return doc.__openreplay__getOffset();
+        }
+        return { top: 0, left: 0 };
+    }
     handleIframe(iframe) {
         let doc = null;
+        let win = null;
         const handle = this.app.safe(() => {
             const id = this.app.nodes.getID(iframe);
             if (id === undefined) {
+                //log
                 return;
-            } //log
-            if (iframe.contentDocument === doc) {
-                return;
-            } // How frequently can it happen?
-            doc = iframe.contentDocument;
-            if (!doc || !iframe.contentWindow) {
-                return;
             }
-            const observer = new IFrameObserver(this.app);
-            this.iframeObservers.push(observer);
-            observer.observe(iframe);
+            const currentWin = iframe.contentWindow;
+            const currentDoc = iframe.contentDocument;
+            if (currentDoc && currentDoc !== doc) {
+                const observer = new IFrameObserver(this.app);
+                this.iframeObservers.push(observer);
+                observer.observe(iframe);
+                doc = currentDoc;
+                doc.__openreplay__getOffset = () => {
+                    const { top, left } = this.getDocumentOffset(iframe.ownerDocument);
+                    return {
+                        top: iframe.offsetTop + top,
+                        left: iframe.offsetLeft + left,
+                    };
+                };
+            }
+            if (currentWin &&
+                // Sometimes currentWin.window is null (not in specification). Such window object is not functional
+                currentWin === currentWin.window &&
+                !this.contextsSet.has(currentWin) // for each context callbacks called once per Tracker (TopObserver) instance
+            ) {
+                this.contextsSet.add(currentWin);
+                //@ts-ignore https://github.com/microsoft/TypeScript/issues/41684
+                this.contextCallbacks.forEach((cb) => cb(currentWin));
+                win = currentWin;
+            }
         });
-        iframe.addEventListener("load", handle); // why app.attachEventListener not working?
+        iframe.addEventListener('load', handle); // why app.attachEventListener not working?
         handle();
     }
     handleShadowRoot(shRoot) {
@@ -58,25 +92,26 @@ export default class TopObserver extends Observer {
         // Protection from several subsequent calls?
         const observer = this;
         Element.prototype.attachShadow = function () {
+            // eslint-disable-next-line
             const shadow = attachShadowNativeFn.apply(this, arguments);
             observer.handleShadowRoot(shadow);
             return shadow;
         };
         // Can observe documentElement (<html>) here, because it is not supposed to be changing.
         // However, it is possible in some exotic cases and may cause an ignorance of the newly created <html>
-        // In this case context.document have to be observed, but this will cause 
-        // the change in the re-player behaviour caused by CreateDocument message: 
+        // In this case context.document have to be observed, but this will cause
+        // the change in the re-player behaviour caused by CreateDocument message:
         //   the 0-node ("fRoot") will become #document rather than documentElement as it is now.
         // Alternatively - observe(#document) then bindNode(documentElement)
         this.observeRoot(window.document, () => {
-            this.app.send(new CreateDocument());
+            this.app.send(CreateDocument());
         }, window.document.documentElement);
     }
     disconnect() {
         Element.prototype.attachShadow = attachShadowNativeFn;
-        this.iframeObservers.forEach(o => o.disconnect());
+        this.iframeObservers.forEach((o) => o.disconnect());
         this.iframeObservers = [];
-        this.shadowRootObservers.forEach(o => o.disconnect());
+        this.shadowRootObservers.forEach((o) => o.disconnect());
         this.shadowRootObservers = [];
         super.disconnect();
     }

package/lib/app/sanitizer.d.ts

@@ -1,4 +1,4 @@
-import type App from "./index.js";
+import type App from './index.js';
 export interface Options {
     obscureTextEmails: boolean;
     obscureTextNumbers: boolean;

package/lib/app/sanitizer.js

@@ -1,5 +1,5 @@
-import { stars, hasOpenreplayAttribute } from "../utils.js";
-import { isElementNode } from "./guards.js";
+import { stars, hasOpenreplayAttribute } from '../utils.js';
+import { isElementNode } from './guards.js';
 export default class Sanitizer {
     constructor(app, options) {
         this.app = app;
@@ -12,20 +12,20 @@ export default class Sanitizer {
     }
     handleNode(id, parentID, node) {
         if (this.masked.has(parentID) ||
-            (isElementNode(node) &&
-                hasOpenreplayAttribute(node, 'masked'))) {
+            (isElementNode(node) && hasOpenreplayAttribute(node, 'masked'))) {
             this.masked.add(id);
         }
         if (this.maskedContainers.has(parentID) ||
-            (isElementNode(node) &&
-                hasOpenreplayAttribute(node, 'htmlmasked'))) {
+            (isElementNode(node) && hasOpenreplayAttribute(node, 'htmlmasked'))) {
             this.maskedContainers.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, '█');
+            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');

package/lib/app/session.d.ts

@@ -1,19 +1,37 @@
+import type App from './index.js';
 interface SessionInfo {
-    sessionID: string | null;
+    sessionID: string | undefined;
     metadata: Record<string, string>;
     userID: string | null;
+    timestamp: number;
+    projectID?: string;
 }
 declare type OnUpdateCallback = (i: Partial<SessionInfo>) => void;
+export declare type Options = {
+    session_token_key: string;
+    session_pageno_key: string;
+};
 export default class Session {
+    private readonly app;
+    private readonly options;
     private metadata;
     private userID;
     private sessionID;
-    private callbacks;
+    private readonly callbacks;
+    private timestamp;
+    private projectID;
+    constructor(app: App, options: Options);
     attachUpdateCallback(cb: OnUpdateCallback): void;
     private handleUpdate;
     update(newInfo: Partial<SessionInfo>): void;
     setMetadata(key: string, value: string): void;
     setUserID(userID: string): void;
+    private getPageNumber;
+    incPageNo(): number;
+    getSessionToken(): string | undefined;
+    setSessionToken(token: string): void;
+    applySessionHash(hash: string): void;
+    getSessionHash(): string | undefined;
     getInfo(): SessionInfo;
     reset(): void;
 }

package/lib/app/session.js

@@ -1,9 +1,11 @@
 export default class Session {
-    constructor() {
+    constructor(app, options) {
+        this.app = app;
+        this.options = options;
         this.metadata = {};
         this.userID = null;
-        this.sessionID = null;
         this.callbacks = [];
+        this.timestamp = 0;
     }
     attachUpdateCallback(cb) {
         this.callbacks.push(cb);
@@ -15,18 +17,25 @@ export default class Session {
         if (newInfo.sessionID == null) {
             delete newInfo.sessionID;
         }
-        this.callbacks.forEach(cb => cb(newInfo));
+        this.callbacks.forEach((cb) => cb(newInfo));
     }
     update(newInfo) {
-        if (newInfo.userID !== undefined) { // TODO clear nullable/undefinable types
+        if (newInfo.userID !== undefined) {
+            // TODO clear nullable/undefinable types
             this.userID = newInfo.userID;
         }
         if (newInfo.metadata !== undefined) {
-            Object.entries(newInfo.metadata).forEach(([k, v]) => this.metadata[k] = v);
+            Object.entries(newInfo.metadata).forEach(([k, v]) => (this.metadata[k] = v));
         }
         if (newInfo.sessionID !== undefined) {
             this.sessionID = newInfo.sessionID;
         }
+        if (newInfo.timestamp !== undefined) {
+            this.timestamp = newInfo.timestamp;
+        }
+        if (newInfo.projectID !== undefined) {
+            this.projectID = newInfo.projectID;
+        }
         this.handleUpdate(newInfo);
     }
     setMetadata(key, value) {
@@ -37,16 +46,66 @@ export default class Session {
         this.userID = userID;
         this.handleUpdate({ userID });
     }
+    getPageNumber() {
+        const pageNoStr = this.app.sessionStorage.getItem(this.options.session_pageno_key);
+        if (pageNoStr == null) {
+            return undefined;
+        }
+        return parseInt(pageNoStr);
+    }
+    incPageNo() {
+        let pageNo = this.getPageNumber();
+        if (pageNo === undefined) {
+            pageNo = 0;
+        }
+        else {
+            pageNo++;
+        }
+        this.app.sessionStorage.setItem(this.options.session_pageno_key, pageNo.toString());
+        return pageNo;
+    }
+    getSessionToken() {
+        return this.app.sessionStorage.getItem(this.options.session_token_key) || undefined;
+    }
+    setSessionToken(token) {
+        this.app.sessionStorage.setItem(this.options.session_token_key, token);
+    }
+    applySessionHash(hash) {
+        const hashParts = decodeURI(hash).split('&');
+        let token = hash;
+        let pageNoStr = '100500'; // back-compat for sessionToken
+        if (hashParts.length == 2) {
+            ;
+            [token, pageNoStr] = hashParts;
+        }
+        if (!pageNoStr || !token) {
+            return;
+        }
+        this.app.sessionStorage.setItem(this.options.session_token_key, token);
+        this.app.sessionStorage.setItem(this.options.session_pageno_key, pageNoStr);
+    }
+    getSessionHash() {
+        const pageNo = this.getPageNumber();
+        const token = this.getSessionToken();
+        if (pageNo === undefined || token === undefined) {
+            return;
+        }
+        return encodeURI(String(pageNo) + '&' + token);
+    }
     getInfo() {
         return {
             sessionID: this.sessionID,
             metadata: this.metadata,
             userID: this.userID,
+            timestamp: this.timestamp,
+            projectID: this.projectID,
         };
     }
     reset() {
+        this.app.sessionStorage.removeItem(this.options.session_token_key);
         this.metadata = {};
         this.userID = null;
-        this.sessionID = null;
+        this.sessionID = undefined;
+        this.timestamp = 0;
     }
 }

package/lib/app/ticker.d.ts

@@ -1,4 +1,4 @@
-import App from "./index.js";
+import App from './index.js';
 declare type Callback = () => void;
 export default class Ticker {
     private readonly app;