dojah-kyc-sdk-react_native 0.0.7-dev → 0.0.8-dev

package/README.md

@@ -124,23 +124,125 @@ To start KYC, import Dojah in your React Native code, and launch Dojah Screen
 ```js
 import {launchDojahKyc } from 'dojah-kyc-sdk-react_native';
 
-launchDojahKyc(
-  "{Required: Your_WidgetID}",
-  "{Optional: Reference_ID}",
-  “{Optional: Email_Address}”
-)
-
-
-
-//Example (If you're not passing Reference_ID and Email_Address values)
-
-//launchDojahKyc("1234678901234", "DJ-123456", "abc@gmail.com")
-
-
-//Example (If you're not passing Reference_ID and Email_Address values)
-
-//launchDojahKyc("1234678901234", null, null)
 
+/** 
+ * The following parameters are available 
+ * for launching the flow.
+*/
+
+/**
+* This is your widget ID, a unique identifier for your Dojah flow. You can find it in your Dojah Dashboard after creating and publishing a flow. Replace `'your-widget-id'` with the actual widget ID from your dashboard.
+*/
+const widgetId = 'your-widget-id';
+
+/**
+ * Reference ID: This is an optional parameter that allows you to initialize the SDK for an ongoing verification process.
+ */
+const referenceId = 'your-reference-id';
+
+/**
+ * Email: This is an optional parameter that allows you to initialize the SDK with the user's email address.
+ */
+const email = 'your-email@example.com';
+
+/**
+ * User Data: This object contains personal information about the user, such as their first name, last name, date of birth, and email.
+ */
+const userData = {
+  firstName: 'John',
+  lastName: 'Doe',
+  dob: '1990-01-01',
+  email: email
+};
+
+/**
+ * Government Data: This object contains government-issued identifiers such as BVN, driver's license, NIN, and voter ID.
+ */
+const govData = {
+  bvn: 'your-bvn',
+  dl: 'your-dl',
+  nin: 'your-nin',
+  vnin: 'your-vnin'
+};
+
+/**
+ * Government ID: This object contains various types of government-issued IDs, such as national ID, passport, driver's license, voter ID, and others.
+ */
+const govId = {
+  national: 'your-national-id',
+  passport: 'your-passport-id',
+  dl: 'your-dl-id',
+  voter: 'your-voter-id',
+  nin: 'your-nin-id',
+  others: 'your-others-id'
+};
+
+/**
+ * Location: This object contains the latitude and longitude of the user's location, which can be used for address verification.
+ */
+const location = {
+  latitude: 'your-latitude',
+  longitude: 'your-longitude'
+};
+
+/**
+ * Business Data: This object contains business-related information, such as the CAC (Corporate Affairs Commission) registration number.
+ */
+const businessData = {
+  cac: 'your-cac'
+};
+
+/**
+ * Address: This is the user's address, which can be used for address verification.
+ */
+const address = 'your-address';
+
+/**
+ * Metadata: This object contains additional key-value pairs that can be used to pass custom data to the SDK.
+ */
+const metadata = {
+  key1: 'value1',
+  key2: 'value2'
+};
+
+/** 
+ * to launch the flow only [widgetId] is mandatory  
+ * @returns - the Promise of the result, promise
+ * will return a status that you can use to track 
+ * the immidiate progress. 
+ * @throws - an error if the Dojah KYC flow fails
+*/
+launchDojahKyc(
+      widgetId,
+      ref,
+      mail,
+      userData,
+      govData,
+      govId,
+      location,
+      businessData,
+      address,
+      metadata)
+.then((status) => {
+  console.log('Result: ', status);
+  switch(result){
+    case 'approved':
+      //kyc approved
+      console.log('KYC Approved');
+      break;
+    case 'pending':
+      //kyc pending
+      console.log('KYC Pending');
+      break;
+    case 'failed':
+      //kyc failed
+      console.log('KYC Failed');
+      break;
+    case 'closed':
+      //user has cancelled the KYC
+      console.log('KYC Closed');
+  }
+});
 
 ```
 

package/android/build.gradle

@@ -104,8 +104,8 @@ dependencies {
   implementation "com.facebook.react:react-native:+"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
 
-  implementation 'com.github.dojah-inc:sdk-kotlin:v0.0.1-dev'
-  // implementation 'com.github.dojah-inc:sdk-kotlin:v0.0.3'
+  // implementation 'com.github.dojah-inc:sdk-kotlin:v0.0.1-dev'
+  implementation 'com.github.dojah-inc:sdk-kotlin:v0.0.4-dev'
 
 
 }

package/android/src/main/java/com/dojahkyc/DojahKycModule.kt

@@ -1,46 +1,134 @@
 package com.dojahkyc
 
+import android.app.Activity
+import android.app.Activity.RESULT_OK
+import android.content.Intent
+import android.widget.Toast
 import com.dojah.kyc_sdk_kotlin.DojahSdk
-import com.facebook.react.bridge.LifecycleEventListener
+import com.dojah.kyc_sdk_kotlin.DOJAH_RESULT_KEY
+// import com.dojah.kyc_sdk_kotlin.BACKWARD_CALL_REQUEST_CODE
+import com.dojah.kyc_sdk_kotlin.domain.ExtraUserData
+import com.facebook.react.bridge.ActivityEventListener
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
 import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.WritableMap
 import com.facebook.react.bridge.WritableNativeMap
+import androidx.activity.result.ActivityResult
+import androidx.activity.result.ActivityResultLauncher
+import androidx.activity.result.contract.ActivityResultContracts
+import com.facebook.react.bridge.ReadableMap
+import com.dojah.kyc_sdk_kotlin.domain.UserData
+import com.dojah.kyc_sdk_kotlin.domain.GovData
+import com.dojah.kyc_sdk_kotlin.domain.GovId
+import com.dojah.kyc_sdk_kotlin.domain.Location
+import com.dojah.kyc_sdk_kotlin.domain.BusinessData
 
+const val BACKWARD_CALL_REQUEST_CODE = 1001
 
 class DojahKycModule(private val reactContext: ReactApplicationContext) :
-  ReactContextBaseJavaModule(reactContext) {
+  ReactContextBaseJavaModule(reactContext), ActivityEventListener{
 
+  var promise: Promise? = null
+
+  init {
+        reactContext.addActivityEventListener(this)
+    }
   override fun getName(): String {
     return NAME
   }
 
   // Example method
   // See https://reactnative.dev/docs/native-modules-android
-  @ReactMethod
+  @ReactMethod()
   fun launch(
     widgetId: String,
     referenceId: String? = null,
     email: String? = null,
+    userData: ReadableMap? = null,
+    govData: ReadableMap? = null,
+    govId: ReadableMap? = null,
+    location: ReadableMap? = null,
+    businessData: ReadableMap? = null,
+    address: String? = null,
+    metadata: ReadableMap? = null,
     promise: Promise
   ) {
-    DojahSdk.with(reactContext).launch(widgetId, referenceId, email)
-    promise.resolve("Launched Dojah SDK")
+    val activity = currentActivity
+
+    if (activity == null) {
+      promise.reject("D_ACTIVITY_DOES_NOT_EXIST", "Activity doesn't exist")
+      return
+    }
+    this.promise = promise
+    try {
+      DojahSdk.with(reactContext)
+        .launchWithBackwardCompatibility(activity, widgetId, referenceId, email, extraData = ExtraUserData(
+          userData = UserData(
+            firstName = userData?.getString("firstName"),
+            lastName = userData?.getString("lastName"),
+            dob = userData?.getString("dob"),
+            email = userData?.getString("email")
+          ),
+          govData = GovData(
+            bvn = govData?.getString("bvn"),
+            dl = govData?.getString("dl"),
+            nin = govData?.getString("nin"),
+            vnin = govData?.getString("vnin")
+          ),
+          govId = GovId(
+            national = govId?.getString("national"),
+            passport = govId?.getString("passport"),
+            dl = govId?.getString("dl"),
+            voter = govId?.getString("voter"),
+            nin = govId?.getString("nin"),
+            others = govId?.getString("others")
+          ),
+          location = Location(
+            latitude = location?.getString("latitude"),
+            longitude = location?.getString("longitude")
+          ),
+          businessData = BusinessData(
+            cac = businessData?.getString("cac")
+          ),
+          address = address,
+          metadata = metadata?.toHashMap()
+        ))
+    } catch (e: Exception) {
+        // this.promise.reject("LAUNCH_ERROR", e.message, e)
+        // this.promise = null
+    }
+    
   }
 
+
+
   @ReactMethod
   fun getIdHistory(promise: Promise) {
     val writeMap: WritableMap = WritableNativeMap()
     DojahSdk.with(reactContext).getIdHistory().forEach {
       writeMap.putString(it.first, it.second)
     }
-
     promise.resolve(writeMap)
   }
 
 
+  override fun onActivityResult(activity:Activity?,requestCode: Int, resultCode: Int, data: Intent?) {
+    if (requestCode == BACKWARD_CALL_REQUEST_CODE) {
+        if (resultCode == Activity.RESULT_OK) {
+            val result = data?.getStringExtra(DOJAH_RESULT_KEY)
+            promise?.resolve(result)
+        } else {
+            promise?.reject("RESULT_FAILED", "Activity did not return OK")
+        }
+        promise = null
+    }
+  }
+
+  override fun onNewIntent(intent: Intent?) {
+  }
+
   companion object {
     const val NAME = "DojahKyc"
   }

package/lib/commonjs/index.js

@@ -16,21 +16,81 @@ const DojahKyc = _reactNative.NativeModules.DojahKyc ? _reactNative.NativeModule
   }
 });
 
-/// Initialize Dojah KYC for IOS,
-/// call this before your app is registered
-/// the Sdk won't work on IOS without this
-/// @param appName: the name of your app
-// export function initializeDojahIOS(appName: string) {
-// if(Platform.OS === 'ios'){
-//   DojahKyc.initialize(appName);
-// }
-// }
+/**
+ * Launches the Dojah KYC flow
+ * @param widgetId - The widget ID to be used
+ * @param referenceId (optional) - The reference ID to be used
+ * @param email (optional) - The email to be used
+ * @param userData (optional) - your user data if available
+ * @param govData (optional) - your government data if available
+ * @param govId (optional) - your government ID data if available
+ * @param location (optional) - your location data if available
+ * @param businessData (optional) - your business data if available
+ * @param address (optional) - your address data if available
+ * @param metadata (optional) - your metadata data if any
+ * @returns - the Promise of the result
+ * @throws - an error if the Dojah KYC flow fails
+ * @example
+ * 
+ * ```typescript
+ * import { launchDojahKyc } from 'dojah-kyc-sdk-react_native';
+ * const widgetId = 'your-widget-id';
+ * const referenceId = 'your-reference-id';
+ * const email = 'your-email@example.com';
+ * const userData = {
+ *   firstName: 'John',
+ *   lastName: 'Doe',
+ *   dob: '1990-01-01',
+ *   email: email
+ * };
+ * const govData = {
+ *   bvn: 'your-bvn',
+ *   dl: 'your-dl',
+ *   nin: 'your-nin',
+ *   vnin: 'your-vnin'
+ * };
+ * const govId = {
+ *   national: 'your-national-id',
+ *   passport: 'your-passport-id',
+ *   dl: 'your-dl-id',
+ *   voter: 'your-voter-id',
+ *   nin: 'your-nin-id',
+ *   others: 'your-others-id'
+ * };
+ * const location = {
+ *   latitude: 'your-latitude',
+ *   longitude: 'your-longitude'
+ * };
+ * const businessData = {
+ *   cac: 'your-cac'
+ * };
+ * const address = 'your-address';
+ * const metadata = {
+ *   key1: 'value1',
+ *   key2: 'value2'
+ * };
+ * launchDojahKyc(widgetId, referenceId, email, userData, govData, govId, location, businessData, address, metadata)
+ *   .then((result) => {
+ *     console.log('Result: ', result);
+ *   })
+ *   .catch((error) => {
+ *     console.error('Error: ', error);
+ *   });
+ * ```
+**/
 
-function launchDojahKyc(widgetId, referenceId, email) {
+function launchDojahKyc(widgetId, referenceId, email, userData = null, govData = null, govId = null, location = null, businessData = null, address = null, metadata = null) {
   if (_reactNative.Platform.OS === 'ios') {
-    DojahKyc.launch(widgetId, referenceId ?? '', email ?? '');
+    return new Promise((resolve, reject) => {
+      try {
+        DojahKyc.launch(widgetId, referenceId ?? '', email ?? '');
+        resolve("launched"); // Adjust this based on the actual return value of DojahKyc.launch
+      } catch (error) {
+        reject("closed");
+      }
+    });
   } else {
-    DojahKyc.launch(widgetId, referenceId, email);
+    return DojahKyc.launch(widgetId, referenceId, email, userData, govData, govId, location, businessData, address, metadata);
   }
 }
 function getIdHistory() {

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","default","DojahKyc","NativeModules","Proxy","get","Error","launchDojahKyc","widgetId","referenceId","email","OS","launch","getIdHistory"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA,MAAMC,aAAa,GACjB,qFAAqF,GACrFC,qBAAQ,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,QAAQ,GAAGC,0BAAa,CAACD,QAAQ,GACnCC,0BAAa,CAACD,QAAQ,GACtB,IAAIE,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACT,aAAa,CAAC;EAChC;AACF,CACF,CAAC;;AAEL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,SAASU,cAAcA,CAC5BC,QAAgB,EAChBC,WAA2B,EAC3BC,KAAqB,EACrB;EACA,IAAIZ,qBAAQ,CAACa,EAAE,KAAK,KAAK,EAAE;IACzBT,QAAQ,CAACU,MAAM,CAACJ,QAAQ,EAAEC,WAAW,IAAI,EAAE,EAAEC,KAAK,IAAI,EAAE,CAAC;EAC3D,CAAC,MAAM;IACLR,QAAQ,CAACU,MAAM,CAACJ,QAAQ,EAAEC,WAAW,EAAEC,KAAK,CAAC;EAC/C;AACF;AAEO,SAASG,YAAYA,CAAA,EAAwC;EAClE,OAAOX,QAAQ,CAACW,YAAY,CAAC,CAAC;AAChC","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","default","DojahKyc","NativeModules","Proxy","get","Error","launchDojahKyc","widgetId","referenceId","email","userData","govData","govId","location","businessData","address","metadata","OS","Promise","resolve","reject","launch","error","getIdHistory"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA,MAAMC,aAAa,GACjB,qFAAqF,GACrFC,qBAAQ,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,QAAQ,GAAGC,0BAAa,CAACD,QAAQ,GACnCC,0BAAa,CAACD,QAAQ,GACtB,IAAIE,KAAK,CACT,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACT,aAAa,CAAC;EAChC;AACF,CACF,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEO,SAASU,cAAcA,CAC5BC,QAAgB,EAChBC,WAA2B,EAC3BC,KAAqB,EACrBC,QAAuB,GAAG,IAAI,EAC9BC,OAAsB,GAAG,IAAI,EAC7BC,KAAoB,GAAG,IAAI,EAC3BC,QAAuB,GAAG,IAAI,EAC9BC,YAA2B,GAAG,IAAI,EAClCC,OAAsB,GAAG,IAAI,EAC7BC,QAAuB,GAAG,IAAI,EACN;EACxB,IAAInB,qBAAQ,CAACoB,EAAE,KAAK,KAAK,EAAE;IACzB,OAAO,IAAIC,OAAO,CAAgB,CAACC,OAAO,EAAEC,MAAM,KAAK;MACrD,IAAI;QACFnB,QAAQ,CAACoB,MAAM,CAACd,QAAQ,EAAEC,WAAW,IAAI,EAAE,EAAEC,KAAK,IAAI,EAAE,CAAC;QACzDU,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;MACvB,CAAC,CAAC,OAAOG,KAAK,EAAE;QACdF,MAAM,CAAC,QAAQ,CAAC;MAClB;IACF,CAAC,CAAC;EACJ,CAAC,MAAM;IACL,OAAOnB,QAAQ,CAACoB,MAAM,CAACd,QAAQ,EAAEC,WAAW,EAAEC,KAAK,EAAEC,QAAQ,EAAEC,OAAO,EAAEC,KAAK,EAAEC,QAAQ,EAAEC,YAAY,EAAEC,OAAO,EAAEC,QAAQ,CAAC;EAC3H;AACF;AAEO,SAASO,YAAYA,CAAA,EAAwC;EAClE,OAAOtB,QAAQ,CAACsB,YAAY,CAAC,CAAC;AAChC","ignoreList":[]}

package/lib/module/index.js

@@ -9,21 +9,81 @@ const DojahKyc = NativeModules.DojahKyc ? NativeModules.DojahKyc : new Proxy({},
   }
 });
 
-/// Initialize Dojah KYC for IOS,
-/// call this before your app is registered
-/// the Sdk won't work on IOS without this
-/// @param appName: the name of your app
-// export function initializeDojahIOS(appName: string) {
-// if(Platform.OS === 'ios'){
-//   DojahKyc.initialize(appName);
-// }
-// }
+/**
+ * Launches the Dojah KYC flow
+ * @param widgetId - The widget ID to be used
+ * @param referenceId (optional) - The reference ID to be used
+ * @param email (optional) - The email to be used
+ * @param userData (optional) - your user data if available
+ * @param govData (optional) - your government data if available
+ * @param govId (optional) - your government ID data if available
+ * @param location (optional) - your location data if available
+ * @param businessData (optional) - your business data if available
+ * @param address (optional) - your address data if available
+ * @param metadata (optional) - your metadata data if any
+ * @returns - the Promise of the result
+ * @throws - an error if the Dojah KYC flow fails
+ * @example
+ * 
+ * ```typescript
+ * import { launchDojahKyc } from 'dojah-kyc-sdk-react_native';
+ * const widgetId = 'your-widget-id';
+ * const referenceId = 'your-reference-id';
+ * const email = 'your-email@example.com';
+ * const userData = {
+ *   firstName: 'John',
+ *   lastName: 'Doe',
+ *   dob: '1990-01-01',
+ *   email: email
+ * };
+ * const govData = {
+ *   bvn: 'your-bvn',
+ *   dl: 'your-dl',
+ *   nin: 'your-nin',
+ *   vnin: 'your-vnin'
+ * };
+ * const govId = {
+ *   national: 'your-national-id',
+ *   passport: 'your-passport-id',
+ *   dl: 'your-dl-id',
+ *   voter: 'your-voter-id',
+ *   nin: 'your-nin-id',
+ *   others: 'your-others-id'
+ * };
+ * const location = {
+ *   latitude: 'your-latitude',
+ *   longitude: 'your-longitude'
+ * };
+ * const businessData = {
+ *   cac: 'your-cac'
+ * };
+ * const address = 'your-address';
+ * const metadata = {
+ *   key1: 'value1',
+ *   key2: 'value2'
+ * };
+ * launchDojahKyc(widgetId, referenceId, email, userData, govData, govId, location, businessData, address, metadata)
+ *   .then((result) => {
+ *     console.log('Result: ', result);
+ *   })
+ *   .catch((error) => {
+ *     console.error('Error: ', error);
+ *   });
+ * ```
+**/
 
-export function launchDojahKyc(widgetId, referenceId, email) {
+export function launchDojahKyc(widgetId, referenceId, email, userData = null, govData = null, govId = null, location = null, businessData = null, address = null, metadata = null) {
   if (Platform.OS === 'ios') {
-    DojahKyc.launch(widgetId, referenceId ?? '', email ?? '');
+    return new Promise((resolve, reject) => {
+      try {
+        DojahKyc.launch(widgetId, referenceId ?? '', email ?? '');
+        resolve("launched"); // Adjust this based on the actual return value of DojahKyc.launch
+      } catch (error) {
+        reject("closed");
+      }
+    });
   } else {
-    DojahKyc.launch(widgetId, referenceId, email);
+    return DojahKyc.launch(widgetId, referenceId, email, userData, govData, govId, location, businessData, address, metadata);
   }
 }
 export function getIdHistory() {

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","Platform","LINKING_ERROR","select","ios","default","DojahKyc","Proxy","get","Error","launchDojahKyc","widgetId","referenceId","email","OS","launch","getIdHistory"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AAEtD,MAAMC,aAAa,GACjB,qFAAqF,GACrFD,QAAQ,CAACE,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,QAAQ,GAAGN,aAAa,CAACM,QAAQ,GACnCN,aAAa,CAACM,QAAQ,GACtB,IAAIC,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACP,aAAa,CAAC;EAChC;AACF,CACF,CAAC;;AAEL;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASQ,cAAcA,CAC5BC,QAAgB,EAChBC,WAA2B,EAC3BC,KAAqB,EACrB;EACA,IAAIZ,QAAQ,CAACa,EAAE,KAAK,KAAK,EAAE;IACzBR,QAAQ,CAACS,MAAM,CAACJ,QAAQ,EAAEC,WAAW,IAAI,EAAE,EAAEC,KAAK,IAAI,EAAE,CAAC;EAC3D,CAAC,MAAM;IACLP,QAAQ,CAACS,MAAM,CAACJ,QAAQ,EAAEC,WAAW,EAAEC,KAAK,CAAC;EAC/C;AACF;AAEA,OAAO,SAASG,YAAYA,CAAA,EAAwC;EAClE,OAAOV,QAAQ,CAACU,YAAY,CAAC,CAAC;AAChC","ignoreList":[]}
+{"version":3,"names":["NativeModules","Platform","LINKING_ERROR","select","ios","default","DojahKyc","Proxy","get","Error","launchDojahKyc","widgetId","referenceId","email","userData","govData","govId","location","businessData","address","metadata","OS","Promise","resolve","reject","launch","error","getIdHistory"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AAEtD,MAAMC,aAAa,GACjB,qFAAqF,GACrFD,QAAQ,CAACE,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,QAAQ,GAAGN,aAAa,CAACM,QAAQ,GACnCN,aAAa,CAACM,QAAQ,GACtB,IAAIC,KAAK,CACT,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACP,aAAa,CAAC;EAChC;AACF,CACF,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASQ,cAAcA,CAC5BC,QAAgB,EAChBC,WAA2B,EAC3BC,KAAqB,EACrBC,QAAuB,GAAG,IAAI,EAC9BC,OAAsB,GAAG,IAAI,EAC7BC,KAAoB,GAAG,IAAI,EAC3BC,QAAuB,GAAG,IAAI,EAC9BC,YAA2B,GAAG,IAAI,EAClCC,OAAsB,GAAG,IAAI,EAC7BC,QAAuB,GAAG,IAAI,EACN;EACxB,IAAInB,QAAQ,CAACoB,EAAE,KAAK,KAAK,EAAE;IACzB,OAAO,IAAIC,OAAO,CAAgB,CAACC,OAAO,EAAEC,MAAM,KAAK;MACrD,IAAI;QACFlB,QAAQ,CAACmB,MAAM,CAACd,QAAQ,EAAEC,WAAW,IAAI,EAAE,EAAEC,KAAK,IAAI,EAAE,CAAC;QACzDU,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;MACvB,CAAC,CAAC,OAAOG,KAAK,EAAE;QACdF,MAAM,CAAC,QAAQ,CAAC;MAClB;IACF,CAAC,CAAC;EACJ,CAAC,MAAM;IACL,OAAOlB,QAAQ,CAACmB,MAAM,CAACd,QAAQ,EAAEC,WAAW,EAAEC,KAAK,EAAEC,QAAQ,EAAEC,OAAO,EAAEC,KAAK,EAAEC,QAAQ,EAAEC,YAAY,EAAEC,OAAO,EAAEC,QAAQ,CAAC;EAC3H;AACF;AAEA,OAAO,SAASO,YAAYA,CAAA,EAAwC;EAClE,OAAOrB,QAAQ,CAACqB,YAAY,CAAC,CAAC;AAChC","ignoreList":[]}

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

@@ -1,3 +1,65 @@
-export declare function launchDojahKyc(widgetId: string, referenceId?: string | null, email?: string | null): void;
+/**
+ * Launches the Dojah KYC flow
+ * @param widgetId - The widget ID to be used
+ * @param referenceId (optional) - The reference ID to be used
+ * @param email (optional) - The email to be used
+ * @param userData (optional) - your user data if available
+ * @param govData (optional) - your government data if available
+ * @param govId (optional) - your government ID data if available
+ * @param location (optional) - your location data if available
+ * @param businessData (optional) - your business data if available
+ * @param address (optional) - your address data if available
+ * @param metadata (optional) - your metadata data if any
+ * @returns - the Promise of the result
+ * @throws - an error if the Dojah KYC flow fails
+ * @example
+ *
+ * ```typescript
+ * import { launchDojahKyc } from 'dojah-kyc-sdk-react_native';
+ * const widgetId = 'your-widget-id';
+ * const referenceId = 'your-reference-id';
+ * const email = 'your-email@example.com';
+ * const userData = {
+ *   firstName: 'John',
+ *   lastName: 'Doe',
+ *   dob: '1990-01-01',
+ *   email: email
+ * };
+ * const govData = {
+ *   bvn: 'your-bvn',
+ *   dl: 'your-dl',
+ *   nin: 'your-nin',
+ *   vnin: 'your-vnin'
+ * };
+ * const govId = {
+ *   national: 'your-national-id',
+ *   passport: 'your-passport-id',
+ *   dl: 'your-dl-id',
+ *   voter: 'your-voter-id',
+ *   nin: 'your-nin-id',
+ *   others: 'your-others-id'
+ * };
+ * const location = {
+ *   latitude: 'your-latitude',
+ *   longitude: 'your-longitude'
+ * };
+ * const businessData = {
+ *   cac: 'your-cac'
+ * };
+ * const address = 'your-address';
+ * const metadata = {
+ *   key1: 'value1',
+ *   key2: 'value2'
+ * };
+ * launchDojahKyc(widgetId, referenceId, email, userData, govData, govId, location, businessData, address, metadata)
+ *   .then((result) => {
+ *     console.log('Result: ', result);
+ *   })
+ *   .catch((error) => {
+ *     console.error('Error: ', error);
+ *   });
+ * ```
+**/
+export declare function launchDojahKyc(widgetId: string, referenceId?: string | null, email?: string | null, userData?: Object | null, govData?: Object | null, govId?: Object | null, location?: Object | null, businessData?: Object | null, address?: string | null, metadata?: Object | null): Promise<string | null>;
 export declare function getIdHistory(): Promise<Map<string, string> | null>;
 //# 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":"AA6BA,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,QAOtB;AAED,wBAAgB,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAElE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAmBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AAEH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,EAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,OAAO,GAAE,MAAM,GAAG,IAAW,EAC7B,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,YAAY,GAAE,MAAM,GAAG,IAAW,EAClC,OAAO,GAAE,MAAM,GAAG,IAAW,EAC7B,QAAQ,GAAE,MAAM,GAAG,IAAW,GAC7B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED,wBAAgB,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAElE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dojah-kyc-sdk-react_native",
-  "version": "0.0.7-dev",
+  "version": "0.0.8-dev",
   "description": "Dojah SDK",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/index.tsx

@@ -9,33 +9,100 @@ const LINKING_ERROR =
 const DojahKyc = NativeModules.DojahKyc
   ? NativeModules.DojahKyc
   : new Proxy(
-      {},
-      {
-        get() {
-          throw new Error(LINKING_ERROR);
-        },
-      }
-    );
+    {},
+    {
+      get() {
+        throw new Error(LINKING_ERROR);
+      },
+    }
+  );
 
-/// Initialize Dojah KYC for IOS,
-/// call this before your app is registered
-/// the Sdk won't work on IOS without this
-/// @param appName: the name of your app
-// export function initializeDojahIOS(appName: string) {
-// if(Platform.OS === 'ios'){
-//   DojahKyc.initialize(appName);
-// }
-// }
+/**
+ * Launches the Dojah KYC flow
+ * @param widgetId - The widget ID to be used
+ * @param referenceId (optional) - The reference ID to be used
+ * @param email (optional) - The email to be used
+ * @param userData (optional) - your user data if available
+ * @param govData (optional) - your government data if available
+ * @param govId (optional) - your government ID data if available
+ * @param location (optional) - your location data if available
+ * @param businessData (optional) - your business data if available
+ * @param address (optional) - your address data if available
+ * @param metadata (optional) - your metadata data if any
+ * @returns - the Promise of the result
+ * @throws - an error if the Dojah KYC flow fails
+ * @example
+ * 
+ * ```typescript
+ * import { launchDojahKyc } from 'dojah-kyc-sdk-react_native';
+ * const widgetId = 'your-widget-id';
+ * const referenceId = 'your-reference-id';
+ * const email = 'your-email@example.com';
+ * const userData = {
+ *   firstName: 'John',
+ *   lastName: 'Doe',
+ *   dob: '1990-01-01',
+ *   email: email
+ * };
+ * const govData = {
+ *   bvn: 'your-bvn',
+ *   dl: 'your-dl',
+ *   nin: 'your-nin',
+ *   vnin: 'your-vnin'
+ * };
+ * const govId = {
+ *   national: 'your-national-id',
+ *   passport: 'your-passport-id',
+ *   dl: 'your-dl-id',
+ *   voter: 'your-voter-id',
+ *   nin: 'your-nin-id',
+ *   others: 'your-others-id'
+ * };
+ * const location = {
+ *   latitude: 'your-latitude',
+ *   longitude: 'your-longitude'
+ * };
+ * const businessData = {
+ *   cac: 'your-cac'
+ * };
+ * const address = 'your-address';
+ * const metadata = {
+ *   key1: 'value1',
+ *   key2: 'value2'
+ * };
+ * launchDojahKyc(widgetId, referenceId, email, userData, govData, govId, location, businessData, address, metadata)
+ *   .then((result) => {
+ *     console.log('Result: ', result);
+ *   })
+ *   .catch((error) => {
+ *     console.error('Error: ', error);
+ *   });
+ * ```
+**/
 
 export function launchDojahKyc(
   widgetId: string,
   referenceId?: string | null,
-  email?: string | null
-) {
+  email?: string | null,
+  userData: Object | null = null,
+  govData: Object | null = null,
+  govId: Object | null = null,
+  location: Object | null = null,
+  businessData: Object | null = null,
+  address: string | null = null,
+  metadata: Object | null = null
+): Promise<string | null> {
   if (Platform.OS === 'ios') {
-    DojahKyc.launch(widgetId, referenceId ?? '', email ?? '');
+    return new Promise<string | null>((resolve, reject) => {
+      try {
+        DojahKyc.launch(widgetId, referenceId ?? '', email ?? '');
+        resolve("launched"); // Adjust this based on the actual return value of DojahKyc.launch
+      } catch (error) {
+        reject("closed");
+      }
+    });
   } else {
-    DojahKyc.launch(widgetId, referenceId, email);
+    return DojahKyc.launch(widgetId, referenceId, email, userData, govData, govId, location, businessData, address, metadata);
   }
 }