@splitsoftware/splitio-commons 1.17.1-rc.3 → 1.17.1-rc.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/CHANGES.txt +4 -3
  2. package/cjs/readiness/readinessManager.js +13 -4
  3. package/cjs/sdkClient/sdkClientMethodCS.js +3 -7
  4. package/cjs/sdkClient/sdkClientMethodCSWithTT.js +3 -7
  5. package/cjs/sdkFactory/index.js +8 -13
  6. package/cjs/storages/{AbstractSegmentsCacheSync.js → AbstractMySegmentsCacheSync.js} +15 -17
  7. package/cjs/storages/AbstractSplitsCacheAsync.js +7 -0
  8. package/cjs/storages/AbstractSplitsCacheSync.js +7 -0
  9. package/cjs/storages/dataLoader.js +32 -64
  10. package/cjs/storages/inLocalStorage/MySegmentsCacheInLocal.js +5 -5
  11. package/cjs/storages/inLocalStorage/SplitsCacheInLocal.js +9 -1
  12. package/cjs/storages/inLocalStorage/index.js +1 -6
  13. package/cjs/storages/inMemory/InMemoryStorageCS.js +5 -17
  14. package/cjs/storages/inMemory/MySegmentsCacheInMemory.js +5 -5
  15. package/cjs/storages/inMemory/SegmentsCacheInMemory.js +13 -27
  16. package/cjs/storages/inMemory/SplitsCacheInMemory.js +0 -1
  17. package/cjs/storages/inRedis/RedisAdapter.js +1 -1
  18. package/cjs/storages/inRedis/SegmentsCacheInRedis.js +13 -19
  19. package/cjs/storages/pluggable/SegmentsCachePluggable.js +11 -32
  20. package/cjs/storages/pluggable/index.js +32 -37
  21. package/cjs/sync/offline/syncManagerOffline.js +18 -11
  22. package/cjs/sync/offline/syncTasks/fromObjectSyncTask.js +7 -2
  23. package/cjs/sync/polling/pollingManagerSS.js +3 -3
  24. package/cjs/sync/polling/updaters/segmentChangesUpdater.js +12 -28
  25. package/cjs/sync/polling/updaters/splitChangesUpdater.js +10 -1
  26. package/cjs/sync/syncManagerOnline.js +20 -21
  27. package/cjs/trackers/eventTracker.js +1 -1
  28. package/cjs/trackers/impressionsTracker.js +1 -1
  29. package/cjs/utils/settingsValidation/storage/storageCS.js +12 -1
  30. package/esm/readiness/readinessManager.js +13 -4
  31. package/esm/sdkClient/sdkClientMethodCS.js +3 -7
  32. package/esm/sdkClient/sdkClientMethodCSWithTT.js +3 -7
  33. package/esm/sdkFactory/index.js +9 -14
  34. package/esm/storages/{AbstractSegmentsCacheSync.js → AbstractMySegmentsCacheSync.js} +14 -16
  35. package/esm/storages/AbstractSplitsCacheAsync.js +7 -0
  36. package/esm/storages/AbstractSplitsCacheSync.js +7 -0
  37. package/esm/storages/dataLoader.js +30 -61
  38. package/esm/storages/inLocalStorage/MySegmentsCacheInLocal.js +5 -5
  39. package/esm/storages/inLocalStorage/SplitsCacheInLocal.js +9 -1
  40. package/esm/storages/inLocalStorage/index.js +2 -7
  41. package/esm/storages/inMemory/InMemoryStorageCS.js +5 -17
  42. package/esm/storages/inMemory/MySegmentsCacheInMemory.js +5 -5
  43. package/esm/storages/inMemory/SegmentsCacheInMemory.js +13 -27
  44. package/esm/storages/inMemory/SplitsCacheInMemory.js +0 -1
  45. package/esm/storages/inRedis/RedisAdapter.js +1 -1
  46. package/esm/storages/inRedis/SegmentsCacheInRedis.js +13 -19
  47. package/esm/storages/pluggable/SegmentsCachePluggable.js +11 -32
  48. package/esm/storages/pluggable/index.js +32 -37
  49. package/esm/sync/offline/syncManagerOffline.js +18 -11
  50. package/esm/sync/offline/syncTasks/fromObjectSyncTask.js +8 -3
  51. package/esm/sync/polling/pollingManagerSS.js +3 -3
  52. package/esm/sync/polling/updaters/segmentChangesUpdater.js +12 -28
  53. package/esm/sync/polling/updaters/splitChangesUpdater.js +11 -2
  54. package/esm/sync/syncManagerOnline.js +20 -21
  55. package/esm/trackers/eventTracker.js +1 -1
  56. package/esm/trackers/impressionsTracker.js +1 -1
  57. package/esm/utils/settingsValidation/storage/storageCS.js +10 -0
  58. package/package.json +1 -1
  59. package/src/readiness/readinessManager.ts +11 -4
  60. package/src/readiness/types.ts +2 -0
  61. package/src/sdkClient/sdkClientMethodCS.ts +1 -6
  62. package/src/sdkClient/sdkClientMethodCSWithTT.ts +1 -6
  63. package/src/sdkFactory/index.ts +9 -15
  64. package/src/sdkFactory/types.ts +1 -2
  65. package/src/storages/{AbstractSegmentsCacheSync.ts → AbstractMySegmentsCacheSync.ts} +13 -28
  66. package/src/storages/AbstractSplitsCacheAsync.ts +8 -0
  67. package/src/storages/AbstractSplitsCacheSync.ts +8 -0
  68. package/src/storages/dataLoader.ts +32 -62
  69. package/src/storages/inLocalStorage/MySegmentsCacheInLocal.ts +5 -5
  70. package/src/storages/inLocalStorage/SplitsCacheInLocal.ts +10 -1
  71. package/src/storages/inLocalStorage/index.ts +2 -8
  72. package/src/storages/inMemory/InMemoryStorageCS.ts +5 -20
  73. package/src/storages/inMemory/MySegmentsCacheInMemory.ts +5 -5
  74. package/src/storages/inMemory/SegmentsCacheInMemory.ts +12 -26
  75. package/src/storages/inMemory/SplitsCacheInMemory.ts +0 -1
  76. package/src/storages/inRedis/RedisAdapter.ts +1 -1
  77. package/src/storages/inRedis/SegmentsCacheInRedis.ts +13 -22
  78. package/src/storages/pluggable/SegmentsCachePluggable.ts +11 -35
  79. package/src/storages/pluggable/index.ts +33 -38
  80. package/src/storages/types.ts +9 -11
  81. package/src/sync/offline/syncManagerOffline.ts +21 -13
  82. package/src/sync/offline/syncTasks/fromObjectSyncTask.ts +7 -3
  83. package/src/sync/polling/pollingManagerSS.ts +2 -3
  84. package/src/sync/polling/updaters/segmentChangesUpdater.ts +13 -29
  85. package/src/sync/polling/updaters/splitChangesUpdater.ts +11 -3
  86. package/src/sync/syncManagerOnline.ts +17 -17
  87. package/src/sync/types.ts +1 -1
  88. package/src/trackers/eventTracker.ts +1 -1
  89. package/src/trackers/impressionsTracker.ts +1 -1
  90. package/src/types.ts +8 -9
  91. package/src/utils/settingsValidation/storage/storageCS.ts +13 -0
  92. package/types/readiness/types.d.ts +2 -0
  93. package/types/sdkFactory/types.d.ts +1 -2
  94. package/types/storages/AbstractSplitsCacheAsync.d.ts +5 -0
  95. package/types/storages/AbstractSplitsCacheSync.d.ts +5 -0
  96. package/types/storages/dataLoader.d.ts +6 -17
  97. package/types/storages/inLocalStorage/MySegmentsCacheInLocal.d.ts +5 -5
  98. package/types/storages/inLocalStorage/SplitsCacheInLocal.d.ts +6 -0
  99. package/types/storages/inMemory/MySegmentsCacheInMemory.d.ts +5 -5
  100. package/types/storages/inMemory/SegmentsCacheInMemory.d.ts +5 -7
  101. package/types/storages/inMemory/SplitsCacheInMemory.d.ts +0 -1
  102. package/types/storages/inRedis/SegmentsCacheInRedis.d.ts +6 -3
  103. package/types/storages/pluggable/SegmentsCachePluggable.d.ts +4 -16
  104. package/types/storages/types.d.ts +7 -11
  105. package/types/sync/types.d.ts +1 -1
  106. package/types/types.d.ts +8 -8
  107. package/types/utils/settingsValidation/storage/storageCS.d.ts +5 -0
package/CHANGES.txt CHANGED
@@ -1,7 +1,8 @@
1
- 2.0.0 (September XX, 2024)
2
- - Updated internal storage factory to emit the SDK_READY_FROM_CACHE event when it corresponds, to clean up the initialization flow.
3
- - Added `factory.destroy()` method, which invokes the `destroy` method on all SDK clients created by the factory.
1
+ 2.0.0 (October XX, 2024)
4
2
  - Added support for targeting rules based on large segments.
3
+ - Added `factory.destroy()` method, which invokes the `destroy` method on all SDK clients created by the factory.
4
+ - 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.
5
+ - Bugfixing - Fixed an issue with the server-side polling manager that caused dangling timers when the SDK was destroyed before it was ready.
5
6
  - BREAKING CHANGES:
6
7
  - Updated default flag spec version to 1.2.
7
8
  - Removed `/mySegments` endpoint from SplitAPI module, as it is replaced by `/memberships` endpoint.
@@ -7,6 +7,8 @@ function splitsEventEmitterFactory(EventEmitter) {
7
7
  var splitsEventEmitter = (0, objectAssign_1.objectAssign)(new EventEmitter(), {
8
8
  splitsArrived: false,
9
9
  splitsCacheLoaded: false,
10
+ initialized: false,
11
+ initCallbacks: []
10
12
  });
11
13
  // `isSplitKill` condition avoids an edge-case of wrongly emitting SDK_READY if:
12
14
  // - `/memberships` fetch and SPLIT_KILL occurs before `/splitChanges` fetch, and
@@ -45,7 +47,6 @@ function readinessManagerFactory(EventEmitter, settings, splits) {
45
47
  splits.once(constants_1.SDK_SPLITS_CACHE_LOADED, checkIsReadyFromCache);
46
48
  // emit SDK_READY_TIMED_OUT
47
49
  var hasTimedout = false;
48
- var readyTimeoutId;
49
50
  function timeout() {
50
51
  if (hasTimedout || isReady)
51
52
  return;
@@ -53,6 +54,13 @@ function readinessManagerFactory(EventEmitter, settings, splits) {
53
54
  syncLastUpdate();
54
55
  gate.emit(constants_1.SDK_READY_TIMED_OUT, 'Split SDK emitted SDK_READY_TIMED_OUT event.');
55
56
  }
57
+ var readyTimeoutId;
58
+ if (readyTimeout > 0) {
59
+ if (splits.initialized)
60
+ readyTimeoutId = setTimeout(timeout, readyTimeout);
61
+ else
62
+ splits.initCallbacks.push(function () { readyTimeoutId = setTimeout(timeout, readyTimeout); });
63
+ }
56
64
  // emit SDK_READY and SDK_UPDATE
57
65
  var isReady = false;
58
66
  splits.on(constants_1.SDK_SPLITS_ARRIVED, checkIsReadyOrUpdate);
@@ -114,9 +122,10 @@ function readinessManagerFactory(EventEmitter, settings, splits) {
114
122
  // tracking and evaluations, while keeping event listeners to emit SDK_READY_TIMED_OUT event
115
123
  setDestroyed: function () { isDestroyed = true; },
116
124
  init: function () {
117
- if (readyTimeout > 0) {
118
- readyTimeoutId = setTimeout(timeout, readyTimeout);
119
- }
125
+ if (splits.initialized)
126
+ return;
127
+ splits.initialized = true;
128
+ splits.initCallbacks.forEach(function (cb) { return cb(); });
120
129
  },
121
130
  destroy: function () {
122
131
  isDestroyed = true;
@@ -14,7 +14,7 @@ var identity_1 = require("./identity");
14
14
  * Therefore, clients don't have a bound TT for the track method.
15
15
  */
16
16
  function sdkClientMethodCSFactory(params) {
17
- var clients = params.clients, storage = params.storage, syncManager = params.syncManager, sdkReadinessManager = params.sdkReadinessManager, _a = params.settings, key = _a.core.key, log = _a.log, whenInit = params.whenInit;
17
+ var clients = params.clients, storage = params.storage, syncManager = params.syncManager, sdkReadinessManager = params.sdkReadinessManager, _a = params.settings, key = _a.core.key, log = _a.log;
18
18
  var mainClientInstance = (0, clientCS_1.clientCSDecorator)(log, (0, sdkClient_1.sdkClientFactory)(params), key);
19
19
  var parsedDefaultKey = (0, key_2.keyParser)(key);
20
20
  var defaultInstanceId = (0, identity_1.buildInstanceId)(parsedDefaultKey);
@@ -47,18 +47,14 @@ function sdkClientMethodCSFactory(params) {
47
47
  // - Consumer mode: both syncManager and sharedSyncManager are undefined
48
48
  // - Consumer partial mode: syncManager is defined (only for submitters) but sharedSyncManager is undefined
49
49
  // @ts-ignore
50
- var sharedSyncManager_1 = syncManager && sharedStorage && syncManager.shared(matchingKey, sharedSdkReadiness_1.readinessManager, sharedStorage);
50
+ var sharedSyncManager = syncManager && sharedStorage && syncManager.shared(matchingKey, sharedSdkReadiness_1.readinessManager, sharedStorage);
51
51
  // As shared clients reuse all the storage information, we don't need to check here if we
52
52
  // will use offline or online mode. We should stick with the original decision.
53
53
  clients[instanceId] = (0, clientCS_1.clientCSDecorator)(log, (0, sdkClient_1.sdkClientFactory)((0, objectAssign_1.objectAssign)({}, params, {
54
54
  sdkReadinessManager: sharedSdkReadiness_1,
55
55
  storage: sharedStorage || storage,
56
- syncManager: sharedSyncManager_1,
56
+ syncManager: sharedSyncManager,
57
57
  }), true), validKey);
58
- whenInit(function () {
59
- sharedSdkReadiness_1.readinessManager.init();
60
- sharedSyncManager_1 && sharedSyncManager_1.start();
61
- });
62
58
  log.info(constants_1.NEW_SHARED_CLIENT);
63
59
  }
64
60
  else {
@@ -16,7 +16,7 @@ var identity_1 = require("./identity");
16
16
  * (default client) or the client method (shared clients).
17
17
  */
18
18
  function sdkClientMethodCSFactory(params) {
19
- var clients = params.clients, storage = params.storage, syncManager = params.syncManager, sdkReadinessManager = params.sdkReadinessManager, _a = params.settings, _b = _a.core, key = _b.key, trafficType = _b.trafficType, log = _a.log, whenInit = params.whenInit;
19
+ var clients = params.clients, storage = params.storage, syncManager = params.syncManager, sdkReadinessManager = params.sdkReadinessManager, _a = params.settings, _b = _a.core, key = _b.key, trafficType = _b.trafficType, log = _a.log;
20
20
  var mainClientInstance = (0, clientCS_1.clientCSDecorator)(log, (0, sdkClient_1.sdkClientFactory)(params), key, trafficType);
21
21
  var parsedDefaultKey = (0, key_2.keyParser)(key);
22
22
  var defaultInstanceId = (0, identity_1.buildInstanceId)(parsedDefaultKey, trafficType);
@@ -56,18 +56,14 @@ function sdkClientMethodCSFactory(params) {
56
56
  // - Consumer mode: both syncManager and sharedSyncManager are undefined
57
57
  // - Consumer partial mode: syncManager is defined (only for submitters) but sharedSyncManager is undefined
58
58
  // @ts-ignore
59
- var sharedSyncManager_1 = syncManager && sharedStorage && syncManager.shared(matchingKey, sharedSdkReadiness_1.readinessManager, sharedStorage);
59
+ var sharedSyncManager = syncManager && sharedStorage && syncManager.shared(matchingKey, sharedSdkReadiness_1.readinessManager, sharedStorage);
60
60
  // As shared clients reuse all the storage information, we don't need to check here if we
61
61
  // will use offline or online mode. We should stick with the original decision.
62
62
  clients[instanceId] = (0, clientCS_1.clientCSDecorator)(log, (0, sdkClient_1.sdkClientFactory)((0, objectAssign_1.objectAssign)({}, params, {
63
63
  sdkReadinessManager: sharedSdkReadiness_1,
64
64
  storage: sharedStorage || storage,
65
- syncManager: sharedSyncManager_1,
65
+ syncManager: sharedSyncManager,
66
66
  }), true), validKey, validTrafficType);
67
- whenInit(function () {
68
- sharedSdkReadiness_1.readinessManager.init();
69
- sharedSyncManager_1 && sharedSyncManager_1.start();
70
- });
71
67
  log.info(constants_1.NEW_SHARED_CLIENT);
72
68
  }
73
69
  else {
@@ -19,15 +19,15 @@ var constants_3 = require("../utils/constants");
19
19
  * Modular SDK factory
20
20
  */
21
21
  function sdkFactory(params) {
22
- var settings = params.settings, platform = params.platform, storageFactory = params.storageFactory, splitApiFactory = params.splitApiFactory, extraProps = params.extraProps, syncManagerFactory = params.syncManagerFactory, SignalListener = params.SignalListener, impressionsObserverFactory = params.impressionsObserverFactory, integrationsManagerFactory = params.integrationsManagerFactory, sdkManagerFactory = params.sdkManagerFactory, sdkClientMethodFactory = params.sdkClientMethodFactory, filterAdapterFactory = params.filterAdapterFactory, isPure = params.isPure;
22
+ var settings = params.settings, platform = params.platform, storageFactory = params.storageFactory, splitApiFactory = params.splitApiFactory, extraProps = params.extraProps, syncManagerFactory = params.syncManagerFactory, SignalListener = params.SignalListener, impressionsObserverFactory = params.impressionsObserverFactory, integrationsManagerFactory = params.integrationsManagerFactory, sdkManagerFactory = params.sdkManagerFactory, sdkClientMethodFactory = params.sdkClientMethodFactory, filterAdapterFactory = params.filterAdapterFactory, lazyInit = params.lazyInit;
23
23
  var log = settings.log, impressionsMode = settings.sync.impressionsMode;
24
24
  // @TODO handle non-recoverable errors, such as, global `fetch` not available, invalid SDK Key, etc.
25
25
  // On non-recoverable errors, we should mark the SDK as destroyed and not start synchronization.
26
26
  // initialization
27
- var isInit = false;
27
+ var hasInit = false;
28
28
  var initCallbacks = [];
29
29
  function whenInit(cb) {
30
- if (isInit)
30
+ if (hasInit)
31
31
  cb();
32
32
  else
33
33
  initCallbacks.push(cb);
@@ -45,10 +45,8 @@ function sdkFactory(params) {
45
45
  readiness.splits.emit(constants_2.SDK_SPLITS_ARRIVED);
46
46
  readiness.segments.emit(constants_2.SDK_SEGMENTS_ARRIVED);
47
47
  },
48
- onReadyFromCacheCb: function () {
49
- readiness.splits.emit(constants_2.SDK_SPLITS_CACHE_LOADED);
50
- }
51
48
  });
49
+ // @TODO add support for dataloader: `if (params.dataLoader) params.dataLoader(storage);`
52
50
  var clients = {};
53
51
  var telemetryTracker = (0, telemetryTracker_1.telemetryTrackerFactory)(storage.telemetry, platform.now);
54
52
  var integrationsManager = integrationsManagerFactory && integrationsManagerFactory({ settings: settings, storage: storage, telemetryTracker: telemetryTracker });
@@ -69,7 +67,7 @@ function sdkFactory(params) {
69
67
  var eventTracker = (0, eventTracker_1.eventTrackerFactory)(settings, storage.events, whenInit, integrationsManager, storage.telemetry);
70
68
  // splitApi is used by SyncManager and Browser signal listener
71
69
  var splitApi = splitApiFactory && splitApiFactory(settings, platform, telemetryTracker);
72
- var ctx = { clients: clients, splitApi: splitApi, eventTracker: eventTracker, impressionsTracker: impressionsTracker, telemetryTracker: telemetryTracker, uniqueKeysTracker: uniqueKeysTracker, sdkReadinessManager: sdkReadinessManager, readiness: readiness, settings: settings, storage: storage, platform: platform, whenInit: whenInit };
70
+ var ctx = { clients: clients, splitApi: splitApi, eventTracker: eventTracker, impressionsTracker: impressionsTracker, telemetryTracker: telemetryTracker, uniqueKeysTracker: uniqueKeysTracker, sdkReadinessManager: sdkReadinessManager, readiness: readiness, settings: settings, storage: storage, platform: platform };
73
71
  var syncManager = syncManagerFactory && syncManagerFactory(ctx);
74
72
  ctx.syncManager = syncManager;
75
73
  var signalListener = SignalListener && new SignalListener(syncManager, settings, storage, splitApi);
@@ -78,21 +76,18 @@ function sdkFactory(params) {
78
76
  var clientMethod = sdkClientMethodFactory(ctx);
79
77
  var managerInstance = sdkManagerFactory(settings, storage.splits, sdkReadinessManager);
80
78
  function init() {
81
- if (isInit)
79
+ if (hasInit)
82
80
  return;
83
- isInit = true;
81
+ hasInit = true;
84
82
  // We will just log and allow for the SDK to end up throwing an SDK_TIMEOUT event for devs to handle.
85
83
  (0, apiKey_1.validateAndTrackApiKey)(log, settings.core.authorizationKey);
86
84
  readiness.init();
87
- storage.init && storage.init();
88
85
  uniqueKeysTracker && uniqueKeysTracker.start();
89
86
  syncManager && syncManager.start();
90
87
  signalListener && signalListener.start();
91
88
  initCallbacks.forEach(function (cb) { return cb(); });
92
89
  initCallbacks.length = 0;
93
90
  }
94
- if (!isPure)
95
- init();
96
91
  log.info(constants_1.NEW_FACTORY);
97
92
  // @ts-ignore
98
93
  return (0, objectAssign_1.objectAssign)({
@@ -109,6 +104,6 @@ function sdkFactory(params) {
109
104
  destroy: function () {
110
105
  return Promise.all(Object.keys(clients).map(function (key) { return clients[key].destroy(); })).then(function () { });
111
106
  }
112
- }, extraProps && extraProps(ctx), isPure && { init: init });
107
+ }, extraProps && extraProps(ctx), lazyInit ? { init: init } : init());
113
108
  }
114
109
  exports.sdkFactory = sdkFactory;
@@ -1,39 +1,37 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.AbstractSegmentsCacheSync = void 0;
3
+ exports.AbstractMySegmentsCacheSync = void 0;
4
4
  /**
5
5
  * This class provides a skeletal implementation of the ISegmentsCacheSync interface
6
6
  * to minimize the effort required to implement this interface.
7
7
  */
8
- var AbstractSegmentsCacheSync = /** @class */ (function () {
9
- function AbstractSegmentsCacheSync() {
8
+ var AbstractMySegmentsCacheSync = /** @class */ (function () {
9
+ function AbstractMySegmentsCacheSync() {
10
10
  }
11
11
  /**
12
12
  * clear the cache.
13
13
  */
14
- AbstractSegmentsCacheSync.prototype.clear = function () {
14
+ AbstractMySegmentsCacheSync.prototype.clear = function () {
15
15
  this.resetSegments({});
16
16
  };
17
- /**
18
- * For server-side synchronizer: add the given list of segments to the cache, with an empty list of keys. The segments that already exist are not modified.
19
- * For client-side synchronizer: the method is not used.
20
- */
21
- AbstractSegmentsCacheSync.prototype.registerSegments = function (names) { return false; };
17
+ // No-op. Not used in client-side.
18
+ AbstractMySegmentsCacheSync.prototype.registerSegments = function () { return false; };
19
+ AbstractMySegmentsCacheSync.prototype.update = function () { return false; };
22
20
  /**
23
21
  * For server-side synchronizer: the method is not used.
24
22
  * For client-side synchronizer: it resets or updates the cache.
25
23
  */
26
- AbstractSegmentsCacheSync.prototype.resetSegments = function (segmentsData) {
24
+ AbstractMySegmentsCacheSync.prototype.resetSegments = function (segmentsData) {
27
25
  var _this = this;
28
- this.setChangeNumber(undefined, segmentsData.cn);
26
+ this.setChangeNumber(segmentsData.cn);
29
27
  var _a = segmentsData, added = _a.added, removed = _a.removed;
30
28
  if (added && removed) {
31
29
  var isDiff_1 = false;
32
30
  added.forEach(function (segment) {
33
- isDiff_1 = _this.addToSegment(segment) || isDiff_1;
31
+ isDiff_1 = _this.addSegment(segment) || isDiff_1;
34
32
  });
35
33
  removed.forEach(function (segment) {
36
- isDiff_1 = _this.removeFromSegment(segment) || isDiff_1;
34
+ isDiff_1 = _this.removeSegment(segment) || isDiff_1;
37
35
  });
38
36
  return isDiff_1;
39
37
  }
@@ -50,13 +48,13 @@ var AbstractSegmentsCacheSync = /** @class */ (function () {
50
48
  return false;
51
49
  // Slowest path => add and/or remove segments
52
50
  for (var removeIndex = index; removeIndex < storedSegmentKeys.length; removeIndex++) {
53
- this.removeFromSegment(storedSegmentKeys[removeIndex]);
51
+ this.removeSegment(storedSegmentKeys[removeIndex]);
54
52
  }
55
53
  for (var addIndex = index; addIndex < names.length; addIndex++) {
56
- this.addToSegment(names[addIndex]);
54
+ this.addSegment(names[addIndex]);
57
55
  }
58
56
  return true;
59
57
  };
60
- return AbstractSegmentsCacheSync;
58
+ return AbstractMySegmentsCacheSync;
61
59
  }());
62
- exports.AbstractSegmentsCacheSync = AbstractSegmentsCacheSync;
60
+ exports.AbstractMySegmentsCacheSync = AbstractMySegmentsCacheSync;
@@ -14,6 +14,13 @@ var AbstractSplitsCacheAsync = /** @class */ (function () {
14
14
  AbstractSplitsCacheAsync.prototype.usesSegments = function () {
15
15
  return Promise.resolve(true);
16
16
  };
17
+ /**
18
+ * Check if the splits information is already stored in cache.
19
+ * Noop, just keeping the interface. This is used by client-side implementations only.
20
+ */
21
+ AbstractSplitsCacheAsync.prototype.checkCache = function () {
22
+ return Promise.resolve(false);
23
+ };
17
24
  /**
18
25
  * Kill `name` split and set `defaultTreatment` and `changeNumber`.
19
26
  * Used for SPLIT_KILL push notifications.
@@ -30,6 +30,13 @@ var AbstractSplitsCacheSync = /** @class */ (function () {
30
30
  var _this = this;
31
31
  return this.getSplitNames().map(function (key) { return _this.getSplit(key); });
32
32
  };
33
+ /**
34
+ * Check if the splits information is already stored in cache. This data can be preloaded.
35
+ * It is used as condition to emit SDK_SPLITS_CACHE_LOADED, and then SDK_READY_FROM_CACHE.
36
+ */
37
+ AbstractSplitsCacheSync.prototype.checkCache = function () {
38
+ return false;
39
+ };
33
40
  /**
34
41
  * Kill `name` split and set `defaultTreatment` and `changeNumber`.
35
42
  * Used for SPLIT_KILL push notifications.
@@ -1,83 +1,51 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getSnapshot = exports.loadData = void 0;
4
- var sets_1 = require("../utils/lang/sets");
5
- var key_1 = require("../utils/key");
3
+ exports.dataLoaderFactory = void 0;
4
+ var browser_1 = require("../utils/constants/browser");
6
5
  /**
7
- * Storage-agnostic adaptation of `loadDataIntoLocalStorage` function
8
- * (https://github.com/godaddy/split-javascript-data-loader/blob/master/src/load-data.js)
6
+ * Factory of client-side storage loader
9
7
  *
10
- * @param preloadedData validated data following the format proposed in https://github.com/godaddy/split-javascript-data-loader and extended with a `mySegmentsData` property.
11
- * @param storage object containing `splits` and `segments` cache (client-side variant)
12
- * @param userKey user key (matching key) of the provided MySegmentsCache
13
- *
14
- * @TODO extend to load largeSegments
15
- * @TODO extend to load data on shared mySegments storages. Be specific when emitting SDK_READY_FROM_CACHE on shared clients. Maybe the serializer should provide the `useSegments` flag.
16
- * @TODO add logs, and input validation in this module, in favor of size reduction.
17
- * @TODO unit tests
8
+ * @param preloadedData validated data following the format proposed in https://github.com/godaddy/split-javascript-data-loader
9
+ * and extended with a `mySegmentsData` property.
10
+ * @returns function to preload the storage
18
11
  */
19
- function loadData(preloadedData, storage, matchingKey) {
20
- // Do not load data if current preloadedData is empty
21
- if (Object.keys(preloadedData).length === 0)
22
- return;
23
- var _a = preloadedData.segmentsData, segmentsData = _a === void 0 ? {} : _a, _b = preloadedData.since, since = _b === void 0 ? -1 : _b, _c = preloadedData.splitsData, splitsData = _c === void 0 ? [] : _c;
24
- if (storage.splits) {
12
+ function dataLoaderFactory(preloadedData) {
13
+ /**
14
+ * Storage-agnostic adaptation of `loadDataIntoLocalStorage` function
15
+ * (https://github.com/godaddy/split-javascript-data-loader/blob/master/src/load-data.js)
16
+ *
17
+ * @param storage object containing `splits` and `segments` cache (client-side variant)
18
+ * @param userId user key string of the provided MySegmentsCache
19
+ *
20
+ * @TODO extend to support SegmentsCache (server-side variant) by making `userId` optional and adding the corresponding logic.
21
+ * @TODO extend to load data on shared mySegments storages. Be specific when emitting SDK_READY_FROM_CACHE on shared clients. Maybe the serializer should provide the `useSegments` flag.
22
+ */
23
+ return function loadData(storage, userId) {
24
+ // Do not load data if current preloadedData is empty
25
+ if (Object.keys(preloadedData).length === 0)
26
+ return;
27
+ var _a = preloadedData.lastUpdated, lastUpdated = _a === void 0 ? -1 : _a, _b = preloadedData.segmentsData, segmentsData = _b === void 0 ? {} : _b, _c = preloadedData.since, since = _c === void 0 ? -1 : _c, _d = preloadedData.splitsData, splitsData = _d === void 0 ? {} : _d;
25
28
  var storedSince = storage.splits.getChangeNumber();
26
- // Do not load data if current data is more recent
27
- if (storedSince > since)
29
+ var expirationTimestamp = Date.now() - browser_1.DEFAULT_CACHE_EXPIRATION_IN_MILLIS;
30
+ // Do not load data if current localStorage data is more recent,
31
+ // or if its `lastUpdated` timestamp is older than the given `expirationTimestamp`,
32
+ if (storedSince > since || lastUpdated < expirationTimestamp)
28
33
  return;
29
34
  // cleaning up the localStorage data, since some cached splits might need be part of the preloaded data
30
35
  storage.splits.clear();
31
36
  storage.splits.setChangeNumber(since);
32
37
  // splitsData in an object where the property is the split name and the pertaining value is a stringified json of its data
33
- storage.splits.addSplits(splitsData.map(function (split) { return ([split.name, split]); }));
34
- }
35
- if (matchingKey) { // add mySegments data (client-side)
36
- var mySegmentsData = preloadedData.mySegmentsData && preloadedData.mySegmentsData[matchingKey];
38
+ storage.splits.addSplits(Object.keys(splitsData).map(function (splitName) { return JSON.parse(splitsData[splitName]); }));
39
+ // add mySegments data
40
+ var mySegmentsData = preloadedData.mySegmentsData && preloadedData.mySegmentsData[userId];
37
41
  if (!mySegmentsData) {
38
42
  // segmentsData in an object where the property is the segment name and the pertaining value is a stringified object that contains the `added` array of userIds
39
43
  mySegmentsData = Object.keys(segmentsData).filter(function (segmentName) {
40
- var matchingKeys = segmentsData[segmentName];
41
- return matchingKeys.indexOf(matchingKey) > -1;
44
+ var userIds = JSON.parse(segmentsData[segmentName]).added;
45
+ return Array.isArray(userIds) && userIds.indexOf(userId) > -1;
42
46
  });
43
47
  }
44
48
  storage.segments.resetSegments({ k: mySegmentsData.map(function (s) { return ({ n: s }); }) });
45
- }
46
- else { // add segments data (server-side)
47
- Object.keys(segmentsData).filter(function (segmentName) {
48
- var matchingKeys = segmentsData[segmentName];
49
- storage.segments.addToSegment(segmentName, matchingKeys);
50
- });
51
- }
52
- }
53
- exports.loadData = loadData;
54
- function getSnapshot(storage, userKeys) {
55
- return {
56
- // lastUpdated: Date.now(),
57
- since: storage.splits.getChangeNumber(),
58
- splitsData: storage.splits.getAll(),
59
- segmentsData: userKeys ?
60
- undefined : // @ts-ignore accessing private prop
61
- Object.keys(storage.segments.segmentCache).reduce(function (prev, cur) {
62
- prev[cur] = (0, sets_1.setToArray)(storage.segments.segmentCache[cur]);
63
- return prev;
64
- }, {}),
65
- mySegmentsData: userKeys ?
66
- userKeys.reduce(function (prev, userKey) {
67
- prev[(0, key_1.getMatching)(userKey)] = storage.shared ?
68
- // Client-side segments
69
- // @ts-ignore accessing private prop
70
- Object.keys(storage.shared(userKey).segments.segmentCache) :
71
- // Server-side segments
72
- // @ts-ignore accessing private prop
73
- Object.keys(storage.segments.segmentCache).reduce(function (prev, segmentName) {
74
- return storage.segments.segmentCache[segmentName].has(userKey) ?
75
- prev.concat(segmentName) :
76
- prev;
77
- }, []);
78
- return prev;
79
- }, {}) :
80
- undefined
81
49
  };
82
50
  }
83
- exports.getSnapshot = getSnapshot;
51
+ exports.dataLoaderFactory = dataLoaderFactory;
@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.MySegmentsCacheInLocal = void 0;
4
4
  var tslib_1 = require("tslib");
5
5
  var lang_1 = require("../../utils/lang");
6
- var AbstractSegmentsCacheSync_1 = require("../AbstractSegmentsCacheSync");
6
+ var AbstractMySegmentsCacheSync_1 = require("../AbstractMySegmentsCacheSync");
7
7
  var constants_1 = require("./constants");
8
8
  var MySegmentsCacheInLocal = /** @class */ (function (_super) {
9
9
  (0, tslib_1.__extends)(MySegmentsCacheInLocal, _super);
@@ -14,7 +14,7 @@ var MySegmentsCacheInLocal = /** @class */ (function (_super) {
14
14
  return _this;
15
15
  // There is not need to flush segments cache like splits cache, since resetSegments receives the up-to-date list of active segments
16
16
  }
17
- MySegmentsCacheInLocal.prototype.addToSegment = function (name) {
17
+ MySegmentsCacheInLocal.prototype.addSegment = function (name) {
18
18
  var segmentKey = this.keys.buildSegmentNameKey(name);
19
19
  try {
20
20
  if (localStorage.getItem(segmentKey) === constants_1.DEFINED)
@@ -27,7 +27,7 @@ var MySegmentsCacheInLocal = /** @class */ (function (_super) {
27
27
  return false;
28
28
  }
29
29
  };
30
- MySegmentsCacheInLocal.prototype.removeFromSegment = function (name) {
30
+ MySegmentsCacheInLocal.prototype.removeSegment = function (name) {
31
31
  var segmentKey = this.keys.buildSegmentNameKey(name);
32
32
  try {
33
33
  if (localStorage.getItem(segmentKey) !== constants_1.DEFINED)
@@ -76,7 +76,7 @@ var MySegmentsCacheInLocal = /** @class */ (function (_super) {
76
76
  MySegmentsCacheInLocal.prototype.getKeysCount = function () {
77
77
  return 1;
78
78
  };
79
- MySegmentsCacheInLocal.prototype.setChangeNumber = function (name, changeNumber) {
79
+ MySegmentsCacheInLocal.prototype.setChangeNumber = function (changeNumber) {
80
80
  try {
81
81
  if (changeNumber)
82
82
  localStorage.setItem(this.keys.buildTillKey(), changeNumber + '');
@@ -97,5 +97,5 @@ var MySegmentsCacheInLocal = /** @class */ (function (_super) {
97
97
  return n;
98
98
  };
99
99
  return MySegmentsCacheInLocal;
100
- }(AbstractSegmentsCacheSync_1.AbstractSegmentsCacheSync));
100
+ }(AbstractMySegmentsCacheSync_1.AbstractMySegmentsCacheSync));
101
101
  exports.MySegmentsCacheInLocal = MySegmentsCacheInLocal;
@@ -186,6 +186,14 @@ var SplitsCacheInLocal = /** @class */ (function (_super) {
186
186
  return true;
187
187
  }
188
188
  };
189
+ /**
190
+ * Check if the splits information is already stored in browser LocalStorage.
191
+ * In this function we could add more code to check if the data is valid.
192
+ * @override
193
+ */
194
+ SplitsCacheInLocal.prototype.checkCache = function () {
195
+ return this.getChangeNumber() > -1;
196
+ };
189
197
  /**
190
198
  * Clean Splits cache if its `lastUpdated` timestamp is older than the given `expirationTimestamp`,
191
199
  *
@@ -208,7 +216,7 @@ var SplitsCacheInLocal = /** @class */ (function (_super) {
208
216
  // mark cache to update the new query filter on first successful splits fetch
209
217
  this.updateNewFilter = true;
210
218
  // if there is cache, clear it
211
- if (this.getChangeNumber() > -1)
219
+ if (this.checkCache())
212
220
  this.clear();
213
221
  }
214
222
  catch (e) {
@@ -30,7 +30,7 @@ function InLocalStorage(options) {
30
30
  params.settings.log.warn(constants_1.LOG_PREFIX + 'LocalStorage API is unavailable. Falling back to default MEMORY storage');
31
31
  return (0, InMemoryStorageCS_1.InMemoryStorageCSFactory)(params);
32
32
  }
33
- var onReadyFromCacheCb = params.onReadyFromCacheCb, settings = params.settings, _a = params.settings, log = _a.log, _b = _a.scheduler, impressionsQueueSize = _b.impressionsQueueSize, eventsQueueSize = _b.eventsQueueSize, _c = _a.sync, impressionsMode = _c.impressionsMode, __splitFiltersValidation = _c.__splitFiltersValidation;
33
+ var settings = params.settings, _a = params.settings, log = _a.log, _b = _a.scheduler, impressionsQueueSize = _b.impressionsQueueSize, eventsQueueSize = _b.eventsQueueSize, _c = _a.sync, impressionsMode = _c.impressionsMode, __splitFiltersValidation = _c.__splitFiltersValidation;
34
34
  var matchingKey = (0, key_1.getMatching)(settings.core.key);
35
35
  var keys = new KeyBuilderCS_1.KeyBuilderCS(prefix, matchingKey);
36
36
  var expirationTimestamp = Date.now() - browser_1.DEFAULT_CACHE_EXPIRATION_IN_MILLIS;
@@ -46,11 +46,6 @@ function InLocalStorage(options) {
46
46
  events: new EventsCacheInMemory_1.EventsCacheInMemory(eventsQueueSize),
47
47
  telemetry: (0, TelemetryCacheInMemory_1.shouldRecordTelemetry)(params) ? new TelemetryCacheInMemory_1.TelemetryCacheInMemory(splits, segments) : undefined,
48
48
  uniqueKeys: impressionsMode === constants_2.NONE ? new UniqueKeysCacheInMemoryCS_1.UniqueKeysCacheInMemoryCS() : undefined,
49
- init: function () {
50
- if (settings.mode === constants_2.LOCALHOST_MODE || splits.getChangeNumber() > -1) {
51
- Promise.resolve().then(onReadyFromCacheCb);
52
- }
53
- },
54
49
  destroy: function () {
55
50
  var _a;
56
51
  this.splits = new SplitsCacheInMemory_1.SplitsCacheInMemory(__splitFiltersValidation);
@@ -9,15 +9,13 @@ var ImpressionCountsCacheInMemory_1 = require("./ImpressionCountsCacheInMemory")
9
9
  var constants_1 = require("../../utils/constants");
10
10
  var TelemetryCacheInMemory_1 = require("./TelemetryCacheInMemory");
11
11
  var UniqueKeysCacheInMemoryCS_1 = require("./UniqueKeysCacheInMemoryCS");
12
- var key_1 = require("../../utils/key");
13
- var dataLoader_1 = require("../dataLoader");
14
12
  /**
15
13
  * InMemory storage factory for standalone client-side SplitFactory
16
14
  *
17
15
  * @param params parameters required by EventsCacheSync
18
16
  */
19
17
  function InMemoryStorageCSFactory(params) {
20
- var _a = params.settings, _b = _a.scheduler, impressionsQueueSize = _b.impressionsQueueSize, eventsQueueSize = _b.eventsQueueSize, _c = _a.sync, impressionsMode = _c.impressionsMode, __splitFiltersValidation = _c.__splitFiltersValidation, preloadedData = _a.preloadedData, onReadyFromCacheCb = params.onReadyFromCacheCb;
18
+ var _a = params.settings, _b = _a.scheduler, impressionsQueueSize = _b.impressionsQueueSize, eventsQueueSize = _b.eventsQueueSize, _c = _a.sync, impressionsMode = _c.impressionsMode, __splitFiltersValidation = _c.__splitFiltersValidation;
21
19
  var splits = new SplitsCacheInMemory_1.SplitsCacheInMemory(__splitFiltersValidation);
22
20
  var segments = new MySegmentsCacheInMemory_1.MySegmentsCacheInMemory();
23
21
  var largeSegments = new MySegmentsCacheInMemory_1.MySegmentsCacheInMemory();
@@ -41,16 +39,11 @@ function InMemoryStorageCSFactory(params) {
41
39
  this.uniqueKeys && this.uniqueKeys.clear();
42
40
  },
43
41
  // When using shared instanciation with MEMORY we reuse everything but segments (they are unique per key)
44
- shared: function (matchingKey) {
45
- var segments = new MySegmentsCacheInMemory_1.MySegmentsCacheInMemory();
46
- var largeSegments = new MySegmentsCacheInMemory_1.MySegmentsCacheInMemory();
47
- if (preloadedData) {
48
- (0, dataLoader_1.loadData)(preloadedData, { segments: segments, largeSegments: largeSegments }, matchingKey);
49
- }
42
+ shared: function () {
50
43
  return {
51
44
  splits: this.splits,
52
- segments: segments,
53
- largeSegments: largeSegments,
45
+ segments: new MySegmentsCacheInMemory_1.MySegmentsCacheInMemory(),
46
+ largeSegments: new MySegmentsCacheInMemory_1.MySegmentsCacheInMemory(),
54
47
  impressions: this.impressions,
55
48
  impressionCounts: this.impressionCounts,
56
49
  events: this.events,
@@ -65,7 +58,7 @@ function InMemoryStorageCSFactory(params) {
65
58
  },
66
59
  };
67
60
  // @TODO revisit storage logic in localhost mode
68
- // No tracking data in localhost mode to avoid memory leaks
61
+ // No tracking in localhost mode to avoid memory leaks: https://github.com/splitio/javascript-commons/issues/181
69
62
  if (params.settings.mode === constants_1.LOCALHOST_MODE) {
70
63
  var noopTrack = function () { return true; };
71
64
  storage.impressions.track = noopTrack;
@@ -75,11 +68,6 @@ function InMemoryStorageCSFactory(params) {
75
68
  if (storage.uniqueKeys)
76
69
  storage.uniqueKeys.track = noopTrack;
77
70
  }
78
- if (preloadedData) {
79
- (0, dataLoader_1.loadData)(preloadedData, storage, (0, key_1.getMatching)(params.settings.core.key));
80
- if (splits.getChangeNumber() > -1)
81
- onReadyFromCacheCb();
82
- }
83
71
  return storage;
84
72
  }
85
73
  exports.InMemoryStorageCSFactory = InMemoryStorageCSFactory;
@@ -2,7 +2,7 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.MySegmentsCacheInMemory = void 0;
4
4
  var tslib_1 = require("tslib");
5
- var AbstractSegmentsCacheSync_1 = require("../AbstractSegmentsCacheSync");
5
+ var AbstractMySegmentsCacheSync_1 = require("../AbstractMySegmentsCacheSync");
6
6
  /**
7
7
  * Default MySegmentsCacheInMemory implementation that stores MySegments in memory.
8
8
  * Supported by all JS runtimes.
@@ -14,13 +14,13 @@ var MySegmentsCacheInMemory = /** @class */ (function (_super) {
14
14
  _this.segmentCache = {};
15
15
  return _this;
16
16
  }
17
- MySegmentsCacheInMemory.prototype.addToSegment = function (name) {
17
+ MySegmentsCacheInMemory.prototype.addSegment = function (name) {
18
18
  if (this.segmentCache[name])
19
19
  return false;
20
20
  this.segmentCache[name] = true;
21
21
  return true;
22
22
  };
23
- MySegmentsCacheInMemory.prototype.removeFromSegment = function (name) {
23
+ MySegmentsCacheInMemory.prototype.removeSegment = function (name) {
24
24
  if (!this.segmentCache[name])
25
25
  return false;
26
26
  delete this.segmentCache[name];
@@ -29,7 +29,7 @@ var MySegmentsCacheInMemory = /** @class */ (function (_super) {
29
29
  MySegmentsCacheInMemory.prototype.isInSegment = function (name) {
30
30
  return this.segmentCache[name] === true;
31
31
  };
32
- MySegmentsCacheInMemory.prototype.setChangeNumber = function (name, changeNumber) {
32
+ MySegmentsCacheInMemory.prototype.setChangeNumber = function (changeNumber) {
33
33
  this.cn = changeNumber;
34
34
  };
35
35
  MySegmentsCacheInMemory.prototype.getChangeNumber = function () {
@@ -42,5 +42,5 @@ var MySegmentsCacheInMemory = /** @class */ (function (_super) {
42
42
  return 1;
43
43
  };
44
44
  return MySegmentsCacheInMemory;
45
- }(AbstractSegmentsCacheSync_1.AbstractSegmentsCacheSync));
45
+ }(AbstractMySegmentsCacheSync_1.AbstractMySegmentsCacheSync));
46
46
  exports.MySegmentsCacheInMemory = MySegmentsCacheInMemory;