@moveris/shared 2.7.0 → 3.0.0

package/README.md

@@ -47,13 +47,14 @@ The main client for interacting with the Moveris Liveness API.
 const client = new LivenessClient(config: LivenessClientConfig);
 ```
 
-| Option        | Type           | Default                     | Description                                     |
-| ------------- | -------------- | --------------------------- | ----------------------------------------------- |
-| `apiKey`      | `string`       | **required**                | Your Moveris API key                            |
-| `baseUrl`     | `string`       | `'https://api.moveris.com'` | API base URL                                    |
-| `timeout`     | `number`       | `30000`                     | Request timeout in milliseconds                 |
-| `enableRetry` | `boolean`      | `true`                      | Enable automatic retry with exponential backoff |
-| `customFetch` | `typeof fetch` | `fetch`                     | Custom fetch implementation (for React Native)  |
+| Option         | Type           | Default                     | Description                                                        |
+| -------------- | -------------- | --------------------------- | ------------------------------------------------------------------ |
+| `apiKey`       | `string`       | **required**                | Your Moveris API key                                               |
+| `baseUrl`      | `string`       | `'https://api.moveris.com'` | API base URL                                                       |
+| `modelVersion` | `ModelVersion` | -                           | Model version alias for `X-Model-Version` header (e.g. `'latest'`) |
+| `timeout`      | `number`       | `30000`                     | Request timeout in milliseconds                                    |
+| `enableRetry`  | `boolean`      | `true`                      | Enable automatic retry with exponential backoff                    |
+| `customFetch`  | `typeof fetch` | `fetch`                     | Custom fetch implementation (for React Native)                     |
 
 #### Methods
 
@@ -71,11 +72,13 @@ const result = await client.fastCheck(frames, {
 
 **Parameters:**
 
-| 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) |
+| Option         | Type             | Default         | Description                                                       |
+| -------------- | ---------------- | --------------- | ----------------------------------------------------------------- |
+| `sessionId`    | `string`         | auto-generated  | Unique session identifier (UUID)                                  |
+| `model`        | `FastCheckModel` | `'mixed-10-v2'` | Model to use (see Models section)                                 |
+| `modelVersion` | `ModelVersion`   | -               | Version alias sent via `X-Model-Version` header (e.g. `'latest'`) |
+| `frameCount`   | `number`         | -               | Frame count for alias-based model resolution                      |
+| `source`       | `FrameSource`    | `'live'`        | Frame source: `'live'` (camera) or `'media'` (recorded video)     |
 
 **Returns:** `Promise<LivenessResult>`
 
@@ -94,6 +97,7 @@ const crops: CropData[] = capturedFrames.map((f) => ({
 const result = await client.fastCheckCrops(crops, {
   model: '10',
   source: 'live',
+  bgSegmentation: true, // optional — sent as bg_segmentation in payload
 });
 ```
 
@@ -207,11 +211,36 @@ Active models (recommended):
 
 Legacy models (still supported):
 
-| Value   | Frames | Description                 |
-| ------- | ------ | --------------------------- |
-| `'10'`  | 10     | Standard — fast             |
-| `'50'`  | 50     | Standard — balanced         |
-| `'250'` | 250    | Standard — highest accuracy |
+| Value   | Frames | Description                                      |
+| ------- | ------ | ------------------------------------------------ |
+| `'10'`  | 10     | Standard — fast (alias: `'fast'`)                |
+| `'50'`  | 50     | Standard — balanced (alias: `'spatial'`)         |
+| `'250'` | 250    | Standard — highest accuracy (alias: `'spatial'`) |
+
+Hybrid-v2 models (alias: `'hybrid'`):
+
+| Value             | Frames | Description                  |
+| ----------------- | ------ | ---------------------------- |
+| `'hybrid-v2-10'`  | 10     | Hybrid v2 — fast             |
+| `'hybrid-v2-30'`  | 30     | Hybrid v2 — balanced         |
+| `'hybrid-v2-60'`  | 60     | Hybrid v2 — higher accuracy  |
+| `'hybrid-v2-90'`  | 90     | Hybrid v2 — high accuracy    |
+| `'hybrid-v2-100'` | 100    | Hybrid v2 — high accuracy    |
+| `'hybrid-v2-120'` | 120    | Hybrid v2 — highest accuracy |
+| `'hybrid-v2-125'` | 125    | Hybrid v2 — highest accuracy |
+| `'hybrid-v2-250'` | 250    | Hybrid v2 — maximum accuracy |
+
+Deprecated models (v1 — sunset 2026-09-01):
+
+| Value         | Frames | Replacement      |
+| ------------- | ------ | ---------------- |
+| `'mixed-10'`  | 10     | `'mixed-10-v2'`  |
+| `'mixed-30'`  | 30     | `'mixed-30-v2'`  |
+| `'mixed-60'`  | 60     | `'mixed-60-v2'`  |
+| `'mixed-90'`  | 90     | `'mixed-90-v2'`  |
+| `'mixed-120'` | 120    | `'mixed-120-v2'` |
+| `'mixed-150'` | 150    | —                |
+| `'mixed-250'` | 250    | —                |
 
 #### FrameSource
 
@@ -265,6 +294,7 @@ interface LivenessResult {
   sessionId: string; // Session identifier
   processingMs: number; // Server processing time
   framesProcessed: number; // Number of frames analyzed
+  deprecation?: DeprecationInfo; // Present when X-Moveris-Model-Resolved header is returned
 }
 ```
 
@@ -291,6 +321,80 @@ interface CropData {
 }
 ```
 
+#### ModelVersion
+
+Version alias sent via the `X-Model-Version` request header for server-side model resolution.
+
+```typescript
+type ModelVersion = 'latest' | 'v2' | 'v1' | 'fast' | 'spatial' | 'hybrid' | (string & object);
+```
+
+| Value       | Resolves to                         |
+| ----------- | ----------------------------------- |
+| `'latest'`  | Current production mixed-v2 model   |
+| `'v2'`      | Pinned mixed-v2 version             |
+| `'v1'`      | Legacy mixed-v1 models (deprecated) |
+| `'fast'`    | Model `'10'`                        |
+| `'spatial'` | Models `'50'` / `'250'`             |
+| `'hybrid'`  | Hybrid-v2 models                    |
+
+> When `X-Model-Version` is set, the API also requires `frame_count` in the request body. Pass it via the `frameCount` option.
+
+#### DeprecationInfo
+
+Parsed from API response headers when the server resolves a model.
+
+```typescript
+interface DeprecationInfo {
+  deprecated: boolean; // true when model is deprecated
+  resolvedModel: string; // Concrete model id (X-Moveris-Model-Resolved)
+  deprecatedModel?: string; // Deprecated model id (X-Moveris-Deprecated-Model)
+  sunsetDate?: string; // ISO date of removal (Sunset header)
+  suggestedModel?: string; // Replacement model (X-Moveris-Suggested-Model)
+}
+```
+
+---
+
+### Model Versioning & Deprecation
+
+The client supports model alias resolution via the `X-Model-Version` header and automatically parses deprecation headers from API responses.
+
+```typescript
+// Use aliases for automatic server-side resolution
+const client = new LivenessClient({
+  apiKey: 'mv_your_api_key',
+  modelVersion: 'latest', // sent as X-Model-Version header on every request
+});
+
+const result = await client.fastCheck(frames, {
+  model: 'mixed-30-v2',
+  frameCount: 30, // required when modelVersion is set
+});
+
+// Deprecation info is automatically parsed from response headers
+if (result.deprecation?.deprecated) {
+  console.warn(`Model "${result.deprecation.resolvedModel}" is deprecated.`);
+  console.warn(`Migrate to "${result.deprecation.suggestedModel}".`);
+  console.warn(`Sunset date: ${result.deprecation.sunsetDate}`);
+}
+
+// Per-call override (takes precedence over client-level modelVersion)
+const result2 = await client.fastCheck(frames, {
+  modelVersion: 'v2',
+  frameCount: 10,
+});
+```
+
+#### Valid Frame Counts
+
+When using model version aliases, `frameCount` must be one of:
+
+```typescript
+import { VALID_FRAME_COUNTS } from '@moveris/shared';
+// [10, 30, 60, 90, 120]
+```
+
 ---
 
 ### Utilities
@@ -443,6 +547,9 @@ const status = getStatusMessage('capturing', DEFAULT_LOCALE);
 | `eyes_overexposed`  | "Eye region overexposed…"      | Eye region too bright        |
 | `glasses_glare`     | "Glare detected…"              | Specular highlights on eyes  |
 | `eye_quality_poor`  | "Eye region quality is poor"   | Generic eye quality failure  |
+| `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"            | Eye line deviates > 15°      |
 
 ---
 
@@ -529,7 +636,13 @@ if (bounds) {
 Utilities for assessing frame quality before submission.
 
 ```typescript
-import { isFaceFullyVisible, isFaceInOval, calculateFaceCropRegion } from '@moveris/shared';
+import {
+  isFaceFullyVisible,
+  isFaceInOval,
+  calculateFaceCropRegion,
+  detectFaceRoll,
+  detectCameraAngle,
+} from '@moveris/shared';
 
 // Check if face is fully visible in frame
 const visibility = isFaceFullyVisible(faceBbox, frameWidth, frameHeight);
@@ -547,8 +660,17 @@ const cropRegion = calculateFaceCropRegion(faceBbox, frameWidth, frameHeight);
 
 // Calculate adaptive crop multiplier based on face size
 import { calculateAdaptiveCropMultiplier } from '@moveris/shared';
-const multiplier = calculateAdaptiveCropMultiplier(faceSize, videoSize);
-// Returns 1.8–2.5x (matched to cognito-check for ~50% face coverage)
+const multiplier = calculateAdaptiveCropMultiplier(faceBox, frameWidth, frameHeight);
+// Returns 2.5–4.0x (matched to cognito-check for ~33% face coverage in 224×224 crop)
+
+// Detect face roll (device tilt) from eye-corner landmarks
+const rollResult = detectFaceRoll(landmarks); // requires ≥364 landmarks
+// { roll: number (degrees), tooTilted: boolean }
+
+// Detect camera vertical angle from forehead/nose/chin landmark ratio
+const angleResult = detectCameraAngle(landmarks); // requires ≥153 landmarks
+// { ratio: number, cameraAbove: boolean, cameraBelow: boolean }
+// ratio ~1.0 at eye level; >1.35 = camera above user; <0.75 = camera below user
 ```
 
 #### Crop Constants (aligned with cognito-check)
@@ -565,6 +687,30 @@ These constants control how face crops are generated for the `fast-check-crops`
 
 ---
 
+### Model Configuration
+
+```typescript
+import { MODEL_CONFIGS, isDeprecatedModel, getActiveModels } from '@moveris/shared';
+
+// Access model metadata
+const config = MODEL_CONFIGS['mixed-10-v2'];
+console.log(config.minFrames); // 10
+console.log(config.deprecated); // false
+console.log(config.aliases); // ['v2', 'latest']
+
+// Check if a model is deprecated
+if (isDeprecatedModel('mixed-10')) {
+  const mc = MODEL_CONFIGS['mixed-10'];
+  console.log(`Deprecated! Sunset: ${mc.sunsetDate}, replace with ${mc.replacement}`);
+}
+
+// Get only active (non-deprecated) models
+const active = getActiveModels();
+// ['mixed-10-v2', 'mixed-30-v2', ..., '10', '50', '250', 'hybrid-v2-10', ...]
+```
+
+---
+
 ## Configuration Constants
 
 ```typescript
@@ -588,6 +734,9 @@ import type {
   LivenessState,
   LivenessConfig,
   FastCheckModel,
+  ModelVersion,
+  DeprecationInfo,
+  ModelConfig,
   FrameSource,
   Verdict,
   CapturedFrame,

package/dist/index.d.mts

@@ -5,9 +5,18 @@ interface ModelEntry {
     description: string;
     min_frames: number;
     deprecated: boolean;
+    aliases?: string[];
 }
 type ModelsResponse = ModelEntry[];
 type FastCheckModel = '10' | '50' | '250' | 'hybrid-v2-10' | 'hybrid-v2-30' | 'hybrid-v2-50' | 'hybrid-v2-60' | 'hybrid-v2-90' | 'hybrid-v2-100' | 'hybrid-v2-125' | 'hybrid-v2-150' | 'hybrid-v2-250' | 'mixed-10' | 'mixed-30' | 'mixed-60' | 'mixed-90' | 'mixed-120' | 'mixed-150' | 'mixed-250' | 'mixed-10-v2' | 'mixed-30-v2' | 'mixed-60-v2' | 'mixed-90-v2' | 'mixed-120-v2' | (string & object);
+type ModelVersion = 'latest' | 'v2' | 'v1' | 'fast' | 'spatial' | 'hybrid' | (string & object);
+interface DeprecationInfo {
+    deprecated: boolean;
+    resolvedModel: string;
+    deprecatedModel?: string;
+    sunsetDate?: string;
+    suggestedModel?: string;
+}
 type StreamingStatus = 'buffering' | 'complete';
 type FrameSource = 'media' | 'live';
 type JobStatus = 'queued' | 'processing' | 'complete' | 'failed';
@@ -29,6 +38,7 @@ interface FastCheckRequest {
     model?: FastCheckModel;
     source?: FrameSource;
     frames: FrameData[];
+    frame_count?: number;
     warnings?: string[];
 }
 interface FastCheckCropsRequest {
@@ -36,6 +46,7 @@ interface FastCheckCropsRequest {
     model?: FastCheckModel;
     source?: FrameSource;
     crops: CropData[];
+    frame_count?: number;
 }
 interface VerifyRequest {
     session_id: string;
@@ -65,6 +76,7 @@ interface FastCheckStreamRequest {
     model?: FastCheckModel;
     source?: FrameSource;
     frame: FrameData;
+    frame_count?: number;
     warnings?: string[];
 }
 interface FastCheckResponse {
@@ -162,12 +174,14 @@ interface LivenessResult {
     processingMs: number;
     framesProcessed: number;
     warnings?: string[];
+    deprecation?: DeprecationInfo;
 }
 type LivenessState = 'idle' | 'capturing' | 'uploading' | 'processing' | 'complete' | 'error';
 interface LivenessConfig {
     baseUrl: string;
     apiKey: string;
     model?: FastCheckModel;
+    modelVersion?: ModelVersion;
     source?: FrameSource;
     fps?: number;
     frameCount?: number;
@@ -180,12 +194,16 @@ interface CapturedFrame {
 }
 
 type ModelType = FastCheckModel;
+declare const VALID_FRAME_COUNTS: readonly [10, 30, 60, 90, 120];
 interface ModelConfig {
     type: FastCheckModel;
     minFrames: number;
     recommendedFrames: number;
     description: string;
     deprecated: boolean;
+    aliases?: string[];
+    sunsetDate?: string;
+    replacement?: string;
 }
 declare const MODEL_CONFIGS: Record<FastCheckModel, ModelConfig>;
 interface HybridModelConfig {
@@ -301,7 +319,7 @@ interface FrameQualityResult {
     alignment?: FaceAlignmentResult;
     rejectionReason?: 'blur' | 'backlit' | 'low_light' | 'partial_face' | 'no_face' | 'too_close' | 'too_far' | 'misaligned';
 }
-declare const DEFAULT_BLUR_THRESHOLD = 100;
+declare const DEFAULT_BLUR_THRESHOLD = 110;
 declare const BLUR_THRESHOLD_MOBILE = 60;
 declare const BACKLIT_RATIO_THRESHOLD = 0.6;
 declare const LOW_LIGHT_THRESHOLD = 50;
@@ -353,6 +371,14 @@ interface FaceRollResult {
 }
 declare const MAX_FACE_ROLL_DEGREES = 15;
 declare function detectFaceRoll(landmarks: FaceLandmarkPoint[]): FaceRollResult;
+interface CameraAngleResult {
+    ratio: number;
+    cameraAbove: boolean;
+    cameraBelow: boolean;
+}
+declare const CAMERA_ANGLE_HIGH_RATIO = 1.35;
+declare const CAMERA_ANGLE_LOW_RATIO = 0.75;
+declare function detectCameraAngle(landmarks: FaceLandmarkPoint[]): CameraAngleResult;
 declare class BaseFrameCollector {
     protected frames: CapturedFrame[];
     protected maxFrames: number;
@@ -446,6 +472,7 @@ declare const DEFAULT_STABILIZER_CONFIG: StabilizerConfig;
 interface LivenessClientConfig {
     baseUrl?: string;
     apiKey: string;
+    modelVersion?: ModelVersion;
     timeout?: number;
     enableRetry?: boolean;
     customFetch?: typeof fetch;
@@ -465,34 +492,46 @@ declare function generateSessionId(): string;
 declare class LivenessClient {
     private readonly baseUrl;
     private readonly apiKey;
+    private readonly modelVersion;
     private readonly timeout;
     private readonly enableRetry;
     private readonly fetchFn;
     constructor(config: LivenessClientConfig);
     private request;
+    private requestRaw;
     private parseErrorResponse;
     private static unwrapErrorCode;
     private static unwrapErrorMessage;
     private static extractCodeFromText;
+    private static parseDeprecationHeaders;
+    private buildModelVersionHeaders;
     private requestWithRetry;
+    private requestWithRetryRaw;
     health(): Promise<HealthResponse>;
     getModels(): Promise<ModelEntry[]>;
     queueStats(): Promise<QueueStatsResponse>;
     fastCheck(frames: CapturedFrame[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        frameCount?: number;
         source?: FrameSource;
         warnings?: string[];
     }): Promise<LivenessResult>;
     fastCheckCrops(crops: CropData[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        frameCount?: number;
         source?: FrameSource;
         warnings?: string[];
+        bgSegmentation?: boolean;
     }): Promise<LivenessResult>;
     streamFrame(frame: CapturedFrame, options: {
         sessionId: string;
         model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        frameCount?: number;
         source?: FrameSource;
         warnings?: string[];
     }): Promise<FastCheckStreamResponse>;
@@ -500,6 +539,8 @@ declare class LivenessClient {
     fastCheckStream(frames: CapturedFrame[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        frameCount?: number;
         source?: FrameSource;
         warnings?: string[];
     }, callbacks?: {
@@ -509,6 +550,8 @@ declare class LivenessClient {
     fastCheckStreamSequential(frames: CapturedFrame[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        frameCount?: number;
         source?: FrameSource;
         warnings?: string[];
     }, callbacks?: {
@@ -602,6 +645,7 @@ declare const FRAME_BUFFER_CONFIG: {
 declare const AUTH_CONFIG: {
     readonly timeout: 30000;
     readonly apiKeyHeader: "X-API-Key";
+    readonly modelVersionHeader: "X-Model-Version";
 };
 declare const FRAME_CONFIG: {
     readonly targetFPS: 30;
@@ -704,8 +748,9 @@ declare const FEEDBACK_MESSAGES: {
     readonly poor_lighting: "Improve lighting";
     readonly too_dark: "Low lighting - move to a brighter area";
     readonly backlit: "Backlit - try facing the light source";
-    readonly phone_angle_low: "Raise your phone to eye level";
-    readonly phone_tilted: "Hold your phone level";
+    readonly camera_angle_low: "Raise camera to eye level";
+    readonly camera_angle_high: "Lower camera to eye level";
+    readonly camera_tilted: "Hold camera level";
     readonly hand_detected: "Remove hand from face";
     readonly eyes_not_visible: "Eyes not clearly visible";
     readonly eyes_shadowed: "Eyes are in shadow - improve lighting";
@@ -738,8 +783,9 @@ interface CaptureQualityState {
     targetFrames: number;
     tooFarFromIdeal?: boolean;
     tooCloseToIdeal?: boolean;
-    phoneAngled?: boolean;
-    phoneTilted?: boolean;
+    cameraAngleLow?: boolean;
+    cameraAngleHigh?: boolean;
+    cameraTilted?: boolean;
 }
 declare function getCaptureQualityFeedback(state: CaptureQualityState): string;
 declare function canCaptureFrame(state: Omit<CaptureQualityState, 'framesCaptured' | 'targetFrames' | 'isCapturing'>): boolean;
@@ -790,4 +836,4 @@ declare function analyzeEyeRegionContrast(pixels: Uint8Array | Uint8ClampedArray
 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 };
+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, CAMERA_ANGLE_HIGH_RATIO, CAMERA_ANGLE_LOW_RATIO, type CameraAngleResult, 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 DeprecationInfo, 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 ModelVersion, 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, VALID_FRAME_COUNTS, type Verdict, type VerifyRequest, type VerifyResponse, type VideoFrameMetadata, analyzeBlur, analyzeEyeRegionBrightness, analyzeEyeRegionContrast, analyzeLighting, calculateAdaptiveCropMultiplier, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkEyeRegionQuality, checkFrameQuality, decodeBase64, detectCameraAngle, 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 };