@statsig/client-core 3.3.0-beta.1 → 3.3.0-beta.3

package/package.json

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

package/src/ErrorBoundary.js

@@ -69,7 +69,11 @@ class ErrorBoundary {
                 }
                 this._seen.add(name);
                 if ((_b = (_a = this._options) === null || _a === void 0 ? void 0 : _a.networkConfig) === null || _b === void 0 ? void 0 : _b.preventAllNetworkTraffic) {
-                    (_c = this._emitter) === null || _c === void 0 ? void 0 : _c.call(this, { name: 'error', error });
+                    (_c = this._emitter) === null || _c === void 0 ? void 0 : _c.call(this, {
+                        name: 'error',
+                        error,
+                        tag,
+                    });
                     return;
                 }
                 const sdkType = SDKType_1.SDKType._get(this._sdkKey);
@@ -87,7 +91,11 @@ class ErrorBoundary {
                     },
                     body,
                 });
-                (_g = this._emitter) === null || _g === void 0 ? void 0 : _g.call(this, { name: 'error', error });
+                (_g = this._emitter) === null || _g === void 0 ? void 0 : _g.call(this, {
+                    name: 'error',
+                    error,
+                    tag,
+                });
             });
             impl()
                 .then(() => {

package/src/NetworkCore.js

@@ -20,6 +20,7 @@ const SDKType_1 = require("./SDKType");
 const SafeJs_1 = require("./SafeJs");
 const SessionID_1 = require("./SessionID");
 const StableID_1 = require("./StableID");
+const StatsigClientEventEmitter_1 = require("./StatsigClientEventEmitter");
 const StatsigMetadata_1 = require("./StatsigMetadata");
 const VisibilityObserving_1 = require("./VisibilityObserving");
 const DEFAULT_TIMEOUT_MS = 10000;
@@ -134,7 +135,12 @@ class NetworkCore {
                 if (!retries ||
                     currentAttempt > retries ||
                     !RETRYABLE_CODES.has((_b = response === null || response === void 0 ? void 0 : response.status) !== null && _b !== void 0 ? _b : 500)) {
-                    (_c = this._emitter) === null || _c === void 0 ? void 0 : _c.call(this, { name: 'error', error });
+                    (_c = this._emitter) === null || _c === void 0 ? void 0 : _c.call(this, {
+                        name: 'error',
+                        error,
+                        tag: StatsigClientEventEmitter_1.ErrorTag.NetworkError,
+                        requestArgs: args,
+                    });
                     Log_1.Log.error(`A networking error occured during ${method} request to ${populatedUrl}.`, errorMessage, error);
                     return null;
                 }

package/src/NetworkFallbackResolver.d.ts

@@ -7,11 +7,13 @@ export declare class NetworkFallbackResolver {
     private _fallbackInfo;
     private _errorBoundary;
     private _networkOverrideFunc?;
+    private _cooldowns;
     constructor(options: AnyStatsigOptions);
     setErrorBoundary(errorBoundary: ErrorBoundary): void;
     tryBumpExpiryTime(sdkKey: string, url: string): void;
     getFallbackUrl(sdkKey: string, url: string): string | null;
     tryFetchUpdatedFallbackInfo(sdkKey: string, url: string, errorMessage: string | null, timedOut: boolean): Promise<boolean>;
+    private _updateFallbackInfoWithNewUrl;
     private _fetchFallbackUrl;
 }
 export declare function _isDefaultUrl(url: string): boolean;

package/src/NetworkFallbackResolver.js

@@ -15,12 +15,14 @@ const Hashing_1 = require("./Hashing");
 const Log_1 = require("./Log");
 const NetworkConfig_1 = require("./NetworkConfig");
 const StorageProvider_1 = require("./StorageProvider");
-const DEFAULT_TTL = 7 * 24 * 60 * 60 * 1000; // 7 days
+const DEFAULT_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+const COOLDOWN_TIME_MS = 4 * 60 * 60 * 1000; // 4 hours
 class NetworkFallbackResolver {
     constructor(options) {
         var _a;
         this._fallbackInfo = null;
         this._errorBoundary = null;
+        this._cooldowns = {};
         this._networkOverrideFunc = (_a = options.networkConfig) === null || _a === void 0 ? void 0 : _a.networkOverrideFunc;
     }
     setErrorBoundary(errorBoundary) {
@@ -36,7 +38,7 @@ class NetworkFallbackResolver {
         if (!info) {
             return;
         }
-        info.expiryTime = Date.now() + DEFAULT_TTL;
+        info.expiryTime = Date.now() + DEFAULT_TTL_MS;
         _tryWriteFallbackInfoToCache(sdkKey, Object.assign(Object.assign({}, this._fallbackInfo), { [domainKey]: info }));
     }
     getFallbackUrl(sdkKey, url) {
@@ -64,43 +66,52 @@ class NetworkFallbackResolver {
         return null;
     }
     tryFetchUpdatedFallbackInfo(sdkKey, url, errorMessage, timedOut) {
-        var _a, _b, _c, _d;
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const domainKey = _getDomainKeyFromEndpoint(url);
                 if (!_isDomainFailure(errorMessage, timedOut) || !domainKey) {
                     return false;
                 }
+                if (this._cooldowns[domainKey] &&
+                    Date.now() < this._cooldowns[domainKey]) {
+                    return false;
+                }
+                this._cooldowns[domainKey] = Date.now() + COOLDOWN_TIME_MS;
                 const newUrl = yield this._fetchFallbackUrl(domainKey);
                 if (!newUrl) {
                     return false;
                 }
-                const newFallbackInfo = {
-                    url: newUrl,
-                    expiryTime: Date.now() + DEFAULT_TTL,
-                    previous: [],
-                };
-                const previousInfo = (_a = this._fallbackInfo) === null || _a === void 0 ? void 0 : _a[domainKey];
-                if (previousInfo) {
-                    newFallbackInfo.previous.push(...previousInfo.previous);
-                }
-                if (newFallbackInfo.previous.length > 10) {
-                    newFallbackInfo.previous = [];
-                }
-                const previousUrl = (_c = (_b = this._fallbackInfo) === null || _b === void 0 ? void 0 : _b[domainKey]) === null || _c === void 0 ? void 0 : _c.url;
-                if (previousUrl != null) {
-                    newFallbackInfo.previous.push(previousUrl);
-                }
-                this._fallbackInfo = Object.assign(Object.assign({}, this._fallbackInfo), { [domainKey]: newFallbackInfo });
-                _tryWriteFallbackInfoToCache(sdkKey, this._fallbackInfo);
+                this._updateFallbackInfoWithNewUrl(sdkKey, domainKey, newUrl);
                 return true;
             }
             catch (error) {
-                (_d = this._errorBoundary) === null || _d === void 0 ? void 0 : _d.logError('tryFetchUpdatedFallbackInfo', error);
+                (_a = this._errorBoundary) === null || _a === void 0 ? void 0 : _a.logError('tryFetchUpdatedFallbackInfo', error);
                 return false;
             }
         });
     }
+    _updateFallbackInfoWithNewUrl(sdkKey, domainKey, newUrl) {
+        var _a, _b, _c;
+        const newFallbackInfo = {
+            url: newUrl,
+            expiryTime: Date.now() + DEFAULT_TTL_MS,
+            previous: [],
+        };
+        const previousInfo = (_a = this._fallbackInfo) === null || _a === void 0 ? void 0 : _a[domainKey];
+        if (previousInfo) {
+            newFallbackInfo.previous.push(...previousInfo.previous);
+        }
+        if (newFallbackInfo.previous.length > 10) {
+            newFallbackInfo.previous = [];
+        }
+        const previousUrl = (_c = (_b = this._fallbackInfo) === null || _b === void 0 ? void 0 : _b[domainKey]) === null || _c === void 0 ? void 0 : _c.url;
+        if (previousUrl != null) {
+            newFallbackInfo.previous.push(previousUrl);
+        }
+        this._fallbackInfo = Object.assign(Object.assign({}, this._fallbackInfo), { [domainKey]: newFallbackInfo });
+        _tryWriteFallbackInfoToCache(sdkKey, this._fallbackInfo);
+    }
     _fetchFallbackUrl(domainKey) {
         var _a, _b, _c, _d, _e, _f;
         return __awaiter(this, void 0, void 0, function* () {

package/src/StatsigClientEventEmitter.d.ts

@@ -2,15 +2,25 @@ import { DataAdapterResult } from './StatsigDataAdapter';
 import { DynamicConfig, Experiment, FeatureGate, Layer } from './StatsigTypes';
 import { Flatten } from './TypingUtils';
 export type StatsigLoadingStatus = 'Uninitialized' | 'Loading' | 'Ready';
+export declare const ErrorTag: {
+    readonly NetworkError: "NetworkError";
+};
+export type ErrorTag = (typeof ErrorTag)[keyof typeof ErrorTag];
+type ErrorEventData = {
+    error: unknown;
+    tag: ErrorTag | string;
+} | {
+    error: unknown;
+    tag: 'NetworkError';
+    requestArgs: Record<string, unknown>;
+};
 type EventNameToEventDataMap = {
     values_updated: {
         status: StatsigLoadingStatus;
         values: DataAdapterResult | null;
     };
     session_expired: object;
-    error: {
-        error: unknown;
-    };
+    error: ErrorEventData;
     logs_flushed: {
         events: Record<string, unknown>[];
     };
@@ -34,12 +44,16 @@ type EventNameToEventDataMap = {
  *
  * `values_updated` - When the Statsig clients internal values change as the result of an initialize/update operation.
  *
+ * `session_expired` - When the current session has expired.
+ *
  * `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
  *
+ * `initialization_failure` - Fired when the client fails to initialize.
+ *
  * `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.

package/src/StatsigClientEventEmitter.js

@@ -1,2 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorTag = void 0;
+exports.ErrorTag = {
+    NetworkError: 'NetworkError',
+};

package/src/StatsigMetadata.d.ts

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