seedcord 0.10.5 → 0.11.0-next.0

package/README.md

@@ -10,4 +10,4 @@ _This repository is a work in progress._
 - Till a major v1.0.0 release for seedcord, expect breaking changes in minor versions.
 - Documentation will come soon as well!
 
-I'm planning to release the first major version by the end of 2025, or Jan 2026. But till then, if you'd like to try using it, you can check out the code in `packages/mock`
+I'm planning to release the first major version by Q1 2026. But till then, if you'd like to try using it, you can check out the code in `mock`

package/dist/Components-D-AZ6ESx.d.mts

@@ -0,0 +1,244 @@
+import { ActionRowBuilder, ButtonBuilder, ChannelSelectMenuBuilder, ContainerBuilder, ContextMenuCommandBuilder, EmbedBuilder, FileBuilder, FileUploadBuilder, LabelBuilder, MediaGalleryBuilder, MentionableSelectMenuBuilder, ModalBuilder, RoleSelectMenuBuilder, SectionBuilder, SeparatorBuilder, SlashCommandBuilder, SlashCommandSubcommandBuilder, SlashCommandSubcommandGroupBuilder, StringSelectMenuBuilder, StringSelectMenuOptionBuilder, TextDisplayBuilder, TextInputBuilder, UserSelectMenuBuilder } from "discord.js";
+
+//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/non-empty-tuple.d.ts
+/**
+Matches any non-empty tuple.
+
+@example
+```
+import type {NonEmptyTuple} from 'type-fest';
+
+const sum = (...numbers: NonEmptyTuple<number>) => numbers.reduce((total, value) => total + value, 0);
+
+sum(1, 2, 3);
+// Ok
+
+// @ts-expect-error
+sum();
+// Error: Expected at least 1 arguments, but got 0.
+```
+
+@see {@link RequireAtLeastOne} for objects
+
+@category Array
+*/
+type NonEmptyTuple<T = unknown> = readonly [T, ...T[]];
+//#endregion
+//#region ../../node_modules/.pnpm/type-fest@5.6.0/node_modules/type-fest/source/join.d.ts
+// The builtin `join` method supports all these natively in the same way that typescript handles them so we can safely accept all of them.
+type JoinableItem = string | number | bigint | boolean | undefined | null; // `null` and `undefined` are treated uniquely in the built-in join method, in a way that differs from the default `toString` that would result in the type `${undefined}`. That's why we need to handle it specifically with this helper.
+// @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/join#description
+type NullishCoalesce<Value extends JoinableItem, Fallback extends string> = Value extends undefined | null ? NonNullable<Value> | Fallback : Value;
+/**
+Join an array of strings and/or numbers using the given string as a delimiter.
+
+Use-case: Defining key paths in a nested object. For example, for dot-notation fields in MongoDB queries.
+
+@example
+```
+import type {Join} from 'type-fest';
+
+// Mixed (strings & numbers) items
+const path1 = ['foo', 0, 'baz'].join('.') as Join<['foo', 0, 'baz'], '.'>;
+//=> 'foo.0.baz'
+
+// Only string items
+const path2 = ['foo', 'bar', 'baz'].join('.') as Join<['foo', 'bar', 'baz'], '.'>;
+//=> 'foo.bar.baz'
+
+// Only number items
+const path3 = [1, 2, 3].join('.') as Join<[1, 2, 3], '.'>;
+//=> '1.2.3'
+
+// Only bigint items
+const path4 = [1n, 2n, 3n].join('.') as Join<[1n, 2n, 3n], '.'>;
+//=> '1.2.3'
+
+// Only boolean items
+const path5 = [true, false, true].join('.') as Join<[true, false, true], '.'>;
+//=> 'true.false.true'
+
+// Contains nullish items
+const path6 = ['foo', undefined, 'baz', null, 'xyz'].join('.') as Join<['foo', undefined, 'baz', null, 'xyz'], '.'>;
+//=> 'foo..baz..xyz'
+
+// Partial tuple shapes (rest param last)
+const path7 = ['prefix'].join('.') as Join<['prefix', ...string[]], '.'>;
+//=> `prefix.${string}`
+
+// Partial tuple shapes (rest param first)
+const path8 = ['suffix'].join('.') as Join<[...string[], 'suffix'], '.'>;
+//=> `${string}.suffix`
+
+// Tuples items with nullish unions
+const path9 = ['hello', 'world'].join('.') as Join<['hello' | undefined, 'world' | null], '.'>;
+//=> '.' | '.world' | 'hello.' | 'hello.world'
+```
+
+@category Array
+@category Template literal
+*/
+type Join<Items extends readonly JoinableItem[], Delimiter extends string> = Items extends readonly [] ? '' : Items extends readonly [JoinableItem?] ? `${NullishCoalesce<Items[0], ''>}` : Items extends readonly [infer First extends JoinableItem, ...infer Tail extends readonly JoinableItem[]] ? `${NullishCoalesce<First, ''>}${Delimiter}${Join<Tail, Delimiter>}` : Items extends readonly [...infer Head extends readonly JoinableItem[], infer Last extends JoinableItem] ? `${Join<Head, Delimiter>}${Delimiter}${NullishCoalesce<Last, ''>}` : string;
+//#endregion
+//#region src/interfaces/Components.d.ts
+/**
+ * Available Discord.js builder classes for use with BuilderComponent
+ *
+ * @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;
+  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
+ *
+ * @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 ActionRowComponentType = keyof typeof RowTypes;
+/**
+ * @internal
+ */
+type InstantiatedActionRow<RowKey extends ActionRowComponentType> = 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<ActionRowComponentType>;
+  /**
+   * 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;
+  /**
+   * Builds a customId string for interactive components with no arguments
+   *
+   * @param prefix - The route prefix that handlers will match against
+   * @returns The prefix as the customId
+   */
+  buildCustomId<Prefix extends string>(prefix: Prefix): Prefix;
+  /**
+   * Builds a customId string for interactive components
+   *
+   * Creates customIds in the format `prefix:arg1-arg2-arg3` for buttons, modals, etc.
+   * Arguments are joined with hyphens and separated from prefix with a colon.
+   *
+   * @param prefix - The route prefix that handlers will match against
+   * @param args - Additional arguments to encode in the customId
+   * @returns Formatted customId string
+   */
+  buildCustomId<Prefix extends string, Args extends NonEmptyTuple<string>>(prefix: Prefix, ...args: Args): `${Prefix}:${Join<Args, '-'>}`;
+}
+/**
+ * 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 ActionRowComponentType> 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 { RowComponent as a, CustomError as i, BuilderComponent as n, NonEmptyTuple as o, BuilderType as r, ActionRowComponentType as t };
+//# sourceMappingURL=Components-D-AZ6ESx.d.mts.map

package/dist/Database-CqvL4DO2.mjs

@@ -0,0 +1,217 @@
+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";
+
+//#region src/miscellaneous/botColorHolder.ts
+const DEFAULT_COLOR = "Default";
+let current = DEFAULT_COLOR;
+/** @internal */
+function setBotColor(color) {
+	current = color ?? DEFAULT_COLOR;
+}
+/** @internal */
+function getBotColor() {
+	return current;
+}
+
+//#endregion
+//#region src/interfaces/Components.ts
+/**
+* Available Discord.js builder classes for use with BuilderComponent
+*
+* @internal
+*/
+const BuilderTypes = {
+	command: SlashCommandBuilder,
+	context_menu: ContextMenuCommandBuilder,
+	subcommand: SlashCommandSubcommandBuilder,
+	group: SlashCommandSubcommandGroupBuilder,
+	embed: EmbedBuilder,
+	modal: ModalBuilder,
+	label: LabelBuilder,
+	text_input: TextInputBuilder,
+	file_upload: FileUploadBuilder,
+	button: ButtonBuilder,
+	menu_string: StringSelectMenuBuilder,
+	menu_option_string: StringSelectMenuOptionBuilder,
+	menu_user: UserSelectMenuBuilder,
+	menu_channel: ChannelSelectMenuBuilder,
+	menu_mentionable: MentionableSelectMenuBuilder,
+	menu_role: RoleSelectMenuBuilder,
+	container: ContainerBuilder,
+	text_display: TextDisplayBuilder,
+	file: FileBuilder,
+	media: MediaGalleryBuilder,
+	section: SectionBuilder,
+	separator: SeparatorBuilder
+};
+/**
+* Available Discord.js action row classes for use with RowComponent
+*
+* @internal
+*/
+const RowTypes = {
+	button: ActionRowBuilder,
+	menu_string: ActionRowBuilder,
+	menu_user: ActionRowBuilder,
+	menu_channel: ActionRowBuilder,
+	menu_mentionable: ActionRowBuilder,
+	menu_role: ActionRowBuilder
+};
+/**
+* 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
+*/
+var BaseComponent = class {
+	_component;
+	constructor(ComponentClass) {
+		this._component = new ComponentClass();
+	}
+	/**
+	* 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')
+	*/
+	get instance() {
+		return this._component;
+	}
+	buildCustomId(prefix, ...args) {
+		return args.length === 0 ? prefix : `${prefix}:${args.join("-")}`;
+	}
+};
+/**
+* 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
+*/
+var BuilderComponent = class extends BaseComponent {
+	type;
+	colorApplied = false;
+	constructor(type) {
+		const ComponentClass = BuilderTypes[type];
+		super(ComponentClass);
+		this.type = type;
+		if (this.instance instanceof SlashCommandBuilder || this.instance instanceof ContextMenuCommandBuilder) this.instance.setContexts(InteractionContextType.Guild);
+	}
+	get component() {
+		this.applyBotColor();
+		return this.instance;
+	}
+	applyBotColor() {
+		if (this.colorApplied) return;
+		this.colorApplied = true;
+		const color = getBotColor();
+		if (this.instance instanceof EmbedBuilder) {
+			if (this.instance.data.color === void 0) this.instance.setColor(color);
+		} else if (this.instance instanceof ContainerBuilder) {
+			const accent = this.instance.data.accent_color;
+			if (accent === null || accent === void 0) this.instance.setAccentColor(color === "Default" ? void 0 : resolveColor(color));
+		}
+	}
+};
+/**
+* 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
+*/
+var RowComponent = class extends BaseComponent {
+	type;
+	constructor(type) {
+		const ComponentClass = RowTypes[type];
+		super(ComponentClass);
+		this.type = type;
+	}
+	get component() {
+		return this.instance;
+	}
+};
+/**
+* Pre-configured error embed with default styling
+*
+* This is bundled in {@link CustomError}s as the response.
+*
+* @internal
+*/
+var BaseErrorEmbed = class extends BuilderComponent {
+	/**
+	* Creates a new error embed with default configuration.
+	*/
+	constructor() {
+		super("embed");
+		this.instance.setTitle("Cannot Proceed");
+	}
+};
+/**
+* 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.
+*/
+var CustomError = class extends Error {
+	message;
+	_emit = false;
+	response = new BaseErrorEmbed().component;
+	constructor(message) {
+		super(message);
+		this.message = message;
+		Error.captureStackTrace(this, this.constructor);
+	}
+	/**
+	* 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() {
+		return this._emit;
+	}
+	/**
+	* Sets whether this error should be emitted to logs
+	*/
+	set emit(value) {
+		this._emit = value;
+	}
+};
+
+//#endregion
+//#region src/bot/defaults/errors/Database.ts
+/**
+* Generic database operation error with UUID tracking.
+*
+* Thrown for various database operation failures and includes
+* a UUID for error tracking and debugging purposes.
+*
+* @internal
+*/
+var DatabaseError = class extends CustomError {
+	uuid;
+	/**
+	* Creates a new DatabaseError.
+	*
+	* @param message - The error message describing what went wrong
+	* @param uuid - A unique identifier for this specific error instance
+	*/
+	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.\n### UUID: \`${this.uuid}\``);
+	}
+};
+
+//#endregion
+export { setBotColor as a, RowComponent as i, BuilderComponent as n, CustomError as r, DatabaseError as t };
+//# sourceMappingURL=Database-CqvL4DO2.mjs.map

package/dist/Database-CqvL4DO2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database-CqvL4DO2.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    ContainerBuilder,\n    ContextMenuCommandBuilder,\n    EmbedBuilder,\n    FileBuilder,\n    FileUploadBuilder,\n    InteractionContextType,\n    LabelBuilder,\n    MediaGalleryBuilder,\n    MentionableSelectMenuBuilder,\n    ModalBuilder,\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\nimport type { Join, NonEmptyTuple } from 'type-fest';\n\n/**\n * Available Discord.js builder classes for use with BuilderComponent\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\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\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 ActionRowComponentType = keyof typeof RowTypes;\n\n/**\n * @internal\n */\nexport type InstantiatedActionRow<RowKey extends ActionRowComponentType> = 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<ActionRowComponentType>;\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     * Builds a customId string for interactive components with no arguments\n     *\n     * @param prefix - The route prefix that handlers will match against\n     * @returns The prefix as the customId\n     */\n    public buildCustomId<Prefix extends string>(prefix: Prefix): Prefix;\n    /**\n     * Builds a customId string for interactive components\n     *\n     * Creates customIds in the format `prefix:arg1-arg2-arg3` for buttons, modals, etc.\n     * Arguments are joined with hyphens and separated from prefix with a colon.\n     *\n     * @param prefix - The route prefix that handlers will match against\n     * @param args - Additional arguments to encode in the customId\n     * @returns Formatted customId string\n     */\n    public buildCustomId<Prefix extends string, Args extends NonEmptyTuple<string>>(\n        prefix: Prefix,\n        ...args: Args\n    ): `${Prefix}:${Join<Args, '-'>}`;\n\n    public buildCustomId<Prefix extends string, Args extends NonEmptyTuple<string> | []>(\n        prefix: Prefix,\n        ...args: Args\n    ): Prefix | `${Prefix}:${string}` {\n        return args.length === 0 ? prefix : `${prefix}:${args.join('-')}`;\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 ActionRowComponentType> extends BaseComponent<\n    InstantiatedActionRow<RowKey>\n> {\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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"}