@flowriki/agent 0.1.0-beta.48 → 0.1.0-beta.49

package/dist/{chunk-7X54JYUL.js → chunk-4VJVDGF5.js}

@@ -649,6 +649,7 @@ import { z as z6 } from "zod";
 import { z as z7 } from "zod";
 import { z as z8 } from "zod";
 import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 var EngineSchema = z3.enum(["chromium", "firefox", "webkit", "android", "ios"]);
 var CapabilitySchema = z3.object({
   id: z3.string(),
@@ -1742,6 +1743,29 @@ var CaseUpdateRequestSchema = z9.object({
   createdAt: z9.string(),
   updatedAt: z9.string()
 }).strict();
+var RUN_PLACES = ["local", "cloud"];
+var RunWhereSchema = z10.object({
+  web: z10.enum(RUN_PLACES).default("local"),
+  android: z10.enum(RUN_PLACES).default("local"),
+  ios: z10.enum(RUN_PLACES).default("local")
+}).strict();
+var runWhereOf = (config) => {
+  const parsed = RunWhereSchema.safeParse(config?.runWhere ?? {});
+  return parsed.success ? parsed.data : RunWhereSchema.parse({});
+};
+var WEB_CLOUD_PROVIDERS = ["browserstack", "lambdatest"];
+var WEB_CLOUD_BROWSERS = ["chrome", "edge", "firefox", "webkit"];
+var WEB_CLOUD_BROWSER_NAME = { chrome: "Chrome", edge: "Edge", firefox: "Firefox", webkit: "Safari (WebKit)" };
+var WEB_CLOUD_SYSTEMS = ["Windows 11", "Windows 10", "macOS Sonoma", "macOS Ventura"];
+var WebCloudSchema = z10.object({
+  provider: z10.enum(WEB_CLOUD_PROVIDERS),
+  browser: z10.enum(WEB_CLOUD_BROWSERS).default("chrome"),
+  system: z10.enum(WEB_CLOUD_SYSTEMS).default("Windows 11")
+}).strict();
+var webCloudOf = (config) => {
+  const parsed = WebCloudSchema.safeParse(config?.webCloud);
+  return parsed.success ? parsed.data : null;
+};
 
 // ../engine-appium/dist/index.js
 import path5 from "path";
@@ -3723,8 +3747,14 @@ async function finishVideo(session, policy, evidenceDir, passed, name = "phone")
   const saved = await session.stopVideo(keep ? path6.join(evidenceDir, `video-${name}.mp4`) : null).catch(() => null);
   return saved ? [{ kind: "video", relPath: saved.relPath, bytes: saved.bytes }] : [];
 }
-async function chooseDevice(platform, mobile, asked) {
-  const chosen = asked ?? mobile.devices[platform];
+async function chooseDevice(platform, mobile, asked, where) {
+  const name = platform === "ios" ? "iOS" : "Android";
+  if (where === "cloud") {
+    const cloud = [asked, mobile.devices[platform]].find((d) => d?.kind === "cloud");
+    if (cloud) return cloud;
+    throw new Error(mobile.cloud.length ? `${name} tests run in the cloud, but no cloud phone is chosen \u2014 pick one in Settings \u2192 Platforms.` : `${name} tests run in the cloud, but no cloud device farm is connected \u2014 connect one in Settings \u2192 Platforms.`);
+  }
+  const chosen = where === "local" ? [asked, mobile.devices[platform]].find((d) => d?.kind === "local") : asked ?? mobile.devices[platform];
   if (chosen) return chosen;
   const devices = await listDevices();
   const picked = pickDevice(devices, platform);
@@ -3734,7 +3764,7 @@ async function chooseDevice(platform, mobile, asked) {
   throw new Error(platform === "ios" ? "No iPhone or simulator is available \u2014 install Xcode for simulators, or plug in an iPhone." : "No Android phone or emulator is available \u2014 start an emulator in Android Studio, or plug in a phone with USB debugging on.");
 }
 async function openMobileSession(opts) {
-  const device = await chooseDevice(opts.platform, opts.mobile, opts.device);
+  const device = await chooseDevice(opts.platform, opts.mobile, opts.device, opts.where);
   return MobileSession.open(
     { platform: opts.platform, device, mobile: opts.mobile, ...opts.fresh ? { fresh: true } : {} },
     { ...opts.resolveSecret ? { resolveSecret: opts.resolveSecret } : {}, ...opts.onProgress ? { onProgress: opts.onProgress } : {} }
@@ -3893,6 +3923,7 @@ var MobileLane = class {
         session = await openMobileSession({
           platform,
           mobile: this.opts.mobile,
+          ...this.opts.runWhere?.[platform] ? { where: this.opts.runWhere[platform] } : {},
           ...this.opts.devices?.[platform] ? { device: this.opts.devices[platform] } : {},
           ...this.opts.resolveSecret ? { resolveSecret: this.opts.resolveSecret } : {}
         });
@@ -4040,6 +4071,9 @@ export {
   PrerequisiteProblem,
   expandForRun,
   DeliveredHelperSchema,
+  runWhereOf,
+  WEB_CLOUD_BROWSER_NAME,
+  webCloudOf,
   proposeAssertions,
   hasObservableChange,
   normalizeStartUrl,

package/dist/{chunk-JUAJABZC.js → chunk-YXTWKSJ4.js}

@@ -3,6 +3,7 @@ import {
   ArtifactPolicySchema,
   AuthReferenceSchema,
   CHECKS,
+  CLOUD_PROVIDER_NAME,
   CURRENT_SCHEMA_VERSION,
   CapabilitySchema,
   DeliveredAuthSchema,
@@ -19,6 +20,7 @@ import {
   SCOPE_ROLES,
   STEP_PRESENTATION,
   TestCaseSchema,
+  WEB_CLOUD_BROWSER_NAME,
   actorIdsUsed,
   actorPreparations,
   adjacentLabelPattern,
@@ -52,6 +54,7 @@ import {
   resolveStartUrl,
   restoreDebugCase,
   runMobileSteps,
+  runWhereOf,
   sameIdentity,
   screenLines,
   sessionLanes,
@@ -60,8 +63,9 @@ import {
   stepRefusedOn,
   targetFor,
   textIndependent,
-  validateActors
-} from "./chunk-7X54JYUL.js";
+  validateActors,
+  webCloudOf
+} from "./chunk-4VJVDGF5.js";
 
 // src/engine/machine.ts
 import fs from "fs";
@@ -69,7 +73,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.48";
+var AGENT_VERSION = "0.1.0-beta.49";
 async function prepareBrowsers() {
   if (browsersReady()) {
     return { ok: true, already: true, message: "chromium is already installed" };
@@ -129,7 +133,7 @@ async function checkMachine() {
     }
   } catch {
   }
-  const { mobileDoctor: mobileDoctor2 } = await import("./dist-CZEWUTXJ.js");
+  const { mobileDoctor: mobileDoctor2 } = await import("./dist-Y36FF3R3.js");
   return {
     agentVersion: AGENT_VERSION,
     node: process.versions.node,
@@ -2078,6 +2082,8 @@ import "playwright";
 import fs32 from "fs";
 import "playwright";
 import fs42 from "fs";
+import { createRequire as createRequire22 } from "module";
+import { chromium as chromium2, firefox as firefox2, webkit as webkit2 } from "playwright";
 function makeUnique(now = Date.now()) {
   return `${now.toString(36)}${randomBytes(3).toString("hex")}`;
 }
@@ -3677,6 +3683,7 @@ async function replayFlow(opts) {
     opts.actors?.find((a) => a.id === (opts.defaultActorId ?? "default"))?.startSignedIn
   );
   const session = await openRunSession({
+    ...opts.browser ? { browser: opts.browser } : {},
     steps: [...steps, ...actorPreparations(opts.actors)],
     ...hydrated?.state ? { storageState: hydrated.state } : {},
     ...opts.resolveAuth ? { resolveAuth: opts.resolveAuth } : {},
@@ -3932,6 +3939,7 @@ async function replayCase(opts) {
     opts.actors?.find((a) => a.id === (opts.defaultActorId ?? "default"))?.startSignedIn
   );
   const session = await openRunSession({
+    ...opts.browser ? { browser: opts.browser } : {},
     steps: allSteps,
     ...caseHydrated?.state ? { storageState: caseHydrated.state } : {},
     ...opts.resolveAuth ? { resolveAuth: opts.resolveAuth } : {},
@@ -5234,6 +5242,59 @@ async function fieldNames(page) {
     return found;
   }).catch(() => []);
 }
+var playwrightVersion2 = () => {
+  try {
+    return createRequire22(import.meta.url)("playwright/package.json").version;
+  } catch {
+    return "1.latest";
+  }
+};
+function cloudBrowserEndpoint(account, key, choice, name) {
+  const type = choice.browser === "firefox" ? "firefox" : choice.browser === "webkit" ? "webkit" : "chromium";
+  const build = `Flowriki ${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`;
+  const mac = choice.system.startsWith("macOS");
+  if (account.provider === "browserstack") {
+    const caps = {
+      browser: choice.browser === "chrome" ? "chrome" : choice.browser === "edge" ? "edge" : `playwright-${type}`,
+      os: mac ? "OS X" : "Windows",
+      os_version: mac ? choice.system.replace("macOS ", "") : choice.system.replace("Windows ", ""),
+      name,
+      build,
+      project: "Flowriki",
+      "browserstack.username": account.username,
+      "browserstack.accessKey": key,
+      "client.playwrightVersion": playwrightVersion2()
+    };
+    return { type, wsEndpoint: `wss://cdp.browserstack.com/playwright?caps=${encodeURIComponent(JSON.stringify(caps))}` };
+  }
+  if (account.provider === "lambdatest") {
+    const caps = {
+      browserName: choice.browser === "chrome" ? "Chrome" : choice.browser === "edge" ? "MicrosoftEdge" : choice.browser === "firefox" ? "pw-firefox" : "pw-webkit",
+      browserVersion: "latest",
+      "LT:Options": {
+        platform: mac ? choice.system : choice.system,
+        build,
+        name,
+        project: "Flowriki",
+        user: account.username,
+        accessKey: key,
+        playwrightClientVersion: playwrightVersion2()
+      }
+    };
+    return { type, wsEndpoint: `wss://cdp.lambdatest.com/playwright?capabilities=${encodeURIComponent(JSON.stringify(caps))}` };
+  }
+  throw new Error(`${CLOUD_PROVIDER_NAME[account.provider]} cannot run a website's tests remotely \u2014 choose BrowserStack or LambdaTest for the web`);
+}
+async function connectCloudBrowser(account, key, choice, name) {
+  const { type, wsEndpoint } = cloudBrowserEndpoint(account, key, choice, name);
+  const engine = { chromium: chromium2, firefox: firefox2, webkit: webkit2 }[type];
+  try {
+    return await engine.connect(wsEndpoint, { timeout: 12e4 });
+  } catch (error) {
+    const said = error.message.split("\n")[0] ?? "";
+    throw new Error(`${CLOUD_PROVIDER_NAME[account.provider]} could not open ${WEB_CLOUD_BROWSER_NAME[choice.browser]} on ${choice.system}: ${said.replace(key, "\u2022\u2022\u2022\u2022")}`);
+  }
+}
 
 // ../results/dist/chunk-LYCTVHPR.js
 import { z as z3 } from "zod";
@@ -6096,7 +6157,7 @@ function toSummary(row) {
   };
 }
 
-// ../repository-store/dist/chunk-7ZXMHRUH.js
+// ../repository-store/dist/chunk-7ZZULR2K.js
 var FLOWRIKI_DIR = ".flowriki";
 var FEATURES_DIR = `${FLOWRIKI_DIR}/features`;
 var CONFIG_PATH = `${FLOWRIKI_DIR}/config.json`;
@@ -6148,7 +6209,9 @@ function parseConfig(raw) {
     artifacts: ArtifactPolicySchema.parse(source["artifacts"] ?? {}),
     flakinessRepeat: clampRepeat(source["flakinessRepeat"]),
     platforms: platformsOf(source),
-    mobile: mobileOf(source)
+    mobile: mobileOf(source),
+    runWhere: runWhereOf(source),
+    ...webCloudOf(source) ? { webCloud: webCloudOf(source) } : {}
   };
 }
 function readEnvironments(raw) {
@@ -7095,6 +7158,17 @@ async function runHelper(helper, ctx) {
 // ../execution/dist/index.js
 import fs24 from "fs";
 import crypto3 from "crypto";
+async function cloudBrowserFor(config, secrets, name) {
+  const settings = config ?? {};
+  if (runWhereOf(settings).web !== "cloud") return null;
+  const choice = webCloudOf(settings);
+  if (!choice) throw new Error("This project runs websites in the cloud, but no cloud browser is chosen \u2014 pick one in Settings \u2192 Platforms.");
+  const account = mobileOf(settings).cloud.find((c) => c.provider === choice.provider);
+  if (!account) throw new Error(`${CLOUD_PROVIDER_NAME[choice.provider]} is not connected to this project \u2014 connect it in Settings \u2192 Platforms.`);
+  const key = secrets[account.keyRef];
+  if (!key) throw new Error(`The ${CLOUD_PROVIDER_NAME[choice.provider]} access key was not sent with this run \u2014 set it again in Settings \u2192 Platforms.`);
+  return connectCloudBrowser(account, key, choice, name);
+}
 var LOCAL_CHROMIUM = { id: "chromium", provider: "local", engine: "chromium" };
 async function executeFlow(opts) {
   const { store, storage = null, flowId, trigger, watch = false, onEvent } = opts;
@@ -7151,6 +7225,7 @@ async function executeFlow(opts) {
     mobile: mobileOf(store.readConfig()),
     steps: o.steps,
     startPath: flow.startPath,
+    where: runWhereOf(store.readConfig())[platform],
     ...opts.device ? { device: opts.device } : {},
     resolveSecret: o.resolveSecret,
     resolveAuth: o.resolveAuth,
@@ -7160,7 +7235,21 @@ async function executeFlow(opts) {
     screenshots: o.artifacts?.screenshot ?? "on-failure",
     signal: o.signal,
     video: { mode: o.artifacts?.video ?? "off", allowUnmasked: o.artifacts?.allowUnmaskedArtifacts === true }
-  }) : replayFlow(o);
+  }) : runWebsite(o);
+  const runWebsite = async (o) => {
+    let cloud = null;
+    try {
+      cloud = await cloudBrowserFor(store.readConfig(), secrets, flow.name);
+    } catch (error) {
+      return { status: "errored", error: error.message, durationMs: 0, stepsRun: 0, stepsTotal: o.steps.length, steps: [] };
+    }
+    if (!cloud) return replayFlow(o);
+    try {
+      return await replayFlow({ ...o, browser: cloud, artifacts: { ...o.artifacts, video: "off", trace: "off" } });
+    } finally {
+      await cloud.close().catch(() => void 0);
+    }
+  };
   const byId = new Map(flow.steps.map((s2) => [s2.id, s2]));
   const attempts = [];
   const perStep = /* @__PURE__ */ new Map();
@@ -7521,12 +7610,23 @@ async function executeCase(opts) {
     ...config.artifacts?.screenshot ? { screenshots: config.artifacts.screenshot } : {},
     ...opts.signal ? { signal: opts.signal } : {},
     video: { mode: config.artifacts?.video ?? "off", allowUnmasked: config.artifacts?.allowUnmaskedArtifacts === true },
-    allSteps: phoneRows.flatMap((o) => o.steps)
+    allSteps: phoneRows.flatMap((o) => o.steps),
+    runWhere: runWhereOf(config)
   };
   const lane = phoneRows.length && phoneRows.length < testCase.occurrences.length ? new MobileLane(laneOptions) : null;
+  let cloud = null;
+  let cloudProblem = null;
+  if (phoneRows.length < testCase.occurrences.length) {
+    try {
+      cloud = await cloudBrowserFor(config, secrets, testCase.name);
+    } catch (error) {
+      cloudProblem = error.message;
+    }
+  }
   const opened = /* @__PURE__ */ new Set();
   let outcome;
   try {
+    if (cloudProblem) throw new Error(cloudProblem);
     if (phoneRows.length === testCase.occurrences.length) {
       outcome = await replayMobileCase({
         ...laneOptions,
@@ -7535,6 +7635,7 @@ async function executeCase(opts) {
         onStepResult: recordStep
       });
     } else outcome = await replayCase({
+      ...cloud ? { browser: cloud } : {},
       ...lane ? {
         runElsewhere: (occurrence, ctx) => {
           if (!isMobile(occurrence.platform)) return null;
@@ -7556,7 +7657,7 @@ async function executeCase(opts) {
       ...opts.watch ? { slowMo: 400 } : {},
       resolveSecret: (ref) => secrets[ref],
       ...opts.resolveFile ? { resolveFile: opts.resolveFile } : {},
-      ...config.artifacts ? { artifacts: config.artifacts } : {},
+      ...config.artifacts ? { artifacts: cloud ? { ...config.artifacts, video: "off", trace: "off" } : config.artifacts } : {},
       ...runDir ? { evidenceDir: runDir } : {},
       ...opts.signal ? { signal: opts.signal } : {},
       onStepResult: recordStep
@@ -7585,6 +7686,7 @@ async function executeCase(opts) {
       }))
     };
   }
+  await cloud?.close().catch(() => void 0);
   if (lane) outcome = { ...outcome, artifacts: [...outcome.artifacts ?? [], ...await lane.close(outcome.status === "passed")] };
   await Promise.all(writes);
   if (storage && run) {
@@ -8069,6 +8171,7 @@ async function verifyFlowSteps(deps, opts) {
         mobile: mobileOf(store.readConfig()),
         steps,
         startPath: flow.startPath,
+        where: runWhereOf(store.readConfig())[flow.platform],
         ...store.resolveAuth ? { resolveAuth: store.resolveAuth } : {},
         ...store.runHelper ? { runHelper: store.runHelper } : {},
         resolveSecret: (ref) => secrets[ref],
@@ -9731,7 +9834,13 @@ function mobileHandlers(ctx) {
           const config = command.args["config"] ?? {};
           const secrets = command.args["secrets"] ?? {};
           const device = command.args["device"] ? DeviceChoiceSchema.parse(command.args["device"]) : void 0;
-          const session = await openMobileSession({ platform, mobile: mobileOf(config), ...device ? { device } : {}, resolveSecret: (ref) => secrets[ref] });
+          const session = await openMobileSession({
+            platform,
+            mobile: mobileOf(config),
+            ...device ? { device } : {},
+            resolveSecret: (ref) => secrets[ref],
+            where: runWhereOf(config)[platform]
+          });
           const typed = /* @__PURE__ */ new Map();
           const l2 = {
             id: randomUUID2(),

package/dist/cli.js

@@ -23,7 +23,7 @@ import {
   runtimeValue,
   start,
   status
-} from "./chunk-JUAJABZC.js";
+} from "./chunk-YXTWKSJ4.js";
 import {
   CLOUD_PROVIDERS,
   CLOUD_PROVIDER_NAME,
@@ -46,7 +46,7 @@ import {
   screenLines,
   stepRefusedOn,
   targetFor
-} from "./chunk-7X54JYUL.js";
+} from "./chunk-4VJVDGF5.js";
 
 // src/cli.ts
 import { parseArgs } from "util";
@@ -988,6 +988,7 @@ Review and publish it here: ${review}`;
     this.mobile = await openMobileSession({
       platform,
       mobile,
+      ...catalog.runWhere ? { where: catalog.runWhere[platform] } : {},
       ...draft.device ? { device: draft.device } : {},
       ...resolvers ? { resolveSecret: resolvers.resolveSecret } : {}
     });
@@ -1407,12 +1408,12 @@ It is now the project these tools work on. Open it: ${service.origin}/projects/$
           const chosen = c.mobile?.devices[p];
           return `${p === "android" ? "Android" : "iOS"} app: ${app ?? "(not set up \u2014 Settings \u2192 Mobile)"}
   Phones on this computer: ${here.length ? here.map((d) => `${d.name}${d.state === "ready" ? "" : ` (${d.state})`}`).join(", ") : "none"}` + (farms.length ? `
-  Cloud device farms: ${farms.join(", ")}` : "") + (chosen ? `
-  Runs go to: ${chosen.kind === "local" ? chosen.name || chosen.id : `${CLOUD_PROVIDER_NAME[chosen.provider]}: ${chosen.device}`}` : "");
+  Cloud device farms: ${farms.join(", ")}` : "") + `
+  Runs: ${c.runWhere?.[p] === "cloud" ? "in the cloud" : "on this computer"}` + (chosen ? ` \u2014 ${chosen.kind === "local" ? chosen.name || chosen.id : `${CLOUD_PROVIDER_NAME[chosen.provider]}: ${chosen.device}`}` : "");
         });
         return text([
           `Project ${projectId}. Tests: ${[platforms.web && "web", platforms.android && "Android app", platforms.ios && "iOS app"].filter(Boolean).join(", ")}.`,
-          platforms.web ? `Base URL: ${c.baseUrl || "(not set)"}` : "",
+          platforms.web ? `Base URL: ${c.baseUrl || "(not set)"}${c.runWhere?.web === "cloud" ? " \u2014 test runs use a cloud browser; recording is on this computer" : ""}` : "",
           ...phoneLines,
           c.environments.length ? `Environments: ${c.environments.map((e) => `${e.name} ${e.baseUrl}`).join(", ")}` : "",
           `

package/dist/{dist-CZEWUTXJ.js → dist-Y36FF3R3.js}

@@ -44,7 +44,7 @@ import {
   textOf,
   toolEnv,
   typesSecrets
-} from "./chunk-7X54JYUL.js";
+} from "./chunk-4VJVDGF5.js";
 export {
   AGENT_HOME,
   APPIUM_DIR,

package/dist/engine.js

@@ -9,8 +9,8 @@ import {
   resolveCheckouts,
   start,
   status
-} from "./chunk-JUAJABZC.js";
-import "./chunk-7X54JYUL.js";
+} from "./chunk-YXTWKSJ4.js";
+import "./chunk-4VJVDGF5.js";
 export {
   AGENT_VERSION,
   browsersReady,

package/package.json

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