"use strict"; const crypto = require("crypto"); const {execFileSync} = require("child_process"); const fs = require("fs"); const path = require("path"); const accounts = require("./accounts.js"); const admin = require("./admin.js"); const bans = require("./bans.js"); const captcha = require("./captcha.js"); const chatlog = require("./chatlog.js"); const config = require("../config.js"); const customItems = require("./customitems.js"); const itemControl = require("./itemcontrol.js"); const itemArt = require("./itemart.js"); const playerItems = require("./playeritems.js"); const defpacks = require("./defpacks.js"); const devices = require("./devices.js"); const discordLinks = require("./discord.js"); const limits = require("./limits.js"); const manage = require("./manage.js"); const masterpieces = require("./masterpieces.js"); const modlog = require("./modlog.js"); const modNotes = require("./modnotes.js"); const reports = require("./reports.js"); const roles = require("./roles.js"); const staff = require("./staff.js"); const stats = require("./stats.js"); const sfs = require("./sfs.js"); const support = require("./support.js"); const totp = require("./totp.js"); const world = require("./world.js"); // the moderator panel at /mod: what a moderator needs to look after the // players, and no more. it is apart from the admin panel (lib/panel.js), // which stays whoever runs the server's alone. // // A moderator is a game account the admin gave a staff role (lib/roles.js: // helper, moderator or admin; `moderator` on an older account counts as a // moderator), and what they may do here is what their role allows. they sign in here with that account's username and password and // a code from their authenticator app, every time: an account without 2FA // cannot sign in at all, and a trusted device is not taken for a code. // being a moderator gives the account nothing in the game itself. // // what it does not give: sign-in histories, the server's log, what an // account owns, passwords, renaming, deleting, gifts. a moderator may look // up which players signed in from an address they already have (a search // written down under their name, below), but is shown no others; an // address can be banned through its player (the one they last signed in // from) and shows here with its end left out. another moderator cannot be // acted on. // everything done here is written down (lib/modlog.js) under the // moderator's name, for the admin panel. const COOKIE = "ajc_mod"; const DISCORD_COOKIE = "ajc_mod_discord"; const SESSION_HOURS = 12; const TEN_MINUTES_MS = 600000; const MAX_BAN_HOURS = 24 * 365 * 10; const MAX_MESSAGE_LENGTH = 200; const MAX_RECENT_NOTES = 15; const RECENT_PAINTINGS = 12; const GIT_STATUS_CACHE_MS = 10000; const PROJECT_ROOT = path.resolve(__dirname, ".."); const failuresByAddress = limits.limiter(config.failedLoginsPerTenMinutes, TEN_MINUTES_MS); const actionsPerTenMinutes = limits.limiter(300, TEN_MINUTES_MS); // per moderator const sessions = new Map(); // SHA-256 of a session token -> {id: account id, expiry: ms} const addressSearched = new Map(); // moderator's account id -> the address they last searched for const sha256 = text => crypto.createHash("sha256").update(text).digest("hex"); // This is read-only and intentionally never fetches, pulls or pushes. It // gives staff a conspicuous reminder that the running checkout contains work // which has not made it to its tracked remote yet. let gitStatusCachedAt = 0; let gitStatusCached = null; const gitUpdateState = () => { if (gitStatusCached && Date.now() - gitStatusCachedAt < GIT_STATUS_CACHE_MS) { return gitStatusCached; } try { const runGit = args => execFileSync("git", args, {cwd: PROJECT_ROOT, encoding: "utf8", timeout: 1500, maxBuffer: 128 * 1024}).trim(); const raw = runGit(["status", "--porcelain=v1", "-z"]); const entries = raw ? raw.split("\0").filter(Boolean) : []; const changed = []; for (let index = 0; index < entries.length; index++) { const entry = entries[index]; const status = entry.slice(0, 2); changed.push({status: status.trim() || "?", path: entry.slice(3)}); // A rename/copy has another NUL-delimited source path. The destination // is the useful file to show in the warning. if (status[0] === "R" || status[0] === "C") { index++; } } let ahead = 0; let behind = 0; let remoteKnown = true; try { const [behindText, aheadText] = runGit(["rev-list", "--left-right", "--count", "@{upstream}...HEAD"]).split(/\s+/); behind = Number(behindText) || 0; ahead = Number(aheadText) || 0; } catch (_) { remoteKnown = false; } gitStatusCached = {available: true, changed, ahead, behind, remoteKnown, needsPublish: changed.length > 0 || ahead > 0}; } catch (err) { gitStatusCached = {available: false, changed: [], ahead: 0, behind: 0, remoteKnown: false, needsPublish: false, error: "Git status could not be read."}; } gitStatusCachedAt = Date.now(); return gitStatusCached; }; const cookieToken = req => { const match = new RegExp(`(?:^|;\\s*)${COOKIE}=([0-9a-f]{48})(?:;|$)`).exec(req.headers.cookie || ""); return match ? match[1] : null; }; const cookieHeader = (token, maxAgeSeconds) => `${COOKIE}=${token}; Path=/; HttpOnly; SameSite=Strict; Max-Age=${maxAgeSeconds}${config.secureCookies ? "; Secure" : ""}`; const discordCookie = (value, maxAgeSeconds) => `${DISCORD_COOKIE}=${value}; Path=/; HttpOnly; SameSite=Lax; Max-Age=${maxAgeSeconds}${config.secureCookies ? "; Secure" : ""}`; const beginSession = (account, res, address, detail = "") => { accounts.recordLogin(account, "mod", address); accounts.save(account); for (const [hash, session] of sessions) { if (session.expiry < Date.now()) { sessions.delete(hash); } } const token = crypto.randomBytes(24).toString("hex"); sessions.set(sha256(token), {id: account.id, expiry: Date.now() + SESSION_HOURS * 3600000}); res.setHeader("Set-Cookie", cookieHeader(token, SESSION_HOURS * 3600)); modlog.record(account.username, "signed in", "", detail); }; // may this account use the panel (still)? const mayModerate = account => Boolean(account && roles.isActiveStaff(account, world.moderation.banRemaining(account) !== 0)); const signedInAs = req => { const token = cookieToken(req); const session = token && sessions.get(sha256(token)); const account = session && session.expiry > Date.now() ? accounts.byId(session.id) : null; return mayModerate(account) ? account : null; }; // ends the account's sessions here: it is no longer a moderator, or its // password or name changed. const forget = account => { for (const [hash, session] of sessions) { if (session.id === account.id) { sessions.delete(hash); } } }; const playerRow = (account, playing) => { const ban = world.moderation.banOf(account); return { username: account.username, createdAt: account.createdAt, lastSeen: account.lastSeen || account.lastLogin || null, online: playing.has(account.username), room: playing.get(account.username) || null, banned: ban ? ban.seconds : 0, banReason: ban ? ban.reason : "", silenced: world.moderation.silenceRemaining(account), nameRejected: Boolean(account.nameRejected), moderator: Boolean(roles.roleOf(account)), role: roles.roleOf(account), warnings: (account.warnings || []).length, playtime: account.playtime, bio: account.bio, discord: account.discord, deviceBanned: devices.bannedId(account) !== 0, }; }; const playing = () => new Map(world.players().map(player => [player.username, player.room || "(between rooms)"])); // what the Players page's list can be narrowed to (lib/staff.js `keep`). const ONLY = { online: (account, online) => online.has(account.username), banned: account => world.moderation.banRemaining(account) !== 0 || devices.bannedId(account) !== 0, silenced: account => world.moderation.silenceRemaining(account) !== 0, staff: account => Boolean(roles.roleOf(account)), }; // by name (lib/staff.js says in what order), and `only` one of ONLY's. const findPlayers = (query, only) => { const online = playing(); const {found, total} = staff.findAccounts(query, Object.hasOwn(ONLY, only) ? ONLY[only] : undefined); return {players: found.map(account => playerRow(account, online)), total}; }; // one player: the row, what was done about their bans (without addresses), // their appeal, and the reports about them still waiting. const playerDetail = account => ({ ...playerRow(account, playing()), history: bans.historyOf(account).map(({at, action, seconds, reason, by}) => ({at, action, seconds, reason, by})), appeal: bans.appealOf(account), warningList: (account.warnings || []).slice(-20).reverse(), notes: modNotes.list(account), openReports: reports.list(false).filter(report => report.target.toLowerCase() === account.username.toLowerCase()).length, devicesKnown: devices.knownFor(account).ids, stoppedThisWeek: chatlog.notSentCount(account, 7), paintings: masterpieces.madeBy(account).length, // what they made in the Item Maker, with its pictures, for a report about one madeItems: playerItems.madeBy(account).map(entry => ({kind: entry.kind, id: entry.id, name: entry.name, artUrl: itemArt.urlOf(entry, "/mod/api/itemart"), artWaiting: Boolean(entry.artPending)})), picturesStopped: Boolean(account.artBlocked), pictureStrikes: account.artRefusals || 0, }); // an address with its end left out, and a name to lift its ban by. const maskedAddress = ban => ({ id: sha256(ban.key).slice(0, 16), address: ban.key.includes(":") ? `${ban.key.split(":").slice(0, 2).join(":")}:…` : `${ban.key.split(".").slice(0, 2).join(".")}.…`, reason: ban.reason, by: ban.by, createdAt: ban.createdAt, }); const wholeNumber = (value, min, max) => (Number.isInteger(value) && value >= min && value <= max ? value : null); // the permission (lib/roles.js) each action needs. an action that is not // here is refused (act), so that a new one cannot go unchecked. const ACTION_PERMISSIONS = { ban: "player.ban", banReason: "player.ban", unban: "player.ban", silence: "chat.silence", unsilence: "chat.silence", kick: "player.kick", message: "player.warn", warn: "player.warn", unwarn: "player.warn", rejectName: "player.names", acceptName: "player.names", clearBio: "player.names", clearWallPosts: "player.names", banAddress: "address.ban", // a computer's ban, as an address's, keeps out everyone who uses it banDevices: "address.ban", unbanDevices: "address.ban", summon: "player.summon", goto: "player.goto", note: "player.view", deleteNote: "player.view", }; // minutes as a person would say them: "1 hour", "1 day", "90 minutes". const silenceText = minutes => { const [count, unit] = minutes % 1440 === 0 ? [minutes / 1440, "day"] : minutes % 60 === 0 ? [minutes / 60, "hour"] : [minutes, "minute"]; return `${count} ${unit}${count === 1 ? "" : "s"}`; }; const act = (mod, target, body) => { const {actions, PERMANENT} = world.moderation; const name = target.username; const by = mod.username; if (target === mod) { return {error: "That is you."}; } if (!roles.outranks(mod, target)) { return {error: "Staff of your rank or above are for someone higher up to deal with."}; } const permission = Object.hasOwn(ACTION_PERMISSIONS, body.action) ? ACTION_PERMISSIONS[body.action] : null; if (!permission) { return {error: "Unknown action."}; } if (!roles.can(mod, permission)) { return {error: "Your role cannot do that."}; } switch (body.action) { case "ban": { const hours = wholeNumber(body.hours, 0, MAX_BAN_HOURS); if (hours === null) { return {error: "Hours as a whole number, or 0 for permanent."}; } actions.ban(target, hours === 0 ? PERMANENT : hours * 3600, body.reason, by); manage.forget(target); return {ok: hours === 0 ? `${name} is banned permanently.` : `${name} is banned for ${hours} hours.`, detail: `${hours || "permanent"} · ${target.banReason}`}; } case "banReason": return actions.banReason(target, body.reason, by) ? {ok: "Reason saved.", detail: target.banReason} : {error: `${name} is not banned.`}; case "unban": if (world.moderation.banRemaining(target) === 0) { return {error: `${name} is not banned.`}; } actions.unban(target, by); return {ok: `${name} is no longer banned.`}; // counted in hours here; the game's own notice counts minutes. case "silence": { const hours = wholeNumber(body.hours, 0, MAX_BAN_HOURS); if (hours === null) { return {error: "Hours as a whole number, or 0 for until lifted."}; } actions.silence(target, hours === 0 ? PERMANENT : hours * 3600); return {ok: hours === 0 ? `${name} cannot chat until it is lifted.` : `${name} cannot chat for ${hours} hours.`, detail: String(hours || "until lifted")}; } case "unsilence": actions.silence(target, 0); return {ok: `${name} can chat again.`}; case "kick": return actions.kick(target) ? {ok: `${name} was disconnected.`} : {error: `${name} is not online.`}; case "message": { const text = String(body.text || "").trim().slice(0, MAX_MESSAGE_LENGTH); if (!text) { return {error: "The message is empty."}; } return actions.message(target, text) ? {ok: `Shown to ${name}.`, detail: text} : {error: `${name} is not online.`}; } case "warn": { const reason = String(body.reason || "behavior"); const result = actions.warn(target, reason, by, body.note); if (!result) { return {error: reason === "custom" ? "A custom warning needs its words in the note: they are what the player is shown." : `A warning's reason: ${world.moderation.WARNINGS.join(", ")}.`}; } return {ok: `${name} warned (${reason}): warning ${result.count}.${result.online ? "" : " They are offline: they will see it when they next play."}` + (result.silencedMinutes ? ` That many warnings also silenced them for ${silenceText(result.silencedMinutes)}.` : ""), detail: `${reason}${body.note ? ` · ${String(body.note).slice(0, 200)}` : ""}`}; } case "unwarn": { const removed = actions.unwarn(target); return removed ? {ok: `Took back ${name}'s latest warning (${removed.reason}).`, detail: removed.reason} : {error: `${name} has no warnings.`}; } case "rejectName": if (target.nameRejected) { return {error: "Already rejected."}; } actions.rejectName(target, by); manage.forget(target); return {ok: `${name} is signed out and picks a new name at the next sign-in.`}; case "acceptName": if (!target.nameRejected) { return {error: "Not rejected."}; } actions.acceptName(target); return {ok: `${name} keeps the name.`}; case "clearBio": target.bio = ""; accounts.save(target); return {ok: "Bio cleared."}; case "clearWallPosts": { const {posts, replies, walls} = actions.clearWallPosts(target); if (!posts) { return {error: `${name} has no posts on any Jammer Wall.`}; } const text = `${posts} wall ${posts === 1 ? "post" : "posts"} by ${name} removed from ${walls} ${walls === 1 ? "wall" : "walls"}` + `${replies ? ` (with ${replies} ${replies === 1 ? "reply" : "replies"} to them)` : ""}.`; return {ok: text, detail: `${posts} posts, ${replies} replies, ${walls} walls`}; } // a note for the other staff (lib/modnotes.js); the player never sees it. case "note": { const result = modNotes.add(target, by, body.text); return result.error ? result : {ok: "Note added.", detail: result.note.text}; } case "deleteNote": { const result = modNotes.remove(target, body.id, by, roles.roleOf(mod) === "admin"); return result.error ? result : {ok: "Note removed.", detail: `${result.note.by}: ${result.note.text}`}; } // the address they last signed in from, for good. which address that // is, the moderator is not told. case "banAddress": { const last = target.logins.find(login => login.ok && login.address); if (!last) { return {error: "No address is known for them."}; } const result = staff.banAddress(last.address, body.reason, by); if (result.error) { return {error: result.error.startsWith("That is this machine") ? "Their address cannot be banned." : result.error}; } return {ok: "Their address is banned.", detail: result.ban.reason}; } // the moderator's own animal and the player's, in the game: both have // to be online, the moderator in a room. case "summon": { const result = world.staffMove(target.username, mod.username); return result.ok ? {ok: `${name} was brought to ${result.room}.`, detail: result.room} : {error: result.error}; } case "goto": { const result = world.staffMove(mod.username, target.username); return result.ok ? {ok: `You went to ${name} (${result.room}).`, detail: result.room} : {error: result.error}; } // every computer they signed in from lately (lib/devices.js). case "banDevices": return staff.banDevices(target, body.reason, by); case "unbanDevices": return staff.unbanDevicesOf(target, by); default: return {error: "Unknown action."}; } }; const PAGE_HEADERS = { "Cache-Control": "no-store", "X-Frame-Options": "DENY", "X-Content-Type-Options": "nosniff", "Referrer-Policy": "no-referrer", "Content-Security-Policy": captcha.policy("default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; connect-src 'self'; img-src 'self' data:; font-src 'self'; " + "form-action 'none'; frame-ancestors 'none'; base-uri 'none'"), }; // `from` is {address, key, local}; `web` is {send, readJson} from lib/http.js. const handle = async (req, res, url, from, web) => { for (const [name, value] of Object.entries(PAGE_HEADERS)) { res.setHeader(name, value); } const reply = (status, body) => web.send(res, status, body); const route = `${req.method} ${url.pathname.replace(/\/$/, "") || "/mod"}`; if (route === "GET /mod") { web.send(res, 200, captcha.withScriptVersion(await stats.withView(await fs.promises.readFile(path.join(config.publicDir, "mod.html")))), "text/html; charset=utf-8"); return; } // The nonce cookie is Lax only for Discord's cross-site return. The normal // staff-session cookie remains Strict and is issued after the callback. if (route === "GET /mod/discord/login") { if (!discordLinks.linking()) { res.writeHead(302, {Location: "/dashboard/staff?discord=off"}); res.end(); return; } const {url: to, nonce} = discordLinks.startStaff(); res.setHeader("Set-Cookie", discordCookie(nonce, 600)); res.writeHead(302, {Location: to}); res.end(); return; } if (route === "GET /mod/discord/callback") { const nonce = (new RegExp(`(?:^|;\\s*)${DISCORD_COOKIE}=([0-9a-f]{48})(?:;|$)`).exec(req.headers.cookie || "") || [])[1]; const result = url.searchParams.get("error") ? {error: "cancelled"} : await discordLinks.finishStaff(url.searchParams.get("state"), nonce, url.searchParams.get("code")); if (result.ok && !mayModerate(result.account)) { result.ok = false; result.error = "denied"; } if (result.ok) { beginSession(result.account, res, from.address, "through Discord"); console.log(`[mod] ${result.account.username} signed in with Discord from ${from.address}`); } const sessionCookie = res.getHeader("Set-Cookie"); res.setHeader("Set-Cookie", sessionCookie ? [sessionCookie, discordCookie("", 0)] : discordCookie("", 0)); res.writeHead(302, {Location: `/dashboard/staff?discord=${result.ok ? "ok" : result.error}`}); res.end(); return; } if (req.method === "POST" && !limits.originAllowed(req)) { reply(403, {error: "forbidden"}); return; } const body = req.method === "POST" ? await web.readJson(req) : {}; switch (route) { case "GET /mod/api/state": { const mod = signedInAs(req); reply(200, {signedIn: Boolean(mod), username: mod ? mod.username : "", discordLogin: discordLinks.linking()}); return; } // username, password and a code, all three every time. case "POST /mod/api/login": { if (!from.local && failuresByAddress.blocked(from.key)) { reply(429, {error: "Too many attempts. Try later."}); return; } const captchaProblem = await captcha.check({captcha: body.captcha}, from, "login"); if (captchaProblem) { reply(captchaProblem === "captcha_unavailable" ? 503 : 401, {error: captcha.MESSAGES[captchaProblem]}); return; } // looked up first: with AJ_REGISTER=1 authenticate() would make the account. const known = accounts.byName(String(body.username || "").trim()); const account = known && await accounts.authenticateAsync(known.username, body.password) === known ? known : null; // one answer for a wrong password and for an account that is no // moderator: who the moderators are is nobody's to find out here. if (!account || !roles.roleOf(account)) { failuresByAddress.record(from.key); if (known && !account) { accounts.recordLogin(known, "mod", from.address, false); accounts.save(known); } reply(401, {error: "Wrong username or password."}); return; } if (!totp.isOn(account)) { reply(403, {error: "Turn on 2FA on your account page first."}); return; } if (!mayModerate(account)) { reply(403, {error: "This account cannot sign in here now."}); return; } if (!totp.verify(account, String(body.code || ""))) { failuresByAddress.record(from.key); accounts.recordLogin(account, "mod", from.address, false); accounts.save(account); reply(401, {error: "Wrong code."}); return; } accounts.recordLogin(account, "mod", from.address); accounts.save(account); for (const [hash, session] of sessions) { if (session.expiry < Date.now()) { sessions.delete(hash); } } const token = crypto.randomBytes(24).toString("hex"); sessions.set(sha256(token), {id: account.id, expiry: Date.now() + SESSION_HOURS * 3600000}); res.setHeader("Set-Cookie", cookieHeader(token, SESSION_HOURS * 3600)); modlog.record(account.username, "signed in"); reply(200, {ok: true, username: account.username}); return; } // signed in through the game instead: a client the moderator is playing // in hands over the game's login token, so they need not type their // password and a code again. taken only for active staff with 2FA on // (so the game's own sign-in took a code), who are in the game now, and // asking from the address that game connected from: the token alone, // copied elsewhere, opens nothing. case "POST /mod/api/game-login": { if (!from.local && failuresByAddress.blocked(from.key)) { reply(429, {error: "Too many attempts. Try later."}); return; } const account = accounts.byToken(body.token); const session = account ? world.findOnline(account.username) : null; if (!account || !roles.roleOf(account)) { failuresByAddress.record(from.key); reply(401, {error: "Sign in with your password and code."}); return; } if (!totp.isOn(account)) { reply(403, {error: "Turn on 2FA on your account page first."}); return; } if (!mayModerate(account)) { reply(403, {error: "This account cannot sign in here now."}); return; } if (!session || limits.key(session.address) !== from.key) { reply(401, {error: "Be in the game on this computer, or sign in with your password and code."}); return; } accounts.recordLogin(account, "mod", from.address); accounts.save(account); for (const [hash, kept] of sessions) { if (kept.expiry < Date.now()) { sessions.delete(hash); } } const cookie = crypto.randomBytes(24).toString("hex"); sessions.set(sha256(cookie), {id: account.id, expiry: Date.now() + SESSION_HOURS * 3600000}); res.setHeader("Set-Cookie", cookieHeader(cookie, SESSION_HOURS * 3600)); modlog.record(account.username, "signed in", "", "through the game"); reply(200, {ok: true, username: account.username}); return; } case "POST /mod/api/logout": { const token = cookieToken(req); if (token) { sessions.delete(sha256(token)); } res.setHeader("Set-Cookie", cookieHeader("", 0)); reply(200, {ok: true}); return; } } const mod = signedInAs(req); if (!mod) { reply(401, {error: "Sign in first."}); return; } if (req.method === "POST" && !actionsPerTenMinutes.allow(mod.id)) { reply(429, {error: "Too many at once. Try later."}); return; } // what was done, under the moderator's name; then the answer. const done = (result, action, target = "", detail = "") => { if (result.ok) { modlog.record(mod.username, action, target, result.detail || detail); } reply(result.ok ? 200 : 400, result.ok ? {ok: result.ok} : {error: result.error}); }; // a route's permission (lib/roles.js), as act() checks an action's: a // role without it is refused here, whatever its page shows. const may = permission => { if (roles.can(mod, permission)) { return true; } reply(403, {error: "Your role cannot do that."}); return false; }; // why the moderator may not act on `account`, as act() refuses: not on // themselves, nor on staff of their rank or above. null when they may. const refusalFor = account => { if (!account || roles.outranks(mod, account)) { return null; } return {error: account === mod ? "That is you." : "Staff of your rank or above are for someone higher up to deal with."}; }; switch (route) { // who is signed in here, their role and what it allows: for a client to // show only the buttons that will work. case "GET /mod/api/me": reply(200, {username: mod.username, role: roles.roleOf(mod), permissions: roles.permissionsOf(mod)}); return; } // what players made that waits for approval (lib/playeritems.js) if (url.pathname === "/mod/api/review") { if (!roles.can(mod, "items.approve")) { reply(403, {error: "Your role does not allow that."}); return; } reviewRoutes(route.replace(" /mod/api/", " "), body, reply, done, mod.username, "/mod/api/itemart"); return; } // This deliberately precedes the broad /items branch. Moderators may // receive the narrow items.restrict permission without also being allowed // to make, delete, lock or take items. if (/^\/mod\/api\/items\/wear-rules\/?$/.test(url.pathname)) { if (!roles.can(mod, "items.restrict")) { reply(403, {error: "Your role does not allow that."}); return; } // Normalize the harmless trailing-slash spelling before dispatching it. itemRoutes(`${req.method} items/wear-rules`, url, body, reply, done, { username: mod.username, artBase: "/mod/api/itemart", mayTake: () => false, }); return; } // custom items (lib/customitems.js), for whoever may make them. if (url.pathname.startsWith("/mod/api/items")) { if (!roles.can(mod, "items.create")) { reply(403, {error: "Your role does not allow that."}); return; } itemRoutes(route.replace(" /mod/api/", " "), url, body, reply, done, { username: mod.username, artBase: "/mod/api/itemart", mayTake: target => target === mod || !roles.roleOf(target) || roles.outranks(mod, target), }); return; } // Service health is intentionally separate from player data: every staff // role may see it, including developers who have no player-view access. if (route === "GET /mod/api/server") { if (!roles.can(mod, "server.view")) { reply(403, {error: "Your role does not allow that."}); return; } const memory = process.memoryUsage(); const players = world.players(); const rooms = new Set(players.map(player => player.room).filter(Boolean)); reply(200, { uptimeSeconds: Math.floor(process.uptime()), players: players.length, rooms: rooms.size, memory: { rssMb: Math.round(memory.rss / 1048576), heapUsedMb: Math.round(memory.heapUsed / 1048576), heapTotalMb: Math.round(memory.heapTotal / 1048576), }, sockets: sfs.health(), update: gitUpdateState(), now: Date.now(), }); return; } // everything else shows players and what they did: not for a role that // only makes things. if (!roles.can(mod, "player.view")) { reply(403, {error: "Your role does not allow that."}); return; } switch (route) { case "GET /mod/api/overview": reply(200, {online: world.players().length, reports: reports.openCount(), requests: support.nameRequests(false).length + bans.openAppeals(), paintings: masterpieces.list(masterpieces.PENDING).length}); return; // other accounts the same person may have, and their story (lib/staff.js). case "GET /mod/api/alts": { const account = accounts.byName(url.searchParams.get("username") || ""); reply(account ? 200 : 404, account ? {alts: staff.altsOf(account), ids: devices.idsFor(account)} : {error: "No such player."}); return; } case "GET /mod/api/timeline": { const account = accounts.byName(url.searchParams.get("username") || ""); reply(account ? 200 : 404, account ? {events: staff.timelineOf(account)} : {error: "No such player."}); return; } // who the server's chat filter stopped most this week. case "GET /mod/api/filterhits": reply(200, {players: chatlog.mostStopped(7, 50)}); return; case "GET /mod/api/players": { const searchBy = url.searchParams.get("by"); if (searchBy === "device") { const found = staff.byDevice(url.searchParams.get("q")); if (found.error) { reply(400, found); return; } const online = playing(); reply(200, {players: found.players.map(entry => ({...playerRow(accounts.byName(entry.username), online), matchedAt: entry.lastAt}))}); return; } if (searchBy !== "address") { reply(200, findPlayers(url.searchParams.get("q"), url.searchParams.get("only"))); return; } // by address: only the address typed, which is written down (once // for each address, though the page asks again every few seconds). // for the roles that ban addresses (lib/roles.js), not every staff member. if (!roles.can(mod, "address.ban")) { reply(403, {error: "Your role cannot do that."}); return; } const query = String(url.searchParams.get("q") || "").trim().toLowerCase(); const found = staff.byAddress(query); if (found.error) { reply(400, found); return; } if (addressSearched.get(mod.id) !== query) { addressSearched.set(mod.id, query); modlog.record(mod.username, "searched by address", "", `${query} · ${found.players.length} found`); } const online = playing(); reply(200, {players: found.players.map(entry => ({...playerRow(accounts.byName(entry.username), online), matchedAt: entry.lastAt}))}); return; } // the latest mod notes on anybody (lib/modnotes.js), for the dashboard. case "GET /mod/api/notes": reply(200, {notes: modNotes.recent(MAX_RECENT_NOTES)}); return; case "GET /mod/api/stats": reply(200, stats.report(Number(url.searchParams.get("days")), Number(url.searchParams.get("offset")))); return; case "GET /mod/api/player": { const account = accounts.byName(url.searchParams.get("username") || ""); reply(account ? 200 : 404, account ? playerDetail(account) : {error: "No such player."}); return; } case "POST /mod/api/act": { const target = accounts.byName(String(body.username || "")); if (!target) { reply(404, {error: "No such player."}); return; } done(act(mod, target, body), String(body.action), target.username); return; } // what players typed (lib/chatlog.js): a page of lines, or the lines // around one of them. case "GET /mod/api/chat": { const params = url.searchParams; const lines = chatlog.search({username: (params.get("username") || "").trim().slice(0, 100), room: (params.get("room") || "").trim().slice(0, 100), text: (params.get("text") || "").trim().slice(0, 100), kind: params.get("kind") || "", direction: params.get("direction") || "", until: Number(params.get("until")) || 0, before: Number(params.get("before")) || 0}); reply(200, {lines, more: lines.length === chatlog.PAGE, days: config.chatLogDays}); return; } case "GET /mod/api/chat/around": { const found = chatlog.around(url.searchParams.get("id")); reply(found ? 200 : 404, found || {error: "No such line."}); return; } case "GET /mod/api/reports": reply(200, {reports: reports.list(url.searchParams.get("handled") === "1"), open: reports.openCount()}); return; // a report dealt with: for the roles that act on players (a warning is // the least of it), not for one that only looks. case "POST /mod/api/report": if (!may("player.warn")) { return; } done(reports.markHandled(Number(body.id)) ? {ok: "Marked as dealt with."} : {error: "No such report waiting."}, "report dealt with", "", `#${Number(body.id)}`); return; // requests for another username, and ban appeals. case "GET /mod/api/requests": { const handled = url.searchParams.get("handled") === "1"; reply(200, {names: support.nameRequests(handled), appeals: staff.appealsFor(handled).map(({addressKey, address, ...appeal}) => ({...appeal, ofAddress: Boolean(address)}))}); return; } case "POST /mod/api/request": { if (body.action === "appealApprove" || body.action === "appealDeny") { // a ban decision: for the roles that ban, and one that also lifts the // ban on an address only for those that ban addresses. const appeal = bans.waitingAppeal(body.id); const liftsAddress = body.action === "appealApprove" && appeal && appeal.addressKey && bans.addressBan(appeal.addressKey); if (!may("player.ban") || (liftsAddress && !may("address.ban"))) { return; } const refusal = appeal ? refusalFor(accounts.byId(appeal.accountId)) : null; if (refusal) { done(refusal); return; } const result = staff.answerAppeal(body.id, body.action === "appealApprove", body.reply, mod.username); done(result, body.action === "appealApprove" ? "appeal approved" : "appeal denied", result.username, bans.clean(body.reply, bans.MAX_REPLY)); } else if (body.action === "approve" || body.action === "deny") { // a new name: for the roles that judge names. if (!may("player.names")) { return; } const request = support.nameRequestById(body.id); const refusal = request ? refusalFor(accounts.byId(request.accountId)) : null; if (refusal) { done(refusal); return; } const result = staff.answerNameRequest(body.id, body.action === "approve"); done(result, body.action === "approve" ? "name request approved" : "name request denied", result.username); } else { reply(400, {error: "Unknown action."}); } return; } case "GET /mod/api/bans": reply(200, {accounts: staff.disciplined(), addresses: bans.addressBans().map(maskedAddress), devices: devices.list(), alerts: devices.alerts()}); return; case "POST /mod/api/address": { if (!roles.can(mod, "address.ban")) { reply(403, {error: "Your role cannot do that."}); return; } const ban = bans.addressBans().find(entry => sha256(entry.key).slice(0, 16) === String(body.id)); done(ban && bans.unbanAddress(ban.key, mod.username) ? {ok: "No longer banned."} : {error: "Not banned."}, "address unbanned", "", ban ? ban.reason : ""); return; } // A device ban lifted (lib/devices.js): for the roles that give them // (act's unbanDevices), and not one made with staff of their rank or above. case "POST /mod/api/device": { if (!may("address.ban")) { return; } const ban = devices.banById(body.id); const refusal = ban ? refusalFor(accounts.byId(ban.accountId)) : null; if (refusal) { done(refusal); return; } const result = staff.unbanDevices(body.id, mod.username); done(result, "hardware ban lifted", result.username || ""); return; } // paintings players framed (lib/masterpieces.js), and the ones approved // last, to take one back that should not have been (mine=1: only the // ones this moderator approved). case "GET /mod/api/masterpieces": reply(200, {...masterpieces.listsFor(url.searchParams.get("creator")), waitingCount: masterpieces.list(masterpieces.PENDING).length, recent: masterpieces.recentlyApproved(RECENT_PAINTINGS, url.searchParams.get("mine") === "1" ? mod.username : "")}); return; case "GET /mod/api/masterpiece": { const picture = masterpieces.image(url.searchParams.get("id") || ""); if (!picture) { reply(404, {error: "No such painting."}); return; } res.setHeader("Cache-Control", "private, max-age=3600"); web.send(res, 200, picture, "image/jpeg"); return; } // a painting judged: for the roles that judge what players make, and // never their own or one by staff of their rank or above. case "POST /mod/api/masterpiece": { if (!may("items.approve")) { return; } const id = String(body.id || ""); const maker = masterpieces.creatorOf(id); const refusal = refusalFor(maker); if (refusal) { done(refusal); return; } const result = body.action === "approve" ? (world.approveMasterpiece(id, mod.username) ? {ok: "Approved."} : {error: "No such painting waiting."}) : body.action === "reject" || body.action === "remove" ? (world.removeMasterpiece(id) ? {ok: "Removed for good. Its maker was told and given a Masterpiece Token."} : {error: "No such painting."}) : {error: "Unknown action."}; done(result, `painting ${body.action === "approve" ? "approved" : "removed"}`, maker ? maker.username : "", id); return; } default: reply(404, {error: "not_found"}); } }; // the custom items' pages, for the moderator panel (/mod/api/...) and the // admin panel (/admin/api/..., lib/panel.js): `route` is without that // ("GET items"), and `actor` is {username, mayTake(account)}: who it is // written down as, and whether they may take items from that player. // GET items: the custom items, the newest first. // GET items/find?q=WORDS&kind=all|clothing|den: any item (the game's or a // custom one), by name or id, as the item finder finds it, each marked // whether it is locked out of the finder: for the dashboards' lock. // GET items/base?kind=clothing|den&id=N: an item of the game's to // make one from (its name and colours), to check before making it. // GET items/wear-rules?q=WORDS: clothing search results, animal choices and // current per-animal wear blocks. POST it with {id, blockedTypes} to set. // POST items {action: "create", kind, base, name, cost, members, colors} // or {action: "update", kind, id, and any of name, cost, members, colors, inShop} // or {action: "lock" | "unlock", kind, id}: kept out of the item finder // or {action: "take", username, kind, id}: every one of it, from one player // or {action: "delete", kind, id}: a custom item, out of the game and every inventory. const itemRoutes = (route, url, body, reply, done, actor) => { switch (route) { case "GET items/wear-rules": { const search = new URLSearchParams({kind: "clothing", q: url.searchParams.get("q") || ""}); const found = admin.search(search, null, true); const rules = itemControl.wearRuleList(); const blockedByItem = new Map(rules.map(rule => [rule.id, rule.blockedTypes])); reply(200, {animals: itemControl.wearAnimals(), rules, total: found.total, results: found.results.slice(0, 20).map(entry => ({id: entry.id, name: entry.locked ? entry.name.replace(/ \(locked\)$/, "") : entry.name, custom: entry.id >= customItems.FIRST_ID, blockedTypes: blockedByItem.get(entry.id) || []}))}); return; } case "POST items/wear-rules": { const result = itemControl.setWearRule(body.id, body.blockedTypes, world); done(result, result.ok ? "item wear rule changed" : "", "", `clothing ${body.id}`); return; } case "GET items": reply(200, {items: customItems.list().map(entry => ({...entry, baseName: customItems.baseName(entry), locked: itemControl.isLocked(entry.kind, entry.id), artUrl: itemArt.urlOf(entry, actor.artBase)})), firstId: customItems.FIRST_ID, locked: itemControl.lockedList()}); return; case "GET items/find": { const found = admin.search(url.searchParams, null, true); reply(200, {total: found.total, results: found.results.slice(0, 20).map(entry => ({ kind: entry.kind, id: entry.id, cost: entry.cost, name: entry.locked ? entry.name.replace(/ \(locked\)$/, "") : entry.name, locked: Boolean(entry.locked), custom: entry.id >= customItems.FIRST_ID, })), lockedCount: itemControl.lockedList().length}); return; } case "GET items/base": { const kind = url.searchParams.get("kind") === "den" ? "den" : "clothing"; const id = Number(url.searchParams.get("id")); const def = kind === "den" ? defpacks.denItemDef(id) : defpacks.itemDef(id); if (!def || id >= customItems.FIRST_ID || (kind === "clothing" && def.type !== "1")) { reply(404, {error: `No ${kind === "den" ? "den item" : "clothing"} with that id.`}); return; } reply(200, kind === "den" ? {kind, id, name: defpacks.string(def.nameStrId) || def.abbrName, art: def.abbrName, cost: Number(def.cost)} : {kind, id, name: defpacks.string(def.titleStrId), art: Number(def.layerDefId), cost: Number(def.value), colors: String(def.colors).split(",").map(Number)}); return; } case "POST items": { const kind = String(body.kind || ""); if (body.action === "lock" || body.action === "unlock") { const result = itemControl.setLocked(kind, body.id, body.action === "lock"); done(result, result.ok ? `item ${body.action}ed` : "", "", `${kind} ${body.id}`); return; } if (body.action === "take") { const target = accounts.byName(String(body.username || "").trim()); if (target && !actor.mayTake(target)) { done({error: "Staff of your rank or above are for someone higher up to deal with."}); return; } const result = itemControl.take(String(body.username || "").trim(), kind, body.id, world); done(result, result.ok ? "item taken" : "", target ? target.username : "", `${kind} ${body.id}${result.count ? ` x${result.count}` : ""}`); return; } if (body.action === "look") { const result = customItems.setArtMode(kind, body.id, String(body.look)); done(result.error ? result : {ok: `${result.item.name} is worn as ${body.look === "texture" ? "a texture" : "a sticker"}.`}, "item look changed", "", `${kind} ${body.id} ${body.look}`); return; } if (body.action === "delete") { const result = itemControl.deleteCustom(kind, body.id, world); done(result, result.ok ? "item deleted" : "", "", `${kind} ${body.id}`); return; } const result = body.action === "update" ? customItems.update(kind, body.id, body) : body.action === "create" ? customItems.create(kind, body, actor.username) : {error: "Unknown action."}; if (result.error) { done(result); return; } const {item} = result; done({ok: `${item.name} (${item.kind === "den" ? "den item" : "clothing"} ${item.id}) ${body.action === "update" ? "changed" : "made"}.`}, body.action === "update" ? "item changed" : "item made", "", `${item.kind} ${item.id} ${item.name}`); return; } default: reply(404, {error: "not_found"}); } }; // GET review: what waits, the oldest first; POST review {kind, id, approve: true | false}. // for the moderator panel and the admin panel (lib/panel.js) alike. // POST review {action: "takePicture", kind, id}: a picture off an item, // counted against its maker; {action: "uploads", username, blocked}: // stops, or lets again, one player's picture uploads. // `artBase`: the panel's /…/api/itemart, where pictures that wait are shown. const reviewRoutes = (route, body, reply, done, by, artBase) => { if (route === "GET review") { reply(200, { waiting: customItems.waiting().map(entry => { const maker = entry.ownerId === null ? null : accounts.byId(entry.ownerId); return {kind: entry.kind, id: entry.id, name: entry.name, baseName: customItems.baseName(entry), base: entry.base, maker: maker ? maker.username : entry.createdBy, createdAt: entry.createdAt, waiting: entry.pending ? "item" : "picture", artUrl: itemArt.urlOf(entry, artBase), makerStrikes: maker ? maker.artRefusals || 0 : 0}; }), enabled: playerItems.enabled(), approval: playerItems.approvalOn(), artApproval: playerItems.artApprovalOn(), strikes: playerItems.ART_STRIKES, stopped: accounts.all().filter(account => account.artBlocked).map(account => account.username).sort(), }); return; } if (route === "POST review" && body.action === "takePicture") { const kind = String(body.kind || ""); const entry = customItems.get(kind, body.id); const maker = entry && entry.ownerId !== null ? accounts.byId(entry.ownerId) : null; const result = playerItems.takePicture(kind, body.id); done(result, result.ok ? "item picture taken off" : "", maker ? maker.username : "", `${kind} ${body.id}`); return; } if (route === "POST review" && body.action === "uploads") { const target = accounts.byName(String(body.username || "").trim()); if (!target) { done({error: "No such player."}); return; } const result = playerItems.setUploadsBlocked(target, body.blocked === true); done(result, body.blocked === true ? "picture uploads stopped" : "picture uploads allowed", target.username); return; } if (route === "POST review") { const kind = String(body.kind || ""); const result = playerItems.review(kind, body.id, body.approve === true, by, world); done(result, result.ok ? (body.approve === true ? "item approved" : "item turned away") : "", "", `${kind} ${body.id}`); return; } reply(404, {error: "not_found"}); }; const moderators = () => accounts.all().filter(account => roles.roleOf(account)) .map(account => ({username: account.username, role: roles.roleOf(account), twoStep: totp.isOn(account), lastSeen: account.lastSeen || null})) .sort((a, b) => a.username.localeCompare(b.username)); module.exports = {handle, forget, moderators, signedInAs, itemRoutes, reviewRoutes};