@digiotech/react-native 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2023 Ramanand Sirvi
+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
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# Digio React Native SDK
+
+Official React Native SDK for Digio Gateway Integration
+
+## Installation
+
+```sh
+yarn install @digiotech/react-native
+```
+
+## Documentation
+
+Documentation of Digio Gateway Integration and their usage is available at <https://documentation.digio.in>
+
+### Basic Usage
+
+Instantiate the Digio instance with `environment` & other options
+
+```tsx
+import { Digio, DigioConfig, DigioResponse } from '@digiotech/react-native';
+
+const config: DigioConfig = { environment: Environment.PRODUCTION };
+const digio = new Digio(config);
+const documentId = "<document_id>";
+const identifier = "<email_or_phone>";
+const digioResponse: DigioResponse = await digio.start(documentId, identifier);
+```
+
+### Consuming gateway events [Optional]
+
+You can consume events and understand the flow or the journey of the user as he is performing it.
+
+For a complete list of events and the payload associated with it, refer [here](https://docs.google.com/document/d/15LHtjGyXd_JNM0de8uH9zB7WllJikRl1d9e4qdy0-C0/edit?usp=sharing)
+
+```tsx
+import { useEffect } from 'react';
+import { Digio, DigioConfig, GatewayEvent } from '@digiotech/react-native';
+
+function YourComponent() {
+  useEffect(() => {
+    const gatewayEventListener = digio.addGatewayEventListener(
+      (event: GatewayEvent) => {
+        // Do some operation on the received events
+      }
+    );
+
+    return () => {
+      gatewayEventListener.remove();
+    }
+  }, []);
+}
+```
+
+### Complete Usage
+
+```tsx
+import { useEffect } from 'react';
+import { Digio, DigioConfig, GatewayEvent } from '@digiotech/react-native';
+
+function YourComponent() {
+  useEffect(() => {
+    const gatewayEventListener = digio.addGatewayEventListener(
+      (event: GatewayEvent) => {
+        // Do some operation on the received events
+      }
+    );
+
+    return () => {
+      gatewayEventListener.remove();
+    }
+  }, []);
+
+  const triggerDigioGateway = async () => {
+    const config: DigioConfig = { environment: Environment.PRODUCTION };
+    const digio = new Digio(config);
+    const documentId = "<document_id>";
+    const identifier = "<email_or_phone>";
+    const tokenId = "<gateway_token_id";
+    const digioResponse: DigioResponse = await digio.start(documentId, identifier, tokenId);
+
+  }
+}
+```
+
+## SDK Reference
+
+### DigioConfig
+
+**Parameters:**
+
+| Name            | Type    | Description                                                                            |
+|-----------------|---------|----------------------------------------------------------------------------------------|
+| environment*    | string  | Environment for which you want to open gateway. One of `sandbox` or `production`       |
+| logo            | string  | Pass an URL of your brand logo. **Note:** Pass an optimised image url for best results |
+| theme           | string  | Options for changing the appearance of the gateway. See below for options under it.    |
+
+**Theme:**
+
+| Name           | Type    | Description                                                              |
+|----------------|---------|--------------------------------------------------------------------------|
+| primaryColor   | string  | Your brand colour's HEX code to alter CTA (call-to-action) button colors |
+| secondaryColor | string  | HEX Code to alter text colors                                            |
+| fontFamily     | string  | Font Family of your choice. For eg: Crimson Pro                          |
+| fontFormat     | string  | Format of the Font Family Provided. For eg: ’woff2’,’ot’,’tt’            |
+| fontUrl        | string  | Font Family URL. For eg: '{font_family_url}.woff2'                       |
+
+### DigioResponse [Response received from Gateway]
+
+| Name        | Type          | Description                                                                                                                                                                                                 |
+|-------------|---------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| code*       | number        | SUCCESS = 1001 <br /> FAIL = 1002 <br /> CANCEL = -1000 <br /> WEBVIEW_CRASH = 1003 <br /> WEBVIEW_ERROR = 10017 <br /> SDK_CRASH = 1004 <br /> Location/Camera/MicroPhone Permission Denied By User = 1008 |
+| documentId  | string        | Document ID Passed from the parent app. For eg: `KID22040413040490937VNTC6LAP8KWD`                                                                                                                          |
+| message     | string        | Error message in case of crash or failure                                                                                                                                                                   |
+| permissions | Array<string> | List of mandatory permissions which are not given during kyc journey                                                                                                                                        |

package/android/build.gradle

@@ -0,0 +1,106 @@
+buildscript {
+  repositories {
+    google()
+    mavenCentral()
+    maven { url 'https://jitpack.io' }
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:7.2.1"
+  }
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+}
+
+apply plugin: "com.android.library"
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: "com.facebook.react"
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties["DigioReactNative_" + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["DigioReactNative_" + name]).toInteger()
+}
+
+def supportsNamespace() {
+  def parsed = com.android.Version.ANDROID_GRADLE_PLUGIN_VERSION.tokenize('.')
+  def major = parsed[0].toInteger()
+  def minor = parsed[1].toInteger()
+
+  // Namespace support was added in 7.3.0
+  return (major == 7 && minor >= 3) || major >= 8
+}
+
+android {
+  if (supportsNamespace()) {
+    namespace "com.digioreactnative"
+
+    sourceSets {
+      main {
+        manifest.srcFile "src/main/AndroidManifestNew.xml"
+      }
+    }
+  }
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+  buildFeatures {
+    viewBinding true
+    dataBinding true
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+}
+
+
+dependencies {
+  // For < 0.71, this will be from the local maven repo
+  // For > 0.71, this will be replaced by `com.facebook.react:react-android:$version` by react gradle plugin
+  //noinspection GradleDynamicVersion
+  implementation "com.facebook.react:react-native:+"
+  implementation 'com.github.digio-tech:gateway:v4.0.8'
+  implementation 'com.github.digio-tech:gateway_kyc:v4.0.8'
+  implementation 'androidx.appcompat:appcompat:1.6.1'
+  implementation 'com.google.android.material:material:1.9.0'
+  implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
+  implementation "androidx.camera:camera-core:1.1.0"
+  implementation "androidx.camera:camera-camera2:1.1.0"
+  implementation "androidx.camera:camera-lifecycle:1.1.0"
+  implementation "androidx.camera:camera-view:1.1.0"
+  implementation 'androidx.navigation:navigation-fragment:2.5.3'
+  implementation 'androidx.navigation:navigation-ui:2.5.3'
+  implementation 'androidx.preference:preference:1.2.0'
+  implementation 'com.google.android.gms:play-services-mlkit-face-detection:17.1.0'
+  implementation 'com.google.android.gms:play-services-location:21.0.1'
+  implementation 'androidx.swiperefreshlayout:swiperefreshlayout:1.1.0'
+}
+

package/android/gradle.properties

@@ -0,0 +1,5 @@
+DigioReactNative_kotlinVersion=1.7.0
+DigioReactNative_minSdkVersion=21
+DigioReactNative_targetSdkVersion=31
+DigioReactNative_compileSdkVersion=31
+DigioReactNative_ndkversion=21.4.7075529

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.digioreactnative">
+</manifest>

package/android/src/main/AndroidManifestNew.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/digioreactnative/ArrayUtil.java

@@ -0,0 +1,162 @@
+package com.digioreactnative;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.ReadableArray;
+import com.facebook.react.bridge.ReadableType;
+import com.facebook.react.bridge.WritableArray;
+import com.facebook.react.bridge.WritableNativeArray;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.Map;
+
+public class ArrayUtil {
+
+	public static JSONArray toJSONArray(ReadableArray readableArray) throws JSONException {
+		JSONArray jsonArray = new JSONArray();
+
+		for (int i = 0; i < readableArray.size(); i++) {
+			ReadableType type = readableArray.getType(i);
+
+			switch (type) {
+				case Null:
+					jsonArray.put(i, null);
+					break;
+				case Boolean:
+					jsonArray.put(i, readableArray.getBoolean(i));
+					break;
+				case Number:
+					jsonArray.put(i, readableArray.getDouble(i));
+					break;
+				case String:
+					jsonArray.put(i, readableArray.getString(i));
+					break;
+				case Map:
+					jsonArray.put(i, MapUtil.toJSONObject(readableArray.getMap(i)));
+					break;
+				case Array:
+					jsonArray.put(i, ArrayUtil.toJSONArray(readableArray.getArray(i)));
+					break;
+			}
+		}
+
+		return jsonArray;
+	}
+
+	public static Object[] toArray(JSONArray jsonArray) throws JSONException {
+		Object[] array = new Object[jsonArray.length()];
+
+		for (int i = 0; i < jsonArray.length(); i++) {
+			Object value = jsonArray.get(i);
+
+			if (value instanceof JSONObject) {
+				value = MapUtil.toMap((JSONObject) value);
+			}
+
+			if (value instanceof JSONArray) {
+				value = ArrayUtil.toArray((JSONArray) value);
+			}
+
+			array[i] = value;
+		}
+
+		return array;
+	}
+
+	public static Object[] toArray(ReadableArray readableArray) {
+		Object[] array = new Object[readableArray.size()];
+
+		for (int i = 0; i < readableArray.size(); i++) {
+			ReadableType type = readableArray.getType(i);
+
+			switch (type) {
+				case Null:
+					array[i] = null;
+					break;
+				case Boolean:
+					array[i] = readableArray.getBoolean(i);
+					break;
+				case Number:
+					array[i] = readableArray.getDouble(i);
+					break;
+				case String:
+					array[i] = readableArray.getString(i);
+					break;
+				case Map:
+					array[i] = MapUtil.toMap(readableArray.getMap(i));
+					break;
+				case Array:
+					array[i] = ArrayUtil.toArray(readableArray.getArray(i));
+					break;
+			}
+		}
+
+		return array;
+	}
+
+	public static WritableArray toWritableArray(Object[] array) {
+		WritableArray writableArray = Arguments.createArray();
+
+		for (int i = 0; i < array.length; i++) {
+			Object value = array[i];
+
+			if (value == null) {
+				writableArray.pushNull();
+			} else if (value instanceof Boolean) {
+				writableArray.pushBoolean((Boolean) value);
+			} else if (value instanceof Double) {
+				writableArray.pushDouble((Double) value);
+			} else if (value instanceof Integer) {
+				writableArray.pushInt((Integer) value);
+			} else if (value instanceof String) {
+				writableArray.pushString((String) value);
+			} else if (value instanceof Map) {
+				writableArray.pushMap(MapUtil.toWritableMap((Map<String, Object>) value));
+			} else if (value.getClass() != null && value.getClass().isArray()) {
+				writableArray.pushArray(ArrayUtil.toWritableArray((Object[]) value));
+			}
+		}
+
+		return writableArray;
+	}
+
+	public static WritableArray jsonArrayToWritableArray(JSONArray jsonArray) {
+		WritableArray writableArray = new WritableNativeArray();
+
+		if (jsonArray == null) {
+			return null;
+		}
+
+		if (jsonArray.length() <= 0) {
+			return null;
+		}
+
+		for (int i = 0 ; i < jsonArray.length(); i++) {
+			try {
+				Object value = jsonArray.get(i);
+
+				if (value == null) {
+					writableArray.pushNull();
+				} else if (value instanceof Boolean) {
+					writableArray.pushBoolean((Boolean) value);
+				} else if (value instanceof Integer) {
+					writableArray.pushInt((Integer) value);
+				} else if (value instanceof Double) {
+					writableArray.pushDouble((Double) value);
+				} else if (value instanceof String) {
+					writableArray.pushString((String) value);
+				} else if (value instanceof JSONObject) {
+					writableArray.pushMap(MapUtil.jsonToWritableMap((JSONObject) value));
+				} else if (value instanceof JSONArray) {
+					writableArray.pushArray(jsonArrayToWritableArray((JSONArray) value));
+				}
+			} catch (JSONException e) {
+				e.printStackTrace();
+			}
+		}
+
+		return writableArray;
+	}
+}

package/android/src/main/java/com/digioreactnative/DigioReactNativeModule.java

@@ -0,0 +1,210 @@
+package com.digioreactnative;
+
+import android.annotation.SuppressLint;
+import android.app.Activity;
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.text.TextUtils;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.core.content.ContextCompat;
+
+import com.facebook.react.bridge.ActivityEventListener;
+import com.facebook.react.bridge.Arguments;
+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.ReadableMap;
+import com.facebook.react.bridge.WritableArray;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.module.annotations.ReactModule;
+import com.facebook.react.modules.core.DeviceEventManagerModule;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.Locale;
+import java.util.Map;
+
+import in.digio.sdk.gateway.DigioActivity;
+import in.digio.sdk.gateway.DigioConstants;
+import in.digio.sdk.gateway.enums.DigioEnvironment;
+import in.digio.sdk.gateway.enums.DigioErrorCode;
+import in.digio.sdk.gateway.model.DigioConfig;
+import in.digio.sdk.gateway.model.DigioTheme;
+
+@ReactModule(name = DigioReactNativeModule.NAME)
+public class DigioReactNativeModule extends ReactContextBaseJavaModule {
+  public static final String NAME = "DigioReactNative";
+
+  public static final String AAR_VERSION = "4.0.8";
+  public static final int DIGIO_ACTIVITY = 73457843;
+  private Promise resultPromise;
+
+  private BroadcastReceiver eventBroadcastReceiver = new BroadcastReceiver() {
+
+    @Override
+    public void onReceive(Context context, Intent intent) {
+      if (intent.getStringExtra("data") != null) {
+        JSONObject jsonObject = null;
+        try {
+          jsonObject = new JSONObject(
+            intent.getStringExtra(
+              "data"
+            )
+          );
+        } catch (JSONException e) {
+          e.printStackTrace();
+        }
+        WritableMap resultMap = MapUtil.jsonToWritableMap(jsonObject);
+        getReactApplicationContext()
+          .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
+          .emit("gatewayEvent", resultMap);
+      }
+    }
+  };
+
+  ActivityEventListener activityEventListener = new ActivityEventListener() {
+    @Override
+    public void onActivityResult(Activity activity, int requestCode, int resultCode, @Nullable Intent intent) {
+      if (requestCode == DIGIO_ACTIVITY) {
+        onNativeActivityResult(resultCode, intent);
+      }
+    }
+
+    @Override
+    public void onNewIntent(Intent intent) {
+
+    }
+  };
+
+  private void onNativeActivityResult(int resultCode, Intent data) {
+    WritableMap resultMap = Arguments.createMap();
+    resultMap.putInt("code", resultCode);
+    if (data != null) {
+      resultMap.putString("message", data.getStringExtra("message"));
+      String screenName = data.getStringExtra("screen_name");
+      if (TextUtils.isEmpty(screenName)) {
+        screenName = "starting_digio";
+      }
+      resultMap.putString("screen", screenName);
+      resultMap.putString("step", data.getStringExtra("step"));
+      resultMap.putString("documentId", data.getStringExtra("document_id"));
+      resultMap.putString("failingUrl", data.getStringExtra("failing_url"));
+      resultMap.putInt("errorCode", data.getIntExtra("error_code", resultCode));
+      String[] stringArrayExtra = data.getStringArrayExtra("permissions");
+      WritableArray permissionArray = Arguments.createArray();
+      if (stringArrayExtra != null && stringArrayExtra.length > 0) {
+        for (String permission : stringArrayExtra) {
+          permissionArray.pushString(permission);
+        }
+      }
+      resultMap.putArray(
+        "permissions", permissionArray);
+    }
+    if (resultCode == DigioConstants.RESPONSE_CODE_SUCCESS) {
+      if (resultMap.getString("message") == null) {
+        resultMap.putString("message", "KYC Success");
+      }
+    } else if (resultCode == DigioErrorCode.DIGIO_PERMISSIONS_REQUIRED.getErrorCode()) {
+      resultMap.putInt("errorCode", resultCode);
+    } else {
+      if (resultMap.getString("message") == null) {
+        resultMap.putString("message", "KYC Failure");
+      }
+      resultMap.putInt("errorCode", resultCode);
+    }
+    resultPromise.resolve(resultMap);
+  }
+
+  @SuppressLint("WrongConstant")
+  public DigioReactNativeModule(ReactApplicationContext reactContext) {
+    super(reactContext);
+    reactContext.addActivityEventListener(activityEventListener);
+    ContextCompat.registerReceiver(
+      reactContext, eventBroadcastReceiver,
+      new IntentFilter(DigioConstants.GATEWAY_EVENT),
+      ContextCompat.RECEIVER_NOT_EXPORTED
+    );
+  }
+
+  @Override
+  @NonNull
+  public String getName() {
+    return NAME;
+  }
+
+  @ReactMethod
+  public void start(String documentId, String identifier, String tokenId, ReadableMap additionalData, ReadableMap config, Promise promise) {
+    this.resultPromise = promise;
+    try {
+      Intent intent = new Intent(this.getCurrentActivity(), DigioActivity.class);
+      DigioConfig digioConfig = new DigioConfig();
+      String environment = config.getString("environment");
+      String logo = config.getString("logo");
+      if (!TextUtils.isEmpty(environment)) {
+        try {
+          digioConfig.setEnvironment(DigioEnvironment.valueOf(environment.toUpperCase(Locale.ENGLISH)));
+        } catch (Exception e) {
+          e.printStackTrace();
+        }
+      }
+      if (!TextUtils.isEmpty(logo)) {
+        digioConfig.setLogo(logo);
+      }
+      DigioTheme digioTheme = new DigioTheme();
+
+      String primaryColor = config.getString("primaryColor");
+      if (!TextUtils.isEmpty(primaryColor)) {
+        digioTheme.setPrimaryColorHex(primaryColor);
+      }
+      String secondaryColor = config.getString("secondaryColor");
+      if (!TextUtils.isEmpty(secondaryColor)) {
+        digioTheme.setSecondaryColorHex(secondaryColor);
+      }
+      String fontFormat = config.getString("fontFormat");
+      if (!TextUtils.isEmpty(fontFormat)) {
+        digioTheme.setFontFormat(fontFormat);
+      }
+      String fontFamily = config.getString("fontFamily");
+      if (!TextUtils.isEmpty(fontFamily)) {
+        digioTheme.setFontFamily(fontFamily);
+      }
+      String fontUrl = config.getString("fontUrl");
+      if (!TextUtils.isEmpty(fontUrl)) {
+        digioTheme.setFontUrl(fontUrl);
+      }
+
+      digioConfig.setTheme(digioTheme);
+
+      intent.putExtra("config", digioConfig);
+      intent.putExtra("aar_version", AAR_VERSION);
+      intent.putExtra("navigation_graph", R.navigation.workflow);
+      intent.putExtra("document_id", documentId);
+      intent.putExtra("customer_identifier", identifier);
+      intent.putExtra("token_id", tokenId);
+      HashMap additionalDataMap = new HashMap();
+      if (additionalData != null) {
+        Iterator<Map.Entry<String, Object>> entryIterator = additionalData.getEntryIterator();
+        while (entryIterator.hasNext()) {
+          Map.Entry<String, Object> objectEntry = entryIterator.next();
+          additionalDataMap.put(objectEntry.getKey(), objectEntry.getValue());
+        }
+      }
+      intent.putExtra("additional_data", additionalDataMap);
+      this.getCurrentActivity().startActivityForResult(intent, DIGIO_ACTIVITY);
+    } catch (Exception e) {
+      // Throws DigioException if WorkflowResponseListener is not implemented/passed, or
+      // DigioConfig is not valid (check config parameters)
+      // It is mandatory to implemented/add WorkflowResponseListener
+      e.printStackTrace();
+      resultPromise.reject(e);
+    }
+  }
+}

package/android/src/main/java/com/digioreactnative/DigioReactNativePackage.java

@@ -0,0 +1,28 @@
+package com.digioreactnative;
+
+import androidx.annotation.NonNull;
+
+import com.facebook.react.ReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.uimanager.ViewManager;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+
+public class DigioReactNativePackage implements ReactPackage {
+  @NonNull
+  @Override
+  public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
+    List<NativeModule> modules = new ArrayList<>();
+    modules.add(new DigioReactNativeModule(reactContext));
+    return modules;
+  }
+
+  @NonNull
+  @Override
+  public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
+    return Collections.emptyList();
+  }
+}