/** * @author Marzavec ( https://github.com/marzavec ) * @summary Ban a user * @version 1.0.0 * @description Bans target user by name * @module ban */ import { isModerator, getUserDetails, levels, } from '../utility/_UAC.js'; import { Errors, } from '../utility/_Constants.js'; import { findUser, } from '../utility/_Channels.js'; /** * Executes when invoked by a remote client * @param {Object} env - Enviroment object with references to core, server, socket & payload * @public * @return {void} */ export async function run({ core, server, socket, payload, }) { // increase rate limit chance and ignore if not admin or mod if (!isModerator(socket.level)) { return server.police.frisk(socket, 10); } // check user input if (socket.hcProtocol === 1) { if (typeof payload.nick !== 'string') { return false; } payload.channel = socket.channel; // eslint-disable-line no-param-reassign } else if (typeof payload.userid !== 'number') { return false; } // find target user const targetUser = findUser(server, payload); if (!targetUser) { return server.reply({ cmd: 'warn', text: 'Could not find user in that channel', id: Errors.Global.UNKNOWN_USER, channel: socket.channel, // @todo Multichannel }, socket); } const targetNick = targetUser.nick; // i guess banning mods or admins isn't the best idea? if (targetUser.level >= socket.level) { return server.reply({ cmd: 'warn', text: 'Cannot ban other users of the same level, how rude', id: Errors.Global.PERMISSION, channel: socket.channel, // @todo Multichannel }, socket); } // commit arrest record server.police.arrest(targetUser.address, targetUser.hash); console.log(`${socket.nick} [${socket.trip}] banned ${targetNick} in ${socket.channel}`); // notify normal users server.broadcast({ cmd: 'info', text: `Banned ${targetNick}`, user: getUserDetails(targetUser), channel: socket.channel, // @todo Multichannel }, { channel: socket.channel, level: (level) => level < levels.moderator }); // notify mods server.broadcast({ cmd: 'info', text: `${socket.nick}#${socket.trip} banned ${targetNick} in ${payload.channel}, userhash: ${targetUser.hash}`, channel: socket.channel, // @todo Multichannel inChannel: payload.channel, user: getUserDetails(targetUser), banner: getUserDetails(socket), }, { level: isModerator }); // force connection closed targetUser.terminate(); // stats are fun core.stats.increment('users-banned'); return true; } /** * Module meta information * @public * @typedef {Object} ban/info * @property {string} name - Module command name * @property {string} category - Module category name * @property {string} description - Information about module * @property {string} usage - Information about module usage */ export const info = { name: 'ban', category: 'moderators', description: 'Bans target user by name', usage: ` API: { cmd: 'ban', nick: '' }`, };