@moveris/shared 1.0.2 → 2.0.0

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 type Verdict = 'live' | 'fake';
-type FastCheckModel = '10' | '50' | '250';
+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';
+type StreamingStatus = 'buffering' | 'complete';
 type FrameSource = 'media' | 'live';
 type JobStatus = 'queued' | 'processing' | 'complete' | 'failed';
 interface FrameData {
@@ -50,6 +51,12 @@ interface Hybrid150CheckRequest {
     fps?: number;
     frames: HybridFrameData[];
 }
+interface FastCheckStreamRequest {
+    session_id: string;
+    model?: FastCheckModel;
+    source?: FrameSource;
+    frame: FrameData;
+}
 interface FastCheckResponse {
     verdict: Verdict | null;
     confidence: number | null;
@@ -63,6 +70,23 @@ interface FastCheckResponse {
     warning: string | null;
     error: string | null;
 }
+interface FastCheckStreamResponse {
+    status: StreamingStatus;
+    session_id: string;
+    frames_received: number;
+    frames_required: number;
+    ttl_seconds: number;
+    verdict: Verdict | null;
+    confidence: number | null;
+    real_score: number | null;
+    score: number | null;
+    model: string | null;
+    processing_ms: number | null;
+    frames_processed: number | null;
+    available: boolean;
+    warning: string | null;
+    error: string | null;
+}
 interface VerifyResponse {
     verdict: Verdict;
     confidence: number;
@@ -197,6 +221,7 @@ declare class LivenessApiError extends Error {
 declare function toFrameData(frames: CapturedFrame[]): FrameData[];
 declare function toHybridFrameData(frames: CapturedFrame[]): HybridFrameData[];
 declare function toLivenessResult(response: FastCheckResponse | VerifyResponse | HybridCheckResponse): LivenessResult;
+declare function toLivenessResultFromStream(response: FastCheckStreamResponse): LivenessResult;
 declare function generateSessionId(): string;
 declare class LivenessClient {
     private readonly baseUrl;
@@ -219,6 +244,23 @@ declare class LivenessClient {
         model?: FastCheckModel;
         source?: FrameSource;
     }): Promise<LivenessResult>;
+    private sendStreamFrame;
+    fastCheckStream(frames: CapturedFrame[], options?: {
+        sessionId?: string;
+        model?: FastCheckModel;
+        source?: FrameSource;
+    }, callbacks?: {
+        onFrameSent?: (index: number, total: number) => void;
+        onFrameBuffered?: (framesReceived: number, framesRequired: number) => void;
+    }): Promise<LivenessResult>;
+    fastCheckStreamSequential(frames: CapturedFrame[], options?: {
+        sessionId?: string;
+        model?: FastCheckModel;
+        source?: FrameSource;
+    }, callbacks?: {
+        onFrameSent?: (index: number, total: number) => void;
+        onFrameBuffered?: (framesReceived: number, framesRequired: number) => void;
+    }): Promise<LivenessResult>;
     verify(frames: CapturedFrame[], options?: {
         sessionId?: string;
         captureStartMs?: number;
@@ -284,6 +326,7 @@ declare const API_PATHS: {
     readonly health: "/health";
     readonly fastCheck: "/api/v1/fast-check";
     readonly fastCheckCrops: "/api/v1/fast-check-crops";
+    readonly fastCheckStream: "/api/v1/fast-check-stream";
     readonly verify: "/api/v1/verify";
     readonly hybridCheck: "/api/v1/hybrid-check";
     readonly hybrid50: "/api/v1/hybrid-50";
@@ -541,4 +584,4 @@ declare class BaseFrameCollector {
     getNextIndex(): number;
 }
 
-export { ALIGNMENT_THRESHOLD_CAPTURE, ALIGNMENT_THRESHOLD_GOOD, ALIGNMENT_THRESHOLD_PERFECT, ALIGNMENT_THRESHOLD_POOR, API_ENDPOINTS, API_PATHS, AUTH_CONFIG, BACKLIT_RATIO_THRESHOLD, BLUR_THRESHOLD_MOBILE, BaseFrameCollector, type BlurAnalysis, type CaptureQualityState, type CapturedFrame, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_ENDPOINT, DEFAULT_LIVENESS_CONFIG, DEFAULT_LOCALE, DEFAULT_OVAL_REGION, DEFAULT_STATUS_MESSAGES, ES_LOCALE, type ErrorResponse, FACE_CENTER_VERTICAL_OFFSET, FACE_CROP_OUTPUT_SIZE, FEEDBACK_MESSAGES, FRAME_BUFFER_CONFIG, FRAME_CONFIG, type FaceAlignmentResult, type FaceBoundingBox, type FaceInOvalResult, type FaceVisibilityResult, type FastCheckCropsRequest, type FastCheckModel, type FastCheckRequest, type FastCheckResponse, type FeedbackLocale, type FeedbackMessageKey, type Frame, FrameBuffer, type FrameData, type FrameQualityResult, FrameQueue, type FrameSource, GOOD_ALIGNMENT, HIGH_ALIGNMENT, HYBRID_MODEL_CONFIGS, type HealthResponse, type Hybrid150CheckRequest, type Hybrid50CheckRequest, type HybridCheckRequest, type HybridCheckResponse, type HybridFrameData, type HybridModelConfig, IDEAL_CROP_MULTIPLIER, type JobStatus, type JobStatusResponse, LOW_LIGHT_THRESHOLD, 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, MIN_CAPTURE_ALIGNMENT, MIN_CROP_MULTIPLIER, MIN_FACE_BOTTOM_MARGIN, MIN_FACE_RATIO, MIN_FACE_SIDE_MARGIN, MIN_FACE_TOP_MARGIN, MODEL_CONFIGS, type ModelConfig, type ModelType, OVAL_GUIDE_COLORS, OVAL_GUIDE_STYLES, type OnErrorCallback, type OnFrameCapturedCallback, type OnProgressCallback, type OnResultCallback, type OnStateChangeCallback, type OvalGuideState, type OvalRegion, type QueueStatsResponse, RETRY_CONFIG, type RetryOptions, type StatusMessageKey, TARGET_FACE_PERCENTAGE_IN_CROP, type Verdict, type VerifyRequest, type VerifyResponse, analyzeBlur, analyzeLighting, calculateAdaptiveCropMultiplier, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkFrameQuality, decodeBase64, encodeBase64, generateSessionId, getCaptureQualityFeedback, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, retryWithBackoff, rgbaToGrayscale, sleep, toFrameData, toHybridFrameData, toLivenessResult, validateApiKey, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };
+export { ALIGNMENT_THRESHOLD_CAPTURE, ALIGNMENT_THRESHOLD_GOOD, ALIGNMENT_THRESHOLD_PERFECT, ALIGNMENT_THRESHOLD_POOR, API_ENDPOINTS, API_PATHS, AUTH_CONFIG, BACKLIT_RATIO_THRESHOLD, BLUR_THRESHOLD_MOBILE, BaseFrameCollector, type BlurAnalysis, type CaptureQualityState, type CapturedFrame, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_ENDPOINT, DEFAULT_LIVENESS_CONFIG, DEFAULT_LOCALE, DEFAULT_OVAL_REGION, DEFAULT_STATUS_MESSAGES, ES_LOCALE, type ErrorResponse, FACE_CENTER_VERTICAL_OFFSET, FACE_CROP_OUTPUT_SIZE, FEEDBACK_MESSAGES, FRAME_BUFFER_CONFIG, FRAME_CONFIG, type FaceAlignmentResult, type FaceBoundingBox, type FaceInOvalResult, 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, HIGH_ALIGNMENT, HYBRID_MODEL_CONFIGS, type HealthResponse, type Hybrid150CheckRequest, type Hybrid50CheckRequest, type HybridCheckRequest, type HybridCheckResponse, type HybridFrameData, type HybridModelConfig, IDEAL_CROP_MULTIPLIER, type JobStatus, type JobStatusResponse, LOW_LIGHT_THRESHOLD, 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, MIN_CAPTURE_ALIGNMENT, MIN_CROP_MULTIPLIER, MIN_FACE_BOTTOM_MARGIN, MIN_FACE_RATIO, MIN_FACE_SIDE_MARGIN, MIN_FACE_TOP_MARGIN, MODEL_CONFIGS, type ModelConfig, type ModelType, OVAL_GUIDE_COLORS, OVAL_GUIDE_STYLES, type OnErrorCallback, type OnFrameCapturedCallback, type OnProgressCallback, type OnResultCallback, type OnStateChangeCallback, type OvalGuideState, type OvalRegion, type QueueStatsResponse, RETRY_CONFIG, type RetryOptions, type StatusMessageKey, type StreamingStatus, TARGET_FACE_PERCENTAGE_IN_CROP, type Verdict, type VerifyRequest, type VerifyResponse, analyzeBlur, analyzeLighting, calculateAdaptiveCropMultiplier, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkFrameQuality, decodeBase64, encodeBase64, generateSessionId, getCaptureQualityFeedback, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, retryWithBackoff, rgbaToGrayscale, sleep, toFrameData, toHybridFrameData, toLivenessResult, toLivenessResultFromStream, validateApiKey, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 type Verdict = 'live' | 'fake';
-type FastCheckModel = '10' | '50' | '250';
+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';
+type StreamingStatus = 'buffering' | 'complete';
 type FrameSource = 'media' | 'live';
 type JobStatus = 'queued' | 'processing' | 'complete' | 'failed';
 interface FrameData {
@@ -50,6 +51,12 @@ interface Hybrid150CheckRequest {
     fps?: number;
     frames: HybridFrameData[];
 }
+interface FastCheckStreamRequest {
+    session_id: string;
+    model?: FastCheckModel;
+    source?: FrameSource;
+    frame: FrameData;
+}
 interface FastCheckResponse {
     verdict: Verdict | null;
     confidence: number | null;
@@ -63,6 +70,23 @@ interface FastCheckResponse {
     warning: string | null;
     error: string | null;
 }
+interface FastCheckStreamResponse {
+    status: StreamingStatus;
+    session_id: string;
+    frames_received: number;
+    frames_required: number;
+    ttl_seconds: number;
+    verdict: Verdict | null;
+    confidence: number | null;
+    real_score: number | null;
+    score: number | null;
+    model: string | null;
+    processing_ms: number | null;
+    frames_processed: number | null;
+    available: boolean;
+    warning: string | null;
+    error: string | null;
+}
 interface VerifyResponse {
     verdict: Verdict;
     confidence: number;
@@ -197,6 +221,7 @@ declare class LivenessApiError extends Error {
 declare function toFrameData(frames: CapturedFrame[]): FrameData[];
 declare function toHybridFrameData(frames: CapturedFrame[]): HybridFrameData[];
 declare function toLivenessResult(response: FastCheckResponse | VerifyResponse | HybridCheckResponse): LivenessResult;
+declare function toLivenessResultFromStream(response: FastCheckStreamResponse): LivenessResult;
 declare function generateSessionId(): string;
 declare class LivenessClient {
     private readonly baseUrl;
@@ -219,6 +244,23 @@ declare class LivenessClient {
         model?: FastCheckModel;
         source?: FrameSource;
     }): Promise<LivenessResult>;
+    private sendStreamFrame;
+    fastCheckStream(frames: CapturedFrame[], options?: {
+        sessionId?: string;
+        model?: FastCheckModel;
+        source?: FrameSource;
+    }, callbacks?: {
+        onFrameSent?: (index: number, total: number) => void;
+        onFrameBuffered?: (framesReceived: number, framesRequired: number) => void;
+    }): Promise<LivenessResult>;
+    fastCheckStreamSequential(frames: CapturedFrame[], options?: {
+        sessionId?: string;
+        model?: FastCheckModel;
+        source?: FrameSource;
+    }, callbacks?: {
+        onFrameSent?: (index: number, total: number) => void;
+        onFrameBuffered?: (framesReceived: number, framesRequired: number) => void;
+    }): Promise<LivenessResult>;
     verify(frames: CapturedFrame[], options?: {
         sessionId?: string;
         captureStartMs?: number;
@@ -284,6 +326,7 @@ declare const API_PATHS: {
     readonly health: "/health";
     readonly fastCheck: "/api/v1/fast-check";
     readonly fastCheckCrops: "/api/v1/fast-check-crops";
+    readonly fastCheckStream: "/api/v1/fast-check-stream";
     readonly verify: "/api/v1/verify";
     readonly hybridCheck: "/api/v1/hybrid-check";
     readonly hybrid50: "/api/v1/hybrid-50";
@@ -541,4 +584,4 @@ declare class BaseFrameCollector {
     getNextIndex(): number;
 }
 
-export { ALIGNMENT_THRESHOLD_CAPTURE, ALIGNMENT_THRESHOLD_GOOD, ALIGNMENT_THRESHOLD_PERFECT, ALIGNMENT_THRESHOLD_POOR, API_ENDPOINTS, API_PATHS, AUTH_CONFIG, BACKLIT_RATIO_THRESHOLD, BLUR_THRESHOLD_MOBILE, BaseFrameCollector, type BlurAnalysis, type CaptureQualityState, type CapturedFrame, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_ENDPOINT, DEFAULT_LIVENESS_CONFIG, DEFAULT_LOCALE, DEFAULT_OVAL_REGION, DEFAULT_STATUS_MESSAGES, ES_LOCALE, type ErrorResponse, FACE_CENTER_VERTICAL_OFFSET, FACE_CROP_OUTPUT_SIZE, FEEDBACK_MESSAGES, FRAME_BUFFER_CONFIG, FRAME_CONFIG, type FaceAlignmentResult, type FaceBoundingBox, type FaceInOvalResult, type FaceVisibilityResult, type FastCheckCropsRequest, type FastCheckModel, type FastCheckRequest, type FastCheckResponse, type FeedbackLocale, type FeedbackMessageKey, type Frame, FrameBuffer, type FrameData, type FrameQualityResult, FrameQueue, type FrameSource, GOOD_ALIGNMENT, HIGH_ALIGNMENT, HYBRID_MODEL_CONFIGS, type HealthResponse, type Hybrid150CheckRequest, type Hybrid50CheckRequest, type HybridCheckRequest, type HybridCheckResponse, type HybridFrameData, type HybridModelConfig, IDEAL_CROP_MULTIPLIER, type JobStatus, type JobStatusResponse, LOW_LIGHT_THRESHOLD, 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, MIN_CAPTURE_ALIGNMENT, MIN_CROP_MULTIPLIER, MIN_FACE_BOTTOM_MARGIN, MIN_FACE_RATIO, MIN_FACE_SIDE_MARGIN, MIN_FACE_TOP_MARGIN, MODEL_CONFIGS, type ModelConfig, type ModelType, OVAL_GUIDE_COLORS, OVAL_GUIDE_STYLES, type OnErrorCallback, type OnFrameCapturedCallback, type OnProgressCallback, type OnResultCallback, type OnStateChangeCallback, type OvalGuideState, type OvalRegion, type QueueStatsResponse, RETRY_CONFIG, type RetryOptions, type StatusMessageKey, TARGET_FACE_PERCENTAGE_IN_CROP, type Verdict, type VerifyRequest, type VerifyResponse, analyzeBlur, analyzeLighting, calculateAdaptiveCropMultiplier, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkFrameQuality, decodeBase64, encodeBase64, generateSessionId, getCaptureQualityFeedback, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, retryWithBackoff, rgbaToGrayscale, sleep, toFrameData, toHybridFrameData, toLivenessResult, validateApiKey, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };
+export { ALIGNMENT_THRESHOLD_CAPTURE, ALIGNMENT_THRESHOLD_GOOD, ALIGNMENT_THRESHOLD_PERFECT, ALIGNMENT_THRESHOLD_POOR, API_ENDPOINTS, API_PATHS, AUTH_CONFIG, BACKLIT_RATIO_THRESHOLD, BLUR_THRESHOLD_MOBILE, BaseFrameCollector, type BlurAnalysis, type CaptureQualityState, type CapturedFrame, type CropData, DEFAULT_BLUR_THRESHOLD, DEFAULT_ENDPOINT, DEFAULT_LIVENESS_CONFIG, DEFAULT_LOCALE, DEFAULT_OVAL_REGION, DEFAULT_STATUS_MESSAGES, ES_LOCALE, type ErrorResponse, FACE_CENTER_VERTICAL_OFFSET, FACE_CROP_OUTPUT_SIZE, FEEDBACK_MESSAGES, FRAME_BUFFER_CONFIG, FRAME_CONFIG, type FaceAlignmentResult, type FaceBoundingBox, type FaceInOvalResult, 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, HIGH_ALIGNMENT, HYBRID_MODEL_CONFIGS, type HealthResponse, type Hybrid150CheckRequest, type Hybrid50CheckRequest, type HybridCheckRequest, type HybridCheckResponse, type HybridFrameData, type HybridModelConfig, IDEAL_CROP_MULTIPLIER, type JobStatus, type JobStatusResponse, LOW_LIGHT_THRESHOLD, 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, MIN_CAPTURE_ALIGNMENT, MIN_CROP_MULTIPLIER, MIN_FACE_BOTTOM_MARGIN, MIN_FACE_RATIO, MIN_FACE_SIDE_MARGIN, MIN_FACE_TOP_MARGIN, MODEL_CONFIGS, type ModelConfig, type ModelType, OVAL_GUIDE_COLORS, OVAL_GUIDE_STYLES, type OnErrorCallback, type OnFrameCapturedCallback, type OnProgressCallback, type OnResultCallback, type OnStateChangeCallback, type OvalGuideState, type OvalRegion, type QueueStatsResponse, RETRY_CONFIG, type RetryOptions, type StatusMessageKey, type StreamingStatus, TARGET_FACE_PERCENTAGE_IN_CROP, type Verdict, type VerifyRequest, type VerifyResponse, analyzeBlur, analyzeLighting, calculateAdaptiveCropMultiplier, calculateBrightness, calculateFaceAlignment, calculateFaceCropRegion, canCaptureFrame, checkFrameQuality, decodeBase64, encodeBase64, generateSessionId, getCaptureQualityFeedback, getFeedbackMessage, getMinFramesForModel, getOvalGuideState, getStatusMessage, hasEnoughFrames, isFaceCropFullyInFrame, isFaceFullyVisible, isFaceInOval, retryWithBackoff, rgbaToGrayscale, sleep, toFrameData, toHybridFrameData, toLivenessResult, toLivenessResultFromStream, validateApiKey, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };

package/dist/index.js

@@ -91,6 +91,7 @@ __export(index_exports, {
   toFrameData: () => toFrameData,
   toHybridFrameData: () => toHybridFrameData,
   toLivenessResult: () => toLivenessResult,
+  toLivenessResultFromStream: () => toLivenessResultFromStream,
   validateApiKey: () => validateApiKey,
   validateFrameCount: () => validateFrameCount,
   validateFrameData: () => validateFrameData,
@@ -112,6 +113,7 @@ var API_PATHS = {
   health: "/health",
   fastCheck: "/api/v1/fast-check",
   fastCheckCrops: "/api/v1/fast-check-crops",
+  fastCheckStream: "/api/v1/fast-check-stream",
   verify: "/api/v1/verify",
   hybridCheck: "/api/v1/hybrid-check",
   hybrid50: "/api/v1/hybrid-50",
@@ -232,6 +234,22 @@ function toLivenessResult(response) {
     framesProcessed: "frames_processed" in response ? response.frames_processed ?? 0 : 0
   };
 }
+function toLivenessResultFromStream(response) {
+  if (response.status !== "complete") {
+    throw new LivenessApiError("Stream not complete", "stream_incomplete", 400);
+  }
+  if (!response.verdict) {
+    throw new LivenessApiError(response.error ?? "No verdict received", "no_verdict", 500);
+  }
+  return {
+    verdict: response.verdict,
+    confidence: response.confidence ?? 0,
+    score: response.score ?? 0,
+    sessionId: response.session_id,
+    processingMs: response.processing_ms ?? 0,
+    framesProcessed: response.frames_processed ?? 0
+  };
+}
 function generateSessionId() {
   if (typeof crypto !== "undefined" && crypto.randomUUID) {
     return crypto.randomUUID();
@@ -366,6 +384,116 @@ var LivenessClient = class {
     });
     return toLivenessResult(response);
   }
+  /**
+   * Send a single frame to the streaming endpoint with retry
+   *
+   * @param frame - Single frame to send
+   * @param options - Session and model options
+   * @returns Stream response with status
+   */
+  async sendStreamFrame(frame, options) {
+    const request = {
+      session_id: options.sessionId,
+      model: options.model,
+      source: options.source,
+      frame
+    };
+    return this.requestWithRetry(API_PATHS.fastCheckStream, {
+      method: "POST",
+      body: JSON.stringify(request)
+    });
+  }
+  /**
+   * Perform streaming liveness check by sending frames one at a time
+   *
+   * Each frame is sent separately to the streaming endpoint with individual retry.
+   * The last frame that completes the set will return the full liveness result.
+   *
+   * @param frames - Captured frames to analyze
+   * @param options - Additional options
+   * @param callbacks - Optional callbacks for progress tracking
+   * @returns Liveness result
+   */
+  async fastCheckStream(frames, options = {}, callbacks) {
+    const sessionId = options.sessionId ?? generateSessionId();
+    const model = options.model ?? "10";
+    const source = options.source ?? "live";
+    const frameDataList = toFrameData(frames);
+    const total = frameDataList.length;
+    let finalResponse = null;
+    const sendPromises = frameDataList.map(async (frameData, index) => {
+      const response = await this.sendStreamFrame(frameData, {
+        sessionId,
+        model,
+        source
+      });
+      callbacks?.onFrameSent?.(index + 1, total);
+      if (response.status === "buffering") {
+        callbacks?.onFrameBuffered?.(response.frames_received, response.frames_required);
+      }
+      return response;
+    });
+    const responses = await Promise.all(sendPromises);
+    finalResponse = responses.find((r) => r.status === "complete") ?? null;
+    if (!finalResponse) {
+      const lastResponse = responses[responses.length - 1];
+      if (lastResponse) {
+        throw new LivenessApiError(
+          `Streaming incomplete: received ${lastResponse.frames_received}/${lastResponse.frames_required} frames`,
+          "stream_incomplete",
+          400
+        );
+      }
+      throw new LivenessApiError(
+        "Streaming failed: no responses received",
+        "stream_incomplete",
+        400
+      );
+    }
+    return toLivenessResultFromStream(finalResponse);
+  }
+  /**
+   * Perform streaming liveness check by sending frames sequentially
+   *
+   * Alternative to fastCheckStream that sends frames one by one in order.
+   * Useful when parallel uploads are not desired or network is constrained.
+   *
+   * @param frames - Captured frames to analyze
+   * @param options - Additional options
+   * @param callbacks - Optional callbacks for progress tracking
+   * @returns Liveness result
+   */
+  async fastCheckStreamSequential(frames, options = {}, callbacks) {
+    const sessionId = options.sessionId ?? generateSessionId();
+    const model = options.model ?? "10";
+    const source = options.source ?? "live";
+    const frameDataList = toFrameData(frames);
+    const total = frameDataList.length;
+    let finalResponse = null;
+    for (const frameData of frameDataList) {
+      const response = await this.sendStreamFrame(frameData, {
+        sessionId,
+        model,
+        source
+      });
+      const currentIndex = frameData.index;
+      callbacks?.onFrameSent?.(currentIndex + 1, total);
+      if (response.status === "buffering") {
+        callbacks?.onFrameBuffered?.(response.frames_received, response.frames_required);
+      } else if (response.status === "complete") {
+        finalResponse = response;
+        break;
+      }
+    }
+    if (!finalResponse) {
+      throw new LivenessApiError(
+        "Streaming did not complete after all frames sent",
+        "stream_incomplete",
+        400
+      );
+    }
+    return toLivenessResultFromStream(finalResponse);
+  }
   // ===========================================================================
   // Verify Endpoint (Spatial Features)
   // ===========================================================================
@@ -622,6 +750,7 @@ var FrameQueue = class {
 
 // src/types/models.ts
 var MODEL_CONFIGS = {
+  // Standard fast-check models
   "10": {
     type: "10",
     minFrames: 10,
@@ -639,6 +768,104 @@ var MODEL_CONFIGS = {
     minFrames: 250,
     recommendedFrames: 250,
     description: "High-accuracy model - 250 frames, best accuracy"
+  },
+  // Hybrid V2 models with physiological features
+  "hybrid-v2-10": {
+    type: "hybrid-v2-10",
+    minFrames: 10,
+    recommendedFrames: 10,
+    description: "Hybrid V2 10-frame model with physio features"
+  },
+  "hybrid-v2-30": {
+    type: "hybrid-v2-30",
+    minFrames: 30,
+    recommendedFrames: 30,
+    description: "Hybrid V2 30-frame model with physio features"
+  },
+  "hybrid-v2-50": {
+    type: "hybrid-v2-50",
+    minFrames: 50,
+    recommendedFrames: 50,
+    description: "Hybrid V2 50-frame model with physio features"
+  },
+  "hybrid-v2-60": {
+    type: "hybrid-v2-60",
+    minFrames: 60,
+    recommendedFrames: 60,
+    description: "Hybrid V2 60-frame model with physio features"
+  },
+  "hybrid-v2-90": {
+    type: "hybrid-v2-90",
+    minFrames: 90,
+    recommendedFrames: 90,
+    description: "Hybrid V2 90-frame model with physio features"
+  },
+  "hybrid-v2-100": {
+    type: "hybrid-v2-100",
+    minFrames: 100,
+    recommendedFrames: 100,
+    description: "Hybrid V2 100-frame model with physio features"
+  },
+  "hybrid-v2-125": {
+    type: "hybrid-v2-125",
+    minFrames: 125,
+    recommendedFrames: 125,
+    description: "Hybrid V2 125-frame model with physio features"
+  },
+  "hybrid-v2-150": {
+    type: "hybrid-v2-150",
+    minFrames: 150,
+    recommendedFrames: 150,
+    description: "Hybrid V2 150-frame model with physio features"
+  },
+  "hybrid-v2-250": {
+    type: "hybrid-v2-250",
+    minFrames: 250,
+    recommendedFrames: 250,
+    description: "Hybrid V2 250-frame model with physio features"
+  },
+  // Mixed models (FastLivenessDetector with mixed-trained weights)
+  "mixed-10": {
+    type: "mixed-10",
+    minFrames: 10,
+    recommendedFrames: 10,
+    description: "Mixed 10-frame model"
+  },
+  "mixed-30": {
+    type: "mixed-30",
+    minFrames: 30,
+    recommendedFrames: 30,
+    description: "Mixed 30-frame model"
+  },
+  "mixed-60": {
+    type: "mixed-60",
+    minFrames: 60,
+    recommendedFrames: 60,
+    description: "Mixed 60-frame model"
+  },
+  "mixed-90": {
+    type: "mixed-90",
+    minFrames: 90,
+    recommendedFrames: 90,
+    description: "Mixed 90-frame model"
+  },
+  "mixed-120": {
+    type: "mixed-120",
+    minFrames: 120,
+    recommendedFrames: 120,
+    description: "Mixed 120-frame model"
+  },
+  "mixed-150": {
+    type: "mixed-150",
+    minFrames: 150,
+    recommendedFrames: 150,
+    description: "Mixed 150-frame model"
+  },
+  "mixed-250": {
+    type: "mixed-250",
+    minFrames: 250,
+    recommendedFrames: 250,
+    description: "Mixed 250-frame model"
   }
 };
 var HYBRID_MODEL_CONFIGS = {
@@ -1277,6 +1504,7 @@ var BaseFrameCollector = class {
   toFrameData,
   toHybridFrameData,
   toLivenessResult,
+  toLivenessResultFromStream,
   validateApiKey,
   validateFrameCount,
   validateFrameData,

package/dist/index.mjs

@@ -9,6 +9,7 @@ var API_PATHS = {
   health: "/health",
   fastCheck: "/api/v1/fast-check",
   fastCheckCrops: "/api/v1/fast-check-crops",
+  fastCheckStream: "/api/v1/fast-check-stream",
   verify: "/api/v1/verify",
   hybridCheck: "/api/v1/hybrid-check",
   hybrid50: "/api/v1/hybrid-50",
@@ -129,6 +130,22 @@ function toLivenessResult(response) {
     framesProcessed: "frames_processed" in response ? response.frames_processed ?? 0 : 0
   };
 }
+function toLivenessResultFromStream(response) {
+  if (response.status !== "complete") {
+    throw new LivenessApiError("Stream not complete", "stream_incomplete", 400);
+  }
+  if (!response.verdict) {
+    throw new LivenessApiError(response.error ?? "No verdict received", "no_verdict", 500);
+  }
+  return {
+    verdict: response.verdict,
+    confidence: response.confidence ?? 0,
+    score: response.score ?? 0,
+    sessionId: response.session_id,
+    processingMs: response.processing_ms ?? 0,
+    framesProcessed: response.frames_processed ?? 0
+  };
+}
 function generateSessionId() {
   if (typeof crypto !== "undefined" && crypto.randomUUID) {
     return crypto.randomUUID();
@@ -263,6 +280,116 @@ var LivenessClient = class {
     });
     return toLivenessResult(response);
   }
+  /**
+   * Send a single frame to the streaming endpoint with retry
+   *
+   * @param frame - Single frame to send
+   * @param options - Session and model options
+   * @returns Stream response with status
+   */
+  async sendStreamFrame(frame, options) {
+    const request = {
+      session_id: options.sessionId,
+      model: options.model,
+      source: options.source,
+      frame
+    };
+    return this.requestWithRetry(API_PATHS.fastCheckStream, {
+      method: "POST",
+      body: JSON.stringify(request)
+    });
+  }
+  /**
+   * Perform streaming liveness check by sending frames one at a time
+   *
+   * Each frame is sent separately to the streaming endpoint with individual retry.
+   * The last frame that completes the set will return the full liveness result.
+   *
+   * @param frames - Captured frames to analyze
+   * @param options - Additional options
+   * @param callbacks - Optional callbacks for progress tracking
+   * @returns Liveness result
+   */
+  async fastCheckStream(frames, options = {}, callbacks) {
+    const sessionId = options.sessionId ?? generateSessionId();
+    const model = options.model ?? "10";
+    const source = options.source ?? "live";
+    const frameDataList = toFrameData(frames);
+    const total = frameDataList.length;
+    let finalResponse = null;
+    const sendPromises = frameDataList.map(async (frameData, index) => {
+      const response = await this.sendStreamFrame(frameData, {
+        sessionId,
+        model,
+        source
+      });
+      callbacks?.onFrameSent?.(index + 1, total);
+      if (response.status === "buffering") {
+        callbacks?.onFrameBuffered?.(response.frames_received, response.frames_required);
+      }
+      return response;
+    });
+    const responses = await Promise.all(sendPromises);
+    finalResponse = responses.find((r) => r.status === "complete") ?? null;
+    if (!finalResponse) {
+      const lastResponse = responses[responses.length - 1];
+      if (lastResponse) {
+        throw new LivenessApiError(
+          `Streaming incomplete: received ${lastResponse.frames_received}/${lastResponse.frames_required} frames`,
+          "stream_incomplete",
+          400
+        );
+      }
+      throw new LivenessApiError(
+        "Streaming failed: no responses received",
+        "stream_incomplete",
+        400
+      );
+    }
+    return toLivenessResultFromStream(finalResponse);
+  }
+  /**
+   * Perform streaming liveness check by sending frames sequentially
+   *
+   * Alternative to fastCheckStream that sends frames one by one in order.
+   * Useful when parallel uploads are not desired or network is constrained.
+   *
+   * @param frames - Captured frames to analyze
+   * @param options - Additional options
+   * @param callbacks - Optional callbacks for progress tracking
+   * @returns Liveness result
+   */
+  async fastCheckStreamSequential(frames, options = {}, callbacks) {
+    const sessionId = options.sessionId ?? generateSessionId();
+    const model = options.model ?? "10";
+    const source = options.source ?? "live";
+    const frameDataList = toFrameData(frames);
+    const total = frameDataList.length;
+    let finalResponse = null;
+    for (const frameData of frameDataList) {
+      const response = await this.sendStreamFrame(frameData, {
+        sessionId,
+        model,
+        source
+      });
+      const currentIndex = frameData.index;
+      callbacks?.onFrameSent?.(currentIndex + 1, total);
+      if (response.status === "buffering") {
+        callbacks?.onFrameBuffered?.(response.frames_received, response.frames_required);
+      } else if (response.status === "complete") {
+        finalResponse = response;
+        break;
+      }
+    }
+    if (!finalResponse) {
+      throw new LivenessApiError(
+        "Streaming did not complete after all frames sent",
+        "stream_incomplete",
+        400
+      );
+    }
+    return toLivenessResultFromStream(finalResponse);
+  }
   // ===========================================================================
   // Verify Endpoint (Spatial Features)
   // ===========================================================================
@@ -519,6 +646,7 @@ var FrameQueue = class {
 
 // src/types/models.ts
 var MODEL_CONFIGS = {
+  // Standard fast-check models
   "10": {
     type: "10",
     minFrames: 10,
@@ -536,6 +664,104 @@ var MODEL_CONFIGS = {
     minFrames: 250,
     recommendedFrames: 250,
     description: "High-accuracy model - 250 frames, best accuracy"
+  },
+  // Hybrid V2 models with physiological features
+  "hybrid-v2-10": {
+    type: "hybrid-v2-10",
+    minFrames: 10,
+    recommendedFrames: 10,
+    description: "Hybrid V2 10-frame model with physio features"
+  },
+  "hybrid-v2-30": {
+    type: "hybrid-v2-30",
+    minFrames: 30,
+    recommendedFrames: 30,
+    description: "Hybrid V2 30-frame model with physio features"
+  },
+  "hybrid-v2-50": {
+    type: "hybrid-v2-50",
+    minFrames: 50,
+    recommendedFrames: 50,
+    description: "Hybrid V2 50-frame model with physio features"
+  },
+  "hybrid-v2-60": {
+    type: "hybrid-v2-60",
+    minFrames: 60,
+    recommendedFrames: 60,
+    description: "Hybrid V2 60-frame model with physio features"
+  },
+  "hybrid-v2-90": {
+    type: "hybrid-v2-90",
+    minFrames: 90,
+    recommendedFrames: 90,
+    description: "Hybrid V2 90-frame model with physio features"
+  },
+  "hybrid-v2-100": {
+    type: "hybrid-v2-100",
+    minFrames: 100,
+    recommendedFrames: 100,
+    description: "Hybrid V2 100-frame model with physio features"
+  },
+  "hybrid-v2-125": {
+    type: "hybrid-v2-125",
+    minFrames: 125,
+    recommendedFrames: 125,
+    description: "Hybrid V2 125-frame model with physio features"
+  },
+  "hybrid-v2-150": {
+    type: "hybrid-v2-150",
+    minFrames: 150,
+    recommendedFrames: 150,
+    description: "Hybrid V2 150-frame model with physio features"
+  },
+  "hybrid-v2-250": {
+    type: "hybrid-v2-250",
+    minFrames: 250,
+    recommendedFrames: 250,
+    description: "Hybrid V2 250-frame model with physio features"
+  },
+  // Mixed models (FastLivenessDetector with mixed-trained weights)
+  "mixed-10": {
+    type: "mixed-10",
+    minFrames: 10,
+    recommendedFrames: 10,
+    description: "Mixed 10-frame model"
+  },
+  "mixed-30": {
+    type: "mixed-30",
+    minFrames: 30,
+    recommendedFrames: 30,
+    description: "Mixed 30-frame model"
+  },
+  "mixed-60": {
+    type: "mixed-60",
+    minFrames: 60,
+    recommendedFrames: 60,
+    description: "Mixed 60-frame model"
+  },
+  "mixed-90": {
+    type: "mixed-90",
+    minFrames: 90,
+    recommendedFrames: 90,
+    description: "Mixed 90-frame model"
+  },
+  "mixed-120": {
+    type: "mixed-120",
+    minFrames: 120,
+    recommendedFrames: 120,
+    description: "Mixed 120-frame model"
+  },
+  "mixed-150": {
+    type: "mixed-150",
+    minFrames: 150,
+    recommendedFrames: 150,
+    description: "Mixed 150-frame model"
+  },
+  "mixed-250": {
+    type: "mixed-250",
+    minFrames: 250,
+    recommendedFrames: 250,
+    description: "Mixed 250-frame model"
   }
 };
 var HYBRID_MODEL_CONFIGS = {
@@ -1173,6 +1399,7 @@ export {
   toFrameData,
   toHybridFrameData,
   toLivenessResult,
+  toLivenessResultFromStream,
   validateApiKey,
   validateFrameCount,
   validateFrameData,

package/package.json

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