@regulaforensics/idv 3.2.1-nightly

package/examples/ionic/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "idv",
+  "scripts": {
+    "setup": "scripts/setup.sh",
+    "ios": "scripts/ios.sh",
+    "android": "scripts/android.sh"
+  },
+  "dependencies": {
+    "@angular-devkit/build-angular": "^20.3.1",
+    "@angular/cli": "^20.3.1",
+    "@angular/common": "^20.3.0",
+    "@angular/compiler-cli": "^20.3.0",
+    "@angular/core": "^20.3.0",
+    "@angular/forms": "^20.3.0",
+    "@angular/platform-browser-dynamic": "^20.3.0",
+    "@angular/router": "^20.3.0",
+    "@ionic/angular": "^8.7.3",
+    "@ionic/cordova-builders": "^12.3.0",
+    "@regulaforensics/idv": "3.2.1-nightly",
+    "@regulaforensics/document-reader": "8.4.2-nightly",
+    "@regulaforensics/face-sdk": "8.1.1-nightly",
+    "@regulaforensics/document-reader-core-fullauthrfid": "8.4.7-nightly",
+    "@regulaforensics/face-core-basic": "8.1.1-nightly",
+    "@regulaforensics/idv-module-document-reader": "file:../ftp_5",
+    "@regulaforensics/idv-module-face": "file:../ftp_6",
+    "cordova-android": "^14.0.1",
+    "cordova-ios": "^7.1.1",
+    "cordova-plugin-ionic-webview": "^5.0.1"
+  },
+  "cordova": {
+    "plugins": {
+      "@regulaforensics/document-reader": {},
+      "@regulaforensics/document-reader-core-fullauthrfid": {},
+      "@regulaforensics/face-sdk": {},
+      "@regulaforensics/face-core-basic": {},
+      "@regulaforensics/idv": {},
+      "@regulaforensics/idv-module-face": {},
+      "@regulaforensics/idv-module-document-reader": {},
+      "cordova-plugin-ionic-webview": {}
+    },
+    "platforms": [
+      "android",
+      "ios"
+    ]
+  }
+}

package/examples/ionic/scripts/android.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+if [[ $npm_config_o || $npm_config_open ]]; then
+    ionic cordova build android
+    studio platforms/android || open -a 'Android Studio' platforms/android
+else
+    ionic cordova run android
+fi

package/examples/ionic/scripts/ios.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+if [[ $npm_config_o || $npm_config_open ]]; then
+    ionic cordova prepare ios
+    open platforms/ios/IDV.xcworkspace
+else
+    ionic cordova run ios
+fi

package/examples/ionic/scripts/setup.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -e
+
+npm install
+ionic cordova prepare || {
+    pod repo update
+    ionic cordova prepare
+}

package/examples/ionic/src/main.css

@@ -0,0 +1,148 @@
+html,
+body {
+    margin: 0;
+    width: 100%;
+    height: 99vh;
+    display: flex;
+    overflow: hidden;
+    flex-direction: column;
+}
+
+/* Prevent text selection */
+* {
+    user-select: none !important;
+    -webkit-user-select: none !important;
+    -webkit-user-drag: none !important;
+    -webkit-touch-callout: none !important;
+}
+
+.column {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    width: 100%;
+}
+
+.row {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    justify-content: center;
+}
+
+.header {
+    text-align: center;
+    padding-top: 80px;
+    margin-top: -10px;
+    background-color: rgba(0, 0, 0, 0.03);
+    font-weight: 600;
+    font-size: 18px;
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+}
+
+.sub-header {
+    background-color: rgba(0, 0, 0, 0.03); 
+    width: 100%; 
+    padding-top: 13px; 
+    text-align: center; 
+    font-weight: 550; 
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+}
+
+.divider {
+    height: 1px;
+    background-color: rgba(0, 0, 0, 0.075);
+    margin-top: 13px;
+}
+
+.scroll {
+    flex-grow: 1;
+    overflow-y: auto;
+}
+
+.no-scroll {
+    flex-grow: 1;
+    overflow-y: hidden;
+}
+
+.button {
+    width: 175px;
+    height: 40px;
+    margin: 5px;
+    margin-top: 10px;
+    background-color: #4285F4;
+    color: white;
+    border: none;
+    padding: 10px 20px;
+    justify-content: center;
+    font-size: 16px;
+    border-radius: 100px;
+    cursor: pointer;
+    transition: all 0.3s ease;
+    user-select: none;
+    -webkit-user-select: none;
+    -moz-user-select: none;
+    -ms-user-select: none;
+}
+
+.button:active {
+    position: relative;
+    top: 1px;
+}
+
+.text-button {
+    background: none;
+    border: none;
+    color: #2196f3;
+    font-size: 20px;
+    font-weight: bold;
+    padding: 5px;
+}
+
+.text-button:active {
+    position: relative;
+    top: 1px;
+}
+
+.radio {
+    align-items: baseline;
+    padding: 15px;
+}
+
+input[type="checkbox"] {
+    width: 20px;
+    height: 20px;
+    border: 2px solid black;
+    background-color: white;
+    display: inline-block;
+    position: relative;
+    cursor: pointer;
+}
+
+input[type="text"] {
+    width: 173px;
+    height: 40px;
+    font-size: 15px;
+    margin: 5px;
+    border-radius: 100px;
+    padding-left: 10px;
+    padding-right: 10px;
+    margin-top: 10px;
+}
+
+.progress-bar {
+    width: 75%;
+    padding: 3px;
+    margin-top: 40px;
+    background-color: #eee;
+    border-radius: 8px;
+    box-shadow: inset 0 0 5px rgba(0, 0, 0, 0.2);
+}
+
+#progress {
+    width: 0%;
+    height: 20px;
+    background-color: #4285F4;
+    border-radius: 5px;
+}

package/examples/ionic/src/main.html

@@ -0,0 +1,17 @@
+<div class="column" style="height: 100%">
+    <div class="column header">
+        <span id="status">Initializing...</span>
+        <div class="column divider"></div>
+    </div>
+    <div id="sub-header" class="column sub-header" style="display: none;">
+        <span id="description"></span>
+        <div class="column divider"></div>
+    </div>
+    <div id="main" class="column no-scroll">
+        <div class="column no-scroll" style="padding-top: 15px; background-color: rgba(0, 0, 0, 0.03);">
+            <div id="radio-group" class="scroll"></div>
+        </div>
+        <button id="start-workflow" class="button" style="width: 360px">Start Workflow</button>
+        <div style="padding-top: 30px"></div>
+    </div>
+</div>

package/examples/ionic/src/main.tsx

@@ -0,0 +1,124 @@
+import { IDV, Workflow } from '@regulaforensics/idv'
+
+enum Configuration { credentials, token, apiKey }
+
+const loginType: Configuration = Configuration.credentials
+const baseUrl = "https://idv.regula.app"
+const username = "username_placeholder"
+const password = "password_placeholder"
+const tokenUrl = "token_placeholder"
+const apiKey = "api_key_placeholder"
+
+var idv = IDV.instance
+var selectedWorkflow = ""
+var workflowIds: string[] = []
+
+async function init() {
+    var [_, iError] = await idv.initialize()
+    if (handleException(iError, "initialize")) return
+
+    var success = ({
+        [Configuration.credentials]: async () => await configureWithCredentials(),
+        [Configuration.token]: async () => await configureWithToken(),
+        [Configuration.apiKey]: async () => await configureApiKey(),
+    })[loginType]!
+    if (!await success()) return
+
+    var [wfs, error] = await idv.getWorkflows()
+    if (handleException(error, "getWorkflows")) return
+    if (loginType == Configuration.token) {
+        wfs = wfs!.filter((wf: any) => workflowIds.includes(wf.id))
+    }
+
+    setWorkflows(wfs!)
+    setStatus("Ready")
+}
+
+async function configureWithCredentials(): Promise<boolean> {
+    var [success, error] = await idv.configureWithCredentials({
+        baseUrl: baseUrl,
+        userName: username,
+        password: password
+    })
+    handleException(error, "configureWithCredentials")
+    return success
+}
+
+async function configureWithToken(): Promise<boolean> {
+    var [wfIds, error] = await idv.configureWithToken({ url: tokenUrl })
+    if (handleException(error, "configureWithToken")) return false
+    workflowIds = wfIds!
+    return true
+}
+
+async function configureApiKey(): Promise<boolean> {
+    var [success, error] = await idv.configureWithApiKey({ baseUrl, apiKey })
+    handleException(error, "configureWithApiKey")
+    return success
+}
+
+async function startWorkflow(): Promise<void> {
+    if (selectedWorkflow.length == 0) return
+    setStatus("Preparing Workflow...")
+
+    var [_, prepareError] = await idv.prepareWorkflow({ workflowId: selectedWorkflow })
+    if (handleException(prepareError, "prepareWorkflow")) return
+
+    var [result, error] = await idv.startWorkflow()
+    if (handleException(error, "startWorkflow")) return
+
+    setStatus("Success")
+    setDescription(`SessionID: ${result?.sessionId}`)
+}
+
+function handleException(error?: string | null, tag?: string): boolean {
+    if (error == null) return false
+    setStatus(`Error - IDV.${tag}()`)
+    setDescription(error)
+    console.log(error)
+    return true
+}
+
+// --------------------------------------------------------------------------------------------------------------------
+
+export function main() {
+    document.getElementById("start-workflow")!.onclick = () => startWorkflow()
+
+    init()
+}
+
+var setStatus = (data: string) => document.getElementById("status")!.innerHTML = data
+var setDescription = (data: string) => {
+    document.getElementById("description")!.innerHTML = data
+    document.getElementById("sub-header")!.style.display = data.length > 0 ? "block" : "none"
+}
+
+var workflows: Workflow[] = []
+function setWorkflows(data: Workflow[]) {
+    var radioGroup = document.getElementById("radio-group")!
+    workflows = data
+    if (workflows.length != 0) {
+        selectedWorkflow = workflows[0].id
+    }
+
+    data.forEach(item => {
+        var checked = selectedWorkflow == item.id ? "checked" : ""
+        var radioElement = `
+        <div class="row radio">
+            <input type="radio" name="radio" id="${item.id}" value="${item.id}" ${checked}>
+            <span id="${item.id}-caption" style="width: 200px; padding-left: 5px;">${item.name}</span>
+        </div>`
+        radioGroup.insertAdjacentHTML("beforeend", radioElement)
+    })
+
+    data.forEach(item => {
+        var element = document.getElementById(item.id) as HTMLInputElement
+        var elementCaption = document.getElementById(item.id + "-caption")!
+        var onclick = () => {
+            selectedWorkflow = item.id
+            element.checked = true
+        }
+        element.onclick = onclick
+        elementCaption.onclick = onclick
+    })
+}

package/examples/ionic/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "include": [
+    "*.tsx"
+  ],
+  "compilerOptions": {
+    "types": [],
+    "module": "esnext",
+    "moduleResolution": "node",
+    "experimentalDecorators": true,
+    "target": "es2022",
+    "jsx": "react-jsx",
+    "skipLibCheck": true, // Temp fix for https://github.com/ionic-team/ionic-framework/issues/30650
+  }
+}

package/examples/react_native/README.md

@@ -0,0 +1,15 @@
+# Regula IDV React Native demo application
+
+## How to build demo application
+1. Download or the clone current repository using the command `git clone https://github.com/regulaforensics/npm-idv.git`.
+2. Put `regula.license` file at `assets/` (you can get a trial license [here](https://client.regulaforensics.com)).
+3. Put `db.dat` file at `assets/` (you can get a trial database [here](https://client.regulaforensics.com/customer/databases))
+4. Execute `npm run setup` within this directory.
+5. In `src/main.tsx` choose prefered login configuration(`loginType` variable) and provide your login data according to it: username and password for `credentials`, tokenUrl for `token`, apiKey for `apiKey`.
+6. Run the app: 
+  * IOS: `npm run ios`.
+  * Android: `npm run android`.
+7. After initialization choose **General KYC - AP** from workflows list and click **Start Workflow** button.
+8. Complete workflow and get your session id.
+
+**Note**: `npm run ios`/`npm run android` is just one way of running the app. You can also pass `-o` or `--open` argument to the command, and this will open Xcode/Android Studio, then run the app directly from the IDE. Overall, this is a more consistent way, so if you're having troubles running the app from terminal, try running it from the IDE. Just don't forget to make sure that Metro Bundler is running(`npm start`).

package/examples/react_native/app.config.ts

@@ -0,0 +1,46 @@
+import { ExpoConfig, ConfigContext } from 'expo/config'
+
+export default ({ config }: ConfigContext): ExpoConfig => ({
+  ...config,
+  slug: 'idv',
+  name: 'IDV',
+  orientation: 'portrait',
+  icon: 'images/icon.png',
+  ios: {
+    bundleIdentifier: 'com.regula.example.idv.react',
+    infoPlist: {
+      NSCameraUsageDescription: 'To use camera',
+      NSPhotoLibraryUsageDescription: 'To use gallery',
+      NFCReaderUsageDescription: 'To use NFC',
+      'com.apple.developer.nfc.readersession.iso7816.select-identifiers': [
+        'A0000002471001',
+        'E80704007F00070302',
+        'A000000167455349474E',
+        'A0000002480100',
+        'A0000002480200',
+        'A0000002480300',
+        'A00000045645444C2D3031'
+      ]
+    },
+    entitlements: { 'com.apple.developer.nfc.readersession.formats': ['TAG'] },
+    appleTeamId: ''
+  },
+  android: {
+    package: 'com.regula.example.idv.react',
+    permissions: ['android.permission.NFC'],
+    edgeToEdgeEnabled: true
+  },
+  plugins: [
+    ['expo-custom-assets', { assetsPaths: ['./assets'] }],
+    ['expo-build-properties', {
+      android: {
+        extraMavenRepos: [
+          { url: 'https://maven.regulaforensics.com/RegulaDocumentReader' },
+          { url: 'https://maven.regulaforensics.com/RegulaDocumentReader/Beta' },
+          { url: 'https://maven.regulaforensics.com/RegulaDocumentReader/Nightly' },
+          { url: 'https://maven.regulaforensics.com/RegulaDocumentReader/Stage' }
+        ]
+      }
+    }]
+  ]
+})

package/examples/react_native/index.html

@@ -0,0 +1,12 @@
+<meta name="viewport" content="initial-scale=1, user-scalable=no, viewport-fit=cover">
+<link rel="stylesheet" href="src/main.css">
+
+<div id="content" style="height: 100%"></div>
+
+<script>
+    (async () => {
+        document.getElementById("content").innerHTML = await fetch("src/main.html").then(r => r.text())
+        await new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(resolve)))
+        window.ReactNativeWebView.postMessage(JSON.stringify({ id: "ready" }))
+    })()
+</script>

package/examples/react_native/index.tsx

@@ -0,0 +1,63 @@
+import { registerRootComponent } from 'expo'
+import WebView from 'react-native-webview'
+import React from 'react'
+import { main } from './src/main'
+
+var webViewRef: any
+const onclicks: any = {}
+const onMessage = (json: any) => {
+  const event = JSON.parse(json.nativeEvent.data)
+  if (event.id === "ready") main()
+  if (event.id === "onclick") {
+    onclicks[event.value]()
+  }
+}
+
+const document = {
+  getElementById(id: string): any {
+    return new Proxy({}, {
+      set(_, prop: string, value) {
+        if (prop == "onclick") {
+          onclicks[id] = value
+          webViewRef.injectJavaScript(`
+            document.getElementById("${id}").onclick = () => {
+              window.ReactNativeWebView.postMessage(JSON.stringify({ id: "onclick", value: "${id}" }));
+            }; true
+          `)
+        } else
+          webViewRef.injectJavaScript(`document.getElementById("${id}").${prop} = ${parseValue(value)}; true`)
+        return true
+      },
+      get(_, prop: string) {
+        if (prop === "style") return new Proxy({}, {
+          set(_, styleProp: string, value) {
+            webViewRef.injectJavaScript(`document.getElementById("${id}").style.${styleProp} = ${parseValue(value)}; true`)
+            return true
+          }
+        })
+        if (prop === "insertAdjacentHTML") return (position: string, html: string) => {
+          webViewRef.injectJavaScript(`document.getElementById("${id}").insertAdjacentHTML('${position}', \`${html}\`); true`)
+          return true
+        }
+        return undefined
+      }
+    }
+    )
+  }
+}
+
+function parseValue(value: any) {
+  if (value !== true && value !== false) return `"${value}"`
+  return value
+}
+
+(globalThis as any).document = document;
+registerRootComponent(() =>
+  <WebView
+    ref={ref => { webViewRef = ref }}
+    onMessage={onMessage}
+    source={require("./index.html")}
+    scrollEnabled={false}
+    overScrollMode={'content'}
+  />
+)

package/examples/react_native/metro.config.js

@@ -0,0 +1,7 @@
+const config = require('expo/metro-config').getDefaultConfig(__dirname)
+config.watchFolders = [
+    __dirname + '/node_modules'
+]
+config.resolver.nodeModulesPaths = config.watchFolders
+config.resolver.assetExts.push('css')
+module.exports = config