@vppos/react-native-nfc 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 trnguyen5885
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NFCSDK.podspec

@@ -0,0 +1,40 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "NFCSDK"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/trnguyen5885/react-native-nfc-sdk.git", :tag => "#{s.version}" }
+
+  s.source_files = [
+    "ios/**/*.{h,m,mm,swift}",
+    "vendor/ios-passport-reader/Sources/NFCPassportReader/**/*.{swift}"
+  ]
+  s.frameworks = "CoreNFC"
+  s.swift_version = "5.0"
+  s.dependency "OpenSSL-Universal", "1.1.1900"
+  s.xcconfig = {
+    "OTHER_LDFLAGS" => "-weak_framework CryptoKit -weak_framework CoreNFC -weak_framework CryptoTokenKit"
+  }
+  s.pod_target_xcconfig = {
+    "EXCLUDED_ARCHS[sdk=iphonesimulator*]" => "arm64"
+  }
+  s.user_target_xcconfig = {
+    "EXCLUDED_ARCHS[sdk=iphonesimulator*]" => "arm64"
+  }
+
+# Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+# See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
+if respond_to?(:install_modules_dependencies, true)
+  install_modules_dependencies(s)
+else
+  s.dependency "React-Core"
+end
+end

package/android/build.gradle

@@ -0,0 +1,85 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['NFCSDK_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["NFCSDK_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.nfcsdk"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+  implementation "androidx.appcompat:appcompat:1.7.0"
+  implementation "org.jmrtd:jmrtd:0.7.18"
+  implementation "net.sf.scuba:scuba-sc-android:0.0.20"
+  implementation "com.madgag.spongycastle:prov:1.54.0.0"
+  implementation "com.madgag.spongycastle:pkix:1.54.0.0"
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+NFCSDK_kotlinVersion=2.0.21
+NFCSDK_minSdkVersion=24
+NFCSDK_targetSdkVersion=34
+NFCSDK_compileSdkVersion=35
+NFCSDK_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,31 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.nfcsdk">
+
+    <uses-permission android:name="android.permission.NFC" />
+    <uses-permission android:name="android.permission.VIBRATE" />
+
+    <uses-feature
+        android:name="android.hardware.nfc"
+        android:required="false" />
+
+    <application>
+        <activity
+            android:name=".NFCScanActivity"
+            android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
+            android:exported="false"
+            android:launchMode="singleTop"
+            android:noHistory="true"
+            android:screenOrientation="portrait"
+            android:theme="@style/NfcBottomSheetTheme"
+            android:windowSoftInputMode="adjustResize">
+
+            <intent-filter>
+                <action android:name="android.nfc.action.TECH_DISCOVERED" />
+            </intent-filter>
+
+            <meta-data
+                android:name="android.nfc.action.TECH_DISCOVERED"
+                android:resource="@xml/nfc_tech_filter" />
+        </activity>
+    </application>
+</manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,30 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <uses-permission android:name="android.permission.NFC" />
+    <uses-permission android:name="android.permission.VIBRATE" />
+
+    <uses-feature
+        android:name="android.hardware.nfc"
+        android:required="false" />
+
+    <application>
+        <activity
+            android:name="com.nfcsdk.NFCScanActivity"
+            android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
+            android:exported="false"
+            android:launchMode="singleTop"
+            android:noHistory="true"
+            android:screenOrientation="portrait"
+            android:theme="@style/NfcBottomSheetTheme"
+            android:windowSoftInputMode="adjustResize">
+
+            <intent-filter>
+                <action android:name="android.nfc.action.TECH_DISCOVERED" />
+            </intent-filter>
+
+            <meta-data
+                android:name="android.nfc.action.TECH_DISCOVERED"
+                android:resource="@xml/nfc_tech_filter" />
+        </activity>
+    </application>
+</manifest>

package/android/src/main/java/com/nfcsdk/ChipReader.kt

@@ -0,0 +1,237 @@
+package com.nfcsdk
+
+import android.nfc.Tag
+import android.nfc.tech.IsoDep
+import android.util.Base64
+import android.util.Log
+import com.nfcsdk.utils.MrzUtils
+import com.nfcsdk.utils.FaceExtractor
+import com.nfcsdk.utils.Dg13Parser
+import com.nfcsdk.utils.Dg13ParsedData
+import net.sf.scuba.smartcards.CardService
+import org.jmrtd.PACEKeySpec
+import org.jmrtd.PassportService
+import org.jmrtd.lds.CardAccessFile
+import org.jmrtd.lds.PACEInfo
+import org.jmrtd.lds.icao.DG1File
+import java.io.ByteArrayInputStream
+
+/**
+ * Kết quả đọc chip CCCD.
+ */
+data class ChipReadResult(
+  val citizenId: String,
+  val fullName: String,
+  val dob: String,
+  val gender: String,
+  val nationality: String,
+  val permanentAddress: String,
+  val issueDate: String,
+  val issuePlace: String,
+  val expireDate: String,
+  val imageFromChipBase64: String,
+  val dg1DataB64: String,
+  val dg2DataB64: String,
+  val dg13DataB64: String,
+  val dg14DataB64: String,
+  val sodData: String,
+)
+
+/**
+ * Listener nhận cập nhật tiến trình đọc chip.
+ */
+fun interface ChipReadProgressListener {
+  fun onProgress(progress: Int, message: String)
+}
+
+/**
+ * Core logic đọc chip NFC trên CCCD.
+ *
+ * Luồng xử lý:
+ * 1. Mở IsoDep connection
+ * 2. Xác thực PACE (CAN = 6 số cuối CCCD)
+ * 3. Đọc DG1 (MRZ) → thông tin cá nhân
+ * 4. Đọc DG2 → ảnh khuôn mặt
+ * 5. Đọc DG13 → thông tin mở rộng (đặc thù VN)
+ * 6. Đọc DG14 + SOD → security data
+ * 7. Trả về [ChipReadResult]
+ */
+object ChipReader {
+
+  private const val TAG = "NFCSDK"
+  private const val ISO_DEP_TIMEOUT = 30_000
+
+  /**
+   * Đọc toàn bộ dữ liệu từ chip CCCD.
+   *
+   * @param tag NFC tag nhận được từ foreground dispatch
+   * @param citizenId Số CCCD (>= 6 ký tự)
+   * @param progressListener Callback cập nhật tiến trình
+   * @return [ChipReadResult] chứa toàn bộ dữ liệu đã parse
+   * @throws ChipReadException nếu xảy ra lỗi trong quá trình đọc
+   */
+  fun read(
+    tag: Tag,
+    citizenId: String,
+    progressListener: ChipReadProgressListener,
+  ): ChipReadResult {
+    val cleanCitizenId = citizenId.trim()
+    require(cleanCitizenId.length >= 6) { "citizenId must be at least 6 characters" }
+
+    var isoDep: IsoDep? = null
+    var cardService: CardService? = null
+    var passportService: PassportService? = null
+
+    try {
+      progressListener.onProgress(10, "Đang kết nối chip...")
+
+      isoDep = IsoDep.get(tag)
+        ?: throw ChipReadException("Không nhận diện được chip IsoDep")
+
+      isoDep.timeout = ISO_DEP_TIMEOUT
+      cardService = CardService.getInstance(isoDep)
+      cardService.open()
+
+      passportService = PassportService(
+        cardService,
+        PassportService.NORMAL_MAX_TRANCEIVE_LENGTH,
+        PassportService.DEFAULT_MAX_BLOCKSIZE,
+        false,
+        false,
+      )
+      passportService.open()
+
+      // PACE authentication
+      val canCode = cleanCitizenId.takeLast(6)
+      progressListener.onProgress(20, "Đang xác thực chip...")
+
+      val paceInfo = readPaceInfo(passportService)
+        ?: throw ChipReadException("Chip không hỗ trợ PACE")
+
+      passportService.doPACE(
+        PACEKeySpec.createCANKey(canCode),
+        paceInfo.objectIdentifier,
+        PACEInfo.toParameterSpec(paceInfo.parameterId),
+        null,
+      )
+      passportService.sendSelectApplet(true)
+
+      // DG1 — MRZ
+      progressListener.onProgress(40, "Đang đọc DG1...")
+      val dg1Bytes = passportService
+        .getInputStream(PassportService.EF_DG1)
+        .readBytes()
+
+      val dg1File = DG1File(ByteArrayInputStream(dg1Bytes))
+      val mrzInfo = dg1File.mrzInfo
+
+      val fullName = MrzUtils.normalizeName(
+        mrzInfo.primaryIdentifier,
+        mrzInfo.secondaryIdentifier,
+      )
+      val dob = MrzUtils.formatBirthDate(mrzInfo.dateOfBirth?.toString() ?: "")
+      var gender = MrzUtils.normalizeGender(mrzInfo.gender?.toString() ?: "")
+      val nationality = MrzUtils.normalizeNationality(mrzInfo.nationality)
+      val expireDate = MrzUtils.formatExpireDate(mrzInfo.dateOfExpiry?.toString() ?: "")
+
+      // DG2 — Face image
+      progressListener.onProgress(60, "Đang đọc DG2...")
+      val dg2Bytes = passportService
+        .getInputStream(PassportService.EF_DG2)
+        .readBytes()
+
+      // DG13 — Vietnam-specific data
+      var dg13DataB64 = ""
+      var parsedDg13 = Dg13ParsedData()
+      try {
+        progressListener.onProgress(70, "Đang đọc DG13...")
+        val dg13Bytes = passportService
+          .getInputStream(PassportService.EF_DG13)
+          .readBytes()
+        dg13DataB64 = Base64.encodeToString(dg13Bytes, Base64.NO_WRAP)
+        parsedDg13 = Dg13Parser.parse(dg13Bytes)
+      } catch (e: Exception) {
+        Log.e(TAG, "DG13 read failed", e)
+      }
+
+      if (parsedDg13.gender.isNotBlank()) {
+        gender = parsedDg13.gender
+      }
+
+      // DG14 + SOD — Security data
+      val dg14DataB64 = readOptionalDataGroup(
+        passportService, PassportService.EF_DG14, 75, "DG14", progressListener,
+      )
+      val sodData = readOptionalDataGroup(
+        passportService, PassportService.EF_SOD, 80, "SOD", progressListener,
+      )
+
+      // Face extraction
+      progressListener.onProgress(90, "Đang đọc ảnh chip...")
+      val imageFromChipBase64 = FaceExtractor.extractBase64(dg2Bytes)
+        ?: throw ChipReadException("Không đọc được ảnh chip")
+
+      progressListener.onProgress(100, "Đọc NFC thành công")
+
+      return ChipReadResult(
+        citizenId = cleanCitizenId,
+        fullName = fullName,
+        dob = dob,
+        gender = gender,
+        nationality = nationality,
+        permanentAddress = parsedDg13.permanentAddress,
+        issueDate = parsedDg13.issueDate,
+        issuePlace = parsedDg13.issuePlace,
+        expireDate = expireDate,
+        imageFromChipBase64 = imageFromChipBase64,
+        dg1DataB64 = Base64.encodeToString(dg1Bytes, Base64.NO_WRAP),
+        dg2DataB64 = Base64.encodeToString(dg2Bytes, Base64.NO_WRAP),
+        dg13DataB64 = dg13DataB64,
+        dg14DataB64 = dg14DataB64,
+        sodData = sodData,
+      )
+    } finally {
+      closeQuietly { passportService?.close() }
+      closeQuietly { cardService?.close() }
+      closeQuietly { isoDep?.close() }
+    }
+  }
+
+  private fun readPaceInfo(passportService: PassportService): PACEInfo? {
+    val cardAccessFile = CardAccessFile(
+      passportService.getInputStream(PassportService.EF_CARD_ACCESS),
+    )
+    return cardAccessFile.securityInfos
+      .filterIsInstance<PACEInfo>()
+      .firstOrNull()
+  }
+
+  private fun readOptionalDataGroup(
+    passportService: PassportService,
+    fileId: Short,
+    progress: Int,
+    label: String,
+    progressListener: ChipReadProgressListener,
+  ): String {
+    return try {
+      progressListener.onProgress(progress, "Đang đọc $label...")
+      val bytes = passportService.getInputStream(fileId).readBytes()
+      Base64.encodeToString(bytes, Base64.NO_WRAP)
+    } catch (e: Exception) {
+      Log.e(TAG, "$label read failed", e)
+      ""
+    }
+  }
+
+  private inline fun closeQuietly(block: () -> Unit) {
+    try {
+      block()
+    } catch (_: Exception) {
+    }
+  }
+}
+
+/**
+ * Exception đặc thù cho lỗi đọc chip NFC.
+ */
+class ChipReadException(message: String) : Exception(message)

package/android/src/main/java/com/nfcsdk/NFCSDKModule.kt

@@ -0,0 +1,78 @@
+package com.nfcsdk
+
+import android.content.Intent
+import android.util.Log
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+
+class NFCSDKModule(
+  reactContext: ReactApplicationContext
+) : ReactContextBaseJavaModule(reactContext) {
+
+  override fun getName(): String = NAME
+
+  @ReactMethod
+  fun setCitizenId(citizenId: String) {
+    documentNumber = citizenId.trim()
+  }
+
+  @ReactMethod
+  fun startNfcScan() {
+    openNfcActivity()
+  }
+
+  private fun openNfcActivity() {
+    val activity = reactApplicationContext.currentActivity
+    val intent = Intent(
+      activity ?: reactApplicationContext,
+      NFCScanActivity::class.java
+    )
+
+    if (activity != null) {
+      activity.startActivity(intent)
+    } else {
+      intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+      reactApplicationContext.startActivity(intent)
+    }
+  }
+
+  @ReactMethod
+  fun addListener(eventName: String) {
+  }
+
+  @ReactMethod
+  fun removeListeners(count: Int) {
+  }
+
+  companion object {
+    const val NAME = "NFCSDK"
+
+    @Volatile
+    var reactContext: ReactApplicationContext? = null
+
+    @Volatile
+    var documentNumber: String = ""
+
+    fun sendEvent(
+      eventName: String,
+      params: WritableMap?
+    ) {
+      val ctx = reactContext ?: return
+
+      try {
+        ctx
+          .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+          .emit(eventName, params)
+      } catch (e: Exception) {
+        Log.e("NFCSDK", "sendEvent($eventName) failed", e)
+      }
+    }
+  }
+
+  init {
+    Companion.reactContext = reactContext
+  }
+}

package/android/src/main/java/com/nfcsdk/NFCSDKPackage.kt

@@ -0,0 +1,17 @@
+package com.nfcsdk
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+
+class NFCSDKPackage : ReactPackage {
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return listOf(NFCSDKModule(reactContext))
+  }
+
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return emptyList()
+  }
+}