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

package/dist/extensibility.esm.js

@@ -1,59 +1,76 @@
-import { t as WasmUtilProvider } from "./WasmUtilProvider-BKWm8rSA.esm.js";
-import "./BrowserTimerProvider-DhNc_x02.esm.js";
-import "./api-CESGtpbH.esm.js";
-import "./events-Dvvriq9l.esm.js";
-import "./endpoints-BeTK0Mlt.esm.js";
-import "./stats-BMNUG1AU.esm.js";
-import { t as IpifyProvider } from "./IpifyProvider-D4LWD15E.esm.js";
-import "./browserSimulation-B1dWiXp7.esm.js";
-import { o as FingerprintProvider, s as getDeviceFingerprintInfo, t as getDisableIpify } from "./sessionInitializer-DRB-hgbV.esm.js";
-import "./platform-SKvEfCBh.esm.js";
-import "./getBrowser-C8DP7oTB.esm.js";
-import { a as fromPromise, i as fromCallback, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
-import "./apiError-B-j-gyDx.esm.js";
-import "./antifraudStateMachine-Ccrb-Jxc.esm.js";
-import { n as createAntifraudManagerFromActor } from "./antifraudManager-CkV4u-LE.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 "./faceCaptureManagerFactory-ej2j1LMr.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 { t as faceCaptureMachine } from "./faceCaptureSetup-B9t6bYze.esm.js";
-import "./authenticationStateMachine-DkcGUMw5.esm.js";
-import { n as createAuthenticationManagerFromActor } from "./authenticationManager-BlR6mSaG.esm.js";
-import "./consentStateMachine-BG3yL8aC.esm.js";
-import { n as createConsentManagerFromActor } from "./consentManager-BYo9Nu1r.esm.js";
-import { n as createCpfOcrManagerFromActor } from "./cpfOcrManager-sSKegxox.esm.js";
-import "./cpf-BRzggV8G.esm.js";
-import "./curpValidationStateMachine-B7V_qp66.esm.js";
-import { n as createCurpValidationManagerFromActor } from "./curpValidationManager-CFem6zP9.esm.js";
-import "./session-DoVb-OcB.esm.js";
-import "./emailStateMachine-CxTOMAjC.esm.js";
-import "./otp-CGMdUzBC.esm.js";
-import { n as createEmailManagerFromActor } from "./emailManager--D5G3ChB.esm.js";
-import "./selfieStateMachine-Bv99bZJE.esm.js";
-import { n as createSelfieManagerFromActor } from "./selfieManager-BNuTIGAz.esm.js";
-import "./idCaptureStateMachine-B3AiDIsT.esm.js";
-import { r as createIdCaptureManagerFromActor } from "./idCaptureManager-D3pwWutw.esm.js";
-import "./phoneStateMachine-BiV0yoEx.esm.js";
-import { n as createPhoneManagerFromActor } from "./phoneManager-BmF-0Ez4.esm.js";
-import "./identityReuseStateMachine-BfE5YiEr.esm.js";
-import { n as createIdentityReuseManagerFromActor } from "./identityReuseManager-C6n_97dw.esm.js";
-import { n as createFieldComparisonManagerFromActor } from "./fieldComparisonManager-COGI2ARD.esm.js";
-import "./mandatoryConsentStateMachine-DtQNW1ji.esm.js";
-import { n as createMandatoryConsentManagerFromActor } from "./mandatoryConsentManager-H6D18cZB.esm.js";
-import "./redirectToMobileStateMachine-DyAdRxfP.esm.js";
-import { n as createRedirectToMobileManagerFromActor } from "./redirectToMobileManager-Dy3t7o0C.esm.js";
+import { t as WasmUtilProvider } from "./WasmUtilProvider-ADG54T6M.esm.js";
+import "./BrowserTimerProvider-CHloo0eQ.esm.js";
+import "./api-DsbUi7TO.esm.js";
+import "./events-CqGY1yMq.esm.js";
+import "./types-ElOJAGaM.esm.js";
+import "./endpoints-BzMJFAPV.esm.js";
+import "./stats-CYcScXcO.esm.js";
+import "./browserSimulation-TsSoavQv.esm.js";
+import { o as FingerprintProvider, t as getDisableIpify } from "./sessionInitializer-C_TYIgyk.esm.js";
+import { t as getDeviceFingerprintInfo } from "./getDeviceData-TrKM8NPh.esm.js";
+import "./thumbmarkAdapter-fHBUDlAP.esm.js";
+import { t as IpifyProvider } from "./IpifyProvider-BRW14_uo.esm.js";
+import "./platform-uIVQUnJP.esm.js";
+import "./tri-BG1iJsr4.esm.js";
+import { a as fromPromise, i as fromCallback, s as createActor } from "./xstate.esm-Bomq1a0z.esm.js";
+import "./urlUtils-BZqFU9rR.esm.js";
+import "./apiError-DNS2OCEX.esm.js";
+import "./antifraudStateMachine-C0NGnP9W.esm.js";
+import { n as createAntifraudManagerFromActor } from "./antifraudManager-BKdQoMFf.esm.js";
+import { t as faceCaptureMachine } from "./faceCaptureSetup-CDUVU1nl.esm.js";
+import "./BrowserVisibilityObserverProvider-rim9Jrz-.esm.js";
+import "./MotionSensorProvider-DCbId4De.esm.js";
+import "./permissionServices-BJhGL13R.esm.js";
+import "./camera-DUkgmYMo.esm.js";
+import "./faceCaptureManagerFactory-2brKTzMb.esm.js";
+import { t as BrowserStorageProvider } from "./BrowserStorageProvider-CrrN540a.esm.js";
+import "./onDeviceFaceResults-DVBggeq8.esm.js";
+import "./ITimerCapability-pltuG1E8.esm.js";
+import "./canvas-_I95hkPg.esm.js";
+import "./backCameraStream-ZyqrFyjO.esm.js";
+import "./video-C2WIj6TS.esm.js";
+import "./getDeviceClass-DavNdcxh.esm.js";
+import "./deepsightService-CDahSjGP.esm.js";
+import "./getDeviceClass-DGGzzfqm.esm.js";
+import "./types-CMcxlSmH.esm.js";
+import "./createFaceAvatar-BOHDKQRq.esm.js";
+import "./StreamCanvasCapture-Bz17q4FP.esm.js";
+import "./permissionGuards-BR2oN573.esm.js";
+import "./recordingService-m_1xCthr.esm.js";
+import "./mediaRecorderOptions-C3NAkVgK.esm.js";
+import "./authenticationStateMachine-D-hOlg8p.esm.js";
+import { n as createAuthenticationManagerFromActor } from "./authenticationManager-Dtl1vcET.esm.js";
+import "./consentStateMachine-DO2JqoZW.esm.js";
+import { n as createConsentManagerFromActor } from "./consentManager-BtnPZUW4.esm.js";
+import { n as createCpfOcrManagerFromActor } from "./cpfOcrManager-C4rLgKsu.esm.js";
+import "./cpf-BKaho0j_.esm.js";
+import "./curpValidationStateMachine-DXTPK6vI.esm.js";
+import { n as createCurpValidationManagerFromActor } from "./curpValidationManager-BafobPXC.esm.js";
+import "./dateUtils-7-tQYRNN.esm.js";
+import "./dynamicFormsStateMachine-BXHcaocI.esm.js";
+import { n as createDynamicFormsManagerFromActor } from "./dynamicFormsManager-BOefZbyF.esm.js";
+import "./session-9jIfKFCc.esm.js";
+import "./emailStateMachine-fqJ42b19.esm.js";
+import "./otp-Bfnzf7I3.esm.js";
+import { n as createEmailManagerFromActor } from "./emailManager-B_XzEsXH.esm.js";
+import "./selfieStateMachine-CIgeeiN9.esm.js";
+import { n as createSelfieManagerFromActor } from "./selfieManager-D_ZFERsE.esm.js";
+import "./idCaptureStateMachine-BeDidMLU.esm.js";
+import "./idCaptureDefaults-DNJON8Xo.esm.js";
+import { r as createIdCaptureManagerFromActor } from "./idCaptureManager-Bo9DCQSU.esm.js";
+import "./phoneStateMachine-B_V9nODs.esm.js";
+import { n as createPhoneManagerFromActor } from "./phoneManager-BWlxqbyD.esm.js";
+import "./identityReuseStateMachine-BmONeF6B.esm.js";
+import { n as createIdentityReuseManagerFromActor } from "./identityReuseManager-Bu62LToE.esm.js";
+import { n as createFieldComparisonManagerFromActor } from "./fieldComparisonManager-B9W0a9A5.esm.js";
+import "./mandatoryConsentStateMachine-DkJJLHqC.esm.js";
+import { n as createMandatoryConsentManagerFromActor } from "./mandatoryConsentManager-CQ3jirlZ.esm.js";
+import "./idOcrStateMachine-DRZc4FBl.esm.js";
+import { n as createIdOcrManagerFromActor } from "./idOcrManager-BkRDrpZu.esm.js";
+import "./redirectToMobileStateMachine-DoAnf2ql.esm.js";
+import { n as createRedirectToMobileManagerFromActor } from "./redirectToMobileManager-BaAo9rgi.esm.js";
+import { n as createGeolocationManagerFromActor } from "./geolocationManager-BP2Do9O-.esm.js";
+import "./geolocationStateMachine-BYfOOOG0.esm.js";
 
 //#region src/internal/fingerprint/fingerprintApi.ts
 async function getFingerprint(disableIpify) {
@@ -62,4 +79,4 @@ async function getFingerprint(disableIpify) {
 }
 
 //#endregion
-export { BrowserStorageProvider, WasmUtilProvider, createActor, createAntifraudManagerFromActor, createAuthenticationManagerFromActor, createConsentManagerFromActor, createCpfOcrManagerFromActor, createCurpValidationManagerFromActor, createEmailManagerFromActor, createFieldComparisonManagerFromActor, createIdCaptureManagerFromActor, createIdentityReuseManagerFromActor, createMandatoryConsentManagerFromActor, createPhoneManagerFromActor, createRedirectToMobileManagerFromActor, createSelfieManagerFromActor, faceCaptureMachine, fromCallback, fromPromise, getDeviceFingerprintInfo, getFingerprint };
+export { BrowserStorageProvider, WasmUtilProvider, createActor, createAntifraudManagerFromActor, createAuthenticationManagerFromActor, createConsentManagerFromActor, createCpfOcrManagerFromActor, createCurpValidationManagerFromActor, createDynamicFormsManagerFromActor, createEmailManagerFromActor, createFieldComparisonManagerFromActor, createGeolocationManagerFromActor, createIdCaptureManagerFromActor, createIdOcrManagerFromActor, createIdentityReuseManagerFromActor, createMandatoryConsentManagerFromActor, createPhoneManagerFromActor, createRedirectToMobileManagerFromActor, createSelfieManagerFromActor, faceCaptureMachine, fromCallback, fromPromise, getDeviceFingerprintInfo, getFingerprint };

package/dist/externalFetch-CyhBfD-n.esm.js

@@ -0,0 +1,22 @@
+import { t as buildUrlWithSearchParams } from "./urlUtils-BZqFU9rR.esm.js";
+
+//#region ../infra/src/http/externalFetch.ts
+/**
+* Lightweight fetch wrapper for requests to external URLs (e.g. presigned S3).
+* Unlike the SDK HttpClient, this sends NO default headers — only what the
+* caller explicitly provides.
+*/
+async function externalFetch(config) {
+	const url = config.query ? buildUrlWithSearchParams(config.url, config.query) : config.url;
+	const res = await fetch(url, {
+		method: config.method,
+		headers: config.headers,
+		body: config.body,
+		signal: config.signal
+	});
+	if (!res.ok) throw new Error(`${config.method} ${url} failed: ${res.status} ${res.statusText}`);
+	return res;
+}
+
+//#endregion
+export { externalFetch as t };

package/dist/face-match.d.ts

@@ -1,7 +1,7 @@
-import { t as Manager } from "./Manager-BHn8wH8K.js";
+import "./StateMachine-C_AY4cs7.js";
+import { t as Manager } from "./Manager-CJ3G2zqi.js";
 
 //#region src/modules/face-match/types.d.ts
-
 /**
  * Face match comparison variant.
  * Determines which images are compared in the face match flow.

package/dist/face-match.esm.js

@@ -1,8 +1,9 @@
-import "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, 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 { n as ID_FACE_EXTRACTION_SKIPPED_CODE, r as isFaceExtractionSkippedError, t as faceMatchMachine } from "./faceMatchStateMachine-DeXXzSuz.esm.js";
+import "./api-DsbUi7TO.esm.js";
+import { n as createManagerInstrumentation } from "./events-CqGY1yMq.esm.js";
+import { n as eventModuleNames } from "./types-ElOJAGaM.esm.js";
+import "./endpoints-BzMJFAPV.esm.js";
+import { l as createManager, s as createActor } from "./xstate.esm-Bomq1a0z.esm.js";
+import { n as ID_FACE_EXTRACTION_SKIPPED_CODE, r as isFaceExtractionSkippedError, t as faceMatchMachine } from "./faceMatchStateMachine-DUeUjEPx.esm.js";
 
 //#region src/modules/face-match/faceMatchActor.ts
 function createFaceMatchActor(options) {

package/dist/{faceCaptureManagerFactory-ej2j1LMr.esm.js → faceCaptureManagerFactory-2brKTzMb.esm.js}

@@ -1,7 +1,9 @@
-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 createManagerInstrumentation, t as topLevelStateName } from "./events-CqGY1yMq.esm.js";
+import { n as eventModuleNames, r as eventScreenNames } from "./types-ElOJAGaM.esm.js";
+import { l as createManager } from "./xstate.esm-Bomq1a0z.esm.js";
+import { n as concealmentToAvatar } from "./faceCaptureSetup-CDUVU1nl.esm.js";
+import { n as setWasmDsFlagSync, t as BrowserVisibilityObserverProvider } from "./BrowserVisibilityObserverProvider-rim9Jrz-.esm.js";
+import { r as primeMotionFromUserGestureIfNeeded } from "./permissionServices-BJhGL13R.esm.js";
 
 //#region src/internal/faceCapture/faceCaptureManagerFactory.ts
 function getPermissionStatus(snapshot) {
@@ -44,18 +46,25 @@ function mapState(snapshot) {
 			permissionStatus
 		};
 	}
-	if (snapshot.matches("capture")) return {
-		status: "capture",
-		captureStatus: getCaptureStatus(snapshot) ?? "initializing",
-		stream: context.stream,
-		detectionStatus: context.detectionStatus ?? "idle",
-		debugFrame: context.debugFrame,
-		attemptsRemaining: context.attemptsRemaining ?? 0,
-		uploadError: context.uploadError,
-		assistedOnboarding: context.config?.assistedOnboarding ?? false,
-		ageAssurance: context.config?.ageAssurance === true,
-		onDeviceMode: context.config?.onDeviceFaceResultsSubmissionEnabled === true
-	};
+	if (snapshot.matches("capture")) {
+		const captureStatus = getCaptureStatus(snapshot);
+		const { obfuscateWithAvatar, avatarVariant } = concealmentToAvatar(context.config?.selfieConcealmentOption);
+		return {
+			status: "capture",
+			captureStatus: captureStatus ?? "initializing",
+			stream: context.stream,
+			detectionStatus: context.detectionStatus ?? "idle",
+			debugFrame: context.debugFrame,
+			attemptsRemaining: context.attemptsRemaining ?? 0,
+			uploadError: context.uploadError,
+			assistedOnboarding: context.config?.assistedOnboarding ?? false,
+			ageAssurance: context.config?.ageAssurance === true,
+			onDeviceMode: context.config?.onDeviceFaceResultsSubmissionEnabled === true,
+			obfuscateWithAvatar,
+			avatarCanvas: context.avatarCanvas,
+			avatarVariant
+		};
+	}
 	if (snapshot.matches("processing")) return { status: "processing" };
 	if (snapshot.matches("finished")) return {
 		status: "finished",
@@ -194,14 +203,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 +225,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 +290,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
 		})
 	});
 }