@ninetailed/experience.js 4.2.3 → 4.3.0-beta.1

package/index.js

@@ -5,6 +5,8 @@ import { z } from 'zod';
 
 const HAS_SEEN_EXPERIENCE = 'has_seen_experience';
 const HAS_SEEN_COMPONENT = 'has_seen_component';
+const HAS_SEEN_ELEMENT = 'has_seen_element';
+const PAGE_HIDDEN = 'page_hidden';
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
 
@@ -602,9 +604,9 @@ var inspectSource$3 = store$1.inspectSource;
 var global$d = global$k;
 var isCallable$d = isCallable$k;
 
-var WeakMap$1 = global$d.WeakMap;
+var WeakMap$2 = global$d.WeakMap;
 
-var weakMapBasicDetection = isCallable$d(WeakMap$1) && /native code/.test(String(WeakMap$1));
+var weakMapBasicDetection = isCallable$d(WeakMap$2) && /native code/.test(String(WeakMap$2));
 
 var shared$1 = shared$3.exports;
 var uid = uid$2;
@@ -628,7 +630,7 @@ var hiddenKeys$3 = hiddenKeys$4;
 
 var OBJECT_ALREADY_INITIALIZED = 'Object already initialized';
 var TypeError$2 = global$c.TypeError;
-var WeakMap = global$c.WeakMap;
+var WeakMap$1 = global$c.WeakMap;
 var set$1, get, has;
 
 var enforce = function (it) {
@@ -645,7 +647,7 @@ var getterFor = function (TYPE) {
 };
 
 if (NATIVE_WEAK_MAP || shared.state) {
-  var store = shared.state || (shared.state = new WeakMap());
+  var store = shared.state || (shared.state = new WeakMap$1());
   /* eslint-disable no-self-assign -- prototype methods protection */
   store.get = store.get;
   store.has = store.has;
@@ -2517,6 +2519,18 @@ OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
 
+function __rest(s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+}
+
 function __awaiter(thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -2835,6 +2849,115 @@ if (NOT_GENERIC || INCORRECT_NAME) {
   }, { unsafe: true });
 }
 
+var classof = classofRaw$2;
+
+// `IsArray` abstract operation
+// https://tc39.es/ecma262/#sec-isarray
+// eslint-disable-next-line es/no-array-isarray -- safe
+var isArray$2 = Array.isArray || function isArray(argument) {
+  return classof(argument) == 'Array';
+};
+
+var $TypeError$1 = TypeError;
+var MAX_SAFE_INTEGER = 0x1FFFFFFFFFFFFF; // 2 ** 53 - 1 == 9007199254740991
+
+var doesNotExceedSafeInteger$1 = function (it) {
+  if (it > MAX_SAFE_INTEGER) throw $TypeError$1('Maximum allowed index exceeded');
+  return it;
+};
+
+var isArray$1 = isArray$2;
+var lengthOfArrayLike$2 = lengthOfArrayLike$5;
+var doesNotExceedSafeInteger = doesNotExceedSafeInteger$1;
+var bind = functionBindContext;
+
+// `FlattenIntoArray` abstract operation
+// https://tc39.github.io/proposal-flatMap/#sec-FlattenIntoArray
+var flattenIntoArray$1 = function (target, original, source, sourceLen, start, depth, mapper, thisArg) {
+  var targetIndex = start;
+  var sourceIndex = 0;
+  var mapFn = mapper ? bind(mapper, thisArg) : false;
+  var element, elementLen;
+
+  while (sourceIndex < sourceLen) {
+    if (sourceIndex in source) {
+      element = mapFn ? mapFn(source[sourceIndex], sourceIndex, original) : source[sourceIndex];
+
+      if (depth > 0 && isArray$1(element)) {
+        elementLen = lengthOfArrayLike$2(element);
+        targetIndex = flattenIntoArray$1(target, original, element, elementLen, targetIndex, depth - 1) - 1;
+      } else {
+        doesNotExceedSafeInteger(targetIndex + 1);
+        target[targetIndex] = element;
+      }
+
+      targetIndex++;
+    }
+    sourceIndex++;
+  }
+  return targetIndex;
+};
+
+var flattenIntoArray_1 = flattenIntoArray$1;
+
+var isArray = isArray$2;
+var isConstructor = isConstructor$2;
+var isObject$1 = isObject$a;
+var wellKnownSymbol$3 = wellKnownSymbol$h;
+
+var SPECIES = wellKnownSymbol$3('species');
+var $Array = Array;
+
+// a part of `ArraySpeciesCreate` abstract operation
+// https://tc39.es/ecma262/#sec-arrayspeciescreate
+var arraySpeciesConstructor$1 = function (originalArray) {
+  var C;
+  if (isArray(originalArray)) {
+    C = originalArray.constructor;
+    // cross-realm fallback
+    if (isConstructor(C) && (C === $Array || isArray(C.prototype))) C = undefined;
+    else if (isObject$1(C)) {
+      C = C[SPECIES];
+      if (C === null) C = undefined;
+    }
+  } return C === undefined ? $Array : C;
+};
+
+var arraySpeciesConstructor = arraySpeciesConstructor$1;
+
+// `ArraySpeciesCreate` abstract operation
+// https://tc39.es/ecma262/#sec-arrayspeciescreate
+var arraySpeciesCreate$1 = function (originalArray, length) {
+  return new (arraySpeciesConstructor(originalArray))(length === 0 ? 0 : length);
+};
+
+var $$3 = _export;
+var flattenIntoArray = flattenIntoArray_1;
+var toObject$2 = toObject$5;
+var lengthOfArrayLike$1 = lengthOfArrayLike$5;
+var toIntegerOrInfinity = toIntegerOrInfinity$3;
+var arraySpeciesCreate = arraySpeciesCreate$1;
+
+// `Array.prototype.flat` method
+// https://tc39.es/ecma262/#sec-array.prototype.flat
+$$3({ target: 'Array', proto: true }, {
+  flat: function flat(/* depthArg = 1 */) {
+    var depthArg = arguments.length ? arguments[0] : undefined;
+    var O = toObject$2(this);
+    var sourceLen = lengthOfArrayLike$1(O);
+    var A = arraySpeciesCreate(O, 0);
+    A.length = flattenIntoArray(A, O, O, sourceLen, 0, depthArg === undefined ? 1 : toIntegerOrInfinity(depthArg));
+    return A;
+  }
+});
+
+// this method was added to unscopables after implementation
+// in popular engines, so it's moved to a separate module
+var addToUnscopables$1 = addToUnscopables$3;
+
+// https://tc39.es/ecma262/#sec-array.prototype-@@unscopables
+addToUnscopables$1('flat');
+
 var fails$3 = fails$h;
 
 var correctPrototypeGetter = !fails$3(function () {
@@ -2846,7 +2969,7 @@ var correctPrototypeGetter = !fails$3(function () {
 
 var hasOwn = hasOwnProperty_1;
 var isCallable$2 = isCallable$k;
-var toObject$2 = toObject$5;
+var toObject$1 = toObject$5;
 var sharedKey = sharedKey$3;
 var CORRECT_PROTOTYPE_GETTER = correctPrototypeGetter;
 
@@ -2858,7 +2981,7 @@ var ObjectPrototype = $Object.prototype;
 // https://tc39.es/ecma262/#sec-object.getprototypeof
 // eslint-disable-next-line es/no-object-getprototypeof -- safe
 var objectGetPrototypeOf = CORRECT_PROTOTYPE_GETTER ? $Object.getPrototypeOf : function (O) {
-  var object = toObject$2(O);
+  var object = toObject$1(O);
   if (hasOwn(object, IE_PROTO)) return object[IE_PROTO];
   var constructor = object.constructor;
   if (isCallable$2(constructor) && object instanceof constructor) {
@@ -2868,12 +2991,12 @@ var objectGetPrototypeOf = CORRECT_PROTOTYPE_GETTER ? $Object.getPrototypeOf : f
 
 var fails$2 = fails$h;
 var isCallable$1 = isCallable$k;
-var isObject$1 = isObject$a;
+var isObject = isObject$a;
 var getPrototypeOf$1 = objectGetPrototypeOf;
 var defineBuiltIn$1 = defineBuiltIn$6;
-var wellKnownSymbol$3 = wellKnownSymbol$h;
+var wellKnownSymbol$2 = wellKnownSymbol$h;
 
-var ITERATOR$3 = wellKnownSymbol$3('iterator');
+var ITERATOR$3 = wellKnownSymbol$2('iterator');
 var BUGGY_SAFARI_ITERATORS$1 = false;
 
 // `%IteratorPrototype%` object
@@ -2891,7 +3014,7 @@ if ([].keys) {
   }
 }
 
-var NEW_ITERATOR_PROTOTYPE = !isObject$1(IteratorPrototype$2) || fails$2(function () {
+var NEW_ITERATOR_PROTOTYPE = !isObject(IteratorPrototype$2) || fails$2(function () {
   var test = {};
   // FF44- legacy iterators case
   return IteratorPrototype$2[ITERATOR$3].call(test) !== test;
@@ -2928,7 +3051,7 @@ var iteratorCreateConstructor = function (IteratorConstructor, NAME, next, ENUME
   return IteratorConstructor;
 };
 
-var $$3 = _export;
+var $$2 = _export;
 var call = functionCall;
 var FunctionName = functionName;
 var isCallable = isCallable$k;
@@ -2938,7 +3061,7 @@ var setPrototypeOf = objectSetPrototypeOf;
 var setToStringTag = setToStringTag$3;
 var createNonEnumerableProperty$1 = createNonEnumerableProperty$4;
 var defineBuiltIn = defineBuiltIn$6;
-var wellKnownSymbol$2 = wellKnownSymbol$h;
+var wellKnownSymbol$1 = wellKnownSymbol$h;
 var Iterators$1 = iterators;
 var IteratorsCore = iteratorsCore;
 
@@ -2946,7 +3069,7 @@ var PROPER_FUNCTION_NAME = FunctionName.PROPER;
 var CONFIGURABLE_FUNCTION_NAME = FunctionName.CONFIGURABLE;
 var IteratorPrototype = IteratorsCore.IteratorPrototype;
 var BUGGY_SAFARI_ITERATORS = IteratorsCore.BUGGY_SAFARI_ITERATORS;
-var ITERATOR$2 = wellKnownSymbol$2('iterator');
+var ITERATOR$2 = wellKnownSymbol$1('iterator');
 var KEYS = 'keys';
 var VALUES = 'values';
 var ENTRIES = 'entries';
@@ -3013,7 +3136,7 @@ var iteratorDefine = function (Iterable, NAME, IteratorConstructor, next, DEFAUL
       if (BUGGY_SAFARI_ITERATORS || INCORRECT_VALUES_NAME || !(KEY in IterablePrototype)) {
         defineBuiltIn(IterablePrototype, KEY, methods[KEY]);
       }
-    } else $$3({ target: NAME, proto: true, forced: BUGGY_SAFARI_ITERATORS || INCORRECT_VALUES_NAME }, methods);
+    } else $$2({ target: NAME, proto: true, forced: BUGGY_SAFARI_ITERATORS || INCORRECT_VALUES_NAME }, methods);
   }
 
   // define iterator
@@ -3032,7 +3155,7 @@ var createIterResultObject$1 = function (value, done) {
 };
 
 var toIndexedObject = toIndexedObject$5;
-var addToUnscopables$1 = addToUnscopables$3;
+var addToUnscopables = addToUnscopables$3;
 var Iterators = iterators;
 var InternalStateModule = internalState;
 var defineProperty = objectDefineProperty.f;
@@ -3083,9 +3206,9 @@ var es_array_iterator = defineIterator(Array, 'Array', function (iterated, kind)
 var values = Iterators.Arguments = Iterators.Array;
 
 // https://tc39.es/ecma262/#sec-array.prototype-@@unscopables
-addToUnscopables$1('keys');
-addToUnscopables$1('values');
-addToUnscopables$1('entries');
+addToUnscopables('keys');
+addToUnscopables('values');
+addToUnscopables('entries');
 
 // V8 ~ Chrome 45- bug
 if (DESCRIPTORS && values.name !== 'values') try {
@@ -3141,10 +3264,10 @@ var DOMIterables = domIterables;
 var DOMTokenListPrototype = domTokenListPrototype;
 var ArrayIteratorMethods = es_array_iterator;
 var createNonEnumerableProperty = createNonEnumerableProperty$4;
-var wellKnownSymbol$1 = wellKnownSymbol$h;
+var wellKnownSymbol = wellKnownSymbol$h;
 
-var ITERATOR$1 = wellKnownSymbol$1('iterator');
-var TO_STRING_TAG = wellKnownSymbol$1('toStringTag');
+var ITERATOR$1 = wellKnownSymbol('iterator');
+var TO_STRING_TAG = wellKnownSymbol('toStringTag');
 var ArrayValues = ArrayIteratorMethods.values;
 
 var handlePrototype = function (CollectionPrototype, COLLECTION_NAME) {
@@ -3175,115 +3298,54 @@ for (var COLLECTION_NAME in DOMIterables) {
 
 handlePrototype(DOMTokenListPrototype, 'DOMTokenList');
 
-var classof = classofRaw$2;
-
-// `IsArray` abstract operation
-// https://tc39.es/ecma262/#sec-isarray
-// eslint-disable-next-line es/no-array-isarray -- safe
-var isArray$2 = Array.isArray || function isArray(argument) {
-  return classof(argument) == 'Array';
-};
-
-var $TypeError$1 = TypeError;
-var MAX_SAFE_INTEGER = 0x1FFFFFFFFFFFFF; // 2 ** 53 - 1 == 9007199254740991
-
-var doesNotExceedSafeInteger$1 = function (it) {
-  if (it > MAX_SAFE_INTEGER) throw $TypeError$1('Maximum allowed index exceeded');
-  return it;
-};
-
-var isArray$1 = isArray$2;
-var lengthOfArrayLike$2 = lengthOfArrayLike$5;
-var doesNotExceedSafeInteger = doesNotExceedSafeInteger$1;
-var bind = functionBindContext;
-
-// `FlattenIntoArray` abstract operation
-// https://tc39.github.io/proposal-flatMap/#sec-FlattenIntoArray
-var flattenIntoArray$1 = function (target, original, source, sourceLen, start, depth, mapper, thisArg) {
-  var targetIndex = start;
-  var sourceIndex = 0;
-  var mapFn = mapper ? bind(mapper, thisArg) : false;
-  var element, elementLen;
-
-  while (sourceIndex < sourceLen) {
-    if (sourceIndex in source) {
-      element = mapFn ? mapFn(source[sourceIndex], sourceIndex, original) : source[sourceIndex];
-
-      if (depth > 0 && isArray$1(element)) {
-        elementLen = lengthOfArrayLike$2(element);
-        targetIndex = flattenIntoArray$1(target, original, element, elementLen, targetIndex, depth - 1) - 1;
+class ElementSeenObserver {
+  constructor(_options) {
+    this._options = _options;
+    this._elementDelays = new WeakMap();
+    this._intersectionTimers = new WeakMap();
+    if (typeof IntersectionObserver !== 'undefined') {
+      this._intersectionObserver = new IntersectionObserver(this.onIntersection.bind(this));
+    }
+  }
+  onIntersection(entries) {
+    entries.forEach(entry => {
+      const {
+        isIntersecting,
+        target
+      } = entry;
+      if (isIntersecting) {
+        const delay = this._elementDelays.get(target);
+        const timeOut = window.setTimeout(() => {
+          this._options.onElementSeen(target);
+        }, delay);
+        this._intersectionTimers.set(target, timeOut);
       } else {
-        doesNotExceedSafeInteger(targetIndex + 1);
-        target[targetIndex] = element;
+        const timeOut = this._intersectionTimers.get(target);
+        if (typeof timeOut !== 'undefined') {
+          window.clearTimeout(timeOut);
+        }
       }
-
-      targetIndex++;
-    }
-    sourceIndex++;
+    });
   }
-  return targetIndex;
-};
-
-var flattenIntoArray_1 = flattenIntoArray$1;
-
-var isArray = isArray$2;
-var isConstructor = isConstructor$2;
-var isObject = isObject$a;
-var wellKnownSymbol = wellKnownSymbol$h;
-
-var SPECIES = wellKnownSymbol('species');
-var $Array = Array;
+  observe(element, options) {
+    var _a, _b;
+    this._elementDelays.set(element, (_a = options === null || options === void 0 ? void 0 : options.delay) !== null && _a !== void 0 ? _a : 2000);
+    (_b = this._intersectionObserver) === null || _b === void 0 ? void 0 : _b.observe(element);
+  }
+  unobserve(element) {
+    var _a;
+    (_a = this._intersectionObserver) === null || _a === void 0 ? void 0 : _a.unobserve(element);
+  }
+}
 
-// a part of `ArraySpeciesCreate` abstract operation
-// https://tc39.es/ecma262/#sec-arrayspeciescreate
-var arraySpeciesConstructor$1 = function (originalArray) {
-  var C;
-  if (isArray(originalArray)) {
-    C = originalArray.constructor;
-    // cross-realm fallback
-    if (isConstructor(C) && (C === $Array || isArray(C.prototype))) C = undefined;
-    else if (isObject(C)) {
-      C = C[SPECIES];
-      if (C === null) C = undefined;
-    }
-  } return C === undefined ? $Array : C;
+const acceptsCredentials = plugin => {
+  return typeof plugin === 'object' && plugin !== null && 'setCredentials' in plugin && typeof plugin.setCredentials === 'function';
 };
 
-var arraySpeciesConstructor = arraySpeciesConstructor$1;
-
-// `ArraySpeciesCreate` abstract operation
-// https://tc39.es/ecma262/#sec-arrayspeciescreate
-var arraySpeciesCreate$1 = function (originalArray, length) {
-  return new (arraySpeciesConstructor(originalArray))(length === 0 ? 0 : length);
+const isInterestedInHiddenPage = arg => {
+  return typeof arg === 'object' && arg !== null && PAGE_HIDDEN in arg && typeof arg[PAGE_HIDDEN] === 'function';
 };
 
-var $$2 = _export;
-var flattenIntoArray = flattenIntoArray_1;
-var toObject$1 = toObject$5;
-var lengthOfArrayLike$1 = lengthOfArrayLike$5;
-var toIntegerOrInfinity = toIntegerOrInfinity$3;
-var arraySpeciesCreate = arraySpeciesCreate$1;
-
-// `Array.prototype.flat` method
-// https://tc39.es/ecma262/#sec-array.prototype.flat
-$$2({ target: 'Array', proto: true }, {
-  flat: function flat(/* depthArg = 1 */) {
-    var depthArg = arguments.length ? arguments[0] : undefined;
-    var O = toObject$1(this);
-    var sourceLen = lengthOfArrayLike$1(O);
-    var A = arraySpeciesCreate(O, 0);
-    A.length = flattenIntoArray(A, O, O, sourceLen, 0, depthArg === undefined ? 1 : toIntegerOrInfinity(depthArg));
-    return A;
-  }
-});
-
-// this method was added to unscopables after implementation
-// in popular engines, so it's moved to a separate module
-var addToUnscopables = addToUnscopables$3;
-
-// https://tc39.es/ecma262/#sec-array.prototype-@@unscopables
-addToUnscopables('flat');
-
 class Ninetailed {
   constructor(ninetailedApiClientInstanceOrOptions, {
     plugins,
@@ -3339,6 +3401,28 @@ class Ninetailed {
         type: HAS_SEEN_EXPERIENCE
       }));
     };
+    this.observeElement = (payload, options) => {
+      const {
+          element
+        } = payload,
+        remaingPayload = __rest(payload, ["element"]);
+      this.observedElements.set(element, remaingPayload);
+      this.elementSeenObserver.observe(element, options);
+    };
+    this.unobserveElement = element => {
+      this.observedElements.delete(element);
+      this.elementSeenObserver.unobserve(element);
+    };
+    this.onElementSeen = element => {
+      const payload = this.observedElements.get(element);
+      if (typeof payload !== 'undefined') {
+        this.instance.dispatch(Object.assign(Object.assign({
+          element
+        }, payload), {
+          type: HAS_SEEN_ELEMENT
+        }));
+      }
+    };
     this.identify = (uid, traits, options) => __awaiter(this, void 0, void 0, function* () {
       try {
         const result = Traits.default({}).safeParse(traits);
@@ -3406,6 +3490,18 @@ class Ninetailed {
         this.onIsInitialized(resolve);
       });
     };
+    this.onVisibilityChange = () => {
+      if (typeof document === 'undefined') {
+        return;
+      }
+      document.addEventListener('visibilitychange', () => {
+        if (document.visibilityState === 'hidden') {
+          this.instance.dispatch({
+            type: PAGE_HIDDEN
+          });
+        }
+      });
+    };
     if (ninetailedApiClientInstanceOrOptions instanceof NinetailedApiClient) {
       this.apiClient = ninetailedApiClientInstanceOrOptions;
     } else {
@@ -3423,15 +3519,15 @@ class Ninetailed {
         preview
       });
     }
-    this.plugins = [...(plugins || []).map(plugin => {
-      if ('setCredentials' in plugin && typeof plugin['setCredentials'] === 'function') {
-        plugin['setCredentials']({
+    this.plugins = (plugins !== null && plugins !== void 0 ? plugins : []).flat();
+    this.plugins.forEach(plugin => {
+      if (acceptsCredentials(plugin) && this.clientId && this.environment) {
+        plugin.setCredentials({
           clientId: this.clientId,
           environment: this.environment
         });
       }
-      return plugin;
-    }).flat()];
+    });
     if (profile) {
       this._profileState = {
         status: 'success',
@@ -3479,6 +3575,14 @@ class Ninetailed {
         });
       }
     });
+    this.observedElements = new WeakMap();
+    this.elementSeenObserver = new ElementSeenObserver({
+      onElementSeen: this.onElementSeen.bind(this)
+    });
+    const hasPluginsInterestedInHiddenPage = this.plugins.some(isInterestedInHiddenPage);
+    if (hasPluginsInterestedInHiddenPage) {
+      this.onVisibilityChange();
+    }
     this.registerWindowHandlers();
   }
   get profileState() {
@@ -3877,4 +3981,4 @@ const makeExperienceSelectMiddleware = ({
   };
 };
 
-export { ANONYMOUS_ID, CONSENT, DEBUG_FLAG, EMPTY_MERGE_ID, HAS_SEEN_COMPONENT, HAS_SEEN_EXPERIENCE, LEGACY_ANONYMOUS_ID, Ninetailed, NinetailedPlugin, OnChangeEmitter, PLUGIN_NAME, PROFILE_CHANGE, PROFILE_FALLBACK_CACHE, PROFILE_RESET, SET_ENABLED_FEATURES, TrackComponentProperties, TrackExperienceProperties, decodeExperienceVariantsMap, makeExperienceSelectMiddleware, ninetailedPlugin, selectPluginsHavingExperienceSelectionMiddleware, selectPluginsHavingOnChangeEmitter, selectVariant };
+export { ANONYMOUS_ID, CONSENT, DEBUG_FLAG, EMPTY_MERGE_ID, HAS_SEEN_COMPONENT, HAS_SEEN_ELEMENT, HAS_SEEN_EXPERIENCE, LEGACY_ANONYMOUS_ID, Ninetailed, NinetailedPlugin, OnChangeEmitter, PAGE_HIDDEN, PLUGIN_NAME, PROFILE_CHANGE, PROFILE_FALLBACK_CACHE, PROFILE_RESET, SET_ENABLED_FEATURES, TrackComponentProperties, TrackExperienceProperties, buildClientNinetailedRequestContext, decodeExperienceVariantsMap, makeExperienceSelectMiddleware, ninetailedPlugin, selectPluginsHavingExperienceSelectionMiddleware, selectPluginsHavingOnChangeEmitter, selectVariant };

package/lib/ElementSeenObserver.d.ts

@@ -0,0 +1,16 @@
+export type ElementSeenObserverOptions = {
+    onElementSeen: (element: Element) => void;
+};
+export type ObserveOptions = {
+    delay?: number;
+};
+export declare class ElementSeenObserver {
+    private _options;
+    private _intersectionObserver?;
+    private _elementDelays;
+    private _intersectionTimers;
+    constructor(_options: ElementSeenObserverOptions);
+    private onIntersection;
+    observe(element: Element, options?: ObserveOptions): void;
+    unobserve(element: Element): void;
+}

package/lib/Ninetailed.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="analytics" />
 import { Locale, Traits, Profile, OnLogHandler, OnErrorHandler, Logger, PageviewProperties, Properties, NinetailedApiClient, NinetailedApiClientOptions } from '@ninetailed/experience.js-shared';
-import { EventFunctionOptions, NinetailedInstance, NinetailedPlugin, OnIsInitializedCallback, OnProfileChangeCallback, ProfileState, TrackHasSeenComponent, TrackHasSeenExperience } from './types';
+import { EventFunctionOptions, NinetailedInstance, NinetailedPlugin, OnIsInitializedCallback, OnProfileChangeCallback, ProfileState, TrackHasSeenComponent, TrackHasSeenExperience, ElementSeenPayload } from './types';
+import { ObserveOptions } from './ElementSeenObserver';
 declare global {
     interface Window {
         ninetailed?: {
@@ -27,6 +28,8 @@ export declare class Ninetailed implements NinetailedInstance {
     private isInitialized;
     private readonly apiClient;
     private readonly eventQueue;
+    private readonly elementSeenObserver;
+    private readonly observedElements;
     private readonly clientId;
     private readonly environment;
     readonly plugins: NinetailedPlugin[];
@@ -36,6 +39,9 @@ export declare class Ninetailed implements NinetailedInstance {
     track: (event: string, properties?: Properties, options?: EventFunctionOptions) => Promise<import("./types").FlushResult>;
     trackHasSeenComponent: TrackHasSeenComponent;
     trackHasSeenExperience: TrackHasSeenExperience;
+    observeElement: (payload: ElementSeenPayload, options?: ObserveOptions) => void;
+    unobserveElement: (element: Element) => void;
+    private onElementSeen;
     identify: (uid: string, traits?: Traits, options?: EventFunctionOptions) => Promise<import("./types").FlushResult>;
     reset: () => Promise<void>;
     debug: (enabled: boolean) => Promise<void>;
@@ -45,5 +51,6 @@ export declare class Ninetailed implements NinetailedInstance {
     get profileState(): ProfileState;
     private buildOptions;
     private registerWindowHandlers;
+    private onVisibilityChange;
 }
 export {};

package/lib/analytics/index.d.ts

@@ -1,2 +1,3 @@
 export * from './get-analytics-plugin';
 export * from './constants';
+export * from './Events';

package/lib/constants.d.ts

@@ -1,2 +1,4 @@
 export declare const HAS_SEEN_EXPERIENCE = "has_seen_experience";
 export declare const HAS_SEEN_COMPONENT = "has_seen_component";
+export declare const HAS_SEEN_ELEMENT = "has_seen_element";
+export declare const PAGE_HIDDEN = "page_hidden";

package/lib/guards/acceptsCredentials.d.ts

@@ -0,0 +1,2 @@
+import { AcceptsCredentials } from '../types/interfaces/AcceptsCredentials';
+export declare const acceptsCredentials: (plugin: unknown) => plugin is AcceptsCredentials;

package/lib/guards/isInterestedInHiddenPage.d.ts

@@ -0,0 +1,2 @@
+import { InterestedInHiddenPage } from '../types/interfaces/InterestedInHiddenPage';
+export declare const isInterestedInHiddenPage: (arg: unknown) => arg is InterestedInHiddenPage;

package/lib/guards/isInterestedInSeenElements.d.ts

@@ -0,0 +1,2 @@
+import { InterestedInSeenElements } from '../types/interfaces/InterestedInSeenElements';
+export declare const isInterestedInSeenElements: (arg: unknown) => arg is InterestedInSeenElements;

package/lib/types/Credentials.d.ts

@@ -0,0 +1,4 @@
+export type Credentials = {
+    clientId: string;
+    environment: string;
+};

package/lib/types/ElementSeenPayload.d.ts

@@ -0,0 +1,7 @@
+export type ElementSeenPayload = {
+    element: Element;
+    experienceId?: string;
+    baselineId?: string;
+    variantId?: string;
+    audienceId?: string;
+};

package/lib/types/ProfileChangedPayload.d.ts

@@ -0,0 +1,4 @@
+import { type Profile } from '@ninetailed/experience.js-shared';
+export type ProfileChangedPayload = {
+    profile: Profile;
+};