@openreplay/tracker 3.4.15 → 3.4.17

package/cjs/app/observer/observer.js

@@ -1,39 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isInstance = void 0;
-const utils_js_1 = require("../../utils.js");
 const index_js_1 = require("../../messages/index.js");
+const context_js_1 = require("../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)
-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];
-}
-exports.isInstance = isInstance;
 function isIgnored(node) {
-    if (isInstance(node, Text)) {
+    if ((0, context_js_1.isInstance)(node, Text)) {
         return false;
     }
-    if (!isInstance(node, Element)) {
+    if (!(0, context_js_1.isInstance)(node, Element)) {
         return true;
     }
     const tag = node.tagName.toUpperCase();
@@ -49,7 +25,7 @@ function isIgnored(node) {
         tag === 'BASE');
 }
 function isRootNode(node) {
-    return isInstance(node, Document) || isInstance(node, ShadowRoot);
+    return (0, context_js_1.isInstance)(node, Document) || (0, context_js_1.isInstance)(node, ShadowRoot);
 }
 function isObservable(node) {
     if (isRootNode(node)) {
@@ -58,7 +34,7 @@ function isObservable(node) {
     return !isIgnored(node);
 }
 class Observer {
-    constructor(app, options, context = window) {
+    constructor(app, context = window) {
         this.app = app;
         this.context = context;
         this.commited = [];
@@ -67,34 +43,12 @@ 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) || !(0, context_js_1.inDocument)(target)) {
                     continue;
                 }
                 if (type === 'childList') {
@@ -139,7 +93,6 @@ class Observer {
         this.indexes.length = 1;
         this.attributesList.length = 0;
         this.textSet.clear();
-        //this.textMasked.clear();
     }
     sendNodeAttribute(id, node, name, value) {
         if (isSVGElement(node)) {
@@ -169,7 +122,7 @@ class Observer {
             return;
         }
         if (name === 'value' &&
-            isInstance(node, HTMLInputElement) &&
+            (0, context_js_1.isInstance)(node, HTMLInputElement) &&
             node.type !== 'button' &&
             node.type !== 'reset' &&
             node.type !== 'submit') {
@@ -179,7 +132,7 @@ class Observer {
             this.app.send(new index_js_1.RemoveNodeAttribute(id, name));
             return;
         }
-        if (name === 'style' || name === 'href' && isInstance(node, HTMLLinkElement)) {
+        if (name === 'style' || name === 'href' && (0, context_js_1.isInstance)(node, HTMLLinkElement)) {
             this.app.send(new index_js_1.SetNodeAttributeURLBased(id, name, value, this.app.getBaseHref()));
             return;
         }
@@ -188,35 +141,14 @@ class Observer {
         }
         this.app.send(new index_js_1.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) => (0, utils_js_1.stars)(f[1]) + '@' + (0, utils_js_1.stars)(f[2]) + '.' + (0, utils_js_1.stars)(f[3]));
-        }
-        return data;
-    }
     sendNodeData(id, parentElement, data) {
-        if (isInstance(parentElement, HTMLStyleElement) || isInstance(parentElement, SVGStyleElement)) {
+        if ((0, context_js_1.isInstance)(parentElement, HTMLStyleElement) || (0, context_js_1.isInstance)(parentElement, SVGStyleElement)) {
             this.app.send(new index_js_1.SetCSSDataURLBased(id, data, this.app.getBaseHref()));
             return;
         }
-        data = this.checkObscure(id, data);
+        data = this.app.sanitizer.sanitize(id, data);
         this.app.send(new index_js_1.SetNodeData(id, data));
     }
-    /* end TODO:  abstract sanitation */
     bindNode(node) {
         const r = this.app.nodes.registerNode(node);
         const id = r[0];
@@ -254,7 +186,7 @@ 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 (!isInstance(node, HTMLHtmlElement) || !this.inUpperContext) {
+        if (!(0, context_js_1.isInstance)(node, HTMLHtmlElement) || !this.inUpperContext) {
             if (parent === null) {
                 this.unbindNode(node);
                 return false;
@@ -268,10 +200,7 @@ class Observer {
                 this.unbindNode(node);
                 return false;
             }
-            if (this.textMasked.has(parentID) ||
-                (isInstance(node, Element) && (0, utils_js_1.hasOpenreplayAttribute)(node, 'masked'))) {
-                this.textMasked.add(id);
-            }
+            this.app.sanitizer.handleNode(id, parentID, node);
         }
         let sibling = node.previousSibling;
         while (sibling !== null) {
@@ -292,7 +221,7 @@ class Observer {
             throw 'commitNode: missing node index';
         }
         if (isNew === true) {
-            if (isInstance(node, Element)) {
+            if ((0, context_js_1.isInstance)(node, Element)) {
                 if (parentID !== undefined) {
                     this.app.send(new index_js_1.CreateElementNode(id, parentID, index, node.tagName, isSVGElement(node)));
                 }
@@ -301,7 +230,7 @@ class Observer {
                     this.sendNodeAttribute(id, node, attr.nodeName, attr.value);
                 }
             }
-            else if (isInstance(node, Text)) {
+            else if ((0, context_js_1.isInstance)(node, Text)) {
                 // for text node id != 0, hence parentID !== undefined and parent is Element
                 this.app.send(new index_js_1.CreateTextNode(id, parentID, index));
                 this.sendNodeData(id, parent, node.data);
@@ -313,7 +242,7 @@ class Observer {
         }
         const attr = this.attributesList[id];
         if (attr !== undefined) {
-            if (!isInstance(node, Element)) {
+            if (!(0, context_js_1.isInstance)(node, Element)) {
                 throw 'commitNode: node is not an element';
             }
             for (const name of attr) {
@@ -321,7 +250,7 @@ class Observer {
             }
         }
         if (this.textSet.has(id)) {
-            if (!isInstance(node, Text)) {
+            if (!(0, context_js_1.isInstance)(node, Text)) {
                 throw 'commitNode: node is not a text';
             }
             // for text node id != 0, hence parent is Element
@@ -344,8 +273,7 @@ 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;
             }
@@ -373,8 +301,6 @@ class Observer {
     disconnect() {
         this.observer.disconnect();
         this.clear();
-        // to sanitizer
-        this.textMasked.clear();
         this.myNodes.length = 0;
     }
 }

package/cjs/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/cjs/app/observer/top_observer.js

@@ -1,27 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const observer_js_1 = require("./observer.js");
+const context_js_1 = require("../context.js");
 const iframe_observer_js_1 = require("./iframe_observer.js");
 const shadow_root_observer_js_1 = require("./shadow_root_observer.js");
 const index_js_1 = require("../../messages/index.js");
-const attachShadowNativeFn = Element.prototype.attachShadow;
+const utils_js_1 = require("../../utils.js");
+const attachShadowNativeFn = utils_js_1.IN_BROWSER ? Element.prototype.attachShadow : () => new ShadowRoot();
 class TopObserver extends observer_js_1.default {
     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 ((0, observer_js_1.isInstance)(node, HTMLIFrameElement) &&
+            if ((0, context_js_1.isInstance)(node, HTMLIFrameElement) &&
                 (this.options.captureIFrames || node.getAttribute("data-openreplay-capture"))) {
                 this.handleIframe(node);
             }
         });
         // ShadowDOM
         this.app.nodes.attachNodeCallback(node => {
-            if ((0, observer_js_1.isInstance)(node, Element) && node.shadowRoot !== null) {
+            if ((0, context_js_1.isInstance)(node, Element) && node.shadowRoot !== null) {
                 this.handleShadowRoot(node.shadowRoot);
             }
         });
@@ -40,7 +43,7 @@ class TopObserver extends observer_js_1.default {
             if (!context) {
                 return;
             }
-            const observer = new iframe_observer_js_1.default(this.app, this.options, context);
+            const observer = new iframe_observer_js_1.default(this.app, context);
             this.iframeObservers.push(observer);
             observer.observe(iframe);
         });
@@ -48,7 +51,7 @@ class TopObserver extends observer_js_1.default {
         handle();
     }
     handleShadowRoot(shRoot) {
-        const observer = new shadow_root_observer_js_1.default(this.app, this.options, this.context);
+        const observer = new shadow_root_observer_js_1.default(this.app, this.context);
         this.shadowRootObservers.push(observer);
         observer.observe(shRoot.host);
     }

package/cjs/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/cjs/app/sanitizer.js

@@ -1 +1,47 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_js_1 = require("../utils.js");
+const context_js_1 = require("./context.js");
+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) ||
+            ((0, context_js_1.isInstance)(node, Element) && (0, utils_js_1.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) => (0, utils_js_1.stars)(f[1]) + '@' + (0, utils_js_1.stars)(f[2]) + '.' + (0, utils_js_1.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();
+    }
+}
+exports.default = Sanitizer;

package/cjs/index.d.ts

@@ -2,18 +2,20 @@ import App from "./app/index.js";
 export { default as App } from './app/index.js';
 import * as _Messages from "./messages/index.js";
 export declare const Messages: typeof _Messages;
-import { Options as AppOptions } from "./app/index.js";
-import { Options as ConsoleOptions } from "./modules/console.js";
-import { Options as ExceptionOptions } from "./modules/exception.js";
-import { Options as InputOptions } from "./modules/input.js";
-import { Options as PerformanceOptions } from "./modules/performance.js";
-import { Options as TimingOptions } from "./modules/timing.js";
-export type { OnStartInfo } from './app/index.js';
+import type { Options as AppOptions } from "./app/index.js";
+import type { Options as ConsoleOptions } from "./modules/console.js";
+import type { Options as ExceptionOptions } from "./modules/exception.js";
+import type { Options as InputOptions } from "./modules/input.js";
+import type { Options as PerformanceOptions } from "./modules/performance.js";
+import type { Options as TimingOptions } from "./modules/timing.js";
+import type { StartOptions } from './app/index.js';
+import type { OnStartInfo } from './app/index.js';
 export declare type Options = Partial<AppOptions & ConsoleOptions & ExceptionOptions & InputOptions & PerformanceOptions & TimingOptions> & {
     projectID?: number;
     projectKey: string;
     sessionToken?: string;
     respectDoNotTrack?: boolean;
+    autoResetOnWindowOpen?: boolean;
     __DISABLE_SECURE_MODE?: boolean;
 };
 export default class API {
@@ -23,7 +25,7 @@ export default class API {
     use<T>(fn: (app: App | null, options?: Options) => T): T;
     isActive(): boolean;
     active(): boolean;
-    start(): Promise<import("./app/index.js").OnStartInfo>;
+    start(startOpts?: StartOptions): Promise<OnStartInfo>;
     stop(): void;
     getSessionToken(): string | null | undefined;
     getSessionID(): string | null | undefined;

package/cjs/index.js

@@ -81,7 +81,7 @@ class API {
             (navigator.doNotTrack == '1'
                 // @ts-ignore
                 || window.doNotTrack == '1');
-        this.app = doNotTrack ||
+        const app = this.app = doNotTrack ||
             !('Map' in window) ||
             !('Set' in window) ||
             !('MutationObserver' in window) ||
@@ -92,20 +92,34 @@ class API {
             !('Worker' in window)
             ? null
             : new index_js_1.default(options.projectKey, options.sessionToken, options);
-        if (this.app !== null) {
-            (0, viewport_js_1.default)(this.app);
-            (0, cssrules_js_1.default)(this.app);
-            (0, connection_js_1.default)(this.app);
-            (0, console_js_1.default)(this.app, options);
-            (0, exception_js_1.default)(this.app, options);
-            (0, img_js_1.default)(this.app);
-            (0, input_js_1.default)(this.app, options);
-            (0, mouse_js_1.default)(this.app);
-            (0, timing_js_1.default)(this.app, options);
-            (0, performance_js_1.default)(this.app, options);
-            (0, scroll_js_1.default)(this.app);
-            (0, longtasks_js_1.default)(this.app);
+        if (app !== null) {
+            (0, viewport_js_1.default)(app);
+            (0, cssrules_js_1.default)(app);
+            (0, connection_js_1.default)(app);
+            (0, console_js_1.default)(app, options);
+            (0, exception_js_1.default)(app, options);
+            (0, img_js_1.default)(app);
+            (0, input_js_1.default)(app, options);
+            (0, mouse_js_1.default)(app);
+            (0, timing_js_1.default)(app, options);
+            (0, performance_js_1.default)(app, options);
+            (0, scroll_js_1.default)(app);
+            (0, longtasks_js_1.default)(app);
             window.__OPENREPLAY__ = this;
+            if (options.autoResetOnWindowOpen) {
+                const wOpen = window.open;
+                app.attachStartCallback(() => {
+                    // @ts-ignore ?
+                    window.open = function (...args) {
+                        app.resetNextPageSession(true);
+                        wOpen.call(window, ...args);
+                        app.resetNextPageSession(false);
+                    };
+                });
+                app.attachStopCallback(() => {
+                    window.open = wOpen;
+                });
+            }
         }
         else {
             console.log("OpenReplay: browser doesn't support API required for tracking or doNotTrack is set to 1.");
@@ -115,7 +129,7 @@ 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.15',
+                trackerVersion: '3.4.17',
                 projectKey: options.projectKey,
                 doNotTrack,
                 // TODO: add precise reason (an exact API missing)
@@ -135,7 +149,7 @@ class API {
         (0, utils_js_1.deprecationWarn)("'active' method", "'isActive' method", "/");
         return this.isActive();
     }
-    start() {
+    start(startOpts) {
         if (!utils_js_1.IN_BROWSER) {
             console.error(`OpenReplay: you are trying to start Tracker on a node.js environment. If you want to use OpenReplay with SSR, please, use componentDidMount or useEffect API for placing the \`tracker.start()\` line. Check documentation on ${utils_js_1.DOCS_HOST}${DOCS_SETUP}`);
             return Promise.reject("Trying to start not in browser.");
@@ -143,7 +157,7 @@ class API {
         if (this.app === null) {
             return Promise.reject("Browser doesn't support required api, or doNotTrack is active.");
         }
-        return this.app.start();
+        return this.app.start(startOpts);
     }
     stop() {
         if (this.app === null) {

package/cjs/modules/exception.js

@@ -41,7 +41,14 @@ function getExceptionMessageFromEvent(e) {
             return getExceptionMessage(e.reason, []);
         }
         else {
-            return new index_js_1.JSException('Unhandled Promise Rejection', String(e.reason), '[]');
+            let message;
+            try {
+                message = JSON.stringify(e.reason);
+            }
+            catch (_) {
+                message = String(e.reason);
+            }
+            return new index_js_1.JSException('Unhandled Promise Rejection', message, '[]');
         }
     }
     return null;

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;
+}