@exedev/sdk 0.0.6 → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bold Software, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -15,27 +15,21 @@ import exedev from "@exedev/sdk";
 
 const exe = exedev({ token: process.env.EXE_TOKEN! });
 
-// List all VMs
-const vms = await exe.ls();
-console.log(vms);
-
-// Get your identity
-const me = await exe.whoami();
-console.log(me.email);
-
-// Create a VM
-await exe.new("my-vm", { region: "lon" });
-
-// Get VM details
-const info = await exe.stat("my-vm");
-console.log(info);
+// Every exe.dev command is a method. Positional arguments are parameters;
+// flags go in an options object, spelled as on the command line.
+const vm = await exe.new({ name: "my-vm", image: "ubuntu:24.04", tag: ["dev"] });
+console.log(vm.https_url);
+
+const { vms } = await exe.ls();
+await exe.resize("my-vm", { memory: "8GB" });
+await exe.pause("my-vm");
+await exe.resume("my-vm");
+await exe.shareAdd("my-vm", "friend@example.com", { message: "have a look" });
+await exe.rm("my-vm");
 
-// Run any command
+// Run a raw command line.
 const result = await exe.exec("help");
 console.log(result.body);
-
-// Delete a VM
-await exe.rm("my-vm");
 ```
 
 ## Authentication
@@ -43,7 +37,7 @@ await exe.rm("my-vm");
 Generate an API token via SSH:
 
 ```sh
-ssh exe.dev token
+ssh exe.dev ssh-key generate-api-key --label=my-app --exp=30d
 ```
 
 See the [HTTPS API docs](https://exe.dev/docs/https-api) for full details on
@@ -57,23 +51,24 @@ authentication, token permissions, and scoping.
 | --------- | ------ | -------- | ------------------- |
 | `token`   | string | Yes      |                     |
 | `baseURL` | string | No       | `https://exe.dev`   |
+| `fetch`   | function | No     | global `fetch`      |
 
-### Methods
+### Commands
 
-| Method | Description |
-| --- | --- |
-| `exec(command)` | Run any command (raw) |
-| `ls()` | List VMs |
-| `whoami()` | Get authenticated user |
-| `stat(vmName)` | Get VM details |
-| `new(name, options?)` | Create a VM |
-| `rm(vmName)` | Delete a VM |
-| `restart(vmName)` | Restart a VM |
-| `rename(oldName, newName)` | Rename a VM |
-| `sshKeyList()` | List SSH keys |
-| `shareShow(vmName)` | Show sharing settings |
+Each public exe.dev command that runs over the HTTPS API is a method, named by
+camel-casing its path: `ls`, `new`, `ssh-key list` is `sshKeyList`,
+`team settings auto-join` is `teamSettingsAutoJoin`. Each method's doc comment
+is the command's own help text, so `help <command>` and your editor agree.
 
-All methods accept an optional `{ signal: AbortSignal }` as the last argument for cancellation.
+Methods resolve to the command's JSON output, typed for the commands listed in
+`CommandResults` (`src/types.ts`) and `unknown` otherwise. They reject with
+`ExeAPIError` (`status`, `command`, `body`) when a command fails. Every
+options object accepts `signal` (an `AbortSignal`) for cancellation.
+
+The command methods live in `src/commands.gen.ts`, which is generated from the
+exe.dev command tree; don't edit it by hand. To pick up new commands, run
+`npm run sync-commands -- path/to/exe` (default `../exe`) with an up-to-date
+checkout of the exe.dev repository, then `npm test`.
 
 ### Named import
 
@@ -81,6 +76,30 @@ All methods accept an optional `{ signal: AbortSignal }` as the last argument fo
 import { exedev } from "@exedev/sdk";
 ```
 
+## Development
+
+```sh
+npm install
+npm test
+```
+
+`npm test` builds the package, then runs the unit tests and the integration
+tests. The integration tests run against the real exe.dev API and create,
+restart, rename and delete a VM. They need a tag-scoped API token, which can
+only see and touch VMs with its tag, and they fail without one (set
+`EXE_SKIP_INTEGRATION=1` to skip them). To create the token:
+
+```sh
+mkdir -p ~/.config/exedev
+ssh exe.dev 'ssh-key generate-api-key --label=sdk-test --tag=sdk-test --exp=30d --cmds="help,ls,new,whoami,stat,rm,restart,rename,ssh-key list,share show" --json' \
+  | jq -r .token > ~/.config/exedev/sdk-test-token
+chmod 600 ~/.config/exedev/sdk-test-token
+```
+
+The tests read the token from `$EXE_TOKEN` or `~/.config/exedev/sdk-test-token`.
+They check that the VM they create is tagged `sdk-test` (override with
+`$EXE_TEST_TAG`). Revoke the token with `ssh exe.dev ssh-key remove sdk-test`.
+
 ## License
 
 MIT

package/dist/client.d.ts

@@ -1,14 +1,15 @@
-import type { VM, WhoamiResponse, StatResponse } from "./types.js";
+import { Commands } from "./commands.gen.js";
+import type { Arg, CallOptions, FlagKind } from "./commands.gen.js";
 export interface ExedevOptions {
     /** Bearer token (exe0.* or exe1.*). */
     token: string;
     /** Base URL for the API. Defaults to "https://exe.dev". */
     baseURL?: string;
+    /** fetch implementation. Defaults to the global fetch. */
+    fetch?: typeof fetch;
 }
-export interface ExecOptions {
-    /** AbortSignal for cancellation. */
-    signal?: AbortSignal;
-}
+/** @deprecated Use CallOptions. */
+export type ExecOptions = CallOptions;
 export interface ExecResult {
     /** HTTP status code. */
     status: number;
@@ -17,29 +18,19 @@ export interface ExecResult {
     /** Whether the request succeeded (2xx). */
     ok: boolean;
 }
-export interface ExedevClient {
-    /** Execute a raw command against the exe.dev API. */
-    exec(command: string, opts?: ExecOptions): Promise<ExecResult>;
-    /** List all VMs. */
-    ls(opts?: ExecOptions): Promise<VM[]>;
-    /** Get the authenticated user's identity. */
-    whoami(opts?: ExecOptions): Promise<WhoamiResponse>;
-    /** Get detailed status of a VM. */
-    stat(vmName: string, opts?: ExecOptions): Promise<StatResponse>;
-    /** Create a new VM. Returns the VM name. */
-    "new"(name: string, options?: {
-        region?: string;
-    }, opts?: ExecOptions): Promise<string>;
-    /** Delete a VM. */
-    rm(vmName: string, opts?: ExecOptions): Promise<void>;
-    /** Restart a VM. */
-    restart(vmName: string, opts?: ExecOptions): Promise<void>;
-    /** Rename a VM. */
-    rename(oldName: string, newName: string, opts?: ExecOptions): Promise<void>;
-    /** List SSH keys. */
-    sshKeyList(opts?: ExecOptions): Promise<string>;
-    /** Show sharing settings for a VM. */
-    shareShow(vmName: string, opts?: ExecOptions): Promise<string>;
+/**
+ * An exe.dev API client. Each exe.dev command is a method (see Commands);
+ * exec runs a raw command line.
+ *
+ * Command methods resolve to the command's parsed JSON output and reject with
+ * ExeAPIError when the command fails.
+ */
+export declare class ExedevClient extends Commands {
+    #private;
+    constructor(opts: ExedevOptions);
+    /** Executes a raw command line against the exe.dev API. */
+    exec(command: string, options?: CallOptions): Promise<ExecResult>;
+    protected run(path: string, args: readonly Arg[], options: CallOptions | undefined, flags: Readonly<Record<string, FlagKind>>): Promise<any>;
 }
 /**
  * Create an exe.dev API client.
@@ -49,12 +40,16 @@ export interface ExedevClient {
  * import exedev from "@exedev/sdk";
  *
  * const exe = exedev({ token: process.env.EXE_TOKEN! });
- * const vms = await exe.ls();
+ * const { vms } = await exe.ls();
  * console.log(vms);
  * ```
  */
 export default function exedev(opts: ExedevOptions): ExedevClient;
-/** Error thrown when the exe.dev API returns a non-2xx status. */
+/** Builds the command line for a generated command method. */
+export declare function commandLine(path: string, args: readonly Arg[], options: CallOptions | undefined, flags: Readonly<Record<string, FlagKind>>): string;
+/** Quotes s for the exe.dev command-line parser (POSIX shell rules). */
+export declare function quote(s: string): string;
+/** Error thrown when the exe.dev API reports a failed command. */
 export declare class ExeAPIError extends Error {
     readonly command: string;
     readonly status: number;

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAkB,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,oBAAoB;IACpB,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACtC,6CAA6C;IAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACpD,mCAAmC;IACnC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChE,4CAA4C;IAC5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxF,mBAAmB;IACnB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,oBAAoB;IACpB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,mBAAmB;IACnB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,qBAAqB;IACrB,UAAU,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,sCAAsC;IACtC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CA8GhE;AAED,kEAAkE;AAClE,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAO1D"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,QAAQ;;gBAK5B,IAAI,EAAE,aAAa;IAU/B,2DAA2D;IACrD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;cAcvD,GAAG,CACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GACxC,OAAO,CAAC,GAAG,CAAC;CAiBhB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAEhE;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GACxC,MAAM,CA2CR;AAED,wEAAwE;AACxE,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvC;AA4BD,kEAAkE;AAClE,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAO1D"}

package/dist/client.js

@@ -1,109 +1,168 @@
+import { Commands } from "./commands.gen.js";
 /**
- * Create an exe.dev API client.
- *
- * @example
- * ```ts
- * import exedev from "@exedev/sdk";
+ * An exe.dev API client. Each exe.dev command is a method (see Commands);
+ * exec runs a raw command line.
  *
- * const exe = exedev({ token: process.env.EXE_TOKEN! });
- * const vms = await exe.ls();
- * console.log(vms);
- * ```
+ * Command methods resolve to the command's parsed JSON output and reject with
+ * ExeAPIError when the command fails.
  */
-export default function exedev(opts) {
-    if (!opts.token) {
-        throw new Error("exedev: token is required");
+export class ExedevClient extends Commands {
+    #token;
+    #baseURL;
+    #fetch;
+    constructor(opts) {
+        super();
+        if (!opts?.token) {
+            throw new Error("exedev: token is required");
+        }
+        this.#token = opts.token;
+        this.#baseURL = (opts.baseURL ?? "https://exe.dev").replace(/\/$/, "");
+        this.#fetch = opts.fetch ?? ((input, init) => fetch(input, init));
     }
-    const token = opts.token;
-    const baseURL = (opts.baseURL ?? "https://exe.dev").replace(/\/$/, "");
-    async function exec(command, execOpts) {
-        const res = await fetch(`${baseURL}/exec`, {
+    /** Executes a raw command line against the exe.dev API. */
+    async exec(command, options) {
+        const res = await this.#fetch(`${this.#baseURL}/exec`, {
             method: "POST",
             headers: {
-                Authorization: `Bearer ${token}`,
+                Authorization: `Bearer ${this.#token}`,
                 "Content-Type": "text/plain",
             },
             body: command,
-            signal: execOpts?.signal,
+            signal: options?.signal,
         });
         const body = await res.text();
         return { status: res.status, body, ok: res.ok };
     }
-    async function execJSON(command, execOpts) {
-        const result = await exec(command, execOpts);
+    async run(path, args, options, flags) {
+        const command = commandLine(path, args, options, flags);
+        const result = await this.exec(command, options);
         if (!result.ok) {
             throw new ExeAPIError(command, result.status, result.body);
         }
-        return JSON.parse(result.body);
-    }
-    return {
-        exec,
-        async ls(execOpts) {
-            const res = await execJSON("ls", execOpts);
-            return res.vms;
-        },
-        async whoami(execOpts) {
-            return execJSON("whoami", execOpts);
-        },
-        async stat(vmName, execOpts) {
-            return execJSON(`stat ${vmName}`, execOpts);
-        },
-        async new(name, options, execOpts) {
-            let cmd = `new ${name}`;
-            if (options?.region) {
-                cmd += ` --region=${options.region}`;
-            }
-            const result = await exec(cmd, execOpts);
-            if (!result.ok) {
-                throw new ExeAPIError(cmd, result.status, result.body);
-            }
-            return result.body.trim();
-        },
-        async rm(vmName, execOpts) {
-            const result = await exec(`rm ${vmName}`, execOpts);
-            if (!result.ok) {
-                throw new ExeAPIError(`rm ${vmName}`, result.status, result.body);
-            }
-        },
-        async restart(vmName, execOpts) {
-            const result = await exec(`restart ${vmName}`, execOpts);
-            if (!result.ok) {
-                throw new ExeAPIError(`restart ${vmName}`, result.status, result.body);
-            }
-        },
-        async rename(oldName, newName, execOpts) {
-            const result = await exec(`rename ${oldName} ${newName}`, execOpts);
-            if (!result.ok) {
-                throw new ExeAPIError(`rename ${oldName} ${newName}`, result.status, result.body);
-            }
-        },
-        async sshKeyList(execOpts) {
-            const result = await exec("ssh-key list", execOpts);
-            if (!result.ok) {
-                throw new ExeAPIError("ssh-key list", result.status, result.body);
-            }
+        const docs = parseDocuments(result.body);
+        if (docs === undefined) {
             return result.body;
-        },
-        async shareShow(vmName, execOpts) {
-            const result = await exec(`share show ${vmName}`, execOpts);
-            if (!result.ok) {
-                throw new ExeAPIError(`share show ${vmName}`, result.status, result.body);
+        }
+        // Some commands report a failure as an {"error": ...} document with a
+        // 200 status (e.g. rm of a missing VM).
+        if (docs.some(isErrorDocument)) {
+            throw new ExeAPIError(command, result.status, result.body);
+        }
+        return docs.length === 1 ? docs[0] : docs;
+    }
+}
+/**
+ * Create an exe.dev API client.
+ *
+ * @example
+ * ```ts
+ * import exedev from "@exedev/sdk";
+ *
+ * const exe = exedev({ token: process.env.EXE_TOKEN! });
+ * const { vms } = await exe.ls();
+ * console.log(vms);
+ * ```
+ */
+export default function exedev(opts) {
+    return new ExedevClient(opts);
+}
+/** Builds the command line for a generated command method. */
+export function commandLine(path, args, options, flags) {
+    const words = [path];
+    for (const [key, value] of Object.entries(options ?? {})) {
+        if (key === "signal" || value === undefined) {
+            continue;
+        }
+        const kind = Object.hasOwn(flags, key) ? flags[key] : undefined;
+        switch (kind) {
+            case "bool":
+                words.push(value ? `--${key}` : `--${key}=false`);
+                break;
+            case "number":
+            case "string":
+                words.push(`--${key}=${quote(String(value))}`);
+                break;
+            case "repeated":
+                for (const v of [value].flat()) {
+                    words.push(`--${key}=${quote(String(v))}`);
+                }
+                break;
+            default:
+                throw new TypeError(`${path}: unknown option ${JSON.stringify(key)}`);
+        }
+    }
+    const positionals = [];
+    let skipped = false;
+    for (const arg of args) {
+        if (arg === undefined) {
+            skipped = true;
+            continue;
+        }
+        for (const a of [arg].flat()) {
+            if (skipped) {
+                throw new TypeError(`${path}: argument ${JSON.stringify(a)} follows an omitted argument`);
             }
-            return result.body;
-        },
-    };
+            positionals.push(a);
+        }
+    }
+    if (positionals.some((p) => p.startsWith("-"))) {
+        words.push("--");
+    }
+    words.push(...positionals.map(quote));
+    return words.join(" ");
 }
-/** Error thrown when the exe.dev API returns a non-2xx status. */
+/** Quotes s for the exe.dev command-line parser (POSIX shell rules). */
+export function quote(s) {
+    if (/^[A-Za-z0-9_@%+=:,./-]+$/.test(s)) {
+        return s;
+    }
+    return `'${s.replaceAll("'", `'"'"'`)}'`;
+}
+/**
+ * Parses a response body as one JSON document, or as newline-separated
+ * documents. Returns undefined for an empty or non-JSON body.
+ */
+function parseDocuments(body) {
+    const text = body.trim();
+    if (text === "") {
+        return undefined;
+    }
+    try {
+        return [JSON.parse(text)];
+    }
+    catch {
+        // Not a single document.
+    }
+    try {
+        return text.split("\n").filter((line) => line.trim() !== "").map((line) => JSON.parse(line));
+    }
+    catch {
+        return undefined;
+    }
+}
+function isErrorDocument(doc) {
+    return typeof doc === "object" && doc !== null && !Array.isArray(doc) &&
+        Object.keys(doc).length === 1 && "error" in doc;
+}
+/** Error thrown when the exe.dev API reports a failed command. */
 export class ExeAPIError extends Error {
     command;
     status;
     body;
     constructor(command, status, body) {
-        super(`exe.dev API error (${status}): ${body.trim()}`);
+        super(`exe.dev API error (${status}): ${errorMessage(body)}`);
         this.name = "ExeAPIError";
         this.command = command;
         this.status = status;
         this.body = body;
     }
 }
+function errorMessage(body) {
+    for (const doc of parseDocuments(body) ?? []) {
+        if (isErrorDocument(doc)) {
+            return String(doc.error);
+        }
+    }
+    return body.trim();
+}
 //# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}