@moveris/shared 2.6.0 → 2.7.0

package/README.md

@@ -26,7 +26,7 @@ const client = new LivenessClient({
 // Perform a fast liveness check
 const result = await client.fastCheck(frames, {
   sessionId: 'my-session-id', // optional — auto-generated if omitted
-  model: '10',
+  model: 'mixed-10-v2',
   source: 'live',
 });
 
@@ -64,18 +64,18 @@ Perform fast liveness check with server-side face detection. Ideal for quick ver
 ```typescript
 const result = await client.fastCheck(frames, {
   sessionId: 'optional-uuid',
-  model: '10', // '10' | '50' | '250'
+  model: 'mixed-10-v2',
   source: 'live', // 'live' | 'media'
 });
 ```
 
 **Parameters:**
 
-| Option      | Type             | Default        | Description                                                             |
-| ----------- | ---------------- | -------------- | ----------------------------------------------------------------------- |
-| `sessionId` | `string`         | auto-generated | Unique session identifier (UUID)                                        |
-| `model`     | `FastCheckModel` | `'10'`         | Model to use: `'10'` (fast), `'50'` (balanced), `'250'` (high-accuracy) |
-| `source`    | `FrameSource`    | `'live'`       | Frame source: `'live'` (camera) or `'media'` (recorded video)           |
+| Option      | Type             | Default         | Description                                                   |
+| ----------- | ---------------- | --------------- | ------------------------------------------------------------- |
+| `sessionId` | `string`         | auto-generated  | Unique session identifier (UUID)                              |
+| `model`     | `FastCheckModel` | `'mixed-10-v2'` | Model to use (see Models section)                             |
+| `source`    | `FrameSource`    | `'live'`        | Frame source: `'live'` (camera) or `'media'` (recorded video) |
 
 **Returns:** `Promise<LivenessResult>`
 
@@ -184,22 +184,34 @@ Model selection for liveness detection speed/accuracy trade-off.
 
 ```typescript
 type FastCheckModel =
+  | 'mixed-10-v2'
+  | 'mixed-30-v2'
+  | 'mixed-60-v2'
+  | 'mixed-90-v2'
+  | 'mixed-120-v2' // Active mixed-v2 models (recommended)
   | '10'
   | '50'
-  | '250' // Standard models
-  | 'hybrid-v2-10'
-  | 'hybrid-v2-50' // Hybrid V2 (physiological features)
-  | 'mixed-10'; // Mixed (visual + physiological scoring)
+  | '250' // Legacy standard models
+  | (string & object); // Forward-compatible with future model IDs
 ```
 
-| Value            | Frames | Category  | Description                               |
-| ---------------- | ------ | --------- | ----------------------------------------- |
-| `'10'`           | 10     | Standard  | Fast verification, lowest latency         |
-| `'50'`           | 50     | Standard  | Balanced speed and accuracy               |
-| `'250'`          | 250    | Standard  | Highest accuracy, slower                  |
-| `'hybrid-v2-10'` | 10     | Hybrid V2 | Visual + physiological feature extraction |
-| `'hybrid-v2-50'` | 50     | Hybrid V2 | Higher accuracy physiological features    |
-| `'mixed-10'`     | 10     | Mixed     | Combined visual + physiological scoring   |
+Active models (recommended):
+
+| Value            | Frames | Description                    |
+| ---------------- | ------ | ------------------------------ |
+| `'mixed-10-v2'`  | 10     | Fast verification, low latency |
+| `'mixed-30-v2'`  | 30     | Balanced speed and accuracy    |
+| `'mixed-60-v2'`  | 60     | Higher accuracy                |
+| `'mixed-90-v2'`  | 90     | High accuracy                  |
+| `'mixed-120-v2'` | 120    | Highest accuracy, slower       |
+
+Legacy models (still supported):
+
+| Value   | Frames | Description                 |
+| ------- | ------ | --------------------------- |
+| `'10'`  | 10     | Standard — fast             |
+| `'50'`  | 50     | Standard — balanced         |
+| `'250'` | 250    | Standard — highest accuracy |
 
 #### FrameSource
 
@@ -492,6 +504,8 @@ const glareRatio = detectSpecularHighlights(pixels);
 | Glare       | `maxGlareRatio: 0.15` | >15% of pixels are specular highlights  |
 | Occluded    | `minContrast: 12`     | Standard deviation of luminance too low |
 
+Glare detection uses a **relative threshold** (`mean brightness × 2.5`) so sensitivity adapts to ambient lighting, avoiding false positives in bright environments.
+
 Custom thresholds can be passed as a second argument to `checkEyeRegionQuality()`.
 
 ### Eye Region Landmarks

package/dist/index.d.mts

@@ -29,6 +29,7 @@ interface FastCheckRequest {
     model?: FastCheckModel;
     source?: FrameSource;
     frames: FrameData[];
+    warnings?: string[];
 }
 interface FastCheckCropsRequest {
     session_id: string;
@@ -64,6 +65,7 @@ interface FastCheckStreamRequest {
     model?: FastCheckModel;
     source?: FrameSource;
     frame: FrameData;
+    warnings?: string[];
 }
 interface FastCheckResponse {
     verdict: Verdict | null;
@@ -76,6 +78,7 @@ interface FastCheckResponse {
     frames_processed: number;
     available: boolean;
     warning: string | null;
+    warnings?: string[] | null;
     error: string | null;
 }
 interface FastCheckStreamResponse {
@@ -93,6 +96,7 @@ interface FastCheckStreamResponse {
     frames_processed: number | null;
     available: boolean;
     warning: string | null;
+    warnings?: string[] | null;
     error: string | null;
 }
 interface VerifyResponse {
@@ -157,6 +161,7 @@ interface LivenessResult {
     sessionId: string;
     processingMs: number;
     framesProcessed: number;
+    warnings?: string[];
 }
 type LivenessState = 'idle' | 'capturing' | 'uploading' | 'processing' | 'complete' | 'error';
 interface LivenessConfig {
@@ -477,22 +482,26 @@ declare class LivenessClient {
         sessionId?: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }): Promise<LivenessResult>;
     fastCheckCrops(crops: CropData[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }): Promise<LivenessResult>;
     streamFrame(frame: CapturedFrame, options: {
         sessionId: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }): Promise<FastCheckStreamResponse>;
     private sendStreamFrameInternal;
     fastCheckStream(frames: CapturedFrame[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }, callbacks?: {
         onFrameSent?: (index: number, total: number) => void;
         onFrameBuffered?: (framesReceived: number, framesRequired: number) => void;
@@ -501,6 +510,7 @@ declare class LivenessClient {
         sessionId?: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }, callbacks?: {
         onFrameSent?: (index: number, total: number) => void;
         onFrameBuffered?: (framesReceived: number, framesRequired: number) => void;
@@ -771,13 +781,13 @@ interface EyeQualityThresholds {
     minBrightness: number;
     maxBrightness: number;
     minContrast: number;
-    glarePixelThreshold: number;
+    glareRelativeFactor: number;
     maxGlareRatio: number;
 }
 declare const EYE_QUALITY_THRESHOLDS: EyeQualityThresholds;
 declare function analyzeEyeRegionBrightness(pixels: Uint8Array | Uint8ClampedArray): number;
 declare function analyzeEyeRegionContrast(pixels: Uint8Array | Uint8ClampedArray, meanBrightness?: number): number;
-declare function detectSpecularHighlights(pixels: Uint8Array | Uint8ClampedArray, threshold?: number): number;
+declare function detectSpecularHighlights(pixels: Uint8Array | Uint8ClampedArray, relativeFactor?: number, meanBrightness?: number): number;
 declare function checkEyeRegionQuality(pixels: Uint8Array | Uint8ClampedArray, thresholds?: EyeQualityThresholds): EyeRegionQuality;
 
 export { ALIGNMENT_THRESHOLD_CAPTURE, ALIGNMENT_THRESHOLD_GOOD, ALIGNMENT_THRESHOLD_PERFECT, ALIGNMENT_THRESHOLD_POOR, API_ENDPOINTS, API_ERROR_CODES, API_PATHS, AUTH_CONFIG, type ApiErrorCode, BACKLIT_RATIO_THRESHOLD, BLUR_THRESHOLD_MOBILE, BaseFrameCollector, type BlurAnalysis, type CaptureQualityState, type CapturedFrame, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_ENDPOINT, DEFAULT_FACE_DETECTION_TIERS, DEFAULT_GAZE_THRESHOLDS, DEFAULT_HAND_OCCLUSION_CONFIG, DEFAULT_LIVENESS_CONFIG, DEFAULT_LOCALE, DEFAULT_OVAL_REGION, DEFAULT_STABILIZER_CONFIG, DEFAULT_STATUS_MESSAGES, type DetectionResult, type DetectionSummary, type DetectorConfig, ERROR_MESSAGES, ERROR_MESSAGES_ES, ES_LOCALE, EYE_LANDMARK_INDICES, EYE_QUALITY_THRESHOLDS, type ErrorResponse, type EyeQualityThresholds, type EyeRegionBounds, type EyeRegionQuality, type EyeRegionsBounds, FACE_CENTER_VERTICAL_OFFSET, FACE_CROP_OUTPUT_SIZE, FEEDBACK_MESSAGES, FRAME_BUFFER_CONFIG, FRAME_CONFIG, type FaceAlignmentResult, type FaceBoundingBox, type FaceDetectionTiers, type FaceInOvalResult, type FaceLandmarkPoint, type FaceRollResult, type FaceVisibilityResult, type FastCheckCropsRequest, type FastCheckModel, type FastCheckRequest, type FastCheckResponse, type FastCheckStreamRequest, type FastCheckStreamResponse, type FeedbackLocale, type FeedbackMessageKey, type Frame, FrameBuffer, type FrameData, type FrameQualityResult, FrameQueue, type FrameSource, GOOD_ALIGNMENT, type GazeThresholds, HIGH_ALIGNMENT, HYBRID_MODEL_CONFIGS, type HandOcclusionConfig, type HeadPose, type HealthResponse, type Hybrid150CheckRequest, type Hybrid50CheckRequest, type HybridCheckRequest, type HybridCheckResponse, type HybridFrameData, type HybridModelConfig, IDEAL_CROP_MULTIPLIER, type JobStatus, type JobStatusResponse, LANDMARK_INDEX, LANDMARK_MAX_BOUND, LANDMARK_MIN_BOUND, LOW_LIGHT_THRESHOLD, type LandmarkValidationResult, type LightingAnalysis, LivenessApiError, type LivenessCallbacks, LivenessClient, type LivenessClientConfig, type LivenessConfig, type LivenessResult, type LivenessState, MAX_CROP_MULTIPLIER, MAX_FACE_PERCENTAGE_IN_CROP, MAX_FACE_RATIO, MAX_FACE_ROLL_DEGREES, MAX_IDEAL_FACE_RATIO, MIN_CAPTURE_ALIGNMENT, MIN_CROP_MULTIPLIER, MIN_FACE_BOTTOM_MARGIN, MIN_FACE_RATIO, MIN_FACE_SIDE_MARGIN, MIN_FACE_TOP_MARGIN, MIN_IDEAL_FACE_RATIO, MIN_LANDMARK_COUNT, MODEL_CONFIGS, type ModelConfig, type ModelEntry, type ModelType, type ModelsResponse, OVAL_GUIDE_COLORS, OVAL_GUIDE_STYLES, OVAL_REGION_DESKTOP, OVAL_REGION_MOBILE, type OnErrorCallback, type OnFrameCapturedCallback, type OnProgressCallback, type OnResultCallback, type OnStateChangeCallback, type OvalGuideState, type OvalRegion, type QueueStatsResponse, RETRY_CONFIG, type RetryOptions, type StabilizationProgress, type StabilizationResult, type StabilizerConfig, type StatusMessageKey, type StreamingStatus, TARGET_FACE_PERCENTAGE_IN_CROP, type Verdict, type VerifyRequest, type VerifyResponse, type VideoFrameMetadata, analyzeBlur, analyzeEyeRegionBrightness, analyzeEyeRegionContrast, analyzeLighting, calculateAdaptiveCropMultiplier, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkEyeRegionQuality, checkFrameQuality, decodeBase64, detectFaceRoll, detectSpecularHighlights, encodeBase64, generateSessionId, getActiveModels, getApiErrorMessage, getCaptureQualityFeedback, getEyeRegionBounds, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isDeprecatedModel, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, isRetryableError, retryWithBackoff, rgbaToGrayscale, sleep, toFrameData, toHybridFrameData, toLivenessResult, toLivenessResultFromStream, validateApiKey, validateFaceLandmarks, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };

package/dist/index.d.ts

@@ -29,6 +29,7 @@ interface FastCheckRequest {
     model?: FastCheckModel;
     source?: FrameSource;
     frames: FrameData[];
+    warnings?: string[];
 }
 interface FastCheckCropsRequest {
     session_id: string;
@@ -64,6 +65,7 @@ interface FastCheckStreamRequest {
     model?: FastCheckModel;
     source?: FrameSource;
     frame: FrameData;
+    warnings?: string[];
 }
 interface FastCheckResponse {
     verdict: Verdict | null;
@@ -76,6 +78,7 @@ interface FastCheckResponse {
     frames_processed: number;
     available: boolean;
     warning: string | null;
+    warnings?: string[] | null;
     error: string | null;
 }
 interface FastCheckStreamResponse {
@@ -93,6 +96,7 @@ interface FastCheckStreamResponse {
     frames_processed: number | null;
     available: boolean;
     warning: string | null;
+    warnings?: string[] | null;
     error: string | null;
 }
 interface VerifyResponse {
@@ -157,6 +161,7 @@ interface LivenessResult {
     sessionId: string;
     processingMs: number;
     framesProcessed: number;
+    warnings?: string[];
 }
 type LivenessState = 'idle' | 'capturing' | 'uploading' | 'processing' | 'complete' | 'error';
 interface LivenessConfig {
@@ -477,22 +482,26 @@ declare class LivenessClient {
         sessionId?: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }): Promise<LivenessResult>;
     fastCheckCrops(crops: CropData[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }): Promise<LivenessResult>;
     streamFrame(frame: CapturedFrame, options: {
         sessionId: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }): Promise<FastCheckStreamResponse>;
     private sendStreamFrameInternal;
     fastCheckStream(frames: CapturedFrame[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }, callbacks?: {
         onFrameSent?: (index: number, total: number) => void;
         onFrameBuffered?: (framesReceived: number, framesRequired: number) => void;
@@ -501,6 +510,7 @@ declare class LivenessClient {
         sessionId?: string;
         model?: FastCheckModel;
         source?: FrameSource;
+        warnings?: string[];
     }, callbacks?: {
         onFrameSent?: (index: number, total: number) => void;
         onFrameBuffered?: (framesReceived: number, framesRequired: number) => void;
@@ -771,13 +781,13 @@ interface EyeQualityThresholds {
     minBrightness: number;
     maxBrightness: number;
     minContrast: number;
-    glarePixelThreshold: number;
+    glareRelativeFactor: number;
     maxGlareRatio: number;
 }
 declare const EYE_QUALITY_THRESHOLDS: EyeQualityThresholds;
 declare function analyzeEyeRegionBrightness(pixels: Uint8Array | Uint8ClampedArray): number;
 declare function analyzeEyeRegionContrast(pixels: Uint8Array | Uint8ClampedArray, meanBrightness?: number): number;
-declare function detectSpecularHighlights(pixels: Uint8Array | Uint8ClampedArray, threshold?: number): number;
+declare function detectSpecularHighlights(pixels: Uint8Array | Uint8ClampedArray, relativeFactor?: number, meanBrightness?: number): number;
 declare function checkEyeRegionQuality(pixels: Uint8Array | Uint8ClampedArray, thresholds?: EyeQualityThresholds): EyeRegionQuality;
 
 export { ALIGNMENT_THRESHOLD_CAPTURE, ALIGNMENT_THRESHOLD_GOOD, ALIGNMENT_THRESHOLD_PERFECT, ALIGNMENT_THRESHOLD_POOR, API_ENDPOINTS, API_ERROR_CODES, API_PATHS, AUTH_CONFIG, type ApiErrorCode, BACKLIT_RATIO_THRESHOLD, BLUR_THRESHOLD_MOBILE, BaseFrameCollector, type BlurAnalysis, type CaptureQualityState, type CapturedFrame, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_ENDPOINT, DEFAULT_FACE_DETECTION_TIERS, DEFAULT_GAZE_THRESHOLDS, DEFAULT_HAND_OCCLUSION_CONFIG, DEFAULT_LIVENESS_CONFIG, DEFAULT_LOCALE, DEFAULT_OVAL_REGION, DEFAULT_STABILIZER_CONFIG, DEFAULT_STATUS_MESSAGES, type DetectionResult, type DetectionSummary, type DetectorConfig, ERROR_MESSAGES, ERROR_MESSAGES_ES, ES_LOCALE, EYE_LANDMARK_INDICES, EYE_QUALITY_THRESHOLDS, type ErrorResponse, type EyeQualityThresholds, type EyeRegionBounds, type EyeRegionQuality, type EyeRegionsBounds, FACE_CENTER_VERTICAL_OFFSET, FACE_CROP_OUTPUT_SIZE, FEEDBACK_MESSAGES, FRAME_BUFFER_CONFIG, FRAME_CONFIG, type FaceAlignmentResult, type FaceBoundingBox, type FaceDetectionTiers, type FaceInOvalResult, type FaceLandmarkPoint, type FaceRollResult, type FaceVisibilityResult, type FastCheckCropsRequest, type FastCheckModel, type FastCheckRequest, type FastCheckResponse, type FastCheckStreamRequest, type FastCheckStreamResponse, type FeedbackLocale, type FeedbackMessageKey, type Frame, FrameBuffer, type FrameData, type FrameQualityResult, FrameQueue, type FrameSource, GOOD_ALIGNMENT, type GazeThresholds, HIGH_ALIGNMENT, HYBRID_MODEL_CONFIGS, type HandOcclusionConfig, type HeadPose, type HealthResponse, type Hybrid150CheckRequest, type Hybrid50CheckRequest, type HybridCheckRequest, type HybridCheckResponse, type HybridFrameData, type HybridModelConfig, IDEAL_CROP_MULTIPLIER, type JobStatus, type JobStatusResponse, LANDMARK_INDEX, LANDMARK_MAX_BOUND, LANDMARK_MIN_BOUND, LOW_LIGHT_THRESHOLD, type LandmarkValidationResult, type LightingAnalysis, LivenessApiError, type LivenessCallbacks, LivenessClient, type LivenessClientConfig, type LivenessConfig, type LivenessResult, type LivenessState, MAX_CROP_MULTIPLIER, MAX_FACE_PERCENTAGE_IN_CROP, MAX_FACE_RATIO, MAX_FACE_ROLL_DEGREES, MAX_IDEAL_FACE_RATIO, MIN_CAPTURE_ALIGNMENT, MIN_CROP_MULTIPLIER, MIN_FACE_BOTTOM_MARGIN, MIN_FACE_RATIO, MIN_FACE_SIDE_MARGIN, MIN_FACE_TOP_MARGIN, MIN_IDEAL_FACE_RATIO, MIN_LANDMARK_COUNT, MODEL_CONFIGS, type ModelConfig, type ModelEntry, type ModelType, type ModelsResponse, OVAL_GUIDE_COLORS, OVAL_GUIDE_STYLES, OVAL_REGION_DESKTOP, OVAL_REGION_MOBILE, type OnErrorCallback, type OnFrameCapturedCallback, type OnProgressCallback, type OnResultCallback, type OnStateChangeCallback, type OvalGuideState, type OvalRegion, type QueueStatsResponse, RETRY_CONFIG, type RetryOptions, type StabilizationProgress, type StabilizationResult, type StabilizerConfig, type StatusMessageKey, type StreamingStatus, TARGET_FACE_PERCENTAGE_IN_CROP, type Verdict, type VerifyRequest, type VerifyResponse, type VideoFrameMetadata, analyzeBlur, analyzeEyeRegionBrightness, analyzeEyeRegionContrast, analyzeLighting, calculateAdaptiveCropMultiplier, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkEyeRegionQuality, checkFrameQuality, decodeBase64, detectFaceRoll, detectSpecularHighlights, encodeBase64, generateSessionId, getActiveModels, getApiErrorMessage, getCaptureQualityFeedback, getEyeRegionBounds, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isDeprecatedModel, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, isRetryableError, retryWithBackoff, rgbaToGrayscale, sleep, toFrameData, toHybridFrameData, toLivenessResult, toLivenessResultFromStream, validateApiKey, validateFaceLandmarks, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };

package/dist/index.js

@@ -261,7 +261,8 @@ function toLivenessResult(response) {
     score: response.score ?? 0,
     sessionId: response.session_id,
     processingMs: response.processing_ms,
-    framesProcessed: "frames_processed" in response ? response.frames_processed ?? 0 : 0
+    framesProcessed: "frames_processed" in response ? response.frames_processed ?? 0 : 0,
+    warnings: "warnings" in response && Array.isArray(response.warnings) ? response.warnings : void 0
   };
 }
 function toLivenessResultFromStream(response) {
@@ -278,7 +279,8 @@ function toLivenessResultFromStream(response) {
     score: response.score ?? 0,
     sessionId: response.session_id,
     processingMs: response.processing_ms ?? 0,
-    framesProcessed: response.frames_processed ?? 0
+    framesProcessed: response.frames_processed ?? 0,
+    warnings: Array.isArray(response.warnings) ? response.warnings : void 0
   };
 }
 function generateSessionId() {
@@ -457,7 +459,8 @@ var LivenessClient = class _LivenessClient {
       session_id: options.sessionId ?? generateSessionId(),
       model: options.model ?? "10",
       source: options.source ?? "live",
-      frames: toFrameData(frames)
+      frames: toFrameData(frames),
+      ...options.warnings?.length ? { warnings: options.warnings } : {}
     };
     const response = await this.requestWithRetry(API_PATHS.fastCheck, {
       method: "POST",
@@ -477,7 +480,8 @@ var LivenessClient = class _LivenessClient {
       session_id: options.sessionId ?? generateSessionId(),
       model: options.model ?? "10",
       source: options.source ?? "live",
-      crops
+      crops,
+      ...options.warnings?.length ? { warnings: options.warnings } : {}
     };
     const response = await this.requestWithRetry(API_PATHS.fastCheckCrops, {
       method: "POST",
@@ -511,7 +515,8 @@ var LivenessClient = class _LivenessClient {
     return this.sendStreamFrameInternal(frameData, {
       sessionId: options.sessionId,
       model: options.model ?? "10",
-      source: options.source ?? "live"
+      source: options.source ?? "live",
+      warnings: options.warnings
     });
   }
   /**
@@ -526,7 +531,8 @@ var LivenessClient = class _LivenessClient {
       session_id: options.sessionId,
       model: options.model,
       source: options.source,
-      frame: frameData
+      frame: frameData,
+      ...options.warnings?.length ? { warnings: options.warnings } : {}
     };
     return this.requestWithRetry(API_PATHS.fastCheckStream, {
       method: "POST",
@@ -555,7 +561,8 @@ var LivenessClient = class _LivenessClient {
       const response = await this.sendStreamFrameInternal(frameData, {
         sessionId,
         model,
-        source
+        source,
+        warnings: options.warnings
       });
       callbacks?.onFrameSent?.(index + 1, total);
       if (response.status === "buffering") {
@@ -604,7 +611,8 @@ var LivenessClient = class _LivenessClient {
       const response = await this.sendStreamFrameInternal(frameData, {
         sessionId,
         model,
-        source
+        source,
+        warnings: options.warnings
       });
       const currentIndex = frameData.index;
       callbacks?.onFrameSent?.(currentIndex + 1, total);
@@ -1880,7 +1888,7 @@ var EYE_QUALITY_THRESHOLDS = {
   minBrightness: 40,
   maxBrightness: 230,
   minContrast: 12,
-  glarePixelThreshold: 240,
+  glareRelativeFactor: 2.5,
   maxGlareRatio: 0.15
 };
 function rgbaToLuminance(r, g, b) {
@@ -1907,9 +1915,11 @@ function analyzeEyeRegionContrast(pixels, meanBrightness) {
   }
   return Math.sqrt(sumSqDiff / pixelCount);
 }
-function detectSpecularHighlights(pixels, threshold = EYE_QUALITY_THRESHOLDS.glarePixelThreshold) {
+function detectSpecularHighlights(pixels, relativeFactor = EYE_QUALITY_THRESHOLDS.glareRelativeFactor, meanBrightness) {
   const pixelCount = pixels.length / 4;
   if (pixelCount === 0) return 0;
+  const mean = meanBrightness ?? analyzeEyeRegionBrightness(pixels);
+  const threshold = mean * relativeFactor;
   let glareCount = 0;
   for (let i = 0; i < pixels.length; i += 4) {
     const lum = rgbaToLuminance(pixels[i], pixels[i + 1], pixels[i + 2]);
@@ -1932,7 +1942,7 @@ function checkEyeRegionQuality(pixels, thresholds = EYE_QUALITY_THRESHOLDS) {
   }
   const brightness = analyzeEyeRegionBrightness(pixels);
   const contrast = analyzeEyeRegionContrast(pixels, brightness);
-  const glareRatio = detectSpecularHighlights(pixels, thresholds.glarePixelThreshold);
+  const glareRatio = detectSpecularHighlights(pixels, thresholds.glareRelativeFactor, brightness);
   const hasGlare = glareRatio > thresholds.maxGlareRatio;
   if (brightness < thresholds.minBrightness) {
     return {
@@ -1954,16 +1964,6 @@ function checkEyeRegionQuality(pixels, thresholds = EYE_QUALITY_THRESHOLDS) {
       message: "Eye region overexposed - reduce lighting"
     };
   }
-  if (hasGlare) {
-    return {
-      passed: false,
-      brightness,
-      contrast,
-      hasGlare,
-      glareRatio,
-      message: "Glare detected - adjust angle or remove glasses"
-    };
-  }
   if (contrast < thresholds.minContrast) {
     return {
       passed: false,

package/dist/index.mjs

@@ -128,7 +128,8 @@ function toLivenessResult(response) {
     score: response.score ?? 0,
     sessionId: response.session_id,
     processingMs: response.processing_ms,
-    framesProcessed: "frames_processed" in response ? response.frames_processed ?? 0 : 0
+    framesProcessed: "frames_processed" in response ? response.frames_processed ?? 0 : 0,
+    warnings: "warnings" in response && Array.isArray(response.warnings) ? response.warnings : void 0
   };
 }
 function toLivenessResultFromStream(response) {
@@ -145,7 +146,8 @@ function toLivenessResultFromStream(response) {
     score: response.score ?? 0,
     sessionId: response.session_id,
     processingMs: response.processing_ms ?? 0,
-    framesProcessed: response.frames_processed ?? 0
+    framesProcessed: response.frames_processed ?? 0,
+    warnings: Array.isArray(response.warnings) ? response.warnings : void 0
   };
 }
 function generateSessionId() {
@@ -324,7 +326,8 @@ var LivenessClient = class _LivenessClient {
       session_id: options.sessionId ?? generateSessionId(),
       model: options.model ?? "10",
       source: options.source ?? "live",
-      frames: toFrameData(frames)
+      frames: toFrameData(frames),
+      ...options.warnings?.length ? { warnings: options.warnings } : {}
     };
     const response = await this.requestWithRetry(API_PATHS.fastCheck, {
       method: "POST",
@@ -344,7 +347,8 @@ var LivenessClient = class _LivenessClient {
       session_id: options.sessionId ?? generateSessionId(),
       model: options.model ?? "10",
       source: options.source ?? "live",
-      crops
+      crops,
+      ...options.warnings?.length ? { warnings: options.warnings } : {}
     };
     const response = await this.requestWithRetry(API_PATHS.fastCheckCrops, {
       method: "POST",
@@ -378,7 +382,8 @@ var LivenessClient = class _LivenessClient {
     return this.sendStreamFrameInternal(frameData, {
       sessionId: options.sessionId,
       model: options.model ?? "10",
-      source: options.source ?? "live"
+      source: options.source ?? "live",
+      warnings: options.warnings
     });
   }
   /**
@@ -393,7 +398,8 @@ var LivenessClient = class _LivenessClient {
       session_id: options.sessionId,
       model: options.model,
       source: options.source,
-      frame: frameData
+      frame: frameData,
+      ...options.warnings?.length ? { warnings: options.warnings } : {}
     };
     return this.requestWithRetry(API_PATHS.fastCheckStream, {
       method: "POST",
@@ -422,7 +428,8 @@ var LivenessClient = class _LivenessClient {
       const response = await this.sendStreamFrameInternal(frameData, {
         sessionId,
         model,
-        source
+        source,
+        warnings: options.warnings
       });
       callbacks?.onFrameSent?.(index + 1, total);
       if (response.status === "buffering") {
@@ -471,7 +478,8 @@ var LivenessClient = class _LivenessClient {
       const response = await this.sendStreamFrameInternal(frameData, {
         sessionId,
         model,
-        source
+        source,
+        warnings: options.warnings
       });
       const currentIndex = frameData.index;
       callbacks?.onFrameSent?.(currentIndex + 1, total);
@@ -1747,7 +1755,7 @@ var EYE_QUALITY_THRESHOLDS = {
   minBrightness: 40,
   maxBrightness: 230,
   minContrast: 12,
-  glarePixelThreshold: 240,
+  glareRelativeFactor: 2.5,
   maxGlareRatio: 0.15
 };
 function rgbaToLuminance(r, g, b) {
@@ -1774,9 +1782,11 @@ function analyzeEyeRegionContrast(pixels, meanBrightness) {
   }
   return Math.sqrt(sumSqDiff / pixelCount);
 }
-function detectSpecularHighlights(pixels, threshold = EYE_QUALITY_THRESHOLDS.glarePixelThreshold) {
+function detectSpecularHighlights(pixels, relativeFactor = EYE_QUALITY_THRESHOLDS.glareRelativeFactor, meanBrightness) {
   const pixelCount = pixels.length / 4;
   if (pixelCount === 0) return 0;
+  const mean = meanBrightness ?? analyzeEyeRegionBrightness(pixels);
+  const threshold = mean * relativeFactor;
   let glareCount = 0;
   for (let i = 0; i < pixels.length; i += 4) {
     const lum = rgbaToLuminance(pixels[i], pixels[i + 1], pixels[i + 2]);
@@ -1799,7 +1809,7 @@ function checkEyeRegionQuality(pixels, thresholds = EYE_QUALITY_THRESHOLDS) {
   }
   const brightness = analyzeEyeRegionBrightness(pixels);
   const contrast = analyzeEyeRegionContrast(pixels, brightness);
-  const glareRatio = detectSpecularHighlights(pixels, thresholds.glarePixelThreshold);
+  const glareRatio = detectSpecularHighlights(pixels, thresholds.glareRelativeFactor, brightness);
   const hasGlare = glareRatio > thresholds.maxGlareRatio;
   if (brightness < thresholds.minBrightness) {
     return {
@@ -1821,16 +1831,6 @@ function checkEyeRegionQuality(pixels, thresholds = EYE_QUALITY_THRESHOLDS) {
       message: "Eye region overexposed - reduce lighting"
     };
   }
-  if (hasGlare) {
-    return {
-      passed: false,
-      brightness,
-      contrast,
-      hasGlare,
-      glareRatio,
-      message: "Glare detected - adjust angle or remove glasses"
-    };
-  }
   if (contrast < thresholds.minContrast) {
     return {
       passed: false,

package/package.json

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