@wwkit/opm 1.0.1

package/src/managers/npm.js

@@ -0,0 +1,473 @@
+/**
+ * npm 包管理器实现
+ *
+ * 通过执行 npm CLI 命令实现统一接口。
+ * npm view 命令查询源信息，npm list 查询本地安装状态。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { createRequire } from 'node:module'
+import { PackageManager } from './base.js'
+import { getActiveRegistry, setActiveRegistry } from '../config.js'
+
+export class NpmManager extends PackageManager {
+  constructor() {
+    super()
+    this.name = 'npm'
+  }
+
+  /**
+   * 执行 npm 命令，返回 stdout
+   * execSync 默认通过 shell 执行，兼容 Windows 的 npm.cmd
+   * @param {string[]} args
+   * @param {object} [opts]
+   * @returns {string}
+   * @private
+   */
+  _exec(args, opts = {}) {
+    const cmd = ['npm', ...args].join(' ')
+    try {
+      return execSync(cmd, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'], ...opts })
+    } catch (err) {
+      if (opts.allowNonZero) {
+        return err.stdout ? err.stdout.toString() : ''
+      }
+      const stderr = err.stderr ? err.stderr.toString().trim() : ''
+      if (stderr && !stderr.startsWith('npm warn')) {
+        throw new Error(stderr)
+      }
+      return err.stdout ? err.stdout.toString() : ''
+    }
+  }
+
+  /**
+   * 执行 npm 命令并解析 JSON 输出
+   * @param {string[]} args
+   * @returns {*}
+   * @private
+   */
+  _execJson(args) {
+    const out = this._exec([...args, '--json', '--no-workspaces'], { allowNonZero: true })
+    try {
+      return JSON.parse(out)
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * 执行 npm 命令，输出直接继承到终端（用于 install/uninstall 等）
+   * @param {string[]} args
+   * @private
+   */
+  _execInherit(args) {
+    const result = spawnSync('npm', args, { stdio: 'inherit', shell: true })
+    if (result.error) {
+      throw new Error(result.error.message)
+    }
+    if (result.status !== 0) {
+      throw new Error(`npm ${args.join(' ')} exited with code ${result.status}`)
+    }
+  }
+
+  /**
+   * 构造 npm proxy 参数
+   * @param {string} [proxy] - 代理地址
+   * @returns {string[]}
+   * @private
+   */
+  _proxyArgs(proxy) {
+    return proxy ? ['--proxy', proxy] : []
+  }
+
+  /**
+   * 构造 npm registry 参数（使用配置中 active 镜像）
+   * @returns {string[]}
+   * @private
+   */
+  _registryArgs() {
+    const registry = getActiveRegistry('npm')
+    return registry ? ['--registry', registry] : []
+  }
+
+  async getRegistry() {
+    return { registry: getActiveRegistry('npm') }
+  }
+
+  async getVersion() {
+    try {
+      const version = this._exec(['--version'], { allowNonZero: true }).trim()
+      if (version) {
+        return { name: 'npm', installed: true, version }
+      }
+    } catch {}
+    return { name: 'npm', version: '', installed: false, hint: 'Install Node.js from https://nodejs.org/ (includes npm)' }
+  }
+
+  async setRegistry(url) {
+    const resolved = setActiveRegistry('npm', url)
+    return { registry: resolved }
+  }
+
+  async searchPackage(name, version, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const proxyArgs = this._proxyArgs(opts.proxy)
+    const regArgs = this._registryArgs()
+
+    if (version) {
+      try {
+        const data = this._execJson(['view', `${name}@${version}`, ...proxyArgs, ...regArgs])
+        if (data) {
+          return { name, version, exists: true, available: true, registry }
+        }
+      } catch {}
+      return { name, version, exists: false, available: false, registry }
+    }
+
+    try {
+      const data = this._execJson(['view', name, ...proxyArgs, ...regArgs])
+      if (data) {
+        const versions = Array.isArray(data.versions) ? data.versions : (data.versions ? Object.keys(data.versions) : [])
+        return {
+          name,
+          exists: true,
+          latest: data['dist-tags']?.latest || versions[versions.length - 1] || 'unknown',
+          versions,
+          registry
+        }
+      }
+    } catch {}
+
+    return { name, exists: false, registry }
+  }
+
+  /**
+   * 读取当前项目 package.json 中的所有依赖声明
+   * @returns {Record<string, string>} name -> versionRange
+   * @private
+   */
+  _readDeclaredDeps() {
+    const pkgPath = path.join(process.cwd(), 'package.json')
+    if (!fs.existsSync(pkgPath)) return {}
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+      return {
+        ...(pkg.dependencies || {}),
+        ...(pkg.devDependencies || {}),
+        ...(pkg.peerDependencies || {}),
+        ...(pkg.optionalDependencies || {})
+      }
+    } catch {
+      return {}
+    }
+  }
+
+  /**
+   * 读取 workspace 包名列表（兼容 npm/yarn workspaces 和 pnpm-workspace.yaml）
+   * @returns {{ name: string, version: string, dir: string }[]}
+   * @private
+   */
+  _readWorkspacePackages() {
+    const cwd = process.cwd()
+    const patterns = []
+
+    const pkgPath = path.join(cwd, 'package.json')
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+        if (Array.isArray(pkg.workspaces)) {
+          patterns.push(...pkg.workspaces)
+        }
+      } catch {}
+    }
+
+    const pnpmWsPath = path.join(cwd, 'pnpm-workspace.yaml')
+    if (fs.existsSync(pnpmWsPath)) {
+      try {
+        const text = fs.readFileSync(pnpmWsPath, 'utf8')
+        const lines = text.split('\n').map((l) => l.trim())
+        let inPackages = false
+        for (const line of lines) {
+          if (line.startsWith('packages:')) {
+            inPackages = true
+            continue
+          }
+          if (inPackages && line.startsWith('-')) {
+            const val = line.slice(1).trim().replace(/^['"]|['"]$/g, '')
+            if (val) patterns.push(val)
+          } else if (inPackages && line && !line.startsWith('-') && !line.startsWith('#')) {
+            inPackages = false
+          }
+        }
+      } catch {}
+    }
+
+    const results = []
+    const seen = new Set()
+    for (const pattern of patterns) {
+      const dirs = this._globDirs(cwd, pattern)
+      for (const dir of dirs) {
+        const wpkgPath = path.join(dir, 'package.json')
+        if (!fs.existsSync(wpkgPath)) continue
+        try {
+          const wpkg = JSON.parse(fs.readFileSync(wpkgPath, 'utf8'))
+          if (wpkg.name && !seen.has(wpkg.name)) {
+            seen.add(wpkg.name)
+            results.push({ name: wpkg.name, version: wpkg.version || '0.0.0', dir })
+          }
+        } catch {}
+      }
+    }
+    return results
+  }
+
+  /**
+   * 简单 glob：将 packages/* 等模式展开为实际目录
+   * @param {string} base - 基目录
+   * @param {string} pattern - glob 模式（仅支持单层 * 通配）
+   * @returns {string[]}
+   * @private
+   */
+  _globDirs(base, pattern) {
+    if (!pattern.includes('*')) {
+      const full = path.resolve(base, pattern)
+      return fs.existsSync(full) ? [full] : []
+    }
+    const parts = pattern.split('*')
+    const prefix = parts[0]
+    const suffix = parts.slice(1).join('*')
+    const searchDir = path.resolve(base, prefix)
+    if (!fs.existsSync(searchDir)) return []
+    let entries = []
+    try {
+      entries = fs.readdirSync(searchDir, { withFileTypes: true })
+    } catch {
+      return []
+    }
+    return entries
+      .filter((e) => e.isDirectory())
+      .map((e) => path.join(searchDir, e.name) + (suffix || ''))
+      .filter((d) => fs.existsSync(d))
+  }
+
+  /**
+   * 通过 Node 模块解析获取已安装包的实际版本
+   * 兼容 npm / yarn / pnpm 的 node_modules 结构
+   * @param {string} name - 包名
+   * @returns {{ version: string, path: string } | null}
+   * @private
+   */
+  _resolveInstalled(name) {
+    const require = createRequire(path.join(process.cwd(), 'package.json'))
+
+    try {
+      const pkgPath = require.resolve(`${name}/package.json`)
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+      return { version: pkg.version, path: path.dirname(pkgPath) }
+    } catch {}
+
+    try {
+      const mainPath = require.resolve(name)
+      const dir = path.dirname(mainPath)
+      const realDir = fs.realpathSync(dir)
+      const pkgPath = path.join(realDir, 'package.json')
+      if (fs.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+        return { version: pkg.version, path: realDir }
+      }
+      const parentDir = path.dirname(realDir)
+      const parentPkgPath = path.join(parentDir, 'package.json')
+      if (fs.existsSync(parentPkgPath)) {
+        const pkg = JSON.parse(fs.readFileSync(parentPkgPath, 'utf8'))
+        if (pkg.name === name) {
+          return { version: pkg.version, path: parentDir }
+        }
+      }
+    } catch {}
+
+    return null
+  }
+
+  /**
+   * 查询全局安装的包
+   * @param {string} name - 包名
+   * @returns {Promise<InstalledResult>}
+   * @private
+   */
+  async _isGlobalInstalled(name) {
+    try {
+      const data = this._execJson(['list', '-g', name])
+      const deps = data?.dependencies || {}
+      const pkg = deps[name]
+      if (pkg) {
+        const globalRoot = this._exec(['root', '-g'], { allowNonZero: true }).trim()
+        return { name, installed: true, version: pkg.version || 'unknown', path: path.join(globalRoot, name), global: true }
+      }
+    } catch {}
+
+    try {
+      const globalRoot = this._exec(['root', '-g'], { allowNonZero: true }).trim()
+      const pkgPath = path.join(globalRoot, name, 'package.json')
+      if (fs.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+        return { name, installed: true, version: pkg.version, path: path.dirname(pkgPath), global: true }
+      }
+    } catch {}
+
+    return { name, installed: false, global: true }
+  }
+
+  async isInstalled(name, opts = {}) {
+    if (opts.global) {
+      return this._isGlobalInstalled(name)
+    }
+
+    const resolved = this._resolveInstalled(name)
+    if (resolved) {
+      return { name, installed: true, version: resolved.version, path: resolved.path }
+    }
+
+    const workspaces = this._readWorkspacePackages()
+    const wsMatch = workspaces.find((w) => w.name === name)
+    if (wsMatch) {
+      return { name, installed: true, version: wsMatch.version, path: wsMatch.dir }
+    }
+
+    const declared = this._readDeclaredDeps()
+    if (declared[name]) {
+      return { name, installed: true, version: declared[name] }
+    }
+
+    return { name, installed: false }
+  }
+
+  async packageInfo(name, opts = {}) {
+    try {
+      const data = this._execJson(['view', name, ...this._proxyArgs(opts.proxy), ...this._registryArgs()])
+      if (!data) {
+        return { name, description: '(not found)' }
+      }
+      return {
+        name,
+        description: data.description || '',
+        latest: data['dist-tags']?.latest || '',
+        homepage: data.homepage || '',
+        license: data.license || '',
+        author: typeof data.author === 'object' ? data.author?.name || '' : (data.author || ''),
+        repository: typeof data.repository === 'object' ? data.repository?.url || '' : (data.repository || '')
+      }
+    } catch (err) {
+      throw new Error(`npm info "${name}" failed: ${err.message}`)
+    }
+  }
+
+  async packageVersions(name, opts = {}) {
+    const { registry } = await this.getRegistry()
+    try {
+      const data = this._execJson(['view', name, 'versions', ...this._proxyArgs(opts.proxy), ...this._registryArgs()])
+      if (data) {
+        const versions = Array.isArray(data) ? data : (typeof data === 'object' ? Object.keys(data) : [])
+        return { name, versions, registry }
+      }
+    } catch {}
+    return { name, versions: [], registry }
+  }
+
+  async listInstalled(opts = {}) {
+    if (opts.global) {
+      try {
+        const data = this._execJson(['list', '-g', '--depth=0'])
+        const deps = data?.dependencies || {}
+        return Object.entries(deps)
+          .filter(([, info]) => info && info.version)
+          .map(([name, info]) => ({ name, version: info.version, global: true }))
+      } catch (err) {
+        throw new Error(`npm list -g failed: ${err.message}`)
+      }
+    }
+
+    const declared = this._readDeclaredDeps()
+    const workspaces = this._readWorkspacePackages()
+    const items = []
+    const seen = new Set()
+
+    for (const { name, version, dir } of workspaces) {
+      if (seen.has(name)) continue
+      seen.add(name)
+      const resolved = this._resolveInstalled(name)
+      items.push({
+        name,
+        version: resolved ? resolved.version : version,
+        path: resolved ? resolved.path : dir
+      })
+    }
+
+    for (const [name, declaredVersion] of Object.entries(declared)) {
+      if (seen.has(name)) continue
+      seen.add(name)
+      const resolved = this._resolveInstalled(name)
+      items.push({
+        name,
+        version: resolved ? resolved.version : declaredVersion
+      })
+    }
+
+    return items
+  }
+
+  async listOutdated(opts = {}) {
+    try {
+      const args = ['outdated']
+      if (opts.global) args.push('-g')
+      args.push(...this._proxyArgs(opts.proxy))
+      args.push(...this._registryArgs())
+      const data = this._execJson(args)
+      if (!data) return []
+      const items = Object.entries(data).map(([name, info]) => ({
+        name,
+        current: info.current || 'missing',
+        wanted: info.wanted || '',
+        latest: info.latest || ''
+      }))
+      return items
+    } catch (err) {
+      throw new Error(`npm outdated failed: ${err.message}`)
+    }
+  }
+
+  async install(name, version, opts = {}) {
+    const spec = version ? `${name}@${version}` : name
+    const args = ['install', spec]
+    if (opts.global) args.push('-g')
+    args.push(...this._proxyArgs(opts.proxy))
+    args.push(...this._registryArgs())
+
+    this._execInherit(args)
+    return { name, version: version || 'latest', action: 'installed' }
+  }
+
+  async uninstall(name, opts = {}) {
+    const args = ['uninstall', name]
+    if (opts.global) args.push('-g')
+
+    this._execInherit(args)
+    return { name, action: 'uninstalled' }
+  }
+
+  async upgrade(name, opts = {}) {
+    const args = ['install', `${name}@latest`]
+    if (opts.global) args.push('-g')
+    args.push(...this._proxyArgs(opts.proxy))
+    args.push(...this._registryArgs())
+
+    this._execInherit(args)
+    return { name, version: 'latest', action: 'upgraded' }
+  }
+
+  async cleanCache() {
+    this._execInherit(['cache', 'clean', '--force'])
+    return { action: 'cache cleaned' }
+  }
+}

package/src/managers/php.js

@@ -0,0 +1,157 @@
+/**
+ * php（PHP runtime）版本管理器实现（基于 phpenv）
+ *
+ * 通过 phpenv CLI 管理多个 PHP 版本。phpenv 是常规二进制（~/.phpenv/bin/phpenv），
+ * 非 shell function，直接调用即可（无需 source）。
+ *
+ * 源查询使用 phpenv install --list，本地查询使用 phpenv versions。
+ * 镜像通过 PHP_BUILD_MIRROR_URL 环境变量传递给 php-build。
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { execSync } from 'node:child_process'
+import { RuntimeManager } from './runtime.js'
+import { Shell } from '@wwkit/shared'
+import { getActiveRegistry } from '../config.js'
+
+const shell = new Shell()
+
+const PHP_BUILD_GIT = 'https://github.com/php-build/php-build.git'
+
+/**
+ * 获取 phpenv 根目录
+ * @returns {string}
+ */
+function getPhpenvRoot() {
+  return process.env.PHPENV_ROOT || path.join(os.homedir(), '.phpenv')
+}
+
+/**
+ * 获取 phpenv 二进制路径
+ * @returns {string}
+ */
+export function getPhpenvBin() {
+  return path.join(getPhpenvRoot(), 'bin', 'phpenv')
+}
+
+/**
+ * 检查 phpenv 是否已安装
+ * @returns {boolean}
+ */
+export function isPhpenvInstalled() {
+  return fs.existsSync(getPhpenvBin())
+}
+
+/**
+ * 安装 phpenv（git clone + php-build 插件 + 写 shell profile）
+ * @returns {{ action: string, plugin: string, profile: string, hint: string }}
+ */
+export function installPhpenv() {
+  const mirror = getActiveRegistry('phpenv')
+  const root = getPhpenvRoot()
+  execSync(`git clone "${mirror}" "${root}"`, { stdio: 'inherit', shell: shell.resolveBash() })
+  execSync(`git clone "${PHP_BUILD_GIT}" "${path.join(root, 'plugins', 'php-build')}"`, {
+    stdio: 'inherit',
+    shell: shell.resolveBash(),
+  })
+  const lines = [
+    `export PHPENV_ROOT="${root}"`,
+    `export PATH="$PHPENV_ROOT/bin:$PATH"`,
+    `eval "$(phpenv init -)"`,
+  ]
+  const wroteProfile = shell.writeProfile('PHPENV_ROOT', 'phpenv', lines)
+  return {
+    action: 'installed',
+    plugin: 'php-build',
+    profile: wroteProfile ? shell.getProfile() : '(already configured)',
+    hint: `Restart shell or run: eval "$(${getPhpenvBin()} init -)"`,
+  }
+}
+
+export class PhpManager extends RuntimeManager {
+  constructor() {
+    super({
+      name: 'php',
+      mirrorEnv: 'PHP_BUILD_MIRROR_URL',
+      prefix: getPhpenvBin(),
+      needsBash: true,
+      isInstalled: () => isPhpenvInstalled(),
+      installTool: () => installPhpenv(),
+      toolName: 'phpenv',
+      toolMissingMsg: 'phpenv not installed, run `opm phpenv install` first',
+      listCmd: ['versions'],
+      listRemoteCmd: ['install', '--list'],
+      currentCmd: ['version'],
+      parseCurrent: (out) => {
+        const m = out.trim().match(/^(\d+\.\d+\.\d+)/)
+        return m ? m[1] : ''
+      },
+      installCmd: (v) => ['install', v],
+      uninstallCmd: (n) => ['uninstall', n],
+      resultName: (v) => v,
+      useCmd: (v) => ['global', v],
+      useAction: 'switched',
+      defaultCmd: (v) => ['global', v],
+      noCacheMsg: 'no cache for phpenv-managed php',
+      installUsage: 'Usage: opm php install <version> (e.g. 8.3, 8.3.13)',
+      notInstalledHint: 'phpenv not installed or no PHP version active, run `opm phpenv install` and `opm php install <version>`',
+      upgradeNoVersionMsg: 'No PHP version available to upgrade to',
+      info: {
+        description: 'PHP Hypertext Preprocessor',
+        homepage: 'https://www.php.net',
+        license: 'PHP License',
+        author: 'The PHP Group',
+        repository: 'https://github.com/php/php-src',
+      },
+    })
+  }
+
+  /**
+   * 获取当前激活 php 的安装目录
+   * @returns {string}
+   */
+  getInstallDir() {
+    try {
+      const out = this._exec(['which'], { allowNonZero: true }).trim()
+      if (!out) return ''
+      return path.dirname(path.dirname(out))
+    } catch {}
+    return ''
+  }
+
+  /**
+   * 解析 phpenv versions 输出为已安装版本列表
+   * @param {string} out
+   * @returns {{ name: string, version: string, current: boolean }[]}
+   * @private
+   */
+  _parseInstalled(out) {
+    const items = []
+    for (const line of out.split('\n')) {
+      const m = line.match(/^(\*)?\s+(\d+\.\d+\.\d+)\b/)
+      if (m) {
+        items.push({ name: m[2], version: m[2], current: !!m[1] })
+      }
+    }
+    return items
+  }
+
+  /**
+   * 解析 phpenv install --list 输出为可用版本列表
+   * @param {string} out
+   * @returns {string[]}
+   * @private
+   */
+  _parseRemote(out) {
+    const versions = []
+    for (const line of out.split('\n')) {
+      const m = line.match(/^\s*(\d+\.\d+\.\d+)\s*$/)
+      if (m) {
+        versions.push(m[1])
+      }
+    }
+    return versions
+  }
+}