@incodetech/core 2.2.0 → 2.3.0-rc.1

package/dist/{idCaptureManager-CqrqSjJV.d.ts → idCaptureManager-DKESug0R.d.ts}

@@ -4,44 +4,61 @@ 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 { a as RegulationTypes } from "./types-KPvmag_B.js";
+import "./createFaceAvatar-BlcTYgJv.js";
+import { a as RegulationTypes } from "./types-Do5rEXij.js";
+import { n as VirtualCameraCheckOutput, r as WasmUtilConfig, t as IWasmUtilCapability } from "./IWasmUtilCapability-CNWRl7jr.js";
 import { n as PermissionStatus } from "./types-BEwVKkLJ.js";
-import { t as DeepsightService } from "./deepsightService-DLVQS_RH.js";
-import { i as Pdf417DecodeResult, n as IIdCaptureCapability, t as DetectionOrientation } from "./IIdCaptureCapability-DHTT3FC2.js";
-import { A as ManualUploadSide, C as RecordingSession, T as IAnalyticsCapability, a as DetectionArea, c as IdCaptureConfig, d as IdCaptureEvent, g as IdCaptureOutput, h as IdCaptureOnlyConfig, j as ManualUploadTab, l as IdCaptureContext, m as IdCaptureMode, n as CaptureIdResponse, o as DetectionStatus, p as IdCaptureInput, t as AddBarcodeV3Response, u as IdCaptureDependencies, w as UploadIdResponse, x as IdErrorCode, y as IdDocumentType } from "./types-Bdf8_LYB2.js";
-//#region src/modules/id/idCaptureStateMachine.d.ts
-declare const idCaptureMachine: AnyStateMachine;
-type IdCaptureMachine = StateMachine<IdCaptureContext, IdCaptureEvent, any, any, any, any, any, any, any, IdCaptureInput, any, any, any, any>;
-//#endregion
-//#region src/modules/id/idCaptureActor.d.ts
-type CreateIdCaptureActorOptions = {
-  config: IdCaptureConfig;
-  dependencies?: IdCaptureDependencies;
-};
-type IdCaptureActor = ActorRefFrom<IdCaptureMachine>;
-declare function createIdCaptureActor(options: CreateIdCaptureActorOptions): IdCaptureActor;
-//#endregion
-//#region src/modules/id/idCaptureOnlyStateMachine.d.ts
-type IdCaptureOnlyContext = IdCaptureContext;
-type IdCaptureOnlyEvent = IdCaptureEvent;
-type IdCaptureOnlyInput = IdCaptureInput;
-/**
- * ID capture state machine variant for the captureOnly flow. Shares the full
- * base ID-capture state tree (chooser, tutorial, permissions, capture,
- * front/back finished, processing, finished); only the upload, process, and
- * recording steps are local instead of remote.
- */
-declare const idCaptureOnlyMachine: AnyStateMachine;
-type IdCaptureOnlyMachine = StateMachine<IdCaptureOnlyContext, IdCaptureOnlyEvent, any, any, any, any, any, any, any, IdCaptureOnlyInput, any, any, any, any>;
-//#endregion
-//#region src/modules/id/idCaptureOnlyActor.d.ts
-type CreateIdCaptureOnlyActorOptions = {
-  config: IdCaptureOnlyConfig;
-  dependencies?: IdCaptureDependencies;
-};
-type IdCaptureOnlyActor = ActorRefFrom<IdCaptureOnlyMachine>;
-declare function createIdCaptureOnlyActor(options: CreateIdCaptureOnlyActorOptions): IdCaptureOnlyActor;
+import { t as BaseWasmProvider } from "./BaseWasmProvider-Dyi6dKp1.js";
+import "./types-BT_Oalip.js";
+import { n as DeepsightService } from "./StreamCanvasCapture-_8gdW5Lk.js";
+import { t as CameraStream } from "./camera-9wWD-pwg.js";
+import { i as Pdf417DecodeResult, n as IIdCaptureCapability, t as DetectionOrientation } from "./IIdCaptureCapability-RNiFhvXR.js";
+import { C as IdDocumentType, D as UploadIdResponse, L as DeviceWalletFailReason, N as ManualUploadSide, O as IAnalyticsCapability, P as ManualUploadTab, T as IdErrorCode, X as FailureReason, Y as DigitalIdProviderId, _ as IdCaptureInput, b as IdCaptureOutput, c as DetectionStatus, d as IdCaptureContext, f as IdCaptureDependencies, h as IdCaptureEvent, i as CaptureIdResponse, r as AddBarcodeV3Response, s as DetectionArea, t as AcceptedDocument, u as IdCaptureConfig, v as IdCaptureMode, y as IdCaptureOnlyConfig, z as DeviceWalletPlatform } from "./types-byBHOzCG2.js";
+//#region ../infra/src/providers/wasm/WasmUtilProvider.d.ts
+declare class WasmUtilProvider extends BaseWasmProvider implements IWasmUtilCapability {
+  private static instance;
+  private static initPromise;
+  static getInstance(): Promise<WasmUtilProvider>;
+  static resetInstance(): void;
+  constructor();
+  initialize(config: WasmUtilConfig): Promise<void>;
+  processFrame(_image: ImageData): Promise<void>;
+  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;
+  setOnDeviceMode(enabled: boolean): void;
+  setZc(zc: string): void;
+  setInspectorOpened(opened: boolean): void;
+  getInspectorOpened(): boolean;
+  /**
+   * Toggles the WASM module's production mode. When `true`, the native module
+   * suppresses its verbose debug logging/console output; when `false`, those
+   * logs are emitted. The SDK forces this to `true` by default and only flips
+   * it off when the caller opts in via `setup({ wasm: { showLogs: true } })`.
+   *
+   * @param productionMode - `true` to silence WASM logs, `false` to emit them.
+   */
+  setProductionMode(productionMode: boolean): Promise<void>;
+  getMetadata(): string;
+  analyzeFrame(image: ImageData): Promise<void>;
+  getCheck(): string;
+  getPipelineState(): string;
+  estimatePerformance(): string;
+  isVirtualCamera(label: string | null): boolean;
+  prc(): Promise<void>;
+  poc(output: VirtualCameraCheckOutput): Promise<void>;
+  rsp(): Promise<void>;
+  ssl(): void;
+  stl(): void;
+  osv(): void;
+  oev(): void;
+  ckvcks(data: ArrayBuffer): void;
+}
 //#endregion
 //#region src/modules/id/idCaptureServices.d.ts
 type IdCaptureInitResult = {
@@ -49,6 +66,8 @@ type IdCaptureInitResult = {
   provider: IIdCaptureCapability;
   captureResolution?: string;
   cameraFallbackLevel?: number;
+  /** Whether the stream in use is the rear camera, checked on the track. */
+  usingBackCamera?: boolean;
 };
 type InitializeIdCaptureParams = {
   config: IdCaptureConfig;
@@ -96,16 +115,28 @@ declare function validateUploadResponse(response: UploadIdResponse & {
   skipGlareFront?: boolean;
   skipGlareBack?: boolean;
 }): ValidationError | undefined;
+declare const getRealQualityValue: (value: number) => number;
 declare function uploadIdImage(params: UploadIdImageParams): Promise<CaptureIdResponse>;
 type StartRecordingParams = {
   config: IdCaptureConfig;
   stream: CameraStream;
-  existing?: RecordingSession;
+  existing?: object;
   type: 'frontId' | 'backId';
 };
-declare function preloadIdRecordingProvider(config: IdCaptureConfig): void;
-declare function startRecordingSession(params: StartRecordingParams): Promise<RecordingSession | undefined>;
-declare function stopRecording(session: RecordingSession): void;
+declare function startRecordingSession(params: StartRecordingParams): Promise<object | undefined>;
+declare function pauseRecordingForAttempt(session: object): void;
+declare function prepareRecordingForCameraRetry(session: object): void;
+type FinalizedIdRecording = Readonly<{
+  recordingId?: string | null;
+}>;
+/**
+ * Fully drains an ID recording before the protected camera cycle runs POC.
+ * Every recorder clone is stopped before this promise settles.
+ */
+declare function finalizeRecordingSession(session: object): Promise<FinalizedIdRecording>;
+/** Synchronous teardown used when an attempt is cancelled before finalization. */
+declare function disposeRecordingSession(session: object): void;
+declare function stopRecording(session: object): void;
 declare function processId(isSecondId?: boolean, queueName?: string, signal?: AbortSignal): Promise<{
   isDocumentExpired: boolean;
 }>;
@@ -167,6 +198,39 @@ type AddBarcodeParams = {
  */
 declare function addBarcode(params: AddBarcodeParams): Promise<AddBarcodeV3Response>;
 //#endregion
+//#region src/modules/id/idCaptureStateMachine.d.ts
+declare const idCaptureMachine: AnyStateMachine;
+type IdCaptureMachine = StateMachine<IdCaptureContext, IdCaptureEvent, any, any, any, any, any, any, any, IdCaptureInput, any, any, any, any>;
+//#endregion
+//#region src/modules/id/idCaptureActor.d.ts
+type CreateIdCaptureActorOptions = {
+  config: IdCaptureConfig;
+  dependencies?: IdCaptureDependencies;
+};
+type IdCaptureActor = ActorRefFrom<IdCaptureMachine>;
+declare function createIdCaptureActor(options: CreateIdCaptureActorOptions): IdCaptureActor;
+//#endregion
+//#region src/modules/id/idCaptureOnlyStateMachine.d.ts
+type IdCaptureOnlyContext = IdCaptureContext;
+type IdCaptureOnlyEvent = IdCaptureEvent;
+type IdCaptureOnlyInput = IdCaptureInput;
+/**
+ * ID capture state machine variant for the captureOnly flow. Shares the full
+ * base ID-capture state tree (chooser, tutorial, permissions, capture,
+ * front/back finished, processing, finished); only the upload, process, and
+ * recording steps are local instead of remote.
+ */
+declare const idCaptureOnlyMachine: AnyStateMachine;
+type IdCaptureOnlyMachine = StateMachine<IdCaptureOnlyContext, IdCaptureOnlyEvent, any, any, any, any, any, any, any, IdCaptureOnlyInput, any, any, any, any>;
+//#endregion
+//#region src/modules/id/idCaptureOnlyActor.d.ts
+type CreateIdCaptureOnlyActorOptions = {
+  config: IdCaptureOnlyConfig;
+  dependencies?: IdCaptureDependencies;
+};
+type IdCaptureOnlyActor = ActorRefFrom<IdCaptureOnlyMachine>;
+declare function createIdCaptureOnlyActor(options: CreateIdCaptureOnlyActorOptions): IdCaptureOnlyActor;
+//#endregion
 //#region src/modules/id/digitalUpload/types.d.ts
 type DigitalUploadFailReason = 'DIGITAL_ID_REQUESTED_BUT_OTHER_PROVIDED' | 'ID_TYPE_UNACCEPTABLE' | 'FILE_CHANGED_ERROR' | 'INVALID_FILE_TYPE' | 'NETWORK_ERROR' | 'GENERIC';
 //#endregion
@@ -179,11 +243,58 @@ type IdCaptureChooserState = {
   status: 'chooser';
   availableDocumentTypes: IdDocumentType[];
 };
+/**
+ * Which UI-less machine phase the collapsed `loading` status stands for. The
+ * status itself is intentionally coarse (one spinner for several phases), but
+ * some surfaces need the underlying phase — e.g. IDC-01 suppresses the spinner
+ * during `permissionsIdle` so the permission sheet does not flash a full-screen
+ * loader on its way in. Mirrors `getLoadingPhase`.
+ */
+type IdCaptureLoadingPhase =
+/** Top-level `loading`: permission check + Deepsight init in parallel. */
+'bootstrapping' |
+/** `permissions.idle` — silently re-checking permission before the dialog. */
+'permissionsIdle' |
+/** `capture.checkingStream` */
+'checkingStream' |
+/** `capture.initializingDeepsight` */
+'initializingDeepsight' |
+/** `capture.initializing` — opening the camera. */
+'initializingCamera';
 type IdCaptureLoadingState = {
   status: 'loading';
+  phase: IdCaptureLoadingPhase;
+  /** `config.showTutorial` — mirrors the `permissions` state's field. */
+  tutorialEnabled: boolean;
+  /**
+   * Mirrors `tutorial`/`permissions` — lets a tutorial-backed UI keep
+   * rendering the right document/side across the `permissionsIdle` blip
+   * instead of caching the last known values.
+   */
+  selectedDocumentType: IdDocumentType | undefined;
+  currentMode: IdCaptureMode;
 };
+/**
+ * Which `tutorial` substate the collapsed `status: 'tutorial'` stands for.
+ * Mirrors `IdCaptureLoadingPhase` — a UI-facing discriminant for phases the
+ * coarse status collapses, not a UI concept itself. `waitingForPermission`
+ * and `waitingForCamera` are the symmetric pair: the user has continued and
+ * the tutorial is blocked on permission vs. blocked on the camera warm-up.
+ */
+type IdCaptureTutorialPhase =
+/** `tutorial.checkingPermission` — resolving permission on arrival. */
+'checkingPermission' |
+/** `tutorial.ready` — idle, waiting for the user. */
+'ready' |
+/** `tutorial.initializingCamera` — warming the camera behind the tutorial; the user has not continued. */
+'initializingCamera' |
+/** `tutorial.waitingForPermission` — the user continued; resolving permission. */
+'waitingForPermission' |
+/** `tutorial.initializingCamera` with the user's Continue recorded; blocked on the warm-up. */
+'waitingForCamera';
 type IdCaptureTutorialState = {
   status: 'tutorial';
+  phase: IdCaptureTutorialPhase;
   selectedDocumentType: IdDocumentType | undefined;
   currentMode: IdCaptureMode;
 };
@@ -193,15 +304,25 @@ type IdCaptureAgeVerificationState = {
 type IdCapturePermissionsState = {
   status: 'permissions';
   permissionStatus: PermissionStatus;
+  selectedDocumentType: IdDocumentType | undefined;
+  currentMode: IdCaptureMode;
+  /** `config.showTutorial` — whether a tutorial screen precedes this one. */
+  tutorialEnabled: boolean;
 };
 type IdCaptureCaptureState = {
   status: 'capture';
   captureStatus: CaptureStatus;
   stream: CameraStream | undefined;
+  /** Whether `stream` is genuinely the rear camera; UI mirrors when false. */
+  usingBackCamera: boolean;
   detectionStatus: DetectionStatus;
   attemptsRemaining: number;
   uploadError: IdErrorCode | undefined;
   currentMode: IdCaptureMode;
+  /** Explicit chooser selection, or the effective camera document for direct-entry flows. */
+  selectedDocumentType: IdDocumentType | undefined;
+  /** `config.showTutorial` — whether this camera path was configured with a tutorial. */
+  tutorialEnabled: boolean;
   counterValue: number;
   orientation: DetectionOrientation | undefined;
   idType: string | undefined;
@@ -235,6 +356,14 @@ type IdCaptureCaptureState = {
   captureFeedbackMode: 'countdown' | 'optimizing';
   uploadErrorMessage?: string;
   uploadErrorDescription?: string;
+  /**
+   * Backend-supplied list of document types accepted for `countryCode`. Only
+   * populated alongside `uploadError === 'ID_TYPE_UNACCEPTABLE'`. Entries are
+   * widened to `string`, so unknown values must be handled by the consumer.
+   */
+  acceptedDocuments?: Array<AcceptedDocument>;
+  /** Country detected for the current upload response, if any. */
+  countryCode?: string;
   /** Whether back capture is needed after front capture completes */
   needsBackCapture: boolean;
   /** Whether front capture is needed after back capture (usSmartCapture + forceFrontIdCapture) */
@@ -303,6 +432,8 @@ type IdCaptureManualUploadState = {
   activeTab: ManualUploadTab;
   showIdTab: boolean;
   showPassportTab: boolean;
+  /** Whether the ID tab should render a front-of-ID slot. Defaults to true. */
+  showFrontSlot?: boolean;
   /** Whether the ID tab should render a back-of-ID slot. */
   showBackSlot: boolean;
   frontFileName: string | undefined;
@@ -327,7 +458,37 @@ type IdCaptureDigitalUploadState = {
   uploadProgress: number;
   pickerRequestId: number;
 };
-type IdCaptureState = IdCaptureIdleState | IdCaptureChooserState | IdCaptureLoadingState | IdCaptureTutorialState | IdCaptureAgeVerificationState | IdCapturePermissionsState | IdCaptureCaptureState | IdCaptureMandatoryConsentState | IdCaptureFrontFinishedState | IdCaptureBackFinishedState | IdCaptureProcessingState | IdCaptureExpiredState | IdCaptureExpiredExhaustedState | IdCaptureFinishedState | IdCaptureClosedState | IdCaptureErrorState | IdCaptureManualUploadState | IdCaptureDigitalUploadState;
+type IdCaptureDigitalIdRedirectState = {
+  status: 'digitalIdRedirect';
+  /**
+   * `loading` — spinner (creating/persisting/submitting/polling/idle);
+   * `redirecting` — `launchUrl` is ready, the UI performs the full-page nav;
+   * `success` — verification COMPLETED; confirmation screen with a Continue
+   *   action (the child waits here so the flow does not skip past the result);
+   * `failed` — recoverable failure screen (retry / use another method);
+   * `error` — generic recoverable error screen.
+   */
+  phase: 'loading' | 'redirecting' | 'success' | 'failed' | 'error';
+  /** Provider full-page redirect target; present in the `redirecting` phase. */
+  launchUrl: string | undefined;
+  /** Localized-failure discriminator; present in the `failed` phase. */
+  failureReason: FailureReason | undefined;
+  providerId: DigitalIdProviderId | undefined;
+};
+type IdCaptureDeviceWalletState = {
+  status: 'deviceWallet';
+  /**
+   * `requesting` — spinner (fetching the wallet request payload; also covers
+   *   the synchronous `digitalIdRouting` tick and decrypt);
+   * `presenting` — the OS wallet sheet is up;
+   * `decrypting` — spinner (forwarding the wallet response for decryption);
+   * `failed` — recoverable failure screen (retry / use another method).
+   */
+  phase: 'requesting' | 'presenting' | 'decrypting' | 'failed';
+  failReason: DeviceWalletFailReason | null;
+  platform: DeviceWalletPlatform | undefined;
+};
+type IdCaptureState = IdCaptureIdleState | IdCaptureChooserState | IdCaptureLoadingState | IdCaptureTutorialState | IdCaptureAgeVerificationState | IdCapturePermissionsState | IdCaptureCaptureState | IdCaptureMandatoryConsentState | IdCaptureFrontFinishedState | IdCaptureBackFinishedState | IdCaptureProcessingState | IdCaptureExpiredState | IdCaptureExpiredExhaustedState | IdCaptureFinishedState | IdCaptureClosedState | IdCaptureErrorState | IdCaptureManualUploadState | IdCaptureDigitalUploadState | IdCaptureDigitalIdRedirectState | IdCaptureDeviceWalletState;
 /**
  * Union of all `idCaptureMachine` variants' actor types. Variants share the
  * same state tree and context shape, so the manager helpers
@@ -353,6 +514,14 @@ declare function createIdCaptureManagerFromActor(actor: AnyIdCaptureActor, visib
   load(): void;
   selectDocument(documentType: IdDocumentType): void;
   nextStep(): Promise<void>;
+  /**
+   * Requests camera (and, when deepsight is enabled, motion) permission.
+   * Effective in `permissions.idle`, `permissions.waitingForUser`,
+   * `permissions.motionOnly`, `permissions.learnMore`, `tutorial.ready`,
+   * `tutorial.checkingPermission`, and `tutorial.initializingCamera` (while
+   * the camera pre-warms it records the user's intent to continue, so the
+   * tutorial advances to capture as soon as the warm-up finishes).
+   */
   requestPermission(): void;
   goToLearnMore(): void;
   back(): void;
@@ -390,6 +559,18 @@ declare function createIdCaptureManagerFromActor(actor: AnyIdCaptureActor, visib
   digitalUploadRetry(): void;
   digitalUploadScanInstead(): void;
   digitalUploadChooseAnother(): void;
+  /** Retry a failed Digital ID web-redirect — creates a NEW verification. */
+  digitalIdRedirectRetry(): void;
+  /** Fall back from the Digital ID web-redirect to the chooser. */
+  digitalIdRedirectUseAnotherMethod(): void;
+  /** Acknowledge the Digital ID web-redirect success screen and advance. */
+  digitalIdRedirectContinue(): void;
+  /** Refresh an expiring launch URL (no new verification / billing event). */
+  digitalIdRedirectRefresh(): void;
+  /** Retry a failed device-wallet (mDL) handshake from the start. */
+  deviceWalletRetry(): void;
+  /** Fall back from the device-wallet handshake to the chooser. */
+  deviceWalletUseAnotherMethod(): void;
 };
 type IdCaptureManager = ReturnType<typeof createIdCaptureManagerFromActor>;
 //#endregion
@@ -434,6 +615,12 @@ declare function createIdCaptureManager(options: CreateIdCaptureActorOptions): M
   digitalUploadRetry(): void;
   digitalUploadScanInstead(): void;
   digitalUploadChooseAnother(): void;
+  digitalIdRedirectRetry(): void;
+  digitalIdRedirectUseAnotherMethod(): void;
+  digitalIdRedirectContinue(): void;
+  digitalIdRedirectRefresh(): void;
+  deviceWalletRetry(): void;
+  deviceWalletUseAnotherMethod(): void;
 };
 //#endregion
-export { createIdCaptureActor as A, CreateIdCaptureOnlyActorOptions as C, idCaptureOnlyMachine as D, IdCaptureOnlyMachine as E, idCaptureMachine as M, CreateIdCaptureActorOptions as O, validateUploadResponse as S, createIdCaptureOnlyActor as T, startRecordingSession as _, AddBarcodeParams as a, uploadIdImage as b, StartRecordingParams as c, ValidationError as d, addBarcode as f, processId as g, preloadIdRecordingProvider as h, createIdCaptureManagerFromActor as i, IdCaptureMachine as j, IdCaptureActor as k, UploadIdImageParams as l, initializeIdCapture as m, IdCaptureManager as n, IdCaptureInitResult as o, barcodeToBase64 as p, IdCaptureState as r, InitializeIdCaptureParams as s, createIdCaptureManager as t, UploadManualIdFileParams as u, stopRecording as v, IdCaptureOnlyActor as w, uploadManualIdFile as x, stopStream as y };
+export { prepareRecordingForCameraRetry as A, addBarcode as C, getRealQualityValue as D, finalizeRecordingSession as E, uploadIdImage as F, uploadManualIdFile as I, validateUploadResponse as L, startRecordingSession as M, stopRecording as N, initializeIdCapture as O, stopStream as P, WasmUtilProvider as R, ValidationError as S, disposeRecordingSession as T, IdCaptureInitResult as _, CreateIdCaptureOnlyActorOptions as a, UploadIdImageParams as b, IdCaptureOnlyMachine as c, IdCaptureActor as d, createIdCaptureActor as f, FinalizedIdRecording as g, AddBarcodeParams as h, createIdCaptureManagerFromActor as i, processId as j, pauseRecordingForAttempt as k, idCaptureOnlyMachine as l, idCaptureMachine as m, IdCaptureManager as n, IdCaptureOnlyActor as o, IdCaptureMachine as p, IdCaptureState as r, createIdCaptureOnlyActor as s, createIdCaptureManager as t, CreateIdCaptureActorOptions as u, InitializeIdCaptureParams as v, barcodeToBase64 as w, UploadManualIdFileParams as x, StartRecordingParams as y };