@incodetech/core 2.0.0-alpha.8 → 2.0.0-rc.0

package/dist/faceMatchStateMachine-DNFrxTFS.esm.js

@@ -0,0 +1,127 @@
+import { t as api } from "./api-CESGtpbH.esm.js";
+import { t as endpoints } from "./endpoints-CnN3SyDa.esm.js";
+import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-B70JrNqo.esm.js";
+
+//#region src/modules/face-match/faceMatchServices.ts
+/**
+* Fetches cropped face images from the backend.
+*/
+async function fetchFaceMatchImages(signal) {
+	const res = await api.post(endpoints.getImagesV2, { images: [
+		"croppedFace",
+		"croppedIDFace",
+		"croppedAuthenticationSelfie"
+	] }, { signal });
+	if (!res.ok) throw new Error(`POST ${endpoints.getImagesV2} failed: ${res.status} ${res.statusText}`);
+	const data = res.data;
+	return {
+		idFace: data.croppedIDFace ?? null,
+		selfie: data.croppedFace ?? data.croppedAuthenticationSelfie ?? null,
+		secondIdFace: void 0
+	};
+}
+/**
+* Fetches face recognition score from the backend.
+*/
+async function fetchScore(signal) {
+	const res = await api.get(endpoints.getScore, { signal });
+	if (!res.ok) throw new Error(`GET ${endpoints.getScore} failed: ${res.status} ${res.statusText}`);
+	const data = res.data;
+	return {
+		matched: data.faceRecognition?.overall?.status === "OK" ? true : data.faceRecognition?.overall?.status === "FAIL" ? false : null,
+		liveness: data.deepsight ? data.deepsight.multimodalIntelligence?.overall?.status === "OK" : data.liveness?.overall?.status === "OK"
+	};
+}
+/**
+* Fetches second ID face images from the backend.
+*/
+async function fetchSecondIdImages(signal) {
+	const res = await api.post(endpoints.getImagesSecondId, { images: ["croppedIDFace"] }, { signal });
+	if (!res.ok) throw new Error(`POST ${endpoints.getImagesSecondId} failed: ${res.status} ${res.statusText}`);
+	return { secondIdFace: res.data.croppedIDFace ?? null };
+}
+/**
+* Fetches all face match data in parallel (images, score, and optionally second ID images).
+*/
+async function fetchFaceMatchData(config, signal) {
+	const promises = [fetchFaceMatchImages(signal), fetchScore(signal)];
+	if (config.matchingType === "secondId") promises.push(fetchSecondIdImages(signal));
+	const [imagesRes, resultRes, secondIdRes] = await Promise.all(promises);
+	return {
+		images: {
+			...imagesRes,
+			secondIdFace: secondIdRes?.secondIdFace ?? null
+		},
+		result: resultRes
+	};
+}
+
+//#endregion
+//#region src/modules/face-match/faceMatchStateMachine.ts
+const faceMatchMachine = setup({
+	types: {
+		context: {},
+		events: {},
+		input: {}
+	},
+	actors: { fetchData: fromPromise(async ({ input, signal }) => {
+		return fetchFaceMatchData(input.config, signal);
+	}) },
+	actions: {
+		setData: assign(({ event }) => {
+			const output = event.output;
+			return {
+				images: output.images,
+				result: output.result
+			};
+		}),
+		setError: assign(({ event }) => ({ error: String(event.error) })),
+		clearError: assign({ error: () => void 0 }),
+		resetContext: assign(({ context }) => ({
+			config: context.config,
+			images: null,
+			result: null,
+			error: void 0
+		}))
+	},
+	guards: { isAnimationDisabled: ({ context }) => context.config.disableFaceMatchAnimation === true }
+}).createMachine({
+	id: "faceMatch",
+	initial: "idle",
+	context: ({ input }) => ({
+		config: input.config,
+		images: null,
+		result: null,
+		error: void 0
+	}),
+	states: {
+		idle: { on: { LOAD: { target: "loading" } } },
+		loading: { invoke: {
+			id: "fetchData",
+			src: "fetchData",
+			input: ({ context }) => ({ config: context.config }),
+			onDone: [{
+				target: "finished",
+				guard: "isAnimationDisabled",
+				actions: "setData"
+			}, {
+				target: "animating",
+				actions: "setData"
+			}],
+			onError: {
+				target: "error",
+				actions: "setError"
+			}
+		} },
+		animating: { on: { ANIMATION_COMPLETE: { target: "result" } } },
+		result: { on: { CONTINUE: { target: "finished" } } },
+		finished: { type: "final" },
+		error: { on: { RESET: {
+			target: "idle",
+			actions: "resetContext"
+		} } }
+	}
+});
+
+//#endregion
+export { faceMatchMachine as t };

package/dist/flow-events.d.ts

@@ -0,0 +1,6 @@
+import "./camera-DBSxa6ML.js";
+import "./types-CFV9G_7j.js";
+import "./types-BP1m8VRw.js";
+import "./flowCompletionService-DhkT4SRY.js";
+import { a as FlowEventListener, c as FlowModuleStartedEvent, i as FlowEvent, l as FlowReadyEvent, n as FlowCompletedEvent, o as FlowEventSubscribable, r as FlowErrorEvent, s as FlowModuleCompletedEvent, t as FlowClosedEvent, u as FlowStartedEvent } from "./index-BcRG8rtJ.js";
+export { FlowClosedEvent, FlowCompletedEvent, FlowErrorEvent, FlowEvent, FlowEventListener, FlowEventSubscribable, FlowModuleCompletedEvent, FlowModuleStartedEvent, FlowReadyEvent, FlowStartedEvent };

package/dist/flow.d.ts

@@ -1,312 +1,30 @@
-import { t as WasmPipeline } from "./warmup-CEJTfxQr.js";
-import { t as Manager } from "./Manager-BGfxEmyv.js";
-import { t as AnyStateMachine } from "./StateMachine-DRE1oH2B.js";
+import { n as WasmPipeline } from "./warmup-CEcppFiS.js";
+import { t as Manager } from "./Manager-C8PrhBOx.js";
+import { t as AnyStateMachine } from "./StateMachine-BCQrZJhf.js";
+import "./camera-DBSxa6ML.js";
+import "./types-CFV9G_7j.js";
+import { i as FlowModuleConfig, n as Flow, r as FlowModule } from "./types-BP1m8VRw.js";
+import { n as GetFinishStatusFn, t as FinishStatus } from "./flowCompletionService-DhkT4SRY.js";
+import { o as FlowEventSubscribable } from "./index-BcRG8rtJ.js";
+import { n as ModuleRegistry } from "./types-B06Ypu2F.js";
+import * as xstate1002 from "xstate";
 
-//#region src/modules/flow/types.d.ts
-type EmptyConfig = Record<string, never>;
-type RegulationTypes = 'US' | 'Worldwide' | 'Other' | 'US_Illinois' | 'US_Texas' | 'US_California' | 'US_Washington';
-type TutorialIdConfig = {
-  showTutorial: boolean;
-  enableId: boolean;
-  enablePassport: boolean;
-  onlyFront: boolean;
-  onlyBack: boolean;
-  barcodeCapture: boolean;
-  fetchAdditionalPage: boolean;
-  secondId: boolean;
-  thirdId: boolean;
-  autoCaptureTimeout: number;
-  deviceIdleTimeout: number;
-  captureAttempts: number;
-  manualUploadIdCapture: boolean;
-  digitalIdsUpload: boolean;
-  showDocumentChooserScreen: boolean;
-  enableIdRecording: boolean;
-  usSmartCapture: boolean;
-  perCountryPerDocOverrides: Record<string, Record<string, {
-    onlyFront: boolean;
-    onlyBack: boolean;
-    fetchAdditionalPage: boolean;
-  }>>;
+//#region src/modules/flow/flowUtils.d.ts
+type NormalizeFlowModulesOptions = {
+  isDesktop?: boolean;
+  authHint?: string;
+  lang?: string;
+  useCPF?: boolean;
 };
-type FlowModuleConfig = {
-  AUTHENTICATION: {
-    showTutorial: boolean;
-    autoCaptureTimeout: number;
-    numberOfAttempts: number;
-    type: 'ONE_TO_ONE';
-    deepsightLiveness: 'SINGLE_FRAME' | 'MULTIMODAL' | 'VIDEOLIVENESS';
-    validateClosedEyes: boolean;
-    validateFaceMask: boolean;
-    validateHeadCover: boolean;
-    validateLenses: boolean;
-  };
-  ADDRESS: {
-    disableSkipPoa: boolean;
-    title: string;
-    text: string;
-  };
-  AE_SIGNATURE: {
-    uploadDocument: boolean;
-    downloadDocument: boolean;
-    issuePermanentCertificate: boolean;
-    allowWithoutScoreValidation: boolean;
-    validationsToSkip: ('ID' | 'FACE_RECOGNITION' | 'OTP' | 'TOTAL_SCORE')[];
-  };
-  CURP_VALIDATION: {
-    curpDataMatch: boolean;
-    deceasedStatusVerification: boolean;
-  };
-  CUSTOM_FIELDS: {
-    title: string;
-    customFields: {
-      name: string;
-      alias: string;
-      type: 'INTEGER' | 'DOUBLE' | 'BOOLEAN' | 'STRING';
-    }[];
-  };
-  DOCUMENT_CAPTURE: {
-    processingType: 'capture' | 'processPoaOcr' | 'processLoaOcr' | 'processAsylumSeekerVisaZaf' | 'processBankStatementOCR' | 'processBankCheck' | 'processV5CLogbook' | 'processCarInvoice' | 'processCirculationCard' | 'processFinanceSettlement';
-    title: string;
-    text: string;
-    allowSkipDocumentCapture: boolean;
-  };
-  EKYB: {
-    checkBusinessName: boolean;
-    businessNameSource: 'userInput';
-    checkAddress: boolean;
-    address: 'userInput';
-    checkTaxId: boolean;
-    taxIdSource: 'userInput';
-    checkUniqueBeneficialOwner: boolean;
-    uniqueBeneficialOwnerSource: 'userInput';
-  };
-  EXTERNAL_VERIFICATION: {
-    source: 'US_DRIVERS_LICENSE_1' | 'US_TELCO_1' | 'US_TELCO_2' | 'US_CONSUMER_1' | 'US_CREDIT_BUREAU_1' | 'MX_CONSUMER_1' | 'BR_GOVT_1' | 'CA_RES_CREDIT' | 'UK_CREDIT_BUREAU_1' | 'ES_1' | 'CL_1' | 'AR_1' | 'GR_1' | 'GT_1' | 'BR_CPF_1';
-    checkName: boolean;
-    nameSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkEmail: boolean;
-    emailSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkAddress: boolean;
-    addressSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkPhone: boolean;
-    phoneSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkSsn: boolean;
-    ssnSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkDob: boolean;
-    dobSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkNationality: boolean;
-    nationalitySource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkDlNumber: boolean;
-    dlNumberSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkDlState: boolean;
-    dlStateSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkDlExpireAt: boolean;
-    dlExpireAtSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkLast4SSN: boolean;
-    last4SSNSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkIdNum: boolean;
-    idNumSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkIdNum1: boolean;
-    idNum1Source: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-    checkGender: boolean;
-    genderSource: 'userInput' | 'document' | 'poa' | 'phoneModuleInput' | 'emailModuleInput';
-  };
-  EMAIL: {
-    otpVerification: boolean;
-    otpExpirationInMinutes: number;
-    prefill?: boolean;
-  };
-  FACE_MATCH: {
-    matchingType: 'selfieVsId' | 'selfieVsNfc' | 'idVsNfc' | 'nfc3Way';
-    disableFaceMatchAnimation: boolean;
-  };
-  FINISH_GPT: {
-    finishgptCompanyName: string;
-  };
-  GEOLOCATION: {
-    allowUserToSkipGeolocation: boolean;
-  };
-  INE_VALIDATION: {
-    facialValidation: boolean;
-    alternativeFacialValidation: boolean;
-    fallbackEnabled: boolean;
-    scrapingMethod: boolean;
-    scrapingV2: boolean;
-    scrapingV3: boolean;
-    failUnsupportedId: boolean;
-    dataValidation: boolean;
-    backgroundExecution: boolean;
-    mockConnectionError: boolean;
-    mockUserNotFoundError: boolean;
-    mockOK: boolean;
-  };
-  GOVT_VALIDATION_PROVISIONING: {
-    validationCountries: string[];
-    facialValidation: boolean;
-    dataValidation: boolean;
-    faceAndDataValidation: boolean;
-    addressValidation: boolean;
-    backgroundExecution: boolean;
-    faceMatchOverrideDataScore: boolean;
-    useCroppedIdFacePhoto: boolean;
-  };
-  TUTORIAL_ID: TutorialIdConfig;
-  ID: TutorialIdConfig;
-  SECOND_ID: TutorialIdConfig;
-  THIRD_ID: TutorialIdConfig;
-  ID_OCR: {
-    editableOcr: boolean;
-  };
-  INCODE_WATCHLIST: {
-    failIfFaceOnBlocklist: boolean;
-    addSuspectedFraudAutomatically: boolean;
-    autoExecution: boolean;
-  };
-  INSTANT_BAV: {
-    bavVendorCountry: 'US' | 'CA' | 'AU' | 'NZ' | 'BR' | 'MX' | 'CO' | 'UK' | 'EU';
-    bavNumberOfRetries: number;
-  };
-  ML_CONSENT: {
-    consentType: RegulationTypes;
-  };
-  NFC_SCAN: {
-    nfcAvailability: boolean;
-    nfcValidation: boolean;
-    showInitialDataConfirmationScreen: boolean;
-  };
-  PHONE: {
-    otpVerification: boolean;
-    otpExpirationInMinutes: number;
-    prefill: boolean;
-  };
-  SELFIE: {
-    showTutorial: boolean;
-    showPreview: boolean;
-    assistedOnboarding: boolean;
-    enableFaceRecording: boolean;
-    autoCaptureTimeout: number;
-    captureAttempts: number;
-    validateLenses: boolean;
-    validateFaceMask: boolean;
-    validateHeadCover: boolean;
-    validateClosedEyes: boolean;
-    validateBrightness: boolean;
-    deepsightLiveness: 'SINGLE_FRAME' | 'MULTIMODAL' | 'VIDEOLIVENESS';
-  };
-  SIGNATURE: {
-    title: string;
-    subTitle: string;
-  };
-  USER_CONSENT: {
-    title: string;
-    text: string;
-  };
-  CONFERENCE: {
-    enableConferenceOtp: boolean;
-  };
-  VIDEO_ONBOARDING: {
-    useAsSelfie: boolean;
-    showTutorials: boolean;
-    companyName: string;
-    checkLiveness: boolean;
-    checkIdScan: boolean;
-    checkDocumentScan: boolean;
-    compareIdEnabled: boolean;
-    compareOcrEnabled: boolean;
-    compareBackIdEnabled: boolean;
-    compareBackOcrEnabled: boolean;
-    checkVoiceConsent: boolean;
-    voiceConsentQuestions: number;
-    selfieQualityAffectsScore: boolean;
-    maxWaitingVideoSelfieFile: number;
-    lastSecondsVideoQualityCheck: boolean;
-    lastSecondsVideoQualityCheckDuration: number;
-    validateClosedEyes: boolean;
-    validateFaceMask: boolean;
-    validateHeadCover: boolean;
-    validateLenses: boolean;
-  };
-  DYNAMIC_FORMS: {
-    screens: {
-      title: string;
-      hideTitle: boolean;
-      questions: {
-        questionId: string;
-        overrides: string | null;
-        isPredefined: boolean;
-        predefinedQuestionType: string | null;
-        question: string;
-        inputType: 'NUMBER' | 'CPF' | 'COUNTRY' | 'NATIONALITY' | 'DATE' | 'PHONE' | 'EMAIL' | 'TEXT' | 'MULTISELECT' | 'YESNO' | 'SELECT';
-        options: string[];
-      }[];
-    }[];
-  };
-  COMBINED_CONSENT: {
-    combinedConsents: string;
-  };
-  QE_SIGNATURE: {
-    uploadDocument: boolean;
-    downloadDocument: boolean;
-  };
-  CERTIFICATE_ISSUANCE: {
-    region: string;
-    type: 'ONE_TIME' | 'SHORT_TERM' | 'LONG_TERM';
-  };
-  ANTIFRAUD: EmptyConfig;
-  CHECKBOX_SIGNATURE: EmptyConfig;
-  CROSS_DOCUMENT_DATA_MATCH: EmptyConfig;
-  DEVICE_FINGERPRINT: EmptyConfig;
-  FACE_ONBOARDING: EmptyConfig;
-  FIELD_COMPARISON: EmptyConfig;
-  FISCAL_QR: EmptyConfig;
-  GENERATE_QR: EmptyConfig;
-  INSTANT_VERIFY: EmptyConfig;
-  IP_ADDRESS: EmptyConfig;
-  NAME_CAPTURE: EmptyConfig;
-  SHOW_RESULTS: EmptyConfig;
-  STADIUM_SELECTOR: EmptyConfig;
-  UNIVERSAL_IDENTITY: EmptyConfig;
-  WATCHLIST: EmptyConfig;
-  TRUST_GRAPH: EmptyConfig;
-  WATCHLIST_BUSINESS: EmptyConfig;
-};
-type FlowModule = { [K in keyof FlowModuleConfig]: {
-  key: K;
-  configuration: FlowModuleConfig[K];
-} }[keyof FlowModuleConfig];
-type Flow = {
-  flowId: string;
-  name: string;
-  autoApproveEnabled?: boolean;
-  autoApproveLevel?: 'LOW' | 'MEDIUM' | 'HIGH';
-  checkTutorials?: boolean;
-  checkAuthorization?: boolean;
-  redirectDesktopToMobile?: boolean;
-  disableUnsupportedBrowserScreen?: boolean;
-  qrPhishingResistance?: boolean;
-  addContinueToDesktop?: boolean;
-  redirectOriginOnly?: boolean;
-  displayOnboardingResultOnDesktop?: boolean;
-  enableMultipleOnboardings?: boolean;
-  disableLaunchScreen?: boolean;
-  enableSardineRisk?: boolean;
-  mandatoryConsentCheck?: boolean;
-  disableSmsOption?: boolean;
-  mergeSessionRecordings?: boolean;
-  ageAssurance?: boolean;
-  flowModules: FlowModule[];
-  enforceCaptureAttemptLimits?: boolean;
-  enableFraudAi?: boolean;
-  getEnableIdOnlyIdentity?: boolean;
-  ds?: boolean;
-};
-//#endregion
-//#region src/modules/flow/flowAnalyzer.d.ts
+type FlowForNormalization = Pick<Flow, 'flowId' | 'flowModules' | 'redirectDesktopToMobile' | 'disableSmsOption' | 'addContinueToDesktop' | 'qrPhishingResistance'>;
 /**
  * Analyzes a flow configuration and returns the WASM pipelines needed.
  * Use this to conditionally warmup WASM only when required by the flow.
  *
+ * Modules with `onDeviceFaceResultsSubmissionEnabled: true` (currently SELFIE
+ * and AUTHENTICATION) select the 6-model `'onDeviceSelfie'` bundle instead of
+ * the default 4-model `'selfie'` bundle.
+ *
  * @param flow - The flow configuration from /omni/onboarding/flow
  * @returns Array of WASM pipelines needed (e.g., ['selfie', 'idCapture'])
  *
@@ -319,17 +37,37 @@ type Flow = {
  * ```
  */
 declare function getRequiredWasmPipelines(flow: Flow): WasmPipeline[];
+/**
+ * Normalizes flow modules by expanding TUTORIAL_ID into ID + SECOND_ID
+ * based on configuration flags. Matches legacy flowService behavior.
+ *
+ * - TUTORIAL_ID becomes ID (with same config)
+ * - If secondId: true, adds SECOND_ID module with isSecondId: true
+ * - thirdId is deprecated and ignored; the flow continues to the next step
+ * - Bare ID following TUTORIAL_ID is dropped (already merged)
+ */
+declare function normalizeFlowModules(flow: FlowForNormalization, options?: NormalizeFlowModulesOptions): FlowModule[];
 //#endregion
-//#region src/modules/flow/flowCompletionService.d.ts
-type FinishStatus = {
-  redirectionUrl: string;
-  action: 'approved' | 'rejected' | 'none';
-  scoreStatus: 'OK' | 'WARN' | 'MANUAL_OK' | 'FAIL' | 'UNKNOWN' | 'MANUAL_FAIL';
+//#region src/modules/flow/flowServices.d.ts
+type GetFlowOptions = {
+  isDesktop?: boolean;
+  authHint?: string;
+  lang?: string;
+  useCPF?: boolean;
 };
-type GetFinishStatusFn = (flowId: string | undefined | null, signal?: AbortSignal) => Promise<FinishStatus>;
+type GetFlow = (signal: AbortSignal, options?: GetFlowOptions) => Promise<Flow>;
+declare const getFlow: GetFlow;
 //#endregion
-//#region src/modules/flow/flowServices.d.ts
-type GetFlow = (signal: AbortSignal) => Promise<Flow>;
+//#region src/modules/flow/noOpFlowModuleMachine.d.ts
+declare const noOpFlowModuleMachine: xstate1002.StateMachine<xstate1002.MachineContext, xstate1002.AnyEventObject, {}, never, never, never, never, "finished", string, xstate1002.NonReducibleUnknown, xstate1002.NonReducibleUnknown, xstate1002.EventObject, xstate1002.MetaObject, {
+  readonly id: "noOpFlowModule";
+  readonly initial: "finished";
+  readonly states: {
+    readonly finished: {
+      readonly type: "final";
+    };
+  };
+}>;
 //#endregion
 //#region src/modules/flow/flowActor.d.ts
 type CreateFlowActorOptions = {
@@ -451,7 +189,7 @@ declare function createFlowManager(options?: CreateFlowActorOptions): Manager<Fl
    * @returns `true` if the module exists in the flow, `false` otherwise or if not in `ready` state
    */
   isModuleEnabled: (moduleKey: string) => boolean;
-};
+} & FlowEventSubscribable;
 //#endregion
 //#region src/modules/flow/moduleLoader.d.ts
 type LazyModule<T$1> = () => Promise<T$1>;
@@ -469,16 +207,17 @@ declare function createModuleLoader(registry: ModuleLoaderRegistry): ModuleLoade
 //#endregion
 //#region src/modules/flow/orchestratedFlowStateMachine.d.ts
 type GetFlowFn = (signal: AbortSignal) => Promise<Flow>;
-type ModuleRegistry = {
-  PHONE?: AnyStateMachine;
-  EMAIL?: AnyStateMachine;
-  SELFIE?: AnyStateMachine;
-  [key: string]: AnyStateMachine | undefined;
+type LazyModuleRegistry = {
+  [key: string]: (() => Promise<AnyStateMachine | {
+    default: AnyStateMachine;
+  }>) | undefined;
 };
 type OrchestratedFlowInput = {
   getFlow: GetFlowFn;
-  modules: ModuleRegistry;
+  modules?: ModuleRegistry;
+  lazyModules?: LazyModuleRegistry;
   getFinishStatus?: GetFinishStatusFn;
+  enableHome?: boolean;
 };
 type OrchestratedFlowEvent = {
   type: 'LOAD';
@@ -488,6 +227,10 @@ type OrchestratedFlowEvent = {
   type: 'RESET';
 } | {
   type: 'MODULE_COMPLETE';
+} | {
+  type: 'COMPLETE_FLOW';
+} | {
+  type: 'HOME_CONTINUE';
 } | {
   type: '*';
   [key: string]: unknown;
@@ -497,11 +240,24 @@ type OrchestratedFlowEvent = {
 };
 //#endregion
 //#region src/modules/flow/orchestratedFlowManager.d.ts
+type OrchestratedFlowHomeScreen = {
+  visible: boolean;
+  isContinueLoading: boolean;
+};
+type OrchestratedFlowPresentation = {
+  isAwaitingReady: boolean;
+  lazyModuleKey: string | undefined;
+  shouldPrefetchHome: boolean;
+};
 type OrchestratedFlowIdleState = {
   status: 'idle';
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
 };
 type OrchestratedFlowLoadingState = {
   status: 'loading';
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
 };
 type OrchestratedFlowReadyState = {
   status: 'ready';
@@ -511,6 +267,8 @@ type OrchestratedFlowReadyState = {
   currentStep: string | undefined;
   config: unknown;
   moduleState: unknown;
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
 };
 type OrchestratedFlowFinishedState = {
   status: 'finished';
@@ -520,16 +278,23 @@ type OrchestratedFlowFinishedState = {
     action: 'approved' | 'rejected' | 'none';
     scoreStatus: 'OK' | 'WARN' | 'MANUAL_OK' | 'FAIL' | 'UNKNOWN' | 'MANUAL_FAIL';
   };
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
 };
 type OrchestratedFlowErrorState = {
   status: 'error';
   error: string;
+  errorCode?: number;
+  homeScreen: OrchestratedFlowHomeScreen;
+  presentation: OrchestratedFlowPresentation;
 };
 type OrchestratedFlowState = OrchestratedFlowIdleState | OrchestratedFlowLoadingState | OrchestratedFlowReadyState | OrchestratedFlowFinishedState | OrchestratedFlowErrorState;
 type CreateOrchestratedFlowActorOptions = {
   getFlow?: GetFlowFn;
-  modules: ModuleRegistry;
+  modules?: ModuleRegistry;
+  lazyModules?: LazyModuleRegistry;
   getFinishStatus?: OrchestratedFlowInput['getFinishStatus'];
+  enableHome?: boolean;
 };
 declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowActorOptions): Manager<OrchestratedFlowState> & {
   /**
@@ -557,6 +322,11 @@ declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowAc
    * ```
    */
   completeModule(): void;
+  /**
+   * Skip all remaining modules and go straight to the completion step.
+   * Used when the flow was completed externally (e.g. via redirect to mobile).
+   */
+  completeFlow(): void;
   /**
    * Signal that the current module encountered an error.
    * Call this from your UI component's `onError` callback if you want
@@ -573,6 +343,16 @@ declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowAc
   readonly canNext: boolean;
   getModuleConfig: <T$1 = unknown>(moduleKey: string) => T$1 | undefined;
   isModuleEnabled: (moduleKey: string) => boolean;
-};
+  isAwaitingOrchestratorReady(): boolean;
+  /**
+   * Resolve once the orchestrator has finished loading the flow and the first
+   * module is ready to render. Useful for gating an initialization spinner
+   * alongside other parallel async work (e.g. theme fetching).
+   */
+  waitForReady(): Promise<void>;
+  getLazyModuleKey(): string | undefined;
+  shouldRenderHomeScreen(): boolean;
+  continueFromHome(): Promise<void>;
+} & FlowEventSubscribable;
 //#endregion
-export { type FinishStatus, type Flow, type FlowModule, type FlowModuleConfig, type FlowReadyState, type FlowState, type LazyModule, type ModuleLoader, type ModuleLoaderRegistry, type ModuleRegistry, type OrchestratedFlowFinishedState, type OrchestratedFlowInput, type OrchestratedFlowReadyState, type OrchestratedFlowState, createFlowManager, createModuleLoader, createOrchestratedFlowManager, getRequiredWasmPipelines };
+export { type FinishStatus, type Flow, type FlowModule, type FlowModuleConfig, type FlowReadyState, type FlowState, type LazyModule, type LazyModuleRegistry, type ModuleLoader, type ModuleLoaderRegistry, type ModuleRegistry, type OrchestratedFlowFinishedState, type OrchestratedFlowHomeScreen, type OrchestratedFlowInput, type OrchestratedFlowPresentation, type OrchestratedFlowReadyState, type OrchestratedFlowState, createFlowManager, createModuleLoader, createOrchestratedFlowManager, getFlow, getRequiredWasmPipelines, noOpFlowModuleMachine, normalizeFlowModules };