@uniformdev/context 20.6.2-alpha.11 → 20.7.1-alpha.4

package/dist/index.js

@@ -53,9 +53,7 @@ __export(src_exports, {
   PAIR_SEP: () => PAIR_SEP,
   QUIRK_SEP: () => QUIRK_SEP,
   SERVER_STATE_ID: () => SERVER_STATE_ID,
-  STRONGEST_SCORE_PERSONALIZATION_ALGORITHM: () => STRONGEST_SCORE_PERSONALIZATION_ALGORITHM,
   ScriptType: () => ScriptType,
-  TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM: () => TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM,
   TYPE_SEP: () => TYPE_SEP,
   TransitionDataStore: () => TransitionDataStore,
   UNIFORM_DEFAULT_COOKIE_NAME: () => UNIFORM_DEFAULT_COOKIE_NAME,
@@ -97,9 +95,7 @@ __export(src_exports, {
   serializePersonalizeVariants: () => serializePersonalizeVariants,
   serializeQuickConnect: () => serializeQuickConnect,
   serializeQuirks: () => serializeQuirks,
-  strongestScorePersonalizationSelectionAlgorithm: () => strongestScorePersonalizationSelectionAlgorithm,
-  testVariations: () => testVariations,
-  topDownCriteriaPersonalizationSelectionAlgorithm: () => topDownCriteriaPersonalizationSelectionAlgorithm
+  testVariations: () => testVariations
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -609,7 +605,7 @@ var GroupCriteriaEvaluator = class {
 _evaluators = new WeakMap();
 
 // src/placement/criteria/evaluateVariantMatch.ts
-function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
+function evaluateVariantMatch(variantId, match, vec, onLogMessage) {
   onLogMessage == null ? void 0 : onLogMessage(["info", 301, "GROUP", { id: variantId, op: match == null ? void 0 : match.op }]);
   let result;
   try {
@@ -617,9 +613,9 @@ function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
       onLogMessage == null ? void 0 : onLogMessage(["info", 302, { matched: true, description: "default variation" }]);
       result = true;
     } else if (!match.op || match.op === "&") {
-      result = match.crit.every((c) => evaluateMatch(c, vec, quirks != null ? quirks : {}, onLogMessage));
+      result = match.crit.every((c) => evaluateDimensionMatch(c, vec, onLogMessage));
     } else {
-      result = match.crit.some((c) => evaluateMatch(c, vec, quirks != null ? quirks : {}, onLogMessage));
+      result = match.crit.some((c) => evaluateDimensionMatch(c, vec, onLogMessage));
     }
     onLogMessage == null ? void 0 : onLogMessage(["info", 303, result]);
   } finally {
@@ -627,16 +623,9 @@ function evaluateVariantMatch(variantId, match, vec, onLogMessage, quirks) {
   }
   return result;
 }
-function evaluateMatch(crit, vec, quirks, onLogMessage) {
-  if ("t" in crit && crit.t === "q") {
-    return evaluateQuirkMatch(crit, quirks, onLogMessage);
-  } else {
-    return evaluateDimensionMatch(crit, vec, onLogMessage);
-  }
-}
 function evaluateDimensionMatch(crit, vec, onLogMessage) {
   var _a, _b;
-  const { l: lhs, op } = crit;
+  const { op, l: lhs } = crit;
   const lhsScore = (_a = vec[lhs]) != null ? _a : 0;
   if (op === "^") {
     const [cat] = lhs.split(ENR_SEPARATOR);
@@ -703,65 +692,33 @@ function evaluateDimensionMatch(crit, vec, onLogMessage) {
   }
   if (op === ">") {
     const result = lhsScore > rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === ">=") {
     const result = lhsScore >= rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "<") {
     const result = lhsScore < rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "<=") {
     const result = lhsScore <= rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "=") {
     const result = lhsScore === rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else if (op === "!=") {
     const result = lhsScore !== rhsScore;
-    explainScore(onLogMessage, result, crit, lhsScore, rhsScore);
+    explain(onLogMessage, result, crit, lhsScore, rhsScore);
     return result;
   } else {
-    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) {
-  var _a;
-  const { l: targetQuirk, op, r: targetValue } = crit;
-  const targetQuirkValue = (_a = quirks[targetQuirk]) != null ? _a : "";
-  if (op === "=") {
-    const result = targetQuirkValue === targetValue;
-    explainQuirk(onLogMessage, result, crit, targetQuirkValue);
-    return result;
-  } else if (op === "!=") {
-    const result = targetQuirkValue !== targetValue;
-    explainQuirk(onLogMessage, result, crit, targetQuirkValue);
-    return result;
-  } else {
-    onLogMessage == null ? void 0 : onLogMessage([
-      "error",
-      302,
-      {
-        matched: false,
-        description: `Quirk ${crit.l} ${crit.op} ${crit.r}: Unknown quirk op ${crit.op}.`
-      }
-    ]);
-    return false;
+    throw new Error(`Unknown op: ${op}`);
   }
 }
-function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
+function explain(onLogMessage, result, crit, lhsScore, rhsScore) {
   onLogMessage == null ? void 0 : onLogMessage([
     "info",
     302,
@@ -771,20 +728,9 @@ function explainScore(onLogMessage, result, crit, lhsScore, rhsScore) {
     }
   ]);
 }
-function explainQuirk(onLogMessage, result, crit, lhs) {
-  onLogMessage == null ? void 0 : onLogMessage([
-    "info",
-    302,
-    {
-      matched: result,
-      description: `Quirk ${crit.l}[${lhs}] ${crit.op} ${crit.r}`
-    }
-  ]);
-}
 
-// src/placement/topDownCriteriaPersonalizationSelectionAlgorithm.ts
-var TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM = "default";
-function topDownCriteriaPersonalizationSelectionAlgorithm({
+// src/placement/personalize.ts
+function personalizeVariations({
   name,
   context,
   variations,
@@ -794,35 +740,27 @@ function topDownCriteriaPersonalizationSelectionAlgorithm({
   var _a, _b, _c;
   onLogMessage == null ? void 0 : onLogMessage(["info", 300, "GROUP", { name, take }]);
   try {
-    const variationMatches = [];
-    const defaultVariations = [];
-    const needsConsentToPersonalize = context.requireConsentForPersonalization;
-    const personalizationAllowed = !needsConsentToPersonalize || context.storage.data.consent;
-    for (const variation of variations) {
-      const isInvalidFormat = variation.pz && (typeof variation.pz !== "object" || variation.pz === null || !("crit" in variation.pz && Array.isArray(variation.pz.crit)));
-      let validVariation;
-      if (isInvalidFormat) {
-        const { pz, ...validParts } = variation;
-        validVariation = validParts;
-      } else {
-        validVariation = variation;
-      }
-      if ((_a = validVariation.pz) == null ? void 0 : _a.crit.length) {
-        if (personalizationAllowed && variationMatches.length !== take && evaluateVariantMatch(variation.id, validVariation.pz, context.scores, onLogMessage, context.quirks)) {
-          variationMatches.push(validVariation);
+    const variantMatches = [];
+    const defaultVariants = [];
+    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)) {
+          variantMatches.push(variant);
         }
       } else {
-        defaultVariations.push(validVariation);
+        defaultVariants.push(variant);
       }
     }
     const result = [];
-    for (let i = 0; i < variationMatches.length; i++) {
+    for (let i = 0; i < variantMatches.length; i++) {
       let isControl = (_b = context.storage.data.controlGroup) != null ? _b : false;
-      const variation = variationMatches[i];
-      if (!isControl && typeof ((_c = variation.pz) == null ? void 0 : _c.control) === "number") {
+      const variant = variantMatches[i];
+      if (!isControl && typeof ((_c = variant.pz) == null ? void 0 : _c.control) === "number") {
         isControl = context.getPersonalizeVariantControl(name, i);
         if (typeof isControl === "undefined") {
-          isControl = rollForControlGroup(variation.pz.control);
+          isControl = rollForControlGroup(variant.pz.control);
           context.storage.updateData([
             {
               type: "setpersonalizecontrol",
@@ -835,13 +773,13 @@ function topDownCriteriaPersonalizationSelectionAlgorithm({
           ]);
         }
       }
-      let variantToAdd = variation;
+      let variantToAdd = variant;
       if (isControl) {
-        const defaultReplacement = defaultVariations.shift();
+        const defaultReplacement = defaultVariants.shift();
         if (defaultReplacement) {
           variantToAdd = {
             ...defaultReplacement,
-            id: variation.id
+            id: variant.id
           };
         } else {
           variantToAdd = void 0;
@@ -851,8 +789,8 @@ function topDownCriteriaPersonalizationSelectionAlgorithm({
         result.push({ ...variantToAdd, control: isControl });
       }
     }
-    while (result.length < take && defaultVariations.length) {
-      result.push({ ...defaultVariations.shift(), control: false });
+    while (result.length < take && defaultVariants.length) {
+      result.push({ ...defaultVariants.shift(), control: false });
     }
     const personalized = result.some((v) => {
       var _a2;
@@ -867,86 +805,7 @@ function topDownCriteriaPersonalizationSelectionAlgorithm({
   }
 }
 
-// src/placement/personalizeVariations.ts
-function personalizeVariations(options) {
-  return topDownCriteriaPersonalizationSelectionAlgorithm(options);
-}
-
-// src/placement/strongestScorePersonalizationSelectionAlgorithm.ts
-var STRONGEST_SCORE_PERSONALIZATION_ALGORITHM = "ssc";
-function strongestScorePersonalizationSelectionAlgorithm({
-  name,
-  context,
-  variations,
-  take = 1,
-  onLogMessage
-}) {
-  var _a, _b;
-  onLogMessage == null ? void 0 : onLogMessage(["info", 300, "GROUP", { name, take }]);
-  try {
-    const variationMatches = [];
-    const defaultVariations = [];
-    const needsConsentToPersonalize = context.requireConsentForPersonalization;
-    const isInGlobalControlGroup = (_a = context.storage.data.controlGroup) != null ? _a : false;
-    const personalizationAllowed = !needsConsentToPersonalize || context.storage.data.consent;
-    for (const variation of variations) {
-      const isInvalidFormat = variation.pz && typeof variation.pz !== "object";
-      let validVariation;
-      if (isInvalidFormat) {
-        const { pz, ...validParts } = variation;
-        validVariation = validParts;
-      } else {
-        validVariation = variation;
-      }
-      if ((_b = validVariation.pz) == null ? void 0 : _b.dim) {
-        if (!personalizationAllowed) {
-          continue;
-        }
-        const score = context.scores[validVariation.pz.dim];
-        if (score === void 0 || score <= 0) {
-          continue;
-        }
-        variationMatches.push({ variation: validVariation, score });
-      } else {
-        defaultVariations.push(validVariation);
-      }
-    }
-    variationMatches.sort((a, b) => b.score - a.score);
-    const result = [];
-    for (let i = 0; i < variationMatches.length; i++) {
-      const variationMatch = variationMatches[i];
-      let variantToAdd = variationMatch.variation;
-      if (i >= take) {
-        continue;
-      }
-      if (isInGlobalControlGroup) {
-        const defaultReplacement = defaultVariations.shift();
-        if (defaultReplacement) {
-          variantToAdd = {
-            ...defaultReplacement,
-            id: variationMatch.variation.id
-          };
-        } else {
-          variantToAdd = void 0;
-        }
-      }
-      if (variantToAdd) {
-        result.push({ ...variantToAdd, control: isInGlobalControlGroup });
-      }
-    }
-    while (result.length < take && defaultVariations.length) {
-      result.push({ ...defaultVariations.shift(), control: false });
-    }
-    return {
-      personalized: variationMatches.length > 0 && !isInGlobalControlGroup,
-      variations: result
-    };
-  } finally {
-    onLogMessage == null ? void 0 : onLogMessage(["info", 300, "ENDGROUP"]);
-  }
-}
-
-// src/placement/normalizeVariationDistributions.ts
+// src/placement/test.ts
 var normalizeVariationDistributions = (variations) => {
   const { values, total, missingDistribution } = variations.reduce(
     (previous, current) => {
@@ -965,12 +824,7 @@ var normalizeVariationDistributions = (variations) => {
     }
   );
   if (total > 100) {
-    const autoScaleFactor = 100 / total;
-    values.forEach((value, index) => {
-      if (typeof value === "number") {
-        values[index] = value * autoScaleFactor;
-      }
-    });
+    throw new Error(`Total distribution ${total} is over the maximum 100.`);
   } else if (total < 100) {
     const remainder = 100 - total;
     const missingSlice = remainder / missingDistribution;
@@ -982,8 +836,6 @@ var normalizeVariationDistributions = (variations) => {
   }
   return values;
 };
-
-// src/placement/testVariations.ts
 var testVariations = ({
   name,
   context,
@@ -1750,12 +1602,11 @@ 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 _personalizationSelectionAlgorithms, _serverTransitionState, _scores, _state, _pzCache, _plugins, _commands, _requireConsentForPersonalization, _mitt3, _Context_instances, emitTest_fn, updateGoals_fn, updateComputedScores_fn, calculateScores_fn;
+var _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);
@@ -1772,7 +1623,7 @@ var Context = class {
       off: __privateGet(this, _mitt3).off
     });
     __publicField(this, "storage");
-    var _a, _b, _c;
+    var _a, _b;
     const { manifest, ...storageOptions } = options;
     __privateSet(this, _state, {});
     __privateSet(this, _plugins, options.plugins);
@@ -1780,20 +1631,7 @@ var Context = class {
     if (typeof options.transitionStore !== "undefined") {
       __privateSet(this, _commands, []);
     }
-    __privateSet(this, _personalizationSelectionAlgorithms, {
-      [TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM]: topDownCriteriaPersonalizationSelectionAlgorithm,
-      [STRONGEST_SCORE_PERSONALIZATION_ALGORITHM]: strongestScorePersonalizationSelectionAlgorithm
-    });
     (_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;
       }
@@ -1844,7 +1682,7 @@ var Context = class {
         __privateGet(this, _mitt3).emit("quirksUpdated", quirks.quirks);
         __privateGet(this, _mitt3).emit("log", ["info", 4, quirks.quirks]);
       });
-      (_c = __privateGet(this, _plugins)) == null ? void 0 : _c.forEach((plugin) => {
+      (_b = __privateGet(this, _plugins)) == null ? void 0 : _b.forEach((plugin) => {
         if (!plugin.init) {
           return;
         }
@@ -2094,17 +1932,7 @@ var Context = class {
   }
   /** Executes a personalized placement with a given set of variants */
   personalize(options) {
-    var _a;
-    const algorithmName = (_a = options.algorithm) != null ? _a : TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM;
-    const algorithm = __privateGet(this, _personalizationSelectionAlgorithms)[algorithmName];
-    if (!algorithm) {
-      __privateGet(this, _mitt3).emit("log", ["warn", 304, { algorithm: algorithmName }]);
-      return {
-        personalized: false,
-        variations: []
-      };
-    }
-    const value = algorithm({
+    const value = personalizeVariations({
       ...options,
       context: this,
       onLogMessage: (message) => __privateGet(this, _mitt3).emit("log", message)
@@ -2178,7 +2006,6 @@ var Context = class {
     __privateGet(this, _mitt3).emit("personalizationResult", event);
   }
 };
-_personalizationSelectionAlgorithms = new WeakMap();
 _serverTransitionState = new WeakMap();
 _scores = new WeakMap();
 _state = new WeakMap();
@@ -2774,10 +2601,6 @@ 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.`],
@@ -2883,9 +2706,7 @@ function parseQuickConnect(serialized) {
   PAIR_SEP,
   QUIRK_SEP,
   SERVER_STATE_ID,
-  STRONGEST_SCORE_PERSONALIZATION_ALGORITHM,
   ScriptType,
-  TOP_DOWN_CRITERIA_PERSONALIZATION_ALGORITHM,
   TYPE_SEP,
   TransitionDataStore,
   UNIFORM_DEFAULT_COOKIE_NAME,
@@ -2927,7 +2748,5 @@ function parseQuickConnect(serialized) {
   serializePersonalizeVariants,
   serializeQuickConnect,
   serializeQuirks,
-  strongestScorePersonalizationSelectionAlgorithm,
-  testVariations,
-  topDownCriteriaPersonalizationSelectionAlgorithm
+  testVariations
 });