to make it considerably easier to find your way around the lib

cache role overrides too and calculate user permissions

should try to delete these files

quark seems to get ratelimited very very occasionally, with <1 second left before another request can be made

likely due to network latency, and definitely something that should be accounted for

dynamically calculating this seems like the best way

decide how it can be determined whether certain things should be cached for certain guilds

perhaps attach the gData structure to the guild, and determine from there?/more integration between the guild and gData structures

during busy periods when lots of requests are trying to be processed, often at the same time, it is very common for ratelimits to be encountered with ~1 second or less of time until another request can be made, resulting in missed messages

there is no recovery mechanism for if a queue gets stuck, requests just keep getting added indefinitely while no further requests are made

prevent guilds which have just recovered from being unavailable from being emitted again - should note if a guild is unavailable

see https://discord.com/developers/docs/topics/gateway#heartbeating-example-gateway-heartbeat-ack

need to disconnect and attempt to resume

let shard ids be provided to the client, so the bot can give different responses for different servers

implement or allow a way to perform rolling/zero-downtime restarts

• perhaps could try restarting on the reconnect event? would avoid the issue of hitting the IDENTIFY limit
• ideally (and if we were to use the reconnect event) things should stay cached between restarts (and apparently "reloading" modules/files is not a great idea and can cause memory issues, so i would prefer to avoid that if possible)

"dev" - lots of logging
"prod" - no logging, process should continue running even if an error is encountered
"shadow" - runs in the background. everything happens as it usually would, except requests which cause an action are not made. needed for stress and stability testing

provide option to include specific properties in cache

provide a quick and easy way of starting the bot on multiple processes, some of which may run slightly different code (for a/b testing)

rewrite gluon using rust?????

https://napi.rs ??????