@splitsoftware/splitio-commons 2.1.0-rc.0 → 2.1.0-rc.2

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 (76) hide show
  1. package/CHANGES.txt +11 -0
  2. package/LICENSE +1 -1
  3. package/cjs/evaluator/index.js +2 -0
  4. package/cjs/evaluator/matchers/large_segment.js +0 -6
  5. package/cjs/evaluator/matchers/segment.js +0 -6
  6. package/cjs/listeners/browser.js +4 -6
  7. package/cjs/readiness/readinessManager.js +6 -0
  8. package/cjs/sdkClient/client.js +14 -11
  9. package/cjs/sdkClient/sdkClient.js +1 -1
  10. package/cjs/sdkFactory/index.js +9 -14
  11. package/cjs/sdkManager/index.js +2 -1
  12. package/cjs/storages/inLocalStorage/index.js +4 -3
  13. package/cjs/storages/inLocalStorage/validateCache.js +1 -2
  14. package/cjs/storages/inMemory/InMemoryStorage.js +5 -7
  15. package/cjs/storages/inMemory/InMemoryStorageCS.js +6 -7
  16. package/cjs/storages/inRedis/SplitsCacheInRedis.js +1 -1
  17. package/cjs/storages/inRedis/index.js +9 -13
  18. package/cjs/storages/pluggable/index.js +15 -19
  19. package/cjs/sync/submitters/impressionCountsSubmitter.js +2 -4
  20. package/cjs/sync/submitters/submitterManager.js +3 -6
  21. package/cjs/trackers/impressionsTracker.js +17 -18
  22. package/cjs/trackers/strategy/strategyDebug.js +4 -11
  23. package/cjs/trackers/strategy/strategyNone.js +11 -16
  24. package/cjs/trackers/strategy/strategyOptimized.js +11 -21
  25. package/esm/evaluator/index.js +2 -0
  26. package/esm/evaluator/matchers/large_segment.js +0 -6
  27. package/esm/evaluator/matchers/segment.js +0 -6
  28. package/esm/listeners/browser.js +1 -3
  29. package/esm/readiness/readinessManager.js +6 -0
  30. package/esm/sdkClient/client.js +14 -11
  31. package/esm/sdkClient/sdkClient.js +1 -1
  32. package/esm/sdkFactory/index.js +10 -15
  33. package/esm/sdkManager/index.js +2 -1
  34. package/esm/storages/inLocalStorage/index.js +5 -4
  35. package/esm/storages/inLocalStorage/validateCache.js +1 -2
  36. package/esm/storages/inMemory/InMemoryStorage.js +6 -8
  37. package/esm/storages/inMemory/InMemoryStorageCS.js +7 -8
  38. package/esm/storages/inRedis/SplitsCacheInRedis.js +1 -1
  39. package/esm/storages/inRedis/index.js +10 -14
  40. package/esm/storages/pluggable/index.js +16 -20
  41. package/esm/sync/submitters/impressionCountsSubmitter.js +2 -4
  42. package/esm/sync/submitters/submitterManager.js +3 -6
  43. package/esm/trackers/impressionsTracker.js +17 -18
  44. package/esm/trackers/strategy/strategyDebug.js +4 -11
  45. package/esm/trackers/strategy/strategyNone.js +11 -16
  46. package/esm/trackers/strategy/strategyOptimized.js +11 -21
  47. package/package.json +1 -1
  48. package/src/dtos/types.ts +2 -1
  49. package/src/evaluator/index.ts +2 -0
  50. package/src/evaluator/matchers/large_segment.ts +0 -7
  51. package/src/evaluator/matchers/segment.ts +0 -7
  52. package/src/evaluator/types.ts +1 -1
  53. package/src/listeners/browser.ts +1 -3
  54. package/src/readiness/readinessManager.ts +5 -0
  55. package/src/sdkClient/client.ts +19 -15
  56. package/src/sdkClient/sdkClient.ts +1 -1
  57. package/src/sdkFactory/index.ts +11 -16
  58. package/src/sdkFactory/types.ts +1 -1
  59. package/src/sdkManager/index.ts +2 -1
  60. package/src/storages/inLocalStorage/index.ts +5 -4
  61. package/src/storages/inLocalStorage/validateCache.ts +1 -2
  62. package/src/storages/inMemory/InMemoryStorage.ts +6 -6
  63. package/src/storages/inMemory/InMemoryStorageCS.ts +7 -6
  64. package/src/storages/inRedis/SplitsCacheInRedis.ts +1 -1
  65. package/src/storages/inRedis/index.ts +10 -10
  66. package/src/storages/pluggable/index.ts +16 -20
  67. package/src/storages/types.ts +2 -2
  68. package/src/sync/submitters/impressionCountsSubmitter.ts +2 -4
  69. package/src/sync/submitters/submitterManager.ts +3 -4
  70. package/src/sync/submitters/uniqueKeysSubmitter.ts +2 -3
  71. package/src/trackers/impressionsTracker.ts +18 -19
  72. package/src/trackers/strategy/strategyDebug.ts +4 -11
  73. package/src/trackers/strategy/strategyNone.ts +11 -17
  74. package/src/trackers/strategy/strategyOptimized.ts +10 -20
  75. package/src/trackers/types.ts +13 -8
  76. package/types/splitio.d.ts +4 -0
@@ -4,7 +4,7 @@ import { ImpressionsCacheInMemory } from './ImpressionsCacheInMemory';
4
4
  import { EventsCacheInMemory } from './EventsCacheInMemory';
5
5
  import { IStorageSync, IStorageFactoryParams } from '../types';
6
6
  import { ImpressionCountsCacheInMemory } from './ImpressionCountsCacheInMemory';
7
- import { DEBUG, LOCALHOST_MODE, NONE, STORAGE_MEMORY } from '../../utils/constants';
7
+ import { LOCALHOST_MODE, STORAGE_MEMORY } from '../../utils/constants';
8
8
  import { shouldRecordTelemetry, TelemetryCacheInMemory } from './TelemetryCacheInMemory';
9
9
  import { UniqueKeysCacheInMemoryCS } from './UniqueKeysCacheInMemoryCS';
10
10
 
@@ -14,7 +14,7 @@ import { UniqueKeysCacheInMemoryCS } from './UniqueKeysCacheInMemoryCS';
14
14
  * @param params - parameters required by EventsCacheSync
15
15
  */
16
16
  export function InMemoryStorageCSFactory(params: IStorageFactoryParams): IStorageSync {
17
- const { settings: { scheduler: { impressionsQueueSize, eventsQueueSize, }, sync: { impressionsMode, __splitFiltersValidation } } } = params;
17
+ const { settings: { scheduler: { impressionsQueueSize, eventsQueueSize }, sync: { __splitFiltersValidation } } } = params;
18
18
 
19
19
  const splits = new SplitsCacheInMemory(__splitFiltersValidation);
20
20
  const segments = new MySegmentsCacheInMemory();
@@ -25,10 +25,10 @@ export function InMemoryStorageCSFactory(params: IStorageFactoryParams): IStorag
25
25
  segments,
26
26
  largeSegments,
27
27
  impressions: new ImpressionsCacheInMemory(impressionsQueueSize),
28
- impressionCounts: impressionsMode !== DEBUG ? new ImpressionCountsCacheInMemory() : undefined,
28
+ impressionCounts: new ImpressionCountsCacheInMemory(),
29
29
  events: new EventsCacheInMemory(eventsQueueSize),
30
30
  telemetry: shouldRecordTelemetry(params) ? new TelemetryCacheInMemory(splits, segments) : undefined,
31
- uniqueKeys: impressionsMode === NONE ? new UniqueKeysCacheInMemoryCS() : undefined,
31
+ uniqueKeys: new UniqueKeysCacheInMemoryCS(),
32
32
 
33
33
  destroy() { },
34
34
 
@@ -42,6 +42,7 @@ export function InMemoryStorageCSFactory(params: IStorageFactoryParams): IStorag
42
42
  impressionCounts: this.impressionCounts,
43
43
  events: this.events,
44
44
  telemetry: this.telemetry,
45
+ uniqueKeys: this.uniqueKeys,
45
46
 
46
47
  destroy() { }
47
48
  };
@@ -54,8 +55,8 @@ export function InMemoryStorageCSFactory(params: IStorageFactoryParams): IStorag
54
55
  const noopTrack = () => true;
55
56
  storage.impressions.track = noopTrack;
56
57
  storage.events.track = noopTrack;
57
- if (storage.impressionCounts) storage.impressionCounts.track = noopTrack;
58
- if (storage.uniqueKeys) storage.uniqueKeys.track = noopTrack;
58
+ storage.impressionCounts.track = noopTrack;
59
+ storage.uniqueKeys.track = noopTrack;
59
60
  }
60
61
 
61
62
  return storage;
@@ -266,10 +266,10 @@ export class SplitsCacheInRedis extends AbstractSplitsCacheAsync {
266
266
  return Promise.reject(this.redisError);
267
267
  }
268
268
 
269
- const splits: Record<string, ISplit | null> = {};
270
269
  const keys = names.map(name => this.keys.buildSplitKey(name));
271
270
  return this.redis.mget(...keys)
272
271
  .then(splitDefinitions => {
272
+ const splits: Record<string, ISplit | null> = {};
273
273
  names.forEach((name, idx) => {
274
274
  const split = splitDefinitions[idx];
275
275
  splits[name] = split && JSON.parse(split);
@@ -6,7 +6,7 @@ import { SplitsCacheInRedis } from './SplitsCacheInRedis';
6
6
  import { SegmentsCacheInRedis } from './SegmentsCacheInRedis';
7
7
  import { ImpressionsCacheInRedis } from './ImpressionsCacheInRedis';
8
8
  import { EventsCacheInRedis } from './EventsCacheInRedis';
9
- import { DEBUG, NONE, STORAGE_REDIS } from '../../utils/constants';
9
+ import { STORAGE_REDIS } from '../../utils/constants';
10
10
  import { TelemetryCacheInRedis } from './TelemetryCacheInRedis';
11
11
  import { UniqueKeysCacheInRedis } from './UniqueKeysCacheInRedis';
12
12
  import { ImpressionCountsCacheInRedis } from './ImpressionCountsCacheInRedis';
@@ -30,19 +30,19 @@ export function InRedisStorage(options: InRedisStorageOptions = {}): IStorageAsy
30
30
  const prefix = validatePrefix(options.prefix);
31
31
 
32
32
  function InRedisStorageFactory(params: IStorageFactoryParams): IStorageAsync {
33
- const { onReadyCb, settings, settings: { log, sync: { impressionsMode } } } = params;
33
+ const { onReadyCb, settings, settings: { log } } = params;
34
34
  const metadata = metadataBuilder(settings);
35
35
  const keys = new KeyBuilderSS(prefix, metadata);
36
36
  const redisClient: RedisAdapter = new RD(log, options.options || {});
37
37
  const telemetry = new TelemetryCacheInRedis(log, keys, redisClient);
38
- const impressionCountsCache = impressionsMode !== DEBUG ? new ImpressionCountsCacheInRedis(log, keys.buildImpressionsCountKey(), redisClient) : undefined;
39
- const uniqueKeysCache = impressionsMode === NONE ? new UniqueKeysCacheInRedis(log, keys.buildUniqueKeysKey(), redisClient) : undefined;
38
+ const impressionCountsCache = new ImpressionCountsCacheInRedis(log, keys.buildImpressionsCountKey(), redisClient);
39
+ const uniqueKeysCache = new UniqueKeysCacheInRedis(log, keys.buildUniqueKeysKey(), redisClient);
40
40
 
41
41
  // subscription to Redis connect event in order to emit SDK_READY event on consumer mode
42
42
  redisClient.on('connect', () => {
43
43
  onReadyCb();
44
- if (impressionCountsCache) impressionCountsCache.start();
45
- if (uniqueKeysCache) uniqueKeysCache.start();
44
+ impressionCountsCache.start();
45
+ uniqueKeysCache.start();
46
46
 
47
47
  // Synchronize config
48
48
  telemetry.recordConfig();
@@ -60,10 +60,10 @@ export function InRedisStorage(options: InRedisStorageOptions = {}): IStorageAsy
60
60
  // When using REDIS we should:
61
61
  // 1- Disconnect from the storage
62
62
  destroy(): Promise<void> {
63
- let promises = [];
64
- if (impressionCountsCache) promises.push(impressionCountsCache.stop());
65
- if (uniqueKeysCache) promises.push(uniqueKeysCache.stop());
66
- return Promise.all(promises).then(() => { redisClient.disconnect(); });
63
+ return Promise.all([
64
+ impressionCountsCache.stop(),
65
+ uniqueKeysCache.stop()
66
+ ]).then(() => { redisClient.disconnect(); });
67
67
  // @TODO check that caches works as expected when redisClient is disconnected
68
68
  }
69
69
  };
@@ -8,7 +8,7 @@ import { EventsCachePluggable } from './EventsCachePluggable';
8
8
  import { wrapperAdapter, METHODS_TO_PROMISE_WRAP } from './wrapperAdapter';
9
9
  import { isObject } from '../../utils/lang';
10
10
  import { getStorageHash, validatePrefix } from '../KeyBuilder';
11
- import { CONSUMER_PARTIAL_MODE, DEBUG, NONE, STORAGE_PLUGGABLE } from '../../utils/constants';
11
+ import { CONSUMER_PARTIAL_MODE, STORAGE_PLUGGABLE } from '../../utils/constants';
12
12
  import { ImpressionsCacheInMemory } from '../inMemory/ImpressionsCacheInMemory';
13
13
  import { EventsCacheInMemory } from '../inMemory/EventsCacheInMemory';
14
14
  import { ImpressionCountsCacheInMemory } from '../inMemory/ImpressionCountsCacheInMemory';
@@ -63,35 +63,31 @@ export function PluggableStorage(options: PluggableStorageOptions): IStorageAsyn
63
63
  const prefix = validatePrefix(options.prefix);
64
64
 
65
65
  function PluggableStorageFactory(params: IStorageFactoryParams): IStorageAsync {
66
- const { onReadyCb, settings, settings: { log, mode, sync: { impressionsMode }, scheduler: { impressionsQueueSize, eventsQueueSize } } } = params;
66
+ const { onReadyCb, settings, settings: { log, mode, scheduler: { impressionsQueueSize, eventsQueueSize } } } = params;
67
67
  const metadata = metadataBuilder(settings);
68
68
  const keys = new KeyBuilderSS(prefix, metadata);
69
69
  const wrapper = wrapperAdapter(log, options.wrapper);
70
70
 
71
- const isSyncronizer = mode === undefined; // If mode is not defined, the synchronizer is running
71
+ const isSynchronizer = mode === undefined; // If mode is not defined, the synchronizer is running
72
72
  const isPartialConsumer = mode === CONSUMER_PARTIAL_MODE;
73
73
 
74
- const telemetry = shouldRecordTelemetry(params) || isSyncronizer ?
74
+ const telemetry = shouldRecordTelemetry(params) || isSynchronizer ?
75
75
  isPartialConsumer ?
76
76
  new TelemetryCacheInMemory() :
77
77
  new TelemetryCachePluggable(log, keys, wrapper) :
78
78
  undefined;
79
79
 
80
- const impressionCountsCache = impressionsMode !== DEBUG || isSyncronizer ?
81
- isPartialConsumer ?
82
- new ImpressionCountsCacheInMemory() :
83
- new ImpressionCountsCachePluggable(log, keys.buildImpressionsCountKey(), wrapper) :
84
- undefined;
80
+ const impressionCountsCache = isPartialConsumer ?
81
+ new ImpressionCountsCacheInMemory() :
82
+ new ImpressionCountsCachePluggable(log, keys.buildImpressionsCountKey(), wrapper);
85
83
 
86
- const uniqueKeysCache = impressionsMode === NONE || isSyncronizer ?
87
- isPartialConsumer ?
88
- settings.core.key === undefined ? new UniqueKeysCacheInMemory() : new UniqueKeysCacheInMemoryCS() :
89
- new UniqueKeysCachePluggable(log, keys.buildUniqueKeysKey(), wrapper) :
90
- undefined;
84
+ const uniqueKeysCache = isPartialConsumer ?
85
+ settings.core.key === undefined ? new UniqueKeysCacheInMemory() : new UniqueKeysCacheInMemoryCS() :
86
+ new UniqueKeysCachePluggable(log, keys.buildUniqueKeysKey(), wrapper);
91
87
 
92
88
  // Connects to wrapper and emits SDK_READY event on main client
93
89
  const connectPromise = wrapper.connect().then(() => {
94
- if (isSyncronizer) {
90
+ if (isSynchronizer) {
95
91
  // @TODO reuse InLocalStorage::validateCache logic
96
92
  // In standalone or producer mode, clear storage if SDK key, flags filter criteria or flags spec version was modified
97
93
  return wrapper.get(keys.buildHashKey()).then((hash) => {
@@ -107,8 +103,8 @@ export function PluggableStorage(options: PluggableStorageOptions): IStorageAsyn
107
103
  });
108
104
  } else {
109
105
  // Start periodic flush of async storages if not running synchronizer (producer mode)
110
- if (impressionCountsCache && (impressionCountsCache as ImpressionCountsCachePluggable).start) (impressionCountsCache as ImpressionCountsCachePluggable).start();
111
- if (uniqueKeysCache && (uniqueKeysCache as UniqueKeysCachePluggable).start) (uniqueKeysCache as UniqueKeysCachePluggable).start();
106
+ if ((impressionCountsCache as ImpressionCountsCachePluggable).start) (impressionCountsCache as ImpressionCountsCachePluggable).start();
107
+ if ((uniqueKeysCache as UniqueKeysCachePluggable).start) (uniqueKeysCache as UniqueKeysCachePluggable).start();
112
108
  if (telemetry && (telemetry as ITelemetryCacheAsync).recordConfig) (telemetry as ITelemetryCacheAsync).recordConfig();
113
109
 
114
110
  onReadyCb();
@@ -130,9 +126,9 @@ export function PluggableStorage(options: PluggableStorageOptions): IStorageAsyn
130
126
 
131
127
  // Stop periodic flush and disconnect the underlying storage
132
128
  destroy() {
133
- return Promise.all(isSyncronizer ? [] : [
134
- impressionCountsCache && (impressionCountsCache as ImpressionCountsCachePluggable).stop && (impressionCountsCache as ImpressionCountsCachePluggable).stop(),
135
- uniqueKeysCache && (uniqueKeysCache as UniqueKeysCachePluggable).stop && (uniqueKeysCache as UniqueKeysCachePluggable).stop(),
129
+ return Promise.all(isSynchronizer ? [] : [
130
+ (impressionCountsCache as ImpressionCountsCachePluggable).stop && (impressionCountsCache as ImpressionCountsCachePluggable).stop(),
131
+ (uniqueKeysCache as UniqueKeysCachePluggable).stop && (uniqueKeysCache as UniqueKeysCachePluggable).stop(),
136
132
  ]).then(() => wrapper.disconnect());
137
133
  },
138
134
 
@@ -435,10 +435,10 @@ export interface IStorageBase<
435
435
  splits: TSplitsCache,
436
436
  segments: TSegmentsCache,
437
437
  impressions: TImpressionsCache,
438
- impressionCounts?: TImpressionsCountCache,
438
+ impressionCounts: TImpressionsCountCache,
439
439
  events: TEventsCache,
440
440
  telemetry?: TTelemetryCache,
441
- uniqueKeys?: TUniqueKeysCache,
441
+ uniqueKeys: TUniqueKeysCache,
442
442
  destroy(): void | Promise<void>,
443
443
  shared?: (matchingKey: string, onReadyCb: (error?: any) => void) => this
444
444
  }
@@ -39,8 +39,6 @@ export function impressionCountsSubmitterFactory(params: ISdkFactoryContextSync)
39
39
  storage: { impressionCounts }
40
40
  } = params;
41
41
 
42
- if (impressionCounts) {
43
- // retry impressions counts only once.
44
- return submitterFactory(log, postTestImpressionsCount, impressionCounts, IMPRESSIONS_COUNT_RATE, 'impression counts', fromImpressionCountsCollector, 1);
45
- }
42
+ // retry impressions counts only once.
43
+ return submitterFactory(log, postTestImpressionsCount, impressionCounts, IMPRESSIONS_COUNT_RATE, 'impression counts', fromImpressionCountsCollector, 1);
46
44
  }
@@ -10,13 +10,12 @@ export function submitterManagerFactory(params: ISdkFactoryContextSync): ISubmit
10
10
 
11
11
  const submitters = [
12
12
  impressionsSubmitterFactory(params),
13
- eventsSubmitterFactory(params)
13
+ eventsSubmitterFactory(params),
14
+ impressionCountsSubmitterFactory(params),
15
+ uniqueKeysSubmitterFactory(params)
14
16
  ];
15
17
 
16
- const impressionCountsSubmitter = impressionCountsSubmitterFactory(params);
17
- if (impressionCountsSubmitter) submitters.push(impressionCountsSubmitter);
18
18
  const telemetrySubmitter = telemetrySubmitterFactory(params);
19
- if (params.storage.uniqueKeys) submitters.push(uniqueKeysSubmitterFactory(params));
20
19
 
21
20
  return {
22
21
  // `onlyTelemetry` true if SDK is created with userConsent not GRANTED
@@ -19,10 +19,10 @@ export function uniqueKeysSubmitterFactory(params: ISdkFactoryContextSync) {
19
19
  const isClientSide = key !== undefined;
20
20
  const postUniqueKeysBulk = isClientSide ? postUniqueKeysBulkCs : postUniqueKeysBulkSs;
21
21
 
22
- const syncTask = submitterFactory(log, postUniqueKeysBulk, uniqueKeys!, UNIQUE_KEYS_RATE, DATA_NAME);
22
+ const syncTask = submitterFactory(log, postUniqueKeysBulk, uniqueKeys, UNIQUE_KEYS_RATE, DATA_NAME);
23
23
 
24
24
  // register unique keys submitter to be executed when uniqueKeys cache is full
25
- uniqueKeys!.setOnFullQueueCb(() => {
25
+ uniqueKeys.setOnFullQueueCb(() => {
26
26
  if (syncTask.isRunning()) {
27
27
  log.info(SUBMITTERS_PUSH_FULL_QUEUE, [DATA_NAME]);
28
28
  syncTask.execute();
@@ -33,4 +33,3 @@ export function uniqueKeysSubmitterFactory(params: ISdkFactoryContextSync) {
33
33
 
34
34
  return syncTask;
35
35
  }
36
-
@@ -1,7 +1,7 @@
1
1
  import { objectAssign } from '../utils/lang/objectAssign';
2
2
  import { thenable } from '../utils/promise/thenable';
3
3
  import { IImpressionsCacheBase, ITelemetryCacheSync, ITelemetryCacheAsync } from '../storages/types';
4
- import { IImpressionsHandler, IImpressionsTracker, IStrategy } from './types';
4
+ import { IImpressionsHandler, IImpressionsTracker, ImpressionDecorated, IStrategy } from './types';
5
5
  import { ISettings } from '../types';
6
6
  import { IMPRESSIONS_TRACKER_SUCCESS, ERROR_IMPRESSIONS_TRACKER, ERROR_IMPRESSIONS_LISTENER } from '../logger/constants';
7
7
  import { CONSENT_DECLINED, DEDUPED, QUEUED } from '../utils/constants';
@@ -9,16 +9,11 @@ import SplitIO from '../../types/splitio';
9
9
 
10
10
  /**
11
11
  * Impressions tracker stores impressions in cache and pass them to the listener and integrations manager if provided.
12
- *
13
- * @param impressionsCache - cache to save impressions
14
- * @param metadata - runtime metadata (ip, hostname and version)
15
- * @param impressionListener - optional impression listener
16
- * @param integrationsManager - optional integrations manager
17
- * @param strategy - strategy for impressions tracking.
18
12
  */
19
13
  export function impressionsTrackerFactory(
20
14
  settings: ISettings,
21
15
  impressionsCache: IImpressionsCacheBase,
16
+ noneStrategy: IStrategy,
22
17
  strategy: IStrategy,
23
18
  whenInit: (cb: () => void) => void,
24
19
  integrationsManager?: IImpressionsHandler,
@@ -28,40 +23,44 @@ export function impressionsTrackerFactory(
28
23
  const { log, impressionListener, runtime: { ip, hostname }, version } = settings;
29
24
 
30
25
  return {
31
- track(impressions: SplitIO.ImpressionDTO[], attributes?: SplitIO.Attributes) {
26
+ track(impressions: ImpressionDecorated[], attributes?: SplitIO.Attributes) {
32
27
  if (settings.userConsent === CONSENT_DECLINED) return;
33
28
 
34
- const impressionsCount = impressions.length;
35
- const { impressionsToStore, impressionsToListener, deduped } = strategy.process(impressions);
29
+ const impressionsToStore = impressions.filter(({ imp, disabled }) => {
30
+ return disabled ?
31
+ noneStrategy.process(imp) :
32
+ strategy.process(imp);
33
+ });
36
34
 
37
- const impressionsToListenerCount = impressionsToListener.length;
35
+ const impressionsLength = impressions.length;
36
+ const impressionsToStoreLength = impressionsToStore.length;
38
37
 
39
- if (impressionsToStore.length > 0) {
40
- const res = impressionsCache.track(impressionsToStore);
38
+ if (impressionsToStoreLength) {
39
+ const res = impressionsCache.track(impressionsToStore.map((item) => item.imp));
41
40
 
42
41
  // If we're on an async storage, handle error and log it.
43
42
  if (thenable(res)) {
44
43
  res.then(() => {
45
- log.info(IMPRESSIONS_TRACKER_SUCCESS, [impressionsCount]);
44
+ log.info(IMPRESSIONS_TRACKER_SUCCESS, [impressionsLength]);
46
45
  }).catch(err => {
47
- log.error(ERROR_IMPRESSIONS_TRACKER, [impressionsCount, err]);
46
+ log.error(ERROR_IMPRESSIONS_TRACKER, [impressionsLength, err]);
48
47
  });
49
48
  } else {
50
49
  // Record when impressionsCache is sync only (standalone mode)
51
50
  // @TODO we are not dropping impressions on full queue yet, so DROPPED stats are not recorded
52
51
  if (telemetryCache) {
53
- (telemetryCache as ITelemetryCacheSync).recordImpressionStats(QUEUED, impressionsToStore.length);
54
- (telemetryCache as ITelemetryCacheSync).recordImpressionStats(DEDUPED, deduped);
52
+ (telemetryCache as ITelemetryCacheSync).recordImpressionStats(QUEUED, impressionsToStoreLength);
53
+ (telemetryCache as ITelemetryCacheSync).recordImpressionStats(DEDUPED, impressionsLength - impressionsToStoreLength);
55
54
  }
56
55
  }
57
56
  }
58
57
 
59
58
  // @TODO next block might be handled by the integration manager. In that case, the metadata object doesn't need to be passed in the constructor
60
59
  if (impressionListener || integrationsManager) {
61
- for (let i = 0; i < impressionsToListenerCount; i++) {
60
+ for (let i = 0; i < impressionsLength; i++) {
62
61
  const impressionData: SplitIO.ImpressionData = {
63
62
  // copy of impression, to avoid unexpected behavior if modified by integrations or impressionListener
64
- impression: objectAssign({}, impressionsToListener[i]),
63
+ impression: objectAssign({}, impressions[i].imp),
65
64
  attributes,
66
65
  ip,
67
66
  hostname,
@@ -6,23 +6,16 @@ import { IStrategy } from '../types';
6
6
  * Debug strategy for impressions tracker. Wraps impressions to store and adds previousTime if it corresponds
7
7
  *
8
8
  * @param impressionsObserver - impression observer. Previous time (pt property) is included in impression instances
9
- * @returns IStrategyResult
9
+ * @returns Debug strategy
10
10
  */
11
11
  export function strategyDebugFactory(
12
12
  impressionsObserver: IImpressionObserver
13
13
  ): IStrategy {
14
14
 
15
15
  return {
16
- process(impressions: SplitIO.ImpressionDTO[]) {
17
- impressions.forEach((impression) => {
18
- // Adds previous time if it is enabled
19
- impression.pt = impressionsObserver.testAndSet(impression);
20
- });
21
- return {
22
- impressionsToStore: impressions,
23
- impressionsToListener: impressions,
24
- deduped: 0
25
- };
16
+ process(impression: SplitIO.ImpressionDTO) {
17
+ impression.pt = impressionsObserver.testAndSet(impression);
18
+ return true;
26
19
  }
27
20
  };
28
21
  }
@@ -5,30 +5,24 @@ import { IStrategy, IUniqueKeysTracker } from '../types';
5
5
  /**
6
6
  * None strategy for impressions tracker.
7
7
  *
8
- * @param impressionsCounter - cache to save impressions count. impressions will be deduped (OPTIMIZED mode)
8
+ * @param impressionCounts - cache to save impressions count. impressions will be deduped (OPTIMIZED mode)
9
9
  * @param uniqueKeysTracker - unique keys tracker in charge of tracking the unique keys per split.
10
- * @returns IStrategyResult
10
+ * @returns None strategy
11
11
  */
12
12
  export function strategyNoneFactory(
13
- impressionsCounter: IImpressionCountsCacheBase,
13
+ impressionCounts: IImpressionCountsCacheBase,
14
14
  uniqueKeysTracker: IUniqueKeysTracker
15
15
  ): IStrategy {
16
16
 
17
17
  return {
18
- process(impressions: SplitIO.ImpressionDTO[]) {
19
- impressions.forEach((impression) => {
20
- const now = Date.now();
21
- // Increments impression counter per featureName
22
- impressionsCounter.track(impression.feature, now, 1);
23
- // Keep track by unique key
24
- uniqueKeysTracker.track(impression.keyName, impression.feature);
25
- });
26
-
27
- return {
28
- impressionsToStore: [],
29
- impressionsToListener: impressions,
30
- deduped: 0
31
- };
18
+ process(impression: SplitIO.ImpressionDTO) {
19
+ const now = Date.now();
20
+ // Increments impression counter per featureName
21
+ impressionCounts.track(impression.feature, now, 1);
22
+ // Keep track by unique key
23
+ uniqueKeysTracker.track(impression.keyName, impression.feature);
24
+ // Do not store impressions
25
+ return false;
32
26
  }
33
27
  };
34
28
  }
@@ -8,35 +8,25 @@ import { IStrategy } from '../types';
8
8
  * Optimized strategy for impressions tracker. Wraps impressions to store and adds previousTime if it corresponds
9
9
  *
10
10
  * @param impressionsObserver - impression observer. previous time (pt property) is included in impression instances
11
- * @param impressionsCounter - cache to save impressions count. impressions will be deduped (OPTIMIZED mode)
12
- * @returns IStrategyResult
11
+ * @param impressionCounts - cache to save impressions count. impressions will be deduped (OPTIMIZED mode)
12
+ * @returns Optimized strategy
13
13
  */
14
14
  export function strategyOptimizedFactory(
15
15
  impressionsObserver: IImpressionObserver,
16
- impressionsCounter: IImpressionCountsCacheBase,
16
+ impressionCounts: IImpressionCountsCacheBase,
17
17
  ): IStrategy {
18
18
 
19
19
  return {
20
- process(impressions: SplitIO.ImpressionDTO[]) {
21
- const impressionsToStore: SplitIO.ImpressionDTO[] = [];
22
- impressions.forEach((impression) => {
23
- impression.pt = impressionsObserver.testAndSet(impression);
20
+ process(impression: SplitIO.ImpressionDTO) {
21
+ impression.pt = impressionsObserver.testAndSet(impression);
24
22
 
25
- const now = Date.now();
23
+ const now = Date.now();
26
24
 
27
- // Increments impression counter per featureName
28
- if (impression.pt) impressionsCounter.track(impression.feature, now, 1);
25
+ // Increments impression counter per featureName
26
+ if (impression.pt) impressionCounts.track(impression.feature, now, 1);
29
27
 
30
- // Checks if the impression should be added in queue to be sent
31
- if (!impression.pt || impression.pt < truncateTimeFrame(now)) {
32
- impressionsToStore.push(impression);
33
- }
34
- });
35
- return {
36
- impressionsToStore: impressionsToStore,
37
- impressionsToListener: impressions,
38
- deduped: impressions.length - impressionsToStore.length
39
- };
28
+ // Checks if the impression should be added in queue to be sent
29
+ return (!impression.pt || impression.pt < truncateTimeFrame(now)) ? true : false;
40
30
  }
41
31
  };
42
32
  }
@@ -17,8 +17,19 @@ export interface IImpressionsHandler {
17
17
  handleImpression(impressionData: SplitIO.ImpressionData): any
18
18
  }
19
19
 
20
+ export type ImpressionDecorated = {
21
+ /**
22
+ * Impression DTO
23
+ */
24
+ imp: SplitIO.ImpressionDTO,
25
+ /**
26
+ * Whether the impression should be tracked or not
27
+ */
28
+ disabled?: boolean
29
+ };
30
+
20
31
  export interface IImpressionsTracker {
21
- track(impressions: SplitIO.ImpressionDTO[], attributes?: SplitIO.Attributes): void
32
+ track(impressions: ImpressionDecorated[], attributes?: SplitIO.Attributes): void
22
33
  }
23
34
 
24
35
  /** Telemetry tracker */
@@ -70,12 +81,6 @@ export interface IUniqueKeysTracker {
70
81
  track(key: string, featureName: string): void;
71
82
  }
72
83
 
73
- export interface IStrategyResult {
74
- impressionsToStore: SplitIO.ImpressionDTO[],
75
- impressionsToListener: SplitIO.ImpressionDTO[],
76
- deduped: number
77
- }
78
-
79
84
  export interface IStrategy {
80
- process(impressions: SplitIO.ImpressionDTO[]): IStrategyResult
85
+ process(impression: SplitIO.ImpressionDTO): boolean
81
86
  }
@@ -862,6 +862,10 @@ declare namespace SplitIO {
862
862
  * The default treatment of the feature flag.
863
863
  */
864
864
  defaultTreatment: string;
865
+ /**
866
+ * Whether the feature flag has impressions tracking disabled or not.
867
+ */
868
+ impressionsDisabled: boolean;
865
869
  };
866
870
  /**
867
871
  * A promise that resolves to a feature flag view or null if the feature flag is not found.