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

package/dist/{idCaptureManager-ChCNmgBj.d.ts → idCaptureManager-BVdvfJys.d.ts}

@@ -1,18 +1,29 @@
-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 { a as RegulationTypes, n as Flow, o as TutorialIdConfig } from "./types-DOUhndhT.js";
-import { a as IMLProviderCapability, c as IRecordingCapability, l as RecordingConnection, 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 StateMachine, t as AnyStateMachine } from "./StateMachine-C_AY4cs7.js";
+import { t as Manager } from "./Manager-CJ3G2zqi.js";
+import { t as ActorRefFrom } from "./Actor-CGEelYtQ.js";
+import { t as IVisibilityObserverCapability } from "./IVisibilityObserverCapability-BbWjgpiF.js";
+import { t as CameraStream } from "./camera-CNVUo-bC.js";
+import { t as IncodeCanvas } from "./canvas-CJUmoXSD.js";
+import { _ as MLProviderConfig, g as IMLProviderCapability } from "./createFaceAvatar-B8pFpy6o.js";
+import { a as RegulationTypes, n as Flow, o as TutorialIdConfig } from "./types-BsYXnC5s.js";
+import { a as IRecordingCapability, i as IStorageCapability, o as RecordingConnection } from "./IWasmUtilCapability-d2XvzaCk.js";
+import { n as PermissionStatus, t as PermissionResult } from "./types-Duy2rDxF.js";
+import { t as StreamCanvasCapture } from "./StreamCanvasCapture-DS1TOoiH.js";
+import { t as DeepsightService } from "./deepsightService-CMB9XjES.js";
 
 //#region ../infra/src/capabilities/IIdCaptureCapability.d.ts
 /**
  * Configuration for ID capture provider.
  * Extends base ML provider config with ID-capture specific options.
  */
-type IdCaptureConfig$1 = MLProviderConfig;
+interface IdCaptureConfig$1 extends MLProviderConfig {
+  /**
+   * Load the video-selfie ID workflow (`IdVideoSelfiePipeline`, the simplified
+   * ID-capture pipeline without a capturing-manager timer, used by the
+   * video-selfie flow) instead of the default blur/glare ID pipeline.
+   */
+  videoSelfie?: boolean;
+}
 interface IdCaptureThresholds$1 {
   blurThreshold: number;
   blurChangeThreshold: number;
@@ -413,8 +424,11 @@ type IdCaptureContext = {
   attemptsRemaining: number;
   /**
    * Number of consecutive `isDocumentExpired === true` upload responses for
-   * the current side. Reset on side change; preserved across the soft-retry
-   * cycle (`expired → capture`). Compared against `config.captureAttempts`.
+   * the current side (V1's `expiredFirstSideAttempt`). Reset on every side
+   * change; preserved across the same-side soft-retry cycle
+   * (`expired → capture`). Compared against `config.captureAttempts`. This is
+   * a per-side local counter only — the cross-side expired-back→front redirect
+   * is bounded separately by `expiredRedirected` (see below).
    */
   expiredAttempts: number;
   /**
@@ -459,6 +473,19 @@ type IdCaptureContext = {
    * the terminal "No attempts remaining" view.
    */
   forceFinishAfterProcessing: boolean;
+  /**
+   * One-shot flag (V1's `expiredRedirected`). Set when an expired BACK upload
+   * in a multi-side flow sends the user back to FRONT capture for one more
+   * attempt (Figma Story #2.1 / ENG-46592). Session-global — preserved across
+   * the front/back side resets so it survives the flip cycle. Once set, any
+   * further expired upload routes straight to `expiredExhausted` instead of
+   * redirecting again, so the back→front redirect happens AT MOST ONCE per
+   * session. This is what keeps total captures within the backend's
+   * max-attempts/OCR cap (re-respects ENG-45666). Session-global: preserved
+   * across side resets and mid-flow `resetContext` restarts (like V1's
+   * localStorage flag); a fresh session starts it `false`.
+   */
+  expiredRedirected: boolean;
   uploadError: IdErrorCode | undefined;
   permissionResult: PermissionResult | 'refresh' | undefined;
   resetDetection: (() => void) | undefined;
@@ -825,6 +852,8 @@ type IdCaptureExpiredState = {
    * "X attempts remaining" line on `1-9-11-id-documenterror`.
    */
   attemptsRemaining: number;
+  /** Which side just expired — drives the back-specific subtitle in the UI. */
+  currentMode: IdCaptureMode;
 };
 type IdCaptureExpiredExhaustedState = {
   status: 'expiredExhausted';
@@ -887,8 +916,14 @@ type AnyIdCaptureActor = IdCaptureActor | IdCaptureOnlyActor;
  * which is typed against the regular machine. Variants produced via
  * `idCaptureMachine.provide({...})` share the same context and event types,
  * so the cast is sound at runtime — only the actor implementation differs.
+ *
+ * `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 createIdCaptureManagerFromActor(actor: AnyIdCaptureActor): Manager<IdCaptureState> & {
+declare function createIdCaptureManagerFromActor(actor: AnyIdCaptureActor, visibilityObserver?: IVisibilityObserverCapability): Manager<IdCaptureState> & {
   load(): void;
   selectDocument(documentType: IdDocumentType): void;
   nextStep(): Promise<void>;

package/dist/{idCaptureManager-D3pwWutw.esm.js → idCaptureManager-Bo9DCQSU.esm.js}

@@ -1,8 +1,10 @@
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import { c as createManager, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import { n as setWasmDsFlagSync, t as BrowserStorageProvider } from "./BrowserStorageProvider-BpJM-gIl.esm.js";
-import { o as resetWasmMotionPrimedForModule, r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-Doec4X5L.esm.js";
-import { h as mapDigitalIdScreenName, t as idCaptureMachine } from "./idCaptureStateMachine-B3AiDIsT.esm.js";
+import { n as createManagerInstrumentation, t as topLevelStateName } from "./events-CqGY1yMq.esm.js";
+import { n as eventModuleNames } from "./types-ElOJAGaM.esm.js";
+import { l as createManager, s as createActor } from "./xstate.esm-Bomq1a0z.esm.js";
+import { n as setWasmDsFlagSync, t as BrowserVisibilityObserverProvider } from "./BrowserVisibilityObserverProvider-rim9Jrz-.esm.js";
+import { o as resetWasmMotionPrimedForModule, r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-BJhGL13R.esm.js";
+import { t as BrowserStorageProvider } from "./BrowserStorageProvider-CrrN540a.esm.js";
+import { i as mapIdManualUploadScreenName, n as getManualUploadTabs, r as MAX_EXPIRED_FIRST_SIDE_ATTEMPTS, t as idCaptureMachine, v as mapDigitalIdScreenName } from "./idCaptureStateMachine-BeDidMLU.esm.js";
 
 //#region src/internal/idCapture/idCaptureManagerFactory.ts
 function getPermissionStatus(snapshot) {
@@ -98,9 +100,7 @@ function shouldCaptureBack(context) {
 	if (!(context.currentMode === "front" || context.currentMode === "passport")) return false;
 	if (context.config.onlyBack) return false;
 	if (context.config.usSmartCapture && context.currentMode === "front") return false;
-	const serverSkipped = context.uploadResponse?.skipBackIdCapture === true;
-	const forceBackForNonPassport = context.config.alwaysCaptureBackOfId === true && context.currentMode !== "passport";
-	return !serverSkipped || forceBackForNonPassport;
+	return context.uploadResponse?.skipBackIdCapture !== true;
 }
 function shouldCaptureFront(context) {
 	return context.config.usSmartCapture === true && context.currentMode === "back" && context.uploadResponse?.forceFrontIdCapture === true;
@@ -136,6 +136,7 @@ function isLoadingPhase(snapshot) {
 }
 function mapManualUploadState(snapshot) {
 	const { config } = snapshot.context;
+	const { showIdTab, showPassportTab } = getManualUploadTabs(config);
 	const childSnapshot = snapshot.children["manualIdUpload"]?.getSnapshot();
 	const childCtx = childSnapshot?.context;
 	const childValue = childSnapshot?.value;
@@ -155,8 +156,8 @@ function mapManualUploadState(snapshot) {
 		phase,
 		uploadingSide,
 		activeTab: childCtx?.activeTab ?? "id",
-		showIdTab: config.enableId ?? true,
-		showPassportTab: config.enablePassport ?? false,
+		showIdTab,
+		showPassportTab,
 		showBackSlot: true,
 		frontFileName: childCtx?.frontFile?.name,
 		backFileName: childCtx?.backFile?.name,
@@ -234,9 +235,11 @@ function mapState(snapshot) {
 	if (snapshot.matches("expiredExhausted")) return { status: "expiredExhausted" };
 	if (snapshot.matches("expired")) {
 		const counter = context.expiredFromUpload ? context.expiredAttempts : context.processingExpiredAttempts;
+		const cap = context.expiredFromUpload ? MAX_EXPIRED_FIRST_SIDE_ATTEMPTS : context.config.captureAttempts;
 		return {
 			status: "expired",
-			attemptsRemaining: Math.max(0, context.config.captureAttempts - counter)
+			attemptsRemaining: Math.max(0, cap - counter),
+			currentMode: context.currentMode
 		};
 	}
 	if (snapshot.matches("finished")) return { status: "finished" };
@@ -509,7 +512,7 @@ function getPermissionScreen(value) {
 function getIdCaptureScreenName(snapshot) {
 	const { value, context } = snapshot;
 	if (value === void 0 || value === null) return void 0;
-	const topLevel = typeof value === "string" ? value : typeof value === "object" ? Object.keys(value)[0] : void 0;
+	const topLevel = topLevelStateName(value);
 	if (topLevel === void 0) return void 0;
 	const side = context.currentMode;
 	const screens = getSideScreens(side);
@@ -535,16 +538,90 @@ function getIdCaptureScreenName(snapshot) {
 			const childContext = child?.context;
 			return mapDigitalIdScreenName(child?.value, childContext?.failReason ?? null);
 		}
+		case "manualIdUpload": {
+			const child = snapshot.children["manualIdUpload"]?.getSnapshot();
+			const childContext = child?.context;
+			return mapIdManualUploadScreenName(child?.value, childContext) ?? "idCapture.manualIdUpload";
+		}
 		default: return `idCapture.${topLevel}`;
 	}
 }
 function mapIdCaptureScreenName(snapshot) {
 	return getIdCaptureScreenName(snapshot);
 }
+/**
+* Figma-aligned, machine-stable reason token per upload error code. Mirrors the
+* leaf used by `getCaptureErrorScreen` (e.g. `GLARE_DETECTED` → `glare`) so the
+* `errorTriggered` payload, the error name and the screen name stay in sync
+* with the ID Capture Figma "Capture front/back errors" frames.
+*/
+const ID_UPLOAD_ERROR_REASON = {
+	WRONG_DOCUMENT_SIDE: "wrongSide",
+	GLARE_DETECTED: "glare",
+	LOW_SHARPNESS: "blur",
+	READABILITY_ISSUE: "notReadable",
+	ID_TYPE_UNACCEPTABLE: "notAccepted",
+	CLASSIFICATION_FAILED: "notAccepted",
+	RETRY_EXHAUSTED_CONTINUE_TO_BACK: "failedExhausted",
+	RETRY_EXHAUSTED_SKIP_BACK: "failedExhausted",
+	NO_MORE_TRIES: "failedExhausted",
+	NO_TOKEN: "noConnection",
+	SERVER_ERROR: "noConnection",
+	UPLOAD_ERROR: "failed",
+	UNEXPECTED_ERROR: "failed",
+	PERMISSION_DENIED: "failed",
+	USER_CANCELLED: "failed"
+};
+/**
+* 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 isIdCaptureSubstateActive(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 ID Capture error state. Returned without
+* the module prefix — the instrumentation adapter prepends `idCapture.` to
+* produce e.g. `idCapture.error.glare`. Returning `undefined` means "not an
+* error state", which suppresses `errorTriggered`.
+*
+* Covers: recoverable capture/upload errors (`capture.uploadError`, including
+* the `noConnection` network path via `SERVER_ERROR`/`NO_TOKEN`), the
+* document-expired flows (`expired`/`expiredExhausted`), and the fatal
+* top-level `error` state.
+*/
+function getIdCaptureErrorName(snapshot) {
+	const topLevel = topLevelStateName(snapshot.value);
+	if (topLevel === void 0) return void 0;
+	switch (topLevel) {
+		case "error": return "error.unknown";
+		case "expired": return "error.expired";
+		case "expiredExhausted": return "error.expiredExhausted";
+		case "capture": {
+			if (!isIdCaptureSubstateActive(snapshot.value, "uploadError")) return;
+			const code = snapshot.context.uploadError;
+			return `error.${code ? ID_UPLOAD_ERROR_REASON[code] : "failed"}`;
+		}
+		default: return;
+	}
+}
 function getIdCaptureErrorPayload(snapshot) {
+	const topLevel = topLevelStateName(snapshot.value);
+	if (topLevel === "expired") return { reason: "documentExpired" };
+	if (topLevel === "expiredExhausted") return { reason: "documentExpiredExhausted" };
+	if (topLevel === "error") return { reason: "fatal" };
 	const errorCode = snapshot.context.uploadError;
 	if (errorCode === void 0) return;
-	return { errorCode };
+	return {
+		errorCode,
+		reason: ID_UPLOAD_ERROR_REASON[errorCode] ?? "failed"
+	};
 }
 /**
 * Builds the public ID capture manager from an already-created actor.
@@ -554,15 +631,23 @@ function getIdCaptureErrorPayload(snapshot) {
 * which is typed against the regular machine. Variants produced via
 * `idCaptureMachine.provide({...})` share the same context and event types,
 * so the cast is sound at runtime — only the actor implementation differs.
+*
+* `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 createIdCaptureManagerFromActor(actor) {
+function createIdCaptureManagerFromActor(actor, visibilityObserver = new BrowserVisibilityObserverProvider()) {
 	return createManager({
 		actor,
 		mapState,
 		createApi,
 		instrumentation: createManagerInstrumentation(eventModuleNames.idCapture, {
 			getEventScreenName: mapIdCaptureScreenName,
-			getErrorPayload: getIdCaptureErrorPayload
+			getErrorName: getIdCaptureErrorName,
+			getErrorPayload: getIdCaptureErrorPayload,
+			visibilityObserver
 		})
 	});
 }