@statsig/client-core 0.0.1-beta.1 → 0.0.1-beta.10

package/src/NetworkCore.js

@@ -1,19 +1,4 @@
 "use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
 var __assign = (this && this.__assign) || function () {
     __assign = Object.assign || function(t) {
         for (var s, i = 1, n = arguments.length; i < n; i++) {
@@ -69,33 +54,21 @@ var SessionID_1 = require("./SessionID");
 var StableID_1 = require("./StableID");
 var StatsigMetadata_1 = require("./StatsigMetadata");
 var DEFAULT_TIMEOUT_MS = 10000;
-var NetworkError = /** @class */ (function (_super) {
-    __extends(NetworkError, _super);
-    function NetworkError(message, errorDescription) {
-        var _this = _super.call(this, message) || this;
-        _this.errorDescription = errorDescription;
-        return _this;
-    }
-    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) {
         return __awaiter(this, void 0, void 0, function () {
-            var data, stableID, sessionID, body;
+            var body;
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0:
-                        data = args.data;
-                        return [4 /*yield*/, StableID_1.StableID.get(args.sdkKey)];
+                    case 0: return [4 /*yield*/, this._getPopulatedBody(args)];
                     case 1:
-                        stableID = _a.sent();
-                        sessionID = SessionID_1.SessionID.get(args.sdkKey);
-                        body = JSON.stringify(__assign(__assign({}, data), { statsigMetadata: __assign(__assign({}, StatsigMetadata_1.StatsigMetadataProvider.get()), { stableID: stableID, sessionID: sessionID }) }));
+                        body = _a.sent();
                         return [2 /*return*/, this._sendRequest(__assign({ method: 'POST', body: body }, args))];
                 }
             });
@@ -108,51 +81,68 @@ var NetworkCore = /** @class */ (function () {
             });
         });
     };
+    NetworkCore.prototype.isBeaconSupported = function () {
+        return (typeof navigator !== 'undefined' &&
+            typeof (navigator === null || navigator === void 0 ? void 0 : navigator.sendBeacon) === 'function');
+    };
     NetworkCore.prototype.beacon = function (args) {
-        var url = new URL(args.url);
-        url.searchParams.append('k', args.sdkKey);
-        return navigator.sendBeacon(url, JSON.stringify(args.data));
+        return __awaiter(this, void 0, void 0, function () {
+            var url, body;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        url = this._getPopulatedURL(args);
+                        return [4 /*yield*/, this._getPopulatedBody(args)];
+                    case 1:
+                        body = _a.sent();
+                        return [2 /*return*/, navigator.sendBeacon(url, body)];
+                }
+            });
+        });
     };
     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 method, body, retries, controller, handle, response, url, text, err, 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]);
-                        fullUrl = this._getPopulatedURL(args);
-                        return [4 /*yield*/, fetch(fullUrl, {
+                        _b.trys.push([1, 4, , 5]);
+                        url = this._getPopulatedURL(args);
+                        return [4 /*yield*/, fetch(url, {
                                 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);
+                            err = new Error("Failed to fetch: ".concat(url, " ").concat(text));
+                            err.name = 'NetworkError';
+                            throw err;
                         }
                         Diagnostics_1.Diagnostics.mark('_sendRequest:response-received', {
                             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,7 +150,8 @@ var NetworkCore = /** @class */ (function () {
                             contentLength: response === null || response === void 0 ? void 0 : response.headers.get('content-length'),
                         });
                         if (!retries || retries <= 0) {
-                            Log_1.Log.error('A networking error occured.', errorMessage);
+                            (_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, error_1);
                             return [2 /*return*/, null];
                         }
                         return [2 /*return*/, this._sendRequest(__assign(__assign({}, args), { retries: retries - 1 }))];
@@ -170,14 +161,31 @@ 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 params = __assign(__assign({}, args.params), { k: args.sdkKey, st: metadata.sdkType, sv: metadata.sdkVersion, t: String(Date.now()), sid: SessionID_1.SessionID.get(args.sdkKey) });
+        var query = Object.entries(params)
+            .map(function (_a) {
+            var key = _a[0], value = _a[1];
+            return "".concat(encodeURIComponent(key), "=").concat(encodeURIComponent(value));
+        })
+            .join('&');
+        return "".concat(args.url).concat(query ? "?".concat(query) : '');
+    };
+    NetworkCore.prototype._getPopulatedBody = function (args) {
+        return __awaiter(this, void 0, void 0, function () {
+            var data, stableID, sessionID;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        data = args.data;
+                        return [4 /*yield*/, StableID_1.StableID.get(args.sdkKey)];
+                    case 1:
+                        stableID = _a.sent();
+                        sessionID = SessionID_1.SessionID.get(args.sdkKey);
+                        return [2 /*return*/, JSON.stringify(__assign(__assign({}, data), { statsigMetadata: __assign(__assign({}, StatsigMetadata_1.StatsigMetadataProvider.get()), { stableID: stableID, sessionID: sessionID }) }))];
+                }
+            });
+        });
     };
     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(user?: StatsigUser): Promise<DataProviderResult>;
-    protected _saveToDataProviders(data: string | null, user?: StatsigUser): void;
+    protected _setStatus(newStatus: StatsigLoadingStatus, values: StatsigDataAdapterResult | null): 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.Error;
-        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]) {
@@ -91,175 +52,9 @@ var StatsigClientBase = /** @class */ (function () {
         }
         (_a = this._listeners['*']) === null || _a === void 0 ? void 0 : _a.forEach(function (listener) { return listener(data); });
     };
-    StatsigClientBase.prototype._setStatus = function (newStatus) {
+    StatsigClientBase.prototype._setStatus = function (newStatus, values) {
         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 (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, 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 (data, user) {
-        var _this = this;
-        (function () { return __awaiter(_this, void 0, void 0, function () {
-            var localResult, _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(user)];
-                    case 1:
-                        localResult = _j.sent();
-                        data = (_g = localResult.data) !== null && _g !== void 0 ? _g : data;
-                        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 });
-        });
+        this.emit({ event: 'values_updated', status: newStatus, values: values });
     };
     StatsigClientBase.prototype._enqueueExposure = function (options, exposure) {
         if (options.disableExposureLog === true) {
@@ -267,6 +62,11 @@ var StatsigClientBase = /** @class */ (function () {
         }
         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/StatsigClientEventEmitter.d.ts

@@ -1,11 +1,33 @@
+import { StatsigDataAdapterResult } from './StatsigDataAdapter';
 import { DynamicConfig, Experiment, FeatureGate, Layer } from './StatsigTypes';
-export type StatsigLoadingStatus = 'Uninitialized' | 'Loading' | 'Ready' | 'Error';
-export type StatsigClientEvent = 'status_change' | 'error' | 'logs_flushed' | 'gate_evaluation' | 'dynamic_config_evaluation' | 'experiment_evaluation' | 'layer_evaluation';
+export type StatsigLoadingStatus = 'Uninitialized' | 'Loading' | 'Ready';
+/**
+ * All the possible events emitted from a Statsig client.
+ *
+ * `values_updated` - When the Statsig clients internal values change as the result of an initialize/update operation.
+ *
+ * `error` - When an unexpected error occurs within the Statsig client.
+ *
+ * `logs_flushed` - When queued StatsigEvents are flushed to Statsig servers.
+ *
+ * `gate_evaluation` - Fired when any gate is checked from the Statsig client.
+ *
+ * `dynamic_config_evaluation` - Fired when any dyanamic config is checked from the Statsig client.
+ *
+ * `experiment_evaluation` - Fired when any experiment is checked from the Statsig client.
+ *
+ * `layer_evaluation` - Fired when any layer is checked from the Statsig client.
+ */
+export type StatsigClientEvent = 'values_updated' | 'error' | 'logs_flushed' | 'gate_evaluation' | 'dynamic_config_evaluation' | 'experiment_evaluation' | 'layer_evaluation';
+/**
+ * Type representing various events emitted by a Statsig client.
+ */
 export type StatsigClientEventData = {
     event: StatsigClientEvent;
 } | {
-    event: 'status_change';
-    loadingStatus: StatsigLoadingStatus;
+    event: 'values_updated';
+    status: StatsigLoadingStatus;
+    values: StatsigDataAdapterResult | null;
 } | {
     event: 'error';
     error: unknown;

package/src/StatsigDataAdapter.d.ts

@@ -0,0 +1,43 @@
+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;
+    readonly receivedAt: number;
+};
+export declare const DataAdapterCachePrefix = "statsig.cached";
+/**
+ * Describes a type that is used during intialize/update operations of a Statsig client.
+ *
+ * See below to find the default adapters, but know that it is possible to create your
+ * own StatsigDataAdapter and provide it via {@link StatsigOptionsCommon.dataAdapter}.
+ *
+ * Defaults:
+ *
+ * - {@link PrecomputedEvaluationsClient} uses {@link EvaluationsDataAdapter}
+ *
+ * - {@link OnDeviceEvaluationsClient} uses {@link SpecsDataAdapter}
+ */
+export type StatsigDataAdapter = {
+    readonly _setInMemoryCache: (cache: Record<string, StatsigDataAdapterResult>) => void;
+    /**
+     * 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/StatsigDataAdapter.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataAdapterCachePrefix = void 0;
+exports.DataAdapterCachePrefix = 'statsig.cached';

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;