@incodetech/core 2.0.0-alpha.13 → 2.0.0-alpha.15

package/dist/selfie.d.ts

@@ -1,6 +1,6 @@
-import { a as CameraStream, d as IMLProviderCapability, f as MLProviderConfig, i as StreamCanvasCapture, l as MotionPermissionState, n as PermissionStatus, o as IRecordingCapability, p as IncodeCanvas, r as BaseWasmProvider, s as RecordingConnection, t as PermissionResult, u as MotionStatus } from "./types-DZbrbPgj.js";
-import { n as StateMachine, t as AnyStateMachine } from "./StateMachine-pi8byl8C.js";
-import { t as Manager } from "./Manager-BZUZTRPx.js";
+import { a as CameraStream, d as IMLProviderCapability, f as MLProviderConfig, i as StreamCanvasCapture, l as MotionPermissionState, n as PermissionStatus, o as IRecordingCapability, p as IncodeCanvas, r as BaseWasmProvider, t as PermissionResult, u as MotionStatus } from "./types-CRVSv38Q.js";
+import { a as AnyStateMachine, o as StateMachine, r as FlowModuleConfig, s as WasmPipeline, t as Flow } from "./types-CMR6NkxW.js";
+import { t as Manager } from "./Manager-Co-PsiG9.js";
 
 //#region ../infra/src/capabilities/IFaceDetectionCapability.d.ts
 
@@ -143,18 +143,83 @@ interface IFaceDetectionCapability extends IMLProviderCapability<FaceDetectionCo
   setVideoSelfieMode(enabled: boolean): void;
 }
 //#endregion
-//#region ../infra/src/capabilities/IDeepsightRecordingCapability.d.ts
-type DeepsightRecordingResult = {
-  trimmedBlob: Blob;
-  encryptedVideo: string;
+//#region ../infra/src/capabilities/IStorageCapability.d.ts
+/**
+ * Storage capability interface for abstracting storage operations.
+ * Enables swapping between browser localStorage and future WASM-based storage.
+ */
+interface IStorageCapability {
+  /**
+   * Retrieves a value from storage.
+   * @param key - The storage key
+   * @returns The stored value or null if not found
+   */
+  get<T>(key: string): Promise<T | null>;
+  /**
+   * Stores a value in storage.
+   * @param key - The storage key
+   * @param value - The value to store (will be serialized)
+   */
+  set<T>(key: string, value: T): Promise<void>;
+  /**
+   * Removes a value from storage.
+   * @param key - The storage key to remove
+   */
+  remove(key: string): Promise<void>;
+  /**
+   * Clears all values from storage.
+   */
+  clear(): Promise<void>;
+}
+//#endregion
+//#region ../infra/src/capabilities/IWasmUtilCapability.d.ts
+type WasmUtilConfig = MLProviderConfig & {
+  pipelines?: WasmPipeline[];
 };
-type IDeepsightRecordingCapability = {
-  readonly isRecording: boolean;
-  readonly hasError: boolean;
-  readonly error: string | null;
-  startRecording(stream: MediaStream): void;
-  stopRecording(trimSeconds: number, encrypt: (base64: string) => string, generateChecksum: (buffer: ArrayBuffer) => void): Promise<DeepsightRecordingResult>;
-  reset(): void;
+type VirtualCameraCheckOutput = {
+  canvas: HTMLCanvasElement | null;
+  itr: boolean | null;
+  skipped: boolean | null;
+};
+type IWasmUtilCapability = {
+  /**
+   * Whether the provider has been initialized and is ready to be used.
+   */
+  readonly initialized: boolean;
+  /**
+   * Initializes the provider with the given configuration.
+   * If WASM was already warmed up via `warmupWasm()`, this returns almost instantly.
+   * @param config - Provider configuration including WASM paths
+   */
+  initialize(config: WasmUtilConfig): Promise<void>;
+  /**
+   * Encrypts a base64 image using the WASM utility API.
+   * @param image - Base64 image string (no data URL prefix)
+   * @returns Encrypted string
+   */
+  encryptImage(image: string): string;
+  setSdkVersion(version: string): void;
+  setSdkPlatform(platform: string): void;
+  setDeviceInfo(deviceInfo: object, overrideExisting?: boolean): void;
+  setBrowserInfo(browserInfo: object, overrideExisting?: boolean): void;
+  setCameraInfo(cameraInfo: object, overrideExisting?: boolean): void;
+  setMotionStatus(status: string): void;
+  setBackgroundMode(backgroundMode: boolean): void;
+  setZc(zc: string): void;
+  setInspectorOpened(opened: boolean): void;
+  getMetadata(): string;
+  analyzeFrame(image: ImageData): Promise<void>;
+  getCheck(): string;
+  estimatePerformance(): string;
+  isVirtualCamera(label: string | null): boolean;
+  prc(): Promise<void>;
+  poc(output: VirtualCameraCheckOutput): Promise<void>;
+  ckvcks(data: ArrayBuffer): void;
+  getVersions(): Promise<unknown>;
+  /**
+   * Disposes of resources and resets initialization state.
+   */
+  dispose(): Promise<void>;
 };
 //#endregion
 //#region ../infra/src/providers/wasm/FaceDetectionProvider.d.ts
@@ -203,43 +268,48 @@ type MotionStatusService = {
   readonly hasPermission: boolean;
 };
 //#endregion
-//#region src/internal/deepsight/deepsightService.d.ts
-type DeepsightCaptureResult = {
-  metadata: string;
-  recordingId: string | null;
+//#region src/internal/virtualCameraCheck.d.ts
+declare const frameSources: {
+  readonly front: "FRONT_ID";
+  readonly back: "BACK_ID";
+  readonly selfie: "SELFIE";
 };
+type FrameSource = (typeof frameSources)[keyof typeof frameSources];
+//#endregion
+//#region src/internal/deepsight/deepsightService.d.ts
 type DeepsightService = {
   readonly metadata: MetadataService;
   readonly motion: MotionStatusService;
-  readonly recorder: IDeepsightRecordingCapability;
   initialize(disableIpify?: boolean): Promise<void>;
   requestMotionPermission(): Promise<'granted' | 'denied' | 'not-required'>;
   startMotionSensors(): Promise<void>;
   stopMotionSensors(): void;
-  startRecording(stream: MediaStream): void;
   checkVirtualCamera(videoTrack: MediaStreamTrack): Promise<boolean>;
-  performVirtualCameraCheck(): Promise<void>;
-  performCapture(sessionToken: string, imageData: ImageData): Promise<DeepsightCaptureResult>;
+  performVirtualCameraCheck(sessionToken: string | null, source: FrameSource): Promise<void>;
+  /**
+   * Runs PRC warmup and stores DS flag using infrastructure providers.
+   */
+  performPrcCheck(params: DeepsightPrcCheckParams): Promise<void>;
+  analyzeFrame(imageData: ImageData): Promise<void>;
+  getMetadata(): string;
   cleanup(): void;
 };
+type DeepsightPrcCheckParams = {
+  constraints: MediaStreamConstraints;
+  ds?: boolean;
+  storage: IStorageCapability;
+};
 //#endregion
 //#region src/modules/selfie/types.d.ts
-type SelfieConfig = {
-  showTutorial: boolean;
-  showPreview: boolean;
-  assistedOnboarding: boolean;
-  enableFaceRecording: boolean;
+type SelfieConfig = FlowModuleConfig['SELFIE'] & {
   recording?: {
     capability?: IRecordingCapability;
   };
-  autoCaptureTimeout: number;
-  captureAttempts: number;
-  validateLenses: boolean;
-  validateFaceMask: boolean;
-  validateHeadCover: boolean;
-  validateClosedEyes: boolean;
-  validateBrightness: boolean;
-  deepsightLiveness: 'SINGLE_FRAME' | 'MULTIMODAL' | 'VIDEOLIVENESS';
+  ds?: Flow['ds'];
+};
+type SelfieDependencies = {
+  storage: IStorageCapability;
+  getWasmUtil: () => Promise<IWasmUtilCapability>;
 };
 type DetectionStatus = 'idle' | 'detecting' | 'noFace' | 'tooManyFaces' | 'tooClose' | 'tooFar' | 'blur' | 'dark' | 'faceAngle' | 'headWear' | 'lenses' | 'eyesClosed' | 'faceMask' | 'centerFace' | 'manualCapture' | 'success' | 'error' | 'capturing' | 'getReady' | 'getReadyFinished' | 'offline';
 type SendFaceImageResponse = {
@@ -285,14 +355,6 @@ declare const FACE_ERROR_CODES: {
   readonly SELFIE_IMAGE_LOW_QUALITY: "SELFIE_IMAGE_LOW_QUALITY";
 };
 type FaceErrorCode = (typeof FACE_ERROR_CODES)[keyof typeof FACE_ERROR_CODES];
-type RecordingSession = {
-  token: string;
-  sessionId: string;
-  videoRecordingId: string;
-  connection: RecordingConnection;
-  resolution?: string;
-  hasAudio: boolean;
-};
 //#endregion
 //#region src/modules/selfie/selfieUploadService.d.ts
 type ProcessFaceImageType = 'selfie' | 'videoSelfie';
@@ -303,9 +365,19 @@ type ProcessFaceResponse = {
 };
 declare function processFace(imageType?: ProcessFaceImageType, signal?: AbortSignal): Promise<ProcessFaceResponse>;
 //#endregion
+//#region src/modules/selfie/recordingService.d.ts
+type RecordingService = {
+  start(stream: MediaStream): Promise<void>;
+  stop(): Promise<{
+    recordingId: string | null;
+  }>;
+  cleanup(): void;
+};
+//#endregion
 //#region src/modules/selfie/selfieStateMachine.d.ts
 type SelfieContext = {
   config: SelfieConfig;
+  dependencies: SelfieDependencies;
   stream: CameraStream | undefined;
   provider: FaceDetectionProvider | undefined;
   frameCapturer: StreamCanvasCapture | undefined;
@@ -316,8 +388,7 @@ type SelfieContext = {
   faceCoordinates: FaceCoordinates | undefined;
   uploadResponse: SendFaceImageResponse | undefined;
   processResponse: ProcessFaceResponse | undefined;
-  recordingSession: RecordingSession | undefined;
-  recordingStream: MediaStream | undefined;
+  recordingService: RecordingService | undefined;
   attemptsRemaining: number;
   uploadError: FaceErrorCode | undefined;
   permissionResult: PermissionResult | 'refresh' | undefined;
@@ -358,6 +429,7 @@ type SelfieEvent = {
 };
 type SelfieInput = {
   config: SelfieConfig;
+  dependencies: SelfieDependencies;
 };
 /**
  * The selfie capture state machine.
@@ -375,6 +447,7 @@ type SelfieMachine = StateMachine<SelfieContext, SelfieEvent, any, any, any, any
 //#region src/modules/selfie/selfieActor.d.ts
 type CreateSelfieActorOptions = {
   config: SelfieConfig;
+  dependencies?: SelfieDependencies;
 };
 //#endregion
 //#region src/modules/selfie/selfieManager.d.ts
@@ -499,7 +572,7 @@ declare function createSelfieManager(options: CreateSelfieActorOptions): Manager
   close(): void;
   /**
    * Resets the selfie manager to its initial `idle` state.
-   * Can be called from `finished` or `error` states.
+   * Can be called from `error` state. Not available from `finished` (final state).
    */
   reset(): void;
   /**