From f20c2b73000f61e5256d04ca184ac10db0a4e037 Mon Sep 17 00:00:00 2001
From: Fleny <Fleny113@outlook.com>
Date: Fri, 14 Aug 2026 18:49:09 +0200
Subject: [PATCH] feat: Add file type filtering for modals & / commands (#5236)

* feat: Add file type filtering for modals & / commands

* Add fileTypes to ApplicationCommandOption

* update comments

---------

Co-authored-by: Awesome Stickz <38146668+AwesomeStickz@users.noreply.github.com>
---
 packages/bot/src/desiredProperties.ts         |  1 +
 .../transformers/applicationCommandOption.ts  |  1 +
 packages/bot/src/transformers/component.ts    |  1 +
 packages/bot/src/transformers/types.ts        | 36 +++++++++++++++++++
 packages/types/src/discord/components.ts      | 18 ++++++++++
 packages/types/src/discord/interactions.ts    | 20 +++++++++++
 packages/types/src/discordeno/components.ts   | 18 ++++++++++
 7 files changed, 95 insertions(+)

diff --git a/packages/bot/src/desiredProperties.ts b/packages/bot/src/desiredProperties.ts
index a06acbc8b..bf6c59577 100644
--- a/packages/bot/src/desiredProperties.ts
+++ b/packages/bot/src/desiredProperties.ts
@@ -368,6 +368,7 @@ export function createDesiredPropertiesObject<T extends RecursivePartial<Transfo
       component: defaultValue,
       values: defaultValue,
       resolved: defaultValue,
+      fileTypes: defaultValue,
       ...desiredProperties.component,
     },
     forumTag: {
diff --git a/packages/bot/src/transformers/applicationCommandOption.ts b/packages/bot/src/transformers/applicationCommandOption.ts
index 76c7d9b58..0105d25cd 100644
--- a/packages/bot/src/transformers/applicationCommandOption.ts
+++ b/packages/bot/src/transformers/applicationCommandOption.ts
@@ -18,6 +18,7 @@ export function transformApplicationCommandOption(bot: Bot, payload: DiscordAppl
     minLength: payload.min_length,
     maxLength: payload.max_length,
     options: payload.options?.map((option) => bot.transformers.applicationCommandOption(bot, option)),
+    fileTypes: payload.file_types,
   } as ApplicationCommandOption;
 
   return bot.transformers.customizers.applicationCommandOption(bot, payload, applicationCommandOption);
diff --git a/packages/bot/src/transformers/component.ts b/packages/bot/src/transformers/component.ts
index e8c509919..e614ca459 100644
--- a/packages/bot/src/transformers/component.ts
+++ b/packages/bot/src/transformers/component.ts
@@ -493,6 +493,7 @@ function transformFileUploadComponent(bot: Bot, payload: Partial<DiscordFileUplo
     if (props.minValues && _payload.min_values) fileUpload.minValues = _payload.min_values;
     if (props.maxValues && _payload.max_values) fileUpload.maxValues = _payload.max_values;
     if (props.required && _payload.required) fileUpload.required = _payload.required;
+    if (props.fileTypes && _payload.file_types) fileUpload.fileTypes = _payload.file_types;
   }
 
   return fileUpload;
diff --git a/packages/bot/src/transformers/types.ts b/packages/bot/src/transformers/types.ts
index 835fceeeb..94055655d 100644
--- a/packages/bot/src/transformers/types.ts
+++ b/packages/bot/src/transformers/types.ts
@@ -279,6 +279,24 @@ export interface ApplicationCommandOption {
   maxLength?: number;
   /** if autocomplete interactions are enabled for this `String`, `Integer`, or `Number` type option */
   autocomplete?: boolean;
+  /**
+   * The accepted file types for the file upload
+   *
+   * @remarks
+   * The supported values are `image`, `video`, `audio` or any dot prefixed extension (e.g. `.pdf`)
+   *
+   * Extensions are case-insensitive and are normalized to lowercase, so `.PDF` and `.pdf` are equivalent.
+   *
+   * Discord recommends using the provided file groups rather than listing extensions individually.
+   * If you do list extensions individually, include `.jpg` for image uploads and both `.mp4` and `.mov` for video uploads,
+   * as some mobile clients rely on those extensions.
+   *
+   * This feature only checks the file extension against the filename and does not inspect the file contents.
+   * You are still responsible for validating the actual contents of the file.
+   *
+   * Up to 10 file types.
+   */
+  fileTypes?: string[];
 }
 
 export interface ApplicationCommandOptionChoice {
@@ -690,6 +708,24 @@ export interface Component {
   default?: boolean;
   /** Resolved entities from selected options */
   resolved?: InteractionDataResolved;
+  /**
+   * The accepted file types for the file upload
+   *
+   * @remarks
+   * The supported values are `image`, `video`, `audio` or any dot prefixed extension (e.g. `.pdf`)
+   *
+   * Extensions are case-insensitive and are normalized to lowercase, so `.PDF` and `.pdf` are equivalent.
+   *
+   * Discord recommends using the provided file groups rather than listing extensions individually.
+   * If you do list extensions individually, include `.jpg` for image uploads and both `.mp4` and `.mov` for video uploads,
+   * as some mobile clients rely on those extensions.
+   *
+   * This feature only checks the file extension against the filename and does not inspect the file contents.
+   * You are still responsible for validating the actual contents of the file.
+   *
+   * Up to 10 file types.
+   */
+  fileTypes?: string[];
 }
 
 export interface UnfurledMediaItem {
diff --git a/packages/types/src/discord/components.ts b/packages/types/src/discord/components.ts
index c16d10bc5..a1b5f3e96 100644
--- a/packages/types/src/discord/components.ts
+++ b/packages/types/src/discord/components.ts
@@ -818,6 +818,24 @@ export interface DiscordFileUploadComponent extends DiscordBaseComponent {
    * @default true
    */
   required?: boolean;
+  /**
+   * The accepted file types for the file upload
+   *
+   * @remarks
+   * The supported values are `image`, `video`, `audio` or any dot prefixed extension (e.g. `.pdf`)
+   *
+   * Extensions are case-insensitive and are normalized to lowercase, so `.PDF` and `.pdf` are equivalent.
+   *
+   * Discord recommends using the provided file groups rather than listing extensions individually.
+   * If you do list extensions individually, include `.jpg` for image uploads and both `.mp4` and `.mov` for video uploads,
+   * as some mobile clients rely on those extensions.
+   *
+   * This feature only checks the file extension against the filename and does not inspect the file contents.
+   * You are still responsible for validating the actual contents of the file.
+   *
+   * Up to 10 file types.
+   */
+  file_types?: string[];
 }
 
 /** https://docs.discord.com/developers/components/reference#file-upload-file-upload-interaction-response-structure */
diff --git a/packages/types/src/discord/interactions.ts b/packages/types/src/discord/interactions.ts
index da23166df..d445c80bd 100644
--- a/packages/types/src/discord/interactions.ts
+++ b/packages/types/src/discord/interactions.ts
@@ -456,6 +456,26 @@ export interface DiscordApplicationCommandOption {
    * When {@link DiscordApplicationCommandOption.choices | choices} are provided, this may not be set to true
    */
   autocomplete?: boolean;
+  /**
+   * The accepted file types for the file upload
+   *
+   * @remarks
+   * The supported values are `image`, `video`, `audio` or any dot prefixed extension (e.g. `.pdf`)
+   *
+   * Extensions are case-insensitive and are normalized to lowercase, so `.PDF` and `.pdf` are equivalent.
+   *
+   * Discord recommends using the provided file groups rather than listing extensions individually.
+   * If you do list extensions individually, include `.jpg` for image uploads and both `.mp4` and `.mov` for video uploads,
+   * as some mobile clients rely on those extensions.
+   *
+   * This feature only checks the file extension against the filename and does not inspect the file contents.
+   * You are still responsible for validating the actual contents of the file.
+   *
+   * Up to 10 file types.
+   *
+   * Only valid in options of type {@link ApplicationCommandOptionTypes.Attachment | Attachment}
+   */
+  file_types?: string[];
 }
 
 /** https://docs.discord.com/developers/interactions/application-commands#application-command-object-application-command-option-type */
diff --git a/packages/types/src/discordeno/components.ts b/packages/types/src/discordeno/components.ts
index 95f67853d..cea8935a6 100644
--- a/packages/types/src/discordeno/components.ts
+++ b/packages/types/src/discordeno/components.ts
@@ -474,6 +474,24 @@ export interface FileUploadComponent extends BaseComponent {
    * @default true
    */
   required?: boolean;
+  /**
+   * The accepted file types for the file upload
+   *
+   * @remarks
+   * The supported values are `image`, `video`, `audio` or any dot prefixed extension (e.g. `.pdf`)
+   *
+   * Extensions are case-insensitive and are normalized to lowercase, so `.PDF` and `.pdf` are equivalent.
+   *
+   * Discord recommends using the provided file groups rather than listing extensions individually.
+   * If you do list extensions individually, include `.jpg` for image uploads and both `.mp4` and `.mov` for video uploads,
+   * as some mobile clients rely on those extensions.
+   *
+   * This feature only checks the file extension against the filename and does not inspect the file contents.
+   * You are still responsible for validating the actual contents of the file.
+   *
+   * Up to 10 file types.
+   */
+  fileTypes?: string[];
 }
 
 /** https://docs.discord.com/developers/components/reference#radio-group-structure */