@uniformdev/context 20.3.1-alpha.7 → 20.4.1-alpha.15

package/dist/api/api.d.mts

@@ -1,4 +1,4 @@
-import { aD as paths$7, N as ManifestV2 } from '../types-gu4PVkDD.mjs';
+import { aH as paths$7, _ as ManifestV2 } from '../types-BPchcX4k.mjs';
 import 'mitt';
 
 type LimitPolicy = <ReturnValue>(func: () => Promise<ReturnValue>) => Promise<ReturnValue>;

package/dist/api/api.d.ts

@@ -1,4 +1,4 @@
-import { aD as paths$7, N as ManifestV2 } from '../types-gu4PVkDD.js';
+import { aH as paths$7, _ as ManifestV2 } from '../types-BPchcX4k.js';
 import 'mitt';
 
 type LimitPolicy = <ReturnValue>(func: () => Promise<ReturnValue>) => Promise<ReturnValue>;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, g as DevToolsEvents } from './types-gu4PVkDD.mjs';
-export { $ as AggregateDimensionInput, a6 as BehaviorTag, h as CONTEXTUAL_EDITING_TEST_NAME, i as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, n as Context, l as ContextEvents, m as ContextInstance, j as ContextOptions, aA as ContextState, aB as ContextStateUpdate, J as CriteriaEvaluatorParameters, I as CriteriaEvaluatorResult, ap as DecayOptions, q as DevToolsActions, t as DevToolsDataEvent, r as DevToolsEvent, x as DevToolsForgetEvent, u as DevToolsHelloEvent, s as DevToolsLogEvent, w as DevToolsRawCommandsEvent, p as DevToolsState, o as DevToolsUiVersion, v as DevToolsUpdateEvent, a2 as DimensionMatch, Y as EnrichmentCategory, av as EnrichmentData, ay as EventData, aC as GoalStateUpdate, au as Goals, H as GroupCriteriaEvaluator, ai as IdentifyCommand, F as LogMessageGroup, E as LogMessageSingle, y as LogMessages, G as ManifestInstance, N as ManifestV2, M as MessageCategory, B as MessageFunc, ad as ModifyScoreCommand, ae as ModifySessionScoreCommand, Z as NumberMatch, P as PersonalizationEvent, R as PersonalizationManifest, aw as PersonalizeControlVariant, a4 as PersonalizeOptions, ax as PersonalizeVariants, a8 as PersonalizedResult, a7 as PersonalizedVariant, a3 as QuirkMatch, an as SERVER_STATE_ID, am as ServerToClientTransitionState, af as SetConsentCommand, aj as SetControlGroupCommand, ac as SetGoalCommand, ak as SetPersonalizeVariantControlCommand, ag as SetQuirkCommand, ah as SetTestCommand, z as Severity, U as Signal, X as SignalCriteria, W as SignalCriteriaGroup, K as SignalData, ab as StorageCommand, _ as TestDefinition, k as TestEvent, a0 as TestOptions, aa as TestResult, a9 as TestVariant, at as Tests, ao as TransitionDataStoreEvents, as as VisitorDataStore, ar as VisitorDataStoreEvents, aq as VisitorDataStoreOptions, al as areCommandsEqual, az as emptyVisitorData, a5 as personalizeVariations, a1 as testVariations } from './types-gu4PVkDD.mjs';
+import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, P as PersonalizedVariant, g as PersonalizeOptions, h as Context, i as PersonalizedResult, j as PersonalizationSelectionAlgorithmOptions, k as DevToolsEvents } from './types-BPchcX4k.mjs';
+export { a6 as AggregateDimensionInput, ac as BehaviorTag, l as CONTEXTUAL_EDITING_TEST_NAME, m as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, t as ContextEvents, u as ContextInstance, p as ContextOptions, aE as ContextState, aF as ContextStateUpdate, Y as CriteriaEvaluatorParameters, X as CriteriaEvaluatorResult, at as DecayOptions, x as DevToolsActions, B as DevToolsDataEvent, y as DevToolsEvent, H as DevToolsForgetEvent, E as DevToolsHelloEvent, z as DevToolsLogEvent, G as DevToolsRawCommandsEvent, w as DevToolsState, v as DevToolsUiVersion, F as DevToolsUpdateEvent, aa as DimensionMatch, a3 as EnrichmentCategory, az as EnrichmentData, aC as EventData, aG as GoalStateUpdate, ay as Goals, W as GroupCriteriaEvaluator, am as IdentifyCommand, R as LogMessageGroup, N as LogMessageSingle, I as LogMessages, U as ManifestInstance, _ as ManifestV2, M as MessageCategory, K as MessageFunc, ah as ModifyScoreCommand, ai as ModifySessionScoreCommand, a4 as NumberMatch, r as PersonalizationEvent, q as PersonalizationEventVariantId, $ as PersonalizationManifest, n as PersonalizationSelectionAlgorithm, o as PersonalizationSelectionAlgorithms, aA as PersonalizeControlVariant, aB as PersonalizeVariants, ab as QuirkMatch, ar as SERVER_STATE_ID, aq as ServerToClientTransitionState, aj as SetConsentCommand, an as SetControlGroupCommand, ag as SetGoalCommand, ao as SetPersonalizeVariantControlCommand, ak as SetQuirkCommand, al as SetTestCommand, J as Severity, a0 as Signal, a2 as SignalCriteria, a1 as SignalCriteriaGroup, Z as SignalData, af as StorageCommand, a5 as TestDefinition, s as TestEvent, a7 as TestOptions, ae as TestResult, ad as TestVariant, ax as Tests, as as TransitionDataStoreEvents, a9 as VariantMatchMetadata, aw as VisitorDataStore, av as VisitorDataStoreEvents, au as VisitorDataStoreOptions, ap as areCommandsEqual, aD as emptyVisitorData, a8 as testVariations } from './types-BPchcX4k.mjs';
 import Cookies from 'js-cookie';
 import 'mitt';
 
@@ -160,6 +160,21 @@ declare function enableDebugConsoleLogDrain(level: OutputSeverity, options?: Con
 
 declare function evaluateVariantMatch(variantId: string, match: VariantMatchCriteria | undefined | null, vec: ScoreVector, onLogMessage?: (message: LogMessage) => void, quirks?: Quirks): boolean;
 
+/**
+ * @deprecated Use `topDownCriteriaPersonalizationSelectionAlgorithm` instead
+ */
+declare function personalizeVariations<TVariant extends PersonalizedVariant<VariantMatchCriteria>>(options: PersonalizeOptions<TVariant> & {
+    context: Context;
+}): PersonalizedResult<TVariant>;
+
+/**
+ * Implementation of the top-down criteria personalization selection algorithm.
+ *
+ * In this mode, we evaluate variations in the order they are declared and the first <take>
+ * variations whose criteria evaluate to true are selected.
+ */
+declare function topDownCriteriaPersonalizationSelectionAlgorithm<TCriteria extends VariantMatchCriteria, TVariation extends PersonalizedVariant<TCriteria>>({ name, context, variations, take, onLogMessage, }: PersonalizationSelectionAlgorithmOptions<TCriteria, TVariation>): PersonalizedResult<TVariation>;
+
 type ContextDevToolOptions = {
     onAfterMessageReceived?: (message: DevToolsEvents) => void;
 };
@@ -183,6 +198,7 @@ declare enum ScriptType {
 type EdgePersonalizeComponentOptions = {
     name: string;
     count?: number;
+    algorithm?: string;
 };
 type EdgeTestComponentOptions = {
     name: string;
@@ -213,4 +229,4 @@ type QuickConnectConfig = {
 declare function serializeQuickConnect(config: QuickConnectConfig): string;
 declare function parseQuickConnect(serialized: string): Required<QuickConnectConfig>;
 
-export { AggregateDimension, type ConsoleDebugLogDrainOptions, type ContextDevToolOptions, ContextPlugin, CookieTransitionDataStore, type CookieTransitionDataStoreOptions, CriteriaEvaluator, DecayFunction, DevToolsEvents, ENR_SEPARATOR, EdgeNodeTagName, type EdgePersonalizeComponentOptions, type EdgeTestComponentOptions, EdgeTransitionDataStore, type EdgeTransitionDataStoreOptions, type EnableUniformInsightsOptions, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, QUIRK_SEP, type QuickConnectConfig, Quirks, ScoreVector, ScriptType, StorageCommands, StringMatch, TYPE_SEP, TransitionDataStore, TransitionDataStoreOptions, UNIFORM_DEFAULT_COOKIE_NAME, UNIFORM_DEFAULT_QUIRK_COOKIE_NAME, VariantMatchCriteria, VisitorData, computeAggregateDimensions, cookieEvaluator, createConsoleLogDrain, createDebugConsoleLogDrain, createLinearDecay, currentPageEvaluator, decodeCookieType, decodePersonalizeVariants, enableConsoleLogDrain, enableContextDevTools, enableDebugConsoleLogDrain, enableUniformInsights, encodeCookieType, evaluateVariantMatch, eventEvaluator, explainStringMatch, explainStringMatchCriteria, getEnrichmentVectorKey, isStringMatch, pageViewCountDimension, pageViewCountEvaluator, parseCookieScores, parseCookieType, parseQuickConnect, parseQuirkCookie, parseScoreCookie, queryStringEvaluator, quirkEvaluator, serializeCookie, serializeCookieType, serializePersonalizeVariants, serializeQuickConnect, serializeQuirks };
+export { AggregateDimension, type ConsoleDebugLogDrainOptions, Context, type ContextDevToolOptions, ContextPlugin, CookieTransitionDataStore, type CookieTransitionDataStoreOptions, CriteriaEvaluator, DecayFunction, DevToolsEvents, ENR_SEPARATOR, EdgeNodeTagName, type EdgePersonalizeComponentOptions, type EdgeTestComponentOptions, EdgeTransitionDataStore, type EdgeTransitionDataStoreOptions, type EnableUniformInsightsOptions, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, PersonalizationSelectionAlgorithmOptions, PersonalizeOptions, PersonalizedResult, PersonalizedVariant, QUIRK_SEP, type QuickConnectConfig, Quirks, ScoreVector, ScriptType, StorageCommands, StringMatch, TYPE_SEP, TransitionDataStore, TransitionDataStoreOptions, UNIFORM_DEFAULT_COOKIE_NAME, UNIFORM_DEFAULT_QUIRK_COOKIE_NAME, VariantMatchCriteria, VisitorData, computeAggregateDimensions, cookieEvaluator, createConsoleLogDrain, createDebugConsoleLogDrain, createLinearDecay, currentPageEvaluator, decodeCookieType, decodePersonalizeVariants, enableConsoleLogDrain, enableContextDevTools, enableDebugConsoleLogDrain, enableUniformInsights, encodeCookieType, evaluateVariantMatch, eventEvaluator, explainStringMatch, explainStringMatchCriteria, getEnrichmentVectorKey, isStringMatch, pageViewCountDimension, pageViewCountEvaluator, parseCookieScores, parseCookieType, parseQuickConnect, parseQuirkCookie, parseScoreCookie, personalizeVariations, queryStringEvaluator, quirkEvaluator, serializeCookie, serializeCookieType, serializePersonalizeVariants, serializeQuickConnect, serializeQuirks, topDownCriteriaPersonalizationSelectionAlgorithm };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, g as DevToolsEvents } from './types-gu4PVkDD.js';
-export { $ as AggregateDimensionInput, a6 as BehaviorTag, h as CONTEXTUAL_EDITING_TEST_NAME, i as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, n as Context, l as ContextEvents, m as ContextInstance, j as ContextOptions, aA as ContextState, aB as ContextStateUpdate, J as CriteriaEvaluatorParameters, I as CriteriaEvaluatorResult, ap as DecayOptions, q as DevToolsActions, t as DevToolsDataEvent, r as DevToolsEvent, x as DevToolsForgetEvent, u as DevToolsHelloEvent, s as DevToolsLogEvent, w as DevToolsRawCommandsEvent, p as DevToolsState, o as DevToolsUiVersion, v as DevToolsUpdateEvent, a2 as DimensionMatch, Y as EnrichmentCategory, av as EnrichmentData, ay as EventData, aC as GoalStateUpdate, au as Goals, H as GroupCriteriaEvaluator, ai as IdentifyCommand, F as LogMessageGroup, E as LogMessageSingle, y as LogMessages, G as ManifestInstance, N as ManifestV2, M as MessageCategory, B as MessageFunc, ad as ModifyScoreCommand, ae as ModifySessionScoreCommand, Z as NumberMatch, P as PersonalizationEvent, R as PersonalizationManifest, aw as PersonalizeControlVariant, a4 as PersonalizeOptions, ax as PersonalizeVariants, a8 as PersonalizedResult, a7 as PersonalizedVariant, a3 as QuirkMatch, an as SERVER_STATE_ID, am as ServerToClientTransitionState, af as SetConsentCommand, aj as SetControlGroupCommand, ac as SetGoalCommand, ak as SetPersonalizeVariantControlCommand, ag as SetQuirkCommand, ah as SetTestCommand, z as Severity, U as Signal, X as SignalCriteria, W as SignalCriteriaGroup, K as SignalData, ab as StorageCommand, _ as TestDefinition, k as TestEvent, a0 as TestOptions, aa as TestResult, a9 as TestVariant, at as Tests, ao as TransitionDataStoreEvents, as as VisitorDataStore, ar as VisitorDataStoreEvents, aq as VisitorDataStoreOptions, al as areCommandsEqual, az as emptyVisitorData, a5 as personalizeVariations, a1 as testVariations } from './types-gu4PVkDD.js';
+import { O as OutputSeverity, L as LogDrain, C as ContextPlugin, S as ScoreVector, A as AggregateDimension, T as TransitionDataStore, a as StorageCommands, V as VisitorData, Q as Quirks, b as TransitionDataStoreOptions, D as DecayFunction, c as CriteriaEvaluator, d as StringMatch, e as VariantMatchCriteria, f as LogMessage, P as PersonalizedVariant, g as PersonalizeOptions, h as Context, i as PersonalizedResult, j as PersonalizationSelectionAlgorithmOptions, k as DevToolsEvents } from './types-BPchcX4k.js';
+export { a6 as AggregateDimensionInput, ac as BehaviorTag, l as CONTEXTUAL_EDITING_TEST_NAME, m as CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID, t as ContextEvents, u as ContextInstance, p as ContextOptions, aE as ContextState, aF as ContextStateUpdate, Y as CriteriaEvaluatorParameters, X as CriteriaEvaluatorResult, at as DecayOptions, x as DevToolsActions, B as DevToolsDataEvent, y as DevToolsEvent, H as DevToolsForgetEvent, E as DevToolsHelloEvent, z as DevToolsLogEvent, G as DevToolsRawCommandsEvent, w as DevToolsState, v as DevToolsUiVersion, F as DevToolsUpdateEvent, aa as DimensionMatch, a3 as EnrichmentCategory, az as EnrichmentData, aC as EventData, aG as GoalStateUpdate, ay as Goals, W as GroupCriteriaEvaluator, am as IdentifyCommand, R as LogMessageGroup, N as LogMessageSingle, I as LogMessages, U as ManifestInstance, _ as ManifestV2, M as MessageCategory, K as MessageFunc, ah as ModifyScoreCommand, ai as ModifySessionScoreCommand, a4 as NumberMatch, r as PersonalizationEvent, q as PersonalizationEventVariantId, $ as PersonalizationManifest, n as PersonalizationSelectionAlgorithm, o as PersonalizationSelectionAlgorithms, aA as PersonalizeControlVariant, aB as PersonalizeVariants, ab as QuirkMatch, ar as SERVER_STATE_ID, aq as ServerToClientTransitionState, aj as SetConsentCommand, an as SetControlGroupCommand, ag as SetGoalCommand, ao as SetPersonalizeVariantControlCommand, ak as SetQuirkCommand, al as SetTestCommand, J as Severity, a0 as Signal, a2 as SignalCriteria, a1 as SignalCriteriaGroup, Z as SignalData, af as StorageCommand, a5 as TestDefinition, s as TestEvent, a7 as TestOptions, ae as TestResult, ad as TestVariant, ax as Tests, as as TransitionDataStoreEvents, a9 as VariantMatchMetadata, aw as VisitorDataStore, av as VisitorDataStoreEvents, au as VisitorDataStoreOptions, ap as areCommandsEqual, aD as emptyVisitorData, a8 as testVariations } from './types-BPchcX4k.js';
 import Cookies from 'js-cookie';
 import 'mitt';
 
@@ -160,6 +160,21 @@ declare function enableDebugConsoleLogDrain(level: OutputSeverity, options?: Con
 
 declare function evaluateVariantMatch(variantId: string, match: VariantMatchCriteria | undefined | null, vec: ScoreVector, onLogMessage?: (message: LogMessage) => void, quirks?: Quirks): boolean;
 
+/**
+ * @deprecated Use `topDownCriteriaPersonalizationSelectionAlgorithm` instead
+ */
+declare function personalizeVariations<TVariant extends PersonalizedVariant<VariantMatchCriteria>>(options: PersonalizeOptions<TVariant> & {
+    context: Context;
+}): PersonalizedResult<TVariant>;
+
+/**
+ * Implementation of the top-down criteria personalization selection algorithm.
+ *
+ * In this mode, we evaluate variations in the order they are declared and the first <take>
+ * variations whose criteria evaluate to true are selected.
+ */
+declare function topDownCriteriaPersonalizationSelectionAlgorithm<TCriteria extends VariantMatchCriteria, TVariation extends PersonalizedVariant<TCriteria>>({ name, context, variations, take, onLogMessage, }: PersonalizationSelectionAlgorithmOptions<TCriteria, TVariation>): PersonalizedResult<TVariation>;
+
 type ContextDevToolOptions = {
     onAfterMessageReceived?: (message: DevToolsEvents) => void;
 };
@@ -183,6 +198,7 @@ declare enum ScriptType {
 type EdgePersonalizeComponentOptions = {
     name: string;
     count?: number;
+    algorithm?: string;
 };
 type EdgeTestComponentOptions = {
     name: string;
@@ -213,4 +229,4 @@ type QuickConnectConfig = {
 declare function serializeQuickConnect(config: QuickConnectConfig): string;
 declare function parseQuickConnect(serialized: string): Required<QuickConnectConfig>;
 
-export { AggregateDimension, type ConsoleDebugLogDrainOptions, type ContextDevToolOptions, ContextPlugin, CookieTransitionDataStore, type CookieTransitionDataStoreOptions, CriteriaEvaluator, DecayFunction, DevToolsEvents, ENR_SEPARATOR, EdgeNodeTagName, type EdgePersonalizeComponentOptions, type EdgeTestComponentOptions, EdgeTransitionDataStore, type EdgeTransitionDataStoreOptions, type EnableUniformInsightsOptions, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, QUIRK_SEP, type QuickConnectConfig, Quirks, ScoreVector, ScriptType, StorageCommands, StringMatch, TYPE_SEP, TransitionDataStore, TransitionDataStoreOptions, UNIFORM_DEFAULT_COOKIE_NAME, UNIFORM_DEFAULT_QUIRK_COOKIE_NAME, VariantMatchCriteria, VisitorData, computeAggregateDimensions, cookieEvaluator, createConsoleLogDrain, createDebugConsoleLogDrain, createLinearDecay, currentPageEvaluator, decodeCookieType, decodePersonalizeVariants, enableConsoleLogDrain, enableContextDevTools, enableDebugConsoleLogDrain, enableUniformInsights, encodeCookieType, evaluateVariantMatch, eventEvaluator, explainStringMatch, explainStringMatchCriteria, getEnrichmentVectorKey, isStringMatch, pageViewCountDimension, pageViewCountEvaluator, parseCookieScores, parseCookieType, parseQuickConnect, parseQuirkCookie, parseScoreCookie, queryStringEvaluator, quirkEvaluator, serializeCookie, serializeCookieType, serializePersonalizeVariants, serializeQuickConnect, serializeQuirks };
+export { AggregateDimension, type ConsoleDebugLogDrainOptions, Context, type ContextDevToolOptions, ContextPlugin, CookieTransitionDataStore, type CookieTransitionDataStoreOptions, CriteriaEvaluator, DecayFunction, DevToolsEvents, ENR_SEPARATOR, EdgeNodeTagName, type EdgePersonalizeComponentOptions, type EdgeTestComponentOptions, EdgeTransitionDataStore, type EdgeTransitionDataStoreOptions, type EnableUniformInsightsOptions, KV_SEP, type LinearDecayOptions, LogDrain, LogMessage, OutputSeverity, PAIR_SEP, PersonalizationSelectionAlgorithmOptions, PersonalizeOptions, PersonalizedResult, PersonalizedVariant, QUIRK_SEP, type QuickConnectConfig, Quirks, ScoreVector, ScriptType, StorageCommands, StringMatch, TYPE_SEP, TransitionDataStore, TransitionDataStoreOptions, UNIFORM_DEFAULT_COOKIE_NAME, UNIFORM_DEFAULT_QUIRK_COOKIE_NAME, VariantMatchCriteria, VisitorData, computeAggregateDimensions, cookieEvaluator, createConsoleLogDrain, createDebugConsoleLogDrain, createLinearDecay, currentPageEvaluator, decodeCookieType, decodePersonalizeVariants, enableConsoleLogDrain, enableContextDevTools, enableDebugConsoleLogDrain, enableUniformInsights, encodeCookieType, evaluateVariantMatch, eventEvaluator, explainStringMatch, explainStringMatchCriteria, getEnrichmentVectorKey, isStringMatch, pageViewCountDimension, pageViewCountEvaluator, parseCookieScores, parseCookieType, parseQuickConnect, parseQuirkCookie, parseScoreCookie, personalizeVariations, queryStringEvaluator, quirkEvaluator, serializeCookie, serializeCookieType, serializePersonalizeVariants, serializeQuickConnect, serializeQuirks, topDownCriteriaPersonalizationSelectionAlgorithm };

package/dist/index.esm.js

@@ -633,7 +633,15 @@ function evaluateDimensionMatch(crit, vec, onLogMessage) {
     explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else {
-    throw new Error(`Unknown op: ${op}`);
+    onLogMessage == null ? void 0 : onLogMessage([
+      "error",
+      302,
+      {
+        matched: false,
+        description: `${crit.l} ${crit.op} ${crit.rDim ? `${crit.rDim}` : crit.r}: Unknown op ${crit.op}.`
+      }
+    ]);
+    return false;
   }
 }
 function evaluateQuirkMatch(crit, quirks, onLogMessage) {
@@ -649,7 +657,15 @@ function evaluateQuirkMatch(crit, quirks, onLogMessage) {
     explainQuirk(onLogMessage, result, crit, targetQuirkValue);
     return result;
   } else {
-    throw new Error(`Unknown quirk op: ${op}`);
+    onLogMessage == null ? void 0 : onLogMessage([
+      "error",
+      302,
+      {
+        matched: false,
+        description: `Quirk ${crit.l} ${crit.op} ${crit.r}: Unknown quirk op ${crit.op}.`
+      }
+    ]);
+    return false;
   }
 }
 function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
@@ -673,8 +689,8 @@ function explainQuirk(onLogMessage, result, crit, lhs) {
   ]);
 }
 
-// src/placement/personalizeVariations.ts
-function personalizeVariations({
+// src/placement/topDownCriteriaPersonalizationSelectionAlgorithm.ts
+function topDownCriteriaPersonalizationSelectionAlgorithm({
   name,
   context,
   variations,
@@ -689,12 +705,19 @@ function personalizeVariations({
     const needsConsent = context.requireConsentForPersonalization;
     const canEvaluate = !needsConsent || context.storage.data.consent;
     for (const variant of variations) {
-      if ((_a = variant.pz) == null ? void 0 : _a.crit.length) {
-        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage, context.quirks)) {
-          variantMatches.push(variant);
+      const isInvalidFormat = variant.pz && (typeof variant.pz !== "object" || variant.pz === null || !("crit" in variant.pz && Array.isArray(variant.pz.crit)));
+      let validVariant;
+      if (isInvalidFormat) {
+        validVariant = { id: variant.id };
+      } else {
+        validVariant = variant;
+      }
+      if ((_a = validVariant.pz) == null ? void 0 : _a.crit.length) {
+        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, validVariant.pz, context.scores, onLogMessage, context.quirks)) {
+          variantMatches.push(validVariant);
         }
       } else {
-        defaultVariants.push(variant);
+        defaultVariants.push(validVariant);
       }
     }
     const result = [];
@@ -749,6 +772,11 @@ function personalizeVariations({
   }
 }
 
+// src/placement/personalizeVariations.ts
+function personalizeVariations(options) {
+  return topDownCriteriaPersonalizationSelectionAlgorithm(options);
+}
+
 // src/placement/normalizeVariationDistributions.ts
 var normalizeVariationDistributions = (variations) => {
   const { values, total, missingDistribution } = variations.reduce(
@@ -768,7 +796,12 @@ var normalizeVariationDistributions = (variations) => {
     }
   );
   if (total > 100) {
-    throw new Error(`Total distribution ${total} is over the maximum 100.`);
+    const autoScaleFactor = 100 / total;
+    values.forEach((value, index) => {
+      if (typeof value === "number") {
+        values[index] = value * autoScaleFactor;
+      }
+    });
   } else if (total < 100) {
     const remainder = 100 - total;
     const missingSlice = remainder / missingDistribution;
@@ -1548,11 +1581,12 @@ import { dequal as dequal5 } from "dequal/lite";
 import mitt3 from "mitt";
 var CONTEXTUAL_EDITING_TEST_NAME = "contextual_editing_test";
 var CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID = "contextual_editing_test_selected_variant";
-var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
+var _personalizationSelectionAlgorithms, _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
 var Context = class {
   constructor(options) {
     __privateAdd(this, _Context_instances);
     __publicField(this, "manifest");
+    __privateAdd(this, _personalizationSelectionAlgorithms);
     __privateAdd(this, _serverTransitionState);
     __privateAdd(this, _scores, {});
     __privateAdd(this, _state);
@@ -1569,7 +1603,7 @@ var Context = class {
       off: __privateGet(this, _mitt3).off
     });
     __publicField(this, "storage");
-    var _a, _b;
+    var _a, _b, _c;
     const { manifest, ...storageOptions } = options;
     __privateSet(this, _state, {});
     __privateSet(this, _plugins, options.plugins);
@@ -1577,7 +1611,17 @@ var Context = class {
     if (typeof options.transitionStore !== "undefined") {
       __privateSet(this, _commands, []);
     }
+    __privateSet(this, _personalizationSelectionAlgorithms, { default: topDownCriteriaPersonalizationSelectionAlgorithm });
     (_a = __privateGet(this, _plugins)) == null ? void 0 : _a.forEach((plugin) => {
+      if (!plugin.personalizationSelectionAlgorithms) {
+        return;
+      }
+      __privateSet(this, _personalizationSelectionAlgorithms, {
+        ...__privateGet(this, _personalizationSelectionAlgorithms),
+        ...plugin.personalizationSelectionAlgorithms
+      });
+    });
+    (_b = __privateGet(this, _plugins)) == null ? void 0 : _b.forEach((plugin) => {
       if (!plugin.logDrain) {
         return;
       }
@@ -1628,7 +1672,7 @@ var Context = class {
         __privateGet(this, _mitt3).emit("quirksUpdated", quirks.quirks);
         __privateGet(this, _mitt3).emit("log", ["info", 4, quirks.quirks]);
       });
-      (_b = __privateGet(this, _plugins)) == null ? void 0 : _b.forEach((plugin) => {
+      (_c = __privateGet(this, _plugins)) == null ? void 0 : _c.forEach((plugin) => {
         if (!plugin.init) {
           return;
         }
@@ -1878,7 +1922,17 @@ var Context = class {
   }
   /** Executes a personalized placement with a given set of variants */
   personalize(options) {
-    const value = personalizeVariations({
+    var _a;
+    const algorithmName = (_a = options.algorithm) != null ? _a : "default";
+    const algorithm = __privateGet(this, _personalizationSelectionAlgorithms)[algorithmName];
+    if (!algorithm) {
+      __privateGet(this, _mitt3).emit("log", ["warn", 304, { algorithm: algorithmName }]);
+      return {
+        personalized: false,
+        variations: []
+      };
+    }
+    const value = algorithm({
       ...options,
       context: this,
       onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message)
@@ -1952,6 +2006,7 @@ var Context = class {
     __privateGet(this, _mitt3).emit("personalizationResult", event);
   }
 };
+_personalizationSelectionAlgorithms = new WeakMap();
 _serverTransitionState = new WeakMap();
 _scores = new WeakMap();
 _state = new WeakMap();
@@ -2547,6 +2602,10 @@ var messageContent = {
   301: ({ id, op }) => ["personalization", `testing variation ${id} (${op === "|" ? "OR" : "AND"})`],
   302: ({ matched, description }) => ["personalization", `${description} is ${matched}`],
   303: (selected) => ["personalization", selected ? "selected variation" : "did not select variation"],
+  304: ({ algorithm }) => [
+    "personalization",
+    `personalization selection algorithm '${algorithm}' not found. Hiding placement.`
+  ],
   // TESTING
   400: (name) => ["testing", `executing A/B test '${name}'`],
   401: (testName) => ["testing", `${testName} is not registered in the manifest; it will not be run.`],
@@ -2693,5 +2752,6 @@ export {
   serializePersonalizeVariants,
   serializeQuickConnect,
   serializeQuirks,
-  testVariations
+  testVariations,
+  topDownCriteriaPersonalizationSelectionAlgorithm
 };

package/dist/index.js

@@ -95,7 +95,8 @@ __export(src_exports, {
   serializePersonalizeVariants: () => serializePersonalizeVariants,
   serializeQuickConnect: () => serializeQuickConnect,
   serializeQuirks: () => serializeQuirks,
-  testVariations: () => testVariations
+  testVariations: () => testVariations,
+  topDownCriteriaPersonalizationSelectionAlgorithm: () => topDownCriteriaPersonalizationSelectionAlgorithm
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -722,7 +723,15 @@ function evaluateDimensionMatch(crit, vec, onLogMessage) {
     explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else {
-    throw new Error(`Unknown op: ${op}`);
+    onLogMessage == null ? void 0 : onLogMessage([
+      "error",
+      302,
+      {
+        matched: false,
+        description: `${crit.l} ${crit.op} ${crit.rDim ? `${crit.rDim}` : crit.r}: Unknown op ${crit.op}.`
+      }
+    ]);
+    return false;
   }
 }
 function evaluateQuirkMatch(crit, quirks, onLogMessage) {
@@ -738,7 +747,15 @@ function evaluateQuirkMatch(crit, quirks, onLogMessage) {
     explainQuirk(onLogMessage, result, crit, targetQuirkValue);
     return result;
   } else {
-    throw new Error(`Unknown quirk op: ${op}`);
+    onLogMessage == null ? void 0 : onLogMessage([
+      "error",
+      302,
+      {
+        matched: false,
+        description: `Quirk ${crit.l} ${crit.op} ${crit.r}: Unknown quirk op ${crit.op}.`
+      }
+    ]);
+    return false;
   }
 }
 function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
@@ -762,8 +779,8 @@ function explainQuirk(onLogMessage, result, crit, lhs) {
   ]);
 }
 
-// src/placement/personalizeVariations.ts
-function personalizeVariations({
+// src/placement/topDownCriteriaPersonalizationSelectionAlgorithm.ts
+function topDownCriteriaPersonalizationSelectionAlgorithm({
   name,
   context,
   variations,
@@ -778,12 +795,19 @@ function personalizeVariations({
     const needsConsent = context.requireConsentForPersonalization;
     const canEvaluate = !needsConsent || context.storage.data.consent;
     for (const variant of variations) {
-      if ((_a = variant.pz) == null ? void 0 : _a.crit.length) {
-        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage, context.quirks)) {
-          variantMatches.push(variant);
+      const isInvalidFormat = variant.pz && (typeof variant.pz !== "object" || variant.pz === null || !("crit" in variant.pz && Array.isArray(variant.pz.crit)));
+      let validVariant;
+      if (isInvalidFormat) {
+        validVariant = { id: variant.id };
+      } else {
+        validVariant = variant;
+      }
+      if ((_a = validVariant.pz) == null ? void 0 : _a.crit.length) {
+        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, validVariant.pz, context.scores, onLogMessage, context.quirks)) {
+          variantMatches.push(validVariant);
         }
       } else {
-        defaultVariants.push(variant);
+        defaultVariants.push(validVariant);
       }
     }
     const result = [];
@@ -838,6 +862,11 @@ function personalizeVariations({
   }
 }
 
+// src/placement/personalizeVariations.ts
+function personalizeVariations(options) {
+  return topDownCriteriaPersonalizationSelectionAlgorithm(options);
+}
+
 // src/placement/normalizeVariationDistributions.ts
 var normalizeVariationDistributions = (variations) => {
   const { values, total, missingDistribution } = variations.reduce(
@@ -857,7 +886,12 @@ var normalizeVariationDistributions = (variations) => {
     }
   );
   if (total > 100) {
-    throw new Error(`Total distribution ${total} is over the maximum 100.`);
+    const autoScaleFactor = 100 / total;
+    values.forEach((value, index) => {
+      if (typeof value === "number") {
+        values[index] = value * autoScaleFactor;
+      }
+    });
   } else if (total < 100) {
     const remainder = 100 - total;
     const missingSlice = remainder / missingDistribution;
@@ -1637,11 +1671,12 @@ var import_lite5 = require("dequal/lite");
 var import_mitt3 = __toESM(require("mitt"));
 var CONTEXTUAL_EDITING_TEST_NAME = "contextual_editing_test";
 var CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID = "contextual_editing_test_selected_variant";
-var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
+var _personalizationSelectionAlgorithms, _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
 var Context = class {
   constructor(options) {
     __privateAdd(this, _Context_instances);
     __publicField(this, "manifest");
+    __privateAdd(this, _personalizationSelectionAlgorithms);
     __privateAdd(this, _serverTransitionState);
     __privateAdd(this, _scores, {});
     __privateAdd(this, _state);
@@ -1658,7 +1693,7 @@ var Context = class {
       off: __privateGet(this, _mitt3).off
     });
     __publicField(this, "storage");
-    var _a, _b;
+    var _a, _b, _c;
     const { manifest, ...storageOptions } = options;
     __privateSet(this, _state, {});
     __privateSet(this, _plugins, options.plugins);
@@ -1666,7 +1701,17 @@ var Context = class {
     if (typeof options.transitionStore !== "undefined") {
       __privateSet(this, _commands, []);
     }
+    __privateSet(this, _personalizationSelectionAlgorithms, { default: topDownCriteriaPersonalizationSelectionAlgorithm });
     (_a = __privateGet(this, _plugins)) == null ? void 0 : _a.forEach((plugin) => {
+      if (!plugin.personalizationSelectionAlgorithms) {
+        return;
+      }
+      __privateSet(this, _personalizationSelectionAlgorithms, {
+        ...__privateGet(this, _personalizationSelectionAlgorithms),
+        ...plugin.personalizationSelectionAlgorithms
+      });
+    });
+    (_b = __privateGet(this, _plugins)) == null ? void 0 : _b.forEach((plugin) => {
       if (!plugin.logDrain) {
         return;
       }
@@ -1717,7 +1762,7 @@ var Context = class {
         __privateGet(this, _mitt3).emit("quirksUpdated", quirks.quirks);
         __privateGet(this, _mitt3).emit("log", ["info", 4, quirks.quirks]);
       });
-      (_b = __privateGet(this, _plugins)) == null ? void 0 : _b.forEach((plugin) => {
+      (_c = __privateGet(this, _plugins)) == null ? void 0 : _c.forEach((plugin) => {
         if (!plugin.init) {
           return;
         }
@@ -1967,7 +2012,17 @@ var Context = class {
   }
   /** Executes a personalized placement with a given set of variants */
   personalize(options) {
-    const value = personalizeVariations({
+    var _a;
+    const algorithmName = (_a = options.algorithm) != null ? _a : "default";
+    const algorithm = __privateGet(this, _personalizationSelectionAlgorithms)[algorithmName];
+    if (!algorithm) {
+      __privateGet(this, _mitt3).emit("log", ["warn", 304, { algorithm: algorithmName }]);
+      return {
+        personalized: false,
+        variations: []
+      };
+    }
+    const value = algorithm({
       ...options,
       context: this,
       onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message)
@@ -2041,6 +2096,7 @@ var Context = class {
     __privateGet(this, _mitt3).emit("personalizationResult", event);
   }
 };
+_personalizationSelectionAlgorithms = new WeakMap();
 _serverTransitionState = new WeakMap();
 _scores = new WeakMap();
 _state = new WeakMap();
@@ -2636,6 +2692,10 @@ var messageContent = {
   301: ({ id, op }) => ["personalization", `testing variation ${id} (${op === "|" ? "OR" : "AND"})`],
   302: ({ matched, description }) => ["personalization", `${description} is ${matched}`],
   303: (selected) => ["personalization", selected ? "selected variation" : "did not select variation"],
+  304: ({ algorithm }) => [
+    "personalization",
+    `personalization selection algorithm '${algorithm}' not found. Hiding placement.`
+  ],
   // TESTING
   400: (name) => ["testing", `executing A/B test '${name}'`],
   401: (testName) => ["testing", `${testName} is not registered in the manifest; it will not be run.`],
@@ -2783,5 +2843,6 @@ function parseQuickConnect(serialized) {
   serializePersonalizeVariants,
   serializeQuickConnect,
   serializeQuirks,
-  testVariations
+  testVariations,
+  topDownCriteriaPersonalizationSelectionAlgorithm
 });

package/dist/index.mjs

@@ -633,7 +633,15 @@ function evaluateDimensionMatch(crit, vec, onLogMessage) {
     explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else {
-    throw new Error(`Unknown op: ${op}`);
+    onLogMessage == null ? void 0 : onLogMessage([
+      "error",
+      302,
+      {
+        matched: false,
+        description: `${crit.l} ${crit.op} ${crit.rDim ? `${crit.rDim}` : crit.r}: Unknown op ${crit.op}.`
+      }
+    ]);
+    return false;
   }
 }
 function evaluateQuirkMatch(crit, quirks, onLogMessage) {
@@ -649,7 +657,15 @@ function evaluateQuirkMatch(crit, quirks, onLogMessage) {
     explainQuirk(onLogMessage, result, crit, targetQuirkValue);
     return result;
   } else {
-    throw new Error(`Unknown quirk op: ${op}`);
+    onLogMessage == null ? void 0 : onLogMessage([
+      "error",
+      302,
+      {
+        matched: false,
+        description: `Quirk ${crit.l} ${crit.op} ${crit.r}: Unknown quirk op ${crit.op}.`
+      }
+    ]);
+    return false;
   }
 }
 function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
@@ -673,8 +689,8 @@ function explainQuirk(onLogMessage, result, crit, lhs) {
   ]);
 }
 
-// src/placement/personalizeVariations.ts
-function personalizeVariations({
+// src/placement/topDownCriteriaPersonalizationSelectionAlgorithm.ts
+function topDownCriteriaPersonalizationSelectionAlgorithm({
   name,
   context,
   variations,
@@ -689,12 +705,19 @@ function personalizeVariations({
     const needsConsent = context.requireConsentForPersonalization;
     const canEvaluate = !needsConsent || context.storage.data.consent;
     for (const variant of variations) {
-      if ((_a = variant.pz) == null ? void 0 : _a.crit.length) {
-        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, variant.pz, context.scores, onLogMessage, context.quirks)) {
-          variantMatches.push(variant);
+      const isInvalidFormat = variant.pz && (typeof variant.pz !== "object" || variant.pz === null || !("crit" in variant.pz && Array.isArray(variant.pz.crit)));
+      let validVariant;
+      if (isInvalidFormat) {
+        validVariant = { id: variant.id };
+      } else {
+        validVariant = variant;
+      }
+      if ((_a = validVariant.pz) == null ? void 0 : _a.crit.length) {
+        if (canEvaluate && variantMatches.length !== take && evaluateVariantMatch(variant.id, validVariant.pz, context.scores, onLogMessage, context.quirks)) {
+          variantMatches.push(validVariant);
         }
       } else {
-        defaultVariants.push(variant);
+        defaultVariants.push(validVariant);
       }
     }
     const result = [];
@@ -749,6 +772,11 @@ function personalizeVariations({
   }
 }
 
+// src/placement/personalizeVariations.ts
+function personalizeVariations(options) {
+  return topDownCriteriaPersonalizationSelectionAlgorithm(options);
+}
+
 // src/placement/normalizeVariationDistributions.ts
 var normalizeVariationDistributions = (variations) => {
   const { values, total, missingDistribution } = variations.reduce(
@@ -768,7 +796,12 @@ var normalizeVariationDistributions = (variations) => {
     }
   );
   if (total > 100) {
-    throw new Error(`Total distribution ${total} is over the maximum 100.`);
+    const autoScaleFactor = 100 / total;
+    values.forEach((value, index) => {
+      if (typeof value === "number") {
+        values[index] = value * autoScaleFactor;
+      }
+    });
   } else if (total < 100) {
     const remainder = 100 - total;
     const missingSlice = remainder / missingDistribution;
@@ -1548,11 +1581,12 @@ import { dequal as dequal5 } from "dequal/lite";
 import mitt3 from "mitt";
 var CONTEXTUAL_EDITING_TEST_NAME = "contextual_editing_test";
 var CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID = "contextual_editing_test_selected_variant";
-var _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
+var _personalizationSelectionAlgorithms, _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
 var Context = class {
   constructor(options) {
     __privateAdd(this, _Context_instances);
     __publicField(this, "manifest");
+    __privateAdd(this, _personalizationSelectionAlgorithms);
     __privateAdd(this, _serverTransitionState);
     __privateAdd(this, _scores, {});
     __privateAdd(this, _state);
@@ -1569,7 +1603,7 @@ var Context = class {
       off: __privateGet(this, _mitt3).off
     });
     __publicField(this, "storage");
-    var _a, _b;
+    var _a, _b, _c;
     const { manifest, ...storageOptions } = options;
     __privateSet(this, _state, {});
     __privateSet(this, _plugins, options.plugins);
@@ -1577,7 +1611,17 @@ var Context = class {
     if (typeof options.transitionStore !== "undefined") {
       __privateSet(this, _commands, []);
     }
+    __privateSet(this, _personalizationSelectionAlgorithms, { default: topDownCriteriaPersonalizationSelectionAlgorithm });
     (_a = __privateGet(this, _plugins)) == null ? void 0 : _a.forEach((plugin) => {
+      if (!plugin.personalizationSelectionAlgorithms) {
+        return;
+      }
+      __privateSet(this, _personalizationSelectionAlgorithms, {
+        ...__privateGet(this, _personalizationSelectionAlgorithms),
+        ...plugin.personalizationSelectionAlgorithms
+      });
+    });
+    (_b = __privateGet(this, _plugins)) == null ? void 0 : _b.forEach((plugin) => {
       if (!plugin.logDrain) {
         return;
       }
@@ -1628,7 +1672,7 @@ var Context = class {
         __privateGet(this, _mitt3).emit("quirksUpdated", quirks.quirks);
         __privateGet(this, _mitt3).emit("log", ["info", 4, quirks.quirks]);
       });
-      (_b = __privateGet(this, _plugins)) == null ? void 0 : _b.forEach((plugin) => {
+      (_c = __privateGet(this, _plugins)) == null ? void 0 : _c.forEach((plugin) => {
         if (!plugin.init) {
           return;
         }
@@ -1878,7 +1922,17 @@ var Context = class {
   }
   /** Executes a personalized placement with a given set of variants */
   personalize(options) {
-    const value = personalizeVariations({
+    var _a;
+    const algorithmName = (_a = options.algorithm) != null ? _a : "default";
+    const algorithm = __privateGet(this, _personalizationSelectionAlgorithms)[algorithmName];
+    if (!algorithm) {
+      __privateGet(this, _mitt3).emit("log", ["warn", 304, { algorithm: algorithmName }]);
+      return {
+        personalized: false,
+        variations: []
+      };
+    }
+    const value = algorithm({
       ...options,
       context: this,
       onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message)
@@ -1952,6 +2006,7 @@ var Context = class {
     __privateGet(this, _mitt3).emit("personalizationResult", event);
   }
 };
+_personalizationSelectionAlgorithms = new WeakMap();
 _serverTransitionState = new WeakMap();
 _scores = new WeakMap();
 _state = new WeakMap();
@@ -2547,6 +2602,10 @@ var messageContent = {
   301: ({ id, op }) => ["personalization", `testing variation ${id} (${op === "|" ? "OR" : "AND"})`],
   302: ({ matched, description }) => ["personalization", `${description} is ${matched}`],
   303: (selected) => ["personalization", selected ? "selected variation" : "did not select variation"],
+  304: ({ algorithm }) => [
+    "personalization",
+    `personalization selection algorithm '${algorithm}' not found. Hiding placement.`
+  ],
   // TESTING
   400: (name) => ["testing", `executing A/B test '${name}'`],
   401: (testName) => ["testing", `${testName} is not registered in the manifest; it will not be run.`],
@@ -2693,5 +2752,6 @@ export {
   serializePersonalizeVariants,
   serializeQuickConnect,
   serializeQuirks,
-  testVariations
+  testVariations,
+  topDownCriteriaPersonalizationSelectionAlgorithm
 };

package/dist/{types-gu4PVkDD.d.mts → types-BPchcX4k.d.mts}

@@ -859,6 +859,10 @@ type LogMessages = {
     }>;
     /** Final result for a personalized variation */
     303: MessageFunc<boolean>;
+    /** Personalization algorithm not found */
+    304: MessageFunc<{
+        algorithm: string;
+    }>;
     /** A/B test placement executing */
     400: MessageFunc<string>;
     /** A/B Test definition did not exist */
@@ -898,7 +902,8 @@ type LogMessageSingle<TID extends keyof LogMessages = keyof LogMessages> = [
 type LogMessageGroup<TID extends keyof LogMessages = keyof LogMessages> = [severity: Severity, id: TID, group: 'GROUP', ...args: Parameters<LogMessages[TID]>] | [severity: Severity, id: TID, group: 'ENDGROUP'];
 type LogDrain = (message: LogMessage) => void;
 
-type VariantMatchCriteria = {
+/** Data for a personalization variation using the top-down criteria selection algorithm */
+interface VariantMatchCriteria extends VariantMatchMetadata {
     /**
      * Operation for match criteria
      *
@@ -906,15 +911,20 @@ type VariantMatchCriteria = {
      */
     op?: '&' | '|';
     crit: Array<DimensionMatch | QuirkMatch>;
-    /**
-     * Name of the variant for analytics tracking.
-     */
-    name?: string;
     /**
      * Control group percentage for the variant.
      */
     control?: number;
-};
+}
+/** Data that must exist on a personalization variation regardless of selection algorithm */
+interface VariantMatchMetadata {
+    /**
+     * Name of the variation for analytics tracking.
+     * NOTE: name is optional for backwards compatibility, but it is HIGHLY recommended to specify a name
+     * as the default fallback is not helpfully named and is reliant on the order of the variations array.
+     */
+    name?: string;
+}
 type DimensionMatch = {
     /**
      * Left hand side of the match expression (name of dimension in score vector)
@@ -990,11 +1000,11 @@ type BehaviorTag = {
     beh?: EnrichmentData[];
 };
 /** Defines the shape of a personalized content variant */
-type PersonalizedVariant = {
+type PersonalizedVariant<TCriteria = VariantMatchCriteria> = {
     /** A unique identifier for this variation */
     id: string;
     /** Match criteria for this variation */
-    pz?: VariantMatchCriteria;
+    pz?: TCriteria;
 };
 /** The result of computing personalized content from variations */
 type PersonalizedResult<TVariant> = {
@@ -1002,6 +1012,7 @@ type PersonalizedResult<TVariant> = {
     personalized: boolean;
     /** Matching variations */
     variations: Array<TVariant & {
+        /** Whether the visitor is part of this variation's local control group (also true if part of global control group) */
         control: boolean;
     }>;
 };
@@ -1026,19 +1037,28 @@ type TestResult<TVariant> = {
      */
     variantAssigned: boolean;
 };
-
-type PersonalizeOptions<TVariant> = {
+interface PersonalizeOptions<TVariant> {
+    /** Name of placement (sent to analytics) */
+    name: string;
+    /** Possible variations to place  */
+    variations: Iterable<TVariant>;
+    /** Maximum number of variants to place (default: 1) */
+    take?: number;
+    /** Name of the personalization selection algorithm to use. Defaults to top-down criteria when not specified. */
+    algorithm?: string;
+}
+interface PersonalizationSelectionAlgorithmOptions<TCriteria, TVariant extends PersonalizedVariant<TCriteria> = PersonalizedVariant<TCriteria>> {
     /** Name of placement (sent to analytics) */
     name: string;
-    /** Possible variants to place  */
+    /** Possible variations to place  */
     variations: Iterable<TVariant>;
     /** Maximum number of variants to place (default: 1) */
     take?: number;
+    /** Callback for logging messages */
     onLogMessage?: (message: LogMessage) => void;
-};
-declare function personalizeVariations<TVariant extends PersonalizedVariant>({ name, context, variations, take, onLogMessage, }: PersonalizeOptions<TVariant> & {
+    /** Context instance */
     context: Context;
-}): PersonalizedResult<TVariant>;
+}
 
 type TestOptions<TVariant extends TestVariant> = {
     /** The name of the test that is being run, must be included in the manifest. */
@@ -1053,18 +1073,31 @@ declare const testVariations: <TVariant extends TestVariant>({ name, context, va
 
 declare const CONTEXTUAL_EDITING_TEST_NAME = "contextual_editing_test";
 declare const CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID = "contextual_editing_test_selected_variant";
+type PersonalizationSelectionAlgorithm<TCriteria = unknown> = (options: PersonalizationSelectionAlgorithmOptions<TCriteria>) => PersonalizedResult<PersonalizedVariant<TCriteria>>;
+type PersonalizationSelectionAlgorithms<TCriteria = unknown> = Record<string, PersonalizationSelectionAlgorithm<TCriteria>>;
 /**
  * Defines a plugin for Uniform Context.
  * The plugin should attach event handlers in its creation function.
  * @returns A function that detaches any event handlers when called
  */
 type ContextPlugin = {
+    /** Defines a log drain for the plugin, which all log messages are sent to */
     logDrain?: LogDrain;
+    /** Initializes the plugin (attach event handlers here if needed) */
     init?: (context: Context) => () => void;
+    /** Plugin-specific actions to perform when a user is forgotten */
     forget?: () => Promise<void> | void;
+    /** Plugin-specific actions to perform when the visitor context is updated */
     update?: (newData: Partial<ContextState>) => Promise<void> | void;
+    /**
+     * Allows the plugin to register named personalization selection algorithms
+     *
+     * Important: the `default` and `strongestMatch` algorithms are automatically registered.
+     * We strongly advise against replacing these.
+     */
+    personalizationSelectionAlgorithms?: PersonalizationSelectionAlgorithms<any>;
 };
-type ContextOptions = {
+interface ContextOptions extends Omit<VisitorDataStoreOptions, 'manifest' | 'onServerTransitionScoresReceived'> {
     /** The Context Manifest to load (from the Context API) */
     manifest: ManifestV2;
     /**
@@ -1081,16 +1114,19 @@ type ContextOptions = {
      * `true`: personalization is not run at all unless storage consent is given
      */
     requireConsentForPersonalization?: boolean;
-} & Omit<VisitorDataStoreOptions, 'manifest' | 'onServerTransitionScoresReceived'>;
+}
+type PersonalizationEventVariantId = {
+    /** The variant ID that was selected */
+    id: string;
+    /** Whether the visitor is part of this variant's local control group (also true if part of global control group) */
+    control: boolean;
+};
 /** Emitted when a personalization runs */
 type PersonalizationEvent = {
     /** Name of the personalized placement */
     name: string;
     /** Selected variant ID(s) */
-    variantIds: {
-        id: string;
-        control: boolean;
-    }[];
+    variantIds: PersonalizationEventVariantId[];
     /** Whether the user was part of the control group (and did not receive any personalization) */
     control: boolean | undefined;
     /**
@@ -1144,7 +1180,7 @@ interface ContextInstance {
     setTestVariantId(testName: string, variantId: string): void;
     log(...message: LogMessage): void;
     test<TVariant extends TestVariant>(options: TestOptions<TVariant>): TestResult<TVariant>;
-    personalize<TVariant extends PersonalizedVariant>(options: PersonalizeOptions<TVariant>): PersonalizedResult<TVariant>;
+    personalize<TVariant extends PersonalizedVariant<any>>(options: PersonalizeOptions<TVariant>): PersonalizedResult<TVariant>;
     forget(fromAllDevices: boolean): Promise<void>;
     getServerToClientTransitionState(): ServerToClientTransitionState;
     readonly manifest: ManifestInstance;
@@ -1209,7 +1245,7 @@ declare class Context implements ContextInstance {
     /** Executes an A/B test with a given set of variants, showing the visitor's assigned variant (or selecting one to assign, if none is set yet) */
     test<TVariant extends TestVariant>(options: TestOptions<TVariant>): TestResult<TVariant>;
     /** Executes a personalized placement with a given set of variants */
-    personalize<TVariant extends PersonalizedVariant>(options: PersonalizeOptions<TVariant>): PersonalizedResult<TVariant>;
+    personalize<TVariant extends PersonalizedVariant<any>>(options: PersonalizeOptions<TVariant>): PersonalizedResult<TVariant>;
     /**
      * Forgets the visitor's data and resets the Context to its initial state.
      * @param fromAllDevices for an identified user, whether to delete all their data (for the entire account) - true, or data for this device (sign out) - false
@@ -1296,4 +1332,4 @@ declare global {
     }
 }
 
-export { type AggregateDimensionInput as $, type AggregateDimension as A, type MessageFunc as B, type ContextPlugin as C, type DecayFunction as D, type LogMessageSingle as E, type LogMessageGroup as F, ManifestInstance as G, GroupCriteriaEvaluator as H, type CriteriaEvaluatorResult as I, type CriteriaEvaluatorParameters as J, type SignalData as K, type LogDrain as L, type MessageCategory as M, type ManifestV2 as N, type OutputSeverity as O, type PersonalizationEvent as P, type Quirks as Q, type PersonalizationManifest as R, type ScoreVector as S, TransitionDataStore as T, type Signal as U, type VisitorData as V, type SignalCriteriaGroup as W, type SignalCriteria as X, type EnrichmentCategory as Y, type NumberMatch as Z, type TestDefinition as _, type StorageCommands as a, type TestOptions as a0, testVariations as a1, type DimensionMatch as a2, type QuirkMatch as a3, type PersonalizeOptions as a4, personalizeVariations as a5, type BehaviorTag as a6, type PersonalizedVariant as a7, type PersonalizedResult as a8, type TestVariant as a9, type ContextState as aA, type ContextStateUpdate as aB, type GoalStateUpdate as aC, type paths as aD, type TestResult as aa, type StorageCommand as ab, type SetGoalCommand as ac, type ModifyScoreCommand as ad, type ModifySessionScoreCommand as ae, type SetConsentCommand as af, type SetQuirkCommand as ag, type SetTestCommand as ah, type IdentifyCommand as ai, type SetControlGroupCommand as aj, type SetPersonalizeVariantControlCommand as ak, areCommandsEqual as al, type ServerToClientTransitionState as am, SERVER_STATE_ID as an, type TransitionDataStoreEvents as ao, type DecayOptions as ap, type VisitorDataStoreOptions as aq, type VisitorDataStoreEvents as ar, VisitorDataStore as as, type Tests as at, type Goals as au, type EnrichmentData as av, type PersonalizeControlVariant as aw, type PersonalizeVariants as ax, type EventData as ay, emptyVisitorData as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type DevToolsEvents as g, CONTEXTUAL_EDITING_TEST_NAME as h, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as i, type ContextOptions as j, type TestEvent as k, type ContextEvents as l, type ContextInstance as m, Context as n, type DevToolsUiVersion as o, type DevToolsState as p, type DevToolsActions as q, type DevToolsEvent as r, type DevToolsLogEvent as s, type DevToolsDataEvent as t, type DevToolsHelloEvent as u, type DevToolsUpdateEvent as v, type DevToolsRawCommandsEvent as w, type DevToolsForgetEvent as x, type LogMessages as y, type Severity as z };
+export { type PersonalizationManifest as $, type AggregateDimension as A, type DevToolsDataEvent as B, type ContextPlugin as C, type DecayFunction as D, type DevToolsHelloEvent as E, type DevToolsUpdateEvent as F, type DevToolsRawCommandsEvent as G, type DevToolsForgetEvent as H, type LogMessages as I, type Severity as J, type MessageFunc as K, type LogDrain as L, type MessageCategory as M, type LogMessageSingle as N, type OutputSeverity as O, type PersonalizedVariant as P, type Quirks as Q, type LogMessageGroup as R, type ScoreVector as S, TransitionDataStore as T, ManifestInstance as U, type VisitorData as V, GroupCriteriaEvaluator as W, type CriteriaEvaluatorResult as X, type CriteriaEvaluatorParameters as Y, type SignalData as Z, type ManifestV2 as _, type StorageCommands as a, type Signal as a0, type SignalCriteriaGroup as a1, type SignalCriteria as a2, type EnrichmentCategory as a3, type NumberMatch as a4, type TestDefinition as a5, type AggregateDimensionInput as a6, type TestOptions as a7, testVariations as a8, type VariantMatchMetadata as a9, type PersonalizeControlVariant as aA, type PersonalizeVariants as aB, type EventData as aC, emptyVisitorData as aD, type ContextState as aE, type ContextStateUpdate as aF, type GoalStateUpdate as aG, type paths as aH, type DimensionMatch as aa, type QuirkMatch as ab, type BehaviorTag as ac, type TestVariant as ad, type TestResult as ae, type StorageCommand as af, type SetGoalCommand as ag, type ModifyScoreCommand as ah, type ModifySessionScoreCommand as ai, type SetConsentCommand as aj, type SetQuirkCommand as ak, type SetTestCommand as al, type IdentifyCommand as am, type SetControlGroupCommand as an, type SetPersonalizeVariantControlCommand as ao, areCommandsEqual as ap, type ServerToClientTransitionState as aq, SERVER_STATE_ID as ar, type TransitionDataStoreEvents as as, type DecayOptions as at, type VisitorDataStoreOptions as au, type VisitorDataStoreEvents as av, VisitorDataStore as aw, type Tests as ax, type Goals as ay, type EnrichmentData as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type PersonalizeOptions as g, Context as h, type PersonalizedResult as i, type PersonalizationSelectionAlgorithmOptions as j, type DevToolsEvents as k, CONTEXTUAL_EDITING_TEST_NAME as l, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as m, type PersonalizationSelectionAlgorithm as n, type PersonalizationSelectionAlgorithms as o, type ContextOptions as p, type PersonalizationEventVariantId as q, type PersonalizationEvent as r, type TestEvent as s, type ContextEvents as t, type ContextInstance as u, type DevToolsUiVersion as v, type DevToolsState as w, type DevToolsActions as x, type DevToolsEvent as y, type DevToolsLogEvent as z };

package/dist/{types-gu4PVkDD.d.ts → types-BPchcX4k.d.ts}

@@ -859,6 +859,10 @@ type LogMessages = {
     }>;
     /** Final result for a personalized variation */
     303: MessageFunc<boolean>;
+    /** Personalization algorithm not found */
+    304: MessageFunc<{
+        algorithm: string;
+    }>;
     /** A/B test placement executing */
     400: MessageFunc<string>;
     /** A/B Test definition did not exist */
@@ -898,7 +902,8 @@ type LogMessageSingle<TID extends keyof LogMessages = keyof LogMessages> = [
 type LogMessageGroup<TID extends keyof LogMessages = keyof LogMessages> = [severity: Severity, id: TID, group: 'GROUP', ...args: Parameters<LogMessages[TID]>] | [severity: Severity, id: TID, group: 'ENDGROUP'];
 type LogDrain = (message: LogMessage) => void;
 
-type VariantMatchCriteria = {
+/** Data for a personalization variation using the top-down criteria selection algorithm */
+interface VariantMatchCriteria extends VariantMatchMetadata {
     /**
      * Operation for match criteria
      *
@@ -906,15 +911,20 @@ type VariantMatchCriteria = {
      */
     op?: '&' | '|';
     crit: Array<DimensionMatch | QuirkMatch>;
-    /**
-     * Name of the variant for analytics tracking.
-     */
-    name?: string;
     /**
      * Control group percentage for the variant.
      */
     control?: number;
-};
+}
+/** Data that must exist on a personalization variation regardless of selection algorithm */
+interface VariantMatchMetadata {
+    /**
+     * Name of the variation for analytics tracking.
+     * NOTE: name is optional for backwards compatibility, but it is HIGHLY recommended to specify a name
+     * as the default fallback is not helpfully named and is reliant on the order of the variations array.
+     */
+    name?: string;
+}
 type DimensionMatch = {
     /**
      * Left hand side of the match expression (name of dimension in score vector)
@@ -990,11 +1000,11 @@ type BehaviorTag = {
     beh?: EnrichmentData[];
 };
 /** Defines the shape of a personalized content variant */
-type PersonalizedVariant = {
+type PersonalizedVariant<TCriteria = VariantMatchCriteria> = {
     /** A unique identifier for this variation */
     id: string;
     /** Match criteria for this variation */
-    pz?: VariantMatchCriteria;
+    pz?: TCriteria;
 };
 /** The result of computing personalized content from variations */
 type PersonalizedResult<TVariant> = {
@@ -1002,6 +1012,7 @@ type PersonalizedResult<TVariant> = {
     personalized: boolean;
     /** Matching variations */
     variations: Array<TVariant & {
+        /** Whether the visitor is part of this variation's local control group (also true if part of global control group) */
         control: boolean;
     }>;
 };
@@ -1026,19 +1037,28 @@ type TestResult<TVariant> = {
      */
     variantAssigned: boolean;
 };
-
-type PersonalizeOptions<TVariant> = {
+interface PersonalizeOptions<TVariant> {
+    /** Name of placement (sent to analytics) */
+    name: string;
+    /** Possible variations to place  */
+    variations: Iterable<TVariant>;
+    /** Maximum number of variants to place (default: 1) */
+    take?: number;
+    /** Name of the personalization selection algorithm to use. Defaults to top-down criteria when not specified. */
+    algorithm?: string;
+}
+interface PersonalizationSelectionAlgorithmOptions<TCriteria, TVariant extends PersonalizedVariant<TCriteria> = PersonalizedVariant<TCriteria>> {
     /** Name of placement (sent to analytics) */
     name: string;
-    /** Possible variants to place  */
+    /** Possible variations to place  */
     variations: Iterable<TVariant>;
     /** Maximum number of variants to place (default: 1) */
     take?: number;
+    /** Callback for logging messages */
     onLogMessage?: (message: LogMessage) => void;
-};
-declare function personalizeVariations<TVariant extends PersonalizedVariant>({ name, context, variations, take, onLogMessage, }: PersonalizeOptions<TVariant> & {
+    /** Context instance */
     context: Context;
-}): PersonalizedResult<TVariant>;
+}
 
 type TestOptions<TVariant extends TestVariant> = {
     /** The name of the test that is being run, must be included in the manifest. */
@@ -1053,18 +1073,31 @@ declare const testVariations: <TVariant extends TestVariant>({ name, context, va
 
 declare const CONTEXTUAL_EDITING_TEST_NAME = "contextual_editing_test";
 declare const CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID = "contextual_editing_test_selected_variant";
+type PersonalizationSelectionAlgorithm<TCriteria = unknown> = (options: PersonalizationSelectionAlgorithmOptions<TCriteria>) => PersonalizedResult<PersonalizedVariant<TCriteria>>;
+type PersonalizationSelectionAlgorithms<TCriteria = unknown> = Record<string, PersonalizationSelectionAlgorithm<TCriteria>>;
 /**
  * Defines a plugin for Uniform Context.
  * The plugin should attach event handlers in its creation function.
  * @returns A function that detaches any event handlers when called
  */
 type ContextPlugin = {
+    /** Defines a log drain for the plugin, which all log messages are sent to */
     logDrain?: LogDrain;
+    /** Initializes the plugin (attach event handlers here if needed) */
     init?: (context: Context) => () => void;
+    /** Plugin-specific actions to perform when a user is forgotten */
     forget?: () => Promise<void> | void;
+    /** Plugin-specific actions to perform when the visitor context is updated */
     update?: (newData: Partial<ContextState>) => Promise<void> | void;
+    /**
+     * Allows the plugin to register named personalization selection algorithms
+     *
+     * Important: the `default` and `strongestMatch` algorithms are automatically registered.
+     * We strongly advise against replacing these.
+     */
+    personalizationSelectionAlgorithms?: PersonalizationSelectionAlgorithms<any>;
 };
-type ContextOptions = {
+interface ContextOptions extends Omit<VisitorDataStoreOptions, 'manifest' | 'onServerTransitionScoresReceived'> {
     /** The Context Manifest to load (from the Context API) */
     manifest: ManifestV2;
     /**
@@ -1081,16 +1114,19 @@ type ContextOptions = {
      * `true`: personalization is not run at all unless storage consent is given
      */
     requireConsentForPersonalization?: boolean;
-} & Omit<VisitorDataStoreOptions, 'manifest' | 'onServerTransitionScoresReceived'>;
+}
+type PersonalizationEventVariantId = {
+    /** The variant ID that was selected */
+    id: string;
+    /** Whether the visitor is part of this variant's local control group (also true if part of global control group) */
+    control: boolean;
+};
 /** Emitted when a personalization runs */
 type PersonalizationEvent = {
     /** Name of the personalized placement */
     name: string;
     /** Selected variant ID(s) */
-    variantIds: {
-        id: string;
-        control: boolean;
-    }[];
+    variantIds: PersonalizationEventVariantId[];
     /** Whether the user was part of the control group (and did not receive any personalization) */
     control: boolean | undefined;
     /**
@@ -1144,7 +1180,7 @@ interface ContextInstance {
     setTestVariantId(testName: string, variantId: string): void;
     log(...message: LogMessage): void;
     test<TVariant extends TestVariant>(options: TestOptions<TVariant>): TestResult<TVariant>;
-    personalize<TVariant extends PersonalizedVariant>(options: PersonalizeOptions<TVariant>): PersonalizedResult<TVariant>;
+    personalize<TVariant extends PersonalizedVariant<any>>(options: PersonalizeOptions<TVariant>): PersonalizedResult<TVariant>;
     forget(fromAllDevices: boolean): Promise<void>;
     getServerToClientTransitionState(): ServerToClientTransitionState;
     readonly manifest: ManifestInstance;
@@ -1209,7 +1245,7 @@ declare class Context implements ContextInstance {
     /** Executes an A/B test with a given set of variants, showing the visitor's assigned variant (or selecting one to assign, if none is set yet) */
     test<TVariant extends TestVariant>(options: TestOptions<TVariant>): TestResult<TVariant>;
     /** Executes a personalized placement with a given set of variants */
-    personalize<TVariant extends PersonalizedVariant>(options: PersonalizeOptions<TVariant>): PersonalizedResult<TVariant>;
+    personalize<TVariant extends PersonalizedVariant<any>>(options: PersonalizeOptions<TVariant>): PersonalizedResult<TVariant>;
     /**
      * Forgets the visitor's data and resets the Context to its initial state.
      * @param fromAllDevices for an identified user, whether to delete all their data (for the entire account) - true, or data for this device (sign out) - false
@@ -1296,4 +1332,4 @@ declare global {
     }
 }
 
-export { type AggregateDimensionInput as $, type AggregateDimension as A, type MessageFunc as B, type ContextPlugin as C, type DecayFunction as D, type LogMessageSingle as E, type LogMessageGroup as F, ManifestInstance as G, GroupCriteriaEvaluator as H, type CriteriaEvaluatorResult as I, type CriteriaEvaluatorParameters as J, type SignalData as K, type LogDrain as L, type MessageCategory as M, type ManifestV2 as N, type OutputSeverity as O, type PersonalizationEvent as P, type Quirks as Q, type PersonalizationManifest as R, type ScoreVector as S, TransitionDataStore as T, type Signal as U, type VisitorData as V, type SignalCriteriaGroup as W, type SignalCriteria as X, type EnrichmentCategory as Y, type NumberMatch as Z, type TestDefinition as _, type StorageCommands as a, type TestOptions as a0, testVariations as a1, type DimensionMatch as a2, type QuirkMatch as a3, type PersonalizeOptions as a4, personalizeVariations as a5, type BehaviorTag as a6, type PersonalizedVariant as a7, type PersonalizedResult as a8, type TestVariant as a9, type ContextState as aA, type ContextStateUpdate as aB, type GoalStateUpdate as aC, type paths as aD, type TestResult as aa, type StorageCommand as ab, type SetGoalCommand as ac, type ModifyScoreCommand as ad, type ModifySessionScoreCommand as ae, type SetConsentCommand as af, type SetQuirkCommand as ag, type SetTestCommand as ah, type IdentifyCommand as ai, type SetControlGroupCommand as aj, type SetPersonalizeVariantControlCommand as ak, areCommandsEqual as al, type ServerToClientTransitionState as am, SERVER_STATE_ID as an, type TransitionDataStoreEvents as ao, type DecayOptions as ap, type VisitorDataStoreOptions as aq, type VisitorDataStoreEvents as ar, VisitorDataStore as as, type Tests as at, type Goals as au, type EnrichmentData as av, type PersonalizeControlVariant as aw, type PersonalizeVariants as ax, type EventData as ay, emptyVisitorData as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type DevToolsEvents as g, CONTEXTUAL_EDITING_TEST_NAME as h, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as i, type ContextOptions as j, type TestEvent as k, type ContextEvents as l, type ContextInstance as m, Context as n, type DevToolsUiVersion as o, type DevToolsState as p, type DevToolsActions as q, type DevToolsEvent as r, type DevToolsLogEvent as s, type DevToolsDataEvent as t, type DevToolsHelloEvent as u, type DevToolsUpdateEvent as v, type DevToolsRawCommandsEvent as w, type DevToolsForgetEvent as x, type LogMessages as y, type Severity as z };
+export { type PersonalizationManifest as $, type AggregateDimension as A, type DevToolsDataEvent as B, type ContextPlugin as C, type DecayFunction as D, type DevToolsHelloEvent as E, type DevToolsUpdateEvent as F, type DevToolsRawCommandsEvent as G, type DevToolsForgetEvent as H, type LogMessages as I, type Severity as J, type MessageFunc as K, type LogDrain as L, type MessageCategory as M, type LogMessageSingle as N, type OutputSeverity as O, type PersonalizedVariant as P, type Quirks as Q, type LogMessageGroup as R, type ScoreVector as S, TransitionDataStore as T, ManifestInstance as U, type VisitorData as V, GroupCriteriaEvaluator as W, type CriteriaEvaluatorResult as X, type CriteriaEvaluatorParameters as Y, type SignalData as Z, type ManifestV2 as _, type StorageCommands as a, type Signal as a0, type SignalCriteriaGroup as a1, type SignalCriteria as a2, type EnrichmentCategory as a3, type NumberMatch as a4, type TestDefinition as a5, type AggregateDimensionInput as a6, type TestOptions as a7, testVariations as a8, type VariantMatchMetadata as a9, type PersonalizeControlVariant as aA, type PersonalizeVariants as aB, type EventData as aC, emptyVisitorData as aD, type ContextState as aE, type ContextStateUpdate as aF, type GoalStateUpdate as aG, type paths as aH, type DimensionMatch as aa, type QuirkMatch as ab, type BehaviorTag as ac, type TestVariant as ad, type TestResult as ae, type StorageCommand as af, type SetGoalCommand as ag, type ModifyScoreCommand as ah, type ModifySessionScoreCommand as ai, type SetConsentCommand as aj, type SetQuirkCommand as ak, type SetTestCommand as al, type IdentifyCommand as am, type SetControlGroupCommand as an, type SetPersonalizeVariantControlCommand as ao, areCommandsEqual as ap, type ServerToClientTransitionState as aq, SERVER_STATE_ID as ar, type TransitionDataStoreEvents as as, type DecayOptions as at, type VisitorDataStoreOptions as au, type VisitorDataStoreEvents as av, VisitorDataStore as aw, type Tests as ax, type Goals as ay, type EnrichmentData as az, type TransitionDataStoreOptions as b, type CriteriaEvaluator as c, type StringMatch as d, type VariantMatchCriteria as e, type LogMessage as f, type PersonalizeOptions as g, Context as h, type PersonalizedResult as i, type PersonalizationSelectionAlgorithmOptions as j, type DevToolsEvents as k, CONTEXTUAL_EDITING_TEST_NAME as l, CONTEXTUAL_EDITING_TEST_SELECTED_VARIANT_ID as m, type PersonalizationSelectionAlgorithm as n, type PersonalizationSelectionAlgorithms as o, type ContextOptions as p, type PersonalizationEventVariantId as q, type PersonalizationEvent as r, type TestEvent as s, type ContextEvents as t, type ContextInstance as u, type DevToolsUiVersion as v, type DevToolsState as w, type DevToolsActions as x, type DevToolsEvent as y, type DevToolsLogEvent as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/context",
-  "version": "20.3.1-alpha.7+bede5bf489",
+  "version": "20.4.1-alpha.15+73b27bfcce",
   "description": "Uniform Context core package",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -68,5 +68,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "bede5bf4893bf814af6aba78a558e28efd9f5682"
+  "gitHead": "73b27bfcce749c31e7ab50bdc9bb86ac1294903d"
 }