@lynxship/cli 0.1.19 → 0.1.21

package/dist/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsCD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAmDxD;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,OAAO,CAAC,CAoDlB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAQ/C"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../src/remote.ts"],"names":[],"mappings":"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"}

package/dist/remote.js

@@ -1,3 +1,15 @@
+import { decodeSourceSnapshot, SOURCE_SNAPSHOT_CONTENT_TYPE, } from "@lynxship/build-orchestrator";
+import { sha256 } from "@lynxship/contracts";
+export class RemoteApiError extends Error {
+    status;
+    code;
+    constructor(status, message, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "RemoteApiError";
+    }
+}
 function apiUrl(options) {
     return (options.apiUrl ??
         process.env.LYNXSHIP_API_URL ??
@@ -12,9 +24,18 @@ async function request(options, path, init = {}) {
         ...init,
         headers,
     });
-    const body = (await response.json());
+    const text = await response.text();
+    let body;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        body = undefined;
+    }
     if (!response.ok)
-        throw new Error(`LynxShip API ${response.status}: ${body.message ?? body.error ?? response.statusText}`);
+        throw new RemoteApiError(response.status, `LynxShip API ${response.status}: ${body?.message ?? body?.error ?? response.statusText}`, body?.error);
+    if (!body)
+        throw new Error("LynxShip API returned invalid JSON");
     return body;
 }
 export async function ensureRemoteTarget(config, state) {
@@ -57,6 +78,124 @@ export async function ensureRemoteTarget(config, state) {
     }
     return { organizationId, projectId };
 }
+export async function uploadBuildSource(config, state, bytes) {
+    const target = await ensureRemoteTarget(config, state);
+    let directSource;
+    try {
+        const snapshot = decodeSourceSnapshot(bytes);
+        directSource = {
+            key: `sources/${sha256(bytes)}`,
+            hash: sha256(bytes),
+            size: bytes.length,
+            contentType: SOURCE_SNAPSHOT_CONTENT_TYPE,
+            fileCount: snapshot.files.length,
+        };
+        const plan = await request({
+            apiUrl: config.cli?.apiUrl,
+            token: config.cli?.token ?? process.env.LYNXSHIP_TOKEN,
+        }, "/v1/build-sources/upload-plan", {
+            method: "POST",
+            body: JSON.stringify({ ...target, source: directSource }),
+        });
+        const uploaded = await fetch(plan.upload.url, {
+            method: plan.upload.method,
+            headers: plan.upload.headers,
+            body: Uint8Array.from(bytes),
+        });
+        if (!uploaded.ok)
+            throw new Error(`Direct source upload failed with HTTP ${uploaded.status}`);
+        const completed = await request({
+            apiUrl: config.cli?.apiUrl,
+            token: config.cli?.token ?? process.env.LYNXSHIP_TOKEN,
+        }, "/v1/build-sources/complete", {
+            method: "POST",
+            body: JSON.stringify({ ...target, source: plan.source }),
+        });
+        return completed.source;
+    }
+    catch (error) {
+        const code = typeof error === "object" && error !== null && "code" in error
+            ? error.code
+            : undefined;
+        if (!((error instanceof RemoteApiError &&
+            (error.status === 404 ||
+                error.code === "SOURCE_DIRECT_UPLOAD_UNAVAILABLE")) ||
+            code === "SOURCE_SNAPSHOT_INVALID"))
+            throw error;
+    }
+    const response = await request({
+        apiUrl: config.cli?.apiUrl,
+        token: config.cli?.token ?? process.env.LYNXSHIP_TOKEN,
+    }, "/v1/build-sources", {
+        method: "POST",
+        body: JSON.stringify({
+            ...target,
+            dataBase64: bytes.toString("base64"),
+        }),
+    });
+    return response.source;
+}
+export async function createRemoteBuild(config, state, input) {
+    const target = await ensureRemoteTarget(config, state);
+    return request({
+        apiUrl: config.cli?.apiUrl,
+        token: config.cli?.token ?? process.env.LYNXSHIP_TOKEN,
+    }, "/v1/builds", {
+        method: "POST",
+        body: JSON.stringify({
+            ...target,
+            platform: input.platform,
+            profile: input.profile,
+            source: input.source,
+            sourceHash: input.source.hash,
+            idempotencyKey: input.idempotencyKey ??
+                "cli:" +
+                    input.platform +
+                    ":" +
+                    input.profile +
+                    ":" +
+                    input.source.hash,
+        }),
+    });
+}
+export async function getRemoteBuild(config, id) {
+    return request({
+        apiUrl: config.cli?.apiUrl,
+        token: config.cli?.token ?? process.env.LYNXSHIP_TOKEN,
+    }, "/v1/builds/" + encodeURIComponent(id));
+}
+export async function listRemoteBuilds(config, state) {
+    const { organizationId, projectId } = await ensureRemoteTarget(config, state);
+    return request({
+        apiUrl: config.cli?.apiUrl,
+        token: config.cli?.token ?? process.env.LYNXSHIP_TOKEN,
+    }, `/v1/builds?organizationId=${encodeURIComponent(organizationId)}&projectId=${encodeURIComponent(projectId)}`);
+}
+export async function cancelRemoteBuild(config, id) {
+    return request({
+        apiUrl: config.cli?.apiUrl,
+        token: config.cli?.token ?? process.env.LYNXSHIP_TOKEN,
+    }, `/v1/builds/${encodeURIComponent(id)}/cancel`, { method: "POST", body: JSON.stringify({}) });
+}
+export async function retryRemoteBuild(config, id) {
+    return request({
+        apiUrl: config.cli?.apiUrl,
+        token: config.cli?.token ?? process.env.LYNXSHIP_TOKEN,
+    }, `/v1/builds/${encodeURIComponent(id)}/retry`, { method: "POST", body: JSON.stringify({}) });
+}
+export async function waitForRemoteBuild(config, id, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 60 * 60 * 1_000;
+    const pollMs = options.pollMs ?? 2_000;
+    const startedAt = Date.now();
+    for (;;) {
+        const job = await getRemoteBuild(config, id);
+        if (["success", "failed", "canceled", "timed_out"].includes(job.state))
+            return job;
+        if (Date.now() - startedAt >= timeoutMs)
+            throw new Error("Remote build " + id + " did not finish before the timeout");
+        await new Promise((resolve) => setTimeout(resolve, pollMs));
+    }
+}
 export async function submitRealArtifact(config, state, job, latest) {
     if (!job.artifact?.key || !job.artifact.url)
         throw new Error("The build artifact is not registered in Cloudflare R2");

package/dist/rspeedy-app-config.d.ts

@@ -0,0 +1,4 @@
+import type { LoadedLynxShipAppConfig } from "./app-config.js";
+/** Build the `lynxConfig` exported by app.config without generating a proxy file. */
+export declare function buildRspeedyAppConfig(root: string, appConfig: LoadedLynxShipAppConfig): Promise<void>;
+//# sourceMappingURL=rspeedy-app-config.d.ts.map

package/dist/rspeedy-app-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rspeedy-app-config.d.ts","sourceRoot":"","sources":["../src/rspeedy-app-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAuC/D,qFAAqF;AACrF,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,uBAAuB,GACjC,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/rspeedy-app-config.js

@@ -0,0 +1,32 @@
+import { join } from "node:path";
+import { createJiti } from "jiti";
+import { LynxShipError } from "@lynxship/contracts";
+function buildError(code, message) {
+    return new LynxShipError(code, message);
+}
+async function loadProjectRspeedy(root) {
+    try {
+        const jiti = createJiti(join(root, "package.json"), {
+            fsCache: false,
+            moduleCache: false,
+            sourceMaps: false,
+        });
+        const module = (await jiti.import("@lynx-js/rspeedy"));
+        if (typeof module.createRspeedy !== "function")
+            throw new Error("@lynx-js/rspeedy does not expose createRspeedy");
+        return module;
+    }
+    catch (error) {
+        throw buildError("CLI_RSPEEDY_REQUIRED", `A Lynx app.config was found, but @lynx-js/rspeedy could not be loaded from the project: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/** Build the `lynxConfig` exported by app.config without generating a proxy file. */
+export async function buildRspeedyAppConfig(root, appConfig) {
+    const { createRspeedy } = await loadProjectRspeedy(root);
+    const instance = await createRspeedy({
+        cwd: root,
+        rspeedyConfig: appConfig.config.lynxConfig,
+        callerName: "lynxship",
+    });
+    await instance.build();
+}

package/dist/runtime/args.d.ts

@@ -0,0 +1,3 @@
+export declare function projectDirectoryFlag(values: readonly string[]): string | undefined;
+export declare function readFlag(values: readonly string[], name: string, fallback?: string | null): string | null;
+//# sourceMappingURL=args.d.ts.map

package/dist/runtime/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/runtime/args.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,MAAM,GAAG,SAAS,CAKpB;AAED,wBAAgB,QAAQ,CACtB,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,MAAM,GAAG,IAAI,CAGf"}

package/dist/runtime/args.js

@@ -0,0 +1,11 @@
+export function projectDirectoryFlag(values) {
+    const index = values.indexOf("--project-dir");
+    if (index >= 0)
+        return values[index + 1];
+    const inline = values.find((value) => value.startsWith("--project-dir="));
+    return inline?.slice("--project-dir=".length);
+}
+export function readFlag(values, name, fallback = null) {
+    const index = values.indexOf(name);
+    return index >= 0 ? (values[index + 1] ?? "true") : fallback;
+}

package/dist/runtime/build-commands.d.ts

@@ -0,0 +1,3 @@
+import type { CliRuntime } from "./context.js";
+export declare function runBuildOrStateCommand(context: CliRuntime, command: string): Promise<void>;
+//# sourceMappingURL=build-commands.d.ts.map

package/dist/runtime/build-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-commands.d.ts","sourceRoot":"","sources":["../../src/runtime/build-commands.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAgRf"}

package/dist/runtime/build-commands.js

@@ -0,0 +1,282 @@
+import { assert } from "@lynxship/contracts";
+import { loadConfig, platformValue, resolveProfile, } from "../config.js";
+import { ensureNativeHostForBuild, initializeBuildProject, } from "../commands/project.js";
+import { executeBuild } from "../commands/build-execution.js";
+import { runOtaCommand } from "../commands/ota.js";
+import { runSubmit } from "../commands/submit.js";
+import { executeRemoteBuild } from "../commands/remote-build.js";
+import { cancelRemoteBuild, ensureRemoteTarget, getRemoteBuild, listRemoteBuilds, retryRemoteBuild, } from "../remote.js";
+import { prepareRemoteSource } from "../commands/remote-build.js";
+import { loadState, saveState } from "./state.js";
+export async function runBuildOrStateCommand(context, command) {
+    if (command === "build")
+        await initializeBuildProject(context.projectCommandContext);
+    const { state, repository, builds, submissions } = await loadState(context.root);
+    if (command === "rollback" || command === "update") {
+        await runOtaCommand({
+            root: context.root,
+            args: context.args,
+            ui: context.ui,
+            flag: context.flag,
+            printValue: context.printValue,
+            requireOperationalConfiguration: (target) => context.requireOperationalConfiguration(target),
+            requireR2Configuration: context.requireR2Configuration,
+            configuredProjectId: context.configuredProjectId,
+            mobilePlatformValue: context.mobilePlatformValue,
+            state,
+            repository,
+            builds,
+            submissions,
+        }, command);
+        return;
+    }
+    if (command === "submit") {
+        await runSubmit({
+            root: context.root,
+            args: context.args,
+            ui: context.ui,
+            flag: context.flag,
+            printValue: context.printValue,
+            requireOperationalConfiguration: context.requireOperationalConfiguration,
+            configuredProjectId: context.configuredProjectId,
+            mobilePlatformValue: context.mobilePlatformValue,
+            state,
+            repository,
+            builds,
+            submissions,
+        });
+        return;
+    }
+    const subcommand = context.args[0] && !context.args[0].startsWith("--")
+        ? (context.args.shift() ?? "create")
+        : "create";
+    const platformArgument = context.flag("--platform", "android");
+    const buildAll = subcommand === "all" || platformArgument === "all";
+    const platform = buildAll ? "android" : platformValue(platformArgument);
+    const simulator = context.args.includes("--simulator");
+    const remote = context.args.includes("--remote");
+    const skipUpload = context.args.includes("--no-upload") || simulator;
+    assert(!remote || !context.args.includes("--local"), "CLI_BUILD_FLAGS", "--remote and --local are mutually exclusive.");
+    assert(!remote || !simulator, "CLI_BUILD_FLAGS", "--remote cannot create a local iOS Simulator app. Use a local macOS build for simulator output.");
+    assert(!remote || !context.args.includes("--no-upload"), "CLI_BUILD_FLAGS", "--remote always stores the build artifact on the configured remote worker; remove --no-upload.");
+    assert(!simulator || platformArgument === "ios", "IOS_SIMULATOR_PLATFORM", "The --simulator option is only available with --platform ios.");
+    const allowUnsigned = context.args.includes("--allow-unsigned");
+    assert(!allowUnsigned || skipUpload, "CLI_UNSIGNED_UPLOAD_BLOCKED", "--allow-unsigned is only available with --no-upload and can never upload an unsigned Desktop artifact.");
+    await context.requireOperationalConfiguration(platform, {
+        requireR2: remote ? false : !skipUpload,
+        requireSigning: !remote,
+    });
+    if (remote && ["list", "status", "cancel", "retry"].includes(subcommand)) {
+        const config = await loadConfig(context.root);
+        const remoteState = state;
+        if (subcommand === "list") {
+            context.printValue(await listRemoteBuilds(config, remoteState));
+            return;
+        }
+        const id = context.args[0];
+        assert(id, "CLI_BUILD_ID_REQUIRED", `A build id is required for ${subcommand}.`);
+        const job = subcommand === "status"
+            ? await getRemoteBuild(config, id)
+            : subcommand === "cancel"
+                ? await cancelRemoteBuild(config, id)
+                : await retryRemoteBuild(config, id);
+        if (subcommand !== "status") {
+            builds.restore([
+                ...builds.list().filter((candidate) => candidate.id !== job.id),
+                job,
+            ]);
+            await saveState(state, repository, builds, submissions);
+        }
+        context.printValue(job);
+        return;
+    }
+    if (subcommand === "list") {
+        context.printValue(builds.list());
+        return;
+    }
+    const id = context.args[0];
+    if (subcommand === "status") {
+        context.printValue(builds.get(id ?? ""));
+        return;
+    }
+    if (subcommand === "cancel") {
+        const job = builds.cancel(id ?? "");
+        await saveState(state, repository, builds, submissions);
+        context.printValue(job);
+        return;
+    }
+    if (subcommand === "retry") {
+        const job = builds.retry(id ?? "");
+        await saveState(state, repository, builds, submissions);
+        context.printValue(job);
+        return;
+    }
+    assert(subcommand === "create" || buildAll, "CLI_BUILD_COMMAND", `Unknown build command: ${subcommand}`);
+    const config = await loadConfig(context.root);
+    const profile = context.flag("--profile", simulator ? "simulator" : "production");
+    const simulatorDevice = context.flag("--device") ?? undefined;
+    const simulatorAutostart = simulator &&
+        !context.args.includes("--no-autostart") &&
+        (context.args.includes("--autostart") ||
+            (!context.json && context.ui.interactive));
+    const wait = !context.args.includes("--no-wait");
+    const local = context.args.includes("--local");
+    const platforms = buildAll
+        ? ["android", "ios", "harmony", "web", "desktop"]
+        : [platform];
+    if (buildAll && wait && !local && !remote) {
+        assert(process.platform === "darwin", "BUILD_ALL_MACOS_REQUIRED", "A real all-target build includes iOS and therefore requires macOS locally. Run supported targets individually on Windows/Linux, or use a macOS CI worker for the complete matrix.");
+        for (const target of platforms)
+            await ensureNativeHostForBuild(context.projectCommandContext, target, profile, config);
+    }
+    if (remote) {
+        const loaded = { state, repository, builds, submissions };
+        if (buildAll) {
+            const source = await prepareRemoteSource(context.root, config, state);
+            await ensureRemoteTarget(config, state);
+            const outcomes = await Promise.all(platforms.map((target) => executeRemoteBuild({
+                root: context.root,
+                config,
+                state,
+                loaded,
+                platform: target,
+                profile,
+                wait,
+                source,
+                printValue: context.printValue,
+                ui: context.ui,
+            })));
+            context.printValue({
+                status: outcomes.every((job) => job.state === "success")
+                    ? "success"
+                    : outcomes.some((job) => ["failed", "timed_out"].includes(job.state))
+                        ? "failed"
+                        : "queued",
+                builds: outcomes,
+            });
+        }
+        else {
+            await executeRemoteBuild({
+                root: context.root,
+                config,
+                state,
+                loaded,
+                platform,
+                profile,
+                wait,
+                printValue: context.printValue,
+                ui: context.ui,
+            });
+        }
+        return;
+    }
+    const buildOptions = {
+        root: context.root,
+        ui: context.ui,
+        json: context.json,
+        ensureNativeHostForBuild: (target, selectedProfile, selectedConfig) => ensureNativeHostForBuild(context.projectCommandContext, target, selectedProfile, selectedConfig),
+        requireAutolinkReady: context.requireAutolinkReady,
+        configuredProjectId: context.configuredProjectId,
+        printValue: context.printValue,
+        config,
+        profile,
+        platform,
+        skipUpload,
+        allowUnsigned,
+        wait,
+        local,
+        simulator,
+        simulatorDevice,
+        simulatorAutostart,
+        state,
+        repository,
+        builds,
+        submissions,
+    };
+    if (!buildAll) {
+        await executeBuild(buildOptions);
+        return;
+    }
+    if (buildAll && wait && !local)
+        await context.buildSharedLynxBundle(resolveProfile(config, profile).miso);
+    await runAllBuilds(context, {
+        ...buildOptions,
+        platforms,
+    });
+}
+async function runAllBuilds(context, options) {
+    const progress = options.ui.progress("All Lynx targets build");
+    const progressValues = {};
+    const progressLabels = {};
+    const platformName = (target) => target === "android"
+        ? "Android"
+        : target === "ios"
+            ? "iOS"
+            : target === "harmony"
+                ? "HarmonyOS"
+                : target === "web"
+                    ? "Web"
+                    : "Desktop";
+    const outcomes = await Promise.allSettled(options.platforms.map((target) => executeBuild({
+        ...options,
+        platform: target,
+        progress,
+        progressPrefix: platformName(target),
+        skipBundleBuild: options.wait && !options.local && target !== "web",
+        onEvent: (message) => progress.event(`${platformName(target)} · ${message}`),
+        onProgress: (value, label) => {
+            if (value !== undefined)
+                progressValues[target] = value;
+            if (label)
+                progressLabels[target] = label;
+            const average = options.platforms.reduce((total, current) => total + (progressValues[current] ?? 0), 0) / options.platforms.length;
+            progress.update(average, `${platformName(target)} · ${progressLabels[target] ?? ""}`);
+        },
+    }, false)));
+    progress.update(100, "All Lynx target builds finished");
+    progress.stop();
+    const summaryBuilds = outcomes.map((outcome, index) => {
+        if (outcome.status === "fulfilled")
+            return outcome.value;
+        const error = outcome.reason;
+        const buildId = error && typeof error === "object" && "buildId" in error
+            ? String(error.buildId)
+            : undefined;
+        const job = buildId ? options.builds.jobs.get(buildId) : undefined;
+        return (job ?? {
+            platform: options.platforms[index] ?? "android",
+            state: "failed",
+            error: error instanceof Error ? error.message : String(error),
+        });
+    });
+    const failed = summaryBuilds.some((result) => result.state === "failed");
+    context.printValue({
+        status: failed
+            ? "failed"
+            : summaryBuilds.every((result) => result.state === "success")
+                ? "success"
+                : "queued",
+        builds: summaryBuilds,
+    }, {
+        title: "Build all result",
+        rows: summaryBuilds.map((result) => ({
+            label: platformName(result.platform),
+            value: `${result.state}${"id" in result ? ` · ${result.id}` : ""}`,
+            valueColor: result.state === "success"
+                ? "green"
+                : result.state === "failed"
+                    ? "red"
+                    : "yellow",
+        })),
+        done: failed
+            ? "At least one platform build failed. Review its events and retry that platform."
+            : "All Lynx target build jobs completed. Submit supported store artifacts separately.",
+    });
+    for (const result of summaryBuilds)
+        if (result.state === "success" &&
+            "artifact" in result &&
+            result.artifact?.url)
+            options.ui.downloadArtifact(result.artifact.url, result.artifact.expiresAt);
+    if (failed)
+        process.exitCode = 5;
+}

package/dist/runtime/context.d.ts

@@ -0,0 +1,63 @@
+import { type MobilePlatform, type Platform } from "@lynxship/contracts";
+import { type BuildProfile, type LynxShipConfig } from "../config.js";
+import { type BoxRow } from "../ui/index.js";
+import { prompt } from "../prompt.js";
+import { requireAutolinkReady } from "../autolink.js";
+interface View {
+    title: string;
+    rows: BoxRow[];
+    done: string;
+}
+export declare function createCliRuntime(rawArgs: string[]): {
+    rawArgs: string[];
+    args: string[];
+    ui: import("../ui/index.js").CliUi;
+    json: boolean;
+    root: string;
+    flag: (name: string, fallback?: string | null) => string | null;
+    projectCommandContext: {
+        root: string;
+        ui: import("../ui/index.js").CliUi;
+        flag: (name: string, fallback?: string | null) => string | null;
+        prompt: typeof prompt;
+    };
+    commandContext: {
+        root: string;
+        args: string[];
+        ui: import("../ui/index.js").CliUi;
+        json: boolean;
+        flag: (name: string, fallback?: string | null) => string | null;
+        project: {
+            root: string;
+            ui: import("../ui/index.js").CliUi;
+            flag: (name: string, fallback?: string | null) => string | null;
+            prompt: typeof prompt;
+        };
+        printValue: (value: unknown, view?: View) => void;
+        mobilePlatformValue: (value: string) => MobilePlatform;
+    };
+    printValue: (value: unknown, view?: View) => void;
+    assertInteractivePrompt: (label: string, fallback: string, optionName: string) => Promise<string>;
+    requireProjectRoot: () => Promise<void>;
+    readConfigurationStatus: () => Promise<{
+        r2: boolean;
+        android: boolean;
+    }>;
+    requireOperationalConfiguration: (platform: Platform, options?: {
+        requireR2?: boolean;
+        requireSigning?: boolean;
+    }) => Promise<void>;
+    requireR2Configuration: () => Promise<void>;
+    configuredProjectId: (config: LynxShipConfig) => string;
+    mobilePlatformValue: (value: string) => MobilePlatform;
+    renderConfigurationFooter: () => Promise<void>;
+    buildSharedLynxBundle: (miso: BuildProfile["miso"]) => Promise<void>;
+    initSelfHost: () => Promise<{
+        status: string;
+        file: string;
+    }>;
+    requireAutolinkReady: typeof requireAutolinkReady;
+};
+export type CliRuntime = ReturnType<typeof createCliRuntime>;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/runtime/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAItD,UAAU,IAAI;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE;;;;;;iBAQ5B,MAAM,aAAY,MAAM,GAAG,IAAI,KAAU,MAAM,GAAG,IAAI;;;;qBAAtD,MAAM,aAAY,MAAM,GAAG,IAAI,KAAU,MAAM,GAAG,IAAI;;;;;;;;qBAAtD,MAAM,aAAY,MAAM,GAAG,IAAI,KAAU,MAAM,GAAG,IAAI;;;;yBAAtD,MAAM,aAAY,MAAM,GAAG,IAAI,KAAU,MAAM,GAAG,IAAI;;;4BAG/C,OAAO,SAAS,IAAI,KAAG,IAAI;qCAyGlB,MAAM,KAAG,cAAc;;wBAzGhC,OAAO,SAAS,IAAI,KAAG,IAAI;qCAkB7C,MAAM,YACH,MAAM,cACJ,MAAM,KACjB,OAAO,CAAC,MAAM,CAAC;8BASmB,OAAO,CAAC,IAAI,CAAC;mCAQR,OAAO,CAAC;QAChD,EAAE,EAAE,OAAO,CAAC;QACZ,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;gDA0BU,QAAQ,YACT;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,KACzD,OAAO,CAAC,IAAI,CAAC;kCAiByB,OAAO,CAAC,IAAI,CAAC;kCAUjB,cAAc,KAAG,MAAM;iCASxB,MAAM,KAAG,cAAc;qCAUf,OAAO,CAAC,IAAI,CAAC;kCA+BjD,YAAY,CAAC,MAAM,CAAC,KACzB,OAAO,CAAC,IAAI,CAAC;wBAkBe,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;;EAsDzE;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}