@minesa-org/mini-interaction 0.0.13 → 0.0.14

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,6 +6,7 @@ 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, MiniInteractionButtonHandler, MiniInteractionStringSelectHandler, MiniInteractionRoleSelectHandler, MiniInteractionUserSelectHandler, MiniInteractionChannelSelectHandler, MiniInteractionMentionableSelectHandler, MiniInteractionComponentHandler, MiniInteractionModal, MiniInteractionModalHandler, MiniInteractionHandler, } from "./clients/MiniInteraction.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/package.json

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