@pagopa/io-react-native-cie 1.0.0

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

@@ -0,0 +1,113 @@
+import { AlertMessageKey, type CieEvent, type CieEventHandlers } from './types';
+/**
+ * Adds a listener for a specific CIE event.
+ *
+ * @param event - The event to listen to {@see CieEvent}
+ * @param listener - The listener to add {@see CieEventHandler}
+ * @returns Function to remove the listener
+ * @example
+ * ```typescript
+ * const removeListener = CieManager.addListener('onEvent', event => {
+ *   console.log(event.name, event.progress);
+ * });
+ * // ...
+ * removeListener();
+ */
+declare const addListener: <E extends CieEvent>(event: E, listener: CieEventHandlers[E]) => () => void;
+/**
+ * Removes a listener for a specific CIE event.
+ *
+ * @param event - The event to remove the listener from {@see CieEvent}
+ */
+declare const removeListener: (event: CieEvent) => void;
+/**
+ * Removes all registered event, error, and success listeners for CIE operations.
+ *
+ * @example
+ * ```typescript
+ * CieManager.removeAllListeners();
+ * ```
+ */
+declare const removeAllListeners: () => void;
+/**
+ * Sets a custom Identity Provider (IDP) URL for authentication.
+ * If not set, will be used the default IDP URL:
+ * https://idserver.servizicie.interno.gov.it/idp/
+ *
+ * @param url - The custom IDP URL to use
+ * @example
+ * ```typescript
+ * CieManager.setCustomIdpUrl('https://custom.idp.com/auth');
+ * ```
+ */
+declare const setCustomIdpUrl: (url: string) => any;
+/**
+ * Sets an alert message for the CIE reading process.
+ *
+ * **Note**: Alert messages are only available on iOS
+ *
+ * @param key - The key of the alert message to set
+ * @param value - The value of the alert message to set
+ * @example
+ * ```typescript
+ * CieManager.setAlertMessage('readingInstructions', 'Please scan your CIE card');
+ * ```
+ */
+export declare const setAlertMessage: (key: AlertMessageKey, value: string) => any;
+/**
+ * Updates the current displayed alert message for the CIE reading process.
+ *
+ * **Note**: Alert messages are only available on iOS
+ *
+ * @param value - The value of the alert message to set
+ * @example
+ * ```typescript
+ * CieManager.setCurrentAlertMessage('Please scan your CIE card');
+ * ```
+ */
+export declare const setCurrentAlertMessage: (value: string) => any;
+/**
+ * Starts the process of reading attributes from the CIE card.
+ *
+ * @param timeout - Optional timeout in milliseconds (default: 10000) (**Note**: Android only)
+ * @returns Promise<void>
+ * @throws {CieError} If reading attributes fails
+ * @example
+ * ```typescript
+ * await CieManager.startReadingAttributes();
+ * // or with custom timeout
+ * await CieManager.startReadingAttributes(15000);
+ * ```
+ */
+declare const startReadingAttributes: (timeout?: number) => Promise<void>;
+/**
+ * Starts the CIE reading and authentication process.
+ *
+ * @param pin - The CIE card PIN code
+ * @param authenticationUrl - The authentication service URL
+ * @param timeout - Optional timeout in milliseconds (default: 10000) (**Note**: Android only)
+ * @returns Promise<void>
+ * @throws {CieError} If could not start reading for authentication
+ * @example
+ * ```typescript
+ * await CieManager.startReading('12345678', 'https://idserver.example.com/auth');
+ * // or with custom timeout
+ * await CieManager.startReading('12345678', 'https://idserver.example.com/auth', 20000);
+ * ```
+ */
+declare const startReading: (pin: string, authenticationUrl: string, timeout?: number) => Promise<void>;
+/**
+ * Stops any ongoing CIE reading process.
+ *
+ * **Note:** Android only. On iOS the reading process is stopped by closing
+ * the system NFC overlay
+ *
+ * @returns Promise<void>
+ * @example
+ * ```typescript
+ * await CieManager.stopReading();
+ * ```
+ */
+declare const stopReading: () => Promise<void>;
+export { addListener, removeListener, removeAllListeners, setCustomIdpUrl, startReadingAttributes, startReading, stopReading, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;AAMhF;;;;;;;;;;;;;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;;;;;;;;;;GAUG;AACH,QAAA,MAAM,eAAe,GAAI,KAAK,MAAM,QAEnC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,eAAe,EAAE,OAAO,MAAM,QAElE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,QAEnD,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,YAAY,EACZ,WAAW,GACZ,CAAC"}

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

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+/**
+ * Represent the key of the alert message that can be set during the CIE reading process
+ *
+ * **Note**: Alert messages are only available on iOS
+ */
+export declare const AlertMessageKey: z.ZodEnum<["readingInstructions", "moreTags", "readingInProgress", "readingSuccess", "invalidCard", "tagLost", "cardLocked", "wrongPin1AttemptLeft", "wrongPin2AttemptLeft", "genericError"]>;
+export type AlertMessageKey = z.infer<typeof AlertMessageKey>;
+/**
+ * Event emitted during the CIE reading process with the name of the event and the progress of the reading up to that point.
+ * Event names may differ based on the platform.
+ */
+export declare const NfcEvent: z.ZodObject<{
+    name: z.ZodString;
+    progress: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    progress: number;
+}, {
+    name: string;
+    progress: number;
+}>;
+export type NfcEvent = z.infer<typeof NfcEvent>;
+/**
+ * Name of the error emitted during the CIE reading process
+ */
+export declare const NfcErrorName: z.ZodEnum<["NOT_A_CIE", "TAG_LOST", "CANCELLED_BY_USER", "APDU_ERROR", "WRONG_PIN", "CARD_BLOCKED", "NO_INTERNET_CONNECTION", "CERTIFICATE_EXPIRED", "CERTIFICATE_REVOKED", "AUTHENTICATION_ERROR", "GENERIC_ERROR"]>;
+export type NfcErrorName = z.infer<typeof NfcErrorName>;
+/**
+ * Represent an NFC error emitted during the CIE reading process
+ * It contains the name of the error, the message and the number of attempts
+ */
+export declare const NfcError: z.ZodUnion<[z.ZodObject<{
+    name: z.ZodEnum<["NOT_A_CIE", "TAG_LOST", "CANCELLED_BY_USER", "APDU_ERROR", "WRONG_PIN", "CARD_BLOCKED", "NO_INTERNET_CONNECTION", "CERTIFICATE_EXPIRED", "CERTIFICATE_REVOKED", "AUTHENTICATION_ERROR", "GENERIC_ERROR"]>;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: "NOT_A_CIE" | "TAG_LOST" | "CANCELLED_BY_USER" | "APDU_ERROR" | "WRONG_PIN" | "CARD_BLOCKED" | "NO_INTERNET_CONNECTION" | "CERTIFICATE_EXPIRED" | "CERTIFICATE_REVOKED" | "AUTHENTICATION_ERROR" | "GENERIC_ERROR";
+    message?: string | undefined;
+}, {
+    name: "NOT_A_CIE" | "TAG_LOST" | "CANCELLED_BY_USER" | "APDU_ERROR" | "WRONG_PIN" | "CARD_BLOCKED" | "NO_INTERNET_CONNECTION" | "CERTIFICATE_EXPIRED" | "CERTIFICATE_REVOKED" | "AUTHENTICATION_ERROR" | "GENERIC_ERROR";
+    message?: string | undefined;
+}>, z.ZodObject<{
+    name: z.ZodLiteral<"WRONG_PIN">;
+    message: z.ZodOptional<z.ZodString>;
+    attempts: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: "WRONG_PIN";
+    attempts: number;
+    message?: string | undefined;
+}, {
+    name: "WRONG_PIN";
+    attempts: number;
+    message?: string | undefined;
+}>]>;
+export type NfcError = z.infer<typeof NfcError>;
+/**
+ * Represent the CIE attributes containing the CIE type
+ */
+export declare const CieAttributes: z.ZodObject<{
+    type: z.ZodString;
+    base64: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    base64: string;
+}, {
+    type: string;
+    base64: string;
+}>;
+export type CieAttributes = z.infer<typeof CieAttributes>;
+/**
+ * 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;
+    onAttributesSuccess: (attributes: CieAttributes) => void;
+    onSuccess: (uri: string) => void;
+};
+/**
+ * Possible events that can be listened to
+ */
+export type CieEvent = keyof CieEventHandlers;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;IAUnB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;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,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/lib/typescript/src/native.d.ts

@@ -0,0 +1,2 @@
+export declare const IoReactNativeCie: any;
+//# sourceMappingURL=native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../src/native.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,gBAAgB,KASxB,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * Checks if the device has NFC hardware capabilities.
+ *
+ * On iOS the NFC features is always available.
+ *
+ * @returns A promise that resolves to true if the device supports NFC, false otherwise.
+ * @throws {CieError} If cannot check if NFC is available.
+ */
+export declare const hasNfcFeature: () => Promise<any>;
+/**
+ * Checks if NFC is currently enabled on the device.
+ *
+ * On iOS the NFC features is always enabled.
+ *
+ * @returns A promise that resolves to true if NFC is enabled, false otherwise.
+ * @throws {CieError} If cannot check if NFC is enabled.
+ */
+export declare const isNfcEnabled: () => Promise<any>;
+/**
+ * Verifies if the device supports CIE (Electronic Identity Card) authentication.
+ * @returns A promise that resolves to true if CIE authentication is supported, false otherwise.
+ */
+export declare const isCieAuthenticationSupported: () => Promise<any>;
+/**
+ * Opens the device's NFC settings page, allowing users to enable or disable NFC.
+ * @returns A promise that resolves when the settings page is opened.
+ * @throws {CieError} If cannot open the settings page.
+ */
+export declare const openNfcSettings: () => Promise<any>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,oBAEzB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,oBAExB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,oBAExC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,oBAE3B,CAAC"}

package/package.json

@@ -0,0 +1,158 @@
+{
+  "name": "@pagopa/io-react-native-cie",
+  "version": "1.0.0",
+  "description": "Native support for CIE",
+  "source": "./src/index.ts",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace @pagopa/io-react-native-cie-example",
+    "test": "jest",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "release": "release-it"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pagopa/io-react-native-cie.git"
+  },
+  "author": "PagoPa (https://github.com/pagopa)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pagopa/io-react-native-cie/issues"
+  },
+  "homepage": "https://github.com/pagopa/io-react-native-cie#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.6.0",
+    "@eslint/compat": "^1.2.7",
+    "@eslint/eslintrc": "^3.3.0",
+    "@eslint/js": "^9.22.0",
+    "@evilmartians/lefthook": "^1.5.0",
+    "@react-native/eslint-config": "^0.78.0",
+    "@release-it/conventional-changelog": "^9.0.2",
+    "@types/jest": "^29.5.5",
+    "@types/react": "^19.0.0",
+    "commitlint": "^19.6.1",
+    "del-cli": "^5.1.0",
+    "eslint": "^9.22.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-eslint-comments": "^3.2.0",
+    "eslint-plugin-prettier": "^5.2.3",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.3",
+    "react": "19.0.0",
+    "react-native": "0.78.2",
+    "react-native-builder-bob": "^0.40.6",
+    "release-it": "^17.10.0",
+    "turbo": "^1.10.7",
+    "typescript": "^5.2.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@3.6.1",
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "create-react-native-library": {
+    "type": "legacy-module",
+    "languages": "kotlin-swift",
+    "version": "0.49.8"
+  },
+  "dependencies": {
+    "zod": "^3.24.4"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,32 @@
+/**
+ * Error codes returned by the iOS module.
+ */
+type CieErrorCodesIOS =
+  | 'PIN_REGEX_NOT_VALID'
+  | 'INVALID_AUTH_URL'
+  | 'THREADING_ERROR'
+  | 'UNKNOWN_EXCEPTION';
+
+/**
+ * Error codes returned by the Android side.
+ */
+type CieErrorCodesAndroid =
+  | 'PIN_REGEX_NOT_VALID'
+  | 'INVALID_AUTH_URL'
+  | 'UNKNOWN_EXCEPTION';
+
+/**
+ * All error codes that the module could return.
+ */
+export type CieErrorCodes = CieErrorCodesAndroid | CieErrorCodesIOS;
+
+/**
+ * Error type returned by a rejected promise.
+ *
+ * If additional error information are available,
+ * they are stored in the {@link CieError["userInfo"]} field.
+ */
+export type CieError = {
+  message: CieErrorCodes;
+  userInfo: Record<string, string>;
+};

package/src/index.ts

@@ -0,0 +1,14 @@
+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 { CieError, CieErrorCodes } from './errors';

package/src/manager/index.ts

@@ -0,0 +1,167 @@
+import { NativeEventEmitter, NativeModules } from 'react-native';
+import { IoReactNativeCie } from '../native';
+import { AlertMessageKey, type CieEvent, type CieEventHandlers } from './types';
+
+const DEFAULT_TIMEOUT = 10000;
+
+const eventEmitter = new NativeEventEmitter(NativeModules.IoReactNativeCie);
+
+/**
+ * Adds a listener for a specific CIE event.
+ *
+ * @param event - The event to listen to {@see CieEvent}
+ * @param listener - The listener to add {@see CieEventHandler}
+ * @returns Function to remove the listener
+ * @example
+ * ```typescript
+ * const removeListener = CieManager.addListener('onEvent', event => {
+ *   console.log(event.name, event.progress);
+ * });
+ * // ...
+ * removeListener();
+ */
+const addListener = <E extends CieEvent>(
+  event: E,
+  listener: CieEventHandlers[E]
+) => {
+  const subscription = eventEmitter.addListener(event, listener);
+  return subscription.remove;
+};
+
+/**
+ * Removes a listener for a specific CIE event.
+ *
+ * @param event - The event to remove the listener from {@see CieEvent}
+ */
+const removeListener = (event: CieEvent) => {
+  eventEmitter.removeAllListeners(event);
+};
+
+/**
+ * Removes all registered event, error, and success listeners for CIE operations.
+ *
+ * @example
+ * ```typescript
+ * CieManager.removeAllListeners();
+ * ```
+ */
+const removeAllListeners = () => {
+  eventEmitter.removeAllListeners('onEvent');
+  eventEmitter.removeAllListeners('onError');
+  eventEmitter.removeAllListeners('onAttributesSuccess');
+  eventEmitter.removeAllListeners('onSuccess');
+};
+
+/**
+ * Sets a custom Identity Provider (IDP) URL for authentication.
+ * If not set, will be used the default IDP URL:
+ * https://idserver.servizicie.interno.gov.it/idp/
+ *
+ * @param url - The custom IDP URL to use
+ * @example
+ * ```typescript
+ * CieManager.setCustomIdpUrl('https://custom.idp.com/auth');
+ * ```
+ */
+const setCustomIdpUrl = (url: string) => {
+  return IoReactNativeCie.setCustomIdpUrl(url);
+};
+
+/**
+ * Sets an alert message for the CIE reading process.
+ *
+ * **Note**: Alert messages are only available on iOS
+ *
+ * @param key - The key of the alert message to set
+ * @param value - The value of the alert message to set
+ * @example
+ * ```typescript
+ * CieManager.setAlertMessage('readingInstructions', 'Please scan your CIE card');
+ * ```
+ */
+export const setAlertMessage = (key: AlertMessageKey, value: string) => {
+  return IoReactNativeCie.setAlertMessage(key, value);
+};
+
+/**
+ * Updates the current displayed alert message for the CIE reading process.
+ *
+ * **Note**: Alert messages are only available on iOS
+ *
+ * @param value - The value of the alert message to set
+ * @example
+ * ```typescript
+ * CieManager.setCurrentAlertMessage('Please scan your CIE card');
+ * ```
+ */
+export const setCurrentAlertMessage = (value: string) => {
+  return IoReactNativeCie.setCurrentAlertMessage(value);
+};
+
+/**
+ * Starts the process of reading attributes from the CIE card.
+ *
+ * @param timeout - Optional timeout in milliseconds (default: 10000) (**Note**: Android only)
+ * @returns Promise<void>
+ * @throws {CieError} If reading attributes fails
+ * @example
+ * ```typescript
+ * await CieManager.startReadingAttributes();
+ * // or with custom timeout
+ * await CieManager.startReadingAttributes(15000);
+ * ```
+ */
+const startReadingAttributes = async (
+  timeout: number = DEFAULT_TIMEOUT
+): Promise<void> => {
+  return IoReactNativeCie.startReadingAttributes(timeout);
+};
+
+/**
+ * Starts the CIE reading and authentication process.
+ *
+ * @param pin - The CIE card PIN code
+ * @param authenticationUrl - The authentication service URL
+ * @param timeout - Optional timeout in milliseconds (default: 10000) (**Note**: Android only)
+ * @returns Promise<void>
+ * @throws {CieError} If could not start reading for authentication
+ * @example
+ * ```typescript
+ * await CieManager.startReading('12345678', 'https://idserver.example.com/auth');
+ * // or with custom timeout
+ * await CieManager.startReading('12345678', 'https://idserver.example.com/auth', 20000);
+ * ```
+ */
+const startReading = async (
+  pin: string,
+  authenticationUrl: string,
+  timeout: number = DEFAULT_TIMEOUT
+): Promise<void> => {
+  return IoReactNativeCie.startReading(pin, authenticationUrl, timeout);
+};
+
+/**
+ * Stops any ongoing CIE reading process.
+ *
+ * **Note:** Android only. On iOS the reading process is stopped by closing
+ * the system NFC overlay
+ *
+ * @returns Promise<void>
+ * @example
+ * ```typescript
+ * await CieManager.stopReading();
+ * ```
+ */
+const stopReading = async (): Promise<void> => {
+  return IoReactNativeCie.stopReading();
+};
+
+export {
+  addListener,
+  removeListener,
+  removeAllListeners,
+  setCustomIdpUrl,
+  startReadingAttributes,
+  startReading,
+  stopReading,
+};