@fecommunity/reactpress-cli 0.1.0 → 0.2.0

package/bin/reactpress.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+
+/**
+ * ReactPress unified CLI — init, dev, build, server, docker, publish.
+ * Run without arguments for an interactive menu (Claude Code–style).
+ */
+
+const { Command } = require('commander');
+const path = require('path');
+const chalk = require('chalk');
+const { ensureOriginalCwd, getMonorepoRoot } = require('../lib/root');
+const { ensureProjectEnvironment, initMonorepoProject } = require('../lib/bootstrap');
+const { runDev } = require('../lib/dev');
+const { runApiDev } = require('../lib/api-dev');
+const { runLifecycleCommand } = require('../lib/lifecycle');
+const { runDockerCommand } = require('../lib/docker');
+const { printUnifiedStatus } = require('../lib/status');
+const { runBuild } = require('../lib/build');
+const { startApiWithPm2 } = require('../lib/pm2');
+const { runNodeScript, runReactpressCli } = require('../lib/spawn');
+const { getClientBin } = require('../lib/paths');
+const { runInteractiveLoop } = require('../ui/interactive');
+
+const rootPkg = require(path.join(getMonorepoRoot(), 'package.json'));
+
+const program = new Command();
+
+program
+  .name('reactpress')
+  .description('ReactPress 全栈 CLI — 初始化、开发、构建、部署、发布')
+  .version(rootPkg.version);
+
+program
+  .command('init')
+  .description('初始化项目 (.reactpress/config.json + .env + Docker MySQL)')
+  .argument('[directory]', '项目目录', '.')
+  .option('-f, --force', '覆盖已有配置')
+  .action(async (directory, options) => {
+    const projectRoot = path.resolve(directory);
+    process.env.REACTPRESS_ORIGINAL_CWD = projectRoot;
+    const { isMonorepoCheckout } = require('../lib/bootstrap');
+    if (isMonorepoCheckout(projectRoot)) {
+      const result = await initMonorepoProject(projectRoot, { force: !!options.force });
+      console.log(`[reactpress] ${result.message}`);
+      process.exit(result.ok ? 0 : 1);
+      return;
+    }
+    const args = ['init', directory];
+    if (options.force) args.push('--force');
+    runReactpressCli(args, { cwd: projectRoot });
+  });
+
+program
+  .command('dev')
+  .description('零配置开发: 环境检查 + toolkit 构建 + API + 前端')
+  .option('--api-only', '仅启动 API (watch)')
+  .option('--client-only', '仅启动前端')
+  .action(async (options) => {
+    const projectRoot = ensureOriginalCwd();
+    try {
+      if (options.clientOnly) {
+        await runNodeScript(getClientBin(), [], { cwd: projectRoot });
+        return;
+      }
+      if (options.apiOnly) {
+        await runApiDev(projectRoot);
+        return;
+      }
+      await runDev(projectRoot);
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
+      process.exit(err.exitCode ?? 1);
+    }
+  });
+
+const serverCmd = program.command('server').description('管理 API 服务');
+
+serverCmd
+  .command('start')
+  .description('启动 API（等待 HTTP 就绪）')
+  .option('--pm2', '使用 PM2 启动（生产）')
+  .option('--bg', '后台启动，不等待 HTTP')
+  .action(async (options) => {
+    const projectRoot = ensureOriginalCwd();
+    try {
+      if (options.pm2) {
+        await startApiWithPm2(projectRoot);
+        return;
+      }
+      const cmd = options.bg ? 'start:bg' : 'start';
+      const code = await runLifecycleCommand(cmd, projectRoot);
+      process.exit(code ?? 0);
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
+      process.exit(1);
+    }
+  });
+
+serverCmd.command('stop').description('停止 API').action(async () => {
+  const code = await runLifecycleCommand('stop', ensureOriginalCwd());
+  process.exit(code ?? 0);
+});
+
+serverCmd.command('restart').description('重启 API').action(async () => {
+  const code = await runLifecycleCommand('restart', ensureOriginalCwd());
+  process.exit(code ?? 0);
+});
+
+serverCmd.command('status').description('查看 API 状态').action(async () => {
+  await runLifecycleCommand('status', ensureOriginalCwd());
+});
+
+const clientCmd = program.command('client').description('管理前端');
+
+clientCmd
+  .command('start')
+  .description('启动 Next.js 客户端')
+  .option('--pm2', '使用 PM2 启动')
+  .action(async (options) => {
+    const args = options.pm2 ? ['--pm2'] : [];
+    await runNodeScript(getClientBin(), args, { cwd: ensureOriginalCwd() });
+  });
+
+program
+  .command('build')
+  .description('构建生产产物')
+  .option('-t, --target <target>', 'toolkit | server | client | docs | all', 'all')
+  .action(async (options) => {
+    try {
+      await runBuild(options.target, ensureOriginalCwd());
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
+      process.exit(1);
+    }
+  });
+
+const dockerCmd = program.command('docker').description('Docker 开发环境 (MySQL + nginx)');
+
+dockerCmd
+  .command('up')
+  .description('仅启动 Docker 服务并等待 MySQL')
+  .action(async () => {
+    await runDockerCommand('up', ensureOriginalCwd());
+  });
+
+dockerCmd
+  .command('down')
+  .alias('stop')
+  .description('停止 Docker 服务')
+  .action(async () => {
+    await runDockerCommand('down', ensureOriginalCwd());
+  });
+
+dockerCmd
+  .command('start')
+  .description('启动 Docker + 全栈开发 (API + 前端)')
+  .action(async () => {
+    await runDockerCommand('start', ensureOriginalCwd());
+  });
+
+dockerCmd.command('restart').description('重启 Docker 服务').action(async () => {
+  await runDockerCommand('restart', ensureOriginalCwd());
+});
+
+dockerCmd.command('status').description('查看 Docker 容器状态').action(async () => {
+  await runDockerCommand('status', ensureOriginalCwd());
+});
+
+dockerCmd
+  .command('logs [service]')
+  .description('查看 Docker 日志 (db | nginx)')
+  .action(async (service) => {
+    await runDockerCommand('logs', ensureOriginalCwd(), service ? [service] : []);
+  });
+
+program
+  .command('status')
+  .description('查看项目、API、前端、Docker 综合状态')
+  .action(async () => {
+    await printUnifiedStatus(ensureOriginalCwd());
+  });
+
+program
+  .command('publish')
+  .description('构建并发布 npm 包 (交互式)')
+  .option('--build', '仅构建所有包')
+  .option('--publish', '交互式发布')
+  .action(async (options) => {
+    const prev = process.argv.slice();
+    const args = [process.argv[0], process.argv[1]];
+    if (options.build) args.push('--build');
+    else if (options.publish) args.push('--publish');
+    else args.push('--publish');
+    process.argv = args;
+    try {
+      await require('../lib/publish').main();
+    } catch (err) {
+      console.error(chalk.red('[reactpress]'), err.message || err);
+      process.exit(1);
+    } finally {
+      process.argv = prev;
+    }
+  });
+
+program
+  .command('start')
+  .description('生产模式: 启动 API + 前端')
+  .action(async () => {
+    const projectRoot = ensureOriginalCwd();
+    const { spawn } = require('child_process');
+    const code = await runLifecycleCommand('start', projectRoot);
+    if (code !== 0) process.exit(code);
+    const child = spawn('pnpm', ['run', '--dir', './client', 'start'], {
+      stdio: 'inherit',
+      shell: true,
+      cwd: projectRoot,
+    });
+    child.on('close', (c) => process.exit(c ?? 0));
+  });
+
+program.on('--help', () => {
+  console.log('');
+  console.log(chalk.gray('示例:'));
+  console.log('  reactpress                  交互式菜单');
+  console.log('  reactpress dev              零配置全栈开发');
+  console.log('  reactpress init --force     重新初始化配置');
+  console.log('  reactpress server start     启动 API');
+  console.log('  reactpress status           综合状态');
+  console.log('  reactpress docker start     Docker + 全栈');
+  console.log('  reactpress publish          发布 npm 包');
+  console.log('');
+});
+
+async function main() {
+  const argv = process.argv.slice(2);
+  if (argv.length === 0) {
+    await runInteractiveLoop();
+    return;
+  }
+  program.parse(process.argv);
+}
+
+main().catch((err) => {
+  console.error(chalk.red('[reactpress]'), err.message || err);
+  process.exit(1);
+});

package/lib/api-dev-runner.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+const { runApiDev } = require('./api-dev');
+const { ensureOriginalCwd } = require('./root');
+
+ensureOriginalCwd();
+runApiDev();

package/lib/api-dev.js

@@ -0,0 +1,84 @@
+const { spawn, spawnSync } = require('child_process');
+const path = require('path');
+const { ensureProjectEnvironment } = require('./bootstrap');
+const { isUsingMonorepoServer } = require('./paths');
+const { getMonorepoRoot } = require('./root');
+
+let apiChild;
+
+function stopApiDev(projectRoot) {
+  if (apiChild && !apiChild.killed) {
+    apiChild.kill('SIGTERM');
+  }
+  if (!isUsingMonorepoServer()) {
+    spawnSync('pnpm', ['exec', 'reactpress-cli', 'stop'], {
+      cwd: projectRoot,
+      stdio: 'inherit',
+    });
+  }
+}
+
+function startApiDev(projectRoot) {
+  if (isUsingMonorepoServer()) {
+    console.log('[reactpress] 开发模式: server/ (nest start --watch)');
+    apiChild = spawn('pnpm', ['run', '--dir', './server', 'dev'], {
+      cwd: projectRoot,
+      stdio: 'inherit',
+      shell: true,
+      env: {
+        ...process.env,
+        REACTPRESS_ORIGINAL_CWD: projectRoot,
+      },
+    });
+  } else {
+    console.log('[reactpress] 开发模式: reactpress-cli（未找到 server/src）');
+    const start = spawnSync('pnpm', ['exec', 'reactpress-cli', 'start'], {
+      cwd: projectRoot,
+      stdio: 'inherit',
+    });
+    if (start.status !== 0) {
+      process.exit(start.status ?? 1);
+    }
+    console.log('[reactpress] API 已由 reactpress-cli 启动。');
+    process.stdin.resume();
+    return;
+  }
+
+  if (apiChild) {
+    apiChild.on('close', (code) => {
+      process.exit(code ?? 0);
+    });
+    console.log('[reactpress] 按 Ctrl+C 停止 API。');
+    console.log('[reactpress] 单独停止: reactpress server stop');
+  }
+}
+
+async function runApiDev(projectRoot = process.env.REACTPRESS_ORIGINAL_CWD || getMonorepoRoot()) {
+  try {
+    await ensureProjectEnvironment(projectRoot);
+  } catch (err) {
+    console.error('[reactpress] 环境准备失败:', err.message || err);
+    process.exit(1);
+  }
+
+  process.on('SIGINT', () => {
+    stopApiDev(projectRoot);
+    process.exit(0);
+  });
+  process.on('SIGTERM', () => {
+    stopApiDev(projectRoot);
+    process.exit(0);
+  });
+
+  startApiDev(projectRoot);
+}
+
+function getApiDevScriptPath() {
+  return path.join(__dirname, 'api-dev-runner.js');
+}
+
+module.exports = {
+  runApiDev,
+  stopApiDev,
+  getApiDevScriptPath,
+};

package/lib/bootstrap.js

@@ -0,0 +1,109 @@
+const fs = require('fs');
+const path = require('path');
+const { pathToFileURL } = require('url');
+const { getMonorepoRoot, isMonorepoCheckout } = require('./root');
+const { getCliPackageRoot } = require('./paths');
+
+async function importCliModule(relativePath) {
+  const modulePath = path.join(getCliPackageRoot(), 'dist', relativePath);
+  return import(pathToFileURL(modulePath).href);
+}
+
+async function copyTemplateFile(src, dest) {
+  await fs.promises.mkdir(path.dirname(dest), { recursive: true });
+  await fs.promises.copyFile(src, dest);
+}
+
+async function initMonorepoProject(projectRoot, { force = false } = {}) {
+  const { getProjectPaths, getTemplatesDir } = await importCliModule('utils/paths.js');
+  const { saveConfig, syncEnvFromConfig } = await importCliModule('services/config.js');
+  const { ensureDatabase, ensureDatabaseHostPort } = await importCliModule('services/database.js');
+
+  const paths = getProjectPaths(projectRoot);
+  const templatesDir = getTemplatesDir();
+
+  if (fs.existsSync(paths.configPath) && !force) {
+    const config = await (await importCliModule('services/config.js')).loadConfig(projectRoot);
+    await ensureDatabaseHostPort(projectRoot, undefined, config);
+    const dbResult = await ensureDatabase(projectRoot, config);
+    if (!dbResult.ok) {
+      return { ok: false, projectRoot, message: dbResult.message };
+    }
+    return { ok: true, projectRoot, message: '配置已存在，数据库已就绪。' };
+  }
+
+  await fs.promises.mkdir(paths.reactpressDir, { recursive: true });
+  await copyTemplateFile(
+    path.join(templatesDir, 'docker-compose.yml'),
+    paths.dockerComposePath
+  );
+
+  const config = JSON.parse(
+    await fs.promises.readFile(path.join(templatesDir, 'config.default.json'), 'utf8')
+  );
+  await saveConfig(projectRoot, config);
+  await syncEnvFromConfig(projectRoot, config);
+
+  if (!fs.existsSync(paths.envPath) || force) {
+    await copyTemplateFile(path.join(templatesDir, 'env.default'), paths.envPath);
+    await syncEnvFromConfig(projectRoot, config);
+  }
+
+  await ensureDatabaseHostPort(projectRoot, undefined, config);
+  const dbResult = await ensureDatabase(projectRoot, config);
+
+  if (!dbResult.ok) {
+    return {
+      ok: true,
+      projectRoot,
+      message: `项目已创建，但数据库未就绪: ${dbResult.message}。请确认 Docker 已启动后重试 reactpress dev。`,
+    };
+  }
+
+  return {
+    ok: true,
+    projectRoot,
+    message: 'ReactPress 开发环境已就绪（配置 + 数据库）。',
+  };
+}
+
+async function ensureProjectEnvironment(projectRoot = getMonorepoRoot()) {
+  const root = path.resolve(projectRoot);
+  const { setProjectCwd } = await importCliModule('utils/cli-context.js');
+  setProjectCwd(root);
+
+  const { isReactPressProject, loadConfig } = await importCliModule('services/config.js');
+  const { ensureDatabase, ensureDatabaseHostPort } = await importCliModule('services/database.js');
+
+  if (!(await isReactPressProject(root))) {
+    if (isMonorepoCheckout(root)) {
+      const result = await initMonorepoProject(root);
+      if (!result.ok) {
+        throw new Error(result.message || '初始化失败');
+      }
+      return result;
+    }
+
+    const { initProject } = await importCliModule('services/init.js');
+    const result = await initProject({ directory: root, force: false });
+    if (!result.ok) {
+      throw new Error(result.message || 'reactpress-cli init 失败');
+    }
+    return result;
+  }
+
+  const config = await loadConfig(root);
+  await ensureDatabaseHostPort(root, undefined, config);
+  const dbResult = await ensureDatabase(root, config);
+  if (!dbResult.ok) {
+    throw new Error(dbResult.message || '数据库未就绪，请检查 Docker 与 .env 中的 DB_* 配置');
+  }
+
+  return { ok: true, projectRoot: root, message: '数据库已就绪' };
+}
+
+module.exports = {
+  ensureProjectEnvironment,
+  initMonorepoProject,
+  isMonorepoCheckout,
+};

package/lib/build.js

@@ -0,0 +1,23 @@
+const { runSync } = require('./spawn');
+const { ensureOriginalCwd } = require('./root');
+
+const TARGETS = {
+  toolkit: ['build:toolkit'],
+  server: ['build:server'],
+  client: ['build:client'],
+  docs: ['build:docs'],
+  all: ['build'],
+};
+
+async function runBuild(target = 'all', projectRoot = ensureOriginalCwd()) {
+  const script = TARGETS[target];
+  if (!script) {
+    throw new Error(`未知构建目标: ${target}，可选: ${Object.keys(TARGETS).join(', ')}`);
+  }
+  for (const name of script) {
+    console.log(`[reactpress] 构建: ${name}`);
+    runSync('pnpm', ['run', name], { cwd: projectRoot });
+  }
+}
+
+module.exports = { runBuild, TARGETS };

package/lib/dev.js

@@ -0,0 +1,109 @@
+const { spawn } = require('child_process');
+const path = require('path');
+const { ensureProjectEnvironment } = require('./bootstrap');
+const { loadServerSiteUrl, waitForHttp } = require('./http');
+const { ensureOriginalCwd } = require('./root');
+
+const API_READY_TIMEOUT_MS = 180_000;
+
+let apiChild;
+let webChild;
+let shuttingDown = false;
+
+function shutdown(signal = 'SIGINT') {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  if (webChild && !webChild.killed) {
+    webChild.kill(signal);
+  }
+  if (apiChild && !apiChild.killed) {
+    apiChild.kill(signal);
+  }
+}
+
+async function buildToolkit(projectRoot) {
+  return new Promise((resolve, reject) => {
+    const build = spawn('pnpm', ['build:toolkit'], {
+      stdio: 'inherit',
+      shell: true,
+      cwd: projectRoot,
+    });
+    build.on('close', (code) => {
+      if (code !== 0) {
+        reject(new Error(`toolkit 构建失败，退出码: ${code}`));
+        return;
+      }
+      resolve();
+    });
+  });
+}
+
+async function startDevStack(projectRoot) {
+  const serverUrl = loadServerSiteUrl(projectRoot);
+  const apiDevRunner = path.join(__dirname, 'api-dev-runner.js');
+
+  console.log('[reactpress] 正在启动 API（首次可能需安装依赖，请稍候）…');
+  apiChild = spawn(process.execPath, [apiDevRunner], {
+    stdio: 'inherit',
+    cwd: projectRoot,
+    env: {
+      ...process.env,
+      REACTPRESS_ORIGINAL_CWD: projectRoot,
+    },
+  });
+
+  apiChild.on('close', (code) => {
+    if (shuttingDown) {
+      process.exit(code ?? 0);
+      return;
+    }
+    if (webChild && !webChild.killed) {
+      webChild.kill('SIGINT');
+    }
+    process.exit(code ?? 1);
+  });
+
+  console.log(`[reactpress] 等待 API 就绪: ${serverUrl}`);
+  const ready = await waitForHttp(serverUrl, API_READY_TIMEOUT_MS);
+  if (!ready) {
+    console.error(
+      `[reactpress] API 在 ${API_READY_TIMEOUT_MS / 1000}s 内未就绪。请检查 Docker/MySQL 与 .env 中的 DB_* 配置。`
+    );
+    shutdown('SIGINT');
+    process.exit(1);
+  }
+
+  console.log('[reactpress] API 已就绪，正在启动前端…');
+  webChild = spawn('pnpm', ['run', '--dir', './client', 'dev'], {
+    stdio: 'inherit',
+    shell: true,
+    cwd: projectRoot,
+  });
+
+  webChild.on('close', (code) => {
+    if (!shuttingDown) {
+      shutdown('SIGINT');
+    }
+    process.exit(code ?? 0);
+  });
+}
+
+async function runDev(projectRoot = ensureOriginalCwd()) {
+  process.on('SIGINT', () => shutdown('SIGINT'));
+  process.on('SIGTERM', () => shutdown('SIGTERM'));
+
+  try {
+    const result = await ensureProjectEnvironment(projectRoot);
+    if (result.message && !result.message.includes('已就绪')) {
+      console.log(`[reactpress] ${result.message}`);
+    }
+  } catch (err) {
+    console.error('[reactpress] 环境准备失败:', err.message || err);
+    process.exit(1);
+  }
+
+  await buildToolkit(projectRoot);
+  await startDevStack(projectRoot);
+}
+
+module.exports = { runDev, buildToolkit, startDevStack };