@iyexin/mio-android-tools 0.0.0-stage → 0.1.1

package/dist/exec.js

@@ -0,0 +1,67 @@
+import { spawn } from "node:child_process";
+import { MioToolError } from "./errors.js";
+/**
+ * Run a child process and capture stdout/stderr.
+ *
+ * The caller is responsible for interpreting a non-zero exit code. Spawn
+ * failures and timeouts are surfaced as MioToolError.
+ */
+export async function run(file, args, options = {}) {
+    const timeoutMs = options.timeoutMs ?? 120_000;
+    return await new Promise((resolve, reject) => {
+        let settled = false;
+        let timedOut = false;
+        let stdout = "";
+        let stderr = "";
+        const child = spawn(file, args, {
+            cwd: options.cwd,
+            env: { ...process.env, ...options.env },
+            windowsHide: true,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(result);
+        };
+        const fail = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(error);
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill();
+        }, timeoutMs);
+        child.stdout?.setEncoding("utf8");
+        child.stderr?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", (error) => {
+            fail(new MioToolError("SPAWN_FAILED", `Failed to start ${file}: ${error.message}`, {
+                cause: error,
+                stdout,
+                stderr,
+            }));
+        });
+        child.on("close", (code) => {
+            if (timedOut) {
+                fail(new MioToolError("TIMEOUT", `${file} timed out after ${timeoutMs}ms`, {
+                    stdout,
+                    stderr,
+                }));
+                return;
+            }
+            finish({ code: code ?? -1, stdout, stderr });
+        });
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/exec.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { MioToolError } from "./errors.js";
+export type { MioToolErrorCode, MioToolErrorOptions } from "./errors.js";
+export { discoverAndroidTools, describeAndroidTools, type AndroidTools, type DiscoverOptions, } from "./discover.js";
+export { alignApk, checkAlignment, type AlignOptions, type AlignmentCheck, type PageSize, } from "./zipalign.js";
+export { signApkWithApksigner, verifyApkWithApksigner, buildSignArgs, parseVerifyOutput, type SignApkWithApksignerOptions, type VerifyApkOptions, type VerifyResult, type SignerCertificate, } from "./apksigner.js";
+export { ensureDebugKeystore, type DebugKeystoreOptions } from "./keystore.js";
+export { parseAxml, patchManifestAxml, type AxmlAttribute, type AxmlDocument, type AxmlElement, type ManifestPatch, } from "./axml.js";
+export { injectApk, type InjectApkOptions, type InjectApkResult, } from "./apk.js";
+export { injectWindowsExe, type InjectWindowsExeOptions, type InjectWindowsExeResult, } from "./windows.js";
+export { signApk, verifyApk, type SignApkOptions, type SignResult, } from "./signing.js";
+export { installToolBundle, platformKeyOf, type InstallToolBundleOptions, type InstalledToolBundle, type ToolBundleManifest, type ToolBundlePlatform, } from "./tool-bundle.js";
+export { run, type ExecOptions, type ExecResult } from "./exec.js";
+export { listZipEntries, extractZip, readZipEntry } from "./zip.js";

package/dist/index.js

@@ -0,0 +1,13 @@
+export { MioToolError } from "./errors.js";
+export { discoverAndroidTools, describeAndroidTools, } from "./discover.js";
+export { alignApk, checkAlignment, } from "./zipalign.js";
+export { signApkWithApksigner, verifyApkWithApksigner, buildSignArgs, parseVerifyOutput, } from "./apksigner.js";
+export { ensureDebugKeystore } from "./keystore.js";
+export { parseAxml, patchManifestAxml, } from "./axml.js";
+export { injectApk, } from "./apk.js";
+export { injectWindowsExe, } from "./windows.js";
+export { signApk, verifyApk, } from "./signing.js";
+export { installToolBundle, platformKeyOf, } from "./tool-bundle.js";
+export { run } from "./exec.js";
+export { listZipEntries, extractZip, readZipEntry } from "./zip.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,QAAQ,EACR,cAAc,GAIf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,iBAAiB,GAKlB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAA6B,MAAM,eAAe,CAAC;AAE/E,OAAO,EACL,SAAS,EACT,iBAAiB,GAKlB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,SAAS,GAGV,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,gBAAgB,GAGjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,OAAO,EACP,SAAS,GAGV,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,aAAa,GAKd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,GAAG,EAAqC,MAAM,WAAW,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/keystore.d.ts

@@ -0,0 +1,22 @@
+import type { AndroidTools } from "./discover.js";
+export interface DebugKeystoreOptions {
+    /** Where to create the keystore. */
+    path: string;
+    /** Defaults to "android"; only for debug builds. */
+    password?: string;
+    /** Defaults to "mio-debug". */
+    alias?: string;
+    /** Defaults to "CN=Mio Debug, O=Mio, C=CN". */
+    distinguishedName?: string;
+}
+/**
+ * Create a debug keystore if it does not exist yet.
+ *
+ * Never use this key for release artifacts. Release keys are supplied by the
+ * developer and must not be generated or stored by Mio.
+ */
+export declare function ensureDebugKeystore(tools: AndroidTools, options: DebugKeystoreOptions): Promise<{
+    path: string;
+    alias: string;
+    password: string;
+}>;

package/dist/keystore.js

@@ -0,0 +1,65 @@
+import { access, mkdir } from "node:fs/promises";
+import { constants } from "node:fs";
+import { dirname } from "node:path";
+import { MioToolError } from "./errors.js";
+import { run } from "./exec.js";
+async function exists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a debug keystore if it does not exist yet.
+ *
+ * Never use this key for release artifacts. Release keys are supplied by the
+ * developer and must not be generated or stored by Mio.
+ */
+export async function ensureDebugKeystore(tools, options) {
+    const password = options.password ?? "android";
+    const alias = options.alias ?? "mio-debug";
+    if (await exists(options.path)) {
+        return { path: options.path, alias, password };
+    }
+    if (!tools.keytool) {
+        throw new MioToolError("KEYTOOL_NOT_FOUND", "keytool is required to generate a debug keystore but was not found.", {
+            details: "Use a JDK/JRE that includes keytool, or provide an existing debug keystore.",
+        });
+    }
+    await mkdir(dirname(options.path), { recursive: true });
+    const args = [
+        "-genkeypair",
+        "-keystore",
+        options.path,
+        "-storetype",
+        "PKCS12",
+        "-alias",
+        alias,
+        "-keyalg",
+        "RSA",
+        "-keysize",
+        "2048",
+        "-validity",
+        "10000",
+        "-storepass",
+        password,
+        "-keypass",
+        password,
+        "-dname",
+        options.distinguishedName ?? "CN=Mio Debug, O=Mio, C=CN",
+        "-noprompt",
+    ];
+    const result = await run(tools.keytool, args, { timeoutMs: 120_000 });
+    if (result.code !== 0) {
+        throw new MioToolError("KEYTOOL_FAILED", "keytool failed to create the debug keystore", {
+            stdout: result.stdout,
+            stderr: result.stderr,
+            details: `exit code ${result.code}`,
+        });
+    }
+    return { path: options.path, alias, password };
+}
+//# sourceMappingURL=keystore.js.map

package/dist/keystore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystore.js","sourceRoot":"","sources":["../src/keystore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAchC,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAmB,EACnB,OAA6B;IAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;IAE3C,IAAI,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CACpB,mBAAmB,EACnB,qEAAqE,EACrE;YACE,OAAO,EAAE,6EAA6E;SACvF,CACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,IAAI,GAAG;QACX,aAAa;QACb,WAAW;QACX,OAAO,CAAC,IAAI;QACZ,YAAY;QACZ,QAAQ;QACR,QAAQ;QACR,KAAK;QACL,SAAS;QACT,KAAK;QACL,UAAU;QACV,MAAM;QACN,WAAW;QACX,OAAO;QACP,YAAY;QACZ,QAAQ;QACR,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,OAAO,CAAC,iBAAiB,IAAI,2BAA2B;QACxD,WAAW;KACZ,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACtE,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,YAAY,CAAC,gBAAgB,EAAE,6CAA6C,EAAE;YACtF,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,aAAa,MAAM,CAAC,IAAI,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACjD,CAAC"}

package/dist/signing.d.ts

@@ -0,0 +1,28 @@
+import { type AndroidTools } from "./discover.js";
+import { type SignApkWithApksignerOptions, type VerifyResult } from "./apksigner.js";
+import { type PageSize } from "./zipalign.js";
+export interface SignApkOptions extends Omit<SignApkWithApksignerOptions, "input" | "output"> {
+    input: string;
+    output: string;
+    /** Reuse an already discovered toolchain; otherwise discover it. */
+    tools?: AndroidTools;
+    /** 16 KiB by default (Android 15+). Use 4 for older build-tools. */
+    pageSize?: PageSize;
+}
+export interface SignResult {
+    output: string;
+    tools: AndroidTools;
+    verify: VerifyResult;
+}
+/**
+ * Align, sign, and verify an APK.
+ *
+ * This is the only supported high-level Android signing entry point: alignment
+ * must happen before apksigner, and the result must be verified before it is
+ * treated as a build artifact.
+ */
+export declare function signApk(options: SignApkOptions): Promise<SignResult>;
+export declare function verifyApk(apk: string, options?: {
+    tools?: AndroidTools;
+    minSdkVersion?: number;
+}): Promise<VerifyResult>;

package/dist/signing.js

@@ -0,0 +1,72 @@
+import { access, copyFile, mkdir, mkdtemp, rm } from "node:fs/promises";
+import { constants } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { discoverAndroidTools } from "./discover.js";
+import { MioToolError } from "./errors.js";
+import { signApkWithApksigner, verifyApkWithApksigner, } from "./apksigner.js";
+import { alignApk } from "./zipalign.js";
+async function exists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Align, sign, and verify an APK.
+ *
+ * This is the only supported high-level Android signing entry point: alignment
+ * must happen before apksigner, and the result must be verified before it is
+ * treated as a build artifact.
+ */
+export async function signApk(options) {
+    const tools = options.tools ?? (await discoverAndroidTools());
+    const input = resolve(options.input);
+    const output = resolve(options.output);
+    if (!(await exists(input))) {
+        throw new MioToolError("MISSING_FILE", `Input APK does not exist: ${input}`);
+    }
+    if (input === output) {
+        throw new MioToolError("INVALID_ARGUMENT", "Input and output APK must be different files.", { details: "Write the signed artifact to a new path so a failed build cannot destroy the input." });
+    }
+    await mkdir(dirname(output), { recursive: true });
+    const tempDir = await mkdtemp(join(tmpdir(), "mio-sign-"));
+    const aligned = join(tempDir, "aligned.apk");
+    const signed = join(tempDir, "signed.apk");
+    try {
+        await alignApk(tools, input, aligned, {
+            pageSize: options.pageSize ?? 16,
+            verbose: options.verbose,
+        });
+        await signApkWithApksigner(tools, {
+            ...options,
+            input: aligned,
+            output: signed,
+        });
+        const verify = await verifyApkWithApksigner(tools, signed, {
+            minSdkVersion: options.minSdkVersion,
+        });
+        if (!verify.verified) {
+            throw new MioToolError("APKSIGNER_VERIFY_FAILED", "Signed APK did not verify", {
+                stdout: verify.raw,
+                details: `exit code ${verify.exitCode}`,
+            });
+        }
+        // Only publish the output after it has passed verification.
+        await copyFile(signed, output);
+        return { output, tools, verify };
+    }
+    finally {
+        await rm(tempDir, { recursive: true, force: true });
+    }
+}
+export async function verifyApk(apk, options = {}) {
+    const tools = options.tools ?? (await discoverAndroidTools());
+    return await verifyApkWithApksigner(tools, resolve(apk), {
+        minSdkVersion: options.minSdkVersion,
+    });
+}
+//# sourceMappingURL=signing.js.map

package/dist/signing.js.map

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

package/dist/tool-bundle.d.ts

@@ -0,0 +1,47 @@
+import { type AndroidTools } from "./discover.js";
+export interface ToolBundlePlatform {
+    /** Archive URL (http:, https:, or file:). */
+    url: string;
+    /** SHA-256 of the archive. */
+    sha256: string;
+    /** Optional expected archive size in bytes. */
+    size?: number;
+    /** Number of leading path segments to strip during extraction. Default: 1. */
+    strip?: number;
+}
+export interface ToolBundleManifest {
+    schemaVersion: 1;
+    latest: string;
+    bundles: Record<string, {
+        platforms: Record<string, ToolBundlePlatform>;
+    }>;
+}
+export interface InstallToolBundleOptions {
+    /** Manifest object, local path, or http(s)/file URL. */
+    manifest: ToolBundleManifest | string;
+    /** Defaults to manifest.latest. */
+    version?: string;
+    /** Defaults to `${process.platform}-${process.arch}`. */
+    platform?: string;
+    /** Defaults to ~/.mio/tools/android. */
+    cacheDir?: string;
+    /** Defaults to HTTPS_PROXY/HTTP_PROXY/ALL_PROXY. */
+    proxy?: string;
+    /** Re-download even if a cached bundle exists. */
+    force?: boolean;
+}
+export interface InstalledToolBundle {
+    tools: AndroidTools;
+    dir: string;
+    version: string;
+    platform: string;
+}
+declare function platformKeyOf(platform: NodeJS.Platform, arch: string): string;
+/**
+ * Download, verify, extract, and cache a Mio Android tools bundle.
+ *
+ * The bundle is a .tar.gz containing apksigner.jar, zipalign[.exe], and
+ * optionally jre/. The archive is authenticated by SHA-256 before extraction.
+ */
+export declare function installToolBundle(options: InstallToolBundleOptions): Promise<InstalledToolBundle>;
+export { platformKeyOf };

package/dist/tool-bundle.js

@@ -0,0 +1,204 @@
+import { createHash } from "node:crypto";
+import { access, mkdir, mkdtemp, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { constants } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import * as tar from "tar";
+import { ProxyAgent, fetch as undiciFetch } from "undici";
+import { discoverAndroidTools } from "./discover.js";
+import { MioToolError } from "./errors.js";
+const MANIFEST_FILE = ".mio-tools.json";
+function platformKeyOf(platform, arch) {
+    return `${platform}-${arch}`;
+}
+function defaultCacheDir() {
+    return join(homedir(), ".mio", "tools", "android");
+}
+function defaultProxy() {
+    return (process.env.HTTPS_PROXY ??
+        process.env.https_proxy ??
+        process.env.HTTP_PROXY ??
+        process.env.http_proxy ??
+        process.env.ALL_PROXY ??
+        process.env.all_proxy);
+}
+async function exists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sha256(buffer) {
+    return createHash("sha256").update(buffer).digest("hex");
+}
+async function fetchBuffer(url, proxy) {
+    if (url.startsWith("file:")) {
+        return await readFile(fileURLToPath(url));
+    }
+    const init = {};
+    if (proxy) {
+        init.dispatcher = new ProxyAgent(proxy);
+    }
+    let response;
+    try {
+        response = await undiciFetch(url, init);
+    }
+    catch (error) {
+        throw new MioToolError("BUNDLE_DOWNLOAD_FAILED", `Failed to download ${url}`, {
+            cause: error,
+            details: proxy ? `proxy: ${proxy}` : undefined,
+        });
+    }
+    if (!response.ok) {
+        throw new MioToolError("BUNDLE_DOWNLOAD_FAILED", `Failed to download ${url}: HTTP ${response.status}`);
+    }
+    return Buffer.from(await response.arrayBuffer());
+}
+async function loadManifest(source, proxy) {
+    if (typeof source !== "string")
+        return source;
+    const buffer = source.startsWith("http:") || source.startsWith("https:") || source.startsWith("file:")
+        ? await fetchBuffer(source, proxy)
+        : await readFile(source);
+    let parsed;
+    try {
+        parsed = JSON.parse(buffer.toString("utf8"));
+    }
+    catch (error) {
+        throw new MioToolError("BUNDLE_DOWNLOAD_FAILED", "Tool bundle manifest is not valid JSON", {
+            cause: error,
+        });
+    }
+    const manifest = parsed;
+    if (manifest.schemaVersion !== 1 || typeof manifest.latest !== "string" || !manifest.bundles) {
+        throw new MioToolError("BUNDLE_DOWNLOAD_FAILED", "Unsupported tool bundle manifest");
+    }
+    return manifest;
+}
+function selectBundle(manifest, version, platform) {
+    const bundle = manifest.bundles[version];
+    if (!bundle) {
+        throw new MioToolError("BUNDLE_DOWNLOAD_FAILED", `Unknown tool bundle version: ${version}`);
+    }
+    const entry = bundle.platforms[platform];
+    if (!entry) {
+        throw new MioToolError("BUNDLE_DOWNLOAD_FAILED", `Tool bundle ${version} has no build for ${platform}`, { details: `available: ${Object.keys(bundle.platforms).join(", ")}` });
+    }
+    return entry;
+}
+async function readMarker(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, "utf8"));
+        if (typeof parsed.version !== "string" ||
+            typeof parsed.platform !== "string" ||
+            typeof parsed.sha256 !== "string") {
+            return undefined;
+        }
+        return {
+            version: parsed.version,
+            platform: parsed.platform,
+            sha256: parsed.sha256,
+            installedAt: parsed.installedAt ?? "",
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+async function validateBundleLayout(dir) {
+    const apksigner = [join(dir, "apksigner.jar"), join(dir, "lib", "apksigner.jar")];
+    const zipalign = process.platform === "win32"
+        ? [join(dir, "zipalign.exe"), join(dir, "bin", "zipalign.exe")]
+        : [join(dir, "zipalign"), join(dir, "bin", "zipalign")];
+    for (const candidate of apksigner) {
+        if (await exists(candidate))
+            break;
+        if (candidate === apksigner[apksigner.length - 1]) {
+            throw new MioToolError("BUNDLE_EXTRACT_FAILED", "Tool bundle is missing apksigner.jar");
+        }
+    }
+    for (const candidate of zipalign) {
+        if (await exists(candidate))
+            break;
+        if (candidate === zipalign[zipalign.length - 1]) {
+            throw new MioToolError("BUNDLE_EXTRACT_FAILED", "Tool bundle is missing zipalign");
+        }
+    }
+}
+/**
+ * Download, verify, extract, and cache a Mio Android tools bundle.
+ *
+ * The bundle is a .tar.gz containing apksigner.jar, zipalign[.exe], and
+ * optionally jre/. The archive is authenticated by SHA-256 before extraction.
+ */
+export async function installToolBundle(options) {
+    const proxy = options.proxy ?? defaultProxy();
+    const manifest = await loadManifest(options.manifest, proxy);
+    const version = options.version ?? manifest.latest;
+    const platform = options.platform ?? platformKeyOf(process.platform, process.arch);
+    const entry = selectBundle(manifest, version, platform);
+    const cacheDir = options.cacheDir ?? defaultCacheDir();
+    const dest = join(cacheDir, version, platform);
+    const markerPath = join(dest, MANIFEST_FILE);
+    await mkdir(cacheDir, { recursive: true });
+    if (!options.force) {
+        const marker = await readMarker(markerPath);
+        if (marker?.sha256 === entry.sha256 && (await exists(dest))) {
+            try {
+                const tools = await discoverAndroidTools({
+                    env: { ...process.env, MIO_ANDROID_TOOLS_DIR: dest },
+                });
+                return { tools, dir: dest, version, platform };
+            }
+            catch {
+                // Cached bundle is incomplete or corrupt; fall through and reinstall.
+                await rm(dest, { recursive: true, force: true });
+            }
+        }
+    }
+    const tempRoot = await mkdtemp(join(cacheDir, ".download-"));
+    const archivePath = join(tempRoot, "tools.tar.gz");
+    const extractDir = join(tempRoot, "extracted");
+    try {
+        await mkdir(extractDir, { recursive: true });
+        const archive = await fetchBuffer(entry.url, proxy);
+        if (entry.size !== undefined && archive.length !== entry.size) {
+            throw new MioToolError("BUNDLE_CHECKSUM_FAILED", `Tool bundle size mismatch: expected ${entry.size}, got ${archive.length}`);
+        }
+        const digest = sha256(archive);
+        if (digest !== entry.sha256.toLowerCase()) {
+            throw new MioToolError("BUNDLE_CHECKSUM_FAILED", `Tool bundle SHA-256 mismatch: expected ${entry.sha256}, got ${digest}`);
+        }
+        await writeFile(archivePath, archive);
+        await tar.x({
+            file: archivePath,
+            cwd: extractDir,
+            strip: entry.strip ?? 1,
+            strict: true,
+            preservePaths: false,
+        });
+        await validateBundleLayout(extractDir);
+        await rm(dest, { recursive: true, force: true });
+        await mkdir(dirname(dest), { recursive: true });
+        await rename(extractDir, dest);
+        await writeFile(markerPath, JSON.stringify({
+            version,
+            platform,
+            sha256: entry.sha256,
+            installedAt: new Date().toISOString(),
+        }, null, 2));
+        const tools = await discoverAndroidTools({
+            env: { ...process.env, MIO_ANDROID_TOOLS_DIR: dest },
+        });
+        return { tools, dir: dest, version, platform };
+    }
+    finally {
+        await rm(tempRoot, { recursive: true, force: true });
+    }
+}
+export { platformKeyOf };
+//# sourceMappingURL=tool-bundle.js.map

package/dist/tool-bundle.js.map

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

package/dist/windows.d.ts

@@ -0,0 +1,22 @@
+export interface InjectWindowsExeOptions {
+    templateExe: string;
+    asar: string;
+    output: string;
+    resourceName?: string;
+    language?: number;
+    appName?: string;
+    version?: string;
+    /** Optional PNG used to replace the executable's icon group. */
+    icon?: string;
+}
+export interface InjectWindowsExeResult {
+    output: string;
+    asarBytes: number;
+}
+/**
+ * Inject app.asar as an RT_RCDATA resource into a Windows executable.
+ *
+ * The Flutter shell reads it with FindResourceW/LoadResource. This does not
+ * sign the executable; Authenticode must be applied after injection.
+ */
+export declare function injectWindowsExe(options: InjectWindowsExeOptions): Promise<InjectWindowsExeResult>;