seedcord 0.2.1 → 0.4.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { Logger, CoordinatedShutdown, CoordinatedStartup, StartupPhase } from '@seedcord/services';
 export * from '@seedcord/services';
-import { ClientOptions, Guild, User, Client, ChatInputCommandInteraction, ButtonInteraction, ModalSubmitInteraction, AutocompleteInteraction, AnySelectMenuInteraction, ContextMenuCommandInteraction, ClientEvents, Events, AutocompleteFocusedOption, SlashCommandBuilder, EmbedBuilder, ButtonBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, UserSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder, RoleSelectMenuBuilder, ModalBuilder, ContextMenuCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, ContainerBuilder, TextDisplayBuilder, FileBuilder, MediaGalleryBuilder, SectionBuilder, SeparatorBuilder, ActionRowBuilder, TextInputBuilder, WebhookClient } from 'discord.js';
+import { ClientOptions, Guild, User, SlashCommandBuilder, ContextMenuCommandBuilder, Collection, Client, ChatInputCommandInteraction, ButtonInteraction, ModalSubmitInteraction, AutocompleteInteraction, AnySelectMenuInteraction, ContextMenuCommandInteraction, ClientEvents, Events, AutocompleteFocusedOption, EmbedBuilder, ButtonBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, UserSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder, RoleSelectMenuBuilder, ModalBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, ContainerBuilder, TextDisplayBuilder, FileBuilder, MediaGalleryBuilder, SectionBuilder, SeparatorBuilder, ActionRowBuilder, TextInputBuilder, WebhookClient } from 'discord.js';
 import { Nullable, Tail, TypedConstructor, ConstructorFunction } from '@seedcord/types';
 export * from '@seedcord/types';
 import { UUID } from 'crypto';
@@ -14,6 +14,7 @@ interface InteractionsConfig {
      * Path to dir containing interaction handlers.
      */
     path: string;
+    ignoreCustomIds?: string[];
 }
 /**
  * Djs Events handlers
@@ -54,9 +55,41 @@ interface BotConfig {
      */
     clientOptions: ClientOptions;
     /**
-     * Optional emoji mappings for the bot
+     * Optional emoji mappings. Pass an object with emojis mappings (e.g. below). These emojis will be loaded from the Application Emojis that you've uploaded via the Dev-Dashboard
+     *
+     * Key: The name of the object key you want to use in your codebase
+     *
+     * Value: The emoji identifier used in Discord
+     *
+     * @example
+     * ```ts
+     * const Emojis = {
+     *   ThumbsUp: 'thumbsup',
+     *   ThumbsDown: 'thumbsdown',
+     *   Lol: 'lol_1',
+     *   Kek: 'keklmao',
+     * };
+     * ```
+     *
+     * will turn into
+     *
+     * @example
+     * ```ts
+     * const Emojis = {
+     *   ThumbsUp: '<:thumbsup:1872389747982323423>',
+     *   ThumbsDown: '<:thumbsdown:1872389747982323424>',
+     *   Lol: '<:lol_1:1872389747982323425>',
+     *   Kek: '<a:keklmao:1872389747982323426>',
+     * };
+     * ```
      */
     emojis?: Record<string, string>;
+    /**
+     * Whether to show the error stack trace in the terminal in errors caught by the `@Catchable` decorator
+     *
+     * `false` by default
+     */
+    errorStack?: boolean;
 }
 /** Main configuration object for Seedcord bot */
 interface Config {
@@ -231,6 +264,28 @@ declare class Pluggable {
     attach<Key extends string, Ctor extends PluginCtor>(this: this, key: Key, Plugin: Ctor, startupPhase: StartupPhase, ...args: PluginArgs<Ctor>): this & Record<Key, InstanceType<Ctor>>;
 }
 
+/**
+ * Manages Discord application command registration and deployment.
+ *
+ * Scans command directories, builds command structures, and handles both
+ * global and guild-specific command deployment to Discord's API.
+ *
+ * @internal
+ */
+declare class CommandRegistry implements Initializeable {
+    private readonly core;
+    private readonly logger;
+    private isInitialised;
+    readonly globalCommands: (SlashCommandBuilder | ContextMenuCommandBuilder)[];
+    readonly guildCommands: Collection<string, (SlashCommandBuilder | ContextMenuCommandBuilder)[]>;
+    constructor(core: Core);
+    init(): Promise<void>;
+    private loadCommands;
+    private isCommandClass;
+    private registerCommand;
+    setCommands(): Promise<void>;
+}
+
 /**
  * Discord bot implementation that manages client and controllers
  * @internal - Accessed via core.bot, not directly instantiated by users
@@ -243,7 +298,7 @@ declare class Bot extends Plugin {
     private readonly _client;
     private readonly interactions;
     private readonly events;
-    private readonly commands;
+    readonly commands: CommandRegistry;
     private readonly emojiInjector;
     /**
      * @param core - Seedcord core instance
@@ -611,7 +666,7 @@ declare class BaseErrorEmbed extends BuilderComponent<'embed'> {
  */
 declare abstract class CustomError extends Error {
     message: string;
-    protected _emit: boolean;
+    private _emit;
     readonly response: EmbedBuilder;
     protected constructor(message: string);
     /**
@@ -623,6 +678,12 @@ declare abstract class CustomError extends Error {
      * @returns True if the error should be logged
      */
     get emit(): boolean;
+    /**
+     * Sets whether this error should be emitted to logs
+     *
+     * @see {@link emit}
+     */
+    set emit(value: boolean);
 }
 /** Constructor type for custom error classes */
 type CustomErrorConstructor = new (message: string, ...args: any[]) => CustomError;
@@ -946,7 +1007,6 @@ declare abstract class WebhookLog<KeyOfEffects extends EffectKeys> extends Effec
  */
 declare class DatabaseError extends CustomError {
     uuid: UUID;
-    protected _emit: boolean;
     /**
      * Creates a new DatabaseError.
      *

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Logger, CoordinatedShutdown, CoordinatedStartup, StartupPhase } from '@seedcord/services';
 export * from '@seedcord/services';
-import { ClientOptions, Guild, User, Client, ChatInputCommandInteraction, ButtonInteraction, ModalSubmitInteraction, AutocompleteInteraction, AnySelectMenuInteraction, ContextMenuCommandInteraction, ClientEvents, Events, AutocompleteFocusedOption, SlashCommandBuilder, EmbedBuilder, ButtonBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, UserSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder, RoleSelectMenuBuilder, ModalBuilder, ContextMenuCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, ContainerBuilder, TextDisplayBuilder, FileBuilder, MediaGalleryBuilder, SectionBuilder, SeparatorBuilder, ActionRowBuilder, TextInputBuilder, WebhookClient } from 'discord.js';
+import { ClientOptions, Guild, User, SlashCommandBuilder, ContextMenuCommandBuilder, Collection, Client, ChatInputCommandInteraction, ButtonInteraction, ModalSubmitInteraction, AutocompleteInteraction, AnySelectMenuInteraction, ContextMenuCommandInteraction, ClientEvents, Events, AutocompleteFocusedOption, EmbedBuilder, ButtonBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, UserSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder, RoleSelectMenuBuilder, ModalBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, ContainerBuilder, TextDisplayBuilder, FileBuilder, MediaGalleryBuilder, SectionBuilder, SeparatorBuilder, ActionRowBuilder, TextInputBuilder, WebhookClient } from 'discord.js';
 import { Nullable, Tail, TypedConstructor, ConstructorFunction } from '@seedcord/types';
 export * from '@seedcord/types';
 import { UUID } from 'crypto';
@@ -14,6 +14,7 @@ interface InteractionsConfig {
      * Path to dir containing interaction handlers.
      */
     path: string;
+    ignoreCustomIds?: string[];
 }
 /**
  * Djs Events handlers
@@ -54,9 +55,41 @@ interface BotConfig {
      */
     clientOptions: ClientOptions;
     /**
-     * Optional emoji mappings for the bot
+     * Optional emoji mappings. Pass an object with emojis mappings (e.g. below). These emojis will be loaded from the Application Emojis that you've uploaded via the Dev-Dashboard
+     *
+     * Key: The name of the object key you want to use in your codebase
+     *
+     * Value: The emoji identifier used in Discord
+     *
+     * @example
+     * ```ts
+     * const Emojis = {
+     *   ThumbsUp: 'thumbsup',
+     *   ThumbsDown: 'thumbsdown',
+     *   Lol: 'lol_1',
+     *   Kek: 'keklmao',
+     * };
+     * ```
+     *
+     * will turn into
+     *
+     * @example
+     * ```ts
+     * const Emojis = {
+     *   ThumbsUp: '<:thumbsup:1872389747982323423>',
+     *   ThumbsDown: '<:thumbsdown:1872389747982323424>',
+     *   Lol: '<:lol_1:1872389747982323425>',
+     *   Kek: '<a:keklmao:1872389747982323426>',
+     * };
+     * ```
      */
     emojis?: Record<string, string>;
+    /**
+     * Whether to show the error stack trace in the terminal in errors caught by the `@Catchable` decorator
+     *
+     * `false` by default
+     */
+    errorStack?: boolean;
 }
 /** Main configuration object for Seedcord bot */
 interface Config {
@@ -231,6 +264,28 @@ declare class Pluggable {
     attach<Key extends string, Ctor extends PluginCtor>(this: this, key: Key, Plugin: Ctor, startupPhase: StartupPhase, ...args: PluginArgs<Ctor>): this & Record<Key, InstanceType<Ctor>>;
 }
 
+/**
+ * Manages Discord application command registration and deployment.
+ *
+ * Scans command directories, builds command structures, and handles both
+ * global and guild-specific command deployment to Discord's API.
+ *
+ * @internal
+ */
+declare class CommandRegistry implements Initializeable {
+    private readonly core;
+    private readonly logger;
+    private isInitialised;
+    readonly globalCommands: (SlashCommandBuilder | ContextMenuCommandBuilder)[];
+    readonly guildCommands: Collection<string, (SlashCommandBuilder | ContextMenuCommandBuilder)[]>;
+    constructor(core: Core);
+    init(): Promise<void>;
+    private loadCommands;
+    private isCommandClass;
+    private registerCommand;
+    setCommands(): Promise<void>;
+}
+
 /**
  * Discord bot implementation that manages client and controllers
  * @internal - Accessed via core.bot, not directly instantiated by users
@@ -243,7 +298,7 @@ declare class Bot extends Plugin {
     private readonly _client;
     private readonly interactions;
     private readonly events;
-    private readonly commands;
+    readonly commands: CommandRegistry;
     private readonly emojiInjector;
     /**
      * @param core - Seedcord core instance
@@ -611,7 +666,7 @@ declare class BaseErrorEmbed extends BuilderComponent<'embed'> {
  */
 declare abstract class CustomError extends Error {
     message: string;
-    protected _emit: boolean;
+    private _emit;
     readonly response: EmbedBuilder;
     protected constructor(message: string);
     /**
@@ -623,6 +678,12 @@ declare abstract class CustomError extends Error {
      * @returns True if the error should be logged
      */
     get emit(): boolean;
+    /**
+     * Sets whether this error should be emitted to logs
+     *
+     * @see {@link emit}
+     */
+    set emit(value: boolean);
 }
 /** Constructor type for custom error classes */
 type CustomErrorConstructor = new (message: string, ...args: any[]) => CustomError;
@@ -946,7 +1007,6 @@ declare abstract class WebhookLog<KeyOfEffects extends EffectKeys> extends Effec
  */
 declare class DatabaseError extends CustomError {
     uuid: UUID;
-    protected _emit: boolean;
     /**
      * Creates a new DatabaseError.
      *

package/dist/index.mjs

@@ -2,7 +2,7 @@ import 'reflect-metadata';
 import { Logger, ShutdownPhase, CoordinatedShutdown, CoordinatedStartup, HealthCheck, StartupPhase } from '@seedcord/services';
 export * from '@seedcord/services';
 import chalk2 from 'chalk';
-import { SeparatorBuilder, SectionBuilder, MediaGalleryBuilder, FileBuilder, TextDisplayBuilder, ContainerBuilder, SlashCommandSubcommandGroupBuilder, SlashCommandSubcommandBuilder, ContextMenuCommandBuilder, ModalBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder, ChannelSelectMenuBuilder, UserSelectMenuBuilder, StringSelectMenuOptionBuilder, StringSelectMenuBuilder, ButtonBuilder, EmbedBuilder, SlashCommandBuilder, InteractionContextType, ActionRowBuilder, TextInputBuilder, MessageFlags, Events, Client, WebhookClient, DiscordAPIError, SnowflakeUtil, Message } from 'discord.js';
+import { SeparatorBuilder, SectionBuilder, MediaGalleryBuilder, FileBuilder, TextDisplayBuilder, ContainerBuilder, SlashCommandSubcommandGroupBuilder, SlashCommandSubcommandBuilder, ContextMenuCommandBuilder, ModalBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder, ChannelSelectMenuBuilder, UserSelectMenuBuilder, StringSelectMenuOptionBuilder, StringSelectMenuBuilder, ButtonBuilder, EmbedBuilder, SlashCommandBuilder, InteractionContextType, ActionRowBuilder, TextInputBuilder, Collection, MessageFlags, Events, Client, WebhookClient, DiscordAPIError, SnowflakeUtil, Message } from 'discord.js';
 import { Envapt } from 'envapt';
 import { traverseDirectory } from '@seedcord/utils';
 export * from '@seedcord/utils';
@@ -247,6 +247,14 @@ var CustomError = class extends Error {
   get emit() {
     return this._emit;
   }
+  /**
+  * Sets whether this error should be emitted to logs
+  *
+  * @see {@link emit}
+  */
+  set emit(value) {
+    this._emit = value;
+  }
 };
 
 // src/bot/decorators/CommandRegisterable.ts
@@ -273,7 +281,7 @@ var CommandRegistry = class {
   logger = new Logger("Commands");
   isInitialised = false;
   globalCommands = [];
-  guildCommands = /* @__PURE__ */ new Map();
+  guildCommands = new Collection();
   constructor(core) {
     this.core = core;
   }
@@ -436,7 +444,7 @@ var EventController = class {
   core;
   logger = new Logger("Events");
   isInitialized = false;
-  eventMap = /* @__PURE__ */ new Map();
+  eventMap = new Collection();
   constructor(core) {
     this.core = core;
   }
@@ -612,7 +620,6 @@ var DatabaseError = class extends CustomError {
     __name(this, "DatabaseError");
   }
   uuid;
-  _emit = true;
   /**
   * Creates a new DatabaseError.
   *
@@ -621,6 +628,7 @@ var DatabaseError = class extends CustomError {
   */
   constructor(message, uuid) {
     super(message), this.uuid = uuid;
+    this.emit = true;
     this.name = "DatabaseError";
     this.response.setTitle("Database Error").setDescription(`An error occurred while interacting with the database.
 ### UUID: \`${this.uuid}\``);
@@ -664,7 +672,9 @@ var ErrorHandlingUtils = class {
         response: error.response
       };
     }
-    this.logger.error(uuid, error);
+    const showStack = core.config.bot.errorStack;
+    if (showStack) this.logger.error(uuid, error);
+    else this.logger.error(`${uuid} | ${error.message}`);
     core.effects.emit("unknownException", {
       uuid,
       error,
@@ -775,24 +785,25 @@ var InteractionController = class {
   core;
   logger = new Logger("Interactions");
   isInitialized = false;
-  slashMap = /* @__PURE__ */ new Map();
-  buttonMap = /* @__PURE__ */ new Map();
-  modalMap = /* @__PURE__ */ new Map();
-  stringSelectMap = /* @__PURE__ */ new Map();
-  userSelectMap = /* @__PURE__ */ new Map();
-  roleSelectMap = /* @__PURE__ */ new Map();
-  channelSelectMap = /* @__PURE__ */ new Map();
-  mentionableSelectMap = /* @__PURE__ */ new Map();
-  messageContextMenuMap = /* @__PURE__ */ new Map();
-  userContextMenuMap = /* @__PURE__ */ new Map();
-  autocompleteMap = /* @__PURE__ */ new Map();
-  keysToIgnore = /* @__PURE__ */ new Set([
-    "confirm!confirmable",
-    "cancel!confirmable"
-  ]);
+  slashMap = new Collection();
+  buttonMap = new Collection();
+  modalMap = new Collection();
+  stringSelectMap = new Collection();
+  userSelectMap = new Collection();
+  roleSelectMap = new Collection();
+  channelSelectMap = new Collection();
+  mentionableSelectMap = new Collection();
+  messageContextMenuMap = new Collection();
+  userContextMenuMap = new Collection();
+  autocompleteMap = new Collection();
+  keysToIgnore = /* @__PURE__ */ new Set();
   middlewares = [];
   constructor(core) {
     this.core = core;
+    const ignoredKeysFromConfig = this.core.config.bot.interactions.ignoreCustomIds;
+    if (ignoredKeysFromConfig) {
+      for (const ignoredKey of ignoredKeysFromConfig) this.keysToIgnore.add(ignoredKey);
+    }
   }
   async init() {
     if (this.isInitialized) return;
@@ -1211,6 +1222,7 @@ _ts_decorate4([
   Envapt("UNKNOWN_EXCEPTION_WEBHOOK_URL", {
     converter(raw, _fallback) {
       if (!raw) throw new Error("Missing UNKNOWN_EXCEPTION_WEBHOOK_URL");
+      if (!URL.canParse(String(raw))) throw new Error("Invalid UNKNOWN_EXCEPTION_WEBHOOK_URL");
       return raw;
     }
   }),
@@ -1304,7 +1316,7 @@ var EffectsRegistry = class extends Plugin {
   core;
   logger = new Logger("Effects");
   isInitialized = false;
-  effectsMap = /* @__PURE__ */ new Map();
+  effectsMap = new Collection();
   emitter = new EffectsEmitter();
   constructor(core) {
     super(core), this.core = core;