@minesa-org/mini-interaction 0.2.23 → 0.2.24

package/dist/clients/MiniInteraction.d.ts

@@ -37,6 +37,25 @@ export type InteractionHandlerResult = {
     body: APIInteractionResponse | {
         error: string;
     };
+    /**
+     * Promise that resolves when all background work (like editReply) completes.
+     * Pass this to Vercel's waitUntil() to prevent premature termination.
+     *
+     * @example
+     * ```typescript
+     * // In Next.js App Router
+     * import { waitUntil } from '@vercel/functions';
+     *
+     * export async function POST(request: Request) {
+     *   const result = await client.handleRequest({ ... });
+     *   if (result.backgroundWork) {
+     *     waitUntil(result.backgroundWork);
+     *   }
+     *   return Response.json(result.body, { status: result.status });
+     * }
+     * ```
+     */
+    backgroundWork?: Promise<void>;
 };
 /** Configuration for interaction timeout handling. */
 export type InteractionTimeoutConfig = {

package/dist/clients/MiniInteraction.js

@@ -1142,10 +1142,11 @@ export class MiniInteraction {
                 }
                 return resolvedResponse;
             }, this.timeoutConfig.initialResponseTimeout, `Component "${customId}"`, this.timeoutConfig.enableTimeoutWarnings, ackPromise);
-            const resolvedResponse = await timeoutWrapper();
+            const { response: resolvedResponse, backgroundWork } = await timeoutWrapper();
             return {
                 status: 200,
                 body: resolvedResponse,
+                backgroundWork,
             };
         }
         catch (error) {
@@ -1208,10 +1209,11 @@ export class MiniInteraction {
                 }
                 return resolvedResponse;
             }, this.timeoutConfig.initialResponseTimeout, `Modal "${customId}"`, this.timeoutConfig.enableTimeoutWarnings, ackPromise);
-            const resolvedResponse = await timeoutWrapper();
+            const { response: resolvedResponse, backgroundWork } = await timeoutWrapper();
             return {
                 status: 200,
                 body: resolvedResponse,
+                backgroundWork,
             };
         }
         catch (error) {
@@ -1324,7 +1326,7 @@ export class MiniInteraction {
                 }
                 return resolvedResponse;
             }, this.timeoutConfig.initialResponseTimeout, `Command "${commandName}"`, this.timeoutConfig.enableTimeoutWarnings, ackPromise);
-            const finalResponse = await timeoutWrapper();
+            const { response: finalResponse, backgroundWork } = await timeoutWrapper();
             if (this.timeoutConfig.enableResponseDebugLogging) {
                 console.log(`[MiniInteraction] handleApplicationCommand: initial response determined (type=${finalResponse?.type})`);
             }
@@ -1344,6 +1346,7 @@ export class MiniInteraction {
             return {
                 status: 200,
                 body: finalResponse,
+                backgroundWork,
             };
         }
         catch (error) {
@@ -1607,12 +1610,16 @@ function createTimeoutWrapper(handler, timeoutMs, handlerName, enableWarnings =
         });
         // Start handler execution immediately (don't await yet)
         const handlerPromise = Promise.resolve(handler(...args));
+        // Attach a default error handler to prevent unhandled rejections
+        const backgroundWork = handlerPromise.catch((error) => {
+            console.error(`[MiniInteraction] ${handlerName} background execution failed:`, error instanceof Error ? error.message : String(error));
+        }).then(() => {
+            // Ensure it always resolves to void
+        });
         // If we have an ackPromise, race between ACK and timeout
-        // When ACK is received, return IMMEDIATELY so Discord gets the response
-        // Handler continues in background
         if (ackPromise) {
             try {
-                const ackResult = await Promise.race([
+                const response = await Promise.race([
                     ackPromise,
                     timeoutPromise,
                 ]);
@@ -1620,11 +1627,7 @@ function createTimeoutWrapper(handler, timeoutMs, handlerName, enableWarnings =
                 if (timeoutId) {
                     clearTimeout(timeoutId);
                 }
-                // Handler continues in background - attach error handler
-                handlerPromise.catch((error) => {
-                    console.error(`[MiniInteraction] ${handlerName} background execution failed:`, error instanceof Error ? error.message : String(error));
-                });
-                return ackResult;
+                return { response, backgroundWork };
             }
             catch (error) {
                 // Timeout occurred before ACK - fall through to check handler
@@ -1636,7 +1639,7 @@ function createTimeoutWrapper(handler, timeoutMs, handlerName, enableWarnings =
         }
         // No ACK promise - wait for handler with timeout
         try {
-            const handlerResult = await Promise.race([
+            const response = await Promise.race([
                 handlerPromise,
                 timeoutPromise,
             ]);
@@ -1647,7 +1650,7 @@ function createTimeoutWrapper(handler, timeoutMs, handlerName, enableWarnings =
             if (enableWarnings && elapsed > timeoutMs * 0.8) {
                 console.warn(`[MiniInteraction] ${handlerName} completed in ${elapsed}ms (${Math.round((elapsed / timeoutMs) * 100)}% of timeout limit)`);
             }
-            return handlerResult;
+            return { response, backgroundWork };
         }
         catch (error) {
             if (timeoutId) {

package/package.json

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