@statsig/client-core 0.0.1-beta.5 → 0.0.1-beta.7

package/package.json

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

package/src/ClientInterfaces.d.ts

@@ -4,7 +4,8 @@ import { StatsigEvent } from './StatsigEvent';
 import { DynamicConfig, Experiment, FeatureGate, Layer } from './StatsigTypes';
 import { StatsigUser } from './StatsigUser';
 export interface StatsigClientCommonInterface extends StatsigClientEventEmitterInterface {
-    initialize(): Promise<void>;
+    initializeSync(): void;
+    initializeAsync(): Promise<void>;
     shutdown(): Promise<void>;
 }
 export interface OnDeviceEvaluationsInterface extends StatsigClientCommonInterface {
@@ -17,7 +18,8 @@ export interface OnDeviceEvaluationsInterface extends StatsigClientCommonInterfa
 }
 export interface PrecomputedEvaluationsInterface extends StatsigClientCommonInterface {
     getCurrentUser(): StatsigUser;
-    updateUser(user: StatsigUser): Promise<void>;
+    updateUserSync(user: StatsigUser): void;
+    updateUserAsync(user: StatsigUser): Promise<void>;
     checkGate(name: string, options: EvaluationOptions): boolean;
     getFeatureGate(name: string, options: EvaluationOptions): FeatureGate;
     getDynamicConfig(name: string, options: EvaluationOptions): DynamicConfig;

package/src/EventLogger.d.ts

@@ -13,14 +13,16 @@ export declare class EventLogger {
     private _lastExposureMap;
     private _maxQueueSize;
     private _failedLogs;
-    private _hasFiredQuickFlush;
+    private _hasRunQuickFlush;
+    private _creationTime;
     constructor(_sdkKey: string, _emitter: StatsigClientEmitEventFunc, _network: NetworkCore, _options: StatsigOptionsCommon | null);
     enqueue(event: StatsigEventInternal): void;
     reset(): void;
     onVisibilityChanged(visibility: Visibility): void;
     shutdown(): Promise<void>;
     /**
-     * We 'Quick Flush' following the very first enqueued event
+     * We 'Quick Flush' following the very first event enqueued
+     * within the quick flush window
      */
     private _quickFlushIfNeeded;
     private _shouldLogEvent;

package/src/EventLogger.js

@@ -60,6 +60,7 @@ var MAX_DEDUPER_KEYS = 1000;
 var DEDUPER_WINDOW_DURATION_MS = 60000;
 var MAX_FAILED_LOGS = 500;
 var DEFAULT_API = 'https://api.statsig.com/v1';
+var QUICK_FLUSH_WINDOW_MS = 200;
 var EventLogger = /** @class */ (function () {
     function EventLogger(_sdkKey, _emitter, _network, _options) {
         var _this = this;
@@ -70,7 +71,8 @@ var EventLogger = /** @class */ (function () {
         this._options = _options;
         this._queue = [];
         this._lastExposureMap = {};
-        this._hasFiredQuickFlush = false;
+        this._hasRunQuickFlush = false;
+        this._creationTime = Date.now();
         this._maxQueueSize = (_a = _options === null || _options === void 0 ? void 0 : _options.loggingBufferMaxSize) !== null && _a !== void 0 ? _a : DEFAULT_QUEUE_SIZE;
         var flushInterval = (_b = _options === null || _options === void 0 ? void 0 : _options.loggingIntervalMs) !== null && _b !== void 0 ? _b : DEFAULT_FLUSH_INTERVAL_MS;
         this._flushTimer = setInterval(function () { return _this._flushAndForget(); }, flushInterval);
@@ -119,15 +121,19 @@ var EventLogger = /** @class */ (function () {
         });
     };
     /**
-     * We 'Quick Flush' following the very first enqueued event
+     * We 'Quick Flush' following the very first event enqueued
+     * within the quick flush window
      */
     EventLogger.prototype._quickFlushIfNeeded = function () {
         var _this = this;
-        if (this._hasFiredQuickFlush) {
+        if (this._hasRunQuickFlush) {
             return;
         }
-        this._hasFiredQuickFlush = true;
-        setTimeout(function () { return _this._flushAndForget(); }, 200);
+        this._hasRunQuickFlush = true;
+        if (Date.now() - this._creationTime > QUICK_FLUSH_WINDOW_MS) {
+            return;
+        }
+        setTimeout(function () { return _this._flushAndForget(); }, QUICK_FLUSH_WINDOW_MS);
     };
     EventLogger.prototype._shouldLogEvent = function (event) {
         var _a, _b, _c, _d;
@@ -233,8 +239,8 @@ var EventLogger = /** @class */ (function () {
                         })];
                     case 1:
                         result = _a.sent();
-                        if (result) {
-                            return [2 /*return*/, JSON.parse(result)];
+                        if (result === null || result === void 0 ? void 0 : result.body) {
+                            return [2 /*return*/, JSON.parse(result.body)];
                         }
                         return [2 /*return*/, { success: false }];
                 }

package/src/NetworkCore.d.ts

@@ -11,13 +11,17 @@ type RequestArgs = {
 type RequestArgsWithData = RequestArgs & {
     data: Record<string, unknown>;
 };
+type NetworkResponse = {
+    body: string | null;
+    code: number;
+};
 export declare class NetworkCore {
     private _options;
     private _emitter?;
     private readonly _timeout;
     constructor(_options: StatsigOptionsCommon | null, _emitter?: StatsigClientEmitEventFunc | undefined);
-    post(args: RequestArgsWithData): Promise<string | null>;
-    get(args: RequestArgs): Promise<string | null>;
+    post(args: RequestArgsWithData): Promise<NetworkResponse | null>;
+    get(args: RequestArgs): Promise<NetworkResponse | null>;
     beacon(args: RequestArgsWithData): boolean;
     private _sendRequest;
     private _getPopulatedURL;

package/src/NetworkCore.js

@@ -149,7 +149,10 @@ var NetworkCore = /** @class */ (function () {
                             status: response.status,
                             contentLength: response.headers.get('content-length'),
                         });
-                        return [2 /*return*/, text];
+                        return [2 /*return*/, {
+                                body: text,
+                                code: response.status,
+                            }];
                     case 4:
                         error_1 = _b.sent();
                         errorMessage = _getErrorMessage(controller, error_1);

package/src/StableID.js

@@ -64,7 +64,7 @@ exports.StableID = {
     },
 };
 function _getStableIDStorageKey(sdkKey) {
-    return "statsig.stable_id:".concat((0, Hashing_1.DJB2)(sdkKey));
+    return "statsig.stable_id.".concat((0, Hashing_1.DJB2)(sdkKey));
 }
 function _persistToStorage(stableID, sdkKey) {
     var storageKey = _getStableIDStorageKey(sdkKey);

package/src/StatsigClientBase.d.ts

@@ -3,35 +3,28 @@ import { ErrorBoundary } from './ErrorBoundary';
 import { EventLogger } from './EventLogger';
 import { NetworkCore } from './NetworkCore';
 import { StatsigClientEvent, StatsigClientEventCallback, StatsigClientEventData, StatsigClientEventEmitterInterface, StatsigLoadingStatus } from './StatsigClientEventEmitter';
-import { DataSource, StatsigDataProvider } from './StatsigDataProvider';
+import { StatsigDataAdapter, StatsigDataAdapterResult } from './StatsigDataAdapter';
 import { StatsigEventInternal } from './StatsigEvent';
 import { StatsigOptionsCommon } from './StatsigOptionsCommon';
 import { StatsigUser } from './StatsigUser';
-type DataProviderResult = {
-    data: string | null;
-    source: DataSource;
-};
 export type EvaluationOptions = {
     disableExposureLog?: boolean;
 };
 export declare const DEFAULT_EVAL_OPTIONS: EvaluationOptions;
 export type StatsigClientEmitEventFunc = (data: StatsigClientEventData) => void;
-export declare class StatsigClientBase implements StatsigClientEventEmitterInterface {
+export declare abstract class StatsigClientBase implements StatsigClientEventEmitterInterface {
+    protected readonly _sdkKey: string;
+    protected readonly _adapter: StatsigDataAdapter;
     loadingStatus: StatsigLoadingStatus;
-    protected _errorBoundary: ErrorBoundary;
-    protected _logger: EventLogger;
-    protected _sdkKey: string;
-    protected _dataProviders: StatsigDataProvider[];
+    protected readonly _errorBoundary: ErrorBoundary;
+    protected readonly _logger: EventLogger;
     private _listeners;
-    constructor(sdkKey: string, network: NetworkCore, options: StatsigOptionsCommon | null, dataProviders: StatsigDataProvider[]);
+    constructor(_sdkKey: string, _adapter: StatsigDataAdapter, network: NetworkCore, options: StatsigOptionsCommon | null);
     on(event: StatsigClientEvent | '*', listener: StatsigClientEventCallback): void;
     off(event: StatsigClientEvent | '*', listener: StatsigClientEventCallback): void;
+    getDataAdapter(): StatsigDataAdapter;
     protected emit(data: StatsigClientEventData): void;
     protected _setStatus(newStatus: StatsigLoadingStatus): void;
-    protected _getDataFromProviders(user?: StatsigUser): DataProviderResult;
-    protected _getDataFromProvidersAsync(user?: StatsigUser): Promise<DataProviderResult>;
-    protected _getDataPostInitFromProviders(currentData: string | null, user?: StatsigUser): Promise<DataProviderResult>;
-    protected _saveToDataProviders(currentData: string | null, user?: StatsigUser): void;
     protected _enqueueExposure(options: EvaluationOptions, exposure: StatsigEventInternal): void;
+    protected _runPostUpdate(current: StatsigDataAdapterResult | null, user?: StatsigUser): void;
 }
-export {};

package/src/StatsigClientBase.js

@@ -1,47 +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());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-var __asyncValues = (this && this.__asyncValues) || function (o) {
-    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
-    var m = o[Symbol.asyncIterator], i;
-    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
-    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
-    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatsigClientBase = exports.DEFAULT_EVAL_OPTIONS = void 0;
 require("./$_StatsigGlobal");
@@ -53,22 +10,23 @@ exports.DEFAULT_EVAL_OPTIONS = {
     disableExposureLog: false,
 };
 var StatsigClientBase = /** @class */ (function () {
-    function StatsigClientBase(sdkKey, network, options, dataProviders) {
+    function StatsigClientBase(_sdkKey, _adapter, network, options) {
         var _a, _b;
+        this._sdkKey = _sdkKey;
+        this._adapter = _adapter;
         this.loadingStatus = 'Uninitialized';
         this._listeners = {};
-        this._logger = new EventLogger_1.EventLogger(sdkKey, this.emit.bind(this), network, options);
-        this._sdkKey = sdkKey;
-        this._errorBoundary = new ErrorBoundary_1.ErrorBoundary(sdkKey);
+        Log_1.Log.level = (_a = options === null || options === void 0 ? void 0 : options.logLevel) !== null && _a !== void 0 ? _a : Log_1.LogLevel.Warn;
+        this._logger = new EventLogger_1.EventLogger(_sdkKey, this.emit.bind(this), network, options);
+        this._errorBoundary = new ErrorBoundary_1.ErrorBoundary(_sdkKey);
         if (options === null || options === void 0 ? void 0 : options.overrideStableID) {
-            StableID_1.StableID.setOverride(options.overrideStableID, sdkKey);
+            StableID_1.StableID.setOverride(options.overrideStableID, _sdkKey);
         }
         __STATSIG__ = __STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {};
-        var instances = (_a = __STATSIG__.instances) !== null && _a !== void 0 ? _a : new Set();
+        var instances = (_b = __STATSIG__.instances) !== null && _b !== void 0 ? _b : new Set();
         instances.add(this);
         __STATSIG__.instances = instances;
-        Log_1.Log.level = (_b = options === null || options === void 0 ? void 0 : options.logLevel) !== null && _b !== void 0 ? _b : Log_1.LogLevel.Warn;
-        this._dataProviders = dataProviders;
+        this._adapter.attach(_sdkKey, options);
     }
     StatsigClientBase.prototype.on = function (event, listener) {
         if (!this._listeners[event]) {
@@ -84,6 +42,9 @@ var StatsigClientBase = /** @class */ (function () {
             }
         }
     };
+    StatsigClientBase.prototype.getDataAdapter = function () {
+        return this._adapter;
+    };
     StatsigClientBase.prototype.emit = function (data) {
         var _a;
         if (this._listeners[data.event]) {
@@ -95,178 +56,17 @@ var StatsigClientBase = /** @class */ (function () {
         this.loadingStatus = newStatus;
         this.emit({ event: 'status_change', loadingStatus: newStatus });
     };
-    StatsigClientBase.prototype._getDataFromProviders = function (user) {
-        var _a;
-        for (var _i = 0, _b = this._dataProviders; _i < _b.length; _i++) {
-            var provider = _b[_i];
-            var data = (_a = provider.getData) === null || _a === void 0 ? void 0 : _a.call(provider, this._sdkKey, user);
-            if (data) {
-                return { data: data, source: provider.source };
-            }
-        }
-        return { data: null, source: 'NoValues' };
-    };
-    StatsigClientBase.prototype._getDataFromProvidersAsync = function (user) {
-        var _a, e_1, _b, _c;
-        var _d;
-        return __awaiter(this, void 0, void 0, function () {
-            var _e, _f, _g, provider, data, e_1_1;
-            return __generator(this, function (_h) {
-                switch (_h.label) {
-                    case 0:
-                        _h.trys.push([0, 6, 7, 12]);
-                        _e = true, _f = __asyncValues(this._dataProviders);
-                        _h.label = 1;
-                    case 1: return [4 /*yield*/, _f.next()];
-                    case 2:
-                        if (!(_g = _h.sent(), _a = _g.done, !_a)) return [3 /*break*/, 5];
-                        _c = _g.value;
-                        _e = false;
-                        provider = _c;
-                        return [4 /*yield*/, ((_d = provider.getDataAsync) === null || _d === void 0 ? void 0 : _d.call(provider, this._sdkKey, user))];
-                    case 3:
-                        data = _h.sent();
-                        if (data) {
-                            return [2 /*return*/, { data: data, source: provider.source }];
-                        }
-                        _h.label = 4;
-                    case 4:
-                        _e = true;
-                        return [3 /*break*/, 1];
-                    case 5: return [3 /*break*/, 12];
-                    case 6:
-                        e_1_1 = _h.sent();
-                        e_1 = { error: e_1_1 };
-                        return [3 /*break*/, 12];
-                    case 7:
-                        _h.trys.push([7, , 10, 11]);
-                        if (!(!_e && !_a && (_b = _f.return))) return [3 /*break*/, 9];
-                        return [4 /*yield*/, _b.call(_f)];
-                    case 8:
-                        _h.sent();
-                        _h.label = 9;
-                    case 9: return [3 /*break*/, 11];
-                    case 10:
-                        if (e_1) throw e_1.error;
-                        return [7 /*endfinally*/];
-                    case 11: return [7 /*endfinally*/];
-                    case 12: return [2 /*return*/, { data: null, source: 'NoValues' }];
-                }
-            });
-        });
-    };
-    StatsigClientBase.prototype._getDataPostInitFromProviders = function (currentData, user) {
-        var _a, e_2, _b, _c;
-        var _d;
-        return __awaiter(this, void 0, void 0, function () {
-            var _e, _f, _g, provider, data, e_2_1;
-            return __generator(this, function (_h) {
-                switch (_h.label) {
-                    case 0:
-                        _h.trys.push([0, 6, 7, 12]);
-                        _e = true, _f = __asyncValues(this._dataProviders);
-                        _h.label = 1;
-                    case 1: return [4 /*yield*/, _f.next()];
-                    case 2:
-                        if (!(_g = _h.sent(), _a = _g.done, !_a)) return [3 /*break*/, 5];
-                        _c = _g.value;
-                        _e = false;
-                        provider = _c;
-                        return [4 /*yield*/, ((_d = provider.getDataPostInit) === null || _d === void 0 ? void 0 : _d.call(provider, this._sdkKey, currentData, user))];
-                    case 3:
-                        data = _h.sent();
-                        if (data) {
-                            return [2 /*return*/, { data: data, source: provider.source }];
-                        }
-                        _h.label = 4;
-                    case 4:
-                        _e = true;
-                        return [3 /*break*/, 1];
-                    case 5: return [3 /*break*/, 12];
-                    case 6:
-                        e_2_1 = _h.sent();
-                        e_2 = { error: e_2_1 };
-                        return [3 /*break*/, 12];
-                    case 7:
-                        _h.trys.push([7, , 10, 11]);
-                        if (!(!_e && !_a && (_b = _f.return))) return [3 /*break*/, 9];
-                        return [4 /*yield*/, _b.call(_f)];
-                    case 8:
-                        _h.sent();
-                        _h.label = 9;
-                    case 9: return [3 /*break*/, 11];
-                    case 10:
-                        if (e_2) throw e_2.error;
-                        return [7 /*endfinally*/];
-                    case 11: return [7 /*endfinally*/];
-                    case 12: return [2 /*return*/, { data: null, source: 'NoValues' }];
-                }
-            });
-        });
-    };
-    StatsigClientBase.prototype._saveToDataProviders = function (currentData, user) {
-        var _this = this;
-        (function () { return __awaiter(_this, void 0, void 0, function () {
-            var latest, data, _a, _b, _c, provider, e_3_1;
-            var _d, e_3, _e, _f;
-            var _g, _h;
-            return __generator(this, function (_j) {
-                switch (_j.label) {
-                    case 0: return [4 /*yield*/, this._getDataPostInitFromProviders(currentData, user)];
-                    case 1:
-                        latest = _j.sent();
-                        data = (_g = latest.data) !== null && _g !== void 0 ? _g : currentData;
-                        if (!data) {
-                            return [2 /*return*/];
-                        }
-                        _j.label = 2;
-                    case 2:
-                        _j.trys.push([2, 8, 9, 14]);
-                        _a = true, _b = __asyncValues(this._dataProviders);
-                        _j.label = 3;
-                    case 3: return [4 /*yield*/, _b.next()];
-                    case 4:
-                        if (!(_c = _j.sent(), _d = _c.done, !_d)) return [3 /*break*/, 7];
-                        _f = _c.value;
-                        _a = false;
-                        provider = _f;
-                        return [4 /*yield*/, ((_h = provider.setDataPostInit) === null || _h === void 0 ? void 0 : _h.call(provider, this._sdkKey, data, user))];
-                    case 5:
-                        _j.sent();
-                        _j.label = 6;
-                    case 6:
-                        _a = true;
-                        return [3 /*break*/, 3];
-                    case 7: return [3 /*break*/, 14];
-                    case 8:
-                        e_3_1 = _j.sent();
-                        e_3 = { error: e_3_1 };
-                        return [3 /*break*/, 14];
-                    case 9:
-                        _j.trys.push([9, , 12, 13]);
-                        if (!(!_a && !_d && (_e = _b.return))) return [3 /*break*/, 11];
-                        return [4 /*yield*/, _e.call(_b)];
-                    case 10:
-                        _j.sent();
-                        _j.label = 11;
-                    case 11: return [3 /*break*/, 13];
-                    case 12:
-                        if (e_3) throw e_3.error;
-                        return [7 /*endfinally*/];
-                    case 13: return [7 /*endfinally*/];
-                    case 14: return [2 /*return*/];
-                }
-            });
-        }); })().catch(function (error) {
-            _this.emit({ event: 'error', error: error });
-        });
-    };
     StatsigClientBase.prototype._enqueueExposure = function (options, exposure) {
         if (options.disableExposureLog === true) {
             return;
         }
         this._logger.enqueue(exposure);
     };
+    StatsigClientBase.prototype._runPostUpdate = function (current, user) {
+        this._adapter.getDataAsync(current, user).catch(function (err) {
+            Log_1.Log.error('An error occurred after update.', err);
+        });
+    };
     return StatsigClientBase;
 }());
 exports.StatsigClientBase = StatsigClientBase;

package/src/StatsigDataAdapter.d.ts

@@ -0,0 +1,40 @@
+import { StatsigOptionsCommon } from './StatsigOptionsCommon';
+import { StatsigUser } from './StatsigUser';
+export type DataSource = 'Uninitialized' | 'Loading' | 'NoValues' | 'Cache' | 'Network' | 'NetworkNotModified' | 'Bootstrap';
+export type StatsigDataAdapterResult = {
+    readonly source: DataSource;
+    readonly data: string;
+};
+/**
+ * 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 StatsigOptions.dataAdapter}.
+ *
+ * Defaults:
+ *
+ * - {@link PrecomputedEvaluationsClient} uses {@link EvaluationsDataAdapter}
+ *
+ * - {@link OnDeviceEvaluationsClient} uses {@link SpecsDataAdapter}
+ */
+export type StatsigDataAdapter = {
+    /**
+     * Called when the StatsigDataAdapter is attached to the Statsig client instance during construction.
+     * @param {string} sdkKey The SDK key being used by the Statsig client.
+     * @param {StatsigOptionsCommon | null} options The StatsigOptions being used by the Statsig client.
+     */
+    readonly attach: (sdkKey: string, options: StatsigOptionsCommon | null) => void;
+    /**
+     * Synchronously get data for the given user (if any). Called during initializeSync and/or updateUserSync.
+     * It is also called during async update operations before StatsigDataAdapter.getDataAsync is called.
+     * @param {StatsigUser | undefined} user The StatsigUser to get data for.
+     * @returns {StatsigDataAdapterResult | null} The data that was found for the given StatsigUser.
+     */
+    readonly getDataSync: (user?: StatsigUser) => StatsigDataAdapterResult | null;
+    /**
+     * Asynchronously get data for the given user (if any). Called during initializeAsync and/or updateUserAsync.
+     * @param {StatsigUser | undefined} user The StatsigUser to get data for.
+     * @returns {StatsigDataAdapterResult | null} The data that was found for the given StatsigUser.
+     */
+    readonly getDataAsync: (current: StatsigDataAdapterResult | null, user?: StatsigUser) => Promise<StatsigDataAdapterResult | null>;
+};

package/src/StatsigMetadata.js

@@ -12,7 +12,7 @@ var __assign = (this && this.__assign) || function () {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatsigMetadataProvider = void 0;
-var SDK_VERSION = '0.0.1-beta.5';
+var SDK_VERSION = '0.0.1-beta.7';
 var metadata = {
     sdkVersion: SDK_VERSION,
     sdkType: 'js-mono', // js-mono is overwritten by Precomp and OnDevice clients

package/src/StatsigOptionsCommon.d.ts

@@ -1,5 +1,5 @@
 import { LogLevel } from './Log';
-import { StatsigDataProvider } from './StatsigDataProvider';
+import { StatsigDataAdapter } from './StatsigDataAdapter';
 /** Common options for configuring the Statsig SDK. */
 export type StatsigOptionsCommon = {
     /**
@@ -22,10 +22,10 @@ export type StatsigOptionsCommon = {
      */
     logLevel?: LogLevel;
     /**
-     * StatsigDataProvider implementors used to customize the initialization flow.
-     * Default: LocalStorageCache then Network
+     * StatsigDataAdapter implementor used to customize the initialization/update flow.
+     * Default: EvaluationsDataAdapter (Precomputed) or SpecsDataAdapter (OnDevice)
      */
-    dataProviders?: StatsigDataProvider[];
+    dataAdapter?: StatsigDataAdapter;
     /**
      * The maximum amount of time (in milliseconds) that any network request can take
      * before timing out. Default: 10,000 (10 seconds)

package/src/StatsigUser.js

@@ -16,8 +16,7 @@ function normalizeUser(original, environment) {
 }
 exports.normalizeUser = normalizeUser;
 function getUserStorageKey(sdkKey, user) {
-    var key = (0, Hashing_1.DJB2)(JSON.stringify(_getSortedObject({ sdkKey: sdkKey, user: user })));
-    return "statsig.user_cache.".concat(key);
+    return (0, Hashing_1.DJB2)(JSON.stringify(_getSortedObject({ sdkKey: sdkKey, user: user })));
 }
 exports.getUserStorageKey = getUserStorageKey;
 function _getSortedObject(object) {

package/src/index.d.ts

@@ -12,7 +12,7 @@ export * from './NetworkCore';
 export * from './StableID';
 export * from './StatsigClientBase';
 export * from './StatsigClientEventEmitter';
-export * from './StatsigDataProvider';
+export * from './StatsigDataAdapter';
 export * from './StatsigEvent';
 export * from './StatsigMetadata';
 export * from './StatsigOptionsCommon';

package/src/index.js

@@ -41,7 +41,7 @@ __exportStar(require("./NetworkCore"), exports);
 __exportStar(require("./StableID"), exports);
 __exportStar(require("./StatsigClientBase"), exports);
 __exportStar(require("./StatsigClientEventEmitter"), exports);
-__exportStar(require("./StatsigDataProvider"), exports);
+__exportStar(require("./StatsigDataAdapter"), exports);
 __exportStar(require("./StatsigEvent"), exports);
 __exportStar(require("./StatsigMetadata"), exports);
 __exportStar(require("./StatsigOptionsCommon"), exports);

package/src/StatsigDataProvider.d.ts

@@ -1,9 +0,0 @@
-import { StatsigUser } from './StatsigUser';
-export type DataSource = 'Uninitialized' | 'Loading' | 'NoValues' | 'Cache' | 'Network' | 'Bootstrap' | 'Prefetch';
-export type StatsigDataProvider = {
-    readonly getData?: (sdkKey: string, user?: StatsigUser) => string | null;
-    readonly getDataAsync?: (sdkKey: string, user?: StatsigUser) => Promise<string | null>;
-    readonly getDataPostInit?: (sdkKey: string, currentData: string | null, user?: StatsigUser) => Promise<string | null>;
-    readonly setDataPostInit?: (sdkKey: string, data: string, user?: StatsigUser) => Promise<void>;
-    readonly source: DataSource;
-};