@incodetech/core 2.0.1 → 2.1.0-rc.0

package/dist/dynamic-forms.esm.js

@@ -1,10 +1,75 @@
 import { t as api } from "./api-CESGtpbH.esm.js";
-import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-D6-e4vok.esm.js";
-import { t as endpoints } from "./endpoints-CnN3SyDa.esm.js";
-import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-B70JrNqo.esm.js";
-import { t as validateCPF } from "./cpf-PPz2Njto.esm.js";
-import { t as isoDateToMs } from "./dateUtils-UoN5xswP.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
+import { t as endpoints } from "./endpoints-BeTK0Mlt.esm.js";
+import { a as fromPromise, c as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-C9wncMQa.esm.js";
+import { t as isoDateToMs } from "./dateUtils-AksLQmgV.esm.js";
 
+//#region src/modules/dynamic-forms/dynamicFormsFields.ts
+function getEffectiveType(question) {
+	return question.inputType ?? question.overrides ?? "TEXT";
+}
+const FORMAT_ERROR_KEY_BY_TYPE = {
+	PHONE: "phone.invalidPhone",
+	EMAIL: "verification.errors.emailInvalid",
+	CPF: "dynamicForms.invalidCpf"
+};
+function buildQuestionValidation(question) {
+	const effectiveType = getEffectiveType(question);
+	const rules = [];
+	if (!question.isOptional) rules.push({ type: "required" });
+	const formatErrorKey = FORMAT_ERROR_KEY_BY_TYPE[effectiveType];
+	if (formatErrorKey) rules.push({
+		type: "formatViaAnswerValidity",
+		errorKey: formatErrorKey
+	});
+	return rules;
+}
+function buildScreenFields(formScreen) {
+	return formScreen.questions.map((q) => ({
+		questionId: q.questionId,
+		inputType: getEffectiveType(q),
+		isOptional: q.isOptional ?? false,
+		validation: buildQuestionValidation(q)
+	}));
+}
+
+//#endregion
+//#region src/modules/dynamic-forms/dynamicFormsValidators.ts
+const VALIDATORS = {
+	required: ({ value }) => value.trim().length === 0 ? "dynamicForms.fieldRequired" : void 0,
+	formatViaAnswerValidity: ({ questionId, answerValidity }, rule) => answerValidity[questionId] === false ? rule.errorKey : void 0
+};
+const normalizeValue = (value) => typeof value === "string" ? value : String(value ?? "");
+function evaluateRules(input, rules) {
+	for (const rule of rules) {
+		const error = rule.type === "required" ? VALIDATORS.required(input) : VALIDATORS.formatViaAnswerValidity(input, rule);
+		if (error) return error;
+	}
+}
+/** Runs full-screen validation. Returns first failing key per field; empty = pass. */
+function validateScreenForm(answers, fields, answerValidity) {
+	return fields.reduce((errors, field) => {
+		const error = evaluateRules({
+			value: normalizeValue(answers[field.questionId]),
+			questionId: field.questionId,
+			answerValidity
+		}, field.validation);
+		if (error) errors[field.questionId] = error;
+		return errors;
+	}, {});
+}
+/** Runs single-field validation (blur). Unknown `questionId` → `undefined`. */
+function validateScreenField(answers, questionId, fields, answerValidity) {
+	const field = fields.find((f) => f.questionId === questionId);
+	if (!field) return void 0;
+	return evaluateRules({
+		value: normalizeValue(answers[questionId]),
+		questionId,
+		answerValidity
+	}, field.validation);
+}
+
+//#endregion
 //#region src/modules/dynamic-forms/dynamicFormsServices.ts
 async function fetchForms(flowId, signal) {
 	const url = `${endpoints.moduleConfig}?id=${encodeURIComponent(flowId)}&moduleKey=DYNAMIC_FORMS`;
@@ -23,22 +88,6 @@ async function submitFormAnswer(params, signal) {
 
 //#endregion
 //#region src/modules/dynamic-forms/dynamicFormsStateMachine.ts
-/**
-* Returns default answers for a screen, seeding 'NO' for every YESNO question.
-* An untouched checkbox must submit a value — this is a domain rule, not a UI concern.
-*/
-function seedDefaultAnswers(formScreen) {
-	if (!formScreen) return {};
-	const defaults = {};
-	for (const q of formScreen.questions) if ((q.inputType ?? q.overrides) === "YESNO") defaults[q.questionId] = "NO";
-	return defaults;
-}
-/**
-* Transforms a raw answer value before submission based on question type.
-* - CPF: strips formatting characters (dots and dash)
-* - DATE: converts ISO date string (YYYY-MM-DD) to Unix milliseconds string
-* - All others: pass through as-is
-*/
 function transformAnswerValue(inputType, value) {
 	switch (inputType) {
 		case "CPF": return value.replace(/[-.]/g, "");
@@ -46,6 +95,18 @@ function transformAnswerValue(inputType, value) {
 		default: return value;
 	}
 }
+const removeKey = (errors, key) => {
+	if (!errors?.[key]) return errors;
+	const next = { ...errors };
+	delete next[key];
+	return Object.keys(next).length > 0 ? next : void 0;
+};
+const upsertKey = (errors, key, message) => {
+	const next = { ...errors ?? {} };
+	if (message) next[key] = message;
+	else delete next[key];
+	return Object.keys(next).length > 0 ? next : void 0;
+};
 const dynamicFormsMachine = setup({
 	types: {
 		context: {},
@@ -73,38 +134,51 @@ const dynamicFormsMachine = setup({
 	actions: {
 		setScreens: assign(({ event }) => {
 			const screens = event.output.screens;
+			const firstScreen = screens[0];
 			return {
 				screens,
-				answers: seedDefaultAnswers(screens[0])
+				answers: {},
+				currentScreenFields: firstScreen ? buildScreenFields(firstScreen) : []
 			};
 		}),
 		setAnswer: assign(({ context, event }) => {
 			const e = event;
-			const question = context.screens[context.currentScreenIndex]?.questions.find((q) => q.questionId === e.questionId);
-			const effectiveType = question?.inputType ?? question?.overrides;
-			const newAnswerValidity = { ...context.answerValidity };
-			if (effectiveType === "CPF") newAnswerValidity[e.questionId] = validateCPF(e.value);
 			return {
 				answers: {
 					...context.answers,
 					[e.questionId]: e.value
 				},
-				answerValidity: newAnswerValidity
+				validationErrors: removeKey(context.validationErrors, e.questionId)
 			};
 		}),
 		setAnswerValidity: assign(({ context, event }) => {
 			const e = event;
-			return { answerValidity: {
-				...context.answerValidity,
-				[e.questionId]: e.isValid
-			} };
+			return {
+				answerValidity: {
+					...context.answerValidity,
+					[e.questionId]: e.isValid
+				},
+				validationErrors: removeKey(context.validationErrors, e.questionId)
+			};
+		}),
+		validateFormField: assign(({ context, event }) => {
+			if (event.type !== "VALIDATE_FIELD") return {};
+			const message = validateScreenField(context.answers, event.questionId, context.currentScreenFields, context.answerValidity);
+			return { validationErrors: upsertKey(context.validationErrors, event.questionId, message) };
+		}),
+		computeValidationResult: assign(({ context }) => {
+			const errors = validateScreenForm(context.answers, context.currentScreenFields, context.answerValidity);
+			return { validationErrors: Object.keys(errors).length > 0 ? errors : void 0 };
 		}),
 		advanceScreen: assign(({ context }) => {
 			const nextIndex = context.currentScreenIndex + 1;
+			const nextScreen = context.screens[nextIndex];
 			return {
 				currentScreenIndex: nextIndex,
-				answers: seedDefaultAnswers(context.screens[nextIndex]),
-				answerValidity: {}
+				answers: {},
+				answerValidity: {},
+				currentScreenFields: nextScreen ? buildScreenFields(nextScreen) : [],
+				validationErrors: void 0
 			};
 		}),
 		markCompleted: assign({ result: "completed" }),
@@ -113,19 +187,22 @@ const dynamicFormsMachine = setup({
 	guards: {
 		hasPreloadedScreens: ({ context }) => (context.config.screens?.length ?? 0) > 0,
 		hasFlowId: ({ context }) => !!context.config.flowId,
-		isLastScreen: ({ context }) => context.currentScreenIndex >= context.screens.length - 1
+		isLastScreen: ({ context }) => context.currentScreenIndex >= context.screens.length - 1,
+		isScreenValid: ({ context }) => Object.keys(context.validationErrors ?? {}).length === 0
 	}
 }).createMachine({
 	id: "dynamicForms",
 	initial: "idle",
 	context: ({ input }) => {
 		const screens = input.config.screens ?? [];
+		const firstScreen = screens[0];
 		return {
 			config: input.config,
 			screens,
 			currentScreenIndex: 0,
-			answers: seedDefaultAnswers(screens[0]),
+			answers: {},
 			answerValidity: {},
+			currentScreenFields: firstScreen ? buildScreenFields(firstScreen) : [],
 			result: null
 		};
 	},
@@ -154,11 +231,24 @@ const dynamicFormsMachine = setup({
 				actions: "markSkipped"
 			}
 		} },
-		inputting: { on: {
-			ANSWER_CHANGED: { actions: "setAnswer" },
-			ANSWER_VALIDITY_CHANGED: { actions: "setAnswerValidity" },
-			SUBMIT: { target: "submitting" }
-		} },
+		inputting: {
+			initial: "editing",
+			states: {
+				editing: { on: {
+					ANSWER_CHANGED: { actions: "setAnswer" },
+					ANSWER_VALIDITY_CHANGED: { actions: "setAnswerValidity" },
+					VALIDATE_FIELD: { actions: "validateFormField" },
+					SUBMIT: { target: "validatingSubmit" }
+				} },
+				validatingSubmit: {
+					entry: "computeValidationResult",
+					always: [{
+						guard: "isScreenValid",
+						target: "#dynamicForms.submitting"
+					}, { target: "editing" }]
+				}
+			}
+		},
 		submitting: { invoke: {
 			id: "submitScreenAnswers",
 			src: "submitScreenAnswers",
@@ -229,32 +319,24 @@ function createDynamicFormsActor(options) {
 * manager.stop();
 * ```
 */
-function isScreenComplete(answers, formScreen) {
-	return formScreen.questions.every((q) => {
-		if (q.isOptional) return true;
-		if ((q.inputType ?? q.overrides) === "YESNO") return true;
-		const value = answers[q.questionId];
-		return value !== void 0 && value !== "";
-	});
+function hasNoErrors(errors) {
+	return Object.keys(errors ?? {}).length === 0;
 }
 function mapState(snapshot) {
 	const typedSnapshot = snapshot;
 	const { context } = typedSnapshot;
 	if (typedSnapshot.matches("idle")) return { status: "idle" };
 	if (typedSnapshot.matches("loadingScreens")) return { status: "loadingScreens" };
-	if (typedSnapshot.matches("inputting")) {
-		const currentScreen = context.screens[context.currentScreenIndex];
-		const allFormatsValid = !Object.values(context.answerValidity).some((v) => v === false);
-		return {
-			status: "inputting",
-			currentScreen,
-			screenIndex: context.currentScreenIndex,
-			totalScreens: context.screens.length,
-			answers: context.answers,
-			answerValidity: context.answerValidity,
-			canSubmit: currentScreen ? isScreenComplete(context.answers, currentScreen) && allFormatsValid : false
-		};
-	}
+	if (typedSnapshot.matches("inputting")) return {
+		status: "inputting",
+		currentScreen: context.screens[context.currentScreenIndex],
+		screenIndex: context.currentScreenIndex,
+		totalScreens: context.screens.length,
+		answers: context.answers,
+		answerValidity: context.answerValidity,
+		validationErrors: context.validationErrors,
+		canSubmit: hasNoErrors(context.validationErrors)
+	};
 	if (typedSnapshot.matches("submitting")) {
 		const currentScreen = context.screens[context.currentScreenIndex];
 		return {
@@ -263,7 +345,8 @@ function mapState(snapshot) {
 			totalScreens: context.screens.length,
 			currentScreen,
 			answers: context.answers,
-			answerValidity: context.answerValidity
+			answerValidity: context.answerValidity,
+			validationErrors: context.validationErrors
 		};
 	}
 	if (typedSnapshot.matches("success")) return { status: "success" };
@@ -294,6 +377,12 @@ function createApi({ actor }) {
 				isValid
 			});
 		},
+		validateField(questionId) {
+			actor.send({
+				type: "VALIDATE_FIELD",
+				questionId
+			});
+		},
 		submit() {
 			actor.send({ type: "SUBMIT" });
 		},

package/dist/ekyb.d.ts

@@ -1,9 +1,9 @@
-import { t as Manager } from "./Manager-C8PrhBOx.js";
-import "./Actor-CI32dTbG.js";
-import "./camera-DBSxa6ML.js";
-import "./types-CFV9G_7j.js";
-import { i as FlowModuleConfig } from "./types-BP1m8VRw.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 "./camera-SRBpPq2X.js";
+import "./types-Bj9hdFjU.js";
+import { c as AddressSuggestion, l as FieldDef } from "./types-DvGZI7BF.js";
+import { i as FlowModuleConfig } from "./types-DOUhndhT.js";
 
 //#region src/modules/ekyb/types.d.ts
 type UboEntry = {
@@ -30,8 +30,24 @@ type EkybConfig = {
   checkTaxId?: boolean;
   checkUniqueBeneficialOwner?: boolean;
 };
+type EkybValidationRule = {
+  type: 'required';
+} | {
+  type: 'streetLevelRequired';
+} | {
+  type: 'cnpj';
+} | {
+  type: 'postalCodeFormat';
+  country: string;
+};
+type EkybValidationError = {
+  key: string;
+  params?: Record<string, string | number>;
+};
+type EkybValidationErrors = Partial<Record<string, EkybValidationError>>;
 type EkybFieldDef = FieldDef & {
   optionalForCountries?: string[];
+  validation?: EkybValidationRule[];
 };
 type EkybCountry = 'BR' | 'US' | 'GB' | 'ES' | 'IT' | 'FR' | 'DE' | 'IL' | 'MX' | 'CN' | 'NG' | 'CM' | 'KE';
 //#endregion
@@ -53,12 +69,16 @@ type EkybFormState = {
   availableCountries: readonly string[];
   fields: EkybFieldDef[];
   values: EkybFormValues;
-  errors: Record<string, string>;
+  validationErrors?: EkybValidationErrors;
+  /**
+   * True when no validation errors are currently displayed.
+   * Optimistic semantic: starts true on initial empty form.
+   * Derived as `Object.keys(validationErrors ?? {}).length === 0`.
+   */
   isValid: boolean;
   ubos: UboEntry[];
   canAddUbo: boolean;
   addressSuggestions: AddressSuggestion[];
-  submitAttempted: boolean;
 };
 type EkybSubmittingState = {
   status: 'submitting';
@@ -88,8 +108,10 @@ declare function createEkybManager(options: CreateEkybActorOptions): Manager<Eky
   load(): void;
   /** Sets the country and resets/revalidates fields */
   setCountry(country: string): void;
-  /** Sets a form field value and triggers revalidation */
+  /** Sets a form field value and clears its current validation error */
   setField(name: string, value: string): void;
+  /** Runs single-field validation (call on blur) */
+  validateField(name: string): void;
   /** Adds a new UBO entry (max 8) */
   addUbo(): void;
   /** Removes a UBO entry by index */
@@ -109,9 +131,6 @@ declare function createEkybManager(options: CreateEkybActorOptions): Manager<Eky
 };
 type EkybManager = ReturnType<typeof createEkybManager>;
 //#endregion
-//#region src/modules/ekyb/ekybActions.d.ts
-declare function computeDisplayErrors(errors: Record<string, string>, touched: Record<string, boolean>, submitAttempted: boolean, country: string, fields?: EkybFieldDef[]): DisplayErrorsResult;
-//#endregion
 //#region src/modules/ekyb/ekybServices.d.ts
 type EkybFlowConfig = FlowModuleConfig['EKYB'];
 //#endregion
@@ -145,4 +164,4 @@ declare const DEV_ONLY_COUNTRIES: readonly EkybCountry[];
 declare const ALL_COUNTRIES: readonly EkybCountry[];
 declare function isSupportedCountry(code: string): code is EkybCountry;
 //#endregion
-export { ALL_COUNTRIES, DEV_ONLY_COUNTRIES, type AddressSuggestion as EkybAddressSuggestion, type EkybConfig, type EkybCountry, type EkybFieldDef, type EkybFlowConfig, type EkybManager, type EkybState, SUPPORTED_COUNTRIES, type UboEntry, computeDisplayErrors as computeEkybDisplayErrors, createEkybManager, ekybMachine, isSupportedCountry, toEkybConfig };
+export { ALL_COUNTRIES, DEV_ONLY_COUNTRIES, type AddressSuggestion as EkybAddressSuggestion, type EkybConfig, type EkybCountry, type EkybFieldDef, type EkybFlowConfig, type EkybManager, type EkybState, type EkybValidationError, type EkybValidationErrors, SUPPORTED_COUNTRIES, type UboEntry, createEkybManager, ekybMachine, isSupportedCountry, toEkybConfig };

package/dist/ekyb.esm.js

@@ -1,14 +1,19 @@
 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 "./session-CrkWAs-q.esm.js";
-import "./IpifyProvider-D7jx52AL.esm.js";
-import "./browserSimulation-gxD8cSpM.esm.js";
-import { c as createManager, s as createActor } from "./xstate.esm-B70JrNqo.esm.js";
-import { a as DEV_ONLY_COUNTRIES, i as ALL_COUNTRIES, n as computeDisplayErrors, o as SUPPORTED_COUNTRIES, r as toEkybConfig, s as isSupportedCountry, t as ekybMachine } from "./ekybStateMachine-CyMx_kg-.esm.js";
-import "./addressSearch-BpTbTWCa.esm.js";
-import "./flowServices-PiNsxLfK.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-Dvvriq9l.esm.js";
+import "./endpoints-BeTK0Mlt.esm.js";
+import "./stats-BMNUG1AU.esm.js";
+import "./IpifyProvider-D4LWD15E.esm.js";
+import "./browserSimulation-B1dWiXp7.esm.js";
+import "./sessionInitializer-B8H5MsXM.esm.js";
+import "./platform-SKvEfCBh.esm.js";
+import "./getBrowser-C8DP7oTB.esm.js";
+import { c as createManager, s as createActor } from "./xstate.esm-C9wncMQa.esm.js";
+import "./apiError-B-j-gyDx.esm.js";
+import { a as SUPPORTED_COUNTRIES, i as DEV_ONLY_COUNTRIES, n as toEkybConfig, o as isSupportedCountry, r as ALL_COUNTRIES, t as ekybMachine } from "./ekybStateMachine-aYixw2sL.esm.js";
+import "./addressSearch-DvmWXKZg.esm.js";
+import "./session-DoVb-OcB.esm.js";
+import "./flowServices-BTuHLHVr.esm.js";
 
 //#region src/modules/ekyb/ekybActor.ts
 /**
@@ -31,12 +36,11 @@ function mapState(snapshot) {
 		availableCountries: context.availableCountries,
 		fields: context.fields,
 		values: context.values,
-		errors: context.errors,
-		isValid: context.isValid,
+		validationErrors: context.validationErrors,
+		isValid: Object.keys(context.validationErrors ?? {}).length === 0,
 		ubos: context.ubos,
 		canAddUbo: context.canAddUbo,
-		addressSuggestions: context.addressSuggestions,
-		submitAttempted: context.submitAttempted
+		addressSuggestions: context.addressSuggestions
 	};
 	if (typedSnapshot.matches("submitting")) return { status: "submitting" };
 	if (typedSnapshot.matches("success")) return { status: "success" };
@@ -61,11 +65,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
+			});
+		},
 		addUbo() {
 			trackElementClicked?.("addUbo");
 			actor.send({ type: "ADD_UBO" });
@@ -124,4 +134,4 @@ function createEkybManager(options) {
 }
 
 //#endregion
-export { ALL_COUNTRIES, DEV_ONLY_COUNTRIES, SUPPORTED_COUNTRIES, computeDisplayErrors as computeEkybDisplayErrors, createEkybManager, ekybMachine, isSupportedCountry, toEkybConfig };
+export { ALL_COUNTRIES, DEV_ONLY_COUNTRIES, SUPPORTED_COUNTRIES, createEkybManager, ekybMachine, isSupportedCountry, toEkybConfig };