@minesa-org/mini-interaction 0.1.7 → 0.1.10

package/dist/clients/MiniInteraction.d.ts

@@ -239,6 +239,12 @@ export declare class MiniInteraction {
      * This is primarily used when Discord asks for a verification URL while setting up Linked Roles.
      * Provide an HTML file that contains the `{{OAUTH_URL}}` placeholder (or a custom placeholder defined in options)
      * and this helper will replace the token with a freshly generated OAuth link on every request.
+     *
+     * Available placeholders:
+     * - `{{OAUTH_URL}}` - HTML-escaped OAuth URL for links/buttons.
+     * - `{{OAUTH_URL_RAW}}` - raw OAuth URL, ideal for `<script>` usage.
+     * - `{{OAUTH_STATE}}` - HTML-escaped OAuth state value.
+     * - Custom placeholder name (from {@link DiscordOAuthVerificationPageOptions.placeholder}) and its `_RAW` variant.
      */
     discordOAuthVerificationPage(options?: DiscordOAuthVerificationPageOptions): MiniInteractionNodeHandler;
     /**
@@ -264,7 +270,7 @@ export declare class MiniInteraction {
     private loadHtmlTemplate;
     /**
      * Replaces placeholder tokens in a template with escaped HTML values.
-     */
+ */
     private renderHtmlTemplate;
     /**
      * Normalizes placeholder tokens to the bare key the HTML renderer expects.

package/dist/clients/MiniInteraction.js

@@ -430,6 +430,12 @@ export class MiniInteraction {
      * This is primarily used when Discord asks for a verification URL while setting up Linked Roles.
      * Provide an HTML file that contains the `{{OAUTH_URL}}` placeholder (or a custom placeholder defined in options)
      * and this helper will replace the token with a freshly generated OAuth link on every request.
+     *
+     * Available placeholders:
+     * - `{{OAUTH_URL}}` - HTML-escaped OAuth URL for links/buttons.
+     * - `{{OAUTH_URL_RAW}}` - raw OAuth URL, ideal for `<script>` usage.
+     * - `{{OAUTH_STATE}}` - HTML-escaped OAuth state value.
+     * - Custom placeholder name (from {@link DiscordOAuthVerificationPageOptions.placeholder}) and its `_RAW` variant.
      */
     discordOAuthVerificationPage(options = {}) {
         const scopes = options.scopes ?? ["identify", "role_connections.write"];
@@ -440,12 +446,20 @@ export class MiniInteraction {
         return (_request, response) => {
             try {
                 const { url, state } = generateOAuthUrl(oauthConfig, scopes);
-                const html = this.renderHtmlTemplate(template, {
+                const values = {
                     OAUTH_URL: url,
+                    OAUTH_URL_RAW: url,
                     OAUTH_STATE: state,
-                    ...(placeholderKey !== "OAUTH_URL"
-                        ? { [placeholderKey]: url }
-                        : {}),
+                };
+                const rawKeys = new Set(["OAUTH_URL_RAW"]);
+                if (placeholderKey !== "OAUTH_URL") {
+                    values[placeholderKey] = url;
+                    const rawVariant = `${placeholderKey}_RAW`;
+                    values[rawVariant] = url;
+                    rawKeys.add(rawVariant);
+                }
+                const html = this.renderHtmlTemplate(template, values, {
+                    rawKeys,
                 });
                 sendHtml(response, html);
             }
@@ -519,14 +533,18 @@ export class MiniInteraction {
     }
     /**
      * Replaces placeholder tokens in a template with escaped HTML values.
-     */
-    renderHtmlTemplate(template, values) {
+ */
+    renderHtmlTemplate(template, values, options) {
+        const rawKeys = options?.rawKeys instanceof Set
+            ? options.rawKeys
+            : new Set(options?.rawKeys ?? []);
         return template.replace(/\{\{\s*(\w+)\s*\}\}/g, (match, key) => {
             const value = values[key];
             if (value === undefined || value === null) {
                 return "";
             }
-            return escapeHtml(String(value));
+            const stringValue = String(value);
+            return rawKeys.has(key) ? stringValue : escapeHtml(stringValue);
         });
     }
     /**

package/dist/utils/ContextMenuInteraction.d.ts

@@ -1,4 +1,4 @@
-import { type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIMessageApplicationCommandInteraction, type APIModalInteractionResponse, type APIModalInteractionResponseCallbackData, type APIUserApplicationCommandInteraction } from "discord-api-types/v10";
+import { type APIInteractionResponse, type APIInteractionResponseChannelMessageWithSource, type APIInteractionResponseDeferredChannelMessageWithSource, type APIInteractionResponseUpdateMessage, type APIMessage, type APIMessageApplicationCommandInteraction, type APIModalInteractionResponse, type APIModalInteractionResponseCallbackData, type APIUser, type APIUserApplicationCommandInteraction } from "discord-api-types/v10";
 import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageHelpers.js";
 /**
  * Base helper methods for context menu interactions.
@@ -6,6 +6,8 @@ import { DeferReplyOptions, InteractionMessageData } from "./interactionMessageH
 type ContextMenuInteractionHelpers = {
     getResponse: () => APIInteractionResponse | null;
     reply: (data: InteractionMessageData) => APIInteractionResponseChannelMessageWithSource;
+    followUp: (data: InteractionMessageData) => APIInteractionResponseChannelMessageWithSource;
+    editReply: (data?: InteractionMessageData) => APIInteractionResponseUpdateMessage;
     deferReply: (options?: DeferReplyOptions) => APIInteractionResponseDeferredChannelMessageWithSource;
     showModal: (data: APIModalInteractionResponseCallbackData | {
         toJSON(): APIModalInteractionResponseCallbackData;
@@ -14,11 +16,17 @@ type ContextMenuInteractionHelpers = {
 /**
  * User context menu interaction with helper methods.
  */
-export type UserContextMenuInteraction = APIUserApplicationCommandInteraction & ContextMenuInteractionHelpers;
+export type UserContextMenuInteraction = APIUserApplicationCommandInteraction & ContextMenuInteractionHelpers & {
+    /** Resolved user targeted by this user context menu command. */
+    targetUser?: APIUser;
+};
 /**
  * Message context menu interaction with helper methods.
  */
-export type MessageContextMenuInteraction = APIMessageApplicationCommandInteraction & ContextMenuInteractionHelpers;
+export type MessageContextMenuInteraction = APIMessageApplicationCommandInteraction & ContextMenuInteractionHelpers & {
+    /** Resolved message targeted by this message context menu command. */
+    targetMessage?: APIMessage;
+};
 /**
  * Wraps a raw user context menu interaction with helper methods.
  *

package/dist/utils/ContextMenuInteraction.js

@@ -1,49 +1,63 @@
 import { InteractionResponseType, } from "discord-api-types/v10";
 import { normaliseInteractionMessageData, normaliseMessageFlags, } from "./interactionMessageHelpers.js";
-/**
- * Wraps a raw user context menu interaction with helper methods.
- *
- * @param interaction - The raw user context menu interaction payload from Discord.
- * @returns A helper-augmented interaction object.
- */
-export function createUserContextMenuInteraction(interaction) {
+function createContextMenuInteractionHelpers() {
     let capturedResponse = null;
-    const reply = (data) => {
-        const normalised = normaliseInteractionMessageData(data);
-        if (!normalised) {
-            throw new Error("[MiniInteraction] Channel message responses require data to be provided.");
-        }
-        const response = {
-            type: InteractionResponseType.ChannelMessageWithSource,
-            data: normalised,
-        };
+    const captureResponse = (response) => {
         capturedResponse = response;
         return response;
     };
+    function createMessageResponse(type, data) {
+        const normalised = normaliseInteractionMessageData(data);
+        if (type === InteractionResponseType.ChannelMessageWithSource) {
+            if (!normalised) {
+                throw new Error("[MiniInteraction] Channel message responses require data to be provided.");
+            }
+            return captureResponse({
+                type,
+                data: normalised,
+            });
+        }
+        if (normalised) {
+            return captureResponse({ type, data: normalised });
+        }
+        return captureResponse({ type });
+    }
+    const reply = (data) => createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
+    const followUp = (data) => createMessageResponse(InteractionResponseType.ChannelMessageWithSource, data);
+    const editReply = (data) => createMessageResponse(InteractionResponseType.UpdateMessage, data);
     const deferReply = (options = {}) => {
         const flags = normaliseMessageFlags(options.flags);
-        const response = {
+        return captureResponse({
             type: InteractionResponseType.DeferredChannelMessageWithSource,
             data: flags ? { flags } : undefined,
-        };
-        capturedResponse = response;
-        return response;
+        });
     };
     const showModal = (data) => {
         const modalData = typeof data === "object" && "toJSON" in data ? data.toJSON() : data;
-        const response = {
+        return captureResponse({
             type: InteractionResponseType.Modal,
             data: modalData,
-        };
-        capturedResponse = response;
-        return response;
+        });
     };
     const getResponse = () => capturedResponse;
-    return Object.assign(interaction, {
+    return {
+        getResponse,
         reply,
+        followUp,
+        editReply,
         deferReply,
         showModal,
-        getResponse,
+    };
+}
+/**
+ * Wraps a raw user context menu interaction with helper methods.
+ *
+ * @param interaction - The raw user context menu interaction payload from Discord.
+ * @returns A helper-augmented interaction object.
+ */
+export function createUserContextMenuInteraction(interaction) {
+    return Object.assign(interaction, createContextMenuInteractionHelpers(), {
+        targetUser: resolveTargetUser(interaction),
     });
 }
 /**
@@ -53,42 +67,21 @@ export function createUserContextMenuInteraction(interaction) {
  * @returns A helper-augmented interaction object.
  */
 export function createMessageContextMenuInteraction(interaction) {
-    let capturedResponse = null;
-    const reply = (data) => {
-        const normalised = normaliseInteractionMessageData(data);
-        if (!normalised) {
-            throw new Error("[MiniInteraction] Channel message responses require data to be provided.");
-        }
-        const response = {
-            type: InteractionResponseType.ChannelMessageWithSource,
-            data: normalised,
-        };
-        capturedResponse = response;
-        return response;
-    };
-    const deferReply = (options = {}) => {
-        const flags = normaliseMessageFlags(options.flags);
-        const response = {
-            type: InteractionResponseType.DeferredChannelMessageWithSource,
-            data: flags ? { flags } : undefined,
-        };
-        capturedResponse = response;
-        return response;
-    };
-    const showModal = (data) => {
-        const modalData = typeof data === "object" && "toJSON" in data ? data.toJSON() : data;
-        const response = {
-            type: InteractionResponseType.Modal,
-            data: modalData,
-        };
-        capturedResponse = response;
-        return response;
-    };
-    const getResponse = () => capturedResponse;
-    return Object.assign(interaction, {
-        reply,
-        deferReply,
-        showModal,
-        getResponse,
+    return Object.assign(interaction, createContextMenuInteractionHelpers(), {
+        targetMessage: resolveTargetMessage(interaction),
     });
 }
+function resolveTargetMessage(interaction) {
+    const targetId = interaction.data?.target_id;
+    if (!targetId) {
+        return undefined;
+    }
+    return interaction.data?.resolved?.messages?.[targetId];
+}
+function resolveTargetUser(interaction) {
+    const targetId = interaction.data?.target_id;
+    if (!targetId) {
+        return undefined;
+    }
+    return interaction.data?.resolved?.users?.[targetId];
+}

package/package.json

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