@moveris/shared 3.12.0 → 3.15.0

package/dist/index.d.mts

@@ -59,6 +59,13 @@ interface FrameData {
     timestamp_ms: number;
     pixels: string;
 }
+interface LiveCheckFrameData extends FrameData {
+    landmarks: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | null;
+}
 interface CropData {
     index: number;
     pixels: string;
@@ -79,6 +86,55 @@ interface FastCheckRequest {
         consumer?: ConsumerContext;
     } | null;
 }
+interface LiveCheckRequest {
+    session_id: string;
+    model?: FastCheckModel;
+    source?: FrameSource;
+    frames: LiveCheckFrameData[];
+    frame_count?: number;
+    warnings?: string[];
+    device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
+}
+interface V2UploadFrameData extends FrameData {
+    landmarks?: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | null;
+}
+interface V2UploadRequest {
+    session_id: string;
+    model?: FastCheckModel;
+    source?: FrameSource;
+    fps?: number;
+    frames: V2UploadFrameData[];
+    frame_count?: number;
+    warnings?: string[];
+}
+interface V2UploadResponse {
+    session_id: string;
+    frames_received: number;
+    frames_required: number;
+    is_complete: boolean;
+    ttl_seconds: number;
+    stored_durable: boolean;
+}
+interface V2FastCheckRequest {
+    session_id: string;
+    model?: FastCheckModel;
+    source?: FrameSource;
+    fps?: number;
+    frame_count?: number;
+    warnings?: string[];
+    device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
+}
+type V2LiveCheckRequest = V2FastCheckRequest;
 interface FastCheckCropsRequest {
     session_id: string;
     model?: FastCheckModel;
@@ -138,6 +194,7 @@ interface FastCheckResponse {
     warning: string | null;
     warnings?: string[] | null;
     error: string | null;
+    diagnostics?: Record<string, unknown> | null;
 }
 interface FastCheckStreamResponse {
     status: StreamingStatus;
@@ -225,6 +282,7 @@ interface LivenessResult {
     warnings?: string[];
     deprecation?: DeprecationInfo;
     clientTime?: number;
+    diagnostics?: Record<string, unknown> | null;
 }
 type LivenessState = 'idle' | 'capturing' | 'uploading' | 'processing' | 'complete' | 'error';
 interface LivenessConfig {
@@ -241,6 +299,11 @@ interface CapturedFrame {
     index: number;
     timestampMs: number;
     pixels: string;
+    landmarks?: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | null;
 }
 
 type ModelType = FastCheckModel;
@@ -596,6 +659,9 @@ declare class LivenessApiError extends Error {
     constructor(message: string, code: string, statusCode: number, required?: number, received?: number);
 }
 declare function toFrameData(frames: CapturedFrame[]): FrameData[];
+declare function toV2UploadFrameData(frames: CapturedFrame[], options?: {
+    withLandmarks?: boolean;
+}): V2UploadFrameData[];
 declare function toHybridFrameData(frames: CapturedFrame[]): HybridFrameData[];
 declare function toLivenessResult(response: FastCheckResponse | VerifyResponse | HybridCheckResponse): LivenessResult;
 declare function toLivenessResultFromStream(response: FastCheckStreamResponse): LivenessResult;
@@ -640,6 +706,14 @@ declare class LivenessClient {
         source?: FrameSource;
         warnings?: string[];
     }): Promise<LivenessResult>;
+    liveCheck(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;
@@ -701,6 +775,35 @@ declare class LivenessClient {
     }): Promise<LivenessResult>;
     getJobResult(jobId: string): Promise<JobStatusResponse>;
     waitForJobResult(jobId: string, timeout?: number): Promise<JobStatusResponse>;
+    v2Upload(frames: CapturedFrame[], options: {
+        sessionId: string;
+        model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        source?: FrameSource;
+        fps?: number;
+        frameCount?: number;
+        warnings?: string[];
+        withLandmarks?: boolean;
+    }): Promise<V2UploadResponse>;
+    v2FastCheck(options: {
+        sessionId: string;
+        model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        source?: FrameSource;
+        fps?: number;
+        frameCount?: number;
+        warnings?: string[];
+    }): Promise<LivenessResult>;
+    v2LiveCheck(options: {
+        sessionId: string;
+        model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        source?: FrameSource;
+        fps?: number;
+        frameCount?: number;
+        warnings?: string[];
+    }): Promise<LivenessResult>;
+    private runV2Check;
 }
 
 declare class FrameBuffer {
@@ -747,6 +850,7 @@ declare const API_PATHS: {
     readonly fastCheck: "/api/v1/fast-check";
     readonly fastCheckCrops: "/api/v1/fast-check-crops";
     readonly fastCheckStream: "/api/v1/fast-check-stream";
+    readonly liveCheck: "/api/v1/live-check";
     readonly verify: "/api/v1/verify";
     readonly hybridCheck: "/api/v1/hybrid-check";
     readonly hybrid50: "/api/v1/hybrid-50";
@@ -754,6 +858,9 @@ declare const API_PATHS: {
     readonly jobResult: "/api/v1/result";
     readonly queueStats: "/api/v1/queue/stats";
     readonly sessions: "/api/v1/sessions";
+    readonly v2Upload: "/api/v2/upload";
+    readonly v2FastCheck: "/api/v2/fast-check";
+    readonly v2LiveCheck: "/api/v2/live-check";
 };
 declare const RETRY_CONFIG: {
     readonly maxAttempts: 3;
@@ -968,4 +1075,4 @@ declare function collectDeviceIntelligence(opts?: {
     platformVersion?: string;
 }): Promise<DeviceIntelligence | null>;
 
-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 CameraCapabilities, type CameraRequirements, type CameraValidationResult, type CaptureQualityState, type CapturedFrame, type ConsumerContext, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_CAMERA_REQUIREMENTS, 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, DYNAMIC_RANGE_WARNING_THRESHOLD, type DeprecationInfo, type DetectionResult, type DetectionSummary, type DetectorConfig, type DeviceIntelligence, type DeviceIntelligenceCamera, type DeviceIntelligenceGeo, type DeviceIntelligenceOverrides, type DynamicRangeAnalysis, ERROR_MESSAGES, ERROR_MESSAGES_ES, ES_LOCALE, EYE_LANDMARK_INDICES, EYE_QUALITY_THRESHOLDS, type ErrorResponse, type ExtraMetadata, type EyeQualityThresholds, type EyeRegionBounds, type EyeRegionQuality, type EyeRegionsBounds, FACE_CROP_FRAME_MARGIN, 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, 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_FACE_PERCENTAGE_IN_CROP, MAX_FACE_RATIO, MAX_FACE_ROLL_DEGREES, MAX_IDEAL_FACE_RATIO, MIN_CAPTURE_ALIGNMENT, MIN_FACE_AREA_RATIO, 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, SHARED_SDK_PLATFORM, 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, analyzeDynamicRange, analyzeEyeRegionBrightness, analyzeEyeRegionContrast, analyzeLighting, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkEyeRegionQuality, checkFrameQuality, collectDeviceIntelligence, decodeBase64, detectCameraAngle, detectFaceRoll, detectFaceRollFromMatrix, detectSpecularHighlights, encodeBase64, generateSessionId, getActiveModels, getApiErrorMessage, getCaptureQualityFeedback, getEyeRegionBounds, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isDeprecatedModel, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, isRetryableError, linearRgbToLabL, retryWithBackoff, rgbaToGrayscale, sleep, srgbToLinear, 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 CameraCapabilities, type CameraRequirements, type CameraValidationResult, type CaptureQualityState, type CapturedFrame, type ConsumerContext, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_CAMERA_REQUIREMENTS, 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, DYNAMIC_RANGE_WARNING_THRESHOLD, type DeprecationInfo, type DetectionResult, type DetectionSummary, type DetectorConfig, type DeviceIntelligence, type DeviceIntelligenceCamera, type DeviceIntelligenceGeo, type DeviceIntelligenceOverrides, type DynamicRangeAnalysis, ERROR_MESSAGES, ERROR_MESSAGES_ES, ES_LOCALE, EYE_LANDMARK_INDICES, EYE_QUALITY_THRESHOLDS, type ErrorResponse, type ExtraMetadata, type EyeQualityThresholds, type EyeRegionBounds, type EyeRegionQuality, type EyeRegionsBounds, FACE_CROP_FRAME_MARGIN, 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, type JobStatus, type JobStatusResponse, LANDMARK_INDEX, LANDMARK_MAX_BOUND, LANDMARK_MIN_BOUND, LOW_LIGHT_THRESHOLD, type LandmarkValidationResult, type LightingAnalysis, type LiveCheckFrameData, type LiveCheckRequest, LivenessApiError, type LivenessCallbacks, LivenessClient, type LivenessClientConfig, type LivenessConfig, type LivenessResult, type LivenessState, MAX_FACE_PERCENTAGE_IN_CROP, MAX_FACE_RATIO, MAX_FACE_ROLL_DEGREES, MAX_IDEAL_FACE_RATIO, MIN_CAPTURE_ALIGNMENT, MIN_FACE_AREA_RATIO, 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, SHARED_SDK_PLATFORM, type StabilizationProgress, type StabilizationResult, type StabilizerConfig, type StatusMessageKey, type StreamingStatus, TARGET_FACE_PERCENTAGE_IN_CROP, type V2FastCheckRequest, type V2LiveCheckRequest, type V2UploadFrameData, type V2UploadRequest, type V2UploadResponse, VALID_FRAME_COUNTS, type Verdict, type VerifyRequest, type VerifyResponse, type VideoFrameMetadata, analyzeBlur, analyzeDynamicRange, analyzeEyeRegionBrightness, analyzeEyeRegionContrast, analyzeLighting, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkEyeRegionQuality, checkFrameQuality, collectDeviceIntelligence, decodeBase64, detectCameraAngle, detectFaceRoll, detectFaceRollFromMatrix, detectSpecularHighlights, encodeBase64, generateSessionId, getActiveModels, getApiErrorMessage, getCaptureQualityFeedback, getEyeRegionBounds, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isDeprecatedModel, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, isRetryableError, linearRgbToLabL, retryWithBackoff, rgbaToGrayscale, sleep, srgbToLinear, toFrameData, toHybridFrameData, toLivenessResult, toLivenessResultFromStream, toV2UploadFrameData, validateApiKey, validateFaceLandmarks, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };

package/dist/index.d.ts

@@ -59,6 +59,13 @@ interface FrameData {
     timestamp_ms: number;
     pixels: string;
 }
+interface LiveCheckFrameData extends FrameData {
+    landmarks: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | null;
+}
 interface CropData {
     index: number;
     pixels: string;
@@ -79,6 +86,55 @@ interface FastCheckRequest {
         consumer?: ConsumerContext;
     } | null;
 }
+interface LiveCheckRequest {
+    session_id: string;
+    model?: FastCheckModel;
+    source?: FrameSource;
+    frames: LiveCheckFrameData[];
+    frame_count?: number;
+    warnings?: string[];
+    device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
+}
+interface V2UploadFrameData extends FrameData {
+    landmarks?: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | null;
+}
+interface V2UploadRequest {
+    session_id: string;
+    model?: FastCheckModel;
+    source?: FrameSource;
+    fps?: number;
+    frames: V2UploadFrameData[];
+    frame_count?: number;
+    warnings?: string[];
+}
+interface V2UploadResponse {
+    session_id: string;
+    frames_received: number;
+    frames_required: number;
+    is_complete: boolean;
+    ttl_seconds: number;
+    stored_durable: boolean;
+}
+interface V2FastCheckRequest {
+    session_id: string;
+    model?: FastCheckModel;
+    source?: FrameSource;
+    fps?: number;
+    frame_count?: number;
+    warnings?: string[];
+    device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
+}
+type V2LiveCheckRequest = V2FastCheckRequest;
 interface FastCheckCropsRequest {
     session_id: string;
     model?: FastCheckModel;
@@ -138,6 +194,7 @@ interface FastCheckResponse {
     warning: string | null;
     warnings?: string[] | null;
     error: string | null;
+    diagnostics?: Record<string, unknown> | null;
 }
 interface FastCheckStreamResponse {
     status: StreamingStatus;
@@ -225,6 +282,7 @@ interface LivenessResult {
     warnings?: string[];
     deprecation?: DeprecationInfo;
     clientTime?: number;
+    diagnostics?: Record<string, unknown> | null;
 }
 type LivenessState = 'idle' | 'capturing' | 'uploading' | 'processing' | 'complete' | 'error';
 interface LivenessConfig {
@@ -241,6 +299,11 @@ interface CapturedFrame {
     index: number;
     timestampMs: number;
     pixels: string;
+    landmarks?: {
+        x: number;
+        y: number;
+        z: number;
+    }[] | null;
 }
 
 type ModelType = FastCheckModel;
@@ -596,6 +659,9 @@ declare class LivenessApiError extends Error {
     constructor(message: string, code: string, statusCode: number, required?: number, received?: number);
 }
 declare function toFrameData(frames: CapturedFrame[]): FrameData[];
+declare function toV2UploadFrameData(frames: CapturedFrame[], options?: {
+    withLandmarks?: boolean;
+}): V2UploadFrameData[];
 declare function toHybridFrameData(frames: CapturedFrame[]): HybridFrameData[];
 declare function toLivenessResult(response: FastCheckResponse | VerifyResponse | HybridCheckResponse): LivenessResult;
 declare function toLivenessResultFromStream(response: FastCheckStreamResponse): LivenessResult;
@@ -640,6 +706,14 @@ declare class LivenessClient {
         source?: FrameSource;
         warnings?: string[];
     }): Promise<LivenessResult>;
+    liveCheck(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;
@@ -701,6 +775,35 @@ declare class LivenessClient {
     }): Promise<LivenessResult>;
     getJobResult(jobId: string): Promise<JobStatusResponse>;
     waitForJobResult(jobId: string, timeout?: number): Promise<JobStatusResponse>;
+    v2Upload(frames: CapturedFrame[], options: {
+        sessionId: string;
+        model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        source?: FrameSource;
+        fps?: number;
+        frameCount?: number;
+        warnings?: string[];
+        withLandmarks?: boolean;
+    }): Promise<V2UploadResponse>;
+    v2FastCheck(options: {
+        sessionId: string;
+        model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        source?: FrameSource;
+        fps?: number;
+        frameCount?: number;
+        warnings?: string[];
+    }): Promise<LivenessResult>;
+    v2LiveCheck(options: {
+        sessionId: string;
+        model?: FastCheckModel;
+        modelVersion?: ModelVersion;
+        source?: FrameSource;
+        fps?: number;
+        frameCount?: number;
+        warnings?: string[];
+    }): Promise<LivenessResult>;
+    private runV2Check;
 }
 
 declare class FrameBuffer {
@@ -747,6 +850,7 @@ declare const API_PATHS: {
     readonly fastCheck: "/api/v1/fast-check";
     readonly fastCheckCrops: "/api/v1/fast-check-crops";
     readonly fastCheckStream: "/api/v1/fast-check-stream";
+    readonly liveCheck: "/api/v1/live-check";
     readonly verify: "/api/v1/verify";
     readonly hybridCheck: "/api/v1/hybrid-check";
     readonly hybrid50: "/api/v1/hybrid-50";
@@ -754,6 +858,9 @@ declare const API_PATHS: {
     readonly jobResult: "/api/v1/result";
     readonly queueStats: "/api/v1/queue/stats";
     readonly sessions: "/api/v1/sessions";
+    readonly v2Upload: "/api/v2/upload";
+    readonly v2FastCheck: "/api/v2/fast-check";
+    readonly v2LiveCheck: "/api/v2/live-check";
 };
 declare const RETRY_CONFIG: {
     readonly maxAttempts: 3;
@@ -968,4 +1075,4 @@ declare function collectDeviceIntelligence(opts?: {
     platformVersion?: string;
 }): Promise<DeviceIntelligence | null>;
 
-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 CameraCapabilities, type CameraRequirements, type CameraValidationResult, type CaptureQualityState, type CapturedFrame, type ConsumerContext, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_CAMERA_REQUIREMENTS, 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, DYNAMIC_RANGE_WARNING_THRESHOLD, type DeprecationInfo, type DetectionResult, type DetectionSummary, type DetectorConfig, type DeviceIntelligence, type DeviceIntelligenceCamera, type DeviceIntelligenceGeo, type DeviceIntelligenceOverrides, type DynamicRangeAnalysis, ERROR_MESSAGES, ERROR_MESSAGES_ES, ES_LOCALE, EYE_LANDMARK_INDICES, EYE_QUALITY_THRESHOLDS, type ErrorResponse, type ExtraMetadata, type EyeQualityThresholds, type EyeRegionBounds, type EyeRegionQuality, type EyeRegionsBounds, FACE_CROP_FRAME_MARGIN, 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, 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_FACE_PERCENTAGE_IN_CROP, MAX_FACE_RATIO, MAX_FACE_ROLL_DEGREES, MAX_IDEAL_FACE_RATIO, MIN_CAPTURE_ALIGNMENT, MIN_FACE_AREA_RATIO, 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, SHARED_SDK_PLATFORM, 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, analyzeDynamicRange, analyzeEyeRegionBrightness, analyzeEyeRegionContrast, analyzeLighting, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkEyeRegionQuality, checkFrameQuality, collectDeviceIntelligence, decodeBase64, detectCameraAngle, detectFaceRoll, detectFaceRollFromMatrix, detectSpecularHighlights, encodeBase64, generateSessionId, getActiveModels, getApiErrorMessage, getCaptureQualityFeedback, getEyeRegionBounds, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isDeprecatedModel, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, isRetryableError, linearRgbToLabL, retryWithBackoff, rgbaToGrayscale, sleep, srgbToLinear, 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 CameraCapabilities, type CameraRequirements, type CameraValidationResult, type CaptureQualityState, type CapturedFrame, type ConsumerContext, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_CAMERA_REQUIREMENTS, 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, DYNAMIC_RANGE_WARNING_THRESHOLD, type DeprecationInfo, type DetectionResult, type DetectionSummary, type DetectorConfig, type DeviceIntelligence, type DeviceIntelligenceCamera, type DeviceIntelligenceGeo, type DeviceIntelligenceOverrides, type DynamicRangeAnalysis, ERROR_MESSAGES, ERROR_MESSAGES_ES, ES_LOCALE, EYE_LANDMARK_INDICES, EYE_QUALITY_THRESHOLDS, type ErrorResponse, type ExtraMetadata, type EyeQualityThresholds, type EyeRegionBounds, type EyeRegionQuality, type EyeRegionsBounds, FACE_CROP_FRAME_MARGIN, 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, type JobStatus, type JobStatusResponse, LANDMARK_INDEX, LANDMARK_MAX_BOUND, LANDMARK_MIN_BOUND, LOW_LIGHT_THRESHOLD, type LandmarkValidationResult, type LightingAnalysis, type LiveCheckFrameData, type LiveCheckRequest, LivenessApiError, type LivenessCallbacks, LivenessClient, type LivenessClientConfig, type LivenessConfig, type LivenessResult, type LivenessState, MAX_FACE_PERCENTAGE_IN_CROP, MAX_FACE_RATIO, MAX_FACE_ROLL_DEGREES, MAX_IDEAL_FACE_RATIO, MIN_CAPTURE_ALIGNMENT, MIN_FACE_AREA_RATIO, 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, SHARED_SDK_PLATFORM, type StabilizationProgress, type StabilizationResult, type StabilizerConfig, type StatusMessageKey, type StreamingStatus, TARGET_FACE_PERCENTAGE_IN_CROP, type V2FastCheckRequest, type V2LiveCheckRequest, type V2UploadFrameData, type V2UploadRequest, type V2UploadResponse, VALID_FRAME_COUNTS, type Verdict, type VerifyRequest, type VerifyResponse, type VideoFrameMetadata, analyzeBlur, analyzeDynamicRange, analyzeEyeRegionBrightness, analyzeEyeRegionContrast, analyzeLighting, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkEyeRegionQuality, checkFrameQuality, collectDeviceIntelligence, decodeBase64, detectCameraAngle, detectFaceRoll, detectFaceRollFromMatrix, detectSpecularHighlights, encodeBase64, generateSessionId, getActiveModels, getApiErrorMessage, getCaptureQualityFeedback, getEyeRegionBounds, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isDeprecatedModel, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, isRetryableError, linearRgbToLabL, retryWithBackoff, rgbaToGrayscale, sleep, srgbToLinear, toFrameData, toHybridFrameData, toLivenessResult, toLivenessResultFromStream, toV2UploadFrameData, validateApiKey, validateFaceLandmarks, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };

package/dist/index.js

@@ -129,6 +129,7 @@ __export(index_exports, {
   toHybridFrameData: () => toHybridFrameData,
   toLivenessResult: () => toLivenessResult,
   toLivenessResultFromStream: () => toLivenessResultFromStream,
+  toV2UploadFrameData: () => toV2UploadFrameData,
   validateApiKey: () => validateApiKey,
   validateFaceLandmarks: () => validateFaceLandmarks,
   validateFrameCount: () => validateFrameCount,
@@ -153,13 +154,20 @@ var API_PATHS = {
   fastCheck: "/api/v1/fast-check",
   fastCheckCrops: "/api/v1/fast-check-crops",
   fastCheckStream: "/api/v1/fast-check-stream",
+  /** Live-check prototype (Phase 2): SDK-supplied landmarks per frame. */
+  liveCheck: "/api/v1/live-check",
   verify: "/api/v1/verify",
   hybridCheck: "/api/v1/hybrid-check",
   hybrid50: "/api/v1/hybrid-50",
   hybrid150: "/api/v1/hybrid-150",
   jobResult: "/api/v1/result",
   queueStats: "/api/v1/queue/stats",
-  sessions: "/api/v1/sessions"
+  sessions: "/api/v1/sessions",
+  // v2 upload-first pipeline (MOV-1936). Separate from v1; frames are uploaded
+  // first and resolved server-side by session_id at check time.
+  v2Upload: "/api/v2/upload",
+  v2FastCheck: "/api/v2/fast-check",
+  v2LiveCheck: "/api/v2/live-check"
 };
 var RETRY_CONFIG = {
   maxAttempts: 3,
@@ -239,7 +247,7 @@ async function sleep(ms) {
 }
 
 // package.json
-var version = "3.12.0";
+var version = "3.15.0";
 
 // src/utils/deviceIntelligence.ts
 var IPINFO_URL = "https://ipinfo.io/json";
@@ -298,6 +306,14 @@ var LivenessApiError = class extends Error {
     this.received = received;
   }
 };
+function toLiveCheckFrameData(frames) {
+  return frames.map((frame) => ({
+    index: frame.index,
+    timestamp_ms: frame.timestampMs,
+    pixels: frame.pixels,
+    landmarks: frame.landmarks ? frame.landmarks.map((lm) => ({ x: lm.x, y: lm.y, z: lm.z })) : null
+  }));
+}
 function toFrameData(frames) {
   return frames.map((frame) => ({
     index: frame.index,
@@ -305,6 +321,16 @@ function toFrameData(frames) {
     pixels: frame.pixels
   }));
 }
+function toV2UploadFrameData(frames, options = {}) {
+  return frames.map((frame) => ({
+    index: frame.index,
+    timestamp_ms: frame.timestampMs,
+    pixels: frame.pixels,
+    ...options.withLandmarks ? {
+      landmarks: frame.landmarks ? frame.landmarks.map((lm) => ({ x: lm.x, y: lm.y, z: lm.z })) : null
+    } : {}
+  }));
+}
 function toHybridFrameData(frames) {
   return frames.map((frame) => ({
     timestamp_ms: frame.timestampMs,
@@ -333,7 +359,10 @@ function toLivenessResult(response) {
     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
+    warnings: "warnings" in response && Array.isArray(response.warnings) ? response.warnings : void 0,
+    // Live-check prototype: surface the server diagnostics block so the
+    // demo can log it. Production fast-check leaves this off the wire.
+    ..."diagnostics" in response && response.diagnostics != null ? { diagnostics: response.diagnostics } : {}
   };
 }
 function toLivenessResultFromStream(response) {
@@ -453,15 +482,16 @@ var LivenessClient = class _LivenessClient {
     const url = `${this.baseUrl}${path}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    const mergedHeaders = {
+      "Content-Type": "application/json",
+      [AUTH_CONFIG.apiKeyHeader]: this.apiKey,
+      ...options.headers
+    };
     try {
       const response = await this.fetchFn(url, {
         ...options,
         signal: controller.signal,
-        headers: {
-          "Content-Type": "application/json",
-          [AUTH_CONFIG.apiKeyHeader]: this.apiKey,
-          ...options.headers
-        }
+        headers: mergedHeaders
       });
       clearTimeout(timeoutId);
       if (!response.ok) {
@@ -704,6 +734,42 @@ var LivenessClient = class _LivenessClient {
     }
     return result;
   }
+  /**
+   * Live-check prototype (Phase 2): same payload shape as ``fastCheck``
+   * plus the MediaPipe Face Mesh landmarks the SDK already computed for
+   * each frame. The server uses those landmarks to skip its own
+   * MediaPipe Face Detection + Face Mesh calls — typically a 5–15s
+   * server-side win on V3.1 models.
+   *
+   * Required: every frame must include `landmarks` (a 468-entry array
+   * of `{x, y, z}` from MediaPipe Face Mesh). Frames whose `landmarks`
+   * is `null` flow through cleanly and are dropped server-side.
+   */
+  async liveCheck(frames, options = {}) {
+    const effectiveVersion = options.modelVersion ?? this.modelVersion;
+    const di = await this.getDeviceIntelligence();
+    const request = {
+      session_id: options.sessionId ?? generateSessionId(),
+      model: options.model ?? "10",
+      source: options.source ?? "live",
+      frames: toLiveCheckFrameData(frames),
+      ...options.frameCount != null ? { frame_count: options.frameCount } : {},
+      ...options.warnings?.length ? { warnings: options.warnings } : {},
+      ...di ? { device_intelligence: di } : {},
+      ...this.buildMetadata() ? { metadata: this.buildMetadata() } : {}
+    };
+    const { data: response, headers } = await this.requestWithRetryRaw(
+      API_PATHS.liveCheck,
+      {
+        method: "POST",
+        body: JSON.stringify(request),
+        headers: this.buildModelVersionHeaders(effectiveVersion)
+      }
+    );
+    const result = toLivenessResult(response);
+    result.deprecation = _LivenessClient.parseDeprecationHeaders(headers);
+    return result;
+  }
   /**
    * Perform fast liveness check with pre-cropped face images
    *
@@ -1007,6 +1073,103 @@ var LivenessClient = class _LivenessClient {
       `${API_PATHS.jobResult}/${jobId}/wait?timeout=${timeout}`
     );
   }
+  // ===========================================================================
+  // v2 Pipeline (MOV-1936): upload-first
+  //
+  // Two-phase flow, fully separate from the v1 endpoints above:
+  //   1. v2Upload()    — buffer frames server-side (call once or repeatedly).
+  //   2. v2FastCheck() / v2LiveCheck() — run inference; NO frames in the body,
+  //      the server resolves them by session_id from the prior upload(s).
+  // The check responses reuse the v1 FastCheckResponse shape, so the existing
+  // `toLivenessResult` + deprecation-header handling applies unchanged.
+  // ===========================================================================
+  /**
+   * Buffer a batch of frames for a session (POST /api/v2/upload).
+   *
+   * Inference is NOT run here — this only stores frames keyed by `session_id`.
+   * May be called multiple times for the same session (e.g. chunked during
+   * capture); the server accumulates and reports cumulative progress.
+   *
+   * Set `withLandmarks` for the live-check path so MediaPipe landmarks travel
+   * with each frame; leave it off for the fast-check path.
+   *
+   * @param frames  - Captured frames to buffer
+   * @param options - Session, model, source and upload flags
+   * @returns Upload progress (frames_received / frames_required / is_complete)
+   */
+  async v2Upload(frames, options) {
+    const effectiveVersion = options.modelVersion ?? this.modelVersion;
+    const request = {
+      session_id: options.sessionId,
+      model: options.model ?? "10",
+      source: options.source ?? "live",
+      frames: toV2UploadFrameData(frames, { withLandmarks: options.withLandmarks }),
+      ...options.fps != null ? { fps: options.fps } : {},
+      ...options.frameCount != null ? { frame_count: options.frameCount } : {},
+      ...options.warnings?.length ? { warnings: options.warnings } : {}
+    };
+    return this.requestWithRetry(API_PATHS.v2Upload, {
+      method: "POST",
+      body: JSON.stringify(request),
+      headers: this.buildModelVersionHeaders(effectiveVersion)
+    });
+  }
+  /**
+   * Run a fast-check against frames previously uploaded via {@link v2Upload}
+   * (POST /api/v2/fast-check). The request carries NO frames — the server
+   * resolves them by `session_id`.
+   *
+   * @param options - Session and request context
+   * @returns Liveness result
+   */
+  async v2FastCheck(options) {
+    return this.runV2Check(API_PATHS.v2FastCheck, options);
+  }
+  /**
+   * Run a live-check against frames previously uploaded via {@link v2Upload}
+   * with `withLandmarks: true` (POST /api/v2/live-check). The request carries
+   * NO frames. The server requires a V3 model and surfaces the V3 `diagnostics`
+   * block on the result.
+   *
+   * @param options - Session and request context
+   * @returns Liveness result (includes `diagnostics`)
+   */
+  async v2LiveCheck(options) {
+    return this.runV2Check(API_PATHS.v2LiveCheck, options);
+  }
+  /**
+   * Shared body for the v2 fast-check / live-check requests (internal).
+   * Both endpoints take the identical no-frames payload and response shape;
+   * only the path differs.
+   */
+  async runV2Check(path, options) {
+    const effectiveVersion = options.modelVersion ?? this.modelVersion;
+    const di = await this.getDeviceIntelligence();
+    const metadata = this.buildMetadata();
+    const request = {
+      session_id: options.sessionId,
+      model: options.model ?? "10",
+      source: options.source ?? "live",
+      ...options.fps != null ? { fps: options.fps } : {},
+      ...options.frameCount != null ? { frame_count: options.frameCount } : {},
+      ...options.warnings?.length ? { warnings: options.warnings } : {},
+      ...di ? { device_intelligence: di } : {},
+      ...metadata ? { metadata } : {}
+    };
+    const { data: response, headers } = await this.requestWithRetryRaw(path, {
+      method: "POST",
+      body: JSON.stringify(request),
+      headers: this.buildModelVersionHeaders(effectiveVersion)
+    });
+    const result = toLivenessResult(response);
+    result.deprecation = _LivenessClient.parseDeprecationHeaders(headers);
+    if (result.deprecation?.deprecated) {
+      console.warn(
+        `[Moveris] Model "${result.deprecation.resolvedModel}" is deprecated.` + (result.deprecation.suggestedModel ? ` Migrate to "${result.deprecation.suggestedModel}".` : "") + (result.deprecation.sunsetDate ? ` Sunset date: ${result.deprecation.sunsetDate}.` : "")
+      );
+    }
+    return result;
+  }
 };
 
 // src/buffer/FrameBuffer.ts
@@ -2522,6 +2685,7 @@ function checkEyeRegionQuality(pixels, thresholds = EYE_QUALITY_THRESHOLDS) {
   toHybridFrameData,
   toLivenessResult,
   toLivenessResultFromStream,
+  toV2UploadFrameData,
   validateApiKey,
   validateFaceLandmarks,
   validateFrameCount,

package/dist/index.mjs

@@ -11,13 +11,20 @@ var API_PATHS = {
   fastCheck: "/api/v1/fast-check",
   fastCheckCrops: "/api/v1/fast-check-crops",
   fastCheckStream: "/api/v1/fast-check-stream",
+  /** Live-check prototype (Phase 2): SDK-supplied landmarks per frame. */
+  liveCheck: "/api/v1/live-check",
   verify: "/api/v1/verify",
   hybridCheck: "/api/v1/hybrid-check",
   hybrid50: "/api/v1/hybrid-50",
   hybrid150: "/api/v1/hybrid-150",
   jobResult: "/api/v1/result",
   queueStats: "/api/v1/queue/stats",
-  sessions: "/api/v1/sessions"
+  sessions: "/api/v1/sessions",
+  // v2 upload-first pipeline (MOV-1936). Separate from v1; frames are uploaded
+  // first and resolved server-side by session_id at check time.
+  v2Upload: "/api/v2/upload",
+  v2FastCheck: "/api/v2/fast-check",
+  v2LiveCheck: "/api/v2/live-check"
 };
 var RETRY_CONFIG = {
   maxAttempts: 3,
@@ -97,7 +104,7 @@ async function sleep(ms) {
 }
 
 // package.json
-var version = "3.12.0";
+var version = "3.15.0";
 
 // src/utils/deviceIntelligence.ts
 var IPINFO_URL = "https://ipinfo.io/json";
@@ -156,6 +163,14 @@ var LivenessApiError = class extends Error {
     this.received = received;
   }
 };
+function toLiveCheckFrameData(frames) {
+  return frames.map((frame) => ({
+    index: frame.index,
+    timestamp_ms: frame.timestampMs,
+    pixels: frame.pixels,
+    landmarks: frame.landmarks ? frame.landmarks.map((lm) => ({ x: lm.x, y: lm.y, z: lm.z })) : null
+  }));
+}
 function toFrameData(frames) {
   return frames.map((frame) => ({
     index: frame.index,
@@ -163,6 +178,16 @@ function toFrameData(frames) {
     pixels: frame.pixels
   }));
 }
+function toV2UploadFrameData(frames, options = {}) {
+  return frames.map((frame) => ({
+    index: frame.index,
+    timestamp_ms: frame.timestampMs,
+    pixels: frame.pixels,
+    ...options.withLandmarks ? {
+      landmarks: frame.landmarks ? frame.landmarks.map((lm) => ({ x: lm.x, y: lm.y, z: lm.z })) : null
+    } : {}
+  }));
+}
 function toHybridFrameData(frames) {
   return frames.map((frame) => ({
     timestamp_ms: frame.timestampMs,
@@ -191,7 +216,10 @@ function toLivenessResult(response) {
     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
+    warnings: "warnings" in response && Array.isArray(response.warnings) ? response.warnings : void 0,
+    // Live-check prototype: surface the server diagnostics block so the
+    // demo can log it. Production fast-check leaves this off the wire.
+    ..."diagnostics" in response && response.diagnostics != null ? { diagnostics: response.diagnostics } : {}
   };
 }
 function toLivenessResultFromStream(response) {
@@ -311,15 +339,16 @@ var LivenessClient = class _LivenessClient {
     const url = `${this.baseUrl}${path}`;
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    const mergedHeaders = {
+      "Content-Type": "application/json",
+      [AUTH_CONFIG.apiKeyHeader]: this.apiKey,
+      ...options.headers
+    };
     try {
       const response = await this.fetchFn(url, {
         ...options,
         signal: controller.signal,
-        headers: {
-          "Content-Type": "application/json",
-          [AUTH_CONFIG.apiKeyHeader]: this.apiKey,
-          ...options.headers
-        }
+        headers: mergedHeaders
       });
       clearTimeout(timeoutId);
       if (!response.ok) {
@@ -562,6 +591,42 @@ var LivenessClient = class _LivenessClient {
     }
     return result;
   }
+  /**
+   * Live-check prototype (Phase 2): same payload shape as ``fastCheck``
+   * plus the MediaPipe Face Mesh landmarks the SDK already computed for
+   * each frame. The server uses those landmarks to skip its own
+   * MediaPipe Face Detection + Face Mesh calls — typically a 5–15s
+   * server-side win on V3.1 models.
+   *
+   * Required: every frame must include `landmarks` (a 468-entry array
+   * of `{x, y, z}` from MediaPipe Face Mesh). Frames whose `landmarks`
+   * is `null` flow through cleanly and are dropped server-side.
+   */
+  async liveCheck(frames, options = {}) {
+    const effectiveVersion = options.modelVersion ?? this.modelVersion;
+    const di = await this.getDeviceIntelligence();
+    const request = {
+      session_id: options.sessionId ?? generateSessionId(),
+      model: options.model ?? "10",
+      source: options.source ?? "live",
+      frames: toLiveCheckFrameData(frames),
+      ...options.frameCount != null ? { frame_count: options.frameCount } : {},
+      ...options.warnings?.length ? { warnings: options.warnings } : {},
+      ...di ? { device_intelligence: di } : {},
+      ...this.buildMetadata() ? { metadata: this.buildMetadata() } : {}
+    };
+    const { data: response, headers } = await this.requestWithRetryRaw(
+      API_PATHS.liveCheck,
+      {
+        method: "POST",
+        body: JSON.stringify(request),
+        headers: this.buildModelVersionHeaders(effectiveVersion)
+      }
+    );
+    const result = toLivenessResult(response);
+    result.deprecation = _LivenessClient.parseDeprecationHeaders(headers);
+    return result;
+  }
   /**
    * Perform fast liveness check with pre-cropped face images
    *
@@ -865,6 +930,103 @@ var LivenessClient = class _LivenessClient {
       `${API_PATHS.jobResult}/${jobId}/wait?timeout=${timeout}`
     );
   }
+  // ===========================================================================
+  // v2 Pipeline (MOV-1936): upload-first
+  //
+  // Two-phase flow, fully separate from the v1 endpoints above:
+  //   1. v2Upload()    — buffer frames server-side (call once or repeatedly).
+  //   2. v2FastCheck() / v2LiveCheck() — run inference; NO frames in the body,
+  //      the server resolves them by session_id from the prior upload(s).
+  // The check responses reuse the v1 FastCheckResponse shape, so the existing
+  // `toLivenessResult` + deprecation-header handling applies unchanged.
+  // ===========================================================================
+  /**
+   * Buffer a batch of frames for a session (POST /api/v2/upload).
+   *
+   * Inference is NOT run here — this only stores frames keyed by `session_id`.
+   * May be called multiple times for the same session (e.g. chunked during
+   * capture); the server accumulates and reports cumulative progress.
+   *
+   * Set `withLandmarks` for the live-check path so MediaPipe landmarks travel
+   * with each frame; leave it off for the fast-check path.
+   *
+   * @param frames  - Captured frames to buffer
+   * @param options - Session, model, source and upload flags
+   * @returns Upload progress (frames_received / frames_required / is_complete)
+   */
+  async v2Upload(frames, options) {
+    const effectiveVersion = options.modelVersion ?? this.modelVersion;
+    const request = {
+      session_id: options.sessionId,
+      model: options.model ?? "10",
+      source: options.source ?? "live",
+      frames: toV2UploadFrameData(frames, { withLandmarks: options.withLandmarks }),
+      ...options.fps != null ? { fps: options.fps } : {},
+      ...options.frameCount != null ? { frame_count: options.frameCount } : {},
+      ...options.warnings?.length ? { warnings: options.warnings } : {}
+    };
+    return this.requestWithRetry(API_PATHS.v2Upload, {
+      method: "POST",
+      body: JSON.stringify(request),
+      headers: this.buildModelVersionHeaders(effectiveVersion)
+    });
+  }
+  /**
+   * Run a fast-check against frames previously uploaded via {@link v2Upload}
+   * (POST /api/v2/fast-check). The request carries NO frames — the server
+   * resolves them by `session_id`.
+   *
+   * @param options - Session and request context
+   * @returns Liveness result
+   */
+  async v2FastCheck(options) {
+    return this.runV2Check(API_PATHS.v2FastCheck, options);
+  }
+  /**
+   * Run a live-check against frames previously uploaded via {@link v2Upload}
+   * with `withLandmarks: true` (POST /api/v2/live-check). The request carries
+   * NO frames. The server requires a V3 model and surfaces the V3 `diagnostics`
+   * block on the result.
+   *
+   * @param options - Session and request context
+   * @returns Liveness result (includes `diagnostics`)
+   */
+  async v2LiveCheck(options) {
+    return this.runV2Check(API_PATHS.v2LiveCheck, options);
+  }
+  /**
+   * Shared body for the v2 fast-check / live-check requests (internal).
+   * Both endpoints take the identical no-frames payload and response shape;
+   * only the path differs.
+   */
+  async runV2Check(path, options) {
+    const effectiveVersion = options.modelVersion ?? this.modelVersion;
+    const di = await this.getDeviceIntelligence();
+    const metadata = this.buildMetadata();
+    const request = {
+      session_id: options.sessionId,
+      model: options.model ?? "10",
+      source: options.source ?? "live",
+      ...options.fps != null ? { fps: options.fps } : {},
+      ...options.frameCount != null ? { frame_count: options.frameCount } : {},
+      ...options.warnings?.length ? { warnings: options.warnings } : {},
+      ...di ? { device_intelligence: di } : {},
+      ...metadata ? { metadata } : {}
+    };
+    const { data: response, headers } = await this.requestWithRetryRaw(path, {
+      method: "POST",
+      body: JSON.stringify(request),
+      headers: this.buildModelVersionHeaders(effectiveVersion)
+    });
+    const result = toLivenessResult(response);
+    result.deprecation = _LivenessClient.parseDeprecationHeaders(headers);
+    if (result.deprecation?.deprecated) {
+      console.warn(
+        `[Moveris] Model "${result.deprecation.resolvedModel}" is deprecated.` + (result.deprecation.suggestedModel ? ` Migrate to "${result.deprecation.suggestedModel}".` : "") + (result.deprecation.sunsetDate ? ` Sunset date: ${result.deprecation.sunsetDate}.` : "")
+      );
+    }
+    return result;
+  }
 };
 
 // src/buffer/FrameBuffer.ts
@@ -2379,6 +2541,7 @@ export {
   toHybridFrameData,
   toLivenessResult,
   toLivenessResultFromStream,
+  toV2UploadFrameData,
   validateApiKey,
   validateFaceLandmarks,
   validateFrameCount,

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@moveris/shared",
-  "version": "3.12.0",
+  "version": "3.15.0",
   "description": "Core business logic for Moveris Live SDK",
+  "author": "Moveris - Jeyson Palacio, Arthur ITurres, Eric D. Brown",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -21,7 +22,6 @@
     "websocket",
     "sdk"
   ],
-  "author": "Jeyson Palacio",
   "license": "MIT",
   "devDependencies": {
     "@types/jest": "^29.5.11",