@minesa-org/mini-interaction 0.3.9 → 0.3.13

package/dist/builders/ModalBuilder.js

@@ -74,7 +74,8 @@ export class ModalBuilder {
                 componentType === ComponentType.RoleSelect ||
                 componentType === ComponentType.MentionableSelect ||
                 componentType === ComponentType.ChannelSelect ||
-                componentType === ComponentType.FileUpload) {
+                componentType === ComponentType.FileUpload ||
+                componentType === ComponentType.Label) {
                 return {
                     type: ComponentType.ActionRow,
                     components: [resolved],

package/dist/builders/ModalChannelSelectMenuBuilder.d.ts

@@ -1,4 +1,4 @@
-import { SelectMenuDefaultValueType, type APIChannelSelectComponent, type APISelectMenuDefaultValue } from "discord-api-types/v10";
+import { SelectMenuDefaultValueType, type APIChannelSelectComponent, type APISelectMenuDefaultValue, ChannelType } from "discord-api-types/v10";
 import type { JSONEncodable } from "./shared.js";
 /** Shape describing initial modal channel select menu data accepted by the builder. */
 export type ModalChannelSelectMenuBuilderData = {
@@ -8,6 +8,7 @@ export type ModalChannelSelectMenuBuilderData = {
     maxValues?: number;
     disabled?: boolean;
     required?: boolean;
+    channelTypes?: ChannelType[];
     defaultValues?: APISelectMenuDefaultValue<SelectMenuDefaultValueType.Channel>[];
 };
 /** Builder for Discord channel select menu components in modals. */
@@ -45,6 +46,14 @@ export declare class ModalChannelSelectMenuBuilder implements JSONEncodable<APIC
      * Replaces the default channel selections displayed when the menu renders.
      */
     setDefaultValues(defaultValues: Iterable<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Channel>>): this;
+    /**
+     * Sets the channel types allowed in the select menu.
+     */
+    setChannelTypes(...channelTypes: ChannelType[]): this;
+    /**
+     * Adds channel types allowed in the select menu.
+     */
+    addChannelTypes(...channelTypes: ChannelType[]): this;
     /**
      * Serialises the builder into an API compatible channel select menu payload.
      */

package/dist/builders/ModalChannelSelectMenuBuilder.js

@@ -13,6 +13,7 @@ export class ModalChannelSelectMenuBuilder {
             maxValues: data.maxValues,
             disabled: data.disabled,
             required: data.required,
+            channelTypes: data.channelTypes,
             defaultValues: data.defaultValues
                 ? data.defaultValues.map((value) => ({
                     ...value,
@@ -73,6 +74,21 @@ export class ModalChannelSelectMenuBuilder {
         }));
         return this;
     }
+    /**
+     * Sets the channel types allowed in the select menu.
+     */
+    setChannelTypes(...channelTypes) {
+        this.data.channelTypes = channelTypes.flat();
+        return this;
+    }
+    /**
+     * Adds channel types allowed in the select menu.
+     */
+    addChannelTypes(...channelTypes) {
+        this.data.channelTypes ??= [];
+        this.data.channelTypes.push(...channelTypes.flat());
+        return this;
+    }
     /**
      * Serialises the builder into an API compatible channel select menu payload.
      */
@@ -89,6 +105,7 @@ export class ModalChannelSelectMenuBuilder {
             max_values: this.data.maxValues,
             disabled: this.data.disabled,
             required: this.data.required,
+            channel_types: this.data.channelTypes,
             default_values: this.data.defaultValues?.map((value) => ({
                 ...value,
                 type: SelectMenuDefaultValueType.Channel,

package/dist/clients/MiniInteraction.d.ts

@@ -12,6 +12,7 @@ export type InteractionClientOptions = {
     commandsDirectory?: string | false;
     componentsDirectory?: string | false;
     utilsDirectory?: string | false;
+    debug?: boolean;
     fetchImplementation?: typeof fetch;
     verifyKeyImplementation?: VerifyKeyFunction;
     timeoutConfig?: InteractionTimeoutConfig;
@@ -178,6 +179,7 @@ export declare class MiniInteraction {
     private readonly commandsDirectory;
     private readonly componentsDirectory;
     readonly utilsDirectory: string | null;
+    private readonly debug;
     private readonly timeoutConfig;
     private readonly commands;
     private readonly componentHandlers;
@@ -196,6 +198,7 @@ export declare class MiniInteraction {
      * Creates a new MiniInteraction client with optional command auto-loading and custom runtime hooks.
      */
     constructor(options?: InteractionClientOptions);
+    private log;
     private trackInteractionState;
     /**
      * Checks if an interaction can still respond (not expired and not already responded).

package/dist/clients/MiniInteraction.js

@@ -31,6 +31,7 @@ export class MiniInteraction {
     commandsDirectory;
     componentsDirectory;
     utilsDirectory;
+    debug;
     timeoutConfig;
     commands = new Map();
     componentHandlers = new Map();
@@ -54,7 +55,8 @@ export class MiniInteraction {
             // @ts-ignore - Optional dependency, may not have types available during build
             import("dotenv/config").catch(() => { });
         }
-        const { applicationId, publicKey, commandsDirectory, componentsDirectory, utilsDirectory, fetchImplementation, verifyKeyImplementation, timeoutConfig, } = options;
+        const { applicationId, publicKey, commandsDirectory, componentsDirectory, utilsDirectory, debug, fetchImplementation, verifyKeyImplementation, timeoutConfig, } = options;
+        this.debug = debug ?? (typeof process !== "undefined" ? process.env.DEBUG === "true" || process.env.MINI_DEBUG === "true" : false);
         const resolvedAppId = applicationId ?? (typeof process !== "undefined" ? process.env.DISCORD_APPLICATION_ID : undefined);
         const resolvedPublicKey = publicKey ?? (typeof process !== "undefined" ? (process.env.DISCORD_PUBLIC_KEY ?? process.env.DISCORD_APP_PUBLIC_KEY) : undefined);
         const fetchImpl = fetchImplementation ?? globalThis.fetch;
@@ -85,6 +87,11 @@ export class MiniInteraction {
             ...timeoutConfig,
         };
     }
+    log(message, ...args) {
+        if (this.debug) {
+            console.log(`[MiniInteraction] ${message}`, ...args);
+        }
+    }
     trackInteractionState(interactionId, token, state) {
         const now = Date.now();
         this.interactionStates.set(interactionId, {
@@ -856,6 +863,9 @@ export class MiniInteraction {
      * Recursively collects all command module file paths from the target directory.
      */
     async collectModuleFiles(directory) {
+        if (this.debug) {
+            this.log(`Collecting module files from: ${directory}`);
+        }
         const entries = await readdir(directory, { withFileTypes: true });
         const files = [];
         for (const entry of entries) {
@@ -891,6 +901,7 @@ export class MiniInteraction {
     async importCommandModule(absolutePath) {
         try {
             const moduleUrl = pathToFileURL(absolutePath).href;
+            this.log(`Dynamically importing command: ${moduleUrl}`);
             const imported = await import(moduleUrl);
             // Try to find a command object from various export patterns
             let candidate = imported.default ??
@@ -954,6 +965,7 @@ export class MiniInteraction {
     async importComponentModule(absolutePath) {
         try {
             const moduleUrl = pathToFileURL(absolutePath).href;
+            this.log(`Dynamically importing component: ${moduleUrl}`);
             const imported = await import(moduleUrl);
             // Collect all potential component candidates
             const candidates = [];
@@ -1139,10 +1151,17 @@ export class MiniInteraction {
             pushCandidate(path.resolve(root, defaultFolder));
         }
         for (const candidate of candidates) {
-            if (existsSync(candidate)) {
+            const exists = existsSync(candidate);
+            if (this.debug) {
+                this.log(`Checking directory: ${candidate} (exists: ${exists})`);
+            }
+            if (exists) {
                 return candidate;
             }
         }
+        if (this.debug) {
+            this.log(`No existing directory found for ${defaultFolder}, using default candidate: ${candidates[0]}`);
+        }
         return candidates[0];
     }
     /**

package/dist/utils/MessageComponentInteraction.d.ts

@@ -1,4 +1,4 @@
-import { type APIInteractionDataResolvedChannel, type APIInteractionDataResolvedGuildMember, type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIInteractionResponseDeferredMessageUpdate, type APIInteractionResponseUpdateMessage, type APIMessageComponentInteraction, type APIMessageButtonInteractionData, type APIMessageChannelSelectInteractionData, type APIMessageMentionableSelectInteractionData, type APIMessageRoleSelectInteractionData, type APIMessageStringSelectInteractionData, type APIMessageUserSelectInteractionData, type APIModalInteractionResponse, type APIModalInteractionResponseCallbackData, type APIRole, type APIUser } from "discord-api-types/v10";
+import { type APIInteractionDataResolvedChannel, type APIInteractionDataResolvedGuildMember, type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIInteractionResponseDeferredMessageUpdate, type APIInteractionResponseUpdateMessage, type APIMessageComponentInteraction, type APIMessageButtonInteractionData, type APIMessageChannelSelectInteractionData, type APIMessageMentionableSelectInteractionData, type APIMessageRoleSelectInteractionData, type APIMessageStringSelectInteractionData, type APIMessageUserSelectInteractionData, type APIModalInteractionResponse, type APIModalInteractionResponseCallbackData, type APIRole, type APIUser, type APIAttachment } from "discord-api-types/v10";
 import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageHelpers.js";
 /** Resolved user option including optional guild member data. */
 export type ResolvedUserOption = {
@@ -183,21 +183,29 @@ export type MessageComponentInteraction = APIMessageComponentInteraction & {
      * @returns Array of resolved role objects, or empty array if not a role select menu
      */
     getRoles: () => APIRole[];
+    getRole: () => APIRole | undefined;
     /**
      * Helper method to get selected channels from a channel select menu.
      * @returns Array of resolved channel objects, or empty array if not a channel select menu
      */
     getChannels: () => APIInteractionDataResolvedChannel[];
+    getChannel: () => APIInteractionDataResolvedChannel | undefined;
     /**
      * Helper method to get selected users from a user select menu.
      * @returns Array of resolved user objects (with optional member data), or empty array if not a user select menu
      */
     getUsers: () => ResolvedUserOption[];
+    getUser: () => ResolvedUserOption | undefined;
     /**
      * Helper method to get selected mentionables from a mentionable select menu.
      * @returns Array of resolved mentionable objects (users or roles), or empty array if not a mentionable select menu
      */
     getMentionables: () => ResolvedMentionableOption[];
+    getMentionable: () => ResolvedMentionableOption | undefined;
+    /**
+     * Helper method to get an attachment value (if applicable).
+     */
+    getAttachment: () => APIAttachment | undefined;
 };
 export declare const MessageComponentInteraction: {};
 /**

package/dist/utils/MessageComponentInteraction.js

@@ -160,6 +160,7 @@ export function createMessageComponentInteraction(interaction, helpers) {
         }
         return roles;
     };
+    const getRole = () => getRoles()[0];
     const getChannels = () => {
         if (!values) {
             return [];
@@ -180,6 +181,7 @@ export function createMessageComponentInteraction(interaction, helpers) {
         }
         return channels;
     };
+    const getChannel = () => getChannels()[0];
     const getUsers = () => {
         if (!values) {
             return [];
@@ -201,6 +203,7 @@ export function createMessageComponentInteraction(interaction, helpers) {
         }
         return users;
     };
+    const getUser = () => getUsers()[0];
     const getMentionables = () => {
         if (!values) {
             return [];
@@ -229,6 +232,15 @@ export function createMessageComponentInteraction(interaction, helpers) {
         }
         return mentionables;
     };
+    const getMentionable = () => getMentionables()[0];
+    const getAttachment = () => {
+        if (!values || values.length === 0)
+            return undefined;
+        const resolved = "resolved" in interaction.data
+            ? interaction.data.resolved
+            : undefined;
+        return resolved?.attachments?.[values[0]];
+    };
     return Object.assign(interaction, {
         reply,
         deferReply,
@@ -240,9 +252,14 @@ export function createMessageComponentInteraction(interaction, helpers) {
         values,
         getStringValues,
         getRoles,
+        getRole,
         getChannels,
+        getChannel,
         getUsers,
+        getUser,
         getMentionables,
+        getMentionable,
+        getAttachment,
         onAck: helpers?.onAck,
         sendFollowUp: helpers?.sendFollowUp,
         canRespond: helpers?.canRespond,

package/dist/utils/ModalSubmitInteraction.d.ts

@@ -1,5 +1,6 @@
-import { type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIModalSubmitInteraction } from "discord-api-types/v10";
+import { type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIModalSubmitInteraction, type APIRole, type APIInteractionDataResolvedChannel, type APIAttachment } from "discord-api-types/v10";
 import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageHelpers.js";
+import type { ResolvedUserOption } from "./MessageComponentInteraction.js";
 /**
  * Represents a modal submit interaction augmented with helper response methods.
  */
@@ -7,9 +8,6 @@ export type ModalSubmitInteraction = APIModalSubmitInteraction & {
     getResponse: () => APIInteractionResponse | null;
     reply: (data: InteractionMessageData) => Promise<APIInteractionResponseChannelMessageWithSource>;
     deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
-    /**
-     * Helper method to get the value of a text input component by its custom ID.
-     */
     /**
      * Helper method to get the value of a text input component by its custom ID.
      */
@@ -23,6 +21,25 @@ export type ModalSubmitInteraction = APIModalSubmitInteraction & {
      * Returns string for text inputs, string[] for select menus, or undefined.
      */
     getComponentValue: (customId: string) => string | string[] | undefined;
+    /**
+     * Helper method to get selected roles from a role select menu in the modal.
+     */
+    getRoles: (customId: string) => APIRole[];
+    getRole: (customId: string) => APIRole | undefined;
+    /**
+     * Helper method to get selected users from a user select menu in the modal.
+     */
+    getUsers: (customId: string) => ResolvedUserOption[];
+    getUser: (customId: string) => ResolvedUserOption | undefined;
+    /**
+     * Helper method to get selected channels from a channel select menu in the modal.
+     */
+    getChannels: (customId: string) => APIInteractionDataResolvedChannel[];
+    getChannel: (customId: string) => APIInteractionDataResolvedChannel | undefined;
+    /**
+     * Helper method to get an attachment value (e.g. from FileUpload component).
+     */
+    getAttachment: (customId: string) => APIAttachment | undefined;
     /**
      * Finalise the interaction response via a webhook follow-up.
      * This is automatically called by reply() if the interaction is deferred.

package/dist/utils/ModalSubmitInteraction.js

@@ -137,6 +137,56 @@ export function createModalSubmitInteraction(interaction, helpers) {
         }
         return getSelectMenuValues(customId);
     };
+    const getRoles = (customId) => {
+        const values = getSelectMenuValues(customId);
+        const resolved = interaction.data.resolved;
+        if (!values || !resolved?.roles)
+            return [];
+        const roles = [];
+        for (const id of values) {
+            const role = resolved.roles[id];
+            if (role)
+                roles.push(role);
+        }
+        return roles;
+    };
+    const getRole = (customId) => getRoles(customId)[0];
+    const getUsers = (customId) => {
+        const values = getSelectMenuValues(customId);
+        const resolved = interaction.data.resolved;
+        if (!values || !resolved?.users)
+            return [];
+        const users = [];
+        for (const id of values) {
+            const user = resolved.users[id];
+            if (user) {
+                const member = resolved.members?.[id];
+                users.push({ user, member });
+            }
+        }
+        return users;
+    };
+    const getUser = (customId) => getUsers(customId)[0];
+    const getChannels = (customId) => {
+        const values = getSelectMenuValues(customId);
+        const resolved = interaction.data.resolved;
+        if (!values || !resolved?.channels)
+            return [];
+        const channels = [];
+        for (const id of values) {
+            const channel = resolved.channels[id];
+            if (channel)
+                channels.push(channel);
+        }
+        return channels;
+    };
+    const getChannel = (customId) => getChannels(customId)[0];
+    const getAttachment = (customId) => {
+        const value = getComponentValue(customId);
+        if (!value || Array.isArray(value))
+            return undefined;
+        return interaction.data.resolved?.attachments?.[value];
+    };
     return Object.assign(interaction, {
         reply,
         deferReply,
@@ -145,6 +195,13 @@ export function createModalSubmitInteraction(interaction, helpers) {
         getTextFieldValue,
         getSelectMenuValues,
         getComponentValue,
+        getRoles,
+        getRole,
+        getUsers,
+        getUser,
+        getChannels,
+        getChannel,
+        getAttachment,
         sendFollowUp: helpers?.sendFollowUp,
         canRespond: helpers?.canRespond,
         trackResponse: helpers?.trackResponse,

package/package.json

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