@koraidv/core 1.5.0 → 1.5.1

package/dist/index.d.mts

@@ -135,6 +135,8 @@ interface Verification {
     faceVerification?: FaceVerification;
     /** Liveness verification result */
     livenessVerification?: LivenessVerification;
+    /** Per-feature score breakdown (0-100 scale) */
+    scores?: VerificationScores;
     /** Risk signals */
     riskSignals?: RiskSignal[];
     /** Overall risk score (0-100) */
@@ -189,6 +191,25 @@ interface ChallengeResult {
     passed: boolean;
     confidence: number;
 }
+/**
+ * Per-feature verification scores (0-100 scale).
+ *
+ * Mirrors the iOS / Android / Flutter SDKs so partners writing
+ * cross-platform code see the same shape on every platform. The single
+ * `overall` is the fused risk score (also exposed as `Verification.riskScore`
+ * at the top level for convenience). Individual feature scores let you
+ * drill into which check drove the result.
+ */
+interface VerificationScores {
+    documentQuality: number;
+    documentAuth: number;
+    faceMatch: number;
+    liveness: number;
+    nameMatch: number;
+    dataConsistency: number;
+    screening: number;
+    overall: number;
+}
 /**
  * Risk signal
  */
@@ -215,6 +236,10 @@ declare enum KoraErrorCode {
     RATE_LIMITED = "RATE_LIMITED",
     SERVER_ERROR = "SERVER_ERROR",
     HTTP_ERROR = "HTTP_ERROR",
+    INVALID_RESPONSE = "INVALID_RESPONSE",
+    NO_DATA = "NO_DATA",
+    DECODING_ERROR = "DECODING_ERROR",
+    ENCODING_ERROR = "ENCODING_ERROR",
     CAMERA_ACCESS_DENIED = "CAMERA_ACCESS_DENIED",
     CAMERA_NOT_AVAILABLE = "CAMERA_NOT_AVAILABLE",
     CAPTURE_FAILED = "CAPTURE_FAILED",
@@ -222,6 +247,8 @@ declare enum KoraErrorCode {
     DOCUMENT_NOT_DETECTED = "DOCUMENT_NOT_DETECTED",
     DOCUMENT_TYPE_NOT_SUPPORTED = "DOCUMENT_TYPE_NOT_SUPPORTED",
     MRZ_READ_FAILED = "MRZ_READ_FAILED",
+    NFC_NOT_AVAILABLE = "NFC_NOT_AVAILABLE",
+    NFC_READ_FAILED = "NFC_READ_FAILED",
     FACE_NOT_DETECTED = "FACE_NOT_DETECTED",
     MULTIPLE_FACES_DETECTED = "MULTIPLE_FACES_DETECTED",
     FACE_MATCH_FAILED = "FACE_MATCH_FAILED",
@@ -408,7 +435,7 @@ declare class KoraIDV {
     private currentVerification;
     private livenessSession;
     private sessionStartTime;
-    static readonly VERSION = "1.5.0";
+    static readonly VERSION = "1.5.1";
     constructor(config: Partial<Configuration> & {
         apiKey: string;
         tenantId: string;
@@ -1046,4 +1073,4 @@ declare const WalletPresentationBuilder: {
     decode(json: string): WalletPresentation;
 };
 
-export { ApiClient, type ChallengeResult, type ChallengeType, type Configuration, type CreateVerificationRequest, DisclosureClaim, type DisclosureProfile, DisclosureProfiles, type DocumentQualityResponse, DocumentType, type DocumentTypeInfo, type DocumentUploadResponse, type DocumentVerification, type Environment, type FaceVerification, type HandoffContext, type HandoffSession, KoraError, KoraErrorCode, KoraIDV, KoraWallet, type LivenessChallenge, type LivenessChallengeResponse, type LivenessMode, type LivenessSession, type LivenessVerification, type Locale, MrzParser, type QualityIssue$1 as QualityIssue, QualityValidator, type RiskSignal, type SelfieUploadResponse, type StoredWalletCredential, type SupportedCountry, type Theme, type Verification, type VerificationCallbacks, type VerificationOptions, type VerificationStatus, type VerificationStep, type WalletCredential, type WalletCredentialStatus, WalletCredentialStore, type WalletCredentialSubject, type WalletDataIntegrityProof, WalletError, type WalletPresentation, WalletPresentationBuilder, WebBarcodeScanner, applyDisclosure, blobToBase64, computeAgeOver18, createWalletCredential, getDocumentTypeInfo };
+export { ApiClient, type ChallengeResult, type ChallengeType, type Configuration, type CreateVerificationRequest, DisclosureClaim, type DisclosureProfile, DisclosureProfiles, type DocumentQualityResponse, DocumentType, type DocumentTypeInfo, type DocumentUploadResponse, type DocumentVerification, type Environment, type FaceVerification, type HandoffContext, type HandoffSession, KoraError, KoraErrorCode, KoraIDV, KoraWallet, type LivenessChallenge, type LivenessChallengeResponse, type LivenessMode, type LivenessSession, type LivenessVerification, type Locale, MrzParser, type QualityIssue$1 as QualityIssue, QualityValidator, type RiskSignal, type SelfieUploadResponse, type StoredWalletCredential, type SupportedCountry, type Theme, type Verification, type VerificationCallbacks, type VerificationOptions, type VerificationScores, type VerificationStatus, type VerificationStep, type WalletCredential, type WalletCredentialStatus, WalletCredentialStore, type WalletCredentialSubject, type WalletDataIntegrityProof, WalletError, type WalletPresentation, WalletPresentationBuilder, WebBarcodeScanner, applyDisclosure, blobToBase64, computeAgeOver18, createWalletCredential, getDocumentTypeInfo };

package/dist/index.d.ts

@@ -135,6 +135,8 @@ interface Verification {
     faceVerification?: FaceVerification;
     /** Liveness verification result */
     livenessVerification?: LivenessVerification;
+    /** Per-feature score breakdown (0-100 scale) */
+    scores?: VerificationScores;
     /** Risk signals */
     riskSignals?: RiskSignal[];
     /** Overall risk score (0-100) */
@@ -189,6 +191,25 @@ interface ChallengeResult {
     passed: boolean;
     confidence: number;
 }
+/**
+ * Per-feature verification scores (0-100 scale).
+ *
+ * Mirrors the iOS / Android / Flutter SDKs so partners writing
+ * cross-platform code see the same shape on every platform. The single
+ * `overall` is the fused risk score (also exposed as `Verification.riskScore`
+ * at the top level for convenience). Individual feature scores let you
+ * drill into which check drove the result.
+ */
+interface VerificationScores {
+    documentQuality: number;
+    documentAuth: number;
+    faceMatch: number;
+    liveness: number;
+    nameMatch: number;
+    dataConsistency: number;
+    screening: number;
+    overall: number;
+}
 /**
  * Risk signal
  */
@@ -215,6 +236,10 @@ declare enum KoraErrorCode {
     RATE_LIMITED = "RATE_LIMITED",
     SERVER_ERROR = "SERVER_ERROR",
     HTTP_ERROR = "HTTP_ERROR",
+    INVALID_RESPONSE = "INVALID_RESPONSE",
+    NO_DATA = "NO_DATA",
+    DECODING_ERROR = "DECODING_ERROR",
+    ENCODING_ERROR = "ENCODING_ERROR",
     CAMERA_ACCESS_DENIED = "CAMERA_ACCESS_DENIED",
     CAMERA_NOT_AVAILABLE = "CAMERA_NOT_AVAILABLE",
     CAPTURE_FAILED = "CAPTURE_FAILED",
@@ -222,6 +247,8 @@ declare enum KoraErrorCode {
     DOCUMENT_NOT_DETECTED = "DOCUMENT_NOT_DETECTED",
     DOCUMENT_TYPE_NOT_SUPPORTED = "DOCUMENT_TYPE_NOT_SUPPORTED",
     MRZ_READ_FAILED = "MRZ_READ_FAILED",
+    NFC_NOT_AVAILABLE = "NFC_NOT_AVAILABLE",
+    NFC_READ_FAILED = "NFC_READ_FAILED",
     FACE_NOT_DETECTED = "FACE_NOT_DETECTED",
     MULTIPLE_FACES_DETECTED = "MULTIPLE_FACES_DETECTED",
     FACE_MATCH_FAILED = "FACE_MATCH_FAILED",
@@ -408,7 +435,7 @@ declare class KoraIDV {
     private currentVerification;
     private livenessSession;
     private sessionStartTime;
-    static readonly VERSION = "1.5.0";
+    static readonly VERSION = "1.5.1";
     constructor(config: Partial<Configuration> & {
         apiKey: string;
         tenantId: string;
@@ -1046,4 +1073,4 @@ declare const WalletPresentationBuilder: {
     decode(json: string): WalletPresentation;
 };
 
-export { ApiClient, type ChallengeResult, type ChallengeType, type Configuration, type CreateVerificationRequest, DisclosureClaim, type DisclosureProfile, DisclosureProfiles, type DocumentQualityResponse, DocumentType, type DocumentTypeInfo, type DocumentUploadResponse, type DocumentVerification, type Environment, type FaceVerification, type HandoffContext, type HandoffSession, KoraError, KoraErrorCode, KoraIDV, KoraWallet, type LivenessChallenge, type LivenessChallengeResponse, type LivenessMode, type LivenessSession, type LivenessVerification, type Locale, MrzParser, type QualityIssue$1 as QualityIssue, QualityValidator, type RiskSignal, type SelfieUploadResponse, type StoredWalletCredential, type SupportedCountry, type Theme, type Verification, type VerificationCallbacks, type VerificationOptions, type VerificationStatus, type VerificationStep, type WalletCredential, type WalletCredentialStatus, WalletCredentialStore, type WalletCredentialSubject, type WalletDataIntegrityProof, WalletError, type WalletPresentation, WalletPresentationBuilder, WebBarcodeScanner, applyDisclosure, blobToBase64, computeAgeOver18, createWalletCredential, getDocumentTypeInfo };
+export { ApiClient, type ChallengeResult, type ChallengeType, type Configuration, type CreateVerificationRequest, DisclosureClaim, type DisclosureProfile, DisclosureProfiles, type DocumentQualityResponse, DocumentType, type DocumentTypeInfo, type DocumentUploadResponse, type DocumentVerification, type Environment, type FaceVerification, type HandoffContext, type HandoffSession, KoraError, KoraErrorCode, KoraIDV, KoraWallet, type LivenessChallenge, type LivenessChallengeResponse, type LivenessMode, type LivenessSession, type LivenessVerification, type Locale, MrzParser, type QualityIssue$1 as QualityIssue, QualityValidator, type RiskSignal, type SelfieUploadResponse, type StoredWalletCredential, type SupportedCountry, type Theme, type Verification, type VerificationCallbacks, type VerificationOptions, type VerificationScores, type VerificationStatus, type VerificationStep, type WalletCredential, type WalletCredentialStatus, WalletCredentialStore, type WalletCredentialSubject, type WalletDataIntegrityProof, WalletError, type WalletPresentation, WalletPresentationBuilder, WebBarcodeScanner, applyDisclosure, blobToBase64, computeAgeOver18, createWalletCredential, getDocumentTypeInfo };

package/dist/index.js

@@ -386,6 +386,10 @@ var KoraErrorCode = /* @__PURE__ */ ((KoraErrorCode2) => {
   KoraErrorCode2["RATE_LIMITED"] = "RATE_LIMITED";
   KoraErrorCode2["SERVER_ERROR"] = "SERVER_ERROR";
   KoraErrorCode2["HTTP_ERROR"] = "HTTP_ERROR";
+  KoraErrorCode2["INVALID_RESPONSE"] = "INVALID_RESPONSE";
+  KoraErrorCode2["NO_DATA"] = "NO_DATA";
+  KoraErrorCode2["DECODING_ERROR"] = "DECODING_ERROR";
+  KoraErrorCode2["ENCODING_ERROR"] = "ENCODING_ERROR";
   KoraErrorCode2["CAMERA_ACCESS_DENIED"] = "CAMERA_ACCESS_DENIED";
   KoraErrorCode2["CAMERA_NOT_AVAILABLE"] = "CAMERA_NOT_AVAILABLE";
   KoraErrorCode2["CAPTURE_FAILED"] = "CAPTURE_FAILED";
@@ -393,6 +397,8 @@ var KoraErrorCode = /* @__PURE__ */ ((KoraErrorCode2) => {
   KoraErrorCode2["DOCUMENT_NOT_DETECTED"] = "DOCUMENT_NOT_DETECTED";
   KoraErrorCode2["DOCUMENT_TYPE_NOT_SUPPORTED"] = "DOCUMENT_TYPE_NOT_SUPPORTED";
   KoraErrorCode2["MRZ_READ_FAILED"] = "MRZ_READ_FAILED";
+  KoraErrorCode2["NFC_NOT_AVAILABLE"] = "NFC_NOT_AVAILABLE";
+  KoraErrorCode2["NFC_READ_FAILED"] = "NFC_READ_FAILED";
   KoraErrorCode2["FACE_NOT_DETECTED"] = "FACE_NOT_DETECTED";
   KoraErrorCode2["MULTIPLE_FACES_DETECTED"] = "MULTIPLE_FACES_DETECTED";
   KoraErrorCode2["FACE_MATCH_FAILED"] = "FACE_MATCH_FAILED";
@@ -420,6 +426,10 @@ var errorMessages = {
   ["RATE_LIMITED" /* RATE_LIMITED */]: "Rate limit exceeded. Please try again later.",
   ["SERVER_ERROR" /* SERVER_ERROR */]: "Server error. Please try again later.",
   ["HTTP_ERROR" /* HTTP_ERROR */]: "HTTP error occurred.",
+  ["INVALID_RESPONSE" /* INVALID_RESPONSE */]: "The server returned an invalid response.",
+  ["NO_DATA" /* NO_DATA */]: "No response data received.",
+  ["DECODING_ERROR" /* DECODING_ERROR */]: "Failed to decode the server response.",
+  ["ENCODING_ERROR" /* ENCODING_ERROR */]: "Failed to encode the request.",
   ["CAMERA_ACCESS_DENIED" /* CAMERA_ACCESS_DENIED */]: "Camera access denied. Please enable camera access.",
   ["CAMERA_NOT_AVAILABLE" /* CAMERA_NOT_AVAILABLE */]: "Camera not available on this device.",
   ["CAPTURE_FAILED" /* CAPTURE_FAILED */]: "Capture failed.",
@@ -427,6 +437,8 @@ var errorMessages = {
   ["DOCUMENT_NOT_DETECTED" /* DOCUMENT_NOT_DETECTED */]: "Document not detected. Position document in frame.",
   ["DOCUMENT_TYPE_NOT_SUPPORTED" /* DOCUMENT_TYPE_NOT_SUPPORTED */]: "Document type not supported.",
   ["MRZ_READ_FAILED" /* MRZ_READ_FAILED */]: "Could not read document MRZ.",
+  ["NFC_NOT_AVAILABLE" /* NFC_NOT_AVAILABLE */]: "NFC is not available on this device.",
+  ["NFC_READ_FAILED" /* NFC_READ_FAILED */]: "NFC read failed. Hold device steady against the chip.",
   ["FACE_NOT_DETECTED" /* FACE_NOT_DETECTED */]: "Face not detected. Position face in frame.",
   ["MULTIPLE_FACES_DETECTED" /* MULTIPLE_FACES_DETECTED */]: "Multiple faces detected. Show only one face.",
   ["FACE_MATCH_FAILED" /* FACE_MATCH_FAILED */]: "Face match failed.",
@@ -976,7 +988,7 @@ var KoraIDV = class {
     }
   }
 };
-KoraIDV.VERSION = "1.5.0";
+KoraIDV.VERSION = "1.5.1";
 
 // src/utils/QualityValidator.ts
 var defaultThresholds = {

package/dist/index.mjs

@@ -342,6 +342,10 @@ var KoraErrorCode = /* @__PURE__ */ ((KoraErrorCode2) => {
   KoraErrorCode2["RATE_LIMITED"] = "RATE_LIMITED";
   KoraErrorCode2["SERVER_ERROR"] = "SERVER_ERROR";
   KoraErrorCode2["HTTP_ERROR"] = "HTTP_ERROR";
+  KoraErrorCode2["INVALID_RESPONSE"] = "INVALID_RESPONSE";
+  KoraErrorCode2["NO_DATA"] = "NO_DATA";
+  KoraErrorCode2["DECODING_ERROR"] = "DECODING_ERROR";
+  KoraErrorCode2["ENCODING_ERROR"] = "ENCODING_ERROR";
   KoraErrorCode2["CAMERA_ACCESS_DENIED"] = "CAMERA_ACCESS_DENIED";
   KoraErrorCode2["CAMERA_NOT_AVAILABLE"] = "CAMERA_NOT_AVAILABLE";
   KoraErrorCode2["CAPTURE_FAILED"] = "CAPTURE_FAILED";
@@ -349,6 +353,8 @@ var KoraErrorCode = /* @__PURE__ */ ((KoraErrorCode2) => {
   KoraErrorCode2["DOCUMENT_NOT_DETECTED"] = "DOCUMENT_NOT_DETECTED";
   KoraErrorCode2["DOCUMENT_TYPE_NOT_SUPPORTED"] = "DOCUMENT_TYPE_NOT_SUPPORTED";
   KoraErrorCode2["MRZ_READ_FAILED"] = "MRZ_READ_FAILED";
+  KoraErrorCode2["NFC_NOT_AVAILABLE"] = "NFC_NOT_AVAILABLE";
+  KoraErrorCode2["NFC_READ_FAILED"] = "NFC_READ_FAILED";
   KoraErrorCode2["FACE_NOT_DETECTED"] = "FACE_NOT_DETECTED";
   KoraErrorCode2["MULTIPLE_FACES_DETECTED"] = "MULTIPLE_FACES_DETECTED";
   KoraErrorCode2["FACE_MATCH_FAILED"] = "FACE_MATCH_FAILED";
@@ -376,6 +382,10 @@ var errorMessages = {
   ["RATE_LIMITED" /* RATE_LIMITED */]: "Rate limit exceeded. Please try again later.",
   ["SERVER_ERROR" /* SERVER_ERROR */]: "Server error. Please try again later.",
   ["HTTP_ERROR" /* HTTP_ERROR */]: "HTTP error occurred.",
+  ["INVALID_RESPONSE" /* INVALID_RESPONSE */]: "The server returned an invalid response.",
+  ["NO_DATA" /* NO_DATA */]: "No response data received.",
+  ["DECODING_ERROR" /* DECODING_ERROR */]: "Failed to decode the server response.",
+  ["ENCODING_ERROR" /* ENCODING_ERROR */]: "Failed to encode the request.",
   ["CAMERA_ACCESS_DENIED" /* CAMERA_ACCESS_DENIED */]: "Camera access denied. Please enable camera access.",
   ["CAMERA_NOT_AVAILABLE" /* CAMERA_NOT_AVAILABLE */]: "Camera not available on this device.",
   ["CAPTURE_FAILED" /* CAPTURE_FAILED */]: "Capture failed.",
@@ -383,6 +393,8 @@ var errorMessages = {
   ["DOCUMENT_NOT_DETECTED" /* DOCUMENT_NOT_DETECTED */]: "Document not detected. Position document in frame.",
   ["DOCUMENT_TYPE_NOT_SUPPORTED" /* DOCUMENT_TYPE_NOT_SUPPORTED */]: "Document type not supported.",
   ["MRZ_READ_FAILED" /* MRZ_READ_FAILED */]: "Could not read document MRZ.",
+  ["NFC_NOT_AVAILABLE" /* NFC_NOT_AVAILABLE */]: "NFC is not available on this device.",
+  ["NFC_READ_FAILED" /* NFC_READ_FAILED */]: "NFC read failed. Hold device steady against the chip.",
   ["FACE_NOT_DETECTED" /* FACE_NOT_DETECTED */]: "Face not detected. Position face in frame.",
   ["MULTIPLE_FACES_DETECTED" /* MULTIPLE_FACES_DETECTED */]: "Multiple faces detected. Show only one face.",
   ["FACE_MATCH_FAILED" /* FACE_MATCH_FAILED */]: "Face match failed.",
@@ -932,7 +944,7 @@ var KoraIDV = class {
     }
   }
 };
-KoraIDV.VERSION = "1.5.0";
+KoraIDV.VERSION = "1.5.1";
 
 // src/utils/QualityValidator.ts
 var defaultThresholds = {

package/package.json

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