discord.fixed.js 1.2.3 → 1.2.4

package/README.md

@@ -1,131 +1,136 @@
 # ⚙️ discord.fixed.js
 
-A **minimal, fast, and opinionated framework** built on top of **discord.js** that removes boilerplate and lets you focus on writing commands — not handlers.
+A **minimal, fast, and opinionated framework** built on top of **discord.js** that removes boilerplate and provides helper utilities for building Discord bots.  
 
-discord.fixed.js is designed to be:
-- Easy to use
-- Hard to misuse
-- Fast to develop with
-- Safe as a library (no forced structure)
+discord.fixed.js is designed to be:  
+- Easy to use  
+- Fast to develop with  
+- Safe as a library (no forced structure)  
+- Compatible with **CJS, ESM (Modern JS), and TypeScript**
 
 ---
 
 ## ✨ Features
 
-• Zero-boilerplate prefix commands  
-• Automatic command & event loading via paths  
-• Built-in message handler (no messageCreate needed)  
-• Recursive folder support  
-• Command aliases  
-• Clean execution flow  
-• Library-safe (paths only, no assumptions)  
-• Future-ready for slash commands  
+- Simplified `Bot` class for Discord.js  
+- Builders for modern Discord interactions:
+  - `EmbedBuilder` — simplified embed construction  
+  - `ComponentBuilder` — build complex component layouts  
+  - `Button`, `Row`, `Select` — quick action row and button handling  
+- Message prototype extensions:
+  - `.reply()`, `.edit()`, `.deleteSafe()`, `.ping()`  
+- Aliases and constants (`I`, `Flags`, `Perms`, `Channels`, etc.)  
+- Fully compatible with **CJS, ESM, and TypeScript**  
+- Includes `.d.ts` typings for TS projects  
 
 ---
 
 ## 📦 Installation
 
+```bash
 npm install discord.fixed.js
+```
 
 ---
 
 ## 🚀 Quick Start
 
-const Bot = require("discord.fixed.js");
+### CommonJS
+
+```js
+const { Bot, EmbedBuilder, Button } = require("discord.fixed.js");
 
 const client = new Bot({
   intents: "all",
-  prefix: "!",
-  commandsPath: "./commands",
-  eventsPath: "./events"
+  owners: ["YOUR_USER_ID"]
 });
 
 client.start("YOUR_BOT_TOKEN");
+```
 
----
+### Modern JS / ESM
 
-## 📁 Recommended Folder Structure
+```js
+import { Bot, EmbedBuilder, Button } from "discord.fixed.js";
 
-project/
-├─ commands/
-│  ├─ ping.js
-│  └─ fun/
-│     └─ hello.js
-│
-├─ events/
-│  └─ ready.js
-│
-└─ index.js
+const client = new Bot({
+  intents: "all",
+  owners: ["YOUR_USER_ID"]
+});
 
----
+client.start("YOUR_BOT_TOKEN");
+```
 
-## 🧩 Prefix Command Example
+### TypeScript
 
-commands/ping.js
+```ts
+import { Bot, EmbedBuilder, Button } from "discord.fixed.js";
 
-module.exports = {
-  name: "ping",
-  aliases: ["p"],
-  execute(client, message, args) {
-    message.reply("Pong!");
-  }
-};
+const client = new Bot({
+  intents: "all",
+  owners: ["YOUR_USER_ID"]
+});
 
-That’s it.  
-No handlers. No listeners. No boilerplate.
+client.start("YOUR_BOT_TOKEN");
+```
 
 ---
 
-## 📡 Event Example
+## 🔧 Builders & Utilities
 
-events/ready.js
+### Embeds
 
-module.exports = {
-  name: "ready",
-  once: true,
-  execute(client) {
-    console.log(`${client.user.tag} is online`);
-  }
-};
+```js
+import { EmbedBuilder } from "discord.fixed.js";
 
-Events are optional.  
-Commands work even if you have **zero event files**.
+const embed = new EmbedBuilder()
+  .title("Hello")
+  .description("This is an embed")
+  .color("Blue");
+```
 
----
+### Components
 
-## ⚙️ How discord.fixed.js Works
+```js
+import { Button, Row, Select } from "discord.fixed.js";
 
-• Commands are auto-loaded from `commandsPath`  
-• Events are auto-loaded from `eventsPath`  
-• Prefix command execution is handled internally  
-• Users never write messageCreate listeners  
-• The framework owns execution & safety  
+const button = new Button().label("Click Me").style("Primary").id("btn_1");
+const row = new Row().add(button);
 
-You write logic — the framework handles the rest.
+const select = new Select().id("menu_1").placeholder("Choose").option("Option 1", "1");
+```
 
----
+### Message Extensions
 
-## 🔐 Error Handling
+```js
+// Works on discord.js Message object
+message.reply("Hello!");
+message.ping();
+message.deleteSafe();
+message.edit("New content");
+```
 
-Errors inside commands are caught automatically.
+---
 
-Example output:
+## ⚙️ How discord.fixed.js Works
 
-[CMD] ping Error: Something went wrong
+- Provides a **lightweight Bot class** for Discord.js  
+- Builders make component, embed, and button creation easier  
+- Adds safe, convenient **message prototype helpers**  
+- Fully compatible with **CJS, ESM, and TypeScript**, including `.d.ts` support  
 
-Custom error hooks will be added in future versions.
+You focus on logic — the library handles convenience utilities.
 
 ---
 
 ## 🧠 Philosophy
 
 discord.fixed.js exists to:
-• Remove Discord.js boilerplate  
-• Enforce clean architecture  
-• Stay small but powerful  
-• Be beginner-friendly and scalable  
 
-If discord.js feels verbose — discord.fixed.js is for you.
+- Remove repetitive boilerplate  
+- Provide clean, safe builders for Discord.js  
+- Stay small but powerful  
+- Be beginner-friendly and scalable  
 
 ---
 

package/package.json

@@ -1,21 +1,35 @@
 {
   "name": "discord.fixed.js",
-  "version": "1.2.3",
-  "description": "An Wrapper for discord developers.",
-  "main": "src/export.js",
+  "version": "1.2.4",
+  "description": "A wrapper for Discord developers",
+  "main": "src/export.cjs",
+  "module": "src/export.mjs",
+  "types": "src/export.d.ts",
+  "exports": {
+    ".": {
+      "import": "./src/export.mjs",
+      "require": "./src/export.cjs"
+    }
+  },
+  "type": "module",
   "scripts": {
+    "build:types": "tsc --declaration --emitDeclarationOnly --allowJs --outDir dist/types",
+    "build": "npm run build:types",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [
     "discord.js",
     "discord",
-    "discord.fixed.js"
+    "discord.fixed.js",
+    "discord library"
   ],
   "author": "synorix.dev",
   "license": "MIT",
-  "dependencies": {
+  "devDependencies": {
     "@types/node": "^22.13.11",
-    "discord.js": "^14.25.1",
-    "npm": "^11.8.0"
+    "typescript": "^5.2.2"
+  },
+  "dependencies": {
+    "discord.js": "^14.25.1"
   }
 }

package/src/Builders/ButtonActionBuilder.cjs

@@ -0,0 +1,51 @@
+const {
+  ButtonBuilder: DjsButtonBuilder,
+  ActionRowBuilder: DjsActionRowBuilder,
+  ButtonStyle,
+  StringSelectMenuBuilder
+} = require("discord.js");
+
+const STYLE_MAP = {
+  blue: ButtonStyle.Primary,
+  primary: ButtonStyle.Primary,
+  green: ButtonStyle.Success,
+  success: ButtonStyle.Success,
+  red: ButtonStyle.Danger,
+  danger: ButtonStyle.Danger,
+  gray: ButtonStyle.Secondary,
+  grey: ButtonStyle.Secondary,
+  secondary: ButtonStyle.Secondary,
+  link: ButtonStyle.Link
+};
+
+class Button extends DjsButtonBuilder {
+  constructor(data) { super(data); }
+  label(value) { this.setLabel(String(value)); return this; }
+  id(value) { this.setCustomId(String(value)); return this; }
+  style(value) {
+    if (typeof value === "string") {
+      const key = value.toLowerCase();
+      this.setStyle(STYLE_MAP[key] ?? ButtonStyle[value]);
+    } else {
+      this.setStyle(value);
+    }
+    return this;
+  }
+  url(value) { this.setURL(String(value)); return this; }
+  emoji(value) { this.setEmoji(value); return this; }
+  disabled(value = true) { this.setDisabled(value); return this; }
+}
+
+class Row extends DjsActionRowBuilder {
+  constructor(data) { super(data); }
+  add(component) { this.addComponents(component); return this; }
+  components(arr = []) { this.addComponents(arr); return this; }
+}
+
+class Select extends StringSelectMenuBuilder {
+  id(i) { return this.setCustomId(i); }
+  placeholder(t) { return this.setPlaceholder(t); }
+  option(l, v, d, e) { return this.addOptions({ label: l, value: v, description: d, emoji: e }); }
+}
+
+module.exports = { Button, Row, Select };

package/src/Builders/ButtonActionBuilder.mjs

@@ -0,0 +1,51 @@
+import {
+  ButtonBuilder as DjsButtonBuilder,
+  ActionRowBuilder as DjsActionRowBuilder,
+  ButtonStyle,
+  StringSelectMenuBuilder
+} from "discord.js";
+
+const STYLE_MAP = {
+  blue: ButtonStyle.Primary,
+  primary: ButtonStyle.Primary,
+  green: ButtonStyle.Success,
+  success: ButtonStyle.Success,
+  red: ButtonStyle.Danger,
+  danger: ButtonStyle.Danger,
+  gray: ButtonStyle.Secondary,
+  grey: ButtonStyle.Secondary,
+  secondary: ButtonStyle.Secondary,
+  link: ButtonStyle.Link
+};
+
+class Button extends DjsButtonBuilder {
+  constructor(data) { super(data); }
+  label(value) { this.setLabel(String(value)); return this; }
+  id(value) { this.setCustomId(String(value)); return this; }
+  style(value) {
+    if (typeof value === "string") {
+      const key = value.toLowerCase();
+      this.setStyle(STYLE_MAP[key] ?? ButtonStyle[value]);
+    } else {
+      this.setStyle(value);
+    }
+    return this;
+  }
+  url(value) { this.setURL(String(value)); return this; }
+  emoji(value) { this.setEmoji(value); return this; }
+  disabled(value = true) { this.setDisabled(value); return this; }
+}
+
+class Row extends DjsActionRowBuilder {
+  constructor(data) { super(data); }
+  add(component) { this.addComponents(component); return this; }
+  components(arr = []) { this.addComponents(arr); return this; }
+}
+
+class Select extends StringSelectMenuBuilder {
+  id(i) { return this.setCustomId(i); }
+  placeholder(t) { return this.setPlaceholder(t); }
+  option(l, v, d, e) { return this.addOptions({ label: l, value: v, description: d, emoji: e }); }
+}
+
+export { Button, Row, Select };

package/src/Builders/ButtonActionBuilder.ts

@@ -0,0 +1,51 @@
+import {
+  ButtonBuilder as DjsButtonBuilder,
+  ActionRowBuilder as DjsActionRowBuilder,
+  ButtonStyle,
+  StringSelectMenuBuilder
+} from "discord.js";
+
+const STYLE_MAP: Record<string, ButtonStyle> = {
+  blue: ButtonStyle.Primary,
+  primary: ButtonStyle.Primary,
+  green: ButtonStyle.Success,
+  success: ButtonStyle.Success,
+  red: ButtonStyle.Danger,
+  danger: ButtonStyle.Danger,
+  gray: ButtonStyle.Secondary,
+  grey: ButtonStyle.Secondary,
+  secondary: ButtonStyle.Secondary,
+  link: ButtonStyle.Link
+};
+
+export class Button extends DjsButtonBuilder {
+  constructor(data?: Partial<DjsButtonBuilder>) {
+    super(data);
+  }
+  label(value: string) { this.setLabel(value); return this; }
+  id(value: string) { this.setCustomId(value); return this; }
+  style(value: string | ButtonStyle) {
+    if (typeof value === "string") {
+      const key = value.toLowerCase();
+      this.setStyle(STYLE_MAP[key] ?? ButtonStyle[value as keyof typeof ButtonStyle]);
+    } else {
+      this.setStyle(value);
+    }
+    return this;
+  }
+  url(value: string) { this.setURL(value); return this; }
+  emoji(value: string | object) { this.setEmoji(value as any); return this; }
+  disabled(value = true) { this.setDisabled(value); return this; }
+}
+
+export class Row extends DjsActionRowBuilder {
+  constructor(data?: Partial<DjsActionRowBuilder>) { super(data); }
+  add(component: any) { this.addComponents(component); return this; }
+  components(arr: any[] = []) { this.addComponents(arr); return this; }
+}
+
+export class Select extends StringSelectMenuBuilder {
+  id(i: string) { return this.setCustomId(i); }
+  placeholder(t: string) { return this.setPlaceholder(t); }
+  option(l: string, v: string, d?: string, e?: any) { return this.addOptions({ label: l, value: v, description: d, emoji: e }); }
+}

package/src/Builders/ComponentBuilder.cjs

@@ -0,0 +1,67 @@
+const {
+  ContainerBuilder,
+  TextDisplayBuilder,
+  SeparatorBuilder,
+  SeparatorSpacingSize,
+  ActionRowBuilder,
+  ButtonBuilder,
+  StringSelectMenuBuilder,
+  MediaGalleryBuilder,
+  MediaGalleryItemBuilder
+} = require("discord.js");
+
+class ComponentBuilder extends ContainerBuilder {
+  constructor() { super(); }
+
+  addText(input) {
+    if (typeof input === "string") {
+      this.addTextDisplayComponents(new TextDisplayBuilder().setContent(input));
+      return this;
+    }
+    if (input instanceof TextDisplayBuilder) {
+      this.addTextDisplayComponents(input);
+      return this;
+    }
+    return this;
+  }
+
+  addSeparator(spacing = "Small") {
+    const map = { Small: SeparatorSpacingSize.Small, Large: SeparatorSpacingSize.Large };
+    this.addSeparatorComponents(new SeparatorBuilder().setSpacing(map[spacing] || SeparatorSpacingSize.Small));
+    return this;
+  }
+
+  addButtons(...buttons) {
+    this.addActionRowComponents(new ActionRowBuilder().addComponents(buttons));
+    return this;
+  }
+
+  addSelect(select) {
+    this.addActionRowComponents(new ActionRowBuilder().addComponents(select));
+    return this;
+  }
+
+  addMedia(items = []) {
+    const gallery = new MediaGalleryBuilder();
+    for (const item of items) {
+      if (typeof item === "string") gallery.addItems(new MediaGalleryItemBuilder().setURL(item));
+      else if (item instanceof MediaGalleryItemBuilder) gallery.addItems(item);
+    }
+    this.addMediaGalleryComponents(gallery);
+    return this;
+  }
+}
+
+const text = content => new TextDisplayBuilder().setContent(content);
+
+module.exports = {
+  ComponentBuilder,
+  text,
+  TextDisplayBuilder,
+  SeparatorBuilder,
+  ActionRowBuilder,
+  ButtonBuilder,
+  StringSelectMenuBuilder,
+  MediaGalleryBuilder,
+  MediaGalleryItemBuilder
+};

package/src/Builders/ComponentBuilder.mjs

@@ -0,0 +1,67 @@
+import {
+  ContainerBuilder,
+  TextDisplayBuilder,
+  SeparatorBuilder,
+  SeparatorSpacingSize,
+  ActionRowBuilder,
+  ButtonBuilder,
+  StringSelectMenuBuilder,
+  MediaGalleryBuilder,
+  MediaGalleryItemBuilder
+} from "discord.js";
+
+class ComponentBuilder extends ContainerBuilder {
+  constructor() { super(); }
+
+  addText(input) {
+    if (typeof input === "string") {
+      this.addTextDisplayComponents(new TextDisplayBuilder().setContent(input));
+      return this;
+    }
+    if (input instanceof TextDisplayBuilder) {
+      this.addTextDisplayComponents(input);
+      return this;
+    }
+    return this;
+  }
+
+  addSeparator(spacing = "Small") {
+    const map = { Small: SeparatorSpacingSize.Small, Large: SeparatorSpacingSize.Large };
+    this.addSeparatorComponents(new SeparatorBuilder().setSpacing(map[spacing] || SeparatorSpacingSize.Small));
+    return this;
+  }
+
+  addButtons(...buttons) {
+    this.addActionRowComponents(new ActionRowBuilder().addComponents(buttons));
+    return this;
+  }
+
+  addSelect(select) {
+    this.addActionRowComponents(new ActionRowBuilder().addComponents(select));
+    return this;
+  }
+
+  addMedia(items = []) {
+    const gallery = new MediaGalleryBuilder();
+    for (const item of items) {
+      if (typeof item === "string") gallery.addItems(new MediaGalleryItemBuilder().setURL(item));
+      else if (item instanceof MediaGalleryItemBuilder) gallery.addItems(item);
+    }
+    this.addMediaGalleryComponents(gallery);
+    return this;
+  }
+}
+
+const text = content => new TextDisplayBuilder().setContent(content);
+
+export {
+  ComponentBuilder,
+  text,
+  TextDisplayBuilder,
+  SeparatorBuilder,
+  ActionRowBuilder,
+  ButtonBuilder,
+  StringSelectMenuBuilder,
+  MediaGalleryBuilder,
+  MediaGalleryItemBuilder
+};

package/src/Builders/ComponentBuilder.ts

@@ -0,0 +1,68 @@
+import {
+  ContainerBuilder,
+  TextDisplayBuilder,
+  SeparatorBuilder,
+  SeparatorSpacingSize,
+  ActionRowBuilder,
+  ButtonBuilder,
+  StringSelectMenuBuilder,
+  MediaGalleryBuilder,
+  MediaGalleryItemBuilder
+} from "discord.js";
+
+export class ComponentBuilder extends ContainerBuilder {
+  constructor() { super(); }
+
+  addText(input: string | TextDisplayBuilder) {
+    if (typeof input === "string") {
+      this.addTextDisplayComponents(new TextDisplayBuilder().setContent(input));
+      return this;
+    }
+    if (input instanceof TextDisplayBuilder) {
+      this.addTextDisplayComponents(input);
+      return this;
+    }
+    return this;
+  }
+
+  addSeparator(spacing: "Small" | "Large" = "Small") {
+    const map: Record<string, SeparatorSpacingSize> = {
+      Small: SeparatorSpacingSize.Small,
+      Large: SeparatorSpacingSize.Large
+    };
+    this.addSeparatorComponents(new SeparatorBuilder().setSpacing(map[spacing] || SeparatorSpacingSize.Small));
+    return this;
+  }
+
+  addButtons(...buttons: any[]) {
+    this.addActionRowComponents(new ActionRowBuilder().addComponents(buttons));
+    return this;
+  }
+
+  addSelect(select: any) {
+    this.addActionRowComponents(new ActionRowBuilder().addComponents(select));
+    return this;
+  }
+
+  addMedia(items: (string | MediaGalleryItemBuilder)[] = []) {
+    const gallery = new MediaGalleryBuilder();
+    for (const item of items) {
+      if (typeof item === "string") gallery.addItems(new MediaGalleryItemBuilder().setURL(item));
+      else if (item instanceof MediaGalleryItemBuilder) gallery.addItems(item);
+    }
+    this.addMediaGalleryComponents(gallery);
+    return this;
+  }
+}
+
+export const text = (content: string) => new TextDisplayBuilder().setContent(content);
+
+export {
+  TextDisplayBuilder,
+  SeparatorBuilder,
+  ActionRowBuilder,
+  ButtonBuilder,
+  StringSelectMenuBuilder,
+  MediaGalleryBuilder,
+  MediaGalleryItemBuilder
+};

package/src/Builders/EmbedBuilder.cjs

@@ -0,0 +1,26 @@
+const { EmbedBuilder: DjsEmbedBuilder } = require("discord.js");
+
+class EmbedBuilder extends DjsEmbedBuilder {
+  constructor(data) { super(data); }
+  title(value) { this.setTitle(String(value)); return this; }
+  addTitle(value) { this.setTitle(String(value)); return this; }
+  description(value) { this.setDescription(String(value)); return this; }
+  addDescription(value) { this.setDescription(String(value)); return this; }
+  color(value) { this.setColor(value); return this; }
+  addColor(value) { this.setColor(value); return this; }
+  author(name, iconURL, url) { this.setAuthor({ name, iconURL, url }); return this; }
+  addAuthor(name, iconURL, url) { this.setAuthor({ name, iconURL, url }); return this; }
+  footer(text, iconURL) { this.setFooter({ text, iconURL }); return this; }
+  addFooter(text, iconURL) { this.setFooter({ text, iconURL }); return this; }
+  thumbnail(url) { this.setThumbnail(url); return this; }
+  addThumbnail(url) { this.setThumbnail(url); return this; }
+  image(url) { this.setImage(url); return this; }
+  addImage(url) { this.setImage(url); return this; }
+  field(name, value, inline = false) { this.addFields({ name: String(name), value: String(value), inline }); return this; }
+  addField(name, value, inline = false) { this.addFields({ name: String(name), value: String(value), inline }); return this; }
+  fields(arr = []) { this.addFields(arr.map(f => ({ name: String(f.name), value: String(f.value), inline: !!f.inline }))); return this; }
+  timestamp(value = Date.now()) { this.setTimestamp(value); return this; }
+  addTime(value = Date.now()) { this.setTimestamp(value); return this; }
+}
+
+module.exports = EmbedBuilder;