@minesa-org/mini-interaction 0.0.12 → 0.0.14

package/dist/clients/MiniInteraction.d.ts

@@ -2,7 +2,7 @@ import type { IncomingMessage, ServerResponse } from "node:http";
 import { APIInteractionResponse, RESTPostAPIChatInputApplicationCommandsJSONBody, RESTPostAPIContextMenuApplicationCommandsJSONBody } from "discord-api-types/v10";
 import type { MiniInteractionCommand } from "../types/Commands.js";
 import { RoleConnectionMetadataTypes } from "../types/RoleConnectionMetadataTypes.js";
-import { type MessageComponentInteraction } from "../utils/MessageComponentInteraction.js";
+import { type MessageComponentInteraction, type ButtonInteraction, type StringSelectInteraction, type RoleSelectInteraction, type UserSelectInteraction, type ChannelSelectInteraction, type MentionableSelectInteraction } from "../utils/MessageComponentInteraction.js";
 import { type ModalSubmitInteraction } from "../utils/ModalSubmitInteraction.js";
 /** Configuration parameters for the MiniInteraction client. */
 export type MiniInteractionOptions = {
@@ -35,12 +35,24 @@ export type MiniInteractionHandlerResult = {
         error: string;
     };
 };
-/** Handler signature invoked for Discord message component interactions. */
+/** Handler signature invoked for Discord button interactions. */
+export type MiniInteractionButtonHandler = (interaction: ButtonInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+/** Handler signature invoked for Discord string select menu interactions. */
+export type MiniInteractionStringSelectHandler = (interaction: StringSelectInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+/** Handler signature invoked for Discord role select menu interactions. */
+export type MiniInteractionRoleSelectHandler = (interaction: RoleSelectInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+/** Handler signature invoked for Discord user select menu interactions. */
+export type MiniInteractionUserSelectHandler = (interaction: UserSelectInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+/** Handler signature invoked for Discord channel select menu interactions. */
+export type MiniInteractionChannelSelectHandler = (interaction: ChannelSelectInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+/** Handler signature invoked for Discord mentionable select menu interactions. */
+export type MiniInteractionMentionableSelectHandler = (interaction: MentionableSelectInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+/** Handler signature invoked for Discord message component interactions (generic). */
 export type MiniInteractionComponentHandler = (interaction: MessageComponentInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
 /** Handler signature invoked for Discord modal submit interactions. */
 export type MiniInteractionModalHandler = (interaction: ModalSubmitInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
-/** Unified handler signature that accepts both component and modal interactions. */
-export type MiniInteractionHandler = MiniInteractionComponentHandler | MiniInteractionModalHandler;
+/** Unified handler signature that accepts any component or modal interaction. */
+export type MiniInteractionHandler = MiniInteractionButtonHandler | MiniInteractionStringSelectHandler | MiniInteractionRoleSelectHandler | MiniInteractionUserSelectHandler | MiniInteractionChannelSelectHandler | MiniInteractionMentionableSelectHandler | MiniInteractionComponentHandler | MiniInteractionModalHandler;
 /**
  * Structure describing a component or modal handler mapped to a custom id.
  * When auto-loading from the components directory:

package/dist/clients/MiniInteraction.js

@@ -8,6 +8,7 @@ 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";
+import { createUserContextMenuInteraction, createMessageContextMenuInteraction, } from "../utils/ContextMenuInteraction.js";
 /** File extensions that are treated as loadable modules when auto-loading. */
 const SUPPORTED_MODULE_EXTENSIONS = new Set([
     ".js",
@@ -842,8 +843,22 @@ export class MiniInteraction {
                 resolvedResponse =
                     response ?? interactionWithHelpers.getResponse();
             }
+            else if (commandInteraction.data.type === ApplicationCommandType.User) {
+                // User context menu command
+                const interactionWithHelpers = createUserContextMenuInteraction(commandInteraction);
+                response = await command.handler(interactionWithHelpers);
+                resolvedResponse =
+                    response ?? interactionWithHelpers.getResponse();
+            }
+            else if (commandInteraction.data.type === ApplicationCommandType.Message) {
+                // Message context menu command
+                const interactionWithHelpers = createMessageContextMenuInteraction(commandInteraction);
+                response = await command.handler(interactionWithHelpers);
+                resolvedResponse =
+                    response ?? interactionWithHelpers.getResponse();
+            }
             else {
-                // Context menu commands (User or Message) - pass raw interaction
+                // Unknown command type
                 response = await command.handler(commandInteraction);
                 resolvedResponse = response ?? null;
             }

package/dist/index.d.ts

@@ -6,10 +6,11 @@ export { UserCommandBuilder, MessageCommandBuilder, } from "./commands/ContextMe
 export type { AttachmentOptionBuilder, ChannelOptionBuilder, MentionableOptionBuilder, NumberOptionBuilder, RoleOptionBuilder, StringOptionBuilder, SubcommandBuilder, SubcommandGroupBuilder, UserOptionBuilder, } from "./commands/CommandBuilder.js";
 export { CommandInteractionOptionResolver, createCommandInteraction, } from "./utils/CommandInteractionOptions.js";
 export type { CommandInteraction, MentionableOption, ResolvedUserOption, } from "./utils/CommandInteractionOptions.js";
+export type { UserContextMenuInteraction, MessageContextMenuInteraction, } from "./utils/ContextMenuInteraction.js";
 export type { MiniInteractionFetchHandler, MiniInteractionNodeHandler, MiniInteractionHandlerResult, MiniInteractionRequest, MiniInteractionOptions, } from "./clients/MiniInteraction.js";
 export type { MiniInteractionCommand, SlashCommandHandler, UserCommandHandler, MessageCommandHandler, CommandHandler, } from "./types/Commands.js";
-export type { MiniInteractionComponent, MiniInteractionComponentHandler, MiniInteractionModal, MiniInteractionModalHandler, MiniInteractionHandler, } from "./clients/MiniInteraction.js";
-export type { MessageComponentInteraction, ResolvedUserOption as ComponentResolvedUserOption, ResolvedMentionableOption as ComponentResolvedMentionableOption, } from "./utils/MessageComponentInteraction.js";
+export type { MiniInteractionComponent, MiniInteractionButtonHandler, MiniInteractionStringSelectHandler, MiniInteractionRoleSelectHandler, MiniInteractionUserSelectHandler, MiniInteractionChannelSelectHandler, MiniInteractionMentionableSelectHandler, MiniInteractionComponentHandler, MiniInteractionModal, MiniInteractionModalHandler, MiniInteractionHandler, } from "./clients/MiniInteraction.js";
+export type { MessageComponentInteraction, ButtonInteraction, StringSelectInteraction, RoleSelectInteraction, UserSelectInteraction, ChannelSelectInteraction, MentionableSelectInteraction, ResolvedUserOption as ComponentResolvedUserOption, ResolvedMentionableOption as ComponentResolvedMentionableOption, } from "./utils/MessageComponentInteraction.js";
 export type { ModalSubmitInteraction } from "./utils/ModalSubmitInteraction.js";
 export { RoleConnectionMetadataTypes } from "./types/RoleConnectionMetadataTypes.js";
 export { ChannelType } from "./types/ChannelType.js";

package/dist/types/Commands.d.ts

@@ -1,12 +1,13 @@
-import type { APIInteractionResponse, RESTPostAPIChatInputApplicationCommandsJSONBody, RESTPostAPIContextMenuApplicationCommandsJSONBody, APIUserApplicationCommandInteraction, APIMessageApplicationCommandInteraction } from "discord-api-types/v10";
+import type { APIInteractionResponse, RESTPostAPIChatInputApplicationCommandsJSONBody, RESTPostAPIContextMenuApplicationCommandsJSONBody } from "discord-api-types/v10";
 import type { CommandInteraction } from "../utils/CommandInteractionOptions.js";
+import type { UserContextMenuInteraction, MessageContextMenuInteraction } from "../utils/ContextMenuInteraction.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;
 /** Handler signature for user context menu command executions within MiniInteraction. */
-export type UserCommandHandler = (interaction: APIUserApplicationCommandInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+export type UserCommandHandler = (interaction: UserContextMenuInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
 /** Handler signature for message context menu command executions within MiniInteraction. */
-export type MessageCommandHandler = (interaction: APIMessageApplicationCommandInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
+export type MessageCommandHandler = (interaction: MessageContextMenuInteraction) => Promise<APIInteractionResponse | void> | APIInteractionResponse | void;
 /** Union of all command handler types. */
 export type CommandHandler = SlashCommandHandler | UserCommandHandler | MessageCommandHandler;
 /** Structure representing a slash command definition and its runtime handler. */

package/dist/utils/ContextMenuInteraction.d.ts

@@ -0,0 +1,36 @@
+import { type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIMessageApplicationCommandInteraction, type APIModalInteractionResponse, type APIModalInteractionResponseCallbackData, type APIUserApplicationCommandInteraction } from "discord-api-types/v10";
+import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageHelpers.js";
+/**
+ * Base helper methods for context menu interactions.
+ */
+type ContextMenuInteractionHelpers = {
+    getResponse: () => APIInteractionResponse | null;
+    reply: (data: InteractionMessageData) => APIInteractionResponseChannelMessageWithSource;
+    deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
+    showModal: (data: APIModalInteractionResponseCallbackData | {
+        toJSON(): APIModalInteractionResponseCallbackData;
+    }) => APIModalInteractionResponse;
+};
+/**
+ * User context menu interaction with helper methods.
+ */
+export type UserContextMenuInteraction = APIUserApplicationCommandInteraction & ContextMenuInteractionHelpers;
+/**
+ * Message context menu interaction with helper methods.
+ */
+export type MessageContextMenuInteraction = APIMessageApplicationCommandInteraction & ContextMenuInteractionHelpers;
+/**
+ * Wraps a raw user context menu interaction with helper methods.
+ *
+ * @param interaction - The raw user context menu interaction payload from Discord.
+ * @returns A helper-augmented interaction object.
+ */
+export declare function createUserContextMenuInteraction(interaction: APIUserApplicationCommandInteraction): UserContextMenuInteraction;
+/**
+ * Wraps a raw message context menu interaction with helper methods.
+ *
+ * @param interaction - The raw message context menu interaction payload from Discord.
+ * @returns A helper-augmented interaction object.
+ */
+export declare function createMessageContextMenuInteraction(interaction: APIMessageApplicationCommandInteraction): MessageContextMenuInteraction;
+export {};

package/dist/utils/ContextMenuInteraction.js

@@ -0,0 +1,94 @@
+import { InteractionResponseType, } from "discord-api-types/v10";
+import { normaliseInteractionMessageData, normaliseMessageFlags, } from "./interactionMessageHelpers.js";
+/**
+ * Wraps a raw user context menu interaction with helper methods.
+ *
+ * @param interaction - The raw user context menu interaction payload from Discord.
+ * @returns A helper-augmented interaction object.
+ */
+export function createUserContextMenuInteraction(interaction) {
+    let capturedResponse = null;
+    const reply = (data) => {
+        const normalised = normaliseInteractionMessageData(data);
+        if (!normalised) {
+            throw new Error("[MiniInteraction] Channel message responses require data to be provided.");
+        }
+        const response = {
+            type: InteractionResponseType.ChannelMessageWithSource,
+            data: normalised,
+        };
+        capturedResponse = response;
+        return response;
+    };
+    const deferReply = (options = {}) => {
+        const flags = normaliseMessageFlags(options.flags);
+        const response = {
+            type: InteractionResponseType.DeferredChannelMessageWithSource,
+            data: flags ? { flags } : undefined,
+        };
+        capturedResponse = response;
+        return response;
+    };
+    const showModal = (data) => {
+        const modalData = typeof data === "object" && "toJSON" in data ? data.toJSON() : data;
+        const response = {
+            type: InteractionResponseType.Modal,
+            data: modalData,
+        };
+        capturedResponse = response;
+        return response;
+    };
+    const getResponse = () => capturedResponse;
+    return Object.assign(interaction, {
+        reply,
+        deferReply,
+        showModal,
+        getResponse,
+    });
+}
+/**
+ * Wraps a raw message context menu interaction with helper methods.
+ *
+ * @param interaction - The raw message context menu interaction payload from Discord.
+ * @returns A helper-augmented interaction object.
+ */
+export function createMessageContextMenuInteraction(interaction) {
+    let capturedResponse = null;
+    const reply = (data) => {
+        const normalised = normaliseInteractionMessageData(data);
+        if (!normalised) {
+            throw new Error("[MiniInteraction] Channel message responses require data to be provided.");
+        }
+        const response = {
+            type: InteractionResponseType.ChannelMessageWithSource,
+            data: normalised,
+        };
+        capturedResponse = response;
+        return response;
+    };
+    const deferReply = (options = {}) => {
+        const flags = normaliseMessageFlags(options.flags);
+        const response = {
+            type: InteractionResponseType.DeferredChannelMessageWithSource,
+            data: flags ? { flags } : undefined,
+        };
+        capturedResponse = response;
+        return response;
+    };
+    const showModal = (data) => {
+        const modalData = typeof data === "object" && "toJSON" in data ? data.toJSON() : data;
+        const response = {
+            type: InteractionResponseType.Modal,
+            data: modalData,
+        };
+        capturedResponse = response;
+        return response;
+    };
+    const getResponse = () => capturedResponse;
+    return Object.assign(interaction, {
+        reply,
+        deferReply,
+        showModal,
+        getResponse,
+    });
+}

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 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 } from "discord-api-types/v10";
 import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageHelpers.js";
 /** Resolved user option including optional guild member data. */
 export type ResolvedUserOption = {
@@ -13,6 +13,66 @@ export type ResolvedMentionableOption = {
     type: "role";
     value: APIRole;
 };
+/**
+ * Base helper methods available on all component interactions.
+ */
+type BaseComponentInteractionHelpers = {
+    getResponse: () => APIInteractionResponse | null;
+    reply: (data: InteractionMessageData) => APIInteractionResponseChannelMessageWithSource;
+    deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
+    update: (data?: InteractionMessageData) => APIInteractionResponseUpdateMessage;
+    deferUpdate: () => APIInteractionResponseDeferredMessageUpdate;
+    showModal: (data: APIModalInteractionResponseCallbackData | {
+        toJSON(): APIModalInteractionResponseCallbackData;
+    }) => APIModalInteractionResponse;
+};
+/**
+ * Button interaction with helper methods.
+ * Buttons don't have values or resolved data.
+ */
+export type ButtonInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+    data: APIMessageButtonInteractionData;
+} & BaseComponentInteractionHelpers;
+/**
+ * String select menu interaction with helper methods.
+ */
+export type StringSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+    data: APIMessageStringSelectInteractionData;
+    values: string[];
+    getStringValues: () => string[];
+} & BaseComponentInteractionHelpers;
+/**
+ * Role select menu interaction with helper methods.
+ */
+export type RoleSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+    data: APIMessageRoleSelectInteractionData;
+    values: string[];
+    getRoles: () => APIRole[];
+} & BaseComponentInteractionHelpers;
+/**
+ * User select menu interaction with helper methods.
+ */
+export type UserSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+    data: APIMessageUserSelectInteractionData;
+    values: string[];
+    getUsers: () => ResolvedUserOption[];
+} & BaseComponentInteractionHelpers;
+/**
+ * Channel select menu interaction with helper methods.
+ */
+export type ChannelSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+    data: APIMessageChannelSelectInteractionData;
+    values: string[];
+    getChannels: () => APIInteractionDataResolvedChannel[];
+} & BaseComponentInteractionHelpers;
+/**
+ * Mentionable select menu interaction with helper methods.
+ */
+export type MentionableSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+    data: APIMessageMentionableSelectInteractionData;
+    values: string[];
+    getMentionables: () => ResolvedMentionableOption[];
+} & BaseComponentInteractionHelpers;
 /**
  * Represents a component interaction augmented with helper response methods.
  *
@@ -67,3 +127,4 @@ export type MessageComponentInteraction = APIMessageComponentInteraction & {
  * @returns A helper-augmented interaction object.
  */
 export declare function createMessageComponentInteraction(interaction: APIMessageComponentInteraction): MessageComponentInteraction;
+export {};

package/package.json

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