@pagopa/io-react-native-iso18013 0.6.0 → 0.8.0

package/IoReactNativeIso18013.podspec

@@ -17,7 +17,7 @@ Pod::Spec.new do |s|
 
   # Module dependencies
   s.dependency "IOWalletCBOR", "0.2.1"
-  s.dependency "IOWalletProximity", "1.3.0"
+  s.dependency "IOWalletProximity", "1.4.1"
 
   # 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.

package/README.md

@@ -13,7 +13,7 @@ npm install @pagopa/io-react-native-iso18013
 This library includes two native modules for both iOS and Android:
 
 - [IoReactNativeIso18013](src/iso18013/iso18013-5/proximity.ts) for ISO 18013-5 and ISO 18013-7 implementations;
-- [IoReactNativeCbor](src/cbor/cbor.ts) for CBOR and COSE implementations.
+- [IoReactNativeCbor](src/cbor/index.ts) for CBOR and COSE implementations.
 
 On the javascript side, the library exposes the following modules:
 

package/android/build.gradle

@@ -83,7 +83,8 @@ def kotlin_version = getExtOrDefault("kotlinVersion")
 dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  implementation "it.pagopa.io.wallet.proximity:proximity:2.2.0"
-  implementation "it.pagopa.io.wallet.cbor:cbor:1.3.0"
+  implementation "it.pagopa.io.wallet.proximity:proximity:2.4.1"
+  implementation "it.pagopa.io.wallet.cbor:cbor:1.4.1"
+  implementation "org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3"
   testImplementation('junit:junit:4.13.2')
 }

package/android/src/main/AndroidManifest.xml

@@ -1,3 +1,20 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
           package="com.ioreactnativeiso18013">
+    <uses-permission android:name="android.permission.NFC" />
+    <uses-feature android:name="android.hardware.nfc.hce" android:required="false" />
+
+    <application>
+        <service
+            android:name="com.ioreactnativeiso18013.IoNfcEngagementService"
+            android:exported="true"
+            android:permission="android.permission.BIND_NFC_SERVICE">
+            <intent-filter>
+                <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
+                <action android:name="android.nfc.action.NDEF_DISCOVERED" />
+            </intent-filter>
+            <meta-data
+                android:name="android.nfc.cardemulation.host_apdu_service"
+                android:resource="@xml/nfc_engagement_apdu_service" />
+        </service>
+    </application>
 </manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -1,2 +1,19 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <uses-permission android:name="android.permission.NFC" />
+  <uses-feature android:name="android.hardware.nfc.hce" android:required="false" />
+
+  <application>
+    <service
+        android:name="com.ioreactnativeiso18013.IoNfcEngagementService"
+        android:exported="true"
+        android:permission="android.permission.BIND_NFC_SERVICE">
+      <intent-filter>
+        <action android:name="android.nfc.action.NDEF_DISCOVERED" />
+        <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
+      </intent-filter>
+      <meta-data
+          android:name="android.nfc.cardemulation.host_apdu_service"
+          android:resource="@xml/nfc_engagement_apdu_service" />
+    </service>
+  </application>
 </manifest>

package/android/src/main/java/com/ioreactnativeiso18013/Enums.kt

@@ -0,0 +1,42 @@
+package com.ioreactnativeiso18013
+
+import com.facebook.react.bridge.ReadableArray
+
+internal enum class EngagementMode(val bridgeValue: String) {
+  QR_CODE("qrcode"),
+  NFC("nfc");
+
+  companion object {
+    fun fromBridgeValue(value: String): EngagementMode =
+      entries.firstOrNull { it.bridgeValue == value.lowercase() }
+        ?: throw IllegalArgumentException("Invalid retrieval method: '$value'. Expected 'ble' or 'nfc'.")
+  }
+}
+
+internal fun parseEngagementModes(engagementModes: ReadableArray): List<EngagementMode> {
+  if (engagementModes.size() == 0) return listOf(EngagementMode.QR_CODE)
+  return (0 until engagementModes.size()).map { index ->
+    val method = engagementModes.getString(index)
+      ?: throw IllegalArgumentException("Engagement mode at index $index is null")
+    EngagementMode.fromBridgeValue(method)
+  }
+}
+internal enum class RetrievalMethod(val bridgeValue: String) {
+  BLE("ble"),
+  NFC("nfc");
+
+  companion object {
+    fun fromBridgeValue(value: String): RetrievalMethod =
+      entries.firstOrNull { it.bridgeValue == value.lowercase() }
+        ?: throw IllegalArgumentException("Invalid retrieval method: '$value'. Expected 'ble' or 'nfc'.")
+  }
+}
+
+internal fun parseRetrievalMethods(retrievalMethods: ReadableArray): List<RetrievalMethod> {
+  if (retrievalMethods.size() == 0) return listOf(RetrievalMethod.BLE)
+  return (0 until retrievalMethods.size()).map { index ->
+    val method = retrievalMethods.getString(index)
+      ?: throw IllegalArgumentException("Retrieval method at index $index is null")
+    RetrievalMethod.fromBridgeValue(method)
+  }
+}

package/android/src/main/java/com/ioreactnativeiso18013/IoNfcEngagementService.kt

@@ -0,0 +1,17 @@
+package com.ioreactnativeiso18013
+
+import it.pagopa.io.wallet.proximity.nfc.NfcEngagementService
+
+/**
+ * Concrete subclass of [NfcEngagementService] (which itself extends [android.nfc.cardemulation.HostApduService]).
+ *
+ * This class intentionally lives in its own file and contains no logic.
+ * Android components declared in AndroidManifest.xml must be top-level, named classes so the
+ * system can instantiate them by their fully-qualified name via reflection. Registering an
+ * anonymous object or an inner class in the manifest is not supported.
+ *
+ * All NFC engagement logic is handled by the library's [NfcEngagementService] base class and
+ * events are surfaced through [it.pagopa.io.wallet.proximity.nfc.NfcEngagementEventBus].
+ * See [IoReactNativeIso18013Module.setupNfcHandler] for the event handling.
+ */
+class IoNfcEngagementService : NfcEngagementService()