@wwkit/opm 1.0.1 → 1.0.3

package/src/tools/ftp/util.js

@@ -0,0 +1,174 @@
+/**
+ * FTP 工具函数 — exclude 匹配、MD5、图片检测、自动命名、HTTP 源下载
+ */
+
+import crypto from 'node:crypto'
+import fs from 'node:fs'
+import path from 'node:path'
+
+const IMAGE_MAGIC = {
+  jpg: Buffer.from([0xff, 0xd8, 0xff]),
+  png: Buffer.from([0x89, 0x50, 0x4e, 0x47]),
+  gif: Buffer.from([0x47, 0x49, 0x46, 0x38]),
+  webp: Buffer.from([0x52, 0x49, 0x46, 0x46]),
+}
+
+/**
+ * glob 通配符匹配（支持 * 和 **）
+ * @param {string} relPath - 相对路径（posix 风格）
+ * @param {string} pattern - glob 模式
+ * @returns {boolean}
+ */
+export function matchGlob(relPath, pattern) {
+  const regex = globToRegex(pattern)
+  return regex.test(relPath)
+}
+
+function globToRegex(pattern) {
+  let re = ''
+  let i = 0
+  while (i < pattern.length) {
+    if (pattern[i] === '*' && pattern[i + 1] === '*') {
+      re += '.*'
+      i += 2
+    } else if (pattern[i] === '*') {
+      re += '[^/]*'
+      i++
+    } else if (pattern[i] === '?') {
+      re += '[^/]'
+      i++
+    } else if ('.+^$(){}|[]\\'.includes(pattern[i])) {
+      re += '\\' + pattern[i]
+      i++
+    } else {
+      re += pattern[i]
+      i++
+    }
+  }
+  return new RegExp('^' + re + '$')
+}
+
+/**
+ * 判断路径是否被排除
+ * @param {string} relPath - 相对路径（posix）
+ * @param {string[]} excludes - 排除模式列表
+ * @returns {boolean}
+ */
+export function isExcluded(relPath, excludes) {
+  for (const pattern of excludes) {
+    const p = pattern.trim()
+    if (!p) continue
+    if (matchGlob(relPath, p) || matchGlob(relPath, `${p}/**`)) {
+      return true
+    }
+  }
+  return false
+}
+
+/**
+ * 计算文件 MD5（流式，避免大文件占内存）
+ * @param {string} filePath
+ * @returns {Promise<string>}
+ */
+export async function md5File(filePath) {
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('md5')
+    const stream = fs.createReadStream(filePath)
+    stream.on('data', (chunk) => hash.update(chunk))
+    stream.on('end', () => resolve(hash.digest('hex')))
+    stream.on('error', reject)
+  })
+}
+
+/**
+ * 计算 Buffer MD5
+ * @param {Buffer} data
+ * @returns {string}
+ */
+export function md5Buffer(data) {
+  return crypto.createHash('md5').update(data).digest('hex')
+}
+
+/**
+ * 从 magic bytes 检测图片扩展名
+ * @param {Buffer} data
+ * @returns {string|null}
+ */
+export function detectImageExt(data) {
+  for (const [ext, magic] of Object.entries(IMAGE_MAGIC)) {
+    if (data.subarray(0, magic.length).equals(magic)) {
+      return ext
+    }
+  }
+  return null
+}
+
+/**
+ * 从文件名提取扩展名（仅限图片类型）
+ * @param {string} name
+ * @returns {string|null}
+ */
+export function extFromName(name) {
+  const clean = name.split('?')[0]
+  const ext = path.extname(clean).slice(1).toLowerCase()
+  return ext in IMAGE_MAGIC ? ext : null
+}
+
+/**
+ * 生成随机文件名
+ * @param {string} ext
+ * @returns {string}
+ */
+export function makeFilename(ext) {
+  const id = crypto.randomUUID().replace(/-/g, '').slice(0, 8)
+  return `${id}.${ext}`
+}
+
+/**
+ * 今天的日期字符串 YYYYMMDD
+ * @returns {string}
+ */
+export function todayStr() {
+  const d = new Date()
+  const y = d.getFullYear()
+  const m = String(d.getMonth() + 1).padStart(2, '0')
+  const day = String(d.getDate()).padStart(2, '0')
+  return `${y}${m}${day}`
+}
+
+/**
+ * 读取本地文件或下载 HTTP URL 为 Buffer
+ * @param {string} urlOrPath
+ * @param {number} [timeout=120000]
+ * @returns {Promise<Buffer>}
+ */
+export async function readData(urlOrPath, timeout = 120000) {
+  if (urlOrPath.startsWith('http://') || urlOrPath.startsWith('https://')) {
+    const resp = await fetch(urlOrPath, { signal: AbortSignal.timeout(timeout) })
+    if (!resp.ok) throw new Error(`HTTP ${resp.status}: ${urlOrPath}`)
+    return Buffer.from(await resp.arrayBuffer())
+  }
+  if (!fs.existsSync(urlOrPath)) throw new Error(`File not found: ${urlOrPath}`)
+  return fs.readFileSync(urlOrPath)
+}
+
+/**
+ * 递归收集目录下所有文件（posix 相对路径）
+ * @param {string} dir
+ * @returns {string[]}
+ */
+export function collectFiles(dir) {
+  const result = []
+  function walk(base) {
+    for (const entry of fs.readdirSync(base, { withFileTypes: true })) {
+      const full = path.join(base, entry.name)
+      if (entry.isDirectory()) {
+        walk(full)
+      } else if (entry.isFile()) {
+        result.push(path.relative(dir, full).split(path.sep).join('/'))
+      }
+    }
+  }
+  walk(dir)
+  return result.sort()
+}

package/src/tools/git/config.js

@@ -0,0 +1,374 @@
+/**
+ * git 配置管理 — config/user/init/export/mark/version/install/uninstall/upgrade 实现
+ *
+ * 通过 git config CLI 读写配置，支持 --global/--local/--system 作用域。
+ * init 根据 opm config 的 git 段一键初始化全局配置。
+ * export 保存两个 commit 之间的差异到文件（默认从 mark 到 HEAD）。
+ * mark 用 lightweight git tag（opm-diff-base）标记基准 commit。
+ * version/install/uninstall/upgrade 管理 git 自身的系统安装。
+ */
+
+import { execSync, spawnSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { getConfig } from '../../config.js'
+
+const MARK_TAG = 'opm-diff-base'
+
+/**
+ * 作用域映射到 git config 参数
+ * @param {string} scope - global|local|system
+ * @returns {string}
+ */
+function scopeArg(scope) {
+  if (scope === 'local') return '--local'
+  if (scope === 'system') return '--system'
+  return '--global'
+}
+
+/**
+ * 执行 git config 命令（静默 stderr）
+ * @param {string[]} args
+ * @returns {string}
+ */
+function gitConfig(args) {
+  try {
+    return execSync(`git config ${args.join(' ')}`, { encoding: 'utf8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim()
+  } catch {
+    return ''
+  }
+}
+
+/**
+ * 获取配置文件路径
+ * @param {string} scope
+ * @returns {string}
+ */
+function getConfigFile(scope) {
+  const raw = gitConfig([scopeArg(scope), '--list', '--show-origin'])
+  const firstLine = raw.split('\n')[0] || ''
+  const m = firstLine.match(/^file:([^\t]+)/)
+  return m ? m[1] : ''
+}
+
+/**
+ * 列出全部配置
+ * @param {string} scope
+ * @returns {{file: string, config: Record<string, string>}}
+ */
+export function listConfig(scope) {
+  const arg = scopeArg(scope)
+  const raw = gitConfig([arg, '--list'])
+  const config = {}
+  for (const line of raw.split('\n')) {
+    if (!line) continue
+    const idx = line.indexOf('=')
+    if (idx > 0) {
+      config[line.slice(0, idx)] = line.slice(idx + 1)
+    }
+  }
+  return { file: getConfigFile(scope), config }
+}
+
+/**
+ * 获取单个配置值
+ * @param {string} key
+ * @param {string} scope
+ * @returns {string}
+ */
+export function getConfigValue(key, scope) {
+  return gitConfig([scopeArg(scope), '--get', key])
+}
+
+/**
+ * 设置配置值
+ * @param {string} key
+ * @param {string} value
+ * @param {string} scope
+ * @returns {boolean}
+ */
+export function setConfigValue(key, value, scope) {
+  try {
+    execSync(`git config ${scopeArg(scope)} ${key} "${value}"`, { timeout: 5000 })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 取消配置项
+ * @param {string} key
+ * @param {string} scope
+ * @returns {boolean}
+ */
+export function unsetConfigValue(key, scope) {
+  try {
+    execSync(`git config ${scopeArg(scope)} --unset ${key}`, { timeout: 5000 })
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 获取 user 信息
+ * @param {string} scope
+ * @returns {{name: string, email: string}}
+ */
+export function getUser(scope) {
+  return {
+    name: getConfigValue('user.name', scope),
+    email: getConfigValue('user.email', scope),
+  }
+}
+
+/**
+ * 设置 user 信息
+ * @param {string} name
+ * @param {string} email
+ * @param {string} scope
+ * @returns {{name: boolean, email: boolean}}
+ */
+export function setUser(name, email, scope) {
+  const result = {}
+  if (name) result.name = setConfigValue('user.name', name, scope)
+  if (email) result.email = setConfigValue('user.email', email, scope)
+  return result
+}
+
+/**
+ * 一键初始化 git 全局配置
+ * 根据 opm config 的 git 段设置 user/ssl/pull.rebase
+ * @param {boolean} force - 强制覆盖已有配置
+ * @returns {Promise<object>}
+ */
+export async function initGitConfig(force) {
+  const cfg = getConfig().git || {}
+  const scope = 'global'
+  const items = []
+  let set = 0
+  let skip = 0
+  let overwrite = 0
+
+  const tasks = [
+    { key: 'user.name', value: cfg.user?.name || '' },
+    { key: 'user.email', value: cfg.user?.email || '' },
+    { key: 'http.sslVerify', value: cfg.sslVerify === false ? 'false' : 'true' },
+    { key: 'pull.rebase', value: cfg.pullRebase === true ? 'true' : 'false' },
+  ]
+
+  for (const task of tasks) {
+    if (!task.value && task.value !== 'false') continue
+    const existing = getConfigValue(task.key, scope)
+    if (existing && !force) {
+      items.push({ key: task.key, value: task.value, action: 'skip', existing })
+      skip++
+    } else if (existing && force) {
+      setConfigValue(task.key, task.value, scope)
+      items.push({ key: task.key, value: task.value, action: 'overwrite', existing })
+      overwrite++
+    } else {
+      setConfigValue(task.key, task.value, scope)
+      items.push({ key: task.key, value: task.value, action: 'set' })
+      set++
+    }
+  }
+
+  return { scope, items, summary: { set, skip, overwrite } }
+}
+
+/**
+ * 获取 mark 标记的 commit 信息
+ * @param {string} workDir
+ * @returns {{commit: string, message: string}|null}
+ */
+export function getMark(workDir) {
+  const opts = { encoding: 'utf8', timeout: 5000, cwd: workDir, stdio: ['pipe', 'pipe', 'pipe'] }
+  try {
+    const hash = execSync(`git rev-list -n 1 ${MARK_TAG}`, opts).trim()
+    const message = execSync(`git log -1 --format=%s ${hash}`, opts).trim()
+    return { commit: hash, message }
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 设置 mark 标记（在指定 commit 上打 tag，已存在则先删后打）
+ * @param {string} workDir
+ * @param {string} [ref='HEAD'] - commit ref
+ * @returns {{commit: string, message: string}}
+ */
+export function setMark(workDir, ref = 'HEAD') {
+  const opts = { encoding: 'utf8', timeout: 5000, cwd: workDir, stdio: ['pipe', 'pipe', 'pipe'] }
+  try {
+    execSync(`git tag -d ${MARK_TAG}`, opts)
+  } catch {}
+  execSync(`git tag ${MARK_TAG} ${ref}`, opts)
+  const hash = execSync(`git rev-list -n 1 ${MARK_TAG}`, opts).trim()
+  const message = execSync(`git log -1 --format=%s ${hash}`, opts).trim()
+  return { commit: hash, message }
+}
+
+/**
+ * 删除 mark 标记
+ * @param {string} workDir
+ * @returns {boolean}
+ */
+export function unsetMark(workDir) {
+  const opts = { encoding: 'utf8', timeout: 5000, cwd: workDir, stdio: ['pipe', 'pipe', 'pipe'] }
+  try {
+    execSync(`git tag -d ${MARK_TAG}`, opts)
+    return true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 导入 diff 文件到工作目录
+ * @param {string} workDir - git 仓库工作目录
+ * @param {string} diffFile - diff 文件路径
+ * @returns {{workDir: string, diffFile: string, applied: boolean, rejected: string[]}}
+ */
+export function importDiff(workDir, diffFile) {
+  const opts = { encoding: 'utf8', timeout: 30000, cwd: workDir, stdio: ['pipe', 'pipe', 'pipe'] }
+  const resolved = path.resolve(diffFile)
+  if (!fs.existsSync(resolved)) {
+    return { workDir, diffFile: resolved, applied: false, error: 'File not found' }
+  }
+
+  try {
+    execSync(`git apply --reject ${resolved}`, opts)
+    return { workDir, diffFile: resolved, applied: true, rejected: [] }
+  } catch (err) {
+    const stderr = err.stderr ? err.stderr.toString() : ''
+    const rejFiles = stderr.match(/\.rej/g) ? fs.readdirSync(workDir).filter(f => f.endsWith('.rej')) : []
+    return { workDir, diffFile: resolved, applied: false, rejected: rejFiles, error: stderr.trim() || err.message }
+  }
+}
+
+/**
+ * 保存两个 commit 之间的差异到文件
+ * 执行前若有未提交变更，自动 commit（含未跟踪文件），确保所有变动都在 HEAD 中。
+ * @param {string} workDir - git 仓库工作目录
+ * @param {string} outputFile - 输出文件路径
+ * @param {string} fromRef - 起始 commit ref（mark tag 或 HEAD~n）
+ * @returns {{workDir: string, file: string, lines: number, from: string, to: string, autoCommitted: boolean}}
+ */
+export function saveDiff(workDir, outputFile, fromRef) {
+  const opts = { encoding: 'utf8', maxBuffer: 50 * 1024 * 1024, timeout: 30000, cwd: workDir, stdio: ['pipe', 'pipe', 'pipe'] }
+
+  let autoCommitted = false
+  const status = execSync('git status --porcelain', { ...opts, timeout: 5000 }).trim()
+  if (status) {
+    execSync('git add -A', { ...opts, timeout: 5000 })
+    execSync('git commit -m "wip: auto-commit before export"', { ...opts, timeout: 10000 })
+    autoCommitted = true
+  }
+
+  const fromMessage = execSync(`git log -1 --format=%s ${fromRef}`, { ...opts, timeout: 5000 }).trim()
+  const diff = execSync(`git diff ${fromRef} HEAD`, opts)
+  fs.writeFileSync(outputFile, diff, 'utf8')
+  const lines = diff ? diff.split('\n').length : 0
+  return { workDir, file: outputFile, lines, from: fromRef, fromMessage, to: 'HEAD', autoCommitted }
+}
+
+/**
+ * 检测系统包管理器
+ * @returns {{cmd: string, installArgs: string[], uninstallArgs: string[], upgradeArgs: string[]}|null}
+ */
+function detectPm() {
+  const candidates = [
+    { cmd: 'dnf', install: ['install', '-y'], uninstall: ['remove', '-y'], upgrade: ['upgrade', '-y'] },
+    { cmd: 'yum', install: ['install', '-y'], uninstall: ['remove', '-y'], upgrade: ['upgrade', '-y'] },
+    { cmd: 'apt-get', install: ['install', '-y'], uninstall: ['remove', '-y'], upgrade: ['install', '--only-upgrade', '-y'] },
+    { cmd: 'apk', install: ['add'], uninstall: ['del'], upgrade: ['upgrade'] },
+  ]
+  for (const c of candidates) {
+    try {
+      execSync(`command -v ${c.cmd}`, { encoding: 'utf8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] })
+      return {
+        cmd: c.cmd,
+        installArgs: c.install,
+        uninstallArgs: c.uninstall,
+        upgradeArgs: c.upgrade,
+      }
+    } catch {}
+  }
+  return null
+}
+
+/**
+ * 查询 git 版本
+ * @returns {{installed: boolean, version?: string, path?: string, hint?: string}}
+ */
+export function getGitVersion() {
+  try {
+    const out = execSync('git --version', { encoding: 'utf8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] }).trim()
+    const match = out.match(/(\d+(?:\.\d+)+)/)
+    let path = ''
+    try {
+      path = execSync('command -v git', { encoding: 'utf8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] }).trim()
+    } catch {}
+    return { installed: true, version: match ? match[1] : out, path }
+  } catch {
+    return { installed: false, hint: 'Run `opm git install` to install git' }
+  }
+}
+
+/**
+ * 安装 git（通过系统包管理器）
+ * @param {string} [proxy]
+ * @returns {{action: string, pm?: string, error?: string}}
+ */
+export function installGit(proxy) {
+  const pm = detectPm()
+  if (!pm) {
+    return { action: 'install', error: 'No supported package manager found (dnf/yum/apt-get/apk)' }
+  }
+  const args = [...pm.installArgs, 'git']
+  if (proxy && pm.cmd !== 'apk') args.push(`--proxy=${proxy}`)
+  const result = spawnSync(pm.cmd, args, { stdio: 'inherit', shell: true })
+  if (result.error || result.status !== 0) {
+    return { action: 'install', pm: pm.cmd, error: result.error ? result.error.message : `exited with code ${result.status}` }
+  }
+  return { action: 'installed', pm: pm.cmd }
+}
+
+/**
+ * 卸载 git（通过系统包管理器）
+ * @returns {{action: string, pm?: string, error?: string}}
+ */
+export function uninstallGit() {
+  const pm = detectPm()
+  if (!pm) {
+    return { action: 'uninstall', error: 'No supported package manager found (dnf/yum/apt-get/apk)' }
+  }
+  const args = [...pm.uninstallArgs, 'git']
+  const result = spawnSync(pm.cmd, args, { stdio: 'inherit', shell: true })
+  if (result.error || result.status !== 0) {
+    return { action: 'uninstall', pm: pm.cmd, error: result.error ? result.error.message : `exited with code ${result.status}` }
+  }
+  return { action: 'uninstalled', pm: pm.cmd }
+}
+
+/**
+ * 升级 git（通过系统包管理器）
+ * @param {string} [proxy]
+ * @returns {{action: string, pm?: string, error?: string}}
+ */
+export function upgradeGit(proxy) {
+  const pm = detectPm()
+  if (!pm) {
+    return { action: 'upgrade', error: 'No supported package manager found (dnf/yum/apt-get/apk)' }
+  }
+  const args = [...pm.upgradeArgs, 'git']
+  if (proxy && pm.cmd !== 'apk') args.push(`--proxy=${proxy}`)
+  const result = spawnSync(pm.cmd, args, { stdio: 'inherit', shell: true })
+  if (result.error || result.status !== 0) {
+    return { action: 'upgrade', pm: pm.cmd, error: result.error ? result.error.message : `exited with code ${result.status}` }
+  }
+  return { action: 'upgraded', pm: pm.cmd }
+}