@wwkit/opm 1.0.1

package/src/managers/base.js

@@ -0,0 +1,167 @@
+/**
+ * 包管理器基类
+ *
+ * 定义统一的包管理操作接口，各具体管理器（npm/pip 等）继承此类并实现具体逻辑。
+ *
+ * @typedef {Object} SearchResult
+ * @property {string} name - 包名
+ * @property {boolean} exists - 是否存在
+ * @property {string} [latest] - 最新版本（无版本查询时）
+ * @property {string} [version] - 查询的版本（有版本查询时）
+ * @property {boolean} [available] - 指定版本是否可用（有版本查询时）
+ * @property {string[]} [versions] - 所有可用版本列表
+ * @property {string} registry - 查询的镜像地址
+ *
+ * @typedef {Object} InstalledResult
+ * @property {string} name - 包名
+ * @property {boolean} installed - 是否已安装
+ * @property {string} [version] - 已安装版本
+ * @property {string} [path] - 安装路径
+ *
+ * @typedef {Object} PackageInfo
+ * @property {string} name - 包名
+ * @property {string} [description] - 描述
+ * @property {string} [latest] - 最新版本
+ * @property {string} [homepage] - 主页
+ * @property {string} [license] - 许可证
+ * @property {string} [author] - 作者
+ * @property {string} [repository] - 仓库地址
+ *
+ * @typedef {Object} InstalledItem
+ * @property {string} name - 包名
+ * @property {string} version - 版本
+ *
+ * @typedef {Object} OutdatedItem
+ * @property {string} name - 包名
+ * @property {string} current - 当前版本
+ * @property {string} [wanted] - 期望版本
+ * @property {string} latest - 最新版本
+ */
+export class PackageManager {
+  constructor() {
+    this.name = 'base'
+  }
+
+  /**
+   * 查询管理器本身版本
+   * @returns {Promise<{ name: string, installed: boolean, version?: string, hint?: string }>}
+   */
+  async getVersion() {
+    throw new Error(`${this.name}: getVersion not implemented`)
+  }
+
+  /**
+   * 查询当前镜像地址
+   * @returns {Promise<{ registry: string }>}
+   */
+  async getRegistry() {
+    throw new Error(`${this.name}: getRegistry not implemented`)
+  }
+
+  /**
+   * 设置镜像地址
+   * @param {string} url - 镜像 URL 或预设名
+   * @returns {Promise<{ registry: string }>}
+   */
+  async setRegistry(url) {
+    throw new Error(`${this.name}: setRegistry not implemented`)
+  }
+
+  /**
+   * 查询包在源是否可用
+   * @param {string} name - 包名
+   * @param {string} [version] - 版本号（可选）
+   * @param {{ proxy?: string }} [opts] - 选项
+   * @returns {Promise<SearchResult>}
+   */
+  async searchPackage(name, version, opts) {
+    throw new Error(`${this.name}: searchPackage not implemented`)
+  }
+
+  /**
+   * 查询包是否已安装
+   * @param {string} name - 包名
+   * @param {{ global?: boolean }} [opts] - 选项
+   * @returns {Promise<InstalledResult>}
+   */
+  async isInstalled(name, opts) {
+    throw new Error(`${this.name}: isInstalled not implemented`)
+  }
+
+  /**
+   * 查询包详情
+   * @param {string} name - 包名
+   * @param {{ proxy?: string }} [opts] - 选项
+   * @returns {Promise<PackageInfo>}
+   */
+  async packageInfo(name, opts) {
+    throw new Error(`${this.name}: packageInfo not implemented`)
+  }
+
+  /**
+   * 列出包的所有可用版本
+   * @param {string} name - 包名
+   * @param {{ proxy?: string }} [opts] - 选项
+   * @returns {Promise<{ name: string, versions: string[], registry: string }>}
+   */
+  async packageVersions(name, opts) {
+    throw new Error(`${this.name}: packageVersions not implemented`)
+  }
+
+  /**
+   * 列出所有已安装包
+   * @param {{ global?: boolean }} [opts] - 选项
+   * @returns {Promise<InstalledItem[]>}
+   */
+  async listInstalled(opts) {
+    throw new Error(`${this.name}: listInstalled not implemented`)
+  }
+
+  /**
+   * 列出过期包
+   * @param {{ global?: boolean, proxy?: string }} [opts] - 选项
+   * @returns {Promise<OutdatedItem[]>}
+   */
+  async listOutdated(opts) {
+    throw new Error(`${this.name}: listOutdated not implemented`)
+  }
+
+  /**
+   * 安装包
+   * @param {string} name - 包名
+   * @param {string} [version] - 版本号
+   * @param {{ global?: boolean, proxy?: string }} [opts] - 选项
+   * @returns {Promise<{ name: string, version: string, action: string }>}
+   */
+  async install(name, version, opts) {
+    throw new Error(`${this.name}: install not implemented`)
+  }
+
+  /**
+   * 卸载包
+   * @param {string} name - 包名
+   * @param {{ global?: boolean }} [opts] - 选项
+   * @returns {Promise<{ name: string, action: string }>}
+   */
+  async uninstall(name, opts) {
+    throw new Error(`${this.name}: uninstall not implemented`)
+  }
+
+  /**
+   * 升级包
+   * @param {string} name - 包名
+   * @param {{ global?: boolean, proxy?: string }} [opts] - 选项
+   * @returns {Promise<{ name: string, version: string, action: string }>}
+   */
+  async upgrade(name, opts) {
+    throw new Error(`${this.name}: upgrade not implemented`)
+  }
+
+  /**
+   * 清理缓存
+   * @returns {Promise<{ action: string }>}
+   */
+  async cleanCache() {
+    throw new Error(`${this.name}: cleanCache not implemented`)
+  }
+}

package/src/managers/brew.js

@@ -0,0 +1,374 @@
+/**
+ * brew（Homebrew）包管理器实现（macOS）
+ *
+ * 通过执行 brew CLI 命令实现统一接口（系统级，无用户级/local 概念）。
+ * 源查询使用 brew info --json=v2，本地查询使用 brew list，均只读系统状态。
+ * 镜像（非 official）通过 HOMEBREW_API_DOMAIN / HOMEBREW_BOTTLE_DOMAIN 环境变量传递，
+ * 仅作用于本工具发起的命令，不修改系统 brew 配置。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import { PackageManager } from './base.js'
+import { getActiveRegistry, getPresets, setActiveRegistry } from '../config.js'
+
+const BREW_INSTALL_URL = 'https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh'
+const BREW_UNINSTALL_URL = 'https://raw.githubusercontent.com/Homebrew/uninstall/HEAD/uninstall.sh'
+
+/**
+ * 定位 brew 可执行文件（兼容 Intel / Apple Silicon 路径），找不到时退回 PATH
+ * @returns {string}
+ */
+export function getBrewBin() {
+  for (const p of ['/opt/homebrew/bin/brew', '/usr/local/bin/brew']) {
+    if (fs.existsSync(p)) return p
+  }
+  return 'brew'
+}
+
+/**
+ * 检查 Homebrew 是否已安装
+ * @returns {boolean}
+ */
+export function isHomebrewInstalled() {
+  try {
+    execSync(`${getBrewBin()} --version`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 安装 Homebrew（curl 官方安装脚本）
+ * @returns {{ action: string, hint: string }}
+ */
+export function installHomebrew() {
+  if (process.platform === 'win32') {
+    throw new Error('Homebrew is not supported on Windows (use WSL)')
+  }
+  execSync(`curl -fsSL "${BREW_INSTALL_URL}" | bash`, { stdio: 'inherit', shell: true })
+  return { action: 'installed', hint: 'Restart shell or ensure /opt/homebrew/bin (or /usr/local/bin) is in PATH' }
+}
+
+export class BrewManager extends PackageManager {
+  constructor() {
+    super()
+    this.name = 'brew'
+  }
+
+  /**
+   * 定位 brew 可执行文件（兼容 Intel / Apple Silicon 路径），找不到时退回 PATH
+   * @returns {string}
+   * @private
+   */
+  _brewBin() {
+    return getBrewBin()
+  }
+
+  /**
+   * 对包含特殊字符的参数进行 shell 转义（单引号包裹）
+   * @param {string} arg
+   * @returns {string}
+   * @private
+   */
+  _quoteArg(arg) {
+    if (arg && /[\s'"$`\\]/.test(arg)) {
+      return `'${arg.replace(/'/g, `'\\''`)}'`
+    }
+    return arg
+  }
+
+  /**
+   * 构造 brew 命令环境：镜像域名 + 代理 + 关闭自动更新/安装清理
+   * @param {string} [proxy] - 代理地址
+   * @returns {Record<string,string>}
+   * @private
+   */
+  _buildEnv(proxy) {
+    const env = { ...process.env }
+    const mirror = this._mirrorEnv()
+    Object.assign(env, mirror)
+    Object.assign(env, this._proxyEnv(proxy))
+    env.HOMEBREW_NO_AUTO_UPDATE = '1'
+    env.HOMEBREW_NO_INSTALL_CLEANUP = '1'
+    return env
+  }
+
+  /**
+   * 构造镜像环境变量（仅当 active 非 official 时设置）
+   * @returns {Record<string,string>}
+   * @private
+   */
+  _mirrorEnv() {
+    const active = getActiveRegistry('brew')
+    if (!active || active === getPresets('brew').official) return {}
+    const base = active.replace(/\/+$/, '')
+    if (!/^https?:\/\//.test(base)) return {}
+    return {
+      HOMEBREW_API_DOMAIN: `${base}/api`,
+      HOMEBREW_BOTTLE_DOMAIN: base,
+    }
+  }
+
+  /**
+   * 构造 brew 代理环境变量（brew 遵循标准 HTTP_PROXY/ALL_PROXY）
+   * @param {string} [proxy] - 代理地址
+   * @returns {Record<string,string>}
+   * @private
+   */
+  _proxyEnv(proxy) {
+    if (!proxy) return {}
+    return {
+      HTTP_PROXY: proxy,
+      HTTPS_PROXY: proxy,
+      ALL_PROXY: proxy,
+      http_proxy: proxy,
+      https_proxy: proxy,
+      all_proxy: proxy,
+    }
+  }
+
+  /**
+   * 执行 brew 命令，返回 stdout
+   * @param {string[]} args
+   * @param {{ allowNonZero?: boolean, proxy?: string }} [opts]
+   * @returns {string}
+   * @private
+   */
+  _exec(args, opts = {}) {
+    const cmd = [this._brewBin(), ...args].map((a) => this._quoteArg(a)).join(' ')
+    try {
+      return execSync(cmd, {
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        env: this._buildEnv(opts.proxy),
+        ...opts,
+      })
+    } catch (err) {
+      if (opts.allowNonZero) {
+        return err.stdout ? err.stdout.toString() : ''
+      }
+      const stderr = err.stderr ? err.stderr.toString().trim() : ''
+      if (stderr && !stderr.startsWith('Warning:')) {
+        throw new Error(stderr)
+      }
+      return err.stdout ? err.stdout.toString() : ''
+    }
+  }
+
+  /**
+   * 执行 brew 命令，输出直接继承到终端（用于 install/uninstall/upgrade）
+   * @param {string[]} args
+   * @param {{ proxy?: string }} [opts]
+   * @private
+   */
+  _execInherit(args, opts = {}) {
+    const result = spawnSync(this._brewBin(), args, {
+      stdio: 'inherit',
+      env: this._buildEnv(opts.proxy),
+    })
+    if (result.error) {
+      throw new Error(result.error.message)
+    }
+    if (result.status !== 0) {
+      throw new Error(`brew ${args.join(' ')} exited with code ${result.status}`)
+    }
+  }
+
+  /**
+   * 解析 brew info --json=v2 输出为 { formula, cask }（取首个）
+   * @param {string} text
+   * @returns {{ formula?: object, cask?: object, type: string }|null}
+   * @private
+   */
+  _parseInfoJson(text) {
+    try {
+      const data = JSON.parse(text)
+      if (Array.isArray(data.formulae) && data.formulae.length > 0) {
+        return { formula: data.formulae[0], cask: null, type: 'formula' }
+      }
+      if (Array.isArray(data.casks) && data.casks.length > 0) {
+        return { formula: null, cask: data.casks[0], type: 'cask' }
+      }
+    } catch {}
+    return null
+  }
+
+  /**
+   * 解析 brew list --versions 输出为已安装项数组
+   * 每行格式：name version [version...]
+   * @param {string} out
+   * @returns {{ name: string, version: string }[]}
+   * @private
+   */
+  _parseListVersions(out) {
+    const items = []
+    for (const line of out.split('\n')) {
+      const trimmed = line.trim()
+      if (!trimmed) continue
+      const m = trimmed.match(/^(\S+)\s+(.+)$/)
+      if (m) items.push({ name: m[1], version: m[2].trim() })
+    }
+    return items
+  }
+
+  /**
+   * 解析 brew outdated --json=v2 输出为过期项数组（formulae + casks）
+   * @param {string} text
+   * @returns {{ name: string, current: string, latest: string }[]}
+   * @private
+   */
+  _parseOutdatedJson(text) {
+    let data
+    try {
+      data = JSON.parse(text)
+    } catch {
+      return []
+    }
+    const items = []
+    for (const group of ['formulae', 'casks']) {
+      const list = Array.isArray(data[group]) ? data[group] : []
+      for (const item of list) {
+        items.push({
+          name: item.name,
+          current: (Array.isArray(item.installed_versions) ? item.installed_versions : []).join(', '),
+          latest: item.current_version || '',
+        })
+      }
+    }
+    return items
+  }
+
+  async getVersion() {
+    try {
+      const out = this._exec(['--version'], { allowNonZero: true })
+      const firstLine = out.trim().split('\n')[0] || ''
+      const match = firstLine.match(/^Homebrew\s+(\S+)/)
+      if (match) {
+        return { name: 'brew', installed: true, version: match[1] }
+      }
+      if (firstLine) {
+        return { name: 'brew', installed: true, version: firstLine }
+      }
+    } catch {}
+    return { name: 'brew', version: '', installed: false, hint: 'Install Homebrew from https://brew.sh/' }
+  }
+
+  async getRegistry() {
+    return { registry: getActiveRegistry('brew') }
+  }
+
+  async setRegistry(url) {
+    const resolved = setActiveRegistry('brew', url)
+    return { registry: resolved }
+  }
+
+  /**
+   * 查询包的源内信息（brew info --json=v2）
+   * @param {string} name
+   * @param {{ proxy?: string }} [opts]
+   * @returns {{ formula?: object, cask?: object, type: string }|null}
+   * @private
+   */
+  _fetchInfo(name, opts = {}) {
+    const out = this._exec(['info', '--json=v2', name], { allowNonZero: true, proxy: opts.proxy })
+    return this._parseInfoJson(out)
+  }
+
+  async searchPackage(name, version, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const info = this._fetchInfo(name, opts)
+    const item = info ? info.formula || info.cask : null
+    if (!item) {
+      if (version) return { name, version, exists: false, available: false, registry }
+      return { name, exists: false, registry }
+    }
+    const stable = item.versions?.stable || ''
+    if (version) {
+      return { name, version, exists: true, available: stable === version, registry }
+    }
+    const versions = [stable].filter(Boolean)
+    return {
+      name,
+      exists: true,
+      latest: stable,
+      versions,
+      registry,
+    }
+  }
+
+  async isInstalled(name, opts = {}) {
+    const out = this._exec(['list', '--versions', name], { allowNonZero: true })
+    const items = this._parseListVersions(out)
+    const hit = items.find((i) => i.name === name)
+    if (hit) {
+      return { name, installed: true, version: hit.version }
+    }
+    return { name, installed: false }
+  }
+
+  async packageInfo(name, opts = {}) {
+    const info = this._fetchInfo(name, opts)
+    const item = info ? info.formula || info.cask : null
+    if (!item) {
+      return { name, description: '(not found)' }
+    }
+    return {
+      name,
+      description: item.desc || '',
+      latest: item.versions?.stable || '',
+      homepage: item.homepage || '',
+      license: item.license || '',
+      author: '',
+      repository: item.tap || '',
+    }
+  }
+
+  async packageVersions(name, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const info = this._fetchInfo(name, opts)
+    const item = info ? info.formula || info.cask : null
+    const versions = []
+    if (item) {
+      if (item.versions?.stable) versions.push(item.versions.stable)
+      if (item.versions?.head) versions.push(item.versions.head)
+    }
+    return { name, versions, registry }
+  }
+
+  async listInstalled(opts = {}) {
+    const out = this._exec(['list', '--versions'], { allowNonZero: true })
+    return this._parseListVersions(out)
+  }
+
+  async listOutdated(opts = {}) {
+    const out = this._exec(['outdated', '--json=v2'], { allowNonZero: true, proxy: opts.proxy })
+    return this._parseOutdatedJson(out)
+  }
+
+  async install(name, version, opts = {}) {
+    if (!isHomebrewInstalled()) {
+      console.log('[opm] Homebrew not installed, auto-installing...')
+      installHomebrew()
+    }
+    const spec = version && !name.includes('@') ? `${name}@${version}` : name
+    this._execInherit(['install', spec], { proxy: opts.proxy })
+    return { name, version: version || 'latest', action: 'installed' }
+  }
+
+  async uninstall(name, opts = {}) {
+    this._execInherit(['uninstall', name])
+    return { name, action: 'uninstalled' }
+  }
+
+  async upgrade(name, opts = {}) {
+    this._execInherit(['upgrade', name], { proxy: opts.proxy })
+    return { name, version: 'latest', action: 'upgraded' }
+  }
+
+  async cleanCache() {
+    this._execInherit(['cleanup', '-s', '--prune=all'])
+    return { action: 'cache cleaned' }
+  }
+}