devicerent 0.1.0 → 0.2.1

package/README.md

@@ -1,9 +1,54 @@
 # devicerent
 
 DeviceRent from your terminal. Rent a **real** Android phone by the minute,
-install your APK, run Espresso or a Quick test, get a hosted Appium URL, or hand
+install your APK, run a Quick test or Espresso, get a hosted Appium URL, or hand
 the phone to DeviceyAI — everything the website does except show you the live
-screen.
+screen. You don't need to know how to code to use it.
+
+## Start here
+
+You need [Node.js](https://nodejs.org) 22 or newer (the LTS download). Then open
+a terminal — on Windows press Start and type **Terminal**, on a Mac press ⌘-Space
+and type **Terminal** — and type:
+
+```bash
+npx devicerent
+```
+
+That opens a guided session:
+
+```
+╭──────────────────────────────────────────────────╮
+│ ✻ Welcome to DeviceRent                          │
+│   Real Android phones, rented by the minute.     │
+│   you@example.com · Pro · Wallet €12.50          │
+╰──────────────────────────────────────────────────╯
+╭──────────────────────────────────────────────────╮
+│ > rent a phone                                   │
+╰──────────────────────────────────────────────────╯
+  / for commands · ? for help          no phone rented
+```
+
+Then just say what you want, in plain words:
+
+| Type | What happens |
+| --- | --- |
+| `rent` | Pick a phone from a menu; it shows **your** price and asks before billing starts |
+| *drag your `.apk` onto the window* | Installs it on the rented phone, then offers to open it |
+| `test my app` | The Quick test: opens your app, taps around, reports any crash |
+| `take a screenshot` | Saves a picture of the phone's screen to Downloads and opens it |
+| `open Settings and turn on dark mode` | Anything else in plain words goes to DeviceyAI, which does it on the phone (it asks first, and uses AI credits) |
+| `I'm done` | Stops the rental (it asks first; the phone is wiped afterwards) |
+| `balance` · `topup` · `plans` | Your wallet and plan; payment opens Stripe in your browser |
+| `/` | Every command, with a live menu — ↑↓ to choose, Enter to run |
+
+Leaving with a phone still rented asks whether to stop it first. Arrow keys,
+Enter and Esc work in every menu; Ctrl-C stops whatever is running.
+
+## One command at a time (scripts and CI)
+
+Every command also works on its own, exactly as before, and that is what
+scripts and CI should use:
 
 ```bash
 npm install -g devicerent      # Node 22 or newer
@@ -15,6 +60,11 @@ devicerent test quick com.example.app --report quick-test.md
 devicerent stop
 ```
 
+`devicerent` with no command opens the guided session only when a person is at
+a terminal. Piped, with `--json`, under `CI`, or with
+`DEVICERENT_NO_INTERACTIVE=1`, it prints the help text instead, and every
+command's output and exit code are unchanged.
+
 ## Signing in
 
 `devicerent login` opens `devicerent.net` in your browser and asks you to

package/bin/devicerent.mjs

@@ -2,4 +2,19 @@
 // The published entry point. Everything lives in the bundle `npm run build`
 // writes to dist/ — the CLI imports the web app's own device and DeviceyAI
 // modules from src/lib, so it cannot run from source without the bundler.
-import "../dist/devicerent.mjs";
+//
+// The Node version is checked FIRST, and the bundle loaded with a dynamic
+// import (a static one would be hoisted above the check): on an old Node the
+// bundle dies with an error nobody can act on, and the people this tool is
+// for are told what to install instead.
+import { loadFailedMessage, nodeTooOld, tooOldMessage } from "./nodeCheck.mjs";
+
+if (nodeTooOld(process.version)) {
+  process.stderr.write(tooOldMessage(process.version));
+  process.exitCode = 1;
+} else {
+  import("../dist/devicerent.mjs").catch((err) => {
+    process.stderr.write(loadFailedMessage(err));
+    process.exitCode = 1;
+  });
+}

package/bin/nodeCheck.mjs

@@ -0,0 +1,36 @@
+// Kept to syntax every Node from 12 on can parse: this file has to run on the
+// old Node it is warning about.
+
+export var MIN_NODE_MAJOR = 22;
+
+/** True when `version` ("v20.11.1" or "20.11.1") is older than we support. */
+export function nodeTooOld(version) {
+  var major = Number(String(version).replace(/^v/, "").split(".")[0]);
+  return !(major >= MIN_NODE_MAJOR);
+}
+
+export function tooOldMessage(version) {
+  return (
+    "DeviceRent needs Node.js " +
+    MIN_NODE_MAJOR +
+    " or newer, and this computer has " +
+    version +
+    ".\n" +
+    "Install the LTS version from https://nodejs.org, open a new terminal, then run: npx devicerent\n"
+  );
+}
+
+/**
+ * The bundle itself failed to load: a file missing from a broken install, or
+ * a dependency whose download did not finish. One sentence and what to do,
+ * not a stack trace.
+ */
+export function loadFailedMessage(err) {
+  var first = String((err && err.message) || err).split("\n")[0];
+  return (
+    "DeviceRent could not start: " +
+    first +
+    "\n" +
+    "Reinstall it and try again: npx devicerent@latest  (or, if you installed it: npm install -g devicerent@latest)\n"
+  );
+}