@capuchoo/cli 0.2.0

package/dist/pipeline/build.js

@@ -0,0 +1,138 @@
+import fs from "node:fs";
+import path from "node:path";
+import { run } from "../utils/exec.js";
+import { readScript, resolveBin } from "./toolchain.js";
+/**
+ * Generates launcher icons and splash screens.
+ *
+ * Optional by design: icons rarely change and an app may not ship source
+ * artwork at all, so a missing tool or asset directory is a skip, not a
+ * failure.
+ */
+export async function generateAssets(context, platform) {
+    const { toolchain, flavour } = context;
+    if (!flavour.assetPath) {
+        return { ran: false, reason: `no asset directory at ${flavour.config.assetPath}` };
+    }
+    const sources = fs
+        .readdirSync(flavour.assetPath)
+        .filter((name) => /^(icon|splash)(-dark)?\.(png|svg)$/.test(name));
+    if (sources.length === 0) {
+        return {
+            ran: false,
+            reason: `${flavour.config.assetPath} has no icon.png or splash.png`,
+        };
+    }
+    const bin = resolveBin("capacitor-assets", toolchain.appDir);
+    if (!bin) {
+        return { ran: false, reason: "@capacitor/assets is not installed" };
+    }
+    await run(bin, ["generate", `--${platform}`, "--assetPath", flavour.assetPath], {
+        ...context.runOptions,
+        cwd: toolchain.appDir,
+        env: context.env,
+    });
+    return { ran: true, via: "@capacitor/assets" };
+}
+/**
+ * Builds the web assets.
+ *
+ * Resolution order, most explicit first:
+ *   1. `build.command` in project.json - the app has said exactly what to run.
+ *   2. A `build:<mode>` script, if the app already has one that works.
+ *   3. Vite directly, with `--mode <flavour>`.
+ *
+ * The flavour's variables are passed as environment rather than through
+ * `dotenv-cli`, so no extra dependency is needed and the values are identical
+ * to the ones the native configuration step receives.
+ */
+export async function buildWeb(context, build) {
+    const { toolchain, flavour } = context;
+    const cwd = build.cwd ? path.resolve(toolchain.appDir, build.cwd) : toolchain.appDir;
+    const options = { ...context.runOptions, cwd, env: context.env };
+    if (build.command) {
+        const [file, ...args] = tokenize(build.command);
+        if (!file)
+            throw new Error("build.command in project.json is empty");
+        // A workspace-local binary beats whatever is on PATH.
+        const resolved = resolveBin(file, toolchain.appDir) ?? file;
+        await run(resolved, args, options);
+        return { ran: true, via: build.command };
+    }
+    const scriptName = `build:${flavour.mode}`;
+    if (readScript(toolchain.appDir, scriptName)) {
+        await run(toolchain.packageManager, ["run", scriptName], options);
+        return { ran: true, via: `${toolchain.packageManager} run ${scriptName}` };
+    }
+    const viteBin = resolveBin("vite", toolchain.appDir);
+    if (viteBin) {
+        await run(viteBin, ["build", "--mode", flavour.mode], options);
+        return { ran: true, via: `vite build --mode ${flavour.mode}` };
+    }
+    const vpBin = resolveBin("vp", toolchain.appDir);
+    if (vpBin) {
+        await run(vpBin, ["build", "--mode", flavour.mode], options);
+        return { ran: true, via: `vp build --mode ${flavour.mode}` };
+    }
+    throw new Error("Nothing to build with: no build.command in .capucho/project.json, no " +
+        `"${scriptName}" script, and neither vite nor vp is installed.`);
+}
+/**
+ * Copies the built web assets into the native project and updates plugins.
+ *
+ * Runs after the native configuration step, because `cap sync` regenerates
+ * plugin registration files and rewriting the identity afterwards would leave
+ * those pointing at the previous package name.
+ */
+export async function syncCapacitor(context, platform) {
+    const bin = resolveBin("cap", context.toolchain.appDir);
+    if (!bin) {
+        return { ran: false, reason: "@capacitor/cli is not installed" };
+    }
+    await run(bin, ["sync", platform], {
+        ...context.runOptions,
+        cwd: context.toolchain.appDir,
+        env: context.env,
+    });
+    return { ran: true, via: `cap sync ${platform}` };
+}
+/**
+ * Splits a command string into argv, honouring quoted segments.
+ *
+ * Needed because `build.command` comes from a config file as one string. The
+ * previous code passed such strings straight to a shell, so a path containing a
+ * space became two arguments.
+ */
+export function tokenize(command) {
+    const tokens = [];
+    let current = "";
+    let quote = null;
+    for (const char of command.trim()) {
+        if (quote) {
+            if (char === quote)
+                quote = null;
+            else
+                current += char;
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+            continue;
+        }
+        if (/\s/.test(char)) {
+            if (current) {
+                tokens.push(current);
+                current = "";
+            }
+            continue;
+        }
+        current += char;
+    }
+    if (quote) {
+        throw new Error(`Unbalanced ${quote} in command: ${command}`);
+    }
+    if (current)
+        tokens.push(current);
+    return tokens;
+}
+//# sourceMappingURL=build.js.map

package/dist/pipeline/build.js.map

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

package/dist/pipeline/deploy.d.ts

@@ -0,0 +1,74 @@
+import { type Environment, type ResolvedProjectConfig } from "@capuchoo/core";
+import { Reporter, type Step } from "../utils/reporter.js";
+import { type BuildType } from "./android.js";
+import { type ResolvedFlavour } from "./flavour.js";
+/**
+ * The deploy pipeline.
+ *
+ * One code path for OTA and native deploys, and one place where the step list
+ * is decided. The steps that will run are computed *before* anything executes,
+ * which is what makes the progress numbers true and lets the whole thing be
+ * validated with `--dry-run` without touching the project.
+ */
+export type DeployKind = "ota" | "native";
+export type Platform = "android" | "ios";
+export interface DeployRequest {
+    appDir: string;
+    project: ResolvedProjectConfig;
+    kind: DeployKind;
+    platform: Platform;
+    channel: string;
+    environment: Environment;
+    /** Semantic version being published, already bumped if requested. */
+    version: string;
+    buildType: BuildType;
+    skipAssets: boolean;
+    skipBuild: boolean;
+    allowUnsigned: boolean;
+    dryRun: boolean;
+    verbose: boolean;
+    quiet: boolean;
+}
+export interface DeployArtifact {
+    kind: DeployKind;
+    filePath: string;
+    byteSize: number;
+    /** Native only. */
+    signed?: boolean;
+    /** OTA only. */
+    fileCount?: number;
+}
+export interface DeployOutcome {
+    version: string;
+    versionCode: number;
+    environment: Environment;
+    artifact: DeployArtifact | null;
+    nativeConfigMethod: string;
+    warnings: string[];
+    /** Steps that were planned but skipped, with reasons. */
+    skipped: Array<{
+        step: string;
+        reason: string;
+    }>;
+}
+/**
+ * Builds the step list for a request.
+ *
+ * Conditional work is resolved here rather than inside the run loop, so a
+ * skipped step never leaves a gap in the numbering.
+ */
+export declare function planSteps(request: DeployRequest): Step[];
+/**
+ * Checks the request against the project before any work happens.
+ *
+ * Cheap validation up front matters more than it sounds: the old pipeline
+ * bumped the version in `package.json` as step 1, then discovered a missing env
+ * file at step 2, leaving the repository holding a version that was never
+ * published.
+ */
+export declare function validateRequest(request: DeployRequest, flavour: ResolvedFlavour): string[];
+export declare function runDeploy(request: DeployRequest, reporter: Reporter): Promise<DeployOutcome>;
+export declare function formatBytes(bytes: number): string;
+/** Turns a pipeline failure into something worth printing. */
+export declare function describeFailure(error: unknown, appDir: string): string;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/pipeline/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/pipeline/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC3B,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEvF,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,cAAc,CAAC;AAKtB;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;AAC1C,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAEzC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAID;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,EAAE,CAuBxD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAkC1F;AAED,wBAAsB,SAAS,CAC7B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,aAAa,CAAC,CA8IxB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtE"}

package/dist/pipeline/deploy.js

@@ -0,0 +1,198 @@
+import { describeEnvironmentMismatch, } from "@capuchoo/core";
+import fs from "node:fs";
+import path from "node:path";
+import { CommandError } from "../utils/exec.js";
+import { Reporter } from "../utils/reporter.js";
+import { assembleAndroid, collectAndroidArtifact } from "./android.js";
+import { buildWeb, generateAssets, syncCapacitor } from "./build.js";
+import { buildEnvironment, describeFlavourProblems, resolveFlavour, resolveVersionState, writeVersionCodes, } from "./flavour.js";
+import { applyNativeConfig, builtinConfigLimitations } from "./native-config.js";
+import { detectToolchain } from "./toolchain.js";
+import { bundleFileName, createBundleZip } from "./zip.js";
+const LOG_FILE = "capuchoo-deploy.log";
+/**
+ * Builds the step list for a request.
+ *
+ * Conditional work is resolved here rather than inside the run loop, so a
+ * skipped step never leaves a gap in the numbering.
+ */
+export function planSteps(request) {
+    const steps = [{ id: "resolve", label: "Resolving flavour and version" }];
+    if (!request.skipBuild) {
+        if (!request.skipAssets) {
+            steps.push({ id: "assets", label: "Generating launcher assets" });
+        }
+        steps.push({ id: "web", label: "Building web assets" });
+        steps.push({ id: "native-config", label: "Applying native configuration" });
+        steps.push({ id: "sync", label: "Syncing Capacitor" });
+    }
+    steps.push(request.kind === "ota"
+        ? { id: "bundle", label: "Packaging OTA bundle" }
+        : { id: "compile", label: `Compiling ${request.platform} (${request.buildType})` });
+    if (!request.dryRun) {
+        steps.push({ id: "upload", label: "Uploading to Capucho" });
+    }
+    return steps;
+}
+/**
+ * Checks the request against the project before any work happens.
+ *
+ * Cheap validation up front matters more than it sounds: the old pipeline
+ * bumped the version in `package.json` as step 1, then discovered a missing env
+ * file at step 2, leaving the repository holding a version that was never
+ * published.
+ */
+export function validateRequest(request, flavour) {
+    const problems = describeFlavourProblems(flavour);
+    const declaredAppId = flavour.fileEnv.VITE_APP_ID;
+    if (declaredAppId) {
+        // Uses the shared rule rather than a plain equality check, so the CLI
+        // rejects exactly what the server rejects and nothing more. A production
+        // build on a staging channel is deliberately allowed - that is how a
+        // release candidate gets beta-tested - and an equality check here blocked
+        // it, which is a legitimate setup the CLI has no business refusing.
+        const mismatch = describeEnvironmentMismatch(declaredAppId, request.environment, request.channel);
+        if (mismatch)
+            problems.push(`${mismatch} (from ${flavour.config.envFile})`);
+    }
+    if (request.kind === "native" && request.platform === "ios") {
+        problems.push("iOS native builds are not driven by this CLI yet - archive and upload " +
+            "through Xcode, then register the build in the dashboard.");
+    }
+    const webDir = path.resolve(request.appDir, request.project.webDir);
+    if (request.skipBuild && !fs.existsSync(webDir)) {
+        problems.push(`--skip-build was passed but ${request.project.webDir} does not exist, ` +
+            "so there is nothing to publish.");
+    }
+    return problems;
+}
+export async function runDeploy(request, reporter) {
+    const warnings = [];
+    const skipped = [];
+    const toolchain = detectToolchain(request.appDir);
+    const flavour = resolveFlavour(request.appDir, request.project, request.environment);
+    const problems = validateRequest(request, flavour);
+    if (problems.length > 0) {
+        throw new Error(`This deploy cannot proceed:\n  - ${problems.join("\n  - ")}`);
+    }
+    reporter.plan(planSteps(request));
+    // Only a native build changes the installed binary, so only a native build
+    // needs a new versionCode.
+    const state = resolveVersionState(request.appDir, request.project, request.environment, request.version, request.kind === "native");
+    const env = buildEnvironment(flavour, state);
+    const runOptions = {
+        logFile: path.join(request.appDir, LOG_FILE),
+        verbose: request.verbose,
+    };
+    const context = { toolchain, flavour, env, runOptions };
+    reporter.begin("resolve");
+    reporter.note(`${request.environment} flavour, v${state.version} (build ${state.versionCode}), ` +
+        `${toolchain.packageManager} workspace`);
+    let nativeConfigMethod = "not run";
+    if (!request.skipBuild) {
+        if (!request.skipAssets) {
+            reporter.begin("assets");
+            const outcome = await generateAssets(context, request.platform);
+            if (!outcome.ran) {
+                reporter.skip(outcome.reason);
+                skipped.push({ step: "assets", reason: outcome.reason });
+            }
+        }
+        reporter.begin("web");
+        const web = await buildWeb(context, request.project.build);
+        if (web.ran)
+            reporter.note(web.via);
+        reporter.begin("native-config");
+        const nativeConfig = await applyNativeConfig({
+            appDir: request.appDir,
+            androidDir: request.project.androidDir,
+            iosDir: request.project.iosDir,
+            flavour,
+            env,
+            platform: request.platform,
+            runOptions,
+        });
+        nativeConfigMethod = nativeConfig.method;
+        if (nativeConfig.method === "trapeze") {
+            reporter.note("Trapeze applied the flavour configuration");
+        }
+        else {
+            reporter.note(`Built-in configuration (${nativeConfig.reason}): ` +
+                `${nativeConfig.changed.length} file(s) updated`);
+            for (const limitation of builtinConfigLimitations(request.platform)) {
+                warnings.push(limitation);
+            }
+        }
+        reporter.begin("sync");
+        const sync = await syncCapacitor(context, request.platform);
+        if (!sync.ran) {
+            reporter.skip(sync.reason);
+            skipped.push({ step: "sync", reason: sync.reason });
+            warnings.push("Capacitor sync did not run, so the native project may still hold the " +
+                "previous build's web assets");
+        }
+    }
+    else {
+        skipped.push({ step: "build", reason: "--skip-build" });
+    }
+    let artifact = null;
+    if (request.kind === "ota") {
+        reporter.begin("bundle");
+        const webDir = path.resolve(request.appDir, request.project.webDir);
+        const outFile = path.join(request.appDir, bundleFileName(request.project.appId, state.version));
+        const bundle = createBundleZip({ webDir, outFile });
+        reporter.note(`${bundle.fileCount} files, ${formatBytes(bundle.byteSize)} -> ${path.basename(bundle.zipPath)}`);
+        artifact = {
+            kind: "ota",
+            filePath: bundle.zipPath,
+            byteSize: bundle.byteSize,
+            fileCount: bundle.fileCount,
+        };
+    }
+    else {
+        reporter.begin("compile");
+        const androidDir = path.resolve(request.appDir, request.project.androidDir);
+        await assembleAndroid(androidDir, request.buildType, runOptions);
+        const built = collectAndroidArtifact(androidDir, request.buildType, request.allowUnsigned);
+        reporter.note(`${path.basename(built.apkPath)}, ${formatBytes(built.byteSize)}` +
+            (built.signed ? "" : " (unsigned)"));
+        if (!built.signed) {
+            warnings.push("This artefact is not signed. Android will not install it as-is.");
+        }
+        artifact = {
+            kind: "native",
+            filePath: built.apkPath,
+            byteSize: built.byteSize,
+            signed: built.signed,
+        };
+    }
+    // The version code is persisted only once the artefact exists, so a failed
+    // build does not consume a build number.
+    if (request.kind === "native" && !request.dryRun) {
+        writeVersionCodes(request.appDir, request.project, state.codes);
+    }
+    return {
+        version: state.version,
+        versionCode: state.versionCode,
+        environment: request.environment,
+        artifact,
+        nativeConfigMethod,
+        warnings,
+        skipped,
+    };
+}
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KiB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+}
+/** Turns a pipeline failure into something worth printing. */
+export function describeFailure(error, appDir) {
+    if (error instanceof CommandError) {
+        return `${error.message}\n\n  Full output: ${path.join(appDir, LOG_FILE)}`;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=deploy.js.map

package/dist/pipeline/deploy.js.map

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

package/dist/pipeline/flavour.d.ts

@@ -0,0 +1,66 @@
+import { type Environment, type FlavourConfig, type ResolvedProjectConfig, type VersionCodes } from "@capuchoo/core";
+/**
+ * Resolves everything a single build flavour needs.
+ *
+ * The previous implementation rewrote `VITE_APP_VERSION`, `VERSION_CODE` and
+ * `BUILD_NUMBER` *into* the committed `build/<env>/.env.<env>` file on every
+ * deploy. That had three consequences: every deploy left the working tree
+ * dirty, two deploys running at once corrupted each other's values, and a
+ * failed deploy left the file holding a version that was never published.
+ *
+ * Here the env file is read and never written. The computed values are merged
+ * on top in memory and handed to the build and to Trapeze as environment
+ * variables - which is where both of them look anyway.
+ */
+export interface ResolvedFlavour {
+    environment: Environment;
+    config: FlavourConfig;
+    /** Absolute path, or null when the flavour declares none. */
+    envFile: string | null;
+    trapezeConfig: string | null;
+    assetPath: string | null;
+    /** Values parsed from the env file. */
+    fileEnv: Record<string, string>;
+    /** Vite mode for this flavour. */
+    mode: string;
+}
+/**
+ * Parses a dotenv file.
+ *
+ * Deliberately small and dependency-free: `KEY=value`, `#` comments, optional
+ * surrounding quotes, `export ` prefix tolerated. Anything more exotic belongs
+ * in the app's own tooling, not in a deploy tool.
+ */
+export declare function parseEnvFile(contents: string): Record<string, string>;
+export declare function resolveFlavour(appDir: string, project: ResolvedProjectConfig, environment: Environment): ResolvedFlavour;
+/**
+ * Problems that make a flavour unbuildable, as actionable messages.
+ *
+ * The old `syncVersion` threw `Env file for staging not found` from deep inside
+ * the pipeline, *after* the version had been bumped. Checking up front means a
+ * misconfigured flavour costs nothing.
+ */
+export declare function describeFlavourProblems(flavour: ResolvedFlavour): string[];
+export interface VersionState {
+    /** Semantic version from the app's package.json. */
+    version: string;
+    versionCode: number;
+    codes: VersionCodes;
+}
+export declare function readVersionCodes(appDir: string, project: ResolvedProjectConfig): VersionCodes;
+export declare function writeVersionCodes(appDir: string, project: ResolvedProjectConfig, codes: VersionCodes): void;
+/**
+ * Computes the version state for a deploy.
+ *
+ * `bumpCode` should be true for a native build - Android refuses an APK whose
+ * versionCode did not increase - and false for an OTA bundle, which does not
+ * change the installed binary.
+ */
+export declare function resolveVersionState(appDir: string, project: ResolvedProjectConfig, environment: Environment, version: string, bumpCode: boolean): VersionState;
+/**
+ * The environment a build step runs with: the flavour's own values, plus the
+ * resolved version. Version values win, because they are computed for *this*
+ * deploy while the file holds whatever the last one left behind.
+ */
+export declare function buildEnvironment(flavour: ResolvedFlavour, state: VersionState): Record<string, string>;
+//# sourceMappingURL=flavour.d.ts.map

package/dist/pipeline/flavour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flavour.d.ts","sourceRoot":"","sources":["../../src/pipeline/flavour.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAIxB;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8BrE;AAQD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,qBAAqB,EAC9B,WAAW,EAAE,WAAW,GACvB,eAAe,CAajB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAsB1E;AAED,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,YAAY,CAY7F;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,YAAY,GAClB,IAAI,CAGN;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,qBAAqB,EAC9B,WAAW,EAAE,WAAW,EACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,GAChB,YAAY,CAKd;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,YAAY,GAClB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxB"}

package/dist/pipeline/flavour.js

@@ -0,0 +1,120 @@
+import { INITIAL_VERSION_CODES, nextVersionCode, versionEnv, } from "@capuchoo/core";
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Parses a dotenv file.
+ *
+ * Deliberately small and dependency-free: `KEY=value`, `#` comments, optional
+ * surrounding quotes, `export ` prefix tolerated. Anything more exotic belongs
+ * in the app's own tooling, not in a deploy tool.
+ */
+export function parseEnvFile(contents) {
+    const values = {};
+    for (const rawLine of contents.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const withoutExport = line.startsWith("export ") ? line.slice(7).trim() : line;
+        const separator = withoutExport.indexOf("=");
+        if (separator <= 0)
+            continue;
+        const key = withoutExport.slice(0, separator).trim();
+        if (!/^[A-Za-z_]\w*$/.test(key))
+            continue;
+        let value = withoutExport.slice(separator + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"') && value.length > 1) ||
+            (value.startsWith("'") && value.endsWith("'") && value.length > 1)) {
+            value = value.slice(1, -1);
+        }
+        else {
+            // Strip a trailing inline comment on unquoted values only.
+            const comment = value.indexOf(" #");
+            if (comment >= 0)
+                value = value.slice(0, comment).trimEnd();
+        }
+        values[key] = value;
+    }
+    return values;
+}
+function existingPath(appDir, relative) {
+    if (!relative)
+        return null;
+    const absolute = path.resolve(appDir, relative);
+    return fs.existsSync(absolute) ? absolute : null;
+}
+export function resolveFlavour(appDir, project, environment) {
+    const config = project.flavours[environment];
+    const envFile = existingPath(appDir, config.envFile);
+    return {
+        environment,
+        config,
+        envFile,
+        trapezeConfig: existingPath(appDir, config.trapezeConfig),
+        assetPath: existingPath(appDir, config.assetPath),
+        fileEnv: envFile ? parseEnvFile(fs.readFileSync(envFile, "utf8")) : {},
+        mode: config.mode ?? environment,
+    };
+}
+/**
+ * Problems that make a flavour unbuildable, as actionable messages.
+ *
+ * The old `syncVersion` threw `Env file for staging not found` from deep inside
+ * the pipeline, *after* the version had been bumped. Checking up front means a
+ * misconfigured flavour costs nothing.
+ */
+export function describeFlavourProblems(flavour) {
+    const problems = [];
+    if (!flavour.envFile) {
+        problems.push(`No env file at "${flavour.config.envFile}" for the ${flavour.environment} flavour. ` +
+            "Create it, or point the flavour at another path in .capucho/project.json.");
+        return problems;
+    }
+    if (!flavour.fileEnv.VITE_APP_ID) {
+        problems.push(`${flavour.config.envFile} does not set VITE_APP_ID`);
+    }
+    if (!flavour.fileEnv.VITE_UPDATE_API_URL) {
+        problems.push(`${flavour.config.envFile} does not set VITE_UPDATE_API_URL, so the built app ` +
+            "would ship with updates disabled");
+    }
+    return problems;
+}
+export function readVersionCodes(appDir, project) {
+    const file = path.resolve(appDir, project.versionCodeFile);
+    if (!fs.existsSync(file))
+        return { ...INITIAL_VERSION_CODES };
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+        return { ...INITIAL_VERSION_CODES, ...parsed };
+    }
+    catch {
+        throw new Error(`${project.versionCodeFile} is not valid JSON. Fix or delete it before deploying.`);
+    }
+}
+export function writeVersionCodes(appDir, project, codes) {
+    const file = path.resolve(appDir, project.versionCodeFile);
+    fs.writeFileSync(file, `${JSON.stringify(codes, null, 2)}\n`);
+}
+/**
+ * Computes the version state for a deploy.
+ *
+ * `bumpCode` should be true for a native build - Android refuses an APK whose
+ * versionCode did not increase - and false for an OTA bundle, which does not
+ * change the installed binary.
+ */
+export function resolveVersionState(appDir, project, environment, version, bumpCode) {
+    const current = readVersionCodes(appDir, project);
+    const codes = bumpCode ? nextVersionCode(current, environment) : current;
+    return { version, versionCode: codes[environment], codes };
+}
+/**
+ * The environment a build step runs with: the flavour's own values, plus the
+ * resolved version. Version values win, because they are computed for *this*
+ * deploy while the file holds whatever the last one left behind.
+ */
+export function buildEnvironment(flavour, state) {
+    return {
+        ...flavour.fileEnv,
+        ...versionEnv(state.version, state.versionCode),
+    };
+}
+//# sourceMappingURL=flavour.js.map

package/dist/pipeline/flavour.js.map

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