@statsig/client-core 1.7.0 → 2.1.0

package/package.json

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

package/src/ClientInterfaces.d.ts

@@ -21,18 +21,14 @@ export type CommonContext = {
     sdkKey: string;
     options: AnyStatsigOptions;
     errorBoundary: ErrorBoundary;
-};
-export type AsyncCommonContext = {
     session: StatsigSession;
     stableID: string;
 };
 export type OnDeviceEvaluationsContext = CommonContext & {
     values: DownloadConfigSpecsResponse | null;
 };
-export type OnDeviceEvaluationsAsyncContext = OnDeviceEvaluationsContext & AsyncCommonContext;
 export interface OnDeviceEvaluationsInterface extends StatsigClientCommonInterface {
     readonly dataAdapter: SpecsDataAdapter;
-    getAsyncContext(): Promise<OnDeviceEvaluationsAsyncContext>;
     getContext(): OnDeviceEvaluationsContext;
     checkGate(name: string, user: StatsigUser, options?: FeatureGateEvaluationOptions): boolean;
     getFeatureGate(name: string, user: StatsigUser, options?: FeatureGateEvaluationOptions): FeatureGate;
@@ -46,10 +42,8 @@ export type PrecomputedEvaluationsContext = Flatten<CommonContext & {
     values: InitializeResponseWithUpdates | null;
     user: StatsigUser;
 }>;
-export type PrecomputedEvaluationsAsyncContext = Flatten<AsyncCommonContext & PrecomputedEvaluationsContext>;
 export interface PrecomputedEvaluationsInterface extends StatsigClientCommonInterface {
     readonly dataAdapter: EvaluationsDataAdapter;
-    getAsyncContext(): Promise<PrecomputedEvaluationsAsyncContext>;
     getContext(): PrecomputedEvaluationsContext;
     updateUserSync(user: StatsigUser): void;
     updateUserAsync(user: StatsigUser): Promise<void>;

package/src/DataAdapterCore.js

@@ -118,7 +118,7 @@ class DataAdapterCore {
     }
     _loadFromCache(cacheKey) {
         var _a;
-        const cache = (_a = StorageProvider_1.Storage._getItemSync) === null || _a === void 0 ? void 0 : _a.call(StorageProvider_1.Storage, cacheKey);
+        const cache = (_a = StorageProvider_1.Storage._getItem) === null || _a === void 0 ? void 0 : _a.call(StorageProvider_1.Storage, cacheKey);
         if (cache == null) {
             return null;
         }

package/src/Diagnostics.d.ts

@@ -1,3 +1,67 @@
-export declare abstract class Diagnostics {
-    static mark(): void;
+import { EvaluationDetails } from './EvaluationTypes';
+import { EventLogger } from './EventLogger';
+import { NetworkConfigCommon, StatsigOptionsCommon } from './StatsigOptionsCommon';
+import { StatsigUserInternal } from './StatsigUser';
+export type KeyType = 'initialize' | 'overall';
+export type StepType = 'process' | 'network_request';
+export type ActionType = 'start' | 'end';
+export interface Marker {
+    key: KeyType;
+    action: ActionType;
+    timestamp: number;
+    step?: StepType;
+    statusCode?: number;
+    success?: boolean;
+    url?: string;
+    idListCount?: number;
+    sdkRegion?: string | null;
+    markerID?: string;
+    attempt?: number;
+    isRetry?: boolean;
+    configName?: string;
+    message?: string | null;
+    evaluationDetails?: EvaluationDetails;
+    error?: Record<string, unknown>;
+    isDelta?: boolean;
 }
+export declare const Diagnostics: {
+    _getMarkers: (sdkKey: string) => Marker[] | undefined;
+    _markInitOverallStart: (sdkKey: string) => void;
+    _markInitOverallEnd: (sdkKey: string, success: boolean, evaluationDetails?: EvaluationDetails) => void;
+    _markInitNetworkReqStart: (sdkKey: string, data: InitializeDataType['networkRequest']['start']) => void;
+    _markInitNetworkReqEnd: (sdkKey: string, data: InitializeDataType['networkRequest']['end']) => void;
+    _markInitProcessStart: (sdkKey: string) => void;
+    _markInitProcessEnd: (sdkKey: string, data: InitializeDataType['process']['end']) => void;
+    _clearMarkers: (sdkKey: string) => void;
+    _formatError(e: unknown): Record<string, unknown> | undefined;
+    _getDiagnosticsData(res: Response | null, attempt: number, body: string, e?: unknown): {
+        success: boolean;
+        isDelta?: boolean | undefined;
+        sdkRegion?: string | null | undefined;
+        statusCode?: number | undefined;
+        attempt: number;
+        error?: Record<string, unknown> | undefined;
+    };
+    _enqueueDiagnosticsEvent(user: StatsigUserInternal | null, logger: EventLogger, sdk: string, options: StatsigOptionsCommon<NetworkConfigCommon> | null): void;
+};
+interface InitializeDataType {
+    process: {
+        end: {
+            success: boolean;
+        };
+    };
+    networkRequest: {
+        start: {
+            attempt: number;
+        };
+        end: {
+            success: boolean;
+            attempt: number;
+            isDelta?: boolean;
+            sdkRegion?: string | null;
+            statusCode?: number;
+            error?: Record<string, unknown>;
+        };
+    };
+}
+export {};

package/src/Diagnostics.js

@@ -1,9 +1,98 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Diagnostics = void 0;
-class Diagnostics {
-    static mark() {
-        //
+const MARKER_MAP = new Map();
+const ACT_START = 'start';
+const ACT_END = 'end';
+const DIAGNOSTICS_EVENT = 'statsig::diagnostics';
+exports.Diagnostics = {
+    _getMarkers: (sdkKey) => {
+        return MARKER_MAP.get(sdkKey);
+    },
+    _markInitOverallStart: (sdkKey) => {
+        _addMarker(sdkKey, _createMarker({}, ACT_START, 'overall'));
+    },
+    _markInitOverallEnd: (sdkKey, success, evaluationDetails) => {
+        _addMarker(sdkKey, _createMarker({
+            success,
+            error: success
+                ? undefined
+                : { name: 'InitializeError', message: 'Failed to initialize' },
+            evaluationDetails,
+        }, ACT_END, 'overall'));
+    },
+    _markInitNetworkReqStart: (sdkKey, data) => {
+        _addMarker(sdkKey, _createMarker(data, ACT_START, 'initialize', 'network_request'));
+    },
+    _markInitNetworkReqEnd: (sdkKey, data) => {
+        _addMarker(sdkKey, _createMarker(data, ACT_END, 'initialize', 'network_request'));
+    },
+    _markInitProcessStart: (sdkKey) => {
+        _addMarker(sdkKey, _createMarker({}, ACT_START, 'initialize', 'process'));
+    },
+    _markInitProcessEnd: (sdkKey, data) => {
+        _addMarker(sdkKey, _createMarker(data, ACT_END, 'initialize', 'process'));
+    },
+    _clearMarkers: (sdkKey) => {
+        MARKER_MAP.delete(sdkKey);
+    },
+    _formatError(e) {
+        if (!(e && typeof e === 'object')) {
+            return;
+        }
+        return {
+            code: _safeGetField(e, 'code'),
+            name: _safeGetField(e, 'name'),
+            message: _safeGetField(e, 'message'),
+        };
+    },
+    _getDiagnosticsData(res, attempt, body, e) {
+        var _a;
+        return {
+            success: (res === null || res === void 0 ? void 0 : res.ok) === true,
+            statusCode: res === null || res === void 0 ? void 0 : res.status,
+            sdkRegion: (_a = res === null || res === void 0 ? void 0 : res.headers) === null || _a === void 0 ? void 0 : _a.get('x-statsig-region'),
+            isDelta: body.includes('"is_delta":true') === true ? true : undefined,
+            attempt,
+            error: exports.Diagnostics._formatError(e),
+        };
+    },
+    _enqueueDiagnosticsEvent(user, logger, sdk, options) {
+        const markers = exports.Diagnostics._getMarkers(sdk);
+        if (markers == null || markers.length <= 0) {
+            return;
+        }
+        exports.Diagnostics._clearMarkers(sdk);
+        const event = _makeDiagnosticsEvent(user, {
+            context: 'initialize',
+            markers: markers.slice(),
+            statsigOptions: options,
+        });
+        logger.enqueue(event);
+    },
+};
+function _createMarker(data, action, key, step) {
+    return Object.assign({ key: key, action: action, step: step, timestamp: Date.now() }, data);
+}
+function _makeDiagnosticsEvent(user, data) {
+    const latencyEvent = {
+        eventName: DIAGNOSTICS_EVENT,
+        user,
+        value: null,
+        metadata: data,
+        time: Date.now(),
+    };
+    return latencyEvent;
+}
+function _addMarker(sdkKey, marker) {
+    var _a;
+    const markers = (_a = MARKER_MAP.get(sdkKey)) !== null && _a !== void 0 ? _a : [];
+    markers.push(marker);
+    MARKER_MAP.set(sdkKey, markers);
+}
+function _safeGetField(data, field) {
+    if (field in data) {
+        return data[field];
     }
+    return undefined;
 }
-exports.Diagnostics = Diagnostics;

package/src/EventLogger.js

@@ -118,6 +118,9 @@ class EventLogger {
         setTimeout(() => _safeFlushAndForget(this._sdkKey), QUICK_FLUSH_WINDOW_MS);
     }
     _shouldLogEvent(event) {
+        if ((0, SafeJs_1._isServerEnv)()) {
+            return false; // do not run in server environments
+        }
         if (!(0, StatsigEvent_1._isExposureEvent)(event)) {
             return true;
         }
@@ -206,18 +209,21 @@ class EventLogger {
             events.shift();
         }
         const storageKey = this._getStorageKey();
-        (0, StorageProvider_1._setObjectInStorage)(storageKey, events).catch(() => {
+        try {
+            (0, StorageProvider_1._setObjectInStorage)(storageKey, events);
+        }
+        catch (_a) {
             Log_1.Log.warn('Unable to save failed logs to storage');
-        });
+        }
     }
     _retryFailedLogs() {
         const storageKey = this._getStorageKey();
         (() => __awaiter(this, void 0, void 0, function* () {
-            const events = yield (0, StorageProvider_1._getObjectFromStorage)(storageKey);
+            const events = (0, StorageProvider_1._getObjectFromStorage)(storageKey);
             if (!events) {
                 return;
             }
-            yield StorageProvider_1.Storage._removeItem(storageKey);
+            StorageProvider_1.Storage._removeItem(storageKey);
             yield this._sendEvents(events);
         }))().catch(() => {
             Log_1.Log.warn('Failed to flush stored logs');

package/src/InitializeResponse.d.ts

@@ -5,7 +5,12 @@ type SessionReplayFields = {
     can_record_session?: boolean;
     session_recording_rate?: number;
 };
-export type InitializeResponseWithUpdates = SessionReplayFields & {
+type AutoCaptureFields = {
+    auto_capture_settings?: {
+        disabled_events: Record<string, boolean>;
+    };
+};
+export type InitializeResponseWithUpdates = SessionReplayFields & AutoCaptureFields & {
     feature_gates: Record<string, GateEvaluation>;
     dynamic_configs: Record<string, DynamicConfigEvaluation>;
     layer_configs: Record<string, LayerEvaluation>;

package/src/Log.js

@@ -2,6 +2,11 @@
 /* eslint-disable no-console */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Log = exports.LogLevel = void 0;
+// intentionally spaced for formatting
+const DEBUG = ' DEBUG ';
+const _INFO = '  INFO ';
+const _WARN = '  WARN ';
+const ERROR = ' ERROR ';
 function addTag(args) {
     args.unshift('[Statsig]');
     return args; // ['[Statsig]', ...args];
@@ -17,24 +22,24 @@ var LogLevel;
 class Log {
     static info(...args) {
         if (this.level >= LogLevel.Info) {
-            console.info(...addTag(args));
+            console.info('\x1b[34m%s\x1b[0m', _INFO, ...addTag(args));
         }
     }
     static debug(...args) {
         if (this.level >= LogLevel.Debug) {
-            console.debug(...addTag(args));
+            console.debug('\x1b[32m%s\x1b[0m', DEBUG, ...addTag(args));
         }
     }
     static warn(...args) {
         if (this.level >= LogLevel.Warn) {
-            console.warn(...addTag(args));
+            console.warn('\x1b[33m%s\x1b[0m', _WARN, ...addTag(args));
         }
     }
     static error(...args) {
         if (this.level >= LogLevel.Error) {
-            console.error(...addTag(args));
+            console.error('\x1b[31m%s\x1b[0m', ERROR, ...addTag(args));
         }
     }
 }
 exports.Log = Log;
-Log.level = LogLevel.Error;
+Log.level = LogLevel.Warn;

package/src/NetworkCore.d.ts

@@ -8,6 +8,8 @@ type RequestArgs = {
     url: string;
     priority?: NetworkPriority;
     retries?: number;
+    attempt?: number;
+    isInitialize?: boolean;
     params?: Record<string, string>;
     headers?: Record<string, string>;
 };
@@ -16,7 +18,7 @@ export type RequestArgsWithData = Flatten<RequestArgs & {
     isStatsigEncodable?: boolean;
     isCompressable?: boolean;
 }>;
-type BeaconRequestArgs = Pick<RequestArgsWithData, 'data' | 'sdkKey' | 'url' | 'params' | 'isCompressable'>;
+type BeaconRequestArgs = Pick<RequestArgsWithData, 'data' | 'sdkKey' | 'url' | 'params' | 'isCompressable' | 'attempt'>;
 type NetworkResponse = {
     body: string | null;
     code: number;

package/src/NetworkCore.js

@@ -22,6 +22,7 @@ const StableID_1 = require("./StableID");
 const StatsigMetadata_1 = require("./StatsigMetadata");
 const VisibilityObserving_1 = require("./VisibilityObserving");
 const DEFAULT_TIMEOUT_MS = 10000;
+const RETRYABLE_CODES = new Set([408, 500, 502, 503, 504, 522, 524, 599]);
 class NetworkCore {
     constructor(options, _emitter) {
         this._emitter = _emitter;
@@ -66,7 +67,7 @@ class NetworkCore {
         });
     }
     _sendRequest(args) {
-        var _a, _b;
+        var _a, _b, _c;
         return __awaiter(this, void 0, void 0, function* () {
             if (!_ensureValidSdkKey(args)) {
                 return null;
@@ -74,7 +75,8 @@ class NetworkCore {
             if (this._netConfig.preventAllNetworkTraffic) {
                 return null;
             }
-            const { method, body, retries } = args;
+            const { method, body, retries, attempt } = args;
+            const currentAttempt = attempt !== null && attempt !== void 0 ? attempt : 1;
             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);
@@ -89,6 +91,11 @@ class NetworkCore {
                     priority: args.priority,
                     keepalive,
                 };
+                if (args.isInitialize) {
+                    Diagnostics_1.Diagnostics._markInitNetworkReqStart(args.sdkKey, {
+                        attempt: currentAttempt,
+                    });
+                }
                 const func = (_a = this._netConfig.networkOverrideFunc) !== null && _a !== void 0 ? _a : fetch;
                 response = yield func(url, config);
                 clearTimeout(handle);
@@ -99,7 +106,9 @@ class NetworkCore {
                     throw err;
                 }
                 const text = yield response.text();
-                Diagnostics_1.Diagnostics.mark();
+                if (args.isInitialize) {
+                    Diagnostics_1.Diagnostics._markInitNetworkReqEnd(args.sdkKey, Diagnostics_1.Diagnostics._getDiagnosticsData(response, currentAttempt, text));
+                }
                 return {
                     body: text,
                     code: response.status,
@@ -107,13 +116,17 @@ class NetworkCore {
             }
             catch (error) {
                 const errorMessage = _getErrorMessage(controller, error);
-                Diagnostics_1.Diagnostics.mark();
-                if (!retries || retries <= 0) {
-                    (_b = this._emitter) === null || _b === void 0 ? void 0 : _b.call(this, { name: 'error', error });
+                if (args.isInitialize) {
+                    Diagnostics_1.Diagnostics._markInitNetworkReqEnd(args.sdkKey, Diagnostics_1.Diagnostics._getDiagnosticsData(response, currentAttempt, '', error));
+                }
+                if (!retries ||
+                    currentAttempt > retries ||
+                    !RETRYABLE_CODES.has((_b = response === null || response === void 0 ? void 0 : response.status) !== null && _b !== void 0 ? _b : 500)) {
+                    (_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;
                 }
-                return this._sendRequest(Object.assign(Object.assign({}, args), { retries: retries - 1 }));
+                return this._sendRequest(Object.assign(Object.assign({}, args), { retries: retries, attempt: currentAttempt + 1 }));
             }
         });
     }

package/src/SessionID.d.ts

@@ -11,10 +11,10 @@ export type StatsigSession = {
     idleTimeoutID?: SessionTimeoutID;
 };
 export declare const SessionID: {
-    get: (sdkKey: string) => Promise<string>;
+    get: (sdkKey: string) => string;
 };
 export declare const StatsigSession: {
-    get: (sdkKey: string) => Promise<StatsigSession>;
+    get: (sdkKey: string) => StatsigSession;
     overrideInitialSessionID: (override: string, sdkKey: string) => void;
 };
 export {};

package/src/SessionID.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatsigSession = exports.SessionID = void 0;
 const CacheKey_1 = require("./CacheKey");
@@ -18,49 +9,47 @@ const MAX_SESSION_IDLE_TIME = 30 * 60 * 1000; // 30 minutes
 const MAX_SESSION_AGE = 4 * 60 * 60 * 1000; // 4 hours
 const PROMISE_MAP = {};
 exports.SessionID = {
-    get: (sdkKey) => __awaiter(void 0, void 0, void 0, function* () {
-        return exports.StatsigSession.get(sdkKey).then((x) => x.data.sessionID);
-    }),
+    get: (sdkKey) => {
+        return exports.StatsigSession.get(sdkKey).data.sessionID;
+    },
 };
 exports.StatsigSession = {
-    get: (sdkKey) => __awaiter(void 0, void 0, void 0, function* () {
+    get: (sdkKey) => {
         if (PROMISE_MAP[sdkKey] == null) {
             PROMISE_MAP[sdkKey] = _loadSession(sdkKey);
         }
-        const session = yield PROMISE_MAP[sdkKey];
+        const session = PROMISE_MAP[sdkKey];
         return _bumpSession(session);
-    }),
+    },
     overrideInitialSessionID: (override, sdkKey) => {
         PROMISE_MAP[sdkKey] = _overrideSessionId(override, sdkKey);
     },
 };
 function _loadSession(sdkKey) {
-    return __awaiter(this, void 0, void 0, function* () {
-        let data = yield _loadFromStorage(sdkKey);
-        const now = Date.now();
-        if (!data) {
-            data = {
-                sessionID: (0, UUID_1.getUUID)(),
-                startTime: now,
-                lastUpdate: now,
-            };
-        }
-        return {
-            data,
-            sdkKey,
+    let data = _loadFromStorage(sdkKey);
+    const now = Date.now();
+    if (!data) {
+        data = {
+            sessionID: (0, UUID_1.getUUID)(),
+            startTime: now,
+            lastUpdate: now,
         };
-    });
+    }
+    return {
+        data,
+        sdkKey,
+    };
 }
 function _overrideSessionId(override, sdkKey) {
     const now = Date.now();
-    return Promise.resolve({
+    return {
         data: {
             sessionID: override,
             startTime: now,
             lastUpdate: now,
         },
         sdkKey,
-    });
+    };
 }
 function _bumpSession(session) {
     const now = Date.now();
@@ -98,9 +87,12 @@ function _getSessionIDStorageKey(sdkKey) {
 }
 function _persistToStorage(session, sdkKey) {
     const storageKey = _getSessionIDStorageKey(sdkKey);
-    (0, StorageProvider_1._setObjectInStorage)(storageKey, session).catch(() => {
+    try {
+        (0, StorageProvider_1._setObjectInStorage)(storageKey, session);
+    }
+    catch (e) {
         Log_1.Log.warn('Failed to save SessionID');
-    });
+    }
 }
 function _loadFromStorage(sdkKey) {
     const storageKey = _getSessionIDStorageKey(sdkKey);

package/src/StableID.d.ts

@@ -1,4 +1,4 @@
 export declare const StableID: {
-    get: (sdkKey: string) => Promise<string>;
+    get: (sdkKey: string) => string;
     setOverride: (override: string, sdkKey: string) => void;
 };

package/src/StableID.js

@@ -1,13 +1,4 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StableID = void 0;
 const CacheKey_1 = require("./CacheKey");
@@ -16,21 +7,19 @@ const StorageProvider_1 = require("./StorageProvider");
 const UUID_1 = require("./UUID");
 const PROMISE_MAP = {};
 exports.StableID = {
-    get: (sdkKey) => __awaiter(void 0, void 0, void 0, function* () {
+    get: (sdkKey) => {
         if (PROMISE_MAP[sdkKey] == null) {
-            PROMISE_MAP[sdkKey] = _loadFromStorage(sdkKey).then((stableID) => {
-                if (stableID != null) {
-                    return stableID;
-                }
-                const newStableID = (0, UUID_1.getUUID)();
-                _persistToStorage(newStableID, sdkKey);
-                return newStableID;
-            });
+            let stableID = _loadFromStorage(sdkKey);
+            if (stableID == null) {
+                stableID = (0, UUID_1.getUUID)();
+                _persistToStorage(stableID, sdkKey);
+            }
+            PROMISE_MAP[sdkKey] = stableID;
         }
         return PROMISE_MAP[sdkKey];
-    }),
+    },
     setOverride: (override, sdkKey) => {
-        PROMISE_MAP[sdkKey] = Promise.resolve(override);
+        PROMISE_MAP[sdkKey] = override;
         _persistToStorage(override, sdkKey);
     },
 };
@@ -39,9 +28,12 @@ function _getStableIDStorageKey(sdkKey) {
 }
 function _persistToStorage(stableID, sdkKey) {
     const storageKey = _getStableIDStorageKey(sdkKey);
-    (0, StorageProvider_1._setObjectInStorage)(storageKey, stableID).catch(() => {
+    try {
+        (0, StorageProvider_1._setObjectInStorage)(storageKey, stableID);
+    }
+    catch (e) {
         Log_1.Log.warn('Failed to save StableID');
-    });
+    }
 }
 function _loadFromStorage(sdkKey) {
     const storageKey = _getStableIDStorageKey(sdkKey);

package/src/StatsigDataAdapter.d.ts

@@ -26,6 +26,15 @@ export type DataAdapterAsyncOptions = {
      */
     readonly priority?: NetworkPriority;
 };
+export type DataAdapterSyncOptions = {
+    /**
+     * The flag to disable background cache refresh.
+     * If set to true, the cache will not be updated in the background and will only use the data adatpter values.
+     *
+     * default: false
+     */
+    readonly disableBackgroundCacheRefresh?: boolean;
+};
 export declare const DataAdapterCachePrefix = "statsig.cached";
 /**
  * Describes a type that is used during intialize/update operations of a Statsig client.

package/src/StatsigMetadata.d.ts

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

package/src/StorageProvider.d.ts

@@ -1,16 +1,15 @@
 export type StorageProvider = {
     _getProviderName: () => string;
-    _getItem: (key: string) => Promise<string | null>;
-    _setItem: (key: string, value: string) => Promise<void>;
-    _removeItem: (key: string) => Promise<void>;
-    _getAllKeys: () => Promise<readonly string[]>;
-    _getItemSync?: (key: string) => string | null;
+    _getItem: (key: string) => string | null;
+    _setItem: (key: string, value: string) => void;
+    _removeItem: (key: string) => void;
+    _getAllKeys: () => readonly string[];
 };
 type StorageProviderManagment = {
     _setProvider: (newProvider: StorageProvider) => void;
     _setDisabled: (isDisabled: boolean) => void;
 };
 export declare const Storage: StorageProvider & StorageProviderManagment;
-export declare function _getObjectFromStorage<T>(key: string): Promise<T | null>;
-export declare function _setObjectInStorage(key: string, obj: unknown): Promise<void>;
+export declare function _getObjectFromStorage<T>(key: string): T | null;
+export declare function _setObjectInStorage(key: string, obj: unknown): void;
 export {};

package/src/StorageProvider.js

@@ -1,26 +1,19 @@
 "use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 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) => 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)),
+    _getItem: (key) => inMemoryStore[key] ? inMemoryStore[key] : null,
+    _setItem: (key, value) => {
+        inMemoryStore[key] = value;
+    },
+    _removeItem: (key) => {
+        delete inMemoryStore[key];
+    },
+    _getAllKeys: () => Object.keys(inMemoryStore),
 };
 let _localStorageProvider = null;
 try {
@@ -30,11 +23,10 @@ try {
         typeof win.localStorage.getItem === 'function') {
         _localStorageProvider = {
             _getProviderName: () => 'LocalStorage',
-            _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)),
+            _getItem: (key) => win.localStorage.getItem(key),
+            _setItem: (key, value) => win.localStorage.setItem(key, value),
+            _removeItem: (key) => win.localStorage.removeItem(key),
+            _getAllKeys: () => Object.keys(win.localStorage),
         };
     }
 }
@@ -57,8 +49,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(() => _current._getItemSync ? _current._getItemSync(key) : null),
+    _getItem: (key) => _inMemoryBreaker(() => _current._getItem(key)),
     _setItem: (key, value) => _current._setItem(key, value),
     _removeItem: (key) => _current._removeItem(key),
     _getAllKeys: () => _current._getAllKeys(),
@@ -77,15 +68,11 @@ exports.Storage = {
     },
 };
 function _getObjectFromStorage(key) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const value = yield exports.Storage._getItem(key);
-        return JSON.parse(value !== null && value !== void 0 ? value : 'null');
-    });
+    const value = exports.Storage._getItem(key);
+    return JSON.parse(value !== null && value !== void 0 ? value : 'null');
 }
 exports._getObjectFromStorage = _getObjectFromStorage;
 function _setObjectInStorage(key, obj) {
-    return __awaiter(this, void 0, void 0, function* () {
-        yield exports.Storage._setItem(key, JSON.stringify(obj));
-    });
+    exports.Storage._setItem(key, JSON.stringify(obj));
 }
 exports._setObjectInStorage = _setObjectInStorage;

package/src/index.d.ts

@@ -1,5 +1,6 @@
 /** Statsig Global should go first */
 import './$_StatsigGlobal';
+import { Diagnostics } from './Diagnostics';
 import { EventLogger } from './EventLogger';
 import { Log } from './Log';
 import { Storage } from './StorageProvider';
@@ -7,6 +8,7 @@ export * from './$_StatsigGlobal';
 export * from './CacheKey';
 export * from './ClientInterfaces';
 export * from './DataAdapterCore';
+export * from './Diagnostics';
 export * from './DownloadConfigSpecsResponse';
 export * from './ErrorBoundary';
 export * from './EvaluationOptions';
@@ -37,4 +39,4 @@ export * from './TypingUtils';
 export * from './UrlOverrides';
 export * from './UUID';
 export * from './VisibilityObserving';
-export { EventLogger, Storage, Log };
+export { EventLogger, Storage, Log, Diagnostics };

package/src/index.js

@@ -14,9 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Log = exports.Storage = exports.EventLogger = void 0;
+exports.Diagnostics = exports.Log = exports.Storage = exports.EventLogger = void 0;
 /** Statsig Global should go first */
 require("./$_StatsigGlobal");
+const Diagnostics_1 = require("./Diagnostics");
+Object.defineProperty(exports, "Diagnostics", { enumerable: true, get: function () { return Diagnostics_1.Diagnostics; } });
 const EventLogger_1 = require("./EventLogger");
 Object.defineProperty(exports, "EventLogger", { enumerable: true, get: function () { return EventLogger_1.EventLogger; } });
 const Log_1 = require("./Log");
@@ -28,6 +30,7 @@ __exportStar(require("./$_StatsigGlobal"), exports);
 __exportStar(require("./CacheKey"), exports);
 __exportStar(require("./ClientInterfaces"), exports);
 __exportStar(require("./DataAdapterCore"), exports);
+__exportStar(require("./Diagnostics"), exports);
 __exportStar(require("./DownloadConfigSpecsResponse"), exports);
 __exportStar(require("./ErrorBoundary"), exports);
 __exportStar(require("./EvaluationOptions"), exports);