@moveris/shared 3.8.6 → 3.10.0

package/README.md

@@ -56,6 +56,8 @@ const client = new LivenessClient(config: LivenessClientConfig);
 | `enableRetry`                 | `boolean`                     | `true`                      | Enable automatic retry with exponential backoff                                                  |
 | `customFetch`                 | `typeof fetch`                | `fetch`                     | Custom fetch implementation (for React Native)                                                   |
 | `deviceIntelligenceOverrides` | `DeviceIntelligenceOverrides` | -                           | Static overrides merged into every `device_intelligence` payload (e.g. `{ vpn_detected: true }`) |
+| `consumer`                    | `ConsumerContext`             | -                           | Consumer app context — traces which app and environment submitted each transaction               |
+| `trackClientTime`             | `boolean`                     | `false`                     | When true, fires a fire-and-forget PATCH after each verdict to record end-to-end client duration |
 
 #### Methods
 
@@ -152,6 +154,17 @@ const result = await client.hybrid50(frames, { fps: 30 });
 const result = await client.hybrid150(frames, { fps: 30 });
 ```
 
+##### `postClientTime(sessionId, clientTime)`
+
+Fire-and-forget PATCH to record end-to-end client duration for a completed verification session. No-op when `trackClientTime` is `false`. Swallows all errors silently.
+
+```typescript
+// Called automatically by useLiveness / CognitoCheckWidget after the verdict.
+// Approach B consumers can call it manually after onComplete resolves:
+const elapsed = Math.round(performance.now() - startTime);
+void client.postClientTime(result.sessionId, elapsed);
+```
+
 ##### `updateDeviceIntelligenceOverrides(overrides)`
 
 Merge additional fields into the cached device intelligence payload. Call this after construction to inject data only available at runtime (e.g. camera specs, VPN detection results). Merges shallowly — later calls are merged on top of earlier ones.
@@ -254,6 +267,27 @@ Deprecated models (v1 — sunset 2026-09-01):
 | `'mixed-150'` | 150    | —                |
 | `'mixed-250'` | 250    | —                |
 
+#### ConsumerContext
+
+Consumer app context attached to every verification request for transaction tracing.
+
+```typescript
+interface ConsumerContext {
+  url: string; // The consumer app's URL
+  env: 'development' | 'staging' | 'production'; // Consumer app environment
+}
+```
+
+Pass it at client construction — it is included in every subsequent request automatically:
+
+```typescript
+const client = new LivenessClient({
+  apiKey: 'mv_your_api_key',
+  consumer: { url: 'https://app.example.com', env: 'production' },
+  trackClientTime: true, // optional — fires postClientTime after each verdict
+});
+```
+
 #### FrameSource
 
 Source of the captured frames.
@@ -308,6 +342,7 @@ interface LivenessResult {
   processingMs: number; // Server processing time
   framesProcessed: number; // Number of frames analyzed
   deprecation?: DeprecationInfo; // Present when X-Moveris-Model-Resolved header is returned
+  clientTime?: number; // End-to-end client duration in ms (start() to verdict received)
 }
 ```
 
@@ -856,6 +891,7 @@ import type {
   Verdict,
   CapturedFrame,
   CropData,
+  ConsumerContext,
   LivenessClientConfig,
   DetectionResult,
   DetectionSummary,

package/dist/index.d.mts

@@ -26,6 +26,13 @@ type DeviceIntelligenceOverrides = {
 };
 
 type Verdict = 'live' | 'fake' | 'inconclusive';
+type MetadataScalar = string | number | boolean | null;
+type ExtraMetadataValue = MetadataScalar | Record<string, MetadataScalar>;
+type ExtraMetadata = Record<string, ExtraMetadataValue>;
+interface ConsumerContext {
+    url: string;
+    env: 'development' | 'staging' | 'production';
+}
 interface ModelEntry {
     id: string;
     label: string;
@@ -68,6 +75,9 @@ interface FastCheckRequest {
     frame_count?: number;
     warnings?: string[];
     device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
 }
 interface FastCheckCropsRequest {
     session_id: string;
@@ -76,6 +86,9 @@ interface FastCheckCropsRequest {
     crops: CropData[];
     frame_count?: number;
     device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
 }
 interface VerifyRequest {
     session_id: string;
@@ -108,6 +121,9 @@ interface FastCheckStreamRequest {
     frame_count?: number;
     warnings?: string[];
     device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
 }
 interface FastCheckResponse {
     verdict: Verdict | null;
@@ -208,6 +224,7 @@ interface LivenessResult {
     framesProcessed: number;
     warnings?: string[];
     deprecation?: DeprecationInfo;
+    clientTime?: number;
 }
 type LivenessState = 'idle' | 'capturing' | 'uploading' | 'processing' | 'complete' | 'error';
 interface LivenessConfig {
@@ -567,6 +584,9 @@ interface LivenessClientConfig {
     enableRetry?: boolean;
     customFetch?: typeof fetch;
     deviceIntelligenceOverrides?: DeviceIntelligenceOverrides;
+    consumer?: ConsumerContext;
+    trackClientTime?: boolean;
+    extraMetadata?: ExtraMetadata;
 }
 declare class LivenessApiError extends Error {
     readonly code: string;
@@ -587,12 +607,16 @@ declare class LivenessClient {
     private readonly timeout;
     private readonly enableRetry;
     private readonly fetchFn;
+    private readonly consumer;
+    private readonly trackClientTime;
+    private readonly extraMetadata;
     private diCollected;
     private diCollecting;
     private diOverrides;
     constructor(config: LivenessClientConfig);
     updateDeviceIntelligenceOverrides(partial: DeviceIntelligenceOverrides): void;
     private getDeviceIntelligence;
+    private buildMetadata;
     private applyDiOverrides;
     private request;
     private requestRaw;
@@ -607,6 +631,7 @@ declare class LivenessClient {
     health(): Promise<HealthResponse>;
     getModels(): Promise<ModelEntry[]>;
     queueStats(): Promise<QueueStatsResponse>;
+    postClientTime(sessionId: string, clientTime: number): Promise<void>;
     fastCheck(frames: CapturedFrame[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
@@ -728,6 +753,7 @@ declare const API_PATHS: {
     readonly hybrid150: "/api/v1/hybrid-150";
     readonly jobResult: "/api/v1/result";
     readonly queueStats: "/api/v1/queue/stats";
+    readonly sessions: "/api/v1/sessions";
 };
 declare const RETRY_CONFIG: {
     readonly maxAttempts: 3;
@@ -942,4 +968,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 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 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, 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 };

package/dist/index.d.ts

@@ -26,6 +26,13 @@ type DeviceIntelligenceOverrides = {
 };
 
 type Verdict = 'live' | 'fake' | 'inconclusive';
+type MetadataScalar = string | number | boolean | null;
+type ExtraMetadataValue = MetadataScalar | Record<string, MetadataScalar>;
+type ExtraMetadata = Record<string, ExtraMetadataValue>;
+interface ConsumerContext {
+    url: string;
+    env: 'development' | 'staging' | 'production';
+}
 interface ModelEntry {
     id: string;
     label: string;
@@ -68,6 +75,9 @@ interface FastCheckRequest {
     frame_count?: number;
     warnings?: string[];
     device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
 }
 interface FastCheckCropsRequest {
     session_id: string;
@@ -76,6 +86,9 @@ interface FastCheckCropsRequest {
     crops: CropData[];
     frame_count?: number;
     device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
 }
 interface VerifyRequest {
     session_id: string;
@@ -108,6 +121,9 @@ interface FastCheckStreamRequest {
     frame_count?: number;
     warnings?: string[];
     device_intelligence?: DeviceIntelligence;
+    metadata?: {
+        consumer?: ConsumerContext;
+    } | null;
 }
 interface FastCheckResponse {
     verdict: Verdict | null;
@@ -208,6 +224,7 @@ interface LivenessResult {
     framesProcessed: number;
     warnings?: string[];
     deprecation?: DeprecationInfo;
+    clientTime?: number;
 }
 type LivenessState = 'idle' | 'capturing' | 'uploading' | 'processing' | 'complete' | 'error';
 interface LivenessConfig {
@@ -567,6 +584,9 @@ interface LivenessClientConfig {
     enableRetry?: boolean;
     customFetch?: typeof fetch;
     deviceIntelligenceOverrides?: DeviceIntelligenceOverrides;
+    consumer?: ConsumerContext;
+    trackClientTime?: boolean;
+    extraMetadata?: ExtraMetadata;
 }
 declare class LivenessApiError extends Error {
     readonly code: string;
@@ -587,12 +607,16 @@ declare class LivenessClient {
     private readonly timeout;
     private readonly enableRetry;
     private readonly fetchFn;
+    private readonly consumer;
+    private readonly trackClientTime;
+    private readonly extraMetadata;
     private diCollected;
     private diCollecting;
     private diOverrides;
     constructor(config: LivenessClientConfig);
     updateDeviceIntelligenceOverrides(partial: DeviceIntelligenceOverrides): void;
     private getDeviceIntelligence;
+    private buildMetadata;
     private applyDiOverrides;
     private request;
     private requestRaw;
@@ -607,6 +631,7 @@ declare class LivenessClient {
     health(): Promise<HealthResponse>;
     getModels(): Promise<ModelEntry[]>;
     queueStats(): Promise<QueueStatsResponse>;
+    postClientTime(sessionId: string, clientTime: number): Promise<void>;
     fastCheck(frames: CapturedFrame[], options?: {
         sessionId?: string;
         model?: FastCheckModel;
@@ -728,6 +753,7 @@ declare const API_PATHS: {
     readonly hybrid150: "/api/v1/hybrid-150";
     readonly jobResult: "/api/v1/result";
     readonly queueStats: "/api/v1/queue/stats";
+    readonly sessions: "/api/v1/sessions";
 };
 declare const RETRY_CONFIG: {
     readonly maxAttempts: 3;
@@ -942,4 +968,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 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 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, 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 };

package/dist/index.js

@@ -158,7 +158,8 @@ var API_PATHS = {
   hybrid50: "/api/v1/hybrid-50",
   hybrid150: "/api/v1/hybrid-150",
   jobResult: "/api/v1/result",
-  queueStats: "/api/v1/queue/stats"
+  queueStats: "/api/v1/queue/stats",
+  sessions: "/api/v1/sessions"
 };
 var RETRY_CONFIG = {
   maxAttempts: 3,
@@ -238,7 +239,7 @@ async function sleep(ms) {
 }
 
 // package.json
-var version = "3.8.6";
+var version = "3.10.0";
 
 // src/utils/deviceIntelligence.ts
 var IPINFO_URL = "https://ipinfo.io/json";
@@ -386,6 +387,9 @@ var LivenessClient = class _LivenessClient {
     this.enableRetry = config.enableRetry ?? true;
     this.fetchFn = config.customFetch ?? (typeof window !== "undefined" ? fetch.bind(window) : fetch);
     this.diOverrides = { ...config.deviceIntelligenceOverrides };
+    this.consumer = config.consumer;
+    this.trackClientTime = config.trackClientTime ?? false;
+    this.extraMetadata = config.extraMetadata;
   }
   /**
    * Merge additional device intelligence overrides into the existing set.
@@ -419,6 +423,13 @@ var LivenessClient = class _LivenessClient {
     await this.diCollecting;
     return this.diCollected ? this.applyDiOverrides(this.diCollected) : null;
   }
+  buildMetadata() {
+    const meta = {
+      ...this.consumer ? { consumer: this.consumer } : {},
+      ...this.extraMetadata
+    };
+    return Object.keys(meta).length > 0 ? meta : void 0;
+  }
   applyDiOverrides(collected) {
     const ov = this.diOverrides;
     return {
@@ -634,6 +645,25 @@ var LivenessClient = class _LivenessClient {
   async queueStats() {
     return this.request(API_PATHS.queueStats);
   }
+  /**
+   * Post end-to-end client duration for a completed verification session.
+   * Fire-and-forget — swallows all errors, no retry.
+   * No-op when `trackClientTime` is false (default).
+   */
+  async postClientTime(sessionId, clientTime) {
+    if (!this.trackClientTime) return;
+    try {
+      await this.fetchFn(`${this.baseUrl}${API_PATHS.sessions}/${sessionId}/client-time`, {
+        method: "PATCH",
+        headers: {
+          "Content-Type": "application/json",
+          [AUTH_CONFIG.apiKeyHeader]: this.apiKey
+        },
+        body: JSON.stringify({ client_time: clientTime })
+      });
+    } catch {
+    }
+  }
   // ===========================================================================
   // Fast Check Endpoints
   // ===========================================================================
@@ -654,7 +684,8 @@ var LivenessClient = class _LivenessClient {
       frames: toFrameData(frames),
       ...options.frameCount != null ? { frame_count: options.frameCount } : {},
       ...options.warnings?.length ? { warnings: options.warnings } : {},
-      ...di ? { device_intelligence: di } : {}
+      ...di ? { device_intelligence: di } : {},
+      ...this.buildMetadata() ? { metadata: this.buildMetadata() } : {}
     };
     const { data: response, headers } = await this.requestWithRetryRaw(
       API_PATHS.fastCheck,
@@ -691,7 +722,8 @@ var LivenessClient = class _LivenessClient {
       ...options.frameCount != null ? { frame_count: options.frameCount } : {},
       ...options.warnings?.length ? { warnings: options.warnings } : {},
       ...options.bgSegmentation !== void 0 ? { bg_segmentation: options.bgSegmentation } : {},
-      ...di ? { device_intelligence: di } : {}
+      ...di ? { device_intelligence: di } : {},
+      ...this.buildMetadata() ? { metadata: this.buildMetadata() } : {}
     };
     const { data: response, headers } = await this.requestWithRetryRaw(
       API_PATHS.fastCheckCrops,
@@ -755,7 +787,8 @@ var LivenessClient = class _LivenessClient {
       frame: frameData,
       ...options.frameCount != null ? { frame_count: options.frameCount } : {},
       ...options.warnings?.length ? { warnings: options.warnings } : {},
-      ...di ? { device_intelligence: di } : {}
+      ...di ? { device_intelligence: di } : {},
+      ...this.buildMetadata() ? { metadata: this.buildMetadata() } : {}
     };
     return this.requestWithRetry(API_PATHS.fastCheckStream, {
       method: "POST",

package/dist/index.mjs

@@ -16,7 +16,8 @@ var API_PATHS = {
   hybrid50: "/api/v1/hybrid-50",
   hybrid150: "/api/v1/hybrid-150",
   jobResult: "/api/v1/result",
-  queueStats: "/api/v1/queue/stats"
+  queueStats: "/api/v1/queue/stats",
+  sessions: "/api/v1/sessions"
 };
 var RETRY_CONFIG = {
   maxAttempts: 3,
@@ -96,7 +97,7 @@ async function sleep(ms) {
 }
 
 // package.json
-var version = "3.8.6";
+var version = "3.10.0";
 
 // src/utils/deviceIntelligence.ts
 var IPINFO_URL = "https://ipinfo.io/json";
@@ -244,6 +245,9 @@ var LivenessClient = class _LivenessClient {
     this.enableRetry = config.enableRetry ?? true;
     this.fetchFn = config.customFetch ?? (typeof window !== "undefined" ? fetch.bind(window) : fetch);
     this.diOverrides = { ...config.deviceIntelligenceOverrides };
+    this.consumer = config.consumer;
+    this.trackClientTime = config.trackClientTime ?? false;
+    this.extraMetadata = config.extraMetadata;
   }
   /**
    * Merge additional device intelligence overrides into the existing set.
@@ -277,6 +281,13 @@ var LivenessClient = class _LivenessClient {
     await this.diCollecting;
     return this.diCollected ? this.applyDiOverrides(this.diCollected) : null;
   }
+  buildMetadata() {
+    const meta = {
+      ...this.consumer ? { consumer: this.consumer } : {},
+      ...this.extraMetadata
+    };
+    return Object.keys(meta).length > 0 ? meta : void 0;
+  }
   applyDiOverrides(collected) {
     const ov = this.diOverrides;
     return {
@@ -492,6 +503,25 @@ var LivenessClient = class _LivenessClient {
   async queueStats() {
     return this.request(API_PATHS.queueStats);
   }
+  /**
+   * Post end-to-end client duration for a completed verification session.
+   * Fire-and-forget — swallows all errors, no retry.
+   * No-op when `trackClientTime` is false (default).
+   */
+  async postClientTime(sessionId, clientTime) {
+    if (!this.trackClientTime) return;
+    try {
+      await this.fetchFn(`${this.baseUrl}${API_PATHS.sessions}/${sessionId}/client-time`, {
+        method: "PATCH",
+        headers: {
+          "Content-Type": "application/json",
+          [AUTH_CONFIG.apiKeyHeader]: this.apiKey
+        },
+        body: JSON.stringify({ client_time: clientTime })
+      });
+    } catch {
+    }
+  }
   // ===========================================================================
   // Fast Check Endpoints
   // ===========================================================================
@@ -512,7 +542,8 @@ var LivenessClient = class _LivenessClient {
       frames: toFrameData(frames),
       ...options.frameCount != null ? { frame_count: options.frameCount } : {},
       ...options.warnings?.length ? { warnings: options.warnings } : {},
-      ...di ? { device_intelligence: di } : {}
+      ...di ? { device_intelligence: di } : {},
+      ...this.buildMetadata() ? { metadata: this.buildMetadata() } : {}
     };
     const { data: response, headers } = await this.requestWithRetryRaw(
       API_PATHS.fastCheck,
@@ -549,7 +580,8 @@ var LivenessClient = class _LivenessClient {
       ...options.frameCount != null ? { frame_count: options.frameCount } : {},
       ...options.warnings?.length ? { warnings: options.warnings } : {},
       ...options.bgSegmentation !== void 0 ? { bg_segmentation: options.bgSegmentation } : {},
-      ...di ? { device_intelligence: di } : {}
+      ...di ? { device_intelligence: di } : {},
+      ...this.buildMetadata() ? { metadata: this.buildMetadata() } : {}
     };
     const { data: response, headers } = await this.requestWithRetryRaw(
       API_PATHS.fastCheckCrops,
@@ -613,7 +645,8 @@ var LivenessClient = class _LivenessClient {
       frame: frameData,
       ...options.frameCount != null ? { frame_count: options.frameCount } : {},
       ...options.warnings?.length ? { warnings: options.warnings } : {},
-      ...di ? { device_intelligence: di } : {}
+      ...di ? { device_intelligence: di } : {},
+      ...this.buildMetadata() ? { metadata: this.buildMetadata() } : {}
     };
     return this.requestWithRetry(API_PATHS.fastCheckStream, {
       method: "POST",

package/package.json

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