@pagopa/io-react-native-cie 1.3.1 → 1.3.3

package/IoReactNativeCie.podspec

@@ -16,7 +16,7 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 
   # CieSDK dependency
-  s.dependency "CieSDK", "~> 0.1.16"
+  s.dependency "CieSDK", "~> 0.1.19"
 
 # 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

@@ -15,6 +15,7 @@ Module to handle CIE (Electronic Identity Card) operations natively in React Nat
 - [API](#api)
 - [Usage](#usage)
   - [Check NFC Status](#check-nfc-status)
+  - [Logs](#logs)
   - [Reading CIE Data](#reading-cie-data)
     - [Reading Attributes](#reading-attributes)
     - [Authentication](#authentication)
@@ -116,13 +117,17 @@ List of available functions
 | `startReadingAttributes(timeout: number)`                                                                            | `Promise<void>`    | Start the CIE attributes reading process                                       |
 | `startReading(pin: string, authenticationUrl: string, timeout: number)`                                              | `Promise<void>`    | Start the CIE reading process fro authentication                               |
 | `stopReading()`                                                                                                      | `Promise<void>`    | (Android) Stops all reading process                                            |
+| `setLogMode(mode: LogMode)`                                                                                          | `void`             | (iOS) Sets the log mode for the CIE SDK                                        |
+| `getLogsFilePath()`                                                                                                  | `Promise<string>`  | (iOS) Returns file path of CIE SDK logs                                        |
+| `getLogs()`                                                                                                          | `Promise<string>`  | (iOS) Returns content of CIE SDK logs                                          |
 
 ## Usage
 
-The package is split into two modules:
+The package is split into three modules:
 
 - [CieUtils](/src/utils): Provides functions to check the NFC status of the device.
 - [CieManager](/src/manager): Provides CIE read and authentication capabilities.
+- [CieLogger](/src/logger): Provides logging utils
 
 ### Check NFC Status
 
@@ -139,6 +144,29 @@ await CieUtils.isNfcEnabled();
 await CieUtils.isCieAuthenticationSupported();
 ```
 
+### Logs
+
+**Note:** Logging is only supported on iOS. On Android, these methods will throw an error.
+
+```typescript
+import { CieLogger } from '@pagopa/io-react-native-cie';
+
+// Enable logging to local file
+CieLogger.setLogMode('localFile');
+
+// Enable logging to console
+CieLogger.setLogMode('console');
+
+// Disable logging
+CieLogger.setLogMode('disabled');
+
+// Get logs file path
+const path = await CieLogger.getLogsFilePath();
+
+// Get logs content
+const logs = await CieLogger.getLogs();
+```
+
 ### Reading CIE Data
 
 #### Internal Authentication
@@ -447,17 +475,39 @@ type ResultEncoding = 'hex' | 'base64' | 'base64url';
 
 Supported types of encoding for Internal Auth and Mrtd reponse payloads.
 
+```typescript
+type LogMode = 'localFile' | 'console' | 'disabled';
+```
+
+Log mode for the CIE SDK:
+
+- `localFile`: Logs saved to device for later retrieval
+- `console`: Logs output to console for real-time monitoring
+- `disabled`: Disables all logging
+
+```typescript
+type CertificateData = {
+  name?: string;
+  surname?: string;
+  fiscalCode?: string;
+  docSerialNumber?: string;
+};
+```
+
+Contains CIE certificate data read from the card.
+
 ## Errors
 
 The CIE reading function may throw exceptions if the reading process cannot be initiated. These exceptions indicate issues with input validation or system compatibility.
 Below is a comprehensive list of possible exceptions that may be thrown during initialization:
 
-| Error Code            | Platform    | Description             |
-| --------------------- | ----------- | ----------------------- |
-| `PIN_REGEX_NOT_VALID` | ios/Android | Invalid PIN format      |
-| `INVALID_AUTH_URL`    | ios/Android | Invalid auth url format |
-| `THREADING_ERROR`     | iOS         | Unexpected error        |
-| `UNKNOWN_EXCEPTION`   | iOS/Android | Unexpected error        |
+| Error Code            | Platform    | Description                       |
+| --------------------- | ----------- | --------------------------------- |
+| `PIN_REGEX_NOT_VALID` | iOS/Android | Invalid PIN format                |
+| `INVALID_AUTH_URL`    | iOS/Android | Invalid auth url format           |
+| `THREADING_ERROR`     | iOS         | Unexpected error                  |
+| `UNSUPPORTED`         | Android     | Feature not supported on platform |
+| `UNKNOWN_EXCEPTION`   | iOS/Android | Unexpected error                  |
 
 ## Contributing
 

package/android/build.gradle

@@ -78,6 +78,6 @@ dependencies {
   implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
   // CIE SDK
-  implementation "it.pagopa.io.app.cie:cie:0.1.9"
+  implementation "it.pagopa.io.app.cie:cie:0.1.10"
 }
 

package/android/src/main/java/com/pagopa/ioreactnativecie/IoReactNativeCieModule.kt

@@ -1,6 +1,7 @@
 package com.pagopa.ioreactnativecie
 
 import android.util.Base64
+import android.app.Activity
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
@@ -26,10 +27,15 @@ import it.pagopa.io.app.cie.pace.PaceCallback
 import it.pagopa.io.app.cie.toHex
 import it.pagopa.io.app.cie.cie.CieCertificateDataCallback
 import java.net.URL
+import java.lang.ref.WeakReference
 
 class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
   ReactContextBaseJavaModule(reactContext) {
 
+  private var _cieSdk: CieSDK? = null
+  private var _sdkActivityRef: WeakReference<Activity>? = null
+  private var _customIdpUrl: String? = null
+
   init {
     CieLogger.enabled = BuildConfig.DEBUG
   }
@@ -39,11 +45,27 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
   }
 
   /**
-   * Lazy value ensures it is initialized with a valid activity when first used.
+   * Getter for a valid Cie SDK instance. Because the SDK is initialized with an activity,
+   * the instance must be recreated if the original activity has changed.
    */
-  val cieSdk: CieSDK by lazy {
-    CieSDK.withContext(reactApplicationContext.currentActivity)
-  };
+  val cieSdk: CieSDK
+    get() {
+      val currentActivity = reactApplicationContext.currentActivity
+        ?: throw Exception("Can not initialize Cie SDK with a null activity")
+
+      val hasActivityChanged = _sdkActivityRef?.get() != currentActivity
+
+      if (_cieSdk == null || hasActivityChanged) {
+        val newSdk = CieSDK.withContext(currentActivity)
+        // Re-apply saved configurations
+        _customIdpUrl?.let { newSdk.withCustomIdpUrl(it) }
+        // Update references
+        _cieSdk = newSdk
+        _sdkActivityRef = WeakReference(currentActivity)
+      }
+
+      return _cieSdk!!
+    }
 
   @Suppress("unused")
   @ReactMethod
@@ -113,6 +135,7 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
   @Suppress("unused")
   @ReactMethod
   fun setCustomIdpUrl(url: String) {
+    _customIdpUrl = url
     cieSdk.withCustomIdpUrl(url)
   }
 
@@ -126,7 +149,7 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
   ) {
     val encoding: ResultEncoding = ResultEncoding.fromString(resultEncoding)
     try {
-      cieSdk.startReadingNis(challenge, timeout, object : NfcEvents {
+      cieSdk.startReadingNis(challenge, timeout, true, object : NfcEvents {
         override fun event(event: NfcEvent) {
           this@IoReactNativeCieModule.reactApplicationContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
             .emit(EventType.EVENT.value, WritableNativeMap().apply {
@@ -181,7 +204,7 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
   ) {
     val encoding: ResultEncoding = ResultEncoding.fromString(resultEncoding)
     try {
-      cieSdk.startDoPace(can, timeout, object : NfcEvents {
+      cieSdk.startDoPace(can, timeout, true, object : NfcEvents {
         override fun event(event: NfcEvent) {
           this@IoReactNativeCieModule.reactApplicationContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
             .emit(EventType.EVENT.value, WritableNativeMap().apply {
@@ -236,7 +259,7 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
   ) {
     val encoding: ResultEncoding = ResultEncoding.fromString(resultEncoding)
     try {
-      cieSdk.startNisAndPace(challenge, can, timeout, object : NfcEvents {
+      cieSdk.startNisAndPace(challenge, can, timeout, true, object : NfcEvents {
         override fun event(event: NfcEvent) {
           this@IoReactNativeCieModule.reactApplicationContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
             .emit(EventType.EVENT.value, WritableNativeMap().apply {
@@ -303,7 +326,7 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
     promise: Promise,
   ) {
     try {
-      cieSdk.startReadingCieAtr(timeout, object : NfcEvents {
+      cieSdk.startReadingCieAtr(timeout, true, object : NfcEvents {
         override fun event(event: NfcEvent) {
           this@IoReactNativeCieModule.reactApplicationContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
             .emit(EventType.EVENT.value, WritableNativeMap().apply {
@@ -369,7 +392,7 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
     }
 
     try {
-      cieSdk.startReading(timeout, object : NfcEvents {
+      cieSdk.startReading(timeout, true, object : NfcEvents {
         override fun event(event: NfcEvent) {
           this@IoReactNativeCieModule.reactApplicationContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
             .emit(EventType.EVENT.value, WritableNativeMap().apply {
@@ -424,7 +447,7 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
     }
 
     try {
-      cieSdk.startReadingCertificate(timeout, object : NfcEvents {
+      cieSdk.startReadingCertificate(timeout, true, object : NfcEvents {
         override fun event(event: NfcEvent) {
           this@IoReactNativeCieModule.reactApplicationContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
             .emit(EventType.EVENT.value, WritableNativeMap().apply {
@@ -469,6 +492,24 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
     }
   }
 
+  @Suppress("unused")
+  @ReactMethod
+  fun setLogMode(mode: String, promise: Promise) {
+    promise.reject(ModuleException.UNSUPPORTED, "Logging is not supported on Android", null)
+  }
+
+  @Suppress("unused")
+  @ReactMethod
+  fun getLogsFilePath(promise: Promise) {
+    promise.reject(ModuleException.UNSUPPORTED, "Logging is not supported on Android", null)
+  }
+
+  @Suppress("unused")
+  @ReactMethod
+  fun getLogs(promise: Promise) {
+    promise.reject(ModuleException.UNSUPPORTED, "Logging is not supported on Android", null)
+  }
+
   @Suppress("unused")
   @ReactMethod
   fun stopReading() {
@@ -553,6 +594,7 @@ class IoReactNativeCieModule(reactContext: ReactApplicationContext) :
       const val PIN_REGEX_NOT_VALID = "PIN_REGEX_NOT_VALID"
       const val INVALID_AUTH_URL = "INVALID_AUTH_URL"
       const val UNKNOWN_EXCEPTION = "UNKNOWN_EXCEPTION"
+      const val UNSUPPORTED = "UNSUPPORTED"
     }
   }
 }

package/ios/IoReactNativeCie.mm

@@ -59,6 +59,14 @@ RCT_EXTERN_METHOD(startReadingCertificate:  (NSString)pin
                   withResolver:             (RCTPromiseResolveBlock)resolve
                   withRejecter:             (RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(setLogMode: (NSString)mode)
+
+RCT_EXTERN_METHOD(getLogsFilePath:  (RCTPromiseResolveBlock)resolve
+                  withRejecter:     (RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(getLogs:      (RCTPromiseResolveBlock)resolve
+                  withRejecter: (RCTPromiseRejectBlock)reject)
+
 + (BOOL)requiresMainQueueSetup
 {
   return NO;

package/ios/IoReactNativeCie.swift

@@ -6,11 +6,7 @@ class IoReactNativeCie: RCTEventEmitter {
   private let cieSdk: CieDigitalId
   
   override init() {
-#if DEBUG
-    self.cieSdk = CieDigitalId.init(.console)
-#else
     self.cieSdk = CieDigitalId.init()
-#endif
     super.init()
   }
   
@@ -292,6 +288,33 @@ class IoReactNativeCie: RCTEventEmitter {
     }
   }
   
+  @objc func setLogMode(_ mode: NSString) {
+    let logMode = CieDigitalId.LogMode(rawValue: mode as String) ?? .disabled
+    cieSdk.setLogMode(logMode)
+  }
+  
+  @objc func getLogsFilePath(
+    _ resolve: RCTPromiseResolveBlock,
+    withRejecter reject: RCTPromiseRejectBlock
+  ) {
+    if let fileUrl = CieDigitalId.retriveLastLogFilePath() {
+      resolve(fileUrl)
+    } else {
+      reject(ModuleException.unexpected.rawValue, "Failed to retrieve last log file path", nil)
+    }
+  }
+  
+  @objc func getLogs(
+    _ resolve: RCTPromiseResolveBlock,
+    withRejecter reject: RCTPromiseRejectBlock
+  ) {
+    if let logs = CieDigitalId.retriveLastLogFile() {
+      resolve(logs)
+    } else {
+      reject(ModuleException.unexpected.rawValue, "Failed to retrieve last log", nil)
+    }
+  }
+  
   func handleReadEvent(event: CieSDK.CieDigitalIdEvent, progress: Float) {
     let payload: NSDictionary = ["name": "\(event)", "progress": progress]
     self.sendEvent(withName: EventType.onEvent.rawValue, body: payload)

package/lib/module/errors.js

@@ -34,7 +34,7 @@ const ModuleErrorIosSchema = z.object({
  */
 const ModuleErrorCodesSchema = z.enum(['PIN_REGEX_NOT_VALID', 'INVALID_AUTH_URL', 'THREADING_ERROR',
 // iOS only
-'UNKNOWN_EXCEPTION']);
+'UNSUPPORTED', 'UNKNOWN_EXCEPTION']);
 /**
  * Schema which can be used to parse a rejected promise error the module.
  * This schema contains the common parameters that are shared across both Android and iOS native modules.

package/lib/module/errors.js.map

@@ -1 +1 @@
-{"version":3,"names":["z","StackTraceElementSchema","object","lineNumber","number","file","string","methodName","class","ModuleErrorAndroidSchema","nativeStackAndroid","array","partial","ModuleErrorIosSchema","domain","nativeStackIOS","ModuleErrorCodesSchema","enum","CieErrorSchema","code","message","name","userInfo","record","any","optional","or","null","and"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;AAAA,SAASA,CAAC,QAAQ,KAAK;;AAEvB;AACA;AACA;AACA,MAAMC,uBAAuB,GAAGD,CAAC,CAACE,MAAM,CAAC;EACvCC,UAAU,EAAEH,CAAC,CAACI,MAAM,CAAC,CAAC;EACtBC,IAAI,EAAEL,CAAC,CAACM,MAAM,CAAC,CAAC;EAChBC,UAAU,EAAEP,CAAC,CAACM,MAAM,CAAC,CAAC;EACtBE,KAAK,EAAER,CAAC,CAACM,MAAM,CAAC;AAClB,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA,MAAMG,wBAAwB,GAAGT,CAAC,CAC/BE,MAAM,CAAC;EACNQ,kBAAkB,EAAEV,CAAC,CAACW,KAAK,CAACV,uBAAuB;AACrD,CAAC,CAAC,CACDW,OAAO,CAAC,CAAC;;AAEZ;AACA;AACA;AACA;AACA,MAAMC,oBAAoB,GAAGb,CAAC,CAC3BE,MAAM,CAAC;EACNY,MAAM,EAAEd,CAAC,CAACM,MAAM,CAAC,CAAC;EAClBS,cAAc,EAAEf,CAAC,CAACW,KAAK,CAACX,CAAC,CAACM,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC,CACDM,OAAO,CAAC,CAAC;;AAEZ;AACA;AACA;AACA,MAAMI,sBAAsB,GAAGhB,CAAC,CAACiB,IAAI,CAAC,CACpC,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB;AAAE;AACnB,mBAAmB,CACpB,CAAC;AAIF;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAMC,cAAc,GAAGlB,CAAC,CAC5BE,MAAM,CAAC;EACNiB,IAAI,EAAEH,sBAAsB;EAC5BI,OAAO,EAAEpB,CAAC,CAACM,MAAM,CAAC,CAAC;EACnBe,IAAI,EAAErB,CAAC,CAACM,MAAM,CAAC,CAAC;EAChBgB,QAAQ,EAAEtB,CAAC,CAACuB,MAAM,CAACvB,CAAC,CAACM,MAAM,CAAC,CAAC,EAAEN,CAAC,CAACwB,GAAG,CAAC,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC,CAACC,EAAE,CAAC1B,CAAC,CAAC2B,IAAI,CAAC,CAAC;AAChE,CAAC,CAAC,CACDC,GAAG,CAACnB,wBAAwB,CAAC,CAC7BmB,GAAG,CAACf,oBAAoB,CAAC","ignoreList":[]}
+{"version":3,"names":["z","StackTraceElementSchema","object","lineNumber","number","file","string","methodName","class","ModuleErrorAndroidSchema","nativeStackAndroid","array","partial","ModuleErrorIosSchema","domain","nativeStackIOS","ModuleErrorCodesSchema","enum","CieErrorSchema","code","message","name","userInfo","record","any","optional","or","null","and"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;AAAA,SAASA,CAAC,QAAQ,KAAK;;AAEvB;AACA;AACA;AACA,MAAMC,uBAAuB,GAAGD,CAAC,CAACE,MAAM,CAAC;EACvCC,UAAU,EAAEH,CAAC,CAACI,MAAM,CAAC,CAAC;EACtBC,IAAI,EAAEL,CAAC,CAACM,MAAM,CAAC,CAAC;EAChBC,UAAU,EAAEP,CAAC,CAACM,MAAM,CAAC,CAAC;EACtBE,KAAK,EAAER,CAAC,CAACM,MAAM,CAAC;AAClB,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA,MAAMG,wBAAwB,GAAGT,CAAC,CAC/BE,MAAM,CAAC;EACNQ,kBAAkB,EAAEV,CAAC,CAACW,KAAK,CAACV,uBAAuB;AACrD,CAAC,CAAC,CACDW,OAAO,CAAC,CAAC;;AAEZ;AACA;AACA;AACA;AACA,MAAMC,oBAAoB,GAAGb,CAAC,CAC3BE,MAAM,CAAC;EACNY,MAAM,EAAEd,CAAC,CAACM,MAAM,CAAC,CAAC;EAClBS,cAAc,EAAEf,CAAC,CAACW,KAAK,CAACX,CAAC,CAACM,MAAM,CAAC,CAAC;AACpC,CAAC,CAAC,CACDM,OAAO,CAAC,CAAC;;AAEZ;AACA;AACA;AACA,MAAMI,sBAAsB,GAAGhB,CAAC,CAACiB,IAAI,CAAC,CACpC,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB;AAAE;AACnB,aAAa,EACb,mBAAmB,CACpB,CAAC;AAIF;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,MAAMC,cAAc,GAAGlB,CAAC,CAC5BE,MAAM,CAAC;EACNiB,IAAI,EAAEH,sBAAsB;EAC5BI,OAAO,EAAEpB,CAAC,CAACM,MAAM,CAAC,CAAC;EACnBe,IAAI,EAAErB,CAAC,CAACM,MAAM,CAAC,CAAC;EAChBgB,QAAQ,EAAEtB,CAAC,CAACuB,MAAM,CAACvB,CAAC,CAACM,MAAM,CAAC,CAAC,EAAEN,CAAC,CAACwB,GAAG,CAAC,CAAC,CAAC,CAACC,QAAQ,CAAC,CAAC,CAACC,EAAE,CAAC1B,CAAC,CAAC2B,IAAI,CAAC,CAAC;AAChE,CAAC,CAAC,CACDC,GAAG,CAACnB,wBAAwB,CAAC,CAC7BmB,GAAG,CAACf,oBAAoB,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -2,5 +2,6 @@
 
 import * as CieUtils from "./utils/index.js";
 import * as CieManager from "./manager/index.js";
-export { CieUtils, CieManager };
+import * as CieLogger from "./logger/index.js";
+export { CieUtils, CieManager, CieLogger };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["CieUtils","CieManager"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,OAAO,KAAKA,QAAQ,MAAM,kBAAS;AACnC,OAAO,KAAKC,UAAU,MAAM,oBAAW;AAEvC,SAASD,QAAQ,EAAEC,UAAU","ignoreList":[]}
+{"version":3,"names":["CieUtils","CieManager","CieLogger"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,OAAO,KAAKA,QAAQ,MAAM,kBAAS;AACnC,OAAO,KAAKC,UAAU,MAAM,oBAAW;AACvC,OAAO,KAAKC,SAAS,MAAM,mBAAU;AAErC,SAASF,QAAQ,EAAEC,UAAU,EAAEC,SAAS","ignoreList":[]}

package/lib/module/logger/index.js

@@ -0,0 +1,37 @@
+"use strict";
+
+import { IoReactNativeCie } from "../native.js";
+/**
+ * Sets the log mode for the CIE SDK.
+ *
+ * **Note**: Logging is only supported on iOS. On Android, this method will throw an error.
+ *
+ * @param mode - The log mode to set ('console', 'localFile', or 'disabled').
+ * @example
+ * ```typescript
+ * CieManager.setLogMode('console');
+ * ```
+ */
+const setLogMode = mode => {
+  IoReactNativeCie.setLogMode(mode);
+};
+
+/**
+ * Retrieves the file path of the latest logs generated by the CIE SDK.
+ * @returns A promise that resolves to a string representing the file path of the latest logs.
+ * @throws {CieError} If cannot retrieve the logs path.
+ */
+const getLogsFilePath = async () => {
+  return IoReactNativeCie.getLogsFilePath();
+};
+
+/**
+ * Retrieves the contetent of the latest logs generated by the CIE SDK.
+ * @returns A promise that resolves to a string representing the content of the latest logs.
+ * @throws {CieError} If cannot retrieve the logs content.
+ */
+const getLogs = async () => {
+  return IoReactNativeCie.getLogs();
+};
+export { setLogMode, getLogsFilePath, getLogs };
+//# sourceMappingURL=index.js.map

package/lib/module/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["IoReactNativeCie","setLogMode","mode","getLogsFilePath","getLogs"],"sourceRoot":"../../../src","sources":["logger/index.ts"],"mappings":";;AAAA,SAASA,gBAAgB,QAAQ,cAAW;AAG5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,UAAU,GAAIC,IAAa,IAAK;EACpCF,gBAAgB,CAACC,UAAU,CAACC,IAAI,CAAC;AACnC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,MAAMC,eAAe,GAAG,MAAAA,CAAA,KAA6B;EACnD,OAAOH,gBAAgB,CAACG,eAAe,CAAC,CAAC;AAC3C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,MAAMC,OAAO,GAAG,MAAAA,CAAA,KAA6B;EAC3C,OAAOJ,gBAAgB,CAACI,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAASH,UAAU,EAAEE,eAAe,EAAEC,OAAO","ignoreList":[]}

package/lib/module/logger/types.js

@@ -0,0 +1,15 @@
+"use strict";
+
+import { z } from 'zod';
+
+/**
+ * Represent the log mode for the CIE SDK
+ *
+ * - `localFile`: Logs are saved to a local file on the device for later retrieval.
+ * - `console`: Logs are output to the console for real-time monitoring.
+ * - `disabled`: Disables all logging
+ *
+ * **Note**: Logging is only supported on iOS. On Android, setting the log mode will throw an error.
+ */
+export const LogMode = z.enum(['localFile', 'console', 'disabled']);
+//# sourceMappingURL=types.js.map

package/lib/module/logger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["z","LogMode","enum"],"sourceRoot":"../../../src","sources":["logger/types.ts"],"mappings":";;AAAA,SAASA,CAAC,QAAQ,KAAK;;AAEvB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,OAAO,GAAGD,CAAC,CAACE,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC","ignoreList":[]}

package/lib/typescript/src/errors.d.ts

@@ -2,7 +2,7 @@ import { z } from 'zod';
 /**
  * Error codes which the module uses to reject a promise.
  */
-declare const ModuleErrorCodesSchema: z.ZodEnum<["PIN_REGEX_NOT_VALID", "INVALID_AUTH_URL", "THREADING_ERROR", "UNKNOWN_EXCEPTION"]>;
+declare const ModuleErrorCodesSchema: z.ZodEnum<["PIN_REGEX_NOT_VALID", "INVALID_AUTH_URL", "THREADING_ERROR", "UNSUPPORTED", "UNKNOWN_EXCEPTION"]>;
 export type CieErrorCodes = z.infer<typeof ModuleErrorCodesSchema>;
 /**
  * Schema which can be used to parse a rejected promise error the module.
@@ -12,17 +12,17 @@ export type CieErrorCodes = z.infer<typeof ModuleErrorCodesSchema>;
  * @returns A schema for the common parameters of a rejected promise error in a native module.
  */
 export declare const CieErrorSchema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
-    code: z.ZodEnum<["PIN_REGEX_NOT_VALID", "INVALID_AUTH_URL", "THREADING_ERROR", "UNKNOWN_EXCEPTION"]>;
+    code: z.ZodEnum<["PIN_REGEX_NOT_VALID", "INVALID_AUTH_URL", "THREADING_ERROR", "UNSUPPORTED", "UNKNOWN_EXCEPTION"]>;
     message: z.ZodString;
     name: z.ZodString;
     userInfo: z.ZodUnion<[z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>, z.ZodNull]>;
 }, "strip", z.ZodTypeAny, {
-    code: "PIN_REGEX_NOT_VALID" | "INVALID_AUTH_URL" | "THREADING_ERROR" | "UNKNOWN_EXCEPTION";
+    code: "PIN_REGEX_NOT_VALID" | "INVALID_AUTH_URL" | "THREADING_ERROR" | "UNSUPPORTED" | "UNKNOWN_EXCEPTION";
     message: string;
     name: string;
     userInfo?: Record<string, any> | null | undefined;
 }, {
-    code: "PIN_REGEX_NOT_VALID" | "INVALID_AUTH_URL" | "THREADING_ERROR" | "UNKNOWN_EXCEPTION";
+    code: "PIN_REGEX_NOT_VALID" | "INVALID_AUTH_URL" | "THREADING_ERROR" | "UNSUPPORTED" | "UNKNOWN_EXCEPTION";
     message: string;
     name: string;
     userInfo?: Record<string, any> | null | undefined;

package/lib/typescript/src/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiCxB;;GAEG;AACH,QAAA,MAAM,sBAAsB,gGAK1B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEnE;;;;;;GAMG;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAQC,CAAC;AAE7B,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiCxB;;GAEG;AACH,QAAA,MAAM,sBAAsB,+GAM1B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEnE;;;;;;GAMG;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAQC,CAAC;AAE7B,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,6 +1,8 @@
 import * as CieUtils from './utils';
 import * as CieManager from './manager';
-export { CieUtils, CieManager };
-export type { NfcEvent, NfcError, CieAttributes, CieEventHandlers, CieEvent, InternalAuthResponse, MrtdResponse, InternalAuthAndMrtdResponse, ResultEncoding, } from './manager/types';
+import * as CieLogger from './logger';
+export { CieUtils, CieManager, CieLogger };
+export type { NfcEvent, NfcError, CieAttributes, CieEventHandlers, CieEvent, InternalAuthResponse, MrtdResponse, InternalAuthAndMrtdResponse, ResultEncoding, CertificateData, } from './manager/types';
+export type { LogMode } from './logger/types';
 export type { CieErrorSchema, CieError, CieErrorCodes } from './errors';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,UAAU,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAEhC,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,2BAA2B,EAC3B,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,UAAU,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAE3C,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,oBAAoB,EACpB,YAAY,EACZ,2BAA2B,EAC3B,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/lib/typescript/src/logger/index.d.ts

@@ -0,0 +1,27 @@
+import { type LogMode } from './types';
+/**
+ * Sets the log mode for the CIE SDK.
+ *
+ * **Note**: Logging is only supported on iOS. On Android, this method will throw an error.
+ *
+ * @param mode - The log mode to set ('console', 'localFile', or 'disabled').
+ * @example
+ * ```typescript
+ * CieManager.setLogMode('console');
+ * ```
+ */
+declare const setLogMode: (mode: LogMode) => void;
+/**
+ * Retrieves the file path of the latest logs generated by the CIE SDK.
+ * @returns A promise that resolves to a string representing the file path of the latest logs.
+ * @throws {CieError} If cannot retrieve the logs path.
+ */
+declare const getLogsFilePath: () => Promise<string>;
+/**
+ * Retrieves the contetent of the latest logs generated by the CIE SDK.
+ * @returns A promise that resolves to a string representing the content of the latest logs.
+ * @throws {CieError} If cannot retrieve the logs content.
+ */
+declare const getLogs: () => Promise<string>;
+export { setLogMode, getLogsFilePath, getLogs };
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/logger/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,QAAA,MAAM,UAAU,GAAI,MAAM,OAAO,SAEhC,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,eAAe,QAAa,OAAO,CAAC,MAAM,CAE/C,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,OAAO,QAAa,OAAO,CAAC,MAAM,CAEvC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC"}

package/lib/typescript/src/logger/types.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+/**
+ * Represent the log mode for the CIE SDK
+ *
+ * - `localFile`: Logs are saved to a local file on the device for later retrieval.
+ * - `console`: Logs are output to the console for real-time monitoring.
+ * - `disabled`: Disables all logging
+ *
+ * **Note**: Logging is only supported on iOS. On Android, setting the log mode will throw an error.
+ */
+export declare const LogMode: z.ZodEnum<["localFile", "console", "disabled"]>;
+export type LogMode = z.infer<typeof LogMode>;
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/logger/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/logger/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,iDAA+C,CAAC;AAEpE,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagopa/io-react-native-cie",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "Native support for CIE",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",

package/src/errors.ts

@@ -38,6 +38,7 @@ const ModuleErrorCodesSchema = z.enum([
   'PIN_REGEX_NOT_VALID',
   'INVALID_AUTH_URL',
   'THREADING_ERROR', // iOS only
+  'UNSUPPORTED',
   'UNKNOWN_EXCEPTION',
 ]);
 

package/src/index.ts

@@ -1,7 +1,8 @@
 import * as CieUtils from './utils';
 import * as CieManager from './manager';
+import * as CieLogger from './logger';
 
-export { CieUtils, CieManager };
+export { CieUtils, CieManager, CieLogger };
 
 export type {
   NfcEvent,
@@ -13,6 +14,9 @@ export type {
   MrtdResponse,
   InternalAuthAndMrtdResponse,
   ResultEncoding,
+  CertificateData,
 } from './manager/types';
 
+export type { LogMode } from './logger/types';
+
 export type { CieErrorSchema, CieError, CieErrorCodes } from './errors';

package/src/logger/index.ts

@@ -0,0 +1,37 @@
+import { IoReactNativeCie } from '../native';
+import { type LogMode } from './types';
+
+/**
+ * Sets the log mode for the CIE SDK.
+ *
+ * **Note**: Logging is only supported on iOS. On Android, this method will throw an error.
+ *
+ * @param mode - The log mode to set ('console', 'localFile', or 'disabled').
+ * @example
+ * ```typescript
+ * CieManager.setLogMode('console');
+ * ```
+ */
+const setLogMode = (mode: LogMode) => {
+  IoReactNativeCie.setLogMode(mode);
+};
+
+/**
+ * Retrieves the file path of the latest logs generated by the CIE SDK.
+ * @returns A promise that resolves to a string representing the file path of the latest logs.
+ * @throws {CieError} If cannot retrieve the logs path.
+ */
+const getLogsFilePath = async (): Promise<string> => {
+  return IoReactNativeCie.getLogsFilePath();
+};
+
+/**
+ * Retrieves the contetent of the latest logs generated by the CIE SDK.
+ * @returns A promise that resolves to a string representing the content of the latest logs.
+ * @throws {CieError} If cannot retrieve the logs content.
+ */
+const getLogs = async (): Promise<string> => {
+  return IoReactNativeCie.getLogs();
+};
+
+export { setLogMode, getLogsFilePath, getLogs };

package/src/logger/types.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+
+/**
+ * Represent the log mode for the CIE SDK
+ *
+ * - `localFile`: Logs are saved to a local file on the device for later retrieval.
+ * - `console`: Logs are output to the console for real-time monitoring.
+ * - `disabled`: Disables all logging
+ *
+ * **Note**: Logging is only supported on iOS. On Android, setting the log mode will throw an error.
+ */
+export const LogMode = z.enum(['localFile', 'console', 'disabled']);
+
+export type LogMode = z.infer<typeof LogMode>;