@incodetech/core 2.2.0 → 2.3.0-rc.1

package/dist/{faceCaptureManagerFactory-BxWPpxyd.d.ts → faceCaptureManagerFactory-BeUl8fl1.d.ts}

@@ -4,57 +4,21 @@ import { t as Manager } from "./Manager-CQQ99QOI.js";
 import "./Actor-iTq7YY48.js";
 import { t as IVisibilityObserverCapability } from "./IVisibilityObserverCapability-D4tvIB5v.js";
 import "./index-B8weJxmL.js";
-import { t as CameraStream } from "./camera-9wWD-pwg.js";
-import { o as IncodeCanvas } from "./IStorageCapability-ORkQfK3F.js";
-import { i as FaceData, r as FaceCoordinates, t as FaceDetectionProvider } from "./FaceDetectionProvider-Mh6q3EbA.js";
-import { t as AvatarId } from "./createFaceAvatar-BEj18KXi.js";
-import { i as FlowModuleConfig } from "./types-KPvmag_B.js";
-import { a as FaceCapturedImageData, i as FaceCaptureOnlyResponse, n as DetectionStatus, o as FaceErrorCode, r as FaceCaptureDependencies, t as BaseFaceCaptureConfig } from "./types-Hmd7U0JA.js";
+import { s as FaceFeed, t as AvatarId, u as FaceCoordinates, y as IncodeCanvas } from "./createFaceAvatar-BlcTYgJv.js";
+import { i as FlowModuleConfig } from "./types-Do5rEXij.js";
+import "./IWasmUtilCapability-CNWRl7jr.js";
 import { n as PermissionStatus, t as PermissionResult } from "./types-BEwVKkLJ.js";
-import { t as AuthenticationConfig } from "./types-EELWyWpd.js";
-import { n as StreamCanvasCapture, t as DeepsightService } from "./deepsightService-DLVQS_RH.js";
+import { a as FaceCapturedImageData, i as FaceCaptureOnlyResponse, n as DetectionStatus, o as FaceErrorCode, r as FaceCaptureDependencies, t as BaseFaceCaptureConfig } from "./types-Bnl58jUQ.js";
+import { t as AuthenticationConfig } from "./types-ChAowIxT.js";
+import "./types-BT_Oalip.js";
+import { n as DeepsightService, t as StreamCanvasCapture } from "./StreamCanvasCapture-_8gdW5Lk.js";
+import { t as FaceDetectionProvider } from "./FaceDetectionProvider-LdZ47bWy.js";
+import { t as CameraStream } from "./camera-9wWD-pwg.js";
 //#region src/modules/authentication/authenticationStateMachine.d.ts
 declare const _authenticationMachine: AnyStateMachine;
 type AuthenticationMachine = typeof _authenticationMachine;
 declare const authenticationMachine: AnyStateMachine;
 //#endregion
-//#region ../infra/src/avatar/faceFeed.d.ts
-/**
- * A tiny per-frame pub/sub channel for the Incode WASM pipeline's `FaceData`.
- *
- * The parked `incode-2d` avatar drives the cosmetic avatar from the **existing** Incode face-detection
- * pipeline (no second MediaPipe model). The detection pipeline lives in core's
- * detection actor, while the avatar lives in the avatar actor — so the avatar is
- * *fed* `FaceData` through this channel rather than running its own model.
- *
- * Deliberately NOT routed through XState events/context: the pipeline emits
- * ~10×/s, and assigning that into context would re-run `mapState` and notify all
- * manager subscribers 10×/s — needless churn that could itself regress UI perf.
- * The feed is a plain emitter passed as input to both actors (detection
- * publishes, the avatar source subscribes); nothing else observes it.
- *
- * Strictly read-only w.r.t. the authoritative pipeline — the feed only forwards
- * data the pipeline already computed; it never influences detection/autocapture.
- */
-interface FaceFeedReader {
-  /** Subscribe to per-frame faces. Returns an unsubscribe function. */
-  subscribe(listener: (face: FaceData) => void): () => void;
-  /** The most recently published face, or null if none yet. */
-  getLatest(): FaceData | null;
-  /**
-   * Subscribe to the coarse "eyes closed" pulse — the only real eye signal the
-   * Incode pipeline exposes (a threshold event, both eyes, fired only when the
-   * closed-eyes check is enabled via `validateClosedEyes`). The avatar uses it
-   * to drive a real blink. Returns an unsubscribe function.
-   */
-  onEyesClosed(listener: () => void): () => void;
-}
-interface FaceFeed extends FaceFeedReader {
-  publish(face: FaceData): void;
-  /** Fire the eyes-closed pulse (from the detection pipeline's threshold event). */
-  signalEyesClosed(): void;
-}
-//#endregion
 //#region src/modules/authentication/authenticationActor.d.ts
 type CreateAuthenticationActorOptions = {
   config: AuthenticationConfig;
@@ -106,12 +70,36 @@ type SendFaceImageResponse = {
   sessionStatus: string;
 };
 //#endregion
+//#region src/modules/selfie/selfieUploadService.d.ts
+type ProcessFaceImageType = 'selfie' | 'videoSelfie';
+type ProcessFaceResponse = {
+  faceMatch: boolean;
+  confidence: number;
+  existingUser: boolean;
+};
+declare function processFace(imageType?: ProcessFaceImageType, signal?: AbortSignal): Promise<ProcessFaceResponse>;
+//#endregion
 //#region src/internal/faceCapture/recordingService.d.ts
 type RecordingService = {
   start(stream: MediaStream): Promise<void>;
+  /**
+   * Prepares the recording metadata needed by the face-image upload.
+   *
+   * Local video-liveness recordings must stop here because their upload id is
+   * sent with the image. Scoped face recordings return no legacy id, pause at
+   * the end of each attempt, and resume the same upload after a rejection; the
+   * state machine finalizes them only after the backend accepts the capture.
+   */
+  prepareUpload(): Promise<{
+    recordingId: string | null;
+  }>;
   stop(): Promise<{
     recordingId: string | null;
   }>;
+  /** Best-effort page-background handling for protected camera cycles. */
+  pauseForBackground?(): void;
+  /** Resumes the same recorder after its protected presentation track recovers. */
+  resumeFromBackground?(stream: MediaStream): Promise<void>;
   /**
    * Stops the recorder and returns the raw (un-encrypted, not uploaded)
    * video as base64. Used by the captureOnly flow, which hands video bytes
@@ -120,8 +108,6 @@ type RecordingService = {
    * Returns `{ videoBase64: undefined }` when video is not available for
    * any reason, including:
    * - the recorder was never started or is already stopped,
-   * - the provider is server-side (e.g. OpenVidu) and the client never
-   *   holds the bytes,
    * - video assembly fails.
    */
   stopAndGetVideo(): Promise<{
@@ -153,8 +139,10 @@ type FaceCaptureContext = {
   dependencies: FaceCaptureDependencies;
   authHint: string | undefined;
   stream: CameraStream | undefined;
-  provider: FaceDetectionProvider | undefined;
-  frameCapturer: StreamCanvasCapture | undefined;
+  /** @deprecated Protected capture authority is private and this is always absent. */
+  provider?: FaceDetectionProvider | undefined;
+  /** @deprecated Protected capture authority is private and this is always absent. */
+  frameCapturer?: StreamCanvasCapture | undefined;
   usingBackCamera: boolean;
   error: string | FaceErrorObject | undefined;
   detectionStatus: DetectionStatus;
@@ -162,12 +150,17 @@ type FaceCaptureContext = {
   faceCoordinates: FaceCoordinates | undefined;
   uploadResponse: Record<string, unknown> | undefined;
   processResponse: Record<string, unknown> | undefined;
-  recordingService: RecordingService | undefined;
+  /** @deprecated Recorder ownership is private and this is always absent. */
+  recordingService?: RecordingService | undefined;
   attemptsRemaining: number;
   uploadError: FaceErrorCode | undefined;
   permissionResult: PermissionResult | 'refresh' | undefined;
-  resetDetection: (() => void) | undefined;
-  deepsightService: DeepsightService | undefined;
+  /** @deprecated Detection callback ownership is private and this is always absent. */
+  resetDetection?: (() => void) | undefined;
+  /** @deprecated Deepsight ownership is private and this is always absent. */
+  deepsightService?: DeepsightService | undefined;
+  /** Internal semantic readiness marker; no service instance is exposed. */
+  deepsightReady?: boolean;
   encryptedBase64Image: string | undefined;
   uploadRecordingId: string | null | undefined;
   manualCaptureTriggered: boolean;
@@ -229,6 +222,15 @@ type FaceCaptureEvent = {
   canvas: HTMLCanvasElement;
 } | {
   type: 'RETRY_CAPTURE';
+} | {
+  type: 'GO_TO_MANUAL_UPLOAD';
+} | {
+  type: 'MANUAL_UPLOAD_FILE_SELECTED';
+  file: File;
+} | {
+  type: 'MANUAL_UPLOAD_CONTINUE';
+} | {
+  type: 'MANUAL_UPLOAD_RESET';
 };
 declare const faceCaptureMachine: AnyStateMachine;
 //#endregion
@@ -291,6 +293,20 @@ type FaceCaptureLoadingState = {
 type FaceCaptureTutorialState = {
   status: 'tutorial';
   ageAssurance?: boolean;
+  /** Whether to offer the manual file-upload alternative to live capture. */
+  showManualUploadLink: boolean;
+};
+/** Picking a photo from device storage instead of using the camera */
+type FaceCaptureManualUploadState = {
+  status: 'manualUpload';
+  /** `uploading` covers both the file conversion and the network call. */
+  phase: 'selecting' | 'uploading';
+  /** Whether a file has been accepted by the backend. */
+  uploaded: boolean;
+  canContinue: boolean;
+  /** i18n key for the current rejection, or `null`. */
+  errorKey: string | null;
+  attemptsRemaining: number;
 };
 /** Handling camera permissions */
 type FaceCapturePermissionsState = {
@@ -373,7 +389,7 @@ type FaceCaptureErrorState = {
   moduleErrorCode?: string;
 };
 /** Union of all possible face capture states */
-type FaceCaptureManagerState = FaceCaptureIdleState | FaceCaptureLoadingState | FaceCaptureTutorialState | FaceCapturePermissionsState | FaceCaptureCaptureState | FaceCaptureProcessingState | FaceCaptureFinishedState | FaceCaptureClosedState | FaceCaptureErrorState;
+type FaceCaptureManagerState = FaceCaptureIdleState | FaceCaptureLoadingState | FaceCaptureTutorialState | FaceCapturePermissionsState | FaceCaptureCaptureState | FaceCaptureManualUploadState | FaceCaptureProcessingState | FaceCaptureFinishedState | FaceCaptureClosedState | FaceCaptureErrorState;
 /**
  * Builds a face capture manager (selfie / authentication / captureOnly) from an
  * already-created actor.
@@ -433,7 +449,23 @@ declare function createFaceCaptureManagerFromActor(actor: FaceCaptureActor, modu
    * Only effective when in `capture.detecting` state and `detectionStatus === 'manualCapture'`.
    */
   capture(): void;
+  /**
+   * Leaves the tutorial for the manual file-upload screen.
+   * Only effective from `tutorial` and only when the module enables it, so a
+   * call from anywhere else — including the console — is a no-op.
+   */
+  goToManualUpload(): void;
+  /**
+   * Submits a file the user picked from device storage.
+   * Only effective when in `manualUpload`.
+   */
+  manualUploadSelectFile(file: File): void;
+  /**
+   * Accepts the uploaded photo and moves on to processing.
+   * Only effective when in `manualUpload` and an upload has succeeded.
+   */
+  manualUploadContinue(): void;
 };
 type FaceCaptureManager = ReturnType<typeof createFaceCaptureManagerFromActor>;
 //#endregion
-export { SendFaceImageResponse as _, SelfieCaptureOnlyMachine as a, createAuthenticationActor as b, SelfieActor as c, FaceCaptureContext as d, FaceCaptureEvent as f, SelfieConfig as g, SelfieCaptureOnlyConfig as h, SelfieCaptureOnlyActor as i, SelfieMachine as l, faceCaptureMachine as m, FaceCaptureManagerState as n, selfieCaptureOnlyMachine as o, FaceCaptureInput as p, CreateSelfieCaptureOnlyActorOptions as r, CreateSelfieActorOptions as s, FaceCaptureManager as t, selfieMachine as u, AuthenticationActor as v, authenticationMachine as x, CreateAuthenticationActorOptions as y };
+export { authenticationMachine as C, createAuthenticationActor as S, SelfieCaptureOnlyConfig as _, SelfieCaptureOnlyMachine as a, AuthenticationActor as b, SelfieActor as c, FaceCaptureContext as d, FaceCaptureEvent as f, processFace as g, ProcessFaceResponse as h, SelfieCaptureOnlyActor as i, SelfieMachine as l, faceCaptureMachine as m, FaceCaptureManagerState as n, selfieCaptureOnlyMachine as o, FaceCaptureInput as p, CreateSelfieCaptureOnlyActorOptions as r, CreateSelfieActorOptions as s, FaceCaptureManager as t, selfieMachine as u, SelfieConfig as v, CreateAuthenticationActorOptions as x, SendFaceImageResponse as y };