@ninetailed/experience.js 4.1.0-beta.0 → 4.1.0-beta.1

package/index.cjs

@@ -3488,13 +3488,27 @@ const selectVariant$1 = (baseline, variants, {
   };
 };
 
+class NinetailedPlugin {}
+
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const EXPERIENCE_TRAIT_PREFIX = 'nt_experiment_';
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectBaselineWithVariants = (experience, baseline) => {
   var _a;
   return (_a = experience.components.find(baselineWithVariants => baselineWithVariants.baseline.id === baseline.id)) !== null && _a !== void 0 ? _a : null;
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectVariants = (experience, baseline) => {
   const baselineWithVariants = selectBaselineWithVariants(experience, baseline);
   if (!baselineWithVariants) {
@@ -3503,6 +3517,10 @@ const selectVariants = (experience, baseline) => {
   return baselineWithVariants.variants;
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectHasVariants = (experience, baseline) => {
   const variants = selectVariants(experience, baseline);
   return variants.length > 0;
@@ -4045,6 +4063,10 @@ fixRegExpWellKnownSymbolLogic('replace', function (_, nativeReplace, maybeCallNa
   ];
 }, !REPLACE_SUPPORTS_NAMED_GROUPS || !REPLACE_KEEPS_$0 || REGEXP_REPLACE_SUBSTITUTES_UNDEFINED_CAPTURE);
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectActiveExperiments = (experiments, profile) => {
   const experimentTraits = pickBy__default["default"](profile.traits, (value, key) => key.startsWith(EXPERIENCE_TRAIT_PREFIX) && value === true);
   const experimentTraitsIds = Object.keys(experimentTraits).map(id => id.replace(EXPERIENCE_TRAIT_PREFIX, ''));
@@ -4058,6 +4080,10 @@ const selectActiveExperiments = (experiments, profile) => {
  * When going for an experiment we can only select a active experiment when 1 or more experiments are active
  * If the profile is not in any active experiments, we can select any expermiment
  */
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectEligibleExperiences = ({
   experiences,
   activeExperiments
@@ -4075,9 +4101,21 @@ const getRandom = text => {
   const random = normalize(hash, LOWER_BOUND, UPPER_BOUND);
   return random;
 };
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const getTrafficRandom = (profile, experience) => getRandom(`traffic-${experience.id}-${profile.id}`);
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const getDistributionRandom = (profile, experience) => getRandom(`distribution-${experience.id}-${profile.id}`);
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const isExperienceMatch = ({
   experience,
   activeExperiments,
@@ -4098,6 +4136,10 @@ const isExperienceMatch = ({
   hasActiveExperiment);
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectExperience = ({
   experiences,
   activeExperiments,
@@ -4115,6 +4157,10 @@ const selectExperience = ({
   return selectedExperience !== null && selectedExperience !== void 0 ? selectedExperience : null;
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectDistribution = ({
   experience,
   profile
@@ -4138,6 +4184,10 @@ const selectDistribution = ({
   return distribution;
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectVariant = ({
   baseline,
   experience,
@@ -4329,6 +4379,102 @@ const decodeExperienceVariantsMap = encodedExperienceVariantsMap => {
   }), {});
 };
 
+class OnChangeEmitter {
+  constructor() {
+    this.onChangeListeners = [];
+  }
+  addListener(listener) {
+    this.onChangeListeners.push(listener);
+    return () => {
+      this.removeOnChangeListener(listener);
+    };
+  }
+  invokeListeners() {
+    this.onChangeListeners.forEach(listener => listener());
+  }
+  removeOnChangeListener(listener) {
+    this.onChangeListeners = this.onChangeListeners.filter(l => l !== listener);
+  }
+}
+
+const hasOnChangeEmitter = arg => {
+  return typeof arg === 'object' && arg !== null && 'onChangeEmitter' in arg && typeof arg.onChangeEmitter === 'object' && arg.onChangeEmitter !== null && arg.onChangeEmitter.constructor === OnChangeEmitter;
+};
+
+const selectPluginsHavingOnChangeEmitter = plugins => {
+  const filteredPlugins = [];
+  for (const plugin of plugins) {
+    if (hasOnChangeEmitter(plugin)) {
+      filteredPlugins.push(plugin);
+    }
+  }
+  return filteredPlugins;
+};
+
+const hasExperienceSelectionMiddleware = arg => {
+  return typeof arg === 'object' && arg !== null && 'getExperienceSelectionMiddleware' in arg && typeof arg.getExperienceSelectionMiddleware === 'function';
+};
+
+const selectPluginsHavingExperienceSelectionMiddleware = plugins => {
+  const filteredPlugins = [];
+  for (const plugin of plugins) {
+    if (hasExperienceSelectionMiddleware(plugin)) {
+      filteredPlugins.push(plugin);
+    }
+  }
+  return filteredPlugins;
+};
+
+const createPassThroughMiddleware = () => {
+  return ({
+    experience,
+    variant
+  }) => {
+    return {
+      experience,
+      variant
+    };
+  };
+};
+const makeExperienceSelectMiddleware = ({
+  plugins,
+  onChange,
+  experiences,
+  baseline,
+  profile
+}) => {
+  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
+    }));
+    return experience_jsShared.pipe(...middlewareFunctions);
+  };
+  const addListeners = () => {
+    removeChangeListeners = pluginsHavingChangeEmitters.map(plugin => {
+      const listener = () => {
+        onChange();
+      };
+      return plugin.onChangeEmitter.addListener(listener);
+    });
+  };
+  const removeListeners = () => {
+    removeChangeListeners.forEach(listener => listener());
+  };
+  const middleware = prepareMiddleware();
+  return {
+    addListeners,
+    removeListeners,
+    middleware
+  };
+};
+
 exports.ANONYMOUS_ID = ANONYMOUS_ID;
 exports.CONSENT = CONSENT;
 exports.DEBUG_FLAG = DEBUG_FLAG;
@@ -4336,6 +4482,8 @@ exports.EMPTY_MERGE_ID = EMPTY_MERGE_ID;
 exports.EXPERIENCE_TRAIT_PREFIX = EXPERIENCE_TRAIT_PREFIX;
 exports.LEGACY_ANONYMOUS_ID = LEGACY_ANONYMOUS_ID;
 exports.Ninetailed = Ninetailed;
+exports.NinetailedPlugin = NinetailedPlugin;
+exports.OnChangeEmitter = OnChangeEmitter;
 exports.PLUGIN_NAME = PLUGIN_NAME;
 exports.PROFILE_CHANGE = PROFILE_CHANGE;
 exports.PROFILE_FALLBACK_CACHE = PROFILE_FALLBACK_CACHE;
@@ -4343,6 +4491,7 @@ exports.PROFILE_RESET = PROFILE_RESET;
 exports.SET_ENABLED_FEATURES = SET_ENABLED_FEATURES;
 exports.decodeExperienceVariantsMap = decodeExperienceVariantsMap;
 exports.isExperienceMatch = isExperienceMatch;
+exports.makeExperienceSelectMiddleware = makeExperienceSelectMiddleware;
 exports.ninetailedPlugin = ninetailedPlugin;
 exports.selectActiveExperiments = selectActiveExperiments;
 exports.selectDistribution = selectDistribution;
@@ -4352,4 +4501,6 @@ exports.selectExperienceBaselineWithVariants = selectBaselineWithVariants;
 exports.selectExperienceVariant = selectVariant;
 exports.selectExperienceVariants = selectVariants;
 exports.selectHasExperienceVariants = selectHasVariants;
+exports.selectPluginsHavingExperienceSelectionMiddleware = selectPluginsHavingExperienceSelectionMiddleware;
+exports.selectPluginsHavingOnChangeEmitter = selectPluginsHavingOnChangeEmitter;
 exports.selectVariant = selectVariant$1;

package/index.d.ts

@@ -3,4 +3,8 @@ export * from './lib/Ninetailed';
 export * from './lib/selectVariant';
 export * from './lib/types';
 export * from './lib/experience';
+export * from './lib/plugins/selectPluginsHavingExperienceSelectionMiddleware';
+export * from './lib/plugins/selectPluginsHavingOnChangeEmitter';
+export * from './lib/types/interfaces/HasExperienceSelectionMiddleware';
+export * from './lib/utils/OnChangeEmitter';
 export type { Profile } from '@ninetailed/experience.js-shared';

package/index.js

@@ -1,5 +1,5 @@
 import unionBy from 'lodash/unionBy';
-import { FEATURES, logger, ConsoleLogSink, buildPageEvent, buildTrackEvent, buildIdentifyEvent, NinetailedApiClient, OnLogLogSink, OnErrorLogSink, PageviewProperties, Properties, Traits } from '@ninetailed/experience.js-shared';
+import { FEATURES, logger, ConsoleLogSink, buildPageEvent, buildTrackEvent, buildIdentifyEvent, NinetailedApiClient, OnLogLogSink, OnErrorLogSink, PageviewProperties, Properties, Traits, pipe } from '@ninetailed/experience.js-shared';
 import Analytics from 'analytics';
 import { HAS_SEEN_EXPERIENCE, HAS_SEEN_COMPONENT } from '@ninetailed/experience.js-plugin-analytics';
 import flatten from 'lodash/flatten';
@@ -3475,13 +3475,27 @@ const selectVariant$1 = (baseline, variants, {
   };
 };
 
+class NinetailedPlugin {}
+
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const EXPERIENCE_TRAIT_PREFIX = 'nt_experiment_';
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectBaselineWithVariants = (experience, baseline) => {
   var _a;
   return (_a = experience.components.find(baselineWithVariants => baselineWithVariants.baseline.id === baseline.id)) !== null && _a !== void 0 ? _a : null;
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectVariants = (experience, baseline) => {
   const baselineWithVariants = selectBaselineWithVariants(experience, baseline);
   if (!baselineWithVariants) {
@@ -3490,6 +3504,10 @@ const selectVariants = (experience, baseline) => {
   return baselineWithVariants.variants;
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectHasVariants = (experience, baseline) => {
   const variants = selectVariants(experience, baseline);
   return variants.length > 0;
@@ -4032,6 +4050,10 @@ fixRegExpWellKnownSymbolLogic('replace', function (_, nativeReplace, maybeCallNa
   ];
 }, !REPLACE_SUPPORTS_NAMED_GROUPS || !REPLACE_KEEPS_$0 || REGEXP_REPLACE_SUBSTITUTES_UNDEFINED_CAPTURE);
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectActiveExperiments = (experiments, profile) => {
   const experimentTraits = pickBy(profile.traits, (value, key) => key.startsWith(EXPERIENCE_TRAIT_PREFIX) && value === true);
   const experimentTraitsIds = Object.keys(experimentTraits).map(id => id.replace(EXPERIENCE_TRAIT_PREFIX, ''));
@@ -4045,6 +4067,10 @@ const selectActiveExperiments = (experiments, profile) => {
  * When going for an experiment we can only select a active experiment when 1 or more experiments are active
  * If the profile is not in any active experiments, we can select any expermiment
  */
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectEligibleExperiences = ({
   experiences,
   activeExperiments
@@ -4062,9 +4088,21 @@ const getRandom = text => {
   const random = normalize(hash, LOWER_BOUND, UPPER_BOUND);
   return random;
 };
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const getTrafficRandom = (profile, experience) => getRandom(`traffic-${experience.id}-${profile.id}`);
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const getDistributionRandom = (profile, experience) => getRandom(`distribution-${experience.id}-${profile.id}`);
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const isExperienceMatch = ({
   experience,
   activeExperiments,
@@ -4085,6 +4123,10 @@ const isExperienceMatch = ({
   hasActiveExperiment);
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectExperience = ({
   experiences,
   activeExperiments,
@@ -4102,6 +4144,10 @@ const selectExperience = ({
   return selectedExperience !== null && selectedExperience !== void 0 ? selectedExperience : null;
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectDistribution = ({
   experience,
   profile
@@ -4125,6 +4171,10 @@ const selectDistribution = ({
   return distribution;
 };
 
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 const selectVariant = ({
   baseline,
   experience,
@@ -4316,4 +4366,100 @@ const decodeExperienceVariantsMap = encodedExperienceVariantsMap => {
   }), {});
 };
 
-export { ANONYMOUS_ID, CONSENT, DEBUG_FLAG, EMPTY_MERGE_ID, EXPERIENCE_TRAIT_PREFIX, LEGACY_ANONYMOUS_ID, Ninetailed, PLUGIN_NAME, PROFILE_CHANGE, PROFILE_FALLBACK_CACHE, PROFILE_RESET, SET_ENABLED_FEATURES, decodeExperienceVariantsMap, isExperienceMatch, ninetailedPlugin, selectActiveExperiments, selectDistribution, selectEligibleExperiences, selectExperience, selectBaselineWithVariants as selectExperienceBaselineWithVariants, selectVariant as selectExperienceVariant, selectVariants as selectExperienceVariants, selectHasVariants as selectHasExperienceVariants, selectVariant$1 as selectVariant };
+class OnChangeEmitter {
+  constructor() {
+    this.onChangeListeners = [];
+  }
+  addListener(listener) {
+    this.onChangeListeners.push(listener);
+    return () => {
+      this.removeOnChangeListener(listener);
+    };
+  }
+  invokeListeners() {
+    this.onChangeListeners.forEach(listener => listener());
+  }
+  removeOnChangeListener(listener) {
+    this.onChangeListeners = this.onChangeListeners.filter(l => l !== listener);
+  }
+}
+
+const hasOnChangeEmitter = arg => {
+  return typeof arg === 'object' && arg !== null && 'onChangeEmitter' in arg && typeof arg.onChangeEmitter === 'object' && arg.onChangeEmitter !== null && arg.onChangeEmitter.constructor === OnChangeEmitter;
+};
+
+const selectPluginsHavingOnChangeEmitter = plugins => {
+  const filteredPlugins = [];
+  for (const plugin of plugins) {
+    if (hasOnChangeEmitter(plugin)) {
+      filteredPlugins.push(plugin);
+    }
+  }
+  return filteredPlugins;
+};
+
+const hasExperienceSelectionMiddleware = arg => {
+  return typeof arg === 'object' && arg !== null && 'getExperienceSelectionMiddleware' in arg && typeof arg.getExperienceSelectionMiddleware === 'function';
+};
+
+const selectPluginsHavingExperienceSelectionMiddleware = plugins => {
+  const filteredPlugins = [];
+  for (const plugin of plugins) {
+    if (hasExperienceSelectionMiddleware(plugin)) {
+      filteredPlugins.push(plugin);
+    }
+  }
+  return filteredPlugins;
+};
+
+const createPassThroughMiddleware = () => {
+  return ({
+    experience,
+    variant
+  }) => {
+    return {
+      experience,
+      variant
+    };
+  };
+};
+const makeExperienceSelectMiddleware = ({
+  plugins,
+  onChange,
+  experiences,
+  baseline,
+  profile
+}) => {
+  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
+    }));
+    return pipe(...middlewareFunctions);
+  };
+  const addListeners = () => {
+    removeChangeListeners = pluginsHavingChangeEmitters.map(plugin => {
+      const listener = () => {
+        onChange();
+      };
+      return plugin.onChangeEmitter.addListener(listener);
+    });
+  };
+  const removeListeners = () => {
+    removeChangeListeners.forEach(listener => listener());
+  };
+  const middleware = prepareMiddleware();
+  return {
+    addListeners,
+    removeListeners,
+    middleware
+  };
+};
+
+export { ANONYMOUS_ID, CONSENT, DEBUG_FLAG, EMPTY_MERGE_ID, EXPERIENCE_TRAIT_PREFIX, LEGACY_ANONYMOUS_ID, Ninetailed, NinetailedPlugin, OnChangeEmitter, PLUGIN_NAME, PROFILE_CHANGE, PROFILE_FALLBACK_CACHE, PROFILE_RESET, SET_ENABLED_FEATURES, decodeExperienceVariantsMap, isExperienceMatch, makeExperienceSelectMiddleware, ninetailedPlugin, selectActiveExperiments, selectDistribution, selectEligibleExperiences, selectExperience, selectBaselineWithVariants as selectExperienceBaselineWithVariants, selectVariant as selectExperienceVariant, selectVariants as selectExperienceVariants, selectHasVariants as selectHasExperienceVariants, selectPluginsHavingExperienceSelectionMiddleware, selectPluginsHavingOnChangeEmitter, selectVariant$1 as selectVariant };

package/lib/Ninetailed.d.ts

@@ -1,6 +1,6 @@
-import { AnalyticsPlugin } from 'analytics';
+/// <reference types="analytics" />
 import { Locale, Traits, Profile, OnLogHandler, OnErrorHandler, Logger, PageviewProperties, Properties, NinetailedApiClient, NinetailedApiClientOptions } from '@ninetailed/experience.js-shared';
-import { EventFunctionOptions, NinetailedInstance, OnIsInitializedCallback, OnProfileChangeCallback, ProfileState, TrackHasSeenComponent, TrackHasSeenExperience } from './types';
+import { EventFunctionOptions, NinetailedInstance, NinetailedPlugin, OnIsInitializedCallback, OnProfileChangeCallback, ProfileState, TrackHasSeenComponent, TrackHasSeenExperience } from './types';
 declare global {
     interface Window {
         ninetailed?: {
@@ -14,7 +14,7 @@ declare global {
 type Options = {
     url?: string;
     locale?: Locale;
-    plugins?: (AnalyticsPlugin | AnalyticsPlugin[])[];
+    plugins?: (NinetailedPlugin | NinetailedPlugin[])[];
     profile?: Profile;
     requestTimeout?: number;
     onLog?: OnLogHandler;
@@ -27,7 +27,7 @@ export declare class Ninetailed implements NinetailedInstance {
     private isInitialized;
     private readonly apiClient;
     private readonly eventQueue;
-    readonly plugins: AnalyticsPlugin[];
+    readonly plugins: NinetailedPlugin[];
     readonly logger: Logger;
     constructor(ninetailedApiClientInstanceOrOptions: NinetailedApiClientInstanceOrOptions, { plugins, url, profile, locale, requestTimeout, onLog, onError, }?: Options);
     page: (data?: Partial<PageviewProperties>, options?: EventFunctionOptions) => Promise<import("./types").FlushResult>;

package/lib/experience/constants.d.ts

@@ -1 +1,5 @@
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const EXPERIENCE_TRAIT_PREFIX = "nt_experiment_";

package/lib/experience/index.d.ts

@@ -10,3 +10,4 @@ export { selectVariant as selectExperienceVariant } from './selectVariant';
 export { isExperienceMatch } from './isExperienceMatch';
 export { selectDistribution } from './selectDistribution';
 export { decodeExperienceVariantsMap } from './decodeExperienceVariantsMap';
+export { makeExperienceSelectMiddleware } from './makeExperienceSelectMiddleware';

package/lib/experience/isExperienceMatch.d.ts

@@ -5,5 +5,9 @@ type IsExperienceMatchArgs = {
     activeExperiments: ExperienceConfiguration<any>[];
     profile: Profile;
 };
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const isExperienceMatch: ({ experience, activeExperiments, profile, }: IsExperienceMatchArgs) => boolean;
 export {};

package/lib/experience/makeExperienceSelectMiddleware.d.ts

@@ -0,0 +1,19 @@
+import { ExperienceConfiguration, Profile, Reference } from '@ninetailed/experience.js-shared';
+import { NinetailedPlugin } from '../types/NinetailedPlugin';
+import { ExperienceSelectionMiddlewareReturnArg } from '../types/interfaces/HasExperienceSelectionMiddleware';
+type MakeExperienceSelectMiddlewareArg = {
+    plugins: NinetailedPlugin[];
+    experiences: ExperienceConfiguration<Reference>[];
+    baseline: Reference;
+    profile: Profile | null;
+    onChange: () => void;
+};
+export declare const makeExperienceSelectMiddleware: ({ plugins, onChange, experiences, baseline, profile, }: MakeExperienceSelectMiddlewareArg) => {
+    addListeners: () => void;
+    removeListeners: () => void;
+    middleware: ({ experience, variant, }: ExperienceSelectionMiddlewareReturnArg<Reference>) => {
+        experience: ExperienceConfiguration<Reference> | null;
+        variant: Reference | null;
+    };
+};
+export {};

package/lib/experience/selectActiveExperiments.d.ts

@@ -1,3 +1,7 @@
 import { Profile } from '@ninetailed/experience.js-shared';
 import { ExperienceConfiguration, Reference } from './types';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const selectActiveExperiments: <Variant extends Reference>(experiments: ExperienceConfiguration<Variant>[], profile: Profile) => ExperienceConfiguration<Variant>[];

package/lib/experience/selectBaselineWithVariants.d.ts

@@ -1,2 +1,6 @@
 import { Baseline, BaselineWithVariants, ExperienceConfiguration, Reference } from './types';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const selectBaselineWithVariants: <Variant extends Reference>(experience: ExperienceConfiguration<Variant>, baseline: Baseline) => BaselineWithVariants<Variant> | null;

package/lib/experience/selectDistribution.d.ts

@@ -4,5 +4,9 @@ type SelectDistributionArgs<Variant extends Reference> = {
     experience: ExperienceConfiguration<Variant>;
     profile: Profile;
 };
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const selectDistribution: <Variant extends Reference>({ experience, profile, }: SelectDistributionArgs<Variant>) => Distribution;
 export {};

package/lib/experience/selectEligibleExperiences.d.ts

@@ -8,5 +8,9 @@ type SelectEligibleExperiencesArgs<Variant extends Reference> = {
  * When going for an experiment we can only select a active experiment when 1 or more experiments are active
  * If the profile is not in any active experiments, we can select any expermiment
  */
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const selectEligibleExperiences: <Variant extends Reference>({ experiences, activeExperiments, }: SelectEligibleExperiencesArgs<Variant>) => ExperienceConfiguration<Variant>[];
 export {};

package/lib/experience/selectExperience.d.ts

@@ -5,5 +5,9 @@ type SelectExprienceArgs<Variant extends Reference> = {
     activeExperiments: ExperienceConfiguration<Variant>[];
     profile: Profile;
 };
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const selectExperience: <Variant extends Reference>({ experiences, activeExperiments, profile, }: SelectExprienceArgs<Variant>) => ExperienceConfiguration<Variant> | null;
 export {};

package/lib/experience/selectHasVariants.d.ts

@@ -1,2 +1,6 @@
 import { Baseline, ExperienceConfiguration, Reference } from './types';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const selectHasVariants: <Variant extends Reference>(experience: ExperienceConfiguration<Variant>, baseline: Baseline) => boolean;

package/lib/experience/selectVariant.d.ts

@@ -5,5 +5,9 @@ type SelectVariantArgs<Variant extends Reference> = {
     experience: ExperienceConfiguration<Variant>;
     profile: Profile;
 };
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const selectVariant: <Variant extends Reference>({ baseline, experience, profile, }: SelectVariantArgs<Variant>) => Variant | VariantRef | null;
 export {};

package/lib/experience/selectVariants.d.ts

@@ -1,2 +1,6 @@
 import { Baseline, ExperienceConfiguration, Reference, VariantRef } from './types';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const selectVariants: <Variant extends Reference>(experience: ExperienceConfiguration<Variant>, baseline: Baseline) => (Variant | VariantRef)[];

package/lib/experience/types/Baseline.d.ts

@@ -1,2 +1,6 @@
 import { Reference } from './Reference';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export type Baseline<P = unknown> = P & Reference;

package/lib/experience/types/BaselineWithVariants.d.ts

@@ -1,6 +1,10 @@
 import { Baseline } from './Baseline';
 import { Reference } from './Reference';
 import { VariantRef } from './VariantRef';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export type BaselineWithVariants<Variant extends Reference> = {
     baseline: Baseline;
     variants: (Variant | VariantRef)[];

package/lib/experience/types/Distribution.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export type Distribution = {
     index: number;
     start: number;

package/lib/experience/types/ExperienceConfiguration.d.ts

@@ -1,7 +1,15 @@
 import { BaselineWithVariants } from './BaselineWithVariants';
 import { Distribution } from './Distribution';
 import { Reference } from './Reference';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export type ExperienceType = 'nt_personalization' | 'nt_experiment';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export type ExperienceConfiguration<Variant extends Reference = Reference> = {
     id: string;
     type: ExperienceType;

package/lib/experience/types/Reference.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export type Reference = {
     id: string;
 };

package/lib/experience/types/VariantRef.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export type VariantRef = {
     id: string;
     hidden: boolean;

package/lib/experience/utils.d.ts

@@ -1,4 +1,12 @@
 import { Profile } from '@ninetailed/experience.js-shared';
 import { ExperienceConfiguration } from './types';
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const getTrafficRandom: (profile: Profile, experience: ExperienceConfiguration<any>) => number;
+/**
+ * @deprecated use @ninetailed/experience.js-shared instead
+ * This wil get removed in the next major release
+ */
 export declare const getDistributionRandom: (profile: Profile, experience: ExperienceConfiguration<any>) => number;

package/lib/guards/hasExperienceSelectionMiddleware.d.ts

@@ -0,0 +1,3 @@
+import { Reference } from '@ninetailed/experience.js-shared';
+import { HasExperienceSelectionMiddleware } from '../types/interfaces/HasExperienceSelectionMiddleware';
+export declare const hasExperienceSelectionMiddleware: <Variant extends Reference>(arg: unknown) => arg is HasExperienceSelectionMiddleware<Variant>;

package/lib/guards/hasOnChangeEmitter.d.ts

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

package/lib/plugins/selectPluginsHavingExperienceSelectionMiddleware.d.ts

@@ -0,0 +1,4 @@
+import { Reference } from '@ninetailed/experience.js-shared';
+import { HasExperienceSelectionMiddleware } from '../types/interfaces/HasExperienceSelectionMiddleware';
+import { NinetailedPlugin } from '../types/NinetailedPlugin';
+export declare const selectPluginsHavingExperienceSelectionMiddleware: <Variant extends Reference>(plugins: NinetailedPlugin[]) => HasExperienceSelectionMiddleware<Variant>[];

package/lib/plugins/selectPluginsHavingOnChangeEmitter.d.ts

@@ -0,0 +1,3 @@
+import { NinetailedPlugin } from '../types/NinetailedPlugin';
+import { HasOnChangeEmitter } from '../types/interfaces/HasOnChangeEmitter';
+export declare const selectPluginsHavingOnChangeEmitter: (plugins: NinetailedPlugin[]) => HasOnChangeEmitter[];

package/lib/types/NinetailedPlugin.d.ts

@@ -0,0 +1,5 @@
+import { AnalyticsPlugin } from 'analytics';
+export declare abstract class NinetailedPlugin implements AnalyticsPlugin {
+    [x: string]: unknown;
+    abstract readonly name: string;
+}

package/lib/{types.d.ts → types/index.d.ts}

@@ -1,6 +1,7 @@
 import { TrackComponentProperties, TrackExperienceProperties } from '@ninetailed/experience.js-plugin-analytics';
 import { Logger, PageviewProperties, Profile, Properties, Traits } from '@ninetailed/experience.js-shared';
-import { AnalyticsPlugin, DetachListeners } from 'analytics';
+import { DetachListeners } from 'analytics';
+import { NinetailedPlugin } from './NinetailedPlugin';
 type Loading = {
     status: 'loading';
     profile: null;
@@ -49,8 +50,8 @@ export interface NinetailedInstance {
     debug: Debug;
     profileState: ProfileState;
     onProfileChange: OnProfileChange;
-    plugins: AnalyticsPlugin[];
+    plugins: NinetailedPlugin[];
     logger: Logger;
     onIsInitialized: OnIsInitialized;
 }
-export {};
+export { NinetailedPlugin };

package/lib/types/interfaces/HasExperienceSelectionMiddleware.d.ts

@@ -0,0 +1,15 @@
+import { ExperienceConfiguration, Reference } from '@ninetailed/experience.js-shared';
+export type ExperienceSelectionMiddlewareReturnArg<Variant extends Reference> = {
+    experience: ExperienceConfiguration<Variant> | null;
+    variant: Variant | null;
+};
+type ExperienceSelectionMiddlewareReturn<Variant extends Reference> = (arg: ExperienceSelectionMiddlewareReturnArg<Variant>) => ExperienceSelectionMiddlewareReturnArg<Variant>;
+type ExperienceSelectionMiddlewareArg<Variant extends Reference> = {
+    experiences: ExperienceConfiguration<Variant>[];
+    baseline: Reference;
+};
+export type ExperienceSelectionMiddleware<Variant extends Reference> = (arg: ExperienceSelectionMiddlewareArg<Variant>) => ExperienceSelectionMiddlewareReturn<Variant>;
+export interface HasExperienceSelectionMiddleware<Variant extends Reference> {
+    getExperienceSelectionMiddleware: ExperienceSelectionMiddleware<Variant>;
+}
+export {};

package/lib/types/interfaces/HasOnChangeEmitter.d.ts

@@ -0,0 +1,4 @@
+import { OnChangeEmitter } from '../../utils/OnChangeEmitter';
+export interface HasOnChangeEmitter {
+    onChangeEmitter: OnChangeEmitter;
+}

package/lib/utils/OnChangeEmitter.d.ts

@@ -0,0 +1,8 @@
+export type OnChangeListener = () => void;
+export type RemoveOnChangeListener = () => void;
+export declare class OnChangeEmitter {
+    private onChangeListeners;
+    addListener(listener: OnChangeListener): RemoveOnChangeListener;
+    invokeListeners(): void;
+    private removeOnChangeListener;
+}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@ninetailed/experience.js",
-  "version": "4.1.0-beta.0",
+  "version": "4.1.0-beta.1",
   "module": "./index.js",
   "main": "./index.cjs",
   "type": "module",
   "types": "./index.d.ts",
   "dependencies": {
-    "@ninetailed/experience.js-shared": "4.1.0-beta.0",
+    "@ninetailed/experience.js-shared": "4.1.0-beta.1",
     "analytics": "0.8.1",
     "lodash": "4.17.21",
     "murmurhash-js": "1.0.0",
-    "@ninetailed/experience.js-plugin-analytics": "4.1.0-beta.0"
+    "@ninetailed/experience.js-plugin-analytics": "4.1.0-beta.1"
   },
   "peerDependencies": {}
 }