face-validator-sdk 1.3.0 → 1.3.2

package/dist/types/core/FaceValidator.d.ts

@@ -15,11 +15,29 @@ export declare class FaceValidator {
     private lastDetection;
     private stableSince;
     private isCapturing;
+    private containerElement;
+    private statusElement;
+    private uiRootElement;
+    private cameraStream;
+    private cameraReadyPromise;
+    private managedElements;
+    private managedCamera;
+    private injectedStyleElement;
     constructor(options: FaceValidatorOptions);
     private resolveOptions;
+    private setupElements;
+    private resolveContainer;
+    private ensureDefaultUI;
+    private attachMediaElements;
+    private injectDefaultStyles;
+    private applyMirrorStyles;
     private init;
     private getMessageForStatus;
     private setStatus;
+    private updateStatusUI;
+    private getStatusClass;
+    private initCamera;
+    private waitForVideoReady;
     private startDetectionLoop;
     /**
      * Estima bounding box a partir dos landmarks (MediaPipe não fornece bbox diretamente).
@@ -27,4 +45,7 @@ export declare class FaceValidator {
     private estimateBoundingBox;
     private captureImage;
     stop(): void;
+    destroy(): void;
+    private stopCamera;
+    private getVideoElement;
 }

package/dist/types/core/types.d.ts

@@ -19,10 +19,20 @@ export declare enum ValidationStatus {
 }
 export type SupportedLocale = 'pt-BR' | 'en' | 'es';
 export interface FaceValidatorOptions {
+    /** Optional container element or selector to auto-render UI and media elements. */
+    container?: HTMLElement | string;
+    /** Optional UI mode. Default: 'default'. */
+    ui?: 'default' | 'none';
+    /** Auto-start camera if SDK manages the video element. Default: true. */
+    autoStart?: boolean;
+    /** Mirror preview horizontally. Default: true. */
+    mirror?: boolean;
+    /** Optional video constraints passed to getUserMedia. */
+    videoConstraints?: MediaTrackConstraints;
     /** Optional path to MediaPipe models WASM files. Default: auto-detected from CDN */
     modelPath?: string;
     /** Video element for the camera stream. */
-    videoElement: HTMLVideoElement;
+    videoElement?: HTMLVideoElement;
     /** Optional canvas for visual feedback (e.g. face outline). */
     overlayCanvasElement?: HTMLCanvasElement | null;
     /** Optional video width. Default: 640 */
@@ -34,11 +44,11 @@ export interface FaceValidatorOptions {
     /** Optional override for specific status messages. */
     customMessages?: Partial<Record<ValidationStatus, string>>;
     /** Callback on each validation status update. */
-    onStatusUpdate: (status: ValidationStatus, message: string) => void;
+    onStatusUpdate?: (status: ValidationStatus, message: string) => void;
     /** Callback when selfie is successfully captured (receives Blob). */
-    onCaptureSuccess: (imageBlob: Blob) => void;
+    onCaptureSuccess?: (imageBlob: Blob) => void;
     /** Callback on error. */
-    onError: (errorType: ValidationStatus, error: Error) => void;
+    onError?: (errorType: ValidationStatus, error: Error) => void;
     /** Optional min detection confidence (0–1). Default: 0.5 */
     minDetectionConfidence?: number;
     /** Optional min brightness (0–255). Default: 70 */

package/dist/types/types.d.ts

@@ -19,10 +19,20 @@ export declare enum ValidationStatus {
 }
 export type SupportedLocale = 'pt-BR' | 'en' | 'es';
 export interface FaceValidatorOptions {
+    /** Optional container element or selector to auto-render UI and media elements. */
+    container?: HTMLElement | string;
+    /** Optional UI mode. Default: 'default'. */
+    ui?: 'default' | 'none';
+    /** Auto-start camera if SDK manages the video element. Default: true. */
+    autoStart?: boolean;
+    /** Mirror preview horizontally. Default: true. */
+    mirror?: boolean;
+    /** Optional video constraints passed to getUserMedia. */
+    videoConstraints?: MediaTrackConstraints;
     /** Optional path to MediaPipe models WASM files. Default: auto-detected from CDN */
     modelPath?: string;
     /** Video element for the camera stream. */
-    videoElement: HTMLVideoElement;
+    videoElement?: HTMLVideoElement;
     /** Optional canvas for visual feedback (e.g. face outline). */
     overlayCanvasElement?: HTMLCanvasElement | null;
     /** Optional video width. Default: 640 */
@@ -34,11 +44,11 @@ export interface FaceValidatorOptions {
     /** Optional override for specific status messages. */
     customMessages?: Partial<Record<ValidationStatus, string>>;
     /** Callback on each validation status update. */
-    onStatusUpdate: (status: ValidationStatus, message: string) => void;
+    onStatusUpdate?: (status: ValidationStatus, message: string) => void;
     /** Callback when selfie is successfully captured (receives Blob). */
-    onCaptureSuccess: (imageBlob: Blob) => void;
+    onCaptureSuccess?: (imageBlob: Blob) => void;
     /** Callback on error. */
-    onError: (errorType: ValidationStatus, error: Error) => void;
+    onError?: (errorType: ValidationStatus, error: Error) => void;
     /** Optional min detection confidence (0–1). Default: 0.5 */
     minDetectionConfidence?: number;
     /** Optional min brightness (0–255). Default: 70 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "face-validator-sdk",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "Real-time selfie validation SDK with face detection, i18n (pt-BR, en, es). Built on MediaPipe.",
   "main": "dist/face-validator-sdk.cjs.js",
   "module": "dist/face-validator-sdk.esm.js",