grim-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Grim Mineflayer contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# grim-server
+
+A self-contained Minecraft server launcher for Paper + Grim anticheat.
+
+## Features
+
+- Downloads and caches Paper server jars and Grim anticheat jars automatically
+- Resolves Java automatically from an explicit setting, `JAVA_HOME`, or the system `PATH`
+- Creates and updates a local `grim-server.config.json` file for server settings
+- Starts a server in a dedicated directory without removing worlds or config state
+- Exposes a small library for programmatic server startup and artifact discovery
+
+## Installation
+
+```sh
+npm install -g grim-server
+```
+
+## Quick start
+
+```sh
+mkdir my-server && cd my-server
+grim-server init
+grim-server start
+```
+
+This creates `grim-server.config.json` in the current directory and starts the configured server using the resolved Java runtime.
+
+## Commands
+
+```text
+grim-server init
+grim-server start [minecraft-version]
+grim-server versions
+grim-server verify [minecraft-version]
+```
+
+### `grim-server init`
+
+Creates a default config file:
+
+```json
+{
+  "version": "1.21.11",
+  "serverDir": ".grim-server",
+  "cacheDir": ".grim-cache",
+  "port": 25565,
+  "motd": "Grim Minecraft Server",
+  "onlineMode": false,
+  "allowFlight": true,
+  "memory": {
+    "min": "1G",
+    "max": "2G"
+  }
+}
+```
+
+### `grim-server start [minecraft-version]`
+
+Starts a Paper server with Grim enabled. If a version is provided, it overrides `config.version` for that run.
+
+### `grim-server versions`
+
+Lists available Paper versions from the upstream API.
+
+### `grim-server verify [minecraft-version]`
+
+Resolves the Paper and Grim artifacts for the selected version and prints their metadata.
+
+## Configuration
+
+`grim-server.config.json` lives next to the project root or the working directory used when launching the CLI. You can also pass partial overrides programmatically when calling the library.
+
+### Supported fields
+
+- `version`: Paper Minecraft version to use (for example `1.21.11`)
+- `serverDir`: Directory that stores the server world and generated configs
+- `cacheDir`: Directory used for downloaded jar artifacts
+- `port`: Minecraft port, between `1` and `65535`
+- `motd`: Server MOTD shown in the client
+- `onlineMode`: Toggle Mojang authentication / online mode
+- `allowFlight`: Allow flight in-game
+- `memory.min`: Minimum Java heap size
+- `memory.max`: Maximum Java heap size
+- `serverProperties`: Any Minecraft `server.properties` key/value, including keys added by newer Minecraft or Paper versions
+- `javaArgs`: Additional JVM arguments
+- `environment`: Environment variables passed to the server process
+- `captureOutput`: Capture child-process streams for programmatic logging
+- `java`: Optional explicit Java executable or path override
+- `paperJar`: Optional custom Paper jar path
+- `grimJar`: Optional custom Grim jar path
+
+### Example
+
+```json
+{
+  "version": "1.21.7",
+  "serverDir": "./worlds/dev",
+  "cacheDir": "./.cache",
+  "port": 25565,
+  "motd": "Local Grim dev server",
+  "onlineMode": false,
+  "allowFlight": true,
+  "serverProperties": {
+    "difficulty": "hard",
+    "gamemode": "survival",
+    "view-distance": 10,
+    "simulation-distance": 10,
+    "spawn-protection": 0,
+    "enable-command-block": true,
+    "white-list": false
+  },
+  "javaArgs": ["-XX:+UseG1GC"],
+  "environment": {
+    "LANG": "en_US.UTF-8"
+  },
+  "captureOutput": true,
+  "memory": {
+    "min": "512M",
+    "max": "1G"
+  }
+}
+```
+
+## Java and runtime resolution
+
+Java is resolved in this order:
+
+1. Explicit `java` config value
+2. Bundled runtime in `.runtime/current` or a matching extracted JDK directory
+3. `JAVA_HOME`
+4. System `PATH`
+5. Platform default Java command as a final fallback
+
+Java 21 must be installed separately, or supplied through the `java` configuration field or `JAVA_HOME`. The optional `bundle:runtime` script can download a local development runtime, but it is not included in the npm package.
+
+## Artifact discovery
+
+Paper builds are discovered from the official Paper API, and Grim releases are resolved from Modrinth with GitHub releases as a fallback. Downloaded jars are cached locally and verified with published checksums before use.
+
+## Library usage
+
+```ts
+import { startServer } from 'grim-server';
+
+const server = await startServer({
+  version: '1.21.11',
+  port: 25565,
+  motd: 'Local dev server',
+  onlineMode: false,
+});
+
+server.on('close', (code) => {
+  console.log(`server exited with code ${code}`);
+});
+```
+
+The package also exports helpers for configuration, artifact cache management, Java resolution, and server startup.
+
+The returned server handle is the underlying `ChildProcess` with convenience methods:
+
+```ts
+server.say('Server is ready');
+server.command('weather clear');
+server.stop();
+server.killServer();
+server.onLine((line) => console.log('[minecraft]', line));
+server.onLog((line, stream) => console.log(`[${stream}]`, line));
+server.on('exit', (code, signal) => console.log({ code, signal }));
+server.on('error', (error) => console.error(error));
+```
+
+Unknown or future Minecraft/Paper properties are passed through unchanged. Existing files in
+`serverDir` are preserved, and only the explicitly managed properties plus values in
+`serverProperties` are updated.
+
+## Development
+
+```sh
+npm install
+npm run check
+```
+
+## License
+
+Paper and Grim remain subject to their own licenses. This project is distributed under the MIT license.

package/dist/artifacts/cache.d.ts

@@ -0,0 +1,6 @@
+import type { Artifact, DiscoveryOptions } from './types.js';
+export declare function cacheArtifact(artifact: Artifact, cacheDir: string, options?: DiscoveryOptions): Promise<Artifact & {
+    path: string;
+}>;
+export declare function hashFile(file: string, algorithm?: 'sha256' | 'sha1' | 'sha512'): Promise<string>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/artifacts/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/artifacts/cache.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAsB,aAAa,CACjC,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BtC;AAED,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,QAAQ,GAAG,MAAM,GAAG,QAAmB,GACjD,OAAO,CAAC,MAAM,CAAC,CAIjB"}

package/dist/artifacts/cache.js

@@ -0,0 +1,73 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { access, mkdir, rename, rm, stat } from 'node:fs/promises';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import path from 'node:path';
+import { request } from './http.js';
+export async function cacheArtifact(artifact, cacheDir, options = {}) {
+    await mkdir(cacheDir, { recursive: true });
+    const target = path.join(cacheDir, safeName(artifact.name));
+    if (await matchesChecksum(target, artifact))
+        return { ...artifact, path: target };
+    await rm(target, { force: true });
+    const temporary = `${target}.${process.pid}.${randomUUID()}.part`;
+    try {
+        await downloadToFile(artifact, temporary, options);
+        if (artifact.sha256 &&
+            (await hashFile(temporary, 'sha256')) !== artifact.sha256.toLowerCase()) {
+            throw new Error(`SHA-256 verification failed for ${artifact.name}`);
+        }
+        if (artifact.checksum) {
+            const actual = await hashFile(temporary, artifact.checksum.algorithm);
+            if (actual !== artifact.checksum.value.toLowerCase()) {
+                throw new Error(`${artifact.checksum.algorithm} verification failed for ${artifact.name}`);
+            }
+        }
+        await rename(temporary, target);
+        return { ...artifact, path: target };
+    }
+    catch (error) {
+        await rm(temporary, { force: true });
+        throw error;
+    }
+}
+export async function hashFile(file, algorithm = 'sha256') {
+    const hash = createHash(algorithm);
+    for await (const chunk of createReadStream(file))
+        hash.update(chunk);
+    return hash.digest('hex').toLowerCase();
+}
+async function downloadToFile(artifact, file, options) {
+    const response = await request(artifact.url, { headers: { 'User-Agent': 'grim-server' } }, options);
+    if (!response.ok || !response.body) {
+        throw new Error(`Unable to download ${artifact.name}: HTTP ${response.status}`);
+    }
+    await pipeline(Readable.fromWeb(response.body), createWriteStream(file));
+}
+async function matchesChecksum(file, artifact) {
+    try {
+        const info = await stat(file);
+        if (info.size === 0)
+            return false;
+        if (artifact.sha256)
+            return (await hashFile(file)) === artifact.sha256.toLowerCase();
+        if (artifact.checksum) {
+            return ((await hashFile(file, artifact.checksum.algorithm)) ===
+                artifact.checksum.value.toLowerCase());
+        }
+        await access(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function safeName(name) {
+    const normalized = path.basename(name).replace(/[^a-zA-Z0-9._-]/g, '_');
+    if (!normalized || normalized === '.' || normalized === '..') {
+        throw new Error('Artifact name is invalid');
+    }
+    return normalized;
+}
+//# sourceMappingURL=cache.js.map

package/dist/artifacts/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/artifacts/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAkB,EAClB,QAAgB,EAChB,UAA4B,EAAE;IAE9B,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5D,IAAI,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClF,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,OAAO,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACnD,IACE,QAAQ,CAAC,MAAM;YACf,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,EACvE,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACtE,IAAI,MAAM,KAAK,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACrD,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,4BAA4B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7F,CAAC;QACH,CAAC;QACD,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,YAA0C,QAAQ;IAElD,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,QAAkB,EAClB,IAAY,EACZ,OAAyB;IAEzB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,QAAQ,CAAC,GAAG,EACZ,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,EAC5C,OAAO,CACR,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,IAAI,UAAU,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,QAAQ,CACZ,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAA2D,CAAC,EACtF,iBAAiB,CAAC,IAAI,CAAC,CACxB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,QAAkB;IAC7D,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAClC,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACrF,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,CACL,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACnD,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CACtC,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACxE,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/artifacts/grim.d.ts

@@ -0,0 +1,3 @@
+import type { Artifact, DiscoveryOptions } from './types.js';
+export declare function resolveGrim(minecraftVersion: string, options?: DiscoveryOptions): Promise<Artifact>;
+//# sourceMappingURL=grim.d.ts.map

package/dist/artifacts/grim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grim.d.ts","sourceRoot":"","sources":["../../src/artifacts/grim.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAsB,WAAW,CAC/B,gBAAgB,EAAE,MAAM,EACxB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CAmEnB"}

package/dist/artifacts/grim.js

@@ -0,0 +1,94 @@
+import { cacheArtifact } from './cache.js';
+import { requestJson } from './http.js';
+export async function resolveGrim(minecraftVersion, options = {}) {
+    let modrinthError;
+    try {
+        const versions = await requestJson(`https://api.modrinth.com/v2/project/grimac/version?game_versions=${encodeURIComponent(JSON.stringify([minecraftVersion]))}`, options);
+        if (!Array.isArray(versions)) {
+            throw new Error('Modrinth discovery returned an invalid response');
+        }
+        const selected = versions
+            .filter((value) => isModrinthVersion(value, minecraftVersion))
+            .sort(compareModrinthVersions)[0];
+        const file = selected?.files.find((entry) => entry.primary && /\.jar$/i.test(entry.filename)) ??
+            selected?.files.find((entry) => /\.jar$/i.test(entry.filename));
+        if (selected && file?.url) {
+            const checksum = file.hashes.sha512
+                ? { algorithm: 'sha512', value: file.hashes.sha512 }
+                : file.hashes.sha1
+                    ? { algorithm: 'sha1', value: file.hashes.sha1 }
+                    : undefined;
+            const artifact = {
+                name: file.filename,
+                url: file.url,
+                version: selected.version_number,
+                source: 'modrinth',
+                ...(checksum ? { checksum } : {}),
+            };
+            return options.cacheDir ? cacheArtifact(artifact, options.cacheDir, options) : artifact;
+        }
+    }
+    catch (error) {
+        modrinthError = error;
+    }
+    try {
+        const releases = await requestJson('https://api.github.com/repos/GrimAnticheat/Grim/releases?per_page=30', { ...options, headers: { Accept: 'application/vnd.github+json' } });
+        if (!Array.isArray(releases)) {
+            throw new Error('GitHub release discovery returned an invalid response');
+        }
+        const release = releases.find((value) => isGithubRelease(value, minecraftVersion));
+        const asset = release && githubAsset(release);
+        if (!asset) {
+            throw new Error(`No Grim release asset is compatible with Minecraft ${minecraftVersion}`);
+        }
+        const artifact = {
+            name: asset.name,
+            url: asset.browser_download_url,
+            version: typeof release.tag_name === 'string' ? release.tag_name : minecraftVersion,
+            source: 'github',
+            ...(asset.digest?.startsWith('sha256:')
+                ? { sha256: asset.digest.slice('sha256:'.length).toLowerCase() }
+                : {}),
+        };
+        return options.cacheDir ? cacheArtifact(artifact, options.cacheDir, options) : artifact;
+    }
+    catch (fallbackError) {
+        const reason = modrinthError instanceof Error ? ` Modrinth: ${modrinthError.message}.` : '';
+        throw new Error(`Unable to discover Grim for Minecraft ${minecraftVersion}.${reason} GitHub: ${fallbackError instanceof Error ? fallbackError.message : String(fallbackError)}`);
+    }
+}
+function isModrinthVersion(value, minecraftVersion) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const version = value;
+    return (typeof version.version_number === 'string' &&
+        typeof version.version_type === 'string' &&
+        typeof version.date_published === 'string' &&
+        Array.isArray(version.game_versions) &&
+        version.game_versions.includes(minecraftVersion) &&
+        Array.isArray(version.loaders) &&
+        version.loaders.some((loader) => ['paper', 'bukkit', 'spigot'].includes(loader.toLowerCase())) &&
+        Array.isArray(version.files));
+}
+function compareModrinthVersions(a, b) {
+    const rank = (type) => (type === 'release' ? 0 : type === 'beta' ? 1 : 2);
+    return (rank(a.version_type) - rank(b.version_type) ||
+        Date.parse(b.date_published) - Date.parse(a.date_published));
+}
+function isGithubRelease(value, version) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const release = value;
+    const text = `${release.tag_name ?? ''} ${release.name ?? ''} ${release.body ?? ''}`;
+    return (release.draft !== true &&
+        release.prerelease !== true &&
+        Array.isArray(release.assets) &&
+        text.includes(version));
+}
+function githubAsset(release) {
+    return release.assets.find((asset) => typeof asset.name === 'string' &&
+        /\.jar$/i.test(asset.name) &&
+        typeof asset.browser_download_url === 'string' &&
+        (asset.size === undefined || asset.size > 0));
+}
+//# sourceMappingURL=grim.js.map

package/dist/artifacts/grim.js.map

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

package/dist/artifacts/http.d.ts

@@ -0,0 +1,8 @@
+import type { DiscoveryOptions } from './types.js';
+declare const defaultFetch: (input: string | URL, init?: RequestInit) => Promise<Response>;
+export declare function requestJson(url: string, options?: DiscoveryOptions & {
+    headers?: HeadersInit;
+}): Promise<unknown>;
+export declare function request(input: string | URL, init: RequestInit, options?: DiscoveryOptions): Promise<Response>;
+export { defaultFetch };
+//# sourceMappingURL=http.d.ts.map

package/dist/artifacts/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/artifacts/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,QAAA,MAAM,YAAY,GAAI,OAAO,MAAM,GAAG,GAAG,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,QAAQ,CAC5D,CAAC;AAErB,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,gBAAgB,GAAG;IAAE,OAAO,CAAC,EAAE,WAAW,CAAA;CAAO,GACzD,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,GAAG,GAAG,EACnB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CASnB;AA4BD,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/artifacts/http.js

@@ -0,0 +1,51 @@
+const defaultFetch = (input, init) => fetch(input, init);
+export async function requestJson(url, options = {}) {
+    const response = await request(url, {
+        headers: { 'User-Agent': 'grim-server', ...options.headers },
+    }, options);
+    if (!response.ok)
+        throw new Error(`Discovery request failed: HTTP ${response.status}`);
+    return response.json();
+}
+export async function request(input, init, options = {}) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), options.timeoutMs ?? 15_000);
+    const signal = combineSignals(options.signal, controller.signal);
+    try {
+        return await withRetries(() => (options.fetch ?? defaultFetch)(input, { ...init, signal }));
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function withRetries(requester) {
+    let lastError;
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+        try {
+            const response = await requester();
+            if (response.ok || response.status < 500)
+                return response;
+            lastError = new Error(`HTTP ${response.status}`);
+        }
+        catch (error) {
+            lastError = error;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 250 * 2 ** attempt));
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+function combineSignals(...signals) {
+    const available = signals.filter((signal) => signal !== undefined);
+    if (available.length === 1 && available[0])
+        return available[0];
+    const controller = new AbortController();
+    for (const signal of available) {
+        if (signal.aborted)
+            controller.abort(signal.reason);
+        else
+            signal.addEventListener('abort', () => controller.abort(signal.reason), { once: true });
+    }
+    return controller.signal;
+}
+export { defaultFetch };
+//# sourceMappingURL=http.js.map

package/dist/artifacts/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/artifacts/http.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,CAAC,KAAmB,EAAE,IAAkB,EAAqB,EAAE,CAClF,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,UAAwD,EAAE;IAE1D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,GAAG,EACH;QACE,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE;KAC7D,EACD,OAAO,CACR,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACvF,OAAO,QAAQ,CAAC,IAAI,EAAsB,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,KAAmB,EACnB,IAAiB,EACjB,UAA4B,EAAE;IAE9B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,OAAO,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,SAAkC;IAC3D,IAAI,SAAkB,CAAC;IACvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,EAAE,CAAC;YACnC,IAAI,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG;gBAAE,OAAO,QAAQ,CAAC;YAC1D,SAAS,GAAG,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,GAAG,OAAoC;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAyB,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IAC1F,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,OAAO;YAAE,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;;YAC/C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,UAAU,CAAC,MAAM,CAAC;AAC3B,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/artifacts/index.d.ts

@@ -0,0 +1,5 @@
+export { cacheArtifact, hashFile } from './cache.js';
+export { listPaperVersions, resolvePaper } from './paper.js';
+export { resolveGrim } from './grim.js';
+export type { Artifact, Checksum, DiscoveryOptions, HttpClient } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/artifacts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/artifacts/index.js

@@ -0,0 +1,4 @@
+export { cacheArtifact, hashFile } from './cache.js';
+export { listPaperVersions, resolvePaper } from './paper.js';
+export { resolveGrim } from './grim.js';
+//# sourceMappingURL=index.js.map

package/dist/artifacts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/artifacts/paper.d.ts

@@ -0,0 +1,4 @@
+import type { Artifact, DiscoveryOptions } from './types.js';
+export declare function listPaperVersions(options?: DiscoveryOptions): Promise<string[]>;
+export declare function resolvePaper(version: string, options?: DiscoveryOptions): Promise<Artifact>;
+//# sourceMappingURL=paper.d.ts.map

package/dist/artifacts/paper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paper.d.ts","sourceRoot":"","sources":["../../src/artifacts/paper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYzF;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,QAAQ,CAAC,CA6BnB"}

package/dist/artifacts/paper.js

@@ -0,0 +1,56 @@
+import { cacheArtifact } from './cache.js';
+import { requestJson } from './http.js';
+export async function listPaperVersions(options = {}) {
+    const response = await requestJson('https://fill.papermc.io/v3/projects/paper', options);
+    if (!response || typeof response !== 'object') {
+        throw new Error('Paper version discovery returned an invalid response');
+    }
+    const versions = response.versions;
+    if (!versions || typeof versions !== 'object' || Array.isArray(versions)) {
+        throw new Error('Paper version discovery returned an invalid response');
+    }
+    return Object.values(versions).flatMap((value) => Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : []);
+}
+export async function resolvePaper(version, options = {}) {
+    if (version === 'latest') {
+        const available = await listPaperVersions(options);
+        const selected = available[0];
+        if (!selected)
+            throw new Error('Paper discovery returned no versions');
+        version = selected;
+    }
+    const response = await requestJson(`https://fill.papermc.io/v3/projects/paper/versions/${encodeURIComponent(version)}/builds`, options);
+    if (!Array.isArray(response))
+        throw new Error('Paper discovery returned an invalid response');
+    const builds = response.filter(isPaperBuild);
+    if (builds.length === 0) {
+        throw new Error(`No Paper builds are available for Minecraft ${version}`);
+    }
+    const stable = builds.filter((build) => build.channel.toUpperCase() === 'STABLE');
+    const selected = [...(stable.length > 0 ? stable : builds)].sort((a, b) => b.id - a.id)[0];
+    if (!selected)
+        throw new Error(`No usable Paper build is available for Minecraft ${version}`);
+    const download = selected.downloads['server:default'];
+    const artifact = {
+        name: download.name,
+        url: download.url,
+        version,
+        sha256: download.checksums.sha256.toLowerCase(),
+        source: 'paper',
+        build: selected.id,
+    };
+    return options.cacheDir ? cacheArtifact(artifact, options.cacheDir, options) : artifact;
+}
+function isPaperBuild(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const build = value;
+    const download = build.downloads?.['server:default'];
+    return (Number.isInteger(build.id) &&
+        typeof build.channel === 'string' &&
+        !!download &&
+        typeof download.name === 'string' &&
+        typeof download.url === 'string' &&
+        typeof download.checksums?.sha256 === 'string');
+}
+//# sourceMappingURL=paper.js.map

package/dist/artifacts/paper.js.map

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

package/dist/artifacts/types.d.ts

@@ -0,0 +1,21 @@
+export type Checksum = {
+    algorithm: 'sha256' | 'sha1' | 'sha512';
+    value: string;
+};
+export type Artifact = {
+    name: string;
+    url: string;
+    version: string;
+    sha256?: string;
+    checksum?: Checksum;
+    source: 'paper' | 'modrinth' | 'github';
+    build?: number;
+};
+export type HttpClient = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export type DiscoveryOptions = {
+    fetch?: HttpClient;
+    cacheDir?: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/artifacts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,SAAS,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAExF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/dist/artifacts/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifacts/types.ts"],"names":[],"mappings":""}

package/dist/artifacts.d.ts

@@ -0,0 +1,2 @@
+export * from './artifacts/index.js';
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/artifacts.js

@@ -0,0 +1,2 @@
+export * from './artifacts/index.js';
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../src/artifacts.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}