@digitalshieldfe/react-native-backup-card-sdk 0.1.5 → 0.1.6

package/android/build.gradle

@@ -32,6 +32,33 @@ apply plugin: "kotlin-android"
 
 apply plugin: "com.facebook.react"
 
+react {
+  jsRootDir = file("../src/")
+  libraryName = "BackupCardSdkSpec"
+  codegenJavaPackageName = "com.ziancube.reactnativebackupcardsdk"
+}
+
+// Kotlin/Java TurboModule uses BackupCardSdkSpec-generated.cpp (JavaTurboModule).
+// BackupCardSdkSpecJSI-generated.cpp targets a C++ module class that is not implemented
+// and conflicts with BackupCardSdkSpecJSI.h from the same codegen run.
+def patchBackupCardCodegen = tasks.register("patchBackupCardCodegen") {
+  doLast {
+    def jsiCpp =
+        file(
+            "${layout.buildDirectory.get()}/generated/source/codegen/jni/react/renderer/components/BackupCardSdkSpec/BackupCardSdkSpecJSI-generated.cpp"
+        )
+    if (jsiCpp.exists()) {
+      jsiCpp.delete()
+    }
+  }
+}
+
+tasks.configureEach { task ->
+  if (task.name == "generateCodegenArtifactsFromSchema") {
+    task.finalizedBy(patchBackupCardCodegen)
+  }
+}
+
 android {
   namespace "com.ziancube.reactnativebackupcardsdk"
 

package/android/src/main/java/com/ziancube/reactnativebackupcardsdk/BackupCardSdkModule.kt

@@ -1,6 +1,8 @@
 package com.ziancube.reactnativebackupcardsdk
 
+import android.app.Activity
 import android.content.Intent
+import android.util.Log
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.BaseActivityEventListener
 import com.facebook.react.bridge.Promise
@@ -12,7 +14,12 @@ import com.facebook.react.bridge.LifecycleEventListener
 import com.ziancube.backupcardsdk.ApduLogger
 import com.ziancube.backupcardsdk.BackupCardSdk
 import com.ziancube.backupcardsdk.NfcTouchListener
+import com.ziancube.backupcardsdk.CardOperationResult
 import com.ziancube.backupcardsdk.CardInfo
+import com.ziancube.backupcardsdk.NfcWaitTimeoutException
+import com.ziancube.reactnativebackupcardsdk.nfc.NfcExceptions
+import com.ziancube.reactnativebackupcardsdk.nfc.NfcUtils
+import com.ziancube.reactnativebackupcardsdk.utils.NfcPermissionUtils
 import kotlinx.coroutines.CoroutineDispatcher
 import kotlinx.coroutines.CoroutineScope
 import kotlinx.coroutines.Dispatchers
@@ -21,47 +28,73 @@ import kotlinx.coroutines.cancel
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.withContext
 
-fun CardInfo.toWritableMap(): WritableMap {
-  val map = Arguments.createMap()
-  map.putString("serialNumber", serialNumber)
-  map.putInt("pinRetryCount", pinRetryCount ?: -1)
-  map.putBoolean("isNewCard", isNewCard ?: false)
-  return map
-}
-
-fun ReadableArray.toByteArray(): ByteArray {
-  val bytes = ByteArray(size())
-  for (i in 0 until size()) {
-    bytes[i] = getInt(i).toByte()
-  }
-  return bytes
-}
-
-fun ByteArray?.toWritableArrayOrNull(): WritableArray? {
-  if (this == null) return null
-  val array = Arguments.createArray()
-  for (b in this) {
-    array.pushInt(b.toInt() and 0xFF)
-  }
-  return array
-}
-
-
 class BackupCardSdkModule(val reactContext: ReactApplicationContext) :
         NativeBackupCardSdkSpec(reactContext) ,LifecycleEventListener
 {
-  private lateinit var backupCardSdk: BackupCardSdk
+  private var backupCardSdk: BackupCardSdk? = null
+  private var boundActivity: Activity? = null
   private val tag = "BackupCardSdkModule"
   private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)
+
+  private val apduLogger =
+          object : ApduLogger {
+            override fun log(message: String, isSent: Boolean, isSuccess: Boolean) {
+              val params =
+                      Arguments.createMap()
+                              .apply {
+                                putString("message", message)
+                                putBoolean("isSent", isSent)
+                                putBoolean("isSuccess", isSuccess)
+                              }
+                              .copy()
+              runCatching { emitOnApduLog(params) }
+                .onFailure { Log.w(tag, "Dropped apduLog event: JS callback is not ready", it) }
+            }
+          }
+
+  private val nfcTouchListener =
+          object : NfcTouchListener {
+            override fun onTouch(isBackupCard: Boolean) {
+              val params =
+                      Arguments.createMap()
+                              .apply { putBoolean("isBackupCard", isBackupCard) }
+                              .copy()
+              runCatching { emitOnNfcTouch(params) }
+                .onFailure { Log.w(tag, "Dropped nfcTouch event: JS callback is not ready", it) }
+            }
+          }
+
+  private fun ensureBackupCardSdk(activity: Activity?): BackupCardSdk? {
+    if (activity == null) return null
+    if (backupCardSdk != null && boundActivity === activity) return backupCardSdk
+
+    runCatching { backupCardSdk?.release() }
+      .onFailure { Log.e(tag, "Failed to release previous BackupCardSdk", it) }
+
+    boundActivity = activity
+    backupCardSdk = runCatching { BackupCardSdk(activity, apduLogger, nfcTouchListener) }
+      .onFailure { Log.e(tag, "Failed to initialize BackupCardSdk", it) }
+      .getOrNull()
+    return backupCardSdk
+  }
+
   override fun invalidate() {
     super.invalidate()
+    backupCardSdk?.cancelWaitForCardTag()
+    backupCardSdk?.release()
+    backupCardSdk = null
+    boundActivity = null
     scope.cancel()
   }
   private val mActivityEventListener =
           object : BaseActivityEventListener() {
             override fun onNewIntent(intent: Intent) {
               super.onNewIntent(intent)
-              backupCardSdk.handleIntent(intent)
+              runCatching {
+                backupCardSdk?.handleIntent(intent)
+              }.onFailure {
+                Log.e(tag, "Crash while handling NFC intent", it)
+              }
             }
           }
 
@@ -69,37 +102,76 @@ class BackupCardSdkModule(val reactContext: ReactApplicationContext) :
     super.initialize()
     Utils.init(reactContext)
     Utils.getActivityLifecycle()
-    val activity = Utils.getTopActivity()
-    if (activity == null) {
-      return
-    }
-    val apduLogger =
-            object : ApduLogger {
-              override fun log(message: String, isSent: Boolean, isSuccess: Boolean) {
-                val params =
-                        Arguments.createMap()
-                                .apply {
-                                  putString("message", message)
-                                  putBoolean("isSent", isSent)
-                                  putBoolean("isSuccess", isSuccess)
-                                }
-                                .copy()
-                emitOnApduLog(params)
-              }
-            }
-    val nfcTouchListener =
-            object : NfcTouchListener {
-              override fun onTouch(isBackupCard: Boolean) {
-                val params =
-                        Arguments.createMap()
-                                .apply { putBoolean("isBackupCard", isBackupCard) }
-                                .copy()
-                emitOnNfcTouch(params)
-              }
-            }
-    backupCardSdk = BackupCardSdk(activity, apduLogger, nfcTouchListener)
     reactContext.addActivityEventListener(mActivityEventListener)
     reactContext.addLifecycleEventListener(this)
+    ensureBackupCardSdk(Utils.getTopActivity())
+  }
+
+  private fun CardInfo.toCardInfoMap(): WritableMap {
+    val map = Arguments.createMap()
+    map.putString("serialNumber", serialNumber)
+    map.putInt("pinRetryCount", pinRetryCount ?: -1)
+    map.putBoolean("isNewCard", isNewCard ?: false)
+    val backup = isBackup
+    if (backup != null) {
+      map.putBoolean("isBackup", backup)
+    } else {
+      map.putNull("isBackup")
+    }
+    return map
+  }
+
+  private fun putOperationData(map: WritableMap, data: Any?) {
+    when (data) {
+      null -> map.putNull("data")
+      is Boolean -> map.putBoolean("data", data)
+      is Int -> map.putInt("data", data)
+      is Long -> map.putDouble("data", data.toDouble())
+      is Double -> map.putDouble("data", data)
+      is Float -> map.putDouble("data", data.toDouble())
+      is String -> map.putString("data", data)
+      is ByteArray -> map.putArray("data", data.asWritableArrayOrNull())
+      else -> map.putNull("data")
+    }
+  }
+
+  private fun CardOperationResult<*>.toCardOperationResultMap(): WritableMap {
+    val map = Arguments.createMap()
+    val cardError = error
+    val info = cardInfo
+    if (cardError != null) {
+      val errorMap = Arguments.createMap()
+      errorMap.putInt("code", cardError.code)
+      errorMap.putString("message", cardError.message)
+      map.putMap("error", errorMap)
+    } else {
+      map.putNull("error")
+    }
+    if (info != null) {
+      map.putMap("cardInfo", info.toCardInfoMap())
+    } else {
+      map.putNull("cardInfo")
+    }
+    map.putInt("resultCode", resultCode)
+    putOperationData(map, data)
+    return map
+  }
+
+  private fun ReadableArray.asByteArray(): ByteArray {
+    val bytes = ByteArray(size())
+    for (i in 0 until size()) {
+      bytes[i] = getInt(i).toByte()
+    }
+    return bytes
+  }
+
+  private fun ByteArray?.asWritableArrayOrNull(): WritableArray? {
+    if (this == null) return null
+    val array = Arguments.createArray()
+    for (b in this) {
+      array.pushInt(b.toInt() and 0xFF)
+    }
+    return array
   }
 
   companion object {
@@ -108,44 +180,125 @@ class BackupCardSdkModule(val reactContext: ReactApplicationContext) :
 
   override fun getCardInfo(promise: Promise) =
         promise.launchSuspend(
-                block = { backupCardSdk.getCardInfo() },
-                transform = { info -> info?.toWritableMap() }
+                block = {
+                  val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+                          ?: throw IllegalStateException("No foreground activity available")
+                  sdk.getCardInfo()
+                },
+                transform = { info -> info?.toCardInfoMap() }
         )
 
+  override fun cancelNfcWait() {
+    backupCardSdk?.cancelWaitForCardTag()
+  }
+
+  override fun checkNFCPermission(promise: Promise) {
+    val activity = Utils.getTopActivity()
+    if (activity == null) {
+      promise.rejectNfc(NfcExceptions.InitializedException("No foreground activity"))
+      return
+    }
+    if (!NfcUtils.isNfcExits(activity)) {
+      promise.rejectNfc(NfcExceptions.NotExistsNFC())
+      return
+    }
+    if (!NfcUtils.isNfcEnable(activity)) {
+      promise.rejectNfc(NfcExceptions.NotEnableNFC())
+      return
+    }
+    var granted = false
+    NfcPermissionUtils.checkPermission(activity) { granted = true }
+    if (granted) {
+      promise.resolve(true)
+    } else {
+      promise.rejectNfc(NfcExceptions.NotNFCPermission())
+    }
+  }
+
+  override fun intoSetting() {
+    val activity = Utils.getTopActivity() ?: return
+    NfcUtils.intentToNfcSetting(activity)
+  }
+
+  private fun Promise.rejectNfc(exception: NfcExceptions) {
+    val userInfo =
+            Arguments.createMap()
+                    .apply {
+                      putInt("code", exception.code)
+                      putString("message", exception.message ?: "")
+                    }
+                    .copy()
+    reject("NFC_ERROR", exception.message, null, userInfo)
+  }
+
     override fun resetCard(promise: Promise) =
       promise.launchSuspend(
-          block = { backupCardSdk.resetCard() },
+          block = {
+            val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+                    ?: throw IllegalStateException("No foreground activity available")
+            sdk.resetCard()
+          },
           transform = { result -> result }
       )
 
-      override fun activateCard(pwd: String, promise: Promise) =
+      override fun activateCard(pwd: String, serialNumber: String, promise: Promise) =
         promise.launchSuspend(
-          block = { backupCardSdk.activateCard(pwd) },
-          transform = { result -> result }
+          block = {
+            val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+                    ?: throw IllegalStateException("No foreground activity available")
+            sdk.activateCard(pwd, serialNumber)
+          },
+          transform = { result -> result.toCardOperationResultMap() }
         )
 
       override fun changePin(oldPin: String, newPin: String, promise: Promise) =
         promise.launchSuspend(
-          block = { backupCardSdk.changePin(oldPin, newPin) },
+          block = {
+            val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+                    ?: throw IllegalStateException("No foreground activity available")
+            sdk.changePin(oldPin, newPin)
+          },
           transform = { result -> result }
         )
 
       override fun checkSlotEmpty(slotId: Double, pwd: String, promise: Promise) =
         promise.launchSuspend(
-          block = { backupCardSdk.checkSlotEmpty(slotId.toInt(), pwd) },
-          transform = { result -> result }
+          block = {
+            val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+                    ?: throw IllegalStateException("No foreground activity available")
+            sdk.checkSlotEmpty(slotId.toInt(), pwd)
+          },
+          transform = { result -> result.toCardOperationResultMap() }
         )
 
       override fun writeSlot(slotIndex: Double, data: ReadableArray, pwd: String, promise: Promise) =
         promise.launchSuspend(
-          block = { backupCardSdk.writeSlot(slotIndex.toInt(), data.toByteArray(), pwd) },
-          transform = { result -> result }
+          block = {
+            val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+                    ?: throw IllegalStateException("No foreground activity available")
+            sdk.writeSlot(slotIndex.toInt(), data.asByteArray(), pwd)
+          },
+          transform = { result -> result.toCardOperationResultMap() }
         )
 
       override fun readSlot(slotIndex: Double, pwd: String, promise: Promise) =
         promise.launchSuspend(
-          block = { backupCardSdk.readSlot(slotIndex.toInt(), pwd) },
-          transform = { result -> result.toWritableArrayOrNull() }
+          block = {
+            val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+                    ?: throw IllegalStateException("No foreground activity available")
+            sdk.readSlot(slotIndex.toInt(), pwd)
+          },
+          transform = { result -> result.toCardOperationResultMap() }
+        )
+
+      override fun deleteSlot(slotIndex: Double, pwd: String, promise: Promise) =
+        promise.launchSuspend(
+          block = {
+            val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+                    ?: throw IllegalStateException("No foreground activity available")
+            sdk.deleteSlot(slotIndex.toInt(), pwd)
+          },
+          transform = { result -> result.toCardOperationResultMap() }
         )
 
 
@@ -154,7 +307,12 @@ class BackupCardSdkModule(val reactContext: ReactApplicationContext) :
           dispatcher: CoroutineDispatcher = Dispatchers.IO,
           block: suspend () -> T,
           transform: (T) -> R,
-          errorCode: (Throwable) -> String = { "E_UNEXPECTED" }
+          errorCode: (Throwable) -> String = { throwable ->
+            when (throwable) {
+              is NfcWaitTimeoutException -> "NFC_WAIT_TIMEOUT"
+              else -> "E_UNEXPECTED"
+            }
+          }
   ) {
     scope.launch {
       try {
@@ -170,14 +328,26 @@ class BackupCardSdkModule(val reactContext: ReactApplicationContext) :
   }
 
   override fun onHostResume() {
-    backupCardSdk.onActivityResumed()
+    runCatching {
+      val sdk = ensureBackupCardSdk(Utils.getTopActivity())
+      sdk?.onActivityResumed()
+      if (sdk != null) {
+        Log.i(tag, "NFC foreground dispatch enabled automatically on app resume.")
+      } else {
+        Log.w(tag, "Skipped NFC foreground dispatch: no foreground activity.")
+      }
+    }.onFailure {
+      Log.e(tag, "Failed to enable NFC foreground dispatch on resume", it)
+    }
   }
 
   override fun onHostPause() {
-    backupCardSdk.onActivityPaused()
+    runCatching { backupCardSdk?.onActivityPaused() }
+      .onFailure { Log.e(tag, "Failed to disable NFC foreground dispatch on pause", it) }
   }
 
   override fun onHostDestroy() {
-    backupCardSdk.onActivityDestroyed()
+    runCatching { backupCardSdk?.onActivityDestroyed() }
+      .onFailure { Log.e(tag, "Failed to cleanup NFC on destroy", it) }
   }
 }

package/android/src/main/java/com/ziancube/reactnativebackupcardsdk/BackupCardSdkPackage.kt

@@ -22,7 +22,7 @@ class BackupCardSdkPackage : BaseReactPackage() {
         name = BackupCardSdkModule.NAME,
         className = BackupCardSdkModule.NAME,
         canOverrideExistingModule = false,
-        needsEagerInit = false,
+        needsEagerInit = true,
         isCxxModule = false,
         isTurboModule = true
       )

package/android/src/main/java/com/ziancube/reactnativebackupcardsdk/nfc/NfcExceptions.kt

@@ -0,0 +1,11 @@
+package com.ziancube.reactnativebackupcardsdk.nfc
+
+sealed class NfcExceptions(val code: Int, override val message: String? = null) : Exception(message) {
+  class InitializedException(message: String? = null) : NfcExceptions(4001, message)
+
+  class NotExistsNFC(message: String? = null) : NfcExceptions(1001, message)
+
+  class NotEnableNFC(message: String? = null) : NfcExceptions(1002, message)
+
+  class NotNFCPermission(message: String? = null) : NfcExceptions(1003, message)
+}

package/android/src/main/java/com/ziancube/reactnativebackupcardsdk/nfc/NfcUtils.kt

@@ -0,0 +1,30 @@
+package com.ziancube.reactnativebackupcardsdk.nfc
+
+import android.content.Context
+import android.content.Intent
+import android.nfc.NfcAdapter
+import android.provider.Settings
+
+object NfcUtils {
+  fun isNfcExits(context: Context): Boolean {
+    return NfcAdapter.getDefaultAdapter(context) != null
+  }
+
+  fun isNfcEnable(context: Context): Boolean {
+    val nfcAdapter = NfcAdapter.getDefaultAdapter(context)
+    return nfcAdapter != null && nfcAdapter.isEnabled
+  }
+
+  fun intentToNfcSetting(context: Context): Boolean {
+    if (!isNfcExits(context)) {
+      return false
+    }
+    return try {
+      context.startActivity(Intent(Settings.ACTION_NFC_SETTINGS))
+      true
+    } catch (ex: Exception) {
+      ex.printStackTrace()
+      false
+    }
+  }
+}

package/android/src/main/java/com/ziancube/reactnativebackupcardsdk/utils/MiUtil.kt

@@ -0,0 +1,74 @@
+package com.ziancube.reactnativebackupcardsdk.utils
+
+import android.app.AppOpsManager
+import android.content.Context
+import android.content.Intent
+import android.net.Uri
+import android.os.Build
+import android.provider.Settings
+import android.util.Log
+import androidx.annotation.IntDef
+import androidx.annotation.RequiresApi
+
+object MiUtil {
+  private const val TAG = "BackupCardSdkMiUtil"
+
+  @IntDef(
+          value =
+                  [
+                    PermissionResult.PERMISSION_GRANTED,
+                    PermissionResult.PERMISSION_DENIED,
+                    PermissionResult.PERMISSION_ASK,
+                    PermissionResult.PERMISSION_UNKNOWN,
+                  ]
+  )
+  @Retention(AnnotationRetention.SOURCE)
+  annotation class PermissionResult {
+    companion object {
+      const val PERMISSION_GRANTED = 0
+      const val PERMISSION_DENIED = -1
+      const val PERMISSION_ASK = 1
+      const val PERMISSION_UNKNOWN = 2
+    }
+  }
+
+  @PermissionResult
+  @RequiresApi(Build.VERSION_CODES.KITKAT)
+  fun checkNfcPermission(context: Context): Int {
+    try {
+      val appOps = context.getSystemService(Context.APP_OPS_SERVICE) as AppOpsManager
+      val pkg = context.applicationContext.packageName
+      val uid = context.applicationInfo.uid
+      val appOpsClass = Class.forName(AppOpsManager::class.java.name)
+      val checkOpNoThrowMethod =
+              appOpsClass.getDeclaredMethod(
+                      "checkOpNoThrow",
+                      Integer.TYPE,
+                      Integer.TYPE,
+                      String::class.java,
+              )
+      val invoke = checkOpNoThrowMethod.invoke(appOps, 10016, uid, pkg) ?: return PermissionResult.PERMISSION_UNKNOWN
+      return when (invoke.toString()) {
+        "0" -> PermissionResult.PERMISSION_GRANTED
+        "1" -> PermissionResult.PERMISSION_DENIED
+        "5" -> PermissionResult.PERMISSION_ASK
+        else -> PermissionResult.PERMISSION_UNKNOWN
+      }
+    } catch (e: Exception) {
+      Log.d(TAG, "check nfc permission fail: ${e.message}")
+    }
+    return PermissionResult.PERMISSION_UNKNOWN
+  }
+
+  fun intentToAppSetting(context: Context): Boolean {
+    val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)
+    intent.data = Uri.fromParts("package", context.packageName, null)
+    return try {
+      context.startActivity(intent)
+      true
+    } catch (e: Exception) {
+      Log.d(TAG, "open app setting fail: ${e.message}")
+      false
+    }
+  }
+}

package/android/src/main/java/com/ziancube/reactnativebackupcardsdk/utils/NfcPermissionUtils.kt

@@ -0,0 +1,23 @@
+package com.ziancube.reactnativebackupcardsdk.utils
+
+import android.app.Activity
+import android.os.Build
+
+object NfcPermissionUtils {
+  inline fun checkPermission(activity: Activity, doNext: () -> Unit): Int {
+    return if ("xiaomi".equals(Build.MANUFACTURER, ignoreCase = true)) {
+      checkMiuiPermission(activity, doNext)
+    } else {
+      doNext.invoke()
+      0
+    }
+  }
+
+  inline fun checkMiuiPermission(activity: Activity, doNext: () -> Unit): Int {
+    when (MiUtil.checkNfcPermission(activity)) {
+      MiUtil.PermissionResult.PERMISSION_GRANTED -> doNext.invoke()
+      else -> {}
+    }
+    return MiUtil.checkNfcPermission(activity)
+  }
+}

package/lib/module/NativeBackupCardSdk.js

@@ -1,5 +1,8 @@
 "use strict";
 
 import { TurboModuleRegistry } from 'react-native';
+
+/** App-layer result type (same pattern as react-native-lite-card PromiseResult). */
+
 export default TurboModuleRegistry.getEnforcing('BackupCardSdk');
 //# sourceMappingURL=NativeBackupCardSdk.js.map

package/lib/module/NativeBackupCardSdk.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeBackupCardSdk.ts"],"mappings":";;AAAA,SACEA,mBAAmB,QAGd,cAAc;AAgCrB,eAAeA,mBAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeBackupCardSdk.ts"],"mappings":";;AAAA,SACEA,mBAAmB,QAGd,cAAc;;AAWrB;;AA+EA,eAAeA,mBAAmB,CAACC,YAAY,CAAO,eAAe,CAAC","ignoreList":[]}

package/lib/module/cardOperations.js

@@ -0,0 +1,27 @@
+"use strict";
+
+import BackupCardSdk from "./NativeBackupCardSdk.js";
+function withoutData(result) {
+  return {
+    error: result.error,
+    cardInfo: result.cardInfo,
+    resultCode: result.resultCode,
+    data: null
+  };
+}
+export async function activateCard(pwd, serialNumber) {
+  return withoutData(await BackupCardSdk.activateCard(pwd, serialNumber));
+}
+export async function checkSlotEmpty(slotId, pwd) {
+  return withoutData(await BackupCardSdk.checkSlotEmpty(slotId, pwd));
+}
+export async function writeSlot(slotIndex, data, pwd) {
+  return withoutData(await BackupCardSdk.writeSlot(slotIndex, data, pwd));
+}
+export async function readSlot(slotIndex, pwd) {
+  return BackupCardSdk.readSlot(slotIndex, pwd);
+}
+export async function deleteSlot(slotIndex, pwd) {
+  return withoutData(await BackupCardSdk.deleteSlot(slotIndex, pwd));
+}
+//# sourceMappingURL=cardOperations.js.map

package/lib/module/cardOperations.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BackupCardSdk","withoutData","result","error","cardInfo","resultCode","data","activateCard","pwd","serialNumber","checkSlotEmpty","slotId","writeSlot","slotIndex","readSlot","deleteSlot"],"sourceRoot":"../../src","sources":["cardOperations.ts"],"mappings":";;AAAA,OAAOA,aAAa,MAAM,0BAAuB;AAejD,SAASC,WAAWA,CAClBC,MAAiC,EACN;EAC3B,OAAO;IACLC,KAAK,EAAED,MAAM,CAACC,KAAK;IACnBC,QAAQ,EAAEF,MAAM,CAACE,QAAQ;IACzBC,UAAU,EAAEH,MAAM,CAACG,UAAU;IAC7BC,IAAI,EAAE;EACR,CAAC;AACH;AAEA,OAAO,eAAeC,YAAYA,CAChCC,GAAW,EACXC,YAAoB,EACgB;EACpC,OAAOR,WAAW,CAAC,MAAMD,aAAa,CAACO,YAAY,CAACC,GAAG,EAAEC,YAAY,CAAC,CAAC;AACzE;AAEA,OAAO,eAAeC,cAAcA,CAClCC,MAAc,EACdH,GAAW,EACyB;EACpC,OAAOP,WAAW,CAAC,MAAMD,aAAa,CAACU,cAAc,CAACC,MAAM,EAAEH,GAAG,CAAC,CAAC;AACrE;AAEA,OAAO,eAAeI,SAASA,CAC7BC,SAAiB,EACjBP,IAAmB,EACnBE,GAAW,EACyB;EACpC,OAAOP,WAAW,CAAC,MAAMD,aAAa,CAACY,SAAS,CAACC,SAAS,EAAEP,IAAI,EAAEE,GAAG,CAAC,CAAC;AACzE;AAEA,OAAO,eAAeM,QAAQA,CAC5BD,SAAiB,EACjBL,GAAW,EAC2B;EACtC,OAAOR,aAAa,CAACc,QAAQ,CAACD,SAAS,EAAEL,GAAG,CAAC;AAC/C;AAEA,OAAO,eAAeO,UAAUA,CAC9BF,SAAiB,EACjBL,GAAW,EACyB;EACpC,OAAOP,WAAW,CAAC,MAAMD,aAAa,CAACe,UAAU,CAACF,SAAS,EAAEL,GAAG,CAAC,CAAC;AACpE","ignoreList":[]}

package/lib/module/index.js

@@ -1,5 +1,7 @@
 "use strict";
 
 import BackupCardSdk from "./NativeBackupCardSdk.js";
+export { CardErrors, cancelNfcWait, checkNFCPermission, intoSetting } from "./nfc.js";
+export { activateCard, checkSlotEmpty, deleteSlot, readSlot, writeSlot } from "./cardOperations.js";
 export default BackupCardSdk;
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["BackupCardSdk"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,aAAa,MAAM,0BAAuB;AAGjD,eAAeA,aAAa","ignoreList":[]}
+{"version":3,"names":["BackupCardSdk","CardErrors","cancelNfcWait","checkNFCPermission","intoSetting","activateCard","checkSlotEmpty","deleteSlot","readSlot","writeSlot"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,aAAa,MAAM,0BAAuB;AASjD,SACEC,UAAU,EACVC,aAAa,EACbC,kBAAkB,EAClBC,WAAW,QACN,UAAO;AACd,SACEC,YAAY,EACZC,cAAc,EACdC,UAAU,EACVC,QAAQ,EACRC,SAAS,QACJ,qBAAkB;AAEzB,eAAeT,aAAa","ignoreList":[]}

package/lib/module/nfc.js

@@ -0,0 +1,75 @@
+"use strict";
+
+import { Platform } from 'react-native';
+import BackupCardSdk from "./NativeBackupCardSdk.js";
+/** Same error codes as @digitalshieldfe/react-native-lite-card for NFC checks. */
+export let CardErrors = /*#__PURE__*/function (CardErrors) {
+  CardErrors[CardErrors["InitChannel"] = 1000] = "InitChannel";
+  CardErrors[CardErrors["NotExistsNFC"] = 1001] = "NotExistsNFC";
+  CardErrors[CardErrors["NotEnableNFC"] = 1002] = "NotEnableNFC";
+  CardErrors[CardErrors["NotNFCPermission"] = 1003] = "NotNFCPermission";
+  CardErrors[CardErrors["ConnectionFail"] = 2001] = "ConnectionFail";
+  CardErrors[CardErrors["NotSameNFCLite"] = 2002] = "NotSameNFCLite";
+  CardErrors[CardErrors["ActivateCardFailed"] = 2003] = "ActivateCardFailed";
+  CardErrors[CardErrors["NotSupportedCard"] = 2004] = "NotSupportedCard";
+  CardErrors[CardErrors["PasswordWrong"] = 2005] = "PasswordWrong";
+  CardErrors[CardErrors["NotSetPassword"] = 2006] = "NotSetPassword";
+  CardErrors[CardErrors["CardLock"] = 2007] = "CardLock";
+  CardErrors[CardErrors["NotInitializedError"] = 2008] = "NotInitializedError";
+  CardErrors[CardErrors["InitializedError"] = 4001] = "InitializedError";
+  return CardErrors;
+}({});
+function parseTurboModuleError(error) {
+  const err = error;
+  const code = err?.userInfo?.code;
+  if (typeof code === 'number') {
+    return {
+      code,
+      message: err.userInfo?.message ?? err.message ?? null
+    };
+  }
+  return {
+    code: CardErrors.InitChannel,
+    message: err?.message ?? null
+  };
+}
+
+/** Android only for now; iOS will be added later. */
+export function checkNFCPermission() {
+  if (Platform.OS !== 'android') {
+    return Promise.resolve({
+      error: {
+        code: CardErrors.InitChannel,
+        message: 'checkNFCPermission is not implemented on iOS yet'
+      },
+      data: null,
+      cardInfo: null,
+      resultCode: -1
+    });
+  }
+  return BackupCardSdk.checkNFCPermission().then(() => ({
+    error: null,
+    data: true,
+    cardInfo: null,
+    resultCode: 0
+  })).catch(error => ({
+    error: parseTurboModuleError(error),
+    data: null,
+    cardInfo: null,
+    resultCode: -1
+  }));
+}
+
+/** Android only for now; iOS will be added later. */
+export function intoSetting() {
+  if (Platform.OS !== 'android') {
+    return;
+  }
+  BackupCardSdk.intoSetting();
+}
+
+/** Call when user dismisses the "tap card" UI to stop waiting. Android only. */
+export function cancelNfcWait() {
+  BackupCardSdk.cancelNfcWait();
+}
+//# sourceMappingURL=nfc.js.map

package/lib/module/nfc.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","BackupCardSdk","CardErrors","parseTurboModuleError","error","err","code","userInfo","message","InitChannel","checkNFCPermission","OS","Promise","resolve","data","cardInfo","resultCode","then","catch","intoSetting","cancelNfcWait"],"sourceRoot":"../../src","sources":["nfc.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AAEvC,OAAOC,aAAa,MAAM,0BAAuB;AAMjD;AACA,WAAYC,UAAU,0BAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAVA,UAAU,CAAVA,UAAU;EAAA,OAAVA,UAAU;AAAA;AAkBtB,SAASC,qBAAqBA,CAACC,KAAc,EAAiB;EAC5D,MAAMC,GAAG,GAAGD,KAGX;EACD,MAAME,IAAI,GAAGD,GAAG,EAAEE,QAAQ,EAAED,IAAI;EAChC,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE;IAC5B,OAAO;MAAEA,IAAI;MAAEE,OAAO,EAAEH,GAAG,CAACE,QAAQ,EAAEC,OAAO,IAAIH,GAAG,CAACG,OAAO,IAAI;IAAK,CAAC;EACxE;EACA,OAAO;IAAEF,IAAI,EAAEJ,UAAU,CAACO,WAAW;IAAED,OAAO,EAAEH,GAAG,EAAEG,OAAO,IAAI;EAAK,CAAC;AACxE;;AAEA;AACA,OAAO,SAASE,kBAAkBA,CAAA,EAAoC;EACpE,IAAIV,QAAQ,CAACW,EAAE,KAAK,SAAS,EAAE;IAC7B,OAAOC,OAAO,CAACC,OAAO,CAAC;MACrBT,KAAK,EAAE;QACLE,IAAI,EAAEJ,UAAU,CAACO,WAAW;QAC5BD,OAAO,EAAE;MACX,CAAC;MACDM,IAAI,EAAE,IAAI;MACVC,QAAQ,EAAE,IAAI;MACdC,UAAU,EAAE,CAAC;IACf,CAAC,CAAC;EACJ;EACA,OAAOf,aAAa,CAACS,kBAAkB,CAAC,CAAC,CACtCO,IAAI,CAAC,OAAO;IAAEb,KAAK,EAAE,IAAI;IAAEU,IAAI,EAAE,IAAI;IAAEC,QAAQ,EAAE,IAAI;IAAEC,UAAU,EAAE;EAAE,CAAC,CAAC,CAAC,CACxEE,KAAK,CAAEd,KAAc,KAAM;IAC1BA,KAAK,EAAED,qBAAqB,CAACC,KAAK,CAAC;IACnCU,IAAI,EAAE,IAAI;IACVC,QAAQ,EAAE,IAAI;IACdC,UAAU,EAAE,CAAC;EACf,CAAC,CAAC,CAAC;AACP;;AAEA;AACA,OAAO,SAASG,WAAWA,CAAA,EAAS;EAClC,IAAInB,QAAQ,CAACW,EAAE,KAAK,SAAS,EAAE;IAC7B;EACF;EACAV,aAAa,CAACkB,WAAW,CAAC,CAAC;AAC7B;;AAEA;AACA,OAAO,SAASC,aAAaA,CAAA,EAAS;EACpCnB,aAAa,CAACmB,aAAa,CAAC,CAAC;AAC/B","ignoreList":[]}

package/lib/typescript/src/NativeBackupCardSdk.d.ts

@@ -3,15 +3,61 @@ export type CardInfo = {
     serialNumber: string | null;
     pinRetryCount: number | null;
     isNewCard: boolean | null;
+    isBackup: boolean | null;
 };
+export type CallbackError = {
+    code: number;
+    message: string | null;
+};
+/** App-layer result type (same pattern as react-native-lite-card PromiseResult). */
+export type PromiseResult<T> = {
+    error: CallbackError | null;
+    data: T | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+};
+export type CardOperationResult<T> = PromiseResult<T>;
 export interface Spec extends TurboModule {
+    /** Waits for user to tap the backup card (Android), then reads card info. */
     getCardInfo(): Promise<CardInfo | null>;
+    /** Cancels an in-flight wait for NFC tap (Android). */
+    cancelNfcWait(): void;
+    /** Android: hardware NFC, system switch, MIUI permission. iOS: not implemented yet. */
+    checkNFCPermission(): Promise<boolean>;
+    /** Android: opens system NFC settings. iOS: not implemented yet. */
+    intoSetting(): void;
     resetCard(): Promise<Boolean>;
-    activateCard(pwd: string): Promise<Boolean>;
+    activateCard(pwd: string, serialNumber: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
     changePin(oldPin: string, newPin: string): Promise<Boolean>;
-    checkSlotEmpty(slotId: number, pwd: string): Promise<Boolean>;
-    writeSlot(slotIndex: number, data: Array<number>, pwd: string): Promise<Boolean>;
-    readSlot(slotIndex: number, pwd: string): Promise<Array<number> | null>;
+    checkSlotEmpty(slotId: number, pwd: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
+    writeSlot(slotIndex: number, data: Array<number>, pwd: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
+    readSlot(slotIndex: number, pwd: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
+    deleteSlot(slotIndex: number, pwd: string): Promise<{
+        error: CallbackError | null;
+        cardInfo: CardInfo | null;
+        resultCode: number;
+        data: string | null;
+    }>;
     readonly onApduLog: CodegenTypes.EventEmitter<{
         message: string;
         isSent: boolean;

package/lib/typescript/src/NativeBackupCardSdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeBackupCardSdk.d.ts","sourceRoot":"","sources":["../../../src/NativeBackupCardSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,WAAW,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACxC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IAExE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,YAAY,CAAC;QAC5C,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC;QAC7C,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC,CAAC;CACJ;;AAED,wBAAuE"}
+{"version":3,"file":"NativeBackupCardSdk.d.ts","sourceRoot":"","sources":["../../../src/NativeBackupCardSdk.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/cardOperations.d.ts

@@ -0,0 +1,7 @@
+import type { CardOperationResult } from './NativeBackupCardSdk';
+export declare function activateCard(pwd: string, serialNumber: string): Promise<CardOperationResult<null>>;
+export declare function checkSlotEmpty(slotId: number, pwd: string): Promise<CardOperationResult<null>>;
+export declare function writeSlot(slotIndex: number, data: Array<number>, pwd: string): Promise<CardOperationResult<null>>;
+export declare function readSlot(slotIndex: number, pwd: string): Promise<CardOperationResult<string>>;
+export declare function deleteSlot(slotIndex: number, pwd: string): Promise<CardOperationResult<null>>;
+//# sourceMappingURL=cardOperations.d.ts.map

package/lib/typescript/src/cardOperations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardOperations.d.ts","sourceRoot":"","sources":["../../../src/cardOperations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAoB/B,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAEpC;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAEpC;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAEpC;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAEtC;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAEpC"}

package/lib/typescript/src/index.d.ts

@@ -1,5 +1,8 @@
 import BackupCardSdk from './NativeBackupCardSdk';
-import type { CardInfo } from './NativeBackupCardSdk';
-export type { CardInfo };
+import type { CardInfo, CardOperationResult, PromiseResult } from './NativeBackupCardSdk';
+export type { CardInfo, CardOperationResult, PromiseResult };
+export type { CallbackError } from './nfc';
+export { CardErrors, cancelNfcWait, checkNFCPermission, intoSetting, } from './nfc';
+export { activateCard, checkSlotEmpty, deleteSlot, readSlot, writeSlot, } from './cardOperations';
 export default BackupCardSdk;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,CAAC;AACzB,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EACV,QAAQ,EACR,mBAAmB,EACnB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,aAAa,EAAE,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EACL,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,OAAO,CAAC;AACf,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,eAAe,aAAa,CAAC"}

package/lib/typescript/src/nfc.d.ts

@@ -0,0 +1,28 @@
+import type { PromiseResult } from './NativeBackupCardSdk';
+export type CallbackError = {
+    code: number;
+    message: string | null;
+} | null;
+/** Same error codes as @digitalshieldfe/react-native-lite-card for NFC checks. */
+export declare enum CardErrors {
+    InitChannel = 1000,
+    NotExistsNFC = 1001,
+    NotEnableNFC = 1002,
+    NotNFCPermission = 1003,
+    ConnectionFail = 2001,
+    NotSameNFCLite = 2002,
+    ActivateCardFailed = 2003,
+    NotSupportedCard = 2004,
+    PasswordWrong = 2005,
+    NotSetPassword = 2006,
+    CardLock = 2007,
+    NotInitializedError = 2008,
+    InitializedError = 4001
+}
+/** Android only for now; iOS will be added later. */
+export declare function checkNFCPermission(): Promise<PromiseResult<boolean>>;
+/** Android only for now; iOS will be added later. */
+export declare function intoSetting(): void;
+/** Call when user dismisses the "tap card" UI to stop waiting. Android only. */
+export declare function cancelNfcWait(): void;
+//# sourceMappingURL=nfc.d.ts.map

package/lib/typescript/src/nfc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfc.d.ts","sourceRoot":"","sources":["../../../src/nfc.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC;AAE5E,kFAAkF;AAClF,oBAAY,UAAU;IACpB,WAAW,OAAO;IAClB,YAAY,OAAO;IACnB,YAAY,OAAO;IACnB,gBAAgB,OAAO;IAEvB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,kBAAkB,OAAO;IACzB,gBAAgB,OAAO;IACvB,aAAa,OAAO;IACpB,cAAc,OAAO;IACrB,QAAQ,OAAO;IACf,mBAAmB,OAAO;IAE1B,gBAAgB,OAAO;CACxB;AAcD,qDAAqD;AACrD,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAoBpE;AAED,qDAAqD;AACrD,wBAAgB,WAAW,IAAI,IAAI,CAKlC;AAED,gFAAgF;AAChF,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@digitalshieldfe/react-native-backup-card-sdk",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "ds react-native backup-card sdk",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
     ".": {
-      "source": "./src/index.tsx",
       "types": "./lib/typescript/src/index.d.ts",
+      "react-native": "./src/index.tsx",
       "default": "./lib/module/index.js"
     },
     "./package.json": "./package.json"

package/src/NativeBackupCardSdk.ts

@@ -8,20 +8,78 @@ export type CardInfo = {
   serialNumber: string | null;
   pinRetryCount: number | null;
   isNewCard: boolean | null;
+  isBackup: boolean | null;
 };
 
+export type CallbackError = { code: number; message: string | null };
+
+/** App-layer result type (same pattern as react-native-lite-card PromiseResult). */
+export type PromiseResult<T> = {
+  error: CallbackError | null;
+  data: T | null;
+  cardInfo: CardInfo | null;
+  resultCode: number;
+};
+
+export type CardOperationResult<T> = PromiseResult<T>;
+
 export interface Spec extends TurboModule {
+  /** Waits for user to tap the backup card (Android), then reads card info. */
   getCardInfo(): Promise<CardInfo | null>;
+  /** Cancels an in-flight wait for NFC tap (Android). */
+  cancelNfcWait(): void;
+  /** Android: hardware NFC, system switch, MIUI permission. iOS: not implemented yet. */
+  checkNFCPermission(): Promise<boolean>;
+  /** Android: opens system NFC settings. iOS: not implemented yet. */
+  intoSetting(): void;
   resetCard(): Promise<Boolean>;
-  activateCard(pwd: string): Promise<Boolean>;
+  activateCard(
+    pwd: string,
+    serialNumber: string
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
   changePin(oldPin: string, newPin: string): Promise<Boolean>;
-  checkSlotEmpty(slotId: number, pwd: string): Promise<Boolean>;
+  checkSlotEmpty(
+    slotId: number,
+    pwd: string
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
   writeSlot(
     slotIndex: number,
     data: Array<number>,
     pwd: string
-  ): Promise<Boolean>;
-  readSlot(slotIndex: number, pwd: string): Promise<Array<number> | null>;
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
+  readSlot(
+    slotIndex: number,
+    pwd: string
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
+  deleteSlot(
+    slotIndex: number,
+    pwd: string
+  ): Promise<{
+    error: CallbackError | null;
+    cardInfo: CardInfo | null;
+    resultCode: number;
+    data: string | null;
+  }>;
 
   readonly onApduLog: CodegenTypes.EventEmitter<{
     message: string;

package/src/cardOperations.ts

@@ -0,0 +1,61 @@
+import BackupCardSdk from './NativeBackupCardSdk';
+
+import type {
+  CallbackError,
+  CardInfo,
+  CardOperationResult,
+} from './NativeBackupCardSdk';
+
+type NativeCardOperationResult = {
+  error: CallbackError | null;
+  cardInfo: CardInfo | null;
+  resultCode: number;
+  data: string | null;
+};
+
+function withoutData(
+  result: NativeCardOperationResult
+): CardOperationResult<null> {
+  return {
+    error: result.error,
+    cardInfo: result.cardInfo,
+    resultCode: result.resultCode,
+    data: null,
+  };
+}
+
+export async function activateCard(
+  pwd: string,
+  serialNumber: string
+): Promise<CardOperationResult<null>> {
+  return withoutData(await BackupCardSdk.activateCard(pwd, serialNumber));
+}
+
+export async function checkSlotEmpty(
+  slotId: number,
+  pwd: string
+): Promise<CardOperationResult<null>> {
+  return withoutData(await BackupCardSdk.checkSlotEmpty(slotId, pwd));
+}
+
+export async function writeSlot(
+  slotIndex: number,
+  data: Array<number>,
+  pwd: string
+): Promise<CardOperationResult<null>> {
+  return withoutData(await BackupCardSdk.writeSlot(slotIndex, data, pwd));
+}
+
+export async function readSlot(
+  slotIndex: number,
+  pwd: string
+): Promise<CardOperationResult<string>> {
+  return BackupCardSdk.readSlot(slotIndex, pwd);
+}
+
+export async function deleteSlot(
+  slotIndex: number,
+  pwd: string
+): Promise<CardOperationResult<null>> {
+  return withoutData(await BackupCardSdk.deleteSlot(slotIndex, pwd));
+}

package/src/index.tsx

@@ -1,4 +1,24 @@
 import BackupCardSdk from './NativeBackupCardSdk';
-import type { CardInfo } from './NativeBackupCardSdk';
-export type { CardInfo };
+import type {
+  CardInfo,
+  CardOperationResult,
+  PromiseResult,
+} from './NativeBackupCardSdk';
+
+export type { CardInfo, CardOperationResult, PromiseResult };
+export type { CallbackError } from './nfc';
+export {
+  CardErrors,
+  cancelNfcWait,
+  checkNFCPermission,
+  intoSetting,
+} from './nfc';
+export {
+  activateCard,
+  checkSlotEmpty,
+  deleteSlot,
+  readSlot,
+  writeSlot,
+} from './cardOperations';
+
 export default BackupCardSdk;

package/src/nfc.ts

@@ -0,0 +1,74 @@
+import { Platform } from 'react-native';
+
+import BackupCardSdk from './NativeBackupCardSdk';
+
+import type { PromiseResult } from './NativeBackupCardSdk';
+
+export type CallbackError = { code: number; message: string | null } | null;
+
+/** Same error codes as @digitalshieldfe/react-native-lite-card for NFC checks. */
+export enum CardErrors {
+  InitChannel = 1000,
+  NotExistsNFC = 1001,
+  NotEnableNFC = 1002,
+  NotNFCPermission = 1003,
+
+  ConnectionFail = 2001,
+  NotSameNFCLite = 2002,
+  ActivateCardFailed = 2003,
+  NotSupportedCard = 2004,
+  PasswordWrong = 2005,
+  NotSetPassword = 2006,
+  CardLock = 2007,
+  NotInitializedError = 2008,
+
+  InitializedError = 4001,
+}
+
+function parseTurboModuleError(error: unknown): CallbackError {
+  const err = error as {
+    message?: string;
+    userInfo?: { code?: number; message?: string };
+  };
+  const code = err?.userInfo?.code;
+  if (typeof code === 'number') {
+    return { code, message: err.userInfo?.message ?? err.message ?? null };
+  }
+  return { code: CardErrors.InitChannel, message: err?.message ?? null };
+}
+
+/** Android only for now; iOS will be added later. */
+export function checkNFCPermission(): Promise<PromiseResult<boolean>> {
+  if (Platform.OS !== 'android') {
+    return Promise.resolve({
+      error: {
+        code: CardErrors.InitChannel,
+        message: 'checkNFCPermission is not implemented on iOS yet',
+      },
+      data: null,
+      cardInfo: null,
+      resultCode: -1,
+    });
+  }
+  return BackupCardSdk.checkNFCPermission()
+    .then(() => ({ error: null, data: true, cardInfo: null, resultCode: 0 }))
+    .catch((error: unknown) => ({
+      error: parseTurboModuleError(error),
+      data: null,
+      cardInfo: null,
+      resultCode: -1,
+    }));
+}
+
+/** Android only for now; iOS will be added later. */
+export function intoSetting(): void {
+  if (Platform.OS !== 'android') {
+    return;
+  }
+  BackupCardSdk.intoSetting();
+}
+
+/** Call when user dismisses the "tap card" UI to stop waiting. Android only. */
+export function cancelNfcWait(): void {
+  BackupCardSdk.cancelNfcWait();
+}