@statsig/client-core 0.0.1-beta.4 → 0.0.1-beta.6

package/package.json

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

package/src/ClientInterfaces.d.ts

@@ -4,7 +4,7 @@ import { StatsigEvent } from './StatsigEvent';
 import { DynamicConfig, Experiment, FeatureGate, Layer } from './StatsigTypes';
 import { StatsigUser } from './StatsigUser';
 export interface StatsigClientCommonInterface extends StatsigClientEventEmitterInterface {
-    initialize(): Promise<void>;
+    initialize(): void;
     shutdown(): Promise<void>;
 }
 export interface OnDeviceEvaluationsInterface extends StatsigClientCommonInterface {
@@ -17,7 +17,7 @@ export interface OnDeviceEvaluationsInterface extends StatsigClientCommonInterfa
 }
 export interface PrecomputedEvaluationsInterface extends StatsigClientCommonInterface {
     getCurrentUser(): StatsigUser;
-    updateUser(user: StatsigUser): Promise<void>;
+    updateUser(user: StatsigUser): 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,11 +13,18 @@ export declare class EventLogger {
     private _lastExposureMap;
     private _maxQueueSize;
     private _failedLogs;
+    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 event enqueued
+     * within the quick flush window
+     */
+    private _quickFlushIfNeeded;
     private _shouldLogEvent;
     private _flushAndForget;
     private _flush;

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,6 +71,8 @@ var EventLogger = /** @class */ (function () {
         this._options = _options;
         this._queue = [];
         this._lastExposureMap = {};
+        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);
@@ -87,6 +90,7 @@ var EventLogger = /** @class */ (function () {
         }
         var _a = StatsigMetadata_1.StatsigMetadataProvider.get(), sdkType = _a.sdkType, sdkVersion = _a.sdkVersion;
         this._queue.push(__assign(__assign({}, event), { statsigMetadata: { sdkType: sdkType, sdkVersion: sdkVersion } }));
+        this._quickFlushIfNeeded();
         if (this._queue.length > this._maxQueueSize) {
             this._flushAndForget();
         }
@@ -116,6 +120,21 @@ var EventLogger = /** @class */ (function () {
             });
         });
     };
+    /**
+     * We 'Quick Flush' following the very first event enqueued
+     * within the quick flush window
+     */
+    EventLogger.prototype._quickFlushIfNeeded = function () {
+        var _this = this;
+        if (this._hasRunQuickFlush) {
+            return;
+        }
+        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;
         if (!(0, StatsigEvent_1.isExposureEvent)(event)) {
@@ -213,15 +232,15 @@ var EventLogger = /** @class */ (function () {
                             },
                             url: "".concat(api, "/rgstr"),
                             retries: 3,
-                            headers: {
-                                'Content-Type': 'application/json',
-                                'STATSIG-EVENT-COUNT': String(events.length),
+                            params: {
+                                // ec = Event Count
+                                ec: String(events.length),
                             },
                         })];
                     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

@@ -1,20 +1,27 @@
+import { StatsigClientEmitEventFunc } from './StatsigClientBase';
 import { StatsigOptionsCommon } from './StatsigOptionsCommon';
 type RequestArgs = {
     sdkKey: string;
     url: string;
     timeoutMs?: number;
     retries?: number;
+    params?: Record<string, string>;
     headers?: Record<string, string>;
 };
 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);
-    post(args: RequestArgsWithData): Promise<string | null>;
-    get(args: RequestArgs): Promise<string | null>;
+    constructor(_options: StatsigOptionsCommon | null, _emitter?: StatsigClientEmitEventFunc | undefined);
+    post(args: RequestArgsWithData): Promise<NetworkResponse | null>;
+    get(args: RequestArgs): Promise<NetworkResponse | null>;
     beacon(args: RequestArgsWithData): boolean;
     private _sendRequest;
     private _getPopulatedURL;

package/src/NetworkCore.js

@@ -79,9 +79,10 @@ var NetworkError = /** @class */ (function (_super) {
     return NetworkError;
 }(Error));
 var NetworkCore = /** @class */ (function () {
-    function NetworkCore(_options) {
+    function NetworkCore(_options, _emitter) {
         var _a;
         this._options = _options;
+        this._emitter = _emitter;
         this._timeout = (_a = _options === null || _options === void 0 ? void 0 : _options.networkTimeoutMs) !== null && _a !== void 0 ? _a : DEFAULT_TIMEOUT_MS;
     }
     NetworkCore.prototype.post = function (args) {
@@ -114,35 +115,33 @@ var NetworkCore = /** @class */ (function () {
         return navigator.sendBeacon(url, JSON.stringify(args.data));
     };
     NetworkCore.prototype._sendRequest = function (args) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
             var method, body, retries, controller, handle, response, fullUrl, text, error_1, errorMessage;
             var _this = this;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         method = args.method, body = args.body, retries = args.retries;
                         controller = new AbortController();
                         handle = setTimeout(function () { return controller.abort("Timeout of ".concat(_this._timeout, "ms expired.")); }, this._timeout);
                         response = null;
-                        _a.label = 1;
+                        _b.label = 1;
                     case 1:
-                        _a.trys.push([1, 4, , 5]);
+                        _b.trys.push([1, 4, , 5]);
                         fullUrl = this._getPopulatedURL(args);
                         return [4 /*yield*/, fetch(fullUrl, {
                                 method: method,
                                 body: body,
-                                headers: __assign({ 
-                                    // Must set this content type to bypass cors
-                                    // can override via headers if necessary (recommended for logevent)
-                                    'Content-Type': 'text/plain' }, args.headers),
+                                headers: __assign({}, args.headers),
                                 signal: controller.signal,
                             })];
                     case 2:
-                        response = _a.sent();
+                        response = _b.sent();
                         clearTimeout(handle);
                         return [4 /*yield*/, response.text()];
                     case 3:
-                        text = _a.sent();
+                        text = _b.sent();
                         if (!response.ok) {
                             throw new NetworkError('Fetch Failure', text);
                         }
@@ -150,9 +149,12 @@ 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 = _a.sent();
+                        error_1 = _b.sent();
                         errorMessage = _getErrorMessage(controller, error_1);
                         Diagnostics_1.Diagnostics.mark('_sendRequest:error', {
                             error: errorMessage,
@@ -160,6 +162,7 @@ var NetworkCore = /** @class */ (function () {
                             contentLength: response === null || response === void 0 ? void 0 : response.headers.get('content-length'),
                         });
                         if (!retries || retries <= 0) {
+                            (_a = this._emitter) === null || _a === void 0 ? void 0 : _a.call(this, { event: 'error', error: error_1 });
                             Log_1.Log.error('A networking error occured.', errorMessage);
                             return [2 /*return*/, null];
                         }
@@ -170,14 +173,20 @@ var NetworkCore = /** @class */ (function () {
         });
     };
     NetworkCore.prototype._getPopulatedURL = function (args) {
-        var statsigMetadata = StatsigMetadata_1.StatsigMetadataProvider.get();
-        var fullUrl = new URL(args.url);
-        fullUrl.searchParams.append('k', args.sdkKey);
-        fullUrl.searchParams.append('st', statsigMetadata.sdkType);
-        fullUrl.searchParams.append('sv', statsigMetadata.sdkVersion);
-        fullUrl.searchParams.append('t', String(Date.now()));
-        fullUrl.searchParams.append('sid', SessionID_1.SessionID.get(args.sdkKey));
-        return fullUrl.toString();
+        var metadata = StatsigMetadata_1.StatsigMetadataProvider.get();
+        var url = new URL(args.url);
+        url.searchParams.append('k', args.sdkKey);
+        url.searchParams.append('st', metadata.sdkType);
+        url.searchParams.append('sv', metadata.sdkVersion);
+        url.searchParams.append('t', String(Date.now()));
+        url.searchParams.append('sid', SessionID_1.SessionID.get(args.sdkKey));
+        if (args.params) {
+            Object.entries(args.params).forEach(function (_a) {
+                var k = _a[0], v = _a[1];
+                url.searchParams.append(k, v);
+            });
+        }
+        return url.toString();
     };
     return NetworkCore;
 }());

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,18 @@ 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) {
+        var _a, _b;
+        (_b = (_a = this._adapter).handlePostUpdate) === null || _b === void 0 ? void 0 : _b.call(_a, 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,27 @@
+import { StatsigOptionsCommon } from './StatsigOptionsCommon';
+import { StatsigUser } from './StatsigUser';
+export type DataSource = 'Uninitialized' | 'Loading' | 'NoValues' | 'Cache' | 'Network' | 'NetworkNotModified' | 'Bootstrap' | 'Prefetch';
+export type StatsigDataAdapterResult = {
+    readonly source: DataSource;
+    readonly data: string;
+};
+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 initialization and updates.
+     * @param {StatsigUser | undefined} user The StatsigUser to get data for.
+     * @returns {StatsigDataAdapterResult | null} The data that was found for the given StatsigUser.
+     */
+    readonly getData: (user?: StatsigUser) => StatsigDataAdapterResult | null;
+    /**
+     *
+     * @param {StatsigDataAdapterResult | null} result The values that were found and applied during initialization or update.
+     * @param {StatsigUser | undefined} user The StatsigUser object that was used.
+     */
+    readonly handlePostUpdate: (result: StatsigDataAdapterResult | null, user?: StatsigUser) => Promise<void>;
+};

package/src/StatsigEvent.d.ts

@@ -1,5 +1,4 @@
-import { DataSource } from './StatsigDataProvider';
-import { DynamicConfig, FeatureGate } from './StatsigTypes';
+import { DynamicConfig, EvaluationDetails, FeatureGate } from './StatsigTypes';
 import { StatsigUser } from './StatsigUser';
 export type SecondaryExposure = {
     gate: string;
@@ -27,5 +26,5 @@ export declare function createLayerParameterExposure(user: StatsigUser, layerNam
     undelegated_secondary_exposures?: SecondaryExposure[];
     secondary_exposures: SecondaryExposure[];
     allocated_experiment_name: string;
-    source: DataSource;
+    details: EvaluationDetails;
 }): StatsigEventInternal;

package/src/StatsigEvent.js

@@ -4,12 +4,12 @@ exports.createLayerParameterExposure = exports.createConfigExposure = exports.cr
 var CONFIG_EXPOSURE_NAME = 'statsig::config_exposure';
 var GATE_EXPOSURE_NAME = 'statsig::gate_exposure';
 var LAYER_EXPOSURE_NAME = 'statsig::layer_exposure';
-function createExposure(eventName, user, metadata, secondaryExposures) {
+function createExposure(eventName, user, details, metadata, secondaryExposures) {
     return {
         eventName: eventName,
         user: user,
         value: null,
-        metadata: metadata,
+        metadata: _addEvaluationDetailsToMetadata(details, metadata),
         secondaryExposures: secondaryExposures,
         time: Date.now(),
     };
@@ -20,19 +20,17 @@ function isExposureEvent(_a) {
 }
 exports.isExposureEvent = isExposureEvent;
 function createGateExposure(user, gate, secondaryExposures) {
-    return createExposure(GATE_EXPOSURE_NAME, user, {
+    return createExposure(GATE_EXPOSURE_NAME, user, gate.details, {
         gate: gate.name,
         gateValue: String(gate.value),
         ruleID: gate.ruleID,
-        reason: gate.source,
     }, secondaryExposures !== null && secondaryExposures !== void 0 ? secondaryExposures : []);
 }
 exports.createGateExposure = createGateExposure;
 function createConfigExposure(user, config, secondaryExposures) {
-    return createExposure(CONFIG_EXPOSURE_NAME, user, {
+    return createExposure(CONFIG_EXPOSURE_NAME, user, config.details, {
         config: config.name,
         ruleID: config.ruleID,
-        reason: config.source,
     }, secondaryExposures !== null && secondaryExposures !== void 0 ? secondaryExposures : []);
 }
 exports.createConfigExposure = createConfigExposure;
@@ -45,13 +43,22 @@ function createLayerParameterExposure(user, layerName, parameterName, spec) {
         allocatedExperiment = spec.allocated_experiment_name;
         secondaryExposures = spec.secondary_exposures;
     }
-    return createExposure(LAYER_EXPOSURE_NAME, user, {
+    return createExposure(LAYER_EXPOSURE_NAME, user, spec.details, {
         config: layerName,
         parameterName: parameterName,
         ruleID: spec.rule_id,
         allocatedExperiment: allocatedExperiment,
         isExplicitParameter: String(isExplicit),
-        reason: spec.source,
     }, secondaryExposures);
 }
 exports.createLayerParameterExposure = createLayerParameterExposure;
+function _addEvaluationDetailsToMetadata(details, metadata) {
+    metadata['reason'] = details.reason;
+    if (details.lcut) {
+        metadata['lcut'] = String(details.lcut);
+    }
+    if (details.receivedAt) {
+        metadata['receivedAt'] = String(details.receivedAt);
+    }
+    return metadata;
+}

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.4';
+var SDK_VERSION = '0.0.1-beta.6';
 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 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/StatsigTypes.d.ts

@@ -1,10 +1,15 @@
 export type Flatten<T> = {
     [K in keyof T]: T[K];
 } & {};
+export type EvaluationDetails = {
+    reason: string;
+    lcut?: number;
+    receivedAt?: number;
+};
 type EvaluatedSpec = {
     readonly name: string;
     readonly ruleID: string;
-    readonly source: string;
+    readonly details: EvaluationDetails;
 };
 export type FeatureGate = EvaluatedSpec & {
     readonly value: boolean;
@@ -16,7 +21,7 @@ export type Experiment = DynamicConfig;
 export type Layer = EvaluatedSpec & {
     readonly getValue: (parameterName: string) => unknown;
 };
-export declare function makeFeatureGate(name: string, source: string, ruleID?: string, value?: boolean): FeatureGate;
-export declare function makeDynamicConfig(name: string, source: string, ruleID?: string, value?: Record<string, unknown>): DynamicConfig;
-export declare function makeLayer(name: string, source: string, ruleID?: string, getValue?: (param: string) => unknown): Layer;
+export declare function makeFeatureGate(name: string, details: EvaluationDetails, ruleID?: string, value?: boolean): FeatureGate;
+export declare function makeDynamicConfig(name: string, details: EvaluationDetails, ruleID?: string, value?: Record<string, unknown>): DynamicConfig;
+export declare function makeLayer(name: string, details: EvaluationDetails, ruleID?: string, getValue?: (param: string) => unknown): Layer;
 export {};

package/src/StatsigTypes.js

@@ -2,28 +2,28 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeLayer = exports.makeDynamicConfig = exports.makeFeatureGate = void 0;
 var DEFAULT_RULE = 'default';
-function makeFeatureGate(name, source, ruleID, value) {
+function makeFeatureGate(name, details, ruleID, value) {
     return {
         name: name,
-        source: source,
+        details: details,
         ruleID: ruleID !== null && ruleID !== void 0 ? ruleID : DEFAULT_RULE,
         value: value === true,
     };
 }
 exports.makeFeatureGate = makeFeatureGate;
-function makeDynamicConfig(name, source, ruleID, value) {
+function makeDynamicConfig(name, details, ruleID, value) {
     return {
         name: name,
-        source: source,
+        details: details,
         ruleID: ruleID !== null && ruleID !== void 0 ? ruleID : DEFAULT_RULE,
         value: value !== null && value !== void 0 ? value : {},
     };
 }
 exports.makeDynamicConfig = makeDynamicConfig;
-function makeLayer(name, source, ruleID, getValue) {
+function makeLayer(name, details, ruleID, getValue) {
     return {
         name: name,
-        source: source,
+        details: details,
         getValue: getValue !== null && getValue !== void 0 ? getValue : (function () { return undefined; }),
         ruleID: ruleID !== null && ruleID !== void 0 ? ruleID : DEFAULT_RULE,
     };

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;
-};