sdkvm 1.0.2 → 1.0.4

package/dist/index.js

@@ -3521,7 +3521,7 @@ var log = {
 };
 
 // src/cli/install.ts
-import fs10 from "fs";
+import fs11 from "fs";
 import path9 from "path";
 
 // src/core/platform.ts
@@ -3809,6 +3809,63 @@ function parseNodeUserSpec(input) {
     hint: "Expected: 22, 22.20.0, lts, latest, or with vendor prefix like nodejs-22.20.0"
   });
 }
+var MAVEN_VENDOR_IDS = ["maven"];
+function parseMavenVersion(vendor, input) {
+  const raw = input.trim();
+  const s = raw.replace(/^maven-/i, "").replace(/^v/i, "");
+  const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(s);
+  if (!m || !m[1] || !m[2] || !m[3]) {
+    throw new SdkvmError(`Invalid Maven version: "${input}"`, {
+      hint: "Expected forms: 3, 3.9, 3.9.9, 4.0.0-rc-4, latest"
+    });
+  }
+  return {
+    vendor,
+    major: Number(m[1]),
+    minor: Number(m[2]),
+    patch: Number(m[3]),
+    extra: m[4] ?? null,
+    build: null,
+    raw
+  };
+}
+function formatMavenVersion(v) {
+  const base = `${v.major}.${v.minor}.${v.patch ?? 0}`;
+  return v.extra ? `${base}-${v.extra}` : base;
+}
+function parseMavenDirName(dir) {
+  const m = new RegExp(`^(${MAVEN_VENDOR_IDS.join("|")})-(.+)$`).exec(dir);
+  if (!m || !m[1] || !m[2]) return null;
+  try {
+    return parseMavenVersion(m[1], m[2]);
+  } catch {
+    return null;
+  }
+}
+function parseMavenUserSpec(input) {
+  let s = input.trim().toLowerCase();
+  let vendor;
+  const m = /^(maven)-(.+)$/.exec(s);
+  if (m && m[2]) {
+    vendor = "maven";
+    s = m[2];
+  }
+  if (s === "latest") return { vendor, spec: { kind: "latest" } };
+  if (s === "lts" || s === "--lts") {
+    throw new SdkvmError(`Invalid Maven version: "${input}"`, {
+      hint: 'Maven has no lts alias \u2014 use "3", "3.9", "3.9.9", or "latest"'
+    });
+  }
+  if (/^\d+\.\d+\.\d+(-[0-9a-z.\-]+)?$/.test(s)) return { vendor, spec: { kind: "full", version: s } };
+  const line = /^(\d+)\.(\d+)$/.exec(s);
+  if (line && line[1] && line[2]) {
+    return { vendor, spec: { kind: "line", major: Number(line[1]), minor: Number(line[2]) } };
+  }
+  if (/^\d+$/.test(s)) return { vendor, spec: { kind: "major", major: Number(s) } };
+  throw new SdkvmError(`Invalid Maven version: "${input}"`, {
+    hint: "Expected: 3, 3.9, 3.9.9, 4.0.0-rc-4, latest, or with vendor prefix like maven-3.9.9"
+  });
+}
 
 // src/core/lock.ts
 import fs5 from "fs";
@@ -4399,16 +4456,109 @@ var nodejsVendor = {
   }
 };
 
+// src/vendor/maven.ts
+var META_URL = "https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/maven-metadata.xml";
+var REPO = "https://repo.maven.apache.org/maven2";
+var MIN_MAJOR = 3;
+function tryParse(raw) {
+  try {
+    const v = parseMavenVersion("maven", raw);
+    if (v.major < MIN_MAJOR) return null;
+    return { raw, v, stable: v.extra === null };
+  } catch {
+    return null;
+  }
+}
+async function fetchListed() {
+  const xml = await httpText(META_URL);
+  const out = [];
+  for (const m of xml.matchAll(/<version>([^<]+)<\/version>/g)) {
+    const raw = m[1];
+    if (!raw) continue;
+    const parsed = tryParse(raw);
+    if (parsed) out.push(parsed);
+  }
+  return out;
+}
+function stablesDesc(listed) {
+  return listed.filter((x) => x.stable).sort((a, b) => compareVersions(b.v, a.v));
+}
+function specLabel3(spec) {
+  if (spec.kind === "major") return String(spec.major);
+  if (spec.kind === "line") return `${spec.major}.${spec.minor}`;
+  if (spec.kind === "full") return spec.version;
+  return spec.kind;
+}
+function buildArtifact4(v, platform) {
+  const display = formatMavenVersion(v);
+  const ext = platform.os === "windows" ? "zip" : "tar.gz";
+  const filename = `apache-maven-${display}-bin.${ext}`;
+  const downloadUrl = `${REPO}/org/apache/maven/apache-maven/${display}/${filename}`;
+  return {
+    vendorId: "maven",
+    version: v,
+    dirName: `maven-${display}`,
+    displayName: `Apache Maven ${display}`,
+    downloadUrl,
+    checksum: { kind: "sha512", url: `${downloadUrl}.sha512` },
+    archive: ext === "zip" ? "zip" : "tar.gz"
+  };
+}
+var mavenVendor = {
+  id: "maven",
+  label: "Apache Maven",
+  sdk: "maven",
+  supportsFullVersionList: true,
+  /** 一条 minor 线（3.9）只含稳定版；预发布不单独成线 */
+  async listMajors() {
+    const versions = stablesDesc(await fetchListed());
+    const lines = /* @__PURE__ */ new Map();
+    for (const { v } of versions) {
+      const key = `${v.major}.${v.minor}`;
+      const cur = lines.get(key);
+      if (!cur || compareVersions(v, cur) > 0) lines.set(key, v);
+    }
+    return [...lines.entries()].sort((a, b) => compareVersions(b[1], a[1])).map(([key, v]) => ({ key, lts: false, latestFullVersion: formatMavenVersion(v) }));
+  },
+  async resolve(spec, platform) {
+    if (spec.kind === "lts") {
+      throw new SdkvmError("Unsupported version spec for Maven: lts", {
+        hint: 'Maven has no lts alias \u2014 use "3", "3.9", "3.9.9", or "latest"'
+      });
+    }
+    const listed = await fetchListed();
+    const stables = stablesDesc(listed);
+    let target;
+    if (spec.kind === "latest") {
+      target = stables[0];
+    } else if (spec.kind === "major") {
+      target = stables.find((x) => x.v.major === spec.major);
+    } else if (spec.kind === "line") {
+      target = stables.find((x) => x.v.major === spec.major && x.v.minor === spec.minor);
+    } else {
+      target = listed.find((x) => formatMavenVersion(x.v) === spec.version);
+    }
+    if (!target) {
+      throw new SdkvmError(`No Maven release matches "${specLabel3(spec)}"`, {
+        hint: `Run \`${cmdPath("maven")} ls -r\` to see available versions.`
+      });
+    }
+    return buildArtifact4(target.v, platform);
+  }
+};
+
 // src/vendor/index.ts
 var JAVA_VENDORS = [temurinVendor, zuluVendor, correttoVendor];
 var GO_VENDORS = [golangVendor];
 var FLUTTER_VENDORS = [flutterVendor];
 var NODE_VENDORS = [nodejsVendor];
+var MAVEN_VENDORS = [mavenVendor];
 function vendorsFor(type) {
   if (type === "java") return JAVA_VENDORS;
   if (type === "go") return GO_VENDORS;
   if (type === "flutter") return FLUTTER_VENDORS;
   if (type === "node") return NODE_VENDORS;
+  if (type === "maven") return MAVEN_VENDORS;
   throw new SdkvmError(`Unknown SDK type: ${type}`);
 }
 function allVendorIds(type) {
@@ -4536,14 +4686,40 @@ var nodeSdk = {
   versionCheck: { args: ["--version"], stream: "stdout" }
 };
 
+// src/sdk/maven.ts
+var mavenSdk = {
+  id: "maven",
+  label: "Maven",
+  installDirName: "mavens",
+  currentLinkName: "current-maven",
+  envVar: "MAVEN_HOME",
+  supportsLts: false,
+  requiresJdk: true,
+  vendors: MAVEN_VENDORS,
+  parseUserSpec: parseMavenUserSpec,
+  parseDirName: parseMavenDirName,
+  formatVersion: formatMavenVersion,
+  compareVersions,
+  binRelPath(platform) {
+    return `bin/${platform.os === "windows" ? "mvn.cmd" : "mvn"}`;
+  },
+  envBinSuffix(platform) {
+    return platform.os === "windows" ? "\\bin" : "/bin";
+  },
+  // 归档是单根 apache-maven-<version>/ 目录
+  locateHome: (root) => root,
+  versionCheck: { args: ["-version"], stream: "stdout" }
+};
+
 // src/sdk/index.ts
 var SPECS = {
   java: javaSdk,
   go: goSdk,
   flutter: flutterSdk,
-  node: nodeSdk
+  node: nodeSdk,
+  maven: mavenSdk
 };
-var SDK_TYPES = ["java", "go", "flutter", "node"];
+var SDK_TYPES = ["java", "go", "flutter", "node", "maven"];
 function getSdkType(id) {
   const spec = SPECS[id];
   if (!spec) throw new SdkvmError(`Unknown SDK type: ${id}`);
@@ -4724,7 +4900,7 @@ function updateConfig(mutator) {
 }
 
 // src/vendor/mirror.ts
-var MIRROR_REWRITE_VENDORS = /* @__PURE__ */ new Set(["temurin", "golang", "flutter", "nodejs"]);
+var MIRROR_REWRITE_VENDORS = /* @__PURE__ */ new Set(["temurin", "golang", "flutter", "nodejs", "maven"]);
 function applyMirrorDetail(artifact, platform, mirrorRoot) {
   if (!mirrorRoot?.trim()) return { artifact, applied: false };
   const root = mirrorRoot.trim().replace(/\/+$/, "");
@@ -4746,6 +4922,11 @@ function applyMirrorDetail(artifact, platform, mirrorRoot) {
     if (url2 === artifact.downloadUrl) return { artifact, applied: false };
     return { artifact: { ...artifact, downloadUrl: url2 }, applied: true };
   }
+  if (artifact.vendorId === "maven") {
+    const url2 = artifact.downloadUrl.replace(/^https:\/\/repo\.maven\.apache\.org\/maven2/, root);
+    if (url2 === artifact.downloadUrl) return { artifact, applied: false };
+    return { artifact: { ...artifact, downloadUrl: url2 }, applied: true };
+  }
   if (artifact.vendorId !== "temurin") return { artifact, applied: false };
   const m = /^https:\/\/github\.com\/adoptium\/temurin(\d+)-binaries\/releases\/download\/[^/]+\/(.+)$/.exec(
     artifact.downloadUrl
@@ -4754,6 +4935,13 @@ function applyMirrorDetail(artifact, platform, mirrorRoot) {
   const url = `${root}/${m[1]}/jdk/${platform.arch}/${platform.os}/${m[2]}`;
   return { artifact: { ...artifact, downloadUrl: url }, applied: true };
 }
+function checksumSidecarFallback(officialDownload, officialChecksum, mirroredDownload) {
+  if (!officialChecksum || mirroredDownload === officialDownload) return void 0;
+  if (!officialChecksum.startsWith(officialDownload)) return void 0;
+  const suffix = officialChecksum.slice(officialDownload.length);
+  if (!/^\.[A-Za-z0-9.]+$/.test(suffix)) return void 0;
+  return mirroredDownload + suffix;
+}
 
 // src/net/download.ts
 import crypto from "crypto";
@@ -4761,10 +4949,25 @@ import { once } from "events";
 import fs7 from "fs";
 import path6 from "path";
 var IDLE_TIMEOUT_MS = 6e4;
+function watchWriteStream(out) {
+  let streamError = null;
+  out.on("error", (err) => {
+    streamError ??= err;
+  });
+  return { error: () => streamError };
+}
+async function closeWriteStream(out) {
+  if (out.closed) return;
+  await new Promise((resolve) => {
+    out.once("close", () => resolve());
+    if (!out.destroyed) out.destroy();
+  });
+}
 async function downloadFile(url, destFile, onProgress) {
   const partFile = `${destFile}.part`;
   const hash = crypto.createHash("sha256");
   const out = fs7.createWriteStream(partFile);
+  const stream = watchWriteStream(out);
   let bytes = 0;
   let total = null;
   let encoded2 = false;
@@ -4774,6 +4977,10 @@ async function downloadFile(url, destFile, onProgress) {
     stalled = true;
     ac.abort();
   }, IDLE_TIMEOUT_MS);
+  const throwIfStreamError = () => {
+    const err = stream.error();
+    if (err) throw err;
+  };
   try {
     const res = await httpFetch(url, {
       signal: ac.signal,
@@ -4785,26 +4992,28 @@ async function downloadFile(url, destFile, onProgress) {
     if (!res.body) throw new SdkvmError(`Empty response body: ${url}`);
     for await (const chunk of res.body) {
       timer.refresh();
+      throwIfStreamError();
       if (!out.write(chunk)) await once(out, "drain");
+      throwIfStreamError();
       hash.update(chunk);
       bytes += chunk.byteLength;
       onProgress?.(bytes, total);
     }
+    throwIfStreamError();
     await new Promise((resolve, reject) => {
       out.end((err) => err ? reject(err) : resolve());
     });
   } catch (err) {
-    await new Promise((resolve) => {
-      out.once("close", resolve);
-      out.destroy();
-    });
+    await closeWriteStream(out);
     fs7.rmSync(partFile, { force: true });
     if (stalled) {
       throw new SdkvmError(`Download stalled: no data for ${IDLE_TIMEOUT_MS / 1e3}s (${bytes} bytes so far)`, {
         hint: url
       });
     }
-    throw err;
+    if (err instanceof SdkvmError) throw err;
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new SdkvmError(`Download failed after ${bytes} bytes: ${detail}`, { hint: url });
   } finally {
     clearTimeout(timer);
   }
@@ -4825,19 +5034,72 @@ function cacheFileName(url) {
 }
 
 // src/net/checksum.ts
+import crypto2 from "crypto";
+import fs8 from "fs";
 var HEX64 = /^[0-9a-f]{64}$/i;
-function extractExpectedChecksum(text) {
+var HEX128 = /^[0-9a-f]{128}$/i;
+function hexOf(value, kind) {
+  const re = kind === "sha512" ? HEX128 : HEX64;
+  return typeof value === "string" && re.test(value) ? value.toLowerCase() : null;
+}
+function hex64(value) {
+  return hexOf(value, "sha256");
+}
+function extractExpectedChecksum(text, kind = "sha256") {
   const trimmed = text.trim();
-  if (trimmed.startsWith("{")) {
+  if (kind === "sha256" && trimmed.startsWith("{")) {
     try {
       const obj = JSON.parse(trimmed);
-      if (obj.checksum && HEX64.test(obj.checksum)) return obj.checksum.toLowerCase();
+      const direct = hex64(obj.checksum) ?? hex64(obj.sha256);
+      if (direct) return direct;
+      if (Array.isArray(obj.hashes)) {
+        for (const item of obj.hashes) {
+          if (!item || typeof item !== "object") continue;
+          const hash = item;
+          const alg = typeof hash.alg === "string" ? hash.alg.toLowerCase().replace(/-/g, "") : "";
+          if (alg === "sha256") {
+            const content = hex64(hash.content);
+            if (content) return content;
+          }
+        }
+      }
     } catch {
     }
     return null;
   }
   const token = trimmed.split(/\s+/)[0] ?? "";
-  return HEX64.test(token) ? token.toLowerCase() : null;
+  return hexOf(token, kind);
+}
+function hashFile(file, algorithm) {
+  return new Promise((resolve, reject) => {
+    const hash = crypto2.createHash(algorithm);
+    fs8.createReadStream(file).on("error", reject).on("data", (chunk) => {
+      hash.update(chunk);
+    }).on("end", () => resolve(hash.digest("hex")));
+  });
+}
+async function readFallbackChecksum(artifact, url, kind, strict) {
+  let expected;
+  try {
+    expected = extractExpectedChecksum(await httpText(url), kind);
+  } catch (err) {
+    if (strict) {
+      const detail = err instanceof Error ? err.message.split("\n")[0] : String(err);
+      throw new SdkvmError(`Cannot fetch checksum for ${artifact.displayName}`, {
+        hint: `${detail}. Official and mirror checksum URLs were both unreachable.`
+      });
+    }
+    log.warn(`cannot fetch mirror checksum for ${artifact.displayName}, skipping verification`);
+    return null;
+  }
+  if (expected) return expected;
+  if (strict) {
+    throw new SdkvmError(`Checksum source has no valid hash for ${artifact.displayName}`, {
+      hint: `Mirror sidecar ${url} did not contain a ${kind} hash.`
+    });
+  }
+  log.warn(`mirror sidecar has no valid hash for ${artifact.displayName}, skipping verification`);
+  return null;
 }
 async function verifyChecksum(artifact, actual, opts = {}) {
   const strict = opts.strict === true;
@@ -4853,17 +5115,28 @@ async function verifyChecksum(artifact, actual, opts = {}) {
   }
   let expected = info.expected?.toLowerCase() ?? null;
   if (!expected && info.url) {
+    const fallback = opts.fallbackUrl && opts.fallbackUrl !== info.url ? opts.fallbackUrl : void 0;
     try {
-      expected = extractExpectedChecksum(await httpText(info.url));
+      expected = extractExpectedChecksum(await httpText(info.url), info.kind);
     } catch (err) {
-      if (strict) {
-        const detail = err instanceof Error ? err.message.split("\n")[0] : String(err);
-        throw new SdkvmError(`Cannot fetch checksum for ${artifact.displayName}`, {
-          hint: `${detail}. Mirrored installs need the official checksum URL to be reachable.`
-        });
+      if (!fallback) {
+        if (strict) {
+          const detail = err instanceof Error ? err.message.split("\n")[0] : String(err);
+          throw new SdkvmError(`Cannot fetch checksum for ${artifact.displayName}`, {
+            hint: `${detail}. Mirrored installs need a reachable checksum URL.`
+          });
+        }
+        log.warn(`cannot fetch checksum for ${artifact.displayName}, skipping verification`);
+        return;
       }
-      log.warn(`cannot fetch checksum for ${artifact.displayName}, skipping verification`);
-      return;
+      log.warn(`cannot fetch official checksum for ${artifact.displayName}, trying the mirror sidecar`);
+      expected = await readFallbackChecksum(artifact, fallback, info.kind, strict);
+      if (!expected) return;
+    }
+    if (!expected && fallback) {
+      log.warn(`official checksum has no valid hash for ${artifact.displayName}, trying the mirror sidecar`);
+      expected = await readFallbackChecksum(artifact, fallback, info.kind, strict);
+      if (!expected) return;
     }
   }
   if (!expected) {
@@ -4883,7 +5156,7 @@ async function verifyChecksum(artifact, actual, opts = {}) {
 }
 
 // src/fs/extract.ts
-import fs8 from "fs";
+import fs9 from "fs";
 import path7 from "path";
 
 // src/util/spawn.ts
@@ -4909,9 +5182,9 @@ async function run(cmd, args, opts = {}) {
 // src/fs/extract.ts
 var WIN_TAR = "C:\\Windows\\System32\\tar.exe";
 async function extractArchive(archiveFile, archiveType, destDir, platform) {
-  fs8.mkdirSync(destDir, { recursive: true });
+  fs9.mkdirSync(destDir, { recursive: true });
   if (platform.os === "windows") {
-    if (fs8.existsSync(WIN_TAR)) {
+    if (fs9.existsSync(WIN_TAR)) {
       await run(WIN_TAR, ["-xf", archiveFile, "-C", destDir]);
     } else {
       await run("powershell.exe", [
@@ -4934,21 +5207,21 @@ function tmpExtractDir(base) {
 }
 
 // src/fs/layout.ts
-import fs9 from "fs";
+import fs10 from "fs";
 import path8 from "path";
 function normalizeExtracted(tmpDir, platform, type) {
   const spec = getSdkType(type);
-  const entries = fs9.readdirSync(tmpDir).filter((e) => e !== "._" && !e.startsWith("._"));
+  const entries = fs10.readdirSync(tmpDir).filter((e) => e !== "._" && !e.startsWith("._"));
   const real = entries.filter((e) => e !== ".DS_Store");
   let root;
-  if (real.length === 1 && fs9.statSync(path8.join(tmpDir, real[0])).isDirectory()) {
+  if (real.length === 1 && fs10.statSync(path8.join(tmpDir, real[0])).isDirectory()) {
     root = path8.join(tmpDir, real[0]);
   } else {
     root = tmpDir;
   }
   const home = spec.locateHome(root);
   const bin = path8.join(home, spec.binRelPath(platform));
-  if (!fs9.existsSync(bin)) {
+  if (!fs10.existsSync(bin)) {
     throw new SdkvmError(`Archive does not look like a valid ${spec.label} (bin not found)`, {
       hint: `expected ${bin}`
     });
@@ -5000,7 +5273,7 @@ function createProgress(label2) {
 async function renameWithRetry(from, to, attempts = 3) {
   for (let i = 1; ; i++) {
     try {
-      fs10.renameSync(from, to);
+      fs11.renameSync(from, to);
       return;
     } catch (err) {
       if (i >= attempts) throw err;
@@ -5034,7 +5307,7 @@ async function installCommand(type, specInput, opts) {
   const hintVersion = type === "java" || type === "node" ? String(artifact.version.major) : `${artifact.version.major}.${artifact.version.minor}`;
   await withLock(async () => {
     ensureLayout();
-    if (fs10.existsSync(finalDir)) {
+    if (fs11.existsSync(finalDir)) {
       if (!opts.force) {
         log.warn(`${artifact.displayName} is already installed`);
         log.info(`run: ${cmdPath(type)} use ${hintVersion}`);
@@ -5042,15 +5315,17 @@ async function installCommand(type, specInput, opts) {
       }
       log.warn(`--force: removing existing ${artifact.dirName}`);
     }
-    for (const f of fs10.readdirSync(paths.cache())) {
-      if (f.endsWith(".part")) fs10.rmSync(path9.join(paths.cache(), f), { force: true });
+    for (const f of fs11.readdirSync(paths.cache())) {
+      if (f.endsWith(".part")) fs11.rmSync(path9.join(paths.cache(), f), { force: true });
     }
     const dest = path9.join(paths.cache(), cacheFileName(artifact.downloadUrl));
     const progress = createProgress(`\u2193 ${artifact.displayName}`);
     log.info(`downloading ${artifact.downloadUrl}`);
     const dl = await downloadFile(artifact.downloadUrl, dest, (b, t) => progress.update(b, t));
     progress.done(dl.bytes, null);
-    await verifyChecksum(artifact, dl.sha256, { strict: applied });
+    const actual = artifact.checksum?.kind === "sha512" ? await hashFile(dest, "sha512") : dl.sha256;
+    const fallbackUrl = applied ? checksumSidecarFallback(resolved.downloadUrl, resolved.checksum?.url, artifact.downloadUrl) : void 0;
+    await verifyChecksum(artifact, actual, { strict: applied, fallbackUrl });
     const tmp = tmpExtractDir(paths.tmp());
     const bak = `${finalDir}.bak`;
     let finalTmp = tmp;
@@ -5059,28 +5334,28 @@ async function installCommand(type, specInput, opts) {
       await extractArchive(dest, artifact.archive, tmp, platform);
       const normalized = normalizeExtracted(tmp, platform, type);
       finalTmp = normalized.root;
-      fs10.rmSync(bak, { recursive: true, force: true });
-      if (fs10.existsSync(finalDir)) fs10.renameSync(finalDir, bak);
+      fs11.rmSync(bak, { recursive: true, force: true });
+      if (fs11.existsSync(finalDir)) fs11.renameSync(finalDir, bak);
       try {
         await renameWithRetry(normalized.root, finalDir);
       } catch (err) {
-        if (fs10.existsSync(bak) && !fs10.existsSync(finalDir)) {
+        if (fs11.existsSync(bak) && !fs11.existsSync(finalDir)) {
           try {
-            fs10.renameSync(bak, finalDir);
+            fs11.renameSync(bak, finalDir);
           } catch {
           }
         }
         throw err;
       }
-      fs10.rmSync(bak, { recursive: true, force: true });
+      fs11.rmSync(bak, { recursive: true, force: true });
     } catch (err) {
-      fs10.rmSync(finalTmp, { recursive: true, force: true });
-      fs10.rmSync(tmp, { recursive: true, force: true });
+      fs11.rmSync(finalTmp, { recursive: true, force: true });
+      fs11.rmSync(tmp, { recursive: true, force: true });
       throw err;
     } finally {
-      fs10.rmSync(dest, { force: true });
-      fs10.rmSync(paths.tmp(), { recursive: true, force: true });
-      fs10.mkdirSync(paths.tmp(), { recursive: true });
+      fs11.rmSync(dest, { force: true });
+      fs11.rmSync(paths.tmp(), { recursive: true, force: true });
+      fs11.mkdirSync(paths.tmp(), { recursive: true });
     }
     log.ok(`installed ${artifact.displayName} \u2192 ${finalDir}`);
     log.info(`switch to it: ${cmdPath(type)} use ${hintVersion}`);
@@ -5093,34 +5368,34 @@ import { promisify as promisify2 } from "util";
 import path15 from "path";
 
 // src/core/registry.ts
-import fs12 from "fs";
+import fs13 from "fs";
 import path11 from "path";
 
 // src/fs/link.ts
-import fs11 from "fs";
+import fs12 from "fs";
 import path10 from "path";
 function setCurrent(type, target, platform) {
   const link = paths.current(type);
   if (platform.os === "windows") {
     try {
-      fs11.rmSync(link, { force: true });
+      fs12.rmSync(link, { force: true });
     } catch {
-      fs11.rmSync(link, { recursive: true, force: true });
+      fs12.rmSync(link, { recursive: true, force: true });
     }
-    fs11.symlinkSync(target, link, "junction");
+    fs12.symlinkSync(target, link, "junction");
     return;
   }
   const tmp = `${link}.tmp-${process.pid}`;
-  fs11.rmSync(tmp, { force: true });
-  fs11.symlinkSync(target, tmp);
-  fs11.renameSync(tmp, link);
+  fs12.rmSync(tmp, { force: true });
+  fs12.symlinkSync(target, tmp);
+  fs12.renameSync(tmp, link);
 }
 function readCurrent(type) {
   const link = paths.current(type);
   try {
-    const st = fs11.lstatSync(link);
+    const st = fs12.lstatSync(link);
     if (!st.isSymbolicLink()) return null;
-    const raw = fs11.readlinkSync(link);
+    const raw = fs12.readlinkSync(link);
     return path10.resolve(path10.dirname(link), raw);
   } catch {
     return null;
@@ -5129,9 +5404,9 @@ function readCurrent(type) {
 function clearCurrent(type) {
   const link = paths.current(type);
   try {
-    fs11.rmSync(link, { force: true });
+    fs12.rmSync(link, { force: true });
   } catch {
-    fs11.rmSync(link, { recursive: true, force: true });
+    fs12.rmSync(link, { recursive: true, force: true });
   }
 }
 
@@ -5139,13 +5414,13 @@ function clearCurrent(type) {
 function listInstalled(type) {
   const spec = getSdkType(type);
   const root = paths.sdks(type);
-  if (!fs12.existsSync(root)) return [];
+  if (!fs13.existsSync(root)) return [];
   const result = [];
-  for (const name of fs12.readdirSync(root)) {
+  for (const name of fs13.readdirSync(root)) {
     const version = spec.parseDirName(name);
     if (!version) continue;
     const dirPath = path11.join(root, name);
-    if (!fs12.statSync(dirPath).isDirectory()) continue;
+    if (!fs13.statSync(dirPath).isDirectory()) continue;
     result.push({ type, version, dirPath, home: spec.locateHome(dirPath) });
   }
   result.sort((a, b) => spec.compareVersions(a.version, b.version));
@@ -5217,7 +5492,7 @@ function detectRcFile(platform) {
 }
 
 // src/shell/rc.ts
-import fs13 from "fs";
+import fs14 from "fs";
 import os3 from "os";
 import path13 from "path";
 function rcBegin(type) {
@@ -5255,8 +5530,8 @@ ${rcBlock(type)}
 `;
 }
 function upsertRcFile(file, type) {
-  const content = fs13.existsSync(file) ? fs13.readFileSync(file, "utf8") : "";
-  fs13.writeFileSync(file, upsertRcContent(content, type));
+  const content = fs14.existsSync(file) ? fs14.readFileSync(file, "utf8") : "";
+  fs14.writeFileSync(file, upsertRcContent(content, type));
 }
 function escapeRegex(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -5359,6 +5634,9 @@ async function useCommand(type, specInput, opts) {
       console.log(rcBlock(type));
     }
   }
+  if (spec.requiresJdk && !envGet("JAVA_HOME")) {
+    log.warn(`${spec.label} needs a JDK. Run: ${CLI_BIN} java use <version>`);
+  }
   await showSdkVersion(path15.join(installed.home, spec.binRelPath(platform)), type);
 }
 
@@ -5439,7 +5717,7 @@ function currentCommand(types = SDK_TYPES) {
 }
 
 // src/cli/uninstall.ts
-import fs14 from "fs";
+import fs15 from "fs";
 async function uninstallCommand(type, specInput, opts) {
   const spec = getSdkType(type);
   const installed = findInstalled(type, specInput, opts.vendor);
@@ -5449,7 +5727,7 @@ async function uninstallCommand(type, specInput, opts) {
       log.warn(`uninstalled the current ${spec.label}; ${spec.envVar} is now dangling`);
       log.info(`select another: ${cmdPath(type)} use <version>`);
     }
-    fs14.rmSync(installed.dirPath, { recursive: true, force: true });
+    fs15.rmSync(installed.dirPath, { recursive: true, force: true });
   });
   log.ok(`removed ${installed.version.vendor}-${spec.formatVersion(installed.version)}`);
 }
@@ -5459,7 +5737,8 @@ var MIRRORABLE_BY_TYPE = {
   java: ["temurin"],
   go: ["golang"],
   flutter: ["flutter"],
-  node: ["nodejs"]
+  node: ["nodejs"],
+  maven: ["maven"]
 };
 var MIRROR_SITE_PRESETS = [
   {
@@ -5487,14 +5766,16 @@ var MIRROR_SITE_PRESETS = [
     list: true,
     vendors: {
       golang: "https://mirrors.aliyun.com/golang",
-      nodejs: "https://mirrors.aliyun.com/nodejs-release"
+      nodejs: "https://mirrors.aliyun.com/nodejs-release",
+      maven: "https://maven.aliyun.com/repository/central"
     }
   },
   {
     name: "huawei",
     list: true,
     vendors: {
-      nodejs: "https://repo.huaweicloud.com/nodejs"
+      nodejs: "https://repo.huaweicloud.com/nodejs",
+      maven: "https://repo.huaweicloud.com/repository/maven"
     }
   },
   {
@@ -5743,7 +6024,7 @@ function mirrorCommand(type, action, arg1, arg2) {
 
 // src/cli/upgrade.ts
 import { spawn } from "child_process";
-import fs15 from "fs";
+import fs16 from "fs";
 import path16 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var RELEASE_REPO = "QInJ1995/sdkvm";
@@ -5779,12 +6060,12 @@ function checksumFor(sumsText, fileName) {
 }
 async function prepareCliPackage(archiveFile, home = sdkvmHome()) {
   const staging = path16.join(home, "cli.next");
-  fs15.rmSync(staging, { recursive: true, force: true });
-  fs15.mkdirSync(home, { recursive: true });
+  fs16.rmSync(staging, { recursive: true, force: true });
+  fs16.mkdirSync(home, { recursive: true });
   await extractArchive(archiveFile, "tar.gz", staging, detectPlatform());
   const unpacked = path16.join(staging, "package");
-  if (!fs15.existsSync(path16.join(unpacked, "package.json"))) {
-    fs15.rmSync(staging, { recursive: true, force: true });
+  if (!fs16.existsSync(path16.join(unpacked, "package.json"))) {
+    fs16.rmSync(staging, { recursive: true, force: true });
     throw new SdkvmError("Release archive is missing package/package.json", { hint: archiveFile });
   }
   return unpacked;
@@ -5794,22 +6075,22 @@ async function replaceCliPackage(archiveFile, home = sdkvmHome()) {
   const bak = path16.join(home, "cli.bak");
   const cli = path16.join(home, "cli");
   const unpacked = await prepareCliPackage(archiveFile, home);
-  fs15.rmSync(bak, { recursive: true, force: true });
-  if (fs15.existsSync(cli)) fs15.renameSync(cli, bak);
+  fs16.rmSync(bak, { recursive: true, force: true });
+  if (fs16.existsSync(cli)) fs16.renameSync(cli, bak);
   try {
-    fs15.renameSync(unpacked, cli);
+    fs16.renameSync(unpacked, cli);
   } catch (err) {
-    if (fs15.existsSync(bak) && !fs15.existsSync(cli)) {
+    if (fs16.existsSync(bak) && !fs16.existsSync(cli)) {
       try {
-        fs15.renameSync(bak, cli);
+        fs16.renameSync(bak, cli);
       } catch {
       }
     }
-    fs15.rmSync(staging, { recursive: true, force: true });
+    fs16.rmSync(staging, { recursive: true, force: true });
     throw err;
   }
-  fs15.rmSync(bak, { recursive: true, force: true });
-  fs15.rmSync(staging, { recursive: true, force: true });
+  fs16.rmSync(bak, { recursive: true, force: true });
+  fs16.rmSync(staging, { recursive: true, force: true });
 }
 function windowsUpgradeScript(home) {
   return [
@@ -5832,7 +6113,7 @@ function windowsUpgradeScript(home) {
 }
 function scheduleWindowsCliReplace(home) {
   const script = path16.join(home, "upgrade-apply.cmd");
-  fs15.writeFileSync(script, windowsUpgradeScript(home), "utf8");
+  fs16.writeFileSync(script, windowsUpgradeScript(home), "utf8");
   const child = spawn("cmd.exe", ["/c", script], {
     detached: true,
     stdio: "ignore",
@@ -5854,7 +6135,7 @@ async function upgradeCommand() {
     if (!expected) {
       throw new SdkvmError(`No checksum for ${RELEASE_ASSET}`, { hint: sumsUrl });
     }
-    fs15.mkdirSync(paths.cache(), { recursive: true });
+    fs16.mkdirSync(paths.cache(), { recursive: true });
     const dest = path16.join(paths.cache(), RELEASE_ASSET);
     try {
       const downloaded = await downloadFile(assetUrl, dest);
@@ -5879,8 +6160,8 @@ async function upgradeCommand() {
         `upgraded CLI ${before} \u2192 ${after} in ${path16.join(home, "cli")}; runtime and installed SDKs were left in place`
       );
     } finally {
-      fs15.rmSync(dest, { force: true });
-      fs15.rmSync(`${dest}.part`, { force: true });
+      fs16.rmSync(dest, { force: true });
+      fs16.rmSync(`${dest}.part`, { force: true });
     }
   });
 }
@@ -6080,17 +6361,29 @@ async function nrmTest(name, opts = {}) {
 
 // src/index.ts
 var program2 = new Command();
-program2.name("sdkvm").description("SDK version manager \u2014 install & switch JDKs (Temurin / Zulu / Corretto), Go toolchains, Flutter SDKs, and Node.js runtimes").version(getVersion());
+program2.name("sdkvm").description("SDK version manager \u2014 install & switch JDKs (Temurin / Zulu / Corretto), Go toolchains, Flutter SDKs, Node.js runtimes, and Apache Maven").version(getVersion());
+var INSTALL_HELP = {
+  java: "21 | lts | 21.0.5 | 21.0.5+11 | temurin-21",
+  go: "1.24 | 1.24.5 | latest | golang-1.24",
+  flutter: "3.47 | 3.47.5 | 3.49.0-0.1.pre | latest | flutter-3.47",
+  node: "22 | 22.20.0 | lts | latest | nodejs-22.20.0",
+  maven: "3 | 3.9 | 3.9.9 | 4.0.0-rc-4 | latest | maven-3.9"
+};
+var VERSION_EXAMPLE = {
+  java: "21 / temurin-21.0.5+11",
+  go: "1.24 / golang-1.24.5",
+  flutter: "3.47 / flutter-3.47.5",
+  node: "22 / nodejs-22.20.0",
+  maven: "3.9 / maven-3.9.9"
+};
 function registerSdkCommands(cmd, type) {
   const s = getSdkType(type);
-  const isJava = type === "java";
-  const installHelp = isJava ? "21 | lts | 21.0.5 | 21.0.5+11 | temurin-21" : type === "go" ? "1.24 | 1.24.5 | latest | golang-1.24" : type === "flutter" ? "3.47 | 3.47.5 | 3.49.0-0.1.pre | latest | flutter-3.47" : "22 | 22.20.0 | lts | latest | nodejs-22.20.0";
   const vendorIds = s.vendors.map((v) => v.id).join(" | ");
-  cmd.command("install").description(`install a ${s.label}: ${installHelp}`).argument("<version>", "version spec (optional vendor- prefix)").option("--vendor <id>", `vendor: ${vendorIds}`).option("--force", "reinstall even if already installed").action((v, o) => installCommand(type, v, o));
-  cmd.command("use").description(`switch the current ${s.label} (updates ${s.envVar} / PATH)`).argument("<version>", `installed version, e.g. ${isJava ? "21 / temurin-21.0.5+11" : type === "go" ? "1.24 / golang-1.24.5" : type === "flutter" ? "3.47 / flutter-3.47.5" : "22 / nodejs-22.20.0"}`).option("--vendor <id>", "restrict matching to a vendor").action((v, o) => useCommand(type, v, o));
+  cmd.command("install").description(`install a ${s.label}: ${INSTALL_HELP[type]}`).argument("<version>", "version spec (optional vendor- prefix)").option("--vendor <id>", `vendor: ${vendorIds}`).option("--force", "reinstall even if already installed").action((v, o) => installCommand(type, v, o));
+  cmd.command("use").description(`switch the current ${s.label} (updates ${s.envVar} / PATH)`).argument("<version>", `installed version, e.g. ${VERSION_EXAMPLE[type]}`).option("--vendor <id>", "restrict matching to a vendor").action((v, o) => useCommand(type, v, o));
   cmd.command("ls").alias("list").description(`list installed ${s.label}s (\u2192 marks current); -r lists installable versions`).option("-r, --remote", "list installable versions from all vendors").option("--vendor <id>", "filter --remote output to one vendor").action((o) => lsCommand(type, o));
   cmd.command("current").description(`show the current ${s.label}`).action(() => currentCommand([type]));
-  cmd.command("uninstall").description(`remove an installed ${s.label}`).argument("<version>", `installed version, e.g. ${isJava ? "21 / temurin-21.0.5+11" : type === "go" ? "1.24 / golang-1.24.5" : type === "flutter" ? "3.47 / flutter-3.47.5" : "22 / nodejs-22.20.0"}`).option("--vendor <id>", "restrict matching to a vendor").action((v, o) => uninstallCommand(type, v, o));
+  cmd.command("uninstall").description(`remove an installed ${s.label}`).argument("<version>", `installed version, e.g. ${VERSION_EXAMPLE[type]}`).option("--vendor <id>", "restrict matching to a vendor").action((v, o) => uninstallCommand(type, v, o));
   cmd.command("mirror").description("show, set, or switch download mirror sites for this SDK").argument("[action]", "ls | use | current | show | set | unset").argument("[nameOrVendor]", "site name, vendor id, or URL").argument("[url]", "mirror root URL (for set)").action(
     (a, v, u) => mirrorCommand(type, a, v, u)
   );
@@ -6108,6 +6401,9 @@ flutterCmd.action(() => flutterCmd.help());
 var nodeCmd = program2.command("node").description("Node.js subcommands");
 registerSdkCommands(nodeCmd, "node");
 nodeCmd.action(() => nodeCmd.help());
+var mavenCmd = program2.command("maven").description("Apache Maven subcommands");
+registerSdkCommands(mavenCmd, "maven");
+mavenCmd.action(() => mavenCmd.help());
 program2.commands.find((c) => c.name() === "current")?.action(() => currentCommand());
 program2.command("version").description("print sdkvm CLI version").action(versionCommand);
 program2.command("upgrade").description("upgrade the sdkvm CLI (script install replaces ~/.sdkvm/cli; npm install prints npm update -g)").action(upgradeCommand);