@minesa-org/mini-interaction 0.2.7 → 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);

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