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

package/dist/id-verification.d.ts

@@ -1,6 +1,6 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import * as xstate654 from "xstate";
+import { t as Manager } from "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import * as xstate554 from "xstate";
 
 //#region src/modules/id-verification/types.d.ts
 type IdVerificationConfig = {
@@ -32,26 +32,26 @@ type IdVerificationContext = {
 type IdVerificationInput = {
   config: IdVerificationConfig;
 };
-declare const idVerificationMachine: xstate654.StateMachine<IdVerificationContext, {
+declare const idVerificationMachine: xstate554.StateMachine<IdVerificationContext, {
   type: "LOAD";
 } | {
   type: "CONTINUE";
 }, {
-  [x: string]: xstate654.ActorRefFromLogic<xstate654.PromiseActorLogic<ProcessIdResponse, {
+  [x: string]: xstate554.ActorRefFromLogic<xstate554.PromiseActorLogic<ProcessIdResponse, {
     isSecondId: boolean;
     queueName: string;
-  }, xstate654.EventObject>> | undefined;
+  }, xstate554.EventObject>> | undefined;
 }, {
   src: "processId";
-  logic: xstate654.PromiseActorLogic<ProcessIdResponse, {
+  logic: xstate554.PromiseActorLogic<ProcessIdResponse, {
     isSecondId: boolean;
     queueName: string;
-  }, xstate654.EventObject>;
+  }, xstate554.EventObject>;
   id: string | undefined;
 }, never, {
   type: "isDocumentExpired";
   params: unknown;
-}, never, "idle" | "processing" | "finished" | "expired", string, IdVerificationInput, xstate654.NonReducibleUnknown, xstate654.EventObject, xstate654.MetaObject, {
+}, never, "idle" | "processing" | "finished" | "expired", string, IdVerificationInput, xstate554.NonReducibleUnknown, xstate554.EventObject, xstate554.MetaObject, {
   readonly id: "idVerification";
   readonly initial: "idle";
   readonly context: ({
@@ -60,50 +60,50 @@ declare const idVerificationMachine: xstate654.StateMachine<IdVerificationContex
     spawn: {
       <TSrc extends "processId">(logic: TSrc, ...[options]: {
         src: "processId";
-        logic: xstate654.PromiseActorLogic<ProcessIdResponse, {
+        logic: xstate554.PromiseActorLogic<ProcessIdResponse, {
           isSecondId: boolean;
           queueName: string;
-        }, xstate654.EventObject>;
+        }, xstate554.EventObject>;
         id: string | undefined;
       } extends infer T ? T extends {
         src: "processId";
-        logic: xstate654.PromiseActorLogic<ProcessIdResponse, {
+        logic: xstate554.PromiseActorLogic<ProcessIdResponse, {
           isSecondId: boolean;
           queueName: string;
-        }, xstate654.EventObject>;
+        }, xstate554.EventObject>;
         id: string | undefined;
       } ? T extends {
         src: TSrc;
-      } ? xstate654.ConditionalRequired<[options?: ({
+      } ? xstate554.ConditionalRequired<[options?: ({
         id?: T["id"] | undefined;
         systemId?: string;
-        input?: xstate654.InputFrom<T["logic"]> | undefined;
+        input?: xstate554.InputFrom<T["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate654.RequiredActorOptions<T>]: unknown }) | undefined], xstate654.IsNotNever<xstate654.RequiredActorOptions<T>>> : never : never : never): xstate654.ActorRefFromLogic<xstate654.GetConcreteByKey<{
+      } & { [K in xstate554.RequiredActorOptions<T>]: unknown }) | undefined], xstate554.IsNotNever<xstate554.RequiredActorOptions<T>>> : never : never : never): xstate554.ActorRefFromLogic<xstate554.GetConcreteByKey<{
         src: "processId";
-        logic: xstate654.PromiseActorLogic<ProcessIdResponse, {
+        logic: xstate554.PromiseActorLogic<ProcessIdResponse, {
           isSecondId: boolean;
           queueName: string;
-        }, xstate654.EventObject>;
+        }, xstate554.EventObject>;
         id: string | undefined;
       }, "src", TSrc>["logic"]>;
-      <TLogic extends xstate654.AnyActorLogic>(src: TLogic, ...[options]: xstate654.ConditionalRequired<[options?: ({
+      <TLogic extends xstate554.AnyActorLogic>(src: TLogic, ...[options]: xstate554.ConditionalRequired<[options?: ({
         id?: never;
         systemId?: string;
-        input?: xstate654.InputFrom<TLogic> | undefined;
+        input?: xstate554.InputFrom<TLogic> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate654.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate654.IsNotNever<xstate654.RequiredLogicInput<TLogic>>>): xstate654.ActorRefFromLogic<TLogic>;
+      } & { [K in xstate554.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate554.IsNotNever<xstate554.RequiredLogicInput<TLogic>>>): xstate554.ActorRefFromLogic<TLogic>;
     };
     input: IdVerificationInput;
-    self: xstate654.ActorRef<xstate654.MachineSnapshot<IdVerificationContext, {
+    self: xstate554.ActorRef<xstate554.MachineSnapshot<IdVerificationContext, {
       type: "LOAD";
     } | {
       type: "CONTINUE";
-    }, Record<string, xstate654.AnyActorRef | undefined>, xstate654.StateValue, string, unknown, any, any>, {
+    }, Record<string, xstate554.AnyActorRef | undefined>, xstate554.StateValue, string, unknown, any, any>, {
       type: "LOAD";
     } | {
       type: "CONTINUE";
-    }, xstate654.AnyEventObject>;
+    }, xstate554.AnyEventObject>;
   }) => {
     config: IdVerificationConfig;
     isSecondId: boolean;
@@ -127,15 +127,15 @@ declare const idVerificationMachine: xstate654.StateMachine<IdVerificationContex
           } | {
             type: "CONTINUE";
           };
-          self: xstate654.ActorRef<xstate654.MachineSnapshot<IdVerificationContext, {
+          self: xstate554.ActorRef<xstate554.MachineSnapshot<IdVerificationContext, {
             type: "LOAD";
           } | {
             type: "CONTINUE";
-          }, Record<string, xstate654.AnyActorRef>, xstate654.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate554.AnyActorRef>, xstate554.StateValue, string, unknown, any, any>, {
             type: "LOAD";
           } | {
             type: "CONTINUE";
-          }, xstate654.AnyEventObject>;
+          }, xstate554.AnyEventObject>;
         }) => {
           isSecondId: boolean;
           queueName: string;

package/dist/id-verification.esm.js

@@ -1,8 +1,8 @@
-import "./api-CESGtpbH.esm.js";
-import { o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import { c as createManager, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import { t as idVerificationMachine } from "./idVerificationStateMachine-kRxwImzO.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import { s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import "./endpoints-BM2_j_IE.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { t as idVerificationMachine } from "./idVerificationStateMachine-Bo1IYuZH.esm.js";
 
 //#region src/modules/id-verification/idVerificationActor.ts
 function createIdVerificationActor(options) {

package/dist/id.d.ts

@@ -1,19 +1,25 @@
-import "./warmup-Dg8Lh-50.js";
-import "./Manager-BHn8wH8K.js";
-import "./Actor-Y0_Fj-KL.js";
-import "./StateMachine-BC_nGvrc.js";
-import { t as CameraStream } from "./camera-SRBpPq2X.js";
-import "./types-Bj9hdFjU.js";
-import "./types-DvGZI7BF.js";
-import "./types-DOUhndhT.js";
-import "./deepsightService-Dh5P-hLf.js";
-import { n as PermissionStatus, t as PermissionResult } from "./types-ya0LN_MX.js";
-import "./StreamCanvasCapture-yyl20qd9.js";
-import { $ as MANUAL_UPLOAD_MAX_FILE_SIZE_BYTES, A as CaptureIdResponse, B as IdCaptureGeometry, C as IdCaptureOnlyMachine, D as createIdCaptureActor, E as IdCaptureActor, F as ID_ERROR_CODES, G as IdCapturedImageData, H as IdCaptureMode, I as IdCaptureConfig, J as IdErrorCode, K as IdDocumentType, L as IdCaptureContext, M as CapturedImage, N as DetectionArea, O as IdCaptureMachine, P as DetectionStatus, Q as MANUAL_UPLOAD_EXHAUSTION_FORWARD_MS, R as IdCaptureDependencies, S as createIdCaptureOnlyActor, T as CreateIdCaptureActorOptions, U as IdCaptureOnlyConfig, V as IdCaptureInput, W as IdCaptureThresholds, X as RecordingSession, Y as IdFlowStep, Z as UploadIdResponse, _ as uploadIdImage, a as IdCaptureInitResult, at as IdCaptureSettings, b as CreateIdCaptureOnlyActorOptions, c as UploadIdImageParams, d as initializeIdCapture, et as MANUAL_UPLOAD_MAX_RETRIES, f as preloadIdRecordingProvider, g as stopStream, h as stopRecording, it as DetectionOrientation, j as CaptureOnlyResponse, k as idCaptureMachine, l as UploadManualIdFileParams, m as startRecordingSession, n as IdCaptureManager, nt as ManualUploadSide, o as InitializeIdCaptureParams, p as processId, q as IdError, r as IdCaptureState, rt as ManualUploadTab, s as StartRecordingParams, t as createIdCaptureManager, tt as ManualUploadContext, u as ValidationError, v as uploadManualIdFile, w as idCaptureOnlyMachine, x as IdCaptureOnlyActor, y as validateUploadResponse, z as IdCaptureEvent } from "./idCaptureManager-ChCNmgBj.js";
+import "./warmup--6HA3yUR.js";
+import "./Manager-B2OEDYqf.js";
+import "./Actor-fIPLXfoi.js";
+import { u as IVisibilityObserverCapability } from "./deepsightService-ByNKY5Jv.js";
+import { t as CameraStream } from "./camera-biGPWlmx.js";
+import "./types-Z9wv19v2.js";
+import "./types-DYZja-k9.js";
+import "./types-Dv-9WPJX.js";
+import { n as PermissionStatus, t as PermissionResult } from "./types-F0IXbaCB.js";
+import "./StreamCanvasCapture-Ctgyx-oD.js";
+import { $ as MANUAL_UPLOAD_MAX_FILE_SIZE_BYTES, A as CaptureIdResponse, B as IdCaptureGeometry, C as IdCaptureOnlyMachine, D as createIdCaptureActor, E as IdCaptureActor, F as ID_ERROR_CODES, G as IdCapturedImageData, H as IdCaptureMode, I as IdCaptureConfig, J as IdErrorCode, K as IdDocumentType, L as IdCaptureContext, M as CapturedImage, N as DetectionArea, O as IdCaptureMachine, P as DetectionStatus, Q as MANUAL_UPLOAD_EXHAUSTION_FORWARD_MS, R as IdCaptureDependencies, S as createIdCaptureOnlyActor, T as CreateIdCaptureActorOptions, U as IdCaptureOnlyConfig, V as IdCaptureInput, W as IdCaptureThresholds, X as RecordingSession, Y as IdFlowStep, Z as UploadIdResponse, _ as uploadIdImage, a as IdCaptureInitResult, at as IdCaptureSettings, b as CreateIdCaptureOnlyActorOptions, c as UploadIdImageParams, d as initializeIdCapture, et as MANUAL_UPLOAD_MAX_RETRIES, f as preloadIdRecordingProvider, g as stopStream, h as stopRecording, it as DetectionOrientation, j as CaptureOnlyResponse, k as idCaptureMachine, l as UploadManualIdFileParams, m as startRecordingSession, n as IdCaptureManager, nt as ManualUploadSide, o as InitializeIdCaptureParams, p as processId, q as IdError, r as IdCaptureState, rt as ManualUploadTab, s as StartRecordingParams, t as createIdCaptureManager, tt as ManualUploadContext, u as ValidationError, v as uploadManualIdFile, w as idCaptureOnlyMachine, x as IdCaptureOnlyActor, y as validateUploadResponse, z as IdCaptureEvent } from "./idCaptureManager-BvGUSN2e.js";
 
 //#region src/modules/id/idCaptureOnlyManager.d.ts
 type IdCaptureOnlyManager = IdCaptureManager;
-declare function createIdCaptureOnlyManagerFromActor(actor: IdCaptureOnlyActor, config: IdCaptureOnlyConfig): IdCaptureOnlyManager;
+/**
+ * `visibilityObserver` is an optional override escape-hatch — first-party
+ * callers omit it and the downstream factory defaults to
+ * `BrowserVisibilityObserverProvider`. Pass a custom or no-op observer to
+ * disable `background`/`foreground` tracking or to run in a non-DOM
+ * environment (e.g. SSR / tests).
+ */
+declare function createIdCaptureOnlyManagerFromActor(actor: IdCaptureOnlyActor, config: IdCaptureOnlyConfig, visibilityObserver?: IVisibilityObserverCapability): IdCaptureOnlyManager;
 /**
  * Creates a captureOnly ID capture manager.
  *

package/dist/id.esm.js

@@ -1,34 +1,35 @@
-import "./WasmUtilProvider-BKWm8rSA.esm.js";
-import "./BrowserTimerProvider-DhNc_x02.esm.js";
-import "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames } 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, r as assign, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import "./apiError-B-j-gyDx.esm.js";
-import { t as BrowserStorageProvider } from "./BrowserStorageProvider-BpJM-gIl.esm.js";
-import "./MotionSensorProvider-Bx7Mpzt0.esm.js";
-import "./permissionServices-Doec4X5L.esm.js";
-import "./camera-DJWm3V4g.esm.js";
-import "./recordingService-yRw7hfzU.esm.js";
-import "./ITimerCapability-CB0I1Uf2.esm.js";
-import "./canvas-SKcRBxsk.esm.js";
-import "./backCameraStream-D7Wo4Nbx.esm.js";
-import "./deepsightService-CrHmvx8X.esm.js";
-import "./getDeviceClass-C0olyNFS.esm.js";
-import "./getDeviceClass-C8Do2qYu.esm.js";
-import "./types-DsnEVMhr.esm.js";
-import "./StreamCanvasCapture-ImiDQdVA.esm.js";
-import "./permissionGuards-D0wGddy7.esm.js";
-import "./session-DoVb-OcB.esm.js";
-import { a as startRecordingSession, c as uploadIdImage, d as ID_ERROR_CODES, f as MANUAL_UPLOAD_EXHAUSTION_FORWARD_MS, i as processId, l as uploadManualIdFile, m as MANUAL_UPLOAD_MAX_RETRIES, n as initializeIdCapture, o as stopRecording, p as MANUAL_UPLOAD_MAX_FILE_SIZE_BYTES, r as preloadIdRecordingProvider, s as stopStream, t as idCaptureMachine, u as validateUploadResponse } from "./idCaptureStateMachine-B3AiDIsT.esm.js";
-import { n as createIdCaptureActor, r as createIdCaptureManagerFromActor, t as createIdCaptureManager } from "./idCaptureManager-D3pwWutw.esm.js";
-import { t as invokeOnCaptureCallback } from "./invokeOnCaptureCallback-ygByVdnn.esm.js";
+import "./WasmUtilProvider-CIu373BZ.esm.js";
+import "./BrowserTimerProvider-BVgutW_b.esm.js";
+import "./api-DUZwyz0o.esm.js";
+import { n as eventModuleNames } 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, r as assign, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import "./apiError-D-GTvFrH.esm.js";
+import { t as BrowserStorageProvider } from "./BrowserStorageProvider-D5xc7Lqo.esm.js";
+import "./MotionSensorProvider-C9fPAJdS.esm.js";
+import "./permissionServices-CPDboRoE.esm.js";
+import "./camera-x4LjGTjZ.esm.js";
+import "./recordingService-CxMJP4tQ.esm.js";
+import "./ITimerCapability-BvH0pDwp.esm.js";
+import "./canvas-7uX2izHb.esm.js";
+import "./backCameraStream-iftkf3rd.esm.js";
+import "./deepsightService-CEZrdiW0.esm.js";
+import "./getDeviceClass-C0zrM97a.esm.js";
+import "./getDeviceClass-rXKlXywy.esm.js";
+import "./types-BdVOWGGW.esm.js";
+import "./StreamCanvasCapture-Dr5n_iK1.esm.js";
+import "./permissionGuards-D-Z-lgNj.esm.js";
+import "./session-Be_IA1e0.esm.js";
+import { a as processId, c as stopStream, d as validateUploadResponse, f as ID_ERROR_CODES, h as MANUAL_UPLOAD_MAX_RETRIES, i as preloadIdRecordingProvider, l as uploadIdImage, m as MANUAL_UPLOAD_MAX_FILE_SIZE_BYTES, o as startRecordingSession, p as MANUAL_UPLOAD_EXHAUSTION_FORWARD_MS, r as initializeIdCapture, s as stopRecording, t as idCaptureMachine, u as uploadManualIdFile } from "./idCaptureStateMachine-D1YhOj6n.esm.js";
+import { n as createIdCaptureActor, r as createIdCaptureManagerFromActor, t as createIdCaptureManager } from "./idCaptureManager-Bm6Wm6Qv.esm.js";
+import { t as invokeOnCaptureCallback } from "./invokeOnCaptureCallback-Dzemudhk.esm.js";
 
 //#region src/modules/id/idCaptureOnlyStateMachine.ts
 function buildSubImage(canvas) {
@@ -181,9 +182,16 @@ function attachOnCaptureFiring(actor, config) {
 	} });
 	return () => subscription.unsubscribe();
 }
-function createIdCaptureOnlyManagerFromActor(actor, config) {
+/**
+* `visibilityObserver` is an optional override escape-hatch — first-party
+* callers omit it and the downstream factory defaults to
+* `BrowserVisibilityObserverProvider`. Pass a custom or no-op observer to
+* disable `background`/`foreground` tracking or to run in a non-DOM
+* environment (e.g. SSR / tests).
+*/
+function createIdCaptureOnlyManagerFromActor(actor, config, visibilityObserver) {
 	const unsubscribe = attachOnCaptureFiring(actor, config);
-	const manager = createIdCaptureManagerFromActor(actor);
+	const manager = createIdCaptureManagerFromActor(actor, visibilityObserver);
 	return {
 		...manager,
 		stop: () => {

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

@@ -1,8 +1,8 @@
-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 eventModuleNames, o as topLevelStateName, s as createManagerInstrumentation } from "./events-DN-u67gb.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-Dkm1jy5u.esm.js";
+import { n as BrowserVisibilityObserverProvider, r as setWasmDsFlagSync, t as BrowserStorageProvider } from "./BrowserStorageProvider-D5xc7Lqo.esm.js";
+import { o as resetWasmMotionPrimedForModule, r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-CPDboRoE.esm.js";
+import { g as mapDigitalIdScreenName, n as mapIdManualUploadScreenName, t as idCaptureMachine } from "./idCaptureStateMachine-D1YhOj6n.esm.js";
 
 //#region src/internal/idCapture/idCaptureManagerFactory.ts
 function getPermissionStatus(snapshot) {
@@ -509,7 +509,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 +535,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 +628,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
 		})
 	});
 }

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

@@ -1,11 +1,10 @@
-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 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, l as RecordingConnection, 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 { a as RegulationTypes, n as Flow, o as TutorialIdConfig } 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 ../infra/src/capabilities/IIdCaptureCapability.d.ts
 /**
@@ -887,8 +886,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>;