@icedevml/react-native-host-card-emulation 0.6.3 → 0.7.0

package/README.md

@@ -200,6 +200,11 @@ This function will throw an exception if:
 * you are in the cooldown period where you are not allowed to acquire the presentment intent assertion (cooldown is 15 seconds after the previous assertion had expired);
 * the feature is not supported or the device is not eligible for whatever reason;
 
+Whenever you don't need the exclusive NFC access anymore, call the following function to release the `NFCPresentmentIntentAssertion` object:
+```typescript
+await NativeHCEModule.releaseExclusiveNFC();
+```
+
 Call `NativeHCEModule.isExclusiveNFC()` to check if exclusive NFC access is still active.
 
 ### Android: Handle HCE calls when the app is not running

package/android/src/main/java/com/itsecrnd/rtnhceandroid/RTNHCEAndroidModule.java

@@ -119,6 +119,12 @@ public class RTNHCEAndroidModule extends NativeHCEModuleSpec {
         promise.reject("err_platform_unsupported", "acquireExclusiveNFC() is not supported on Android.");
     }
 
+    @Override
+    public void releaseExclusiveNFC() {
+        Log.d(TAG, "RTNHCEAndroidModule:releaseExclusiveNFC");
+        // unsupported on Android, no-op
+    }
+
     @Override
     public boolean isExclusiveNFC() {
         Log.d(TAG, "RTNHCEAndroidModule:isExclusiveNFC");

package/ios/RTNHCEModuleIOS.mm

@@ -50,6 +50,12 @@
     }
 }
 
+- (void)releaseExclusiveNFC {
+    if (@available(iOS 17.4, *)) {
+        [hcemoduleios releaseExclusiveNFC];
+    }
+}
+
 - (nonnull NSNumber *)isExclusiveNFC {
     if (@available(iOS 17.4, *)) {
         return [hcemoduleios isExclusiveNFC] ? @1 : @0;
@@ -90,6 +96,10 @@
     return @0;
 }
 
+- (nonnull NSNumber *)finishBackgroundHCE:(nonnull NSString *)handle {
+    return @0;
+}
+
 - (void)startHCE:(nonnull RCTPromiseResolveBlock)resolve reject:(nonnull RCTPromiseRejectBlock)reject {
     if (@available(iOS 17.4, *)) {
         return [hcemoduleios startHCEWithResolve:resolve reject:reject];

package/ios/RTNHCEModuleIOSImpl.swift

@@ -34,6 +34,21 @@ extension Data {
 
   @objc public func acquireExclusiveNFC(resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
     Task.init {
+      guard NFCReaderSession.readingAvailable else {
+        reject("err_nfc_reader_not_available", "Preflight check failed: NFCReaderSession.readingAvailable is false", nil)
+        return
+      }
+
+      guard CardSession.isSupported else {
+        reject("err_card_session_unsupported", "Preflight check failed: CardSession.isSupported is false", nil)
+        return
+      }
+
+      guard await CardSession.isEligible else {
+        reject("err_card_session_not_eligible", "Preflight check failed: CardSession.isEligible is false", nil)
+        return
+      }
+
       if self.presentmentIntent != nil && self.presentmentIntent!.isValid {
         reject("err_already_exists", "NFCPresentmentIntentAssertion already exists and is valid.", nil)
         return
@@ -44,8 +59,7 @@ extension Data {
       do {
         self.presentmentIntent = try await NFCPresentmentIntentAssertion.acquire()
       } catch (let error) {
-        // TODO exact error details here and in other places as well
-        reject("err_create_presentment", "Failed to create NFCPresentmentIntentAssertion: \(error)", nil)
+        reject("err_create_presentment_\(error)", "Failed to acquire NFCPresentmentIntentAssertion: \(error)", nil)
         return
       }
 
@@ -53,6 +67,10 @@ extension Data {
     }
   }
 
+  @objc public func releaseExclusiveNFC() {
+    self.presentmentIntent = nil
+  }
+
   @objc public func isExclusiveNFC() -> Bool {
     return self.presentmentIntent != nil && self.presentmentIntent!.isValid
   }
@@ -82,10 +100,11 @@ extension Data {
       do {
         self.cardSession = try await CardSession()
       } catch (let error) {
-        reject("err_create_card_session", "Failed to create CardSession(): \(error)", nil)
+        reject("err_create_card_session_\(error)", "Failed to create CardSession: \(error)", nil)
         return
       }
 
+      self.cardSessionInvalidated = false
       resolve(nil)
 
       do {
@@ -151,7 +170,7 @@ extension Data {
         reject("err_illegal_state", "The provided handle is invalid.", nil)
         return
       }
-        
+
       guard let capdu = self.receivedCardAPDU else {
         reject("err_no_apdu_received", "There is no received APDU to respond to.", nil)
         return

package/js/NativeHCEModule.ts

@@ -47,6 +47,11 @@ export interface Spec extends TurboModule {
    * Android: Not supported (throws an exception).
    */
   acquireExclusiveNFC(): Promise<void>;
+  /**
+   * iOS: Release NFCPresentmentIntentAssertion object.
+   * Android: Not supported (no-op).
+   */
+  releaseExclusiveNFC(): void;
   /**
    * iOS: Whether the NFCPresentmentIntentAssertion is acquired and still valid.
    * Android: Always false.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icedevml/react-native-host-card-emulation",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "Host Card Emulation (HCE) React Native Turbo Module for iOS and Android platforms.",
   "react-native": "js/index",
   "source": "js/index",