@incodetech/core 2.0.0 → 2.0.1

package/dist/idOcrStateMachine-YbjjC_Gg.esm.js

@@ -0,0 +1,388 @@
+import { t as api } from "./api-CESGtpbH.esm.js";
+import { x as getTimestamp } from "./events-D6-e4vok.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";
+
+//#region ../infra/src/providers/browser/DateFormattingProvider.ts
+var DateFormattingProvider = class {
+	utcToIsoDateString(value) {
+		if (value === void 0 || value === null || value === "") return "";
+		const date = new Date(value);
+		if (Number.isNaN(date.getTime())) return "";
+		return `${date.getUTCFullYear()}-${String(date.getUTCMonth() + 1).padStart(2, "0")}-${String(date.getUTCDate()).padStart(2, "0")}`;
+	}
+	parseIsoDateStringToEpochMs(value) {
+		return Date.parse(value);
+	}
+	getAgeInYears(birthDate, referenceEpochMs) {
+		const now = new Date(referenceEpochMs);
+		const birth = typeof birthDate === "string" && /^\d{4}-\d{2}-\d{2}$/.test(birthDate) ? (() => {
+			const [y, m, d] = birthDate.split("-").map(Number);
+			return new Date(y, m - 1, d);
+		})() : new Date(birthDate);
+		let age = now.getFullYear() - birth.getFullYear();
+		const monthDiff = now.getMonth() - birth.getMonth();
+		if (monthDiff < 0 || monthDiff === 0 && now.getDate() < birth.getDate()) age--;
+		return age;
+	}
+};
+
+//#endregion
+//#region src/modules/id-ocr/idOcrUtils.ts
+const dateFormattingInstance$1 = new DateFormattingProvider();
+const resolveFullName = (data) => {
+	if (data.name?.fullName) return data.name.fullName;
+	const joined = [
+		data.name?.givenName ?? data.givenName ?? data.firstName,
+		data.name?.paternalLastName ?? data.fathersSurname,
+		data.name?.maternalLastName ?? data.mothersSurname
+	].filter(Boolean).join(" ").trim();
+	if (joined) return joined;
+	return data.fullNameMrz ?? "";
+};
+const mapOcrResponseToFormData = (data) => ({
+	name: resolveFullName(data),
+	firstName: data.firstName ?? data.givenName ?? data.name?.givenName ?? "",
+	lastName: data.fathersSurname ?? data.name?.paternalLastName ?? "",
+	paternalLastName: data.fathersSurname ?? data.name?.paternalLastName ?? "",
+	maternalLastName: data.mothersSurname ?? data.name?.maternalLastName ?? "",
+	birthDate: dateFormattingInstance$1.utcToIsoDateString(data.birthDate),
+	gender: data.gender ?? "",
+	address: data.address ?? "",
+	documentNumber: data.documentNumber ?? "",
+	personalNumber: data.personalNumber ?? "",
+	curp: data.curp ?? "",
+	issuingCountry: data.issuingCountry ?? "",
+	expireAt: data.expireAt,
+	email: ""
+});
+const mapUpdateOcrDataForApi = (params) => {
+	const working = { ...params };
+	const nameTrimmed = working.name?.trim();
+	if (nameTrimmed) working.name = nameTrimmed;
+	if (nameTrimmed && !working.firstName?.trim() && !working.paternalLastName?.trim() && !working.maternalLastName?.trim()) {
+		const tokens = nameTrimmed.split(/\s+/).filter(Boolean);
+		if (tokens.length === 3) {
+			working.firstName = tokens[0];
+			working.paternalLastName = tokens[1];
+			working.maternalLastName = tokens[2];
+		}
+	}
+	const body = {};
+	for (const key of Object.keys(working)) {
+		const raw = working[key];
+		if (raw === void 0) continue;
+		if (key === "birthDate") {
+			body[key] = dateFormattingInstance$1.parseIsoDateStringToEpochMs(raw);
+			continue;
+		}
+		body[key] = typeof raw === "string" ? raw.trim() : raw;
+	}
+	return body;
+};
+
+//#endregion
+//#region src/modules/id-ocr/idOcrServices.ts
+/** Fetch ID OCR data. Throws on failure. */
+async function getOcrData(signal, isSecondId) {
+	const url = isSecondId ? endpoints.ocrDataSecondId : endpoints.ocrData;
+	const res = await api.get(url, { signal });
+	if (!res.ok) throw new Error(`GET ${url} failed: ${res.status} ${res.statusText}`);
+	return res.data;
+}
+/** Updates ID OCR data if OCR data is editable. Throws on failure. */
+async function updateOcrData(params, signal, isSecondId) {
+	const url = isSecondId ? endpoints.updateEditableOcrDataSecondId : endpoints.updateEditableOcrData;
+	const res = await api.put(url, mapUpdateOcrDataForApi(params), { signal });
+	if (!res.ok) throw new Error(`PUT failed: ${url} failed: ${res.status} ${res.statusText}`);
+	return res.data;
+}
+
+//#endregion
+//#region src/modules/id-ocr/idOcrConsts.ts
+const MIN_AGE = 18;
+const CPFFlowIds = [
+	"65985b7ec335fa20effa547b",
+	"657b823ddb312196b5dd30f8",
+	"659843c207413e34c407fc1d",
+	"657c8b7a188817b6ec04b26c",
+	"6793bba8845d50f53f5fb910",
+	"679826a35ec9927c65407873",
+	"6838c03fae866c13e63fbaf4",
+	"681a14fb37a49f2319cbf359",
+	"68e5318406c77c2b6993ed8f",
+	"68e531531a6892418eecd21f",
+	"68e5314706c77c2b6993eb99"
+];
+
+//#endregion
+//#region src/modules/id-ocr/idOcrFields.ts
+const CPF_ONLY_OCR_FIELDS = [{
+	key: "documentNumber",
+	labelKey: "userData.cpf",
+	type: "text",
+	validation: [{ type: "required" }, { type: "cpf" }],
+	required: true
+}];
+const OCR_FIELDS = [
+	{
+		key: "name",
+		labelKey: "userData.fullName",
+		type: "text",
+		validation: [{ type: "required" }],
+		required: true
+	},
+	{
+		key: "birthDate",
+		labelKey: "userData.dateOfBirth",
+		type: "date",
+		validation: [{ type: "required" }, {
+			type: "minAge",
+			years: MIN_AGE
+		}],
+		required: true
+	},
+	{
+		key: "gender",
+		labelKey: "userData.sex",
+		type: "radio",
+		options: [{
+			label: "common.male",
+			value: "M"
+		}, {
+			label: "common.female",
+			value: "F"
+		}],
+		required: false
+	},
+	{
+		key: "issuingCountry",
+		labelKey: "userData.issuingCountry",
+		type: "text",
+		validation: [{ type: "required" }],
+		required: true
+	},
+	{
+		key: "documentNumber",
+		labelKey: "userData.documentNumber",
+		type: "text",
+		validation: [{ type: "required" }],
+		required: true
+	},
+	{
+		key: "address",
+		labelKey: "userData.address",
+		type: "text",
+		validation: [{ type: "required" }],
+		required: true
+	}
+];
+const getOcrFields = (config) => {
+	const { flowId } = config;
+	if (flowId && CPFFlowIds.includes(flowId)) return CPF_ONLY_OCR_FIELDS;
+	return OCR_FIELDS;
+};
+
+//#endregion
+//#region src/modules/id-ocr/idOcrValidators.ts
+const dateFormattingInstance = new DateFormattingProvider();
+const createValidators = () => {
+	return {
+		required: (value, _) => !value.trim() ? "modifiableOCR.cantBeEmpty" : void 0,
+		minAge: (value, rule) => {
+			if (!value.trim() || rule.type !== "minAge") return void 0;
+			return dateFormattingInstance.getAgeInYears(value, getTimestamp()) < rule.years ? "modifiableOCR.ageRange" : void 0;
+		},
+		cpf: (value, rule) => {
+			if (rule.type !== "cpf" || !value.trim()) return void 0;
+			return validateCPF(value) ? void 0 : "verification.errors.invalidTaxId";
+		}
+	};
+};
+const normalizeFieldValue = (value) => typeof value === "string" ? value.trim() : String(value ?? "");
+const validateFieldValue = (value, field, validators) => {
+	if (!field.validation) return void 0;
+	for (const rule of field.validation) {
+		const error = validators[rule.type](value, rule);
+		if (error) return error;
+	}
+};
+const validateOcrForm = (data, fields) => {
+	const validators = createValidators();
+	return fields.reduce((errors, field) => {
+		const error = validateFieldValue(normalizeFieldValue(data[field.key]), field, validators);
+		if (error) errors[field.key] = error;
+		return errors;
+	}, {});
+};
+const validateOcrField = (data, fieldKey, fields) => {
+	const field = fields.find((field$1) => field$1.key === fieldKey);
+	if (!field) return void 0;
+	const validators = createValidators();
+	return validateFieldValue(normalizeFieldValue(data[field.key]), field, validators);
+};
+
+//#endregion
+//#region src/modules/id-ocr/idOcrStateMachine.ts
+const emptyOcrData = () => ({});
+const idOcrStateMachine = setup({
+	types: {
+		context: {},
+		events: {},
+		input: {}
+	},
+	actors: {
+		getOcrData: fromPromise(async ({ input, signal }) => getOcrData(signal, input.isSecondId)),
+		updateOcrData: fromPromise(async ({ input, signal }) => updateOcrData(input.params, signal, input.isSecondId))
+	},
+	actions: {
+		setInitialData: assign(({ event }) => {
+			const raw = event.output;
+			return {
+				formData: mapOcrResponseToFormData(raw),
+				editedFields: {},
+				validationErrors: void 0,
+				error: void 0
+			};
+		}),
+		updateField: assign(({ context, event }) => {
+			const { field, value } = event;
+			return {
+				formData: {
+					...context.formData,
+					[field]: value
+				},
+				editedFields: {
+					...context.editedFields,
+					[field]: value
+				}
+			};
+		}),
+		clearFieldValidationError: assign(({ context, event }) => {
+			if (event.type !== "DATA_CHANGED") return {};
+			const { field } = event;
+			const errs = context.validationErrors;
+			if (!errs?.[field]) return {};
+			const next = { ...errs };
+			delete next[field];
+			return { validationErrors: Object.keys(next).length > 0 ? next : void 0 };
+		}),
+		setOcrValidationErrors: assign(({ context }) => ({ validationErrors: validateOcrForm(context.formData, getOcrFields(context.config)) })),
+		validateFormField: assign(({ context, event }) => {
+			if (event.type !== "VALIDATE_FIELD") return {};
+			const { field } = event;
+			const message = validateOcrField(context.formData, field, getOcrFields(context.config));
+			const next = { ...context.validationErrors ?? {} };
+			if (message) next[field] = message;
+			else delete next[field];
+			return { validationErrors: Object.keys(next).length > 0 ? next : void 0 };
+		}),
+		setError: assign(({ event }) => ({ error: String(event.error) })),
+		beginSecondIdOcrPhase: assign(() => ({
+			activeOcrDocument: "second",
+			editedFields: {},
+			validationErrors: void 0
+		})),
+		resetForRetry: assign(() => ({
+			activeOcrDocument: "first",
+			formData: emptyOcrData(),
+			editedFields: {},
+			error: void 0,
+			validationErrors: void 0
+		})),
+		computeValidationResult: assign(({ context }) => ({ validationErrors: validateOcrForm(context.formData, getOcrFields(context.config)) }))
+	},
+	guards: {
+		isOcrEditable: ({ context }) => context.config.editableOcr === true,
+		shouldLoadSecondOcrAfterFirst: ({ context }) => context.config.secondId === true && context.activeOcrDocument === "first",
+		isOcrFormValid: ({ context }) => Object.keys(context.validationErrors ?? {}).length === 0,
+		shouldSubmit: ({ context }) => Object.keys(context.validationErrors ?? {}).length === 0 && Object.keys(context.editedFields).length > 0,
+		shouldProceedWithoutSubmitToSecondId: ({ context }) => Object.keys(context.validationErrors ?? {}).length === 0 && Object.keys(context.editedFields).length === 0 && context.config.secondId === true && context.activeOcrDocument === "first"
+	}
+}).createMachine({
+	id: "idOcr",
+	initial: "idle",
+	context: ({ input }) => {
+		const data = emptyOcrData();
+		return {
+			config: input.config,
+			formData: data,
+			editedFields: {},
+			activeOcrDocument: "first"
+		};
+	},
+	states: {
+		idle: { on: { LOAD: [{ target: "loading" }] } },
+		loading: { invoke: {
+			src: "getOcrData",
+			input: ({ context }) => ({ isSecondId: context.activeOcrDocument === "second" }),
+			onDone: [{
+				target: "inputting",
+				guard: "isOcrEditable",
+				actions: "setInitialData"
+			}, {
+				target: "readonly",
+				actions: "setInitialData"
+			}],
+			onError: {
+				target: "error",
+				actions: "setError"
+			}
+		} },
+		readonly: { on: { CONTINUE: [{
+			target: "loading",
+			guard: "shouldLoadSecondOcrAfterFirst",
+			actions: "beginSecondIdOcrPhase"
+		}, { target: "success" }] } },
+		inputting: { on: {
+			DATA_CHANGED: { actions: ["updateField", "clearFieldValidationError"] },
+			VALIDATE_FIELD: { actions: "validateFormField" },
+			CONTINUE: { target: "validatingContinue" }
+		} },
+		validatingContinue: {
+			entry: "computeValidationResult",
+			always: [
+				{
+					guard: "shouldSubmit",
+					target: "submitting"
+				},
+				{
+					guard: "shouldProceedWithoutSubmitToSecondId",
+					target: "loading",
+					actions: "beginSecondIdOcrPhase"
+				},
+				{
+					guard: "isOcrFormValid",
+					target: "success"
+				},
+				{ target: "inputting" }
+			]
+		},
+		submitting: { invoke: {
+			src: "updateOcrData",
+			input: ({ context }) => ({
+				params: context.editedFields,
+				isSecondId: context.activeOcrDocument === "second"
+			}),
+			onDone: [{
+				target: "loading",
+				guard: "shouldLoadSecondOcrAfterFirst",
+				actions: "beginSecondIdOcrPhase"
+			}, { target: "success" }],
+			onError: {
+				target: "error",
+				actions: "setError"
+			}
+		} },
+		error: { on: { RETRY: {
+			target: "loading",
+			actions: "resetForRetry"
+		} } },
+		success: { after: { 3e3: "finished" } },
+		finished: { type: "final" }
+	}
+});
+
+//#endregion
+export { MIN_AGE as a, CPFFlowIds as i, OCR_FIELDS as n, getOcrFields as r, idOcrStateMachine as t };

package/dist/idVerificationStateMachine-xbw9HP1Z.esm.js

@@ -0,0 +1,71 @@
+import { t as api } from "./api-CESGtpbH.esm.js";
+import { t as endpoints } from "./endpoints-CnN3SyDa.esm.js";
+import { a as fromPromise, t as setup } from "./xstate.esm-B70JrNqo.esm.js";
+
+//#region src/modules/id-verification/idVerificationServices.ts
+/**
+* Submits the captured ID for backend verification. Wraps `POST /omni/process/id`
+* (or `/omni/process/second-id` when `isSecondId` is true).
+*
+* The `queueName` query parameter is always appended — including when empty —
+* to match the legacy request shape that the server returns 200 for. The
+* versioned `/0/omni/process/id` route 500s when the parameter is omitted.
+*/
+async function processId(input = {}, signal) {
+	const endpoint = input.isSecondId ? endpoints.processSecondId : endpoints.processId;
+	const queueName = input.queueName ?? "";
+	const url = `${endpoint}?queueName=${encodeURIComponent(queueName)}`;
+	const res = await api.post(url, {}, { signal });
+	if (!res.ok) throw new Error(`POST ${endpoint} failed: ${res.status} ${res.statusText}`);
+	return { isDocumentExpired: res.data?.isDocumentExpired ?? false };
+}
+
+//#endregion
+//#region src/modules/id-verification/idVerificationStateMachine.ts
+function deriveIsSecondId(config) {
+	if (config.isSecondId === true) return true;
+	if (config.idRank === "SECOND_ID") return true;
+	return false;
+}
+const idVerificationMachine = setup({
+	types: {
+		context: {},
+		events: {},
+		input: {}
+	},
+	actors: { processId: fromPromise(async ({ input, signal }) => {
+		return processId({
+			isSecondId: input.isSecondId,
+			queueName: input.queueName
+		}, signal);
+	}) },
+	guards: { isDocumentExpired: ({ event }) => event.output?.isDocumentExpired === true }
+}).createMachine({
+	id: "idVerification",
+	initial: "idle",
+	context: ({ input }) => ({
+		config: input.config,
+		isSecondId: deriveIsSecondId(input.config)
+	}),
+	states: {
+		idle: { on: { LOAD: "processing" } },
+		processing: { invoke: {
+			id: "processId",
+			src: "processId",
+			input: ({ context }) => ({
+				isSecondId: context.isSecondId,
+				queueName: context.config.queueName ?? ""
+			}),
+			onDone: [{
+				target: "expired",
+				guard: "isDocumentExpired"
+			}, { target: "finished" }],
+			onError: { target: "finished" }
+		} },
+		expired: { on: { CONTINUE: "finished" } },
+		finished: { type: "final" }
+	}
+});
+
+//#endregion
+export { idVerificationMachine as t };