create-kedge 0.9.0 → 0.10.0

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "create-kedge",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/chandeldivyam/Kedge.git",
     "directory": "packages/create-kedge"
   },
+  "engines": {
+    "node": ">=24"
+  },
   "type": "module",
   "description": "npx create-kedge my-store: a new Kedge store from the starter.",
   "bin": {

package/src/create.mjs

@@ -71,9 +71,33 @@ export function write(dir, files) {
   }
 }
 
+/**
+ * The oldest Node and pnpm a store is tested on (p0.10 §3): `kedge generate`
+ * reads with `node:sqlite` (D-039), and the template's pnpm-workspace.yaml
+ * relies on `allowBuilds` to let workerd and esbuild fetch their binaries. The
+ * clean-machine run is what proves these; every package's `engines.node` says the same.
+ */
+export const MIN_NODE = 24;
+export const MIN_PNPM = 11;
+
+/** What this machine lacks, with the one command that fixes it; null when nothing. */
+export function environmentProblem({ node, pnpm, install }) {
+  const major = (v) => Number(/^v?(\d+)\./.exec(v ?? "")?.[1] ?? 0);
+  if (major(node) < MIN_NODE)
+    return `Kedge needs Node ${MIN_NODE} or newer, and this is ${node}: install it from https://nodejs.org (or \`nvm install ${MIN_NODE}\`), then run this again`;
+  if (!install) return null;
+  if (!pnpm) return `Kedge stores install with pnpm, which isn't on the path: run \`npm install --global pnpm@${MIN_PNPM}\`, then run this again`;
+  if (major(pnpm) < MIN_PNPM)
+    return `Kedge needs pnpm ${MIN_PNPM} or newer, and this is ${pnpm}: run \`npm install --global pnpm@${MIN_PNPM}\`, then run this again`;
+  return null;
+}
+
 const USAGE = `usage: create-kedge <directory> [--name <name>] [--from-packs <dir>] [--no-install] [--no-git]`;
 
-export function main(argv, { template, run = spawnSync, log = console.log, error = console.error } = {}) {
+export function main(
+  argv,
+  { template, run = spawnSync, log = console.log, error = console.error, node = process.versions.node } = {},
+) {
   const flags = new Set(argv.filter((a) => a.startsWith("--no-")));
   const value = (f) => {
     const i = argv.indexOf(f);
@@ -85,6 +109,17 @@ export function main(argv, { template, run = spawnSync, log = console.log, error
     error(USAGE);
     return 2;
   }
+  // Before anything is written: a half-made store on a machine that can't install it helps no one.
+  const pnpm = flags.has("--no-install") ? null : run("pnpm", ["--version"], { encoding: "utf8" });
+  const problem = environmentProblem({
+    node,
+    pnpm: pnpm?.status === 0 ? String(pnpm.stdout ?? "").trim() : null,
+    install: !flags.has("--no-install"),
+  });
+  if (problem) {
+    error(problem);
+    return 1;
+  }
   const dir = resolve(target);
   if (existsSync(dir) && readdirSync(dir).length > 0) {
     error(`${dir} isn't empty`);