@peacechen/react-native-otp-autocomplete
v1.1.3
Published
React native sms verification without additional permissions.
Downloads
328
Maintainers
Readme
react-native-otp-autocomplete
This is a fork of https://github.com/jmlavoier/react-native-otp-autocomplete and published as a separate package on [npmjs.com](https://www.npmjs.com/package/@peacechen/react-native-otp-autocomplete to unlock the peer dependencies. That package was forked from react-native-otp-verify which was deprecated.
It uses Automatic SMS Verification with the SMS Retriever API. 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
Getting started
$ npm install @peacechen/react-native-otp-autocomplete --save
or
$ yarn @peacechen/react-native-otp-autocomplete
Using React Native Link (React Native 0.59 and lower)
$ react-native link @peacechen/react-native-otp-autocomplete
Manual installation (Android)
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.jmlavoier.OtpAutocomplete.RNOtpAutocompletePackage;
to the imports at the top of the file - Add
new RNOtpAutocompletePackage()
to the list returned by thegetPackages()
method
- Append the following lines to
android/settings.gradle
:include ':@peacechen/react-native-otp-autocomplete' project(':@peacechen/react-native-otp-autocomplete').projectDir = new File(rootProject.projectDir, '../node_modules/@peacechen/react-native-otp-autocomplete/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:compile project(':@peacechen/react-native-otp-autocomplete')
Usage
import OtpAutocomplete from '@peacechen/react-native-otp-autocomplete';
const getHash = () =>
OtpAutocomplete.getHash()
.then(console.log)
.catch(console.log);
const startListeningForOtp = () =>
OtpAutocomplete.getOtp()
.then(p => OtpAutocomplete.addListener(otpHandler))
.catch(p => console.log(p));
const otpHandler = (message: string) => {
const otp = /(\d{4})/g.exec(message)[1];
this.setState({ otp });
OtpAutocomplete.removeListener();
Keyboard.dismiss();
}
useEffet(() => {
startListeningForOtp();
return () => OtpAutocomplete.removeListener();
}, [startListeningForOtp]);
Methods
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):Promise<boolean>
Adds a javascript listener to the handler passed which is called when message is received.
removeListener():void
Removes the listener.