@minesa-org/mini-interaction 0.2.7 → 0.2.9

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);
@@ -1276,6 +1278,8 @@ export class MiniInteraction {
                     const interactionWithHelpers = createUserContextMenuInteraction(commandInteraction, {
                         onAck: (response) => ackResolver?.(response),
                         sendFollowUp,
+                        canRespond: (id) => this.canRespond(id),
+                        trackResponse: (id, token, state) => this.trackInteractionState(id, token, state),
                     });
                     response = await command.handler(interactionWithHelpers);
                     resolvedResponse =
@@ -1286,6 +1290,8 @@ export class MiniInteraction {
                     const interactionWithHelpers = createAppCommandInteraction(commandInteraction, {
                         onAck: (response) => ackResolver?.(response),
                         sendFollowUp,
+                        canRespond: (id) => this.canRespond(id),
+                        trackResponse: (id, token, state) => this.trackInteractionState(id, token, state),
                     });
                     response = await command.handler(interactionWithHelpers);
                     resolvedResponse =

package/dist/utils/CommandInteractionOptions.d.ts

@@ -146,7 +146,7 @@ export interface CommandInteraction extends Omit<APIChatInputApplicationCommandI
     reply(data: InteractionMessageData): APIInteractionResponseChannelMessageWithSource;
     followUp(data: InteractionMessageData): Promise<APIInteractionResponseChannelMessageWithSource>;
     edit(data?: InteractionMessageData): APIInteractionResponseUpdateMessage;
-    editReply(data?: InteractionMessageData): Promise<APIInteractionResponseUpdateMessage>;
+    editReply(data?: InteractionMessageData): Promise<APIInteractionResponseChannelMessageWithSource | APIInteractionResponseUpdateMessage>;
     deferReply(options?: DeferReplyOptions): APIInteractionResponseDeferredChannelMessageWithSource;
     showModal(data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;

package/dist/utils/CommandInteractionOptions.js

@@ -1,4 +1,4 @@
-import { ApplicationCommandOptionType, InteractionResponseType, } from "discord-api-types/v10";
+import { ApplicationCommandOptionType, InteractionResponseType, InteractionType, } from "discord-api-types/v10";
 import { normaliseInteractionMessageData, normaliseMessageFlags, } from "./interactionMessageHelpers.js";
 export const ResolvedUserOption = {};
 export const MentionableOption = {};
@@ -405,10 +405,24 @@ export function createCommandInteraction(interaction, helpers) {
             if (!this.canRespond?.(this.id)) {
                 throw new Error('Interaction cannot edit reply: expired');
             }
-            const response = createMessageResponse(InteractionResponseType.UpdateMessage, data);
+            // Slash commands (type 2) MUST use ChannelMessageWithSource (type 4) for their initial response,
+            // or UpdateMessage (type 7) if they are updating a component interaction message.
+            // However, for as-yet-unresponded slash commands, we need type 4.
+            const interactionAny = interaction;
+            const isComponent = interactionAny.type === InteractionType.MessageComponent;
+            let response;
+            if (isComponent) {
+                response = createMessageResponse(InteractionResponseType.UpdateMessage, data);
+            }
+            else {
+                response = createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
+            }
             // If it's already deferred or responded, we MUST use a webhook
             if (this.sendFollowUp && (isDeferred || hasResponded)) {
                 await this.sendFollowUp(this.token, response, '@original');
+                // If we already sent an ACK (like a DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE), 
+                // we return the original captured response to avoid sending type 4/7 back to the initial POST.
+                return capturedResponse;
             }
             // Track response
             this.trackResponse?.(this.id, this.token, 'responded');
@@ -479,6 +493,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

@@ -14,6 +14,8 @@ export type ContextMenuInteractionHelpers = {
     }) => APIModalInteractionResponse;
     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;
 };
 /**
  * User context menu interaction with helper methods.
@@ -46,6 +48,8 @@ export declare const AppCommandInteraction: {};
 export declare function createUserContextMenuInteraction(interaction: APIUserApplicationCommandInteraction, 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;
 }): UserContextMenuInteraction;
 /**
  * Wraps a raw message context menu interaction with helper methods.
@@ -57,6 +61,8 @@ export declare function createUserContextMenuInteraction(interaction: APIUserApp
 export declare function createMessageContextMenuInteraction(interaction: APIMessageApplicationCommandInteraction, 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;
 }): MessageContextMenuInteraction;
 /**
  * Wraps a raw primary entry point interaction with helper methods.
@@ -68,4 +74,6 @@ export declare function createMessageContextMenuInteraction(interaction: APIMess
 export declare function createAppCommandInteraction(interaction: APIPrimaryEntryPointCommandInteraction, 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;
 }): AppCommandInteraction;

package/dist/utils/ContextMenuInteraction.js

@@ -44,6 +44,7 @@ function createContextMenuInteractionHelpers(interaction, helpers) {
         const response = createMessageResponse(InteractionResponseType.UpdateMessage, data);
         if (helpers?.sendFollowUp && (isDeferred || hasResponded)) {
             await helpers.sendFollowUp(interaction.token, response, '@original');
+            return capturedResponse;
         }
         hasResponded = true;
         return response;
@@ -73,7 +74,10 @@ function createContextMenuInteractionHelpers(interaction, helpers) {
         editReply,
         deferReply,
         showModal,
+        onAck: helpers?.onAck,
         sendFollowUp: helpers?.sendFollowUp,
+        canRespond: helpers?.canRespond,
+        trackResponse: helpers?.trackResponse,
     };
 }
 /**

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.7",
+	"version": "0.2.9",
 	"description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
 	"type": "module",
 	"main": "dist/index.js",