@minesa-org/mini-interaction 0.2.24 → 0.2.26

package/dist/clients/MiniInteraction.d.ts

@@ -7,8 +7,8 @@ import { type ModalSubmitInteraction } from "../utils/ModalSubmitInteraction.js"
 import { type OAuthConfig, type OAuthTokens, type DiscordUser } from "../oauth/DiscordOAuth.js";
 /** Configuration parameters for the MiniInteraction client. */
 export type InteractionClientOptions = {
-    applicationId: string;
-    publicKey: string;
+    applicationId?: string;
+    publicKey?: string;
     commandsDirectory?: string | false;
     componentsDirectory?: string | false;
     utilsDirectory?: string | false;
@@ -190,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.
      */
@@ -208,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;
     /**
@@ -286,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.
      *
@@ -340,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,22 +43,26 @@ 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.
      */
     constructor({ applicationId, publicKey, commandsDirectory, componentsDirectory, utilsDirectory, fetchImplementation, verifyKeyImplementation, timeoutConfig, }) {
-        if (!applicationId) {
-            throw new Error("[MiniInteraction] applicationId is required");
+        const resolvedAppId = applicationId ?? (typeof process !== "undefined" ? process.env.DISCORD_APPLICATION_ID : undefined);
+        const resolvedPublicKey = publicKey ?? (typeof process !== "undefined" ? process.env.DISCORD_PUBLIC_KEY : undefined);
+        if (!resolvedAppId) {
+            throw new Error("[MiniInteraction] applicationId is required (or DISCORD_APPLICATION_ID env var)");
         }
-        if (!publicKey) {
-            throw new Error("[MiniInteraction] publicKey is required");
+        if (!resolvedPublicKey) {
+            throw new Error("[MiniInteraction] publicKey is required (or DISCORD_PUBLIC_KEY env var)");
         }
         const fetchImpl = fetchImplementation ?? globalThis.fetch;
         if (typeof fetchImpl !== "function") {
             throw new Error("[MiniInteraction] fetch is not available. Provide a global fetch implementation.");
         }
-        this.applicationId = applicationId;
-        this.publicKey = publicKey;
+        this.applicationId = resolvedAppId;
+        this.publicKey = resolvedPublicKey;
         this.fetchImpl = fetchImpl;
         this.verifyKeyImpl = verifyKeyImplementation ?? verifyKey;
         this.commandsDirectory =
@@ -129,6 +133,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 +502,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 +540,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 +794,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 +819,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" },

package/package.json

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