@adyen/kyc-components 4.20.0 → 4.21.0-beta.0

package/dist/validateExtractionResult-BnSV5Z6F.js

@@ -0,0 +1,343 @@
+try {
+	let e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+	n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "11df1387-7668-42a2-8ace-94b35bcd34a3", e._sentryDebugIdIdentifier = "sentry-dbid-11df1387-7668-42a2-8ace-94b35bcd34a3");
+} catch (e) {}
+import { r as useTranslation } from "./translation-BOm4lmPx.js";
+import { t as createLogger } from "./logger-Z8AeTE4x.js";
+import { t as Typography } from "./Typography-CAc_f5Iq.js";
+import { n as IconButton, t as Button } from "./Button-DSD_afG_.js";
+import { r as httpPost, s as useApiContext } from "./http-DsJtugN1.js";
+import { a as objectsDeepEqual, c as valuesOf, s as keysOf } from "./genUtils-Ce61IJs8.js";
+import { t as localizeDateString } from "./localizeDateString-Dxlqr4rL.js";
+import { t as Spacer } from "./Spacer-CEHRO4Ml.js";
+import { useMemo } from "preact/hooks";
+import { jsx, jsxs } from "preact/jsx-runtime";
+import { useMutation, useQuery } from "@tanstack/preact-query";
+//#region src/api/idVerificationProviders/useExtractDocumentInformation.ts
+var extractDocumentInformation = async (legalEntityId, baseUrl, data) => httpPost({
+	baseUrl,
+	path: `legalEntities/${legalEntityId}/providers/idVerification/extract`
+}, data);
+var useExtractDocumentInformation = (options) => {
+	const { rootLegalEntityId, baseUrl } = useApiContext();
+	return useMutation({
+		mutationFn: (data) => extractDocumentInformation(rootLegalEntityId.value, baseUrl.value, data),
+		...options
+	});
+};
+//#endregion
+//#region src/utils/addressToString.tsx
+/**
+* Maps an Address object from the API model to the local AddressSchema used by forms.
+* This is the single source of truth for this conversion.
+* @param address - The Address object from the API (uses `street`, `street2`).
+* @returns An AddressSchema object for use in UI components (uses `street`, `street2`).
+*/
+var mapApiAddressToSchema = (address) => ({
+	street: address.street,
+	street2: address.street2,
+	city: address.city,
+	postalCode: address.postalCode,
+	stateOrProvince: address.stateOrProvince,
+	country: address.country
+});
+var appendWithPreSeparator = (existing, separator, appendix) => existing.length === 0 ? appendix : `${existing}${separator}${appendix}`;
+var addressToString = ({ street, street2, postalCode, city, stateOrProvince, country }, datasetUtils) => {
+	let out = "";
+	if (street) out = street;
+	if (street2) out = appendWithPreSeparator(out, " ", street2);
+	if (city) out = appendWithPreSeparator(out, ", ", city);
+	if (postalCode) out = appendWithPreSeparator(out, " ", postalCode);
+	if (stateOrProvince) out = appendWithPreSeparator(out, ", ", stateOrProvince);
+	if (country) out = appendWithPreSeparator(out, ", ", datasetUtils.getCountryName(country) ?? country);
+	return out;
+};
+//#endregion
+//#region src/hooks/useDataConflicts.ts
+var defaultConflictRule = (provided, detected) => {
+	if (detected === void 0 || detected === null) return { hasConflict: false };
+	if (provided === void 0 || provided === null) return {
+		hasConflict: false,
+		resolvedValue: detected
+	};
+	if (typeof provided === "string" && typeof detected === "string") return { hasConflict: provided.trim().toLowerCase() !== detected.trim().toLowerCase() };
+	return { hasConflict: !objectsDeepEqual(provided, detected) };
+};
+/**
+* A factory function that returns a conflict rule for the `Address` model.
+* The rule handles enrichment (auto-resolution) and deep equality checks.
+*/
+var createAddressConflictRule = (datasetUtils) => (provided, detected) => {
+	if (!detected || Object.keys(detected).length === 0) return { hasConflict: false };
+	if (!provided) return {
+		hasConflict: false,
+		resolvedValue: detected
+	};
+	if (provided.country !== detected.country) return { hasConflict: true };
+	const { country: _country, ...otherProvidedDetails } = provided;
+	if (valuesOf(otherProvidedDetails).every((value) => !value || value === "")) return {
+		hasConflict: false,
+		resolvedValue: detected
+	};
+	return { hasConflict: addressToString(mapApiAddressToSchema(provided), datasetUtils) !== addressToString(mapApiAddressToSchema(detected), datasetUtils) };
+};
+/**
+* A hook to compare two data objects and identify conflicting properties.
+* It supports custom rules for complex comparisons and can auto-resolve certain conflicts.
+*
+* @template T The shape of the data objects being compared.
+* @param providedData The primary data source (e.g., user input).
+* @param detectedData The secondary data source (e.g., OCR extraction).
+* @param rules A map of custom conflict rules for specific properties.
+* @param onAutoResolve
+* @returns An object containing the conflict status and any resolved data.
+*/
+var useDataConflicts = (providedData, detectedData, rules = {}, onAutoResolve) => {
+	const { conflictingProperties, wasAutoResolved, resolvedData, hasConflicts } = useMemo(() => {
+		if (!providedData || !detectedData) return {
+			hasConflicts: false,
+			conflictingProperties: [],
+			wasAutoResolved: false,
+			resolvedData: void 0
+		};
+		const propertiesToCompare = keysOf(detectedData);
+		const conflictingProperties = [];
+		const autoResolvedPatches = /* @__PURE__ */ new Map();
+		for (const property of propertiesToCompare) {
+			const result = (rules[property] || defaultConflictRule)(providedData[property], detectedData[property]);
+			if (result.hasConflict) conflictingProperties.push(property);
+			else if (result.resolvedValue !== void 0) autoResolvedPatches.set(property, result.resolvedValue);
+		}
+		const hasConflicts = conflictingProperties.length > 0;
+		const wasAutoResolved = autoResolvedPatches.size > 0;
+		const resolvedData = wasAutoResolved ? {
+			...providedData ?? {},
+			...Object.fromEntries(autoResolvedPatches)
+		} : void 0;
+		if (wasAutoResolved && !hasConflicts && resolvedData) onAutoResolve?.(resolvedData);
+		return {
+			hasConflicts,
+			conflictingProperties,
+			wasAutoResolved,
+			resolvedData
+		};
+	}, [
+		providedData,
+		detectedData,
+		rules,
+		onAutoResolve
+	]);
+	return {
+		hasConflicts,
+		conflictingProperties,
+		wasAutoResolved,
+		resolvedData
+	};
+};
+var IdVerificationMethod_module_default = {
+	"verification-header-image": "_verification-header-image_1vivf_1",
+	verificationHeaderImage: "_verification-header-image_1vivf_1",
+	"or-separator": "_or-separator_1vivf_5",
+	orSeparator: "_or-separator_1vivf_5"
+};
+//#endregion
+//#region src/components/Individual/forms/IdVerificationMethod/individualConflictsSchema.ts
+/**
+* Converts and flattens an {@link IndividualSchema} to an {@link IndividualConflictsSchema}.
+*
+* This is useful for comparing two {@link IndividualSchema} objects field by field.
+*
+* @param {IndividualSchema} individualSchema - The schema to convert.
+* @returns {IndividualConflictsSchema} The flattened schema.
+*/
+var toIndividualConflictSchema = ({ basicDetails, additionalPersonalDetails }) => {
+	return {
+		firstName: basicDetails?.firstName,
+		lastName: basicDetails?.lastName,
+		email: basicDetails?.email,
+		phoneNumber: basicDetails?.phoneNumber,
+		birthDate: additionalPersonalDetails?.birthDate,
+		nationality: additionalPersonalDetails?.nationality,
+		address: {
+			street: additionalPersonalDetails?.street,
+			street2: additionalPersonalDetails?.street2,
+			postalCode: additionalPersonalDetails?.postalCode,
+			city: additionalPersonalDetails?.city,
+			stateOrProvince: additionalPersonalDetails?.stateOrProvince,
+			country: additionalPersonalDetails?.country
+		},
+		idNumber: additionalPersonalDetails?.idNumber,
+		typeOfIdentity: additionalPersonalDetails?.typeOfIdentity,
+		issuerState: additionalPersonalDetails?.issuerState,
+		licenseCardNumber: additionalPersonalDetails?.licenseCardNumber,
+		expiryDate: additionalPersonalDetails?.expiryDate
+	};
+};
+/**
+* Converts an {@link IndividualConflictsSchema} back to an {@link IndividualSchema}.
+*
+* This is useful for reconstructing the original schema after a comparison.
+*
+* @param {IndividualConflictsSchema} conflictSchema - The flattened schema to convert.
+* @returns {IndividualSchema} The reconstructed schema.
+*/
+var fromIndividualConflictSchema = ({ firstName, lastName, email, phoneNumber, birthDate, nationality, address, ...idFields }) => ({
+	basicDetails: {
+		firstName,
+		lastName,
+		email,
+		phoneNumber
+	},
+	additionalPersonalDetails: {
+		birthDate,
+		nationality,
+		...idFields,
+		...address
+	}
+});
+//#endregion
+//#region src/components/Individual/forms/IdVerificationMethod/mapExtractionResultToSchema.ts
+var logger = createLogger();
+var mapExtractionResultToSchema = (result, restrictCountryOfResidenceTo) => {
+	const { firstName, lastName, issuingCountry, issuingState, dateOfBirth, address, documentNumber, documentType, nationality, placeOfBirth } = result;
+	const schema = {
+		basicDetails: {
+			firstName,
+			lastName
+		},
+		additionalPersonalDetails: {}
+	};
+	let issuingCountryIsCountryOfResidency = false;
+	if (issuingCountry) {
+		const countryFromOcr = issuingCountry;
+		if (!restrictCountryOfResidenceTo || restrictCountryOfResidenceTo.includes(countryFromOcr)) {
+			schema.additionalPersonalDetails.country = countryFromOcr;
+			issuingCountryIsCountryOfResidency = true;
+		} else {
+			schema.additionalPersonalDetails.nationality = countryFromOcr;
+			issuingCountryIsCountryOfResidency = false;
+		}
+	}
+	if (dateOfBirth) schema.additionalPersonalDetails.birthDate = dateOfBirth;
+	if (issuingState) schema.additionalPersonalDetails.issuerState = issuingState;
+	if (nationality) schema.additionalPersonalDetails.nationality = nationality;
+	if (address && issuingCountryIsCountryOfResidency && Object.keys(address).length > 0) schema.additionalPersonalDetails = {
+		...schema.additionalPersonalDetails,
+		...mapAddressToSchema(address)
+	};
+	if (documentType) switch (documentType) {
+		case "identityCard":
+			schema.additionalPersonalDetails.typeOfIdentity = "proofOfIdentityCard";
+			schema.additionalPersonalDetails.idNumber = documentNumber;
+			break;
+		case "driversLicense":
+			schema.additionalPersonalDetails.typeOfIdentity = "driversLicense";
+			schema.additionalPersonalDetails.licenseCardNumber = documentNumber;
+			break;
+		case "passport":
+			schema.additionalPersonalDetails.typeOfIdentity = "passport";
+			schema.additionalPersonalDetails.idNumber = documentNumber;
+			break;
+		default:
+			logger.warn(`document type "${documentType}" not recognised`);
+			break;
+	}
+	return schema;
+};
+var mapAddressToSchema = ({ street, street2, city, postalCode, stateOrProvince }) => ({
+	street,
+	street2,
+	city,
+	postalCode,
+	stateOrProvince
+});
+//#endregion
+//#region src/api/idVerificationProviders/useIdVerificationToken.ts
+var getIdVerificationToken = async (rootLegalEntityId, baseUrl, request) => httpPost({
+	baseUrl,
+	path: `legalEntities/${rootLegalEntityId}/providers/idVerification/initiate`
+}, request);
+/**
+* Retrieves a token that we can use to proceed with ID verification for the given set of applicant
+* details.
+*
+* **Note:** on the backend we re-use an existing Onfido applicant if a `legalEntityId` is sent
+* and we have previously generated a token for that same legal entity. Therefore, this request
+* effectively idempotent.
+*/
+var useIdVerificationToken = ({ firstName, lastName, residencyCountry }, legalEntityId, options) => {
+	const { rootLegalEntityId, baseUrl } = useApiContext();
+	const data = firstName && lastName && residencyCountry ? {
+		name: {
+			firstName,
+			lastName
+		},
+		country: residencyCountry,
+		origin: `${window.location.origin}/*`,
+		consents: [{
+			name: "privacy_notices_read",
+			granted: true
+		}],
+		...legalEntityId ? { legalEntityId } : {}
+	} : void 0;
+	return useQuery({
+		enabled: Boolean(firstName && lastName && residencyCountry),
+		queryKey: ["idVerificationToken", data],
+		queryFn: () => getIdVerificationToken(rootLegalEntityId.value, baseUrl.value, data),
+		...options
+	});
+};
+var UploadedDocument_module_default = {
+	"uploaded-document": "_uploaded-document_vsv6u_1",
+	uploadedDocument: "_uploaded-document_vsv6u_1"
+};
+//#endregion
+//#region src/components/Individual/forms/IdVerificationMethod/UploadedDocument/UploadedDocument.tsx
+var UploadedDocument = ({ document, onDelete, onUpdate }) => {
+	const { t, i18n } = useTranslation("common");
+	return /* @__PURE__ */ jsxs("article", {
+		className: UploadedDocument_module_default.uploadedDocument,
+		children: [
+			/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx(Typography, {
+				el: "h4",
+				variant: "title",
+				children: t(($) => $[document.idDocumentType])
+			}), /* @__PURE__ */ jsx(Typography, {
+				el: "p",
+				variant: "body",
+				children: t(($) => $["uploadedOn"], { date: localizeDateString(document.modificationDate, i18n.language, { month: "short" }) ?? "" })
+			})] }),
+			/* @__PURE__ */ jsx(Spacer, {}),
+			/* @__PURE__ */ jsx(IconButton, {
+				onClick: onDelete,
+				icon: "bin",
+				variant: "secondary",
+				ariaLabel: t(($) => $["delete"])
+			}),
+			/* @__PURE__ */ jsx(Button, {
+				onClick: onUpdate,
+				variant: "secondary",
+				children: t(($) => $["update"])
+			})
+		]
+	});
+};
+//#endregion
+//#region src/components/Individual/forms/IdVerificationMethod/validateExtractionResult.ts
+/**
+* Validates the OCR extraction result against business rules.
+* @param extractionResult - The data extracted from the document.
+* @returns A translation key for an error message if validation fails, otherwise null.
+*/
+var validateExtractionResult = (extractionResult) => {
+	const { isExpired, isValidDocumentType, isUnderage, minimumOnboardingAge } = extractionResult;
+	if (isExpired) return { key: "theDocumentYouUploadedIsExpired" };
+	if (!isValidDocumentType) return { key: "theDocumentTypeYouUploadedIsNotSupported" };
+	if (isUnderage) return {
+		key: "weDontAcceptDocumentsOrInformationAboutAnyoneYoungerThan_",
+		options: { values: { minimumOnboardingAge: minimumOnboardingAge?.toString() ?? "" } }
+	};
+	return null;
+};
+//#endregion
+export { fromIndividualConflictSchema as a, createAddressConflictRule as c, useExtractDocumentInformation as d, mapExtractionResultToSchema as i, useDataConflicts as l, UploadedDocument as n, toIndividualConflictSchema as o, useIdVerificationToken as r, IdVerificationMethod_module_default as s, validateExtractionResult as t, addressToString as u };

package/dist/{validationError-D5iB4HOa.js → validationError-BgIcYxoa.js}

@@ -1,8 +1,8 @@
 try {
 	let e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-	n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c32ea27e-6d98-480d-92a3-448b842ada3a", e._sentryDebugIdIdentifier = "sentry-dbid-c32ea27e-6d98-480d-92a3-448b842ada3a");
+	n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "fe069c3d-976e-4c92-ae0c-b9f7c6cf442d", e._sentryDebugIdIdentifier = "sentry-dbid-fe069c3d-976e-4c92-ae0c-b9f7c6cf442d");
 } catch (e) {}
-import { i as getFieldNameFromPath } from "./ErrorPanel-Be6eGO6I.js";
+import { i as getFieldNameFromPath } from "./ErrorPanel-CMHH1nTS.js";
 //#region src/utils/validationError.ts
 var API_VALIDATION_ERROR_CODE = "30_102";
 var ID_DOCUMENT_UPLOAD_ERROR_CODE = "30_105";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adyen/kyc-components",
-  "version": "4.20.0",
+  "version": "4.21.0-beta.0",
   "keywords": [
     "adyen",
     "adyen-for-platforms",
@@ -75,6 +75,7 @@
     "@adyen/openbankingsdk": "^0.2.3",
     "@adyen/ui-assets-icons-16": "^7.9.4",
     "@preact/signals": "^2.9.1",
+    "@tanstack/preact-form": "1.30.2",
     "@tanstack/preact-query": "^5.101.0",
     "classnames": "^2.5.1",
     "container-query-polyfill": "^1.0.2",
@@ -106,7 +107,6 @@
     "@storybook/preact-vite": "10.3.4",
     "@tanstack/eslint-plugin-query": "^5.101.0",
     "@tanstack/preact-query-devtools": "^5.101.0",
-    "@tanstack/react-form": "1.29.0",
     "@tanstack/react-form-devtools": "0.2.21",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/preact": "3.2.3",