nestcraftx 0.2.5 → 0.3.0

package/utils/shell.js

@@ -1,32 +1,112 @@
-const { execSync } = require("child_process");
-const fs = require("fs");
-const { logError } = require("./loggers/logError");
-const { spinner } = require("./spinner");
-
-async function runCommand(command, errorMessage, spinnerText = null) {
-  const spin = spinnerText ? spinner(spinnerText) : null;
-
-  try {
-    if (spin) spin.start();
-    execSync(command, { stdio: spinnerText ? "pipe" : "inherit" });
-    if (spin) spin.succeed(spinnerText);
-  } catch (error) {
-    if (spin) spin.fail(errorMessage);
-    logError(errorMessage);
-    fs.appendFileSync(
-      "setup.log",
-      `[Erreur] ${errorMessage}: ${error.message}\n`
-    );
-    process.exit(1);
-  }
-}
-
-async function runCommandSilent(command) {
-  try {
-    return execSync(command, { stdio: "pipe" }).toString();
-  } catch (error) {
-    return null;
-  }
-}
-
-module.exports = { runCommand, runCommandSilent };
+const { execSync } = require("child_process");
+const fs = require("fs");
+const { logError } = require("./loggers/logError");
+const { logWarning } = require("./loggers/logWarning");
+const { spinner } = require("./spinner");
+const { warning, info } = require("./colors");
+
+/**
+ * Accumulated warnings collected during a generation session.
+ * Displayed as a summary at the end via printSetupWarnings().
+ */
+const _warnings = [];
+
+/**
+ * Runs a shell command synchronously.
+ *
+ * @param {string} command - The shell command to execute.
+ * @param {string} errorMessage - Human-readable error message shown on failure.
+ * @param {object} [options] - Optional configuration.
+ * @param {boolean} [options.critical=true] - If true (default), a failure calls process.exit(1).
+ *   If false, the failure is logged as a warning and execution continues.
+ * @param {string|null} [options.spinner] - Optional spinner label shown during execution.
+ * @returns {Promise<boolean>} Resolves to true on success, false on non-critical failure.
+ */
+async function runCommand(command, errorMessage, options = {}) {
+  // Support old call signature: runCommand(cmd, msg, spinnerText)
+  // New signature: runCommand(cmd, msg, { critical, spinner })
+  let critical = true;
+  let spinnerText = null;
+
+  if (typeof options === "string") {
+    // Legacy: third arg was spinnerText string
+    spinnerText = options;
+  } else if (typeof options === "object" && options !== null) {
+    critical = options.critical !== false; // default true
+    spinnerText = options.spinner || null;
+  }
+
+  const spin = spinnerText ? spinner(spinnerText) : null;
+
+  try {
+    if (spin) spin.start();
+    execSync(command, { stdio: spinnerText ? "pipe" : "inherit" });
+    if (spin) spin.succeed(spinnerText);
+    return true;
+  } catch (error) {
+    if (spin) spin.fail(errorMessage);
+
+    const logLine = `[${new Date().toISOString()}] ${errorMessage}: ${error.message}\n`;
+    fs.appendFileSync("setup.log", logLine);
+
+    if (critical) {
+      // Fatal — stop everything
+      logError(`${errorMessage}`);
+      logError(`Run: ${command}`);
+      process.exit(1);
+    } else {
+      // Non-critical — warn and continue
+      logWarning(`${errorMessage} (non-fatal, continuing...)`);
+      logWarning(`  Command: ${command}`);
+      logWarning(`  See setup.log for details`);
+      _warnings.push({ command, errorMessage });
+      return false;
+    }
+  }
+}
+
+/**
+ * Silent command — returns stdout string or null on failure. Never exits.
+ * @param {string} command
+ * @returns {string|null}
+ */
+async function runCommandSilent(command) {
+  try {
+    return execSync(command, { stdio: "pipe" }).toString();
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Prints a summary of all non-critical warnings accumulated during the session.
+ * Call this at the very end of the generation pipeline.
+ */
+function printSetupWarnings() {
+  if (_warnings.length === 0) return;
+
+  console.log(
+    `\n${warning("⚠️  Setup completed with")} ${warning(String(_warnings.length))} ${warning("warning(s):")}`,
+  );
+  _warnings.forEach((w, i) => {
+    console.log(`  ${info(`${i + 1}.`)} ${w.errorMessage}`);
+    console.log(`     ${info("Command:")} ${w.command}`);
+  });
+  console.log(
+    `\n  ${info("➜")} Full details in: ${info("setup.log")}\n`,
+  );
+}
+
+/**
+ * Clears the warnings accumulator (useful between test runs).
+ */
+function clearSetupWarnings() {
+  _warnings.length = 0;
+}
+
+module.exports = {
+  runCommand,
+  runCommandSilent,
+  printSetupWarnings,
+  clearSetupWarnings,
+};

package/utils/spinner.js

@@ -1,57 +1,57 @@
-const { info, success, error: errorColor } = require('./colors');
-
-class Spinner {
-  constructor(text = 'Loading...') {
-    this.text = text;
-    this.frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-    this.currentFrame = 0;
-    this.intervalId = null;
-    this.isSpinning = false;
-  }
-
-  start() {
-    if (this.isSpinning) return;
-
-    this.isSpinning = true;
-    this.currentFrame = 0;
-
-    process.stdout.write('\n');
-
-    this.intervalId = setInterval(() => {
-      const frame = this.frames[this.currentFrame];
-      process.stdout.write(`\r${info(frame)} ${this.text}`);
-      this.currentFrame = (this.currentFrame + 1) % this.frames.length;
-    }, 80);
-  }
-
-  stop() {
-    if (!this.isSpinning) return;
-
-    this.isSpinning = false;
-    if (this.intervalId) {
-      clearInterval(this.intervalId);
-      this.intervalId = null;
-    }
-    process.stdout.write('\r' + ' '.repeat(this.text.length + 10) + '\r');
-  }
-
-  succeed(text) {
-    this.stop();
-    console.log(success('✓') + ` ${text || this.text}`);
-  }
-
-  fail(text) {
-    this.stop();
-    console.log(errorColor('✗') + ` ${text || this.text}`);
-  }
-
-  update(text) {
-    this.text = text;
-  }
-}
-
-function spinner(text) {
-  return new Spinner(text);
-}
-
-module.exports = { Spinner, spinner };
+const { info, success, error: errorColor } = require('./colors');
+
+class Spinner {
+  constructor(text = 'Loading...') {
+    this.text = text;
+    this.frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    this.currentFrame = 0;
+    this.intervalId = null;
+    this.isSpinning = false;
+  }
+
+  start() {
+    if (this.isSpinning) return;
+
+    this.isSpinning = true;
+    this.currentFrame = 0;
+
+    process.stdout.write('\n');
+
+    this.intervalId = setInterval(() => {
+      const frame = this.frames[this.currentFrame];
+      process.stdout.write(`\r${info(frame)} ${this.text}`);
+      this.currentFrame = (this.currentFrame + 1) % this.frames.length;
+    }, 80);
+  }
+
+  stop() {
+    if (!this.isSpinning) return;
+
+    this.isSpinning = false;
+    if (this.intervalId) {
+      clearInterval(this.intervalId);
+      this.intervalId = null;
+    }
+    process.stdout.write('\r' + ' '.repeat(this.text.length + 10) + '\r');
+  }
+
+  succeed(text) {
+    this.stop();
+    console.log(success('✓') + ` ${text || this.text}`);
+  }
+
+  fail(text) {
+    this.stop();
+    console.log(errorColor('✗') + ` ${text || this.text}`);
+  }
+
+  update(text) {
+    this.text = text;
+  }
+}
+
+function spinner(text) {
+  return new Spinner(text);
+}
+
+module.exports = { Spinner, spinner };

package/utils/systemCheck.js

@@ -1,124 +1,124 @@
-const { execSync } = require("child_process");
-const fs = require("fs");
-
-function checkCommand(cmd) {
-  try {
-    execSync(`${cmd} --version`, { stdio: "pipe" });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function getVersion(cmd) {
-  try {
-    const output = execSync(`${cmd} --version`, {
-      encoding: "utf8",
-      stdio: "pipe",
-    });
-    return output.trim().split("\n")[0];
-  } catch {
-    return "not installed";
-  }
-}
-
-function checkSystemRequirements() {
-  const checks = {
-    node: {
-      installed: checkCommand("node"),
-      version: getVersion("node"),
-    },
-    npm: {
-      installed: checkCommand("npm"),
-      version: getVersion("npm"),
-    },
-    nestCli: {
-      installed: checkCommand("nest"),
-      version: getVersion("nest"),
-    },
-    git: {
-      installed: checkCommand("git"),
-      version: getVersion("git"),
-    },
-    docker: {
-      installed: checkCommand("docker"),
-      version: getVersion("docker"),
-    },
-    npx: {
-      installed: checkCommand("npx"),
-      version: "npx available",
-    },
-  };
-
-  const envExists = fs.existsSync(".env");
-
-  let postgresStatus = "not detected locally";
-  if (envExists) {
-    try {
-      const envContent = fs.readFileSync(".env", "utf8");
-      if (
-        envContent.includes("POSTGRES_") ||
-        envContent.includes("DATABASE_URL")
-      ) {
-        postgresStatus = "configured in .env";
-      }
-    } catch {}
-  }
-
-  checks.postgres = {
-    installed: false,
-    version: postgresStatus,
-  };
-
-  return checks;
-}
-
-function displaySystemCheck() {
-  console.log("\n🔍 NestCraftX System Check");
-  console.log("--------------------------------");
-
-  const checks = checkSystemRequirements();
-  let successCount = 0;
-  let totalCount = 0;
-
-  Object.entries(checks).forEach(([name, info]) => {
-    totalCount++;
-    const displayName =
-      name.charAt(0).toUpperCase() + name.slice(1).replace(/([A-Z])/g, " $1");
-
-    if (info.installed || info.version.includes("configured")) {
-      console.log(`✅ ${displayName}: ${info.version}`);
-      successCount++;
-    } else {
-      console.log(`⚠️  ${displayName}: ${info.version}`);
-    }
-  });
-
-  console.log("--------------------------------");
-
-  const status =
-    successCount === totalCount
-      ? "✅ Ready"
-      : successCount >= totalCount - 2
-      ? "⚠️  Almost Ready"
-      : "❌ Missing Requirements";
-
-  console.log(`System status: ${status} (${successCount}/${totalCount} OK)`);
-
-  if (successCount < totalCount) {
-    console.log("\n💡 Tips:");
-    if (!checks.nestCli.installed) {
-      console.log("   - Install Nest CLI: npm install -g @nestjs/cli");
-    }
-    if (!checks.docker.installed) {
-      console.log("   - Install Docker: https://docs.docker.com/get-docker/");
-    }
-    if (!checks.git.installed) {
-      console.log("   - Install Git: https://git-scm.com/downloads");
-    }
-  }
-
-  console.log("");
-}
-
-module.exports = { checkSystemRequirements, displaySystemCheck };
+const { execSync } = require("child_process");
+const fs = require("fs");
+
+function checkCommand(cmd) {
+  try {
+    execSync(`${cmd} --version`, { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getVersion(cmd) {
+  try {
+    const output = execSync(`${cmd} --version`, {
+      encoding: "utf8",
+      stdio: "pipe",
+    });
+    return output.trim().split("\n")[0];
+  } catch {
+    return "not installed";
+  }
+}
+
+function checkSystemRequirements() {
+  const checks = {
+    node: {
+      installed: checkCommand("node"),
+      version: getVersion("node"),
+    },
+    npm: {
+      installed: checkCommand("npm"),
+      version: getVersion("npm"),
+    },
+    nestCli: {
+      installed: checkCommand("nest"),
+      version: getVersion("nest"),
+    },
+    git: {
+      installed: checkCommand("git"),
+      version: getVersion("git"),
+    },
+    docker: {
+      installed: checkCommand("docker"),
+      version: getVersion("docker"),
+    },
+    npx: {
+      installed: checkCommand("npx"),
+      version: "npx available",
+    },
+  };
+
+  const envExists = fs.existsSync(".env");
+
+  let postgresStatus = "not detected locally";
+  if (envExists) {
+    try {
+      const envContent = fs.readFileSync(".env", "utf8");
+      if (
+        envContent.includes("POSTGRES_") ||
+        envContent.includes("DATABASE_URL")
+      ) {
+        postgresStatus = "configured in .env";
+      }
+    } catch {}
+  }
+
+  checks.postgres = {
+    installed: false,
+    version: postgresStatus,
+  };
+
+  return checks;
+}
+
+function displaySystemCheck() {
+  console.log("\n🔍 NestCraftX System Check");
+  console.log("--------------------------------");
+
+  const checks = checkSystemRequirements();
+  let successCount = 0;
+  let totalCount = 0;
+
+  Object.entries(checks).forEach(([name, info]) => {
+    totalCount++;
+    const displayName =
+      name.charAt(0).toUpperCase() + name.slice(1).replace(/([A-Z])/g, " $1");
+
+    if (info.installed || info.version.includes("configured")) {
+      console.log(`✅ ${displayName}: ${info.version}`);
+      successCount++;
+    } else {
+      console.log(`⚠️  ${displayName}: ${info.version}`);
+    }
+  });
+
+  console.log("--------------------------------");
+
+  const status =
+    successCount === totalCount
+      ? "✅ Ready"
+      : successCount >= totalCount - 2
+      ? "⚠️  Almost Ready"
+      : "❌ Missing Requirements";
+
+  console.log(`System status: ${status} (${successCount}/${totalCount} OK)`);
+
+  if (successCount < totalCount) {
+    console.log("\n💡 Tips:");
+    if (!checks.nestCli.installed) {
+      console.log("   - Install Nest CLI: npm install -g @nestjs/cli");
+    }
+    if (!checks.docker.installed) {
+      console.log("   - Install Docker: https://docs.docker.com/get-docker/");
+    }
+    if (!checks.git.installed) {
+      console.log("   - Install Git: https://git-scm.com/downloads");
+    }
+  }
+
+  console.log("");
+}
+
+module.exports = { checkSystemRequirements, displaySystemCheck };