Compare commits

..

No commits in common. "c325bf5ab4961c9ffbcba0ad5cb1558236820bf4" and "9d82f9dacbf930d3b273dca84e657a60eb269518" have entirely different histories.

8 changed files with 986 additions and 505 deletions

View File

@ -1,19 +1,18 @@
# WIP MODMAIL BOT # WIP MODMAIL BOT
**Still a work in progress, has no actual integration with the main bot at this point due to the main bot still being very much a work in progress.** **Still a work in progress, has no actual integration with the main bot at this point due to the main bot still being very much a work in progress.**
Uses json for storage. If this is a problem, feel free to start a branch and write your own cache handler, alternatively use another bot. Uses json for storage. If this is a problem, feel free to start a branch and write your own cache handler, alternatively use another bot.
Shouldn't require much setup, fill in the relevant fields in config.js, should be well commented. Shouldn't require much setup, fill in the relevant fields in config.js, should be well commented.
I've tried refactoring some of the original code that I wrote initially in haste, but a lot of it's still very questionable and in need of rewriting/refactoring. I've tried refactoring some of the original code that I wrote initially in haste, but a lot of it's still very questionable and in need of rewriting/refactoring.
Contributions welcome. Contributions welcome.
## Docker image ## Docker image
**Highly recommend making a named volume for the storage** **Highly recommend making a named volume for the storage**
> Create a named volume `docker volume create ModmailStorage` > Create a named volume `docker volume create ModmailStorage`
Make sure to have a config.js ready to go, see the example file for a template Make sure to have a config.js ready to go, see the example file for a template
> Start the container > Start the container
``` ```
docker run -d --name modmail \ docker run -d --name modmail \
-v /path/to/config.js:/modmail/config.js \ -v /path/to/config.js:/modmail/config.js \
@ -22,18 +21,18 @@ navydotgif/modmail:latest
``` ```
## How to use ## How to use
> Install [Node.js](https://nodejs.org/en/download/), at least v12, though I'd recommend at least 14 due to Discord.js requiring it in v13. > Install [Node.js](https://nodejs.org/en/download/), at least v12, though I'd recommend at least 14 due to Discord.js requiring it in v13.
> Run `git clone https://github.com/GalacticBot/modmail.git` > Run `git clone https://github.com/GalacticBot/modmail.git`
> Run `yarn install`, alternatively `npm install` if you don't have yarn for some reason. > Run `yarn install`, alternatively `npm install` if you don't have yarn for some reason.
> Rename `config.example.js` to `config.js`, open it and fill in the relevant values. The comments should explain what they are for. If something is unclear open an issue and I'll attempt to make it more clear. > Rename `config.example.js` to `config.js`, open it and fill in the relevant values. The comments should explain what they are for. If something is unclear open an issue and I'll attempt to make it more clear.
> At this point you'll probably notice you need to add 3 new categories. I'm planning on automating a part of the setup process, but for now this is how it be. Make those, add their IDs to the array. > At this point you'll probably notice you need to add 3 new categories. I'm planning on automating a part of the setup process, but for now this is how it be. Make those, add their IDs to the array.
> I'd recommend getting PM2 or whatever you prefer for process management. > I'd recommend getting PM2 or whatever you prefer for process management.
> Start up the bot and if you did everything right it should boot up and just work. If something goes wrong submit an issue, alternatively if you know how to fix it, issue a pull request. > Start up the bot and if you did everything right it should boot up and just work. If something goes wrong submit an issue, alternatively if you know how to fix it, issue a pull request.
## Commands ## Commands
@ -47,7 +46,7 @@ Both of these can be used with `!r` and `!cr` respectively and both of them supp
`!mmqueue` - Shows users in queue. `!mmqueue` - Shows users in queue.
`!id [channel]` - Get the target user ID for the modmail thread. Can be used without the channel argument in a modmail channel, outside of a modmail channel will return the user ID for the channel's target if available. `!id [channel]` - Get the target user ID for the modmail thread. Can be used without the channel argument in a modmail channel, outside of a modmail channel will return the user ID for the channel's target if available.
The bot has an `!eval` command which you can grant access to in the config file. The bot has an `!eval` command which you can grant access to in the config file.
**Creating canned/pre-written replies** **Creating canned/pre-written replies**
Simple as using `!cr create <name> <the reply content here>`. Updating an existing entry is done by overwriting it. Simple as using `!cr create <name> <the reply content here>`. Updating an existing entry is done by overwriting it.

View File

@ -1,26 +1,25 @@
{ {
"name": "modmail", "name": "modmail",
"version": "1.0.0", "version": "1.0.0",
"main": "index.js", "main": "index.js",
"author": "Navy <navydotgif@gmail.com>", "author": "Navy <navydotgif@gmail.com>",
"license": "MIT", "license": "MIT",
"private": false, "private": false,
"description": "Modmail bot with eventual integration with Galactic Bot's API", "description": "Modmail bot with eventual integration with Galactic Bot's API",
"scripts": { "scripts": {
"start": "node index.js", "start": "node index.js",
"dev": "nodemon --ignore *.json index.js", "dev": "nodemon --ignore *.json index.js"
"dockerpub": "tsc && docker build . --tag navydotgif/modmail:latest && docker push navydotgif/modmail:latest " },
}, "devDependencies": {
"devDependencies": { "eslint": "^7.28.0",
"eslint": "^7.28.0", "nodemon": "^2.0.7"
"nodemon": "^2.0.7" },
}, "dependencies": {
"dependencies": { "chalk": "^4.0.0",
"chalk": "^4.0.0", "diagnostics": "^2.0.2",
"diagnostics": "^2.0.2", "discord.js": "^12.5.3",
"discord.js": "^12.5.3", "moment": "^2.29.2",
"moment": "^2.29.4", "winston": "^3.3.3",
"winston": "^3.3.3", "winston-transport": "^4.4.0"
"winston-transport": "^4.4.0" }
} }
}

View File

@ -92,7 +92,7 @@ class ChannelHandler {
if (channel) await channel.edit({ parentID: state === 'read' ? this.readMail.id : this.newMail.id, lockPermissions: true }); if (channel) await channel.edit({ parentID: state === 'read' ? this.readMail.id : this.newMail.id, lockPermissions: true });
if (!this.cache.updatedThreads.includes(target)) this.cache.updatedThreads.push(target); if (!this.cache.updatedThreads.includes(target)) this.cache.updatedThreads.push(target);
if (this.cache.queue.includes(target) && state === 'read') this.cache.queue.splice(this.cache.queue.indexOf(target), 1); if (this.cache.queue.includes(target) && state === 'read') this.cache.queue.splice(this.cache.queue.indexOf(target), 1);
else if (!this.cache.queue.includes(target) && state === 'unread') this.cache.queue.push(target); else if (!this.cache.queue.includes(target)) this.cache.queue.push(target);
return {}; return {};
} }

View File

@ -102,11 +102,11 @@ class ModmailClient extends Client {
const roles = member.roles.cache.map((r) => r.id); const roles = member.roles.cache.map((r) => r.id);
if (!roles.some((r) => this._options.staffRoles.includes(r)) && !member.hasPermission('ADMINISTRATOR')) return; if (!roles.some((r) => this._options.staffRoles.includes(r)) && !member.hasPermission('ADMINISTRATOR')) return;
const [ rawCommand, ...args ] = content.split(/\s+/u); const [ rawCommand, ...args ] = content.split(' ');
const commandName = rawCommand.substring(prefix.length); const commandName = rawCommand.substring(prefix.length);
const command = this.registry.find(commandName); const command = this.registry.find(commandName);
if (!command) return; if (!command) return;
message._caller = commandName; message._caller = commandName.toLowerCase();
if (command.showUsage && !args.length) { if (command.showUsage && !args.length) {

View File

@ -362,6 +362,7 @@ class Modmail {
response = await this.channels.setReadState(userId, channel, author, state); response = await this.channels.setReadState(userId, channel, author, state);
} }
if (response.error) return response; if (response.error) return response;
this.log({ author, action: `${author.tag} marked ${user.tag}'s thread as ${state}`, target: user }); this.log({ author, action: `${author.tag} marked ${user.tag}'s thread as ${state}`, target: user });
return 'Done'; return 'Done';

View File

@ -1,89 +1,88 @@
const Command = require('../Command'); const Command = require('../Command');
class CannedReply extends Command { class CannedReply extends Command {
constructor (client) { constructor (client) {
super(client, { super(client, {
name: 'cannedreply', name: 'cannedreply',
aliases: [ 'cr', 'canned' ], aliases: [ 'cr', 'canned' ],
showUsage: true, showUsage: true,
usage: `<canned response name>` usage: `<canned response name>`
}); });
} }
async execute (message, { args }) { async execute (message, { args }) {
const [ first, second ] = args.map((a) => a); const [ first ] = args.map((a) => a);
// eslint-disable-next-line prefer-const // eslint-disable-next-line prefer-const
let { channel, content, _caller } = message, let { channel, content, _caller } = message,
anon = false; anon = false;
content = content.replace(`${this.client.prefix}${_caller}`, ''); content = content.replace(`${this.client.prefix}${_caller}`, '');
const op = args.shift().toLowerCase(); const op = args.shift().toLowerCase();
if (op === 'anon') { if (op === 'anon') {
anon = true; anon = true;
content = content.replace(first, ''); content = content.replace(first, '');
} else if ([ 'create', 'delete' ].includes(op)) { } else if ([ 'create', 'delete' ].includes(op)) {
return this.createCanned(op, args, message); return this.createCanned(op, args, message);
} else if ([ 'list' ].includes(first.toLowerCase())) { } else if ([ 'list' ].includes(first.toLowerCase())) {
const list = Object.entries(this.client.modmail.replies); const list = Object.entries(this.client.modmail.replies);
let str = ''; let str = '';
if (second?.toLowerCase() !== '-here') channel = await message.author.createDM(); // eslint-disable-next-line no-shadow
// eslint-disable-next-line no-shadow for (const [ name, content ] of list) {
for (const [ name, content ] of list) { const substr = `**${name}:** ${content}\n`;
const substr = `**${name}:** ${content}\n`; if (str.length + substr.length > 2000) {
if (str.length + substr.length > 2000) { await channel.send(str);
await channel.send(str); str = '';
str = ''; }
} str += substr;
str += substr; }
} if (str.length) return channel.send(str);
if (str.length) return channel.send(str); return '**__None__**';
return '**__None__**';
}
}
return this.client.modmail.sendCannedResponse({ message, responseName: content.trim(), anon });
return this.client.modmail.sendCannedResponse({ message, responseName: content.trim(), anon });
}
}
async createCanned (op, args, { channel, author }) {
async createCanned (op, args, { channel, author }) {
if (args.length < 1) return {
if (args.length < 1) return { error: true,
error: true, msg: 'Missing reply name'
msg: 'Missing reply name' };
}; const [ _name, ...rest ] = args;
const [ _name, ...rest ] = args;
const name = _name.toLowerCase();
const name = _name.toLowerCase(); const canned = this.client.modmail.replies;
const canned = this.client.modmail.replies; let confirmation = null;
let confirmation = null;
if (op === 'create') {
if (op === 'create') { if (!rest.length) return {
if (!rest.length) return { error: true,
error: true, msg: 'Missing content'
msg: 'Missing content' };
};
if (canned[name]) {
if (canned[name]) { confirmation = await this.client.prompt(`A canned reply by the name ${name} already exists, would you like to overwrite it?`, { channel, author });
confirmation = await this.client.prompt(`A canned reply by the name ${name} already exists, would you like to overwrite it?`, { channel, author }); if (!confirmation) return 'Timed out.';
if (!confirmation) return 'Timed out.'; confirmation = [ 'y', 'yes', 'ok' ].includes(confirmation.content.toLowerCase());
confirmation = [ 'y', 'yes', 'ok' ].includes(confirmation.content.toLowerCase()); if (!confirmation) return 'Cancelled';
if (!confirmation) return 'Cancelled'; }
}
canned[name] = rest.join(' ');
canned[name] = rest.join(' ');
} else {
} else { delete canned[name];
delete canned[name]; }
}
this.client.modmail.saveReplies();
this.client.modmail.saveReplies(); return `Updated ${_name}`;
return `Updated ${_name}`;
}
}
}
}
module.exports = CannedReply; module.exports = CannedReply;

View File

@ -1,51 +1,53 @@
const Command = require('../Command'); const Command = require('../Command');
class Modmail extends Command { class Modmail extends Command {
constructor (client) { constructor (client) {
super(client, { super(client, {
name: 'modmail', name: 'modmail',
aliases: [ 'mm' ], aliases: [ 'mm' ],
showUsage: true, showUsage: true,
usage: `<user> <content>` usage: `<user> <content>`
}); });
} }
async execute (message, { args }) { async execute (message, { args }) {
// eslint-disable-next-line prefer-const
let [ first, second ] = args.map((a) => a); // eslint-disable-next-line prefer-const
// eslint-disable-next-line prefer-const let [ first, second ] = args.map((a) => a);
let { content, _caller } = message, // eslint-disable-next-line prefer-const
anon = false; let { content, _caller } = message,
content = content.replace(`${this.client.prefix}${_caller}`, ''); anon = false;
if (first.toLowerCase() === 'anon') { content = content.replace(`${this.client.prefix}${_caller}`, '');
anon = true; if (first.toLowerCase() === 'anon') {
content = content.replace(first, ''); anon = true;
first = second; content = content.replace(first, '');
} else if (second?.toLowerCase() === 'anon') { first = second;
anon = true; } else if (second?.toLowerCase() === 'anon') {
content = content.replace(second, ''); anon = true;
} content = content.replace(second, '');
}
const user = await this.client.resolveUser(first, true);
if (!user) return { const user = await this.client.resolveUser(first, true);
error: true, if (!user) return {
msg: 'Failed to resolve user' error: true,
}; msg: 'Failed to resolve user'
else if (user.bot) return { };
error: true, else if (user.bot) return {
msg: 'Cannot send modmail to a bot.' error: true,
}; msg: 'Cannot send modmail to a bot.'
content = content.replace(first, '').trim(); };
content = content.replace(first, '');
if (!content.length) return {
error: true, if (!content.length) return {
msg: `Cannot send empty message` error: true,
}; msg: `Cannot send empty message`
};
return this.client.modmail.sendModmail({ message, content, anon, target: user });
} return this.client.modmail.sendModmail({ message, content: content.trim(), anon, target: user });
} }
}
module.exports = Modmail; module.exports = Modmail;

1127
yarn.lock

File diff suppressed because it is too large Load Diff