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

package/dist/index.js

@@ -57,6 +57,11 @@ __export(index_exports, {
   MentionableSelectMenuBuilder: () => MentionableSelectMenuBuilder,
   MessageContextCommandBuilder: () => MessageContextCommandBuilder,
   ModalBuilder: () => ModalBuilder,
+  PollAnswerBuilder: () => PollAnswerBuilder,
+  PollAnswerMediaBuilder: () => PollAnswerMediaBuilder,
+  PollBuilder: () => PollBuilder,
+  PollMediaBuilder: () => PollMediaBuilder,
+  PollQuestionBuilder: () => PollQuestionBuilder,
   PremiumButtonBuilder: () => PremiumButtonBuilder,
   PrimaryButtonBuilder: () => PrimaryButtonBuilder,
   RoleSelectMenuBuilder: () => RoleSelectMenuBuilder,
@@ -96,7 +101,12 @@ __export(index_exports, {
   modalPredicate: () => modalPredicate,
   normalizeArray: () => normalizeArray,
   numberOptionPredicate: () => numberOptionPredicate,
+  pollAnswerMediaPredicate: () => pollAnswerMediaPredicate,
+  pollAnswerPredicate: () => pollAnswerPredicate,
+  pollPredicate: () => pollPredicate,
+  pollQuestionPredicate: () => pollQuestionPredicate,
   refineURLPredicate: () => refineURLPredicate,
+  resolveBuilder: () => resolveBuilder,
   selectMenuChannelPredicate: () => selectMenuChannelPredicate,
   selectMenuMentionablePredicate: () => selectMenuMentionablePredicate,
   selectMenuRolePredicate: () => selectMenuRolePredicate,
@@ -3070,8 +3080,327 @@ var EmbedBuilder = class {
   }
 };
 
+// src/messages/poll/Assertions.ts
+var import_v1032 = require("discord-api-types/v10");
+var import_zod8 = require("zod");
+var pollQuestionPredicate = import_zod8.z.object({ text: import_zod8.z.string().min(1).max(300) });
+var pollAnswerMediaPredicate = import_zod8.z.object({
+  text: import_zod8.z.string().min(1).max(55),
+  emoji: emojiPredicate.nullish()
+});
+var pollAnswerPredicate = import_zod8.z.object({ poll_media: pollAnswerMediaPredicate });
+var pollPredicate = import_zod8.z.object({
+  question: pollQuestionPredicate,
+  answers: import_zod8.z.array(pollAnswerPredicate).max(10),
+  duration: import_zod8.z.number().min(1).max(768).optional(),
+  allow_multiselect: import_zod8.z.boolean().optional(),
+  layout_type: import_zod8.z.nativeEnum(import_v1032.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";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,
@@ -3110,6 +3439,11 @@ var version = "2.0.0-dev.1740679933-8a37b7b93";
   MentionableSelectMenuBuilder,
   MessageContextCommandBuilder,
   ModalBuilder,
+  PollAnswerBuilder,
+  PollAnswerMediaBuilder,
+  PollBuilder,
+  PollMediaBuilder,
+  PollQuestionBuilder,
   PremiumButtonBuilder,
   PrimaryButtonBuilder,
   RoleSelectMenuBuilder,
@@ -3149,7 +3483,12 @@ var version = "2.0.0-dev.1740679933-8a37b7b93";
   modalPredicate,
   normalizeArray,
   numberOptionPredicate,
+  pollAnswerMediaPredicate,
+  pollAnswerPredicate,
+  pollPredicate,
+  pollQuestionPredicate,
   refineURLPredicate,
+  resolveBuilder,
   selectMenuChannelPredicate,
   selectMenuMentionablePredicate,
   selectMenuRolePredicate,