@moveris/shared 3.6.0 → 3.6.2

package/README.md

@@ -30,7 +30,7 @@ const result = await client.fastCheck(frames, {
   source: 'live',
 });
 
-console.log(result.verdict); // 'live' or 'fake'
+console.log(result.verdict); // 'live', 'fake', or 'inconclusive'
 console.log(result.confidence); // 0-1
 console.log(result.score); // 0-100
 ```
@@ -260,13 +260,14 @@ type FrameSource = 'media' | 'live';
 Liveness determination result.
 
 ```typescript
-type Verdict = 'live' | 'fake';
+type Verdict = 'live' | 'fake' | 'inconclusive';
 ```
 
-| Value    | Description                                          |
-| -------- | ---------------------------------------------------- |
-| `'live'` | Real person detected                                 |
-| `'fake'` | Spoofing attempt detected (photo, video, mask, etc.) |
+| Value            | Description                                                                      |
+| ---------------- | -------------------------------------------------------------------------------- |
+| `'live'`         | Real person detected                                                             |
+| `'fake'`         | Spoofing attempt detected (photo, video, mask, etc.)                             |
+| `'inconclusive'` | API processed successfully but could not determine a verdict — retry recommended |
 
 #### LivenessState
 
@@ -288,7 +289,7 @@ Result returned from liveness verification.
 
 ```typescript
 interface LivenessResult {
-  verdict: Verdict; // 'live' or 'fake'
+  verdict: Verdict; // 'live', 'fake', or 'inconclusive'
   confidence: number; // Confidence score (0-1)
   score: number; // Liveness score (0-100)
   sessionId: string; // Session identifier
@@ -550,7 +551,7 @@ const status = getStatusMessage('capturing', DEFAULT_LOCALE);
 | `camera_angle_low`  | "Raise camera to eye level"    | Camera below face (Y < 0.3)                                                       |
 | `camera_angle_high` | "Lower camera to eye level"    | Camera above face (Y > 0.7)                                                       |
 | `camera_tilted`     | "Hold camera level"            | Device tilt > 15° (via transformation matrix, falls back to eye-corner landmarks) |
-| `flat_lighting`     | "Find better lighting"         | Face-region dynamic range < 180 L-units — soft warning, capture continues         |
+| `flat_lighting`     | "Find better lighting"         | Face-region dynamic range < 60 L-units — soft warning, capture continues          |
 
 ---
 
@@ -683,7 +684,7 @@ const angleResult = detectCameraAngle(landmarks); // requires ≥153 landmarks
 // Pass pre-sampled face-region pixels — use sampleFaceRegionPixels() in @moveris/react
 import { analyzeDynamicRange } from '@moveris/shared';
 const drResult = analyzeDynamicRange(rgbaPixels);
-// { range: number (max L* − min L*), isLow: boolean (< 180) }
+// { range: number (max L* − min L*), isLow: boolean (< 60) }
 // Soft warning — do not use as a hard capture gate
 ```
 

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-type Verdict = 'live' | 'fake';
+type Verdict = 'live' | 'fake' | 'inconclusive';
 interface ModelEntry {
     id: string;
     label: string;
@@ -344,7 +344,7 @@ declare const MAX_FACE_RATIO = 0.7;
 declare const FACE_CROP_OUTPUT_SIZE = 224;
 declare const MAX_FACE_PERCENTAGE_IN_CROP = 0.45;
 declare const TARGET_FACE_PERCENTAGE_IN_CROP = 0.33;
-declare const DYNAMIC_RANGE_WARNING_THRESHOLD = 180;
+declare const DYNAMIC_RANGE_WARNING_THRESHOLD = 60;
 interface DynamicRangeAnalysis {
     range: number;
     isLow: boolean;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type Verdict = 'live' | 'fake';
+type Verdict = 'live' | 'fake' | 'inconclusive';
 interface ModelEntry {
     id: string;
     label: string;
@@ -344,7 +344,7 @@ declare const MAX_FACE_RATIO = 0.7;
 declare const FACE_CROP_OUTPUT_SIZE = 224;
 declare const MAX_FACE_PERCENTAGE_IN_CROP = 0.45;
 declare const TARGET_FACE_PERCENTAGE_IN_CROP = 0.33;
-declare const DYNAMIC_RANGE_WARNING_THRESHOLD = 180;
+declare const DYNAMIC_RANGE_WARNING_THRESHOLD = 60;
 interface DynamicRangeAnalysis {
     range: number;
     isLow: boolean;

package/dist/index.js

@@ -265,7 +265,18 @@ function toHybridFrameData(frames) {
 }
 function toLivenessResult(response) {
   if (!response.verdict) {
-    throw new LivenessApiError(response.error ?? "No verdict received", "no_verdict", 500);
+    if (response.error) {
+      throw new LivenessApiError(response.error, "no_verdict", 500);
+    }
+    return {
+      verdict: "inconclusive",
+      confidence: response.confidence ?? 0,
+      score: response.score ?? 0,
+      sessionId: response.session_id,
+      processingMs: response.processing_ms,
+      framesProcessed: "frames_processed" in response ? response.frames_processed ?? 0 : 0,
+      warnings: "warnings" in response && Array.isArray(response.warnings) ? response.warnings : void 0
+    };
   }
   return {
     verdict: response.verdict,
@@ -282,8 +293,18 @@ function toLivenessResultFromStream(response) {
     throw new LivenessApiError("Stream not complete", "stream_incomplete", 400);
   }
   if (!response.verdict) {
-    const errorCode = response.error ?? "no_verdict";
-    throw new LivenessApiError(response.error ?? "No verdict received", errorCode, 500);
+    if (response.error) {
+      throw new LivenessApiError(response.error, response.error, 500);
+    }
+    return {
+      verdict: "inconclusive",
+      confidence: response.confidence ?? 0,
+      score: response.score ?? 0,
+      sessionId: response.session_id,
+      processingMs: response.processing_ms ?? 0,
+      framesProcessed: response.frames_processed ?? 0,
+      warnings: Array.isArray(response.warnings) ? response.warnings : void 0
+    };
   }
   return {
     verdict: response.verdict,
@@ -1674,7 +1695,7 @@ var MAX_FACE_RATIO = 0.7;
 var FACE_CROP_OUTPUT_SIZE = 224;
 var MAX_FACE_PERCENTAGE_IN_CROP = 0.45;
 var TARGET_FACE_PERCENTAGE_IN_CROP = 0.33;
-var DYNAMIC_RANGE_WARNING_THRESHOLD = 180;
+var DYNAMIC_RANGE_WARNING_THRESHOLD = 60;
 function srgbToLinear(c) {
   const n = c / 255;
   return n <= 0.04045 ? n / 12.92 : Math.pow((n + 0.055) / 1.055, 2.4);

package/dist/index.mjs

@@ -121,7 +121,18 @@ function toHybridFrameData(frames) {
 }
 function toLivenessResult(response) {
   if (!response.verdict) {
-    throw new LivenessApiError(response.error ?? "No verdict received", "no_verdict", 500);
+    if (response.error) {
+      throw new LivenessApiError(response.error, "no_verdict", 500);
+    }
+    return {
+      verdict: "inconclusive",
+      confidence: response.confidence ?? 0,
+      score: response.score ?? 0,
+      sessionId: response.session_id,
+      processingMs: response.processing_ms,
+      framesProcessed: "frames_processed" in response ? response.frames_processed ?? 0 : 0,
+      warnings: "warnings" in response && Array.isArray(response.warnings) ? response.warnings : void 0
+    };
   }
   return {
     verdict: response.verdict,
@@ -138,8 +149,18 @@ function toLivenessResultFromStream(response) {
     throw new LivenessApiError("Stream not complete", "stream_incomplete", 400);
   }
   if (!response.verdict) {
-    const errorCode = response.error ?? "no_verdict";
-    throw new LivenessApiError(response.error ?? "No verdict received", errorCode, 500);
+    if (response.error) {
+      throw new LivenessApiError(response.error, response.error, 500);
+    }
+    return {
+      verdict: "inconclusive",
+      confidence: response.confidence ?? 0,
+      score: response.score ?? 0,
+      sessionId: response.session_id,
+      processingMs: response.processing_ms ?? 0,
+      framesProcessed: response.frames_processed ?? 0,
+      warnings: Array.isArray(response.warnings) ? response.warnings : void 0
+    };
   }
   return {
     verdict: response.verdict,
@@ -1530,7 +1551,7 @@ var MAX_FACE_RATIO = 0.7;
 var FACE_CROP_OUTPUT_SIZE = 224;
 var MAX_FACE_PERCENTAGE_IN_CROP = 0.45;
 var TARGET_FACE_PERCENTAGE_IN_CROP = 0.33;
-var DYNAMIC_RANGE_WARNING_THRESHOLD = 180;
+var DYNAMIC_RANGE_WARNING_THRESHOLD = 60;
 function srgbToLinear(c) {
   const n = c / 255;
   return n <= 0.04045 ? n / 12.92 : Math.pow((n + 0.055) / 1.055, 2.4);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moveris/shared",
-  "version": "3.6.0",
+  "version": "3.6.2",
   "description": "Core business logic for Moveris Live SDK",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",