@koraidv/core 1.7.11 → 1.8.1

package/dist/index.d.mts

@@ -147,6 +147,16 @@ interface Verification {
     updatedAt: Date;
     /** Completion timestamp */
     completedAt?: Date;
+    /**
+     * Integrator + SDK-supplied metadata persisted on the verification.
+     * The Web SDK sets `source: 'web'` here so the backend's source-
+     * aware threshold tuning (v1.8.0) and the SDK's source-aware
+     * display thresholds (v1.8.1) can both line up — without this
+     * round-trip, the SDK can't tell which thresholds the backend
+     * used and the ResultScreen "REVIEW" badge disagrees with the
+     * actual backend approval.
+     */
+    metadata?: Record<string, unknown>;
 }
 /**
  * Verification status
@@ -304,6 +314,14 @@ interface CreateVerificationRequest {
     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

package/dist/index.d.ts

@@ -147,6 +147,16 @@ interface Verification {
     updatedAt: Date;
     /** Completion timestamp */
     completedAt?: Date;
+    /**
+     * Integrator + SDK-supplied metadata persisted on the verification.
+     * The Web SDK sets `source: 'web'` here so the backend's source-
+     * aware threshold tuning (v1.8.0) and the SDK's source-aware
+     * display thresholds (v1.8.1) can both line up — without this
+     * round-trip, the SDK can't tell which thresholds the backend
+     * used and the ResultScreen "REVIEW" badge disagrees with the
+     * actual backend approval.
+     */
+    metadata?: Record<string, unknown>;
 }
 /**
  * Verification status
@@ -304,6 +314,14 @@ interface CreateVerificationRequest {
     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

package/dist/index.js

@@ -578,7 +578,19 @@ var ApiClient = class {
         // emitting empty strings (backend's name-match logic treats
         // "" as "user has no claimed name" same as missing).
         expectedFirstName: request.expectedFirstName,
-        expectedLastName: request.expectedLastName
+        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 ?? {}
+        }
       })
     });
   }
@@ -1009,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

@@ -534,7 +534,19 @@ var ApiClient = class {
         // emitting empty strings (backend's name-match logic treats
         // "" as "user has no claimed name" same as missing).
         expectedFirstName: request.expectedFirstName,
-        expectedLastName: request.expectedLastName
+        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 ?? {}
+        }
       })
     });
   }
@@ -965,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.11",
+  "version": "1.8.1",
   "description": "Kora IDV Core SDK - API Client and Utilities",
   "main": "dist/index.js",
   "module": "dist/index.mjs",