create-nexora-next 0.1.0

package/src/utils/runner.js

@@ -0,0 +1,50 @@
+import { execSync } from 'child_process'
+
+/**
+ * Run a shell command with live output, throwing on failure.
+ * @param {string} cmd
+ * @param {string} cwd
+ */
+export function run(cmd, cwd) {
+  execSync(cmd, { cwd, stdio: 'inherit' })
+}
+
+/**
+ * Run silently, capturing output. Returns stdout string.
+ * @param {string} cmd
+ * @param {string} cwd
+ */
+export function runSilent(cmd, cwd) {
+  return execSync(cmd, { cwd, stdio: 'pipe' }).toString().trim()
+}
+
+/**
+ * Returns the install command for the given package manager.
+ * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
+ * @param {string[]} deps
+ * @param {boolean} dev
+ */
+export function installCmd(pm, deps, dev = false) {
+  const flag = dev
+    ? pm === 'npm' ? '--save-dev' : '-D'
+    : ''
+  const pkgs = deps.join(' ')
+  switch (pm) {
+    case 'yarn': return `yarn add ${flag} ${pkgs}`.trim()
+    case 'pnpm': return `pnpm add ${flag} ${pkgs}`.trim()
+    case 'bun':  return `bun add ${flag} ${pkgs}`.trim()
+    default:     return `npm install ${flag} ${pkgs}`.trim()
+  }
+}
+
+/**
+ * Returns the exec command (npx / pnpx / bunx).
+ * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
+ */
+export function execCmd(pm) {
+  switch (pm) {
+    case 'pnpm': return 'pnpx'
+    case 'bun':  return 'bunx'
+    default:     return 'npx'
+  }
+}

package/src/utils/safe-step.js

@@ -0,0 +1,43 @@
+import * as p from '@clack/prompts'
+import pc from 'picocolors'
+
+/**
+ * Wraps a step function with automatic retry-on-failure UX.
+ * If the step throws, shows the error, prompts "Fix it and press Enter to retry",
+ * and loops until success or the user cancels.
+ *
+ * @param {string}   label   Human-readable step name (shown in spinner)
+ * @param {()=>Promise<void>|void} fn  The step to execute
+ */
+export async function safeStep(label, fn) {
+  while (true) {
+    const spinner = p.spinner()
+    spinner.start(label)
+    try {
+      await fn()
+      spinner.stop(pc.green(`✓ ${label}`))
+      return
+    } catch (err) {
+      spinner.stop(pc.red(`✗ ${label} failed`))
+
+      const message = err?.message || String(err)
+      p.log.error(pc.red(message))
+      p.log.warn(
+        pc.yellow(
+          `Fix the issue above, then press ${pc.bold('Enter')} to retry — or Ctrl+C to abort.`,
+        ),
+      )
+
+      const retry = await p.confirm({
+        message: 'Ready to retry?',
+        initialValue: true,
+      })
+
+      if (p.isCancel(retry) || !retry) {
+        p.cancel('Setup aborted.')
+        process.exit(1)
+      }
+      // loop again
+    }
+  }
+}

package/src/utils/writer.js

@@ -0,0 +1,38 @@
+import fs from 'fs'
+import path from 'path'
+
+/**
+ * Write content to a file, creating parent directories as needed.
+ * @param {string} filePath  Absolute path
+ * @param {string} content
+ */
+export function writeFile(filePath, content) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true })
+  fs.writeFileSync(filePath, content, 'utf8')
+}
+
+/**
+ * Append content to an existing file.
+ * @param {string} filePath  Absolute path
+ * @param {string} content
+ */
+export function appendFile(filePath, content) {
+  fs.appendFileSync(filePath, content, 'utf8')
+}
+
+/**
+ * Create a directory (and all parents) if it doesn't exist.
+ * @param {string} dirPath  Absolute path
+ */
+export function mkdir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true })
+}
+
+/**
+ * Check whether a path exists.
+ * @param {string} p
+ * @returns {boolean}
+ */
+export function exists(p) {
+  return fs.existsSync(p)
+}