@vppos/react-native-nfc 1.0.0

package/android/src/main/res/drawable/bg_nfc_sheet_handle.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="rectangle">
+    <size
+        android:width="52dp"
+        android:height="5dp" />
+    <corners android:radius="999dp" />
+    <solid android:color="#FDBA74" />
+</shape>

package/android/src/main/res/layout/activity_nfc.xml

@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="utf-8"?>
+<FrameLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="@android:color/transparent">
+
+    <View
+        android:id="@+id/sheetScrim"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:background="#660F172A" />
+
+    <LinearLayout
+        android:id="@+id/sheetContainer"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_gravity="bottom"
+        android:layout_marginStart="12dp"
+        android:layout_marginEnd="12dp"
+        android:layout_marginBottom="12dp"
+        android:background="@drawable/bg_nfc_bottom_sheet"
+        android:elevation="12dp"
+        android:gravity="center_horizontal"
+        android:orientation="vertical"
+        android:paddingStart="24dp"
+        android:paddingTop="16dp"
+        android:paddingEnd="24dp"
+        android:paddingBottom="28dp">
+
+        <View
+            android:layout_width="52dp"
+            android:layout_height="5dp"
+            android:background="@drawable/bg_nfc_sheet_handle" />
+
+        
+
+        <TextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="16dp"
+            android:text="Quét chip CCCD"
+            android:textColor="#0F172A"
+            android:textSize="22sp"
+            android:textStyle="bold" />
+
+        <TextView
+            android:id="@+id/tvGuide"
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="8dp"
+            android:gravity="center"
+            android:text="Đặt CCCD sát mặt lưng điện thoại và giữ cố định để đọc chip."
+            android:textColor="#475569"
+            android:textSize="14sp" />
+
+        <LinearLayout
+            android:layout_width="match_parent"
+            android:layout_height="wrap_content"
+            android:layout_marginTop="24dp"
+            android:gravity="center_vertical"
+            android:orientation="horizontal">
+
+            <TextView
+                android:layout_width="0dp"
+                android:layout_height="wrap_content"
+                android:layout_weight="1"
+                android:text="Tiến độ đọc chip"
+                android:textColor="#0F172A"
+                android:textSize="15sp"
+                android:textStyle="bold" />
+
+            <TextView
+                android:id="@+id/tvProgressPercent"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:text="0%"
+                android:textColor="#EA580C"
+                android:textSize="15sp"
+                android:textStyle="bold" />
+        </LinearLayout>
+
+        <ProgressBar
+            android:id="@+id/nfcProgressBar"
+            style="?android:attr/progressBarStyleHorizontal"
+            android:layout_width="match_parent"
+            android:layout_height="10dp"
+            android:layout_marginTop="12dp"
+            android:max="100"
+            android:progress="0"
+            android:progressBackgroundTint="#E2E8F0"
+            android:progressTint="#EA580C" />
+
+
+
+        <Button
+            android:id="@+id/btnRetry"
+            android:layout_width="match_parent"
+            android:layout_height="54dp"
+            android:layout_marginTop="24dp"
+            android:backgroundTint="#EA580C"
+            android:text="THỬ LẠI"
+            android:textColor="#FFFFFF"
+            android:textSize="15sp"
+            android:textStyle="bold"
+            android:visibility="gone" />
+
+    </LinearLayout>
+
+</FrameLayout>

package/android/src/main/res/values/styles.xml

@@ -0,0 +1,10 @@
+<resources>
+    <style name="NfcBottomSheetTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <item name="android:windowBackground">@android:color/transparent</item>
+        <item name="android:windowIsTranslucent">true</item>
+        <item name="android:windowNoTitle">true</item>
+        <item name="android:backgroundDimEnabled">false</item>
+        <item name="android:statusBarColor">@android:color/transparent</item>
+        <item name="android:navigationBarColor">#660F172A</item>
+    </style>
+</resources>

package/android/src/main/res/xml/nfc_tech_filter.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
+    <tech-list>
+        <tech>android.nfc.tech.IsoDep</tech>
+        <tech>android.nfc.tech.NfcA</tech>
+        <tech>android.nfc.tech.NfcB</tech>
+    </tech-list>
+</resources>

package/ios/ChipReader.swift

@@ -0,0 +1,258 @@
+import Foundation
+
+struct ChipReadResult {
+  let citizenId: String
+  let fullName: String
+  let dob: String
+  let gender: String
+  let nationality: String
+  let permanentAddress: String
+  let issueDate: String
+  let issuePlace: String
+  let expireDate: String
+  let imageFromChipBase64: String
+  let dg1DataB64: String
+  let dg2DataB64: String
+  let dg13DataB64: String
+  let dg14DataB64: String
+  let sodData: String
+}
+
+enum ChipReadError: LocalizedError {
+  case invalidCitizenId
+  case nfcNotSupported
+  case userCanceled
+  case sessionTimeout
+  case readFailed(String)
+
+  var errorDescription: String? {
+    switch self {
+    case .invalidCitizenId:
+      return "CCCD không hợp lệ"
+    case .nfcNotSupported:
+      return "Thiết bị không hỗ trợ NFC"
+    case .userCanceled:
+      return "Phiên NFC đã bị hủy"
+    case .sessionTimeout:
+      return "Phiên NFC đã hết thời gian, vui lòng thử lại"
+    case .readFailed(let message):
+      return "Đọc NFC thất bại: \(message)"
+    }
+  }
+}
+
+typealias ChipReadProgressListener = (_ progress: Int, _ message: String) -> Void
+
+final class ChipReader {
+  private let passportReader = PassportReader()
+
+  @MainActor
+  func read(
+    citizenId: String,
+    progressListener: @escaping ChipReadProgressListener
+  ) async throws -> ChipReadResult {
+    let cleanCitizenId = citizenId.trimmingCharacters(
+      in: .whitespacesAndNewlines
+    )
+
+    guard cleanCitizenId.count >= 6 else {
+      throw ChipReadError.invalidCitizenId
+    }
+
+    progressListener(10, "Đang khởi tạo NFC...")
+
+    let canCode = String(cleanCitizenId.suffix(6))
+    let requiredTags: [DataGroupId] = [
+      .COM,
+      .DG1,
+      .DG2,
+      .DG13,
+      .DG14,
+      .SOD,
+    ]
+
+    do {
+      let passport = try await passportReader.readPassport(
+        canKey: canCode,
+        tags: requiredTags,
+        skipCA: true,
+        useExtendedMode: true,
+        customDisplayMessage: { displayMessage in
+          self.handleInternalProgress(
+            displayMessage,
+            progressListener: progressListener
+          )
+          return self.getDisplayString(from: displayMessage)
+        }
+      )
+
+      progressListener(100, "Đọc NFC thành công")
+      return mapResult(passport: passport, citizenId: cleanCitizenId)
+    } catch {
+      if let readerError = error as? NFCPassportReaderError,
+         case .NFCNotSupported = readerError {
+        throw ChipReadError.nfcNotSupported
+      }
+
+      if let readerError = error as? NFCPassportReaderError {
+        switch readerError {
+        case .UserCanceled:
+          throw ChipReadError.userCanceled
+        case .InvalidMRZKey:
+          throw ChipReadError.readFailed("Khóa CAN không hợp lệ")
+        case .Unknown(let wrappedError):
+          let wrappedDescription = wrappedError.localizedDescription
+          if self.isTimeoutDescription(wrappedDescription) {
+            throw ChipReadError.sessionTimeout
+          }
+          if wrappedDescription.localizedCaseInsensitiveContains("Session invalidated") {
+            throw ChipReadError.readFailed("Phiên NFC bị ngắt giữa chừng")
+          }
+          throw ChipReadError.readFailed(readerError.localizedDescription)
+        default:
+          if self.isTimeoutDescription(readerError.localizedDescription) {
+            throw ChipReadError.sessionTimeout
+          }
+          throw ChipReadError.readFailed(readerError.localizedDescription)
+        }
+      }
+
+      if error.localizedDescription == "NFCNotSupported" {
+        throw ChipReadError.nfcNotSupported
+      }
+
+      if error.localizedDescription.localizedCaseInsensitiveContains("Session invalidated") {
+        throw ChipReadError.readFailed("Phiên NFC bị ngắt giữa chừng")
+      }
+
+      if self.isTimeoutDescription(error.localizedDescription) {
+        throw ChipReadError.sessionTimeout
+      }
+
+      throw ChipReadError.readFailed(error.localizedDescription)
+    }
+  }
+}
+
+private extension ChipReader {
+  func isTimeoutDescription(_ description: String) -> Bool {
+    let normalized = description.trimmingCharacters(in: .whitespacesAndNewlines)
+      .lowercased()
+
+    return normalized.contains("timeout") ||
+      normalized.contains("timed out") ||
+      normalized.contains("time out")
+  }
+
+  func getDisplayString(
+    from message: NFCViewDisplayMessage
+  ) -> String {
+    switch message {
+    case .requestPresentPassport:
+      return "Đưa mặt sau CCCD sát đỉnh iPhone và giữ cố định."
+    case .authenticatingWithPassport:
+      return "Đang mở khóa chip bằng CAN..."
+    case .readingDataGroupProgress(let dg, let progress):
+      return "Đang đọc \(dg): \(progress)%"
+    case .successfulRead:
+      return "Đọc thành công!"
+    case .error(let error):
+      return "Lỗi: \(error.localizedDescription)"
+    default:
+      return "Vui lòng giữ CCCD cố định"
+    }
+  }
+
+  func handleInternalProgress(
+    _ message: NFCViewDisplayMessage,
+    progressListener: ChipReadProgressListener
+  ) {
+    switch message {
+    case .authenticatingWithPassport(let progress):
+      // PACE Authentication ranges from 10% to 25% of overall progress
+      let overallProgress = 10 + (progress * 15 / 100)
+      progressListener(overallProgress, "Đang mở khóa chip CCCD...")
+    case .readingDataGroupProgress(let dg, let progress):
+      // Assign overall progress ranges based on the specific Data Group being read
+      let overallProgress: Int
+      switch dg {
+      case .COM:
+        overallProgress = 25 + (progress * 5 / 100)
+      case .DG1:
+        overallProgress = 30 + (progress * 5 / 100)
+      case .DG2:
+        // DG2 (face photo) is usually the largest, taking 35% - 75% of overall progress
+        overallProgress = 35 + (progress * 40 / 100)
+      case .DG13:
+        // DG13 (VN custom details) takes 75% - 85%
+        overallProgress = 75 + (progress * 10 / 100)
+      case .DG14:
+        overallProgress = 85 + (progress * 5 / 100)
+      case .SOD:
+        overallProgress = 90 + (progress * 5 / 100)
+      default:
+        overallProgress = 95
+      }
+      progressListener(overallProgress, "Đang đọc \(dg.getName())...")
+    default:
+      break
+    }
+  }
+
+  func mapResult(
+    passport: NFCPassportModel,
+    citizenId: String
+  ) -> ChipReadResult {
+    var imageFromChipBase64 = ""
+    if let image = passport.passportImage,
+       let imageData = image.jpegData(compressionQuality: 0.8) {
+      imageFromChipBase64 = imageData.base64EncodedString()
+    }
+
+    let dg1DataB64 = passport.dataGroupsRead[.DG1]
+      .map { Data($0.data).base64EncodedString() } ?? ""
+    let dg2DataB64 = passport.dataGroupsRead[.DG2]
+      .map { Data($0.data).base64EncodedString() } ?? ""
+    let dg13Data = passport.dataGroupsRead[.DG13].map { Data($0.data) }
+    let dg13DataB64 = dg13Data?.base64EncodedString() ?? ""
+    let dg14DataB64 = passport.dataGroupsRead[.DG14]
+      .map { Data($0.data).base64EncodedString() } ?? ""
+    let sodData = passport.dataGroupsRead[.SOD]
+      .map { Data($0.data).base64EncodedString() } ?? ""
+
+    let parsedDg13 = dg13Data.map {
+      DG13Parser.parse($0, fallbackIssuePlace: "")
+    } ?? DG13ParsedData()
+
+    let normalizedGender = DG13Parser.normalizeGender(passport.gender)
+    let finalGender =
+      parsedDg13.gender.isEmpty ? normalizedGender : parsedDg13.gender
+    let mrzExpireDate = MrzUtils.formatDate(passport.documentExpiryDate)
+    let finalExpireDate =
+      parsedDg13.expireDate.isEmpty ? mrzExpireDate : parsedDg13.expireDate
+    let mrzFullName = MrzUtils.normalizeName(
+      firstName: passport.firstName,
+      lastName: passport.lastName
+    )
+    let finalFullName =
+      parsedDg13.fullName.isEmpty ? mrzFullName : parsedDg13.fullName
+
+    return ChipReadResult(
+      citizenId: citizenId,
+      fullName: finalFullName,
+      dob: MrzUtils.formatDate(passport.dateOfBirth),
+      gender: finalGender,
+      nationality: MrzUtils.normalizeNationality(passport.nationality),
+      permanentAddress: parsedDg13.permanentAddress,
+      issueDate: parsedDg13.issueDate,
+      issuePlace: parsedDg13.issuePlace,
+      expireDate: finalExpireDate,
+      imageFromChipBase64: imageFromChipBase64,
+      dg1DataB64: dg1DataB64,
+      dg2DataB64: dg2DataB64,
+      dg13DataB64: dg13DataB64,
+      dg14DataB64: dg14DataB64,
+      sodData: sodData
+    )
+  }
+}

package/ios/NFCSDK-Bridging-Header.h

@@ -0,0 +1,2 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTViewManager.h>

package/ios/NFCSDK.mm

@@ -0,0 +1,9 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
+
+@interface RCT_EXTERN_MODULE(NFCSDK, RCTEventEmitter)
+
+RCT_EXTERN_METHOD(setCitizenId:(NSString *)citizenId)
+RCT_EXTERN_METHOD(startNfcScan)
+
+@end

package/ios/NFCSDK.swift

@@ -0,0 +1,112 @@
+import Foundation
+import React
+
+@objc(NFCSDK)
+class NFCSDK: RCTEventEmitter {
+
+  static var shared: NFCSDK?
+  private let chipReader = ChipReader()
+  private var currentReadTask: Task<Void, Never>?
+
+  override init() {
+    super.init()
+    NFCSDK.shared = self
+  }
+
+  override static func requiresMainQueueSetup() -> Bool {
+    true
+  }
+
+  override func supportedEvents() -> [String]! {
+    [
+      "onNfcProgress",
+      "onNfcCompleted",
+    ]
+  }
+
+  @objc
+  func setCitizenId(_ citizenId: String) {
+    NFCSDKSession.citizenId = citizenId.trimmingCharacters(
+      in: .whitespacesAndNewlines
+    )
+  }
+
+  @objc
+  func startNfcScan() {
+    if currentReadTask != nil {
+      return
+    }
+
+    let citizenId = NFCSDKSession.citizenId
+    currentReadTask = Task { @MainActor [weak self] in
+      guard let self else {
+        return
+      }
+
+      defer {
+        self.currentReadTask = nil
+      }
+
+      do {
+        let result = try await self.chipReader.read(
+          citizenId: citizenId,
+          progressListener: { progress, message in
+            self.emitProgress(progress: progress, message: message)
+          }
+        )
+        self.emitCompleted(result)
+      } catch {
+        self.emitProgress(
+          progress: -1,
+          message: error.localizedDescription
+        )
+      }
+    }
+  }
+
+  private func emitProgress(
+    progress: Int,
+    message: String
+  ) {
+    DispatchQueue.main.async {
+      self.sendEvent(
+        withName: "onNfcProgress",
+        body: [
+          "progress": progress,
+          "message": message,
+        ]
+      )
+    }
+  }
+
+  private func emitCompleted(
+    _ result: ChipReadResult
+  ) {
+    let payload: [String: Any] = [
+      "citizenId": result.citizenId,
+      "fullName": result.fullName,
+      "dob": result.dob,
+      "gender": result.gender,
+      "nationality": result.nationality,
+      "permanentAddress": result.permanentAddress,
+      "issueDate": result.issueDate,
+      "issuePlace": result.issuePlace,
+      "expireDate": result.expireDate,
+      "imageFromChip": result.imageFromChipBase64,
+      "frontCardBase64": "",
+      "backCardBase64": "",
+      "dg1DataB64": result.dg1DataB64,
+      "dg2DataB64": result.dg2DataB64,
+      "dg13DataB64": result.dg13DataB64,
+      "dg14DataB64": result.dg14DataB64,
+      "sodData": result.sodData,
+    ]
+
+    DispatchQueue.main.async {
+      self.sendEvent(
+        withName: "onNfcCompleted",
+        body: payload
+      )
+    }
+  }
+}

package/ios/NFCSDKSession.swift

@@ -0,0 +1,5 @@
+import Foundation
+
+enum NFCSDKSession {
+  static var citizenId = ""
+}