aboutsummaryrefslogtreecommitdiffstats
path: root/server/commands/core/help.js
blob: 7f63d3df9d9d05da153aec69acf8637e6b38f3cb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
/*
  Description: Outputs the current command module list or command categories
*/

const stripIndents = require('common-tags').stripIndents;

exports.run = async (core, server, socket, data) => {
  // verify passed arguments
  let typeDt = typeof data.type;
  let catDt = typeof data.category;
  let cmdDt = typeof data.command;
  if (typeDt !== 'undefined' && typeDt !== 'string' ) {
    return;
  } else if (catDt !== 'undefined' && catDt !== 'string' ) {
    return;
  } else if (cmdDt !== 'undefined' && cmdDt !== 'string' ) {
    return;
  }

  // set default reply
  let reply = stripIndents`Help usage:
    Show all categories -> { cmd: 'help', type: 'categories' }
    Show all commands in category -> { cmd: 'help', category: '<category name>' }
    Show specific command -> { cmd: 'help', command: '<command name>' }`;

  if (typeDt !== 'undefined') {
    let categories = core.commands.categories().sort();
    reply = `Command Categories:\n${categories.map(c => `- ${c.replace('../src/commands/', '')}`).join('\n')}`;
  } else if (catDt !== 'undefined') {
    let catCommands = core.commands.all('../src/commands/' + data.category).sort((a, b) => a.info.name.localeCompare(b.info.name));
    reply = `${data.category} commands:\n${catCommands.map(c => `- ${c.info.name}`).join('\n')}`;
  } else if (cmdDt !== 'undefined') {
    let command = core.commands.get(data.command);
    reply = stripIndents`
      Usage: ${command.info.usage || command.info.name}
      Description: ${command.info.description || '¯\_(ツ)_/¯'}`;
  }

  server.reply({
    cmd: 'info',
    text: reply
  }, socket);
};

exports.info = {
  name: 'help',
  usage: 'help ([ type:categories] | [category:<category name> | command:<command name> ])',
  description: 'Outputs information about the servers current protocol'
};