@statsig/client-core 3.8.3 → 3.9.0

package/package.json

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

package/src/EvaluationOptions.d.ts

@@ -19,3 +19,4 @@ export type ExperimentEvaluationOptions = EvaluationOptionsCommon & {
 };
 export type LayerEvaluationOptions = EvaluationOptionsCommon & {};
 export type ParameterStoreEvaluationOptions = EvaluationOptionsCommon & {};
+export type AnyEvaluationOptions = FeatureGateEvaluationOptions | DynamicConfigEvaluationOptions | ExperimentEvaluationOptions | LayerEvaluationOptions | ParameterStoreEvaluationOptions;

package/src/EventLogger.js

@@ -19,11 +19,11 @@ const StatsigEvent_1 = require("./StatsigEvent");
 const StorageProvider_1 = require("./StorageProvider");
 const UrlConfiguration_1 = require("./UrlConfiguration");
 const VisibilityObserving_1 = require("./VisibilityObserving");
-const DEFAULT_QUEUE_SIZE = 50;
+const DEFAULT_QUEUE_SIZE = 100;
 const DEFAULT_FLUSH_INTERVAL_MS = 10000;
 const MAX_DEDUPER_KEYS = 1000;
-const DEDUPER_WINDOW_DURATION_MS = 60000;
-const MAX_FAILED_LOGS = 500;
+const DEDUPER_WINDOW_DURATION_MS = 600000;
+const MAX_FAILED_LOGS = 1000;
 const QUICK_FLUSH_WINDOW_MS = 200;
 const EVENT_LOGGER_MAP = {};
 const RetryFailedLogsTrigger = {

package/src/MemoKey.d.ts

@@ -0,0 +1,2 @@
+import { AnyEvaluationOptions } from './EvaluationOptions';
+export declare function createMemoKey(name: string, options?: AnyEvaluationOptions): string | undefined;

package/src/MemoKey.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMemoKey = void 0;
+const EXIST_KEYS = new Set([
+// Add keys that should be memoized based only on their existence, not their value
+]);
+const DO_NOT_MEMO_KEYS = new Set([
+    // Add keys that if exist, should not be memoized
+    'userPersistedValues',
+]);
+function createMemoKey(name, options) {
+    let cacheKey = name;
+    if (!options) {
+        return cacheKey;
+    }
+    for (const key of Object.keys(options)) {
+        if (DO_NOT_MEMO_KEYS.has(key)) {
+            return undefined;
+        }
+        if (EXIST_KEYS.has(key)) {
+            cacheKey += `${key}=true`;
+        }
+        else {
+            cacheKey += `${key}=${options[key]}`;
+        }
+    }
+    return cacheKey;
+}
+exports.createMemoKey = createMemoKey;

package/src/NetworkCore.d.ts

@@ -30,6 +30,7 @@ export declare class NetworkCore {
     private readonly _netConfig;
     private readonly _options;
     private readonly _fallbackResolver;
+    private _leakyBucket;
     private _errorBoundary;
     constructor(options: AnyStatsigOptions | null, _emitter?: StatsigClientEmitEventFunc | undefined);
     setErrorBoundary(errorBoundary: ErrorBoundary): void;
@@ -38,6 +39,7 @@ export declare class NetworkCore {
     post(args: RequestArgsWithData): Promise<NetworkResponse | null>;
     get(args: RequestArgs): Promise<NetworkResponse | null>;
     private _sendRequest;
+    private _isRateLimited;
     private _getPopulatedURL;
     private _getPopulatedBody;
     private _attemptToEncodeString;

package/src/NetworkCore.js

@@ -26,6 +26,9 @@ const VisibilityObserving_1 = require("./VisibilityObserving");
 const DEFAULT_TIMEOUT_MS = 10000;
 const BACKOFF_BASE_MS = 500;
 const BACKOFF_MAX_MS = 30000;
+const RATE_LIMIT_WINDOW_MS = 1000;
+const RATE_LIMIT_MAX_REQ_COUNT = 50;
+const LEAK_RATE = RATE_LIMIT_MAX_REQ_COUNT / RATE_LIMIT_WINDOW_MS;
 const RETRYABLE_CODES = new Set([408, 500, 502, 503, 504, 522, 524, 599]);
 class NetworkCore {
     constructor(options, _emitter) {
@@ -33,6 +36,7 @@ class NetworkCore {
         this._timeout = DEFAULT_TIMEOUT_MS;
         this._netConfig = {};
         this._options = {};
+        this._leakyBucket = {};
         this._errorBoundary = null;
         if (options) {
             this._options = options;
@@ -91,6 +95,11 @@ class NetworkCore {
                 return null;
             }
             const { method, body, retries, attempt } = args;
+            const endpoint = args.urlConfig.endpoint;
+            if (this._isRateLimited(endpoint)) {
+                Log_1.Log.warn(`Request to ${endpoint} was blocked because you are making requests too frequently.`);
+                return null;
+            }
             const currentAttempt = attempt !== null && attempt !== void 0 ? attempt : 1;
             const abortController = typeof AbortController !== 'undefined' ? new AbortController() : null;
             const timeoutHandle = setTimeout(() => {
@@ -109,6 +118,11 @@ class NetworkCore {
                     keepalive,
                 };
                 _tryMarkInitStart(args, currentAttempt);
+                const bucket = this._leakyBucket[endpoint];
+                if (bucket) {
+                    bucket.lastRequestTime = Date.now();
+                    this._leakyBucket[endpoint] = bucket;
+                }
                 const func = (_a = this._netConfig.networkOverrideFunc) !== null && _a !== void 0 ? _a : fetch;
                 response = yield func(populatedUrl, config);
                 clearTimeout(timeoutHandle);
@@ -151,6 +165,24 @@ class NetworkCore {
             }
         });
     }
+    _isRateLimited(endpoint) {
+        var _a;
+        const now = Date.now();
+        const bucket = (_a = this._leakyBucket[endpoint]) !== null && _a !== void 0 ? _a : {
+            count: 0,
+            lastRequestTime: now,
+        };
+        const elapsed = now - bucket.lastRequestTime;
+        const leakedRequests = Math.floor(elapsed * LEAK_RATE);
+        bucket.count = Math.max(0, bucket.count - leakedRequests);
+        if (bucket.count >= RATE_LIMIT_MAX_REQ_COUNT) {
+            return true;
+        }
+        bucket.count += 1;
+        bucket.lastRequestTime = now;
+        this._leakyBucket[endpoint] = bucket;
+        return false;
+    }
     _getPopulatedURL(args) {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {

package/src/StatsigClientBase.d.ts

@@ -1,6 +1,6 @@
 import './$_StatsigGlobal';
 import { ErrorBoundary } from './ErrorBoundary';
-import { EvaluationOptionsCommon } from './EvaluationOptions';
+import { AnyEvaluationOptions, EvaluationOptionsCommon } from './EvaluationOptions';
 import { EventLogger } from './EventLogger';
 import { NetworkCore } from './NetworkCore';
 import { OverrideAdapter } from './OverrideAdapter';
@@ -26,6 +26,7 @@ export declare abstract class StatsigClientBase<TAdapter extends EvaluationsData
     protected readonly _errorBoundary: ErrorBoundary;
     protected readonly _logger: EventLogger;
     protected _initializePromise: Promise<void> | null;
+    protected _memoCache: Record<string, unknown>;
     private _listeners;
     constructor(sdkKey: string, adapter: TAdapter, network: NetworkCore, options: AnyStatsigOptions | null);
     /**
@@ -66,5 +67,6 @@ export declare abstract class StatsigClientBase<TAdapter extends EvaluationsData
     $emt(event: AnyStatsigClientEvent): void;
     protected _setStatus(newStatus: StatsigLoadingStatus, values: DataAdapterResult | null): void;
     protected _enqueueExposure(name: string, exposure: StatsigEventInternal, options?: EvaluationOptionsCommon): void;
+    protected _memoize<T, O extends AnyEvaluationOptions>(fn: (name: string, options?: O) => T): (name: string, options?: O) => T;
     protected abstract _primeReadyRipcord(): void;
 }

package/src/StatsigClientBase.js

@@ -15,6 +15,7 @@ const __StatsigGlobal_1 = require("./$_StatsigGlobal");
 const ErrorBoundary_1 = require("./ErrorBoundary");
 const EventLogger_1 = require("./EventLogger");
 const Log_1 = require("./Log");
+const MemoKey_1 = require("./MemoKey");
 const SafeJs_1 = require("./SafeJs");
 const SessionID_1 = require("./SessionID");
 const StorageProvider_1 = require("./StorageProvider");
@@ -32,6 +33,7 @@ class StatsigClientBase {
         (options === null || options === void 0 ? void 0 : options.storageProvider) && StorageProvider_1.Storage._setProvider(options.storageProvider);
         this._sdkKey = sdkKey;
         this._options = options !== null && options !== void 0 ? options : {};
+        this._memoCache = {};
         this.overrideAdapter = (_a = options === null || options === void 0 ? void 0 : options.overrideAdapter) !== null && _a !== void 0 ? _a : null;
         this._logger = new EventLogger_1.EventLogger(sdkKey, emitter, network, options);
         this._errorBoundary = new ErrorBoundary_1.ErrorBoundary(sdkKey, options, emitter);
@@ -134,6 +136,7 @@ class StatsigClientBase {
     }
     _setStatus(newStatus, values) {
         this.loadingStatus = newStatus;
+        this._memoCache = {};
         this.$emt({ name: 'values_updated', status: newStatus, values });
     }
     _enqueueExposure(name, exposure, options) {
@@ -143,6 +146,18 @@ class StatsigClientBase {
         }
         this._logger.enqueue(exposure);
     }
+    _memoize(fn) {
+        return (name, options) => {
+            const memoKey = (0, MemoKey_1.createMemoKey)(name, options);
+            if (!memoKey) {
+                return fn(name, options);
+            }
+            if (!(memoKey in this._memoCache)) {
+                this._memoCache[memoKey] = fn(name, options);
+            }
+            return this._memoCache[memoKey];
+        };
+    }
 }
 exports.StatsigClientBase = StatsigClientBase;
 function _assignGlobalInstance(sdkKey, client) {

package/src/StatsigMetadata.d.ts

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

package/src/StatsigTypes.d.ts

@@ -38,4 +38,4 @@ export type ParameterStore = Flatten<{
     readonly __configuration: ParamStoreConfig | null;
 }>;
 export type AnyConfigBasedStatsigType = DynamicConfig | Experiment | Layer;
-export type AnyStatsigType = FeatureGate | AnyConfigBasedStatsigType;
+export type AnyStatsigType = FeatureGate | AnyConfigBasedStatsigType | ParameterStore;