@somehiddenkey/discord-command-utils 2.0.0 → 2.1.0

package/README.md

@@ -66,6 +66,44 @@ export const globalConfig = GlobalConfig.load("../global_config.json");
 ```
 It contains the IDs of the following sections: guilds, categories, channels, log channels and roles. These can be used as constant values throughout your code, making sure that if an ID ever changes, that all bot instances would take the new updated value by simply updating the json once.
 
+#### Properties
+The properties of the different guilds can read per scope/guild. We differentiate the main, tutor, staff and community server:
+- Get the ID of the main server : `globalConfig.main.guild.id`
+- Get the ID of the general chat in the main server: `globalConfig.main.channels.international.id`
+
+#### Caching
+You can fetch and cache the value of a guild, channel or role from discordjs, as to access it immidiately afterwards. However, at all times, the id is available even without fetching
+```js
+console.write(globalConfig.main.guild.name); //error: not fetched yet
+console.write(globalConfig.main.guild.id); 	//still fine, ID always accessible
+
+await globalConfig.main.guild.fetch();
+await globalConfig.main.channels.international.fetch();
+console.write(globalConfig.main.guild.name); //uses the cached value
+```
+
+Please keep in mind that cached value may contain outdated data! If you call `fetch()` it will either return the cached value or fetch the value once. If you want to reload the value e.g. to read the updated members that are in a specific voicechannel, you must call `refresh()`
+
+```js
+console.write(globalConfig.main.channels.break_afk.members.length); 
+//shows the member count at the time of the fetch()
+
+await globalConfig.main.channels.break_afk.refresh();
+//fetches the value again, and caches it again
+
+console.write(globalConfig.main.channels.break_afk.members.length); 
+//shows the now updated member count
+```
+
+You can fetch and refresh entire groups or guilds. Please keep in mind that, if you fetch the values of a specific guild, the bot has to actually be part of that server. A value that cannot be fetched will result in an error.
+
+```js
+await globalConfig.community.fetch();
+await globalConfig.main.channels.fetch();
+
+console.write(globalConfig.main.channel.international.name); //uses the cached value
+```
+
 ### Secrets configuration
 Loads the environment variables that contain all secrets for that bot, like your bot token and database credentials. It goes without saying that these actual values may never be git traced. Load new instance of your secret config through the following code: 
 ```js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@somehiddenkey/discord-command-utils",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "A utility library for building Discord bot commands using discord.js",
   "author": {
     "email": "k3y.throwaway@gmail.com",

package/src/Configs/Fetchable.js

@@ -25,6 +25,13 @@ export default class Fetchable {
                     if (prop === "id") 
                         return id;
 
+                    if (prop === "refresh") {
+                        return async () => {
+                            cachedObject = await fetcher(id);
+                            return cachedObject;
+                        };
+                    }
+
                     if (prop === "fetch") {
                         return async () => {
                             if (!cachedObject){
@@ -66,4 +73,13 @@ export default class Fetchable {
             this._config_keys.map((key) => this[key]?.fetch())
         );
     }
+
+    /**
+     * @returns {Promise<void[]>} 
+     */
+    refresh() {
+        return Promise.all(
+            this._config_keys.map((key) => this[key]?.refresh())
+        );
+    }
 }

package/src/Configs/GlobalConfig/GlobalConfigCommunity.js

@@ -2,7 +2,7 @@
  * @typedef {string} Snowflake
  */
 
-import ConfigError from "./ConfigError.js";
+import ConfigError from "../ConfigError.js";
 import pkg from 'discord.js';
 import { GuildBased, ChannelBased, RoleBased } from '../NestedGlobalConfig.js';
 const { GuildBasedChannel } = pkg;

package/src/Configs/GlobalConfig/GlobalConfigMain.js

@@ -2,7 +2,7 @@
  * @typedef {string} Snowflake
  */
 
-import ConfigError from "./ConfigError.js";
+import ConfigError from "../ConfigError.js";
 import pkg from 'discord.js';
 import { GuildBased, ChannelBased, RoleBased } from '../NestedGlobalConfig.js';
 const { GuildBasedChannel } = pkg;
@@ -22,10 +22,10 @@ export default class Guild extends GuildBased {
             throw new ConfigError('No data initialized for GlobalConfig');
 
         super(data);
-        this.categories = new Categories(data.categories, data.id);
-        this.channels = new Channels(data.channels, data.id);
-        this.logs = new Logs(data.logs, data.id);
-        this.roles = new Roles(data.roles, data.id);
+        this.categories = new Categories(data.categories, this.guild);
+        this.channels = new Channels(data.channels, this.guild);
+        this.logs = new Logs(data.logs, this.guild);
+        this.roles = new Roles(data.roles, this.guild);
     }
 }
 

package/src/Configs/GlobalConfig/GlobalConfigStaff.js

@@ -0,0 +1,38 @@
+/**
+ * @typedef {string} Snowflake
+ */
+
+import ConfigError from "../ConfigError.js";
+import pkg from 'discord.js';
+import { GuildBased, ChannelBased, RoleBased } from '../NestedGlobalConfig.js';
+const { GuildBasedChannel } = pkg;
+
+export default class Guild extends GuildBased {
+    /** @type {Categories} */
+    categories;
+    /** @type {Channels} */
+    channels;
+    /** @type {Logs} */
+    logs;
+    /** @type {Roles} */
+    roles;
+
+    constructor(data) {
+        if (!data) 
+            throw new ConfigError('No data initialized for GlobalConfig');
+
+        super(data);
+        this.categories = new Categories(data.categories, data.id);
+        this.channels = new Channels(data.channels, data.id);
+        this.logs = new Logs(data.logs, data.id);
+        this.roles = new Roles(data.roles, data.id);
+    }
+}
+
+class Categories extends ChannelBased {}
+
+class Channels extends ChannelBased {}
+
+class Logs extends ChannelBased {}
+
+class Roles extends RoleBased {}

package/src/Configs/GlobalConfig/GlobalConfigTutor.js

@@ -2,7 +2,7 @@
  * @typedef {string} Snowflake
  */
 
-import ConfigError from "./ConfigError.js";
+import ConfigError from "../ConfigError.js";
 import pkg from 'discord.js';
 import { GuildBased, ChannelBased, RoleBased } from '../NestedGlobalConfig.js';
 const { GuildBasedChannel } = pkg;

package/src/Configs/NestedGlobalConfig.js

@@ -3,8 +3,10 @@
  */
 
 import Fetchable from './Fetchable.js';
+import {Guild} from 'discord.js';
 
 export class GuildBased extends Fetchable {
+    /** @type {Guild} */
     guild;
     categories;
     channels;
@@ -20,13 +22,17 @@ export class GuildBased extends Fetchable {
     }
 
     constructor(data){
-        this._guild = this._createLazyObject(data.id);
+        this.guild = this._createLazyObject(data.id);
         this._config_keys = Object.keys(data).filter(k => k !== 'id').push('guild');
     }
 }
 
 export class ChannelBased extends Fetchable {
-    constructor(data) {
+    /** @type {Guild} */
+    #guild;
+
+    constructor(data, guild) {
+        this.#guild = guild;
         super(data);
     }
 
@@ -35,12 +41,16 @@ export class ChannelBased extends Fetchable {
      * @returns {Proxy}
      */
     _createLazyObject(id) {
-        return super._createLazyObject(id, async (id) => await bot.channels.fetch(id));
+        return super._createLazyObject(id, async (id) => await this.#guild.fetch().then(guild => guild.channels.fetch(id)));
     }
 }
 
 export class RoleBased extends Fetchable {
+    /** @type {Guild} */
+    #guild;
+
     constructor(data) {
+        this.#guild = guild;
         super(data);
     }
 
@@ -49,6 +59,6 @@ export class RoleBased extends Fetchable {
      * @returns {Proxy}
      */
     _createLazyObject(id) {
-        return super._createLazyObject(id, async (id) => await bot.roles.fetch(id));
+        return super._createLazyObject(id, async (id) => await this.#guild.fetch().then(guild => guild.roles.fetch(id)));
     }
 }