@davicm/react-native-otp-verify
v1.1.4
Published
Otp verify
Downloads
1
Readme
React Native Otp Verify ✉️
- 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.
Please read the official documentation for the message structure at this Google developer guide
Quick start 🔥
Installation
$ npm install react-native-otp-verify --save
or
$ yarn add react-native-otp-verify
Usage
Import the Library
import {
getHash,
startOtpListener,
useOtpVerify,
} from 'react-native-otp-verify';
Using Hook
// You can use the startListener and stopListener to manually trigger listeners again.
// optionally pass numberOfDigits if you want to extract otp
const { hash, otp, message, timeoutError, stopListener, startListener } = useOtpVerify({numberOfDigits: 4});
Properties
| Property | Type | Description |
| ------------- |:-------------:|:-------------:|
| hash | string[] | The hash code for the application which should be added at the end of message.|
| otp | string | OTP retreived from SMS when received. (Must pass numberOfDigits
) |
| message | string | SMS message when received. |
| timeoutError | boolean | Flag is set to true when after timeout (5 minutes) Check here |
| startListener | function | Manually starts listener again in case of timeout or any other error |
| stopListener | function | Stops listener for the sms |
Using Methods
// using methods
useEffect(() => {
getHash().then(hash => {
// use this hash in the message.
}).catch(console.log);
startOtpListener(message => {
// extract the otp using regex e.g. the below regex extracts 4 digit otp from message
const otp = /(\d{4})/g.exec(message)[1];
setOtp(otp);
});
return () => removeListener();
}, []);
Example
See the example app in example
folder.
Auto Linking for React Native >= 0.60
Linking the package manually is not required anymore with Autolinking.
Manual Linking
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.faizal.OtpVerify.OtpVerifyPackage;
to the imports at the top of the file - Add
new OtpVerifyPackage()
to the list returned by thegetPackages()
method
- Append the following lines to
android/settings.gradle
:include ':react-native-otp-verify' project(':react-native-otp-verify').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-otp-verify/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:implementation project(':react-native-otp-verify')
Methods
requestHint: () => Promise<string>
Gets phone number in a frictionless way to show a user’s (SIM-based) phone numbers as a hint. Check here
startOtpListener(handler:(message:string)=>any):Promise<Subscription>
Start listening for OTP/SMS and adds listener for the handler passed which is called when message is received..
getOtp():Promise<boolean>
Start listening for OTP/SMS. Return true if listener starts else throws error.
getHash():Promise<string[]>
Gets the hash code for the application which should be added at the end of message. This is just a one time process.
addListener(handler:(message:string)=>any):Subscription
Adds a javascript listener to the handler passed which is called when message is received.
removeListener():void
Removes all listeners.