@discordjs/builders 2.0.0-dev.1741219959-e273afbb9 → 2.0.0-dev.1741953893-09beb8a6a

package/dist/index.js

@@ -22,12 +22,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   ActionRowBuilder: () => ActionRowBuilder,
+  AllowedMentionsBuilder: () => AllowedMentionsBuilder,
   ApplicationCommandNumericOptionMinMaxValueMixin: () => ApplicationCommandNumericOptionMinMaxValueMixin,
   ApplicationCommandOptionAllowedChannelTypes: () => ApplicationCommandOptionAllowedChannelTypes,
   ApplicationCommandOptionBase: () => ApplicationCommandOptionBase,
   ApplicationCommandOptionChannelTypesMixin: () => ApplicationCommandOptionChannelTypesMixin,
   ApplicationCommandOptionWithAutocompleteMixin: () => ApplicationCommandOptionWithAutocompleteMixin,
   ApplicationCommandOptionWithChoicesMixin: () => ApplicationCommandOptionWithChoicesMixin,
+  AttachmentBuilder: () => AttachmentBuilder,
   BaseButtonBuilder: () => BaseButtonBuilder,
   BaseSelectMenuBuilder: () => BaseSelectMenuBuilder,
   ChannelSelectMenuBuilder: () => ChannelSelectMenuBuilder,
@@ -55,7 +57,9 @@ __export(index_exports, {
   EmojiOrLabelButtonMixin: () => EmojiOrLabelButtonMixin,
   LinkButtonBuilder: () => LinkButtonBuilder,
   MentionableSelectMenuBuilder: () => MentionableSelectMenuBuilder,
+  MessageBuilder: () => MessageBuilder,
   MessageContextCommandBuilder: () => MessageContextCommandBuilder,
+  MessageReferenceBuilder: () => MessageReferenceBuilder,
   ModalBuilder: () => ModalBuilder,
   PollAnswerBuilder: () => PollAnswerBuilder,
   PollAnswerMediaBuilder: () => PollAnswerMediaBuilder,
@@ -77,6 +81,8 @@ __export(index_exports, {
   UserContextCommandBuilder: () => UserContextCommandBuilder,
   UserSelectMenuBuilder: () => UserSelectMenuBuilder,
   actionRowPredicate: () => actionRowPredicate,
+  allowedMentionPredicate: () => allowedMentionPredicate,
+  attachmentPredicate: () => attachmentPredicate,
   basicOptionPredicate: () => basicOptionPredicate,
   buttonPredicate: () => buttonPredicate,
   channelOptionPredicate: () => channelOptionPredicate,
@@ -98,6 +104,8 @@ __export(index_exports, {
   localeMapPredicate: () => localeMapPredicate,
   memberPermissionsPredicate: () => memberPermissionsPredicate,
   messageCommandPredicate: () => messageCommandPredicate,
+  messagePredicate: () => messagePredicate,
+  messageReferencePredicate: () => messageReferencePredicate,
   modalPredicate: () => modalPredicate,
   normalizeArray: () => normalizeArray,
   numberOptionPredicate: () => numberOptionPredicate,
@@ -980,7 +988,7 @@ var StringSelectMenuBuilder = class extends BaseSelectMenuBuilder {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/slice | Array.prototype.splice()}.
    * It's useful for modifying and adjusting the order of existing options.
    * @example
    * Remove the first option:
@@ -1492,7 +1500,7 @@ var ActionRowBuilder = class extends ComponentBuilder {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    *
    * It's useful for modifying and adjusting order of the already-existing components of an action row.
    * @example
@@ -2143,7 +2151,7 @@ var SharedChatInputCommandOptions = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    *
    * It's useful for modifying and adjusting order of the already-existing options for this command.
    * @example
@@ -2513,7 +2521,7 @@ var ModalBuilder = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    * The maximum amount of action rows that can be added is 5.
    *
    * It's useful for modifying and adjusting order of the already-existing action rows of a modal.
@@ -2571,10 +2579,10 @@ __name(embedLength, "embedLength");
 
 // src/messages/embed/Assertions.ts
 var namePredicate3 = import_zod7.z.string().max(256);
-var iconURLPredicate = import_zod7.z.string().url().refine(refineURLPredicate(["http:", "https:", "attachment:"]), {
-  message: "Invalid protocol for icon URL. Must be http:, https:, or attachment:"
-});
 var URLPredicate = import_zod7.z.string().url().refine(refineURLPredicate(["http:", "https:"]), { message: "Invalid protocol for URL. Must be http: or https:" });
+var URLWithAttachmentProtocolPredicate = import_zod7.z.string().url().refine(refineURLPredicate(["http:", "https:", "attachment:"]), {
+  message: "Invalid protocol for URL. Must be http:, https:, or attachment:"
+});
 var embedFieldPredicate = import_zod7.z.object({
   name: namePredicate3,
   value: import_zod7.z.string().max(1024),
@@ -2582,12 +2590,12 @@ var embedFieldPredicate = import_zod7.z.object({
 });
 var embedAuthorPredicate = import_zod7.z.object({
   name: namePredicate3.min(1),
-  icon_url: iconURLPredicate.optional(),
+  icon_url: URLWithAttachmentProtocolPredicate.optional(),
   url: URLPredicate.optional()
 });
 var embedFooterPredicate = import_zod7.z.object({
   text: import_zod7.z.string().min(1).max(2048),
-  icon_url: iconURLPredicate.optional()
+  icon_url: URLWithAttachmentProtocolPredicate.optional()
 });
 var embedPredicate = import_zod7.z.object({
   title: namePredicate3.min(1).optional(),
@@ -2596,8 +2604,8 @@ var embedPredicate = import_zod7.z.object({
   timestamp: import_zod7.z.string().optional(),
   color: import_zod7.z.number().int().min(0).max(16777215).optional(),
   footer: embedFooterPredicate.optional(),
-  image: import_zod7.z.object({ url: URLPredicate }).optional(),
-  thumbnail: import_zod7.z.object({ url: URLPredicate }).optional(),
+  image: import_zod7.z.object({ url: URLWithAttachmentProtocolPredicate }).optional(),
+  thumbnail: import_zod7.z.object({ url: URLWithAttachmentProtocolPredicate }).optional(),
   author: embedAuthorPredicate.optional(),
   fields: import_zod7.z.array(embedFieldPredicate).max(25).optional()
 }).refine(
@@ -2854,7 +2862,7 @@ var EmbedBuilder = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    * The maximum amount of fields that can be added is 25.
    *
    * It's useful for modifying and adjusting order of the already-existing fields of an embed.
@@ -3290,7 +3298,7 @@ var PollBuilder = class {
    *
    * @remarks
    * This method behaves similarly
-   * to {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
    * The maximum amount of answers that can be added is 10.
    *
    * It's useful for modifying and adjusting order of the already-existing answers of a poll.
@@ -3418,17 +3426,855 @@ var PollBuilder = class {
   }
 };
 
+// src/messages/Assertions.ts
+var import_v1033 = require("discord-api-types/v10");
+var import_zod9 = require("zod");
+var attachmentPredicate = import_zod9.z.object({
+  id: import_zod9.z.union([import_zod9.z.string(), import_zod9.z.number()]),
+  description: import_zod9.z.string().optional(),
+  duration_secs: import_zod9.z.number().optional(),
+  filename: import_zod9.z.string().optional(),
+  title: import_zod9.z.string().optional(),
+  waveform: import_zod9.z.string().optional()
+});
+var allowedMentionPredicate = import_zod9.z.object({
+  parse: import_zod9.z.nativeEnum(import_v1033.AllowedMentionsTypes).array().optional(),
+  roles: import_zod9.z.string().array().optional(),
+  users: import_zod9.z.string().array().optional(),
+  replied_user: import_zod9.z.boolean().optional()
+});
+var messageReferencePredicate = import_zod9.z.object({
+  channel_id: import_zod9.z.string().optional(),
+  fail_if_not_exists: import_zod9.z.boolean().optional(),
+  guild_id: import_zod9.z.string().optional(),
+  message_id: import_zod9.z.string(),
+  type: import_zod9.z.nativeEnum(import_v1033.MessageReferenceType).optional()
+});
+var messagePredicate = import_zod9.z.object({
+  content: import_zod9.z.string().optional(),
+  nonce: import_zod9.z.union([import_zod9.z.string().max(25), import_zod9.z.number()]).optional(),
+  tts: import_zod9.z.boolean().optional(),
+  embeds: embedPredicate.array().max(10).optional(),
+  allowed_mentions: allowedMentionPredicate.optional(),
+  message_reference: messageReferencePredicate.optional(),
+  // Partial validation here to ensure the components are valid,
+  // rest of the validation is done in the action row predicate
+  components: import_zod9.z.object({
+    type: import_zod9.z.literal(import_v1033.ComponentType.ActionRow),
+    components: import_zod9.z.object({
+      type: import_zod9.z.union([
+        import_zod9.z.literal(import_v1033.ComponentType.Button),
+        import_zod9.z.literal(import_v1033.ComponentType.ChannelSelect),
+        import_zod9.z.literal(import_v1033.ComponentType.MentionableSelect),
+        import_zod9.z.literal(import_v1033.ComponentType.RoleSelect),
+        import_zod9.z.literal(import_v1033.ComponentType.StringSelect),
+        import_zod9.z.literal(import_v1033.ComponentType.UserSelect)
+      ])
+    }).array()
+  }).array().max(5).optional(),
+  sticker_ids: import_zod9.z.array(import_zod9.z.string()).min(0).max(3).optional(),
+  attachments: attachmentPredicate.array().max(10).optional(),
+  flags: import_zod9.z.number().optional(),
+  enforce_nonce: import_zod9.z.boolean().optional(),
+  poll: pollPredicate.optional()
+}).refine(
+  (data) => {
+    return data.content !== void 0 || data.embeds !== void 0 && data.embeds.length > 0 || data.poll !== void 0 || data.attachments !== void 0 && data.attachments.length > 0 || data.components !== void 0 && data.components.length > 0 || data.sticker_ids !== void 0 && data.sticker_ids.length > 0;
+  },
+  { message: "Messages must have content, embeds, a poll, attachments, components, or stickers" }
+);
+
+// src/messages/AllowedMentions.ts
+var AllowedMentionsBuilder = class {
+  static {
+    __name(this, "AllowedMentionsBuilder");
+  }
+  data;
+  /**
+   * Creates new allowed mention builder from API data.
+   *
+   * @param data - The API data to create this attachment with
+   */
+  constructor(data = {}) {
+    this.data = structuredClone(data);
+  }
+  /**
+   * Sets the types of mentions to parse from the content.
+   *
+   * @param parse - The types of mentions to parse from the content
+   */
+  setParse(...parse) {
+    this.data.parse = normalizeArray(parse);
+    return this;
+  }
+  /**
+   * Sets the roles to mention.
+   *
+   * @param roles - The roles to mention
+   */
+  setRoles(...roles) {
+    this.data.roles = normalizeArray(roles);
+    return this;
+  }
+  /**
+   * Adds roles to mention.
+   *
+   * @param roles - The roles to mention
+   */
+  addRoles(...roles) {
+    this.data.roles ??= [];
+    this.data.roles.push(...normalizeArray(roles));
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts roles.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing roles.
+   * @example
+   * Remove the first role:
+   * ```ts
+   * allowedMentions.spliceRoles(0, 1);
+   * ```
+   * @example
+   * Remove the first n role:
+   * ```ts
+   * const n = 4;
+   * allowedMentions.spliceRoles(0, n);
+   * ```
+   * @example
+   * Remove the last role:
+   * ```ts
+   * allowedMentions.spliceRoles(-1, 1);
+   * ```
+   * @param index - The index to start at
+   * @param deleteCount - The number of roles to remove
+   * @param roles - The replacing role ids
+   */
+  spliceRoles(index, deleteCount, ...roles) {
+    this.data.roles ??= [];
+    this.data.roles.splice(index, deleteCount, ...normalizeArray(roles));
+    return this;
+  }
+  /**
+   * Sets the users to mention.
+   *
+   * @param users - The users to mention
+   */
+  setUsers(...users) {
+    this.data.users = normalizeArray(users);
+    return this;
+  }
+  /**
+   * Adds users to mention.
+   *
+   * @param users - The users to mention
+   */
+  addUsers(...users) {
+    this.data.users ??= [];
+    this.data.users.push(...normalizeArray(users));
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts users.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing users.
+   * @example
+   * Remove the first user:
+   * ```ts
+   * allowedMentions.spliceUsers(0, 1);
+   * ```
+   * @example
+   * Remove the first n user:
+   * ```ts
+   * const n = 4;
+   * allowedMentions.spliceUsers(0, n);
+   * ```
+   * @example
+   * Remove the last user:
+   * ```ts
+   * allowedMentions.spliceUsers(-1, 1);
+   * ```
+   * @param index - The index to start at
+   * @param deleteCount - The number of users to remove
+   * @param users - The replacing user ids
+   */
+  spliceUsers(index, deleteCount, ...users) {
+    this.data.users ??= [];
+    this.data.users.splice(index, deleteCount, ...normalizeArray(users));
+    return this;
+  }
+  /**
+   * For replies, sets whether to mention the author of the message being replied to
+   */
+  setRepliedUser(repliedUser = true) {
+    this.data.replied_user = repliedUser;
+    return this;
+  }
+  /**
+   * Serializes this builder to API-compatible JSON data.
+   *
+   * Note that by disabling validation, there is no guarantee that the resulting object will be valid.
+   *
+   * @param validationOverride - Force validation to run/not run regardless of your global preference
+   */
+  toJSON(validationOverride) {
+    const clone = structuredClone(this.data);
+    validate(allowedMentionPredicate, clone, validationOverride);
+    return clone;
+  }
+};
+
+// src/messages/Attachment.ts
+var AttachmentBuilder = class {
+  static {
+    __name(this, "AttachmentBuilder");
+  }
+  data;
+  /**
+   * Creates new attachment builder from API data.
+   *
+   * @param data - The API data to create this attachment with
+   */
+  constructor(data = {}) {
+    this.data = structuredClone(data);
+  }
+  /**
+   * @param id - The id of the attachment
+   */
+  setId(id) {
+    this.data.id = id;
+    return this;
+  }
+  /**
+   * Clears the id of this attachment.
+   */
+  clearId() {
+    this.data.id = void 0;
+    return this;
+  }
+  /**
+   * Sets the description of this attachment.
+   */
+  setDescription(description) {
+    this.data.description = description;
+    return this;
+  }
+  /**
+   * Clears the description of this attachment.
+   */
+  clearDescription() {
+    this.data.description = void 0;
+    return this;
+  }
+  /**
+   * Sets the duration of this attachment (audio clips).
+   *
+   * @param duration - The duration of the attachment in seconds
+   */
+  setDuration(duration) {
+    this.data.duration_secs = duration;
+    return this;
+  }
+  /**
+   * Clears the duration of this attachment.
+   */
+  clearDuration() {
+    this.data.duration_secs = void 0;
+    return this;
+  }
+  /**
+   * Sets the filename of this attachment.
+   *
+   * @param filename - The filename of the attachment
+   */
+  setFilename(filename) {
+    this.data.filename = filename;
+    return this;
+  }
+  /**
+   * Clears the filename of this attachment.
+   */
+  clearFilename() {
+    this.data.filename = void 0;
+    return this;
+  }
+  /**
+   * Sets the title of this attachment.
+   *
+   * @param title - The title of the attachment
+   */
+  setTitle(title) {
+    this.data.title = title;
+    return this;
+  }
+  /**
+   * Clears the title of this attachment.
+   */
+  clearTitle() {
+    this.data.title = void 0;
+    return this;
+  }
+  /**
+   * Sets the waveform of this attachment.
+   *
+   * @param waveform - The waveform of the attachment
+   */
+  setWaveform(waveform) {
+    this.data.waveform = waveform;
+    return this;
+  }
+  /**
+   * Clears the waveform of this attachment.
+   */
+  clearWaveform() {
+    this.data.waveform = void 0;
+    return this;
+  }
+  /**
+   * Serializes this builder to API-compatible JSON data.
+   *
+   * Note that by disabling validation, there is no guarantee that the resulting object will be valid.
+   *
+   * @param validationOverride - Force validation to run/not run regardless of your global preference
+   */
+  toJSON(validationOverride) {
+    const clone = structuredClone(this.data);
+    validate(attachmentPredicate, clone, validationOverride);
+    return clone;
+  }
+};
+
+// src/messages/MessageReference.ts
+var MessageReferenceBuilder = class {
+  static {
+    __name(this, "MessageReferenceBuilder");
+  }
+  data;
+  /**
+   * Creates new allowed mention builder from API data.
+   *
+   * @param data - The API data to create this attachment with
+   */
+  constructor(data = {}) {
+    this.data = structuredClone(data);
+  }
+  /**
+   * Sets the types of message reference this represents
+   *
+   * @param type - The type of message reference
+   */
+  setType(type) {
+    this.data.type = type;
+    return this;
+  }
+  /**
+   * Clear the type of message reference this represents
+   */
+  clearType() {
+    this.data.type = void 0;
+    return this;
+  }
+  /**
+   * Sets the id of the message being referenced
+   *
+   * @param messageId - The id of the message being referenced
+   */
+  setMessageId(messageId) {
+    this.data.message_id = messageId;
+    return this;
+  }
+  /**
+   * Sets the id of the channel being referenced
+   *
+   * @param channelId - The id of the channel being referenced
+   */
+  setChannelId(channelId) {
+    this.data.channel_id = channelId;
+    return this;
+  }
+  /**
+   * Clear the id of the channel being referenced
+   */
+  clearChannelId() {
+    this.data.channel_id = void 0;
+    return this;
+  }
+  /**
+   * Sets the id of the guild being referenced
+   *
+   * @param guildId - The id of the guild being referenced
+   */
+  setGuildId(guildId) {
+    this.data.guild_id = guildId;
+    return this;
+  }
+  /**
+   * Clear the id of the guild being referenced
+   */
+  clearGuildId() {
+    this.data.guild_id = void 0;
+    return this;
+  }
+  /**
+   * Serializes this builder to API-compatible JSON data.
+   *
+   * Note that by disabling validation, there is no guarantee that the resulting object will be valid.
+   *
+   * @param validationOverride - Force validation to run/not run regardless of your global preference
+   */
+  toJSON(validationOverride) {
+    const clone = structuredClone(this.data);
+    validate(messageReferencePredicate, clone, validationOverride);
+    return clone;
+  }
+};
+
+// src/messages/Message.ts
+var MessageBuilder = class {
+  static {
+    __name(this, "MessageBuilder");
+  }
+  /**
+   * The API data associated with this message.
+   */
+  data;
+  /**
+   * Gets the attachments of this message.
+   */
+  get attachments() {
+    return this.data.attachments;
+  }
+  /**
+   * Gets the components of this message.
+   */
+  get components() {
+    return this.data.components;
+  }
+  /**
+   * Gets the embeds of this message.
+   */
+  get embeds() {
+    return this.data.embeds;
+  }
+  /**
+   * Creates new attachment builder from API data.
+   *
+   * @param data - The API data to create this attachment with
+   */
+  constructor(data = {}) {
+    this.data = {
+      ...structuredClone(data),
+      allowed_mentions: data.allowed_mentions ? new AllowedMentionsBuilder(data.allowed_mentions) : void 0,
+      attachments: data.attachments?.map((attachment) => new AttachmentBuilder(attachment)) ?? [],
+      embeds: data.embeds?.map((embed) => new EmbedBuilder(embed)) ?? [],
+      poll: data.poll ? new PollBuilder(data.poll) : void 0,
+      components: data.components?.map((component) => new ActionRowBuilder(component)) ?? [],
+      message_reference: data.message_reference ? new MessageReferenceBuilder(data.message_reference) : void 0
+    };
+  }
+  /**
+   * Sets the content of the message.
+   *
+   * @param content - The content to set
+   */
+  setContent(content) {
+    this.data.content = content;
+    return this;
+  }
+  /**
+   * Clears the content of the message.
+   */
+  clearContent() {
+    this.data.content = void 0;
+    return this;
+  }
+  /**
+   * Sets the nonce of the message.
+   *
+   * @param nonce - The nonce to set
+   */
+  setNonce(nonce) {
+    this.data.nonce = nonce;
+    return this;
+  }
+  /**
+   * Clears the nonce of the message.
+   */
+  clearNonce() {
+    this.data.nonce = void 0;
+    return this;
+  }
+  /**
+   * Sets whether the message is TTS.
+   */
+  setTTS(tts = true) {
+    this.data.tts = tts;
+    return this;
+  }
+  /**
+   * Appends embeds to this message.
+   *
+   * @remarks
+   * The maximum amount of embeds that can be added is 10.
+   * @example
+   * Using an array:
+   * ```ts
+   * const embeds: APIEmbed[] = ...;
+   * const message = new MessageBuilder()
+   * 	.addEmbeds(embeds);
+   * ```
+   * @example
+   * Using rest parameters (variadic):
+   * ```ts
+   * const message = new MessageBuilder()
+   * 	.addEmbeds(
+   * 		{ title: 'Embed 1' },
+   * 		{ title: 'Embed 2' },
+   * 	);
+   * ```
+   * @param embeds - The embeds to add
+   */
+  addEmbeds(...embeds) {
+    this.data.embeds ??= [];
+    const resolved = normalizeArray(embeds).map((embed) => resolveBuilder(embed, EmbedBuilder));
+    this.data.embeds.push(...resolved);
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts embeds for this message.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing embeds of a message.
+   * @example
+   * Remove the first embed:
+   * ```ts
+   * message.spliceEmbeds(0, 1);
+   * ```
+   * @example
+   * Remove the first n embeds:
+   * ```ts
+   * const n = 4;
+   * message.spliceEmbeds(0, n);
+   * ```
+   * @example
+   * Remove the last embed:
+   * ```ts
+   * message.spliceEmbeds(-1, 1);
+   * ```
+   * @param start - The index to start at
+   * @param deleteCount - The amount of embeds to remove
+   * @param embeds - The embeds to insert
+   */
+  spliceEmbeds(start, deleteCount, ...embeds) {
+    this.data.embeds ??= [];
+    const resolved = normalizeArray(embeds).map((embed) => resolveBuilder(embed, EmbedBuilder));
+    this.data.embeds.splice(start, deleteCount, ...resolved);
+    return this;
+  }
+  /**
+   * Sets the allowed mentions for this message.
+   *
+   * @param allowedMentions - The allowed mentions to set
+   */
+  setAllowedMentions(allowedMentions) {
+    this.data.allowed_mentions = resolveBuilder(allowedMentions, AllowedMentionsBuilder);
+    return this;
+  }
+  /**
+   * Updates the allowed mentions for this message (and creates it if it doesn't exist)
+   *
+   * @param updater - The function to update the allowed mentions with
+   */
+  updateAllowedMentions(updater) {
+    this.data.allowed_mentions = updater(this.data.allowed_mentions ?? new AllowedMentionsBuilder());
+    return this;
+  }
+  /**
+   * Clears the allowed mentions for this message.
+   */
+  clearAllowedMentions() {
+    this.data.allowed_mentions = void 0;
+    return this;
+  }
+  /**
+   * Sets the message reference for this message.
+   *
+   * @param reference - The reference to set
+   */
+  setMessageReference(reference) {
+    this.data.message_reference = resolveBuilder(reference, MessageReferenceBuilder);
+    return this;
+  }
+  /**
+   * Updates the message reference for this message (and creates it if it doesn't exist)
+   *
+   * @param updater - The function to update the message reference with
+   */
+  updateMessageReference(updater) {
+    this.data.message_reference = updater(this.data.message_reference ?? new MessageReferenceBuilder());
+    return this;
+  }
+  /**
+   * Clears the message reference for this message.
+   */
+  clearMessageReference() {
+    this.data.message_reference = void 0;
+    return this;
+  }
+  /**
+   * Adds components to this message.
+   *
+   * @param components - The components to add
+   */
+  addComponents(...components) {
+    this.data.components ??= [];
+    const resolved = normalizeArray(components).map((component) => resolveBuilder(component, ActionRowBuilder));
+    this.data.components.push(...resolved);
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts components for this message.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing components of a message.
+   * @example
+   * Remove the first component:
+   * ```ts
+   * message.spliceComponents(0, 1);
+   * ```
+   * @example
+   * Remove the first n components:
+   * ```ts
+   * const n = 4;
+   * message.spliceComponents(0, n);
+   * ```
+   * @example
+   * Remove the last component:
+   * ```ts
+   * message.spliceComponents(-1, 1);
+   * ```
+   * @param start - The index to start at
+   * @param deleteCount - The amount of components to remove
+   * @param components - The components to insert
+   */
+  spliceComponents(start, deleteCount, ...components) {
+    this.data.components ??= [];
+    const resolved = normalizeArray(components).map((component) => resolveBuilder(component, ActionRowBuilder));
+    this.data.components.splice(start, deleteCount, ...resolved);
+    return this;
+  }
+  /**
+   * Sets the components of this message.
+   *
+   * @param components - The components to set
+   */
+  setComponents(...components) {
+    this.data.components = normalizeArray(components).map((component) => resolveBuilder(component, ActionRowBuilder));
+    return this;
+  }
+  /**
+   * Sets the sticker ids of this message.
+   *
+   * @param stickerIds - The ids of the stickers to set
+   */
+  setStickerIds(...stickerIds) {
+    this.data.sticker_ids = normalizeArray(stickerIds);
+    return this;
+  }
+  /**
+   * Adds sticker ids to this message.
+   *
+   * @param stickerIds - The ids of the stickers to add
+   */
+  addStickerIds(...stickerIds) {
+    this.data.sticker_ids ??= [];
+    this.data.sticker_ids.push(...normalizeArray(stickerIds));
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts sticker ids for this message.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing sticker ids of a message.
+   * @example
+   * Remove the first sticker id:
+   * ```ts
+   * message.spliceStickerIds(0, 1);
+   * ```
+   * @example
+   * Remove the first n sticker ids:
+   * ```ts
+   * const n = 4;
+   * message.spliceStickerIds(0, n);
+   * ```
+   * @example
+   * Remove the last sticker id:
+   * ```ts
+   * message.spliceStickerIds(-1, 1);
+   * ```
+   * @param index - The index to start at
+   * @param deleteCount - The amount of sticker ids to remove
+   * @param stickerIds - The sticker ids to insert
+   */
+  spliceStickerIds(index, deleteCount, ...stickerIds) {
+    this.data.sticker_ids ??= [];
+    this.data.sticker_ids.splice(index, deleteCount, ...normalizeArray(stickerIds));
+    return this;
+  }
+  /**
+   * Sets attachments for this message.
+   *
+   * @param attachments - The attachments to set
+   */
+  setAttachments(...attachments) {
+    const resolved = normalizeArray(attachments).map((attachment) => resolveBuilder(attachment, AttachmentBuilder));
+    this.data.attachments = resolved;
+    return this;
+  }
+  /**
+   * Adds attachments to this message.
+   *
+   * @param attachments - The attachments to add
+   */
+  addAttachments(...attachments) {
+    const resolved = normalizeArray(attachments).map((attachment) => resolveBuilder(attachment, AttachmentBuilder));
+    this.data.attachments.push(...resolved);
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts attachments for this message.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array/splice | Array.prototype.splice()}.
+   *
+   * It's useful for modifying and adjusting order of the already-existing attachments of a message.
+   * @example
+   * Remove the first attachment:
+   * ```ts
+   * message.spliceAttachments(0, 1);
+   * ```
+   * @example
+   * Remove the first n attachments:
+   * ```ts
+   * const n = 4;
+   * message.spliceAttachments(0, n);
+   * ```
+   * @example
+   * Remove the last attachment:
+   * ```ts
+   * message.spliceAttachments(-1, 1);
+   * ```
+   * @param start - The index to start at
+   * @param deleteCount - The amount of attachments to remove
+   * @param attachments - The attachments to insert
+   */
+  spliceAttachments(start, deleteCount, ...attachments) {
+    const resolved = normalizeArray(attachments).map((attachment) => resolveBuilder(attachment, AttachmentBuilder));
+    this.data.attachments.splice(start, deleteCount, ...resolved);
+    return this;
+  }
+  /**
+   * Sets the flags for this message.
+   */
+  setFlags(flags) {
+    this.data.flags = flags;
+    return this;
+  }
+  /**
+   * Clears the flags for this message.
+   */
+  clearFlags() {
+    this.data.flags = void 0;
+    return this;
+  }
+  /**
+   * Sets `enforce_nonce` for this message.
+   */
+  setEnforceNonce(enforceNonce = true) {
+    this.data.enforce_nonce = enforceNonce;
+    return this;
+  }
+  /**
+   * Sets the poll for this message.
+   *
+   * @param poll - The poll to set
+   */
+  setPoll(poll) {
+    this.data.poll = resolveBuilder(poll, PollBuilder);
+    return this;
+  }
+  /**
+   * Updates the poll for this message (and creates it if it doesn't exist)
+   *
+   * @param updater - The function to update the poll with
+   */
+  updatePoll(updater) {
+    this.data.poll = updater(this.data.poll ?? new PollBuilder());
+    return this;
+  }
+  /**
+   * Clears the poll for this message.
+   */
+  clearPoll() {
+    this.data.poll = void 0;
+    return this;
+  }
+  /**
+   * Serializes this builder to API-compatible JSON data.
+   *
+   * Note that by disabling validation, there is no guarantee that the resulting object will be valid.
+   *
+   * @param validationOverride - Force validation to run/not run regardless of your global preference
+   */
+  toJSON(validationOverride) {
+    const { poll, allowed_mentions, attachments, embeds, components, message_reference, ...rest } = this.data;
+    const data = {
+      ...structuredClone(rest),
+      // Wherever we pass false, it's covered by the messagePredicate already
+      poll: this.data.poll?.toJSON(false),
+      allowed_mentions: allowed_mentions?.toJSON(false),
+      attachments: attachments.map((attachment) => attachment.toJSON(false)),
+      embeds: this.data.embeds.map((embed) => embed.toJSON(false)),
+      // Here, the messagePredicate does specific constraints rather than using the componentPredicate
+      components: this.data.components?.map((component) => component.toJSON(validationOverride)),
+      message_reference: message_reference?.toJSON(false)
+    };
+    validate(messagePredicate, data, validationOverride);
+    return data;
+  }
+};
+
 // src/index.ts
-var version = "2.0.0-dev.1741219959-e273afbb9";
+var version = "2.0.0-dev.1741953893-09beb8a6a";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,
+  AllowedMentionsBuilder,
   ApplicationCommandNumericOptionMinMaxValueMixin,
   ApplicationCommandOptionAllowedChannelTypes,
   ApplicationCommandOptionBase,
   ApplicationCommandOptionChannelTypesMixin,
   ApplicationCommandOptionWithAutocompleteMixin,
   ApplicationCommandOptionWithChoicesMixin,
+  AttachmentBuilder,
   BaseButtonBuilder,
   BaseSelectMenuBuilder,
   ChannelSelectMenuBuilder,
@@ -3456,7 +4302,9 @@ var version = "2.0.0-dev.1741219959-e273afbb9";
   EmojiOrLabelButtonMixin,
   LinkButtonBuilder,
   MentionableSelectMenuBuilder,
+  MessageBuilder,
   MessageContextCommandBuilder,
+  MessageReferenceBuilder,
   ModalBuilder,
   PollAnswerBuilder,
   PollAnswerMediaBuilder,
@@ -3478,6 +4326,8 @@ var version = "2.0.0-dev.1741219959-e273afbb9";
   UserContextCommandBuilder,
   UserSelectMenuBuilder,
   actionRowPredicate,
+  allowedMentionPredicate,
+  attachmentPredicate,
   basicOptionPredicate,
   buttonPredicate,
   channelOptionPredicate,
@@ -3499,6 +4349,8 @@ var version = "2.0.0-dev.1741219959-e273afbb9";
   localeMapPredicate,
   memberPermissionsPredicate,
   messageCommandPredicate,
+  messagePredicate,
+  messageReferencePredicate,
   modalPredicate,
   normalizeArray,
   numberOptionPredicate,