chrxmaticc-framework 1.2.1 → 1.4.0

package/core/ChrxRouter.js

@@ -0,0 +1,233 @@
+/**
+ * core/ChrxRouter.js
+ * Global interaction router — register handlers once, auto-routes everything.
+ *
+ * Supports:
+ * - Buttons
+ * - Select menus
+ * - Modal submits
+ * - Context menus
+ *
+ * Usage:
+ * ChrxRouter.init(client);
+ * ChrxRouter.button("ban_confirm", async (i) => i.reply("✅ Banned!"));
+ * ChrxRouter.select("role_select", async (i, values) => i.reply(`Picked: ${values[0]}`));
+ * ChrxRouter.modal("feedback_modal", async (i, values) => i.reply(`Got: ${values.feedback}`));
+ * ChrxRouter.context("Get Avatar", async (i) => i.reply(i.targetUser.displayAvatarURL()));
+ */
+
+const { ComponentType } = require("discord.js");
+
+// ── Route registries ──────────────────────────────────────────────────────
+const buttonRoutes  = new Map(); // customId -> handler
+const selectRoutes  = new Map(); // customId -> handler
+const modalRoutes   = new Map(); // customId -> handler
+const contextRoutes = new Map(); // name     -> handler
+
+// ── Middleware ────────────────────────────────────────────────────────────
+const middlewares = [];
+
+// ── Cooldowns ─────────────────────────────────────────────────────────────
+const cooldowns = new Map(); // `${userId}-${id}` -> timestamp
+
+let _initialized = false;
+
+const ChrxRouter = {
+
+  /**
+   * Initialize the router — call this once after bot is ready.
+   * @param {import("discord.js").Client} client
+   */
+  init(client) {
+    if (_initialized) return;
+    _initialized = true;
+
+    client.on("interactionCreate", async (interaction) => {
+      try {
+        // ── Run middleware ────────────────────────────────────────────────
+        for (const mw of middlewares) {
+          const pass = await mw(interaction);
+          if (pass === false) return; // middleware blocked it
+        }
+
+        // ── Button ────────────────────────────────────────────────────────
+        if (interaction.isButton()) {
+          const handler = ChrxRouter._resolve(buttonRoutes, interaction.customId);
+          if (handler) await handler(interaction);
+          return;
+        }
+
+        // ── Select menu ───────────────────────────────────────────────────
+        if (interaction.isStringSelectMenu()) {
+          const handler = ChrxRouter._resolve(selectRoutes, interaction.customId);
+          if (handler) await handler(interaction, interaction.values);
+          return;
+        }
+
+        // ── Modal submit ──────────────────────────────────────────────────
+        if (interaction.isModalSubmit()) {
+          const handler = ChrxRouter._resolve(modalRoutes, interaction.customId);
+          if (handler) {
+            // Build values object keyed by field customId
+            const values = {};
+            for (const [key, field] of interaction.fields.fields) {
+              values[key] = field.value;
+            }
+            await handler(interaction, values);
+          }
+          return;
+        }
+
+        // ── Context menu ──────────────────────────────────────────────────
+        if (interaction.isContextMenuCommand()) {
+          const handler = contextRoutes.get(interaction.commandName);
+          if (handler) await handler(interaction);
+          return;
+        }
+
+      } catch (err) {
+        console.error("[ChrxRouter] Unhandled error:", err.message);
+        const msg = { content: err.message || "❌ Something went wrong.", ephemeral: true };
+        try {
+          if (interaction.replied || interaction.deferred) {
+            await interaction.followUp(msg);
+          } else {
+            await interaction.reply(msg);
+          }
+        } catch {}
+      }
+    });
+
+    console.log("[ChrxRouter] Initialized — routing all interactions globally.");
+  },
+
+  // ── Internal resolver — supports wildcards ────────────────────────────
+  // e.g. "ban_confirm_*" matches "ban_confirm_123456"
+  _resolve(registry, id) {
+    // Exact match first
+    if (registry.has(id)) return registry.get(id);
+
+    // Wildcard match
+    for (const [pattern, handler] of registry) {
+      if (pattern.endsWith("*") && id.startsWith(pattern.slice(0, -1))) {
+        return handler;
+      }
+    }
+
+    return null;
+  },
+
+  // ═══════════════════════════════════════════════════════════════════════
+  // Registration methods
+  // ═══════════════════════════════════════════════════════════════════════
+
+  /**
+   * Register a button handler.
+   * @param {string}   id       Button customId (supports wildcard e.g. "confirm_*")
+   * @param {Function} handler  async (interaction) => void
+   * @param {object}   [options]
+   * @param {number}   [options.cooldown]   Cooldown in seconds per user
+   * @param {boolean}  [options.ownerOnly]  Restrict to OWNER_ID
+   */
+  button(id, handler, options = {}) {
+    buttonRoutes.set(id, ChrxRouter._wrap(handler, id, options));
+    return ChrxRouter; // chainable
+  },
+
+  /**
+   * Register a select menu handler.
+   * @param {string}   id       Select menu customId
+   * @param {Function} handler  async (interaction, values) => void
+   * @param {object}   [options]
+   */
+  select(id, handler, options = {}) {
+    selectRoutes.set(id, ChrxRouter._wrap(handler, id, options));
+    return ChrxRouter;
+  },
+
+  /**
+   * Register a modal submit handler.
+   * @param {string}   id       Modal customId
+   * @param {Function} handler  async (interaction, values) => void
+   *                            values = { inputId: "user typed value", ... }
+   * @param {object}   [options]
+   */
+  modal(id, handler, options = {}) {
+    modalRoutes.set(id, ChrxRouter._wrap(handler, id, options));
+    return ChrxRouter;
+  },
+
+  /**
+   * Register a context menu handler.
+   * @param {string}   name     Context menu command name
+   * @param {Function} handler  async (interaction) => void
+   */
+  context(name, handler) {
+    contextRoutes.set(name, handler);
+    return ChrxRouter;
+  },
+
+  /**
+   * Remove a registered route.
+   * @param {"button"|"select"|"modal"|"context"} type
+   * @param {string} id
+   */
+  remove(type, id) {
+    const map = { button: buttonRoutes, select: selectRoutes, modal: modalRoutes, context: contextRoutes }[type];
+    if (map) map.delete(id);
+    return ChrxRouter;
+  },
+
+  /**
+   * Add global middleware — runs before every routed interaction.
+   * Return false to block the interaction.
+   * @param {Function} fn  async (interaction) => boolean | void
+   */
+  use(fn) {
+    middlewares.push(fn);
+    return ChrxRouter;
+  },
+
+  /**
+   * List all registered routes (useful for debugging).
+   */
+  list() {
+    return {
+      buttons:  [...buttonRoutes.keys()],
+      selects:  [...selectRoutes.keys()],
+      modals:   [...modalRoutes.keys()],
+      contexts: [...contextRoutes.keys()],
+    };
+  },
+
+  // ── Internal: wrap handler with cooldown + ownerOnly ──────────────────
+  _wrap(handler, id, options = {}) {
+    return async (interaction, ...args) => {
+      // Owner only
+      if (options.ownerOnly && interaction.user.id !== process.env.OWNER_ID) {
+        return interaction.reply({ content: "❌ This is restricted to the bot owner.", ephemeral: true });
+      }
+
+      // Cooldown
+      if (options.cooldown) {
+        const key = `${interaction.user.id}-${id}`;
+        const now = Date.now();
+        if (cooldowns.has(key)) {
+          const remaining = (options.cooldown * 1000) - (now - cooldowns.get(key));
+          if (remaining > 0) {
+            return interaction.reply({
+              content: `⏱ Wait **${(remaining / 1000).toFixed(1)}s** before doing that again.`,
+              ephemeral: true,
+            });
+          }
+        }
+        cooldowns.set(key, now);
+        setTimeout(() => cooldowns.delete(key), options.cooldown * 1000);
+      }
+
+      await handler(interaction, ...args);
+    };
+  },
+};
+
+module.exports = ChrxRouter;

package/core/ChrxTimedReply.js

@@ -0,0 +1,50 @@
+/**
+ * core/ChrxTimedReply.js
+ * Extended deferReply — keeps the interaction alive for a custom duration
+ * and handles the reply automatically when your function resolves.
+ *
+ * Usage:
+ * await ChrxTimedReply(interaction, async () => "Pong!");
+ * await ChrxTimedReply(interaction, async () => ({ content: "Pong!", ephemeral: true }));
+ * await ChrxTimedReply(interaction, async () => ({ embeds: [myEmbed] }));
+ */
+
+/**
+ * @param {import("discord.js").CommandInteraction} interaction
+ * @param {Function} handler  Async function that returns a string, object, or EmbedBuilder
+ * @param {object}  [options]
+ * @param {boolean} [options.ephemeral]  Defer as ephemeral (default: false)
+ */
+async function ChrxTimedReply(interaction, handler, options = {}) {
+  // Defer immediately to keep the interaction token alive
+  await interaction.deferReply({ ephemeral: options.ephemeral ?? false });
+
+  try {
+    const result = await handler();
+
+    if (!result) return;
+
+    // ── Normalize result into a payload ───────────────────────────────────
+    let payload = {};
+
+    if (typeof result === "string") {
+      payload.content = result;
+    } else if (result?.setTitle || result?.data?.title) {
+      // EmbedBuilder instance
+      payload.embeds = [result];
+    } else {
+      // Plain object — pass through as-is
+      payload = result;
+    }
+
+    await interaction.editReply(payload);
+
+  } catch (err) {
+    console.error("[ChrxTimedReply] Handler error:", err);
+    await interaction.editReply({
+      content: err.message || "❌ Something went wrong.",
+    }).catch(() => {});
+  }
+}
+
+module.exports = ChrxTimedReply;

package/index.js

@@ -1,24 +1,30 @@
 /**
- * index.js (not for a discord bot)
- * Main entry point, will ALWAYS export everything.
- * Listen to Project4play / SVJ at SoundCloud NOW! 
+ * index.js
+ * Main entry point — exports everything.
  */
 
-const { ChrxClient } = require("./core/Client");
-const Database = require("./core/Database");
-const XPSystem = require("./core/XPSystem");
-const AIWrapper = require("./core/AIWrapper");
-const MusicManager = require("./core/MusicManager");
-const ChrxCommandBuilder = require("./core/ChrxCommandBuilder");
+const { ChrxClient }         = require("./core/Client");
+const Database               = require("./core/Database");
+const XPSystem               = require("./core/XPSystem");
+const AIWrapper              = require("./core/AIWrapper");
+const MusicManager           = require("./core/MusicManager");
+const ChrxCommandBuilder     = require("./core/ChrxCommandBuilder");
+const ChrxTimedReply         = require("./core/ChrxTimedReply");
+const ChrxRouter             = require("./core/ChrxRouter");
+const { ChrxEmbedBuilder, EmbedTrigger }                = require("./core/ChrxEmbedBuilder");
+const { ChrxModalBuilder, ModalTrigger, onModalSubmit } = require("./core/ChrxModalBuilder");
 const {
-  parseTime,
-  formatTime,
-  setMarker,
-  getMarkers,
-  clearMarker,
-  applyStartMarker,
-  startEndMarkerWatcher,
-  stopEndMarkerWatcher,
+  ChrxButton, ChrxSelectMenu, ChrxPagination,
+  ChrxContextMenu, ChrxMenu, ChrxForm, ChrxConfirm,
+} = require("./core/ChrxComponentsV3");
+const {
+  ChrxReply, ChrxDeferReply, ChrxEditReply,
+  ChrxFollowUp, ChrxFetchReply, ChrxSilentReply,
+  ChrxAutoReply, ChrxThinkReply,
+} = require("./core/ChrxReply");
+const {
+  parseTime, formatTime, setMarker, getMarkers,
+  clearMarker, applyStartMarker, startEndMarkerWatcher, stopEndMarkerWatcher,
 } = require("./core/songMarkers");
 
 // ── Plugins ───────────────────────────────────────────────────────────────
@@ -36,6 +42,34 @@ module.exports = {
   // Core
   ChrxClient,
   ChrxCommandBuilder,
+  ChrxRouter,
+
+  // Reply system
+  ChrxReply,
+  ChrxDeferReply,
+  ChrxEditReply,
+  ChrxFollowUp,
+  ChrxFetchReply,
+  ChrxSilentReply,
+  ChrxAutoReply,
+  ChrxThinkReply,
+  ChrxTimedReply,
+
+  // Embed & Modal
+  ChrxEmbedBuilder,
+  EmbedTrigger,
+  ChrxModalBuilder,
+  ModalTrigger,
+  onModalSubmit,
+
+  // Components V3
+  ChrxButton,
+  ChrxSelectMenu,
+  ChrxPagination,
+  ChrxContextMenu,
+  ChrxMenu,
+  ChrxForm,
+  ChrxConfirm,
 
   // Modules
   Database,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrxmaticc-framework",
-  "version": "1.2.1",
+  "version": "1.4.0",
   "description": "A batteries-included Discord bot framework with music, AI, XP and database support.",
   "main": "index.js",
   "files": [