nv-kit 1.0.2 → 1.0.4

package/ABOUT.md

@@ -0,0 +1,110 @@
+# nv-kit
+
+A beginner-friendly Discord.js command handler framework.
+
+Install once. Build commands instantly.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install nv-kit
+```
+
+---
+
+## 🚀 What is nv-kit?
+
+nv-kit is a structured command handler for Discord.js that simplifies:
+
+- Slash commands
+- Prefix (legacy) commands
+- Cooldowns
+- Permission checks
+- Owner-only commands
+- Test server restriction
+- Optional MongoDB integration
+- Built-in administrative utilities
+
+It removes boilerplate so you can focus on writing commands.
+
+---
+
+## Handler
+
+The handler automatically:
+
+- Registers slash commands
+- Handles interactions
+- Parses arguments
+- Applies cooldowns
+- Validates permissions
+
+---
+
+## ⚙ Command Options
+
+Each command may include:
+
+- description
+- type (SLASH | LEGACY | BOTH)
+- guildOnly
+- testOnly
+- ownerOnly
+- permissions
+- minArgs / maxArgs
+- expectedArgs
+- correctSyntax
+- aliases
+- cooldowns
+- deferReply
+- init()
+- callback()
+
+---
+
+## 🗂 Default Commands
+
+nv-kit includes optional built-in commands:
+
+- prefix
+- togglecommand
+- customcommand
+- delcustomcmd
+- requiredpermissions
+- requiredroles
+- channelcommand
+
+Disable them during initialization:
+
+```js
+new NV({
+  client,
+  disabledDefaultCommands: ["prefix", "togglecommand"]
+});
+```
+
+---
+
+## 🗄 MongoDB
+
+MongoDB is **required**! This is used for:
+
+- Custom prefixes
+- Custom commands
+- Role requirements
+- Command toggling
+- Persistent guild settings
+
+If you do not need dynamic configuration, Mongo can be removed with minor edits.
+
+---
+
+## 👤 Who Is This For?
+
+- Beginners learning Discord.js
+- Developers who want structure without complexity
+- Bots growing beyond single-file scripts
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nv-kit",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Beginner-friendly Discord.js command handler with slash/prefix commands, cooldowns, permissions, and optional MongoDB.",
   "main": "src/index.js",
   "scripts": {

package/src/button-handler/ButtonHandler.js

@@ -0,0 +1,59 @@
+const fs = require("fs")
+const path = require("path")
+
+const getAllFiles = (dir) => {
+  const entries = fs.readdirSync(dir, { withFileTypes: true })
+  let files = []
+
+  for (const ent of entries) {
+    const full = path.join(dir, ent.name)
+    if (ent.isDirectory()) files = files.concat(getAllFiles(full))
+    else if (ent.isFile() && full.endsWith(".js")) files.push(full)
+  }
+
+  return files
+}
+
+class ButtonHandler {
+  constructor(instance, buttonsDir, client) {
+    this._instance = instance
+    this._client = client
+    this._buttons = new Map()
+
+    const abs = path.isAbsolute(buttonsDir)
+      ? buttonsDir
+      : path.join(process.cwd(), buttonsDir)
+
+    if (!fs.existsSync(abs)) {
+      console.warn(`[nv-kit] buttonsDir not found: ${abs}`)
+      return
+    }
+
+    const files = getAllFiles(abs)
+
+    for (const file of files) {
+      delete require.cache[require.resolve(file)]
+      const btn = require(file)
+
+      if (!btn || typeof btn !== "object") continue
+      if (!btn.id || typeof btn.id !== "string") {
+        console.warn(`[nv-kit] Button missing "id" in: ${file}`)
+        continue
+      }
+      if (typeof btn.callback !== "function") {
+        console.warn(`[nv-kit] Button missing "callback" in: ${file}`)
+        continue
+      }
+
+      this._buttons.set(btn.id, btn)
+    }
+
+    console.log(`[nv-kit] Loaded ${this._buttons.size} button handlers.`)
+  }
+
+  getButton(id) {
+    return this._buttons.get(id)
+  }
+}
+
+module.exports = ButtonHandler

package/src/event-handler/events/interactionCreate/isButton/test.js

@@ -1,3 +1,16 @@
-module.exports = (interaction) => {
-  interaction.reply('testing')
-}
+module.exports = async (instance, interaction, client) => {
+  const btn = instance.buttonHandler?.getButton(interaction.customId)
+  if (!btn) return
+
+  try {
+    await btn.callback({ interaction, client, instance })
+  } catch (e) {
+    console.error(`[nv-kit] Button handler error (${interaction.customId})`, e)
+
+    if (!interaction.replied && !interaction.deferred) {
+      await interaction
+        .reply({ content: "Button error.", ephemeral: true })
+        .catch(() => {})
+    }
+  }
+}

package/src/index.js

@@ -4,6 +4,7 @@ const CommandHandler = require('./command-handler/CommandHandler')
 const Cooldowns = require('./util/Cooldowns')
 const EventHandler = require('./event-handler/EventHandler')
 const FeatureHandler = require('./util/FeatureHandler')
+const ButtonHandler = require("./button-handler/ButtonHandler")
 
 class Main {
   constructor(obj) {
@@ -14,6 +15,7 @@ class Main {
     client,
     mongoUri,
     commandsDir,
+    buttonsDir,
     featuresDir,
     testServers = [],
     botOwners = [],
@@ -45,6 +47,10 @@ class Main {
       this._commandHandler = new CommandHandler(this, commandsDir, client)
     }
 
+    if (buttonsDir) {
+  this._buttonHandler = new ButtonHandler(this, buttonsDir, client)
+}
+
     if (featuresDir) {
       new FeatureHandler(this, featuresDir, client)
     }
@@ -72,6 +78,10 @@ class Main {
     return this._commandHandler
   }
 
+  get buttonHandler() {
+  return this._buttonHandler
+}
+
   get eventHandler() {
     return this._eventHandler
   }