@shipvo/cli 0.1.4 → 0.1.5

package/dist/agents.d.ts

@@ -0,0 +1,14 @@
+export type ProjectKind = "shipvo" | "expo" | "react-native" | "capacitor" | "unknown";
+export declare const BEGIN = "<!-- shipvo:begin -->";
+export declare const END = "<!-- shipvo:end -->";
+export declare const SKILL_LINE = "npx skills add shipvo/shipvo --skill shipvo -g";
+/** What kind of app lives in `dir`. A shipvo.json wins; then Capacitor, Expo, bare React Native. */
+export declare function detectProject(dir: string): ProjectKind;
+/** The text between (and including) our markers. */
+export declare function agentsSection(kind: ProjectKind): string;
+/** Put `section` between the markers. Text outside the markers is never changed. Returns null when the markers are broken (one missing, or END before BEGIN). */
+export declare function upsertSection(text: string, section: string): string | null;
+/** Add the `shipvo` server and keep every other server and key. Returns null if the file is not valid JSON. */
+export declare function mergeMcp(text: string | null): string | null;
+/** `shipvo agents setup [--dry-run] [--json]`. Exit 0 done, 2 error. */
+export declare function agentsCmd(argv: string[], dir?: string): Promise<number>;

package/dist/agents.js

@@ -0,0 +1,124 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { args } from "./config.js";
+export const BEGIN = "<!-- shipvo:begin -->";
+export const END = "<!-- shipvo:end -->";
+export const SKILL_LINE = "npx skills add shipvo/shipvo --skill shipvo -g";
+/** What kind of app lives in `dir`. A shipvo.json wins; then Capacitor, Expo, bare React Native. */
+export function detectProject(dir) {
+    if (existsSync(join(dir, "shipvo.json")))
+        return "shipvo";
+    let deps = {};
+    try {
+        const p = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+        deps = { ...p.devDependencies, ...p.dependencies };
+    }
+    catch { /* no package.json */ }
+    if (existsSync(join(dir, "capacitor.config.ts")) || existsSync(join(dir, "capacitor.config.json")) || "@capacitor/core" in deps)
+        return "capacitor";
+    if ("expo" in deps)
+        return "expo";
+    if ("react-native" in deps)
+        return "react-native";
+    return "unknown";
+}
+const LABEL = { shipvo: "a Shipvo app", expo: "an Expo app", "react-native": "a bare React Native app", capacitor: "a Capacitor app", unknown: "an app" };
+/** The text between (and including) our markers. */
+export function agentsSection(kind) {
+    return [
+        BEGIN,
+        "## Shipvo",
+        "",
+        `This project is ${LABEL[kind]} that uses Shipvo for over-the-air updates and the app simulator.`,
+        "",
+        "- Use `shipvo` commands instead of editing release or signing files by hand.",
+        "- When you are not sure what to do next, run `shipvo status --json`. It prints `next`: the commands to run and why.",
+        "- Exit codes of `shipvo status --json`: 0 ok, 1 action needed, 2 error.",
+        "- To drive the app, use the `shipvo` MCP server from `.mcp.json` (`@shipvo/mcp`).",
+        END,
+    ].join("\n");
+}
+/** Put `section` between the markers. Text outside the markers is never changed. Returns null when the markers are broken (one missing, or END before BEGIN). */
+export function upsertSection(text, section) {
+    const b = text.indexOf(BEGIN);
+    const e = text.indexOf(END);
+    if ((b === -1) !== (e === -1) || (b !== -1 && e < b))
+        return null;
+    if (b !== -1 && e !== -1)
+        return text.slice(0, b) + section + text.slice(e + END.length);
+    if (!text.trim())
+        return section + "\n";
+    return text.replace(/\n*$/, "\n\n") + section + "\n";
+}
+const SERVER = { command: "npx", args: ["-y", "@shipvo/mcp"] };
+/** Add the `shipvo` server and keep every other server and key. Returns null if the file is not valid JSON. */
+export function mergeMcp(text) {
+    let doc = {};
+    if (text !== null && text.trim()) {
+        try {
+            doc = JSON.parse(text);
+        }
+        catch {
+            return null;
+        }
+        if (!doc || typeof doc !== "object" || Array.isArray(doc))
+            return null;
+    }
+    const servers = (doc.mcpServers && typeof doc.mcpServers === "object" ? doc.mcpServers : {});
+    servers.shipvo = SERVER;
+    return JSON.stringify({ ...doc, mcpServers: servers }, null, 2) + "\n";
+}
+/** `shipvo agents setup [--dry-run] [--json]`. Exit 0 done, 2 error. */
+export async function agentsCmd(argv, dir = process.cwd()) {
+    const [sub, ...rest] = argv;
+    if (sub !== "setup") {
+        console.error("Usage: shipvo agents setup [--dry-run] [--json]");
+        return 2;
+    }
+    const a = args(rest);
+    const dry = a["dry-run"] !== undefined, json = a.json !== undefined;
+    const kind = detectProject(dir);
+    const changes = [];
+    const writes = [];
+    const plan = (file, next, note) => {
+        const path = join(dir, file);
+        const old = existsSync(path) ? readFileSync(path, "utf8") : null;
+        if (next === null) {
+            changes.push({ file, action: "skip", note });
+            return;
+        }
+        if (old === next) {
+            changes.push({ file, action: "unchanged" });
+            return;
+        }
+        changes.push({ file, action: old === null ? "create" : "update" });
+        writes.push({ path, text: next });
+    };
+    const read = (f) => existsSync(join(dir, f)) ? readFileSync(join(dir, f), "utf8") : null;
+    plan("AGENTS.md", upsertSection(read("AGENTS.md") ?? "", agentsSection(kind)), "AGENTS.md has a broken shipvo marker; fix it and run again.");
+    const targets = [".mcp.json", ...(existsSync(join(dir, ".cursor")) ? [".cursor/mcp.json"] : [])];
+    for (const f of targets) {
+        const merged = mergeMcp(read(f));
+        plan(f, merged, `${f} is not valid JSON; I left it alone. Fix it and run again.`);
+    }
+    const bad = changes.some((c) => c.action === "skip");
+    if (!dry && !bad)
+        for (const w of writes) {
+            mkdirSync(dirname(w.path), { recursive: true });
+            writeFileSync(w.path, w.text);
+        }
+    const wrote = !dry && !bad;
+    if (json)
+        console.log(JSON.stringify({ ok: !bad, project: kind, dry_run: dry, changes, skill_install: SKILL_LINE }));
+    else {
+        console.log(`Project: ${LABEL[kind]}.`);
+        for (const c of changes)
+            console.log(`  ${c.file}: ${c.action === "skip" ? c.note : c.action === "unchanged" ? "already up to date" : `${dry ? "would " : ""}${c.action}${dry ? "" : "d"}`}`);
+        if (dry)
+            console.log("Dry run: nothing was written.");
+        else if (wrote && !changes.some((c) => c.action !== "unchanged"))
+            console.log("Nothing to change.");
+        console.log(`Install the skill: ${SKILL_LINE}`);
+    }
+    return bad ? 2 : 0;
+}

package/dist/audit.d.ts

@@ -0,0 +1,13 @@
+export declare const AUDIT_FLAGS: string[];
+export declare const AUDIT_COLUMNS: readonly ["id", "app_id", "at", "actor", "actor_kind", "action", "release", "release_id", "before", "after"];
+export declare const AUDIT_HELP = "Usage: shipvo audit <app> [--format json|csv] [--limit n]\n\nPrint the app's audit log, newest first, to stdout. Pages through the control plane.\n\nFlags (write a value after a space, not =):\n  --format json|csv   Output format (default json)\n  --limit n           Stop after n entries (default: all)\n  --help              Show this help\n\nNeeds SHIPVO_OWNER_TOKEN, or the publish token from shipvo app create (SHIPVO_PUBLISH_TOKEN or .shipvo/publish-token).\n";
+type Row = Record<string, unknown> & {
+    id: number;
+};
+/** One CSV field: quoted, with "" for quotes. Values that start with = + - @ get a leading ' so spreadsheets do not run them. */
+export declare function csvField(v: unknown): string;
+export declare function toCsv(rows: Row[]): string;
+export declare function audit(argv: string[], deps?: {
+    fetchFn?: typeof fetch;
+}): Promise<void>;
+export {};

package/dist/audit.js

@@ -0,0 +1,75 @@
+// `shipvo audit <app>`: export an app's audit log as JSON or CSV on stdout.
+import { args as parse, loadConfig, publishToken } from "./config.js";
+export const AUDIT_FLAGS = ["format", "limit"];
+export const AUDIT_COLUMNS = ["id", "app_id", "at", "actor", "actor_kind", "action", "release", "release_id", "before", "after"];
+const PAGE = 200;
+export const AUDIT_HELP = `Usage: shipvo audit <app> [--format json|csv] [--limit n]
+
+Print the app's audit log, newest first, to stdout. Pages through the control plane.
+
+Flags (write a value after a space, not =):
+  --format json|csv   Output format (default json)
+  --limit n           Stop after n entries (default: all)
+  --help              Show this help
+
+Needs SHIPVO_OWNER_TOKEN, or the publish token from shipvo app create (SHIPVO_PUBLISH_TOKEN or .shipvo/publish-token).
+`;
+/** One CSV field: quoted, with "" for quotes. Values that start with = + - @ get a leading ' so spreadsheets do not run them. */
+export function csvField(v) {
+    let s = v === null || v === undefined ? "" : typeof v === "object" ? JSON.stringify(v) : String(v);
+    if (/^[=+\-@]/.test(s))
+        s = "'" + s;
+    return `"${s.replace(/"/g, '""')}"`;
+}
+export function toCsv(rows) {
+    return [AUDIT_COLUMNS.map(csvField).join(","), ...rows.map((r) => AUDIT_COLUMNS.map((c) => csvField(r[c])).join(","))].join("\n");
+}
+export async function audit(argv, deps = {}) {
+    if (argv.includes("--help") || argv.includes("-h")) {
+        console.log(AUDIT_HELP);
+        return;
+    }
+    const bad = argv.filter((x) => x.startsWith("--") && !AUDIT_FLAGS.includes(x.slice(2)));
+    if (bad.length)
+        throw new Error(`Unknown flag ${bad.join(", ")}. Known flags: ${AUDIT_FLAGS.map((k) => "--" + k).join(" ")}`);
+    const a = parse(argv);
+    // Positional app id: the first argument that is not a flag or a flag's value.
+    const appId = argv.find((x, i) => !x.startsWith("--") && !(i > 0 && AUDIT_FLAGS.includes(argv[i - 1].slice(2)) && argv[i - 1].startsWith("--")));
+    if (!appId)
+        throw new Error("Usage: shipvo audit <app> [--format json|csv] [--limit n]");
+    const format = a.format ?? "json";
+    if (format !== "json" && format !== "csv")
+        throw new Error(`--format must be json or csv (got "${a.format}").`);
+    let max = Infinity;
+    if (argv.includes("--limit")) {
+        max = Number(a.limit);
+        if (!Number.isInteger(max) || max < 1)
+            throw new Error(`--limit must be a positive whole number (got "${a.limit}").`);
+    }
+    const token = process.env.SHIPVO_OWNER_TOKEN?.trim() || publishToken();
+    if (!token)
+        throw new Error("No credentials. Set SHIPVO_OWNER_TOKEN, or run `shipvo app create` to get a publish token (SHIPVO_PUBLISH_TOKEN or .shipvo/publish-token).");
+    const base = loadConfig().controlPlane.replace(/\/$/, "");
+    const f = deps.fetchFn ?? fetch;
+    const rows = [];
+    let before;
+    while (rows.length < max) {
+        const want = Math.min(PAGE, max - rows.length);
+        const url = `${base}/audit/${encodeURIComponent(appId)}?limit=${want}${before !== undefined ? `&before=${before}` : ""}`;
+        let r;
+        try {
+            r = await f(url, { headers: { authorization: `Bearer ${token}` } });
+        }
+        catch (e) {
+            throw new Error(`Could not reach the control plane at ${base} (${e instanceof Error ? e.message : String(e)}).`);
+        }
+        if (!r.ok)
+            throw new Error(`Audit request failed: HTTP ${r.status}${r.status === 401 ? " (the token was not accepted for this app)" : ""}.`);
+        const page = (await r.json()).rows ?? [];
+        rows.push(...page);
+        if (page.length < want)
+            break;
+        before = page[page.length - 1].id;
+    }
+    console.log(format === "csv" ? toCsv(rows) : JSON.stringify(rows, null, 2));
+}

package/dist/ci.d.ts

@@ -0,0 +1,3 @@
+export declare const WORKFLOW_PATH: string;
+/** `shipvo ci init --framework capacitor [--dry-run] [--force]`. Returns the exit code. */
+export declare function ci(argv: string[], cwd?: string): Promise<number>;

package/dist/ci.js

@@ -0,0 +1,42 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { args } from "./config.js";
+export const WORKFLOW_PATH = join(".github", "workflows", "shipvo-build.yml");
+/** Find the template: next to the built CLI (npm), or in the repo's `templates/` (development). */
+function templatePath(framework) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const rel = join("templates", framework, "github-actions", "build.yml");
+    for (const c of [join(here, rel), join(here, "..", "..", "..", rel)])
+        if (existsSync(c))
+            return c;
+    throw new Error(`template for ${framework} not found`);
+}
+/** `shipvo ci init --framework capacitor [--dry-run] [--force]`. Returns the exit code. */
+export async function ci(argv, cwd = process.cwd()) {
+    const [sub, ...rest] = argv;
+    if (sub !== "init") {
+        console.error("Usage: shipvo ci init --framework capacitor [--dry-run] [--force]");
+        return 2;
+    }
+    const a = args(rest);
+    if (a.framework !== "capacitor") {
+        console.error("shipvo ci init: --framework capacitor is the only framework with a template so far");
+        return 2;
+    }
+    const body = readFileSync(templatePath("capacitor"), "utf8");
+    const target = resolve(cwd, WORKFLOW_PATH);
+    if (a["dry-run"] !== undefined && a["dry-run"] !== "false") {
+        console.log(`Would write ${WORKFLOW_PATH}${existsSync(target) ? " (file exists; --force needed)" : ""}. Nothing was written.\n`);
+        console.log(body);
+        return 0;
+    }
+    if (existsSync(target) && (a.force === undefined || a.force === "false")) {
+        console.error(`${WORKFLOW_PATH} already exists. Use --force to overwrite it.`);
+        return 1;
+    }
+    mkdirSync(dirname(target), { recursive: true });
+    writeFileSync(target, body);
+    console.log(`Wrote ${WORKFLOW_PATH}. Add the secrets listed in docs/capacitor.md, then run the "Shipvo build" workflow.`);
+    return 0;
+}

package/dist/cli.js

@@ -7,15 +7,22 @@ import { init } from "./init.js";
 import { publish, rollback } from "./publish.js";
 import { promote } from "./promote.js";
 import { autoHalt } from "./autohalt.js";
+import { explore } from "./explore.js";
 import { sim } from "./sim.js";
 import { preview } from "./preview.js";
+import { run } from "./run.js";
 import { keys, login, mcp } from "./login.js";
 import { verifyPointer } from "./verify.js";
 import { signingKey } from "./signing.js";
 import { appCmd } from "./app.js";
 import { status } from "./status.js";
+import { agentsCmd } from "./agents.js";
 import { doctor } from "./doctor.js";
+import { audit } from "./audit.js";
 import { store } from "./store.js";
+import { ci } from "./ci.js";
+import { easCmd } from "./eas.js";
+import { testCmd } from "./test.js";
 import { failure, help, unknownCommand } from "./help.js";
 const [cmd, ...rest] = process.argv.slice(2);
 try {
@@ -26,6 +33,12 @@ try {
         case "sim":
             await sim(rest);
             break;
+        case "explore":
+            process.exitCode = await explore(rest);
+            break;
+        case "run":
+            process.exitCode = await run(rest);
+            break;
         case "preview":
             await preview(rest);
             break;
@@ -50,9 +63,24 @@ try {
         case "status":
             process.exitCode = await status(rest);
             break;
+        case "agents":
+            process.exitCode = await agentsCmd(rest);
+            break;
+        case "audit":
+            await audit(rest);
+            break;
+        case "test":
+            process.exitCode = await testCmd(rest);
+            break;
         case "store":
             await store(rest);
             break;
+        case "ci":
+            process.exitCode = await ci(rest);
+            break;
+        case "eas":
+            process.exitCode = await easCmd(rest);
+            break;
         case "app":
             await appCmd(rest);
             break;

package/dist/config.d.ts

@@ -21,6 +21,8 @@ export type ShipvoConfig = {
     preview?: "here.now" | "control-plane";
     /** Release rules checked by `shipvo publish --dry-run`. Validated there, not at load, so a bad section never breaks other commands. */
     policy?: unknown;
+    /** Deep links `shipvo explore` opens after the start screen (for example "tide://cart"). Needs an onUrl listener in the app. */
+    routes?: string[];
     /** Marketplace listing (hosted control plane): shown to agents and on shipvo.dev once reviewed. */
     listing?: {
         public?: boolean;

package/dist/config.js

@@ -42,31 +42,46 @@ export function publishToken() {
         return null;
     }
 }
+const RETRIES = 2;
 /** Publishing through the hosted control plane: the same get/put/keys, scoped to this app and signed-pointer checked server side. */
 function hostedKv(cfg, token) {
     const base = `${cfg.controlPlane.replace(/\/$/, "")}/apps/${cfg.appId}/kv`;
-    const auth = { Authorization: `Bearer ${token}` };
+    const auth = { Authorization: `Bearer ${token}`, ...(process.env.SHIPVO_ACTOR === "agent" ? { "x-shipvo-actor": "agent" } : {}) };
     const path = (k) => `${base}/${k.split("/").map(encodeURIComponent).join("/")}`;
     const host = cfg.controlPlane.replace(/\/$/, "");
     /** One place for the two first-run failures: the server is not there, or it does not accept the token. */
-    const call = async (url, init) => {
+    const call = async (url, init, what) => {
         let r;
-        try {
-            r = await fetch(url, init);
+        for (let attempt = 0;; attempt++) {
+            try {
+                r = await fetch(url, init);
+                break;
+            }
+            catch (err) {
+                // Network errors only, never HTTP statuses. Every call here is a GET or a PUT of the same bytes to the same key, so repeating it is safe.
+                if (attempt < RETRIES) {
+                    await new Promise((ok) => setTimeout(ok, 150 * 2 ** attempt));
+                    continue;
+                }
+                const cause = err?.cause?.code ?? err?.code ?? err?.cause?.message ?? err?.message ?? "unknown error";
+                throw new Error(`Cannot reach the control plane at ${host} (${cause}) while ${init.method ?? "GET"} ${what}. Check "controlPlane" in shipvo.json, then run \`shipvo doctor\`.`);
+            }
         }
-        catch {
-            throw new Error(`Cannot reach the control plane at ${host}. Check "controlPlane" in shipvo.json, then run \`shipvo doctor\`.`);
+        if (r.status === 403) { // a typed policy refusal is not a bad token
+            const j = await r.clone().json().catch(() => null);
+            if (j?.code === "policy_refused")
+                throw new Error(`Refused by policy rule ${j.rule}: ${j.reason}`);
         }
         if (r.status === 401 || r.status === 403)
             throw new Error(`The control plane at ${host} rejected your publish token (${r.status}). Run \`shipvo login\`, then \`shipvo app create\` for a new token.`);
         return r;
     };
     return {
-        async get(k) { const r = await call(path(k), { headers: auth }); return r.ok ? r.text() : null; },
-        async getBytes(k) { const r = await call(path(k), { headers: auth }); return r.ok ? new Uint8Array(await r.arrayBuffer()) : null; },
-        async keys(prefix) { const r = await call(`${base}?prefix=${encodeURIComponent(prefix)}`, { headers: auth }); return r.ok ? (await r.json()).keys : []; },
+        async get(k) { const r = await call(path(k), { headers: auth }, k); return r.ok ? r.text() : null; },
+        async getBytes(k) { const r = await call(path(k), { headers: auth }, k); return r.ok ? new Uint8Array(await r.arrayBuffer()) : null; },
+        async keys(prefix) { const r = await call(`${base}?prefix=${encodeURIComponent(prefix)}`, { headers: auth }, `keys ${prefix}`); return r.ok ? (await r.json()).keys : []; },
         async put(k, body, type) {
-            const r = await call(path(k), { method: "PUT", headers: { ...auth, "content-type": type }, body });
+            const r = await call(path(k), { method: "PUT", headers: { ...auth, "content-type": type }, body }, k);
             if (!r.ok) {
                 let m = "";
                 try {

package/dist/doctor.d.ts

@@ -18,6 +18,8 @@ type DoctorDeps = {
     port: number;
     /** Path of the Playwright Chromium binary, or null if Playwright is not installed. */
     chromiumPath: (cwd: string) => string | null;
+    /** Version of the playwright that chromiumPath resolved, or null if unknown. */
+    playwrightVersion: (cwd: string) => string | null;
     portFree: (port: number) => Promise<boolean>;
     /** Skip the checks that need the network (control plane reachable and /health). */
     offline: boolean;

package/dist/doctor.js

@@ -22,6 +22,12 @@ const defaultDeps = () => ({
     } },
     port: 4545,
     chromiumPath: playwrightChromiumPath,
+    playwrightVersion: (cwd) => { try {
+        return createRequire(join(cwd, "package.json"))("playwright/package.json").version;
+    }
+    catch {
+        return null;
+    } },
     portFree,
     offline: false,
     skipSim: false,
@@ -42,6 +48,19 @@ function playwrightChromiumPath(cwd) {
     }
     return null;
 }
+/** Where system Chrome or Edge lives. Same places as the simulator's browser resolver (packages/sim/browser-resolver.mjs). */
+function systemBrowserPaths(platform, env) {
+    if (platform === "win32") {
+        const roots = [env.PROGRAMFILES, env["PROGRAMFILES(X86)"], env.LOCALAPPDATA].filter(Boolean);
+        return roots.flatMap((r) => [["Chrome", r + "\\Google\\Chrome\\Application\\chrome.exe"], ["Edge", r + "\\Microsoft\\Edge\\Application\\msedge.exe"]]);
+    }
+    if (platform === "darwin")
+        return [["Chrome", "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"], ["Edge", "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"]];
+    return [
+        ["Chrome", "/usr/bin/google-chrome"], ["Chrome", "/usr/bin/google-chrome-stable"], ["Chrome", "/opt/google/chrome/chrome"],
+        ["Edge", "/usr/bin/microsoft-edge"], ["Edge", "/usr/bin/microsoft-edge-stable"], ["Edge", "/opt/microsoft/msedge/msedge"],
+    ];
+}
 function hasSimScript(deps) {
     try {
         const pkg = JSON.parse(deps.readText(join(deps.cwd, "package.json")));
@@ -186,8 +205,13 @@ export async function runDoctorChecks(overrides = {}) {
     results.push({ name: "hermesBytecodeVersion (if present) is set", ok: hermesOk, fix: "set hermesBytecodeVersion to a positive integer or list (for example 96 or [96, 98])" });
     // Simulator checks only apply to projects that have a `sim` script.
     if (!deps.skipSim && hasSimScript(deps)) {
+        const system = systemBrowserPaths(deps.platform, deps.env).find(([, p]) => deps.fileExists(p));
         const exe = deps.chromiumPath(deps.cwd);
-        results.push({ name: "Playwright Chromium installed", ok: !!exe && deps.fileExists(exe), fix: "npx playwright install chromium" });
+        const cached = !!exe && deps.fileExists(exe);
+        const noAuto = deps.env.SHIPVO_NO_AUTO_INSTALL === "1";
+        const ok = !!system || cached || !noAuto;
+        const note = system ? `system ${system[0]}` : cached ? "Playwright Chromium" : "none found yet; the first run downloads Chromium once";
+        results.push({ name: "Browser for the simulator", ok, fix: `SHIPVO_NO_AUTO_INSTALL=1 is set and no Chrome, Edge or Playwright Chromium was found; install Chrome or Edge, or run \`npx playwright install chromium\` in the app folder${deps.playwrightVersion(deps.cwd) ? ` (playwright ${deps.playwrightVersion(deps.cwd)})` : ""}. On Linux, if it then fails to start, run \`npx playwright install-deps chromium\``, note });
         results.push({ name: `sim port ${deps.port} is free`, ok: await deps.portFree(deps.port), fix: "Stop the other process or pass --port <n>" });
     }
     return results;

package/dist/eas.d.ts

@@ -0,0 +1,29 @@
+export declare const ANDROID_IMAGE = "latest";
+export declare const IOS_IMAGE = "macos-tahoe-26.5-xcode-26.6";
+export declare const NODE_VERSION = "22";
+export declare const JDK_VERSION = "21";
+export interface CapacitorProject {
+    configFile: string;
+    android: boolean;
+    ios: boolean;
+}
+/** Look for a Capacitor project at `root`. Returns undefined when it is not one. */
+export declare function detectCapacitor(root: string): CapacitorProject | undefined;
+export interface PlannedFile {
+    path: string;
+    content: string;
+    action: "create" | "update";
+}
+/** Work out which files need writing. Existing build YAMLs and schemes are never overwritten. */
+export declare function planEasSetup(root: string, p: CapacitorProject): PlannedFile[];
+/** Create the `ios/App.xcodeproj -> App/App.xcodeproj` link the EAS CLI scheme check needs. Returns true if it made one. */
+export declare function ensureSchemeShim(root: string): boolean;
+export declare const ONE_TIME_STEPS: readonly [readonly ["eas-cli", "init"], readonly ["eas-cli", "build:version:set", "-p", "ios"]];
+export declare const IOS_UNPROVEN = "Note: the iOS signing steps in .eas/build/ios.yml are unproven. The step names were not checked against Expo's custom build functions (https://docs.expo.dev/custom-builds/schema/), so your first iOS build is the check.";
+export type Runner = (cmd: string, args: string[], cwd: string) => number;
+export interface EasOptions {
+    cwd?: string;
+    log?: (s: string) => void;
+    runner?: Runner;
+}
+export declare function easCmd(args: string[], o?: EasOptions): Promise<number>;