@magicyan/discord 1.0.27 → 1.0.28

package/README.md

@@ -16,121 +16,239 @@ Install with
 npm install @magicyan/discord
 ```
 
-Some functions summarize the way we create things with discord.js
+## Components
+Easily create action rows
 
 ```ts
-// Create an action row of buttons with discord.js
-new ActionRowBuilder<ButtonBuilder>({
-    components: [
-        new ButtonBuilder({
-            customId: "click-me-button",
-            label: "Click me", style: ButtonStyle.Success,
-        })
-        new ButtonBuilder({
-            customId: "dont-click-me-button",
-            label: "Don't click me", style: ButtonStyle.Danger,
-        })
-    ]
-})
+import { createRow } from "@magicyan/discord";
+
+const row = createRow(
+    new ButtonBuilder(/* button data... */),
+    new ButtonBuilder(/* button data... */),
+    new ButtonBuilder(/* button data... */),
+);
+const selectRow = createRow(
+    new StringSelectMenuBuilder(/* select data... */)
+);
+interaction.reply({ components: [row, selectRow] });
+```
+Create a link button quickly
+```ts
+import { createRow, createLinkButton } from "@magicyan/discord";
 
-// Create an action row of buttons with @magicyan/dicord
-createRow(
-    new ButtonBuilder({ 
-        customId: "click-me-button", label: "Click me", 
-        style: ButtonStyle.Success,
-    })
-    new ButtonBuilder({ 
-        customId: "dont-click-me-button", label: "Don't click me", 
-        style: ButtonStyle.Danger,
-    })
-)
+const row = createRow(
+    createLinkButton({ label: "Github", url: "https://github.com/rinckodev" })
+    createLinkButton({ label: "Youtube", url: "https://youtube.com/@rinckodev" })
+);
+interaction.reply({ components: [row] });
+```
 
-// Add inputs to the modal with discord.js
-new ModalBuilder({
-    customId: "my-modal",
-    title: "Modal Title",
-    components: [
-        new ActionRowBuilder<TextInputBuilder>({components: [
-            new TextInputBuilder({
-                customId: "name-input",
-                label: "Name",
-                placeholder: "Enter your name",
-                style: TextInputStyle.Short,
-                required: true
-            }),
-            new TextInputBuilder({
-                customId: "nio-modal",
-                label: "Bio",
-                placeholder: "Enter your bio",
-                style: TextInputStyle.Paragraph,
-                required: true
-            })
-        ]})
-    ]
-})
+## Modals
+A row only supports a single input, so use this function that already creates it within a row
+```ts
+import { createModalInput } from "@magicyan/discord";
 
-// Add inputs to the modal with @magicyan/dicord
-new ModalBuilder({
-    customId: "my-modal", title: "Modal Title",
+const modal = new ModalBuilder({
+    customId: "my/modal",
+    title: "My modal",
     components: [
         createModalInput({
-            customId: "name-input", placeholder: "Enter your name",
-            label: "Name", style: TextInputStyle.Short, required: true
+            customId: "name",
+            label: "Name",
+            style: TextInputStyle.Short,
         }),
         createModalInput({
-            customId: "nio-modal", placeholder: "Enter your bio",
-            label: "Bio", style: TextInputStyle.Paragraph, required: true
+            customId: "age",
+            label: "Age",
+            style: TextInputStyle.Short,
         }),
     ]
+});
+interaction.showModal(modal);
+```
+Or if you prefer, you can create a record where the key is the customId
+```ts
+import { createModalFields } from "@magicyan/discord";
+
+const modal = new ModalBuilder({
+    customId: "my/modal",
+    title: "My modal",
+    components: createModalFields({
+        name: {
+            label: "Name",
+            style: TextInputStyle.Short,
+        },
+        age:{
+            label: "Age",
+            style: TextInputStyle.Short,
+        },
+    })
+});
+```
+Don't forget that you can define the custom id however you want
+```ts
+createModalFields({
+    ["my-custom-input-name"]: {
+        label: "Name",
+        style: TextInputStyle.Short,
+    }
 })
 ```
-
-You can create a link button quickly
+You can transform the fields received from the interaction into a record
 ```ts
-const url = "https://github.com/rinckodev";
+import { modalFieldsToRecord } from "@magicyan/discord";
 
-createLinkButton({ url, label: "My github" });
+function run(interaction: ModalSubmitInteraction){
+    const fields = modalFieldsToRecord(interaction.fields);
+    console.log(fields["my-custom-input-name"]);
+    console.log(fields.age);
+}
 ```
+It is also possible to pass a union type in the function generic
+```ts
+type FormFields = "id" | "nickname" | "bio";
+function run(interaction: ModalSubmitInteraction){
+    const fields = modalFieldsToRecord<FormFields>(interaction.fields);
+    console.log(fields.id);
+    console.log(fields.nickname);
+    console.log(fields.bio);
+}
+```
+## Embeds
+> soon
 
-You can create an embed author easily with a User object
+## Channels
+You can try to get information from a channel url
 ```ts
-const { user } = interaction
+import { getChannelUrlInfo } from "@magicyan/discord";
 
-new EmbedBuilder({
-    author: createEmbedAuthor({ user }),
-    description: "My embed description"
-})
+const url = "https://discord.com/channels/537817462272557057/832829213651763210";
+const { guildId, channelId } = getChannelUrlInfo(url);
+console.log(guildId); // 537817462272557057
+console.log(channelId); // 832829213651763210
+```
+If the url does not follow the pattern of a discord channel url, the return will be an empty object
+```ts
+const url = "https://github.com/rinckodev";
+const { guildId, channelId } = getChannelUrlInfo(url);
+console.log(guildId); // undefined
+console.log(channelId); // undefined
 ```
+Find a guild channel easily with the findChannel function
+```ts
+import { findChannel } from "@magicyan/discord";
 
-Function to find a channel from the guild cache
+function run(interaction: ChatInputCommandInteraction<"cached">){
+    const { guild } = interaction; 
+    const channel = findChannel(guild).byId("832829213651763210");
+    channel // TextChannel | undefined
+}
+```
+This function searches for channels in the guild cache, by default it tries to find channels of the GuildText type, but you can change it to any type of guild channel
 ```ts
-const { guild } = interaction
+const channel = findChannel(guild, ChannelType.GuildVoice).byId("832829213651763210");
+// VoiceChannel | undefined
+```
+You can find channels in other ways
+```ts
+const general = findChannel(guild).byName("general");
+const updates = findChannel(guild, ChannelType.GuildAnnouncement).byName("updates");
+const lounge = findChannel(guild, ChannelType.GuildVoice).byName("Lounge 01");
+const popular = findChannel(guild, ChannelType.GuildStageVoice).byFilter(f => f.members.size >= 12);
+const hotforum = findChannel(guild, ChannelType.GuildForum).byFilter(f => f.threads.cache.size >= 100);
+
+general; // TextChannel | undefined
+updates; // NewsChannel | undefined
+lounge; // VoiceChannel | undefined
+popular; // StageChannel | undefined
+hotforum; // ForumChannel | undefined
+```
+Find a channel in a category easily
+```ts
+const ticket = findChannel(guild)
+    .inCategoryName("Tickets")
+    .byName(`ticket-${member.id}`);
 
-const channel = findChannel(guild, ChannelType.GuildVoice).byName("Lounge 01") // VoiceChannel  | undefined
+ticket; // TextChannel | undefined
+```
+## Roles
+Find guild roles easily
+```ts
+import { findRole } from "@magicyan/discord";
+
+function run(interaction: ChatInputCommandInteraction<"cached">){
+    const { guild } = interaction; 
+    
+    const memberRole = findRole(guild).byName("Member");
+    const adminRole = findRole(guild).byHexColor("#ff5454");
+    const leaderRole = findRole(guild).byId("537818031728885771");
+    
+    memberRole // Role | undefined
+    adminRole // Role | undefined
+    leaderRole // Role | undefined
+}
+```
+## Members
+Find guild members easily
+```ts
+import { findMember } from "@magicyan/discord";
+
+function run(interaction: ChatInputCommandInteraction<"cached">){
+    const { guild } = interaction;
+    const finder = findMember(guild);
+    const member = finder.byId("264620632644255745")
+    ?? finder.byUsername("rincko")
+    ?? finder.byGlobalName("Rincko")
+    ?? finder.byNickname("RinckoZ_");
+
+    member; // GuildMember | undefined
+}
 ```
+## Messages
+You can try to get information from a channel url
+```ts
+import { getMessageUrlInfo } from "@magicyan/discord";
 
-Function to find a role from the guild cache
+const url = "https://discord.com/channels/537817462272557057/1101949941712171078/1101950570035691530";
+const { guildId, channelId, messageId } = getMessageUrlInfo(url);
+console.log(guildId); // 537817462272557057
+console.log(channelId); // 1101949941712171078
+console.log(messageId); // 1101950570035691530
+```
+## Commands
+Find a command easily
 ```ts
-const { guild } = interaction
+import { findCommand } from "@magicyan/discord";
 
-const role = findChannel(guild).byName("Administrator") // Role  | undefined
+function run(interaction: ChatInputCommandInteraction<"cached">){
+    const { client } = interaction;
+    const command = findCommand(client).byName("register");
+    command; // ApplicationCommand | undefined
+}
 ```
 
-Function to create embed asset
-If the method used to obtain a url returns null or undefined the function will set undefined in the image property
+## Emojis
+Find a emoji easily
 ```ts
-const embed = new EmbedBuilder({
-    image: createEmbedAsset(guild.iconURL()) // { url: guild.iconUrl() } | undefined
-})
+import { findEmoji } from "@magicyan/discord";
+
+function run(interaction: ChatInputCommandInteraction<"cached">){
+    const { client } = interaction;
+    const emoji = findEmoji(client).byName("discord");
+    emoji; // GuildEmoji | undefined
+}
 ```
 
-When passing an attachment to the function, it will return the url with local attachments
+## Regex
+Extract the id of any mention
 ```ts
-const image = new AttachmentBuilder(buffer, { name: "myImage.png" });
+import { extractMentionId } from "@magicyan/discord";
 
-const embed = new EmbedBuilder({
-    image: createEmbedAsset(image) // { url: attachment://myImage.png }
-});
+const user = "<@264620632644255745>";
+const channel = "<#1068689068256403457>";
+const role = "<@&929925182796226632>";
 
-channel.send({ embeds: [embed], files: [image]})
+extractMentionId(user) // 264620632644255745
+extractMentionId(channel) // 1068689068256403457
+extractMentionId(role) // 929925182796226632
 ```

package/dist/functions/channels.cjs

@@ -60,6 +60,9 @@ function findChannel(guild, type) {
   };
 }
 function getChannelUrlInfo(url) {
+  const regex = new RegExp(/^https:\/\/discord\.com\/channels\/\d+\/\d+$/);
+  if (!regex.test(url))
+    return {};
   const [channelId, guildId] = url.split("/").reverse();
   return { channelId, guildId };
 }

package/dist/functions/channels.mjs

@@ -58,6 +58,9 @@ function findChannel(guild, type) {
   };
 }
 function getChannelUrlInfo(url) {
+  const regex = new RegExp(/^https:\/\/discord\.com\/channels\/\d+\/\d+$/);
+  if (!regex.test(url))
+    return {};
   const [channelId, guildId] = url.split("/").reverse();
   return { channelId, guildId };
 }

package/dist/functions/components.cjs

@@ -10,55 +10,6 @@ function createLinkButton(data) {
     data.label = data.url;
   return new discord_js.ButtonBuilder({ style: discord_js.ButtonStyle.Link, ...data });
 }
-function createComponentsManager(components) {
-  const buttons = components.flatMap(
-    (row) => row.components.filter((c) => c.type === discord_js.ComponentType.Button)
-  );
-  const stringSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === discord_js.ComponentType.StringSelect)
-  );
-  const userSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === discord_js.ComponentType.UserSelect)
-  );
-  const channelSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === discord_js.ComponentType.ChannelSelect)
-  );
-  const roleSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === discord_js.ComponentType.RoleSelect)
-  );
-  const mentionableSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === discord_js.ComponentType.MentionableSelect)
-  );
-  return {
-    getButton(customId) {
-      return buttons.find((b) => b.customId === customId);
-    },
-    getStringSelect(customId) {
-      return stringSelects.find((b) => b.customId === customId);
-    },
-    getUserSelect(customId) {
-      return userSelects.find((b) => b.customId === customId);
-    },
-    getChannelSelect(customId) {
-      return channelSelects.find((b) => b.customId === customId);
-    },
-    getRoleSelect(customId) {
-      return roleSelects.find((b) => b.customId === customId);
-    },
-    getMentionableSelect(customId) {
-      return mentionableSelects.find((b) => b.customId === customId);
-    },
-    resolved: {
-      buttons,
-      stringSelects,
-      userSelects,
-      channelSelects,
-      roleSelects,
-      mentionableSelects
-    }
-  };
-}
 
-exports.createComponentsManager = createComponentsManager;
 exports.createLinkButton = createLinkButton;
 exports.createRow = createRow;

package/dist/functions/components.mjs

@@ -1,4 +1,4 @@
-import { ActionRowBuilder, ButtonBuilder, ButtonStyle, ComponentType } from 'discord.js';
+import { ActionRowBuilder, ButtonBuilder, ButtonStyle } from 'discord.js';
 
 function createRow(...components) {
   return new ActionRowBuilder({ components });
@@ -8,53 +8,5 @@ function createLinkButton(data) {
     data.label = data.url;
   return new ButtonBuilder({ style: ButtonStyle.Link, ...data });
 }
-function createComponentsManager(components) {
-  const buttons = components.flatMap(
-    (row) => row.components.filter((c) => c.type === ComponentType.Button)
-  );
-  const stringSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === ComponentType.StringSelect)
-  );
-  const userSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === ComponentType.UserSelect)
-  );
-  const channelSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === ComponentType.ChannelSelect)
-  );
-  const roleSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === ComponentType.RoleSelect)
-  );
-  const mentionableSelects = components.flatMap(
-    (row) => row.components.filter((c) => c.type === ComponentType.MentionableSelect)
-  );
-  return {
-    getButton(customId) {
-      return buttons.find((b) => b.customId === customId);
-    },
-    getStringSelect(customId) {
-      return stringSelects.find((b) => b.customId === customId);
-    },
-    getUserSelect(customId) {
-      return userSelects.find((b) => b.customId === customId);
-    },
-    getChannelSelect(customId) {
-      return channelSelects.find((b) => b.customId === customId);
-    },
-    getRoleSelect(customId) {
-      return roleSelects.find((b) => b.customId === customId);
-    },
-    getMentionableSelect(customId) {
-      return mentionableSelects.find((b) => b.customId === customId);
-    },
-    resolved: {
-      buttons,
-      stringSelects,
-      userSelects,
-      channelSelects,
-      roleSelects,
-      mentionableSelects
-    }
-  };
-}
 
-export { createComponentsManager, createLinkButton, createRow };
+export { createLinkButton, createRow };

package/dist/functions/embeds/embedplus.cjs

@@ -3,8 +3,8 @@
 const discord_js = require('discord.js');
 const chars = require('../../constants/chars.cjs');
 const assets = require('./assets.cjs');
-const footer = require('./footer.cjs');
 const fields = require('./fields.cjs');
+const footer = require('./footer.cjs');
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;

package/dist/functions/embeds/embedplus.mjs

@@ -1,8 +1,8 @@
 import { EmbedBuilder } from 'discord.js';
 import { chars } from '../../constants/chars.mjs';
 import { createEmbedAsset } from './assets.mjs';
-import { createEmbedFooter } from './footer.mjs';
 import { EmbedPlusFields } from './fields.mjs';
+import { createEmbedFooter } from './footer.mjs';
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;

package/dist/functions/message.cjs

@@ -41,6 +41,9 @@ function findMessage(channel) {
   };
 }
 function getMessageUrlInfo(url) {
+  const regex = new RegExp(/^https:\/\/discord\.com\/channels\/\d+\/\d+\/\d+$/);
+  if (!regex.test(url))
+    return {};
   const [messageId, channelId, guildId] = url.split("/").reverse();
   return { messageId, channelId, guildId };
 }

package/dist/functions/message.mjs

@@ -39,6 +39,9 @@ function findMessage(channel) {
   };
 }
 function getMessageUrlInfo(url) {
+  const regex = new RegExp(/^https:\/\/discord\.com\/channels\/\d+\/\d+\/\d+$/);
+  if (!regex.test(url))
+    return {};
   const [messageId, channelId, guildId] = url.split("/").reverse();
   return { messageId, channelId, guildId };
 }

package/dist/index.cjs

@@ -8,7 +8,6 @@ const commands = require('./functions/commands.cjs');
 const components = require('./functions/components.cjs');
 const modals = require('./functions/modals.cjs');
 const emojis = require('./functions/emojis.cjs');
-const format = require('./functions/format.cjs');
 const members = require('./functions/members.cjs');
 const message = require('./functions/message.cjs');
 const roles = require('./functions/roles.cjs');
@@ -28,14 +27,12 @@ exports.setMobileStatus = misc.setMobileStatus;
 exports.findChannel = channels.findChannel;
 exports.getChannelUrlInfo = channels.getChannelUrlInfo;
 exports.findCommand = commands.findCommand;
-exports.createComponentsManager = components.createComponentsManager;
 exports.createLinkButton = components.createLinkButton;
 exports.createRow = components.createRow;
 exports.createModalFields = modals.createModalFields;
 exports.createModalInput = modals.createModalInput;
 exports.modalFieldsToRecord = modals.modalFieldsToRecord;
 exports.findEmoji = emojis.findEmoji;
-exports.formatedMention = format.formatedMention;
 exports.findMember = members.findMember;
 exports.findMessage = message.findMessage;
 exports.getMessageUrlInfo = message.getMessageUrlInfo;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, ActionRow, MessageActionRowComponent, LinkButtonComponentData, ButtonComponent, StringSelectMenuComponent, UserSelectMenuComponent, ChannelSelectMenuComponent, RoleSelectMenuComponent, MentionableSelectMenuComponent, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildBasedChannel, Role, User, GuildMember, GuildTextBasedChannel, Message, Attachment, AttachmentBuilder, EmbedAssetData, EmbedAuthorData, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedBuilder, EmbedData, ColorResolvable } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, Attachment, AttachmentBuilder, EmbedAssetData, EmbedAuthorData, ImageURLOptions, User, EmbedFooterData, APIEmbed, Embed, EmbedBuilder, EmbedData, ColorResolvable } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -61,37 +61,14 @@ declare function createRow<Component extends AnyComponentBuilder>(...components:
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
 declare function createLinkButton(data: CreateLinkButtonData): ButtonBuilder;
-interface MessageComponentsManager {
-    getButton(customId: string): ButtonComponent | undefined;
-    getButton(customId: string, required: true): ButtonComponent;
-    getStringSelect(customId: string): StringSelectMenuComponent | undefined;
-    getStringSelect(customId: string, required: true): StringSelectMenuComponent;
-    getUserSelect(customId: string): UserSelectMenuComponent | undefined;
-    getUserSelect(customId: string, required: true): UserSelectMenuComponent;
-    getChannelSelect(customId: string): ChannelSelectMenuComponent | undefined;
-    getChannelSelect(customId: string, required: true): ChannelSelectMenuComponent;
-    getRoleSelect(customId: string): RoleSelectMenuComponent | undefined;
-    getRoleSelect(customId: string, required: true): RoleSelectMenuComponent;
-    getMentionableSelect(customId: string): MentionableSelectMenuComponent | undefined;
-    getMentionableSelect(customId: string, required: true): MentionableSelectMenuComponent;
-    resolved: {
-        buttons: ButtonComponent[];
-        stringSelects: StringSelectMenuComponent[];
-        userSelects: UserSelectMenuComponent[];
-        channelSelects: ChannelSelectMenuComponent[];
-        roleSelects: RoleSelectMenuComponent[];
-        mentionableSelects: MentionableSelectMenuComponent[];
-    };
-}
-declare function createComponentsManager(components: ActionRow<MessageActionRowComponent>[]): MessageComponentsManager;
 
 type TextInputData = Omit<TextInputComponentData, "type">;
 type CreateModalInputData = TextInputData;
 declare function createModalInput(data: CreateModalInputData): ActionRowBuilder<TextInputBuilder>;
 type ModalFieldsData = Record<string, Omit<TextInputData, "customId">>;
 declare function createModalFields(data: ModalFieldsData): ActionRowBuilder<TextInputBuilder>[];
-type ModalFieldsRecord = Record<string, string>;
-declare function modalFieldsToRecord(fields: ModalSubmitFields | Collection<string, TextInputComponent>): ModalFieldsRecord;
+type ModalFieldsRecord<K extends string> = Record<K, string>;
+declare function modalFieldsToRecord<K extends string = string>(fields: ModalSubmitFields | Collection<string, TextInputComponent>): ModalFieldsRecord<K>;
 
 type FindEmojiFilter = (emoji: GuildEmoji) => boolean;
 declare function findEmoji(guildOrClient: Guild | Client): {
@@ -100,8 +77,6 @@ declare function findEmoji(guildOrClient: Guild | Client): {
     byFilter(filter: FindEmojiFilter): GuildEmoji | undefined;
 };
 
-declare function formatedMention(ref: GuildBasedChannel | Role | User | undefined | null, alt?: string): string;
-
 type FindMemberFilter = (member: GuildMember) => boolean;
 declare function findMember(guild: Guild): {
     byGlobalName(globalName: string, and?: FindMemberFilter): GuildMember | undefined;
@@ -186,12 +161,6 @@ type CreateEmbedAuthorOptions = AuthorOption & ImageURLOptions & {
 };
 declare function createEmbedAuthor(options: CreateEmbedAuthorOptions): EmbedAuthorData;
 
-type EmbedPlusFooterData = {
-    text?: string | null;
-    iconURL?: string | null;
-};
-declare function createEmbedFooter(options: EmbedPlusFooterData): EmbedFooterData | undefined;
-
 type EmbedPlusFieldData = {
     name: string;
     value: string;
@@ -227,6 +196,12 @@ declare class EmbedPlusFields {
     private getPredicateIndex;
 }
 
+type EmbedPlusFooterData = {
+    text?: string | null;
+    iconURL?: string | null;
+};
+declare function createEmbedFooter(options: EmbedPlusFooterData): EmbedFooterData | undefined;
+
 type EmbedPlusColorData = string & {} | ColorResolvable | null;
 type EmbedPlusAuthorData = {
     name: string;
@@ -276,4 +251,4 @@ interface CreateEmbedOptions<B extends boolean> extends EmbedPlusOptions {
 type CreateEmbedReturn<B> = undefined extends B ? EmbedPlusBuilder : false extends B ? EmbedPlusBuilder : EmbedPlusBuilder[];
 declare function createEmbed<B extends boolean>(options: CreateEmbedOptions<B>): CreateEmbedReturn<B>;
 
-export { type AnyEmbed, CustomItents, CustomPartials, type EmbedPlusAssetData, EmbedPlusBuilder, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createComponentsManager, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, formatedMention, getChannelUrlInfo, getMessageUrlInfo, modalFieldsToRecord, setMobileStatus };
+export { type AnyEmbed, CustomItents, CustomPartials, type EmbedPlusAssetData, EmbedPlusBuilder, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, modalFieldsToRecord, setMobileStatus };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, ActionRow, MessageActionRowComponent, LinkButtonComponentData, ButtonComponent, StringSelectMenuComponent, UserSelectMenuComponent, ChannelSelectMenuComponent, RoleSelectMenuComponent, MentionableSelectMenuComponent, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildBasedChannel, Role, User, GuildMember, GuildTextBasedChannel, Message, Attachment, AttachmentBuilder, EmbedAssetData, EmbedAuthorData, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedBuilder, EmbedData, ColorResolvable } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, Attachment, AttachmentBuilder, EmbedAssetData, EmbedAuthorData, ImageURLOptions, User, EmbedFooterData, APIEmbed, Embed, EmbedBuilder, EmbedData, ColorResolvable } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -61,37 +61,14 @@ declare function createRow<Component extends AnyComponentBuilder>(...components:
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
 declare function createLinkButton(data: CreateLinkButtonData): ButtonBuilder;
-interface MessageComponentsManager {
-    getButton(customId: string): ButtonComponent | undefined;
-    getButton(customId: string, required: true): ButtonComponent;
-    getStringSelect(customId: string): StringSelectMenuComponent | undefined;
-    getStringSelect(customId: string, required: true): StringSelectMenuComponent;
-    getUserSelect(customId: string): UserSelectMenuComponent | undefined;
-    getUserSelect(customId: string, required: true): UserSelectMenuComponent;
-    getChannelSelect(customId: string): ChannelSelectMenuComponent | undefined;
-    getChannelSelect(customId: string, required: true): ChannelSelectMenuComponent;
-    getRoleSelect(customId: string): RoleSelectMenuComponent | undefined;
-    getRoleSelect(customId: string, required: true): RoleSelectMenuComponent;
-    getMentionableSelect(customId: string): MentionableSelectMenuComponent | undefined;
-    getMentionableSelect(customId: string, required: true): MentionableSelectMenuComponent;
-    resolved: {
-        buttons: ButtonComponent[];
-        stringSelects: StringSelectMenuComponent[];
-        userSelects: UserSelectMenuComponent[];
-        channelSelects: ChannelSelectMenuComponent[];
-        roleSelects: RoleSelectMenuComponent[];
-        mentionableSelects: MentionableSelectMenuComponent[];
-    };
-}
-declare function createComponentsManager(components: ActionRow<MessageActionRowComponent>[]): MessageComponentsManager;
 
 type TextInputData = Omit<TextInputComponentData, "type">;
 type CreateModalInputData = TextInputData;
 declare function createModalInput(data: CreateModalInputData): ActionRowBuilder<TextInputBuilder>;
 type ModalFieldsData = Record<string, Omit<TextInputData, "customId">>;
 declare function createModalFields(data: ModalFieldsData): ActionRowBuilder<TextInputBuilder>[];
-type ModalFieldsRecord = Record<string, string>;
-declare function modalFieldsToRecord(fields: ModalSubmitFields | Collection<string, TextInputComponent>): ModalFieldsRecord;
+type ModalFieldsRecord<K extends string> = Record<K, string>;
+declare function modalFieldsToRecord<K extends string = string>(fields: ModalSubmitFields | Collection<string, TextInputComponent>): ModalFieldsRecord<K>;
 
 type FindEmojiFilter = (emoji: GuildEmoji) => boolean;
 declare function findEmoji(guildOrClient: Guild | Client): {
@@ -100,8 +77,6 @@ declare function findEmoji(guildOrClient: Guild | Client): {
     byFilter(filter: FindEmojiFilter): GuildEmoji | undefined;
 };
 
-declare function formatedMention(ref: GuildBasedChannel | Role | User | undefined | null, alt?: string): string;
-
 type FindMemberFilter = (member: GuildMember) => boolean;
 declare function findMember(guild: Guild): {
     byGlobalName(globalName: string, and?: FindMemberFilter): GuildMember | undefined;
@@ -186,12 +161,6 @@ type CreateEmbedAuthorOptions = AuthorOption & ImageURLOptions & {
 };
 declare function createEmbedAuthor(options: CreateEmbedAuthorOptions): EmbedAuthorData;
 
-type EmbedPlusFooterData = {
-    text?: string | null;
-    iconURL?: string | null;
-};
-declare function createEmbedFooter(options: EmbedPlusFooterData): EmbedFooterData | undefined;
-
 type EmbedPlusFieldData = {
     name: string;
     value: string;
@@ -227,6 +196,12 @@ declare class EmbedPlusFields {
     private getPredicateIndex;
 }
 
+type EmbedPlusFooterData = {
+    text?: string | null;
+    iconURL?: string | null;
+};
+declare function createEmbedFooter(options: EmbedPlusFooterData): EmbedFooterData | undefined;
+
 type EmbedPlusColorData = string & {} | ColorResolvable | null;
 type EmbedPlusAuthorData = {
     name: string;
@@ -276,4 +251,4 @@ interface CreateEmbedOptions<B extends boolean> extends EmbedPlusOptions {
 type CreateEmbedReturn<B> = undefined extends B ? EmbedPlusBuilder : false extends B ? EmbedPlusBuilder : EmbedPlusBuilder[];
 declare function createEmbed<B extends boolean>(options: CreateEmbedOptions<B>): CreateEmbedReturn<B>;
 
-export { type AnyEmbed, CustomItents, CustomPartials, type EmbedPlusAssetData, EmbedPlusBuilder, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createComponentsManager, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, formatedMention, getChannelUrlInfo, getMessageUrlInfo, modalFieldsToRecord, setMobileStatus };
+export { type AnyEmbed, CustomItents, CustomPartials, type EmbedPlusAssetData, EmbedPlusBuilder, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, modalFieldsToRecord, setMobileStatus };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, ActionRow, MessageActionRowComponent, LinkButtonComponentData, ButtonComponent, StringSelectMenuComponent, UserSelectMenuComponent, ChannelSelectMenuComponent, RoleSelectMenuComponent, MentionableSelectMenuComponent, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildBasedChannel, Role, User, GuildMember, GuildTextBasedChannel, Message, Attachment, AttachmentBuilder, EmbedAssetData, EmbedAuthorData, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedBuilder, EmbedData, ColorResolvable } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, Attachment, AttachmentBuilder, EmbedAssetData, EmbedAuthorData, ImageURLOptions, User, EmbedFooterData, APIEmbed, Embed, EmbedBuilder, EmbedData, ColorResolvable } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -61,37 +61,14 @@ declare function createRow<Component extends AnyComponentBuilder>(...components:
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
 declare function createLinkButton(data: CreateLinkButtonData): ButtonBuilder;
-interface MessageComponentsManager {
-    getButton(customId: string): ButtonComponent | undefined;
-    getButton(customId: string, required: true): ButtonComponent;
-    getStringSelect(customId: string): StringSelectMenuComponent | undefined;
-    getStringSelect(customId: string, required: true): StringSelectMenuComponent;
-    getUserSelect(customId: string): UserSelectMenuComponent | undefined;
-    getUserSelect(customId: string, required: true): UserSelectMenuComponent;
-    getChannelSelect(customId: string): ChannelSelectMenuComponent | undefined;
-    getChannelSelect(customId: string, required: true): ChannelSelectMenuComponent;
-    getRoleSelect(customId: string): RoleSelectMenuComponent | undefined;
-    getRoleSelect(customId: string, required: true): RoleSelectMenuComponent;
-    getMentionableSelect(customId: string): MentionableSelectMenuComponent | undefined;
-    getMentionableSelect(customId: string, required: true): MentionableSelectMenuComponent;
-    resolved: {
-        buttons: ButtonComponent[];
-        stringSelects: StringSelectMenuComponent[];
-        userSelects: UserSelectMenuComponent[];
-        channelSelects: ChannelSelectMenuComponent[];
-        roleSelects: RoleSelectMenuComponent[];
-        mentionableSelects: MentionableSelectMenuComponent[];
-    };
-}
-declare function createComponentsManager(components: ActionRow<MessageActionRowComponent>[]): MessageComponentsManager;
 
 type TextInputData = Omit<TextInputComponentData, "type">;
 type CreateModalInputData = TextInputData;
 declare function createModalInput(data: CreateModalInputData): ActionRowBuilder<TextInputBuilder>;
 type ModalFieldsData = Record<string, Omit<TextInputData, "customId">>;
 declare function createModalFields(data: ModalFieldsData): ActionRowBuilder<TextInputBuilder>[];
-type ModalFieldsRecord = Record<string, string>;
-declare function modalFieldsToRecord(fields: ModalSubmitFields | Collection<string, TextInputComponent>): ModalFieldsRecord;
+type ModalFieldsRecord<K extends string> = Record<K, string>;
+declare function modalFieldsToRecord<K extends string = string>(fields: ModalSubmitFields | Collection<string, TextInputComponent>): ModalFieldsRecord<K>;
 
 type FindEmojiFilter = (emoji: GuildEmoji) => boolean;
 declare function findEmoji(guildOrClient: Guild | Client): {
@@ -100,8 +77,6 @@ declare function findEmoji(guildOrClient: Guild | Client): {
     byFilter(filter: FindEmojiFilter): GuildEmoji | undefined;
 };
 
-declare function formatedMention(ref: GuildBasedChannel | Role | User | undefined | null, alt?: string): string;
-
 type FindMemberFilter = (member: GuildMember) => boolean;
 declare function findMember(guild: Guild): {
     byGlobalName(globalName: string, and?: FindMemberFilter): GuildMember | undefined;
@@ -186,12 +161,6 @@ type CreateEmbedAuthorOptions = AuthorOption & ImageURLOptions & {
 };
 declare function createEmbedAuthor(options: CreateEmbedAuthorOptions): EmbedAuthorData;
 
-type EmbedPlusFooterData = {
-    text?: string | null;
-    iconURL?: string | null;
-};
-declare function createEmbedFooter(options: EmbedPlusFooterData): EmbedFooterData | undefined;
-
 type EmbedPlusFieldData = {
     name: string;
     value: string;
@@ -227,6 +196,12 @@ declare class EmbedPlusFields {
     private getPredicateIndex;
 }
 
+type EmbedPlusFooterData = {
+    text?: string | null;
+    iconURL?: string | null;
+};
+declare function createEmbedFooter(options: EmbedPlusFooterData): EmbedFooterData | undefined;
+
 type EmbedPlusColorData = string & {} | ColorResolvable | null;
 type EmbedPlusAuthorData = {
     name: string;
@@ -276,4 +251,4 @@ interface CreateEmbedOptions<B extends boolean> extends EmbedPlusOptions {
 type CreateEmbedReturn<B> = undefined extends B ? EmbedPlusBuilder : false extends B ? EmbedPlusBuilder : EmbedPlusBuilder[];
 declare function createEmbed<B extends boolean>(options: CreateEmbedOptions<B>): CreateEmbedReturn<B>;
 
-export { type AnyEmbed, CustomItents, CustomPartials, type EmbedPlusAssetData, EmbedPlusBuilder, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createComponentsManager, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, formatedMention, getChannelUrlInfo, getMessageUrlInfo, modalFieldsToRecord, setMobileStatus };
+export { type AnyEmbed, CustomItents, CustomPartials, type EmbedPlusAssetData, EmbedPlusBuilder, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, modalFieldsToRecord, setMobileStatus };

package/dist/index.mjs

@@ -3,10 +3,9 @@ export { CustomItents, CustomPartials } from './constants/client.mjs';
 export { setMobileStatus } from './functions/misc.mjs';
 export { findChannel, getChannelUrlInfo } from './functions/channels.mjs';
 export { findCommand } from './functions/commands.mjs';
-export { createComponentsManager, createLinkButton, createRow } from './functions/components.mjs';
+export { createLinkButton, createRow } from './functions/components.mjs';
 export { createModalFields, createModalInput, modalFieldsToRecord } from './functions/modals.mjs';
 export { findEmoji } from './functions/emojis.mjs';
-export { formatedMention } from './functions/format.mjs';
 export { findMember } from './functions/members.mjs';
 export { findMessage, getMessageUrlInfo } from './functions/message.mjs';
 export { findRole } from './functions/roles.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicyan/discord",
-  "version": "1.0.27",
+  "version": "1.0.28",
   "description": "Simple functions to facilitate discord bot development",
   "license": "MIT",
   "type": "module",

package/dist/functions/format.cjs

@@ -1,9 +0,0 @@
-'use strict';
-
-const discord_js = require('discord.js');
-
-function formatedMention(ref, alt = "") {
-  return ref instanceof discord_js.Role ? discord_js.roleMention(ref.id) : ref instanceof discord_js.User ? discord_js.userMention(ref.id) : ref ? discord_js.channelMention(ref.id) : alt;
-}
-
-exports.formatedMention = formatedMention;

package/dist/functions/format.mjs

@@ -1,7 +0,0 @@
-import { Role, roleMention, User, userMention, channelMention } from 'discord.js';
-
-function formatedMention(ref, alt = "") {
-  return ref instanceof Role ? roleMention(ref.id) : ref instanceof User ? userMention(ref.id) : ref ? channelMention(ref.id) : alt;
-}
-
-export { formatedMention };