@splitsoftware/splitio-commons 3.1.1-rc.11 → 3.1.1-rc.12

package/CHANGES.txt

@@ -1,4 +1,5 @@
 3.2.0 (XXX XX, 2026)
+ - Added support for streaming in the Configs SDK, handling CONFIG_UPDATE notifications. Unlike feature flag notifications, the previous change number of CONFIG_UPDATE and RB_SEGMENT_UPDATE notifications are scoped to the referenced entity rather than to the environment, and so instant updates are applied without updating the storage change number.
  - Added support for AI configs.
  - Added support for ioredis v6 (Related to issue https://github.com/splitio/javascript-client/issues/951). Note that ioredis v6 requires Node.js 20 or above; stay on ioredis v4 or v5 for older Node.js versions.
  - Removed the `@types/ioredis` dependency, which is no longer required since the public type definitions don't depend on ioredis types. The `@types/node` dependency, previously installed transitively by `@types/ioredis`, is now declared explicitly, since the public type definitions use Node.js types for the `agent` and `tls` options.

package/cjs/services/authProvider.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.authProviderFactory = void 0;
-var AuthClient_1 = require("../sync/streaming/AuthClient");
+var fetchAuth_1 = require("./fetchAuth");
 var Backoff_1 = require("../utils/Backoff");
 var constants_1 = require("../logger/constants");
 var constants_2 = require("../utils/constants");
@@ -18,7 +18,7 @@ function noCachedCredentialError() {
  */
 function authProviderFactory(settings, splitHttpClient, telemetryTracker) {
     var urls = settings.urls, log = settings.log;
-    var fetchAuth = (0, AuthClient_1.fetchAuthFactory)(function () {
+    var fetchAuth = (0, fetchAuth_1.fetchAuthFactory)(function () {
         var url = "".concat(urls.auth, "/api/v3/auth?capabilities=config,aiconfig");
         return splitHttpClient(url, undefined, telemetryTracker.trackHttp(constants_2.TOKEN), false, true);
     });

package/cjs/{sync/streaming/AuthClient/index.js → services/fetchAuth.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchAuthFactory = void 0;
-var objectAssign_1 = require("../../../utils/lang/objectAssign");
-var jwt_1 = require("../../../utils/jwt");
+var objectAssign_1 = require("../utils/lang/objectAssign");
+var jwt_1 = require("../utils/jwt");
 /**
  * Factory of authentication function.
  *

package/cjs/services/splitApi.js

@@ -5,7 +5,7 @@ var splitHttpClient_1 = require("./splitHttpClient");
 var objectAssign_1 = require("../utils/lang/objectAssign");
 var constants_1 = require("../utils/constants");
 var constants_2 = require("../logger/constants");
-var AuthClient_1 = require("../sync/streaming/AuthClient");
+var fetchAuth_1 = require("./fetchAuth");
 var noCacheHeaderOptions = { headers: { 'Cache-Control': 'no-cache' } };
 function userKeyToQueryParam(userKey) {
     return 'users=' + encodeURIComponent(userKey); // no need to check availability of `encodeURIComponent`, since it is a global highly supported.
@@ -24,7 +24,7 @@ function splitApiFactory(settings, platform, telemetryTracker) {
     var SplitSDKImpressionsMode = settings.sync.impressionsMode;
     var splitHttpClient = (0, splitHttpClient_1.splitHttpClientFactory)(settings, platform);
     return {
-        fetchAuth: (0, AuthClient_1.fetchAuthFactory)(function (userMatchingKeys) {
+        fetchAuth: (0, fetchAuth_1.fetchAuthFactory)(function (userMatchingKeys) {
             var url = "".concat(urls.auth, "/v2/auth?s=").concat(settings.sync.flagSpecVersion);
             if (userMatchingKeys) { // `userMatchingKeys` is undefined in server-side
                 var queryParams = userMatchingKeys.map(userKeyToQueryParam).join('&');

package/cjs/storages/inLocalStorage/DefinitionsCacheInLocal.js

@@ -98,7 +98,8 @@ var DefinitionsCacheInLocal = /** @class */ (function (_super) {
     };
     DefinitionsCacheInLocal.prototype.setChangeNumber = function (changeNumber) {
         try {
-            this.storage.setItem(this.keys.buildDefinitionsTillKey(), changeNumber + '');
+            if (changeNumber !== undefined)
+                this.storage.setItem(this.keys.buildDefinitionsTillKey(), changeNumber + '');
             // update "last updated" timestamp with current time
             this.storage.setItem(this.keys.buildLastUpdatedKey(), Date.now() + '');
             this.hasSync = true;

package/cjs/storages/inLocalStorage/RBSegmentsCacheInLocal.js

@@ -25,7 +25,8 @@ var RBSegmentsCacheInLocal = /** @class */ (function () {
     };
     RBSegmentsCacheInLocal.prototype.setChangeNumber = function (changeNumber) {
         try {
-            this.storage.setItem(this.keys.buildRBSegmentsTillKey(), changeNumber + '');
+            if (changeNumber !== undefined)
+                this.storage.setItem(this.keys.buildRBSegmentsTillKey(), changeNumber + '');
             this.storage.setItem(this.keys.buildLastUpdatedKey(), Date.now() + '');
         }
         catch (e) {

package/cjs/storages/inMemory/DefinitionsCacheInMemory.js

@@ -70,7 +70,8 @@ var DefinitionsCacheInMemory = /** @class */ (function (_super) {
         return this.definitionsCache[name] || null;
     };
     DefinitionsCacheInMemory.prototype.setChangeNumber = function (changeNumber) {
-        this.changeNumber = changeNumber;
+        if (changeNumber !== undefined)
+            this.changeNumber = changeNumber;
         return true;
     };
     DefinitionsCacheInMemory.prototype.getChangeNumber = function () {

package/cjs/storages/inMemory/RBSegmentsCacheInMemory.js

@@ -18,7 +18,8 @@ var RBSegmentsCacheInMemory = /** @class */ (function () {
         var _this = this;
         var updated = toAdd.map(function (toAdd) { return _this.add(toAdd); }).some(function (result) { return result; });
         updated = toRemove.map(function (toRemove) { return _this.remove(toRemove); }).some(function (result) { return result; }) || updated;
-        this.changeNumber = changeNumber;
+        if (changeNumber !== undefined)
+            this.changeNumber = changeNumber;
         return updated;
     };
     RBSegmentsCacheInMemory.prototype.add = function (rbSegment) {

package/cjs/storages/inRedis/DefinitionsCacheInRedis.js

@@ -126,7 +126,9 @@ var DefinitionsCacheInRedis = /** @class */ (function (_super) {
      * or rejected if it fails.
      */
     DefinitionsCacheInRedis.prototype.setChangeNumber = function (changeNumber) {
-        return this.redis.set(this.keys.buildDefinitionsTillKey(), changeNumber + '').then(function (status) { return status === 'OK'; });
+        if (changeNumber !== undefined) {
+            return this.redis.set(this.keys.buildDefinitionsTillKey(), changeNumber + '').then(function (status) { return status === 'OK'; });
+        }
     };
     /**
      * Get till number or -1 if it's not defined.

package/cjs/storages/inRedis/RBSegmentsCacheInRedis.js

@@ -43,7 +43,9 @@ var RBSegmentsCacheInRedis = /** @class */ (function () {
         });
     };
     RBSegmentsCacheInRedis.prototype.setChangeNumber = function (changeNumber) {
-        return this.redis.set(this.keys.buildRBSegmentsTillKey(), changeNumber + '').then(function (status) { return status === 'OK'; });
+        if (changeNumber !== undefined) {
+            return this.redis.set(this.keys.buildRBSegmentsTillKey(), changeNumber + '').then(function (status) { return status === 'OK'; });
+        }
     };
     RBSegmentsCacheInRedis.prototype.getChangeNumber = function () {
         var _this = this;

package/cjs/storages/pluggable/DefinitionsCachePluggable.js

@@ -186,7 +186,9 @@ var DefinitionsCachePluggable = /** @class */ (function (_super) {
      * or rejected if it fails (e.g., wrapper operation fails).
      */
     DefinitionsCachePluggable.prototype.setChangeNumber = function (changeNumber) {
-        return this.wrapper.set(this.keys.buildDefinitionsTillKey(), changeNumber + '');
+        if (changeNumber !== undefined) {
+            return this.wrapper.set(this.keys.buildDefinitionsTillKey(), changeNumber + '');
+        }
     };
     /**
      * Get till number or -1 if it's not defined.

package/cjs/storages/pluggable/RBSegmentsCachePluggable.js

@@ -43,7 +43,9 @@ var RBSegmentsCachePluggable = /** @class */ (function () {
         });
     };
     RBSegmentsCachePluggable.prototype.setChangeNumber = function (changeNumber) {
-        return this.wrapper.set(this.keys.buildRBSegmentsTillKey(), changeNumber + '');
+        if (changeNumber !== undefined) {
+            return this.wrapper.set(this.keys.buildRBSegmentsTillKey(), changeNumber + '');
+        }
     };
     RBSegmentsCachePluggable.prototype.getChangeNumber = function () {
         var _this = this;

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

@@ -16,7 +16,7 @@ function isSplitChangesLegacyResponse(data) {
 function partitionByStatus(items, till, since) {
     var updated = [], removed = [];
     items.forEach(function (item) { return item.status === 'ARCHIVED' ? removed.push(item.name) : updated.push(item); });
-    return { updated: updated, removed: removed, till: till, since: since };
+    return { updated: updated, removed: removed, till: till, since: since !== null && since !== void 0 ? since : undefined };
 }
 /**
  * Factory of SplitChanges fetcher.

package/cjs/sync/polling/updaters/definitionChangesUpdater.js

@@ -8,6 +8,7 @@ var lang_1 = require("../../../utils/lang");
 var constants_3 = require("../../../utils/constants");
 var sets_1 = require("../../../utils/lang/sets");
 var constants_4 = require("../../streaming/constants");
+var thenable_1 = require("../../../utils/promise/thenable");
 /**
  * Collect segments from a raw FF or RBS definition.
  * Exported for testing purposes.
@@ -115,7 +116,7 @@ function definitionChangesUpdaterFactory(log, definitionChangesFetcher, storage,
      * @param noCache - true to revalidate data to fetch
      * @param till - query param to bypass CDN requests
      */
-    return function definitionChangesUpdater(noCache, till, instantUpdate) {
+    return function definitionChangesUpdater(noCache, till, instantUpdate, pcns) {
         /**
          * @param since - current changeNumber at definitionsCache
          * @param retry - current number of retry attempts
@@ -123,8 +124,14 @@ function definitionChangesUpdaterFactory(log, definitionChangesFetcher, storage,
         function _definitionChangesUpdater(sinces, retry) {
             if (retry === void 0) { retry = 0; }
             var since = sinces[0], rbSince = sinces[1];
-            log.debug(constants_2.SYNC_FETCH, [definitionChangesFetcher.type, since, rbSince]);
-            return Promise.resolve(instantUpdate ?
+            // If provided, `since` and `rbSince` must not be higher than it, to avoid missing an update that the scoped `pcn` indicates hasn't been fetched yet.
+            if (pcns) {
+                if (pcns.since !== undefined && pcns.since < since)
+                    since = pcns.since;
+                if (pcns.rbSince !== undefined && pcns.rbSince < rbSince)
+                    rbSince = pcns.rbSince;
+            }
+            var definitionChangesRequest = instantUpdate ?
                 instantUpdate.type === constants_4.RB_SEGMENT_UPDATE ?
                     { rbs: convertInstantUpdateToDefinitionChanges(instantUpdate) } :
                     // IFFU edge case: a change to definition that adds an IN_RULE_BASED_SEGMENT matcher that is not present yet
@@ -133,7 +140,10 @@ function definitionChangesUpdaterFactory(log, definitionChangesFetcher, storage,
                             { d: convertInstantUpdateToDefinitionChanges(instantUpdate) } :
                             definitionChangesFetcher(since, noCache, till, rbSince, _promiseDecorator);
                     }) :
-                definitionChangesFetcher(since, noCache, till, rbSince, _promiseDecorator))
+                definitionChangesFetcher(since, noCache, till, rbSince, _promiseDecorator);
+            if ((0, thenable_1.thenable)(definitionChangesRequest))
+                log.debug(constants_2.SYNC_FETCH, [definitionChangesFetcher.type, since, rbSince]);
+            return Promise.resolve(definitionChangesRequest)
                 .then(function (definitionChanges) {
                 var usedSegments = new Set();
                 var updatedDefinitions = [];

package/cjs/sync/streaming/UpdateWorkers/DefinitionsUpdateWorker.js

@@ -9,9 +9,11 @@ var constants_4 = require("../constants");
 var parseUtils_1 = require("../parseUtils");
 var constants_5 = require("./constants");
 /**
- * DefinitionsUpdateWorker factory
+ * DefinitionsUpdateWorker factory for Flags SDKs, where notifications pcn and changeNumber are environment-scoped
  */
-function DefinitionsUpdateWorker(log, storage, definitionsSyncTask, definitionsEventEmitter, telemetryTracker) {
+function DefinitionsUpdateWorker(params, pollingManager) {
+    var log = params.settings.log, storage = params.storage, telemetryTracker = params.telemetryTracker, definitionsEventEmitter = params.readiness.definitions;
+    var definitionsSyncTask = pollingManager.definitionsSyncTask;
     var ff = DefinitionsUpdateWorker(storage.definitions);
     var rbs = DefinitionsUpdateWorker(storage.rbSegments);
     function DefinitionsUpdateWorker(cache) {
@@ -96,7 +98,7 @@ function DefinitionsUpdateWorker(log, storage, definitionsSyncTask, definitionsE
         put: function (parsedData) {
             if (parsedData.d && parsedData.c !== undefined) {
                 try {
-                    var payload = (0, parseUtils_1.parseFFUpdatePayload)(parsedData.c, parsedData.d);
+                    var payload = (0, parseUtils_1.parseUpdatePayload)(parsedData.c, parsedData.d);
                     if (payload) {
                         (parsedData.type === constants_4.RB_SEGMENT_UPDATE ? rbs : ff).put(parsedData, payload);
                         return;

package/cjs/sync/streaming/parseUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDelay = exports.parseFFUpdatePayload = exports.isInBitmap = exports.parseBitmap = exports.parseCompressedData = void 0;
+exports.getDelay = exports.parseUpdatePayload = exports.isInBitmap = exports.parseBitmap = exports.parseCompressedData = void 0;
 var decompress_1 = require("../../utils/decompress");
 var base64_1 = require("../../utils/base64");
 var murmur3_1 = require("../../utils/murmur3/murmur3");
@@ -79,14 +79,14 @@ function isInBitmap(bitmap, hash64hex) {
 }
 exports.isInBitmap = isInBitmap;
 /**
- * Parse feature flags notifications for instant feature flag updates
+ * Parse notifications for instant updates
  */
-function parseFFUpdatePayload(compression, data) {
+function parseUpdatePayload(compression, data) {
     return compression > 0 ?
         parseCompressedData(data, compression, false) :
         JSON.parse((0, base64_1.decodeFromBase64)(data));
 }
-exports.parseFFUpdatePayload = parseFFUpdatePayload;
+exports.parseUpdatePayload = parseUpdatePayload;
 var DEFAULT_MAX_INTERVAL = 60000;
 function getDelay(parsedData, matchingKey) {
     if (parsedData.h === 0)

package/cjs/sync/streaming/pushManager.js

@@ -21,8 +21,9 @@ var constants_3 = require("../../utils/constants");
  * - for server-side if key is not provided in settings.
  * - for client-side, with support for multiple clients, if key is provided in settings
  */
-function pushManagerFactory(params, pollingManager) {
-    var settings = params.settings, storage = params.storage, serviceApi = params.serviceApi, readiness = params.readiness, platform = params.platform, telemetryTracker = params.telemetryTracker;
+function pushManagerFactory(params, pollingManager, definitionsUpdateWorkerFactory) {
+    if (definitionsUpdateWorkerFactory === void 0) { definitionsUpdateWorkerFactory = DefinitionsUpdateWorker_1.DefinitionsUpdateWorker; }
+    var settings = params.settings, storage = params.storage, serviceApi = params.serviceApi, platform = params.platform, telemetryTracker = params.telemetryTracker;
     // `userKey` is the matching key of main client in client-side SDK.
     // It can be used to check if running on client-side or server-side SDK.
     var userKey = (0, key_1.checkIfServerSide)(settings) ? undefined : (0, key_1.getMatching)(settings.core.key);
@@ -44,7 +45,7 @@ function pushManagerFactory(params, pollingManager) {
     // MySegmentsUpdateWorker (client-side) are initiated in `add` method
     var segmentsUpdateWorker = userKey ? undefined : (0, SegmentsUpdateWorker_1.SegmentsUpdateWorker)(log, pollingManager.segmentsSyncTask, storage.segments);
     // For server-side we pass the segmentsSyncTask, used by DefinitionsUpdateWorker to fetch new segments
-    var definitionsUpdateWorker = (0, DefinitionsUpdateWorker_1.DefinitionsUpdateWorker)(log, storage, pollingManager.definitionsSyncTask, readiness.definitions, telemetryTracker);
+    var definitionsUpdateWorker = definitionsUpdateWorkerFactory(params, pollingManager);
     // [Only for client-side] map of user keys to their corresponding hash64 and MySegmentsUpdateWorkers.
     // Hash64 is used to process membership update events and dispatch actions to the corresponding MySegmentsUpdateWorker.
     var clients = {};

package/esm/services/authProvider.js

@@ -1,4 +1,4 @@
-import { fetchAuthFactory } from '../sync/streaming/AuthClient';
+import { fetchAuthFactory } from './fetchAuth';
 import { Backoff } from '../utils/Backoff';
 import { LOG_PREFIX_SYNC_AUTH } from '../logger/constants';
 import { TOKEN } from '../utils/constants';

package/esm/{sync/streaming/AuthClient/index.js → services/fetchAuth.js}

@@ -1,5 +1,5 @@
-import { objectAssign } from '../../../utils/lang/objectAssign';
-import { decodeJWTtoken } from '../../../utils/jwt';
+import { objectAssign } from '../utils/lang/objectAssign';
+import { decodeJWTtoken } from '../utils/jwt';
 /**
  * Factory of authentication function.
  *

package/esm/services/splitApi.js

@@ -2,7 +2,7 @@ import { splitHttpClientFactory } from './splitHttpClient';
 import { objectAssign } from '../utils/lang/objectAssign';
 import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MEMBERSHIPS } from '../utils/constants';
 import { ERROR_TOO_MANY_SETS } from '../logger/constants';
-import { fetchAuthFactory } from '../sync/streaming/AuthClient';
+import { fetchAuthFactory } from './fetchAuth';
 var noCacheHeaderOptions = { headers: { 'Cache-Control': 'no-cache' } };
 function userKeyToQueryParam(userKey) {
     return 'users=' + encodeURIComponent(userKey); // no need to check availability of `encodeURIComponent`, since it is a global highly supported.

package/esm/storages/inLocalStorage/DefinitionsCacheInLocal.js

@@ -95,7 +95,8 @@ var DefinitionsCacheInLocal = /** @class */ (function (_super) {
     };
     DefinitionsCacheInLocal.prototype.setChangeNumber = function (changeNumber) {
         try {
-            this.storage.setItem(this.keys.buildDefinitionsTillKey(), changeNumber + '');
+            if (changeNumber !== undefined)
+                this.storage.setItem(this.keys.buildDefinitionsTillKey(), changeNumber + '');
             // update "last updated" timestamp with current time
             this.storage.setItem(this.keys.buildLastUpdatedKey(), Date.now() + '');
             this.hasSync = true;

package/esm/storages/inLocalStorage/RBSegmentsCacheInLocal.js

@@ -22,7 +22,8 @@ var RBSegmentsCacheInLocal = /** @class */ (function () {
     };
     RBSegmentsCacheInLocal.prototype.setChangeNumber = function (changeNumber) {
         try {
-            this.storage.setItem(this.keys.buildRBSegmentsTillKey(), changeNumber + '');
+            if (changeNumber !== undefined)
+                this.storage.setItem(this.keys.buildRBSegmentsTillKey(), changeNumber + '');
             this.storage.setItem(this.keys.buildLastUpdatedKey(), Date.now() + '');
         }
         catch (e) {

package/esm/storages/inMemory/DefinitionsCacheInMemory.js

@@ -67,7 +67,8 @@ var DefinitionsCacheInMemory = /** @class */ (function (_super) {
         return this.definitionsCache[name] || null;
     };
     DefinitionsCacheInMemory.prototype.setChangeNumber = function (changeNumber) {
-        this.changeNumber = changeNumber;
+        if (changeNumber !== undefined)
+            this.changeNumber = changeNumber;
         return true;
     };
     DefinitionsCacheInMemory.prototype.getChangeNumber = function () {

package/esm/storages/inMemory/RBSegmentsCacheInMemory.js

@@ -15,7 +15,8 @@ var RBSegmentsCacheInMemory = /** @class */ (function () {
         var _this = this;
         var updated = toAdd.map(function (toAdd) { return _this.add(toAdd); }).some(function (result) { return result; });
         updated = toRemove.map(function (toRemove) { return _this.remove(toRemove); }).some(function (result) { return result; }) || updated;
-        this.changeNumber = changeNumber;
+        if (changeNumber !== undefined)
+            this.changeNumber = changeNumber;
         return updated;
     };
     RBSegmentsCacheInMemory.prototype.add = function (rbSegment) {

package/esm/storages/inRedis/DefinitionsCacheInRedis.js

@@ -123,7 +123,9 @@ var DefinitionsCacheInRedis = /** @class */ (function (_super) {
      * or rejected if it fails.
      */
     DefinitionsCacheInRedis.prototype.setChangeNumber = function (changeNumber) {
-        return this.redis.set(this.keys.buildDefinitionsTillKey(), changeNumber + '').then(function (status) { return status === 'OK'; });
+        if (changeNumber !== undefined) {
+            return this.redis.set(this.keys.buildDefinitionsTillKey(), changeNumber + '').then(function (status) { return status === 'OK'; });
+        }
     };
     /**
      * Get till number or -1 if it's not defined.

package/esm/storages/inRedis/RBSegmentsCacheInRedis.js

@@ -40,7 +40,9 @@ var RBSegmentsCacheInRedis = /** @class */ (function () {
         });
     };
     RBSegmentsCacheInRedis.prototype.setChangeNumber = function (changeNumber) {
-        return this.redis.set(this.keys.buildRBSegmentsTillKey(), changeNumber + '').then(function (status) { return status === 'OK'; });
+        if (changeNumber !== undefined) {
+            return this.redis.set(this.keys.buildRBSegmentsTillKey(), changeNumber + '').then(function (status) { return status === 'OK'; });
+        }
     };
     RBSegmentsCacheInRedis.prototype.getChangeNumber = function () {
         var _this = this;

package/esm/storages/pluggable/DefinitionsCachePluggable.js

@@ -183,7 +183,9 @@ var DefinitionsCachePluggable = /** @class */ (function (_super) {
      * or rejected if it fails (e.g., wrapper operation fails).
      */
     DefinitionsCachePluggable.prototype.setChangeNumber = function (changeNumber) {
-        return this.wrapper.set(this.keys.buildDefinitionsTillKey(), changeNumber + '');
+        if (changeNumber !== undefined) {
+            return this.wrapper.set(this.keys.buildDefinitionsTillKey(), changeNumber + '');
+        }
     };
     /**
      * Get till number or -1 if it's not defined.

package/esm/storages/pluggable/RBSegmentsCachePluggable.js

@@ -40,7 +40,9 @@ var RBSegmentsCachePluggable = /** @class */ (function () {
         });
     };
     RBSegmentsCachePluggable.prototype.setChangeNumber = function (changeNumber) {
-        return this.wrapper.set(this.keys.buildRBSegmentsTillKey(), changeNumber + '');
+        if (changeNumber !== undefined) {
+            return this.wrapper.set(this.keys.buildRBSegmentsTillKey(), changeNumber + '');
+        }
     };
     RBSegmentsCachePluggable.prototype.getChangeNumber = function () {
         var _this = this;

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

@@ -13,7 +13,7 @@ function isSplitChangesLegacyResponse(data) {
 function partitionByStatus(items, till, since) {
     var updated = [], removed = [];
     items.forEach(function (item) { return item.status === 'ARCHIVED' ? removed.push(item.name) : updated.push(item); });
-    return { updated: updated, removed: removed, till: till, since: since };
+    return { updated: updated, removed: removed, till: till, since: since !== null && since !== void 0 ? since : undefined };
 }
 /**
  * Factory of SplitChanges fetcher.

package/esm/sync/polling/updaters/definitionChangesUpdater.js

@@ -5,6 +5,7 @@ import { startsWith } from '../../../utils/lang';
 import { IN_RULE_BASED_SEGMENT, IN_SEGMENT, RULE_BASED_SEGMENT, STANDARD_SEGMENT } from '../../../utils/constants';
 import { setToArray } from '../../../utils/lang/sets';
 import { RB_SEGMENT_UPDATE } from '../../streaming/constants';
+import { thenable } from '../../../utils/promise/thenable';
 /**
  * Collect segments from a raw FF or RBS definition.
  * Exported for testing purposes.
@@ -110,7 +111,7 @@ export function definitionChangesUpdaterFactory(log, definitionChangesFetcher, s
      * @param noCache - true to revalidate data to fetch
      * @param till - query param to bypass CDN requests
      */
-    return function definitionChangesUpdater(noCache, till, instantUpdate) {
+    return function definitionChangesUpdater(noCache, till, instantUpdate, pcns) {
         /**
          * @param since - current changeNumber at definitionsCache
          * @param retry - current number of retry attempts
@@ -118,8 +119,14 @@ export function definitionChangesUpdaterFactory(log, definitionChangesFetcher, s
         function _definitionChangesUpdater(sinces, retry) {
             if (retry === void 0) { retry = 0; }
             var since = sinces[0], rbSince = sinces[1];
-            log.debug(SYNC_FETCH, [definitionChangesFetcher.type, since, rbSince]);
-            return Promise.resolve(instantUpdate ?
+            // If provided, `since` and `rbSince` must not be higher than it, to avoid missing an update that the scoped `pcn` indicates hasn't been fetched yet.
+            if (pcns) {
+                if (pcns.since !== undefined && pcns.since < since)
+                    since = pcns.since;
+                if (pcns.rbSince !== undefined && pcns.rbSince < rbSince)
+                    rbSince = pcns.rbSince;
+            }
+            var definitionChangesRequest = instantUpdate ?
                 instantUpdate.type === RB_SEGMENT_UPDATE ?
                     { rbs: convertInstantUpdateToDefinitionChanges(instantUpdate) } :
                     // IFFU edge case: a change to definition that adds an IN_RULE_BASED_SEGMENT matcher that is not present yet
@@ -128,7 +135,10 @@ export function definitionChangesUpdaterFactory(log, definitionChangesFetcher, s
                             { d: convertInstantUpdateToDefinitionChanges(instantUpdate) } :
                             definitionChangesFetcher(since, noCache, till, rbSince, _promiseDecorator);
                     }) :
-                definitionChangesFetcher(since, noCache, till, rbSince, _promiseDecorator))
+                definitionChangesFetcher(since, noCache, till, rbSince, _promiseDecorator);
+            if (thenable(definitionChangesRequest))
+                log.debug(SYNC_FETCH, [definitionChangesFetcher.type, since, rbSince]);
+            return Promise.resolve(definitionChangesRequest)
                 .then(function (definitionChanges) {
                 var usedSegments = new Set();
                 var updatedDefinitions = [];

package/esm/sync/streaming/UpdateWorkers/DefinitionsUpdateWorker.js

@@ -3,12 +3,14 @@ import { SDK_DEFINITIONS_ARRIVED } from '../../../readiness/constants';
 import { Backoff } from '../../../utils/Backoff';
 import { SPLITS } from '../../../utils/constants';
 import { RB_SEGMENT_UPDATE } from '../constants';
-import { parseFFUpdatePayload } from '../parseUtils';
+import { parseUpdatePayload } from '../parseUtils';
 import { FETCH_BACKOFF_BASE, FETCH_BACKOFF_MAX_WAIT, FETCH_BACKOFF_MAX_RETRIES } from './constants';
 /**
- * DefinitionsUpdateWorker factory
+ * DefinitionsUpdateWorker factory for Flags SDKs, where notifications pcn and changeNumber are environment-scoped
  */
-export function DefinitionsUpdateWorker(log, storage, definitionsSyncTask, definitionsEventEmitter, telemetryTracker) {
+export function DefinitionsUpdateWorker(params, pollingManager) {
+    var log = params.settings.log, storage = params.storage, telemetryTracker = params.telemetryTracker, definitionsEventEmitter = params.readiness.definitions;
+    var definitionsSyncTask = pollingManager.definitionsSyncTask;
     var ff = DefinitionsUpdateWorker(storage.definitions);
     var rbs = DefinitionsUpdateWorker(storage.rbSegments);
     function DefinitionsUpdateWorker(cache) {
@@ -93,7 +95,7 @@ export function DefinitionsUpdateWorker(log, storage, definitionsSyncTask, defin
         put: function (parsedData) {
             if (parsedData.d && parsedData.c !== undefined) {
                 try {
-                    var payload = parseFFUpdatePayload(parsedData.c, parsedData.d);
+                    var payload = parseUpdatePayload(parsedData.c, parsedData.d);
                     if (payload) {
                         (parsedData.type === RB_SEGMENT_UPDATE ? rbs : ff).put(parsedData, payload);
                         return;

package/esm/sync/streaming/parseUtils.js

@@ -73,9 +73,9 @@ export function isInBitmap(bitmap, hash64hex) {
     return (bitmap[internal] & 1 << offset) > 0;
 }
 /**
- * Parse feature flags notifications for instant feature flag updates
+ * Parse notifications for instant updates
  */
-export function parseFFUpdatePayload(compression, data) {
+export function parseUpdatePayload(compression, data) {
     return compression > 0 ?
         parseCompressedData(data, compression, false) :
         JSON.parse(decodeFromBase64(data));

package/esm/sync/streaming/pushManager.js

@@ -18,8 +18,9 @@ import { TOKEN_REFRESH, AUTH_REJECTION } from '../../utils/constants';
  * - for server-side if key is not provided in settings.
  * - for client-side, with support for multiple clients, if key is provided in settings
  */
-export function pushManagerFactory(params, pollingManager) {
-    var settings = params.settings, storage = params.storage, serviceApi = params.serviceApi, readiness = params.readiness, platform = params.platform, telemetryTracker = params.telemetryTracker;
+export function pushManagerFactory(params, pollingManager, definitionsUpdateWorkerFactory) {
+    if (definitionsUpdateWorkerFactory === void 0) { definitionsUpdateWorkerFactory = DefinitionsUpdateWorker; }
+    var settings = params.settings, storage = params.storage, serviceApi = params.serviceApi, platform = params.platform, telemetryTracker = params.telemetryTracker;
     // `userKey` is the matching key of main client in client-side SDK.
     // It can be used to check if running on client-side or server-side SDK.
     var userKey = checkIfServerSide(settings) ? undefined : getMatching(settings.core.key);
@@ -41,7 +42,7 @@ export function pushManagerFactory(params, pollingManager) {
     // MySegmentsUpdateWorker (client-side) are initiated in `add` method
     var segmentsUpdateWorker = userKey ? undefined : SegmentsUpdateWorker(log, pollingManager.segmentsSyncTask, storage.segments);
     // For server-side we pass the segmentsSyncTask, used by DefinitionsUpdateWorker to fetch new segments
-    var definitionsUpdateWorker = DefinitionsUpdateWorker(log, storage, pollingManager.definitionsSyncTask, readiness.definitions, telemetryTracker);
+    var definitionsUpdateWorker = definitionsUpdateWorkerFactory(params, pollingManager);
     // [Only for client-side] map of user keys to their corresponding hash64 and MySegmentsUpdateWorkers.
     // Hash64 is used to process membership update events and dispatch actions to the corresponding MySegmentsUpdateWorker.
     var clients = {};

package/package.json

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

package/src/dtos/types.ts

@@ -243,14 +243,14 @@ export interface IDefinition extends TargetingEntity {
 /** Interface of the parsed JSON response of `/splitChanges` */
 export interface IDefinitionChangesResponse {
   d?: {
-    till: number,
-    since?: number | null,
+    till?: number,
+    since?: number,
     updated: IDefinition[],
     removed: string[],
   },
   rbs?: {
-    till: number,
-    since?: number | null,
+    till?: number,
+    since?: number,
     updated: IRBSegment[],
     removed: string[],
   }

package/src/services/authProvider.ts

@@ -1,6 +1,6 @@
 import { ISplitHttpClient, NetworkError } from './types';
-import { IJwtCredential } from '../sync/streaming/AuthClient/types';
-import { fetchAuthFactory } from '../sync/streaming/AuthClient';
+import { IJwtCredential } from './types';
+import { fetchAuthFactory } from './fetchAuth';
 import { Backoff } from '../utils/Backoff';
 import { LOG_PREFIX_SYNC_AUTH } from '../logger/constants';
 import { ISettings } from '../types';

package/src/{sync/streaming/AuthClient/index.ts → services/fetchAuth.ts}

@@ -1,7 +1,6 @@
-import { IJwtCredential, IFetchAuth } from './types';
-import { objectAssign } from '../../../utils/lang/objectAssign';
-import { decodeJWTtoken } from '../../../utils/jwt';
-import { IResponse } from '../../../services/types';
+import { IJwtCredential, IFetchAuth, IResponse } from './types';
+import { objectAssign } from '../utils/lang/objectAssign';
+import { decodeJWTtoken } from '../utils/jwt';
 
 /**
  * Factory of authentication function.

package/src/services/splitApi.ts

@@ -6,7 +6,7 @@ import { objectAssign } from '../utils/lang/objectAssign';
 import { ITelemetryTracker } from '../trackers/types';
 import { SPLITS, IMPRESSIONS, IMPRESSIONS_COUNT, EVENTS, TELEMETRY, TOKEN, SEGMENT, MEMBERSHIPS } from '../utils/constants';
 import { ERROR_TOO_MANY_SETS } from '../logger/constants';
-import { fetchAuthFactory } from '../sync/streaming/AuthClient';
+import { fetchAuthFactory } from './fetchAuth';
 
 const noCacheHeaderOptions = { headers: { 'Cache-Control': 'no-cache' } };