generator-mico-cli 0.2.20 → 0.2.21

package/lib/utils.js

@@ -2,7 +2,8 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { execSync } = require('node:child_process');
+const { execSync, exec } = require('node:child_process');
+const os = require('node:os');
 
 /**
  * 转换为 kebab-case
@@ -135,7 +136,7 @@ function getRegistryForPackage(packageName) {
 }
 
 /**
- * 从 npm registry 获取包的最新版本号（不使用 latest 标签，避免不可复现）
+ * 从 npm registry 获取包的最新版本号（同步版本）
  * registry 根据 packageName 的 scope 自动选择：scope 包含 mico 时用 MICO_NPM_REGISTRY，否则用默认
  * @param {string} packageName - 包名，如 '@mico-platform/ui'
  * @param {string} [fallback='1.0.0'] - 网络或超时时的回退版本
@@ -161,6 +162,193 @@ function getLatestNpmVersion(packageName, fallback = '1.0.0', timeoutMs = 8000,
   }
 }
 
+/**
+ * 从 npm registry 获取包的最新版本号（异步版本）
+ * @param {string} packageName - 包名，如 '@mico-platform/ui'
+ * @param {string} [fallback='1.0.0'] - 网络或超时时的回退版本
+ * @param {number} [timeoutMs=8000] - 超时毫秒
+ * @param {string} [cwd] - 执行 npm view 的 cwd
+ * @returns {Promise<string>} 版本号，如 '1.2.3'
+ */
+function getLatestNpmVersionAsync(packageName, fallback = '1.0.0', timeoutMs = 8000, cwd) {
+  return new Promise((resolve) => {
+    const registry = getRegistryForPackage(packageName);
+    const registryArg = registry ? `--registry=${registry}` : '';
+    const cmd = `npm view ${packageName} version ${registryArg}`.trim();
+
+    const child = exec(cmd, {
+      encoding: 'utf-8',
+      timeout: timeoutMs,
+      ...(cwd && { cwd })
+    }, (error, stdout) => {
+      if (error) {
+        resolve(fallback);
+        return;
+      }
+      const v = stdout.trim();
+      resolve(v && /^\d+\.\d+\.\d+/.test(v) ? v : fallback);
+    });
+
+    // 确保超时后也能 resolve
+    setTimeout(() => {
+      child.kill();
+      resolve(fallback);
+    }, timeoutMs + 100);
+  });
+}
+
+/**
+ * 并行获取多个包的版本号
+ * @param {Array<{name: string, fallback?: string}>} packages - 包列表
+ * @param {number} [timeoutMs=8000] - 超时毫秒
+ * @param {string} [cwd] - 执行 npm view 的 cwd
+ * @returns {Promise<Record<string, string>>} 包名到版本号的映射
+ */
+async function getPackageVersionsParallel(packages, timeoutMs = 8000, cwd) {
+  const results = await Promise.all(
+    packages.map(async (pkg) => {
+      const version = await getLatestNpmVersionAsync(
+        pkg.name,
+        pkg.fallback || '1.0.0',
+        timeoutMs,
+        cwd
+      );
+      return { name: pkg.name, version };
+    })
+  );
+
+  return results.reduce((acc, { name, version }) => {
+    acc[name] = version;
+    return acc;
+  }, {});
+}
+
+// ============ 配置文件支持 ============
+
+/**
+ * 查找并加载 .micorc 配置文件
+ * 按优先级从高到低查找：当前目录 -> 用户主目录
+ * @param {string} [startDir] - 开始查找的目录，默认为 process.cwd()
+ * @returns {object} 配置对象，找不到则返回空对象
+ */
+function loadMicorc(startDir = process.cwd()) {
+  const configNames = ['.micorc', '.micorc.json'];
+  const searchPaths = [
+    startDir,
+    os.homedir()
+  ];
+
+  for (const dir of searchPaths) {
+    for (const name of configNames) {
+      const configPath = path.join(dir, name);
+      if (fs.existsSync(configPath)) {
+        try {
+          const content = fs.readFileSync(configPath, 'utf-8');
+          const config = JSON.parse(content);
+          return { config, configPath };
+        } catch (e) {
+          // 解析失败，继续查找
+          console.warn(`Warning: Failed to parse ${configPath}: ${e.message}`);
+        }
+      }
+    }
+  }
+
+  return { config: {}, configPath: null };
+}
+
+/**
+ * 合并配置与用户输入
+ * @param {object} defaults - 默认值
+ * @param {object} rcConfig - .micorc 配置
+ * @returns {object} 合并后的默认值
+ */
+function mergeDefaults(defaults, rcConfig) {
+  return { ...defaults, ...rcConfig };
+}
+
+// ============ 环境检查 ============
+
+/**
+ * 检查命令是否可用
+ * @param {string} command - 命令名称
+ * @returns {{available: boolean, version?: string, error?: string}}
+ */
+function checkCommand(command) {
+  try {
+    const versionFlag = command === 'pnpm' ? '--version' : '--version';
+    const out = execSync(`${command} ${versionFlag}`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 5000
+    });
+    const version = out.trim().split('\n')[0];
+    return { available: true, version };
+  } catch (e) {
+    return { available: false, error: e.message };
+  }
+}
+
+/**
+ * 检查 Node.js 版本是否满足要求
+ * @param {string} required - 要求的最低版本，如 '18'
+ * @returns {{satisfied: boolean, current: string, required: string}}
+ */
+function checkNodeVersion(required = '18') {
+  const current = process.version.replace(/^v/, '');
+  const currentMajor = parseInt(current.split('.')[0], 10);
+  const requiredMajor = parseInt(required, 10);
+  return {
+    satisfied: currentMajor >= requiredMajor,
+    current,
+    required
+  };
+}
+
+/**
+ * 检查网络连接（npm registry）
+ * @param {number} [timeoutMs=5000] - 超时毫秒
+ * @returns {Promise<{reachable: boolean, registry: string, error?: string}>}
+ */
+async function checkNpmRegistry(timeoutMs = 5000) {
+  const registry = 'https://registry.npmjs.org';
+  return new Promise((resolve) => {
+    const child = exec(`npm ping --registry=${registry}`, {
+      timeout: timeoutMs
+    }, (error) => {
+      if (error) {
+        resolve({ reachable: false, registry, error: error.message });
+      } else {
+        resolve({ reachable: true, registry });
+      }
+    });
+
+    setTimeout(() => {
+      child.kill();
+      resolve({ reachable: false, registry, error: 'Timeout' });
+    }, timeoutMs + 100);
+  });
+}
+
+/**
+ * 运行完整的环境检查
+ * @returns {Promise<object>} 检查结果
+ */
+async function runDoctorChecks() {
+  const results = {
+    node: checkNodeVersion('18'),
+    pnpm: checkCommand('pnpm'),
+    yo: checkCommand('yo'),
+    git: checkCommand('git'),
+    npm: null
+  };
+
+  // 异步检查 npm registry
+  results.npm = await checkNpmRegistry();
+
+  return results;
+}
+
 /**
  * 检查是否启用了 verbose 模式
  * @returns {boolean}
@@ -247,8 +435,18 @@ module.exports = {
   transformDestPath,
   isTemplateFile,
   getLatestNpmVersion,
+  getLatestNpmVersionAsync,
+  getPackageVersionsParallel,
   setupErrorHandlers,
   TEMPLATE_EXTENSIONS,
+  // 配置文件
+  loadMicorc,
+  mergeDefaults,
+  // 环境检查
+  checkCommand,
+  checkNodeVersion,
+  checkNpmRegistry,
+  runDoctorChecks,
   // Verbose 日志
   isVerbose,
   verboseLog,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-mico-cli",
-  "version": "0.2.20",
+  "version": "0.2.21",
   "description": "Yeoman generator for Mico CLI projects",
   "keywords": ["yeoman-generator", "generator", "cli"],
   "license": "MIT",