@statsig/client-core 0.0.1-beta.9 → 1.0.0

package/src/SessionID.js

@@ -1,13 +1,94 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionID = void 0;
-var UUID_1 = require("./UUID");
-var SESSION_ID_MAP = {};
+exports.StatsigSession = exports.SessionID = void 0;
+const CacheKey_1 = require("./CacheKey");
+const Log_1 = require("./Log");
+const StorageProvider_1 = require("./StorageProvider");
+const UUID_1 = require("./UUID");
+const MAX_SESSION_IDLE_TIME = 30 * 60 * 1000; // 30 minutes
+const MAX_SESSION_AGE = 4 * 60 * 60 * 1000; // 4 hours
+const PROMISE_MAP = {};
 exports.SessionID = {
-    get: function (sdkKey) {
-        if (SESSION_ID_MAP[sdkKey] == null) {
-            SESSION_ID_MAP[sdkKey] = (0, UUID_1.getUUID)();
+    get: (sdkKey) => __awaiter(void 0, void 0, void 0, function* () {
+        return exports.StatsigSession.get(sdkKey).then((x) => x.data.sessionID);
+    }),
+};
+exports.StatsigSession = {
+    get: (sdkKey) => __awaiter(void 0, void 0, void 0, function* () {
+        if (PROMISE_MAP[sdkKey] == null) {
+            PROMISE_MAP[sdkKey] = _loadSession(sdkKey);
         }
-        return SESSION_ID_MAP[sdkKey];
-    },
+        const session = yield PROMISE_MAP[sdkKey];
+        return _bumpSession(session);
+    }),
 };
+function _loadSession(sdkKey) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let data = yield _loadFromStorage(sdkKey);
+        const now = Date.now();
+        if (!data) {
+            data = {
+                sessionID: (0, UUID_1.getUUID)(),
+                startTime: now,
+                lastUpdate: now,
+            };
+        }
+        return {
+            data,
+            sdkKey,
+        };
+    });
+}
+function _bumpSession(session) {
+    const now = Date.now();
+    const data = session.data;
+    if (_isIdle(data) || _hasRunTooLong(data)) {
+        data.sessionID = (0, UUID_1.getUUID)();
+        data.startTime = now;
+    }
+    data.lastUpdate = now;
+    _persistToStorage(data, session.sdkKey);
+    clearTimeout(session.idleTimeoutID);
+    clearTimeout(session.ageTimeoutID);
+    const lifetime = now - data.startTime;
+    const sdkKey = session.sdkKey;
+    session.idleTimeoutID = _createSessionTimeout(sdkKey, MAX_SESSION_IDLE_TIME);
+    session.ageTimeoutID = _createSessionTimeout(sdkKey, MAX_SESSION_AGE - lifetime);
+    return session;
+}
+function _createSessionTimeout(sdkKey, duration) {
+    return setTimeout(() => {
+        const client = __STATSIG__ === null || __STATSIG__ === void 0 ? void 0 : __STATSIG__.instance(sdkKey);
+        if (client) {
+            client.$emt({ name: 'session_expired' });
+        }
+    }, duration);
+}
+function _isIdle({ lastUpdate }) {
+    return Date.now() - lastUpdate > MAX_SESSION_IDLE_TIME;
+}
+function _hasRunTooLong({ startTime }) {
+    return Date.now() - startTime > MAX_SESSION_AGE;
+}
+function _getSessionIDStorageKey(sdkKey) {
+    return `statsig.session_id.${(0, CacheKey_1._getStorageKey)(sdkKey)}`;
+}
+function _persistToStorage(session, sdkKey) {
+    const storageKey = _getSessionIDStorageKey(sdkKey);
+    (0, StorageProvider_1._setObjectInStorage)(storageKey, session).catch(() => {
+        Log_1.Log.warn('Failed to save SessionID');
+    });
+}
+function _loadFromStorage(sdkKey) {
+    const storageKey = _getSessionIDStorageKey(sdkKey);
+    return (0, StorageProvider_1._getObjectFromStorage)(storageKey);
+}

package/src/StableID.js

@@ -8,71 +8,42 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         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 };
-    }
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StableID = void 0;
-var Hashing_1 = require("./Hashing");
-var Log_1 = require("./Log");
-var StorageProvider_1 = require("./StorageProvider");
-var UUID_1 = require("./UUID");
-var PROMISE_MAP = {};
+const CacheKey_1 = require("./CacheKey");
+const Log_1 = require("./Log");
+const StorageProvider_1 = require("./StorageProvider");
+const UUID_1 = require("./UUID");
+const PROMISE_MAP = {};
 exports.StableID = {
-    get: function (sdkKey) { return __awaiter(void 0, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            if (PROMISE_MAP[sdkKey] == null) {
-                PROMISE_MAP[sdkKey] = _loadFromStorage(sdkKey).then(function (stableID) {
-                    if (stableID != null) {
-                        return stableID;
-                    }
-                    var newStableID = (0, UUID_1.getUUID)();
-                    _persistToStorage(newStableID, sdkKey);
-                    return newStableID;
-                });
-            }
-            return [2 /*return*/, PROMISE_MAP[sdkKey]];
-        });
-    }); },
-    setOverride: function (override, sdkKey) {
+    get: (sdkKey) => __awaiter(void 0, void 0, void 0, function* () {
+        if (PROMISE_MAP[sdkKey] == null) {
+            PROMISE_MAP[sdkKey] = _loadFromStorage(sdkKey).then((stableID) => {
+                if (stableID != null) {
+                    return stableID;
+                }
+                const newStableID = (0, UUID_1.getUUID)();
+                _persistToStorage(newStableID, sdkKey);
+                return newStableID;
+            });
+        }
+        return PROMISE_MAP[sdkKey];
+    }),
+    setOverride: (override, sdkKey) => {
         PROMISE_MAP[sdkKey] = Promise.resolve(override);
         _persistToStorage(override, sdkKey);
     },
 };
 function _getStableIDStorageKey(sdkKey) {
-    return "statsig.stable_id.".concat((0, Hashing_1.DJB2)(sdkKey));
+    return `statsig.stable_id.${(0, CacheKey_1._getStorageKey)(sdkKey)}`;
 }
 function _persistToStorage(stableID, sdkKey) {
-    var storageKey = _getStableIDStorageKey(sdkKey);
-    (0, StorageProvider_1.setObjectInStorage)(storageKey, stableID).catch(function () {
+    const storageKey = _getStableIDStorageKey(sdkKey);
+    (0, StorageProvider_1._setObjectInStorage)(storageKey, stableID).catch(() => {
         Log_1.Log.warn('Failed to save StableID');
     });
 }
 function _loadFromStorage(sdkKey) {
-    var storageKey = _getStableIDStorageKey(sdkKey);
-    return (0, StorageProvider_1.getObjectFromStorage)(storageKey);
+    const storageKey = _getStableIDStorageKey(sdkKey);
+    return (0, StorageProvider_1._getObjectFromStorage)(storageKey);
 }

package/src/StatsigClientBase.d.ts

@@ -1,30 +1,67 @@
 import './$_StatsigGlobal';
 import { ErrorBoundary } from './ErrorBoundary';
+import { EvaluationOptionsCommon } from './EvaluationOptions';
 import { EventLogger } from './EventLogger';
 import { NetworkCore } from './NetworkCore';
-import { StatsigClientEvent, StatsigClientEventCallback, StatsigClientEventData, StatsigClientEventEmitterInterface, StatsigLoadingStatus } from './StatsigClientEventEmitter';
-import { StatsigDataAdapter, StatsigDataAdapterResult } from './StatsigDataAdapter';
+import { OverrideAdapter } from './OverrideAdapter';
+import { AnyStatsigClientEvent, StatsigClientEventCallback, StatsigClientEventEmitterInterface, StatsigClientEventName, StatsigLoadingStatus } from './StatsigClientEventEmitter';
+import { DataAdapterResult, EvaluationsDataAdapter, SpecsDataAdapter } from './StatsigDataAdapter';
 import { StatsigEventInternal } from './StatsigEvent';
-import { StatsigOptionsCommon } from './StatsigOptionsCommon';
-import { StatsigUser } from './StatsigUser';
-export type EvaluationOptions = {
-    disableExposureLog?: boolean;
+import { AnyStatsigOptions, StatsigRuntimeMutableOptions } from './StatsigOptionsCommon';
+export type StatsigClientEmitEventFunc = (event: AnyStatsigClientEvent) => void;
+export type StatsigContext = {
+    sdkKey: string;
+    options: AnyStatsigOptions;
+    sessionID: string;
+    values: unknown;
 };
-export declare const DEFAULT_EVAL_OPTIONS: EvaluationOptions;
-export type StatsigClientEmitEventFunc = (data: StatsigClientEventData) => void;
-export declare abstract class StatsigClientBase implements StatsigClientEventEmitterInterface {
-    protected readonly _sdkKey: string;
-    protected readonly _adapter: StatsigDataAdapter;
+export declare abstract class StatsigClientBase<TAdapter extends EvaluationsDataAdapter | SpecsDataAdapter> implements StatsigClientEventEmitterInterface {
     loadingStatus: StatsigLoadingStatus;
+    readonly dataAdapter: TAdapter;
+    protected readonly _sdkKey: string;
+    protected readonly _options: AnyStatsigOptions;
     protected readonly _errorBoundary: ErrorBoundary;
     protected readonly _logger: EventLogger;
+    protected readonly _overrideAdapter: OverrideAdapter | null;
     private _listeners;
-    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 _enqueueExposure(options: EvaluationOptions, exposure: StatsigEventInternal): void;
-    protected _runPostUpdate(current: StatsigDataAdapterResult | null, user?: StatsigUser): void;
+    constructor(sdkKey: string, adapter: TAdapter, network: NetworkCore, options: AnyStatsigOptions | null);
+    /**
+     * Updates runtime configuration options for the SDK, allowing toggling of certain behaviors such as logging and storage to comply with user preferences or regulations such as GDPR.
+     *
+     * @param {StatsigRuntimeMutableOptions} options - The configuration options that dictate the runtime behavior of the SDK.
+     */
+    updateRuntimeOptions(options: StatsigRuntimeMutableOptions): void;
+    /**
+     * Flushes any currently queued events.
+     */
+    flush(): Promise<void>;
+    /**
+     * Gracefully shuts down the SDK, ensuring that all pending events are send before the SDK stops.
+     * This function emits a 'pre_shutdown' event and then waits for the logger to complete its shutdown process.
+     *
+     * @returns {Promise<void>} A promise that resolves when all shutdown procedures, including logging shutdown, have been completed.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Subscribes a callback function to a specific {@link StatsigClientEvent} or all StatsigClientEvents if the wildcard '*' is used.
+     * Once subscribed, the listener callback will be invoked whenever the specified event is emitted.
+     *
+     * @param {StatsigClientEventName} event - The name of the event to subscribe to, or '*' to subscribe to all events.
+     * @param {StatsigClientEventCallback<T>} listener - The callback function to execute when the event occurs. The function receives event-specific data as its parameter.
+     * @see {@link off} for unsubscribing from events.
+     */
+    on<T extends StatsigClientEventName>(event: T, listener: StatsigClientEventCallback<T>): void;
+    /**
+     * Unsubscribes a previously registered callback function from a specific {@link StatsigClientEvent} or all StatsigClientEvents if the wildcard '*' is used.
+     *
+     * @param {StatsigClientEventName} event - The name of the event from which to unsubscribe, or '*' to unsubscribe from all events.
+     * @param {StatsigClientEventCallback<T>} listener - The callback function to remove from the event's notification list.
+     * @see {@link on} for subscribing to events.
+     */
+    off<T extends StatsigClientEventName>(event: T, listener: StatsigClientEventCallback<T>): void;
+    $on<T extends StatsigClientEventName>(event: T, listener: StatsigClientEventCallback<T>): void;
+    $emt(event: AnyStatsigClientEvent): void;
+    protected _setStatus(newStatus: StatsigLoadingStatus, values: DataAdapterResult | null): void;
+    protected _enqueueExposure(name: string, exposure: StatsigEventInternal, options?: EvaluationOptionsCommon): void;
+    protected abstract _primeReadyRipcord(): void;
 }

package/src/StatsigClientBase.js

@@ -1,72 +1,150 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StatsigClientBase = exports.DEFAULT_EVAL_OPTIONS = void 0;
+exports.StatsigClientBase = void 0;
 require("./$_StatsigGlobal");
-var ErrorBoundary_1 = require("./ErrorBoundary");
-var EventLogger_1 = require("./EventLogger");
-var Log_1 = require("./Log");
-var StableID_1 = require("./StableID");
-exports.DEFAULT_EVAL_OPTIONS = {
-    disableExposureLog: false,
-};
-var StatsigClientBase = /** @class */ (function () {
-    function StatsigClientBase(_sdkKey, _adapter, network, options) {
+const __StatsigGlobal_1 = require("./$_StatsigGlobal");
+const ErrorBoundary_1 = require("./ErrorBoundary");
+const EventLogger_1 = require("./EventLogger");
+const Log_1 = require("./Log");
+const SafeJs_1 = require("./SafeJs");
+const StorageProvider_1 = require("./StorageProvider");
+class StatsigClientBase {
+    constructor(sdkKey, adapter, network, options) {
         var _a, _b;
-        this._sdkKey = _sdkKey;
-        this._adapter = _adapter;
         this.loadingStatus = 'Uninitialized';
         this._listeners = {};
-        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);
+        const emitter = this.$emt.bind(this);
+        (options === null || options === void 0 ? void 0 : options.logLevel) != null && (Log_1.Log.level = options.logLevel);
+        (options === null || options === void 0 ? void 0 : options.disableStorage) && StorageProvider_1.Storage._setDisabled(true);
+        this._sdkKey = sdkKey;
+        this._options = options !== null && options !== void 0 ? options : {};
+        this._overrideAdapter = (_a = options === null || options === void 0 ? void 0 : options.overrideAdapter) !== null && _a !== void 0 ? _a : null;
+        this._logger = new EventLogger_1.EventLogger(sdkKey, emitter, network, options);
+        this._errorBoundary = new ErrorBoundary_1.ErrorBoundary(sdkKey, options, emitter);
+        this._errorBoundary.wrap(this);
+        this._errorBoundary.wrap(network);
+        this._errorBoundary.wrap(adapter);
+        this._errorBoundary.wrap(this._logger);
+        if ((0, SafeJs_1._isBrowserEnv)()) {
+            const statsigGlobal = (0, __StatsigGlobal_1._getStatsigGlobal)();
+            const instances = (_b = statsigGlobal.instances) !== null && _b !== void 0 ? _b : {};
+            const inst = this;
+            if (instances[sdkKey] != null) {
+                Log_1.Log.warn('Creating multiple Statsig clients with the same SDK key can lead to unexpected behavior. Multi-instance support requires different SDK keys.');
+            }
+            instances[sdkKey] = inst;
+            statsigGlobal.lastInstance = inst;
+            statsigGlobal.instances = instances;
+            __STATSIG__ = statsigGlobal;
+        }
+        this.dataAdapter = adapter;
+        this.dataAdapter.attach(sdkKey, options);
+        this._primeReadyRipcord();
+    }
+    /**
+     * Updates runtime configuration options for the SDK, allowing toggling of certain behaviors such as logging and storage to comply with user preferences or regulations such as GDPR.
+     *
+     * @param {StatsigRuntimeMutableOptions} options - The configuration options that dictate the runtime behavior of the SDK.
+     */
+    updateRuntimeOptions(options) {
+        if (options.disableLogging != null) {
+            this._options.disableLogging = options.disableLogging;
+            this._logger.setLoggingDisabled(options.disableLogging);
         }
-        __STATSIG__ = __STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {};
-        var instances = (_b = __STATSIG__.instances) !== null && _b !== void 0 ? _b : new Set();
-        instances.add(this);
-        __STATSIG__.instances = instances;
-        this._adapter.attach(_sdkKey, options);
+        if (options.disableStorage != null) {
+            this._options.disableStorage = options.disableStorage;
+            StorageProvider_1.Storage._setDisabled(options.disableStorage);
+        }
+    }
+    /**
+     * Flushes any currently queued events.
+     */
+    flush() {
+        return this._logger.flush();
+    }
+    /**
+     * Gracefully shuts down the SDK, ensuring that all pending events are send before the SDK stops.
+     * This function emits a 'pre_shutdown' event and then waits for the logger to complete its shutdown process.
+     *
+     * @returns {Promise<void>} A promise that resolves when all shutdown procedures, including logging shutdown, have been completed.
+     */
+    shutdown() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.$emt({ name: 'pre_shutdown' });
+            yield this._logger.shutdown();
+        });
     }
-    StatsigClientBase.prototype.on = function (event, listener) {
+    /**
+     * Subscribes a callback function to a specific {@link StatsigClientEvent} or all StatsigClientEvents if the wildcard '*' is used.
+     * Once subscribed, the listener callback will be invoked whenever the specified event is emitted.
+     *
+     * @param {StatsigClientEventName} event - The name of the event to subscribe to, or '*' to subscribe to all events.
+     * @param {StatsigClientEventCallback<T>} listener - The callback function to execute when the event occurs. The function receives event-specific data as its parameter.
+     * @see {@link off} for unsubscribing from events.
+     */
+    on(event, listener) {
         if (!this._listeners[event]) {
             this._listeners[event] = [];
         }
         this._listeners[event].push(listener);
-    };
-    StatsigClientBase.prototype.off = function (event, listener) {
+    }
+    /**
+     * Unsubscribes a previously registered callback function from a specific {@link StatsigClientEvent} or all StatsigClientEvents if the wildcard '*' is used.
+     *
+     * @param {StatsigClientEventName} event - The name of the event from which to unsubscribe, or '*' to unsubscribe from all events.
+     * @param {StatsigClientEventCallback<T>} listener - The callback function to remove from the event's notification list.
+     * @see {@link on} for subscribing to events.
+     */
+    off(event, listener) {
         if (this._listeners[event]) {
-            var index = this._listeners[event].indexOf(listener);
+            const index = this._listeners[event].indexOf(listener);
             if (index !== -1) {
                 this._listeners[event].splice(index, 1);
             }
         }
-    };
-    StatsigClientBase.prototype.getDataAdapter = function () {
-        return this._adapter;
-    };
-    StatsigClientBase.prototype.emit = function (data) {
+    }
+    $on(event, listener) {
+        listener.__isInternal = true;
+        this.on(event, listener);
+    }
+    $emt(event) {
         var _a;
-        if (this._listeners[data.event]) {
-            this._listeners[data.event].forEach(function (listener) { return listener(data); });
+        const barrier = (listener) => {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                if (listener.__isInternal === true) {
+                    this._errorBoundary.logError(`__emit:${event.name}`, error);
+                    return;
+                }
+                Log_1.Log.error(`An error occurred in a StatsigClientEvent listener. This is not an issue with Statsig.`, event);
+            }
+        };
+        if (this._listeners[event.name]) {
+            this._listeners[event.name].forEach((l) => barrier(l));
         }
-        (_a = this._listeners['*']) === null || _a === void 0 ? void 0 : _a.forEach(function (listener) { return listener(data); });
-    };
-    StatsigClientBase.prototype._setStatus = function (newStatus) {
+        (_a = this._listeners['*']) === null || _a === void 0 ? void 0 : _a.forEach(barrier);
+    }
+    _setStatus(newStatus, values) {
         this.loadingStatus = newStatus;
-        this.emit({ event: 'status_change', loadingStatus: newStatus });
-    };
-    StatsigClientBase.prototype._enqueueExposure = function (options, exposure) {
-        if (options.disableExposureLog === true) {
+        this.$emt({ name: 'values_updated', status: newStatus, values });
+    }
+    _enqueueExposure(name, exposure, options) {
+        if ((options === null || options === void 0 ? void 0 : options.disableExposureLog) === true) {
+            this._logger.incrementNonExposureCount(name);
             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/StatsigClientEventEmitter.d.ts

@@ -1,14 +1,44 @@
+import { DataAdapterResult } from './StatsigDataAdapter';
 import { DynamicConfig, Experiment, FeatureGate, Layer } from './StatsigTypes';
+import { Flatten } from './UtitlityTypes';
 export type StatsigLoadingStatus = 'Uninitialized' | 'Loading' | 'Ready';
+type EventNameToEventDataMap = {
+    values_updated: {
+        status: StatsigLoadingStatus;
+        values: DataAdapterResult | null;
+    };
+    session_expired: object;
+    error: {
+        error: unknown;
+    };
+    logs_flushed: {
+        events: Record<string, unknown>[];
+    };
+    pre_shutdown: object;
+    gate_evaluation: {
+        gate: FeatureGate;
+    };
+    dynamic_config_evaluation: {
+        dynamicConfig: DynamicConfig;
+    };
+    experiment_evaluation: {
+        experiment: Experiment;
+    };
+    layer_evaluation: {
+        layer: Layer;
+    };
+};
 /**
- * All the possible events emitted from a Statsig client.
+ * Type representing various events emitted by a Statsig client.
  *
- * `status_change` - When the Statsig clients internal values change as the result of an initialize/update operation.
+ * `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.
  *
+ * `pre_shutdown` - Fired just before the SDK is shutdown
+ *
  * `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.
@@ -17,37 +47,28 @@ export type StatsigLoadingStatus = 'Uninitialized' | 'Loading' | 'Ready';
  *
  * `layer_evaluation` - Fired when any layer is checked from the Statsig client.
  */
-export type StatsigClientEvent = 'status_change' | '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: 'error';
-    error: unknown;
-} | {
-    event: 'logs_flushed';
-    events: Record<string, unknown>[];
-} | {
-    event: 'gate_evaluation';
-    gate: FeatureGate;
-} | {
-    event: 'dynamic_config_evaluation';
-    dynamicConfig: DynamicConfig;
-} | {
-    event: 'experiment_evaluation';
-    experiment: Experiment;
-} | {
-    event: 'layer_evaluation';
-    layer: Layer;
-};
-export type StatsigClientEventCallback = (data: StatsigClientEventData) => void;
+export type AnyStatsigClientEvent = Flatten<{
+    [K in keyof EventNameToEventDataMap]: {
+        name: K;
+    } & EventNameToEventDataMap[K];
+}[keyof EventNameToEventDataMap]>;
+export type StatsigClientEvent<T> = Extract<AnyStatsigClientEvent, {
+    name: T;
+}>;
+export type AnyStatsigClientEventListener = StatsigClientEventCallback<StatsigClientEventName>;
+export type StatsigClientEventName = AnyStatsigClientEvent['name'] | '*';
+export type StatsigClientEventCallback<T extends StatsigClientEventName> = (event: T extends '*' ? AnyStatsigClientEvent : StatsigClientEvent<T>) => void;
 export interface StatsigClientEventEmitterInterface {
     readonly loadingStatus: StatsigLoadingStatus;
-    on(event: StatsigClientEvent, listener: StatsigClientEventCallback): void;
-    off(event: StatsigClientEvent, listener: StatsigClientEventCallback): void;
+    on<T extends StatsigClientEventName>(event: T, listener: StatsigClientEventCallback<T>): void;
+    off<T extends StatsigClientEventName>(event: T, listener: StatsigClientEventCallback<T>): void;
+    /**
+     * (Statsig Use Only) - Same as .on() but logs errors to sdk_exception
+     */
+    $on<T extends StatsigClientEventName>(event: T, listener: StatsigClientEventCallback<T>): void;
+    /**
+     * (Statsig Use Only) - Emit StatsigClientEvents
+     */
+    $emt(event: AnyStatsigClientEvent): void;
 }
+export {};