@bkm016/calcite 0.0.0-stage → 0.2.0

package/dist/hmc.js

@@ -0,0 +1,168 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { mkdirSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { pathToFileURL } from 'node:url';
+import { download, javaProxyProps } from './net.js';
+/** Pinned HeadlessMC release (MIT, https://github.com/headlesshq/headlessmc). */
+export const HMC_VERSION = '3.0.0-RC3';
+export const HMC_URL = `https://github.com/headlesshq/headlessmc/releases/download/${HMC_VERSION}/headlessmc.jar`;
+export const HMC_SHA256 = 'dcc061a336ecf7aa638794bd47840fa9970b31d562e630e84c3d587c906153a8';
+/** Path of the HeadlessMC jar (CALCITE_HMC_JAR overrides the pinned download). */
+export async function ensureHmc(paths) {
+    if (process.env.CALCITE_HMC_JAR)
+        return process.env.CALCITE_HMC_JAR;
+    const file = join(paths.hmcJars, `headlessmc-${HMC_VERSION}.jar`);
+    await download(process.env.CALCITE_HMC_URL || HMC_URL, file, { sha256: HMC_SHA256 });
+    return file;
+}
+/** Escapes one entry of a comma separated HeadlessMC list setting. */
+export function hmcListEntry(value) {
+    return value.replace(/\\/g, '\\\\').replace(/,/g, '\\,');
+}
+/** Quotes one argument for HeadlessMC's `--jvm`/`--game` options, which are split like a shell command line. */
+export function hmcQuote(arg) {
+    return `"${arg.replace(/[\\"]/g, (c) => `\\${c}`)}"`;
+}
+/**
+ * Writes the HeadlessMC profile used when launching `versionId` from `location`. HeadlessMC only runs a version
+ * with the exact Java major the version asks for; the profile pins the runtime Calcite chose instead. With a
+ * {@code loader} the profile selects that platform (fabric, forge, neoforge) and build for Minecraft {@code versionId}.
+ */
+export async function writeHmcProfile(location, versionId, gameDir, javaMajor, loader) {
+    const [platform, , build] = loader ? hmcVersionArgs(versionId, loader) : ['vanilla'];
+    const version = { side: null, platform, version: versionId, build: build ?? null };
+    const profile = {
+        name: 'calcite',
+        version,
+        currentVersion: version,
+        path: pathToFileURL(gameDir).href,
+        options: { resolution: null, quickPlayPath: null, join: null, demo: false },
+        patchers: [],
+        systemProperties: {},
+        vmArgs: [],
+        gameArgs: [],
+        javaVersion: javaMajor,
+        eulaStatus: 'UNKNOWN',
+        hasDefaultClientJvmArgs: true,
+        hmcVersion: 0,
+    };
+    await mkdir(join(location, 'profiles'), { recursive: true });
+    await writeFile(join(location, 'profiles', 'calcite.json'), JSON.stringify(profile, null, 2));
+}
+/**
+ * HeadlessMC's version argument: "1.21.11", or "fabric 1.21.11 0.19.5" for a mod loader. HeadlessMC names NeoForge
+ * builds without the Minecraft part of their version (NeoForge 21.11.45 for 1.21.11 is build "45").
+ */
+export function hmcVersionArgs(versionId, loader) {
+    if (!loader)
+        return [versionId];
+    let build = loader.build;
+    if (build && loader.kind === 'neoforge') {
+        const prefix = `${versionId.startsWith('1.') ? versionId.slice(2) : versionId}.`;
+        if (build.startsWith(prefix))
+            build = build.slice(prefix.length);
+    }
+    return [loader.kind, versionId, ...(build ? [build] : [])];
+}
+const live = new Set();
+let exitGuard = false;
+/** Kills every still-running HeadlessMC tree when the host process exits, so nothing is orphaned. */
+function guardExit() {
+    if (exitGuard)
+        return;
+    exitGuard = true;
+    const killAll = () => {
+        for (const child of live) {
+            if (child.pid === undefined || child.exitCode !== null)
+                continue;
+            try {
+                if (process.platform === 'win32')
+                    spawnSync('taskkill', ['/pid', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
+                else
+                    process.kill(-child.pid, 'SIGKILL');
+            }
+            catch {
+                // already gone
+            }
+        }
+        live.clear();
+    };
+    process.once('exit', killAll);
+    // A signal without a handler terminates Node without an 'exit' event; when nobody else handles it, clean up and
+    // die with the conventional status. Hosts that handle the signal themselves end up in 'exit' above.
+    for (const [signal, code] of [['SIGTERM', 143], ['SIGHUP', 129], ['SIGINT', 130]]) {
+        process.on(signal, () => {
+            if (process.listenerCount(signal) > 1)
+                return;
+            killAll();
+            process.exit(code);
+        });
+    }
+}
+/**
+ * Runs one HeadlessMC command non-interactively; HeadlessMC exits once the command (and a launched game) finished.
+ * Settings are passed as -D system properties, which take precedence over any config file.
+ */
+export function runHmc(opts) {
+    const props = {
+        'hmc.files.location': opts.location,
+        'hmc.jline.enabled': 'false',
+        'hmc.log.console-level': 'INFO',
+        ...javaProxyProps(),
+        ...opts.props,
+    };
+    const args = [...Object.entries(props).map(([k, v]) => `-D${k}=${v}`), '-jar', opts.hmcJar, ...opts.command];
+    mkdirSync(opts.location, { recursive: true });
+    const child = spawn(opts.javaPath, args, {
+        cwd: opts.location,
+        env: opts.env ?? process.env,
+        stdio: ['pipe', 'pipe', 'pipe'],
+        // own process group on POSIX so the whole tree (launcher + game) can be stopped together
+        detached: process.platform !== 'win32',
+        windowsHide: true,
+    });
+    guardExit();
+    live.add(child);
+    child.once('exit', () => live.delete(child));
+    for (const stream of [child.stdout, child.stderr]) {
+        if (!stream)
+            continue;
+        const rl = createInterface({ input: stream });
+        rl.on('line', (line) => opts.onLine?.(line));
+    }
+    const exited = new Promise((resolve) => {
+        child.once('exit', (code) => resolve(code));
+        child.once('error', () => resolve(null));
+    });
+    return { child, exited };
+}
+/** Stops a process tree started by {@link runHmc}. */
+export async function killTree(child, graceMs = 5000) {
+    if (child.exitCode !== null || child.signalCode !== null || child.pid === undefined)
+        return;
+    const exited = new Promise((resolve) => child.once('exit', () => resolve()));
+    if (process.platform === 'win32') {
+        spawn('taskkill', ['/pid', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
+    }
+    else {
+        try {
+            process.kill(-child.pid, 'SIGTERM');
+        }
+        catch {
+            child.kill('SIGTERM');
+        }
+        const timer = setTimeout(() => {
+            try {
+                process.kill(-child.pid, 'SIGKILL');
+            }
+            catch {
+                child.kill('SIGKILL');
+            }
+        }, graceMs);
+        exited.finally(() => clearTimeout(timer));
+    }
+    await Promise.race([exited, new Promise((r) => setTimeout(r, graceMs * 2))]);
+}
+//# sourceMappingURL=hmc.js.map

package/dist/hmc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmc.js","sourceRoot":"","sources":["../src/hmc.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { Client, CalciteError, installVersion, parseServer } from './client.js';
+export type { Account, BlockFace, BlockInfo, BlockPosition, ChatLine, ClickMode, ClientOptions, ClientStatus, ContainerInfo, DigResult, EntityInfo, EntityQuery, GameState, HitTarget, InstallOptions, InventoryInfo, ItemInfo, LogLine, MoveControls, Phase, PlayerState, RenderMode, ServerAddress, WalkResult, } from './client.js';
+export { listAccounts, removeAccount, startLogin } from './accounts.js';
+export type { AccountInfo, LoginHandle } from './accounts.js';
+export { resolvePaths } from './paths.js';
+export type { CalcitePaths } from './paths.js';
+export { findJavaInstalls, ensureJava } from './java.js';
+export type { JavaInstall } from './java.js';
+export { resolveVersion } from './mojang.js';
+export { setLogLevel } from './log.js';
+export { ClientManager } from './manager.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+export { Client, CalciteError, installVersion, parseServer } from './client.js';
+export { listAccounts, removeAccount, startLogin } from './accounts.js';
+export { resolvePaths } from './paths.js';
+export { findJavaInstalls, ensureJava } from './java.js';
+export { resolveVersion } from './mojang.js';
+export { setLogLevel } from './log.js';
+export { ClientManager } from './manager.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA2BhF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,48 @@
+import { type JavaInstall } from './java.js';
+import { type InstalledLoader } from './loaders.js';
+import { type VersionJson } from './mojang.js';
+import { type NameMode } from './names.js';
+import { type CalcitePaths } from './paths.js';
+/** Copies the probe jar to the space-free probe directory (content-addressed). */
+export declare function installProbe(paths: CalcitePaths): Promise<string>;
+export interface PrepareOptions {
+    /** Minecraft version id, "release" or "snapshot". */
+    version: string;
+    /** Mod loader: "fabric", "forge", "neoforge", optionally "@<loader version>". */
+    loader?: string;
+    javaPath?: string;
+    allowJavaDownload?: boolean;
+    /** Whether the game will run without a renderer (picks Java 17 for the Java 8 versions). */
+    headless?: boolean;
+    /** HeadlessMC output while installing a loader. */
+    onLine?: (line: string) => void;
+}
+export interface PreparedGame {
+    json: VersionJson;
+    clientJar: string;
+    loader?: InstalledLoader;
+    names: NameMode;
+    java: JavaInstall;
+    launcherJava: JavaInstall;
+    hmcJar: string;
+}
+/** Downloads and verifies what launching needs: version files, Java, HeadlessMC, the mod loader and name tables. */
+export declare function prepareGame(paths: CalcitePaths, opts: PrepareOptions): Promise<PreparedGame>;
+export interface InstallOptions {
+    paths?: CalcitePaths;
+    /** Mod loader to install as well: "fabric", "forge", "neoforge", optionally "@<loader version>". */
+    loader?: string;
+    javaPath?: string;
+    allowJavaDownload?: boolean;
+    onLine?: (line: string) => void;
+}
+/**
+ * Downloads everything a version needs (client, libraries, natives, assets, mappings, Java, HeadlessMC, the mod
+ * loader) without starting the game, so later launches start fast and work offline.
+ */
+export declare function installVersion(spec: string, opts?: InstallOptions): Promise<{
+    id: string;
+    loader?: string;
+    java: string;
+    probe: string;
+}>;

package/dist/install.js

@@ -0,0 +1,119 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { copyFile, mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ensureHmc, hmcListEntry, hmcQuote, hmcVersionArgs, runHmc, writeHmcProfile } from './hmc.js';
+import { ensureJava, ensureLauncherJava } from './java.js';
+import { findLoader, formatLoader, parseLoader } from './loaders.js';
+import { withLock } from './lock.js';
+import { ensureClientJar, getVersionJson, requiredJavaMajor, resolveVersion } from './mojang.js';
+import { resolveNames } from './names.js';
+import { resolvePaths } from './paths.js';
+import { CalciteError } from './types.js';
+/** HeadlessMC 3's LWJGL stubs need Java 9+; the Java 8 versions (up to 1.16.5) run headless on Java 17 instead. */
+const HEADLESS_MIN_JAVA = 17;
+function probeJarSource() {
+    return process.env.CALCITE_PROBE_JAR || fileURLToPath(new URL('../vendor/calcite-probe.jar', import.meta.url));
+}
+/** Copies the probe jar to the space-free probe directory (content-addressed). */
+export async function installProbe(paths) {
+    const source = await readFile(probeJarSource());
+    const hash = createHash('sha256').update(source).digest('hex').slice(0, 12);
+    const target = join(paths.probe, `calcite-probe-${hash}.jar`);
+    try {
+        await stat(target);
+    }
+    catch {
+        await mkdir(paths.probe, { recursive: true });
+        const tmp = `${target}.${process.pid}.tmp`;
+        await writeFile(tmp, source);
+        await copyFile(tmp, target);
+        await rm(tmp, { force: true });
+    }
+    return target;
+}
+/** Downloads and verifies what launching needs: version files, Java, HeadlessMC, the mod loader and name tables. */
+export async function prepareGame(paths, opts) {
+    const spec = parseLoader(opts.loader);
+    const json = await getVersionJson(paths, await resolveVersion(paths, opts.version));
+    const clientJar = await ensureClientJar(paths, json);
+    const required = requiredJavaMajor(json);
+    const modded = !!spec && spec.kind !== 'fabric';
+    if (modded && opts.headless && required < 9) {
+        throw new CalciteError('unsupported_loader', `${spec.kind} for Minecraft ${json.id} needs Java ${required}, which cannot run headless; use render "on-demand"`);
+    }
+    const java = await ensureJava(paths, opts.headless && required < 9 ? HEADLESS_MIN_JAVA : required, {
+        javaPath: opts.javaPath,
+        allowDownload: opts.allowJavaDownload,
+        exact: modded,
+    });
+    const launcherJava = await ensureLauncherJava(paths, { allowDownload: opts.allowJavaDownload });
+    const hmcJar = await ensureHmc(paths);
+    const loader = spec ? await ensureLoader(paths, json, spec, { java, launcherJava, hmcJar, onLine: opts.onLine }) : undefined;
+    const names = await resolveNames(paths, json, clientJar, loader);
+    return { json, clientJar, loader, names, java, launcherJava, hmcJar };
+}
+/**
+ * Lets HeadlessMC prepare a version without playing it: it downloads the game files (and installs a mod loader)
+ * when launching; `-version` makes the game JVM exit right away.
+ */
+async function hmcDryLaunch(paths, json, loader, rt) {
+    const location = join(paths.hmcHome, 'install', randomBytes(6).toString('hex'));
+    try {
+        await writeHmcProfile(location, json.id, join(location, 'game'), rt.java.major, loader);
+        const run = runHmc({
+            javaPath: rt.launcherJava.path,
+            hmcJar: rt.hmcJar,
+            location,
+            props: {
+                'hmc.files.mc': paths.minecraft,
+                'hmc.files.game': join(location, 'game'),
+                'hmc.java.versions': hmcListEntry(rt.java.path),
+                'hmc.java.download': 'false',
+            },
+            command: ['launch', ...hmcVersionArgs(json.id, loader), '--offline', '--headless', `--jvm=${hmcQuote('-version')}`],
+            onLine: rt.onLine,
+        });
+        const code = await run.exited;
+        const what = loader ? `${formatLoader(loader)} for ${json.id}` : json.id;
+        if (code !== 0)
+            throw new CalciteError('install_failed', `HeadlessMC exited with code ${code} while installing ${what}`);
+    }
+    finally {
+        await rm(location, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+/** The installed loader matching {@code spec}, installing it through HeadlessMC first when missing. */
+async function ensureLoader(paths, json, spec, rt) {
+    const found = await findLoader(paths, json.id, spec);
+    if (found)
+        return found;
+    return withLock(join(paths.minecraft, 'versions', `.calcite-${spec.kind}-${json.id}.lock`), async () => {
+        const again = await findLoader(paths, json.id, spec);
+        if (again)
+            return again;
+        await hmcDryLaunch(paths, json, spec, rt);
+        const installed = await findLoader(paths, json.id, spec);
+        if (!installed) {
+            throw new CalciteError('install_failed', `HeadlessMC did not install ${formatLoader(spec)} for Minecraft ${json.id} (is there a build for this version?)`);
+        }
+        return installed;
+    });
+}
+/**
+ * Downloads everything a version needs (client, libraries, natives, assets, mappings, Java, HeadlessMC, the mod
+ * loader) without starting the game, so later launches start fast and work offline.
+ */
+export async function installVersion(spec, opts = {}) {
+    const paths = opts.paths ?? resolvePaths();
+    const game = await prepareGame(paths, { version: spec, loader: opts.loader, javaPath: opts.javaPath, allowJavaDownload: opts.allowJavaDownload, onLine: opts.onLine });
+    await installProbe(paths);
+    await hmcDryLaunch(paths, game.json, game.loader, game);
+    return {
+        id: game.json.id,
+        loader: game.loader ? `${game.loader.kind}@${game.loader.build}` : undefined,
+        java: game.java.version,
+        probe: game.names.kind === 'unsupported' ? game.names.reason : 'supported',
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"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"}

package/dist/java.d.ts

@@ -0,0 +1,37 @@
+import type { CalcitePaths } from './paths.js';
+export interface JavaInstall {
+    /** Path of the java executable. */
+    path: string;
+    /** Major version (8, 17, 21, ...). */
+    major: number;
+    /** Full version string. */
+    version: string;
+}
+/** Parses "java.specification.version = 1.8" / "= 21" from -XshowSettings output. */
+export declare function parseJavaSettings(output: string): {
+    major: number;
+    version: string;
+} | null;
+export declare function findJavaInstalls(paths: CalcitePaths): Promise<JavaInstall[]>;
+/**
+ * Picks a runtime for {@code major}: exact major first; Minecraft 1.17+ (Java 16/17/21/25) also runs on newer
+ * runtimes, legacy versions (Java 8) need exactly 8.
+ */
+export declare function pickJava(installs: JavaInstall[], major: number): JavaInstall | undefined;
+/** Downloads an Eclipse Temurin runtime for {@code major} into CALCITE_HOME/java. */
+export declare function downloadJava(paths: CalcitePaths, major: number): Promise<JavaInstall>;
+export interface EnsureJavaOptions {
+    /** Explicit java executable; skips detection. */
+    javaPath?: string;
+    /** Download a runtime when none is installed (default true). */
+    allowDownload?: boolean;
+    /** Only accept exactly {@code major} (Forge and NeoForge refuse newer runtimes). */
+    exact?: boolean;
+}
+export declare function ensureJava(paths: CalcitePaths, major: number, opts?: EnsureJavaOptions): Promise<JavaInstall>;
+/** Java release HeadlessMC 3 itself runs on (the game may use another runtime). */
+export declare const LAUNCHER_JAVA_MAJOR = 25;
+/** A runtime for HeadlessMC itself (Java 25+); prefers an installed one, downloads Java 25 otherwise. */
+export declare function ensureLauncherJava(paths: CalcitePaths, opts?: {
+    allowDownload?: boolean;
+}): Promise<JavaInstall>;

package/dist/java.js

@@ -0,0 +1,222 @@
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdir, readdir, rename, rm, stat } from 'node:fs/promises';
+import { delimiter, join } from 'node:path';
+import { promisify } from 'node:util';
+import { withLock } from './lock.js';
+import { logger } from './log.js';
+import { download, httpJson } from './net.js';
+const execFileAsync = promisify(execFile);
+const log = logger('java');
+const EXE = process.platform === 'win32' ? 'java.exe' : 'java';
+/** Parses "java.specification.version = 1.8" / "= 21" from -XshowSettings output. */
+export function parseJavaSettings(output) {
+    const spec = /java\.specification\.version = (\S+)/.exec(output);
+    const version = /java\.version = (\S+)/.exec(output);
+    if (!spec)
+        return null;
+    const raw = spec[1];
+    const major = raw.startsWith('1.') ? Number(raw.slice(2)) : Number(raw);
+    if (!Number.isFinite(major))
+        return null;
+    return { major, version: version ? version[1] : raw };
+}
+async function probeJava(path) {
+    try {
+        const env = { ...process.env };
+        delete env.JAVA_TOOL_OPTIONS;
+        delete env._JAVA_OPTIONS;
+        const { stdout, stderr } = await execFileAsync(path, ['-XshowSettings:properties', '-version'], { timeout: 20_000, env });
+        const parsed = parseJavaSettings(`${stdout}\n${stderr}`);
+        return parsed ? { path, ...parsed } : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function subdirs(dir) {
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => join(dir, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+/** Java homes to look at: env, PATH, well-known install locations and Calcite-managed runtimes. */
+async function candidateExecutables(paths) {
+    const homes = [];
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value && (key === 'JAVA_HOME' || /^JAVA_HOME_\d+/.test(key) || /^CALCITE_JAVA_\d+$/.test(key)))
+            homes.push(value);
+    }
+    const roots = [];
+    if (process.platform === 'win32') {
+        for (const base of [process.env.ProgramFiles, process.env['ProgramFiles(x86)'], process.env.ProgramW6432]) {
+            if (!base)
+                continue;
+            for (const vendor of ['Java', 'Eclipse Adoptium', 'Eclipse Foundation', 'Microsoft', 'Zulu', 'Amazon Corretto', 'BellSoft', 'Semeru']) {
+                roots.push(join(base, vendor));
+            }
+        }
+        if (process.env.LOCALAPPDATA)
+            roots.push(join(process.env.LOCALAPPDATA, 'Programs', 'Eclipse Adoptium'));
+    }
+    else if (process.platform === 'darwin') {
+        roots.push('/Library/Java/JavaVirtualMachines', join(process.env.HOME || '', 'Library/Java/JavaVirtualMachines'));
+    }
+    else {
+        roots.push('/usr/lib/jvm', '/usr/java', '/opt/java', '/opt/jdk', join(process.env.HOME || '', '.sdkman/candidates/java'));
+    }
+    for (const root of roots)
+        homes.push(...(await subdirs(root)));
+    // runtimes downloaded by Calcite: java/temurin-<major>-<os>-<arch>/<archive root>/
+    for (const managed of await subdirs(paths.java))
+        homes.push(managed, ...(await subdirs(managed)));
+    const exes = new Set();
+    for (const home of homes) {
+        for (const bin of [join(home, 'bin', EXE), join(home, 'Contents', 'Home', 'bin', EXE)]) {
+            if (existsSync(bin))
+                exes.add(bin);
+        }
+    }
+    for (const dir of (process.env.PATH || '').split(delimiter)) {
+        const bin = join(dir, EXE);
+        if (dir && existsSync(bin))
+            exes.add(bin);
+    }
+    return [...exes];
+}
+export async function findJavaInstalls(paths) {
+    const results = await Promise.all((await candidateExecutables(paths)).map(probeJava));
+    const seen = new Set();
+    return results.filter((j) => {
+        if (!j)
+            return false;
+        const key = `${j.major}:${j.version}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * Picks a runtime for {@code major}: exact major first; Minecraft 1.17+ (Java 16/17/21/25) also runs on newer
+ * runtimes, legacy versions (Java 8) need exactly 8.
+ */
+export function pickJava(installs, major) {
+    const exact = installs.filter((j) => j.major === major);
+    if (exact.length)
+        return exact[0];
+    if (major <= 8)
+        return undefined;
+    return installs.filter((j) => j.major > major).sort((a, b) => a.major - b.major)[0];
+}
+function adoptiumOs() {
+    switch (process.platform) {
+        case 'win32':
+            return 'windows';
+        case 'darwin':
+            return 'mac';
+        case 'linux':
+            return 'linux';
+        default:
+            throw new Error(`Automatic Java download is not supported on ${process.platform}`);
+    }
+}
+function adoptiumArch() {
+    switch (process.arch) {
+        case 'x64':
+            return 'x64';
+        case 'arm64':
+            return 'aarch64';
+        case 'ia32':
+            return 'x32';
+        default:
+            throw new Error(`Automatic Java download is not supported on ${process.arch}`);
+    }
+}
+/** Downloads an Eclipse Temurin runtime for {@code major} into CALCITE_HOME/java. */
+export async function downloadJava(paths, major) {
+    const os = adoptiumOs();
+    const arch = adoptiumArch();
+    const target = join(paths.java, `temurin-${major}-${os}-${arch}`);
+    return withLock(`${target}.lock`, async () => {
+        const existing = await findInDir(target);
+        if (existing)
+            return existing;
+        let asset;
+        for (const image of ['jre', 'jdk']) {
+            const url = `https://api.adoptium.net/v3/assets/latest/${major}/hotspot?architecture=${arch}&image_type=${image}&os=${os}&vendor=eclipse`;
+            const assets = await httpJson(url).catch(() => []);
+            asset = assets[0];
+            if (asset)
+                break;
+        }
+        if (!asset)
+            throw new Error(`No Temurin ${major} build for ${os}/${arch}`);
+        const pkg = asset.binary.package;
+        log.info(`downloading Temurin ${asset.version.semver} (${pkg.name})`);
+        const archive = join(paths.java, pkg.name);
+        await download(pkg.link, archive, { sha256: pkg.checksum });
+        const staging = `${target}.extract`;
+        await rm(staging, { recursive: true, force: true });
+        await mkdir(staging, { recursive: true });
+        // tar handles .tar.gz everywhere and .zip on Windows 10+ (bsdtar)
+        await execFileAsync('tar', ['-xf', archive, '-C', staging], { timeout: 10 * 60_000 });
+        await rm(target, { recursive: true, force: true });
+        await rename(staging, target);
+        await rm(archive, { force: true });
+        const installed = await findInDir(target);
+        if (!installed)
+            throw new Error(`Extracted Java ${major} but found no java executable in ${target}`);
+        return installed;
+    });
+}
+async function findInDir(dir) {
+    try {
+        await stat(dir);
+    }
+    catch {
+        return null;
+    }
+    for (const home of [dir, ...(await subdirs(dir))]) {
+        for (const bin of [join(home, 'bin', EXE), join(home, 'Contents', 'Home', 'bin', EXE)]) {
+            if (existsSync(bin)) {
+                const j = await probeJava(bin);
+                if (j)
+                    return j;
+            }
+        }
+    }
+    return null;
+}
+export async function ensureJava(paths, major, opts = {}) {
+    if (opts.javaPath) {
+        const j = await probeJava(opts.javaPath);
+        if (!j)
+            throw new Error(`Not a working java executable: ${opts.javaPath}`);
+        return j;
+    }
+    const installs = await findJavaInstalls(paths);
+    const picked = opts.exact ? installs.find((j) => j.major === major) : pickJava(installs, major);
+    if (picked)
+        return picked;
+    if (opts.allowDownload === false) {
+        throw new Error(`Java ${major}${opts.exact ? '' : ' or newer'} is required but not installed (automatic download disabled)`);
+    }
+    return downloadJava(paths, major);
+}
+/** Java release HeadlessMC 3 itself runs on (the game may use another runtime). */
+export const LAUNCHER_JAVA_MAJOR = 25;
+/** A runtime for HeadlessMC itself (Java 25+); prefers an installed one, downloads Java 25 otherwise. */
+export async function ensureLauncherJava(paths, opts = {}) {
+    const picked = pickJava(await findJavaInstalls(paths), LAUNCHER_JAVA_MAJOR);
+    if (picked)
+        return picked;
+    if (opts.allowDownload === false) {
+        throw new Error(`HeadlessMC needs Java ${LAUNCHER_JAVA_MAJOR} or newer, which is not installed (automatic download disabled)`);
+    }
+    return downloadJava(paths, LAUNCHER_JAVA_MAJOR);
+}
+//# sourceMappingURL=java.js.map