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

package/package.json

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

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,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, 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 ||
@@ -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.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;
@@ -177,6 +191,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) => {
@@ -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.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/StatsigMetadata.d.ts

@@ -1,4 +1,4 @@
-export declare const SDK_VERSION = "3.3.0";
+export declare const SDK_VERSION = "3.4.0-beta.1";
 export type StatsigMetadata = {
     readonly [key: string]: string | undefined;
     readonly appVersion?: string;

package/src/StatsigMetadata.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StatsigMetadataProvider = exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = '3.3.0';
+exports.SDK_VERSION = '3.4.0-beta.1';
 let metadata = {
     sdkVersion: exports.SDK_VERSION,
     sdkType: 'js-mono', // js-mono is overwritten by Precomp and OnDevice clients

package/src/StatsigTypeFactories.d.ts

@@ -5,4 +5,4 @@ export declare function _makeDynamicConfig(name: string, details: EvaluationDeta
 export declare function _makeExperiment(name: string, details: EvaluationDetails, evaluation: DynamicConfigEvaluation | null): Experiment;
 export declare function _makeLayer(name: string, details: EvaluationDetails, evaluation: LayerEvaluation | null, exposeFunc?: (param: string) => void): Layer;
 export declare function _mergeOverride<T extends AnyConfigBasedStatsigType>(original: T, overridden: T | null | undefined, value: Record<string, unknown>, exposeFunc?: (param: string) => void): T;
-export declare function _makeTypedGet(value: Record<string, unknown> | undefined, exposeFunc?: (param: string) => void): TypedGet;
+export declare function _makeTypedGet(name: string, value: Record<string, unknown> | undefined, exposeFunc?: (param: string) => void): TypedGet;

package/src/StatsigTypeFactories.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._makeTypedGet = exports._mergeOverride = exports._makeLayer = exports._makeExperiment = exports._makeDynamicConfig = exports._makeFeatureGate = void 0;
+const Log_1 = require("./Log");
 const TypingUtils_1 = require("./TypingUtils");
 const DEFAULT_RULE = 'default';
 function _makeEvaluation(name, details, evaluation, value) {
@@ -20,7 +21,7 @@ exports._makeFeatureGate = _makeFeatureGate;
 function _makeDynamicConfig(name, details, evaluation) {
     var _a;
     const value = (_a = evaluation === null || evaluation === void 0 ? void 0 : evaluation.value) !== null && _a !== void 0 ? _a : {};
-    return Object.assign(Object.assign({}, _makeEvaluation(name, details, evaluation, value)), { get: _makeTypedGet(evaluation === null || evaluation === void 0 ? void 0 : evaluation.value) });
+    return Object.assign(Object.assign({}, _makeEvaluation(name, details, evaluation, value)), { get: _makeTypedGet(name, evaluation === null || evaluation === void 0 ? void 0 : evaluation.value) });
 }
 exports._makeDynamicConfig = _makeDynamicConfig;
 function _makeExperiment(name, details, evaluation) {
@@ -31,14 +32,14 @@ function _makeExperiment(name, details, evaluation) {
 exports._makeExperiment = _makeExperiment;
 function _makeLayer(name, details, evaluation, exposeFunc) {
     var _a, _b;
-    return Object.assign(Object.assign({}, _makeEvaluation(name, details, evaluation, undefined)), { get: _makeTypedGet(evaluation === null || evaluation === void 0 ? void 0 : evaluation.value, exposeFunc), groupName: (_a = evaluation === null || evaluation === void 0 ? void 0 : evaluation.group_name) !== null && _a !== void 0 ? _a : null, __value: (_b = evaluation === null || evaluation === void 0 ? void 0 : evaluation.value) !== null && _b !== void 0 ? _b : {} });
+    return Object.assign(Object.assign({}, _makeEvaluation(name, details, evaluation, undefined)), { get: _makeTypedGet(name, evaluation === null || evaluation === void 0 ? void 0 : evaluation.value, exposeFunc), groupName: (_a = evaluation === null || evaluation === void 0 ? void 0 : evaluation.group_name) !== null && _a !== void 0 ? _a : null, __value: (_b = evaluation === null || evaluation === void 0 ? void 0 : evaluation.value) !== null && _b !== void 0 ? _b : {} });
 }
 exports._makeLayer = _makeLayer;
 function _mergeOverride(original, overridden, value, exposeFunc) {
-    return Object.assign(Object.assign(Object.assign({}, original), overridden), { get: _makeTypedGet(value, exposeFunc) });
+    return Object.assign(Object.assign(Object.assign({}, original), overridden), { get: _makeTypedGet(original.name, value, exposeFunc) });
 }
 exports._mergeOverride = _mergeOverride;
-function _makeTypedGet(value, exposeFunc) {
+function _makeTypedGet(name, value, exposeFunc) {
     return (param, fallback) => {
         var _a;
         const found = (_a = value === null || value === void 0 ? void 0 : value[param]) !== null && _a !== void 0 ? _a : null;
@@ -46,6 +47,7 @@ function _makeTypedGet(value, exposeFunc) {
             return (fallback !== null && fallback !== void 0 ? fallback : null);
         }
         if (fallback != null && !(0, TypingUtils_1._isTypeMatch)(found, fallback)) {
+            Log_1.Log.warn(`Parameter type mismatch. '${name}.${param}' was found to be type '${typeof found}' but fallback/return type is '${typeof fallback}'. See https://docs.statsig.com/client/javascript-sdk/#typed-getters`);
             return (fallback !== null && fallback !== void 0 ? fallback : null);
         }
         exposeFunc === null || exposeFunc === void 0 ? void 0 : exposeFunc(param);

package/src/index.d.ts

@@ -16,8 +16,8 @@ export * from './EvaluationTypes';
 export * from './Hashing';
 export * from './InitializeResponse';
 export * from './Log';
-export * from './NetworkCore';
 export * from './NetworkConfig';
+export * from './NetworkCore';
 export * from './OverrideAdapter';
 export * from './ParamStoreTypes';
 export * from './SafeJs';
@@ -30,10 +30,10 @@ export * from './StatsigDataAdapter';
 export * from './StatsigEvent';
 export * from './StatsigMetadata';
 export * from './StatsigOptionsCommon';
+export * from './StatsigPlugin';
 export * from './StatsigTypeFactories';
 export * from './StatsigTypes';
 export * from './StatsigUser';
-export * from './StatsigPlugin';
 export * from './StorageProvider';
 export * from './TypedJsonParse';
 export * from './TypingUtils';

package/src/index.js

@@ -38,8 +38,8 @@ __exportStar(require("./EvaluationTypes"), exports);
 __exportStar(require("./Hashing"), exports);
 __exportStar(require("./InitializeResponse"), exports);
 __exportStar(require("./Log"), exports);
-__exportStar(require("./NetworkCore"), exports);
 __exportStar(require("./NetworkConfig"), exports);
+__exportStar(require("./NetworkCore"), exports);
 __exportStar(require("./OverrideAdapter"), exports);
 __exportStar(require("./ParamStoreTypes"), exports);
 __exportStar(require("./SafeJs"), exports);
@@ -52,10 +52,10 @@ __exportStar(require("./StatsigDataAdapter"), exports);
 __exportStar(require("./StatsigEvent"), exports);
 __exportStar(require("./StatsigMetadata"), exports);
 __exportStar(require("./StatsigOptionsCommon"), exports);
+__exportStar(require("./StatsigPlugin"), exports);
 __exportStar(require("./StatsigTypeFactories"), exports);
 __exportStar(require("./StatsigTypes"), exports);
 __exportStar(require("./StatsigUser"), exports);
-__exportStar(require("./StatsigPlugin"), exports);
 __exportStar(require("./StorageProvider"), exports);
 __exportStar(require("./TypedJsonParse"), exports);
 __exportStar(require("./TypingUtils"), exports);