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

package/LICENSE

@@ -1,21 +1,21 @@
-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.
+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.

package/README.md

@@ -1,17 +1,17 @@
-# Package: React Native HCE Module
-
-Host Card Emulation Module for React Native on iOS and Android platforms.
-
-> [!IMPORTANT]  
-> As per Apple's policy, **Host Card Emulation feature is only available for users based in the European
-> Economic Area (EEA)** with an iPhone running iOS 17.4 or later. Applications require a special HCE entitlement
-> 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.
-
-## 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)
+# Package: React Native HCE Module
+
+Host Card Emulation Module for React Native on iOS and Android platforms.
+
+> [!IMPORTANT]  
+> As per Apple's policy, **Host Card Emulation feature is only available for users based in the European
+> Economic Area (EEA)** with an iPhone running iOS 17.4 or later. Applications require a special HCE entitlement
+> 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.
+
+## 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)

package/RTNHCEModuleIOS.podspec

@@ -1,19 +1,19 @@
-require "json"
-
-package = JSON.parse(File.read(File.join(__dir__, "package.json")))
-
-Pod::Spec.new do |s|
-  s.name            = "RTNHCEModuleIOS"
-  s.version         = package["version"]
-  s.summary         = package["description"]
-  s.description     = package["description"]
-  s.homepage        = package["homepage"]
-  s.license         = package["license"]
-  s.platforms       = { :ios => "11.0" }
-  s.author          = package["author"]
-  s.source          = { :git => package["repository"], :tag => "#{s.version}" }
-
-  s.source_files    = "ios/**/*.{h,m,mm,swift}"
-
-  install_modules_dependencies(s)
-end
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name            = "RTNHCEModuleIOS"
+  s.version         = package["version"]
+  s.summary         = package["description"]
+  s.description     = package["description"]
+  s.homepage        = package["homepage"]
+  s.license         = package["license"]
+  s.platforms       = { :ios => "11.0" }
+  s.author          = package["author"]
+  s.source          = { :git => package["repository"], :tag => "#{s.version}" }
+
+  s.source_files    = "ios/**/*.{h,m,mm,swift}"
+
+  install_modules_dependencies(s)
+end

package/android/build.gradle

@@ -1,33 +1,33 @@
-buildscript {
-    ext.safeExtGet = {prop, fallback ->
-        rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
-    }
-    repositories {
-        google()
-        gradlePluginPortal()
-    }
-    dependencies {
-        classpath("com.android.tools.build:gradle:7.3.1")
-    }
-}
-
-apply plugin: 'com.android.library'
-apply plugin: 'com.facebook.react'
-
-android {
-    compileSdkVersion safeExtGet('compileSdkVersion', 33)
-    namespace "com.itsecrnd.rtnhceandroid"
-}
-
-repositories {
-    maven {
-        // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
-        url "$projectDir/../node_modules/react-native/android"
-    }
-    mavenCentral()
-    google()
-}
-
-dependencies {
-    implementation 'com.facebook.react:react-native:+'
-}
+buildscript {
+    ext.safeExtGet = {prop, fallback ->
+        rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+    }
+    repositories {
+        google()
+        gradlePluginPortal()
+    }
+    dependencies {
+        classpath("com.android.tools.build:gradle:7.3.1")
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'com.facebook.react'
+
+android {
+    compileSdkVersion safeExtGet('compileSdkVersion', 33)
+    namespace "com.itsecrnd.rtnhceandroid"
+}
+
+repositories {
+    maven {
+        // All of React Native (JS, Obj-C sources, Android binaries) is installed from npm
+        url "$projectDir/../node_modules/react-native/android"
+    }
+    mavenCentral()
+    google()
+}
+
+dependencies {
+    implementation 'com.facebook.react:react-native:+'
+}

package/android/src/main/AndroidMainfest.xml

@@ -1,3 +1,3 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-          package="com.itsecrnd.rtnhceandroid">
-</manifest>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.itsecrnd.rtnhceandroid">
+</manifest>

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

@@ -1,89 +1,89 @@
-package com.itsecrnd.rtnhceandroid;
-
-import android.annotation.SuppressLint;
-
-import javax.crypto.BadPaddingException;
-import javax.crypto.Cipher;
-import javax.crypto.IllegalBlockSizeException;
-import javax.crypto.KeyGenerator;
-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 SecretKey generateKey() {
-        KeyGenerator keyGen;
-        try {
-            keyGen = KeyGenerator.getInstance("AES");
-        } catch (NoSuchAlgorithmException e) {
-            throw new RuntimeException("Failed to get AES algorithm.", e);
-        }
-        keyGen.init(256);
-        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];
-            new SecureRandom().nextBytes(iv);
-
-            Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
-            GCMParameterSpec gcmParameterSpec = new GCMParameterSpec(128, iv);
-            cipher.init(Cipher.ENCRYPT_MODE, key, gcmParameterSpec);
-
-            byte[] plaintextBytes = plaintext.getBytes(StandardCharsets.UTF_8);
-            byte[] ciphertextBytes = cipher.doFinal(plaintextBytes);
-
-            return Base64.getEncoder().encodeToString(iv) + ';' +
-                Base64.getEncoder().encodeToString(ciphertextBytes);
-        } catch (NoSuchPaddingException
-                 | NoSuchAlgorithmException
-                 | IllegalBlockSizeException
-                 | InvalidAlgorithmParameterException
-                 | BadPaddingException
-                 | InvalidKeyException e) {
-            throw new RuntimeException(e);
-        }
-    }
-
-    public static String decryptData(SecretKey key, String ciphertext) {
-        try {
-            Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
-            String[] parts = ciphertext.split(";");
-
-            if (parts.length != 2) {
-                throw new IllegalArgumentException("Invalid ciphertext parameter.");
-            }
-
-            byte[] iv = Base64.getDecoder().decode(parts[0]);
-            byte[] ciphertextBytes = Base64.getDecoder().decode(parts[1]);
-
-            GCMParameterSpec gcmParameterSpec = new GCMParameterSpec(128, iv);
-            cipher.init(Cipher.DECRYPT_MODE, key, gcmParameterSpec);
-
-            byte[] plaintextBytes = cipher.doFinal(ciphertextBytes);
-            return new String(plaintextBytes, StandardCharsets.UTF_8);
-        } catch (NoSuchPaddingException
-                 | IllegalBlockSizeException
-                 | InvalidAlgorithmParameterException
-                 | BadPaddingException
-                 | InvalidKeyException
-                 | NoSuchAlgorithmException e) {
-            throw new RuntimeException(e);
-        }
-    }
-}
+package com.itsecrnd.rtnhceandroid;
+
+import android.annotation.SuppressLint;
+
+import javax.crypto.BadPaddingException;
+import javax.crypto.Cipher;
+import javax.crypto.IllegalBlockSizeException;
+import javax.crypto.KeyGenerator;
+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 SecretKey generateKey() {
+        KeyGenerator keyGen;
+        try {
+            keyGen = KeyGenerator.getInstance("AES");
+        } catch (NoSuchAlgorithmException e) {
+            throw new RuntimeException("Failed to get AES algorithm.", e);
+        }
+        keyGen.init(256);
+        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];
+            new SecureRandom().nextBytes(iv);
+
+            Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
+            GCMParameterSpec gcmParameterSpec = new GCMParameterSpec(128, iv);
+            cipher.init(Cipher.ENCRYPT_MODE, key, gcmParameterSpec);
+
+            byte[] plaintextBytes = plaintext.getBytes(StandardCharsets.UTF_8);
+            byte[] ciphertextBytes = cipher.doFinal(plaintextBytes);
+
+            return Base64.getEncoder().encodeToString(iv) + ';' +
+                Base64.getEncoder().encodeToString(ciphertextBytes);
+        } catch (NoSuchPaddingException
+                 | NoSuchAlgorithmException
+                 | IllegalBlockSizeException
+                 | InvalidAlgorithmParameterException
+                 | BadPaddingException
+                 | InvalidKeyException e) {
+            throw new RuntimeException(e);
+        }
+    }
+
+    public static String decryptData(SecretKey key, String ciphertext) {
+        try {
+            Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
+            String[] parts = ciphertext.split(";");
+
+            if (parts.length != 2) {
+                throw new IllegalArgumentException("Invalid ciphertext parameter.");
+            }
+
+            byte[] iv = Base64.getDecoder().decode(parts[0]);
+            byte[] ciphertextBytes = Base64.getDecoder().decode(parts[1]);
+
+            GCMParameterSpec gcmParameterSpec = new GCMParameterSpec(128, iv);
+            cipher.init(Cipher.DECRYPT_MODE, key, gcmParameterSpec);
+
+            byte[] plaintextBytes = cipher.doFinal(ciphertextBytes);
+            return new String(plaintextBytes, StandardCharsets.UTF_8);
+        } catch (NoSuchPaddingException
+                 | IllegalBlockSizeException
+                 | InvalidAlgorithmParameterException
+                 | BadPaddingException
+                 | InvalidKeyException
+                 | NoSuchAlgorithmException e) {
+            throw new RuntimeException(e);
+        }
+    }
+}

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

@@ -1,66 +1,66 @@
-/*
- * Content of "BinaryUtils" class:
- * Original source: https://github.com/googlearchive/android-CardEmulation
- *
- * ---
- *
- * Copyright (C) 2013 The Android Open Source Project
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- */
-
-package com.itsecrnd.rtnhceandroid;
-
-public class BinaryUtils {
-    /**
-     * Utility method to convert a byte array to a hexadecimal string.
-     *
-     * @param bytes Bytes to convert
-     * @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'};
-        char[] hexChars = new char[bytes.length * 2]; // Each byte has two hex characters (nibbles)
-        int v;
-        for (int j = 0; j < bytes.length; j++) {
-            v = bytes[j] & 0xFF; // Cast bytes[j] to int, treating as unsigned value
-            hexChars[j * 2] = hexArray[v >>> 4]; // Select hex character from upper nibble
-            hexChars[j * 2 + 1] = hexArray[v & 0x0F]; // Select hex character from lower nibble
-        }
-        return new String(hexChars);
-    }
-
-    /**
-     * Utility method to convert a hexadecimal string to a byte string.
-     *
-     * <p>Behavior with input strings containing non-hexadecimal characters is undefined.
-     *
-     * @param s String containing hexadecimal characters to convert
-     * @return Byte array generated from input
-     * @throws java.lang.IllegalArgumentException if input length is incorrect
-     */
-    public static byte[] HexStringToByteArray(String s) throws IllegalArgumentException {
-        int len = s.length();
-        if (len % 2 == 1) {
-            throw new IllegalArgumentException("Hex string must have even number of characters");
-        }
-        byte[] data = new byte[len / 2]; // Allocate 1 byte per 2 hex characters
-        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));
-        }
-        return data;
-    }
+/*
+ * Content of "BinaryUtils" class:
+ * Original source: https://github.com/googlearchive/android-CardEmulation
+ *
+ * ---
+ *
+ * Copyright (C) 2013 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+package com.itsecrnd.rtnhceandroid;
+
+public class BinaryUtils {
+    /**
+     * Utility method to convert a byte array to a hexadecimal string.
+     *
+     * @param bytes Bytes to convert
+     * @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'};
+        char[] hexChars = new char[bytes.length * 2]; // Each byte has two hex characters (nibbles)
+        int v;
+        for (int j = 0; j < bytes.length; j++) {
+            v = bytes[j] & 0xFF; // Cast bytes[j] to int, treating as unsigned value
+            hexChars[j * 2] = hexArray[v >>> 4]; // Select hex character from upper nibble
+            hexChars[j * 2 + 1] = hexArray[v & 0x0F]; // Select hex character from lower nibble
+        }
+        return new String(hexChars);
+    }
+
+    /**
+     * Utility method to convert a hexadecimal string to a byte string.
+     *
+     * <p>Behavior with input strings containing non-hexadecimal characters is undefined.
+     *
+     * @param s String containing hexadecimal characters to convert
+     * @return Byte array generated from input
+     * @throws java.lang.IllegalArgumentException if input length is incorrect
+     */
+    public static byte[] HexStringToByteArray(String s) throws IllegalArgumentException {
+        int len = s.length();
+        if (len % 2 == 1) {
+            throw new IllegalArgumentException("Hex string must have even number of characters");
+        }
+        byte[] data = new byte[len / 2]; // Allocate 1 byte per 2 hex characters
+        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));
+        }
+        return data;
+    }
 }