@minesa-org/mini-interaction 0.2.23 → 0.2.25

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 = {
@@ -171,6 +190,8 @@ export declare class MiniInteraction {
     private loadComponentsPromise;
     private registerCommandsPromise;
     private registerCommandsSignature;
+    private vercelWaitUntil;
+    private searchedForVercel;
     /**
      * Creates a new MiniInteraction client with optional command auto-loading and custom runtime hooks.
      */
@@ -189,6 +210,10 @@ export declare class MiniInteraction {
      * Call this periodically to clean up old interaction data.
      */
     cleanupExpiredInteractions(): number;
+    /**
+     * Attempt to find a waitUntil implementation in the environment (e.g. Vercel or Cloudflare).
+     */
+    private getAutoWaitUntil;
     private normalizeCommandData;
     private registerCommand;
     /**
@@ -267,7 +292,9 @@ export declare class MiniInteraction {
      * Creates a Node.js style request handler compatible with Express, Next.js API routes,
      * Vercel serverless functions, and any runtime that expects a `(req, res)` listener.
      */
-    createNodeHandler(): InteractionNodeHandler;
+    createNodeHandler(options?: {
+        waitUntil?: (promise: Promise<void>) => void;
+    }): InteractionNodeHandler;
     /**
      * Generates a lightweight verification handler that serves an HTML page with an embedded OAuth link.
      *
@@ -321,7 +348,13 @@ export declare class MiniInteraction {
     /**
      * Creates a Fetch API compatible handler for runtimes like Workers or Deno.
      */
-    createFetchHandler(): InteractionFetchHandler;
+    /**
+     * Generates a Fetch-standard request handler compatible with Cloudflare Workers,
+     * Bun, Deno, and Next.js Edge Runtime.
+     */
+    createFetchHandler(options?: {
+        waitUntil?: (promise: Promise<void>) => void;
+    }): InteractionFetchHandler;
     /**
      * Checks if the provided directory path exists on disk.
      */

package/dist/clients/MiniInteraction.js

@@ -43,6 +43,8 @@ export class MiniInteraction {
     loadComponentsPromise = null;
     registerCommandsPromise = null;
     registerCommandsSignature = null;
+    vercelWaitUntil = null;
+    searchedForVercel = false;
     /**
      * Creates a new MiniInteraction client with optional command auto-loading and custom runtime hooks.
      */
@@ -129,6 +131,33 @@ export class MiniInteraction {
         }
         return cleaned;
     }
+    /**
+     * Attempt to find a waitUntil implementation in the environment (e.g. Vercel or Cloudflare).
+     */
+    async getAutoWaitUntil() {
+        if (this.searchedForVercel)
+            return this.vercelWaitUntil;
+        this.searchedForVercel = true;
+        // Try Vercel's @vercel/functions
+        try {
+            // @ts-ignore - Dynamic import to avoid hard dependency or build errors in non-vercel environments
+            const { waitUntil } = await import("@vercel/functions");
+            if (typeof waitUntil === "function") {
+                this.vercelWaitUntil = waitUntil;
+                return waitUntil;
+            }
+        }
+        catch {
+            // Ignore if not found
+        }
+        // Try globalThis.waitUntil (some edge runtimes)
+        // @ts-ignore
+        if (typeof globalThis.waitUntil === "function") {
+            // @ts-ignore
+            return globalThis.waitUntil;
+        }
+        return null;
+    }
     normalizeCommandData(data) {
         if (typeof data === "object" && data !== null) {
             return resolveJSONEncodable(data);
@@ -471,7 +500,8 @@ export class MiniInteraction {
      * Creates a Node.js style request handler compatible with Express, Next.js API routes,
      * Vercel serverless functions, and any runtime that expects a `(req, res)` listener.
      */
-    createNodeHandler() {
+    createNodeHandler(options) {
+        const { waitUntil } = options ?? {};
         return (request, response) => {
             if (request.method !== "POST") {
                 response.statusCode = 405;
@@ -508,6 +538,12 @@ export class MiniInteraction {
                         signature,
                         timestamp,
                     });
+                    if (result.backgroundWork) {
+                        const resolvedWaitUntil = waitUntil ?? await this.getAutoWaitUntil();
+                        if (resolvedWaitUntil) {
+                            resolvedWaitUntil(result.backgroundWork);
+                        }
+                    }
                     response.statusCode = result.status;
                     response.setHeader("content-type", "application/json");
                     response.end(JSON.stringify(result.body));
@@ -756,7 +792,12 @@ export class MiniInteraction {
     /**
      * Creates a Fetch API compatible handler for runtimes like Workers or Deno.
      */
-    createFetchHandler() {
+    /**
+     * Generates a Fetch-standard request handler compatible with Cloudflare Workers,
+     * Bun, Deno, and Next.js Edge Runtime.
+     */
+    createFetchHandler(options) {
+        const { waitUntil } = options ?? {};
         return async (request) => {
             if (request.method !== "POST") {
                 return new Response(JSON.stringify({
@@ -776,6 +817,12 @@ export class MiniInteraction {
                     signature,
                     timestamp,
                 });
+                if (result.backgroundWork) {
+                    const resolvedWaitUntil = waitUntil ?? await this.getAutoWaitUntil();
+                    if (resolvedWaitUntil) {
+                        resolvedWaitUntil(result.backgroundWork);
+                    }
+                }
                 return new Response(JSON.stringify(result.body), {
                     status: result.status,
                     headers: { "content-type": "application/json" },
@@ -1142,10 +1189,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 +1256,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 +1373,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 +1393,7 @@ export class MiniInteraction {
             return {
                 status: 200,
                 body: finalResponse,
+                backgroundWork,
             };
         }
         catch (error) {
@@ -1607,12 +1657,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 +1674,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 +1686,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 +1697,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.25",
 	"description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
 	"type": "module",
 	"main": "dist/index.js",