@polyguard/sdk 1.1.3 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polyguard/sdk",
-  "version": "1.1.3",
+  "version": "1.2.0",
   "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]));

package/src/generated/src/ApiClient.js

@@ -203,22 +203,6 @@ class ApiClient {
     * @returns {Boolean} <code>true</code> if <code>param</code> represents a file.
     */
     isFileParam(param) {
-        // fs.ReadStream in Node.js and Electron (but not in runtime like browserify)
-        if (typeof require === 'function') {
-            let fs;
-            try {
-                fs = require('fs');
-            } catch (err) {}
-            if (fs && fs.ReadStream && param instanceof fs.ReadStream) {
-                return true;
-            }
-        }
-
-        // Buffer in Node.js
-        if (typeof Buffer === 'function' && param instanceof Buffer) {
-            return true;
-        }
-
         // Blob in browser
         if (typeof Blob === 'function' && param instanceof Blob) {
             return true;

package/src/index.js

@@ -9,12 +9,4 @@ if (typeof window !== 'undefined') {
 }
 
 export { PolyguardClient };
-export * from './generated/src/index.js';
-
-// Add this for CommonJS compatibility
-if (typeof module !== 'undefined' && typeof module.exports !== 'undefined') {
-  module.exports = {
-    PolyguardClient,
-    ...PolyguardApi
-  };
-} 
+export * from './generated/src/index.js';