@koraidv/react 1.7.9 → 1.7.11

package/dist/index.d.mts

@@ -67,7 +67,7 @@ interface UseKoraIDVReturn {
     /**
      * Start a new verification
      */
-    startVerification: (externalId: string, tier?: string) => Promise<void>;
+    startVerification: (externalId: string, tier?: string, expectedFirstName?: string, expectedLastName?: string) => Promise<void>;
     /**
      * Resume an existing verification
      */
@@ -142,6 +142,21 @@ interface VerificationFlowProps {
     externalId: string;
     tier?: 'basic' | 'standard' | 'enhanced';
     documentTypes?: DocumentType[];
+    /**
+     * Optional name-match inputs. When set, the backend compares the
+     * OCR'd names on the document against these values and surfaces a
+     * real `scores.nameMatch` percentage on the verification result —
+     * the ResultScreen's "Name Match" row shows real PASS/FAIL instead
+     * of the always-0% / always-FAIL it shows when these aren't passed.
+     *
+     * Wire from your user record at mount time, e.g.
+     *   `<VerificationFlow expectedFirstName={user.firstName} ... />`
+     *
+     * Mirrors iOS's
+     * `KoraIDV.startVerification(expectedFirstName:expectedLastName:)`.
+     */
+    expectedFirstName?: string;
+    expectedLastName?: string;
     onComplete?: (verification: Verification) => void;
     onError?: (error: KoraError) => void;
     onCancel?: () => void;
@@ -151,7 +166,7 @@ interface VerificationFlowProps {
 /**
  * Complete verification flow component
  */
-declare function VerificationFlow({ externalId, tier, documentTypes, onComplete, onError, onCancel, className, style, }: VerificationFlowProps): react_jsx_runtime.JSX.Element;
+declare function VerificationFlow({ externalId, tier, documentTypes, expectedFirstName, expectedLastName, onComplete, onError, onCancel, className, style, }: VerificationFlowProps): react_jsx_runtime.JSX.Element;
 
 interface ConsentScreenProps {
     onAccept: () => void;

package/dist/index.d.ts

@@ -67,7 +67,7 @@ interface UseKoraIDVReturn {
     /**
      * Start a new verification
      */
-    startVerification: (externalId: string, tier?: string) => Promise<void>;
+    startVerification: (externalId: string, tier?: string, expectedFirstName?: string, expectedLastName?: string) => Promise<void>;
     /**
      * Resume an existing verification
      */
@@ -142,6 +142,21 @@ interface VerificationFlowProps {
     externalId: string;
     tier?: 'basic' | 'standard' | 'enhanced';
     documentTypes?: DocumentType[];
+    /**
+     * Optional name-match inputs. When set, the backend compares the
+     * OCR'd names on the document against these values and surfaces a
+     * real `scores.nameMatch` percentage on the verification result —
+     * the ResultScreen's "Name Match" row shows real PASS/FAIL instead
+     * of the always-0% / always-FAIL it shows when these aren't passed.
+     *
+     * Wire from your user record at mount time, e.g.
+     *   `<VerificationFlow expectedFirstName={user.firstName} ... />`
+     *
+     * Mirrors iOS's
+     * `KoraIDV.startVerification(expectedFirstName:expectedLastName:)`.
+     */
+    expectedFirstName?: string;
+    expectedLastName?: string;
     onComplete?: (verification: Verification) => void;
     onError?: (error: KoraError) => void;
     onCancel?: () => void;
@@ -151,7 +166,7 @@ interface VerificationFlowProps {
 /**
  * Complete verification flow component
  */
-declare function VerificationFlow({ externalId, tier, documentTypes, onComplete, onError, onCancel, className, style, }: VerificationFlowProps): react_jsx_runtime.JSX.Element;
+declare function VerificationFlow({ externalId, tier, documentTypes, expectedFirstName, expectedLastName, onComplete, onError, onCancel, className, style, }: VerificationFlowProps): react_jsx_runtime.JSX.Element;
 
 interface ConsentScreenProps {
     onAccept: () => void;

package/dist/index.js

@@ -101,11 +101,16 @@ function useKoraIDV() {
   const [selectedDocumentType, setSelectedDocumentType] = (0, import_react2.useState)(null);
   const [documentFrontCaptured, setDocumentFrontCaptured] = (0, import_react2.useState)(false);
   const startVerification = (0, import_react2.useCallback)(
-    async (externalId, tier = "standard") => {
+    async (externalId, tier = "standard", expectedFirstName, expectedLastName) => {
       setState((prev) => ({ ...prev, isLoading: true, error: null }));
       try {
         await sdk.startVerification(
-          { externalId, tier },
+          {
+            externalId,
+            tier,
+            expectedFirstName,
+            expectedLastName
+          },
           {
             onStepChange: (step) => {
               setState((prev) => ({ ...prev, step }));
@@ -1509,13 +1514,18 @@ function ProcessingScreen({ steps }) {
   ] });
 }
 function computeScoreBreakdown(verification) {
-  const liveness = verification.livenessVerification?.livenessScore ?? 0;
-  const livenessPercent = Math.round(liveness * 100);
-  const docQuality = verification.documentVerification?.authenticityScore ?? 0;
-  const docPercent = Math.round(docQuality * 100);
-  const nameMatch = verification.documentVerification?.firstName && verification.documentVerification?.lastName ? 100 : 0;
-  const selfieMatch = verification.faceVerification?.matchScore ?? 0;
-  const selfiePercent = Math.round(selfieMatch * 100);
+  const livenessPercent = Math.round(
+    verification.scores?.liveness ?? verification.livenessVerification?.livenessScore ?? 0
+  );
+  const docPercent = Math.round(
+    verification.scores?.documentAuth ?? (verification.documentVerification?.authenticityScore ?? 0) * 100
+  );
+  const nameMatch = Math.round(
+    verification.scores?.nameMatch ?? (verification.documentVerification?.firstName && verification.documentVerification?.lastName ? 100 : 0)
+  );
+  const selfiePercent = Math.round(
+    verification.scores?.faceMatch ?? verification.faceVerification?.matchScore ?? 0
+  );
   function getStatus(score) {
     if (score >= 75) return "pass";
     if (score >= 50) return "borderline";
@@ -2663,7 +2673,9 @@ function ResultScreen({ verification, onDone, onRetry, resultPageMode, simplifie
   }
 }
 function SuccessResult({ verification, onDone }) {
-  const score = verification.riskScore ?? 84;
+  const score = Math.round(
+    verification.scores?.overall ?? 100 - (verification.riskScore ?? 16)
+  );
   const metrics = computeScoreBreakdown(verification);
   return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { style: styles.resultContainer, children: [
     /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { style: styles.resultContent, children: [
@@ -2704,7 +2716,9 @@ function SuccessResult({ verification, onDone }) {
   ] });
 }
 function RejectedResult({ verification, onRetry }) {
-  const score = verification.riskScore ?? 42;
+  const score = Math.round(
+    verification.scores?.overall ?? 100 - (verification.riskScore ?? 58)
+  );
   const metrics = computeScoreBreakdown(verification);
   return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { style: styles.resultContainer, children: [
     /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { style: styles.resultContent, children: [
@@ -2795,7 +2809,9 @@ function ExpiredResult({ verification, onRetry }) {
   ] });
 }
 function ManualReviewResult({ verification, onDone }) {
-  const score = verification.riskScore ?? 68;
+  const score = Math.round(
+    verification.scores?.overall ?? 100 - (verification.riskScore ?? 32)
+  );
   const metrics = computeScoreBreakdown(verification);
   return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { style: styles.resultContainer, children: [
     /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { style: styles.resultContent, children: [
@@ -3031,6 +3047,8 @@ function VerificationFlow({
   externalId,
   tier = "standard",
   documentTypes,
+  expectedFirstName,
+  expectedLastName,
   onComplete,
   onError,
   onCancel,
@@ -3063,8 +3081,8 @@ function VerificationFlow({
     }
   }, [state.step]);
   (0, import_react10.useEffect)(() => {
-    startVerification(externalId, tier);
-  }, [externalId, tier, startVerification]);
+    startVerification(externalId, tier, expectedFirstName, expectedLastName);
+  }, [externalId, tier, expectedFirstName, expectedLastName, startVerification]);
   (0, import_react10.useEffect)(() => {
     if (state.error && onError) {
       onError(state.error);

package/dist/index.mjs

@@ -52,11 +52,16 @@ function useKoraIDV() {
   const [selectedDocumentType, setSelectedDocumentType] = useState(null);
   const [documentFrontCaptured, setDocumentFrontCaptured] = useState(false);
   const startVerification = useCallback(
-    async (externalId, tier = "standard") => {
+    async (externalId, tier = "standard", expectedFirstName, expectedLastName) => {
       setState((prev) => ({ ...prev, isLoading: true, error: null }));
       try {
         await sdk.startVerification(
-          { externalId, tier },
+          {
+            externalId,
+            tier,
+            expectedFirstName,
+            expectedLastName
+          },
           {
             onStepChange: (step) => {
               setState((prev) => ({ ...prev, step }));
@@ -1460,13 +1465,18 @@ function ProcessingScreen({ steps }) {
   ] });
 }
 function computeScoreBreakdown(verification) {
-  const liveness = verification.livenessVerification?.livenessScore ?? 0;
-  const livenessPercent = Math.round(liveness * 100);
-  const docQuality = verification.documentVerification?.authenticityScore ?? 0;
-  const docPercent = Math.round(docQuality * 100);
-  const nameMatch = verification.documentVerification?.firstName && verification.documentVerification?.lastName ? 100 : 0;
-  const selfieMatch = verification.faceVerification?.matchScore ?? 0;
-  const selfiePercent = Math.round(selfieMatch * 100);
+  const livenessPercent = Math.round(
+    verification.scores?.liveness ?? verification.livenessVerification?.livenessScore ?? 0
+  );
+  const docPercent = Math.round(
+    verification.scores?.documentAuth ?? (verification.documentVerification?.authenticityScore ?? 0) * 100
+  );
+  const nameMatch = Math.round(
+    verification.scores?.nameMatch ?? (verification.documentVerification?.firstName && verification.documentVerification?.lastName ? 100 : 0)
+  );
+  const selfiePercent = Math.round(
+    verification.scores?.faceMatch ?? verification.faceVerification?.matchScore ?? 0
+  );
   function getStatus(score) {
     if (score >= 75) return "pass";
     if (score >= 50) return "borderline";
@@ -2614,7 +2624,9 @@ function ResultScreen({ verification, onDone, onRetry, resultPageMode, simplifie
   }
 }
 function SuccessResult({ verification, onDone }) {
-  const score = verification.riskScore ?? 84;
+  const score = Math.round(
+    verification.scores?.overall ?? 100 - (verification.riskScore ?? 16)
+  );
   const metrics = computeScoreBreakdown(verification);
   return /* @__PURE__ */ jsxs9("div", { style: styles.resultContainer, children: [
     /* @__PURE__ */ jsxs9("div", { style: styles.resultContent, children: [
@@ -2655,7 +2667,9 @@ function SuccessResult({ verification, onDone }) {
   ] });
 }
 function RejectedResult({ verification, onRetry }) {
-  const score = verification.riskScore ?? 42;
+  const score = Math.round(
+    verification.scores?.overall ?? 100 - (verification.riskScore ?? 58)
+  );
   const metrics = computeScoreBreakdown(verification);
   return /* @__PURE__ */ jsxs9("div", { style: styles.resultContainer, children: [
     /* @__PURE__ */ jsxs9("div", { style: styles.resultContent, children: [
@@ -2746,7 +2760,9 @@ function ExpiredResult({ verification, onRetry }) {
   ] });
 }
 function ManualReviewResult({ verification, onDone }) {
-  const score = verification.riskScore ?? 68;
+  const score = Math.round(
+    verification.scores?.overall ?? 100 - (verification.riskScore ?? 32)
+  );
   const metrics = computeScoreBreakdown(verification);
   return /* @__PURE__ */ jsxs9("div", { style: styles.resultContainer, children: [
     /* @__PURE__ */ jsxs9("div", { style: styles.resultContent, children: [
@@ -2982,6 +2998,8 @@ function VerificationFlow({
   externalId,
   tier = "standard",
   documentTypes,
+  expectedFirstName,
+  expectedLastName,
   onComplete,
   onError,
   onCancel,
@@ -3014,8 +3032,8 @@ function VerificationFlow({
     }
   }, [state.step]);
   useEffect8(() => {
-    startVerification(externalId, tier);
-  }, [externalId, tier, startVerification]);
+    startVerification(externalId, tier, expectedFirstName, expectedLastName);
+  }, [externalId, tier, expectedFirstName, expectedLastName, startVerification]);
   useEffect8(() => {
     if (state.error && onError) {
       onError(state.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koraidv/react",
-  "version": "1.7.9",
+  "version": "1.7.11",
   "description": "Kora IDV React Components for Identity Verification",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -21,7 +21,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@koraidv/core": "^1.7.9"
+    "@koraidv/core": "^1.7.11"
   },
   "devDependencies": {
     "@types/react": "^18.2.0",