📁 Added File Input element.

src/elements/file-input.ts

@@ -0,0 +1,44 @@
+import { ElementBuilderBase } from '../internal/base';
+import { ElementType } from '../internal/constants';
+import { SlackElementDto } from '../internal/dto';
+import { applyMixins } from '../internal/helpers';
+import {
+  ActionId,
+  Filetypes,
+  MaxFiles,
+  End,
+} from '../internal/methods';
+
+export interface FileInputParams {
+  actionId?: string;
+  filetypes?: string[];
+  maxFiles?: number;
+}
+
+export interface FileInputBuilder extends ActionId,
+  Filetypes,
+  MaxFiles,
+  End {
+}
+
+/**
+ * @@link https://api.slack.com/reference/block-kit/block-elements#file_input
+ * @@displayName File Input Builder
+ */
+
+export class FileInputBuilder extends ElementBuilderBase {
+  /** @internal */
+
+  public build(): Readonly<SlackElementDto> {
+    return this.getResult(SlackElementDto, {
+      type: ElementType.FileInput,
+    });
+  }
+}
+
+applyMixins(FileInputBuilder, [
+  ActionId,
+  Filetypes,
+  MaxFiles,
+  End,
+]);

src/elements/index.ts

@@ -22,6 +22,7 @@ import { TimePickerBuilder, TimePickerParams } from './timepicker';
 import { URLInputBuilder, URLInputParams } from './url-input';
 import { UserMultiSelectBuilder, UserMultiSelectParams } from './user-multi-select';
 import { UserSelectBuilder, UserSelectParams } from './user-select';
+import { FileInputBuilder, FileInputParams } from './file-input';
 
 export type {
   ButtonBuilder,
@@ -68,6 +69,8 @@ export type {
   UserMultiSelectParams,
   UserSelectBuilder,
   UserSelectParams,
+  FileInputBuilder,
+  FileInputParams,
 };
 
 /**
@@ -229,6 +232,18 @@ export function Img(params?: ImgParams): ImgBuilder {
   return new ImgBuilder(params);
 }
 
+/**
+ * @param {Object} [params] Parameters passed to the constructor.
+ * @param {string} [params.filetypes] Sets the accepted filetypes.
+ * @param {string} [params.maxFiles] Sets the maximum number of files to upload.
+ *
+ * {@link https://api.slack.com/reference/block-kit/block-elements#file_input|View in Slack API Documentation}
+ */
+
+export function FileInput(params?: FileInputParams): FileInputBuilder {
+  return new FileInputBuilder(params);
+}
+
 /**
  * @param {Object} [params] Parameters passed to the constructor.
  * @param {string} [params.actionId] Sets a string to be an identifier for the source of an action in interaction payloads.
@@ -382,6 +397,7 @@ const elements = {
   URLInput,
   UserMultiSelect,
   UserSelect,
+  FileInput,
 };
 
 // Strange export. I know. For IDE highlighting purposes.

src/internal/constants/element-types.ts

@@ -21,4 +21,5 @@ export enum ElementType {
   URLInput = 'url_text_input',
   EmailInput = 'email_text_input',
   NumberInput = 'number_input',
+  FileInput = 'file_input',
 }

src/internal/constants/props.ts

@@ -87,4 +87,6 @@ export enum Prop {
   TitleUrl = 'titleUrl',
   ThumbnailUrl = 'thumbnailUrl',
   VideoUrl = 'videoUrl',
+  MaxFiles = 'maxFiles',
+  Filetypes = 'filetypes',
 }

src/internal/dto/slack-dto.ts

@@ -85,6 +85,8 @@ export enum Param {
   videoUrl = 'video_url',
   minValue = 'min_value',
   maxValue = 'max_value',
+  maxFiles = 'max_files',
+  filetypes = 'filetypes',
 }
 
 export class SlackDto implements ObjectLiteral {

src/internal/methods/set-methods.ts

@@ -769,3 +769,35 @@ export abstract class VideoUrl extends Builder {
     return this.set(videoUrl, Prop.VideoUrl);
   }
 }
+
+export abstract class MaxFiles extends Builder {
+  /**
+   * @description Maximum number of files that can be uploaded for this file_input element. Minimum of 1, maximum of 10. Defaults to 10 if not specified.
+   *
+   * {@link https://api.slack.com/block-kit|Open Official Slack Block Kit Documentation}
+   * {@link https://www.blockbuilder.dev|Open Block Builder Documentation}
+   */
+
+  public maxFiles(maxFiles:Settable<number> = 10): this {
+    return this.set(maxFiles, Prop.MaxFiles);
+  }
+}
+
+export abstract class Filetypes extends Builder {
+  /**
+   * @description An array of valid file extensions that will be accepted for this element. All file extensions will be accepted if filetypes is not specified.
+   *
+   * **Slack Validation Rules and Tips:**
+   *    * **Required if the text property is undefined** ⚠
+   *    * Maximum of 10 items.
+   *    * Maximum of 2000 characters for each field.
+   *    * Markdown supported.
+   *
+   * {@link https://api.slack.com/block-kit|Open Official Slack Block Kit Documentation}
+   * {@link https://www.blockbuilder.dev|Open Block Builder Documentation}
+   */
+
+  public filetypes(filetypes:Settable<string[]> = []): this {
+    return this.set(filetypes.flat(), Prop.Filetypes);
+  }
+}

src/internal/types/index.ts

@@ -8,6 +8,7 @@ import type {
   DatePickerBuilder, DateTimePickerBuilder,
   ExternalMultiSelectBuilder,
   ExternalSelectBuilder,
+  FileInputBuilder,
   ImgBuilder,
   OverflowMenuBuilder,
   RadioButtonsBuilder,
@@ -83,7 +84,8 @@ export type InputElementBuilder =
   | TimePickerBuilder
   | URLInputBuilder
   | UserMultiSelectBuilder
-  | UserSelectBuilder;
+  | UserSelectBuilder
+  | FileInputBuilder;
 
 export type ContextElement = ImgBuilder | string;
 

tests/elements/file-input.spec.ts

@@ -0,0 +1,23 @@
+import { FileInputBuilder as Class } from '../../src/elements/file-input';
+import { SlackElementDto as DtoClass } from '../../src/internal';
+import { params } from './mocks/file-input.mock';
+import * as methods from '../methods';
+import { testCompositeBuilderClass } from '../test-composite-builder-class';
+
+const className = 'FileInput';
+const category = 'Elements';
+
+const config = {
+  Class,
+  DtoClass,
+  params,
+  className,
+  category,
+};
+
+const methodsConfig = [
+  methods.filetypes,
+  methods.maxFiles,
+];
+
+testCompositeBuilderClass({ config, methods: methodsConfig });

tests/elements/mocks/file-input.mock.ts

@@ -0,0 +1,9 @@
+import { FileInputBuilder } from '../../../src/elements/file-input';
+
+export const params = {
+  actionId: 'actionId',
+  filetypes: 'filetypes',
+  maxFiles: 'maxFiles',
+};
+
+export const mock = new FileInputBuilder(params);

tests/elements/mocks/index.ts

@@ -20,3 +20,4 @@ export * as TimePicker from './time-picker.mock';
 export * as URLInput from './url-input.mock';
 export * as UserMultiSelect from './user-multiselect.mock';
 export * as UserSelect from './user-select.mock';
+export * as FileInput from './file-input.mock';

tests/methods/filetypes.ts

@@ -0,0 +1,19 @@
+import { CompositeBuilderClassConfig } from '../test-config-types';
+import { Prop } from '../../src/internal/constants';
+import { methodArgMocks } from '../mocks/method-arg-mocks';
+import { SlackDto } from '../../src/internal';
+import * as checks from '../checks';
+
+export const filetypes = (params: CompositeBuilderClassConfig): void => {
+  const config = {
+    ...params,
+    methodArgMock: methodArgMocks.filetypes,
+    methodName: Prop.Filetypes,
+    propSetterPropName: Prop.Filetypes,
+    slackDtoParamName: SlackDto.mapParam(Prop.Filetypes),
+    expectArray: true,
+  };
+
+  checks.settableProperty(config);
+  checks.literalBuild(config);
+};

tests/methods/index.ts

@@ -82,3 +82,5 @@ export * from './ts';
 export * from './url';
 export * from './value';
 export * from './video-url';
+export * from './max-files';
+export * from './filetypes';

tests/methods/max-files.ts

@@ -0,0 +1,18 @@
+import { CompositeBuilderClassConfig } from '../test-config-types';
+import { Prop } from '../../src/internal/constants';
+import { methodArgMocks } from '../mocks/method-arg-mocks';
+import { SlackDto } from '../../src/internal';
+import * as checks from '../checks';
+
+export const maxFiles = (params: CompositeBuilderClassConfig): void => {
+  const config = {
+    ...params,
+    methodArgMock: methodArgMocks.maxFiles,
+    methodName: Prop.MaxFiles,
+    propSetterPropName: Prop.MaxFiles,
+    slackDtoParamName: SlackDto.mapParam(Prop.MaxFiles),
+  };
+
+  checks.settableProperty(config);
+  checks.literalBuild(config);
+};

tests/mocks/method-arg-mocks.ts

@@ -85,4 +85,6 @@ export const methodArgMocks = {
   titleUrl: methodArgMocksByType.string,
   thumbnailUrl: methodArgMocksByType.string,
   videoUrl: methodArgMocksByType.string,
+  maxFiles: methodArgMocksByType.int,
+  filetypes: methodArgMocksByType.arrayStrings,
 };