uqudosdk-web 3.4.2 → 3.6.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 3.6.0
+- Introduced support for Qatar Vehicle License.
+- Enhanced the facial recognition step to provide a smoother experience for end users.
+- Fixed an issue where the selfie output in facial recognition appeared squeezed on some devices.
+- Introduced support for the Analytics functionality. For more details, visit https://docs.uqudo.com/docs/kyc/uqudo-sdk/integration/web/analytics.
+
+## 3.5.0
+- Updated the facial recognition layout for desktop to address the issue on Windows where the default zoom is set to 150%. We've added and updated some styles: for a complete list, please refer to the style configuration documentation https://docs.uqudo.com/docs/kyc/uqudo-sdk/integration/web/ui-customisation/styles-configuration.
+- Enhanced the facial recognition layout for mobile and tablet. Fixed the oval's position, which sometimes misled users into placing their faces incorrectly.
+- Changed the image format to JPEG for the document photo-taking step.
+- Added virtual camera detection. If a virtual camera is detected, the SDK terminates the session with the error code MEDIA_VIRTUAL_CAMERA_DETECTED. For more details, see the operation error documentation https://docs.uqudo.com/docs/kyc/uqudo-sdk/integration/web/operation-error.
+
 ## 3.4.2
 
 - Introducing the new document type UAE_ID_DIGITAL aimed at clearly distinguishing between the digital and physical versions. If you want to accept the digital version, it is necessary to treat this as a separate document type in your configuration. It's important to note that starting from this version onwards, selecting the document type UAE_ID while the user provides the digital version will result in rejection. Likewise, selecting UAE_ID_DIGITAL while the user provides the physical version will yield the same outcome.

package/index.d.ts

@@ -39,6 +39,7 @@ export enum ErrorCode {
   MEDIA_NOT_ALLOWED_ERROR = "MEDIA_NOT_ALLOWED_ERROR",
   MEDIA_NOT_FOUND_ERROR = "MEDIA_NOT_FOUND_ERROR",
   MEDIA_SECURITY_ERROR = "MEDIA_SECURITY_ERROR",
+  MEDIA_VIRTUAL_CAMERA_DETECTED = "MEDIA_VIRTUAL_CAMERA_DETECTED",
   MEDIA_UNKNOWN_ERROR = "MEDIA_UNKNOWN_ERROR",
   USER_CANCEL = "USER_CANCEL",
   INVALID_CONFIG = "INVALID_CONFIG",
@@ -98,8 +99,8 @@ export enum DocumentType {
   SEN_ID = "SEN_ID",
   DZA_ID = "DZA_ID",
   TUR_ID = "TUR_ID",
-  COD_DL = "COD_DL",
   GBR_ID = "GBR_ID",
+  COD_DL = "COD_DL",
   COD_VOTER_ID = "COD_VOTER_ID",
   OMN_VL = "OMN_VL",
   OMN_DL = "OMN_DL",
@@ -114,6 +115,7 @@ export enum DocumentType {
   IRQ_ID = "IRQ_ID",
   MRZ = "MRZ",
   UAE_ID_DIGITAL = "UAE_ID_DIGITAL",
+  QAT_VL = "QAT_VL",
 }
 
 export enum BackgroundCheckType {
@@ -221,6 +223,7 @@ export type IObservableFunctionsType<R = IResultInfo, E = OperationError> = {
   onSuccess?: (result: R) => void;
   onError?: (error: E) => void;
   onFinally?: () => void;
+  onTrace?: TOnTrace;
 };
 
 export type IResource = {
@@ -297,3 +300,64 @@ export type IAccountRecoveryConfig = IConfigProcess &
     maxAttempts?: number;
     minimumMatchLevel?: number;
   };
+
+// ---------- Tracing mechanism type --------- //
+
+export enum TraceCategory {
+  ENROLLMENT = "ENROLLMENT",
+  FACE_SESSION = "FACE_SESSION",
+}
+
+export enum TracePage {
+  SCAN = "SCAN",
+  FACE = "FACE",
+  BACKGROUND_CHECK = "BACKGROUND_CHECK",
+}
+
+export enum TraceEvent {
+  VIEW = "VIEW",
+  START = "START",
+  IN_PROGRESS = "IN_PROGRESS",
+  SKIP = "SKIP",
+  COMPLETE = "COMPLETE",
+  FINISH = "FINISH",
+}
+
+export enum TraceStatus {
+  SUCCESS = "SUCCESS",
+  FAILURE = "FAILURE",
+}
+
+export enum TraceStatusCode {
+  USER_CANCEL = "USER_CANCEL",
+  SESSION_EXPIRED = "SESSION_EXPIRED",
+  UNEXPECTED_ERROR = "UNEXPECTED_ERROR",
+  CAMERA_NOT_AVAILABLE = "CAMERA_NOT_AVAILABLE",
+  CAMERA_PERMISSION_NOT_GRANTED = "CAMERA_PERMISSION_NOT_GRANTED",
+  SCAN_DOCUMENT_FRONT_PROCESSED = "SCAN_DOCUMENT_FRONT_PROCESSED",
+  SCAN_DOCUMENT_BACK_PROCESSED = "SCAN_DOCUMENT_BACK_PROCESSED",
+  SCAN_DOCUMENT_FRONT_BACK_MISMATCH = "SCAN_DOCUMENT_FRONT_BACK_MISMATCH",
+  SCAN_DOCUMENT_NOT_RECOGNIZED = "SCAN_DOCUMENT_NOT_RECOGNIZED",
+  SCAN_DOCUMENT_EXPIRED = "SCAN_DOCUMENT_EXPIRED",
+  SCAN_DOCUMENT_AGE_VERIFICATION_FAILED = "SCAN_DOCUMENT_AGE_VERIFICATION_FAILED",
+  FACE_LIVENESS_FAILED = "FACE_LIVENESS_FAILED",
+  FACE_NO_MATCH = "FACE_NO_MATCH",
+  FACE_TIMEOUT = "FACE_TIMEOUT",
+  FACE_RECOGNITION_TOO_MANY_ATTEMPTS = "FACE_RECOGNITION_TOO_MANY_ATTEMPTS",
+  FACE_INCORRECT_POSITION_DETECTED = "FACE_INCORRECT_POSITION_DETECTED",
+  FACE_INCORRECT_DISTANCE_DETECTED = "FACE_INCORRECT_DISTANCE_DETECTED",
+  FACE_EYES_CLOSED_DETECTED = "FACE_EYES_CLOSED_DETECTED",
+  MEDIA_VIRTUAL_CAMERA_DETECTED = "MEDIA_VIRTUAL_CAMERA_DETECTED",
+}
+
+export type ITrace = {
+  sessionId: string;
+  category: TraceCategory;
+  event: TraceEvent;
+  status: TraceStatus;
+  page?: TracePage;
+  statusCode?: TraceStatusCode;
+  statusMessage?: string;
+  documentType?: string;
+  timestamp: Date;
+};