@incodetech/core 2.0.1-rc.0 → 2.1.0-rc.0

package/dist/ekyc.d.ts

@@ -1,74 +1,7 @@
-import { t as Manager } from "./Manager-C8PrhBOx.js";
-import "./Actor-CI32dTbG.js";
-import { n as AddressSuggestion, r as FieldDef, t as DisplayErrorsResult } from "./displayErrors-DqJ_IbsG.js";
+import { t as Manager } from "./Manager-BHn8wH8K.js";
+import "./Actor-Y0_Fj-KL.js";
+import { a as EkycValidationError, c as AddressSuggestion, i as EkycModuleConfig, n as EkycFieldDef, o as EkycValidationErrors, r as EkycFormValues, t as EkycConfig } from "./types-DvGZI7BF.js";
 
-//#region src/modules/ekyc/types.d.ts
-type EkycFieldSource = 'user_input' | 'document_scan' | 'poa_document' | 'phone_module_input' | 'email_module_input' | false;
-type EkycVerificationFields = {
-  name?: EkycFieldSource;
-  address?: EkycFieldSource;
-  phone?: EkycFieldSource;
-  email?: EkycFieldSource;
-  SSN?: EkycFieldSource;
-  taxId?: EkycFieldSource;
-  nationality?: EkycFieldSource;
-  'date of birth'?: EkycFieldSource;
-  dlNumber?: EkycFieldSource;
-  dlState?: EkycFieldSource;
-  dlExpireAt?: EkycFieldSource;
-  last4SSN?: EkycFieldSource;
-  idNum?: EkycFieldSource;
-  idNum1?: EkycFieldSource;
-  gender?: EkycFieldSource;
-  panNumber?: EkycFieldSource;
-};
-type EkycModuleConfig = {
-  source: string;
-  enablePhoneRisk?: boolean;
-  checkName?: boolean;
-  nameSource?: string;
-  checkEmail?: boolean;
-  emailSource?: string;
-  checkAddress?: boolean;
-  addressSource?: string;
-  checkPhone?: boolean;
-  phoneSource?: string;
-  checkSsn?: boolean;
-  ssnSource?: string;
-  checkDob?: boolean;
-  dobSource?: string;
-  checkNationality?: boolean;
-  nationalitySource?: string;
-  checkDlNumber?: boolean;
-  dlNumberSource?: string;
-  checkDlState?: boolean;
-  dlStateSource?: string;
-  checkDlExpireAt?: boolean;
-  dlExpireAtSource?: string;
-  checkLast4SSN?: boolean;
-  last4SSNSource?: string;
-  checkIdNum?: boolean;
-  idNumSource?: string;
-  checkIdNum1?: boolean;
-  idNum1Source?: string;
-  checkGender?: boolean;
-  genderSource?: string;
-  checkPanNumber?: boolean;
-  panNumberSource?: string;
-};
-type EkycFormValues = Record<string, string | undefined>;
-/** Manager creation config */
-type EkycConfig = {
-  flowId?: string;
-  verificationFields?: EkycVerificationFields;
-  source?: string;
-  fieldsCountry?: string;
-  enablePhoneRisk?: boolean;
-};
-type EkycFieldDef = FieldDef & {
-  source: EkycFieldSource;
-};
-//#endregion
 //#region src/modules/ekyc/ekycStateMachine.d.ts
 declare const ekycMachine: any;
 //#endregion
@@ -85,14 +18,14 @@ type EkycFormState = {
   status: 'form';
   fields: EkycFieldDef[];
   values: EkycFormValues;
-  errors: Record<string, string>;
+  validationErrors?: EkycValidationErrors;
+  /** True iff `validationErrors` is empty. Optimistic semantic: starts true on initial render. */
   isValid: boolean;
   addressSuggestions: AddressSuggestion[];
   prefilled: Record<string, boolean>;
   hideEmail: boolean;
   fieldsCountry: string;
   submitError: string;
-  submitAttempted: boolean;
 };
 type EkycSubmittingState = {
   status: 'submitting';
@@ -123,13 +56,15 @@ type EkycState = EkycLoadingState | EkycFormState | EkycSubmittingState | EkycSu
 declare function createEkycManager(options: CreateEkycActorOptions): Manager<EkycState> & {
   /** Initializes the eKYC flow — fetches config and pre-fill data */
   load(): void;
-  /** Sets a form field value and triggers revalidation */
+  /** Sets a form field value. Clears any existing validation error for this field. */
   setField(name: string, value: string): void;
+  /** Validates a single field (e.g., on blur). Populates or clears `validationErrors[name]`. */
+  validateField(name: string): void;
   /** Initiates a debounced address autocomplete search */
   searchAddress(query: string): void;
   /** Selects an address suggestion and populates address fields */
   selectAddress(suggestion: AddressSuggestion): void;
-  /** Submits the form (requires isValid to be true) */
+  /** Submits the form. Runs full-form validation; advances only when no errors. */
   submit(): void;
   /** Retries from failure state, returning to the form */
   retry(): void;
@@ -140,9 +75,6 @@ declare function createEkycManager(options: CreateEkycActorOptions): Manager<Eky
 };
 type EkycManager = ReturnType<typeof createEkycManager>;
 //#endregion
-//#region src/modules/ekyc/ekycActions.d.ts
-declare function computeDisplayErrors(errors: Record<string, string>, touched: Record<string, boolean>, submitAttempted: boolean, country: string, fields?: EkycFieldDef[]): DisplayErrorsResult;
-//#endregion
 //#region src/modules/ekyc/ekycUtils.d.ts
 /**
  * Normalizes any supported eKYC config input into a manager-ready `EkycConfig`.
@@ -161,4 +93,4 @@ declare function computeDisplayErrors(errors: Record<string, string>, touched: R
  */
 declare function toEkycConfig(config: Partial<EkycModuleConfig> & Partial<EkycConfig>): EkycConfig;
 //#endregion
-export { type AddressSuggestion, type EkycConfig, type EkycManager, type EkycModuleConfig, type EkycState, computeDisplayErrors as computeEkycDisplayErrors, createEkycManager, ekycMachine, toEkycConfig };
+export { type AddressSuggestion, type EkycConfig, type EkycManager, type EkycModuleConfig, type EkycState, type EkycValidationError, type EkycValidationErrors, createEkycManager, ekycMachine, toEkycConfig };

package/dist/ekyc.esm.js

@@ -1,11 +1,11 @@
 import "./BrowserTimerProvider-DhNc_x02.esm.js";
 import "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-D6-e4vok.esm.js";
-import "./endpoints-CnN3SyDa.esm.js";
-import { c as createManager, s as createActor } from "./xstate.esm-B70JrNqo.esm.js";
-import "./cpf-PPz2Njto.esm.js";
-import "./addressSearch-BpTbTWCa.esm.js";
-import { n as computeDisplayErrors, r as toEkycConfig, t as ekycMachine } from "./ekycStateMachine-oeO0Iekd.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 "./cpf-BRzggV8G.esm.js";
+import "./addressSearch-DvmWXKZg.esm.js";
+import { n as toEkycConfig, t as ekycMachine } from "./ekycStateMachine-CXbpaJJn.esm.js";
 
 //#region src/modules/ekyc/ekycActor.ts
 /**
@@ -26,14 +26,13 @@ function mapState(snapshot) {
 		status: "form",
 		fields: context.fields,
 		values: context.values,
-		errors: context.errors,
-		isValid: context.isValid,
+		validationErrors: context.validationErrors,
+		isValid: Object.keys(context.validationErrors ?? {}).length === 0,
 		addressSuggestions: context.addressSuggestions,
 		prefilled: context.prefilled,
 		hideEmail: context.hideEmail,
 		fieldsCountry: context.fieldsCountry,
-		submitError: context.submitError,
-		submitAttempted: context.submitAttempted
+		submitError: context.submitError
 	};
 	if (typedSnapshot.matches("submitting")) return { status: "submitting" };
 	if (typedSnapshot.matches("success")) return { status: "success" };
@@ -53,11 +52,17 @@ function createApi({ actor, trackElementClicked }) {
 		},
 		setField(name, value) {
 			actor.send({
-				type: "SET_FIELD",
+				type: "DATA_CHANGED",
 				name,
 				value
 			});
 		},
+		validateField(name) {
+			actor.send({
+				type: "VALIDATE_FIELD",
+				name
+			});
+		},
 		searchAddress(query) {
 			actor.send({
 				type: "SEARCH_ADDRESS",
@@ -101,4 +106,4 @@ function createEkycManager(options) {
 }
 
 //#endregion
-export { computeDisplayErrors as computeEkycDisplayErrors, createEkycManager, ekycMachine, toEkycConfig };
+export { createEkycManager, ekycMachine, toEkycConfig };

package/dist/{ekycStateMachine-oeO0Iekd.esm.js → ekycStateMachine-CXbpaJJn.esm.js}

@@ -1,8 +1,8 @@
 import { t as api } from "./api-CESGtpbH.esm.js";
-import { t as endpoints } from "./endpoints-CnN3SyDa.esm.js";
-import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-B70JrNqo.esm.js";
-import { t as validateCPF } from "./cpf-PPz2Njto.esm.js";
-import { a as POSTAL_CODE_FORMAT_ERROR_KEYS, c as getPostalCodeMaxLength, i as FIXED_DIGIT_POSTAL_CODE_LENGTH, l as validatePostalCode, n as fillFromSuggestion, o as formatPostalCode, r as DYNAMIC_REQUIRED_KEY, s as getPostalCodeErrorKey, t as debounceSearchActor, u as usStateOptions } from "./addressSearch-BpTbTWCa.esm.js";
+import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
+import { a as fromPromise, r as assign, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
+import { t as validateCPF } from "./cpf-BRzggV8G.esm.js";
+import { a as getPostalCodeMaxLength, c as STREET_LEVEL_REQUIRED_ERROR, d as usStateOptions, i as getPostalCodeErrorKey, l as fillFromSuggestion, n as FIXED_DIGIT_POSTAL_CODE_LENGTH, o as validatePostalCode, r as formatPostalCode, s as DYNAMIC_REQUIRED_KEY, t as debounceSearchActor, u as getStreetLevelErrorForSuggestion } from "./addressSearch-DvmWXKZg.esm.js";
 
 //#region src/modules/ekyc/ekycConsts.ts
 const COUNTRY_SELECTOR_DISABLED_SOURCES = ["UK_VOTER_REGISTER"];
@@ -29,7 +29,6 @@ const DRIVERS_LICENSE_FIELDS = [
 	"dlState",
 	"dlExpireAt"
 ];
-const REQUIRED_ERROR_KEYS = new Set(["verification.errors.required"]);
 const DOB_OPTIONAL_SOURCES = ["US_TELCO_1", "UK_VOTER_REGISTER"];
 const ADDRESS_OPTIONAL_SOURCES = ["US_TELCO_1", "UK_VOTER_REGISTER"];
 const LAST4SSN_OPTIONAL_SOURCES = ["US_TELCO_1"];
@@ -120,6 +119,8 @@ const MIDDLE_NAME_SOURCES = [
 	"CL_1",
 	"INDIA_PAN"
 ];
+const PHONE_RISK_ADDONS = ["phoneCheck", "advancedPhoneCheck"];
+const EMAIL_RISK_ADDONS = ["emailCheck"];
 
 //#endregion
 //#region src/modules/ekyc/ekycUtils.ts
@@ -132,15 +133,22 @@ function mapToEKYCvalue(field) {
 		default: return "user_input";
 	}
 }
+function hasRiskAddon(riskAddons, allowedAddons) {
+	return allowedAddons.some((addon) => riskAddons?.includes(addon));
+}
 /** Maps raw backend module config to a field-source mapping */
 function getEKYCFields(config) {
+	const hasPhoneRiskAddon = hasRiskAddon(config.riskAddons, PHONE_RISK_ADDONS);
+	const hasEmailRiskAddon = hasRiskAddon(config.riskAddons, EMAIL_RISK_ADDONS);
+	const shouldRenderEmail = config.checkEmail || hasEmailRiskAddon;
+	const shouldRenderPhone = config.checkPhone || hasPhoneRiskAddon;
 	return {
 		name: config.checkName ? mapToEKYCvalue(config.nameSource ?? "") : false,
 		SSN: config.checkSsn ? mapToEKYCvalue(config.ssnSource ?? "") : false,
 		address: config.checkAddress ? mapToEKYCvalue(config.addressSource ?? "") : false,
 		"date of birth": config.checkDob ? mapToEKYCvalue(config.dobSource ?? "") : false,
-		email: config.checkEmail ? mapToEKYCvalue(config.emailSource ?? "") : false,
-		phone: config.checkPhone ? mapToEKYCvalue(config.phoneSource ?? "") : false,
+		email: shouldRenderEmail ? mapToEKYCvalue(config.emailSource ?? "") : false,
+		phone: shouldRenderPhone ? mapToEKYCvalue(config.phoneSource ?? "") : false,
 		nationality: config.checkNationality ? mapToEKYCvalue(config.nationalitySource ?? "") : false,
 		dlNumber: config.checkDlNumber ? mapToEKYCvalue(config.dlNumberSource ?? "") : false,
 		dlState: config.checkDlState ? mapToEKYCvalue(config.dlStateSource ?? "") : false,
@@ -178,7 +186,7 @@ function getEKYCCountry(source) {
 * distinguish a raw backend config from an unconfigured / empty input.
 */
 function hasRawSignal(c) {
-	return Boolean(c.source || c.checkName || c.checkEmail || c.checkAddress || c.checkPhone || c.checkSsn || c.checkDob || c.checkNationality || c.checkDlNumber || c.checkDlState || c.checkDlExpireAt || c.checkLast4SSN || c.checkIdNum || c.checkIdNum1 || c.checkGender || c.checkPanNumber);
+	return Boolean(c.source || c.checkName || c.checkEmail || c.checkAddress || c.checkPhone || c.checkSsn || c.checkDob || c.checkNationality || c.checkDlNumber || c.checkDlState || c.checkDlExpireAt || c.checkLast4SSN || c.checkIdNum || c.checkIdNum1 || c.checkGender || c.checkPanNumber || c.riskAddons?.length);
 }
 /**
 * Normalizes any supported eKYC config input into a manager-ready `EkycConfig`.
@@ -10047,21 +10055,127 @@ function validatePhone(phone, country) {
 function formatPhoneE164(phone, country) {
 	return phoneValidator.formatE164(phone, country) ?? phone;
 }
+const SSN_FORMAT_REGEX = /^\d{3}-\d{2}-\d{4}$/;
+const EMAIL_FORMAT_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const buildPostalCodeParams = (country) => {
+	const fixedLen = FIXED_DIGIT_POSTAL_CODE_LENGTH[country];
+	if (fixedLen !== void 0) return { length: fixedLen };
+	let maxLen = getPostalCodeMaxLength(country);
+	if (country === "US" || country === "BR") maxLen = maxLen - 1;
+	return { maxLength: maxLen };
+};
+const createValidators = () => ({
+	required: (value, _rule, field) => {
+		if (value.trim().length > 0) return void 0;
+		const fieldName = field.displayLabel ?? field.label;
+		return fieldName ? {
+			key: DYNAMIC_REQUIRED_KEY,
+			params: { fieldName }
+		} : { key: DYNAMIC_REQUIRED_KEY };
+	},
+	streetLevelRequired: (value) => {
+		if (value.trim().length > 0) return void 0;
+		return STREET_LEVEL_REQUIRED_ERROR;
+	},
+	cpf: (value) => {
+		if (value.trim().length === 0) return void 0;
+		return validateCPF(value) ? void 0 : { key: "verification.errors.invalidTaxId" };
+	},
+	ssnFormat: (value) => {
+		if (value.trim().length === 0) return void 0;
+		return SSN_FORMAT_REGEX.test(value) ? void 0 : { key: "verification.errors.ssnFormat" };
+	},
+	noPoBox: (value) => {
+		if (value.trim().length === 0) return void 0;
+		return isPoBox(value) ? { key: "verification.errors.poBox" } : void 0;
+	},
+	postalCodeFormat: (value, rule) => {
+		if (rule.type !== "postalCodeFormat") return void 0;
+		if (value.trim().length === 0) return void 0;
+		if (validatePostalCode(value, rule.country)) return void 0;
+		return {
+			key: getPostalCodeErrorKey(rule.country),
+			params: buildPostalCodeParams(rule.country)
+		};
+	},
+	phoneFormat: (value, rule) => {
+		if (rule.type !== "phoneFormat") return void 0;
+		const trimmed = value.trim();
+		if (rule.optional && trimmed.length === 0) return void 0;
+		return validatePhone(trimmed, rule.country) ? void 0 : { key: "verification.errors.phoneInvalid" };
+	},
+	emailFormat: (value) => {
+		if (value.trim().length === 0) return void 0;
+		return EMAIL_FORMAT_REGEX.test(value) ? void 0 : { key: "verification.errors.emailInvalid" };
+	},
+	exactLength: (value, rule) => {
+		if (rule.type !== "exactLength") return void 0;
+		if (value.trim().length === 0) return void 0;
+		return value.length === rule.length ? void 0 : { key: "verification.errors.exactly10Characters" };
+	}
+});
+const normalizeFieldValue = (value) => typeof value === "string" ? value : String(value ?? "");
+const evaluateRules = (value, rules, field, validators) => {
+	if (!rules) return void 0;
+	for (const rule of rules) {
+		const error = validators[rule.type](value, rule, field);
+		if (error) return error;
+	}
+};
+function validateEkycForm(values, fields) {
+	const validators = createValidators();
+	return fields.reduce((errors, field) => {
+		const error = evaluateRules(normalizeFieldValue(values[field.name]), field.validation, field, validators);
+		if (error) errors[field.name] = error;
+		return errors;
+	}, {});
+}
+function validateEkycField(values, fieldName, fields) {
+	const field = fields.find((f) => f.name === fieldName);
+	if (!field) return void 0;
+	const validators = createValidators();
+	return evaluateRules(normalizeFieldValue(values[field.name]), field.validation, field, validators);
+}
 
 //#endregion
 //#region src/modules/ekyc/ekycActions.ts
+function buildValidationRules(field, country, configSource) {
+	const rules = [];
+	if (field.required) rules.push({ type: "required" });
+	if (field.name === "taxId" && country === "BR") rules.push({ type: "cpf" });
+	if (field.name === "ssn" && (country === "US" || country === "CA")) rules.push({ type: "ssnFormat" });
+	if (field.name === "street") rules.push({ type: "noPoBox" });
+	if (field.name === "postalCode") rules.push({
+		type: "postalCodeFormat",
+		country
+	});
+	if (field.name === "phone") rules.push({
+		type: "phoneFormat",
+		country,
+		optional: isFieldOptional("phone", configSource)
+	});
+	if (field.name === "email") rules.push({ type: "emailFormat" });
+	if (field.name === "panNumber") rules.push({
+		type: "exactLength",
+		length: 10
+	});
+	return rules;
+}
 function buildFieldDefs(fields, configSource, country, enablePhoneRisk = false) {
 	const defs = [];
 	const add = (name, type, label, source, opts) => {
 		if (source === false) return;
-		defs.push({
+		const def = {
 			name,
 			type,
 			label,
 			source,
 			required: !isFieldOptional(name, configSource),
 			...opts
-		});
+		};
+		const validation = buildValidationRules(def, country, configSource);
+		if (validation.length > 0) def.validation = validation;
+		defs.push(def);
 	};
 	const nameSource = fields.name || (NAME_SOURCES.includes(configSource) ? "user_input" : false);
 	if (nameSource) {
@@ -10163,68 +10277,6 @@ function buildFieldDefs(fields, configSource, country, enablePhoneRisk = false)
 	}
 	return defs;
 }
-function validateField(name, value, required, country, configSource) {
-	const val = (value ?? "").trim();
-	if (required && !val) return "verification.errors.required";
-	if (!val) return void 0;
-	if (name === "taxId" && country === "BR") return validateCPF(val) ? void 0 : "verification.errors.invalidTaxId";
-	if (name === "ssn" && (country === "US" || country === "CA")) return /^\d{3}-\d{2}-\d{4}$/.test(val) ? void 0 : "verification.errors.ssnFormat";
-	if (name === "street" && isPoBox(val)) return "verification.errors.poBox";
-	if (name === "postalCode") return validatePostalCode(val, country) ? void 0 : getPostalCodeErrorKey(country);
-	if (name === "phone") {
-		if (!isFieldOptional("phone", configSource) || val) return validatePhone(val, country) ? void 0 : "verification.errors.phoneInvalid";
-	}
-	if (name === "email" && val) return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(val) ? void 0 : "verification.errors.emailInvalid";
-	if (name === "panNumber" && val) return val.length === 10 ? void 0 : "verification.errors.exactly10Characters";
-}
-function computeValidation(fields, values, country, configSource) {
-	const errors = {};
-	for (const field of fields) {
-		const err = validateField(field.name, values[field.name], field.required, country, configSource);
-		if (err) errors[field.name] = err;
-	}
-	return {
-		errors,
-		isValid: Object.keys(errors).length === 0
-	};
-}
-function computeDisplayErrors(errors, touched, submitAttempted, country, fields) {
-	const display = {};
-	const errorParams = {};
-	const fieldLabelMap = new Map(fields?.map((f) => [f.name, f.displayLabel ?? f.label]));
-	for (const [field, err] of Object.entries(errors)) {
-		const isRequiredErr = REQUIRED_ERROR_KEYS.has(err);
-		if (isRequiredErr && (submitAttempted || touched[field])) {
-			const label = fieldLabelMap.get(field);
-			if (label) {
-				display[field] = DYNAMIC_REQUIRED_KEY;
-				errorParams[field] = {
-					...errorParams[field] ?? {},
-					fieldName: label
-				};
-			} else display[field] = DYNAMIC_REQUIRED_KEY;
-		} else if (!isRequiredErr && touched[field]) display[field] = err;
-		if (display[field] && field === "postalCode" && POSTAL_CODE_FORMAT_ERROR_KEYS.has(err)) {
-			const fixedLen = FIXED_DIGIT_POSTAL_CODE_LENGTH[country];
-			if (fixedLen !== void 0) errorParams[field] = {
-				...errorParams[field] ?? {},
-				length: fixedLen
-			};
-			else {
-				let maxLen = getPostalCodeMaxLength(country);
-				if (country === "US" || country === "BR") maxLen = maxLen - 1;
-				errorParams[field] = {
-					...errorParams[field] ?? {},
-					maxLength: maxLen
-				};
-			}
-		}
-	}
-	return {
-		displayErrors: display,
-		errorParams
-	};
-}
 function applyPrefill(fields, ocrData, otpStatus, _country) {
 	const values = {};
 	const prefilled = {};
@@ -10380,7 +10432,7 @@ async function submitEkyc(data, signal) {
 
 //#endregion
 //#region src/modules/ekyc/ekycGuards.ts
-const isValidGuard = ({ context }) => context.isValid;
+const hasNoValidationErrorsGuard = ({ context }) => Object.keys(context.validationErrors ?? {}).length === 0;
 const hasFlowIdGuard = ({ context }) => !!context.config.flowId;
 const hasVerificationFieldsGuard = ({ context }) => !!context.config.verificationFields;
 const COUNTRY_NOT_SUPPORTED_MSG = "Request unsuccessful. Country not supported for EKYC.";
@@ -10403,6 +10455,19 @@ const submitEkycActor = fromPromise(async ({ input, signal }) => submitEkyc(inpu
 
 //#endregion
 //#region src/modules/ekyc/ekycStateMachine.ts
+const ADDRESS_AUTOCOMPLETE_KEYS = [
+	"street",
+	"city",
+	"state",
+	"postalCode",
+	"houseNo"
+];
+const omitKeys = (errors, keys) => {
+	if (!errors) return void 0;
+	const next = { ...errors };
+	for (const key of keys) delete next[key];
+	return Object.keys(next).length > 0 ? next : void 0;
+};
 const ekycMachine = setup({
 	types: {
 		context: {},
@@ -10432,45 +10497,62 @@ const ekycMachine = setup({
 		applyPrefillData: assign(({ context, event }) => {
 			const { ocrData, otpStatus } = event.output;
 			const { values, prefilled, hideEmail, readonlyFields } = applyPrefill(context.verificationFields, ocrData, otpStatus, context.fieldsCountry);
-			const updatedFields = context.fields.map((f) => ({
-				...f,
-				readonly: readonlyFields.includes(f.name) ? true : f.readonly
-			}));
-			const { errors, isValid } = computeValidation(updatedFields, values, context.fieldsCountry, context.configSource);
 			return {
 				values,
 				prefilled,
 				hideEmail,
-				fields: updatedFields,
-				errors,
-				isValid
+				fields: context.fields.map((f) => ({
+					...f,
+					readonly: readonlyFields.includes(f.name) ? true : f.readonly
+				}))
 			};
 		}),
 		updateField: assign(({ context, event }) => {
-			const { name, value } = event;
-			const processedValue = processFieldValue(name, value, context.fieldsCountry);
-			const newValues = {
-				...context.values,
-				[name]: processedValue
-			};
-			const { errors, isValid } = computeValidation(context.fields, newValues, context.fieldsCountry, context.configSource);
+			if (event.type !== "DATA_CHANGED") return {};
+			const processedValue = processFieldValue(event.name, event.value, context.fieldsCountry);
 			return {
-				values: newValues,
-				errors,
-				isValid,
+				values: {
+					...context.values,
+					[event.name]: processedValue
+				},
 				submitError: ""
 			};
 		}),
+		clearFieldValidationError: assign(({ context, event }) => {
+			if (event.type !== "DATA_CHANGED") return {};
+			const errs = context.validationErrors;
+			if (!errs?.[event.name]) return {};
+			const next = { ...errs };
+			delete next[event.name];
+			return { validationErrors: Object.keys(next).length > 0 ? next : void 0 };
+		}),
+		validateFormField: assign(({ context, event }) => {
+			if (event.type !== "VALIDATE_FIELD") return {};
+			const message = validateEkycField(context.values, event.name, context.fields);
+			const next = { ...context.validationErrors ?? {} };
+			if (message) next[event.name] = message;
+			else delete next[event.name];
+			return { validationErrors: Object.keys(next).length > 0 ? next : void 0 };
+		}),
+		computeValidationResult: assign(({ context }) => {
+			const errors = validateEkycForm(context.values, context.fields);
+			return { validationErrors: Object.keys(errors).length > 0 ? errors : void 0 };
+		}),
 		fillAddressFields: assign(({ context, event }) => {
 			const { suggestion } = event;
 			const activeFields = new Set(context.fields.map((f) => f.name));
 			const { values: newValues } = fillFromSuggestion(context.values, {}, suggestion, activeFields);
-			const { errors, isValid } = computeValidation(context.fields, newValues, context.fieldsCountry, context.configSource);
+			const clearedErrors = omitKeys(context.validationErrors, ADDRESS_AUTOCOMPLETE_KEYS);
+			const streetError = getStreetLevelErrorForSuggestion(suggestion, activeFields);
+			const validationErrors = {
+				...clearedErrors ?? {},
+				...streetError !== void 0 ? { street: streetError } : {}
+			};
 			return {
 				values: newValues,
 				addressSuggestions: [],
-				errors,
-				isValid,
+				_searchQuery: "",
+				validationErrors: Object.keys(validationErrors).length > 0 ? validationErrors : void 0,
 				submitError: ""
 			};
 		}),
@@ -10478,11 +10560,10 @@ const ekycMachine = setup({
 		setErrorMessage: assign(({ event }) => ({ errorMessage: String(event.error ?? "verification.error") })),
 		clearErrorMessage: assign({ errorMessage: () => "" }),
 		setSubmitError: assign(() => ({ submitError: "verification.errors.countryNotSupported" })),
-		clearSubmitError: assign({ submitError: () => "" }),
-		markSubmitAttempted: assign({ submitAttempted: () => true })
+		clearSubmitError: assign({ submitError: () => "" })
 	},
 	guards: {
-		isValid: isValidGuard,
+		hasNoValidationErrors: hasNoValidationErrorsGuard,
 		hasFlowId: hasFlowIdGuard,
 		hasVerificationFields: hasVerificationFieldsGuard,
 		isCountryNotSupported: isCountryNotSupportedGuard
@@ -10500,14 +10581,11 @@ const ekycMachine = setup({
 			fieldsCountry: config.fieldsCountry ?? "",
 			fields: [],
 			values: {},
-			errors: {},
-			isValid: false,
 			addressSuggestions: [],
 			prefilled: {},
 			hideEmail: false,
 			errorMessage: "",
 			submitError: "",
-			submitAttempted: false,
 			_searchQuery: ""
 		};
 	},
@@ -10557,23 +10635,37 @@ const ekycMachine = setup({
 			onError: { target: "form" }
 		} },
 		form: {
-			initial: "idle",
+			initial: "inputting",
 			states: {
-				idle: {},
+				inputting: { on: {
+					DATA_CHANGED: { actions: ["updateField", "clearFieldValidationError"] },
+					VALIDATE_FIELD: { actions: "validateFormField" },
+					SUBMIT: { target: "validatingSubmit" }
+				} },
 				searching: {
 					invoke: {
 						id: "debounceSearch",
 						src: "debounceSearch",
 						input: ({ context }) => ({ query: context._searchQuery })
 					},
-					on: { RESULTS: {
-						target: "idle",
-						actions: "setAddressSuggestions"
-					} }
+					on: {
+						DATA_CHANGED: { actions: ["updateField", "clearFieldValidationError"] },
+						VALIDATE_FIELD: { actions: "validateFormField" },
+						RESULTS: {
+							target: "inputting",
+							actions: "setAddressSuggestions"
+						}
+					}
+				},
+				validatingSubmit: {
+					entry: "computeValidationResult",
+					always: [{
+						guard: "hasNoValidationErrors",
+						target: "#ekyc.submitting"
+					}, { target: "inputting" }]
 				}
 			},
 			on: {
-				SET_FIELD: { actions: "updateField" },
 				SEARCH_ADDRESS: {
 					target: ".searching",
 					actions: assign(({ event }) => ({
@@ -10582,13 +10674,9 @@ const ekycMachine = setup({
 					}))
 				},
 				SELECT_ADDRESS: {
-					target: ".idle",
+					target: ".inputting",
 					actions: "fillAddressFields"
 				},
-				SUBMIT: [{
-					target: "submitting",
-					guard: "isValid"
-				}, { actions: "markSubmitAttempted" }],
 				SKIP: { target: "#ekyc.finished" },
 				CLOSE: { target: "#ekyc.closed" }
 			}
@@ -10623,4 +10711,4 @@ const ekycMachine = setup({
 });
 
 //#endregion
-export { computeDisplayErrors as n, toEkycConfig as r, ekycMachine as t };
+export { toEkycConfig as n, ekycMachine as t };

package/dist/electronic-signature.d.ts

@@ -1,4 +1,4 @@
-import "./Manager-C8PrhBOx.js";
-import "./Actor-CI32dTbG.js";
-import { a as AE_CONSENT_KEYS, c as ConsentKey, d as ElectronicSignatureVariant, f as QE_CONSENT_KEYS, g as getDefaultConsentChecks, h as getConsentKeys, i as electronicSignatureMachine, l as ElectronicSignatureConfig, m as areAllConsented, n as ElectronicSignatureState, o as AeConsentKey, p as QeConsentKey, r as createElectronicSignatureManager, s as ConsentChecks, t as ElectronicSignatureManager, u as ElectronicSignatureDocument } from "./index-DZoqeAo9.js";
+import "./Manager-BHn8wH8K.js";
+import "./Actor-Y0_Fj-KL.js";
+import { a as AE_CONSENT_KEYS, c as ConsentKey, d as ElectronicSignatureVariant, f as QE_CONSENT_KEYS, g as getDefaultConsentChecks, h as getConsentKeys, i as electronicSignatureMachine, l as ElectronicSignatureConfig, m as areAllConsented, n as ElectronicSignatureState, o as AeConsentKey, p as QeConsentKey, r as createElectronicSignatureManager, s as ConsentChecks, t as ElectronicSignatureManager, u as ElectronicSignatureDocument } from "./index-B9NysVDB.js";
 export { AE_CONSENT_KEYS, AeConsentKey, ConsentChecks, ConsentKey, ElectronicSignatureConfig, ElectronicSignatureDocument, ElectronicSignatureManager, ElectronicSignatureState, ElectronicSignatureVariant, QE_CONSENT_KEYS, QeConsentKey, areAllConsented, createElectronicSignatureManager, electronicSignatureMachine, getConsentKeys, getDefaultConsentChecks };