@incodetech/core 2.3.2 → 2.4.0-rc.0

package/dist/phone.d.ts

@@ -1,2 +1,2 @@
-import { n as PhoneState, o as phoneMachine, r as createPhoneManager, s as PhoneConfig, t as PhoneManager } from "./phoneManager-BBU8Lq0O.js";
+import { n as PhoneState, o as phoneMachine, r as createPhoneManager, s as PhoneConfig, t as PhoneManager } from "./phoneManager-BO-LTih5.js";
 export { type PhoneConfig, type PhoneManager, type PhoneState, createPhoneManager, phoneMachine };

package/dist/phone.esm.js

@@ -1,3 +1,3 @@
-import { t as phoneMachine } from "./phoneStateMachine-CXdXufKg.esm.js";
-import { t as createPhoneManager } from "./phoneManager-IjhSv5XS.esm.js";
+import { t as phoneMachine } from "./phoneStateMachine-CEm2y7yG.esm.js";
+import { t as createPhoneManager } from "./phoneManager-BGBcpqsk.esm.js";
 export { createPhoneManager, phoneMachine };

package/dist/{phoneManager-IjhSv5XS.esm.js → phoneManager-BGBcpqsk.esm.js}

@@ -1,6 +1,8 @@
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-ijlbX_Wx.esm.js";
-import { s as createActor, u as createManager } from "./xstate.esm-BuFLFuzz.esm.js";
-import { t as phoneMachine } from "./phoneStateMachine-CXdXufKg.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-CAgFE-k3.esm.js";
+import { s as createActor, u as createManager } from "./xstate.esm-DSajW7CJ.esm.js";
+import { n as loadPhoneValidation, t as getPhoneValidation } from "./phoneValidation-DnBcNUNh.esm.js";
+import { n as isOtpComplete } from "./otp-D2k3PeSL.esm.js";
+import { t as phoneMachine } from "./phoneStateMachine-CEm2y7yG.esm.js";
 //#region src/modules/phone/phoneActor.ts
 function createPhoneActor(options) {
 	return createActor(phoneMachine, { input: { config: options.config } }).start();
@@ -109,26 +111,32 @@ function createPhoneActor(options) {
 * screen until the SM surfaces them):
 *
 * - `phoneNumber.verify.countryCode` — country-picker overlay; no separate SM state.
-* - `phoneNumber.verify.phoneTyping` / `phoneNumber.verify.phoneFilled` — UI sub-states of `inputting`.
-* - `phoneNumber.OTP.filled` — UI sub-state of `awaitingOtp`.
 *
 * `finished` and `error` are mapped to terminal Figma screens to keep the
 * adapter from falling back to the generic `<module>.finished` /
 * `<module>.error` defaults.
 */
-function getPhoneScreenName(snapshot) {
-	const { value } = snapshot;
+function getPhoneScreenName(snapshot, phoneValidation) {
+	const { value, context } = snapshot;
 	if (typeof value !== "string") return void 0;
 	switch (value) {
-		case "idle":
+		case "idle": return "phoneNumber.verify.default";
 		case "inputting":
-		case "validatingSubmit": return "phoneNumber.verify.default";
+		case "validatingSubmit": {
+			const phone = context.phone.trim();
+			if (!phone) return "phoneNumber.verify.default";
+			const internationalPhone = phone.startsWith("+") ? phone : `+${phone}`;
+			return phoneValidation?.isPossible(internationalPhone) ? "phoneNumber.verify.phoneFilled" : "phoneNumber.verify.phoneTyping";
+		}
 		case "loadingPrefill":
-		case "loadingStartInfo": return "phoneNumber.verify.loading";
-		case "submitting": return snapshot.context?.config?.isInstantVerify ? "phoneNumber.SNA.loading" : "phoneNumber.verify.loading";
+		case "loadingStartInfo":
+		case "loadingPhoneRules": return "phoneNumber.verify.loading";
+		case "submitting": return context.config?.isInstantVerify ? "phoneNumber.SNA.loading" : "phoneNumber.verify.loading";
 		case "sendingInitialOtp":
-		case "resendingOtp":
-		case "awaitingOtp": return "phoneNumber.OTP.typing";
+		case "resendingOtp": return "phoneNumber.OTP.typing";
+		case "awaitingOtp":
+			if (context.otpValidationErrors?.otp) return "phoneNumber.OTP.error";
+			return isOtpComplete(context.otpCode) ? "phoneNumber.OTP.filled" : "phoneNumber.OTP.typing";
 		case "verifyingOtp": return "phoneNumber.OTP.processing";
 		case "otpError":
 		case "error": return "phoneNumber.OTP.error";
@@ -141,7 +149,7 @@ function mapState(snapshot) {
 	const { context } = typedSnapshot;
 	if (typedSnapshot.matches("idle")) return { status: "idle" };
 	if (typedSnapshot.matches("loadingPrefill")) return { status: "loadingPrefill" };
-	if (typedSnapshot.matches("loadingStartInfo")) return {
+	if (typedSnapshot.matches("loadingStartInfo") || typedSnapshot.matches("loadingPhoneRules")) return {
 		status: "loadingStartInfo",
 		prefilledPhone: context.prefilledPhone,
 		otpVerification: context.config.otpVerification,
@@ -371,19 +379,20 @@ function createApi({ actor, trackElementClicked }) {
 * ```
 */
 function createPhoneManager(options) {
-	return createManager({
-		actor: createPhoneActor(options),
-		mapState,
-		createApi,
-		instrumentation: createManagerInstrumentation(eventModuleNames.phone, { getEventScreenName: getPhoneScreenName })
-	});
+	return createPhoneManagerFromActor(createPhoneActor(options));
 }
-function createPhoneManagerFromActor(actor) {
+/**
+* Wraps an existing phone actor in a manager. Without `phoneValidation`, this
+* starts loading the phone rules. Until they load, the analytics screen name
+* for a typed number is `phoneTyping`.
+*/
+function createPhoneManagerFromActor(actor, phoneValidation) {
+	if (!phoneValidation) loadPhoneValidation();
 	return createManager({
 		actor,
 		mapState,
 		createApi,
-		instrumentation: createManagerInstrumentation(eventModuleNames.phone, { getEventScreenName: getPhoneScreenName })
+		instrumentation: createManagerInstrumentation(eventModuleNames.phone, { getEventScreenName: (snapshot) => getPhoneScreenName(snapshot, phoneValidation ?? getPhoneValidation()) })
 	});
 }
 //#endregion

package/dist/{phoneManager-BBU8Lq0O.d.ts → phoneManager-BO-LTih5.d.ts}

@@ -1,7 +1,15 @@
 import { i as ActorRefFrom } from "./spawn-D9jgw9pW.js";
-import { t as Manager } from "./Manager-CQQ99QOI.js";
-import "./Actor-iTq7YY48.js";
+import { t as Manager } from "./Manager-C9T5amUN.js";
+import "./Actor-DpTj5PFb.js";
 import { t as OtpValidationErrors } from "./otp-CEWfTj9v.js";
+//#region ../infra/src/capabilities/IPhoneValidationCapability.d.ts
+type IPhoneValidationCapability = {
+  /** Checks the possible length of an international number, not its validity. */
+  isPossible(phone: string): boolean;
+  isValid(phone: string, country: string): boolean;
+  formatE164(phone: string, country: string): string | null;
+};
+//#endregion
 //#region src/modules/phone/types.d.ts
 /**
  * Configuration options for phone verification.
@@ -343,7 +351,12 @@ declare function createPhoneManager(options: CreatePhoneActorOptions): Manager<P
    */
   reset(): void;
 };
-declare function createPhoneManagerFromActor(actor: PhoneActor): Manager<PhoneState> & {
+/**
+ * Wraps an existing phone actor in a manager. Without `phoneValidation`, this
+ * starts loading the phone rules. Until they load, the analytics screen name
+ * for a typed number is `phoneTyping`.
+ */
+declare function createPhoneManagerFromActor(actor: PhoneActor, phoneValidation?: Pick<IPhoneValidationCapability, 'isPossible'>): Manager<PhoneState> & {
   /**
    * Initializes the phone verification flow.
    * Transitions from 'idle' to 'loadingPrefill' or 'inputting'.

package/dist/{phoneStateMachine-CXdXufKg.esm.js → phoneStateMachine-CEm2y7yG.esm.js}

@@ -1,8 +1,9 @@
-import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BXhgNxLt.esm.js";
 import { t as api } from "./api-Bx3gKW_y.esm.js";
-import { t as endpoints } from "./endpoints-B-3Q-LUw.esm.js";
-import { i as assign, t as setup } from "./xstate.esm-BuFLFuzz.esm.js";
-import { n as fromPromise, t as fromCallback } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
+import { t as endpoints } from "./endpoints-DHzlkQNe.esm.js";
+import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BXhgNxLt.esm.js";
+import { i as assign, t as setup } from "./xstate.esm-DSajW7CJ.esm.js";
+import { n as fromPromise, t as fromCallback } from "./xstate-actors.esm-8Gzepa_A.esm.js";
+import { n as loadPhoneValidation } from "./phoneValidation-DnBcNUNh.esm.js";
 import { n as isOtpComplete, t as computeOtpValidationErrors } from "./otp-D2k3PeSL.esm.js";
 //#region src/modules/phone/phoneServices.ts
 function getPhoneServerFailureReason(error, invalidStatus) {
@@ -77,6 +78,9 @@ const phoneMachine = setup({
 		fetchStartInfo: fromPromise(async ({ signal }) => {
 			return fetchStartInfo(signal);
 		}),
+		loadPhoneRules: fromPromise(async () => {
+			await loadPhoneValidation();
+		}),
 		submitPhone: fromPromise(async ({ input, signal }) => {
 			if (input.isInstantVerify) return addPhoneInstantVerify({
 				phone: input.phone,
@@ -106,6 +110,9 @@ const phoneMachine = setup({
 		})
 	},
 	actions: {
+		startLoadingPhoneRules: () => {
+			loadPhoneValidation();
+		},
 		setStartInfo: assign(({ event }) => {
 			const info = event.output;
 			return {
@@ -228,22 +235,34 @@ const phoneMachine = setup({
 			target: "loadingPrefill",
 			guard: "hasPrefill"
 		}, { target: "loadingStartInfo" }] } },
-		loadingPrefill: { invoke: {
-			id: "fetchPhone",
-			src: "fetchPhone",
-			onDone: {
-				target: "loadingStartInfo",
-				actions: "setPrefilledPhone"
-			},
-			onError: { target: "loadingStartInfo" }
-		} },
-		loadingStartInfo: { invoke: {
-			id: "fetchStartInfo",
-			src: "fetchStartInfo",
-			onDone: {
-				target: "inputting",
-				actions: "setStartInfo"
-			},
+		loadingPrefill: {
+			entry: "startLoadingPhoneRules",
+			invoke: {
+				id: "fetchPhone",
+				src: "fetchPhone",
+				onDone: {
+					target: "loadingStartInfo",
+					actions: "setPrefilledPhone"
+				},
+				onError: { target: "loadingStartInfo" }
+			}
+		},
+		loadingStartInfo: {
+			entry: "startLoadingPhoneRules",
+			invoke: {
+				id: "fetchStartInfo",
+				src: "fetchStartInfo",
+				onDone: {
+					target: "loadingPhoneRules",
+					actions: "setStartInfo"
+				},
+				onError: { target: "loadingPhoneRules" }
+			}
+		},
+		loadingPhoneRules: { invoke: {
+			id: "loadPhoneRules",
+			src: "loadPhoneRules",
+			onDone: { target: "inputting" },
 			onError: { target: "inputting" }
 		} },
 		inputting: { on: {

package/dist/phoneValidation-DnBcNUNh.esm.js

@@ -0,0 +1,48 @@
+import { t as BrowserLazyImportProvider } from "./BrowserLazyImportProvider-BhoA957O.esm.js";
+//#region ../infra/src/providers/browser/LazyPhoneValidationProvider.ts
+const LAZY_IMPORT_OPTIONS = {
+	label: "PhoneValidation",
+	moduleName: "the phone rules (libphonenumber-js)",
+	timeoutMs: 1e4,
+	disabledMessage: "phone numbers are not checked until a retry loads them."
+};
+/**
+* Loads {@link PhoneValidationProvider} (libphonenumber-js, ~160 KB minified)
+* with a dynamic `import()`, so the modules that check phone numbers do not
+* download the rules up front.
+*
+* The import is managed by {@link BrowserLazyImportProvider}. A load that
+* fails, or takes more than 10 s, logs a warning and resolves `undefined`. It
+* is not cached, so a later `load()` retries.
+*/
+var LazyPhoneValidationProvider = class LazyPhoneValidationProvider {
+	constructor() {
+		this._lazy = BrowserLazyImportProvider.getInstance().create(async () => {
+			const { PhoneValidationProvider } = await import("./PhoneValidationProvider-SZiOS0jB.esm.js").then((n) => n.n);
+			return new PhoneValidationProvider();
+		}, LAZY_IMPORT_OPTIONS);
+	}
+	static getInstance() {
+		return this._instance ??= new LazyPhoneValidationProvider();
+	}
+	/** Resolves to `undefined` when the load fails or times out. */
+	load() {
+		return this._lazy.load();
+	}
+	/** The loaded rules, or `undefined` until `load()` resolves. */
+	get() {
+		return this._lazy.get();
+	}
+};
+//#endregion
+//#region src/internal/phoneValidation/phoneValidation.ts
+/** Resolves to `undefined` when the load fails or times out. A later call retries. */
+function loadPhoneValidation() {
+	return LazyPhoneValidationProvider.getInstance().load();
+}
+/** The loaded rules, or `undefined` until `loadPhoneValidation()` resolves. */
+function getPhoneValidation() {
+	return LazyPhoneValidationProvider.getInstance().get();
+}
+//#endregion
+export { loadPhoneValidation as n, getPhoneValidation as t };

package/dist/qe-signature.d.ts

@@ -1,6 +1,6 @@
-import { t as Manager } from "./Manager-CQQ99QOI.js";
+import { t as Manager } from "./Manager-C9T5amUN.js";
 import { S as getDefaultConsentChecks, a as ElectronicSignatureConfig, b as areAllConsented, f as NAMIRIAL_QES_CONSENT_KEYS, h as QE_CONSENT_KEYS, i as ConsentKey, m as NamirialQesConsentKey, p as NAMIRIAL_QES_PROVIDER_CODE, r as ConsentChecks, s as ElectronicSignatureDocument, u as ElectronicSignatureProviderTerms } from "./types-D0gekt4U.js";
-import { n as ElectronicSignatureState, o as electronicSignatureMachine } from "./electronicSignatureManager-Ds-KEVTq.js";
+import { n as ElectronicSignatureState, o as electronicSignatureMachine } from "./electronicSignatureManager-DTSLOvKR.js";
 import "./electronic-signature.js";
 //#region src/modules/qe-signature/index.d.ts
 type QeSignatureConfig = Omit<ElectronicSignatureConfig, 'variant'>;

package/dist/qe-signature.esm.js

@@ -1,4 +1,4 @@
-import { a as NAMIRIAL_QES_CONSENT_KEYS, c as areAllConsented, o as NAMIRIAL_QES_PROVIDER_CODE, r as electronicSignatureMachine, s as QE_CONSENT_KEYS, t as createElectronicSignatureManager, u as getDefaultConsentChecks } from "./electronicSignatureManager-yYUc30na.esm.js";
+import { a as NAMIRIAL_QES_CONSENT_KEYS, c as areAllConsented, o as NAMIRIAL_QES_PROVIDER_CODE, r as electronicSignatureMachine, s as QE_CONSENT_KEYS, t as createElectronicSignatureManager, u as getDefaultConsentChecks } from "./electronicSignatureManager-Bc8spG8p.esm.js";
 //#region src/modules/qe-signature/index.ts
 function createQeSignatureManager(options) {
 	return createElectronicSignatureManager({ config: {

package/dist/redirect-to-mobile.d.ts

@@ -1,5 +1,5 @@
 import { n as RedirectToMobileServices, t as RedirectToMobileConfig } from "./types-DPIDuhut.js";
-import { a as RedirectToMobileActor, i as createRedirectToMobileManagerFromActor, n as RedirectToMobileState, o as redirectToMobileMachine, r as createRedirectToMobileManager, t as RedirectToMobileManager } from "./redirectToMobileManager-BD2PvT5B.js";
+import { a as RedirectToMobileActor, i as createRedirectToMobileManagerFromActor, n as RedirectToMobileState, o as redirectToMobileMachine, r as createRedirectToMobileManager, t as RedirectToMobileManager } from "./redirectToMobileManager-CVsvpVbQ.js";
 //#region src/modules/redirect-to-mobile/redirectToMobileServices.d.ts
 declare const defaultRedirectToMobileServices: RedirectToMobileServices;
 //#endregion

package/dist/redirect-to-mobile.esm.js

@@ -1,3 +1,3 @@
-import { n as redirectToMobileMachine, r as defaultRedirectToMobileServices } from "./redirectToMobileStateMachine-CSWWgUTO.esm.js";
-import { n as createRedirectToMobileManagerFromActor, t as createRedirectToMobileManager } from "./redirectToMobileManager-FLEWJtv8.esm.js";
+import { n as redirectToMobileMachine, r as defaultRedirectToMobileServices } from "./redirectToMobileStateMachine--Sr9NEVT.esm.js";
+import { n as createRedirectToMobileManagerFromActor, t as createRedirectToMobileManager } from "./redirectToMobileManager-B1yQHFLu.esm.js";
 export { createRedirectToMobileManager, createRedirectToMobileManagerFromActor, defaultRedirectToMobileServices, redirectToMobileMachine };

package/dist/{redirectToMobileManager-FLEWJtv8.esm.js → redirectToMobileManager-B1yQHFLu.esm.js}

@@ -1,8 +1,8 @@
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-CAgFE-k3.esm.js";
 import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BXhgNxLt.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-ijlbX_Wx.esm.js";
-import { s as createActor, u as createManager } from "./xstate.esm-BuFLFuzz.esm.js";
-import { n as fromPromise, t as fromCallback } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
-import { n as redirectToMobileMachine, r as defaultRedirectToMobileServices, t as canResendSmsFromContext } from "./redirectToMobileStateMachine-CSWWgUTO.esm.js";
+import { s as createActor, u as createManager } from "./xstate.esm-DSajW7CJ.esm.js";
+import { n as fromPromise, t as fromCallback } from "./xstate-actors.esm-8Gzepa_A.esm.js";
+import { n as redirectToMobileMachine, r as defaultRedirectToMobileServices, t as canResendSmsFromContext } from "./redirectToMobileStateMachine--Sr9NEVT.esm.js";
 //#region src/modules/redirect-to-mobile/redirectToMobileActor.ts
 const POLL_INTERVAL_MS = 5e3;
 const QR_REFRESH_INTERVAL_MS = 5e3;

package/dist/{redirectToMobileManager-BD2PvT5B.d.ts → redirectToMobileManager-CVsvpVbQ.d.ts}

@@ -1,6 +1,6 @@
 import { i as ActorRefFrom } from "./spawn-D9jgw9pW.js";
-import { t as Manager } from "./Manager-CQQ99QOI.js";
-import "./Actor-iTq7YY48.js";
+import { t as Manager } from "./Manager-C9T5amUN.js";
+import "./Actor-DpTj5PFb.js";
 import { n as RedirectToMobileServices, t as RedirectToMobileConfig } from "./types-DPIDuhut.js";
 //#region src/modules/redirect-to-mobile/redirectToMobileStateMachine.d.ts
 declare const redirectToMobileMachine: any;

package/dist/{redirectToMobileStateMachine-CSWWgUTO.esm.js → redirectToMobileStateMachine--Sr9NEVT.esm.js}

@@ -1,9 +1,9 @@
-import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BXhgNxLt.esm.js";
 import { t as api } from "./api-Bx3gKW_y.esm.js";
-import { t as endpoints } from "./endpoints-B-3Q-LUw.esm.js";
-import { i as assign, t as setup } from "./xstate.esm-BuFLFuzz.esm.js";
-import { n as fromPromise, t as fromCallback } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
-import { n as getUrlSearchParam, t as buildUrlWithSearchParams } from "./urlUtils-D6phjq1-.esm.js";
+import { t as endpoints } from "./endpoints-DHzlkQNe.esm.js";
+import { t as BrowserTimerProvider } from "./BrowserTimerProvider-BXhgNxLt.esm.js";
+import { i as assign, t as setup } from "./xstate.esm-DSajW7CJ.esm.js";
+import { n as fromPromise, t as fromCallback } from "./xstate-actors.esm-8Gzepa_A.esm.js";
+import { n as getUrlSearchParam, t as buildUrlWithSearchParams } from "./urlUtils-6jsE6rKp.esm.js";
 //#region src/modules/redirect-to-mobile/redirectToMobileServices.ts
 async function fetchRedirectUrl(signal) {
 	const res = await api.get(endpoints.onboardingUrl, { signal });

package/dist/{rolldown-runtime-FDOR9p9I.esm.js → rolldown-runtime-B-1-B7_t.esm.js}

@@ -6,6 +6,15 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
 var __copyProps = (to, from, except, desc) => {
 	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
 		key = keys[i];
@@ -21,4 +30,4 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-export { __toESM as n, __commonJSMin as t };
+export { __exportAll as n, __toESM as r, __commonJSMin as t };

package/dist/{runChildModule-B2Y_hlix.esm.js → runChildModule-vdxQMCmO.esm.js}

@@ -1,8 +1,8 @@
-import { a as notifyTrueSightManagerStopped, i as notifyTrueSightFlowEvent } from "./trueSightService-M5VpCo96.esm.js";
+import { a as notifyTrueSightManagerStopped, i as notifyTrueSightFlowEvent } from "./trueSightService-BWgRVGIT.esm.js";
 import { t as getTimestamp } from "./IBrowserEnvironmentCapability-DEaRRk-R.esm.js";
-import { C as createEventBus } from "./events-ijlbX_Wx.esm.js";
-import { s as createActor } from "./xstate.esm-BuFLFuzz.esm.js";
-import { t as fromCallback } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
+import { C as createEventBus } from "./events-CAgFE-k3.esm.js";
+import { s as createActor } from "./xstate.esm-DSajW7CJ.esm.js";
+import { t as fromCallback } from "./xstate-actors.esm-8Gzepa_A.esm.js";
 //#region src/internal/flow-events/flowEvents.ts
 function createFlowEventBus() {
 	const eventBus = createEventBus();
@@ -63,6 +63,7 @@ function getActiveModule(state, includeHomeModule) {
 function attachFlowEventEmitter(manager, options = {}) {
 	const flowEventBus = createFlowEventBus();
 	const managerKind = options.managerKind ?? "flow";
+	const getInterviewId = () => options.getInterviewId?.() ?? options.interviewId;
 	flowEventBus.subscribe((event) => notifyTrueSightFlowEvent(event, managerKind));
 	let hasStartedCurrentRun = false;
 	let hasReadyCurrentRun = false;
@@ -90,7 +91,7 @@ function attachFlowEventEmitter(manager, options = {}) {
 		activeModule = nextModule;
 		flowEventBus.emit({
 			type: "flow.module.started",
-			interviewId: options.interviewId,
+			interviewId: getInterviewId(),
 			flowId: getFlowId(state),
 			module: nextModule.module,
 			payload: nextModule.payload
@@ -101,7 +102,7 @@ function attachFlowEventEmitter(manager, options = {}) {
 		completedModuleKeys.add(activeModule.key);
 		flowEventBus.emit({
 			type: "flow.module.completed",
-			interviewId: options.interviewId,
+			interviewId: getInterviewId(),
 			flowId: getFlowId(state),
 			module: activeModule.module,
 			payload: activeModule.payload
@@ -116,7 +117,7 @@ function attachFlowEventEmitter(manager, options = {}) {
 			hasStartedCurrentRun = true;
 			flowEventBus.emit({
 				type: "flow.started",
-				interviewId: options.interviewId
+				interviewId: getInterviewId()
 			});
 			return;
 		}
@@ -132,7 +133,7 @@ function attachFlowEventEmitter(manager, options = {}) {
 				hasReadyCurrentRun = true;
 				flowEventBus.emit({
 					type: "flow.ready",
-					interviewId: options.interviewId,
+					interviewId: getInterviewId(),
 					flowId: getFlowId(readyState),
 					payload: getReadyPayload(readyState)
 				});
@@ -146,7 +147,7 @@ function attachFlowEventEmitter(manager, options = {}) {
 			hasCompletedCurrentRun = true;
 			flowEventBus.emit({
 				type: "flow.completed",
-				interviewId: options.interviewId,
+				interviewId: getInterviewId(),
 				flowId: getFlowId(state),
 				...payload !== void 0 ? { payload } : {}
 			});
@@ -156,7 +157,7 @@ function attachFlowEventEmitter(manager, options = {}) {
 			hasErrorCurrentRun = true;
 			flowEventBus.emit({
 				type: "flow.error",
-				interviewId: options.interviewId,
+				interviewId: getInterviewId(),
 				flowId: getFlowId(state),
 				error: state.error ?? "Unknown error"
 			});
@@ -166,7 +167,7 @@ function attachFlowEventEmitter(manager, options = {}) {
 			hasClosedCurrentRun = true;
 			flowEventBus.emit({
 				type: "flow.closed",
-				interviewId: options.interviewId,
+				interviewId: getInterviewId(),
 				flowId: getFlowId(state)
 			});
 		}
@@ -196,7 +197,7 @@ function attachFlowEventEmitter(manager, options = {}) {
 }
 //#endregion
 //#region src/internal/orchestration/runChildModule.ts
-const runChildModule = fromCallback(({ sendBack, input }) => {
+const runChildModule = /* @__PURE__ */ fromCallback(({ sendBack, input }) => {
 	const { machine, config } = input;
 	if (!machine) return () => {};
 	const actor = createActor(machine, { input: { config } });

package/dist/safeStorage-UxDrnjwa.esm.js

@@ -0,0 +1,35 @@
+//#region ../infra/src/storage/safeStorage.ts
+/**
+* Storage resolvers that tolerate hosts which make Web Storage unreachable.
+*
+* Two hostile shapes occur in the field, and they fail differently:
+*
+* 1. **Deleted bare global** — a page mitigates self-XSS with
+*    `delete window.localStorage` and keeps a module-private reference. Since
+*    `window` *is* the global object, the identifier stops resolving: a bare
+*    read throws `ReferenceError`. `typeof` is the only safe probe, because it
+*    is the one operator that tolerates an unresolvable identifier.
+* 2. **Blocked storage** — a webview or a cross-origin/partitioned context
+*    makes the accessor itself throw (`SecurityError`). Here `typeof` is *not*
+*    enough: it invokes the getter, so the throw escapes the guard.
+*
+* Handling only one shape leaves the other live, so always go through these
+* resolvers instead of touching the globals directly. A `null` return means
+* "no storage in this host" — callers degrade, they do not throw.
+*/
+function resolveLocalStorage() {
+	try {
+		return typeof localStorage === "undefined" ? null : localStorage;
+	} catch {
+		return null;
+	}
+}
+function resolveSessionStorage() {
+	try {
+		return typeof sessionStorage === "undefined" ? null : sessionStorage;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { resolveSessionStorage as n, resolveLocalStorage as t };

package/dist/{sdkVersion-N1UiyFiY.esm.js → sdkVersion-F5YZbjip.esm.js}

@@ -1,4 +1,4 @@
 //#region src/internal/version/sdkVersion.ts
-const SDK_VERSION = "2.3.2+ee2957c";
+const SDK_VERSION = "2.4.0-rc.0";
 //#endregion
 export { SDK_VERSION as t };

package/dist/selfie.d.ts

@@ -1,10 +1,10 @@
 import { t as IVisibilityObserverCapability } from "./IVisibilityObserverCapability-D4tvIB5v.js";
-import { _ as SelfieCaptureOnlyConfig, a as SelfieCaptureOnlyMachine, c as SelfieActor, g as processFace, h as ProcessFaceResponse, i as SelfieCaptureOnlyActor, l as SelfieMachine, n as FaceCaptureManagerState, o as selfieCaptureOnlyMachine, r as CreateSelfieCaptureOnlyActorOptions, t as FaceCaptureManager, u as selfieMachine, v as SelfieConfig } from "./faceCaptureManagerFactory-m-7ae67q.js";
+import { _ as SelfieCaptureOnlyConfig, a as SelfieCaptureOnlyMachine, c as SelfieActor, g as processFace, h as ProcessFaceResponse, i as SelfieCaptureOnlyActor, l as SelfieMachine, n as FaceCaptureManagerState, o as selfieCaptureOnlyMachine, r as CreateSelfieCaptureOnlyActorOptions, t as FaceCaptureManager, u as selfieMachine, v as SelfieConfig } from "./faceCaptureManagerFactory-jKQ2QtY-.js";
 import { n as PermissionStatus, t as PermissionResult } from "./types-BEwVKkLJ.js";
-import { a as FaceCapturedImageData, i as FaceCaptureOnlyResponse, n as DetectionStatus, o as FaceErrorCode } from "./types-ESdtnHtg.js";
-import { n as DeepsightService } from "./StreamCanvasCapture-_8gdW5Lk.js";
+import { a as FaceCapturedImageData, i as FaceCaptureOnlyResponse, n as DetectionStatus, o as FaceErrorCode } from "./types-zpO4fU6a.js";
+import { n as DeepsightService } from "./StreamCanvasCapture-DVmzJux5.js";
 import { t as CameraStream } from "./camera-9wWD-pwg.js";
-import { i as createSelfieManagerFromActor, n as SelfieState, r as createSelfieManager, t as SelfieManager } from "./selfieManager-BSZG891S.js";
+import { i as createSelfieManagerFromActor, n as SelfieState, r as createSelfieManager, t as SelfieManager } from "./selfieManager-1J0IEyFq.js";
 //#region src/modules/selfie/selfieCaptureOnlyManager.d.ts
 type SelfieCaptureOnlyState = FaceCaptureManagerState;
 type SelfieCaptureOnlyManager = FaceCaptureManager;

package/dist/selfie.esm.js

@@ -1,15 +1,15 @@
-import { r as WasmUtilProvider } from "./safeStorage-BdU9_m2E.esm.js";
-import { l as BrowserStorageProvider } from "./setup-BuPbxpwF.esm.js";
-import { n as eventModuleNames } from "./events-ijlbX_Wx.esm.js";
-import { s as createActor } from "./xstate.esm-BuFLFuzz.esm.js";
-import { n as fromPromise } from "./xstate-actors.esm-BXeQ-Ucz.esm.js";
-import { n as createDefaultProtectedFaceControllerActor, t as faceCaptureMachine } from "./faceCaptureSetup-DU1mjRr6.esm.js";
-import { t as createFaceCaptureManagerFromActor } from "./faceCaptureManagerFactory-B6i9QcAk.esm.js";
-import { s as PROTECTED_CAPTURE_TARGET } from "./createCameraCycleOwnership-DnwTl1ad.esm.js";
-import { r as processFace } from "./selfieErrorUtils-UiQ46EBa.esm.js";
-import { t as selfieMachine } from "./selfieStateMachine-DY7vJVNY.esm.js";
-import { n as createSelfieManagerFromActor, t as createSelfieManager } from "./selfieManager-AS6wfUvZ.esm.js";
-import { t as invokeOnCaptureCallback } from "./invokeOnCaptureCallback-BjzPjJ_p.esm.js";
+import { t as WasmUtilProvider } from "./WasmUtilProvider-CIdnE7Fx.esm.js";
+import { n as eventModuleNames } from "./events-CAgFE-k3.esm.js";
+import { u as BrowserStorageProvider } from "./setup-C38QkrSP.esm.js";
+import { s as createActor } from "./xstate.esm-DSajW7CJ.esm.js";
+import { n as fromPromise } from "./xstate-actors.esm-8Gzepa_A.esm.js";
+import { n as createDefaultProtectedFaceControllerActor, t as faceCaptureMachine } from "./faceCaptureSetup-Cu2wabzo.esm.js";
+import { t as createFaceCaptureManagerFromActor } from "./faceCaptureManagerFactory-uFm1AcaY.esm.js";
+import { c as processFace } from "./FaceDetectionProvider-BjTer9h3.esm.js";
+import { o as PROTECTED_CAPTURE_TARGET } from "./createCameraCycleOwnership-kdlhkmmY.esm.js";
+import { t as selfieMachine } from "./selfieStateMachine-BhfKsl3I.esm.js";
+import { n as createSelfieManagerFromActor, t as createSelfieManager } from "./selfieManager-26pENXxw.esm.js";
+import { t as invokeOnCaptureCallback } from "./invokeOnCaptureCallback-BW7V3vub.esm.js";
 /**
 * Selfie state machine variant for the captureOnly flow. Shares the full base
 * face-capture state tree; only the upload/process step is local instead of

package/dist/selfieErrorUtils-D-tsgEuX.esm.js

@@ -0,0 +1,21 @@
+import { d as FACE_ERROR_CODES } from "./FaceDetectionProvider-BjTer9h3.esm.js";
+//#region src/modules/selfie/selfieErrorUtils.ts
+const FACE_ERROR_CODE_VALUES = Object.values(FACE_ERROR_CODES);
+const isFaceErrorCode = (value) => {
+	return FACE_ERROR_CODE_VALUES.includes(value);
+};
+const getFaceErrorCodeFromUnknown = (value) => {
+	if (value instanceof Error && typeof value.message === "string") return isFaceErrorCode(value.message) ? value.message : void 0;
+	if (typeof value === "string") return isFaceErrorCode(value) ? value : void 0;
+};
+const validateUploadResponse = ({ config, response }) => {
+	if (!response) return FACE_ERROR_CODES.SERVER;
+	if (response.confidence !== 0) return FACE_ERROR_CODES.LIVENESS;
+	if (config.validateBrightness && !response.isBright) return FACE_ERROR_CODES.BRIGHTNESS;
+	if (config.validateLenses && response.hasLenses) return FACE_ERROR_CODES.LENSES;
+	if (config.validateFaceMask && response.hasFaceMask) return FACE_ERROR_CODES.MASK;
+	if (config.validateClosedEyes && response.hasClosedEyes) return FACE_ERROR_CODES.CLOSED_EYES;
+	if (config.validateHeadCover && response.hasHeadCover) return FACE_ERROR_CODES.HEAD_COVER;
+};
+//#endregion
+export { validateUploadResponse as n, getFaceErrorCodeFromUnknown as t };

package/dist/{selfieManager-BSZG891S.d.ts → selfieManager-1J0IEyFq.d.ts}

@@ -1,6 +1,6 @@
-import { t as Manager } from "./Manager-CQQ99QOI.js";
+import { t as Manager } from "./Manager-C9T5amUN.js";
 import { t as IVisibilityObserverCapability } from "./IVisibilityObserverCapability-D4tvIB5v.js";
-import { c as SelfieActor, n as FaceCaptureManagerState, s as CreateSelfieActorOptions, t as FaceCaptureManager } from "./faceCaptureManagerFactory-m-7ae67q.js";
+import { c as SelfieActor, n as FaceCaptureManagerState, s as CreateSelfieActorOptions, t as FaceCaptureManager } from "./faceCaptureManagerFactory-jKQ2QtY-.js";
 //#region src/modules/selfie/selfieManager.d.ts
 type SelfieState = FaceCaptureManagerState;
 /**
@@ -22,9 +22,6 @@ declare function createSelfieManagerFromActor(actor: SelfieActor, visibilityObse
   reset(): void;
   retryCapture(): void;
   capture(): void;
-  goToManualUpload(): void;
-  manualUploadSelectFile(file: File): void;
-  manualUploadContinue(): void;
 };
 /**
  * Creates a selfie manager instance for handling selfie capture flow.
@@ -65,9 +62,6 @@ declare function createSelfieManager(options: CreateSelfieActorOptions): Manager
   reset(): void;
   retryCapture(): void;
   capture(): void;
-  goToManualUpload(): void;
-  manualUploadSelectFile(file: File): void;
-  manualUploadContinue(): void;
 };
 type SelfieManager = FaceCaptureManager;
 //#endregion

package/dist/{selfieManager-AS6wfUvZ.esm.js → selfieManager-26pENXxw.esm.js}

@@ -1,9 +1,9 @@
-import { r as WasmUtilProvider } from "./safeStorage-BdU9_m2E.esm.js";
-import { l as BrowserStorageProvider } from "./setup-BuPbxpwF.esm.js";
-import { n as eventModuleNames } from "./events-ijlbX_Wx.esm.js";
-import { s as createActor } from "./xstate.esm-BuFLFuzz.esm.js";
-import { t as createFaceCaptureManagerFromActor } from "./faceCaptureManagerFactory-B6i9QcAk.esm.js";
-import { t as selfieMachine } from "./selfieStateMachine-DY7vJVNY.esm.js";
+import { t as WasmUtilProvider } from "./WasmUtilProvider-CIdnE7Fx.esm.js";
+import { n as eventModuleNames } from "./events-CAgFE-k3.esm.js";
+import { u as BrowserStorageProvider } from "./setup-C38QkrSP.esm.js";
+import { s as createActor } from "./xstate.esm-DSajW7CJ.esm.js";
+import { t as createFaceCaptureManagerFromActor } from "./faceCaptureManagerFactory-uFm1AcaY.esm.js";
+import { t as selfieMachine } from "./selfieStateMachine-BhfKsl3I.esm.js";
 //#region src/modules/selfie/selfieActor.ts
 function createSelfieActor(options) {
 	const dependencies = options.dependencies ?? {