@minesa-org/mini-interaction 0.2.6 → 0.2.7

package/dist/clients/MiniInteraction.js

@@ -1273,9 +1273,9 @@ export class MiniInteraction {
                 }
                 else if (commandInteraction.data.type ===
                     ApplicationCommandType.User) {
-                    // User context menu command
                     const interactionWithHelpers = createUserContextMenuInteraction(commandInteraction, {
                         onAck: (response) => ackResolver?.(response),
+                        sendFollowUp,
                     });
                     response = await command.handler(interactionWithHelpers);
                     resolvedResponse =
@@ -1285,6 +1285,7 @@ export class MiniInteraction {
                     ApplicationCommandType.PrimaryEntryPoint) {
                     const interactionWithHelpers = createAppCommandInteraction(commandInteraction, {
                         onAck: (response) => ackResolver?.(response),
+                        sendFollowUp,
                     });
                     response = await command.handler(interactionWithHelpers);
                     resolvedResponse =
@@ -1295,6 +1296,7 @@ export class MiniInteraction {
                     // Message context menu command
                     const interactionWithHelpers = createMessageContextMenuInteraction(commandInteraction, {
                         onAck: (response) => ackResolver?.(response),
+                        sendFollowUp,
                     });
                     response = await command.handler(interactionWithHelpers);
                     resolvedResponse =
@@ -1305,9 +1307,15 @@ export class MiniInteraction {
                     response = await command.handler(commandInteraction);
                     resolvedResponse = response ?? null;
                 }
+                if (this.timeoutConfig.enableResponseDebugLogging) {
+                    console.log(`[MiniInteraction] Command handler finished: "${commandName}"`);
+                }
                 return resolvedResponse;
             }, this.timeoutConfig.initialResponseTimeout, `Command "${commandName}"`, this.timeoutConfig.enableTimeoutWarnings, ackPromise);
             const finalResponse = await timeoutWrapper();
+            if (this.timeoutConfig.enableResponseDebugLogging) {
+                console.log(`[MiniInteraction] handleApplicationCommand: initial response determined (type=${finalResponse?.type})`);
+            }
             if (!finalResponse) {
                 console.error(`[MiniInteraction] Command "${commandName}" did not return a response. ` +
                     "This indicates the handler completed but no response was generated. " +
@@ -1352,8 +1360,14 @@ export class MiniInteraction {
         const url = isEdit
             ? `${DISCORD_BASE_URL}/webhooks/${this.applicationId}/${token}/messages/${messageId}`
             : `${DISCORD_BASE_URL}/webhooks/${this.applicationId}/${token}`;
+        if (this.timeoutConfig.enableResponseDebugLogging) {
+            console.log(`[MiniInteraction] sendFollowUp: id=${messageId || 'new'}, edit=${isEdit}, url=${url}`);
+        }
         // Only send follow-up if there is data to send
         if (!('data' in response) || !response.data) {
+            if (this.timeoutConfig.enableResponseDebugLogging) {
+                console.warn(`[MiniInteraction] sendFollowUp cancelled: no data in response object`);
+            }
             return;
         }
         try {
@@ -1364,6 +1378,9 @@ export class MiniInteraction {
                 },
                 body: JSON.stringify(response.data),
             });
+            if (this.timeoutConfig.enableResponseDebugLogging) {
+                console.log(`[MiniInteraction] sendFollowUp response: [${fetchResponse.status}] ${fetchResponse.statusText}`);
+            }
             if (!fetchResponse.ok) {
                 const errorBody = await fetchResponse.text();
                 console.error(`[MiniInteraction] Failed to send follow-up response: [${fetchResponse.status}] ${errorBody}`);

package/dist/utils/ContextMenuInteraction.d.ts

@@ -3,16 +3,17 @@ import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageH
 /**
  * Base helper methods for context menu interactions.
  */
-type ContextMenuInteractionHelpers = {
+export type ContextMenuInteractionHelpers = {
     getResponse: () => APIInteractionResponse | null;
     reply: (data: InteractionMessageData) => APIInteractionResponseChannelMessageWithSource;
-    followUp: (data: InteractionMessageData) => APIInteractionResponseChannelMessageWithSource;
-    editReply: (data?: InteractionMessageData) => APIInteractionResponseUpdateMessage;
+    followUp: (data: InteractionMessageData) => Promise<APIInteractionResponseChannelMessageWithSource>;
+    editReply: (data?: InteractionMessageData) => Promise<APIInteractionResponseUpdateMessage>;
     deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
     onAck?: (response: APIInteractionResponse) => void;
+    sendFollowUp?: (token: string, response: APIInteractionResponse, messageId?: string) => Promise<void>;
 };
 /**
  * User context menu interaction with helper methods.
@@ -39,27 +40,32 @@ export declare const AppCommandInteraction: {};
  * Wraps a raw user context menu interaction with helper methods.
  *
  * @param interaction - The raw user context menu interaction payload from Discord.
+ * @param helpers - Optional callback helpers.
  * @returns A helper-augmented interaction object.
  */
 export declare function createUserContextMenuInteraction(interaction: APIUserApplicationCommandInteraction, helpers?: {
     onAck?: (response: APIInteractionResponse) => void;
+    sendFollowUp?: (token: string, response: APIInteractionResponse, messageId?: string) => Promise<void>;
 }): UserContextMenuInteraction;
 /**
  * Wraps a raw message context menu interaction with helper methods.
  *
  * @param interaction - The raw message context menu interaction payload from Discord.
+ * @param helpers - Optional callback helpers.
  * @returns A helper-augmented interaction object.
  */
 export declare function createMessageContextMenuInteraction(interaction: APIMessageApplicationCommandInteraction, helpers?: {
     onAck?: (response: APIInteractionResponse) => void;
+    sendFollowUp?: (token: string, response: APIInteractionResponse, messageId?: string) => Promise<void>;
 }): MessageContextMenuInteraction;
 /**
  * Wraps a raw primary entry point interaction with helper methods.
  *
  * @param interaction - The raw primary entry point interaction payload from Discord.
+ * @param helpers - Optional callback helpers.
  * @returns A helper-augmented interaction object.
  */
 export declare function createAppCommandInteraction(interaction: APIPrimaryEntryPointCommandInteraction, helpers?: {
     onAck?: (response: APIInteractionResponse) => void;
+    sendFollowUp?: (token: string, response: APIInteractionResponse, messageId?: string) => Promise<void>;
 }): AppCommandInteraction;
-export {};

package/dist/utils/ContextMenuInteraction.js

@@ -3,8 +3,10 @@ import { normaliseInteractionMessageData, normaliseMessageFlags, } from "./inter
 export const UserContextMenuInteraction = {};
 export const MessageContextMenuInteraction = {};
 export const AppCommandInteraction = {};
-function createContextMenuInteractionHelpers(helpers) {
+function createContextMenuInteractionHelpers(interaction, helpers) {
     let capturedResponse = null;
+    let isDeferred = false;
+    let hasResponded = false;
     const captureResponse = (response) => {
         capturedResponse = response;
         return response;
@@ -27,17 +29,32 @@ function createContextMenuInteractionHelpers(helpers) {
     }
     const reply = (data) => {
         const response = createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
+        hasResponded = true;
         helpers?.onAck?.(response);
         return response;
     };
-    const followUp = (data) => createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
-    const editReply = (data) => createMessageResponse(InteractionResponseType.UpdateMessage, data);
+    const followUp = async (data) => {
+        const response = createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
+        if (helpers?.sendFollowUp) {
+            await helpers.sendFollowUp(interaction.token, response, '');
+        }
+        return response;
+    };
+    const editReply = async (data) => {
+        const response = createMessageResponse(InteractionResponseType.UpdateMessage, data);
+        if (helpers?.sendFollowUp && (isDeferred || hasResponded)) {
+            await helpers.sendFollowUp(interaction.token, response, '@original');
+        }
+        hasResponded = true;
+        return response;
+    };
     const deferReply = (options = {}) => {
         const flags = normaliseMessageFlags(options.flags);
         const response = captureResponse({
             type: InteractionResponseType.DeferredChannelMessageWithSource,
             data: flags ? { flags } : undefined,
         });
+        isDeferred = true;
         helpers?.onAck?.(response);
         return response;
     };
@@ -56,17 +73,18 @@ function createContextMenuInteractionHelpers(helpers) {
         editReply,
         deferReply,
         showModal,
-        onAck: helpers?.onAck,
+        sendFollowUp: helpers?.sendFollowUp,
     };
 }
 /**
  * Wraps a raw user context menu interaction with helper methods.
  *
  * @param interaction - The raw user context menu interaction payload from Discord.
+ * @param helpers - Optional callback helpers.
  * @returns A helper-augmented interaction object.
  */
 export function createUserContextMenuInteraction(interaction, helpers) {
-    return Object.assign(interaction, createContextMenuInteractionHelpers(helpers), {
+    return Object.assign(interaction, createContextMenuInteractionHelpers(interaction, helpers), {
         targetUser: resolveTargetUser(interaction),
     });
 }
@@ -74,10 +92,11 @@ export function createUserContextMenuInteraction(interaction, helpers) {
  * Wraps a raw message context menu interaction with helper methods.
  *
  * @param interaction - The raw message context menu interaction payload from Discord.
+ * @param helpers - Optional callback helpers.
  * @returns A helper-augmented interaction object.
  */
 export function createMessageContextMenuInteraction(interaction, helpers) {
-    return Object.assign(interaction, createContextMenuInteractionHelpers(helpers), {
+    return Object.assign(interaction, createContextMenuInteractionHelpers(interaction, helpers), {
         targetMessage: resolveTargetMessage(interaction),
     });
 }
@@ -85,10 +104,11 @@ export function createMessageContextMenuInteraction(interaction, helpers) {
  * Wraps a raw primary entry point interaction with helper methods.
  *
  * @param interaction - The raw primary entry point interaction payload from Discord.
+ * @param helpers - Optional callback helpers.
  * @returns A helper-augmented interaction object.
  */
 export function createAppCommandInteraction(interaction, helpers) {
-    return Object.assign(interaction, createContextMenuInteractionHelpers(helpers));
+    return Object.assign(interaction, createContextMenuInteractionHelpers(interaction, helpers));
 }
 function resolveTargetMessage(interaction) {
     const targetId = interaction.data?.target_id;

package/package.json

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