@hexar/biometric-identity-sdk-core 1.0.12 → 1.0.14

package/dist/BiometricIdentitySDK.js

@@ -311,7 +311,9 @@ class BiometricIdentitySDK {
             logger_1.logger.info('Sending validation request to backend', {
                 framesCount: videoFrames.length,
                 duration: this.state.videoData.duration,
-                challengesCount: this.state.videoData.challengesCompleted?.length || 0
+                challengesCount: this.state.videoData.challengesCompleted?.length || 0,
+                frontImageSize: this.state.frontID.data?.length || 0,
+                backImageSize: this.state.backID?.data?.length || 0
             });
             const response = await this.backendClient.fullValidation({
                 frontIdImage: this.state.frontID.data,
@@ -324,8 +326,22 @@ class BiometricIdentitySDK {
             return this.backendClient.convertToValidationResult(response);
         }
         catch (error) {
-            logger_1.logger.error('Backend validation failed', error);
-            throw this.createError(types_1.BiometricErrorCode.NETWORK_ERROR, 'Backend validation failed', error);
+            logger_1.logger.error('Backend validation failed', {
+                errorMessage: error?.message,
+                errorName: error?.name,
+                status: error?.status,
+                statusText: error?.statusText,
+                errorData: error?.errorData,
+                errorStack: error?.stack?.substring(0, 500)
+            });
+            const errorMessage = error?.message ||
+                (error?.status ? `Backend request failed with status ${error.status}` : 'Backend validation failed');
+            throw this.createError(types_1.BiometricErrorCode.NETWORK_ERROR, errorMessage, {
+                status: error?.status,
+                statusText: error?.statusText,
+                errorData: error?.errorData,
+                originalError: error?.message
+            });
         }
     }
     /**

package/dist/api/BackendClient.js

@@ -88,10 +88,10 @@ class BackendClient {
      */
     async fullValidation(params) {
         if (!this.currentSessionId) {
-            // Generate a challenge first if no session exists
+            logger_1.logger.info('No session ID, generating challenge');
             await this.generateChallenge();
         }
-        return this.request('/api/v1/validate', 'POST', {
+        const requestBody = {
             front_id_image: params.frontIdImage,
             back_id_image: params.backIdImage,
             video_frames: params.videoFrames,
@@ -101,7 +101,20 @@ class BackendClient {
             document_type: params.documentType,
             country_code: params.countryCode,
             device_info: params.deviceInfo,
+        };
+        logger_1.logger.info('Full validation request', {
+            hasSessionId: !!this.currentSessionId,
+            sessionId: this.currentSessionId,
+            videoFramesCount: params.videoFrames.length,
+            hasFrontImage: !!params.frontIdImage,
+            hasBackImage: !!params.backIdImage,
+            frontImageLength: params.frontIdImage?.length || 0,
+            backImageLength: params.backIdImage?.length || 0,
+            averageFrameLength: params.videoFrames.length > 0
+                ? Math.round(params.videoFrames.reduce((sum, f) => sum + f.length, 0) / params.videoFrames.length)
+                : 0
         });
+        return this.request('/api/v1/validate', 'POST', requestBody);
     }
     /**
      * Convert backend response to SDK ValidationResult format
@@ -171,6 +184,12 @@ class BackendClient {
      */
     async request(endpoint, method, body) {
         const url = `${this.config.apiEndpoint}${endpoint}`;
+        logger_1.logger.info('Making backend request', {
+            url,
+            method,
+            hasBody: !!body,
+            bodySize: body ? JSON.stringify(body).length : 0
+        });
         const controller = new AbortController();
         const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
         const headers = {
@@ -187,25 +206,65 @@ class BackendClient {
                 body: body ? JSON.stringify(body) : undefined,
                 signal: controller.signal,
             });
+            logger_1.logger.info('Backend response received', {
+                url,
+                status: response.status,
+                statusText: response.statusText,
+                ok: response.ok
+            });
             clearTimeout(timeoutId);
             if (!response.ok) {
-                // Handle 413 Payload Too Large specifically
+                let errorText = '';
+                let errorData = {};
+                try {
+                    errorText = await response.text();
+                    if (errorText) {
+                        try {
+                            errorData = JSON.parse(errorText);
+                        }
+                        catch {
+                            errorData = { raw: errorText };
+                        }
+                    }
+                }
+                catch (parseError) {
+                    logger_1.logger.warn('Could not parse error response', parseError);
+                }
+                const errorMessage = errorData?.error?.message ||
+                    errorData?.detail ||
+                    errorData?.message ||
+                    errorData?.raw ||
+                    `Request failed with status ${response.status}: ${response.statusText}`;
+                logger_1.logger.error('Backend request failed', {
+                    url,
+                    method,
+                    status: response.status,
+                    statusText: response.statusText,
+                    errorText: errorText.substring(0, 500),
+                    errorData: JSON.stringify(errorData).substring(0, 500)
+                });
+                const error = new Error(errorMessage);
+                error.status = response.status;
+                error.statusText = response.statusText;
+                error.errorData = errorData;
                 if (response.status === 413) {
                     throw new Error(`Payload too large (413). The request body exceeds the server's size limit. Try reducing the number of video frames or image sizes.`);
                 }
-                const errorData = await response.json().catch(() => ({}));
-                throw new Error(errorData?.error?.message ||
-                    errorData?.detail ||
-                    `Request failed with status ${response.status}`);
+                throw error;
             }
             return await response.json();
         }
         catch (error) {
             clearTimeout(timeoutId);
             if (error.name === 'AbortError') {
+                logger_1.logger.error('Request timeout', { url, method, timeout: this.config.timeout });
                 throw new Error('Request timeout');
             }
-            throw error;
+            if (error.message) {
+                throw error;
+            }
+            logger_1.logger.error('Unexpected request error', { url, method, error });
+            throw new Error('Network request failed');
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexar/biometric-identity-sdk-core",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Core AI engine for biometric identity verification",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/BiometricIdentitySDK.ts

@@ -394,7 +394,9 @@ export class BiometricIdentitySDK {
       logger.info('Sending validation request to backend', {
         framesCount: videoFrames.length,
         duration: this.state.videoData.duration,
-        challengesCount: this.state.videoData.challengesCompleted?.length || 0
+        challengesCount: this.state.videoData.challengesCompleted?.length || 0,
+        frontImageSize: this.state.frontID.data?.length || 0,
+        backImageSize: this.state.backID?.data?.length || 0
       });
 
       const response = await this.backendClient.fullValidation({
@@ -408,12 +410,28 @@ export class BiometricIdentitySDK {
       this.updateState({ progress: 95 });
 
       return this.backendClient.convertToValidationResult(response);
-    } catch (error) {
-      logger.error('Backend validation failed', error);
+    } catch (error: any) {
+      logger.error('Backend validation failed', {
+        errorMessage: error?.message,
+        errorName: error?.name,
+        status: error?.status,
+        statusText: error?.statusText,
+        errorData: error?.errorData,
+        errorStack: error?.stack?.substring(0, 500)
+      });
+      
+      const errorMessage = error?.message || 
+        (error?.status ? `Backend request failed with status ${error.status}` : 'Backend validation failed');
+      
       throw this.createError(
         BiometricErrorCode.NETWORK_ERROR,
-        'Backend validation failed',
-        error
+        errorMessage,
+        {
+          status: error?.status,
+          statusText: error?.statusText,
+          errorData: error?.errorData,
+          originalError: error?.message
+        }
       );
     }
   }

package/src/api/BackendClient.ts

@@ -261,24 +261,39 @@ export class BackendClient {
     deviceInfo?: Record<string, any>;
   }): Promise<FullValidationResponse> {
     if (!this.currentSessionId) {
-      // Generate a challenge first if no session exists
+      logger.info('No session ID, generating challenge');
       await this.generateChallenge();
     }
 
+    const requestBody = {
+      front_id_image: params.frontIdImage,
+      back_id_image: params.backIdImage,
+      video_frames: params.videoFrames,
+      video_duration_ms: params.videoDurationMs,
+      session_id: this.currentSessionId,
+      challenges_completed: params.challengesCompleted || [],
+      document_type: params.documentType,
+      country_code: params.countryCode,
+      device_info: params.deviceInfo,
+    };
+
+    logger.info('Full validation request', {
+      hasSessionId: !!this.currentSessionId,
+      sessionId: this.currentSessionId,
+      videoFramesCount: params.videoFrames.length,
+      hasFrontImage: !!params.frontIdImage,
+      hasBackImage: !!params.backIdImage,
+      frontImageLength: params.frontIdImage?.length || 0,
+      backImageLength: params.backIdImage?.length || 0,
+      averageFrameLength: params.videoFrames.length > 0 
+        ? Math.round(params.videoFrames.reduce((sum, f) => sum + f.length, 0) / params.videoFrames.length)
+        : 0
+    });
+
     return this.request<FullValidationResponse>(
       '/api/v1/validate',
       'POST',
-      {
-        front_id_image: params.frontIdImage,
-        back_id_image: params.backIdImage,
-        video_frames: params.videoFrames,
-        video_duration_ms: params.videoDurationMs,
-        session_id: this.currentSessionId,
-        challenges_completed: params.challengesCompleted || [],
-        document_type: params.documentType,
-        country_code: params.countryCode,
-        device_info: params.deviceInfo,
-      }
+      requestBody
     );
   }
 
@@ -359,6 +374,13 @@ export class BackendClient {
   ): Promise<T> {
     const url = `${this.config.apiEndpoint}${endpoint}`;
     
+    logger.info('Making backend request', {
+      url,
+      method,
+      hasBody: !!body,
+      bodySize: body ? JSON.stringify(body).length : 0
+    });
+    
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
 
@@ -378,23 +400,60 @@ export class BackendClient {
         body: body ? JSON.stringify(body) : undefined,
         signal: controller.signal as RequestInit['signal'],
       });
+      
+      logger.info('Backend response received', {
+        url,
+        status: response.status,
+        statusText: response.statusText,
+        ok: response.ok
+      });
 
       clearTimeout(timeoutId);
 
       if (!response.ok) {
-        // Handle 413 Payload Too Large specifically
+        let errorText = '';
+        let errorData: Record<string, any> = {};
+        
+        try {
+          errorText = await response.text();
+          if (errorText) {
+            try {
+              errorData = JSON.parse(errorText);
+            } catch {
+              errorData = { raw: errorText };
+            }
+          }
+        } catch (parseError) {
+          logger.warn('Could not parse error response', parseError);
+        }
+
+        const errorMessage = errorData?.error?.message || 
+          errorData?.detail ||
+          errorData?.message ||
+          errorData?.raw ||
+          `Request failed with status ${response.status}: ${response.statusText}`;
+
+        logger.error('Backend request failed', {
+          url,
+          method,
+          status: response.status,
+          statusText: response.statusText,
+          errorText: errorText.substring(0, 500),
+          errorData: JSON.stringify(errorData).substring(0, 500)
+        });
+
+        const error = new Error(errorMessage);
+        (error as any).status = response.status;
+        (error as any).statusText = response.statusText;
+        (error as any).errorData = errorData;
+        
         if (response.status === 413) {
           throw new Error(
             `Payload too large (413). The request body exceeds the server's size limit. Try reducing the number of video frames or image sizes.`
           );
         }
         
-        const errorData = await response.json().catch(() => ({})) as Record<string, any>;
-        throw new Error(
-          errorData?.error?.message || 
-          errorData?.detail ||
-          `Request failed with status ${response.status}`
-        );
+        throw error;
       }
 
       return await response.json() as T;
@@ -402,10 +461,16 @@ export class BackendClient {
       clearTimeout(timeoutId);
       
       if (error.name === 'AbortError') {
+        logger.error('Request timeout', { url, method, timeout: this.config.timeout });
         throw new Error('Request timeout');
       }
       
-      throw error;
+      if (error.message) {
+        throw error;
+      }
+      
+      logger.error('Unexpected request error', { url, method, error });
+      throw new Error('Network request failed');
     }
   }
 }