feat: add #from for easy builder conversions

packages/discord.js/src/structures/ButtonBuilder.js

@@ -1,12 +1,24 @@
 'use strict';
 
-const { ButtonBuilder: BuildersButtonComponent } = require('@discordjs/builders');
+const { ButtonBuilder: BuildersButtonComponent, isJSONEncodable } = require('@discordjs/builders');
 const Transformers = require('../util/Transformers');
 
 class ButtonBuilder extends BuildersButtonComponent {
   constructor(data) {
     super(Transformers.toSnakeCase(data));
   }
+
+  /**
+   * Creates a new button builder from json data
+   * @param {JSONEncodable<APIButtonComponent> | APIButtonComponent} other The other data
+   * @returns {ButtonBuilder}
+   */
+  static from(other) {
+    if (isJSONEncodable(other)) {
+      return new this(other.toJSON());
+    }
+    return new this(other);
+  }
 }
 
 module.exports = ButtonBuilder;

packages/discord.js/src/structures/EmbedBuilder.js

@@ -1,12 +1,24 @@
 'use strict';
 
-const { EmbedBuilder: BuildersEmbed } = require('@discordjs/builders');
+const { EmbedBuilder: BuildersEmbed, isJSONEncodable } = require('@discordjs/builders');
 const Transformers = require('../util/Transformers');
 
 class EmbedBuilder extends BuildersEmbed {
   constructor(data) {
     super(Transformers.toSnakeCase(data));
   }
+
+  /**
+   * Creates a new embed builder from json data
+   * @param {JSONEncodable<APIEmbed> | APIEmbed} other The other data
+   * @returns {EmbedBuilder}
+   */
+  static from(other) {
+    if (isJSONEncodable(other)) {
+      return new this(other.toJSON());
+    }
+    return new this(other);
+  }
 }
 
 module.exports = EmbedBuilder;

packages/discord.js/src/structures/SelectMenuBuilder.js

@@ -1,12 +1,24 @@
 'use strict';
 
-const { SelectMenuBuilder: BuildersSelectMenuComponent } = require('@discordjs/builders');
+const { SelectMenuBuilder: BuildersSelectMenuComponent, isJSONEncodable } = require('@discordjs/builders');
 const Transformers = require('../util/Transformers');
 
 class SelectMenuBuilder extends BuildersSelectMenuComponent {
   constructor(data) {
     super(Transformers.toSnakeCase(data));
   }
+
+  /**
+   * Creates a new select menu builder from json data
+   * @param {JSONEncodable<APISelectMenuComponent> | APISelectMenuComponent} other The other data
+   * @returns {SelectMenuBuilder}
+   */
+  static from(other) {
+    if (isJSONEncodable(other)) {
+      return new this(other.toJSON());
+    }
+    return new this(other);
+  }
 }
 
 module.exports = SelectMenuBuilder;

packages/discord.js/src/structures/TextInputBuilder.js

@@ -1,12 +1,24 @@
 'use strict';
 
-const { TextInputBuilder: BuildersTextInputComponent } = require('@discordjs/builders');
+const { TextInputBuilder: BuildersTextInputComponent, isJSONEncodable } = require('@discordjs/builders');
 const Transformers = require('../util/Transformers');
 
 class TextInputBuilder extends BuildersTextInputComponent {
   constructor(data) {
     super(Transformers.toSnakeCase(data));
   }
+
+  /**
+   * Creates a new text input builder from json data
+   * @param {JSONEncodable<APITextInputComponent> | APITextInputComponent} other The other data
+   * @returns {TextInputBuilder}
+   */
+  static from(other) {
+    if (isJSONEncodable(other)) {
+      return new this(other.toJSON());
+    }
+    return new this(other);
+  }
 }
 
 module.exports = TextInputBuilder;

packages/discord.js/typings/index.d.ts

@@ -6,7 +6,6 @@ import {
   ButtonBuilder as BuilderButtonComponent,
   channelMention,
   codeBlock,
-  ComponentBuilder,
   EmbedBuilder as BuildersEmbed,
   formatEmoji,
   hideLinkEmbed,
@@ -541,16 +540,19 @@ export class ButtonComponent extends Component<APIButtonComponent> {
 
 export class ButtonBuilder extends BuilderButtonComponent {
   public constructor(data?: ButtonComponentData | (Omit<APIButtonComponent, 'type'> & { type?: ComponentType.Button }));
+  public static from(other: JSONEncodable<APIButtonComponent> | APIButtonComponent): ButtonBuilder;
 }
 
 export class SelectMenuBuilder extends BuilderSelectMenuComponent {
   public constructor(
     data?: SelectMenuComponentData | (Omit<APISelectMenuComponent, 'type'> & { type?: ComponentType.SelectMenu }),
   );
+  public static from(other: JSONEncodable<APISelectMenuComponent> | APISelectMenuComponent): SelectMenuBuilder;
 }
 
 export class TextInputBuilder extends BuilderTextInputComponent {
   public constructor(data?: TextInputComponentData | APITextInputComponent);
+  public static from(other: JSONEncodable<APITextInputComponent> | APITextInputComponent): TextInputBuilder;
 }
 
 export class TextInputComponent extends Component<APITextInputComponent> {
@@ -604,6 +606,7 @@ export interface EmbedImageData extends Omit<APIEmbedImage, 'proxy_url'> {
 export class EmbedBuilder extends BuildersEmbed {
   public constructor(data?: EmbedData | APIEmbed);
   public override setColor(color: ColorResolvable | null): this;
+  public static from(other: JSONEncodable<APIEmbed> | APIEmbed): EmbedBuilder;
 }
 
 export class Embed {

packages/discord.js/typings/index.test-d.ts

@@ -20,6 +20,8 @@ import {
   AuditLogEvent,
   ButtonStyle,
   TextInputStyle,
+  APITextInputComponent,
+  APIEmbed,
 } from 'discord-api-types/v9';
 import {
   ApplicationCommand,
@@ -113,6 +115,9 @@ import {
   EmbedBuilder,
   MessageActionRowComponent,
   SelectMenuBuilder,
+  TextInputBuilder,
+  TextInputComponent,
+  Embed,
 } from '.';
 import { expectAssignable, expectDeprecated, expectNotAssignable, expectNotType, expectType } from 'tsd';
 
@@ -1404,3 +1409,27 @@ chatInputInteraction.showModal({
     },
   ],
 });
+
+declare const selectMenuData: APISelectMenuComponent;
+SelectMenuBuilder.from(selectMenuData);
+
+declare const selectMenuComp: SelectMenuComponent;
+SelectMenuBuilder.from(selectMenuComp);
+
+declare const buttonData: APIButtonComponent;
+ButtonBuilder.from(buttonData);
+
+declare const buttonComp: ButtonComponent;
+ButtonBuilder.from(buttonComp);
+
+declare const textInputData: APITextInputComponent;
+TextInputBuilder.from(textInputData);
+
+declare const textInputComp: TextInputComponent;
+TextInputBuilder.from(textInputComp);
+
+declare const embedData: APIEmbed;
+EmbedBuilder.from(embedData);
+
+declare const embedComp: Embed;
+EmbedBuilder.from(embedComp);