@socure-inc/docv-react-native 3.2.0-pre-release-1 → 4.0.0-alpha.0

package/README.md

@@ -2,6 +2,8 @@
 
 The Predictive Document Verification (DocV) SDK v3 for React Native is a React Native wrapper that allows you to use the DocV SDK for Android and iOS in your React Native application. 
 
+> Note: Document verification services will be disabled for older SDK versions soon. All SDK v3 integrations must be updated to version **3.1.0 or later** to meet compliance requirements.
+
 ## Minimum Requirements
 
 **React Native**
@@ -11,12 +13,12 @@ The Predictive Document Verification (DocV) SDK v3 for React Native is a React N
 **iOS**
 
 - Support for iOS 13 and later
-- Xcode version 13+
+- Xcode version 14.1+
 
 **Android**
 
 - Android SDK Version 22 (OS Version 5.1) and later
-- Android SDK is compiled with `compileSdkVersion` 32 and Java 11
+- Android SDK is compiled with `compileSdkVersion` 33 and Java 11
 
 ## Getting started
 
@@ -148,7 +150,7 @@ Using the command line, go to your root project folder and enter the following c
   
 ### Configure your Android app
 
-For the Android app, add your project dependencies by going to the module level `build.gradle` file and making sure the `minSdkVersion` is set to at least 22 and the `compileSdkVersion` is set to at least 32. 
+For the Android app, add your project dependencies by going to the module level `build.gradle` file and making sure the `minSdkVersion` is set to at least 22 and the `compileSdkVersion` is set to at least 33. 
 
 ```kotlin {5,6}
 buildscript {
@@ -156,7 +158,7 @@ buildscript {
             ext {
                  ....
                 minSdkVersion = 22 
-                compileSdkVersion = 32
+                compileSdkVersion = 33
                 .....
             }
 }
@@ -215,8 +217,8 @@ The following table lists the available `launchSocureDocV` properties:
 
 | Argument           | Description                                                                                                                                                                                                                                                                                                       |
 | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `socure_sdk_key`   | The unique SDK key obtained from Admin Dashboard. For more information on SDK keys, see the [Getting Started](https://developer.socure.com/docs/) article.                                                                                                                          |
-| `flow`           | An optional JSON string or null value that specifies a custom flow. The `FLOW_NAME` value specifies the name of the flow (created in Admin Dashboard) that the DocV SDK should use.  <br /> <br />`JSON.stringify({flow: {name: “FLOW_NAME”}})` <br /> <br />If the value is `null`, the DocV SDK will fetch the default flow from Admin Dashboard. |  |   |
+| `socure_sdk_key`   | The unique SDK key obtained from Admin Dashboard. For more information on SDK keys, see the [SDK Keys](https://developer.socure.com/docs/admin-dashboard/developers/sdk-keys) article in DevHub.article.                                                                                                                          |
+| `flow`           | An optional JSON string or null value that specifies a custom flow. <br /><br />  `JSON.stringify({flow: {name: “FLOW_NAME”}, document_type: 'license'})` <br /><br />The `flow_name` value specifies the name of the customized Capture App UI flow (created in Admin Dashboard) that the DocV SDK should use for each transaction. If the value is incorrect or `null`, the DocV SDK will use flow set as **Default** in Admin Dashboard. <br /><br />The `document_type` value specifies a single acceptable document type for the transaction and skips the **Selected ID Type Screen** in the Capture App flow. Possible field values are `license` or `passport`. If the value is incorrect or `null`, the DocV SDK will use the document type defined for the flow in Admin Dashboard.  |  |   |
 | `onSuccess`      | A callback function that notifies you when the flow completes successfully.                                                                                                                                                                                                                                                                                               |   |   |
 | `onError`        | A callback function that notifies you when the flow fails.                                                                                                                                                                                                                                                                                                |   |   |
 

package/android/build.gradle

@@ -134,7 +134,7 @@ dependencies {
     //noinspection GradleDynamicVersion
   implementation "com.facebook.react:react-native:+"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  implementation "com.github.socure-inc:socure-docv:3.2.0-pre-release-1"
+  implementation "com.github.socure-inc:socure-docv:4.0.0"
 // From node_modules
 }
 

package/android/src/main/java/com/socure/docv/reactnative/SocureDocVReactNativeModule.kt

@@ -9,6 +9,8 @@ import com.socure.docv.capturesdk.api.Platform.REACT_NATIVE
 import com.socure.docv.capturesdk.api.SocureDocVHelper.getIntent
 import com.socure.docv.capturesdk.api.SocureDocVHelper.getResult
 import com.socure.docv.capturesdk.api.SocureDocVHelper.setSource
+import com.socure.docv.capturesdk.api.SocureDocVHelper.initSdk
+import com.socure.docv.capturesdk.api.SocureExperimentalApi
 import com.socure.docv.capturesdk.common.utils.ResultListener
 import com.socure.docv.capturesdk.common.utils.ScanError
 import com.socure.docv.capturesdk.common.utils.ScannedData
@@ -28,6 +30,23 @@ class SocureDocVReactNativeModule(reactContext: ReactApplicationContext) :
         return "SocureDocVReactNative"
     }
 
+    @OptIn(SocureExperimentalApi::class)
+    @ReactMethod
+    fun initDocVSdk(socureApiKey: String, flow: String?) {
+        Log.d(TAG, "initDocVSdk - init native sdk")
+
+        initSdk(currentActivity!!, socureApiKey, flow)
+    }
+
+    @OptIn(SocureExperimentalApi::class)
+    @ReactMethod
+    fun launchDocVSdk(onSuccess: Callback,onError: Callback) {
+        Log.d(TAG, "launchDocVSdk - launch using experimental api")
+
+        setupLaunch(onSuccess, onError)
+        currentActivity?.startActivityForResult(getIntent(currentActivity!!), SOCURE_SDK_REQUEST_CODE)
+    }
+
     @ReactMethod
     fun launchSocureDocV(
         socureApiKey: String,
@@ -35,6 +54,16 @@ class SocureDocVReactNativeModule(reactContext: ReactApplicationContext) :
         onSuccess: Callback,
         onError: Callback
     ) {
+        Log.d(TAG, "launchSocureDocV - launch Socure SDK")
+
+        setupLaunch(onSuccess, onError)
+        currentActivity?.startActivityForResult(
+            getIntent(currentActivity!!, socureApiKey, flow),
+            SOCURE_SDK_REQUEST_CODE
+        )
+    }
+
+    private fun setupLaunch(onSuccess: Callback, onError: Callback) {
         this.onSuccessCallback = onSuccess
         this.onErrorCallback = onError
 
@@ -43,10 +72,6 @@ class SocureDocVReactNativeModule(reactContext: ReactApplicationContext) :
         reactApplicationContext.addActivityEventListener(this)
 
         setSource(REACT_NATIVE)
-        currentActivity?.startActivityForResult(
-            getIntent(currentActivity!!, socureApiKey, flow),
-            SOCURE_SDK_REQUEST_CODE
-        )
     }
 
     override fun onActivityResult(

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export declare function launchSocureDocV(socureApiKey: string, flow: string | null | undefined, onSuccess: Function, onError: Function): any;
+export declare function initDocVSdk(socureApiKey: string, flow: string | null | undefined): void;
+export declare function launchDocVSdk(onSuccess: Function, onError: Function): any;
 export interface ScannedData {
     docUUID: string;
     sessionId: string;

package/ios/SocureDocVReactNative.m

@@ -5,6 +5,9 @@
 RCT_EXTERN_METHOD(launchSocureDocV:(NSString)socureApiKey flow:(NSString)flow
                   onSuccess:(RCTResponseSenderBlock)success
                   onError:(RCTResponseSenderBlock)error)
+RCT_EXTERN_METHOD(initDocVSdk:(NSString)socureApiKey flow:(NSString)flow)
+RCT_EXTERN_METHOD(launchDocVSdk:(RCTResponseSenderBlock)success
+                  onError:(RCTResponseSenderBlock)error)
 
 + (BOOL)requiresMainQueueSetup
 {

package/ios/SocureDocVReactNative.swift

@@ -2,35 +2,59 @@ import SocureDocV
 
 @objc(SocureDocVReactNative)
 class SocureDocVReactNative: NSObject {
-  let objDocVHelper = SocureDocVHelper()
-  @objc(launchSocureDocV:flow:onSuccess:onError:)
-  func launchSocureDocV(socureApiKey: String, flow: String?, onSuccess: @escaping RCTResponseSenderBlock,onError: @escaping RCTResponseSenderBlock) -> Void {
-      var flowConfig: [String: Any]?
-      do {
-          flowConfig = try flow?.convertToDictionary()
-      } catch {
-          let errorDict = ["errorMessage": "Invalid config data", "statusCode": "7109"]
-          onError([errorDict])
-          return
-      }
-      objDocVHelper.setSource(.reactNative)
-      DispatchQueue.main.async {
-          let root = RCTPresentedViewController()
-          self.objDocVHelper.launch(socureApiKey, presentingViewController: root!, config: flowConfig, completionBlock: { result in
-              switch result {
-              case .success(let scan):
-                  onSuccess([scan.dictionary])
-                  break
-              case .failure(let error):
-                  onError([error.dictionary])
-                  break
-              }
-          })
-      }
-  }
+    lazy var objDocVHelper = SocureDocVHelper()
+    
+    @objc(launchSocureDocV:flow:onSuccess:onError:)
+    func launchSocureDocV(socureApiKey: String, flow: String?, onSuccess: @escaping RCTResponseSenderBlock,onError: @escaping RCTResponseSenderBlock) -> Void {
+        var flowConfig: [String: Any]?
+        do {
+            flowConfig = try flow?.convertToDictionary()
+        } catch {
+            let errorDict = ["errorMessage": "Invalid config data", "statusCode": "7109"]
+            onError([errorDict])
+            return
+        }
+        objDocVHelper.setSource(.reactNative)
+        DispatchQueue.main.async {
+            let root = RCTPresentedViewController()
+            self.objDocVHelper.launch(socureApiKey, presentingViewController: root!, config: flowConfig, completionBlock: { result in
+                switch result {
+                case .success(let scan):
+                    onSuccess([scan.dictionary])
+                    break
+                case .failure(let error):
+                    onError([error.dictionary])
+                    break
+                }
+            })
+        }
+    }
+    
+    @objc(initDocVSdk:flow:)
+    func initDocVSdk(socureApiKey: String, flow: String?) -> Void {
+        SocureDocVSdk.initSdk(publicKey: socureApiKey, config: try? flow?.convertToDictionary())
+    }
+    
+    @objc(launchDocVSdk:onError:)
+    func launchDocVSdk(onSuccess: @escaping RCTResponseSenderBlock,onError: @escaping RCTResponseSenderBlock) -> Void {
+        SocureDocVSdk.setSource(.reactNative)
+        DispatchQueue.main.async {
+            let root = RCTPresentedViewController()
+            SocureDocVSdk.launch(presentingViewController: root!, completionBlock: { result in
+                switch result {
+                case .success(let scan):
+                    onSuccess([scan.dictionary])
+                    break
+                case .failure(let error):
+                    onError([error.dictionary])
+                    break
+                }
+            })
+        }
+    }
     
     @objc static func requiresMainQueueSetup() -> Bool {
-      return false
+        return false
     }
 }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@socure-inc/docv-react-native",
-  "version": "3.2.0-pre-release-1",
-  "description": "The Predictive Document Verification (DocV) SDK React Native bridge allows you to use the DocV SDK v3 for Android and iOS in your React Native application.",
+  "version": "4.0.0-alpha.0",
+  "description": "The Predictive Document Verification (DocV) SDK React Native bridge allows you to use the DocV SDK v4 for Android and iOS in your React Native application.",
   "main": "src/index",
   "types": "dist/index.d.ts",
   "keywords": [
@@ -37,4 +37,4 @@
     "prepack": "tsc -p tsconfig.json",
     "test": "echo \"Error: no test specified\" && exit 1"
   }
-}
+}

package/socure-docv-react-native.podspec

@@ -18,6 +18,6 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift}"
 
   s.dependency "React"
-  s.dependency "SocureDocV", "3.2.0-pre-release-1"
+  s.dependency "SocureDocV", "4.0.0"
 
 end

package/src/index.tsx

@@ -23,6 +23,39 @@ export function launchSocureDocV(socureApiKey: string, flow: string | null | und
   }
 }
 
+{/*
+  This API is experimental. 
+  Please contact Socure before starting to use this.
+*/}
+export function initDocVSdk(socureApiKey: string, flow: string | null | undefined) {
+  if (typeof socureApiKey === "string") {
+    if ((!flow && flow !== "") || (typeof flow === "string" && isValidJSON(flow))) {
+      SocureDocVReactNative.initDocVSdk(socureApiKey, flow);
+    } else {
+      onConfigError("7109", "Invalid config data")
+    }
+  } else {
+    onConfigError("7011", "Invalid key")
+  }
+}
+
+{/*
+  This API is experimental. 
+  Please contact Socure before starting to use this.
+*/}
+export function launchDocVSdk(onSuccess: Function, onError: Function) {
+  return SocureDocVReactNative.launchDocVSdk(onSuccess, onError);
+}
+
+function isValidJSON(jsonString: string) {
+  try {
+    JSON.parse(jsonString);
+    return true;
+  } catch (e) {
+    return false;
+  }
+};
+
 function onConfigError(errorCode: string, errorMessage: string, onError?: Function) {
   let error = { statusCode: errorCode, errorMessage: errorMessage } as ScanError
   if (onError && typeof onError == 'function') {