astra-sdk-web 1.1.27 → 1.1.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astra-sdk-web",
-  "version": "1.1.27",
+  "version": "1.1.29",
   "description": "Official Astra SDK for JavaScript/TypeScript",
   "type": "module",
   "main": "./dist/astra-sdk.cjs.js",

package/src/pages/MobileRoute.tsx

@@ -1,5 +1,6 @@
 import { useEffect, useState } from 'react';
 import { isMobileDevice } from '../utils/deviceDetection';
+import { getKycConfig, clearExpiredConfigs } from '../utils/kycConfigStorage';
 import FaceScanModal from './FaceScanModal';
 import { KycProvider } from '../contexts/KycContext';
 import '../index.css';
@@ -22,27 +23,62 @@ function MobileRoute({ onClose, onNavigate }: MobileRouteProps = {}) {
   } | null>(null);
 
   useEffect(() => {
+    // Clear expired configs on mount
+    clearExpiredConfigs();
+
     if (!isMobileDevice() && onNavigate) {
       onNavigate('qr');
       return;
     }
 
-    // If accessed standalone (via URL), get config from URL params
+    // Get sessionId from URL params
     const searchParams = new URLSearchParams(window.location.search);
     const sessionId = searchParams.get('sessionId');
-    const apiBaseUrl = searchParams.get('apiBaseUrl') || searchParams.get('apiUrl') || '';
-    const serverKey = searchParams.get('serverKey') || '';
-
-    if (sessionId && apiBaseUrl && serverKey) {
-      setConfig({
-        apiBaseUrl,
-        sessionId,
-        serverKey,
-      });
-    } else if (sessionId) {
-      // Try to get from localStorage or use defaults
-      // For now, we'll need these to be passed via URL
-      console.error('Missing required parameters: apiBaseUrl and serverKey must be in URL');
+
+    if (sessionId) {
+      let apiBaseUrl = '';
+      let serverKey = '';
+
+      // First, try to decode config from URL (for cross-device QR scanning)
+      const encodedConfig = searchParams.get('config');
+      if (encodedConfig) {
+        try {
+          const decodedConfig = JSON.parse(atob(encodedConfig));
+          if (decodedConfig.apiBaseUrl && decodedConfig.serverKey) {
+            apiBaseUrl = decodedConfig.apiBaseUrl;
+            serverKey = decodedConfig.serverKey;
+          }
+        } catch (error) {
+          console.error('Failed to decode config from URL:', error);
+        }
+      }
+
+      // If not found in encoded config, try localStorage (for same-device scenarios)
+      if (!apiBaseUrl || !serverKey) {
+        const storedConfig = getKycConfig(sessionId);
+        if (storedConfig) {
+          apiBaseUrl = storedConfig.apiBaseUrl;
+          serverKey = storedConfig.serverKey;
+        }
+      }
+
+      // Fallback: try to get from URL params directly (for backward compatibility)
+      if (!apiBaseUrl || !serverKey) {
+        apiBaseUrl = searchParams.get('apiBaseUrl') || searchParams.get('apiUrl') || '';
+        serverKey = searchParams.get('serverKey') || '';
+      }
+
+      if (apiBaseUrl && serverKey) {
+        setConfig({
+          apiBaseUrl,
+          sessionId,
+          serverKey,
+        });
+      } else {
+        console.error('Missing required parameters: apiBaseUrl and serverKey not found in URL config, localStorage, or URL params');
+      }
+    } else {
+      console.error('Missing required parameter: sessionId must be in URL');
     }
   }, [onNavigate]);
 
@@ -90,7 +126,7 @@ function MobileRoute({ onClose, onNavigate }: MobileRouteProps = {}) {
       <div className="bg-white p-6 rounded-lg text-center max-w-md mx-4">
         <p className="text-red-600 mb-2">Missing Configuration</p>
         <p className="text-sm text-gray-600">
-          Please ensure the URL includes sessionId, apiBaseUrl, and serverKey parameters.
+          Please ensure the URL includes sessionId parameter. The configuration should be stored automatically when scanning the QR code.
         </p>
       </div>
     </div>

package/src/pages/QRCodePage.tsx

@@ -1,6 +1,7 @@
 import { useState, useEffect } from 'react';
 import { QRCodeSVG } from 'qrcode.react';
 import { KycApiService } from '../services/kycApiService';
+import { storeKycConfig } from '../utils/kycConfigStorage';
 // @ts-ignore - optional dependency, may not be installed in some consumers
 import { toast, ToastContainer } from 'react-toastify';
 // @ts-ignore - import styles only when package is present
@@ -21,25 +22,25 @@ function QRCodePage({ onClose, mobileBaseUrl = 'https://kyc-sdk.astraprotocol.co
   const [copied, setCopied] = useState<boolean>(false);
 
   useEffect(() => {
-    // Get search params from current URL
-    const searchParams = new URLSearchParams(window.location.search);
-    
-    // Add required params to query string for mobile route
-    if (sessionId) {
-      searchParams.set('sessionId', sessionId);
-    }
-    if (apiBaseUrl) {
-      searchParams.set('apiBaseUrl', apiBaseUrl);
+    // Store config in localStorage for mobile route to retrieve (for same-device scenarios)
+    if (sessionId && apiBaseUrl && serverKey) {
+      storeKycConfig(sessionId, apiBaseUrl, serverKey);
     }
-    if (serverKey) {
-      searchParams.set('serverKey', serverKey);
+
+    // Encode config in URL for cross-device scenarios (when QR is scanned on different device)
+    if (sessionId && apiBaseUrl && serverKey) {
+      const mobileRoute = '/mobileroute';
+      // Encode config as base64 to include in URL (needed for cross-device QR scanning)
+      const config = JSON.stringify({ apiBaseUrl, serverKey });
+      const encodedConfig = btoa(config);
+      const fullUrl = `${mobileBaseUrl}${mobileRoute}?sessionId=${sessionId}&config=${encodedConfig}`;
+      setQrUrl(fullUrl);
+    } else if (sessionId) {
+      // Fallback: just sessionId if config not available
+      const mobileRoute = '/mobileroute';
+      const fullUrl = `${mobileBaseUrl}${mobileRoute}?sessionId=${sessionId}`;
+      setQrUrl(fullUrl);
     }
-    
-    const mobileRoute = '/mobileroute';
-    const queryString = searchParams.toString();
-    const fullUrl = `${mobileBaseUrl}${mobileRoute}${queryString ? `?${queryString}` : ''}`;
-    
-    setQrUrl(fullUrl);
   }, [mobileBaseUrl, sessionId, apiBaseUrl, serverKey]);
 
   const handleCopyUrl = async () => {

package/src/utils/kycConfigStorage.ts

@@ -0,0 +1,125 @@
+/**
+ * Utility functions for storing and retrieving KYC configuration
+ * Uses localStorage to store apiBaseUrl and serverKey associated with sessionId
+ */
+
+interface KycConfig {
+  apiBaseUrl: string;
+  serverKey: string;
+  sessionId: string;
+}
+
+const STORAGE_PREFIX = 'kyc_config_';
+const STORAGE_EXPIRY_MS = 24 * 60 * 60 * 1000; // 24 hours
+
+/**
+ * Store KYC configuration in localStorage
+ */
+export function storeKycConfig(sessionId: string, apiBaseUrl: string, serverKey: string): void {
+  if (!sessionId || !apiBaseUrl || !serverKey) {
+    console.warn('Cannot store KYC config: missing required parameters');
+    return;
+  }
+
+  try {
+    const config: KycConfig = {
+      apiBaseUrl,
+      serverKey,
+      sessionId,
+    };
+    
+    const storageKey = `${STORAGE_PREFIX}${sessionId}`;
+    const data = {
+      config,
+      timestamp: Date.now(),
+    };
+    
+    localStorage.setItem(storageKey, JSON.stringify(data));
+  } catch (error) {
+    console.error('Failed to store KYC config:', error);
+  }
+}
+
+/**
+ * Retrieve KYC configuration from localStorage
+ */
+export function getKycConfig(sessionId: string): { apiBaseUrl: string; serverKey: string } | null {
+  if (!sessionId) {
+    return null;
+  }
+
+  try {
+    const storageKey = `${STORAGE_PREFIX}${sessionId}`;
+    const stored = localStorage.getItem(storageKey);
+    
+    if (!stored) {
+      return null;
+    }
+
+    const data = JSON.parse(stored);
+    
+    // Check if config is expired
+    if (data.timestamp && Date.now() - data.timestamp > STORAGE_EXPIRY_MS) {
+      localStorage.removeItem(storageKey);
+      return null;
+    }
+
+    if (data.config && data.config.apiBaseUrl && data.config.serverKey) {
+      return {
+        apiBaseUrl: data.config.apiBaseUrl,
+        serverKey: data.config.serverKey,
+      };
+    }
+
+    return null;
+  } catch (error) {
+    console.error('Failed to retrieve KYC config:', error);
+    return null;
+  }
+}
+
+/**
+ * Clear KYC configuration from localStorage
+ */
+export function clearKycConfig(sessionId: string): void {
+  if (!sessionId) {
+    return;
+  }
+
+  try {
+    const storageKey = `${STORAGE_PREFIX}${sessionId}`;
+    localStorage.removeItem(storageKey);
+  } catch (error) {
+    console.error('Failed to clear KYC config:', error);
+  }
+}
+
+/**
+ * Clear all expired KYC configurations
+ */
+export function clearExpiredConfigs(): void {
+  try {
+    const keys = Object.keys(localStorage);
+    const now = Date.now();
+
+    keys.forEach((key) => {
+      if (key.startsWith(STORAGE_PREFIX)) {
+        try {
+          const stored = localStorage.getItem(key);
+          if (stored) {
+            const data = JSON.parse(stored);
+            if (data.timestamp && now - data.timestamp > STORAGE_EXPIRY_MS) {
+              localStorage.removeItem(key);
+            }
+          }
+        } catch (error) {
+          // If parsing fails, remove the key
+          localStorage.removeItem(key);
+        }
+      }
+    });
+  } catch (error) {
+    console.error('Failed to clear expired configs:', error);
+  }
+}
+