@minesa-org/mini-interaction 0.2.6 → 0.2.8

package/dist/clients/MiniInteraction.js

@@ -1126,14 +1126,15 @@ export class MiniInteraction {
             const interactionWithHelpers = createMessageComponentInteraction(interaction, {
                 onAck: (response) => ackResolver?.(response),
                 sendFollowUp,
+                trackResponse: (id, token, state) => this.trackInteractionState(id, token, state),
+                canRespond: (id) => this.canRespond(id),
             });
             // Wrap component handler with timeout and acknowledgment
             const timeoutWrapper = createTimeoutWrapper(async () => {
                 const response = await handler(interactionWithHelpers);
                 const resolvedResponse = response ?? interactionWithHelpers.getResponse();
-                if (!resolvedResponse) {
-                    throw new Error(`Component "${customId}" did not return a response. ` +
-                        "Return an APIInteractionResponse to acknowledge the interaction.");
+                if (this.timeoutConfig.enableResponseDebugLogging) {
+                    console.log(`[MiniInteraction] Component handler finished: "${customId}"`);
                 }
                 return resolvedResponse;
             }, this.timeoutConfig.initialResponseTimeout, `Component "${customId}"`, this.timeoutConfig.enableTimeoutWarnings, ackPromise);
@@ -1191,14 +1192,15 @@ export class MiniInteraction {
             const interactionWithHelpers = createModalSubmitInteraction(interaction, {
                 onAck: (response) => ackResolver?.(response),
                 sendFollowUp,
+                trackResponse: (id, token, state) => this.trackInteractionState(id, token, state),
+                canRespond: (id) => this.canRespond(id),
             });
             // Wrap modal handler with timeout and acknowledgment
             const timeoutWrapper = createTimeoutWrapper(async () => {
                 const response = await handler(interactionWithHelpers);
                 const resolvedResponse = response ?? interactionWithHelpers.getResponse();
-                if (!resolvedResponse) {
-                    throw new Error(`Modal "${customId}" did not return a response. ` +
-                        "Return an APIInteractionResponse to acknowledge the interaction.");
+                if (this.timeoutConfig.enableResponseDebugLogging) {
+                    console.log(`[MiniInteraction] Modal handler finished: "${customId}"`);
                 }
                 return resolvedResponse;
             }, this.timeoutConfig.initialResponseTimeout, `Modal "${customId}"`, this.timeoutConfig.enableTimeoutWarnings, ackPromise);
@@ -1273,9 +1275,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 +1287,7 @@ export class MiniInteraction {
                     ApplicationCommandType.PrimaryEntryPoint) {
                     const interactionWithHelpers = createAppCommandInteraction(commandInteraction, {
                         onAck: (response) => ackResolver?.(response),
+                        sendFollowUp,
                     });
                     response = await command.handler(interactionWithHelpers);
                     resolvedResponse =
@@ -1295,6 +1298,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 +1309,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 +1362,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 +1380,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/CommandInteractionOptions.js

@@ -479,6 +479,7 @@ export function createCommandInteraction(interaction, helpers) {
         canRespond: helpers?.canRespond,
         trackResponse: helpers?.trackResponse,
         onAck: helpers?.onAck,
+        sendFollowUp: helpers?.sendFollowUp,
     };
     return commandInteraction;
 }

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/dist/utils/MessageComponentInteraction.d.ts

@@ -22,6 +22,8 @@ export type BaseComponentInteractionHelpers = {
     trackTiming?: (interactionId: string, operation: string, startTime: number, success: boolean) => void;
     onAck?: (response: APIInteractionResponse) => void;
     sendFollowUp?: (token: string, response: APIInteractionResponse, messageId?: string) => Promise<void>;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 };
 /**
  * Button interaction with helper methods.
@@ -37,6 +39,8 @@ export interface ButtonInteraction extends Omit<APIMessageComponentInteraction,
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 }
 export declare const ButtonInteraction: {};
 /**
@@ -54,6 +58,8 @@ export interface StringSelectInteraction extends Omit<APIMessageComponentInterac
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 }
 export declare const StringSelectInteraction: {};
 /**
@@ -71,6 +77,8 @@ export interface RoleSelectInteraction extends Omit<APIMessageComponentInteracti
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 }
 export declare const RoleSelectInteraction: {};
 /**
@@ -88,6 +96,8 @@ export interface UserSelectInteraction extends Omit<APIMessageComponentInteracti
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 }
 export declare const UserSelectInteraction: {};
 /**
@@ -105,6 +115,8 @@ export interface ChannelSelectInteraction extends Omit<APIMessageComponentIntera
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 }
 export declare const ChannelSelectInteraction: {};
 /**
@@ -122,6 +134,8 @@ export interface MentionableSelectInteraction extends Omit<APIMessageComponentIn
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 }
 export declare const MentionableSelectInteraction: {};
 /**
@@ -144,6 +158,11 @@ export type MessageComponentInteraction = APIMessageComponentInteraction & {
      * This is automatically called by reply() and update() if the interaction is deferred.
      */
     sendFollowUp?: (token: string, response: APIInteractionResponse, messageId?: string) => Promise<void>;
+    /**
+     * Optional state management helpers.
+     */
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
     /**
      * The selected values from a select menu interaction.
      * This property is only present for select menu interactions.

package/dist/utils/MessageComponentInteraction.js

@@ -203,5 +203,7 @@ export function createMessageComponentInteraction(interaction, helpers) {
         getMentionables,
         onAck: helpers?.onAck,
         sendFollowUp: helpers?.sendFollowUp,
+        canRespond: helpers?.canRespond,
+        trackResponse: helpers?.trackResponse,
     });
 }

package/dist/utils/ModalSubmitInteraction.d.ts

@@ -16,6 +16,11 @@ export type ModalSubmitInteraction = APIModalSubmitInteraction & {
      * This is automatically called by reply() if the interaction is deferred.
      */
     sendFollowUp?: (token: string, response: APIInteractionResponse, messageId?: string) => Promise<void>;
+    /**
+     * Optional state management helpers.
+     */
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 };
 export declare const ModalSubmitInteraction: {};
 /**
@@ -28,4 +33,6 @@ export declare const ModalSubmitInteraction: {};
 export declare function createModalSubmitInteraction(interaction: APIModalSubmitInteraction, helpers?: {
     onAck?: (response: APIInteractionResponse) => void;
     sendFollowUp?: (token: string, response: APIInteractionResponse, messageId?: string) => Promise<void>;
+    canRespond?: (interactionId: string) => boolean;
+    trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
 }): ModalSubmitInteraction;

package/dist/utils/ModalSubmitInteraction.js

@@ -67,5 +67,7 @@ export function createModalSubmitInteraction(interaction, helpers) {
         getResponse,
         getTextFieldValue,
         sendFollowUp: helpers?.sendFollowUp,
+        canRespond: helpers?.canRespond,
+        trackResponse: helpers?.trackResponse,
     });
 }

package/package.json

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