@discordjs/builders 2.0.0-dev.1740679933-8a37b7b93 → 2.0.0-dev.1740744295-88bfeaab2

package/dist/index.mjs

@@ -2979,8 +2979,327 @@ var EmbedBuilder = class {
   }
 };
 
+// src/messages/poll/Assertions.ts
+import { PollLayoutType } from "discord-api-types/v10";
+import { z as z8 } from "zod";
+var pollQuestionPredicate = z8.object({ text: z8.string().min(1).max(300) });
+var pollAnswerMediaPredicate = z8.object({
+  text: z8.string().min(1).max(55),
+  emoji: emojiPredicate.nullish()
+});
+var pollAnswerPredicate = z8.object({ poll_media: pollAnswerMediaPredicate });
+var pollPredicate = z8.object({
+  question: pollQuestionPredicate,
+  answers: z8.array(pollAnswerPredicate).max(10),
+  duration: z8.number().min(1).max(768).optional(),
+  allow_multiselect: z8.boolean().optional(),
+  layout_type: z8.nativeEnum(PollLayoutType).optional()
+});
+
+// src/messages/poll/PollMedia.ts
+var PollMediaBuilder = class {
+  static {
+    __name(this, "PollMediaBuilder");
+  }
+  data;
+  /**
+   * Creates new poll media from API data.
+   *
+   * @param data - The API data to use
+   */
+  constructor(data = {}) {
+    this.data = structuredClone(data);
+  }
+  /**
+   * Sets the text for this poll media.
+   *
+   * @param text - The text to use
+   */
+  setText(text) {
+    this.data.text = text;
+    return this;
+  }
+};
+
+// src/messages/poll/PollAnswerMedia.ts
+var PollAnswerMediaBuilder = class extends PollMediaBuilder {
+  static {
+    __name(this, "PollAnswerMediaBuilder");
+  }
+  /**
+   * Sets the emoji for this poll answer.
+   *
+   * @param emoji - The emoji to use
+   */
+  setEmoji(emoji) {
+    this.data.emoji = emoji;
+    return this;
+  }
+  /**
+   * Clears the emoji for this poll answer.
+   */
+  clearEmoji() {
+    this.data.emoji = void 0;
+    return this;
+  }
+  toJSON(validationOverride) {
+    const clone = structuredClone(this.data);
+    validate(pollAnswerMediaPredicate, clone, validationOverride);
+    return clone;
+  }
+};
+
+// src/messages/poll/PollAnswer.ts
+var PollAnswerBuilder = class {
+  static {
+    __name(this, "PollAnswerBuilder");
+  }
+  data;
+  constructor(data = {}) {
+    this.data = {
+      ...structuredClone(data),
+      poll_media: new PollAnswerMediaBuilder(data.poll_media)
+    };
+  }
+  /**
+   * Sets the media for this poll answer.
+   *
+   * @param options - The data to use for this poll answer's media
+   */
+  setMedia(options) {
+    this.data.poll_media = resolveBuilder(options, PollAnswerMediaBuilder);
+    return this;
+  }
+  /**
+   * Updates the media of this poll answer.
+   *
+   * @param updater - The function to update the media with
+   */
+  updateMedia(updater) {
+    updater(this.data.poll_media ??= new PollAnswerMediaBuilder());
+  }
+  /**
+   * 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 data = {
+      ...structuredClone(this.data),
+      // Disable validation because the pollAnswerPredicate below will validate this as well
+      poll_media: this.data.poll_media?.toJSON(false)
+    };
+    validate(pollAnswerPredicate, data, validationOverride);
+    return data;
+  }
+};
+
+// src/messages/poll/PollQuestion.ts
+var PollQuestionBuilder = class extends PollMediaBuilder {
+  static {
+    __name(this, "PollQuestionBuilder");
+  }
+  toJSON(validationOverride) {
+    const clone = structuredClone(this.data);
+    validate(pollQuestionPredicate, clone, validationOverride);
+    return clone;
+  }
+};
+
+// src/messages/poll/Poll.ts
+var PollBuilder = class {
+  static {
+    __name(this, "PollBuilder");
+  }
+  /**
+   * The API data associated with this poll.
+   */
+  data;
+  /**
+   * Gets the answers of this poll.
+   */
+  get answers() {
+    return this.data.answers;
+  }
+  /**
+   * Creates a new poll from API data.
+   *
+   * @param data - The API data to create this poll with
+   */
+  constructor(data = {}) {
+    this.data = {
+      ...structuredClone(data),
+      question: new PollQuestionBuilder(data.question),
+      answers: data.answers?.map((answer) => new PollAnswerBuilder(answer)) ?? []
+    };
+  }
+  /**
+   * Appends answers to the poll.
+   *
+   * @remarks
+   * This method accepts either an array of answers or a variable number of answer parameters.
+   * The maximum amount of answers that can be added is 10.
+   * @example
+   * Using an array:
+   * ```ts
+   * const answers: APIPollMedia[] = ...;
+   * const poll = new PollBuilder()
+   * 	.addAnswers(answers);
+   * ```
+   * @example
+   * Using rest parameters (variadic):
+   * ```ts
+   * const poll = new PollBuilder()
+   * 	.addAnswers(
+   * 		{ text: 'Answer 1' },
+   * 		{ text: 'Answer 2' },
+   * 	);
+   * ```
+   * @param answers - The answers to add
+   */
+  addAnswers(...answers) {
+    const normalizedAnswers = normalizeArray(answers);
+    const resolved = normalizedAnswers.map((answer) => resolveBuilder(answer, PollAnswerBuilder));
+    this.data.answers.push(...resolved);
+    return this;
+  }
+  /**
+   * Removes, replaces, or inserts answers for this poll.
+   *
+   * @remarks
+   * This method behaves similarly
+   * to {@link https://developer.mozilla.org/en-US/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.
+   * @example
+   * Remove the first answer:
+   * ```ts
+   * poll.spliceAnswers(0, 1);
+   * ```
+   * @example
+   * Remove the first n answers:
+   * ```ts
+   * const n = 4;
+   * poll.spliceAnswers(0, n);
+   * ```
+   * @example
+   * Remove the last answer:
+   * ```ts
+   * poll.spliceAnswers(-1, 1);
+   * ```
+   * @param index - The index to start at
+   * @param deleteCount - The number of answers to remove
+   * @param answers - The replacing answer objects
+   */
+  spliceAnswers(index, deleteCount, ...answers) {
+    const normalizedAnswers = normalizeArray(answers);
+    const resolved = normalizedAnswers.map((answer) => resolveBuilder(answer, PollAnswerBuilder));
+    this.data.answers.splice(index, deleteCount, ...resolved);
+    return this;
+  }
+  /**
+   * Sets the answers for this poll.
+   *
+   * @remarks
+   * This method is an alias for {@link PollBuilder.spliceAnswers}. More specifically,
+   * it splices the entire array of answers, replacing them with the provided answers.
+   *
+   * You can set a maximum of 10 answers.
+   * @param answers - The answers to set
+   */
+  setAnswers(...answers) {
+    return this.spliceAnswers(0, this.data.answers.length, ...normalizeArray(answers));
+  }
+  /**
+   * Sets the question for this poll.
+   *
+   * @param options - The data to use for this poll's question
+   */
+  setQuestion(options) {
+    this.data.question = resolveBuilder(options, PollQuestionBuilder);
+    return this;
+  }
+  /**
+   * Updates the question of this poll.
+   *
+   * @param updater - The function to update the question with
+   */
+  updateQuestion(updater) {
+    updater(this.data.question ??= new PollQuestionBuilder());
+    return this;
+  }
+  /**
+   * Sets the layout type for this poll.
+   *
+   * @remarks
+   * This method is redundant while only one type of poll layout exists (`PollLayoutType.Default`)
+   * with Discord using that as the layout type if none is specified.
+   * @param type - The type of poll layout to use
+   */
+  setLayoutType(type) {
+    this.data.layout_type = type;
+    return this;
+  }
+  /**
+   * Clears the layout type for this poll.
+   */
+  clearLayoutType() {
+    this.data.layout_type = void 0;
+    return this;
+  }
+  /**
+   * Sets whether multi-select is enabled for this poll.
+   *
+   * @param multiSelect - Whether to allow multi-select
+   */
+  setMultiSelect(multiSelect = true) {
+    this.data.allow_multiselect = multiSelect;
+    return this;
+  }
+  /**
+   * Sets how long this poll will be open for in hours.
+   *
+   * @remarks
+   * Minimum duration is `1`, with maximum duration being `768` (32 days).
+   * Default if none specified is `24` (one day).
+   * @param duration - The amount of hours this poll will be open for
+   */
+  setDuration(duration) {
+    this.data.duration = duration;
+    return this;
+  }
+  /**
+   * Clears the duration for this poll.
+   */
+  clearDuration() {
+    this.data.duration = 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 { answers, question, ...rest } = this.data;
+    const data = {
+      ...structuredClone(rest),
+      // Disable validation because the pollPredicate below will validate those as well
+      answers: answers.map((answer) => answer.toJSON(false)),
+      question: question.toJSON(false)
+    };
+    validate(pollPredicate, data, validationOverride);
+    return data;
+  }
+};
+
 // src/index.ts
-var version = "2.0.0-dev.1740679933-8a37b7b93";
+var version = "2.0.0-dev.1740744295-88bfeaab2";
 export {
   ActionRowBuilder,
   ApplicationCommandNumericOptionMinMaxValueMixin,
@@ -3018,6 +3337,11 @@ export {
   MentionableSelectMenuBuilder,
   MessageContextCommandBuilder,
   ModalBuilder,
+  PollAnswerBuilder,
+  PollAnswerMediaBuilder,
+  PollBuilder,
+  PollMediaBuilder,
+  PollQuestionBuilder,
   PremiumButtonBuilder,
   PrimaryButtonBuilder,
   RoleSelectMenuBuilder,
@@ -3057,7 +3381,12 @@ export {
   modalPredicate,
   normalizeArray,
   numberOptionPredicate,
+  pollAnswerMediaPredicate,
+  pollAnswerPredicate,
+  pollPredicate,
+  pollQuestionPredicate,
   refineURLPredicate,
+  resolveBuilder,
   selectMenuChannelPredicate,
   selectMenuMentionablePredicate,
   selectMenuRolePredicate,