@magicyan/discord 1.0.30 → 1.0.32

package/dist/functions/commands.cjs

@@ -16,5 +16,28 @@ function findCommand(guildOrClient) {
     }
   };
 }
+function createCommandOptions(options) {
+  return Object.entries(options).map(
+    ([name, data]) => Object.assign(data, { name })
+  );
+}
+function createSubCommands(subcommands) {
+  return Object.entries(subcommands).map(([name, data]) => {
+    if (data.options)
+      Object.assign(data, {
+        options: createCommandOptions(data.options)
+      });
+    return Object.assign(data, { name, type: discord_js.ApplicationCommandOptionType.Subcommand });
+  });
+}
+function createSubCommandsGroups(groups) {
+  return Object.entries(groups).map(([name, data]) => {
+    const options = createSubCommands(data.subcommands);
+    return Object.assign(data, { name, type: discord_js.ApplicationCommandOptionType.SubcommandGroup, options });
+  });
+}
 
+exports.createCommandOptions = createCommandOptions;
+exports.createSubCommands = createSubCommands;
+exports.createSubCommandsGroups = createSubCommandsGroups;
 exports.findCommand = findCommand;

package/dist/functions/commands.mjs

@@ -1,4 +1,4 @@
-import { Client } from 'discord.js';
+import { Client, ApplicationCommandOptionType } from 'discord.js';
 
 function findCommand(guildOrClient) {
   const commands = guildOrClient instanceof Client ? guildOrClient.application.commands.cache : guildOrClient.commands.cache;
@@ -14,5 +14,25 @@ function findCommand(guildOrClient) {
     }
   };
 }
+function createCommandOptions(options) {
+  return Object.entries(options).map(
+    ([name, data]) => Object.assign(data, { name })
+  );
+}
+function createSubCommands(subcommands) {
+  return Object.entries(subcommands).map(([name, data]) => {
+    if (data.options)
+      Object.assign(data, {
+        options: createCommandOptions(data.options)
+      });
+    return Object.assign(data, { name, type: ApplicationCommandOptionType.Subcommand });
+  });
+}
+function createSubCommandsGroups(groups) {
+  return Object.entries(groups).map(([name, data]) => {
+    const options = createSubCommands(data.subcommands);
+    return Object.assign(data, { name, type: ApplicationCommandOptionType.SubcommandGroup, options });
+  });
+}
 
-export { findCommand };
+export { createCommandOptions, createSubCommands, createSubCommandsGroups, findCommand };

package/dist/functions/embeds/embedplus.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
 const discord_js = require('discord.js');
-const chars = require('../../constants/chars.cjs');
 const assets = require('./assets.cjs');
 const fields = require('./fields.cjs');
 const footer = require('./footer.cjs');
+const chars = require('../../constants/chars.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;
@@ -54,6 +54,10 @@ class EmbedPlusBuilder extends discord_js.EmbedBuilder {
   toString(space = 2) {
     return JSON.stringify(this, null, space);
   }
+  toAttachment(data = { name: "embed.png" }, space = 2) {
+    const buffer = Buffer.from(this.toString(space), "utf-8");
+    return new discord_js.AttachmentBuilder(buffer, data);
+  }
   setBorderColor(color) {
     if (color === null) {
       this.setColor("#2B2D31");
@@ -65,10 +69,32 @@ class EmbedPlusBuilder extends discord_js.EmbedBuilder {
     return this;
   }
   setAsset(asset, source) {
-    if (source === null) {
-      asset === "image" ? this.setImage(source) : this.setThumbnail(source);
-    } else {
-      this.update({ [asset]: source });
+    this.update({ [asset]: source });
+    return this;
+  }
+  setElementImageURL(element, url) {
+    switch (element) {
+      case "thumbnail":
+      case "image": {
+        this.setAsset(element, url);
+        break;
+      }
+      case "author": {
+        const author = this.data.author;
+        this.setAuthor({
+          name: author?.name ?? chars.chars.invisible,
+          iconURL: url ?? void 0
+        });
+        break;
+      }
+      case "footer": {
+        const footer = this.data.footer;
+        this.setFooter({
+          text: footer?.text ?? chars.chars.invisible,
+          iconURL: url ?? void 0
+        });
+        break;
+      }
     }
     return this;
   }
@@ -80,8 +106,8 @@ class EmbedPlusBuilder extends discord_js.EmbedBuilder {
   }
 }
 function createEmbed(options) {
-  const { array = false, interaction, ...data } = options;
-  const embed = interaction ? EmbedPlusBuilder.fromInteraction(interaction, 0, data) : new EmbedPlusBuilder(data);
+  const { array = false, from, fromIndex = 0, ...data } = options;
+  const embed = from ? "message" in from ? EmbedPlusBuilder.fromInteraction(from, fromIndex, data) : EmbedPlusBuilder.fromMessage(from, fromIndex, data) : new EmbedPlusBuilder(data);
   return array ? [embed] : embed;
 }
 

package/dist/functions/embeds/embedplus.mjs

@@ -1,8 +1,8 @@
-import { EmbedBuilder } from 'discord.js';
-import { chars } from '../../constants/chars.mjs';
+import { EmbedBuilder, AttachmentBuilder } from 'discord.js';
 import { createEmbedAsset } from './assets.mjs';
 import { EmbedPlusFields } from './fields.mjs';
 import { createEmbedFooter } from './footer.mjs';
+import { chars } from '../../constants/chars.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;
@@ -52,6 +52,10 @@ class EmbedPlusBuilder extends EmbedBuilder {
   toString(space = 2) {
     return JSON.stringify(this, null, space);
   }
+  toAttachment(data = { name: "embed.png" }, space = 2) {
+    const buffer = Buffer.from(this.toString(space), "utf-8");
+    return new AttachmentBuilder(buffer, data);
+  }
   setBorderColor(color) {
     if (color === null) {
       this.setColor("#2B2D31");
@@ -63,10 +67,32 @@ class EmbedPlusBuilder extends EmbedBuilder {
     return this;
   }
   setAsset(asset, source) {
-    if (source === null) {
-      asset === "image" ? this.setImage(source) : this.setThumbnail(source);
-    } else {
-      this.update({ [asset]: source });
+    this.update({ [asset]: source });
+    return this;
+  }
+  setElementImageURL(element, url) {
+    switch (element) {
+      case "thumbnail":
+      case "image": {
+        this.setAsset(element, url);
+        break;
+      }
+      case "author": {
+        const author = this.data.author;
+        this.setAuthor({
+          name: author?.name ?? chars.invisible,
+          iconURL: url ?? void 0
+        });
+        break;
+      }
+      case "footer": {
+        const footer = this.data.footer;
+        this.setFooter({
+          text: footer?.text ?? chars.invisible,
+          iconURL: url ?? void 0
+        });
+        break;
+      }
     }
     return this;
   }
@@ -78,8 +104,8 @@ class EmbedPlusBuilder extends EmbedBuilder {
   }
 }
 function createEmbed(options) {
-  const { array = false, interaction, ...data } = options;
-  const embed = interaction ? EmbedPlusBuilder.fromInteraction(interaction, 0, data) : new EmbedPlusBuilder(data);
+  const { array = false, from, fromIndex = 0, ...data } = options;
+  const embed = from ? "message" in from ? EmbedPlusBuilder.fromInteraction(from, fromIndex, data) : EmbedPlusBuilder.fromMessage(from, fromIndex, data) : new EmbedPlusBuilder(data);
   return array ? [embed] : embed;
 }
 

package/dist/functions/embeds/fields.cjs

@@ -9,10 +9,6 @@ var __publicField = (obj, key, value) => {
 class EmbedPlusFields {
   constructor(embed) {
     __publicField(this, "embed");
-    Object.defineProperty(this, "embed", {
-      enumerable: false,
-      value: embed
-    });
     this.embed = embed;
   }
   set fields(fields) {

package/dist/functions/embeds/fields.mjs

@@ -7,10 +7,6 @@ var __publicField = (obj, key, value) => {
 class EmbedPlusFields {
   constructor(embed) {
     __publicField(this, "embed");
-    Object.defineProperty(this, "embed", {
-      enumerable: false,
-      value: embed
-    });
     this.embed = embed;
   }
   set fields(fields) {

package/dist/functions/embeds/files.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+const discord_js = require('discord.js');
+
+function createEmbedFiles(embed, options) {
+  const { thumbnail, image, footer, author } = embed.data;
+  const files = [];
+  const handle = (url, name, ext = "png") => {
+    files.push(new discord_js.AttachmentBuilder(url, { name: `${name}.${ext}` }));
+    return `attachment://${name}.${ext}`;
+  };
+  if (thumbnail?.url) {
+    const url = handle(thumbnail.url, "thumbnail", options?.extentions?.thumbnail);
+    embed.setThumbnail(url);
+  }
+  if (image?.url) {
+    const url = handle(image.url, "image", options?.extentions?.image);
+    embed.setImage(url);
+  }
+  if (author?.icon_url) {
+    const url = handle(author?.icon_url, "author", options?.extentions?.author);
+    embed.setAuthor({ name: author.name, iconURL: url, url: author.url });
+  }
+  if (footer?.icon_url) {
+    const url = handle(footer.icon_url, "footer", options?.extentions?.footer);
+    embed.setFooter({ text: footer.text, iconURL: url });
+  }
+  return files;
+}
+
+exports.createEmbedFiles = createEmbedFiles;

package/dist/functions/embeds/files.mjs

@@ -0,0 +1,29 @@
+import { AttachmentBuilder } from 'discord.js';
+
+function createEmbedFiles(embed, options) {
+  const { thumbnail, image, footer, author } = embed.data;
+  const files = [];
+  const handle = (url, name, ext = "png") => {
+    files.push(new AttachmentBuilder(url, { name: `${name}.${ext}` }));
+    return `attachment://${name}.${ext}`;
+  };
+  if (thumbnail?.url) {
+    const url = handle(thumbnail.url, "thumbnail", options?.extentions?.thumbnail);
+    embed.setThumbnail(url);
+  }
+  if (image?.url) {
+    const url = handle(image.url, "image", options?.extentions?.image);
+    embed.setImage(url);
+  }
+  if (author?.icon_url) {
+    const url = handle(author?.icon_url, "author", options?.extentions?.author);
+    embed.setAuthor({ name: author.name, iconURL: url, url: author.url });
+  }
+  if (footer?.icon_url) {
+    const url = handle(footer.icon_url, "footer", options?.extentions?.footer);
+    embed.setFooter({ text: footer.text, iconURL: url });
+  }
+  return files;
+}
+
+export { createEmbedFiles };

package/dist/functions/misc.cjs

@@ -3,7 +3,9 @@
 const discord_js = require('discord.js');
 
 function setMobileStatus() {
-  discord_js.DefaultWebSocketManagerOptions.identifyProperties.browser = "Discord Android";
+  Object.assign(discord_js.DefaultWebSocketManagerOptions.identifyProperties, {
+    browser: "Discord Android"
+  });
 }
 
 exports.setMobileStatus = setMobileStatus;

package/dist/functions/misc.mjs

@@ -1,7 +1,9 @@
 import { DefaultWebSocketManagerOptions } from 'discord.js';
 
 function setMobileStatus() {
-  DefaultWebSocketManagerOptions.identifyProperties.browser = "Discord Android";
+  Object.assign(DefaultWebSocketManagerOptions.identifyProperties, {
+    browser: "Discord Android"
+  });
 }
 
 export { setMobileStatus };

package/dist/index.cjs

@@ -7,6 +7,7 @@ const assets = require('./functions/embeds/assets.cjs');
 const author = require('./functions/embeds/author.cjs');
 const embedplus = require('./functions/embeds/embedplus.cjs');
 const footer = require('./functions/embeds/footer.cjs');
+const files = require('./functions/embeds/files.cjs');
 const components = require('./functions/components.cjs');
 const channels = require('./functions/channels.cjs');
 const commands = require('./functions/commands.cjs');
@@ -29,10 +30,14 @@ exports.createEmbedAuthor = author.createEmbedAuthor;
 exports.EmbedPlusBuilder = embedplus.EmbedPlusBuilder;
 exports.createEmbed = embedplus.createEmbed;
 exports.createEmbedFooter = footer.createEmbedFooter;
+exports.createEmbedFiles = files.createEmbedFiles;
 exports.createLinkButton = components.createLinkButton;
 exports.createRow = components.createRow;
 exports.findChannel = channels.findChannel;
 exports.getChannelUrlInfo = channels.getChannelUrlInfo;
+exports.createCommandOptions = commands.createCommandOptions;
+exports.createSubCommands = commands.createSubCommands;
+exports.createSubCommandsGroups = commands.createSubCommandsGroups;
 exports.findCommand = commands.findCommand;
 exports.createModalFields = modals.createModalFields;
 exports.createModalInput = modals.createModalInput;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, ColorResolvable, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role } from 'discord.js';
+import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, ApplicationCommandOptionData, ApplicationCommandSubCommandData, ApplicationCommandSubGroupData, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -132,19 +132,33 @@ declare class EmbedPlusBuilder extends EmbedBuilder {
     has(property: keyof EmbedPlusData): boolean;
     toArray(): EmbedPlusBuilder[];
     toString(space?: number): string;
+    toAttachment(data?: AttachmentData, space?: number): AttachmentBuilder;
     setBorderColor(color: EmbedPlusColorData | null): this;
     setAsset(asset: "thumbnail" | "image", source: EmbedPlusAssetData): this;
+    setElementImageURL(element: "thumbnail" | "image" | "author" | "footer", url: string | null): this;
     static fromInteraction(interaction: InteractionWithEmbeds, index?: number, data?: EmbedPlusData): EmbedPlusBuilder;
     static fromMessage(message: MessageWithEmbeds, index?: number, data?: EmbedPlusData): EmbedPlusBuilder;
 }
 type EmbedPlusProperty<P extends keyof EmbedPlusData> = EmbedPlusData[P];
 interface CreateEmbedOptions<B extends boolean> extends EmbedPlusOptions {
     array?: B;
-    interaction?: InteractionWithEmbeds;
+    from?: InteractionWithEmbeds | MessageWithEmbeds;
+    fromIndex?: number;
 }
 type CreateEmbedReturn<B> = undefined extends B ? EmbedPlusBuilder : false extends B ? EmbedPlusBuilder : EmbedPlusBuilder[];
 declare function createEmbed<B extends boolean>(options: CreateEmbedOptions<B>): CreateEmbedReturn<B>;
 
+type ImageFileExtention = "png" | "jpg" | "gif" | "webp";
+type ImageElementProperty = "author" | "thumbnail" | "image" | "footer";
+interface CreateEmbedFilesOptions {
+    extentions?: Record<ImageElementProperty, ImageFileExtention>;
+}
+/**
+ *
+ * Turns any embed image url into an attachment and returns an attachment array
+ */
+declare function createEmbedFiles(embed: EmbedPlusBuilder, options?: CreateEmbedFilesOptions): AttachmentBuilder[];
+
 declare function createRow<Component extends AnyComponentBuilder>(...components: Component[]): ActionRowBuilder<Component>;
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
@@ -188,6 +202,35 @@ declare function findCommand(guildOrClient: Guild | Client<true>): {
         guild: discord_js.GuildResolvable;
     }> | undefined;
 };
+type OmitCommandDataProps = "name" | "options" | "autocomplete" | "type";
+type CommandOption = Exclude<Omit<ApplicationCommandOptionData, "name">, ApplicationCommandSubGroupData | ApplicationCommandSubCommandData>;
+type CommandOptions = Record<string, CommandOption>;
+/**
+ * Creates an array of command options, quickly define command options with a record where the key is the option name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createCommandOptions(options: CommandOptions): ApplicationCommandOptionData[];
+type SubCommand = Omit<ApplicationCommandSubCommandData, OmitCommandDataProps> & {
+    options?: Record<string, CommandOption>;
+};
+type SubCommands = Record<string, SubCommand>;
+/**
+ * Create an array of command options, quickly define subcommands with a record where the key is the subcommand name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createSubCommands(subcommands: SubCommands): ApplicationCommandSubCommandData[];
+type SubCommandGroup = Omit<ApplicationCommandSubGroupData, OmitCommandDataProps> & {
+    subcommands: SubCommands;
+};
+type SubCommandGroups = Record<string, SubCommandGroup>;
+/**
+ * Create an array of command options, quickly define groups of subcommands with a record where the key is the group name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createSubCommandsGroups(groups: SubCommandGroups): ApplicationCommandSubGroupData[];
 
 type TextInputData = Omit<TextInputComponentData, "type">;
 type CreateModalInputData = TextInputData;
@@ -267,4 +310,4 @@ declare function findRole(guild: Guild): {
  */
 declare function extractMentionId(mention: string): string | null;
 
-export { type AnyEmbedData, 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 };
+export { type AnyEmbedData, CustomItents, CustomPartials, type EmbedPlusAssetData, type EmbedPlusAuthorData, EmbedPlusBuilder, type EmbedPlusColorData, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createCommandOptions, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, createSubCommands, createSubCommandsGroups, 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, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, ColorResolvable, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role } from 'discord.js';
+import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, ApplicationCommandOptionData, ApplicationCommandSubCommandData, ApplicationCommandSubGroupData, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -132,19 +132,33 @@ declare class EmbedPlusBuilder extends EmbedBuilder {
     has(property: keyof EmbedPlusData): boolean;
     toArray(): EmbedPlusBuilder[];
     toString(space?: number): string;
+    toAttachment(data?: AttachmentData, space?: number): AttachmentBuilder;
     setBorderColor(color: EmbedPlusColorData | null): this;
     setAsset(asset: "thumbnail" | "image", source: EmbedPlusAssetData): this;
+    setElementImageURL(element: "thumbnail" | "image" | "author" | "footer", url: string | null): this;
     static fromInteraction(interaction: InteractionWithEmbeds, index?: number, data?: EmbedPlusData): EmbedPlusBuilder;
     static fromMessage(message: MessageWithEmbeds, index?: number, data?: EmbedPlusData): EmbedPlusBuilder;
 }
 type EmbedPlusProperty<P extends keyof EmbedPlusData> = EmbedPlusData[P];
 interface CreateEmbedOptions<B extends boolean> extends EmbedPlusOptions {
     array?: B;
-    interaction?: InteractionWithEmbeds;
+    from?: InteractionWithEmbeds | MessageWithEmbeds;
+    fromIndex?: number;
 }
 type CreateEmbedReturn<B> = undefined extends B ? EmbedPlusBuilder : false extends B ? EmbedPlusBuilder : EmbedPlusBuilder[];
 declare function createEmbed<B extends boolean>(options: CreateEmbedOptions<B>): CreateEmbedReturn<B>;
 
+type ImageFileExtention = "png" | "jpg" | "gif" | "webp";
+type ImageElementProperty = "author" | "thumbnail" | "image" | "footer";
+interface CreateEmbedFilesOptions {
+    extentions?: Record<ImageElementProperty, ImageFileExtention>;
+}
+/**
+ *
+ * Turns any embed image url into an attachment and returns an attachment array
+ */
+declare function createEmbedFiles(embed: EmbedPlusBuilder, options?: CreateEmbedFilesOptions): AttachmentBuilder[];
+
 declare function createRow<Component extends AnyComponentBuilder>(...components: Component[]): ActionRowBuilder<Component>;
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
@@ -188,6 +202,35 @@ declare function findCommand(guildOrClient: Guild | Client<true>): {
         guild: discord_js.GuildResolvable;
     }> | undefined;
 };
+type OmitCommandDataProps = "name" | "options" | "autocomplete" | "type";
+type CommandOption = Exclude<Omit<ApplicationCommandOptionData, "name">, ApplicationCommandSubGroupData | ApplicationCommandSubCommandData>;
+type CommandOptions = Record<string, CommandOption>;
+/**
+ * Creates an array of command options, quickly define command options with a record where the key is the option name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createCommandOptions(options: CommandOptions): ApplicationCommandOptionData[];
+type SubCommand = Omit<ApplicationCommandSubCommandData, OmitCommandDataProps> & {
+    options?: Record<string, CommandOption>;
+};
+type SubCommands = Record<string, SubCommand>;
+/**
+ * Create an array of command options, quickly define subcommands with a record where the key is the subcommand name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createSubCommands(subcommands: SubCommands): ApplicationCommandSubCommandData[];
+type SubCommandGroup = Omit<ApplicationCommandSubGroupData, OmitCommandDataProps> & {
+    subcommands: SubCommands;
+};
+type SubCommandGroups = Record<string, SubCommandGroup>;
+/**
+ * Create an array of command options, quickly define groups of subcommands with a record where the key is the group name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createSubCommandsGroups(groups: SubCommandGroups): ApplicationCommandSubGroupData[];
 
 type TextInputData = Omit<TextInputComponentData, "type">;
 type CreateModalInputData = TextInputData;
@@ -267,4 +310,4 @@ declare function findRole(guild: Guild): {
  */
 declare function extractMentionId(mention: string): string | null;
 
-export { type AnyEmbedData, 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 };
+export { type AnyEmbedData, CustomItents, CustomPartials, type EmbedPlusAssetData, type EmbedPlusAuthorData, EmbedPlusBuilder, type EmbedPlusColorData, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createCommandOptions, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, createSubCommands, createSubCommandsGroups, 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, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, ColorResolvable, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role } from 'discord.js';
+import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, AnyComponentBuilder, ActionRowBuilder, ButtonBuilder, LinkButtonComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, ApplicationCommandOptionData, ApplicationCommandSubCommandData, ApplicationCommandSubGroupData, TextInputBuilder, ModalSubmitFields, Collection, TextInputComponent, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -132,19 +132,33 @@ declare class EmbedPlusBuilder extends EmbedBuilder {
     has(property: keyof EmbedPlusData): boolean;
     toArray(): EmbedPlusBuilder[];
     toString(space?: number): string;
+    toAttachment(data?: AttachmentData, space?: number): AttachmentBuilder;
     setBorderColor(color: EmbedPlusColorData | null): this;
     setAsset(asset: "thumbnail" | "image", source: EmbedPlusAssetData): this;
+    setElementImageURL(element: "thumbnail" | "image" | "author" | "footer", url: string | null): this;
     static fromInteraction(interaction: InteractionWithEmbeds, index?: number, data?: EmbedPlusData): EmbedPlusBuilder;
     static fromMessage(message: MessageWithEmbeds, index?: number, data?: EmbedPlusData): EmbedPlusBuilder;
 }
 type EmbedPlusProperty<P extends keyof EmbedPlusData> = EmbedPlusData[P];
 interface CreateEmbedOptions<B extends boolean> extends EmbedPlusOptions {
     array?: B;
-    interaction?: InteractionWithEmbeds;
+    from?: InteractionWithEmbeds | MessageWithEmbeds;
+    fromIndex?: number;
 }
 type CreateEmbedReturn<B> = undefined extends B ? EmbedPlusBuilder : false extends B ? EmbedPlusBuilder : EmbedPlusBuilder[];
 declare function createEmbed<B extends boolean>(options: CreateEmbedOptions<B>): CreateEmbedReturn<B>;
 
+type ImageFileExtention = "png" | "jpg" | "gif" | "webp";
+type ImageElementProperty = "author" | "thumbnail" | "image" | "footer";
+interface CreateEmbedFilesOptions {
+    extentions?: Record<ImageElementProperty, ImageFileExtention>;
+}
+/**
+ *
+ * Turns any embed image url into an attachment and returns an attachment array
+ */
+declare function createEmbedFiles(embed: EmbedPlusBuilder, options?: CreateEmbedFilesOptions): AttachmentBuilder[];
+
 declare function createRow<Component extends AnyComponentBuilder>(...components: Component[]): ActionRowBuilder<Component>;
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
@@ -188,6 +202,35 @@ declare function findCommand(guildOrClient: Guild | Client<true>): {
         guild: discord_js.GuildResolvable;
     }> | undefined;
 };
+type OmitCommandDataProps = "name" | "options" | "autocomplete" | "type";
+type CommandOption = Exclude<Omit<ApplicationCommandOptionData, "name">, ApplicationCommandSubGroupData | ApplicationCommandSubCommandData>;
+type CommandOptions = Record<string, CommandOption>;
+/**
+ * Creates an array of command options, quickly define command options with a record where the key is the option name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createCommandOptions(options: CommandOptions): ApplicationCommandOptionData[];
+type SubCommand = Omit<ApplicationCommandSubCommandData, OmitCommandDataProps> & {
+    options?: Record<string, CommandOption>;
+};
+type SubCommands = Record<string, SubCommand>;
+/**
+ * Create an array of command options, quickly define subcommands with a record where the key is the subcommand name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createSubCommands(subcommands: SubCommands): ApplicationCommandSubCommandData[];
+type SubCommandGroup = Omit<ApplicationCommandSubGroupData, OmitCommandDataProps> & {
+    subcommands: SubCommands;
+};
+type SubCommandGroups = Record<string, SubCommandGroup>;
+/**
+ * Create an array of command options, quickly define groups of subcommands with a record where the key is the group name and the value is the definitions
+ * @param groups
+ * @returns
+ */
+declare function createSubCommandsGroups(groups: SubCommandGroups): ApplicationCommandSubGroupData[];
 
 type TextInputData = Omit<TextInputComponentData, "type">;
 type CreateModalInputData = TextInputData;
@@ -267,4 +310,4 @@ declare function findRole(guild: Guild): {
  */
 declare function extractMentionId(mention: string): string | null;
 
-export { type AnyEmbedData, 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 };
+export { type AnyEmbedData, CustomItents, CustomPartials, type EmbedPlusAssetData, type EmbedPlusAuthorData, EmbedPlusBuilder, type EmbedPlusColorData, type EmbedPlusData, type EmbedPlusFooterData, type EmbedPlusProperty, chars, createCommandOptions, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createLinkButton, createModalFields, createModalInput, createRow, createSubCommands, createSubCommandsGroups, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, modalFieldsToRecord, setMobileStatus };

package/dist/index.mjs

@@ -5,9 +5,10 @@ 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 { createEmbedFiles } from './functions/embeds/files.mjs';
 export { createLinkButton, createRow } from './functions/components.mjs';
 export { findChannel, getChannelUrlInfo } from './functions/channels.mjs';
-export { findCommand } from './functions/commands.mjs';
+export { createCommandOptions, createSubCommands, createSubCommandsGroups, findCommand } from './functions/commands.mjs';
 export { createModalFields, createModalInput, modalFieldsToRecord } from './functions/modals.mjs';
 export { findEmoji } from './functions/emojis.mjs';
 export { findMember } from './functions/members.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicyan/discord",
-  "version": "1.0.30",
+  "version": "1.0.32",
   "description": "Simple functions to facilitate discord bot development",
   "license": "MIT",
   "type": "module",
@@ -35,13 +35,13 @@
     "dev": "tsx --env-file .env playground/index.ts"
   },
   "devDependencies": {
-    "tsx": "^4.7.0",
+    "tsx": "^4.10.0",
     "unbuild": "^2.0.0"
   },
   "dependencies": {
-    "@magicyan/core": "^1.0.18"
+    "@magicyan/core": "^1.0.19"
   },
   "peerDependencies": {
-    "discord.js": "^14.14.1"
+    "discord.js": "^14.15.2"
   }
-}
+}