@flowriki/agent 0.1.0-beta.30 → 0.1.0-beta.31

package/dist/{chunk-JYXRKBN5.js → chunk-XSH3IU5Y.js}

@@ -6,7 +6,7 @@ import os from "os";
 import path from "path";
 import { createRequire } from "module";
 import { spawnSync } from "child_process";
-var AGENT_VERSION = "0.1.0-beta.30";
+var AGENT_VERSION = "0.1.0-beta.31";
 async function prepareBrowsers() {
   if (browsersReady()) {
     return { ok: true, already: true, message: "chromium is already installed" };
@@ -462,6 +462,7 @@ import fs7 from "fs";
 import path7 from "path";
 
 // ../engine-playwright/dist/index.js
+import { randomBytes } from "crypto";
 import path3 from "path";
 
 // ../test-model/dist/chunk-GALEMMJW.js
@@ -1719,7 +1720,7 @@ var DeliveredHelperSchema = z42.object({
 }).strict();
 
 // ../engine-playwright/dist/index.js
-import { createHmac, randomBytes } from "crypto";
+import { createHmac, randomBytes as randomBytes2 } from "crypto";
 import { errors as errors2 } from "playwright";
 
 // ../core/dist/index.js
@@ -3505,11 +3506,20 @@ import { fileURLToPath } from "url";
 import "playwright";
 import fs32 from "fs";
 import "playwright";
+function makeUnique(now = Date.now()) {
+  return `${now.toString(36)}${randomBytes(3).toString("hex")}`;
+}
+function runtimeValue(values, name) {
+  if (values.has(name)) return values.get(name);
+  if (name === "unique") {
+    const value = makeUnique();
+    values.set(name, value);
+    return value;
+  }
+  throw new Error(`Runtime value "${name}" has not been captured yet`);
+}
 function withRuntimeValues(step, values) {
-  const expand = (text) => text.replace(/\{\{([a-zA-Z][a-zA-Z0-9_]*)\}\}/g, (_, name) => {
-    if (!values.has(name)) throw new Error(`Runtime value "${name}" has not been captured yet`);
-    return values.get(name);
-  });
+  const expand = (text) => text.replace(/\{\{([a-zA-Z][a-zA-Z0-9_]*)\}\}/g, (_, name) => runtimeValue(values, name));
   return {
     ...step,
     value: step.secret ? step.value : expand(step.value),
@@ -3525,10 +3535,8 @@ async function performHelperStep(page, step, options) {
   if (!options.runHelper) {
     throw new Error("helpers run only on runs started from the dashboard \u2014 this machine was not sent any");
   }
-  const inputs = Object.fromEntries(Object.entries(helper.inputs ?? {}).map(([name, text]) => [name, text.replace(NAME, (_, used) => {
-    if (!options.values.has(used)) throw new Error(`Runtime value "${used}" has not been captured yet`);
-    return options.values.get(used);
-  })]));
+  const inputs = Object.fromEntries(Object.entries(helper.inputs ?? {}).map(([name, text]) => [name, text.replace(NAME, (_, used) => runtimeValue(options.values, used))]));
+  inputs["unique"] ??= runtimeValue(options.values, "unique");
   const got = await options.runHelper(helper.helperId, inputs);
   if (got.value.length > 16384) throw new Error("The helper's value is over 16 KB");
   options.values.set(helper.saveAs, got.value);
@@ -3561,7 +3569,7 @@ function authenticationResolver(input) {
     return matches[0];
   };
 }
-var PEPPER = randomBytes(32);
+var PEPPER = randomBytes2(32);
 function preparationKey(identity) {
   const material = JSON.stringify([
     identity.scope,
@@ -11210,6 +11218,7 @@ export {
   resolveService,
   connect,
   RecordedStepSchema,
+  runtimeValue,
   authenticationResolver,
   checkAssertion,
   openRunSession,

package/dist/cli.js

@@ -16,9 +16,10 @@ import {
   replayFlow,
   resolveCheckouts,
   resolveService,
+  runtimeValue,
   start,
   status
-} from "./chunk-JYXRKBN5.js";
+} from "./chunk-XSH3IU5Y.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -340,8 +341,10 @@ ${await this.snapshot()}`;
       ...input.op && input.op !== "equals" ? { op: input.op } : {},
       ...input.role ? { target: { role: input.role, name: input.name ?? "", ...scopeOf(input.within) } } : {}
     });
+    const filled = (text2) => text2.replace(/\{\{([a-zA-Z][a-zA-Z0-9_]*)\}\}/g, (_, name) => runtimeValue(this.values, name));
+    const expected = Array.isArray(assertion.value) ? assertion.value.map(filled) : filled(assertion.value);
     try {
-      await checkAssertion(page, assertion.kind, assertion.value, 5e3, assertion);
+      await checkAssertion(page, assertion.kind, expected, 5e3, { ...assertion, value: expected });
     } catch (error) {
       throw new Error(`That is not true of the page right now, so it was not kept: ${error.message.split("\n")[0]}`);
     }
@@ -499,8 +502,11 @@ How to write a good Flowriki test:
    step fails there, fix it (remove_step, act again) and replay again.
 8. Save with save_flow and give the person the review link it returns.
 Test data you invent (a new user's email or password for a sign-up) is fine to
-type; prefer an address the project's mailbox helper can read, such as
-qa+something@ the mailbox's own domain.`;
+type. For anything that must be NEW on every run \u2014 a sign-up's email or
+username \u2014 use {{unique}}: it is different on every run and the same within
+one, e.g. qa+{{unique}}@ the domain of the project's mailbox helper, so the
+helper can read that address's verification email with {"email": "qa+{{unique}}@\u2026"}.
+A test that types a fixed new email passes once and fails every run after.`;
 var text = (value, isError = false) => ({ content: [{ type: "text", text: value }], ...isError ? { isError } : {} });
 var str = (value) => typeof value === "string" ? value : value === void 0 || value === null ? void 0 : String(value);
 function authoringTools(service, session) {

package/dist/engine.js

@@ -9,7 +9,7 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-JYXRKBN5.js";
+} from "./chunk-XSH3IU5Y.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowriki/agent",
-  "version": "0.1.0-beta.30",
+  "version": "0.1.0-beta.31",
   "description": "Run Flowriki UI tests on your own computer. Connects this machine to your Flowriki account.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",