@statsig/client-core 0.0.1-beta.37 → 0.0.1-beta.39

package/package.json

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

package/src/DataAdapterCore.d.ts

@@ -1,11 +1,9 @@
-import { ErrorBoundary } from './ErrorBoundary';
 import { DataAdapterAsyncOptions, DataAdapterResult } from './StatsigDataAdapter';
 import { AnyStatsigOptions } from './StatsigOptionsCommon';
 import { StatsigUser } from './StatsigUser';
 export declare abstract class DataAdapterCore {
     private _adapterName;
     private _cacheSuffix;
-    protected _errorBoundary: ErrorBoundary | null;
     private _sdkKey;
     private _inMemoryCache;
     private _lastModifiedStoreKey;
@@ -21,8 +19,8 @@ export declare abstract class DataAdapterCore {
     __primeInMemoryCache(cache: Record<string, DataAdapterResult>): void;
     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): Promise<string | null>;
-    private _fetchLatest;
+    protected abstract _fetchFromNetwork(current: string | null, user?: StatsigUser, options?: DataAdapterAsyncOptions): Promise<string | null>;
+    private _fetchAndPrepFromNetwork;
     protected _getSdkKey(): string;
     protected _getCacheKey(user?: StatsigUser): string;
     protected _addToInMemoryCache(cacheKey: string, result: DataAdapterResult): void;

package/src/DataAdapterCore.js

@@ -10,7 +10,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataAdapterCore = void 0;
-const ErrorBoundary_1 = require("./ErrorBoundary");
 const Log_1 = require("./Log");
 const StatsigDataAdapter_1 = require("./StatsigDataAdapter");
 const StatsigUser_1 = require("./StatsigUser");
@@ -21,14 +20,12 @@ class DataAdapterCore {
     constructor(_adapterName, _cacheSuffix) {
         this._adapterName = _adapterName;
         this._cacheSuffix = _cacheSuffix;
-        this._errorBoundary = null;
         this._sdkKey = null;
         this._inMemoryCache = {};
         this._lastModifiedStoreKey = `statsig.last_modified_time.${_cacheSuffix}`;
     }
     attach(sdkKey, _options) {
         this._sdkKey = sdkKey;
-        this._errorBoundary = new ErrorBoundary_1.ErrorBoundary(sdkKey);
     }
     getDataSync(user) {
         const cacheKey = this._getCacheKey(user);
@@ -63,7 +60,9 @@ class DataAdapterCore {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
             const cache = current !== null && current !== void 0 ? current : this.getDataSync(user);
-            const ops = [this._fetchLatest((_a = cache === null || cache === void 0 ? void 0 : cache.data) !== null && _a !== void 0 ? _a : null, user)];
+            const ops = [
+                this._fetchAndPrepFromNetwork((_a = cache === null || cache === void 0 ? void 0 : cache.data) !== null && _a !== void 0 ? _a : null, user, options),
+            ];
             if (options === null || options === void 0 ? void 0 : options.timeoutMs) {
                 ops.push(new Promise((r) => setTimeout(r, options.timeoutMs)).then(() => {
                     Log_1.Log.debug('Fetching latest value timed out');
@@ -82,9 +81,9 @@ class DataAdapterCore {
             }
         });
     }
-    _fetchLatest(current, user) {
+    _fetchAndPrepFromNetwork(current, user, options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const latest = yield this._fetchFromNetwork(current, user);
+            const latest = yield this._fetchFromNetwork(current, user, options);
             if (!latest) {
                 Log_1.Log.debug('No response returned for latest value');
                 return null;

package/src/ErrorBoundary.d.ts

@@ -1,10 +1,12 @@
 import { StatsigClientEmitEventFunc } from './StatsigClientBase';
+import { AnyStatsigOptions } from './StatsigOptionsCommon';
 export declare const EXCEPTION_ENDPOINT = "https://statsigapi.net/v1/sdk_exception";
 export declare class ErrorBoundary {
     private _sdkKey;
+    private _options;
     private _emitter?;
     private _seen;
-    constructor(_sdkKey: string, _emitter?: StatsigClientEmitEventFunc | undefined);
+    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;

package/src/ErrorBoundary.js

@@ -15,8 +15,9 @@ const SDKType_1 = require("./SDKType");
 const StatsigMetadata_1 = require("./StatsigMetadata");
 exports.EXCEPTION_ENDPOINT = 'https://statsigapi.net/v1/sdk_exception';
 class ErrorBoundary {
-    constructor(_sdkKey, _emitter) {
+    constructor(_sdkKey, _options, _emitter) {
         this._sdkKey = _sdkKey;
+        this._options = _options;
         this._emitter = _emitter;
         this._seen = new Set();
     }
@@ -58,7 +59,7 @@ class ErrorBoundary {
         try {
             Log_1.Log.warn(`Caught error in ${tag}`, { error });
             const impl = () => __awaiter(this, void 0, void 0, function* () {
-                var _a;
+                var _a, _b, _c, _d;
                 const unwrapped = (error !== null && error !== void 0 ? error : Error('[Statsig] Error was empty'));
                 const isError = unwrapped instanceof Error;
                 const name = isError ? unwrapped.name : 'No Name';
@@ -66,6 +67,10 @@ class ErrorBoundary {
                     return;
                 }
                 this._seen.add(name);
+                if ((_b = (_a = this._options) === null || _a === void 0 ? void 0 : _a.networkConfig) === null || _b === void 0 ? void 0 : _b.preventAllNetworkTraffic) {
+                    (_c = this._emitter) === null || _c === void 0 ? void 0 : _c.call(this, { name: 'error', error });
+                    return;
+                }
                 const sdkType = SDKType_1.SDKType._get(this._sdkKey);
                 const statsigMetadata = StatsigMetadata_1.StatsigMetadataProvider.get();
                 const info = isError ? unwrapped.stack : _getDescription(unwrapped);
@@ -80,7 +85,7 @@ class ErrorBoundary {
                     },
                     body,
                 });
-                (_a = this._emitter) === null || _a === void 0 ? void 0 : _a.call(this, { name: 'error', error });
+                (_d = this._emitter) === null || _d === void 0 ? void 0 : _d.call(this, { name: 'error', error });
             });
             impl()
                 .then(() => {

package/src/NetworkConfig.d.ts

@@ -3,6 +3,7 @@ export declare const NetworkDefault: {
     initializeApi: "https://featureassets.org/v1";
     specsApi: "https://assetsconfigcdn.org/v1";
 };
+export type NetworkPriority = 'high' | 'low' | 'auto';
 export declare enum NetworkParam {
     EventCount = "ec",
     SdkKey = "k",

package/src/NetworkCore.d.ts

@@ -1,9 +1,11 @@
 import './$_StatsigGlobal';
+import { NetworkPriority } from './NetworkConfig';
 import { StatsigClientEmitEventFunc } from './StatsigClientBase';
 import { AnyStatsigOptions } from './StatsigOptionsCommon';
 type RequestArgs = {
     sdkKey: string;
     url: string;
+    priority?: NetworkPriority;
     retries?: number;
     params?: Record<string, string>;
     headers?: Record<string, string>;

package/src/NetworkCore.js

@@ -15,6 +15,7 @@ const Diagnostics_1 = require("./Diagnostics");
 const Log_1 = require("./Log");
 const NetworkConfig_1 = require("./NetworkConfig");
 const SDKType_1 = require("./SDKType");
+const SafeJs_1 = require("./SafeJs");
 const SessionID_1 = require("./SessionID");
 const StableID_1 = require("./StableID");
 const StatsigMetadata_1 = require("./StatsigMetadata");
@@ -51,23 +52,28 @@ class NetworkCore {
         });
     }
     _sendRequest(args) {
-        var _a;
+        var _a, _b, _c;
         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) {
+                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 url = yield this._getPopulatedURL(args);
             let response = null;
             try {
-                response = yield fetch(url, {
+                const config = {
                     method,
                     body,
                     headers: Object.assign({}, args.headers),
                     signal: controller.signal,
-                });
+                    priority: args.priority,
+                };
+                response = yield fetch(url, config);
                 clearTimeout(handle);
                 if (!response.ok) {
                     const text = yield response.text().catch(() => 'No Text');
@@ -86,7 +92,7 @@ class NetworkCore {
                 const errorMessage = _getErrorMessage(controller, error);
                 Diagnostics_1.Diagnostics.mark();
                 if (!retries || retries <= 0) {
-                    (_a = this._emitter) === null || _a === void 0 ? void 0 : _a.call(this, { name: 'error', error });
+                    (_c = this._emitter) === null || _c === void 0 ? void 0 : _c.call(this, { name: 'error', error });
                     Log_1.Log.error(`A networking error occured during ${method} request to ${url}.`, errorMessage, error);
                     return null;
                 }
@@ -118,15 +124,22 @@ class NetworkCore {
     }
     _attemptToEncodeString(args, input) {
         var _a, _b, _c;
-        if ((__STATSIG__ === null || __STATSIG__ === void 0 ? void 0 : __STATSIG__['no-encode']) != null ||
+        const win = (0, SafeJs_1._getWindowSafe)();
+        if (!(win === null || win === void 0 ? void 0 : win.btoa) ||
+            (__STATSIG__ === null || __STATSIG__ === void 0 ? void 0 : __STATSIG__['no-encode']) != null ||
             ((_a = this._options) === null || _a === void 0 ? void 0 : _a.disableStatsigEncoding) ||
-            !args.isStatsigEncodable ||
-            typeof window === 'undefined' ||
-            !window.btoa) {
+            !args.isStatsigEncodable) {
+            return input;
+        }
+        try {
+            const result = (_b = win.btoa(input).split('').reverse().join('')) !== null && _b !== void 0 ? _b : input;
+            args.params = Object.assign(Object.assign({}, ((_c = args.params) !== null && _c !== void 0 ? _c : {})), { [NetworkConfig_1.NetworkParam.StatsigEncoded]: '1' });
+            return result;
+        }
+        catch (_d) {
+            Log_1.Log.warn('/initialize request encoding failed');
             return input;
         }
-        args.params = Object.assign(Object.assign({}, ((_b = args.params) !== null && _b !== void 0 ? _b : {})), { [NetworkConfig_1.NetworkParam.StatsigEncoded]: '1' });
-        return (_c = window.btoa(input).split('').reverse().join('')) !== null && _c !== void 0 ? _c : input;
     }
 }
 exports.NetworkCore = NetworkCore;

package/src/SessionID.js

@@ -57,17 +57,13 @@ function _bumpSession(session) {
     }
     data.lastUpdate = now;
     _persistToStorage(data, session.sdkKey);
-    session.data = data;
     clearTimeout(session.idleTimeoutID);
     clearTimeout(session.ageTimeoutID);
     const lifetime = now - data.startTime;
     const sdkKey = session.sdkKey;
-    return {
-        data,
-        sdkKey,
-        // idleTimeoutID: _createSessionTimeout(sdkKey, MAX_SESSION_IDLE_TIME),
-        ageTimeoutID: _createSessionTimeout(sdkKey, MAX_SESSION_AGE - lifetime),
-    };
+    session.idleTimeoutID = _createSessionTimeout(sdkKey, MAX_SESSION_IDLE_TIME);
+    session.ageTimeoutID = _createSessionTimeout(sdkKey, MAX_SESSION_AGE - lifetime);
+    return session;
 }
 function _createSessionTimeout(sdkKey, duration) {
     return setTimeout(() => {

package/src/StatsigClientBase.js

@@ -31,7 +31,7 @@ class StatsigClientBase {
         (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._errorBoundary = new ErrorBoundary_1.ErrorBoundary(sdkKey, emitter);
+        this._errorBoundary = new ErrorBoundary_1.ErrorBoundary(sdkKey, options, emitter);
         this._errorBoundary.wrap(this);
         this._errorBoundary.wrap(network);
         this._errorBoundary.wrap(adapter);

package/src/StatsigDataAdapter.d.ts

@@ -1,3 +1,4 @@
+import { NetworkPriority } from './NetworkConfig';
 import type { AnyStatsigOptions, NetworkConfigCommon } from './StatsigOptionsCommon';
 import { StatsigUser } from './StatsigUser';
 export type DataSource = 'Uninitialized' | 'Loading' | 'NoValues' | 'Cache' | 'Network' | 'NetworkNotModified' | 'Bootstrap' | 'Prefetch';
@@ -14,15 +15,23 @@ export type DataAdapterAsyncOptions = {
      * Note: If no timeout is given, the {@link NetworkConfigCommon.networkTimeoutMs|StatsigOptions.networkConfig.networkTimeoutMs} is used.
      */
     readonly timeoutMs?: NetworkConfigCommon['networkTimeoutMs'];
+    /**
+     * The priority that should be applied to the Http request that is fired.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/fetch#priority
+     *
+     * default: 'auto'
+     */
+    readonly priority?: NetworkPriority;
 };
 export declare const DataAdapterCachePrefix = "statsig.cached";
 /**
  * Describes a type that is used during intialize/update operations of a Statsig client.
  *
  * See below to find the default adapters, but know that it is possible to create your
- * own StatsigDataAdapter and provide it via {@link AnyStatsigOptions.dataAdapter}.
+ * own StatsigDataAdapter and provide it via `StatsigOptions.dataAdapter`.
  *
- * Defaults:
+ * defaults:
  *
  * - {@link StatsigClient} uses {@link EvaluationsDataAdapter}
  *

package/src/StatsigMetadata.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "0.0.1-beta.37";
+export declare const SDK_VERSION = "0.0.1-beta.39";
 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.37';
+exports.SDK_VERSION = '0.0.1-beta.39';
 let metadata = {
     sdkVersion: exports.SDK_VERSION,
     sdkType: 'js-mono', // js-mono is overwritten by Precomp and OnDevice clients

package/src/StatsigOptionsCommon.d.ts

@@ -38,6 +38,10 @@ export type NetworkConfigCommon = {
      * default: `10,000 ms` (10 seconds)
      */
     networkTimeoutMs?: number;
+    /**
+     * Intended for testing purposes. Prevents any network requests being made.
+     */
+    preventAllNetworkTraffic?: boolean;
 };
 /** Options for configuring a Statsig client. */
 export type StatsigOptionsCommon<NetworkConfig extends NetworkConfigCommon> = StatsigRuntimeMutableOptions & {

package/src/StorageProvider.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports._setObjectInStorage = exports._getObjectFromStorage = exports.Storage = void 0;
 const Log_1 = require("./Log");
 const inMemoryStore = {};
+const _resolve = (input) => Promise.resolve(input);
 const _inMemoryProvider = {
     _getProviderName: () => 'InMemory',
     _getItemSync(key) {
@@ -20,18 +21,18 @@ const _inMemoryProvider = {
     },
     _getItem(key) {
         var _a;
-        return Promise.resolve((_a = inMemoryStore[key]) !== null && _a !== void 0 ? _a : null);
+        return _resolve((_a = inMemoryStore[key]) !== null && _a !== void 0 ? _a : null);
     },
     _setItem(key, value) {
         inMemoryStore[key] = value;
-        return Promise.resolve();
+        return _resolve();
     },
     _removeItem(key) {
         delete inMemoryStore[key];
-        return Promise.resolve();
+        return _resolve();
     },
     _getAllKeys() {
-        return Promise.resolve(Object.keys(inMemoryStore));
+        return _resolve(Object.keys(inMemoryStore));
     },
 };
 let _localStorageProvider = null;
@@ -43,19 +44,19 @@ try {
                 return localStorage.getItem(key);
             },
             _getItem(key) {
-                return Promise.resolve(localStorage.getItem(key));
+                return _resolve(localStorage.getItem(key));
             },
             _setItem(key, value) {
                 localStorage.setItem(key, value);
-                return Promise.resolve();
+                return _resolve();
             },
             _removeItem(key) {
                 localStorage.removeItem(key);
-                return Promise.resolve();
+                return _resolve();
             },
             _getAllKeys() {
                 const keys = Object.keys(localStorage);
-                return Promise.resolve(keys);
+                return _resolve(keys);
             },
         };
     }