@pagopa/io-react-native-iso18013 0.4.0 → 0.5.0

package/ios/IoReactNativeCbor.swift

@@ -5,14 +5,24 @@ import CryptoKit
 @objc(IoReactNativeCbor)
 class IoReactNativeCbor: NSObject {
   
-  @objc func decode(
-    _ cbor: String,
+  /**
+   Decode base64 or base64url encoded CBOR data to JSON object.
+   Resolves with a string containing the parsed data or rejects with an error code defined in ``ModuleErrorCodes``.
+   This method does not handle nested CBOR data, which will need additional parsing.
+   - Parameters:
+      - data: The base64 or base64url encoded CBOR string.
+      - resolve: The promise to be resolved.
+      - reject: The promise to be rejected.
+   */
+  @objc(decode:withResolver:withRejecter:)
+  func decode(
+    data: String,
     resolver resolve: RCTPromiseResolveBlock,
     rejecter reject: RCTPromiseRejectBlock
   ) {
     do{
-      let data = try Base64Utils.decodeBase64OrBase64URL(base: cbor)
-      guard let json = CborCose.jsonFromCBOR(data: data) else {
+      let buffer = try Base64Utils.decodeBase64OrBase64URL(base: data)
+      guard let json = CborCose.jsonFromCBOR(data: buffer) else {
         // We don't have the exact error here as this method returns nil upon failure
         reject(ModuleErrorCodes.decodeError.rawValue, "Unable to decode CBOR", nil)
         return
@@ -24,14 +34,23 @@ class IoReactNativeCbor: NSObject {
     }
   }
   
-  @objc func decodeDocuments(
-    _ mdoc: String,
+  /**
+   Decode base64 or base64url encoded mDOC-CBOR data to a JSON object.
+   Resolves with a string containing the parsed data or rejects with an error code defined in ``ModuleErrorCodes``.
+   - Parameters:
+      - data: The base64 or base64url encoded mDOC-CBOR string.
+      - resolve: The promise to be resolved.
+      - reject: The promise to be rejected.
+   */
+  @objc(decodeDocuments:withResolver:withRejecter:)
+  func decodeDocuments(
+    data: String,
     resolver resolve: RCTPromiseResolveBlock,
     rejecter reject: RCTPromiseRejectBlock
   ) {
     do{
-      let data = try Base64Utils.decodeBase64OrBase64URL(base: mdoc)
-      guard let json = CborCose.decodeCBOR(data: data, true, true) else {
+      let buffer = try Base64Utils.decodeBase64OrBase64URL(base: data)
+      guard let json = CborCose.decodeCBOR(data: buffer, true, true) else {
         // We don't have the exact error here as this method returns nil upon failure
         reject(ModuleErrorCodes.decodeDocumentsError.rawValue, "Unable to decode document CBOR", nil)
         return
@@ -42,14 +61,23 @@ class IoReactNativeCbor: NSObject {
     }
   }
   
-  @objc func decodeIssuerSigned(
-    _ issuerSigned: String,
+  /**
+   Decode base64 or base64url encoded issuerSigned attribute part of an mDOC-CBOR.
+   Resolves with a string containing the parsed data or rejects with an error code defined in ``ModuleErrorCodes``.
+   - Parameters:
+      - data: The base64 or base64url encoded mDOC-CBOR containing the issuerSigned data string.
+      - resolve: The promise to be resolved.
+      - reject: The promise to be rejected.
+   */
+  @objc(decodeIssuerSigned:withResolver:withRejecter:)
+  func decodeIssuerSigned(
+    data: String,
     resolver resolve: RCTPromiseResolveBlock,
     rejecter reject: RCTPromiseRejectBlock
   ) {
     do{
-      let data = try Base64Utils.decodeBase64OrBase64URL(base: issuerSigned)
-      guard let json = CborCose.issuerSignedCborToJson(data: data) else {
+      let buffer = try Base64Utils.decodeBase64OrBase64URL(base: data)
+      guard let json = CborCose.issuerSignedCborToJson(data: buffer) else {
         // We don't have the exact error here as this method returns nil upon failure
         reject(ModuleErrorCodes.decodeIssuerSignedError.rawValue, "Unable to decode Issuer Signed CBOR", nil)
         return
@@ -60,8 +88,18 @@ class IoReactNativeCbor: NSObject {
     }
   }
   
-  @objc func sign(
-    _ payloadData: String,
+  /**
+   Sign base64 encoded data with COSE and return the COSE-Sign1 object in base64 encoding.
+   Resolves with a string containing the COSE-Sign1 object in base64 encoding or rejects with an error code defined in ``ModuleErrorCodes``.
+   - Parameters:
+     - data: The base64 or base64url encoded payload to sign.
+     - keyTag: The alias of the key to use for signing.
+     - resolve: The promise to be resolved.
+     - reject: The promise to be rejected.
+   */
+  @objc(sign:withKeyTag:withResolver:withRejecter:)
+  func sign(
+    data: String,
     keyTag: String,
     resolver resolve: @escaping RCTPromiseResolveBlock,
     rejecter reject: @escaping RCTPromiseRejectBlock
@@ -73,13 +111,13 @@ class IoReactNativeCbor: NSObject {
         }
         
         do{
-          let data = try Base64Utils.decodeBase64OrBase64URL(base: payloadData)
+          let buffer = try Base64Utils.decodeBase64OrBase64URL(base: data)
           guard let coseKey = CoseKeyPrivate(crv: .p256, keyTag: keyTag) else {
             // We don't have the exact error here as this method returns nil upon failure
             reject(ModuleErrorCodes.signError.rawValue, "Unable to create a private key with the given keytag: \(keyTag)", nil)
             return
           }
-          let signedPayload = CborCose.sign(data: data, privateKey: coseKey)
+          let signedPayload = CborCose.sign(data: buffer, privateKey: coseKey)
           resolve(signedPayload.base64EncodedString())
       }
       catch{
@@ -88,18 +126,28 @@ class IoReactNativeCbor: NSObject {
     }
   }
   
-  @objc func verify(
-    _ sign1Data: String,
-    jwk: NSDictionary,
+  /**
+   Verifies a COSE-Sign1 object with the provided public key.
+   Resolves with boolean indicating whether or not the verification succeeded or not or rejects with an error code defined in ``ModuleErrorCodes``.
+   - Parameters:
+      - data: The COSE-Sign1 object in base64 or base64url encoding.
+      - publicKey: The public key in JWK format.
+      - resolve: The promise to be resolved
+      - reject: The promise to be rejected..
+   */
+  @objc(verify:withJwk:withResolver:withRejecter:)
+  func verify(
+    data: String,
+    publicKey: NSDictionary,
     resolver resolve: RCTPromiseResolveBlock,
     rejecter reject: RCTPromiseRejectBlock
   ) {
     do {
-      let data = try Base64Utils.decodeBase64OrBase64URL(base: sign1Data)
-      let publicKeyJson = try JSONSerialization.data(withJSONObject: jwk, options:[] )
+      let buffer = try Base64Utils.decodeBase64OrBase64URL(base: data)
+      let publicKeyJson = try JSONSerialization.data(withJSONObject: publicKey, options:[] )
       let publicKeyString = String(data: publicKeyJson, encoding: .utf8)!
       let publicKey = CoseKey(jwk: publicKeyString)!
-      let verified = CborCose.verify(data: data, publicKey: publicKey)
+      let verified = CborCose.verify(data: buffer, publicKey: publicKey)
       resolve(verified)
     } catch {
       reject(ModuleErrorCodes.verifyError.rawValue, error.localizedDescription, error)

package/ios/IoReactNativeIso18013.mm

@@ -18,22 +18,22 @@ RCT_EXTERN_METHOD(generateResponse:(NSArray *)documents
                  withResolver:(RCTPromiseResolveBlock)resolve
                  withRejecter:(RCTPromiseRejectBlock)reject)
 
-RCT_EXTERN_METHOD(sendResponse:(NSString)response
+RCT_EXTERN_METHOD(sendResponse:(NSString *)response
                  withResolver:(RCTPromiseResolveBlock)resolve
                  withRejecter:(RCTPromiseRejectBlock)reject)
 
-RCT_EXTERN_METHOD(sendErrorResponse:(NSInteger)status
+RCT_EXTERN_METHOD(sendErrorResponse:(NSInteger *)code
                   withResolver:(RCTPromiseResolveBlock)resolve
                   withRejecter:(RCTPromiseRejectBlock)reject)
 
-RCT_EXTERN_METHOD(generateOID4VPDeviceResponse: (NSString)clientId
-                  responseUri: (NSString*)responseUri
-                  authorizationRequestNonce: (NSString*)authorizationRequestNonce
-                  mdocGeneratedNonce: (NSString*)mdocGeneratedNonce
-                  documents: (NSArray*)documents
-                  fieldRequestedAndAccepted: (NSString*)fieldRequestedAndAccepted
-                  resolver: (RCTPromiseResolveBlock)resolve
-                  rejecter: (RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(generateOID4VPDeviceResponse: (NSString *)clientId
+                  withResponseUri: (NSString *)responseUri
+                  withAuthorizationRequestNonce: (NSString *)authorizationRequestNonce
+                  withMdocGeneratedNonce: (NSString *)mdocGeneratedNonce
+                  withDocuments: (NSArray *)documents
+                  withAcceptedFields: (NSDictionary *)acceptedFields
+                  withResolver: (RCTPromiseResolveBlock)resolve
+                  withRejecter: (RCTPromiseRejectBlock)reject)
 
 + (BOOL)requiresMainQueueSetup
 {

package/ios/IoReactNativeIso18013.swift

@@ -37,8 +37,7 @@ class IoReactNativeIso18013: RCTEventEmitter {
   
   /**
    Starts the proximity flow by allocating the necessary resources and initializing the Bluetooth stack.
-   Resolves to true or rejects if an error occurs.
-    
+   Resolves to true or rejects with an error code defined in ``ModuleErrorCodes``.
    - Parameters:
       - certificates: Two-dimensional array of base64 strings representing DER encoded X.509 certificate which are used to authenticate the verifier app
       - resolve: The promise to be resolved
@@ -47,7 +46,7 @@ class IoReactNativeIso18013: RCTEventEmitter {
   @objc(start:withResolver:withRejecter:)
   func start(
     certificates: [Any],
-    _ resolve: @escaping RCTPromiseResolveBlock,
+    resolve: @escaping RCTPromiseResolveBlock,
     reject: @escaping RCTPromiseRejectBlock
   ){
     do {
@@ -65,10 +64,9 @@ class IoReactNativeIso18013: RCTEventEmitter {
   
   /**
    Utility function to parse an array coming from the React Native Bridge into an array of Data representing DER encoded X.509 certificates.
-   
    - Parameters:
-      - certificates:Two-dimensional array of base64 strings representing DER encoded X.509 certificate
-   
+      - certificates: Two-dimensional array of base64 strings representing DER encoded X.509 certificate
+    - Throws: `ParsingError` if the provided certificate is not a valid base64 encoded string.
     - Returns: A two-dimensional array of Data containing DER encoded X.509 certificates.
   */
   private func parseCertificates(_ certificates: [Any]) throws -> [[Data]] {
@@ -87,15 +85,14 @@ class IoReactNativeIso18013: RCTEventEmitter {
   
   /**
    Creates a QR code to be scanned in order to initialize the presentation.
-   Resolves with the QR code strings.
-
+   Resolves with a string containing the QR code or rejects with an error code defined in ``ModuleErrorCodes``.
    - Parameters:
       - resolve: The promise to be resolved
       - reject: The promise to be rejected
-  */
+   */
   @objc(getQrCodeString:withRejecter:)
   func getQrCodeString(
-    _ resolve: @escaping RCTPromiseResolveBlock,
+    resolve: @escaping RCTPromiseResolveBlock,
     reject: @escaping RCTPromiseRejectBlock
   ) {
     do{
@@ -110,20 +107,17 @@ class IoReactNativeIso18013: RCTEventEmitter {
    Parses an array of documents from the React Native bridge which doesn't have any typing to an array of ``IOWalletProximity.ProximityDocument``.
    It checks if each element in the array has  `issuerSignedContent`, `alias` and `docType` properties in order to build a ``IOWalletProximity.ProximityDocument``, then it appens it to the array.
    The result can be fed to ``IOWalletProximity.generateResponse``.
-   
    - Parameters:
       - documents: An array containing documents. Each document is defined as a map containing:
          - issuerSignedContent which is a base64 or base64url encoded string representing the credential;
          - alias which is the alias of the key used to sign the credential;
          - docType which is the document type.
-   
    - Throws: `ParsingError`:
       - If the provided documents array do not contain a dictionary;
       - If the provided dictionary doesn't adhere to the structure we expect;
       - If the issuerSignedContent is not a valid base64 or base64url encoded string;
       - If the creation of a ProximityDdocument fails.
-   
-   - Returns: An array of `ProximityDocument` containg the documents to be presented
+   - Returns: An array of `ProximityDocument` containg the documents to be presented.
    */
   private func parseDocuments(documents: [Any]) throws -> [ProximityDocument] {
     return try documents.map{ (element) -> ProximityDocument in
@@ -151,14 +145,10 @@ class IoReactNativeIso18013: RCTEventEmitter {
    Parses a dictionary of accepted fields for the presentation from the React Native bridge which doesn't have any typing to a ``AcceptedFieldsDict`` dictionary.
    It checks if each element in the array is a dictionary where the key is a string, and the value is another dictionary. This nested dictionary has a string as its key and a boolean as its value, then it appens it to the array.
    The result can be fed to ``IOWalletProximity.generateResponse``.
-   
    - Parameters:
-      - acceptedFields: A dictionary of any elements. In order to be added to the result dictionary each element must be shaped as ``AcceptedFieldsDict`` thus as [String: [String: [String: Bool]]]
-   
-   - Throws: `ParsingError` if a value doesn't has the ``AcceptedFieldsDict`` shape or the result dictionary is empty
-   
-   - Returns: An ``AcceptedFieldsDict`` containg the accepted fields to be presented
-   
+      - acceptedFields: A dictionary of any elements. In order to be added to the result dictionary each element must be shaped as ``AcceptedFieldsDict`` thus as [String: [String: [String: Bool]]].
+   - Throws: `ParsingError` if a value doesn't has the ``AcceptedFieldsDict`` shape or the result dictionary is empty.
+   - Returns: An ``AcceptedFieldsDict`` containg the accepted fields to be presented.
    */
   private func parseAcceptedFields(acceptedFields: [AnyHashable: Any]) throws(ParsingError) -> AcceptedFieldsDict {
     var result: AcceptedFieldsDict = [:]
@@ -173,50 +163,40 @@ class IoReactNativeIso18013: RCTEventEmitter {
       result[keyString] = valueDict
     }
     
-    if(result.isEmpty){
-      throw ParsingError.acceptedFieldsNotValid("Empty accepted fields cannot be empty")
-    }
-    
     return result
   }
   
   /**
-     Generates a response containing the documents and the fields which the user decided to present.
-     It parses the untyped ``documents`` and ``acceptedFields`` parameters and feeds them to the ``IOWalletProximity.generateDeviceResponse`` function.
-     It resolves the promise with the response as a base64 encoded string.
-     It rejects the promise if an error occurs during the parameters parsing or while generating the device response.
-     
-     - Parameters:
-       - documents: An array containing documents. Each document is defined as a map containing:
-           - issuerSignedContent which is a base64 or base64url encoded string representing the credential;
-           - alias which is the alias of the key used to sign the credential;
-           - docType which is the document type.
-       - issuerSignedContent which is a base64 or base64url encoded string representing the credential;
-       - alias which is the alias of the key used to sign the credential;
-       - docType which is the document type.
-       - acceptedFields: A dictionary of elements, where each element must adhere to the structure of AcceptedFieldsDict—specifically, a [String: [String: [String: Bool]]]. The outermost key represents the credentia doctypel. The inner dictionary contains namespaces, and for each namespace, there is another dictionary mapping requested claims to a boolean value, which indicates whether the user is willing to present the corresponding claim. Example:
+   Generates a response containing the documents and the fields which the user decided to present.
+   It parses the untyped ``documents`` and ``acceptedFields`` parameters and feeds them to the ``IOWalletProximity.generateDeviceResponse`` function.
+   Resolves with a base64 encoded response or rejects with an error code defined in ``ModuleErrorCodes``.
+   - Parameters:
+     - documents: An array containing documents. Each document is defined as a map containing:
+         - issuerSignedContent which is a base64 or base64url encoded string representing the credential;
+         - alias which is the alias of the key used to sign the credential;
+         - docType which is the document type.
+     - acceptedFields: A dictionary of elements, where each element must adhere to the structure of AcceptedFieldsDict—specifically, a [String: [String: [String: Bool]]]. The outermost key represents the credential doctype. The inner dictionary contains namespaces, and for each namespace, there is another dictionary mapping requested claims to a boolean value, which indicates whether the user is willing to present the corresponding claim. Example:
         
          
-             {
-                "org.iso.18013.5.1.mDL": {
-                  "org.iso.18013.5.1": {
-                    "hair_colour": true,
-                    "given_name_national_character": true,
-                    "family_name_national_character": true,
-                    "given_name": true,
-                  }
+           {
+              "org.iso.18013.5.1.mDL": {
+                "org.iso.18013.5.1": {
+                  "hair_colour": true,
+                  "given_name_national_character": true,
+                  "family_name_national_character": true,
+                  "given_name": true,
                 }
-             }
-    
-       - resolve: The promise to be resolved
-       - reject: The promise to be rejected
-     
-     */
+              }
+           }
+  
+     - resolve: The promise to be resolved.
+     - reject: The promise to be rejected.
+   */
   @objc(generateResponse:withAcceptedFields:withResolver:withRejecter:)
   func generateResponse(
     documents: Array<Any>,
     acceptedFields: [AnyHashable: Any],
-    _ resolve: @escaping RCTPromiseResolveBlock,
+    resolve: @escaping RCTPromiseResolveBlock,
     reject: @escaping RCTPromiseRejectBlock
   ){
     do {
@@ -238,9 +218,8 @@ class IoReactNativeIso18013: RCTEventEmitter {
   
   /**
    Sends a response containing the documents and the fields which the user decided to present generated by ``generateResponse``.
-   It resolves to true after sending the response, otherwise it rejects if an error occurs while decoding the response.
    Currently there's not evidence of the verifier app responding to this request, thus we don't handle the response.
-   
+   Resolves with a true boolean in case of success or rejects with an error code defined in ``ModuleErrorCodes``.
    - Parameters:
      - response: A base64 encoded string containing the response generated by ``generateResponse``
      - resolve: The promise to be resolved
@@ -249,7 +228,7 @@ class IoReactNativeIso18013: RCTEventEmitter {
   @objc(sendResponse:withResolver:withRejecter:)
   func sendResponse(
     response: String,
-    _ resolve: @escaping RCTPromiseResolveBlock,
+    resolve: @escaping RCTPromiseResolveBlock,
     reject: @escaping RCTPromiseRejectBlock
   ){
     do{
@@ -265,24 +244,25 @@ class IoReactNativeIso18013: RCTEventEmitter {
   
   /**
    Sends an error response during the presentation according to the SessionData status codes defined in table 20 of the ISO18013-5 standard.
+   Resolves to true or rejects with an error code defined in ``ModuleErrorCodes``.
    - Parameters:
-     - status: The status error to be sent is an integer of type ``SessionDataStatus``:
+     - code: The status error to be sent is an integer of type ``SessionDataStatus``:
        ```
          10 -> Error: session encryption
          11 -> Error: CBOR decoding
          20 -> Session termination
        ```
-     - resolve: The promise to be resolved
-     - reject: The promise to be rejected
+     - resolve: The promise to be resolved.
+     - reject: The promise to be rejected.
    */
   @objc(sendErrorResponse:withResolver:withRejecter:)
-  func sendErrorResponse(status: UInt64, _ resolve: @escaping RCTPromiseResolveBlock,
-                         reject: @escaping RCTPromiseRejectBlock){
+  func sendErrorResponse(code: UInt64, _ resolve: @escaping RCTPromiseResolveBlock,
+                           reject: @escaping RCTPromiseRejectBlock){
     do{
-      if let statusEnum = SessionDataStatus(rawValue: status) {
+      if let statusEnum = SessionDataStatus(rawValue: code) {
         try Proximity.shared.errorPresentation(statusEnum)
       } else {
-        reject(ModuleErrorCodes.sendErrorResponseError.rawValue, "Invalid status code provided: \(status)", nil)
+        reject(ModuleErrorCodes.sendErrorResponseError.rawValue, "Invalid status code provided: \(code)", nil)
       }
       resolve(true)
     }catch let error{
@@ -293,16 +273,14 @@ class IoReactNativeIso18013: RCTEventEmitter {
   
   /**
    Closes the bluetooth connection and clears any resource.
-   It resolves to true after closing the connection.
-   
+   Resolves to true after closing the connection or rejects with an error code defined in ``ModuleErrorCodes``.
    - Parameters:
-     - resolve: The promise to be resolved
-     - reject:  The promise to be rejected
-   
+     - resolve: The promise to be resolved.
+     - reject:  The promise to be rejected.
    */
   @objc(close:withRejecter:)
   func close(
-    _ resolve: @escaping RCTPromiseResolveBlock,
+    resolve: @escaping RCTPromiseResolveBlock,
     reject: @escaping RCTPromiseRejectBlock
   ) {
     Proximity.shared.stop()
@@ -310,13 +288,11 @@ class IoReactNativeIso18013: RCTEventEmitter {
   }
   
   /**
-     Converts a device requested from the `onDocumentRequestReceived` callback into a serializable JSON.
-     
-     - Parameters:
-        - request: The request returned from `onDocumentRequestReceived` which contains an array of tuples consists of a doctype, namespaces and the requested claims with a boolean value indicating wether or not the device which is making the request has an intent to retain the dataß
-     
-     - Returns: A JSON string representing the device request or nil if an error occurs
-    */
+   Converts a device requested from the `onDocumentRequestReceived` callback into a serializable JSON.
+   - Parameters:
+      - request: The request returned from `onDocumentRequestReceived` which contains an array of tuples consists of a doctype, namespaces and the requested claims with a boolean value indicating wether or not the device which is making the request has an intent to retain the data.
+   - Returns: A JSON string representing the device request or nil if an error occurs.
+   */
   private func deviceRequestToJson(request: [(docType: String, nameSpaces: [String: [String: Bool]], isAuthenticated: Bool)]?) -> String? {
     var jsonRequest : [String: AnyHashable] = [:]
     request?.forEach({
@@ -394,13 +370,45 @@ class IoReactNativeIso18013: RCTEventEmitter {
     }
   }
   
-  @objc func generateOID4VPDeviceResponse(
-    _ clientId: String,
+  /**
+   Generates a CBOR encoded device response for ISO 18013-7 mDL remote presentation using OID4VP.
+   Resolves with the base64 encoded device response or rejects with an error code defined in ``ModuleErrorCodes``.
+   - Parameters:
+      - clientId: The client id extracted from OID4VP session.
+      - responseUri: The response URI extracted from OID4VP session.
+      - authorizationRequestNonce - The authorization request nonce extracted from OID4VP session.
+      - mdocGeneratedNonce - the mdoc generated nonce to be generated.
+      - documents: An array containing documents. Each document is defined as a map containing:
+           - issuerSignedContent which is a base64 or base64url encoded string representing the credential;
+           - alias which is the alias of the key used to sign the credential;
+           - docType which is the document type.
+      - acceptedFields: A dictionary of elements, where each element must adhere to the structure of AcceptedFieldsDict—specifically, a `[String: [String: [String: Bool]]]`. The outermost key represents the credential doctype. The inner dictionary contains namespaces, and for each namespace, there is another dictionary mapping requested claims to a boolean value, which indicates whether the user is willing to present the corresponding claim. Example:
+          
+           
+             {
+                "org.iso.18013.5.1.mDL": {
+                  "org.iso.18013.5.1": {
+                    "hair_colour": true,
+                    "given_name_national_character": true,
+                    "family_name_national_character": true,
+                    "given_name": true,
+                  },
+                  {...}
+                },
+                {...}
+             }
+
+       - resolve: The promise to be resolved.
+       - reject: The promise to be rejected.
+   */
+  @objc(generateOID4VPDeviceResponse:withResponseUri:withAuthorizationRequestNonce:withMdocGeneratedNonce:withDocuments:withAcceptedFields:withResolver:withRejecter:)
+  func generateOID4VPDeviceResponse(
+    clientId: String,
     responseUri: String,
     authorizationRequestNonce: String,
     mdocGeneratedNonce: String,
     documents: [Any],
-    fieldRequestedAndAccepted: String,
+    acceptedFields: [AnyHashable: Any],
     resolver resolve: RCTPromiseResolveBlock,
     rejecter reject: RCTPromiseRejectBlock
   ) {
@@ -414,7 +422,7 @@ class IoReactNativeIso18013: RCTEventEmitter {
       )
       
       let documentsAsProximityDocument = try parseDocuments(documents: documents)
-      let items = try JSONDecoder().decode([String : [String : [String : Bool]]].self, from: Data(fieldRequestedAndAccepted.utf8))
+      let items = try parseAcceptedFields(acceptedFields: acceptedFields)
       let response = try Proximity.shared.generateDeviceResponse(items: items, documents: documentsAsProximityDocument, sessionTranscript: sessionTranscript)
       resolve(Data(response).base64EncodedString())
     } catch let parsingError as ParsingError{

package/lib/module/cbor/cbor/README.md

@@ -1,92 +1,40 @@
-## CBOR
+# CBOR
 
 This module provides methods to decode CBOR data into readable objects.
 
 ```typescript
-import { CBOR } from '@pagopa/io-react-native-cbor';
+import { CBOR } from '@pagopa/io-react-native-iso18013';
 ```
 
-### Methods
+## Methods
 
 #### `decode`
 
-This method allows to decode CBOR data into readable JSON objects.
-Returns a `Promise` which resolves to a JSON object, or rejects with an instance of `CborFailure` in case of failure.
+Decodes CBOR data into readable JSON objects.
 
 **Note**: this method does not decode nested CBOR objects and therefore complex objects needs additional manual decoding
 
 ```typescript
-try {
-  const decoded = await CBOR.decode('...');
-} catch (e) {
-  const { message, userInfo } = e as CborFailure;
-}
+const decoded = await CBOR.decode('...');
 ```
 
 #### `decodeDocuments`
 
-This metod allows the decoding of CBOR data which contains MDOC objects.
-Returns a promise wich resolves to a [Documents](#documents) object, or rejects with an instance of `CborFailure` in case of failure.
-
-```typescript
-try {
-  const decoded = await CBOR.decodeDocuments('...');
-} catch (e) {
-  const { message, userInfo } = e as CborFailure;
-}
-```
-
-### Types
-
-#### `Documents`
-
-```typescript
-type Documents = {
-  status?: number;
-  version?: string;
-  documents?: Array<MDOC>;
-};
-```
-
-#### `MDOC`
+Decodes CBOR data containing MDOC objects.
 
 ```typescript
-type MDOC = {
-  docType?: DocumentType;
-  issuerSigned?: IssuerSigned;
-};
+const decoded = await CBOR.decodeDocuments('...');
 ```
 
-#### `IssuerSigned`
-
-```typescript
-type IssuerSigned = {
-  nameSpaces?: Record<string, Array<DocumentValue>>;
-  issuerAuth?: string;
-};
-```
+#### `decodeIssuerSigned`
 
-#### `DocumentValue`
+Decodes CBOR data containing an Issuer Signed object.
 
 ```typescript
-type DocumentValue = {
-  digestID?: number;
-  random?: string;
-  elementIdentifier?: string;
-  elementValue?: string;
-};
-```
-
-#### `DocumentType`
-
-```typescript
-enum DocumentTypeEnum {
-  MDL = 'org.iso.18013.5.1.mDL',
-  EU_PID = 'eu.europa.ec.eudi.pid.1',
-}
+const decoded = await CBOR.decodeIssuerSigned('...');
 ```
 
-### Error Codes
+## Errors
 
 This table contains the list of error codes that can be thrown by the `CBOR` module which are mapped via the `ModuleErrorCodes` type:
 | Type | Platform | Description |