@minesa-org/mini-interaction 0.1.7 → 0.1.9

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/package.json

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