@incodetech/core 2.1.0-rc.0 → 2.1.0-rc.2

package/dist/{faceCaptureManagerFactory-kqbUqtrr.esm.js → faceCaptureManagerFactory-BNXZchWX.esm.js}

@@ -1,7 +1,7 @@
-import { n as eventModuleNames, o as createManagerInstrumentation, r as eventScreenNames } from "./events-Dvvriq9l.esm.js";
-import { c as createManager } from "./xstate.esm-C9wncMQa.esm.js";
-import { n as setWasmDsFlagSync } from "./BrowserStorageProvider-BpJM-gIl.esm.js";
-import { r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-CG3bMSfG.esm.js";
+import { n as eventModuleNames, o as topLevelStateName, r as eventScreenNames, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import { c as createManager } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { n as BrowserVisibilityObserverProvider, r as setWasmDsFlagSync } from "./BrowserStorageProvider-D5xc7Lqo.esm.js";
+import { r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-CPDboRoE.esm.js";
 
 //#region src/internal/faceCapture/faceCaptureManagerFactory.ts
 function getPermissionStatus(snapshot) {
@@ -194,14 +194,10 @@ function getAuthFaceCaptureSubstateScreen(snapshot) {
 	}
 	return eventScreenNames.authFace;
 }
-function getTopLevelState(value) {
-	if (typeof value === "string") return value;
-	if (typeof value === "object") return Object.keys(value)[0];
-}
 function getAuthFaceScreenName(snapshot) {
 	const { value } = snapshot;
 	if (value === void 0 || value === null) return void 0;
-	const topLevel = getTopLevelState(value);
+	const topLevel = topLevelStateName(value);
 	if (topLevel === void 0) return void 0;
 	switch (topLevel) {
 		case "tutorial": return eventScreenNames.authFaceTutorial;
@@ -220,7 +216,7 @@ function getFaceCaptureScreenName(snapshot, moduleName) {
 	if (moduleName === eventModuleNames.authFace || moduleName === eventModuleNames.authentication) return getAuthFaceScreenName(snapshot);
 	const { value } = snapshot;
 	if (value === void 0 || value === null) return void 0;
-	const topLevel = getTopLevelState(value);
+	const topLevel = topLevelStateName(value);
 	if (topLevel === void 0) return void 0;
 	switch (topLevel) {
 		case "idle": return "faceCapture.loading.processing";
@@ -285,19 +281,104 @@ function createApi({ actor, trackElementClicked, trackCaptureAttemptFinished })
 		}
 	};
 }
+/**
+* Figma-aligned, machine-stable reason token per face error code. Mirrors the
+* leaf used by `getResultErrorScreen` (e.g. `LENSES_DETECTED` → `lensesDetected`)
+* so the `errorTriggered` payload, error name and screen name stay in sync with
+* the Face Capture Figma `resultError.*` frames.
+*/
+function getFaceErrorReason(errorCode) {
+	switch (errorCode) {
+		case "LENSES_ERROR":
+		case "LENSES_DETECTED": return "lensesDetected";
+		case "BRIGHTNESS_ERROR": return "tooBright";
+		case "MASK_ERROR":
+		case "FACE_MASK_DETECTED": return "faceMaskDetected";
+		case "FACE_TOO_DARK":
+		case "TOO_DARK_ERROR": return "tooDark";
+		case "CLOSED_EYES_ERROR":
+		case "CLOSED_EYES_DETECTED": return "eyesClosed";
+		case "HEAD_COVER_ERROR":
+		case "HEAD_COVER_DETECTED": return "headCovered";
+		case "FACE_OCCLUDED": return "faceOcclusion";
+		case "TOO_BLURRY_ERROR":
+		case "FACE_TOO_BLURRY":
+		case "BAD_PHOTO_QUALITY":
+		case "SELFIE_IMAGE_LOW_QUALITY": return "lowQuality";
+		case "SERVER_ERROR":
+		case "PROCESSING_ERROR":
+		case "BAD_REQUEST": return "processingFailed";
+		case "FACE_NOT_FOUND":
+		case "MULTIPLE_FACES":
+		case "FACE_CROPPING_FAILED":
+		case "FACE_TOO_SMALL":
+		case "LIVENESS_ERROR":
+		default: return "faceNotAligned";
+	}
+}
+/**
+* Reports whether the given `capture` substate is active in a raw XState value
+* without needing a live snapshot (so it works on the plain objects used in
+* tests). Robust to parallel states (checks membership rather than the first
+* key).
+*/
+function isFaceCaptureSubstateActive(value, name) {
+	if (typeof value !== "object" || value === null) return false;
+	const capture = value.capture;
+	if (typeof capture === "string") return capture === name;
+	if (typeof capture === "object" && capture !== null) return name in capture;
+	return false;
+}
+/**
+* Figma-aligned error name for every Face Capture error state. Returned without
+* the module prefix — the instrumentation adapter prepends the module token to
+* produce e.g. `faceCapture.error.lensesDetected`. Returning `undefined` means
+* "not an error state", which suppresses `errorTriggered`.
+*
+* Covers: recoverable result errors (`capture.uploadError`), the bad-network
+* screen (`detecting` + `detectionStatus === 'offline'`), and the fatal
+* top-level `error` state.
+*/
+function getFaceCaptureErrorName(snapshot) {
+	const topLevel = topLevelStateName(snapshot.value);
+	if (topLevel === void 0) return void 0;
+	if (topLevel === "error") return "error.unknown";
+	if (topLevel === "capture") {
+		if (isFaceCaptureSubstateActive(snapshot.value, "uploadError")) return `error.${getFaceErrorReason(snapshot.context.uploadError)}`;
+		if (isFaceCaptureSubstateActive(snapshot.value, "detecting") && snapshot.context.detectionStatus === "offline") return "error.noConnection";
+	}
+}
 function getFaceCaptureErrorPayload(snapshot) {
+	const topLevel = topLevelStateName(snapshot.value);
+	if (topLevel === "error") return { reason: "fatal" };
+	if (topLevel === "capture" && isFaceCaptureSubstateActive(snapshot.value, "detecting") && snapshot.context.detectionStatus === "offline") return { reason: "noConnection" };
 	const errorCode = snapshot.context.uploadError;
 	if (typeof errorCode !== "string" || errorCode.length === 0) return;
-	return { errorCode };
+	return {
+		errorCode,
+		reason: getFaceErrorReason(errorCode)
+	};
 }
-function createFaceCaptureManagerFromActor(actor, moduleName) {
+/**
+* Builds a face capture manager (selfie / authentication / captureOnly) from an
+* already-created actor.
+*
+* `visibilityObserver` defaults to the browser `document.visibilitychange`
+* provider so first-party and BYO-actor callers get foreground/background
+* events without extra wiring. Construction lives here — a documented, narrow
+* deviation from "never `new` a provider inside Core" (see
+* `docs/patterns/CAPABILITY.md`). Pass a fake/no-op to override (tests do).
+*/
+function createFaceCaptureManagerFromActor(actor, moduleName, visibilityObserver = new BrowserVisibilityObserverProvider()) {
 	return createManager({
 		actor,
 		mapState,
 		createApi,
 		instrumentation: createManagerInstrumentation(moduleName, {
 			getEventScreenName: (snapshot) => getFaceCaptureScreenName(snapshot, moduleName),
-			getErrorPayload: getFaceCaptureErrorPayload
+			getErrorName: getFaceCaptureErrorName,
+			getErrorPayload: getFaceCaptureErrorPayload,
+			visibilityObserver
 		})
 	});
 }

package/dist/{faceCaptureManagerFactory-C_hRHx8a.d.ts → faceCaptureManagerFactory-CL-7T_vH.d.ts}

@@ -1,12 +1,11 @@
-import { n as WasmPipeline } from "./warmup-Dg8Lh-50.js";
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import { t as ActorRefFrom } from "./Actor-Y0_Fj-KL.js";
-import { n as StateMachine, t as AnyStateMachine } from "./StateMachine-BC_nGvrc.js";
-import { t as CameraStream } from "./camera-SRBpPq2X.js";
-import { i as FlowModuleConfig, n as Flow } from "./types-DOUhndhT.js";
-import { a as IMLProviderCapability, c as IRecordingCapability, n as IWasmUtilCapability, o as MLProviderConfig, s as IStorageCapability, t as DeepsightService } from "./deepsightService-B7ShOkWL.js";
-import { n as PermissionStatus, t as PermissionResult } from "./types-ya0LN_MX.js";
-import { n as IncodeCanvas, t as StreamCanvasCapture } from "./StreamCanvasCapture-yyl20qd9.js";
+import { n as WasmPipeline } from "./warmup--6HA3yUR.js";
+import { n as AnyStateMachine, r as StateMachine, t as Manager } from "./Manager-B2OEDYqf.js";
+import { t as ActorRefFrom } from "./Actor-fIPLXfoi.js";
+import { a as IMLProviderCapability, c as IRecordingCapability, n as IWasmUtilCapability, o as MLProviderConfig, s as IStorageCapability, t as DeepsightService, u as IVisibilityObserverCapability } from "./deepsightService-ByNKY5Jv.js";
+import { t as CameraStream } from "./camera-biGPWlmx.js";
+import { i as FlowModuleConfig, n as Flow } from "./types-Dv-9WPJX.js";
+import { n as PermissionStatus, t as PermissionResult } from "./types-F0IXbaCB.js";
+import { n as IncodeCanvas, t as StreamCanvasCapture } from "./StreamCanvasCapture-Ctgyx-oD.js";
 
 //#region src/modules/authentication/authenticationStateMachine.d.ts
 declare const _authenticationMachine: AnyStateMachine;
@@ -115,6 +114,7 @@ declare const FACE_ERROR_CODES: {
   readonly NONEXISTENT_CUSTOMER: "NONEXISTENT_CUSTOMER";
   readonly HINT_NOT_PROVIDED: "HINT_NOT_PROVIDED";
   readonly SELFIE_IMAGE_LOW_QUALITY: "SELFIE_IMAGE_LOW_QUALITY";
+  readonly NO_MORE_ATTEMPTS: "NO_MORE_ATTEMPTS";
 };
 type FaceErrorCode = (typeof FACE_ERROR_CODES)[keyof typeof FACE_ERROR_CODES];
 //#endregion
@@ -406,13 +406,20 @@ type SelfieConfig = FlowModuleConfig['SELFIE'] & BaseFaceCaptureConfig;
 /**
  * Public selfie configuration for the captureOnly flow.
  *
- * Differs from {@link SelfieConfig} by requiring an `onCapture` callback —
- * captureOnly bypasses the Incode upload pipeline and delivers the rich
- * capture payload locally instead. Compile-time enforcement (vs. a runtime
- * check) prevents shipping a captureOnly flow with no destination for the
- * payload.
+ * captureOnly bypasses the Incode upload/processing pipeline, so this config
+ * intentionally exposes ONLY the options that affect the on-device capture
+ * experience: the tutorial/preview UX, attempts, timeout, and the on-device
+ * face validations. Backend-coupled flags of {@link SelfieConfig} (face
+ * recording, assisted onboarding, on-device results submission, …) don't apply
+ * here and are omitted.
+ *
+ * `onCapture` is the one required field — it receives the captured image
+ * locally (compile-time enforced so you can't ship a captureOnly flow with no
+ * destination for the payload). Everything else is optional and defaulted by
+ * the factory (see `DEFAULT_SELFIE_CAPTURE_ONLY_CONFIG`); set only what you care
+ * about, e.g. `{ onCapture, captureAttempts: 5, validateBrightness: true }`.
  */
-type SelfieCaptureOnlyConfig = SelfieConfig & {
+type SelfieCaptureOnlyConfig = Partial<Pick<SelfieConfig, 'showTutorial' | 'showPreview' | 'captureAttempts' | 'autoCaptureTimeout' | 'validateLenses' | 'validateFaceMask' | 'validateHeadCover' | 'validateClosedEyes' | 'validateBrightness'>> & {
   onCapture: (response: FaceCaptureOnlyResponse) => void | Promise<void>;
 };
 type SelfieDependencies = FaceCaptureDependencies;
@@ -659,7 +666,17 @@ type FaceCaptureErrorState = {
 };
 /** Union of all possible face capture states */
 type FaceCaptureManagerState = FaceCaptureIdleState | FaceCaptureLoadingState | FaceCaptureTutorialState | FaceCapturePermissionsState | FaceCaptureCaptureState | FaceCaptureProcessingState | FaceCaptureFinishedState | FaceCaptureClosedState | FaceCaptureErrorState;
-declare function createFaceCaptureManagerFromActor(actor: FaceCaptureActor, moduleName: string): Manager<FaceCaptureManagerState> & {
+/**
+ * Builds a face capture manager (selfie / authentication / captureOnly) from an
+ * already-created actor.
+ *
+ * `visibilityObserver` defaults to the browser `document.visibilitychange`
+ * provider so first-party and BYO-actor callers get foreground/background
+ * events without extra wiring. Construction lives here — a documented, narrow
+ * deviation from "never `new` a provider inside Core" (see
+ * `docs/patterns/CAPABILITY.md`). Pass a fake/no-op to override (tests do).
+ */
+declare function createFaceCaptureManagerFromActor(actor: FaceCaptureActor, moduleName: string, visibilityObserver?: IVisibilityObserverCapability): Manager<FaceCaptureManagerState> & {
   /**
    * Starts the face capture flow.
    * Goes to `tutorial` if showTutorial is true, otherwise to `loading`.

package/dist/{faceCaptureSetup-CtvHWd3x.esm.js → faceCaptureSetup-Dqb09D24.esm.js}

@@ -1,10 +1,10 @@
-import { r as getToken } from "./api-CESGtpbH.esm.js";
-import { a as fromPromise, i as fromCallback, r as assign, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import { n as invokeRequestPermissionActor, t as checkPermission } from "./permissionServices-CG3bMSfG.esm.js";
-import { d as sendLabelInspectionEvent, f as startDetection, l as initializeCamera, n as preloadOpenViduProvider, p as stopStream, r as flagFaceManualReview, t as createRecordingService, u as initializeDeepsightSession } from "./recordingService-Bn9EdCmz.esm.js";
-import { t as FACE_ERROR_CODES } from "./types-DsnEVMhr.esm.js";
-import { t as StreamCanvasCapture } from "./StreamCanvasCapture-ImiDQdVA.esm.js";
-import { n as needsMotionPrimeOnlyFromPermission, r as resolveStoredPermissionResult, t as isReadyForCaptureFromPermission } from "./permissionGuards-C1ispV96.esm.js";
+import { r as getToken } from "./api-DUZwyz0o.esm.js";
+import { a as fromPromise, i as fromCallback, r as assign, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { n as invokeRequestPermissionActor, t as checkPermission } from "./permissionServices-CPDboRoE.esm.js";
+import { d as sendLabelInspectionEvent, f as startDetection, l as initializeCamera, n as preloadOpenViduProvider, p as stopStream, r as flagFaceManualReview, t as createRecordingService, u as initializeDeepsightSession } from "./recordingService-CxMJP4tQ.esm.js";
+import { t as FACE_ERROR_CODES } from "./types-BdVOWGGW.esm.js";
+import { t as StreamCanvasCapture } from "./StreamCanvasCapture-Dr5n_iK1.esm.js";
+import { n as needsMotionPrimeOnlyFromPermission, r as resolveStoredPermissionResult, t as isReadyForCaptureFromPermission } from "./permissionGuards-D-Z-lgNj.esm.js";
 
 //#region src/internal/faceCapture/faceCaptureSetup.ts
 const getAttemptsFromConfig = (config) => {

package/dist/{faceMatchStateMachine-DdGXUBnx.esm.js → faceMatchStateMachine-FikRaUZH.esm.js}

@@ -1,6 +1,6 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
 
 //#region src/modules/face-match/constants.ts
 /**
@@ -67,9 +67,11 @@ async function fetchSecondIdImages(signal) {
 /**
 * Triggers server-side face processing/matching for the captured selfie.
 *
-* Used when an AUTHENTICATION module is present in the flow (`processFaceBeforeMatch`):
-* the auth capture step skips server-side processing, so the match must be triggered here
-* before `GET /omni/get/score` reflects it. Mirrors SDK 1's FaceMatch module.
+* Always run by face-match before reading the score, mirroring SDK 1's FaceMatch module.
+* Some capture steps skip server-side face processing (e.g. AUTHENTICATION and the
+* capture-only selfie variant), so the match must be (re)triggered here before
+* `GET /omni/get/score` can reflect it. When the selfie was already processed upstream
+* (e.g. the regular selfie module) this is a harmless reprocess.
 *
 * The response body is intentionally ignored — face-match re-reads the result via
 * `fetchScore`. A non-ok response throws an Error carrying the backend `status`/`data` so
@@ -91,7 +93,7 @@ async function processFaceForMatch(matchingType, signal) {
 * Fetches all face match data in parallel (images, score, and optionally second ID images).
 */
 async function fetchFaceMatchData(config, signal) {
-	if (config.processFaceBeforeMatch) await processFaceForMatch(config.matchingType, signal);
+	await processFaceForMatch(config.matchingType, signal);
 	const promises = [fetchFaceMatchImages(signal), fetchScore(signal)];
 	if (config.matchingType === "secondId") promises.push(fetchSecondIdImages(signal));
 	const [imagesRes, resultRes, secondIdRes] = await Promise.all(promises);

package/dist/field-comparison.d.ts

@@ -1,4 +1,4 @@
-import "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import { a as FieldComparisonActor, c as FieldComparisonFields, i as createFieldComparisonManagerFromActor, n as FieldComparisonState, o as fieldComparisonMachine, r as createFieldComparisonManager, s as FieldComparisonConfig, t as FieldComparisonManager } from "./fieldComparisonManager-Bu5TaSr3.js";
+import "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import { a as FieldComparisonActor, c as FieldComparisonFields, i as createFieldComparisonManagerFromActor, n as FieldComparisonState, o as fieldComparisonMachine, r as createFieldComparisonManager, s as FieldComparisonConfig, t as FieldComparisonManager } from "./fieldComparisonManager-BXc6-DJv.js";
 export { type FieldComparisonActor, type FieldComparisonConfig, type FieldComparisonFields, type FieldComparisonManager, type FieldComparisonState, createFieldComparisonManager, createFieldComparisonManagerFromActor, fieldComparisonMachine };

package/dist/field-comparison.esm.js

@@ -1,7 +1,7 @@
-import "./api-CESGtpbH.esm.js";
-import "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./xstate.esm-C9wncMQa.esm.js";
-import { n as createFieldComparisonManagerFromActor, r as fieldComparisonMachine, t as createFieldComparisonManager } from "./fieldComparisonManager-COGI2ARD.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./xstate.esm-Dkm1jy5u.esm.js";
+import { n as createFieldComparisonManagerFromActor, r as fieldComparisonMachine, t as createFieldComparisonManager } from "./fieldComparisonManager-Dic0DVgl.esm.js";
 
 export { createFieldComparisonManager, createFieldComparisonManagerFromActor, fieldComparisonMachine };

package/dist/{fieldComparisonManager-Bu5TaSr3.d.ts → fieldComparisonManager-BXc6-DJv.d.ts}

@@ -1,5 +1,5 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import { t as ActorRefFrom } from "./Actor-Y0_Fj-KL.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import { t as ActorRefFrom } from "./Actor-fIPLXfoi.js";
 
 //#region src/modules/field-comparison/types.d.ts
 

package/dist/{fieldComparisonManager-COGI2ARD.esm.js → fieldComparisonManager-Dic0DVgl.esm.js}

@@ -1,7 +1,7 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { n as eventModuleNames, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
 
 //#region src/modules/field-comparison/fieldComparisonServices.ts
 /** Submit first and last name for backend field comparison. Throws on failure. */

package/dist/fiscal-qr.d.ts

@@ -1,6 +1,6 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import "./camera-SRBpPq2X.js";
-import "./StreamCanvasCapture-yyl20qd9.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import "./camera-biGPWlmx.js";
+import "./StreamCanvasCapture-Ctgyx-oD.js";
 
 //#region src/modules/fiscal-qr/types.d.ts
 /**

package/dist/fiscal-qr.esm.js

@@ -1,15 +1,15 @@
-import { t as BrowserTimerProvider } from "./BrowserTimerProvider-DhNc_x02.esm.js";
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { h as addEvent, n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import "./platform-SKvEfCBh.esm.js";
-import { a as fromPromise, c as createManager, i as fromCallback, r as assign, s as createActor, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import { i as stopCameraStream } from "./camera-DJWm3V4g.esm.js";
-import "./ITimerCapability-CB0I1Uf2.esm.js";
-import "./canvas-SKcRBxsk.esm.js";
-import { n as getBackCameraStream } from "./backCameraStream-D7Wo4Nbx.esm.js";
-import { t as StreamCanvasCapture } from "./StreamCanvasCapture-ImiDQdVA.esm.js";
-import "./http-Cai3IoLS.esm.js";
+import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BVgutW_b.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { g as addEvent, n as eventModuleNames, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import "./platform-BfoqeM61.esm.js";
+import { a as fromPromise, c as createManager, i as fromCallback, r as assign, s as createActor, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { i as stopCameraStream } from "./camera-x4LjGTjZ.esm.js";
+import "./ITimerCapability-BvH0pDwp.esm.js";
+import "./canvas-7uX2izHb.esm.js";
+import { n as getBackCameraStream } from "./backCameraStream-iftkf3rd.esm.js";
+import { t as StreamCanvasCapture } from "./StreamCanvasCapture-Dr5n_iK1.esm.js";
+import "./http-CfVTgMfU.esm.js";
 import { BrowserQRCodeReader } from "@zxing/browser";
 
 //#region src/modules/fiscal-qr/fiscalQrConstants.ts

package/dist/flow-events.d.ts

@@ -1,7 +1,7 @@
-import "./camera-SRBpPq2X.js";
-import "./types-Bj9hdFjU.js";
-import "./types-DvGZI7BF.js";
-import "./types-DOUhndhT.js";
-import "./flowCompletionService-BdR2cGgB.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-B5hPA0Bg.js";
+import "./camera-biGPWlmx.js";
+import "./types-Z9wv19v2.js";
+import "./types-DYZja-k9.js";
+import "./types-Dv-9WPJX.js";
+import "./flowCompletionService-CdGDKv0z.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-BgxYUYuD.js";
 export { FlowClosedEvent, FlowCompletedEvent, FlowErrorEvent, FlowEvent, FlowEventListener, FlowEventSubscribable, FlowModuleCompletedEvent, FlowModuleStartedEvent, FlowReadyEvent, FlowStartedEvent };

package/dist/flow.d.ts

@@ -1,14 +1,13 @@
-import { n as WasmPipeline } from "./warmup-Dg8Lh-50.js";
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import { t as AnyStateMachine } from "./StateMachine-BC_nGvrc.js";
-import "./camera-SRBpPq2X.js";
-import "./types-Bj9hdFjU.js";
-import "./types-DvGZI7BF.js";
-import { i as FlowModuleConfig, n as Flow, r as FlowModule } from "./types-DOUhndhT.js";
-import { n as GetFinishStatusFn, t as FinishStatus } from "./flowCompletionService-BdR2cGgB.js";
-import { o as FlowEventSubscribable } from "./index-B5hPA0Bg.js";
-import { n as ModuleRegistry } from "./types-NuT8ftBV.js";
-import * as xstate715 from "xstate";
+import { n as WasmPipeline } from "./warmup--6HA3yUR.js";
+import { n as AnyStateMachine, t as Manager } from "./Manager-B2OEDYqf.js";
+import "./camera-biGPWlmx.js";
+import "./types-Z9wv19v2.js";
+import "./types-DYZja-k9.js";
+import { i as FlowModuleConfig, n as Flow, r as FlowModule } from "./types-Dv-9WPJX.js";
+import { a as classifyScoreStatus, i as TotalScore, n as FinishStatus, r as GetFinishStatusFn, s as getTotalScoreStatus, t as FinishScreenVariant } from "./flowCompletionService-CdGDKv0z.js";
+import { o as FlowEventSubscribable } from "./index-BgxYUYuD.js";
+import { n as ModuleRegistry } from "./types-DpTWgfKY.js";
+import * as xstate1266 from "xstate";
 
 //#region src/modules/flow/flowUtils.d.ts
 type NormalizeFlowModulesOptions = {
@@ -60,7 +59,7 @@ type GetFlow = (signal: AbortSignal, options?: GetFlowOptions) => Promise<Flow>;
 declare const getFlow: GetFlow;
 //#endregion
 //#region src/modules/flow/noOpFlowModuleMachine.d.ts
-declare const noOpFlowModuleMachine: xstate715.StateMachine<xstate715.MachineContext, xstate715.AnyEventObject, {}, never, never, never, never, "finished", string, xstate715.NonReducibleUnknown, xstate715.NonReducibleUnknown, xstate715.EventObject, xstate715.MetaObject, {
+declare const noOpFlowModuleMachine: xstate1266.StateMachine<xstate1266.MachineContext, xstate1266.AnyEventObject, {}, never, never, never, never, "finished", string, xstate1266.NonReducibleUnknown, xstate1266.NonReducibleUnknown, xstate1266.EventObject, xstate1266.MetaObject, {
   readonly id: "noOpFlowModule";
   readonly initial: "finished";
   readonly states: {
@@ -230,6 +229,8 @@ type OrchestratedFlowEvent = {
   type: 'MODULE_COMPLETE';
 } | {
   type: 'COMPLETE_FLOW';
+} | {
+  type: 'FINISH_FLOW';
 } | {
   type: 'HOME_CONTINUE';
 } | {
@@ -288,6 +289,7 @@ type OrchestratedFlowErrorState = {
   status: 'error';
   error: string;
   errorCode?: number;
+  moduleErrorCode?: string;
   homeScreen: OrchestratedFlowHomeScreen;
   presentation: OrchestratedFlowPresentation;
 };
@@ -326,10 +328,18 @@ 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).
+   * Skip all remaining modules and complete the flow now, notifying the
+   * backend (getFinishStatus) on the way to the completion step.
    */
   completeFlow(): void;
+  /**
+   * Finish the flow because the onboarding was already completed externally —
+   * e.g. the REDIRECT_TO_MOBILE handoff finished end-to-end on mobile. Lands
+   * on the completion screen WITHOUT calling getFinishStatus: mobile already
+   * notified the backend, and the desktop never reached its own finish.
+   * Use this (not `completeFlow`) from REDIRECT_TO_MOBILE's `onFinish`.
+   */
+  finishFlow(): void;
   /**
    * Signal that the current module encountered a terminal error, optionally
    * with its machine-readable `moduleErrorCode`. The flow machine decides what
@@ -363,4 +373,4 @@ declare function createOrchestratedFlowManager(options: CreateOrchestratedFlowAc
   continueFromHome(): Promise<void>;
 } & FlowEventSubscribable;
 //#endregion
-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 };
+export { type FinishScreenVariant, 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, type TotalScore, classifyScoreStatus, createFlowManager, createModuleLoader, createOrchestratedFlowManager, getFlow, getRequiredWasmPipelines, getTotalScoreStatus, noOpFlowModuleMachine, normalizeFlowModules };

package/dist/flow.esm.js

@@ -1,19 +1,21 @@
-import "./api-CESGtpbH.esm.js";
-import { h as addEvent } from "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./stats-BMNUG1AU.esm.js";
-import "./IpifyProvider-D4LWD15E.esm.js";
-import "./browserSimulation-B1dWiXp7.esm.js";
-import "./sessionInitializer-B8H5MsXM.esm.js";
-import "./platform-SKvEfCBh.esm.js";
-import "./getBrowser-C8DP7oTB.esm.js";
-import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
-import "./apiError-B-j-gyDx.esm.js";
-import "./types-DsnEVMhr.esm.js";
-import "./session-DoVb-OcB.esm.js";
-import { n as getRequiredWasmPipelines, r as normalizeFlowModules, t as getFlow } from "./flowServices-BTuHLHVr.esm.js";
-import { n as isAdvanceableError, r as attachFlowEventEmitter, t as runChildModule } from "./runChildModule-CuoHZ1cx.esm.js";
-import { t as getFinishStatus } from "./flowCompletionService-DdGojV9K.esm.js";
+import "./BrowserTimerProvider-BVgutW_b.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import { g as addEvent } from "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import "./stats-DntyIiGr.esm.js";
+import "./IpifyProvider-oZf7Ke1O.esm.js";
+import "./browserSimulation-CGjpdNA1.esm.js";
+import "./sessionInitializer-CaiGA8GP.esm.js";
+import "./platform-BfoqeM61.esm.js";
+import "./getBrowser-Dv8LZyHE.esm.js";
+import "./tri-CtxWthxz.esm.js";
+import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-Dkm1jy5u.esm.js";
+import "./apiError-D-GTvFrH.esm.js";
+import "./types-BdVOWGGW.esm.js";
+import "./session-Be_IA1e0.esm.js";
+import { n as getRequiredWasmPipelines, r as normalizeFlowModules, t as getFlow } from "./flowServices-ar5DXv71.esm.js";
+import { n as getFinishStatus, r as getTotalScoreStatus, t as classifyScoreStatus } from "./flowCompletionService-D_CsiDZM.esm.js";
+import { n as isAdvanceableError, r as attachFlowEventEmitter, t as runChildModule } from "./runChildModule-C9G0wfVC.esm.js";
 
 //#region src/modules/flow/noOpFlowModuleMachine.ts
 const noOpFlowModuleMachine = setup({}).createMachine({
@@ -310,13 +312,6 @@ function getModuleConfig(module, flow) {
 		...config,
 		ageAssurance: config.ageAssurance ?? flow?.ageAssurance
 	};
-	if (module?.key === "FACE_MATCH") {
-		const hasAuthentication = flow?.flowModules?.some((m) => m.key === "AUTHENTICATION") ?? false;
-		return {
-			...config,
-			processFaceBeforeMatch: hasAuthentication
-		};
-	}
 	return config;
 }
 function createBaseContext(context, isHomeContinueLoading) {
@@ -434,6 +429,7 @@ const orchestratedFlowMachine = setup({
 			prefetchNextLazyModule(context);
 		},
 		setFinishStatus: assign(({ event }) => ({ finishStatus: event.output })),
+		setFinishStatusFailed: assign({ moduleErrorCode: "FINISH_STATUS_FAILED" }),
 		setModuleErrorCode: assign(({ event }) => ({ moduleErrorCode: event.moduleErrorCode })),
 		trackAdvanceableModuleError: ({ context, event }) => {
 			addEvent({
@@ -451,6 +447,7 @@ const orchestratedFlowMachine = setup({
 		isAdvanceableModuleErrorOnLastStep: ({ context, event }) => isAdvanceableError(event.moduleErrorCode) && context.currentStepIndex >= 0 && context.currentStepIndex === context.steps.length - 1,
 		isLastStep: ({ context }) => context.currentStepIndex >= 0 && context.currentStepIndex === context.steps.length - 1,
 		canGoNext: ({ context }) => context.currentStepIndex >= 0 && context.currentStepIndex < context.steps.length - 1,
+		isOnboardingFinishedSignal: ({ event }) => event.output?.action === "onboardingFinished",
 		shouldEnterHome: ({ context }) => shouldEnterHome(context),
 		hasModule: ({ context, event }) => {
 			if (!("output" in event)) return false;
@@ -577,13 +574,20 @@ const orchestratedFlowMachine = setup({
 				}
 			},
 			on: {
-				MODULE_COMPLETE: [{
-					target: "completing",
-					guard: "isLastStep"
-				}, {
-					target: "resolvingModule",
-					actions: "incrementStep"
-				}],
+				MODULE_COMPLETE: [
+					{
+						target: "finished",
+						guard: "isOnboardingFinishedSignal"
+					},
+					{
+						target: "completing",
+						guard: "isLastStep"
+					},
+					{
+						target: "resolvingModule",
+						actions: "incrementStep"
+					}
+				],
 				MODULE_ERROR: [
 					{
 						guard: "isAdvanceableModuleErrorOnLastStep",
@@ -605,6 +609,7 @@ const orchestratedFlowMachine = setup({
 					}
 				],
 				COMPLETE_FLOW: { target: "completing" },
+				FINISH_FLOW: { target: "finished" },
 				RESET: {
 					target: "idle",
 					actions: "resetContext"
@@ -625,7 +630,7 @@ const orchestratedFlowMachine = setup({
 				},
 				onError: {
 					target: "error",
-					actions: "setError"
+					actions: ["setError", "setFinishStatusFailed"]
 				}
 			},
 			on: { RESET: {
@@ -633,10 +638,7 @@ const orchestratedFlowMachine = setup({
 				actions: "resetContext"
 			} }
 		},
-		finished: { on: { RESET: {
-			target: "idle",
-			actions: "resetContext"
-		} } },
+		finished: { type: "final" },
 		error: {
 			entry: "clearHomeContinueLoading",
 			on: { RESET: {
@@ -715,6 +717,7 @@ function mapOrchestratedFlowState(snapshot, uiOptions) {
 		status: "error",
 		error: context.error ?? "Unknown error",
 		errorCode: context.errorCode,
+		moduleErrorCode: context.moduleErrorCode,
 		homeScreen: uiModel.homeScreen,
 		presentation: uiModel.presentation
 	};
@@ -800,6 +803,10 @@ function createOrchestratedFlowApi({ actor, getSnapshot, trackElementClicked },
 			trackElementClicked?.("completeFlow");
 			actor.send({ type: "COMPLETE_FLOW" });
 		},
+		finishFlow() {
+			trackElementClicked?.("finishFlow");
+			actor.send({ type: "FINISH_FLOW" });
+		},
 		errorModule(error, moduleErrorCode) {
 			actor.send({
 				type: "MODULE_ERROR",
@@ -868,4 +875,4 @@ function createOrchestratedFlowManager(options) {
 }
 
 //#endregion
-export { createFlowManager, createModuleLoader, createOrchestratedFlowManager, getFlow, getRequiredWasmPipelines, noOpFlowModuleMachine, normalizeFlowModules };
+export { classifyScoreStatus, createFlowManager, createModuleLoader, createOrchestratedFlowManager, getFlow, getRequiredWasmPipelines, getTotalScoreStatus, noOpFlowModuleMachine, normalizeFlowModules };

package/dist/{flowCompletionService-BdR2cGgB.d.ts → flowCompletionService-CdGDKv0z.d.ts}

@@ -15,5 +15,13 @@ type FinishStatus = {
 };
 type GetFinishStatusFn = (flowId: string | undefined | null, signal?: AbortSignal) => Promise<FinishStatus>;
 declare const getFinishStatus: GetFinishStatusFn;
+/** The session's overall score status (superset of `FinishStatus['scoreStatus']`). */
+type TotalScore = 'OK' | 'WARN' | 'MANUAL_OK' | 'FAIL' | 'UNKNOWN' | 'MANUAL_FAIL' | 'MANUAL' | 'MANUAL_PENDING';
+/** The three status-specific finish screens a session can resolve to. */
+type FinishScreenVariant = 'success' | 'error' | 'review';
+/** Maps a session's `TotalScore` to the finish-screen variant; unknown or absent → `error`. */
+declare function classifyScoreStatus(score: TotalScore | undefined): FinishScreenVariant;
+/** Fetches the session's overall score status via a lighter read-only GET. */
+declare function getTotalScoreStatus(signal?: AbortSignal): Promise<TotalScore>;
 //#endregion
-export { GetFinishStatusFn as n, getFinishStatus as r, FinishStatus as t };
+export { classifyScoreStatus as a, TotalScore as i, FinishStatus as n, getFinishStatus as o, GetFinishStatusFn as r, getTotalScoreStatus as s, FinishScreenVariant as t };