@koraidv/core 1.7.10 → 1.8.0

package/dist/index.d.mts

@@ -292,6 +292,26 @@ declare class KoraError extends Error {
 interface CreateVerificationRequest {
     externalId: string;
     tier: string;
+    /**
+     * Expected first name for name-match scoring. When set, the backend
+     * compares the OCR'd given name on the document against this value
+     * and surfaces a real `scores.nameMatch` percentage; when unset,
+     * nameMatch is 0 and the ResultScreen's "Name Match" row shows FAIL
+     * on otherwise-approved verifications. Optional — integrators that
+     * don't have the user's claimed legal name (or don't care) can
+     * omit. Mirrors iOS's `CreateVerificationRequest.expectedFirstName`.
+     */
+    expectedFirstName?: string;
+    /** Expected last name. See `expectedFirstName` for semantics. */
+    expectedLastName?: string;
+    /**
+     * Optional integrator-supplied metadata. The Web SDK ALWAYS adds
+     * `source: 'web'` so the backend's source-aware threshold tuning
+     * (v1.8.0+) can apply the right floors for webcam-captured selfies.
+     * Anything the integrator passes here is merged on top of the
+     * SDK-set `source` key.
+     */
+    metadata?: Record<string, unknown>;
 }
 /**
  * Document upload response
@@ -421,6 +441,14 @@ interface VerificationOptions {
     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.
+     * Mirrors iOS's startVerification(expectedFirstName:expectedLastName:).
+     */
+    expectedFirstName?: string;
+    expectedLastName?: string;
 }
 /**
  * Verification step

package/dist/index.d.ts

@@ -292,6 +292,26 @@ declare class KoraError extends Error {
 interface CreateVerificationRequest {
     externalId: string;
     tier: string;
+    /**
+     * Expected first name for name-match scoring. When set, the backend
+     * compares the OCR'd given name on the document against this value
+     * and surfaces a real `scores.nameMatch` percentage; when unset,
+     * nameMatch is 0 and the ResultScreen's "Name Match" row shows FAIL
+     * on otherwise-approved verifications. Optional — integrators that
+     * don't have the user's claimed legal name (or don't care) can
+     * omit. Mirrors iOS's `CreateVerificationRequest.expectedFirstName`.
+     */
+    expectedFirstName?: string;
+    /** Expected last name. See `expectedFirstName` for semantics. */
+    expectedLastName?: string;
+    /**
+     * Optional integrator-supplied metadata. The Web SDK ALWAYS adds
+     * `source: 'web'` so the backend's source-aware threshold tuning
+     * (v1.8.0+) can apply the right floors for webcam-captured selfies.
+     * Anything the integrator passes here is merged on top of the
+     * SDK-set `source` key.
+     */
+    metadata?: Record<string, unknown>;
 }
 /**
  * Document upload response
@@ -421,6 +441,14 @@ interface VerificationOptions {
     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.
+     * Mirrors iOS's startVerification(expectedFirstName:expectedLastName:).
+     */
+    expectedFirstName?: string;
+    expectedLastName?: string;
 }
 /**
  * Verification step

package/dist/index.js

@@ -572,7 +572,25 @@ var ApiClient = class {
       method: "POST",
       body: JSON.stringify({
         externalId: request.externalId,
-        tier: request.tier
+        tier: request.tier,
+        // Optional name-match inputs — only sent when the integrator
+        // provided them, so older call sites don't accidentally start
+        // emitting empty strings (backend's name-match logic treats
+        // "" as "user has no claimed name" same as missing).
+        expectedFirstName: request.expectedFirstName,
+        expectedLastName: request.expectedLastName,
+        // Source signal for backend's source-aware threshold tuning
+        // (v1.8.0). Backend's EffectiveForSource(source) relaxes the
+        // MinFaceMatchScore + MinLivenessScore floors by 10 each when
+        // source="web" — webcam captures consistently score lower than
+        // native mobile camera captures, and the strict mobile-
+        // calibrated floor false-rejects perfectly real users. Carried
+        // in `metadata` to avoid a schema migration on the backend;
+        // any other integrator-supplied metadata is merged on top.
+        metadata: {
+          source: "web",
+          ...request.metadata ?? {}
+        }
       })
     });
   }
@@ -916,7 +934,9 @@ var KoraIDV = class {
       this.sessionStartTime = /* @__PURE__ */ new Date();
       const verification = await this.apiClient.createVerification({
         externalId: options.externalId,
-        tier: options.tier ?? "standard"
+        tier: options.tier ?? "standard",
+        expectedFirstName: options.expectedFirstName,
+        expectedLastName: options.expectedLastName
       });
       this.currentVerification = verification;
       callbacks.onStepChange?.("consent");
@@ -1001,8 +1021,8 @@ var KoraIDV = class {
       imageData
     );
     return {
-      passed: response.challengePassed,
-      remainingChallenges: response.remainingChallenges
+      passed: response.challengePassed ?? false,
+      remainingChallenges: response.remainingChallenges ?? 0
     };
   }
   /**

package/dist/index.mjs

@@ -528,7 +528,25 @@ var ApiClient = class {
       method: "POST",
       body: JSON.stringify({
         externalId: request.externalId,
-        tier: request.tier
+        tier: request.tier,
+        // Optional name-match inputs — only sent when the integrator
+        // provided them, so older call sites don't accidentally start
+        // emitting empty strings (backend's name-match logic treats
+        // "" as "user has no claimed name" same as missing).
+        expectedFirstName: request.expectedFirstName,
+        expectedLastName: request.expectedLastName,
+        // Source signal for backend's source-aware threshold tuning
+        // (v1.8.0). Backend's EffectiveForSource(source) relaxes the
+        // MinFaceMatchScore + MinLivenessScore floors by 10 each when
+        // source="web" — webcam captures consistently score lower than
+        // native mobile camera captures, and the strict mobile-
+        // calibrated floor false-rejects perfectly real users. Carried
+        // in `metadata` to avoid a schema migration on the backend;
+        // any other integrator-supplied metadata is merged on top.
+        metadata: {
+          source: "web",
+          ...request.metadata ?? {}
+        }
       })
     });
   }
@@ -872,7 +890,9 @@ var KoraIDV = class {
       this.sessionStartTime = /* @__PURE__ */ new Date();
       const verification = await this.apiClient.createVerification({
         externalId: options.externalId,
-        tier: options.tier ?? "standard"
+        tier: options.tier ?? "standard",
+        expectedFirstName: options.expectedFirstName,
+        expectedLastName: options.expectedLastName
       });
       this.currentVerification = verification;
       callbacks.onStepChange?.("consent");
@@ -957,8 +977,8 @@ var KoraIDV = class {
       imageData
     );
     return {
-      passed: response.challengePassed,
-      remainingChallenges: response.remainingChallenges
+      passed: response.challengePassed ?? false,
+      remainingChallenges: response.remainingChallenges ?? 0
     };
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koraidv/core",
-  "version": "1.7.10",
+  "version": "1.8.0",
   "description": "Kora IDV Core SDK - API Client and Utilities",
   "main": "dist/index.js",
   "module": "dist/index.mjs",