@pagopa/io-react-native-cie 1.2.0 → 1.2.2

package/lib/module/manager/index.js

@@ -100,7 +100,7 @@ export const setCurrentAlertMessage = value => {
  * Initiates the internal authentication process using the provided challenge and timeout.
  *
  * @param challenge - The challenge string to be used for authentication.
- * @param resultEncoding - The encoding of the result byte arrays, either 'base64' or 'hex' (default: 'base64')
+ * @param resultEncoding - The encoding of the result byte arrays, either 'base64', 'base64url' or 'hex' (default: 'base64')
  * @param timeout - Optional timeout in milliseconds (default: 10000) (**Note**: Android only)
  * @returns A promise that resolves when the authentication process has ended.
  */
@@ -108,6 +108,103 @@ const startInternalAuthentication = async (challenge, resultEncoding = 'base64',
   return IoReactNativeCie.startInternalAuthentication(challenge, resultEncoding, timeout);
 };
 
+/**
+ * Initiates a PACE (Password Authenticated Connection Establishment) reading
+ * session on a CIE (Carta d'Identità Elettronica) using the provided CAN (Card
+ * Access Number) to read the MRTD information.
+ *
+ * The operation is asynchronous; Since the Promise resolves
+ * with `void`, any resulting data or errors are expected to be surfaced through
+ * native events.
+ *
+ * @param can The 6‑digit Card Access Number printed on the CIE, used to
+ *            bootstrap the PACE secure messaging protocol. Must be a numeric
+ *            string; validation (if any) occurs in the native layer.
+ * @param resultEncoding The encoding format expected for any binary payloads
+ *                       produced during the reading process. Defaults to
+ *                       `'base64'`. Use `'hex'` if downstream consumers require
+ *                       hexadecimal representation.
+ * @param timeout Maximum time (in milliseconds) allowed for the PACE reading
+ *                session before it is aborted. Defaults to `DEFAULT_TIMEOUT`.
+ *                A larger value may be required on older devices or in
+ *                environments with slower NFC interactions.
+ *
+ * @returns Promise that resolves when the reading process has started.
+ *
+ * @throws May reject with:
+ * - Invalid input (e.g., malformed CAN).
+ * - NFC subsystem unavailable or disabled.
+ * - Operation timeout exceeded.
+ * - Native module internal errors.
+ *
+ * @example
+ * await startPaceReading("123456"); // Uses base64 encoding and default timeout.
+ *
+ * @example
+ * await startPaceReading("654321", "hex", 15000);
+ *
+ * @remarks
+ * Ensure NFC is enabled and the user has positioned the CIE correctly before
+ * calling this function to minimize timeouts and improve reliability.
+ *
+ * Once the MRTD reading with PACE flow has been initiated, a Promise resolves,
+ * while when the reading process produces data, the `'onSuccess'` event has been called.
+ * The `'onError'` event is called if an error occurs during the reading process.
+ * The `'onEvent'` event is called to provide progress updates.
+ */
+const startMRTDReading = async (can, resultEncoding = 'base64', timeout = DEFAULT_TIMEOUT) => {
+  return IoReactNativeCie.startMRTDReading(can, resultEncoding, timeout);
+};
+
+/**
+ * Initiates a combined reading session on a CIE (Carta d'Identità Elettronica)
+ * that performs both Internal Authentication and MRTD reading using PACE.
+ *
+ * The operation is asynchronous; Since the Promise resolves
+ * with `void`, any resulting data or errors are expected to be surfaced through
+ * native events.
+ *
+ * @param can The 6‑digit Card Access Number printed on the CIE, used to
+ *            bootstrap the PACE secure messaging protocol. Must be a numeric
+ *            string; validation (if any) occurs in the native layer.
+ * @param challenge The challenge string to be used for Internal Authentication.
+ * @param resultEncoding The encoding format expected for any binary payloads
+ *                       produced during the reading process. Defaults to
+ *                       `'base64'`. Use `'hex'` if downstream consumers require
+ *                       hexadecimal representation.
+ * @param timeout Maximum time (in milliseconds) allowed for the combined reading
+ *                session before it is aborted. Defaults to `DEFAULT_TIMEOUT`.
+ *                A larger value may be required on older devices or in
+ *                environments with slower NFC interactions.
+ *
+ * @returns Promise that resolves when the reading process has started.
+ *
+ * @throws May reject with:
+ * - Invalid input (e.g., malformed CAN or challenge).
+ * - NFC subsystem unavailable or disabled.
+ * - Operation timeout exceeded.
+ * - Native module internal errors.
+ *
+ * @example
+ * await startInternalAuthAndMRTDReading("123456", "challengeString");
+ *
+ * @example
+ * await startInternalAuthAndMRTDReading("654321", "challengeString", "hex", 15000);
+ *
+ * @remarks
+ * Ensure NFC is enabled and the user has positioned the CIE correctly before
+ * calling this function to minimize timeouts and improve reliability.
+ *
+ * Once the Internal Authentication and MRTD reading with PACE flow has been initiated,
+ * a Promise resolves, while when the reading process produces data,
+ * the `'onSuccess'` event has been called.
+ * The `'onError'` event is called if an error occurs during the reading process.
+ * The `'onEvent'` event is called to provide progress updates.
+ */
+const startInternalAuthAndMRTDReading = async (can, challenge, resultEncoding = 'base64', timeout = DEFAULT_TIMEOUT) => {
+  return IoReactNativeCie.startInternalAuthAndMRTDReading(can, challenge, resultEncoding, timeout);
+};
+
 /**
  * Starts the process of reading attributes from the CIE card.
  *
@@ -159,5 +256,5 @@ const startReading = async (pin, authenticationUrl, timeout = DEFAULT_TIMEOUT) =
 const stopReading = async () => {
   return IoReactNativeCie.stopReading();
 };
-export { addListener, removeListener, removeAllListeners, setCustomIdpUrl, startReadingAttributes, startInternalAuthentication, startReading, stopReading };
+export { addListener, removeListener, removeAllListeners, setCustomIdpUrl, startReadingAttributes, startInternalAuthentication, startMRTDReading, startInternalAuthAndMRTDReading, startReading, stopReading };
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","IoReactNativeCie","getDefaultIdpUrl","DEFAULT_TIMEOUT","eventEmitter","addListener","event","listener","subscription","remove","removeListener","removeAllListeners","setCustomIdpUrl","url","setAlertMessage","key","value","setCurrentAlertMessage","startInternalAuthentication","challenge","resultEncoding","timeout","startReadingAttributes","startReading","pin","authenticationUrl","stopReading"],"sourceRoot":"../../../src","sources":["manager/index.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,cAAc;AACjD,SAASC,gBAAgB,QAAQ,cAAW;AAE5C,SAASC,gBAAgB,QAAQ,YAAS;AAE1C,MAAMC,eAAe,GAAG,KAAK;AAE7B,MAAMC,YAAY,GAAG,IAAIJ,kBAAkB,CAACC,gBAAgB,CAAC;;AAE7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMI,WAAW,GAAGA,CAClBC,KAAQ,EACRC,QAA6B,KAC1B;EACH,MAAMC,YAAY,GAAGJ,YAAY,CAACC,WAAW,CAACC,KAAK,EAAEC,QAAQ,CAAC;EAC9D,OAAOC,YAAY,CAACC,MAAM;AAC5B,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,MAAMC,cAAc,GAAIJ,KAAe,IAAK;EAC1CF,YAAY,CAACO,kBAAkB,CAACL,KAAK,CAAC;AACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMK,kBAAkB,GAAGA,CAAA,KAAM;EAC/BP,YAAY,CAACO,kBAAkB,CAAC,SAAS,CAAC;EAC1CP,YAAY,CAACO,kBAAkB,CAAC,SAAS,CAAC;EAC1CP,YAAY,CAACO,kBAAkB,CAAC,qBAAqB,CAAC;EACtDP,YAAY,CAACO,kBAAkB,CAAC,WAAW,CAAC;AAC9C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,eAAe,GAAIC,GAAuB,IAAK;EACnDZ,gBAAgB,CAACW,eAAe,CAACC,GAAG,IAAIX,gBAAgB,CAAC,CAAC,CAAC;AAC7D,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMY,eAAe,GAAGA,CAACC,GAAoB,EAAEC,KAAa,KAAK;EACtEf,gBAAgB,CAACa,eAAe,CAACC,GAAG,EAAEC,KAAK,CAAC;AAC9C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,sBAAsB,GAAID,KAAa,IAAK;EACvDf,gBAAgB,CAACgB,sBAAsB,CAACD,KAAK,CAAC;AAChD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAME,2BAA2B,GAAG,MAAAA,CAClCC,SAAiB,EACjBC,cAAgC,GAAG,QAAQ,EAC3CC,OAAe,GAAGlB,eAAe,KACf;EAClB,OAAOF,gBAAgB,CAACiB,2BAA2B,CACjDC,SAAS,EACTC,cAAc,EACdC,OACF,CAAC;AACH,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,sBAAsB,GAAG,MAAAA,CAC7BD,OAAe,GAAGlB,eAAe,KACf;EAClB,OAAOF,gBAAgB,CAACqB,sBAAsB,CAACD,OAAO,CAAC;AACzD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAME,YAAY,GAAG,MAAAA,CACnBC,GAAW,EACXC,iBAAyB,EACzBJ,OAAe,GAAGlB,eAAe,KACf;EAClB,OAAOF,gBAAgB,CAACsB,YAAY,CAACC,GAAG,EAAEC,iBAAiB,EAAEJ,OAAO,CAAC;AACvE,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMK,WAAW,GAAG,MAAAA,CAAA,KAA2B;EAC7C,OAAOzB,gBAAgB,CAACyB,WAAW,CAAC,CAAC;AACvC,CAAC;AAED,SACErB,WAAW,EACXK,cAAc,EACdC,kBAAkB,EAClBC,eAAe,EACfU,sBAAsB,EACtBJ,2BAA2B,EAC3BK,YAAY,EACZG,WAAW","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","IoReactNativeCie","getDefaultIdpUrl","DEFAULT_TIMEOUT","eventEmitter","addListener","event","listener","subscription","remove","removeListener","removeAllListeners","setCustomIdpUrl","url","setAlertMessage","key","value","setCurrentAlertMessage","startInternalAuthentication","challenge","resultEncoding","timeout","startMRTDReading","can","startInternalAuthAndMRTDReading","startReadingAttributes","startReading","pin","authenticationUrl","stopReading"],"sourceRoot":"../../../src","sources":["manager/index.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,cAAc;AACjD,SAASC,gBAAgB,QAAQ,cAAW;AAO5C,SAASC,gBAAgB,QAAQ,YAAS;AAE1C,MAAMC,eAAe,GAAG,KAAK;AAE7B,MAAMC,YAAY,GAAG,IAAIJ,kBAAkB,CAACC,gBAAgB,CAAC;;AAE7D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMI,WAAW,GAAGA,CAClBC,KAAQ,EACRC,QAA6B,KAC1B;EACH,MAAMC,YAAY,GAAGJ,YAAY,CAACC,WAAW,CAACC,KAAK,EAAEC,QAAQ,CAAC;EAC9D,OAAOC,YAAY,CAACC,MAAM;AAC5B,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,MAAMC,cAAc,GAAIJ,KAAe,IAAK;EAC1CF,YAAY,CAACO,kBAAkB,CAACL,KAAK,CAAC;AACxC,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMK,kBAAkB,GAAGA,CAAA,KAAM;EAC/BP,YAAY,CAACO,kBAAkB,CAAC,SAAS,CAAC;EAC1CP,YAAY,CAACO,kBAAkB,CAAC,SAAS,CAAC;EAC1CP,YAAY,CAACO,kBAAkB,CAAC,qBAAqB,CAAC;EACtDP,YAAY,CAACO,kBAAkB,CAAC,WAAW,CAAC;AAC9C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,eAAe,GAAIC,GAAuB,IAAK;EACnDZ,gBAAgB,CAACW,eAAe,CAACC,GAAG,IAAIX,gBAAgB,CAAC,CAAC,CAAC;AAC7D,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMY,eAAe,GAAGA,CAACC,GAAoB,EAAEC,KAAa,KAAK;EACtEf,gBAAgB,CAACa,eAAe,CAACC,GAAG,EAAEC,KAAK,CAAC;AAC9C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,sBAAsB,GAAID,KAAa,IAAK;EACvDf,gBAAgB,CAACgB,sBAAsB,CAACD,KAAK,CAAC;AAChD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAME,2BAA2B,GAAG,MAAAA,CAClCC,SAAiB,EACjBC,cAA8B,GAAG,QAAQ,EACzCC,OAAe,GAAGlB,eAAe,KACf;EAClB,OAAOF,gBAAgB,CAACiB,2BAA2B,CACjDC,SAAS,EACTC,cAAc,EACdC,OACF,CAAC;AACH,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,gBAAgB,GAAG,MAAAA,CACvBC,GAAW,EACXH,cAA8B,GAAG,QAAQ,EACzCC,OAAe,GAAGlB,eAAe,KACf;EAClB,OAAOF,gBAAgB,CAACqB,gBAAgB,CAACC,GAAG,EAAEH,cAAc,EAAEC,OAAO,CAAC;AACxE,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMG,+BAA+B,GAAG,MAAAA,CACtCD,GAAW,EACXJ,SAAiB,EACjBC,cAA8B,GAAG,QAAQ,EACzCC,OAAe,GAAGlB,eAAe,KACf;EAClB,OAAOF,gBAAgB,CAACuB,+BAA+B,CACrDD,GAAG,EACHJ,SAAS,EACTC,cAAc,EACdC,OACF,CAAC;AACH,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMI,sBAAsB,GAAG,MAAAA,CAC7BJ,OAAe,GAAGlB,eAAe,KACf;EAClB,OAAOF,gBAAgB,CAACwB,sBAAsB,CAACJ,OAAO,CAAC;AACzD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMK,YAAY,GAAG,MAAAA,CACnBC,GAAW,EACXC,iBAAyB,EACzBP,OAAe,GAAGlB,eAAe,KACf;EAClB,OAAOF,gBAAgB,CAACyB,YAAY,CAACC,GAAG,EAAEC,iBAAiB,EAAEP,OAAO,CAAC;AACvE,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMQ,WAAW,GAAG,MAAAA,CAAA,KAA2B;EAC7C,OAAO5B,gBAAgB,CAAC4B,WAAW,CAAC,CAAC;AACvC,CAAC;AAED,SACExB,WAAW,EACXK,cAAc,EACdC,kBAAkB,EAClBC,eAAe,EACfa,sBAAsB,EACtBP,2BAA2B,EAC3BI,gBAAgB,EAChBE,+BAA+B,EAC/BE,YAAY,EACZG,WAAW","ignoreList":[]}

package/lib/module/manager/types.js

@@ -34,8 +34,8 @@ z.object({
   attemptsLeft: z.number()
 })]);
 /**
- * Represent the CIE attributes containing the CIE type
- * All string value are Hex encoded
+ * Represent the CIE response coming from NIS Internal Auth
+ * All string value are Hex or Base64 encoded
  */
 export const InternalAuthResponseObject = z.object({
   nis: z.string(),
@@ -43,6 +43,33 @@ export const InternalAuthResponseObject = z.object({
   sod: z.string(),
   signedChallenge: z.string()
 });
+/**
+ * Represent the CIE response coming from MRTD with PACE reading
+ * All string value are Hex or Base64 encoded
+ */
+export const MrtdResponseObject = z.object({
+  dg1: z.string(),
+  dg11: z.string(),
+  sod: z.string()
+});
+/**
+ * Represent the CIE response coming from NIS Internal Auth
+ * and MRTD with PACE reading during the same NFC session.
+ * All string value are Hex or Base64 encoded
+ */
+export const InternalAuthAndMrtdResponse = z.object({
+  nis_data: z.object({
+    nis: z.string(),
+    publicKey: z.string(),
+    sod: z.string(),
+    signedChallenge: z.string()
+  }),
+  mrtd_data: z.object({
+    dg1: z.string(),
+    dg11: z.string(),
+    sod: z.string()
+  })
+});
 /**
  * Represent the CIE attributes containing the CIE type
  */
@@ -51,6 +78,10 @@ export const CieAttributes = z.object({
   base64: z.string()
 });
 
+/**
+ * Possible encodings for the CIE reading results
+ */
+
 /**
  * Event handler that can be used to handle the CIE events during the reading process
  */

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

@@ -1 +1 @@
-{"version":3,"names":["z","AlertMessageKey","enum","NfcEvent","object","name","string","progress","coerce","number","NfcErrorName","NfcError","union","exclude","message","optional","extract","attemptsLeft","InternalAuthResponseObject","nis","publicKey","sod","signedChallenge","CieAttributes","type","base64"],"sourceRoot":"../../../src","sources":["manager/types.ts"],"mappings":";;AAAA,SAASA,CAAC,QAAQ,KAAK;;AAEvB;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,GAAGD,CAAC,CAACE,IAAI,CAAC,CACpC,qBAAqB,EACrB,UAAU,EACV,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,CACf,CAAC;AAIF;AACA;AACA;AACA;AACA,OAAO,MAAMC,QAAQ,GAAGH,CAAC,CAACI,MAAM,CAAC;EAC/BC,IAAI,EAAEL,CAAC,CAACM,MAAM,CAAC,CAAC;EAChBC,QAAQ,EAAEP,CAAC,CAACQ,MAAM,CAACC,MAAM,CAAC;AAC5B,CAAC,CAAC;AAIF;AACA;AACA;AACA,OAAO,MAAMC,YAAY,GAAGV,CAAC,CAACE,IAAI,CAAC,CACjC,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,CAChB,CAAC;AAIF;AACA;AACA;AACA,OAAO,MAAMS,QAAQ,GAAGX,CAAC,CAACY,KAAK,CAAC,CAC9BZ,CAAC,CAACI,MAAM,CAAC;EACPC,IAAI,EAAEK,YAAY,CAACG,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC;EACzCC,OAAO,EAAEd,CAAC,CAACM,MAAM,CAAC,CAAC,CAACS,QAAQ,CAAC;AAC/B,CAAC,CAAC;AACF;AACAf,CAAC,CAACI,MAAM,CAAC;EACPC,IAAI,EAAEK,YAAY,CAACM,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC;EACzCF,OAAO,EAAEd,CAAC,CAACM,MAAM,CAAC,CAAC,CAACS,QAAQ,CAAC,CAAC;EAC9BE,YAAY,EAAEjB,CAAC,CAACS,MAAM,CAAC;AACzB,CAAC,CAAC,CACH,CAAC;AAIF;AACA;AACA;AACA;AACA,OAAO,MAAMS,0BAA0B,GAAGlB,CAAC,CAACI,MAAM,CAAC;EACjDe,GAAG,EAAEnB,CAAC,CAACM,MAAM,CAAC,CAAC;EACfc,SAAS,EAAEpB,CAAC,CAACM,MAAM,CAAC,CAAC;EACrBe,GAAG,EAAErB,CAAC,CAACM,MAAM,CAAC,CAAC;EACfgB,eAAe,EAAEtB,CAAC,CAACM,MAAM,CAAC;AAC5B,CAAC,CAAC;AAIF;AACA;AACA;AACA,OAAO,MAAMiB,aAAa,GAAGvB,CAAC,CAACI,MAAM,CAAC;EACpCoB,IAAI,EAAExB,CAAC,CAACM,MAAM,CAAC,CAAC;EAChBmB,MAAM,EAAEzB,CAAC,CAACM,MAAM,CAAC;AACnB,CAAC,CAAC;;AAIF;AACA;AACA;;AASA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["z","AlertMessageKey","enum","NfcEvent","object","name","string","progress","coerce","number","NfcErrorName","NfcError","union","exclude","message","optional","extract","attemptsLeft","InternalAuthResponseObject","nis","publicKey","sod","signedChallenge","MrtdResponseObject","dg1","dg11","InternalAuthAndMrtdResponse","nis_data","mrtd_data","CieAttributes","type","base64"],"sourceRoot":"../../../src","sources":["manager/types.ts"],"mappings":"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","ignoreList":[]}

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

@@ -1,6 +1,6 @@
 import * as CieUtils from './utils';
 import * as CieManager from './manager';
 export { CieUtils, CieManager };
-export type { NfcEvent, NfcError, CieAttributes, CieEventHandlers, CieEvent, } from './manager/types';
+export type { NfcEvent, NfcError, CieAttributes, CieEventHandlers, CieEvent, InternalAuthResponse, MrtdResponse, InternalAuthAndMrtdResponse, ResultEncoding, } from './manager/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,GACT,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;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"}

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

@@ -1,4 +1,4 @@
-import { AlertMessageKey, type CieEvent, type CieEventHandlers } from './types';
+import { AlertMessageKey, type CieEvent, type CieEventHandlers, type ResultEncoding } from './types';
 /**
  * Adds a listener for a specific CIE event.
  *
@@ -71,11 +71,102 @@ export declare const setCurrentAlertMessage: (value: string) => void;
  * Initiates the internal authentication process using the provided challenge and timeout.
  *
  * @param challenge - The challenge string to be used for authentication.
- * @param resultEncoding - The encoding of the result byte arrays, either 'base64' or 'hex' (default: 'base64')
+ * @param resultEncoding - The encoding of the result byte arrays, either 'base64', 'base64url' or 'hex' (default: 'base64')
  * @param timeout - Optional timeout in milliseconds (default: 10000) (**Note**: Android only)
  * @returns A promise that resolves when the authentication process has ended.
  */
-declare const startInternalAuthentication: (challenge: string, resultEncoding?: "base64" | "hex", timeout?: number) => Promise<void>;
+declare const startInternalAuthentication: (challenge: string, resultEncoding?: ResultEncoding, timeout?: number) => Promise<void>;
+/**
+ * Initiates a PACE (Password Authenticated Connection Establishment) reading
+ * session on a CIE (Carta d'Identità Elettronica) using the provided CAN (Card
+ * Access Number) to read the MRTD information.
+ *
+ * The operation is asynchronous; Since the Promise resolves
+ * with `void`, any resulting data or errors are expected to be surfaced through
+ * native events.
+ *
+ * @param can The 6‑digit Card Access Number printed on the CIE, used to
+ *            bootstrap the PACE secure messaging protocol. Must be a numeric
+ *            string; validation (if any) occurs in the native layer.
+ * @param resultEncoding The encoding format expected for any binary payloads
+ *                       produced during the reading process. Defaults to
+ *                       `'base64'`. Use `'hex'` if downstream consumers require
+ *                       hexadecimal representation.
+ * @param timeout Maximum time (in milliseconds) allowed for the PACE reading
+ *                session before it is aborted. Defaults to `DEFAULT_TIMEOUT`.
+ *                A larger value may be required on older devices or in
+ *                environments with slower NFC interactions.
+ *
+ * @returns Promise that resolves when the reading process has started.
+ *
+ * @throws May reject with:
+ * - Invalid input (e.g., malformed CAN).
+ * - NFC subsystem unavailable or disabled.
+ * - Operation timeout exceeded.
+ * - Native module internal errors.
+ *
+ * @example
+ * await startPaceReading("123456"); // Uses base64 encoding and default timeout.
+ *
+ * @example
+ * await startPaceReading("654321", "hex", 15000);
+ *
+ * @remarks
+ * Ensure NFC is enabled and the user has positioned the CIE correctly before
+ * calling this function to minimize timeouts and improve reliability.
+ *
+ * Once the MRTD reading with PACE flow has been initiated, a Promise resolves,
+ * while when the reading process produces data, the `'onSuccess'` event has been called.
+ * The `'onError'` event is called if an error occurs during the reading process.
+ * The `'onEvent'` event is called to provide progress updates.
+ */
+declare const startMRTDReading: (can: string, resultEncoding?: ResultEncoding, timeout?: number) => Promise<void>;
+/**
+ * Initiates a combined reading session on a CIE (Carta d'Identità Elettronica)
+ * that performs both Internal Authentication and MRTD reading using PACE.
+ *
+ * The operation is asynchronous; Since the Promise resolves
+ * with `void`, any resulting data or errors are expected to be surfaced through
+ * native events.
+ *
+ * @param can The 6‑digit Card Access Number printed on the CIE, used to
+ *            bootstrap the PACE secure messaging protocol. Must be a numeric
+ *            string; validation (if any) occurs in the native layer.
+ * @param challenge The challenge string to be used for Internal Authentication.
+ * @param resultEncoding The encoding format expected for any binary payloads
+ *                       produced during the reading process. Defaults to
+ *                       `'base64'`. Use `'hex'` if downstream consumers require
+ *                       hexadecimal representation.
+ * @param timeout Maximum time (in milliseconds) allowed for the combined reading
+ *                session before it is aborted. Defaults to `DEFAULT_TIMEOUT`.
+ *                A larger value may be required on older devices or in
+ *                environments with slower NFC interactions.
+ *
+ * @returns Promise that resolves when the reading process has started.
+ *
+ * @throws May reject with:
+ * - Invalid input (e.g., malformed CAN or challenge).
+ * - NFC subsystem unavailable or disabled.
+ * - Operation timeout exceeded.
+ * - Native module internal errors.
+ *
+ * @example
+ * await startInternalAuthAndMRTDReading("123456", "challengeString");
+ *
+ * @example
+ * await startInternalAuthAndMRTDReading("654321", "challengeString", "hex", 15000);
+ *
+ * @remarks
+ * Ensure NFC is enabled and the user has positioned the CIE correctly before
+ * calling this function to minimize timeouts and improve reliability.
+ *
+ * Once the Internal Authentication and MRTD reading with PACE flow has been initiated,
+ * a Promise resolves, while when the reading process produces data,
+ * the `'onSuccess'` event has been called.
+ * The `'onError'` event is called if an error occurs during the reading process.
+ * The `'onEvent'` event is called to provide progress updates.
+ */
+declare const startInternalAuthAndMRTDReading: (can: string, challenge: string, resultEncoding?: ResultEncoding, timeout?: number) => Promise<void>;
 /**
  * Starts the process of reading attributes from the CIE card.
  *
@@ -119,5 +210,5 @@ declare const startReading: (pin: string, authenticationUrl: string, timeout?: n
  * ```
  */
 declare const stopReading: () => Promise<void>;
-export { addListener, removeListener, removeAllListeners, setCustomIdpUrl, startReadingAttributes, startInternalAuthentication, startReading, stopReading, };
+export { addListener, removeListener, removeAllListeners, setCustomIdpUrl, startReadingAttributes, startInternalAuthentication, startMRTDReading, startInternalAuthAndMRTDReading, startReading, stopReading, };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/manager/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAOhF;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,WAAW,GAAI,CAAC,SAAS,QAAQ,EACrC,OAAO,CAAC,EACR,UAAU,gBAAgB,CAAC,CAAC,CAAC,eAI9B,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,cAAc,GAAI,OAAO,QAAQ,SAEtC,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,kBAAkB,YAKvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,eAAe,GAAI,KAAK,MAAM,GAAG,SAAS,SAE/C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,eAAe,EAAE,OAAO,MAAM,SAElE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,SAEnD,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,2BAA2B,GAC/B,WAAW,MAAM,EACjB,iBAAgB,QAAQ,GAAG,KAAgB,EAC3C,UAAS,MAAwB,KAChC,OAAO,CAAC,IAAI,CAMd,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,sBAAsB,GAC1B,UAAS,MAAwB,KAChC,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,YAAY,GAChB,KAAK,MAAM,EACX,mBAAmB,MAAM,EACzB,UAAS,MAAwB,KAChC,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,WAAW,QAAa,OAAO,CAAC,IAAI,CAEzC,CAAC;AAEF,OAAO,EACL,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,YAAY,EACZ,WAAW,GACZ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/manager/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAOjB;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,WAAW,GAAI,CAAC,SAAS,QAAQ,EACrC,OAAO,CAAC,EACR,UAAU,gBAAgB,CAAC,CAAC,CAAC,eAI9B,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,cAAc,GAAI,OAAO,QAAQ,SAEtC,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,kBAAkB,YAKvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,eAAe,GAAI,KAAK,MAAM,GAAG,SAAS,SAE/C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,eAAe,EAAE,OAAO,MAAM,SAElE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,SAEnD,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,2BAA2B,GAC/B,WAAW,MAAM,EACjB,iBAAgB,cAAyB,EACzC,UAAS,MAAwB,KAChC,OAAO,CAAC,IAAI,CAMd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,QAAA,MAAM,gBAAgB,GACpB,KAAK,MAAM,EACX,iBAAgB,cAAyB,EACzC,UAAS,MAAwB,KAChC,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,QAAA,MAAM,+BAA+B,GACnC,KAAK,MAAM,EACX,WAAW,MAAM,EACjB,iBAAgB,cAAyB,EACzC,UAAS,MAAwB,KAChC,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,sBAAsB,GAC1B,UAAS,MAAwB,KAChC,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,YAAY,GAChB,KAAK,MAAM,EACX,mBAAmB,MAAM,EACzB,UAAS,MAAwB,KAChC,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,WAAW,QAAa,OAAO,CAAC,IAAI,CAEzC,CAAC;AAEF,OAAO,EACL,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,gBAAgB,EAChB,+BAA+B,EAC/B,YAAY,EACZ,WAAW,GACZ,CAAC"}

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

@@ -53,8 +53,8 @@ export declare const NfcError: z.ZodUnion<[z.ZodObject<{
 }>]>;
 export type NfcError = z.infer<typeof NfcError>;
 /**
- * Represent the CIE attributes containing the CIE type
- * All string value are Hex encoded
+ * Represent the CIE response coming from NIS Internal Auth
+ * All string value are Hex or Base64 encoded
  */
 export declare const InternalAuthResponseObject: z.ZodObject<{
     nis: z.ZodString;
@@ -73,6 +73,85 @@ export declare const InternalAuthResponseObject: z.ZodObject<{
     signedChallenge: string;
 }>;
 export type InternalAuthResponse = z.infer<typeof InternalAuthResponseObject>;
+/**
+ * Represent the CIE response coming from MRTD with PACE reading
+ * All string value are Hex or Base64 encoded
+ */
+export declare const MrtdResponseObject: z.ZodObject<{
+    dg1: z.ZodString;
+    dg11: z.ZodString;
+    sod: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    sod: string;
+    dg1: string;
+    dg11: string;
+}, {
+    sod: string;
+    dg1: string;
+    dg11: string;
+}>;
+export type MrtdResponse = z.infer<typeof MrtdResponseObject>;
+/**
+ * Represent the CIE response coming from NIS Internal Auth
+ * and MRTD with PACE reading during the same NFC session.
+ * All string value are Hex or Base64 encoded
+ */
+export declare const InternalAuthAndMrtdResponse: z.ZodObject<{
+    nis_data: z.ZodObject<{
+        nis: z.ZodString;
+        publicKey: z.ZodString;
+        sod: z.ZodString;
+        signedChallenge: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        nis: string;
+        publicKey: string;
+        sod: string;
+        signedChallenge: string;
+    }, {
+        nis: string;
+        publicKey: string;
+        sod: string;
+        signedChallenge: string;
+    }>;
+    mrtd_data: z.ZodObject<{
+        dg1: z.ZodString;
+        dg11: z.ZodString;
+        sod: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        sod: string;
+        dg1: string;
+        dg11: string;
+    }, {
+        sod: string;
+        dg1: string;
+        dg11: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    nis_data: {
+        nis: string;
+        publicKey: string;
+        sod: string;
+        signedChallenge: string;
+    };
+    mrtd_data: {
+        sod: string;
+        dg1: string;
+        dg11: string;
+    };
+}, {
+    nis_data: {
+        nis: string;
+        publicKey: string;
+        sod: string;
+        signedChallenge: string;
+    };
+    mrtd_data: {
+        sod: string;
+        dg1: string;
+        dg11: string;
+    };
+}>;
+export type InternalAuthAndMrtdResponse = z.infer<typeof InternalAuthAndMrtdResponse>;
 /**
  * Represent the CIE attributes containing the CIE type
  */
@@ -87,13 +166,19 @@ export declare const CieAttributes: z.ZodObject<{
     base64: string;
 }>;
 export type CieAttributes = z.infer<typeof CieAttributes>;
+/**
+ * Possible encodings for the CIE reading results
+ */
+export type ResultEncoding = 'hex' | 'base64' | 'base64url';
 /**
  * Event handler that can be used to handle the CIE events during the reading process
  */
 export type CieEventHandlers = {
     onEvent: (event: NfcEvent) => void;
     onError: (error: NfcError) => void;
-    onInternalAuthenticationSuccess: (attributes: InternalAuthResponse) => void;
+    onInternalAuthenticationSuccess: (internalAuthResponse: InternalAuthResponse) => void;
+    onMRTDWithPaceSuccess: (mrtdResponse: MrtdResponse) => void;
+    onInternalAuthAndMRTDWithPaceSuccess: (internalAuthAndMrtdResponse: InternalAuthAndMrtdResponse) => void;
     onAttributesSuccess: (attributes: CieAttributes) => void;
     onSuccess: (uri: string) => void;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/manager/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,eAAe,+LAW1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;EAGnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,YAAY,uNAYvB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;IAWnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,+BAA+B,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC5E,mBAAmB,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;IACzD,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/manager/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,eAAe,+LAW1B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;EAGnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,YAAY,uNAYvB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;IAWnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYtC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAC/C,OAAO,2BAA2B,CACnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;EAGxB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnC,+BAA+B,EAAE,CAC/B,oBAAoB,EAAE,oBAAoB,KACvC,IAAI,CAAC;IACV,qBAAqB,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5D,oCAAoC,EAAE,CACpC,2BAA2B,EAAE,2BAA2B,KACrD,IAAI,CAAC;IACV,mBAAmB,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;IACzD,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC"}

package/package.json

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

package/src/index.ts

@@ -9,6 +9,10 @@ export type {
   CieAttributes,
   CieEventHandlers,
   CieEvent,
+  InternalAuthResponse,
+  MrtdResponse,
+  InternalAuthAndMrtdResponse,
+  ResultEncoding,
 } from './manager/types';
 
 export type { CieErrorSchema, CieError, CieErrorCodes } from './errors';

package/src/manager/index.ts

@@ -1,6 +1,11 @@
 import { NativeEventEmitter } from 'react-native';
 import { IoReactNativeCie } from '../native';
-import { AlertMessageKey, type CieEvent, type CieEventHandlers } from './types';
+import {
+  AlertMessageKey,
+  type CieEvent,
+  type CieEventHandlers,
+  type ResultEncoding,
+} from './types';
 import { getDefaultIdpUrl } from './utils';
 
 const DEFAULT_TIMEOUT = 10000;
@@ -104,13 +109,13 @@ export const setCurrentAlertMessage = (value: string) => {
  * Initiates the internal authentication process using the provided challenge and timeout.
  *
  * @param challenge - The challenge string to be used for authentication.
- * @param resultEncoding - The encoding of the result byte arrays, either 'base64' or 'hex' (default: 'base64')
+ * @param resultEncoding - The encoding of the result byte arrays, either 'base64', 'base64url' or 'hex' (default: 'base64')
  * @param timeout - Optional timeout in milliseconds (default: 10000) (**Note**: Android only)
  * @returns A promise that resolves when the authentication process has ended.
  */
 const startInternalAuthentication = async (
   challenge: string,
-  resultEncoding: 'base64' | 'hex' = 'base64',
+  resultEncoding: ResultEncoding = 'base64',
   timeout: number = DEFAULT_TIMEOUT
 ): Promise<void> => {
   return IoReactNativeCie.startInternalAuthentication(
@@ -120,6 +125,117 @@ const startInternalAuthentication = async (
   );
 };
 
+/**
+ * Initiates a PACE (Password Authenticated Connection Establishment) reading
+ * session on a CIE (Carta d'Identità Elettronica) using the provided CAN (Card
+ * Access Number) to read the MRTD information.
+ *
+ * The operation is asynchronous; Since the Promise resolves
+ * with `void`, any resulting data or errors are expected to be surfaced through
+ * native events.
+ *
+ * @param can The 6‑digit Card Access Number printed on the CIE, used to
+ *            bootstrap the PACE secure messaging protocol. Must be a numeric
+ *            string; validation (if any) occurs in the native layer.
+ * @param resultEncoding The encoding format expected for any binary payloads
+ *                       produced during the reading process. Defaults to
+ *                       `'base64'`. Use `'hex'` if downstream consumers require
+ *                       hexadecimal representation.
+ * @param timeout Maximum time (in milliseconds) allowed for the PACE reading
+ *                session before it is aborted. Defaults to `DEFAULT_TIMEOUT`.
+ *                A larger value may be required on older devices or in
+ *                environments with slower NFC interactions.
+ *
+ * @returns Promise that resolves when the reading process has started.
+ *
+ * @throws May reject with:
+ * - Invalid input (e.g., malformed CAN).
+ * - NFC subsystem unavailable or disabled.
+ * - Operation timeout exceeded.
+ * - Native module internal errors.
+ *
+ * @example
+ * await startPaceReading("123456"); // Uses base64 encoding and default timeout.
+ *
+ * @example
+ * await startPaceReading("654321", "hex", 15000);
+ *
+ * @remarks
+ * Ensure NFC is enabled and the user has positioned the CIE correctly before
+ * calling this function to minimize timeouts and improve reliability.
+ *
+ * Once the MRTD reading with PACE flow has been initiated, a Promise resolves,
+ * while when the reading process produces data, the `'onSuccess'` event has been called.
+ * The `'onError'` event is called if an error occurs during the reading process.
+ * The `'onEvent'` event is called to provide progress updates.
+ */
+const startMRTDReading = async (
+  can: string,
+  resultEncoding: ResultEncoding = 'base64',
+  timeout: number = DEFAULT_TIMEOUT
+): Promise<void> => {
+  return IoReactNativeCie.startMRTDReading(can, resultEncoding, timeout);
+};
+
+/**
+ * Initiates a combined reading session on a CIE (Carta d'Identità Elettronica)
+ * that performs both Internal Authentication and MRTD reading using PACE.
+ *
+ * The operation is asynchronous; Since the Promise resolves
+ * with `void`, any resulting data or errors are expected to be surfaced through
+ * native events.
+ *
+ * @param can The 6‑digit Card Access Number printed on the CIE, used to
+ *            bootstrap the PACE secure messaging protocol. Must be a numeric
+ *            string; validation (if any) occurs in the native layer.
+ * @param challenge The challenge string to be used for Internal Authentication.
+ * @param resultEncoding The encoding format expected for any binary payloads
+ *                       produced during the reading process. Defaults to
+ *                       `'base64'`. Use `'hex'` if downstream consumers require
+ *                       hexadecimal representation.
+ * @param timeout Maximum time (in milliseconds) allowed for the combined reading
+ *                session before it is aborted. Defaults to `DEFAULT_TIMEOUT`.
+ *                A larger value may be required on older devices or in
+ *                environments with slower NFC interactions.
+ *
+ * @returns Promise that resolves when the reading process has started.
+ *
+ * @throws May reject with:
+ * - Invalid input (e.g., malformed CAN or challenge).
+ * - NFC subsystem unavailable or disabled.
+ * - Operation timeout exceeded.
+ * - Native module internal errors.
+ *
+ * @example
+ * await startInternalAuthAndMRTDReading("123456", "challengeString");
+ *
+ * @example
+ * await startInternalAuthAndMRTDReading("654321", "challengeString", "hex", 15000);
+ *
+ * @remarks
+ * Ensure NFC is enabled and the user has positioned the CIE correctly before
+ * calling this function to minimize timeouts and improve reliability.
+ *
+ * Once the Internal Authentication and MRTD reading with PACE flow has been initiated,
+ * a Promise resolves, while when the reading process produces data,
+ * the `'onSuccess'` event has been called.
+ * The `'onError'` event is called if an error occurs during the reading process.
+ * The `'onEvent'` event is called to provide progress updates.
+ */
+const startInternalAuthAndMRTDReading = async (
+  can: string,
+  challenge: string,
+  resultEncoding: ResultEncoding = 'base64',
+  timeout: number = DEFAULT_TIMEOUT
+): Promise<void> => {
+  return IoReactNativeCie.startInternalAuthAndMRTDReading(
+    can,
+    challenge,
+    resultEncoding,
+    timeout
+  );
+};
+
 /**
  * Starts the process of reading attributes from the CIE card.
  *
@@ -185,6 +301,8 @@ export {
   setCustomIdpUrl,
   startReadingAttributes,
   startInternalAuthentication,
+  startMRTDReading,
+  startInternalAuthAndMRTDReading,
   startReading,
   stopReading,
 };