@statsig/client-core 0.0.1-beta.35 → 0.0.1-beta.37

package/README.md

@@ -1,8 +1,5 @@
 # Statsig - Core
 
-> [!IMPORTANT]
-> This version of the SDK is still in beta. The non-beta version can be found [here](https://github.com/statsig-io/js-client).
-
 The package that contains all the common logic shared by the various Statsig Javascript packages.
 
 Learn more by visiting: https://docs.statsig.com/client/javascript-sdk

package/package.json

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

package/src/ClientInterfaces.d.ts

@@ -2,6 +2,7 @@ import { DownloadConfigSpecsResponse } from './DownloadConfigSpecsResponse';
 import { ErrorBoundary } from './ErrorBoundary';
 import { DynamicConfigEvaluationOptions, ExperimentEvaluationOptions, FeatureGateEvaluationOptions, LayerEvaluationOptions } from './EvaluationOptions';
 import { InitializeResponseWithUpdates } from './InitializeResponse';
+import { StatsigSession } from './SessionID';
 import { StatsigClientEventEmitterInterface } from './StatsigClientEventEmitter';
 import { EvaluationsDataAdapter, SpecsDataAdapter } from './StatsigDataAdapter';
 import { StatsigEvent } from './StatsigEvent';
@@ -22,7 +23,7 @@ export type CommonContext = {
     errorBoundary: ErrorBoundary;
 };
 export type AsyncCommonContext = {
-    sessionID: string;
+    session: StatsigSession;
     stableID: string;
 };
 export type OnDeviceEvaluationsContext = CommonContext & {

package/src/EventLogger.js

@@ -12,8 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventLogger = void 0;
 const Hashing_1 = require("./Hashing");
 const Log_1 = require("./Log");
-const NetworkDefaults_1 = require("./NetworkDefaults");
-const NetworkParams_1 = require("./NetworkParams");
+const NetworkConfig_1 = require("./NetworkConfig");
 const SafeJs_1 = require("./SafeJs");
 const StatsigEvent_1 = require("./StatsigEvent");
 const StorageProvider_1 = require("./StorageProvider");
@@ -59,8 +58,8 @@ class EventLogger {
         }, flushInterval);
         this._flushTimer = intervalId;
         const config = _options === null || _options === void 0 ? void 0 : _options.networkConfig;
-        this._logEventUrl = (0, UrlOverrides_1._getOverridableUrl)(config === null || config === void 0 ? void 0 : config.logEventUrl, config === null || config === void 0 ? void 0 : config.api, '/rgstr', NetworkDefaults_1.NetworkDefault.eventsApi);
-        this._logEventBeaconUrl = (0, UrlOverrides_1._getOverridableUrl)(config === null || config === void 0 ? void 0 : config.logEventBeaconUrl, config === null || config === void 0 ? void 0 : config.api, '/log_event_beacon', NetworkDefaults_1.NetworkDefault.eventsApi);
+        this._logEventUrl = (0, UrlOverrides_1._getOverridableUrl)(config === null || config === void 0 ? void 0 : config.logEventUrl, config === null || config === void 0 ? void 0 : config.api, '/rgstr', NetworkConfig_1.NetworkDefault.eventsApi);
+        this._logEventBeaconUrl = (0, UrlOverrides_1._getOverridableUrl)(config === null || config === void 0 ? void 0 : config.logEventBeaconUrl, config === null || config === void 0 ? void 0 : config.api, '/log_event_beacon', NetworkConfig_1.NetworkDefault.eventsApi);
         (0, VisibilityObserving_1._subscribeToVisiblityChanged)((visibility) => {
             if (visibility === 'background') {
                 _safeFlushAndForget(_sdkKey);
@@ -182,7 +181,7 @@ class EventLogger {
                 url: this._logEventUrl,
                 retries: 3,
                 params: {
-                    [NetworkParams_1.NetworkParam.EventCount]: String(events.length),
+                    [NetworkConfig_1.NetworkParam.EventCount]: String(events.length),
                 },
             });
             const response = (result === null || result === void 0 ? void 0 : result.body)

package/src/NetworkConfig.d.ts

@@ -0,0 +1,14 @@
+export declare const NetworkDefault: {
+    eventsApi: "https://prodregistryv2.org/v1";
+    initializeApi: "https://featureassets.org/v1";
+    specsApi: "https://assetsconfigcdn.org/v1";
+};
+export declare enum NetworkParam {
+    EventCount = "ec",
+    SdkKey = "k",
+    SdkType = "st",
+    SdkVersion = "sv",
+    Time = "t",
+    SessionID = "sid",
+    StatsigEncoded = "se"
+}

package/src/{NetworkParams.js → NetworkConfig.js}

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetworkParam = void 0;
+exports.NetworkParam = exports.NetworkDefault = void 0;
+exports.NetworkDefault = {
+    eventsApi: 'https://prodregistryv2.org/v1',
+    initializeApi: 'https://featureassets.org/v1',
+    specsApi: 'https://assetsconfigcdn.org/v1',
+};
 var NetworkParam;
 (function (NetworkParam) {
     NetworkParam["EventCount"] = "ec";

package/src/NetworkCore.js

@@ -13,7 +13,7 @@ exports.NetworkCore = void 0;
 require("./$_StatsigGlobal");
 const Diagnostics_1 = require("./Diagnostics");
 const Log_1 = require("./Log");
-const NetworkParams_1 = require("./NetworkParams");
+const NetworkConfig_1 = require("./NetworkConfig");
 const SDKType_1 = require("./SDKType");
 const SessionID_1 = require("./SessionID");
 const StableID_1 = require("./StableID");
@@ -96,7 +96,7 @@ class NetworkCore {
     }
     _getPopulatedURL(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            const params = Object.assign({ [NetworkParams_1.NetworkParam.SdkKey]: args.sdkKey, [NetworkParams_1.NetworkParam.SdkType]: SDKType_1.SDKType._get(args.sdkKey), [NetworkParams_1.NetworkParam.SdkVersion]: StatsigMetadata_1.SDK_VERSION, [NetworkParams_1.NetworkParam.Time]: String(Date.now()), [NetworkParams_1.NetworkParam.SessionID]: yield SessionID_1.SessionID.get(args.sdkKey) }, args.params);
+            const params = Object.assign({ [NetworkConfig_1.NetworkParam.SdkKey]: args.sdkKey, [NetworkConfig_1.NetworkParam.SdkType]: SDKType_1.SDKType._get(args.sdkKey), [NetworkConfig_1.NetworkParam.SdkVersion]: StatsigMetadata_1.SDK_VERSION, [NetworkConfig_1.NetworkParam.Time]: String(Date.now()), [NetworkConfig_1.NetworkParam.SessionID]: yield SessionID_1.SessionID.get(args.sdkKey) }, args.params);
             const query = Object.entries(params)
                 .map(([key, value]) => {
                 return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
@@ -125,7 +125,7 @@ class NetworkCore {
             !window.btoa) {
             return input;
         }
-        args.params = Object.assign(Object.assign({}, ((_b = args.params) !== null && _b !== void 0 ? _b : {})), { [NetworkParams_1.NetworkParam.StatsigEncoded]: '1' });
+        args.params = Object.assign(Object.assign({}, ((_b = args.params) !== null && _b !== void 0 ? _b : {})), { [NetworkConfig_1.NetworkParam.StatsigEncoded]: '1' });
         return (_c = window.btoa(input).split('').reverse().join('')) !== null && _c !== void 0 ? _c : input;
     }
 }

package/src/SessionID.d.ts

@@ -1,12 +1,19 @@
-type SessionState = {
-    emitFunction: () => void;
-    ageTimeoutID: ReturnType<typeof setTimeout> | null;
-    idleTimeoutID: ReturnType<typeof setTimeout> | null;
+type SessionTimeoutID = ReturnType<typeof setTimeout>;
+type SessionData = {
+    sessionID: string;
+    startTime: number;
+    lastUpdate: number;
+};
+export type StatsigSession = {
+    data: SessionData;
+    sdkKey: string;
+    ageTimeoutID?: SessionTimeoutID;
+    idleTimeoutID?: SessionTimeoutID;
 };
 export declare const SessionID: {
     get: (sdkKey: string) => Promise<string>;
-    _getPromise: (sdkKey: string) => Promise<string>;
-    _setEmitFunction: (eFunction: () => void, sdkKey: string) => void;
-    _resetTimeout: (sessionState: SessionState, timeoutID: ReturnType<typeof setTimeout> | null, duration: number) => ReturnType<typeof setTimeout> | null;
+};
+export declare const StatsigSession: {
+    get: (sdkKey: string) => Promise<StatsigSession>;
 };
 export {};

package/src/SessionID.js

@@ -9,75 +9,80 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SessionID = void 0;
+exports.StatsigSession = exports.SessionID = void 0;
 const Hashing_1 = require("./Hashing");
 const Log_1 = require("./Log");
 const StorageProvider_1 = require("./StorageProvider");
 const UUID_1 = require("./UUID");
-const SESSION_ID_MAP = {};
-const SESSION_STATE_MAP = {};
-const PROMISE_MAP = {};
 const MAX_SESSION_IDLE_TIME = 30 * 60 * 1000; // 30 minutes
 const MAX_SESSION_AGE = 4 * 60 * 60 * 1000; // 4 hours
+const PROMISE_MAP = {};
 exports.SessionID = {
-    get: (sdkKey) => {
-        if (PROMISE_MAP[sdkKey] != null) {
-            return PROMISE_MAP[sdkKey];
+    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 (PROMISE_MAP[sdkKey] = exports.SessionID._getPromise(sdkKey));
-    },
-    _getPromise: (sdkKey) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a;
-        let session = 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 (session == null) {
-            let tempSession = yield _loadFromStorage(sdkKey);
-            if (tempSession == null) {
-                tempSession = {
-                    sessionID: (0, UUID_1.getUUID)(),
-                    startTime: now,
-                    lastUpdate: now,
-                };
-            }
-            session = tempSession;
-            SESSION_ID_MAP[sdkKey] = session;
+        if (!data) {
+            data = {
+                sessionID: (0, UUID_1.getUUID)(),
+                startTime: now,
+                lastUpdate: now,
+            };
         }
-        const sessionState = (_a = SESSION_STATE_MAP[sdkKey]) !== null && _a !== void 0 ? _a : {
-            ageTimeoutID: null,
-            idleTimeoutID: null,
-            emitFunction: () => {
-                return;
-            },
+        return {
+            data,
+            sdkKey,
         };
-        if (now - session.startTime > MAX_SESSION_AGE ||
-            now - session.lastUpdate > MAX_SESSION_IDLE_TIME) {
-            session.sessionID = (0, UUID_1.getUUID)();
-            session.startTime = now;
+    });
+}
+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);
+    session.data = data;
+    clearTimeout(session.idleTimeoutID);
+    clearTimeout(session.ageTimeoutID);
+    const lifetime = now - data.startTime;
+    const sdkKey = session.sdkKey;
+    return {
+        data,
+        sdkKey,
+        // idleTimeoutID: _createSessionTimeout(sdkKey, MAX_SESSION_IDLE_TIME),
+        ageTimeoutID: _createSessionTimeout(sdkKey, MAX_SESSION_AGE - lifetime),
+    };
+}
+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' });
         }
-        session.lastUpdate = now;
-        _persistToStorage(session, sdkKey);
-        sessionState.idleTimeoutID = exports.SessionID._resetTimeout(sessionState, sessionState.idleTimeoutID, MAX_SESSION_IDLE_TIME);
-        sessionState.ageTimeoutID = exports.SessionID._resetTimeout(sessionState, sessionState.ageTimeoutID, MAX_SESSION_AGE - (now - session.startTime));
-        SESSION_ID_MAP[sdkKey] = session;
-        SESSION_STATE_MAP[sdkKey] = sessionState;
-        PROMISE_MAP[sdkKey] = null;
-        return session.sessionID;
-    }),
-    _setEmitFunction: (eFunction, sdkKey) => {
-        var _a;
-        const sessionState = (_a = SESSION_STATE_MAP[sdkKey]) !== null && _a !== void 0 ? _a : {
-            ageTimeoutID: null,
-            idleTimeoutID: null,
-            emitFunction: eFunction,
-        };
-        sessionState.emitFunction = eFunction;
-        SESSION_STATE_MAP[sdkKey] = sessionState;
-    },
-    _resetTimeout: (sessionState, timeoutID, duration) => {
-        clearTimeout(timeoutID !== null && timeoutID !== void 0 ? timeoutID : undefined);
-        return setTimeout(sessionState.emitFunction, duration);
-    },
-};
+    }, 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, Hashing_1.DJB2)(sdkKey)}`;
 }

package/src/StatsigClientBase.d.ts

@@ -59,8 +59,8 @@ export declare abstract class StatsigClientBase<TAdapter extends EvaluationsData
      * @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;
-    protected _emit(event: AnyStatsigClientEvent): 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;
 }

package/src/StatsigClientBase.js

@@ -16,7 +16,6 @@ const ErrorBoundary_1 = require("./ErrorBoundary");
 const EventLogger_1 = require("./EventLogger");
 const Log_1 = require("./Log");
 const SafeJs_1 = require("./SafeJs");
-const SessionID_1 = require("./SessionID");
 const StableID_1 = require("./StableID");
 const StorageProvider_1 = require("./StorageProvider");
 class StatsigClientBase {
@@ -24,7 +23,7 @@ class StatsigClientBase {
         var _a, _b;
         this.loadingStatus = 'Uninitialized';
         this._listeners = {};
-        const emitter = this._emit.bind(this);
+        const emitter = this.$emt.bind(this);
         const statsigGlobal = (0, __StatsigGlobal_1._getStatsigGlobal)();
         const instances = (_a = statsigGlobal.instances) !== null && _a !== void 0 ? _a : {};
         const inst = this;
@@ -40,9 +39,6 @@ class StatsigClientBase {
         this._options = options !== null && options !== void 0 ? options : {};
         this._overrideAdapter = (_b = options === null || options === void 0 ? void 0 : options.overrideAdapter) !== null && _b !== void 0 ? _b : null;
         this._logger = new EventLogger_1.EventLogger(sdkKey, emitter, network, options);
-        SessionID_1.SessionID._setEmitFunction(() => {
-            this._emit({ name: 'session_expired' });
-        }, sdkKey);
         if (instances[sdkKey] != null && (0, SafeJs_1._isBrowserEnv)()) {
             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.');
         }
@@ -82,7 +78,7 @@ class StatsigClientBase {
      */
     shutdown() {
         return __awaiter(this, void 0, void 0, function* () {
-            this._emit({ name: 'pre_shutdown' });
+            this.$emt({ name: 'pre_shutdown' });
             yield this._logger.shutdown();
         });
     }
@@ -115,11 +111,11 @@ class StatsigClientBase {
             }
         }
     }
-    __on(event, listener) {
+    $on(event, listener) {
         listener.__isInternal = true;
         this.on(event, listener);
     }
-    _emit(event) {
+    $emt(event) {
         var _a;
         const barrier = (listener) => {
             try {
@@ -127,7 +123,7 @@ class StatsigClientBase {
             }
             catch (error) {
                 if (listener.__isInternal === true) {
-                    this._errorBoundary.logError(`_emit:${event.name}`, error);
+                    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);
@@ -140,7 +136,7 @@ class StatsigClientBase {
     }
     _setStatus(newStatus, values) {
         this.loadingStatus = newStatus;
-        this._emit({ name: 'values_updated', status: newStatus, values });
+        this.$emt({ name: 'values_updated', status: newStatus, values });
     }
     _enqueueExposure(name, exposure, options) {
         if ((options === null || options === void 0 ? void 0 : options.disableExposureLog) === true) {

package/src/StatsigClientEventEmitter.d.ts

@@ -65,6 +65,10 @@ export interface StatsigClientEventEmitterInterface {
     /**
      * (Statsig Use Only) - Same as .on() but logs errors to sdk_exception
      */
-    __on<T extends StatsigClientEventName>(event: T, listener: StatsigClientEventCallback<T>): void;
+    $on<T extends StatsigClientEventName>(event: T, listener: StatsigClientEventCallback<T>): void;
+    /**
+     * (Statsig Use Only) - Emit StatsigClientEvents
+     */
+    $emt(event: AnyStatsigClientEvent): void;
 }
 export {};

package/src/StatsigMetadata.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "0.0.1-beta.35";
+export declare const SDK_VERSION = "0.0.1-beta.37";
 export type StatsigMetadata = {
     readonly [key: string]: string | undefined;
     readonly appVersion?: string;

package/src/StatsigMetadata.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatsigMetadataProvider = exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '0.0.1-beta.35';
+exports.SDK_VERSION = '0.0.1-beta.37';
 let metadata = {
     sdkVersion: exports.SDK_VERSION,
     sdkType: 'js-mono', // js-mono is overwritten by Precomp and OnDevice clients

package/src/index.d.ts

@@ -13,9 +13,8 @@ export * from './EvaluationTypes';
 export * from './Hashing';
 export * from './InitializeResponse';
 export * from './Log';
-export * from './NetworkParams';
 export * from './NetworkCore';
-export * from './NetworkDefaults';
+export * from './NetworkConfig';
 export * from './OverrideAdapter';
 export * from './SafeJs';
 export * from './SDKType';

package/src/index.js

@@ -35,9 +35,8 @@ __exportStar(require("./EvaluationTypes"), exports);
 __exportStar(require("./Hashing"), exports);
 __exportStar(require("./InitializeResponse"), exports);
 __exportStar(require("./Log"), exports);
-__exportStar(require("./NetworkParams"), exports);
 __exportStar(require("./NetworkCore"), exports);
-__exportStar(require("./NetworkDefaults"), exports);
+__exportStar(require("./NetworkConfig"), exports);
 __exportStar(require("./OverrideAdapter"), exports);
 __exportStar(require("./SafeJs"), exports);
 __exportStar(require("./SDKType"), exports);

package/src/NetworkDefaults.d.ts

@@ -1,5 +0,0 @@
-export declare const NetworkDefault: {
-    eventsApi: "https://events.statsigapi.net/v1";
-    initializeApi: "https://featuregates.org/v1";
-    specsApi: "https://api.statsigcdn.com/v1";
-};

package/src/NetworkDefaults.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetworkDefault = void 0;
-exports.NetworkDefault = {
-    eventsApi: 'https://events.statsigapi.net/v1',
-    initializeApi: 'https://featuregates.org/v1',
-    specsApi: 'https://api.statsigcdn.com/v1',
-};

package/src/NetworkParams.d.ts

@@ -1,9 +0,0 @@
-export declare enum NetworkParam {
-    EventCount = "ec",
-    SdkKey = "k",
-    SdkType = "st",
-    SdkVersion = "sv",
-    Time = "t",
-    SessionID = "sid",
-    StatsigEncoded = "se"
-}