@lynxship/cli 0.1.20 → 0.1.21

package/dist/app-config.js

@@ -0,0 +1,106 @@
+import { readFile, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { createJiti } from "jiti";
+import { join, relative, resolve } from "node:path";
+import { LynxShipError } from "@lynxship/contracts";
+import { FrameworkError, normalizeLynxShipAppConfig, } from "@lynxship/framework";
+const APP_CONFIG_FILES = [
+    "app.config.ts",
+    "app.config.js",
+    "app.config.mts",
+    "app.config.mjs",
+    "app.config.cts",
+    "app.config.cjs",
+];
+const MAX_APP_CONFIG_BYTES = 512 * 1024;
+function appConfigError(code, message, details = {}) {
+    return new LynxShipError(code, message, details);
+}
+function isInsideRoot(root, candidate) {
+    const rootPath = resolve(root);
+    const candidatePath = resolve(candidate);
+    const relativePath = relative(rootPath, candidatePath);
+    return relativePath === "" || relativePath.split(/[\\/]/u)[0] !== "..";
+}
+/** Find the single Sparkling-compatible app config without executing it. */
+export function findAppConfig(root) {
+    const matches = APP_CONFIG_FILES.map((file) => join(root, file)).filter((file) => existsSync(file));
+    if (matches.length > 1) {
+        throw appConfigError("CLI_APP_CONFIG_AMBIGUOUS", `Multiple app.config files were found. Keep exactly one: ${matches.join(", ")}`, { files: matches });
+    }
+    return matches[0];
+}
+async function readConfigSource(path) {
+    const info = await stat(path).catch(() => undefined);
+    if (!info?.isFile())
+        throw appConfigError("CLI_APP_CONFIG_INVALID", `The app config is not a regular file: ${path}`, { path });
+    if (info.size > MAX_APP_CONFIG_BYTES)
+        throw appConfigError("CLI_APP_CONFIG_TOO_LARGE", `The app config exceeds the ${MAX_APP_CONFIG_BYTES} byte limit: ${path}`, { path, maxBytes: MAX_APP_CONFIG_BYTES });
+    return readFile(path, "utf8");
+}
+function isLynxAppConfigSource(source) {
+    return /\blynxConfig\b/.test(source);
+}
+async function resolveExport(value, context) {
+    if (typeof value === "function")
+        return value(context);
+    return value;
+}
+/**
+ * Load and validate a Sparkling-style app.config file only on an explicit
+ * command path. Discovery remains source-only so `doctor` and project scans
+ * never execute arbitrary project modules accidentally.
+ */
+export async function loadAppConfig(root, options = {}) {
+    const path = findAppConfig(root);
+    if (!path)
+        return undefined;
+    const source = await readConfigSource(path);
+    if (!isLynxAppConfigSource(source)) {
+        if (options.required)
+            throw appConfigError("CLI_APP_CONFIG_LYNX_REQUIRED", `The app config does not expose a lynxConfig property: ${path}`, { path });
+        return undefined;
+    }
+    try {
+        const jiti = createJiti(path, {
+            fsCache: false,
+            moduleCache: false,
+            sourceMaps: false,
+            tsconfigPaths: true,
+        });
+        const exported = await jiti.import(path, { default: true });
+        const value = await resolveExport(exported, {
+            command: options.command ?? "build",
+            env: process.env.NODE_ENV ?? "production",
+        });
+        if (typeof value !== "object" || value === null || Array.isArray(value))
+            throw appConfigError("CLI_APP_CONFIG_INVALID", "app.config must export an object or a function returning an object.", { path });
+        return {
+            path,
+            config: normalizeLynxShipAppConfig(value),
+        };
+    }
+    catch (error) {
+        if (error instanceof LynxShipError)
+            throw error;
+        if (error instanceof FrameworkError)
+            throw appConfigError("CLI_APP_CONFIG_INVALID", `Invalid Lynx app config ${path}: ${error.message}`, { path, frameworkCode: error.code });
+        throw appConfigError("CLI_APP_CONFIG_LOAD_FAILED", `Could not load ${path}: ${error instanceof Error ? error.message : String(error)}`, { path });
+    }
+}
+/** Resolve an app.config asset destination while keeping it inside the project. */
+export function resolveAppConfigAssetPath(root, config, platform, fallback) {
+    const configured = config?.config.paths?.[platform];
+    const destination = resolve(root, configured ?? fallback);
+    if (!isInsideRoot(root, destination))
+        throw appConfigError("CLI_APP_CONFIG_PATH_OUTSIDE_PROJECT", `app.config paths.${platform} must remain inside the project: ${configured}`, { platform, path: configured });
+    return destination;
+}
+export function resolveAppConfigProjectPath(root, value, field) {
+    if (!value)
+        return undefined;
+    const path = resolve(root, value);
+    if (!isInsideRoot(root, path))
+        throw appConfigError("CLI_APP_CONFIG_PATH_OUTSIDE_PROJECT", `app.config ${field} must remain inside the project: ${value}`, { field, path: value });
+    return path;
+}

package/dist/bundle-build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle-build.d.ts","sourceRoot":"","sources":["../src/bundle-build.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;SAChD,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,GAAG,SAAS,CAWpB;AAuGD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Df"}
+{"version":3,"file":"bundle-build.d.ts","sourceRoot":"","sources":["../src/bundle-build.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;SAChD,CAAC;KACH,CAAC;CACH;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,GAAG,SAAS,CAWpB;AAuGD,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAwEf"}

package/dist/bundle-build.js

@@ -4,6 +4,8 @@ import { assert, LynxShipError } from "@lynxship/contracts";
 import { acquireMicroHs } from "@lynxship/microhs";
 import { commandExists, packageManagerScriptCommand, runProcess, runRspeedy, } from "./process-runner.js";
 import { detectLynxFramework } from "./frameworks.js";
+import { loadAppConfig } from "./app-config.js";
+import { buildRspeedyAppConfig } from "./rspeedy-app-config.js";
 export function resolveMisoBuildTarget(flake, configuredAttribute) {
     const explicitAttribute = configuredAttribute?.trim();
     if (explicitAttribute)
@@ -111,6 +113,15 @@ export async function buildLynxBundle(root, options = {}) {
         await copyMisoBundle(root, options.miso?.artifact ?? "result/main.lynx.bundle", options.onOutput);
         return;
     }
+    if (!options.script && !options.rspeedyArgs) {
+        const appConfig = await loadAppConfig(root, { required: false });
+        if (appConfig) {
+            options.onOutput?.(`Building Rspeedy from ${appConfig.path}`);
+            await buildRspeedyAppConfig(root, appConfig);
+            options.onOutput?.("Rspeedy app.config bundle ready");
+            return;
+        }
+    }
     if (!options.script && options.rspeedyArgs) {
         await runRspeedy(root, "build", options.rspeedyArgs, {
             env: options.env,

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { runEarlyCommand, commandHeader } from "./runtime/early-commands.js";
+import { createCliRuntime } from "./runtime/context.js";
+import { runBuildOrStateCommand } from "./runtime/build-commands.js";
+import { guidanceForError } from "./guidance.js";
+import { exitCode } from "./commands/metadata.js";
+const rawArgs = process.argv.slice(2);
+const context = createCliRuntime(rawArgs);
+async function runCli() {
+    const command = context.args.shift() ?? "help";
+    const wantsHelp = command === "help" ||
+        command === "--help" ||
+        command === "-h" ||
+        rawArgs.includes("--help") ||
+        rawArgs.includes("-h");
+    const shouldShowBanner = !context.json &&
+        (wantsHelp || rawArgs.length === 0 || rawArgs.includes("--banner"));
+    if (shouldShowBanner)
+        context.ui.banner();
+    if (wantsHelp) {
+        const { helpText } = await import("./commands/help.js");
+        if (context.ui.interactive)
+            context.ui.header("Help");
+        context.printValue(helpText());
+        return;
+    }
+    context.ui.header(commandHeader(command, context.args));
+    context.ui.debug(`cwd=${context.root}`);
+    if (await runEarlyCommand(context, command))
+        return;
+    await runBuildOrStateCommand(context, command);
+}
+void runCli()
+    .catch((error) => {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    const code = error.code ?? "CLI_ERROR";
+    const nextSteps = guidanceForError(error, { args: rawArgs });
+    if (context.json) {
+        console.log(JSON.stringify({
+            error: message,
+            code,
+            ...(nextSteps.commands.length > 0
+                ? {
+                    nextSteps: nextSteps.commands,
+                    ...(nextSteps.note ? { note: nextSteps.note } : {}),
+                    ...(nextSteps.environment
+                        ? { environment: nextSteps.environment }
+                        : {}),
+                }
+                : {}),
+        }));
+    }
+    else {
+        context.ui.error(message);
+        context.ui.nextSteps(nextSteps);
+    }
+    process.exitCode = exitCode(error);
+})
+    .finally(async () => {
+    try {
+        await context.renderConfigurationFooter();
+    }
+    catch {
+        // Configuration status must never hide the original command result.
+    }
+});

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

@@ -0,0 +1,41 @@
+import type { BuildJob, MobilePlatform, Platform } from "@lynxship/contracts";
+import { BuildOrchestrator } from "@lynxship/build-orchestrator";
+import type { JsonRepository } from "@lynxship/db";
+import { SubmissionService } from "@lynxship/submit";
+import { type LynxShipConfig } from "../config.js";
+import { type CliState } from "../runtime/state.js";
+import { type BoxRow, CliUi, type ProgressHandle } from "../ui/index.js";
+export interface BuildExecutionOptions {
+    root: string;
+    ui: CliUi;
+    json: boolean;
+    ensureNativeHostForBuild: (platform: Platform, profile: string, config: LynxShipConfig) => Promise<void>;
+    requireAutolinkReady: (root: string, platform: MobilePlatform) => Promise<unknown>;
+    configuredProjectId: (config: LynxShipConfig) => string;
+    printValue: (value: unknown, view?: {
+        title: string;
+        rows: BoxRow[];
+        done: string;
+    }) => void;
+    config: LynxShipConfig;
+    profile: string;
+    platform: Platform;
+    skipUpload: boolean;
+    wait: boolean;
+    local: boolean;
+    state: CliState;
+    repository: JsonRepository<CliState>;
+    builds: BuildOrchestrator;
+    submissions: SubmissionService;
+    allowUnsigned: boolean;
+    progress?: ProgressHandle;
+    progressPrefix?: string;
+    onProgress?: (value?: number, label?: string) => void;
+    onEvent?: (message: string) => void;
+    skipBundleBuild?: boolean;
+    simulator?: boolean;
+    simulatorDevice?: string;
+    simulatorAutostart?: boolean;
+}
+export declare function executeBuild(options: BuildExecutionOptions, showResult?: boolean): Promise<BuildJob>;
+//# sourceMappingURL=build-execution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-execution.d.ts","sourceRoot":"","sources":["../../src/commands/build-execution.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAoB/E,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,OAAO,CAAC;IACd,wBAAwB,EAAE,CACxB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,oBAAoB,EAAE,CACpB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,cAAc,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,mBAAmB,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,MAAM,CAAC;IACxD,UAAU,EAAE,CACV,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KACnD,IAAI,CAAC;IACV,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,qBAAqB,EAC9B,UAAU,UAAO,GAChB,OAAO,CAAC,QAAQ,CAAC,CAsNnB"}

package/dist/commands/build-execution.js

@@ -0,0 +1,182 @@
+import { createHash } from "node:crypto";
+import { assert } from "@lynxship/contracts";
+import { loadConfig, resolveProfile } from "../config.js";
+import { applyProjectPlugins } from "../plugins.js";
+import { hasAndroidHost, isSupportedAndroidPlatform, runRealAndroidBuild, } from "../android-build.js";
+import { hasIosHost, runRealIosBuild } from "../ios-build.js";
+import { inspectAndroidToolchain, formatAndroidToolchainFailure, } from "../android-toolchain.js";
+import { inspectIosToolchain, formatIosToolchainFailure, } from "../ios-toolchain.js";
+import { runRealHarmonyBuild } from "../harmony-build.js";
+import { runRealWebBuild } from "../web-build.js";
+import { runRealDesktopBuild } from "../desktop-build.js";
+import { inspectRuntimeFingerprint } from "../runtime-fingerprint.js";
+import { saveState } from "../runtime/state.js";
+export async function executeBuild(options, showResult = true) {
+    const { root, ui, json, ensureNativeHostForBuild, requireAutolinkReady, configuredProjectId, printValue, config, profile, platform, skipUpload, wait, local, state, repository, builds, submissions, progress: sharedProgress, progressPrefix, onProgress, onEvent, skipBundleBuild, simulator = false, simulatorDevice, simulatorAutostart = false, } = options;
+    if (wait && !local)
+        await ensureNativeHostForBuild(platform, profile, config);
+    // Host initialization can write lynxship.json (for example, the generated
+    // iOS scheme). Always read it again before resolving the build profile so a
+    // first build uses the host that was just created in the same invocation.
+    const loadedConfig = wait && !local ? await loadConfig(root) : config;
+    const pluginApplication = wait && !local
+        ? await applyProjectPlugins(root, loadedConfig, { platform, profile })
+        : {
+            config: loadedConfig,
+            report: { configured: 0, plugins: [] },
+            applied: [],
+            templates: [],
+            cloud: [],
+            build: [],
+            changes: [],
+            autolink: [],
+        };
+    const effectiveConfig = pluginApplication.config;
+    if (platform === "android" || platform === "ios")
+        await requireAutolinkReady(root, platform);
+    const runtime = await inspectRuntimeFingerprint(root, platform, effectiveConfig);
+    const resolvedBuildProfile = resolveProfile(effectiveConfig, profile);
+    const job = await builds.create({
+        projectId: configuredProjectId(effectiveConfig),
+        organizationId: "local_org",
+        platform,
+        profile,
+        sourceHash: createHash("sha256").update(root).digest("hex"),
+        runtimeVersion: runtime.value,
+        runtimeInputs: runtime.inputs,
+    });
+    ui.info(`Using profile: ${profile} · platform: ${platform}`);
+    const ownsProgress = !sharedProgress;
+    const progress = sharedProgress ??
+        ui.progress(`${platform[0].toUpperCase()}${platform.slice(1)} build`);
+    const prefix = progressPrefix ? `${progressPrefix} · ` : "";
+    const reportEvent = (message) => {
+        if (onEvent)
+            onEvent(message);
+        else
+            progress.event(`${prefix}${message}`);
+    };
+    const reportProgress = (value, label) => {
+        if (onProgress)
+            onProgress(value, label);
+        else
+            progress.update(value, label ? `${prefix}${label}` : undefined);
+    };
+    try {
+        reportProgress(undefined, "Preparing build pipeline…");
+        if (wait) {
+            if (platform === "android" && !isSupportedAndroidPlatform() && !local)
+                assert(false, "ANDROID_PLATFORM_UNSUPPORTED", "Android builds are supported only on Linux, macOS and Windows.");
+            const realAndroid = platform === "android" &&
+                isSupportedAndroidPlatform() &&
+                (await hasAndroidHost(root));
+            const realIos = platform === "ios" &&
+                hasIosHost(root, resolveProfile(effectiveConfig, profile));
+            if (platform === "ios" && !realIos && !local)
+                assert(false, "IOS_HOST_REQUIRED", "A macOS Xcode host is required for a real iOS build. Run `lynxship ios host init --bundle-identifier <id>` or pass --bundle-identifier <id> to build.");
+            if (platform === "android" && !realAndroid && !local)
+                assert(false, "ANDROID_HOST_REQUIRED", "This project has no Android Gradle host. Run `lynxship android host init --application-id <id>` or pass --application-id <id> to build. `lynxship dev` remains available for Lynx Explorer; `--local` does not create an APK.");
+            if (realAndroid) {
+                const toolchain = await inspectAndroidToolchain(root);
+                assert(toolchain.ok, "ANDROID_TOOLCHAIN_REQUIRED", `Android toolchain is not ready: ${formatAndroidToolchainFailure(toolchain)}`);
+                await runRealAndroidBuild(job, {
+                    root,
+                    profile: resolvedBuildProfile,
+                    uploadArtifacts: !skipUpload,
+                    skipBundleBuild,
+                    quiet: json,
+                    onEvent: reportEvent,
+                    onProgress: reportProgress,
+                });
+            }
+            else if (realIos) {
+                const toolchain = await inspectIosToolchain(root, resolveProfile(effectiveConfig, profile), simulator ? "simulator" : "device");
+                assert(toolchain.ok, "IOS_TOOLCHAIN_REQUIRED", `iOS toolchain is not ready: ${formatIosToolchainFailure(toolchain)}`);
+                await runRealIosBuild(job, {
+                    root,
+                    profile: resolvedBuildProfile,
+                    simulator,
+                    simulatorDevice,
+                    simulatorAutostart,
+                    uploadArtifacts: !skipUpload,
+                    skipBundleBuild,
+                    quiet: json,
+                    onEvent: reportEvent,
+                    onProgress: reportProgress,
+                });
+            }
+            else if (!local && platform === "web") {
+                await runRealWebBuild(job, {
+                    root,
+                    profile: resolveProfile(effectiveConfig, profile),
+                    uploadArtifacts: !skipUpload,
+                    skipBundleBuild,
+                    quiet: json,
+                    onEvent: reportEvent,
+                    onProgress: reportProgress,
+                });
+            }
+            else if (!local && platform === "harmony") {
+                await runRealHarmonyBuild(job, {
+                    root,
+                    profile: resolveProfile(effectiveConfig, profile),
+                    uploadArtifacts: !skipUpload,
+                    skipBundleBuild,
+                    quiet: json,
+                    onEvent: reportEvent,
+                    onProgress: reportProgress,
+                });
+            }
+            else if (!local && platform === "desktop") {
+                await runRealDesktopBuild(job, {
+                    root,
+                    profile: resolveProfile(effectiveConfig, profile),
+                    uploadArtifacts: !skipUpload,
+                    allowUnsigned: options.allowUnsigned,
+                    skipBundleBuild,
+                    quiet: json,
+                    onEvent: reportEvent,
+                    onProgress: reportProgress,
+                });
+            }
+            else {
+                await builds.run(job.id);
+            }
+        }
+        reportProgress(100);
+        await saveState(state, repository, builds, submissions);
+    }
+    catch (error) {
+        await saveState(state, repository, builds, submissions);
+        if (error instanceof Error) {
+            Object.assign(error, { buildId: job.id });
+        }
+        throw error;
+    }
+    finally {
+        if (ownsProgress)
+            progress.stop();
+    }
+    const result = builds.get(job.id);
+    if (showResult) {
+        printValue(result, {
+            title: `${platform[0].toUpperCase()}${platform.slice(1)} build result`,
+            rows: [
+                { label: "Build ID", value: result.id, valueColor: "purple" },
+                { label: "Platform", value: result.platform, valueColor: "blue" },
+                { label: "Profile", value: result.profile, valueColor: "text" },
+                {
+                    label: "Status",
+                    value: result.state,
+                    valueColor: result.state === "success" ? "green" : "yellow",
+                },
+            ],
+            done: result.state === "success"
+                ? "Build complete. Run lynxship submit to publish."
+                : "Build queued.",
+        });
+        if (result.state === "success" && result.artifact?.url)
+            ui.downloadArtifact(result.artifact.url, result.artifact.expiresAt);
+    }
+    return result;
+}

package/dist/commands/configuration.d.ts

@@ -0,0 +1,19 @@
+import type { ProjectCommandContext } from "./project.js";
+import type { BoxRow, CliUi } from "../ui/index.js";
+export interface ConfigurationCommandContext {
+    root: string;
+    args: string[];
+    ui: CliUi;
+    flag: (name: string, fallback?: string | null) => string | null;
+    printValue: (value: unknown, view?: {
+        title: string;
+        rows: BoxRow[];
+        done: string;
+    }) => void;
+    project: ProjectCommandContext;
+    assertInteractivePrompt: (label: string, fallback: string, optionName: string) => Promise<string>;
+    initializeBuildProject: (context: ProjectCommandContext) => Promise<unknown>;
+    mobilePlatformValue: (value: string) => "android" | "ios";
+}
+export declare function runConfigurationCommands(context: ConfigurationCommandContext, command: string): Promise<void>;
+//# sourceMappingURL=configuration.d.ts.map

package/dist/commands/configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/commands/configuration.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;IAChE,UAAU,EAAE,CACV,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KACnD,IAAI,CAAC;IACV,OAAO,EAAE,qBAAqB,CAAC;IAC/B,uBAAuB,EAAE,CACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,GAAG,KAAK,CAAC;CAC3D;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,2BAA2B,EACpC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAmPf"}

package/dist/commands/configuration.js

@@ -0,0 +1,174 @@
+import { basename, join } from "node:path";
+import { assert } from "@lynxship/contracts";
+import { configureAndroid, configureAppStoreConnect, configureGooglePlay, configureR2, } from "../configure.js";
+import { initializeAndroidHost, suggestedAndroidApplicationId, } from "../android-host.js";
+import { initializeIosHost, suggestedIosBundleIdentifier, } from "../ios-host.js";
+import { credentialStorageDescription } from "../secure-store.js";
+export async function runConfigurationCommands(context, command) {
+    const { root, args, ui, flag, printValue, project, assertInteractivePrompt, initializeBuildProject, mobilePlatformValue, } = context;
+    if (command === "storage") {
+        assert(ui.interactive, "CLI_INTERACTIVE_REQUIRED", "Run `lynxship storage configure` in an interactive terminal");
+        assert((args.shift() ?? "configure") === "configure", "CLI_STORAGE_COMMAND", "Only storage configure is available");
+        ui.info("Configuring Cloudflare R2. Secret fields will stay invisible…");
+        const config = await configureR2(root);
+        ui.success(`R2 bucket verified: ${config.bucket}`);
+        printValue({
+            status: "configured",
+            provider: "cloudflare-r2",
+            bucket: config.bucket,
+        }, {
+            title: "Cloudflare R2",
+            rows: [
+                { label: "Provider", value: "Cloudflare R2", valueColor: "orange" },
+                { label: "Bucket", value: config.bucket, valueColor: "blue" },
+                {
+                    label: "Credentials",
+                    value: credentialStorageDescription(),
+                    valueColor: "green",
+                },
+            ],
+            done: "R2 is ready for signed build artifacts.",
+        });
+        return;
+    }
+    if (command === "ios") {
+        const subcommand = args.shift() ?? "host";
+        assert(subcommand === "host" && (args.shift() ?? "init") === "init", "CLI_IOS_HOST_COMMAND", "Use `lynxship ios host init` to create an iOS host.");
+        await initializeBuildProject(project);
+        const suggestedId = suggestedIosBundleIdentifier(root);
+        const bundleIdentifier = flag("--bundle-identifier") ??
+            (await assertInteractivePrompt("iOS bundle identifier", suggestedId, "--bundle-identifier"));
+        const result = await initializeIosHost(root, {
+            bundleIdentifier,
+            appName: basename(root),
+            appIcon: flag("--icon") ?? undefined,
+        });
+        ui.success(`iOS host created: ${result.directory}`);
+        printValue({
+            status: "created",
+            platform: "ios",
+            directory: result.directory,
+            bundleIdentifier: result.bundleIdentifier,
+            project: result.project,
+            scheme: result.scheme,
+            configUpdated: result.configUpdated,
+        }, {
+            title: "iOS host",
+            rows: [
+                {
+                    label: "Bundle identifier",
+                    value: result.bundleIdentifier,
+                    valueColor: "blue",
+                },
+                {
+                    label: "Xcode project",
+                    value: result.project,
+                    valueColor: "green",
+                },
+                { label: "Scheme", value: result.scheme, valueColor: "purple" },
+                {
+                    label: "CocoaPods",
+                    value: "Run pod install on macOS before the first build",
+                    valueColor: "yellow",
+                },
+            ],
+            done: "iOS host is ready. Run lynxship doctor --platform ios on macOS.",
+        });
+        return;
+    }
+    if (command === "android") {
+        const subcommand = args.shift() ?? "configure";
+        if (subcommand === "host") {
+            assert((args.shift() ?? "init") === "init", "CLI_ANDROID_HOST_COMMAND", "Use `lynxship android host init` to create an Android host.");
+            await initializeBuildProject(project);
+            const suggestedId = suggestedAndroidApplicationId(root);
+            const applicationId = flag("--application-id") ??
+                (await assertInteractivePrompt("Android application ID", suggestedId, "--application-id"));
+            const result = await initializeAndroidHost(root, {
+                applicationId,
+                appName: basename(root),
+            });
+            ui.success(`Android host created: ${result.directory}`);
+            printValue({
+                status: "created",
+                platform: "android",
+                directory: result.directory,
+                applicationId: result.applicationId,
+            }, {
+                title: "Android host",
+                rows: [
+                    {
+                        label: "Application ID",
+                        value: result.applicationId,
+                        valueColor: "blue",
+                    },
+                    {
+                        label: "Gradle wrapper",
+                        value: join(result.directory, "gradlew"),
+                        valueColor: "green",
+                    },
+                ],
+                done: "Android host is ready. Run lynxship doctor, then lynxship build.",
+            });
+            return;
+        }
+        assert(ui.interactive, "CLI_INTERACTIVE_REQUIRED", "Run `lynxship android configure` in an interactive terminal");
+        assert(subcommand === "configure", "CLI_ANDROID_COMMAND", "Only android configure is available");
+        ui.info("Configuring Android signing. Secret fields will stay invisible…");
+        const result = await configureAndroid(root);
+        ui.success(result.generated
+            ? `Android keystore generated: ${result.keystorePath}`
+            : `Android signing credentials saved in ${credentialStorageDescription()}`);
+        printValue({ status: "configured", provider: "android-keystore" }, {
+            title: "Android signing",
+            rows: [
+                { label: "Keystore", value: "Configured", valueColor: "green" },
+                {
+                    label: "Storage",
+                    value: credentialStorageDescription(),
+                    valueColor: "green",
+                },
+            ],
+            done: "Android signing is ready for the next build.",
+        });
+        return;
+    }
+    if (command === "store") {
+        assert(ui.interactive, "CLI_INTERACTIVE_REQUIRED", "Run store configure in an interactive terminal");
+        assert((args.shift() ?? "configure") === "configure", "CLI_STORE_COMMAND", "Only store configure is available");
+        const platform = mobilePlatformValue(flag("--platform", "android"));
+        ui.info(platform === "android"
+            ? "Configuring Google Play submission. Secret fields will stay invisible…"
+            : "Configuring App Store Connect submission. Private key contents stay protected…");
+        if (platform === "android")
+            await configureGooglePlay(root);
+        else
+            await configureAppStoreConnect(root);
+        ui.success(platform === "android"
+            ? "Google Play submission credentials saved securely"
+            : "App Store Connect submission credentials saved securely");
+        printValue({
+            status: "configured",
+            provider: platform === "android" ? "google-play" : "app-store-connect",
+            storage: credentialStorageDescription(),
+        }, {
+            title: platform === "android"
+                ? "Google Play submission"
+                : "App Store Connect submission",
+            rows: [
+                {
+                    label: "Provider",
+                    value: platform === "android" ? "Google Play" : "App Store Connect",
+                    valueColor: "blue",
+                },
+                {
+                    label: "Credentials",
+                    value: credentialStorageDescription(),
+                    valueColor: "green",
+                },
+            ],
+            done: "Store submission is ready for the next build.",
+        });
+        return;
+    }
+}

package/dist/commands/development.d.ts

@@ -0,0 +1,22 @@
+import { type MobilePlatform } from "@lynxship/contracts";
+import { type ProjectCommandContext } from "./project.js";
+import type { BoxRow, CliUi } from "../ui/index.js";
+export interface DevelopmentCommandContext {
+    root: string;
+    args: readonly string[];
+    ui: CliUi;
+    json: boolean;
+    flag: (name: string, fallback?: string | null) => string | null;
+    project: ProjectCommandContext;
+    printValue: (value: unknown, view?: {
+        title: string;
+        rows: BoxRow[];
+        done: string;
+    }) => void;
+    mobilePlatformValue: (value: string) => MobilePlatform;
+}
+export declare function forwardedToolArgs(values: readonly string[]): string[];
+export declare function runRspeedyCommand(context: DevelopmentCommandContext, subcommand: "dev" | "preview" | "inspect" | "build", environment?: NodeJS.ProcessEnv): Promise<void>;
+export declare function runAutolinkCodegen(context: DevelopmentCommandContext): Promise<void>;
+export declare function runDevToolDoctor(context: DevelopmentCommandContext, kind: "devtool" | "trace" | "recorder"): Promise<void>;
+//# sourceMappingURL=development.d.ts.map