@socure-inc/docv-react-native 3.0.0

package/License.txt

@@ -0,0 +1,33 @@
+Socure's Software Development Kit (SDK) LICENSE AGREEMENT
+
+This Software Development Kit (“SDK”) License Agreement (“Agreement”) is between you (both the individual downloading the SDK and any legal entity on behalf of which such individual is acting) (“You” or “Your”) and Socure Inc. (“Socure”).
+IT IS IMPORTANT THAT YOU READ CAREFULLY AND UNDERSTAND THIS AGREEMENT. BY CLICKING THE “I ACCEPT” BUTTON OR AN EQUIVALENT INDICATOR OR BY DOWNLOADING, INSTALLING OR USING THE SDK OR THE DOCUMENTATION, YOU AGREE TO BE BOUND BY THIS AGREEMENT. IF YOU DO NOT AGREE TO BE BOUND BY THIS AGREEMENT, YOU WILL NOT BE PERMITTED TO (AND YOU WILL HAVE NO RIGHT TO) DOWNLOAD, INSTALL OR USE THE SDK OR THE DOCUMENTATION.
+1. DEFINITIONS
+1.2 “Documentation” means the materials made available to You in connection with the Software by or on behalf of Socure pursuant to this Agreement.
+1.3 “Master Service Agreement” means the underlying agreement between You and Socure outlining your use of any and all Socure products and services.
+1.4 “Software” means all of the software included in the software development kit made available to You by or on behalf of Socure pursuant to this Agreement, including but not limited to sample source code, code snippets, software tools, code libraries, sample applications, Documentation and any upgrades, modified versions, updates, and/or additions thereto, if any, made available to You by or on behalf of Socure pursuant to this Agreement.
+2. GRANT OF LICENSE; RESTRICTIONS
+2.1 Limited License. Subject to and conditioned upon Your compliance with the terms of this Agreement, Socure hereby grants to You a limited, revocable, non-exclusive, non-transferable, royalty-free license during the term of this Agreement to use the Software, pursuant to the terms of Your Master Service Agreement with Socure. If you do not have a Master Service Agreement in place with Socure, you are prohibited from downloading or using the Software or the SDK. 
+2.2 Restrictions. You shall not (and shall have no right to): (a) make or distribute copies of the Software or the Documentation, in whole or in part, except as expressly permitted pursuant to Section 2.1; (b) alter or remove any copyright, trademark, trade name or other proprietary notices, legends, symbols or labels appearing on or in the Software or Documentation; (c) sublicense (or purport to sublicense) the Software or the Documentation, in whole or in part, to any third party except as expressly permitted pursuant to Section 2.1; (d) engage in any activity with the Software, including the development or distribution of an application, that interferes with, disrupts, damages, or accesses in an unauthorized manner the platform, servers, or systems of Socure, any of its affiliates, or any third party; (e) otherwise use or exploit the Software or the Documentation for any purpose other than as expressly permitted in your Master Service Agreement.
+2.3 Ownership. You acknowledge and agree that all right, title and interest in and to the Software and Documentation shall, at all times, be and remain the exclusive property of Socure and that You do not have or acquire any rights, express or implied, in the Software or Documentation.
+2.4 No Support. Socure has no obligation to provide support, maintenance, upgrades, modifications or new releases of the Software.
+2.5 Use. (a) You represent, warrant and agree to use the Software and write Applications only for purposes permitted by (i) this Agreement; (ii) your Master Service Agreement (iii) applicable law and regulation; and (iv) generally accepted practices or guidelines in the relevant jurisdictions. (b) You represent, warrant and agree that You are solely responsible for (and that neither Socure nor its affiliates have any responsibility to You or to any third party for): (i) any data, content, or resources that You obtain, transmit or display through the use of Software; and (ii) any breach of Your obligations under this Agreement, any applicable third party license, or any applicable law or regulation, and for the consequences of any such breach.
+3. WARRANTY DISCLAIMER; LIMITATION OF LIABILITY
+3.1 Disclaimer. THE SOFTWARE AND THE DOCUMENTATION ARE PROVIDED ON AN “AS IS” AND “AS AVAILABLE” BASIS WITH NO WARRANTY. YOU AGREE THAT YOUR USE OF THE SOFTWARE AND THE DOCUMENTATION IS AT YOUR SOLE RISK AND YOU ARE SOLELY RESPONSIBLE FOR ANY DAMAGE TO YOUR COMPUTER SYSTEM OR OTHER DEVICE OR LOSS OF DATA THAT RESULTS FROM SUCH USE. TO THE FULLEST EXTENT PERMISSIBLE UNDER APPLICABLE LAW, SOCURE AND ITS AFFILIATES EXPRESSLY DISCLAIM ALL WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, WITH RESPECT TO THE SOFTWARE AND THE DOCUMENTATION, INCLUDING ALL WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, SATISFACTORY QUALITY, ACCURACY, TITLE AND NON-INFRINGEMENT, AND ANY WARRANTIES THAT MAY ARISE OUT OF COURSE OF PERFORMANCE, COURSE OF DEALING OR USAGE OF TRADE. NEITHER SOCURE NOR ITS AFFILIATES WARRANT THAT THE FUNCTIONS OR INFORMATION CONTAINED IN THE SOFTWARE OR THE DOCUMENTATION WILL MEET ANY REQUIREMENTS OR NEEDS YOU MAY HAVE, OR THAT THE SOFTWARE OR DOCUMENTATION WILL OPERATE ERROR FREE, OR THAT THE SOFTWARE OR DOCUMENTATION IS COMPATIBLE WITH ANY PARTICULAR OPERATING SYSTEM.
+3.2 Limitation of Liability. IN NO EVENT SHALL SOCURE OR ITS AFFILIATES BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL OR PUNITIVE DAMAGES, OR DAMAGES FOR LOSS OF PROFITS, REVENUE, BUSINESS, SAVINGS, DATA, USE OR COST OF SUBSTITUTE PROCUREMENT, INCURRED BY YOU OR ANY THIRD PARTY, WHETHER IN AN ACTION IN CONTRACT OR TORT, EVEN IF SOCURE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR IF SUCH DAMAGES ARE FORESEEABLE. IN NO EVENT SHALL THE ENTIRE LIABILITY OF SOCURE AND AFFILIATES ARISING FROM OR RELATING TO THIS AGREEMENT OR THE SUBJECT MATTER HEREOF EXCEED THE FEES PAID BY YOU FOR THE SOFTWARE UNDER THIS AGREEMENT. THE PARTIES ACKNOWLEDGE THAT THE LIMITATIONS OF LIABILITY IN THIS SECTION 3.2 AND IN THE OTHER PROVISIONS OF THIS AGREEMENT AND THE ALLOCATION OF RISK HEREIN ARE AN ESSENTIAL ELEMENT OF THE BARGAIN BETWEEN THE PARTIES, WITHOUT WHICH SOCURE WOULD NOT HAVE ENTERED INTO THIS AGREEMENT.
+4. INDEMNIFICATION
+You shall indemnify, hold harmless and, at Socure’s request, defend Socure and its affiliates and their officers, directors, employees, and agents from and against any claim, suit or proceeding, and any associated liabilities, costs, damages and expenses, including reasonable attorneys’ fees, that arise out of relate to: (i) Your use or distribution of the Software or the Documentation (or any portion thereof), including, but not limited to, any allegation that any such use or distribution infringes, misappropriates or otherwise violates any intellectual property (including, without limitation, copyright, patent, and trademark), privacy, publicity or other rights of any third party, or has caused the death or injury of any person or damage to any property; (ii) Your alleged or actual breach of this Agreement; (iii) the alleged or actual breach of this Agreement by any party to whom you have provided the Software or the Documentation or (iii) Your alleged or actual violation of or non-compliance with any applicable laws, legislation, policies, rules, regulations or governmental requirements (including, without limitation, any laws, legislation, policies, rules, regulations or governmental requirements related to privacy and data collection).
+5. TERMINATION
+This Agreement and the licenses granted to you herein are effective until terminated. Socure may terminate this Agreement and the licenses granted to You at any time. Upon termination of this Agreement, You shall cease all use of the Software and the Documentation, return to Socure or destroy all copies of the Software and Documentation and related materials in Your possession, and so certify to Socure. Except for the license to You granted herein, the terms of this Agreement shall survive termination.
+6. CONFIDENTIAL INFORMATION
+6.1 You hereby agree (i) to hold Socure’s Confidential Information in strict confidence and to take reasonable precautions to protect such Confidential Information (including, without limitation, all precautions You employ with respect to Your own confidential materials), (ii) not to divulge any such Confidential Information to any third person; (iii) not to make any use whatsoever at any time of such Confidential Information except as strictly licensed hereunder, (iv) not to remove or export from the United States or re-export any such Confidential Information or any direct product thereof, except in compliance with, and with all licenses and approvals required under applicable U.S. and foreign export laws and regulations, including, without limitation, those of the U.S. Department of Commerce.
+“Confidential Information” shall mean any data or information, oral or written, treated as confidential that relates to Socure’s past, present, or future research, development or business activities, including without limitation any unannounced products and services, any information relating to services, developments, inventions, processes, plans, financial information, customer data, revenue, transaction volume, forecasts, projections, application programming interfaces, Software and Documentation.
+7. General Terms
+7.1 Law. This Agreement and all matters arising out of or relating to this Agreement shall be governed by the laws of the State of New York without giving effect to any choice of law rule. This Agreement shall not be governed by the United Nations Convention on Contracts for the International Sales of Goods, the application of which is expressly excluded. In the event of any controversy, claim or dispute between the parties arising out of or relating to this Agreement, such controversy, claim or dispute shall be resolved in the state or federal courts in New York City, New York, and the parties hereby irrevocably consent to the jurisdiction and venue of such courts.
+7.2 Severability and Waiver. If any provision of this Agreement is held to be illegal, invalid or otherwise unenforceable, such provision shall be enforced to the extent possible consistent with the stated intention of the parties, or, if incapable of such enforcement, shall be deemed to be severed and deleted from this Agreement, while the remainder of this Agreement shall continue in full force and effect. The waiver by either party of any default or breach of this Agreement shall not constitute a waiver of any other or subsequent default or breach.
+7.3 No Assignment. You may not assign, sell, transfer, delegate or otherwise dispose of, whether voluntarily or involuntarily, by operation of law or otherwise, this Agreement or any rights or obligations under this Agreement without the prior written consent of Socure, which may be withheld in Socure’s sole discretion. Any purported assignment, transfer or delegation by You shall be null and void. Subject to the foregoing, this Agreement shall be binding upon and shall inure to the benefit of the parties and their respective successors and assigns.
+7.4 Export Administration. You shall comply fully with all relevant export laws and regulations of the United States, including, without limitation, the U.S. Export Administration Regulations (collectively “Export Controls”). Without limiting the generality of the foregoing, You shall not, and You shall require Your representatives not to, export, direct or transfer the Software or the Documentation, or any direct product thereof, to any destination, person or entity restricted or prohibited by the Export Controls.
+7.5 Privacy. In order to continually innovate and improve the Software, You understand and agree that Socure may collect certain usage statistics including but not limited to a unique identifier, associated IP address, version number of software, and information on which tools and/or services in the Software are being used and how they are being used.
+7.6 Headings. The headings to the Sections and Subsections of this Agreement are included merely for convenience of reference and shall not affect the meaning of the language included therein.
+7.7 Entire Agreement; Amendments. This Agreement in conjunction with Your Master Service Agreement constitutes the entire agreement between the parties and supersedes all prior or contemporaneous agreements or representations, written or oral, concerning the subject matter of this Agreement, including any agreement or terms that may exist between You and GitHub. Socure may make changes to this Agreement, Software or Documentation in its sole discretion. When these changes are made, Socure will make a new version of the Agreement, Software or Documentation available on the website where the Software is available. This Agreement may not be modified or amended by You except in a writing signed by a duly authorized representative of each party. You acknowledge and agree that Socure has not made any representations, warranties or agreements of any kind, except as expressly set forth herein.
+BY CLICKING “I ACCEPT,” “I AGREE” OR AN EQUIVALENT INDICATOR OR BY DOWNLOADING, INSTALLING OR USING THE SOFTWARE OR THE DOCUMENTATION, YOU ACKNOWLEDGE AND AGREE THAT (1) YOU HAVE READ AND REVIEWED THIS AGREEMENT IN ITS ENTIRETY, (2) YOU AGREE TO BE BOUND BY THIS AGREEMENT, (3) YOU HAVE THE POWER, AUTHORITY AND LEGAL RIGHT TO ENTER INTO THIS AGREEMENT ON BEHALF OF YOU AND, (4) THIS AGREEMENT CONSTITUTES BINDING AND ENFORCEABLE OBLIGATIONS OF YOU.

package/README.md

@@ -0,0 +1,317 @@
+# Predictive DocV SDK v3 React Native
+
+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. 
+
+## Minimum Requirements
+
+**React Native**
+
+- React Native CLI. See the [React Native docs](https://reactnative.dev/docs/environment-setup) for instructions on how to set up your development environment. 
+
+**iOS**
+
+- Support for iOS 13 and later
+- Xcode version 13+
+
+**Android**
+
+- Android SDK Version 22 (OS Version 5.1) and later
+- Android SDK is compiled with `compileSdkVersion` 32 and Java 11
+
+## Getting started
+
+To get started, complete the steps in the following sections:  
+
+- [Install the React Native wrapper with NPM](#install-the-react-native-wrapper-with-npm)
+- [Configure your iOS or Android app](#configure-your-ios-or-android-app)
+- [Import and launch the SDK](#import-and-launch-the-sdk)
+
+## Install the React Native wrapper with NPM
+
+In your React Native project, install the DocV React Native wrapper by running the following NPM command:
+
+```
+npm install @socure-inc/docv-react-native
+```
+
+## Configure your iOS or Android app
+
+Your React Native project needs to access the DocV iOS or Android SDKs through the React Native wrapper. Follow the instructions in the drop down menus below to integrate the DocV SDK into your iOS or Android app. 
+
+<br />
+
+<details>
+  <summary><b>Integrate with the DocV iOS SDK</b></summary>
+
+<br />
+
+### Configure your iOS app
+
+For the iOS app, you can install the DocV iOS SDK into your project using Cocoapods. If you do not already have the CocoaPods tool installed, see the [CocoaPods Getting Started guide](https://guides.cocoapods.org/using/getting-started.html#installation). 
+
+#### Add project dependencies
+
+In your root project folder, open your Podfile with a text editor and specify the following project dependencies: 
+
+- Replace the deployment target with `platform :ios, '13.0'`.
+- Add the line pod `'socure-docv-react-native', :path => '../node_modules/@socure-inc/docv-react-native'`
+
+Once completed, your Podfile should look like the following example: 
+
+```swift {4,36}
+require_relative '../node_modules/react-native/scripts/react_native_pods'
+require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'
+
+platform :ios, '13.0'
+install! 'cocoapods', :deterministic_uuids => false
+
+production = ENV["PRODUCTION"] == "1"
+
+target 'SocureDocVDemo' do
+  config = use_native_modules!
+
+  # Flags change depending on the env values.
+  flags = get_default_flags()
+
+  use_react_native!(
+    :path => config[:reactNativePath],
+    # to enable hermes on iOS, change `false` to `true` and then install pods
+    :production => production,
+    :hermes_enabled => flags[:hermes_enabled],
+    :fabric_enabled => flags[:fabric_enabled],
+    :flipper_configuration => FlipperConfiguration.enabled,
+    # An absolute path to your application root.
+    :app_path => "#{Pod::Config.instance.installation_root}/.."
+  )
+
+  target 'SocureDocVDemoTests' do
+    inherit! :complete
+    # Pods for testing
+  end
+
+  post_install do |installer|
+    react_native_post_install(installer)
+    __apply_Xcode_12_5_M1_post_install_workaround(installer)
+  end
+
+pod 'socure-docv-react-native', :path => '../node_modules/@socure-inc/docv-react-native'
+
+end
+```
+
+#### Install the dependencies
+
+Change the location of your working directory to the `iOS` folder: 
+
+```
+cd ios
+```
+
+Install the Cocoapods dependencies by running the following command: 
+
+```
+pod install
+```
+
+#### Use the CocoaPods-generated `.xcworkspace` file
+
+The CocoaPods installation command generates a `.xcworkspace` file with all the dependencies configured. To continue with the installation, complete the following: 
+
+- Close Xcode and then open your project's `.xcworkspace` file to launch Xcode. From now on, use the `.xcworkspace` to open your project. 
+- Check that your deployment target is set to iOS 13 or later. 
+
+#### Request camera permissions
+
+The DocV iOS SDK requires a device's camera permission to capture identity documents. Upon the first invocation of the SDK, the app will request camera permission from the consumer. If the app does not already use the camera, you must add the following to the app’s `Info.plist file`: 
+
+| Key                                | Type   | Value                                                                                       |
+|------------------------------------|--------|---------------------------------------------------------------------------------------------|
+| Privacy - Camera Usage Description | String | "This application requires use of your camera in order to capture your identity documents." |
+
+
+> **Note:** We recommend you check for camera permission before calling the SocureDocV SDK’s launch API. 
+
+### Run the app
+
+Using the command line, go to your root project folder and enter the following command to run the app: 
+
+```
+"react-native run-ios"
+```
+
+</details>
+
+<details>
+  <summary><b>Integrate with the DocV Android SDK</b></summary>
+
+<br />
+  
+### 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. 
+
+```kotlin {5,6}
+buildscript {
+              .....
+            ext {
+                 ....
+                minSdkVersion = 22 
+                compileSdkVersion = 32
+                .....
+            }
+}
+```
+
+### Camera permissions
+
+The DocV Android SDK requires camera permission to capture identity documents. Upon the first invocation of the SDK, your app will request camera permission from the user.
+
+> **Note:** We recommend you check for camera permissions before calling the Socure DocV SDK’s launch API. 
+
+#### Required permissions
+
+Ensure that your app manifest has been set up properly to request the following required permissions:
+
+```
+<uses-feature android:name="android.hardware.camera" />
+
+<!-- Declare permissions -->
+<uses-permission android:name="android.permission.CAMERA" />
+<uses-permission android:name="android.permission.INTERNET" />
+<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
+```
+
+## Run the app
+
+From the command line, go to your root project folder and enter the following command to run the app: 
+
+```
+react-native run-android
+```
+
+</details>
+
+<br />
+
+## Import and launch the SDK
+
+After you have installed the DocV SDK React Native wrapper using NPM and configured your iOS or Android app, add the following code to your `App.js` file to import `launchSocureDocV`:
+
+```jsx
+import { launchSocureDocV } from "@socure-inc/docv-react-native"
+```
+
+To launch the Socure DocV SDK, specify your SDK key and call the `launchSocureDocV` launch function: 
+
+```jsx
+launchSocureDocV("SOCURE_SDK_KEY", flow, onSuccess, onError);
+```
+
+## How it works
+
+Your React Native application initializes and communicates with the DocV SDK through the React Native wrapper using the `launchSocureDocV` instance. The `launchSocureDocV` function also includes two callback functions, one for `onSuccess` and one for `onError`. See [Response callbacks](#response-callbacks) below for more information.  
+
+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. |  |   |
+| `onSuccess`      | A callback function that notifies you when the flow completes successfully.                                                                                                                                                                                                                                                                                               |   |   |
+| `onError`        | A callback function that notifies you when the flow fails.                                                                                                                                                                                                                                                                                                |   |   |
+
+                                                                                
+## Response callbacks
+
+Your app can receive a response callback from the Socure DocV SDK when the flow completes successfully or returns with an error using the `onSuccess` and `onError` callback functions.
+
+### `onSuccess` response
+When the consumer successfully completes the flow and the captured images are uploaded, the `onSuccess` callback receives the ScannedData object which contains session information and the extracted data. The table below lists the available `ScannedData` properties.
+
+| Result Field   | Type        | Description                                                                                                                                                                                          |
+|----------------|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `docUUID`        | string      | The UUID for the uploaded scanned images.                                                                                                                                                             |
+| `sessionId`      | string      | The session ID for the scan session.                                                                                                                                                                 |
+| `extractedData`  | JSON object | Contains extractedInfo from the barcode or MRZ.                                                                                                                                                      |
+| `captureData`    | JSON object | The mapped capture type for every scan. <br /> Possible keys are: `lic_front`, `lic_back`, `passport`, `selfie` <br /> Possible values can be `manual` or `auto`                                                              |
+| `capturedImages` | JSON object | The mapped image data of captured images. <br /> Possible keys are: `lic_front`, `lic_back`, `passport`, `selfie` <br />  Value will be a base64 image string <br />**Note**: Prefix `data:image/png;base64,` while using base64 string. |
+
+#### Sample `onSuccess` response
+```json
+{
+  "docUUID": "UUID for the uploaded scanned images",
+  "sessionId": "Session ID for the particular scan session",
+  "extractedData": {
+    "address": "123 TAYLOR AVE",
+    "issueDate": "09282007",
+    "parsedAddress": {
+      "city": "SAN BRUNO",
+      "country": "USA",
+      "physicalAddress": "123 TAYLOR AVE",
+      "physicalAddress2": "SAN BRUNO",
+      "postalCode": "940660000",
+      "state": "CA"
+    },
+    "dob": "07221977",
+    "documentNumber": "D12345",
+    "expirationDate": "07222022",
+    "firstName": "SAM",
+    "fullName": "SAM SOTO",
+    "type": "barcode"
+  },
+  "captureData": {
+    "lic_front": "auto",
+    "lic_back": "auto",
+    "passport": "auto",
+    "selfie": "manual"
+  },
+  "capturedImages": {
+    "lic_front": "base64 Image as String",
+    "lic_back": "base64 Image as String",
+    "selfie": "base64 Image as String"
+  }
+}
+```
+
+### `onError` response
+
+If the consumer exits the flow without completing it or the SDK encounters an error, the `onError` callback receives the `ScanError` object which contains session information and the error. The table below lists the available `ScanError` properties.
+
+| Error Field    | Type        | Description                                                                                                                                                                                                          |
+|----------------|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `capturedImages` | JSON object | The mapped image data of captured images (if available). <br /> Possible keys are: `lic_front`, `lic_back`, `passport`, `selfie` <br /> Value will be a base64 image string <br /> **Note**: Prefix `data:image/png;base64,` while using base64 string. |
+| `errorMessage`   | string      | The error code description.                                                                                                                                                                                          |
+| `sessionId`      | string      | The session ID for the particular scan session.                                                                                                                                                                      |
+| `statusCode`     | string      | The error code returned by Socure DocV SDK.                                                                                                                                                                          |
+
+#### Sample `onError` response
+```json
+{
+  "capturedImages": {
+    "passport": "base64 Image as String"
+  },
+  "errorMessage": "Scan canceled by the user",
+  "sessionId": "2a55f9-42bgfa-4fb3-9gf32e-6a6fec5",
+  "statusCode": "7104"
+}
+```
+
+### Error codes
+
+The following table lists the errors that can be returned by Socure DocV SDK:
+
+| Error Code | Error Description (string)                              |
+| ---------- | ------------------------------------------------------- |
+| `7011`       | `Invalid key`                                             |
+| `7021`       | `Failed to initiate the session `                         |
+| `7014`       | `Session expired   `                                      |
+| `7101`       | `Empty key `                                              |
+| `7103`       | `No internet connection  `                                |
+| `7102`       | `Do not have the required permissions to open the camera` |
+| `7022`       | `Failed to upload the documents `                         |
+| `7104`       | `Scan canceled by the user`                               |
+| `7106`       | `Camera error`                                            |
+| `7107`       | `Unknown error`                                           |
+| `7108`       | `Camera resolution doesn't match the minimum requirement` |
+| `7109`       | `Invalid config data`                                     |
+| `7110`       | `Consent declined`                                        |

package/android/build.gradle

@@ -0,0 +1,147 @@
+buildscript {
+  // Buildscript is evaluated before everything else so we can't use getExtOrDefault
+  def kotlin_version = rootProject.ext.has('kotlinVersion') ? rootProject.ext.get('kotlinVersion') : project.properties['SocureDocVReactNative_kotlinVersion']
+
+  repositories {
+      google()
+      mavenCentral()
+  }
+
+  dependencies {
+    classpath 'com.android.tools.build:gradle:3.5.3'
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+  }
+}
+
+def isNewArchitectureEnabled() {
+  return rootProject.hasProperty("newArchEnabled") &&  rootProject.getProperty("newArchEnabled") == "true"
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+if (isNewArchitectureEnabled()) {
+  apply plugin: 'com.facebook.react'
+}
+
+def getExtOrDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['SocureDocVReactNative_' + name]
+}
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties['SocureDocVReactNative_' + name]).toInteger()
+}
+
+android {
+  compileSdkVersion getExtOrIntegerDefault('compileSdkVersion')
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault('minSdkVersion')
+    targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
+    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchitectureEnabled().toString()
+  }
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable 'GradleCompatible'
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_11
+    targetCompatibility JavaVersion.VERSION_11
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+  maven { url "https://jitpack.io" }
+
+  def found = false
+  def defaultDir = null
+  def androidSourcesName = 'React Native sources'
+
+  if (rootProject.ext.has('reactNativeAndroidRoot')) {
+    defaultDir = rootProject.ext.get('reactNativeAndroidRoot')
+  } else {
+    defaultDir = new File(
+      projectDir,
+      '/../../../node_modules/react-native/android'
+    )
+  }
+
+  if (defaultDir.exists()) {
+    maven {
+      url defaultDir.toString()
+      name androidSourcesName
+    }
+
+    logger.info(":${project.name}:reactNativeAndroidRoot ${defaultDir.canonicalPath}")
+    found = true
+  } else {
+    def parentDir = rootProject.projectDir
+
+    1.upto(5, {
+      if (found) return true
+      parentDir = parentDir.parentFile
+
+      def androidSourcesDir = new File(
+        parentDir,
+        'node_modules/react-native'
+      )
+
+      def androidPrebuiltBinaryDir = new File(
+        parentDir,
+        'node_modules/react-native/android'
+      )
+
+      if (androidPrebuiltBinaryDir.exists()) {
+        maven {
+          url androidPrebuiltBinaryDir.toString()
+          name androidSourcesName
+        }
+
+        logger.info(":${project.name}:reactNativeAndroidRoot ${androidPrebuiltBinaryDir.canonicalPath}")
+        found = true
+      } else if (androidSourcesDir.exists()) {
+        maven {
+          url androidSourcesDir.toString()
+          name androidSourcesName
+        }
+
+        logger.info(":${project.name}:reactNativeAndroidRoot ${androidSourcesDir.canonicalPath}")
+        found = true
+      }
+    })
+  }
+
+  if (!found) {
+    throw new GradleException(
+      "${project.name}: unable to locate React Native android sources. " +
+      "Ensure you have you installed React Native as a dependency in your project and try again."
+    )
+  }
+}
+
+def kotlin_version = getExtOrDefault('kotlinVersion')
+
+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.0.1"
+// From node_modules
+}
+
+if (isNewArchitectureEnabled()) {
+  react {
+    jsRootDir = file("../src/")
+    libraryName = "SocureDocVReactNative"
+    codegenJavaPackageName = "com.socure.docv.reactnative"
+  }
+}

package/android/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.8-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/android/gradle.properties

@@ -0,0 +1,5 @@
+SocureDocVReactNative_kotlinVersion=1.7.0
+SocureDocVReactNative_minSdkVersion=22
+SocureDocVReactNative_targetSdkVersion=32
+SocureDocVReactNative_compileSdkVersion=32
+SocureDocVReactNative_ndkversion=21.4.7075529

package/android/gradlew

@@ -0,0 +1,185 @@
+#!/usr/bin/env sh
+
+#
+# Copyright 2015 the original author or authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+        PRG="$link"
+    else
+        PRG=`dirname "$PRG"`"/$link"
+    fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn () {
+    echo "$*"
+}
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+  CYGWIN* )
+    cygwin=true
+    ;;
+  Darwin* )
+    darwin=true
+    ;;
+  MINGW* )
+    msys=true
+    ;;
+  NONSTOP* )
+    nonstop=true
+    ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+        JAVACMD="$JAVA_HOME/bin/java"
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD="java"
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+    MAX_FD_LIMIT=`ulimit -H -n`
+    if [ $? -eq 0 ] ; then
+        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+            MAX_FD="$MAX_FD_LIMIT"
+        fi
+        ulimit -n $MAX_FD
+        if [ $? -ne 0 ] ; then
+            warn "Could not set maximum file descriptor limit: $MAX_FD"
+        fi
+    else
+        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+    fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
+    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+
+    JAVACMD=`cygpath --unix "$JAVACMD"`
+
+    # We build the pattern for arguments to be converted via cygpath
+    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+    SEP=""
+    for dir in $ROOTDIRSRAW ; do
+        ROOTDIRS="$ROOTDIRS$SEP$dir"
+        SEP="|"
+    done
+    OURCYGPATTERN="(^($ROOTDIRS))"
+    # Add a user-defined pattern to the cygpath arguments
+    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+    fi
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    i=0
+    for arg in "$@" ; do
+        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
+
+        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
+            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+        else
+            eval `echo args$i`="\"$arg\""
+        fi
+        i=`expr $i + 1`
+    done
+    case $i in
+        0) set -- ;;
+        1) set -- "$args0" ;;
+        2) set -- "$args0" "$args1" ;;
+        3) set -- "$args0" "$args1" "$args2" ;;
+        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+    esac
+fi
+
+# Escape application args
+save () {
+    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+    echo " "
+}
+APP_ARGS=`save "$@"`
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+exec "$JAVACMD" "$@"

package/android/gradlew.bat

@@ -0,0 +1,89 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,4 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.socure.docv.reactnative">
+
+</manifest>

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

@@ -0,0 +1,130 @@
+package com.socure.docv.reactnative
+
+import android.app.Activity
+import android.content.Intent
+import android.util.Base64
+import com.facebook.react.bridge.*
+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.common.utils.ResultListener
+import com.socure.docv.capturesdk.common.utils.ScanError
+import com.socure.docv.capturesdk.common.utils.ScannedData
+import org.json.JSONException
+import org.json.JSONObject
+
+class SocureDocVReactNativeModule(reactContext: ReactApplicationContext) :
+    ReactContextBaseJavaModule(reactContext), ActivityEventListener {
+
+    private var onSuccessCallback: Callback? = null
+    private var onErrorCallback: Callback? = null
+
+    init {
+        reactApplicationContext.addActivityEventListener(this)
+    }
+
+    override fun getName(): String {
+        return "SocureDocVReactNative"
+    }
+
+    @ReactMethod
+    fun launchSocureDocV(
+        socureApiKey: String,
+        flow: String?,
+        onSuccess: Callback,
+        onError: Callback
+    ) {
+        this.onSuccessCallback = onSuccess
+        this.onErrorCallback = onError
+        setSource(REACT_NATIVE)
+        currentActivity?.startActivityForResult(
+            getIntent(currentActivity!!, socureApiKey, flow),
+            123
+        )
+    }
+
+    override fun onActivityResult(
+        activity: Activity?,
+        requestCode: Int,
+        resultCode: Int,
+        data: Intent?
+    ) {
+        data?.let {
+            getResult(data, object : ResultListener {
+                override fun onSuccess(scannedData: ScannedData) {
+                    onSuccessCallback?.invoke(convertResultToReadbleMap(scannedData))
+                }
+
+                override fun onError(scanError: ScanError) {
+                    onErrorCallback?.invoke(convertErrorToReadableMap(scanError))
+                }
+            })
+        }
+    }
+
+    override fun onNewIntent(intent: Intent?) {}
+
+    private fun convertResultToReadbleMap(scannedData: ScannedData): ReadableMap {
+        val docVResponse: WritableMap = Arguments.createMap()
+        docVResponse.putString("docUUID", scannedData.docUUID)
+        docVResponse.putString("sessionId", scannedData.sessionId)
+
+        val captureData: WritableMap = Arguments.createMap()
+        scannedData.captureData?.forEach {
+            captureData.putString(it.key, it.value)
+        }
+        docVResponse.putMap("captureData", captureData)
+
+        val capturedImages: WritableMap = Arguments.createMap()
+        scannedData.capturedImages?.forEach {
+            capturedImages.putString(it.key, Base64.encodeToString(it.value, Base64.DEFAULT) ?: "")
+        }
+        docVResponse.putMap("capturedImages", capturedImages)
+
+        scannedData.extractedData?.let { jsonString ->
+            try {
+                docVResponse.putMap("extractedData", convertStringToMap(JSONObject(jsonString)))
+            } catch (ex: JSONException) {
+                docVResponse.putString("extractedData", jsonString)
+            }
+        }
+
+        return docVResponse
+    }
+
+    private fun convertErrorToReadableMap(scanError: ScanError): ReadableMap {
+        val docVErrResponse: WritableMap = Arguments.createMap()
+        docVErrResponse.putString("statusCode", scanError.statusCode.toString())
+        docVErrResponse.putString("errorMessage", scanError.errorMessage)
+        scanError.sessionId?.let {
+            docVErrResponse.putString("sessionId", it)
+        }
+
+        val capturedImages: WritableMap = Arguments.createMap()
+        scanError.capturedImages?.forEach {
+            capturedImages.putString(it.key, Base64.encodeToString(it.value, Base64.DEFAULT) ?: "")
+        }
+        docVErrResponse.putMap("capturedImages", capturedImages)
+
+        return docVErrResponse
+    }
+
+    private fun convertStringToMap(jsonObject: JSONObject): ReadableMap {
+        val responseMap: WritableMap = Arguments.createMap()
+        val jsonIterator = jsonObject.keys()
+        while (jsonIterator.hasNext()) {
+            val key: String = jsonIterator.next()
+            when (val value = jsonObject[key]) {
+                is JSONObject -> {
+                    responseMap.putMap(key, convertStringToMap(value))
+                }
+                is String -> {
+                    responseMap.putString(key, value)
+                }
+            }
+        }
+        return responseMap
+    }
+
+}

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

@@ -0,0 +1,17 @@
+package com.socure.docv.reactnative
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+
+class SocureDocVReactNativePackage : ReactPackage {
+    override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+        return listOf(SocureDocVReactNativeModule(reactContext))
+    }
+
+    override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+        return emptyList()
+    }
+}

package/ios/SocureDocVReactNative-Bridging-Header.h

@@ -0,0 +1,5 @@
+#import <React/RCTBridgeModule.h>
+#import <React/RCTViewManager.h>
+#import <React/RCTBridge.h>
+#import <React/RCTEventDispatcher.h>
+#import <React/RCTUtils.h>

package/ios/SocureDocVReactNative.m

@@ -0,0 +1,14 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE(SocureDocVReactNative, NSObject)
+
+RCT_EXTERN_METHOD(launchSocureDocV:(NSString)socureApiKey flow:(NSString)flow
+                  onSuccess:(RCTResponseSenderBlock)success
+                  onError:(RCTResponseSenderBlock)error)
+
++ (BOOL)requiresMainQueueSetup
+{
+  return NO;
+}
+
+@end

package/ios/SocureDocVReactNative.swift

@@ -0,0 +1,48 @@
+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
+              }
+          })
+      }
+  }
+    
+    @objc static func requiresMainQueueSetup() -> Bool {
+      return false
+    }
+}
+
+extension String {
+    func convertToDictionary() throws -> [String: Any]? {
+        if let data = self.data(using: .utf8) {
+            do {
+                return try JSONSerialization.jsonObject(with: data, options: []) as? [String: Any]
+            } catch {
+                throw error
+            }
+        }
+        return nil
+    }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@socure-inc/docv-react-native",
+  "version": "3.0.0",
+  "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.",
+  "main": "lib/commonjs/index",
+  "module": "lib/module/index",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "socure",
+    "socure-docv",
+    "document-verification"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/socure-inc/socure-docv-demo-app-react-native.git"
+  },
+  "author": "Socure <support@socure.com>",
+  "license": "SEE LICENSE IN License.txt",
+  "homepage": "https://github.com/socure-inc/socure-docv-demo-app-react-native",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "react": ">=16.13.1",
+    "react-native": ">=0.66.0"
+  },
+  "devDependencies": {
+    "react": "17.0.2",
+    "react-native": "0.68.2"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

package/socure-docv-react-native.podspec

@@ -0,0 +1,23 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+folly_version = '2021.06.28.00-v2'
+folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+
+Pod::Spec.new do |s|
+  s.name         = "socure-docv-react-native"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+  s.source       = { :git => "https://github.com/socure-inc/socure-docv-demo-app-react-native", :tag => "#{s.version}" }
+
+  s.platforms    = { :ios => "13.0" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  s.dependency "React"
+  s.dependency "SocureDocV", "3.0.2"
+
+end

package/src/index.tsx

@@ -0,0 +1,69 @@
+import { NativeModules } from 'react-native';
+
+const LINKING_ERROR =
+  `The package '@socure-inc/docv-react-native' doesn't seem to be linked.\n\n` +
+  '- Rebuilt the app after installing the package';
+
+const SocureDocVReactNative = NativeModules.SocureDocVReactNative ? NativeModules.SocureDocVReactNative : new Proxy(
+  {},
+  {
+    get() {
+      throw new Error(LINKING_ERROR);
+    },
+  }
+);
+
+export function launchSocureDocV(socureApiKey: string, flow: string | null | undefined, onSuccess: Function, onError: Function) {
+  if (typeof socureApiKey !== 'string') {
+    onConfigError("7011", "Invalid key", onError)
+  } else if (flow && typeof flow !== 'string') {
+    onConfigError("7109", "Invalid config data", onError)
+  } else {
+    return SocureDocVReactNative.launchSocureDocV(socureApiKey, flow, onSuccess, onError);
+  }
+}
+
+function onConfigError(errorCode: string, errorMessage: string, onError?: Function) {
+  let error = { statusCode: errorCode, errorMessage: errorMessage } as ScanError
+  if (onError && typeof onError == 'function') {
+    onError(error)
+  } else {
+    throw Promise.reject(error)
+  }
+}
+
+export interface ScannedData {
+  docUUID: string
+  sessionId: string
+  extractedData?: ExtractedInfo
+  captureData: { [doc_type: string]: [capture_type: string] }
+  capturedImages: { [doc_type: string]: [image_data: string] }
+}
+
+export interface ScanError {
+  statusCode: string
+  errorMessage: string
+  sessionId?: string
+  capturedImages?: { [doc_type: string]: [image_data: string] }
+}
+
+export interface ExtractedInfo {
+  type?: string
+  expirationDate?: string
+  dob?: string
+  firstName?: string
+  fullName?: string
+  documentNumber?: string
+  address?: string
+  surName?: string
+  issueDate?: string
+  parsedAddress?: AddressInfo
+}
+
+export interface AddressInfo {
+  state?: String
+  postalCode?: String
+  city?: String
+  country?: String
+  physicalAddress?: String
+}