seyfert 0.1.0

package/lib/builders/MessageEmbed.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Embed = void 0;
+const common_1 = require("../common");
+/**
+ * Represents a message embed.
+ * @example
+ * const embed = new MessageEmbed();
+ * embed.setTitle('Seyfert');
+ * embed.setDescription('Better than discord.js');
+ * embed.setColor('Green');
+ * const embedJSON = embed.json();
+ */
+class Embed {
+    data;
+    /**
+     * Creates a new instance of MessageEmbed.
+     * @param data - The initial data for the embed.
+     * @example
+     * const embed = new MessageEmbed({ title: 'Hello', description: 'This is an example embed' });
+     */
+    constructor(data = {}) {
+        this.data = data;
+        if (!data.fields)
+            this.data.fields = [];
+    }
+    /**
+     * Sets the author of the embed.
+     * @param author - The author information.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setAuthor({ name: 'John Doe', iconURL: 'https://example.com/avatar.png' });
+     */
+    setAuthor(author) {
+        this.data.author = (0, common_1.toSnakeCase)(author);
+        return this;
+    }
+    /**
+     * Sets the color of the embed.
+     * @param color - The color of the embed.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setColor('#FF0000');
+     * embed.setColor('Blurple');
+     */
+    setColor(color) {
+        this.data.color = (0, common_1.resolveColor)(color);
+        return this;
+    }
+    /**
+     * Sets the description of the embed.
+     * @param desc - The description of the embed.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setDescription('This is the description of the embed');
+     */
+    setDescription(desc) {
+        this.data.description = desc;
+        return this;
+    }
+    /**
+     * Adds one or more fields to the embed.
+     * @param fields - The fields to add to the embed.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.addFields({ name: 'Field 1', value: 'Value 1' }, { name: 'Field 2', value: 'Value 2' });
+     */
+    addFields(...fields) {
+        this.data.fields = this.data.fields.concat((0, common_1.fastFlat)(fields));
+        return this;
+    }
+    /**
+     * Sets the fields of the embed.
+     * @param fields - The fields of the embed.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setFields([{ name: 'Field 1', value: 'Value 1' }, { name: 'Field 2', value: 'Value 2' }]);
+     */
+    setFields(fields) {
+        this.data.fields = fields;
+        return this;
+    }
+    /**
+     * Sets the footer of the embed.
+     * @param footer - The footer information.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setFooter({ text: 'This is the footer', iconURL: 'https://example.com/footer.png' });
+     */
+    setFooter(footer) {
+        this.data.footer = (0, common_1.toSnakeCase)(footer);
+        return this;
+    }
+    /**
+     * Sets the image of the embed.
+     * @param url - The URL of the image.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setImage('https://example.com/image.png');
+     */
+    setImage(url) {
+        this.data.image = { url };
+        return this;
+    }
+    /**
+     * Sets the timestamp of the embed.
+     * @param time - The timestamp value.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setTimestamp();
+     * embed.setTimestamp(1628761200000);
+     * embed.setTimestamp(new Date());
+     */
+    setTimestamp(time = Date.now()) {
+        this.data.timestamp = new Date(time).toISOString();
+        return this;
+    }
+    /**
+     * Sets the title of the embed.
+     * @param title - The title of the embed.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setTitle('This is the title');
+     */
+    setTitle(title) {
+        this.data.title = title;
+        return this;
+    }
+    /**
+     * Sets the URL of the embed.
+     * @param url - The URL of the embed.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setURL('https://seyfert.com');
+     */
+    setURL(url) {
+        this.data.url = url;
+        return this;
+    }
+    /**
+     * Sets the thumbnail of the embed.
+     * @param url - The URL of the thumbnail.
+     * @returns The updated MessageEmbed instance.
+     * @example
+     * embed.setThumbnail('https://example.com/thumbnail.png');
+     */
+    setThumbnail(url) {
+        this.data.thumbnail = url ? { url } : undefined;
+        return this;
+    }
+    /**
+     * Converts the MessageEmbed instance to a JSON object.
+     * @returns The JSON representation of the MessageEmbed instance.
+     */
+    toJSON() {
+        return { ...this.data };
+    }
+}
+exports.Embed = Embed;

package/lib/builders/Modal.d.ts

@@ -0,0 +1,111 @@
+import { type APIModalInteractionResponseCallbackData, type APITextInputComponent, type RestOrArray, type TextInputStyle } from '../common';
+import type { ActionRow } from './ActionRow';
+import { BaseComponentBuilder, type OptionValuesLength } from './Base';
+import type { ModalBuilderComponents, ModalSubmitCallback } from './types';
+/**
+ * Represents a modal for user interactions.
+ * @template T - The type of components allowed in the modal.
+ * @example
+ * const modal = new Modal();
+ * modal.setTitle("Sample Modal");
+ * modal.addComponents(new TextInput().setLabel("Enter text"));
+ * modal.run((interaction) => {
+ *   // Handle modal submission
+ * });
+ * const json = modal.toJSON();
+ */
+export declare class Modal<T extends ModalBuilderComponents = TextInput> {
+    data: Partial<APIModalInteractionResponseCallbackData>;
+    components: ActionRow<T>[];
+    /**
+     * Creates a new Modal instance.
+     * @param data - Optional data for the modal.
+     */
+    constructor(data?: Partial<APIModalInteractionResponseCallbackData>);
+    /**
+     * Adds components to the modal.
+     * @param components - Components to be added to the modal.
+     * @returns The current Modal instance.
+     */
+    addComponents(...components: RestOrArray<ActionRow<T>>): this;
+    /**
+     * Sets the title of the modal.
+     * @param title - The title of the modal.
+     * @returns The current Modal instance.
+     */
+    setTitle(title: string): this;
+    /**
+     * Sets the custom ID of the modal.
+     * @param id - The custom ID for the modal.
+     * @returns The current Modal instance.
+     */
+    setCustomId(id: string): this;
+    /**
+     * Sets the callback function to be executed when the modal is submitted.
+     * @param func - The callback function.
+     * @returns The current Modal instance.
+     */
+    run(func: ModalSubmitCallback): this;
+    /**
+     * Converts the modal to JSON format.
+     * @returns The modal data in JSON format.
+     */
+    toJSON(): APIModalInteractionResponseCallbackData;
+}
+/**
+ * Represents a text input component builder.
+ * @example
+ * const textInput = new TextInput().setLabel("Enter text");
+ * textInput.setStyle(TextInputStyle.FULL);
+ * textInput.setPlaceholder("Type here");
+ * const json = textInput.toJSON();
+ */
+export declare class TextInput extends BaseComponentBuilder<APITextInputComponent> {
+    /**
+     * Creates a new TextInput instance.
+     * @param data - Optional data for the text input.
+     */
+    constructor(data?: Partial<APITextInputComponent>);
+    /**
+     * Sets the style of the text input.
+     * @param style - The style of the text input.
+     * @returns The current TextInput instance.
+     */
+    setStyle(style: TextInputStyle): this;
+    /**
+     * Sets the label of the text input.
+     * @param label - The label of the text input.
+     * @returns The current TextInput instance.
+     */
+    setLabel(label: string): this;
+    /**
+     * Sets the placeholder of the text input.
+     * @param placeholder - The placeholder text.
+     * @returns The current TextInput instance.
+     */
+    setPlaceholder(placeholder: string): this;
+    /**
+     * Sets the length constraints for the text input.
+     * @param options - The length constraints.
+     * @returns The current TextInput instance.
+     */
+    setLength({ max, min }: Partial<OptionValuesLength>): this;
+    /**
+     * Sets the custom ID of the text input.
+     * @param id - The custom ID for the text input.
+     * @returns The current TextInput instance.
+     */
+    setCustomId(id: string): this;
+    /**
+     * Sets the initial value of the text input.
+     * @param value - The initial value.
+     * @returns The current TextInput instance.
+     */
+    setValue(value: string): this;
+    /**
+     * Sets whether the text input is required.
+     * @param required - Indicates whether the text input is required.
+     * @returns The current TextInput instance.
+     */
+    setRequired(required?: boolean): this;
+}

package/lib/builders/Modal.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextInput = exports.Modal = void 0;
+const common_1 = require("../common");
+const Base_1 = require("./Base");
+const index_1 = require("./index");
+/**
+ * Represents a modal for user interactions.
+ * @template T - The type of components allowed in the modal.
+ * @example
+ * const modal = new Modal();
+ * modal.setTitle("Sample Modal");
+ * modal.addComponents(new TextInput().setLabel("Enter text"));
+ * modal.run((interaction) => {
+ *   // Handle modal submission
+ * });
+ * const json = modal.toJSON();
+ */
+class Modal {
+    data;
+    /** @internal */
+    __exec;
+    components = [];
+    /**
+     * Creates a new Modal instance.
+     * @param data - Optional data for the modal.
+     */
+    constructor(data = {}) {
+        this.data = data;
+        this.components = this.components.concat(data.components?.map(index_1.fromComponent) ?? []);
+    }
+    /**
+     * Adds components to the modal.
+     * @param components - Components to be added to the modal.
+     * @returns The current Modal instance.
+     */
+    addComponents(...components) {
+        this.components = this.components.concat((0, common_1.fastFlat)(components));
+        return this;
+    }
+    /**
+     * Sets the title of the modal.
+     * @param title - The title of the modal.
+     * @returns The current Modal instance.
+     */
+    setTitle(title) {
+        this.data.title = title;
+        return this;
+    }
+    /**
+     * Sets the custom ID of the modal.
+     * @param id - The custom ID for the modal.
+     * @returns The current Modal instance.
+     */
+    setCustomId(id) {
+        this.data.custom_id = id;
+        return this;
+    }
+    /**
+     * Sets the callback function to be executed when the modal is submitted.
+     * @param func - The callback function.
+     * @returns The current Modal instance.
+     */
+    run(func) {
+        this.__exec = func;
+        return this;
+    }
+    /**
+     * Converts the modal to JSON format.
+     * @returns The modal data in JSON format.
+     */
+    toJSON() {
+        return {
+            custom_id: this.data.custom_id,
+            title: this.data.title,
+            components: this.components.map(x => x.toJSON()),
+        };
+    }
+}
+exports.Modal = Modal;
+/**
+ * Represents a text input component builder.
+ * @example
+ * const textInput = new TextInput().setLabel("Enter text");
+ * textInput.setStyle(TextInputStyle.FULL);
+ * textInput.setPlaceholder("Type here");
+ * const json = textInput.toJSON();
+ */
+class TextInput extends Base_1.BaseComponentBuilder {
+    /**
+     * Creates a new TextInput instance.
+     * @param data - Optional data for the text input.
+     */
+    constructor(data = {}) {
+        super({ ...data, type: common_1.ComponentType.TextInput });
+    }
+    /**
+     * Sets the style of the text input.
+     * @param style - The style of the text input.
+     * @returns The current TextInput instance.
+     */
+    setStyle(style) {
+        this.data.style = style;
+        return this;
+    }
+    /**
+     * Sets the label of the text input.
+     * @param label - The label of the text input.
+     * @returns The current TextInput instance.
+     */
+    setLabel(label) {
+        this.data.label = label;
+        return this;
+    }
+    /**
+     * Sets the placeholder of the text input.
+     * @param placeholder - The placeholder text.
+     * @returns The current TextInput instance.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder;
+        return this;
+    }
+    /**
+     * Sets the length constraints for the text input.
+     * @param options - The length constraints.
+     * @returns The current TextInput instance.
+     */
+    setLength({ max, min }) {
+        this.data.max_length = max;
+        this.data.min_length = min;
+        return this;
+    }
+    /**
+     * Sets the custom ID of the text input.
+     * @param id - The custom ID for the text input.
+     * @returns The current TextInput instance.
+     */
+    setCustomId(id) {
+        this.data.custom_id = id;
+        return this;
+    }
+    /**
+     * Sets the initial value of the text input.
+     * @param value - The initial value.
+     * @returns The current TextInput instance.
+     */
+    setValue(value) {
+        this.data.value = value;
+        return this;
+    }
+    /**
+     * Sets whether the text input is required.
+     * @param required - Indicates whether the text input is required.
+     * @returns The current TextInput instance.
+     */
+    setRequired(required = true) {
+        this.data.required = required;
+        return this;
+    }
+}
+exports.TextInput = TextInput;

package/lib/builders/SelectMenu.d.ts

@@ -0,0 +1,201 @@
+import { type APIChannelSelectComponent, type APIMentionableSelectComponent, type APIMessageComponentEmoji, type APIRoleSelectComponent, type APISelectMenuComponent, type APISelectMenuOption, type APIStringSelectComponent, type APIUserSelectComponent, type ChannelType, type RestOrArray } from '../common';
+import type { ChannelSelectMenuInteraction, ComponentInteraction, MentionableSelectMenuInteraction, RoleSelectMenuInteraction, StringSelectMenuInteraction, UserSelectMenuInteraction } from '../structures';
+import { BaseComponentBuilder, type OptionValuesLength } from './Base';
+import type { ComponentCallback } from './types';
+export type BuilderSelectMenus = RoleSelectMenu | UserSelectMenu | MentionableSelectMenu | ChannelSelectMenu | StringSelectMenu;
+/**
+ * Represents a base class for building Select Menus.
+ * @template Select - The type of APISelectMenuComponent.
+ * @template Interaction - The type of interaction.
+ * @example
+ * const selectMenu = new SelectMenu<APIUserSelectComponent, UserSelectMenuInteraction>();
+ * selectMenu.setCustomId("user-select-menu");
+ * selectMenu.setPlaceholder("Select a user");
+ * selectMenu.run((interaction) => {
+ *   // Handle select menu interaction
+ * });
+ */
+export declare class SelectMenu<Select extends APISelectMenuComponent = APISelectMenuComponent, Interaction = ComponentInteraction> extends BaseComponentBuilder<Select> {
+    /**
+     * Sets the custom ID for the select menu.
+     * @param id - The custom ID for the select menu.
+     * @returns The current SelectMenu instance.
+     */
+    setCustomId(id: string): this;
+    /**
+     * Sets the placeholder text for the select menu.
+     * @param placeholder - The placeholder text.
+     * @returns The current SelectMenu instance.
+     */
+    setPlaceholder(placeholder: string): this;
+    /**
+     * Sets the maximum and minimum number of selected values for the select menu.
+     * @param options - The maximum and minimum values.
+     * @returns The current SelectMenu instance.
+     */
+    setValuesLength({ max, min }: Partial<OptionValuesLength>): this;
+    /**
+     * Sets whether the select menu is disabled.
+     *  [disabled=true] - Indicates whether the select menu is disabled.
+     * @returns The current SelectMenu instance.
+     */
+    setDisabled(disabled?: boolean): this;
+    /**
+     * Sets the callback function to be executed when the select menu is interacted with.
+     *  func - The callback function.
+     * @returns The current SelectMenu instance.
+     */
+    run(func: ComponentCallback<Interaction>): this;
+}
+/**
+ * Represents a Select Menu for selecting users.
+ * @example
+ * const userSelectMenu = new UserSelectMenu();
+ * userSelectMenu.setCustomId("user-select");
+ * userSelectMenu.addDefaultUsers("123456789", "987654321");
+ */
+export declare class UserSelectMenu extends SelectMenu<APIUserSelectComponent, UserSelectMenuInteraction> {
+    constructor(data?: Partial<APIUserSelectComponent>);
+    /**
+     * Adds default selected users to the select menu.
+     * @param users - User IDs to be added as default.
+     * @returns The current UserSelectMenu instance.
+     */
+    addDefaultUsers(...users: RestOrArray<string>): this;
+    /**
+     * Sets the default selected users for the select menu.
+     * @param users - User IDs to be set as default.
+     * @returns The current UserSelectMenu instance.
+     */
+    setDefaultUsers(...users: RestOrArray<string>): this;
+}
+/**
+ * Represents a Select Menu for selecting roles.
+ * @example
+ * const roleSelectMenu = new RoleSelectMenu();
+ * roleSelectMenu.setCustomId("role-select");
+ * roleSelectMenu.addDefaultRoles("123456789", "987654321");
+ */
+export declare class RoleSelectMenu extends SelectMenu<APIRoleSelectComponent, RoleSelectMenuInteraction> {
+    constructor(data?: Partial<APIRoleSelectComponent>);
+    /**
+     * Adds default selected roles to the select menu.
+     * @param roles - Role IDs to be added as default.
+     * @returns The current RoleSelectMenu instance.
+     */
+    addDefaultRoles(...roles: RestOrArray<string>): this;
+    /**
+     * Sets the default selected roles for the select menu.
+     * @param roles - Role IDs to be set as default.
+     * @returns The current RoleSelectMenu instance.
+     */
+    setDefaultRoles(...roles: RestOrArray<string>): this;
+}
+/**
+ * Represents a Select Menu for selecting mentionable entities.
+ * @example
+ * const mentionableSelectMenu = new MentionableSelectMenu();
+ * mentionableSelectMenu.setCustomId("mentionable-select");
+ */
+export declare class MentionableSelectMenu extends SelectMenu<APIMentionableSelectComponent, MentionableSelectMenuInteraction> {
+    constructor(data?: Partial<APIMentionableSelectComponent>);
+}
+/**
+ * Represents a Select Menu for selecting channels.
+ * @example
+ * const channelSelectMenu = new ChannelSelectMenu();
+ * channelSelectMenu.setCustomId("channel-select");
+ * channelSelectMenu.addDefaultChannels("123456789", "987654321");
+ * channelSelectMenu.setChannelTypes([ChannelType.GuildText, ChannelType.GuildVoice]);
+ */
+export declare class ChannelSelectMenu extends SelectMenu<APIChannelSelectComponent, ChannelSelectMenuInteraction> {
+    constructor(data?: Partial<APIChannelSelectComponent>);
+    /**
+     * Adds default selected channels to the select menu.
+     * @param channels - Channel IDs to be added as default.
+     * @returns The current ChannelSelectMenu instance.
+     */
+    addDefaultChannels(...channels: RestOrArray<string>): this;
+    /**
+     * Sets the default selected channels for the select menu.
+     * @param channels - Channel IDs to be set as default.
+     * @returns The current ChannelSelectMenu instance.
+     */
+    setDefaultChannels(...channels: RestOrArray<string>): this;
+    /**
+     * Sets the types of channels that can be selected in the menu.
+     *  types - The types of channels.
+     * @returns The current ChannelSelectMenu instance.
+     */
+    setChannelTypes(types: ChannelType[]): this;
+}
+/**
+ * Represents a Select Menu for selecting string options.
+ * @example
+ * const stringSelectMenu = new StringSelectMenu();
+ * stringSelectMenu.setCustomId("string-select");
+ * stringSelectMenu.addOption(new StringSelectOption().setLabel("Option 1").setValue("option_1"));
+ * stringSelectMenu.setOptions([
+ *   { label: "Option 2", value: "option_2" },
+ *   { label: "Option 3", value: "option_3" },
+ * ]);
+ */
+export declare class StringSelectMenu extends SelectMenu<APIStringSelectComponent, StringSelectMenuInteraction> {
+    constructor(data?: Partial<APIStringSelectComponent>);
+    /**
+     * Adds options to the string select menu.
+     * @param {...RestOrArray<APISelectMenuOption>} options - Options to be added.
+     * @returns The current StringSelectMenu instance.
+     */
+    addOption(...options: RestOrArray<APISelectMenuOption>): this;
+    /**
+     * Sets the options for the string select menu.
+     *  options - Options to be set.
+     * @returns The current StringSelectMenu instance.
+     */
+    setOptions(options: APISelectMenuOption[]): this;
+}
+/**
+ * Represents an individual option for a string select menu.
+ * @example
+ * const option = new StringSelectOption().setLabel("Option 1").setValue("option_1");
+ */
+export declare class StringSelectOption {
+    data: Partial<APISelectMenuOption>;
+    constructor(data?: Partial<APISelectMenuOption>);
+    /**
+     * Sets the label for the option.
+     *  label - The label for the option.
+     * @returns The current StringSelectOption instance.
+     */
+    setLabel(label: string): this;
+    /**
+     * Sets the value for the option.
+     *  value - The value for the option.
+     * @returns The current StringSelectOption instance.
+     */
+    setValue(value: string): this;
+    /**
+     * Sets the description for the option.
+     *  description - The description for the option.
+     * @returns The current StringSelectOption instance.
+     */
+    setDescription(description: string): this;
+    /**
+     * Sets whether the option is the default.
+     *  [Default=true] - Indicates whether the option is the default.
+     * @returns The current StringSelectOption instance.
+     */
+    setDefault(Default?: boolean): this;
+    /**
+     * Sets the emoji for the option.
+     *  emoji - The emoji for the option.
+     * @returns The current StringSelectOption instance.
+     */
+    setEmoji(emoji: APIMessageComponentEmoji): this;
+    /**
+     * Converts the option to JSON format.
+     * @returns The option data in JSON format.
+     */
+    toJSON(): APISelectMenuOption;
+}