@magicyan/discord 1.0.21 → 1.0.23

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, TextInputBuilder, ButtonBuilder, ActionRow, MessageActionRowComponent, TextInputComponentData, LinkButtonComponentData, ButtonComponent, StringSelectMenuComponent, UserSelectMenuComponent, ChannelSelectMenuComponent, RoleSelectMenuComponent, MentionableSelectMenuComponent, EmbedAuthorData, EmbedFooterData, EmbedAssetData, EmbedBuilder, User, ImageURLOptions, Attachment, AttachmentBuilder, EmbedData, APIEmbed, Embed, ColorResolvable, GuildEmoji, GuildBasedChannel, Role, GuildMember, GuildTextBasedChannel, Message } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, AnyComponentBuilder, ActionRowBuilder, TextInputBuilder, ButtonBuilder, ActionRow, MessageActionRowComponent, TextInputComponentData, LinkButtonComponentData, ButtonComponent, StringSelectMenuComponent, UserSelectMenuComponent, ChannelSelectMenuComponent, RoleSelectMenuComponent, MentionableSelectMenuComponent, GuildEmoji, GuildBasedChannel, Role, User, GuildMember, GuildTextBasedChannel, Message, Attachment, AttachmentBuilder, EmbedAssetData, EmbedAuthorData, ImageURLOptions, EmbedBuilder, EmbedData, APIEmbed, Embed, ColorResolvable, EmbedFooterData } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -16,25 +16,33 @@ declare const CustomPartials: {
     All: Partials[];
 };
 
-type FindChannelFilter<T extends ChannelType> = (channel: GetChannelType<T>) => boolean;
-type GetChannelType<Type extends ChannelType> = Extract<NonNullable<CommandInteractionOption<"cached">["channel"]>, {
+declare function setMobileStatus(): void;
+
+type GuildChannelType = Exclude<ChannelType, ChannelType.DM>;
+type FindChannelFilter<T extends GuildChannelType> = (channel: GetChannelType<T>) => boolean;
+type GetChannelType<Type extends GuildChannelType> = Extract<NonNullable<CommandInteractionOption<"cached">["channel"]>, {
     type: Type extends ChannelType.PublicThread | ChannelType.AnnouncementThread ? ChannelType.PublicThread | ChannelType.AnnouncementThread : Type;
 }>;
-declare function findChannel<Type extends Exclude<ChannelType, ChannelType.DM> = ChannelType.GuildText>(guild: Guild, type?: Type): {
+declare function findChannel<Type extends GuildChannelType = ChannelType.GuildText>(guild: Guild, type?: Type): {
     byName(name: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
     byId(id: string): GetChannelType<Type> | undefined;
-    byFilter(filter: FindChannelFilter<Type>): discord_js.GuildBasedChannel | undefined;
+    byFilter(filter: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
     inCategoryId(id: string): {
         byName(name: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
         byId(id: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
-        byFilter(filter: FindChannelFilter<Type>): discord_js.GuildBasedChannel | undefined;
+        byFilter(filter: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
     };
     inCategoryName(name: string): {
         byName(name: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
         byId(id: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
-        byFilter(filter: FindChannelFilter<Type>): discord_js.GuildBasedChannel | undefined;
+        byFilter(filter: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
     };
 };
+interface ChannelUrlInfo {
+    channelId?: string;
+    guildId?: string;
+}
+declare function getChannelUrlInfo(url: string): ChannelUrlInfo;
 
 type FindCommandFilter = (command: ApplicationCommand) => boolean;
 declare function findCommand(guildOrClient: Guild | Client<true>): {
@@ -80,72 +88,6 @@ interface MessageComponentsManager {
 }
 declare function createComponentsManager(components: ActionRow<MessageActionRowComponent>[]): MessageComponentsManager;
 
-interface CreateEmbedAuthorOptions {
-    user: User;
-    property?: "username" | "displayName" | "id" | "globalName";
-    imageSize?: ImageURLOptions["size"];
-    iconURL?: string;
-    url?: string;
-    prefix?: string;
-    suffix?: string;
-}
-declare function createEmbedAuthor(options: CreateEmbedAuthorOptions): EmbedAuthorData;
-interface CreateEmbedFooterOptions {
-    text?: string | null;
-    iconURL?: string | null;
-}
-declare function createEmbedFooter(options: CreateEmbedFooterOptions): EmbedFooterData | undefined;
-type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
-type AssetSource = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
-declare function createEmbedAsset(source: AssetSource, options?: EmbedAssetOptions): EmbedAssetData | undefined;
-type EmbedBuilderPlusAssetData = AssetSource;
-type EmbedBuilderPlusColorData = string & {} | ColorResolvable | null;
-type EmbedBuilderPlusFieldData = {
-    name: string;
-    value: string;
-    inline?: boolean;
-};
-type EmbedBuilderPlusFooterData = {
-    text?: string | null;
-    iconURL?: string | null;
-};
-type EmbedBuilderPlusAuthorData = {
-    name: string;
-    url?: string;
-    iconURL?: string;
-};
-interface EmbedBuilderPlusOptions {
-    extend?: Omit<EmbedBuilderPlusData, keyof EmbedBuilderPlusOptions> | EmbedData | APIEmbed | Embed;
-    mergeFields?: boolean;
-}
-interface EmbedBuilderPlusData extends EmbedBuilderPlusOptions {
-    title?: string | null;
-    color?: EmbedBuilderPlusColorData | null;
-    description?: string | null;
-    url?: string | null;
-    thumbnail?: EmbedBuilderPlusAssetData | null;
-    image?: EmbedBuilderPlusAssetData | null;
-    fields?: Partial<EmbedBuilderPlusFieldData>[] | null;
-    timestamp?: string | number | Date | null;
-    footer?: EmbedBuilderPlusFooterData;
-    author?: EmbedBuilderPlusAuthorData;
-}
-declare class EmbedBuilderPlus extends EmbedBuilder {
-    constructor(data: EmbedBuilderPlusData);
-    has(property: keyof Omit<EmbedBuilderPlusData, keyof EmbedBuilderPlusOptions>): boolean;
-    toArray(): this[];
-    toString(space?: number): string;
-    updateField(index: number, field: Partial<EmbedBuilderPlusFieldData>): this;
-    deleteField(index: number): this;
-    popField(): discord_js.APIEmbedField | undefined;
-    setAsset(asset: "thumbnail" | "image", source: EmbedBuilderPlusAssetData): this;
-    get fieldsLength(): number;
-    get fields(): discord_js.APIEmbedField[];
-    createFromThis(data?: EmbedBuilderPlusData): EmbedBuilderPlus;
-}
-type EmbedPropery<T extends keyof EmbedBuilderPlusData> = EmbedBuilderPlusData[T];
-declare function createEmbed(data: EmbedBuilderPlusData): EmbedBuilderPlus;
-
 type FindEmojiFilter = (emoji: GuildEmoji) => boolean;
 declare function findEmoji(guildOrClient: Guild | Client): {
     byName(name: string, animated?: boolean, and?: FindEmojiFilter): GuildEmoji | undefined;
@@ -175,6 +117,12 @@ declare function findMessage(channel: GuildTextBasedChannel): {
     };
     byFilter(filter: FindMessageFilter): Message<true> | undefined;
 };
+interface MessageUrlInfo {
+    messageId?: string;
+    channelId?: string;
+    guildId?: string;
+}
+declare function getMessageUrlInfo(url: string): MessageUrlInfo;
 
 type FindRoleFilter = (role: Role) => boolean;
 declare function findRole(guild: Guild): {
@@ -185,4 +133,99 @@ declare function findRole(guild: Guild): {
     byFilter(filter: FindRoleFilter): Role | undefined;
 };
 
-export { CustomItents, CustomPartials, EmbedBuilderPlus, type EmbedPropery, chars, createComponentsManager, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalInput, createRow, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, formatedMention };
+/**
+ *
+ * @param mention Discord mentionable string
+ * @returns mentionable id or null
+ *
+ * ```ts
+ * const user = "<@264620632644255745>";
+ * const channel = "<#1068689068256403457>";
+ * const role = "<@&929925182796226632>";
+ *
+ * extractMentionId(user) // 264620632644255745
+ * extractMentionId(channel) // 1068689068256403457
+ * extractMentionId(role) // 929925182796226632
+ * ```
+ */
+declare function extractMentionId(mention: string): string | null;
+
+type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
+type AssetSource = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
+declare function createEmbedAsset(source: AssetSource, options?: EmbedAssetOptions): EmbedAssetData | undefined;
+
+interface UserAuthorOption {
+    user: User;
+    property?: "username" | "displayName" | "id" | "globalName";
+}
+interface MemberAuthorOption {
+    member: GuildMember;
+    property?: "username" | "displayName" | "id" | "globalName" | "nickname";
+}
+type AuthorOption = UserAuthorOption | MemberAuthorOption;
+type CreateEmbedAuthorOptions = AuthorOption & ImageURLOptions & {
+    iconURL?: string;
+    url?: string;
+    prefix?: string;
+    suffix?: string;
+};
+declare function createEmbedAuthor(options: CreateEmbedAuthorOptions): EmbedAuthorData;
+
+type EmbedPlusAssetData = AssetSource;
+type EmbedPlusColorData = string & {} | ColorResolvable | null;
+type EmbedPlusFieldData = {
+    name: string;
+    value: string;
+    inline?: boolean;
+};
+type EmbedPlusFooterData = {
+    text?: string | null;
+    iconURL?: string | null;
+};
+type EmbedPlusAuthorData = {
+    name: string;
+    url?: string;
+    iconURL?: string;
+};
+interface EmbedPlusData {
+    title?: string | null;
+    color?: EmbedPlusColorData | null;
+    description?: string | null;
+    url?: string | null;
+    thumbnail?: EmbedPlusAssetData | null;
+    image?: EmbedPlusAssetData | null;
+    fields?: Partial<EmbedPlusFieldData>[] | null;
+    timestamp?: string | number | Date | null;
+    footer?: EmbedPlusFooterData;
+    author?: EmbedPlusAuthorData;
+}
+interface EmbedPlusOptions extends EmbedPlusData {
+    extends?: Omit<EmbedPlusData, keyof EmbedPlusOptions> | EmbedData | APIEmbed | Embed;
+    mergeFields?: boolean;
+}
+declare class EmbedPlusBuilder extends EmbedBuilder {
+    constructor(data: EmbedPlusOptions);
+    has(property: keyof Omit<EmbedPlusData, keyof EmbedPlusOptions>): boolean;
+    toArray(): this[];
+    toString(space?: number): string;
+    updateField(index: number, field: Partial<EmbedPlusFieldData>): this;
+    deleteField(index: number): this;
+    popField(): discord_js.APIEmbedField | undefined;
+    setAsset(asset: "thumbnail" | "image", source: EmbedPlusAssetData): this;
+    get fieldsLength(): number;
+    get fields(): discord_js.APIEmbedField[];
+}
+type EmbedPlusPropery<P extends keyof EmbedPlusData> = EmbedPlusData[P];
+interface CreateEmbedOptions<B extends boolean> extends EmbedPlusOptions {
+    array?: B;
+}
+type CreateEmbedReturn<B> = undefined extends B ? EmbedPlusBuilder : false extends B ? EmbedPlusBuilder : EmbedPlusBuilder[];
+declare function createEmbed<B extends boolean>(options: CreateEmbedOptions<B>): CreateEmbedReturn<B>;
+
+interface CreateEmbedFooterOptions {
+    text?: string | null;
+    iconURL?: string | null;
+}
+declare function createEmbedFooter(options: CreateEmbedFooterOptions): EmbedFooterData | undefined;
+
+export { type AssetSource, CustomItents, CustomPartials, EmbedPlusBuilder, type EmbedPlusPropery, chars, createComponentsManager, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalInput, createRow, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, formatedMention, getChannelUrlInfo, getMessageUrlInfo, 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, TextInputBuilder, ButtonBuilder, ActionRow, MessageActionRowComponent, TextInputComponentData, LinkButtonComponentData, ButtonComponent, StringSelectMenuComponent, UserSelectMenuComponent, ChannelSelectMenuComponent, RoleSelectMenuComponent, MentionableSelectMenuComponent, EmbedAuthorData, EmbedFooterData, EmbedAssetData, EmbedBuilder, User, ImageURLOptions, Attachment, AttachmentBuilder, EmbedData, APIEmbed, Embed, ColorResolvable, GuildEmoji, GuildBasedChannel, Role, GuildMember, GuildTextBasedChannel, Message } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, AnyComponentBuilder, ActionRowBuilder, TextInputBuilder, ButtonBuilder, ActionRow, MessageActionRowComponent, TextInputComponentData, LinkButtonComponentData, ButtonComponent, StringSelectMenuComponent, UserSelectMenuComponent, ChannelSelectMenuComponent, RoleSelectMenuComponent, MentionableSelectMenuComponent, GuildEmoji, GuildBasedChannel, Role, User, GuildMember, GuildTextBasedChannel, Message, Attachment, AttachmentBuilder, EmbedAssetData, EmbedAuthorData, ImageURLOptions, EmbedBuilder, EmbedData, APIEmbed, Embed, ColorResolvable, EmbedFooterData } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -16,25 +16,33 @@ declare const CustomPartials: {
     All: Partials[];
 };
 
-type FindChannelFilter<T extends ChannelType> = (channel: GetChannelType<T>) => boolean;
-type GetChannelType<Type extends ChannelType> = Extract<NonNullable<CommandInteractionOption<"cached">["channel"]>, {
+declare function setMobileStatus(): void;
+
+type GuildChannelType = Exclude<ChannelType, ChannelType.DM>;
+type FindChannelFilter<T extends GuildChannelType> = (channel: GetChannelType<T>) => boolean;
+type GetChannelType<Type extends GuildChannelType> = Extract<NonNullable<CommandInteractionOption<"cached">["channel"]>, {
     type: Type extends ChannelType.PublicThread | ChannelType.AnnouncementThread ? ChannelType.PublicThread | ChannelType.AnnouncementThread : Type;
 }>;
-declare function findChannel<Type extends Exclude<ChannelType, ChannelType.DM> = ChannelType.GuildText>(guild: Guild, type?: Type): {
+declare function findChannel<Type extends GuildChannelType = ChannelType.GuildText>(guild: Guild, type?: Type): {
     byName(name: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
     byId(id: string): GetChannelType<Type> | undefined;
-    byFilter(filter: FindChannelFilter<Type>): discord_js.GuildBasedChannel | undefined;
+    byFilter(filter: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
     inCategoryId(id: string): {
         byName(name: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
         byId(id: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
-        byFilter(filter: FindChannelFilter<Type>): discord_js.GuildBasedChannel | undefined;
+        byFilter(filter: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
     };
     inCategoryName(name: string): {
         byName(name: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
         byId(id: string, filter?: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
-        byFilter(filter: FindChannelFilter<Type>): discord_js.GuildBasedChannel | undefined;
+        byFilter(filter: FindChannelFilter<Type>): GetChannelType<Type> | undefined;
     };
 };
+interface ChannelUrlInfo {
+    channelId?: string;
+    guildId?: string;
+}
+declare function getChannelUrlInfo(url: string): ChannelUrlInfo;
 
 type FindCommandFilter = (command: ApplicationCommand) => boolean;
 declare function findCommand(guildOrClient: Guild | Client<true>): {
@@ -80,72 +88,6 @@ interface MessageComponentsManager {
 }
 declare function createComponentsManager(components: ActionRow<MessageActionRowComponent>[]): MessageComponentsManager;
 
-interface CreateEmbedAuthorOptions {
-    user: User;
-    property?: "username" | "displayName" | "id" | "globalName";
-    imageSize?: ImageURLOptions["size"];
-    iconURL?: string;
-    url?: string;
-    prefix?: string;
-    suffix?: string;
-}
-declare function createEmbedAuthor(options: CreateEmbedAuthorOptions): EmbedAuthorData;
-interface CreateEmbedFooterOptions {
-    text?: string | null;
-    iconURL?: string | null;
-}
-declare function createEmbedFooter(options: CreateEmbedFooterOptions): EmbedFooterData | undefined;
-type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
-type AssetSource = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
-declare function createEmbedAsset(source: AssetSource, options?: EmbedAssetOptions): EmbedAssetData | undefined;
-type EmbedBuilderPlusAssetData = AssetSource;
-type EmbedBuilderPlusColorData = string & {} | ColorResolvable | null;
-type EmbedBuilderPlusFieldData = {
-    name: string;
-    value: string;
-    inline?: boolean;
-};
-type EmbedBuilderPlusFooterData = {
-    text?: string | null;
-    iconURL?: string | null;
-};
-type EmbedBuilderPlusAuthorData = {
-    name: string;
-    url?: string;
-    iconURL?: string;
-};
-interface EmbedBuilderPlusOptions {
-    extend?: Omit<EmbedBuilderPlusData, keyof EmbedBuilderPlusOptions> | EmbedData | APIEmbed | Embed;
-    mergeFields?: boolean;
-}
-interface EmbedBuilderPlusData extends EmbedBuilderPlusOptions {
-    title?: string | null;
-    color?: EmbedBuilderPlusColorData | null;
-    description?: string | null;
-    url?: string | null;
-    thumbnail?: EmbedBuilderPlusAssetData | null;
-    image?: EmbedBuilderPlusAssetData | null;
-    fields?: Partial<EmbedBuilderPlusFieldData>[] | null;
-    timestamp?: string | number | Date | null;
-    footer?: EmbedBuilderPlusFooterData;
-    author?: EmbedBuilderPlusAuthorData;
-}
-declare class EmbedBuilderPlus extends EmbedBuilder {
-    constructor(data: EmbedBuilderPlusData);
-    has(property: keyof Omit<EmbedBuilderPlusData, keyof EmbedBuilderPlusOptions>): boolean;
-    toArray(): this[];
-    toString(space?: number): string;
-    updateField(index: number, field: Partial<EmbedBuilderPlusFieldData>): this;
-    deleteField(index: number): this;
-    popField(): discord_js.APIEmbedField | undefined;
-    setAsset(asset: "thumbnail" | "image", source: EmbedBuilderPlusAssetData): this;
-    get fieldsLength(): number;
-    get fields(): discord_js.APIEmbedField[];
-    createFromThis(data?: EmbedBuilderPlusData): EmbedBuilderPlus;
-}
-type EmbedPropery<T extends keyof EmbedBuilderPlusData> = EmbedBuilderPlusData[T];
-declare function createEmbed(data: EmbedBuilderPlusData): EmbedBuilderPlus;
-
 type FindEmojiFilter = (emoji: GuildEmoji) => boolean;
 declare function findEmoji(guildOrClient: Guild | Client): {
     byName(name: string, animated?: boolean, and?: FindEmojiFilter): GuildEmoji | undefined;
@@ -175,6 +117,12 @@ declare function findMessage(channel: GuildTextBasedChannel): {
     };
     byFilter(filter: FindMessageFilter): Message<true> | undefined;
 };
+interface MessageUrlInfo {
+    messageId?: string;
+    channelId?: string;
+    guildId?: string;
+}
+declare function getMessageUrlInfo(url: string): MessageUrlInfo;
 
 type FindRoleFilter = (role: Role) => boolean;
 declare function findRole(guild: Guild): {
@@ -185,4 +133,99 @@ declare function findRole(guild: Guild): {
     byFilter(filter: FindRoleFilter): Role | undefined;
 };
 
-export { CustomItents, CustomPartials, EmbedBuilderPlus, type EmbedPropery, chars, createComponentsManager, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalInput, createRow, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, formatedMention };
+/**
+ *
+ * @param mention Discord mentionable string
+ * @returns mentionable id or null
+ *
+ * ```ts
+ * const user = "<@264620632644255745>";
+ * const channel = "<#1068689068256403457>";
+ * const role = "<@&929925182796226632>";
+ *
+ * extractMentionId(user) // 264620632644255745
+ * extractMentionId(channel) // 1068689068256403457
+ * extractMentionId(role) // 929925182796226632
+ * ```
+ */
+declare function extractMentionId(mention: string): string | null;
+
+type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
+type AssetSource = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
+declare function createEmbedAsset(source: AssetSource, options?: EmbedAssetOptions): EmbedAssetData | undefined;
+
+interface UserAuthorOption {
+    user: User;
+    property?: "username" | "displayName" | "id" | "globalName";
+}
+interface MemberAuthorOption {
+    member: GuildMember;
+    property?: "username" | "displayName" | "id" | "globalName" | "nickname";
+}
+type AuthorOption = UserAuthorOption | MemberAuthorOption;
+type CreateEmbedAuthorOptions = AuthorOption & ImageURLOptions & {
+    iconURL?: string;
+    url?: string;
+    prefix?: string;
+    suffix?: string;
+};
+declare function createEmbedAuthor(options: CreateEmbedAuthorOptions): EmbedAuthorData;
+
+type EmbedPlusAssetData = AssetSource;
+type EmbedPlusColorData = string & {} | ColorResolvable | null;
+type EmbedPlusFieldData = {
+    name: string;
+    value: string;
+    inline?: boolean;
+};
+type EmbedPlusFooterData = {
+    text?: string | null;
+    iconURL?: string | null;
+};
+type EmbedPlusAuthorData = {
+    name: string;
+    url?: string;
+    iconURL?: string;
+};
+interface EmbedPlusData {
+    title?: string | null;
+    color?: EmbedPlusColorData | null;
+    description?: string | null;
+    url?: string | null;
+    thumbnail?: EmbedPlusAssetData | null;
+    image?: EmbedPlusAssetData | null;
+    fields?: Partial<EmbedPlusFieldData>[] | null;
+    timestamp?: string | number | Date | null;
+    footer?: EmbedPlusFooterData;
+    author?: EmbedPlusAuthorData;
+}
+interface EmbedPlusOptions extends EmbedPlusData {
+    extends?: Omit<EmbedPlusData, keyof EmbedPlusOptions> | EmbedData | APIEmbed | Embed;
+    mergeFields?: boolean;
+}
+declare class EmbedPlusBuilder extends EmbedBuilder {
+    constructor(data: EmbedPlusOptions);
+    has(property: keyof Omit<EmbedPlusData, keyof EmbedPlusOptions>): boolean;
+    toArray(): this[];
+    toString(space?: number): string;
+    updateField(index: number, field: Partial<EmbedPlusFieldData>): this;
+    deleteField(index: number): this;
+    popField(): discord_js.APIEmbedField | undefined;
+    setAsset(asset: "thumbnail" | "image", source: EmbedPlusAssetData): this;
+    get fieldsLength(): number;
+    get fields(): discord_js.APIEmbedField[];
+}
+type EmbedPlusPropery<P extends keyof EmbedPlusData> = EmbedPlusData[P];
+interface CreateEmbedOptions<B extends boolean> extends EmbedPlusOptions {
+    array?: B;
+}
+type CreateEmbedReturn<B> = undefined extends B ? EmbedPlusBuilder : false extends B ? EmbedPlusBuilder : EmbedPlusBuilder[];
+declare function createEmbed<B extends boolean>(options: CreateEmbedOptions<B>): CreateEmbedReturn<B>;
+
+interface CreateEmbedFooterOptions {
+    text?: string | null;
+    iconURL?: string | null;
+}
+declare function createEmbedFooter(options: CreateEmbedFooterOptions): EmbedFooterData | undefined;
+
+export { type AssetSource, CustomItents, CustomPartials, EmbedPlusBuilder, type EmbedPlusPropery, chars, createComponentsManager, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter, createLinkButton, createModalInput, createRow, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, formatedMention, getChannelUrlInfo, getMessageUrlInfo, setMobileStatus };

package/dist/index.mjs

@@ -1,12 +1,17 @@
 export { chars } from './constants/chars.mjs';
 export { CustomItents, CustomPartials } from './constants/client.mjs';
-export { findChannel } from './functions/channels.mjs';
+export { setMobileStatus } from './functions/misc.mjs';
+export { findChannel, getChannelUrlInfo } from './functions/channels.mjs';
 export { findCommand } from './functions/commands.mjs';
 export { createComponentsManager, createLinkButton, createModalInput, createRow } from './functions/components.mjs';
-export { EmbedBuilderPlus, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFooter } from './functions/embeds.mjs';
 export { findEmoji } from './functions/emojis.mjs';
 export { formatedMention } from './functions/format.mjs';
 export { findMember } from './functions/members.mjs';
-export { findMessage } from './functions/message.mjs';
+export { findMessage, getMessageUrlInfo } from './functions/message.mjs';
 export { findRole } from './functions/roles.mjs';
+export { extractMentionId } from './functions/regex.mjs';
+export { createEmbedAsset } from './functions/embeds/assets.mjs';
+export { createEmbedAuthor } from './functions/embeds/author.mjs';
+export { EmbedPlusBuilder, createEmbed } from './functions/embeds/embedplus.mjs';
+export { createEmbedFooter } from './functions/embeds/footer.mjs';
 export * from '@magicyan/core';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicyan/discord",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Simple functions to facilitate discord bot development",
   "license": "MIT",
   "type": "module",
@@ -32,7 +32,7 @@
   ],
   "scripts": {
     "build": "unbuild",
-    "dev": "tsx playground/index.ts"
+    "dev": "tsx --env-file .env playground/index.ts"
   },
   "devDependencies": {
     "tsx": "^4.7.0",

package/dist/functions/embeds.cjs

@@ -1,136 +0,0 @@
-'use strict';
-
-const discord_js = require('discord.js');
-const chars = require('../constants/chars.cjs');
-const core = require('@magicyan/core');
-
-function createEmbedAuthor(options) {
-  const {
-    user,
-    property = "displayName",
-    imageSize: size = 512,
-    iconURL,
-    url,
-    prefix = "",
-    suffix = ""
-  } = options;
-  return {
-    name: prefix + user[property] + suffix,
-    url,
-    iconURL: iconURL || user.displayAvatarURL({ size })
-  };
-}
-function createEmbedFooter(options) {
-  const { text, iconURL } = options;
-  return !text && !iconURL ? void 0 : { text: text ?? "\u200B", iconURL: core.notFound(iconURL) };
-}
-function createEmbedAsset(source, options) {
-  if (source instanceof discord_js.Attachment || source instanceof discord_js.AttachmentBuilder) {
-    return { url: `attachment://${source.name}`, ...options };
-  }
-  if (source && typeof source === "object" && "url" in source) {
-    return source;
-  }
-  return source ? { url: source, ...options } : void 0;
-}
-class EmbedBuilderPlus extends discord_js.EmbedBuilder {
-  constructor(data) {
-    const fields = (data.mergeFields ? [data.extend?.fields ?? [], data.fields ?? []].flat() : data.fields ?? data.extend?.fields ?? []).map(({ name = chars.chars.invisible, value = chars.chars.invisible, inline }) => ({
-      name,
-      value,
-      inline
-    }));
-    const extend = data.extend ? new EmbedBuilderPlus(
-      data.extend instanceof discord_js.Embed ? data.extend.data : data.extend instanceof discord_js.EmbedBuilder ? data.extend.data : data.extend
-    ).data : {};
-    const { fields: _, ...exetendData } = extend;
-    const embed = new discord_js.EmbedBuilder({
-      ...exetendData,
-      ...data.title ? { title: data.title } : {},
-      ...data.description ? { description: data.description } : {},
-      ...data.url ? { url: data.url } : {},
-      ...data.footer ? { footer: createEmbedFooter(data.footer) } : {},
-      ...data.author ? { author: data.author } : {},
-      ...data.image ? { image: createEmbedAsset(data.image) } : {},
-      ...data.thumbnail ? { thumbnail: createEmbedAsset(data.thumbnail) } : {},
-      ...fields.length > 0 ? { fields } : {}
-    });
-    if (data.timestamp)
-      embed.setTimestamp(
-        typeof data.timestamp === "string" ? new Date(data.timestamp) : data.timestamp
-      );
-    if (data.color)
-      embed.setColor(data.color);
-    super(embed.data);
-  }
-  has(property) {
-    return Boolean(this.data[property]);
-  }
-  toArray() {
-    return [this];
-  }
-  toString(space = 2) {
-    return JSON.stringify(this, null, space);
-  }
-  updateField(index, field) {
-    if (this.fields.at(index)) {
-      const fields = Array.from(this.fields);
-      if (field.name)
-        fields[index].name = field.name;
-      if (field.value)
-        fields[index].value = field.value;
-      if (field.inline)
-        fields[index].inline = field.inline;
-      this.setFields(fields);
-    }
-    return this;
-  }
-  deleteField(index) {
-    if (this.fields.at(index)) {
-      this.setFields(this.fields.toSpliced(index, 1));
-    }
-    return this;
-  }
-  popField() {
-    const fields = Array.from(this.fields);
-    const field = fields.pop();
-    this.setFields(fields);
-    return field;
-  }
-  setAsset(asset, source) {
-    let url = void 0;
-    if (source instanceof discord_js.Attachment || source instanceof discord_js.AttachmentBuilder) {
-      url = `attachment://${source.name}`;
-    }
-    if (source && typeof source === "object" && "url" in source) {
-      url = source.url;
-    }
-    if (!url)
-      return this;
-    if (asset === "thumbnail") {
-      this.setImage(url);
-    } else {
-      this.setThumbnail(url);
-    }
-    return this;
-  }
-  get fieldsLength() {
-    return this.data.fields?.length ?? 0;
-  }
-  get fields() {
-    return this.data.fields ?? [];
-  }
-  createFromThis(data = {}) {
-    data.extend = this;
-    return new EmbedBuilderPlus(data);
-  }
-}
-function createEmbed(data) {
-  return new EmbedBuilderPlus(data);
-}
-
-exports.EmbedBuilderPlus = EmbedBuilderPlus;
-exports.createEmbed = createEmbed;
-exports.createEmbedAsset = createEmbedAsset;
-exports.createEmbedAuthor = createEmbedAuthor;
-exports.createEmbedFooter = createEmbedFooter;