pairit 0.3.0 → 0.3.2

package/dist/index.js

@@ -9513,9 +9513,13 @@ function getEnvName() {
   return fromEnv ? parseEnvName(fromEnv) : "production";
 }
 function getApiUrl() {
+  if (selected)
+    return ENVIRONMENTS[selected].api;
   return process2.env.PAIRIT_API_URL || ENVIRONMENTS[getEnvName()].api;
 }
 function getLabUrl() {
+  if (selected)
+    return ENVIRONMENTS[selected].lab;
   return process2.env.PAIRIT_LAB_URL || ENVIRONMENTS[getEnvName()].lab;
 }
 function getCredentialKey() {
@@ -9803,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.0").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) {
@@ -10089,8 +10149,15 @@ async function lintConfig(configPath) {
       if (!page.id) {
         errors.push(`pages[${index}] is missing id`);
       }
+      page.components?.forEach((component, componentIndex) => {
+        const column = component?.column;
+        if (column !== undefined && column !== "left" && column !== "right") {
+          errors.push(`pages[${index}].components[${componentIndex}].column must be "left" or "right"`);
+        }
+      });
     });
   }
+  errors.push(...lintRandomization(config));
   if (errors.length) {
     throw new Error(errors.join(", "));
   }
@@ -10152,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,42 +1,42 @@
 {
-  "name": "pairit",
-  "version": "0.3.0",
-  "description": "CLI for the Pairit behavioral science experiment platform",
-  "type": "module",
-  "bin": {
-    "pairit": "dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target node",
-    "lint": "tsc --noEmit",
-    "prepublishOnly": "bun run build"
-  },
-  "keywords": [
-    "experiment",
-    "behavioral-science",
-    "research",
-    "cli"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pairium/pairit.git",
-    "directory": "apps/manager/cli"
-  },
-  "homepage": "https://docs.pairium.ai/pairit/",
-  "license": "MIT",
-  "optionalDependencies": {
-    "keytar": "^7.9.0"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.1.13",
-    "@types/open": "^6.2.1",
-    "better-auth": "^1.4.7",
-    "commander": "^12.1.0",
-    "open": "^11.0.0",
-    "typescript": "^5.9.3",
-    "yaml": "^2.6.0"
-  }
+	"name": "pairit",
+	"version": "0.3.2",
+	"description": "CLI for the Pairit behavioral science experiment platform",
+	"type": "module",
+	"bin": {
+		"pairit": "dist/index.js"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "bun build src/index.ts --outdir dist --target node",
+		"lint": "tsc --noEmit",
+		"prepublishOnly": "bun run build"
+	},
+	"keywords": [
+		"experiment",
+		"behavioral-science",
+		"research",
+		"cli"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/pairium/pairit.git",
+		"directory": "apps/manager/cli"
+	},
+	"homepage": "https://docs.pairium.ai/pairit/",
+	"license": "MIT",
+	"optionalDependencies": {
+		"keytar": "^7.9.0"
+	},
+	"devDependencies": {
+		"@types/bun": "^1.1.13",
+		"@types/open": "^6.2.1",
+		"better-auth": "^1.4.7",
+		"commander": "^12.1.0",
+		"open": "^11.0.0",
+		"typescript": "^5.9.3",
+		"yaml": "^2.6.0"
+	}
 }