@statsig/client-core 3.4.0-beta.1 → 3.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statsig/client-core",
-  "version": "3.4.0-beta.1",
+  "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

@@ -4,13 +4,13 @@ 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>;
 };
@@ -19,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;

package/src/NetworkCore.js

@@ -118,7 +118,7 @@ class NetworkCore {
                 }
                 const text = yield response.text();
                 _tryMarkInitEnd(args, response, currentAttempt, text);
-                this._fallbackResolver.tryBumpExpiryTime(args.sdkKey, populatedUrl);
+                this._fallbackResolver.tryBumpExpiryTime(args.sdkKey, args.urlConfig);
                 return {
                     body: text,
                     code: response.status,
@@ -128,9 +128,9 @@ class NetworkCore {
                 const errorMessage = _getErrorMessage(abortController, error);
                 const timedOut = _didTimeout(abortController);
                 _tryMarkInitEnd(args, response, currentAttempt, '', error);
-                const fallbackUpdated = yield this._fallbackResolver.tryFetchUpdatedFallbackInfo(args.sdkKey, populatedUrl, errorMessage, timedOut);
+                const fallbackUpdated = yield this._fallbackResolver.tryFetchUpdatedFallbackInfo(args.sdkKey, args.urlConfig, errorMessage, timedOut);
                 if (fallbackUpdated) {
-                    args.fallbackUrl = this._fallbackResolver.getFallbackUrl(args.sdkKey, args.url);
+                    args.fallbackUrl = this._fallbackResolver.getActiveFallbackUrl(args.sdkKey, args.urlConfig);
                 }
                 if (!retries ||
                     currentAttempt > retries ||
@@ -151,7 +151,7 @@ class NetworkCore {
     _getPopulatedURL(args) {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            const url = (_a = args.fallbackUrl) !== null && _a !== void 0 ? _a : args.url;
+            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) => {
@@ -187,12 +187,12 @@ 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.getFallbackUrl(args.sdkKey, args.url);
+        const fallbackUrl = this._fallbackResolver.getActiveFallbackUrl(args.sdkKey, args.urlConfig);
         return Object.assign(Object.assign({}, args), { method,
             fallbackUrl });
     }
@@ -225,7 +225,7 @@ function _didTimeout(controller) {
     return timeout || false;
 }
 function _tryMarkInitStart(args, attempt) {
-    if (!args.isInitialize) {
+    if (args.urlConfig.endpoint !== NetworkConfig_1.Endpoint._initialize) {
         return;
     }
     Diagnostics_1.Diagnostics._markInitNetworkReqStart(args.sdkKey, {
@@ -233,7 +233,7 @@ function _tryMarkInitStart(args, attempt) {
     });
 }
 function _tryMarkInitEnd(args, response, attempt, body, err) {
-    if (!args.isInitialize) {
+    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

@@ -1,5 +1,6 @@
 import { ErrorBoundary } from './ErrorBoundary';
 import { AnyStatsigOptions } from './StatsigOptionsCommon';
+import { UrlConfiguration } from './UrlConfiguration';
 export type FallbackResolverArgs = {
     fallbackUrl: string | null;
 };
@@ -7,14 +8,15 @@ export declare class NetworkFallbackResolver {
     private _fallbackInfo;
     private _errorBoundary;
     private _networkOverrideFunc?;
-    private _cooldowns;
+    private _dnsQueryCooldowns;
     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>;
+    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 _fetchFallbackUrl;
+    private _tryFetchFallbackUrlsFromNetwork;
+    private _pickNewFallbackUrl;
 }
-export declare function _isDefaultUrl(url: string): boolean;
 export declare function _isDomainFailure(errorMsg: string | null, timedOut: boolean): boolean;

package/src/NetworkFallbackResolver.js

@@ -9,11 +9,10 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._isDomainFailure = exports._isDefaultUrl = exports.NetworkFallbackResolver = void 0;
+exports._isDomainFailure = exports.NetworkFallbackResolver = void 0;
 const DnsTxtQuery_1 = require("./DnsTxtQuery");
 const Hashing_1 = require("./Hashing");
 const Log_1 = require("./Log");
-const NetworkConfig_1 = require("./NetworkConfig");
 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
@@ -22,134 +21,138 @@ class NetworkFallbackResolver {
         var _a;
         this._fallbackInfo = null;
         this._errorBoundary = null;
-        this._cooldowns = {};
+        this._dnsQueryCooldowns = {};
         this._networkOverrideFunc = (_a = options.networkConfig) === null || _a === void 0 ? void 0 : _a.networkOverrideFunc;
     }
     setErrorBoundary(errorBoundary) {
         this._errorBoundary = errorBoundary;
     }
-    tryBumpExpiryTime(sdkKey, url) {
+    tryBumpExpiryTime(sdkKey, urlConfig) {
         var _a;
-        const domainKey = _getDomainKeyFromEndpoint(url);
-        if (!domainKey) {
-            return;
-        }
-        const info = (_a = this._fallbackInfo) === null || _a === void 0 ? void 0 : _a[domainKey];
+        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), { [domainKey]: info }));
+        _tryWriteFallbackInfoToCache(sdkKey, Object.assign(Object.assign({}, this._fallbackInfo), { [urlConfig.endpoint]: info }));
     }
-    getFallbackUrl(sdkKey, url) {
+    getActiveFallbackUrl(sdkKey, urlConfig) {
         var _a, _b;
-        const domainKey = _getDomainKeyFromEndpoint(url);
-        if (!_isDefaultUrl(url) || !domainKey) {
-            return null;
-        }
         let info = this._fallbackInfo;
         if (info == null) {
             info = (_a = _readFallbackInfoFromCache(sdkKey)) !== null && _a !== void 0 ? _a : {};
             this._fallbackInfo = info;
         }
-        const entry = info[domainKey];
+        const entry = info[urlConfig.endpoint];
         if (!entry || Date.now() > ((_b = entry.expiryTime) !== null && _b !== void 0 ? _b : 0)) {
-            delete info[domainKey];
+            delete info[urlConfig.endpoint];
             this._fallbackInfo = info;
             _tryWriteFallbackInfoToCache(sdkKey, this._fallbackInfo);
             return null;
         }
-        const endpoint = _extractEndpointForUrl(url);
         if (entry.url) {
-            return `https://${entry.url}/${endpoint}`;
+            return entry.url;
         }
         return null;
     }
-    tryFetchUpdatedFallbackInfo(sdkKey, url, errorMessage, timedOut) {
-        var _a;
+    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 {
-                const domainKey = _getDomainKeyFromEndpoint(url);
-                if (!_isDomainFailure(errorMessage, timedOut) || !domainKey) {
-                    return false;
-                }
-                if (this._cooldowns[domainKey] &&
-                    Date.now() < this._cooldowns[domainKey]) {
+                if (!_isDomainFailure(errorMessage, timedOut)) {
                     return false;
                 }
-                this._cooldowns[domainKey] = Date.now() + COOLDOWN_TIME_MS;
-                const newUrl = yield this._fetchFallbackUrl(domainKey);
+                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, domainKey, newUrl);
+                this._updateFallbackInfoWithNewUrl(sdkKey, urlConfig.endpoint, newUrl);
                 return true;
             }
             catch (error) {
-                (_a = this._errorBoundary) === null || _a === void 0 ? void 0 : _a.logError('tryFetchUpdatedFallbackInfo', error);
+                (_b = this._errorBoundary) === null || _b === void 0 ? void 0 : _b.logError('tryFetchUpdatedFallbackInfo', error);
                 return false;
             }
         });
     }
-    _updateFallbackInfoWithNewUrl(sdkKey, domainKey, newUrl) {
+    _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[domainKey];
+        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[domainKey]) === null || _c === void 0 ? void 0 : _c.url;
+        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), { [domainKey]: newFallbackInfo });
+        this._fallbackInfo = Object.assign(Object.assign({}, this._fallbackInfo), { [endpoint]: newFallbackInfo });
         _tryWriteFallbackInfoToCache(sdkKey, this._fallbackInfo);
     }
-    _fetchFallbackUrl(domainKey) {
-        var _a, _b, _c, _d, _e, _f;
+    _tryFetchFallbackUrlsFromNetwork(urlConfig) {
+        var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            const records = yield (0, DnsTxtQuery_1._fetchTxtRecords)((_a = this._networkOverrideFunc) !== null && _a !== void 0 ? _a : fetch);
-            if (records.length === 0) {
+            const cooldown = this._dnsQueryCooldowns[urlConfig.endpoint];
+            if (cooldown && Date.now() < cooldown) {
                 return null;
             }
-            const seen = new Set((_d = (_c = (_b = this._fallbackInfo) === null || _b === void 0 ? void 0 : _b[domainKey]) === null || _c === void 0 ? void 0 : _c.previous) !== null && _d !== void 0 ? _d : []);
-            const currentUrl = (_f = (_e = this._fallbackInfo) === null || _e === void 0 ? void 0 : _e[domainKey]) === null || _f === void 0 ? void 0 : _f.url;
-            let found = 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) {
-                const [recordKey, recordUrl] = record.split('=');
-                if (!recordUrl || recordKey !== domainKey) {
+                if (!record.startsWith(urlConfig.endpointDnsKey + '=')) {
                     continue;
                 }
-                let url = recordUrl;
-                if (recordUrl.endsWith('/')) {
-                    url = recordUrl.slice(0, -1);
-                }
-                if (!seen.has(recordUrl) && url !== currentUrl) {
-                    found = url;
-                    break;
+                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 found;
+            return result;
         });
     }
-}
-exports.NetworkFallbackResolver = NetworkFallbackResolver;
-function _isDefaultUrl(url) {
-    for (const key in NetworkConfig_1.NetworkDefault) {
-        if (url.startsWith(NetworkConfig_1.NetworkDefault[key])) {
-            return true;
+    _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;
     }
-    return false;
 }
-exports._isDefaultUrl = _isDefaultUrl;
+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 : '';
@@ -184,25 +187,12 @@ function _readFallbackInfoFromCache(sdkKey) {
         return null;
     }
 }
-function _extractEndpointForUrl(urlString) {
+function _extractPathFromUrl(urlString) {
     try {
         const url = new URL(urlString);
-        const endpoint = url.pathname.substring(1);
-        return endpoint;
+        return url.pathname;
     }
     catch (error) {
-        return '';
-    }
-}
-function _getDomainKeyFromEndpoint(endpoint) {
-    if (endpoint.includes('initialize')) {
-        return 'i';
-    }
-    if (endpoint.includes('rgstr')) {
-        return 'e';
-    }
-    if (endpoint.includes('download_config_specs')) {
-        return 'd';
+        return null;
     }
-    return null;
 }

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-beta.1";
+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-beta.1';
+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;