@statsig/client-core 3.1.0 → 3.2.0

package/package.json

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

package/src/EventLogger.js

@@ -26,11 +26,10 @@ const DEDUPER_WINDOW_DURATION_MS = 60000;
 const MAX_FAILED_LOGS = 500;
 const QUICK_FLUSH_WINDOW_MS = 200;
 const EVENT_LOGGER_MAP = {};
-var RetryFailedLogsTrigger;
-(function (RetryFailedLogsTrigger) {
-    RetryFailedLogsTrigger[RetryFailedLogsTrigger["Startup"] = 0] = "Startup";
-    RetryFailedLogsTrigger[RetryFailedLogsTrigger["GainedFocus"] = 1] = "GainedFocus";
-})(RetryFailedLogsTrigger || (RetryFailedLogsTrigger = {}));
+const RetryFailedLogsTrigger = {
+    Startup: 'startup',
+    GainedFocus: 'gained_focus',
+};
 class EventLogger {
     static _safeFlushAndForget(sdkKey) {
         var _a;
@@ -101,6 +100,7 @@ class EventLogger {
                 clearInterval(this._flushIntervalId);
                 this._flushIntervalId = null;
             }
+            delete EVENT_LOGGER_MAP[this._sdkKey];
             yield this.flush();
         });
     }
@@ -165,8 +165,8 @@ class EventLogger {
                 return false;
             }
             try {
-                const isInBackground = !(0, VisibilityObserving_1._isCurrentlyVisible)();
-                const shouldUseBeacon = isInBackground &&
+                const isClosing = (0, VisibilityObserving_1._isUnloading)();
+                const shouldUseBeacon = isClosing &&
                     this._network.isBeaconSupported() &&
                     ((_b = (_a = this._options) === null || _a === void 0 ? void 0 : _a.networkConfig) === null || _b === void 0 ? void 0 : _b.networkOverrideFunc) == null;
                 const response = shouldUseBeacon

package/src/Log.d.ts

@@ -1,10 +1,11 @@
-export declare enum LogLevel {
-    None = 0,
-    Error = 1,
-    Warn = 2,
-    Info = 3,
-    Debug = 4
-}
+export declare const LogLevel: {
+    readonly None: 0;
+    readonly Error: 1;
+    readonly Warn: 2;
+    readonly Info: 3;
+    readonly Debug: 4;
+};
+export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
 export declare abstract class Log {
     static level: LogLevel;
     static info(...args: unknown[]): void;

package/src/Log.js

@@ -11,35 +11,34 @@ function addTag(args) {
     args.unshift('[Statsig]');
     return args; // ['[Statsig]', ...args];
 }
-var LogLevel;
-(function (LogLevel) {
-    LogLevel[LogLevel["None"] = 0] = "None";
-    LogLevel[LogLevel["Error"] = 1] = "Error";
-    LogLevel[LogLevel["Warn"] = 2] = "Warn";
-    LogLevel[LogLevel["Info"] = 3] = "Info";
-    LogLevel[LogLevel["Debug"] = 4] = "Debug";
-})(LogLevel || (exports.LogLevel = LogLevel = {}));
+exports.LogLevel = {
+    None: 0,
+    Error: 1,
+    Warn: 2,
+    Info: 3,
+    Debug: 4,
+};
 class Log {
     static info(...args) {
-        if (this.level >= LogLevel.Info) {
+        if (this.level >= exports.LogLevel.Info) {
             console.info(_INFO, ...addTag(args));
         }
     }
     static debug(...args) {
-        if (this.level >= LogLevel.Debug) {
+        if (this.level >= exports.LogLevel.Debug) {
             console.debug(DEBUG, ...addTag(args));
         }
     }
     static warn(...args) {
-        if (this.level >= LogLevel.Warn) {
+        if (this.level >= exports.LogLevel.Warn) {
             console.warn(_WARN, ...addTag(args));
         }
     }
     static error(...args) {
-        if (this.level >= LogLevel.Error) {
+        if (this.level >= exports.LogLevel.Error) {
             console.error(ERROR, ...addTag(args));
         }
     }
 }
 exports.Log = Log;
-Log.level = LogLevel.Warn;
+Log.level = exports.LogLevel.Warn;

package/src/NetworkConfig.d.ts

@@ -7,13 +7,14 @@ export type NetworkPriority = 'high' | 'low' | 'auto';
 export type NetworkArgs = RequestInit & {
     priority?: NetworkPriority;
 };
-export declare enum NetworkParam {
-    EventCount = "ec",
-    SdkKey = "k",
-    SdkType = "st",
-    SdkVersion = "sv",
-    Time = "t",
-    SessionID = "sid",
-    StatsigEncoded = "se",
-    IsGzipped = "gz"
-}
+export declare const NetworkParam: {
+    readonly EventCount: "ec";
+    readonly SdkKey: "k";
+    readonly SdkType: "st";
+    readonly SdkVersion: "sv";
+    readonly Time: "t";
+    readonly SessionID: "sid";
+    readonly StatsigEncoded: "se";
+    readonly IsGzipped: "gz";
+};
+export type NetworkParam = (typeof NetworkParam)[keyof typeof NetworkParam];

package/src/NetworkConfig.js

@@ -6,14 +6,13 @@ exports.NetworkDefault = {
     initializeApi: 'https://featureassets.org/v1',
     specsApi: 'https://assetsconfigcdn.org/v1',
 };
-var NetworkParam;
-(function (NetworkParam) {
-    NetworkParam["EventCount"] = "ec";
-    NetworkParam["SdkKey"] = "k";
-    NetworkParam["SdkType"] = "st";
-    NetworkParam["SdkVersion"] = "sv";
-    NetworkParam["Time"] = "t";
-    NetworkParam["SessionID"] = "sid";
-    NetworkParam["StatsigEncoded"] = "se";
-    NetworkParam["IsGzipped"] = "gz";
-})(NetworkParam || (exports.NetworkParam = NetworkParam = {}));
+exports.NetworkParam = {
+    EventCount: 'ec',
+    SdkKey: 'k',
+    SdkType: 'st',
+    SdkVersion: 'sv',
+    Time: 't',
+    SessionID: 'sid',
+    StatsigEncoded: 'se',
+    IsGzipped: 'gz',
+};

package/src/NetworkCore.js

@@ -132,7 +132,7 @@ class NetworkCore {
     }
     _getPopulatedURL(args) {
         return __awaiter(this, void 0, void 0, function* () {
-            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 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]: SessionID_1.SessionID.get(args.sdkKey) }, args.params);
             const query = Object.keys(params)
                 .map((key) => {
                 return `${encodeURIComponent(key)}=${encodeURIComponent(params[key])}`;

package/src/StatsigClientBase.d.ts

@@ -25,6 +25,7 @@ export declare abstract class StatsigClientBase<TAdapter extends EvaluationsData
     protected readonly _options: AnyStatsigOptions;
     protected readonly _errorBoundary: ErrorBoundary;
     protected readonly _logger: EventLogger;
+    protected _initializePromise: Promise<void> | null;
     private _listeners;
     constructor(sdkKey: string, adapter: TAdapter, network: NetworkCore, options: AnyStatsigOptions | null);
     /**

package/src/StatsigClientBase.js

@@ -20,8 +20,9 @@ const SessionID_1 = require("./SessionID");
 const StorageProvider_1 = require("./StorageProvider");
 class StatsigClientBase {
     constructor(sdkKey, adapter, network, options) {
-        var _a, _b;
+        var _a;
         this.loadingStatus = 'Uninitialized';
+        this._initializePromise = null;
         this._listeners = {};
         const emitter = this.$emt.bind(this);
         (options === null || options === void 0 ? void 0 : options.logLevel) != null && (Log_1.Log.level = options.logLevel);
@@ -38,22 +39,11 @@ class StatsigClientBase {
         this._errorBoundary.wrap(network);
         this._errorBoundary.wrap(adapter);
         this._errorBoundary.wrap(this._logger);
-        if (!(0, SafeJs_1._isServerEnv)()) {
-            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.storageProvider = StorageProvider_1.Storage;
         this._primeReadyRipcord();
+        _assignGlobalInstance(sdkKey, this);
     }
     /**
      * 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.
@@ -85,6 +75,8 @@ class StatsigClientBase {
     shutdown() {
         return __awaiter(this, void 0, void 0, function* () {
             this.$emt({ name: 'pre_shutdown' });
+            this._setStatus('Uninitialized', null);
+            this._initializePromise = null;
             yield this._logger.stop();
         });
     }
@@ -153,3 +145,19 @@ class StatsigClientBase {
     }
 }
 exports.StatsigClientBase = StatsigClientBase;
+function _assignGlobalInstance(sdkKey, client) {
+    var _a;
+    if ((0, SafeJs_1._isServerEnv)()) {
+        return;
+    }
+    const statsigGlobal = (0, __StatsigGlobal_1._getStatsigGlobal)();
+    const instances = (_a = statsigGlobal.instances) !== null && _a !== void 0 ? _a : {};
+    const inst = client;
+    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;
+}

package/src/StatsigMetadata.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "3.1.0";
+export declare const SDK_VERSION = "3.2.0";
 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 = '3.1.0';
+exports.SDK_VERSION = '3.2.0';
 let metadata = {
     sdkVersion: exports.SDK_VERSION,
     sdkType: 'js-mono', // js-mono is overwritten by Precomp and OnDevice clients

package/src/StatsigPlugin.d.ts

@@ -0,0 +1,5 @@
+import { StatsigClientInterface } from './ClientInterfaces';
+export type StatsigPlugin<T extends StatsigClientInterface> = {
+    readonly __plugin: 'session-replay' | 'auto-capture';
+    bind: (client: T) => void;
+};

package/src/StatsigPlugin.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/index.d.ts

@@ -33,6 +33,7 @@ export * from './StatsigOptionsCommon';
 export * from './StatsigTypeFactories';
 export * from './StatsigTypes';
 export * from './StatsigUser';
+export * from './StatsigPlugin';
 export * from './StorageProvider';
 export * from './TypedJsonParse';
 export * from './TypingUtils';

package/src/index.js

@@ -55,6 +55,7 @@ __exportStar(require("./StatsigOptionsCommon"), exports);
 __exportStar(require("./StatsigTypeFactories"), exports);
 __exportStar(require("./StatsigTypes"), exports);
 __exportStar(require("./StatsigUser"), exports);
+__exportStar(require("./StatsigPlugin"), exports);
 __exportStar(require("./StorageProvider"), exports);
 __exportStar(require("./TypedJsonParse"), exports);
 __exportStar(require("./TypingUtils"), exports);