@open-discord-bots/framework 0.2.17 → 0.3.1

package/src/api/modules/config.ts

@@ -6,6 +6,7 @@ import nodepath from "path"
 import { ODDebugger } from "./console.js"
 import fs from "fs"
 import * as fjs from "formatted-json-stringify"
+import { jsonc } from "jsonc"
 
 /**## ODConfigManagerIdConstraint `type`
  * The constraint/layout for id mappings/interfaces of the `ODConfigManager` class.
@@ -20,16 +21,18 @@ export type ODConfigManagerIdConstraint = Record<string,ODConfig<any>>
  * You can use this class to get/change/add a config file (`ODConfig`) in your plugin!
  */
 export class ODConfigManager<IdList extends ODConfigManagerIdConstraint = ODConfigManagerIdConstraint> extends ODManager<ODConfig<any>> {
-    /**Alias to Open Discord debugger. */
-    #debug: ODDebugger
-    
     constructor(debug:ODDebugger){
         super(debug,"config")
-        this.#debug = debug
     }
+
     add(data:ODConfig<any>|ODConfig<any>[],overwrite?:boolean): boolean {
-        if (Array.isArray(data)) data.forEach((d) => d.useDebug(this.#debug))
-        else data.useDebug(this.#debug)
+        if (this.debug){
+            if (Array.isArray(data)){
+                for (const d of data){
+                    d.useDebug(this.debug)
+                }
+            }else data.useDebug(this.debug)
+        }
         return super.add(data,overwrite)
     }
     /**Init all config files. */
@@ -71,7 +74,7 @@ export class ODConfigManager<IdList extends ODConfigManagerIdConstraint = ODConf
  * 
  * You can use this class if you want to create your own config implementation (e.g. `yml`, `xml`,...)!
  */
-export class ODConfig<Data extends any> extends ODManagerData {
+export abstract class ODConfig<Data extends any> extends ODManagerData {
     /**The name of the file with extension. */
     file: string = ""
     /**The path to the file relative to the main directory. */
@@ -182,4 +185,80 @@ export class ODJsonConfig<Data extends any> extends ODConfig<Data> {
             throw new ODSystemError("Unable to save config \""+nodepath.join("./",this.path)+"\"!")
         }
     }
+}
+
+/**## ODJsonCommentsConfig `class`
+ * An Open Discord JSONC (`.jsonc`) config.  
+ * Use this class to get & edit variables from the config files or to create your own JSON config!
+ * @example
+ * //create a config from: ./config/test.jsonc with the id "some-config"
+ * const config = new api.ODJsonCommentsConfig("some-config","test.jsonc")
+ * 
+ * //create a config with custom dir: ./plugins/testplugin/test.jsonc
+ * const config = new api.ODJsonCommentsConfig("plugin-config","test.jsonc","./plugins/testplugin/")
+ */
+export class ODJsonCommentsConfig<Data extends any> extends ODConfig<Data> {
+    formatter: fjs.custom.BaseFormatter
+
+    constructor(id:ODValidId, file:string, customPath?:string, formatter?:fjs.custom.BaseFormatter){
+        super(id,{})
+        this.file = (file.endsWith(".jsonc")) ? file : file+".jsonc"
+        this.path = customPath ? nodepath.join("./",customPath,this.file) : nodepath.join("./config/",this.file)
+        this.formatter = formatter ?? new fjs.DefaultFormatter(null,true,"    ")
+    }
+
+    /**Init the config. */
+    init(): ODPromiseVoid {
+        if (!fs.existsSync(this.path)) throw new ODSystemError("Unable to parse JSONC config \""+nodepath.join("./",this.path)+"\", the file doesn't exist!")
+        try{
+            this.data = jsonc.parse(fs.readFileSync(this.path).toString())
+            super.init()
+        }catch(err){
+            process.emit("uncaughtException",err)
+            throw new ODSystemError("Unable to parse JSONC config \""+nodepath.join("./",this.path)+"\"!")
+        }
+    }
+    /**Reload the config. Be aware that this doesn't update the config data everywhere in the bot! */
+    reload(){
+        if (!this.initiated) throw new ODSystemError("Unable to reload JSONC config \""+nodepath.join("./",this.path)+"\", the file hasn't been initiated yet!")
+        if (!fs.existsSync(this.path)) throw new ODSystemError("Unable to JSONC reload config \""+nodepath.join("./",this.path)+"\", the file doesn't exist!")
+        try{
+            this.data = jsonc.parse(fs.readFileSync(this.path).toString())
+            super.reload()
+            this.reloadListeners.forEach((cb) => {
+                try{
+                    cb()
+                }catch(err){
+                    process.emit("uncaughtException",err)
+                }
+            })
+        }catch(err){
+            process.emit("uncaughtException",err)
+            throw new ODSystemError("Unable to reload JSONC config \""+nodepath.join("./",this.path)+"\"!")
+        }
+    }
+    /**Save the edited config to the filesystem. This is used by the Interactive Setup CLI. It's not recommended to use this while the bot is running. */
+    save(): ODPromiseVoid {
+        if (!this.initiated) throw new ODSystemError("Unable to save JSONC config \""+nodepath.join("./",this.path)+"\", the file hasn't been initiated yet!")
+        try{
+            const contents = this.formatter.stringify(this.data as ODValidJsonType)
+            fs.writeFileSync(this.path,contents)
+            super.save()
+        }catch(err){
+            process.emit("uncaughtException",err)
+            throw new ODSystemError("Unable to save JSONC config \""+nodepath.join("./",this.path)+"\"!")
+        }
+    }
+}
+
+/**## ODMemoryConfig `class`
+ * An Open Discord memory config.  
+ * This config lives in-memory and does not have any connection to the filesystem.
+ * 
+ * It is perfect for temporary configs or using the `ODChecker` without a real config file.
+ */
+export class ODMemoryConfig<Data extends any> extends ODConfig<Data> {
+    constructor(id:ODValidId,data:Data){
+        super(id,data)
+    }
 }

package/src/api/modules/console.ts

@@ -278,10 +278,10 @@ export class ODConsoleManager {
             if (this.debugfile) this.debugfile.writeConsoleMessage(newMessage)
             this.history.push(newMessage)
         }
-        this.#purgeHistory()
+        this.purgeHistory()
     }
     /**Shorten the history when it exceeds the max history length! */
-    #purgeHistory(){
+    protected purgeHistory(){
         if (this.history.length > this.historylength) this.history.shift()
     }
 }
@@ -310,16 +310,16 @@ export class ODDebugFileManager {
         this.version = version
         this.maxlines = maxlines
 
-        this.#writeStartupStats()
+        this.writeStartupStats()
     }
 
     /**Check if the debug file exists */
-    #existsDebugFile(){
+    protected existsDebugFile(){
         return fs.existsSync(this.path)
     }
     /**Read from the debug file */
-    #readDebugFile(){
-        if (this.#existsDebugFile()){
+    protected readDebugFile(){
+        if (this.existsDebugFile()){
             try {
                 return fs.readFileSync(this.path).toString()
             }catch{
@@ -330,8 +330,8 @@ export class ODDebugFileManager {
         }
     }
     /**Write to the debug file and shorten it when needed. */
-    #writeDebugFile(text:string){
-        const currenttext = this.#readDebugFile()
+    protected writeDebugFile(text:string){
+        const currenttext = this.readDebugFile()
         if (currenttext){
             const splitted = currenttext.split("\n")
             
@@ -343,12 +343,12 @@ export class ODDebugFileManager {
             fs.writeFileSync(this.path,splitted.join("\n"))
         }else{
             //write new file:
-            const newtext = this.#createStatsText()+text
+            const newtext = this.createStatsText()+text
             fs.writeFileSync(this.path,newtext)
         }
     }
     /**Generate the statistics/header of the debug file (containing the version) */
-    #createStatsText(){
+    protected createStatsText(){
         const date = new Date()
         const dstring = `${date.getDate()}/${date.getMonth()+1}/${date.getFullYear()} ${date.getHours()}:${date.getMinutes()}:${date.getSeconds()}`
         return [
@@ -360,8 +360,8 @@ export class ODDebugFileManager {
         ].join("\n")
     }
     /**Write the statistics/header to the debug file on startup */
-    #writeStartupStats(){
-        const currenttext = this.#readDebugFile()
+    protected writeStartupStats(){
+        const currenttext = this.readDebugFile()
         if (currenttext){
             //edit previous file:
             const splitted = currenttext.split("\n")
@@ -371,31 +371,31 @@ export class ODDebugFileManager {
                 splitted.splice(0,((splitted.length+11) - this.maxlines))
             }
 
-            splitted.unshift(this.#createStatsText())
+            splitted.unshift(this.createStatsText())
             splitted.push("\n---------------------------------------------------------------------\n---------------------------------------------------------------------\n")
             
             fs.writeFileSync(this.path,splitted.join("\n"))
         }else{
             //write new file:
-            const newtext = this.#createStatsText()
+            const newtext = this.createStatsText()
             fs.writeFileSync(this.path,newtext)
         }
     }
     /**Write an `ODConsoleMessage` to the debug file */
     writeConsoleMessage(message:ODConsoleMessage){
-        this.#writeDebugFile(message.toDebugString())
+        this.writeDebugFile(message.toDebugString())
     }
     /**Write an `ODError` to the debug file */
     writeErrorMessage(error:ODError){
-        this.#writeDebugFile(error.toDebugString())
+        this.writeDebugFile(error.toDebugString())
     }
     /**Write custom text to the debug file */
     writeText(text:string){
-        this.#writeDebugFile(text)
+        this.writeDebugFile(text)
     }
     /**Write a custom note to the debug file (starting with `[NOTE]:`) */
     writeNote(text:string){
-        this.#writeDebugFile("[NOTE]: "+text)
+        this.writeDebugFile("[NOTE]: "+text)
     }
 }
 
@@ -597,7 +597,7 @@ export class ODLiveStatusManager<IdList extends ODLiveStatusManagerIdConstraint
     /**The class responsible for rendering the livestatus messages. */
     renderer: ODLiveStatusRenderer
     /**A reference to the ODMain or "opendiscord" global variable */
-    #main: ODMain|null = null
+    protected main: ODMain|null = null
 
     constructor(debug:ODDebugger,console:ODConsoleManager){
         super(debug,"livestatus source")
@@ -606,18 +606,18 @@ export class ODLiveStatusManager<IdList extends ODLiveStatusManagerIdConstraint
 
     /**Get the messages from all sources combined! */
     async getAllMessages(): Promise<ODLiveStatusSourceData[]> {
-        if (!this.#main) throw new ODSystemError("ODLiveStatusManager:getAllMessages() --> Unable to get messages, 'opendiscord/ODMain' has not been connected!")
+        if (!this.main) throw new ODSystemError("ODLiveStatusManager:getAllMessages() --> Unable to get messages, 'opendiscord/ODMain' has not been connected!")
         const messages: ODLiveStatusSourceData[] = []
         for (const source of this.getAll()){
             try {
-                messages.push(...(await source.getMessages(this.#main)))
+                messages.push(...(await source.getMessages(this.main)))
             }catch{}
         }
         return messages
     }
     /**Set the opendiscord `ODMain` class to use for fetching message filters. */
     useMain(main:ODMain){
-        this.#main = main
+        this.main = main
     }
 
     get<LiveStatusId extends keyof ODNoGeneric<IdList>>(id:LiveStatusId): IdList[LiveStatusId]
@@ -649,10 +649,10 @@ export class ODLiveStatusManager<IdList extends ODLiveStatusManagerIdConstraint
  */
 export class ODLiveStatusRenderer {
     /**A reference to the ODConsoleManager or "opendiscord.console" global variable */
-    #console: ODConsoleManager
+    protected console: ODConsoleManager
 
     constructor(console:ODConsoleManager){
-        this.#console = console
+        this.console = console
     }
 
     /**Render all messages */
@@ -688,7 +688,7 @@ export class ODLiveStatusRenderer {
             //return all messages
             return final.join("\n")
         }catch{
-            this.#console.log("Failed to render LiveStatus messages!","error")
+            this.console.log("Failed to render LiveStatus messages!","error")
             return ""
         }
     }

package/src/api/modules/cooldown.ts

@@ -75,7 +75,7 @@ export class ODCooldownData<Data extends object> extends ODManagerData {
  * 
  * There are also premade cooldowns available in the bot!
  */
-export class ODCooldown<Data extends object> extends ODManagerData {
+export abstract class ODCooldown<Data extends object> extends ODManagerData {
     data: ODManager<ODCooldownData<Data>> = new ODManager()
     /**Is this cooldown already initialized? */
     ready: boolean = false
@@ -85,21 +85,16 @@ export class ODCooldown<Data extends object> extends ODManagerData {
     }
 
     /**Check this id and start cooldown when it exeeds the limit! Returns `true` when on cooldown! */
-    use(id:string): boolean {
-        throw new ODSystemError("Tried to use an unimplemented ODCooldown!")
-    }
+    abstract use(id:string): boolean
+    
     /**Check this id without starting or updating the cooldown. Returns `true` when on cooldown! */
-    check(id:string): boolean {
-        throw new ODSystemError("Tried to use an unimplemented ODCooldown!")
-    }
+    abstract check(id:string): boolean
+    
     /**Remove the cooldown for an id when available.*/
-    delete(id:string){
-        throw new ODSystemError("Tried to use an unimplemented ODCooldown!")
-    }
+    abstract delete(id:string): void
+    
     /**Initialize the internal systems of this cooldown. */
-    async init(){
-        throw new ODSystemError("Tried to use an unimplemented ODCooldown!")
-    }
+    abstract init(): Promise<void>|void
 }
 
 /**## ODCounterCooldown `class`

package/src/api/modules/database.ts

@@ -70,50 +70,42 @@ export type ODDatabaseIdConstraint = Record<string,ODValidJsonType>
  * 
  * You can use this class if you want to create your own database implementation (e.g. `mongodb`, `mysql`,...)!
  */
-export class ODDatabase<IdList extends ODDatabaseIdConstraint = ODDatabaseIdConstraint> extends ODManagerData {
+export abstract class ODDatabase<IdList extends ODDatabaseIdConstraint = ODDatabaseIdConstraint> extends ODManagerData {
     /**The name of the file with extension. */
     file: string = ""
     /**The path to the file relative to the main directory. */
     path: string = ""
 
     /**Init the database. */
-    init(): ODPromiseVoid {
-        //nothing
-    }
+    abstract init(): ODPromiseVoid
+    
     /**Add/Overwrite a specific category & key in the database. Returns `true` when overwritten. */
-    set<CategoryId extends keyof ODNoGeneric<IdList>>(category:CategoryId, key:string, value:IdList[CategoryId]): ODOptionalPromise<boolean>
-    set(category:string, key:string, value:ODValidJsonType): ODOptionalPromise<boolean>
-    set(category:string, key:string, value:ODValidJsonType): ODOptionalPromise<boolean> {
-        return false
-    }
+    abstract set<CategoryId extends keyof ODNoGeneric<IdList>>(category:CategoryId, key:string, value:IdList[CategoryId]): ODOptionalPromise<boolean>
+    abstract set(category:string, key:string, value:ODValidJsonType): ODOptionalPromise<boolean>
+    abstract set(category:string, key:string, value:ODValidJsonType): ODOptionalPromise<boolean>
+    
     /**Get a specific category & key in the database */
-    get<CategoryId extends keyof ODNoGeneric<IdList>>(category:CategoryId, key:string): ODOptionalPromise<IdList[CategoryId]|undefined>
-    get(category:string, key:string): ODOptionalPromise<ODValidJsonType|undefined>
-    get(category:string, key:string): ODOptionalPromise<ODValidJsonType|undefined> {
-        return undefined
-    }
+    abstract get<CategoryId extends keyof ODNoGeneric<IdList>>(category:CategoryId, key:string): ODOptionalPromise<IdList[CategoryId]|undefined>
+    abstract get(category:string, key:string): ODOptionalPromise<ODValidJsonType|undefined>
+    abstract get(category:string, key:string): ODOptionalPromise<ODValidJsonType|undefined>
+    
     /**Delete a specific category & key in the database */
-    delete<CategoryId extends keyof ODNoGeneric<IdList>>(category:CategoryId, key:string): ODOptionalPromise<boolean>
-    delete(category:string, key:string): ODOptionalPromise<boolean>
-    delete(category:string, key:string): ODOptionalPromise<boolean> {
-        return false
-    }
+    abstract delete<CategoryId extends keyof ODNoGeneric<IdList>>(category:CategoryId, key:string): ODOptionalPromise<boolean>
+    abstract delete(category:string, key:string): ODOptionalPromise<boolean>
+    abstract delete(category:string, key:string): ODOptionalPromise<boolean>
+    
     /**Check if a specific category & key exists in the database */
-    exists(category:keyof ODNoGeneric<IdList>, key:string): ODOptionalPromise<boolean>
-    exists(category:string, key:string): ODOptionalPromise<boolean>
-    exists(category:string, key:string): ODOptionalPromise<boolean> {
-        return false
-    }
+    abstract exists(category:keyof ODNoGeneric<IdList>, key:string): ODOptionalPromise<boolean>
+    abstract exists(category:string, key:string): ODOptionalPromise<boolean>
+    abstract exists(category:string, key:string): ODOptionalPromise<boolean>
+    
     /**Get a specific category in the database */
-    getCategory<CategoryId extends keyof ODNoGeneric<IdList>>(category:CategoryId): ODOptionalPromise<{key:string, value:IdList[CategoryId]}[]|undefined>
-    getCategory(category:string): ODOptionalPromise<{key:string, value:ODValidJsonType}[]|undefined>
-    getCategory(category:string): ODOptionalPromise<{key:string, value:ODValidJsonType}[]|undefined> {
-        return undefined
-    }
+    abstract getCategory<CategoryId extends keyof ODNoGeneric<IdList>>(category:CategoryId): ODOptionalPromise<{key:string, value:IdList[CategoryId]}[]|undefined>
+    abstract getCategory(category:string): ODOptionalPromise<{key:string, value:ODValidJsonType}[]|undefined>
+    abstract getCategory(category:string): ODOptionalPromise<{key:string, value:ODValidJsonType}[]|undefined>
+    
     /**Get all values in the database */
-    getAll(): ODOptionalPromise<ODJsonDatabaseStructure> {
-        return []
-    }
+    abstract getAll(): ODOptionalPromise<ODJsonDatabaseStructure>
 }
 
 /**## ODJsonDatabaseStructure `type`

package/src/api/modules/event.ts

@@ -17,7 +17,7 @@ export type ODEventCallback = (...args:any) => ODPromiseVoid
  */
 export class ODEvent<Callback extends ODEventCallback = ODEventCallback> extends ODManagerData {
     /**Alias to Open Discord debugger. */
-    #debug?: ODDebugger
+    protected debug?: ODDebugger
     /**The list of permanent listeners. */
     listeners: Function[] = []
     /**The list of one-time listeners. List is cleared every time the event is emitted. */
@@ -27,10 +27,10 @@ export class ODEvent<Callback extends ODEventCallback = ODEventCallback> extends
 
     /**Use the Open Discord debugger in this manager for logs*/
     useDebug(debug:ODDebugger|null){
-        this.#debug = debug ?? undefined
+        this.debug = debug ?? undefined
     }
     /**Get a collection of listeners combined from both types. Also clears the one-time listeners array! */
-    #getCurrentListeners(){
+    protected getCurrentListeners(){
         const final: Function[] = []
         this.oncelisteners.forEach((l) => final.push(l))
         this.listeners.forEach((l) => final.push(l))
@@ -47,7 +47,7 @@ export class ODEvent<Callback extends ODEventCallback = ODEventCallback> extends
         this.listeners.push(callback)
 
         if (this.listeners.length > this.listenerLimit){
-            if (this.#debug) this.#debug.console.log(new ODWarningConsoleMessage("Possible event memory leak detected!",[
+            if (this.debug) this.debug.console.log(new ODWarningConsoleMessage("Possible event memory leak detected!",[
                 {key:"event",value:this.id.value},
                 {key:"listeners",value:this.listeners.length.toString()}
             ]))
@@ -65,7 +65,7 @@ export class ODEvent<Callback extends ODEventCallback = ODEventCallback> extends
     }
     /**Emit this event to all listeners. You are required to provide all parameters of the event! */
     async emit(params:Parameters<Callback>): Promise<void> {
-        for (const listener of this.#getCurrentListeners()){
+        for (const listener of this.getCurrentListeners()){
             try{
                 await listener(...params)
             }catch(err:any){
@@ -89,16 +89,12 @@ export type ODEventManagerIdConstraint = Record<string,ODEvent>
  * All events are available in the `opendiscord.events` global!
  */
 export class ODEventManager<IdList extends ODEventManagerIdConstraint = ODEventManagerIdConstraint> extends ODManager<ODEvent> {
-    /**Reference to the Open Discord debugger */
-    #debug: ODDebugger
-
     constructor(debug:ODDebugger){
         super(debug,"event")
-        this.#debug = debug
     }
 
     add(data:ODEvent, overwrite?:boolean): boolean {
-        data.useDebug(this.#debug)
+        if (this.debug) data.useDebug(this.debug)
         return super.add(data,overwrite)
     }
 

package/src/api/modules/fuse.ts

@@ -44,7 +44,7 @@ export type ODFuseStringArray<FuseList extends object> = {
  */
 export class ODFuseManager<FuseList extends object> {
     /**A list of all the defaults */
-    private fuses: FuseList
+    protected fuses: FuseList
 
     constructor(fuses:FuseList){
         this.fuses = fuses

package/src/api/modules/helpmenu.ts

@@ -4,27 +4,22 @@
 import { ODId, ODManager, ODManagerData, ODNoGeneric, ODSystemError, ODValidId } from "./base.js"
 import { ODDebugger } from "./console.js"
 
-/**## ODHelpMenuComponentRenderer `type`
- * This is the callback of the help menu component renderer. It also contains information about how & where it is rendered.
- */
-export type ODHelpMenuComponentRenderer = (page:number, category:number, location:number, mode:"slash"|"text") => string|Promise<string>
-
 /**## ODHelpMenuComponent `class`
  * This is an Open Discord help menu component.
  * 
  * It can render something on the Open Discord help menu.
  */
-export class ODHelpMenuComponent extends ODManagerData {
+export abstract class ODHelpMenuComponent extends ODManagerData {
     /**The priority of this component. The higher, the earlier it will appear in the help menu. */
     priority: number
-    /**The render function for this component. */
-    render: ODHelpMenuComponentRenderer
 
-    constructor(id:ODValidId, priority:number, render:ODHelpMenuComponentRenderer){
+    constructor(id:ODValidId, priority:number){
         super(id)
         this.priority = priority
-        this.render = render
     }
+
+    /**The render function for this component. */
+    abstract render(page:number, category:number, location:number, mode:"slash"|"text"): string|Promise<string>
 }
 
 /**## ODHelpMenuTextComponent `class`
@@ -33,10 +28,16 @@ export class ODHelpMenuComponent extends ODManagerData {
  * It can render a static piece of text on the Open Discord help menu.
  */
 export class ODHelpMenuTextComponent extends ODHelpMenuComponent {
+    /**The text of this help menu component. */
+    text: string
+
     constructor(id:ODValidId, priority:number, text:string){
-        super(id,priority,() => {
-            return text
-        })
+        super(id,priority)
+        this.text = text
+    }
+
+    render(page:number,category:number,location:number,mode:"slash"|"text"){
+        return this.text
     }
 }
 
@@ -74,20 +75,26 @@ export interface ODHelpMenuCommandComponentSettings {
  * It contains a useful helper to render a command in the Open Discord help menu.
  */
 export class ODHelpMenuCommandComponent extends ODHelpMenuComponent {
+    /**The settings for this help menu component. */
+    settings:ODHelpMenuCommandComponentSettings
+
     constructor(id:ODValidId, priority:number, settings:ODHelpMenuCommandComponentSettings){
-        super(id,priority,(page,category,location,mode) => {
-            if (mode == "slash" && settings.slashName){
-                return `\`${settings.slashName}${(settings.slashOptions) ? this.#renderOptions(settings.slashOptions) : ""}\` ➜ ${settings.slashDescription ?? ""}`
-            
-            }else if (mode == "text" && settings.textName){
-                return `\`${settings.textName}${(settings.textOptions) ? this.#renderOptions(settings.textOptions) : ""}\` ➜ ${settings.textDescription ?? ""}`
-            
-            }else return ""
-        })
+        super(id,priority)
+        this.settings = settings
+    }
+
+    render(page:number,category:number,location:number,mode:"slash"|"text"){
+        if (mode == "slash" && this.settings.slashName){
+            return `\`${this.settings.slashName}${(this.settings.slashOptions) ? this.renderOptions(this.settings.slashOptions) : ""}\` ➜ ${this.settings.slashDescription ?? ""}`
+        
+        }else if (mode == "text" && this.settings.textName){
+            return `\`${this.settings.textName}${(this.settings.textOptions) ? this.renderOptions(this.settings.textOptions) : ""}\` ➜ ${this.settings.textDescription ?? ""}`
+        
+        }else return ""
     }
     
     /**Utility function to render all command options. */
-    #renderOptions(options:ODHelpMenuCommandComponentOption[]){
+    protected renderOptions(options:ODHelpMenuCommandComponentOption[]){
         return " "+options.map((opt) => (opt.optional) ? `[${opt.name}]` : `<${opt.name}>`).join(" ")
     }
 }
@@ -188,18 +195,15 @@ export type ODHelpMenuManagerIdConstraint = Record<string,ODHelpMenuCategory>
  * Fewer Categories == More Clean Menu
  */
 export class ODHelpMenuManager<IdList extends ODHelpMenuManagerIdConstraint = ODHelpMenuManagerIdConstraint> extends ODManager<ODHelpMenuCategory> {
-    /**Alias to Open Discord debugger. */
-    #debug: ODDebugger
     /**The amount of categories per-page. */
     categoriesPerPage: number = 3
     
     constructor(debug:ODDebugger){
         super(debug,"help menu category")
-        this.#debug = debug
     }
 
     add(data:ODHelpMenuCategory, overwrite?:boolean): boolean {
-        data.useDebug(this.#debug,"help menu component")
+        data.useDebug(this.debug,"help menu component")
         return super.add(data,overwrite)
     }
 

package/src/api/modules/language.ts

@@ -40,15 +40,12 @@ export class ODLanguageManager<IdList extends ODLanguageManagerIdConstraint = OD
     current: ODLanguage|null = null
     /**The currently selected backup language. (used when translation missing in current language) */
     backup: ODLanguage|null = null
-    /**An alias to Open Discord debugger. */
-    #debug: ODDebugger
     
     constructor(debug:ODDebugger, presets:boolean){
         super(debug,"language")
-        if (presets) this.add(new ODLanguage("english","english.json"))
-        this.current = presets ? new ODLanguage("english","english.json") : null
-        this.backup = presets ? new ODLanguage("english","english.json") : null
-        this.#debug = debug
+        if (presets) this.add(new ODJsonLanguage("english","english.json"))
+        this.current = presets ? new ODJsonLanguage("english","english.json") : null
+        this.backup = presets ? new ODJsonLanguage("english","english.json") : null
     }
 
     /**Set the current language by providing the ID of a language which is registered in this manager. */
@@ -58,7 +55,7 @@ export class ODLanguageManager<IdList extends ODLanguageManagerIdConstraint = OD
         this.current = this.get(id)
         const languageId = this.current?.id.value ?? "<unknown-id>"
         const languageAutomated = this.current?.metadata?.automated.toString() ?? "<unknown-metadata>"
-        this.#debug.debug("Selected current language",[
+        this.debug?.debug("Selected current language",[
             {key:"id",value:languageId},
             {key:"automated",value:languageAutomated},
         ])
@@ -74,7 +71,7 @@ export class ODLanguageManager<IdList extends ODLanguageManagerIdConstraint = OD
         this.backup = this.get(id)
         const languageId = this.backup?.id.value ?? "<unknown-id>"
         const languageAutomated = this.backup?.metadata?.automated.toString() ?? "<unknown-metadata>"
-        this.#debug.debug("Selected backup language",[
+        this.debug?.debug("Selected backup language",[
             {key:"id",value:languageId},
             {key:"automated",value:languageAutomated},
         ])
@@ -96,7 +93,7 @@ export class ODLanguageManager<IdList extends ODLanguageManagerIdConstraint = OD
     getTranslation(id:TranslationIds): string
     getTranslation(id:string): string|null
     getTranslation(id:string): string|null {
-        if (!this.current) return this.#getBackupTranslation(id)
+        if (!this.current) return this.getBackupTranslation(id)
         
         const splitted = id.split(".")
         let currentObject = this.current.data
@@ -110,10 +107,10 @@ export class ODLanguageManager<IdList extends ODLanguageManagerIdConstraint = OD
         })
 
         if (typeof result == "string") return result
-        else return this.#getBackupTranslation(id)
+        else return this.getBackupTranslation(id)
     }
-    /**Get a backup  translation string by JSON location. (system only) */
-    #getBackupTranslation(id:string): string|null {
+    /**Get a backup translation string by JSON location. (system only) */
+    protected getBackupTranslation(id:string): string|null {
         if (!this.backup) return null
 
         const splitted = id.split(".")
@@ -185,7 +182,7 @@ export class ODLanguageManager<IdList extends ODLanguageManagerIdConstraint = OD
  * 
  * JSON languages should be created using the `ODJsonLanguage` class instead!
  */
-export class ODLanguage extends ODManagerData {
+export abstract class ODLanguage extends ODManagerData {
     /**The name of the file with extension. */
     file: string = ""
     /**The path to the file relative to the main directory. */
@@ -201,9 +198,7 @@ export class ODLanguage extends ODManagerData {
     }
 
     /**Init the language. */
-    init(): ODPromiseVoid {
-        //nothing
-    }
+    abstract init(): ODPromiseVoid
 }
 
 /**## ODJsonLanguage `class`