@statsig/client-core 0.0.1-beta.40 → 0.0.1-beta.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statsig/client-core",
-  "version": "0.0.1-beta.40",
+  "version": "0.0.1-beta.42",
   "dependencies": {},
   "type": "commonjs",
   "main": "./src/index.js",

package/src/$_StatsigGlobal.js

@@ -4,12 +4,15 @@ var _a, _b, _c;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._getInstance = exports._getStatsigGlobal = void 0;
 const _getStatsigGlobal = () => {
-    return __STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : statsigGlobal;
+    return __STATSIG__ ? __STATSIG__ : statsigGlobal;
 };
 exports._getStatsigGlobal = _getStatsigGlobal;
 const _getInstance = (sdkKey) => {
-    var _a;
-    return sdkKey ? (_a = __STATSIG__ === null || __STATSIG__ === void 0 ? void 0 : __STATSIG__.instances) === null || _a === void 0 ? void 0 : _a[sdkKey] : __STATSIG__ === null || __STATSIG__ === void 0 ? void 0 : __STATSIG__.lastInstance;
+    const gbl = (0, exports._getStatsigGlobal)();
+    if (!sdkKey) {
+        return gbl.lastInstance;
+    }
+    return gbl.instances && gbl.instances[sdkKey];
 };
 exports._getInstance = _getInstance;
 const GLOBAL_KEY = '__STATSIG__';

package/src/CacheKey.d.ts

@@ -0,0 +1,4 @@
+import { StatsigUser } from './StatsigUser';
+export type CustomCacheKeyGenerator = (sdkKey: string, user: StatsigUser) => string;
+export declare function _getUserStorageKey(sdkKey: string, user: StatsigUser, customKeyGenerator?: CustomCacheKeyGenerator): string;
+export declare function _getStorageKey(sdkKey: string, user?: StatsigUser, customKeyGenerator?: CustomCacheKeyGenerator): string;

package/src/CacheKey.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._getStorageKey = exports._getUserStorageKey = void 0;
+const Hashing_1 = require("./Hashing");
+function _getUserStorageKey(sdkKey, user, customKeyGenerator) {
+    var _a, _b;
+    if (customKeyGenerator) {
+        return customKeyGenerator(sdkKey, user);
+    }
+    const parts = [
+        `uid:${(_a = user === null || user === void 0 ? void 0 : user.userID) !== null && _a !== void 0 ? _a : ''}`,
+        `cids:${Object.entries((_b = user === null || user === void 0 ? void 0 : user.customIDs) !== null && _b !== void 0 ? _b : {})
+            .sort(([leftKey], [rightKey]) => leftKey.localeCompare(rightKey))
+            .map(([key, value]) => `${key}-${value}`)
+            .join(',')}`,
+        `k:${sdkKey}`,
+    ];
+    return (0, Hashing_1._DJB2)(parts.join('|'));
+}
+exports._getUserStorageKey = _getUserStorageKey;
+function _getStorageKey(sdkKey, user, customKeyGenerator) {
+    if (user) {
+        return _getUserStorageKey(sdkKey, user, customKeyGenerator);
+    }
+    return (0, Hashing_1._DJB2)(`k:${sdkKey}`);
+}
+exports._getStorageKey = _getStorageKey;

package/src/DataAdapterCore.d.ts

@@ -3,12 +3,13 @@ import { AnyStatsigOptions } from './StatsigOptionsCommon';
 import { StatsigUser } from './StatsigUser';
 export declare abstract class DataAdapterCore {
     private _adapterName;
-    private _cacheSuffix;
+    protected _cacheSuffix: string;
+    protected _options: AnyStatsigOptions | null;
     private _sdkKey;
     private _inMemoryCache;
     private _lastModifiedStoreKey;
     protected constructor(_adapterName: string, _cacheSuffix: string);
-    attach(sdkKey: string, _options: AnyStatsigOptions | null): void;
+    attach(sdkKey: string, options: AnyStatsigOptions | null): void;
     getDataSync(user?: StatsigUser | undefined): DataAdapterResult | null;
     setData(data: string, user?: StatsigUser): void;
     /**
@@ -20,10 +21,9 @@ export declare abstract class DataAdapterCore {
     protected _getDataAsyncImpl(current: DataAdapterResult | null, user?: StatsigUser, options?: DataAdapterAsyncOptions): Promise<DataAdapterResult | null>;
     protected _prefetchDataImpl(user?: StatsigUser, options?: DataAdapterAsyncOptions): Promise<void>;
     protected abstract _fetchFromNetwork(current: string | null, user?: StatsigUser, options?: DataAdapterAsyncOptions): Promise<string | null>;
+    protected abstract _getCacheKey(user?: StatsigUser): string;
     private _fetchAndPrepFromNetwork;
     protected _getSdkKey(): string;
-    protected _getCacheKey(user?: StatsigUser): string;
-    protected _addToInMemoryCache(cacheKey: string, result: DataAdapterResult): void;
     private _loadFromCache;
     private _writeToCache;
     private _runLocalStorageCacheEviction;

package/src/DataAdapterCore.js

@@ -11,7 +11,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataAdapterCore = void 0;
 const Log_1 = require("./Log");
-const StatsigDataAdapter_1 = require("./StatsigDataAdapter");
+const StableID_1 = require("./StableID");
 const StatsigUser_1 = require("./StatsigUser");
 const StorageProvider_1 = require("./StorageProvider");
 const TypedJsonParse_1 = require("./TypedJsonParse");
@@ -20,33 +20,33 @@ class DataAdapterCore {
     constructor(_adapterName, _cacheSuffix) {
         this._adapterName = _adapterName;
         this._cacheSuffix = _cacheSuffix;
+        this._options = null;
         this._sdkKey = null;
-        this._inMemoryCache = {};
         this._lastModifiedStoreKey = `statsig.last_modified_time.${_cacheSuffix}`;
+        this._inMemoryCache = new InMemoryCache();
     }
-    attach(sdkKey, _options) {
+    attach(sdkKey, options) {
         this._sdkKey = sdkKey;
+        this._options = options;
     }
     getDataSync(user) {
         const cacheKey = this._getCacheKey(user);
-        const result = this._inMemoryCache[cacheKey];
-        if (result) {
-            return result;
+        const inMem = this._inMemoryCache.get(cacheKey, user);
+        if (inMem) {
+            return inMem;
         }
         const cache = this._loadFromCache(cacheKey);
         if (cache) {
-            this._addToInMemoryCache(cacheKey, cache);
-            return this._inMemoryCache[cacheKey];
+            this._inMemoryCache.add(cacheKey, cache);
+            return this._inMemoryCache.get(cacheKey, user);
         }
         return null;
     }
     setData(data, user) {
-        const cacheKey = this._getCacheKey(user);
-        this._addToInMemoryCache(cacheKey, {
-            source: 'Bootstrap',
-            data,
-            receivedAt: Date.now(),
-        });
+        var _a;
+        const normalized = user && (0, StatsigUser_1._normalizeUser)(user, (_a = this._options) === null || _a === void 0 ? void 0 : _a.environment);
+        const cacheKey = this._getCacheKey(normalized);
+        this._inMemoryCache.add(cacheKey, _makeDataAdapterResult('Bootstrap', data, null));
     }
     /**
      * (Internal Use Only) - Used by \@statsig/react-native-bindings to prime the cache from AsyncStorage
@@ -54,7 +54,7 @@ class DataAdapterCore {
      * @param {Record<string, DataAdapterResult>} cache The values to merge into _inMemoryCache
      */
     __primeInMemoryCache(cache) {
-        this._inMemoryCache = Object.assign(Object.assign({}, this._inMemoryCache), cache);
+        this._inMemoryCache.merge(cache);
     }
     _getDataAsyncImpl(current, user, options) {
         var _a;
@@ -77,7 +77,7 @@ class DataAdapterCore {
             const cacheKey = this._getCacheKey(user);
             const result = yield this._getDataAsyncImpl(null, user, options);
             if (result) {
-                this._addToInMemoryCache(cacheKey, Object.assign(Object.assign({}, result), { source: 'Prefetch' }));
+                this._inMemoryCache.add(cacheKey, Object.assign(Object.assign({}, result), { source: 'Prefetch' }));
             }
         });
     }
@@ -88,23 +88,21 @@ class DataAdapterCore {
                 Log_1.Log.debug('No response returned for latest value');
                 return null;
             }
-            const response = (0, TypedJsonParse_1.typedJsonParse)(latest, 'has_updates', 'Failure while attempting to persist latest value');
+            const response = (0, TypedJsonParse_1._typedJsonParse)(latest, 'has_updates', 'Initialize Response');
+            const sdkKey = this._getSdkKey();
+            const stableID = yield StableID_1.StableID.get(sdkKey);
             let result = null;
             if ((response === null || response === void 0 ? void 0 : response.has_updates) === true) {
-                result = { source: 'Network', data: latest, receivedAt: Date.now() };
+                result = _makeDataAdapterResult('Network', latest, stableID);
             }
             else if (current && (response === null || response === void 0 ? void 0 : response.has_updates) === false) {
-                result = {
-                    source: 'NetworkNotModified',
-                    data: current,
-                    receivedAt: Date.now(),
-                };
+                result = _makeDataAdapterResult('NetworkNotModified', current, stableID);
             }
-            if (!result) {
+            else {
                 return null;
             }
             const cacheKey = this._getCacheKey(user);
-            this._addToInMemoryCache(cacheKey, result);
+            this._inMemoryCache.add(cacheKey, result);
             yield this._writeToCache(cacheKey, result);
             return result;
         });
@@ -116,29 +114,13 @@ class DataAdapterCore {
         Log_1.Log.error(`${this._adapterName} is not attached to a Client`);
         return '';
     }
-    _getCacheKey(user) {
-        const key = (0, StatsigUser_1.getUserStorageKey)(this._getSdkKey(), user);
-        return `${StatsigDataAdapter_1.DataAdapterCachePrefix}.${this._cacheSuffix}.${key}`;
-    }
-    _addToInMemoryCache(cacheKey, result) {
-        const entries = Object.entries(this._inMemoryCache);
-        if (entries.length < CACHE_LIMIT) {
-            this._inMemoryCache[cacheKey] = result;
-            return;
-        }
-        const [oldest] = entries.reduce((acc, curr) => {
-            return curr[1] < acc[1] ? curr : acc;
-        });
-        delete this._inMemoryCache[oldest];
-        this._inMemoryCache[cacheKey] = result;
-    }
     _loadFromCache(cacheKey) {
         var _a;
         const cache = (_a = StorageProvider_1.Storage._getItemSync) === null || _a === void 0 ? void 0 : _a.call(StorageProvider_1.Storage, cacheKey);
         if (cache == null) {
             return null;
         }
-        const result = (0, TypedJsonParse_1.typedJsonParse)(cache, 'source', 'Failed to parse cached result');
+        const result = (0, TypedJsonParse_1._typedJsonParse)(cache, 'source', 'Cached Result');
         return result ? Object.assign(Object.assign({}, result), { source: 'Cache' }) : null;
     }
     _writeToCache(cacheKey, result) {
@@ -167,3 +149,42 @@ class DataAdapterCore {
     }
 }
 exports.DataAdapterCore = DataAdapterCore;
+function _makeDataAdapterResult(source, data, stableID) {
+    return {
+        source,
+        data,
+        receivedAt: Date.now(),
+        stableID,
+    };
+}
+class InMemoryCache {
+    constructor() {
+        this._data = {};
+    }
+    get(cacheKey, user) {
+        var _a;
+        const result = this._data[cacheKey];
+        const cached = result === null || result === void 0 ? void 0 : result.stableID;
+        const provided = (_a = user === null || user === void 0 ? void 0 : user.customIDs) === null || _a === void 0 ? void 0 : _a.stableID;
+        if (provided && cached && provided !== cached) {
+            Log_1.Log.warn("'StatsigUser.customIDs.stableID' mismatch");
+            return null;
+        }
+        return result;
+    }
+    add(cacheKey, value) {
+        const entries = Object.entries(this._data);
+        if (entries.length < CACHE_LIMIT) {
+            this._data[cacheKey] = value;
+            return;
+        }
+        const [oldest] = entries.reduce((acc, curr) => {
+            return curr[1] < acc[1] ? curr : acc;
+        });
+        delete this._data[oldest];
+        this._data[cacheKey] = value;
+    }
+    merge(values) {
+        this._data = Object.assign(Object.assign({}, this._data), values);
+    }
+}

package/src/ErrorBoundary.d.ts

@@ -8,7 +8,7 @@ export declare class ErrorBoundary {
     private _seen;
     constructor(_sdkKey: string, _options: AnyStatsigOptions | null, _emitter?: StatsigClientEmitEventFunc | undefined);
     wrap(instance: unknown): void;
-    capture(tag: string, task: () => unknown): unknown;
     logError(tag: string, error: unknown): void;
+    private _capture;
     private _onError;
 }

package/src/ErrorBoundary.js

@@ -14,6 +14,7 @@ const Log_1 = require("./Log");
 const SDKType_1 = require("./SDKType");
 const StatsigMetadata_1 = require("./StatsigMetadata");
 exports.EXCEPTION_ENDPOINT = 'https://statsigapi.net/v1/sdk_exception';
+const UNKNOWN_ERROR = '[Statsig] UnknownError';
 class ErrorBoundary {
     constructor(_sdkKey, _options, _emitter) {
         this._sdkKey = _sdkKey;
@@ -30,7 +31,7 @@ class ErrorBoundary {
                     return;
                 }
                 obj[name] = (...args) => {
-                    return this.capture(name, () => original.apply(instance, args));
+                    return this._capture(name, () => original.apply(instance, args));
                 };
                 obj[name].$EB = true;
             });
@@ -39,7 +40,10 @@ class ErrorBoundary {
             this._onError('eb:wrap', err);
         }
     }
-    capture(tag, task) {
+    logError(tag, error) {
+        this._onError(tag, error);
+    }
+    _capture(tag, task) {
         try {
             const res = task();
             if (res && res instanceof Promise) {
@@ -52,15 +56,12 @@ class ErrorBoundary {
             return null;
         }
     }
-    logError(tag, error) {
-        this._onError(tag, error);
-    }
     _onError(tag, error) {
         try {
             Log_1.Log.warn(`Caught error in ${tag}`, { error });
             const impl = () => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g;
-                const unwrapped = (error !== null && error !== void 0 ? error : Error('[Statsig] Error was empty'));
+                const unwrapped = (error ? error : Error(UNKNOWN_ERROR));
                 const isError = unwrapped instanceof Error;
                 const name = isError ? unwrapped.name : 'No Name';
                 if (this._seen.has(name)) {
@@ -107,7 +108,7 @@ function _getDescription(obj) {
         return JSON.stringify(obj);
     }
     catch (_a) {
-        return '[Statsig] Failed to get string for error.';
+        return UNKNOWN_ERROR;
     }
 }
 function _getAllInstanceMethodNames(instance) {

package/src/EventLogger.d.ts

@@ -8,7 +8,7 @@ export declare class EventLogger {
     private _network;
     private _options;
     private _queue;
-    private _flushTimer;
+    private _flushIntervalId;
     private _lastExposureTimeMap;
     private _nonExposedChecks;
     private _maxQueueSize;
@@ -16,7 +16,6 @@ export declare class EventLogger {
     private _creationTime;
     private _isLoggingDisabled;
     private _logEventUrl;
-    private _logEventBeaconUrl;
     constructor(_sdkKey: string, _emitter: StatsigClientEmitEventFunc, _network: NetworkCore, _options: StatsigOptionsCommon<NetworkConfigCommon> | null);
     setLoggingDisabled(isDisabled: boolean): void;
     enqueue(event: StatsigEventInternal): void;
@@ -33,10 +32,12 @@ export declare class EventLogger {
     private _sendEvents;
     private _sendEventsViaPost;
     private _sendEventsViaBeacon;
+    private _getRequestData;
     private _saveFailedLogsToStorage;
     private _retryFailedLogs;
     private _getStorageKey;
     private _normalizeAndAppendEvent;
     private _appendAndResetNonExposedChecks;
     private _getCurrentPageUrl;
+    private _startBackgroundFlushInterval;
 }

package/src/EventLogger.js

@@ -16,7 +16,6 @@ const NetworkConfig_1 = require("./NetworkConfig");
 const SafeJs_1 = require("./SafeJs");
 const StatsigEvent_1 = require("./StatsigEvent");
 const StorageProvider_1 = require("./StorageProvider");
-const TypedJsonParse_1 = require("./TypedJsonParse");
 const UrlOverrides_1 = require("./UrlOverrides");
 const VisibilityObserving_1 = require("./VisibilityObserving");
 const DEFAULT_QUEUE_SIZE = 50;
@@ -34,7 +33,7 @@ const _safeFlushAndForget = (sdkKey) => {
 };
 class EventLogger {
     constructor(_sdkKey, _emitter, _network, _options) {
-        var _a, _b;
+        var _a;
         this._sdkKey = _sdkKey;
         this._emitter = _emitter;
         this._network = _network;
@@ -47,25 +46,15 @@ class EventLogger {
         EVENT_LOGGER_MAP[_sdkKey] = this;
         this._isLoggingDisabled = (_options === null || _options === void 0 ? void 0 : _options.disableLogging) === true;
         this._maxQueueSize = (_a = _options === null || _options === void 0 ? void 0 : _options.loggingBufferMaxSize) !== null && _a !== void 0 ? _a : DEFAULT_QUEUE_SIZE;
-        const flushInterval = (_b = _options === null || _options === void 0 ? void 0 : _options.loggingIntervalMs) !== null && _b !== void 0 ? _b : DEFAULT_FLUSH_INTERVAL_MS;
-        const intervalId = setInterval(() => {
-            const logger = EVENT_LOGGER_MAP[_sdkKey];
-            if (!logger) {
-                clearInterval(intervalId);
-                return;
-            }
-            _safeFlushAndForget(_sdkKey);
-        }, flushInterval);
-        this._flushTimer = intervalId;
         const config = _options === null || _options === void 0 ? void 0 : _options.networkConfig;
         this._logEventUrl = (0, UrlOverrides_1._getOverridableUrl)(config === null || config === void 0 ? void 0 : config.logEventUrl, config === null || config === void 0 ? void 0 : config.api, '/rgstr', NetworkConfig_1.NetworkDefault.eventsApi);
-        this._logEventBeaconUrl = (0, UrlOverrides_1._getOverridableUrl)(config === null || config === void 0 ? void 0 : config.logEventBeaconUrl, config === null || config === void 0 ? void 0 : config.api, '/log_event_beacon', NetworkConfig_1.NetworkDefault.eventsApi);
         (0, VisibilityObserving_1._subscribeToVisiblityChanged)((visibility) => {
             if (visibility === 'background') {
                 _safeFlushAndForget(_sdkKey);
             }
         });
         this._retryFailedLogs();
+        this._startBackgroundFlushInterval();
     }
     setLoggingDisabled(isDisabled) {
         this._isLoggingDisabled = isDisabled;
@@ -90,9 +79,9 @@ class EventLogger {
     }
     shutdown() {
         return __awaiter(this, void 0, void 0, function* () {
-            if (this._flushTimer) {
-                clearInterval(this._flushTimer);
-                this._flushTimer = null;
+            if (this._flushIntervalId) {
+                clearInterval(this._flushIntervalId);
+                this._flushIntervalId = null;
             }
             yield this.flush();
         });
@@ -105,7 +94,7 @@ class EventLogger {
             }
             const events = this._queue;
             this._queue = [];
-            yield this._sendEvents(events);
+            return this._sendEvents(events);
         });
     }
     /**
@@ -123,16 +112,17 @@ class EventLogger {
         setTimeout(() => _safeFlushAndForget(this._sdkKey), QUICK_FLUSH_WINDOW_MS);
     }
     _shouldLogEvent(event) {
-        var _a, _b, _c, _d;
         if (!(0, StatsigEvent_1._isExposureEvent)(event)) {
             return true;
         }
+        const user = event.user ? event.user : {};
+        const metadata = event.metadata ? event.metadata : {};
         const key = [
             event.eventName,
-            (_a = event.user) === null || _a === void 0 ? void 0 : _a.userID,
-            (_b = event.metadata) === null || _b === void 0 ? void 0 : _b['gate'],
-            (_c = event.metadata) === null || _c === void 0 ? void 0 : _c['config'],
-            (_d = event.metadata) === null || _d === void 0 ? void 0 : _d['ruleID'],
+            user.userID,
+            metadata['gate'],
+            metadata['config'],
+            metadata['ruleID'],
         ].join('|');
         const previous = this._lastExposureTimeMap[key];
         const now = Date.now();
@@ -176,37 +166,34 @@ class EventLogger {
         });
     }
     _sendEventsViaPost(events) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            const result = yield this._network.post({
-                sdkKey: this._sdkKey,
-                data: {
-                    events,
-                },
-                url: this._logEventUrl,
-                retries: 3,
-                params: {
-                    [NetworkConfig_1.NetworkParam.EventCount]: String(events.length),
-                },
-            });
-            const response = (result === null || result === void 0 ? void 0 : result.body)
-                ? (0, TypedJsonParse_1.typedJsonParse)(result.body, 'success', 'Failed to parse SendEventsResponse')
-                : null;
-            return { success: (response === null || response === void 0 ? void 0 : response.success) === true };
+            const result = yield this._network.post(this._getRequestData(events));
+            const code = (_a = result === null || result === void 0 ? void 0 : result.code) !== null && _a !== void 0 ? _a : -1;
+            return { success: code >= 200 && code < 300 };
         });
     }
     _sendEventsViaBeacon(events) {
         return __awaiter(this, void 0, void 0, function* () {
             return {
-                success: yield this._network.beacon({
-                    sdkKey: this._sdkKey,
-                    data: {
-                        events,
-                    },
-                    url: this._logEventBeaconUrl,
-                }),
+                success: yield this._network.beacon(this._getRequestData(events)),
             };
         });
     }
+    _getRequestData(events) {
+        return {
+            sdkKey: this._sdkKey,
+            data: {
+                events,
+            },
+            url: this._logEventUrl,
+            retries: 3,
+            isCompressable: true,
+            params: {
+                [NetworkConfig_1.NetworkParam.EventCount]: String(events.length),
+            },
+        };
+    }
     _saveFailedLogsToStorage(events) {
         while (events.length > MAX_FAILED_LOGS) {
             events.shift();
@@ -230,7 +217,7 @@ class EventLogger {
         });
     }
     _getStorageKey() {
-        return `statsig.failed_logs.${(0, Hashing_1.DJB2)(this._sdkKey)}`;
+        return `statsig.failed_logs.${(0, Hashing_1._DJB2)(this._sdkKey)}`;
     }
     _normalizeAndAppendEvent(event) {
         if (event.user) {
@@ -242,7 +229,9 @@ class EventLogger {
         if (currentPage) {
             extras.statsigMetadata = { currentPage };
         }
-        this._queue.push(Object.assign(Object.assign({}, event), extras));
+        const final = Object.assign(Object.assign({}, event), extras);
+        Log_1.Log.debug('Enqueued Event:', final);
+        this._queue.push(final);
     }
     _appendAndResetNonExposedChecks() {
         if (Object.keys(this._nonExposedChecks).length === 0) {
@@ -265,5 +254,22 @@ class EventLogger {
         }
         return (0, SafeJs_1._getCurrentPageUrlSafe)();
     }
+    _startBackgroundFlushInterval() {
+        var _a, _b;
+        if (!(0, SafeJs_1._isBrowserEnv)()) {
+            return; // do not run in server environments
+        }
+        const flushInterval = (_b = (_a = this._options) === null || _a === void 0 ? void 0 : _a.loggingIntervalMs) !== null && _b !== void 0 ? _b : DEFAULT_FLUSH_INTERVAL_MS;
+        const intervalId = setInterval(() => {
+            const logger = EVENT_LOGGER_MAP[this._sdkKey];
+            if (logger._flushIntervalId !== intervalId) {
+                clearInterval(intervalId);
+            }
+            else {
+                _safeFlushAndForget(this._sdkKey);
+            }
+        }, flushInterval);
+        this._flushIntervalId = intervalId;
+    }
 }
 exports.EventLogger = EventLogger;

package/src/Hashing.d.ts

@@ -1,2 +1,2 @@
-export declare const DJB2: (value: string) => string;
-export declare const DJB2Object: (value: Record<string, unknown> | null) => string;
+export declare const _DJB2: (value: string) => string;
+export declare const _DJB2Object: (value: Record<string, unknown> | null) => string;

package/src/Hashing.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DJB2Object = exports.DJB2 = void 0;
-const DJB2 = (value) => {
+exports._DJB2Object = exports._DJB2 = void 0;
+const _DJB2 = (value) => {
     let hash = 0;
     for (let i = 0; i < value.length; i++) {
         const character = value.charCodeAt(i);
@@ -10,11 +10,11 @@ const DJB2 = (value) => {
     }
     return String(hash >>> 0);
 };
-exports.DJB2 = DJB2;
-const DJB2Object = (value) => {
-    return (0, exports.DJB2)(JSON.stringify(_getSortedObject(value)));
+exports._DJB2 = _DJB2;
+const _DJB2Object = (value) => {
+    return (0, exports._DJB2)(JSON.stringify(_getSortedObject(value)));
 };
-exports.DJB2Object = DJB2Object;
+exports._DJB2Object = _DJB2Object;
 const _getSortedObject = (object) => {
     if (object == null) {
         return null;

package/src/NetworkConfig.d.ts

@@ -14,5 +14,6 @@ export declare enum NetworkParam {
     SdkVersion = "sv",
     Time = "t",
     SessionID = "sid",
-    StatsigEncoded = "se"
+    StatsigEncoded = "se",
+    IsGzipped = "gz"
 }

package/src/NetworkConfig.js

@@ -15,4 +15,5 @@ var NetworkParam;
     NetworkParam["Time"] = "t";
     NetworkParam["SessionID"] = "sid";
     NetworkParam["StatsigEncoded"] = "se";
+    NetworkParam["IsGzipped"] = "gz";
 })(NetworkParam || (exports.NetworkParam = NetworkParam = {}));

package/src/NetworkCore.d.ts

@@ -2,6 +2,7 @@ import './$_StatsigGlobal';
 import { NetworkPriority } from './NetworkConfig';
 import { StatsigClientEmitEventFunc } from './StatsigClientBase';
 import { AnyStatsigOptions } from './StatsigOptionsCommon';
+import { Flatten } from './UtitlityTypes';
 type RequestArgs = {
     sdkKey: string;
     url: string;
@@ -10,10 +11,12 @@ type RequestArgs = {
     params?: Record<string, string>;
     headers?: Record<string, string>;
 };
-type RequestArgsWithData = RequestArgs & {
+export type RequestArgsWithData = Flatten<RequestArgs & {
     data: Record<string, unknown>;
     isStatsigEncodable?: boolean;
-};
+    isCompressable?: boolean;
+}>;
+type BeaconRequestArgs = Pick<RequestArgsWithData, 'data' | 'sdkKey' | 'url' | 'params' | 'isCompressable'>;
 type NetworkResponse = {
     body: string | null;
     code: number;
@@ -22,11 +25,12 @@ export declare class NetworkCore {
     private _options;
     private _emitter?;
     private readonly _timeout;
+    private readonly _netConfig;
     constructor(_options: AnyStatsigOptions | null, _emitter?: StatsigClientEmitEventFunc | undefined);
     post(args: RequestArgsWithData): Promise<NetworkResponse | null>;
     get(args: RequestArgs): Promise<NetworkResponse | null>;
     isBeaconSupported(): boolean;
-    beacon(args: RequestArgsWithData): Promise<boolean>;
+    beacon(args: BeaconRequestArgs): Promise<boolean>;
     private _sendRequest;
     private _getPopulatedURL;
     private _getPopulatedBody;

package/src/NetworkCore.js

@@ -19,19 +19,26 @@ const SafeJs_1 = require("./SafeJs");
 const SessionID_1 = require("./SessionID");
 const StableID_1 = require("./StableID");
 const StatsigMetadata_1 = require("./StatsigMetadata");
+const VisibilityObserving_1 = require("./VisibilityObserving");
 const DEFAULT_TIMEOUT_MS = 10000;
 class NetworkCore {
     constructor(_options, _emitter) {
-        var _a, _b;
+        var _a, _b, _c;
         this._options = _options;
         this._emitter = _emitter;
-        this._timeout =
-            (_b = (_a = _options === null || _options === void 0 ? void 0 : _options.networkConfig) === null || _a === void 0 ? void 0 : _a.networkTimeoutMs) !== null && _b !== void 0 ? _b : DEFAULT_TIMEOUT_MS;
+        this._netConfig = (_a = _options === null || _options === void 0 ? void 0 : _options.networkConfig) !== null && _a !== void 0 ? _a : null;
+        this._timeout = (_c = (_b = this._netConfig) === null || _b === void 0 ? void 0 : _b.networkTimeoutMs) !== null && _c !== void 0 ? _c : DEFAULT_TIMEOUT_MS;
     }
     post(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const body = yield this._getPopulatedBody(args);
-            return this._sendRequest(Object.assign({ method: 'POST', body: this._attemptToEncodeString(args, body) }, args));
+            let body = yield this._getPopulatedBody(args);
+            if (args.isStatsigEncodable) {
+                body = this._attemptToEncodeString(args, body);
+            }
+            else if (args.isCompressable) {
+                body = yield _attemptToCompressBody(args, body);
+            }
+            return this._sendRequest(Object.assign({ method: 'POST', body }, args));
         });
     }
     get(args) {
@@ -39,47 +46,49 @@ class NetworkCore {
     }
     isBeaconSupported() {
         return (typeof navigator !== 'undefined' &&
-            typeof (navigator === null || navigator === void 0 ? void 0 : navigator.sendBeacon) === 'function');
+            typeof navigator.sendBeacon === 'function');
     }
     beacon(args) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!_ensureValidSdkKey(args)) {
                 return false;
             }
+            let body = yield this._getPopulatedBody(args);
+            body = yield _attemptToCompressBody(args, body);
             const url = yield this._getPopulatedURL(args);
-            const body = yield this._getPopulatedBody(args);
             return navigator.sendBeacon(url, body);
         });
     }
     _sendRequest(args) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d;
         return __awaiter(this, void 0, void 0, function* () {
             if (!_ensureValidSdkKey(args)) {
                 return null;
             }
-            if ((_b = (_a = this._options) === null || _a === void 0 ? void 0 : _a.networkConfig) === null || _b === void 0 ? void 0 : _b.preventAllNetworkTraffic) {
+            if ((_a = this._netConfig) === null || _a === void 0 ? void 0 : _a.preventAllNetworkTraffic) {
                 return null;
             }
             const { method, body, retries } = args;
-            const controller = new AbortController();
-            const handle = setTimeout(() => controller.abort(`Timeout of ${this._timeout}ms expired.`), this._timeout);
+            const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
+            const handle = setTimeout(() => controller === null || controller === void 0 ? void 0 : controller.abort(`Timeout of ${this._timeout}ms expired.`), this._timeout);
             const url = yield this._getPopulatedURL(args);
             let response = null;
+            const keepalive = (0, VisibilityObserving_1._isUnloading)();
             try {
                 const config = {
                     method,
                     body,
                     headers: Object.assign({}, args.headers),
-                    signal: controller.signal,
+                    signal: controller === null || controller === void 0 ? void 0 : controller.signal,
                     priority: args.priority,
-                    keepalive: true,
+                    keepalive,
                 };
-                const func = (_e = (_d = (_c = this._options) === null || _c === void 0 ? void 0 : _c.networkConfig) === null || _d === void 0 ? void 0 : _d.networkOverrideFunc) !== null && _e !== void 0 ? _e : fetch;
+                const func = (_c = (_b = this._netConfig) === null || _b === void 0 ? void 0 : _b.networkOverrideFunc) !== null && _c !== void 0 ? _c : fetch;
                 response = yield func(url, config);
                 clearTimeout(handle);
                 if (!response.ok) {
                     const text = yield response.text().catch(() => 'No Text');
-                    const err = new Error(`Failed to fetch: ${url} ${text}`);
+                    const err = new Error(`NetworkError: ${url} ${text}`);
                     err.name = 'NetworkError';
                     throw err;
                 }
@@ -94,7 +103,7 @@ class NetworkCore {
                 const errorMessage = _getErrorMessage(controller, error);
                 Diagnostics_1.Diagnostics.mark();
                 if (!retries || retries <= 0) {
-                    (_f = this._emitter) === null || _f === void 0 ? void 0 : _f.call(this, { name: 'error', error });
+                    (_d = this._emitter) === null || _d === void 0 ? void 0 : _d.call(this, { name: 'error', error });
                     Log_1.Log.error(`A networking error occured during ${method} request to ${url}.`, errorMessage, error);
                     return null;
                 }
@@ -153,7 +162,7 @@ const _ensureValidSdkKey = (args) => {
     return true;
 };
 function _getErrorMessage(controller, error) {
-    if (controller.signal.aborted &&
+    if ((controller === null || controller === void 0 ? void 0 : controller.signal.aborted) &&
         typeof controller.signal.reason === 'string') {
         return controller.signal.reason;
     }
@@ -165,3 +174,21 @@ function _getErrorMessage(controller, error) {
     }
     return 'Unknown Error';
 }
+function _attemptToCompressBody(args, body) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!args.isCompressable ||
+            typeof CompressionStream === 'undefined' ||
+            typeof TextEncoder === 'undefined' ||
+            (__STATSIG__ === null || __STATSIG__ === void 0 ? void 0 : __STATSIG__['no-compress']) != null) {
+            return body;
+        }
+        const bytes = new TextEncoder().encode(body);
+        const stream = new CompressionStream('gzip');
+        const writer = stream.writable.getWriter();
+        writer.write(bytes).catch(Log_1.Log.error);
+        writer.close().catch(Log_1.Log.error);
+        args.params = Object.assign(Object.assign({}, ((_a = args.params) !== null && _a !== void 0 ? _a : {})), { [NetworkConfig_1.NetworkParam.IsGzipped]: '1' });
+        return yield new Response(stream.readable).arrayBuffer();
+    });
+}

package/src/SessionID.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatsigSession = exports.SessionID = void 0;
-const Hashing_1 = require("./Hashing");
+const CacheKey_1 = require("./CacheKey");
 const Log_1 = require("./Log");
 const StorageProvider_1 = require("./StorageProvider");
 const UUID_1 = require("./UUID");
@@ -80,7 +80,7 @@ function _hasRunTooLong({ startTime }) {
     return Date.now() - startTime > MAX_SESSION_AGE;
 }
 function _getSessionIDStorageKey(sdkKey) {
-    return `statsig.session_id.${(0, Hashing_1.DJB2)(sdkKey)}`;
+    return `statsig.session_id.${(0, CacheKey_1._getStorageKey)(sdkKey)}`;
 }
 function _persistToStorage(session, sdkKey) {
     const storageKey = _getSessionIDStorageKey(sdkKey);

package/src/StableID.js

@@ -10,7 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StableID = void 0;
-const Hashing_1 = require("./Hashing");
+const CacheKey_1 = require("./CacheKey");
 const Log_1 = require("./Log");
 const StorageProvider_1 = require("./StorageProvider");
 const UUID_1 = require("./UUID");
@@ -35,7 +35,7 @@ exports.StableID = {
     },
 };
 function _getStableIDStorageKey(sdkKey) {
-    return `statsig.stable_id.${(0, Hashing_1.DJB2)(sdkKey)}`;
+    return `statsig.stable_id.${(0, CacheKey_1._getStorageKey)(sdkKey)}`;
 }
 function _persistToStorage(stableID, sdkKey) {
     const storageKey = _getStableIDStorageKey(sdkKey);

package/src/StatsigClientBase.d.ts

@@ -63,4 +63,5 @@ export declare abstract class StatsigClientBase<TAdapter extends EvaluationsData
     $emt(event: AnyStatsigClientEvent): void;
     protected _setStatus(newStatus: StatsigLoadingStatus, values: DataAdapterResult | null): void;
     protected _enqueueExposure(name: string, exposure: StatsigEventInternal, options?: EvaluationOptionsCommon): void;
+    protected abstract _primeReadyRipcord(): void;
 }

package/src/StatsigClientBase.js

@@ -16,7 +16,6 @@ const ErrorBoundary_1 = require("./ErrorBoundary");
 const EventLogger_1 = require("./EventLogger");
 const Log_1 = require("./Log");
 const SafeJs_1 = require("./SafeJs");
-const StableID_1 = require("./StableID");
 const StorageProvider_1 = require("./StorageProvider");
 class StatsigClientBase {
     constructor(sdkKey, adapter, network, options) {
@@ -24,30 +23,32 @@ class StatsigClientBase {
         this.loadingStatus = 'Uninitialized';
         this._listeners = {};
         const emitter = this.$emt.bind(this);
-        const statsigGlobal = (0, __StatsigGlobal_1._getStatsigGlobal)();
-        const instances = (_a = statsigGlobal.instances) !== null && _a !== void 0 ? _a : {};
-        const inst = this;
-        (options === null || options === void 0 ? void 0 : options.logLevel) && (Log_1.Log.level = options === null || options === void 0 ? void 0 : options.logLevel);
+        (options === null || options === void 0 ? void 0 : options.logLevel) != null && (Log_1.Log.level = options.logLevel);
         (options === null || options === void 0 ? void 0 : options.disableStorage) && StorageProvider_1.Storage._setDisabled(true);
-        (options === null || options === void 0 ? void 0 : options.overrideStableID) &&
-            StableID_1.StableID.setOverride(options.overrideStableID, sdkKey);
+        this._sdkKey = sdkKey;
+        this._options = options !== null && options !== void 0 ? options : {};
+        this._overrideAdapter = (_a = options === null || options === void 0 ? void 0 : options.overrideAdapter) !== null && _a !== void 0 ? _a : null;
+        this._logger = new EventLogger_1.EventLogger(sdkKey, emitter, network, options);
         this._errorBoundary = new ErrorBoundary_1.ErrorBoundary(sdkKey, options, emitter);
         this._errorBoundary.wrap(this);
         this._errorBoundary.wrap(network);
         this._errorBoundary.wrap(adapter);
-        this._sdkKey = sdkKey;
-        this._options = options !== null && options !== void 0 ? options : {};
-        this._overrideAdapter = (_b = options === null || options === void 0 ? void 0 : options.overrideAdapter) !== null && _b !== void 0 ? _b : null;
-        this._logger = new EventLogger_1.EventLogger(sdkKey, emitter, network, options);
-        if (instances[sdkKey] != null && (0, SafeJs_1._isBrowserEnv)()) {
-            Log_1.Log.warn('Creating multiple Statsig clients with the same SDK key can lead to unexpected behavior. Multi-instance support requires different SDK keys.');
+        this._errorBoundary.wrap(this._logger);
+        if ((0, SafeJs_1._isBrowserEnv)()) {
+            const statsigGlobal = (0, __StatsigGlobal_1._getStatsigGlobal)();
+            const instances = (_b = statsigGlobal.instances) !== null && _b !== void 0 ? _b : {};
+            const inst = this;
+            if (instances[sdkKey] != null) {
+                Log_1.Log.warn('Creating multiple Statsig clients with the same SDK key can lead to unexpected behavior. Multi-instance support requires different SDK keys.');
+            }
+            instances[sdkKey] = inst;
+            statsigGlobal.lastInstance = inst;
+            statsigGlobal.instances = instances;
+            __STATSIG__ = statsigGlobal;
         }
-        instances[sdkKey] = inst;
-        statsigGlobal.lastInstance = inst;
-        statsigGlobal.instances = instances;
-        __STATSIG__ = statsigGlobal;
         this.dataAdapter = adapter;
         this.dataAdapter.attach(sdkKey, options);
+        this._primeReadyRipcord();
     }
     /**
      * Updates runtime configuration options for the SDK, allowing toggling of certain behaviors such as logging and storage to comply with user preferences or regulations such as GDPR.

package/src/StatsigDataAdapter.d.ts

@@ -6,6 +6,7 @@ export type DataAdapterResult = {
     readonly source: DataSource;
     readonly data: string;
     readonly receivedAt: number;
+    readonly stableID: string | null;
 };
 export type DataAdapterAsyncOptions = {
     /**

package/src/StatsigMetadata.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "0.0.1-beta.40";
+export declare const SDK_VERSION = "0.0.1-beta.42";
 export type StatsigMetadata = {
     readonly [key: string]: string | undefined;
     readonly appVersion?: string;

package/src/StatsigMetadata.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatsigMetadataProvider = exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '0.0.1-beta.40';
+exports.SDK_VERSION = '0.0.1-beta.42';
 let metadata = {
     sdkVersion: exports.SDK_VERSION,
     sdkType: 'js-mono', // js-mono is overwritten by Precomp and OnDevice clients

package/src/StatsigOptionsCommon.d.ts

@@ -26,12 +26,6 @@ export type NetworkConfigCommon = {
      * default: `https://featuregates.org/v1/initialize`
      */
     logEventUrl?: string;
-    /**
-     * The URL used to flush queued events via {@link window.navigator.sendBeacon} (web only). Takes precedence over {@link StatsigOptionsCommon.api}.
-     *
-     * default: `https://featuregates.org/v1/initialize`
-     */
-    logEventBeaconUrl?: string;
     /**
      * The maximum amount of time (in milliseconds) that any network request can take
      * before timing out.
@@ -69,10 +63,6 @@ export type StatsigOptionsCommon<NetworkConfig extends NetworkConfigCommon> = St
      * in the same session.
      */
     environment?: StatsigEnvironment;
-    /**
-     * Overrides the auto-generated StableID that is set for the device.
-     */
-    overrideStableID?: string;
     /**
      * How much information is allowed to be printed to the console.
      *

package/src/StatsigUser.d.ts

@@ -2,7 +2,10 @@ import type { StatsigEnvironment } from './StatsigOptionsCommon';
 type StatsigUserPrimitives = string | number | boolean | Array<string> | undefined;
 export type StatsigUser = {
     userID?: string;
-    customIDs?: Record<string, string>;
+    customIDs?: {
+        [key: string]: string | undefined;
+        stableID?: string;
+    };
     email?: string;
     ip?: string;
     userAgent?: string;
@@ -15,7 +18,6 @@ export type StatsigUser = {
 export type StatsigUserInternal = StatsigUser & {
     statsigEnvironment?: StatsigEnvironment;
 };
-export declare function normalizeUser(original: StatsigUser, environment?: StatsigEnvironment): StatsigUser;
-export declare function getUserStorageKey(sdkKey: string, user?: StatsigUser): string;
+export declare function _normalizeUser(original: StatsigUser, environment?: StatsigEnvironment): StatsigUser;
 export declare function getUnitIDFromUser(user: StatsigUser, idType: string): string | undefined;
 export {};

package/src/StatsigUser.js

@@ -1,8 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getUnitIDFromUser = exports.getUserStorageKey = exports.normalizeUser = void 0;
-const Hashing_1 = require("./Hashing");
-function normalizeUser(original, environment) {
+exports.getUnitIDFromUser = exports._normalizeUser = void 0;
+function _normalizeUser(original, environment) {
     try {
         const copy = JSON.parse(JSON.stringify(original));
         if (environment != null) {
@@ -14,11 +13,7 @@ function normalizeUser(original, environment) {
         throw new Error('User object must be convertable to JSON string.');
     }
 }
-exports.normalizeUser = normalizeUser;
-function getUserStorageKey(sdkKey, user) {
-    return (0, Hashing_1.DJB2Object)({ sdkKey, user });
-}
-exports.getUserStorageKey = getUserStorageKey;
+exports._normalizeUser = _normalizeUser;
 function getUnitIDFromUser(user, idType) {
     var _a, _b, _c;
     if (typeof idType === 'string' && idType.toLowerCase() !== 'userid') {

package/src/StorageProvider.js

@@ -11,53 +11,30 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._setObjectInStorage = exports._getObjectFromStorage = exports.Storage = void 0;
 const Log_1 = require("./Log");
+const SafeJs_1 = require("./SafeJs");
 const inMemoryStore = {};
 const _resolve = (input) => Promise.resolve(input);
 const _inMemoryProvider = {
     _getProviderName: () => 'InMemory',
-    _getItemSync(key) {
-        var _a;
-        return (_a = inMemoryStore[key]) !== null && _a !== void 0 ? _a : null;
-    },
-    _getItem(key) {
-        var _a;
-        return _resolve((_a = inMemoryStore[key]) !== null && _a !== void 0 ? _a : null);
-    },
-    _setItem(key, value) {
-        inMemoryStore[key] = value;
-        return _resolve();
-    },
-    _removeItem(key) {
-        delete inMemoryStore[key];
-        return _resolve();
-    },
-    _getAllKeys() {
-        return _resolve(Object.keys(inMemoryStore));
-    },
+    _getItemSync: (key) => inMemoryStore[key] ? inMemoryStore[key] : null,
+    _getItem: (key) => _resolve(inMemoryStore[key] ? inMemoryStore[key] : null),
+    _setItem: (key, value) => ((inMemoryStore[key] = value), _resolve()),
+    _removeItem: (key) => (delete inMemoryStore[key], _resolve()),
+    _getAllKeys: () => _resolve(Object.keys(inMemoryStore)),
 };
 let _localStorageProvider = null;
 try {
-    if (typeof window !== 'undefined' && 'localStorage' in window) {
+    const win = (0, SafeJs_1._getWindowSafe)();
+    if (win &&
+        win.localStorage &&
+        typeof win.localStorage.getItem === 'function') {
         _localStorageProvider = {
             _getProviderName: () => 'LocalStorage',
-            _getItemSync(key) {
-                return localStorage.getItem(key);
-            },
-            _getItem(key) {
-                return _resolve(localStorage.getItem(key));
-            },
-            _setItem(key, value) {
-                localStorage.setItem(key, value);
-                return _resolve();
-            },
-            _removeItem(key) {
-                localStorage.removeItem(key);
-                return _resolve();
-            },
-            _getAllKeys() {
-                const keys = Object.keys(localStorage);
-                return _resolve(keys);
-            },
+            _getItemSync: (key) => win.localStorage.getItem(key),
+            _getItem: (key) => _resolve(win.localStorage.getItem(key)),
+            _setItem: (key, value) => (win.localStorage.setItem(key, value), _resolve()),
+            _removeItem: (key) => (win.localStorage.removeItem(key), _resolve()),
+            _getAllKeys: () => _resolve(Object.keys(win.localStorage)),
         };
     }
 }
@@ -81,7 +58,7 @@ function _inMemoryBreaker(get) {
 exports.Storage = {
     _getProviderName: () => _current._getProviderName(),
     _getItem: (key) => __awaiter(void 0, void 0, void 0, function* () { return _inMemoryBreaker(() => _current._getItem(key)); }),
-    _getItemSync: (key) => _inMemoryBreaker(() => { var _a, _b; return (_b = (_a = _current._getItemSync) === null || _a === void 0 ? void 0 : _a.call(_current, key)) !== null && _b !== void 0 ? _b : null; }),
+    _getItemSync: (key) => _inMemoryBreaker(() => _current._getItemSync ? _current._getItemSync(key) : null),
     _setItem: (key, value) => _current._setItem(key, value),
     _removeItem: (key) => _current._removeItem(key),
     _getAllKeys: () => _current._getAllKeys(),

package/src/TypedJsonParse.d.ts

@@ -5,4 +5,4 @@
  * @param {string} error An error to print via Log.error() when parsing fails
  * @returns {T | null} The parse object T or null if it failed
  */
-export declare function typedJsonParse<T>(data: string, guard: string, error: string): T | null;
+export declare function _typedJsonParse<T>(data: string, guard: string, typeName: string): T | null;

package/src/TypedJsonParse.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.typedJsonParse = void 0;
+exports._typedJsonParse = void 0;
 const Log_1 = require("./Log");
 /**
  *
@@ -9,7 +9,7 @@ const Log_1 = require("./Log");
  * @param {string} error An error to print via Log.error() when parsing fails
  * @returns {T | null} The parse object T or null if it failed
  */
-function typedJsonParse(data, guard, error) {
+function _typedJsonParse(data, guard, typeName) {
     try {
         const result = JSON.parse(data);
         if (typeof result === 'object' &&
@@ -21,7 +21,7 @@ function typedJsonParse(data, guard, error) {
     catch (_a) {
         // noop
     }
-    Log_1.Log.error(error);
+    Log_1.Log.error(`Failed to parse ${typeName}`);
     return null;
 }
-exports.typedJsonParse = typedJsonParse;
+exports._typedJsonParse = _typedJsonParse;

package/src/VisibilityObserving.d.ts

@@ -3,6 +3,7 @@ declare const BACKGROUND = "background";
 export type Visibility = typeof FOREGROUND | typeof BACKGROUND;
 type VisibilityChangedCallback = (visibility: Visibility) => void;
 export declare const _isCurrentlyVisible: () => boolean;
+export declare const _isUnloading: () => boolean;
 export declare const _subscribeToVisiblityChanged: (listener: VisibilityChangedCallback) => void;
 export declare const _notifyVisibilityChanged: (visibility: Visibility) => void;
 export {};

package/src/VisibilityObserving.js

@@ -1,15 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._notifyVisibilityChanged = exports._subscribeToVisiblityChanged = exports._isCurrentlyVisible = void 0;
+exports._notifyVisibilityChanged = exports._subscribeToVisiblityChanged = exports._isUnloading = exports._isCurrentlyVisible = void 0;
 const SafeJs_1 = require("./SafeJs");
 const FOREGROUND = 'foreground';
 const BACKGROUND = 'background';
 const LISTENERS = [];
 let current = FOREGROUND;
+let isUnloading = false;
 const _isCurrentlyVisible = () => {
     return current === FOREGROUND;
 };
 exports._isCurrentlyVisible = _isCurrentlyVisible;
+const _isUnloading = () => isUnloading;
+exports._isUnloading = _isUnloading;
 const _subscribeToVisiblityChanged = (listener) => {
     LISTENERS.unshift(listener);
 };
@@ -22,9 +25,15 @@ const _notifyVisibilityChanged = (visibility) => {
     LISTENERS.forEach((l) => l(visibility));
 };
 exports._notifyVisibilityChanged = _notifyVisibilityChanged;
-(0, SafeJs_1._addWindowEventListenerSafe)('focus', () => (0, exports._notifyVisibilityChanged)(FOREGROUND));
+(0, SafeJs_1._addWindowEventListenerSafe)('focus', () => {
+    isUnloading = false;
+    (0, exports._notifyVisibilityChanged)(FOREGROUND);
+});
 (0, SafeJs_1._addWindowEventListenerSafe)('blur', () => (0, exports._notifyVisibilityChanged)(BACKGROUND));
-(0, SafeJs_1._addWindowEventListenerSafe)('beforeunload', () => (0, exports._notifyVisibilityChanged)(BACKGROUND));
+(0, SafeJs_1._addWindowEventListenerSafe)('beforeunload', () => {
+    isUnloading = true;
+    (0, exports._notifyVisibilityChanged)(BACKGROUND);
+});
 (0, SafeJs_1._addDocumentEventListenerSafe)('visibilitychange', () => {
     (0, exports._notifyVisibilityChanged)(document.visibilityState === 'visible' ? FOREGROUND : BACKGROUND);
 });

package/src/index.d.ts

@@ -4,6 +4,7 @@ import { EventLogger } from './EventLogger';
 import { Log } from './Log';
 import { Storage } from './StorageProvider';
 export * from './$_StatsigGlobal';
+export * from './CacheKey';
 export * from './ClientInterfaces';
 export * from './DataAdapterCore';
 export * from './DownloadConfigSpecsResponse';

package/src/index.js

@@ -24,8 +24,8 @@ Object.defineProperty(exports, "Log", { enumerable: true, get: function () { ret
 const StatsigMetadata_1 = require("./StatsigMetadata");
 const StorageProvider_1 = require("./StorageProvider");
 Object.defineProperty(exports, "Storage", { enumerable: true, get: function () { return StorageProvider_1.Storage; } });
-const UUID_1 = require("./UUID");
 __exportStar(require("./$_StatsigGlobal"), exports);
+__exportStar(require("./CacheKey"), exports);
 __exportStar(require("./ClientInterfaces"), exports);
 __exportStar(require("./DataAdapterCore"), exports);
 __exportStar(require("./DownloadConfigSpecsResponse"), exports);
@@ -57,8 +57,5 @@ __exportStar(require("./UrlOverrides"), exports);
 __exportStar(require("./UtitlityTypes"), exports);
 __exportStar(require("./UUID"), exports);
 __exportStar(require("./VisibilityObserving"), exports);
-__STATSIG__ = Object.assign(Object.assign({}, (__STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {})), { EventLogger: EventLogger_1.EventLogger,
-    Log: Log_1.Log,
-    getUUID: UUID_1.getUUID,
-    Storage: StorageProvider_1.Storage,
+__STATSIG__ = Object.assign(Object.assign({}, (__STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {})), { Log: Log_1.Log,
     SDK_VERSION: StatsigMetadata_1.SDK_VERSION });