adjacent-dev-client 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## Unpublished
+
+### 🛠 Breaking changes
+
+### 🎉 New features
+
+### 🐛 Bug fixes
+
+### 💡 Others
+
+## 0.1.0 - 2026-08-29
+
+_This version does not introduce any user-facing changes._

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eric Kweyunga
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# adjacent-dev-client
+
+Runs an Adjacent app on a real Android device, over a trusted tunnel and inside
+a Trusted Web Activity.
+
+## Documentation
+
+- [Android development](https://github.com/erickweyunga/adjacent-framework/blob/main/docs/android.md)
+- [Checking the toolchain](https://github.com/erickweyunga/adjacent-framework/blob/main/docs/doctor.md)
+- [All the documentation](https://github.com/erickweyunga/adjacent-framework/blob/main/docs/README.md)
+
+## Installation
+
+```bash
+npm install --save-dev adjacent-dev-client
+```
+
+Everything else in Adjacent works without it. Install it when you want to run
+the app on a device rather than in a browser:
+
+```bash
+adj dev --android
+```
+
+`adjacent-cli` loads this only when a command asks for a device, so a project
+that never does pays nothing for it. That matters: the Android toolchain it
+carries is most of what installing Adjacent would otherwise cost.
+
+## What it carries
+
+- Android device and emulator discovery through ADB
+- The Trusted Web Activity wrapper, built with Bubblewrap
+- Digital Asset Links generated from the wrapper's signing certificate
+- The trusted HTTPS development tunnel
+- `adj doctor`, including the Play Store quality criteria
+
+## Known advisories
+
+`bun audit` reports three advisories reached through `@bubblewrap/core`, none of
+which can be fixed without breaking the Android build, and one of which has no
+patched release anywhere. They are development tooling on a developer's machine,
+no application ships them, and the high-severity one is in a code path Adjacent
+never calls. The reasoning is written out in
+[SECURITY.md](https://github.com/erickweyunga/adjacent-framework/blob/main/SECURITY.md).
+
+## Issues
+
+If you hit a problem using this package, please
+[report it here](https://github.com/erickweyunga/adjacent-framework/issues/new).
+
+## Contributing
+
+Issues and pull requests are welcome. Please read the
+[contributing guide](https://github.com/erickweyunga/adjacent-framework/blob/main/CONTRIBUTING.md)
+first.
+
+## License
+
+MIT

package/dist/android-dev.d.ts

@@ -0,0 +1,4 @@
+import type { AndroidDevOptions, AndroidInstallOptions } from "adjacent-cli";
+export declare function runAndroidDev(options: AndroidDevOptions): Promise<void>;
+export declare function runAndroidInstall(options: AndroidInstallOptions): Promise<void>;
+//# sourceMappingURL=android-dev.d.ts.map

package/dist/android-dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-dev.d.ts","sourceRoot":"","sources":["../src/android-dev.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAsF7E,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqI7E;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmErF"}

package/dist/android-dev.js

@@ -0,0 +1,239 @@
+import { resolve } from "node:path";
+import { get } from "node:https";
+import { createServer } from "node:net";
+import { installAndroidApk, isAndroidPackageInstalled, openAndroidChrome, openAndroidPackage, prepareAndroidChrome, removeAndroidReverse, resolveAdbPath, selectAndroidDevice, } from "./android.js";
+import { ANDROID_PACKAGE_ID, buildAndroidWrapper, readAndroidAssetLink, readExistingAndroidWrapper, } from "./android-wrapper.js";
+import { clearDevChannelState, startDevChannel, writeDevChannelState, } from "adjacent-cli";
+import { KEY_HELP, watchKeys } from "adjacent-cli";
+import { resolvePackageManager } from "adjacent-cli";
+import { killProcessTree, startCommand, terminateProcessTree } from "adjacent-cli";
+import { createShutdown } from "adjacent-cli";
+import { startAdjacentTunnel } from "./tunnel.js";
+import { intro, outro, step, success, task } from "adjacent-cli";
+async function assertPortAvailable(port) {
+    await new Promise((resolveAvailable, rejectUnavailable) => {
+        const probe = createServer();
+        probe.once("error", () => {
+            rejectUnavailable(new Error(`Port ${port} is already in use. Stop the existing development server or pass --port PORT.`));
+        });
+        probe.listen(port, "::", () => {
+            probe.close((error) => {
+                if (error)
+                    rejectUnavailable(error);
+                else
+                    resolveAvailable();
+            });
+        });
+    });
+}
+async function isServerReady(url) {
+    if (!url.startsWith("https:")) {
+        try {
+            return (await fetch(url)).ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    return new Promise((resolveReady) => {
+        const request = get(url, { rejectUnauthorized: false }, (response) => {
+            response.resume();
+            resolveReady((response.statusCode ?? 500) < 400);
+        });
+        request.once("error", () => resolveReady(false));
+        request.end();
+    });
+}
+async function waitForServer(url, server, timeoutMilliseconds = 30_000) {
+    const deadline = Date.now() + timeoutMilliseconds;
+    while (Date.now() < deadline) {
+        if (server.exitCode !== null) {
+            throw new Error(`Next.js development server exited with code ${server.exitCode}.`);
+        }
+        if (await isServerReady(url))
+            return;
+        await new Promise((resolveDelay) => setTimeout(resolveDelay, 250));
+    }
+    throw new Error(`Next.js did not become ready at ${url} within 30 seconds.`);
+}
+export async function runAndroidDev(options) {
+    intro("Adjacent Android development");
+    const projectRoot = resolve(options.projectRoot);
+    await assertPortAvailable(options.port);
+    const adb = await resolveAdbPath();
+    const serial = await selectAndroidDevice(adb, options.device);
+    const localUrl = `http://localhost:${options.port}`;
+    const healthUrl = `http://127.0.0.1:${options.port}`;
+    success(`Using Android device ${serial}`);
+    const tunnel = options.standalone
+        ? await task("Starting the secure development tunnel", () => startAdjacentTunnel(projectRoot, options.port, options.verbose))
+        : undefined;
+    if (!tunnel) {
+        await task("Connecting the development server to Android", () => prepareAndroidChrome(adb, serial, options.port));
+    }
+    const channel = await startDevChannel();
+    const manager = await resolvePackageManager({ projectRoot });
+    const dev = manager.run("dev", ["--port", String(options.port)]);
+    step("Starting the Next.js development server");
+    // The CLI owns the keyboard, so the server never reads this terminal.
+    const server = startCommand(dev.command, dev.args, {
+        cwd: projectRoot,
+        detached: true,
+        env: {
+            ...process.env,
+            ADJACENT_DEV_CHANNEL_URL: channel.url,
+            ...(tunnel ? {
+                ADJACENT_ASSET_LINKS_URL: tunnel.assetLinksUrl,
+                ADJACENT_DEV_ORIGIN: tunnel.origin,
+            } : null),
+        },
+        stdio: ["ignore", "inherit", "inherit"],
+    });
+    let restoreTerminal = () => undefined;
+    const shutdown = createShutdown({
+        exit: (code) => process.exit(code),
+        kill: () => {
+            killProcessTree(server, "SIGKILL");
+            tunnel?.process.kill("SIGKILL");
+        },
+        notify: step,
+        release: async () => {
+            await clearDevChannelState(projectRoot).catch(() => undefined);
+            await channel.stop().catch(() => undefined);
+            await terminateProcessTree(server);
+            if (tunnel)
+                await tunnel.stop().catch(() => undefined);
+            try {
+                await removeAndroidReverse(adb, serial, options.port);
+            }
+            catch {
+                // The device may have already disconnected.
+            }
+        },
+        restore: () => restoreTerminal(),
+    });
+    const stopListening = shutdown.listen();
+    try {
+        await task("Waiting for the Next.js development server", () => waitForServer(healthUrl, server));
+        if (tunnel) {
+            const manifestUrl = `${tunnel.origin}/manifest.webmanifest`;
+            await task("Waiting for the public development URL", () => waitForServer(tunnel.origin, tunnel.process, 45_000));
+            let wrapper = await readExistingAndroidWrapper(projectRoot, manifestUrl);
+            const wrapperNeedsBuild = !wrapper;
+            const installed = await isAndroidPackageInstalled(adb, serial, ANDROID_PACKAGE_ID);
+            if (!wrapper) {
+                wrapper = await task("Building the Adjacent Android wrapper", () => buildAndroidWrapper(projectRoot, manifestUrl));
+            }
+            tunnel.setAssetLink(await readAndroidAssetLink(wrapper));
+            await task("Verifying the Android application link", () => waitForServer(`${tunnel.origin}/.well-known/assetlinks.json`, tunnel.process));
+            if (!installed || wrapperNeedsBuild) {
+                await task("Installing the Android wrapper", () => installAndroidApk(adb, serial, wrapper.apkPath));
+                success(`Installed ${wrapper.packageId} on ${serial}`);
+            }
+            await task("Opening the standalone app", () => openAndroidPackage(adb, serial, ANDROID_PACKAGE_ID));
+            outro(`Opened ${tunnel.origin} on ${serial}`);
+        }
+        else {
+            await task("Opening Chrome on Android", () => openAndroidChrome(adb, serial, localUrl));
+            outro(`Opened ${localUrl} in Chrome on ${serial}`);
+        }
+        await writeDevChannelState(projectRoot, {
+            channelUrl: channel.url,
+            origin: tunnel?.origin ?? localUrl,
+            pid: process.pid,
+            port: options.port,
+        });
+        const send = async (command) => {
+            const clients = channel.publish(command);
+            step(clients === 0
+                ? "No open app is connected to the development channel."
+                : `Sent ${command.type} to ${clients} connected app${clients === 1 ? "" : "s"}.`);
+        };
+        const reopen = async () => {
+            if (tunnel)
+                await openAndroidPackage(adb, serial, ANDROID_PACKAGE_ID);
+            else
+                await openAndroidChrome(adb, serial, localUrl);
+            step(`Reopened the app on ${serial}.`);
+        };
+        step(KEY_HELP);
+        restoreTerminal = watchKeys({
+            onInterrupt: () => shutdown.request(130),
+            onOpen: reopen,
+            onQuit: () => shutdown.request(0),
+            onSend: send,
+            onShowHelp: () => step(KEY_HELP),
+        });
+        try {
+            await new Promise((resolveExit, rejectExit) => {
+                server.once("error", rejectExit);
+                server.once("exit", () => resolveExit());
+            });
+        }
+        finally {
+            restoreTerminal();
+        }
+    }
+    finally {
+        stopListening();
+        await shutdown.release();
+    }
+}
+export async function runAndroidInstall(options) {
+    intro("Adjacent Android installation");
+    const projectRoot = resolve(options.projectRoot);
+    await assertPortAvailable(options.port);
+    const adb = await resolveAdbPath();
+    const serial = await selectAndroidDevice(adb, options.device);
+    const healthUrl = `http://127.0.0.1:${options.port}`;
+    success(`Using Android device ${serial}`);
+    const tunnel = await task("Starting the secure development tunnel", () => startAdjacentTunnel(projectRoot, options.port, options.verbose));
+    step("Starting the Next.js development server");
+    const manager = await resolvePackageManager({ projectRoot });
+    const dev = manager.run("dev", ["--port", String(options.port)]);
+    const server = startCommand(dev.command, dev.args, {
+        cwd: projectRoot,
+        detached: true,
+        env: {
+            ...process.env,
+            ADJACENT_ASSET_LINKS_URL: tunnel.assetLinksUrl,
+            ADJACENT_DEV_ORIGIN: tunnel.origin,
+        },
+        stdio: ["ignore", "inherit", "inherit"],
+    });
+    const shutdown = createShutdown({
+        exit: (code) => process.exit(code),
+        kill: () => {
+            killProcessTree(server, "SIGKILL");
+            tunnel.process.kill("SIGKILL");
+        },
+        notify: step,
+        release: async () => {
+            await terminateProcessTree(server);
+            await tunnel.stop().catch(() => undefined);
+            try {
+                await removeAndroidReverse(adb, serial, options.port);
+            }
+            catch {
+                // The device may have disconnected.
+            }
+        },
+        restore: () => undefined,
+    });
+    const stopListening = shutdown.listen();
+    try {
+        await task("Waiting for the Next.js development server", () => waitForServer(healthUrl, server));
+        await task("Waiting for the public development URL", () => waitForServer(tunnel.origin, tunnel.process, 45_000));
+        const wrapper = await task("Building the Adjacent Android wrapper", () => buildAndroidWrapper(projectRoot, `${tunnel.origin}/manifest.webmanifest`));
+        tunnel.setAssetLink(await readAndroidAssetLink(wrapper));
+        await task("Verifying the Android application link", () => waitForServer(`${tunnel.origin}/.well-known/assetlinks.json`, tunnel.process));
+        await task("Installing the Android wrapper", () => installAndroidApk(adb, serial, wrapper.apkPath));
+        success(`Installed ${wrapper.packageId} on ${serial}`);
+        outro("Run adj dev --android to launch it.");
+    }
+    finally {
+        stopListening();
+        await shutdown.release();
+    }
+}
+//# sourceMappingURL=android-dev.js.map

package/dist/android-dev.js.map

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

package/dist/android-wrapper.d.ts

@@ -0,0 +1,63 @@
+export declare const ANDROID_PACKAGE_ID = "dev.adjacent.runner";
+export interface AndroidWrapper {
+    readonly apkPath: string;
+    readonly packageId: string;
+}
+export interface AndroidAssetLink {
+    readonly packageId: string;
+    readonly sha256Fingerprint: string;
+}
+export declare function isSupportedJdkRelease(releaseFile: string): boolean;
+/**
+ * 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 declare function parseCertificateFingerprint(output: string): string | undefined;
+export interface AndroidChrome {
+    navigationColor?: string;
+    navigationColorDark?: string;
+    navigationDividerColor?: string;
+    navigationDividerColorDark?: string;
+    themeColorDark?: string;
+}
+/**
+ * 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 declare function readAndroidChrome(manifestSource: string): AndroidChrome;
+export declare function hashManifestSource(source: string): string;
+/**
+ * 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 declare function describePackageIdProblem(packageId: string): string | undefined;
+export declare function describeManifestProblems(manifest: {
+    readonly display?: string;
+    readonly iconUrl?: string;
+    readonly maskableIconUrl?: string;
+    readonly packageId?: string;
+    readonly startUrl?: string;
+    readonly webManifestUrl?: URL | string;
+}): string[];
+export declare function resolveAndroidSdk(): string;
+export declare function buildAndroidWrapper(projectRoot: string, manifestUrl: string): Promise<AndroidWrapper>;
+export declare function readExistingAndroidWrapper(projectRoot: string, manifestUrl: string): Promise<AndroidWrapper | undefined>;
+export declare function readAndroidAssetLink(wrapper: AndroidWrapper): Promise<AndroidAssetLink>;
+export interface AndroidToolchain {
+    readonly androidSdk: string;
+    readonly javaHome: string;
+    readonly licensesAccepted: boolean;
+}
+/** Backs `adj doctor`, reporting the toolchain Bubblewrap needs. */
+export declare function inspectAndroidToolchain(): Promise<AndroidToolchain>;
+//# sourceMappingURL=android-wrapper.d.ts.map

package/dist/android-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-wrapper.d.ts","sourceRoot":"","sources":["../src/android-wrapper.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AAYxD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAQD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ9E;AAKD,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,CAqBvE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEzD;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB9E;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC;CACxC,GAAG,MAAM,EAAE,CA2BX;AAgDD,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AA0DD,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC,CA2EzB;AAED,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAmBrC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,oEAAoE;AACpE,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAQzE"}