@geekmidas/cli 10.0.0-alpha.12 → 10.0.0-alpha.121

package/dist/eas-iT2JDHCh.mjs

@@ -0,0 +1,334 @@
+import { t as GkmError } from "./errors-D8Gwp5kU.mjs";
+import { t as appKey } from "./derive-B4vDpzgP.mjs";
+import { i as easWorkflowPath, n as mobileStage, r as easWorkflow } from "./index.mjs";
+import { t as loadStage } from "./stage-BvM_u2z4.mjs";
+import { delimiter, dirname, join } from "node:path";
+import { existsSync } from "node:fs";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { spawn } from "node:child_process";
+//#region src/mobile/eas.ts
+/**
+* `gkm eas:sync --stage <stage>`: a mobile app's EAS project set up for a
+* deployed stage, from what the workspace declares — so a store build, which
+* EAS runs on its own machines, outside gkm, is built with the same values
+* the stage's servers were deployed with.
+*
+* - **`eas.json`**: the stage's build profile (`build.<stage>`) reads its EAS
+*   environment and listens on its channel; its submit profile
+*   (`submit.<stage>.android`) has its Play track and release status — see
+*   `mobileStage`. Every other field is left as it is.
+* - **The EAS environment**: each value the app's build reads for the stage
+*   (`StackMobileApp.values`) — its scheme, its edges' public URLs under
+*   `EXPO_PUBLIC_`, and every stage secret already named so — set with
+*   `eas env:set`, as `plaintext`: a bundle inlines them, so none is secret.
+*   Nothing else is written: no server key reaches EAS.
+*/
+const logger = console;
+/** The workspace declares no `MobileApp`: nothing to set up. */
+var NoMobileApp = class extends GkmError {
+	constructor() {
+		super("The workspace declares no MobileApp, so there is no EAS project to set up. Declare one: new MobileApp('App', { path: 'apps/app' }).dependsOn([api, auth]).");
+		this.name = "NoMobileApp";
+	}
+};
+/** Several `MobileApp`s, and nothing to say which. */
+var MobileAppNotChosen = class extends GkmError {
+	apps;
+	constructor(apps) {
+		super(`The workspace declares ${apps.length} mobile apps (${apps.join(", ")}). Run from one's directory, or name it: --app ${apps[0]}.`);
+		this.apps = apps;
+		this.name = "MobileAppNotChosen";
+	}
+};
+/** `--app` names no `MobileApp`. */
+var MobileAppUnknown = class extends GkmError {
+	app;
+	apps;
+	constructor(app, apps) {
+		super(`'${app}' is not one of the workspace's mobile apps (${apps.join(", ")}).`);
+		this.app = app;
+		this.apps = apps;
+		this.name = "MobileAppUnknown";
+	}
+};
+/** `eas` is not installed where the app is. */
+var EasCliMissing = class extends GkmError {
+	dir;
+	constructor(dir) {
+		super(`No \`eas\` to run in ${dir}. Add it to the app: pnpm add -D eas-cli (or install it globally: npm install -g eas-cli).`);
+		this.dir = dir;
+		this.name = "EasCliMissing";
+	}
+};
+/** `eas` refused a command. */
+var EasCommandFailed = class extends GkmError {
+	command;
+	code;
+	stderr;
+	constructor(command, code, stderr) {
+		super(`\`eas ${command}\` failed (exit ${code}): ${stderr.trim() || "it said nothing"}. In CI, EXPO_TOKEN must be set; on this machine, \`eas login\`.`);
+		this.command = command;
+		this.code = code;
+		this.stderr = stderr;
+		this.name = "EasCommandFailed";
+	}
+};
+/**
+* Run `eas` in `dir`: the app's own, else the workspace's, else the one on
+* PATH. What it prints on stdout is answered; a failure is
+* {@link EasCommandFailed} with what it said.
+*/
+function runEas(root, dir, args, options = {}) {
+	return new Promise((resolve, reject) => {
+		const child = spawn("eas", [...args, "--non-interactive"], {
+			cwd: dir,
+			stdio: [
+				"ignore",
+				options.inherit ? "inherit" : "pipe",
+				"pipe"
+			],
+			env: {
+				...process.env,
+				...options.env,
+				PATH: [
+					join(dir, "node_modules", ".bin"),
+					join(root, "node_modules", ".bin"),
+					process.env.PATH
+				].join(delimiter)
+			}
+		});
+		let stdout = "";
+		let stderr = "";
+		child.stdout?.on("data", (chunk) => {
+			stdout += chunk.toString();
+		});
+		child.stderr?.on("data", (chunk) => {
+			stderr += chunk.toString();
+			if (options.inherit) process.stderr.write(chunk);
+		});
+		const command = args.slice(0, 3).join(" ");
+		child.on("error", (error) => reject(error.code === "ENOENT" ? new EasCliMissing(dir) : new EasCommandFailed(command, null, error.message)));
+		child.on("close", (code) => code === 0 ? resolve(stdout) : reject(new EasCommandFailed(command, code, stderr)));
+	});
+}
+/** The JSON `eas … --json` printed, read for `what`. */
+function easJson(output, what) {
+	try {
+		return JSON.parse(output);
+	} catch {
+		throw new EasCommandFailed(what, 0, `not JSON: ${output.slice(0, 200)}`);
+	}
+}
+/**
+* The real one — never a prompt (`--non-interactive`). `env` is what the
+* app's `app.config.ts` reads for the stage: every `eas` command evaluates
+* it, and one that reads a value it lacks fails before it starts — and a
+* fingerprint computed here must match the one EAS computes with the
+* stage's values.
+*/
+function easCli(root, env = {}) {
+	const run = (dir, args, options = {}) => runEas(root, dir, args, {
+		...options,
+		env
+	});
+	return {
+		async setEnv(dir, { environment, name, value }) {
+			await run(dir, [
+				"env:set",
+				"--environment",
+				environment,
+				"--name",
+				name,
+				"--value",
+				value,
+				"--visibility",
+				"plaintext",
+				"--scope",
+				"project"
+			]);
+		},
+		async fingerprint(dir, { platform, profile }) {
+			const hash = easJson(await run(dir, [
+				"fingerprint:generate",
+				"--platform",
+				platform,
+				"--build-profile",
+				profile,
+				"--json"
+			]), "fingerprint:generate").hash;
+			if (typeof hash !== "string") throw new EasCommandFailed("fingerprint:generate", 0, "no hash");
+			return hash;
+		},
+		async storeBuild(dir, { platform, profile, fingerprint }) {
+			const builds = easJson(await run(dir, [
+				"build:list",
+				"--platform",
+				platform,
+				"--build-profile",
+				profile,
+				"--fingerprint-hash",
+				fingerprint,
+				"--status",
+				"finished",
+				"--distribution",
+				"store",
+				"--limit",
+				"1",
+				"--json"
+			]), "build:list");
+			if (!Array.isArray(builds)) return void 0;
+			const id = builds[0]?.id;
+			return typeof id === "string" ? id : void 0;
+		},
+		async build(dir, { platform, profile, submit, wait }) {
+			await run(dir, [
+				"build",
+				"--platform",
+				platform,
+				"--profile",
+				profile,
+				...submit ? ["--auto-submit"] : [],
+				...wait ? [] : ["--no-wait"]
+			], { inherit: true });
+		},
+		async update(dir, { platform, channel, environment, message }) {
+			await run(dir, [
+				"update",
+				"--platform",
+				platform,
+				"--channel",
+				channel,
+				"--environment",
+				environment,
+				"--message",
+				message
+			], { inherit: true });
+		}
+	};
+}
+/**
+* The mobile app a command is about: the one `--app` names, else the one
+* this directory is, else the only one.
+*
+* @throws {NoMobileApp}, {MobileAppNotChosen}, {MobileAppUnknown}
+*/
+function chooseMobileApp(manifest, app, here) {
+	const declarations = Object.values(manifest).filter((declaration) => declaration.kind === "mobile-app");
+	const names = declarations.map((declaration) => appKey(declaration.id));
+	if (declarations.length === 0) throw new NoMobileApp();
+	const name = app ?? (here && names.includes(here) ? here : names.length === 1 ? names[0] : void 0);
+	if (!name) throw new MobileAppNotChosen(names);
+	const declaration = declarations.find((d) => appKey(d.id) === name);
+	if (!declaration) throw new MobileAppUnknown(name, names);
+	return declaration;
+}
+/**
+* `eas.json` with the stage's build and submit profiles as `stage` says:
+* every field gkm does not decide is kept.
+*/
+function withStageProfiles(easJson, stage) {
+	const build = easJson.build?.[stage.stage] ?? {};
+	const submit = easJson.submit?.[stage.stage] ?? {};
+	const android = submit.android ?? {};
+	return {
+		...easJson,
+		build: {
+			...easJson.build,
+			[stage.stage]: {
+				...build,
+				environment: stage.environment,
+				channel: stage.channel
+			}
+		},
+		submit: {
+			...easJson.submit,
+			[stage.stage]: {
+				...submit,
+				android: {
+					...android,
+					track: stage.android.track,
+					releaseStatus: stage.android.releaseStatus
+				}
+			}
+		}
+	};
+}
+/**
+* Set up a mobile app's EAS project for a deployed stage.
+*
+* @throws {NoMobileApp}, {MobileAppNotChosen}, {MobileAppUnknown},
+*   {MobileAppStageUndeclared}, {EasCliMissing}, {EasCommandFailed} — and
+*   what loading the stage throws: {UndeclaredStage}, {ExecStageNotComposed},
+*   {ExecStageNotDeployed}
+*/
+async function easSync(options, eas) {
+	const loaded = await loadStage(options);
+	const { workspace, manifest, stack } = loaded;
+	const declaration = chooseMobileApp(manifest, options.app, loaded.appName);
+	const name = appKey(declaration.id);
+	const stage = mobileStage(workspace, declaration, options.stage);
+	const values = stack.mobileApps.find((candidate) => candidate.name === name)?.values ?? {};
+	const dir = join(workspace.root, declaration.app.path);
+	const path = join(dir, "eas.json");
+	const before = existsSync(path) ? JSON.parse(await readFile(path, "utf8")) : {};
+	const after = withStageProfiles(before, stage);
+	const easJsonChanged = JSON.stringify(before) !== JSON.stringify(after);
+	const workflowPath = easWorkflowPath(stage.stage);
+	const workflowFile = join(dir, workflowPath);
+	const workflowYaml = easWorkflow(stage, {
+		release: workspace.stages.protected?.includes(stage.stage) ?? false,
+		iosSubmits: Boolean((after.submit?.[stage.stage]?.ios)?.ascAppId)
+	});
+	const workflow = {
+		path: workflowPath,
+		changed: !existsSync(workflowFile) || await readFile(workflowFile, "utf8") !== workflowYaml
+	};
+	const where = `${name} on '${stage.stage}': EAS environment '${stage.environment}', channel '${stage.channel}', Play track '${stage.android.track}' (${stage.android.releaseStatus})`;
+	if (options.dryRun) {
+		logger.log(`📱 ${where} (dry run)`);
+		if (easJsonChanged) logger.log(`   would write build.${stage.stage} and submit.${stage.stage} in ${path}`);
+		if (workflow.changed) logger.log(`   would write ${workflowFile}`);
+		for (const [key, value] of Object.entries(values)) logger.log(`   would set ${key}=${value}`);
+		return {
+			app: name,
+			root: workspace.root,
+			dir,
+			stage,
+			values,
+			easJsonChanged,
+			workflow
+		};
+	}
+	logger.log(`📱 ${where}`);
+	if (easJsonChanged) {
+		await writeFile(path, `${JSON.stringify(after, null, 2)}\n`);
+		logger.log(`   wrote build.${stage.stage} and submit.${stage.stage} in ${path}`);
+	}
+	if (workflow.changed) {
+		await mkdir(dirname(workflowFile), { recursive: true });
+		await writeFile(workflowFile, workflowYaml);
+		logger.log(`   wrote ${workflowFile}`);
+	}
+	const cli = eas ?? easCli(workspace.root, values);
+	for (const [key, value] of Object.entries(values)) {
+		await cli.setEnv(dir, {
+			environment: stage.environment,
+			name: key,
+			value
+		});
+		logger.log(`   set ${key}`);
+	}
+	return {
+		app: name,
+		root: workspace.root,
+		dir,
+		stage,
+		values,
+		easJsonChanged,
+		workflow
+	};
+}
+//#endregion
+export { chooseMobileApp, easCli, easSync, withStageProfiles };
+
+//# sourceMappingURL=eas-iT2JDHCh.mjs.map

package/dist/eas-iT2JDHCh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eas-iT2JDHCh.mjs","names":[],"sources":["../src/mobile/eas.ts"],"sourcesContent":["/**\n * `gkm eas:sync --stage <stage>`: a mobile app's EAS project set up for a\n * deployed stage, from what the workspace declares — so a store build, which\n * EAS runs on its own machines, outside gkm, is built with the same values\n * the stage's servers were deployed with.\n *\n * - **`eas.json`**: the stage's build profile (`build.<stage>`) reads its EAS\n *   environment and listens on its channel; its submit profile\n *   (`submit.<stage>.android`) has its Play track and release status — see\n *   `mobileStage`. Every other field is left as it is.\n * - **The EAS environment**: each value the app's build reads for the stage\n *   (`StackMobileApp.values`) — its scheme, its edges' public URLs under\n *   `EXPO_PUBLIC_`, and every stage secret already named so — set with\n *   `eas env:set`, as `plaintext`: a bundle inlines them, so none is secret.\n *   Nothing else is written: no server key reaches EAS.\n */\n\nimport { spawn } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { delimiter, dirname, join } from 'node:path';\nimport type {\n\tConstructManifest,\n\tMobileAppDeclaration,\n} from '@geekmidas/manifest';\nimport { GkmError } from '../errors';\nimport { loadStage } from '../exec/stage.js';\nimport { appKey } from '../workspace/derive.js';\nimport { easWorkflow, easWorkflowPath } from './easWorkflow.js';\nimport { type MobileStage, mobileStage } from './stage.js';\n\nconst logger = console;\n\n/** The workspace declares no `MobileApp`: nothing to set up. */\nexport class NoMobileApp extends GkmError {\n\tconstructor() {\n\t\tsuper(\n\t\t\t'The workspace declares no MobileApp, so there is no EAS project to set ' +\n\t\t\t\t\"up. Declare one: new MobileApp('App', { path: 'apps/app' }).dependsOn([api, auth]).\",\n\t\t);\n\t\tthis.name = 'NoMobileApp';\n\t}\n}\n\n/** Several `MobileApp`s, and nothing to say which. */\nexport class MobileAppNotChosen extends GkmError {\n\tconstructor(readonly apps: readonly string[]) {\n\t\tsuper(\n\t\t\t`The workspace declares ${apps.length} mobile apps (${apps.join(', ')}). ` +\n\t\t\t\t`Run from one's directory, or name it: --app ${apps[0]}.`,\n\t\t);\n\t\tthis.name = 'MobileAppNotChosen';\n\t}\n}\n\n/** `--app` names no `MobileApp`. */\nexport class MobileAppUnknown extends GkmError {\n\tconstructor(\n\t\treadonly app: string,\n\t\treadonly apps: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`'${app}' is not one of the workspace's mobile apps (${apps.join(', ')}).`,\n\t\t);\n\t\tthis.name = 'MobileAppUnknown';\n\t}\n}\n\n/** `eas` is not installed where the app is. */\nexport class EasCliMissing extends GkmError {\n\tconstructor(readonly dir: string) {\n\t\tsuper(\n\t\t\t`No \\`eas\\` to run in ${dir}. Add it to the app: pnpm add -D eas-cli ` +\n\t\t\t\t'(or install it globally: npm install -g eas-cli).',\n\t\t);\n\t\tthis.name = 'EasCliMissing';\n\t}\n}\n\n/** `eas` refused a command. */\nexport class EasCommandFailed extends GkmError {\n\tconstructor(\n\t\treadonly command: string,\n\t\treadonly code: number | null,\n\t\treadonly stderr: string,\n\t) {\n\t\tsuper(\n\t\t\t`\\`eas ${command}\\` failed (exit ${code}): ${stderr.trim() || 'it said nothing'}. ` +\n\t\t\t\t'In CI, EXPO_TOKEN must be set; on this machine, `eas login`.',\n\t\t);\n\t\tthis.name = 'EasCommandFailed';\n\t}\n}\n\n/** A platform EAS builds for. */\nexport type EasPlatform = 'ios' | 'android';\n\n/** What gkm asks of EAS, so tests can stand in. */\nexport interface EasCli {\n\t/** Create or update a variable in one of the project's environments. */\n\tsetEnv(\n\t\tdir: string,\n\t\tvariable: { environment: string; name: string; value: string },\n\t): Promise<void>;\n\t/**\n\t * The fingerprint of the app's native code, as a build with `profile`\n\t * would compute it — what its runtime version is.\n\t */\n\tfingerprint(\n\t\tdir: string,\n\t\toptions: { platform: EasPlatform; profile: string },\n\t): Promise<string>;\n\t/** A finished store build of `profile` with that fingerprint, if any. */\n\tstoreBuild(\n\t\tdir: string,\n\t\toptions: { platform: EasPlatform; profile: string; fingerprint: string },\n\t): Promise<string | undefined>;\n\t/** Start a store build of `profile`, submitted to the store when asked. */\n\tbuild(\n\t\tdir: string,\n\t\toptions: {\n\t\t\tplatform: EasPlatform;\n\t\t\tprofile: string;\n\t\t\tsubmit: boolean;\n\t\t\twait: boolean;\n\t\t},\n\t): Promise<void>;\n\t/** Publish an update of the app's JavaScript on a channel. */\n\tupdate(\n\t\tdir: string,\n\t\toptions: {\n\t\t\tplatform: EasPlatform;\n\t\t\tchannel: string;\n\t\t\tenvironment: string;\n\t\t\tmessage: string;\n\t\t},\n\t): Promise<void>;\n}\n\n/**\n * Run `eas` in `dir`: the app's own, else the workspace's, else the one on\n * PATH. What it prints on stdout is answered; a failure is\n * {@link EasCommandFailed} with what it said.\n */\nfunction runEas(\n\troot: string,\n\tdir: string,\n\targs: readonly string[],\n\toptions: { inherit?: boolean; env?: Readonly<Record<string, string>> } = {},\n): Promise<string> {\n\treturn new Promise((resolve, reject) => {\n\t\tconst child = spawn('eas', [...args, '--non-interactive'], {\n\t\t\tcwd: dir,\n\t\t\t// A build's or an update's progress is the user's to read.\n\t\t\tstdio: ['ignore', options.inherit ? 'inherit' : 'pipe', 'pipe'],\n\t\t\tenv: {\n\t\t\t\t...process.env,\n\t\t\t\t...options.env,\n\t\t\t\tPATH: [\n\t\t\t\t\tjoin(dir, 'node_modules', '.bin'),\n\t\t\t\t\tjoin(root, 'node_modules', '.bin'),\n\t\t\t\t\tprocess.env.PATH,\n\t\t\t\t].join(delimiter),\n\t\t\t},\n\t\t});\n\t\tlet stdout = '';\n\t\tlet stderr = '';\n\t\tchild.stdout?.on('data', (chunk: Buffer) => {\n\t\t\tstdout += chunk.toString();\n\t\t});\n\t\tchild.stderr?.on('data', (chunk: Buffer) => {\n\t\t\tstderr += chunk.toString();\n\t\t\tif (options.inherit) process.stderr.write(chunk);\n\t\t});\n\t\tconst command = args.slice(0, 3).join(' ');\n\t\tchild.on('error', (error: NodeJS.ErrnoException) =>\n\t\t\treject(\n\t\t\t\terror.code === 'ENOENT'\n\t\t\t\t\t? new EasCliMissing(dir)\n\t\t\t\t\t: new EasCommandFailed(command, null, error.message),\n\t\t\t),\n\t\t);\n\t\tchild.on('close', (code) =>\n\t\t\tcode === 0\n\t\t\t\t? resolve(stdout)\n\t\t\t\t: reject(new EasCommandFailed(command, code, stderr)),\n\t\t);\n\t});\n}\n\n/** The JSON `eas … --json` printed, read for `what`. */\nfunction easJson(output: string, what: string): unknown {\n\ttry {\n\t\treturn JSON.parse(output);\n\t} catch {\n\t\tthrow new EasCommandFailed(what, 0, `not JSON: ${output.slice(0, 200)}`);\n\t}\n}\n\n/**\n * The real one — never a prompt (`--non-interactive`). `env` is what the\n * app's `app.config.ts` reads for the stage: every `eas` command evaluates\n * it, and one that reads a value it lacks fails before it starts — and a\n * fingerprint computed here must match the one EAS computes with the\n * stage's values.\n */\nexport function easCli(\n\troot: string,\n\tenv: Readonly<Record<string, string>> = {},\n): EasCli {\n\tconst run = (\n\t\tdir: string,\n\t\targs: readonly string[],\n\t\toptions: { inherit?: boolean } = {},\n\t) => runEas(root, dir, args, { ...options, env });\n\treturn {\n\t\tasync setEnv(dir, { environment, name, value }) {\n\t\t\tawait run(dir, [\n\t\t\t\t'env:set',\n\t\t\t\t'--environment',\n\t\t\t\tenvironment,\n\t\t\t\t'--name',\n\t\t\t\tname,\n\t\t\t\t'--value',\n\t\t\t\tvalue,\n\t\t\t\t'--visibility',\n\t\t\t\t'plaintext',\n\t\t\t\t'--scope',\n\t\t\t\t'project',\n\t\t\t]);\n\t\t},\n\n\t\tasync fingerprint(dir, { platform, profile }) {\n\t\t\tconst output = await run(dir, [\n\t\t\t\t'fingerprint:generate',\n\t\t\t\t'--platform',\n\t\t\t\tplatform,\n\t\t\t\t'--build-profile',\n\t\t\t\tprofile,\n\t\t\t\t'--json',\n\t\t\t]);\n\t\t\tconst hash = (\n\t\t\t\teasJson(output, 'fingerprint:generate') as { hash?: unknown }\n\t\t\t).hash;\n\t\t\tif (typeof hash !== 'string') {\n\t\t\t\tthrow new EasCommandFailed('fingerprint:generate', 0, 'no hash');\n\t\t\t}\n\t\t\treturn hash;\n\t\t},\n\n\t\tasync storeBuild(dir, { platform, profile, fingerprint }) {\n\t\t\tconst output = await run(dir, [\n\t\t\t\t'build:list',\n\t\t\t\t'--platform',\n\t\t\t\tplatform,\n\t\t\t\t'--build-profile',\n\t\t\t\tprofile,\n\t\t\t\t'--fingerprint-hash',\n\t\t\t\tfingerprint,\n\t\t\t\t'--status',\n\t\t\t\t'finished',\n\t\t\t\t'--distribution',\n\t\t\t\t'store',\n\t\t\t\t'--limit',\n\t\t\t\t'1',\n\t\t\t\t'--json',\n\t\t\t]);\n\t\t\tconst builds = easJson(output, 'build:list');\n\t\t\tif (!Array.isArray(builds)) return undefined;\n\t\t\tconst id = (builds[0] as { id?: unknown } | undefined)?.id;\n\t\t\treturn typeof id === 'string' ? id : undefined;\n\t\t},\n\n\t\tasync build(dir, { platform, profile, submit, wait }) {\n\t\t\tawait run(\n\t\t\t\tdir,\n\t\t\t\t[\n\t\t\t\t\t'build',\n\t\t\t\t\t'--platform',\n\t\t\t\t\tplatform,\n\t\t\t\t\t'--profile',\n\t\t\t\t\tprofile,\n\t\t\t\t\t...(submit ? ['--auto-submit'] : []),\n\t\t\t\t\t...(wait ? [] : ['--no-wait']),\n\t\t\t\t],\n\t\t\t\t{ inherit: true },\n\t\t\t);\n\t\t},\n\n\t\tasync update(dir, { platform, channel, environment, message }) {\n\t\t\tawait run(\n\t\t\t\tdir,\n\t\t\t\t[\n\t\t\t\t\t'update',\n\t\t\t\t\t'--platform',\n\t\t\t\t\tplatform,\n\t\t\t\t\t'--channel',\n\t\t\t\t\tchannel,\n\t\t\t\t\t'--environment',\n\t\t\t\t\tenvironment,\n\t\t\t\t\t'--message',\n\t\t\t\t\tmessage,\n\t\t\t\t],\n\t\t\t\t{ inherit: true },\n\t\t\t);\n\t\t},\n\t};\n}\n\n/**\n * The mobile app a command is about: the one `--app` names, else the one\n * this directory is, else the only one.\n *\n * @throws {NoMobileApp}, {MobileAppNotChosen}, {MobileAppUnknown}\n */\nexport function chooseMobileApp(\n\tmanifest: ConstructManifest,\n\tapp: string | undefined,\n\there: string | undefined,\n): MobileAppDeclaration {\n\tconst declarations = Object.values(manifest).filter(\n\t\t(declaration): declaration is MobileAppDeclaration =>\n\t\t\tdeclaration.kind === 'mobile-app',\n\t);\n\tconst names = declarations.map((declaration) => appKey(declaration.id));\n\tif (declarations.length === 0) throw new NoMobileApp();\n\tconst name =\n\t\tapp ??\n\t\t(here && names.includes(here)\n\t\t\t? here\n\t\t\t: names.length === 1\n\t\t\t\t? names[0]\n\t\t\t\t: undefined);\n\tif (!name) throw new MobileAppNotChosen(names);\n\tconst declaration = declarations.find((d) => appKey(d.id) === name);\n\tif (!declaration) throw new MobileAppUnknown(name, names);\n\treturn declaration;\n}\n\n/** `eas.json`, as far as gkm writes it. */\ninterface EasJson {\n\tbuild?: Record<string, Record<string, unknown>>;\n\tsubmit?: Record<string, Record<string, unknown>>;\n\t[key: string]: unknown;\n}\n\n/**\n * `eas.json` with the stage's build and submit profiles as `stage` says:\n * every field gkm does not decide is kept.\n */\nexport function withStageProfiles(\n\teasJson: EasJson,\n\tstage: MobileStage,\n): EasJson {\n\tconst build = easJson.build?.[stage.stage] ?? {};\n\tconst submit = easJson.submit?.[stage.stage] ?? {};\n\tconst android = (submit.android as Record<string, unknown> | undefined) ?? {};\n\treturn {\n\t\t...easJson,\n\t\tbuild: {\n\t\t\t...easJson.build,\n\t\t\t[stage.stage]: {\n\t\t\t\t...build,\n\t\t\t\tenvironment: stage.environment,\n\t\t\t\tchannel: stage.channel,\n\t\t\t},\n\t\t},\n\t\tsubmit: {\n\t\t\t...easJson.submit,\n\t\t\t[stage.stage]: {\n\t\t\t\t...submit,\n\t\t\t\tandroid: {\n\t\t\t\t\t...android,\n\t\t\t\t\ttrack: stage.android.track,\n\t\t\t\t\treleaseStatus: stage.android.releaseStatus,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t};\n}\n\nexport interface EasSyncOptions {\n\tstage: string;\n\t/** The mobile app, by its app key; the one here, or the only one, if not. */\n\tapp?: string;\n\t/** The AWS profile for the stage's account, where its secrets are kept. */\n\tprofile?: string;\n\tcwd?: string;\n\t/** Say what would be written, and write nothing. */\n\tdryRun?: boolean;\n}\n\n/** What a sync wrote — or, dry, would. */\nexport interface EasSyncResult {\n\tapp: string;\n\t/** The workspace's root, where its `eas` may be installed. */\n\troot: string;\n\tdir: string;\n\tstage: MobileStage;\n\tvalues: Record<string, string>;\n\t/** Whether `eas.json` changed. */\n\teasJsonChanged: boolean;\n\t/** The stage's EAS workflow, relative to the app, and whether it changed. */\n\tworkflow: { path: string; changed: boolean };\n}\n\n/**\n * Set up a mobile app's EAS project for a deployed stage.\n *\n * @throws {NoMobileApp}, {MobileAppNotChosen}, {MobileAppUnknown},\n *   {MobileAppStageUndeclared}, {EasCliMissing}, {EasCommandFailed} — and\n *   what loading the stage throws: {UndeclaredStage}, {ExecStageNotComposed},\n *   {ExecStageNotDeployed}\n */\nexport async function easSync(\n\toptions: EasSyncOptions,\n\teas?: EasCli,\n): Promise<EasSyncResult> {\n\tconst loaded = await loadStage(options);\n\tconst { workspace, manifest, stack } = loaded;\n\n\tconst declaration = chooseMobileApp(manifest, options.app, loaded.appName);\n\tconst name = appKey(declaration.id);\n\n\tconst stage = mobileStage(workspace, declaration, options.stage);\n\tconst values =\n\t\tstack.mobileApps.find((candidate) => candidate.name === name)?.values ?? {};\n\tconst dir = join(workspace.root, declaration.app.path);\n\n\tconst path = join(dir, 'eas.json');\n\tconst before = existsSync(path)\n\t\t? (JSON.parse(await readFile(path, 'utf8')) as EasJson)\n\t\t: {};\n\tconst after = withStageProfiles(before, stage);\n\tconst easJsonChanged = JSON.stringify(before) !== JSON.stringify(after);\n\n\tconst workflowPath = easWorkflowPath(stage.stage);\n\tconst workflowFile = join(dir, workflowPath);\n\tconst workflowYaml = easWorkflow(stage, {\n\t\trelease: workspace.stages.protected?.includes(stage.stage) ?? false,\n\t\tiosSubmits: Boolean(\n\t\t\t(after.submit?.[stage.stage]?.ios as { ascAppId?: string } | undefined)\n\t\t\t\t?.ascAppId,\n\t\t),\n\t});\n\tconst workflow = {\n\t\tpath: workflowPath,\n\t\tchanged:\n\t\t\t!existsSync(workflowFile) ||\n\t\t\t(await readFile(workflowFile, 'utf8')) !== workflowYaml,\n\t};\n\n\tconst where = `${name} on '${stage.stage}': EAS environment '${stage.environment}', channel '${stage.channel}', Play track '${stage.android.track}' (${stage.android.releaseStatus})`;\n\tif (options.dryRun) {\n\t\tlogger.log(`📱 ${where} (dry run)`);\n\t\tif (easJsonChanged) {\n\t\t\tlogger.log(\n\t\t\t\t`   would write build.${stage.stage} and submit.${stage.stage} in ${path}`,\n\t\t\t);\n\t\t}\n\t\tif (workflow.changed) logger.log(`   would write ${workflowFile}`);\n\t\tfor (const [key, value] of Object.entries(values)) {\n\t\t\tlogger.log(`   would set ${key}=${value}`);\n\t\t}\n\t\treturn {\n\t\t\tapp: name,\n\t\t\troot: workspace.root,\n\t\t\tdir,\n\t\t\tstage,\n\t\t\tvalues,\n\t\t\teasJsonChanged,\n\t\t\tworkflow,\n\t\t};\n\t}\n\n\tlogger.log(`📱 ${where}`);\n\tif (easJsonChanged) {\n\t\tawait writeFile(path, `${JSON.stringify(after, null, 2)}\\n`);\n\t\tlogger.log(\n\t\t\t`   wrote build.${stage.stage} and submit.${stage.stage} in ${path}`,\n\t\t);\n\t}\n\tif (workflow.changed) {\n\t\tawait mkdir(dirname(workflowFile), { recursive: true });\n\t\tawait writeFile(workflowFile, workflowYaml);\n\t\tlogger.log(`   wrote ${workflowFile}`);\n\t}\n\tconst cli = eas ?? easCli(workspace.root, values);\n\tfor (const [key, value] of Object.entries(values)) {\n\t\tawait cli.setEnv(dir, { environment: stage.environment, name: key, value });\n\t\tlogger.log(`   set ${key}`);\n\t}\n\treturn {\n\t\tapp: name,\n\t\troot: workspace.root,\n\t\tdir,\n\t\tstage,\n\t\tvalues,\n\t\teasJsonChanged,\n\t\tworkflow,\n\t};\n}\n"],"mappings":"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"}

package/dist/{emit-CIlvnDvV.mjs → emit-C1e8qD08.mjs}

@@ -1,10 +1,5 @@
-import { dirname, join } from "node:path";
 import { canonicalId, provideKey } from "@geekmidas/manifest";
-import { mkdir, writeFile } from "node:fs/promises";
-
 //#region src/reconcile/emit.ts
-/** Where the build writes it, relative to the app root. */
-const MANIFEST_PATH = ".gkm/manifest.ts";
 /**
 * Fold the build's generated routes into the surface that serves them.
 *
@@ -19,11 +14,10 @@ const MANIFEST_PATH = ".gkm/manifest.ts";
 * already knows where it wrote each handler. Asking the declaration to restate
 * any of that is how the two come to disagree.
 *
-* Attribution is by exclusion — routes go to the surface that declared none of
-* its own. A surface with static endpoints (an auth server's single wildcard)
-* keeps them. That is exact while an app has one API of its own, and needs a
-* real answer the day it has two; the alternative today would be inventing one
-* before anything needs it.
+* Attribution is to the surface the build served — the one whose `path` is
+* the app being built. Without one, routes go to the surface that declared none
+* of its own; a surface with static endpoints (an auth server's single
+* wildcard) keeps them.
 *
 * **Only from a provider that generates one handler per route.** The `server`
 * provider generates a single catch-all — `ALL *` pointing at the Hono app that
@@ -35,7 +29,7 @@ const MANIFEST_PATH = ".gkm/manifest.ts";
 */
 function withRoutes(manifest, routes, options) {
 	if (routes.length === 0 || !options.perRoute) return manifest;
-	const target = Object.entries(manifest).find(([, declaration$1]) => declaration$1.kind === "rest-api" && declaration$1.endpoints.length === 0);
+	const target = Object.entries(manifest).find(([id, declaration]) => options.surface ? id === options.surface : declaration.kind === "rest-api" && declaration.endpoints.length === 0);
 	if (!target) return manifest;
 	const [id, declaration] = target;
 	if (declaration.kind !== "rest-api") return manifest;
@@ -144,7 +138,7 @@ function asEndpoint(manifest, surface, route) {
 */
 function manifestModule(manifest, backends = {}) {
 	return `${HEADER}
-export const manifest = ${serialise(manifest)} as const satisfies ConstructManifest;
+export const constructs = ${serialise(manifest)} as const satisfies ConstructManifest;
 
 /**
  * Where the backends that are *config* rather than declaration resolved to.
@@ -158,24 +152,17 @@ export const manifest = ${serialise(manifest)} as const satisfies ConstructManif
 export const backends = ${serialise(backends)} as const;
 
 // Derived types
-export type Ids = IdsOf<typeof manifest>;
-export type Construct<Id extends Ids> = DeclarationOf<typeof manifest, Id>;
+export type Ids = IdsOf<typeof constructs>;
+export type Construct<Id extends Ids> = DeclarationOf<typeof constructs, Id>;
 export type Kind = Construct<Ids>['kind'];
 
 // Useful union types
-export type ProvidedKeys = AllProvidedKeys<typeof manifest>;
-export type Surfaces = IdsOfKind<typeof manifest, 'rest-api'>;
+export type ProvidedKeys = AllProvidedKeys<typeof constructs>;
+export type Surfaces = IdsOfKind<typeof constructs, 'rest-api'>;
 export type CacheBackend = (typeof backends)['cache'];
 export type EmailBackend = (typeof backends)['email'];
 `;
 }
-/** Write it where the deploy config expects to import it from. */
-async function writeManifestModule(manifest, appRoot, backends = {}) {
-	const path = join(appRoot, MANIFEST_PATH);
-	await mkdir(dirname(path), { recursive: true });
-	await writeFile(path, manifestModule(manifest, backends), "utf8");
-	return path;
-}
 const HEADER = `// Generated by \`gkm build\`. Do not edit.
 //
 // Discovery imports application code, so it runs once here rather than in every
@@ -200,7 +187,7 @@ import type {
 function serialise(value) {
 	return JSON.stringify(value, null, "	").replace(/^(\t*)"([A-Za-z_$][\w$]*)":/gm, "$1$2:").replace(/"/g, "'");
 }
-
 //#endregion
-export { MANIFEST_PATH, manifestModule, withCompute, withRoutes, writeManifestModule };
-//# sourceMappingURL=emit-CIlvnDvV.mjs.map
+export { withCompute as n, withRoutes as r, manifestModule as t };
+
+//# sourceMappingURL=emit-C1e8qD08.mjs.map

package/dist/emit-C1e8qD08.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-C1e8qD08.mjs","names":[],"sources":["../src/reconcile/emit.ts"],"sourcesContent":["/**\n * The manifest, written out as a module.\n *\n * Discovery imports the application's own code — that is how it finds\n * constructs — so anything calling it evaluates the whole runtime graph: React\n * email templates, database clients, modules that read env at import time. That\n * is fine inside `gkm dev`, which is already running the app. It is not fine\n * inside a deploy config, where it fails on the first thing the deploy toolchain\n * does not expect and would keep failing on the next.\n *\n * So discovery happens once, in the build, and everything downstream reads what\n * it wrote. The same split `RestApi` makes by naming a routes glob rather than\n * importing route modules.\n *\n * A module rather than JSON, because a manifest is not just data to this\n * codebase — `as const satisfies ConstructManifest` is what keeps every id,\n * kind and provided key a *literal*, so `IdsOf`, `ProvidedKeys` and the rest\n * can select out of it. `JSON.parse` returns `any` and gives all of that up.\n */\n\nimport type {\n\tConstructManifest,\n\tCronInfo,\n\tDeclaration,\n\tDependency,\n\tFunctionInfo,\n\tQueueInfo,\n\tRestApiEndpoint,\n\tRouteInfo,\n\tSubscriberInfo,\n} from '@geekmidas/manifest';\nimport { canonicalId, provideKey } from '@geekmidas/manifest';\nimport type { CacheBackend, EmailBackend } from '../types.js';\n\n/**\n * Fold the build's generated routes into the surface that serves them.\n *\n * The routes already exist: `gkm build` generates one handler per endpoint and\n * records its path, method and environment. What was missing is that the\n * *construct* manifest never learned about them, so a `rest-api` node said\n * `endpoints: []` while five handlers sat in `.gkm/`. Two documents describing\n * the same routes, one of them wrong.\n *\n * Merging here rather than making the construct name a glob or import its\n * endpoints: the build is the thing that already walked the filesystem and\n * already knows where it wrote each handler. Asking the declaration to restate\n * any of that is how the two come to disagree.\n *\n * Attribution is to the surface the build served — the one whose `path` is\n * the app being built. Without one, routes go to the surface that declared none\n * of its own; a surface with static endpoints (an auth server's single\n * wildcard) keeps them.\n *\n * **Only from a provider that generates one handler per route.** The `server`\n * provider generates a single catch-all — `ALL *` pointing at the Hono app that\n * routes in-process — which is a true description of that build and a false\n * description of the application. Merging it wrote `endpoints: [{ method:\n * 'ALL', path: '*' }]` into a manifest for an app with five routes, and made the\n * document's contents depend on which `--provider` ran last. A manifest must not\n * do that.\n */\nexport function withRoutes(\n\tmanifest: ConstructManifest,\n\troutes: readonly RouteInfo[],\n\toptions: { perRoute: boolean; surface?: string },\n): ConstructManifest {\n\tif (routes.length === 0 || !options.perRoute) return manifest;\n\n\tconst target = Object.entries(manifest).find(([id, declaration]) =>\n\t\toptions.surface\n\t\t\t? id === options.surface\n\t\t\t: declaration.kind === 'rest-api' && declaration.endpoints.length === 0,\n\t);\n\n\tif (!target) return manifest;\n\n\tconst [id, declaration] = target;\n\tif (declaration.kind !== 'rest-api') return manifest;\n\n\treturn {\n\t\t...manifest,\n\t\t[id]: {\n\t\t\t...declaration,\n\t\t\tendpoints: routes.map((route) => asEndpoint(manifest, id, route)),\n\t\t},\n\t};\n}\n\n/**\n * Fold in the compute the build generated: functions, crons, queue workers and\n * topic subscribers.\n *\n * All four are named by their *export*, the same way an endpoint's handler is —\n * `CronGenerator` uses the export key as the name — so none of them can declare\n * themselves and all of them are the build's to add. That is why a `Function`\n * has no `declare()` and never will.\n *\n * A worker and a subscriber **nest** inside the queue or topic that triggers\n * them, because position carries the trigger. A function and a cron are\n * top-level, because nothing triggers them but a caller or a clock.\n */\nexport function withCompute(\n\tmanifest: ConstructManifest,\n\tcompute: {\n\t\tfunctions?: readonly FunctionInfo[];\n\t\tcrons?: readonly CronInfo[];\n\t\tqueues?: readonly QueueInfo[];\n\t\tsubscribers?: readonly SubscriberInfo[];\n\t},\n): ConstructManifest {\n\tconst next: Record<string, Declaration> = { ...manifest };\n\n\tfor (const fn of compute.functions ?? []) {\n\t\tnext[fn.name] = {\n\t\t\tkind: 'function',\n\t\t\tid: fn.name,\n\t\t\thandler: fn.handler,\n\t\t\tdependencies: edgesTo(manifest, fn.dependencies),\n\t\t\tprovides: [provideKey(fn.name, 'url')],\n\t\t};\n\t}\n\n\tfor (const cron of compute.crons ?? []) {\n\t\tnext[cron.name] = {\n\t\t\tkind: 'cron',\n\t\t\tid: cron.name,\n\t\t\thandler: cron.handler,\n\t\t\tschedule: cron.schedule,\n\t\t\tdependencies: edgesTo(manifest, cron.dependencies),\n\t\t};\n\t}\n\n\t// A worker drains exactly one queue, so it is matched by the queue it names\n\t// rather than by anything about the handler.\n\tfor (const worker of compute.queues ?? []) {\n\t\tconst queue = next[canonicalId(worker.name)];\n\t\tif (queue?.kind !== 'queue') continue;\n\n\t\tnext[queue.id] = {\n\t\t\t...queue,\n\t\t\tworker: {\n\t\t\t\tid: `${queue.id}Worker`,\n\t\t\t\thandler: worker.handler,\n\t\t\t\tdependencies: edgesTo(manifest, worker.dependencies),\n\t\t\t},\n\t\t};\n\t}\n\n\tfor (const subscriber of compute.subscribers ?? []) {\n\t\tconst topicId = subscriber.topic && canonicalId(subscriber.topic);\n\t\tconst topic = topicId ? next[topicId] : undefined;\n\t\tif (topic?.kind !== 'topic') continue;\n\n\t\tnext[topic.id] = {\n\t\t\t...topic,\n\t\t\tsubscribers: [\n\t\t\t\t...topic.subscribers,\n\t\t\t\t{\n\t\t\t\t\tid: subscriber.name,\n\t\t\t\t\thandler: subscriber.handler,\n\t\t\t\t\tevents: subscriber.subscribedEvents,\n\t\t\t\t\tdependencies: edgesTo(manifest, subscriber.dependencies),\n\t\t\t\t},\n\t\t\t],\n\t\t};\n\t}\n\n\treturn next;\n}\n\n/**\n * Construct ids as manifest edges.\n *\n * A `Dependency` carries the target's kind as well as its id, and the kind is\n * read off the manifest rather than recorded beside the edge — the same rule\n * `edgeTo` follows, for the same reason: a hand-written kind is one fact stated\n * twice, and the copy is what goes stale.\n *\n * An id that names nothing is dropped rather than thrown on. A handler can\n * depend on a construct that declares no node of its own — a lifted `Service`\n * is exactly that — and a build is the wrong place to refuse it; what a target\n * needs from this list is the subset it can actually grant.\n */\nfunction edgesTo(\n\tmanifest: ConstructManifest,\n\tids: readonly string[] = [],\n): Dependency[] {\n\treturn ids.flatMap((target) => {\n\t\tconst declaration = manifest[target];\n\n\t\treturn declaration ? [{ target, kind: declaration.kind }] : [];\n\t});\n}\n\n/** One generated route as the manifest's shape. */\nfunction asEndpoint(\n\tmanifest: ConstructManifest,\n\tsurface: string,\n\troute: RouteInfo,\n): RestApiEndpoint {\n\treturn {\n\t\t// The handler path is already unique per route and is what a target needs\n\t\t// to point a function at, so it is also the natural id.\n\t\tid: `${surface}${route.method}${route.path}`,\n\t\thandler: route.handler,\n\t\tmethod: route.method,\n\t\tpath: route.path,\n\t\t// The edges the handler declared, which is what a target reads to grant\n\t\t// this one function access to exactly those constructs. `environment` is\n\t\t// the same edges' shadow — the keys read — and cannot be turned back into\n\t\t// them, which is why the ids are carried rather than inferred.\n\t\tdependencies: edgesTo(manifest, route.dependencies),\n\t\t...(route.authorizer ? { authorizer: route.authorizer } : {}),\n\t};\n}\n\n/**\n * The manifest as TypeScript source.\n *\n * Pure, so what gets written can be asserted without touching a filesystem.\n */\nexport function manifestModule(\n\tmanifest: ConstructManifest,\n\tbackends: Backends = {},\n): string {\n\treturn `${HEADER}\nexport const constructs = ${serialise(manifest)} as const satisfies ConstructManifest;\n\n/**\n * Where the backends that are *config* rather than declaration resolved to.\n *\n * Recorded because they were being answered twice: once by the build, which\n * registers exactly one cache driver, and once by a deploy config, which told\n * the provisioner something else. The result was a deployed URL the running code\n * had no driver for — two documents disagreeing about one fact, which is what\n * this manifest exists to stop.\n */\nexport const backends = ${serialise(backends)} as const;\n\n// Derived types\nexport type Ids = IdsOf<typeof constructs>;\nexport type Construct<Id extends Ids> = DeclarationOf<typeof constructs, Id>;\nexport type Kind = Construct<Ids>['kind'];\n\n// Useful union types\nexport type ProvidedKeys = AllProvidedKeys<typeof constructs>;\nexport type Surfaces = IdsOfKind<typeof constructs, 'rest-api'>;\nexport type CacheBackend = (typeof backends)['cache'];\nexport type EmailBackend = (typeof backends)['email'];\n`;\n}\n\n/** The choices that are deployment config rather than declaration. */\nexport interface Backends {\n\tcache?: CacheBackend;\n\temail?: EmailBackend;\n}\n\nconst HEADER = `// Generated by \\`gkm build\\`. Do not edit.\n//\n// Discovery imports application code, so it runs once here rather than in every\n// consumer — a deploy config that discovered for itself would evaluate the whole\n// runtime graph inside its own toolchain. This is the result, as literals.\n\nimport type {\n\tAllProvidedKeys,\n\tConstructManifest,\n\tDeclarationOf,\n\tIdsOf,\n\tIdsOfKind,\n} from '@geekmidas/manifest';\n`;\n\n/**\n * JSON, re-indented with tabs and with keys left unquoted where they can be.\n *\n * Cosmetic, and worth it: this file is read by people trying to work out what\n * their app declares, and a wall of quoted keys reads as output rather than as\n * something anyone is expected to understand.\n */\nfunction serialise(value: object): string {\n\treturn JSON.stringify(value, null, '\\t')\n\t\t.replace(/^(\\t*)\"([A-Za-z_$][\\w$]*)\":/gm, '$1$2:')\n\t\t.replace(/\"/g, \"'\");\n}\n"],"mappings":"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"}

package/dist/{emit-CUD1BWls.cjs → emit-Dmc1nvdS.cjs}

@@ -1,11 +1,5 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const node_path = require_chunk.__toESM(require("node:path"));
-const __geekmidas_manifest = require_chunk.__toESM(require("@geekmidas/manifest"));
-const node_fs_promises = require_chunk.__toESM(require("node:fs/promises"));
-
+let _geekmidas_manifest = require("@geekmidas/manifest");
 //#region src/reconcile/emit.ts
-/** Where the build writes it, relative to the app root. */
-const MANIFEST_PATH = ".gkm/manifest.ts";
 /**
 * Fold the build's generated routes into the surface that serves them.
 *
@@ -20,11 +14,10 @@ const MANIFEST_PATH = ".gkm/manifest.ts";
 * already knows where it wrote each handler. Asking the declaration to restate
 * any of that is how the two come to disagree.
 *
-* Attribution is by exclusion — routes go to the surface that declared none of
-* its own. A surface with static endpoints (an auth server's single wildcard)
-* keeps them. That is exact while an app has one API of its own, and needs a
-* real answer the day it has two; the alternative today would be inventing one
-* before anything needs it.
+* Attribution is to the surface the build served — the one whose `path` is
+* the app being built. Without one, routes go to the surface that declared none
+* of its own; a surface with static endpoints (an auth server's single
+* wildcard) keeps them.
 *
 * **Only from a provider that generates one handler per route.** The `server`
 * provider generates a single catch-all — `ALL *` pointing at the Hono app that
@@ -36,7 +29,7 @@ const MANIFEST_PATH = ".gkm/manifest.ts";
 */
 function withRoutes(manifest, routes, options) {
 	if (routes.length === 0 || !options.perRoute) return manifest;
-	const target = Object.entries(manifest).find(([, declaration$1]) => declaration$1.kind === "rest-api" && declaration$1.endpoints.length === 0);
+	const target = Object.entries(manifest).find(([id, declaration]) => options.surface ? id === options.surface : declaration.kind === "rest-api" && declaration.endpoints.length === 0);
 	if (!target) return manifest;
 	const [id, declaration] = target;
 	if (declaration.kind !== "rest-api") return manifest;
@@ -68,7 +61,7 @@ function withCompute(manifest, compute) {
 		id: fn.name,
 		handler: fn.handler,
 		dependencies: edgesTo(manifest, fn.dependencies),
-		provides: [(0, __geekmidas_manifest.provideKey)(fn.name, "url")]
+		provides: [(0, _geekmidas_manifest.provideKey)(fn.name, "url")]
 	};
 	for (const cron of compute.crons ?? []) next[cron.name] = {
 		kind: "cron",
@@ -78,7 +71,7 @@ function withCompute(manifest, compute) {
 		dependencies: edgesTo(manifest, cron.dependencies)
 	};
 	for (const worker of compute.queues ?? []) {
-		const queue = next[(0, __geekmidas_manifest.canonicalId)(worker.name)];
+		const queue = next[(0, _geekmidas_manifest.canonicalId)(worker.name)];
 		if (queue?.kind !== "queue") continue;
 		next[queue.id] = {
 			...queue,
@@ -90,7 +83,7 @@ function withCompute(manifest, compute) {
 		};
 	}
 	for (const subscriber of compute.subscribers ?? []) {
-		const topicId = subscriber.topic && (0, __geekmidas_manifest.canonicalId)(subscriber.topic);
+		const topicId = subscriber.topic && (0, _geekmidas_manifest.canonicalId)(subscriber.topic);
 		const topic = topicId ? next[topicId] : void 0;
 		if (topic?.kind !== "topic") continue;
 		next[topic.id] = {
@@ -145,7 +138,7 @@ function asEndpoint(manifest, surface, route) {
 */
 function manifestModule(manifest, backends = {}) {
 	return `${HEADER}
-export const manifest = ${serialise(manifest)} as const satisfies ConstructManifest;
+export const constructs = ${serialise(manifest)} as const satisfies ConstructManifest;
 
 /**
  * Where the backends that are *config* rather than declaration resolved to.
@@ -159,24 +152,17 @@ export const manifest = ${serialise(manifest)} as const satisfies ConstructManif
 export const backends = ${serialise(backends)} as const;
 
 // Derived types
-export type Ids = IdsOf<typeof manifest>;
-export type Construct<Id extends Ids> = DeclarationOf<typeof manifest, Id>;
+export type Ids = IdsOf<typeof constructs>;
+export type Construct<Id extends Ids> = DeclarationOf<typeof constructs, Id>;
 export type Kind = Construct<Ids>['kind'];
 
 // Useful union types
-export type ProvidedKeys = AllProvidedKeys<typeof manifest>;
-export type Surfaces = IdsOfKind<typeof manifest, 'rest-api'>;
+export type ProvidedKeys = AllProvidedKeys<typeof constructs>;
+export type Surfaces = IdsOfKind<typeof constructs, 'rest-api'>;
 export type CacheBackend = (typeof backends)['cache'];
 export type EmailBackend = (typeof backends)['email'];
 `;
 }
-/** Write it where the deploy config expects to import it from. */
-async function writeManifestModule(manifest, appRoot, backends = {}) {
-	const path = (0, node_path.join)(appRoot, MANIFEST_PATH);
-	await (0, node_fs_promises.mkdir)((0, node_path.dirname)(path), { recursive: true });
-	await (0, node_fs_promises.writeFile)(path, manifestModule(manifest, backends), "utf8");
-	return path;
-}
 const HEADER = `// Generated by \`gkm build\`. Do not edit.
 //
 // Discovery imports application code, so it runs once here rather than in every
@@ -201,36 +187,24 @@ import type {
 function serialise(value) {
 	return JSON.stringify(value, null, "	").replace(/^(\t*)"([A-Za-z_$][\w$]*)":/gm, "$1$2:").replace(/"/g, "'");
 }
-
 //#endregion
-Object.defineProperty(exports, 'MANIFEST_PATH', {
-  enumerable: true,
-  get: function () {
-    return MANIFEST_PATH;
-  }
-});
-Object.defineProperty(exports, 'manifestModule', {
-  enumerable: true,
-  get: function () {
-    return manifestModule;
-  }
-});
-Object.defineProperty(exports, 'withCompute', {
-  enumerable: true,
-  get: function () {
-    return withCompute;
-  }
+Object.defineProperty(exports, "manifestModule", {
+	enumerable: true,
+	get: function() {
+		return manifestModule;
+	}
 });
-Object.defineProperty(exports, 'withRoutes', {
-  enumerable: true,
-  get: function () {
-    return withRoutes;
-  }
+Object.defineProperty(exports, "withCompute", {
+	enumerable: true,
+	get: function() {
+		return withCompute;
+	}
 });
-Object.defineProperty(exports, 'writeManifestModule', {
-  enumerable: true,
-  get: function () {
-    return writeManifestModule;
-  }
+Object.defineProperty(exports, "withRoutes", {
+	enumerable: true,
+	get: function() {
+		return withRoutes;
+	}
 });
-//# sourceMappingURL=emit-CUD1BWls.cjs.map
+
+//# sourceMappingURL=emit-Dmc1nvdS.cjs.map