@statsig/client-core 3.4.0 → 3.5.0

package/package.json

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

package/src/DownloadConfigSpecsResponse.d.ts

@@ -32,6 +32,7 @@ export type Spec = {
     hasSharedParams: boolean;
     isActive?: boolean;
     targetAppIDs?: string[];
+    version?: number;
 };
 export type DownloadConfigSpecsResponse = {
     feature_gates: Spec[];

package/src/EvaluationTypes.d.ts

@@ -7,6 +7,7 @@ type EvaluationBase<T> = {
     rule_id: string;
     secondary_exposures: SecondaryExposure[];
     value: T;
+    version?: string;
 };
 export type SecondaryExposure = {
     gate: string;
@@ -21,6 +22,7 @@ export type ExperimentEvaluation = Flatten<EvaluationBase<Record<string, unknown
     is_device_based: boolean;
     is_experiment_active?: boolean;
     is_user_in_experiment?: boolean;
+    passed?: boolean;
 }>;
 export type DynamicConfigEvaluation = ExperimentEvaluation;
 export type LayerEvaluation = Flatten<Omit<ExperimentEvaluation, 'id_type'> & {

package/src/EventLogger.d.ts

@@ -15,7 +15,7 @@ export declare class EventLogger {
     private _hasRunQuickFlush;
     private _creationTime;
     private _isLoggingDisabled;
-    private _logEventUrl;
+    private _logEventUrlConfig;
     private static _safeFlushAndForget;
     private static _safeRetryFailedLogs;
     constructor(_sdkKey: string, _emitter: StatsigClientEmitEventFunc, _network: NetworkCore, _options: StatsigOptionsCommon<NetworkConfigCommon> | null);

package/src/EventLogger.js

@@ -17,7 +17,7 @@ const NetworkConfig_1 = require("./NetworkConfig");
 const SafeJs_1 = require("./SafeJs");
 const StatsigEvent_1 = require("./StatsigEvent");
 const StorageProvider_1 = require("./StorageProvider");
-const UrlOverrides_1 = require("./UrlOverrides");
+const UrlConfiguration_1 = require("./UrlConfiguration");
 const VisibilityObserving_1 = require("./VisibilityObserving");
 const DEFAULT_QUEUE_SIZE = 50;
 const DEFAULT_FLUSH_INTERVAL_MS = 10000;
@@ -55,7 +55,7 @@ class EventLogger {
         this._isLoggingDisabled = (_options === null || _options === void 0 ? void 0 : _options.disableLogging) === true;
         this._maxQueueSize = (_a = _options === null || _options === void 0 ? void 0 : _options.loggingBufferMaxSize) !== null && _a !== void 0 ? _a : DEFAULT_QUEUE_SIZE;
         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', NetworkConfig_1.NetworkDefault.eventsApi);
+        this._logEventUrlConfig = new UrlConfiguration_1.UrlConfiguration(NetworkConfig_1.Endpoint._rgstr, config === null || config === void 0 ? void 0 : config.logEventUrl, config === null || config === void 0 ? void 0 : config.api, config === null || config === void 0 ? void 0 : config.logEventFallbackUrls);
     }
     setLoggingDisabled(isDisabled) {
         this._isLoggingDisabled = isDisabled;
@@ -212,7 +212,7 @@ class EventLogger {
             data: {
                 events,
             },
-            url: this._logEventUrl,
+            urlConfig: this._logEventUrlConfig,
             retries: 3,
             isCompressable: true,
             params: {

package/src/NetworkConfig.d.ts

@@ -1,7 +1,13 @@
+export declare const Endpoint: {
+    readonly _initialize: "initialize";
+    readonly _rgstr: "rgstr";
+    readonly _download_config_specs: "download_config_specs";
+};
+export type Endpoint = (typeof Endpoint)[keyof typeof Endpoint];
 export declare const NetworkDefault: {
-    eventsApi: "https://prodregistryv2.org/v1";
-    initializeApi: "https://featureassets.org/v1";
-    specsApi: "https://assetsconfigcdn.org/v1";
+    rgstr: "https://prodregistryv2.org/v1";
+    initialize: "https://featureassets.org/v1";
+    download_config_specs: "https://assetsconfigcdn.org/v1";
 };
 export type NetworkPriority = 'high' | 'low' | 'auto';
 export type NetworkArgs = RequestInit & {

package/src/NetworkConfig.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NetworkParam = exports.NetworkDefault = void 0;
+exports.NetworkParam = exports.NetworkDefault = exports.Endpoint = void 0;
+exports.Endpoint = {
+    _initialize: 'initialize',
+    _rgstr: 'rgstr',
+    _download_config_specs: 'download_config_specs',
+};
 exports.NetworkDefault = {
-    eventsApi: 'https://prodregistryv2.org/v1',
-    initializeApi: 'https://featureassets.org/v1',
-    specsApi: 'https://assetsconfigcdn.org/v1',
+    [exports.Endpoint._rgstr]: 'https://prodregistryv2.org/v1',
+    [exports.Endpoint._initialize]: 'https://featureassets.org/v1',
+    [exports.Endpoint._download_config_specs]: 'https://assetsconfigcdn.org/v1',
 };
 exports.NetworkParam = {
     EventCount: 'ec',

package/src/NetworkCore.d.ts

@@ -1,15 +1,16 @@
 import './$_StatsigGlobal';
+import { ErrorBoundary } from './ErrorBoundary';
 import { NetworkPriority } from './NetworkConfig';
 import { StatsigClientEmitEventFunc } from './StatsigClientBase';
 import { AnyStatsigOptions } from './StatsigOptionsCommon';
 import { Flatten } from './TypingUtils';
+import { UrlConfiguration } from './UrlConfiguration';
 type RequestArgs = {
     sdkKey: string;
-    url: string;
+    urlConfig: UrlConfiguration;
     priority?: NetworkPriority;
     retries?: number;
     attempt?: number;
-    isInitialize?: boolean;
     params?: Record<string, string>;
     headers?: Record<string, string>;
 };
@@ -18,7 +19,7 @@ export type RequestArgsWithData = Flatten<RequestArgs & {
     isStatsigEncodable?: boolean;
     isCompressable?: boolean;
 }>;
-type BeaconRequestArgs = Pick<RequestArgsWithData, 'data' | 'sdkKey' | 'url' | 'params' | 'isCompressable' | 'attempt'>;
+type BeaconRequestArgs = Pick<RequestArgsWithData, 'data' | 'sdkKey' | 'urlConfig' | 'params' | 'isCompressable' | 'attempt'>;
 type NetworkResponse = {
     body: string | null;
     code: number;
@@ -28,14 +29,18 @@ export declare class NetworkCore {
     private readonly _timeout;
     private readonly _netConfig;
     private readonly _options;
+    private readonly _fallbackResolver;
+    private _errorBoundary;
     constructor(options: AnyStatsigOptions | null, _emitter?: StatsigClientEmitEventFunc | undefined);
-    post(args: RequestArgsWithData): Promise<NetworkResponse | null>;
-    get(args: RequestArgs): Promise<NetworkResponse | null>;
+    setErrorBoundary(errorBoundary: ErrorBoundary): void;
     isBeaconSupported(): boolean;
     beacon(args: BeaconRequestArgs): Promise<boolean>;
+    post(args: RequestArgsWithData): Promise<NetworkResponse | null>;
+    get(args: RequestArgs): Promise<NetworkResponse | null>;
     private _sendRequest;
     private _getPopulatedURL;
     private _getPopulatedBody;
     private _attemptToEncodeString;
+    private _getInternalRequestArgs;
 }
 export {};

package/src/NetworkCore.js

@@ -15,6 +15,7 @@ const __StatsigGlobal_1 = require("./$_StatsigGlobal");
 const Diagnostics_1 = require("./Diagnostics");
 const Log_1 = require("./Log");
 const NetworkConfig_1 = require("./NetworkConfig");
+const NetworkFallbackResolver_1 = require("./NetworkFallbackResolver");
 const SDKType_1 = require("./SDKType");
 const SafeJs_1 = require("./SafeJs");
 const SessionID_1 = require("./SessionID");
@@ -30,6 +31,7 @@ class NetworkCore {
         this._timeout = DEFAULT_TIMEOUT_MS;
         this._netConfig = {};
         this._options = {};
+        this._errorBoundary = null;
         if (options) {
             this._options = options;
         }
@@ -39,18 +41,13 @@ class NetworkCore {
         if (this._netConfig.networkTimeoutMs) {
             this._timeout = this._netConfig.networkTimeoutMs;
         }
+        this._fallbackResolver = new NetworkFallbackResolver_1.NetworkFallbackResolver(this._options);
     }
-    post(args) {
-        return __awaiter(this, void 0, void 0, function* () {
-            let body = yield this._getPopulatedBody(args);
-            if (args.isStatsigEncodable) {
-                body = this._attemptToEncodeString(args, body);
-            }
-            return this._sendRequest(Object.assign({ method: 'POST', body }, args));
-        });
-    }
-    get(args) {
-        return this._sendRequest(Object.assign({ method: 'GET' }, args));
+    setErrorBoundary(errorBoundary) {
+        this._errorBoundary = errorBoundary;
+        this._errorBoundary.wrap(this);
+        this._errorBoundary.wrap(this._fallbackResolver);
+        this._fallbackResolver.setErrorBoundary(errorBoundary);
     }
     isBeaconSupported() {
         return (typeof navigator !== 'undefined' &&
@@ -61,12 +58,27 @@ class NetworkCore {
             if (!_ensureValidSdkKey(args)) {
                 return false;
             }
-            const body = yield this._getPopulatedBody(args);
-            const url = yield this._getPopulatedURL(args);
+            const argsInternal = this._getInternalRequestArgs('POST', args);
+            const body = yield this._getPopulatedBody(argsInternal, args.data);
+            const url = yield this._getPopulatedURL(argsInternal);
             const nav = navigator;
             return nav.sendBeacon.bind(nav)(url, body);
         });
     }
+    post(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const argsInternal = this._getInternalRequestArgs('POST', args);
+            argsInternal.body = yield this._getPopulatedBody(argsInternal, args.data);
+            if (args.isStatsigEncodable) {
+                argsInternal.body = this._attemptToEncodeString(argsInternal, argsInternal.body);
+            }
+            return this._sendRequest(argsInternal);
+        });
+    }
+    get(args) {
+        const argsInternal = this._getInternalRequestArgs('GET', args);
+        return this._sendRequest(argsInternal);
+    }
     _sendRequest(args) {
         var _a, _b, _c;
         return __awaiter(this, void 0, void 0, function* () {
@@ -78,9 +90,11 @@ class NetworkCore {
             }
             const { method, body, retries, attempt } = args;
             const currentAttempt = attempt !== null && attempt !== void 0 ? attempt : 1;
-            const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
-            const handle = setTimeout(() => controller === null || controller === void 0 ? void 0 : controller.abort(`Timeout of ${this._timeout}ms expired.`), this._timeout);
-            const url = yield this._getPopulatedURL(args);
+            const abortController = typeof AbortController !== 'undefined' ? new AbortController() : null;
+            const timeoutHandle = setTimeout(() => {
+                abortController === null || abortController === void 0 ? void 0 : abortController.abort(`Timeout of ${this._timeout}ms expired.`);
+            }, this._timeout);
+            const populatedUrl = yield this._getPopulatedURL(args);
             let response = null;
             const keepalive = (0, VisibilityObserving_1._isUnloading)();
             try {
@@ -88,37 +102,35 @@ class NetworkCore {
                     method,
                     body,
                     headers: Object.assign({}, args.headers),
-                    signal: controller === null || controller === void 0 ? void 0 : controller.signal,
+                    signal: abortController === null || abortController === void 0 ? void 0 : abortController.signal,
                     priority: args.priority,
                     keepalive,
                 };
-                if (args.isInitialize) {
-                    Diagnostics_1.Diagnostics._markInitNetworkReqStart(args.sdkKey, {
-                        attempt: currentAttempt,
-                    });
-                }
+                _tryMarkInitStart(args, currentAttempt);
                 const func = (_a = this._netConfig.networkOverrideFunc) !== null && _a !== void 0 ? _a : fetch;
-                response = yield func(url, config);
-                clearTimeout(handle);
+                response = yield func(populatedUrl, config);
+                clearTimeout(timeoutHandle);
                 if (!response.ok) {
                     const text = yield response.text().catch(() => 'No Text');
-                    const err = new Error(`NetworkError: ${url} ${text}`);
+                    const err = new Error(`NetworkError: ${populatedUrl} ${text}`);
                     err.name = 'NetworkError';
                     throw err;
                 }
                 const text = yield response.text();
-                if (args.isInitialize) {
-                    Diagnostics_1.Diagnostics._markInitNetworkReqEnd(args.sdkKey, Diagnostics_1.Diagnostics._getDiagnosticsData(response, currentAttempt, text));
-                }
+                _tryMarkInitEnd(args, response, currentAttempt, text);
+                this._fallbackResolver.tryBumpExpiryTime(args.sdkKey, args.urlConfig);
                 return {
                     body: text,
                     code: response.status,
                 };
             }
             catch (error) {
-                const errorMessage = _getErrorMessage(controller, error);
-                if (args.isInitialize) {
-                    Diagnostics_1.Diagnostics._markInitNetworkReqEnd(args.sdkKey, Diagnostics_1.Diagnostics._getDiagnosticsData(response, currentAttempt, '', error));
+                const errorMessage = _getErrorMessage(abortController, error);
+                const timedOut = _didTimeout(abortController);
+                _tryMarkInitEnd(args, response, currentAttempt, '', error);
+                const fallbackUpdated = yield this._fallbackResolver.tryFetchUpdatedFallbackInfo(args.sdkKey, args.urlConfig, errorMessage, timedOut);
+                if (fallbackUpdated) {
+                    args.fallbackUrl = this._fallbackResolver.getActiveFallbackUrl(args.sdkKey, args.urlConfig);
                 }
                 if (!retries ||
                     currentAttempt > retries ||
@@ -129,40 +141,42 @@ class NetworkCore {
                         tag: StatsigClientEventEmitter_1.ErrorTag.NetworkError,
                         requestArgs: args,
                     });
-                    Log_1.Log.error(`A networking error occured during ${method} request to ${url}.`, errorMessage, error);
+                    Log_1.Log.error(`A networking error occured during ${method} request to ${populatedUrl}.`, errorMessage, error);
                     return null;
                 }
-                return this._sendRequest(Object.assign(Object.assign({}, args), { retries: retries, attempt: currentAttempt + 1 }));
+                return this._sendRequest(Object.assign(Object.assign({}, args), { retries, attempt: currentAttempt + 1 }));
             }
         });
     }
     _getPopulatedURL(args) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
+            const url = (_a = args.fallbackUrl) !== null && _a !== void 0 ? _a : args.urlConfig.getUrl();
             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])}`;
             })
                 .join('&');
-            return `${args.url}${query ? `?${query}` : ''}`;
+            return `${url}${query ? `?${query}` : ''}`;
         });
     }
-    _getPopulatedBody(args) {
+    _getPopulatedBody(args, data) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { data, sdkKey } = args;
+            const { sdkKey, fallbackUrl } = args;
             const stableID = StableID_1.StableID.get(sdkKey);
             const sessionID = SessionID_1.SessionID.get(sdkKey);
             const sdkType = SDKType_1.SDKType._get(sdkKey);
             return JSON.stringify(Object.assign(Object.assign({}, data), { statsigMetadata: Object.assign(Object.assign({}, StatsigMetadata_1.StatsigMetadataProvider.get()), { stableID,
                     sessionID,
-                    sdkType }) }));
+                    sdkType,
+                    fallbackUrl }) }));
         });
     }
     _attemptToEncodeString(args, input) {
         var _a, _b;
         const win = (0, SafeJs_1._getWindowSafe)();
-        if (!args.isStatsigEncodable ||
-            this._options.disableStatsigEncoding ||
+        if (this._options.disableStatsigEncoding ||
             (0, __StatsigGlobal_1._getStatsigGlobalFlag)('no-encode') != null ||
             !(win === null || win === void 0 ? void 0 : win.btoa)) {
             return input;
@@ -173,10 +187,15 @@ class NetworkCore {
             return result;
         }
         catch (_c) {
-            Log_1.Log.warn('/initialize request encoding failed');
+            Log_1.Log.warn(`Request encoding failed for ${args.urlConfig.getUrl()}`);
             return input;
         }
     }
+    _getInternalRequestArgs(method, args) {
+        const fallbackUrl = this._fallbackResolver.getActiveFallbackUrl(args.sdkKey, args.urlConfig);
+        return Object.assign(Object.assign({}, args), { method,
+            fallbackUrl });
+    }
 }
 exports.NetworkCore = NetworkCore;
 const _ensureValidSdkKey = (args) => {
@@ -199,3 +218,23 @@ function _getErrorMessage(controller, error) {
     }
     return 'Unknown Error';
 }
+function _didTimeout(controller) {
+    const timeout = (controller === null || controller === void 0 ? void 0 : controller.signal.aborted) &&
+        typeof controller.signal.reason === 'string' &&
+        controller.signal.reason.includes('Timeout');
+    return timeout || false;
+}
+function _tryMarkInitStart(args, attempt) {
+    if (args.urlConfig.endpoint !== NetworkConfig_1.Endpoint._initialize) {
+        return;
+    }
+    Diagnostics_1.Diagnostics._markInitNetworkReqStart(args.sdkKey, {
+        attempt,
+    });
+}
+function _tryMarkInitEnd(args, response, attempt, body, err) {
+    if (args.urlConfig.endpoint !== NetworkConfig_1.Endpoint._initialize) {
+        return;
+    }
+    Diagnostics_1.Diagnostics._markInitNetworkReqEnd(args.sdkKey, Diagnostics_1.Diagnostics._getDiagnosticsData(response, attempt, body, err));
+}

package/src/NetworkFallbackResolver.d.ts

@@ -0,0 +1,22 @@
+import { ErrorBoundary } from './ErrorBoundary';
+import { AnyStatsigOptions } from './StatsigOptionsCommon';
+import { UrlConfiguration } from './UrlConfiguration';
+export type FallbackResolverArgs = {
+    fallbackUrl: string | null;
+};
+export declare class NetworkFallbackResolver {
+    private _fallbackInfo;
+    private _errorBoundary;
+    private _networkOverrideFunc?;
+    private _dnsQueryCooldowns;
+    constructor(options: AnyStatsigOptions);
+    setErrorBoundary(errorBoundary: ErrorBoundary): void;
+    tryBumpExpiryTime(sdkKey: string, urlConfig: UrlConfiguration): void;
+    getActiveFallbackUrl(sdkKey: string, urlConfig: UrlConfiguration): string | null;
+    getFallbackFromProvided(url: string): string | null;
+    tryFetchUpdatedFallbackInfo(sdkKey: string, urlConfig: UrlConfiguration, errorMessage: string | null, timedOut: boolean): Promise<boolean>;
+    private _updateFallbackInfoWithNewUrl;
+    private _tryFetchFallbackUrlsFromNetwork;
+    private _pickNewFallbackUrl;
+}
+export declare function _isDomainFailure(errorMsg: string | null, timedOut: boolean): boolean;

package/src/NetworkFallbackResolver.js

@@ -0,0 +1,198 @@
+"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._isDomainFailure = exports.NetworkFallbackResolver = void 0;
+const DnsTxtQuery_1 = require("./DnsTxtQuery");
+const Hashing_1 = require("./Hashing");
+const Log_1 = require("./Log");
+const StorageProvider_1 = require("./StorageProvider");
+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._dnsQueryCooldowns = {};
+        this._networkOverrideFunc = (_a = options.networkConfig) === null || _a === void 0 ? void 0 : _a.networkOverrideFunc;
+    }
+    setErrorBoundary(errorBoundary) {
+        this._errorBoundary = errorBoundary;
+    }
+    tryBumpExpiryTime(sdkKey, urlConfig) {
+        var _a;
+        const info = (_a = this._fallbackInfo) === null || _a === void 0 ? void 0 : _a[urlConfig.endpoint];
+        if (!info) {
+            return;
+        }
+        info.expiryTime = Date.now() + DEFAULT_TTL_MS;
+        _tryWriteFallbackInfoToCache(sdkKey, Object.assign(Object.assign({}, this._fallbackInfo), { [urlConfig.endpoint]: info }));
+    }
+    getActiveFallbackUrl(sdkKey, urlConfig) {
+        var _a, _b;
+        let info = this._fallbackInfo;
+        if (info == null) {
+            info = (_a = _readFallbackInfoFromCache(sdkKey)) !== null && _a !== void 0 ? _a : {};
+            this._fallbackInfo = info;
+        }
+        const entry = info[urlConfig.endpoint];
+        if (!entry || Date.now() > ((_b = entry.expiryTime) !== null && _b !== void 0 ? _b : 0)) {
+            delete info[urlConfig.endpoint];
+            this._fallbackInfo = info;
+            _tryWriteFallbackInfoToCache(sdkKey, this._fallbackInfo);
+            return null;
+        }
+        if (entry.url) {
+            return entry.url;
+        }
+        return null;
+    }
+    getFallbackFromProvided(url) {
+        const path = _extractPathFromUrl(url);
+        if (path) {
+            return url.replace(path, '');
+        }
+        return null;
+    }
+    tryFetchUpdatedFallbackInfo(sdkKey, urlConfig, errorMessage, timedOut) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                if (!_isDomainFailure(errorMessage, timedOut)) {
+                    return false;
+                }
+                const canUseNetworkFallbacks = urlConfig.customUrl == null && urlConfig.fallbackUrls == null;
+                const urls = canUseNetworkFallbacks
+                    ? yield this._tryFetchFallbackUrlsFromNetwork(urlConfig)
+                    : urlConfig.fallbackUrls;
+                const newUrl = this._pickNewFallbackUrl((_a = this._fallbackInfo) === null || _a === void 0 ? void 0 : _a[urlConfig.endpoint], urls);
+                if (!newUrl) {
+                    return false;
+                }
+                this._updateFallbackInfoWithNewUrl(sdkKey, urlConfig.endpoint, newUrl);
+                return true;
+            }
+            catch (error) {
+                (_b = this._errorBoundary) === null || _b === void 0 ? void 0 : _b.logError('tryFetchUpdatedFallbackInfo', error);
+                return false;
+            }
+        });
+    }
+    _updateFallbackInfoWithNewUrl(sdkKey, endpoint, 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[endpoint];
+        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[endpoint]) === null || _c === void 0 ? void 0 : _c.url;
+        if (previousUrl != null) {
+            newFallbackInfo.previous.push(previousUrl);
+        }
+        this._fallbackInfo = Object.assign(Object.assign({}, this._fallbackInfo), { [endpoint]: newFallbackInfo });
+        _tryWriteFallbackInfoToCache(sdkKey, this._fallbackInfo);
+    }
+    _tryFetchFallbackUrlsFromNetwork(urlConfig) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const cooldown = this._dnsQueryCooldowns[urlConfig.endpoint];
+            if (cooldown && Date.now() < cooldown) {
+                return null;
+            }
+            this._dnsQueryCooldowns[urlConfig.endpoint] = Date.now() + COOLDOWN_TIME_MS;
+            const result = [];
+            const records = yield (0, DnsTxtQuery_1._fetchTxtRecords)((_a = this._networkOverrideFunc) !== null && _a !== void 0 ? _a : fetch);
+            const path = _extractPathFromUrl(urlConfig.defaultUrl);
+            for (const record of records) {
+                if (!record.startsWith(urlConfig.endpointDnsKey + '=')) {
+                    continue;
+                }
+                const parts = record.split('=');
+                if (parts.length > 1) {
+                    let baseUrl = parts[1];
+                    if (baseUrl.endsWith('/')) {
+                        baseUrl = baseUrl.slice(0, -1);
+                    }
+                    result.push(`https://${baseUrl}${path}`);
+                }
+            }
+            return result;
+        });
+    }
+    _pickNewFallbackUrl(currentFallbackInfo, urls) {
+        var _a;
+        if (urls == null) {
+            return null;
+        }
+        const previouslyUsed = new Set((_a = currentFallbackInfo === null || currentFallbackInfo === void 0 ? void 0 : currentFallbackInfo.previous) !== null && _a !== void 0 ? _a : []);
+        const currentFallbackUrl = currentFallbackInfo === null || currentFallbackInfo === void 0 ? void 0 : currentFallbackInfo.url;
+        let found = null;
+        for (const loopUrl of urls) {
+            const url = loopUrl.endsWith('/') ? loopUrl.slice(0, -1) : loopUrl;
+            if (!previouslyUsed.has(loopUrl) && url !== currentFallbackUrl) {
+                found = url;
+                break;
+            }
+        }
+        return found;
+    }
+}
+exports.NetworkFallbackResolver = NetworkFallbackResolver;
+function _isDomainFailure(errorMsg, timedOut) {
+    var _a;
+    const lowerErrorMsg = (_a = errorMsg === null || errorMsg === void 0 ? void 0 : errorMsg.toLowerCase()) !== null && _a !== void 0 ? _a : '';
+    return (timedOut ||
+        lowerErrorMsg.includes('uncaught exception') ||
+        lowerErrorMsg.includes('failed to fetch') ||
+        lowerErrorMsg.includes('networkerror when attempting to fetch resource'));
+}
+exports._isDomainFailure = _isDomainFailure;
+function _getFallbackInfoStorageKey(sdkKey) {
+    return `statsig.network_fallback.${(0, Hashing_1._DJB2)(sdkKey)}`;
+}
+function _tryWriteFallbackInfoToCache(sdkKey, info) {
+    const hashKey = _getFallbackInfoStorageKey(sdkKey);
+    if (!info || Object.keys(info).length === 0) {
+        StorageProvider_1.Storage.removeItem(hashKey);
+        return;
+    }
+    StorageProvider_1.Storage.setItem(hashKey, JSON.stringify(info));
+}
+function _readFallbackInfoFromCache(sdkKey) {
+    const hashKey = _getFallbackInfoStorageKey(sdkKey);
+    const data = StorageProvider_1.Storage.getItem(hashKey);
+    if (!data) {
+        return null;
+    }
+    try {
+        return JSON.parse(data);
+    }
+    catch (_a) {
+        Log_1.Log.error('Failed to parse FallbackInfo');
+        return null;
+    }
+}
+function _extractPathFromUrl(urlString) {
+    try {
+        const url = new URL(urlString);
+        return url.pathname;
+    }
+    catch (error) {
+        return null;
+    }
+}

package/src/StatsigClientBase.js

@@ -36,9 +36,9 @@ class StatsigClientBase {
         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);
+        network.setErrorBoundary(this._errorBoundary);
         this.dataAdapter = adapter;
         this.dataAdapter.attach(sdkKey, options);
         this.storageProvider = StorageProvider_1.Storage;

package/src/StatsigEvent.js

@@ -22,24 +22,35 @@ const _isExposureEvent = ({ eventName, }) => {
 };
 exports._isExposureEvent = _isExposureEvent;
 const _createGateExposure = (user, gate) => {
-    var _a, _b;
-    return _createExposure(GATE_EXPOSURE_NAME, user, gate.details, {
+    var _a, _b, _c;
+    const metadata = {
         gate: gate.name,
         gateValue: String(gate.value),
         ruleID: gate.ruleID,
-    }, (_b = (_a = gate.__evaluation) === null || _a === void 0 ? void 0 : _a.secondary_exposures) !== null && _b !== void 0 ? _b : []);
+    };
+    if (((_a = gate.__evaluation) === null || _a === void 0 ? void 0 : _a.version) != null) {
+        metadata['configVersion'] = gate.__evaluation.version;
+    }
+    return _createExposure(GATE_EXPOSURE_NAME, user, gate.details, metadata, (_c = (_b = gate.__evaluation) === null || _b === void 0 ? void 0 : _b.secondary_exposures) !== null && _c !== void 0 ? _c : []);
 };
 exports._createGateExposure = _createGateExposure;
 const _createConfigExposure = (user, config) => {
-    var _a, _b;
-    return _createExposure(CONFIG_EXPOSURE_NAME, user, config.details, {
+    var _a, _b, _c, _d;
+    const metadata = {
         config: config.name,
         ruleID: config.ruleID,
-    }, (_b = (_a = config.__evaluation) === null || _a === void 0 ? void 0 : _a.secondary_exposures) !== null && _b !== void 0 ? _b : []);
+    };
+    if (((_a = config.__evaluation) === null || _a === void 0 ? void 0 : _a.version) != null) {
+        metadata['configVersion'] = config.__evaluation.version;
+    }
+    if (((_b = config.__evaluation) === null || _b === void 0 ? void 0 : _b.passed) != null) {
+        metadata['rulePassed'] = String(config.__evaluation.passed);
+    }
+    return _createExposure(CONFIG_EXPOSURE_NAME, user, config.details, metadata, (_d = (_c = config.__evaluation) === null || _c === void 0 ? void 0 : _c.secondary_exposures) !== null && _d !== void 0 ? _d : []);
 };
 exports._createConfigExposure = _createConfigExposure;
 const _createLayerParameterExposure = (user, layer, parameterName) => {
-    var _a, _b, _c;
+    var _a, _b, _c, _d;
     const evaluation = layer.__evaluation;
     const isExplicit = ((_a = evaluation === null || evaluation === void 0 ? void 0 : evaluation.explicit_parameters) === null || _a === void 0 ? void 0 : _a.includes(parameterName)) === true;
     let allocatedExperiment = '';
@@ -48,13 +59,17 @@ const _createLayerParameterExposure = (user, layer, parameterName) => {
         allocatedExperiment = (_c = evaluation.allocated_experiment_name) !== null && _c !== void 0 ? _c : '';
         secondaryExposures = evaluation.secondary_exposures;
     }
-    return _createExposure(LAYER_EXPOSURE_NAME, user, layer.details, {
+    const metadata = {
         config: layer.name,
         parameterName,
         ruleID: layer.ruleID,
         allocatedExperiment,
         isExplicitParameter: String(isExplicit),
-    }, secondaryExposures);
+    };
+    if (((_d = layer.__evaluation) === null || _d === void 0 ? void 0 : _d.version) != null) {
+        metadata['configVersion'] = layer.__evaluation.version;
+    }
+    return _createExposure(LAYER_EXPOSURE_NAME, user, layer.details, metadata, secondaryExposures);
 };
 exports._createLayerParameterExposure = _createLayerParameterExposure;
 const _addEvaluationDetailsToMetadata = (details, metadata) => {

package/src/StatsigMetadata.d.ts

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

package/src/StatsigOptionsCommon.d.ts

@@ -27,6 +27,10 @@ export type NetworkConfigCommon = {
      * default: `https://featuregates.org/v1/initialize`
      */
     logEventUrl?: string;
+    /**
+     * A list of URLs to try if the primary logEventUrl fails.
+     */
+    logEventFallbackUrls?: string[];
     /**
      * Overrides the default networking layer used by the Statsig client.
      * By default, the client use `fetch`, but overriding this

package/src/UrlConfiguration.d.ts

@@ -0,0 +1,11 @@
+import { Endpoint } from './NetworkConfig';
+export type EndpointDnsKey = 'i' | 'e' | 'd';
+export declare class UrlConfiguration {
+    readonly endpoint: Endpoint;
+    readonly endpointDnsKey: EndpointDnsKey;
+    readonly defaultUrl: string;
+    readonly customUrl: string | null;
+    readonly fallbackUrls: string[] | null;
+    constructor(endpoint: Endpoint, customUrl: string | undefined | null, customApi: string | undefined | null, fallbackUrls: string[] | undefined | null);
+    getUrl(): string;
+}

package/src/UrlConfiguration.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlConfiguration = void 0;
+const NetworkConfig_1 = require("./NetworkConfig");
+const ENDPOINT_DNS_KEY_MAP = {
+    [NetworkConfig_1.Endpoint._initialize]: 'i',
+    [NetworkConfig_1.Endpoint._rgstr]: 'e',
+    [NetworkConfig_1.Endpoint._download_config_specs]: 'd',
+};
+class UrlConfiguration {
+    constructor(endpoint, customUrl, customApi, fallbackUrls) {
+        this.customUrl = null;
+        this.fallbackUrls = null;
+        this.endpoint = endpoint;
+        this.endpointDnsKey = ENDPOINT_DNS_KEY_MAP[endpoint];
+        if (customUrl) {
+            this.customUrl = customUrl;
+        }
+        if (!customUrl && customApi) {
+            this.customUrl = `${customApi}/${endpoint}`;
+        }
+        if (fallbackUrls) {
+            this.fallbackUrls = fallbackUrls;
+        }
+        const defaultApi = NetworkConfig_1.NetworkDefault[endpoint];
+        this.defaultUrl = `${defaultApi}/${endpoint}`;
+    }
+    getUrl() {
+        var _a;
+        return (_a = this.customUrl) !== null && _a !== void 0 ? _a : this.defaultUrl;
+    }
+}
+exports.UrlConfiguration = UrlConfiguration;

package/src/index.d.ts

@@ -37,7 +37,7 @@ export * from './StatsigUser';
 export * from './StorageProvider';
 export * from './TypedJsonParse';
 export * from './TypingUtils';
-export * from './UrlOverrides';
+export * from './UrlConfiguration';
 export * from './UUID';
 export * from './VisibilityObserving';
 export { EventLogger, Storage, Log, Diagnostics };

package/src/index.js

@@ -59,7 +59,7 @@ __exportStar(require("./StatsigUser"), exports);
 __exportStar(require("./StorageProvider"), exports);
 __exportStar(require("./TypedJsonParse"), exports);
 __exportStar(require("./TypingUtils"), exports);
-__exportStar(require("./UrlOverrides"), exports);
+__exportStar(require("./UrlConfiguration"), exports);
 __exportStar(require("./UUID"), exports);
 __exportStar(require("./VisibilityObserving"), exports);
 __STATSIG__ = Object.assign(Object.assign({}, (__STATSIG__ !== null && __STATSIG__ !== void 0 ? __STATSIG__ : {})), { Log: Log_1.Log,

package/src/UrlOverrides.d.ts

@@ -1 +0,0 @@
-export declare function _getOverridableUrl(overrideUrl: string | undefined, overrideApi: string | undefined, defaultEndpoint: string, defaultApi: string): string;

package/src/UrlOverrides.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports._getOverridableUrl = void 0;
-function _getOverridableUrl(overrideUrl, overrideApi, defaultEndpoint, defaultApi) {
-    if (overrideUrl) {
-        return overrideUrl;
-    }
-    else if (overrideApi) {
-        return `${overrideApi}${defaultEndpoint}`;
-    }
-    else {
-        return `${defaultApi}${defaultEndpoint}`;
-    }
-}
-exports._getOverridableUrl = _getOverridableUrl;