@wwkit/opm 1.0.1

package/src/managers/bun.js

@@ -0,0 +1,342 @@
+/**
+ * bun 包管理器实现
+ *
+ * Bun 是全栈 JS 工具链（runtime + 包管理器 + 打包器）。
+ * 包管理命令通过 bun CLI 实现，源查询通过 HTTP 直接查 npm registry。
+ * 镜像通过 BUN_CONFIG_REGISTRY 环境变量传递给 bun 命令。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { PackageManager } from './base.js'
+import { getActiveRegistry, setActiveRegistry } from '../config.js'
+
+export class BunManager extends PackageManager {
+  constructor() {
+    super()
+    this.name = 'bun'
+  }
+
+  /**
+   * 构造 bun 调用环境（含 registry 镜像 + proxy）
+   * @param {string} [proxy]
+   * @returns {Record<string,string>}
+   * @private
+   */
+  _buildEnv(proxy) {
+    const env = { ...process.env }
+    const registry = getActiveRegistry('bun')
+    if (registry) {
+      env.BUN_CONFIG_REGISTRY = registry
+    }
+    if (proxy) {
+      Object.assign(env, {
+        HTTP_PROXY: proxy,
+        HTTPS_PROXY: proxy,
+        ALL_PROXY: proxy,
+        http_proxy: proxy,
+        https_proxy: proxy,
+        all_proxy: proxy,
+      })
+    }
+    return env
+  }
+
+  /**
+   * 执行 bun 命令，返回 stdout
+   * @param {string[]} args
+   * @param {{ allowNonZero?: boolean, proxy?: string }} [opts]
+   * @returns {string}
+   * @private
+   */
+  _exec(args, opts = {}) {
+    try {
+      return execSync(['bun', ...args].join(' '), {
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        env: this._buildEnv(opts.proxy),
+      })
+    } catch (err) {
+      if (opts.allowNonZero) {
+        return err.stdout ? err.stdout.toString() : ''
+      }
+      const stderr = err.stderr ? err.stderr.toString().trim() : ''
+      if (stderr) {
+        throw new Error(stderr)
+      }
+      return err.stdout ? err.stdout.toString() : ''
+    }
+  }
+
+  /**
+   * 执行 bun 命令并解析 JSON 输出
+   * @param {string[]} args
+   * @param {{ proxy?: string }} [opts]
+   * @returns {*}
+   * @private
+   */
+  _execJson(args, opts = {}) {
+    const out = this._exec([...args], { allowNonZero: true, ...opts })
+    try {
+      return JSON.parse(out)
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * 执行 bun 命令，输出直接继承到终端
+   * @param {string[]} args
+   * @param {{ proxy?: string }} [opts]
+   * @private
+   */
+  _execInherit(args, opts = {}) {
+    const result = spawnSync('bun', args, {
+      stdio: 'inherit',
+      shell: true,
+      env: this._buildEnv(opts.proxy),
+    })
+    if (result.error) {
+      throw new Error(result.error.message)
+    }
+    if (result.status !== 0) {
+      throw new Error(`bun ${args.join(' ')} exited with code ${result.status}`)
+    }
+  }
+
+  /**
+   * 通过 HTTP 查询 npm registry 获取包元数据
+   * @param {string} pkgName
+   * @param {{ proxy?: string }} [opts]
+   * @returns {Promise<object|null>}
+   * @private
+   */
+  async _fetchRegistryMetadata(pkgName, opts = {}) {
+    const registry = getActiveRegistry('bun').replace(/\/$/, '')
+    const url = `${registry}/${encodeURIComponent(pkgName).replace('%40', '@')}`
+    try {
+      const { default: http } = await import('node:http')
+      const { default: https } = await import('node:https')
+      const client = url.startsWith('https') ? https : http
+      const proxyAgent = opts.proxy ? await this._getProxyAgent(opts.proxy) : null
+      return new Promise((resolve) => {
+        const req = client.get(url, { agent: proxyAgent }, (res) => {
+          let data = ''
+          res.on('data', (chunk) => (data += chunk))
+          res.on('end', () => {
+            try {
+              resolve(JSON.parse(data))
+            } catch {
+              resolve(null)
+            }
+          })
+        })
+        req.on('error', () => resolve(null))
+        req.setTimeout(15000, () => {
+          req.destroy()
+          resolve(null)
+        })
+      })
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * 获取 proxy agent（简化实现，仅支持 http proxy）
+   * @param {string} proxy
+   * @returns {Promise<undefined>}
+   * @private
+   */
+  async _getProxyAgent(proxy) {
+    return undefined
+  }
+
+  async getVersion() {
+    try {
+      const version = this._exec(['--version'], { allowNonZero: true }).trim()
+      if (version) {
+        return { name: 'bun', installed: true, version }
+      }
+    } catch {}
+    return { name: 'bun', version: '', installed: false, hint: 'Install Bun from https://bun.sh/ (curl -fsSL https://bun.sh/install | bash)' }
+  }
+
+  async getRegistry() {
+    return { registry: getActiveRegistry('bun') }
+  }
+
+  async setRegistry(url) {
+    const resolved = setActiveRegistry('bun', url)
+    return { registry: resolved }
+  }
+
+  async searchPackage(name, version, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const data = await this._fetchRegistryMetadata(name, opts)
+    if (!data) {
+      if (version) return { name, version, exists: false, available: false, registry }
+      return { name, exists: false, registry }
+    }
+    const versions = data.versions ? Object.keys(data.versions) : []
+    if (version) {
+      return { name, version, exists: true, available: versions.includes(version), registry }
+    }
+    return {
+      name,
+      exists: true,
+      latest: data['dist-tags']?.latest || versions[versions.length - 1] || 'unknown',
+      versions,
+      registry,
+    }
+  }
+
+  async isInstalled(name, opts = {}) {
+    const pkgPath = path.join(process.cwd(), 'node_modules', name, 'package.json')
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+        return { name, installed: true, version: pkg.version, path: path.dirname(pkgPath) }
+      } catch {}
+    }
+
+    if (opts.global) {
+      try {
+        const out = this._exec(['pm', 'ls', '-g'], { allowNonZero: true })
+        if (out.includes(name)) {
+          const m = out.match(new RegExp(`${name}@([\\d.]+)`))
+          return { name, installed: true, version: m ? m[1] : 'unknown', global: true }
+        }
+      } catch {}
+    }
+
+    const declared = this._readDeclaredDeps()
+    if (declared[name]) {
+      return { name, installed: true, version: declared[name] }
+    }
+
+    return { name, installed: false }
+  }
+
+  /**
+   * 读取 package.json 中的依赖声明
+   * @returns {Record<string, string>}
+   * @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 {}
+    }
+  }
+
+  async packageInfo(name, opts = {}) {
+    const data = await this._fetchRegistryMetadata(name, opts)
+    if (!data) {
+      return { name, description: '(not found)' }
+    }
+    const latest = data['dist-tags']?.latest || ''
+    const latestData = latest && data.versions?.[latest] ? data.versions[latest] : data
+    return {
+      name,
+      description: latestData.description || data.description || '',
+      latest,
+      homepage: latestData.homepage || data.homepage || '',
+      license: latestData.license || data.license || '',
+      author: typeof latestData.author === 'object' ? latestData.author?.name || '' : (latestData.author || ''),
+      repository: typeof latestData.repository === 'object' ? latestData.repository?.url || '' : (latestData.repository || ''),
+    }
+  }
+
+  async packageVersions(name, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const data = await this._fetchRegistryMetadata(name, opts)
+    if (!data) {
+      return { name, versions: [], registry }
+    }
+    const versions = data.versions ? Object.keys(data.versions) : []
+    return { name, versions, registry }
+  }
+
+  async listInstalled(opts = {}) {
+    const args = ['pm', 'ls']
+    if (opts.global) args.push('-g')
+    try {
+      const out = this._exec(args, { allowNonZero: true })
+      const items = []
+      for (const line of out.split('\n')) {
+        const m = line.match(/([^\s]+)@([\d.]+)/)
+        if (m) {
+          items.push({ name: m[1], version: m[2], ...(opts.global ? { global: true } : {}) })
+        }
+      }
+      return items
+    } catch {
+      return []
+    }
+  }
+
+  async listOutdated(opts = {}) {
+    const args = ['outdated']
+    if (opts.global) args.push('-g')
+    try {
+      const out = this._exec(args, { allowNonZero: true, proxy: opts.proxy })
+      const items = []
+      const lines = out.split('\n')
+      for (const line of lines) {
+        const parts = line.trim().split(/\s+/)
+        if (parts.length >= 3 && parts[0] !== 'package' && parts[0] !== 'name') {
+          items.push({
+            name: parts[0],
+            current: parts[1] || 'unknown',
+            wanted: parts[1] || '',
+            latest: parts[2] || 'unknown',
+          })
+        }
+      }
+      return items
+    } catch {
+      return []
+    }
+  }
+
+  async install(name, version, opts = {}) {
+    const spec = version ? `${name}@${version}` : name
+    const args = ['add', spec]
+    if (opts.global) args.push('-g')
+
+    this._execInherit(args, { proxy: opts.proxy })
+    return { name, version: version || 'latest', action: 'installed' }
+  }
+
+  async uninstall(name, opts = {}) {
+    const args = ['remove', name]
+    if (opts.global) args.push('-g')
+
+    this._execInherit(args)
+    return { name, action: 'uninstalled' }
+  }
+
+  async upgrade(name, opts = {}) {
+    const args = ['update', name]
+    if (opts.global) args.push('-g')
+
+    this._execInherit(args, { proxy: opts.proxy })
+    return { name, version: 'latest', action: 'upgraded' }
+  }
+
+  async cleanCache() {
+    this._execInherit(['pm', 'cache', 'rm'])
+    return { action: 'cache cleaned' }
+  }
+}

package/src/managers/composer.js

@@ -0,0 +1,280 @@
+/**
+ * composer（PHP）包管理器实现
+ *
+ * 通过执行 composer CLI 命令实现统一接口。
+ * 源查询使用 Packagist P2 元数据端点（{registry}/p2/{vendor}/{package}.json），
+ * 本地查询读取 vendor/composer/installed.json 或 composer CLI。
+ *
+ * composer 无 per-command registry 标记，镜像仅作用于源查询（P2 元数据拉取）；
+ * install/upgrade 使用 composer CLI 自身的仓库配置（项目 composer.json / 全局 config）。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { PackageManager } from './base.js'
+import { fetchText } from './http.js'
+import { getActiveRegistry, setActiveRegistry } from '../config.js'
+
+export class ComposerManager extends PackageManager {
+  constructor() {
+    super()
+    this.name = 'composer'
+  }
+
+  /**
+   * 执行 composer 命令，返回 stdout
+   * @param {string[]} args
+   * @param {{ allowNonZero?: boolean, proxy?: string }} [opts]
+   * @returns {string}
+   * @private
+   */
+  _exec(args, opts = {}) {
+    const cmd = ['composer', ...args].join(' ')
+    try {
+      return execSync(cmd, {
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        env: this._buildEnv(opts.proxy),
+      })
+    } catch (err) {
+      if (opts.allowNonZero) {
+        return err.stdout ? err.stdout.toString() : ''
+      }
+      const stderr = err.stderr ? err.stderr.toString().trim() : ''
+      if (stderr) {
+        throw new Error(stderr)
+      }
+      return err.stdout ? err.stdout.toString() : ''
+    }
+  }
+
+  /**
+   * 执行 composer 命令，输出直接继承到终端
+   * @param {string[]} args
+   * @param {{ proxy?: string }} [opts]
+   * @private
+   */
+  _execInherit(args, opts = {}) {
+    const result = spawnSync('composer', args, {
+      stdio: 'inherit',
+      shell: true,
+      env: this._buildEnv(opts.proxy),
+    })
+    if (result.error) {
+      throw new Error(result.error.message)
+    }
+    if (result.status !== 0) {
+      throw new Error(`composer ${args.join(' ')} exited with code ${result.status}`)
+    }
+  }
+
+  /**
+   * 构造 composer 命令环境（代理 via 标准 env vars）
+   * @param {string} [proxy]
+   * @returns {Record<string,string>}
+   * @private
+   */
+  _buildEnv(proxy) {
+    const env = { ...process.env }
+    if (proxy) {
+      Object.assign(env, {
+        HTTP_PROXY: proxy,
+        HTTPS_PROXY: proxy,
+        ALL_PROXY: proxy,
+        http_proxy: proxy,
+        https_proxy: proxy,
+        all_proxy: proxy,
+      })
+    }
+    return env
+  }
+
+  /**
+   * 获取激活镜像 base URL（P2 元数据端点基础）
+   * @returns {string}
+   * @private
+   */
+  _getBaseRegistry() {
+    return getActiveRegistry('composer') || 'https://repo.packagist.org'
+  }
+
+  /**
+   * 构造 Packagist P2 元数据 URL
+   * @param {string} name - 包名（vendor/package）
+   * @returns {string}
+   * @private
+   */
+  _buildP2Url(name) {
+    const base = this._getBaseRegistry().replace(/\/+$/, '')
+    return `${base}/p2/${name}.json`
+  }
+
+  /**
+   * 通过 P2 元数据端点查询包信息
+   * @param {string} name
+   * @param {{ proxy?: string }} [opts]
+   * @returns {Promise<object|null>} 包条目数组或 null
+   * @private
+   */
+  async _fetchMetadata(name, opts = {}) {
+    if (!name.includes('/')) return null
+    const url = this._buildP2Url(name)
+    const text = await fetchText(url, { proxy: opts.proxy })
+    if (!text) return null
+    try {
+      const data = JSON.parse(text)
+      const entries = data?.packages?.[name]
+      if (Array.isArray(entries) && entries.length > 0) return entries
+    } catch {}
+    return null
+  }
+
+  /**
+   * 从 P2 元数据条目中提取稳定最新版本
+   * @param {object[]} entries
+   * @returns {string}
+   * @private
+   */
+  _pickLatest(entries) {
+    for (const entry of entries) {
+      const v = entry.version || ''
+      if (v && !v.includes('dev') && !v.includes('-beta') && !v.includes('-RC') && !v.includes('-alpha')) {
+        return v
+      }
+    }
+    return entries[0]?.version || ''
+  }
+
+  async getVersion() {
+    try {
+      const out = this._exec(['--version'], { allowNonZero: true })
+      const match = out.match(/Composer version\s+(\S+)/)
+      if (match) {
+        return { name: 'composer', installed: true, version: match[1] }
+      }
+    } catch {}
+    return { name: 'composer', version: '', installed: false, hint: 'Install Composer from https://getcomposer.org/' }
+  }
+
+  async getRegistry() {
+    return { registry: getActiveRegistry('composer') }
+  }
+
+  async setRegistry(url) {
+    const resolved = setActiveRegistry('composer', url)
+    return { registry: resolved }
+  }
+
+  async searchPackage(name, version, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const entries = await this._fetchMetadata(name, opts)
+    if (!entries) {
+      if (version) return { name, version, exists: false, available: false, registry }
+      return { name, exists: false, registry }
+    }
+    const versions = entries.map((e) => e.version).filter(Boolean)
+    const latest = this._pickLatest(entries)
+    if (version) {
+      return { name, version, exists: true, available: versions.includes(version), registry }
+    }
+    return { name, exists: true, latest, versions, registry }
+  }
+
+  /**
+   * 读取项目本地 vendor/composer/installed.json
+   * @returns {object[]|null}
+   * @private
+   */
+  _readInstalledJson() {
+    const p = path.join(process.cwd(), 'vendor', 'composer', 'installed.json')
+    if (!fs.existsSync(p)) return null
+    try {
+      const data = JSON.parse(fs.readFileSync(p, 'utf8'))
+      return Array.isArray(data.packages) ? data.packages : null
+    } catch {
+      return null
+    }
+  }
+
+  async isInstalled(name, opts = {}) {
+    const packages = this._readInstalledJson()
+    if (packages) {
+      const pkg = packages.find((p) => p.name === name)
+      if (pkg) {
+        return { name, installed: true, version: pkg.version || 'unknown' }
+      }
+      return { name, installed: false }
+    }
+    return { name, installed: false }
+  }
+
+  async packageInfo(name, opts = {}) {
+    const entries = await this._fetchMetadata(name, opts)
+    if (!entries) {
+      return { name, description: '(not found)' }
+    }
+    const entry = entries[0]
+    return {
+      name,
+      description: entry.description || '',
+      latest: this._pickLatest(entries),
+      homepage: entry.homepage || '',
+      license: Array.isArray(entry.license) ? entry.license.join(', ') : (entry.license || ''),
+      author: Array.isArray(entry.authors) ? (entry.authors[0]?.name || '') : '',
+      repository: entry.source?.url || entry.homepage || '',
+    }
+  }
+
+  async packageVersions(name, opts = {}) {
+    const { registry } = await this.getRegistry()
+    const entries = await this._fetchMetadata(name, opts)
+    const versions = entries ? entries.map((e) => e.version).filter(Boolean) : []
+    return { name, versions, registry }
+  }
+
+  async listInstalled(opts = {}) {
+    const packages = this._readInstalledJson()
+    if (!packages) return []
+    return packages.map((p) => ({
+      name: p.name,
+      version: p.version || 'unknown',
+    }))
+  }
+
+  async listOutdated(opts = {}) {
+    const out = this._exec(['outdated', '--format=json'], { allowNonZero: true, proxy: opts.proxy })
+    try {
+      const data = JSON.parse(out)
+      const installed = Array.isArray(data.installed) ? data.installed : []
+      return installed.map((item) => ({
+        name: item.name,
+        current: item.version || '',
+        latest: item.latest || '',
+      }))
+    } catch {
+      return []
+    }
+  }
+
+  async install(name, version, opts = {}) {
+    const spec = version ? `${name}:${version}` : name
+    this._execInherit(['require', spec, '--no-interaction'], { proxy: opts.proxy })
+    return { name, version: version || 'latest', action: 'installed' }
+  }
+
+  async uninstall(name, opts = {}) {
+    this._execInherit(['remove', name, '--no-interaction'])
+    return { name, action: 'uninstalled' }
+  }
+
+  async upgrade(name, opts = {}) {
+    this._execInherit(['update', name, '--no-interaction'], { proxy: opts.proxy })
+    return { name, version: 'latest', action: 'upgraded' }
+  }
+
+  async cleanCache() {
+    this._execInherit(['clear-cache'])
+    return { action: 'cache cleaned' }
+  }
+}