updated api

.eslintrc.json

@@ -0,0 +1,56 @@
+{
+    "root": true,
+    "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended"
+    ],
+    "parser": "@typescript-eslint/parser",
+    "parserOptions": { "project": ["./tsconfig.eslint.json"] },
+    "plugins": [
+        "@typescript-eslint"
+    ],
+    "rules": {
+        "@typescript-eslint/strict-boolean-expressions": [
+            2,
+            {
+                "allowString" : false,
+                "allowNumber" : false
+            }
+        ],
+        
+        /* important */
+        "prefer-const": "error",
+        "quotes": ["error", "single"],
+
+        "block-scoped-var": "error",
+        "camelcase": "error",
+        "consistent-this": ["error", "that"],
+        "no-else-return": "error",
+        "no-eq-null": "error",
+        "no-floating-decimal": "error",
+        "no-implicit-coercion": "error",
+        "no-implied-eval": "error",
+        "no-invalid-this": "error",
+        "require-await": "error",
+        "yoda": "error",
+
+        "semi": ["error", "always"],
+        "semi-style": ["error", "last"],
+
+        /* less important */
+        "no-unreachable-loop": "error",
+        "no-unused-private-class-members": "error",
+        "no-use-before-define": "error",
+        "no-unmodified-loop-condition": "error",
+        "no-duplicate-imports": "error",
+        "no-promise-executor-return": "error",
+        "no-self-compare": "error",
+        "no-constructor-return": "error",
+        "no-template-curly-in-string": "error",
+        "array-callback-return": "error",
+        "no-eval": "error",
+        "no-extend-native": "error",
+        "no-extra-bind": "error"
+    },
+    "ignorePatterns": ["src/**/*.test.ts", "src/frontend/generated/*"]
+}

.gitignore

@@ -1,5 +1,6 @@
-node_modules
-token.txt
-queues.json
 .DS_Store
-log
+.vscode
+log
+node_modules
+queues.json
+token.txt

README.md

@@ -44,6 +44,8 @@ Download and install [Node.js](https://nodejs.org/en/)
 
 ## Starting
 
+**Important**: the bot's invite needs permission to `Create Commands` and `Send Messages`
+
 1. Open the `scripts` folder
 2. Open the folder that corresponds with your operating system
 3. Run the `start` file

dist/api.js

@@ -23,10 +23,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPlayerInteraction = exports.getPlayer = void 0;
+/*eslint prefer-const: "error"*/
 const cheerio = __importStar(require("cheerio"));
-const discord_js_1 = require("discord.js");
 const https_1 = __importDefault(require("https"));
-const util_1 = require("./util");
+const main_1 = require("./util/main");
+const Lang = __importStar(require("./lang"));
 const uniteApiRegex = {
     //$1 = name, $2 = id
     ogtitle: /unite api - (.+) \((.*)\)/i,
@@ -73,25 +74,25 @@ function getHTML(name) {
  * @throws errorMessage class if the request fails
  */
 function readHTML(html) {
-    let $ = cheerio.load(html);
+    const $ = cheerio.load(html), foundData = {
-    let metaElems = $('meta').toArray(), foundData = {
+        name: '',
-        name: "",
+        id: '',
-        id: "",
+        avatar: '',
-        avatar: "",
+        level: '',
-        level: "",
+        rank: '',
-        rank: "",
         elo: null,
         class: null,
-        battles: "",
+        battles: '',
-        wins: "",
+        wins: '',
-        winrate: ""
+        winrate: ''
     };
+    let metaElems = $('meta').toArray();
     //filter down to just ones named "og:..."
     metaElems = metaElems.filter(el => el.attribs.property?.startsWith('og:'));
     metaElems.forEach(el => {
-        let attr = el.attribs;
+        const attr = el.attribs;
         if (attr.property === 'og:title') {
-            let data = uniteApiRegex.ogtitle.exec(attr.content);
+            const data = uniteApiRegex.ogtitle.exec(attr.content);
             if (data !== null && data.length >= 3) {
                 foundData.name = data[1];
                 foundData.id = data[2];
@@ -99,15 +100,16 @@ function readHTML(html) {
         }
         else if (attr.property === 'og:description') {
             //all lines
-            let lines = attr.content.split('\n').map(l => l.trim()), extraLines = [];
+            let lines = attr.content.split('\n').map(l => l.trim());
+            const extraLines = [];
             //ensure first line is correct
-            while (lines.length && !/pok.mon unite/i.test(lines[0])) {
+            while ((lines.length > 0) && !/pok.mon unite/i.test(lines[0])) {
-                let line = lines.shift();
+                const line = lines.shift();
-                if (line)
+                if (line !== undefined)
                     extraLines.push(line);
             }
-            if (!lines.length)
+            if (lines.length === 0)
-                throw (0, util_1.emsg)('Unable to read data, please try again');
+                throw (0, main_1.emsg)('Unable to read data, please try again');
             //bring the first lines removed back into the data
             lines = [
                 ...lines,
@@ -116,20 +118,19 @@ function readHTML(html) {
             //first line
             {
                 //will be only text after "pokemon unite:"
-                let line = lines[0].split(':').slice(1).join(':').trim();
+                const line = lines[0].split(':').slice(1).join(':').trim(), regex = uniteApiRegex.ogdescription;
-                let regex = uniteApiRegex.ogdescription;
                 if (regex[0].test(line)) { //is master/has elo
-                    let regexData = line.match(regex[0]);
+                    const regexData = line.match(regex[0]);
                     if (!regexData || regexData.length < 4)
-                        throw (0, util_1.emsg)('Unable to read data, please try again');
+                        throw (0, main_1.emsg)('Unable to read data, please try again');
                     foundData.level = regexData[1];
                     foundData.rank = regexData[2];
                     foundData.elo = regexData[3];
                 }
                 else { //is not master/has a class
-                    let regexData = line.match(regex[1]);
+                    const regexData = line.match(regex[1]);
                     if (!regexData || regexData.length < 4)
-                        throw (0, util_1.emsg)('Unable to read data, please try again');
+                        throw (0, main_1.emsg)('Unable to read data, please try again');
                     foundData.level = regexData[1];
                     foundData.rank = regexData[2];
                     foundData.class = regexData[3];
@@ -138,7 +139,7 @@ function readHTML(html) {
             lines.shift();
             //rest of lines
             lines.forEach(line => {
-                let split = line.split(':').map(l => l.trim()), key = split[0].toLowerCase().replace(/[^\w]/g, ''), value = split[1];
+                const split = line.split(':').map(l => l.trim()), key = split[0].toLowerCase().replace(/[^\w]/g, ''), value = split[1];
                 switch (key) {
                     case 'battles':
                         foundData.battles = value;
@@ -153,7 +154,8 @@ function readHTML(html) {
             });
         }
     });
-    foundData.avatar = $('.player-card-image img').attr('src') || "";
+    const imgSrc = $('.player-card-image img').attr('src');
+    foundData.avatar = imgSrc !== undefined ? imgSrc : '';
     foundData.avatar = foundData.avatar.replace('../', 'https://uniteapi.dev/');
     return foundData;
 }
@@ -163,7 +165,7 @@ function readHTML(html) {
  * @returns boolean, valid or invalid
  */
 function verifyData(data) {
-    if (data.id.length)
+    if (data.id.length > 0)
         return true;
     return false;
 }
@@ -173,26 +175,30 @@ function verifyData(data) {
  * @returns player data
  */
 async function getPlayer(name) {
-    let html = await getHTML(name);
+    const html = await getHTML(name), data = readHTML(html);
-    let data = readHTML(html);
     if (verifyData(data))
         return data;
     return null;
 }
 exports.getPlayer = getPlayer;
 async function sendPlayerEmbed(interaction, data) {
-    let embed = new discord_js_1.MessageEmbed()
+    let eloStr;
-        .setTitle(`${data.name} (${data.id})`)
+    if (data.elo !== null)
-        .setURL(`https://uniteapi.dev/p/${encodeURIComponent(data.name)}`)
+        eloStr = `(${data.elo})`;
-        .setTimestamp()
+    else
-        .setThumbnail(data.avatar)
+        eloStr = `Class ${data.class}`;
-        .setDescription(`Level ${data.level}
+    await interaction.editReply(Lang.getEmbed('api.player', {
-${data.rank} ${data.elo ? `(${data.elo})` : `Class ${data.class}`}
+        name: data.name,
-
+        id: data.id,
-**Battles** ${data.battles}
+        nameEncoded: encodeURIComponent(data.name),
-**Wins** ${data.wins}
+        avatar: data.avatar,
-**Win Rate** ${data.winrate}`);
+        level: data.level,
-    await interaction.editReply({ embeds: [embed] });
+        rank: data.rank,
+        elo: eloStr,
+        battles: data.battles,
+        wins: data.wins,
+        winrate: data.winrate
+    }));
 }
 /**
  * calls getPlayer() with the name from the interaction
@@ -200,11 +206,11 @@ ${data.rank} ${data.elo ? `(${data.elo})` : `Class ${data.class}`}
  * @throws errorMessage class if the user cannot be found
  */
 async function getPlayerInteraction(interaction) {
-    let username = interaction.options.getString('username', true);
+    const username = interaction.options.getString('username', true);
     await interaction.deferReply();
-    let data = await getPlayer(username);
+    const data = await getPlayer(username);
     if (data === null)
-        throw (0, util_1.emsg)('Unable to find user');
+        throw (0, main_1.emsg)('api.noUser');
     else
         sendPlayerEmbed(interaction, data);
 }

dist/discord.js

@@ -1,22 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCommands = void 0;
+/* eslint-disable camelcase */
 const rest_1 = require("@discordjs/rest");
 const v9_1 = require("discord-api-types/v9");
 // list of commands to register with discord
 const commands = [
     {
-        name: 'queue',
+        name: 'open',
-        description: 'get queue info or initialize a queue for this channel',
+        description: 'open a queue for this channel',
         options: [
             {
                 type: 4,
                 name: 'teamsize',
                 description: 'size of each team',
-                min_value: 1
+                min_value: 1,
+                required: true
             }
         ]
     },
+    {
+        name: 'close',
+        description: 'close the queue for this channel'
+    },
+    {
+        name: 'queue',
+        description: 'view queue info'
+    },
     {
         name: 'join',
         description: 'join the active queue'
@@ -25,10 +35,6 @@ const commands = [
         name: 'leave',
         description: 'leave the active queue'
     },
-    {
-        name: 'stop',
-        description: 'stops the current queue (must have the Manage Messages permission)'
-    },
     {
         name: 'player',
         description: 'display player information',
@@ -42,6 +48,7 @@ const commands = [
         ]
     }
 ];
+/*commandNames = commands.map(c => c.name);*/
 /**
  * register/reload commands on guild(s)
  * @param token discord bot token
@@ -55,7 +62,6 @@ async function registerCommands(token, clientId, guildIds) {
     for (let i = 0; i < guildIds.length; i++) {
         try {
             await rest.put(v9_1.Routes.applicationGuildCommands(clientId, guildIds[i]), { body: commands });
-            console.log(`[${guildIds[i]}] registered command`);
         }
         catch (error) {
             console.error(error);

dist/lang.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEmbed = exports.get = exports.setLang = void 0;
+const lang_1 = require("./util/lang");
+const LANG = {
+    en: {
+        main: {
+            login: 'Logged in as {user}'
+        },
+        discord: {
+            botRestart: 'The bot has just restarted, anybody previously in the queue has been reset',
+            create: 'A queue for teams of {teamsize} has been created',
+            close: 'Queue has been closed',
+            join: 'Joined the queue',
+            leave: 'Left the queue',
+            team: {
+                embed: true,
+                title: 'Team',
+                description: '{team}'
+            },
+            queue: {
+                embed: true,
+                title: 'Active Queue',
+                fields: [
+                    {
+                        name: 'Team Size',
+                        value: '{teamsize}'
+                    },
+                    {
+                        name: 'Players Joined',
+                        value: '{playercount}'
+                    }
+                ],
+                footer: 'type `/join`'
+            }
+        },
+        api: {
+            player: {
+                embed: true,
+                title: '{name} ({id})',
+                url: 'https://uniteapi.dev/p/{nameEncoded}',
+                timestamp: true,
+                thumbnail: '{avatar}',
+                description: [
+                    'Level {level}',
+                    '{rank} {elo}',
+                    '',
+                    '**Battles** {battles}',
+                    '**Wins** {wins}',
+                    '**Win Rate** {winrate}'
+                ]
+            }
+        },
+        error: {
+            main: {
+                missingToken: 'Missing Discord Token, please enter the bot token into the token file'
+            },
+            discord: {
+                noQueue: 'There is not an active queue in this channel, type `/open` to create one',
+                noChannel: 'Unable to find channel {channelId} for teams of {teamsize}',
+                noCreate: 'There is already an active queue in this channel for teams of {teamsize}',
+                inQueue: 'You are already in the queue',
+                notInQueue: 'You aren\'t in the queue',
+                notMod: 'Member is not a moderator'
+            },
+            general: {
+                noMember: 'Unable to retrieve guild member information, please try again',
+                noChannel: 'Unable to retrieve text channel information, please try again'
+            },
+            api: {
+                noUser: 'Unable to find user'
+            }
+        }
+    }
+};
+/* MAIN */
+let LANGID = 'en';
+if (!(LANGID in LANG))
+    throw 'language id does not exist';
+function setLang(langid) {
+    if (langid in LANG)
+        LANGID = langid;
+    else
+        throw 'language id does not exist';
+}
+exports.setLang = setLang;
+/**
+ * reads language json (just strings)
+ * @param id ex: discord.error.noActiveQueue
+ * @param args list of key/value pairs to represent template values
+ * @returns language value, defaults to `id` parameter
+ */
+function get(id, args = {}) {
+    const keySpl = id.split('.').map(k => k.trim()).filter(k => k);
+    let finding = LANG[LANGID];
+    for (const key of keySpl) {
+        if (key in finding) {
+            const found = finding[key];
+            if (typeof found === 'string')
+                return (0, lang_1.template)(found, args);
+            if (found.embed === true)
+                return (0, lang_1.embedObjStr)(found, args, id);
+            finding = found;
+        }
+        else
+            break;
+    }
+    return id;
+}
+exports.get = get;
+/**
+ * reads language json as an object (could be embed or just string)
+ * @param id ex: discord.error.noActiveQueue
+ * @param args list of key/value pairs to represent template values
+ * @param otherOptions values to be passed through to the return value
+ * @returns language value, defaults to `id` parameter
+ */
+function getEmbed(id, args = {}, otherOptions = {}) {
+    const embedData = {
+        ...otherOptions,
+        embeds: []
+    };
+    const keySpl = id.split('.').map(k => k.trim()).filter(k => k);
+    let finding = LANG[LANGID];
+    for (const key of keySpl) {
+        if (key in finding) {
+            const found = finding[key];
+            if (typeof found === 'string') {
+                embedData.content = (0, lang_1.template)(found, args);
+                break;
+            }
+            if (found.embed === true) {
+                const embedObj = found, { content } = embedObj, embed = (0, lang_1.embedObjEmbed)(embedObj, args);
+                embedData.embeds.push(embed);
+                if (content !== undefined)
+                    embedData.content = content;
+                return embedData;
+            }
+            finding = found;
+        }
+        else
+            break;
+    }
+    return embedData;
+}
+exports.getEmbed = getEmbed;

dist/main.js

@@ -23,41 +23,60 @@ const discord_js_1 = require("discord.js");
 const fs = __importStar(require("fs"));
 const api_1 = require("./api");
 const discord_1 = require("./discord");
+const Lang = __importStar(require("./lang"));
 const queue_1 = require("./queue");
-const util_1 = require("./util");
+const main_1 = require("./util/main");
 const CLIENT = new discord_js_1.Client({ intents: [discord_js_1.Intents.FLAGS.GUILDS] });
 //init logs with a timestamp
 console.log(new Date().toISOString() + '\n\n');
 //get token
 if (!fs.existsSync('./token.txt')) {
     fs.writeFileSync('./token.txt', '');
-    console.error('Missing Discord Token, please enter the bot token into the token file');
+    console.error(Lang.get('error.main.missingToken'));
     process.exit(1);
 }
 const TOKEN = fs.readFileSync('./token.txt').toString();
 //discord connections
 CLIENT.on('ready', client => {
-    console.log(`Logged in as ${client.user.tag}`);
+    console.log(Lang.get('main.login', {
+        user: client.user.tag
+    }));
     client.guilds.fetch().then(guilds => (0, discord_1.registerCommands)(TOKEN, client.user.id, guilds.map(g => g.id)));
     (0, queue_1.discordInit)(client);
 });
+CLIENT.on('guildCreate', guild => {
+    if (guild.client.user)
+        (0, discord_1.registerCommands)(TOKEN, guild.client.user.id, guild.id);
+});
 CLIENT.on('interactionCreate', async (interaction) => {
     if (!interaction.isCommand())
         return;
     try {
-        if (interaction.commandName === 'queue')
+        switch (interaction.commandName) {
-            await queue_1.QueueCommands.queue(interaction);
+            //mod commands
-        else if (interaction.commandName === 'join')
+            case 'open':
-            await queue_1.QueueCommands.join(interaction);
+                await queue_1.QueueCommands.open(interaction);
-        else if (interaction.commandName === 'leave')
+                break;
-            await queue_1.QueueCommands.leave(interaction);
+            case 'close':
-        else if (interaction.commandName === 'stop')
+                await queue_1.QueueCommands.close(interaction);
-            await queue_1.QueueCommands.stop(interaction);
+                break;
-        else if (interaction.commandName === 'player')
+            //general commands
-            await (0, api_1.getPlayerInteraction)(interaction);
+            case 'queue':
+                await queue_1.QueueCommands.queue(interaction);
+                break;
+            case 'join':
+                await queue_1.QueueCommands.join(interaction);
+                break;
+            case 'leave':
+                await queue_1.QueueCommands.leave(interaction);
+                break;
+            case 'player':
+                await (0, api_1.getPlayerInteraction)(interaction);
+                break;
+        }
     }
     catch (e) {
-        if (e instanceof util_1.errorMessage) {
+        if (e instanceof main_1.errorMessage) {
             if (interaction.deferred || interaction.replied)
                 interaction.editReply(e.msg);
             else

dist/queue.js

@@ -23,196 +23,184 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueueCommands = exports.discordInit = void 0;
+exports.QueueCommands = exports.queueContains = exports.discordInit = exports.queueRemove = exports.queueCreate = void 0;
 const discord_js_1 = require("discord.js");
 const fs = __importStar(require("fs"));
-const util_1 = require("./util");
+const Lang = __importStar(require("./lang"));
-//load queues from file
+const discord_1 = require("./util/discord");
+const main_1 = require("./util/main");
+//load queues from file`
 if (!fs.existsSync('./queues.json'))
     fs.writeFileSync('./queues.json', '{}');
 const _QUEUE = fs.readFileSync('./queues.json').toString(), QUEUE = new Map();
 try {
-    let queueJson = JSON.parse(_QUEUE);
+    const queueJson = JSON.parse(_QUEUE);
-    for (let channelId of queueJson) {
+    for (const channelId in queueJson) {
-        let { teamsize } = queueJson[channelId];
+        const { teamsize } = queueJson[channelId];
-        if (teamsize)
+        if (teamsize !== 0)
             QUEUE.set(channelId, { teamsize, players: [] });
     }
 }
-catch (e) { }
+catch (e) {
+    //do nothing
+}
 function SaveQueue() {
-    let queueJson = Object.fromEntries(QUEUE), queueFileJson = {};
+    const queueJson = Object.fromEntries(QUEUE), queueFileJson = {};
-    for (let channelId in QUEUE.keys())
+    for (const channelId of QUEUE.keys())
         queueFileJson[channelId] = { teamsize: queueJson[channelId].teamsize };
     fs.writeFileSync('./queues.json', JSON.stringify(queueFileJson, null, 2));
 }
 async function checkQueue(channel) {
-    let info = QUEUE.get(channel.id);
+    const info = QUEUE.get(channel.id);
     if (!info)
         return;
-    if (info.players.length > info.teamsize) {
+    if (info.players.length >= info.teamsize) {
-        let team = info.players.splice(0, info.teamsize).map(m => m.toString());
+        const team = info.players.splice(0, info.teamsize).map(m => m.toString());
-        let embed = new discord_js_1.MessageEmbed()
+        await channel.send(Lang.getEmbed('discord.team', { team: team.join('\n') }));
-            .setTitle('Team')
-            .setDescription(team.join('\n'));
-        await channel.send({ embeds: [embed] });
     }
 }
-var Queue;
+function queueCreate(channelId, teamsize) {
-(function (Queue) {
+    if (!QUEUE.has(channelId)) {
-    function create(channelId, teamsize) {
+        QUEUE.set(channelId, { teamsize, players: [] });
-        if (!QUEUE.has(channelId)) {
+        SaveQueue();
-            QUEUE.set(channelId, { teamsize, players: [] });
-            SaveQueue();
-        }
     }
-    Queue.create = create;
+}
-    function remove(channelId) {
+exports.queueCreate = queueCreate;
-        if (QUEUE.has(channelId)) {
+function queueRemove(channelId) {
-            QUEUE.delete(channelId);
+    if (QUEUE.has(channelId)) {
-            SaveQueue();
+        QUEUE.delete(channelId);
-        }
+        SaveQueue();
     }
-    Queue.remove = remove;
+}
-    function addPlayer(channelId, member) {
+exports.queueRemove = queueRemove;
-        if (QUEUE.has(channelId)) {
-            QUEUE.delete(channelId);
-        }
-    }
-    Queue.addPlayer = addPlayer;
-    function removePlayer(channelId, member) {
-        if (QUEUE.has(channelId)) {
-            QUEUE.delete(channelId);
-        }
-    }
-    Queue.removePlayer = removePlayer;
-})(Queue || (Queue = {}));
 SaveQueue();
 async function discordInit(client) {
-    for (let channelId in QUEUE.keys()) {
+    for (const channelId of QUEUE.keys()) {
-        let info = QUEUE.get(channelId), channel = await client.channels.fetch(channelId);
+        const info = QUEUE.get(channelId), channel = await client.channels.fetch(channelId);
-        if (!info) { //no idea what could cause this but TS complains
+        if (!info) {
-            Queue.remove(channelId);
+            queueRemove(channelId);
             continue;
         }
         if (!channel || !(channel instanceof discord_js_1.TextChannel)) {
-            console.error(`Unable to find channel ${channelId} for teams of ${info?.teamsize}`);
+            console.error(Lang.get('error.discord.noChannel'), {
-            Queue.remove(channelId);
+                channelId,
+                teamsize: info.teamsize
+            });
+            queueRemove(channelId);
             continue;
         }
-        channel.send('The bot has just restarted and anybody in the queues have been reset');
+        channel.send(Lang.get('discord.botRestart'));
     }
 }
 exports.discordInit = discordInit;
-var QueueCommands;
+/**
-(function (QueueCommands) {
+ * get the queueInfo of an interaction
-    /**
+ * @param interaction
-     * get the queueInfo of an interaction
+ * @throws errorMessage class if it does not exist
-     * @param interaction
+ * @returns queue info
-     * @throws errorMessage class if it does not exist
+ */
-     * @returns queue info
+function getInfo(interaction) {
-     */
+    const info = QUEUE.get(interaction.channelId);
-    function getInfo(interaction) {
+    if (!info)
-        let info = QUEUE.get(interaction.channelId);
+        throw (0, main_1.emsg)('discord.noQueue');
-        if (!info)
+    return info;
-            throw (0, util_1.emsg)('There is not an active queue in this channel, type `/queue` to create one');
+}
-        return info;
+/**
-    }
+ * compiles all the get functions above
-    /**
+ * @param interaction
-     * compiles all the get functions above
+ * @throws if another get function throws
-     * @param interaction
+ * @returns object containing each
-     * @throws if another get function throws
+ */
-     * @returns object containing each
+const getAll = (interaction) => ({
-     */
+    member: (0, discord_1.getMember)(interaction),
-    const getAll = (interaction) => ({
+    channel: (0, discord_1.getChannel)(interaction),
-        member: (0, util_1.getMember)(interaction),
+    info: getInfo(interaction)
-        channel: (0, util_1.getChannel)(interaction),
+});
-        info: getInfo(interaction)
+/**
-    });
+ * checks if the interaction data is already in the queue
-    /**
+ * @param interaction
-     * checks if the interaction data is already in the queue
+ * @returns boolean
-     * @param interaction
+ */
-     * @returns boolean
+function queueContains(interaction) {
-     */
+    const { member, info } = getAll(interaction);
-    function queueContains(interaction) {
+    if (info.players.map(m => m.id).includes(member.id))
-        let { member, info } = getAll(interaction);
+        return true;
-        if (info.players.map(m => m.id).includes(member.id))
+    return false;
-            return true;
+}
-        return false;
+exports.queueContains = queueContains;
-    }
+/**
-    QueueCommands.queueContains = queueContains;
+ * opens a queue
-    /**
+ * @param interaction
-     * creates a queue from an interaction
+ * @throws errorMessage class if it cannot be left
-     * @param interaction
+ */
-     * @throws errorMessage class if it cannot be left
+function open(interaction) {
-     */
+    (0, discord_1.memberIsModThrow)(interaction);
-    function queueCreate(interaction) {
+    const { channelId } = interaction, teamsize = interaction.options.getInteger('teamsize', true);
-        (0, util_1.memberIsModThrow)(interaction);
+    const existing = QUEUE.get(channelId);
-        let { channelId } = interaction, teamsize = interaction.options.getInteger('teamsize', true);
+    if (existing)
-        if (QUEUE.has(channelId))
+        throw (0, main_1.emsg)(Lang.get('error.discord.noCreate', {
-            throw (0, util_1.emsg)(`There is already an active queue in this channel for teams of ${QUEUE.get(channelId)?.teamsize}`);
+            teamsize: existing.teamsize.toString()
-        Queue.create(channelId, teamsize);
+        }));
-        interaction.reply(`A queue for teams of ${teamsize} has been started`);
+    queueCreate(channelId, teamsize);
-    }
+    interaction.reply(Lang.get('discord.create', {
-    QueueCommands.queueCreate = queueCreate;
+        teamsize: teamsize.toString()
-    /**
+    }));
-     * creates a queue from an interaction
+}
-     * @param interaction
+/**
-     * @throws errorMessage class if it cannot be left
+ * closes a queue
-     */
+ * @param interaction
-    async function queue(interaction) {
+ * @throws errorMessage class if it cannot be joined
-        let teamsize = interaction.options.getInteger('teamsize');
+ */
-        if (teamsize) {
+async function close(interaction) {
-            queueCreate(interaction);
+    (0, discord_1.memberIsModThrow)(interaction);
-            return;
+    QUEUE.delete(interaction.channelId);
-        }
+    await interaction.reply(Lang.get('discord.close'));
-        let info = getInfo(interaction);
+}
-        let embed = new discord_js_1.MessageEmbed()
+/**
-            .setTitle('Active Queue')
+ * gives info about the queue
-            .addField('Team Size', info.teamsize.toString(), true)
+ * @param interaction
-            .addField('Players Joined', info.players.length.toString(), true)
+ * @throws errorMessage class if it cannot be left
-            .setFooter({ text: 'type /join' });
+ */
-        await interaction.reply({ embeds: [embed], ephemeral: true });
+async function queue(interaction) {
-    }
+    const info = getInfo(interaction);
-    QueueCommands.queue = queue;
+    await interaction.reply(Lang.getEmbed('discord.queue', {
-    /**
+        teamsize: info.teamsize.toString(),
-     * stops a queue from an interaction
+        playercount: info.players.length.toString(),
-     * @param interaction
+    }, {
-     * @throws errorMessage class if it cannot be joined
+        ephemeral: true
-     */
+    }));
-    async function stop(interaction) {
+}
-        (0, util_1.memberIsModThrow)(interaction);
+/**
-        QUEUE.delete(interaction.channelId);
+ * joins a queue
-        await interaction.reply('Queue has been reset');
+ * @param interaction
-    }
+ * @throws errorMessage class if it cannot be readied
-    QueueCommands.stop = stop;
+ */
-    /**
+async function join(interaction) {
-     * joins a queue from an interaction
+    const { member, info, channel } = getAll(interaction);
-     * @param interaction
+    if (queueContains(interaction))
-     * @throws errorMessage class if it cannot be readied
+        throw (0, main_1.emsg)('discord.inQueue');
-     */
+    info.players.push(member);
-    async function join(interaction) {
+    QUEUE.set(interaction.channelId, info);
-        let { member, info, channel } = getAll(interaction);
+    await interaction.reply(Lang.get('discord.join'));
-        if (queueContains(interaction))
+    checkQueue(channel);
-            throw (0, util_1.emsg)('You are already in the queue');
+}
-        info.players.push(member);
+/**
-        QUEUE.set(interaction.channelId, info);
+ * leaves a queue
-        await interaction.reply('Joined the queue');
+ * @param interaction
-        checkQueue(channel);
+ * @throws errorMessage class if it cannot be reset
-    }
+ */
-    QueueCommands.join = join;
+async function leave(interaction) {
-    /**
+    const { member, info } = getAll(interaction);
-     * leaves a queue from an interaction
+    if (!queueContains(interaction))
-     * @param interaction
+        throw (0, main_1.emsg)('discord.notInQueue');
-     * @throws errorMessage class if it cannot be reset
+    info.players.splice(info.players.indexOf(member), 1);
-     */
+    QUEUE.set(interaction.channelId, info);
-    async function leave(interaction) {
+    await interaction.reply(Lang.get('discord.leave'));
-        let { member, info } = getAll(interaction);
+}
-        if (!queueContains(interaction))
+exports.QueueCommands = {
-            throw (0, util_1.emsg)('You aren\'t in the queue');
+    open,
-        info.players.splice(info.players.indexOf(member), 1);
+    close,
-        QUEUE.set(interaction.channelId, info);
+    queue,
-        await interaction.reply('Left the queue');
+    join,
-    }
+    leave
-    QueueCommands.leave = leave;
+};
-})(QueueCommands = exports.QueueCommands || (exports.QueueCommands = {}));

dist/util.js

@@ -1,13 +1,34 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.memberIsModThrow = exports.memberIsMod = exports.getChannel = exports.getMember = exports.emsg = exports.errorMessage = exports.shuffle = void 0;
 const discord_js_1 = require("discord.js");
+const Lang = __importStar(require("./lang"));
 /**
  * shuffles an array
  * https://stackoverflow.com/a/2450976/2856416
  * @param array an array
  * @returns an array but shuffled
  */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 function shuffle(array) {
     let currentIndex = array.length, randomIndex;
     // While there remain elements to shuffle...
@@ -36,7 +57,7 @@ exports.errorMessage = errorMessage;
  * @param ephemeral (default=true)
  * @returns new errorMessage
  */
-const emsg = (msg, ephemeral = true) => new errorMessage(msg, ephemeral);
+const emsg = (msg, ephemeral = true) => new errorMessage(Lang.get(`error.${msg}`), ephemeral);
 exports.emsg = emsg;
 /**
  * get the GuildMember of an interaction
@@ -45,9 +66,9 @@ exports.emsg = emsg;
  * @returns member
  */
 function getMember(interaction) {
-    let member = interaction.member;
+    const member = interaction.member;
     if (!(member instanceof discord_js_1.GuildMember))
-        throw (0, exports.emsg)('Unable to retrieve guild member information, please try again');
+        throw (0, exports.emsg)('general.noMember');
     return member;
 }
 exports.getMember = getMember;
@@ -58,19 +79,19 @@ exports.getMember = getMember;
  * @returns member
  */
 function getChannel(interaction) {
-    let channel = interaction.channel;
+    const channel = interaction.channel;
     if (!(channel instanceof discord_js_1.TextChannel))
-        throw (0, exports.emsg)('Unable to retrieve text channel information, please try again');
+        throw (0, exports.emsg)('general.noChannel');
     return channel;
 }
 exports.getChannel = getChannel;
 function memberIsMod(interaction) {
-    let member = getMember(interaction);
+    const member = getMember(interaction);
     return member.permissionsIn(interaction.channelId).has('MANAGE_MESSAGES');
 }
 exports.memberIsMod = memberIsMod;
 function memberIsModThrow(interaction) {
     if (!memberIsMod(interaction))
-        throw (0, exports.emsg)('Member is not a moderator');
+        throw (0, exports.emsg)('discord.notMod');
 }
 exports.memberIsModThrow = memberIsModThrow;

dist/util/discord.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memberIsModThrow = exports.memberIsMod = exports.getChannel = exports.getMember = void 0;
+const discord_js_1 = require("discord.js");
+const main_1 = require("./main");
+/**
+ * get the GuildMember of an interaction
+ * @throws errorMessage class if it cannot be read
+ */
+function getMember(interaction) {
+    const member = interaction.member;
+    if (!(member instanceof discord_js_1.GuildMember))
+        throw (0, main_1.emsg)('general.noMember');
+    return member;
+}
+exports.getMember = getMember;
+/**
+ * get the TextChannel of an interaction
+ * @throws errorMessage class if it cannot be read
+ */
+function getChannel(interaction) {
+    const channel = interaction.channel;
+    if (!(channel instanceof discord_js_1.TextChannel))
+        throw (0, main_1.emsg)('general.noChannel');
+    return channel;
+}
+exports.getChannel = getChannel;
+/**
+ * get the TextChannel of an interaction
+ * @throws errorMessage class if the Member cannot be read
+ */
+function memberIsMod(interaction) {
+    const member = getMember(interaction);
+    return member.permissionsIn(interaction.channelId).has('MANAGE_MESSAGES');
+}
+exports.memberIsMod = memberIsMod;
+/**
+ * get the TextChannel of an interaction
+ * @throws errorMessage class if the Member cannot be read or if Member is not a mod
+ */
+function memberIsModThrow(interaction) {
+    if (!memberIsMod(interaction))
+        throw (0, main_1.emsg)('discord.notMod');
+}
+exports.memberIsModThrow = memberIsModThrow;

dist/util/lang.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.embedObjEmbed = exports.embedObjStr = exports.resolveColor = exports.bigString = exports.template = void 0;
+const discord_js_1 = require("discord.js");
+/**
+ *
+ * @param str
+ * @param args
+ * @returns
+ */
+function template(str, args) {
+    return str.replace(/{\w+}/g, str => {
+        const key = str.substring(1, str.length - 1);
+        if (key in args)
+            return args[key];
+        return key;
+    });
+}
+exports.template = template;
+/**
+ * converts bigString to string
+ */
+function bigString(bigStr) {
+    if (Array.isArray(bigStr))
+        return bigStr.join('\n');
+    return bigStr;
+}
+exports.bigString = bigString;
+/**
+ * converts Hex Color string to an RGB array
+ */
+function resolveColor(color) {
+    color = color.replace(/[^0-9a-f]/gi, '');
+    const colorNum = [0, 0, 0];
+    if (color.length === 3 || color.length === 6) {
+        const colorSpl = /([0-9a-f]{1,2})([0-9a-f]{1,2})([0-9a-f]{1,2})/.exec(color);
+        if (!colorSpl)
+            return colorNum;
+        for (let i = 0; i < colorSpl.length && i < colorNum.length; i++)
+            colorNum[i] = parseInt(colorSpl[i], 16);
+    }
+    return colorNum;
+}
+exports.resolveColor = resolveColor;
+/**
+ * converts embedObj to a string if applicable
+ * @param fallback the string to use if no valid strings can be found
+ */
+function embedObjStr(embedObj, args = {}, fallback = '') {
+    if (embedObj.content !== undefined)
+        return template(bigString(embedObj.content), args);
+    if (embedObj.description !== undefined)
+        return template(bigString(embedObj.description), args);
+    return fallback;
+}
+exports.embedObjStr = embedObjStr;
+/**
+ * converts embedObj to Discord.MessageEmbed
+ */
+function embedObjEmbed(embedObj, args = {}) {
+    const embed = new discord_js_1.MessageEmbed(), { author, color, description, fields, footer, image, thumbnail, timestamp, title, url } = embedObj;
+    if (author !== undefined) {
+        let authorFix;
+        if (typeof author === 'string')
+            authorFix = {
+                name: template(author, args)
+            };
+        else {
+            const { name, icon, url } = author;
+            authorFix = {
+                name: template(name, args)
+            };
+            if (icon !== undefined)
+                authorFix.icon = template(icon, args);
+            if (url !== undefined)
+                authorFix.url = template(url, args);
+        }
+        embed.setAuthor(authorFix);
+    }
+    if (footer !== undefined) {
+        let footerFix;
+        if (typeof footer === 'string')
+            footerFix = {
+                text: template(footer, args)
+            };
+        else {
+            const { text, icon } = footer;
+            footerFix = {
+                text: template(text, args)
+            };
+            if (icon !== undefined)
+                footerFix.icon = template(icon, args);
+        }
+        embed.setFooter(footerFix);
+    }
+    if (color !== undefined)
+        embed.setColor(resolveColor(template(color, args)));
+    if (description !== undefined)
+        embed.setDescription(template(bigString(description), args));
+    if (image !== undefined)
+        embed.setImage(template(image, args));
+    if (thumbnail !== undefined)
+        embed.setThumbnail(template(thumbnail, args));
+    if (title !== undefined)
+        embed.setTitle(template(title, args));
+    if (url !== undefined)
+        embed.setURL(template(url, args));
+    if (timestamp === true)
+        embed.setTimestamp();
+    else if (typeof timestamp === 'string')
+        embed.setTimestamp(new Date(template(timestamp, args)));
+    else if (timestamp !== false)
+        embed.setTimestamp(timestamp);
+    fields?.forEach(field => {
+        embed.addField(template(field.name, args), template(bigString(field.value), args), field.inline);
+    });
+    return embed;
+}
+exports.embedObjEmbed = embedObjEmbed;

dist/util/main.js

@@ -0,0 +1,63 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emsg = exports.errorMessage = exports.shuffle = void 0;
+const Lang = __importStar(require("../lang"));
+/**
+ * shuffles an array
+ * https://stackoverflow.com/a/2450976/2856416
+ * @param array an array
+ * @returns an array but shuffled
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function shuffle(array) {
+    let currentIndex = array.length, randomIndex;
+    // While there remain elements to shuffle...
+    while (currentIndex != 0) {
+        // Pick a remaining element...
+        randomIndex = Math.floor(Math.random() * currentIndex);
+        currentIndex--;
+        // And swap it with the current element.
+        [array[currentIndex], array[randomIndex]] = [
+            array[randomIndex], array[currentIndex]
+        ];
+    }
+    return array;
+}
+exports.shuffle = shuffle;
+/**
+ * use the emsg() function instead
+ */
+class errorMessage {
+    constructor(msg, ephemeral = true) {
+        this.msg = msg;
+        this.ephemeral = ephemeral;
+    }
+}
+exports.errorMessage = errorMessage;
+/**
+ * a simple class to contain an error message and related data
+ * @param msg error message
+ * @param ephemeral (default=true)
+ * @returns new errorMessage
+ */
+const emsg = (msg, ephemeral = true) => new errorMessage(Lang.get(`error.${msg}`), ephemeral);
+exports.emsg = emsg;

package.json

@@ -2,7 +2,7 @@
     "name": "1800queue",
     "version": "1.0.0",
     "description": "",
-    "main": "dist/index.js",
+    "main": "dist/main.js",
     "scripts": {
         "build": "tsc",
         "start": "node .",
@@ -30,7 +30,9 @@
     "author": "",
     "license": "MIT",
     "devDependencies": {
-        "@types/node": "^17.0.13",
+        "@types/node": "^17.0.17",
+        "@typescript-eslint/eslint-plugin": "^5.11.0",
+        "discord-api-types": "^0.26.1",
         "npm-watch": "^0.11.0",
         "ts-node": "^10.4.0",
         "typescript": "^4.5.5"
@@ -38,7 +40,6 @@
     "dependencies": {
         "@discordjs/rest": "^0.3.0",
         "cheerio": "^1.0.0-rc.10",
-        "discord-api-types": "^0.26.1",
         "discord.js": "^13.6.0"
     }
 }

src/api.ts

@@ -1,8 +1,9 @@
+/*eslint prefer-const: "error"*/
 import * as cheerio from 'cheerio';
-import { CommandInteraction, MessageEmbed } from 'discord.js';
+import { CommandInteraction } from 'discord.js';
-import { IncomingMessage } from 'http';
+import http, { IncomingMessage } from 'http';
-import http from 'https';
+import { emsg } from './util/main';
-import { emsg } from './util';
+import * as Lang from './lang';
 
 const uniteApiRegex = {
     //$1 = name, $2 = id
@@ -12,21 +13,7 @@ const uniteApiRegex = {
         /lv\.(\d+) (\w+) \((\d+)\)/i,   //master
         /lv\.(\d+) (\w+): class (\d+)/i //other
     ]
-}
+};
-
-type uniteApiData = {
-    name: string,
-    id: string,
-    avatar: string,
-
-    level: string,
-    rank: string,
-    class: string|null,
-    elo: string|null,
-    battles: string,
-    wins: string,
-    winrate: string
-}
 
 /**
  * gets the html of the uniteApi page for the player
@@ -39,8 +26,8 @@ function getHTML(name: string): Promise<string> {
 
     return new Promise((resolve, reject) => {
         
-        const init = {
+        const opts = {
-            host: 'uniteapi.dev',
+            host: '147.182.215.216',
             path: `/p/${encodeURIComponent(name)}`,
             method: 'GET',
         };
@@ -62,7 +49,7 @@ function getHTML(name: string): Promise<string> {
             });
         };
 
-        const req = http.request(init, callback);
+        const req = http.request(opts, callback);
         req.end();
 
     });
@@ -76,30 +63,31 @@ function getHTML(name: string): Promise<string> {
  * @throws errorMessage class if the request fails
  */
 function readHTML(html: string): uniteApiData {
-    let $ = cheerio.load(html)
+    const $ = cheerio.load(html),
-    let metaElems = $('meta').toArray(),
         foundData: uniteApiData = {
-            name: "",
+            name: '',
-            id: "",
+            id: '',
-            avatar: "",
+            avatar: '',
 
-            level: "",
+            level: '',
-            rank: "",
+            rank: '',
             elo: null,
             class: null,
-            battles: "",
+            battles: '',
-            wins: "",
+            wins: '',
-            winrate: ""
+            winrate: ''
         };
+
+    let metaElems = $('meta').toArray();
     
     //filter down to just ones named "og:..."
     metaElems = metaElems.filter(el => el.attribs.property?.startsWith('og:'));
 
     metaElems.forEach(el => {
-        let attr = el.attribs;
+        const attr = el.attribs;
 
         if (attr.property === 'og:title') {
-            let data = uniteApiRegex.ogtitle.exec(attr.content);
+            const data = uniteApiRegex.ogtitle.exec(attr.content);
             if (data !== null && data.length >= 3) {
                 foundData.name = data[1];
                 foundData.id = data[2];
@@ -107,17 +95,17 @@ function readHTML(html: string): uniteApiData {
         } else if (attr.property === 'og:description') {
 
             //all lines
-            let lines = attr.content.split('\n').map(l => l.trim()),
+            let lines = attr.content.split('\n').map(l => l.trim());
-                extraLines: string[] = [];
+            const extraLines: string[] = [];
 
             //ensure first line is correct
-            while (lines.length && !/pok.mon unite/i.test(lines[0])) {
+            while ((lines.length > 0) && !/pok.mon unite/i.test(lines[0])) {
-                let line = lines.shift();
+                const line = lines.shift();
-                if (line)
+                if (line !== undefined)
                     extraLines.push(line);
             }
 
-            if (!lines.length)
+            if (lines.length === 0)
                 throw emsg('Unable to read data, please try again');
             
             //bring the first lines removed back into the data
@@ -129,13 +117,12 @@ function readHTML(html: string): uniteApiData {
             //first line
             {
                 //will be only text after "pokemon unite:"
-                let line = lines[0].split(':').slice(1).join(':').trim();
+                const line = lines[0].split(':').slice(1).join(':').trim(),
-                
+                    regex = uniteApiRegex.ogdescription;
-                let regex = uniteApiRegex.ogdescription;
 
                 if (regex[0].test(line)) { //is master/has elo
 
-                    let regexData = line.match(regex[0]);
+                    const regexData = line.match(regex[0]);
 
                     if (!regexData || regexData.length < 4)
                         throw emsg('Unable to read data, please try again');
@@ -146,7 +133,7 @@ function readHTML(html: string): uniteApiData {
 
                 } else { //is not master/has a class
 
-                    let regexData = line.match(regex[1]);
+                    const regexData = line.match(regex[1]);
 
                     if (!regexData || regexData.length < 4)
                         throw emsg('Unable to read data, please try again');
@@ -164,7 +151,7 @@ function readHTML(html: string): uniteApiData {
             //rest of lines
             lines.forEach(line => {
 
-                let split = line.split(':').map(l => l.trim()),
+                const split = line.split(':').map(l => l.trim()),
                     key = split[0].toLowerCase().replace(/[^\w]/g, ''),
                     value = split[1];
 
@@ -186,7 +173,9 @@ function readHTML(html: string): uniteApiData {
 
     });
 
-    foundData.avatar = $('.player-card-image img').attr('src') || "";
+    const imgSrc = $('.player-card-image img').attr('src');
+
+    foundData.avatar = imgSrc !== undefined ? imgSrc : '';
     foundData.avatar = foundData.avatar.replace('../', 'https://uniteapi.dev/');
 
     return foundData;
@@ -199,7 +188,7 @@ function readHTML(html: string): uniteApiData {
  * @returns boolean, valid or invalid
  */
 function verifyData(data: uniteApiData): boolean {
-    if (data.id.length)
+    if (data.id.length > 0)
         return true;
     return false;
 }
@@ -210,8 +199,8 @@ function verifyData(data: uniteApiData): boolean {
  * @returns player data
  */
 export async function getPlayer(name: string): Promise<uniteApiData|null> {
-    let html = await getHTML(name);
+    const html = await getHTML(name),
-    let data = readHTML(html);
+        data = readHTML(html);
     if (verifyData(data))
         return data;
     return null;
@@ -219,19 +208,24 @@ export async function getPlayer(name: string): Promise<uniteApiData|null> {
 
 async function sendPlayerEmbed(interaction: CommandInteraction, data: uniteApiData) {
 
-    let embed = new MessageEmbed()
+    let eloStr: string;
-        .setTitle(`${data.name} (${data.id})`)
+    if (data.elo !== null)
-        .setURL(`https://uniteapi.dev/p/${encodeURIComponent(data.name)}`)
+        eloStr = `(${data.elo})`;
-        .setTimestamp()
+    else
-        .setThumbnail(data.avatar)
+        eloStr = `Class ${data.class}`;
-        .setDescription(`Level ${data.level}
-${data.rank} ${data.elo ? `(${data.elo})` : `Class ${data.class}`}
 
-**Battles** ${data.battles}
+    await interaction.editReply(Lang.getEmbed('api.player', {
-**Wins** ${data.wins}
+        name: data.name,
-**Win Rate** ${data.winrate}`);
+        id: data.id,
-
+        nameEncoded: encodeURIComponent(data.name),
-    await interaction.editReply({embeds: [embed]});
+        avatar: data.avatar,
+        level: data.level,
+        rank: data.rank,
+        elo: eloStr,
+        battles: data.battles,
+        wins: data.wins,
+        winrate: data.winrate
+    }));
 }
 
 /**
@@ -240,12 +234,12 @@ ${data.rank} ${data.elo ? `(${data.elo})` : `Class ${data.class}`}
  * @throws errorMessage class if the user cannot be found
  */
 export async function getPlayerInteraction(interaction: CommandInteraction) {
-    let username = interaction.options.getString('username', true);
+    const username = interaction.options.getString('username', true);
     await interaction.deferReply();
     
-    let data = await getPlayer(username);
+    const data = await getPlayer(username);
     if (data === null)
-        throw emsg('Unable to find user');
+        throw emsg('api.noUser');
     else
         sendPlayerEmbed(interaction, data);
 }

src/discord.ts

@@ -1,20 +1,31 @@
+/* eslint-disable camelcase */
 import { REST } from '@discordjs/rest';
 import { Routes } from 'discord-api-types/v9';
 
 // list of commands to register with discord
 const commands = [
     {
-        name: 'queue',
+        name: 'open',
-        description: 'get queue info or initialize a queue for this channel',
+        description: 'open a queue for this channel',
         options: [
             {
                 type: 4, //INTEGER
                 name: 'teamsize',
                 description: 'size of each team',
-                min_value: 1
+                min_value: 1,
+                required: true
             }
         ]
     },
+    {
+        name: 'close',
+        description: 'close the queue for this channel'
+    },
+    
+    {
+        name: 'queue',
+        description: 'view queue info'
+    },
     {
         name: 'join',
         description: 'join the active queue'
@@ -23,10 +34,6 @@ const commands = [
         name: 'leave',
         description: 'leave the active queue'
     },
-    {
-        name: 'stop',
-        description: 'stops the current queue (must have the Manage Messages permission)'
-    },
     {
         name: 'player',
         description: 'display player information',
@@ -39,7 +46,8 @@ const commands = [
             }
         ]
     }
-]; 
+];
+/*commandNames = commands.map(c => c.name);*/
 
 /**
  * register/reload commands on guild(s)
@@ -60,7 +68,6 @@ export async function registerCommands(token: string, clientId: string, guildIds
                 Routes.applicationGuildCommands(clientId, guildIds[i]),
                 { body: commands },
             );
-            console.log(`[${guildIds[i]}] registered command`);
         } catch (error) {
             console.error(error);
         }

src/lang.ts

@@ -0,0 +1,185 @@
+import { embedObjEmbed, embedObjStr, template } from './util/lang';
+
+const LANG: LangObjWhole = {
+
+    en: {
+
+        main: {
+            login: 'Logged in as {user}'
+        },
+
+        discord: {
+            botRestart: 'The bot has just restarted, anybody previously in the queue has been reset',
+            create: 'A queue for teams of {teamsize} has been created',
+            close: 'Queue has been closed',
+            join: 'Joined the queue',
+            leave: 'Left the queue',
+
+            team: {
+                embed: true,
+                title: 'Team',
+                description: '{team}'
+            },
+            queue: {
+                embed: true,
+                title: 'Active Queue',
+                fields: [
+                    {
+                        name: 'Team Size',
+                        value: '{teamsize}'
+                    },
+                    {
+                        name: 'Players Joined',
+                        value: '{playercount}'
+                    }
+                ],
+                footer: 'type `/join`'
+            }
+        },
+
+        api: {
+            player: {
+                embed: true,
+                title: '{name} ({id})',
+                url: 'https://uniteapi.dev/p/{nameEncoded}',
+                timestamp: true,
+                thumbnail: '{avatar}',
+                description: [
+                    'Level {level}',
+                    '{rank} {elo}',
+                    '',
+                    '**Battles** {battles}',
+                    '**Wins** {wins}',
+                    '**Win Rate** {winrate}'
+                ]
+            }
+        },
+
+        error: {
+
+            main: {
+                missingToken: 'Missing Discord Token, please enter the bot token into the token file'
+            },
+
+            discord: {
+                noQueue: 'There is not an active queue in this channel, type `/open` to create one',
+                noChannel: 'Unable to find channel {channelId} for teams of {teamsize}',
+                noCreate: 'There is already an active queue in this channel for teams of {teamsize}',
+                inQueue: 'You are already in the queue',
+                notInQueue: 'You aren\'t in the queue',
+                notMod: 'Member is not a moderator'
+            },
+
+            general: {
+                noMember: 'Unable to retrieve guild member information, please try again',
+                noChannel: 'Unable to retrieve text channel information, please try again'
+            },
+
+            api: {
+                noUser: 'Unable to find user'
+            }
+
+        }
+
+    }
+
+};
+
+/* MAIN */
+
+let LANGID = 'en';
+if (!(LANGID in LANG))
+    throw 'language id does not exist';
+
+export function setLang(langid: string) {
+    if (langid in LANG)
+        LANGID = langid;
+    else
+        throw 'language id does not exist';
+}
+
+/**
+ * reads language json (just strings)
+ * @param id ex: discord.error.noActiveQueue
+ * @param args list of key/value pairs to represent template values
+ * @returns language value, defaults to `id` parameter
+ */
+export function get(id: string, args: basicObjectStr = {}): string {
+    
+    const keySpl = id.split('.').map(k => k.trim()).filter(k => k);
+
+    let finding = LANG[LANGID];
+
+    for (const key of keySpl) {
+
+        if (key in finding) {
+
+            const found = finding[key];
+
+            if (typeof found === 'string')
+                return template(found, args);
+
+            if (found.embed === true)
+                return embedObjStr(found as embedObj, args, id);
+                
+            finding = found as LangObj;
+
+        } else
+            break;
+        
+    }
+
+    return id;
+}
+
+/**
+ * reads language json as an object (could be embed or just string)
+ * @param id ex: discord.error.noActiveQueue
+ * @param args list of key/value pairs to represent template values
+ * @param otherOptions values to be passed through to the return value
+ * @returns language value, defaults to `id` parameter
+ */
+export function getEmbed(id: string, args: basicObjectStr = {}, otherOptions: basicObject = {}): embedData {
+
+    const embedData: embedData = {
+        ...otherOptions,
+        embeds: []
+    };
+    
+    const keySpl = id.split('.').map(k => k.trim()).filter(k => k);
+
+    let finding = LANG[LANGID];
+
+    for (const key of keySpl) {
+
+        if (key in finding) {
+
+            const found = finding[key];
+
+            if (typeof found === 'string') {
+                embedData.content = template(found, args);
+                break;
+            }
+
+            if (found.embed === true) {
+                const embedObj = found as embedObj,
+                    {content} = embedObj,
+                    embed = embedObjEmbed(embedObj, args);
+
+                embedData.embeds.push(embed);
+
+                if (content !== undefined)
+                    embedData.content = content;
+
+                return embedData;
+            }
+            
+            finding = found as LangObj;
+
+        } else
+            break;
+        
+    }
+
+    return embedData;
+}

src/main.ts

@@ -3,8 +3,9 @@ import { Client, Intents } from 'discord.js';
 import * as fs from 'fs';
 import { getPlayerInteraction } from './api';
 import { registerCommands } from './discord';
+import * as Lang from './lang';
 import { discordInit, QueueCommands } from './queue';
-import { errorMessage } from './util';
+import { errorMessage } from './util/main';
 const CLIENT = new Client({ intents: [Intents.FLAGS.GUILDS] });
 
 //init logs with a timestamp
@@ -13,34 +14,56 @@ console.log(new Date().toISOString()+'\n\n');
 //get token
 if (!fs.existsSync('./token.txt')) {
     fs.writeFileSync('./token.txt', '');
-    console.error('Missing Discord Token, please enter the bot token into the token file');
+    console.error(Lang.get('error.main.missingToken'));
     process.exit(1);
 }
 const TOKEN = fs.readFileSync('./token.txt').toString();
 
 //discord connections
 CLIENT.on('ready', client => {
-    console.log(`Logged in as ${client.user.tag}`);
+    console.log(Lang.get('main.login', {
+        user: client.user.tag
+    }));
     client.guilds.fetch().then(guilds =>
         registerCommands(TOKEN, client.user.id, guilds.map(g => g.id)));
     discordInit(client);
 });
 
+CLIENT.on('guildCreate', guild => {
+    if (guild.client.user)
+        registerCommands(TOKEN, guild.client.user.id, guild.id);
+});
+
 CLIENT.on('interactionCreate', async interaction => {
     if (!interaction.isCommand()) return;
 
     try {
 
-        if (interaction.commandName === 'queue')
+        switch (interaction.commandName) {
-            await QueueCommands.queue(interaction);
+
-        else if (interaction.commandName === 'join')
+            //mod commands
-            await QueueCommands.join(interaction);
+            case 'open':
-        else if (interaction.commandName === 'leave')
+                await QueueCommands.open(interaction);
-            await QueueCommands.leave(interaction);
+                break;
-        else if (interaction.commandName === 'stop')
+            case 'close':
-            await QueueCommands.stop(interaction);
+                await QueueCommands.close(interaction);
-        else if (interaction.commandName === 'player')
+                break;
-            await getPlayerInteraction(interaction);
+
+            //general commands
+            case 'queue':
+                await QueueCommands.queue(interaction);
+                break;
+            case 'join':
+                await QueueCommands.join(interaction);
+                break;
+            case 'leave':
+                await QueueCommands.leave(interaction);
+                break;
+            case 'player':
+                await getPlayerInteraction(interaction);
+                break;
+
+        }
 
     } catch (e) {
 

src/queue.ts

@@ -1,13 +1,10 @@
-/* TODO
+import { Client, CommandInteraction, TextChannel } from 'discord.js';
-
-join message should contain your current position in the queue, editing it to keep it current
-*/
-
-import { Client, CommandInteraction, GuildMember, MessageEmbed, TextChannel } from "discord.js";
 import * as fs from 'fs';
-import { emsg, getChannel, getMember, memberIsModThrow, queueInfo, queueInfoBase } from "./util";
+import * as Lang from './lang';
+import { getChannel, getMember, memberIsModThrow } from './util/discord';
+import { emsg } from './util/main';
 
-//load queues from file
+//load queues from file`
 if (!fs.existsSync('./queues.json'))
     fs.writeFileSync('./queues.json', '{}');
 
@@ -16,22 +13,24 @@ const _QUEUE = fs.readFileSync('./queues.json').toString(),
 
 try {
 
-    let queueJson = JSON.parse(_QUEUE);
+    const queueJson = JSON.parse(_QUEUE);
 
-    for (let channelId of queueJson) {
+    for (const channelId in queueJson) {
-        let {teamsize} = queueJson[channelId] as queueInfoBase;
+        const {teamsize} = queueJson[channelId] as queueInfoBase;
-        if (teamsize)
+        if (teamsize !== 0)
-            QUEUE.set(channelId, { teamsize, players: [] })
+            QUEUE.set(channelId, { teamsize, players: [] });
     }
 
-} catch(e) {}
+} catch(e) {
+    //do nothing
+}
 
 function SaveQueue() {
 
-    let queueJson = Object.fromEntries(QUEUE),
+    const queueJson = Object.fromEntries(QUEUE),
         queueFileJson: {[keys: string]: queueInfoBase} = {};
 
-    for (let channelId in QUEUE.keys())
+    for (const channelId of QUEUE.keys())
         queueFileJson[channelId] = { teamsize: queueJson[channelId].teamsize };
     
     fs.writeFileSync('./queues.json', JSON.stringify(queueFileJson, null, 2));
@@ -39,224 +38,212 @@ function SaveQueue() {
 }
 
 async function checkQueue(channel: TextChannel) {
-    let info = QUEUE.get(channel.id);
+    const info = QUEUE.get(channel.id);
 
     if (!info)
         return;
     
-    if (info.players.length > info.teamsize) {
+    if (info.players.length >= info.teamsize) {
 
-        let team = info.players.splice(0, info.teamsize).map(m => m.toString());
+        const team = info.players.splice(0, info.teamsize).map(m => m.toString());
 
-        let embed = new MessageEmbed()
+        await channel.send(Lang.getEmbed('discord.team', { team: team.join('\n') }));
-            .setTitle('Team')
-            .setDescription(team.join('\n'));
-
-        await channel.send({embeds: [embed]});
 
     }
-    
+
 }
-namespace Queue {
+    
 
-    export function create(channelId: string, teamsize: number) {
+export function queueCreate(channelId: string, teamsize: number) {
-        if (!QUEUE.has(channelId)) {
+    if (!QUEUE.has(channelId)) {
-            QUEUE.set(channelId, {teamsize, players: []});
+        QUEUE.set(channelId, {teamsize, players: []});
-            SaveQueue();
+        SaveQueue();
-        }
     }
+}
 
-    export function remove(channelId: string) {
+export function queueRemove(channelId: string) {
-        if (QUEUE.has(channelId)) {
+    if (QUEUE.has(channelId)) {
-            QUEUE.delete(channelId);
+        QUEUE.delete(channelId);
-            SaveQueue();
+        SaveQueue();
-        }
     }
-
-    export function addPlayer(channelId: string, member: GuildMember) {
-        if (QUEUE.has(channelId)) {
-            QUEUE.delete(channelId);
-        }
-    }
-
-    export function removePlayer(channelId: string, member: GuildMember) {
-        if (QUEUE.has(channelId)) {
-            QUEUE.delete(channelId);
-        }
-    }
-
 }
 
 SaveQueue();
 
 export async function discordInit(client: Client) {
 
-    for (let channelId in QUEUE.keys()) {
+    for (const channelId of QUEUE.keys()) {
 
-        let info = QUEUE.get(channelId),
+        const info = QUEUE.get(channelId),
             channel = await client.channels.fetch(channelId);
 
-        if (!info) { //no idea what could cause this but TS complains
+        if (!info) {
-            Queue.remove(channelId);
+            queueRemove(channelId);
             continue;
         }
 
         if (!channel || !(channel instanceof TextChannel)) {
-            console.error(`Unable to find channel ${channelId} for teams of ${info?.teamsize}`);
+            console.error(Lang.get('error.discord.noChannel'), {
-            Queue.remove(channelId);
+                channelId,
+                teamsize: info.teamsize
+            });
+            queueRemove(channelId);
             continue;
         }
 
-        channel.send('The bot has just restarted and anybody in the queues have been reset')
+        channel.send(Lang.get('discord.botRestart'));
 
     }
         
 }
-export namespace QueueCommands {
 
-    /**
+/**
-     * get the queueInfo of an interaction
+ * get the queueInfo of an interaction
-     * @param interaction 
+ * @param interaction 
-     * @throws errorMessage class if it does not exist
+ * @throws errorMessage class if it does not exist
-     * @returns queue info
+ * @returns queue info
-     */
+ */
-    function getInfo(interaction: CommandInteraction): queueInfo {
+function getInfo(interaction: CommandInteraction): queueInfo {
-        let info = QUEUE.get(interaction.channelId);
+    const info = QUEUE.get(interaction.channelId);
 
-        if (!info)
+    if (!info)
-            throw emsg('There is not an active queue in this channel, type `/queue` to create one');
+        throw emsg('discord.noQueue');
 
-        return info;
+    return info;
-    }
+}
 
-    /**
+/**
-     * compiles all the get functions above
+ * compiles all the get functions above
-     * @param interaction 
+ * @param interaction 
-     * @throws if another get function throws
+ * @throws if another get function throws
-     * @returns object containing each
+ * @returns object containing each
-     */
+ */
-    const getAll = (interaction: CommandInteraction) => ({
+const getAll = (interaction: CommandInteraction) => ({
-            member: getMember(interaction),
+        member: getMember(interaction),
-            channel: getChannel(interaction),
+        channel: getChannel(interaction),
-            info: getInfo(interaction)
+        info: getInfo(interaction)
-        });
+    });
 
-    /**
+/**
-     * checks if the interaction data is already in the queue
+ * checks if the interaction data is already in the queue
-     * @param interaction 
+ * @param interaction 
-     * @returns boolean
+ * @returns boolean
-     */
+ */
-    export function queueContains(interaction: CommandInteraction): boolean {
+export function queueContains(interaction: CommandInteraction): boolean {
 
-        let {member, info} = getAll(interaction);
+    const {member, info} = getAll(interaction);
 
-        if (info.players.map(m=>m.id).includes(member.id))
+    if (info.players.map(m=>m.id).includes(member.id))
-            return true;
+        return true;
 
-        return false;
+    return false;
-
-    }
-
-    /**
-     * creates a queue from an interaction
-     * @param interaction 
-     * @throws errorMessage class if it cannot be left
-     */
-    export function queueCreate(interaction: CommandInteraction) {
-        memberIsModThrow(interaction);
-
-        let {channelId} = interaction,
-            teamsize = interaction.options.getInteger('teamsize', true);
-
-        if (QUEUE.has(channelId))
-            throw emsg(`There is already an active queue in this channel for teams of ${QUEUE.get(channelId)?.teamsize}`);
-
-        Queue.create(channelId, teamsize);
-
-        interaction.reply(`A queue for teams of ${teamsize} has been started`)
-
-    }
-
-    /**
-     * creates a queue from an interaction
-     * @param interaction 
-     * @throws errorMessage class if it cannot be left
-     */
-    export async function queue(interaction: CommandInteraction) {
-
-        let teamsize = interaction.options.getInteger('teamsize');
-
-        if (teamsize) {
-            queueCreate(interaction);
-            return;
-        }
-
-        let info = getInfo(interaction);
-
-        let embed = new MessageEmbed()
-            .setTitle('Active Queue')
-            .addField('Team Size', info.teamsize.toString(), true)
-            .addField('Players Joined', info.players.length.toString(), true)
-            .setFooter({text: 'type /join'});
-
-        await interaction.reply({embeds: [embed], ephemeral: true});
-
-    }
-
-    /**
-     * stops a queue from an interaction
-     * @param interaction 
-     * @throws errorMessage class if it cannot be joined
-     */
-    export async function stop(interaction: CommandInteraction) {
-        memberIsModThrow(interaction);
-
-        QUEUE.delete(interaction.channelId);
-
-        await interaction.reply('Queue has been reset');
-
-    }
-
-    /**
-     * joins a queue from an interaction
-     * @param interaction 
-     * @throws errorMessage class if it cannot be readied
-     */
-    export async function join(interaction: CommandInteraction) {
-
-        let {member, info, channel} = getAll(interaction);
-
-        if (queueContains(interaction))
-            throw emsg('You are already in the queue');
-
-        info.players.push(member);
-
-        QUEUE.set(interaction.channelId, info);
-
-        await interaction.reply('Joined the queue');
-
-        checkQueue(channel);
-
-    }
-
-    /**
-     * leaves a queue from an interaction
-     * @param interaction 
-     * @throws errorMessage class if it cannot be reset
-     */
-    export async function leave(interaction: CommandInteraction) {
-
-        let {member, info} = getAll(interaction);
-
-        if (!queueContains(interaction))
-            throw emsg('You aren\'t in the queue');
-
-        info.players.splice(info.players.indexOf(member), 1);
-
-        QUEUE.set(interaction.channelId, info);
-
-        await interaction.reply('Left the queue');
-        
-    }
 
 }
+
+/**
+ * opens a queue
+ * @param interaction 
+ * @throws errorMessage class if it cannot be left
+ */
+function open(interaction: CommandInteraction) {
+
+    memberIsModThrow(interaction);
+
+    const {channelId} = interaction,
+        teamsize = interaction.options.getInteger('teamsize', true);
+
+    const existing = QUEUE.get(channelId);
+    if (existing)
+        throw emsg(Lang.get('error.discord.noCreate', {
+            teamsize: existing.teamsize.toString()
+        }));
+
+    queueCreate(channelId, teamsize);
+
+    interaction.reply(Lang.get('discord.create', {
+        teamsize: teamsize.toString()
+    }));
+
+}
+
+/**
+ * closes a queue
+ * @param interaction 
+ * @throws errorMessage class if it cannot be joined
+ */
+async function close(interaction: CommandInteraction) {
+    memberIsModThrow(interaction);
+
+    QUEUE.delete(interaction.channelId);
+
+    await interaction.reply(Lang.get('discord.close'));
+
+}
+
+/**
+ * gives info about the queue
+ * @param interaction 
+ * @throws errorMessage class if it cannot be left
+ */
+async function queue(interaction: CommandInteraction) {
+
+    const info = getInfo(interaction);
+
+    await interaction.reply(Lang.getEmbed('discord.queue', {
+        teamsize: info.teamsize.toString(),
+        playercount: info.players.length.toString(),
+    }, {
+        ephemeral: true
+    }));
+
+}
+
+/**
+ * joins a queue
+ * @param interaction 
+ * @throws errorMessage class if it cannot be readied
+ */
+async function join(interaction: CommandInteraction) {
+
+    const {member, info, channel} = getAll(interaction);
+
+    if (queueContains(interaction))
+        throw emsg('discord.inQueue');
+
+    info.players.push(member);
+
+    QUEUE.set(interaction.channelId, info);
+
+    await interaction.reply(Lang.get('discord.join'));
+
+    checkQueue(channel);
+
+}
+
+/**
+ * leaves a queue
+ * @param interaction 
+ * @throws errorMessage class if it cannot be reset
+ */
+async function leave(interaction: CommandInteraction) {
+
+    const {member, info} = getAll(interaction);
+
+    if (!queueContains(interaction))
+        throw emsg('discord.notInQueue');
+
+    info.players.splice(info.players.indexOf(member), 1);
+
+    QUEUE.set(interaction.channelId, info);
+
+    await interaction.reply(Lang.get('discord.leave'));
+    
+}
+
+export const QueueCommands = {
+    open,
+    close,
+    queue,
+    join,
+    leave
+};

src/types/api.d.ts

@@ -0,0 +1,16 @@
+/**
+ * data taken from UniteAPI
+ */
+interface uniteApiData {
+    name: string,
+    id: string,
+    avatar: string,
+
+    level: string,
+    rank: string,
+    class: string|null,
+    elo: string|null,
+    battles: string,
+    wins: string,
+    winrate: string
+}

src/types/lang.d.ts

@@ -0,0 +1,104 @@
+/**
+ * any indexable object
+ */
+//this is a generic type, and needs 'any'
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type basicObject = {[keys: string]: any};
+
+/**
+ * any indexable object with string values
+ */
+type basicObjectStr = {[keys: string]: string};
+
+/**
+ * an abstract version of strings
+ */
+type bigString = string | string[];
+
+/**
+ * an object that contains embeds and can be passed directly to methods like `Discord.TextChannel.send()`
+ */
+interface embedData {
+    content?: string,
+    embeds: MessageEmbed[]
+}
+
+
+/**
+ * a representation of an author in the LANG object
+ * 
+ * `LANG > Language > Embed > Field`
+ */
+interface embedField {
+    name: string,
+    value: bigString,
+    inline?: boolean
+}
+
+/**
+ * a representation of an author in the LANG object
+ * 
+ * `LANG > Language > Embed > Author`
+ */
+interface authorData {
+    name: string,
+    url?: string,
+    icon?: string
+}
+
+/**
+ * a representation of a footer in the LANG object
+ * 
+ * `LANG > Language > Embed > Footer`
+ */
+interface footerData {
+    text: string,
+    icon?: string
+}
+
+/**
+ * a representation of an embed in the LANG object
+ * 
+ * `LANG > Language > Embed`
+ */
+interface embedObj {
+    embed: true,
+
+    content?: string,
+    title?: string,
+    description?: bigString,
+    /**
+     * URL
+     */
+    url?: string,
+    /**
+     * #FFFFFF
+     */
+    color?: string,
+    footer?: string | footerData,
+    thumbnail?: string,
+    /**
+     * URL
+     */
+    image?: string,
+    /**
+     * URL
+     */
+    author?: string | authorData,
+    fields?: embedField[],
+    timestamp?: boolean | string | number
+}
+
+/**
+ * a specific language in the LANG object
+ * 
+ * `LANG > Language`
+ */
+type LangObj = { [keys:string]: LangObj | embedObj | string }
+
+/**
+ * the entire LANG object
+ * 
+ * `LANG`
+ */
+type LangObjWhole = { [langid:string]: LangObj }

src/types/queue.d.ts

@@ -0,0 +1,6 @@
+interface queueInfoBase {
+    teamsize: number
+}
+interface queueInfo extends queueInfoBase {
+    players: GuildMember[]
+}

src/util.ts

@@ -1,95 +0,0 @@
-import { CommandInteraction, GuildMember, TextChannel } from "discord.js";
-
-/**
- * shuffles an array
- * https://stackoverflow.com/a/2450976/2856416
- * @param array an array
- * @returns an array but shuffled
- */
-export function shuffle(array: any[]) {
-    let currentIndex = array.length,  randomIndex;
-
-    // While there remain elements to shuffle...
-    while (currentIndex != 0) {
-
-        // Pick a remaining element...
-        randomIndex = Math.floor(Math.random() * currentIndex);
-        currentIndex--;
-
-        // And swap it with the current element.
-        [array[currentIndex], array[randomIndex]] = [
-        array[randomIndex], array[currentIndex]];
-    }
-
-    return array;
-}
-
-
-
-export class errorMessage {
-    public msg: string;
-    public ephemeral: boolean;
-
-    constructor(msg: string, ephemeral: boolean = true) {
-        this.msg = msg;
-        this.ephemeral = ephemeral;
-    }
-}
-
-/**
- * a simple class to contain an error message and related data
- * @param msg error message
- * @param ephemeral (default=true)
- * @returns new errorMessage
- */
-export const emsg = (msg: string, ephemeral: boolean = true) => new errorMessage(msg, ephemeral);
-
-
-
-export interface queueInfoBase {
-    teamsize: number
-}
-export interface queueInfo extends queueInfoBase{
-    players: GuildMember[]
-}
-
-/**
- * get the GuildMember of an interaction
- * @param interaction 
- * @throws errorMessage class if it cannot be read
- * @returns member
- */
-export function getMember(interaction: CommandInteraction): GuildMember {
-    let member = interaction.member;
-
-    if (!(member instanceof GuildMember))
-        throw emsg('Unable to retrieve guild member information, please try again');
-
-    return member;
-}
-
-/**
- * get the TextChannel of an interaction
- * @param interaction 
- * @throws errorMessage class if it cannot be read
- * @returns member
- */
-export function getChannel(interaction: CommandInteraction): TextChannel {
-    let channel = interaction.channel;
-
-    if (!(channel instanceof TextChannel))
-        throw emsg('Unable to retrieve text channel information, please try again');
-
-    return channel;
-}
-
-
-export function memberIsMod(interaction: CommandInteraction): boolean {
-    let member = getMember(interaction);
-    return member.permissionsIn(interaction.channelId).has('MANAGE_MESSAGES');
-}
-
-export function memberIsModThrow(interaction: CommandInteraction) {
-    if (!memberIsMod(interaction))
-        throw emsg('Member is not a moderator');
-}

src/util/discord.ts

@@ -0,0 +1,46 @@
+import { CommandInteraction, GuildMember, TextChannel } from 'discord.js';
+import { emsg } from './main';
+
+/**
+ * get the GuildMember of an interaction
+ * @throws errorMessage class if it cannot be read
+ */
+export function getMember(interaction: CommandInteraction): GuildMember {
+    const member = interaction.member;
+
+    if (!(member instanceof GuildMember))
+        throw emsg('general.noMember');
+
+    return member;
+}
+
+/**
+ * get the TextChannel of an interaction
+ * @throws errorMessage class if it cannot be read
+ */
+export function getChannel(interaction: CommandInteraction): TextChannel {
+    const channel = interaction.channel;
+
+    if (!(channel instanceof TextChannel))
+        throw emsg('general.noChannel');
+
+    return channel;
+}
+
+/**
+ * get the TextChannel of an interaction
+ * @throws errorMessage class if the Member cannot be read
+ */
+export function memberIsMod(interaction: CommandInteraction): boolean {
+    const member = getMember(interaction);
+    return member.permissionsIn(interaction.channelId).has('MANAGE_MESSAGES');
+}
+
+/**
+ * get the TextChannel of an interaction
+ * @throws errorMessage class if the Member cannot be read or if Member is not a mod
+ */
+export function memberIsModThrow(interaction: CommandInteraction) {
+    if (!memberIsMod(interaction))
+        throw emsg('discord.notMod');
+}

src/util/lang.ts

@@ -0,0 +1,162 @@
+import { MessageEmbed } from 'discord.js';
+
+/**
+ * 
+ * @param str 
+ * @param args 
+ * @returns 
+ */
+export function template(str: string, args: basicObject): string {
+
+    return str.replace(/{\w+}/g, str => {
+
+        const key = str.substring(1, str.length-1);
+
+        if (key in args)
+            return args[key];
+
+        return key;
+
+    });
+
+}
+
+/**
+ * converts bigString to string
+ */
+export function bigString(bigStr: bigString): string {
+    if (Array.isArray(bigStr))
+        return bigStr.join('\n');
+    return bigStr;
+}
+
+
+/**
+ * converts Hex Color string to an RGB array
+ */
+export function resolveColor(color: string): [number, number, number] {
+    color = color.replace(/[^0-9a-f]/gi, '');
+
+    const colorNum: [number, number, number] = [0, 0, 0];
+
+    if (color.length === 3 || color.length === 6) {
+
+        const colorSpl = /([0-9a-f]{1,2})([0-9a-f]{1,2})([0-9a-f]{1,2})/.exec(color);
+
+        if (!colorSpl)
+            return colorNum;
+
+        for (let i = 0; i < colorSpl.length && i < colorNum.length; i++)
+            colorNum[i] = parseInt(colorSpl[i], 16);
+
+    }
+
+    return colorNum;
+}
+
+/**
+ * converts embedObj to a string if applicable
+ * @param fallback the string to use if no valid strings can be found
+ */
+export function embedObjStr(embedObj: embedObj, args: basicObjectStr = {}, fallback = ''): string {
+
+    if (embedObj.content !== undefined)
+        return template(bigString(embedObj.content), args);
+
+    if (embedObj.description !== undefined)
+        return template(bigString(embedObj.description), args);
+
+    return fallback;
+}
+
+/**
+ * converts embedObj to Discord.MessageEmbed
+ */
+export function embedObjEmbed(embedObj: embedObj, args: basicObjectStr = {}): MessageEmbed {
+    const embed = new MessageEmbed(),
+        { author, color, description, fields, footer, image, thumbnail, timestamp, title, url } = embedObj;
+
+    if (author !== undefined) {
+
+        let authorFix: authorData;
+
+        if (typeof author === 'string')
+            authorFix = {
+                name: template(author, args)
+            };
+        else {
+
+            const {name, icon, url} = author;
+
+            authorFix = {
+                name: template(name, args)
+            };
+
+            if (icon !== undefined)
+                authorFix.icon = template(icon, args);
+
+            if (url !== undefined)
+                authorFix.url = template(url, args);
+
+        }
+
+        embed.setAuthor(authorFix);
+
+    }
+
+    if (footer !== undefined) {
+
+        let footerFix: footerData;
+
+        if (typeof footer === 'string')
+            footerFix = {
+                text: template(footer, args)
+            };
+        else {
+
+            const {text, icon} = footer;
+
+            footerFix = {
+                text: template(text, args)
+            };
+
+            if (icon !== undefined)
+                footerFix.icon = template(icon, args);
+
+        }
+
+        embed.setFooter(footerFix);
+
+    }
+
+    if (color !== undefined)
+        embed.setColor(resolveColor(template(color, args)));
+
+    if (description !== undefined)
+        embed.setDescription(template(bigString(description), args));
+
+    if (image !== undefined)
+        embed.setImage(template(image, args));
+
+    if (thumbnail !== undefined)
+        embed.setThumbnail(template(thumbnail, args));
+
+    if (title !== undefined)
+        embed.setTitle(template(title, args));
+
+    if (url !== undefined)
+        embed.setURL(template(url, args));
+
+    if (timestamp === true)
+        embed.setTimestamp();
+    else if (typeof timestamp === 'string')
+        embed.setTimestamp(new Date(template(timestamp, args)));
+    else if (timestamp !== false)
+        embed.setTimestamp(timestamp);
+
+    fields?.forEach(field => {
+        embed.addField(template(field.name, args), template(bigString(field.value), args), field.inline);
+    });
+
+    return embed;
+}

src/util/main.ts

@@ -0,0 +1,49 @@
+import * as Lang from '../lang';
+
+/**
+ * shuffles an array
+ * https://stackoverflow.com/a/2450976/2856416
+ * @param array an array
+ * @returns an array but shuffled
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function shuffle(array: any[]) {
+    let currentIndex = array.length,  randomIndex;
+
+    // While there remain elements to shuffle...
+    while (currentIndex != 0) {
+
+        // Pick a remaining element...
+        randomIndex = Math.floor(Math.random() * currentIndex);
+        currentIndex--;
+
+        // And swap it with the current element.
+        [array[currentIndex], array[randomIndex]] = [
+        array[randomIndex], array[currentIndex]];
+    }
+
+    return array;
+}
+
+
+/**
+ * use the emsg() function instead
+ */
+export class errorMessage {
+    public msg: string;
+    public ephemeral: boolean;
+
+    constructor(msg: string, ephemeral = true) {
+        this.msg = msg;
+        this.ephemeral = ephemeral;
+    }
+}
+
+/**
+ * a simple class to contain an error message and related data
+ * @param msg error message
+ * @param ephemeral (default=true)
+ * @returns new errorMessage
+ */
+export const emsg = (msg: string, ephemeral = true) => new errorMessage(Lang.get(`error.${msg}`), ephemeral);
+

tsconfig.eslint.json

@@ -0,0 +1,11 @@
+// Special typescript project file, used by eslint only.
+{
+    "extends": "./tsconfig.json",
+    "include": [
+        // repeated from base config's "include" setting
+        "src",
+
+        // these are the eslint-only inclusions
+        ".eslintrc.json",
+    ]
+}

tsconfig.json

@@ -6,7 +6,16 @@
     "outDir": "./dist",
     "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
     "strict": true,
-    "skipLibCheck": true
+    "noImplicitReturns": true,
-  }
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "typeRoots": [
+      "./src/types/"
+    ]
+  },
+  "include": [
+    "src"
+  ]
 }