@splitsoftware/splitio-commons 2.2.1-rc.5 → 2.3.1-rc.0

package/CHANGES.txt

@@ -1,8 +1,12 @@
-2.3.0 (May 12, 2025)
+2.4.0 (May 20, 2025)
  - Added support for targeting rules based on rule-based segments.
+ - Added support for feature flag prerequisites.
+
+2.3.0 (May 16, 2025)
  - Updated the Redis storage to:
     - Avoid lazy require of the `ioredis` dependency when the SDK is initialized, and
     - Flag the SDK as ready from cache immediately to allow queueing feature flag evaluations before SDK_READY event is emitted (Reverted in v1.7.0).
+ - Bugfix - Enhanced HTTP client module to implement timeouts for failing requests that might otherwise remain pending indefinitely on some Fetch API implementations.
 
 2.2.0 (March 28, 2025)
  - Added a new optional argument to the client `getTreatment` methods to allow passing additional evaluation options, such as a map of properties to append to the generated impressions sent to Split backend. Read more in our docs.
@@ -15,21 +19,21 @@
  - Added support for the new impressions tracking toggle available on feature flags, both respecting the setting and including the new field being returned on `SplitView` type objects. Read more in our docs.
 
 2.0.3 (January 9, 2025)
- - Bugfixing - Properly handle rejected promises when using targeting rules with segment matchers in consumer modes (e.g., Redis and Pluggable storages).
+ - Bugfix - Properly handle rejected promises when using targeting rules with segment matchers in consumer modes (e.g., Redis and Pluggable storages).
 
 2.0.2 (December 3, 2024)
  - Updated the factory `init` and `destroy` methods to support re-initialization after destruction. This update ensures compatibility of the React SDK with React Strict Mode, where the factory's `init` and `destroy` effects are executed an extra time to validate proper resource cleanup.
- - Bugfixing - Sanitize the `SplitSDKMachineName` header value to avoid exceptions on HTTP/S requests when it contains non ISO-8859-1 characters (Related to issue https://github.com/splitio/javascript-client/issues/847).
+ - Bugfix - Sanitize the `SplitSDKMachineName` header value to avoid exceptions on HTTP/S requests when it contains non ISO-8859-1 characters (Related to issue https://github.com/splitio/javascript-client/issues/847).
 
 2.0.1 (November 25, 2024)
- - Bugfixing - Fixed an issue with the SDK_UPDATE event on server-side, where it was not being emitted if there was an empty segment and the SDK received a feature flag update notification.
+ - Bugfix - Fixed an issue with the SDK_UPDATE event on server-side, where it was not being emitted if there was an empty segment and the SDK received a feature flag update notification.
 
 2.0.0 (November 1, 2024)
  - Added support for targeting rules based on large segments.
  - Added `factory.destroy()` method, which invokes the `destroy` method on all SDK clients created by the factory.
  - Added `SplitIO` namespace with the public TypeScript definitions to be reused by the SDKs.
  - Updated the handling of timers and async operations inside an `init` factory method to enable lazy initialization of the SDK in standalone mode. This update is intended for the React SDK.
- - Bugfixing - Fixed an issue with the server-side polling manager that caused dangling timers when the SDK was destroyed before it was ready.
+ - Bugfix - Fixed an issue with the server-side polling manager that caused dangling timers when the SDK was destroyed before it was ready.
  - BREAKING CHANGES:
    - Updated default flag spec version to 1.2, which requires Split Proxy v5.9.0 or higher.
    - Removed `/mySegments` endpoint from SplitAPI module, as it is replaced by `/memberships` endpoint.
@@ -48,8 +52,8 @@
 1.16.0 (June 13, 2024)
  - Added the `getOptions` method to the `IPlatform` interface to allow the SDK to pass request options to the `fetch` function and `EventSource` constructor when fetching data from the Split servers. The method is optional and, if provided, it is called twice: first for the `fetch` options and then for the `EventSource` options. Useful for advanced use cases like configuring a proxy or validating HTTPS certificates in Node.js.
  - Updated the Redis storage to lazily import the `ioredis` dependency when the storage is created. This prevents errors when the SDK is imported or bundled in a .mjs file, as `ioredis` is a CommonJS module.
- - Bugfixing - Restored some input validation error logs that were removed in version 1.12.0. The logs inform the user when the `getTreatment(s)` methods are called with an invalid value as feature flag name or flag set name.
- - Bugfixing - Fixed localhost mode to emit SDK_UPDATE when mocked feature flags are updated in the `features` object map of the config object (Related to issue https://github.com/splitio/javascript-browser-client/issues/119).
+ - Bugfix - Restored some input validation error logs that were removed in version 1.12.0. The logs inform the user when the `getTreatment(s)` methods are called with an invalid value as feature flag name or flag set name.
+ - Bugfix - Fixed localhost mode to emit SDK_UPDATE when mocked feature flags are updated in the `features` object map of the config object (Related to issue https://github.com/splitio/javascript-browser-client/issues/119).
 
 1.15.0 (May 13, 2024)
  - Added an optional settings validation parameter to let overwrite the default flag spec version, used by the JS Synchronizer.
@@ -67,13 +71,13 @@
 
 1.12.1 (December 12, 2023)
  - Updated PluggableStorage, for producer mode, and LocalStorage, for standalone mode, to clear the storage before initiating the synchronization process if it was previously synchronized with a different SDK key (i.e., a different environment) or different Split Filter criteria.
- - Bugfixing - Fixed an issue when tracking telemetry latencies for the new `getTreatmentsByFlagSet(s)` methods in Redis and Pluggable storages, which was causing the SDK to not track those stats.
+ - Bugfix - Fixed an issue when tracking telemetry latencies for the new `getTreatmentsByFlagSet(s)` methods in Redis and Pluggable storages, which was causing the SDK to not track those stats.
 
 1.12.0 (December 4, 2023)
  - Added support for Flag Sets in "consumer" and "partial consumer" modes for Pluggable and Redis storages.
  - Updated evaluation flow to log a warning when using flag sets that don't contain cached feature flags.
  - Updated Redis adapter to handle timeouts and queueing of some missing commands: 'hincrby', 'popNRaw', and 'pipeline.exec'.
- - Bugfixing - Fixed manager methods in consumer modes to return results in a promise when the SDK is not operational (not ready or destroyed).
+ - Bugfix - Fixed manager methods in consumer modes to return results in a promise when the SDK is not operational (not ready or destroyed).
 
 1.11.0 (November 3, 2023)
  - Added support for Flag Sets on the SDK, which enables grouping feature flags and interacting with the group rather than individually (more details in our documentation):
@@ -83,7 +87,7 @@
    - Added a new optional Split Filter configuration option. This allows the SDK and Split services to only synchronize the flags in the specified flag sets, avoiding unused or unwanted flags from being synced on the SDK instance, bringing all the benefits from a reduced payload.
      - Note: Only applicable when the SDK is in charge of the rollout data synchronization. When not applicable, the SDK will log a warning on init.
    - Added `sets` property to the `SplitView` object returned by the `split` and `splits` methods of the SDK manager to expose flag sets on flag views.
- - Bugfixing - Fixed SDK key validation in Node.js to ensure the SDK_READY_TIMED_OUT event is emitted when a client-side type SDK key is provided instead of a server-side one (Related to issue https://github.com/splitio/javascript-client/issues/768).
+ - Bugfix - Fixed SDK key validation in Node.js to ensure the SDK_READY_TIMED_OUT event is emitted when a client-side type SDK key is provided instead of a server-side one (Related to issue https://github.com/splitio/javascript-client/issues/768).
 
 1.10.0 (October 20, 2023)
  - Added `defaultTreatment` property to the `SplitView` object returned by the `split` and `splits` methods of the SDK manager (Related to issue https://github.com/splitio/javascript-commons/issues/225).
@@ -102,7 +106,7 @@
 1.8.3 (June 29, 2023)
  - Updated some transitive dependencies for vulnerability fixes.
  - Updated SDK_READY_TIMED_OUT event to be emitted immediately when a connection error occurs using pluggable storage (i.e., when the wrapper `connect` promise is rejected) in consumer and partial consumer modes.
- - Bugfixing - The `destroy` method has been updated to immediately flag the SDK client as destroyed, to prevent unexpected behaviours when `getTreatment` and `track` methods are called synchronously after `destroy` method is called.
+ - Bugfix - The `destroy` method has been updated to immediately flag the SDK client as destroyed, to prevent unexpected behaviours when `getTreatment` and `track` methods are called synchronously after `destroy` method is called.
 
 1.8.2 (May 15, 2023)
  - Updated terminology on the SDKs codebase to be more aligned with current standard without causing a breaking change. The core change is the term split for feature flag on things like logs and IntelliSense comments.
@@ -118,10 +122,10 @@
 1.7.3 (December 16, 2022)
  - Updated unique keys cache for Redis and Pluggable storages to optimize the usage of the underlying storage.
  - Updated some transitive dependencies for vulnerability fixes.
- - Bugfixing - Updated events and impressions cache in localhost mode in order to avoid memory leaks (Related to issue https://github.com/splitio/javascript-commons/issues/181).
+ - Bugfix - Updated events and impressions cache in localhost mode in order to avoid memory leaks (Related to issue https://github.com/splitio/javascript-commons/issues/181).
 
 1.7.2 (October 14, 2022)
- - Bugfixing - Handle `Navigator.sendBeacon` API exceptions in the browser, and fallback to regular Fetch/XHR transport in case of error.
+ - Bugfix - Handle `Navigator.sendBeacon` API exceptions in the browser, and fallback to regular Fetch/XHR transport in case of error.
 
 1.7.1 (October 5, 2022)
  - Updated default value of `scheduler.featuresRefreshRate` config parameter to 60 seconds.
@@ -139,7 +143,7 @@
  - Added `autoRequire` configuration option to the Google Analytics to Split integration, which takes care of requiring the splitTracker plugin on trackers dynamically created by Google tag managers (See https://help.split.io/hc/en-us/articles/360040838752#set-up-with-gtm-and-gtag.js).
  - Updated browser listener to push remaining impressions and events on 'visibilitychange' and 'pagehide' DOM events, instead of 'unload', which is not reliable in modern mobile and desktop Web browsers.
  - Updated the synchronization flow to be more reliable in the event of an edge case generating delay in cache purge propagation, keeping the SDK cache properly synced.
- - Bugfixing - Removed js-yaml dependency to avoid resolution to an incompatible version on certain npm versions when installing third-party dependencies that also define js-yaml as transitive dependency (Related to issue https://github.com/splitio/javascript-client/issues/662).
+ - Bugfix - Removed js-yaml dependency to avoid resolution to an incompatible version on certain npm versions when installing third-party dependencies that also define js-yaml as transitive dependency (Related to issue https://github.com/splitio/javascript-client/issues/662).
 
 1.5.0 (June 29, 2022)
  - Added a new config option to control the tasks that listen or poll for updates on feature flags and segments, via the new config `sync.enabled`. Running online, Split SDK will always pull the most recent updates upon initialization, this only affects updates fetching on a running instance. Useful when a consistent session experience is a must or to save resources when updates are not being used.
@@ -147,16 +151,16 @@
  - Updated submitters logic, to avoid duplicating the post of impressions to Split cloud when the SDK is destroyed while its periodic post of impressions is running.
 
 1.4.1 (June 13, 2022)
- - Bugfixing - Updated submitters logic, to avoid dropping impressions and events that are being tracked while POST request is pending.
+ - Bugfix - Updated submitters logic, to avoid dropping impressions and events that are being tracked while POST request is pending.
 
 1.4.0 (May 24, 2022)
  - Added `scheduler.telemetryRefreshRate` property to SDK configuration, and deprecated `scheduler.metricsRefreshRate` property.
  - Updated SDK telemetry storage, metrics and updater to be more effective and send less often.
- - Bugfixing - Updated default values for `scheduler.impressionsRefreshRate` config parameter: 300s for OPTIMIZED impression mode and 60s for DEBUG impression mode.
+ - Bugfix - Updated default values for `scheduler.impressionsRefreshRate` config parameter: 300s for OPTIMIZED impression mode and 60s for DEBUG impression mode.
 
 1.3.1 (April 19, 2022)
- - Bugfixing - Added peer dependencies to avoid issues when requiring some third-party dependencies used by modules of the package (Related to issue https://github.com/splitio/javascript-client/issues/662).
- - Bugfixing - Updated `ready` method to rejects the promise with an Error object instead of a string value (Related to issue https://github.com/splitio/javascript-client/issues/654).
+ - Bugfix - Added peer dependencies to avoid issues when requiring some third-party dependencies used by modules of the package (Related to issue https://github.com/splitio/javascript-client/issues/662).
+ - Bugfix - Updated `ready` method to rejects the promise with an Error object instead of a string value (Related to issue https://github.com/splitio/javascript-client/issues/654).
 
 1.3.0 (April 6, 2022)
  - Added user consent feature to allow delaying or disabling the data tracking from SDK until user consent is explicitly granted or declined. Read more in our docs.
@@ -165,12 +169,12 @@
  - Updated format for MySegments keys in LocalStorage, keeping backwards compatibility (issue https://github.com/splitio/javascript-client/issues/638).
  - Updated some modules due to general polishing and refactors, including updates in some log messages.
  - Updated some dependencies for vulnerability fixes.
- - Bugfixing - Updated internal isObject utility function, to avoid unexpected behaviors on frameworks and libraries that uses multiple VM contexts, like NuxtJS dev server.
- - Bugfixing - Fixed validation of `core.key` SDK configuration param, to parse it into a string and log a warning when passing a number (Related to issue https://github.com/splitio/react-native-client/issues/19).
- - Bugfixing - Fixed validation of `sync.impressionsMode` SDK configuration param, to avoid an exception on SplitFactory instantiation when passing a non-string value.
- - Bugfixing - Fixed an issue with `connectionTimeout` options params of Redis storage, that was being ignored and not passed down to the underlying ioredis client.
- - Bugfixing - Fixed streaming synchronization issue with multiple clients.
- - Bugfixing - Fixed issue with internal Map ponyfill that results in logger not working properly on IE11 browser.
+ - Bugfix - Updated internal isObject utility function, to avoid unexpected behaviors on frameworks and libraries that uses multiple VM contexts, like NuxtJS dev server.
+ - Bugfix - Fixed validation of `core.key` SDK configuration param, to parse it into a string and log a warning when passing a number (Related to issue https://github.com/splitio/react-native-client/issues/19).
+ - Bugfix - Fixed validation of `sync.impressionsMode` SDK configuration param, to avoid an exception on SplitFactory instantiation when passing a non-string value.
+ - Bugfix - Fixed an issue with `connectionTimeout` options params of Redis storage, that was being ignored and not passed down to the underlying ioredis client.
+ - Bugfix - Fixed streaming synchronization issue with multiple clients.
+ - Bugfix - Fixed issue with internal Map ponyfill that results in logger not working properly on IE11 browser.
 
 1.2.0 (January 19, 2022)
  - Added support to SDK clients on browser to optionally bind attributes to the client, keeping these loaded within the SDK along with the user ID, for easier usage when requesting flag.
@@ -180,7 +184,7 @@
   customers to implement this caching with any storage technology of choice and connect it to the SDK instance to be used instead of its default in-memory storage.
  - Updated multiple modules due to general polishing and improvements, including the replacement of default exports with named exports, to avoid runtime errors with some particular configurations of Webpack projects.
  - Updated ioredis dependency for vulnerability fixes.
- - Bugfixing - Fixed issue returning dynamic configs if treatment name contains a dot (".").
+ - Bugfix - Fixed issue returning dynamic configs if treatment name contains a dot (".").
 
 1.0.0 (October 20, 2021)
  - BREAKING CHANGE on multiple modules due to general polishing, improvements and bug fixes. In most cases the change is to use named exports. This affected mostly modules related with synchronization and storages.

package/cjs/evaluator/Engine.js

@@ -1,79 +1,58 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Engine = void 0;
+exports.engineParser = void 0;
 var lang_1 = require("../utils/lang");
 var parser_1 = require("./parser");
 var key_1 = require("../utils/key");
 var thenable_1 = require("../utils/promise/thenable");
 var labels_1 = require("../utils/labels");
 var constants_1 = require("../utils/constants");
+var constants_2 = require("../logger/constants");
+var prerequisites_1 = require("./matchers/prerequisites");
 function evaluationResult(result, defaultTreatment) {
     return {
         treatment: (0, lang_1.get)(result, 'treatment', defaultTreatment),
         label: (0, lang_1.get)(result, 'label', labels_1.NO_CONDITION_MATCH)
     };
 }
-var Engine = /** @class */ (function () {
-    function Engine(baseInfo, evaluator) {
-        this.baseInfo = baseInfo;
-        this.evaluator = evaluator;
-        // in case we don't have a default treatment in the instantiation, use 'control'
-        if (typeof this.baseInfo.defaultTreatment !== 'string') {
-            this.baseInfo.defaultTreatment = constants_1.CONTROL;
-        }
-    }
-    Engine.parse = function (log, splitFlatStructure, storage) {
-        var conditions = splitFlatStructure.conditions;
-        var evaluator = (0, parser_1.parser)(log, conditions, storage);
-        return new Engine(splitFlatStructure, evaluator);
-    };
-    Engine.prototype.getKey = function () {
-        return this.baseInfo.name;
-    };
-    Engine.prototype.getTreatment = function (key, attributes, splitEvaluator) {
-        var _a = this.baseInfo, killed = _a.killed, seed = _a.seed, defaultTreatment = _a.defaultTreatment, trafficAllocation = _a.trafficAllocation, trafficAllocationSeed = _a.trafficAllocationSeed;
-        var parsedKey;
-        var treatment;
-        var label;
-        try {
-            parsedKey = (0, key_1.keyParser)(key);
-        }
-        catch (err) {
-            return {
-                treatment: constants_1.CONTROL,
-                label: labels_1.EXCEPTION
-            };
-        }
-        if (this.isGarbage()) {
-            treatment = constants_1.CONTROL;
-            label = labels_1.SPLIT_ARCHIVED;
-        }
-        else if (killed) {
-            treatment = defaultTreatment;
-            label = labels_1.SPLIT_KILLED;
-        }
-        else {
-            var evaluation = this.evaluator(parsedKey, seed, trafficAllocation, trafficAllocationSeed, attributes, splitEvaluator);
-            // Evaluation could be async, so we should handle that case checking for a
-            // thenable object
-            if ((0, thenable_1.thenable)(evaluation)) {
-                return evaluation.then(function (result) { return evaluationResult(result, defaultTreatment); });
+function engineParser(log, split, storage) {
+    var killed = split.killed, seed = split.seed, trafficAllocation = split.trafficAllocation, trafficAllocationSeed = split.trafficAllocationSeed, status = split.status, conditions = split.conditions, prerequisites = split.prerequisites;
+    var defaultTreatment = (0, lang_1.isString)(split.defaultTreatment) ? split.defaultTreatment : constants_1.CONTROL;
+    var evaluator = (0, parser_1.parser)(log, conditions, storage);
+    var prerequisiteMatcher = (0, prerequisites_1.prerequisitesMatcherContext)(prerequisites, storage, log);
+    return {
+        getTreatment: function (key, attributes, splitEvaluator) {
+            var parsedKey = (0, key_1.keyParser)(key);
+            function evaluate(prerequisitesMet) {
+                if (!prerequisitesMet) {
+                    log.debug(constants_2.ENGINE_DEFAULT, ['Prerequisite not met']);
+                    return {
+                        treatment: defaultTreatment,
+                        label: labels_1.PREREQUISITES_NOT_MET
+                    };
+                }
+                var evaluation = evaluator(parsedKey, seed, trafficAllocation, trafficAllocationSeed, attributes, splitEvaluator);
+                return (0, thenable_1.thenable)(evaluation) ?
+                    evaluation.then(function (result) { return evaluationResult(result, defaultTreatment); }) :
+                    evaluationResult(evaluation, defaultTreatment);
             }
-            else {
-                return evaluationResult(evaluation, defaultTreatment);
+            if (status === 'ARCHIVED')
+                return {
+                    treatment: constants_1.CONTROL,
+                    label: labels_1.SPLIT_ARCHIVED
+                };
+            if (killed) {
+                log.debug(constants_2.ENGINE_DEFAULT, ['Flag is killed']);
+                return {
+                    treatment: defaultTreatment,
+                    label: labels_1.SPLIT_KILLED
+                };
             }
+            var prerequisitesMet = prerequisiteMatcher({ key: key, attributes: attributes }, splitEvaluator);
+            return (0, thenable_1.thenable)(prerequisitesMet) ?
+                prerequisitesMet.then(evaluate) :
+                evaluate(prerequisitesMet);
         }
-        return {
-            treatment: treatment,
-            label: label
-        };
-    };
-    Engine.prototype.isGarbage = function () {
-        return this.baseInfo.status === 'ARCHIVED';
     };
-    Engine.prototype.getChangeNumber = function () {
-        return this.baseInfo.changeNumber;
-    };
-    return Engine;
-}());
-exports.Engine = Engine;
+}
+exports.engineParser = engineParser;

package/cjs/evaluator/index.js

@@ -97,19 +97,19 @@ function getEvaluation(log, key, splitJSON, attributes, storage) {
         config: null
     };
     if (splitJSON) {
-        var split_1 = Engine_1.Engine.parse(log, splitJSON, storage);
-        evaluation = split_1.getTreatment(key, attributes, evaluateFeature);
+        var split = (0, Engine_1.engineParser)(log, splitJSON, storage);
+        evaluation = split.getTreatment(key, attributes, evaluateFeature);
         // If the storage is async and the evaluated flag uses segments or dependencies, evaluation is thenable
         if ((0, thenable_1.thenable)(evaluation)) {
             return evaluation.then(function (result) {
-                result.changeNumber = split_1.getChangeNumber();
+                result.changeNumber = splitJSON.changeNumber;
                 result.config = splitJSON.configurations && splitJSON.configurations[result.treatment] || null;
                 result.impressionsDisabled = splitJSON.impressionsDisabled;
                 return result;
             });
         }
         else {
-            evaluation.changeNumber = split_1.getChangeNumber(); // Always sync and optional
+            evaluation.changeNumber = splitJSON.changeNumber;
             evaluation.config = splitJSON.configurations && splitJSON.configurations[evaluation.treatment] || null;
             evaluation.impressionsDisabled = splitJSON.impressionsDisabled;
         }

package/cjs/evaluator/matchers/prerequisites.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prerequisitesMatcherContext = void 0;
+var thenable_1 = require("../../utils/promise/thenable");
+function prerequisitesMatcherContext(prerequisites, storage, log) {
+    if (prerequisites === void 0) { prerequisites = []; }
+    return function prerequisitesMatcher(_a, splitEvaluator) {
+        var key = _a.key, attributes = _a.attributes;
+        function evaluatePrerequisite(prerequisite) {
+            var evaluation = splitEvaluator(log, key, prerequisite.n, attributes, storage);
+            return (0, thenable_1.thenable)(evaluation) ?
+                evaluation.then(function (evaluation) { return prerequisite.ts.indexOf(evaluation.treatment) !== -1; }) :
+                prerequisite.ts.indexOf(evaluation.treatment) !== -1;
+        }
+        return prerequisites.reduce(function (prerequisitesMet, prerequisite) {
+            return (0, thenable_1.thenable)(prerequisitesMet) ?
+                prerequisitesMet.then(function (prerequisitesMet) { return prerequisitesMet ? evaluatePrerequisite(prerequisite) : false; }) :
+                prerequisitesMet ? evaluatePrerequisite(prerequisite) : false;
+        }, true);
+    };
+}
+exports.prerequisitesMatcherContext = prerequisitesMatcherContext;

package/cjs/logger/constants.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENGINE_VALUE_NO_ATTRIBUTES = exports.ENGINE_VALUE_INVALID = exports.USER_CONSENT_INITIAL = exports.USER_CONSENT_NOT_UPDATED = exports.USER_CONSENT_UPDATED = exports.IMPRESSIONS_TRACKER_SUCCESS = exports.EVENTS_TRACKER_SUCCESS = exports.SYNC_STOP_POLLING = exports.SYNC_CONTINUE_POLLING = exports.SYNC_START_POLLING = exports.SUBMITTERS_PUSH = exports.SUBMITTERS_PUSH_FULL_QUEUE = exports.STREAMING_DISCONNECTING = exports.STREAMING_DISABLED = exports.STREAMING_CONNECTING = exports.STREAMING_RECONNECT = exports.STREAMING_REFRESH_TOKEN = exports.SYNC_SPLITS_FETCH_RETRY = exports.POLLING_STOP = exports.POLLING_START = exports.POLLING_SMART_PAUSING = exports.NEW_FACTORY = exports.NEW_SHARED_CLIENT = exports.IMPRESSION_QUEUEING = exports.IMPRESSION = exports.CLIENT_READY = exports.CLIENT_READY_FROM_CACHE = exports.ENGINE_MATCHER_RESULT = exports.SETTINGS_SPLITS_FILTER = exports.SYNC_TASK_STOP = exports.SYNC_TASK_EXECUTE = exports.SYNC_TASK_START = exports.STREAMING_NEW_MESSAGE = exports.SYNC_RBS_UPDATE = exports.SYNC_SPLITS_UPDATE = exports.SYNC_SPLITS_FETCH = exports.SYNC_OFFLINE_DATA = exports.RETRIEVE_MANAGER = exports.RETRIEVE_CLIENT_EXISTING = exports.RETRIEVE_CLIENT_DEFAULT = exports.CLEANUP_DEREGISTERING = exports.CLEANUP_REGISTERING = exports.ENGINE_SANITIZE = exports.ENGINE_VALUE = exports.ENGINE_MATCHER_DEPENDENCY_PRE = exports.ENGINE_MATCHER_DEPENDENCY = exports.ENGINE_BUCKET = exports.ENGINE_COMBINER_IFELSEIF_NO_TREATMENT = exports.ENGINE_COMBINER_IFELSEIF = exports.ENGINE_COMBINER_AND = void 0;
-exports.ERROR_HTTP = exports.ERROR_INVALID_CONFIG_PARAM = exports.ERROR_EMPTY_ARRAY = exports.ERROR_EMPTY = exports.ERROR_INVALID = exports.ERROR_INVALID_KEY_OBJECT = exports.ERROR_TOO_LONG = exports.ERROR_NULL = exports.ERROR_CLIENT_DESTROYED = exports.ERROR_NOT_FINITE = exports.ERROR_SIZE_EXCEEDED = exports.ERROR_NOT_PLAIN_OBJECT = exports.ERROR_EVENT_TYPE_FORMAT = exports.ERROR_EVENTS_TRACKER = exports.ERROR_IMPRESSIONS_LISTENER = exports.ERROR_IMPRESSIONS_TRACKER = exports.ERROR_STREAMING_AUTH = exports.ERROR_STREAMING_SSE = exports.ERROR_SYNC_OFFLINE_LOADING = exports.ERROR_CLIENT_CANNOT_GET_READY = exports.ERROR_CLIENT_LISTENER = exports.ERROR_LOGLEVEL_INVALID = exports.ERROR_ENGINE_COMBINER_IFELSEIF = exports.WARN_FLAGSET_WITHOUT_FLAGS = exports.WARN_FLAGSET_NOT_CONFIGURED = exports.WARN_LOWERCASE_FLAGSET = exports.WARN_INVALID_FLAGSET = exports.STREAMING_PARSING_SPLIT_UPDATE = exports.STREAMING_PARSING_MEMBERSHIPS_UPDATE = exports.WARN_SDK_KEY = exports.WARN_SPLITS_FILTER_EMPTY = exports.WARN_SPLITS_FILTER_INVALID = exports.WARN_SPLITS_FILTER_IGNORED = exports.WARN_INTEGRATION_INVALID = exports.WARN_NOT_EXISTENT_TT = exports.WARN_LOWERCASE_TRAFFIC_TYPE = exports.WARN_NOT_EXISTENT_SPLIT = exports.WARN_TRIMMING = exports.WARN_CONVERTING = exports.WARN_TRIMMING_PROPERTIES = exports.WARN_SETTING_NULL = exports.SUBMITTERS_PUSH_RETRY = exports.SUBMITTERS_PUSH_FAILS = exports.STREAMING_FALLBACK = exports.STREAMING_PARSING_MESSAGE_FAILS = exports.STREAMING_PARSING_ERROR_FAILS = exports.SYNC_SPLITS_FETCH_FAILS = exports.SYNC_MYSEGMENTS_FETCH_RETRY = exports.CLIENT_NOT_READY = exports.CLIENT_NO_LISTENER = void 0;
-exports.LOG_PREFIX_CLEANUP = exports.LOG_PREFIX_UNIQUE_KEYS_TRACKER = exports.LOG_PREFIX_EVENTS_TRACKER = exports.LOG_PREFIX_IMPRESSIONS_TRACKER = exports.LOG_PREFIX_SYNC_SUBMITTERS = exports.LOG_PREFIX_SYNC_POLLING = exports.LOG_PREFIX_SYNC_MYSEGMENTS = exports.LOG_PREFIX_SYNC_SEGMENTS = exports.LOG_PREFIX_SYNC_SPLITS = exports.LOG_PREFIX_SYNC_STREAMING = exports.LOG_PREFIX_SYNC_OFFLINE = exports.LOG_PREFIX_SYNC_MANAGER = exports.LOG_PREFIX_SYNC = exports.LOG_PREFIX_ENGINE_VALUE = exports.LOG_PREFIX_ENGINE_MATCHER = exports.LOG_PREFIX_ENGINE_COMBINER = exports.LOG_PREFIX_ENGINE = exports.LOG_PREFIX_CLIENT_INSTANTIATION = exports.LOG_PREFIX_INSTANTIATION = exports.LOG_PREFIX_SETTINGS = exports.ENGINE_MATCHER_ERROR = exports.ERROR_SETS_FILTER_EXCLUSIVE = exports.ERROR_TOO_MANY_SETS = exports.ERROR_MIN_CONFIG_PARAM = exports.ERROR_NOT_BOOLEAN = exports.ERROR_STORAGE_INVALID = void 0;
+exports.ENGINE_VALUE_INVALID = exports.USER_CONSENT_INITIAL = exports.USER_CONSENT_NOT_UPDATED = exports.USER_CONSENT_UPDATED = exports.IMPRESSIONS_TRACKER_SUCCESS = exports.EVENTS_TRACKER_SUCCESS = exports.SYNC_STOP_POLLING = exports.SYNC_CONTINUE_POLLING = exports.SYNC_START_POLLING = exports.SUBMITTERS_PUSH = exports.SUBMITTERS_PUSH_FULL_QUEUE = exports.STREAMING_DISCONNECTING = exports.STREAMING_DISABLED = exports.STREAMING_CONNECTING = exports.STREAMING_RECONNECT = exports.STREAMING_REFRESH_TOKEN = exports.SYNC_SPLITS_FETCH_RETRY = exports.POLLING_STOP = exports.POLLING_START = exports.POLLING_SMART_PAUSING = exports.NEW_FACTORY = exports.NEW_SHARED_CLIENT = exports.IMPRESSION_QUEUEING = exports.IMPRESSION = exports.CLIENT_READY = exports.CLIENT_READY_FROM_CACHE = exports.ENGINE_DEFAULT = exports.ENGINE_MATCHER_RESULT = exports.SETTINGS_SPLITS_FILTER = exports.SYNC_TASK_STOP = exports.SYNC_TASK_EXECUTE = exports.SYNC_TASK_START = exports.STREAMING_NEW_MESSAGE = exports.SYNC_RBS_UPDATE = exports.SYNC_SPLITS_UPDATE = exports.SYNC_SPLITS_FETCH = exports.SYNC_OFFLINE_DATA = exports.RETRIEVE_MANAGER = exports.RETRIEVE_CLIENT_EXISTING = exports.RETRIEVE_CLIENT_DEFAULT = exports.CLEANUP_DEREGISTERING = exports.CLEANUP_REGISTERING = exports.ENGINE_SANITIZE = exports.ENGINE_VALUE = exports.ENGINE_MATCHER_DEPENDENCY_PRE = exports.ENGINE_MATCHER_DEPENDENCY = exports.ENGINE_BUCKET = exports.ENGINE_COMBINER_IFELSEIF_NO_TREATMENT = exports.ENGINE_COMBINER_IFELSEIF = exports.ENGINE_COMBINER_AND = void 0;
+exports.ERROR_INVALID_CONFIG_PARAM = exports.ERROR_EMPTY_ARRAY = exports.ERROR_EMPTY = exports.ERROR_INVALID = exports.ERROR_INVALID_KEY_OBJECT = exports.ERROR_TOO_LONG = exports.ERROR_NULL = exports.ERROR_CLIENT_DESTROYED = exports.ERROR_NOT_FINITE = exports.ERROR_SIZE_EXCEEDED = exports.ERROR_NOT_PLAIN_OBJECT = exports.ERROR_EVENT_TYPE_FORMAT = exports.ERROR_EVENTS_TRACKER = exports.ERROR_IMPRESSIONS_LISTENER = exports.ERROR_IMPRESSIONS_TRACKER = exports.ERROR_STREAMING_AUTH = exports.ERROR_STREAMING_SSE = exports.ERROR_SYNC_OFFLINE_LOADING = exports.ERROR_CLIENT_CANNOT_GET_READY = exports.ERROR_CLIENT_LISTENER = exports.ERROR_LOGLEVEL_INVALID = exports.ERROR_ENGINE_COMBINER_IFELSEIF = exports.WARN_FLAGSET_WITHOUT_FLAGS = exports.WARN_FLAGSET_NOT_CONFIGURED = exports.WARN_LOWERCASE_FLAGSET = exports.WARN_INVALID_FLAGSET = exports.STREAMING_PARSING_SPLIT_UPDATE = exports.STREAMING_PARSING_MEMBERSHIPS_UPDATE = exports.WARN_SDK_KEY = exports.WARN_SPLITS_FILTER_EMPTY = exports.WARN_SPLITS_FILTER_INVALID = exports.WARN_SPLITS_FILTER_IGNORED = exports.WARN_INTEGRATION_INVALID = exports.WARN_NOT_EXISTENT_TT = exports.WARN_LOWERCASE_TRAFFIC_TYPE = exports.WARN_NOT_EXISTENT_SPLIT = exports.WARN_TRIMMING = exports.WARN_CONVERTING = exports.WARN_TRIMMING_PROPERTIES = exports.WARN_SETTING_NULL = exports.SUBMITTERS_PUSH_RETRY = exports.SUBMITTERS_PUSH_FAILS = exports.STREAMING_FALLBACK = exports.STREAMING_PARSING_MESSAGE_FAILS = exports.STREAMING_PARSING_ERROR_FAILS = exports.SYNC_SPLITS_FETCH_FAILS = exports.SYNC_MYSEGMENTS_FETCH_RETRY = exports.CLIENT_NOT_READY = exports.CLIENT_NO_LISTENER = exports.ENGINE_VALUE_NO_ATTRIBUTES = void 0;
+exports.LOG_PREFIX_CLEANUP = exports.LOG_PREFIX_UNIQUE_KEYS_TRACKER = exports.LOG_PREFIX_EVENTS_TRACKER = exports.LOG_PREFIX_IMPRESSIONS_TRACKER = exports.LOG_PREFIX_SYNC_SUBMITTERS = exports.LOG_PREFIX_SYNC_POLLING = exports.LOG_PREFIX_SYNC_MYSEGMENTS = exports.LOG_PREFIX_SYNC_SEGMENTS = exports.LOG_PREFIX_SYNC_SPLITS = exports.LOG_PREFIX_SYNC_STREAMING = exports.LOG_PREFIX_SYNC_OFFLINE = exports.LOG_PREFIX_SYNC_MANAGER = exports.LOG_PREFIX_SYNC = exports.LOG_PREFIX_ENGINE_VALUE = exports.LOG_PREFIX_ENGINE_MATCHER = exports.LOG_PREFIX_ENGINE_COMBINER = exports.LOG_PREFIX_ENGINE = exports.LOG_PREFIX_CLIENT_INSTANTIATION = exports.LOG_PREFIX_INSTANTIATION = exports.LOG_PREFIX_SETTINGS = exports.ENGINE_MATCHER_ERROR = exports.ERROR_SETS_FILTER_EXCLUSIVE = exports.ERROR_TOO_MANY_SETS = exports.ERROR_MIN_CONFIG_PARAM = exports.ERROR_NOT_BOOLEAN = exports.ERROR_STORAGE_INVALID = exports.ERROR_HTTP = void 0;
 /**
  * Message codes used to trim string log messages from commons and client-side API modules,
  * in order to reduce the minimal SDK size for Browser and eventually other client-side environments.
@@ -33,6 +33,7 @@ exports.SYNC_TASK_EXECUTE = 37;
 exports.SYNC_TASK_STOP = 38;
 exports.SETTINGS_SPLITS_FILTER = 39;
 exports.ENGINE_MATCHER_RESULT = 40;
+exports.ENGINE_DEFAULT = 41;
 exports.CLIENT_READY_FROM_CACHE = 100;
 exports.CLIENT_READY = 101;
 exports.IMPRESSION = 102;

package/cjs/logger/messages/debug.js

@@ -15,6 +15,7 @@ exports.codesDebug = info_1.codesInfo.concat([
     [c.ENGINE_VALUE, c.LOG_PREFIX_ENGINE_VALUE + 'Extracted attribute `%s`. %s will be used for matching.'],
     [c.ENGINE_SANITIZE, c.LOG_PREFIX_ENGINE + ':sanitize: Attempted to sanitize %s which should be of type %s. Sanitized and processed value => %s'],
     [c.ENGINE_MATCHER_RESULT, c.LOG_PREFIX_ENGINE_MATCHER + '[%s] Result: %s. Rule value: %s. Evaluation value: %s'],
+    [c.ENGINE_DEFAULT, c.LOG_PREFIX_ENGINE + 'Evaluates to default treatment. %s'],
     // SDK
     [c.CLEANUP_REGISTERING, c.LOG_PREFIX_CLEANUP + 'Registering cleanup handler %s'],
     [c.CLEANUP_DEREGISTERING, c.LOG_PREFIX_CLEANUP + 'Deregistering cleanup handler %s'],
@@ -24,8 +25,8 @@ exports.codesDebug = info_1.codesInfo.concat([
     // synchronizer
     [c.SYNC_OFFLINE_DATA, c.LOG_PREFIX_SYNC_OFFLINE + 'Feature flags data: \n%s'],
     [c.SYNC_SPLITS_FETCH, c.LOG_PREFIX_SYNC_SPLITS + 'Spin up feature flags update using since = %s and rbSince = %s.'],
-    [c.SYNC_SPLITS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New feature flags %s. Removed feature flags %s.'],
-    [c.SYNC_RBS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New rule-based segments %s. Removed rule-based segments %s.'],
+    [c.SYNC_SPLITS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New feature flags: %s. Removed feature flags: %s.'],
+    [c.SYNC_RBS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New rule-based segments: %s. Removed rule-based segments: %s.'],
     [c.STREAMING_NEW_MESSAGE, c.LOG_PREFIX_SYNC_STREAMING + 'New SSE message received, with data: %s.'],
     [c.SYNC_TASK_START, c.LOG_PREFIX_SYNC + ': Starting %s. Running each %s millis'],
     [c.SYNC_TASK_EXECUTE, c.LOG_PREFIX_SYNC + ': Running %s'],

package/cjs/sdkManager/index.js

@@ -29,7 +29,8 @@ function objectToView(splitObject) {
         configs: splitObject.configurations || {},
         sets: splitObject.sets || [],
         defaultTreatment: splitObject.defaultTreatment,
-        impressionsDisabled: splitObject.impressionsDisabled === true
+        impressionsDisabled: splitObject.impressionsDisabled === true,
+        prerequisites: (splitObject.prerequisites || []).map(function (p) { return ({ flagName: p.n, treatments: p.ts }); }),
     };
 }
 function objectsToViews(splitObjects) {

package/cjs/services/splitHttpClient.js

@@ -5,6 +5,7 @@ var objectAssign_1 = require("../utils/lang/objectAssign");
 var constants_1 = require("../logger/constants");
 var decorateHeaders_1 = require("./decorateHeaders");
 var timeout_1 = require("../utils/promise/timeout");
+var PENDING_FETCH_ERROR_TIMEOUT = 100;
 var messageNoFetch = 'Global fetch API is not available.';
 /**
  * Factory of Split HTTP clients, which are HTTP clients with predefined headers for Split endpoints.
@@ -44,8 +45,8 @@ function splitHttpClientFactory(settings, _a) {
             // https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#Checking_that_the_fetch_was_successful
             .then(function (response) {
             if (!response.ok) {
-                // timeout after 100ms because `text()` promise doesn't settle in some implementations and cases (e.g. no content)
-                return (0, timeout_1.timeout)(100, response.text()).then(function (message) { return Promise.reject({ response: response, message: message }); }, function () { return Promise.reject({ response: response }); });
+                // timeout since `text()` promise might not settle in some fetch implementations and cases (e.g. no content)
+                return (0, timeout_1.timeout)(PENDING_FETCH_ERROR_TIMEOUT, response.text()).then(function (message) { return Promise.reject({ response: response, message: message }); }, function () { return Promise.reject({ response: response }); });
             }
             latencyTracker();
             return response;

package/cjs/sync/polling/fetchers/splitChangesFetcher.js

@@ -41,7 +41,7 @@ function splitChangesFetcherFactory(fetchSplitChanges, settings, storage) {
         return splitsPromise
             .then(function (resp) { return resp.json(); })
             .then(function (data) {
-            // Using flag spec version 1.2
+            // Using flag spec version 1.2 or below
             if (data.splits) {
                 return {
                     ff: {

package/cjs/utils/labels/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNSUPPORTED_MATCHER_TYPE = exports.NOT_IN_SPLIT = exports.SPLIT_ARCHIVED = exports.EXCEPTION = exports.SDK_NOT_READY = exports.SPLIT_NOT_FOUND = exports.NO_CONDITION_MATCH = exports.SPLIT_KILLED = void 0;
+exports.PREREQUISITES_NOT_MET = exports.UNSUPPORTED_MATCHER_TYPE = exports.NOT_IN_SPLIT = exports.SPLIT_ARCHIVED = exports.EXCEPTION = exports.SDK_NOT_READY = exports.SPLIT_NOT_FOUND = exports.NO_CONDITION_MATCH = exports.SPLIT_KILLED = void 0;
 exports.SPLIT_KILLED = 'killed';
 exports.NO_CONDITION_MATCH = 'default rule';
 exports.SPLIT_NOT_FOUND = 'definition not found';
@@ -9,3 +9,4 @@ exports.EXCEPTION = 'exception';
 exports.SPLIT_ARCHIVED = 'archived';
 exports.NOT_IN_SPLIT = 'not in split';
 exports.UNSUPPORTED_MATCHER_TYPE = 'targeting rule type unsupported by sdk';
+exports.PREREQUISITES_NOT_MET = 'prerequisites not met';

package/esm/evaluator/Engine.js

@@ -1,76 +1,54 @@
-import { get } from '../utils/lang';
+import { get, isString } from '../utils/lang';
 import { parser } from './parser';
 import { keyParser } from '../utils/key';
 import { thenable } from '../utils/promise/thenable';
-import { EXCEPTION, NO_CONDITION_MATCH, SPLIT_ARCHIVED, SPLIT_KILLED } from '../utils/labels';
+import { NO_CONDITION_MATCH, SPLIT_ARCHIVED, SPLIT_KILLED, PREREQUISITES_NOT_MET } from '../utils/labels';
 import { CONTROL } from '../utils/constants';
+import { ENGINE_DEFAULT } from '../logger/constants';
+import { prerequisitesMatcherContext } from './matchers/prerequisites';
 function evaluationResult(result, defaultTreatment) {
     return {
         treatment: get(result, 'treatment', defaultTreatment),
         label: get(result, 'label', NO_CONDITION_MATCH)
     };
 }
-var Engine = /** @class */ (function () {
-    function Engine(baseInfo, evaluator) {
-        this.baseInfo = baseInfo;
-        this.evaluator = evaluator;
-        // in case we don't have a default treatment in the instantiation, use 'control'
-        if (typeof this.baseInfo.defaultTreatment !== 'string') {
-            this.baseInfo.defaultTreatment = CONTROL;
-        }
-    }
-    Engine.parse = function (log, splitFlatStructure, storage) {
-        var conditions = splitFlatStructure.conditions;
-        var evaluator = parser(log, conditions, storage);
-        return new Engine(splitFlatStructure, evaluator);
-    };
-    Engine.prototype.getKey = function () {
-        return this.baseInfo.name;
-    };
-    Engine.prototype.getTreatment = function (key, attributes, splitEvaluator) {
-        var _a = this.baseInfo, killed = _a.killed, seed = _a.seed, defaultTreatment = _a.defaultTreatment, trafficAllocation = _a.trafficAllocation, trafficAllocationSeed = _a.trafficAllocationSeed;
-        var parsedKey;
-        var treatment;
-        var label;
-        try {
-            parsedKey = keyParser(key);
-        }
-        catch (err) {
-            return {
-                treatment: CONTROL,
-                label: EXCEPTION
-            };
-        }
-        if (this.isGarbage()) {
-            treatment = CONTROL;
-            label = SPLIT_ARCHIVED;
-        }
-        else if (killed) {
-            treatment = defaultTreatment;
-            label = SPLIT_KILLED;
-        }
-        else {
-            var evaluation = this.evaluator(parsedKey, seed, trafficAllocation, trafficAllocationSeed, attributes, splitEvaluator);
-            // Evaluation could be async, so we should handle that case checking for a
-            // thenable object
-            if (thenable(evaluation)) {
-                return evaluation.then(function (result) { return evaluationResult(result, defaultTreatment); });
+export function engineParser(log, split, storage) {
+    var killed = split.killed, seed = split.seed, trafficAllocation = split.trafficAllocation, trafficAllocationSeed = split.trafficAllocationSeed, status = split.status, conditions = split.conditions, prerequisites = split.prerequisites;
+    var defaultTreatment = isString(split.defaultTreatment) ? split.defaultTreatment : CONTROL;
+    var evaluator = parser(log, conditions, storage);
+    var prerequisiteMatcher = prerequisitesMatcherContext(prerequisites, storage, log);
+    return {
+        getTreatment: function (key, attributes, splitEvaluator) {
+            var parsedKey = keyParser(key);
+            function evaluate(prerequisitesMet) {
+                if (!prerequisitesMet) {
+                    log.debug(ENGINE_DEFAULT, ['Prerequisite not met']);
+                    return {
+                        treatment: defaultTreatment,
+                        label: PREREQUISITES_NOT_MET
+                    };
+                }
+                var evaluation = evaluator(parsedKey, seed, trafficAllocation, trafficAllocationSeed, attributes, splitEvaluator);
+                return thenable(evaluation) ?
+                    evaluation.then(function (result) { return evaluationResult(result, defaultTreatment); }) :
+                    evaluationResult(evaluation, defaultTreatment);
             }
-            else {
-                return evaluationResult(evaluation, defaultTreatment);
+            if (status === 'ARCHIVED')
+                return {
+                    treatment: CONTROL,
+                    label: SPLIT_ARCHIVED
+                };
+            if (killed) {
+                log.debug(ENGINE_DEFAULT, ['Flag is killed']);
+                return {
+                    treatment: defaultTreatment,
+                    label: SPLIT_KILLED
+                };
             }
+            var prerequisitesMet = prerequisiteMatcher({ key: key, attributes: attributes }, splitEvaluator);
+            return thenable(prerequisitesMet) ?
+                prerequisitesMet.then(evaluate) :
+                evaluate(prerequisitesMet);
         }
-        return {
-            treatment: treatment,
-            label: label
-        };
-    };
-    Engine.prototype.isGarbage = function () {
-        return this.baseInfo.status === 'ARCHIVED';
     };
-    Engine.prototype.getChangeNumber = function () {
-        return this.baseInfo.changeNumber;
-    };
-    return Engine;
-}());
-export { Engine };
+}

package/esm/evaluator/index.js

@@ -1,4 +1,4 @@
-import { Engine } from './Engine';
+import { engineParser } from './Engine';
 import { thenable } from '../utils/promise/thenable';
 import { EXCEPTION, SPLIT_NOT_FOUND } from '../utils/labels';
 import { CONTROL } from '../utils/constants';
@@ -91,19 +91,19 @@ function getEvaluation(log, key, splitJSON, attributes, storage) {
         config: null
     };
     if (splitJSON) {
-        var split_1 = Engine.parse(log, splitJSON, storage);
-        evaluation = split_1.getTreatment(key, attributes, evaluateFeature);
+        var split = engineParser(log, splitJSON, storage);
+        evaluation = split.getTreatment(key, attributes, evaluateFeature);
         // If the storage is async and the evaluated flag uses segments or dependencies, evaluation is thenable
         if (thenable(evaluation)) {
             return evaluation.then(function (result) {
-                result.changeNumber = split_1.getChangeNumber();
+                result.changeNumber = splitJSON.changeNumber;
                 result.config = splitJSON.configurations && splitJSON.configurations[result.treatment] || null;
                 result.impressionsDisabled = splitJSON.impressionsDisabled;
                 return result;
             });
         }
         else {
-            evaluation.changeNumber = split_1.getChangeNumber(); // Always sync and optional
+            evaluation.changeNumber = splitJSON.changeNumber;
             evaluation.config = splitJSON.configurations && splitJSON.configurations[evaluation.treatment] || null;
             evaluation.impressionsDisabled = splitJSON.impressionsDisabled;
         }

package/esm/evaluator/matchers/prerequisites.js

@@ -0,0 +1,18 @@
+import { thenable } from '../../utils/promise/thenable';
+export function prerequisitesMatcherContext(prerequisites, storage, log) {
+    if (prerequisites === void 0) { prerequisites = []; }
+    return function prerequisitesMatcher(_a, splitEvaluator) {
+        var key = _a.key, attributes = _a.attributes;
+        function evaluatePrerequisite(prerequisite) {
+            var evaluation = splitEvaluator(log, key, prerequisite.n, attributes, storage);
+            return thenable(evaluation) ?
+                evaluation.then(function (evaluation) { return prerequisite.ts.indexOf(evaluation.treatment) !== -1; }) :
+                prerequisite.ts.indexOf(evaluation.treatment) !== -1;
+        }
+        return prerequisites.reduce(function (prerequisitesMet, prerequisite) {
+            return thenable(prerequisitesMet) ?
+                prerequisitesMet.then(function (prerequisitesMet) { return prerequisitesMet ? evaluatePrerequisite(prerequisite) : false; }) :
+                prerequisitesMet ? evaluatePrerequisite(prerequisite) : false;
+        }, true);
+    };
+}

package/esm/logger/constants.js

@@ -28,6 +28,7 @@ export var SYNC_TASK_EXECUTE = 37;
 export var SYNC_TASK_STOP = 38;
 export var SETTINGS_SPLITS_FILTER = 39;
 export var ENGINE_MATCHER_RESULT = 40;
+export var ENGINE_DEFAULT = 41;
 export var CLIENT_READY_FROM_CACHE = 100;
 export var CLIENT_READY = 101;
 export var IMPRESSION = 102;

package/esm/logger/messages/debug.js

@@ -11,6 +11,7 @@ export var codesDebug = codesInfo.concat([
     [c.ENGINE_VALUE, c.LOG_PREFIX_ENGINE_VALUE + 'Extracted attribute `%s`. %s will be used for matching.'],
     [c.ENGINE_SANITIZE, c.LOG_PREFIX_ENGINE + ':sanitize: Attempted to sanitize %s which should be of type %s. Sanitized and processed value => %s'],
     [c.ENGINE_MATCHER_RESULT, c.LOG_PREFIX_ENGINE_MATCHER + '[%s] Result: %s. Rule value: %s. Evaluation value: %s'],
+    [c.ENGINE_DEFAULT, c.LOG_PREFIX_ENGINE + 'Evaluates to default treatment. %s'],
     // SDK
     [c.CLEANUP_REGISTERING, c.LOG_PREFIX_CLEANUP + 'Registering cleanup handler %s'],
     [c.CLEANUP_DEREGISTERING, c.LOG_PREFIX_CLEANUP + 'Deregistering cleanup handler %s'],
@@ -20,8 +21,8 @@ export var codesDebug = codesInfo.concat([
     // synchronizer
     [c.SYNC_OFFLINE_DATA, c.LOG_PREFIX_SYNC_OFFLINE + 'Feature flags data: \n%s'],
     [c.SYNC_SPLITS_FETCH, c.LOG_PREFIX_SYNC_SPLITS + 'Spin up feature flags update using since = %s and rbSince = %s.'],
-    [c.SYNC_SPLITS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New feature flags %s. Removed feature flags %s.'],
-    [c.SYNC_RBS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New rule-based segments %s. Removed rule-based segments %s.'],
+    [c.SYNC_SPLITS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New feature flags: %s. Removed feature flags: %s.'],
+    [c.SYNC_RBS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New rule-based segments: %s. Removed rule-based segments: %s.'],
     [c.STREAMING_NEW_MESSAGE, c.LOG_PREFIX_SYNC_STREAMING + 'New SSE message received, with data: %s.'],
     [c.SYNC_TASK_START, c.LOG_PREFIX_SYNC + ': Starting %s. Running each %s millis'],
     [c.SYNC_TASK_EXECUTE, c.LOG_PREFIX_SYNC + ': Running %s'],

package/esm/sdkManager/index.js

@@ -26,7 +26,8 @@ function objectToView(splitObject) {
         configs: splitObject.configurations || {},
         sets: splitObject.sets || [],
         defaultTreatment: splitObject.defaultTreatment,
-        impressionsDisabled: splitObject.impressionsDisabled === true
+        impressionsDisabled: splitObject.impressionsDisabled === true,
+        prerequisites: (splitObject.prerequisites || []).map(function (p) { return ({ flagName: p.n, treatments: p.ts }); }),
     };
 }
 function objectsToViews(splitObjects) {

package/esm/services/splitHttpClient.js

@@ -2,6 +2,7 @@ import { objectAssign } from '../utils/lang/objectAssign';
 import { ERROR_HTTP, ERROR_CLIENT_CANNOT_GET_READY } from '../logger/constants';
 import { decorateHeaders, removeNonISO88591 } from './decorateHeaders';
 import { timeout } from '../utils/promise/timeout';
+var PENDING_FETCH_ERROR_TIMEOUT = 100;
 var messageNoFetch = 'Global fetch API is not available.';
 /**
  * Factory of Split HTTP clients, which are HTTP clients with predefined headers for Split endpoints.
@@ -41,8 +42,8 @@ export function splitHttpClientFactory(settings, _a) {
             // https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#Checking_that_the_fetch_was_successful
             .then(function (response) {
             if (!response.ok) {
-                // timeout after 100ms because `text()` promise doesn't settle in some implementations and cases (e.g. no content)
-                return timeout(100, response.text()).then(function (message) { return Promise.reject({ response: response, message: message }); }, function () { return Promise.reject({ response: response }); });
+                // timeout since `text()` promise might not settle in some fetch implementations and cases (e.g. no content)
+                return timeout(PENDING_FETCH_ERROR_TIMEOUT, response.text()).then(function (message) { return Promise.reject({ response: response, message: message }); }, function () { return Promise.reject({ response: response }); });
             }
             latencyTracker();
             return response;

package/esm/sync/polling/fetchers/splitChangesFetcher.js

@@ -38,7 +38,7 @@ export function splitChangesFetcherFactory(fetchSplitChanges, settings, storage)
         return splitsPromise
             .then(function (resp) { return resp.json(); })
             .then(function (data) {
-            // Using flag spec version 1.2
+            // Using flag spec version 1.2 or below
             if (data.splits) {
                 return {
                     ff: {

package/esm/utils/labels/index.js

@@ -6,3 +6,4 @@ export var EXCEPTION = 'exception';
 export var SPLIT_ARCHIVED = 'archived';
 export var NOT_IN_SPLIT = 'not in split';
 export var UNSUPPORTED_MATCHER_TYPE = 'targeting rule type unsupported by sdk';
+export var PREREQUISITES_NOT_MET = 'prerequisites not met';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-commons",
-  "version": "2.2.1-rc.5",
+  "version": "2.3.1-rc.0",
   "description": "Split JavaScript SDK common components",
   "main": "cjs/index.js",
   "module": "esm/index.js",

package/src/dtos/types.ts

@@ -220,6 +220,10 @@ export interface ISplit {
   changeNumber: number,
   status: 'ACTIVE' | 'ARCHIVED',
   conditions: ISplitCondition[],
+  prerequisites?: {
+    n: string,
+    ts: string[]
+  }[]
   killed: boolean,
   defaultTreatment: string,
   trafficTypeName: string,

package/src/evaluator/Engine.ts

@@ -1,14 +1,16 @@
-import { get } from '../utils/lang';
+import { get, isString } from '../utils/lang';
 import { parser } from './parser';
 import { keyParser } from '../utils/key';
 import { thenable } from '../utils/promise/thenable';
-import { EXCEPTION, NO_CONDITION_MATCH, SPLIT_ARCHIVED, SPLIT_KILLED } from '../utils/labels';
+import { NO_CONDITION_MATCH, SPLIT_ARCHIVED, SPLIT_KILLED, PREREQUISITES_NOT_MET } from '../utils/labels';
 import { CONTROL } from '../utils/constants';
 import { ISplit, MaybeThenable } from '../dtos/types';
 import SplitIO from '../../types/splitio';
 import { IStorageAsync, IStorageSync } from '../storages/types';
-import { IEvaluation, IEvaluationResult, IEvaluator, ISplitEvaluator } from './types';
+import { IEvaluation, IEvaluationResult, ISplitEvaluator } from './types';
 import { ILogger } from '../logger/types';
+import { ENGINE_DEFAULT } from '../logger/constants';
+import { prerequisitesMatcherContext } from './matchers/prerequisites';
 
 function evaluationResult(result: IEvaluation | undefined, defaultTreatment: string): IEvaluationResult {
   return {
@@ -17,84 +19,55 @@ function evaluationResult(result: IEvaluation | undefined, defaultTreatment: str
   };
 }
 
-export class Engine {
+export function engineParser(log: ILogger, split: ISplit, storage: IStorageSync | IStorageAsync) {
+  const { killed, seed, trafficAllocation, trafficAllocationSeed, status, conditions, prerequisites } = split;
 
-  constructor(private baseInfo: ISplit, private evaluator: IEvaluator) {
+  const defaultTreatment = isString(split.defaultTreatment) ? split.defaultTreatment : CONTROL;
 
-    // in case we don't have a default treatment in the instantiation, use 'control'
-    if (typeof this.baseInfo.defaultTreatment !== 'string') {
-      this.baseInfo.defaultTreatment = CONTROL;
-    }
-  }
+  const evaluator = parser(log, conditions, storage);
+  const prerequisiteMatcher = prerequisitesMatcherContext(prerequisites, storage, log);
+
+  return {
 
-  static parse(log: ILogger, splitFlatStructure: ISplit, storage: IStorageSync | IStorageAsync) {
-    const conditions = splitFlatStructure.conditions;
-    const evaluator = parser(log, conditions, storage);
+    getTreatment(key: SplitIO.SplitKey, attributes: SplitIO.Attributes | undefined, splitEvaluator: ISplitEvaluator): MaybeThenable<IEvaluationResult> {
 
-    return new Engine(splitFlatStructure, evaluator);
-  }
+      const parsedKey = keyParser(key);
 
-  getKey() {
-    return this.baseInfo.name;
-  }
+      function evaluate(prerequisitesMet: boolean) {
+        if (!prerequisitesMet) {
+          log.debug(ENGINE_DEFAULT, ['Prerequisite not met']);
+          return {
+            treatment: defaultTreatment,
+            label: PREREQUISITES_NOT_MET
+          };
+        }
 
-  getTreatment(key: SplitIO.SplitKey, attributes: SplitIO.Attributes | undefined, splitEvaluator: ISplitEvaluator): MaybeThenable<IEvaluationResult> {
-    const {
-      killed,
-      seed,
-      defaultTreatment,
-      trafficAllocation,
-      trafficAllocationSeed
-    } = this.baseInfo;
-    let parsedKey;
-    let treatment;
-    let label;
+        const evaluation = evaluator(parsedKey, seed, trafficAllocation, trafficAllocationSeed, attributes, splitEvaluator) as MaybeThenable<IEvaluation>;
+
+        return thenable(evaluation) ?
+          evaluation.then(result => evaluationResult(result, defaultTreatment)) :
+          evaluationResult(evaluation, defaultTreatment);
+      }
 
-    try {
-      parsedKey = keyParser(key);
-    } catch (err) {
-      return {
+      if (status === 'ARCHIVED') return {
         treatment: CONTROL,
-        label: EXCEPTION
+        label: SPLIT_ARCHIVED
       };
-    }
-
-    if (this.isGarbage()) {
-      treatment = CONTROL;
-      label = SPLIT_ARCHIVED;
-    } else if (killed) {
-      treatment = defaultTreatment;
-      label = SPLIT_KILLED;
-    } else {
-      const evaluation = this.evaluator(
-        parsedKey,
-        seed,
-        trafficAllocation,
-        trafficAllocationSeed,
-        attributes,
-        splitEvaluator
-      ) as MaybeThenable<IEvaluation>;
 
-      // Evaluation could be async, so we should handle that case checking for a
-      // thenable object
-      if (thenable(evaluation)) {
-        return evaluation.then(result => evaluationResult(result, defaultTreatment));
-      } else {
-        return evaluationResult(evaluation, defaultTreatment);
+      if (killed) {
+        log.debug(ENGINE_DEFAULT, ['Flag is killed']);
+        return {
+          treatment: defaultTreatment,
+          label: SPLIT_KILLED
+        };
       }
-    }
 
-    return {
-      treatment,
-      label
-    };
-  }
+      const prerequisitesMet = prerequisiteMatcher({ key, attributes }, splitEvaluator);
 
-  isGarbage() {
-    return this.baseInfo.status === 'ARCHIVED';
-  }
+      return thenable(prerequisitesMet) ?
+        prerequisitesMet.then(evaluate) :
+        evaluate(prerequisitesMet);
+    }
+  };
 
-  getChangeNumber() {
-    return this.baseInfo.changeNumber;
-  }
 }

package/src/evaluator/index.ts

@@ -1,4 +1,4 @@
-import { Engine } from './Engine';
+import { engineParser } from './Engine';
 import { thenable } from '../utils/promise/thenable';
 import { EXCEPTION, SPLIT_NOT_FOUND } from '../utils/labels';
 import { CONTROL } from '../utils/constants';
@@ -99,9 +99,7 @@ export function evaluateFeaturesByFlagSets(
 ): MaybeThenable<Record<string, IEvaluationResult>> {
   let storedFlagNames: MaybeThenable<Set<string>[]>;
 
-  function evaluate(
-    featureFlagsByFlagSets: Set<string>[],
-  ) {
+  function evaluate(featureFlagsByFlagSets: Set<string>[]) {
     let featureFlags = new Set<string>();
     for (let i = 0; i < flagSets.length; i++) {
       const featureFlagByFlagSet = featureFlagsByFlagSets[i];
@@ -148,20 +146,20 @@ function getEvaluation(
   };
 
   if (splitJSON) {
-    const split = Engine.parse(log, splitJSON, storage);
+    const split = engineParser(log, splitJSON, storage);
     evaluation = split.getTreatment(key, attributes, evaluateFeature);
 
     // If the storage is async and the evaluated flag uses segments or dependencies, evaluation is thenable
     if (thenable(evaluation)) {
       return evaluation.then(result => {
-        result.changeNumber = split.getChangeNumber();
+        result.changeNumber = splitJSON.changeNumber;
         result.config = splitJSON.configurations && splitJSON.configurations[result.treatment] || null;
         result.impressionsDisabled = splitJSON.impressionsDisabled;
 
         return result;
       });
     } else {
-      evaluation.changeNumber = split.getChangeNumber(); // Always sync and optional
+      evaluation.changeNumber = splitJSON.changeNumber;
       evaluation.config = splitJSON.configurations && splitJSON.configurations[evaluation.treatment] || null;
       evaluation.impressionsDisabled = splitJSON.impressionsDisabled;
     }

package/src/evaluator/matchers/prerequisites.ts

@@ -0,0 +1,24 @@
+import { ISplit, MaybeThenable } from '../../dtos/types';
+import { IStorageAsync, IStorageSync } from '../../storages/types';
+import { ILogger } from '../../logger/types';
+import { thenable } from '../../utils/promise/thenable';
+import { IDependencyMatcherValue, ISplitEvaluator } from '../types';
+
+export function prerequisitesMatcherContext(prerequisites: ISplit['prerequisites'] = [], storage: IStorageSync | IStorageAsync, log: ILogger) {
+
+  return function prerequisitesMatcher({ key, attributes }: IDependencyMatcherValue, splitEvaluator: ISplitEvaluator): MaybeThenable<boolean> {
+
+    function evaluatePrerequisite(prerequisite: { n: string; ts: string[] }): MaybeThenable<boolean> {
+      const evaluation = splitEvaluator(log, key, prerequisite.n, attributes, storage);
+      return thenable(evaluation) ?
+        evaluation.then(evaluation => prerequisite.ts.indexOf(evaluation.treatment!) !== -1) :
+        prerequisite.ts.indexOf(evaluation.treatment!) !== -1;
+    }
+
+    return prerequisites.reduce<MaybeThenable<boolean>>((prerequisitesMet, prerequisite) => {
+      return thenable(prerequisitesMet) ?
+        prerequisitesMet.then(prerequisitesMet => prerequisitesMet ? evaluatePrerequisite(prerequisite) : false) :
+        prerequisitesMet ? evaluatePrerequisite(prerequisite) : false;
+    }, true);
+  };
+}

package/src/logger/constants.ts

@@ -28,6 +28,7 @@ export const SYNC_TASK_EXECUTE = 37;
 export const SYNC_TASK_STOP = 38;
 export const SETTINGS_SPLITS_FILTER = 39;
 export const ENGINE_MATCHER_RESULT = 40;
+export const ENGINE_DEFAULT = 41;
 
 export const CLIENT_READY_FROM_CACHE = 100;
 export const CLIENT_READY = 101;

package/src/logger/messages/debug.ts

@@ -12,6 +12,7 @@ export const codesDebug: [number, string][] = codesInfo.concat([
   [c.ENGINE_VALUE, c.LOG_PREFIX_ENGINE_VALUE + 'Extracted attribute `%s`. %s will be used for matching.'],
   [c.ENGINE_SANITIZE, c.LOG_PREFIX_ENGINE + ':sanitize: Attempted to sanitize %s which should be of type %s. Sanitized and processed value => %s'],
   [c.ENGINE_MATCHER_RESULT, c.LOG_PREFIX_ENGINE_MATCHER + '[%s] Result: %s. Rule value: %s. Evaluation value: %s'],
+  [c.ENGINE_DEFAULT, c.LOG_PREFIX_ENGINE + 'Evaluates to default treatment. %s'],
   // SDK
   [c.CLEANUP_REGISTERING, c.LOG_PREFIX_CLEANUP + 'Registering cleanup handler %s'],
   [c.CLEANUP_DEREGISTERING, c.LOG_PREFIX_CLEANUP + 'Deregistering cleanup handler %s'],
@@ -21,8 +22,8 @@ export const codesDebug: [number, string][] = codesInfo.concat([
   // synchronizer
   [c.SYNC_OFFLINE_DATA, c.LOG_PREFIX_SYNC_OFFLINE + 'Feature flags data: \n%s'],
   [c.SYNC_SPLITS_FETCH, c.LOG_PREFIX_SYNC_SPLITS + 'Spin up feature flags update using since = %s and rbSince = %s.'],
-  [c.SYNC_SPLITS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New feature flags %s. Removed feature flags %s.'],
-  [c.SYNC_RBS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New rule-based segments %s. Removed rule-based segments %s.'],
+  [c.SYNC_SPLITS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New feature flags: %s. Removed feature flags: %s.'],
+  [c.SYNC_RBS_UPDATE, c.LOG_PREFIX_SYNC_SPLITS + 'New rule-based segments: %s. Removed rule-based segments: %s.'],
   [c.STREAMING_NEW_MESSAGE, c.LOG_PREFIX_SYNC_STREAMING + 'New SSE message received, with data: %s.'],
   [c.SYNC_TASK_START, c.LOG_PREFIX_SYNC + ': Starting %s. Running each %s millis'],
   [c.SYNC_TASK_EXECUTE, c.LOG_PREFIX_SYNC + ': Running %s'],

package/src/sdkFactory/types.ts

@@ -22,7 +22,7 @@ export interface IPlatform {
   /**
    * If provided, it is used to pass additional options to fetch and eventsource calls.
    */
-  getOptions?: (settings: ISettings) => object
+  getOptions?: (settings: ISettings) => (object | undefined)
   /**
    * If provided, it is used to retrieve the EventSource constructor for streaming support.
    */

package/src/sdkManager/index.ts

@@ -32,7 +32,8 @@ function objectToView(splitObject: ISplit | null): SplitIO.SplitView | null {
     configs: splitObject.configurations || {},
     sets: splitObject.sets || [],
     defaultTreatment: splitObject.defaultTreatment,
-    impressionsDisabled: splitObject.impressionsDisabled === true
+    impressionsDisabled: splitObject.impressionsDisabled === true,
+    prerequisites: (splitObject.prerequisites || []).map(p => ({ flagName: p.n, treatments: p.ts })),
   };
 }
 

package/src/services/splitHttpClient.ts

@@ -6,6 +6,7 @@ import { IPlatform } from '../sdkFactory/types';
 import { decorateHeaders, removeNonISO88591 } from './decorateHeaders';
 import { timeout } from '../utils/promise/timeout';
 
+const PENDING_FETCH_ERROR_TIMEOUT = 100;
 const messageNoFetch = 'Global fetch API is not available.';
 
 /**
@@ -46,8 +47,8 @@ export function splitHttpClientFactory(settings: ISettings, { getOptions, getFet
       // https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch#Checking_that_the_fetch_was_successful
       .then(response => {
         if (!response.ok) {
-          // timeout after 100ms because `text()` promise doesn't settle in some implementations and cases (e.g. no content)
-          return timeout(100, response.text()).then(message => Promise.reject({ response, message }), () => Promise.reject({ response }));
+          // timeout since `text()` promise might not settle in some fetch implementations and cases (e.g. no content)
+          return timeout(PENDING_FETCH_ERROR_TIMEOUT, response.text()).then(message => Promise.reject({ response, message }), () => Promise.reject({ response }));
         }
         latencyTracker();
         return response;

package/src/sync/polling/fetchers/splitChangesFetcher.ts

@@ -56,7 +56,7 @@ export function splitChangesFetcherFactory(fetchSplitChanges: IFetchSplitChanges
     return splitsPromise
       .then(resp => resp.json())
       .then(data => {
-        // Using flag spec version 1.2
+        // Using flag spec version 1.2 or below
         if (data.splits) {
           return {
             ff: {

package/src/utils/labels/index.ts

@@ -6,3 +6,4 @@ export const EXCEPTION = 'exception';
 export const SPLIT_ARCHIVED = 'archived';
 export const NOT_IN_SPLIT = 'not in split';
 export const UNSUPPORTED_MATCHER_TYPE = 'targeting rule type unsupported by sdk';
+export const PREREQUISITES_NOT_MET = 'prerequisites not met';

package/types/splitio.d.ts

@@ -879,7 +879,7 @@ declare namespace SplitIO {
     /**
      * The list of treatments available for the feature flag.
      */
-    treatments: Array<string>;
+    treatments: string[];
     /**
      * Current change number of the feature flag.
      */
@@ -903,6 +903,10 @@ declare namespace SplitIO {
      * Whether the feature flag has impressions tracking disabled or not.
      */
     impressionsDisabled: boolean;
+    /**
+     * Prerequisites for the feature flag.
+     */
+    prerequisites: Array<{ flagName: string, treatments: string[] }>;
   };
   /**
    * A promise that resolves to a feature flag view or null if the feature flag is not found.