seedcord 0.5.1 → 0.6.2

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import 'reflect-metadata';
 import { Logger, ShutdownPhase, CoordinatedShutdown, CoordinatedStartup, HealthCheck, StartupPhase } from '@seedcord/services';
 export * from '@seedcord/services';
-import chalk4 from 'chalk';
+import chalk3 from 'chalk';
 import { SeparatorBuilder, SectionBuilder, MediaGalleryBuilder, FileBuilder, TextDisplayBuilder, ContainerBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder, ChannelSelectMenuBuilder, UserSelectMenuBuilder, StringSelectMenuOptionBuilder, StringSelectMenuBuilder, ButtonBuilder, FileUploadBuilder, TextInputBuilder, LabelBuilder, ModalBuilder, EmbedBuilder, SlashCommandSubcommandGroupBuilder, SlashCommandSubcommandBuilder, ContextMenuCommandBuilder, SlashCommandBuilder, InteractionContextType, ActionRowBuilder, Collection, MessageFlags, Events, Client, WebhookClient, AttachmentBuilder, SeparatorSpacingSize, DiscordAPIError, SnowflakeUtil, Role, PermissionFlagsBits, ChatInputCommandInteraction, AutocompleteInteraction, Message, TextChannel, Guild, RESTJSONErrorCodes, Colors } from 'discord.js';
 import { Envapt } from 'envapt';
 import { hexToNumber, traverseDirectory, filterCirculars, prettify } from '@seedcord/utils';
@@ -11,69 +11,21 @@ import { EventEmitter } from 'events';
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-var Plugin = class {
-  static {
-    __name(this, "Plugin");
-  }
-  pluggable;
-  constructor(pluggable) {
-    this.pluggable = pluggable;
-  }
-};
-var Pluggable = class _Pluggable {
-  static {
-    __name(this, "Pluggable");
-  }
-  isInitialized = false;
-  shutdown;
-  startup;
-  static PLUGIN_INIT_TIMEOUT_MS = 15e3;
-  constructor(shutdown, startup) {
-    this.shutdown = shutdown;
-    this.startup = startup;
-  }
-  async init() {
-    if (this.isInitialized) return this;
-    await this.startup.run();
-    this.isInitialized = true;
-    return this;
-  }
-  /**
-   * Attaches a plugin to this instance
-   *
-   * Plugins provide external functionality and are initialized during the specified startup phase.
-   * The plugin instance becomes available as a property in `core` wherever it's available.
-   *
-   * Make sure to augment the {@link Core} interface with the plugin type to ensure TypeScript recognizes it and provides intellisense.
-   *
-   * @typeParam Key - The property name for accessing the plugin
-   * @typeParam Ctor - The plugin constructor type
-   * @param key - Property name to access the plugin instance
-   * @param Plugin - Plugin constructor class
-   * @param startupPhase - When during startup to initialize this plugin ({@link StartupPhase})
-   * @param args - Additional arguments to pass to the plugin constructor
-   * @returns This instance with the plugin attached as a typed property
-   * @throws An {@link Error} When called after initialization or if key already exists
-   * @example
-   * ```typescript
-   * seedcord.attach('db', Mongo, StartupPhase.Configuration, { uri: 'mongodb://...', name: 'seedcord', dir: ... })
-   * ```
-   */
-  attach(key, Plugin2, startupPhase, ...args) {
-    if (this.isInitialized) throw new Error("Cannot attach a plugin after initialization.");
-    if (this[key]) throw new Error(`Plugin with key "${key}" already exists.`);
-    const instance = new Plugin2(this, ...args);
-    const entry = {
-      [key]: instance
+
+// src/bot/decorators/Command.ts
+var CommandMetadataKey = Symbol("command:metadata");
+function RegisterCommand(scope, guilds = []) {
+  return (ctor) => {
+    const meta = scope === "global" ? {
+      scope
+    } : {
+      scope,
+      guilds
     };
-    this.startup.addTask(startupPhase, `Plugin:${key}`, async () => {
-      instance.logger.info(chalk4.bold("Initializing"));
-      await instance.init();
-      instance.logger.info(chalk4.bold("Initialized"));
-    }, _Pluggable.PLUGIN_INIT_TIMEOUT_MS);
-    return Object.assign(this, entry);
-  }
-};
+    Reflect.defineMetadata(CommandMetadataKey, meta, ctor);
+  };
+}
+__name(RegisterCommand, "RegisterCommand");
 function parseEnvColor(raw, fallback) {
   if (!raw) return fallback;
   const toHex = /* @__PURE__ */ __name((n) => `#${n.toString(16).padStart(6, "0")}`, "toHex");
@@ -251,21 +203,6 @@ var CustomError = class extends Error {
   }
 };
 
-// src/bot/decorators/Command.ts
-var CommandMetadataKey = Symbol("command:metadata");
-function RegisterCommand(scope, guilds = []) {
-  return (ctor) => {
-    const meta = scope === "global" ? {
-      scope
-    } : {
-      scope,
-      guilds
-    };
-    Reflect.defineMetadata(CommandMetadataKey, meta, ctor);
-  };
-}
-__name(RegisterCommand, "RegisterCommand");
-
 // src/bot/controllers/CommandRegistry.ts
 var CommandRegistry = class {
   static {
@@ -282,9 +219,9 @@ var CommandRegistry = class {
   async init() {
     if (this.isInitialised) return;
     this.isInitialised = true;
-    this.logger.info(chalk4.bold(this.core.config.bot.commands.path));
+    this.logger.info(chalk3.bold(this.core.config.bot.commands.path));
     await this.loadCommands(this.core.config.bot.commands.path);
-    this.logger.info(`${chalk4.bold.green("Loaded")}: ${chalk4.magenta.bold(this.globalCommands.length)} global, ${chalk4.magenta.bold(this.guildCommands.size)} guild groups`);
+    this.logger.info(`${chalk3.bold.green("Loaded")}: ${chalk3.magenta.bold(this.globalCommands.length)} global, ${chalk3.magenta.bold(this.guildCommands.size)} guild groups`);
   }
   async loadCommands(dir) {
     await traverseDirectory(dir, (_full, rel, mod) => {
@@ -303,24 +240,24 @@ var CommandRegistry = class {
     const commandType = comp instanceof SlashCommandBuilder ? "slash command" : "context menu command";
     if (meta.scope === "global") {
       this.globalCommands.push(comp);
-      this.logger.info(`${chalk4.italic("Registered")} ${chalk4.bold.yellow(ctor.name)} from ${chalk4.gray(rel)}`);
-      this.logger.info(`  \u2192 Global ${commandType}: ${chalk4.bold.cyan(comp.name)}`);
+      this.logger.info(`${chalk3.italic("Registered")} ${chalk3.bold.yellow(ctor.name)} from ${chalk3.gray(rel)}`);
+      this.logger.info(`\u2192 Global ${commandType}: ${chalk3.bold.cyan(comp.name)}`);
     } else {
       for (const g of meta.guilds) {
         const arr = this.guildCommands.get(g) ?? [];
         arr.push(comp);
         this.guildCommands.set(g, arr);
       }
-      this.logger.info(`${chalk4.italic("Registered")} ${chalk4.bold.yellow(ctor.name)} from ${chalk4.gray(rel)}`);
-      this.logger.info(`  \u2192 Guild ${commandType}: ${chalk4.bold.cyan(comp.name)} for ${chalk4.magenta.bold(meta.guilds.length)} guild(s)`);
+      this.logger.info(`${chalk3.italic("Registered")} ${chalk3.bold.yellow(ctor.name)} from ${chalk3.gray(rel)}`);
+      this.logger.info(`\u2192 Guild ${commandType}: ${chalk3.bold.cyan(comp.name)} for ${chalk3.magenta.bold(meta.guilds.length)} guild(s)`);
     }
   }
   async setCommands() {
     if (this.globalCommands.length > 0) {
       await this.core.bot.client.application?.commands.set(this.globalCommands);
       const tag = this.globalCommands.length === 1 ? "command" : "commands";
-      this.logger.info(`${chalk4.bold.green("Configured")} ${chalk4.magenta.bold(this.globalCommands.length)} global ${tag}`);
-      this.logger.info(` \u2192 ${this.globalCommands.map((command) => chalk4.bold.cyan(command.name)).join(", ")}`);
+      this.logger.info(`${chalk3.bold.green("Configured")} ${chalk3.magenta.bold(this.globalCommands.length)} global ${tag}`);
+      this.logger.info(`\u2192 ${this.globalCommands.map((command) => chalk3.bold.cyan(command.name)).join(", ")}`);
     }
     for (const [guildId, commands] of this.guildCommands.entries()) {
       const guild = this.core.bot.client.guilds.cache.get(guildId);
@@ -330,12 +267,62 @@ var CommandRegistry = class {
       }
       await guild.commands.set(commands);
       const tag = commands.length === 1 ? "command" : "commands";
-      this.logger.info(`${chalk4.bold.green("Configured")} ${chalk4.magenta.bold(commands.length)} ${tag} for guild ${chalk4.bold.yellow(guild.name)}`);
-      this.logger.info(` \u2192 ${commands.map((command) => chalk4.bold.cyan(command.name)).join(", ")}`);
+      this.logger.info(`${chalk3.bold.green("Configured")} ${chalk3.magenta.bold(commands.length)} ${tag} for guild ${chalk3.bold.yellow(guild.name)}`);
+      this.logger.info(` \u2192 ${commands.map((command) => chalk3.bold.cyan(command.name)).join(", ")}`);
     }
   }
 };
 
+// src/bot/decorators/Events.ts
+var EventMetadataKey = Symbol("event:metadata");
+function RegisterEvent(events, options) {
+  return function(constructor) {
+    const saved = Reflect.getMetadata(EventMetadataKey, constructor);
+    const existing = saved ?? [];
+    const toStore = Array.isArray(events) ? events : [
+      events
+    ];
+    const frequency = options?.frequency ?? "on";
+    const entries = toStore.map((event) => ({
+      event,
+      frequency
+    }));
+    Reflect.defineMetadata(EventMetadataKey, [
+      ...existing,
+      ...entries
+    ], constructor);
+  };
+}
+__name(RegisterEvent, "RegisterEvent");
+
+// src/bot/decorators/Middlewares.ts
+var MiddlewareType = /* @__PURE__ */ (function(MiddlewareType2) {
+  MiddlewareType2["Interaction"] = "middleware:interaction";
+  MiddlewareType2["Event"] = "middleware:event";
+  return MiddlewareType2;
+})({});
+var MiddlewareMetadataKey = Symbol("middleware:metadata");
+function Middleware(type, priority = 0, options = {}) {
+  return (ctor) => {
+    const normalizedPriority = Number(priority);
+    if (!Number.isFinite(normalizedPriority)) {
+      throw new TypeError("Middleware priority must be a finite number");
+    }
+    if (type === "middleware:interaction" && options.events?.length) {
+      throw new Error("Interaction middleware cannot specify event filters");
+    }
+    const metadata = {
+      priority: normalizedPriority,
+      type,
+      ...options.events ? {
+        events: options.events
+      } : {}
+    };
+    Reflect.defineMetadata(MiddlewareMetadataKey, metadata, ctor);
+  };
+}
+__name(Middleware, "Middleware");
+
 // src/interfaces/Handler.ts
 var BaseHandler = class {
   static {
@@ -435,51 +422,6 @@ function areRoutes(routes) {
 }
 __name(areRoutes, "areRoutes");
 
-// src/bot/decorators/Events.ts
-var EventMetadataKey = Symbol("event:metadata");
-function RegisterEvent(events) {
-  return function(constructor) {
-    const saved = Reflect.getMetadata(EventMetadataKey, constructor);
-    const existing = areRoutes(saved) ? saved : [];
-    const toStore = Array.isArray(events) ? events : [
-      events
-    ];
-    Reflect.defineMetadata(EventMetadataKey, [
-      ...existing,
-      ...toStore
-    ], constructor);
-  };
-}
-__name(RegisterEvent, "RegisterEvent");
-
-// src/bot/decorators/Middlewares.ts
-var MiddlewareType = /* @__PURE__ */ (function(MiddlewareType2) {
-  MiddlewareType2["Interaction"] = "middleware:interaction";
-  MiddlewareType2["Event"] = "middleware:event";
-  return MiddlewareType2;
-})({});
-var MiddlewareMetadataKey = Symbol("middleware:metadata");
-function Middleware(type, priority = 0, options = {}) {
-  return (ctor) => {
-    const normalizedPriority = Number(priority);
-    if (!Number.isFinite(normalizedPriority)) {
-      throw new TypeError("Middleware priority must be a finite number");
-    }
-    if (type === "middleware:interaction" && options.events?.length) {
-      throw new Error("Interaction middleware cannot specify event filters");
-    }
-    const metadata = {
-      priority: normalizedPriority,
-      type,
-      ...options.events ? {
-        events: options.events
-      } : {}
-    };
-    Reflect.defineMetadata(MiddlewareMetadataKey, metadata, ctor);
-  };
-}
-__name(Middleware, "Middleware");
-
 // src/bot/controllers/EventController.ts
 var EventController = class {
   static {
@@ -499,27 +441,27 @@ var EventController = class {
     }
     this.isInitialized = true;
     const handlersDir = this.core.config.bot.events.path;
-    this.logger.info(chalk4.bold(handlersDir));
+    this.logger.info(chalk3.bold(handlersDir));
     const middlewareDir = this.core.config.bot.events.middlewares;
     if (middlewareDir) {
-      this.logger.info(`${chalk4.bold(middlewareDir)} ${chalk4.gray("(middlewares)")}`);
+      this.logger.info(`${chalk3.bold(middlewareDir)} ${chalk3.gray("(middlewares)")}`);
       await this.loadMiddlewares(middlewareDir);
     }
     await this.loadHandlers(handlersDir);
     this.attachToClient();
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.middlewares.length)} middlewares`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.middlewares.length)} middlewares`);
     const loadedEventsArray = [];
     this.eventMap.forEach((handlers, eventName) => {
-      loadedEventsArray.push(`${chalk4.magenta.bold(handlers.length)} ${eventName}`);
+      loadedEventsArray.push(`${chalk3.magenta.bold(handlers.length)} ${eventName}`);
     });
-    this.logger.info(`${chalk4.bold.green("Loaded")}: ${this.eventMap.size > 0 ? loadedEventsArray.join(", ") : "none"}`);
+    this.logger.info(`${chalk3.bold.green("Loaded")}: ${this.eventMap.size > 0 ? loadedEventsArray.join(", ") : "none"}`);
   }
   async loadHandlers(dir) {
     await traverseDirectory(dir, (_fullPath, relativePath, imported) => {
       for (const val of Object.values(imported)) {
         if (!this.isEventHandlerClass(val)) continue;
         this.registerHandler(val);
-        this.logger.info(`${chalk4.italic("Registered")} ${chalk4.bold.yellow(val.name)} from ${chalk4.gray(relativePath)}`);
+        this.logger.info(`${chalk3.italic("Registered")} ${chalk3.bold.yellow(val.name)} from ${chalk3.gray(relativePath)}`);
       }
     }, this.logger);
   }
@@ -544,7 +486,7 @@ var EventController = class {
       } : {}
     });
     this.middlewares.sort((a, b) => a.priority - b.priority);
-    this.logger.info(`${chalk4.italic("Registered event middleware")} ${chalk4.bold.yellow(middlewareCtor.name)} ${chalk4.gray(`(priority ${metadata.priority})`)} from ${chalk4.gray(relativePath)}`);
+    this.logger.info(`${chalk3.italic("Registered event middleware")} ${chalk3.bold.yellow(middlewareCtor.name)} ${chalk3.gray(`(priority ${metadata.priority})`)} from ${chalk3.gray(relativePath)}`);
   }
   async runMiddlewares(eventName, args) {
     for (const { ctor, events } of this.middlewares) {
@@ -572,6 +514,21 @@ var EventController = class {
   }
   registerHandler(handlerClass) {
     const raw = Reflect.getMetadata(EventMetadataKey, handlerClass);
+    if (Array.isArray(raw)) {
+      for (const entry of raw) {
+        const key = entry.event;
+        let handlers = this.eventMap.get(key);
+        if (!handlers) {
+          handlers = [];
+          this.eventMap.set(key, handlers);
+        }
+        handlers.push({
+          ctor: handlerClass,
+          frequency: entry.frequency
+        });
+      }
+      return;
+    }
     const names = areRoutes(raw) ? raw : typeof raw === "string" ? [
       raw
     ] : [];
@@ -583,38 +540,47 @@ var EventController = class {
         handlers = [];
         this.eventMap.set(key, handlers);
       }
-      handlers.push(handlerClass);
+      handlers.push({
+        ctor: handlerClass,
+        frequency: "on"
+      });
     }
   }
   attachToClient() {
-    for (const [eventName] of this.eventMap) {
-      this.logger.debug(`Attaching ${chalk4.bold.green(eventName)} to ${chalk4.bold.yellow(this.core.bot.client.user?.username)}`);
-      this.core.bot.client.on(eventName, (...args) => {
-        void (async () => {
-          await this.processEvent(eventName, args);
-        })();
-      });
+    for (const [eventName, handlerEntries] of this.eventMap) {
+      this.logger.debug(`Attaching ${chalk3.bold.green(eventName)} to ${chalk3.bold.yellow(this.core.bot.client.user?.username)}`);
+      for (const entry of handlerEntries) {
+        const register = entry.frequency === "once" ? this.core.bot.client.once.bind(this.core.bot.client) : this.core.bot.client.on.bind(this.core.bot.client);
+        register(eventName, (...args) => {
+          void (async () => {
+            await this.processEvent(eventName, args, entry.ctor);
+          })();
+        });
+      }
     }
   }
-  async processEvent(eventName, args) {
+  async processEvent(eventName, args, specificHandler) {
     const shouldContinue = await this.runMiddlewares(eventName, args);
     if (!shouldContinue) return;
-    const handlerCtors = this.eventMap.get(eventName);
-    if (!handlerCtors || handlerCtors.length === 0) return;
-    for (const HandlerCtor of handlerCtors) {
-      try {
-        this.logger.debug(`Processing ${chalk4.bold.green(eventName)} with ${chalk4.gray(HandlerCtor.name)}`);
-        const handler = new HandlerCtor(args, this.core);
-        if (handler.hasChecks()) {
-          await handler.runChecks();
-        }
-        if (handler.shouldBreak()) return;
-        if (!handler.hasErrors()) {
-          await handler.execute();
-        }
-      } catch (err) {
-        this.logger.error(`Error in event ${String(eventName)} handler ${HandlerCtor.name}:`, err);
-      }
+    if (specificHandler) {
+      await this.processHandler(eventName, specificHandler, args);
+      return;
+    }
+    const handlerEntries = this.eventMap.get(eventName);
+    if (!handlerEntries || handlerEntries.length === 0) return;
+    for (const entry of handlerEntries) {
+      await this.processHandler(eventName, entry.ctor, args);
+    }
+  }
+  async processHandler(eventName, ctor, args) {
+    try {
+      this.logger.debug(`Processing ${chalk3.bold.green(eventName)} with ${chalk3.gray(ctor.name)}`);
+      const handler = new ctor(args, this.core);
+      if (handler.hasChecks()) await handler.runChecks();
+      if (handler.shouldBreak()) return;
+      if (!handler.hasErrors()) await handler.execute();
+    } catch (err) {
+      this.logger.error(`Error in event ${String(eventName)} handler ${ctor.name}:`, err);
     }
   }
 };
@@ -711,6 +677,26 @@ function storeMetadata(symbol, routes, constructor) {
   Reflect.defineMetadata(InteractionMetadataKey, true, constructor);
 }
 __name(storeMetadata, "storeMetadata");
+function buildSlashRoute(arg1, arg2, arg3) {
+  let command;
+  let sub;
+  let group;
+  if (typeof arg1 === "string") {
+    command = arg1;
+    sub = arg2;
+    group = arg3;
+  } else if (arg1 instanceof ChatInputCommandInteraction || arg1 instanceof AutocompleteInteraction) {
+    command = arg1.commandName;
+    group = arg1.options.getSubcommandGroup(false) ?? void 0;
+    sub = arg1.options.getSubcommand(false) ?? void 0;
+  } else {
+    throw new TypeError("Invalid argument passed to buildSlashRoute");
+  }
+  if (sub && group) return `${command}/${group}/${sub}`;
+  if (sub) return `${command}/${sub}`;
+  return command;
+}
+__name(buildSlashRoute, "buildSlashRoute");
 
 // src/bot/errors/Database.ts
 var DatabaseError = class extends CustomError {
@@ -876,26 +862,6 @@ _ts_decorate3([
   _ts_metadata3("design:paramtypes", []),
   _ts_metadata3("design:returntype", Promise)
 ], UnhandledEvent.prototype, "execute", null);
-function buildSlashRoute(arg1, arg2, arg3) {
-  let command;
-  let sub;
-  let group;
-  if (typeof arg1 === "string") {
-    command = arg1;
-    sub = arg2;
-    group = arg3;
-  } else if (arg1 instanceof ChatInputCommandInteraction || arg1 instanceof AutocompleteInteraction) {
-    command = arg1.commandName;
-    group = arg1.options.getSubcommandGroup(false) ?? void 0;
-    sub = arg1.options.getSubcommand(false) ?? void 0;
-  } else {
-    throw new TypeError("Invalid argument passed to buildSlashRoute");
-  }
-  if (sub && group) return `${command}/${group}/${sub}`;
-  if (sub) return `${command}/${sub}`;
-  return command;
-}
-__name(buildSlashRoute, "buildSlashRoute");
 
 // src/bot/controllers/InteractionController.ts
 var InteractionController = class {
@@ -929,34 +895,34 @@ var InteractionController = class {
     if (this.isInitialized) return;
     this.isInitialized = true;
     const handlersDir = this.core.config.bot.interactions.path;
-    this.logger.info(chalk4.bold(handlersDir));
+    this.logger.info(chalk3.bold(handlersDir));
     const middlewareDir = this.core.config.bot.interactions.middlewares;
     if (middlewareDir) {
-      this.logger.info(`${chalk4.bold(middlewareDir)} ${chalk4.gray("(middlewares)")}`);
+      this.logger.info(`${chalk3.bold(middlewareDir)} ${chalk3.gray("(middlewares)")}`);
       await this.loadMiddlewares(middlewareDir);
     }
     await this.loadHandlers(handlersDir);
     this.attachToClient();
-    this.logger.info(`${chalk4.bold.green("Loaded interaction handlers:")}`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.middlewares.length)} middlewares`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.slashMap.size)} slash commands`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.buttonMap.size)} buttons`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.modalMap.size)} modals`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.stringSelectMap.size)} string selects`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.userSelectMap.size)} user selects`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.roleSelectMap.size)} role selects`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.channelSelectMap.size)} channel selects`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.mentionableSelectMap.size)} mentionable selects`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.messageContextMenuMap.size)} message context menus`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.userContextMenuMap.size)} user context menus`);
-    this.logger.info(`\u2192 ${chalk4.magenta.bold(this.autocompleteMap.size)} autocomplete`);
+    this.logger.info(`${chalk3.bold.green("Loaded interaction handlers:")}`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.middlewares.length)} middlewares`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.slashMap.size)} slash commands`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.buttonMap.size)} buttons`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.modalMap.size)} modals`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.stringSelectMap.size)} string selects`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.userSelectMap.size)} user selects`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.roleSelectMap.size)} role selects`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.channelSelectMap.size)} channel selects`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.mentionableSelectMap.size)} mentionable selects`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.messageContextMenuMap.size)} message context menus`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.userContextMenuMap.size)} user context menus`);
+    this.logger.info(`\u2192 ${chalk3.magenta.bold(this.autocompleteMap.size)} autocomplete`);
   }
   async loadHandlers(dir) {
     await traverseDirectory(dir, (_fullPath, relativePath, imported) => {
       for (const val of Object.values(imported)) {
         if (!this.isHandlerClass(val)) continue;
         this.registerHandler(val);
-        this.logger.info(`${chalk4.italic("Registered")} ${chalk4.bold.yellow(val.name)} from ${chalk4.gray(relativePath)}`);
+        this.logger.info(`${chalk3.italic("Registered")} ${chalk3.bold.yellow(val.name)} from ${chalk3.gray(relativePath)}`);
       }
     }, this.logger);
   }
@@ -978,7 +944,7 @@ var InteractionController = class {
       priority: metadata.priority
     });
     this.middlewares.sort((a, b) => a.priority - b.priority);
-    this.logger.info(`${chalk4.italic("Registered middleware")} ${chalk4.bold.yellow(middlewareCtor.name)} ${chalk4.gray(`(priority ${metadata.priority})`)} from ${chalk4.gray(relativePath)}`);
+    this.logger.info(`${chalk3.italic("Registered middleware")} ${chalk3.bold.yellow(middlewareCtor.name)} ${chalk3.gray(`(priority ${metadata.priority})`)} from ${chalk3.gray(relativePath)}`);
   }
   isHandlerClass(obj) {
     if (typeof obj !== "function") return false;
@@ -1045,7 +1011,7 @@ var InteractionController = class {
   attachToClient() {
     this.core.bot.client.on(Events.InteractionCreate, (interaction) => {
       this.handleInteraction(interaction).catch((err) => {
-        this.logger.error(`[${chalk4.bold.red("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
+        this.logger.error(`[${chalk3.bold.red("UNHANDLED ERROR AT ROOT")}] ${err.name}`, err.stack);
       });
     });
   }
@@ -1076,10 +1042,10 @@ var InteractionController = class {
     }
     let HandlerCtor = getHandler(key);
     if (!HandlerCtor) {
-      this.logger.warn(`No handler found for key ${chalk4.bold.cyan(key)}. Falling back to UnhandledEvent.`);
+      this.logger.warn(`No handler found for key ${chalk3.bold.cyan(key)}. Falling back to UnhandledEvent.`);
       HandlerCtor = UnhandledEvent;
     }
-    this.logger.debug(`Processing ${chalk4.bold.green(key)} with ${chalk4.gray(HandlerCtor.name)}`);
+    this.logger.debug(`Processing ${chalk3.bold.green(key)} with ${chalk3.gray(HandlerCtor.name)}`);
     const handler = new HandlerCtor(interaction, this.core, args);
     if (handler.hasChecks()) await handler.runChecks();
     if (handler.shouldBreak()) return;
@@ -1163,6 +1129,69 @@ var InteractionController = class {
     await this.processInteraction(interaction, () => autocompleteKey, (key) => this.autocompleteMap.get(key));
   }
 };
+var Plugin = class {
+  static {
+    __name(this, "Plugin");
+  }
+  pluggable;
+  constructor(pluggable) {
+    this.pluggable = pluggable;
+  }
+};
+var Pluggable = class _Pluggable {
+  static {
+    __name(this, "Pluggable");
+  }
+  isInitialized = false;
+  shutdown;
+  startup;
+  static PLUGIN_INIT_TIMEOUT_MS = 15e3;
+  constructor(shutdown, startup) {
+    this.shutdown = shutdown;
+    this.startup = startup;
+  }
+  async init() {
+    if (this.isInitialized) return this;
+    await this.startup.run();
+    this.isInitialized = true;
+    return this;
+  }
+  /**
+   * Attaches a plugin to this instance
+   *
+   * Plugins provide external functionality and are initialized during the specified startup phase.
+   * The plugin instance becomes available as a property in `core` wherever it's available.
+   *
+   * Make sure to augment the {@link Core} interface with the plugin type to ensure TypeScript recognizes it and provides intellisense.
+   *
+   * @typeParam Key - The property name for accessing the plugin
+   * @typeParam Ctor - The plugin constructor type
+   * @param key - Property name to access the plugin instance
+   * @param Plugin - Plugin constructor class
+   * @param startupPhase - When during startup to initialize this plugin ({@link StartupPhase})
+   * @param args - Additional arguments to pass to the plugin constructor
+   * @returns This instance with the plugin attached as a typed property
+   * @throws An {@link Error} When called after initialization or if key already exists
+   * @example
+   * ```typescript
+   * seedcord.attach('db', Mongo, StartupPhase.Configuration, { uri: 'mongodb://...', name: 'seedcord', dir: ... })
+   * ```
+   */
+  attach(key, Plugin2, startupPhase, ...args) {
+    if (this.isInitialized) throw new Error("Cannot attach a plugin after initialization.");
+    if (this[key]) throw new Error(`Plugin with key "${key}" already exists.`);
+    const instance = new Plugin2(this, ...args);
+    const entry = {
+      [key]: instance
+    };
+    this.startup.addTask(startupPhase, `Plugin:${key}`, async () => {
+      instance.logger.info(chalk3.bold("Initializing"));
+      await instance.init();
+      instance.logger.info(chalk3.bold("Initialized"));
+    }, _Pluggable.PLUGIN_INIT_TIMEOUT_MS);
+    return Object.assign(this, entry);
+  }
+};
 var EmojiInjector = class {
   static {
     __name(this, "EmojiInjector");
@@ -1174,7 +1203,7 @@ var EmojiInjector = class {
   }
   async init() {
     if (!this.core.config.bot.emojis || Object.keys(this.core.config.bot.emojis).length === 0) {
-      this.logger.info(`${chalk4.bold.green("Loaded")}: ${chalk4.magenta.bold("0")} emojis`);
+      this.logger.info(`${chalk3.bold.green("Loaded")}: ${chalk3.magenta.bold("0")} emojis`);
       return;
     }
     const configEmojis = this.core.config.bot.emojis;
@@ -1185,10 +1214,10 @@ var EmojiInjector = class {
       if (emoji) {
         configEmojis[key] = `<${emoji.identifier}>`;
         foundCount++;
-        this.logger.debug(`${chalk4.bold.green("Found")}: ${chalk4.magenta.bold(emojiName)} (${emoji.id})`);
+        this.logger.debug(`${chalk3.bold.green("Found")}: ${chalk3.magenta.bold(emojiName)} (${emoji.id})`);
       }
     });
-    this.logger.info(`${chalk4.bold.green("Loaded")}: ${chalk4.magenta.bold(foundCount)} emojis`);
+    this.logger.info(`${chalk3.bold.green("Loaded")}: ${chalk3.magenta.bold(foundCount)} emojis`);
   }
 };
 
@@ -1254,7 +1283,7 @@ var Bot = class extends Plugin {
    */
   async login() {
     await this._client.login(this.botToken);
-    this.logger.info(`Logged in as ${chalk4.bold.magenta(this._client.user?.username)}!`);
+    this.logger.info(`Logged in as ${chalk3.bold.magenta(this._client.user?.username)}!`);
     return this;
   }
   /**
@@ -1262,7 +1291,7 @@ var Bot = class extends Plugin {
    */
   async logout() {
     await this._client.destroy();
-    this.logger.info(chalk4.bold.red("Logged out of Discord!"));
+    this.logger.info(chalk3.bold.red("Logged out of Discord!"));
   }
   get client() {
     return this._client;
@@ -1280,14 +1309,18 @@ _ts_decorate4([
 
 // src/effects/decorators/RegisterEffect.ts
 var EffectMetadataKey = Symbol("effect:metadata");
-function RegisterEffect(effect) {
+function RegisterEffect(effect, options) {
   return function(constructor) {
-    Reflect.defineMetadata(EffectMetadataKey, effect, constructor);
+    const meta = {
+      effect,
+      frequency: options?.frequency
+    };
+    Reflect.defineMetadata(EffectMetadataKey, meta, constructor);
   };
 }
 __name(RegisterEffect, "RegisterEffect");
 
-// src/effects/interfaces/EffectsHandler.ts
+// src/effects/EffectsHandler.ts
 var EffectsHandler = class {
   static {
     __name(this, "EffectsHandler");
@@ -1308,7 +1341,7 @@ var EffectsHandler = class {
   }
 };
 
-// src/effects/interfaces/abstracts/WebhookLog.ts
+// src/effects/bases/WebhookLog.ts
 var WebhookLog = class extends EffectsHandler {
   static {
     __name(this, "WebhookLog");
@@ -1484,51 +1517,56 @@ var EffectsRegistry = class extends Plugin {
     if (this.isInitialized) return;
     this.isInitialized = true;
     const effectsDir = this.core.config.effects.path;
-    this.logger.info(chalk4.bold(effectsDir));
-    this.registerEffect("unknownException", UnknownException);
+    this.logger.info(chalk3.bold(effectsDir));
+    this.registerEffect(UnknownException, {
+      effect: "unknownException",
+      frequency: "on"
+    });
     await this.loadEffects(effectsDir);
     this.attachEffects();
     const totalEffects = Array.from(this.effectsMap.values()).reduce((acc, handlers) => acc + handlers.length, 0);
-    this.logger.info(`${chalk4.bold.green("Loaded")}: ${chalk4.bold.magenta(totalEffects)} side effects`);
+    this.logger.info(`${chalk3.bold.green("Loaded")}: ${chalk3.bold.magenta(totalEffects)} side effects`);
   }
   async loadEffects(dir) {
     await traverseDirectory(dir, (_fullPath, relativePath, imported) => {
       for (const exportName of Object.keys(imported)) {
         const val = imported[exportName];
         if (this.isEffectHandler(val)) {
-          const effectName = Reflect.getMetadata(EffectMetadataKey, val);
-          if (effectName) {
-            this.registerEffect(effectName, val);
-            this.logger.info(`${chalk4.italic("Registered")} ${chalk4.bold.yellow(val.name)} from ${chalk4.gray(relativePath)}`);
-          }
+          const meta = Reflect.getMetadata(EffectMetadataKey, val);
+          this.registerEffect(val, meta);
+          this.logger.info(`${chalk3.italic("Registered")} ${chalk3.bold.yellow(val.name)} from ${chalk3.gray(relativePath)}`);
         }
       }
     }, this.logger);
   }
-  registerEffect(effectName, handler) {
-    let handlers = this.effectsMap.get(effectName);
+  registerEffect(handler, options) {
+    let handlers = this.effectsMap.get(options.effect);
     if (!handlers) {
       handlers = [];
-      this.effectsMap.set(effectName, handlers);
+      this.effectsMap.set(options.effect, handlers);
     }
-    handlers.push(handler);
+    handlers.push({
+      ctor: handler,
+      frequency: options.frequency ?? "on"
+    });
   }
   isEffectHandler(obj) {
     if (typeof obj !== "function") return false;
-    return obj.prototype instanceof EffectsHandler;
+    return obj.prototype instanceof EffectsHandler && Reflect.hasMetadata(EffectMetadataKey, obj);
   }
   attachEffects() {
-    for (const [effectName, handlerCtors] of this.effectsMap) {
-      this.emitter.on(effectName, (data) => {
-        for (const HandlerCtor of handlerCtors) {
+    for (const [effectName, handlerEntries] of this.effectsMap) {
+      for (const entry of handlerEntries) {
+        const register = entry.frequency === "once" ? this.emitter.once.bind(this.emitter) : this.emitter.on.bind(this.emitter);
+        register(effectName, (data) => {
           try {
-            const instance = new HandlerCtor(data, this.core);
+            const instance = new entry.ctor(data, this.core);
             void instance.execute();
           } catch (err) {
-            this.logger.error(`Error in side effect ${String(effectName)} handler ${HandlerCtor.name}:`, err);
+            this.logger.error(`Error in side effect ${String(effectName)} handler ${entry.ctor.name}:`, err);
           }
-        }
-      });
+        });
+      }
     }
   }
   emit(event, data) {
@@ -1580,19 +1618,19 @@ var Seedcord = class _Seedcord extends Pluggable {
    */
   registerStartupTasks() {
     this.startup.addTask(StartupPhase.Configuration, "Effect Initialization", async () => {
-      this.effects.logger.info(chalk4.bold("Initializing"));
+      this.effects.logger.info(chalk3.bold("Initializing"));
       await this.effects.init();
-      this.effects.logger.info(chalk4.bold("Initialized"));
+      this.effects.logger.info(chalk3.bold("Initialized"));
     });
     this.startup.addTask(StartupPhase.Instantiation, "Bot Initialization", async () => {
-      this.bot.logger.info(chalk4.bold("Initializing"));
+      this.bot.logger.info(chalk3.bold("Initializing"));
       await this.bot.init();
-      this.bot.logger.info(chalk4.bold("Initialized"));
+      this.bot.logger.info(chalk3.bold("Initialized"));
     });
     this.startup.addTask(StartupPhase.Ready, "Health Check", async () => {
-      this.healthCheck.logger.info(chalk4.bold("Initializing"));
+      this.healthCheck.logger.info(chalk3.bold("Initializing"));
       await this.healthCheck.init();
-      this.healthCheck.logger.info(chalk4.bold("Initialized"));
+      this.healthCheck.logger.info(chalk3.bold("Initialized"));
     });
   }
   /**