seedcord 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -737,7 +737,7 @@ function buildSlashRoute(arg1, arg2, arg3) {
 }
 __name(buildSlashRoute, "buildSlashRoute");
 
-// src/bot/errors/Database.ts
+// src/bot/defaults/errors/Database.ts
 var DatabaseError = class extends CustomError {
   static {
     __name(this, "DatabaseError");
@@ -1245,6 +1245,10 @@ var Pluggable = class _Pluggable extends services.StrictEventEmitter {
   }
 };
 var emojiStorage = {};
+function isEmojiTuple(v) {
+  return Array.isArray(v) && v.length === 2 && typeof v[0] === "string" && typeof v[1] === "string";
+}
+__name(isEmojiTuple, "isEmojiTuple");
 var Emojis = emojiStorage;
 var EmojiInjector = class {
   static {
@@ -1264,23 +1268,57 @@ var EmojiInjector = class {
     const configEmojis = this.core.config.bot.emojis;
     await this.core.bot.client.application?.emojis.fetch();
     let foundCount = 0;
-    Object.entries(configEmojis).forEach(([key, emojiName]) => {
-      if (typeof emojiName !== "string") {
-        this.logger.warn(`${chalk3__default.default.bold.yellow("Invalid")}: ${chalk3__default.default.magenta.bold(String(key))} (expected string, received ${typeof emojiName})`);
-        return;
+    const entries = Object.entries(configEmojis);
+    for (const [key, value] of entries) {
+      if (isEmojiTuple(value)) {
+        foundCount += this.handleTuple(key, value);
+        continue;
       }
-      const emoji = this.core.bot.client.application?.emojis.cache.find((e) => e.name === emojiName);
-      if (emoji) {
-        emojiStorage[key] = `<${emoji.identifier}>`;
-        foundCount++;
-        this.logger.debug(`${chalk3__default.default.bold.green("Found")}: ${chalk3__default.default.magenta.bold(emojiName)} (${emoji.id})`);
-        return;
+      if (typeof value === "string") {
+        foundCount += this.handleString(key, value);
+        continue;
       }
-      emojiStorage[key] = emojiName;
-      this.logger.warn(`${chalk3__default.default.bold.yellow("Missing")}: ${chalk3__default.default.magenta.bold(emojiName)} (using configured value)`);
-    });
+      this.logger.warn(`${chalk3__default.default.bold.yellow("Invalid")}: ${chalk3__default.default.magenta.bold(String(key))} (expected string or [string, string])`);
+    }
     this.logger.info(`${chalk3__default.default.bold.green("Loaded")}: ${chalk3__default.default.magenta.bold(foundCount)} emoji(s)`);
   }
+  /**
+   * Handle emoji config values in tuple form: [emojiName, guildId]
+   * Returns 1 when the emoji was found and stored as an emoji object, otherwise 0.
+   */
+  handleTuple(key, value) {
+    const [emojiName, guildId] = value;
+    const guild = this.core.bot.client.guilds.cache.get(guildId);
+    if (!guild) {
+      emojiStorage[key] = emojiName;
+      this.logger.warn(`${chalk3__default.default.bold.yellow("Missing")}: ${chalk3__default.default.magenta.bold(emojiName)} in guild ${chalk3__default.default.gray(guildId)} (guild not in cache or not found, using provided string)`);
+      return 0;
+    }
+    const guildEmoji = guild.emojis.cache.find((e) => e.name === emojiName);
+    if (guildEmoji) {
+      emojiStorage[key] = guildEmoji;
+      this.logger.debug(`${chalk3__default.default.bold.green("Found")}: ${chalk3__default.default.magenta.bold(emojiName)} (${guildEmoji.id}) in guild ${chalk3__default.default.gray(guildId)}`);
+      return 1;
+    }
+    emojiStorage[key] = emojiName;
+    this.logger.warn(`${chalk3__default.default.bold.yellow("Missing")}: ${chalk3__default.default.magenta.bold(emojiName)} in guild ${chalk3__default.default.magenta.bold(guildId)} (using provided string)`);
+    return 0;
+  }
+  /**
+   * Handle emoji config values provided as a simple string (application emoji lookup).
+   * Returns 1 when the emoji was found and stored as an emoji object, otherwise 0.
+   */
+  handleString(key, emojiName) {
+    const appEmoji = this.core.bot.client.application?.emojis.cache.find((e) => e.name === emojiName);
+    if (appEmoji) {
+      emojiStorage[key] = appEmoji;
+      this.logger.debug(`${chalk3__default.default.bold.green("Found")}: ${chalk3__default.default.magenta.bold(emojiName)} (${appEmoji.id})`);
+      return 1;
+    }
+    emojiStorage[key] = emojiName;
+    this.logger.warn(`${chalk3__default.default.bold.yellow("Missing")}: ${chalk3__default.default.magenta.bold(emojiName)} (using provided string)`);
+    return 0;
+  }
   clearEmojis() {
     for (const key of Object.keys(emojiStorage)) Reflect.deleteProperty(emojiStorage, key);
   }
@@ -1378,1106 +1416,1041 @@ _ts_decorate4([
   _ts_metadata4("design:type", String)
 ], Bot.prototype, "botToken", void 0);
 
-// src/effects/decorators/RegisterEffect.ts
-var EffectMetadataKey = Symbol("effect:metadata");
-function RegisterEffect(effect, options) {
-  return function(constructor) {
-    const meta = {
-      effect,
-      frequency: options?.frequency
-    };
-    Reflect.defineMetadata(EffectMetadataKey, meta, constructor);
+// src/bot/decorators/Checkable.ts
+function Checkable(ctor) {
+  return class extends ctor {
+    static name = ctor.name;
+    checkable = true;
   };
 }
-__name(RegisterEffect, "RegisterEffect");
-
-// src/effects/EffectsHandler.ts
-var EffectsHandler = class {
-  static {
-    __name(this, "EffectsHandler");
-  }
-  data;
-  core;
-  /**
-   * Creates a new effects handler instance.
-   *
-   * @param data - The effect event data
-   * @param core - The core framework instance
-   */
-  constructor(data, core) {
-    this.data = data;
-    this.core = core;
-    this.data = data;
-    this.core = core;
-  }
-};
-
-// src/effects/bases/WebhookLog.ts
-var WebhookLog = class extends EffectsHandler {
-  static {
-    __name(this, "WebhookLog");
-  }
-  constructor(data, core) {
-    super(data, core);
-  }
-};
-
-// src/effects/default/UnknownException.ts
-function _ts_decorate5(decorators, target, key, desc) {
-  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-  return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-__name(_ts_decorate5, "_ts_decorate");
-function _ts_metadata5(k, v) {
-  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-__name(_ts_metadata5, "_ts_metadata");
-function webhookUrlValidator(raw, _fallback) {
-  if (raw === null) {
-    throw new services.SeedcordError(services.SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing);
+__name(Checkable, "Checkable");
+var resolveFactory = /* @__PURE__ */ __name(async (input, ctx) => typeof input === "function" ? await input(ctx) : input, "resolveFactory");
+var isV2 = /* @__PURE__ */ __name((opts) => "container" in opts, "isV2");
+var usesResolver = /* @__PURE__ */ __name((opts) => "resolveDecision" in opts, "usesResolver");
+var usesCustomIds = /* @__PURE__ */ __name((opts) => "confirmCustomIds" in opts, "usesCustomIds");
+var isMessageComponentIx = /* @__PURE__ */ __name((ix) => "deferUpdate" in ix && "customId" in ix, "isMessageComponentIx");
+var buildPrompt = /* @__PURE__ */ __name(async (opts, ctx) => {
+  if (isV2(opts)) {
+    const container = await resolveFactory(opts.container, ctx);
+    return {
+      flags: "IsComponentsV2",
+      components: [
+        container.component
+      ]
+    };
   }
-  if (typeof raw !== "string") {
-    throw new services.SeedcordError(services.SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid);
+  const prompt = await resolveFactory(opts.prompt, ctx);
+  const rows = await resolveFactory(opts.rows, ctx);
+  const components = [
+    ...rows
+  ];
+  const payload = {
+    components
+  };
+  if (typeof prompt === "string") payload.content = prompt;
+  else payload.embeds = [
+    prompt.component
+  ];
+  return payload;
+}, "buildPrompt");
+var clearedPayload = /* @__PURE__ */ __name((opts) => isV2(opts) ? {
+  flags: "IsComponentsV2",
+  components: []
+} : {
+  components: []
+}, "clearedPayload");
+var decide = /* @__PURE__ */ __name(async (opts, i) => {
+  if (usesResolver(opts)) return opts.resolveDecision(i);
+  if (usesCustomIds(opts)) {
+    const { confirmCustomIds, cancelCustomIds = [] } = opts;
+    if (confirmCustomIds.includes(i.customId)) return true;
+    if (cancelCustomIds.includes(i.customId)) return false;
   }
-  const value = raw.trim();
-  if (value === "") {
-    throw new services.SeedcordError(services.SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing);
+  return false;
+}, "decide");
+var shouldDefer = /* @__PURE__ */ __name((ix, opts, isSlash, isContext) => {
+  if (ix.deferred) return false;
+  if (opts.defer === false) return false;
+  return isSlash || isContext;
+}, "shouldDefer");
+var maybeDefer = /* @__PURE__ */ __name(async (ix, opts, isSlash, isContext) => {
+  if (!shouldDefer(ix, opts, isSlash, isContext)) return;
+  if (isSlash || isContext) {
+    const { ephemeral = true } = opts;
+    const flags = ephemeral ? {
+      flags: "Ephemeral"
+    } : void 0;
+    if (flags) await ix.deferReply(flags);
+    else await ix.deferReply();
+  } else if (isMessageComponentIx(ix)) {
+    await ix.deferUpdate();
+  } else {
+    await ix.deferReply().catch(() => void 0);
   }
-  const pattern = String.raw`^https?:\/\/(?:canary\.|ptb\.)?discord(?:app)?\.com\/api\/webhooks\/\d+\/[\w$-]+$`;
-  const discordWebhookRegex = new RegExp(pattern);
-  if (!URL.canParse(value) || !discordWebhookRegex.test(value)) {
-    throw new services.SeedcordError(services.SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid);
+}, "maybeDefer");
+var sendPrompt = /* @__PURE__ */ __name(async (ix, payload, ephemeral, isSlash, isContext) => {
+  if (isSlash || isContext) {
+    if (ix.deferred) return ix.editReply(payload);
+    const reply = {
+      ...payload,
+      ...ephemeral ? {
+        flags: "Ephemeral"
+      } : {}
+    };
+    await ix.reply(reply);
+    return ix.fetchReply();
   }
-  return value;
-}
-__name(webhookUrlValidator, "webhookUrlValidator");
-exports.UnknownException = class _UnknownException extends WebhookLog {
-  static {
-    __name(this, "UnknownException");
+  const follow = {
+    ...payload,
+    ...ephemeral ? {
+      flags: "Ephemeral"
+    } : {}
+  };
+  return ix.followUp(follow);
+}, "sendPrompt");
+var awaitComponent = /* @__PURE__ */ __name(async (msg, original, opts) => {
+  const componentType = opts.componentType ?? discord_js.ComponentType.Button;
+  const timeoutMs = opts.timeoutMs ?? 1e4;
+  try {
+    const button = await msg.awaitMessageComponent({
+      componentType,
+      time: timeoutMs,
+      filter: /* @__PURE__ */ __name((c) => {
+        if (c.user.id !== original.user.id) return false;
+        if (usesCustomIds(opts)) {
+          const { confirmCustomIds, cancelCustomIds = [] } = opts;
+          return confirmCustomIds.includes(c.customId) || cancelCustomIds.includes(c.customId);
+        }
+        return true;
+      }, "filter")
+    });
+    return {
+      button,
+      timedOut: false
+    };
+  } catch {
+    return {
+      button: null,
+      timedOut: true
+    };
   }
-  static logger = new services.Logger("Effect: UnknownException");
-  webhook = new discord_js.WebhookClient({
-    url: _UnknownException.unknownExceptionWebhookUrl
-  });
-  async execute() {
-    const metadataFile = this.prepareMetadataFile();
+}, "awaitComponent");
+var clearUi = /* @__PURE__ */ __name(async (ix, msg, opts, isSlash) => {
+  if (!isSlash) {
     try {
-      await this.webhook.send({
-        flags: "IsComponentsV2",
-        withComponents: true,
-        username: "Unknown Exception",
-        avatarURL: "https://cdn.discordapp.com/attachments/1351446034827579466/1351446912947191830/warning-2.png",
-        components: [
-          new UnhandledErrorContainer(this.data).component
-        ],
-        files: metadataFile ? [
-          metadataFile
-        ] : []
-      });
-    } catch (error) {
-      _UnknownException.logger.error("Failed to send unknown exception webhook", error);
+      await msg.edit(clearedPayload(opts));
+    } catch {
+      await ix.deleteReply(msg).catch(() => void 0);
     }
+    return;
   }
-  prepareMetadataFile() {
-    const { metadata } = this.data;
-    if (!metadata) return null;
-    const content = utils.filterCirculars(metadata);
-    return new discord_js.AttachmentBuilder(Buffer.from(JSON.stringify(content, void 0, 2), "utf-8"), {
-      name: "metadata.json",
-      description: "Metadata associated with the error"
-    });
+  await ix.editReply(clearedPayload(opts)).catch(() => void 0);
+}, "clearUi");
+var normalizeClassicOutcome = /* @__PURE__ */ __name((payload) => ({
+  ...payload,
+  components: payload.components ?? []
+}), "normalizeClassicOutcome");
+var outcomeReplacement = /* @__PURE__ */ __name(async (opts, ctx, confirmed, timedOut) => {
+  const outcomes = opts.outcomeUi;
+  if (isV2(opts)) {
+    const v2Outcomes = outcomes;
+    if (timedOut) return await resolveFactory(v2Outcomes.onTimeout, ctx);
+    if (!confirmed) return await resolveFactory(v2Outcomes.onCancel, ctx);
+    if (v2Outcomes.onConfirm) return await resolveFactory(v2Outcomes.onConfirm, ctx);
+    return null;
   }
-};
-_ts_decorate5([
-  envapt.Envapt("UNKNOWN_EXCEPTION_WEBHOOK_URL", {
-    converter: /* @__PURE__ */ __name((raw, fallback) => webhookUrlValidator(raw), "converter")
-  }),
-  _ts_metadata5("design:type", String)
-], exports.UnknownException, "unknownExceptionWebhookUrl", void 0);
-exports.UnknownException = _ts_decorate5([
-  RegisterEffect("unknownException")
-], exports.UnknownException);
-var DefaultSeparator = class DefaultSeparator2 extends BuilderComponent {
-  static {
-    __name(this, "DefaultSeparator");
-  }
-  constructor() {
-    super("separator");
-    this.instance.setSpacing(discord_js.SeparatorSpacingSize.Small).setDivider(true);
+  const classicOutcomes = outcomes;
+  if (timedOut) return normalizeClassicOutcome(await resolveFactory(classicOutcomes.onTimeout, ctx));
+  if (!confirmed) return normalizeClassicOutcome(await resolveFactory(classicOutcomes.onCancel, ctx));
+  if (classicOutcomes.onConfirm) {
+    return normalizeClassicOutcome(await resolveFactory(classicOutcomes.onConfirm, ctx));
   }
-};
-var UnhandledErrorContainer = class UnhandledErrorContainer2 extends BuilderComponent {
+  return null;
+}, "outcomeReplacement");
+function Confirmable(question, options) {
+  return function(_target, _propertyKey, descriptor) {
+    const original = descriptor.value;
+    descriptor.value = async function(...args) {
+      if (!original) throw new services.SeedcordError(services.SeedcordErrorCode.DecoratorMethodNotFound);
+      const ix = this.getEvent();
+      const isSlash = ix.isChatInputCommand();
+      const isContext = ix.isContextMenuCommand();
+      const { ephemeral = true } = options;
+      await maybeDefer(ix, options, isSlash, isContext);
+      const q = typeof question === "function" ? await question.apply(this) : question;
+      const ctx = {
+        handler: this,
+        interaction: ix,
+        question: q
+      };
+      const prompt = await buildPrompt(options, ctx);
+      const promptMsg = await sendPrompt(ix, prompt, ephemeral, isSlash, isContext);
+      const { button, timedOut } = await awaitComponent(promptMsg, ix, options);
+      let confirmed = false;
+      if (button) {
+        await button.deferUpdate().catch(() => void 0);
+        confirmed = await decide(options, button);
+      }
+      const replacement = await outcomeReplacement(options, ctx, confirmed, timedOut);
+      if (replacement) {
+        if (isSlash || isContext) {
+          await ix.editReply(replacement).catch(() => void 0);
+        } else {
+          await promptMsg.edit(replacement).catch(async () => {
+            await ix.deleteReply(promptMsg).catch(() => void 0);
+            await ix.followUp(replacement).catch(() => void 0);
+          });
+        }
+      } else {
+        await clearUi(ix, promptMsg, options, isSlash);
+      }
+      if (options.onResolved) {
+        await options.onResolved({
+          confirmed,
+          timedOut,
+          handler: this,
+          interaction: ix,
+          question: q,
+          ...button ? {
+            button
+          } : {}
+        });
+      }
+      if (confirmed) {
+        await original.apply(this, args);
+      }
+    };
+    return descriptor;
+  };
+}
+__name(Confirmable, "Confirmable");
+function EventCatchable(options) {
+  return function(_target, _prop, descriptor) {
+    const log = options?.log ?? false;
+    const silent = options?.silent ?? false;
+    const original = descriptor.value;
+    descriptor.value = async function(...args) {
+      if (!original) throw new services.SeedcordError(services.SeedcordErrorCode.DecoratorMethodNotFound);
+      try {
+        await original.apply(this, args);
+      } catch (err) {
+        if (!(err instanceof Error)) throw err;
+        this.setErrored();
+        if (log) console.error(err);
+        const eventArgs = Array.isArray(this.getEvent()) ? this.getEvent() : [
+          this.getEvent()
+        ];
+        const msg = eventArgs.find((x) => x instanceof discord_js.Message);
+        const { response } = extractErrorResponse(err, this.core, msg?.guild ?? null, msg?.author ?? null, eventArgs);
+        if (typeof silent === "boolean" && silent) return;
+        if (typeof silent !== "boolean" && silent.some((errorType) => err instanceof errorType)) {
+          return;
+        }
+        if (!msg) return;
+        await msg.reply({
+          embeds: [
+            response
+          ],
+          components: []
+        });
+      }
+    };
+  };
+}
+__name(EventCatchable, "EventCatchable");
+
+// src/bot/defaults/errors/Channels.ts
+var ChannelNotFoundError = class extends CustomError {
   static {
-    __name(this, "UnhandledErrorContainer");
-  }
-  constructor(data) {
-    super("container");
-    const { uuid, error, guild, user, metadata } = data;
-    this.instance.addTextDisplayComponents((text) => text.setContent(`### An unknown exception was thrown
-**Guild ID:** \`${guild?.id ?? "Not used in a guild"}\`
-**Guild Name:** ${guild?.name ?? "Not used in a guild"}
-**User ID:** \`${user?.id ?? "Missing user info"}\`
-**Username:** ${user?.username ?? "Missing user info"}
-`)).addSeparatorComponents(new DefaultSeparator().component).addTextDisplayComponents((text) => text.setContent(`### UUID \`${uuid}\`
-\`\`\`${error.stack}\`\`\``));
-    this.addTimestampsIfAvailable(error);
-    this.addMetadataIfAvailable(metadata);
-  }
-  addTimestampsIfAvailable(error) {
-    if (!(error instanceof discord_js.DiscordAPIError)) return;
-    const now = Date.now();
-    const snowflake = error.url.match(/\/interactions\/(\d+)\//)?.[1];
-    if (!snowflake) return void 0;
-    const interactionTs = Number(discord_js.SnowflakeUtil.deconstruct(snowflake).timestamp);
-    const diff = now - interactionTs;
-    const seconds = Math.floor(diff / 1e3);
-    const millis = diff % 1e3;
-    this.instance.addSeparatorComponents(new DefaultSeparator().component).addTextDisplayComponents((text) => text.setContent(`### Timestamps
-- **\`Interaction sent\` :** ${new Date(interactionTs).toISOString()} (${interactionTs})
-- **\`Error logged    \` :** ${new Date(now).toISOString()} (${now})
-- **\`Offset          \` :** ${seconds}s ${millis}ms`));
+    __name(this, "ChannelNotFoundError");
   }
-  addMetadataIfAvailable(metadata) {
-    if (!metadata) return;
-    this.instance.addSeparatorComponents(new DefaultSeparator().component).addTextDisplayComponents((text) => text.setContent("### Metadata")).addFileComponents((file) => file.setURL("attachment://metadata.json"));
+  channelId;
+  /**
+   * Creates a new ChannelNotFoundError.
+   *
+   * @param message - The error message
+   * @param channelId - The ID of the channel that could not be found
+   */
+  constructor(message, channelId) {
+    super(message), this.channelId = channelId;
+    this.response.setDescription(`Channel with ID \`${this.channelId}\` not found.`);
   }
 };
-var EffectsEmitter = class {
+var CannotSendEmbedsError = class extends CustomError {
   static {
-    __name(this, "EffectsEmitter");
+    __name(this, "CannotSendEmbedsError");
   }
-  emitter = new events.EventEmitter();
+  channelId;
   /**
-   * Registers a listener for the specified side effect.
+   * Creates a new CannotSendEmbedsError.
    *
-   * @typeParam KeyOfEffects - The side effect name type
-   * @param event - The side effect name to listen for
-   * @param listener - Function to call when the event is emitted
-   * @returns This EffectsEmitter instance for chaining
+   * @param message - The error message
+   * @param channelId - The ID of the channel where embeds cannot be sent
    */
-  on(event, listener) {
-    this.emitter.on(event, listener);
-    return this;
+  constructor(message, channelId) {
+    super(message), this.channelId = channelId;
+    this.response.setDescription(`Cannot send embeds in <#${this.channelId}>.
+
+Please ensure I have the following permissions:
+\u2022 View Channel
+\u2022 Send Messages
+\u2022 Embed Links
+\u2022 Attach Files
+\u2022 Read Message History
+\u2022 Use External Emojis
+`);
+  }
+};
+var CouldNotFindChannel = class extends CustomError {
+  static {
+    __name(this, "CouldNotFindChannel");
   }
+  channelId;
   /**
-   * Registers a one-time listener for the specified side effect.
+   * Creates a new CouldNotFindChannel error.
    *
-   * @typeParam KeyOfEffects - The side effect name type
-   * @param event - The side effect name to listen for once
-   * @param listener - Function to call when the event is emitted
-   * @returns This EffectsEmitter instance for chaining
+   * @param message - The error message
+   * @param channelId - The ID of the channel that could not be found
    */
-  once(event, listener) {
-    this.emitter.once(event, listener);
-    return this;
+  constructor(message, channelId) {
+    super(message), this.channelId = channelId;
+    this.response.setDescription(`Could not find channel with ID \`${this.channelId}\`. It could also be that the channel is not a text channel.`);
+  }
+};
+var ChannelNotTextChannel = class extends CustomError {
+  static {
+    __name(this, "ChannelNotTextChannel");
   }
+  channelId;
   /**
-   * Emits a side effect with the provided data.
+   * Creates a new ChannelNotTextChannel error.
    *
-   * @typeParam KeyOfEffects - The side effect name type
-   * @param event - The side effect name to emit
-   * @param data - The data to pass to registered listeners
-   * @returns True if the event had listeners, false otherwise
+   * @param message - The error message
+   * @param channelId - The ID of the channel that is not a text channel
    */
-  emit(event, data) {
-    return this.emitter.emit(event, data);
+  constructor(message, channelId) {
+    super(message), this.channelId = channelId;
+    this.response.setDescription(`Channel with ID \`${this.channelId}\` is not a text channel.`);
   }
 };
 
-// src/effects/EffectsRegistry.ts
-var EffectsRegistry = class extends Plugin {
-  static {
-    __name(this, "EffectsRegistry");
-  }
-  core;
-  logger = new services.Logger("Effects");
-  isInitialized = false;
-  effectsMap = new discord_js.Collection();
-  emitter = new EffectsEmitter();
-  constructor(core) {
-    super(core), this.core = core;
+// src/bot/utilities/channels/fetchText.ts
+async function fetchText(client, channelId) {
+  if (channelId instanceof discord_js.TextChannel) {
+    return channelId;
   }
-  async init() {
-    if (this.isInitialized) return;
-    this.isInitialized = true;
-    const effectsDir = this.core.config.effects.path;
-    this.logger.info(chalk3__default.default.bold(effectsDir));
-    this.registerEffect(exports.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(`${chalk3__default.default.bold.green("Loaded")}: ${chalk3__default.default.bold.magenta(totalEffects)} side effects`);
+  let channel = client.channels.cache.get(channelId);
+  if (!channel) {
+    try {
+      channel = await client.channels.fetch(channelId);
+    } catch {
+      throw new CouldNotFindChannel("Channel not found or not a text channel", channelId);
+    }
   }
-  async loadEffects(dir) {
-    await utils.traverseDirectory(dir, (_fullPath, relativePath, imported) => {
-      for (const exportName of Object.keys(imported)) {
-        const val = imported[exportName];
-        if (this.isEffectHandler(val)) {
-          const meta = Reflect.getMetadata(EffectMetadataKey, val);
-          this.registerEffect(val, meta);
-          this.logger.info(`${chalk3__default.default.italic("Registered")} ${chalk3__default.default.bold.yellow(val.name)} from ${chalk3__default.default.gray(relativePath)}`);
-        }
-      }
-    }, this.logger);
+  if (channel?.isTextBased()) {
+    return channel;
   }
-  registerEffect(handler, options) {
-    let handlers = this.effectsMap.get(options.effect);
-    if (!handlers) {
-      handlers = [];
-      this.effectsMap.set(options.effect, handlers);
+  throw new CouldNotFindChannel("Channel not found or not a text channel", channelId);
+}
+__name(fetchText, "fetchText");
+
+// src/bot/utilities/channels/sendInText.ts
+async function sendInText(client, channelId, message) {
+  const channel = await fetchText(client, channelId);
+  return await channel.send(message);
+}
+__name(sendInText, "sendInText");
+function throwCustomError(error, message, CustomError2) {
+  const uuid = crypto.randomUUID();
+  services.Logger.Error("Throwing Custom Error", error.name);
+  if (typeof CustomError2 === typeof DatabaseError) {
+    const errorMessage = error instanceof Error ? error.message : message;
+    throw new CustomError2(errorMessage, uuid);
+  } else {
+    if (error instanceof Error) {
+      throw new CustomError2(`${message}: ${error.message ? error.message : error.toString()}`);
+    } else {
+      throw new CustomError2(message);
     }
-    handlers.push({
-      ctor: handler,
-      frequency: options.frequency ?? "on"
-    });
-  }
-  isEffectHandler(obj) {
-    if (typeof obj !== "function") return false;
-    return obj.prototype instanceof EffectsHandler && Reflect.hasMetadata(EffectMetadataKey, obj);
   }
-  attachEffects() {
-    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 entry.ctor(data, this.core);
-            void instance.execute();
-          } catch (err) {
-            this.logger.error(`Error in side effect ${String(effectName)} handler ${entry.ctor.name}:`, err);
-          }
-        });
-      }
+}
+__name(throwCustomError, "throwCustomError");
+
+// src/bot/utilities/messages/attemptSendDM.ts
+async function attemptSendDM(user, content) {
+  const payload = {
+    ...content.content !== void 0 && {
+      content: content.content
+    },
+    ...content.embeds !== void 0 && {
+      embeds: [
+        ...content.embeds
+      ]
+    },
+    ...content.components !== void 0 && {
+      components: [
+        ...content.components
+      ]
     }
+  };
+  try {
+    return await user.send(payload);
+  } catch {
+    return null;
   }
-  emit(event, data) {
-    return this.emitter.emit(event, data);
+}
+__name(attemptSendDM, "attemptSendDM");
+var RoleHigherThanMe = class extends CustomError {
+  static {
+    __name(this, "RoleHigherThanMe");
   }
-};
+  role;
+  botRole;
+  /**
+   * Creates a new RoleHigherThanMe error.
+   *
+   * @param message - The error message
+   */
+  constructor(message, role, botRole) {
+    super(message), this.role = role, this.botRole = botRole;
+    this.response.setDescription(`I cannot assign a role that is higher than me.
 
-// src/Seedcord.ts
-var Seedcord = class _Seedcord extends Pluggable {
+The role <@&${this.role.id}> is higher than my role <@&${this.botRole.id}> in the hierarchy.`);
+  }
+};
+var CannotAssignBotRole = class extends CustomError {
   static {
-    __name(this, "Seedcord");
+    __name(this, "CannotAssignBotRole");
   }
-  config;
-  static isInstantiated = false;
-  /** @see {@link CoordinatedShutdown} */
-  shutdown;
-  /** @see {@link CoordinatedStartup} */
-  startup;
-  /** @see {@link EffectsRegistry} */
-  effects;
-  /** @see {@link Bot} */
-  bot;
-  /** @see {@link HealthCheck} */
-  healthCheck;
   /**
-   * Creates a new Seedcord instance
+   * Creates a new CannotAssignBotRole error.
    *
-   * @param config - Bot configuration including paths and Discord client options
-   * @throws An {@link SeedcordError} When attempting to create multiple instances (singleton)
+   * @param message - The error message
    */
-  constructor(config) {
-    const shutdown = new services.CoordinatedShutdown();
-    const startup = new services.CoordinatedStartup();
-    super(shutdown, startup), this.config = config;
-    this.shutdown = shutdown;
-    this.startup = startup;
-    if (_Seedcord.isInstantiated) {
-      throw new services.SeedcordError(services.SeedcordErrorCode.CoreSingletonViolation);
-    }
-    _Seedcord.isInstantiated = true;
-    this.effects = new EffectsRegistry(this);
-    this.bot = new Bot(this);
-    this.healthCheck = new services.HealthCheck(this.shutdown);
-    this.registerStartupTasks();
+  constructor(message = "I cannot assign a managed role.") {
+    super(message);
+    this.response.setDescription("I cannot assign a managed role.");
+  }
+};
+var RoleDoesNotExist = class extends CustomError {
+  static {
+    __name(this, "RoleDoesNotExist");
   }
+  roleId;
   /**
-   * Registers default startup tasks
-   * @internal
+   * Creates a new RoleDoesNotExist error.
+   *
+   * @param message - The error message
+   * @param roleId - The ID of the role that doesn't exist
    */
-  registerStartupTasks() {
-    this.startup.addTask(services.StartupPhase.Configuration, "Effect Initialization", async () => {
-      this.effects.logger.info(chalk3__default.default.bold("Initializing"));
-      await this.effects.init();
-      this.effects.logger.info(chalk3__default.default.bold("Initialized"));
-    });
-    this.startup.addTask(services.StartupPhase.Instantiation, "Bot Initialization", async () => {
-      this.bot.logger.info(chalk3__default.default.bold("Initializing"));
-      await this.bot.init();
-      this.bot.logger.info(chalk3__default.default.bold("Initialized"));
-    });
-    this.startup.addTask(services.StartupPhase.Ready, "Health Check", async () => {
-      this.healthCheck.logger.info(chalk3__default.default.bold("Initializing"));
-      await this.healthCheck.init();
-      this.healthCheck.logger.info(chalk3__default.default.bold("Initialized"));
-    });
+  constructor(message, roleId) {
+    super(message), this.roleId = roleId;
+    this.response.setDescription(`The role with ID \`${this.roleId}\` does not exist.`);
+  }
+};
+var MissingPermissions = class extends CustomError {
+  static {
+    __name(this, "MissingPermissions");
   }
+  where;
+  missingPerms;
   /**
-   * Starts the bot and runs all initialization tasks
+   * Creates a new MissingPermissions error.
    *
-   * @returns This Seedcord instance when fully initialized
+   * @param message - The error message
+   * @param missingPerms - Array of missing permission names
+   * @param where - Location or subject where permissions are missing
    */
-  async start() {
-    await super.init();
-    return this;
+  constructor(message, where, missingPerms) {
+    super(message), this.where = where, this.missingPerms = missingPerms;
+    const bullets = this.missingPerms.map((perm) => `\u2022 ${perm}`).join("\n");
+    const mention = this.where instanceof discord_js.Role ? `<@&${this.where.id}>` : this.where instanceof discord_js.TextChannel ? `<#${this.where.id}>` : this.where instanceof discord_js.GuildMember ? `<@${this.where.id}>` : `\`${this.where.name}\``;
+    const label = this.where instanceof discord_js.Role ? "role" : this.where instanceof discord_js.TextChannel ? "channel" : this.where instanceof discord_js.GuildMember ? "member" : "guild";
+    this.response.setDescription(`The ${label} ${mention} is missing the following permission entries:
+
+${bullets}`);
   }
 };
+var HasDangerousPermissions = class extends CustomError {
+  static {
+    __name(this, "HasDangerousPermissions");
+  }
+  target;
+  dangerousPerms;
+  /**
+   * Creates a new HasDangerousPermissions error.
+   *
+   * @param message - The error message
+   * @param target - The subject that has the unwanted permissions
+   * @param dangerousPerms - Array of dangerous permission names
+   */
+  constructor(message, target, dangerousPerms) {
+    super(message), this.target = target, this.dangerousPerms = dangerousPerms;
+    const bullets = this.dangerousPerms.map((perm) => `\u2022 ${perm}`).join("\n");
+    const mention = this.target instanceof discord_js.Role ? `<@&${this.target.id}>` : this.target instanceof discord_js.TextChannel ? `<#${this.target.id}>` : this.target instanceof discord_js.GuildMember ? `<@${this.target.id}>` : `\`${this.target.name}\``;
+    const label = this.target instanceof discord_js.Role ? "role" : this.target instanceof discord_js.TextChannel ? "channel" : this.target instanceof discord_js.GuildMember ? "member" : "guild";
+    this.response.setDescription(`The ${label} ${mention} has the following permission entries that must not be enabled:
 
-// src/bot/decorators/Checkable.ts
-function Checkable(ctor) {
-  return class extends ctor {
-    static name = ctor.name;
-    checkable = true;
-  };
+${bullets}`);
+  }
+};
+var PermissionNames = new Map(Object.entries(discord_js.PermissionFlagsBits).map(([key, bit]) => [
+  bit,
+  utils.prettify(key)
+]));
+function checkPermissions(a, b, c, d, e) {
+  const opts = a instanceof discord_js.Role || a instanceof discord_js.GuildMember ? {
+    for: a,
+    in: b,
+    scope: c,
+    inverse: d ?? false,
+    ...e ?? {}
+  } : a;
+  const { for: pFor, in: pIn, scope, inverse = false, missing: missingCtor, dangerous: dangerousCtor } = opts;
+  const Missing = missingCtor ?? MissingPermissions;
+  const Dangerous = dangerousCtor ?? HasDangerousPermissions;
+  const perms = pIn instanceof discord_js.Guild ? pFor.permissions : pIn.permissionsFor(pFor, true);
+  const names = /* @__PURE__ */ __name((bits) => bits.map((bit) => PermissionNames.get(bit) ?? String(bit)), "names");
+  const present = scope.filter((bit) => perms.has(bit, true));
+  const presentNames = names(present);
+  if (inverse) {
+    if (present.length > 0) {
+      const base = `${pFor instanceof discord_js.Role ? "Role" : "Member"} has dangerous permissions in this ${pIn instanceof discord_js.Guild ? "guild" : "channel"}`;
+      throw new Dangerous(base, pFor, presentNames);
+    }
+    return;
+  }
+  const missingBits = scope.filter((bit) => !perms.has(bit, true));
+  if (missingBits.length > 0) {
+    throw new Missing("Missing Any/All/No Permissions", pIn, names(missingBits));
+  }
 }
-__name(Checkable, "Checkable");
-function EventCatchable(options) {
-  return function(_target, _prop, descriptor) {
-    const log = options?.log ?? false;
-    const silent = options?.silent ?? false;
-    const original = descriptor.value;
-    descriptor.value = async function(...args) {
-      if (!original) throw new services.SeedcordError(services.SeedcordErrorCode.DecoratorMethodNotFound);
-      try {
-        await original.apply(this, args);
-      } catch (err) {
-        if (!(err instanceof Error)) throw err;
-        this.setErrored();
-        if (log) console.error(err);
-        if (typeof silent === "boolean" && silent) return;
-        if (typeof silent !== "boolean" && silent.some((errorType) => err instanceof errorType)) {
-          return;
-        }
-        const eventArgs = Array.isArray(this.getEvent()) ? this.getEvent() : [
-          this.getEvent()
-        ];
-        const msg = eventArgs.find((x) => x instanceof discord_js.Message);
-        const { response } = extractErrorResponse(err, this.core, msg?.guild ?? null, msg?.author ?? null, eventArgs);
-        if (!msg) return;
-        await msg.reply({
-          embeds: [
-            response
-          ],
-          components: []
-        });
-      }
-    };
-  };
+__name(checkPermissions, "checkPermissions");
+var ensurePermissions = checkPermissions;
+
+// src/bot/utilities/permissions/checkBotPermissions.ts
+function checkBotPermissions(target, scope, inverse = false, errors) {
+  if (target instanceof discord_js.Guild) {
+    const me2 = target.members.me;
+    if (!me2) {
+      const names = scope.map((bit) => PermissionNames.get(bit) ?? String(bit));
+      const Missing = errors?.missing ?? MissingPermissions;
+      throw new Missing("Missing Permissions", target, names);
+    }
+    checkPermissions(me2, target, scope, inverse, errors);
+    return;
+  }
+  const me = target.guild.members.me;
+  if (!me) {
+    const names = scope.map((bit) => PermissionNames.get(bit) ?? String(bit));
+    const Missing = errors?.missing ?? MissingPermissions;
+    services.Logger.Warn("checkBotPermissions", `Bot member is unavailable in guild ${target.guild.id} while checking permissions in channel ${target.id}`);
+    throw new Missing("Missing Permissions", target, names);
+  }
+  checkPermissions(me, target, scope, inverse, errors);
 }
-__name(EventCatchable, "EventCatchable");
-var resolveFactory = /* @__PURE__ */ __name(async (input, ctx) => typeof input === "function" ? await input(ctx) : input, "resolveFactory");
-var isV2 = /* @__PURE__ */ __name((opts) => "container" in opts, "isV2");
-var usesResolver = /* @__PURE__ */ __name((opts) => "resolveDecision" in opts, "usesResolver");
-var usesCustomIds = /* @__PURE__ */ __name((opts) => "confirmCustomIds" in opts, "usesCustomIds");
-var isMessageComponentIx = /* @__PURE__ */ __name((ix) => "deferUpdate" in ix && "customId" in ix, "isMessageComponentIx");
-var buildPrompt = /* @__PURE__ */ __name(async (opts, ctx) => {
-  if (isV2(opts)) {
-    const container = await resolveFactory(opts.container, ctx);
-    return {
-      flags: "IsComponentsV2",
-      components: [
-        container.component
-      ]
-    };
+__name(checkBotPermissions, "checkBotPermissions");
+var ensureBotPermissions = checkBotPermissions;
+function getBotRole(guild) {
+  const botRole = guild.roles.botRoleFor(guild.client.user);
+  if (!botRole) {
+    throw new services.SeedcordError(services.SeedcordErrorCode.CoreBotRoleMissing, [
+      guild.id
+    ]);
   }
-  const prompt = await resolveFactory(opts.prompt, ctx);
-  const rows = await resolveFactory(opts.rows, ctx);
-  const components = [
-    ...rows
-  ];
-  const payload = {
-    components
-  };
-  if (typeof prompt === "string") payload.content = prompt;
-  else payload.embeds = [
-    prompt.component
-  ];
-  return payload;
-}, "buildPrompt");
-var clearedPayload = /* @__PURE__ */ __name((opts) => isV2(opts) ? {
-  flags: "IsComponentsV2",
-  components: []
-} : {
-  components: []
-}, "clearedPayload");
-var decide = /* @__PURE__ */ __name(async (opts, i) => {
-  if (usesResolver(opts)) return opts.resolveDecision(i);
-  if (usesCustomIds(opts)) {
-    const { confirmCustomIds, cancelCustomIds = [] } = opts;
-    if (confirmCustomIds.includes(i.customId)) return true;
-    if (cancelCustomIds.includes(i.customId)) return false;
+  return botRole;
+}
+__name(getBotRole, "getBotRole");
+
+// src/bot/utilities/permissions/hasPermsToAssign.ts
+function hasPermsToAssign(roleOrOptions) {
+  const { targetRole, errors } = roleOrOptions instanceof discord_js.Role ? {
+    targetRole: roleOrOptions,
+    errors: void 0
+  } : roleOrOptions;
+  const HigherErr = errors?.higher ?? RoleHigherThanMe;
+  const ManagedErr = errors?.managed ?? CannotAssignBotRole;
+  const Missing = errors?.missing ?? MissingPermissions;
+  const botRole = getBotRole(targetRole.guild);
+  if (targetRole.comparePositionTo(botRole) >= 0) {
+    throw new HigherErr("Role is higher than me", targetRole, botRole);
   }
-  return false;
-}, "decide");
-var shouldDefer = /* @__PURE__ */ __name((ix, opts, isSlash, isContext) => {
-  if (ix.deferred) return false;
-  if (opts.defer === false) return false;
-  return isSlash || isContext;
-}, "shouldDefer");
-var maybeDefer = /* @__PURE__ */ __name(async (ix, opts, isSlash, isContext) => {
-  if (!shouldDefer(ix, opts, isSlash, isContext)) return;
-  if (isSlash || isContext) {
-    const { ephemeral = true } = opts;
-    const flags = ephemeral ? {
-      flags: "Ephemeral"
-    } : void 0;
-    if (flags) await ix.deferReply(flags);
-    else await ix.deferReply();
-  } else if (isMessageComponentIx(ix)) {
-    await ix.deferUpdate();
-  } else {
-    await ix.deferReply().catch(() => void 0);
+  if (targetRole.managed) {
+    throw new ManagedErr(`Cannot assign managed role ${targetRole.name}`);
   }
-}, "maybeDefer");
-var sendPrompt = /* @__PURE__ */ __name(async (ix, payload, ephemeral, isSlash, isContext) => {
-  if (isSlash || isContext) {
-    if (ix.deferred) return ix.editReply(payload);
-    const reply = {
-      ...payload,
-      ...ephemeral ? {
-        flags: "Ephemeral"
-      } : {}
-    };
-    await ix.reply(reply);
-    return ix.fetchReply();
+  checkBotPermissions(targetRole.guild, [
+    discord_js.PermissionFlagsBits.ManageRoles
+  ], false, {
+    missing: Missing
+  });
+}
+__name(hasPermsToAssign, "hasPermsToAssign");
+async function fetchRole(clientOrGuild, roleId) {
+  let role;
+  if (!roleId) {
+    throw new RoleDoesNotExist("Role ID is null or undefined", roleId);
   }
-  const follow = {
-    ...payload,
-    ...ephemeral ? {
-      flags: "Ephemeral"
-    } : {}
-  };
-  return ix.followUp(follow);
-}, "sendPrompt");
-var awaitComponent = /* @__PURE__ */ __name(async (msg, original, opts) => {
-  const componentType = opts.componentType ?? discord_js.ComponentType.Button;
-  const timeoutMs = opts.timeoutMs ?? 1e4;
-  try {
-    const button = await msg.awaitMessageComponent({
-      componentType,
-      time: timeoutMs,
-      filter: /* @__PURE__ */ __name((c) => {
-        if (c.user.id !== original.user.id) return false;
-        if (usesCustomIds(opts)) {
-          const { confirmCustomIds, cancelCustomIds = [] } = opts;
-          return confirmCustomIds.includes(c.customId) || cancelCustomIds.includes(c.customId);
+  if (clientOrGuild instanceof discord_js.Guild) {
+    const guild = clientOrGuild;
+    role = guild.roles.cache.get(roleId);
+    if (!role) {
+      try {
+        role = await guild.roles.fetch(roleId);
+      } catch {
+        throw new RoleDoesNotExist("Role not found in specified guild", roleId);
+      }
+    }
+  } else {
+    const client = clientOrGuild;
+    role = client.guilds.cache.map((guild) => guild.roles.cache.get(roleId)).find((role2) => role2);
+    if (!role) {
+      const guilds = client.guilds.cache;
+      for (const guild of guilds.values()) {
+        try {
+          role = await guild.roles.fetch(roleId);
+          if (role) break;
+        } catch {
+          continue;
         }
-        return true;
-      }, "filter")
-    });
-    return {
-      button,
-      timedOut: false
-    };
-  } catch {
-    return {
-      button: null,
-      timedOut: true
-    };
-  }
-}, "awaitComponent");
-var clearUi = /* @__PURE__ */ __name(async (ix, msg, opts, isSlash) => {
-  if (!isSlash) {
-    try {
-      await msg.edit(clearedPayload(opts));
-    } catch {
-      await ix.deleteReply(msg).catch(() => void 0);
+      }
     }
-    return;
-  }
-  await ix.editReply(clearedPayload(opts)).catch(() => void 0);
-}, "clearUi");
-var normalizeClassicOutcome = /* @__PURE__ */ __name((payload) => ({
-  ...payload,
-  components: payload.components ?? []
-}), "normalizeClassicOutcome");
-var outcomeReplacement = /* @__PURE__ */ __name(async (opts, ctx, confirmed, timedOut) => {
-  const outcomes = opts.outcomeUi;
-  if (isV2(opts)) {
-    const v2Outcomes = outcomes;
-    if (timedOut) return await resolveFactory(v2Outcomes.onTimeout, ctx);
-    if (!confirmed) return await resolveFactory(v2Outcomes.onCancel, ctx);
-    if (v2Outcomes.onConfirm) return await resolveFactory(v2Outcomes.onConfirm, ctx);
-    return null;
   }
-  const classicOutcomes = outcomes;
-  if (timedOut) return normalizeClassicOutcome(await resolveFactory(classicOutcomes.onTimeout, ctx));
-  if (!confirmed) return normalizeClassicOutcome(await resolveFactory(classicOutcomes.onCancel, ctx));
-  if (classicOutcomes.onConfirm) {
-    return normalizeClassicOutcome(await resolveFactory(classicOutcomes.onConfirm, ctx));
+  if (!role) {
+    throw new RoleDoesNotExist("Role not found", roleId);
   }
-  return null;
-}, "outcomeReplacement");
-function Confirmable(question, options) {
-  return function(_target, _propertyKey, descriptor) {
-    const original = descriptor.value;
-    descriptor.value = async function(...args) {
-      if (!original) throw new services.SeedcordError(services.SeedcordErrorCode.DecoratorMethodNotFound);
-      const ix = this.getEvent();
-      const isSlash = ix.isChatInputCommand();
-      const isContext = ix.isContextMenuCommand();
-      const { ephemeral = true } = options;
-      await maybeDefer(ix, options, isSlash, isContext);
-      const q = typeof question === "function" ? await question.apply(this) : question;
-      const ctx = {
-        handler: this,
-        interaction: ix,
-        question: q
-      };
-      const prompt = await buildPrompt(options, ctx);
-      const promptMsg = await sendPrompt(ix, prompt, ephemeral, isSlash, isContext);
-      const { button, timedOut } = await awaitComponent(promptMsg, ix, options);
-      let confirmed = false;
-      if (button) {
-        await button.deferUpdate().catch(() => void 0);
-        confirmed = await decide(options, button);
-      }
-      const replacement = await outcomeReplacement(options, ctx, confirmed, timedOut);
-      if (replacement) {
-        if (isSlash || isContext) {
-          await ix.editReply(replacement).catch(() => void 0);
-        } else {
-          await promptMsg.edit(replacement).catch(async () => {
-            await ix.deleteReply(promptMsg).catch(() => void 0);
-            await ix.followUp(replacement).catch(() => void 0);
-          });
-        }
-      } else {
-        await clearUi(ix, promptMsg, options, isSlash);
-      }
-      if (options.onResolved) {
-        await options.onResolved({
-          confirmed,
-          timedOut,
-          handler: this,
-          interaction: ix,
-          question: q,
-          ...button ? {
-            button
-          } : {}
-        });
-      }
-      if (confirmed) {
-        await original.apply(this, args);
-      }
-    };
-    return descriptor;
-  };
+  return role;
 }
-__name(Confirmable, "Confirmable");
+__name(fetchRole, "fetchRole");
 
-// src/bot/errors/Channels.ts
-var ChannelNotFoundError = class extends CustomError {
+// src/bot/defaults/errors/User.ts
+var UserNotInGuild = class extends CustomError {
   static {
-    __name(this, "ChannelNotFoundError");
+    __name(this, "UserNotInGuild");
   }
-  channelId;
   /**
-   * Creates a new ChannelNotFoundError.
+   * Creates a new UserNotInGuild error.
    *
    * @param message - The error message
-   * @param channelId - The ID of the channel that could not be found
    */
-  constructor(message, channelId) {
-    super(message), this.channelId = channelId;
-    this.response.setDescription(`Channel with ID \`${this.channelId}\` not found.`);
+  constructor(message = "User is not in the guild.") {
+    super(message);
+    this.response.setDescription("User is not in the guild.");
   }
 };
-var CannotSendEmbedsError = class extends CustomError {
+var UserNotFound = class extends CustomError {
   static {
-    __name(this, "CannotSendEmbedsError");
+    __name(this, "UserNotFound");
   }
-  channelId;
+  userArg;
   /**
-   * Creates a new CannotSendEmbedsError.
+   * Creates a new UserNotFound error.
    *
-   * @param message - The error message
-   * @param channelId - The ID of the channel where embeds cannot be sent
+   * @param userArg - The user argument that could not be resolved
    */
-  constructor(message, channelId) {
-    super(message), this.channelId = channelId;
-    this.response.setDescription(`Cannot send embeds in <#${this.channelId}>.
-
-Please ensure I have the following permissions:
-\u2022 View Channel
-\u2022 Send Messages
-\u2022 Embed Links
-\u2022 Attach Files
-\u2022 Read Message History
-\u2022 Use External Emojis
-`);
+  constructor(userArg) {
+    super(`User not found: ${userArg}`), this.userArg = userArg;
+    this.response.setTitle("User Not Found").setDescription(`User probably doesn't exist or was deleted.
+**User Argument:** \`${this.userArg}\`
+Please check the user ID and try again. Only pass valid user IDs as the argument.`);
   }
 };
-var CouldNotFindChannel = class extends CustomError {
+
+// src/bot/utilities/users/fetchGuildMember.ts
+async function fetchGuildMember(guild, userId) {
+  let user = guild.members.cache.get(userId);
+  user ??= await guild.members.fetch(userId).catch(() => {
+    throw new UserNotInGuild(`User with ID ${userId} not found in guild`);
+  });
+  return user;
+}
+__name(fetchGuildMember, "fetchGuildMember");
+
+// src/bot/utilities/users/fetchManyGuildMembers.ts
+async function fetchManyGuildMembers(guild, userIds) {
+  const results = await Promise.allSettled(userIds.map((userId) => fetchGuildMember(guild, userId)));
+  return results.filter((result) => result.status === "fulfilled").map((result) => result.value);
+}
+__name(fetchManyGuildMembers, "fetchManyGuildMembers");
+async function fetchUser(client, userId) {
+  let user = client.users.cache.get(userId);
+  user ??= await client.users.fetch(userId).catch((err) => {
+    if (err instanceof discord_js.DiscordAPIError && err.code === discord_js.RESTJSONErrorCodes.UnknownUser) {
+      throw new UserNotFound(userId);
+    }
+    throw err;
+  });
+  return user;
+}
+__name(fetchUser, "fetchUser");
+
+// src/bot/utilities/users/fetchManyUsers.ts
+async function fetchManyUsers(client, userIds) {
+  const results = await Promise.allSettled(userIds.map((userId) => fetchUser(client, userId)));
+  return results.filter((result) => result.status === "fulfilled").map((result) => result.value);
+}
+__name(fetchManyUsers, "fetchManyUsers");
+
+// src/bot/utilities/users/updateMemberRoles.ts
+async function updateMemberRoles(rolesToAdd, rolesToRemove, member) {
+  const current = new Set(member.roles.cache.map((r) => r.id));
+  const toAdd = new Set(rolesToAdd);
+  const toRemove = new Set(rolesToRemove);
+  const updated = current.union(toAdd).difference(toRemove);
+  await member.roles.set([
+    ...updated
+  ]);
+}
+__name(updateMemberRoles, "updateMemberRoles");
+var EffectsEmitter = class {
   static {
-    __name(this, "CouldNotFindChannel");
+    __name(this, "EffectsEmitter");
   }
-  channelId;
+  emitter = new events.EventEmitter();
   /**
-   * Creates a new CouldNotFindChannel error.
+   * Registers a listener for the specified side effect.
    *
-   * @param message - The error message
-   * @param channelId - The ID of the channel that could not be found
+   * @typeParam KeyOfEffects - The side effect name type
+   * @param event - The side effect name to listen for
+   * @param listener - Function to call when the event is emitted
+   * @returns This EffectsEmitter instance for chaining
    */
-  constructor(message, channelId) {
-    super(message), this.channelId = channelId;
-    this.response.setDescription(`Could not find channel with ID \`${this.channelId}\`. It could also be that the channel is not a text channel.`);
-  }
-};
-var ChannelNotTextChannel = class extends CustomError {
-  static {
-    __name(this, "ChannelNotTextChannel");
+  on(event, listener) {
+    this.emitter.on(event, listener);
+    return this;
   }
-  channelId;
   /**
-   * Creates a new ChannelNotTextChannel error.
+   * Registers a one-time listener for the specified side effect.
    *
-   * @param message - The error message
-   * @param channelId - The ID of the channel that is not a text channel
+   * @typeParam KeyOfEffects - The side effect name type
+   * @param event - The side effect name to listen for once
+   * @param listener - Function to call when the event is emitted
+   * @returns This EffectsEmitter instance for chaining
    */
-  constructor(message, channelId) {
-    super(message), this.channelId = channelId;
-    this.response.setDescription(`Channel with ID \`${this.channelId}\` is not a text channel.`);
-  }
-};
-var MissingPermissions = class extends CustomError {
-  static {
-    __name(this, "MissingPermissions");
+  once(event, listener) {
+    this.emitter.once(event, listener);
+    return this;
   }
-  missingPerms;
-  roleOrChannel;
   /**
-   * Creates a new BotMissingPermissionsError.
+   * Emits a side effect with the provided data.
    *
-   * @param message - The error message
-   * @param missingPerms - Array of missing permission names
-   * @param roleOrChannel - The role or channel where permissions are missing
+   * @typeParam KeyOfEffects - The side effect name type
+   * @param event - The side effect name to emit
+   * @param data - The data to pass to registered listeners
+   * @returns True if the event had listeners, false otherwise
    */
-  constructor(message, missingPerms, roleOrChannel) {
-    super(message), this.missingPerms = missingPerms, this.roleOrChannel = roleOrChannel;
-    const missing = this.missingPerms.map((perm) => `\u2022 ${perm}`).join("\n");
-    const errorSubtext = this.roleOrChannel instanceof discord_js.Role ? `My role, <@&${this.roleOrChannel.id}>, is missing the following permissions:` : `I am missing the following permissions in <#${this.roleOrChannel.id}>:`;
-    this.response.setDescription(`${errorSubtext}
-
-Please ensure I have the following missing permission(s):
-${missing}`);
+  emit(event, data) {
+    return this.emitter.emit(event, data);
   }
 };
-var RoleHigherThanMe = class extends CustomError {
-  static {
-    __name(this, "RoleHigherThanMe");
-  }
-  role;
-  botRole;
-  /**
-   * Creates a new RoleHigherThanMe error.
-   *
-   * @param message - The error message
-   */
-  constructor(message, role, botRole) {
-    super(message), this.role = role, this.botRole = botRole;
-    this.response.setDescription(`I cannot assign a role that is higher than me.
 
-The role <@&${this.role.id}> is higher than my role <@&${this.botRole.id}> in the hierarchy.`);
-  }
-};
-var CannotAssignBotRole = class extends CustomError {
+// src/effects/EffectsHandler.ts
+var EffectsHandler = class {
   static {
-    __name(this, "CannotAssignBotRole");
+    __name(this, "EffectsHandler");
   }
+  data;
+  core;
   /**
-   * Creates a new CannotAssignBotRole error.
+   * Creates a new effects handler instance.
    *
-   * @param message - The error message
+   * @param data - The effect event data
+   * @param core - The core framework instance
    */
-  constructor(message = "I cannot assign a managed role.") {
-    super(message);
-    this.response.setDescription("I cannot assign a managed role.");
+  constructor(data, core) {
+    this.data = data;
+    this.core = core;
+    this.data = data;
+    this.core = core;
   }
 };
-var RoleDoesNotExist = class extends CustomError {
+
+// src/effects/decorators/RegisterEffect.ts
+var EffectMetadataKey = Symbol("effect:metadata");
+function RegisterEffect(effect, options) {
+  return function(constructor) {
+    const meta = {
+      effect,
+      frequency: options?.frequency
+    };
+    Reflect.defineMetadata(EffectMetadataKey, meta, constructor);
+  };
+}
+__name(RegisterEffect, "RegisterEffect");
+
+// src/effects/bases/WebhookLog.ts
+var WebhookLog = class extends EffectsHandler {
   static {
-    __name(this, "RoleDoesNotExist");
+    __name(this, "WebhookLog");
   }
-  roleId;
-  /**
-   * Creates a new RoleDoesNotExist error.
-   *
-   * @param message - The error message
-   * @param roleId - The ID of the role that doesn't exist
-   */
-  constructor(message, roleId) {
-    super(message), this.roleId = roleId;
-    this.response.setDescription(`The role with ID \`${this.roleId}\` does not exist.`);
+  constructor(data, core) {
+    super(data, core);
   }
 };
-var HasDangerousPermissions = class extends CustomError {
-  static {
-    __name(this, "HasDangerousPermissions");
-  }
-  role;
-  dangerousPerms;
-  /**
-   * Creates a new HasDangerousPermissions error.
-   *
-   * @param message - The error message
-   * @param role - The role with dangerous permissions
-   * @param dangerousPerms - Array of dangerous permission names
-   */
-  constructor(message, role, dangerousPerms) {
-    super(message), this.role = role, this.dangerousPerms = dangerousPerms;
-    const dangerous = this.dangerousPerms.map((perm) => `\u2022 ${perm}`).join("\n");
-    this.response.setDescription(`The role <@&${this.role.id}> has the following dangerous permissions:
 
-Please ensure the following dangerous permission(s) are not enabled:
-${dangerous}`);
+// src/effects/default/UnknownException.ts
+function _ts_decorate5(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate5, "_ts_decorate");
+function _ts_metadata5(k, v) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+__name(_ts_metadata5, "_ts_metadata");
+function webhookUrlValidator(raw, _fallback) {
+  if (raw === null) {
+    throw new services.SeedcordError(services.SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing);
   }
-};
-
-// src/bot/errors/User.ts
-var UserNotInGuild = class extends CustomError {
-  static {
-    __name(this, "UserNotInGuild");
+  if (typeof raw !== "string") {
+    throw new services.SeedcordError(services.SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid);
   }
-  /**
-   * Creates a new UserNotInGuild error.
-   *
-   * @param message - The error message
-   */
-  constructor(message = "User is not in the guild.") {
-    super(message);
-    this.response.setDescription("User is not in the guild.");
+  const value = raw.trim();
+  if (value === "") {
+    throw new services.SeedcordError(services.SeedcordErrorCode.ConfigUnknownExceptionWebhookMissing);
   }
-};
-var UserNotFound = class extends CustomError {
+  const pattern = String.raw`^https?:\/\/(?:canary\.|ptb\.)?discord(?:app)?\.com\/api\/webhooks\/\d+\/[\w$-]+$`;
+  const discordWebhookRegex = new RegExp(pattern);
+  if (!URL.canParse(value) || !discordWebhookRegex.test(value)) {
+    throw new services.SeedcordError(services.SeedcordErrorCode.ConfigUnknownExceptionWebhookInvalid);
+  }
+  return value;
+}
+__name(webhookUrlValidator, "webhookUrlValidator");
+exports.UnknownException = class _UnknownException extends WebhookLog {
   static {
-    __name(this, "UserNotFound");
+    __name(this, "UnknownException");
   }
-  userArg;
-  /**
-   * Creates a new UserNotFound error.
-   *
-   * @param userArg - The user argument that could not be resolved
-   */
-  constructor(userArg) {
-    super(`User not found: ${userArg}`), this.userArg = userArg;
-    this.response.setTitle("User Not Found").setDescription(`User probably doesn't exist or was deleted.
-**User Argument:** \`${this.userArg}\`
-Please check the user ID and try again. Only pass valid user IDs as the argument.`);
-  }
-};
-async function fetchText(client, channelId) {
-  if (channelId instanceof discord_js.TextChannel) {
-    return channelId;
-  }
-  let channel = client.channels.cache.get(channelId);
-  if (!channel) {
+  static logger = new services.Logger("Effect: UnknownException");
+  webhook = new discord_js.WebhookClient({
+    url: _UnknownException.unknownExceptionWebhookUrl
+  });
+  async execute() {
+    const metadataFile = this.prepareMetadataFile();
     try {
-      channel = await client.channels.fetch(channelId);
-    } catch {
-      throw new CouldNotFindChannel("Channel not found or not a text channel", channelId);
-    }
-  }
-  if (channel?.isTextBased()) {
-    return channel;
-  }
-  throw new CouldNotFindChannel("Channel not found or not a text channel", channelId);
-}
-__name(fetchText, "fetchText");
-
-// src/bot/utilities/channels/sendInText.ts
-async function sendInText(client, channelId, message) {
-  const channel = await fetchText(client, channelId);
-  return await channel.send(message);
-}
-__name(sendInText, "sendInText");
-function throwCustomError(error, message, CustomError2) {
-  const uuid = crypto.randomUUID();
-  services.Logger.Error("Throwing Custom Error", error.name);
-  if (typeof CustomError2 === typeof DatabaseError) {
-    const errorMessage = error instanceof Error ? error.message : message;
-    throw new CustomError2(errorMessage, uuid);
-  } else {
-    if (error instanceof Error) {
-      throw new CustomError2(`${message}: ${error.message ? error.message : error.toString()}`);
-    } else {
-      throw new CustomError2(message);
+      await this.webhook.send({
+        flags: "IsComponentsV2",
+        withComponents: true,
+        username: "Unknown Exception",
+        avatarURL: "https://cdn.discordapp.com/attachments/1351446034827579466/1351446912947191830/warning-2.png",
+        components: [
+          new UnhandledErrorContainer(this.data).component
+        ],
+        files: metadataFile ? [
+          metadataFile
+        ] : []
+      });
+    } catch (error) {
+      _UnknownException.logger.error("Failed to send unknown exception webhook", error);
     }
   }
-}
-__name(throwCustomError, "throwCustomError");
-
-// src/bot/utilities/messages/attemptSendDM.ts
-async function attemptSendDM(user, content) {
-  const payload = {
-    ...content.content !== void 0 && {
-      content: content.content
-    },
-    ...content.embeds !== void 0 && {
-      embeds: [
-        ...content.embeds
-      ]
-    },
-    ...content.components !== void 0 && {
-      components: [
-        ...content.components
-      ]
-    }
-  };
-  try {
-    return await user.send(payload);
-  } catch {
-    return null;
+  prepareMetadataFile() {
+    const { metadata } = this.data;
+    if (!metadata) return null;
+    const content = utils.filterCirculars(metadata);
+    return new discord_js.AttachmentBuilder(Buffer.from(JSON.stringify(content, void 0, 2), "utf-8"), {
+      name: "metadata.json",
+      description: "Metadata associated with the error"
+    });
   }
-}
-__name(attemptSendDM, "attemptSendDM");
-var PermissionNames = new Map(Object.entries(discord_js.PermissionFlagsBits).map(([key, bit]) => [
-  bit,
-  utils.prettify(key)
-]));
-var PERM_GROUPS = {
-  manage: /* @__PURE__ */ new Map([
-    [
-      discord_js.PermissionFlagsBits.ManageChannels,
-      "Manage Channels"
-    ],
-    [
-      discord_js.PermissionFlagsBits.ManageRoles,
-      "Manage Roles"
-    ],
-    [
-      discord_js.PermissionFlagsBits.ManageWebhooks,
-      "Manage Webhooks"
-    ],
-    [
-      discord_js.PermissionFlagsBits.ManageMessages,
-      "Manage Messages"
-    ],
-    [
-      discord_js.PermissionFlagsBits.ManageNicknames,
-      "Manage Nicknames"
-    ]
-  ]),
-  embed: /* @__PURE__ */ new Map([
-    [
-      discord_js.PermissionFlagsBits.ViewChannel,
-      "View Channel"
-    ],
-    [
-      discord_js.PermissionFlagsBits.SendMessages,
-      "Send Messages"
-    ],
-    [
-      discord_js.PermissionFlagsBits.EmbedLinks,
-      "Embed Links"
-    ],
-    [
-      discord_js.PermissionFlagsBits.AttachFiles,
-      "Attach Files"
-    ],
-    [
-      discord_js.PermissionFlagsBits.UseExternalEmojis,
-      "Use External Emojis"
-    ],
-    [
-      discord_js.PermissionFlagsBits.ReadMessageHistory,
-      "Read Message History"
-    ]
-  ]),
-  others: /* @__PURE__ */ new Map([
-    [
-      discord_js.PermissionFlagsBits.AddReactions,
-      "Add Reactions"
-    ],
-    [
-      discord_js.PermissionFlagsBits.UseApplicationCommands,
-      "Use Application Commands"
-    ]
-  ])
 };
-function checkPermissions(client, roleOrChannel, scope = "all", inverse = false) {
-  let required;
-  if (Array.isArray(scope)) {
-    required = /* @__PURE__ */ new Map();
-    for (const bit of scope) {
-      const name = PermissionNames.get(bit);
-      if (name) required.set(bit, name);
-    }
-  } else {
-    switch (scope) {
-      case "manage":
-        required = PERM_GROUPS.manage;
-        break;
-      case "embed":
-        required = PERM_GROUPS.embed;
-        break;
-      case "others":
-        required = new Map([
-          ...PERM_GROUPS.others,
-          ...PERM_GROUPS.embed
-        ]);
-        break;
-      default:
-        required = new Map([
-          ...PERM_GROUPS.manage,
-          ...PERM_GROUPS.others,
-          ...PERM_GROUPS.embed
-        ]);
-        break;
-    }
+_ts_decorate5([
+  envapt.Envapt("UNKNOWN_EXCEPTION_WEBHOOK_URL", {
+    converter: /* @__PURE__ */ __name((raw, fallback) => webhookUrlValidator(raw), "converter")
+  }),
+  _ts_metadata5("design:type", String)
+], exports.UnknownException, "unknownExceptionWebhookUrl", void 0);
+exports.UnknownException = _ts_decorate5([
+  RegisterEffect("unknownException")
+], exports.UnknownException);
+var DefaultSeparator = class DefaultSeparator2 extends BuilderComponent {
+  static {
+    __name(this, "DefaultSeparator");
   }
-  let permissions;
-  if (roleOrChannel instanceof discord_js.Role) {
-    permissions = roleOrChannel.permissions;
-  } else {
-    if (!client.user) {
-      throw new services.SeedcordError(services.SeedcordErrorCode.CoreClientUserUnavailable);
-    }
-    permissions = roleOrChannel.permissionsFor(client.user, true);
+  constructor() {
+    super("separator");
+    this.instance.setSpacing(discord_js.SeparatorSpacingSize.Small).setDivider(true);
   }
-  if (!permissions) {
-    throw new MissingPermissions("Missing Permissions", Array.from(required.values()), roleOrChannel);
+};
+var UnhandledErrorContainer = class UnhandledErrorContainer2 extends BuilderComponent {
+  static {
+    __name(this, "UnhandledErrorContainer");
   }
-  if (inverse) {
-    const dangerous = Array.from(required.entries()).filter(([bit]) => permissions.has(bit, true)).map(([, name]) => name);
-    if (dangerous.length > 0) {
-      throw new HasDangerousPermissions("Role has dangerous permissions", roleOrChannel, dangerous);
-    }
-  } else {
-    const missing = Array.from(required.entries()).filter(([bit]) => !permissions.has(bit, true)).map(([, name]) => name);
-    if (missing.length > 0) {
-      throw new MissingPermissions("Missing Permissions", missing, roleOrChannel);
-    }
+  constructor(data) {
+    super("container");
+    const { uuid, error, guild, user, metadata } = data;
+    this.instance.addTextDisplayComponents((text) => text.setContent(`### An unknown exception was thrown
+**Guild ID:** \`${guild?.id ?? "Not used in a guild"}\`
+**Guild Name:** ${guild?.name ?? "Not used in a guild"}
+**User ID:** \`${user?.id ?? "Missing user info"}\`
+**Username:** ${user?.username ?? "Missing user info"}
+`)).addSeparatorComponents(new DefaultSeparator().component).addTextDisplayComponents((text) => text.setContent(`### UUID \`${uuid}\`
+\`\`\`${error.stack}\`\`\``));
+    this.addTimestampsIfAvailable(error);
+    this.addMetadataIfAvailable(metadata);
   }
-}
-__name(checkPermissions, "checkPermissions");
-function getBotRole(client, guild) {
-  if (!client.user) {
-    throw new services.SeedcordError(services.SeedcordErrorCode.CoreClientUserUnavailable);
+  addTimestampsIfAvailable(error) {
+    if (!(error instanceof discord_js.DiscordAPIError)) return;
+    const now = Date.now();
+    const snowflake = error.url.match(/\/interactions\/(\d+)\//)?.[1];
+    if (!snowflake) return void 0;
+    const interactionTs = Number(discord_js.SnowflakeUtil.deconstruct(snowflake).timestamp);
+    const diff = now - interactionTs;
+    const seconds = Math.floor(diff / 1e3);
+    const millis = diff % 1e3;
+    this.instance.addSeparatorComponents(new DefaultSeparator().component).addTextDisplayComponents((text) => text.setContent(`### Timestamps
+- **\`Interaction sent\` :** ${new Date(interactionTs).toISOString()} (${interactionTs})
+- **\`Error logged    \` :** ${new Date(now).toISOString()} (${now})
+- **\`Offset          \` :** ${seconds}s ${millis}ms`));
   }
-  const botRole = guild.roles.botRoleFor(client.user);
-  if (!botRole) {
-    throw new services.SeedcordError(services.SeedcordErrorCode.CoreBotRoleMissing, [
-      guild.id
-    ]);
+  addMetadataIfAvailable(metadata) {
+    if (!metadata) return;
+    this.instance.addSeparatorComponents(new DefaultSeparator().component).addTextDisplayComponents((text) => text.setContent("### Metadata")).addFileComponents((file) => file.setURL("attachment://metadata.json"));
   }
-  return botRole;
-}
-__name(getBotRole, "getBotRole");
+};
 
-// src/bot/utilities/roles/checkBotPermissions.ts
-function checkBotPermissions(client, guildOrChannel, scope = "all", inverse = false) {
-  if (guildOrChannel instanceof discord_js.Guild) {
-    const botRole = getBotRole(client, guildOrChannel);
-    checkPermissions(client, botRole, scope, inverse);
-  } else {
-    checkPermissions(client, guildOrChannel, scope);
+// src/effects/EffectsRegistry.ts
+var EffectsRegistry = class extends Plugin {
+  static {
+    __name(this, "EffectsRegistry");
   }
-}
-__name(checkBotPermissions, "checkBotPermissions");
-async function fetchRole(clientOrGuild, roleId) {
-  let role;
-  if (!roleId) {
-    throw new RoleDoesNotExist("Role ID is null or undefined", roleId);
+  core;
+  logger = new services.Logger("Effects");
+  isInitialized = false;
+  effectsMap = new discord_js.Collection();
+  emitter = new EffectsEmitter();
+  constructor(core) {
+    super(core), this.core = core;
   }
-  if (clientOrGuild instanceof discord_js.Guild) {
-    const guild = clientOrGuild;
-    role = guild.roles.cache.get(roleId);
-    if (!role) {
-      try {
-        role = await guild.roles.fetch(roleId);
-      } catch {
-        throw new RoleDoesNotExist("Role not found in specified guild", roleId);
-      }
-    }
-  } else {
-    const client = clientOrGuild;
-    role = client.guilds.cache.map((guild) => guild.roles.cache.get(roleId)).find((role2) => role2);
-    if (!role) {
-      const guilds = client.guilds.cache;
-      for (const guild of guilds.values()) {
-        try {
-          role = await guild.roles.fetch(roleId);
-          if (role) break;
-        } catch {
-          continue;
+  async init() {
+    if (this.isInitialized) return;
+    this.isInitialized = true;
+    const effectsDir = this.core.config.effects.path;
+    this.logger.info(chalk3__default.default.bold(effectsDir));
+    this.registerEffect(exports.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(`${chalk3__default.default.bold.green("Loaded")}: ${chalk3__default.default.bold.magenta(totalEffects)} side effects`);
+  }
+  async loadEffects(dir) {
+    await utils.traverseDirectory(dir, (_fullPath, relativePath, imported) => {
+      for (const exportName of Object.keys(imported)) {
+        const val = imported[exportName];
+        if (this.isEffectHandler(val)) {
+          const meta = Reflect.getMetadata(EffectMetadataKey, val);
+          this.registerEffect(val, meta);
+          this.logger.info(`${chalk3__default.default.italic("Registered")} ${chalk3__default.default.bold.yellow(val.name)} from ${chalk3__default.default.gray(relativePath)}`);
         }
       }
+    }, this.logger);
+  }
+  registerEffect(handler, options) {
+    let handlers = this.effectsMap.get(options.effect);
+    if (!handlers) {
+      handlers = [];
+      this.effectsMap.set(options.effect, handlers);
     }
+    handlers.push({
+      ctor: handler,
+      frequency: options.frequency ?? "on"
+    });
   }
-  if (!role) {
-    throw new RoleDoesNotExist("Role not found", roleId);
+  isEffectHandler(obj) {
+    if (typeof obj !== "function") return false;
+    return obj.prototype instanceof EffectsHandler && Reflect.hasMetadata(EffectMetadataKey, obj);
   }
-  return role;
-}
-__name(fetchRole, "fetchRole");
-function hasPermsToAssign(targetRole) {
-  const botRole = getBotRole(targetRole.client, targetRole.guild);
-  if (targetRole.comparePositionTo(botRole) >= 0) {
-    throw new RoleHigherThanMe("Role is higher than me", targetRole, botRole);
+  attachEffects() {
+    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 entry.ctor(data, this.core);
+            void instance.execute();
+          } catch (err) {
+            this.logger.error(`Error in side effect ${String(effectName)} handler ${entry.ctor.name}:`, err);
+          }
+        });
+      }
+    }
   }
-  if (targetRole.managed) {
-    throw new CannotAssignBotRole(`Cannot assign bot role ${targetRole.name}`);
+  emit(event, data) {
+    return this.emitter.emit(event, data);
   }
-  checkBotPermissions(targetRole.client, targetRole.guild, [
-    discord_js.PermissionFlagsBits.ManageRoles
-  ]);
-}
-__name(hasPermsToAssign, "hasPermsToAssign");
-
-// src/bot/utilities/users/fetchGuildMember.ts
-async function fetchGuildMember(guild, userId) {
-  let user = guild.members.cache.get(userId);
-  user ??= await guild.members.fetch(userId).catch(() => {
-    throw new UserNotInGuild(`User with ID ${userId} not found in guild`);
-  });
-  return user;
-}
-__name(fetchGuildMember, "fetchGuildMember");
-
-// src/bot/utilities/users/fetchManyGuildMembers.ts
-async function fetchManyGuildMembers(guild, userIds) {
-  const results = await Promise.allSettled(userIds.map((userId) => fetchGuildMember(guild, userId)));
-  return results.filter((result) => result.status === "fulfilled").map((result) => result.value);
-}
-__name(fetchManyGuildMembers, "fetchManyGuildMembers");
-async function fetchUser(client, userId) {
-  let user = client.users.cache.get(userId);
-  user ??= await client.users.fetch(userId).catch((err) => {
-    if (err instanceof discord_js.DiscordAPIError && err.code === discord_js.RESTJSONErrorCodes.UnknownUser) {
-      throw new UserNotFound(userId);
+};
+var Seedcord = class _Seedcord extends Pluggable {
+  static {
+    __name(this, "Seedcord");
+  }
+  config;
+  static isInstantiated = false;
+  /** @see {@link CoordinatedShutdown} */
+  shutdown;
+  /** @see {@link CoordinatedStartup} */
+  startup;
+  /** @see {@link EffectsRegistry} */
+  effects;
+  /** @see {@link Bot} */
+  bot;
+  /** @see {@link HealthCheck} */
+  healthCheck;
+  /**
+   * Creates a new Seedcord instance
+   *
+   * @param config - Bot configuration including paths and Discord client options
+   * @throws An {@link SeedcordError} When attempting to create multiple instances (singleton)
+   */
+  constructor(config) {
+    const shutdown = new services.CoordinatedShutdown();
+    const startup = new services.CoordinatedStartup();
+    super(shutdown, startup), this.config = config;
+    this.shutdown = shutdown;
+    this.startup = startup;
+    if (_Seedcord.isInstantiated) {
+      throw new services.SeedcordError(services.SeedcordErrorCode.CoreSingletonViolation);
     }
-    throw err;
-  });
-  return user;
-}
-__name(fetchUser, "fetchUser");
-
-// src/bot/utilities/users/fetchManyUsers.ts
-async function fetchManyUsers(client, userIds) {
-  const results = await Promise.allSettled(userIds.map((userId) => fetchUser(client, userId)));
-  return results.filter((result) => result.status === "fulfilled").map((result) => result.value);
-}
-__name(fetchManyUsers, "fetchManyUsers");
-
-// src/bot/utilities/users/updateMemberRoles.ts
-async function updateMemberRoles(rolesToAdd, rolesToRemove, member) {
-  const current = new Set(member.roles.cache.map((r) => r.id));
-  const toAdd = new Set(rolesToAdd);
-  const toRemove = new Set(rolesToRemove);
-  const updated = current.union(toAdd).difference(toRemove);
-  await member.roles.set([
-    ...updated
-  ]);
-}
-__name(updateMemberRoles, "updateMemberRoles");
+    _Seedcord.isInstantiated = true;
+    this.effects = new EffectsRegistry(this);
+    this.bot = new Bot(this);
+    this.healthCheck = new services.HealthCheck(this.shutdown);
+    this.registerStartupTasks();
+  }
+  /**
+   * Registers default startup tasks
+   * @internal
+   */
+  registerStartupTasks() {
+    this.startup.addTask(services.StartupPhase.Configuration, "Effect Initialization", async () => {
+      this.effects.logger.info(chalk3__default.default.bold("Initializing"));
+      await this.effects.init();
+      this.effects.logger.info(chalk3__default.default.bold("Initialized"));
+    });
+    this.startup.addTask(services.StartupPhase.Instantiation, "Bot Initialization", async () => {
+      this.bot.logger.info(chalk3__default.default.bold("Initializing"));
+      await this.bot.init();
+      this.bot.logger.info(chalk3__default.default.bold("Initialized"));
+    });
+    this.startup.addTask(services.StartupPhase.Ready, "Health Check", async () => {
+      this.healthCheck.logger.info(chalk3__default.default.bold("Initializing"));
+      await this.healthCheck.init();
+      this.healthCheck.logger.info(chalk3__default.default.bold("Initialized"));
+    });
+  }
+  /**
+   * Starts the bot and runs all initialization tasks
+   *
+   * @returns This Seedcord instance when fully initialized
+   */
+  async start() {
+    await super.init();
+    return this;
+  }
+};
 
 exports.AutocompleteHandler = AutocompleteHandler;
 exports.AutocompleteRoute = AutocompleteRoute;
@@ -2524,7 +2497,6 @@ exports.MiddlewareMetadataKey = MiddlewareMetadataKey;
 exports.MiddlewareType = MiddlewareType;
 exports.MissingPermissions = MissingPermissions;
 exports.ModalRoute = ModalRoute;
-exports.PERM_GROUPS = PERM_GROUPS;
 exports.PermissionNames = PermissionNames;
 exports.Pluggable = Pluggable;
 exports.Plugin = Plugin;
@@ -2547,6 +2519,8 @@ exports.attemptSendDM = attemptSendDM;
 exports.buildSlashRoute = buildSlashRoute;
 exports.checkBotPermissions = checkBotPermissions;
 exports.checkPermissions = checkPermissions;
+exports.ensureBotPermissions = ensureBotPermissions;
+exports.ensurePermissions = ensurePermissions;
 exports.extractErrorResponse = extractErrorResponse;
 exports.fetchGuildMember = fetchGuildMember;
 exports.fetchManyGuildMembers = fetchManyGuildMembers;