@discordjs/builders 2.0.0-dev.1748606728-762bbc652 → 2.0.0-dev.1748909649-d40ceedad

package/dist/index.js

@@ -571,9 +571,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
@@ -666,9 +666,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
@@ -762,9 +762,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
@@ -852,7 +852,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
@@ -958,9 +958,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
@@ -988,10 +988,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: import_v109.ComponentType.StringSelect
     };
@@ -1071,9 +1072,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
@@ -1158,9 +1159,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
@@ -1370,9 +1374,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
@@ -1398,9 +1405,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: import_v1014.ComponentType.File
     };
   }
@@ -1442,7 +1450,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
@@ -1467,9 +1475,7 @@ var MediaGalleryItemBuilder = class {
    * ```
    */
   constructor(data = {}) {
-    this.data = {
-      ...structuredClone(data)
-    };
+    this.data = structuredClone(data);
   }
   /**
    * Sets the source URL of this media gallery item.
@@ -1520,9 +1526,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
@@ -1557,17 +1572,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: import_v1015.ComponentType.MediaGallery
     };
   }
-  /**
-   * The items in this media gallery.
-   */
-  get items() {
-    return this.data.items;
-  }
   /**
    * Adds a media gallery item to this media gallery.
    *
@@ -1615,9 +1626,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
@@ -1668,9 +1682,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
@@ -1696,9 +1713,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: import_v1017.ComponentType.Thumbnail
     };
   }
@@ -1751,12 +1769,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
@@ -1795,7 +1819,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: import_v1018.ComponentType.Section
     };
@@ -1915,9 +1939,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
@@ -1984,9 +2011,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)),
@@ -2211,6 +2253,9 @@ var ActionRowBuilder = class extends ComponentBuilder {
   static {
     __name(this, "ActionRowBuilder");
   }
+  /**
+   * @internal
+   */
   data;
   /**
    * The components within this action row.
@@ -2219,7 +2264,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
@@ -2252,12 +2297,13 @@ var ActionRowBuilder = class extends ComponentBuilder {
    * 	.addComponents(button2, button3);
    * ```
    */
-  constructor({ components = [], ...data } = {}) {
+  constructor(data = {}) {
     super();
+    const { components = [], ...rest } = data;
     this.data = {
-      ...structuredClone(data),
-      type: import_v1022.ComponentType.ActionRow,
-      components: components.map((component) => createComponentBuilder(component))
+      ...structuredClone(rest),
+      components: components.map((component) => createComponentBuilder(component)),
+      type: import_v1022.ComponentType.ActionRow
     };
   }
   /**
@@ -2561,6 +2607,9 @@ var SharedName = class {
   static {
     __name(this, "SharedName");
   }
+  /**
+   * @internal
+   */
   data = {};
   /**
    * Sets the name of this command.
@@ -2615,6 +2664,9 @@ var SharedNameAndDescription = class extends SharedName {
   static {
     __name(this, "SharedNameAndDescription");
   }
+  /**
+   * @internal
+   */
   data = {};
   /**
    * Sets the description of this command.
@@ -2774,7 +2826,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;
@@ -2807,6 +2867,9 @@ var ChatInputCommandAttachmentOption = class extends ApplicationCommandOptionBas
   static {
     __name(this, "ChatInputCommandAttachmentOption");
   }
+  /**
+   * Creates a new attachment option.
+   */
   constructor() {
     super(import_v1025.ApplicationCommandOptionType.Attachment);
   }
@@ -2818,6 +2881,9 @@ var ChatInputCommandBooleanOption = class extends ApplicationCommandOptionBase {
   static {
     __name(this, "ChatInputCommandBooleanOption");
   }
+  /**
+   * Creates a new boolean option.
+   */
   constructor() {
     super(import_v1026.ApplicationCommandOptionType.Boolean);
   }
@@ -2833,7 +2899,13 @@ var ChatInputCommandChannelOption = class extends (0, import_ts_mixer3.Mixin)(
   static {
     __name(this, "ChatInputCommandChannelOption");
   }
+  /**
+   * @internal
+   */
   static predicate = channelOptionPredicate;
+  /**
+   * Creates a new channel option.
+   */
   constructor() {
     super(import_v1027.ApplicationCommandOptionType.Channel);
   }
@@ -2851,7 +2923,13 @@ var ChatInputCommandIntegerOption = class extends (0, import_ts_mixer4.Mixin)(
   static {
     __name(this, "ChatInputCommandIntegerOption");
   }
+  /**
+   * @internal
+   */
   static predicate = integerOptionPredicate;
+  /**
+   * Creates a new integer option.
+   */
   constructor() {
     super(import_v1028.ApplicationCommandOptionType.Integer);
   }
@@ -2863,6 +2941,9 @@ var ChatInputCommandMentionableOption = class extends ApplicationCommandOptionBa
   static {
     __name(this, "ChatInputCommandMentionableOption");
   }
+  /**
+   * Creates a new mentionable option.
+   */
   constructor() {
     super(import_v1029.ApplicationCommandOptionType.Mentionable);
   }
@@ -2880,7 +2961,13 @@ var ChatInputCommandNumberOption = class extends (0, import_ts_mixer5.Mixin)(
   static {
     __name(this, "ChatInputCommandNumberOption");
   }
+  /**
+   * @internal
+   */
   static predicate = numberOptionPredicate;
+  /**
+   * Creates a new number option.
+   */
   constructor() {
     super(import_v1030.ApplicationCommandOptionType.Number);
   }
@@ -2892,6 +2979,9 @@ var ChatInputCommandRoleOption = class extends ApplicationCommandOptionBase {
   static {
     __name(this, "ChatInputCommandRoleOption");
   }
+  /**
+   * Creates a new role option.
+   */
   constructor() {
     super(import_v1031.ApplicationCommandOptionType.Role);
   }
@@ -2908,7 +2998,13 @@ var ChatInputCommandStringOption = class extends (0, import_ts_mixer6.Mixin)(
   static {
     __name(this, "ChatInputCommandStringOption");
   }
+  /**
+   * @internal
+   */
   static predicate = stringOptionPredicate;
+  /**
+   * Creates a new string option builder.
+   */
   constructor() {
     super(import_v1032.ApplicationCommandOptionType.String);
   }
@@ -2952,6 +3048,9 @@ var ChatInputCommandUserOption = class extends ApplicationCommandOptionBase {
   static {
     __name(this, "ChatInputCommandUserOption");
   }
+  /**
+   * Creates a new user option.
+   */
   constructor() {
     super(import_v1033.ApplicationCommandOptionType.User);
   }
@@ -2962,6 +3061,9 @@ var SharedChatInputCommandOptions = class {
   static {
     __name(this, "SharedChatInputCommandOptions");
   }
+  /**
+   * The options within this command.
+   */
   get options() {
     return this.data.options ??= [];
   }
@@ -3091,6 +3193,9 @@ var ChatInputCommandSubcommandGroupBuilder = class extends SharedNameAndDescript
   static {
     __name(this, "ChatInputCommandSubcommandGroupBuilder");
   }
+  /**
+   * The options within this subcommand group.
+   */
   get options() {
     return this.data.options ??= [];
   }
@@ -3290,7 +3395,17 @@ var ContextMenuCommandBuilder = class extends (0, import_ts_mixer9.Mixin)(
   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);
@@ -3358,13 +3473,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))
     };
   }
@@ -3511,14 +3627,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.
@@ -3580,14 +3699,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.
@@ -3635,14 +3757,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.
@@ -3699,16 +3824,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)
     };
   }
   /**
@@ -3963,9 +4089,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;
@@ -3996,12 +4122,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);
@@ -4058,14 +4186,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)
     };
   }
   /**
@@ -4136,15 +4265,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))
     };
   }
   /**
@@ -4407,11 +4537,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);
@@ -4578,11 +4711,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);
@@ -4695,11 +4831,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);
@@ -4812,21 +4951,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)),
@@ -5288,7 +5420,7 @@ var MessageBuilder = class {
 };
 
 // src/index.ts
-var version = "2.0.0-dev.1748606728-762bbc652";
+var version = "2.0.0-dev.1748909649-d40ceedad";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,