react-native-otp-auto-verify 0.1.4 → 0.1.6

package/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
 Copyright (c) 2026 Kailas Rathod
+
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
 in the Software without restriction, including without limitation the rights

package/README.md

@@ -1,31 +1,39 @@
 # react-native-otp-auto-verify
 
-<div align="center">
 
-[![npm version](https://img.shields.io/npm/v/react-native-otp-auto-verify.svg?style=flat-square)](https://www.npmjs.com/package/react-native-otp-auto-verify)
-[![typescript](https://img.shields.io/badge/TypeScript-Ready-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
-[![license](https://img.shields.io/npm/l/react-native-otp-auto-verify.svg?style=flat-square)](https://github.com/kailas-rathod/react-native-otp-auto-verify/blob/main/LICENSE)
+[![npm version](https://img.shields.io/npm/v/react-native-otp-auto-verify.svg?style=flat-square)](https://www.npmjs.com/package/react-native-otp-auto-verify)      [![npm downloads](https://img.shields.io/npm/dm/react-native-otp-auto-verify.svg?style=flat-square)](https://www.npmjs.com/package/react-native-otp-auto-verify)      [![license](https://img.shields.io/npm/l/react-native-otp-auto-verify.svg?style=flat-square)](https://github.com/kailas-rathod/react-native-otp-auto-verify/blob/main/LICENSE)         [![typescript](https://img.shields.io/badge/TypeScript-Ready-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
 
+**react-native-otp-auto-verify** is a lightweight and secure React Native OTP auto-verification library for Android, built on the official Google SMS Retriever API. It enables automatic OTP detection without requiring READ_SMS or RECEIVE_SMS permissions, ensuring full Google Play Store compliance and enhanced user trust. Designed for modern authentication flows, this library is ideal for fintech apps, banking applications, e-commerce platforms, and secure login systems.
 
-</div>
+With minimal dependencies and clean architecture, it integrates seamlessly into both React Native Old Architecture and the New Architecture (TurboModule) environments. The solution improves user experience by eliminating manual OTP entry on Android while maintaining strong server-side validation standards.
 
+Works best for onboarding/login flows in **banking**, **fintech**, and authentication-heavy apps.
+Supports both RN Old Architecture and React Native **New Architecture** (TurboModule).
+**Android**: automatic OTP detection.
+**iOS**: auto-OTP is not supported—use manual OTP entry as fallback.
 
+**Connect:** [GitHub](https://github.com/kailas-rathod/react-native-otp-auto-verify) · [npm](https://www.npmjs.com/package/react-native-otp-auto-verify) · [Issues](https://github.com/kailas-rathod/react-native-otp-auto-verify/issues) · [License](https://github.com/kailas-rathod/react-native-otp-auto-verify/blob/main/LICENSE)
 
-## Features
+---
+<img width="1536" height="1024" alt="otp" src="https://github.com/user-attachments/assets/e4908e99-e7d1-4a96-a6d2-b92c50090db0" />
 
-Automatic SMS Verification with the SMS Retriever API (Android Only)
-Phone Number Retrieving using the Phone Number Hint API (Android Only)
-Automatic SMS Verification with the SMS Retriever API, you can perform SMS-based user verification in your Android app automatically, without requiring the user to manually type verification codes, and without requiring any extra app permissions.
 
-Message Format/Structure
-In order to detect the message, SMS message must include a hash that identifies your app. This hash can be obtained by using the getHash() method below.
+## Features
 
+- ✅ **Automatic OTP detection**: receives OTP from matching SMS and exposes it as `otp` (hook) or `extractedOtp` (listener)
+- ✅ **No SMS permissions**: no access to inbox, avoids sensitive permissions and reduces compliance friction
+- ✅ **App hash security**: OTP SMS must end with your **11-character hash** (only your app can receive it)
+- ✅ **Hook + Imperative API**: `useOtpVerification()` for screens, `activateOtpListener()` for custom flows
+- ✅ **TypeScript**: typed options and return values
+- ✅ **New Architecture ready**: TurboModule implementation; works with Old Architecture too
+---
 
-## Platform support
+## Platform Support
 
-| Platform | Support | Notes                                   |
-| -------- | ------- | --------------------------------------- |
-| Android  | ✅      | Requires Google Play services on device |
+| Platform | Support | Notes |
+|----------|----------|-------|
+| Android  | ✅ | Requires Google Play Services on device |
+| iOS      | ✅ Native Only | Uses iOS Security Code AutoFill (manual tap required) |
 
 ## Requirements
 
@@ -69,9 +77,10 @@ Requirements:
 Recommended format:
 
 ```
-<#> Your verification code is 123456
-AbCdEfGhIjK
+Dear Kailas Rathod, 321500 is your OTP for mobile authentication. This OTP is valid for the next 15 minutes. Please DO NOT share it with anyone.
+uW87Uq6teXc
 ```
+Note: You do not need `<#>` at the start of the message.
 
 ### 3) Hook usage (recommended)
 
@@ -83,7 +92,7 @@ import { Text, View } from 'react-native';
 import { useOtpVerification } from 'react-native-otp-auto-verify';
 
 export function OtpScreen() {
-  const { hashCode, otp, timeoutError, startListening, stopListening } =
+  const { hashCode, otp, timeoutError, error, startListening, stopListening } =
     useOtpVerification({ numberOfDigits: 6 });
 
   React.useEffect(() => {
@@ -96,6 +105,7 @@ export function OtpScreen() {
       {!!hashCode && <Text>Hash: {hashCode}</Text>}
       {!!otp && <Text>OTP: {otp}</Text>}
       {timeoutError && <Text>Timeout. Tap resend and try again.</Text>}
+      {!!error && <Text>Error: {error.message}</Text>}
     </View>
   );
 }
@@ -124,19 +134,69 @@ sub.remove();
 removeListener();
 ```
 
-## API
+# iOS OTP AutoFill (Native)
+
+iOS does **not** allow third-party libraries to read SMS messages.
+
+Automatic SMS reading is restricted by Apple for privacy and security reasons.  
+Instead, iOS provides a native feature called **Security Code AutoFill**, which suggests the OTP above the keyboard when properly configured.
+
+This library does **not** auto-read OTP on iOS.
+
+---
+
+## How iOS OTP AutoFill Works
+
+1. User receives an SMS containing an OTP.
+2. iOS detects the code.
+3. The OTP appears above the keyboard.
+4. User taps the suggestion.
+5. The code fills automatically into the input field.
+
+No SMS permissions required.
+
+---
+
+## React Native Setup
+
+Use the following configuration in your OTP input field:
+
+```tsx
+<TextInput
+  style={styles.input}
+  keyboardType="number-pad"
+  textContentType="oneTimeCode"
+  autoComplete="sms-otp"
+  importantForAutofill="yes"
+  maxLength={6}
+/>
+
+```
+
+
+## react-native-otp-auto-verify Architecture Flow
+<img width="1536" height="1024" alt="react-native-otp-auto-verify Architecture Flow" src="https://github.com/user-attachments/assets/11582523-81cb-4904-9de0-56af05b3a3b4" />
+
+## API Reference
 
 ### `useOtpVerification(options?)`
 
-- **options**
-  - `numberOfDigits?: 4 | 5 | 6` (default `6`)
-- **returns**
-  - `hashCode: string`
-  - `otp: string | null`
-  - `sms: string | null`
-  - `timeoutError: boolean`
-  - `startListening(): Promise<void>`
-  - `stopListening(): void`
+Use this on your OTP screen. It manages:
+- getting the app hash (`hashCode`)
+- starting/stopping the SMS Retriever listener
+- extracting OTP and exposing it as `otp`
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `numberOfDigits` | `4 \| 5 \| 6` | `6` | OTP length to extract |
+| `hashCode` | `string` | `''` | App hash (send to backend) |
+| `otp` | `string \| null` | `null` | Extracted OTP |
+| `sms` | `string \| null` | `null` | Full SMS text |
+| `timeoutError` | `boolean` | `false` | Timeout occurred |
+| `error` | `Error \| null` | `null` | Set when getHash or startListening fails |
+| `startListening` | `() => Promise<void>` | — | Start listening |
+| `stopListening` | `() => void` | — | Stop listening |
+
 
 ### `getHash(): Promise<string[]>`
 
@@ -228,6 +288,13 @@ See [`./example`](./example).
 
 See [`CONTRIBUTING.md`](CONTRIBUTING.md).
 
+## Publishing
+
+Maintainers: see [RELEASE_CHECKLIST.md](./RELEASE_CHECKLIST.md) before publishing a new version to npm.
+
+## Keywords
+react native otp auto verify, react native sms retriever api, automatic otp detection android, react native otp autofill, sms retriever react native, otp verification library react native, google play compliant otp library
+
 ## License
 
-MIT
+[MIT](./LICENSE) — see [LICENSE](./LICENSE) in the repo.

package/lib/module/NativeOtpAutoVerify.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('OtpAutoVerify');
+//# sourceMappingURL=NativeOtpAutoVerify.js.map

package/lib/module/NativeOtpAutoVerify.js.map

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

package/lib/module/index.js

@@ -2,7 +2,7 @@
 
 import * as React from 'react';
 import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
-import NativeOtpAutoVerify from './NativeOtpAutoVerify';
+import NativeOtpAutoVerify from "./NativeOtpAutoVerify.js";
 const {
   OtpAutoVerify
 } = NativeModules;
@@ -18,7 +18,9 @@ const OTP_REGEX = {
 /** Extracts a numeric OTP of 4–6 digits from SMS text. */
 export function extractOtp(sms, numberOfDigits = DEFAULT_DIGITS) {
   if (!sms || typeof sms !== 'string') return null;
-  const match = sms.match(OTP_REGEX[numberOfDigits]);
+  const trimmed = sms.trim();
+  if (!trimmed) return null;
+  const match = trimmed.match(OTP_REGEX[numberOfDigits]);
   return match ? match[1] : null;
 }
 
@@ -55,13 +57,14 @@ export function removeListener() {
   }
 }
 
-/** Hook for OTP verification. Stops listener on unmount. */
+/** Hook for OTP verification. Call startListening() to begin; listener is stopped on unmount. */
 export function useOtpVerification(options = {}) {
   const numberOfDigits = options.numberOfDigits ?? DEFAULT_DIGITS;
   const [hashCode, setHashCode] = React.useState('');
   const [otp, setOtp] = React.useState(null);
   const [sms, setSms] = React.useState(null);
   const [timeoutError, setTimeoutError] = React.useState(false);
+  const [error, setError] = React.useState(null);
   const subscriptionRef = React.useRef(null);
   const stopListening = React.useCallback(() => {
     subscriptionRef.current?.remove();
@@ -73,11 +76,12 @@ export function useOtpVerification(options = {}) {
     setOtp(null);
     setSms(null);
     setTimeoutError(false);
+    setError(null);
     try {
       const hashes = await getHash();
       setHashCode(hashes[0] ?? '');
-    } catch {
-      // getHash failed; continue to start listener
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
     }
     try {
       const sub = await activateOtpListener((smsText, extractedOtp) => {
@@ -91,9 +95,13 @@ export function useOtpVerification(options = {}) {
         numberOfDigits
       });
       subscriptionRef.current = sub;
-    } catch {
+    } catch (err) {
       subscriptionRef.current = null;
-      throw new Error('Failed to start OTP listener');
+      const wrapped = new Error('Failed to start OTP listener', {
+        cause: err
+      });
+      setError(wrapped);
+      throw wrapped;
     }
   }, [numberOfDigits]);
   React.useEffect(() => () => stopListening(), [stopListening]);
@@ -102,9 +110,10 @@ export function useOtpVerification(options = {}) {
     otp,
     sms,
     timeoutError,
+    error,
     startListening,
     stopListening
-  }), [hashCode, otp, sms, timeoutError, startListening, stopListening]);
+  }), [hashCode, otp, sms, timeoutError, error, startListening, stopListening]);
 }
 export { OTP_RECEIVED_EVENT };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","NativeEventEmitter","NativeModules","Platform","NativeOtpAutoVerify","OtpAutoVerify","eventEmitter","OS","OTP_RECEIVED_EVENT","getConstants","TIMEOUT_MESSAGE","DEFAULT_DIGITS","OTP_REGEX","extractOtp","sms","numberOfDigits","match","getHash","arr","Array","from","activateOtpListener","handler","options","Error","subscription","addListener","args","smsText","String","startSmsRetriever","remove","removeListeners","removeListener","useOtpVerification","hashCode","setHashCode","useState","otp","setOtp","setSms","timeoutError","setTimeoutError","subscriptionRef","useRef","stopListening","useCallback","current","startListening","hashes","sub","extractedOtp","useEffect","useMemo"],"sourceRoot":"..\\..\\src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","NativeEventEmitter","NativeModules","Platform","NativeOtpAutoVerify","OtpAutoVerify","eventEmitter","OS","OTP_RECEIVED_EVENT","getConstants","TIMEOUT_MESSAGE","DEFAULT_DIGITS","OTP_REGEX","extractOtp","sms","numberOfDigits","trimmed","trim","match","getHash","arr","Array","from","activateOtpListener","handler","options","Error","subscription","addListener","args","smsText","String","startSmsRetriever","remove","removeListeners","removeListener","useOtpVerification","hashCode","setHashCode","useState","otp","setOtp","setSms","timeoutError","setTimeoutError","error","setError","subscriptionRef","useRef","stopListening","useCallback","current","startListening","hashes","err","sub","extractedOtp","wrapped","cause","useEffect","useMemo"],"sourceRoot":"..\\..\\src","sources":["index.tsx"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,kBAAkB,EAAEC,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AAC1E,OAAOC,mBAAmB,MAAM,0BAAuB;AAEvD,MAAM;EAAEC;AAAc,CAAC,GAAGH,aAAa;AACvC,MAAMI,YAAY,GAChBH,QAAQ,CAACI,EAAE,KAAK,SAAS,IAAIF,aAAa,GACtC,IAAIJ,kBAAkB,CAACI,aAAa,CAAC,GACrC,IAAI;AAEV,MAAMG,kBAAkB,GACrBJ,mBAAmB,CAACK,YAAY,GAAG,CAAC,EAAED,kBAAkB,IACzD,aAAa;AAEf,MAAME,eAAe,GAAG,gBAAgB;AACxC,MAAMC,cAAc,GAAG,CAAC;AAIxB,MAAMC,SAAoC,GAAG;EAC3C,CAAC,EAAE,aAAa;EAChB,CAAC,EAAE,aAAa;EAChB,CAAC,EAAE;AACL,CAAC;AA4BD;AACA,OAAO,SAASC,UAAUA,CACxBC,GAAW,EACXC,cAAyB,GAAGJ,cAAc,EAC3B;EACf,IAAI,CAACG,GAAG,IAAI,OAAOA,GAAG,KAAK,QAAQ,EAAE,OAAO,IAAI;EAChD,MAAME,OAAO,GAAGF,GAAG,CAACG,IAAI,CAAC,CAAC;EAC1B,IAAI,CAACD,OAAO,EAAE,OAAO,IAAI;EACzB,MAAME,KAAK,GAAGF,OAAO,CAACE,KAAK,CAACN,SAAS,CAACG,cAAc,CAAC,CAAC;EACtD,OAAOG,KAAK,GAAGA,KAAK,CAAC,CAAC,CAAC,GAAI,IAAI;AACjC;;AAEA;AACA,OAAO,eAAeC,OAAOA,CAAA,EAAsB;EACjD,IAAIhB,QAAQ,CAACI,EAAE,KAAK,SAAS,EAAE,OAAO,EAAE;EACxC,MAAMa,GAAG,GAAG,MAAMhB,mBAAmB,CAACe,OAAO,CAAC,CAAC;EAC/C,OAAOE,KAAK,CAACC,IAAI,CAACF,GAAG,CAAC;AACxB;;AAEA;AACA,OAAO,eAAeG,mBAAmBA,CACvCC,OAA4D,EAC5DC,OAAwC,EACN;EAClC,IAAItB,QAAQ,CAACI,EAAE,KAAK,SAAS,IAAI,CAACD,YAAY,EAAE;IAC9C,MAAM,IAAIoB,KAAK,CAAC,6CAA6C,CAAC;EAChE;EAEA,MAAMX,cAAc,GAAGU,OAAO,EAAEV,cAAc,IAAIJ,cAAc;EAChE,MAAMgB,YAAY,GAAGrB,YAAY,CAACsB,WAAW,CAC3CpB,kBAAkB,EAClB,CAAC,GAAGqB,IAAe,KAAK;IACtB,MAAMC,OAAO,GAAGC,MAAM,CAACF,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrCL,OAAO,CAACM,OAAO,EAAEjB,UAAU,CAACiB,OAAO,EAAEf,cAAc,CAAC,CAAC;EACvD,CACF,CAAC;EAED,MAAMX,mBAAmB,CAAC4B,iBAAiB,CAAC,CAAC;EAC7C,OAAO;IACLC,MAAM,EAAEA,CAAA,KAAM;MACZN,YAAY,CAACM,MAAM,CAAC,CAAC;MACrB7B,mBAAmB,CAAC8B,eAAe,CAAC,CAAC,CAAC;IACxC;EACF,CAAC;AACH;;AAEA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAS;EACrC,IAAIhC,QAAQ,CAACI,EAAE,KAAK,SAAS,EAAE;IAC7BH,mBAAmB,CAAC8B,eAAe,CAAC,CAAC,CAAC;EACxC;AACF;;AAEA;AACA,OAAO,SAASE,kBAAkBA,CAChCX,OAAkC,GAAG,CAAC,CAAC,EACb;EAC1B,MAAMV,cAAc,GAAGU,OAAO,CAACV,cAAc,IAAIJ,cAAc;EAC/D,MAAM,CAAC0B,QAAQ,EAAEC,WAAW,CAAC,GAAGtC,KAAK,CAACuC,QAAQ,CAAC,EAAE,CAAC;EAClD,MAAM,CAACC,GAAG,EAAEC,MAAM,CAAC,GAAGzC,KAAK,CAACuC,QAAQ,CAAgB,IAAI,CAAC;EACzD,MAAM,CAACzB,GAAG,EAAE4B,MAAM,CAAC,GAAG1C,KAAK,CAACuC,QAAQ,CAAgB,IAAI,CAAC;EACzD,MAAM,CAACI,YAAY,EAAEC,eAAe,CAAC,GAAG5C,KAAK,CAACuC,QAAQ,CAAC,KAAK,CAAC;EAC7D,MAAM,CAACM,KAAK,EAAEC,QAAQ,CAAC,GAAG9C,KAAK,CAACuC,QAAQ,CAAe,IAAI,CAAC;EAC5D,MAAMQ,eAAe,GAAG/C,KAAK,CAACgD,MAAM,CAAiC,IAAI,CAAC;EAE1E,MAAMC,aAAa,GAAGjD,KAAK,CAACkD,WAAW,CAAC,MAAM;IAC5CH,eAAe,CAACI,OAAO,EAAElB,MAAM,CAAC,CAAC;IACjCc,eAAe,CAACI,OAAO,GAAG,IAAI;IAC9BhB,cAAc,CAAC,CAAC;EAClB,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMiB,cAAc,GAAGpD,KAAK,CAACkD,WAAW,CAAC,YAAY;IACnD,IAAI/C,QAAQ,CAACI,EAAE,KAAK,SAAS,EAAE;IAC/BkC,MAAM,CAAC,IAAI,CAAC;IACZC,MAAM,CAAC,IAAI,CAAC;IACZE,eAAe,CAAC,KAAK,CAAC;IACtBE,QAAQ,CAAC,IAAI,CAAC;IACd,IAAI;MACF,MAAMO,MAAM,GAAG,MAAMlC,OAAO,CAAC,CAAC;MAC9BmB,WAAW,CAACe,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC,CAAC,OAAOC,GAAG,EAAE;MACZR,QAAQ,CAACQ,GAAG,YAAY5B,KAAK,GAAG4B,GAAG,GAAG,IAAI5B,KAAK,CAACK,MAAM,CAACuB,GAAG,CAAC,CAAC,CAAC;IAC/D;IACA,IAAI;MACF,MAAMC,GAAG,GAAG,MAAMhC,mBAAmB,CACnC,CAACO,OAAO,EAAE0B,YAAY,KAAK;QACzBd,MAAM,CAACZ,OAAO,CAAC;QACf,IAAIA,OAAO,KAAKpB,eAAe,EAAE;UAC/BkC,eAAe,CAAC,IAAI,CAAC;UACrB;QACF;QACA,IAAIY,YAAY,EAAEf,MAAM,CAACe,YAAY,CAAC;MACxC,CAAC,EACD;QAAEzC;MAAe,CACnB,CAAC;MACDgC,eAAe,CAACI,OAAO,GAAGI,GAAG;IAC/B,CAAC,CAAC,OAAOD,GAAG,EAAE;MACZP,eAAe,CAACI,OAAO,GAAG,IAAI;MAC9B,MAAMM,OAAO,GAAG,IAAI/B,KAAK,CAAC,8BAA8B,EAAE;QAAEgC,KAAK,EAAEJ;MAAI,CAAC,CAAC;MACzER,QAAQ,CAACW,OAAO,CAAC;MACjB,MAAMA,OAAO;IACf;EACF,CAAC,EAAE,CAAC1C,cAAc,CAAC,CAAC;EAEpBf,KAAK,CAAC2D,SAAS,CAAC,MAAM,MAAMV,aAAa,CAAC,CAAC,EAAE,CAACA,aAAa,CAAC,CAAC;EAE7D,OAAOjD,KAAK,CAAC4D,OAAO,CAClB,OAAO;IACLvB,QAAQ;IACRG,GAAG;IACH1B,GAAG;IACH6B,YAAY;IACZE,KAAK;IACLO,cAAc;IACdH;EACF,CAAC,CAAC,EACF,CAACZ,QAAQ,EAAEG,GAAG,EAAE1B,GAAG,EAAE6B,YAAY,EAAEE,KAAK,EAAEO,cAAc,EAAEH,aAAa,CACzE,CAAC;AACH;AAEA,SAASzC,kBAAkB","ignoreList":[]}

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

@@ -13,6 +13,8 @@ export interface UseOtpVerificationResult {
     sms: string | null;
     /** True when the 5-minute SMS Retriever timeout occurred. */
     timeoutError: boolean;
+    /** Set when getHash fails (non-fatal) or when startListening fails. Cleared when startListening is called again. */
+    error: Error | null;
     /** Start listening for OTP again (e.g. after timeout or error). */
     startListening: () => Promise<void>;
     /** Stop listening and clean up. Call on unmount. */
@@ -31,7 +33,7 @@ export declare function activateOtpListener(handler: (sms: string, extractedOtp?
 }): Promise<OtpListenerSubscription>;
 /** Stops SMS listening and removes all listeners. */
 export declare function removeListener(): void;
-/** Hook for OTP verification. Stops listener on unmount. */
+/** Hook for OTP verification. Call startListening() to begin; listener is stopped on unmount. */
 export declare function useOtpVerification(options?: UseOtpVerificationOptions): UseOtpVerificationResult;
 export { OTP_RECEIVED_EVENT };
 //# 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":"AAUA,QAAA,MAAM,kBAAkB,QAET,CAAC;AAKhB,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAQlC,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,mCAAmC;IACnC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;IACtB,mEAAmE;IACnE,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,oDAAoD;IACpD,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,cAAc,GAAE,SAA0B,GACzC,MAAM,GAAG,IAAI,CAIf;AAED,kFAAkF;AAClF,wBAAsB,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAIjD;AAED,6FAA6F;AAC7F,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,EAC5D,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,SAAS,CAAA;CAAE,GACvC,OAAO,CAAC,uBAAuB,CAAC,CAqBlC;AAED,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CAyD1B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAUA,QAAA,MAAM,kBAAkB,QAET,CAAC;AAKhB,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAQlC,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,mCAAmC;IACnC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAC;IACtB,oHAAoH;IACpH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,mEAAmE;IACnE,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,oDAAoD;IACpD,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,cAAc,GAAE,SAA0B,GACzC,MAAM,GAAG,IAAI,CAMf;AAED,kFAAkF;AAClF,wBAAsB,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAIjD;AAED,6FAA6F;AAC7F,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,EAC5D,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,SAAS,CAAA;CAAE,GACvC,OAAO,CAAC,uBAAuB,CAAC,CAqBlC;AAED,qDAAqD;AACrD,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,wBAAwB,CA8D1B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/package.json

@@ -1,13 +1,28 @@
 {
   "name": "react-native-otp-auto-verify",
-  "version": "0.1.4",
-  "description": "react-native-otp-auto-verify is a React Native library for automatic OTP detection and verification on Android using the Google SMS Retriever API. It enables secure, permission-less OTP auto-reading without requiring READ_SMS, making it fully Play Store compliant.",
+  "version": "0.1.6",
+  "description": "react-native-otp-auto-verify is a React Native library for automatic OTP verification on Android and iOS. It uses the Google SMS Retriever API to detect OTP codes automatically without requiring the READ_SMS permission. The library is fully Play Store compliant, improves user login experience, supports TurboModule, and works with the React Native New Architecture",
   "keywords": [
     "react-native",
-    "ios",
-    "android"
+    "react-native-library",
+    "react-native-otp",
+    "react-native-otp-auto-verify",
+    "react-native-sms",
+    "otp",
+    "otp-verification",
+    "otp-auto-verify",
+    "otp-auto-read",
+    "sms",
+    "sms-retriever",
+    "google-sms-retriever",
+    "android-otp",
+    "ios-otp",
+    "otp-without-permission",
+    "play-store-compliant",
+    "react-native-new-architecture",
+    "turbo-module"
   ],
-  "homepage": "https://github.com/kailas-rathod/react-native-otp-auto-verify#readme",
+  "homepage": "https://github.com/kailas-rathod/react-native-otp-auto-verify?tab=readme-ov-file",
   "bugs": {
     "url": "https://github.com/kailas-rathod/react-native-otp-auto-verify/issues"
   },
@@ -17,20 +32,15 @@
   },
   "license": "MIT",
   "author": "Kailas Rathod (https://github.com/kailas-rathod)",
-  "type": "commonjs",
-  "exports": {
-    ".": {
-      "source": "./src/index.tsx",
-      "types": "./lib/typescript/src/index.d.ts",
-      "default": "./lib/module/index.js"
-    },
-    "./package.json": "./package.json"
+  "engines": {
+    "node": ">=18"
   },
+  "workspaces": [
+    "example"
+  ],
+  "type": "commonjs",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
-  "directories": {
-    "example": "example"
-  },
   "files": [
     "src",
     "lib",
@@ -50,50 +60,26 @@
     "!**/__mocks__",
     "!**/.*"
   ],
-  "workspaces": [
-    "example"
-  ],
   "scripts": {
-    "example": "yarn workspace react-native-otp-auto-verify-example",
-    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
     "prepare": "bob build",
-    "typecheck": "tsc",
-    "lint": "eslint \"**/*.{js,ts,tsx}\"",
-    "test": "jest",
-    "release": "release-it --only-version"
-  },
-  "dependencies": {
-   
+    "prepublishOnly": "bob build",
+    "typecheck": "tsc"
   },
   "devDependencies": {
-    "@commitlint/config-conventional": "^19.8.1",
-    "@eslint/compat": "^1.3.2",
-    "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.35.0",
-    "@react-native/babel-preset": "0.83.0",
-    "@react-native/eslint-config": "0.83.0",
-    "@release-it/conventional-changelog": "^10.0.1",
-    "@types/jest": "^29.5.14",
+    "@react-native/babel-preset": "0.83.2",
     "@types/react": "^19.2.0",
-    "commitlint": "^19.8.1",
-    "del-cli": "^6.0.0",
-    "eslint": "^9.35.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "jest": "^29.7.0",
-    "lefthook": "^2.0.3",
-    "prettier": "^2.8.8",
     "react": "19.2.0",
-    "react-native": "0.83.0",
-    "react-native-builder-bob": "0.39.1",
-    "release-it": "^19.0.4",
-    "turbo": "^2.5.6",
+    "react-native": "0.83.2",
+    "react-native-builder-bob": "0.40.18",
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
     "react": "*",
     "react-native": "*"
   },
+  "resolutions": {
+    "glob": "11.1.0"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
@@ -123,54 +109,5 @@
     "android": {
       "javaPackageName": "com.otpautoverify"
     }
-  },
-  "prettier": {
-    "quoteProps": "consistent",
-    "singleQuote": true,
-    "tabWidth": 2,
-    "trailingComma": "es5",
-    "useTabs": false
-  },
-  "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"
-        }
-      }
-    }
-  },
-  "create-react-native-library": {
-    "type": "turbo-module",
-    "languages": "kotlin-objc",
-    "tools": [
-      "eslint",
-      "jest",
-      "lefthook",
-      "release-it"
-    ],
-    "version": "0.57.0"
   }
 }

package/src/index.tsx

@@ -37,6 +37,8 @@ export interface UseOtpVerificationResult {
   sms: string | null;
   /** True when the 5-minute SMS Retriever timeout occurred. */
   timeoutError: boolean;
+  /** Set when getHash fails (non-fatal) or when startListening fails. Cleared when startListening is called again. */
+  error: Error | null;
   /** Start listening for OTP again (e.g. after timeout or error). */
   startListening: () => Promise<void>;
   /** Stop listening and clean up. Call on unmount. */
@@ -53,7 +55,9 @@ export function extractOtp(
   numberOfDigits: OtpDigits = DEFAULT_DIGITS
 ): string | null {
   if (!sms || typeof sms !== 'string') return null;
-  const match = sms.match(OTP_REGEX[numberOfDigits]);
+  const trimmed = sms.trim();
+  if (!trimmed) return null;
+  const match = trimmed.match(OTP_REGEX[numberOfDigits]);
   return match ? match[1]! : null;
 }
 
@@ -98,7 +102,7 @@ export function removeListener(): void {
   }
 }
 
-/** Hook for OTP verification. Stops listener on unmount. */
+/** Hook for OTP verification. Call startListening() to begin; listener is stopped on unmount. */
 export function useOtpVerification(
   options: UseOtpVerificationOptions = {}
 ): UseOtpVerificationResult {
@@ -107,6 +111,7 @@ export function useOtpVerification(
   const [otp, setOtp] = React.useState<string | null>(null);
   const [sms, setSms] = React.useState<string | null>(null);
   const [timeoutError, setTimeoutError] = React.useState(false);
+  const [error, setError] = React.useState<Error | null>(null);
   const subscriptionRef = React.useRef<OtpListenerSubscription | null>(null);
 
   const stopListening = React.useCallback(() => {
@@ -120,15 +125,16 @@ export function useOtpVerification(
     setOtp(null);
     setSms(null);
     setTimeoutError(false);
+    setError(null);
     try {
       const hashes = await getHash();
       setHashCode(hashes[0] ?? '');
-    } catch {
-      // getHash failed; continue to start listener
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
     }
     try {
       const sub = await activateOtpListener(
-        (smsText: string, extractedOtp: string | null | undefined) => {
+        (smsText, extractedOtp) => {
           setSms(smsText);
           if (smsText === TIMEOUT_MESSAGE) {
             setTimeoutError(true);
@@ -139,9 +145,11 @@ export function useOtpVerification(
         { numberOfDigits }
       );
       subscriptionRef.current = sub;
-    } catch {
+    } catch (err) {
       subscriptionRef.current = null;
-      throw new Error('Failed to start OTP listener');
+      const wrapped = new Error('Failed to start OTP listener', { cause: err });
+      setError(wrapped);
+      throw wrapped;
     }
   }, [numberOfDigits]);
 
@@ -153,10 +161,11 @@ export function useOtpVerification(
       otp,
       sms,
       timeoutError,
+      error,
       startListening,
       stopListening,
     }),
-    [hashCode, otp, sms, timeoutError, startListening, stopListening]
+    [hashCode, otp, sms, timeoutError, error, startListening, stopListening]
   );
 }
 

package/lib/module/NativeOtpAutoVerify.ts

@@ -1,11 +0,0 @@
-import { TurboModuleRegistry, type TurboModule } from 'react-native';
-
-export interface Spec extends TurboModule {
-  getConstants(): { OTP_RECEIVED_EVENT: string };
-  getHash(): Promise<ReadonlyArray<string>>;
-  startSmsRetriever(): Promise<boolean>;
-  addListener(eventName: string): void;
-  removeListeners(count: number): void;
-}
-
-export default TurboModuleRegistry.getEnforcing<Spec>('OtpAutoVerify');