seedcord 0.11.0 → 0.12.0-next.1

package/dist/Components-Drs0KoOi.d.mts

@@ -0,0 +1,151 @@
+import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, CheckboxBuilder, CheckboxGroupBuilder, CheckboxGroupOptionBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RadioGroupBuilder, RadioGroupOptionBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder } from "discord.js";
+
+//#region src/interfaces/Components.d.ts
+/**
+ * Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.
+ *
+ * @internal
+ */
+declare const BuilderTypes: {
+  command: typeof SlashCommandBuilder;
+  context_menu: typeof ContextMenuCommandBuilder;
+  subcommand: typeof SlashCommandSubcommandBuilder;
+  group: typeof SlashCommandSubcommandGroupBuilder;
+  embed: typeof EmbedBuilder;
+  modal: typeof ModalBuilder;
+  label: typeof LabelBuilder;
+  text_input: typeof TextInputBuilder;
+  file_upload: typeof FileUploadBuilder;
+  checkbox: typeof CheckboxBuilder;
+  checkbox_group: typeof CheckboxGroupBuilder;
+  checkbox_group_option: typeof CheckboxGroupOptionBuilder;
+  radio_group: typeof RadioGroupBuilder;
+  radio_group_option: typeof RadioGroupOptionBuilder;
+  button: typeof ButtonBuilder;
+  menu_string: typeof StringSelectMenuBuilder;
+  menu_option_string: typeof StringSelectMenuOptionBuilder;
+  menu_user: typeof UserSelectMenuBuilder;
+  menu_channel: typeof ChannelSelectMenuBuilder;
+  menu_mentionable: typeof MentionableSelectMenuBuilder;
+  menu_role: typeof RoleSelectMenuBuilder;
+  container: typeof ContainerBuilder;
+  text_display: typeof TextDisplayBuilder;
+  file: typeof FileBuilder;
+  media: typeof MediaGalleryBuilder;
+  section: typeof SectionBuilder;
+  separator: typeof SeparatorBuilder;
+};
+/**
+ * Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons
+ *
+ * @internal
+ */
+declare const RowTypes: {
+  button: typeof ActionRowBuilder<ButtonBuilder>;
+  menu_string: typeof ActionRowBuilder<StringSelectMenuBuilder>;
+  menu_user: typeof ActionRowBuilder<UserSelectMenuBuilder>;
+  menu_channel: typeof ActionRowBuilder<ChannelSelectMenuBuilder>;
+  menu_mentionable: typeof ActionRowBuilder<MentionableSelectMenuBuilder>;
+  menu_role: typeof ActionRowBuilder<RoleSelectMenuBuilder>;
+};
+/**
+ * Available Discord.js builder types for use with BuilderComponent
+ */
+type BuilderType = keyof typeof BuilderTypes;
+/**
+ * @internal
+ */
+type InstantiatedBuilder<BuilderKey extends BuilderType> = InstanceType<(typeof BuilderTypes)[BuilderKey]>;
+/**
+ * Available Discord.js action row types for use with RowComponent
+ */
+type RowType = keyof typeof RowTypes;
+/**
+ * @internal
+ */
+type InstantiatedActionRow<RowKey extends RowType> = InstanceType<(typeof RowTypes)[RowKey]>;
+/**
+ * Base class for Discord component wrappers
+ *
+ * Provides common functionality for building Discord components with proper typing.
+ *
+ * @typeParam TComponent - The Discord.js component type being wrapped
+ *
+ * @internal
+ */
+declare abstract class BaseComponent<TComponent> {
+  private readonly _component;
+  protected constructor(ComponentClass: new () => TComponent);
+  /**
+   * Gets the built component (should be considered read-only)
+   *
+   * Returns the finalized component ready for use in Discord messages.
+   *
+   * Please do not use for further configuration, use `this.instance` for that.
+   * @example new SomeComponent().component
+   */
+  abstract get component(): InstantiatedBuilder<BuilderType> | InstantiatedActionRow<RowType>;
+  /**
+   * Gets the component instance for configuration
+   *
+   * Use this to access Discord.js builder methods like setTitle(), setDescription(), etc.
+   *
+   * Use this in your component classes to configure the builder
+   * @example this.instance.setTitle('My Modal')
+   */
+  protected get instance(): TComponent;
+}
+/**
+ * Base class for Discord.js builder components
+ *
+ * Wraps Discord.js builders (SlashCommandBuilder, EmbedBuilder, etc.) with
+ * Seedcord-specific defaults and helper methods.
+ *
+ * @typeParam BuilderKey - The type of Discord.js builder being wrapped
+ */
+declare abstract class BuilderComponent<BuilderKey extends BuilderType> extends BaseComponent<InstantiatedBuilder<BuilderKey>> {
+  readonly type: BuilderKey;
+  private colorApplied;
+  protected constructor(type: BuilderKey);
+  get component(): InstantiatedBuilder<BuilderKey>;
+  private applyBotColor;
+}
+/**
+ * Base class for Discord action row components
+ *
+ * Wraps Discord.js action row builder with Seedcord-specific defaults and helper methods.
+ *
+ * @typeParam RowKey - The Discord.js action row type being wrapped
+ */
+declare abstract class RowComponent<RowKey extends RowType> extends BaseComponent<InstantiatedActionRow<RowKey>> {
+  readonly type: RowKey;
+  protected constructor(type: RowKey);
+  get component(): InstantiatedActionRow<RowKey>;
+}
+/**
+ * Base class for custom error types with Discord embed responses
+ *
+ * Errors extending CustomError should be used with the `Catchable` decorators to implement a control flow. These errors will be caught and handled by the framework to show the user the configured response.
+ */
+declare abstract class CustomError extends Error {
+  message: string;
+  private _emit;
+  readonly response: EmbedBuilder;
+  protected constructor(message: string);
+  /**
+   * Whether this error should be emitted to logs
+   *
+   * Controls logging behavior. Errors with emit=true will always be logged,
+   * while emit=false errors may be suppressed in production.
+   *
+   * @returns True if the error should be logged
+   */
+  get emit(): boolean;
+  /**
+   * Sets whether this error should be emitted to logs
+   */
+  set emit(value: boolean);
+}
+//#endregion
+export { RowType as a, RowComponent as i, BuilderType as n, CustomError as r, BuilderComponent as t };
+//# sourceMappingURL=Components-Drs0KoOi.d.mts.map

package/dist/{Database-CqvL4DO2.mjs → Database-DAWd3hyw.mjs}

@@ -1,4 +1,4 @@
-import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, InteractionContextType, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder, resolveColor } from "discord.js";
+import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, CheckboxBuilder, CheckboxGroupBuilder, CheckboxGroupOptionBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, InteractionContextType, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RadioGroupBuilder, RadioGroupOptionBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder, resolveColor } from "discord.js";
 
 //#region src/miscellaneous/botColorHolder.ts
 const DEFAULT_COLOR = "Default";
@@ -15,7 +15,7 @@ function getBotColor() {
 //#endregion
 //#region src/interfaces/Components.ts
 /**
-* Available Discord.js builder classes for use with BuilderComponent
+* Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.
 *
 * @internal
 */
@@ -29,6 +29,11 @@ const BuilderTypes = {
 	label: LabelBuilder,
 	text_input: TextInputBuilder,
 	file_upload: FileUploadBuilder,
+	checkbox: CheckboxBuilder,
+	checkbox_group: CheckboxGroupBuilder,
+	checkbox_group_option: CheckboxGroupOptionBuilder,
+	radio_group: RadioGroupBuilder,
+	radio_group_option: RadioGroupOptionBuilder,
 	button: ButtonBuilder,
 	menu_string: StringSelectMenuBuilder,
 	menu_option_string: StringSelectMenuOptionBuilder,
@@ -44,7 +49,7 @@ const BuilderTypes = {
 	separator: SeparatorBuilder
 };
 /**
-* Available Discord.js action row classes for use with RowComponent
+* Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons
 *
 * @internal
 */
@@ -81,9 +86,6 @@ var BaseComponent = class {
 	get instance() {
 		return this._component;
 	}
-	buildCustomId(prefix, ...args) {
-		return args.length === 0 ? prefix : `${prefix}:${args.join("-")}`;
-	}
 };
 /**
 * Base class for Discord.js builder components
@@ -214,4 +216,4 @@ var DatabaseError = class extends CustomError {
 
 //#endregion
 export { setBotColor as a, RowComponent as i, BuilderComponent as n, CustomError as r, DatabaseError as t };
-//# sourceMappingURL=Database-CqvL4DO2.mjs.map
+//# sourceMappingURL=Database-DAWd3hyw.mjs.map

package/dist/Database-DAWd3hyw.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database-DAWd3hyw.mjs","names":[],"sources":["../src/miscellaneous/botColorHolder.ts","../src/interfaces/Components.ts","../src/bot/defaults/errors/Database.ts"],"sourcesContent":["import type { ColorResolvable } from 'discord.js';\n\n// 'Default' is Discord.js's own sentinel for \"no explicit color\".\nconst DEFAULT_COLOR: ColorResolvable = 'Default';\n\nlet current: ColorResolvable = DEFAULT_COLOR;\n\n/** @internal */\nexport function setBotColor(color: ColorResolvable | undefined): void {\n    current = color ?? DEFAULT_COLOR;\n}\n\n/** @internal */\nexport function getBotColor(): ColorResolvable {\n    return current;\n}\n","import {\n    ActionRowBuilder,\n    ButtonBuilder,\n    ChannelSelectMenuBuilder,\n    CheckboxBuilder,\n    CheckboxGroupBuilder,\n    CheckboxGroupOptionBuilder,\n    ContainerBuilder,\n    ContextMenuCommandBuilder,\n    EmbedBuilder,\n    FileBuilder,\n    FileUploadBuilder,\n    InteractionContextType,\n    LabelBuilder,\n    MediaGalleryBuilder,\n    MentionableSelectMenuBuilder,\n    ModalBuilder,\n    RadioGroupBuilder,\n    RadioGroupOptionBuilder,\n    RoleSelectMenuBuilder,\n    SectionBuilder,\n    SeparatorBuilder,\n    SlashCommandBuilder,\n    SlashCommandSubcommandBuilder,\n    SlashCommandSubcommandGroupBuilder,\n    StringSelectMenuBuilder,\n    StringSelectMenuOptionBuilder,\n    TextDisplayBuilder,\n    TextInputBuilder,\n    UserSelectMenuBuilder,\n    resolveColor\n} from 'discord.js';\n\nimport { getBotColor } from '@miscellaneous/botColorHolder';\n\n/**\n * Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.\n *\n * @internal\n */\nexport const BuilderTypes = {\n    // Command Components\n    command: SlashCommandBuilder,\n    context_menu: ContextMenuCommandBuilder,\n    subcommand: SlashCommandSubcommandBuilder,\n    group: SlashCommandSubcommandGroupBuilder,\n\n    // Embed Components\n    embed: EmbedBuilder,\n\n    // Modal Components\n    modal: ModalBuilder,\n    label: LabelBuilder,\n    text_input: TextInputBuilder,\n    file_upload: FileUploadBuilder,\n    checkbox: CheckboxBuilder,\n    checkbox_group: CheckboxGroupBuilder,\n    checkbox_group_option: CheckboxGroupOptionBuilder,\n    radio_group: RadioGroupBuilder,\n    radio_group_option: RadioGroupOptionBuilder,\n\n    // Action Row Components\n    button: ButtonBuilder,\n    menu_string: StringSelectMenuBuilder,\n    menu_option_string: StringSelectMenuOptionBuilder,\n    menu_user: UserSelectMenuBuilder,\n    menu_channel: ChannelSelectMenuBuilder,\n    menu_mentionable: MentionableSelectMenuBuilder,\n    menu_role: RoleSelectMenuBuilder,\n\n    // ComponentsV2\n    container: ContainerBuilder,\n    text_display: TextDisplayBuilder,\n    file: FileBuilder,\n    media: MediaGalleryBuilder,\n    section: SectionBuilder,\n    separator: SeparatorBuilder\n};\n\n/**\n * Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons\n *\n * @internal\n */\nexport const RowTypes: {\n    button: typeof ActionRowBuilder<ButtonBuilder>;\n    menu_string: typeof ActionRowBuilder<StringSelectMenuBuilder>;\n    menu_user: typeof ActionRowBuilder<UserSelectMenuBuilder>;\n    menu_channel: typeof ActionRowBuilder<ChannelSelectMenuBuilder>;\n    menu_mentionable: typeof ActionRowBuilder<MentionableSelectMenuBuilder>;\n    menu_role: typeof ActionRowBuilder<RoleSelectMenuBuilder>;\n} = {\n    button: ActionRowBuilder<ButtonBuilder>,\n    menu_string: ActionRowBuilder<StringSelectMenuBuilder>,\n    menu_user: ActionRowBuilder<UserSelectMenuBuilder>,\n    menu_channel: ActionRowBuilder<ChannelSelectMenuBuilder>,\n    menu_mentionable: ActionRowBuilder<MentionableSelectMenuBuilder>,\n    menu_role: ActionRowBuilder<RoleSelectMenuBuilder>\n};\n\n/**\n * Available Discord.js builder types for use with BuilderComponent\n */\nexport type BuilderType = keyof typeof BuilderTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedBuilder<BuilderKey extends BuilderType> = InstanceType<(typeof BuilderTypes)[BuilderKey]>;\n\n/**\n * Available Discord.js action row types for use with RowComponent\n */\nexport type RowType = keyof typeof RowTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedActionRow<RowKey extends RowType> = InstanceType<(typeof RowTypes)[RowKey]>;\n\n/**\n * Base class for Discord component wrappers\n *\n * Provides common functionality for building Discord components with proper typing.\n *\n * @typeParam TComponent - The Discord.js component type being wrapped\n *\n * @internal\n */\nexport abstract class BaseComponent<TComponent> {\n    private readonly _component: TComponent;\n\n    protected constructor(ComponentClass: new () => TComponent) {\n        this._component = new ComponentClass();\n    }\n\n    /**\n     * Gets the built component (should be considered read-only)\n     *\n     * Returns the finalized component ready for use in Discord messages.\n     *\n     * Please do not use for further configuration, use `this.instance` for that.\n     * @example new SomeComponent().component\n     */\n    public abstract get component(): InstantiatedBuilder<BuilderType> | InstantiatedActionRow<RowType>;\n\n    /**\n     * Gets the component instance for configuration\n     *\n     * Use this to access Discord.js builder methods like setTitle(), setDescription(), etc.\n     *\n     * Use this in your component classes to configure the builder\n     * @example this.instance.setTitle('My Modal')\n     */\n    protected get instance(): TComponent {\n        return this._component;\n    }\n}\n\n/**\n * Base class for Discord.js builder components\n *\n * Wraps Discord.js builders (SlashCommandBuilder, EmbedBuilder, etc.) with\n * Seedcord-specific defaults and helper methods.\n *\n * @typeParam BuilderKey - The type of Discord.js builder being wrapped\n */\nexport abstract class BuilderComponent<BuilderKey extends BuilderType> extends BaseComponent<\n    InstantiatedBuilder<BuilderKey>\n> {\n    private colorApplied = false;\n\n    protected constructor(public readonly type: BuilderKey) {\n        const ComponentClass = BuilderTypes[type] as unknown;\n        super(ComponentClass as new () => InstantiatedBuilder<BuilderKey>);\n\n        if (this.instance instanceof SlashCommandBuilder || this.instance instanceof ContextMenuCommandBuilder) {\n            this.instance.setContexts(InteractionContextType.Guild);\n        }\n    }\n\n    get component(): InstantiatedBuilder<BuilderKey> {\n        this.applyBotColor();\n        return this.instance;\n    }\n\n    // Resolving in the constructor would capture the default for a component built before setBotColor()\n    // ran. The unset check keeps a color the subclass set for itself.\n    private applyBotColor(): void {\n        if (this.colorApplied) return;\n        this.colorApplied = true;\n\n        const color = getBotColor();\n        if (this.instance instanceof EmbedBuilder) {\n            if (this.instance.data.color === undefined) this.instance.setColor(color);\n        } else if (this.instance instanceof ContainerBuilder) {\n            const accent = this.instance.data.accent_color;\n            if (accent === null || accent === undefined) {\n                this.instance.setAccentColor(color === 'Default' ? undefined : resolveColor(color));\n            }\n        }\n    }\n}\n\n/**\n * Base class for Discord action row components\n *\n * Wraps Discord.js action row builder with Seedcord-specific defaults and helper methods.\n *\n * @typeParam RowKey - The Discord.js action row type being wrapped\n */\nexport abstract class RowComponent<RowKey extends RowType> extends BaseComponent<InstantiatedActionRow<RowKey>> {\n    protected constructor(public readonly type: RowKey) {\n        const ComponentClass = RowTypes[type] as unknown;\n        super(ComponentClass as new () => InstantiatedActionRow<RowKey>);\n    }\n\n    get component(): InstantiatedActionRow<RowKey> {\n        return this.instance;\n    }\n}\n\n/**\n * Pre-configured error embed with default styling\n *\n * This is bundled in {@link CustomError}s as the response.\n *\n * @internal\n */\nexport class BaseErrorEmbed extends BuilderComponent<'embed'> {\n    /**\n     * Creates a new error embed with default configuration.\n     */\n    public constructor() {\n        super('embed');\n        this.instance.setTitle('Cannot Proceed');\n    }\n}\n\n/**\n * Base class for custom error types with Discord embed responses\n *\n * Errors extending CustomError should be used with the `Catchable` decorators to implement a control flow. These errors will be caught and handled by the framework to show the user the configured response.\n */\nexport abstract class CustomError extends Error {\n    private _emit = false;\n    public readonly response = new BaseErrorEmbed().component;\n\n    protected constructor(public override message: string) {\n        super(message);\n\n        Error.captureStackTrace(this, this.constructor);\n    }\n\n    /**\n     * Whether this error should be emitted to logs\n     *\n     * Controls logging behavior. Errors with emit=true will always be logged,\n     * while emit=false errors may be suppressed in production.\n     *\n     * @returns True if the error should be logged\n     */\n    public get emit(): boolean {\n        return this._emit;\n    }\n\n    /**\n     * Sets whether this error should be emitted to logs\n     */\n    public set emit(value: boolean) {\n        this._emit = value;\n    }\n}\n","import { CustomError } from '@interfaces/Components';\n\nimport type { UUID } from 'crypto';\n\n/**\n * Generic database operation error with UUID tracking.\n *\n * Thrown for various database operation failures and includes\n * a UUID for error tracking and debugging purposes.\n *\n * @internal\n */\nexport class DatabaseError extends CustomError {\n    /**\n     * Creates a new DatabaseError.\n     *\n     * @param message - The error message describing what went wrong\n     * @param uuid - A unique identifier for this specific error instance\n     */\n    constructor(\n        message: string,\n        public uuid: UUID\n    ) {\n        super(message);\n        this.emit = true; // Emit in logs regardless of environment\n        this.name = 'DatabaseError';\n\n        this.response\n            .setTitle('Database Error')\n            .setDescription(`An error occurred while interacting with the database.\\n### UUID: \\`${this.uuid}\\``);\n    }\n}\n"],"mappings":";;;AAGA,MAAM,gBAAiC;AAEvC,IAAI,UAA2B;;AAG/B,SAAgB,YAAY,OAA0C;CAClE,UAAU,SAAS;AACvB;;AAGA,SAAgB,cAA+B;CAC3C,OAAO;AACX;;;;;;;;;ACyBA,MAAa,eAAe;CAExB,SAAS;CACT,cAAc;CACd,YAAY;CACZ,OAAO;CAGP,OAAO;CAGP,OAAO;CACP,OAAO;CACP,YAAY;CACZ,aAAa;CACb,UAAU;CACV,gBAAgB;CAChB,uBAAuB;CACvB,aAAa;CACb,oBAAoB;CAGpB,QAAQ;CACR,aAAa;CACb,oBAAoB;CACpB,WAAW;CACX,cAAc;CACd,kBAAkB;CAClB,WAAW;CAGX,WAAW;CACX,cAAc;CACd,MAAM;CACN,OAAO;CACP,SAAS;CACT,WAAW;AACf;;;;;;AAOA,MAAa,WAOT;CACA,QAAQ;CACR,aAAa;CACb,WAAW;CACX,cAAc;CACd,kBAAkB;CAClB,WAAW;AACf;;;;;;;;;;AA+BA,IAAsB,gBAAtB,MAAgD;CAC5C,AAAiB;CAEjB,AAAU,YAAY,gBAAsC;EACxD,KAAK,aAAa,IAAI,eAAe;CACzC;;;;;;;;;CAoBA,IAAc,WAAuB;EACjC,OAAO,KAAK;CAChB;AACJ;;;;;;;;;AAUA,IAAsB,mBAAtB,cAA+E,cAE7E;CAGwC;CAFtC,AAAQ,eAAe;CAEvB,AAAU,YAAY,AAAgB,MAAkB;EACpD,MAAM,iBAAiB,aAAa;EACpC,MAAM,cAA2D;EAF/B;EAIlC,IAAI,KAAK,oBAAoB,uBAAuB,KAAK,oBAAoB,2BACzE,KAAK,SAAS,YAAY,uBAAuB,KAAK;CAE9D;CAEA,IAAI,YAA6C;EAC7C,KAAK,cAAc;EACnB,OAAO,KAAK;CAChB;CAIA,AAAQ,gBAAsB;EAC1B,IAAI,KAAK,cAAc;EACvB,KAAK,eAAe;EAEpB,MAAM,QAAQ,YAAY;EAC1B,IAAI,KAAK,oBAAoB,cACzB;OAAI,KAAK,SAAS,KAAK,UAAU,QAAW,KAAK,SAAS,SAAS,KAAK;EAAC,OACtE,IAAI,KAAK,oBAAoB,kBAAkB;GAClD,MAAM,SAAS,KAAK,SAAS,KAAK;GAClC,IAAI,WAAW,QAAQ,WAAW,QAC9B,KAAK,SAAS,eAAe,UAAU,YAAY,SAAY,aAAa,KAAK,CAAC;EAE1F;CACJ;AACJ;;;;;;;;AASA,IAAsB,eAAtB,cAAmE,cAA6C;CACtE;CAAtC,AAAU,YAAY,AAAgB,MAAc;EAChD,MAAM,iBAAiB,SAAS;EAChC,MAAM,cAAyD;EAF7B;CAGtC;CAEA,IAAI,YAA2C;EAC3C,OAAO,KAAK;CAChB;AACJ;;;;;;;;AASA,IAAa,iBAAb,cAAoC,iBAA0B;;;;CAI1D,AAAO,cAAc;EACjB,MAAM,OAAO;EACb,KAAK,SAAS,SAAS,gBAAgB;CAC3C;AACJ;;;;;;AAOA,IAAsB,cAAtB,cAA0C,MAAM;CAIN;CAHtC,AAAQ,QAAQ;CAChB,AAAgB,WAAW,IAAI,eAAe,EAAE;CAEhD,AAAU,YAAY,AAAgB,SAAiB;EACnD,MAAM,OAAO;EADqB;EAGlC,MAAM,kBAAkB,MAAM,KAAK,WAAW;CAClD;;;;;;;;;CAUA,IAAW,OAAgB;EACvB,OAAO,KAAK;CAChB;;;;CAKA,IAAW,KAAK,OAAgB;EAC5B,KAAK,QAAQ;CACjB;AACJ;;;;;;;;;;;;ACpQA,IAAa,gBAAb,cAAmC,YAAY;CAShC;;;;;;;CAFX,YACI,SACA,AAAO,MACT;EACE,MAAM,OAAO;EAFN;EAGP,KAAK,OAAO;EACZ,KAAK,OAAO;EAEZ,KAAK,SACA,SAAS,gBAAgB,EACzB,eAAe,uEAAuE,KAAK,KAAK,GAAG;CAC5G;AACJ"}

package/dist/{Database-Xu_qxdiF.cjs → Database-DTVbdvLZ.cjs}

@@ -15,7 +15,7 @@ function getBotColor() {
 //#endregion
 //#region src/interfaces/Components.ts
 /**
-* Available Discord.js builder classes for use with BuilderComponent
+* Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.
 *
 * @internal
 */
@@ -29,6 +29,11 @@ const BuilderTypes = {
 	label: discord_js.LabelBuilder,
 	text_input: discord_js.TextInputBuilder,
 	file_upload: discord_js.FileUploadBuilder,
+	checkbox: discord_js.CheckboxBuilder,
+	checkbox_group: discord_js.CheckboxGroupBuilder,
+	checkbox_group_option: discord_js.CheckboxGroupOptionBuilder,
+	radio_group: discord_js.RadioGroupBuilder,
+	radio_group_option: discord_js.RadioGroupOptionBuilder,
 	button: discord_js.ButtonBuilder,
 	menu_string: discord_js.StringSelectMenuBuilder,
 	menu_option_string: discord_js.StringSelectMenuOptionBuilder,
@@ -44,7 +49,7 @@ const BuilderTypes = {
 	separator: discord_js.SeparatorBuilder
 };
 /**
-* Available Discord.js action row classes for use with RowComponent
+* Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons
 *
 * @internal
 */
@@ -81,9 +86,6 @@ var BaseComponent = class {
 	get instance() {
 		return this._component;
 	}
-	buildCustomId(prefix, ...args) {
-		return args.length === 0 ? prefix : `${prefix}:${args.join("-")}`;
-	}
 };
 /**
 * Base class for Discord.js builder components
@@ -243,4 +245,4 @@ Object.defineProperty(exports, 'setBotColor', {
     return setBotColor;
   }
 });
-//# sourceMappingURL=Database-Xu_qxdiF.cjs.map
+//# sourceMappingURL=Database-DTVbdvLZ.cjs.map

package/dist/Database-DTVbdvLZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database-DTVbdvLZ.cjs","names":["SlashCommandBuilder","ContextMenuCommandBuilder","SlashCommandSubcommandBuilder","SlashCommandSubcommandGroupBuilder","EmbedBuilder","ModalBuilder","LabelBuilder","TextInputBuilder","FileUploadBuilder","CheckboxBuilder","CheckboxGroupBuilder","CheckboxGroupOptionBuilder","RadioGroupBuilder","RadioGroupOptionBuilder","ButtonBuilder","StringSelectMenuBuilder","StringSelectMenuOptionBuilder","UserSelectMenuBuilder","ChannelSelectMenuBuilder","MentionableSelectMenuBuilder","RoleSelectMenuBuilder","ContainerBuilder","TextDisplayBuilder","FileBuilder","MediaGalleryBuilder","SectionBuilder","SeparatorBuilder","ActionRowBuilder","InteractionContextType"],"sources":["../src/miscellaneous/botColorHolder.ts","../src/interfaces/Components.ts","../src/bot/defaults/errors/Database.ts"],"sourcesContent":["import type { ColorResolvable } from 'discord.js';\n\n// 'Default' is Discord.js's own sentinel for \"no explicit color\".\nconst DEFAULT_COLOR: ColorResolvable = 'Default';\n\nlet current: ColorResolvable = DEFAULT_COLOR;\n\n/** @internal */\nexport function setBotColor(color: ColorResolvable | undefined): void {\n    current = color ?? DEFAULT_COLOR;\n}\n\n/** @internal */\nexport function getBotColor(): ColorResolvable {\n    return current;\n}\n","import {\n    ActionRowBuilder,\n    ButtonBuilder,\n    ChannelSelectMenuBuilder,\n    CheckboxBuilder,\n    CheckboxGroupBuilder,\n    CheckboxGroupOptionBuilder,\n    ContainerBuilder,\n    ContextMenuCommandBuilder,\n    EmbedBuilder,\n    FileBuilder,\n    FileUploadBuilder,\n    InteractionContextType,\n    LabelBuilder,\n    MediaGalleryBuilder,\n    MentionableSelectMenuBuilder,\n    ModalBuilder,\n    RadioGroupBuilder,\n    RadioGroupOptionBuilder,\n    RoleSelectMenuBuilder,\n    SectionBuilder,\n    SeparatorBuilder,\n    SlashCommandBuilder,\n    SlashCommandSubcommandBuilder,\n    SlashCommandSubcommandGroupBuilder,\n    StringSelectMenuBuilder,\n    StringSelectMenuOptionBuilder,\n    TextDisplayBuilder,\n    TextInputBuilder,\n    UserSelectMenuBuilder,\n    resolveColor\n} from 'discord.js';\n\nimport { getBotColor } from '@miscellaneous/botColorHolder';\n\n/**\n * Available Discord.js builder classes for use with BuilderComponent for commands, embeds, modals, etc.\n *\n * @internal\n */\nexport const BuilderTypes = {\n    // Command Components\n    command: SlashCommandBuilder,\n    context_menu: ContextMenuCommandBuilder,\n    subcommand: SlashCommandSubcommandBuilder,\n    group: SlashCommandSubcommandGroupBuilder,\n\n    // Embed Components\n    embed: EmbedBuilder,\n\n    // Modal Components\n    modal: ModalBuilder,\n    label: LabelBuilder,\n    text_input: TextInputBuilder,\n    file_upload: FileUploadBuilder,\n    checkbox: CheckboxBuilder,\n    checkbox_group: CheckboxGroupBuilder,\n    checkbox_group_option: CheckboxGroupOptionBuilder,\n    radio_group: RadioGroupBuilder,\n    radio_group_option: RadioGroupOptionBuilder,\n\n    // Action Row Components\n    button: ButtonBuilder,\n    menu_string: StringSelectMenuBuilder,\n    menu_option_string: StringSelectMenuOptionBuilder,\n    menu_user: UserSelectMenuBuilder,\n    menu_channel: ChannelSelectMenuBuilder,\n    menu_mentionable: MentionableSelectMenuBuilder,\n    menu_role: RoleSelectMenuBuilder,\n\n    // ComponentsV2\n    container: ContainerBuilder,\n    text_display: TextDisplayBuilder,\n    file: FileBuilder,\n    media: MediaGalleryBuilder,\n    section: SectionBuilder,\n    separator: SeparatorBuilder\n};\n\n/**\n * Available Discord.js action row classes for use with RowComponent for Select Menus and Buttons\n *\n * @internal\n */\nexport const RowTypes: {\n    button: typeof ActionRowBuilder<ButtonBuilder>;\n    menu_string: typeof ActionRowBuilder<StringSelectMenuBuilder>;\n    menu_user: typeof ActionRowBuilder<UserSelectMenuBuilder>;\n    menu_channel: typeof ActionRowBuilder<ChannelSelectMenuBuilder>;\n    menu_mentionable: typeof ActionRowBuilder<MentionableSelectMenuBuilder>;\n    menu_role: typeof ActionRowBuilder<RoleSelectMenuBuilder>;\n} = {\n    button: ActionRowBuilder<ButtonBuilder>,\n    menu_string: ActionRowBuilder<StringSelectMenuBuilder>,\n    menu_user: ActionRowBuilder<UserSelectMenuBuilder>,\n    menu_channel: ActionRowBuilder<ChannelSelectMenuBuilder>,\n    menu_mentionable: ActionRowBuilder<MentionableSelectMenuBuilder>,\n    menu_role: ActionRowBuilder<RoleSelectMenuBuilder>\n};\n\n/**\n * Available Discord.js builder types for use with BuilderComponent\n */\nexport type BuilderType = keyof typeof BuilderTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedBuilder<BuilderKey extends BuilderType> = InstanceType<(typeof BuilderTypes)[BuilderKey]>;\n\n/**\n * Available Discord.js action row types for use with RowComponent\n */\nexport type RowType = keyof typeof RowTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedActionRow<RowKey extends RowType> = InstanceType<(typeof RowTypes)[RowKey]>;\n\n/**\n * Base class for Discord component wrappers\n *\n * Provides common functionality for building Discord components with proper typing.\n *\n * @typeParam TComponent - The Discord.js component type being wrapped\n *\n * @internal\n */\nexport abstract class BaseComponent<TComponent> {\n    private readonly _component: TComponent;\n\n    protected constructor(ComponentClass: new () => TComponent) {\n        this._component = new ComponentClass();\n    }\n\n    /**\n     * Gets the built component (should be considered read-only)\n     *\n     * Returns the finalized component ready for use in Discord messages.\n     *\n     * Please do not use for further configuration, use `this.instance` for that.\n     * @example new SomeComponent().component\n     */\n    public abstract get component(): InstantiatedBuilder<BuilderType> | InstantiatedActionRow<RowType>;\n\n    /**\n     * Gets the component instance for configuration\n     *\n     * Use this to access Discord.js builder methods like setTitle(), setDescription(), etc.\n     *\n     * Use this in your component classes to configure the builder\n     * @example this.instance.setTitle('My Modal')\n     */\n    protected get instance(): TComponent {\n        return this._component;\n    }\n}\n\n/**\n * Base class for Discord.js builder components\n *\n * Wraps Discord.js builders (SlashCommandBuilder, EmbedBuilder, etc.) with\n * Seedcord-specific defaults and helper methods.\n *\n * @typeParam BuilderKey - The type of Discord.js builder being wrapped\n */\nexport abstract class BuilderComponent<BuilderKey extends BuilderType> extends BaseComponent<\n    InstantiatedBuilder<BuilderKey>\n> {\n    private colorApplied = false;\n\n    protected constructor(public readonly type: BuilderKey) {\n        const ComponentClass = BuilderTypes[type] as unknown;\n        super(ComponentClass as new () => InstantiatedBuilder<BuilderKey>);\n\n        if (this.instance instanceof SlashCommandBuilder || this.instance instanceof ContextMenuCommandBuilder) {\n            this.instance.setContexts(InteractionContextType.Guild);\n        }\n    }\n\n    get component(): InstantiatedBuilder<BuilderKey> {\n        this.applyBotColor();\n        return this.instance;\n    }\n\n    // Resolving in the constructor would capture the default for a component built before setBotColor()\n    // ran. The unset check keeps a color the subclass set for itself.\n    private applyBotColor(): void {\n        if (this.colorApplied) return;\n        this.colorApplied = true;\n\n        const color = getBotColor();\n        if (this.instance instanceof EmbedBuilder) {\n            if (this.instance.data.color === undefined) this.instance.setColor(color);\n        } else if (this.instance instanceof ContainerBuilder) {\n            const accent = this.instance.data.accent_color;\n            if (accent === null || accent === undefined) {\n                this.instance.setAccentColor(color === 'Default' ? undefined : resolveColor(color));\n            }\n        }\n    }\n}\n\n/**\n * Base class for Discord action row components\n *\n * Wraps Discord.js action row builder with Seedcord-specific defaults and helper methods.\n *\n * @typeParam RowKey - The Discord.js action row type being wrapped\n */\nexport abstract class RowComponent<RowKey extends RowType> extends BaseComponent<InstantiatedActionRow<RowKey>> {\n    protected constructor(public readonly type: RowKey) {\n        const ComponentClass = RowTypes[type] as unknown;\n        super(ComponentClass as new () => InstantiatedActionRow<RowKey>);\n    }\n\n    get component(): InstantiatedActionRow<RowKey> {\n        return this.instance;\n    }\n}\n\n/**\n * Pre-configured error embed with default styling\n *\n * This is bundled in {@link CustomError}s as the response.\n *\n * @internal\n */\nexport class BaseErrorEmbed extends BuilderComponent<'embed'> {\n    /**\n     * Creates a new error embed with default configuration.\n     */\n    public constructor() {\n        super('embed');\n        this.instance.setTitle('Cannot Proceed');\n    }\n}\n\n/**\n * Base class for custom error types with Discord embed responses\n *\n * Errors extending CustomError should be used with the `Catchable` decorators to implement a control flow. These errors will be caught and handled by the framework to show the user the configured response.\n */\nexport abstract class CustomError extends Error {\n    private _emit = false;\n    public readonly response = new BaseErrorEmbed().component;\n\n    protected constructor(public override message: string) {\n        super(message);\n\n        Error.captureStackTrace(this, this.constructor);\n    }\n\n    /**\n     * Whether this error should be emitted to logs\n     *\n     * Controls logging behavior. Errors with emit=true will always be logged,\n     * while emit=false errors may be suppressed in production.\n     *\n     * @returns True if the error should be logged\n     */\n    public get emit(): boolean {\n        return this._emit;\n    }\n\n    /**\n     * Sets whether this error should be emitted to logs\n     */\n    public set emit(value: boolean) {\n        this._emit = value;\n    }\n}\n","import { CustomError } from '@interfaces/Components';\n\nimport type { UUID } from 'crypto';\n\n/**\n * Generic database operation error with UUID tracking.\n *\n * Thrown for various database operation failures and includes\n * a UUID for error tracking and debugging purposes.\n *\n * @internal\n */\nexport class DatabaseError extends CustomError {\n    /**\n     * Creates a new DatabaseError.\n     *\n     * @param message - The error message describing what went wrong\n     * @param uuid - A unique identifier for this specific error instance\n     */\n    constructor(\n        message: string,\n        public uuid: UUID\n    ) {\n        super(message);\n        this.emit = true; // Emit in logs regardless of environment\n        this.name = 'DatabaseError';\n\n        this.response\n            .setTitle('Database Error')\n            .setDescription(`An error occurred while interacting with the database.\\n### UUID: \\`${this.uuid}\\``);\n    }\n}\n"],"mappings":"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"}