@sssxyd/face-liveness-detector 0.3.5 → 0.4.0-alpha.2

package/dist/types/types.d.ts

@@ -1,6 +1,6 @@
 /**
- * Face Detection Engine - Type Definitions
- * Framework-agnostic type definitions for face liveness detection
+ * 人脸检测引擎 - 类型定义
+ * 用于人脸活体检测的框架无关类型定义
  */
 import type { LivenessAction, LivenessActionStatus, DetectionCode, ErrorCode } from './enums';
 export interface FaceFrontalFeatures {
@@ -10,67 +10,68 @@ export interface FaceFrontalFeatures {
 }
 export interface ImageQualityFeatures {
     require_full_face_in_bounds: boolean;
-    use_opencv_enhancement: boolean;
     min_laplacian_variance: number;
     min_gradient_sharpness: number;
     min_blur_score: number;
 }
 /**
- * Main configuration interface for FaceDetectionEngine
- * All settings are flattened as individual properties
+ * 人脸检测引擎的主配置接口
+ * 所有设置都作为单个属性展平
  */
-export interface FaceDetectionEngineConfig {
+export interface FaceDetectionEngineOptions {
     human_model_path?: string;
     tensorflow_wasm_path?: string;
     tensorflow_backend?: 'auto' | 'webgl' | 'wasm';
-    video_width?: number;
-    video_height?: number;
-    video_mirror?: boolean;
-    video_load_timeout?: number;
-    detection_frame_delay?: number;
-    error_retry_delay?: number;
-    silent_detect_count?: number;
-    min_face_ratio?: number;
-    max_face_ratio?: number;
-    min_face_frontal?: number;
-    min_image_quality?: number;
-    min_live_score?: number;
-    min_real_score?: number;
-    suspected_frauds_count?: number;
-    face_frontal_features?: FaceFrontalFeatures;
-    image_quality_features?: ImageQualityFeatures;
-    liveness_action_list?: LivenessAction[];
-    liveness_action_count?: number;
-    liveness_action_randomize?: boolean;
-    liveness_verify_timeout?: number;
-    min_mouth_open_percent?: number;
-}
-export interface ResolvedEngineConfig {
-    human_model_path: string;
-    tensorflow_wasm_path: string;
-    tensorflow_backend: 'auto' | 'webgl' | 'wasm';
-    video_width: number;
-    video_height: number;
-    video_mirror: boolean;
-    video_load_timeout: number;
-    detection_frame_delay: number;
-    error_retry_delay: number;
-    silent_detect_count: number;
-    min_face_ratio: number;
-    max_face_ratio: number;
-    min_face_frontal: number;
-    min_image_quality: number;
-    min_real_score: number;
-    min_live_score: number;
-    suspected_frauds_count: number;
-    face_frontal_features: FaceFrontalFeatures;
-    image_quality_features: ImageQualityFeatures;
-    liveness_action_list: LivenessAction[];
-    liveness_action_count: number;
-    liveness_action_randomize: boolean;
-    liveness_verify_timeout: number;
-    min_mouth_open_percent: number;
+    detect_video_ideal_width?: number;
+    detect_video_ideal_height?: number;
+    detect_video_mirror?: boolean;
+    detect_video_load_timeout?: number;
+    detect_frame_delay?: number;
+    detect_error_retry_delay?: number;
+    collect_min_collect_count?: number;
+    collect_min_face_ratio?: number;
+    collect_max_face_ratio?: number;
+    collect_min_face_frontal?: number;
+    collect_min_image_quality?: number;
+    collect_face_frontal_features?: FaceFrontalFeatures;
+    collect_image_quality_features?: ImageQualityFeatures;
+    action_liveness_action_list?: LivenessAction[];
+    action_liveness_action_count?: number;
+    action_liveness_action_randomize?: boolean;
+    action_liveness_verify_timeout?: number;
+    action_liveness_min_mouth_open_percent?: number;
+    motion_liveness_min_motion_score?: number;
+    motion_liveness_min_keypoint_variance?: number;
+    motion_liveness_frame_buffer_size?: number;
+    motion_liveness_eye_aspect_ratio_threshold?: number;
+    motion_liveness_motion_consistency_threshold?: number;
+    motion_liveness_min_optical_flow_threshold?: number;
+    motion_liveness_strict_photo_detection?: boolean;
+    screen_capture_confidence_threshold?: number;
+    screen_capture_detection_strategy?: 'fastest' | 'fast' | 'accurate' | 'adaptive';
+    screen_moire_pattern_threshold?: number;
+    screen_moire_pattern_enable_dct?: boolean;
+    screen_moire_pattern_enable_edge_detection?: boolean;
+    screen_color_saturation_threshold?: number;
+    screen_color_rgb_correlation_threshold?: number;
+    screen_color_pixel_entropy_threshold?: number;
+    screen_color_gradient_smoothness_threshold?: number;
+    screen_color_confidence_threshold?: number;
+    screen_rgb_low_freq_start_percent?: number;
+    screen_rgb_low_freq_end_percent?: number;
+    screen_rgb_energy_ratio_normalization_factor?: number;
+    screen_rgb_channel_difference_normalization_factor?: number;
+    screen_rgb_energy_score_weight?: number;
+    screen_rgb_asymmetry_score_weight?: number;
+    screen_rgb_difference_factor_weight?: number;
+    screen_rgb_confidence_threshold?: number;
 }
+/**
+ * 与默认值合并后的已解析配置
+ * 所有属性都保证为非 undefined
+ * 在内部用作 mergeOptions() 的返回类型
+ */
+export type ResolvedEngineOptions = Required<FaceDetectionEngineOptions>;
 export interface DetectorLoadedEventData {
     success: boolean;
     error?: string;
@@ -82,19 +83,23 @@ export interface DetectorActionEventData {
     status: LivenessActionStatus;
 }
 /**
- * Face detect info event data
+ * 人脸检测信息事件数据
  */
 export interface DetectorInfoEventData {
     passed: boolean;
     code: DetectionCode;
-    size: number;
-    frontal: number;
-    quality: number;
-    real: number;
-    live: number;
+    message: string;
+    faceCount: number;
+    faceRatio: number;
+    faceFrontal: number;
+    imageQuality: number;
+    motionScore: number;
+    keypointVariance: number;
+    motionType: string;
+    screenConfidence: number;
 }
 /**
- * Action/silent liveness detection completion data
+ * 动作/静默活体检测完成数据
  */
 export interface DetectorFinishEventData {
     success: boolean;
@@ -106,14 +111,14 @@ export interface DetectorFinishEventData {
     bestFaceImage: string | null;
 }
 /**
- * Error data
+ * 错误数据
  */
 export interface DetectorErrorEventData {
     code: ErrorCode;
     message: string;
 }
 /**
- * Debug information data
+ * 调试信息数据
  */
 export interface DetectorDebugEventData {
     level: 'info' | 'warn' | 'error';

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAI7F,MAAM,WAAW,mBAAmB;IAElC,aAAa,EAAE,MAAM,CAAA;IAErB,eAAe,EAAE,MAAM,CAAA;IAEvB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IAEnC,2BAA2B,EAAE,OAAO,CAAA;IAEpC,sBAAsB,EAAE,OAAO,CAAA;IAE/B,sBAAsB,EAAE,MAAM,CAAA;IAE9B,sBAAsB,EAAE,MAAM,CAAA;IAE9B,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IAExC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;IAG9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAG1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,qBAAqB,CAAC,EAAE,mBAAmB,CAAA;IAC3C,sBAAsB,CAAC,EAAE,oBAAoB,CAAA;IAG7C,oBAAoB,CAAC,EAAE,cAAc,EAAE,CAAA;IACvC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,yBAAyB,CAAC,EAAE,OAAO,CAAA;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAEhC;AAED,MAAM,WAAW,oBAAoB;IAEnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,kBAAkB,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;IAG7C,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,iBAAiB,EAAE,MAAM,CAAA;IAGzB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,qBAAqB,EAAE,mBAAmB,CAAA;IAC1C,sBAAsB,EAAE,oBAAoB,CAAA;IAG5C,oBAAoB,EAAE,cAAc,EAAE,CAAA;IACtC,qBAAqB,EAAE,MAAM,CAAA;IAC7B,yBAAyB,EAAE,OAAO,CAAA;IAClC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,sBAAsB,EAAE,MAAM,CAAA;CAE/B;AAID,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAGD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,oBAAoB,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,aAAa,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAID,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAEhD,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAClF,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACnF,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IACpF,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;CAClE;AAED,MAAM,WAAW,QAAQ;IACvB,iBAAiB,EAAE,uBAAuB,CAAA;IAC1C,eAAe,EAAE,qBAAqB,CAAA;IACtC,iBAAiB,EAAE,uBAAuB,CAAA;IAC1C,iBAAiB,EAAE,uBAAuB,CAAA;IAC1C,gBAAgB,EAAE,sBAAsB,CAAA;IACxC,gBAAgB,EAAE,sBAAsB,CAAA;CACzC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types/uniapp-resource-manager.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Face Detection Engine - UniApp Resource Manager
+ * Handles loading of models and WASM files in UniApp environment
+ */
+/**
+ * 获取资源路径（考虑 static 目录）
+ * 支持 UniApp App、H5、小程序等多个平台
+ * @param relativePath - 相对路径（相对于插件的 static 目录）
+ * @returns 完整的资源路径
+ */
+export declare function getResourcePath(relativePath: string): string;
+/**
+ * 获取模型文件基础路径
+ * @returns 模型文件所在目录的路径
+ */
+export declare function getModelBasePath(): string;
+/**
+ * 获取 WASM 文件路径
+ * @returns WASM 文件所在目录的路径
+ */
+export declare function getWasmPath(): string;
+/**
+ * 检查资源是否存在（H5 环境）
+ * @param url - 资源 URL
+ * @returns Promise<boolean>
+ */
+export declare function checkResourceExists(url: string): Promise<boolean>;
+/**
+ * UniApp 环境检测
+ */
+export declare function detectUniAppEnvironment(): {
+    isUniApp: boolean;
+    platform: string;
+    modelPath: string;
+    wasmPath: string;
+};
+/**
+ * 在 UniApp 中初始化资源路径
+ * 应该在应用启动时调用
+ */
+export declare function initializeUniAppResources(): void;
+/**
+ * 预加载资源文件（可选，用于提前缓存）
+ * 加载所有必需的模型文件和 WASM 后端
+ */
+export declare function preloadResources(): Promise<boolean>;
+declare const _default: {
+    getResourcePath: typeof getResourcePath;
+    getModelBasePath: typeof getModelBasePath;
+    getWasmPath: typeof getWasmPath;
+    checkResourceExists: typeof checkResourceExists;
+    detectUniAppEnvironment: typeof detectUniAppEnvironment;
+    initializeUniAppResources: typeof initializeUniAppResources;
+    preloadResources: typeof preloadResources;
+};
+export default _default;
+//# sourceMappingURL=uniapp-resource-manager.d.ts.map

package/dist/types/uniapp-resource-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniapp-resource-manager.d.ts","sourceRoot":"","sources":["../../src/uniapp-resource-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAsC5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI;IACzC,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB,CA6DA;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAmBhD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAwGzD;;;;;;;;;;AAED,wBAQC"}

package/dist/types/uniapp-sdk.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Face Liveness Detection SDK for UniApp
+ * Complete SDK wrapper for UniApp integration
+ *
+ * @example
+ * ```javascript
+ * import FaceLivenessDetector from '@sssxyd/face-liveness-detector/uniapp'
+ *
+ * const detector = new FaceLivenessDetector({
+ *   min_face_ratio: 0.5,
+ *   max_face_ratio: 0.9,
+ *   liveness_action_count: 1
+ * })
+ *
+ * detector.on('detector-loaded', () => {
+ *   console.log('Detector ready')
+ * })
+ *
+ * await detector.initialize()
+ * await detector.startDetection(videoElement)
+ * ```
+ */
+import FaceDetectionEngine from './index';
+import type { FaceDetectionEngineOptions } from './types';
+import { detectUniAppEnvironment } from './uniapp-resource-manager';
+/**
+ * UniApp Face Liveness Detection SDK
+ * Wrapper around FaceDetectionEngine optimized for UniApp
+ */
+export declare class UniAppFaceDetectionEngine extends FaceDetectionEngine {
+    private resourcesInitialized;
+    private resourcesPreloaded;
+    /**
+     * Constructor
+     * @param config - Configuration object
+     */
+    constructor(config?: Partial<FaceDetectionEngineOptions>);
+    /**
+     * Initialize the detection engine with UniApp optimizations
+     * Includes automatic resource preloading for better UX
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start detection in UniApp
+     * Automatically handles platform-specific requirements
+     */
+    startDetection(videoElement: HTMLVideoElement): Promise<void>;
+    /**
+     * Get current resource status
+     */
+    getResourceStatus(): {
+        initialized: boolean;
+        preloaded: boolean;
+        modelPath: string;
+        wasmPath: string;
+        environment: ReturnType<typeof detectUniAppEnvironment>;
+    };
+}
+/**
+ * Create and return a new SDK instance
+ *
+ * @param config - Configuration object
+ * @returns SDK instance ready to use
+ *
+ * @example
+ * ```javascript
+ * import { createSDK } from '@sssxyd/face-liveness-detector/uniapp'
+ *
+ * const detector = createSDK({
+ *   liveness_action_count: 2
+ * })
+ * ```
+ */
+export declare function createSDK(config?: Partial<FaceDetectionEngineOptions>): UniAppFaceDetectionEngine;
+/**
+ * Check if environment supports the SDK
+ *
+ * @returns Object with support information
+ */
+export declare function checkEnvironmentSupport(): {
+    isSupported: boolean;
+    platform: string;
+    reason?: string;
+};
+export type { FaceDetectionEngineOptions, EventEmitter, DetectorFinishEventData, DetectorErrorEventData, DetectorLoadedEventData } from './types';
+export { LivenessAction, ErrorCode, DetectionCode, LivenessActionStatus, DetectionPeriod } from './enums';
+export { getModelBasePath, getWasmPath, detectUniAppEnvironment, initializeUniAppResources, preloadResources } from './uniapp-resource-manager';
+export default UniAppFaceDetectionEngine;
+//# sourceMappingURL=uniapp-sdk.d.ts.map

package/dist/types/uniapp-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniapp-sdk.d.ts","sourceRoot":"","sources":["../../src/uniapp-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,mBAAmB,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EACV,0BAA0B,EAK3B,MAAM,SAAS,CAAA;AAChB,OAAO,EAGL,uBAAuB,EAGxB,MAAM,2BAA2B,CAAA;AAElC;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,mBAAmB;IAChE,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,OAAO,CAAC,kBAAkB,CAAiB;IAE3C;;;OAGG;gBACS,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC;IAqBxD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;;OAGG;IACG,cAAc,CAAC,YAAY,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnE;;OAEG;IACH,iBAAiB,IAAI;QACnB,WAAW,EAAE,OAAO,CAAA;QACpB,SAAS,EAAE,OAAO,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAA;KACxD;CAUF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,yBAAyB,CAEjG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI;IACzC,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAuBA;AAGD,YAAY,EACV,0BAA0B,EAC1B,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,cAAc,EACd,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,eAAe,EAChB,MAAM,SAAS,CAAA;AAEhB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,uBAAuB,EACvB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,2BAA2B,CAAA;AAElC,eAAe,yBAAyB,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@sssxyd/face-liveness-detector",
-  "version": "0.3.5",
+  "version": "0.4.0-alpha.2",
   "description": "Pure JS/TS implementation of liveness face detection based on human.js and opencv.js",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -31,6 +31,10 @@
   "scripts": {
     "build": "rollup -c rollup.config.js",
     "build:watch": "rollup -c rollup.config.js -w",
+    "build:uniapp": "rollup -c uniapp/rollup.config.js",
+    "package:uniapp": "node uniapp/build.cjs",
+    "download-wasm:plugin": "node uniapp/download-wasm-plugin.cjs",
+    "install:uniapp": "node uniapp/install-plugin.cjs",
     "dev": "npm run build:watch",
     "clean": "rm -rf dist types",
     "type-check": "tsc --noEmit",
@@ -58,14 +62,16 @@
     }
   },
   "devDependencies": {
-    "@techstark/opencv-js": "^4.12.0-release.1",
-    "@vladmandic/human": "^3.3.0",
     "@babel/preset-typescript": "^7.28.5",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-node-resolve": "^15.1.0",
+    "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^11.1.5",
+    "@techstark/opencv-js": "^4.12.0-release.1",
     "@types/jest": "^30.0.0",
     "@types/node": "^20.8.0",
+    "@vladmandic/human": "^3.3.0",
+    "fs-extra": "^11.3.2",
     "jest": "^30.2.0",
     "jest-environment-jsdom": "^30.2.0",
     "rollup": "^3.29.4",
@@ -80,5 +86,9 @@
   "bugs": {
     "url": "https://github.com/sssxyd/face-liveness-detector/issues"
   },
-  "homepage": "https://github.com/sssxyd/face-liveness-detector#readme"
+  "homepage": "https://github.com/sssxyd/face-liveness-detector#readme",
+  "docs": {
+    "en": "https://github.com/sssxyd/face-liveness-detector/blob/main/README.md",
+    "zh": "https://github.com/sssxyd/face-liveness-detector/blob/main/README.zh-Hans.md"
+  }
 }

package/dist/types/__tests__/config.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Configuration tests
- */
-export {};
-//# sourceMappingURL=config.test.d.ts.map

package/dist/types/__tests__/config.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/config.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/__tests__/enums.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Enums tests
- */
-export {};
-//# sourceMappingURL=enums.test.d.ts.map

package/dist/types/__tests__/enums.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"enums.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/enums.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/__tests__/event-emitter.test.d.ts

@@ -1,5 +0,0 @@
-/**
- * Event Emitter tests
- */
-export {};
-//# sourceMappingURL=event-emitter.test.d.ts.map

package/dist/types/__tests__/event-emitter.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-emitter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/event-emitter.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/types/__tests__/face-detection-engine.test.d.ts

@@ -1,7 +0,0 @@
-/**
- * FaceDetectionEngine integration tests
- * Note: These are basic integration tests using mocks. For full e2e tests,
- * you'll need actual camera and detection models.
- */
-export {};
-//# sourceMappingURL=face-detection-engine.test.d.ts.map

package/dist/types/__tests__/face-detection-engine.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"face-detection-engine.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/face-detection-engine.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/exports.d.ts

@@ -1,11 +0,0 @@
-/**
- * Face Detection Engine
- * Framework-agnostic face liveness detection engine
- *
- * @module @sssxyd/face-liveness-detector
- */
-export { FaceDetectionEngine, FaceDetectionEngine as default } from './index';
-export { preloadOpenCV, getOpenCVVersion, getCvSync } from './library-loader';
-export type { FaceDetectionEngineConfig, FaceFrontalFeatures, ImageQualityFeatures, DetectorInfoEventData, DetectorActionEventData, DetectorFinishEventData, DetectorErrorEventData, DetectorDebugEventData, DetectorLoadedEventData, EventMap, EventListener, EventEmitter, ResolvedEngineConfig } from './types';
-export { LivenessAction, LivenessActionStatus, DetectionCode, ErrorCode, DetectionPeriod } from './enums';
-//# sourceMappingURL=exports.d.ts.map

package/dist/types/exports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../../src/exports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,IAAI,OAAO,EAAE,MAAM,SAAS,CAAA;AAG7E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAG7E,YAAY,EACV,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,SAAS,EACT,eAAe,EAChB,MAAM,SAAS,CAAA"}