feat(qr-modal): add preventIframe option + improve fallback behaviour

README.md

@@ -255,6 +255,16 @@ reclaimProofRequest.setModalOptions({
 
 await reclaimProofRequest.triggerReclaimFlow();
 ```
+### preventIframe (optional)
+
+Prevents the QR modal from opening when the SDK is running inside an iframe.  
+Useful for apps embedded in dashboards, widgets, or hosted inside other platforms.
+
+```ts
+reclaimProofRequest.setModalOptions({
+  preventIframe: true
+});
+```
 
 ### Benefits of the New Flow:
 

src/utils/modalUtils.ts

@@ -23,31 +23,52 @@ export class QRCodeModal {
         };
     }
 
-    async show(requestUrl: string): Promise<void> {
-        try {
-            // Remove existing modal if present
-            this.close();
+   async show(requestUrl: string): Promise<void> {
+    try {
+
+        // Prevent showing modal inside an iframe if enabled
+        if (this.options.preventIframe) {
+            try {
+                if (window.self !== window.top) {
+                    logger.info(
+                        "Reclaim Modal blocked: preventIframe = true and page is inside an iframe."
+                    );
+                    if (this.options.onClose) this.options.onClose();
+                    return;
+                }
+            } catch {
+                logger.info(
+                    "Reclaim Modal blocked: preventIframe = true and iframe check threw a security error."
+                );
+                if (this.options.onClose) this.options.onClose();
+                return;
+            }
+        }
 
-            // Create modal HTML
-            const modalHTML = this.createModalHTML();
+        // Remove existing modal if present
+        this.close();
 
-            // Add modal to DOM
-            document.body.insertAdjacentHTML('beforeend', modalHTML);
+        // Create modal HTML
+        const modalHTML = this.createModalHTML();
 
-            // Generate QR code
-            await this.generateQRCode(requestUrl, 'reclaim-qr-code');
+        // Add modal to DOM
+        document.body.insertAdjacentHTML('beforeend', modalHTML);
 
-            // Add event listeners
-            this.addEventListeners();
+        // Generate QR code
+        await this.generateQRCode(requestUrl, 'reclaim-qr-code');
 
-            // Start auto-close timer
-            this.startAutoCloseTimer();
+        // Add event listeners
+        this.addEventListeners();
 
-        } catch (error) {
-            logger.info('Error showing QR code modal:', error);
-            throw error;
-        }
+        // Start auto-close timer
+        this.startAutoCloseTimer();
+
+    } catch (error) {
+        logger.info('Error showing QR code modal:', error);
+        throw error;
     }
+}
+
 
     close(): void {
         // Clear timers
@@ -348,4 +369,4 @@ export class QRCodeModal {
             progressBar.style.width = `${progressPercentage}%`;
         }
     }
-}
+}

src/utils/types.ts

@@ -67,6 +67,9 @@ export type ModalOptions = {
   modalPopupTimer?: number;
   showExtensionInstallButton?: boolean;
   onClose?: () => void;
+   // NEW OPTION
+  preventIframe?: boolean;
+
 };
 
 // JSON-safe modal options (excludes non-serializable functions)
@@ -160,4 +163,4 @@ export type StatusUrlResponse = {
     statusV2: string;
   };
   providerId?: string;
-};
+};