@pagopa/io-react-native-iso18013 0.1.0

package/IoReactNativeIso18013.podspec

@@ -0,0 +1,29 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "IoReactNativeIso18013"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/pagopa/io-react-native-iso18013.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  # Module dependencies
+  s.dependency "IOWalletCBOR", "~> 0.2.1"
+  s.dependency "IOWalletProximity", "~> 1.2.2"
+
+  # 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.
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+  end
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 LazyAfternoons
+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

@@ -0,0 +1,30 @@
+# @pagopa/io-react-native-iso18013
+
+This library provides a React Native module based on [iso18013-android](https://github.com/pagopa/iso18013-android) and [iso18013-ios](https://github.com/pagopa/iso18013-ios) which allows proximity presentation according to the ISO 18013-5 standard, remote presentation according to the ISO 18013-7 standard, decoding of CBOR data and management of COSE verify and sign operations.
+
+## Installation
+
+```sh
+npm install @pagopa/io-react-native-iso18013
+```
+
+## Usage
+
+Each module is documented in its own README file:
+
+- [ISO18013-5](src/iso18013/iso18013-5/README.md): Proximity presentation according to the ISO 18013-5 standard;
+- [ISO18013-7](src/iso18013/iso18013-7/README.md): Remote presentation according to the ISO 18013-7 standard;
+- [CBOR](src/cbor/cbor/README.md): Decoding of CBOR data into readable objects;
+- [COSE](src/cbor/cose/README.md): Management of COSE verify and sign operations.
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,83 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['IoReactNativeIso18013_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["IoReactNativeIso18013_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.ioreactnativeiso18013"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+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.0.0"
+  implementation "it.pagopa.io.wallet.cbor:cbor:1.3.0"
+}
+

package/android/gradle.properties

@@ -0,0 +1,5 @@
+IoReactNativeIso18013_kotlinVersion=2.0.21
+IoReactNativeIso18013_minSdkVersion=26
+IoReactNativeIso18013_targetSdkVersion=34
+IoReactNativeIso18013_compileSdkVersion=35
+IoReactNativeIso18013_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

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

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

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

@@ -0,0 +1,56 @@
+package com.ioreactnativeiso18013
+
+import kotlin.io.encoding.Base64
+import kotlin.io.encoding.ExperimentalEncodingApi
+
+/**
+ * This singleton class contains a set of utilities for encoding and decoding base64 and base64url
+ * strings. Some functions are simple wrappers in order to share it between modules and having a
+ * centralized class in case we'd like to change the underlying implementation.
+ * Currently it is based on [kotlin.io.encoding.Base64].
+ */
+object Base64Utils {
+  @OptIn(ExperimentalEncodingApi::class)
+  fun decodeBase64AndBase64Url(base: String): ByteArray {
+    return try {
+      /*
+      * Try to decode it as base64url and return it
+      * We set the padding as optional as  RFC 4648 section 5 says
+      * The pad character "=" is typically percent-encoded when used in an
+      * URI [9], but if the data length is known implicitly, this can be
+      *  avoided by skipping the padding; see section 3.2
+      */
+      return Base64.UrlSafe.withPadding(Base64.PaddingOption.PRESENT_OPTIONAL).decode(base)
+    } catch (_: IllegalArgumentException) {
+      // Not base64url, it might be base64 or an invalid string
+      try {
+        // Try standard Base64 decoding and return it
+        Base64.Default.decode(base)
+      } catch (e: IllegalArgumentException) {
+        throw IllegalArgumentException("Input is not valid Base64 or Base64URL", e)
+      }
+    }
+  }
+
+  /**
+   * Wrapper method which encodes a ByteArray in a base64 string.
+   * This allows to change the underlying implementation here without changing it in the whole project.
+   * @param buffer - The ByteArray to be converted
+   * @returns A base64 encoded string representing the buffer
+   */
+  @OptIn(ExperimentalEncodingApi::class)
+  fun encodeBase64(buffer: ByteArray): String {
+    return Base64.Default.encode(buffer)
+  }
+
+  /**
+   * Wrapper method which decodes a ByteArray in a base64 string.
+   * This allows to change the underlying implementation here without changing it in the whole project.
+   * @param buffer - The string to be converted
+   * @returns A buffer representing the base64 string
+   */
+  @OptIn(ExperimentalEncodingApi::class)
+  fun decodeBase64(base64: String): ByteArray {
+    return Base64.Default.decode(base64)
+  }
+}

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

@@ -0,0 +1,209 @@
+package com.ioreactnativeiso18013
+
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.bridge.WritableNativeMap
+import it.pagopa.io.wallet.cbor.cose.COSEManager
+import it.pagopa.io.wallet.cbor.cose.FailureReason
+import it.pagopa.io.wallet.cbor.cose.SignWithCOSEResult
+import it.pagopa.io.wallet.cbor.parser.CBorParser
+
+class IoReactNativeCborModule(reactContext: ReactApplicationContext) :
+  ReactContextBaseJavaModule(reactContext) {
+
+  override fun getName(): String {
+    return NAME
+  }
+
+  @ReactMethod
+  fun decode(data: String, promise: Promise) {
+    val buffer = try {
+      Base64Utils.decodeBase64AndBase64Url(data)
+    } catch (e: Exception) {
+      ModuleException.INVALID_ENCODING.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+      return;
+    }
+
+    try {
+      CBorParser(buffer).toJson()?.let {
+        promise.resolve(it)
+      } ?: run {
+        ModuleException.UNABLE_TO_DECODE.reject(promise)
+      }
+    } catch (e: Exception) {
+      ModuleException.UNKNOWN_EXCEPTION.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+    }
+  }
+
+  @ReactMethod
+  fun decodeDocuments(data: String, promise: Promise) {
+    val buffer = try {
+      Base64Utils.decodeBase64AndBase64Url(data)
+    } catch (e: Exception) {
+      ModuleException.INVALID_ENCODING.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+      return;
+    }
+    try {
+      CBorParser(buffer).documentsCborToJson(separateElementIdentifier = true, onComplete = {
+        promise.resolve(it)
+      }) { ex ->
+        ModuleException.UNABLE_TO_DECODE.reject(
+          promise,
+          Pair(ERROR_USER_INFO_KEY, ex.message.orEmpty())
+        )
+      }
+    } catch (e: Exception) {
+      ModuleException.UNKNOWN_EXCEPTION.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+    }
+  }
+
+  @ReactMethod
+  fun decodeIssuerSigned(issuerSigned: String, promise: Promise) {
+    val buffer = try {
+      Base64Utils.decodeBase64AndBase64Url(issuerSigned)
+    } catch (e: Exception) {
+      ModuleException.INVALID_ENCODING.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+      return;
+    }
+    try {
+      CBorParser(buffer).issuerSignedCborToJson(separateElementIdentifier = true).let {
+        if (it == null) {
+          ModuleException.UNABLE_TO_DECODE.reject(
+            promise,
+            Pair(ERROR_USER_INFO_KEY, "Unable to decode passed CBOR")
+          )
+          return
+        }
+        promise.resolve(it)
+      }
+    } catch (e: Exception) {
+      ModuleException.UNKNOWN_EXCEPTION.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+    }
+  }
+
+  @ReactMethod
+  fun sign(payload: String, keyTag: String, promise: Promise) {
+    val data = try {
+      Base64Utils.decodeBase64AndBase64Url(payload)
+    } catch (e: Exception) {
+      ModuleException.INVALID_ENCODING.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+      return;
+    }
+
+    try {
+      val result = COSEManager().signWithCOSE(
+        data = data,
+        alias = keyTag
+      )
+      when (result) {
+        is SignWithCOSEResult.Failure -> {
+          when (result.reason) {
+            FailureReason.NO_KEY -> ModuleException.PUBLIC_KEY_NOT_FOUND.reject(
+              promise,
+              Pair(ERROR_USER_INFO_KEY, result.reason.msg)
+            )
+
+            FailureReason.FAIL_TO_SIGN -> ModuleException.UNABLE_TO_SIGN.reject(
+              promise,
+              Pair(ERROR_USER_INFO_KEY, result.reason.msg)
+            )
+
+            else -> ModuleException.UNKNOWN_EXCEPTION.reject(
+              promise,
+              Pair(ERROR_USER_INFO_KEY, result.reason.msg)
+            )
+          }
+        }
+
+        is SignWithCOSEResult.Success -> {
+          promise.resolve(Base64Utils.encodeBase64(result.signature))
+        }
+      }
+    } catch (e: Exception) {
+      ModuleException.UNKNOWN_EXCEPTION.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+    }
+  }
+
+  @ReactMethod
+  fun verify(sign1Data: String, publicKey: ReadableMap, promise: Promise) {
+    val data = try {
+      Base64Utils.decodeBase64AndBase64Url(sign1Data)
+    } catch (e: Exception) {
+      ModuleException.INVALID_ENCODING.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+      return;
+    }
+
+    try {
+      val result = COSEManager().verifySign1FromJWK(
+        dataSigned = data,
+        jwk = publicKey.toString()
+      )
+      promise.resolve(result)
+    } catch (e: Exception) {
+      ModuleException.UNKNOWN_EXCEPTION.reject(
+        promise,
+        Pair(ERROR_USER_INFO_KEY, e.message.orEmpty())
+      )
+    }
+  }
+
+  companion object {
+    const val NAME = "IoReactNativeCbor"
+    const val ERROR_USER_INFO_KEY = "error"
+
+    private enum class ModuleException(
+      val ex: Exception
+    ) {
+      UNABLE_TO_DECODE(Exception("UNABLE_TO_DECODE")),
+      PUBLIC_KEY_NOT_FOUND(Exception("PUBLIC_KEY_NOT_FOUND")),
+      UNABLE_TO_SIGN(Exception("UNABLE_TO_SIGN")),
+      INVALID_ENCODING(Exception("INVALID_ENCODING")),
+      UNKNOWN_EXCEPTION(Exception("UNKNOWN_EXCEPTION"));
+
+      fun reject(
+        promise: Promise, vararg args: Pair<String, String>
+      ) {
+        exMap(*args).let {
+          promise.reject(it.first, ex.message, it.second)
+        }
+      }
+
+      private fun exMap(vararg args: Pair<String, String>): Pair<String, WritableMap> {
+        val writableMap = WritableNativeMap()
+        args.forEach { writableMap.putString(it.first, it.second) }
+        return Pair(this.ex.message ?: "UNKNOWN", writableMap)
+      }
+    }
+  }
+}