@minesa-org/mini-interaction 0.2.4 → 0.2.5

package/dist/clients/MiniInteraction.d.ts

@@ -394,5 +394,10 @@ export declare class MiniInteraction {
      * Handles execution of an application command interaction.
      */
     private handleApplicationCommand;
+    /**
+     * Sends a follow-up response or edits an existing response via Discord's interaction webhooks.
+     * This is used for interactions that have already been acknowledged (e.g., via deferReply).
+     */
+    private sendFollowUp;
 }
 export {};

package/dist/clients/MiniInteraction.js

@@ -1125,8 +1125,11 @@ export class MiniInteraction {
             const ackPromise = new Promise((resolve) => {
                 ackResolver = resolve;
             });
+            // Helper to send follow-up responses via webhooks
+            const sendFollowUp = (token, data) => this.sendFollowUp(token, data);
             const interactionWithHelpers = createMessageComponentInteraction(interaction, {
                 onAck: (response) => ackResolver?.(response),
+                sendFollowUp,
             });
             // Wrap component handler with timeout and acknowledgment
             const timeoutWrapper = createTimeoutWrapper(async () => {
@@ -1187,8 +1190,11 @@ export class MiniInteraction {
             const ackPromise = new Promise((resolve) => {
                 ackResolver = resolve;
             });
+            // Helper to send follow-up responses via webhooks
+            const sendFollowUp = (token, data) => this.sendFollowUp(token, data);
             const interactionWithHelpers = createModalSubmitInteraction(interaction, {
                 onAck: (response) => ackResolver?.(response),
+                sendFollowUp,
             });
             // Wrap modal handler with timeout and acknowledgment
             const timeoutWrapper = createTimeoutWrapper(async () => {
@@ -1252,6 +1258,8 @@ export class MiniInteraction {
             const ackPromise = new Promise((resolve) => {
                 ackResolver = resolve;
             });
+            // Helper to send follow-up responses via webhooks
+            const sendFollowUp = (token, data) => this.sendFollowUp(token, data);
             // Create a timeout wrapper for the command handler
             const timeoutWrapper = createTimeoutWrapper(async () => {
                 // Check if it's a chat input (slash) command
@@ -1261,6 +1269,7 @@ export class MiniInteraction {
                         canRespond: (id) => this.canRespond(id),
                         trackResponse: (id, token, state) => this.trackInteractionState(id, token, state),
                         onAck: (response) => ackResolver?.(response),
+                        sendFollowUp,
                     });
                     response = await command.handler(interactionWithHelpers);
                     resolvedResponse =
@@ -1338,6 +1347,33 @@ export class MiniInteraction {
             };
         }
     }
+    /**
+     * Sends a follow-up response or edits an existing response via Discord's interaction webhooks.
+     * This is used for interactions that have already been acknowledged (e.g., via deferReply).
+     */
+    async sendFollowUp(token, response) {
+        const url = `${DISCORD_BASE_URL}/webhooks/${this.applicationId}/${token}/messages/@original`;
+        // Only send follow-up if there is data to send
+        if (!('data' in response) || !response.data) {
+            return;
+        }
+        try {
+            const fetchResponse = await this.fetchImpl(url, {
+                method: "PATCH",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(response.data),
+            });
+            if (!fetchResponse.ok) {
+                const errorBody = await fetchResponse.text();
+                console.error(`[MiniInteraction] Failed to send follow-up response: [${fetchResponse.status}] ${errorBody}`);
+            }
+        }
+        catch (error) {
+            console.error(`[MiniInteraction] Error sending follow-up response: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
 }
 const DEFAULT_DISCORD_OAUTH_TEMPLATES = {
     success: ({ user }) => {

package/dist/utils/CommandInteractionOptions.d.ts

@@ -155,6 +155,7 @@ export interface CommandInteraction extends Omit<APIChatInputApplicationCommandI
     canRespond?(interactionId: string): boolean;
     trackResponse?(interactionId: string, token: string, state: 'responded' | 'deferred'): void;
     onAck?(response: APIInteractionResponse): void;
+    sendFollowUp?(token: string, response: APIInteractionResponse): void;
 }
 export declare const CommandInteraction: {};
 /**
@@ -169,4 +170,5 @@ export declare function createCommandInteraction(interaction: APIChatInputApplic
     trackResponse?: (interactionId: string, token: string, state: 'responded' | 'deferred') => void;
     logTiming?: (interactionId: string, operation: string, startTime: number, success: boolean) => void;
     onAck?: (response: APIInteractionResponse) => void;
+    sendFollowUp?: (token: string, response: APIInteractionResponse) => void;
 }): CommandInteraction;

package/dist/utils/CommandInteractionOptions.js

@@ -379,17 +379,19 @@ export function createCommandInteraction(interaction, helpers) {
             if (!this.canRespond?.(this.id)) {
                 throw new Error('Interaction cannot respond: already responded or expired');
             }
-            const startTime = Date.now();
             const response = createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
             // Track response
             this.trackResponse?.(this.id, this.token, 'responded');
             // Notify acknowledgment
             this.onAck?.(response);
-            // Log timing if debug enabled
             return response;
         },
         followUp(data) {
-            return createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
+            const response = createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
+            if (this.sendFollowUp) {
+                this.sendFollowUp(this.token, response);
+            }
+            return response;
         },
         edit(data) {
             return createMessageResponse(InteractionResponseType.UpdateMessage, data);
@@ -399,11 +401,13 @@ export function createCommandInteraction(interaction, helpers) {
             if (!this.canRespond?.(this.id)) {
                 throw new Error('Interaction cannot edit reply: already responded, expired, or not deferred');
             }
-            const startTime = Date.now();
             const response = createMessageResponse(InteractionResponseType.UpdateMessage, data);
+            // If it's already deferred or responded, we MUST use a webhook
+            if (this.sendFollowUp) {
+                this.sendFollowUp(this.token, response);
+            }
             // Track response
             this.trackResponse?.(this.id, this.token, 'responded');
-            // Log timing if debug enabled
             return response;
         },
         deferReply(options) {
@@ -411,7 +415,6 @@ export function createCommandInteraction(interaction, helpers) {
             if (!this.canRespond?.(this.id)) {
                 throw new Error('Interaction cannot defer: already responded or expired');
             }
-            const startTime = Date.now();
             const response = createDeferredResponse(options?.flags !== undefined
                 ? { flags: options.flags }
                 : undefined);
@@ -419,7 +422,6 @@ export function createCommandInteraction(interaction, helpers) {
             this.trackResponse?.(this.id, this.token, 'deferred');
             // Notify acknowledgment
             this.onAck?.(response);
-            // Log timing if debug enabled
             return response;
         },
         showModal(data) {

package/dist/utils/MessageComponentInteraction.d.ts

@@ -28,6 +28,7 @@ type BaseComponentInteractionHelpers = {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
     onAck?: (response: APIInteractionResponse) => void;
+    sendFollowUp?: (token: string, response: APIInteractionResponse) => void;
 };
 /**
  * Button interaction with helper methods.
@@ -97,6 +98,11 @@ export type MessageComponentInteraction = APIMessageComponentInteraction & {
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
     }) => APIModalInteractionResponse;
+    /**
+     * Finalise the interaction response via a webhook follow-up.
+     * This is automatically called by reply() and update() if the interaction is deferred.
+     */
+    sendFollowUp?: (token: string, response: APIInteractionResponse) => void;
     /**
      * The selected values from a select menu interaction.
      * This property is only present for select menu interactions.
@@ -138,5 +144,6 @@ export declare const MessageComponentInteraction: {};
  */
 export declare function createMessageComponentInteraction(interaction: APIMessageComponentInteraction, helpers?: {
     onAck?: (response: APIInteractionResponse) => void;
+    sendFollowUp?: (token: string, response: APIInteractionResponse) => void;
 }): MessageComponentInteraction;
 export {};

package/dist/utils/MessageComponentInteraction.js

@@ -17,6 +17,7 @@ export const MessageComponentInteraction = {};
  */
 export function createMessageComponentInteraction(interaction, helpers) {
     let capturedResponse = null;
+    let isDeferred = false;
     const captureResponse = (response) => {
         capturedResponse = response;
         return response;
@@ -30,7 +31,12 @@ export function createMessageComponentInteraction(interaction, helpers) {
             type: InteractionResponseType.ChannelMessageWithSource,
             data: normalisedData,
         });
-        helpers?.onAck?.(response);
+        if (isDeferred && helpers?.sendFollowUp) {
+            helpers.sendFollowUp(interaction.token, response);
+        }
+        else {
+            helpers?.onAck?.(response);
+        }
         return response;
     };
     const deferReply = (options) => {
@@ -44,6 +50,7 @@ export function createMessageComponentInteraction(interaction, helpers) {
                 type: InteractionResponseType.DeferredChannelMessageWithSource,
             };
         captureResponse(response);
+        isDeferred = true;
         helpers?.onAck?.(response);
         return response;
     };
@@ -57,11 +64,19 @@ export function createMessageComponentInteraction(interaction, helpers) {
             : {
                 type: InteractionResponseType.UpdateMessage,
             };
+        if (isDeferred && helpers?.sendFollowUp) {
+            helpers.sendFollowUp(interaction.token, response);
+        }
         return captureResponse(response);
     };
-    const deferUpdate = () => captureResponse({
-        type: InteractionResponseType.DeferredMessageUpdate,
-    });
+    const deferUpdate = () => {
+        const response = captureResponse({
+            type: InteractionResponseType.DeferredMessageUpdate,
+        });
+        isDeferred = true;
+        helpers?.onAck?.(response);
+        return response;
+    };
     const showModal = (data) => {
         const resolvedData = typeof data === "object" &&
             "toJSON" in data &&
@@ -183,5 +198,6 @@ export function createMessageComponentInteraction(interaction, helpers) {
         getUsers,
         getMentionables,
         onAck: helpers?.onAck,
+        sendFollowUp: helpers?.sendFollowUp,
     });
 }

package/dist/utils/ModalSubmitInteraction.d.ts

@@ -7,32 +7,25 @@ export type ModalSubmitInteraction = APIModalSubmitInteraction & {
     getResponse: () => APIInteractionResponse | null;
     reply: (data: InteractionMessageData) => APIInteractionResponseChannelMessageWithSource;
     deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
-    onAck?: (response: APIInteractionResponse) => void;
-    /**
-     * Helper method to get the value of a text input component by custom_id.
-     * @param customId - The custom_id of the text input component
-     * @returns The value of the text input, or undefined if not found
-     */
-    getTextInputValue: (customId: string) => string | undefined;
     /**
-     * Helper method to get all text input values as a map.
-     * @returns A map of custom_id to value for all text inputs
+     * Helper method to get the value of a text input component by its custom ID.
      */
-    getTextInputValues: () => Map<string, string>;
+    getTextFieldValue: (customId: string) => string | undefined;
     /**
-     * Helper method to get the selected values of a select menu component by custom_id.
-     * @param customId - The custom_id of the select menu component
-     * @returns The selected values of the select menu, or undefined if not found
+     * Finalise the interaction response via a webhook follow-up.
+     * This is automatically called by reply() if the interaction is deferred.
      */
-    getSelectMenuValues: (customId: string) => string[] | undefined;
+    sendFollowUp?: (token: string, response: APIInteractionResponse) => void;
 };
 export declare const ModalSubmitInteraction: {};
 /**
- * Wraps a raw modal submit interaction with helper methods.
+ * Wraps a raw modal submit interaction with helper methods mirroring Discord's expected responses.
  *
  * @param interaction - The raw interaction payload from Discord.
+ * @param helpers - Optional callback to capture the final interaction response.
  * @returns A helper-augmented interaction object.
  */
 export declare function createModalSubmitInteraction(interaction: APIModalSubmitInteraction, helpers?: {
     onAck?: (response: APIInteractionResponse) => void;
+    sendFollowUp?: (token: string, response: APIInteractionResponse) => void;
 }): ModalSubmitInteraction;

package/dist/utils/ModalSubmitInteraction.js

@@ -1,14 +1,16 @@
-import { InteractionResponseType, } from "discord-api-types/v10";
+import { ComponentType, InteractionResponseType, } from "discord-api-types/v10";
 import { normaliseInteractionMessageData, normaliseMessageFlags, } from "./interactionMessageHelpers.js";
 export const ModalSubmitInteraction = {};
 /**
- * Wraps a raw modal submit interaction with helper methods.
+ * Wraps a raw modal submit interaction with helper methods mirroring Discord's expected responses.
  *
  * @param interaction - The raw interaction payload from Discord.
+ * @param helpers - Optional callback to capture the final interaction response.
  * @returns A helper-augmented interaction object.
  */
 export function createModalSubmitInteraction(interaction, helpers) {
     let capturedResponse = null;
+    let isDeferred = false;
     const captureResponse = (response) => {
         capturedResponse = response;
         return response;
@@ -16,13 +18,18 @@ export function createModalSubmitInteraction(interaction, helpers) {
     const reply = (data) => {
         const normalisedData = normaliseInteractionMessageData(data);
         if (!normalisedData) {
-            throw new Error("[MiniInteraction] Modal submit replies require response data to be provided.");
+            throw new Error("[MiniInteraction] Modal replies require response data to be provided.");
         }
         const response = captureResponse({
             type: InteractionResponseType.ChannelMessageWithSource,
             data: normalisedData,
         });
-        helpers?.onAck?.(response);
+        if (isDeferred && helpers?.sendFollowUp) {
+            helpers.sendFollowUp(interaction.token, response);
+        }
+        else {
+            helpers?.onAck?.(response);
+        }
         return response;
     };
     const deferReply = (options) => {
@@ -36,69 +43,29 @@ export function createModalSubmitInteraction(interaction, helpers) {
                 type: InteractionResponseType.DeferredChannelMessageWithSource,
             };
         captureResponse(response);
+        isDeferred = true;
         helpers?.onAck?.(response);
         return response;
     };
     const getResponse = () => capturedResponse;
-    // Helper to extract text input values from modal components
-    const extractTextInputs = () => {
-        const textInputs = new Map();
-        for (const component of interaction.data.components) {
-            // Handle action rows
-            if ("components" in component && Array.isArray(component.components)) {
-                for (const child of component.components) {
-                    if ("value" in child && "custom_id" in child) {
-                        textInputs.set(child.custom_id, child.value);
-                    }
-                }
-            }
-            // Handle labeled components
-            else if ("component" in component) {
-                const labeledComponent = component.component;
-                if ("value" in labeledComponent && "custom_id" in labeledComponent) {
-                    textInputs.set(labeledComponent.custom_id, labeledComponent.value);
-                }
-            }
-        }
-        return textInputs;
-    };
-    // Helper to extract select menu values from modal components
-    const extractSelectMenuValues = () => {
-        const selectMenuValues = new Map();
-        for (const component of interaction.data.components) {
-            // Handle action rows
-            if ("components" in component && Array.isArray(component.components)) {
-                for (const child of component.components) {
-                    if ("values" in child && "custom_id" in child && Array.isArray(child.values)) {
-                        selectMenuValues.set(child.custom_id, child.values);
+    const getTextFieldValue = (customId) => {
+        for (const actionRow of interaction.data.components) {
+            if ("components" in actionRow && Array.isArray(actionRow.components)) {
+                for (const component of actionRow.components) {
+                    if (component.type === ComponentType.TextInput &&
+                        component.custom_id === customId) {
+                        return component.value;
                     }
                 }
             }
-            // Handle labeled components (unlikely for select menus but good for completeness if spec allows)
-            else if ("component" in component) {
-                const labeledComponent = component.component; // Using any as ModalSubmitComponent might not cover select menus fully in types yet or strictness varies
-                if ("values" in labeledComponent && "custom_id" in labeledComponent && Array.isArray(labeledComponent.values)) {
-                    selectMenuValues.set(labeledComponent.custom_id, labeledComponent.values);
-                }
-            }
         }
-        return selectMenuValues;
-    };
-    const textInputValues = extractTextInputs();
-    const selectMenuValues = extractSelectMenuValues();
-    const getTextInputValue = (customId) => {
-        return textInputValues.get(customId);
-    };
-    const getTextInputValues = () => {
-        return new Map(textInputValues);
+        return undefined;
     };
     return Object.assign(interaction, {
         reply,
         deferReply,
         getResponse,
-        getTextInputValue,
-        getTextInputValues,
-        getSelectMenuValues: (customId) => selectMenuValues.get(customId),
-        onAck: helpers?.onAck,
+        getTextFieldValue,
+        sendFollowUp: helpers?.sendFollowUp,
     });
 }

package/package.json

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