Add support for file upload components

Author: mkrasnitski

src/builder/create_components.rs

@@ -523,6 +523,16 @@ impl<'a> CreateLabel<'a> {
         }
     }
 
+    /// Create a file upload with a specific label.
+    pub fn file_upload(label: impl Into<Cow<'a, str>>, file_upload: CreateFileUpload<'a>) -> Self {
+        Self {
+            kind: ComponentType::Label,
+            label: label.into(),
+            description: None,
+            component: CreateLabelComponent::FileUpload(file_upload),
+        }
+    }
+
     /// Sets the description of this component, which will display underneath the label text.
     pub fn description(mut self, description: impl Into<Cow<'a, str>>) -> Self {
         self.description = Some(description.into());
@@ -537,6 +547,53 @@ impl<'a> CreateLabel<'a> {
 enum CreateLabelComponent<'a> {
     SelectMenu(CreateSelectMenu<'a>),
     InputText(CreateInputText<'a>),
+    FileUpload(CreateFileUpload<'a>),
+}
+
+/// A builder for creating a file upload in a modal.
+///
+/// [Discord docs](https://discord.com/developers/docs/components/reference#file-upload).
+#[derive(Clone, Debug, Serialize)]
+#[must_use]
+pub struct CreateFileUpload<'a> {
+    #[serde(rename = "type")]
+    kind: ComponentType,
+    custom_id: Cow<'a, str>,
+    min_values: u8,
+    max_values: u8,
+    required: bool,
+}
+
+impl<'a> CreateFileUpload<'a> {
+    /// Creates a builder with the given custom id.
+    pub fn new(custom_id: impl Into<Cow<'a, str>>) -> Self {
+        Self {
+            kind: ComponentType::FileUpload,
+            custom_id: custom_id.into(),
+            min_values: 1,
+            max_values: 1,
+            required: true,
+        }
+    }
+
+    /// The minimum number of files that must be uploaded. Must be a number from 0 through 10, and
+    /// defaults to 1.
+    pub fn min_values(mut self, min_values: u8) -> Self {
+        self.min_values = min_values;
+        self
+    }
+
+    /// The maximum number of files that can be uploaded. Defaults to 1, but can be at most 10.
+    pub fn max_values(mut self, max_values: u8) -> Self {
+        self.max_values = max_values;
+        self
+    }
+
+    // Whether the file upload is required.
+    pub fn required(mut self, required: bool) -> Self {
+        self.required = required;
+        self
+    }
 }
 
 enum_number! {

src/model/application/command_interaction.rs

@@ -240,9 +240,10 @@ pub struct CommandData {
     /// The application command type of the triggered application command.
     #[serde(rename = "type")]
     pub kind: CommandType,
-    /// The parameters and the given values. The converted objects from the given options.
+    /// The converted objects from the given options.
     #[serde(default)]
     pub resolved: CommandDataResolved,
+    /// The parameters and the given values.
     #[serde(default)]
     pub options: FixedArray<CommandDataOption>,
     /// The Id of the guild the command is registered to.

src/model/application/component.rs

@@ -28,6 +28,7 @@ enum_number! {
         Separator = 14,
         Container = 17,
         Label = 18,
+        FileUpload = 19,
         _ => Unknown(u8),
     }
 }
@@ -299,6 +300,7 @@ pub struct Label {
 pub enum LabelComponent {
     SelectMenu(SelectMenu),
     InputText(InputText),
+    FileUpload(FileUpload),
 }
 
 impl<'de> Deserialize<'de> for LabelComponent {
@@ -323,6 +325,9 @@ impl<'de> Deserialize<'de> for LabelComponent {
             ComponentType::InputText => {
                 Deserialize::deserialize(raw_data).map(LabelComponent::InputText)
             },
+            ComponentType::FileUpload => {
+                Deserialize::deserialize(raw_data).map(LabelComponent::FileUpload)
+            },
             ComponentType(i) => {
                 return Err(DeError::custom(format_args!("Unknown component type {i}")));
             },
@@ -331,6 +336,20 @@ impl<'de> Deserialize<'de> for LabelComponent {
     }
 }
 
+/// An interactive component that allows users to upload files in modals.
+#[derive(Clone, Debug, Deserialize, Serialize)]
+#[cfg_attr(feature = "typesize", derive(typesize::derive::TypeSize))]
+#[non_exhaustive]
+pub struct FileUpload {
+    /// Always [`ComponentType::FileUpload`]
+    #[serde(rename = "type")]
+    pub kind: ComponentType,
+    /// Developer-defined identifier for the file upload; max 100 characters
+    pub custom_id: FixedString,
+    /// IDs of the uploaded files found in [`ModalInteractionData::resolved`].
+    pub values: FixedArray<AttachmentId>,
+}
+
 /// An action row.
 ///
 /// [Discord docs](https://discord.com/developers/docs/components/reference#action-row).

src/model/application/component_interaction.rs

@@ -315,7 +315,7 @@ pub struct ComponentInteractionData {
     /// Type and type-specific data of this component interaction.
     #[serde(flatten)]
     pub kind: ComponentInteractionDataKind,
-    /// The parameters and the given values. The converted objects from the given options.
+    /// The resolved entities from the selected options.
     #[serde(default)]
     pub resolved: CommandDataResolved,
 }

src/model/application/modal_interaction.rs

@@ -216,4 +216,7 @@ pub struct ModalInteractionData {
     pub custom_id: FixedString,
     /// The components.
     pub components: FixedArray<Component>,
+    /// The resolved entities from the selected options.
+    #[serde(default)]
+    pub resolved: CommandDataResolved,
 }