feat: add config to set scanner cooldown by role

[SherlockSometimes]

Add discordRoleCooldown to scanNext and scanZone config to set cooldown per user role

example config (scanZone accepts the same format)
"scanNext": {
...
// Discord roles that will be allowed to use scanNext
"discordRoles": ["Supporter","Scanner", "Mod"],
// Default cooldown if no role specific cooldown
"userCooldownSeconds": 60,
//List of role/cooldown pair shortest matching time will apply
"discordRoleCooldown":[["Supporter",30],["Mod",0]],
...
}

Expected outcome:
Supporter: 30 second cooldown
Mod: 0 second cooldown
Scanner: will get the default 60 second cooldown.
Supporter & Mod role: the lower 0 second cooldown would apply.

[TurtIeSocks]

Thanks for the contribution, I'm sure many are interested in this! I've been contemplating since you posted in the Discord for how we want to approach this in a scalable way that makes sense, but I keep ending up with solutions that add a lot of complications to this PR. So I'm going to try and keep this simple-ish for now and I may revise it in the future.

• Let's change the new config keys to just rules, as it will be used for Discord and Telegram. And I will use this more in the future as well...
• For the values themselves, we should switch to objects instead of a tuple, to be more consistent with the rest of the config / easier to read. Something like:

{
  "rules": [
      { "role": "12415", "cooldown": 5 },
      { "role": "mod", "cooldown": 1 }
   ]
}

• In server/src/services/config.js, after replacing the alias roles with their ID counterparts, lets create a new map in each of the scanner modes. Something like:

config.scanner.scanNext.rulesObj = Object.fromEntries(config.scanner.scanNext.rules.map((rule) => [rule.role, rule.cooldown]))

• Same for ScanZone
• In server/src/services/DiscordClient.js, remove the code you have now. Add:

    // put this below the scanner declaration
    perms.scannerCooldowns = {}
    // Replace the code where the `scannerPerms` function is being called with
              scannerPerms(userRoles, 'discordRoles', trialActive).forEach(
                (x) => {
                  permSets.scanner.add(x)
                  perms.scannerCooldowns[x] = scanner[x].rules.reduce(
                    (acc, rule) => {
                      if (rule.cooldown < acc) {
                        return rule.cooldown
                      }
                      return acc
                    },
                    scanner[x].userCooldownSeconds,
                  )
                },
              )

• Add this above code to server/src/services/TelegramClient.js as well, with the appropriate adjustments for TG
• In server/src/graphql/resolves.js:
  • For the scannerConfig resolver, change these:
  • cooldown: perms?.scannerCooldowns?.[mode] || scanner.scanZone.userCooldownSeconds
  • cooldown: perms?.scannerCooldowns?.[mode] || scanner.scanNext.userCooldownSeconds
  • You also need to adjust the scanner resolver, this one seems to have somehow escaped my attempt to have them in alphabetical order, so it's last in the Query object... Add something like:

const cooldownSeconds = perms?.scannerCooldowns?.[category] || config.getSafe(`scanner.${category}.userCooldownSeconds`)

• Then adjust the cooldown variable calculation to use this new value
• I would also like if you could adjust the Permissions type found in packages/types/lib so it has the new property.

I know you mentioned on Discord that JS isn't your preferred language so let me know if you want me to jump in and help. I also didn't test these suggested changes so if something seems off, feel free to reach out. Thanks!

[SherlockSometimes]

Didn't add the telegram part, I could add it but it would be untested as I don't use telegram, I can look at it tommorow if so, but figured id post the tested code and do that seperatly.
Wasn't sure if 'rules' needed to be added to 'Permissions' also as its part of the permSet object, so left it out for now.
Also added admin users get 0 cooldown as they skip the permission loop and would just get the default value.

[TurtIeSocks]

Thanks for the adjustments, left some suggested changes on a few small things.

As far as TG, if you just translate the code over to the TelegramClient then I will make an attempt to test it later this week. TG is quite a pain in the ass to test if you don't have already have it set up so I wouldn't ask anyone to go through that 😂

[SherlockSometimes]

Switched to nullish ?? operator as 0 == false and would set default value when a 0 cooldown role was set.
Added telegram, it compiled and ran but no other testing was done with it.