@magicyan/discord 1.6.0 → 1.6.1

package/dist/functions/components/modal.cjs

@@ -6,7 +6,18 @@ const discord_js = require('discord.js');
 function modalFieldsToRecord(data, parse) {
   const collection = "fields" in data ? "fields" in data.fields ? data.fields.fields : data.fields : data;
   const record = collection.reduce((acc, data2) => {
-    acc[data2.customId] = data2.type === discord_js.ComponentType.TextInput ? data2.value : Array.from(data2.values ?? []);
+    if (data2.type === discord_js.ComponentType.TextInput) {
+      acc[data2.customId] = data2.value;
+      return acc;
+    }
+    if (data2.type === discord_js.ComponentType.FileUpload) {
+      const attachments = data2.attachments;
+      acc[data2.customId] = Array.from(
+        attachments.mapValues((data3) => data3.url).values()
+      );
+      return acc;
+    }
+    acc[data2.customId] = Array.from(data2.values ?? []);
     return acc;
   }, {});
   return parse ? parse(record) : record;

package/dist/functions/components/modal.mjs

@@ -4,7 +4,18 @@ import { ComponentType } from 'discord.js';
 function modalFieldsToRecord(data, parse) {
   const collection = "fields" in data ? "fields" in data.fields ? data.fields.fields : data.fields : data;
   const record = collection.reduce((acc, data2) => {
-    acc[data2.customId] = data2.type === ComponentType.TextInput ? data2.value : Array.from(data2.values ?? []);
+    if (data2.type === ComponentType.TextInput) {
+      acc[data2.customId] = data2.value;
+      return acc;
+    }
+    if (data2.type === ComponentType.FileUpload) {
+      const attachments = data2.attachments;
+      acc[data2.customId] = Array.from(
+        attachments.mapValues((data3) => data3.url).values()
+      );
+      return acc;
+    }
+    acc[data2.customId] = Array.from(data2.values ?? []);
     return acc;
   }, {});
   return parse ? parse(record) : record;

package/dist/functions/components/upload.cjs

@@ -0,0 +1,19 @@
+'use strict';
+
+const discord_js = require('discord.js');
+
+function createFileUpload(arg) {
+  if (typeof arg === "string")
+    return new discord_js.FileUploadBuilder({
+      custom_id: arg
+    });
+  const { customId, maxValues, minValues, ...data } = arg;
+  return new discord_js.FileUploadBuilder({
+    custom_id: customId,
+    max_values: maxValues,
+    min_values: minValues,
+    ...data
+  });
+}
+
+exports.createFileUpload = createFileUpload;

package/dist/functions/components/upload.mjs

@@ -0,0 +1,17 @@
+import { FileUploadBuilder } from 'discord.js';
+
+function createFileUpload(arg) {
+  if (typeof arg === "string")
+    return new FileUploadBuilder({
+      custom_id: arg
+    });
+  const { customId, maxValues, minValues, ...data } = arg;
+  return new FileUploadBuilder({
+    custom_id: customId,
+    max_values: maxValues,
+    min_values: minValues,
+    ...data
+  });
+}
+
+export { createFileUpload };

package/dist/index.cjs

@@ -27,6 +27,7 @@ const separator$1 = require('./functions/components/separator.cjs');
 const text = require('./functions/components/text.cjs');
 const thumbarea = require('./functions/components/thumbarea.cjs');
 const thumbnail = require('./functions/components/thumbnail.cjs');
+const upload = require('./functions/components/upload.cjs');
 const assets = require('./functions/embeds/assets.cjs');
 const author = require('./functions/embeds/author.cjs');
 const embedplus = require('./functions/embeds/embedplus.cjs');
@@ -84,6 +85,7 @@ exports.createSeparator = separator$1.createSeparator;
 exports.createTextDisplay = text.createTextDisplay;
 exports.createThumbArea = thumbarea.createThumbArea;
 exports.createThumbnail = thumbnail.createThumbnail;
+exports.createFileUpload = upload.createFileUpload;
 exports.createEmbedAsset = assets.createEmbedAsset;
 exports.createEmbedAuthor = author.createEmbedAuthor;
 exports.EmbedPlusBuilder = embedplus.EmbedPlusBuilder;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -437,8 +437,38 @@ type ResolveModalData = {
     fields: Collection<string, ModalData>;
 } | Collection<string, ModalData>;
 type ModalFieldsRecord = Record<string, string | string[]>;
-declare function modalFieldsToRecord<T = ModalFieldsRecord>(data: ResolveModalData): ModalFieldsRecord;
-declare function modalFieldsToRecord<T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
+/**
+ * Converts modal submitted fields into a plain record object, mapping each component `customId` to its value.
+ *
+ * This function supports multiple modal submission data shapes coming from Discord.js,
+ * automatically extracting and normalizing values from:
+ * - Text input fields (`ComponentType.TextInput`) → string
+ * - Select menus & other multi-value components → string[]
+ * - File upload fields (`ComponentType.FileUpload`) → string[] of attachment URLs
+ *
+ * Optionally, a parser callback may be provided to transform the resulting record before returning it.
+ *
+ * @template T The expected return type after optional parsing.
+ * @param {ResolveModalData} data - The modal submission data, usually from an interaction.
+ * @param {(record: ModalFieldsRecord) => T} [parse] - Optional transform function applied to the resulting record.
+ * @returns {ModalFieldsRecord | T} The processed fields as a record, or the parser result if provided.
+ *
+ * @example
+ * ```ts
+ * const fields = modalFieldsToRecord(interaction.fields);
+ * console.log(fields.username); // "JohnDoe"
+ * ```
+ *
+ * @example With parsing
+ * ```ts
+ * const result = modalFieldsToRecord(interaction.fields, fields => ({
+ *   name: fields.username.trim(),
+ *   age: Number.parseInt(fields.age),
+ * }));
+ * ```
+ */
+declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData): T;
+declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
 type ModalFields = (LabelComponentData | TextDisplayComponentData)[];
 declare function createModalFields(...components: ModalComponents[]): ModalFields;
 
@@ -688,6 +718,16 @@ type ThumbAreaData = {
 declare function createThumbArea(content: string, thumbnail?: ThumbAreaThumbnail): SectionBuilder | TextDisplayBuilder;
 declare function createThumbArea(data: ThumbAreaData): SectionBuilder | TextDisplayBuilder;
 
+interface FileUploadData {
+    customId?: string;
+    minValues?: number;
+    maxValues?: number;
+    required?: boolean;
+    id?: number;
+}
+declare function createFileUpload(data: FileUploadData): FileUploadBuilder;
+declare function createFileUpload(customId: string): FileUploadBuilder;
+
 type EmbedPlusAssetData = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
 type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
 declare function createEmbedAsset(source: EmbedPlusAssetData, options?: EmbedAssetOptions): EmbedAssetData | undefined;
@@ -1095,5 +1135,5 @@ declare function isTextInputBuilder(value: unknown): value is TextInputBuilder;
  */
 declare function isMessage(value: unknown): value is Message;
 
-export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
-export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };
+export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
+export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -437,8 +437,38 @@ type ResolveModalData = {
     fields: Collection<string, ModalData>;
 } | Collection<string, ModalData>;
 type ModalFieldsRecord = Record<string, string | string[]>;
-declare function modalFieldsToRecord<T = ModalFieldsRecord>(data: ResolveModalData): ModalFieldsRecord;
-declare function modalFieldsToRecord<T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
+/**
+ * Converts modal submitted fields into a plain record object, mapping each component `customId` to its value.
+ *
+ * This function supports multiple modal submission data shapes coming from Discord.js,
+ * automatically extracting and normalizing values from:
+ * - Text input fields (`ComponentType.TextInput`) → string
+ * - Select menus & other multi-value components → string[]
+ * - File upload fields (`ComponentType.FileUpload`) → string[] of attachment URLs
+ *
+ * Optionally, a parser callback may be provided to transform the resulting record before returning it.
+ *
+ * @template T The expected return type after optional parsing.
+ * @param {ResolveModalData} data - The modal submission data, usually from an interaction.
+ * @param {(record: ModalFieldsRecord) => T} [parse] - Optional transform function applied to the resulting record.
+ * @returns {ModalFieldsRecord | T} The processed fields as a record, or the parser result if provided.
+ *
+ * @example
+ * ```ts
+ * const fields = modalFieldsToRecord(interaction.fields);
+ * console.log(fields.username); // "JohnDoe"
+ * ```
+ *
+ * @example With parsing
+ * ```ts
+ * const result = modalFieldsToRecord(interaction.fields, fields => ({
+ *   name: fields.username.trim(),
+ *   age: Number.parseInt(fields.age),
+ * }));
+ * ```
+ */
+declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData): T;
+declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
 type ModalFields = (LabelComponentData | TextDisplayComponentData)[];
 declare function createModalFields(...components: ModalComponents[]): ModalFields;
 
@@ -688,6 +718,16 @@ type ThumbAreaData = {
 declare function createThumbArea(content: string, thumbnail?: ThumbAreaThumbnail): SectionBuilder | TextDisplayBuilder;
 declare function createThumbArea(data: ThumbAreaData): SectionBuilder | TextDisplayBuilder;
 
+interface FileUploadData {
+    customId?: string;
+    minValues?: number;
+    maxValues?: number;
+    required?: boolean;
+    id?: number;
+}
+declare function createFileUpload(data: FileUploadData): FileUploadBuilder;
+declare function createFileUpload(customId: string): FileUploadBuilder;
+
 type EmbedPlusAssetData = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
 type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
 declare function createEmbedAsset(source: EmbedPlusAssetData, options?: EmbedAssetOptions): EmbedAssetData | undefined;
@@ -1095,5 +1135,5 @@ declare function isTextInputBuilder(value: unknown): value is TextInputBuilder;
  */
 declare function isMessage(value: unknown): value is Message;
 
-export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
-export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };
+export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
+export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -437,8 +437,38 @@ type ResolveModalData = {
     fields: Collection<string, ModalData>;
 } | Collection<string, ModalData>;
 type ModalFieldsRecord = Record<string, string | string[]>;
-declare function modalFieldsToRecord<T = ModalFieldsRecord>(data: ResolveModalData): ModalFieldsRecord;
-declare function modalFieldsToRecord<T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
+/**
+ * Converts modal submitted fields into a plain record object, mapping each component `customId` to its value.
+ *
+ * This function supports multiple modal submission data shapes coming from Discord.js,
+ * automatically extracting and normalizing values from:
+ * - Text input fields (`ComponentType.TextInput`) → string
+ * - Select menus & other multi-value components → string[]
+ * - File upload fields (`ComponentType.FileUpload`) → string[] of attachment URLs
+ *
+ * Optionally, a parser callback may be provided to transform the resulting record before returning it.
+ *
+ * @template T The expected return type after optional parsing.
+ * @param {ResolveModalData} data - The modal submission data, usually from an interaction.
+ * @param {(record: ModalFieldsRecord) => T} [parse] - Optional transform function applied to the resulting record.
+ * @returns {ModalFieldsRecord | T} The processed fields as a record, or the parser result if provided.
+ *
+ * @example
+ * ```ts
+ * const fields = modalFieldsToRecord(interaction.fields);
+ * console.log(fields.username); // "JohnDoe"
+ * ```
+ *
+ * @example With parsing
+ * ```ts
+ * const result = modalFieldsToRecord(interaction.fields, fields => ({
+ *   name: fields.username.trim(),
+ *   age: Number.parseInt(fields.age),
+ * }));
+ * ```
+ */
+declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData): T;
+declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
 type ModalFields = (LabelComponentData | TextDisplayComponentData)[];
 declare function createModalFields(...components: ModalComponents[]): ModalFields;
 
@@ -688,6 +718,16 @@ type ThumbAreaData = {
 declare function createThumbArea(content: string, thumbnail?: ThumbAreaThumbnail): SectionBuilder | TextDisplayBuilder;
 declare function createThumbArea(data: ThumbAreaData): SectionBuilder | TextDisplayBuilder;
 
+interface FileUploadData {
+    customId?: string;
+    minValues?: number;
+    maxValues?: number;
+    required?: boolean;
+    id?: number;
+}
+declare function createFileUpload(data: FileUploadData): FileUploadBuilder;
+declare function createFileUpload(customId: string): FileUploadBuilder;
+
 type EmbedPlusAssetData = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
 type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
 declare function createEmbedAsset(source: EmbedPlusAssetData, options?: EmbedAssetOptions): EmbedAssetData | undefined;
@@ -1095,5 +1135,5 @@ declare function isTextInputBuilder(value: unknown): value is TextInputBuilder;
  */
 declare function isMessage(value: unknown): value is Message;
 
-export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
-export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };
+export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
+export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };

package/dist/index.mjs

@@ -25,6 +25,7 @@ export { createSeparator } from './functions/components/separator.mjs';
 export { createTextDisplay } from './functions/components/text.mjs';
 export { createThumbArea } from './functions/components/thumbarea.mjs';
 export { createThumbnail } from './functions/components/thumbnail.mjs';
+export { createFileUpload } from './functions/components/upload.mjs';
 export { createEmbedAsset } from './functions/embeds/assets.mjs';
 export { createEmbedAuthor } from './functions/embeds/author.mjs';
 export { EmbedPlusBuilder, createEmbed } from './functions/embeds/embedplus.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicyan/discord",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Simple functions to facilitate discord bot development",
   "license": "MIT",
   "type": "module",
@@ -39,7 +39,7 @@
     "test": "vitest"
   },
   "peerDependencies": {
-    "discord.js": "^14.23.2"
+    "discord.js": "^14.24.0"
   },
   "devDependencies": {
     "@magicyan/config": "*",
@@ -49,6 +49,7 @@
     "vitest": "^2.1.9"
   },
   "dependencies": {
-    "@magicyan/core": "^1.1.5"
+    "@magicyan/core": "^1.1.5",
+    "zod": "^4.1.12"
   }
 }