react-native-rdservice 0.1.0 → 0.2.0

package/README.md

@@ -1,58 +1,112 @@
 # react-native-rdservice
 
-A React Native library for capturing biometric data (fingerprint and face) using RD (Registered Device) services on Android. This library integrates with UIDAI-compliant biometric devices for Aadhaar-based authentication and eKYC services.
+A React Native library for capturing **fingerprint**, **iris**, and **face** biometric data using UIDAI-compliant RD (Registered Device) services on Android. Built for Aadhaar-based authentication and eKYC workflows.
 
-## Installation
+[![npm version](https://img.shields.io/npm/v/react-native-rdservice.svg)](https://www.npmjs.com/package/react-native-rdservice)
+[![license](https://img.shields.io/npm/l/react-native-rdservice.svg)](LICENSE)
 
-```sh
-npm install react-native-rdservice
-```
+## Features
+
+- 🫆 Fingerprint capture via RD services (Mantra, Morpho, Startek, Precision, SecuGen, …)
+- 👁️ Iris capture via iris RD services
+- 🙂 Face capture via UIDAI Face RD
+- ℹ️ Device readiness check (`getDeviceInfo`)
+- Custom `PidOptions` XML support with sensible defaults
+- Promise-based API with full TypeScript definitions
+- New Architecture (TurboModule) — works with React Native 0.80+
+- Android 11+ package visibility (`<queries>`) handled automatically — no manifest changes needed in your app
 
-or
+## Platform support
+
+| Platform | Supported | Notes |
+|----------|-----------|-------|
+| Android  | ✅ | Requires an RD service app installed on the device |
+| iOS      | ⚠️ Graceful stub | UIDAI certifies RD services for **Android and Windows only**. There are no iOS RD service apps, so real capture is impossible on iOS. The module still loads on iOS and every method resolves with `{ status: 'FAILURE', message: '…not available on iOS…' }`, so cross-platform apps can share one code path without crashing. |
+
+## Requirements
+
+- React Native **0.80 or higher** with the New Architecture enabled (default since RN 0.76)
+- Android SDK 24+
+- The relevant RD service app installed on the device (see [package names](#common-rd-service-package-names))
+
+## Installation
 
 ```sh
+npm install react-native-rdservice
+# or
 yarn add react-native-rdservice
 ```
 
-## Features
+No extra Android setup is required. The library ships the required `<queries>` entries for Android 11+ package visibility; they are merged into your app's manifest automatically.
 
-- Fingerprint biometric capture using RD services
-- Face biometric capture using RD services
-- Support for custom PID options
-- TypeScript support with full type definitions
-- Promise-based API for easy async/await usage
+## Quick start
 
-## API Reference
+```typescript
+import { getFingerPrint } from 'react-native-rdservice';
+
+const result = await getFingerPrint('com.mantra.rdservice');
 
-### Types
+if (result.status === 'SUCCESS') {
+  // result.message is the signed PidData XML — send it to your backend as-is
+} else {
+  console.warn(result.message); // e.g. "Device not ready"
+}
+```
 
-#### `RdServiceResponse`
+## API Reference
 
-Response object returned by both fingerprint and face capture methods.
+All methods return `Promise<RdServiceResponse>`:
 
 ```typescript
 interface RdServiceResponse {
-  status: string;    // "SUCCESS" or "FAILURE"
-  message: string;   // XML data on success, error message on failure
+  status: string;  // 'SUCCESS' | 'FAILURE'
+  message: string; // signed XML on success, human-readable error on failure
 }
 ```
 
-### Methods
+`deviceName` is always the **package name of the RD service app** installed on the device. `pidOption` is an optional `PidOptions` XML string — when omitted (or blank), a sensible default is used.
+
+---
+
+### `getDeviceInfo(deviceName)`
+
+Checks whether the RD service and its device are ready (RD `INFO` call).
+
+```typescript
+import { getDeviceInfo } from 'react-native-rdservice';
+
+const info = await getDeviceInfo('com.mantra.rdservice');
+if (info.status === 'SUCCESS') {
+  // info.message contains the RDService info XML (device status, dpId, rdsId, …)
+}
+```
 
 ---
 
-#### `getFingerPrint(deviceName, pidOption)`
+### `getFingerPrint(deviceName, pidOption?)`
 
-Captures fingerprint biometric data using the specified RD service device.
+Captures fingerprint biometric data.
 
-**Parameters:**
+```typescript
+import { getFingerPrint } from 'react-native-rdservice';
+
+// Default options: single finger (fCount="1"), FMR format, 10s timeout, production env
+const result = await getFingerPrint('com.mantra.rdservice');
+
+// Custom PidOptions
+const custom = await getFingerPrint(
+  'com.precision.pb510.rdservice',
+  `<?xml version="1.0"?>
+   <PidOptions ver="1.0">
+     <Opts fCount="2" fType="2" iCount="0" pCount="0" format="0"
+           pidVer="2.0" timeout="15000" posh="UNKNOWN" env="P" />
+     <CustOpts><Param name="txnId" value="12345"/></CustOpts>
+   </PidOptions>`
+);
+```
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `deviceName` | `string` | Yes | Package name of the RD service app (e.g., `"com.mantra.rdservice"`, `"com.precision.pb510.rdservice"`) |
-| `pidOption` | `string` | No | XML string containing PID options. If empty or less than 10 characters, uses default configuration |
+Default `PidOptions`:
 
-**Default PID Options:**
 ```xml
 <?xml version="1.0"?>
 <PidOptions ver="1.0">
@@ -62,80 +116,48 @@ Captures fingerprint biometric data using the specified RD service device.
 </PidOptions>
 ```
 
-**Returns:** `Promise<RdServiceResponse>`
+---
 
-**Success Response:**
-```typescript
-{
-  status: "SUCCESS",
-  message: "<?xml version='1.0'?><PidData>...</PidData>" // Biometric XML data
-}
-```
+### `getIrisCapture(deviceName, pidOption?)`
+
+Captures iris biometric data.
 
-**Error Response:**
 ```typescript
-{
-  status: "FAILURE",
-  message: "Device not ready" | "Selected device not found" | "RD services not available"
+import { getIrisCapture } from 'react-native-rdservice';
+
+// Default options: single iris (iCount="1"), 10s timeout, production env
+const result = await getIrisCapture('com.mantra.mis100v2.rdservice');
+
+if (result.status === 'SUCCESS') {
+  // result.message contains the signed PidData XML with iris data
 }
 ```
 
-**Example:**
-
-```typescript
-import { getFingerPrint } from 'react-native-rdservice';
+Default `PidOptions`:
 
-// Using default PID options
-const captureFingerprint = async () => {
-  try {
-    const result = await getFingerPrint('com.mantra.rdservice', '');
-
-    if (result.status === 'SUCCESS') {
-      console.log('Fingerprint captured:', result.message);
-      // Process the biometric XML data
-      // result.message contains the PID XML with biometric information
-    } else {
-      console.error('Capture failed:', result.message);
-    }
-  } catch (error) {
-    console.error('Error:', error);
-  }
-};
-
-// Using custom PID options
-const captureFingerprintCustom = async () => {
-  const customPidOptions = `<?xml version="1.0"?>
-    <PidOptions ver="1.0">
-      <Opts fCount="2" fType="2" iCount="0" pCount="0" format="0"
-            pidVer="2.0" timeout="15000" posh="UNKNOWN" env="P" />
-      <CustOpts>
-        <Param name="txnId" value="12345"/>
-      </CustOpts>
-    </PidOptions>`;
-
-  const result = await getFingerPrint('com.precision.pb510.rdservice', customPidOptions);
-
-  if (result.status === 'SUCCESS') {
-    // Handle success
-    console.log('Biometric data:', result.message);
-  }
-};
+```xml
+<?xml version="1.0"?>
+<PidOptions ver="1.0">
+  <Opts fCount="0" fType="0" iCount="1" iType="0" pCount="0" pType="0"
+        format="0" pidVer="2.0" timeout="10000" posh="UNKNOWN" env="P" />
+  <CustOpts></CustOpts>
+</PidOptions>
 ```
 
 ---
 
-#### `getFaceCapture(deviceName, pidOption)`
+### `getFaceCapture(deviceName, pidOption?)`
+
+Captures face biometric data via the UIDAI Face RD app.
 
-Captures face biometric data using the specified RD service device.
+```typescript
+import { getFaceCapture } from 'react-native-rdservice';
 
-**Parameters:**
+const result = await getFaceCapture('in.gov.uidai.facerd');
+```
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `deviceName` | `string` | Yes | Package name of the face RD service app (e.g., `"in.gov.uidai.facerd"`) |
-| `pidOption` | `string` | No | XML string containing PID options for face capture. If empty or less than 10 characters, uses default configuration |
+The default `PidOptions` targets **face authentication** and uses the UIDAI-published `wadh` constant for that flow. For eKYC or other purposes, pass your own `PidOptions` with the appropriate `wadh` and `purpose`:
 
-**Default PID Options:**
 ```xml
 <?xml version="1.0" encoding="UTF-8"?>
 <PidOptions ver="1.0" env="P">
@@ -150,170 +172,129 @@ Captures face biometric data using the specified RD service device.
 </PidOptions>
 ```
 
-**Returns:** `Promise<RdServiceResponse>`
-
-**Success Response:**
-```typescript
-{
-  status: "SUCCESS",
-  message: "<?xml version='1.0'?><PidData>...</PidData>" // Face biometric XML data
-}
-```
-
-**Error Response:**
-```typescript
-{
-  status: "FAILURE",
-  message: "Device not ready" | "Selected device not found" | "Face RD services not available"
-}
-```
-
-**Example:**
-
-```typescript
-import { getFaceCapture } from 'react-native-rdservice';
-
-// Using default PID options
-const captureFace = async () => {
-  try {
-    const result = await getFaceCapture('in.gov.uidai.facerd', '');
-
-    if (result.status === 'SUCCESS') {
-      console.log('Face captured:', result.message);
-      // Process the face biometric XML data
-      // result.message contains the PID XML with face biometric information
-    } else {
-      console.error('Capture failed:', result.message);
-    }
-  } catch (error) {
-    console.error('Error:', error);
-  }
-};
-
-// Using custom PID options
-const captureFaceCustom = async () => {
-  const customPidOptions = `<?xml version="1.0" encoding="UTF-8"?>
-    <PidOptions ver="1.0" env="P">
-      <Opts fCount="" fType="" iCount="" iType="" pCount="" pType=""
-            format="" pidVer="2.0" timeout="20000" otp=""
-            wadh="your_wadh_value_here" posh="" />
-      <CustOpts>
-        <Param name="txnId" value="customTxnId123"/>
-        <Param name="purpose" value="ekyc"/>
-        <Param name="language" value="en"/>
-      </CustOpts>
-    </PidOptions>`;
-
-  const result = await getFaceCapture('in.gov.uidai.facerd', customPidOptions);
-
-  if (result.status === 'SUCCESS') {
-    // Handle success
-    console.log('Face biometric data:', result.message);
-  }
-};
-```
-
 ---
 
-## Complete Usage Example
+## Complete usage example
 
 ```typescript
 import React, { useState } from 'react';
-import { View, Button, Text, Alert } from 'react-native';
-import { getFingerPrint, getFaceCapture, type RdServiceResponse } from 'react-native-rdservice';
-
-const BiometricCapture = () => {
-  const [fpData, setFpData] = useState<string>('');
-  const [faceData, setFaceData] = useState<string>('');
-
-  const handleFingerprintCapture = async () => {
+import { View, Button, Alert } from 'react-native';
+import {
+  getDeviceInfo,
+  getFingerPrint,
+  getIrisCapture,
+  getFaceCapture,
+  type RdServiceResponse,
+} from 'react-native-rdservice';
+
+export default function BiometricCapture() {
+  const [busy, setBusy] = useState(false);
+
+  const capture = async (fn: () => Promise<RdServiceResponse>) => {
+    setBusy(true);
     try {
-      const result: RdServiceResponse = await getFingerPrint(
-        'com.mantra.rdservice',
-        ''
-      );
-
-      if (result.status === 'SUCCESS') {
-        setFpData(result.message);
-        Alert.alert('Success', 'Fingerprint captured successfully');
-      } else {
-        Alert.alert('Error', result.message);
-      }
-    } catch (error) {
-      Alert.alert('Error', 'Failed to capture fingerprint');
-      console.error(error);
-    }
-  };
-
-  const handleFaceCapture = async () => {
-    try {
-      const result: RdServiceResponse = await getFaceCapture(
-        'in.gov.uidai.facerd',
-        ''
-      );
-
+      const result = await fn();
       if (result.status === 'SUCCESS') {
-        setFaceData(result.message);
-        Alert.alert('Success', 'Face captured successfully');
+        // Forward result.message (signed PID XML) to your backend over TLS.
+        Alert.alert('Success', 'Biometric captured');
       } else {
-        Alert.alert('Error', result.message);
+        Alert.alert('Failed', result.message);
       }
-    } catch (error) {
-      Alert.alert('Error', 'Failed to capture face');
-      console.error(error);
+    } finally {
+      setBusy(false);
     }
   };
 
   return (
     <View>
-      <Button title="Capture Fingerprint" onPress={handleFingerprintCapture} />
-      <Button title="Capture Face" onPress={handleFaceCapture} />
-
-      {fpData ? <Text>Fingerprint Data: {fpData.substring(0, 100)}...</Text> : null}
-      {faceData ? <Text>Face Data: {faceData.substring(0, 100)}...</Text> : null}
+      <Button
+        title="Check Device"
+        disabled={busy}
+        onPress={() => capture(() => getDeviceInfo('com.mantra.rdservice'))}
+      />
+      <Button
+        title="Fingerprint"
+        disabled={busy}
+        onPress={() => capture(() => getFingerPrint('com.mantra.rdservice'))}
+      />
+      <Button
+        title="Iris"
+        disabled={busy}
+        onPress={() => capture(() => getIrisCapture('com.mantra.mis100v2.rdservice'))}
+      />
+      <Button
+        title="Face"
+        disabled={busy}
+        onPress={() => capture(() => getFaceCapture('in.gov.uidai.facerd'))}
+      />
     </View>
   );
-};
-
-export default BiometricCapture;
+}
 ```
 
-## Common RD Service Package Names
+## Common RD service package names
 
-**Fingerprint Devices:**
-- Mantra: `com.mantra.rdservice`
-- Morpho: `com.scl.rdservice`
-- Precision: `com.precision.pb510.rdservice`
-- Startek: `com.acpl.registersdk`
-- Secugen: `com.secugen.rdservice`
+**Fingerprint:**
 
-**Face Devices:**
-- UIDAI Face RD: `in.gov.uidai.facerd`
+| Vendor | Package |
+|--------|---------|
+| Mantra MFS100 | `com.mantra.rdservice` |
+| Morpho | `com.scl.rdservice` |
+| Precision PB510 | `com.precision.pb510.rdservice` |
+| Startek | `com.acpl.registersdk` |
+| SecuGen | `com.secugen.rdservice` |
+| Tatvik | `com.tatvik.bio.tmf20` |
 
-## Requirements
+**Iris:**
 
-- React Native 0.60 or higher
-- Android SDK 24 or higher
-- RD service app installed on the device
+| Vendor | Package |
+|--------|---------|
+| Mantra MIS100V2 | `com.mantra.mis100v2.rdservice` |
+| IriTech IriShield | `com.iritech.rdservice` |
 
-## Platform Support
+**Face:**
 
-- Android: ✅ Supported
-- iOS: ❌ Not supported (RD services are Android-only)
+| Vendor | Package |
+|--------|---------|
+| UIDAI Face RD | `in.gov.uidai.facerd` |
 
-## Error Handling
+> Package names can change between vendor releases — verify against the RD service app actually installed on your target devices.
 
-The library returns descriptive error messages in the `message` field when `status` is `"FAILURE"`:
+## Error handling
 
-- **"Device not ready"**: The biometric device is not connected or not ready
-- **"Selected device not found"**: The specified RD service package is not installed
-- **"RD services not available"**: The RD service app is not available on the device
-- **"No action taken"**: User cancelled the operation
+Failures resolve (never reject) with `status: 'FAILURE'` and one of:
 
-## License
+| Message | Meaning |
+|---------|---------|
+| `Device not ready` | The biometric device is not connected, not initialised, or returned an invalid response |
+| `Selected device not found` | No app with the given package name handles the RD capture intent |
+| `No action taken` | The user cancelled the capture |
+| `Invalid RD service package name` | `deviceName` is not a valid Android package name |
+| `Another RD service request is already in progress` | A previous capture has not finished yet |
+| `No foreground activity available to start RD service` | The app is not in the foreground |
+| `UIDAI RD services are not available on iOS…` | Called on iOS, where RD services do not exist |
 
-MIT
+## Security notes
+
+Biometric data is highly sensitive. When integrating this library:
+
+- **Never modify the PID XML.** The `message` returned on success is digitally signed by the RD service; altering a single character breaks UIDAI signature verification. This library returns it byte-for-byte as produced.
+- **Never log or persist raw PID data** on the device. Forward it to your backend over TLS and discard it.
+- **The PID block is already encrypted** by the RD service (per UIDAI spec) — your app cannot and should not decrypt it; only the authorised backend/AUA can process it.
+- **Validate the RD service app.** The library only launches explicit intents against a syntactically valid package name, so the capture request cannot be hijacked by an arbitrary app — but you should still pin the exact vendor package(s) you support.
+- **Use `env="PP"` (pre-production) PidOptions during development** and `env="P"` only in production.
+- Comply with the UIDAI Aadhaar Act and data-protection regulations applicable to your deployment.
+
+## Troubleshooting
+
+- **`Selected device not found` on Android 11+**: fixed by this library's built-in `<queries>` declarations — rebuild the app after installing/updating the library.
+- **Capture never returns**: ensure the RD service app is installed, registered, and the device is plugged in; call `getDeviceInfo` first to check readiness.
+- **Works in debug but not release**: confirm your ProGuard/R8 rules don't strip the RD service vendor SDK (this library itself needs no extra rules).
 
 ## Contributing
 
-See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository.
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## License
+
+MIT

package/android/build.gradle

@@ -74,6 +74,8 @@ repositories {
 def kotlin_version = getExtOrDefault("kotlinVersion")
 
 dependencies {
-  implementation 'com.facebook.react:react-android:0.83.0'
+  // Version is resolved by the consumer app's React Native Gradle plugin, so the
+  // library works with any React Native version (0.80+) instead of pinning one.
+  implementation "com.facebook.react:react-android"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 }

package/android/gradle.properties

@@ -1,5 +1,5 @@
 Rdservice_kotlinVersion=2.0.21
 Rdservice_minSdkVersion=24
-Rdservice_targetSdkVersion=34
+Rdservice_targetSdkVersion=35
 Rdservice_compileSdkVersion=35
 Rdservice_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -1,2 +1,21 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <!--
+    Android 11+ package visibility: without these entries the host app cannot
+    see or launch the RD service apps installed on the device. Merged into the
+    consumer app's manifest automatically.
+  -->
+  <queries>
+    <intent>
+      <action android:name="in.gov.uidai.rdservice.fp.INFO" />
+    </intent>
+    <intent>
+      <action android:name="in.gov.uidai.rdservice.fp.CAPTURE" />
+    </intent>
+    <intent>
+      <action android:name="in.gov.uidai.rdservice.iris.CAPTURE" />
+    </intent>
+    <intent>
+      <action android:name="in.gov.uidai.rdservice.face.CAPTURE" />
+    </intent>
+  </queries>
 </manifest>

package/android/src/main/java/com/rdservice/RdserviceModule.kt

@@ -2,6 +2,7 @@ package com.rdservice
 
 import android.app.Activity
 import android.content.Intent
+import android.util.Log
 import com.facebook.react.bridge.ActivityEventListener
 import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.BaseActivityEventListener
@@ -16,72 +17,69 @@ class RdserviceModule(reactContext: ReactApplicationContext) :
 
   companion object {
     const val NAME = "Rdservice"
-    const val RDINFO_CODE = 1
-    const val RDCAPTURE_CODE = 2
-    const val FACE_CAPTURE_CODE = 9
+
+    private const val RDINFO_CODE = 1
+    private const val RDCAPTURE_CODE = 2
+    private const val IRIS_CAPTURE_CODE = 3
+    private const val FACE_CAPTURE_CODE = 9
+
+    private const val ACTION_FP_INFO = "in.gov.uidai.rdservice.fp.INFO"
+    private const val ACTION_FP_CAPTURE = "in.gov.uidai.rdservice.fp.CAPTURE"
+    private const val ACTION_IRIS_CAPTURE = "in.gov.uidai.rdservice.iris.CAPTURE"
+    private const val ACTION_FACE_CAPTURE = "in.gov.uidai.rdservice.face.CAPTURE"
+
+    private const val SUCCESS = "SUCCESS"
+    private const val FAILURE = "FAILURE"
+
+    // RD service responses shorter than this cannot contain valid XML.
+    private const val MIN_VALID_RESPONSE_LENGTH = 10
+
+    // Valid Android application id, e.g. com.mantra.rdservice. Rejecting anything
+    // else prevents the capture intent from being sent as an implicit broadcast
+    // that an arbitrary app could answer.
+    private val PACKAGE_NAME_PATTERN =
+      Regex("^[a-zA-Z][a-zA-Z0-9_]*(\\.[a-zA-Z][a-zA-Z0-9_]*)+$")
+
+    private const val DEFAULT_FINGER_PID_OPTIONS =
+      """<?xml version="1.0"?><PidOptions ver="1.0"><Opts fCount="1" fType="2" iCount="0" pCount="0" format="0" pidVer="2.0" timeout="10000" posh="UNKNOWN" env="P" /><CustOpts></CustOpts></PidOptions>"""
+
+    private const val DEFAULT_IRIS_PID_OPTIONS =
+      """<?xml version="1.0"?><PidOptions ver="1.0"><Opts fCount="0" fType="0" iCount="1" iType="0" pCount="0" pType="0" format="0" pidVer="2.0" timeout="10000" posh="UNKNOWN" env="P" /><CustOpts></CustOpts></PidOptions>"""
+
+    // The wadh value below is the UIDAI-published constant for face authentication.
+    // Pass custom PidOptions for eKYC or other flows.
+    private const val DEFAULT_FACE_PID_OPTIONS =
+      """<?xml version="1.0" encoding="UTF-8"?> <PidOptions ver="1.0" env="P"><Opts fCount="" fType="" iCount="" iType="" pCount="" pType="" format="" pidVer="2.0" timeout="" otp="" wadh="sgydIC09zzy6f8Lb3xaAqzKquKe9lFcNR9uTvYxFp+A=" posh="" /> <CustOpts><Param name="txnId" value="76435891"/><Param name="purpose" value="auth"/><Param name="language" value="en"/></CustOpts></PidOptions>"""
   }
 
-  private val SUCCESS = "SUCCESS"
-  private val FAILURE = "FAILURE"
-  private var pckName = ""
-  private var pidOption = ""
   private var promise: Promise? = null
 
   private val activityEventListener: ActivityEventListener = object : BaseActivityEventListener() {
-    override fun onActivityResult(activity: Activity?, requestCode: Int, resultCode: Int, data: Intent?) {
+    override fun onActivityResult(
+      activity: Activity,
+      requestCode: Int,
+      resultCode: Int,
+      data: Intent?,
+    ) {
+      when (requestCode) {
+        RDINFO_CODE,
+        RDCAPTURE_CODE,
+        IRIS_CAPTURE_CODE,
+        FACE_CAPTURE_CODE,
+        -> Unit
+        // Results from unrelated activities must not touch a pending capture.
+        else -> return
+      }
+
       if (data == null) {
         resolve(FAILURE, "No action taken")
         return
       }
 
       when (requestCode) {
-        RDINFO_CODE -> {
-          val requiredValue = data.getStringExtra("RD_SERVICE_INFO")
-
-          if (requiredValue == null) {
-            resolve(FAILURE, "Device not ready")
-            return
-          }
-          if (requiredValue.length <= 10) {
-            resolve(FAILURE, "Device not ready")
-            return
-          }
-          if (requiredValue.lowercase().contains("notready")) {
-            resolve(FAILURE, "Device not ready")
-            return
-          }
-
-          captureData()
-          return
-        }
-
-        RDCAPTURE_CODE -> {
-          val captureXML = data.getStringExtra("PID_DATA")
-
-          if (captureXML == null || captureXML.length <= 10) {
-            resolve(FAILURE, "Device not ready")
-            return
-          }
-          if (captureXML.lowercase().contains("device not ready")) {
-            resolve(FAILURE, "Device not ready")
-            return
-          }
-          resolve(SUCCESS, captureXML)
-        }
-
-        FACE_CAPTURE_CODE -> {
-          val captureXML = data.getStringExtra("response")
-
-          if (captureXML == null || captureXML.length <= 10) {
-            resolve(FAILURE, "Device not ready")
-            return
-          }
-          if (captureXML.lowercase().contains("device not ready")) {
-            resolve(FAILURE, "Device not ready")
-            return
-          }
-          resolve(SUCCESS, captureXML)
-        }
+        RDINFO_CODE -> handleInfoResult(data.getStringExtra("RD_SERVICE_INFO"))
+        RDCAPTURE_CODE, IRIS_CAPTURE_CODE -> handleCaptureResult(data.getStringExtra("PID_DATA"))
+        FACE_CAPTURE_CODE -> handleCaptureResult(data.getStringExtra("response"))
       }
     }
   }
@@ -90,95 +88,109 @@ class RdserviceModule(reactContext: ReactApplicationContext) :
     reactContext.addActivityEventListener(activityEventListener)
   }
 
-  override fun getName(): String {
-    return NAME
-  }
+  override fun getName(): String = NAME
 
-  private fun captureData() {
-    var finalPidOption = """<?xml version="1.0"?><PidOptions ver="1.0"><Opts fCount="1" fType="2" iCount="0" pCount="0" format="0" pidVer="2.0" timeout="10000" posh="UNKNOWN" env="P" /><CustOpts></CustOpts></PidOptions>"""
+  override fun invalidate() {
+    reactApplicationContext.removeActivityEventListener(activityEventListener)
+    promise = null
+    super.invalidate()
+  }
 
-    if (pidOption.length >= 10) {
-      finalPidOption = pidOption
+  override fun getDeviceInfo(deviceName: String, promise: Promise) {
+    startRdActivity(promise, deviceName, RDINFO_CODE) {
+      Intent(ACTION_FP_INFO)
     }
+  }
 
-    val intent = Intent().apply {
-      action = "in.gov.uidai.rdservice.fp.CAPTURE"
-      putExtra("PID_OPTIONS", finalPidOption)
-      setPackage(pckName)
+  override fun getFingerPrint(deviceName: String, pidOption: String, promise: Promise) {
+    startRdActivity(promise, deviceName, RDCAPTURE_CODE) {
+      Intent(ACTION_FP_CAPTURE)
+        .putExtra("PID_OPTIONS", pidOptionOrDefault(pidOption, DEFAULT_FINGER_PID_OPTIONS))
     }
+  }
 
-    val currentActivity = currentActivity
-    try {
-      currentActivity?.startActivityForResult(intent, RDCAPTURE_CODE)
-    } catch (e: Exception) {
-      e.printStackTrace()
-      resolve(FAILURE, "Selected device not found")
+  override fun getIrisCapture(deviceName: String, pidOption: String, promise: Promise) {
+    startRdActivity(promise, deviceName, IRIS_CAPTURE_CODE) {
+      Intent(ACTION_IRIS_CAPTURE)
+        .putExtra("PID_OPTIONS", pidOptionOrDefault(pidOption, DEFAULT_IRIS_PID_OPTIONS))
     }
   }
 
-  private fun captureFaceData() {
-    var finalPidOption = """<?xml version="1.0" encoding="UTF-8"?> <PidOptions ver="1.0" env="P"><Opts fCount="" fType="" iCount="" iType="" pCount="" pType="" format="" pidVer="2.0" timeout="" otp="" wadh="sgydIC09zzy6f8Lb3xaAqzKquKe9lFcNR9uTvYxFp+A=" posh="" /> <CustOpts><Param name="txnId" value="76435891"/><Param name="purpose" value="auth"/><Param name="language" value="en"/></CustOpts></PidOptions>"""
-
-    if (pidOption.length >= 10) {
-      finalPidOption = pidOption
+  override fun getFaceCapture(deviceName: String, pidOption: String, promise: Promise) {
+    startRdActivity(promise, deviceName, FACE_CAPTURE_CODE) {
+      Intent(ACTION_FACE_CAPTURE)
+        .putExtra("request", pidOptionOrDefault(pidOption, DEFAULT_FACE_PID_OPTIONS))
     }
+  }
 
-    val intent = Intent().apply {
-      action = "in.gov.uidai.rdservice.face.CAPTURE"
-      putExtra("request", finalPidOption)
-      setPackage(pckName)
+  private fun pidOptionOrDefault(pidOption: String, default: String): String =
+    if (pidOption.trim().length >= MIN_VALID_RESPONSE_LENGTH) pidOption else default
+
+  private fun startRdActivity(
+    promise: Promise,
+    packageName: String,
+    requestCode: Int,
+    intentBuilder: () -> Intent,
+  ) {
+    if (this.promise != null) {
+      resolvePromise(promise, FAILURE, "Another RD service request is already in progress")
+      return
+    }
+    if (!PACKAGE_NAME_PATTERN.matches(packageName)) {
+      resolvePromise(promise, FAILURE, "Invalid RD service package name")
+      return
+    }
+    val activity = reactApplicationContext.getCurrentActivity()
+    if (activity == null) {
+      resolvePromise(promise, FAILURE, "No foreground activity available to start RD service")
+      return
     }
 
-    val currentActivity = currentActivity
+    this.promise = promise
     try {
-      currentActivity?.startActivityForResult(intent, FACE_CAPTURE_CODE)
+      activity.startActivityForResult(intentBuilder().setPackage(packageName), requestCode)
     } catch (e: Exception) {
-      e.printStackTrace()
+      // Log only the exception type; never log intent contents or biometric data.
+      Log.w(NAME, "Unable to start RD service activity: ${e.javaClass.simpleName}")
       resolve(FAILURE, "Selected device not found")
     }
   }
 
-  override fun getFingerPrint(deviceName: String, pidOption: String, promise: Promise) {
-    try {
-      this.promise = promise
-      this.pckName = deviceName
-      this.pidOption = pidOption
-      captureData()
-    } catch (e: Exception) {
-      e.printStackTrace()
-      resolve(FAILURE, "RD services not available")
+  private fun handleInfoResult(info: String?) {
+    if (info == null ||
+      info.length <= MIN_VALID_RESPONSE_LENGTH ||
+      info.lowercase().contains("notready")
+    ) {
+      resolve(FAILURE, "Device not ready")
+      return
     }
+    resolve(SUCCESS, info)
   }
 
-  override fun getFaceCapture(deviceName: String, pidOption: String, promise: Promise) {
-    try {
-      this.promise = promise
-      this.pckName = deviceName
-      this.pidOption = pidOption
-      captureFaceData()
-    } catch (e: Exception) {
-      e.printStackTrace()
-      resolve(FAILURE, "Face RD services not available")
+  private fun handleCaptureResult(captureXml: String?) {
+    if (captureXml == null || captureXml.length <= MIN_VALID_RESPONSE_LENGTH) {
+      resolve(FAILURE, "Device not ready")
+      return
     }
-  }
-
-  private fun parseBioMetricData(bioxml: String): String {
-    return bioxml
-      .replace("\"", "'")
-      .replace("\n   ", " ")
-      .replace("\n ", " ")
+    if (captureXml.lowercase().contains("device not ready")) {
+      resolve(FAILURE, "Device not ready")
+      return
+    }
+    // Return the PID XML exactly as the RD service produced it. It is digitally
+    // signed; altering even a single character breaks server-side verification.
+    resolve(SUCCESS, captureXml)
   }
 
   private fun resolve(status: String, message: String) {
-    if (promise == null) {
-      return
-    }
+    val pending = promise ?: return
+    promise = null
+    resolvePromise(pending, status, message)
+  }
 
+  private fun resolvePromise(promise: Promise, status: String, message: String) {
     val map: WritableMap = Arguments.createMap()
-    map.putString("status", status.uppercase())
-    map.putString("message", parseBioMetricData(message))
-
-    promise?.resolve(map)
-    promise = null
+    map.putString("status", status)
+    map.putString("message", message)
+    promise.resolve(map)
   }
 }

package/ios/Rdservice.mm

@@ -1,16 +1,57 @@
 #import "Rdservice.h"
 
+/**
+ * UIDAI RD (Registered Device) services are certified for Android and Windows
+ * only — the capture flow depends on RD service apps resolved via Android
+ * intents, which have no iOS equivalent. These implementations exist so the
+ * module loads on iOS and resolves with a consistent FAILURE response instead
+ * of crashing, letting cross-platform apps share one code path.
+ */
+static NSDictionary *RdserviceUnsupportedResponse(void)
+{
+  return @{
+    @"status" : @"FAILURE",
+    @"message" : @"UIDAI RD services are not available on iOS. Biometric capture is supported on Android only.",
+  };
+}
+
 @implementation Rdservice
-- (NSNumber *)multiply:(double)a b:(double)b {
-    NSNumber *result = @(a * b);
 
-    return result;
+- (void)getDeviceInfo:(NSString *)deviceName
+              resolve:(RCTPromiseResolveBlock)resolve
+               reject:(RCTPromiseRejectBlock)reject
+{
+  resolve(RdserviceUnsupportedResponse());
+}
+
+- (void)getFingerPrint:(NSString *)deviceName
+             pidOption:(NSString *)pidOption
+               resolve:(RCTPromiseResolveBlock)resolve
+                reject:(RCTPromiseRejectBlock)reject
+{
+  resolve(RdserviceUnsupportedResponse());
+}
+
+- (void)getIrisCapture:(NSString *)deviceName
+             pidOption:(NSString *)pidOption
+               resolve:(RCTPromiseResolveBlock)resolve
+                reject:(RCTPromiseRejectBlock)reject
+{
+  resolve(RdserviceUnsupportedResponse());
+}
+
+- (void)getFaceCapture:(NSString *)deviceName
+             pidOption:(NSString *)pidOption
+               resolve:(RCTPromiseResolveBlock)resolve
+                reject:(RCTPromiseRejectBlock)reject
+{
+  resolve(RdserviceUnsupportedResponse());
 }
 
 - (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
     (const facebook::react::ObjCTurboModule::InitParams &)params
 {
-    return std::make_shared<facebook::react::NativeRdserviceSpecJSI>(params);
+  return std::make_shared<facebook::react::NativeRdserviceSpecJSI>(params);
 }
 
 + (NSString *)moduleName

package/lib/module/NativeRdservice.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"..\\..\\src","sources":["NativeRdservice.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAYpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,WAAW,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"..\\..\\src","sources":["NativeRdservice.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAyBpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,WAAW,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -1,10 +1,52 @@
 "use strict";
 
 import Rdservice from "./NativeRdservice.js";
-export function getFingerPrint(deviceName, pidOption) {
+
+/** Possible values of {@link RdServiceResponse.status}. */
+
+/**
+ * Queries the RD service app for device/driver status (RD INFO call).
+ *
+ * @param deviceName Package name of the RD service app, e.g. `com.mantra.rdservice`.
+ * @returns On success, `message` contains the `RDService` info XML.
+ */
+export function getDeviceInfo(deviceName) {
+  return Rdservice.getDeviceInfo(deviceName);
+}
+
+/**
+ * Captures fingerprint biometric data via the given RD service app.
+ *
+ * @param deviceName Package name of the RD service app, e.g. `com.mantra.rdservice`.
+ * @param pidOption Optional `PidOptions` XML. Falls back to a sensible
+ *   single-finger capture configuration when omitted or blank.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
+export function getFingerPrint(deviceName, pidOption = '') {
   return Rdservice.getFingerPrint(deviceName, pidOption);
 }
-export function getFaceCapture(deviceName, pidOption) {
+
+/**
+ * Captures iris biometric data via the given iris RD service app.
+ *
+ * @param deviceName Package name of the iris RD service app, e.g. `com.mantra.mis100v2.rdservice`.
+ * @param pidOption Optional `PidOptions` XML. Falls back to a single-iris
+ *   capture configuration when omitted or blank.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
+export function getIrisCapture(deviceName, pidOption = '') {
+  return Rdservice.getIrisCapture(deviceName, pidOption);
+}
+
+/**
+ * Captures face biometric data via the UIDAI Face RD app.
+ *
+ * @param deviceName Package name of the face RD service app, e.g. `in.gov.uidai.facerd`.
+ * @param pidOption Optional `PidOptions` XML. The default targets face
+ *   authentication; pass your own options (with the correct `wadh`) for eKYC.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
+export function getFaceCapture(deviceName, pidOption = '') {
   return Rdservice.getFaceCapture(deviceName, pidOption);
 }
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Rdservice","getFingerPrint","deviceName","pidOption","getFaceCapture"],"sourceRoot":"..\\..\\src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,SAAS,MAAkC,sBAAmB;AAIrE,OAAO,SAASC,cAAcA,CAC5BC,UAAkB,EAClBC,SAAiB,EACW;EAC5B,OAAOH,SAAS,CAACC,cAAc,CAACC,UAAU,EAAEC,SAAS,CAAC;AACxD;AAEA,OAAO,SAASC,cAAcA,CAC5BF,UAAkB,EAClBC,SAAiB,EACW;EAC5B,OAAOH,SAAS,CAACI,cAAc,CAACF,UAAU,EAAEC,SAAS,CAAC;AACxD","ignoreList":[]}
+{"version":3,"names":["Rdservice","getDeviceInfo","deviceName","getFingerPrint","pidOption","getIrisCapture","getFaceCapture"],"sourceRoot":"..\\..\\src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,SAAS,MAAkC,sBAAmB;;AAIrE;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,aAAaA,CAACC,UAAkB,EAA8B;EAC5E,OAAOF,SAAS,CAACC,aAAa,CAACC,UAAU,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAC5BD,UAAkB,EAClBE,SAAiB,GAAG,EAAE,EACM;EAC5B,OAAOJ,SAAS,CAACG,cAAc,CAACD,UAAU,EAAEE,SAAS,CAAC;AACxD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAC5BH,UAAkB,EAClBE,SAAiB,GAAG,EAAE,EACM;EAC5B,OAAOJ,SAAS,CAACK,cAAc,CAACH,UAAU,EAAEE,SAAS,CAAC;AACxD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,cAAcA,CAC5BJ,UAAkB,EAClBE,SAAiB,GAAG,EAAE,EACM;EAC5B,OAAOJ,SAAS,CAACM,cAAc,CAACJ,UAAU,EAAEE,SAAS,CAAC;AACxD","ignoreList":[]}

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

@@ -1,10 +1,14 @@
 import { type TurboModule } from 'react-native';
 export interface RdServiceResponse {
+    /** "SUCCESS" or "FAILURE" */
     status: string;
+    /** Signed XML from the RD service on success, human-readable error on failure */
     message: string;
 }
 export interface Spec extends TurboModule {
+    getDeviceInfo(deviceName: string): Promise<RdServiceResponse>;
     getFingerPrint(deviceName: string, pidOption: string): Promise<RdServiceResponse>;
+    getIrisCapture(deviceName: string, pidOption: string): Promise<RdServiceResponse>;
     getFaceCapture(deviceName: string, pidOption: string): Promise<RdServiceResponse>;
 }
 declare const _default: Spec;

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

@@ -1 +1 @@
-{"version":3,"file":"NativeRdservice.d.ts","sourceRoot":"","sources":["../../../src/NativeRdservice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClF,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACnF;;AAED,wBAAmE"}
+{"version":3,"file":"NativeRdservice.d.ts","sourceRoot":"","sources":["../../../src/NativeRdservice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9D,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9B,cAAc,CACZ,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;;AAED,wBAAmE"}

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

@@ -1,5 +1,39 @@
-import { type RdServiceResponse } from './NativeRdservice';
+import { type RdServiceResponse } from './NativeRdservice.js';
 export type { RdServiceResponse };
-export declare function getFingerPrint(deviceName: string, pidOption: string): Promise<RdServiceResponse>;
-export declare function getFaceCapture(deviceName: string, pidOption: string): Promise<RdServiceResponse>;
+/** Possible values of {@link RdServiceResponse.status}. */
+export type RdServiceStatus = 'SUCCESS' | 'FAILURE';
+/**
+ * Queries the RD service app for device/driver status (RD INFO call).
+ *
+ * @param deviceName Package name of the RD service app, e.g. `com.mantra.rdservice`.
+ * @returns On success, `message` contains the `RDService` info XML.
+ */
+export declare function getDeviceInfo(deviceName: string): Promise<RdServiceResponse>;
+/**
+ * Captures fingerprint biometric data via the given RD service app.
+ *
+ * @param deviceName Package name of the RD service app, e.g. `com.mantra.rdservice`.
+ * @param pidOption Optional `PidOptions` XML. Falls back to a sensible
+ *   single-finger capture configuration when omitted or blank.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
+export declare function getFingerPrint(deviceName: string, pidOption?: string): Promise<RdServiceResponse>;
+/**
+ * Captures iris biometric data via the given iris RD service app.
+ *
+ * @param deviceName Package name of the iris RD service app, e.g. `com.mantra.mis100v2.rdservice`.
+ * @param pidOption Optional `PidOptions` XML. Falls back to a single-iris
+ *   capture configuration when omitted or blank.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
+export declare function getIrisCapture(deviceName: string, pidOption?: string): Promise<RdServiceResponse>;
+/**
+ * Captures face biometric data via the UIDAI Face RD app.
+ *
+ * @param deviceName Package name of the face RD service app, e.g. `in.gov.uidai.facerd`.
+ * @param pidOption Optional `PidOptions` XML. The default targets face
+ *   authentication; pass your own options (with the correct `wadh`) for eKYC.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
+export declare function getFaceCapture(deviceName: string, pidOption?: string): Promise<RdServiceResponse>;
 //# 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.tsx"],"names":[],"mappings":"AAAA,OAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAE5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAmB,CAAC;AAEtE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAElC,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAE5B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-rdservice",
-  "version": "0.1.0",
-  "description": "Reading Finger print and Face data using RD services in Android",
+  "version": "0.2.0",
+  "description": "Capture fingerprint, iris and face biometric data using UIDAI RD (Registered Device) services on Android",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
@@ -45,6 +45,7 @@
     "android",
     "biometric",
     "fingerprint",
+    "iris",
     "face-recognition",
     "rd-service",
     "uidai",
@@ -69,33 +70,33 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@commitlint/config-conventional": "^19.8.1",
+    "@commitlint/config-conventional": "^21.2.0",
     "@eslint/compat": "^1.3.2",
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.35.0",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^9.39.4",
     "@react-native/babel-preset": "0.83.0",
     "@react-native/eslint-config": "0.83.0",
-    "@release-it/conventional-changelog": "^10.0.1",
+    "@release-it/conventional-changelog": "^11.0.1",
     "@types/jest": "^29.5.14",
-    "@types/react": "^19.2.0",
-    "commitlint": "^19.8.1",
-    "del-cli": "^6.0.0",
-    "eslint": "^9.35.0",
+    "@types/react": "^19.2.17",
+    "commitlint": "^21.2.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
+    "eslint-plugin-prettier": "^5.5.6",
     "jest": "^29.7.0",
-    "lefthook": "^2.0.3",
-    "prettier": "^2.8.8",
+    "lefthook": "^2.1.9",
+    "prettier": "^3.9.4",
     "react": "19.2.0",
     "react-native": "0.83.0",
-    "react-native-builder-bob": "^0.40.13",
-    "release-it": "^19.0.4",
-    "turbo": "^2.5.6",
-    "typescript": "^5.9.2"
+    "react-native-builder-bob": "^0.43.0",
+    "release-it": "^20.2.1",
+    "turbo": "^2.10.4",
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
     "react": "*",
-    "react-native": "*"
+    "react-native": ">=0.80.0"
   },
   "workspaces": [
     "example"

package/src/NativeRdservice.ts

@@ -1,13 +1,26 @@
 import { TurboModuleRegistry, type TurboModule } from 'react-native';
 
 export interface RdServiceResponse {
+  /** "SUCCESS" or "FAILURE" */
   status: string;
+  /** Signed XML from the RD service on success, human-readable error on failure */
   message: string;
 }
 
 export interface Spec extends TurboModule {
-  getFingerPrint(deviceName: string, pidOption: string): Promise<RdServiceResponse>;
-  getFaceCapture(deviceName: string, pidOption: string): Promise<RdServiceResponse>;
+  getDeviceInfo(deviceName: string): Promise<RdServiceResponse>;
+  getFingerPrint(
+    deviceName: string,
+    pidOption: string
+  ): Promise<RdServiceResponse>;
+  getIrisCapture(
+    deviceName: string,
+    pidOption: string
+  ): Promise<RdServiceResponse>;
+  getFaceCapture(
+    deviceName: string,
+    pidOption: string
+  ): Promise<RdServiceResponse>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('Rdservice');

package/src/index.tsx

@@ -2,16 +2,60 @@ import Rdservice, { type RdServiceResponse } from './NativeRdservice';
 
 export type { RdServiceResponse };
 
+/** Possible values of {@link RdServiceResponse.status}. */
+export type RdServiceStatus = 'SUCCESS' | 'FAILURE';
+
+/**
+ * Queries the RD service app for device/driver status (RD INFO call).
+ *
+ * @param deviceName Package name of the RD service app, e.g. `com.mantra.rdservice`.
+ * @returns On success, `message` contains the `RDService` info XML.
+ */
+export function getDeviceInfo(deviceName: string): Promise<RdServiceResponse> {
+  return Rdservice.getDeviceInfo(deviceName);
+}
+
+/**
+ * Captures fingerprint biometric data via the given RD service app.
+ *
+ * @param deviceName Package name of the RD service app, e.g. `com.mantra.rdservice`.
+ * @param pidOption Optional `PidOptions` XML. Falls back to a sensible
+ *   single-finger capture configuration when omitted or blank.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
 export function getFingerPrint(
   deviceName: string,
-  pidOption: string
+  pidOption: string = ''
 ): Promise<RdServiceResponse> {
   return Rdservice.getFingerPrint(deviceName, pidOption);
 }
 
+/**
+ * Captures iris biometric data via the given iris RD service app.
+ *
+ * @param deviceName Package name of the iris RD service app, e.g. `com.mantra.mis100v2.rdservice`.
+ * @param pidOption Optional `PidOptions` XML. Falls back to a single-iris
+ *   capture configuration when omitted or blank.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
+export function getIrisCapture(
+  deviceName: string,
+  pidOption: string = ''
+): Promise<RdServiceResponse> {
+  return Rdservice.getIrisCapture(deviceName, pidOption);
+}
+
+/**
+ * Captures face biometric data via the UIDAI Face RD app.
+ *
+ * @param deviceName Package name of the face RD service app, e.g. `in.gov.uidai.facerd`.
+ * @param pidOption Optional `PidOptions` XML. The default targets face
+ *   authentication; pass your own options (with the correct `wadh`) for eKYC.
+ * @returns On success, `message` contains the signed `PidData` XML.
+ */
 export function getFaceCapture(
   deviceName: string,
-  pidOption: string
+  pidOption: string = ''
 ): Promise<RdServiceResponse> {
   return Rdservice.getFaceCapture(deviceName, pidOption);
 }