@visualautomate/cli 0.4.0 → 0.5.0

package/README.md

@@ -4,14 +4,14 @@ Build and publish VisualAutomate plugins.
 
 ```bash
 npm install -g @visualautomate/cli
-visualautomate login
-visualautomate init my-step
+vsa login
+vsa init my-step
 cd my-step
-visualautomate dev      # run it on every save
-visualautomate push
+vsa dev                 # the sandbox, and a run again on every save
+vsa push
 ```
 
-`va` is the same command, shorter.
+`va` and `visualautomate` are the same command.
 
 That is the whole toolchain. There is nothing else to install: the CLI carries
 the SDK inside it, compiles your TypeScript itself, and writes the type
@@ -85,14 +85,18 @@ unbundled, because that is the file the sandbox loads.
 
 ## `dev`
 
-`test`, and again on every save. Only the module whose folder changed runs
-again; a change anywhere else runs them all. Ctrl+C stops it.
-
 ```bash
-va dev
-va dev --module send-message
+vsa dev
+vsa dev --module send-message
+vsa dev --tier boosted
+vsa dev --local            # on this machine's Node, without the sandbox
 ```
 
+Everything in one command: it starts Docker if it is not running, fetches the
+sandbox image the first time, runs every module, and runs them again on every
+save. Only the module whose folder changed runs again; a change anywhere else
+runs them all. Ctrl+C stops it.
+
 `context.connections` and `context.media` are **not** simulated. One is
 somebody's OAuth account and the other is an ffmpeg container; pretending to be
 either would produce a plugin that passes here and fails on a canvas. Asking for
@@ -140,14 +144,17 @@ Keeps storage and state between runs, in `.visualautomate/` next to the plugin:
 Once that folder exists it is used without the flag. Delete it to start over,
 and add it to `.gitignore`.
 
-## `--docker`: the sandbox on your machine
+## The sandbox on your machine
+
+`dev` uses it by default; `test` does with `--docker`:
 
 ```bash
-va test --docker
-va dev --docker --tier boosted
+vsa dev
+vsa test --docker
+vsa dev --tier boosted
 ```
 
-Runs the test inside the plugin sandbox image,
+Your plugin runs inside the plugin sandbox image,
 `ghcr.io/visualautomate/plugin-sandbox`, at the version of this CLI:
 
 - the Node version the platform runs plugins on, with every allowed npm
@@ -157,10 +164,12 @@ Runs the test inside the plugin sandbox image,
 - no Linux capabilities, a read-only filesystem apart from your project and a
   small `/tmp`, and nothing else from your machine.
 
-A step that runs out of memory or time here does the same on the platform. Docker
-must be running. `--image` uses a different image, for example one you built
-yourself. With `dev`, the watcher stays on your machine and each run starts a
-fresh container.
+A step that runs out of memory or time here does the same on the platform.
+
+Docker does not have to be running: `dev` starts Docker Desktop and waits for it,
+then fetches the image if this machine does not have it. `--image` uses a
+different image, for example one you built yourself. The watcher stays on your
+machine, and each run starts a fresh container.
 
 `context.media` is not available locally, in or out of Docker.
 

package/dist/index.js

@@ -1999,7 +1999,7 @@ function permits(policy, host) {
   return policy.hosts.some((allowed) => host === allowed || host.endsWith(`.${allowed}`));
 }
 function guardFetch(policy, base, onDenied) {
-  return (resource, init) => {
+  return ((resource, init) => {
     const raw = typeof resource === "string" ? resource : resource instanceof URL ? resource.href : resource.url;
     const host = hostOf(raw);
     if (host && !permits(policy, host)) {
@@ -2011,7 +2011,7 @@ function guardFetch(policy, base, onDenied) {
       }
     }
     return base(resource, init);
-  };
+  });
 }
 
 // src/persist.ts
@@ -2139,6 +2139,35 @@ function explainExit(code, tier) {
   if (code === 125) return "\u2717 Docker could not start the container. Is the image available? Try: docker pull " + IMAGE;
   return null;
 }
+function ensureDocker(say, waitMs = 12e4) {
+  const problem = dockerProblem();
+  if (!problem) return null;
+  if (problem.includes("not installed")) return problem;
+  say("Docker is not running. Starting Docker Desktop\u2026");
+  const started = spawnSync("docker", ["desktop", "start"], { encoding: "utf8" });
+  if (started.status !== 0) {
+    say("Could not start it from here \u2014 start Docker Desktop yourself; this will carry on when it is up.");
+  }
+  const until = Date.now() + waitMs;
+  while (Date.now() < until) {
+    spawnSync(process.execPath, ["-e", "setTimeout(() => {}, 1000)"]);
+    if (!dockerProblem()) {
+      say("Docker is ready.");
+      return null;
+    }
+  }
+  return "Docker did not come up in time. Start Docker Desktop and try again.";
+}
+function hasImage(image) {
+  return spawnSync("docker", ["image", "inspect", image], { stdio: "ignore" }).status === 0;
+}
+function pullImage(image, say) {
+  if (hasImage(image)) return null;
+  say(`Fetching ${image} \u2014 once, about 700 MB.`);
+  const pulled = spawnSync("docker", ["pull", image], { stdio: "inherit" });
+  if (pulled.status === 0) return null;
+  return `Could not fetch ${image}. Check your connection, or pass --image with one you have.`;
+}
 function runInDocker(run) {
   const result = spawnSync("docker", dockerArgs(run), { stdio: "inherit" });
   const code = result.status ?? 1;
@@ -2148,7 +2177,7 @@ function runInDocker(run) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.4.0" : "0.0.0-dev";
+var VERSION = true ? "0.5.0" : "0.0.0-dev";
 var DEFAULT_API_URL = "https://visualautomate.com";
 function configPath() {
   return join3(homedir(), ".visualautomate", "config.json");
@@ -2472,9 +2501,16 @@ function packageLoader(dir) {
     }
   };
 }
+function imageFor(flags) {
+  return flags.image || `${IMAGE}:${VERSION}`;
+}
+function prepareSandbox(flags) {
+  const docker = ensureDocker(ok);
+  if (docker) fail(docker);
+  const image = pullImage(imageFor(flags), ok);
+  if (image) fail(image);
+}
 function dockerRunFor(flags, args) {
-  const problem = dockerProblem();
-  if (problem) fail(problem);
   let tier;
   try {
     tier = tierOf(flags.tier);
@@ -2483,7 +2519,7 @@ function dockerRunFor(flags, args) {
   }
   return {
     cwd: process.cwd(),
-    image: flags.image || `${IMAGE}:${VERSION}`,
+    image: imageFor(flags),
     tier,
     args,
     user: typeof process.getuid === "function" && typeof process.getgid === "function" ? { uid: process.getuid(), gid: process.getgid() } : void 0
@@ -2511,19 +2547,22 @@ function targetsOrFail(flags) {
 }
 async function cmdTest(flags) {
   const targets = targetsOrFail(flags);
+  if (flags.docker) prepareSandbox(flags);
   const passed = flags.docker ? runTargetsInDocker(targets, targets, flags) : await runTargets(targets, flags);
   if (!passed) process.exitCode = 1;
 }
 async function cmdDev(flags) {
   const root = process.cwd();
   let targets = targetsOrFail(flags);
+  const inSandbox = flags.local !== "true";
+  if (inSandbox) prepareSandbox(flags);
   const header = () => {
     process.stdout.write("\x1Bc");
-    ok(`visualautomate dev \u2014 ${(/* @__PURE__ */ new Date()).toLocaleTimeString()} \u2014 Ctrl+C to stop`);
+    ok(`vsa dev \u2014 ${(/* @__PURE__ */ new Date()).toLocaleTimeString()} \u2014 Ctrl+C to stop`);
   };
-  const run = async (chosen) => flags.docker ? runTargetsInDocker(chosen, targets, flags) : runTargets(chosen, flags);
+  const run = async (chosen) => inSandbox ? runTargetsInDocker(chosen, targets, flags) : runTargets(chosen, flags);
   header();
-  if (flags.docker) ok(`in ${flags.image || `${IMAGE}:${VERSION}`}, tier ${flags.tier || "standard"}`);
+  ok(inSandbox ? `in ${imageFor(flags)}, tier ${flags.tier || "standard"}` : "on this machine, not in the sandbox");
   await run(targets);
   const ignored = [`${sep2}node_modules${sep2}`, `${sep2}.git${sep2}`, `${sep2}dist${sep2}`, `${sep2}.visualautomate${sep2}`];
   const pending = /* @__PURE__ */ new Set();
@@ -2656,16 +2695,18 @@ ${text.slice(0, 500)}`);
 }
 function printHelp() {
   console.log(`
-visualautomate \u2014 build and publish plugins
+vsa \u2014 build and publish VisualAutomate plugins
+
+  vsa login                    sign this machine in
+  vsa init <name> [--template] start a plugin
+  vsa dev [--module <name>]    the sandbox, and a run again on every save
+  vsa test [--module <name>]   run it once, as the platform's check does
+  vsa push                     publish it
+  vsa whoami                   which account this is
+  vsa logout                   forget the token
+  vsa --version                this CLI's version
 
-  visualautomate login                    sign this machine in
-  visualautomate init <name> [--template] start a plugin
-  visualautomate test [--module <name>]   run it here, as the platform's check does
-  visualautomate dev [--module <name>]    run it again on every save
-  visualautomate --version                this CLI's version
-  visualautomate push                     publish it
-  visualautomate whoami                   which account this is
-  visualautomate logout                   forget the token
+\`va\` and \`visualautomate\` are the same command.
 
 Templates: ${Object.keys(TEMPLATES).join(", ")}
 
@@ -2674,11 +2715,13 @@ GitHub repository, and at the root of an app's repository, where every folder
 in modules/ is run (or the one named with --module). The run's settings come
 from visualautomate.test.json, test.json, or --input <file>.
 
-Options for \`test\` and \`dev\`:
-  --docker             run inside the plugin sandbox image (Docker must be running)
-  --tier <name>        with --docker: standard, boosted, high or max
-  --image <ref>        with --docker: a different image
+Options for \`dev\` and \`test\`:
+  --module <name>      one folder of modules/ instead of all of them
+  --tier <name>        the sandbox's size: standard, boosted, high or max
+  --image <ref>        a different sandbox image
   --persist            keep storage and state in .visualautomate/ between runs
+  --local              \`dev\` without the sandbox, on this machine's Node
+  --docker             \`test\` inside the sandbox, as \`dev\` does
 
 Environment (for CI, where there is no browser):
   VISUALAUTOMATE_API_TOKEN   use instead of \`login\`

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@visualautomate/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Build and publish VisualAutomate plugins.",
   "license": "MIT",
   "type": "module",
   "bin": {
-    "visualautomate": "./dist/index.js",
-    "va": "./dist/index.js"
+    "visualautomate": "dist/index.js",
+    "va": "dist/index.js",
+    "vsa": "dist/index.js"
   },
   "files": [
     "dist",
@@ -26,7 +27,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "esbuild": "^0.23.0"
+    "esbuild": "^0.28.2"
   },
   "devDependencies": {
     "@types/node": "^22",