pairit 0.3.1 → 0.3.2

package/dist/index.js

@@ -9807,9 +9807,65 @@ async function attachHtmlToCompiledConfig(configPath, compiled) {
   return sources;
 }
 
+// src/randomize-lint.ts
+function lintRandomization(config) {
+  const errors = [];
+  const groupSize = singleGroupSize(config);
+  const check = (where, settings) => {
+    if (settings.distribute !== true)
+      return;
+    if (settings.scope !== "group") {
+      errors.push(`${where}: distribute: true needs scope: group`);
+    }
+    const conditions = settings.conditions;
+    if (!Array.isArray(conditions) || conditions.length === 0) {
+      errors.push(`${where}: distribute: true needs a conditions list`);
+      return;
+    }
+    if (groupSize !== undefined && conditions.length !== groupSize) {
+      errors.push(`${where}: distribute: true needs one condition per group member (${conditions.length} conditions, groups of ${groupSize})`);
+    }
+  };
+  config.pages?.forEach((page, pageIndex) => {
+    const pageName = page.id ?? `pages[${pageIndex}]`;
+    page.onEnter?.forEach((action, actionIndex) => {
+      const a = action;
+      if (a?.type === "randomize") {
+        check(`${pageName}.onEnter[${actionIndex}]`, a);
+      }
+    });
+    page.components?.forEach((component, componentIndex) => {
+      const c = component;
+      if (c?.type === "randomization" && c.props) {
+        check(`${pageName}.components[${componentIndex}]`, c.props);
+      }
+    });
+  });
+  return errors;
+}
+function singleGroupSize(config) {
+  const sizes = new Set;
+  if (Array.isArray(config.matchmaking)) {
+    for (const pool of config.matchmaking) {
+      const size = pool?.num_users;
+      sizes.add(typeof size === "number" ? size : 2);
+    }
+  }
+  for (const page of config.pages ?? []) {
+    for (const component of page.components ?? []) {
+      const c = component;
+      if (c?.type !== "matchmaking" || c.props?.poolId !== undefined)
+        continue;
+      const size = c.props?.num_users;
+      sizes.add(typeof size === "number" ? size : 2);
+    }
+  }
+  return sizes.size === 1 ? [...sizes][0] : undefined;
+}
+
 // src/index.ts
 var program2 = new Command;
-program2.name("pairit").description("CLI for Pairit experiment configs").version("0.3.1").option("--env <name>", "Target environment: staging or production", (value) => {
+program2.name("pairit").description("CLI for Pairit experiment configs").version("0.3.2").option("--env <name>", "Target environment: staging or production", (value) => {
   try {
     return parseEnvName(value);
   } catch (error) {
@@ -10101,6 +10157,7 @@ async function lintConfig(configPath) {
       });
     });
   }
+  errors.push(...lintRandomization(config));
   if (errors.length) {
     throw new Error(errors.join(", "));
   }
@@ -10162,6 +10219,10 @@ async function compileConfig(configPath) {
 }
 async function buildUploadPayload(configPath, options) {
   const sourceConfig = await loadConfig(configPath);
+  const randomizationErrors = lintRandomization(sourceConfig);
+  if (randomizationErrors.length) {
+    throw new Error(randomizationErrors.join(", "));
+  }
   const allowRetake = sourceConfig.allowRetake === true;
   const requireAuth = sourceConfig.requireAuth;
   const compiledPath = await compileConfig(configPath);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pairit",
-	"version": "0.3.1",
+	"version": "0.3.2",
 	"description": "CLI for the Pairit behavioral science experiment platform",
 	"type": "module",
 	"bin": {