@icedevml/react-native-host-card-emulation 0.2.1 → 0.3.0

package/README.md

@@ -8,10 +8,95 @@ Host Card Emulation Module for React Native on iOS and Android platforms.
 > in order to use this feature, which is managed by Apple. Read more in the official support article:
 > "[HCE-based contactless NFC transactions for apps in the European Economic Area (EEA)](https://developer.apple.com/support/hce-transactions-in-apps/)".
 
-> [!NOTE]  
-> Kindly please reference this project in your README if you are willing to create a derivative library.
+## Prerequisites
+This package was designed for React Native [New Architecture](https://reactnative.dev/architecture/landing-page) only.
+Make sure that your project has it enabled. Note that the New Architecture is enabled by default for React Native 0.76+ projects.
+
+### iOS
+1. Ensure that you are enrolled as organization (not individual) in Apple Developer Program, and that you are established in the European Economic Area (EEA).
+2. Ensure that you meet other [non-technical requirements imposed by Apple](https://developer.apple.com/support/hce-transactions-in-apps/#requirements-and-availability).
+3. Find out the Bundle ID of your existing application or [register a new Bundle ID](https://developer.apple.com/account/resources/identifiers/bundleId/add/bundle).
+4. [Request the HCE Entitlement](https://developer.apple.com/contact/request/hce-entitlement/) for your application's bundle ID.
+5. Wait until the entitlement is approved by Apple.
+
+### Android
+*(no prerequisite steps are required for Android)*
+
+## Installation
+Install `@icedevml/react-native-host-card-emulation` package within your React Native project. Then, follow the subsections below for each platform that you need to support.
+
+### iOS
+1. Make sure to set up a proper signing team and bundle identifier in "Signing & Capabilities" configuration section of your project.
+2. Add Host Card Emulation (HCE) entitlement with desired AIDs. This could be done either through XCode (by clicking "+ Capability") or within the entitlements XML file directly. Example:
+    ```xml
+    <?xml version="1.0" encoding="UTF-8"?>
+    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+    <plist version="1.0">
+    <dict>
+        <key>com.apple.developer.nfc.hce</key>
+        <true/>
+        <key>com.apple.developer.nfc.hce.iso7816.select-identifier-prefixes</key>
+        <array>
+            <string>F001020304</string>
+            <string>F00102030405</string>
+            <string>F0010203040506</string>
+        </array>
+    </dict>
+    </plist>
+    ```
+   Replace `F001020304`, `F00102030405`, `F0010203040506` with the ISO7816 AIDs that you want to support.
+3. In the `ios/` app's subdirectory, run `bundle install && bundle exec pod install`.
+
+### Android
+1. In `android/app/src/main/AndroidManifest.xml` add:
+   ```diff
+    <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="true" />
+
+      ...
+
+      <application
+        ...
+        >
+
+        ...
+   
+   +    <service
+   +      android:name="com.itsecrnd.rtnhceandroid.HCEService"
+   +      android:exported="true"
+   +      android:enabled="false"
+   +      android:permission="android.permission.BIND_NFC_SERVICE" >
+   +      <intent-filter>
+   +        <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
+   +        <category android:name="android.intent.category.DEFAULT"/>
+   +      </intent-filter>
+   +
+   +      <meta-data
+   +        android:name="android.nfc.cardemulation.host_apdu_service"
+   +        android:resource="@xml/aid_list" />
+   +    </service>
+      </application>
+    </manifest>
+   ```
+2. Create file `android/app/src/main/res/xml/aid_list.xml`:
+   ```xml
+   <host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
+     android:description="@string/app_name"
+     android:requireDeviceUnlock="false">
+     <aid-group android:category="other"
+       android:description="@string/app_name">
+       <aid-filter android:name="F001020304" />
+       <aid-filter android:name="F00102030405" />
+       <aid-filter android:name="F0010203040506" />
+     </aid-group>
+   </host-apdu-service>
+   ```
+   Replace `F001020304`, `F00102030405`, `F0010203040506` with the ISO7816 AIDs that you want to support.
 
 ## API Specification & Demo App
 
-* [module API (declarations)](https://github.com/icedevml/react-native-host-card-emulation/blob/master/packages/react-native-hce-module/js/NativeHCEModule.ts)
-* [demo app's code (example usage)](https://github.com/icedevml/react-native-host-card-emulation/blob/master/packages/demo-hce-module-ios-app/App.tsx)
+* [module API (declarations)](https://github.com/icedevml/react-native-host-card-emulation/blob/master/packages/native-hce-module/js/NativeHCEModule.ts)
+* [demo app's code (example usage)](https://github.com/icedevml/react-native-host-card-emulation/blob/master/packages/demo-hce-module-app/App.tsx)

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

@@ -2,6 +2,13 @@ package com.itsecrnd.rtnhceandroid;
 
 import android.annotation.SuppressLint;
 
+import java.nio.charset.StandardCharsets;
+import java.security.InvalidAlgorithmParameterException;
+import java.security.InvalidKeyException;
+import java.security.NoSuchAlgorithmException;
+import java.security.SecureRandom;
+import java.util.Base64;
+
 import javax.crypto.BadPaddingException;
 import javax.crypto.Cipher;
 import javax.crypto.IllegalBlockSizeException;
@@ -10,15 +17,14 @@ import javax.crypto.NoSuchPaddingException;
 import javax.crypto.SecretKey;
 import javax.crypto.spec.GCMParameterSpec;
 
-import java.nio.charset.StandardCharsets;
-import java.security.InvalidAlgorithmParameterException;
-import java.security.InvalidKeyException;
-import java.security.NoSuchAlgorithmException;
-import java.security.SecureRandom;
-import java.util.Base64;
-
 @SuppressLint("NewApi")
 public class AESGCMUtil {
+    public static String randomString() {
+        byte[] rnd = new byte[32];
+        new SecureRandom().nextBytes(rnd);
+        return BinaryUtils.ByteArrayToHexString(rnd);
+    }
+
     public static SecretKey generateKey() {
         KeyGenerator keyGen;
         try {
@@ -30,12 +36,6 @@ public class AESGCMUtil {
         return keyGen.generateKey();
     }
 
-    public static byte[] generateNonce(int size) {
-        byte[] nonce = new byte[size];
-        new SecureRandom().nextBytes(nonce); // Fill nonce with random bytes
-        return nonce;
-    }
-
     public static String encryptData(SecretKey key, String plaintext) {
         try {
             byte[] iv = new byte[32];
@@ -49,14 +49,14 @@ public class AESGCMUtil {
             byte[] ciphertextBytes = cipher.doFinal(plaintextBytes);
 
             return Base64.getEncoder().encodeToString(iv) + ';' +
-                Base64.getEncoder().encodeToString(ciphertextBytes);
+                    Base64.getEncoder().encodeToString(ciphertextBytes);
         } catch (NoSuchPaddingException
                  | NoSuchAlgorithmException
                  | IllegalBlockSizeException
                  | InvalidAlgorithmParameterException
                  | BadPaddingException
                  | InvalidKeyException e) {
-            throw new RuntimeException(e);
+            throw new RuntimeException("Crypto error.", e);
         }
     }
 
@@ -83,7 +83,7 @@ public class AESGCMUtil {
                  | BadPaddingException
                  | InvalidKeyException
                  | NoSuchAlgorithmException e) {
-            throw new RuntimeException(e);
+            throw new RuntimeException("Crypto error.", e);
         }
     }
 }

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

@@ -30,7 +30,7 @@ public class BinaryUtils {
      * @return String, containing hexadecimal representation.
      */
     public static String ByteArrayToHexString(byte[] bytes) {
-        final char[] hexArray = {'0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F'};
+        final char[] hexArray = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
         char[] hexChars = new char[bytes.length * 2]; // Each byte has two hex characters (nibbles)
         int v;
         for (int j = 0; j < bytes.length; j++) {
@@ -59,7 +59,7 @@ public class BinaryUtils {
         for (int i = 0; i < len; i += 2) {
             // Convert each character into a integer (base-16), then bit-shift into place
             data[i / 2] = (byte) ((Character.digit(s.charAt(i), 16) << 4)
-                    + Character.digit(s.charAt(i+1), 16));
+                    + Character.digit(s.charAt(i + 1), 16));
         }
         return data;
     }

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

@@ -1,5 +1,7 @@
 package com.itsecrnd.rtnhceandroid;
 
+import static com.itsecrnd.rtnhceandroid.IntentKeys.INTENT_READER_DETECT;
+import static com.itsecrnd.rtnhceandroid.IntentKeys.INTENT_READER_LOST;
 import static com.itsecrnd.rtnhceandroid.IntentKeys.INTENT_RECEIVE_C_APDU;
 import static com.itsecrnd.rtnhceandroid.IntentKeys.INTENT_SEND_R_APDU;
 
@@ -8,15 +10,12 @@ import android.content.Context;
 import android.content.Intent;
 import android.content.IntentFilter;
 import android.nfc.cardemulation.HostApduService;
-import android.nfc.cardemulation.PollingFrame;
 import android.os.Build;
 import android.os.Bundle;
 import android.util.Log;
 
-import androidx.annotation.NonNull;
 import androidx.annotation.RequiresApi;
 
-import java.util.List;
 import java.util.Locale;
 
 import javax.crypto.SecretKey;
@@ -31,12 +30,20 @@ public class HCEService extends HostApduService {
     private final BroadcastReceiver receiver = new BroadcastReceiver() {
         @Override
         public void onReceive(Context context, Intent intent) {
-            String action = intent.getAction();
-
-            if (action != null && action.equals(INTENT_SEND_R_APDU)) {
-                String rapdu = AESGCMUtil.decryptData(encSecretKey, intent.getStringExtra("rapdu"));
-                byte[] dec = BinaryUtils.HexStringToByteArray(rapdu.toUpperCase(Locale.ROOT));
-                sendResponseApdu(dec);
+            try {
+                String action = intent.getAction();
+
+                if (action != null) {
+                    AESGCMUtil.decryptData(encSecretKey, intent.getStringExtra("auth"));
+
+                    if (action.equals(INTENT_SEND_R_APDU)) {
+                        String rapdu = AESGCMUtil.decryptData(encSecretKey, intent.getStringExtra("rapdu"));
+                        byte[] dec = BinaryUtils.HexStringToByteArray(rapdu.toUpperCase(Locale.ROOT));
+                        sendResponseApdu(dec);
+                    }
+                }
+            } catch (Exception e) {
+                Log.e(TAG, "Failed to handle broadcast in HCEService.", e);
             }
         }
     };
@@ -47,27 +54,20 @@ public class HCEService extends HostApduService {
 
         Intent intent = new Intent(INTENT_RECEIVE_C_APDU);
         intent.setPackage(getApplicationContext().getPackageName());
+        intent.putExtra("auth", AESGCMUtil.encryptData(encSecretKey, AESGCMUtil.randomString()));
         intent.putExtra("capdu", capdu);
         getApplicationContext().sendBroadcast(intent);
 
         return null;
     }
 
-    @Override
-    public void processPollingFrames(@NonNull List<PollingFrame> frames) {
-        super.processPollingFrames(frames);
-        Log.i(TAG, "Polling frames: " + frames.size());
-    }
-
     @Override
     public void onCreate() {
-        Log.d(TAG, "Starting service");
-
-        IntentFilter filter = new IntentFilter();
-        filter.addAction(INTENT_SEND_R_APDU);
+        Log.d(TAG, "HCEService onCreate");
 
+        String prefsName = getApplicationContext().getPackageName() + ".nativehcemodule";
         String encKey = getApplicationContext()
-                .getSharedPreferences("RTNHCEAndroidModuleBroadcastEnc", Context.MODE_PRIVATE)
+                .getSharedPreferences(prefsName, Context.MODE_PRIVATE)
                 .getString("encKey", "");
 
         if (encKey.isEmpty()) {
@@ -80,13 +80,25 @@ public class HCEService extends HostApduService {
         /*
          * See a comment about registerReceiver() in RTNHCEAndroidModule.
          */
+        IntentFilter filter = new IntentFilter();
+        filter.addAction(INTENT_SEND_R_APDU);
         getApplicationContext().registerReceiver(receiver, filter, RECEIVER_EXPORTED);
+
+        Intent intent = new Intent(INTENT_READER_DETECT);
+        intent.setPackage(getApplicationContext().getPackageName());
+        intent.putExtra("auth", AESGCMUtil.encryptData(encSecretKey, AESGCMUtil.randomString()));
+        getApplicationContext().sendBroadcast(intent);
     }
 
     @Override
     public void onDeactivated(int reason) {
-        Log.d(TAG, "Finishing service: " + reason);
+        Log.d(TAG, "HCEService onDeactivated: " + reason);
 
         getApplicationContext().unregisterReceiver(receiver);
+
+        Intent intent = new Intent(INTENT_READER_LOST);
+        intent.setPackage(getApplicationContext().getPackageName());
+        intent.putExtra("auth", AESGCMUtil.encryptData(encSecretKey, AESGCMUtil.randomString()));
+        getApplicationContext().sendBroadcast(intent);
     }
 }

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

@@ -3,4 +3,6 @@ package com.itsecrnd.rtnhceandroid;
 public class IntentKeys {
     public static final String INTENT_RECEIVE_C_APDU = "com.itsecrnd.rtnhceandroid.receivecapdu";
     public static final String INTENT_SEND_R_APDU = "com.itsecrnd.rtnhceandroid.sendrapdu";
+    public static final String INTENT_READER_DETECT = "com.itsecrnd.rtnhceandroid.readerdetect";
+    public static final String INTENT_READER_LOST = "com.itsecrnd.rtnhceandroid.readerlost";
 }

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

@@ -1,14 +1,17 @@
 package com.itsecrnd.rtnhceandroid;
 
 import static android.content.Context.RECEIVER_EXPORTED;
-
+import static com.itsecrnd.rtnhceandroid.IntentKeys.INTENT_READER_DETECT;
+import static com.itsecrnd.rtnhceandroid.IntentKeys.INTENT_READER_LOST;
 import static com.itsecrnd.rtnhceandroid.IntentKeys.INTENT_RECEIVE_C_APDU;
 import static com.itsecrnd.rtnhceandroid.IntentKeys.INTENT_SEND_R_APDU;
 
 import android.content.BroadcastReceiver;
+import android.content.ComponentName;
 import android.content.Context;
 import android.content.Intent;
 import android.content.IntentFilter;
+import android.content.pm.PackageManager;
 import android.os.Build;
 import android.util.Log;
 
@@ -28,25 +31,56 @@ public class RTNHCEAndroidModule extends NativeHCEModuleSpec {
     public static final String NAME = "NativeHCEModule";
 
     private final SecretKey encSecretKey;
+    private boolean sessionOpen;
+
+    private void toggleHceService(Boolean enabled) {
+        getReactApplicationContext()
+                .getPackageManager()
+                .setComponentEnabledSetting(
+                        new ComponentName(getReactApplicationContext(), HCEService.class),
+                        enabled
+                                ? PackageManager.COMPONENT_ENABLED_STATE_ENABLED
+                                : PackageManager.COMPONENT_ENABLED_STATE_DISABLED,
+                        PackageManager.DONT_KILL_APP
+                );
+    }
+
+    private void sendEvent(final String type, final String arg) {
+        WritableMap map = Arguments.createMap();
+        map.putString("type", type);
+        map.putString("arg", arg);
+        emitOnEvent(map);
+    }
 
     private final BroadcastReceiver receiver = new BroadcastReceiver() {
         @Override
         public void onReceive(Context context, Intent intent) {
-            String action = intent.getAction();
-
-            if (action != null && action.equals(INTENT_RECEIVE_C_APDU)) {
-                String capdu = AESGCMUtil.decryptData(encSecretKey, intent.getStringExtra("capdu"));
-
-                WritableMap map = Arguments.createMap();
-                map.putString("type", "received");
-                map.putString("arg", capdu);
-                emitOnEvent(map);
+            try {
+                String action = intent.getAction();
+
+                if (action != null) {
+                    AESGCMUtil.decryptData(encSecretKey, intent.getStringExtra("auth"));
+
+                    if (action.equals(INTENT_RECEIVE_C_APDU)) {
+                        String capdu = AESGCMUtil.decryptData(encSecretKey, intent.getStringExtra("capdu"));
+                        sendEvent("received", capdu);
+                    } else if (action.equals(INTENT_READER_DETECT)) {
+                        sendEvent("readerDetected", "");
+                    } else if (action.equals(INTENT_READER_LOST)) {
+                        sendEvent("readerDeselected", "");
+                    }
+                }
+            } catch (Exception e) {
+                Log.e(TAG, "Failed to handle broadcast in RTNHCEAndroidModule.", e);
             }
         }
     };
 
     RTNHCEAndroidModule(ReactApplicationContext context) {
         super(context);
+
+        this.sessionOpen = false;
+
         String encKey;
 
         try {
@@ -56,14 +90,17 @@ public class RTNHCEAndroidModule extends NativeHCEModuleSpec {
             throw new RuntimeException("Failed to generate encryption key.", e);
         }
 
+        String prefsName = getReactApplicationContext().getPackageName() + ".nativehcemodule";
         getReactApplicationContext()
-                .getSharedPreferences("RTNHCEAndroidModuleBroadcastEnc", Context.MODE_PRIVATE)
+                .getSharedPreferences(prefsName, Context.MODE_PRIVATE)
                 .edit()
                 .putString("encKey", encKey)
                 .commit();
 
         IntentFilter filter = new IntentFilter();
         filter.addAction(INTENT_RECEIVE_C_APDU);
+        filter.addAction(INTENT_READER_DETECT);
+        filter.addAction(INTENT_READER_LOST);
 
         /*
          * FIXME It seems like those intents are not going through across this module and HostApduService.
@@ -86,55 +123,73 @@ public class RTNHCEAndroidModule extends NativeHCEModuleSpec {
 
     @Override
     public boolean isPlatformSupported() {
-        return true;
+        PackageManager pm = getReactApplicationContext().getPackageManager();
+        return pm.hasSystemFeature(PackageManager.FEATURE_NFC)
+            && pm.hasSystemFeature(PackageManager.FEATURE_NFC_HOST_CARD_EMULATION);
     }
 
     @Override
     public void acquireExclusiveNFC(Promise promise) {
-        promise.resolve(null);
+        promise.reject("err_platform_unsupported", "acquireExclusiveNFC() is not supported on Android.");
     }
 
     @Override
     public boolean isExclusiveNFC() {
+        // unsupported on Android
         return false;
     }
 
     @Override
     public void beginSession(Promise promise) {
-        promise.resolve(null);
+        if (this.sessionOpen) {
+            promise.reject("err_card_session_exists", "Session already exists.");
+        } else {
+            this.sessionOpen = true;
+            promise.resolve(null);
+            sendEvent("sessionStarted", "");
+        }
     }
 
     @Override
     public void setSessionAlertMessage(String message) {
-
+        // unsupported on Android, no-op
     }
 
     @Override
     public void invalidateSession() {
-
+        toggleHceService(false);
+        this.sessionOpen = false;
+        sendEvent("sessionInvalidated", "");
     }
 
     @Override
     public boolean isSessionRunning() {
-        return true;
+        return this.sessionOpen;
     }
 
     @Override
     public void startHCE(Promise promise) {
+        toggleHceService(true);
         promise.resolve(null);
     }
 
     @Override
     public void stopHCE(String status, Promise promise) {
+        toggleHceService(false);
         promise.resolve(null);
     }
 
     @Override
     public void respondAPDU(String rapdu, Promise promise) {
+        if (!this.sessionOpen) {
+            return;
+        }
+
         String encRapdu = AESGCMUtil.encryptData(encSecretKey, rapdu);
 
         Intent intent = new Intent(INTENT_SEND_R_APDU);
         intent.setPackage(getReactApplicationContext().getPackageName());
+        intent.putExtra("auth", AESGCMUtil.encryptData(encSecretKey, AESGCMUtil.randomString()));
         intent.putExtra("rapdu", encRapdu);
         getReactApplicationContext().getApplicationContext().sendBroadcast(intent);
 
@@ -143,6 +198,10 @@ public class RTNHCEAndroidModule extends NativeHCEModuleSpec {
 
     @Override
     public void isHCERunning(Promise promise) {
-        promise.resolve(true);
+        int enabledSetting = getReactApplicationContext()
+                .getPackageManager()
+                .getComponentEnabledSetting(new ComponentName(getReactApplicationContext(), HCEService.class));
+
+        promise.resolve(enabledSetting == PackageManager.COMPONENT_ENABLED_STATE_ENABLED);
     }
 }

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

@@ -40,7 +40,7 @@ public class RTNHCEAndroidPackage extends TurboReactPackage {
                             true, // hasConstants
                             false, // isCxxModule
                             true // isTurboModule
-            ));
+                    ));
             return moduleInfos;
         };
     }

package/js/NativeHCEModule.ts

@@ -1,31 +1,89 @@
 import type {TurboModule, CodegenTypes} from 'react-native';
 import {TurboModuleRegistry} from 'react-native';
 
-export type HCEModuleIOSEventType = 'sessionStarted' | 'readerDetected' | 'readerDeselected' | 'received' | 'sessionInvalidated';
-export type HCEModuleIOSStopReason = 'success' | 'failure';
+export type HCEModuleEventType = 'sessionStarted'
+    | 'sessionInvalidated'
+    /**
+     * iOS: Whether the reader field was detected.
+     * Android: Whether the reader had sent the select command to us.
+     */
+    | 'readerDetected'
+    /**
+     * Whether our HCE app was deselected or the reader was lost.
+     */
+    | 'readerDeselected'
+    /**
+     * Received C-APDU (hex-encoded string in "arg" key) from the reader.
+     * Respond by calling respondAPDU(rapdu).
+     */
+    | 'received';
+export type HCEModuleStopReason = 'success' | 'failure';
 
-export type HCEModuleIOSEvent = {
-  type: HCEModuleIOSEventType
+export type HCEModuleEvent = {
+  type: HCEModuleEventType
   arg: string | null,
 }
 
 export interface Spec extends TurboModule {
+  /**
+   * Checks if a given smartphone supports required HCE features.
+   */
   isPlatformSupported(): boolean;
 
-  acquireExclusiveNFC(): Promise<boolean>;
+  /**
+   * iOS: Tries to acquire NFCPresentmentIntentAssertion.
+   * Android: Not supported (throws an exception).
+   */
+  acquireExclusiveNFC(): Promise<void>;
+  /**
+   * iOS: Whether the NFCPresentmentIntentAssertion is acquired and still valid.
+   * Android: Always false.
+   */
   isExclusiveNFC(): boolean;
 
+  /**
+   * Begin card operation session.
+   * iOS: Create CardSession.
+   * Android: Sets an internal flag that the session is open.
+   */
   beginSession(): Promise<void>;
+  /**
+   * iOS: Set alert message on the NFC system UI.
+   * Android: NO-OP.
+   */
   setSessionAlertMessage(message: string): void;
+  /**
+   * iOS: Invalidate CardSession.
+   * Android: Set an internal flag that the session is closed and disable HCE service.
+   */
   invalidateSession(): void;
+  /**
+   * iOS: Checks if CardSession is running.
+   * Android: Checks if an internal flag is set.
+   */
   isSessionRunning(): boolean;
 
+  /**
+   * iOS: Start the card emulation.
+   * Android: Enable HCE service.
+   */
   startHCE(): Promise<void>;
-  stopHCE(status: HCEModuleIOSStopReason): Promise<void>;
+  /**
+   * iOS: Stop the card emulation with "success"/"failure" UI status.
+   * Android: Disable HCE service.
+   */
+  stopHCE(status: HCEModuleStopReason): Promise<void>;
+  /**
+   * Send R-APDU (hex-encoded string) as a response to the last received C-APDU event.
+   */
   respondAPDU(rapdu: string): Promise<void>;
+  /**
+   * iOS: Checks if the card emulation is running.
+   * Android: Checks if the HCE service is enabled.
+   */
   isHCERunning(): Promise<boolean>;
 
-  readonly onEvent: CodegenTypes.EventEmitter<HCEModuleIOSEvent>;
+  readonly onEvent: CodegenTypes.EventEmitter<HCEModuleEvent>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>(

package/package.json

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

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Michal Leszczynski
-
-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.