@statsig/client-core 3.2.0 → 3.3.0-beta.2

package/package.json

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

package/src/DnsTxtQuery.d.ts

@@ -0,0 +1,2 @@
+import { NetworkArgs } from './NetworkConfig';
+export declare function _fetchTxtRecords(networkFunc: (url: string, args: NetworkArgs) => Promise<Response>): Promise<string[]>;

package/src/DnsTxtQuery.js

@@ -0,0 +1,63 @@
+"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._fetchTxtRecords = void 0;
+// See example: https://github.com/statsig-io/private-js-client-monorepo/pull/340
+const FEATURE_ASSETS_DNS_QUERY = new Uint8Array([
+    0x00, 0x00, 0x01, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x0d,
+    0x66, 0x65, 0x61, 0x74, 0x75, 0x72, 0x65, 0x61, 0x73, 0x73, 0x65, 0x74, 0x73,
+    0x03, 0x6f, 0x72, 0x67, 0x00, 0x00, 0x10, 0x00, 0x01,
+]);
+const DNS_QUERY_ENDPOINT = 'https://cloudflare-dns.com/dns-query';
+const DOMAIN_CHARS = [
+    'i', // initialize
+    'e', // events
+    'd', // dcs
+];
+const MAX_START_LOOKUP = 200;
+function _fetchTxtRecords(networkFunc) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const response = yield networkFunc(DNS_QUERY_ENDPOINT, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/dns-message',
+                Accept: 'application/dns-message',
+            },
+            body: FEATURE_ASSETS_DNS_QUERY,
+        });
+        if (!response.ok) {
+            const err = new Error('Failed to fetch TXT records from DNS');
+            err.name = 'DnsTxtFetchError';
+            throw err;
+        }
+        const data = yield response.arrayBuffer();
+        const bytes = new Uint8Array(data);
+        return _parseDnsResponse(bytes);
+    });
+}
+exports._fetchTxtRecords = _fetchTxtRecords;
+function _parseDnsResponse(input) {
+    // loop until we find the first valid domain char. One of [i=, e=, d=]
+    const start = input.findIndex((byte, index) => index < MAX_START_LOOKUP &&
+        String.fromCharCode(byte) === '=' &&
+        DOMAIN_CHARS.includes(String.fromCharCode(input[index - 1])));
+    if (start === -1) {
+        const err = new Error('Failed to parse TXT records from DNS');
+        err.name = 'DnsTxtParseError';
+        throw err;
+    }
+    // decode the remaining bytes as a string
+    let result = '';
+    for (let i = start - 1; i < input.length; i++) {
+        result += String.fromCharCode(input[i]);
+    }
+    return result.split(',');
+}

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.d.ts

@@ -1,4 +1,5 @@
 import './$_StatsigGlobal';
+import { ErrorBoundary } from './ErrorBoundary';
 import { NetworkPriority } from './NetworkConfig';
 import { StatsigClientEmitEventFunc } from './StatsigClientBase';
 import { AnyStatsigOptions } from './StatsigOptionsCommon';
@@ -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,10 +15,12 @@ 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");
 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;
@@ -29,6 +31,7 @@ class NetworkCore {
         this._timeout = DEFAULT_TIMEOUT_MS;
         this._netConfig = {};
         this._options = {};
+        this._errorBoundary = null;
         if (options) {
             this._options = options;
         }
@@ -38,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' &&
@@ -60,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* () {
@@ -77,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 {
@@ -87,76 +102,76 @@ 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, populatedUrl);
                 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, populatedUrl, errorMessage, timedOut);
+                if (fallbackUpdated) {
+                    args.fallbackUrl = this._fallbackResolver.getFallbackUrl(args.sdkKey, args.url);
                 }
                 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 });
-                    Log_1.Log.error(`A networking error occured during ${method} request to ${url}.`, errorMessage, error);
+                    (_c = this._emitter) === null || _c === void 0 ? void 0 : _c.call(this, { name: 'error', error, tag: StatsigClientEventEmitter_1.ErrorTag.NetworkError });
+                    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.url;
             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;
@@ -171,6 +186,11 @@ class NetworkCore {
             return input;
         }
     }
+    _getInternalRequestArgs(method, args) {
+        const fallbackUrl = this._fallbackResolver.getFallbackUrl(args.sdkKey, args.url);
+        return Object.assign(Object.assign({}, args), { method,
+            fallbackUrl });
+    }
 }
 exports.NetworkCore = NetworkCore;
 const _ensureValidSdkKey = (args) => {
@@ -193,3 +213,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.isInitialize) {
+        return;
+    }
+    Diagnostics_1.Diagnostics._markInitNetworkReqStart(args.sdkKey, {
+        attempt,
+    });
+}
+function _tryMarkInitEnd(args, response, attempt, body, err) {
+    if (!args.isInitialize) {
+        return;
+    }
+    Diagnostics_1.Diagnostics._markInitNetworkReqEnd(args.sdkKey, Diagnostics_1.Diagnostics._getDiagnosticsData(response, attempt, body, err));
+}

package/src/NetworkFallbackResolver.d.ts

@@ -0,0 +1,20 @@
+import { ErrorBoundary } from './ErrorBoundary';
+import { AnyStatsigOptions } from './StatsigOptionsCommon';
+export type FallbackResolverArgs = {
+    fallbackUrl: string | null;
+};
+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;
+export declare function _isDomainFailure(errorMsg: string | null, timedOut: boolean): boolean;

package/src/NetworkFallbackResolver.js

@@ -0,0 +1,208 @@
+"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._isDefaultUrl = 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
+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) {
+        this._errorBoundary = errorBoundary;
+    }
+    tryBumpExpiryTime(sdkKey, url) {
+        var _a;
+        const domainKey = _getDomainKeyFromEndpoint(url);
+        if (!domainKey) {
+            return;
+        }
+        const info = (_a = this._fallbackInfo) === null || _a === void 0 ? void 0 : _a[domainKey];
+        if (!info) {
+            return;
+        }
+        info.expiryTime = Date.now() + DEFAULT_TTL_MS;
+        _tryWriteFallbackInfoToCache(sdkKey, Object.assign(Object.assign({}, this._fallbackInfo), { [domainKey]: info }));
+    }
+    getFallbackUrl(sdkKey, url) {
+        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];
+        if (!entry || Date.now() > ((_b = entry.expiryTime) !== null && _b !== void 0 ? _b : 0)) {
+            delete info[domainKey];
+            this._fallbackInfo = info;
+            _tryWriteFallbackInfoToCache(sdkKey, this._fallbackInfo);
+            return null;
+        }
+        const endpoint = _extractEndpointForUrl(url);
+        if (entry.url) {
+            return `https://${entry.url}/${endpoint}`;
+        }
+        return null;
+    }
+    tryFetchUpdatedFallbackInfo(sdkKey, url, errorMessage, timedOut) {
+        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;
+                }
+                this._updateFallbackInfoWithNewUrl(sdkKey, domainKey, newUrl);
+                return true;
+            }
+            catch (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* () {
+            const records = yield (0, DnsTxtQuery_1._fetchTxtRecords)((_a = this._networkOverrideFunc) !== null && _a !== void 0 ? _a : fetch);
+            if (records.length === 0) {
+                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;
+            for (const record of records) {
+                const [recordKey, recordUrl] = record.split('=');
+                if (!recordUrl || recordKey !== domainKey) {
+                    continue;
+                }
+                let url = recordUrl;
+                if (recordUrl.endsWith('/')) {
+                    url = recordUrl.slice(0, -1);
+                }
+                if (!seen.has(recordUrl) && url !== currentUrl) {
+                    found = url;
+                    break;
+                }
+            }
+            return found;
+        });
+    }
+}
+exports.NetworkFallbackResolver = NetworkFallbackResolver;
+function _isDefaultUrl(url) {
+    for (const key in NetworkConfig_1.NetworkDefault) {
+        if (url.startsWith(NetworkConfig_1.NetworkDefault[key])) {
+            return true;
+        }
+    }
+    return false;
+}
+exports._isDefaultUrl = _isDefaultUrl;
+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 _extractEndpointForUrl(urlString) {
+    try {
+        const url = new URL(urlString);
+        const endpoint = url.pathname.substring(1);
+        return endpoint;
+    }
+    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;
+}

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/StatsigClientEventEmitter.d.ts

@@ -2,6 +2,10 @@ 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 EventNameToEventDataMap = {
     values_updated: {
         status: StatsigLoadingStatus;
@@ -10,6 +14,7 @@ type EventNameToEventDataMap = {
     session_expired: object;
     error: {
         error: unknown;
+        tag: ErrorTag | string;
     };
     logs_flushed: {
         events: Record<string, unknown>[];

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