@polyguard/sdk 1.1.3 → 1.1.6

package/dist/sdk.js

@@ -10969,7 +10969,7 @@
   var PolyguardWebsocketClientImpl = class {
     constructor(params = {}) {
       this.apiClient = new ApiClient_default();
-      const { apiKey, baseUrl, appId, apiServer, requiredProofs = ["Full Name"], scanType = "single", redirectUrl, callbackUrl, cookieName } = params;
+      const { apiKey, baseUrl, appId, apiServer, requiredProofs = ["Full Name"], scanType = "single", redirectUrl, callbackUrl, cookieName, link_uuid } = params;
       if (baseUrl) {
         this.apiClient.basePath = baseUrl;
       }
@@ -10992,6 +10992,7 @@
       this.redirectUrl = redirectUrl;
       this.callbackUrl = callbackUrl;
       this.cookieName = cookieName;
+      this.link_uuid = link_uuid;
     }
     buildModal() {
       const modal = document.createElement("div");
@@ -11024,33 +11025,60 @@
     `;
       return modal;
     }
-    async verify() {
-      const modal = this.buildModal();
-      document.body.appendChild(modal);
-      const qrDiv = modal.querySelector("#polyguard-qr");
+    async verify(target = null, rawJwt = false) {
+      let modal = null;
+      let qrDiv = null;
+      let isTargetMode = false;
+      if (target) {
+        isTargetMode = true;
+        qrDiv = document.getElementById(target);
+        if (!qrDiv) {
+          throw new Error(`Target element with ID '${target}' not found`);
+        }
+      } else {
+        modal = this.buildModal();
+      }
+      if (!isTargetMode) {
+        document.body.appendChild(modal);
+        qrDiv = modal.querySelector("#polyguard-qr");
+      }
       if (qrDiv) {
         qrDiv.innerHTML = LOADING_SPINNER;
       }
       function cleanup() {
-        if (modal.parentNode) modal.parentNode.removeChild(modal);
+        if (isTargetMode) {
+          if (qrDiv) {
+            qrDiv.innerHTML = "";
+          }
+        } else if (modal && modal.parentNode) {
+          modal.parentNode.removeChild(modal);
+        }
       }
       return new Promise(async (resolve, reject) => {
         let ws = null;
         let closed = false;
         function returnError(msg, score = "OFFLINE") {
-          const errDiv = modal.querySelector("#polyguard-error");
-          if (errDiv) {
-            errDiv.textContent = msg;
-            errDiv.style.display = "block";
-          }
-          setTimeout(() => {
+          if (isTargetMode) {
+            console.error("Polyguard Error:", msg);
             cleanup();
             resolve({ presence: { score, msg } });
-          }, 1250);
+          } else {
+            const errDiv = modal.querySelector("#polyguard-error");
+            if (errDiv) {
+              errDiv.textContent = msg;
+              errDiv.style.display = "block";
+            }
+            setTimeout(() => {
+              cleanup();
+              resolve({ presence: { score, msg } });
+            }, 1250);
+          }
         }
         function clearError() {
-          const errDiv = modal.querySelector("#polyguard-error");
-          if (errDiv) errDiv.style.display = "none";
+          if (!isTargetMode) {
+            const errDiv = modal.querySelector("#polyguard-error");
+            if (errDiv) errDiv.style.display = "none";
+          }
         }
         function handleClose() {
           closed = true;
@@ -11058,12 +11086,15 @@
           cleanup();
           reject(new Error("User cancelled"));
         }
-        modal.querySelector("#polyguard-modal-close").onclick = handleClose;
-        modal.querySelector("#polyguard-modal-cancel").onclick = handleClose;
+        if (!isTargetMode) {
+          modal.querySelector("#polyguard-modal-close").onclick = handleClose;
+          modal.querySelector("#polyguard-modal-cancel").onclick = handleClose;
+        }
         try {
           clearError();
           const wsProtocol = window.location.protocol === "https:" ? "wss" : "ws";
-          const ticketRes = await fetch(`https://${this.apiServer}/v2/ticket/${this.appId}`, {
+          const ticketUrl = this.link_uuid ? `https://${this.apiServer}/v2/ticket/${this.appId}/${this.link_uuid}` : `https://${this.apiServer}/v2/ticket/${this.appId}`;
+          const ticketRes = await fetch(ticketUrl, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({ requiredProofs: this.requiredProofs, scanType: this.scanType })
@@ -11103,26 +11134,27 @@
                 if (pcre) {
                   ws.send(JSON.stringify({ type: "pong", seq: pcre[1] }));
                 }
-                const qrDiv2 = modal.querySelector("#polyguard-qr");
-                if (!qrDiv2) return;
+                if (!qrDiv) return;
                 const isMobile = /Mobi|Android/i.test(navigator.userAgent);
                 if (isMobile) {
-                  qrDiv2.innerHTML = `<button id="polyguard-open-app-button" style="background: #7be7c2; color: #222; font-weight: 600; border-radius: 8px; border: none; padding: 10px 32px; font-size: 16px; cursor: pointer;">Open Polyguard App</button>`;
-                  qrDiv2.style.background = "transparent";
-                  qrDiv2.querySelector("#polyguard-open-app-button").onclick = () => window.location.assign(data.qr_url);
-                  const instructionText = qrDiv2.nextElementSibling;
-                  if (instructionText) {
-                    instructionText.textContent = "Tap the button to verify with the Polyguard app.";
-                  }
-                  const instructionList = instructionText.nextElementSibling;
-                  if (instructionList && instructionList.children[1]) {
-                    instructionList.children[1].textContent = "If you do not have the Polyguard app, you will be redirected to download it.";
+                  qrDiv.innerHTML = `<button id="polyguard-open-app-button" style="background: #7be7c2; color: #222; font-weight: 600; border-radius: 8px; border: none; padding: 10px 32px; font-size: 16px; cursor: pointer;">Open Polyguard App</button>`;
+                  qrDiv.style.background = "transparent";
+                  qrDiv.querySelector("#polyguard-open-app-button").onclick = () => window.location.assign(data.qr_url);
+                  if (!isTargetMode) {
+                    const instructionText = qrDiv.nextElementSibling;
+                    if (instructionText) {
+                      instructionText.textContent = "Tap the button to verify with the Polyguard app.";
+                    }
+                    const instructionList = instructionText.nextElementSibling;
+                    if (instructionList && instructionList.children[1]) {
+                      instructionList.children[1].textContent = "If you do not have the Polyguard app, you will be redirected to download it.";
+                    }
                   }
                 } else {
                   const startTime = Date.now();
                   console.log("time before qr code", startTime);
                   import_qrcode.default.toString(data.qr_url, { type: "svg" }, (err, svg) => {
-                    if (!err) qrDiv2.innerHTML = svg;
+                    if (!err) qrDiv.innerHTML = svg;
                   });
                   console.log("time to generate qr code", Date.now() - startTime);
                 }
@@ -11130,12 +11162,11 @@
               } else if (data && data.jwt) {
                 cleanup();
                 ws.close();
-                resolve(data.jwt);
+                resolve(rawJwt ? data : data.jwt);
                 return;
               } else if (data && data.status) {
-                const qrDiv2 = modal.querySelector("#polyguard-qr");
-                if (!qrDiv2) return;
-                qrDiv2.innerHTML = LOADING_SPINNER;
+                if (!qrDiv) return;
+                qrDiv.innerHTML = LOADING_SPINNER;
                 return;
               } else if (data && data.error) {
                 returnError(data.error);
@@ -11167,11 +11198,12 @@
     /**
      * Wrapper around verify that checks received proof values against expected values.
      * @param {Object} expectedProofs - An object mapping proof names to expected values.
+     * @param {string} target - Optional ID of target element to render QR code in.
      * @returns {Promise<boolean>} - Resolves to true if all expected proofs match, false otherwise or if cancelled.
      */
-    async require(expectedProofs = {}) {
+    async require(expectedProofs = {}, target = null) {
       try {
-        const jwt = await this.verify();
+        const jwt = await this.verify(target);
         if (!jwt) return false;
         const payload = JSON.parse(atob(jwt.split(".")[1]));
         console.dir(payload);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polyguard/sdk",
-  "version": "1.1.3",
+  "version": "1.1.6",
   "main": "dist/sdk.js",
   "module": "dist/sdk.js",
   "browser": "dist/sdk.js",
@@ -20,7 +20,7 @@
     "superagent": "^8.1.2"
   },
   "devDependencies": {
-    "esbuild": "^0.21.4"
+    "esbuild": "^0.25.0"
   },
   "repository": {
     "type": "git",

package/src/PolyguardWebsocketClientImpl.js

@@ -24,7 +24,7 @@ const LOADING_SPINNER = `<svg xmlns="http://www.w3.org/2000/svg" width="200" hei
 export class PolyguardWebsocketClientImpl {
   constructor(params = {}) {
     this.apiClient = new PolyguardApi.ApiClient();
-    const { apiKey, baseUrl, appId, apiServer, requiredProofs = ['Full Name'], scanType = 'single', redirectUrl, callbackUrl, cookieName } = params;
+    const { apiKey, baseUrl, appId, apiServer, requiredProofs = ['Full Name'], scanType = 'single', redirectUrl, callbackUrl, cookieName, link_uuid } = params;
     if (baseUrl) {
       this.apiClient.basePath = baseUrl;
     }
@@ -49,6 +49,7 @@ export class PolyguardWebsocketClientImpl {
     this.redirectUrl = redirectUrl;
     this.callbackUrl = callbackUrl;
     this.cookieName = cookieName;
+    this.link_uuid = link_uuid;
   }
 
   buildModal() {
@@ -83,23 +84,46 @@ export class PolyguardWebsocketClientImpl {
     return modal;
   }
 
-  async verify() {
+  async verify(target = null, rawJwt = false) {
     // Only websocket integration is supported for modal
-    // Create modal DOM
-    const modal = this.buildModal();
+    let modal = null;
+    let qrDiv = null;
+    let isTargetMode = false;
     
-    // Show modal immediately with spinner
-    document.body.appendChild(modal);
+    if (target) {
+      // Target mode: render QR code in specified element
+      isTargetMode = true;
+      qrDiv = document.getElementById(target);
+      if (!qrDiv) {
+        throw new Error(`Target element with ID '${target}' not found`);
+      }
+    } else {
+      // Modal mode: create modal DOM
+      modal = this.buildModal();
+    }
+    
+    if (!isTargetMode) {
+      // Show modal immediately with spinner
+      document.body.appendChild(modal);
+      
+      // Initialize QR div with spinner
+      qrDiv = modal.querySelector('#polyguard-qr');
+    }
     
-    // Initialize QR div with spinner
-    const qrDiv = modal.querySelector('#polyguard-qr');
     if (qrDiv) {
       qrDiv.innerHTML = LOADING_SPINNER;
     }
     
-    // Helper to cleanup modal
+    // Helper to cleanup modal or target
     function cleanup() {
-      if (modal.parentNode) modal.parentNode.removeChild(modal);
+      if (isTargetMode) {
+        // Clear target element content
+        if (qrDiv) {
+          qrDiv.innerHTML = '';
+        }
+      } else if (modal && modal.parentNode) {
+        modal.parentNode.removeChild(modal);
+      }
     }
     // Promise for JWT
     return new Promise(async (resolve, reject) => {
@@ -107,19 +131,28 @@ export class PolyguardWebsocketClientImpl {
       let closed = false;
       
       function returnError(msg, score = "OFFLINE") {
-          const errDiv = modal.querySelector('#polyguard-error');
-          if (errDiv) {
-            errDiv.textContent = msg;
-            errDiv.style.display = 'block';
-          }
-          setTimeout(() => {
+          if (isTargetMode) {
+            // In target mode, just log the error and resolve with error data
+            console.error('Polyguard Error:', msg);
             cleanup();
             resolve({presence: { score: score, msg: msg }});
-          }, 1250);
+          } else {
+            const errDiv = modal.querySelector('#polyguard-error');
+            if (errDiv) {
+              errDiv.textContent = msg;
+              errDiv.style.display = 'block';
+            }
+            setTimeout(() => {
+              cleanup();
+              resolve({presence: { score: score, msg: msg }});
+            }, 1250);
+          }
       }
       function clearError() {
-        const errDiv = modal.querySelector('#polyguard-error');
-        if (errDiv) errDiv.style.display = 'none';
+        if (!isTargetMode) {
+          const errDiv = modal.querySelector('#polyguard-error');
+          if (errDiv) errDiv.style.display = 'none';
+        }
       }
       // Close/cancel handler
       function handleClose() {
@@ -129,15 +162,20 @@ export class PolyguardWebsocketClientImpl {
         reject(new Error('User cancelled'));
       }
       
-      // Set up close/cancel handlers
-      modal.querySelector('#polyguard-modal-close').onclick = handleClose;
-      modal.querySelector('#polyguard-modal-cancel').onclick = handleClose;
+      // Set up close/cancel handlers (only in modal mode)
+      if (!isTargetMode) {
+        modal.querySelector('#polyguard-modal-close').onclick = handleClose;
+        modal.querySelector('#polyguard-modal-cancel').onclick = handleClose;
+      }
       
       // Start ticket/ws flow
       try {
         clearError();
         const wsProtocol = window.location.protocol === 'https:' ? 'wss' : 'ws';
-        const ticketRes = await fetch(`https://${this.apiServer}/v2/ticket/${this.appId}`, {
+        const ticketUrl = this.link_uuid 
+          ? `https://${this.apiServer}/v2/ticket/${this.appId}/${this.link_uuid}`
+          : `https://${this.apiServer}/v2/ticket/${this.appId}`;
+        const ticketRes = await fetch(ticketUrl, {
           method: 'POST',
           headers: { 'Content-Type': 'application/json' },
           body: JSON.stringify({ requiredProofs: this.requiredProofs, scanType: this.scanType }),
@@ -182,7 +220,6 @@ export class PolyguardWebsocketClientImpl {
                 ws.send(JSON.stringify({ type: 'pong', seq: pcre[1] }));
               }
 
-              const qrDiv = modal.querySelector('#polyguard-qr');
               if (!qrDiv) return;
 
               const isMobile = /Mobi|Android/i.test(navigator.userAgent);
@@ -193,14 +230,16 @@ export class PolyguardWebsocketClientImpl {
                 qrDiv.style.background = 'transparent';
                 qrDiv.querySelector('#polyguard-open-app-button').onclick = () => window.location.assign(data.qr_url);
 
-                // Update surrounding text
-                const instructionText = qrDiv.nextElementSibling;
-                if (instructionText) {
-                  instructionText.textContent = 'Tap the button to verify with the Polyguard app.';
-                }
-                const instructionList = instructionText.nextElementSibling;
-                if (instructionList && instructionList.children[1]) {
-                  instructionList.children[1].textContent = 'If you do not have the Polyguard app, you will be redirected to download it.';
+                // Update surrounding text only in modal mode
+                if (!isTargetMode) {
+                  const instructionText = qrDiv.nextElementSibling;
+                  if (instructionText) {
+                    instructionText.textContent = 'Tap the button to verify with the Polyguard app.';
+                  }
+                  const instructionList = instructionText.nextElementSibling;
+                  if (instructionList && instructionList.children[1]) {
+                    instructionList.children[1].textContent = 'If you do not have the Polyguard app, you will be redirected to download it.';
+                  }
                 }
               } else {
                 const startTime = Date.now();
@@ -215,12 +254,11 @@ export class PolyguardWebsocketClientImpl {
             } else if (data && data.jwt) {
               cleanup();
               ws.close();
-              resolve(data.jwt);
+              resolve(rawJwt ? data : data.jwt);
               return;
             } else if (data && data.status) {
               // ignore
               // generate a spinner in svg and set the qr code to it
-              const qrDiv = modal.querySelector('#polyguard-qr');
               if (!qrDiv) return;
               qrDiv.innerHTML = LOADING_SPINNER;
               return;
@@ -257,11 +295,12 @@ export class PolyguardWebsocketClientImpl {
   /**
    * Wrapper around verify that checks received proof values against expected values.
    * @param {Object} expectedProofs - An object mapping proof names to expected values.
+   * @param {string} target - Optional ID of target element to render QR code in.
    * @returns {Promise<boolean>} - Resolves to true if all expected proofs match, false otherwise or if cancelled.
    */
-  async require(expectedProofs = {}) {
+  async require(expectedProofs = {}, target = null) {
     try {
-      const jwt = await this.verify();
+      const jwt = await this.verify(target);
       if (!jwt) return false;
       // Decode JWT (without verifying signature)
       const payload = JSON.parse(atob(jwt.split('.')[1]));