@ninetailed/experience.js 7.11.0 → 7.11.1

package/index.cjs.js

@@ -148,14 +148,12 @@ class NinetailedCorePlugin extends experience_jsPluginAnalytics.NinetailedAnalyt
         instance.dispatch({
           type: PROFILE_RESET
         });
-        instance.storage.removeItem(ANONYMOUS_ID);
-        instance.storage.removeItem(PROFILE_FALLBACK_CACHE);
-        instance.storage.removeItem(EXPERIENCES_FALLBACK_CACHE);
+        this.clearCaches();
         experience_jsShared.logger.debug('Removed old profile data from localstorage.');
         if (typeof this.onInitProfileId === 'function') {
           const profileId = yield this.onInitProfileId(undefined);
           if (typeof profileId === 'string') {
-            instance.storage.setItem(ANONYMOUS_ID, profileId);
+            this.setAnonymousId(profileId);
           }
         }
         yield this.ninetailed.track('nt_reset');
@@ -201,13 +199,13 @@ class NinetailedCorePlugin extends experience_jsPluginAnalytics.NinetailedAnalyt
       const legacyAnonymousId = instance.storage.getItem(LEGACY_ANONYMOUS_ID);
       if (legacyAnonymousId) {
         experience_jsShared.logger.debug('Found legacy anonymousId, migrating to new one.', legacyAnonymousId);
-        instance.storage.setItem(ANONYMOUS_ID, legacyAnonymousId);
+        this.setAnonymousId(legacyAnonymousId);
         instance.storage.removeItem(LEGACY_ANONYMOUS_ID);
       }
       if (typeof this.onInitProfileId === 'function') {
-        const profileId = yield this.onInitProfileId(instance.storage.getItem(ANONYMOUS_ID));
+        const profileId = yield this.onInitProfileId(this.getAnonymousId());
         if (typeof profileId === 'string') {
-          instance.storage.setItem(ANONYMOUS_ID, profileId);
+          this.setAnonymousId(profileId);
         }
       }
       experience_jsShared.logger.debug('Ninetailed Core plugin initialized.');
@@ -316,6 +314,49 @@ class NinetailedCorePlugin extends experience_jsPluginAnalytics.NinetailedAnalyt
     }
     return this._instance;
   }
+  getAnonymousId() {
+    var _c;
+    return (_c = this.instance.storage.getItem(ANONYMOUS_ID)) !== null && _c !== void 0 ? _c : undefined;
+  }
+  setAnonymousId(id) {
+    this.instance.storage.setItem(ANONYMOUS_ID, id);
+  }
+  clearAnonymousId() {
+    this.instance.storage.removeItem(ANONYMOUS_ID);
+  }
+  setFallbackProfile(profile) {
+    this.instance.storage.setItem(PROFILE_FALLBACK_CACHE, profile);
+  }
+  getFallbackProfile() {
+    var _c;
+    return (_c = this.instance.storage.getItem(PROFILE_FALLBACK_CACHE)) !== null && _c !== void 0 ? _c : undefined;
+  }
+  clearFallbackProfile() {
+    this.instance.storage.removeItem(PROFILE_FALLBACK_CACHE);
+  }
+  setFallbackExperiences(experiences) {
+    this.instance.storage.setItem(EXPERIENCES_FALLBACK_CACHE, experiences);
+  }
+  getFallbackExperiences() {
+    return this.instance.storage.getItem(EXPERIENCES_FALLBACK_CACHE) || [];
+  }
+  clearFallbackExperiences() {
+    this.instance.storage.removeItem(EXPERIENCES_FALLBACK_CACHE);
+  }
+  clearCaches() {
+    this.clearAnonymousId();
+    this.clearFallbackProfile();
+    this.clearFallbackExperiences();
+  }
+  populateCaches({
+    experiences,
+    profile,
+    anonymousId
+  }) {
+    this.setAnonymousId(anonymousId);
+    this.setFallbackProfile(profile);
+    this.setFallbackExperiences(experiences);
+  }
   _flush() {
     return __awaiter(this, void 0, void 0, function* () {
       const events = Object.assign([], this.queue);
@@ -327,7 +368,7 @@ class NinetailedCorePlugin extends experience_jsPluginAnalytics.NinetailedAnalyt
         };
       }
       try {
-        const anonymousId = this.instance.storage.getItem(ANONYMOUS_ID);
+        const anonymousId = this.getAnonymousId();
         const {
           profile,
           experiences
@@ -338,15 +379,18 @@ class NinetailedCorePlugin extends experience_jsPluginAnalytics.NinetailedAnalyt
           locale: this.locale,
           enabledFeatures: this.enabledFeatures
         });
-        this.instance.storage.setItem(ANONYMOUS_ID, profile.id);
-        this.instance.storage.setItem(PROFILE_FALLBACK_CACHE, profile);
-        this.instance.storage.setItem(EXPERIENCES_FALLBACK_CACHE, experiences);
+        this.populateCaches({
+          anonymousId: profile.id,
+          profile,
+          experiences
+        });
         experience_jsShared.logger.debug('Profile from api: ', profile);
         experience_jsShared.logger.debug('Experiences from api: ', experiences);
         this.instance.dispatch({
           type: PROFILE_CHANGE,
           profile,
-          experiences
+          experiences,
+          error: undefined
         });
         yield delay(20);
         return {
@@ -354,14 +398,15 @@ class NinetailedCorePlugin extends experience_jsPluginAnalytics.NinetailedAnalyt
         };
       } catch (error) {
         experience_jsShared.logger.debug('An error occurred during flushing the events: ', error);
-        const fallbackProfile = this.instance.storage.getItem(PROFILE_FALLBACK_CACHE);
-        const fallbackExperiences = this.instance.storage.getItem(EXPERIENCES_FALLBACK_CACHE) || [];
+        const fallbackProfile = this.getFallbackProfile();
+        const fallbackExperiences = this.getFallbackExperiences();
         if (fallbackProfile) {
           experience_jsShared.logger.debug('Found a fallback profile - will use this.');
           this.instance.dispatch({
             type: PROFILE_CHANGE,
             profile: fallbackProfile,
-            experiences: fallbackExperiences
+            experiences: fallbackExperiences,
+            error: undefined
           });
         } else {
           experience_jsShared.logger.debug('No fallback profile found - setting profile to null.');
@@ -369,7 +414,7 @@ class NinetailedCorePlugin extends experience_jsPluginAnalytics.NinetailedAnalyt
             type: PROFILE_CHANGE,
             profile: null,
             experiences: fallbackExperiences,
-            error
+            error: error
           });
         }
         return {
@@ -436,19 +481,17 @@ const isInterestedInHiddenPage = arg => {
 };
 
 const decodeExperienceVariantsMap = encodedExperienceVariantsMap => {
-  return encodedExperienceVariantsMap.split(',').map(experienceIdWithVariant => {
-    const [experienceId, _variantIndex] = experienceIdWithVariant.split('=');
-    const variantIndex = parseInt(_variantIndex);
+  const experientVariantsAssignments = encodedExperienceVariantsMap.split(',');
+  const experienceVariantsMap = {};
+  for (const experienceVariantAssignment of experientVariantsAssignments) {
+    const [experienceId, variantIndexString] = experienceVariantAssignment.split('=');
+    const variantIndex = parseInt(variantIndexString);
     if (!experienceId || !variantIndex) {
-      return null;
+      continue;
     }
-    return {
-      experienceId,
-      variantIndex
-    };
-  }).filter(x => !!x).reduce((acc, curr) => Object.assign(Object.assign({}, acc), {
-    [curr.experienceId]: curr.variantIndex
-  }), {});
+    experienceVariantsMap[experienceId] = variantIndex;
+  }
+  return experienceVariantsMap;
 };
 
 class OnChangeEmitter {
@@ -510,6 +553,28 @@ const createPassThroughMiddleware = () => {
     };
   };
 };
+function createExperienceSelectionMiddleware({
+  plugins,
+  experiences,
+  baseline,
+  profile
+}) {
+  if (profile === null) {
+    return createPassThroughMiddleware();
+  }
+  const pluginsWithMiddleware = selectPluginsHavingExperienceSelectionMiddleware(plugins);
+  const middlewareFunctions = [];
+  for (const plugin of pluginsWithMiddleware) {
+    const middleware = plugin.getExperienceSelectionMiddleware({
+      experiences,
+      baseline
+    });
+    if (middleware !== undefined) {
+      middlewareFunctions.push(middleware);
+    }
+  }
+  return experience_jsShared.pipe(...middlewareFunctions);
+}
 const makeExperienceSelectMiddleware = ({
   plugins,
   onChange,
@@ -519,18 +584,12 @@ const makeExperienceSelectMiddleware = ({
 }) => {
   let removeChangeListeners = [];
   const pluginsHavingChangeEmitters = selectPluginsHavingOnChangeEmitter(plugins);
-  const prepareMiddleware = () => {
-    if (profile === null) {
-      return createPassThroughMiddleware();
-    }
-    const pluginsWithMiddleware = selectPluginsHavingExperienceSelectionMiddleware(plugins);
-    const middlewareFunctions = pluginsWithMiddleware.map(plugin => plugin.getExperienceSelectionMiddleware({
-      experiences,
-      baseline
-    })).filter(result => typeof result !== 'undefined');
-    return experience_jsShared.pipe(...middlewareFunctions);
-  };
-  const middleware = prepareMiddleware();
+  const middleware = createExperienceSelectionMiddleware({
+    plugins,
+    experiences,
+    baseline,
+    profile
+  });
   const addListeners = () => {
     removeChangeListeners = pluginsHavingChangeEmitters.map(plugin => {
       const listener = () => {
@@ -539,8 +598,12 @@ const makeExperienceSelectMiddleware = ({
       return plugin.onChangeEmitter.addListener(listener);
     });
   };
+  // WARNING: This specific implementation using forEach is required.
+  // DO NOT replace with for...of or other loop constructs as they will break functionality.
+  // The exact reason is uncertain but appears related to the transplier.
+  // TODO: Come back and find out why this is the case, maybe a version bump is in order.
   const removeListeners = () => {
-    removeChangeListeners.forEach(listener => listener());
+    removeChangeListeners.forEach(removeListener => removeListener());
   };
   return {
     addListeners,
@@ -553,44 +616,36 @@ class EventBuilder {
   constructor(buildRequestContext) {
     this.buildRequestContext = buildRequestContext || buildClientNinetailedRequestContext;
   }
-  page(properties, data) {
-    return experience_jsShared.buildPageEvent(Object.assign(Object.assign({
+  buildEventBase(data) {
+    return Object.assign(Object.assign({
       messageId: (data === null || data === void 0 ? void 0 : data.messageId) || uuid.v4()
     }, data), {
       timestamp: Date.now(),
-      properties: properties || {},
       ctx: this.buildRequestContext()
+    });
+  }
+  page(properties, data) {
+    return experience_jsShared.buildPageEvent(Object.assign(Object.assign({}, this.buildEventBase(data)), {
+      properties: properties || {}
     }));
   }
   track(event, properties, data) {
-    return experience_jsShared.buildTrackEvent(Object.assign(Object.assign({
-      messageId: (data === null || data === void 0 ? void 0 : data.messageId) || uuid.v4(),
-      timestamp: Date.now()
-    }, data), {
+    return experience_jsShared.buildTrackEvent(Object.assign(Object.assign({}, this.buildEventBase(data)), {
       event,
-      properties: properties || {},
-      ctx: this.buildRequestContext()
+      properties: properties || {}
     }));
   }
   identify(userId, traits, data) {
-    return experience_jsShared.buildIdentifyEvent(Object.assign(Object.assign({
-      messageId: (data === null || data === void 0 ? void 0 : data.messageId) || uuid.v4(),
-      timestamp: Date.now()
-    }, data), {
+    return experience_jsShared.buildIdentifyEvent(Object.assign(Object.assign({}, this.buildEventBase(data)), {
       traits: traits || {},
-      userId: userId || '',
-      ctx: this.buildRequestContext()
+      userId: userId || ''
     }));
   }
   component(componentId, experienceId, variantIndex, data) {
-    return experience_jsShared.buildComponentViewEvent(Object.assign(Object.assign({
-      messageId: (data === null || data === void 0 ? void 0 : data.messageId) || uuid.v4(),
-      timestamp: Date.now()
-    }, data), {
+    return experience_jsShared.buildComponentViewEvent(Object.assign(Object.assign({}, this.buildEventBase(data)), {
       componentId,
       experienceId: experienceId || '',
-      variantIndex: variantIndex || 0,
-      ctx: this.buildRequestContext()
+      variantIndex: variantIndex || 0
     }));
   }
 }
@@ -647,11 +702,7 @@ class Ninetailed {
         yield this.instance.page(data, this.buildOptions(options));
         return this.ninetailedCorePlugin.flush();
       } catch (error) {
-        experience_jsShared.logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "page" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        return this.handleMethodError(error, 'page');
       }
     });
     this.track = (event, properties, options) => __awaiter(this, void 0, void 0, function* () {
@@ -664,11 +715,7 @@ class Ninetailed {
         yield this.instance.track(event.toString(), result.data, this.buildOptions(options));
         return this.ninetailedCorePlugin.flush();
       } catch (error) {
-        experience_jsShared.logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "track" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        this.handleMethodError(error, 'track');
       }
     });
     this.identify = (uid, traits, options) => __awaiter(this, void 0, void 0, function* () {
@@ -681,11 +728,7 @@ class Ninetailed {
         yield this.instance.identify(uid && uid.toString() !== '' ? uid.toString() : EMPTY_MERGE_ID, result.data, this.buildOptions(options));
         return this.ninetailedCorePlugin.flush();
       } catch (error) {
-        experience_jsShared.logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "identify" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        this.handleMethodError(error, 'identify');
       }
     });
     this.batch = events => __awaiter(this, void 0, void 0, function* () {
@@ -714,11 +757,7 @@ class Ninetailed {
         yield Promise.all(promises);
         return this.ninetailedCorePlugin.flush();
       } catch (error) {
-        experience_jsShared.logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "batch" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        this.handleMethodError(error, 'batch');
       }
     });
     this.trackStickyComponentView = ({
@@ -736,11 +775,7 @@ class Ninetailed {
         });
         return this.ninetailedCorePlugin.flush();
       } catch (error) {
-        experience_jsShared.logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "trackStickyComponentView" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        this.handleMethodError(error, 'trackStickyComponentView');
       }
     });
     /**
@@ -763,33 +798,13 @@ class Ninetailed {
       const {
           element
         } = payload,
-        remaingPayload = __rest(payload, ["element"]);
+        remainingPayload = __rest(payload, ["element"]);
       if (!(element instanceof Element)) {
-        const isObject = typeof element === 'object' && element !== null;
-        const constructorName = isObject ? element.constructor.name : '';
-        const isConstructorNameNotObject = constructorName && constructorName !== 'Object';
-        experience_jsShared.logger.warn(`ElementSeenObserver.observeElement was called with an invalid element. Expected an Element but got ${typeof element}${isConstructorNameNotObject ? ` of type ${constructorName}` : ''}. This call will be ignored.`);
-      } else {
-        const existingPayloads = this.observedElements.get(element);
-        const delays = this.pluginsWithCustomComponentViewThreshold.map(plugin => plugin.getComponentViewTrackingThreshold());
-        const uniqueDelays = Array.from(new Set([...delays, options === null || options === void 0 ? void 0 : options.delay]));
-        if (!existingPayloads) {
-          this.observedElements.set(element, [remaingPayload]);
-        } else {
-          const isPayloadAlreadyObserved = existingPayloads.some(payload => {
-            return JSON.stringify(payload) === JSON.stringify(remaingPayload);
-          });
-          if (isPayloadAlreadyObserved) {
-            return;
-          }
-          this.observedElements.set(element, [...existingPayloads, remaingPayload]);
-        }
-        uniqueDelays.forEach(delay => {
-          this.elementSeenObserver.observe(element, {
-            delay
-          });
-        });
+        this.logInvalidElement(element);
+        return;
       }
+      this.storeElementPayload(element, remainingPayload);
+      this.setupElementObservation(element, options === null || options === void 0 ? void 0 : options.delay);
     };
     this.unobserveElement = element => {
       this.observedElements.delete(element);
@@ -1003,14 +1018,14 @@ class Ninetailed {
         removeMiddlewareChangeListeners();
       };
     };
-    this.onIsInitialized = onIsInitialized => {
-      if (typeof onIsInitialized === 'function') {
+    this.onIsInitialized = onIsInitializedCallback => {
+      if (typeof onIsInitializedCallback === 'function') {
         if (this.isInitialized) {
-          onIsInitialized();
+          onIsInitializedCallback();
         } else {
           const detachOnReadyListener = this.instance.on('ready', () => {
             this.isInitialized = true;
-            onIsInitialized();
+            onIsInitializedCallback();
             detachOnReadyListener();
           });
         }
@@ -1136,6 +1151,42 @@ class Ninetailed {
   get pluginsWithCustomComponentViewThreshold() {
     return [this.ninetailedCorePlugin, ...this.plugins].filter(plugin => experience_jsPluginAnalytics.hasComponentViewTrackingThreshold(plugin));
   }
+  logInvalidElement(element) {
+    const isObject = typeof element === 'object' && element !== null;
+    const constructorName = isObject ? element.constructor.name : '';
+    const isConstructorNameNotObject = constructorName && constructorName !== 'Object';
+    experience_jsShared.logger.warn(`ElementSeenObserver.observeElement was called with an invalid element. Expected an Element but got ${typeof element}${isConstructorNameNotObject ? ` of type ${constructorName}` : ''}. This call will be ignored.`);
+  }
+  storeElementPayload(element, payload) {
+    const existingPayloads = this.observedElements.get(element) || [];
+    // Check if the payload is already being observed for this element
+    const isPayloadAlreadyObserved = existingPayloads.some(existingPayload => JSON.stringify(existingPayload) === JSON.stringify(payload));
+    if (isPayloadAlreadyObserved) {
+      return;
+    }
+    // Store the new or updated payloads
+    this.observedElements.set(element, [...existingPayloads, payload]);
+  }
+  setupElementObservation(element, delay) {
+    // Get all relevant delays from plugins and the custom delay
+    const pluginDelays = this.pluginsWithCustomComponentViewThreshold.map(plugin => plugin.getComponentViewTrackingThreshold());
+    // Ensure we only observe each delay once
+    const uniqueDelays = Array.from(new Set([...pluginDelays, delay]));
+    // Set up observation for each delay
+    uniqueDelays.forEach(delay => {
+      this.elementSeenObserver.observe(element, {
+        delay
+      });
+    });
+  }
+  // Always throws, never returns
+  handleMethodError(error, method) {
+    experience_jsShared.logger.error(error);
+    if (error instanceof RangeError) {
+      throw new Error(`[Validation Error] "${method}" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
+    }
+    throw error;
+  }
   get profileState() {
     return this._profileState;
   }

package/index.esm.js

@@ -110,14 +110,12 @@ class NinetailedCorePlugin extends NinetailedAnalyticsPlugin {
         instance.dispatch({
           type: PROFILE_RESET
         });
-        instance.storage.removeItem(ANONYMOUS_ID);
-        instance.storage.removeItem(PROFILE_FALLBACK_CACHE);
-        instance.storage.removeItem(EXPERIENCES_FALLBACK_CACHE);
+        _this.clearCaches();
         logger.debug('Removed old profile data from localstorage.');
         if (typeof _this.onInitProfileId === 'function') {
           const profileId = await _this.onInitProfileId(undefined);
           if (typeof profileId === 'string') {
-            instance.storage.setItem(ANONYMOUS_ID, profileId);
+            _this.setAnonymousId(profileId);
           }
         }
         await _this.ninetailed.track('nt_reset');
@@ -163,13 +161,13 @@ class NinetailedCorePlugin extends NinetailedAnalyticsPlugin {
     const legacyAnonymousId = instance.storage.getItem(LEGACY_ANONYMOUS_ID);
     if (legacyAnonymousId) {
       logger.debug('Found legacy anonymousId, migrating to new one.', legacyAnonymousId);
-      instance.storage.setItem(ANONYMOUS_ID, legacyAnonymousId);
+      this.setAnonymousId(legacyAnonymousId);
       instance.storage.removeItem(LEGACY_ANONYMOUS_ID);
     }
     if (typeof this.onInitProfileId === 'function') {
-      const profileId = await this.onInitProfileId(instance.storage.getItem(ANONYMOUS_ID));
+      const profileId = await this.onInitProfileId(this.getAnonymousId());
       if (typeof profileId === 'string') {
-        instance.storage.setItem(ANONYMOUS_ID, profileId);
+        this.setAnonymousId(profileId);
       }
     }
     logger.debug('Ninetailed Core plugin initialized.');
@@ -267,6 +265,49 @@ class NinetailedCorePlugin extends NinetailedAnalyticsPlugin {
     }
     return this._instance;
   }
+  getAnonymousId() {
+    var _ref;
+    return (_ref = this.instance.storage.getItem(ANONYMOUS_ID)) != null ? _ref : undefined;
+  }
+  setAnonymousId(id) {
+    this.instance.storage.setItem(ANONYMOUS_ID, id);
+  }
+  clearAnonymousId() {
+    this.instance.storage.removeItem(ANONYMOUS_ID);
+  }
+  setFallbackProfile(profile) {
+    this.instance.storage.setItem(PROFILE_FALLBACK_CACHE, profile);
+  }
+  getFallbackProfile() {
+    var _ref2;
+    return (_ref2 = this.instance.storage.getItem(PROFILE_FALLBACK_CACHE)) != null ? _ref2 : undefined;
+  }
+  clearFallbackProfile() {
+    this.instance.storage.removeItem(PROFILE_FALLBACK_CACHE);
+  }
+  setFallbackExperiences(experiences) {
+    this.instance.storage.setItem(EXPERIENCES_FALLBACK_CACHE, experiences);
+  }
+  getFallbackExperiences() {
+    return this.instance.storage.getItem(EXPERIENCES_FALLBACK_CACHE) || [];
+  }
+  clearFallbackExperiences() {
+    this.instance.storage.removeItem(EXPERIENCES_FALLBACK_CACHE);
+  }
+  clearCaches() {
+    this.clearAnonymousId();
+    this.clearFallbackProfile();
+    this.clearFallbackExperiences();
+  }
+  populateCaches({
+    experiences,
+    profile,
+    anonymousId
+  }) {
+    this.setAnonymousId(anonymousId);
+    this.setFallbackProfile(profile);
+    this.setFallbackExperiences(experiences);
+  }
   async _flush() {
     const events = Object.assign([], this.queue);
     logger.info('Start flushing events.');
@@ -277,7 +318,7 @@ class NinetailedCorePlugin extends NinetailedAnalyticsPlugin {
       };
     }
     try {
-      const anonymousId = this.instance.storage.getItem(ANONYMOUS_ID);
+      const anonymousId = this.getAnonymousId();
       const {
         profile,
         experiences
@@ -288,15 +329,18 @@ class NinetailedCorePlugin extends NinetailedAnalyticsPlugin {
         locale: this.locale,
         enabledFeatures: this.enabledFeatures
       });
-      this.instance.storage.setItem(ANONYMOUS_ID, profile.id);
-      this.instance.storage.setItem(PROFILE_FALLBACK_CACHE, profile);
-      this.instance.storage.setItem(EXPERIENCES_FALLBACK_CACHE, experiences);
+      this.populateCaches({
+        anonymousId: profile.id,
+        profile,
+        experiences
+      });
       logger.debug('Profile from api: ', profile);
       logger.debug('Experiences from api: ', experiences);
       this.instance.dispatch({
         type: PROFILE_CHANGE,
         profile,
-        experiences
+        experiences,
+        error: undefined
       });
       await delay(20);
       return {
@@ -304,14 +348,15 @@ class NinetailedCorePlugin extends NinetailedAnalyticsPlugin {
       };
     } catch (error) {
       logger.debug('An error occurred during flushing the events: ', error);
-      const fallbackProfile = this.instance.storage.getItem(PROFILE_FALLBACK_CACHE);
-      const fallbackExperiences = this.instance.storage.getItem(EXPERIENCES_FALLBACK_CACHE) || [];
+      const fallbackProfile = this.getFallbackProfile();
+      const fallbackExperiences = this.getFallbackExperiences();
       if (fallbackProfile) {
         logger.debug('Found a fallback profile - will use this.');
         this.instance.dispatch({
           type: PROFILE_CHANGE,
           profile: fallbackProfile,
-          experiences: fallbackExperiences
+          experiences: fallbackExperiences,
+          error: undefined
         });
       } else {
         logger.debug('No fallback profile found - setting profile to null.');
@@ -319,7 +364,7 @@ class NinetailedCorePlugin extends NinetailedAnalyticsPlugin {
           type: PROFILE_CHANGE,
           profile: null,
           experiences: fallbackExperiences,
-          error
+          error: error
         });
       }
       return {
@@ -400,19 +445,17 @@ const isInterestedInHiddenPage = arg => {
 };
 
 const decodeExperienceVariantsMap = encodedExperienceVariantsMap => {
-  return encodedExperienceVariantsMap.split(',').map(experienceIdWithVariant => {
-    const [experienceId, _variantIndex] = experienceIdWithVariant.split('=');
-    const variantIndex = parseInt(_variantIndex);
+  const experientVariantsAssignments = encodedExperienceVariantsMap.split(',');
+  const experienceVariantsMap = {};
+  for (const experienceVariantAssignment of experientVariantsAssignments) {
+    const [experienceId, variantIndexString] = experienceVariantAssignment.split('=');
+    const variantIndex = parseInt(variantIndexString);
     if (!experienceId || !variantIndex) {
-      return null;
+      continue;
     }
-    return {
-      experienceId,
-      variantIndex
-    };
-  }).filter(x => !!x).reduce((acc, curr) => Object.assign({}, acc, {
-    [curr.experienceId]: curr.variantIndex
-  }), {});
+    experienceVariantsMap[experienceId] = variantIndex;
+  }
+  return experienceVariantsMap;
 };
 
 class OnChangeEmitter {
@@ -474,6 +517,28 @@ const createPassThroughMiddleware = () => {
     };
   };
 };
+function createExperienceSelectionMiddleware({
+  plugins,
+  experiences,
+  baseline,
+  profile
+}) {
+  if (profile === null) {
+    return createPassThroughMiddleware();
+  }
+  const pluginsWithMiddleware = selectPluginsHavingExperienceSelectionMiddleware(plugins);
+  const middlewareFunctions = [];
+  for (const plugin of pluginsWithMiddleware) {
+    const middleware = plugin.getExperienceSelectionMiddleware({
+      experiences,
+      baseline
+    });
+    if (middleware !== undefined) {
+      middlewareFunctions.push(middleware);
+    }
+  }
+  return pipe(...middlewareFunctions);
+}
 const makeExperienceSelectMiddleware = ({
   plugins,
   onChange,
@@ -483,18 +548,12 @@ const makeExperienceSelectMiddleware = ({
 }) => {
   let removeChangeListeners = [];
   const pluginsHavingChangeEmitters = selectPluginsHavingOnChangeEmitter(plugins);
-  const prepareMiddleware = () => {
-    if (profile === null) {
-      return createPassThroughMiddleware();
-    }
-    const pluginsWithMiddleware = selectPluginsHavingExperienceSelectionMiddleware(plugins);
-    const middlewareFunctions = pluginsWithMiddleware.map(plugin => plugin.getExperienceSelectionMiddleware({
-      experiences,
-      baseline
-    })).filter(result => typeof result !== 'undefined');
-    return pipe(...middlewareFunctions);
-  };
-  const middleware = prepareMiddleware();
+  const middleware = createExperienceSelectionMiddleware({
+    plugins,
+    experiences,
+    baseline,
+    profile
+  });
   const addListeners = () => {
     removeChangeListeners = pluginsHavingChangeEmitters.map(plugin => {
       const listener = () => {
@@ -503,8 +562,13 @@ const makeExperienceSelectMiddleware = ({
       return plugin.onChangeEmitter.addListener(listener);
     });
   };
+
+  // WARNING: This specific implementation using forEach is required.
+  // DO NOT replace with for...of or other loop constructs as they will break functionality.
+  // The exact reason is uncertain but appears related to the transplier.
+  // TODO: Come back and find out why this is the case, maybe a version bump is in order.
   const removeListeners = () => {
-    removeChangeListeners.forEach(listener => listener());
+    removeChangeListeners.forEach(removeListener => removeListener());
   };
   return {
     addListeners,
@@ -518,44 +582,36 @@ class EventBuilder {
     this.buildRequestContext = void 0;
     this.buildRequestContext = buildRequestContext || buildClientNinetailedRequestContext;
   }
-  page(properties, data) {
-    return buildPageEvent(Object.assign({
+  buildEventBase(data) {
+    return Object.assign({
       messageId: (data == null ? void 0 : data.messageId) || v4()
     }, data, {
       timestamp: Date.now(),
-      properties: properties || {},
       ctx: this.buildRequestContext()
+    });
+  }
+  page(properties, data) {
+    return buildPageEvent(Object.assign({}, this.buildEventBase(data), {
+      properties: properties || {}
     }));
   }
   track(event, properties, data) {
-    return buildTrackEvent(Object.assign({
-      messageId: (data == null ? void 0 : data.messageId) || v4(),
-      timestamp: Date.now()
-    }, data, {
+    return buildTrackEvent(Object.assign({}, this.buildEventBase(data), {
       event,
-      properties: properties || {},
-      ctx: this.buildRequestContext()
+      properties: properties || {}
     }));
   }
   identify(userId, traits, data) {
-    return buildIdentifyEvent(Object.assign({
-      messageId: (data == null ? void 0 : data.messageId) || v4(),
-      timestamp: Date.now()
-    }, data, {
+    return buildIdentifyEvent(Object.assign({}, this.buildEventBase(data), {
       traits: traits || {},
-      userId: userId || '',
-      ctx: this.buildRequestContext()
+      userId: userId || ''
     }));
   }
   component(componentId, experienceId, variantIndex, data) {
-    return buildComponentViewEvent(Object.assign({
-      messageId: (data == null ? void 0 : data.messageId) || v4(),
-      timestamp: Date.now()
-    }, data, {
+    return buildComponentViewEvent(Object.assign({}, this.buildEventBase(data), {
       componentId,
       experienceId: experienceId || '',
-      variantIndex: variantIndex || 0,
-      ctx: this.buildRequestContext()
+      variantIndex: variantIndex || 0
     }));
   }
 }
@@ -628,11 +684,7 @@ class Ninetailed {
         await _this.instance.page(data, _this.buildOptions(options));
         return _this.ninetailedCorePlugin.flush();
       } catch (error) {
-        logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "page" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        return _this.handleMethodError(error, 'page');
       }
     };
     this.track = async function (event, properties, options) {
@@ -645,11 +697,7 @@ class Ninetailed {
         await _this.instance.track(event.toString(), result.data, _this.buildOptions(options));
         return _this.ninetailedCorePlugin.flush();
       } catch (error) {
-        logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "track" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        _this.handleMethodError(error, 'track');
       }
     };
     this.identify = async function (uid, traits, options) {
@@ -662,11 +710,7 @@ class Ninetailed {
         await _this.instance.identify(uid && uid.toString() !== '' ? uid.toString() : EMPTY_MERGE_ID, result.data, _this.buildOptions(options));
         return _this.ninetailedCorePlugin.flush();
       } catch (error) {
-        logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "identify" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        _this.handleMethodError(error, 'identify');
       }
     };
     this.batch = async function (events) {
@@ -695,11 +739,7 @@ class Ninetailed {
         await Promise.all(promises);
         return _this.ninetailedCorePlugin.flush();
       } catch (error) {
-        logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "batch" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        _this.handleMethodError(error, 'batch');
       }
     };
     this.trackStickyComponentView = async function ({
@@ -717,11 +757,7 @@ class Ninetailed {
         });
         return _this.ninetailedCorePlugin.flush();
       } catch (error) {
-        logger.error(error);
-        if (error instanceof RangeError) {
-          throw new Error(`[Validation Error] "trackStickyComponentView" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
-        }
-        throw error;
+        _this.handleMethodError(error, 'trackStickyComponentView');
       }
     };
     /**
@@ -744,33 +780,13 @@ class Ninetailed {
       const {
           element
         } = payload,
-        remaingPayload = _objectWithoutPropertiesLoose(payload, _excluded2);
+        remainingPayload = _objectWithoutPropertiesLoose(payload, _excluded2);
       if (!(element instanceof Element)) {
-        const isObject = typeof element === 'object' && element !== null;
-        const constructorName = isObject ? element.constructor.name : '';
-        const isConstructorNameNotObject = constructorName && constructorName !== 'Object';
-        logger.warn(`ElementSeenObserver.observeElement was called with an invalid element. Expected an Element but got ${typeof element}${isConstructorNameNotObject ? ` of type ${constructorName}` : ''}. This call will be ignored.`);
-      } else {
-        const existingPayloads = this.observedElements.get(element);
-        const delays = this.pluginsWithCustomComponentViewThreshold.map(plugin => plugin.getComponentViewTrackingThreshold());
-        const uniqueDelays = Array.from(new Set([...delays, options == null ? void 0 : options.delay]));
-        if (!existingPayloads) {
-          this.observedElements.set(element, [remaingPayload]);
-        } else {
-          const isPayloadAlreadyObserved = existingPayloads.some(payload => {
-            return JSON.stringify(payload) === JSON.stringify(remaingPayload);
-          });
-          if (isPayloadAlreadyObserved) {
-            return;
-          }
-          this.observedElements.set(element, [...existingPayloads, remaingPayload]);
-        }
-        uniqueDelays.forEach(delay => {
-          this.elementSeenObserver.observe(element, {
-            delay
-          });
-        });
+        this.logInvalidElement(element);
+        return;
       }
+      this.storeElementPayload(element, remainingPayload);
+      this.setupElementObservation(element, options == null ? void 0 : options.delay);
     };
     this.unobserveElement = element => {
       this.observedElements.delete(element);
@@ -985,14 +1001,14 @@ class Ninetailed {
         removeMiddlewareChangeListeners();
       };
     };
-    this.onIsInitialized = onIsInitialized => {
-      if (typeof onIsInitialized === 'function') {
+    this.onIsInitialized = onIsInitializedCallback => {
+      if (typeof onIsInitializedCallback === 'function') {
         if (this.isInitialized) {
-          onIsInitialized();
+          onIsInitializedCallback();
         } else {
           const detachOnReadyListener = this.instance.on('ready', () => {
             this.isInitialized = true;
-            onIsInitialized();
+            onIsInitializedCallback();
             detachOnReadyListener();
           });
         }
@@ -1119,6 +1135,46 @@ class Ninetailed {
   get pluginsWithCustomComponentViewThreshold() {
     return [this.ninetailedCorePlugin, ...this.plugins].filter(plugin => hasComponentViewTrackingThreshold(plugin));
   }
+  logInvalidElement(element) {
+    const isObject = typeof element === 'object' && element !== null;
+    const constructorName = isObject ? element.constructor.name : '';
+    const isConstructorNameNotObject = constructorName && constructorName !== 'Object';
+    logger.warn(`ElementSeenObserver.observeElement was called with an invalid element. Expected an Element but got ${typeof element}${isConstructorNameNotObject ? ` of type ${constructorName}` : ''}. This call will be ignored.`);
+  }
+  storeElementPayload(element, payload) {
+    const existingPayloads = this.observedElements.get(element) || [];
+
+    // Check if the payload is already being observed for this element
+    const isPayloadAlreadyObserved = existingPayloads.some(existingPayload => JSON.stringify(existingPayload) === JSON.stringify(payload));
+    if (isPayloadAlreadyObserved) {
+      return;
+    }
+
+    // Store the new or updated payloads
+    this.observedElements.set(element, [...existingPayloads, payload]);
+  }
+  setupElementObservation(element, delay) {
+    // Get all relevant delays from plugins and the custom delay
+    const pluginDelays = this.pluginsWithCustomComponentViewThreshold.map(plugin => plugin.getComponentViewTrackingThreshold());
+
+    // Ensure we only observe each delay once
+    const uniqueDelays = Array.from(new Set([...pluginDelays, delay]));
+
+    // Set up observation for each delay
+    uniqueDelays.forEach(delay => {
+      this.elementSeenObserver.observe(element, {
+        delay
+      });
+    });
+  }
+  // Always throws, never returns
+  handleMethodError(error, method) {
+    logger.error(error);
+    if (error instanceof RangeError) {
+      throw new Error(`[Validation Error] "${method}" was called with invalid params. Could not validate due to "RangeError: Maximum call stack size exceeded". This can be caused by passing a cyclic data structure as a parameter. Refrain from passing a cyclic data structure or sanitize it beforehand.`);
+    }
+    throw error;
+  }
   get profileState() {
     return this._profileState;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ninetailed/experience.js",
-  "version": "7.11.0",
+  "version": "7.11.1",
   "description": "Ninetailed SDK for javascript",
   "license": "MIT",
   "repository": {
@@ -9,8 +9,8 @@
     "directory": "packages/sdks/javascript"
   },
   "dependencies": {
-    "@ninetailed/experience.js-plugin-analytics": "7.11.0",
-    "@ninetailed/experience.js-shared": "7.11.0",
+    "@ninetailed/experience.js-plugin-analytics": "7.11.1",
+    "@ninetailed/experience.js-shared": "7.11.1",
     "analytics": "0.8.1",
     "uuid": "9.0.0"
   },

package/src/lib/Ninetailed.d.ts

@@ -71,13 +71,17 @@ export declare class Ninetailed implements NinetailedInstance {
     trackComponentView: TrackComponentView;
     private get pluginsWithCustomComponentViewThreshold();
     observeElement: (payload: ElementSeenPayload, options?: ObserveOptions) => void;
+    private logInvalidElement;
+    private storeElementPayload;
+    private setupElementObservation;
     unobserveElement: (element: Element) => void;
     private onElementSeen;
     reset: () => Promise<void>;
     debug: (enabled: boolean) => Promise<void>;
     onProfileChange: (cb: OnProfileChangeCallback) => import("analytics").DetachListeners;
     onSelectVariant: <Baseline extends Reference, Variant extends Reference>({ baseline, experiences }: OnSelectVariantArgs<Baseline, Variant>, cb: OnSelectVariantCallback<Baseline, Variant>) => () => void;
-    onIsInitialized: (onIsInitialized: OnIsInitializedCallback) => void;
+    private handleMethodError;
+    onIsInitialized: (onIsInitializedCallback: OnIsInitializedCallback) => void;
     private waitUntilInitialized;
     get profileState(): ProfileState;
     private buildOptions;

package/src/lib/NinetailedCorePlugin/NinetailedCorePlugin.d.ts

@@ -1,9 +1,10 @@
-import { AnalyticsInstance } from 'analytics';
+import { AnalyticsInstance, DetachListeners } from 'analytics';
 import { Locale, NinetailedApiClient, NinetailedRequestContext } from '@ninetailed/experience.js-shared';
 import { NinetailedAnalyticsPlugin, SanitizedElementSeenPayload } from '@ninetailed/experience.js-plugin-analytics';
 import { SET_ENABLED_FEATURES } from './constants';
 import { NinetailedInstance, FlushResult } from '../types';
 import { HAS_SEEN_STICKY_COMPONENT } from '../constants';
+import { DispatchAction, ActionPayloadMap } from './actions';
 export type OnInitProfileId = (profileId?: string) => Promise<string | undefined> | string | undefined;
 type AnalyticsPluginNinetailedConfig = {
     apiClient: NinetailedApiClient;
@@ -16,14 +17,15 @@ type AnalyticsPluginNinetailedConfig = {
 export declare const PLUGIN_NAME = "ninetailed:core";
 type EventFn = {
     payload: any;
-    instance: InternalAnalyticsInstance;
+    instance: EventHandlerAnalyticsInstance;
 };
 type AbortableFnParams = {
     abort: () => void;
     payload: unknown;
 };
-type InternalAnalyticsInstance = AnalyticsInstance & {
-    dispatch: (action: any) => void;
+export type EventHandlerAnalyticsInstance = Omit<AnalyticsInstance, 'on' | 'dispatch'> & {
+    dispatch: (action: DispatchAction) => Promise<void>;
+    on<T extends DispatchAction['type']>(action: T, handler: (data: ActionPayloadMap[T]) => void): DetachListeners;
 };
 export interface NinetailedCorePlugin extends NinetailedAnalyticsPlugin {
     flush: (args: void) => Promise<FlushResult>;
@@ -40,7 +42,7 @@ export declare class NinetailedCorePlugin extends NinetailedAnalyticsPlugin impl
     private readonly ninetailed;
     constructor({ apiClient, locale, ninetailed, onInitProfileId, buildClientContext, }: AnalyticsPluginNinetailedConfig);
     initialize({ instance, }: {
-        instance: InternalAnalyticsInstance;
+        instance: EventHandlerAnalyticsInstance;
     }): Promise<void>;
     [SET_ENABLED_FEATURES]: ({ payload }: EventFn) => Promise<void>;
     pageStart(params: AbortableFnParams): unknown;
@@ -65,6 +67,17 @@ export declare class NinetailedCorePlugin extends NinetailedAnalyticsPlugin impl
     private static abortNonClientEvents;
     private get instance();
     flush: (args: void) => Promise<FlushResult>;
+    private getAnonymousId;
+    private setAnonymousId;
+    private clearAnonymousId;
+    private setFallbackProfile;
+    private getFallbackProfile;
+    private clearFallbackProfile;
+    private setFallbackExperiences;
+    private getFallbackExperiences;
+    private clearFallbackExperiences;
+    private clearCaches;
+    private populateCaches;
     private _flush;
 }
 export {};

package/src/lib/NinetailedCorePlugin/actions.d.ts

@@ -0,0 +1,57 @@
+import { HAS_SEEN_COMPONENT, HAS_SEEN_ELEMENT } from '@ninetailed/experience.js-plugin-analytics';
+import { PROFILE_CHANGE, Profile, SelectedVariantInfo, PROFILE_RESET } from '@ninetailed/experience.js-shared';
+import { HAS_SEEN_STICKY_COMPONENT, PAGE_HIDDEN } from '../constants';
+type ReadyAction = {
+    type: 'ready';
+};
+type HasSeenElementAction = {
+    type: typeof HAS_SEEN_ELEMENT;
+    seenFor: number | undefined;
+    element: Element;
+};
+type PageHiddenAction = {
+    type: typeof PAGE_HIDDEN;
+};
+type ProfileChangeAction = {
+    type: typeof PROFILE_CHANGE;
+    profile: Profile;
+    experiences: SelectedVariantInfo[];
+    error: undefined | null;
+} | {
+    type: typeof PROFILE_CHANGE;
+    profile: Profile | null;
+    experiences: SelectedVariantInfo[];
+    error: Error;
+};
+type ProfileResetAction = {
+    type: typeof PROFILE_RESET;
+};
+type ProfileHasSeenStickyComponentAction = {
+    type: typeof HAS_SEEN_STICKY_COMPONENT;
+    componentId: string;
+    experienceId: string | undefined;
+    variantIndex: number | undefined;
+};
+type ProfileHasSeenComponentAction = {
+    type: typeof HAS_SEEN_COMPONENT;
+    variant: {
+        id: string;
+    };
+    audience: {
+        id: string;
+    };
+    isPersonalized: boolean;
+};
+export type DispatchAction = ReadyAction | ProfileChangeAction | ProfileResetAction | ProfileHasSeenStickyComponentAction | HasSeenElementAction | ProfileHasSeenComponentAction | PageHiddenAction;
+type RemoveTypeField<Type> = {
+    [Property in keyof Type as Exclude<Property, 'type'>]: Type[Property];
+};
+export type ExtractPayload<T extends {
+    type: string;
+}> = {
+    payload: RemoveTypeField<T>;
+};
+export type ActionPayloadMap = {
+    [A in DispatchAction as A['type']]: ExtractPayload<A>;
+};
+export {};

package/src/lib/experience/makeExperienceSelectMiddleware.d.ts

@@ -1,20 +1,25 @@
 import { ExperienceConfiguration, Profile, Reference } from '@ninetailed/experience.js-shared';
 import { NinetailedPlugin } from '@ninetailed/experience.js-plugin-analytics';
-import { ExperienceSelectionMiddleware, ExperienceSelectionMiddlewareArg } from '../types/interfaces/HasExperienceSelectionMiddleware';
-type MakeExperienceSelectMiddlewareArg<Baseline extends Reference, Variant extends Reference> = {
+import { ExperienceSelectionMiddleware } from '../types/interfaces/HasExperienceSelectionMiddleware';
+/**
+ * Args for creating an experience selection middleware
+ */
+type CreateExperienceSelectionMiddlewareArg<Baseline extends Reference, Variant extends Reference> = {
     plugins: NinetailedPlugin[];
     experiences: ExperienceConfiguration<Variant>[];
-    baseline: Reference;
+    baseline: Baseline;
     profile: Profile | null;
+};
+type MakeExperienceSelectMiddlewareArg<Baseline extends Reference, Variant extends Reference> = CreateExperienceSelectionMiddlewareArg<Baseline, Variant> & {
     onChange: (middleware: ExperienceSelectionMiddleware<Baseline, Variant>) => void;
 };
-export declare const makeExperienceSelectMiddleware: <TBaseline extends Reference, TVariant extends Reference>({ plugins, onChange, experiences, baseline, profile, }: MakeExperienceSelectMiddlewareArg<TBaseline, TVariant>) => {
+/**
+ * Result of creating an experience selection middleware
+ */
+interface ExperienceSelectMiddlewareResult<Baseline extends Reference, Variant extends Reference> {
     addListeners: () => void;
     removeListeners: () => void;
-    middleware: ({ experience, variant, variantIndex, }: ExperienceSelectionMiddlewareArg<TBaseline, TVariant>) => {
-        experience: ExperienceConfiguration<TVariant> | null;
-        variant: TBaseline | TVariant | import("@ninetailed/experience.js-shared").VariantRef;
-        variantIndex: number;
-    };
-};
+    middleware: ExperienceSelectionMiddleware<Baseline, Variant>;
+}
+export declare const makeExperienceSelectMiddleware: <Baseline extends Reference, Variant extends Reference>({ plugins, onChange, experiences, baseline, profile, }: MakeExperienceSelectMiddlewareArg<Baseline, Variant>) => ExperienceSelectMiddlewareResult<Baseline, Variant>;
 export {};

package/src/lib/types/index.d.ts

@@ -4,27 +4,25 @@ import { ElementSeenPayload, NinetailedPlugin, TrackComponentProperties } from '
 import { type Ninetailed } from '../Ninetailed';
 import { OnSelectVariant } from './OnSelectVariant';
 import { EventBuilder } from '../utils/EventBuilder';
-type Loading = {
+export type ProfileState = {
     status: 'loading';
     profile: null;
     experiences: null;
     error: null;
-};
-type Success = {
+    from: 'api' | 'hydrated';
+} | {
     status: 'success';
     profile: Profile;
     experiences: SelectedVariantInfo[];
     error: null;
-};
-type Fail = {
+    from: 'api' | 'hydrated';
+} | {
     status: 'error';
-    profile: null;
-    experiences: null;
+    profile: Profile | null;
+    experiences: SelectedVariantInfo[] | null;
     error: Error;
-};
-export type ProfileState = {
     from: 'api' | 'hydrated';
-} & (Loading | Success | Fail);
+};
 export type OnIsInitializedCallback = () => void;
 export type OnIsInitialized = (cb: OnIsInitializedCallback) => void;
 export type EventFunctionOptions = {
@@ -36,6 +34,13 @@ export type EventFunctionOptions = {
 export type FlushResult = {
     success: boolean;
 };
+export type Result<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: Error;
+};
 export type OnProfileChangeCallback = (profile: ProfileState) => void;
 export type Page = (data?: Partial<PageviewProperties>, options?: EventFunctionOptions) => Promise<FlushResult>;
 export type Track = (event: string, properties?: Properties, options?: EventFunctionOptions) => Promise<FlushResult>;

package/src/lib/utils/EventBuilder.d.ts

@@ -1,8 +1,13 @@
 import { BuildPageEventArgs, BuildTrackEventArgs, IdentifyEventArgs, NinetailedRequestContext, Properties } from '@ninetailed/experience.js-shared';
+type PageData = Partial<Omit<BuildPageEventArgs, 'ctx' | 'properties'>>;
+type TrackData = Partial<Omit<BuildTrackEventArgs, 'ctx' | 'event' | 'properties'>>;
+type IdentifyData = Partial<Omit<IdentifyEventArgs, 'ctx' | 'userId' | 'traits'>>;
+type ComponentData = Partial<Omit<BuildPageEventArgs, 'ctx' | 'componentId' | 'experienceId' | 'variantIndex'>>;
 export declare class EventBuilder {
     private readonly buildRequestContext;
     constructor(buildRequestContext?: () => NinetailedRequestContext);
-    page(properties?: Properties, data?: Partial<Omit<BuildPageEventArgs, 'ctx' | 'properties'>>): {
+    private buildEventBase;
+    page(properties?: Properties, data?: PageData): {
         channel: import("@ninetailed/experience.js-shared").EventChanel;
         context: {
             app?: {
@@ -56,7 +61,7 @@ export declare class EventBuilder {
         name?: string | undefined;
         properties: import("@ninetailed/experience.js-shared").PageviewProperties;
     };
-    track(event: string, properties?: Properties, data?: Partial<Omit<BuildTrackEventArgs, 'ctx' | 'event' | 'properties'>>): {
+    track(event: string, properties?: Properties, data?: TrackData): {
         channel: import("@ninetailed/experience.js-shared").EventChanel;
         context: {
             app?: {
@@ -110,7 +115,7 @@ export declare class EventBuilder {
         event: string;
         properties: Properties;
     };
-    identify(userId: string, traits?: Properties, data?: Partial<Omit<IdentifyEventArgs, 'ctx' | 'userId' | 'traits'>>): {
+    identify(userId: string, traits?: Properties, data?: IdentifyData): {
         channel: import("@ninetailed/experience.js-shared").EventChanel;
         context: {
             app?: {
@@ -163,7 +168,7 @@ export declare class EventBuilder {
         userId?: string | undefined;
         traits: Properties;
     };
-    component(componentId: string, experienceId?: string, variantIndex?: number, data?: Partial<Omit<BuildPageEventArgs, 'ctx' | 'componentId' | 'experienceId' | 'variantIndex'>>): {
+    component(componentId: string, experienceId?: string, variantIndex?: number, data?: ComponentData): {
         channel: import("@ninetailed/experience.js-shared").EventChanel;
         context: {
             app?: {
@@ -219,3 +224,4 @@ export declare class EventBuilder {
         variantIndex?: number | undefined;
     };
 }
+export {};