/** * Modlog * Pokemon Showdown - http://pokemonshowdown.com/ * * Interface for viewing and searching modlog. These run in a * subprocess. * * Also handles searching battle logs. * * Actually writing to modlog is handled in chat.js, rooms.js, and * roomlogs.js * * @license MIT */ 'use strict'; const FS = require('./../lib/fs'); const path = require('path'); const Dashycode = require('../lib/dashycode'); const execFileSync = require('child_process').execFileSync; const MAX_PROCESSES = 1; const MAX_QUERY_LENGTH = 2500; const DEFAULT_RESULTS_LENGTH = 100; const MORE_BUTTON_INCREMENTS = [200, 400, 800, 1600, 3200]; const LINES_SEPARATOR = 'lines='; const MAX_RESULTS_LENGTH = MORE_BUTTON_INCREMENTS[MORE_BUTTON_INCREMENTS.length - 1]; const LOG_PATH = 'logs/modlog/'; class SortedLimitedLengthList { constructor(maxSize) { this.maxSize = maxSize; this.list = []; } getListClone() { return this.list.slice(); } tryInsert(element) { let insertedAt = -1; for (let i = this.list.length - 1; i >= 0; i--) { if (element.localeCompare(this.list[i]) < 0) { insertedAt = i + 1; if (i === this.list.length - 1) { this.list.push(element); break; } this.list.splice(i + 1, 0, element); break; } } if (insertedAt < 0) this.list.splice(0, 0, element); if (this.list.length > this.maxSize) { this.list.pop(); if (insertedAt === this.list.length) return false; } return true; } } /********************************************************* * Modlog Functions *********************************************************/ function checkRipgrepAvailability() { if (Config.ripgrepmodlog === undefined) { try { execFileSync('rg', ['--version'], {cwd: path.normalize(`${__dirname}/../`)}); Config.ripgrepmodlog = true; } catch (error) { Config.ripgrepmodlog = false; } } return Config.ripgrepmodlog; } function getMoreButton(room, search, useExactSearch, lines, maxLines) { let newLines = 0; for (let increase of MORE_BUTTON_INCREMENTS) { if (increase > lines) { newLines = increase; break; } } if (!newLines || lines < maxLines) { return ''; // don't show a button if no more pre-set increments are valid or if the amount of results is already below the max } else { if (useExactSearch) search = Chat.escapeHTML(`"${search}"`); return `
`; } } async function runModlog(roomidList, searchString, exactSearch, maxLines) { const useRipgrep = checkRipgrepAvailability() && searchString; let fileNameList = []; let checkAllRooms = false; for (const roomid of roomidList) { if (roomid === 'all') { checkAllRooms = true; const fileList = await FS(LOG_PATH).readdir(); for (const file of fileList) { if (file !== 'README.md' && file !== 'modlog_global.txt') fileNameList.push(file); } } else { fileNameList.push(`modlog_${roomid}.txt`); } } fileNameList = fileNameList.map(filename => `${LOG_PATH}${filename}`); // Ensure regexString can never be greater than or equal to the value of // RegExpMacroAssembler::kMaxRegister in v8 (currently 1 << 16 - 1) given a // searchString with max length MAX_QUERY_LENGTH. Otherwise, the modlog // child process will crash when attempting to execute any RegExp // constructed with it (i.e. when not configured to use ripgrep). let regexString; if (!searchString) { regexString = '.'; } else if (exactSearch) { regexString = searchString.replace(/[\\.+*?()|[\]{}^$]/g, '\\$&'); } else { searchString = toId(searchString); regexString = `[^a-zA-Z0-9]${searchString.split('').join('[^a-zA-Z0-9]*')}([^a-zA-Z0-9]|\\z)`; } let results = new SortedLimitedLengthList(maxLines); if (useRipgrep) { // the entire directory is searched by default, no need to list every file manually if (checkAllRooms) fileNameList = [LOG_PATH]; runRipgrepModlog(fileNameList, regexString, results); } else { const searchStringRegex = searchString ? new RegExp(regexString, 'i') : null; for (const fileName of fileNameList) { await checkRoomModlog(fileName, searchStringRegex, results); } } const resultData = results.getListClone(); return resultData; } async function checkRoomModlog(path, regex, results) { const fileStream = await FS(path).createReadStream(); let line; while ((line = await fileStream.readLine()) !== null) { if (!regex || regex.test(line)) { const insertionSuccessful = results.tryInsert(line); if (!insertionSuccessful) break; } } fileStream.destroy(); return results; } function runRipgrepModlog(paths, regexString, results) { let stdout; try { stdout = execFileSync('rg', ['-i', '-e', regexString, '--no-filename', '--no-line-number', ...paths, '-g', '!modlog_global.txt'], {cwd: path.normalize(`${__dirname}/../`)}); } catch (error) { return results; } for (const fileName of stdout.toString().split('\n').reverse()) { if (fileName) results.tryInsert(fileName); } return results; } function prettifyResults(resultArray, room, searchString, exactSearch, addModlogLinks, hideIps, maxLines) { if (resultArray === null) { return "The modlog query has crashed."; } let roomName; switch (room) { case 'all': roomName = "all rooms"; break; case 'public': roomName = "all public rooms"; break; default: roomName = `room ${room}`; } if (!resultArray.length) { return `|popup|No moderator actions containing ${searchString} found on ${roomName}.` + (exactSearch ? "" : " Add quotes to the search parameter to search for a phrase, rather than a user."); } const title = `[${room}]` + (searchString ? ` ${searchString}` : ``); let lines = resultArray.length; let curDate = ''; resultArray.unshift(''); const resultString = resultArray.map(line => { let time; let bracketIndex; if (line) { if (hideIps) line = line.replace(/[([][0-9]+\.[0-9]+\.[0-9]+\.[0-9]+[)\]]/g, ''); bracketIndex = line.indexOf(']'); if (bracketIndex < 0) return Chat.escapeHTML(line); time = new Date(line.slice(1, bracketIndex)); } else { time = new Date(); } let [date, timestamp] = Chat.toTimestamp(time, {human: true}).split(' '); if (date !== curDate) { curDate = date; date = `

[${date}]
`; } else { date = ``; } if (!line) { return `${date}[${timestamp}] \u2190 current server time`; } let parenIndex = line.indexOf(')'); let thisRoomID = line.slice(bracketIndex + 3, parenIndex); if (addModlogLinks) { let url = Config.modloglink(time, thisRoomID); if (url) timestamp = `${timestamp}`; } return `${date}[${timestamp}] (${thisRoomID})${Chat.escapeHTML(line.slice(parenIndex + 1))}`; }).join(`
`); let preamble; const modlogid = room + (searchString ? '-' + Dashycode.encode(searchString) : ''); if (searchString) { const searchStringDescription = (exactSearch ? `containing the string "${searchString}"` : `matching the username "${searchString}"`); preamble = `>view-modlog-${modlogid}\n|init|html\n|title|[Modlog]${title}\n|pagehtml|

The last ${Chat.count(lines, "logged actions")} ${searchStringDescription} on ${roomName}.` + (exactSearch ? "" : " Add quotes to the search parameter to search for a phrase, rather than a user."); } else { preamble = `>view-modlog-${modlogid}\n|init|html\n|title|[Modlog]${title}\n|pagehtml|

The last ${Chat.count(lines, "lines")} of the Moderator Log of ${roomName}.`; } let moreButton = getMoreButton(room, searchString, exactSearch, lines, maxLines); return `${preamble}${resultString}${moreButton}

`; } function getModlog(connection, roomid = 'global', searchString = '', maxLines = 20, timed = false) { const startTime = Date.now(); const targetRoom = Rooms.search(roomid); const user = connection.user; // permission checking if (roomid === 'all' || roomid === 'public') { if (!user.can('modlog')) { return connection.popup("Access denied"); } } else { if (!user.can('modlog', null, targetRoom) && !user.can('modlog')) { return connection.popup("Access denied"); } } const hideIps = !user.can('lock'); const addModlogLinks = Config.modloglink && (user.group !== ' ' || (targetRoom && targetRoom.isPrivate !== true)); if (searchString.length > MAX_QUERY_LENGTH) { connection.popup(`Your search query must be shorter than ${MAX_QUERY_LENGTH} characters.`); return; } let exactSearch = false; if (searchString.match(/^["'].+["']$/)) { exactSearch = true; searchString = searchString.substring(1, searchString.length - 1); } let roomidList; // handle this here so the child process doesn't have to load rooms data if (roomid === 'public') { const isPublicRoom = (room => !(room.isPrivate || room.battle || room.isPersonal || room.id === 'global')); roomidList = Array.from(Rooms.rooms.values()).filter(isPublicRoom).map(room => room.id); } else { roomidList = [roomid]; } PM.query({cmd: 'modlog', roomidList, searchString, exactSearch, maxLines}).then(response => { connection.send(prettifyResults(response, roomid, searchString, exactSearch, addModlogLinks, hideIps, maxLines)); if (timed) connection.popup(`The modlog query took ${Date.now() - startTime} ms to complete.`); }); } /********************************************************* * Battle Search Functions *********************************************************/ async function runBattleSearch(userid, turnLimit, month, tierid, date) { const useRipgrep = checkRipgrepAvailability(); let path = `logs/${month}/${tierid}/${date}`; let results = { totalBattles: 0, totalWins: 0, totalLosses: 0, totalTies: 0, }; let files = []; try { files = await FS(path).readdir(); } catch (err) { if (err.code === 'ENOENT') { results.notFound = true; return results; } throw err; } if (useRipgrep) { // Matches non-word (including _ which counts as a word) characters between letters/numbers // in a user's name so the userid can case-insensitively be matched to the name. const regexString = `("p1":"${userid.split('').join('[^a-zA-Z0-9]*')}[^a-zA-Z0-9]*"|"p2":"${userid.split('').join('[^a-zA-Z0-9]*')}[^a-zA-Z0-9]*")`; let stdout; try { stdout = execFileSync('rg', ['-i', regexString, '--no-filename', '--no-line-number', '-tjson', path]); } catch (error) { return results; } for (const file of stdout.toString().split('\n').reverse()) { if (!file) continue; let data = JSON.parse(file); if (data.turns > turnLimit) continue; results.totalBattles++; if (toId(data.winner) === userid) { results.totalWins++; } else if (data.winner) { results.totalLosses++; } else { results.totalTies++; } const foe = toId(data.p1) === userid ? toId(data.p2) : toId(data.p1); if (!results[foe]) results[foe] = 0; results[foe]++; } return results; } for (const file of files) { const json = await FS(`${path}/${file}`).readIfExists(); const data = JSON.parse(json); if (toId(data.p1) !== userid && toId(data.p2) !== userid) continue; if (data.turns > turnLimit) continue; results.totalBattles++; if (toId(data.winner) === userid) { results.totalWins++; } else if (data.winner) { results.totalLosses++; } else { results.totalTies++; } const foe = toId(data.p1) === userid ? toId(data.p2) : toId(data.p1); if (!results[foe]) results[foe] = 0; results[foe]++; } return results; } function buildResults(data, userid, turnLimit, month, tierid, date) { let buf = `>view-battlesearch-${userid}-${turnLimit}-${month}-${tierid}-${date}-confirm\n|init|html\n|title|[Battle Search][${userid}][${tierid}][${date}]\n`; buf += `|pagehtml|

${tierid} battles on ${date} where ${userid} was a player and the battle lasted less than ${turnLimit} turn${Chat.plural(turnLimit)}:

`; buf += ``; buf += ``; buf += ``; for (let foe in data) { if (['totalBattles', 'totalWins', 'totalLosses', 'totalTies'].includes(foe)) continue; buf += ``; } buf += `

${userid}'s ${tierid} Battles

CategoryNumber
Total Battles${data.totalBattles}
Total Wins${data.totalWins}
Total Losses${data.totalLosses}
Total Ties${data.totalTies}
OpponentTimes Battled
${foe}${data[foe]}
`; return buf; } function getBattleSearch(connection, userid, turnLimit = 1, month, tierid, date) { const user = connection.user; if (!user.can('forcewin')) return connection.popup(`/battlesearch - Access Denied`); PM.query({cmd: 'battlesearch', userid, turnLimit, month, tierid, date}).then(response => { connection.send(buildResults(response, userid, turnLimit, month, tierid, date)); }); } exports.pages = { modlog(args, user, connection) { if (!user.named) return Rooms.RETRY_AFTER_LOGIN; const roomid = args[0]; const target = Dashycode.decode(args.slice(1).join('-')); getModlog(connection, roomid, target); }, battlesearch(args, user, connection) { if (!user.named) return Rooms.RETRY_AFTER_LOGIN; if (!user.can('forcewin')) return `|title|[Battle Search]\n|pagehtml|
/battlesearch - Access Denied.
`; let userid = toId(args.shift()); let turnLimit = parseInt(args.shift()); if (!userid || !turnLimit || turnLimit < 1) return user.popup(`Some arguments are missing or invalid for battlesearch. Use /battlesearch to start over.`); let title = `|title|[Battle Search][${userid}]`; let buf = `\n|pagehtml|

Battle Search

Userid: ${userid}

Maximum Turns: ${turnLimit}

`; let months = FS('logs/').readdirSync(); months = months.filter(f => f.length === 7 && f.includes('-')).sort((aKey, bKey) => { const a = aKey.split('-').map(parseInt); const b = bKey.split('-').map(parseInt); if (a[0] === b[0]) { if (a[1] > b[1]) return -1; return 1; } if (a[0] > b[0]) return -1; return 1; }); let month = args.shift(); if (!month) { buf += `

Please select a month:

`; } else { month = month += `-${args.shift()}`; if (!months.includes(month)) return title + buf + `Invalid month selected.
`; buf += `

`; } let tierid = toId(args.shift()); const tiers = FS(`logs/${month}/`).readdirSync(); if (!tierid) { buf += `

Please select the tier to search:

`; } else { if (!tiers.includes(tierid)) return title + buf + `Invalid tier selected. `; title += `[${tierid}]`; buf += `

`; } let date = args.shift(); const days = FS(`logs/${month}/${tierid}/`).readdirSync(); if (!date) { buf += `

Please select the date to search:

`; } else { date = date += `-${args.shift()}-${args.shift()}`; if (!days.includes(date)) return title + buf + `Invalid date selected. `; title += `[${date}]`; buf += `

`; } if (args[0] !== 'confirm') { buf += `

Are you sure you want to run a battle search for for ${tierid} battles on ${date} where ${userid} was a player and the battle lasted less than ${turnLimit} turn${Chat.plural(turnLimit)}?

`; buf += `

`; return title + buf + ``; } // Run search getBattleSearch(connection, userid, turnLimit, month, tierid, date); return title + `\n|pagehtml|

Battle Search

Searching for ${tierid} battles on ${date} where ${userid} was a player and the battle lasted less than ${turnLimit} turn${Chat.plural(turnLimit)}.

Loading... (this will take a while)

`; }, }; exports.commands = { '!modlog': true, ml: 'modlog', timedmodlog: 'modlog', modlog: function (target, room, user, connection, cmd) { if (!room) room = Rooms('global'); let roomid = (room.id === 'staff' ? 'global' : room.id); if (target.includes(',')) { let targets = target.split(','); target = targets[1].trim(); roomid = toId(targets[0]) || room.id; } let targetRoom = Rooms.search(roomid); // if a room alias was used, replace alias with actual id if (targetRoom) roomid = targetRoom.id; if (roomid.includes('-')) return this.errorReply(`Battles and groupchats (and other rooms with - in their ID) don't have individual modlogs.`); let lines; if (target.includes(LINES_SEPARATOR)) { // undocumented line specification const reqIndex = target.indexOf(LINES_SEPARATOR); const requestedLines = parseInt(target.substr(reqIndex + LINES_SEPARATOR.length, target.length)); if (isNaN(requestedLines) || requestedLines < 1) { this.errorReply(`${LINES_SEPARATOR}${requestedLines} is not a valid line count.`); return; } lines = requestedLines; target = target.substr(0, reqIndex).trim(); // strip search out } if (!target && !lines) { lines = 20; } if (!lines) lines = DEFAULT_RESULTS_LENGTH; if (lines > MAX_RESULTS_LENGTH) lines = MAX_RESULTS_LENGTH; getModlog(connection, roomid, target, lines, cmd === 'timedmodlog'); }, modloghelp: [ `/modlog OR /ml [roomid], [search] - Searches the moderator log - defaults to the current room unless specified otherwise.`, `If you set [roomid] as [all], it searches for [search] on all rooms' moderator logs.`, `If you set [roomid] as [public], it searches for [search] in all public rooms' moderator logs, excluding battles. Requires: % @ * # & ~`, ], battlesearch: function (target, room, user, connection) { if (!target.trim()) return this.parse('/help battlesearch'); if (!this.can('forcewin')) return; let [userid, turnLimit] = target.split(',').map(toId); if (!userid) return this.parse('/help battlesearch'); if (!turnLimit) { turnLimit = 1; } else { turnLimit = parseInt(turnLimit); if (isNaN(turnLimit) || turnLimit < 1) return this.errorReply(`The turn limit should be a number that is greater than 0.`); } // Selection on month, tier, and date will be handled in the HTML room return this.parse(`/join view-battlesearch-${userid}-${turnLimit}`); }, battlesearchhelp: ['/battlesearch [user], (turn limit) - Searches a users rated battle history and returns information on battles that ended in less than (turn limit or 1) turns. Requires &, ~'], }; /********************************************************* * Process manager *********************************************************/ const QueryProcessManager = require('./../lib/process-manager').QueryProcessManager; const PM = new QueryProcessManager(module, async data => { switch (data.cmd) { case 'modlog': const {roomidList, searchString, exactSearch, maxLines} = data; try { return await runModlog(roomidList, searchString, exactSearch, maxLines); } catch (err) { require('../lib/crashlogger')(err, 'A modlog query', { roomidList, searchString, exactSearch, maxLines, }); } break; case 'battlesearch': const {userid, turnLimit, month, tierid, date} = data; try { return await runBattleSearch(userid, turnLimit, month, tierid, date); } catch (err) { require('../lib/crashlogger')(err, 'A battle search query', { userid, turnLimit, month, tierid, date, }); } break; } return null; }); if (!PM.isParentProcess) { // This is a child process! global.Config = require('../config/config'); process.on('uncaughtException', err => { if (Config.crashguard) { require('../lib/crashlogger')(err, 'A modlog child process'); } }); global.Dex = require('../sim/dex'); global.toId = Dex.getId; require('../lib/repl').start('modlog', cmd => eval(cmd)); } else { PM.spawn(MAX_PROCESSES); } exports.PM = PM;