@incodetech/core 0.0.0-dev-20260309-4e885f1 → 0.0.0-dev-20260309-dec7ce7

package/dist/document-upload.d.ts

@@ -62,7 +62,7 @@ declare const documentUploadMachine: xstate0.StateMachine<DocumentUploadContext,
     type: "stopStream";
     params: xstate0.NonReducibleUnknown;
   };
-}>, never, never, "error" | "initCamera" | "idle" | "capturing" | "closed" | "uploading" | "finished", string, DocumentUploadInput, xstate0.NonReducibleUnknown, xstate0.EventObject, xstate0.MetaObject, {
+}>, never, never, "initCamera" | "error" | "idle" | "capturing" | "closed" | "uploading" | "finished", string, DocumentUploadInput, xstate0.NonReducibleUnknown, xstate0.EventObject, xstate0.MetaObject, {
   readonly id: "documentUpload";
   readonly initial: "idle";
   readonly context: ({

package/dist/ekyc.d.ts

@@ -93,6 +93,7 @@ type EkycFormState = {
   values: EkycFormValues;
   errors: Record<string, string>;
   displayErrors: Record<string, string>;
+  errorParams: Record<string, Record<string, string | number>>;
   isValid: boolean;
   addressSuggestions: AddressSuggestion[];
   prefilled: Record<string, boolean>;

package/dist/ekyc.esm.js

@@ -9919,19 +9919,64 @@ const PO_BOX_REGEX = /POBox|P\.O\.Box|pobox|postofficebox|postbox|po\.box|p\.o\.
 function isPoBox(address) {
 	return PO_BOX_REGEX.test(address.replace(/\s/g, ""));
 }
-const POSTAL_CODE_MAX_LENGTH = {
-	US: 9,
-	CA: 6
-};
+const US_POSTAL_CODE_REGEX = /^(?:\d{5}|\d{9}|\d{5}-\d{4})$/;
+const BR_POSTAL_CODE_REGEX = /^(?:\d{5}|\d{8}|\d{5}-\d{3})$/;
+const CA_POSTAL_CODE_REGEX = /^[A-Za-z]\d[A-Za-z] \d[A-Za-z]\d$/;
+const ES_POSTAL_CODE_REGEX = /^\d{5}$/;
+const UK_POSTAL_CODE_REGEX = /^(?:[A-Z]{2}\d|[A-Z]{2}\d{2}|[A-Z]\d|[A-Z]\d{2}|[A-Z]\d[A-Z]|[A-Z]{2}\d[A-Z]) \d[A-Z]{2}$/;
 const DEFAULT_POSTAL_CODE_MAX = 8;
-/** Validates postal code by country (US accepts 5-digit and ZIP+4) */
+/**
+* Validates postal code by country:
+* - US: 5-digit, 9-digit, or ZIP+4
+* - BR: 5-digit, 8-digit, or 5+3 with dash
+* - CA: A1A 1A1
+* - ES: 5 digits
+* - GB/UK: A0 0AA, AA0 0AA, AA0A 0AA
+* - Others: 5 or 8 numeric digits
+*/
 function validatePostalCode(postalCode, country) {
 	if (!postalCode) return false;
-	if (country === "US") return /^\d{5}(-\d{4})?$/.test(postalCode);
-	if (country === "CA") return /^[A-Za-z]\d[A-Za-z]\s?\d[A-Za-z]\d$/.test(postalCode);
-	const stripped = postalCode.replace(/[\s-]/g, "");
-	const maxLen = POSTAL_CODE_MAX_LENGTH[country] ?? DEFAULT_POSTAL_CODE_MAX;
-	return stripped.length > 0 && stripped.length <= maxLen;
+	if (country === "US") return US_POSTAL_CODE_REGEX.test(postalCode);
+	if (country === "BR") return BR_POSTAL_CODE_REGEX.test(postalCode);
+	if (country === "CA") return CA_POSTAL_CODE_REGEX.test(postalCode);
+	if (country === "ES") return ES_POSTAL_CODE_REGEX.test(postalCode);
+	if (country === "GB" || country === "UK") return UK_POSTAL_CODE_REGEX.test(postalCode.toUpperCase());
+	const stripped = postalCode.replace(/\D/g, "");
+	const maxLen = DEFAULT_POSTAL_CODE_MAX;
+	return /^\d+$/.test(stripped) && [5, maxLen].includes(stripped.length);
+}
+/**
+* Normalizes ZIP input to digits and an optional dash after 5 digits.
+* Examples:
+* - 12345
+* - 123456789
+* - 12345-6789
+*/
+function formatPostalCode(value, country) {
+	if (country === "US" || country === "BR" || country === "ES") {
+		let maxLength = getPostalCodeMaxLength(country);
+		if (country !== "ES") maxLength = maxLength - 1;
+		const hasDash = value.includes("-");
+		const digits = value.replace(/\D/g, "").slice(0, maxLength);
+		if (country === "ES") return digits;
+		if (digits.length <= 5) {
+			if (hasDash && digits.length === 5) return `${digits}-`;
+			return digits;
+		}
+		if (hasDash) return `${digits.slice(0, 5)}-${digits.slice(5)}`;
+		return digits;
+	}
+	if (country === "CA") {
+		const normalized = value.replace(/[^A-Za-z0-9]/g, "").toUpperCase().slice(0, 6);
+		if (normalized.length <= 3) return normalized;
+		return `${normalized.slice(0, 3)} ${normalized.slice(3)}`;
+	}
+	if (country === "GB" || country === "UK") {
+		const normalized = value.replace(/[^A-Za-z0-9]/g, "").toUpperCase().slice(0, 7);
+		if (normalized.length <= 3) return normalized;
+		return `${normalized.slice(0, -3)} ${normalized.slice(-3)}`;
+	}
+	return value.replace(/\D/g, "").slice(0, DEFAULT_POSTAL_CODE_MAX);
 }
 /** Validates a phone number using libphonenumber-js country rules */
 function validatePhone(phone, country) {
@@ -9982,6 +10027,25 @@ const STATE_CODE_HINTS = {
 	AR: "B, C, K"
 };
 const REQUIRED_ERROR_KEYS = new Set(["verification.errors.required"]);
+const POSTAL_CODE_MAX_LENGTH_BY_COUNTRY = {
+	US: 10,
+	BR: 9,
+	CA: 7,
+	ES: 5,
+	GB: 8,
+	UK: 8
+};
+const DEFAULT_POSTAL_CODE_MAX_LENGTH = 8;
+function getPostalCodeMaxLength(country) {
+	return POSTAL_CODE_MAX_LENGTH_BY_COUNTRY[country] ?? DEFAULT_POSTAL_CODE_MAX_LENGTH;
+}
+function getPostalCodeErrorKey(country) {
+	if (country === "CA") return "verification.errors.CAPostalCodeInvalidFormat";
+	if (country === "ES") return "verification.errors.ESPostalCodeInvalidFormat";
+	if (country === "GB" || country === "UK") return "verification.errors.UKPostalCodeInvalidFormat";
+	if (country === "US") return "verification.errors.zipCodeInvalidFormat";
+	return "verification.errors.postalCodeInvalidFormat";
+}
 function buildFieldDefs(fields, configSource, country, enablePhoneRisk = false) {
 	const defs = [];
 	const add = (name, type, label, source, opts) => {
@@ -10068,7 +10132,10 @@ function buildFieldDefs(fields, configSource, country, enablePhoneRisk = false)
 				placeholderParams: { states: STATE_CODE_HINTS[country] ?? "" }
 			}
 		});
-		add("postalCode", "text", country === "US" ? "verification.labels.zipCode" : "verification.labels.postalCode", fields.address, { section: "address" });
+		add("postalCode", "text", country === "US" ? "verification.labels.zipCode" : "verification.labels.postalCode", fields.address, {
+			section: "address",
+			maxLength: getPostalCodeMaxLength(country)
+		});
 	}
 	if (fields.dlNumber) add("dlNumber", "text", "verification.labels.dlNumber", fields.dlNumber, { section: "driverLicense" });
 	if (fields.dlState) add("dlState", "dropdown", "verification.labels.dlState", fields.dlState, {
@@ -10086,7 +10153,7 @@ function validateField(name, value, required, country, configSource) {
 	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.invalidSsn";
 	if (name === "street" && isPoBox(val)) return "verification.errors.poBox";
-	if (name === "postalCode") return validatePostalCode(val, country) ? void 0 : "verification.errors.invalidPostalCode";
+	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.invalidPhone";
 	}
@@ -10103,14 +10170,30 @@ function computeValidation(fields, values, country, configSource) {
 		isValid: Object.keys(errors).length === 0
 	};
 }
-function computeDisplayErrors(errors, touched, submitAttempted) {
+const POSTAL_CODE_FORMAT_ERROR_KEYS = new Set([
+	"verification.errors.zipCodeInvalidFormat",
+	"verification.errors.postalCodeInvalidFormat",
+	"verification.errors.CAPostalCodeInvalidFormat",
+	"verification.errors.ESPostalCodeInvalidFormat",
+	"verification.errors.UKPostalCodeInvalidFormat"
+]);
+function computeDisplayErrors(errors, touched, submitAttempted, country) {
 	const display = {};
+	const errorParams = {};
 	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 (display[field] && field === "postalCode" && POSTAL_CODE_FORMAT_ERROR_KEYS.has(err)) {
+			let length = getPostalCodeMaxLength(country);
+			if (country === "US" || country === "BR") length = length - 1;
+			errorParams[field] = { maxLength: length };
+		}
 	}
-	return display;
+	return {
+		displayErrors: display,
+		errorParams
+	};
 }
 function applyPrefill(fields, ocrData, otpStatus, _country) {
 	const values = {};
@@ -10214,6 +10297,7 @@ function buildSubmitPayload(ctx) {
 function processFieldValue(name, value, fieldsCountry) {
 	if ((name === "firstName" || name === "surName" || name === "middleName" || name === "maternalSurname") && value) return cleanName(value);
 	if (name === "ssn" && (fieldsCountry === "US" || fieldsCountry === "CA")) return formatSSN(value);
+	if (name === "postalCode") return formatPostalCode(value, fieldsCountry);
 	return value;
 }
 function fillFromSuggestion(values, touched, suggestion) {
@@ -10369,7 +10453,8 @@ const ekycMachine = setup({
 				fields: updatedFields,
 				errors,
 				isValid,
-				displayErrors: {}
+				displayErrors: {},
+				errorParams: {}
 			};
 		}),
 		updateField: assign(({ context, event }) => {
@@ -10384,34 +10469,42 @@ const ekycMachine = setup({
 				[name]: true
 			};
 			const { errors, isValid } = computeValidation(context.fields, newValues, context.fieldsCountry, context.configSource);
+			const { displayErrors, errorParams } = computeDisplayErrors(errors, newTouched, context.submitAttempted, context.fieldsCountry);
 			return {
 				values: newValues,
 				errors,
 				isValid,
 				touched: newTouched,
-				displayErrors: computeDisplayErrors(errors, newTouched, context.submitAttempted)
+				displayErrors,
+				errorParams
 			};
 		}),
 		fillAddressFields: assign(({ context, event }) => {
 			const { suggestion } = event;
 			const { values: newValues, touched: newTouched } = fillFromSuggestion(context.values, context.touched, suggestion);
 			const { errors, isValid } = computeValidation(context.fields, newValues, context.fieldsCountry, context.configSource);
+			const { displayErrors, errorParams } = computeDisplayErrors(errors, newTouched, context.submitAttempted, context.fieldsCountry);
 			return {
 				values: newValues,
 				addressSuggestions: [],
 				errors,
 				isValid,
 				touched: newTouched,
-				displayErrors: computeDisplayErrors(errors, newTouched, context.submitAttempted)
+				displayErrors,
+				errorParams
 			};
 		}),
 		setAddressSuggestions: assign(({ event }) => ({ addressSuggestions: event.suggestions })),
 		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.fieldsCountry);
+			return {
+				submitAttempted: true,
+				displayErrors,
+				errorParams
+			};
+		}),
 		trackModuleOpen: () => {
 			addEvent({
 				code: "open",
@@ -10465,6 +10558,7 @@ const ekycMachine = setup({
 		values: {},
 		errors: {},
 		displayErrors: {},
+		errorParams: {},
 		isValid: false,
 		addressSuggestions: [],
 		prefilled: {},
@@ -10619,6 +10713,7 @@ function mapState(snapshot) {
 		values: context.values,
 		errors: context.errors,
 		displayErrors: context.displayErrors,
+		errorParams: context.errorParams,
 		isValid: context.isValid,
 		addressSuggestions: context.addressSuggestions,
 		prefilled: context.prefilled,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@incodetech/core",
-  "version": "0.0.0-dev-20260309-4e885f1",
+  "version": "0.0.0-dev-20260309-dec7ce7",
   "type": "module",
   "main": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",