adjacent-cli 0.1.0

package/dist/create.d.ts

@@ -0,0 +1,42 @@
+import { type InitPorts, type InitResult } from "./init.js";
+import { type InstallOptions, type PackageManager } from "./package-manager.js";
+export interface CreateOptions {
+    readonly cwd?: string;
+    readonly directory?: string;
+    readonly install: boolean;
+    readonly projectName: string;
+}
+export interface CreatePorts extends InitPorts {
+    /** Scaffolds the plain Next.js application Adjacent then adds itself to. */
+    readonly createNextApp?: (options: CreateNextAppOptions) => Promise<void>;
+}
+export interface CreateNextAppOptions {
+    readonly destination: string;
+    readonly projectName: string;
+}
+export interface CreateResult extends InitResult {
+    readonly destination: string;
+}
+/**
+ * Next.js owns what a current Next.js application looks like, so Adjacent does
+ * not carry a copy of one. These flags pick the shape Adjacent supports: the
+ * App Router, TypeScript, and Tailwind, which the starter shell is written in.
+ */
+export declare function createNextAppArguments(destination: string, manager: PackageManager): readonly string[];
+export interface NextStepsOptions {
+    readonly cwd: string;
+    readonly destination: string;
+    /** How the install has to be run, which the printed command must match. */
+    readonly installOptions?: InstallOptions;
+    readonly installed: boolean;
+    readonly packageManager: PackageManager;
+}
+/** The exact commands to run next, adapted to what this run already did. */
+export declare function describeNextSteps({ cwd, destination, installOptions, installed, packageManager, }: NextStepsOptions): readonly string[];
+/**
+ * Creates a Next.js application with `create-next-app`, then adds Adjacent to
+ * it with the same code path `adj init` uses on an application that already
+ * exists.
+ */
+export declare function runCreate(options: CreateOptions, ports?: CreatePorts): Promise<CreateResult>;
+//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,SAAS,MAAM,EAAE,CAkBnB;AAmBD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,EAChC,GAAG,EACH,WAAW,EACX,cAAc,EACd,SAAS,EACT,cAAc,GACf,EAAE,gBAAgB,GAAG,SAAS,MAAM,EAAE,CAatC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,aAAa,EACtB,KAAK,GAAE,WAAgB,GACtB,OAAO,CAAC,YAAY,CAAC,CA+BvB"}

package/dist/create.js

@@ -0,0 +1,82 @@
+import { relative, resolve } from "node:path";
+import { assertDestinationUsable, resolveDestination } from "./destination.js";
+import { runInit } from "./init.js";
+import { resolvePackageManager, } from "./package-manager.js";
+import { runInheritedCommand } from "./process.js";
+import { deriveProjectIdentity } from "./project-name.js";
+import { TERMINAL_REPORTER } from "./reporter.js";
+/**
+ * Next.js owns what a current Next.js application looks like, so Adjacent does
+ * not carry a copy of one. These flags pick the shape Adjacent supports: the
+ * App Router, TypeScript, and Tailwind, which the starter shell is written in.
+ */
+export function createNextAppArguments(destination, manager) {
+    return [
+        destination,
+        "--app",
+        "--empty",
+        "--import-alias",
+        "@/*",
+        "--no-eslint",
+        "--no-src-dir",
+        "--tailwind",
+        "--typescript",
+        // Scaffold with whatever is installing here, so the project ends up with
+        // one lockfile rather than two.
+        manager.scaffoldFlag,
+        // Adjacent initialises no repository of its own, so neither does this.
+        "--disable-git",
+        "--yes",
+    ];
+}
+async function scaffoldNextApp({ destination, }) {
+    const manager = await resolvePackageManager();
+    const { args, command } = manager.exec("create-next-app@latest", createNextAppArguments(destination, manager));
+    await runInheritedCommand(command, args).catch((error) => {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not create the Next.js application at ${destination}: ${detail}`);
+    });
+}
+/** The exact commands to run next, adapted to what this run already did. */
+export function describeNextSteps({ cwd, destination, installOptions, installed, packageManager, }) {
+    const relativePath = relative(cwd, destination);
+    const target = relativePath === "" || relativePath.startsWith("..") ? destination : relativePath;
+    const install = packageManager.install(installOptions);
+    const dev = packageManager.run("dev");
+    return [
+        `cd ${target}`,
+        ...(installed ? [] : [`${install.command} ${install.args.join(" ")}`]),
+        `${dev.command} ${dev.args.join(" ")}`,
+        "adj dev --android",
+    ];
+}
+/**
+ * Creates a Next.js application with `create-next-app`, then adds Adjacent to
+ * it with the same code path `adj init` uses on an application that already
+ * exists.
+ */
+export async function runCreate(options, ports = {}) {
+    const report = ports.reporter ?? TERMINAL_REPORTER;
+    const cwd = options.cwd ?? process.cwd();
+    const identity = deriveProjectIdentity(options.projectName);
+    const destination = resolveDestination(identity.packageName, options.directory, cwd);
+    report.intro("Adjacent project");
+    await assertDestinationUsable(destination);
+    report.step("Creating a Next.js application");
+    await (ports.createNextApp ?? scaffoldNextApp)({
+        destination,
+        projectName: identity.packageName,
+    });
+    const result = await runInit({ install: options.install, projectRoot: destination, scaffold: true }, { ...ports, reporter: report });
+    const steps = describeNextSteps({
+        cwd,
+        destination,
+        installOptions: result.installOptions,
+        installed: result.installed,
+        packageManager: result.packageManager,
+    });
+    report.step(`Next steps:\n${steps.map((command) => `  ${command}`).join("\n")}`);
+    report.outro(`${result.survey.identity.appName} is ready.`);
+    return { ...result, destination: resolve(destination) };
+}
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

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

package/dist/dependencies.d.ts

@@ -0,0 +1,59 @@
+/** Every Adjacent package a generated application depends on. */
+export declare const ADJACENT_PACKAGES: readonly [{
+    readonly directory: "adjacent-core";
+    readonly name: "adjacent-core";
+}, {
+    readonly directory: "adjacent-next";
+    readonly name: "adjacent-next";
+}, {
+    readonly directory: "adjacent-react";
+    readonly name: "adjacent-react";
+}, {
+    readonly directory: "adjacent-ui";
+    readonly name: "adjacent-ui";
+}];
+export declare const ADJACENT_VERSION: string;
+export declare const PUBLISHED_ADJACENT_RANGE: string;
+export declare const NEXT_VERSION = "^16.3.3";
+export declare const REACT_VERSION = "^19.2.8";
+export declare const TYPES_NODE_VERSION = "^20";
+export declare const TYPES_REACT_VERSION = "^19";
+export declare const TYPESCRIPT_VERSION = "^5";
+export interface AdjacentDependencies {
+    readonly dependencies: Readonly<Record<string, string>>;
+    /** True when the packages resolve to a local checkout rather than the registry. */
+    readonly linked: boolean;
+    /**
+     * True when the link is a `file:` path rather than a workspace membership.
+     * Bun's default linker copies such a dependency into place, and Turbopack
+     * cannot resolve the copy, so this asks for the isolated linker instead.
+     */
+    readonly pathLinked: boolean;
+    /**
+     * Present only when linking. The Adjacent packages depend on each other
+     * through `workspace:*`, which cannot resolve outside the framework
+     * repository, so those transitive specifiers are overridden too.
+     */
+    readonly overrides?: Readonly<Record<string, string>>;
+}
+export interface AdjacentDependencyOptions {
+    /** The framework's `packages/` directory. Absent means use the registry. */
+    readonly packagesRoot?: string;
+    /** Where the specifiers will be written, which decides whether they can be relative. */
+    readonly projectRoot?: string;
+    /** True when the project is a member of the framework's own Bun workspace. */
+    readonly workspaceMember?: boolean;
+}
+/**
+ * Matches a path against a workspace glob such as `packages/*` or `apps/**`.
+ * Bun's globs are simple enough that a full matcher would be more machinery
+ * than the two shapes anyone writes.
+ */
+export declare function matchesWorkspaceGlob(path: string, glob: string): boolean;
+/**
+ * Resolves how a generated application should depend on Adjacent. Passing the
+ * framework's `packages/` directory links against that checkout; passing
+ * nothing produces the published ranges.
+ */
+export declare function resolveAdjacentDependencies(options?: AdjacentDependencyOptions): AdjacentDependencies;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../src/dependencies.ts"],"names":[],"mappings":"AAIA,iEAAiE;AACjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAKpB,CAAC;AAiBX,eAAO,MAAM,gBAAgB,EAAE,MAAyB,CAAC;AAEzD,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAE/D,eAAO,MAAM,YAAY,YAAY,CAAC;AACtC,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AACzC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wFAAwF;IACxF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CASxE;AA2DD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,yBAA8B,GACtC,oBAAoB,CAgBtB"}

package/dist/dependencies.js

@@ -0,0 +1,100 @@
+import { readFileSync } from "node:fs";
+import { dirname, join, relative, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+/** Every Adjacent package a generated application depends on. */
+export const ADJACENT_PACKAGES = [
+    { directory: "adjacent-core", name: "adjacent-core" },
+    { directory: "adjacent-next", name: "adjacent-next" },
+    { directory: "adjacent-react", name: "adjacent-react" },
+    { directory: "adjacent-ui", name: "adjacent-ui" },
+];
+/**
+ * The Adjacent packages are versioned and published together, so a generated
+ * application asks for the same version as the CLI that generated it. Reading
+ * it here rather than hardcoding a range means publishing needs no code change.
+ */
+function readOwnVersion() {
+    // Read rather than imported: a JSON import attribute is not supported across
+    // every Node version this CLI is meant to run on.
+    const manifest = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    const { version } = JSON.parse(readFileSync(manifest, "utf8"));
+    return version;
+}
+export const ADJACENT_VERSION = readOwnVersion();
+export const PUBLISHED_ADJACENT_RANGE = `^${ADJACENT_VERSION}`;
+export const NEXT_VERSION = "^16.3.3";
+export const REACT_VERSION = "^19.2.8";
+export const TYPES_NODE_VERSION = "^20";
+export const TYPES_REACT_VERSION = "^19";
+export const TYPESCRIPT_VERSION = "^5";
+/**
+ * Matches a path against a workspace glob such as `packages/*` or `apps/**`.
+ * Bun's globs are simple enough that a full matcher would be more machinery
+ * than the two shapes anyone writes.
+ */
+export function matchesWorkspaceGlob(path, glob) {
+    const pattern = glob
+        .split("/")
+        .map((segment) => segment === "**" ? "[^\\0]*" : segment === "*" ? "[^/]+" : escapeSegment(segment))
+        .join("/");
+    return new RegExp(`^${pattern}$`).test(path);
+}
+function escapeSegment(segment) {
+    return segment.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function workspaceSpecifiers() {
+    return Object.fromEntries(ADJACENT_PACKAGES.map(({ name }) => [name, "workspace:*"]));
+}
+/** package.json specifiers are POSIX paths on every platform. */
+function toSpecifierPath(path) {
+    return path.split(sep).join("/");
+}
+/**
+ * A project inside the framework repository is linked relatively, so the
+ * checkout can be cloned or moved without every specifier breaking. A project
+ * anywhere else gets an absolute path, because a relative one would be a long
+ * climb that only holds while both stay exactly where they are.
+ */
+function linkedSpecifier(packagesRoot, directory, projectRoot) {
+    const target = join(packagesRoot, directory);
+    if (projectRoot === undefined)
+        return `file:${toSpecifierPath(target)}`;
+    const workspaceRoot = dirname(packagesRoot);
+    const fromWorkspace = relative(workspaceRoot, projectRoot);
+    const inCheckout = fromWorkspace !== "" &&
+        !fromWorkspace.startsWith("..") &&
+        !fromWorkspace.startsWith(sep);
+    return inCheckout
+        ? `file:${toSpecifierPath(relative(projectRoot, target))}`
+        : `file:${toSpecifierPath(target)}`;
+}
+function linkedSpecifiers(packagesRoot, projectRoot) {
+    return Object.fromEntries(ADJACENT_PACKAGES.map(({ directory, name }) => [
+        name,
+        linkedSpecifier(packagesRoot, directory, projectRoot),
+    ]));
+}
+function publishedSpecifiers() {
+    return Object.fromEntries(ADJACENT_PACKAGES.map(({ name }) => [name, PUBLISHED_ADJACENT_RANGE]));
+}
+/**
+ * Resolves how a generated application should depend on Adjacent. Passing the
+ * framework's `packages/` directory links against that checkout; passing
+ * nothing produces the published ranges.
+ */
+export function resolveAdjacentDependencies(options = {}) {
+    const { packagesRoot, projectRoot, workspaceMember } = options;
+    if (packagesRoot === undefined) {
+        return { dependencies: publishedSpecifiers(), linked: false, pathLinked: false };
+    }
+    // A member of the framework's own workspace is linked by Bun itself, which
+    // is the only form that survives a clean checkout: a `file:` link resolves a
+    // package's own dependencies from where it really lives, so it needs the
+    // framework's root install to have happened first.
+    if (workspaceMember) {
+        return { dependencies: workspaceSpecifiers(), linked: true, pathLinked: false };
+    }
+    const specifiers = linkedSpecifiers(packagesRoot, projectRoot);
+    return { dependencies: specifiers, linked: true, overrides: specifiers, pathLinked: true };
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/dependencies.js.map

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

package/dist/destination.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The project name is validated to be a single safe path segment, so the
+ * default destination cannot traverse. An explicit `--directory` is the user's
+ * own choice of location and is resolved against the working directory.
+ */
+export declare function resolveDestination(projectName: string, directory: string | undefined, cwd: string): string;
+export interface DestinationState {
+    /** True when the directory was already there, so it must never be removed. */
+    readonly existed: boolean;
+}
+/**
+ * Refuses to write into anything that already holds files. An empty directory
+ * is accepted, which is what a user who ran `mkdir` first will have.
+ */
+export declare function assertDestinationUsable(destination: string): Promise<DestinationState>;
+//# sourceMappingURL=destination.d.ts.map

package/dist/destination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination.d.ts","sourceRoot":"","sources":["../src/destination.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,MAAM,GACV,MAAM,CASR;AAED,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAoB3B"}

package/dist/destination.js

@@ -0,0 +1,39 @@
+import { readdir, stat } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+/**
+ * Entries that do not make a directory meaningfully occupied. A repository the
+ * user initialised before running the command should still be usable.
+ */
+const IGNORED_ENTRIES = new Set([".DS_Store", ".git"]);
+/**
+ * The project name is validated to be a single safe path segment, so the
+ * default destination cannot traverse. An explicit `--directory` is the user's
+ * own choice of location and is resolved against the working directory.
+ */
+export function resolveDestination(projectName, directory, cwd) {
+    if (directory === undefined)
+        return resolve(cwd, projectName);
+    const trimmed = directory.trim();
+    if (trimmed.length === 0) {
+        throw new Error("--directory needs a path, for example: --directory ./apps/my-app");
+    }
+    return isAbsolute(trimmed) ? resolve(trimmed) : resolve(cwd, trimmed);
+}
+/**
+ * Refuses to write into anything that already holds files. An empty directory
+ * is accepted, which is what a user who ran `mkdir` first will have.
+ */
+export async function assertDestinationUsable(destination) {
+    const entry = await stat(destination).catch(() => undefined);
+    if (!entry)
+        return { existed: false };
+    if (!entry.isDirectory()) {
+        throw new Error(`Cannot create a project at ${destination} because a file of that name already exists.`);
+    }
+    const contents = (await readdir(destination)).filter((name) => !IGNORED_ENTRIES.has(name));
+    if (contents.length > 0) {
+        throw new Error(`The directory ${destination} is not empty. Choose another name, pass --directory, or empty it first.`);
+    }
+    return { existed: true };
+}
+//# sourceMappingURL=destination.js.map

package/dist/destination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destination.js","sourceRoot":"","sources":["../src/destination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD;;;GAGG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,SAA6B,EAC7B,GAAW;IAEX,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAE9D,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAOD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,WAAmB;IAEnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAEtC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,8BAA8B,WAAW,8CAA8C,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAClD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CACrC,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,iBAAiB,WAAW,0EAA0E,CACvG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/dev-channel.d.ts

@@ -0,0 +1,40 @@
+/** Mirrors DEV_COMMAND in adjacent-core, which the CLI must not import. */
+export declare const DEV_COMMAND: {
+    readonly clearCache: "ADJACENT_DEV_CLEAR_CACHE";
+    readonly navigate: "ADJACENT_DEV_NAVIGATE";
+    readonly reload: "ADJACENT_DEV_RELOAD";
+};
+export type DevCommand = {
+    readonly type: typeof DEV_COMMAND.clearCache;
+} | {
+    readonly type: typeof DEV_COMMAND.reload;
+} | {
+    readonly path: string;
+    readonly type: typeof DEV_COMMAND.navigate;
+};
+export interface DevChannel {
+    readonly clientCount: () => number;
+    readonly publish: (command: DevCommand) => number;
+    readonly stop: () => Promise<void>;
+    readonly url: string;
+}
+export interface DevChannelState {
+    readonly channelUrl: string;
+    readonly origin: string;
+    readonly pid: number;
+    readonly port: number;
+}
+export declare function parseDevCommand(value: unknown): DevCommand | undefined;
+/**
+ * The Next.js server proxies exactly `/_adjacent/dev` here, so subscribing is
+ * reachable from the device while `/publish` is not: publishing stays local to
+ * the machine running the CLI.
+ */
+export declare function startDevChannel(): Promise<DevChannel>;
+export declare function stateFilePath(projectRoot: string): string;
+export declare function writeDevChannelState(projectRoot: string, state: DevChannelState): Promise<void>;
+export declare function clearDevChannelState(projectRoot: string): Promise<void>;
+export declare function isRunning(pid: number): boolean;
+export declare function readDevChannelState(projectRoot: string): Promise<DevChannelState>;
+export declare function sendDevCommand(projectRoot: string, command: DevCommand): Promise<number>;
+//# sourceMappingURL=dev-channel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-channel.d.ts","sourceRoot":"","sources":["../src/dev-channel.ts"],"names":[],"mappings":"AAIA,2EAA2E;AAC3E,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,WAAW,CAAC,UAAU,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,WAAW,CAAC,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,WAAW,CAAC,QAAQ,CAAA;CAAE,CAAC;AAE1E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,MAAM,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AA2CD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAqBtE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CA8E3D;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO9C;AAED,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA6B1B;AAED,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/dev-channel.js

@@ -0,0 +1,192 @@
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { createServer } from "node:http";
+import { join } from "node:path";
+/** Mirrors DEV_COMMAND in adjacent-core, which the CLI must not import. */
+export const DEV_COMMAND = {
+    clearCache: "ADJACENT_DEV_CLEAR_CACHE",
+    navigate: "ADJACENT_DEV_NAVIGATE",
+    reload: "ADJACENT_DEV_RELOAD",
+};
+const HOLD_MILLISECONDS = 20_000;
+const PUBLISH_PATH = "/publish";
+const STATE_FILE = join(".adjacent", "dev.json");
+function listen(server) {
+    return new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(0, "127.0.0.1", () => {
+            const address = server.address();
+            if (!address || typeof address === "string") {
+                reject(new Error("Could not allocate the Adjacent development channel."));
+                return;
+            }
+            resolve(address.port);
+        });
+    });
+}
+function close(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => (error ? reject(error) : resolve()));
+    });
+}
+async function readBody(request) {
+    const chunks = [];
+    for await (const chunk of request) {
+        chunks.push(chunk);
+        if (chunks.reduce((total, part) => total + part.length, 0) > 8_192) {
+            throw new Error("The development command is too large.");
+        }
+    }
+    return JSON.parse(Buffer.concat(chunks).toString() || "null");
+}
+export function parseDevCommand(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const command = value;
+    if (command.type === DEV_COMMAND.reload)
+        return { type: DEV_COMMAND.reload };
+    if (command.type === DEV_COMMAND.clearCache) {
+        return { type: DEV_COMMAND.clearCache };
+    }
+    if (command.type === DEV_COMMAND.navigate) {
+        const { path } = command;
+        if (typeof path !== "string" ||
+            !path.startsWith("/") ||
+            path[1] === "/" ||
+            path[1] === "\\") {
+            return undefined;
+        }
+        return { path, type: DEV_COMMAND.navigate };
+    }
+    return undefined;
+}
+/**
+ * The Next.js server proxies exactly `/_adjacent/dev` here, so subscribing is
+ * reachable from the device while `/publish` is not: publishing stays local to
+ * the machine running the CLI.
+ */
+export async function startDevChannel() {
+    const waiters = new Set();
+    const server = createServer((request, response) => {
+        const path = (request.url ?? "/").split("?")[0];
+        if (request.method === "POST" && path === PUBLISH_PATH) {
+            void readBody(request)
+                .then((body) => {
+                const command = parseDevCommand(body);
+                if (!command) {
+                    response.writeHead(400, { "content-type": "application/json" });
+                    response.end(JSON.stringify({ error: "Unknown development command." }));
+                    return;
+                }
+                const clients = publish(command);
+                response.writeHead(200, { "content-type": "application/json" });
+                response.end(JSON.stringify({ clients, ok: true }));
+            })
+                .catch((error) => {
+                response.writeHead(400, { "content-type": "application/json" });
+                response.end(JSON.stringify({
+                    error: error instanceof Error ? error.message : String(error),
+                }));
+            });
+            return;
+        }
+        if (request.method !== "GET" || path !== "/") {
+            response.writeHead(404, { "content-type": "application/json" });
+            response.end(JSON.stringify({ error: "Not found" }));
+            return;
+        }
+        const waiter = {
+            release(command) {
+                if (!waiters.delete(waiter))
+                    return;
+                clearTimeout(timer);
+                if (!command) {
+                    response.writeHead(204, { "cache-control": "no-store" });
+                    response.end();
+                    return;
+                }
+                response.writeHead(200, {
+                    "cache-control": "no-store",
+                    "content-type": "application/json",
+                });
+                response.end(JSON.stringify(command));
+            },
+        };
+        const timer = setTimeout(() => waiter.release(undefined), HOLD_MILLISECONDS);
+        request.once("close", () => {
+            if (!waiters.delete(waiter))
+                return;
+            clearTimeout(timer);
+        });
+        waiters.add(waiter);
+    });
+    function publish(command) {
+        const pending = [...waiters];
+        pending.forEach((waiter) => waiter.release(command));
+        return pending.length;
+    }
+    const port = await listen(server);
+    return {
+        clientCount: () => waiters.size,
+        publish,
+        async stop() {
+            [...waiters].forEach((waiter) => waiter.release(undefined));
+            await close(server);
+        },
+        url: `http://127.0.0.1:${port}`,
+    };
+}
+export function stateFilePath(projectRoot) {
+    return join(projectRoot, STATE_FILE);
+}
+export async function writeDevChannelState(projectRoot, state) {
+    const path = stateFilePath(projectRoot);
+    await mkdir(join(projectRoot, ".adjacent"), { recursive: true });
+    await writeFile(path, `${JSON.stringify(state, null, 2)}\n`);
+}
+export async function clearDevChannelState(projectRoot) {
+    await rm(stateFilePath(projectRoot), { force: true });
+}
+export function isRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function readDevChannelState(projectRoot) {
+    const raw = await readFile(stateFilePath(projectRoot), "utf8").catch(() => undefined);
+    if (raw === undefined) {
+        throw new Error(`No Adjacent development server is running in ${projectRoot}. Start one with: adj dev --android`);
+    }
+    const state = JSON.parse(raw);
+    if (typeof state.channelUrl !== "string" ||
+        typeof state.origin !== "string" ||
+        typeof state.pid !== "number" ||
+        typeof state.port !== "number") {
+        throw new Error(`The Adjacent development state at ${stateFilePath(projectRoot)} is unreadable. Restart: adj dev --android`);
+    }
+    if (!isRunning(state.pid)) {
+        await clearDevChannelState(projectRoot);
+        throw new Error(`The Adjacent development server for ${projectRoot} is no longer running. Start one with: adj dev --android`);
+    }
+    return state;
+}
+export async function sendDevCommand(projectRoot, command) {
+    const state = await readDevChannelState(projectRoot);
+    const response = await fetch(`${state.channelUrl}${PUBLISH_PATH}`, {
+        body: JSON.stringify(command),
+        headers: { "content-type": "application/json" },
+        method: "POST",
+    }).catch(() => {
+        throw new Error(`Could not reach the Adjacent development server at ${state.channelUrl}.`);
+    });
+    if (!response.ok) {
+        const detail = (await response.json().catch(() => ({})));
+        throw new Error(detail.error ?? `The development server replied HTTP ${response.status}.`);
+    }
+    const { clients } = (await response.json());
+    return clients;
+}
+//# sourceMappingURL=dev-channel.js.map

package/dist/dev-channel.js.map

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

package/dist/dev.d.ts

@@ -0,0 +1,3 @@
+import { type DevCommand } from "./dev-channel.js";
+export declare function runDevCommand(projectRoot: string, command: DevCommand): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnE,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAOf"}