create-tina-app 2.1.6 → 2.1.7

package/dist/index.js

@@ -9,6 +9,19 @@ import path from "path";
 
 // src/util/textstyles.ts
 import chalk from "chalk";
+var stripAnsi = (str) => str.replace(/\]8;;[^]*/g, "").replace(/\[[0-9;]*m/g, "");
+var box = (lines, color = chalk.hex("#EC4816")) => {
+  const pad = 1;
+  const width = Math.max(...lines.map((l) => stripAnsi(l).length));
+  const rule = color("\u2500".repeat(width + pad * 2));
+  const top = `${color("\u250C")}${rule}${color("\u2510")}`;
+  const bottom = `${color("\u2514")}${rule}${color("\u2518")}`;
+  const body = lines.map((line) => {
+    const trailing = " ".repeat(width - stripAnsi(line).length);
+    return `${color("\u2502")}${" ".repeat(pad)}${line}${trailing}${" ".repeat(pad)}${color("\u2502")}`;
+  });
+  return [top, ...body, bottom].join("\n");
+};
 var TextStyles = {
   tinaOrange: chalk.hex("#EC4816"),
   link: (url) => `\x1B]8;;${url}\x07${chalk.cyan.underline(url)}\x1B]8;;\x07`,
@@ -143,18 +156,36 @@ async function updateTelemetryConfig(dir, mode) {
 
 // src/util/install.ts
 import spawn from "cross-spawn";
+var MAX_OUTPUT_CHARS = 4e3;
 function install(packageManager, verboseOutput) {
+  const command = `${packageManager} install`;
   return new Promise((resolve, reject) => {
     const child = spawn(packageManager, ["install"], {
-      stdio: verboseOutput ? "inherit" : "ignore",
+      stdio: verboseOutput ? "inherit" : ["ignore", "ignore", "pipe"],
       env: { ...process.env, ADBLOCK: "1", DISABLE_OPENCOLLECTIVE: "1" }
     });
+    let captured = "";
+    child.stderr?.on("data", (chunk) => {
+      captured = (captured + chunk.toString()).slice(-MAX_OUTPUT_CHARS);
+    });
+    child.on("error", (err) => {
+      reject(
+        new Error(`Failed to run "${command}": ${err.message}`)
+      );
+    });
     child.on("close", (code) => {
-      if (code !== 0) {
-        reject({ command: `${packageManager} install` });
+      if (code === 0) {
+        resolve();
         return;
       }
-      resolve();
+      const details = captured.trim();
+      let message = `"${command}" exited with code ${code ?? "unknown"}.`;
+      if (details) {
+        message += `
+
+${details}`;
+      }
+      reject(new Error(message));
     });
   });
 }
@@ -422,18 +453,31 @@ async function downloadTemplate(template, root, spinner) {
 }
 
 // src/util/preRunChecks.ts
-var SUPPORTED_NODE_VERSION_BOUNDS = { oldest: 20, latest: 22 };
-var SUPPORTED_NODE_VERSION_RANGE = [
-  ...Array(SUPPORTED_NODE_VERSION_BOUNDS.latest).keys()
-].map((i) => i + SUPPORTED_NODE_VERSION_BOUNDS.oldest);
-var isSupported = SUPPORTED_NODE_VERSION_RANGE.some(
-  (version2) => process.version.startsWith(`v${version2}`)
-);
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+function getSupportedMajors() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  try {
+    const { engines } = JSON.parse(
+      readFileSync(join(here, "../package.json"), "utf8")
+    );
+    return [...String(engines?.node ?? "").matchAll(/(\d+)\.x/g)].map(
+      (m) => Number(m[1])
+    );
+  } catch {
+    return [];
+  }
+}
 function preRunChecks(spinner) {
   spinner.start("Running pre-run checks...");
+  const supported = getSupportedMajors();
+  const currentMajor = Number(process.versions.node.split(".")[0]);
+  const isSupported = supported.includes(currentMajor);
   if (!isSupported) {
+    const range = supported.length ? supported.map((v) => `v${v}`).join(" or ") : "a supported LTS version";
     spinner.warn(
-      `Node ${process.version} is not supported by create-tina-app. Please update to be within v${SUPPORTED_NODE_VERSION_BOUNDS.oldest}-v${SUPPORTED_NODE_VERSION_BOUNDS.latest}. See https://nodejs.org/en/download/ for more details.`
+      `Node ${process.version} is not supported by create-tina-app. Please use ${range}. See https://nodejs.org/en/download/ for more details.`
     );
   } else {
     spinner.succeed(`Node ${process.version} is supported.`);
@@ -466,7 +510,7 @@ import { Command } from "commander";
 
 // package.json
 var name = "create-tina-app";
-var version = "2.1.6";
+var version = "2.1.7";
 
 // src/util/packageManagers.ts
 var PKG_MANAGERS = ["npm", "yarn", "pnpm", "bun"];
@@ -881,6 +925,7 @@ async function fetchPostHogConfig(endpointUrl) {
 // src/index.ts
 import { osInfo as getOsSystemInfo } from "systeminformation";
 var DISCORD_SUPPORT_URL = "https://discord.com/invite/zumN63Ybpf";
+var FAQ_URL = "https://tina.io/docs/faq";
 var posthogClient = null;
 async function initializePostHog(configEndpoint, disableGeoip) {
   let apiKey;
@@ -1231,8 +1276,17 @@ Need more help? Reach out to the TinaCMS community at ${TextStyles.link(
     await install(pkgManager, opts.verbose);
     spinner.succeed();
   } catch (err) {
-    const error = err;
-    spinner.fail(`Failed to install packages: ${error.message}`);
+    const error = err instanceof Error ? err : new Error(String(err));
+    const reason = error.message || String(err);
+    spinner.fail(`Failed to install packages: ${reason}`);
+    console.log(
+      `
+${box([
+        `${TextStyles.bold("Stuck?")} Check the TinaCMS FAQ for common install issues:`,
+        TextStyles.link(FAQ_URL)
+      ])}
+`
+    );
     packageManagerInstallationHadError = true;
     postHogCaptureError(posthogClient, userId, sessionId, error, {
       errorCode: ERROR_CODES.ERR_INSTALL_PKG_MANAGER_FAILED,

package/dist/util/install.d.ts

@@ -3,5 +3,7 @@ import { PackageManager } from './packageManagers';
  * Spawn a package manager installation.
  *
  * @returns A Promise that resolves once the installation is finished.
+ *   On failure it rejects with an `Error` whose message includes the command,
+ *   the exit code, and the tail of the captured output.
  */
 export declare function install(packageManager: PackageManager, verboseOutput: boolean): Promise<void>;

package/dist/util/textstyles.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Draw a bordered box around one or more lines so a message stands out from the
+ * surrounding log output.
+ */
+export declare const box: (lines: string[], color?: (s: string) => string) => string;
 export declare const TextStyles: {
     tinaOrange: import("chalk").ChalkInstance;
     link: (url: string) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-tina-app",
-  "version": "2.1.6",
+  "version": "2.1.7",
   "type": "module",
   "main": "dist/index.js",
   "files": [
@@ -20,7 +20,7 @@
     ]
   },
   "engines": {
-    "node": ">=18.18.0"
+    "node": "22.x || 24.x"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"