@bkm016/calcite 0.0.0-stage → 0.1.0

package/dist/net.js

@@ -0,0 +1,246 @@
+import { createHash } from 'node:crypto';
+import { createWriteStream } from 'node:fs';
+import { mkdir, readFile, rename, rm, stat } from 'node:fs/promises';
+import http from 'node:http';
+import https from 'node:https';
+import { isIP } from 'node:net';
+import { dirname } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import tls from 'node:tls';
+import { logger } from './log.js';
+const log = logger('net');
+export const USER_AGENT = 'calcite (+https://github.com/bkm016/Calcite)';
+export class HttpError extends Error {
+    url;
+    status;
+    constructor(url, status) {
+        super(`HTTP ${status} for ${url}`);
+        this.url = url;
+        this.status = status;
+    }
+}
+function env(name) {
+    return process.env[name] || process.env[name.toLowerCase()] || undefined;
+}
+function ipv4ToInt(ip) {
+    return ip.split('.').reduce((acc, part) => (acc << 8) + Number(part), 0) >>> 0;
+}
+/** NO_PROXY matching: "*", exact hosts, ".suffix"/"suffix" domains, host:port and IPv4 CIDR. */
+export function bypassProxy(target, noProxy = env('NO_PROXY') ?? '') {
+    const host = target.hostname.replace(/^\[|\]$/g, '').toLowerCase();
+    const port = target.port || (target.protocol === 'https:' ? '443' : '80');
+    for (let rule of noProxy.split(/[\s,]+/)) {
+        rule = rule.trim().toLowerCase();
+        if (!rule)
+            continue;
+        if (rule === '*')
+            return true;
+        let rulePort;
+        const m = /^([^:]+):(\d+)$/.exec(rule);
+        if (m)
+            [, rule, rulePort] = m;
+        if (rulePort && rulePort !== port)
+            continue;
+        if (rule.includes('/')) {
+            const [net, bits] = rule.split('/');
+            if (isIP(net) !== 4 || isIP(host) !== 4)
+                continue;
+            const mask = Number(bits) === 0 ? 0 : (~0 << (32 - Number(bits))) >>> 0;
+            if ((ipv4ToInt(host) & mask) === (ipv4ToInt(net) & mask))
+                return true;
+            continue;
+        }
+        const domain = rule.replace(/^\*?\./, '');
+        if (host === domain || host.endsWith(`.${domain}`))
+            return true;
+    }
+    return false;
+}
+/** The proxy to use for {@code target}, honouring HTTPS_PROXY / HTTP_PROXY / NO_PROXY (any case). */
+export function proxyFor(target) {
+    const raw = target.protocol === 'https:' ? (env('HTTPS_PROXY') ?? env('HTTP_PROXY')) : env('HTTP_PROXY');
+    if (!raw || bypassProxy(target))
+        return undefined;
+    return new URL(raw.includes('://') ? raw : `http://${raw}`);
+}
+function proxyAuth(proxy) {
+    if (!proxy.username)
+        return {};
+    const cred = `${decodeURIComponent(proxy.username)}:${decodeURIComponent(proxy.password)}`;
+    return { 'proxy-authorization': `Basic ${Buffer.from(cred).toString('base64')}` };
+}
+/** Opens a TLS connection to {@code target} through an HTTP(S) proxy using CONNECT. */
+function tunnel(proxy, target, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const authority = `${target.hostname}:${target.port || 443}`;
+        const req = (proxy.protocol === 'https:' ? https : http).request({
+            host: proxy.hostname,
+            port: proxy.port || (proxy.protocol === 'https:' ? 443 : 80),
+            method: 'CONNECT',
+            path: authority,
+            headers: { host: authority, ...proxyAuth(proxy) },
+            agent: false,
+        });
+        const timer = setTimeout(() => req.destroy(new Error(`Proxy CONNECT to ${authority} timed out`)), timeoutMs);
+        req.once('connect', (res, socket) => {
+            clearTimeout(timer);
+            if (res.statusCode !== 200) {
+                socket.destroy();
+                reject(new Error(`Proxy CONNECT to ${authority} failed: HTTP ${res.statusCode}`));
+                return;
+            }
+            const secure = tls.connect({ socket, servername: isIP(target.hostname) ? undefined : target.hostname });
+            secure.once('secureConnect', () => resolve(secure));
+            secure.once('error', reject);
+        });
+        req.once('error', (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        req.end();
+    });
+}
+/** One GET without redirects. Resolves with the response (body not yet consumed). */
+async function getOnce(url, { timeoutMs = 60_000, idleMs = 120_000 }) {
+    const proxy = proxyFor(url);
+    const headers = { 'user-agent': USER_AGENT, accept: '*/*', 'accept-encoding': 'identity' };
+    let mod = url.protocol === 'https:' ? https : http;
+    let options = {
+        protocol: url.protocol,
+        host: url.hostname,
+        port: url.port || undefined,
+        path: `${url.pathname}${url.search}`,
+    };
+    if (proxy && url.protocol === 'https:') {
+        const socket = await tunnel(proxy, url, timeoutMs);
+        options = { ...options, agent: false, createConnection: () => socket };
+    }
+    else if (proxy) {
+        // Plain HTTP through a proxy: absolute-form request target.
+        mod = proxy.protocol === 'https:' ? https : http;
+        options = { protocol: proxy.protocol, host: proxy.hostname, port: proxy.port || undefined, path: url.toString(), agent: false };
+        Object.assign(headers, proxyAuth(proxy), { host: url.host });
+    }
+    return new Promise((resolve, reject) => {
+        const req = mod.request({ ...options, method: 'GET', headers });
+        const timer = setTimeout(() => req.destroy(new Error(`Timed out waiting for ${url}`)), timeoutMs);
+        req.once('response', (res) => {
+            clearTimeout(timer);
+            req.setTimeout(idleMs, () => req.destroy(new Error(`Download of ${url} stalled`)));
+            resolve(res);
+        });
+        req.once('error', (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+        req.end();
+    });
+}
+/** GET following redirects. Throws {@link HttpError} for non-2xx responses. */
+async function get(url, opts = {}) {
+    let current = new URL(url);
+    for (let hop = 0;; hop++) {
+        const res = await getOnce(current, opts);
+        const status = res.statusCode ?? 0;
+        if (status >= 300 && status < 400 && res.headers.location) {
+            res.resume();
+            if (hop >= 10)
+                throw new Error(`Too many redirects for ${url}`);
+            current = new URL(res.headers.location, current);
+            continue;
+        }
+        if (status >= 200 && status < 300)
+            return res;
+        res.resume();
+        throw new HttpError(url, status);
+    }
+}
+function retryable(err) {
+    return !(err instanceof HttpError) || err.status === 429 || err.status >= 500;
+}
+/** Runs a whole transfer with retries and exponential backoff on network errors, 429 and 5xx. */
+async function withRetries(url, fn, retries = 4) {
+    for (let attempt = 0;; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            if (!retryable(err) || attempt >= retries)
+                throw err;
+            const delay = 1000 * 2 ** attempt;
+            log.debug(`retry ${attempt + 1}/${retries} for ${url} in ${delay}ms: ${err.message}`);
+            await new Promise((r) => setTimeout(r, delay));
+        }
+    }
+}
+async function readAll(res) {
+    const chunks = [];
+    for await (const chunk of res)
+        chunks.push(chunk);
+    const expected = Number(res.headers['content-length'] ?? -1);
+    const body = Buffer.concat(chunks);
+    if (expected >= 0 && body.length !== expected)
+        throw new Error(`Truncated response: ${body.length}/${expected} bytes`);
+    return body;
+}
+export async function httpText(url) {
+    return withRetries(url, async () => (await readAll(await get(url))).toString('utf8'));
+}
+export async function httpJson(url) {
+    return JSON.parse(await httpText(url));
+}
+export async function hashFile(file, algorithm) {
+    return createHash(algorithm).update(await readFile(file)).digest('hex');
+}
+async function exists(file) {
+    try {
+        await stat(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Downloads to {@code dest} atomically (temp file + rename) and verifies the hash when given. */
+export async function download(url, dest, opts = {}) {
+    const { sha1, sha256, reuse = true } = opts;
+    if (reuse && (await exists(dest))) {
+        if (sha1 && (await hashFile(dest, 'sha1')) === sha1.toLowerCase())
+            return dest;
+        if (sha256 && (await hashFile(dest, 'sha256')) === sha256.toLowerCase())
+            return dest;
+        if (!sha1 && !sha256)
+            return dest;
+        log.warn(`hash mismatch for existing ${dest}, downloading again`);
+    }
+    await mkdir(dirname(dest), { recursive: true });
+    const tmp = `${dest}.${process.pid}.${Date.now()}.part`;
+    try {
+        await withRetries(url, async () => {
+            const res = await get(url);
+            const expected = Number(res.headers['content-length'] ?? -1);
+            await pipeline(res, createWriteStream(tmp));
+            if (expected >= 0) {
+                const { size } = await stat(tmp);
+                if (size !== expected)
+                    throw new Error(`Truncated download of ${url}: ${size}/${expected} bytes`);
+            }
+        });
+        if (sha1) {
+            const actual = await hashFile(tmp, 'sha1');
+            if (actual !== sha1.toLowerCase())
+                throw new Error(`SHA-1 mismatch for ${url}: expected ${sha1}, got ${actual}`);
+        }
+        if (sha256) {
+            const actual = await hashFile(tmp, 'sha256');
+            if (actual !== sha256.toLowerCase())
+                throw new Error(`SHA-256 mismatch for ${url}: expected ${sha256}, got ${actual}`);
+        }
+        await rename(tmp, dest);
+        return dest;
+    }
+    finally {
+        await rm(tmp, { force: true });
+    }
+}
+//# sourceMappingURL=net.js.map

package/dist/net.js.map

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

package/dist/options.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Game options Calcite enforces so an unattended client never blocks on first-run screens and stays cheap.
+ * Unknown keys are ignored by versions that do not have them.
+ */
+export declare function defaultOptions(opts?: {
+    renderDistance?: number;
+    maxFps?: number;
+    muted?: boolean;
+}): Record<string, string>;
+/** Parses options.txt ("key:value" lines). */
+export declare function parseOptions(text: string): Map<string, string>;
+export declare function serializeOptions(map: Map<string, string>): string;
+/** Merges {@code overrides} into gameDir/options.txt, keeping every other existing option. */
+export declare function writeOptions(gameDir: string, overrides: Record<string, string>): Promise<void>;

package/dist/options.js

@@ -0,0 +1,50 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Game options Calcite enforces so an unattended client never blocks on first-run screens and stays cheap.
+ * Unknown keys are ignored by versions that do not have them.
+ */
+export function defaultOptions(opts = {}) {
+    return {
+        onboardAccessibility: 'false',
+        skipMultiplayerWarning: 'true',
+        joinedFirstServer: 'true',
+        tutorialStep: 'none',
+        pauseOnLostFocus: 'false',
+        narrator: '0',
+        fullscreen: 'false',
+        renderDistance: String(opts.renderDistance ?? 8),
+        simulationDistance: String(Math.min(opts.renderDistance ?? 8, 8)),
+        maxFps: String(opts.maxFps ?? 30),
+        ...(opts.muted === false ? {} : { soundCategory_master: '0.0' }),
+    };
+}
+/** Parses options.txt ("key:value" lines). */
+export function parseOptions(text) {
+    const map = new Map();
+    for (const line of text.split(/\r?\n/)) {
+        const idx = line.indexOf(':');
+        if (idx > 0)
+            map.set(line.slice(0, idx), line.slice(idx + 1));
+    }
+    return map;
+}
+export function serializeOptions(map) {
+    return [...map].map(([k, v]) => `${k}:${v}`).join('\n') + '\n';
+}
+/** Merges {@code overrides} into gameDir/options.txt, keeping every other existing option. */
+export async function writeOptions(gameDir, overrides) {
+    await mkdir(gameDir, { recursive: true });
+    const file = join(gameDir, 'options.txt');
+    let current = new Map();
+    try {
+        current = parseOptions(await readFile(file, 'utf8'));
+    }
+    catch {
+        // first launch
+    }
+    for (const [k, v] of Object.entries(overrides))
+        current.set(k, v);
+    await writeFile(file, serializeOptions(current));
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsE,EAAE;IACrG,OAAO;QACL,oBAAoB,EAAE,OAAO;QAC7B,sBAAsB,EAAE,MAAM;QAC9B,iBAAiB,EAAE,MAAM;QACzB,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,OAAO;QACzB,QAAQ,EAAE,GAAG;QACb,UAAU,EAAE,OAAO;QACnB,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QAChD,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAwB;IACvD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjE,CAAC;AAED,8FAA8F;AAC9F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe,EAAE,SAAiC;IACnF,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC1C,IAAI,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,SAAS,CAAC,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,27 @@
+/** Directory layout under CALCITE_HOME (default ~/.calcite). */
+export interface CalcitePaths {
+    /** Root of all Calcite data. */
+    home: string;
+    /** Working directory of HeadlessMC: shared config and stored accounts (HeadlessMC/auth/.accounts.json). */
+    hmcHome: string;
+    /** HeadlessMC launcher jars. */
+    hmcJars: string;
+    /** Shared Minecraft directory: versions, libraries, assets. */
+    minecraft: string;
+    /** Java runtimes downloaded by Calcite. */
+    java: string;
+    /** Mojang client mappings. */
+    mappings: string;
+    /** Cached Mojang metadata. */
+    meta: string;
+    /** Per-client game directories. */
+    instances: string;
+    /** Directory for the probe jar and its config files; guaranteed free of spaces and commas. */
+    probe: string;
+}
+/**
+ * Picks a directory whose path can be passed through HeadlessMC's space-separated hmc.jvmargs and the
+ * -javaagent option (no spaces, commas, equals signs or quotes).
+ */
+export declare function safeProbeDir(home: string): string;
+export declare function resolvePaths(home?: string): CalcitePaths;

package/dist/paths.js

@@ -0,0 +1,48 @@
+import { homedir, tmpdir, userInfo } from 'node:os';
+import { join } from 'node:path';
+const UNSAFE_FOR_JVM_ARGS = /[\s,=;"']/;
+/**
+ * Picks a directory whose path can be passed through HeadlessMC's space-separated hmc.jvmargs and the
+ * -javaagent option (no spaces, commas, equals signs or quotes).
+ */
+export function safeProbeDir(home) {
+    const candidates = [join(home, 'probe')];
+    if (process.platform === 'win32') {
+        candidates.push(join(process.env.PUBLIC || 'C:\\Users\\Public', 'calcite', 'probe'));
+        candidates.push(join(process.env.SystemDrive || 'C:', 'calcite-probe'));
+    }
+    else {
+        let user = 'user';
+        try {
+            user = String(userInfo().uid);
+        }
+        catch {
+            // keep default
+        }
+        candidates.push(join(tmpdir(), `calcite-${user}`, 'probe'));
+        candidates.push(join('/tmp', `calcite-${user}`, 'probe'));
+    }
+    const found = candidates.find((dir) => !UNSAFE_FOR_JVM_ARGS.test(dir));
+    if (!found) {
+        throw new Error(`Cannot find a directory without spaces for the probe; set CALCITE_PROBE_DIR. Tried: ${candidates.join(', ')}`);
+    }
+    return found;
+}
+export function resolvePaths(home = process.env.CALCITE_HOME || join(homedir(), '.calcite')) {
+    const probe = process.env.CALCITE_PROBE_DIR || safeProbeDir(home);
+    if (UNSAFE_FOR_JVM_ARGS.test(probe)) {
+        throw new Error(`CALCITE_PROBE_DIR must not contain spaces, commas, '=' or quotes: ${probe}`);
+    }
+    return {
+        home,
+        hmcHome: join(home, 'hmc-home'),
+        hmcJars: join(home, 'hmc'),
+        minecraft: join(home, 'minecraft'),
+        java: join(home, 'java'),
+        mappings: join(home, 'mappings'),
+        meta: join(home, 'meta'),
+        instances: join(home, 'instances'),
+        probe,
+    };
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAwBjC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,UAAU,GAAa,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,mBAAmB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QACrF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,IAAI,IAAI,GAAG,MAAM,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,uFAAuF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClI,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC;IACzF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qEAAqE,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAC/B,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;QAC1B,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QAClC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC;QAClC,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/probe-server.d.ts

@@ -0,0 +1,28 @@
+import { EventEmitter } from 'node:events';
+export declare const PROBE_PROTOCOL = 1;
+export declare class ProbeError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * TCP endpoint (127.0.0.1, random port) the in-game probe connects to. Authenticated with a random token;
+ * JSON objects separated by newlines.
+ *
+ * Events: 'connected', 'disconnected'.
+ */
+export declare class ProbeServer extends EventEmitter {
+    readonly token: string;
+    private server;
+    private socket;
+    private nextId;
+    private pending;
+    port: number;
+    listen(): Promise<number>;
+    get connected(): boolean;
+    private accept;
+    private onResponse;
+    private failAll;
+    /** Sends one request to the probe. */
+    request<T = unknown>(op: string, args?: Record<string, unknown>, timeoutMs?: number): Promise<T>;
+    close(): Promise<void>;
+}

package/dist/probe-server.js

@@ -0,0 +1,132 @@
+import { randomBytes } from 'node:crypto';
+import { EventEmitter } from 'node:events';
+import { createServer } from 'node:net';
+import { createInterface } from 'node:readline';
+import { logger } from './log.js';
+const log = logger('probe');
+export const PROBE_PROTOCOL = 1;
+export class ProbeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ProbeError';
+    }
+}
+/**
+ * TCP endpoint (127.0.0.1, random port) the in-game probe connects to. Authenticated with a random token;
+ * JSON objects separated by newlines.
+ *
+ * Events: 'connected', 'disconnected'.
+ */
+export class ProbeServer extends EventEmitter {
+    token = randomBytes(24).toString('hex');
+    server = null;
+    socket = null;
+    nextId = 1;
+    pending = new Map();
+    port = 0;
+    async listen() {
+        this.server = createServer((socket) => this.accept(socket));
+        await new Promise((resolve, reject) => {
+            this.server.once('error', reject);
+            this.server.listen(0, '127.0.0.1', () => resolve());
+        });
+        const address = this.server.address();
+        if (!address || typeof address === 'string')
+            throw new Error('Probe server has no TCP address');
+        this.port = address.port;
+        return this.port;
+    }
+    get connected() {
+        return this.socket !== null;
+    }
+    accept(socket) {
+        socket.setNoDelay(true);
+        let authed = false;
+        const helloTimer = setTimeout(() => {
+            if (!authed)
+                socket.destroy();
+        }, 10_000);
+        const rl = createInterface({ input: socket });
+        rl.on('line', (line) => {
+            let msg;
+            try {
+                msg = JSON.parse(line);
+            }
+            catch {
+                socket.destroy();
+                return;
+            }
+            if (!authed) {
+                if (msg.type !== 'hello' || msg.token !== this.token) {
+                    log.warn('rejected a probe connection with a wrong token');
+                    socket.destroy();
+                    return;
+                }
+                if (msg.protocol !== PROBE_PROTOCOL) {
+                    log.warn(`probe protocol ${String(msg.protocol)} differs from ${PROBE_PROTOCOL}`);
+                }
+                authed = true;
+                clearTimeout(helloTimer);
+                this.socket?.destroy();
+                this.socket = socket;
+                log.debug(`probe connected (java ${String(msg.java)})`);
+                this.emit('connected', msg);
+                return;
+            }
+            this.onResponse(msg);
+        });
+        socket.on('error', () => undefined);
+        socket.on('close', () => {
+            clearTimeout(helloTimer);
+            if (this.socket === socket) {
+                this.socket = null;
+                this.failAll(new ProbeError('disconnected', 'The game closed the probe connection'));
+                this.emit('disconnected');
+            }
+        });
+    }
+    onResponse(msg) {
+        const id = Number(msg.id);
+        const pending = this.pending.get(id);
+        if (!pending)
+            return;
+        this.pending.delete(id);
+        clearTimeout(pending.timer);
+        if (msg.ok)
+            pending.resolve(msg.result);
+        else
+            pending.reject(new ProbeError(String(msg.code ?? 'error'), String(msg.error ?? 'probe error')));
+    }
+    failAll(err) {
+        for (const [id, p] of this.pending) {
+            clearTimeout(p.timer);
+            p.reject(err);
+            this.pending.delete(id);
+        }
+    }
+    /** Sends one request to the probe. */
+    request(op, args = {}, timeoutMs = 15_000) {
+        const socket = this.socket;
+        if (!socket)
+            return Promise.reject(new ProbeError('not_connected', 'The game probe is not connected'));
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new ProbeError('timeout', `Probe request "${op}" timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve: resolve, reject, timer });
+            socket.write(JSON.stringify({ id, op, args }) + '\n');
+        });
+    }
+    async close() {
+        this.failAll(new ProbeError('closed', 'Probe server closed'));
+        this.socket?.destroy();
+        this.socket = null;
+        await new Promise((resolve) => (this.server ? this.server.close(() => resolve()) : resolve()));
+        this.server = null;
+    }
+}
+//# sourceMappingURL=probe-server.js.map

package/dist/probe-server.js.map

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

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** Package version, read from package.json next to dist/. */
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,11 @@
+import { readFileSync } from 'node:fs';
+/** Package version, read from package.json next to dist/. */
+export const VERSION = (() => {
+    try {
+        return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+    }
+    catch {
+        return '0.0.0';
+    }
+})();
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,OAAO,GAAW,CAAC,GAAG,EAAE;IACnC,IAAI,CAAC;QACH,OAAQ,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAyB,CAAC,OAAO,CAAC;IACxH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,EAAE,CAAC"}