@splitsoftware/splitio-commons 1.15.1-rc.3 → 1.16.1-rc.0

package/cjs/utils/constants/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MY_SEGMENT = exports.SEGMENT = exports.TOKEN = exports.TELEMETRY = exports.EVENTS = exports.IMPRESSIONS_COUNT = exports.IMPRESSIONS = exports.SPLITS = exports.NONE_ENUM = exports.DEBUG_ENUM = exports.OPTIMIZED_ENUM = exports.CONSUMER_PARTIAL_ENUM = exports.CONSUMER_ENUM = exports.STANDALONE_ENUM = exports.DEDUPED = exports.DROPPED = exports.QUEUED = exports.NAMES_FN_LABEL = exports.SPLITS_FN_LABEL = exports.SPLIT_FN_LABEL = exports.TRACK_FN_LABEL = exports.GET_TREATMENTS_WITH_CONFIG_BY_FLAG_SETS = exports.GET_TREATMENTS_WITH_CONFIG_BY_FLAG_SET = exports.GET_TREATMENTS_BY_FLAG_SETS = exports.GET_TREATMENTS_BY_FLAG_SET = exports.GET_TREATMENTS_WITH_CONFIG = exports.GET_TREATMENT_WITH_CONFIG = exports.GET_TREATMENTS = exports.GET_TREATMENT = exports.CONSENT_UNKNOWN = exports.CONSENT_DECLINED = exports.CONSENT_GRANTED = exports.STORAGE_PLUGGABLE = exports.STORAGE_REDIS = exports.STORAGE_LOCALSTORAGE = exports.STORAGE_MEMORY = exports.CONSUMER_PARTIAL_MODE = exports.CONSUMER_MODE = exports.PRODUCER_MODE = exports.STANDALONE_MODE = exports.LOCALHOST_MODE = exports.NONE = exports.OPTIMIZED = exports.DEBUG = exports.SPLIT_EVENT = exports.SPLIT_IMPRESSION = exports.NA = exports.UNKNOWN = exports.CONTROL_WITH_CONFIG = exports.CONTROL = void 0;
-exports.FLAG_SPEC_VERSION = exports.PAUSED = exports.ENABLED = exports.DISABLED = exports.NON_REQUESTED = exports.REQUESTED = exports.POLLING = exports.STREAMING = exports.AUTH_REJECTION = exports.SYNC_MODE_UPDATE = exports.ABLY_ERROR = exports.TOKEN_REFRESH = exports.SSE_CONNECTION_ERROR = exports.STREAMING_STATUS = exports.OCCUPANCY_SEC = exports.OCCUPANCY_PRI = exports.CONNECTION_ESTABLISHED = exports.TRACK = exports.TREATMENTS_WITH_CONFIG_BY_FLAGSETS = exports.TREATMENTS_WITH_CONFIG_BY_FLAGSET = exports.TREATMENTS_BY_FLAGSETS = exports.TREATMENTS_BY_FLAGSET = exports.TREATMENTS_WITH_CONFIG = exports.TREATMENT_WITH_CONFIG = exports.TREATMENTS = exports.TREATMENT = void 0;
+exports.IN_LARGE_SEGMENT = exports.IN_SEGMENT = exports.FLAG_SPEC_VERSION = exports.PAUSED = exports.ENABLED = exports.DISABLED = exports.NON_REQUESTED = exports.REQUESTED = exports.POLLING = exports.STREAMING = exports.AUTH_REJECTION = exports.SYNC_MODE_UPDATE = exports.ABLY_ERROR = exports.TOKEN_REFRESH = exports.SSE_CONNECTION_ERROR = exports.STREAMING_STATUS = exports.OCCUPANCY_SEC = exports.OCCUPANCY_PRI = exports.CONNECTION_ESTABLISHED = exports.TRACK = exports.TREATMENTS_WITH_CONFIG_BY_FLAGSETS = exports.TREATMENTS_WITH_CONFIG_BY_FLAGSET = exports.TREATMENTS_BY_FLAGSETS = exports.TREATMENTS_BY_FLAGSET = exports.TREATMENTS_WITH_CONFIG = exports.TREATMENT_WITH_CONFIG = exports.TREATMENTS = exports.TREATMENT = exports.MY_LARGE_SEGMENT = void 0;
 // Special treatments
 exports.CONTROL = 'control';
 exports.CONTROL_WITH_CONFIG = {
@@ -65,6 +65,7 @@ exports.TELEMETRY = 'te';
 exports.TOKEN = 'to';
 exports.SEGMENT = 'se';
 exports.MY_SEGMENT = 'ms';
+exports.MY_LARGE_SEGMENT = 'mls';
 exports.TREATMENT = 't';
 exports.TREATMENTS = 'ts';
 exports.TREATMENT_WITH_CONFIG = 'tc';
@@ -91,3 +92,6 @@ exports.DISABLED = 0;
 exports.ENABLED = 1;
 exports.PAUSED = 2;
 exports.FLAG_SPEC_VERSION = '1.1';
+// Matcher types
+exports.IN_SEGMENT = 'IN_SEGMENT';
+exports.IN_LARGE_SEGMENT = 'IN_LARGE_SEGMENT';

package/cjs/utils/settingsValidation/index.js

@@ -30,6 +30,8 @@ exports.base = {
         featuresRefreshRate: 60,
         // fetch segments updates each 60 sec
         segmentsRefreshRate: 60,
+        // fetch large segments updates each 60 sec
+        largeSegmentsRefreshRate: 60,
         // publish telemetry stats each 3600 secs (1 hour)
         telemetryRefreshRate: 3600,
         // publish evaluations each 300 sec (default value for OPTIMIZED impressions mode)
@@ -75,7 +77,8 @@ exports.base = {
         impressionsMode: constants_1.OPTIMIZED,
         localhostMode: undefined,
         enabled: true,
-        flagSpecVersion: constants_1.FLAG_SPEC_VERSION
+        flagSpecVersion: constants_1.FLAG_SPEC_VERSION,
+        largeSegmentsEnabled: false
     },
     // Logger
     log: undefined
@@ -114,6 +117,7 @@ function settingsValidation(config, validationParams) {
     var scheduler = withDefaults.scheduler, startup = withDefaults.startup;
     scheduler.featuresRefreshRate = fromSecondsToMillis(scheduler.featuresRefreshRate);
     scheduler.segmentsRefreshRate = fromSecondsToMillis(scheduler.segmentsRefreshRate);
+    scheduler.largeSegmentsRefreshRate = fromSecondsToMillis(scheduler.largeSegmentsRefreshRate);
     scheduler.offlineRefreshRate = fromSecondsToMillis(scheduler.offlineRefreshRate);
     scheduler.eventsPushRate = fromSecondsToMillis(scheduler.eventsPushRate);
     scheduler.telemetryRefreshRate = fromSecondsToMillis(validateMinValue('telemetryRefreshRate', scheduler.telemetryRefreshRate, 60));
@@ -146,12 +150,12 @@ function settingsValidation(config, validationParams) {
             // Keeping same behaviour than JS SDK: if settings key or TT are invalid,
             // `false` value is used as bound key/TT of the default client, which leads to some issues.
             // @ts-ignore, @TODO handle invalid keys as a non-recoverable error?
-            withDefaults.core.key = (0, key_1.validateKey)(log, maybeKey, 'Client instantiation');
+            withDefaults.core.key = (0, key_1.validateKey)(log, maybeKey, constants_2.LOG_PREFIX_CLIENT_INSTANTIATION);
         }
         if (validationParams.acceptTT) {
             var maybeTT = withDefaults.core.trafficType;
             if (maybeTT !== undefined) { // @ts-ignore
-                withDefaults.core.trafficType = (0, trafficType_1.validateTrafficType)(log, maybeTT, 'Client instantiation');
+                withDefaults.core.trafficType = (0, trafficType_1.validateTrafficType)(log, maybeTT, constants_2.LOG_PREFIX_CLIENT_INSTANTIATION);
             }
         }
     }
@@ -186,10 +190,11 @@ function settingsValidation(config, validationParams) {
     var splitFiltersValidation = (0, splitFilters_1.validateSplitFilters)(log, sync.splitFilters, withDefaults.mode);
     sync.splitFilters = splitFiltersValidation.validFilters;
     sync.__splitFiltersValidation = splitFiltersValidation;
+    // ensure a valid flag spec version
     sync.flagSpecVersion = flagSpec ? flagSpec(withDefaults) : constants_1.FLAG_SPEC_VERSION;
     // ensure a valid user consent value
     // @ts-ignore, modify readonly prop
-    withDefaults.userConsent = consent(withDefaults);
+    withDefaults.userConsent = consent ? consent(withDefaults) : undefined;
     return withDefaults;
 }
 exports.settingsValidation = settingsValidation;

package/esm/evaluator/matchers/index.js

@@ -1,5 +1,6 @@
 import { allMatcherContext } from './all';
 import { segmentMatcherContext } from './segment';
+import { largeSegmentMatcherContext } from './large_segment';
 import { whitelistMatcherContext } from './whitelist';
 import { equalToMatcherContext } from './eq';
 import { greaterThanEqualMatcherContext } from './gte';
@@ -43,7 +44,8 @@ var matchers = [
     greaterThanEqualToSemverMatcherContext,
     lessThanEqualToSemverMatcherContext,
     betweenSemverMatcherContext,
-    inListSemverMatcherContext, // IN_LIST_SEMVER: 22
+    inListSemverMatcherContext,
+    largeSegmentMatcherContext, // IN_LARGE_SEGMENT: 23
 ];
 /**
  * Matcher factory.

package/esm/evaluator/matchers/large_segment.js

@@ -0,0 +1,12 @@
+import { thenable } from '../../utils/promise/thenable';
+export function largeSegmentMatcherContext(largeSegmentName, storage) {
+    return function largeSegmentMatcher(key) {
+        var isInLargeSegment = storage.largeSegments ? storage.largeSegments.isInSegment(largeSegmentName, key) : false;
+        if (thenable(isInLargeSegment)) {
+            isInLargeSegment.then(function (result) {
+                return result;
+            });
+        }
+        return isInLargeSegment;
+    };
+}

package/esm/evaluator/matchers/matcherTypes.js

@@ -22,6 +22,7 @@ export var matcherTypes = {
     LESS_THAN_OR_EQUAL_TO_SEMVER: 20,
     BETWEEN_SEMVER: 21,
     IN_LIST_SEMVER: 22,
+    IN_LARGE_SEGMENT: 23,
 };
 export var matcherDataTypes = {
     BOOLEAN: 'BOOLEAN',

package/esm/evaluator/matchersTransform/index.js

@@ -15,7 +15,7 @@ export function matchersTransform(matchers) {
         // As default input data type we use string (even for ALL_KEYS)
         var dataType = matcherDataTypes.STRING;
         var value = undefined;
-        if (type === matcherTypes.IN_SEGMENT) {
+        if (type === matcherTypes.IN_SEGMENT || type === matcherTypes.IN_LARGE_SEGMENT) {
             value = segmentTransform(userDefinedSegmentMatcherData);
         }
         else if (type === matcherTypes.EQUAL_TO) {

package/esm/logger/constants.js

@@ -35,7 +35,6 @@ export var IMPRESSION = 102;
 export var IMPRESSION_QUEUEING = 103;
 export var NEW_SHARED_CLIENT = 104;
 export var NEW_FACTORY = 105;
-export var POLLING_SMART_PAUSING = 106;
 export var POLLING_START = 107;
 export var POLLING_STOP = 108;
 export var SYNC_SPLITS_FETCH_RETRY = 109;
@@ -116,6 +115,7 @@ export var ENGINE_MATCHER_ERROR = 329;
 // Log prefixes (a.k.a. tags or categories)
 export var LOG_PREFIX_SETTINGS = 'settings';
 export var LOG_PREFIX_INSTANTIATION = 'Factory instantiation';
+export var LOG_PREFIX_CLIENT_INSTANTIATION = 'Client instantiation';
 export var LOG_PREFIX_ENGINE = 'engine';
 export var LOG_PREFIX_ENGINE_COMBINER = LOG_PREFIX_ENGINE + ':combiner: ';
 export var LOG_PREFIX_ENGINE_MATCHER = LOG_PREFIX_ENGINE + ':matcher: ';

package/esm/logger/messages/info.js

@@ -16,7 +16,6 @@ export var codesInfo = codesWarn.concat([
     [c.USER_CONSENT_NOT_UPDATED, 'UserConsent: call had no effect because it was the current consent status (%s).'],
     [c.USER_CONSENT_INITIAL, 'Starting the SDK with %s user consent. No data will be sent.'],
     // synchronizer
-    [c.POLLING_SMART_PAUSING, c.LOG_PREFIX_SYNC_POLLING + 'Turning segments data polling %s.'],
     [c.POLLING_START, c.LOG_PREFIX_SYNC_POLLING + 'Starting polling'],
     [c.POLLING_STOP, c.LOG_PREFIX_SYNC_POLLING + 'Stopping polling'],
     [c.SYNC_SPLITS_FETCH_RETRY, c.LOG_PREFIX_SYNC_SPLITS + 'Retrying download of feature flags #%s. Reason: %s'],

package/esm/readiness/readinessManager.js

@@ -23,10 +23,11 @@ function segmentsEventEmitterFactory(EventEmitter) {
 /**
  * Factory of readiness manager, which handles the ready / update event propagation.
  */
-export function readinessManagerFactory(EventEmitter, readyTimeout, splits) {
-    if (readyTimeout === void 0) { readyTimeout = 0; }
+export function readinessManagerFactory(EventEmitter, settings, splits) {
     if (splits === void 0) { splits = splitsEventEmitterFactory(EventEmitter); }
+    var _a = settings.startup, readyTimeout = _a.readyTimeout, waitForLargeSegments = _a.waitForLargeSegments, largeSegmentsEnabled = settings.sync.largeSegmentsEnabled;
     var segments = segmentsEventEmitterFactory(EventEmitter);
+    var largeSegments = largeSegmentsEnabled && waitForLargeSegments ? segmentsEventEmitterFactory(EventEmitter) : undefined;
     var gate = new EventEmitter();
     // emit SDK_READY_FROM_CACHE
     var isReadyFromCache = false;
@@ -50,6 +51,8 @@ export function readinessManagerFactory(EventEmitter, readyTimeout, splits) {
     var isReady = false;
     splits.on(SDK_SPLITS_ARRIVED, checkIsReadyOrUpdate);
     segments.on(SDK_SEGMENTS_ARRIVED, checkIsReadyOrUpdate);
+    if (largeSegments)
+        largeSegments.on(SDK_SEGMENTS_ARRIVED, checkIsReadyOrUpdate);
     var isDestroyed = false;
     function checkIsReadyFromCache() {
         isReadyFromCache = true;
@@ -75,7 +78,7 @@ export function readinessManagerFactory(EventEmitter, readyTimeout, splits) {
             }
         }
         else {
-            if (splits.splitsArrived && segments.segmentsArrived) {
+            if (splits.splitsArrived && segments.segmentsArrived && (!largeSegments || largeSegments.segmentsArrived)) {
                 clearTimeout(readyTimeoutId);
                 isReady = true;
                 try {
@@ -92,11 +95,11 @@ export function readinessManagerFactory(EventEmitter, readyTimeout, splits) {
     return {
         splits: splits,
         segments: segments,
+        largeSegments: largeSegments,
         gate: gate,
-        shared: function (readyTimeout) {
-            if (readyTimeout === void 0) { readyTimeout = 0; }
+        shared: function () {
             refCount++;
-            return readinessManagerFactory(EventEmitter, readyTimeout, splits);
+            return readinessManagerFactory(EventEmitter, settings, splits);
         },
         // @TODO review/remove next methods when non-recoverable errors are reworked
         // Called on consumer mode, when storage fails to connect
@@ -107,6 +110,8 @@ export function readinessManagerFactory(EventEmitter, readyTimeout, splits) {
         destroy: function () {
             isDestroyed = true;
             segments.removeAllListeners();
+            if (largeSegments)
+                largeSegments.removeAllListeners();
             gate.removeAllListeners();
             clearTimeout(readyTimeoutId);
             if (refCount > 0)

package/esm/readiness/sdkReadinessManager.js

@@ -12,9 +12,9 @@ var REMOVE_LISTENER_EVENT = 'removeListener';
  * @param readyTimeout time in millis to emit SDK_READY_TIME_OUT event
  * @param readinessManager optional readinessManager to use. only used internally for `shared` method
  */
-export function sdkReadinessManagerFactory(log, EventEmitter, readyTimeout, readinessManager) {
-    if (readyTimeout === void 0) { readyTimeout = 0; }
-    if (readinessManager === void 0) { readinessManager = readinessManagerFactory(EventEmitter, readyTimeout); }
+export function sdkReadinessManagerFactory(EventEmitter, settings, readinessManager) {
+    if (readinessManager === void 0) { readinessManager = readinessManagerFactory(EventEmitter, settings); }
+    var log = settings.log;
     /** Ready callback warning */
     var internalReadyCbCount = 0;
     var readyCbCount = 0;
@@ -57,9 +57,8 @@ export function sdkReadinessManagerFactory(log, EventEmitter, readyTimeout, read
     }
     return {
         readinessManager: readinessManager,
-        shared: function (readyTimeout) {
-            if (readyTimeout === void 0) { readyTimeout = 0; }
-            return sdkReadinessManagerFactory(log, EventEmitter, readyTimeout, readinessManager.shared(readyTimeout));
+        shared: function () {
+            return sdkReadinessManagerFactory(EventEmitter, settings, readinessManager.shared());
         },
         incInternalReadyCbCount: function () {
             internalReadyCbCount++;

package/esm/sdkClient/sdkClientMethodCS.js

@@ -3,19 +3,18 @@ import { validateKey } from '../utils/inputValidation/key';
 import { getMatching, keyParser } from '../utils/key';
 import { sdkClientFactory } from './sdkClient';
 import { objectAssign } from '../utils/lang/objectAssign';
-import { RETRIEVE_CLIENT_DEFAULT, NEW_SHARED_CLIENT, RETRIEVE_CLIENT_EXISTING } from '../logger/constants';
+import { RETRIEVE_CLIENT_DEFAULT, NEW_SHARED_CLIENT, RETRIEVE_CLIENT_EXISTING, LOG_PREFIX_CLIENT_INSTANTIATION } from '../logger/constants';
 import { SDK_SEGMENTS_ARRIVED } from '../readiness/constants';
 function buildInstanceId(key) {
     // @ts-ignore
     return (key.matchingKey ? key.matchingKey : key) + "-" + (key.bucketingKey ? key.bucketingKey : key) + "-";
 }
-var method = 'Client instantiation';
 /**
  * Factory of client method for the client-side API variant where TT is ignored.
  * Therefore, clients don't have a bound TT for the track method.
  */
 export function sdkClientMethodCSFactory(params) {
-    var storage = params.storage, syncManager = params.syncManager, sdkReadinessManager = params.sdkReadinessManager, _a = params.settings, key = _a.core.key, readyTimeout = _a.startup.readyTimeout, log = _a.log;
+    var storage = params.storage, syncManager = params.syncManager, sdkReadinessManager = params.sdkReadinessManager, _a = params.settings, key = _a.core.key, log = _a.log;
     var mainClientInstance = clientCSDecorator(log, sdkClientFactory(params), key);
     var parsedDefaultKey = keyParser(key);
     var defaultInstanceId = buildInstanceId(parsedDefaultKey);
@@ -28,14 +27,14 @@ export function sdkClientMethodCSFactory(params) {
             return mainClientInstance;
         }
         // Validate the key value. The trafficType (2nd argument) is ignored
-        var validKey = validateKey(log, key, method);
+        var validKey = validateKey(log, key, LOG_PREFIX_CLIENT_INSTANTIATION);
         if (validKey === false) {
             throw new Error('Shared Client needs a valid key.');
         }
         var instanceId = buildInstanceId(validKey);
         if (!clientInstances[instanceId]) {
             var matchingKey = getMatching(validKey);
-            var sharedSdkReadiness_1 = sdkReadinessManager.shared(readyTimeout);
+            var sharedSdkReadiness_1 = sdkReadinessManager.shared();
             var sharedStorage = storage.shared && storage.shared(matchingKey, function (err) {
                 if (err) {
                     sharedSdkReadiness_1.readinessManager.timeout();

package/esm/sdkClient/sdkClientMethodCSWithTT.js

@@ -4,20 +4,19 @@ import { validateTrafficType } from '../utils/inputValidation/trafficType';
 import { getMatching, keyParser } from '../utils/key';
 import { sdkClientFactory } from './sdkClient';
 import { objectAssign } from '../utils/lang/objectAssign';
-import { RETRIEVE_CLIENT_DEFAULT, NEW_SHARED_CLIENT, RETRIEVE_CLIENT_EXISTING } from '../logger/constants';
+import { RETRIEVE_CLIENT_DEFAULT, NEW_SHARED_CLIENT, RETRIEVE_CLIENT_EXISTING, LOG_PREFIX_CLIENT_INSTANTIATION } from '../logger/constants';
 import { SDK_SEGMENTS_ARRIVED } from '../readiness/constants';
 function buildInstanceId(key, trafficType) {
     // @ts-ignore
     return (key.matchingKey ? key.matchingKey : key) + "-" + (key.bucketingKey ? key.bucketingKey : key) + "-" + (trafficType !== undefined ? trafficType : '');
 }
-var method = 'Client instantiation';
 /**
  * Factory of client method for the client-side (browser) variant of the Isomorphic JS SDK,
  * where clients can have a bound TT for the track method, which is provided via the settings
  * (default client) or the client method (shared clients).
  */
 export function sdkClientMethodCSFactory(params) {
-    var storage = params.storage, syncManager = params.syncManager, sdkReadinessManager = params.sdkReadinessManager, _a = params.settings, _b = _a.core, key = _b.key, trafficType = _b.trafficType, readyTimeout = _a.startup.readyTimeout, log = _a.log;
+    var storage = params.storage, syncManager = params.syncManager, sdkReadinessManager = params.sdkReadinessManager, _a = params.settings, _b = _a.core, key = _b.key, trafficType = _b.trafficType, log = _a.log;
     var mainClientInstance = clientCSDecorator(log, sdkClientFactory(params), key, trafficType);
     var parsedDefaultKey = keyParser(key);
     var defaultInstanceId = buildInstanceId(parsedDefaultKey, trafficType);
@@ -30,13 +29,13 @@ export function sdkClientMethodCSFactory(params) {
             return mainClientInstance;
         }
         // Validate the key value
-        var validKey = validateKey(log, key, "Shared " + method);
+        var validKey = validateKey(log, key, LOG_PREFIX_CLIENT_INSTANTIATION);
         if (validKey === false) {
             throw new Error('Shared Client needs a valid key.');
         }
         var validTrafficType;
         if (trafficType !== undefined) {
-            validTrafficType = validateTrafficType(log, trafficType, "Shared " + method);
+            validTrafficType = validateTrafficType(log, trafficType, LOG_PREFIX_CLIENT_INSTANTIATION);
             if (validTrafficType === false) {
                 throw new Error('Shared Client needs a valid traffic type or no traffic type at all.');
             }
@@ -44,7 +43,7 @@ export function sdkClientMethodCSFactory(params) {
         var instanceId = buildInstanceId(validKey, validTrafficType);
         if (!clientInstances[instanceId]) {
             var matchingKey = getMatching(validKey);
-            var sharedSdkReadiness_1 = sdkReadinessManager.shared(readyTimeout);
+            var sharedSdkReadiness_1 = sdkReadinessManager.shared();
             var sharedStorage = storage.shared && storage.shared(matchingKey, function (err) {
                 if (err) {
                     sharedSdkReadiness_1.readinessManager.timeout();

package/esm/sdkFactory/index.js

@@ -22,7 +22,7 @@ export function sdkFactory(params) {
     // On non-recoverable errors, we should mark the SDK as destroyed and not start synchronization.
     // We will just log and allow for the SDK to end up throwing an SDK_TIMEOUT event for devs to handle.
     validateAndTrackApiKey(log, settings.core.authorizationKey);
-    var sdkReadinessManager = sdkReadinessManagerFactory(log, platform.EventEmitter, settings.startup.readyTimeout);
+    var sdkReadinessManager = sdkReadinessManagerFactory(platform.EventEmitter, settings);
     var readiness = sdkReadinessManager.readinessManager;
     var storage = storageFactory({
         settings: settings,

package/esm/services/splitApi.js

@@ -1,6 +1,6 @@
 import { splitHttpClientFactory } from './splitHttpClient';
 import { objectAssign } from '../utils/lang/objectAssign';
-import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MY_SEGMENT } from '../utils/constants';
+import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MY_SEGMENT, MY_LARGE_SEGMENT } from '../utils/constants';
 import { ERROR_TOO_MANY_SETS } from '../logger/constants';
 var noCacheHeaderOptions = { headers: { 'Cache-Control': 'no-cache' } };
 function userKeyToQueryParam(userKey) {
@@ -61,6 +61,10 @@ export function splitApiFactory(settings, platform, telemetryTracker) {
             var url = urls.sdk + "/mySegments/" + encodeURIComponent(userMatchingKey);
             return splitHttpClient(url, noCache ? noCacheHeaderOptions : undefined, telemetryTracker.trackHttp(MY_SEGMENT));
         },
+        fetchMyLargeSegments: function (userMatchingKey, noCache) {
+            var url = urls.sdk + "/myLargeSegments/" + encodeURIComponent(userMatchingKey);
+            return splitHttpClient(url, noCache ? noCacheHeaderOptions : undefined, telemetryTracker.trackHttp(MY_LARGE_SEGMENT));
+        },
         /**
          * Post events.
          *

package/esm/storages/AbstractSplitsCacheAsync.js

@@ -6,9 +6,9 @@ import { objectAssign } from '../utils/lang/objectAssign';
 var AbstractSplitsCacheAsync = /** @class */ (function () {
     function AbstractSplitsCacheAsync() {
     }
-    // @TODO revisit segment-related methods ('usesSegments', 'getRegisteredSegments', 'registerSegments')
+    // @TODO revisit segment-related methods ('usesMatcher', 'getRegisteredSegments', 'registerSegments')
     // noop, just keeping the interface. This is used by standalone client-side API only, and so only implemented by InMemory and InLocalStorage.
-    AbstractSplitsCacheAsync.prototype.usesSegments = function () {
+    AbstractSplitsCacheAsync.prototype.usesMatcher = function () {
         return Promise.resolve(true);
     };
     /**

package/esm/storages/AbstractSplitsCacheSync.js

@@ -59,14 +59,14 @@ var AbstractSplitsCacheSync = /** @class */ (function () {
 export { AbstractSplitsCacheSync };
 /**
  * Given a parsed split, it returns a boolean flagging if its conditions use segments matchers (rules & whitelists).
- * This util is intended to simplify the implementation of `splitsCache::usesSegments` method
+ * This util is intended to simplify the implementation of `splitsCache::usesMatcher` method
  */
-export function usesSegments(split) {
+export function usesMatcher(split, matcherType) {
     var conditions = split.conditions || [];
     for (var i = 0; i < conditions.length; i++) {
         var matchers = conditions[i].matcherGroup.matchers;
         for (var j = 0; j < matchers.length; j++) {
-            if (matchers[j].matcherType === 'IN_SEGMENT')
+            if (matchers[j].matcherType === matcherType)
                 return true;
         }
     }

package/esm/storages/KeyBuilder.js

@@ -36,6 +36,9 @@ var KeyBuilder = /** @class */ (function () {
     KeyBuilder.prototype.buildSplitsWithSegmentCountKey = function () {
         return this.prefix + ".splits.usingSegments";
     };
+    KeyBuilder.prototype.buildSplitsWithLargeSegmentCountKey = function () {
+        return this.prefix + ".splits.usingLargeSegments";
+    };
     KeyBuilder.prototype.buildSegmentNameKey = function (segmentName) {
         return this.prefix + ".segment." + segmentName;
     };

package/esm/storages/KeyBuilderCS.js

@@ -21,10 +21,6 @@ var KeyBuilderCS = /** @class */ (function (_super) {
             return builtSegmentKeyName.substr(prefix.length);
     };
     // @BREAKING: The key used to start with the matching key instead of the prefix, this was changed on version 10.17.3
-    KeyBuilderCS.prototype.buildOldSegmentNameKey = function (segmentName) {
-        return this.matchingKey + "." + this.prefix + ".segment." + segmentName;
-    };
-    // @BREAKING: The key used to start with the matching key instead of the prefix, this was changed on version 10.17.3
     KeyBuilderCS.prototype.extractOldSegmentKey = function (builtSegmentKeyName) {
         var prefix = this.matchingKey + "." + this.prefix + ".segment.";
         if (startsWith(builtSegmentKeyName, prefix))
@@ -39,3 +35,18 @@ var KeyBuilderCS = /** @class */ (function (_super) {
     return KeyBuilderCS;
 }(KeyBuilder));
 export { KeyBuilderCS };
+export function myLargeSegmentsKeyBuilder(prefix, matchingKey) {
+    return {
+        buildSegmentNameKey: function (segmentName) {
+            return prefix + "." + matchingKey + ".largeSegment." + segmentName;
+        },
+        extractSegmentName: function (builtSegmentKeyName) {
+            var p = prefix + "." + matchingKey + ".largeSegment.";
+            if (startsWith(builtSegmentKeyName, p))
+                return builtSegmentKeyName.substr(p.length);
+        },
+        extractOldSegmentKey: function () {
+            return undefined;
+        }
+    };
+}

package/esm/storages/inLocalStorage/SplitsCacheInLocal.js

@@ -1,9 +1,10 @@
 import { __extends } from "tslib";
-import { AbstractSplitsCacheSync, usesSegments } from '../AbstractSplitsCacheSync';
+import { AbstractSplitsCacheSync, usesMatcher } from '../AbstractSplitsCacheSync';
 import { isFiniteNumber, toNumber, isNaNNumber } from '../../utils/lang';
 import { LOG_PREFIX } from './constants';
 import { _Set, setToArray } from '../../utils/lang/sets';
 import { getStorageHash } from '../KeyBuilder';
+import { IN_LARGE_SEGMENT, IN_SEGMENT } from '../../utils/constants';
 /**
  * ISplitsCacheSync implementation that stores split definitions in browser LocalStorage.
  */
@@ -37,10 +38,14 @@ var SplitsCacheInLocal = /** @class */ (function (_super) {
             if (split) {
                 var ttKey = this.keys.buildTrafficTypeKey(split.trafficTypeName);
                 this._decrementCount(ttKey);
-                if (usesSegments(split)) {
+                if (usesMatcher(split, IN_SEGMENT)) {
                     var segmentsCountKey = this.keys.buildSplitsWithSegmentCountKey();
                     this._decrementCount(segmentsCountKey);
                 }
+                if (usesMatcher(split, IN_LARGE_SEGMENT)) {
+                    var segmentsCountKey = this.keys.buildSplitsWithLargeSegmentCountKey();
+                    this._decrementCount(segmentsCountKey);
+                }
             }
         }
         catch (e) {
@@ -53,11 +58,16 @@ var SplitsCacheInLocal = /** @class */ (function (_super) {
                 var ttKey = this.keys.buildTrafficTypeKey(split.trafficTypeName);
                 // @ts-expect-error
                 localStorage.setItem(ttKey, toNumber(localStorage.getItem(ttKey)) + 1);
-                if (usesSegments(split)) {
+                if (usesMatcher(split, IN_SEGMENT)) {
                     var segmentsCountKey = this.keys.buildSplitsWithSegmentCountKey();
                     // @ts-expect-error
                     localStorage.setItem(segmentsCountKey, toNumber(localStorage.getItem(segmentsCountKey)) + 1);
                 }
+                if (usesMatcher(split, IN_LARGE_SEGMENT)) {
+                    var segmentsCountKey = this.keys.buildSplitsWithLargeSegmentCountKey();
+                    // @ts-expect-error
+                    localStorage.setItem(segmentsCountKey, toNumber(localStorage.getItem(segmentsCountKey)) + 1);
+                }
             }
         }
         catch (e) {
@@ -170,11 +180,13 @@ var SplitsCacheInLocal = /** @class */ (function (_super) {
         var ttCount = toNumber(localStorage.getItem(this.keys.buildTrafficTypeKey(trafficType)));
         return isFiniteNumber(ttCount) && ttCount > 0;
     };
-    SplitsCacheInLocal.prototype.usesSegments = function () {
+    SplitsCacheInLocal.prototype.usesMatcher = function (matcherType) {
         // If cache hasn't been synchronized with the cloud, assume we need them.
         if (!this.hasSync)
             return true;
-        var storedCount = localStorage.getItem(this.keys.buildSplitsWithSegmentCountKey());
+        var storedCount = localStorage.getItem(matcherType === IN_SEGMENT ?
+            this.keys.buildSplitsWithSegmentCountKey() :
+            this.keys.buildSplitsWithLargeSegmentCountKey());
         var splitsWithSegmentsCount = storedCount === null ? 0 : toNumber(storedCount);
         if (isFiniteNumber(splitsWithSegmentsCount)) {
             return splitsWithSegmentsCount > 0;

package/esm/storages/inLocalStorage/index.js

@@ -2,7 +2,7 @@ import { ImpressionsCacheInMemory } from '../inMemory/ImpressionsCacheInMemory';
 import { ImpressionCountsCacheInMemory } from '../inMemory/ImpressionCountsCacheInMemory';
 import { EventsCacheInMemory } from '../inMemory/EventsCacheInMemory';
 import { validatePrefix } from '../KeyBuilder';
-import { KeyBuilderCS } from '../KeyBuilderCS';
+import { KeyBuilderCS, myLargeSegmentsKeyBuilder } from '../KeyBuilderCS';
 import { isLocalStorageAvailable } from '../../utils/env/isLocalStorageAvailable';
 import { SplitsCacheInLocal } from './SplitsCacheInLocal';
 import { MySegmentsCacheInLocal } from './MySegmentsCacheInLocal';
@@ -33,9 +33,11 @@ export function InLocalStorage(options) {
         var expirationTimestamp = Date.now() - DEFAULT_CACHE_EXPIRATION_IN_MILLIS;
         var splits = new SplitsCacheInLocal(settings, keys, expirationTimestamp);
         var segments = new MySegmentsCacheInLocal(log, keys);
+        var largeSegments = new MySegmentsCacheInLocal(log, myLargeSegmentsKeyBuilder(prefix, matchingKey));
         return {
             splits: splits,
             segments: segments,
+            largeSegments: largeSegments,
             impressions: new ImpressionsCacheInMemory(impressionsQueueSize),
             impressionCounts: impressionsMode !== DEBUG ? new ImpressionCountsCacheInMemory() : undefined,
             events: new EventsCacheInMemory(eventsQueueSize),
@@ -45,6 +47,7 @@ export function InLocalStorage(options) {
                 var _a;
                 this.splits = new SplitsCacheInMemory(__splitFiltersValidation);
                 this.segments = new MySegmentsCacheInMemory();
+                this.largeSegments = new MySegmentsCacheInMemory();
                 this.impressions.clear();
                 this.impressionCounts && this.impressionCounts.clear();
                 this.events.clear();
@@ -52,10 +55,10 @@ export function InLocalStorage(options) {
             },
             // When using shared instanciation with MEMORY we reuse everything but segments (they are customer per key).
             shared: function (matchingKey) {
-                var childKeysBuilder = new KeyBuilderCS(prefix, matchingKey);
                 return {
                     splits: this.splits,
-                    segments: new MySegmentsCacheInLocal(log, childKeysBuilder),
+                    segments: new MySegmentsCacheInLocal(log, new KeyBuilderCS(prefix, matchingKey)),
+                    largeSegments: new MySegmentsCacheInLocal(log, myLargeSegmentsKeyBuilder(prefix, matchingKey)),
                     impressions: this.impressions,
                     impressionCounts: this.impressionCounts,
                     events: this.events,
@@ -63,6 +66,7 @@ export function InLocalStorage(options) {
                     destroy: function () {
                         this.splits = new SplitsCacheInMemory(__splitFiltersValidation);
                         this.segments = new MySegmentsCacheInMemory();
+                        this.largeSegments = new MySegmentsCacheInMemory();
                     }
                 };
             },

package/esm/storages/inMemory/InMemoryStorageCS.js

@@ -15,9 +15,11 @@ export function InMemoryStorageCSFactory(params) {
     var _a = params.settings, _b = _a.scheduler, impressionsQueueSize = _b.impressionsQueueSize, eventsQueueSize = _b.eventsQueueSize, _c = _a.sync, impressionsMode = _c.impressionsMode, __splitFiltersValidation = _c.__splitFiltersValidation;
     var splits = new SplitsCacheInMemory(__splitFiltersValidation);
     var segments = new MySegmentsCacheInMemory();
+    var largeSegments = new MySegmentsCacheInMemory();
     var storage = {
         splits: splits,
         segments: segments,
+        largeSegments: largeSegments,
         impressions: new ImpressionsCacheInMemory(impressionsQueueSize),
         impressionCounts: impressionsMode !== DEBUG ? new ImpressionCountsCacheInMemory() : undefined,
         events: new EventsCacheInMemory(eventsQueueSize),
@@ -27,6 +29,7 @@ export function InMemoryStorageCSFactory(params) {
         destroy: function () {
             this.splits.clear();
             this.segments.clear();
+            this.largeSegments.clear();
             this.impressions.clear();
             this.impressionCounts && this.impressionCounts.clear();
             this.events.clear();
@@ -37,6 +40,7 @@ export function InMemoryStorageCSFactory(params) {
             return {
                 splits: this.splits,
                 segments: new MySegmentsCacheInMemory(),
+                largeSegments: new MySegmentsCacheInMemory(),
                 impressions: this.impressions,
                 impressionCounts: this.impressionCounts,
                 events: this.events,
@@ -45,6 +49,7 @@ export function InMemoryStorageCSFactory(params) {
                 destroy: function () {
                     this.splits = new SplitsCacheInMemory(__splitFiltersValidation);
                     this.segments.clear();
+                    this.largeSegments.clear();
                 }
             };
         },