@incodetech/core 2.1.1 → 2.2.0-rc.1

package/dist/ekycUtils-Dew1rBG0.esm.js

@@ -0,0 +1,223 @@
+//#region src/modules/ekyc/ekycConsts.ts
+const COUNTRY_SELECTOR_DISABLED_SOURCES = ["UK_VOTER_REGISTER"];
+const STATE_CODE_HINTS = {
+	US: "CA, NY",
+	CA: "ON, QC",
+	BR: "RJ, SP",
+	MX: "JAL, NLE",
+	GB: "ENG, SCT",
+	ES: "MD, CT",
+	AR: "B, C, K"
+};
+const ADDRESS_FIELDS = [
+	"address",
+	"houseNo",
+	"street",
+	"address2",
+	"city",
+	"state",
+	"postalCode"
+];
+const DRIVERS_LICENSE_FIELDS = [
+	"dlNumber",
+	"dlState",
+	"dlExpireAt"
+];
+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"];
+const DRIVERS_LICENSE_OPTIONAL_SOURCES = ["US_TELCO_1"];
+const EMAIL_SOURCES = ["US_TELCO_1", "US_CREDIT_BUREAU_1"];
+const EMAIL_OPTIONAL_SOURCES = ["US_TELCO_1"];
+const PHONE_OPTIONAL_SOURCES = ["CA_RES_CREDIT", "UK_VOTER_REGISTER"];
+const NAME_SOURCES = [
+	"US_TELCO_1",
+	"US_TELCO_2",
+	"US_TELCO_4",
+	"US_ADDRESS_1",
+	"US_CREDIT_BUREAU_1",
+	"US_DRIVERS_LICENSE_1",
+	"CA_RES_CREDIT",
+	"SERPRO",
+	"SE_1",
+	"GR_1",
+	"GT_1",
+	"AR_1",
+	"ES_1",
+	"UK_VOTER_REGISTER",
+	"CL_1",
+	"INDIA_PAN"
+];
+const HOUSE_NO_SOURCES = [
+	"SERPRO",
+	"BR_GOVT_1",
+	"GR_1",
+	"ES_1"
+];
+const STREET_SOURCES = [
+	"US_TELCO_1",
+	"US_TELCO_2",
+	"US_CREDIT_BUREAU_1",
+	"CA_RES_CREDIT",
+	"SERPRO",
+	"BR_GOVT_1",
+	"AR_1",
+	"ES_1",
+	"UK_VOTER_REGISTER"
+];
+const CITY_SOURCES = [
+	"US_TELCO_1",
+	"US_TELCO_2",
+	"US_CREDIT_BUREAU_1",
+	"CA_RES_CREDIT",
+	"SERPRO",
+	"BR_GOVT_1",
+	"AR_1",
+	"ES_1",
+	"UK_VOTER_REGISTER"
+];
+const ADDRESS_STATE_SOURCES = [
+	"US_TELCO_1",
+	"US_TELCO_2",
+	"US_CREDIT_BUREAU_1",
+	"US_DRIVERS_LICENSE_1",
+	"CA_RES_CREDIT",
+	"SERPRO",
+	"BR_GOVT_1",
+	"AR_1",
+	"ES_1"
+];
+const POSTAL_CODE_SOURCES = [
+	"US_TELCO_1",
+	"US_TELCO_2",
+	"US_CREDIT_BUREAU_1",
+	"CA_RES_CREDIT",
+	"SERPRO",
+	"BR_GOVT_1",
+	"AR_1",
+	"ES_1",
+	"UK_VOTER_REGISTER"
+];
+const TAX_ID_SOURCES = [
+	"GT_1",
+	"ES_1",
+	"CL_1"
+];
+const MIDDLE_NAME_SOURCES = [
+	"US_CREDIT_BUREAU_1",
+	"CA_RES_CREDIT",
+	"UK_VOTER_REGISTER",
+	"GR_1",
+	"AR_1",
+	"ES_1",
+	"CL_1",
+	"INDIA_PAN"
+];
+const PHONE_RISK_ADDONS = ["phoneCheck", "advancedPhoneCheck"];
+const EMAIL_RISK_ADDONS = ["emailCheck"];
+//#endregion
+//#region src/modules/ekyc/ekycUtils.ts
+function mapToEKYCvalue(field) {
+	switch (field) {
+		case "poa": return "poa_document";
+		case "document": return "document_scan";
+		case "phoneModuleInput": return "phone_module_input";
+		case "emailModuleInput": return "email_module_input";
+		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: 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,
+		dlExpireAt: config.checkDlExpireAt ? mapToEKYCvalue(config.dlExpireAtSource ?? "") : false,
+		last4SSN: config.checkLast4SSN ? mapToEKYCvalue(config.last4SSNSource ?? "") : false,
+		idNum: config.checkIdNum ? mapToEKYCvalue(config.idNumSource ?? "") : false,
+		idNum1: config.checkIdNum1 ? mapToEKYCvalue(config.idNum1Source ?? "") : false,
+		gender: config.checkGender ? mapToEKYCvalue(config.genderSource ?? "") : false,
+		panNumber: config.checkPanNumber ? mapToEKYCvalue(config.panNumberSource ?? "") : false
+	};
+}
+/** Maps a verification source string to a country code */
+function getEKYCCountry(source) {
+	switch (source) {
+		case "BR_GOVT_1":
+		case "SERPRO": return "BR";
+		case "MX_CONSUMER_1": return "MX";
+		case "UK_CREDIT_BUREAU_1":
+		case "UK_VOTER_REGISTER": return "GB";
+		case "ES_1": return "ES";
+		case "CL_1": return "CL";
+		case "AR_1": return "AR";
+		case "GR_1": return "GR";
+		case "GT_1": return "GT";
+		case "CO_1": return "CO";
+		case "CR_1": return "CR";
+		case "CA_RES_CREDIT": return "CA";
+		case "INDIA_PAN": return "IN";
+		default: return "US";
+	}
+}
+/**
+* Returns true if the input carries any raw-shape signal — i.e. a non-empty
+* `source` or at least one `check*` flag set. Used by `toEkycConfig` to
+* 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 || c.riskAddons?.length);
+}
+/**
+* Normalizes any supported eKYC config input into a manager-ready `EkycConfig`.
+*
+* Accepts either:
+*  - A manager-ready `EkycConfig` (with `flowId` or `verificationFields`) →
+*    returned unchanged.
+*  - A raw backend `EkycModuleConfig` (with `source` + `check*` / `*Source`
+*    fields, as embedded in a workflow node or returned by
+*    `/omni/flow/onboarding/configuration`) → derived into an `EkycConfig`.
+*  - A config with no recognizable signal (e.g. `{}`) → returned unchanged,
+*    so the machine still lands in `misconfigured` instead of a silent
+*    empty form.
+*
+* Idempotent: `toEkycConfig(toEkycConfig(x))` equals `toEkycConfig(x)`.
+*/
+function toEkycConfig(config) {
+	if (config.flowId || config.verificationFields) return config;
+	if (!hasRawSignal(config)) return config;
+	const source = config.source ?? "";
+	return {
+		verificationFields: getEKYCFields(config),
+		source,
+		fieldsCountry: getEKYCCountry(source),
+		enablePhoneRisk: config.enablePhoneRisk
+	};
+}
+/** Determines if a field is optional given the current config source */
+function isFieldOptional(fieldName, configSource) {
+	if (fieldName === "middleName") return true;
+	if (fieldName === "dateOfBirth") return DOB_OPTIONAL_SOURCES.includes(configSource);
+	if (fieldName === "street") return false;
+	if (ADDRESS_FIELDS.includes(fieldName)) return ADDRESS_OPTIONAL_SOURCES.includes(configSource);
+	if (fieldName === "last4SSN") return LAST4SSN_OPTIONAL_SOURCES.includes(configSource);
+	if (DRIVERS_LICENSE_FIELDS.includes(fieldName)) return DRIVERS_LICENSE_OPTIONAL_SOURCES.includes(configSource);
+	if (fieldName === "email") return EMAIL_OPTIONAL_SOURCES.includes(configSource);
+	if (fieldName === "phone") return PHONE_OPTIONAL_SOURCES.includes(configSource);
+	return false;
+}
+//#endregion
+export { ADDRESS_STATE_SOURCES as a, EMAIL_SOURCES as c, NAME_SOURCES as d, POSTAL_CODE_SOURCES as f, TAX_ID_SOURCES as h, toEkycConfig as i, HOUSE_NO_SOURCES as l, STREET_SOURCES as m, getEKYCFields as n, CITY_SOURCES as o, STATE_CODE_HINTS as p, isFieldOptional as r, COUNTRY_SELECTOR_DISABLED_SOURCES as s, getEKYCCountry as t, MIDDLE_NAME_SOURCES as u };

package/dist/electronic-signature.d.ts

@@ -1,5 +1,3 @@
-import "./StateMachine-D5WO6lHS.js";
-import "./Manager-goNPc_h_.js";
-import "./Actor-BwgmOPkb.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-36QX_21w.js";
-export { AE_CONSENT_KEYS, AeConsentKey, ConsentChecks, ConsentKey, ElectronicSignatureConfig, ElectronicSignatureDocument, ElectronicSignatureManager, ElectronicSignatureState, ElectronicSignatureVariant, QE_CONSENT_KEYS, QeConsentKey, areAllConsented, createElectronicSignatureManager, electronicSignatureMachine, getConsentKeys, getDefaultConsentChecks };
+import { _ as getDefaultConsentChecks, a as ElectronicSignatureConfig, c as ElectronicSignatureFileDataHolder, d as QE_CONSENT_KEYS, f as QeConsentKey, g as getConsentKeys, h as areAllConsented, i as ConsentKey, n as AeConsentKey, r as ConsentChecks, s as ElectronicSignatureDocument, t as AE_CONSENT_KEYS, u as ElectronicSignatureVariant } from "./types-DVmXIdzW.js";
+import { a as ElectronicSignatureActor, i as createElectronicSignatureManagerFromActor, n as ElectronicSignatureState, o as electronicSignatureMachine, r as createElectronicSignatureManager, t as ElectronicSignatureManager } from "./electronicSignatureManager-CcUXQZS7.js";
+export { AE_CONSENT_KEYS, type AeConsentKey, type ConsentChecks, type ConsentKey, type ElectronicSignatureActor, type ElectronicSignatureConfig, type ElectronicSignatureDocument, type ElectronicSignatureFileDataHolder, type ElectronicSignatureManager, type ElectronicSignatureState, type ElectronicSignatureVariant, QE_CONSENT_KEYS, type QeConsentKey, areAllConsented, createElectronicSignatureManager, createElectronicSignatureManagerFromActor, electronicSignatureMachine, getConsentKeys, getDefaultConsentChecks };

package/dist/electronic-signature.esm.js

@@ -1,10 +1,2 @@
-import "./api-DsbUi7TO.esm.js";
-import "./events-1wxZ97yf.esm.js";
-import "./endpoints-CwrFQfW7.esm.js";
-import "./xstate.esm-nY3M5UYm.esm.js";
-import "./urlUtils-CpiYwn7w.esm.js";
-import "./externalFetch-hvmz_npP.esm.js";
-import "./apiError-DkOXfFBu.esm.js";
-import { a as areAllConsented, i as QE_CONSENT_KEYS, n as electronicSignatureMachine, o as getConsentKeys, r as AE_CONSENT_KEYS, s as getDefaultConsentChecks, t as createElectronicSignatureManager } from "./electronicSignatureManager-DESRgObX.esm.js";
-
-export { AE_CONSENT_KEYS, QE_CONSENT_KEYS, areAllConsented, createElectronicSignatureManager, electronicSignatureMachine, getConsentKeys, getDefaultConsentChecks };
+import { a as QE_CONSENT_KEYS, c as getDefaultConsentChecks, i as AE_CONSENT_KEYS, n as createElectronicSignatureManagerFromActor, o as areAllConsented, r as electronicSignatureMachine, s as getConsentKeys, t as createElectronicSignatureManager } from "./electronicSignatureManager-CApcBEQd.esm.js";
+export { AE_CONSENT_KEYS, QE_CONSENT_KEYS, areAllConsented, createElectronicSignatureManager, createElectronicSignatureManagerFromActor, electronicSignatureMachine, getConsentKeys, getDefaultConsentChecks };

package/dist/{electronicSignatureManager-DESRgObX.esm.js → electronicSignatureManager-CApcBEQd.esm.js}

@@ -1,10 +1,11 @@
-import { t as api } from "./api-DsbUi7TO.esm.js";
-import { n as eventModuleNames, o as topLevelStateName, s as createManagerInstrumentation } from "./events-1wxZ97yf.esm.js";
-import { t as endpoints } from "./endpoints-CwrFQfW7.esm.js";
-import { a as fromPromise, l as createManager, r as assign, s as createActor, t as setup } from "./xstate.esm-nY3M5UYm.esm.js";
-import { t as externalFetch } from "./externalFetch-hvmz_npP.esm.js";
-import { n as toIncodeApiError } from "./apiError-DkOXfFBu.esm.js";
-
+import { t as api } from "./api-Bx3gKW_y.esm.js";
+import { n as eventModuleNames, o as createManagerInstrumentation } from "./events-CxfNJVZW.esm.js";
+import { t as topLevelStateName } from "./topLevelStateName-B5i2avbh.esm.js";
+import { t as endpoints } from "./endpoints-CCzL3XD_.esm.js";
+import { r as toIncodeApiError } from "./apiError-oiEnJIlk.esm.js";
+import { c as createManager, o as createActor, r as assign, t as setup } from "./xstate.esm-Cf4e0Cfd.esm.js";
+import { n as fromPromise } from "./xstate-actors.esm-CtI5S0f4.esm.js";
+import { t as externalFetch } from "./externalFetch-BKBThAUC.esm.js";
 //#region src/modules/electronic-signature/electronicSignatureServices.ts
 async function fetchUnsignedDocuments(signal) {
 	const res = await api.get(endpoints.aesUnsignedDocuments, { signal });
@@ -39,7 +40,6 @@ async function uploadDocumentFile(presignedUrl, data, signal) {
 		signal
 	});
 }
-
 //#endregion
 //#region src/modules/electronic-signature/electronicSignatureActors.ts
 const fetchUnsignedDocsActor = fromPromise(async ({ signal }) => fetchUnsignedDocuments(signal));
@@ -56,11 +56,10 @@ const signDocumentsActor = fromPromise(async ({ input, signal }) => {
 */
 const generateUploadUrlActor = fromPromise(async ({ signal }) => generateUploadUrl(signal));
 const uploadFileActor = fromPromise(async ({ input, signal }) => {
-	const fileData = input.getFileData();
+	const fileData = input.fileDataHolder.current;
 	if (!fileData) throw new Error("No file data available for upload");
 	await uploadDocumentFile(input.preSignedUrl, fileData, signal);
 });
-
 //#endregion
 //#region src/modules/electronic-signature/types.ts
 const AE_CONSENT_KEYS = [
@@ -85,9 +84,20 @@ function getDefaultConsentChecks(variant) {
 function areAllConsented(checks) {
 	return Object.values(checks).every(Boolean);
 }
-
 //#endregion
 //#region src/modules/electronic-signature/electronicSignatureStateMachine.ts
+function resolveFileDataHolder(input) {
+	if (input.fileDataHolder !== void 0) return input.fileDataHolder;
+	let selectedFileData;
+	return {
+		get current() {
+			return selectedFileData === void 0 ? input.getFileData() : selectedFileData;
+		},
+		set current(fileData) {
+			selectedFileData = fileData;
+		}
+	};
+}
 const electronicSignatureMachine = setup({
 	types: {
 		context: {},
@@ -154,7 +164,7 @@ const electronicSignatureMachine = setup({
 	initial: "idle",
 	context: ({ input }) => ({
 		config: input.config,
-		getFileData: input.getFileData,
+		fileDataHolder: resolveFileDataHolder(input),
 		documents: [],
 		signedDocuments: [],
 		fileName: null,
@@ -213,7 +223,7 @@ const electronicSignatureMachine = setup({
 			src: "uploadFile",
 			input: ({ context }) => ({
 				preSignedUrl: context.preSignedUrl,
-				getFileData: context.getFileData
+				fileDataHolder: context.fileDataHolder
 			}),
 			onDone: { target: "fetchingDocs" },
 			onError: {
@@ -320,16 +330,11 @@ const electronicSignatureMachine = setup({
 		closed: { type: "final" }
 	}
 });
-
 //#endregion
 //#region src/modules/electronic-signature/electronicSignatureActor.ts
 function createElectronicSignatureActor(options) {
-	return createActor(electronicSignatureMachine, { input: {
-		config: options.config,
-		getFileData: options.getFileData
-	} }).start();
+	return createActor(electronicSignatureMachine, { input: options }).start();
 }
-
 //#endregion
 //#region src/modules/electronic-signature/electronicSignatureManager.ts
 /**
@@ -459,7 +464,7 @@ function mapState(snapshot) {
 	if (snapshot.matches("closed")) return { status: "closed" };
 	throw new Error(`Unhandled electronic-signature state: ${JSON.stringify(snapshot.value)}`);
 }
-function createApi({ actor, trackElementClicked, fileDataRef }) {
+function createApi({ actor, trackElementClicked, fileDataHolder }) {
 	return {
 		load() {
 			actor.send({ type: "LOAD" });
@@ -472,7 +477,7 @@ function createApi({ actor, trackElementClicked, fileDataRef }) {
 			});
 		},
 		selectFile(fileName, fileData, fileUrl) {
-			fileDataRef.current = fileData;
+			fileDataHolder.current = fileData;
 			actor.send({
 				type: "SELECT_FILE",
 				fileName,
@@ -481,7 +486,7 @@ function createApi({ actor, trackElementClicked, fileDataRef }) {
 			});
 		},
 		replaceFile() {
-			fileDataRef.current = null;
+			fileDataHolder.current = null;
 			actor.send({ type: "REPLACE_FILE" });
 		},
 		confirmFile() {
@@ -507,7 +512,7 @@ function createApi({ actor, trackElementClicked, fileDataRef }) {
 		},
 		retry() {
 			trackElementClicked?.("retry");
-			fileDataRef.current = null;
+			fileDataHolder.current = null;
 			actor.send({ type: "RETRY" });
 		},
 		close() {
@@ -516,23 +521,32 @@ function createApi({ actor, trackElementClicked, fileDataRef }) {
 		}
 	};
 }
-function createElectronicSignatureManager(options) {
-	const fileDataRef = { current: null };
-	const actor = createElectronicSignatureActor({
-		config: options.config,
-		getFileData: () => fileDataRef.current
-	});
-	const isQualified = options.config.variant === "qe";
+/**
+* Creates an electronic-signature manager around a pre-built actor.
+*
+* The manager reads the file-data holder from the actor's input-derived
+* context, guaranteeing that `selectFile()` and the upload actor use the same
+* in-memory bytes. This supports actors created from `.provide()` machine
+* variants without exposing the actor through the manager.
+*/
+function createElectronicSignatureManagerFromActor(actor) {
+	const { config, fileDataHolder } = actor.getSnapshot().context;
+	const isQualified = config.variant === "qe";
 	return createManager({
 		actor,
 		mapState,
 		createApi: (apiOptions) => createApi({
 			...apiOptions,
-			fileDataRef
+			fileDataHolder
 		}),
 		instrumentation: createManagerInstrumentation(isQualified ? eventModuleNames.qeSignature : eventModuleNames.aeSignature, { getEventScreenName: isQualified ? getQSignatureScreenName : getAdSignatureScreenName })
 	});
 }
-
+function createElectronicSignatureManager(options) {
+	return createElectronicSignatureManagerFromActor(createElectronicSignatureActor({
+		config: options.config,
+		fileDataHolder: { current: null }
+	}));
+}
 //#endregion
-export { areAllConsented as a, QE_CONSENT_KEYS as i, electronicSignatureMachine as n, getConsentKeys as o, AE_CONSENT_KEYS as r, getDefaultConsentChecks as s, createElectronicSignatureManager as t };
+export { QE_CONSENT_KEYS as a, getDefaultConsentChecks as c, AE_CONSENT_KEYS as i, createElectronicSignatureManagerFromActor as n, areAllConsented as o, electronicSignatureMachine as r, getConsentKeys as s, createElectronicSignatureManager as t };