@moveris/shared 1.0.2 → 2.1.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;
@@ -180,6 +204,204 @@ interface LivenessCallbacks {
     onStateChange?: OnStateChangeCallback;
 }
 
+interface FaceBoundingBox {
+    originX: number;
+    originY: number;
+    width: number;
+    height: number;
+}
+interface BlurAnalysis {
+    variance: number;
+    isBlurry: boolean;
+    threshold: number;
+}
+interface LightingAnalysis {
+    faceBrightness: number;
+    backgroundBrightness: number;
+    ratio: number;
+    status: 'good' | 'backlit' | 'low_light';
+    warning?: string;
+}
+interface FaceVisibilityResult {
+    visible: boolean;
+    reason?: string;
+}
+interface FaceAlignmentResult {
+    score: number;
+    tooClose: boolean;
+    tooFar: boolean;
+}
+interface OvalRegion {
+    centerX: number;
+    centerY: number;
+    width: number;
+    height: number;
+}
+interface FaceInOvalResult {
+    isInside: boolean;
+    centerInOval: boolean;
+    sizeMatch: boolean;
+    feedback?: string;
+}
+interface FrameQualityResult {
+    passed: boolean;
+    blur?: BlurAnalysis;
+    lighting?: LightingAnalysis;
+    visibility?: FaceVisibilityResult;
+    alignment?: FaceAlignmentResult;
+    rejectionReason?: 'blur' | 'backlit' | 'low_light' | 'partial_face' | 'no_face' | 'too_close' | 'too_far' | 'misaligned';
+}
+declare const DEFAULT_BLUR_THRESHOLD = 100;
+declare const BLUR_THRESHOLD_MOBILE = 150;
+declare const BACKLIT_RATIO_THRESHOLD = 0.6;
+declare const LOW_LIGHT_THRESHOLD = 50;
+declare const MIN_FACE_TOP_MARGIN = 0.1;
+declare const MIN_FACE_BOTTOM_MARGIN = 0.08;
+declare const MIN_FACE_SIDE_MARGIN = 0.05;
+declare const MIN_CAPTURE_ALIGNMENT = 0.6;
+declare const HIGH_ALIGNMENT = 0.85;
+declare const GOOD_ALIGNMENT = 0.5;
+declare const IDEAL_CROP_MULTIPLIER = 2;
+declare const MIN_CROP_MULTIPLIER = 1.8;
+declare const MAX_CROP_MULTIPLIER = 2.5;
+declare const FACE_CENTER_VERTICAL_OFFSET = 0.05;
+declare const MIN_FACE_RATIO = 0.036;
+declare const MAX_FACE_RATIO = 0.7;
+declare const FACE_CROP_OUTPUT_SIZE = 224;
+declare const MAX_FACE_PERCENTAGE_IN_CROP = 0.6;
+declare const TARGET_FACE_PERCENTAGE_IN_CROP = 0.5;
+declare function analyzeBlur(grayscalePixels: number[], width: number, height: number, threshold?: number): BlurAnalysis;
+declare function rgbaToGrayscale(rgbaPixels: Uint8ClampedArray | number[]): number[];
+declare function calculateBrightness(rgbaPixels: Uint8ClampedArray | number[]): number;
+declare function analyzeLighting(faceBrightness: number, backgroundBrightness: number): LightingAnalysis;
+declare function isFaceFullyVisible(boundingBox: FaceBoundingBox, frameWidth: number, frameHeight: number): FaceVisibilityResult;
+declare const DEFAULT_OVAL_REGION: OvalRegion;
+declare function isFaceInOval(faceBox: FaceBoundingBox, frameWidth: number, frameHeight: number, oval?: OvalRegion, tolerance?: number): FaceInOvalResult;
+declare function calculateFaceAlignment(boundingBox: FaceBoundingBox, frameWidth: number, frameHeight: number): FaceAlignmentResult;
+declare function calculateAdaptiveCropMultiplier(faceBox: FaceBoundingBox, frameWidth: number, frameHeight: number): number;
+declare function isFaceCropFullyInFrame(faceBox: FaceBoundingBox, frameWidth: number, frameHeight: number): boolean;
+declare function calculateFaceCropRegion(faceBox: FaceBoundingBox, frameWidth: number, frameHeight: number): {
+    x: number;
+    y: number;
+    size: number;
+};
+declare function checkFrameQuality(options: {
+    faceBox?: FaceBoundingBox;
+    frameWidth: number;
+    frameHeight: number;
+    blurAnalysis?: BlurAnalysis;
+    lightingAnalysis?: LightingAnalysis;
+    minAlignment?: number;
+}): FrameQualityResult;
+declare class BaseFrameCollector {
+    protected frames: CapturedFrame[];
+    protected maxFrames: number;
+    protected startTime: number;
+    constructor(maxFrames?: number);
+    setMaxFrames(max: number): void;
+    addFrame(frame: CapturedFrame): void;
+    getFrames(): CapturedFrame[];
+    getCount(): number;
+    isComplete(): boolean;
+    reset(): void;
+    getStartTime(): number;
+    getNextIndex(): number;
+}
+
+interface FaceLandmarkPoint {
+    x: number;
+    y: number;
+    z: number;
+}
+interface LandmarkValidationResult {
+    valid: boolean;
+    message?: string;
+}
+declare const LANDMARK_INDEX: {
+    readonly NOSE_TIP: 1;
+    readonly UPPER_LIP: 13;
+    readonly LOWER_LIP: 14;
+};
+declare const LANDMARK_MIN_BOUND = 0.1;
+declare const LANDMARK_MAX_BOUND = 0.9;
+declare const MIN_LANDMARK_COUNT = 15;
+declare function validateFaceLandmarks(landmarks: FaceLandmarkPoint[] | undefined): LandmarkValidationResult;
+
+interface DetectionResult {
+    type: string;
+    passed: boolean;
+    confidence: number;
+    message?: string;
+    metadata?: Record<string, unknown>;
+}
+interface DetectorConfig {
+    enabled: boolean;
+    minConfidence?: number;
+}
+interface DetectionSummary {
+    allPassed: boolean;
+    results: Map<string, DetectionResult>;
+    faceBox?: FaceBoundingBox;
+    faceLandmarks?: FaceLandmarkPoint[];
+    warnings: string[];
+}
+interface HeadPose {
+    yawDeg: number;
+    pitchDeg: number;
+    rollDeg: number;
+}
+interface GazeThresholds {
+    maxYaw: number;
+    maxPitch: number;
+}
+declare const DEFAULT_GAZE_THRESHOLDS: GazeThresholds;
+interface HandOcclusionConfig {
+    faceExpansionFactor: number;
+    minLandmarksForOcclusion: number;
+    faceBoxExpiryMs: number;
+    centerRegion: number;
+}
+declare const DEFAULT_HAND_OCCLUSION_CONFIG: HandOcclusionConfig;
+interface FaceDetectionTiers {
+    primaryConfidence: number;
+    secondaryConfidence: number;
+}
+declare const DEFAULT_FACE_DETECTION_TIERS: FaceDetectionTiers;
+interface VideoFrameMetadata {
+    presentationTime: number;
+    expectedDisplayTime: number;
+    width: number;
+    height: number;
+    mediaTime: number;
+    presentedFrames: number;
+    processingDuration?: number;
+}
+interface StabilizationProgress {
+    elapsed: number;
+    stableFrameCount: number;
+    requiredFrames: number;
+    greenMean: number;
+    greenDelta: number | null;
+    threshold: number;
+    isStable: boolean;
+    progress: number;
+}
+interface StabilizationResult {
+    success: boolean;
+    elapsed: number;
+    finalGreenMean: number;
+    stableFrameCount: number;
+    message: string;
+}
+interface StabilizerConfig {
+    stabilityThreshold: number;
+    requiredStableFrames: number;
+    maxWaitMs: number;
+    checkIntervalMs: number;
+    sampleSize: number;
+}
+declare const DEFAULT_STABILIZER_CONFIG: StabilizerConfig;
+
 interface LivenessClientConfig {
     baseUrl?: string;
     apiKey: string;
@@ -197,6 +419,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 +442,28 @@ declare class LivenessClient {
         model?: FastCheckModel;
         source?: FrameSource;
     }): Promise<LivenessResult>;
+    streamFrame(frame: CapturedFrame, options: {
+        sessionId: string;
+        model?: FastCheckModel;
+        source?: FrameSource;
+    }): Promise<FastCheckStreamResponse>;
+    private sendStreamFrameInternal;
+    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 +529,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";
@@ -437,108 +683,4 @@ interface RetryOptions {
 declare function retryWithBackoff<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
 declare function sleep(ms: number): Promise<void>;
 
-interface FaceBoundingBox {
-    originX: number;
-    originY: number;
-    width: number;
-    height: number;
-}
-interface BlurAnalysis {
-    variance: number;
-    isBlurry: boolean;
-    threshold: number;
-}
-interface LightingAnalysis {
-    faceBrightness: number;
-    backgroundBrightness: number;
-    ratio: number;
-    status: 'good' | 'backlit' | 'low_light';
-    warning?: string;
-}
-interface FaceVisibilityResult {
-    visible: boolean;
-    reason?: string;
-}
-interface FaceAlignmentResult {
-    score: number;
-    tooClose: boolean;
-    tooFar: boolean;
-}
-interface OvalRegion {
-    centerX: number;
-    centerY: number;
-    width: number;
-    height: number;
-}
-interface FaceInOvalResult {
-    isInside: boolean;
-    centerInOval: boolean;
-    sizeMatch: boolean;
-    feedback?: string;
-}
-interface FrameQualityResult {
-    passed: boolean;
-    blur?: BlurAnalysis;
-    lighting?: LightingAnalysis;
-    visibility?: FaceVisibilityResult;
-    alignment?: FaceAlignmentResult;
-    rejectionReason?: 'blur' | 'backlit' | 'low_light' | 'partial_face' | 'no_face' | 'too_close' | 'too_far' | 'misaligned';
-}
-declare const DEFAULT_BLUR_THRESHOLD = 100;
-declare const BLUR_THRESHOLD_MOBILE = 150;
-declare const BACKLIT_RATIO_THRESHOLD = 0.6;
-declare const LOW_LIGHT_THRESHOLD = 50;
-declare const MIN_FACE_TOP_MARGIN = 0.1;
-declare const MIN_FACE_BOTTOM_MARGIN = 0.08;
-declare const MIN_FACE_SIDE_MARGIN = 0.05;
-declare const MIN_CAPTURE_ALIGNMENT = 0.6;
-declare const HIGH_ALIGNMENT = 0.85;
-declare const GOOD_ALIGNMENT = 0.5;
-declare const IDEAL_CROP_MULTIPLIER = 3.33;
-declare const MIN_CROP_MULTIPLIER = 1.5;
-declare const MAX_CROP_MULTIPLIER = 4;
-declare const FACE_CENTER_VERTICAL_OFFSET = 0.15;
-declare const MIN_FACE_RATIO = 0.03;
-declare const MAX_FACE_RATIO = 0.7;
-declare const FACE_CROP_OUTPUT_SIZE = 224;
-declare const MAX_FACE_PERCENTAGE_IN_CROP = 0.5;
-declare const TARGET_FACE_PERCENTAGE_IN_CROP = 0.3;
-declare function analyzeBlur(grayscalePixels: number[], width: number, height: number, threshold?: number): BlurAnalysis;
-declare function rgbaToGrayscale(rgbaPixels: Uint8ClampedArray | number[]): number[];
-declare function calculateBrightness(rgbaPixels: Uint8ClampedArray | number[]): number;
-declare function analyzeLighting(faceBrightness: number, backgroundBrightness: number): LightingAnalysis;
-declare function isFaceFullyVisible(boundingBox: FaceBoundingBox, frameWidth: number, frameHeight: number): FaceVisibilityResult;
-declare const DEFAULT_OVAL_REGION: OvalRegion;
-declare function isFaceInOval(faceBox: FaceBoundingBox, frameWidth: number, frameHeight: number, oval?: OvalRegion, tolerance?: number): FaceInOvalResult;
-declare function calculateFaceAlignment(boundingBox: FaceBoundingBox, frameWidth: number, frameHeight: number): FaceAlignmentResult;
-declare function calculateAdaptiveCropMultiplier(faceBox: FaceBoundingBox, frameWidth: number, frameHeight: number): number;
-declare function isFaceCropFullyInFrame(faceBox: FaceBoundingBox, frameWidth: number, frameHeight: number): boolean;
-declare function calculateFaceCropRegion(faceBox: FaceBoundingBox, frameWidth: number, frameHeight: number): {
-    x: number;
-    y: number;
-    size: number;
-};
-declare function checkFrameQuality(options: {
-    faceBox?: FaceBoundingBox;
-    frameWidth: number;
-    frameHeight: number;
-    blurAnalysis?: BlurAnalysis;
-    lightingAnalysis?: LightingAnalysis;
-    minAlignment?: number;
-}): FrameQualityResult;
-declare class BaseFrameCollector {
-    protected frames: CapturedFrame[];
-    protected maxFrames: number;
-    protected startTime: number;
-    constructor(maxFrames?: number);
-    setMaxFrames(max: number): void;
-    addFrame(frame: CapturedFrame): void;
-    getFrames(): CapturedFrame[];
-    getCount(): number;
-    isComplete(): boolean;
-    reset(): void;
-    getStartTime(): number;
-    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_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, ES_LOCALE, type ErrorResponse, 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 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, MIN_CAPTURE_ALIGNMENT, MIN_CROP_MULTIPLIER, MIN_FACE_BOTTOM_MARGIN, MIN_FACE_RATIO, MIN_FACE_SIDE_MARGIN, MIN_FACE_TOP_MARGIN, MIN_LANDMARK_COUNT, 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 StabilizationProgress, type StabilizationResult, type StabilizerConfig, type StatusMessageKey, type StreamingStatus, TARGET_FACE_PERCENTAGE_IN_CROP, type Verdict, type VerifyRequest, type VerifyResponse, type VideoFrameMetadata, 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, validateFaceLandmarks, validateFrameCount, validateFrameData, validateFrameIndex, validateTimestamp, validateUUID, validateUrl };