@minesa-org/mini-interaction 0.0.5 → 0.0.6

package/dist/builders/MiniContainerBuilder.d.ts

@@ -20,30 +20,30 @@ export type MiniContentComponent = APIComponentInContainer;
 /** Union of supported section accessory components. */
 export type MiniSectionAccessoryComponent = APISectionAccessoryComponent;
 /** Data accepted by the container builder constructor. */
-export type MiniContainerBuilderData = Partial<Omit<MiniContainerComponent, "components">> & {
+export type ContainerBuilderData = Partial<Omit<MiniContainerComponent, "components">> & {
     components?: Array<MiniContentComponent | JSONEncodable<MiniContentComponent>>;
 };
 /** Data accepted by the section builder constructor. */
-export type MiniSectionBuilderData = Partial<Omit<MiniSectionComponent, "components" | "accessory">> & {
+export type SectionBuilderData = Partial<Omit<MiniSectionComponent, "components" | "accessory">> & {
     components?: Array<MiniTextDisplayComponent | JSONEncodable<MiniTextDisplayComponent>>;
     accessory?: MiniSectionAccessoryComponent | JSONEncodable<MiniSectionAccessoryComponent>;
 };
 /** Data accepted by the text display builder constructor. */
-export type MiniTextDisplayBuilderData = Partial<MiniTextDisplayComponent>;
+export type TextDisplayBuilderData = Partial<MiniTextDisplayComponent>;
 /** Data accepted by the separator builder constructor. */
-export type MiniSeparatorBuilderData = Partial<MiniSeparatorComponent>;
+export type SeparatorBuilderData = Partial<MiniSeparatorComponent>;
 /** Data accepted by the gallery builder constructor. */
-export type MiniGalleryBuilderData = Partial<Omit<MiniGalleryComponent, "items">> & {
+export type GalleryBuilderData = Partial<Omit<MiniGalleryComponent, "items">> & {
     items?: Array<MiniGalleryItemComponent | JSONEncodable<MiniGalleryItemComponent>>;
 };
 /** Data accepted by the gallery item builder constructor. */
-export type MiniGalleryItemBuilderData = Partial<MiniGalleryItemComponent>;
+export type GalleryItemBuilderData = Partial<MiniGalleryItemComponent>;
 /** Data accepted by the thumbnail builder constructor. */
-export type MiniThumbnailBuilderData = Partial<MiniThumbnailComponent>;
+export type ThumbnailBuilderData = Partial<MiniThumbnailComponent>;
 /** Builder for structured message container payloads. */
-export declare class MiniContainerBuilder implements JSONEncodable<MiniContainerComponent> {
+export declare class ContainerBuilder implements JSONEncodable<MiniContainerComponent> {
     private data;
-    constructor(data?: MiniContainerBuilderData);
+    constructor(data?: ContainerBuilderData);
     /** Replaces the components contained in the container. */
     setComponents(components: Array<MiniContentComponent | JSONEncodable<MiniContentComponent>>): this;
     /** Replaces the sections contained in the container. */
@@ -60,9 +60,9 @@ export declare class MiniContainerBuilder implements JSONEncodable<MiniContainer
     toJSON(): MiniContainerComponent;
 }
 /** Builder for structured message sections. */
-export declare class MiniSectionBuilder implements JSONEncodable<MiniSectionComponent> {
+export declare class SectionBuilder implements JSONEncodable<MiniSectionComponent> {
     private data;
-    constructor(data?: MiniSectionBuilderData);
+    constructor(data?: SectionBuilderData);
     /** Replaces the text components within the section. */
     setComponents(components: Array<MiniTextDisplayComponent | JSONEncodable<MiniTextDisplayComponent>>): this;
     /** Adds a text component to the section. */
@@ -73,18 +73,18 @@ export declare class MiniSectionBuilder implements JSONEncodable<MiniSectionComp
     toJSON(): MiniSectionComponent;
 }
 /** Builder for structured message text display components. */
-export declare class MiniTextDisplayBuilder implements JSONEncodable<MiniTextDisplayComponent> {
+export declare class TextDisplayBuilder implements JSONEncodable<MiniTextDisplayComponent> {
     private data;
-    constructor(data?: MiniTextDisplayBuilderData);
+    constructor(data?: TextDisplayBuilderData);
     /** Sets or clears the primary text content. */
     setContent(content: string | null | undefined): this;
     /** Serialises the component into a structured message payload. */
     toJSON(): MiniTextDisplayComponent;
 }
 /** Builder for structured message separator components. */
-export declare class MiniSeparatorBuilder implements JSONEncodable<MiniSeparatorComponent> {
+export declare class SeparatorBuilder implements JSONEncodable<MiniSeparatorComponent> {
     private data;
-    constructor(data?: MiniSeparatorBuilderData);
+    constructor(data?: SeparatorBuilderData);
     /** Sets whether the separator should render a divider. */
     setDivider(divider: boolean | null | undefined): this;
     /** Sets the separator spacing value. */
@@ -93,9 +93,9 @@ export declare class MiniSeparatorBuilder implements JSONEncodable<MiniSeparator
     toJSON(): MiniSeparatorComponent;
 }
 /** Builder for structured message thumbnails. */
-export declare class MiniThumbnailBuilder implements JSONEncodable<MiniThumbnailComponent> {
+export declare class ThumbnailBuilder implements JSONEncodable<MiniThumbnailComponent> {
     private data;
-    constructor(data?: MiniThumbnailBuilderData);
+    constructor(data?: ThumbnailBuilderData);
     /** Sets the media payload for the thumbnail. */
     setMedia(media: APIUnfurledMediaItem | null | undefined): this;
     /** Sets the thumbnail description. */
@@ -106,9 +106,9 @@ export declare class MiniThumbnailBuilder implements JSONEncodable<MiniThumbnail
     toJSON(): MiniThumbnailComponent;
 }
 /** Builder for structured message gallery items. */
-export declare class MiniGalleryItemBuilder implements JSONEncodable<MiniGalleryItemComponent> {
+export declare class GalleryItemBuilder implements JSONEncodable<MiniGalleryItemComponent> {
     private data;
-    constructor(data?: MiniGalleryItemBuilderData);
+    constructor(data?: GalleryItemBuilderData);
     /** Sets the media item payload. */
     setMedia(media: APIUnfurledMediaItem | null | undefined): this;
     /** Sets the media description. */
@@ -119,9 +119,9 @@ export declare class MiniGalleryItemBuilder implements JSONEncodable<MiniGallery
     toJSON(): MiniGalleryItemComponent;
 }
 /** Builder for structured message gallery components. */
-export declare class MiniGalleryBuilder implements JSONEncodable<MiniGalleryComponent> {
+export declare class GalleryBuilder implements JSONEncodable<MiniGalleryComponent> {
     private data;
-    constructor(data?: MiniGalleryBuilderData);
+    constructor(data?: GalleryBuilderData);
     /** Replaces the gallery items. */
     setItems(items: Array<MiniGalleryItemComponent | JSONEncodable<MiniGalleryItemComponent>>): this;
     /** Adds a gallery item to the payload. */

package/dist/builders/MiniContainerBuilder.js

@@ -9,7 +9,7 @@ function cloneAccessory(accessory) {
     return { ...resolved };
 }
 /** Builder for structured message container payloads. */
-export class MiniContainerBuilder {
+export class ContainerBuilder {
     data;
     constructor(data = {}) {
         const components = data.components
@@ -71,7 +71,7 @@ export class MiniContainerBuilder {
     }
 }
 /** Builder for structured message sections. */
-export class MiniSectionBuilder {
+export class SectionBuilder {
     data;
     constructor(data = {}) {
         const components = data.components
@@ -112,9 +112,11 @@ export class MiniSectionBuilder {
     /** Serialises the section into a structured message payload. */
     toJSON() {
         const components = this.data.components ?? [];
-        const accessory = this.data.accessory ? { ...this.data.accessory } : undefined;
+        const accessory = this.data.accessory
+            ? { ...this.data.accessory }
+            : undefined;
         if (!accessory) {
-            throw new Error("[MiniSectionBuilder] accessory is required for sections");
+            throw new Error("[SectionBuilder] accessory is required for sections");
         }
         return {
             ...this.data,
@@ -129,7 +131,7 @@ function cloneTextDisplayComponent(component) {
     return { ...resolved };
 }
 /** Builder for structured message text display components. */
-export class MiniTextDisplayBuilder {
+export class TextDisplayBuilder {
     data;
     constructor(data = {}) {
         this.data = {
@@ -150,7 +152,7 @@ export class MiniTextDisplayBuilder {
     /** Serialises the component into a structured message payload. */
     toJSON() {
         if (!this.data.content) {
-            throw new Error("[MiniTextDisplayBuilder] content is required for text displays");
+            throw new Error("[TextDisplayBuilder] content is required for text displays");
         }
         return {
             ...this.data,
@@ -159,7 +161,7 @@ export class MiniTextDisplayBuilder {
     }
 }
 /** Builder for structured message separator components. */
-export class MiniSeparatorBuilder {
+export class SeparatorBuilder {
     data;
     constructor(data = {}) {
         this.data = {
@@ -196,7 +198,7 @@ export class MiniSeparatorBuilder {
     }
 }
 /** Builder for structured message thumbnails. */
-export class MiniThumbnailBuilder {
+export class ThumbnailBuilder {
     data;
     constructor(data = {}) {
         this.data = {
@@ -238,7 +240,7 @@ export class MiniThumbnailBuilder {
     /** Serialises the thumbnail payload. */
     toJSON() {
         if (!this.data.media) {
-            throw new Error("[MiniThumbnailBuilder] media is required for thumbnails");
+            throw new Error("[ThumbnailBuilder] media is required for thumbnails");
         }
         return {
             ...this.data,
@@ -247,7 +249,7 @@ export class MiniThumbnailBuilder {
     }
 }
 /** Builder for structured message gallery items. */
-export class MiniGalleryItemBuilder {
+export class GalleryItemBuilder {
     data;
     constructor(data = {}) {
         this.data = {
@@ -288,7 +290,7 @@ export class MiniGalleryItemBuilder {
     /** Serialises the gallery item payload. */
     toJSON() {
         if (!this.data.media) {
-            throw new Error("[MiniGalleryItemBuilder] media is required for gallery items");
+            throw new Error("[GalleryItemBuilder] media is required for gallery items");
         }
         return {
             ...this.data,
@@ -297,7 +299,7 @@ export class MiniGalleryItemBuilder {
     }
 }
 /** Builder for structured message gallery components. */
-export class MiniGalleryBuilder {
+export class GalleryBuilder {
     data;
     constructor(data = {}) {
         const items = data.items
@@ -324,7 +326,7 @@ export class MiniGalleryBuilder {
     toJSON() {
         const items = this.data.items ?? [];
         if (items.length === 0) {
-            throw new Error("[MiniGalleryBuilder] at least one gallery item is required");
+            throw new Error("[GalleryBuilder] at least one gallery item is required");
         }
         return {
             ...this.data,
@@ -336,7 +338,7 @@ export class MiniGalleryBuilder {
 function resolveGalleryItem(item) {
     const resolved = resolveJSONEncodable(item);
     if (!resolved.media) {
-        throw new Error("[MiniGalleryBuilder] gallery items require media");
+        throw new Error("[GalleryBuilder] gallery items require media");
     }
     return {
         ...resolved,

package/dist/builders/TextInputBuilder.d.ts

@@ -0,0 +1,57 @@
+import { TextInputStyle, type APITextInputComponent } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial text input data accepted by the builder. */
+export type TextInputBuilderData = {
+    customId?: string;
+    label?: string;
+    style?: TextInputStyle;
+    minLength?: number;
+    maxLength?: number;
+    required?: boolean;
+    value?: string;
+    placeholder?: string;
+};
+/** Builder for Discord text input components used in modals. */
+export declare class TextInputBuilder implements JSONEncodable<APITextInputComponent> {
+    private data;
+    /**
+     * Creates a new text input builder with optional seed data.
+     */
+    constructor(data?: TextInputBuilderData);
+    /**
+     * Sets the custom identifier for this text input.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets the label displayed above the text input.
+     */
+    setLabel(label: string): this;
+    /**
+     * Sets the style of the text input (Short or Paragraph).
+     */
+    setStyle(style: TextInputStyle): this;
+    /**
+     * Sets the minimum length of the input text.
+     */
+    setMinLength(minLength: number): this;
+    /**
+     * Sets the maximum length of the input text.
+     */
+    setMaxLength(maxLength: number): this;
+    /**
+     * Sets whether this text input is required.
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Sets the pre-filled value for this text input.
+     */
+    setValue(value: string): this;
+    /**
+     * Sets the placeholder text shown when the input is empty.
+     */
+    setPlaceholder(placeholder: string): this;
+    /**
+     * Serialises the builder into an API compatible text input payload.
+     */
+    toJSON(): APITextInputComponent;
+}

package/dist/builders/TextInputBuilder.js

@@ -0,0 +1,98 @@
+import { ComponentType, TextInputStyle, } from "discord-api-types/v10";
+/** Builder for Discord text input components used in modals. */
+export class TextInputBuilder {
+    data;
+    /**
+     * Creates a new text input builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            customId: data.customId,
+            label: data.label,
+            style: data.style ?? TextInputStyle.Short,
+            minLength: data.minLength,
+            maxLength: data.maxLength,
+            required: data.required,
+            value: data.value,
+            placeholder: data.placeholder,
+        };
+    }
+    /**
+     * Sets the custom identifier for this text input.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        return this;
+    }
+    /**
+     * Sets the label displayed above the text input.
+     */
+    setLabel(label) {
+        this.data.label = label;
+        return this;
+    }
+    /**
+     * Sets the style of the text input (Short or Paragraph).
+     */
+    setStyle(style) {
+        this.data.style = style;
+        return this;
+    }
+    /**
+     * Sets the minimum length of the input text.
+     */
+    setMinLength(minLength) {
+        this.data.minLength = minLength;
+        return this;
+    }
+    /**
+     * Sets the maximum length of the input text.
+     */
+    setMaxLength(maxLength) {
+        this.data.maxLength = maxLength;
+        return this;
+    }
+    /**
+     * Sets whether this text input is required.
+     */
+    setRequired(required) {
+        this.data.required = required;
+        return this;
+    }
+    /**
+     * Sets the pre-filled value for this text input.
+     */
+    setValue(value) {
+        this.data.value = value;
+        return this;
+    }
+    /**
+     * Sets the placeholder text shown when the input is empty.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder;
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible text input payload.
+     */
+    toJSON() {
+        if (!this.data.customId) {
+            throw new Error("[TextInputBuilder] custom_id is required.");
+        }
+        if (!this.data.label) {
+            throw new Error("[TextInputBuilder] label is required.");
+        }
+        return {
+            type: ComponentType.TextInput,
+            custom_id: this.data.customId,
+            label: this.data.label,
+            style: this.data.style ?? TextInputStyle.Short,
+            min_length: this.data.minLength,
+            max_length: this.data.maxLength,
+            required: this.data.required,
+            value: this.data.value,
+            placeholder: this.data.placeholder,
+        };
+    }
+}

package/dist/builders/index.d.ts

@@ -11,10 +11,12 @@ export { ChannelSelectMenuBuilder } from "./ChannelSelectMenuBuilder.js";
 export type { ChannelSelectMenuBuilderData } from "./ChannelSelectMenuBuilder.js";
 export { ModalBuilder } from "./ModalBuilder.js";
 export type { ModalBuilderData, ModalComponentLike } from "./ModalBuilder.js";
+export { TextInputBuilder } from "./TextInputBuilder.js";
+export type { TextInputBuilderData } from "./TextInputBuilder.js";
 export { AutomodRuleBuilder } from "./AutomodRuleBuilder.js";
 export type { AutomodRuleBuilderData } from "./AutomodRuleBuilder.js";
 export { EmbedBuilder } from "./EmbedBuilder.js";
 export type { EmbedBuilderData } from "./EmbedBuilder.js";
-export { MiniContainerBuilder, MiniSectionBuilder, MiniTextDisplayBuilder, MiniSeparatorBuilder, MiniGalleryBuilder, MiniGalleryItemBuilder, MiniThumbnailBuilder, } from "./MiniContainerBuilder.js";
-export type { MiniContainerBuilderData, MiniSectionBuilderData, MiniTextDisplayBuilderData, MiniSeparatorBuilderData, MiniGalleryBuilderData, MiniGalleryItemBuilderData, MiniThumbnailBuilderData, MiniContainerComponent, MiniSectionComponent, MiniTextDisplayComponent, MiniSeparatorComponent, MiniGalleryComponent, MiniGalleryItemComponent, MiniThumbnailComponent, MiniContentComponent, MiniSectionAccessoryComponent, } from "./MiniContainerBuilder.js";
+export { ContainerBuilder, SectionBuilder, TextDisplayBuilder, SeparatorBuilder, GalleryBuilder, GalleryItemBuilder, ThumbnailBuilder, } from "./MiniContainerBuilder.js";
+export type { ContainerBuilderData, SectionBuilderData, TextDisplayBuilderData, SeparatorBuilderData, GalleryBuilderData, GalleryItemBuilderData, ThumbnailBuilderData, MiniContainerComponent, MiniSectionComponent, MiniTextDisplayComponent, MiniSeparatorComponent, MiniGalleryComponent, MiniGalleryItemComponent, MiniThumbnailComponent, MiniContentComponent, MiniSectionAccessoryComponent, } from "./MiniContainerBuilder.js";
 export type { JSONEncodable } from "./shared.js";

package/dist/builders/index.js

@@ -5,6 +5,7 @@ export { StringSelectMenuBuilder } from "./StringSelectMenuBuilder.js";
 export { RoleSelectMenuBuilder } from "./RoleSelectMenuBuilder.js";
 export { ChannelSelectMenuBuilder } from "./ChannelSelectMenuBuilder.js";
 export { ModalBuilder } from "./ModalBuilder.js";
+export { TextInputBuilder } from "./TextInputBuilder.js";
 export { AutomodRuleBuilder } from "./AutomodRuleBuilder.js";
 export { EmbedBuilder } from "./EmbedBuilder.js";
-export { MiniContainerBuilder, MiniSectionBuilder, MiniTextDisplayBuilder, MiniSeparatorBuilder, MiniGalleryBuilder, MiniGalleryItemBuilder, MiniThumbnailBuilder, } from "./MiniContainerBuilder.js";
+export { ContainerBuilder, SectionBuilder, TextDisplayBuilder, SeparatorBuilder, GalleryBuilder, GalleryItemBuilder, ThumbnailBuilder, } from "./MiniContainerBuilder.js";

package/dist/clients/MiniInteraction.d.ts

@@ -3,6 +3,7 @@ import { APIInteractionResponse, RESTPostAPIChatInputApplicationCommandsJSONBody
 import type { MiniInteractionCommand } from "../types/Commands.js";
 import { RoleConnectionMetadataTypes } from "../types/RoleConnectionMetadataTypes.js";
 import { type MessageComponentInteraction } from "../utils/MessageComponentInteraction.js";
+import { type ModalSubmitInteraction } from "../utils/ModalSubmitInteraction.js";
 /** Configuration parameters for the MiniInteraction client. */
 export type MiniInteractionOptions = {
     applicationId: string;
@@ -41,6 +42,13 @@ export type MiniInteractionComponent = {
     customId: string;
     handler: MiniInteractionComponentHandler;
 };
+/** Handler signature invoked for Discord modal submit interactions. */
+export type MiniInteractionModalHandler = (interaction: ModalSubmitInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+/** Structure describing a modal handler mapped to a custom id. */
+export type MiniInteractionModal = {
+    customId: string;
+    handler: MiniInteractionModalHandler;
+};
 /** Node.js HTTP handler compatible with frameworks like Express or Next.js API routes. */
 export type MiniInteractionNodeHandler = (request: IncomingMessage, response: ServerResponse) => void;
 /** Web Fetch API compatible request handler for platforms such as Cloudflare Workers. */
@@ -62,6 +70,7 @@ export declare class MiniInteraction {
     private readonly componentsDirectory;
     private readonly commands;
     private readonly componentHandlers;
+    private readonly modalHandlers;
     private commandsLoaded;
     private loadCommandsPromise;
     private componentsLoaded;
@@ -94,6 +103,18 @@ export declare class MiniInteraction {
      * @param components - The component definitions to register.
      */
     useComponents(components: MiniInteractionComponent[]): this;
+    /**
+     * Registers a single modal handler mapped to a custom identifier.
+     *
+     * @param modal - The modal definition to register.
+     */
+    useModal(modal: MiniInteractionModal): this;
+    /**
+     * Registers multiple modal handlers in a single call.
+     *
+     * @param modals - The modal definitions to register.
+     */
+    useModals(modals: MiniInteractionModal[]): this;
     /**
      * Recursively loads components from the configured components directory.
      *
@@ -194,6 +215,10 @@ export declare class MiniInteraction {
      * Handles execution of a message component interaction.
      */
     private handleMessageComponent;
+    /**
+     * Handles execution of a modal submit interaction.
+     */
+    private handleModalSubmit;
     /**
      * Handles execution of an application command interaction.
      */

package/dist/clients/MiniInteraction.js

@@ -7,6 +7,7 @@ import { verifyKey } from "discord-interactions";
 import { DISCORD_BASE_URL } from "../utils/constants.js";
 import { createCommandInteraction } from "../utils/CommandInteractionOptions.js";
 import { createMessageComponentInteraction, } from "../utils/MessageComponentInteraction.js";
+import { createModalSubmitInteraction, } from "../utils/ModalSubmitInteraction.js";
 /** File extensions that are treated as loadable modules when auto-loading. */
 const SUPPORTED_MODULE_EXTENSIONS = new Set([
     ".js",
@@ -29,6 +30,7 @@ export class MiniInteraction {
     componentsDirectory;
     commands = new Map();
     componentHandlers = new Map();
+    modalHandlers = new Map();
     commandsLoaded = false;
     loadCommandsPromise = null;
     componentsLoaded = false;
@@ -75,6 +77,18 @@ export class MiniInteraction {
             console.warn(`[MiniInteraction] Command "${commandName}" already exists and will be overwritten.`);
         }
         this.commands.set(commandName, command);
+        // Register components exported with the command
+        if (command.components && Array.isArray(command.components)) {
+            for (const component of command.components) {
+                this.useComponent(component);
+            }
+        }
+        // Register modals exported with the command
+        if (command.modals && Array.isArray(command.modals)) {
+            for (const modal of command.modals) {
+                this.useModal(modal);
+            }
+        }
         return this;
     }
     /**
@@ -118,6 +132,36 @@ export class MiniInteraction {
         }
         return this;
     }
+    /**
+     * Registers a single modal handler mapped to a custom identifier.
+     *
+     * @param modal - The modal definition to register.
+     */
+    useModal(modal) {
+        const customId = modal?.customId;
+        if (!customId) {
+            throw new Error("[MiniInteraction] modal.customId is required");
+        }
+        if (typeof modal.handler !== "function") {
+            throw new Error("[MiniInteraction] modal.handler must be a function");
+        }
+        if (this.modalHandlers.has(customId)) {
+            console.warn(`[MiniInteraction] Modal "${customId}" already exists and will be overwritten.`);
+        }
+        this.modalHandlers.set(customId, modal.handler);
+        return this;
+    }
+    /**
+     * Registers multiple modal handlers in a single call.
+     *
+     * @param modals - The modal definitions to register.
+     */
+    useModals(modals) {
+        for (const modal of modals) {
+            this.useModal(modal);
+        }
+        return this;
+    }
     /**
      * Recursively loads components from the configured components directory.
      *
@@ -184,6 +228,18 @@ export class MiniInteraction {
                 continue;
             }
             this.commands.set(command.data.name, command);
+            // Register components exported from the command file
+            if (command.components && Array.isArray(command.components)) {
+                for (const component of command.components) {
+                    this.useComponent(component);
+                }
+            }
+            // Register modals exported from the command file
+            if (command.modals && Array.isArray(command.modals)) {
+                for (const modal of command.modals) {
+                    this.useModal(modal);
+                }
+            }
         }
         this.commandsLoaded = true;
         return this;
@@ -302,6 +358,9 @@ export class MiniInteraction {
         if (interaction.type === InteractionType.MessageComponent) {
             return this.handleMessageComponent(interaction);
         }
+        if (interaction.type === InteractionType.ModalSubmit) {
+            return this.handleModalSubmit(interaction);
+        }
         return {
             status: 400,
             body: {
@@ -542,9 +601,10 @@ export class MiniInteraction {
             return;
         }
         if (!this.loadComponentsPromise) {
-            this.loadComponentsPromise = this.loadComponentsFromDirectory().then(() => {
-                this.loadComponentsPromise = null;
-            });
+            this.loadComponentsPromise =
+                this.loadComponentsFromDirectory().then(() => {
+                    this.loadComponentsPromise = null;
+                });
         }
         await this.loadComponentsPromise;
     }
@@ -583,7 +643,8 @@ export class MiniInteraction {
         const candidates = [];
         const isWithin = (parent, child) => {
             const relative = path.relative(parent, child);
-            return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+            return (relative === "" ||
+                (!relative.startsWith("..") && !path.isAbsolute(relative)));
         };
         const pushCandidate = (candidate) => {
             if (!candidates.includes(candidate)) {
@@ -681,6 +742,55 @@ export class MiniInteraction {
             };
         }
     }
+    /**
+     * Handles execution of a modal submit interaction.
+     */
+    async handleModalSubmit(interaction) {
+        const customId = interaction?.data?.custom_id;
+        if (!customId) {
+            return {
+                status: 400,
+                body: {
+                    error: "[MiniInteraction] Modal submit interaction is missing a custom_id",
+                },
+            };
+        }
+        const handler = this.modalHandlers.get(customId);
+        if (!handler) {
+            return {
+                status: 404,
+                body: {
+                    error: `[MiniInteraction] No handler registered for modal "${customId}"`,
+                },
+            };
+        }
+        try {
+            const interactionWithHelpers = createModalSubmitInteraction(interaction);
+            const response = await handler(interactionWithHelpers);
+            const resolvedResponse = response ?? interactionWithHelpers.getResponse();
+            if (!resolvedResponse) {
+                return {
+                    status: 500,
+                    body: {
+                        error: `[MiniInteraction] Modal "${customId}" did not return a response. ` +
+                            "Return an APIInteractionResponse to acknowledge the interaction.",
+                    },
+                };
+            }
+            return {
+                status: 200,
+                body: resolvedResponse,
+            };
+        }
+        catch (error) {
+            return {
+                status: 500,
+                body: {
+                    error: `[MiniInteraction] Modal "${customId}" failed: ${String(error)}`,
+                },
+            };
+        }
+    }
     /**
      * Handles execution of an application command interaction.
      */

package/dist/index.d.ts

@@ -7,11 +7,15 @@ export { CommandInteractionOptionResolver, createCommandInteraction, } from "./u
 export type { CommandInteraction, MentionableOption, ResolvedUserOption, } from "./utils/CommandInteractionOptions.js";
 export type { MiniInteractionFetchHandler, MiniInteractionNodeHandler, MiniInteractionHandlerResult, MiniInteractionRequest, MiniInteractionOptions, } from "./clients/MiniInteraction.js";
 export type { MiniInteractionCommand, SlashCommandHandler, } from "./types/Commands.js";
-export type { MiniInteractionComponent, MiniInteractionComponentHandler, } from "./clients/MiniInteraction.js";
+export type { MiniInteractionComponent, MiniInteractionComponentHandler, MiniInteractionModal, MiniInteractionModalHandler, } from "./clients/MiniInteraction.js";
+export type { MessageComponentInteraction } from "./utils/MessageComponentInteraction.js";
+export type { ModalSubmitInteraction } from "./utils/ModalSubmitInteraction.js";
 export { RoleConnectionMetadataTypes } from "./types/RoleConnectionMetadataTypes.js";
 export { ChannelType } from "./types/ChannelType.js";
 export { InteractionFollowUpFlags, InteractionReplyFlags, } from "./types/InteractionFlags.js";
 export { ButtonStyle } from "./types/ButtonStyle.js";
+export { SeparatorSpacingSize } from "./types/SeparatorSpacingSize.js";
+export { TextInputStyle } from "discord-api-types/v10";
 export { MiniPermFlags } from "./types/PermissionFlags.js";
 export type { MiniComponentActionRow, MiniComponentMessageActionRow, } from "./types/ComponentTypes.js";
 export * from "./builders/index.js";

package/dist/index.js

@@ -6,5 +6,7 @@ export { RoleConnectionMetadataTypes } from "./types/RoleConnectionMetadataTypes
 export { ChannelType } from "./types/ChannelType.js";
 export { InteractionFollowUpFlags, InteractionReplyFlags, } from "./types/InteractionFlags.js";
 export { ButtonStyle } from "./types/ButtonStyle.js";
+export { SeparatorSpacingSize } from "./types/SeparatorSpacingSize.js";
+export { TextInputStyle } from "discord-api-types/v10";
 export { MiniPermFlags } from "./types/PermissionFlags.js";
 export * from "./builders/index.js";

package/dist/types/Commands.d.ts

@@ -1,11 +1,22 @@
 import type { APIInteractionResponse, RESTPostAPIChatInputApplicationCommandsJSONBody } from "discord-api-types/v10";
 import type { CommandInteraction } from "../utils/CommandInteractionOptions.js";
+import type { MiniInteractionComponent, MiniInteractionModal } from "../clients/MiniInteraction.js";
 /** Handler signature for slash command executions within MiniInteraction. */
 export type SlashCommandHandler = (interaction: CommandInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
 /** Structure representing a slash command definition and its runtime handler. */
 export type MiniInteractionCommand = {
     data: RESTPostAPIChatInputApplicationCommandsJSONBody;
     handler: SlashCommandHandler;
+    /**
+     * Optional array of component handlers related to this command.
+     * These will be automatically registered when the command is loaded.
+     */
+    components?: MiniInteractionComponent[];
+    /**
+     * Optional array of modal handlers related to this command.
+     * These will be automatically registered when the command is loaded.
+     */
+    modals?: MiniInteractionModal[];
 };
 /** Map of command names to their registered MiniInteraction command definitions. */
 export type MiniInteractionCommandsMap = Map<string, MiniInteractionCommand>;

package/dist/types/SeparatorSpacingSize.d.ts

@@ -0,0 +1,2 @@
+/** Re-export of Discord separator spacing size identifiers for convenience in builders. */
+export { SeparatorSpacingSize } from "discord-api-types/v10";

package/dist/types/SeparatorSpacingSize.js

@@ -0,0 +1,2 @@
+/** Re-export of Discord separator spacing size identifiers for convenience in builders. */
+export { SeparatorSpacingSize } from "discord-api-types/v10";

package/dist/utils/CommandInteractionOptions.d.ts

@@ -132,7 +132,9 @@ export interface CommandInteraction extends Omit<APIChatInputApplicationCommandI
     followUp(data: InteractionMessageData): APIInteractionResponseChannelMessageWithSource;
     edit(data?: InteractionMessageData): APIInteractionResponseUpdateMessage;
     deferReply(options?: DeferReplyOptions): APIInteractionResponseDeferredChannelMessageWithSource;
-    showModal(data: APIModalInteractionResponseCallbackData): APIModalInteractionResponse;
+    showModal(data: APIModalInteractionResponseCallbackData | {
+        toJSON(): APIModalInteractionResponseCallbackData;
+    }): APIModalInteractionResponse;
 }
 /**
  * Wraps a raw application command interaction with helper methods and option resolvers.

package/dist/utils/CommandInteractionOptions.js

@@ -366,9 +366,14 @@ export function createCommandInteraction(interaction) {
                 : undefined);
         },
         showModal(data) {
+            const resolvedData = typeof data === "object" &&
+                "toJSON" in data &&
+                typeof data.toJSON === "function"
+                ? data.toJSON()
+                : data;
             return captureResponse({
                 type: InteractionResponseType.Modal,
-                data,
+                data: resolvedData,
             });
         },
     };

package/dist/utils/MessageComponentInteraction.d.ts

@@ -1,7 +1,10 @@
-import { type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIInteractionResponseDeferredMessageUpdate, type APIInteractionResponseUpdateMessage, type APIMessageComponentInteraction } from "discord-api-types/v10";
+import { type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIInteractionResponseDeferredMessageUpdate, type APIInteractionResponseUpdateMessage, type APIMessageComponentInteraction, type APIModalInteractionResponse, type APIModalInteractionResponseCallbackData } from "discord-api-types/v10";
 import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageHelpers.js";
 /**
  * Represents a component interaction augmented with helper response methods.
+ *
+ * Note: The `values` property is available on select menu interactions (data.values).
+ * For button interactions, this property will be undefined.
  */
 export type MessageComponentInteraction = APIMessageComponentInteraction & {
     getResponse: () => APIInteractionResponse | null;
@@ -9,6 +12,15 @@ export type MessageComponentInteraction = APIMessageComponentInteraction & {
     deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
     update: (data?: InteractionMessageData) => APIInteractionResponseUpdateMessage;
     deferUpdate: () => APIInteractionResponseDeferredMessageUpdate;
+    showModal: (data: APIModalInteractionResponseCallbackData | {
+        toJSON(): APIModalInteractionResponseCallbackData;
+    }) => APIModalInteractionResponse;
+    /**
+     * The selected values from a select menu interaction.
+     * This property is only present for select menu interactions.
+     * For button interactions, this will be undefined.
+     */
+    values?: string[];
 };
 /**
  * Wraps a raw component interaction with helper methods mirroring Discord's expected responses.

package/dist/utils/MessageComponentInteraction.js

@@ -49,12 +49,27 @@ export function createMessageComponentInteraction(interaction) {
     const deferUpdate = () => captureResponse({
         type: InteractionResponseType.DeferredMessageUpdate,
     });
+    const showModal = (data) => {
+        const resolvedData = typeof data === "object" &&
+            "toJSON" in data &&
+            typeof data.toJSON === "function"
+            ? data.toJSON()
+            : data;
+        return captureResponse({
+            type: InteractionResponseType.Modal,
+            data: resolvedData,
+        });
+    };
     const getResponse = () => capturedResponse;
+    // Extract values from select menu interactions
+    const values = "values" in interaction.data ? interaction.data.values : undefined;
     return Object.assign(interaction, {
         reply,
         deferReply,
         update,
         deferUpdate,
+        showModal,
         getResponse,
+        values,
     });
 }

package/dist/utils/ModalSubmitInteraction.d.ts

@@ -0,0 +1,28 @@
+import { type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIModalSubmitInteraction } from "discord-api-types/v10";
+import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageHelpers.js";
+/**
+ * Represents a modal submit interaction augmented with helper response methods.
+ */
+export type ModalSubmitInteraction = APIModalSubmitInteraction & {
+    getResponse: () => APIInteractionResponse | null;
+    reply: (data: InteractionMessageData) => APIInteractionResponseChannelMessageWithSource;
+    deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
+    /**
+     * Helper method to get the value of a text input component by custom_id.
+     * @param customId - The custom_id of the text input component
+     * @returns The value of the text input, or undefined if not found
+     */
+    getTextInputValue: (customId: string) => string | undefined;
+    /**
+     * Helper method to get all text input values as a map.
+     * @returns A map of custom_id to value for all text inputs
+     */
+    getTextInputValues: () => Map<string, string>;
+};
+/**
+ * Wraps a raw modal submit interaction with helper methods.
+ *
+ * @param interaction - The raw interaction payload from Discord.
+ * @returns A helper-augmented interaction object.
+ */
+export declare function createModalSubmitInteraction(interaction: APIModalSubmitInteraction): ModalSubmitInteraction;

package/dist/utils/ModalSubmitInteraction.js

@@ -0,0 +1,74 @@
+import { InteractionResponseType, } from "discord-api-types/v10";
+import { normaliseInteractionMessageData, normaliseMessageFlags, } from "./interactionMessageHelpers.js";
+/**
+ * Wraps a raw modal submit interaction with helper methods.
+ *
+ * @param interaction - The raw interaction payload from Discord.
+ * @returns A helper-augmented interaction object.
+ */
+export function createModalSubmitInteraction(interaction) {
+    let capturedResponse = null;
+    const captureResponse = (response) => {
+        capturedResponse = response;
+        return response;
+    };
+    const reply = (data) => {
+        const normalisedData = normaliseInteractionMessageData(data);
+        if (!normalisedData) {
+            throw new Error("[MiniInteraction] Modal submit replies require response data to be provided.");
+        }
+        return captureResponse({
+            type: InteractionResponseType.ChannelMessageWithSource,
+            data: normalisedData,
+        });
+    };
+    const deferReply = (options) => {
+        const flags = normaliseMessageFlags(options?.flags);
+        const response = flags !== undefined
+            ? {
+                type: InteractionResponseType.DeferredChannelMessageWithSource,
+                data: { flags },
+            }
+            : {
+                type: InteractionResponseType.DeferredChannelMessageWithSource,
+            };
+        return captureResponse(response);
+    };
+    const getResponse = () => capturedResponse;
+    // Helper to extract text input values from modal components
+    const extractTextInputs = () => {
+        const textInputs = new Map();
+        for (const component of interaction.data.components) {
+            // Handle action rows
+            if ("components" in component && Array.isArray(component.components)) {
+                for (const child of component.components) {
+                    if ("value" in child && "custom_id" in child) {
+                        textInputs.set(child.custom_id, child.value);
+                    }
+                }
+            }
+            // Handle labeled components
+            else if ("component" in component) {
+                const labeledComponent = component.component;
+                if ("value" in labeledComponent && "custom_id" in labeledComponent) {
+                    textInputs.set(labeledComponent.custom_id, labeledComponent.value);
+                }
+            }
+        }
+        return textInputs;
+    };
+    const textInputValues = extractTextInputs();
+    const getTextInputValue = (customId) => {
+        return textInputValues.get(customId);
+    };
+    const getTextInputValues = () => {
+        return new Map(textInputValues);
+    };
+    return Object.assign(interaction, {
+        reply,
+        deferReply,
+        getResponse,
+        getTextInputValue,
+        getTextInputValues,
+    });
+}

package/dist/utils/interactionMessageHelpers.d.ts

@@ -4,23 +4,23 @@ import type { InteractionFollowUpFlags, InteractionReplyFlags } from "../types/I
 export type MessageFlagLike = MessageFlags | InteractionReplyFlags | InteractionFollowUpFlags;
 /** Message payload accepted by helper reply/edit functions. */
 export type InteractionMessageData = Omit<APIInteractionResponseCallbackData, "flags"> & {
-    flags?: MessageFlagLike;
+    flags?: MessageFlagLike | MessageFlagLike[];
 };
 /** Deferred response payload recognised by helper methods. */
 export type DeferredResponseData = {
-    flags: MessageFlagLike;
+    flags: MessageFlagLike | MessageFlagLike[];
 };
 /** Options accepted when deferring a reply. */
 export type DeferReplyOptions = {
-    flags?: MessageFlagLike;
+    flags?: MessageFlagLike | MessageFlagLike[];
 };
 /**
  * Normalises helper flag enums into the raw Discord `MessageFlags` bitfield.
  *
- * @param flags - A flag from helper enums or raw Discord flags.
+ * @param flags - A flag or array of flags from helper enums or raw Discord flags.
  * @returns The value coerced to a `MessageFlags` compatible bitfield.
  */
-export declare function normaliseMessageFlags(flags: MessageFlagLike | undefined): MessageFlags | undefined;
+export declare function normaliseMessageFlags(flags: MessageFlagLike | MessageFlagLike[] | undefined): MessageFlags | undefined;
 /**
  * Ensures helper message payloads include correctly normalised message flags.
  *

package/dist/utils/interactionMessageHelpers.js

@@ -1,4 +1,4 @@
-import { ComponentType, MessageFlags as RawMessageFlags } from "discord-api-types/v10";
+import { ComponentType, MessageFlags as RawMessageFlags, } from "discord-api-types/v10";
 const COMPONENTS_V2_TYPES = new Set([
     ComponentType.Container,
     ComponentType.Section,
@@ -11,11 +11,21 @@ const COMPONENTS_V2_TYPES = new Set([
 /**
  * Normalises helper flag enums into the raw Discord `MessageFlags` bitfield.
  *
- * @param flags - A flag from helper enums or raw Discord flags.
+ * @param flags - A flag or array of flags from helper enums or raw Discord flags.
  * @returns The value coerced to a `MessageFlags` compatible bitfield.
  */
 export function normaliseMessageFlags(flags) {
-    return flags === undefined ? undefined : flags;
+    if (flags === undefined) {
+        return undefined;
+    }
+    if (Array.isArray(flags)) {
+        if (flags.length === 0) {
+            return undefined;
+        }
+        // Combine multiple flags using bitwise OR
+        return flags.reduce((acc, flag) => (acc | flag), 0);
+    }
+    return flags;
 }
 /**
  * Ensures helper message payloads include correctly normalised message flags.
@@ -27,19 +37,34 @@ export function normaliseInteractionMessageData(data) {
     if (!data) {
         return undefined;
     }
-    const usesComponentsV2 = Array.isArray(data.components)
-        ? containsComponentsV2(data.components)
+    // Auto-convert builders to JSON
+    const normalisedComponents = data.components
+        ? data.components.map((component) => resolveComponentLike(component))
+        : undefined;
+    const normalisedEmbeds = data.embeds
+        ? data.embeds.map((embed) => resolveComponentLike(embed))
+        : undefined;
+    const usesComponentsV2 = Array.isArray(normalisedComponents)
+        ? containsComponentsV2(normalisedComponents)
         : false;
     const normalisedFlags = normaliseMessageFlags(data.flags);
     const finalFlags = usesComponentsV2
-        ? ((normalisedFlags ?? 0) | RawMessageFlags.IsComponentsV2)
+        ? ((normalisedFlags ?? 0) |
+            RawMessageFlags.IsComponentsV2)
         : normalisedFlags;
-    if (finalFlags === data.flags) {
+    const needsNormalisation = finalFlags !== data.flags ||
+        normalisedComponents !== data.components ||
+        normalisedEmbeds !== data.embeds;
+    if (!needsNormalisation) {
         return data;
     }
-    const { flags: _flags, ...rest } = data;
+    const { flags: _flags, components: _components, embeds: _embeds, ...rest } = data;
     return {
         ...rest,
+        ...(normalisedComponents !== undefined
+            ? { components: normalisedComponents }
+            : {}),
+        ...(normalisedEmbeds !== undefined ? { embeds: normalisedEmbeds } : {}),
         ...(finalFlags !== undefined ? { flags: finalFlags } : {}),
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@minesa-org/mini-interaction",
-	"version": "0.0.5",
+	"version": "0.0.6",
 	"description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
 	"type": "module",
 	"main": "dist/index.js",
@@ -14,6 +14,7 @@
 		"build": "tsc --project tsconfig.json",
 		"typecheck": "tsc --noEmit",
 		"prepare": "npm run build",
+		"patch": "npm version patch",
 		"publish:npm": "npm publish",
 		"publish:gh": "npm publish --registry=https://npm.pkg.github.com"
 	},