adjacent-dev-client 0.1.0

package/dist/android-wrapper.js

@@ -0,0 +1,337 @@
+import { createHash } from "node:crypto";
+import { readdir, readFile, mkdir, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { ConsoleLog, fetchUtils, TwaGenerator, TwaManifest, } from "@bubblewrap/core";
+import { runCommand } from "adjacent-cli";
+export const ANDROID_PACKAGE_ID = "dev.adjacent.runner";
+/**
+ * Bubblewrap pins the JDK exactly: `JdkHelper.validatePath` rejects anything
+ * whose release file is not `JAVA_VERSION="17.0`, and the Android command line
+ * tools are incompatible with newer major versions.
+ */
+const REQUIRED_JDK_MAJOR = "17";
+/** Preserved across rebuilds so Gradle does not start cold every time. */
+const PRESERVED_BUILD_ENTRIES = new Set([".gradle", "app"]);
+export function isSupportedJdkRelease(releaseFile) {
+    return new RegExp(`JAVA_VERSION="${REQUIRED_JDK_MAJOR}(?:[."])`).test(releaseFile);
+}
+/**
+ * Normalises a SHA-256 certificate digest from either `apksigner` (lowercase,
+ * unseparated) or `keytool` (uppercase, colon-separated) into the colon form
+ * that a Digital Asset Links statement expects.
+ */
+export function parseCertificateFingerprint(output) {
+    const apksigner = /SHA-256 digest:\s*([0-9a-f]{64})/i.exec(output)?.[1];
+    if (apksigner) {
+        return (apksigner.toUpperCase().match(/.{2}/g) ?? []).join(":");
+    }
+    const keytool = /SHA256:\s*((?:[0-9A-F]{2}:){31}[0-9A-F]{2})/i.exec(output)?.[1];
+    return keytool?.toUpperCase();
+}
+/** Mirrors ANDROID_MANIFEST_KEY in adjacent-core, which the CLI must not import. */
+const ANDROID_MANIFEST_KEY = "adjacent_android";
+const CHROME_KEYS = [
+    "navigationColor",
+    "navigationColorDark",
+    "navigationDividerColor",
+    "navigationDividerColorDark",
+    "themeColorDark",
+];
+/**
+ * Reads the wrapper chrome Adjacent publishes alongside the web manifest.
+ *
+ * A web manifest has one `theme_color` and nothing at all for the Android
+ * navigation bar, so Bubblewrap falls back to hardcoded defaults for these five
+ * fields. Reading them from a namespaced manifest member keeps the CLI free of
+ * any dependency on the application's configuration file.
+ */
+export function readAndroidChrome(manifestSource) {
+    let parsed;
+    try {
+        parsed = JSON.parse(manifestSource);
+    }
+    catch {
+        return {};
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return {};
+    const section = parsed[ANDROID_MANIFEST_KEY];
+    if (typeof section !== "object" || section === null)
+        return {};
+    const source = section;
+    const chrome = {};
+    for (const key of CHROME_KEYS) {
+        const value = source[key];
+        if (typeof value === "string" && value.trim().length > 0) {
+            chrome[key] = value;
+        }
+    }
+    return chrome;
+}
+export function hashManifestSource(source) {
+    return createHash("sha256").update(source).digest("hex");
+}
+/**
+ * `TwaManifest.validate()` only checks that host, name, startUrl, and iconUrl
+ * are non-empty. These are the remaining fields that decide whether the wrapper
+ * launches fullscreen instead of falling back to a Custom Tab.
+ */
+/**
+ * Segments Android refuses because Java refuses them. The build fails late and
+ * unhelpfully on these, so they are named here.
+ */
+const JAVA_KEYWORDS = new Set([
+    "abstract", "assert", "boolean", "break", "byte", "case", "catch", "char",
+    "class", "const", "continue", "default", "do", "double", "else", "enum",
+    "extends", "final", "finally", "float", "for", "goto", "if", "implements",
+    "import", "instanceof", "int", "interface", "long", "native", "new", "package",
+    "private", "protected", "public", "return", "short", "static", "strictfp",
+    "super", "switch", "synchronized", "this", "throw", "throws", "transient",
+    "try", "void", "volatile", "while",
+]);
+/**
+ * Why an Android application id is invalid, or undefined when it is fine.
+ *
+ * An application id is a Java package name, which is stricter than the "letters,
+ * numbers, periods, hyphens and underscores" that documentation tends to say: a
+ * hyphen is not allowed anywhere, a segment cannot begin with a digit, and no
+ * segment may be a Java keyword. Each of those fails the Gradle build rather
+ * than the packaging step, which is a long way from the mistake.
+ */
+export function describePackageIdProblem(packageId) {
+    if (packageId.length === 0)
+        return "an application id is required";
+    const segments = packageId.split(".");
+    if (segments.length < 2) {
+        return `"${packageId}" needs at least two segments, such as com.example.app`;
+    }
+    for (const segment of segments) {
+        if (segment.length === 0) {
+            return `"${packageId}" has an empty segment`;
+        }
+        if (!/^[A-Za-z][A-Za-z0-9_]*$/.test(segment)) {
+            return /^[0-9]/.test(segment)
+                ? `"${segment}" begins with a digit, and a segment has to begin with a letter`
+                : `"${segment}" is not a valid segment: letters, digits and underscores only, and no hyphens`;
+        }
+        if (JAVA_KEYWORDS.has(segment)) {
+            return `"${segment}" is a Java keyword, which Android cannot use as a segment`;
+        }
+    }
+    return undefined;
+}
+export function describeManifestProblems(manifest) {
+    const problems = [];
+    const packageIdProblem = describePackageIdProblem(manifest.packageId ?? "");
+    if (packageIdProblem !== undefined) {
+        problems.push(`packageId is not a valid Android application id: ${packageIdProblem}`);
+    }
+    if (!manifest.startUrl?.startsWith("/")) {
+        problems.push("startUrl must be a path relative to the origin");
+    }
+    if (!manifest.webManifestUrl) {
+        problems.push("webManifestUrl is missing, which Chrome OS and Meta Quest devices require");
+    }
+    if (manifest.display && !["standalone", "fullscreen", "fullscreen-sticky"].includes(manifest.display)) {
+        problems.push(`display "${manifest.display}" cannot launch fullscreen; use standalone or fullscreen`);
+    }
+    if (!manifest.maskableIconUrl) {
+        problems.push("no maskable icon was found, so Android will letterbox the launcher icon");
+    }
+    return problems;
+}
+async function assertJdk17(javaHome) {
+    const release = await readFile(join(javaHome, "release"), "utf8").catch(() => undefined);
+    if (release === undefined) {
+        throw new Error(`No JDK release file found at ${javaHome}. Point JAVA_HOME at a JDK ${REQUIRED_JDK_MAJOR} installation.`);
+    }
+    if (!isSupportedJdkRelease(release)) {
+        const found = /JAVA_VERSION="([^"]+)"/.exec(release)?.[1] ?? "an unknown version";
+        throw new Error(`The JDK at ${javaHome} is ${found}. The Android command line tools require exactly JDK ${REQUIRED_JDK_MAJOR}; newer majors are not supported.`);
+    }
+    return javaHome;
+}
+async function resolveJavaHome() {
+    if (process.env.JAVA_HOME) {
+        try {
+            return await assertJdk17(process.env.JAVA_HOME);
+        }
+        catch (error) {
+            if (process.platform !== "darwin")
+                throw error;
+        }
+    }
+    if (process.platform === "darwin") {
+        // Without -v this returns the machine default, which silently breaks the
+        // Gradle build as soon as a newer JDK is installed.
+        const { stdout } = await runCommand("/usr/libexec/java_home", [
+            "-v",
+            REQUIRED_JDK_MAJOR,
+        ]).catch(() => {
+            throw new Error(`No JDK ${REQUIRED_JDK_MAJOR} was found. Install one, for example: brew install --cask zulu@${REQUIRED_JDK_MAJOR}`);
+        });
+        return assertJdk17(stdout);
+    }
+    throw new Error(`JAVA_HOME must point to a JDK ${REQUIRED_JDK_MAJOR} installation.`);
+}
+export function resolveAndroidSdk() {
+    const sdk = process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT;
+    if (!sdk) {
+        throw new Error("ANDROID_HOME or ANDROID_SDK_ROOT must point to the Android SDK.");
+    }
+    if (/\s/.test(sdk)) {
+        throw new Error(`The Android SDK path must not contain spaces: ${sdk}. The Android build tools cannot resolve it.`);
+    }
+    return sdk;
+}
+/**
+ * Gradle fails opaquely when SDK licences have never been accepted, so this is
+ * checked up front where the fix can be spelled out.
+ */
+async function assertAndroidSdkLicenses(sdk) {
+    const licence = join(sdk, "licenses", "android-sdk-license");
+    const accepted = await readFile(licence, "utf8").then((contents) => contents.trim().length > 0, () => false);
+    if (!accepted) {
+        throw new Error(`The Android SDK licences have not been accepted. Run: ${join(sdk, "cmdline-tools", "latest", "bin", "sdkmanager")} --licenses`);
+    }
+}
+/** Highest installed build-tools revision, which is where apksigner lives. */
+async function resolveApksigner(sdk) {
+    const buildTools = join(sdk, "build-tools");
+    const revisions = await readdir(buildTools).catch(() => []);
+    const [newest] = revisions
+        .filter((entry) => /^\d+/.test(entry))
+        .sort((a, b) => b.localeCompare(a, undefined, { numeric: true }));
+    return newest ? join(buildTools, newest, "apksigner") : undefined;
+}
+/**
+ * Removes the generated project while keeping Gradle's caches, so a rebuild is
+ * incremental rather than starting from an empty directory every time.
+ */
+async function cleanGeneratedProject(outputRoot) {
+    const entries = await readdir(outputRoot).catch(() => undefined);
+    if (!entries) {
+        await mkdir(outputRoot, { recursive: true });
+        return;
+    }
+    await Promise.all(entries
+        .filter((entry) => !PRESERVED_BUILD_ENTRIES.has(entry))
+        .map((entry) => rm(join(outputRoot, entry), { force: true, recursive: true })));
+}
+async function fetchManifest(manifestUrl) {
+    const response = await fetch(manifestUrl);
+    if (!response.ok) {
+        throw new Error(`Could not read ${manifestUrl}: HTTP ${response.status}`);
+    }
+    const source = await response.text();
+    return { chrome: readAndroidChrome(source), hash: hashManifestSource(source) };
+}
+export async function buildAndroidWrapper(projectRoot, manifestUrl) {
+    const outputRoot = join(projectRoot, ".adjacent", "android");
+    const sdk = resolveAndroidSdk();
+    const javaHome = await resolveJavaHome();
+    await assertAndroidSdkLicenses(sdk);
+    await cleanGeneratedProject(outputRoot);
+    fetchUtils.setFetchEngine("node-fetch");
+    const manifest = await fetchManifest(manifestUrl);
+    const derived = await TwaManifest.fromWebManifest(manifestUrl);
+    // Overrides are applied through the JSON form rather than onto the instance.
+    // On a TwaManifest the colour fields hold Color objects whose `hex()` is
+    // called during generation, so assigning strings to them throws; the JSON
+    // form declares them as strings and the constructor parses them back.
+    const twaManifest = new TwaManifest({
+        ...derived.toJson(),
+        ...manifest.chrome,
+        enableNotifications: false,
+        enableSiteSettingsShortcut: false,
+        generatorApp: "Adjacent",
+        packageId: ANDROID_PACKAGE_ID,
+        // Development wrappers are assembled as debug builds, so the release
+        // keystore Bubblewrap defaults to is never created. Point at Gradle's own.
+        signingKey: {
+            alias: "androiddebugkey",
+            path: join(homedir(), ".android", "debug.keystore"),
+        },
+    });
+    const validationError = twaManifest.validate();
+    if (validationError) {
+        throw new Error(`The web manifest is missing required fields: ${validationError}`);
+    }
+    const problems = describeManifestProblems(twaManifest);
+    if (problems.length > 0) {
+        throw new Error(`The web manifest cannot produce a fullscreen Android wrapper:\n  - ${problems.join("\n  - ")}`);
+    }
+    await twaManifest.saveToFile(join(outputRoot, "twa-manifest.json"));
+    await new TwaGenerator().createTwaProject(outputRoot, twaManifest, new ConsoleLog("Adjacent", false));
+    await runCommand(join(outputRoot, "gradlew"), ["assembleDebug", "--stacktrace"], {
+        cwd: outputRoot,
+        env: { ...process.env, ANDROID_HOME: sdk, JAVA_HOME: javaHome },
+    }).catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        if (/licen[cs]e/i.test(message)) {
+            throw new Error(`Gradle could not build the wrapper because Android SDK licences are outstanding. Run: ${join(sdk, "cmdline-tools", "latest", "bin", "sdkmanager")} --licenses`);
+        }
+        throw error;
+    });
+    const apkPath = join(outputRoot, "app", "build", "outputs", "apk", "debug", "app-debug.apk");
+    await readFile(apkPath);
+    const state = {
+        manifestHash: manifest.hash,
+        manifestUrl,
+        packageId: ANDROID_PACKAGE_ID,
+    };
+    await writeFile(join(outputRoot, "adjacent-state.json"), `${JSON.stringify(state, null, 2)}\n`);
+    return { apkPath, packageId: ANDROID_PACKAGE_ID };
+}
+export async function readExistingAndroidWrapper(projectRoot, manifestUrl) {
+    const outputRoot = join(projectRoot, ".adjacent", "android");
+    const apkPath = join(outputRoot, "app", "build", "outputs", "apk", "debug", "app-debug.apk");
+    try {
+        const rawState = await readFile(join(outputRoot, "adjacent-state.json"), "utf8");
+        const state = JSON.parse(rawState);
+        if (state.manifestUrl !== manifestUrl || !state.manifestHash)
+            return undefined;
+        // The URL alone is constant across a session, so the manifest contents are
+        // compared too: renaming the app or changing its icons must rebuild.
+        if (state.manifestHash !== (await fetchManifest(manifestUrl)).hash) {
+            return undefined;
+        }
+        await readFile(apkPath);
+        return { apkPath, packageId: ANDROID_PACKAGE_ID };
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function readAndroidAssetLink(wrapper) {
+    const javaHome = await resolveJavaHome();
+    const apksigner = await resolveApksigner(resolveAndroidSdk());
+    // apksigner reads v1, v2, and v3 signatures; keytool only reads the v1 JAR
+    // signature, which Gradle stops emitting once minSdkVersion reaches 24.
+    const output = apksigner
+        ? await runCommand(apksigner, ["verify", "--print-certs", wrapper.apkPath], {
+            env: { ...process.env, JAVA_HOME: javaHome },
+        }).then(({ stdout }) => stdout, () => undefined)
+        : undefined;
+    const fallback = output
+        ? undefined
+        : await runCommand(join(javaHome, "bin", "keytool"), [
+            "-printcert",
+            "-jarfile",
+            wrapper.apkPath,
+        ]).then(({ stdout }) => stdout);
+    const fingerprint = parseCertificateFingerprint(output ?? fallback ?? "");
+    if (!fingerprint) {
+        throw new Error(`Could not read the SHA-256 signing fingerprint from ${wrapper.apkPath}.`);
+    }
+    return { packageId: wrapper.packageId, sha256Fingerprint: fingerprint };
+}
+/** Backs `adj doctor`, reporting the toolchain Bubblewrap needs. */
+export async function inspectAndroidToolchain() {
+    const androidSdk = resolveAndroidSdk();
+    const javaHome = await resolveJavaHome();
+    const licensesAccepted = await assertAndroidSdkLicenses(androidSdk).then(() => true, () => false);
+    return { androidSdk, javaHome, licensesAccepted };
+}
+//# sourceMappingURL=android-wrapper.js.map

package/dist/android-wrapper.js.map

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

package/dist/android.d.ts

@@ -0,0 +1,17 @@
+export interface AndroidDevice {
+    readonly serial: string;
+    readonly state: string;
+}
+export declare function parseAdbDevices(output: string): AndroidDevice[];
+export declare function resolveAdbPath(): Promise<string>;
+export declare function selectReadyAndroidDevice(devices: readonly AndroidDevice[], requestedSerial?: string): string;
+export declare function selectAndroidDeviceByChoice(devices: readonly AndroidDevice[], choice: string): AndroidDevice | undefined;
+export declare function selectAndroidDevice(adb: string, requestedSerial?: string): Promise<string>;
+export declare function prepareAndroidChrome(adb: string, serial: string, port: number): Promise<void>;
+export declare function openAndroidChrome(adb: string, serial: string, url: string): Promise<void>;
+export declare function installAndroidApk(adb: string, serial: string, apkPath: string): Promise<void>;
+export declare function isAndroidPackageInstalled(adb: string, serial: string, packageId: string): Promise<boolean>;
+export declare function openAndroidPackage(adb: string, serial: string, packageId: string): Promise<void>;
+export declare function androidPackageLaunchArgs(serial: string, packageId: string): string[];
+export declare function removeAndroidReverse(adb: string, serial: string, port: number): Promise<void>;
+//# sourceMappingURL=android.d.ts.map

package/dist/android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.d.ts","sourceRoot":"","sources":["../src/android.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAY/D;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAWtD;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CA2BR;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,SAAS,CAM3B;AAgBD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,MAAM,CAAC,CAajB;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAWlB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAgBV;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/android.js

@@ -0,0 +1,153 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { runCommand } from "adjacent-cli";
+import { selectItem } from "adjacent-cli";
+const ADB_DEVICE_LINE = /^(.*?)\s+(bootloader|connecting|device|host|no permissions|offline|recovery|sideload|unauthorized)(?:\s|$)/;
+export function parseAdbDevices(output) {
+    return output
+        .split("\n")
+        .slice(1)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .flatMap((line) => {
+        const match = ADB_DEVICE_LINE.exec(line);
+        if (!match)
+            return [];
+        const [, serial, state] = match;
+        return serial && state ? [{ serial, state }] : [];
+    });
+}
+export async function resolveAdbPath() {
+    const sdkRoot = process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT;
+    if (!sdkRoot)
+        return "adb";
+    const candidate = join(sdkRoot, "platform-tools", "adb");
+    try {
+        await access(candidate);
+        return candidate;
+    }
+    catch {
+        return "adb";
+    }
+}
+export function selectReadyAndroidDevice(devices, requestedSerial) {
+    if (requestedSerial) {
+        const requested = devices.find(({ serial }) => serial === requestedSerial);
+        if (!requested) {
+            throw new Error(`Android device ${requestedSerial} is not connected.`);
+        }
+        if (requested.state !== "device") {
+            throw new Error(`Android device ${requestedSerial} is ${requested.state}. Authorize or reconnect it and try again.`);
+        }
+        return requested.serial;
+    }
+    const readyDevices = devices.filter(({ state }) => state === "device");
+    if (readyDevices.length === 0) {
+        throw new Error("No ready Android device found. Start an emulator or connect and authorize a phone, then try again.");
+    }
+    if (readyDevices.length > 1) {
+        throw new Error(`Multiple Android devices are ready. Choose one with --device: ${readyDevices.map(({ serial }) => serial).join(", ")}`);
+    }
+    return readyDevices[0].serial;
+}
+export function selectAndroidDeviceByChoice(devices, choice) {
+    const index = Number(choice.trim());
+    if (!Number.isInteger(index) || index < 1 || index > devices.length) {
+        return undefined;
+    }
+    return devices[index - 1];
+}
+async function promptForAndroidDevice(devices) {
+    const selected = await selectItem({
+        message: "Choose an Android device",
+        items: devices.map((device) => ({
+            hint: device.state,
+            label: device.serial,
+            value: device,
+        })),
+    });
+    return selectReadyAndroidDevice(devices, selected.serial);
+}
+export async function selectAndroidDevice(adb, requestedSerial) {
+    const { stdout } = await runCommand(adb, ["devices", "-l"]);
+    const devices = parseAdbDevices(stdout);
+    if (requestedSerial)
+        return selectReadyAndroidDevice(devices, requestedSerial);
+    if (devices.length === 0) {
+        throw new Error("No Android devices found. Start an emulator or connect a phone, then try again.");
+    }
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+        return promptForAndroidDevice(devices);
+    }
+    return selectReadyAndroidDevice(devices);
+}
+export async function prepareAndroidChrome(adb, serial, port) {
+    const { stdout } = await runCommand(adb, [
+        "-s",
+        serial,
+        "shell",
+        "pm",
+        "list",
+        "packages",
+        "com.android.chrome",
+    ]);
+    if (!stdout.split("\n").includes("package:com.android.chrome")) {
+        throw new Error("Google Chrome is not installed on the selected Android device.");
+    }
+    const target = `tcp:${port}`;
+    await runCommand(adb, ["-s", serial, "reverse", target, target]);
+}
+export async function openAndroidChrome(adb, serial, url) {
+    await runCommand(adb, [
+        "-s",
+        serial,
+        "shell",
+        "am",
+        "start",
+        "-W",
+        "-a",
+        "android.intent.action.VIEW",
+        "-d",
+        url,
+        "com.android.chrome",
+    ]);
+}
+export async function installAndroidApk(adb, serial, apkPath) {
+    await runCommand(adb, ["-s", serial, "install", "-r", apkPath]);
+}
+export async function isAndroidPackageInstalled(adb, serial, packageId) {
+    const { stdout } = await runCommand(adb, [
+        "-s",
+        serial,
+        "shell",
+        "pm",
+        "list",
+        "packages",
+        packageId,
+    ]);
+    return stdout.split("\n").includes(`package:${packageId}`);
+}
+export async function openAndroidPackage(adb, serial, packageId) {
+    await runCommand(adb, androidPackageLaunchArgs(serial, packageId));
+}
+export function androidPackageLaunchArgs(serial, packageId) {
+    return [
+        "-s",
+        serial,
+        "shell",
+        "am",
+        "start",
+        "-W",
+        "-S",
+        "-a",
+        "android.intent.action.MAIN",
+        "-c",
+        "android.intent.category.LAUNCHER",
+        "-p",
+        packageId,
+    ];
+}
+export async function removeAndroidReverse(adb, serial, port) {
+    await runCommand(adb, ["-s", serial, "reverse", "--remove", `tcp:${port}`]);
+}
+//# sourceMappingURL=android.js.map

package/dist/android.js.map

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

package/dist/checks.d.ts

@@ -0,0 +1,21 @@
+import { type DoctorCheck } from "adjacent-cli";
+export interface AssetLinksProblem {
+    readonly detail: string;
+    readonly remedy: string;
+}
+/**
+ * Reads a digital asset links document the way Android does, and says what is
+ * wrong with it.
+ *
+ * A wrong or unreachable one is the single most common Android fault: the app
+ * launches with a browser address bar across the top, or does not launch at
+ * all, and nothing anywhere says why. Every rule here is one that produces
+ * exactly that symptom.
+ */
+export declare function describeAssetLinksProblem(requested: URL, response: {
+    readonly ok: boolean;
+    readonly status: number;
+    readonly url: string;
+}, body: string): AssetLinksProblem | undefined;
+export declare const ANDROID_CHECKS: readonly DoctorCheck[];
+//# sourceMappingURL=checks.d.ts.map

package/dist/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,GAAG,EACd,QAAQ,EAAE;IAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACjF,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,SAAS,CA8D/B;AA2ED,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EAIhD,CAAC"}