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

package/dist/{faceCaptureManagerFactory-ej2j1LMr.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-Doec4X5L.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-CjdBUS6s.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-Dh5P-hLf.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
@@ -666,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-B9t6bYze.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-Doec4X5L.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-yRw7hfzU.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-D0wGddy7.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-DeXXzSuz.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
 /**

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 xstate766 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: xstate766.StateMachine<xstate766.MachineContext, xstate766.AnyEventObject, {}, never, never, never, never, "finished", string, xstate766.NonReducibleUnknown, xstate766.NonReducibleUnknown, xstate766.EventObject, xstate766.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-DRB-hgbV.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-ChgTNggJ.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({
@@ -427,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({
@@ -444,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;
@@ -570,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",
@@ -598,6 +609,7 @@ const orchestratedFlowMachine = setup({
 					}
 				],
 				COMPLETE_FLOW: { target: "completing" },
+				FINISH_FLOW: { target: "finished" },
 				RESET: {
 					target: "idle",
 					actions: "resetContext"
@@ -618,7 +630,7 @@ const orchestratedFlowMachine = setup({
 				},
 				onError: {
 					target: "error",
-					actions: "setError"
+					actions: ["setError", "setFinishStatusFailed"]
 				}
 			},
 			on: { RESET: {
@@ -626,10 +638,7 @@ const orchestratedFlowMachine = setup({
 				actions: "resetContext"
 			} }
 		},
-		finished: { on: { RESET: {
-			target: "idle",
-			actions: "resetContext"
-		} } },
+		finished: { type: "final" },
 		error: {
 			entry: "clearHomeContinueLoading",
 			on: { RESET: {
@@ -708,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
 	};
@@ -793,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",
@@ -861,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 };

package/dist/flowCompletionService-D_CsiDZM.esm.js

@@ -0,0 +1,42 @@
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { n as toIncodeApiError } from "./apiError-D-GTvFrH.esm.js";
+
+//#region src/modules/flow/flowCompletionService.ts
+const getFinishStatus = async (flowId, signal) => {
+	const url = `${endpoints.finishStatus}${flowId ? `?flowId=${flowId}` : ""}`;
+	try {
+		return {
+			...(await api.get(url, { signal })).data,
+			endScreenTitle: null,
+			endScreenText: null
+		};
+	} catch (error) {
+		toIncodeApiError(endpoints.finishStatus, error);
+	}
+};
+const SCORE_VARIANTS = {
+	OK: "success",
+	WARN: "success",
+	MANUAL_OK: "success",
+	FAIL: "error",
+	UNKNOWN: "error",
+	MANUAL_FAIL: "error",
+	MANUAL: "review",
+	MANUAL_PENDING: "review"
+};
+/** Maps a session's `TotalScore` to the finish-screen variant; unknown or absent → `error`. */
+function classifyScoreStatus(score) {
+	return (score && SCORE_VARIANTS[score]) ?? "error";
+}
+/** Fetches the session's overall score status via a lighter read-only GET. */
+async function getTotalScoreStatus(signal) {
+	try {
+		return (await api.get(endpoints.sessionTotalScoreStatus, { signal })).data.totalScoreStatus;
+	} catch (error) {
+		toIncodeApiError(endpoints.sessionTotalScoreStatus, error);
+	}
+}
+
+//#endregion
+export { getFinishStatus as n, getTotalScoreStatus as r, classifyScoreStatus as t };

package/dist/{flowServices-ChgTNggJ.esm.js → flowServices-ar5DXv71.esm.js}

@@ -1,7 +1,7 @@
-import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
-import { n as getSessionFingerprintResult, r as initializeSession } from "./sessionInitializer-DRB-hgbV.esm.js";
-import { n as toIncodeApiError } from "./apiError-B-j-gyDx.esm.js";
+import { t as api } from "./api-DUZwyz0o.esm.js";
+import { t as endpoints } from "./endpoints-BM2_j_IE.esm.js";
+import { n as getSessionFingerprintResult, r as initializeSession } from "./sessionInitializer-CaiGA8GP.esm.js";
+import { n as toIncodeApiError } from "./apiError-D-GTvFrH.esm.js";
 
 //#region src/modules/flow/flowUtils.ts
 const WASM_MODULE_PIPELINES = {

package/dist/geolocation.d.ts

@@ -1,5 +1,5 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
 
 //#region ../infra/src/capabilities/IGeolocationCapability.d.ts
 type GeolocationCoords = {
@@ -42,6 +42,7 @@ type CreateGeolocationActorOptions = {
 };
 //#endregion
 //#region src/modules/geolocation/geolocationManager.d.ts
+
 /** Geolocation manager is in initial state, waiting for `request()` to be called */
 type GeolocationIdleState = {
   status: 'idle';