@minesa-org/mini-interaction 0.3.10 → 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/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.10",
+	"version": "0.3.13",
 	"description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
 	"type": "module",
 	"main": "dist/index.js",