gistajs 0.1.5 → 0.1.7

package/README.md

@@ -10,6 +10,7 @@ npx gistajs create my-app --starter website --no-install --no-git
 ```
 
 Today the CLI covers project creation, starter diffs, pin management, Turso provisioning, and Vercel provisioning.
+For starters that define `pnpm prep`, `gistajs create` offers to run that setup step after dependencies install.
 
 ### Diff
 
@@ -67,7 +68,7 @@ npx gistajs provision turso
 npx gistajs provision vercel
 ```
 
-The command is interactive. It asks for a shared region first, defaults new projects to Oregon, reuses the saved region on later runs, creates a Turso group in that region when needed, links Vercel when needed, and asks before overwriting existing database credentials in `.env`.
+The command is interactive. It asks for a shared region first, defaults new projects to Turso's nearest region when available, falls back to Oregon otherwise, reuses the saved `gistajs.region` on later runs, creates a Turso group in that region when needed, links Vercel when needed, and asks before overwriting existing database credentials in `.env`.
 
 ## Development
 

package/dist/bin.cjs

@@ -166,6 +166,17 @@ async function runInput(command, args, cwd, input) {
     input
   });
 }
+async function assertCommand(runFn, cwd, command, args, failureMessage) {
+  try {
+    await runFn(command, args, cwd);
+  } catch (error) {
+    let code = error.code;
+    if (code === "ENOENT") {
+      throw new Error(`Required command not found: ${command}`);
+    }
+    throw new Error(failureMessage);
+  }
+}
 async function exec(command, args, cwd, options) {
   return await new Promise((resolve2, reject) => {
     let { capture, input } = options;
@@ -273,7 +284,9 @@ var UsageError = class extends Error {
 // src/commands/create.ts
 var defaultCreateProjectDeps = {
   initGit,
-  run
+  promptConfirm,
+  run,
+  stdout: console
 };
 function parseCreateArgs(argv) {
   let options = {};
@@ -358,6 +371,9 @@ async function createProject(starter, options, deps = defaultCreateProjectDeps)
     }
     if (options.install !== false) {
       await installDependencies(root, deps.run);
+      if (await hasPrepScript(root)) {
+        await runPrepScript(root, deps);
+      }
     }
     return root;
   } finally {
@@ -420,8 +436,24 @@ async function rewritePackageName(root, projectName) {
   }
 }
 async function installDependencies(root, runCommand) {
+  await runPnpmCommand(root, runCommand, "install");
+}
+async function runPrepScript(root, deps) {
+  let shouldRun = await deps.promptConfirm("Run project setup now? (Y/n) ");
+  if (!shouldRun) return;
   try {
-    await runCommand("corepack", ["pnpm", "install"], root);
+    await runPnpmCommand(root, deps.run, "prep");
+  } catch (error) {
+    let detail = error instanceof Error ? error.message : String(error);
+    deps.stdout.log(`Warning: Project setup failed. ${detail}`);
+    deps.stdout.log(
+      `Run ${c.path(`cd ${root} && pnpm prep`)} to retry project setup.`
+    );
+  }
+}
+async function runPnpmCommand(root, runCommand, script) {
+  try {
+    await runCommand("corepack", ["pnpm", script], root);
     return;
   } catch (error) {
     if (!isCommandNotFound(error)) {
@@ -429,16 +461,22 @@ async function installDependencies(root, runCommand) {
     }
   }
   try {
-    await runCommand("pnpm", ["install"], root);
+    await runCommand("pnpm", [script], root);
   } catch (error) {
     if (!isCommandNotFound(error)) {
       throw error;
     }
     throw new Error(
-      "Could not install dependencies because neither corepack nor pnpm is available. Install Node.js with corepack enabled, or install pnpm and rerun the command."
+      `Could not run pnpm ${script} because neither corepack nor pnpm is available. Install Node.js with corepack enabled, or install pnpm and rerun the command.`
     );
   }
 }
+async function hasPrepScript(root) {
+  let path = (0, import_node_path.join)(root, "package.json");
+  let source = await (0, import_promises2.readFile)(path, "utf8");
+  let pkg = JSON.parse(source);
+  return typeof pkg.scripts?.prep === "string" && pkg.scripts.prep.length > 0;
+}
 function getErrorCode(error) {
   return error?.code;
 }
@@ -553,6 +591,8 @@ function getHelpText(command) {
       `  ${c.bold("Examples:")}`,
       `    ${c.dim("$")} gistajs create my-app`,
       `    ${c.dim("$")} gistajs create my-app --starter website`,
+      "",
+      `  Some starters offer an optional setup step after dependencies install.`,
       ""
     ].join("\n");
   }
@@ -619,6 +659,9 @@ function getHelpText(command) {
     `  ${c.bold("Examples:")}`,
     `    ${c.dim("$")} gistajs create my-app`,
     `    ${c.dim("$")} gistajs create my-app --starter website`,
+    "",
+    `  Some starters offer an optional setup step after dependencies install.`,
+    "",
     `    ${c.dim("$")} gistajs diff --latest`,
     `    ${c.dim("$")} gistajs diff --latest --stat`,
     `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001`,
@@ -797,8 +840,41 @@ function getErrorMessage(error) {
 }
 
 // src/commands/pin.ts
+var import_promises5 = require("fs/promises");
+var import_node_path4 = require("path");
+
+// src/utils/package.ts
 var import_promises4 = require("fs/promises");
 var import_node_path3 = require("path");
+async function readProjectPackage(root, readFileFn = (p, e) => (0, import_promises4.readFile)(p, e)) {
+  let path = (0, import_node_path3.join)(root, "package.json");
+  let source;
+  try {
+    source = await readFileFn(path, "utf8");
+  } catch (error) {
+    let code = error.code;
+    if (code === "ENOENT") {
+      throw new Error(
+        "No package.json found. Run this from a Gista.js project directory."
+      );
+    }
+    throw error;
+  }
+  try {
+    let pkg = JSON.parse(source);
+    if (!pkg || typeof pkg !== "object" || Array.isArray(pkg)) {
+      throw new Error("package.json must contain a JSON object");
+    }
+    return pkg;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error("Could not parse package.json in the current directory.");
+    }
+    throw error;
+  }
+}
+
+// src/commands/pin.ts
 function parsePinArgs(argv) {
   let options = {};
   for (let index = 0; index < argv.length; index += 1) {
@@ -859,35 +935,13 @@ async function writeProjectStarterPin(root, pin) {
   let parsed = splitProjectStarterPin(pin);
   let gistajs = pkg.gistajs && typeof pkg.gistajs === "object" && !Array.isArray(pkg.gistajs) ? { ...pkg.gistajs } : {};
   gistajs.pin = parsed.pin;
-  await (0, import_promises4.writeFile)(
-    (0, import_node_path3.join)(root, "package.json"),
+  await (0, import_promises5.writeFile)(
+    (0, import_node_path4.join)(root, "package.json"),
     `${JSON.stringify({ ...pkg, gistajs }, null, 2)}
 `
   );
   return parsed;
 }
-async function readProjectPackage(root) {
-  let path = (0, import_node_path3.join)(root, "package.json");
-  let source;
-  try {
-    source = await (0, import_promises4.readFile)(path, "utf8");
-  } catch (error) {
-    if (error?.code === "ENOENT") {
-      throw new Error(`Could not find package.json in ${root}`);
-    }
-    throw error;
-  }
-  try {
-    let pkg = JSON.parse(source);
-    if (!pkg || typeof pkg !== "object" || Array.isArray(pkg)) {
-      throw new Error("package.json must contain a JSON object");
-    }
-    return pkg;
-  } catch (error) {
-    let message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Invalid package.json: ${message}`);
-  }
-}
 
 // src/providers/regions.ts
 var sharedRegions = [
@@ -931,11 +985,6 @@ function getSharedRegion(value) {
 function getDefaultSharedRegion() {
   return getSharedRegion(defaultSharedRegionId);
 }
-function parseSharedRegion(value) {
-  let normalized = value.trim().toLowerCase();
-  if (!normalized) return null;
-  return getSharedRegion(normalized);
-}
 
 // src/utils/version.ts
 function satisfiesVersion(version, range) {
@@ -1065,7 +1114,7 @@ async function runProviderProvision(provider, deps) {
   if (provider !== "turso" && provider !== "vercel") {
     throw new UsageError(`Unknown provider: ${provider}`, "provision");
   }
-  let pkg = await readProjectPackage2(deps);
+  let pkg = await readProvisionPackage(deps);
   let region = await resolveProjectRegion(pkg, deps);
   await writeProjectRegion(pkg, region.id, deps);
   if (provider === "turso") {
@@ -1078,7 +1127,7 @@ async function runProviderProvision(provider, deps) {
   }
 }
 async function runProjectProvision(deps) {
-  let pkg = await readProjectPackage2(deps);
+  let pkg = await readProvisionPackage(deps);
   let providers = pkg.gistajs?.providers;
   if (!providers?.length) {
     throw new Error(
@@ -1116,23 +1165,8 @@ async function runProjectProvision(deps) {
   }
   printSummary(summary, deps);
 }
-async function readProjectPackage2(deps) {
-  let path = `${deps.cwd}/package.json`;
-  try {
-    let file = await deps.readFile(path, "utf8");
-    return JSON.parse(file);
-  } catch (error) {
-    let code = error.code;
-    if (code === "ENOENT") {
-      throw new Error(
-        "No package.json found. Run this from a Gista.js project directory."
-      );
-    }
-    if (error instanceof SyntaxError) {
-      throw new Error("Could not parse package.json in the current directory.");
-    }
-    throw error;
-  }
+async function readProvisionPackage(deps) {
+  return await readProjectPackage(deps.cwd, deps.readFile);
 }
 async function writeProjectRegion(pkg, region, deps) {
   let nextPkg = {
@@ -1161,7 +1195,7 @@ async function resolveProjectRegion(pkg, deps) {
   }
   while (true) {
     let answer = await deps.promptText(`Region (${fallback.label}): `);
-    let selected = parseSharedRegion(answer.trim() || fallback.id);
+    let selected = getSharedRegion(answer.trim() || fallback.id);
     if (selected) return selected;
     deps.stdout.log(`Invalid region. Choose from: ${labels}`);
   }
@@ -1194,21 +1228,50 @@ function assertCliVersion(version, range) {
 }
 
 // src/utils/deps.ts
-var import_promises7 = require("fs/promises");
+var import_promises8 = require("fs/promises");
 var import_node_process5 = __toESM(require("process"), 1);
 
 // src/providers/turso.ts
-var import_promises5 = require("fs/promises");
-var import_node_path4 = require("path");
+var import_promises6 = require("fs/promises");
+var import_node_path5 = require("path");
 var import_node_process3 = __toESM(require("process"), 1);
+
+// src/utils/env.ts
+function getEnvVar(file, key) {
+  return file.match(new RegExp(`^${key}=(.*)$`, "m"))?.[1]?.trim() ?? "";
+}
+function setEnvVar(file, key, value) {
+  if (file.match(new RegExp(`^${key}=.*$`, "m"))) {
+    return file.replace(new RegExp(`^${key}=.*$`, "m"), `${key}=${value}`);
+  }
+  return `${file.trimEnd()}
+${key}=${value}
+`;
+}
+function getRequiredEnvVar(file, key) {
+  let value = getEnvVar(file, key);
+  if (!value) {
+    throw new Error(
+      `Missing ${key} in .env. Provision Turso and prep the app first.`
+    );
+  }
+  return value;
+}
+
+// src/utils/table.ts
+function parseFirstColumn(table) {
+  return table.trim().split("\n").slice(1).map((line) => line.trim()).filter(Boolean).map((line) => line.split(/\s+/)[0]).filter(Boolean);
+}
+
+// src/providers/turso.ts
 var defaultDeps2 = {
   run,
   runOutput,
   promptConfirm,
   promptText,
-  readFile: import_promises5.readFile,
-  writeFile: import_promises5.writeFile,
-  cp: import_promises5.cp,
+  readFile: import_promises6.readFile,
+  writeFile: import_promises6.writeFile,
+  cp: import_promises6.cp,
   stdout: console,
   isTTY: import_node_process3.default.stdin.isTTY
 };
@@ -1218,8 +1281,8 @@ async function provisionTurso(cwd, region, deps = defaultDeps2) {
       "`gistajs provision turso` requires an interactive terminal"
     );
   }
-  let envPath = (0, import_node_path4.join)(cwd, ".env");
-  let envExamplePath = (0, import_node_path4.join)(cwd, ".env.example");
+  let envPath = (0, import_node_path5.join)(cwd, ".env");
+  let envExamplePath = (0, import_node_path5.join)(cwd, ".env.example");
   let file = await ensureEnvFile(envPath, envExamplePath, deps);
   let currentUrl = getEnvVar(file, "DB_URL");
   let currentToken = getEnvVar(file, "DB_AUTH_TOKEN");
@@ -1243,7 +1306,7 @@ async function provisionTurso(cwd, region, deps = defaultDeps2) {
     }
   }
   await assertCommand(
-    deps,
+    deps.run,
     cwd,
     "turso",
     ["auth", "status"],
@@ -1275,7 +1338,7 @@ Available orgs: ${slugs.join(", ")}`);
   let groups = parseGroupTable(
     await deps.runOutput("turso", ["group", "list"], cwd)
   );
-  let fallback = (0, import_node_path4.basename)(cwd).replaceAll(".", "-");
+  let fallback = (0, import_node_path5.basename)(cwd).replaceAll(".", "-");
   let name = "";
   while (true) {
     let dbName = await deps.promptText(`Database name (${fallback}): `);
@@ -1332,31 +1395,6 @@ async function ensureEnvFile(envPath, envExamplePath, deps) {
   deps.stdout.log("Created empty .env");
   return "";
 }
-async function assertCommand(deps, cwd, command, args, failureMessage) {
-  try {
-    await deps.run(command, args, cwd);
-  } catch (error) {
-    let code = error.code;
-    if (code === "ENOENT") {
-      throw new Error(`Required command not found: ${command}`);
-    }
-    throw new Error(failureMessage);
-  }
-}
-function getEnvVar(file, key) {
-  return file.match(new RegExp(`^${key}=(.*)$`, "m"))?.[1]?.trim() ?? "";
-}
-function setEnvVar(file, key, value) {
-  if (file.match(new RegExp(`^${key}=.*$`, "m"))) {
-    return file.replace(new RegExp(`^${key}=.*$`, "m"), `${key}=${value}`);
-  }
-  return `${file.trimEnd()}
-${key}=${value}
-`;
-}
-function parseFirstColumn(table) {
-  return table.trim().split("\n").slice(1).map((line) => line.trim()).filter(Boolean).map((line) => line.split(/\s+/)[0]).filter(Boolean);
-}
 function parseGroupTable(table) {
   return table.trim().split("\n").slice(1).map((line) => line.trim()).filter(Boolean).map((line) => {
     let parts = line.split(/\s+/);
@@ -1386,14 +1424,14 @@ function matchesRegion(location, region) {
 
 // src/providers/vercel.ts
 var import_node_fs = require("fs");
-var import_promises6 = require("fs/promises");
-var import_node_path5 = require("path");
+var import_promises7 = require("fs/promises");
+var import_node_path6 = require("path");
 var import_node_process4 = __toESM(require("process"), 1);
 var defaultDeps3 = {
   run,
   runInput,
   runOutput,
-  readFile: import_promises6.readFile,
+  readFile: import_promises7.readFile,
   existsSync: import_node_fs.existsSync,
   stdout: console,
   isTTY: import_node_process4.default.stdin.isTTY
@@ -1405,23 +1443,23 @@ async function provisionVercel(cwd, region, deps = defaultDeps3) {
       "`gistajs provision vercel` requires an interactive terminal"
     );
   }
-  await assertCommand2(
-    deps,
+  await assertCommand(
+    deps.run,
     cwd,
     "vercel",
     ["whoami"],
     "Not logged in. Run `vercel login` first."
   );
-  if (!deps.existsSync((0, import_node_path5.join)(cwd, ".vercel", "project.json"))) {
+  if (!deps.existsSync((0, import_node_path6.join)(cwd, ".vercel", "project.json"))) {
     deps.stdout.log("Linking this directory to a Vercel project...");
     await deps.run("vercel", ["link"], cwd);
   }
   deps.stdout.log(`Setting the Vercel function region to ${region.label}...`);
   await deps.run("vercel", ["--regions", region.vercel], cwd);
-  let envPath = (0, import_node_path5.join)(cwd, ".env");
+  let envPath = (0, import_node_path6.join)(cwd, ".env");
   let file = await readEnvFile(envPath, deps);
   let values = requiredEnvVars.map((key) => [key, getRequiredEnvVar(file, key)]);
-  let existing = parseFirstColumn2(
+  let existing = parseFirstColumn(
     await deps.runOutput("vercel", ["env", "ls", "production"], cwd)
   );
   for (let [key, value] of values) {
@@ -1447,29 +1485,6 @@ async function readEnvFile(envPath, deps) {
     throw error;
   }
 }
-async function assertCommand2(deps, cwd, command, args, failureMessage) {
-  try {
-    await deps.run(command, args, cwd);
-  } catch (error) {
-    let code = error.code;
-    if (code === "ENOENT") {
-      throw new Error(`Required command not found: ${command}`);
-    }
-    throw new Error(failureMessage);
-  }
-}
-function getRequiredEnvVar(file, key) {
-  let value = file.match(new RegExp(`^${key}=(.*)$`, "m"))?.[1]?.trim();
-  if (!value) {
-    throw new Error(
-      `Missing ${key} in .env. Provision Turso and prep the app first.`
-    );
-  }
-  return value;
-}
-function parseFirstColumn2(table) {
-  return table.trim().split("\n").slice(1).map((line) => line.trim()).filter(Boolean).map((line) => line.split(/\s+/)[0]).filter(Boolean);
-}
 
 // src/utils/catalog.ts
 var DEFAULT_CATALOG_URL = "https://gistajs.com/manifests/starters.json";
@@ -1506,7 +1521,7 @@ async function readCliVersion() {
   if (false) {
     throw new Error("Could not resolve the installed gistajs version");
   }
-  return "0.1.4";
+  return "0.1.7";
 }
 async function readDefaultProvisionRegion() {
   try {
@@ -1530,8 +1545,8 @@ var defaultDeps4 = {
   promptForStarter,
   promptConfirm,
   promptText,
-  readFile: import_promises7.readFile,
-  writeFile: import_promises7.writeFile,
+  readFile: import_promises8.readFile,
+  writeFile: import_promises8.writeFile,
   stdout: console,
   cwd: import_node_process5.default.cwd(),
   getCliVersion: readCliVersion,

package/dist/index.d.ts

@@ -69,7 +69,9 @@ declare function readGitConfig(cwd: string, key: string): string;
 
 type CreateProjectDeps = {
     initGit: typeof initGit;
+    promptConfirm: typeof promptConfirm;
     run: typeof run;
+    stdout: Pick<typeof console, 'log'>;
 };
 declare function createProject(starter: StarterSpec, options: CreateOptions, deps?: CreateProjectDeps): Promise<string>;
 

package/dist/index.js

@@ -151,6 +151,17 @@ async function runInput(command, args, cwd, input) {
     input
   });
 }
+async function assertCommand(runFn, cwd, command, args, failureMessage) {
+  try {
+    await runFn(command, args, cwd);
+  } catch (error) {
+    let code = error.code;
+    if (code === "ENOENT") {
+      throw new Error(`Required command not found: ${command}`);
+    }
+    throw new Error(failureMessage);
+  }
+}
 async function exec(command, args, cwd, options) {
   return await new Promise((resolve2, reject) => {
     let { capture, input } = options;
@@ -258,7 +269,9 @@ var UsageError = class extends Error {
 // src/commands/create.ts
 var defaultCreateProjectDeps = {
   initGit,
-  run
+  promptConfirm,
+  run,
+  stdout: console
 };
 function parseCreateArgs(argv) {
   let options = {};
@@ -343,6 +356,9 @@ async function createProject(starter, options, deps = defaultCreateProjectDeps)
     }
     if (options.install !== false) {
       await installDependencies(root, deps.run);
+      if (await hasPrepScript(root)) {
+        await runPrepScript(root, deps);
+      }
     }
     return root;
   } finally {
@@ -405,8 +421,24 @@ async function rewritePackageName(root, projectName) {
   }
 }
 async function installDependencies(root, runCommand) {
+  await runPnpmCommand(root, runCommand, "install");
+}
+async function runPrepScript(root, deps) {
+  let shouldRun = await deps.promptConfirm("Run project setup now? (Y/n) ");
+  if (!shouldRun) return;
+  try {
+    await runPnpmCommand(root, deps.run, "prep");
+  } catch (error) {
+    let detail = error instanceof Error ? error.message : String(error);
+    deps.stdout.log(`Warning: Project setup failed. ${detail}`);
+    deps.stdout.log(
+      `Run ${c.path(`cd ${root} && pnpm prep`)} to retry project setup.`
+    );
+  }
+}
+async function runPnpmCommand(root, runCommand, script) {
   try {
-    await runCommand("corepack", ["pnpm", "install"], root);
+    await runCommand("corepack", ["pnpm", script], root);
     return;
   } catch (error) {
     if (!isCommandNotFound(error)) {
@@ -414,16 +446,22 @@ async function installDependencies(root, runCommand) {
     }
   }
   try {
-    await runCommand("pnpm", ["install"], root);
+    await runCommand("pnpm", [script], root);
   } catch (error) {
     if (!isCommandNotFound(error)) {
       throw error;
     }
     throw new Error(
-      "Could not install dependencies because neither corepack nor pnpm is available. Install Node.js with corepack enabled, or install pnpm and rerun the command."
+      `Could not run pnpm ${script} because neither corepack nor pnpm is available. Install Node.js with corepack enabled, or install pnpm and rerun the command.`
     );
   }
 }
+async function hasPrepScript(root) {
+  let path = join(root, "package.json");
+  let source = await readFile(path, "utf8");
+  let pkg = JSON.parse(source);
+  return typeof pkg.scripts?.prep === "string" && pkg.scripts.prep.length > 0;
+}
 function getErrorCode(error) {
   return error?.code;
 }
@@ -538,6 +576,8 @@ function getHelpText(command) {
       `  ${c.bold("Examples:")}`,
       `    ${c.dim("$")} gistajs create my-app`,
       `    ${c.dim("$")} gistajs create my-app --starter website`,
+      "",
+      `  Some starters offer an optional setup step after dependencies install.`,
       ""
     ].join("\n");
   }
@@ -604,6 +644,9 @@ function getHelpText(command) {
     `  ${c.bold("Examples:")}`,
     `    ${c.dim("$")} gistajs create my-app`,
     `    ${c.dim("$")} gistajs create my-app --starter website`,
+    "",
+    `  Some starters offer an optional setup step after dependencies install.`,
+    "",
     `    ${c.dim("$")} gistajs diff --latest`,
     `    ${c.dim("$")} gistajs diff --latest --stat`,
     `    ${c.dim("$")} gistajs diff auth 2026-03-28-001 2026-03-29-001`,
@@ -782,8 +825,41 @@ function getErrorMessage(error) {
 }
 
 // src/commands/pin.ts
-import { readFile as readFile2, writeFile as writeFile2 } from "fs/promises";
+import { writeFile as writeFile2 } from "fs/promises";
+import { join as join4 } from "path";
+
+// src/utils/package.ts
+import { readFile as readFile2 } from "fs/promises";
 import { join as join3 } from "path";
+async function readProjectPackage(root, readFileFn = (p, e) => readFile2(p, e)) {
+  let path = join3(root, "package.json");
+  let source;
+  try {
+    source = await readFileFn(path, "utf8");
+  } catch (error) {
+    let code = error.code;
+    if (code === "ENOENT") {
+      throw new Error(
+        "No package.json found. Run this from a Gista.js project directory."
+      );
+    }
+    throw error;
+  }
+  try {
+    let pkg = JSON.parse(source);
+    if (!pkg || typeof pkg !== "object" || Array.isArray(pkg)) {
+      throw new Error("package.json must contain a JSON object");
+    }
+    return pkg;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error("Could not parse package.json in the current directory.");
+    }
+    throw error;
+  }
+}
+
+// src/commands/pin.ts
 function parsePinArgs(argv) {
   let options = {};
   for (let index = 0; index < argv.length; index += 1) {
@@ -845,34 +921,12 @@ async function writeProjectStarterPin(root, pin) {
   let gistajs = pkg.gistajs && typeof pkg.gistajs === "object" && !Array.isArray(pkg.gistajs) ? { ...pkg.gistajs } : {};
   gistajs.pin = parsed.pin;
   await writeFile2(
-    join3(root, "package.json"),
+    join4(root, "package.json"),
     `${JSON.stringify({ ...pkg, gistajs }, null, 2)}
 `
   );
   return parsed;
 }
-async function readProjectPackage(root) {
-  let path = join3(root, "package.json");
-  let source;
-  try {
-    source = await readFile2(path, "utf8");
-  } catch (error) {
-    if (error?.code === "ENOENT") {
-      throw new Error(`Could not find package.json in ${root}`);
-    }
-    throw error;
-  }
-  try {
-    let pkg = JSON.parse(source);
-    if (!pkg || typeof pkg !== "object" || Array.isArray(pkg)) {
-      throw new Error("package.json must contain a JSON object");
-    }
-    return pkg;
-  } catch (error) {
-    let message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Invalid package.json: ${message}`);
-  }
-}
 
 // src/providers/regions.ts
 var sharedRegions = [
@@ -916,11 +970,6 @@ function getSharedRegion(value) {
 function getDefaultSharedRegion() {
   return getSharedRegion(defaultSharedRegionId);
 }
-function parseSharedRegion(value) {
-  let normalized = value.trim().toLowerCase();
-  if (!normalized) return null;
-  return getSharedRegion(normalized);
-}
 
 // src/utils/version.ts
 function satisfiesVersion(version, range) {
@@ -1050,7 +1099,7 @@ async function runProviderProvision(provider, deps) {
   if (provider !== "turso" && provider !== "vercel") {
     throw new UsageError(`Unknown provider: ${provider}`, "provision");
   }
-  let pkg = await readProjectPackage2(deps);
+  let pkg = await readProvisionPackage(deps);
   let region = await resolveProjectRegion(pkg, deps);
   await writeProjectRegion(pkg, region.id, deps);
   if (provider === "turso") {
@@ -1063,7 +1112,7 @@ async function runProviderProvision(provider, deps) {
   }
 }
 async function runProjectProvision(deps) {
-  let pkg = await readProjectPackage2(deps);
+  let pkg = await readProvisionPackage(deps);
   let providers = pkg.gistajs?.providers;
   if (!providers?.length) {
     throw new Error(
@@ -1101,23 +1150,8 @@ async function runProjectProvision(deps) {
   }
   printSummary(summary, deps);
 }
-async function readProjectPackage2(deps) {
-  let path = `${deps.cwd}/package.json`;
-  try {
-    let file = await deps.readFile(path, "utf8");
-    return JSON.parse(file);
-  } catch (error) {
-    let code = error.code;
-    if (code === "ENOENT") {
-      throw new Error(
-        "No package.json found. Run this from a Gista.js project directory."
-      );
-    }
-    if (error instanceof SyntaxError) {
-      throw new Error("Could not parse package.json in the current directory.");
-    }
-    throw error;
-  }
+async function readProvisionPackage(deps) {
+  return await readProjectPackage(deps.cwd, deps.readFile);
 }
 async function writeProjectRegion(pkg, region, deps) {
   let nextPkg = {
@@ -1146,7 +1180,7 @@ async function resolveProjectRegion(pkg, deps) {
   }
   while (true) {
     let answer = await deps.promptText(`Region (${fallback.label}): `);
-    let selected = parseSharedRegion(answer.trim() || fallback.id);
+    let selected = getSharedRegion(answer.trim() || fallback.id);
     if (selected) return selected;
     deps.stdout.log(`Invalid region. Choose from: ${labels}`);
   }
@@ -1184,8 +1218,37 @@ import process5 from "process";
 
 // src/providers/turso.ts
 import { cp as cp2, readFile as readFile3, writeFile as writeFile3 } from "fs/promises";
-import { basename as basename2, join as join4 } from "path";
+import { basename as basename2, join as join5 } from "path";
 import process3 from "process";
+
+// src/utils/env.ts
+function getEnvVar(file, key) {
+  return file.match(new RegExp(`^${key}=(.*)$`, "m"))?.[1]?.trim() ?? "";
+}
+function setEnvVar(file, key, value) {
+  if (file.match(new RegExp(`^${key}=.*$`, "m"))) {
+    return file.replace(new RegExp(`^${key}=.*$`, "m"), `${key}=${value}`);
+  }
+  return `${file.trimEnd()}
+${key}=${value}
+`;
+}
+function getRequiredEnvVar(file, key) {
+  let value = getEnvVar(file, key);
+  if (!value) {
+    throw new Error(
+      `Missing ${key} in .env. Provision Turso and prep the app first.`
+    );
+  }
+  return value;
+}
+
+// src/utils/table.ts
+function parseFirstColumn(table) {
+  return table.trim().split("\n").slice(1).map((line) => line.trim()).filter(Boolean).map((line) => line.split(/\s+/)[0]).filter(Boolean);
+}
+
+// src/providers/turso.ts
 var defaultDeps2 = {
   run,
   runOutput,
@@ -1203,8 +1266,8 @@ async function provisionTurso(cwd, region, deps = defaultDeps2) {
       "`gistajs provision turso` requires an interactive terminal"
     );
   }
-  let envPath = join4(cwd, ".env");
-  let envExamplePath = join4(cwd, ".env.example");
+  let envPath = join5(cwd, ".env");
+  let envExamplePath = join5(cwd, ".env.example");
   let file = await ensureEnvFile(envPath, envExamplePath, deps);
   let currentUrl = getEnvVar(file, "DB_URL");
   let currentToken = getEnvVar(file, "DB_AUTH_TOKEN");
@@ -1228,7 +1291,7 @@ async function provisionTurso(cwd, region, deps = defaultDeps2) {
     }
   }
   await assertCommand(
-    deps,
+    deps.run,
     cwd,
     "turso",
     ["auth", "status"],
@@ -1317,31 +1380,6 @@ async function ensureEnvFile(envPath, envExamplePath, deps) {
   deps.stdout.log("Created empty .env");
   return "";
 }
-async function assertCommand(deps, cwd, command, args, failureMessage) {
-  try {
-    await deps.run(command, args, cwd);
-  } catch (error) {
-    let code = error.code;
-    if (code === "ENOENT") {
-      throw new Error(`Required command not found: ${command}`);
-    }
-    throw new Error(failureMessage);
-  }
-}
-function getEnvVar(file, key) {
-  return file.match(new RegExp(`^${key}=(.*)$`, "m"))?.[1]?.trim() ?? "";
-}
-function setEnvVar(file, key, value) {
-  if (file.match(new RegExp(`^${key}=.*$`, "m"))) {
-    return file.replace(new RegExp(`^${key}=.*$`, "m"), `${key}=${value}`);
-  }
-  return `${file.trimEnd()}
-${key}=${value}
-`;
-}
-function parseFirstColumn(table) {
-  return table.trim().split("\n").slice(1).map((line) => line.trim()).filter(Boolean).map((line) => line.split(/\s+/)[0]).filter(Boolean);
-}
 function parseGroupTable(table) {
   return table.trim().split("\n").slice(1).map((line) => line.trim()).filter(Boolean).map((line) => {
     let parts = line.split(/\s+/);
@@ -1372,7 +1410,7 @@ function matchesRegion(location, region) {
 // src/providers/vercel.ts
 import { existsSync } from "fs";
 import { readFile as readFileFs } from "fs/promises";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 import process4 from "process";
 var defaultDeps3 = {
   run,
@@ -1390,23 +1428,23 @@ async function provisionVercel(cwd, region, deps = defaultDeps3) {
       "`gistajs provision vercel` requires an interactive terminal"
     );
   }
-  await assertCommand2(
-    deps,
+  await assertCommand(
+    deps.run,
     cwd,
     "vercel",
     ["whoami"],
     "Not logged in. Run `vercel login` first."
   );
-  if (!deps.existsSync(join5(cwd, ".vercel", "project.json"))) {
+  if (!deps.existsSync(join6(cwd, ".vercel", "project.json"))) {
     deps.stdout.log("Linking this directory to a Vercel project...");
     await deps.run("vercel", ["link"], cwd);
   }
   deps.stdout.log(`Setting the Vercel function region to ${region.label}...`);
   await deps.run("vercel", ["--regions", region.vercel], cwd);
-  let envPath = join5(cwd, ".env");
+  let envPath = join6(cwd, ".env");
   let file = await readEnvFile(envPath, deps);
   let values = requiredEnvVars.map((key) => [key, getRequiredEnvVar(file, key)]);
-  let existing = parseFirstColumn2(
+  let existing = parseFirstColumn(
     await deps.runOutput("vercel", ["env", "ls", "production"], cwd)
   );
   for (let [key, value] of values) {
@@ -1432,29 +1470,6 @@ async function readEnvFile(envPath, deps) {
     throw error;
   }
 }
-async function assertCommand2(deps, cwd, command, args, failureMessage) {
-  try {
-    await deps.run(command, args, cwd);
-  } catch (error) {
-    let code = error.code;
-    if (code === "ENOENT") {
-      throw new Error(`Required command not found: ${command}`);
-    }
-    throw new Error(failureMessage);
-  }
-}
-function getRequiredEnvVar(file, key) {
-  let value = file.match(new RegExp(`^${key}=(.*)$`, "m"))?.[1]?.trim();
-  if (!value) {
-    throw new Error(
-      `Missing ${key} in .env. Provision Turso and prep the app first.`
-    );
-  }
-  return value;
-}
-function parseFirstColumn2(table) {
-  return table.trim().split("\n").slice(1).map((line) => line.trim()).filter(Boolean).map((line) => line.split(/\s+/)[0]).filter(Boolean);
-}
 
 // src/utils/catalog.ts
 var DEFAULT_CATALOG_URL = "https://gistajs.com/manifests/starters.json";
@@ -1491,7 +1506,7 @@ async function readCliVersion() {
   if (false) {
     throw new Error("Could not resolve the installed gistajs version");
   }
-  return "0.1.4";
+  return "0.1.7";
 }
 async function readDefaultProvisionRegion() {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gistajs",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Scaffold and manage Gista.js starter projects",
   "keywords": [
     "cli",
@@ -53,7 +53,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc -b",
-    "release:prepare": "pnpm typecheck && pnpm build && pnpm test",
+    "release:prepare": "pnpm typecheck && pnpm test",
     "np": "pnpm release:prepare && np"
   }
 }