create-eigen-game 0.9.0 → 0.9.2

package/README.md

@@ -24,13 +24,13 @@ so passing the flag skips the question:
 | Emit the GitHub Actions workflows | `--workflows`, `--no-workflows` |
 | Which package manager the generated scripts use | `--package-manager npm\|pnpm` |
 
-The package manager is only asked when nothing else can say — `npm create` and
+The package manager is only asked when nothing else can say. `npm create` and
 `pnpm create` both announce themselves. The Firebase question only appears when
 the `firebase` and `flutterfire` CLIs are not both installed and signed in, and
 its default is to stop rather than scaffold, since a scaffolded app throws
 `Firebase is not configured` at launch until a project is connected.
 
-With no terminal to ask on — CI, a pipe, an agent session — an unanswered
+With no terminal to ask on (CI, a pipe, an agent session) an unanswered
 question is an error rather than a default chosen where nobody can see it, and
 the message prints the whole command to re-run with each default filled in.
 `--org` is why: `com.example.my_game` is permanent once Google Play has taken

package/dist/{chunk-XTTEOV5U.js → chunk-X6NSW7BX.js}

@@ -1,7 +1,7 @@
 // src/index.ts
 import { execFileSync } from "child_process";
-import { appendFileSync, cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmdirSync, rmSync, statSync, writeFileSync } from "fs";
-import { basename, dirname, relative, resolve } from "path";
+import { appendFileSync, cpSync, existsSync as existsSync2, mkdirSync, mkdtempSync, readdirSync, readFileSync as readFileSync2, renameSync, rmdirSync, rmSync, statSync, writeFileSync } from "fs";
+import { basename, dirname, relative, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
 
 // src/engine-range.ts
@@ -20,6 +20,32 @@ function engineRange(declared, readSiblingVersion) {
   return `^${version}`;
 }
 
+// src/link-firebase.ts
+import { existsSync, readFileSync } from "fs";
+import { resolve } from "path";
+function readJson(path) {
+  if (!existsSync(path)) return void 0;
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function configuredProject(appRoot) {
+  const record = readJson(resolve(appRoot, "firebase.json"));
+  const projectId = record?.flutter?.platforms?.dart?.["lib/firebase_options.dart"]?.projectId;
+  return typeof projectId === "string" && projectId !== "" ? projectId : null;
+}
+function configuredWebClientId(appRoot) {
+  const config = readJson(resolve(appRoot, "app-config.json"));
+  const value = config?.GOOGLE_WEB_CLIENT_ID;
+  return typeof value === "string" && value !== "" ? value : null;
+}
+function readFirebaseLink(root) {
+  const appRoot = resolve(root, "app");
+  return { projectId: configuredProject(appRoot), googleWebClientId: configuredWebClientId(appRoot) };
+}
+
 // src/index.ts
 function normaliseTerminalWidth(stream) {
   if (stream.isTTY === true && (stream.columns ?? 0) < 1) stream.columns = 80;
@@ -46,11 +72,11 @@ function capturingRunner(reporter) {
     }
   };
 }
-var packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-var templatesRoot = resolve(packageRoot, "templates");
-var engineVersion = engineRange(JSON.parse(readFileSync(resolve(packageRoot, "package.json"), "utf8")).devDependencies?.[ENGINE_PACKAGE], () => {
-  const sibling = resolve(packageRoot, "../server/package.json");
-  return existsSync(sibling) ? JSON.parse(readFileSync(sibling, "utf8")).version : void 0;
+var packageRoot = resolve2(dirname(fileURLToPath(import.meta.url)), "..");
+var templatesRoot = resolve2(packageRoot, "templates");
+var engineVersion = engineRange(JSON.parse(readFileSync2(resolve2(packageRoot, "package.json"), "utf8")).devDependencies?.[ENGINE_PACKAGE], () => {
+  const sibling = resolve2(packageRoot, "../server/package.json");
+  return existsSync2(sibling) ? JSON.parse(readFileSync2(sibling, "utf8")).version : void 0;
 });
 var flutterClientVersion = "^0.3.0";
 var gameSlug = (value) => {
@@ -61,7 +87,7 @@ var gameSlug = (value) => {
 };
 var dartName = (value) => value.replaceAll("-", "_");
 function applicationId(directory, org) {
-  return `${org?.trim() || "com.example"}.${dartName(gameSlug(basename(resolve(directory))))}`;
+  return `${org?.trim() || "com.example"}.${dartName(gameSlug(basename(resolve2(directory))))}`;
 }
 var title = (value) => value.split("-").map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
 var identifier = (value) => {
@@ -98,14 +124,14 @@ function renderTree(source, destination, name, manager, packageId) {
   cpSync(source, destination, { recursive: true });
   const visit = (directory) => {
     for (const entry of readdirSync(directory, { withFileTypes: true })) {
-      const templatePath = resolve(directory, entry.name);
+      const templatePath = resolve2(directory, entry.name);
       if (entry.isDirectory()) {
         visit(templatePath);
         continue;
       }
       if (!entry.isFile()) continue;
-      const rendered = resolve(destination, relative(source, templatePath));
-      const text = decodeUtf8(readFileSync(templatePath));
+      const rendered = resolve2(destination, relative(source, templatePath));
+      const text = decodeUtf8(readFileSync2(templatePath));
       if (text !== void 0) {
         writeFileSync(rendered, render(text, name, manager, packageId));
       }
@@ -115,9 +141,9 @@ function renderTree(source, destination, name, manager, packageId) {
     }
   };
   visit(source);
-  const packagedGitignore = resolve(templatesRoot, "scaffold", `${basename(source)}.gitignore`);
-  if (existsSync(packagedGitignore)) {
-    writeFileSync(resolve(destination, ".gitignore"), render(readFileSync(packagedGitignore, "utf8"), name, manager, packageId));
+  const packagedGitignore = resolve2(templatesRoot, "scaffold", `${basename(source)}.gitignore`);
+  if (existsSync2(packagedGitignore)) {
+    writeFileSync(resolve2(destination, ".gitignore"), render(readFileSync2(packagedGitignore, "utf8"), name, manager, packageId));
   }
 }
 function packageCommand(manager, operation) {
@@ -136,8 +162,8 @@ dependencies {
     coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.4")
 }`;
 function enableAndroidCoreLibraryDesugaring(appRoot) {
-  const gradlePath = resolve(appRoot, "android/app/build.gradle.kts");
-  const gradle = readFileSync(gradlePath, "utf8");
+  const gradlePath = resolve2(appRoot, "android/app/build.gradle.kts");
+  const gradle = readFileSync2(gradlePath, "utf8");
   if (!gradle.includes('id("com.android.application")')) {
     throw new Error(`Flutter created an unexpected Android application build file: ${gradlePath}`);
   }
@@ -184,8 +210,8 @@ android {
     }
 }`;
 function enableAndroidReleaseSigning(appRoot) {
-  const gradlePath = resolve(appRoot, "android/app/build.gradle.kts");
-  const gradle = readFileSync(gradlePath, "utf8");
+  const gradlePath = resolve2(appRoot, "android/app/build.gradle.kts");
+  const gradle = readFileSync2(gradlePath, "utf8");
   if (gradle.includes("releaseKeyProperties")) return;
   appendFileSync(gradlePath, `${gradle.endsWith("\n") ? "" : "\n"}${androidReleaseSigning}
 `);
@@ -217,29 +243,29 @@ flutter_native_splash:
   web: true
 `;
 function configureLauncherIconsAndSplash(appRoot) {
-  const pubspecPath = resolve(appRoot, "pubspec.yaml");
-  const pubspec = readFileSync(pubspecPath, "utf8");
+  const pubspecPath = resolve2(appRoot, "pubspec.yaml");
+  const pubspec = readFileSync2(pubspecPath, "utf8");
   if (pubspec.includes("flutter_launcher_icons:")) return;
   appendFileSync(pubspecPath, `${pubspec.endsWith("\n") ? "" : "\n"}${launcherIconsAndSplashConfig}`);
 }
 function addContinuousIntegration(options) {
-  const root = resolve(options.directory);
-  const manifestPath = resolve(root, "package.json");
-  if (!existsSync(manifestPath) || !existsSync(resolve(root, "server")) || !existsSync(resolve(root, "app"))) {
+  const root = resolve2(options.directory);
+  const manifestPath = resolve2(root, "package.json");
+  if (!existsSync2(manifestPath) || !existsSync2(resolve2(root, "server")) || !existsSync2(resolve2(root, "app"))) {
     throw new Error(`not an EigenInteractive game project (expected package.json, server/ and app/): ${root}`);
   }
-  const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+  const manifest = JSON.parse(readFileSync2(manifestPath, "utf8"));
   const name = gameSlug(manifest.name ?? basename(root));
   const recorded = manifest.scripts?.contract?.includes("pnpm ") ? "pnpm" : manifest.scripts?.contract?.includes("npm ") ? "npm" : void 0;
   const manager = options.packageManager ?? recorded ?? detectPackageManager() ?? "pnpm";
-  const appfile = resolve(root, "app/fastlane/Appfile");
-  const packageId = existsSync(appfile) ? /package_name\("([^"]+)"\)/.exec(readFileSync(appfile, "utf8"))?.[1] ?? `com.example.${dartName(name)}` : `com.example.${dartName(name)}`;
-  const workflows = resolve(root, ".github/workflows");
-  const existing = existsSync(workflows) ? readdirSync(workflows).filter((f) => f === "checks.yml" || f === "release.yml") : [];
+  const appfile = resolve2(root, "app/fastlane/Appfile");
+  const packageId = existsSync2(appfile) ? /package_name\("([^"]+)"\)/.exec(readFileSync2(appfile, "utf8"))?.[1] ?? `com.example.${dartName(name)}` : `com.example.${dartName(name)}`;
+  const workflows = resolve2(root, ".github/workflows");
+  const existing = existsSync2(workflows) ? readdirSync(workflows).filter((f) => f === "checks.yml" || f === "release.yml") : [];
   if (existing.length > 0) {
     throw new Error(`refusing to overwrite existing workflows: ${existing.join(", ")}`);
   }
-  renderTree(resolve(templatesRoot, "ci"), root, name, manager, packageId);
+  renderTree(resolve2(templatesRoot, "ci"), root, name, manager, packageId);
   return { root, files: [".github/workflows/checks.yml", ".github/workflows/release.yml"] };
 }
 var probeCommand = (command, args) => {
@@ -254,7 +280,7 @@ function firebaseReadiness(probe = probeCommand) {
   if (probe("firebase", ["--version"]).ok) {
     if (signedOut(probe)) problems.push({ reason: "no Google account is signed in to the Firebase CLI", fix: "firebase login" });
   } else {
-    problems.push({ reason: "the `firebase` CLI is not installed", fix: "npm install -g firebase-tools" });
+    problems.push({ reason: "the `firebase` CLI is not installed", fix: "curl -sL https://firebase.tools | bash" });
   }
   if (!probe("flutterfire", ["--version"]).ok) {
     problems.push({ reason: "the `flutterfire` CLI is not installed", fix: "dart pub global activate flutterfire_cli" });
@@ -272,20 +298,20 @@ function signedOut(probe) {
   }
 }
 function destinationProblem(directory) {
-  const root = resolve(directory);
-  if (!existsSync(root)) return void 0;
+  const root = resolve2(directory);
+  if (!existsSync2(root)) return void 0;
   if (!statSync(root).isDirectory()) return `${root} already exists, and is a file.`;
   const entries = readdirSync(root);
   if (entries.length === 0) return void 0;
   const shown = entries.slice(0, 3).sort().join(", ");
   const rest = entries.length > 3 ? `, and ${entries.length - 3} more` : "";
-  return `${root} already exists, and is not empty \u2014 it holds ${shown}${rest}.
+  return `${root} already exists, and is not empty: it holds ${shown}${rest}.
 
 Scaffold somewhere else, or clear it out yourself. This will not delete a directory you already had.`;
 }
 function insideWorkTree(directory, probe = probeCommand) {
-  let candidate = resolve(directory);
-  while (!existsSync(candidate)) {
+  let candidate = resolve2(directory);
+  while (!existsSync2(candidate)) {
     const parent = dirname(candidate);
     if (parent === candidate) return false;
     candidate = parent;
@@ -293,21 +319,21 @@ function insideWorkTree(directory, probe = probeCommand) {
   return probe("git", ["-C", candidate, "rev-parse", "--is-inside-work-tree"]).ok;
 }
 function configureFirebase(appRoot, project, run, reporter) {
-  const placeholder = resolve(appRoot, "lib/firebase_options.dart");
+  const placeholder = resolve2(appRoot, "lib/firebase_options.dart");
   const parked = `${placeholder}.placeholder`;
-  const parking = existsSync(placeholder);
+  const parking = existsSync2(placeholder);
   if (parking) renameSync(placeholder, parked);
   try {
     reporter.step("Preparing the Firebase configurator", () => run("dart", ["run", "eigen_flutter:configure_firebase", "--help"], appRoot));
-    reporter.handOver("Configuring Firebase", () => run("dart", ["run", "eigen_flutter:configure_firebase", ...typeof project === "string" ? ["--project", project] : []], appRoot));
+    reporter.handOver("Configuring Firebase", () => run("dart", ["run", "eigen_flutter:configure_firebase", "--worker", "../server", ...typeof project === "string" ? ["--project", project] : []], appRoot));
     if (parking) rmSync(parked, { force: true });
     return "configured";
   } catch {
     if (parking) {
-      if (existsSync(placeholder)) rmSync(parked, { force: true });
+      if (existsSync2(placeholder)) rmSync(parked, { force: true });
       else renameSync(parked, placeholder);
     }
-    reporter.warn("Could not configure Firebase. The project is complete \u2014 run `firebase:configure` yourself, then commit what it writes.");
+    reporter.warn("Could not configure Firebase. The project is complete. Run `firebase:configure` yourself, then commit what it writes.");
     return "failed";
   }
 }
@@ -321,7 +347,7 @@ function initialiseRepository(root, name, run, reporter) {
     run("git", ["init", "--quiet"], root);
     run("git", ["add", "--all"], root);
   } catch {
-    reporter.warn("Could not initialise a git repository. The project is complete \u2014 run `git init` yourself when ready.");
+    reporter.warn("Could not initialise a git repository. The project is complete. Run `git init` yourself when ready.");
     return "failed";
   }
   try {
@@ -333,7 +359,7 @@ function initialiseRepository(root, name, run, reporter) {
   return "committed";
 }
 function scaffoldGame(options) {
-  const root = resolve(options.directory);
+  const root = resolve2(options.directory);
   const name = gameSlug(basename(root));
   const manager = options.packageManager ?? detectPackageManager() ?? "pnpm";
   const org = options.org?.trim() || "com.example";
@@ -343,15 +369,15 @@ function scaffoldGame(options) {
   const run = options.run ?? capturingRunner(reporter);
   const occupied = destinationProblem(root);
   if (occupied !== void 0) throw new Error(occupied);
-  if (existsSync(root)) rmdirSync(root);
+  if (existsSync2(root)) rmdirSync(root);
   mkdirSync(dirname(root), { recursive: true });
-  const stagingRoot = mkdtempSync(resolve(dirname(root), `.${basename(root)}-`));
+  const stagingRoot = mkdtempSync(resolve2(dirname(root), `.${basename(root)}-`));
   try {
-    const serverRoot = resolve(stagingRoot, "server");
-    const appRoot = resolve(stagingRoot, "app");
-    renderTree(resolve(templatesRoot, "worker"), serverRoot, name, manager, packageId);
-    renderTree(resolve(templatesRoot, "project"), stagingRoot, name, manager, packageId);
-    if (options.ci) renderTree(resolve(templatesRoot, "ci"), stagingRoot, name, manager, packageId);
+    const serverRoot = resolve2(stagingRoot, "server");
+    const appRoot = resolve2(stagingRoot, "app");
+    renderTree(resolve2(templatesRoot, "worker"), serverRoot, name, manager, packageId);
+    renderTree(resolve2(templatesRoot, "project"), stagingRoot, name, manager, packageId);
+    if (options.ci) renderTree(resolve2(templatesRoot, "ci"), stagingRoot, name, manager, packageId);
     if (bootstrap) {
       reporter.step("Creating the Flutter app", () => {
         run("flutter", ["create", "--empty", "--platforms", "android,web", "--project-name", dartName(name), "--org", org, appRoot], stagingRoot);
@@ -361,7 +387,7 @@ function scaffoldGame(options) {
     } else {
       mkdirSync(appRoot, { recursive: true });
     }
-    renderTree(resolve(templatesRoot, "app-overlay"), appRoot, name, manager, packageId);
+    renderTree(resolve2(templatesRoot, "app-overlay"), appRoot, name, manager, packageId);
     if (bootstrap) {
       reporter.step("Adding the Flutter packages", () => {
         configureLauncherIconsAndSplash(appRoot);
@@ -390,9 +416,10 @@ function scaffoldGame(options) {
     rmSync(stagingRoot, { recursive: true, force: true });
     throw error;
   }
-  const firebase = options.firebase ? configureFirebase(resolve(root, "app"), options.firebase, run, reporter) : "skipped";
+  const firebase = options.firebase ? configureFirebase(resolve2(root, "app"), options.firebase, run, reporter) : "skipped";
+  const link = firebase === "configured" ? readFirebaseLink(root) : void 0;
   const git = options.git ?? bootstrap ? initialiseRepository(root, name, run, reporter) : "skipped";
-  return { root, name, git, firebase };
+  return { root, name, git, firebase, link };
 }
 
 export {
@@ -408,4 +435,4 @@ export {
   insideWorkTree,
   scaffoldGame
 };
-//# sourceMappingURL=chunk-XTTEOV5U.js.map
+//# sourceMappingURL=chunk-X6NSW7BX.js.map

package/dist/chunk-X6NSW7BX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/engine-range.ts","../src/link-firebase.ts"],"sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport { appendFileSync, cpSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmdirSync, rmSync, statSync, writeFileSync } from \"node:fs\";\nimport { basename, dirname, relative, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { ENGINE_PACKAGE, engineRange } from \"./engine-range.js\";\nimport { type FirebaseLink, readFirebaseLink } from \"./link-firebase.js\";\n\nexport type { FirebaseLink } from \"./link-firebase.js\";\n\nexport type PackageManager = \"npm\" | \"pnpm\";\n\nexport type Runner = (command: string, args: string[], cwd: string) => void;\n\n/**\n * Where a scaffold says what it is doing, so that presentation belongs to the\n * caller and this module only has to name things.\n *\n * The default is the behaviour a library caller expects with no opinion:\n * subprocesses inherit the terminal and warnings go to `console.warn`. The CLI\n * substitutes one that captures each step's output and shows it only if the\n * step fails.\n */\nexport interface Reporter {\n  /** Runs `body` as one named step. Its subprocesses can be captured. */\n  step<T>(label: string, body: () => T): T;\n  /**\n   * Runs `body` as a step that owns the terminal, because something inside it\n   * asks questions. FlutterFire is the only one.\n   */\n  handOver<T>(label: string, body: () => T): T;\n  /** Output from a subprocess inside the current step. */\n  emit(output: string): void;\n  /** A failure the scaffold survives. */\n  warn(message: string): void;\n  /** Whether subprocesses must inherit the terminal rather than be captured. */\n  readonly interactive: boolean;\n}\n\n/**\n * Gives a terminal that reports no width the width clack would have assumed.\n *\n * A pty can report itself as a TTY and set `columns` to 0. `script` does, and\n * so do some container terminals. clack falls back to 80 for a stream with no\n * `columns` at all, but `0` is a number and satisfies that check, so the width\n * it draws its rules from goes negative and a scaffold dies partway through\n * with `RangeError: Invalid string length`. Supplying the default its check\n * misses is better than giving up the drawing.\n */\nexport function normaliseTerminalWidth(stream: { isTTY?: boolean; columns?: number }): void {\n  if (stream.isTTY === true && (stream.columns ?? 0) < 1) stream.columns = 80;\n}\n\n/** Runs every step plainly, which is what a library caller gets by default. */\nexport const plainReporter: Reporter = {\n  step: (_label, body) => body(),\n  handOver: (_label, body) => body(),\n  emit: (output) => process.stdout.write(output),\n  warn: (message) => console.warn(`create-eigen-game: ${message}`),\n  interactive: true,\n};\n\n/**\n * The runner a scaffold uses when the caller has not supplied one: it asks the\n * reporter whether the terminal is spoken for.\n *\n * `interactive` inherits, which is the only way FlutterFire can put a question\n * on screen and read the answer. Otherwise both streams are captured and\n * handed to the reporter: on success so it can discard them, and on failure\n * so the reason survives.\n */\nexport function capturingRunner(reporter: Reporter): Runner {\n  return (command, args, cwd) => {\n    if (reporter.interactive) {\n      execFileSync(command, args, { cwd, stdio: \"inherit\" });\n      return;\n    }\n    try {\n      reporter.emit(execFileSync(command, args, { cwd, encoding: \"utf8\", stdio: [\"ignore\", \"pipe\", \"pipe\"] }));\n    } catch (error: unknown) {\n      // Both streams, because which one a tool failed on is its own business:\n      // pub explains itself on stdout, Gradle on stderr.\n      const { stdout, stderr } = error as { stdout?: string; stderr?: string };\n      reporter.emit(`${stdout ?? \"\"}${stderr ?? \"\"}`);\n      throw error;\n    }\n  };\n}\n\nexport interface ScaffoldOptions {\n  directory: string;\n  org?: string;\n  packageManager?: PackageManager;\n  /**\n   * Run Flutter, package installation, and contract/payload generation.\n   * Kept as a programmatic test seam; the public CLI always bootstraps both\n   * halves of the combined project.\n   */\n  bootstrap?: boolean;\n  /**\n   * Emit the GitHub Actions workflows. Off by default; see the call site for\n   * why, and `addContinuousIntegration` for adding them to an existing\n   * project later.\n   */\n  ci?: boolean;\n  /**\n   * Initialise a repository and commit the scaffold. Defaults to `bootstrap`,\n   * because the commit is only worth having once the generated files exist.\n   */\n  git?: boolean;\n  /**\n   * Configure Firebase before the first commit, by running the Flutter\n   * client's `configure_firebase`. A string names the project to use; `true`\n   * lets FlutterFire ask, which is also where a project can be created.\n   *\n   * Explicit here, though the CLI turns it on by default: this is the one step\n   * that reaches outside the destination directory, and a library caller\n   * should say so rather than discover it. {@link firebaseReadiness} is how\n   * the CLI decides.\n   */\n  firebase?: boolean | string;\n  /**\n   * Runs the bootstrap subprocesses. A seam: the tests substitute a recorder,\n   * and `scripts/scaffold-e2e.mjs` wraps it to point the generated server at\n   * this workspace's engine rather than npm's copy.\n   */\n  run?: Runner;\n  /**\n   * Where the scaffold says what it is doing. See {@link Reporter}; the\n   * default runs every step plainly.\n   */\n  reporter?: Reporter;\n}\n\n/**\n * What became of the repository, so the CLI's closing summary can say rather\n * than guess. `failed` has already warned by the time it is returned, and\n * carries no advice of its own.\n */\nexport type GitOutcome = \"committed\" | \"existing\" | \"skipped\" | \"failed\";\n\nexport interface ScaffoldResult {\n  root: string;\n  name: string;\n  git: GitOutcome;\n  /**\n   * Whether Firebase was configured, so the summary can either stop naming the\n   * step or spell it out. `failed` has already warned.\n   */\n  firebase: \"configured\" | \"failed\" | \"skipped\";\n  /**\n   * What the Firebase step made knowable and this scaffold therefore filled\n   * in. Absent unless `firebase` is `configured`, since there is nothing to\n   * read otherwise.\n   */\n  link?: FirebaseLink;\n}\n\nconst packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst templatesRoot = resolve(packageRoot, \"templates\");\n\n/**\n * The engine range emitted into a scaffolded project's package.json.\n *\n * Read from this package's `@eigeninteractive/server` devDependency rather than\n * from its own version. See `engine-range.ts` for why that is the version the\n * templates are known to compile against, and what it replaced.\n */\nconst engineVersion = engineRange((JSON.parse(readFileSync(resolve(packageRoot, \"package.json\"), \"utf8\")) as { devDependencies?: Record<string, string> }).devDependencies?.[ENGINE_PACKAGE], () => {\n  // Only reached in this workspace, where the manifest still says\n  // `workspace:*`. A published tarball has no sibling here and never asks.\n  const sibling = resolve(packageRoot, \"../server/package.json\");\n  return existsSync(sibling) ? (JSON.parse(readFileSync(sibling, \"utf8\")) as { version: string }).version : undefined;\n});\n\n/**\n * The Flutter client range installed into the app half.\n *\n * A stated version, not a derived or resolved one. The Dart templates import\n * `package:eigen_flutter/eigen_flutter.dart` and\n * `package:eigen_flutter/testing/twin_fixtures.dart` and are written against a\n * specific Dart API, and `eigen_flutter` lives in another repository, versioned\n * independently, so nothing in this repository can compute which release that\n * is. Only compiling a scaffolded app establishes it, which is what the\n * `scaffold` job in checks.yml does on every change.\n *\n * This briefly resolved from pub.dev instead: \"the newest `eigen_flutter` whose\n * own `eigen_api` constraint targets the engine line being scaffolded\". That\n * predicate is wrong. The `eigen_api` constraint describes the WIRE the shell\n * speaks, not the Dart API these templates call, and the two move\n * independently: a future `eigen_flutter` may legitimately keep `eigen_api:\n * ^0.2.0` while renaming everything the templates touch. It would have been\n * selected, and the generated app would not compile.\n *\n * A caret RANGE rather than an exact version, so it still improves without a\n * republish: `flutter pub add eigen_flutter@^0.3.0` already picks the newest\n * 0.3.x at scaffold time, which is the part the pub.dev lookup was duplicating.\n * What it deliberately cannot do is cross to 0.4.x, the one move that needs a\n * human to confirm the templates still compile.\n *\n * Staleness is therefore a failing check rather than a broken scaffold: this is\n * only ever a release behind, never wrong.\n *\n * Raised to 0.3.0 because the notification icon moved into `eigen_flutter`'s\n * Android plugin: the scaffold stopped shipping `ic_notification.xml`, so a\n * game resolving 0.2.x would reference a drawable nothing provides.\n */\nconst flutterClientVersion = \"^0.3.0\";\n\nconst gameSlug = (value: string): string => {\n  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value)) {\n    throw new Error(\"destination directory name must be a lowercase kebab-case slug, for example my-game\");\n  }\n  return value;\n};\n\nconst dartName = (value: string): string => value.replaceAll(\"-\", \"_\");\n\n/**\n * The Android `applicationId`, and iOS bundle id, a scaffold at `directory`\n * will produce, so the CLI can show it rather than describe it.\n *\n * `flutter create --org X --project-name Y` derives `X.Y`. The organization is\n * the *prefix*, not the whole identifier, which is the part worth seeing\n * before answering: Google Play makes it permanent at first upload.\n */\nexport function applicationId(directory: string, org?: string): string {\n  return `${org?.trim() || \"com.example\"}.${dartName(gameSlug(basename(resolve(directory))))}`;\n}\n\nconst title = (value: string): string =>\n  value\n    .split(\"-\")\n    .map((part) => `${part[0]?.toUpperCase() ?? \"\"}${part.slice(1)}`)\n    .join(\" \");\n\nconst identifier = (value: string): string => {\n  const pascal = value\n    .split(\"-\")\n    .map((part) => `${part[0]?.toUpperCase() ?? \"\"}${part.slice(1)}`)\n    .join(\"\");\n  return /^[0-9]/.test(pascal) ? `Game${pascal}` : pascal;\n};\n\nexport function detectPackageManager(userAgent = process.env.npm_config_user_agent): PackageManager | undefined {\n  if (userAgent?.startsWith(\"pnpm/\")) return \"pnpm\";\n  if (userAgent?.startsWith(\"npm/\")) return \"npm\";\n  return undefined;\n}\n\n/**\n * Substitutes the scaffold's tokens, of which there are two deliberate kinds.\n *\n * `{{BRACED}}` for values that have no valid example: a package manager,\n * an engine version, an Android package id. They appear only in manifests,\n * READMEs, workflows and the `Appfile`: files nothing compiles.\n *\n * Bare words (`ExampleGame`, `example-game`, …) for names a real example game\n * genuinely has. This is what keeps `templates/worker` and the Dart templates\n * VALID, COMPILING SOURCE rather than text with holes in it, which the rest of\n * this package leans on hard: `typecheck` runs `tsc` over `templates/worker`,\n * the tests `import` its game module directly and build a real contract from\n * it, and the `scaffold` job compiles the Dart templates. Bracing these would\n * trade all of that for a marker.\n *\n * The cost, and the one rule for template authors: a template file cannot\n * contain the literal string `example-game`, `Example Game`, `ExampleGame` or\n * `example_game` and keep it; every occurrence is rewritten, in prose and in\n * code alike. Write around it, or brace a new token instead.\n *\n * Note this means the set of files carrying a token changes whenever someone\n * writes one into an existing file. Nothing needs to track that: `renderTree`\n * decides what to rewrite from the bytes, not from a list of paths.\n */\nfunction render(contents: string, name: string, manager: PackageManager, packageId: string): string {\n  const replacements: ReadonlyArray<readonly [string, string]> = [\n    [\"@game/example-game-server\", `@game/${name}-server`],\n    [\"{{PACKAGE_MANAGER}}\", manager],\n    [\"{{PACKAGE_ID}}\", packageId],\n    [\"{{ENGINE_VERSION}}\", engineVersion],\n    [\"ExampleGame\", identifier(name)],\n    [\"Example Game\", title(name)],\n    [\"example_game\", dartName(name)],\n    [\"example-game\", name],\n  ];\n  return replacements.reduce((result, [from, to]) => result.replaceAll(from, to), contents);\n}\n\n/**\n * True when the bytes are valid UTF-8.\n *\n * This is not a guess at whether a file is \"binary\"; it is the precondition\n * of the operation. Token substitution is `String.replaceAll`, so a file that\n * cannot be decoded cannot take part, and one that can is safe to rewrite.\n *\n * Deliberately not an extension list. A DENY list (`.png`, `.jar`, …) fails\n * silently in the dangerous direction: the day someone adds a `.webp`, it is\n * corrupted with no error. An ALLOW list fails the safe way but fits this tree\n * badly: `Gemfile`, `Fastfile`, `.nvmrc`, `.fvmrc` and `.ruby-version` all\n * need rendering and none carry a usable extension, so it would have to be a\n * list of extensions *and* a list of bare filenames, both drifting.\n *\n * `.template` is not the signal either, despite the name: it marks files a\n * language server must not claim before they have an enclosing package. Five\n * of them contain no token at all, and nine token-bearing files are not\n * marked, so the two concepts are orthogonal here.\n *\n * `renderTree`'s test pins the resulting classification for the whole tree, so\n * this stays a reviewed decision rather than an invisible one.\n */\nconst utf8 = new TextDecoder(\"utf-8\", { fatal: true });\n\nexport function decodeUtf8(bytes: Buffer): string | undefined {\n  try {\n    return utf8.decode(bytes);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction renderTree(source: string, destination: string, name: string, manager: PackageManager, packageId: string): void {\n  cpSync(source, destination, { recursive: true });\n  // Walks the TEMPLATE, not the destination. The app overlay renders on top of\n  // a `flutter create` result, so walking the destination meant rewriting\n  // every file Flutter had just generated, including its binaries, for files\n  // this scaffolder does not own and has no business touching.\n  const visit = (directory: string): void => {\n    for (const entry of readdirSync(directory, { withFileTypes: true })) {\n      const templatePath = resolve(directory, entry.name);\n      if (entry.isDirectory()) {\n        visit(templatePath);\n        continue;\n      }\n      if (!entry.isFile()) continue;\n\n      const rendered = resolve(destination, relative(source, templatePath));\n      const text = decodeUtf8(readFileSync(templatePath));\n      // Undecodable files are already in place from the copy above, byte for\n      // byte. Only decodable ones are rewritten.\n      if (text !== undefined) {\n        writeFileSync(rendered, render(text, name, manager, packageId));\n      }\n      // Template-only source must not be claimed by language servers before\n      // it has an enclosing generated package. Restore the real extension\n      // only in the rendered project.\n      if (entry.name.endsWith(\".template\")) {\n        renameSync(rendered, rendered.slice(0, -\".template\".length));\n      }\n    }\n  };\n  visit(source);\n\n  // npm deliberately excludes files named `.gitignore` from package\n  // tarballs. Their packaged twins live outside the C3 template so a direct\n  // Git-based C3 render does not inherit a scaffolder-only helper file.\n  const packagedGitignore = resolve(templatesRoot, \"scaffold\", `${basename(source)}.gitignore`);\n  if (existsSync(packagedGitignore)) {\n    writeFileSync(resolve(destination, \".gitignore\"), render(readFileSync(packagedGitignore, \"utf8\"), name, manager, packageId));\n  }\n}\n\nfunction packageCommand(manager: PackageManager, operation: \"install\" | \"contract\" | \"cf-typegen\"): [string, string[]] {\n  if (operation === \"install\") return [manager, [\"install\"]];\n  return [manager, [\"run\", operation]];\n}\n\nconst androidDesugaring = `// flutter_local_notifications requires desugaring in the application module.\n// A library plugin cannot enable this compiler setting transitively.\nandroid {\n    compileOptions {\n        isCoreLibraryDesugaringEnabled = true\n    }\n}\n\ndependencies {\n    coreLibraryDesugaring(\"com.android.tools:desugar_jdk_libs:2.1.4\")\n}`;\n\nfunction enableAndroidCoreLibraryDesugaring(appRoot: string): void {\n  const gradlePath = resolve(appRoot, \"android/app/build.gradle.kts\");\n  const gradle = readFileSync(gradlePath, \"utf8\");\n  if (!gradle.includes('id(\"com.android.application\")')) {\n    throw new Error(`Flutter created an unexpected Android application build file: ${gradlePath}`);\n  }\n  const settingExists = gradle.includes(\"isCoreLibraryDesugaringEnabled\");\n  const dependencyExists = gradle.includes(\"coreLibraryDesugaring(\");\n  if (settingExists && dependencyExists) return;\n  if (settingExists || dependencyExists) {\n    throw new Error(`Flutter created an incomplete Android core library desugaring configuration: ${gradlePath}`);\n  }\n  appendFileSync(gradlePath, `${gradle.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\"}${androidDesugaring}\\n`);\n}\n\n// A second top-level `android { }` block is valid Gradle Kotlin DSL, since Gradle\n// merges repeated extension-configuration blocks in one file, which is what\n// lets this stay a pure append, same as the desugaring block above. A second\n// top-level `plugins { }` block is NOT valid (Gradle allows exactly one per\n// script), which is why the Crashlytics Gradle plugin registration,\n// `flutterfire configure`'s own territory, is deliberately left alone here.\n//\n// `Properties` needs a real `import`, prepended separately below. A\n// fully-qualified `java.util.Properties()` reference here was tried first,\n// to avoid needing to touch the top of the file at all, but fails to\n// resolve under AGP 9's Kotlin DSL script compilation\n// (`flutter create`'s current default): \"Unresolved reference 'util'\".\n// Confirmed by actually building a scaffolded project, not just reading it.\nconst androidReleaseSigning = `val releaseKeyProperties: Map<String, String> =\n    rootProject.file(\"key.properties\")\n        .takeIf { it.exists() }\n        ?.readLines()\n        ?.map { it.trim() }\n        ?.filter { it.isNotEmpty() && !it.startsWith(\"#\") && it.contains(\"=\") }\n        ?.associate { it.substringBefore(\"=\").trim() to it.substringAfter(\"=\").trim() }\n        .orEmpty()\n\nandroid {\n    signingConfigs {\n        create(\"release\") {\n            storeFile = releaseKeyProperties[\"storeFile\"]?.let { file(it) }\n            storePassword = releaseKeyProperties[\"storePassword\"]\n            keyAlias = releaseKeyProperties[\"keyAlias\"]\n            keyPassword = releaseKeyProperties[\"keyPassword\"]\n        }\n    }\n    buildTypes {\n        release {\n            signingConfig = if (releaseKeyProperties[\"storeFile\"] != null)\n                signingConfigs.getByName(\"release\")\n            else\n                signingConfigs.getByName(\"debug\")\n            isMinifyEnabled = true\n            isShrinkResources = true\n            proguardFiles(\n                getDefaultProguardFile(\"proguard-android-optimize.txt\"),\n                \"proguard-rules.pro\",\n            )\n        }\n    }\n}`;\n\nfunction enableAndroidReleaseSigning(appRoot: string): void {\n  const gradlePath = resolve(appRoot, \"android/app/build.gradle.kts\");\n  const gradle = readFileSync(gradlePath, \"utf8\");\n  // Not `gradle.includes(\"signingConfigs\")`, because Flutter's own template already\n  // contains that substring (`signingConfig = signingConfigs.getByName(\"debug\")`),\n  // so that check would always short-circuit and never append anything.\n  if (gradle.includes(\"releaseKeyProperties\")) return;\n  // A pure append. This previously also PREPENDED `import java.util.Properties`,\n  // because Kotlin requires imports before every other top-level declaration,\n  // which meant reaching into the very start of a file this scaffolder does\n  // not own, the most position-dependent edit here and the one already broken\n  // once by an AGP upgrade. Parsing `key.properties` with the Kotlin stdlib\n  // needs no import, so the edit is now append-only and cannot collide with\n  // whatever Flutter or `flutterfire configure` writes above it.\n  appendFileSync(gradlePath, `${gradle.endsWith(\"\\n\") ? \"\" : \"\\n\"}${androidReleaseSigning}\\n`);\n}\n\n// `flutter_launcher_icons`/`flutter_native_splash` read these as plain\n// top-level pubspec keys, so appending is safe regardless of what\n// `flutter create` already wrote under `flutter:`. Deliberately omits\n// `ios`/`macos`, since `scaffoldGame` only creates `--platforms android,web`, and\n// `flutter_launcher_icons` errors if told to target a platform whose\n// directory doesn't exist.\n// The colours are the EigenInteractive palette (ink #1B1E24, paper #F4F1EA) because the\n// shipped placeholder art is the EigenInteractive mark: the adaptive foreground is the\n// reversed, light-on-dark variant, so an ink background is what makes it\n// legible. Rebranding a game means replacing the four PNGs *and* these\n// colours together. See https://eigeninteractive.com/docs/ship-it/branding.\nconst launcherIconsAndSplashConfig = `\nflutter_launcher_icons:\n  android: true\n  web:\n    generate: true\n    image_path: \"assets/icon/icon.png\"\n  image_path: \"assets/icon/icon.png\"\n  adaptive_icon_background: \"#1B1E24\"\n  adaptive_icon_foreground: \"assets/icon/icon_foreground.png\"\n  min_sdk_android: 21\n\nflutter_native_splash:\n  color: \"#F4F1EA\"\n  color_dark: \"#1B1E24\"\n  image: assets/icon/splash.png\n  image_dark: assets/icon/splash_dark.png\n  fullscreen: true\n  android_12:\n    color: \"#F4F1EA\"\n    color_dark: \"#1B1E24\"\n    image: assets/icon/splash.png\n    image_dark: assets/icon/splash_dark.png\n    icon_background_color: \"#F4F1EA\"\n    icon_background_color_dark: \"#1B1E24\"\n  web: true\n`;\n\nfunction configureLauncherIconsAndSplash(appRoot: string): void {\n  const pubspecPath = resolve(appRoot, \"pubspec.yaml\");\n  const pubspec = readFileSync(pubspecPath, \"utf8\");\n  if (pubspec.includes(\"flutter_launcher_icons:\")) return;\n  appendFileSync(pubspecPath, `${pubspec.endsWith(\"\\n\") ? \"\" : \"\\n\"}${launcherIconsAndSplashConfig}`);\n}\n\nexport interface AddContinuousIntegrationOptions {\n  directory: string;\n  /** Overrides the manager recorded in the project's own package.json. */\n  packageManager?: PackageManager;\n}\n\n/**\n * Adds the GitHub Actions workflows to an existing generated project.\n *\n * The companion to `ci: false`: a game can be built and played locally for as\n * long as its author likes, then gain the same PR gate and signed release\n * pipeline a `--ci` scaffold would have produced.\n */\nexport function addContinuousIntegration(options: AddContinuousIntegrationOptions): { root: string; files: string[] } {\n  const root = resolve(options.directory);\n  const manifestPath = resolve(root, \"package.json\");\n  if (!existsSync(manifestPath) || !existsSync(resolve(root, \"server\")) || !existsSync(resolve(root, \"app\"))) {\n    throw new Error(`not an EigenInteractive game project (expected package.json, server/ and app/): ${root}`);\n  }\n\n  const manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as {\n    name?: string;\n    scripts?: Record<string, string>;\n  };\n  const name = gameSlug(manifest.name ?? basename(root));\n\n  // The generated `contract` script embeds the manager the project was\n  // scaffolded with (`cd server && pnpm run contract && …`), which is a more\n  // reliable signal than a lockfile: it is present before anything is\n  // installed, and it is what the project actually uses.\n  const recorded = manifest.scripts?.contract?.includes(\"pnpm \") ? \"pnpm\" : manifest.scripts?.contract?.includes(\"npm \") ? \"npm\" : undefined;\n  const manager = options.packageManager ?? recorded ?? detectPackageManager() ?? \"pnpm\";\n\n  // Only `{{PACKAGE_MANAGER}}` appears in these templates, but the real\n  // package id is read back rather than reconstructed, so a project scaffolded\n  // under a different `--org` cannot be silently rewritten to `com.example`.\n  const appfile = resolve(root, \"app/fastlane/Appfile\");\n  const packageId = existsSync(appfile) ? (/package_name\\(\"([^\"]+)\"\\)/.exec(readFileSync(appfile, \"utf8\"))?.[1] ?? `com.example.${dartName(name)}`) : `com.example.${dartName(name)}`;\n\n  const workflows = resolve(root, \".github/workflows\");\n  const existing = existsSync(workflows) ? readdirSync(workflows).filter((f) => f === \"checks.yml\" || f === \"release.yml\") : [];\n  if (existing.length > 0) {\n    throw new Error(`refusing to overwrite existing workflows: ${existing.join(\", \")}`);\n  }\n\n  renderTree(resolve(templatesRoot, \"ci\"), root, name, manager, packageId);\n  return { root, files: [\".github/workflows/checks.yml\", \".github/workflows/release.yml\"] };\n}\n\n/** Asks a command a question. `ok` is \"ran and succeeded\"; a tool that is not installed and one that fails are both `false`, because neither can be used. */\nexport type Probe = (command: string, args: string[]) => { ok: boolean; stdout: string };\n\nconst probeCommand: Probe = (command, args) => {\n  try {\n    return { ok: true, stdout: execFileSync(command, args, { encoding: \"utf8\", stdio: [\"ignore\", \"pipe\", \"ignore\"] }) };\n  } catch {\n    return { ok: false, stdout: \"\" };\n  }\n};\n\n/** One thing standing between this machine and a configured Firebase project, and the single command that clears it. */\nexport interface FirebaseProblem {\n  /** Said as a sentence fragment, so it reads after \"Firebase is not set up here:\". */\n  reason: string;\n  /** The one command that fixes this, and nothing else. */\n  fix: string;\n}\n\nexport type FirebaseReadiness = { ready: true } | { ready: false; problems: FirebaseProblem[] };\n\n/**\n * Whether this machine can configure Firebase, asked *before* the scaffold\n * rather than after it.\n *\n * `configure_firebase` runs the same three checks and is the authority on\n * them; this one exists only to move the answer earlier. Learning that\n * `flutterfire` is missing costs nothing here and costs two minutes of Flutter\n * and pub at the far end, which is where the step actually runs.\n *\n * Every problem, not the first one. The checks are independent (two CLIs from\n * two ecosystems, plus a sign-in) so short-circuiting turns one setup into a\n * sequence of runs that each reveal the next missing piece. Reported in the\n * order they have to be fixed in: the CLI, then the sign-in it stores, then\n * the bridge that consumes both.\n *\n * The sign-in check fails open, for the same reason it does there: only an\n * answer that positively reports no accounts counts as \"no\", so a `firebase`\n * that errors or grows a different output shape is left to the command that\n * actually needs the credentials.\n */\nexport function firebaseReadiness(probe: Probe = probeCommand): FirebaseReadiness {\n  const problems: FirebaseProblem[] = [];\n\n  if (probe(\"firebase\", [\"--version\"]).ok) {\n    if (signedOut(probe)) problems.push({ reason: \"no Google account is signed in to the Firebase CLI\", fix: \"firebase login\" });\n  } else {\n    // Nothing to say about the sign-in: the CLI that would answer is the one\n    // that is missing, and `firebase login` is what installing leads to anyway.\n    // Google's own installer, which picks a standalone binary or npm to suit\n    // the machine. `npm install -g firebase-tools` also works and is what this\n    // used to print, but it needs a global npm prefix the reader may not have\n    // write access to, and it is not the install the Firebase docs lead with.\n    problems.push({ reason: \"the `firebase` CLI is not installed\", fix: \"curl -sL https://firebase.tools | bash\" });\n  }\n\n  if (!probe(\"flutterfire\", [\"--version\"]).ok) {\n    problems.push({ reason: \"the `flutterfire` CLI is not installed\", fix: \"dart pub global activate flutterfire_cli\" });\n  }\n\n  return problems.length === 0 ? { ready: true } : { ready: false, problems };\n}\n\n/**\n * Whether the Firebase CLI holds no credentials.\n *\n * `login:list --json` prints the stored refresh and access tokens along with\n * the account list. Read the shape, count the entries, and never surface the\n * output: not in a warning, not in a captured stream, not on the failure\n * path. That is why this returns a boolean rather than the response.\n */\nfunction signedOut(probe: Probe): boolean {\n  const accounts = probe(\"firebase\", [\"login:list\", \"--json\"]);\n  if (!accounts.ok) return false;\n  try {\n    const { result } = JSON.parse(accounts.stdout) as { result?: unknown };\n    return Array.isArray(result) && result.length === 0;\n  } catch {\n    // Unparseable is not evidence of anything.\n    return false;\n  }\n}\n\n/**\n * Whether the scaffold would land inside a repository that already exists.\n *\n * Asked of the nearest ancestor that exists, because the destination does not\n * yet. The point is not to change what {@link scaffoldGame} does, which already\n * declines to nest a repository, but to stop the CLI asking a question whose\n * answer cannot matter.\n */\n/**\n * Why this destination cannot be scaffolded into, said as a whole message, or\n * `undefined` when there is nothing in the way.\n *\n * A directory that exists and is *empty* is not in the way, since people make\n * one out of habit, so it is removed and rewritten rather than refused over\n * nothing. Anything with contents in it is refused, and a cloned repository is\n * not an exception: `.git` is in the way like any other entry, and the message\n * names it. Publishing into one would mean parking `.git`, renaming staging\n * over the top and putting it back, with a failure in the middle able to\n * orphan a remote, which is a lot of care to spend on a flow that has a\n * one-line alternative.\n *\n * Refused, and deliberately not offered as a \"remove it and continue?\"\n * question, which is where several scaffolders in this family go. This one\n * writes ninety-odd files and runs `flutter create`; the cost of getting that\n * answer wrong against a mistyped path has no upper bound, and `rm -rf` is one\n * command that belongs to the person who can see what is in there. Every other\n * question this CLI asks is reversible. This one would not be.\n *\n * Exported so the CLI can ask it before the first question rather than after\n * the last one. {@link scaffoldGame} asks it again, for callers that are not\n * the CLI.\n */\nexport function destinationProblem(directory: string): string | undefined {\n  const root = resolve(directory);\n  if (!existsSync(root)) return undefined;\n\n  if (!statSync(root).isDirectory()) return `${root} already exists, and is a file.`;\n\n  const entries = readdirSync(root);\n  if (entries.length === 0) return undefined;\n\n  // Named, not counted. \"not empty\" invites an `ls`; the three that are\n  // actually there usually settle whether this was the wrong path or a\n  // directory that has already been scaffolded once.\n  const shown = entries.slice(0, 3).sort().join(\", \");\n  const rest = entries.length > 3 ? `, and ${entries.length - 3} more` : \"\";\n  return `${root} already exists, and is not empty: it holds ${shown}${rest}.\\n\\nScaffold somewhere else, or clear it out yourself. This will not delete a directory you already had.`;\n}\n\nexport function insideWorkTree(directory: string, probe: Probe = probeCommand): boolean {\n  let candidate = resolve(directory);\n  while (!existsSync(candidate)) {\n    const parent = dirname(candidate);\n    if (parent === candidate) return false;\n    candidate = parent;\n  }\n  return probe(\"git\", [\"-C\", candidate, \"rev-parse\", \"--is-inside-work-tree\"]).ok;\n}\n\n/**\n * Runs the Flutter client's `configure_firebase` against the generated app.\n *\n * The command owns everything about how Firebase is configured: which\n * platforms, which CLIs must exist, whether anyone is signed in, and what to\n * do when no project has been chosen yet. This only decides *when*: before the\n * scaffold commit, so a configured project is committed configured.\n *\n * Not fatal. Every failure here (a missing `flutterfire`, no Google login, a\n * cancelled picker) leaves a complete and usable project that is exactly what\n * a scaffold without `--firebase` produces, so it warns with the command to\n * re-run and lets the commit happen.\n */\nfunction configureFirebase(appRoot: string, project: boolean | string, run: Runner, reporter: Reporter): \"configured\" | \"failed\" {\n  // FlutterFire asks before overwriting `firebase_options.dart`, and the\n  // scaffold has just written one, a throwing placeholder whose entire\n  // purpose is to be replaced by this step. Answering that is a question with\n  // one right answer, so the placeholder is moved out of the way and the\n  // question never gets asked.\n  const placeholder = resolve(appRoot, \"lib/firebase_options.dart\");\n  const parked = `${placeholder}.placeholder`;\n  const parking = existsSync(placeholder);\n  if (parking) renameSync(placeholder, parked);\n\n  try {\n    // `dart run` compiles the package executable on first use and says so.\n    // Doing it against `--help`, which returns immediately, moves that noise\n    // into a step whose output can be captured; the real run cannot be, since\n    // FlutterFire prompts through it.\n    reporter.step(\"Preparing the Firebase configurator\", () => run(\"dart\", [\"run\", \"eigen_flutter:configure_firebase\", \"--help\"], appRoot));\n    // `--worker` is what makes this fill in `FIREBASE_PROJECT_ID` as well as\n    // the app's own values. An app-only repository omits it and gets the app\n    // half; a combined scaffold has the Worker one directory over.\n    reporter.handOver(\"Configuring Firebase\", () => run(\"dart\", [\"run\", \"eigen_flutter:configure_firebase\", \"--worker\", \"../server\", ...(typeof project === \"string\" ? [\"--project\", project] : [])], appRoot));\n    if (parking) rmSync(parked, { force: true });\n    return \"configured\";\n  } catch {\n    // Back only if nothing took its place. FlutterFire writes\n    // `firebase_options.dart` before the service worker configuration is\n    // derived from it, so a late failure leaves a real one that is worth more\n    // than the placeholder.\n    if (parking) {\n      if (existsSync(placeholder)) rmSync(parked, { force: true });\n      else renameSync(parked, placeholder);\n    }\n    reporter.warn(\"Could not configure Firebase. The project is complete. Run `firebase:configure` yourself, then commit what it writes.\");\n    return \"failed\";\n  }\n}\n\n/**\n * Commits the scaffold, so the first `git diff` is the first game change.\n *\n * This matters more here than in a scaffolder that only writes source. The\n * bootstrap runs `flutter_launcher_icons` and `flutter_native_splash`, which\n * write generated-but-committed files across `android/`, `web/` and\n * `assets/`; without a baseline the first branding change is indistinguishable\n * from the ninety files the scaffolder happened to produce.\n *\n * Nothing here is fatal. The project is complete and valid before this runs,\n * so a missing `git`, or the unconfigured `user.email` that a fresh CI image\n * has, warns and leaves the tree alone rather than discarding a scaffold that\n * took two minutes of Flutter and pub to produce.\n */\nfunction initialiseRepository(root: string, name: string, run: Runner, reporter: Reporter): GitOutcome {\n  // Scaffolding inside an existing checkout (a monorepo, or a repository\n  // created ahead of time) is a legitimate thing to do, and a nested\n  // repository there is silent breakage: the outer `git add` records a gitlink\n  // and the app's files never leave the machine. Asked directly rather than\n  // through `run`, because it is a question, not a step.\n  try {\n    execFileSync(\"git\", [\"rev-parse\", \"--is-inside-work-tree\"], { cwd: root, stdio: \"ignore\" });\n    return \"existing\";\n  } catch {\n    // Not inside a work tree, which is the case this function is for.\n  }\n\n  try {\n    run(\"git\", [\"init\", \"--quiet\"], root);\n    run(\"git\", [\"add\", \"--all\"], root);\n  } catch {\n    reporter.warn(\"Could not initialise a git repository. The project is complete. Run `git init` yourself when ready.\");\n    return \"failed\";\n  }\n\n  try {\n    run(\"git\", [\"commit\", \"--quiet\", \"--message\", `Scaffold ${name}`], root);\n  } catch {\n    reporter.warn(`Initialised a repository and staged the scaffold, but could not commit it. Set \\`user.name\\` and \\`user.email\\`, then \\`git commit -m \"Scaffold ${name}\"\\`.`);\n    return \"failed\";\n  }\n\n  return \"committed\";\n}\n\nexport function scaffoldGame(options: ScaffoldOptions): ScaffoldResult {\n  const root = resolve(options.directory);\n  const name = gameSlug(basename(root));\n  const manager = options.packageManager ?? detectPackageManager() ?? \"pnpm\";\n  const org = options.org?.trim() || \"com.example\";\n  // Fastlane's `Appfile` names the same package the build actually produces,\n  // and the CLI shows the same one before asking.\n  const packageId = applicationId(root, org);\n  const bootstrap = options.bootstrap ?? true;\n  const reporter = options.reporter ?? plainReporter;\n  const run = options.run ?? capturingRunner(reporter);\n\n  const occupied = destinationProblem(root);\n  if (occupied !== undefined) throw new Error(occupied);\n  // Empty, or `destinationProblem` would have said so. Removed rather than\n  // scaffolded into, because the rename below publishes the staging directory\n  // *as* this path and cannot do that while something is standing there.\n  if (existsSync(root)) rmdirSync(root);\n\n  mkdirSync(dirname(root), { recursive: true });\n\n  // Build beside the destination and publish it with one rename. Failed\n  // subprocesses never leave a half-scaffolded project at the requested path.\n  const stagingRoot = mkdtempSync(resolve(dirname(root), `.${basename(root)}-`));\n  try {\n    const serverRoot = resolve(stagingRoot, \"server\");\n    const appRoot = resolve(stagingRoot, \"app\");\n\n    renderTree(resolve(templatesRoot, \"worker\"), serverRoot, name, manager, packageId);\n    renderTree(resolve(templatesRoot, \"project\"), stagingRoot, name, manager, packageId);\n    // Opt-in. release.yml wants an upload keystore and a Play service account\n    // that a brand-new project does not have, so generating it by default\n    // means a red X on main from the first push until someone sets both up.\n    // `create-eigen-game add ci` writes the same files whenever it is wanted.\n    if (options.ci) renderTree(resolve(templatesRoot, \"ci\"), stagingRoot, name, manager, packageId);\n\n    if (bootstrap) {\n      reporter.step(\"Creating the Flutter app\", () => {\n        run(\"flutter\", [\"create\", \"--empty\", \"--platforms\", \"android,web\", \"--project-name\", dartName(name), \"--org\", org, appRoot], stagingRoot);\n        enableAndroidCoreLibraryDesugaring(appRoot);\n        enableAndroidReleaseSigning(appRoot);\n      });\n    } else {\n      mkdirSync(appRoot, { recursive: true });\n    }\n    renderTree(resolve(templatesRoot, \"app-overlay\"), appRoot, name, manager, packageId);\n\n    if (bootstrap) {\n      reporter.step(\"Adding the Flutter packages\", () => {\n        configureLauncherIconsAndSplash(appRoot);\n        run(\"flutter\", [\"pub\", \"add\", `eigen_flutter@${flutterClientVersion}`, \"firebase_core@^4.9.0\", \"firebase_messaging@^16.2.2\"], appRoot);\n        run(\"flutter\", [\"pub\", \"add\", \"dev:flutter_launcher_icons\", \"dev:flutter_native_splash\"], appRoot);\n      });\n      // Actually apply the icons rather than only configuring them. Both tools\n      // write generated files (mipmaps, `web/icons/`, splash drawables and\n      // styles) that are committed, not built; leaving them unrun would ship\n      // Flutter's own blue logo until a game author happened to notice.\n      reporter.step(\"Generating the icons and splash\", () => {\n        run(\"dart\", [\"run\", \"flutter_launcher_icons\"], appRoot);\n        run(\"dart\", [\"run\", \"flutter_native_splash:create\"], appRoot);\n      });\n      const [install, installArgs] = packageCommand(manager, \"install\");\n      const [typegen, typegenArgs] = packageCommand(manager, \"cf-typegen\");\n      reporter.step(\"Installing the Worker packages\", () => {\n        run(install, installArgs, serverRoot);\n        // `worker-configuration.d.ts` is committed, and its header stamps the\n        // workerd version that produced the runtime types. `wrangler` floats\n        // on a caret and Cloudflare ships workerd about weekly, so the copy in\n        // `templates/worker` is stale for every scaffold made more than a few\n        // days after it was last regenerated, and `wrangler dev` opens by\n        // saying the types might be out of date. Regenerating against the\n        // wrangler that was just installed, rather than the one this package\n        // was built with, is what makes that true. It has to follow the server\n        // install for the same reason it is worth doing: it reads the wrangler\n        // that install resolved.\n        run(typegen, typegenArgs, serverRoot);\n        // The root holds Biome, which lints and formats both the Worker and\n        // the repository's own JSON. Installed after the server so a failure\n        // here costs the cheaper of the two.\n        run(install, installArgs, stagingRoot);\n      });\n      const [contract, contractArgs] = packageCommand(manager, \"contract\");\n      reporter.step(\"Generating the contract and payloads\", () => {\n        run(contract, contractArgs, serverRoot);\n        run(\"dart\", [\"run\", \"eigen_flutter:generate_payloads\", \"--contract\", \"../server/game-contract.json\", \"--output\", \"lib/game/generated/payloads.dart\", \"--fixtures-output\", \"test/fixtures\"], appRoot);\n      });\n    }\n\n    renameSync(stagingRoot, root);\n  } catch (error) {\n    rmSync(stagingRoot, { recursive: true, force: true });\n    throw error;\n  }\n\n  // Both steps below are deliberately outside the staging guard: the project\n  // is published by this point, and neither a Firebase project that could not\n  // be configured nor a repository that failed to initialise is a reason to\n  // delete two minutes of Flutter and pub.\n  //\n  // Firebase first, so what it writes (`firebase.json`,\n  // `android/app/google-services.json`, the real `firebase_options.dart` and\n  // `web/firebase-config.js` in place of the throwing placeholders, and\n  // FlutterFire's two Gradle edits) lands in the scaffold commit rather than\n  // arriving as the project's first diff.\n  const firebase = options.firebase ? configureFirebase(resolve(root, \"app\"), options.firebase, run, reporter) : \"skipped\";\n  // What that step settled, so the summary can name what it did not.\n  // `configure_firebase` does the writing, including into the Worker's\n  // wrangler.jsonc, which is what `--worker` above is for.\n  const link = firebase === \"configured\" ? readFirebaseLink(root) : undefined;\n  const git = (options.git ?? bootstrap) ? initialiseRepository(root, name, run, reporter) : \"skipped\";\n\n  return { root, name, git, firebase, link };\n}\n","/**\n * Where the engine range emitted into a scaffolded project comes from.\n *\n * Its own module because the two branches below execute in different worlds,\n * one only inside this repository and the other only inside a published tarball,\n * and a function whose published-only path never runs in CI is a function that\n * is not tested. `src/index.ts` uses it; the package `exports` map does not\n * expose it, so it is internal despite being importable by the tests.\n */\n\n/** The dependency whose version the scaffolder emits into the generated server. */\nexport const ENGINE_PACKAGE = \"@eigeninteractive/server\";\n\n/**\n * The engine range for a scaffolded project, from this package's own\n * `@eigeninteractive/server` devDependency.\n *\n * That number is not maintained by anyone: it is the version CI compiled the\n * templates against, because `pnpm -r typecheck` runs\n * `tsc -p templates/worker/tsconfig.json` inside this workspace. Emitting\n * anything else would mean shipping templates paired with an engine no build\n * ever saw.\n *\n * It replaced a derivation from this package's OWN version, which was correct\n * only while `create-eigen-game` sat in the `fixed` changesets group, and that\n * membership is what forced an engine-wide release for every scaffolder-only\n * change. Reading the dependency keeps the guarantee and drops the coupling.\n *\n * Two branches, because the same manifest reads differently in the two places\n * this runs:\n *\n * - **Published tarball**: pnpm rewrites `workspace:*` to the exact version\n *   while packing, so the manifest already states it (`\"0.2.0\"`), and no\n *   sibling package exists on disk to consult.\n * - **This workspace**: the manifest still says `workspace:*`, which names no\n *   version, so the sibling package is read directly.\n *\n * @param declared the raw `@eigeninteractive/server` devDependency value\n * @param readSiblingVersion consulted only for the `workspace:` protocol\n */\nexport function engineRange(declared: string | undefined, readSiblingVersion: () => string | undefined): string {\n  if (!declared) {\n    throw new Error(`create-eigen-game has no ${ENGINE_PACKAGE} devDependency, which is where the engine range it emits comes from`);\n  }\n\n  const version = declared.startsWith(\"workspace:\") ? readSiblingVersion() : declared;\n\n  if (!version) {\n    throw new Error(`create-eigen-game declares ${ENGINE_PACKAGE} as \"${declared}\" but the workspace package could not be read, so there is no engine version to emit`);\n  }\n\n  // pnpm packs `workspace:*` as a bare version, which is what makes the caret\n  // below correct. Asserting it means a change in that behaviour fails here\n  // rather than emitting something like `^^0.3.0` into a real project.\n  if (!/^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$/.test(version)) {\n    throw new Error(`expected an exact ${ENGINE_PACKAGE} version to build a range from, got \"${version}\"`);\n  }\n\n  return `^${version}`;\n}\n","/**\n * Reads the two deployment values that exist only once a Firebase project\n * does, so the closing summary can name what is still missing.\n *\n * Reading only. `configure_firebase` writes them, into `wrangler.jsonc` and\n * `app-config.json`, because it is also what a project runs later when\n * reconfiguring, and one implementation is what keeps the scaffold-time path\n * and the re-run path identical. This module exists so the summary can tell\n * the difference between \"filled in\" and \"still owed\", not to do it again.\n *\n * Its own module for the same reason `summary.ts` is: `index.ts` runs a\n * scaffold, and this is worth asserting without one. The package `exports` map\n * does not expose it.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\n/** What the Firebase step managed to settle, and what it left for the console. */\nexport interface FirebaseLink {\n  /** The project now in `wrangler.jsonc`, or null when FlutterFire recorded none. */\n  projectId: string | null;\n  /** The OAuth web client now in `app-config.json`, or null when Google sign-in is not enabled yet. */\n  googleWebClientId: string | null;\n}\n\nfunction readJson(path: string): unknown {\n  if (!existsSync(path)) return undefined;\n  try {\n    return JSON.parse(readFileSync(path, \"utf8\"));\n  } catch {\n    // A file this step only reads is never worth failing a finished scaffold\n    // for. The value counts as unset, and the summary says so.\n    return undefined;\n  }\n}\n\n/**\n * The project FlutterFire recorded for the Dart output this app uses.\n *\n * `firebase.json` is FlutterFire's own record rather than something this\n * scaffold writes, so it is read defensively: a shape that does not match is\n * treated as \"not configured\", which is the same answer as a run that never\n * happened.\n */\nexport function configuredProject(appRoot: string): string | null {\n  const record = readJson(resolve(appRoot, \"firebase.json\")) as { flutter?: { platforms?: { dart?: Record<string, { projectId?: unknown }> } } } | undefined;\n  const projectId = record?.flutter?.platforms?.dart?.[\"lib/firebase_options.dart\"]?.projectId;\n  return typeof projectId === \"string\" && projectId !== \"\" ? projectId : null;\n}\n\n/**\n * The OAuth web client id that `configure_firebase` copied into\n * `app-config.json`, when there was one to copy.\n *\n * Empty is an ordinary outcome rather than a failure. Firebase creates that\n * client when the Google sign-in provider is enabled, which is a console\n * action no CLI can perform, so a project that has never had it enabled has\n * nothing to offer here.\n */\nexport function configuredWebClientId(appRoot: string): string | null {\n  const config = readJson(resolve(appRoot, \"app-config.json\")) as Record<string, unknown> | undefined;\n  const value = config?.GOOGLE_WEB_CLIENT_ID;\n  return typeof value === \"string\" && value !== \"\" ? value : null;\n}\n\n/** What the Firebase step settled, for the summary to report. */\nexport function readFirebaseLink(root: string): FirebaseLink {\n  const appRoot = resolve(root, \"app\");\n  return { projectId: configuredProject(appRoot), googleWebClientId: configuredWebClientId(appRoot) };\n}\n"],"mappings":"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","names":["existsSync","readFileSync","resolve","resolve","readFileSync","existsSync"]}

package/dist/cli.js

@@ -9,7 +9,7 @@ import {
   normaliseTerminalWidth,
   plainReporter,
   scaffoldGame
-} from "./chunk-XTTEOV5U.js";
+} from "./chunk-X6NSW7BX.js";
 
 // src/cli.ts
 import { readFileSync } from "fs";
@@ -61,7 +61,7 @@ ${bar}  ${color.yellow(this.error ?? "")}` : "";
   const shorter = repeatsGameName(org, game) ? withoutGameName(org) : void 0;
   if (shorter !== void 0) {
     const shorten = await confirm({
-      message: `That gives ${color.yellow(`${org}.${game}`)} \u2014 the game name twice. Use ${color.green(shorter)} instead?`,
+      message: `That gives ${color.yellow(`${org}.${game}`)}, the game name twice. Use ${color.green(shorter)} instead?`,
       initialValue: true,
       input,
       output
@@ -113,6 +113,15 @@ function summarise(result, manager, workflows) {
   if (result.git === "committed") status.push(`Committed as "Scaffold ${result.name}"`);
   if (result.git === "existing") status.push("Created inside a repository you already had, so nothing was committed");
   if (result.firebase === "configured") status.push(result.git === "committed" ? "Firebase is configured, and everything it generated is in that commit" : "Firebase is configured");
+  if (result.link?.projectId != null) status.push(`FIREBASE_PROJECT_ID is set to ${result.link.projectId}, and app-config.json points at the local Worker`);
+  const remaining = [];
+  if (result.link !== void 0) {
+    if (result.link.googleWebClientId === null) {
+      remaining.push(["Enable Google sign-in", "Console > Authentication > Sign-in method"]);
+      remaining.push(["GOOGLE_WEB_CLIENT_ID", "that same page, under Web SDK configuration"]);
+    }
+    remaining.push(["FIREBASE_VAPID_KEY", "Console > Project settings > Cloud Messaging > Web configuration"]);
+  }
   const next = [
     "Write the game",
     ...columns([
@@ -130,7 +139,8 @@ function summarise(result, manager, workflows) {
       // app throws `Firebase is not configured` at launch until this has run
       // once.
       ...result.firebase === "configured" ? [] : [[`${run} firebase:configure`, "connect Firebase before the app runs"]]
-    ])
+    ]),
+    ...remaining.length === 0 ? [] : ["", "Before the app runs, from the Firebase console", ...columns(remaining), "", "  The values go in app/app-config.json. Both are public, not secrets."]
   ].join("\n");
   const footnotes = ["Docs: https://eigeninteractive.com"];
   if (!workflows) footnotes.unshift("No CI workflows yet: `create-eigen-game add workflows` writes them when shipping is the next step.");
@@ -149,8 +159,8 @@ kebab-case game slug; the CLI derives the display name, Dart package name, and
 Dart/TypeScript type prefix from it.
 
 Every option below answers a question the CLI would otherwise ask. Pass it to
-skip the question; leave it out to be asked. With no terminal to ask on \u2014 CI, a
-pipe, an agent session \u2014 an unanswered question is an error rather than a
+skip the question; leave it out to be asked. With no terminal to ask on (CI, a
+pipe, an agent session) an unanswered question is an error rather than a
 default quietly chosen for you, and the message prints the command to re-run.
 
 Options:
@@ -211,7 +221,7 @@ function greet() {
   ui.info("A game is one repository with two halves: a Cloudflare Worker that owns the rules,\nand a Flutter app for Android and the web. This writes both, wired together and\nalready playable.");
   ui.info(
     `Firebase signs your players in. The Worker verifies Firebase ID tokens to decide who
-holds a seat, and sends turn notifications through the same project \u2014 so a scaffolded
+holds a seat, and sends turn notifications through the same project, so a scaffolded
 app throws ${color2.dim("Firebase is not configured")} at launch until one is connected.
 
 It is free to start, one project serves every game you build, and this connects yours
@@ -235,7 +245,7 @@ ${color2.dim(PREREQUISITES)}`, "Set up Firebase");
 }
 function unanswered(directory, missing) {
   const command = ["npx create-eigen-game", directory, ...missing.map((question) => question.suggestion)].join(" ");
-  return [`No terminal to ask on, so every answer has to come from a flag. These were not given:`, "", ...missing.map((question) => `  ${question.flags}`), "", "That command, with each default filled in \u2014 read them before you run it:", "", `  ${command}`].join("\n");
+  return [`No terminal to ask on, so every answer has to come from a flag. These were not given:`, "", ...missing.map((question) => `  ${question.flags}`), "", "That command, with each default filled in. Read them before you run it:", "", `  ${command}`].join("\n");
 }
 function flagPair(yes, no, name) {
   if (yes === true && no === true) throw new Error(`--${name} and --no-${name} contradict each other`);
@@ -248,7 +258,7 @@ function resolveOrg(value) {
   if (!ORG.test(value)) {
     throw new Error(`invalid organization: ${value}
 
-Use reverse domain notation \u2014 two or more dot-separated segments of letters, digits and underscores, each starting with a letter, as in ${DEFAULT_ORG} or dev.yourname.games.`);
+Use reverse domain notation: two or more dot-separated segments of letters, digits and underscores, each starting with a letter, as in ${DEFAULT_ORG} or dev.yourname.games.`);
   }
   return value;
 }
@@ -271,7 +281,7 @@ function clackReporter() {
       }
     },
     handOver(label, body) {
-      log.step(`${label} ${color2.dim("\u2014 FlutterFire takes over here")}`);
+      log.step(`${label} ${color2.dim("(FlutterFire takes over here)")}`);
       interactive = true;
       try {
         return body();
@@ -303,7 +313,7 @@ async function main(args) {
       "firebase-project": { type: "string" },
       // Each negation is declared under the name it is typed with, because
       // `parseArgs` has no boolean negation of its own. `flagPair` puts the
-      // two halves back together, and the third state — neither given — is the
+      // two halves back together, and the third state, neither given, is the
       // one that matters: it is what turns the flag into a question.
       "no-firebase": { type: "boolean" },
       git: { type: "boolean" },