@discordjs/builders 2.0.0-dev.1748650424-ef2c1bfa7 → 2.0.0-dev.1748909649-d40ceedad

package/dist/index.mjs

@@ -433,9 +433,9 @@ var ChannelSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   }
   data;
   /**
-   * Creates a new select menu from API data.
+   * Creates a new channel select menu.
    *
-   * @param data - The API data to create this select menu with
+   * @param data - The API data to create this channel select menu with
    * @example
    * Creating a select menu from an API data object:
    * ```ts
@@ -531,9 +531,9 @@ var MentionableSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   }
   data;
   /**
-   * Creates a new select menu from API data.
+   * Creates a new mentionable select menu.
    *
-   * @param data - The API data to create this select menu with
+   * @param data - The API data to create this mentionable select menu with
    * @example
    * Creating a select menu from an API data object:
    * ```ts
@@ -630,9 +630,9 @@ var RoleSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   }
   data;
   /**
-   * Creates a new select menu from API data.
+   * Creates a new role select menu.
    *
-   * @param data - The API data to create this select menu with
+   * @param data - The API data to create this role select menu with
    * @example
    * Creating a select menu from an API data object:
    * ```ts
@@ -720,7 +720,7 @@ var StringSelectMenuOptionBuilder = class {
   }
   data;
   /**
-   * Creates a new string select menu option from API data.
+   * Creates a new string select menu option.
    *
    * @param data - The API data to create this string select menu option with
    * @example
@@ -826,9 +826,9 @@ var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
     return this.data.options;
   }
   /**
-   * Creates a new select menu from API data.
+   * Creates a new string select menu.
    *
-   * @param data - The API data to create this select menu with
+   * @param data - The API data to create this string select menu with
    * @example
    * Creating a select menu from an API data object:
    * ```ts
@@ -856,10 +856,11 @@ var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
    * 	});
    * ```
    */
-  constructor({ options = [], ...data } = {}) {
+  constructor(data = {}) {
     super();
+    const { options = [], ...rest } = data;
     this.data = {
-      ...structuredClone(data),
+      ...structuredClone(rest),
       options: options.map((option) => new StringSelectMenuOptionBuilder(option)),
       type: ComponentType8.StringSelect
     };
@@ -942,9 +943,9 @@ var UserSelectMenuBuilder = class extends BaseSelectMenuBuilder {
   }
   data;
   /**
-   * Creates a new select menu from API data.
+   * Creates a new user select menu.
    *
-   * @param data - The API data to create this select menu with
+   * @param data - The API data to create this user select menu with
    * @example
    * Creating a select menu from an API data object:
    * ```ts
@@ -1029,9 +1030,12 @@ var TextInputBuilder = class extends ComponentBuilder {
   static {
     __name(this, "TextInputBuilder");
   }
+  /**
+   * @internal
+   */
   data;
   /**
-   * Creates a new text input from API data.
+   * Creates a new text input.
    *
    * @param data - The API data to create this text input with
    * @example
@@ -1241,9 +1245,12 @@ var FileBuilder = class extends ComponentBuilder {
   static {
     __name(this, "FileBuilder");
   }
+  /**
+   * @internal
+   */
   data;
   /**
-   * Creates a new file from API data.
+   * Creates a new file.
    *
    * @param data - The API data to create this file with
    * @example
@@ -1269,9 +1276,10 @@ var FileBuilder = class extends ComponentBuilder {
    */
   constructor(data = {}) {
     super();
+    const { file, ...rest } = data;
     this.data = {
-      ...structuredClone(data),
-      file: data.file ? { url: data.file.url } : void 0,
+      ...structuredClone(rest),
+      file: file && { url: file.url },
       type: ComponentType13.File
     };
   }
@@ -1313,7 +1321,7 @@ var MediaGalleryItemBuilder = class {
   }
   data;
   /**
-   * Creates a new media gallery item from API data.
+   * Creates a new media gallery item.
    *
    * @param data - The API data to create this media gallery item with
    * @example
@@ -1338,9 +1346,7 @@ var MediaGalleryItemBuilder = class {
    * ```
    */
   constructor(data = {}) {
-    this.data = {
-      ...structuredClone(data)
-    };
+    this.data = structuredClone(data);
   }
   /**
    * Sets the source URL of this media gallery item.
@@ -1391,9 +1397,18 @@ var MediaGalleryBuilder = class extends ComponentBuilder {
   static {
     __name(this, "MediaGalleryBuilder");
   }
+  /**
+   * @internal
+   */
   data;
   /**
-   * Creates a new media gallery from API data.
+   * The items in this media gallery.
+   */
+  get items() {
+    return this.data.items;
+  }
+  /**
+   * Creates a new media gallery.
    *
    * @param data - The API data to create this container with
    * @example
@@ -1428,17 +1443,13 @@ var MediaGalleryBuilder = class extends ComponentBuilder {
    */
   constructor(data = {}) {
     super();
+    const { items = [], ...rest } = data;
     this.data = {
-      items: data?.items?.map((item) => new MediaGalleryItemBuilder(item)) ?? [],
+      ...structuredClone(rest),
+      items: items.map((item) => new MediaGalleryItemBuilder(item)),
       type: ComponentType14.MediaGallery
     };
   }
-  /**
-   * The items in this media gallery.
-   */
-  get items() {
-    return this.data.items;
-  }
   /**
    * Adds a media gallery item to this media gallery.
    *
@@ -1486,9 +1497,12 @@ var TextDisplayBuilder = class extends ComponentBuilder {
   static {
     __name(this, "TextDisplayBuilder");
   }
+  /**
+   * @internal
+   */
   data;
   /**
-   * Creates a new text display from API data.
+   * Creates a new text display.
    *
    * @param data - The API data to create this text display with
    * @example
@@ -1539,9 +1553,12 @@ var ThumbnailBuilder = class extends ComponentBuilder {
   static {
     __name(this, "ThumbnailBuilder");
   }
+  /**
+   * @internal
+   */
   data;
   /**
-   * Creates a new thumbnail from API data.
+   * Creates a new thumbnail.
    *
    * @param data - The API data to create this thumbnail with
    * @example
@@ -1567,9 +1584,10 @@ var ThumbnailBuilder = class extends ComponentBuilder {
    */
   constructor(data = {}) {
     super();
+    const { media, ...rest } = data;
     this.data = {
-      ...structuredClone(data),
-      media: data.media ? { url: data.media.url } : void 0,
+      ...structuredClone(rest),
+      media: media && { url: media.url },
       type: ComponentType16.Thumbnail
     };
   }
@@ -1622,12 +1640,18 @@ var SectionBuilder = class extends ComponentBuilder {
   static {
     __name(this, "SectionBuilder");
   }
+  /**
+   * @internal
+   */
   data;
+  /**
+   * The components within this section.
+   */
   get components() {
     return this.data.components;
   }
   /**
-   * Creates a new section from API data.
+   * Creates a new section.
    *
    * @param data - The API data to create this section with
    * @example
@@ -1666,7 +1690,7 @@ var SectionBuilder = class extends ComponentBuilder {
     const { components = [], accessory, ...rest } = data;
     this.data = {
       ...structuredClone(rest),
-      accessory: accessory ? resolveAccessoryComponent(accessory) : void 0,
+      accessory: accessory && resolveAccessoryComponent(accessory),
       components: components.map((component) => new TextDisplayBuilder(component)),
       type: ComponentType17.Section
     };
@@ -1786,9 +1810,12 @@ var SeparatorBuilder = class extends ComponentBuilder {
   static {
     __name(this, "SeparatorBuilder");
   }
+  /**
+   * @internal
+   */
   data;
   /**
-   * Creates a new separator from API data.
+   * Creates a new separator.
    *
    * @param data - The API data to create this separator with
    * @example
@@ -1855,9 +1882,24 @@ var ContainerBuilder = class extends ComponentBuilder {
   static {
     __name(this, "ContainerBuilder");
   }
+  /**
+   * @internal
+   */
   data;
-  constructor({ components = [], ...rest } = {}) {
+  /**
+   * Gets the components within this container.
+   */
+  get components() {
+    return this.data.components;
+  }
+  /**
+   * Creates a new container builder.
+   *
+   * @param data - The API data to create the container with
+   */
+  constructor(data = {}) {
     super();
+    const { components = [], ...rest } = data;
     this.data = {
       ...structuredClone(rest),
       components: components.map((component) => createComponentBuilder(component)),
@@ -2082,6 +2124,9 @@ var ActionRowBuilder = class extends ComponentBuilder {
   static {
     __name(this, "ActionRowBuilder");
   }
+  /**
+   * @internal
+   */
   data;
   /**
    * The components within this action row.
@@ -2090,7 +2135,7 @@ var ActionRowBuilder = class extends ComponentBuilder {
     return this.data.components;
   }
   /**
-   * Creates a new action row from API data.
+   * Creates a new action row.
    *
    * @param data - The API data to create this action row with
    * @example
@@ -2123,12 +2168,13 @@ var ActionRowBuilder = class extends ComponentBuilder {
    * 	.addComponents(button2, button3);
    * ```
    */
-  constructor({ components = [], ...data } = {}) {
+  constructor(data = {}) {
     super();
+    const { components = [], ...rest } = data;
     this.data = {
-      ...structuredClone(data),
-      type: ComponentType21.ActionRow,
-      components: components.map((component) => createComponentBuilder(component))
+      ...structuredClone(rest),
+      components: components.map((component) => createComponentBuilder(component)),
+      type: ComponentType21.ActionRow
     };
   }
   /**
@@ -2432,6 +2478,9 @@ var SharedName = class {
   static {
     __name(this, "SharedName");
   }
+  /**
+   * @internal
+   */
   data = {};
   /**
    * Sets the name of this command.
@@ -2486,6 +2535,9 @@ var SharedNameAndDescription = class extends SharedName {
   static {
     __name(this, "SharedNameAndDescription");
   }
+  /**
+   * @internal
+   */
   data = {};
   /**
    * Sets the description of this command.
@@ -2649,7 +2701,15 @@ var ApplicationCommandOptionBase = class extends SharedNameAndDescription {
   static {
     __name(this, "ApplicationCommandOptionBase");
   }
+  /**
+   * @internal
+   */
   static predicate = basicOptionPredicate;
+  /**
+   * Creates a new application command option builder.
+   *
+   * @param type - The type of the option
+   */
   constructor(type) {
     super();
     this.data.type = type;
@@ -2682,6 +2742,9 @@ var ChatInputCommandAttachmentOption = class extends ApplicationCommandOptionBas
   static {
     __name(this, "ChatInputCommandAttachmentOption");
   }
+  /**
+   * Creates a new attachment option.
+   */
   constructor() {
     super(ApplicationCommandOptionType2.Attachment);
   }
@@ -2693,6 +2756,9 @@ var ChatInputCommandBooleanOption = class extends ApplicationCommandOptionBase {
   static {
     __name(this, "ChatInputCommandBooleanOption");
   }
+  /**
+   * Creates a new boolean option.
+   */
   constructor() {
     super(ApplicationCommandOptionType3.Boolean);
   }
@@ -2708,7 +2774,13 @@ var ChatInputCommandChannelOption = class extends Mixin3(
   static {
     __name(this, "ChatInputCommandChannelOption");
   }
+  /**
+   * @internal
+   */
   static predicate = channelOptionPredicate;
+  /**
+   * Creates a new channel option.
+   */
   constructor() {
     super(ApplicationCommandOptionType4.Channel);
   }
@@ -2726,7 +2798,13 @@ var ChatInputCommandIntegerOption = class extends Mixin4(
   static {
     __name(this, "ChatInputCommandIntegerOption");
   }
+  /**
+   * @internal
+   */
   static predicate = integerOptionPredicate;
+  /**
+   * Creates a new integer option.
+   */
   constructor() {
     super(ApplicationCommandOptionType5.Integer);
   }
@@ -2738,6 +2816,9 @@ var ChatInputCommandMentionableOption = class extends ApplicationCommandOptionBa
   static {
     __name(this, "ChatInputCommandMentionableOption");
   }
+  /**
+   * Creates a new mentionable option.
+   */
   constructor() {
     super(ApplicationCommandOptionType6.Mentionable);
   }
@@ -2755,7 +2836,13 @@ var ChatInputCommandNumberOption = class extends Mixin5(
   static {
     __name(this, "ChatInputCommandNumberOption");
   }
+  /**
+   * @internal
+   */
   static predicate = numberOptionPredicate;
+  /**
+   * Creates a new number option.
+   */
   constructor() {
     super(ApplicationCommandOptionType7.Number);
   }
@@ -2767,6 +2854,9 @@ var ChatInputCommandRoleOption = class extends ApplicationCommandOptionBase {
   static {
     __name(this, "ChatInputCommandRoleOption");
   }
+  /**
+   * Creates a new role option.
+   */
   constructor() {
     super(ApplicationCommandOptionType8.Role);
   }
@@ -2783,7 +2873,13 @@ var ChatInputCommandStringOption = class extends Mixin6(
   static {
     __name(this, "ChatInputCommandStringOption");
   }
+  /**
+   * @internal
+   */
   static predicate = stringOptionPredicate;
+  /**
+   * Creates a new string option builder.
+   */
   constructor() {
     super(ApplicationCommandOptionType9.String);
   }
@@ -2827,6 +2923,9 @@ var ChatInputCommandUserOption = class extends ApplicationCommandOptionBase {
   static {
     __name(this, "ChatInputCommandUserOption");
   }
+  /**
+   * Creates a new user option.
+   */
   constructor() {
     super(ApplicationCommandOptionType10.User);
   }
@@ -2837,6 +2936,9 @@ var SharedChatInputCommandOptions = class {
   static {
     __name(this, "SharedChatInputCommandOptions");
   }
+  /**
+   * The options within this command.
+   */
   get options() {
     return this.data.options ??= [];
   }
@@ -2966,6 +3068,9 @@ var ChatInputCommandSubcommandGroupBuilder = class extends SharedNameAndDescript
   static {
     __name(this, "ChatInputCommandSubcommandGroupBuilder");
   }
+  /**
+   * The options within this subcommand group.
+   */
   get options() {
     return this.data.options ??= [];
   }
@@ -3165,7 +3270,17 @@ var ContextMenuCommandBuilder = class extends Mixin9(
   static {
     __name(this, "ContextMenuCommandBuilder");
   }
+  /**
+   * The API data associated with this context menu command.
+   *
+   * @internal
+   */
   data;
+  /**
+   * Creates a new context menu command.
+   *
+   * @param data - The API data to create this context menu command with
+   */
   constructor(data = {}) {
     super();
     this.data = structuredClone(data);
@@ -3233,13 +3348,14 @@ var ModalBuilder = class {
     return this.data.components;
   }
   /**
-   * Creates a new modal from API data.
+   * Creates a new modal.
    *
    * @param data - The API data to create this modal with
    */
-  constructor({ components = [], ...data } = {}) {
+  constructor(data = {}) {
+    const { components = [], ...rest } = data;
     this.data = {
-      ...structuredClone(data),
+      ...structuredClone(rest),
       components: components.map((component) => createComponentBuilder(component))
     };
   }
@@ -3386,14 +3502,17 @@ var EmbedAuthorBuilder = class {
   static {
     __name(this, "EmbedAuthorBuilder");
   }
+  /**
+   * The API data associated with this embed author.
+   */
   data;
   /**
-   * Creates a new embed author from API data.
+   * Creates a new embed author.
    *
-   * @param data - The API data to use
+   * @param data - The API data to create this embed author with
    */
-  constructor(data) {
-    this.data = structuredClone(data) ?? {};
+  constructor(data = {}) {
+    this.data = structuredClone(data);
   }
   /**
    * Sets the name for this embed author.
@@ -3455,14 +3574,17 @@ var EmbedFieldBuilder = class {
   static {
     __name(this, "EmbedFieldBuilder");
   }
+  /**
+   * The API data associated with this embed field.
+   */
   data;
   /**
-   * Creates a new embed field from API data.
+   * Creates a new embed field.
    *
-   * @param data - The API data to use
+   * @param data - The API data to create this embed field with
    */
-  constructor(data) {
-    this.data = structuredClone(data) ?? {};
+  constructor(data = {}) {
+    this.data = structuredClone(data);
   }
   /**
    * Sets the name for this embed field.
@@ -3510,14 +3632,17 @@ var EmbedFooterBuilder = class {
   static {
     __name(this, "EmbedFooterBuilder");
   }
+  /**
+   * The API data associated with this embed footer.
+   */
   data;
   /**
-   * Creates a new embed footer from API data.
+   * Creates a new embed footer.
    *
-   * @param data - The API data to use
+   * @param data - The API data to create this embed footer with
    */
-  constructor(data) {
-    this.data = structuredClone(data) ?? {};
+  constructor(data = {}) {
+    this.data = structuredClone(data);
   }
   /**
    * Sets the text for this embed footer.
@@ -3574,16 +3699,17 @@ var EmbedBuilder = class {
     return this.data.fields;
   }
   /**
-   * Creates a new embed from API data.
+   * Creates a new embed.
    *
    * @param data - The API data to create this embed with
    */
   constructor(data = {}) {
+    const { author, fields = [], footer, ...rest } = data;
     this.data = {
-      ...structuredClone(data),
-      author: data.author && new EmbedAuthorBuilder(data.author),
-      fields: data.fields?.map((field) => new EmbedFieldBuilder(field)) ?? [],
-      footer: data.footer && new EmbedFooterBuilder(data.footer)
+      ...structuredClone(rest),
+      author: author && new EmbedAuthorBuilder(author),
+      fields: fields.map((field) => new EmbedFieldBuilder(field)),
+      footer: footer && new EmbedFooterBuilder(footer)
     };
   }
   /**
@@ -3838,9 +3964,9 @@ var EmbedBuilder = class {
     const data = {
       ...structuredClone(rest),
       // Disable validation because the embedPredicate below will validate those as well
-      author: this.data.author?.toJSON(false),
-      fields: this.data.fields?.map((field) => field.toJSON(false)),
-      footer: this.data.footer?.toJSON(false)
+      author: author?.toJSON(false),
+      fields: fields.map((field) => field.toJSON(false)),
+      footer: footer?.toJSON(false)
     };
     validate(embedPredicate, data, validationOverride);
     return data;
@@ -3871,12 +3997,14 @@ var PollMediaBuilder = class {
   }
   /**
    * The API data associated with this poll media.
+   *
+   * @internal
    */
   data;
   /**
-   * Creates new poll media from API data.
+   * Creates new poll media.
    *
-   * @param data - The API data to use
+   * @param data - The API data to create this poll media with
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
@@ -3933,14 +4061,15 @@ var PollAnswerBuilder = class {
    */
   data;
   /**
-   * Creates a new poll answer from API data.
+   * Creates a new poll answer.
    *
    * @param data - The API data to create this poll answer with
    */
   constructor(data = {}) {
+    const { poll_media, ...rest } = data;
     this.data = {
-      ...structuredClone(data),
-      poll_media: new PollAnswerMediaBuilder(data.poll_media)
+      ...structuredClone(rest),
+      poll_media: new PollAnswerMediaBuilder(poll_media)
     };
   }
   /**
@@ -4011,15 +4140,16 @@ var PollBuilder = class {
     return this.data.answers;
   }
   /**
-   * Creates a new poll from API data.
+   * Creates a new poll.
    *
    * @param data - The API data to create this poll with
    */
   constructor(data = {}) {
+    const { question, answers = [], ...rest } = data;
     this.data = {
-      ...structuredClone(data),
-      question: new PollQuestionBuilder(data.question),
-      answers: data.answers?.map((answer) => new PollAnswerBuilder(answer)) ?? []
+      ...structuredClone(rest),
+      question: new PollQuestionBuilder(question),
+      answers: answers.map((answer) => new PollAnswerBuilder(answer))
     };
   }
   /**
@@ -4282,11 +4412,14 @@ var AllowedMentionsBuilder = class {
   static {
     __name(this, "AllowedMentionsBuilder");
   }
+  /**
+   * The API data associated with these allowed mentions.
+   */
   data;
   /**
-   * Creates a new allowed mentions builder from API data.
+   * Creates a new allowed mentions builder.
    *
-   * @param data - The API data to create this allowed mentions builder with
+   * @param data - The API data to create this allowed mentions with
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
@@ -4453,11 +4586,14 @@ var AttachmentBuilder = class {
   static {
     __name(this, "AttachmentBuilder");
   }
+  /**
+   * The API data associated with this attachment.
+   */
   data;
   /**
-   * Creates a new attachment builder from API data.
+   * Creates a new attachment builder.
    *
-   * @param data - The API data to create this attachment builder with
+   * @param data - The API data to create this attachment with
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
@@ -4570,11 +4706,14 @@ var MessageReferenceBuilder = class {
   static {
     __name(this, "MessageReferenceBuilder");
   }
+  /**
+   * The API data associated with this message reference.
+   */
   data;
   /**
-   * Creates a new message reference builder from API data.
+   * Creates a new message reference builder.
    *
-   * @param data - The API data to create this message reference builder with
+   * @param data - The API data to create this message reference with
    */
   constructor(data = {}) {
     this.data = structuredClone(data);
@@ -4687,21 +4826,14 @@ var MessageBuilder = class {
     return this.data.embeds;
   }
   /**
-   * Creates a new message builder from API data.
+   * Creates a new message builder.
    *
-   * @param data - The API data to create this message builder with
+   * @param data - The API data to create this message with
    */
-  constructor({
-    attachments = [],
-    embeds = [],
-    components = [],
-    message_reference,
-    poll,
-    allowed_mentions,
-    ...data
-  } = {}) {
+  constructor(data = {}) {
+    const { attachments = [], embeds = [], components = [], message_reference, poll, allowed_mentions, ...rest } = data;
     this.data = {
-      ...structuredClone(data),
+      ...structuredClone(rest),
       allowed_mentions: allowed_mentions && new AllowedMentionsBuilder(allowed_mentions),
       attachments: attachments.map((attachment) => new AttachmentBuilder(attachment)),
       embeds: embeds.map((embed) => new EmbedBuilder(embed)),
@@ -5163,7 +5295,7 @@ var MessageBuilder = class {
 };
 
 // src/index.ts
-var version = "2.0.0-dev.1748650424-ef2c1bfa7";
+var version = "2.0.0-dev.1748909649-d40ceedad";
 export {
   ActionRowBuilder,
   AllowedMentionsBuilder,