@discordjs/builders 2.0.0-dev.1740746538-46be1567a → 2.0.0-dev.1740874411-d1f56ffb2

package/dist/index.d.mts

@@ -8169,7 +8169,7 @@ declare const pollQuestionPredicate: z.ZodObject<{
 }>;
 declare const pollAnswerMediaPredicate: z.ZodObject<{
     text: z.ZodString;
-    emoji: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+    emoji: z.ZodOptional<z.ZodEffects<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         name: z.ZodOptional<z.ZodString>;
         animated: z.ZodOptional<z.ZodBoolean>;
@@ -8189,26 +8189,26 @@ declare const pollAnswerMediaPredicate: z.ZodObject<{
         id?: string | undefined;
         name?: string | undefined;
         animated?: boolean | undefined;
-    }>>>;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     text: string;
     emoji?: {
         id?: string | undefined;
         name?: string | undefined;
         animated?: boolean | undefined;
-    } | null | undefined;
+    } | undefined;
 }, {
     text: string;
     emoji?: {
         id?: string | undefined;
         name?: string | undefined;
         animated?: boolean | undefined;
-    } | null | undefined;
+    } | undefined;
 }>;
 declare const pollAnswerPredicate: z.ZodObject<{
     poll_media: z.ZodObject<{
         text: z.ZodString;
-        emoji: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+        emoji: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
             animated: z.ZodOptional<z.ZodBoolean>;
@@ -8228,21 +8228,21 @@ declare const pollAnswerPredicate: z.ZodObject<{
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        }>>>;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
         emoji?: {
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        } | null | undefined;
+        } | undefined;
     }, {
         text: string;
         emoji?: {
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        } | null | undefined;
+        } | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     poll_media: {
@@ -8251,7 +8251,7 @@ declare const pollAnswerPredicate: z.ZodObject<{
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        } | null | undefined;
+        } | undefined;
     };
 }, {
     poll_media: {
@@ -8260,7 +8260,7 @@ declare const pollAnswerPredicate: z.ZodObject<{
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        } | null | undefined;
+        } | undefined;
     };
 }>;
 declare const pollPredicate: z.ZodObject<{
@@ -8274,7 +8274,7 @@ declare const pollPredicate: z.ZodObject<{
     answers: z.ZodArray<z.ZodObject<{
         poll_media: z.ZodObject<{
             text: z.ZodString;
-            emoji: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+            emoji: z.ZodOptional<z.ZodEffects<z.ZodObject<{
                 id: z.ZodOptional<z.ZodString>;
                 name: z.ZodOptional<z.ZodString>;
                 animated: z.ZodOptional<z.ZodBoolean>;
@@ -8294,21 +8294,21 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            }>>>;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             text: string;
             emoji?: {
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         }, {
             text: string;
             emoji?: {
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
         poll_media: {
@@ -8317,7 +8317,7 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         };
     }, {
         poll_media: {
@@ -8326,7 +8326,7 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         };
     }>, "many">;
     duration: z.ZodOptional<z.ZodNumber>;
@@ -8343,7 +8343,7 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         };
     }[];
     duration?: number | undefined;
@@ -8360,7 +8360,7 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         };
     }[];
     duration?: number | undefined;
@@ -8368,7 +8368,13 @@ declare const pollPredicate: z.ZodObject<{
     layout_type?: PollLayoutType | undefined;
 }>;
 
+/**
+ * The base poll media builder that contains common symbols for poll media builders.
+ */
 declare abstract class PollMediaBuilder {
+    /**
+     * The API data associated with this poll media.
+     */
     protected readonly data: Partial<APIPollMedia>;
     /**
      * Creates new poll media from API data.
@@ -8393,19 +8399,22 @@ declare abstract class PollMediaBuilder {
 }
 
 /**
- * A builder that creates API-compatible JSON data for poll answers.
+ * A builder that creates API-compatible JSON data for the media of a poll answer.
  */
 declare class PollAnswerMediaBuilder extends PollMediaBuilder {
     /**
-     * Sets the emoji for this poll answer.
+     * Sets the emoji for this poll answer media.
      *
      * @param emoji - The emoji to use
      */
     setEmoji(emoji: APIPartialEmoji): this;
     /**
-     * Clears the emoji for this poll answer.
+     * Clears the emoji for this poll answer media.
      */
     clearEmoji(): this;
+    /**
+     * {@inheritDoc PollMediaBuilder.toJSON}
+     */
     toJSON(validationOverride?: boolean): APIPollMedia;
 }
 
@@ -8413,7 +8422,15 @@ interface PollAnswerData extends Omit<APIPollAnswer, 'answer_id' | 'poll_media'>
     poll_media: PollAnswerMediaBuilder;
 }
 declare class PollAnswerBuilder {
+    /**
+     * The API data associated with this poll answer.
+     */
     protected readonly data: PollAnswerData;
+    /**
+     * Creates a new poll answer from API data.
+     *
+     * @param data - The API data to create this poll answer with
+     */
     constructor(data?: Partial<Omit<APIPollAnswer, 'answer_id'>>);
     /**
      * Sets the media for this poll answer.
@@ -8426,7 +8443,7 @@ declare class PollAnswerBuilder {
      *
      * @param updater - The function to update the media with
      */
-    updateMedia(updater: (builder: PollAnswerMediaBuilder) => void): void;
+    updateMedia(updater: (builder: PollAnswerMediaBuilder) => void): this;
     /**
      * Serializes this builder to API-compatible JSON data.
      *
@@ -8441,6 +8458,9 @@ declare class PollAnswerBuilder {
  * A builder that creates API-compatible JSON data for a poll question.
  */
 declare class PollQuestionBuilder extends PollMediaBuilder {
+    /**
+     * {@inheritDoc PollMediaBuilder.toJSON}
+     */
     toJSON(validationOverride?: boolean): Omit<APIPollMedia, 'emoji'>;
 }
 

package/dist/index.d.ts

@@ -8169,7 +8169,7 @@ declare const pollQuestionPredicate: z.ZodObject<{
 }>;
 declare const pollAnswerMediaPredicate: z.ZodObject<{
     text: z.ZodString;
-    emoji: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+    emoji: z.ZodOptional<z.ZodEffects<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         name: z.ZodOptional<z.ZodString>;
         animated: z.ZodOptional<z.ZodBoolean>;
@@ -8189,26 +8189,26 @@ declare const pollAnswerMediaPredicate: z.ZodObject<{
         id?: string | undefined;
         name?: string | undefined;
         animated?: boolean | undefined;
-    }>>>;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     text: string;
     emoji?: {
         id?: string | undefined;
         name?: string | undefined;
         animated?: boolean | undefined;
-    } | null | undefined;
+    } | undefined;
 }, {
     text: string;
     emoji?: {
         id?: string | undefined;
         name?: string | undefined;
         animated?: boolean | undefined;
-    } | null | undefined;
+    } | undefined;
 }>;
 declare const pollAnswerPredicate: z.ZodObject<{
     poll_media: z.ZodObject<{
         text: z.ZodString;
-        emoji: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+        emoji: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             id: z.ZodOptional<z.ZodString>;
             name: z.ZodOptional<z.ZodString>;
             animated: z.ZodOptional<z.ZodBoolean>;
@@ -8228,21 +8228,21 @@ declare const pollAnswerPredicate: z.ZodObject<{
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        }>>>;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         text: string;
         emoji?: {
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        } | null | undefined;
+        } | undefined;
     }, {
         text: string;
         emoji?: {
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        } | null | undefined;
+        } | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     poll_media: {
@@ -8251,7 +8251,7 @@ declare const pollAnswerPredicate: z.ZodObject<{
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        } | null | undefined;
+        } | undefined;
     };
 }, {
     poll_media: {
@@ -8260,7 +8260,7 @@ declare const pollAnswerPredicate: z.ZodObject<{
             id?: string | undefined;
             name?: string | undefined;
             animated?: boolean | undefined;
-        } | null | undefined;
+        } | undefined;
     };
 }>;
 declare const pollPredicate: z.ZodObject<{
@@ -8274,7 +8274,7 @@ declare const pollPredicate: z.ZodObject<{
     answers: z.ZodArray<z.ZodObject<{
         poll_media: z.ZodObject<{
             text: z.ZodString;
-            emoji: z.ZodOptional<z.ZodNullable<z.ZodEffects<z.ZodObject<{
+            emoji: z.ZodOptional<z.ZodEffects<z.ZodObject<{
                 id: z.ZodOptional<z.ZodString>;
                 name: z.ZodOptional<z.ZodString>;
                 animated: z.ZodOptional<z.ZodBoolean>;
@@ -8294,21 +8294,21 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            }>>>;
+            }>>;
         }, "strip", z.ZodTypeAny, {
             text: string;
             emoji?: {
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         }, {
             text: string;
             emoji?: {
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
         poll_media: {
@@ -8317,7 +8317,7 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         };
     }, {
         poll_media: {
@@ -8326,7 +8326,7 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         };
     }>, "many">;
     duration: z.ZodOptional<z.ZodNumber>;
@@ -8343,7 +8343,7 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         };
     }[];
     duration?: number | undefined;
@@ -8360,7 +8360,7 @@ declare const pollPredicate: z.ZodObject<{
                 id?: string | undefined;
                 name?: string | undefined;
                 animated?: boolean | undefined;
-            } | null | undefined;
+            } | undefined;
         };
     }[];
     duration?: number | undefined;
@@ -8368,7 +8368,13 @@ declare const pollPredicate: z.ZodObject<{
     layout_type?: PollLayoutType | undefined;
 }>;
 
+/**
+ * The base poll media builder that contains common symbols for poll media builders.
+ */
 declare abstract class PollMediaBuilder {
+    /**
+     * The API data associated with this poll media.
+     */
     protected readonly data: Partial<APIPollMedia>;
     /**
      * Creates new poll media from API data.
@@ -8393,19 +8399,22 @@ declare abstract class PollMediaBuilder {
 }
 
 /**
- * A builder that creates API-compatible JSON data for poll answers.
+ * A builder that creates API-compatible JSON data for the media of a poll answer.
  */
 declare class PollAnswerMediaBuilder extends PollMediaBuilder {
     /**
-     * Sets the emoji for this poll answer.
+     * Sets the emoji for this poll answer media.
      *
      * @param emoji - The emoji to use
      */
     setEmoji(emoji: APIPartialEmoji): this;
     /**
-     * Clears the emoji for this poll answer.
+     * Clears the emoji for this poll answer media.
      */
     clearEmoji(): this;
+    /**
+     * {@inheritDoc PollMediaBuilder.toJSON}
+     */
     toJSON(validationOverride?: boolean): APIPollMedia;
 }
 
@@ -8413,7 +8422,15 @@ interface PollAnswerData extends Omit<APIPollAnswer, 'answer_id' | 'poll_media'>
     poll_media: PollAnswerMediaBuilder;
 }
 declare class PollAnswerBuilder {
+    /**
+     * The API data associated with this poll answer.
+     */
     protected readonly data: PollAnswerData;
+    /**
+     * Creates a new poll answer from API data.
+     *
+     * @param data - The API data to create this poll answer with
+     */
     constructor(data?: Partial<Omit<APIPollAnswer, 'answer_id'>>);
     /**
      * Sets the media for this poll answer.
@@ -8426,7 +8443,7 @@ declare class PollAnswerBuilder {
      *
      * @param updater - The function to update the media with
      */
-    updateMedia(updater: (builder: PollAnswerMediaBuilder) => void): void;
+    updateMedia(updater: (builder: PollAnswerMediaBuilder) => void): this;
     /**
      * Serializes this builder to API-compatible JSON data.
      *
@@ -8441,6 +8458,9 @@ declare class PollAnswerBuilder {
  * A builder that creates API-compatible JSON data for a poll question.
  */
 declare class PollQuestionBuilder extends PollMediaBuilder {
+    /**
+     * {@inheritDoc PollMediaBuilder.toJSON}
+     */
     toJSON(validationOverride?: boolean): Omit<APIPollMedia, 'emoji'>;
 }
 

package/dist/index.js

@@ -3086,12 +3086,12 @@ 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()
+  emoji: emojiPredicate.optional()
 });
 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),
+  answers: import_zod8.z.array(pollAnswerPredicate).min(1).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()
@@ -3102,6 +3102,9 @@ var PollMediaBuilder = class {
   static {
     __name(this, "PollMediaBuilder");
   }
+  /**
+   * The API data associated with this poll media.
+   */
   data;
   /**
    * Creates new poll media from API data.
@@ -3128,7 +3131,7 @@ var PollAnswerMediaBuilder = class extends PollMediaBuilder {
     __name(this, "PollAnswerMediaBuilder");
   }
   /**
-   * Sets the emoji for this poll answer.
+   * Sets the emoji for this poll answer media.
    *
    * @param emoji - The emoji to use
    */
@@ -3137,12 +3140,15 @@ var PollAnswerMediaBuilder = class extends PollMediaBuilder {
     return this;
   }
   /**
-   * Clears the emoji for this poll answer.
+   * Clears the emoji for this poll answer media.
    */
   clearEmoji() {
     this.data.emoji = void 0;
     return this;
   }
+  /**
+   * {@inheritDoc PollMediaBuilder.toJSON}
+   */
   toJSON(validationOverride) {
     const clone = structuredClone(this.data);
     validate(pollAnswerMediaPredicate, clone, validationOverride);
@@ -3155,7 +3161,15 @@ var PollAnswerBuilder = class {
   static {
     __name(this, "PollAnswerBuilder");
   }
+  /**
+   * The API data associated with this poll answer.
+   */
   data;
+  /**
+   * Creates a new poll answer from API data.
+   *
+   * @param data - The API data to create this poll answer with
+   */
   constructor(data = {}) {
     this.data = {
       ...structuredClone(data),
@@ -3177,7 +3191,8 @@ var PollAnswerBuilder = class {
    * @param updater - The function to update the media with
    */
   updateMedia(updater) {
-    updater(this.data.poll_media ??= new PollAnswerMediaBuilder());
+    updater(this.data.poll_media);
+    return this;
   }
   /**
    * Serializes this builder to API-compatible JSON data.
@@ -3187,10 +3202,11 @@ var PollAnswerBuilder = class {
    * @param validationOverride - Force validation to run/not run regardless of your global preference
    */
   toJSON(validationOverride) {
+    const { poll_media, ...rest } = this.data;
     const data = {
-      ...structuredClone(this.data),
+      ...structuredClone(rest),
       // Disable validation because the pollAnswerPredicate below will validate this as well
-      poll_media: this.data.poll_media?.toJSON(false)
+      poll_media: poll_media.toJSON(false)
     };
     validate(pollAnswerPredicate, data, validationOverride);
     return data;
@@ -3202,6 +3218,9 @@ var PollQuestionBuilder = class extends PollMediaBuilder {
   static {
     __name(this, "PollQuestionBuilder");
   }
+  /**
+   * {@inheritDoc PollMediaBuilder.toJSON}
+   */
   toJSON(validationOverride) {
     const clone = structuredClone(this.data);
     validate(pollQuestionPredicate, clone, validationOverride);
@@ -3329,7 +3348,7 @@ var PollBuilder = class {
    * @param updater - The function to update the question with
    */
   updateQuestion(updater) {
-    updater(this.data.question ??= new PollQuestionBuilder());
+    updater(this.data.question);
     return this;
   }
   /**
@@ -3400,7 +3419,7 @@ var PollBuilder = class {
 };
 
 // src/index.ts
-var version = "2.0.0-dev.1740746538-46be1567a";
+var version = "2.0.0-dev.1740874411-d1f56ffb2";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ActionRowBuilder,