@trustchex/react-native-sdk 1.374.0 → 1.381.0

package/lib/module/Shared/Components/IdentityDocumentCamera.types.js

@@ -0,0 +1,3 @@
+"use strict";
+
+export {};

package/lib/module/Shared/Components/IdentityDocumentCamera.utils.js

@@ -0,0 +1,273 @@
+"use strict";
+
+import { Dimensions } from 'react-native';
+import { SIGNATURE_REGEX, PASSPORT_MRZ_PATTERN } from "./IdentityDocumentCamera.constants.js";
+import { debugLog, isDebugEnabled } from "../Libs/debug.utils.js";
+
+/**
+ * Frame-to-screen coordinate transform using FILL_CENTER scaling
+ */
+export function getFrameToScreenTransform(frameWidth, frameHeight) {
+  const screen = Dimensions.get('window');
+  const frameAspect = frameWidth / frameHeight;
+  const screenAspect = screen.width / screen.height;
+  let scale;
+  let offsetX = 0;
+  let offsetY = 0;
+  if (frameAspect > screenAspect) {
+    scale = screen.height / frameHeight;
+    offsetX = (frameWidth * scale - screen.width) / 2;
+  } else {
+    scale = screen.width / frameWidth;
+    offsetY = (frameHeight * scale - screen.height) / 2;
+  }
+  return {
+    scale,
+    offsetX,
+    offsetY,
+    screen
+  };
+}
+
+/**
+ * Compute scan area bounds in frame coordinates
+ */
+export function getScanAreaBounds(frameWidth, frameHeight) {
+  const {
+    scale,
+    offsetX,
+    offsetY,
+    screen
+  } = getFrameToScreenTransform(frameWidth, frameHeight);
+  const scanLeft = (screen.width * 0.05 + offsetX) / scale;
+  const scanTop = (screen.height * 0.36 + offsetY) / scale;
+  const scanRight = (screen.width * 0.95 + offsetX) / scale;
+  const scanBottom = (screen.height * 0.64 + offsetY) / scale;
+  const isInsideScan = (x, y, w, h) => x >= scanLeft && y >= scanTop && x + w <= scanRight && y + h <= scanBottom;
+  return {
+    scanLeft,
+    scanTop,
+    scanRight,
+    scanBottom,
+    isInsideScan
+  };
+}
+
+/**
+ * Transform frame-space bounds to screen-space bounds
+ */
+export function transformBoundsToScreen(bounds, scale, offsetX, offsetY) {
+  return {
+    x: bounds.x * scale - offsetX,
+    y: bounds.y * scale - offsetY,
+    width: bounds.width * scale,
+    height: bounds.height * scale
+  };
+}
+
+/**
+ * Unified status message logic used by both voice guidance and render text.
+ * Returns the appropriate i18n key arguments for the current scan state.
+ */
+export function getStatusMessage(nextStep, status, detectedDocumentType, isBrightnessLow, isFrameBlurry, allElementsDetected, elementsOutsideScanArea, t) {
+  if (nextStep === 'COMPLETED') {
+    return t('identityDocumentCamera.scanCompleted');
+  }
+  if (status === 'INCORRECT') {
+    if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT') {
+      return t('identityDocumentCamera.alignIDFront');
+    }
+    if (nextStep === 'SCAN_ID_BACK') {
+      return t('identityDocumentCamera.alignIDBack');
+    }
+    if (nextStep === 'SCAN_HOLOGRAM') {
+      return t('identityDocumentCamera.alignIDFront');
+    }
+    return t('identityDocumentCamera.alignPhotoSide');
+  }
+  if (isBrightnessLow) {
+    return t('identityDocumentCamera.lowBrightness');
+  }
+  if (isFrameBlurry) {
+    return t('identityDocumentCamera.avoidBlur');
+  }
+  if (status === 'SCANNING' && allElementsDetected && elementsOutsideScanArea.length === 0) {
+    if (nextStep === 'SCAN_ID_BACK') {
+      return t('identityDocumentCamera.idCardBackDetected');
+    }
+    if (detectedDocumentType === 'PASSPORT') {
+      return t('identityDocumentCamera.passportDetected');
+    }
+    if (detectedDocumentType === 'ID_FRONT') {
+      return t('identityDocumentCamera.idCardFrontDetected');
+    }
+    if (nextStep === 'SCAN_HOLOGRAM') {
+      return t('identityDocumentCamera.alignHologram');
+    }
+    return t('identityDocumentCamera.readingDocument');
+  }
+  if (elementsOutsideScanArea.length > 0) {
+    return t('identityDocumentCamera.centerDocument');
+  }
+  if ((status === 'SCANNING' || status === 'SEARCHING') && !allElementsDetected) {
+    if (nextStep === 'SCAN_ID_BACK') {
+      return t('identityDocumentCamera.alignIDBack');
+    }
+    if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT') {
+      if (detectedDocumentType === 'PASSPORT') {
+        return t('identityDocumentCamera.alignPassport');
+      }
+      if (detectedDocumentType === 'ID_FRONT') {
+        return t('identityDocumentCamera.alignIDFront');
+      }
+      return t('identityDocumentCamera.alignPhotoSide');
+    }
+    if (nextStep === 'SCAN_HOLOGRAM') {
+      return t('identityDocumentCamera.alignHologram');
+    }
+    return t('identityDocumentCamera.readingDocument');
+  }
+
+  // Default fallback
+  if (nextStep === 'SCAN_ID_FRONT_OR_PASSPORT') {
+    return status === 'SCANNING' ? t('identityDocumentCamera.readingDocument') : t('identityDocumentCamera.alignPhotoSide');
+  }
+  if (nextStep === 'SCAN_HOLOGRAM') {
+    return t('identityDocumentCamera.alignHologram');
+  }
+  if (nextStep === 'SCAN_ID_BACK') {
+    return status === 'SCANNING' ? t('identityDocumentCamera.readingDocument') : t('identityDocumentCamera.alignIDBackSide');
+  }
+  return '';
+}
+
+/**
+ * Calculate angle from two points in degrees
+ */
+export function angleBetweenPoints(p1, p2) {
+  const dx = p2.x - p1.x;
+  const dy = p2.y - p1.y;
+  return Math.atan2(dy, dx) * (180 / Math.PI);
+}
+
+/**
+ * Calculate distance between two points
+ */
+export function distanceBetweenPoints(p1, p2) {
+  const dx = p2.x - p1.x;
+  const dy = p2.y - p1.y;
+  return Math.sqrt(dx * dx + dy * dy);
+}
+
+/**
+ * Detect document type based on faces, OCR text, and MRZ fields
+ */
+export function detectDocumentType(faces, ocrText, mrzFields, frameWidth, mrzText) {
+  // Relaxed signature detection: matches signature/imza variants and OCR errors
+  const hasSignatureMatch = SIGNATURE_REGEX.test(ocrText);
+  if (isDebugEnabled()) {
+    debugLog('IdentityDocumentCamera.utils', '[DocType] Detection', {
+      faces: faces.length,
+      hasMRZ: !!mrzFields,
+      hasMRZText: !!mrzText,
+      textLength: ocrText?.length,
+      hasSignature: hasSignatureMatch
+    });
+  }
+
+  // ID Back: no face + ID MRZ
+  if (faces.length === 0 && mrzFields?.documentCode === 'I') {
+    return 'ID_BACK';
+  }
+
+  // Passport: face + passport MRZ
+  if (faces.length > 0 && mrzFields?.documentCode === 'P') {
+    return 'PASSPORT';
+  }
+
+  // Check for PASSPORT MRZ pattern BEFORE classifying as ID_FRONT
+  // Both passports and ID cards have face + signature, so we MUST check MRZ first
+  // Check BOTH parsed mrzText AND raw ocrText — MRZ parsing can fail while
+  // the raw OCR still contains P<TUR/P<USA pattern
+  const hasPassportMRZPattern = mrzText && mrzText.length > 20 && PASSPORT_MRZ_PATTERN.test(mrzText) || PASSPORT_MRZ_PATTERN.test(ocrText);
+  if (hasPassportMRZPattern) {
+    // Passport MRZ pattern detected (P<TUR, P<USA, etc.)
+    // Even if not fully parsed, this is definitely a passport, not ID card
+    return 'PASSPORT';
+  }
+
+  // ID Front: face detected
+  // CRITICAL: Only classify as ID_FRONT when we're confident it's NOT a passport
+  // This means we must have either:
+  // 1. MRZ code 'I' (definitive ID card), OR
+  // 2. Face + signature but NO passport MRZ pattern visible
+  if (faces.length > 0 && ocrText?.length >= 5) {
+    // Filter to card-sized faces only (min 5% of frame width to exclude tiny background faces)
+    const cardSizedFaces = frameWidth ? faces.filter(face => face.bounds.width >= frameWidth * 0.05 && face.bounds.height >= frameWidth * 0.05) : faces;
+    if (cardSizedFaces.length > 0) {
+      // If we have MRZ code 'I', it's definitely an ID card
+      if (mrzFields?.documentCode === 'I') {
+        return 'ID_FRONT';
+      }
+
+      // If signature present and NO passport MRZ pattern, likely ID_FRONT
+      // But we can't be 100% sure yet - passport MRZ might appear in next frames
+      const hasSignature = hasSignatureMatch;
+      if (hasSignature && !hasPassportMRZPattern) {
+        return 'ID_FRONT';
+      }
+    }
+  }
+  return 'UNKNOWN';
+}
+
+/**
+ * Determine the document type to set based on current frame analysis
+ * Handles correction of misdetections and passport pattern checking
+ */
+export function determineDocumentTypeToSet(documentType, cardSizedFaces, parsedMRZFields, mrzText) {
+  // CRITICAL: Passport MRZ always takes precedence over other detections
+  const hasPassportMRZ = mrzText && mrzText.length > 20 && PASSPORT_MRZ_PATTERN.test(mrzText) || parsedMRZFields?.documentCode === 'P';
+  if (hasPassportMRZ) {
+    return 'PASSPORT';
+  }
+
+  // After passport MRZ check, accept the detected type directly
+  if (documentType === 'PASSPORT') return 'PASSPORT';
+  if (documentType === 'ID_FRONT') return 'ID_FRONT';
+  return 'UNKNOWN';
+}
+
+/**
+ * Compare MRZ field values (ignore raw text variations)
+ */
+export function areMRZFieldsEqual(fields1, fields2) {
+  if (!fields1 || !fields2) return false;
+  // Compare critical fields that define document identity
+  return fields1.documentNumber === fields2.documentNumber && fields1.birthDate === fields2.birthDate && fields1.expirationDate === fields2.expirationDate && fields1.firstName === fields2.firstName && fields1.lastName === fields2.lastName && fields1.issuingState === fields2.issuingState;
+}
+
+/**
+ * Check if all required MRZ fields are present
+ */
+export function hasRequiredMRZFields(fields) {
+  return !!fields?.firstName && !!fields?.lastName && !!fields?.documentNumber && !!fields?.birthDate;
+}
+
+/**
+ * Validate if face position has changed within acceptable tolerance
+ * Returns true if position is valid (within tolerance)
+ */
+export function validateFacePosition(currentBounds, referenceBounds, isHologramStep) {
+  const xDiff = Math.abs(currentBounds.x - referenceBounds.x);
+  const yDiff = Math.abs(currentBounds.y - referenceBounds.y);
+  const widthDiff = Math.abs(currentBounds.width - referenceBounds.width);
+  const heightDiff = Math.abs(currentBounds.height - referenceBounds.height);
+
+  // Use looser tolerance during hologram step since flash toggling causes position jitter
+  const tolerance = isHologramStep ? 0.5 : 0.2;
+  const xTolerance = referenceBounds.width * tolerance;
+  const yTolerance = referenceBounds.height * tolerance;
+  const sizeTolerance = referenceBounds.width * tolerance;
+  return xDiff <= xTolerance && yDiff <= yTolerance && widthDiff <= sizeTolerance && heightDiff <= sizeTolerance;
+}

package/lib/module/version.js

@@ -2,4 +2,4 @@
 
 // This file is auto-generated. Do not edit manually.
 // Version is synced from package.json during build.
-export const SDK_VERSION = '1.374.0';
+export const SDK_VERSION = '1.381.0';

package/lib/typescript/src/Shared/Components/DebugOverlay.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { ScanStep, ScanStatus, DocumentType, BoundsWithRotation, BoundsWithAngle } from './IdentityDocumentCamera.types';
+export interface DebugOverlayProps {
+    nextStep: ScanStep;
+    status: ScanStatus;
+    detectedDocumentType: DocumentType;
+    isBrightnessLow: boolean;
+    isFrameBlurry: boolean;
+    isTorchOn: boolean;
+    documentPlaneBounds: BoundsWithRotation | null;
+    secondaryFaceBounds: BoundsWithRotation | null;
+    barcodeBounds: BoundsWithAngle | null;
+    mrzBounds: BoundsWithAngle | null;
+    signatureBounds: BoundsWithAngle | null;
+    currentFaceImage?: string;
+    currentSecondaryFaceImage?: string;
+    currentHologramImage?: string;
+    currentHologramMaskImage?: string;
+    latestHologramFaceImage?: string;
+    hologramImageCount: number;
+    allElementsDetected: boolean;
+    elementsOutsideScanArea: string[];
+}
+declare const DebugOverlay: React.NamedExoticComponent<DebugOverlayProps>;
+export interface TestModePanelProps {
+    mrzText: string;
+}
+export declare const TestModePanel: React.NamedExoticComponent<TestModePanelProps>;
+export default DebugOverlay;
+//# sourceMappingURL=DebugOverlay.d.ts.map

package/lib/typescript/src/Shared/Components/DebugOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugOverlay.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/DebugOverlay.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EAChB,MAAM,gCAAgC,CAAC;AA2PxC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,oBAAoB,EAAE,YAAY,CAAC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/C,mBAAmB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/C,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uBAAuB,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,QAAA,MAAM,YAAY,+CAyThB,CAAC;AAIH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,gDAiDxB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.constants.d.ts

@@ -0,0 +1,35 @@
+export declare const HOLOGRAM_IMAGE_COUNT = 16;
+export declare const HOLOGRAM_DETECTION_THRESHOLD = 1000;
+export declare const HOLOGRAM_DETECTION_RETRY_COUNT = 3;
+export declare const HOLOGRAM_CAPTURE_INTERVAL = 250;
+export declare const HOLOGRAM_MAX_FRAMES_WITHOUT_FACE = 30;
+export declare const MIN_BRIGHTNESS_THRESHOLD = 45;
+export declare const MAX_BRIGHTNESS_THRESHOLD = 210;
+export declare const MAX_CONSECUTIVE_QUALITY_FAILURES = 30;
+export declare const FACE_EDGE_MARGIN_PERCENT = 0.08;
+export declare const MIN_CARD_FACE_SIZE_PERCENT = 0.05;
+export declare const MIN_MLI_FACE_SIZE_PERCENT = 0.01;
+export declare const REQUIRED_CONSISTENT_MRZ_READS = 2;
+export declare const REQUIRED_CONSISTENT_DOCTYPE_DETECTIONS = 3;
+export declare const SIGNATURE_REGEX: RegExp;
+export declare const SIGNATURE_TEXT_REGEX: RegExp;
+export declare const MRZ_BLOCK_PATTERN: RegExp;
+export declare const PASSPORT_MRZ_PATTERN: RegExp;
+export declare const MIN_SECURITY_FEATURES_REQUIRED = 4;
+export declare const SECURITY_FEATURE_NAMES: {
+    readonly icao_photo: "ICAO Uyumlu Fotoğraf (ICAO Compliant Photo)";
+    readonly barcode: "Barkod (Barcode)";
+    readonly hologram: "DOVID/OVD (Hologram)";
+    readonly wet_signature: "Islak İmza (Wet Signature)";
+    readonly guilloche: "Giyoş (Guilloche Pattern)";
+    readonly rainbow_print: "Gökkuşağı Baskı (Rainbow Print)";
+    readonly ovi: "Optik Değişken Mürekkep (OVI)";
+    readonly latent_image: "Gizli Görüntü (Latent Image)";
+    readonly microtext: "Mikro Yazı (Microtext)";
+};
+export declare const FACE_SHAPE_MATCH_THRESHOLD = 0.5;
+export declare const FACE_VISUAL_SIMILARITY_THRESHOLD = 0.5;
+export declare const FACE_ASPECT_RATIO_TOLERANCE = 0.15;
+export declare const FACE_SIZE_RATIO_MIN = 0.7;
+export declare const FACE_SIZE_RATIO_MAX = 1.3;
+//# sourceMappingURL=IdentityDocumentCamera.constants.d.ts.map

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentityDocumentCamera.constants.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,sCAAsC,IAAI,CAAC;AAExD,eAAO,MAAM,eAAe,QAAkC,CAAC;AAC/D,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAC3D,eAAO,MAAM,iBAAiB,QAAsB,CAAC;AACrD,eAAO,MAAM,oBAAoB,QAAe,CAAC;AAIjD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,sBAAsB;;;;;;;;;;CAUzB,CAAC;AAKX,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAChD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC"}

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.d.ts

@@ -1,59 +1,6 @@
-import type { MRZFields } from '../Types/mrzFields';
-export type DocumentScannedData = {
-    documentType: 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN';
-    image: string;
-    faceImage?: string;
-    secondaryFaceImage?: string;
-    hologramImage?: string;
-    barcodeValue?: string;
-    mrzText?: string;
-    mrzFields?: MRZFields;
-};
-export type BlockText = {
-    blocks: BlocksData[];
-    resultText: string;
-    mrzOnlyText?: string;
-};
-type BlocksData = {
-    blockFrame: FrameType;
-    blockCornerPoints: CornerPointsType;
-    lines: LinesData;
-    blockLanguages: string[] | [];
-    blockText: string;
-};
-type CornerPointsType = [{
-    x: number;
-    y: number;
-}];
-type FrameType = {
-    boundingCenterX: number;
-    boundingCenterY: number;
-    height: number;
-    width: number;
-    x: number;
-    y: number;
-};
-type LinesData = [
-    lineCornerPoints: CornerPointsType,
-    elements: ElementsData,
-    lineFrame: FrameType,
-    lineLanguages: string[] | [],
-    lineText: string
-];
-type ElementsData = [
-    elementCornerPoints: CornerPointsType,
-    elementFrame: FrameType,
-    elementText: string
-];
-export type PhotoOptions = {
-    uri: string;
-    orientation?: 'landscapeRight' | 'portrait' | 'portraitUpsideDown' | 'landscapeLeft';
-};
-export interface IdentityDocumentCameraProps {
-    onlyMRZScan: boolean;
-    onIdentityDocumentScanned: (scannedData: DocumentScannedData) => void;
-    testMode?: boolean;
-}
+import type { DocumentScannedData, BlockText, IdentityDocumentCameraProps } from './IdentityDocumentCamera.types';
+export type { DocumentScannedData, BlockText, IdentityDocumentCameraProps };
+export type { PhotoOptions } from './IdentityDocumentCamera.types';
 declare const IdentityDocumentCamera: ({ onlyMRZScan, onIdentityDocumentScanned, testMode, }: IdentityDocumentCameraProps) => import("react/jsx-runtime").JSX.Element;
 export default IdentityDocumentCamera;
 //# sourceMappingURL=IdentityDocumentCamera.d.ts.map

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IdentityDocumentCamera.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAiBpD,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,UAAU,EAAE,SAAS,CAAC;IACtB,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,gBAAgB,GAAG,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnD,KAAK,SAAS,GAAG;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,gBAAgB,EAAE,gBAAgB;IAClC,QAAQ,EAAE,YAAY;IACtB,SAAS,EAAE,SAAS;IACpB,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;IAC5B,QAAQ,EAAE,MAAM;CACjB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,mBAAmB,EAAE,gBAAgB;IACrC,YAAY,EAAE,SAAS;IACvB,WAAW,EAAE,MAAM;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EACR,gBAAgB,GAChB,UAAU,GACV,oBAAoB,GACpB,eAAe,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,yBAAyB,EAAE,CAAC,WAAW,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA2BD,QAAA,MAAM,sBAAsB,GAAI,uDAI7B,2BAA2B,4CAylH7B,CAAC;AAgLF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"IdentityDocumentCamera.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.tsx"],"names":[],"mappings":"AAsEA,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,2BAA2B,EAK5B,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,2BAA2B,EAAE,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAMnE,QAAA,MAAM,sBAAsB,GAAI,uDAI7B,2BAA2B,4CAg0E7B,CAAC;AAiIF,eAAe,sBAAsB,CAAC"}

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.flows.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Document scanning flow handlers
+ *
+ * This file contains the logic for handling different document type flows:
+ *
+ * KEY DISTINGUISHING FEATURES:
+ * =============================
+ * PASSPORT: Has MRZ on FRONT with pattern P<XXX (e.g., P<TUR, P<USA)
+ * ID CARD:  Has NO MRZ on front; MRZ only on BACK with code 'I'
+ *
+ * IMPORTANT: Both passports and ID cards have signature sections!
+ * Signature presence is NOT a distinguishing feature between document types.
+ * The ONLY reliable distinguisher is the passport MRZ pattern (P<XXX).
+ *
+ * PASSPORT FLOW:
+ *   1. SCAN_ID_FRONT_OR_PASSPORT: Detect face + MRZ with code 'P' (passport MRZ pattern)
+ *   2. SCAN_HOLOGRAM (optional, skipped if onlyMRZScan): Collect hologram images
+ *   3. COMPLETED: No back side for passports
+ *
+ * ID CARD FLOW:
+ *   1. SCAN_ID_FRONT_OR_PASSPORT: Detect face + NO passport MRZ pattern
+ *   2. SCAN_HOLOGRAM: Collect hologram images from front
+ *   3. SCAN_ID_BACK: Detect MRZ with code 'I' + barcode
+ *   4. COMPLETED
+ *
+ * ID BACK DETECTION:
+ *   - Only occurs during SCAN_ID_BACK step
+ *   - No face, has MRZ with code 'I'
+ */
+import type { Face } from './IdentityDocumentCamera.types';
+import type { MRZFields } from '../Types/mrzFields';
+export interface PassportFlowResult {
+    shouldProceed: boolean;
+    reason?: string;
+    nextAction?: 'WAIT_FOR_ELEMENTS' | 'WAIT_FOR_MRZ' | 'PROCEED_TO_HOLOGRAM' | 'PROCEED_TO_COMPLETED';
+}
+export interface IDFrontFlowResult {
+    shouldProceed: boolean;
+    reason?: string;
+    nextAction?: 'WAIT_FOR_ELEMENTS' | 'REJECT_AS_PASSPORT' | 'PROCEED_TO_HOLOGRAM';
+}
+export interface IDBackFlowResult {
+    shouldProceed: boolean;
+    reason?: string;
+    nextAction?: 'WAIT_FOR_MRZ' | 'WAIT_FOR_BARCODE' | 'PROCEED_TO_COMPLETED';
+}
+/**
+ * Handle PASSPORT flow during SCAN_ID_FRONT_OR_PASSPORT step
+ *
+ * Requirements:
+ * - Face must be detected AND captured
+ * - MRZ must be present with document code 'P'
+ * - MRZ must be stable (consistent reads) even in normal mode
+ * - All required MRZ fields must be present
+ */
+export declare function handlePassportFlow(faces: Face[], mrzText: string | null, mrzFields: MRZFields | undefined, mrzStableAndValid: boolean, onlyMRZScan: boolean, hasRequiredFields: boolean, faceCaptured: boolean): PassportFlowResult;
+/**
+ * Handle ID CARD FRONT flow during SCAN_ID_FRONT_OR_PASSPORT step
+ *
+ * CRITICAL: The KEY distinguishing feature is the ABSENCE of passport MRZ pattern.
+ * Both passports and ID cards have signatures, so signature is NOT used to distinguish
+ * between document types. Signature is only checked to ensure we're viewing the front
+ * side of the document (not the back).
+ *
+ * Requirements:
+ * - Face must be detected (front side indicator)
+ * - Must NOT have passport MRZ pattern (P<XXX) - this is the CRITICAL check
+ * - Signature text should be present (confirms front side, or retry threshold reached)
+ * - If MRZ code is present, it must be 'I' (ID card) not 'P' (passport)
+ */
+export declare function handleIDFrontFlow(faces: Face[], text: string, mrzText: string | null, mrzFields: MRZFields | undefined, retryCount: number): IDFrontFlowResult;
+/**
+ * Handle ID CARD BACK flow during SCAN_ID_BACK step
+ *
+ * Requirements:
+ * - MRZ must be present, valid, stable, and have all required fields
+ * - Barcode must be in frame (unless onlyMRZScan)
+ * - Barcode must match MRZ optional1 serial number (lenient comparison)
+ */
+export declare function handleIDBackFlow(mrzText: string | null, mrzFields: MRZFields | undefined, mrzValid: boolean, mrzStableAndValid: boolean, hasRequiredFields: boolean, barcodeValue: string | undefined, onlyMRZScan: boolean): IDBackFlowResult;
+/**
+ * Determine next step after SCAN_HOLOGRAM based on document type
+ *
+ * PASSPORT: → COMPLETED (no back side)
+ * ID CARD: → SCAN_ID_BACK
+ */
+export declare function getNextStepAfterHologram(detectedDocumentType: 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN', currentFrameDocType: 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN', mrzDocCode: string | undefined): 'COMPLETED' | 'SCAN_ID_BACK';
+//# sourceMappingURL=IdentityDocumentCamera.flows.d.ts.map

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.flows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentityDocumentCamera.flows.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.flows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAUpD,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,cAAc,GACd,qBAAqB,GACrB,sBAAsB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EACP,mBAAmB,GACnB,oBAAoB,GACpB,qBAAqB,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,cAAc,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;CAC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,iBAAiB,EAAE,OAAO,EAC1B,WAAW,EAAE,OAAO,EACpB,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,OAAO,GACpB,kBAAkB,CAgEpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAuEnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,QAAQ,EAAE,OAAO,EACjB,iBAAiB,EAAE,OAAO,EAC1B,iBAAiB,EAAE,OAAO,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,WAAW,EAAE,OAAO,GACnB,gBAAgB,CA2DlB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,oBAAoB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACrE,mBAAmB,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,EACpE,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,WAAW,GAAG,cAAc,CAY9B"}

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.types.d.ts

@@ -0,0 +1,116 @@
+export type SecurityFeature = 'icao_photo' | 'barcode' | 'hologram' | 'wet_signature' | 'guilloche' | 'rainbow_print' | 'ovi' | 'latent_image' | 'microtext';
+export type DocumentScannedData = {
+    documentType: 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN';
+    image: string;
+    faceImage?: string;
+    secondaryFaceImage?: string;
+    hologramImage?: string;
+    barcodeValue?: string;
+    mrzText?: string;
+    mrzFields?: MRZFields;
+    securityFeaturesDetected?: SecurityFeature[];
+    documentTiltValidated?: boolean;
+    interactiveTouchValidated?: boolean;
+    serialNumberVerified?: boolean;
+    transitionPointsValidated?: boolean;
+};
+export type BlockText = {
+    blocks: BlocksData[];
+    resultText: string;
+    mrzOnlyText?: string;
+};
+export type BlocksData = {
+    blockFrame: FrameType;
+    blockCornerPoints: CornerPointsType;
+    lines: LinesData;
+    blockLanguages: string[] | [];
+    blockText: string;
+};
+export type CornerPointsType = [{
+    x: number;
+    y: number;
+}];
+export type FrameType = {
+    boundingCenterX: number;
+    boundingCenterY: number;
+    height: number;
+    width: number;
+    x: number;
+    y: number;
+};
+export type LinesData = [
+    lineCornerPoints: CornerPointsType,
+    elements: ElementsData,
+    lineFrame: FrameType,
+    lineLanguages: string[] | [],
+    lineText: string
+];
+export type ElementsData = [
+    elementCornerPoints: CornerPointsType,
+    elementFrame: FrameType,
+    elementText: string
+];
+export type PhotoOptions = {
+    uri: string;
+    orientation?: 'landscapeRight' | 'portrait' | 'portraitUpsideDown' | 'landscapeLeft';
+};
+export interface IdentityDocumentCameraProps {
+    onlyMRZScan: boolean;
+    onIdentityDocumentScanned: (scannedData: DocumentScannedData) => void;
+    testMode?: boolean;
+}
+export interface Face {
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    rollAngle?: number;
+    pitchAngle?: number;
+    yawAngle?: number;
+    leftEyeOpenProbability?: number;
+    rightEyeOpenProbability?: number;
+    smilingProbability?: number;
+}
+export interface Barcode {
+    rawValue: string;
+    displayValue: string;
+    format: number;
+    boundingBox: {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+    };
+    cornerPoints: Array<{
+        x: number;
+        y: number;
+    }>;
+    value?: string;
+}
+import type { MRZFields } from '../Types/mrzFields';
+export type ScanStep = 'SCAN_ID_FRONT_OR_PASSPORT' | 'SCAN_ID_BACK' | 'SCAN_HOLOGRAM' | 'COMPLETED';
+export type ScanStatus = 'SEARCHING' | 'SCANNING' | 'SCANNED' | 'INCORRECT';
+export type DocumentType = 'ID_FRONT' | 'ID_BACK' | 'PASSPORT' | 'UNKNOWN';
+export type CompletedStep = 'SCAN_ID_FRONT_OR_PASSPORT' | 'SCAN_ID_BACK' | 'SCAN_HOLOGRAM' | null;
+export type BoundsWithRotation = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rollAngle?: number;
+    cropPadding?: number;
+};
+export type BoundsWithAngle = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    angle?: number;
+    corners?: Array<{
+        x: number;
+        y: number;
+    }>;
+};
+//# sourceMappingURL=IdentityDocumentCamera.types.d.ts.map

package/lib/typescript/src/Shared/Components/IdentityDocumentCamera.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentityDocumentCamera.types.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/IdentityDocumentCamera.types.ts"],"names":[],"mappings":"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"}