feat: Add Modals and Text Inputs (#7023)

Co-authored-by: Vlad Frangu <kingdgrizzle@gmail.com>
Co-authored-by: Jiralite <33201955+Jiralite@users.noreply.github.com>
Co-authored-by: Ryan Munro <monbrey@gmail.com>
Co-authored-by: Vitor <milagre.vitor@gmail.com>

packages/builders/src/components/textInput/Assertions.ts

@@ -0,0 +1,17 @@
+import { TextInputStyle } from 'discord-api-types/v9';
+import { z } from 'zod';
+import { customIdValidator } from '../Assertions';
+
+export const textInputStyleValidator = z.nativeEnum(TextInputStyle);
+export const minLengthValidator = z.number().int().min(0).max(4000);
+export const maxLengthValidator = z.number().int().min(1).max(4000);
+export const requiredValidator = z.boolean();
+export const valueValidator = z.string().max(4000);
+export const placeholderValidator = z.string().max(100);
+export const labelValidator = z.string().min(1).max(45);
+
+export function validateRequiredParameters(customId?: string, style?: TextInputStyle, label?: string) {
+	customIdValidator.parse(customId);
+	textInputStyleValidator.parse(style);
+	labelValidator.parse(label);
+}

packages/builders/src/components/textInput/TextInput.ts

@@ -0,0 +1,37 @@
+import type { APITextInputComponent } from 'discord-api-types/v9';
+import {
+	maxLengthValidator,
+	minLengthValidator,
+	placeholderValidator,
+	requiredValidator,
+	valueValidator,
+	validateRequiredParameters,
+} from './Assertions';
+import { UnsafeTextInputComponent } from './UnsafeTextInput';
+
+export class TextInputComponent extends UnsafeTextInputComponent {
+	public override setMinLength(minLength: number) {
+		return super.setMinLength(minLengthValidator.parse(minLength));
+	}
+
+	public override setMaxLength(maxLength: number) {
+		return super.setMaxLength(maxLengthValidator.parse(maxLength));
+	}
+
+	public override setRequired(required = true) {
+		return super.setRequired(requiredValidator.parse(required));
+	}
+
+	public override setValue(value: string) {
+		return super.setValue(valueValidator.parse(value));
+	}
+
+	public override setPlaceholder(placeholder: string) {
+		return super.setPlaceholder(placeholderValidator.parse(placeholder));
+	}
+
+	public override toJSON(): APITextInputComponent {
+		validateRequiredParameters(this.data.custom_id, this.data.style, this.data.label);
+		return super.toJSON();
+	}
+}

packages/builders/src/components/textInput/UnsafeTextInput.ts

@@ -0,0 +1,154 @@
+import { ComponentType, type TextInputStyle, type APITextInputComponent } from 'discord-api-types/v9';
+import { Component } from '../../index';
+import isEqual from 'fast-deep-equal';
+
+export class UnsafeTextInputComponent extends Component<
+	Partial<APITextInputComponent> & { type: ComponentType.TextInput }
+> {
+	public constructor(data?: APITextInputComponent & { type?: ComponentType.TextInput }) {
+		super({ type: ComponentType.TextInput, ...data });
+	}
+
+	/**
+	 * The style of this text input
+	 */
+	public get style() {
+		return this.data.style;
+	}
+
+	/**
+	 * The custom id of this text input
+	 */
+	public get customId() {
+		return this.data.custom_id;
+	}
+
+	/**
+	 * The label for this text input
+	 */
+	public get label() {
+		return this.data.label;
+	}
+
+	/**
+	 * The placeholder text for this text input
+	 */
+	public get placeholder() {
+		return this.data.placeholder;
+	}
+
+	/**
+	 * The default value for this text input
+	 */
+	public get value() {
+		return this.data.value;
+	}
+
+	/**
+	 * The minimum length of this text input
+	 */
+	public get minLength() {
+		return this.data.min_length;
+	}
+
+	/**
+	 * The maximum length of this text input
+	 */
+	public get maxLength() {
+		return this.data.max_length;
+	}
+
+	/**
+	 * Whether this text input is required
+	 */
+	public get required() {
+		return this.data.required;
+	}
+
+	/**
+	 * Sets the custom id for this text input
+	 * @param customId The custom id of this text input
+	 */
+	public setCustomId(customId: string) {
+		this.data.custom_id = customId;
+		return this;
+	}
+
+	/**
+	 * Sets the label for this text input
+	 * @param label The label for this text input
+	 */
+	public setLabel(label: string) {
+		this.data.label = label;
+		return this;
+	}
+
+	/**
+	 * Sets the style for this text input
+	 * @param style The style for this text input
+	 */
+	public setStyle(style: TextInputStyle) {
+		this.data.style = style;
+		return this;
+	}
+
+	/**
+	 * Sets the minimum length of text for this text input
+	 * @param minLength The minimum length of text for this text input
+	 */
+	public setMinLength(minLength: number) {
+		this.data.min_length = minLength;
+		return this;
+	}
+
+	/**
+	 * Sets the maximum length of text for this text input
+	 * @param maxLength The maximum length of text for this text input
+	 */
+	public setMaxLength(maxLength: number) {
+		this.data.max_length = maxLength;
+		return this;
+	}
+
+	/**
+	 * Sets the placeholder of this text input
+	 * @param placeholder The placeholder of this text input
+	 */
+	public setPlaceholder(placeholder: string) {
+		this.data.placeholder = placeholder;
+		return this;
+	}
+
+	/**
+	 * Sets the value of this text input
+	 * @param value The value for this text input
+	 */
+	public setValue(value: string) {
+		this.data.value = value;
+		return this;
+	}
+
+	/**
+	 * Sets whether this text input is required or not
+	 * @param required Whether this text input is required or not
+	 */
+	public setRequired(required = true) {
+		this.data.required = required;
+		return this;
+	}
+
+	public toJSON(): APITextInputComponent {
+		// eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+		return {
+			...this.data,
+		} as APITextInputComponent;
+	}
+
+	public equals(other: UnsafeTextInputComponent | APITextInputComponent): boolean {
+		if (other instanceof UnsafeTextInputComponent) {
+			return isEqual(other.data, this.data);
+		}
+
+		return isEqual(other, this.data);
+	}
+}