/** * @author Marzavec ( https://github.com/marzavec ) * @summary Give da boot * @version 1.0.0 * @description Silently forces target client(s) into another channel * @module kick */ import { isModerator, getUserDetails, } from '../utility/_UAC.js'; import { Errors, } from '../utility/_Constants.js'; import { findUsers, } from '../utility/_Channels.js'; /** * Executes when invoked by a remote client * @param {Object} env - Environment 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') { if (typeof payload.nick !== 'object' && !Array.isArray(payload.nick)) { return true; } } payload.channel = socket.channel; // eslint-disable-line no-param-reassign } else if (typeof payload.userid !== 'number') { if (typeof payload.userid !== 'object' && !Array.isArray(payload.userid)) { return true; } } // find target user(s) const badClients = findUsers(server, payload); if (badClients.length === 0) { return server.reply({ cmd: 'warn', text: 'Could not find user(s) in that channel', id: Errors.Global.UNKNOWN_USER, channel: socket.channel, // @todo Multichannel }, socket); } // check if found targets are kickable, add them to the list if they are const kicked = []; for (let i = 0, j = badClients.length; i < j; i += 1) { if (badClients[i].level >= socket.level) { server.reply({ cmd: 'warn', text: 'Cannot kick other users with the same level, how rude', id: Errors.Global.PERMISSION, channel: socket.channel, // @todo Multichannel }, socket); } else { kicked.push(badClients[i]); } } if (kicked.length === 0) { return true; } let destChannel; if (typeof payload.to === 'string' && !!payload.to.trim()) { destChannel = payload.to; } else { destChannel = Math.random().toString(36).substr(2, 8); } // Announce the kicked clients arrival in destChannel and that they were kicked // Before they arrive, so they don't see they got moved for (let i = 0; i < kicked.length; i += 1) { server.broadcast({ ...getUserDetails(kicked[i]), ...{ cmd: 'onlineAdd', channel: destChannel, // @todo Multichannel }, }, { channel: destChannel }); } // Move all kicked clients to the new channel for (let i = 0; i < kicked.length; i += 1) { // @todo Multichannel kicked[i].channel = destChannel; server.broadcast({ cmd: 'info', // @todo Add numeric info code as `id` text: `${kicked[i].nick} was banished to ?${destChannel}`, channel: socket.channel, // @todo Multichannel }, { channel: socket.channel, level: isModerator }); console.log(`${socket.nick} [${socket.trip}] kicked ${kicked[i].nick} in ${socket.channel} to ${destChannel} `); } // broadcast client leave event for (let i = 0, j = kicked.length; i < j; i += 1) { server.broadcast({ cmd: 'onlineRemove', userid: kicked[i].userid, nick: kicked[i].nick, channel: socket.channel, // @todo Multichannel }, { channel: socket.channel }); } // publicly broadcast kick event server.broadcast({ cmd: 'info', // @todo Add numeric info code as `id` text: `Kicked ${kicked.map((k) => k.nick).join(', ')}`, channel: socket.channel, // @todo Multichannel }, { channel: socket.channel, level: (level) => isModerator(level) }); // stats are fun core.stats.increment('users-kicked', kicked.length); return true; } /** * Module meta information * @public * @typedef {Object} kick/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: 'kick', category: 'moderators', description: 'Silently forces target client(s) into another channel. `nick` may be string or array of strings', usage: ` API: { cmd: 'kick', nick: '', to: '' }`, };