@minesa-org/mini-interaction 0.0.6 → 0.0.8

package/dist/builders/FileUploadBuilder.d.ts

@@ -0,0 +1,37 @@
+import { type APIFileUploadComponent } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial file upload data accepted by the builder. */
+export type FileUploadBuilderData = {
+    customId?: string;
+    minValues?: number;
+    maxValues?: number;
+    required?: boolean;
+};
+/** Builder for Discord file upload components used in modals. */
+export declare class FileUploadBuilder implements JSONEncodable<APIFileUploadComponent> {
+    private data;
+    /**
+     * Creates a new file upload builder with optional seed data.
+     */
+    constructor(data?: FileUploadBuilderData);
+    /**
+     * Sets the custom identifier for this file upload component.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets the minimum number of files that must be uploaded (min 0, max 10).
+     */
+    setMinValues(minValues: number): this;
+    /**
+     * Sets the maximum number of files that can be uploaded (max 10).
+     */
+    setMaxValues(maxValues: number): this;
+    /**
+     * Sets whether files are required before submitting the modal.
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Serialises the builder into an API compatible file upload component payload.
+     */
+    toJSON(): APIFileUploadComponent;
+}

package/dist/builders/FileUploadBuilder.js

@@ -0,0 +1,59 @@
+import { ComponentType, } from "discord-api-types/v10";
+/** Builder for Discord file upload components used in modals. */
+export class FileUploadBuilder {
+    data;
+    /**
+     * Creates a new file upload builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            customId: data.customId,
+            minValues: data.minValues,
+            maxValues: data.maxValues,
+            required: data.required,
+        };
+    }
+    /**
+     * Sets the custom identifier for this file upload component.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        return this;
+    }
+    /**
+     * Sets the minimum number of files that must be uploaded (min 0, max 10).
+     */
+    setMinValues(minValues) {
+        this.data.minValues = minValues;
+        return this;
+    }
+    /**
+     * Sets the maximum number of files that can be uploaded (max 10).
+     */
+    setMaxValues(maxValues) {
+        this.data.maxValues = maxValues;
+        return this;
+    }
+    /**
+     * Sets whether files are required before submitting the modal.
+     */
+    setRequired(required) {
+        this.data.required = required;
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible file upload component payload.
+     */
+    toJSON() {
+        if (!this.data.customId) {
+            throw new Error("[FileUploadBuilder] custom_id is required.");
+        }
+        return {
+            type: ComponentType.FileUpload,
+            custom_id: this.data.customId,
+            min_values: this.data.minValues,
+            max_values: this.data.maxValues,
+            required: this.data.required,
+        };
+    }
+}

package/dist/builders/LabelBuilder.d.ts

@@ -0,0 +1,35 @@
+import { type APILabelComponent, type APIComponentInLabel } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Values accepted when composing label components. */
+export type LabelComponentLike = JSONEncodable<APIComponentInLabel> | APIComponentInLabel;
+/** Shape describing initial label data accepted by the builder. */
+export type LabelBuilderData = {
+    label?: string;
+    description?: string;
+    component?: LabelComponentLike;
+};
+/** Builder for Discord label components used in modals. */
+export declare class LabelBuilder implements JSONEncodable<APILabelComponent> {
+    private data;
+    /**
+     * Creates a new label builder with optional seed data.
+     */
+    constructor(data?: LabelBuilderData);
+    /**
+     * Sets the label text (max 45 characters).
+     */
+    setLabel(label: string): this;
+    /**
+     * Sets the optional description text (max 100 characters).
+     */
+    setDescription(description: string): this;
+    /**
+     * Sets the component within the label.
+     * Can be a TextInput, SelectMenu, or FileUpload component.
+     */
+    setComponent(component: LabelComponentLike): this;
+    /**
+     * Serialises the builder into an API compatible label component payload.
+     */
+    toJSON(): APILabelComponent;
+}

package/dist/builders/LabelBuilder.js

@@ -0,0 +1,55 @@
+import { ComponentType, } from "discord-api-types/v10";
+import { resolveJSONEncodable } from "./shared.js";
+/** Builder for Discord label components used in modals. */
+export class LabelBuilder {
+    data;
+    /**
+     * Creates a new label builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            label: data.label,
+            description: data.description,
+            component: data.component,
+        };
+    }
+    /**
+     * Sets the label text (max 45 characters).
+     */
+    setLabel(label) {
+        this.data.label = label;
+        return this;
+    }
+    /**
+     * Sets the optional description text (max 100 characters).
+     */
+    setDescription(description) {
+        this.data.description = description;
+        return this;
+    }
+    /**
+     * Sets the component within the label.
+     * Can be a TextInput, SelectMenu, or FileUpload component.
+     */
+    setComponent(component) {
+        this.data.component = component;
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible label component payload.
+     */
+    toJSON() {
+        if (!this.data.label) {
+            throw new Error("[LabelBuilder] label is required.");
+        }
+        if (!this.data.component) {
+            throw new Error("[LabelBuilder] component is required.");
+        }
+        return {
+            type: ComponentType.Label,
+            label: this.data.label,
+            description: this.data.description,
+            component: resolveJSONEncodable(this.data.component),
+        };
+    }
+}

package/dist/builders/ModalBuilder.d.ts

@@ -1,7 +1,7 @@
-import type { APIModalInteractionResponseCallbackComponent, APIModalInteractionResponseCallbackData } from "discord-api-types/v10";
+import type { APIModalInteractionResponseCallbackComponent, APIModalInteractionResponseCallbackData, APITextInputComponent, APIComponentInLabel, APISelectMenuComponent, APIFileUploadComponent } from "discord-api-types/v10";
 import type { JSONEncodable } from "./shared.js";
 /** Values accepted when composing modal component rows. */
-export type ModalComponentLike = JSONEncodable<APIModalInteractionResponseCallbackComponent> | APIModalInteractionResponseCallbackComponent;
+export type ModalComponentLike = JSONEncodable<APIModalInteractionResponseCallbackComponent> | APIModalInteractionResponseCallbackComponent | JSONEncodable<APITextInputComponent> | APITextInputComponent | JSONEncodable<APIComponentInLabel> | APIComponentInLabel | JSONEncodable<APISelectMenuComponent> | APISelectMenuComponent | JSONEncodable<APIFileUploadComponent> | APIFileUploadComponent;
 /** Shape describing initial modal data accepted by the builder. */
 export type ModalBuilderData = {
     customId?: string;

package/dist/builders/ModalBuilder.js

@@ -1,3 +1,4 @@
+import { ComponentType } from "discord-api-types/v10";
 import { resolveJSONEncodable } from "./shared.js";
 /** Builder for Discord modal interaction responses. */
 export class ModalBuilder {
@@ -56,10 +57,35 @@ export class ModalBuilder {
         if (this.components.length > 5) {
             throw new Error("[ModalBuilder] no more than 5 components can be provided.");
         }
+        // Auto-wrap components that need wrapping
+        const normalizedComponents = this.components.map((component) => {
+            const resolved = resolveJSONEncodable(component);
+            if (!resolved ||
+                typeof resolved !== "object" ||
+                !("type" in resolved)) {
+                return resolved;
+            }
+            const componentType = resolved.type;
+            // If it's a TextInput, SelectMenu, or FileUpload component, wrap it in an ActionRow
+            // (ActionRows in modals are deprecated, but still supported for backwards compatibility)
+            if (componentType === ComponentType.TextInput ||
+                componentType === ComponentType.StringSelect ||
+                componentType === ComponentType.UserSelect ||
+                componentType === ComponentType.RoleSelect ||
+                componentType === ComponentType.MentionableSelect ||
+                componentType === ComponentType.ChannelSelect ||
+                componentType === ComponentType.FileUpload) {
+                return {
+                    type: ComponentType.ActionRow,
+                    components: [resolved],
+                };
+            }
+            return resolved;
+        });
         return {
             custom_id: this.customId,
             title: this.title,
-            components: this.components.map((component) => resolveJSONEncodable(component)),
+            components: normalizedComponents,
         };
     }
 }

package/dist/builders/TextInputBuilder.js

@@ -80,9 +80,8 @@ export class TextInputBuilder {
         if (!this.data.customId) {
             throw new Error("[TextInputBuilder] custom_id is required.");
         }
-        if (!this.data.label) {
-            throw new Error("[TextInputBuilder] label is required.");
-        }
+        // Note: label is optional when used inside a LabelComponent
+        // but required when used standalone in an ActionRow
         return {
             type: ComponentType.TextInput,
             custom_id: this.data.customId,

package/dist/builders/index.d.ts

@@ -13,6 +13,10 @@ export { ModalBuilder } from "./ModalBuilder.js";
 export type { ModalBuilderData, ModalComponentLike } from "./ModalBuilder.js";
 export { TextInputBuilder } from "./TextInputBuilder.js";
 export type { TextInputBuilderData } from "./TextInputBuilder.js";
+export { LabelBuilder } from "./LabelBuilder.js";
+export type { LabelBuilderData, LabelComponentLike } from "./LabelBuilder.js";
+export { FileUploadBuilder } from "./FileUploadBuilder.js";
+export type { FileUploadBuilderData } from "./FileUploadBuilder.js";
 export { AutomodRuleBuilder } from "./AutomodRuleBuilder.js";
 export type { AutomodRuleBuilderData } from "./AutomodRuleBuilder.js";
 export { EmbedBuilder } from "./EmbedBuilder.js";

package/dist/builders/index.js

@@ -6,6 +6,8 @@ export { RoleSelectMenuBuilder } from "./RoleSelectMenuBuilder.js";
 export { ChannelSelectMenuBuilder } from "./ChannelSelectMenuBuilder.js";
 export { ModalBuilder } from "./ModalBuilder.js";
 export { TextInputBuilder } from "./TextInputBuilder.js";
+export { LabelBuilder } from "./LabelBuilder.js";
+export { FileUploadBuilder } from "./FileUploadBuilder.js";
 export { AutomodRuleBuilder } from "./AutomodRuleBuilder.js";
 export { EmbedBuilder } from "./EmbedBuilder.js";
 export { ContainerBuilder, SectionBuilder, TextDisplayBuilder, SeparatorBuilder, GalleryBuilder, GalleryItemBuilder, ThumbnailBuilder, } from "./MiniContainerBuilder.js";

package/dist/clients/MiniInteraction.d.ts

@@ -185,6 +185,7 @@ export declare class MiniInteraction {
     private importCommandModule;
     /**
      * Dynamically imports and validates a component module from disk.
+     * Also handles modal components if they're in a "modals" subdirectory.
      */
     private importComponentModule;
     /**

package/dist/clients/MiniInteraction.js

@@ -545,6 +545,7 @@ export class MiniInteraction {
     }
     /**
      * Dynamically imports and validates a component module from disk.
+     * Also handles modal components if they're in a "modals" subdirectory.
      */
     async importComponentModule(absolutePath) {
         try {
@@ -554,11 +555,16 @@ export class MiniInteraction {
                 imported.component ??
                 imported.components ??
                 imported.componentDefinition ??
+                imported.modal ??
+                imported.modals ??
                 imported;
             const candidates = Array.isArray(candidate)
                 ? candidate
                 : [candidate];
             const components = [];
+            // Check if this file is in a "modals" subdirectory
+            const isModalFile = absolutePath.includes(path.sep + "modals" + path.sep) ||
+                absolutePath.includes("/modals/");
             for (const item of candidates) {
                 if (!item || typeof item !== "object") {
                     continue;
@@ -572,9 +578,18 @@ export class MiniInteraction {
                     console.warn(`[MiniInteraction] Component module "${absolutePath}" is missing a "handler" function. Skipping.`);
                     continue;
                 }
-                components.push({ customId, handler });
+                // If it's in a modals directory, register it as a modal
+                if (isModalFile) {
+                    this.useModal({
+                        customId,
+                        handler: handler,
+                    });
+                }
+                else {
+                    components.push({ customId, handler });
+                }
             }
-            if (components.length === 0) {
+            if (components.length === 0 && !isModalFile) {
                 console.warn(`[MiniInteraction] Component module "${absolutePath}" did not export any valid components. Skipping.`);
             }
             return components;
@@ -755,6 +770,7 @@ export class MiniInteraction {
                 },
             };
         }
+        await this.ensureComponentsLoaded();
         const handler = this.modalHandlers.get(customId);
         if (!handler) {
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@minesa-org/mini-interaction",
-	"version": "0.0.6",
+	"version": "0.0.8",
 	"description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
 	"type": "module",
 	"main": "dist/index.js",