feat: add file type filtering for attachment options and file uploads

discord/application_command_option.go

@@ -547,6 +547,7 @@ type ApplicationCommandOptionAttachment struct {
 	Description              string            `json:"description"`
 	DescriptionLocalizations map[Locale]string `json:"description_localizations,omitempty"`
 	Required                 bool              `json:"required,omitempty"`
+	FileTypes                []FileType        `json:"file_types,omitempty"`
 }
 
 func (o ApplicationCommandOptionAttachment) MarshalJSON() ([]byte, error) {

discord/component.go

@@ -1477,6 +1477,8 @@ type FileUploadComponent struct {
 	MaxValues int `json:"max_values,omitempty"`
 	// Required specifies whether the file upload is required. (default: false)
 	Required bool `json:"required"`
+	// FileTypes is the file types to filter for. (default: allows all file types, max: 10)
+	FileTypes []FileType `json:"file_types,omitempty"`
 	// Values is only set when the FileUploadComponent is received from an InteractionTypeModalSubmit
 	Values []snowflake.ID `json:"values,omitempty"`
 }
@@ -1538,6 +1540,12 @@ func (f FileUploadComponent) WithRequired(required bool) FileUploadComponent {
 	return f
 }
 
+// WithFileTypes returns a new FileUploadComponent with the provided fileTypes
+func (f FileUploadComponent) WithFileTypes(fileTypes ...FileType) FileUploadComponent {
+	f.FileTypes = fileTypes
+	return f
+}
+
 var (
 	_ Component            = (*RadioGroupComponent)(nil)
 	_ InteractiveComponent = (*RadioGroupComponent)(nil)

discord/file_type.go

@@ -0,0 +1,49 @@
+package discord
+
+import (
+	"fmt"
+	"regexp"
+)
+
+// MaxFileTypes is the maximum number of file types that can be filtered for at once.
+// https://docs.discord.com/developers/reference#file-type-filtering
+const MaxFileTypes = 10
+
+var fileTypeExtensionPattern = regexp.MustCompile(`^\.[\w](?:[\w.-]*[\w])?$`)
+
+// NewFileType creates a new [FileType] for a custom file extension, e.g. NewFileType(".pdf").
+// The extension must be dot-prefixed and only contain latin letters, digits, dashes or dots.
+// Use the FileTypeGroupImage, FileTypeGroupVideo or FileTypeGroupAudio constants for the preset file groups.
+func NewFileType(extension string) (FileType, error) {
+	if !fileTypeExtensionPattern.MatchString(extension) {
+		return "", fmt.Errorf(`file type extension %q must be dot-prefixed (e.g. ".pdf") and only contain latin letters, digits, dashes or dots`, extension)
+	}
+	return FileType(extension), nil
+}
+
+// MustNewFileType creates a new [FileType], panicking instead of returning an error if the extension is invalid.
+func MustNewFileType(extension string) FileType {
+	fileType, err := NewFileType(extension)
+	if err != nil {
+		panic(err)
+	}
+	return fileType
+}
+
+// FileType represents a type of file to filter for in FileUploadComponents and ApplicationCommandOptionAttachment.
+// It can be a preset group like FileTypeGroupImage, FileTypeGroupVideo or FileTypeGroupAudio, or a custom file extension like ".pdf".
+// File types only match against the file extension, Discord does not validate the actual content of the file.
+// Up to [MaxFileTypes] file types can be specified.
+// https://docs.discord.com/developers/reference#file-type-filtering
+type FileType string
+
+// Preset FileType groups.
+const (
+	FileTypeGroupImage FileType = "image"
+	FileTypeGroupVideo FileType = "video"
+	FileTypeGroupAudio FileType = "audio"
+)
+
+func (t FileType) String() string {
+	return string(t)
+}