@incodetech/core 0.0.0-dev-20260313-bc2dab4 → 0.0.0-dev-20260317-ce5d28b

package/dist/ekyb.esm.js

@@ -1,9 +1,10 @@
 import { d as addEvent, n as eventModuleNames, r as eventScreenNames } from "./events-3HzCcoEy.esm.js";
-import { A as createManager } from "./src-BmVrWkLJ.esm.js";
+import { A as createManager } from "./src-D0bFtylT.esm.js";
 import { a as createActor, i as fromPromise, n as assign, t as setup } from "./xstate.esm-CcoTezCZ.esm.js";
 import { t as api } from "./api-C2uzxrpN.esm.js";
 import { t as endpoints } from "./endpoints-IAlXA1zN.esm.js";
-import { t as usStateOptions } from "./usStates-vWM_ZgEH.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-B446UZn4.esm.js";
+import { t as getFlow } from "./flowServices-B5YbZJ7r.esm.js";
 
 //#region src/modules/ekyb/ekybConstants.ts
 const UBO_INPUT_LIMIT = 8;
@@ -189,6 +190,10 @@ function requiresAddressValidation(countryCode) {
 //#endregion
 //#region src/modules/ekyb/ekybActions.ts
 const REQUIRED_ERROR_KEYS = new Set(["ekyb.error.requiredField"]);
+const UBO_FIELD_LABELS = {
+	name: "ekyb.uboName",
+	surname: "ekyb.uboSurname"
+};
 function buildEkybFields(verificationFields, country, _hasUbos) {
 	let modules = verificationFields.filter((f) => f !== "ubos-user_input" && !f.startsWith("socure"));
 	if (country === "GB") modules = modules.filter((m) => m !== "state-user_input");
@@ -207,7 +212,11 @@ function buildEkybFields(verificationFields, country, _hasUbos) {
 			label: `ekyb.${fieldName}`,
 			required: !optional
 		};
-		if (fieldName === "taxId") def.required = true;
+		if (fieldName === "taxId") {
+			def.required = true;
+			if (country === "CN") def.label = "verification.labels.prcId";
+		}
+		if (fieldName === "postalCode") def.maxLength = getPostalCodeMaxLength(country);
 		if (fieldName === "state" && country === "US") {
 			def.type = "dropdown";
 			def.options = usStateOptions;
@@ -233,6 +242,9 @@ function validateEkybField(name, value, required, country) {
 		}
 		if (COUNTRIES_WITH_SPECIAL_TAX_ID_RULES.includes(country) && !val) return;
 	}
+	if (name === "postalCode" && val) {
+		if (!validatePostalCode(val, country)) return getPostalCodeErrorKey(country);
+	}
 }
 function computeEkybValidation(fields, values, country, ubos, hasUbos) {
 	const errors = {};
@@ -250,22 +262,57 @@ function computeEkybValidation(fields, values, country, ubos, hasUbos) {
 		}
 	}
 	if (hasUbos) for (let i = 0; i < ubos.length; i++) {
-		if (!ubos[i].name.trim()) errors[`ubo-${i}-name`] = "ekyb.error.requiredField";
-		if (!ubos[i].surname.trim()) errors[`ubo-${i}-surname`] = "ekyb.error.requiredField";
+		const isDefault = i === 0;
+		const hasAnyValue = ubos[i].name.trim() !== "" || ubos[i].surname.trim() !== "";
+		if (isDefault || hasAnyValue) {
+			if (!ubos[i].name.trim()) errors[`ubo-${i}-name`] = "ekyb.error.requiredField";
+			if (!ubos[i].surname.trim()) errors[`ubo-${i}-surname`] = "ekyb.error.requiredField";
+		}
 	}
 	return {
 		errors,
 		isValid: Object.keys(errors).length === 0
 	};
 }
-function computeDisplayErrors(errors, touched, submitAttempted) {
+function computeDisplayErrors(errors, touched, submitAttempted, country, fields) {
 	const display = {};
+	const errorParams = {};
+	const fieldLabelMap = new Map(fields?.map((f) => [f.name, f.label]));
 	for (const [field, err] of Object.entries(errors)) {
 		const isRequiredErr = REQUIRED_ERROR_KEYS.has(err);
-		if (isRequiredErr && submitAttempted) display[field] = err;
-		else if (!isRequiredErr && touched[field]) display[field] = err;
+		if (isRequiredErr && (submitAttempted || touched[field])) {
+			display[field] = DYNAMIC_REQUIRED_KEY;
+			const label = fieldLabelMap.get(field);
+			if (label) errorParams[field] = { fieldName: label };
+			else {
+				const uboMatch = field.match(/^ubo-\d+-(name|surname)$/);
+				if (uboMatch) errorParams[field] = { fieldName: UBO_FIELD_LABELS[uboMatch[1]] ?? field };
+			}
+		} 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 display;
+	return {
+		displayErrors: display,
+		errorParams
+	};
+}
+function processEkybFieldValue(name, value, country) {
+	if (name === "postalCode") return formatPostalCode(value, country);
+	return value;
 }
 function buildEkybSubmitPayload(ctx) {
 	const uboNames = ctx.ubos.filter((u) => u.name.trim() || u.surname.trim()).map((u) => `${u.name.trim()} ${u.surname.trim()}`.trim());
@@ -283,6 +330,7 @@ function buildEkybSubmitPayload(ctx) {
 
 //#endregion
 //#region src/modules/ekyb/ekybGuards.ts
+const hasFlowIdGuard = ({ context }) => !!context.config.flowId;
 const isValidGuard = ({ context }) => context.isValid;
 const canAddUboGuard = ({ context }) => context.canAddUbo;
 const isValidUboIndexGuard = ({ context, event }) => {
@@ -296,6 +344,12 @@ const isSupportedCountryGuard = ({ event }) => {
 
 //#endregion
 //#region src/modules/ekyb/ekybServices.ts
+/** Fetches the onboarding flow and extracts the EKYB module configuration */
+async function fetchEkybModuleConfig(signal) {
+	const ekybModule = (await getFlow(signal)).flowModules.find((m) => m.key === "EKYB");
+	if (!ekybModule) throw new Error("EKYB module not found in flow configuration");
+	return ekybModule.configuration;
+}
 /** Submits eKYB business verification */
 async function submitEkyb(data, signal) {
 	const res = await api.post(endpoints.ekybSubmit, data, { signal });
@@ -305,6 +359,7 @@ async function submitEkyb(data, signal) {
 
 //#endregion
 //#region src/modules/ekyb/ekybActors.ts
+const fetchEkybModuleConfigActor = fromPromise(async ({ signal }) => fetchEkybModuleConfig(signal));
 const submitEkybActor = fromPromise(async ({ input, signal }) => submitEkyb(input, signal));
 
 //#endregion
@@ -315,8 +370,51 @@ const ekybMachine = setup({
 		events: {},
 		input: {}
 	},
-	actors: { submitEkyb: submitEkybActor },
+	actors: {
+		fetchEkybModuleConfig: fetchEkybModuleConfigActor,
+		submitEkyb: submitEkybActor,
+		debounceSearch: debounceSearchActor
+	},
 	actions: {
+		applyFetchedConfig: assign(({ event }) => {
+			const fetched = event.output;
+			const config = {
+				checkBusinessName: fetched.checkBusinessName,
+				checkAddress: fetched.checkAddress,
+				checkTaxId: fetched.checkTaxId,
+				checkUniqueBeneficialOwner: fetched.checkUniqueBeneficialOwner
+			};
+			const country = "US";
+			const vFields = getDefaultVerificationFields(config);
+			const hasUbos = config.checkUniqueBeneficialOwner !== false && vFields.includes("ubos-user_input");
+			const fields = buildEkybFields(vFields, country, hasUbos);
+			const values = { country };
+			const ubos = hasUbos ? [{
+				id: "ubo-1",
+				name: "",
+				surname: ""
+			}] : [];
+			const { errors, isValid } = computeEkybValidation(fields, values, country, ubos, hasUbos);
+			return {
+				config,
+				country,
+				availableCountries: ALL_COUNTRIES,
+				fields,
+				values,
+				errors,
+				displayErrors: {},
+				errorParams: {},
+				isValid,
+				ubos,
+				canAddUbo: hasUbos,
+				hasUbos,
+				touched: {},
+				submitAttempted: false,
+				addressSuggestions: [],
+				_nextUboId: 2,
+				_searchQuery: ""
+			};
+		}),
 		setCountry: assign(({ context, event }) => {
 			const { country } = event;
 			const vFields = getDefaultVerificationFields(context.config);
@@ -340,6 +438,7 @@ const ekybMachine = setup({
 				state: ""
 			};
 			const { errors, isValid } = computeEkybValidation(fields, newValues, country, ubos, hasUbos);
+			const { displayErrors, errorParams } = computeDisplayErrors(errors, context.touched, context.submitAttempted, country, fields);
 			return {
 				country,
 				fields,
@@ -349,29 +448,32 @@ const ekybMachine = setup({
 				ubos,
 				canAddUbo: hasUbos && ubos.length < UBO_INPUT_LIMIT,
 				hasUbos,
-				displayErrors: {},
-				touched: {},
-				submitAttempted: false,
+				displayErrors,
+				errorParams,
+				submitAttempted: context.submitAttempted,
 				_nextUboId: nextId
 			};
 		}),
 		updateField: assign(({ context, event }) => {
 			const { name, value } = event;
+			const processed = processEkybFieldValue(name, value, context.country);
 			const newValues = {
 				...context.values,
-				[name]: value
+				[name]: processed
 			};
 			const newTouched = {
 				...context.touched,
 				[name]: true
 			};
 			const { errors, isValid } = computeEkybValidation(context.fields, newValues, context.country, context.ubos, context.hasUbos);
+			const { displayErrors, errorParams } = computeDisplayErrors(errors, newTouched, context.submitAttempted, context.country, context.fields);
 			return {
 				values: newValues,
 				errors,
 				isValid,
 				touched: newTouched,
-				displayErrors: computeDisplayErrors(errors, newTouched, context.submitAttempted)
+				displayErrors,
+				errorParams
 			};
 		}),
 		addUbo: assign(({ context }) => {
@@ -383,12 +485,14 @@ const ekybMachine = setup({
 			}];
 			const canAddUbo = ubos.length < UBO_INPUT_LIMIT;
 			const { errors, isValid } = computeEkybValidation(context.fields, context.values, context.country, ubos, context.hasUbos);
+			const { displayErrors, errorParams } = computeDisplayErrors(errors, context.touched, context.submitAttempted, context.country, context.fields);
 			return {
 				ubos,
 				canAddUbo,
 				errors,
 				isValid,
-				displayErrors: computeDisplayErrors(errors, context.touched, context.submitAttempted),
+				displayErrors,
+				errorParams,
 				_nextUboId: newId + 1
 			};
 		}),
@@ -409,12 +513,14 @@ const ekybMachine = setup({
 				touched[`ubo-${newIdx}-${match[2]}`] = val;
 			}
 			const { errors, isValid } = computeEkybValidation(context.fields, context.values, context.country, ubos, context.hasUbos);
+			const { displayErrors, errorParams } = computeDisplayErrors(errors, touched, context.submitAttempted, context.country, context.fields);
 			return {
 				ubos,
 				canAddUbo,
 				errors,
 				isValid,
-				displayErrors: computeDisplayErrors(errors, touched, context.submitAttempted),
+				displayErrors,
+				errorParams,
 				touched
 			};
 		}),
@@ -430,20 +536,42 @@ const ekybMachine = setup({
 				[uboKey]: true
 			};
 			const { errors, isValid } = computeEkybValidation(context.fields, context.values, context.country, ubos, context.hasUbos);
+			const { displayErrors, errorParams } = computeDisplayErrors(errors, newTouched, context.submitAttempted, context.country, context.fields);
 			return {
 				ubos,
 				errors,
 				isValid,
 				touched: newTouched,
-				displayErrors: computeDisplayErrors(errors, newTouched, context.submitAttempted)
+				displayErrors,
+				errorParams
 			};
 		}),
 		setErrorMessage: assign(({ event }) => ({ errorMessage: String(event.error ?? "verification.error") })),
 		clearErrorMessage: assign({ errorMessage: () => "" }),
-		markSubmitAttempted: assign(({ context }) => ({
-			submitAttempted: true,
-			displayErrors: computeDisplayErrors(context.errors, context.touched, true)
-		})),
+		markSubmitAttempted: assign(({ context }) => {
+			const { displayErrors, errorParams } = computeDisplayErrors(context.errors, context.touched, true, context.country, context.fields);
+			return {
+				submitAttempted: true,
+				displayErrors,
+				errorParams
+			};
+		}),
+		fillAddressFields: assign(({ context, event }) => {
+			const { suggestion } = event;
+			const { values: newValues, touched: newTouched } = fillFromSuggestion(context.values, context.touched, suggestion);
+			const { errors, isValid } = computeEkybValidation(context.fields, newValues, context.country, context.ubos, context.hasUbos);
+			const { displayErrors, errorParams } = computeDisplayErrors(errors, newTouched, context.submitAttempted, context.country, context.fields);
+			return {
+				values: newValues,
+				addressSuggestions: [],
+				errors,
+				isValid,
+				touched: newTouched,
+				displayErrors,
+				errorParams
+			};
+		}),
+		setAddressSuggestions: assign(({ event }) => ({ addressSuggestions: event.suggestions })),
 		trackModuleOpen: () => {
 			addEvent({
 				code: "open",
@@ -459,6 +587,7 @@ const ekybMachine = setup({
 		}
 	},
 	guards: {
+		hasFlowId: hasFlowIdGuard,
 		isValid: isValidGuard,
 		canAddUbo: canAddUboGuard,
 		isValidUboIndex: isValidUboIndexGuard,
@@ -466,7 +595,7 @@ const ekybMachine = setup({
 	}
 }).createMachine({
 	id: "ekyb",
-	initial: "form",
+	initial: "idle",
 	context: ({ input }) => {
 		const country = "US";
 		const vFields = getDefaultVerificationFields(input.config);
@@ -487,6 +616,7 @@ const ekybMachine = setup({
 			values,
 			errors,
 			displayErrors: {},
+			errorParams: {},
 			isValid,
 			ubos,
 			canAddUbo: hasUbos,
@@ -494,35 +624,79 @@ const ekybMachine = setup({
 			errorMessage: "",
 			touched: {},
 			submitAttempted: false,
-			_nextUboId: 2
+			addressSuggestions: [],
+			_nextUboId: 2,
+			_searchQuery: ""
 		};
 	},
-	entry: ["trackModuleOpen", "trackFormOpen"],
+	entry: "trackModuleOpen",
 	states: {
-		form: { on: {
-			SET_COUNTRY: {
-				guard: "isSupportedCountry",
-				actions: "setCountry"
-			},
-			SET_FIELD: { actions: "updateField" },
-			ADD_UBO: {
-				guard: "canAddUbo",
-				actions: "addUbo"
-			},
-			REMOVE_UBO: {
-				guard: "isValidUboIndex",
-				actions: "removeUbo"
-			},
-			SET_UBO_FIELD: {
-				guard: "isValidUboIndex",
-				actions: "setUboField"
+		idle: { on: { LOAD: [{
+			target: "loading",
+			guard: "hasFlowId"
+		}, { target: "form" }] } },
+		loading: { invoke: {
+			id: "fetchEkybModuleConfig",
+			src: "fetchEkybModuleConfig",
+			onDone: {
+				target: "form",
+				actions: "applyFetchedConfig"
 			},
-			SUBMIT: [{
-				target: "submitting",
-				guard: "isValid"
-			}, { actions: "markSubmitAttempted" }],
-			CLOSE: { target: "closed" }
+			onError: "form"
 		} },
+		form: {
+			entry: "trackFormOpen",
+			initial: "idle",
+			states: {
+				idle: {},
+				searching: {
+					invoke: {
+						id: "debounceSearch",
+						src: "debounceSearch",
+						input: ({ context }) => ({ query: context._searchQuery })
+					},
+					on: { RESULTS: {
+						target: "idle",
+						actions: "setAddressSuggestions"
+					} }
+				}
+			},
+			on: {
+				SET_COUNTRY: {
+					guard: "isSupportedCountry",
+					actions: "setCountry"
+				},
+				SET_FIELD: { actions: "updateField" },
+				SEARCH_ADDRESS: {
+					target: ".searching",
+					actions: assign(({ event }) => ({
+						_searchQuery: event.query,
+						addressSuggestions: []
+					}))
+				},
+				SELECT_ADDRESS: {
+					target: ".idle",
+					actions: "fillAddressFields"
+				},
+				ADD_UBO: {
+					guard: "canAddUbo",
+					actions: "addUbo"
+				},
+				REMOVE_UBO: {
+					guard: "isValidUboIndex",
+					actions: "removeUbo"
+				},
+				SET_UBO_FIELD: {
+					guard: "isValidUboIndex",
+					actions: "setUboField"
+				},
+				SUBMIT: [{
+					target: "submitting",
+					guard: "isValid"
+				}, { actions: "markSubmitAttempted" }],
+				CLOSE: { target: "closed" }
+			}
+		},
 		submitting: { invoke: {
 			id: "submitEkyb",
 			src: "submitEkyb",
@@ -561,17 +735,19 @@ function createEkybActor(options) {
 function mapState(snapshot) {
 	const typedSnapshot = snapshot;
 	const { context } = typedSnapshot;
+	if (typedSnapshot.matches("idle") || typedSnapshot.matches("loading")) return { status: "loading" };
 	if (typedSnapshot.matches("form")) return {
 		status: "form",
 		country: context.country,
 		availableCountries: context.availableCountries,
 		fields: context.fields,
 		values: context.values,
-		errors: context.errors,
 		displayErrors: context.displayErrors,
+		errorParams: context.errorParams,
 		isValid: context.isValid,
 		ubos: context.ubos,
-		canAddUbo: context.canAddUbo
+		canAddUbo: context.canAddUbo,
+		addressSuggestions: context.addressSuggestions
 	};
 	if (typedSnapshot.matches("submitting")) return { status: "submitting" };
 	if (typedSnapshot.matches("success")) return { status: "success" };
@@ -581,21 +757,13 @@ function mapState(snapshot) {
 	};
 	if (typedSnapshot.matches("finished")) return { status: "finished" };
 	if (typedSnapshot.matches("closed")) return { status: "closed" };
-	return {
-		status: "form",
-		country: context.country,
-		availableCountries: context.availableCountries,
-		fields: context.fields,
-		values: context.values,
-		errors: context.errors,
-		displayErrors: context.displayErrors,
-		isValid: context.isValid,
-		ubos: context.ubos,
-		canAddUbo: context.canAddUbo
-	};
+	return { status: "loading" };
 }
 function createApi({ actor }) {
 	return {
+		load() {
+			actor.send({ type: "LOAD" });
+		},
 		setCountry(country) {
 			actor.send({
 				type: "SET_COUNTRY",
@@ -626,6 +794,18 @@ function createApi({ actor }) {
 				value
 			});
 		},
+		searchAddress(query) {
+			actor.send({
+				type: "SEARCH_ADDRESS",
+				query
+			});
+		},
+		selectAddress(suggestion) {
+			actor.send({
+				type: "SELECT_ADDRESS",
+				suggestion
+			});
+		},
 		submit() {
 			actor.send({ type: "SUBMIT" });
 		},

package/dist/ekyc.d.ts

@@ -1,5 +1,5 @@
-import { t as Manager } from "./Manager-CXnC-tN_.js";
-import { t as FieldDef } from "./types-DTieLton.js";
+import { t as Manager } from "./Manager-DsNvecSe.js";
+import { n as FieldDef, t as AddressSuggestion } from "./types-CWa0DQcn.js";
 
 //#region src/modules/ekyc/types.d.ts
 type EkycFieldSource = 'user_input' | 'document_scan' | 'poa_document' | 'phone_module_input' | 'email_module_input' | false;
@@ -64,16 +64,6 @@ type EkycConfig = {
 type EkycFieldDef = FieldDef & {
   source: EkycFieldSource;
 };
-type AddressSuggestion = {
-  id: string | number;
-  label: string;
-  street?: string;
-  city?: string;
-  stateCode?: string;
-  postalCode?: string;
-  houseNumber?: string;
-  countryCode?: string;
-};
 //#endregion
 //#region src/modules/ekyc/ekycStateMachine.d.ts
 declare const ekycMachine: any;