@statsig/web-analytics 0.0.1-beta.28 → 0.0.1-beta.29

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@statsig/web-analytics",
-  "version": "0.0.1-beta.28",
+  "version": "0.0.1-beta.29",
   "dependencies": {
-    "@statsig/client-core": "0.0.1-beta.28",
-    "@statsig/js-client": "0.0.1-beta.28"
+    "@statsig/client-core": "0.0.1-beta.29",
+    "@statsig/js-client": "0.0.1-beta.29"
   },
   "jsdelivr": "./build/statsig-web-analytics.min.js",
   "type": "commonjs",

package/src/AutoCapture.d.ts

@@ -2,6 +2,7 @@ import { StatsigClient } from '@statsig/js-client';
 export declare function runStatsigAutoCapture(client: StatsigClient): void;
 export declare class AutoCapture {
     private _client;
+    private _errorBoundary;
     private _startTime;
     private _deepestScroll;
     constructor(_client: StatsigClient);

package/src/AutoCapture.js

@@ -14,28 +14,33 @@ class AutoCapture {
         this._startTime = Date.now();
         this._deepestScroll = 0;
         const { sdkKey } = _client.getContext();
+        this._errorBoundary = new client_core_1.ErrorBoundary(sdkKey);
+        (0, client_core_1.monitorClass)(this._errorBoundary, this);
         __STATSIG__ = __STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {};
         const instances = (_a = __STATSIG__.acInstances) !== null && _a !== void 0 ? _a : {};
         instances[sdkKey] = this;
         __STATSIG__.acInstances = instances;
-        if (typeof document !== 'undefined' && document.readyState === 'loading') {
-            document.addEventListener('DOMContentLoaded', () => this._initialize());
+        const doc = (0, Utils_1._getDocumentSafe)();
+        if ((doc === null || doc === void 0 ? void 0 : doc.readyState) === 'loading') {
+            doc.addEventListener('DOMContentLoaded', () => this._initialize());
             return;
         }
         this._initialize();
     }
     _addEventHandlers() {
-        if (typeof window === 'undefined' || typeof document === 'undefined') {
+        const win = (0, Utils_1._getWindowSafe)();
+        const doc = (0, Utils_1._getDocumentSafe)();
+        if (!win || !doc) {
             return;
         }
         const eventHandler = (event) => {
-            this._autoLogEvent(event || window.event);
+            this._autoLogEvent(event || win.event);
         };
-        (0, Utils_1.registerEventHandler)(document, 'click', eventHandler);
-        (0, Utils_1.registerEventHandler)(document, 'submit', eventHandler);
-        (0, Utils_1.registerEventHandler)(window, 'error', eventHandler);
-        (0, Utils_1.registerEventHandler)(window, 'beforeunload', () => this._pageUnloadHandler());
-        (0, Utils_1.registerEventHandler)(window, 'scroll', () => this._scrollEventHandler());
+        (0, Utils_1._registerEventHandler)(doc, 'click', eventHandler);
+        (0, Utils_1._registerEventHandler)(doc, 'submit', eventHandler);
+        (0, Utils_1._registerEventHandler)(win, 'error', eventHandler);
+        (0, Utils_1._registerEventHandler)(win, 'beforeunload', () => this._pageUnloadHandler());
+        (0, Utils_1._registerEventHandler)(win, 'scroll', () => this._scrollEventHandler());
     }
     _autoLogEvent(event) {
         var _a;
@@ -44,17 +49,17 @@ class AutoCapture {
             this._logError(event);
             return;
         }
-        const target = (0, Utils_1.getTargetNode)(event);
+        const target = (0, Utils_1._getTargetNode)(event);
         if (!target) {
             return;
         }
-        if (!(0, Utils_1.shouldLogEvent)(event, target)) {
+        if (!(0, Utils_1._shouldLogEvent)(event, target)) {
             return;
         }
         if (eventType === 'submit') {
             eventType = 'form_submit';
         }
-        const { value, metadata } = (0, Utils_1.gatherEventData)(target);
+        const { value, metadata } = (0, Utils_1._gatherEventData)(target);
         this._enqueueAutoCapture(eventType, value, metadata);
     }
     _initialize() {
@@ -86,23 +91,24 @@ class AutoCapture {
     }
     _logPageView() {
         setTimeout(() => {
-            const url = (0, Utils_1.getSafeUrl)();
-            this._logAutoCaptureImmediately('page_view', (0, Utils_1.getSanitizedPageUrl)(), {
-                title: document === null || document === void 0 ? void 0 : document.title,
+            var _a;
+            const url = (0, Utils_1._getSafeUrl)();
+            this._logAutoCaptureImmediately('page_view', (0, Utils_1._getSanitizedPageUrl)(), {
+                title: (_a = (0, Utils_1._getDocumentSafe)()) === null || _a === void 0 ? void 0 : _a.title,
                 queryParams: Object.fromEntries(url.searchParams),
             });
         }, 1);
     }
     _logPerformance() {
-        if (typeof window === 'undefined' ||
-            typeof window.performance === 'undefined' ||
-            typeof window.performance.getEntriesByType !== 'function' ||
-            typeof window.performance.getEntriesByName !== 'function') {
+        const win = (0, Utils_1._getWindowSafe)();
+        if (typeof (win === null || win === void 0 ? void 0 : win.performance) === 'undefined' ||
+            typeof win.performance.getEntriesByType !== 'function' ||
+            typeof win.performance.getEntriesByName !== 'function') {
             return;
         }
         setTimeout(() => {
             const metadata = {};
-            const navEntries = window.performance.getEntriesByType('navigation');
+            const navEntries = win.performance.getEntriesByType('navigation');
             if (navEntries &&
                 navEntries.length > 0 &&
                 navEntries[0] instanceof PerformanceNavigationTiming) {
@@ -113,27 +119,27 @@ class AutoCapture {
                 metadata['redirect_count'] = nav.redirectCount;
                 metadata['transfer_bytes'] = nav.transferSize;
             }
-            const fpEntries = window.performance.getEntriesByName('first-contentful-paint');
+            const fpEntries = win.performance.getEntriesByName('first-contentful-paint');
             if (fpEntries &&
                 fpEntries.length > 0 &&
                 fpEntries[0] instanceof PerformancePaintTiming) {
                 metadata['first_contentful_paint_time_ms'] = fpEntries[0].startTime;
             }
-            this._enqueueAutoCapture('performance', (0, Utils_1.getSanitizedPageUrl)(), metadata);
+            this._enqueueAutoCapture('performance', (0, Utils_1._getSanitizedPageUrl)(), metadata);
         }, 1);
     }
     _pageUnloadHandler() {
-        this._logAutoCaptureImmediately('page_view_end', (0, Utils_1.getSanitizedPageUrl)(), {
+        this._logAutoCaptureImmediately('page_view_end', (0, Utils_1._getSanitizedPageUrl)(), {
             scrollDepth: this._deepestScroll,
             pageViewLength: Date.now() - this._startTime,
         });
     }
     _enqueueAutoCapture(name, value, metadata) {
-        var _a;
+        var _a, _b, _c;
         const event = {
             eventName: `auto_capture::${name}`,
             value,
-            metadata: Object.assign({ sessionId: (0, Utils_1.getWebSessionId)(this._client.getContext().sdkKey), page_url: ((_a = window === null || window === void 0 ? void 0 : window.location) === null || _a === void 0 ? void 0 : _a.href) || '' }, metadata),
+            metadata: Object.assign({ sessionId: (0, Utils_1._getWebSessionId)(this._client.getContext().sdkKey), page_url: (_c = (_b = (_a = (0, Utils_1._getWindowSafe)()) === null || _a === void 0 ? void 0 : _a.location) === null || _b === void 0 ? void 0 : _b.href) !== null && _c !== void 0 ? _c : '' }, metadata),
         };
         this._client.logEvent(event);
         client_core_1.Log.debug('Enqueued Event', event);
@@ -145,8 +151,12 @@ class AutoCapture {
         });
     }
     _scrollEventHandler() {
-        const scrollHeight = document.body.scrollHeight || 1;
-        this._deepestScroll = Math.max(this._deepestScroll, Math.min(100, Math.round(((window.scrollY + window.innerHeight) / scrollHeight) * 100)));
+        var _a, _b, _c, _d;
+        const scrollHeight = (_b = (_a = (0, Utils_1._getDocumentSafe)()) === null || _a === void 0 ? void 0 : _a.body.scrollHeight) !== null && _b !== void 0 ? _b : 1;
+        const win = (0, Utils_1._getWindowSafe)();
+        const scrollY = (_c = win === null || win === void 0 ? void 0 : win.scrollY) !== null && _c !== void 0 ? _c : 1;
+        const innerHeight = (_d = win === null || win === void 0 ? void 0 : win.innerHeight) !== null && _d !== void 0 ? _d : 1;
+        this._deepestScroll = Math.max(this._deepestScroll, Math.min(100, Math.round(((scrollY + innerHeight) / scrollHeight) * 100)));
     }
 }
 exports.AutoCapture = AutoCapture;

package/src/Utils.d.ts

@@ -1,10 +1,12 @@
-export declare function gatherEventData(target: Element): {
+export declare function _getDocumentSafe(): Document | null;
+export declare function _getWindowSafe(): Window | null;
+export declare function _gatherEventData(target: Element): {
     value: string;
     metadata: Record<string, string | null>;
 };
-export declare function getTargetNode(e: Event): Element | null;
-export declare function shouldLogEvent(e: Event, el: Element): boolean;
-export declare function getSafeUrl(): URL;
-export declare function getWebSessionId(sdkKey: string): string;
-export declare function getSanitizedPageUrl(): string;
-export declare function registerEventHandler(element: Document | Window, eventType: string, handler: (event: Event) => void): void;
+export declare function _getTargetNode(e: Event): Element | null;
+export declare function _shouldLogEvent(e: Event, el: Element): boolean;
+export declare function _getSafeUrl(): URL;
+export declare function _getWebSessionId(sdkKey: string): string;
+export declare function _getSanitizedPageUrl(): string;
+export declare function _registerEventHandler(element: Document | Window, eventType: string, handler: (event: Event) => void): void;

package/src/Utils.js

@@ -1,11 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerEventHandler = exports.getSanitizedPageUrl = exports.getWebSessionId = exports.getSafeUrl = exports.shouldLogEvent = exports.getTargetNode = exports.gatherEventData = void 0;
+exports._registerEventHandler = exports._getSanitizedPageUrl = exports._getWebSessionId = exports._getSafeUrl = exports._shouldLogEvent = exports._getTargetNode = exports._gatherEventData = exports._getWindowSafe = exports._getDocumentSafe = void 0;
 const client_core_1 = require("@statsig/client-core");
 const MAX_SESSION_IDLE_TIME = 10 * 60 * 1000; // 10 minutes
 const MAX_SESSION_AGE = 4 * 60 * 60 * 1000; // 4 hours
 const globals = {};
-function gatherEventData(target) {
+function _getDocumentSafe() {
+    var _a;
+    const win = _getWindowSafe();
+    return (_a = win === null || win === void 0 ? void 0 : win.document) !== null && _a !== void 0 ? _a : null;
+}
+exports._getDocumentSafe = _getDocumentSafe;
+function _getWindowSafe() {
+    return typeof window !== 'undefined' ? window : null;
+}
+exports._getWindowSafe = _getWindowSafe;
+function _gatherEventData(target) {
     var _a;
     const tagName = target.tagName.toLowerCase();
     const metadata = {};
@@ -30,8 +40,8 @@ function gatherEventData(target) {
     }
     return { value, metadata };
 }
-exports.gatherEventData = gatherEventData;
-function getTargetNode(e) {
+exports._gatherEventData = _gatherEventData;
+function _getTargetNode(e) {
     if (!e) {
         return null;
     }
@@ -44,8 +54,8 @@ function getTargetNode(e) {
     }
     return target;
 }
-exports.getTargetNode = getTargetNode;
-function shouldLogEvent(e, el) {
+exports._getTargetNode = _getTargetNode;
+function _shouldLogEvent(e, el) {
     if (!e || !el || el.nodeType !== 1) {
         return false;
     }
@@ -73,10 +83,10 @@ function shouldLogEvent(e, el) {
             return false;
     }
 }
-exports.shouldLogEvent = shouldLogEvent;
-function getSafeUrl() {
-    var _a;
-    const href = ((_a = window === null || window === void 0 ? void 0 : window.location) === null || _a === void 0 ? void 0 : _a.href) || '';
+exports._shouldLogEvent = _shouldLogEvent;
+function _getSafeUrl() {
+    var _a, _b, _c;
+    const href = (_c = (_b = (_a = _getWindowSafe()) === null || _a === void 0 ? void 0 : _a.location) === null || _b === void 0 ? void 0 : _b.href) !== null && _c !== void 0 ? _c : '';
     let url;
     try {
         url = new URL(href);
@@ -86,8 +96,8 @@ function getSafeUrl() {
     }
     return url;
 }
-exports.getSafeUrl = getSafeUrl;
-function getWebSessionId(sdkKey) {
+exports._getSafeUrl = _getSafeUrl;
+function _getWebSessionId(sdkKey) {
     const key = `statsig.web_analytics.session.${(0, client_core_1.DJB2)(sdkKey)}`;
     const json = _getLocalValue(key);
     const now = Date.now();
@@ -103,20 +113,20 @@ function getWebSessionId(sdkKey) {
     _setLocalValue(key, JSON.stringify(session));
     return session.id;
 }
-exports.getWebSessionId = getWebSessionId;
-function getSanitizedPageUrl() {
-    var _a, _b;
-    const url = (_b = (_a = window === null || window === void 0 ? void 0 : window.location) === null || _a === void 0 ? void 0 : _a.href) === null || _b === void 0 ? void 0 : _b.split(/[?#]/)[0];
+exports._getWebSessionId = _getWebSessionId;
+function _getSanitizedPageUrl() {
+    var _a, _b, _c;
+    const url = (_c = (_b = (_a = _getWindowSafe()) === null || _a === void 0 ? void 0 : _a.location) === null || _b === void 0 ? void 0 : _b.href) === null || _c === void 0 ? void 0 : _c.split(/[?#]/)[0];
     return url || '';
 }
-exports.getSanitizedPageUrl = getSanitizedPageUrl;
-function registerEventHandler(element, eventType, handler) {
+exports._getSanitizedPageUrl = _getSanitizedPageUrl;
+function _registerEventHandler(element, eventType, handler) {
     if (!element || !element.addEventListener) {
         return;
     }
     element.addEventListener(eventType, handler, true);
 }
-exports.registerEventHandler = registerEventHandler;
+exports._registerEventHandler = _registerEventHandler;
 function _getAnchorNodeInHierarchy(node) {
     if (!node) {
         return null;
@@ -135,17 +145,19 @@ function _getAnchorNodeInHierarchy(node) {
     return null;
 }
 function _setLocalValue(key, value) {
-    if (window && window.localStorage) {
-        window.localStorage.setItem(key, value);
+    const win = _getWindowSafe();
+    if (win && win.localStorage) {
+        win.localStorage.setItem(key, value);
     }
     else {
         globals[key] = value;
-        client_core_1.Log.error('Statsig Web AutoCapture: No window.localStorage');
+        client_core_1.Log.error('AutoCapture: No window.localStorage');
     }
 }
 function _getLocalValue(key) {
-    if (window && window.localStorage) {
-        return window.localStorage.getItem(key);
+    const win = _getWindowSafe();
+    if (win && win.localStorage) {
+        return win.localStorage.getItem(key);
     }
     return globals[key];
 }