#!/usr/bin/env node "use strict"; // what the security audit of 2026-10-16 found true of this server, checked on // every push so that it stays true (or is changed on purpose): // // - it uses no npm packages, so there is no supply chain to break into // - the server code starts no other programs and runs no generated code // - the server code names no web address outside .github/allowed-hosts.json // - no private key, certificate key or .env file is committed // - every JavaScript file parses // // a check that fails says what to do. run it from the repository's root: // // node .github/scripts/invariants.js const fs = require("fs"); const path = require("path"); const {execFileSync} = require("child_process"); const tracked = execFileSync("git", ["ls-files", "-z"], {encoding: "utf8"}).split("\0").filter(Boolean); const problems = []; const fail = (file, message) => problems.push({file, message}); // no npm packages const pkg = JSON.parse(fs.readFileSync("package.json", "utf8")); for (const field of ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies", "bundledDependencies"]) { if (pkg[field] && Object.keys(pkg[field]).length) { fail("package.json", `${field} is not empty. The server has no npm packages on purpose; if one is really needed, change this check in the same pull request and say why.`); } } for (const lock of ["package-lock.json", "yarn.lock", "pnpm-lock.yaml"]) { if (tracked.includes(lock)) { fail(lock, "a lockfile means npm packages; see package.json above."); } } // the server's own code: what the game server runs const serverCode = tracked.filter(file => /^(server|config)\.js$/.test(file) || /^lib\/.*\.js$/.test(file)); const FORBIDDEN = [ [/require\(\s*["'](?:node:)?child_process["']\s*\)/, "starts other programs (child_process)"], [/require\(\s*["'](?:node:)?vm["']\s*\)/, "runs generated code (vm)"], [/(? /^(server\.js|config\.js|lib\/.*\.(js|json)|public\/.*\.(html|js))$/.test(name))) { for (const [, host] of fs.readFileSync(file, "utf8").matchAll(HOST)) { const name = host.toLowerCase(); if (!allowed.server.includes(name)) { fail(file, `names ${name}, which is not in .github/allowed-hosts.json ("server"). Add it there if it is meant.`); } } } // keys and secrets for (const file of tracked) { const base = path.basename(file); if (/\.(pem|key|p12|pfx)$/i.test(base) || /^\.env(\..*)?$/.test(base) || /^id_(rsa|ed25519|ecdsa)$/.test(base)) { fail(file, "looks like a key or a secrets file. Remove it from the repository (and from its history), and replace the key."); } } // every JavaScript file parses for (const file of tracked.filter(name => /\.(c|m)?js$/.test(name) && !name.startsWith("tools/decompiled/"))) { try { execFileSync(process.execPath, ["--check", file], {stdio: "pipe"}); } catch (err) { fail(file, `does not parse: ${String(err.stderr).trim().split("\n").slice(0, 4).join(" ")}`); } } if (problems.length) { for (const {file, message} of problems) { console.log(`::error file=${file}::${file} ${message}`); } process.exit(1); } console.log(`${serverCode.length} server files and ${tracked.length} tracked files checked: no packages, no program starts or generated code, no unlisted hosts, no keys, everything parses`);