@regulaforensics/document-reader 8.2.186-beta → 8.3.242-beta

package/RNDocumentReader.podspec

@@ -5,7 +5,7 @@ source = File.join(__dir__, 'ios')
 
 Pod::Spec.new do |s|
   s.name         = 'RNDocumentReader'
-  s.version      = '8.2.186-beta'
+  s.version      = '8.3.242-beta'
   s.summary      = package['description']
   s.license      = package['license']
 
@@ -16,6 +16,6 @@ Pod::Spec.new do |s|
   s.ios.deployment_target = '13.0'
   s.source_files = 'ios/**/*.{h,m}'
   s.exclude_files = [ 'ios/CVDDocumentReader.h', 'ios/CVDDocumentReader.m' ]
-  s.dependency 'DocumentReader', '8.1.4772'
+  s.dependency 'DocumentReader', '8.2.4934'
   s.dependency 'React'
 end

package/android/build.gradle

@@ -29,7 +29,7 @@ dependencies {
     //noinspection GradleDynamicVersion
     implementation 'com.facebook.react:react-native:+'
     //noinspection GradleDependency
-    implementation('com.regula.documentreader:api:8.1.11551'){
+    implementation('com.regula.documentreader:api:8.2.11679'){
         transitive = true
     }
 }

package/android/cordova.gradle

@@ -6,7 +6,7 @@ repositories {
 
 dependencies {
     //noinspection GradleDependency
-    implementation('com.regula.documentreader:api:8.1.11551'){
+    implementation('com.regula.documentreader:api:8.2.11679'){
         transitive = true
     }
 }

package/android/src/main/java/com/regula/plugin/documentreader/Config.kt

@@ -137,6 +137,7 @@ fun setProcessParams(processParams: ProcessParam, opts: JSONObject) = opts.forEa
         "generateDTCVC" -> processParams.generateDTCVC = v as Boolean
         "strictDLCategoryExpiry" -> processParams.strictDLCategoryExpiry = v as Boolean
         "generateAlpha2Codes" -> processParams.generateAlpha2Codes = v as Boolean
+        "disableAuthResolutionFilter" -> processParams.disableAuthResolutionFilter = v as Boolean
         "measureSystem" -> processParams.measureSystem = v.toInt()
         "barcodeParserType" -> processParams.barcodeParserType = v.toInt()
         "perspectiveAngle" -> processParams.perspectiveAngle = v.toInt()
@@ -221,6 +222,7 @@ fun getProcessParams(processParams: ProcessParam) = mapOf(
     "generateDTCVC" to processParams.generateDTCVC,
     "strictDLCategoryExpiry" to processParams.strictDLCategoryExpiry,
     "generateAlpha2Codes" to processParams.generateAlpha2Codes,
+    "disableAuthResolutionFilter" to processParams.disableAuthResolutionFilter,
     "measureSystem" to processParams.measureSystem,
     "barcodeParserType" to processParams.barcodeParserType,
     "perspectiveAngle" to processParams.perspectiveAngle,
@@ -316,6 +318,7 @@ fun setCustomization(customization: ParamsCustomization, opts: JSONObject) = opt
         "torchButtonOnImage" -> editor.setTorchImageOn(v.toDrawable())
         "torchButtonOffImage" -> editor.setTorchImageOff(v.toDrawable())
         "livenessAnimationImage" -> editor.setLivenessAnimationImage(v.toDrawable())
+        "multipageButtonImage" -> editor.setMultipageButtonImage(v.toDrawable())
         "helpAnimationImageMatrix" -> editor.setHelpAnimationImageMatrix(matrixFromJSON(v as JSONArray?)).setHelpAnimationImageScaleType(ImageView.ScaleType.MATRIX)
         "multipageAnimationFrontImageMatrix" -> editor.setMultipageAnimationFrontImageMatrix(matrixFromJSON(v as JSONArray?)).setMultipageAnimationFrontImageScaleType(ImageView.ScaleType.MATRIX)
         "multipageAnimationBackImageMatrix" -> editor.setMultipageAnimationBackImageMatrix(matrixFromJSON(v as JSONArray?)).setMultipageAnimationBackImageScaleType(ImageView.ScaleType.MATRIX)
@@ -401,6 +404,7 @@ fun getCustomization(customization: ParamsCustomization) = mapOf(
     "torchButtonOnImage" to customization.torchImageOnDrawable.toBase64(),
     "torchButtonOffImage" to customization.torchImageOffDrawable.toBase64(),
     "livenessAnimationImage" to customization.livenessAnimationImage.toBase64(),
+    "multipageButtonImage" to customization.multipageButtonDrawable.toBase64(),
     "helpAnimationImageMatrix" to generateMatrix(customization.helpAnimationImageMatrix),
     "multipageAnimationFrontImageMatrix" to generateMatrix(customization.multipageAnimationFrontImageMatrix),
     "multipageAnimationBackImageMatrix" to generateMatrix(customization.multipageAnimationBackImageMatrix),

package/android/src/main/java/com/regula/plugin/documentreader/Main.kt

@@ -55,6 +55,8 @@ fun methodCall(method: String, callback: (Any?) -> Unit): Any = when (method) {
     "setTenant" -> setTenant(argsNullable(0))
     "getEnv" -> getEnv(callback)
     "setEnv" -> setEnv(argsNullable(0))
+    "getLocale" -> getLocale(callback)
+    "setLocale" -> setLocale(argsNullable(0))
     "getFunctionality" -> getFunctionality(callback)
     "setFunctionality" -> setFunctionality(args(0))
     "getProcessParams" -> getProcessParams(callback)
@@ -160,6 +162,10 @@ fun getEnv(callback: Callback) = callback(Instance().env)
 
 fun setEnv(tag: String?) = tag.let { Instance().env = it }
 
+fun getLocale(callback: Callback) = callback(Instance().locale)
+
+fun setLocale(locale: String?) = locale.let { Instance().locale = it }
+
 fun getFunctionality(callback: Callback) = callback(getFunctionality(Instance().functionality()))
 
 fun setFunctionality(functionality: JSONObject) = setFunctionality(Instance().functionality(), functionality)

package/examples/capacitor/README.md

@@ -10,3 +10,13 @@
   * Android: `npm run android`.
 
 **Note**: this 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.
+
+## Additional examples
+
+### Bluetooth device
+
+In order to connect to an external scanning device, change the `useBtDevice` constant to true in `src/extra/bt_device`, and set `btDeviceName` to the name of you device. After running the app, click `Connect`.
+
+### RFID self hosted UI
+
+This app also demonstraits how you can implement you own UI for the RFID reading process. To enable it, change the `useRfidSelfHostedUI` constant to true in `src/extra/custom_rfid`. Run the app and initiate RFID reading.

package/examples/capacitor/index.html

@@ -1,10 +1,5 @@
 <meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
-<script type="module" src="/src/main.tsx"></script>
-
 <div id="content" style="height: 100%"></div>
 
-<script>
-    fetch("main.html")
-        .then(response => response.text())
-        .then(html => document.getElementById("content").innerHTML = html)
-</script>
+<script type="module" src="./index.tsx"></script>
+<script type="module" src="/src/main.tsx"></script>

package/examples/capacitor/index.tsx

@@ -0,0 +1,39 @@
+import '@ionic/react/css/core.css'
+import '/src/main.css'
+import { setupIonicReact } from '@ionic/react'
+import { StatusBar, Style } from '@capacitor/status-bar'
+import { File } from '@awesome-cordova-plugins/file'
+import { Camera, DestinationType, MediaType, PictureSourceType } from '@awesome-cordova-plugins/camera'
+import { main } from './src/main'
+
+document.addEventListener('deviceready', () => fetch("main.html")
+    .then(response => response.text())
+    .then(html => document.getElementById("content").innerHTML = html)
+    .then(_ => document.dispatchEvent(new Event('ready')))
+)
+
+export async function loadAsset(path: string): Promise<string> {
+    var dir = await File.resolveDirectoryUrl(File.applicationDirectory + "public/assets")
+    var fileEntry = await File.getFile(dir, path, {})
+    var result = await new Promise<string>((resolve, _) => {
+        fileEntry.file(file => {
+            var reader = new FileReader()
+            reader.onloadend = (_) => resolve(reader.result as string)
+            reader.readAsDataURL(file)
+        })
+    })
+    return result
+}
+
+export async function pickImage(): Promise<string | null> {
+    return await Camera.getPicture({
+        destinationType: DestinationType.DATA_URL,
+        mediaType: MediaType.PICTURE,
+        sourceType: PictureSourceType.PHOTOLIBRARY
+    })
+}
+
+document.addEventListener('ready', main)
+
+setupIonicReact()
+StatusBar.setStyle({ style: Style.Light })

package/examples/capacitor/package.json

@@ -6,9 +6,9 @@
     "android": "scripts/android.sh"
   },
   "dependencies": {
-    "@regulaforensics/document-reader": "8.2.186-beta",
-    "@regulaforensics/document-reader-core-fullauthrfid": "8.2.8-beta",
-    "@regulaforensics/document-reader-btdevice": "8.2.8-beta",
+    "@regulaforensics/document-reader": "8.3.242-beta",
+    "@regulaforensics/document-reader-core-fullauthrfid": "8.3.9-beta",
+    "@regulaforensics/document-reader-btdevice": "8.3.10-beta",
     "@awesome-cordova-plugins/file": "6.6.0",
     "@awesome-cordova-plugins/camera": "6.6.0",
     "@awesome-cordova-plugins/dialogs": "6.6.0",

package/examples/capacitor/scripts/setup.sh

@@ -4,3 +4,7 @@ set -e
 npm install
 cd ios/App
 pod install || pod update
+cd ../../
+
+cp public/assets/db.dat ios/App/App/
+cp public/assets/db.dat android/app/src/main/assets/Regula/

package/examples/capacitor/src/extra/bt_device.tsx

@@ -1,26 +1,27 @@
 import { DocumentReader, InitConfig } from "@regulaforensics/document-reader"
-import { handleException, setStatus } from "../main"
+import { handleException, init, setStatus } from "../main"
 
 export const useBtDevice = false
-const btDeviceName = "Regula 0000"
+export const btDeviceName = "Regula 0000"
 
 export function setupBTDevice() {
-  document.getElementById("bt-device").style.display = "flex"
-  document.getElementById("connect").onclick = () => connect()
+  var connectButton = document.getElementById("connect")
+  connectButton.style.display = "flex"
+  connectButton.onclick = () => connect()
   setStatus("Connect to a bluetooth device")
 }
 
 async function connect() {
   setStatus("Searching for devices...")
   if (await DocumentReader.instance.connectBluetoothDevice(btDeviceName)) {
-    await initializeBTDevice()
+    await init()
     DocumentReader.instance.functionality.useAuthenticator = true
     document.getElementById("bt-device").style.display = "none"
   } else
     setStatus("Failed to connect")
 }
 
-async function initializeBTDevice() {
+export async function initializeWithBTDevice() {
   setStatus("Initializing...")
 
   var initConfig = InitConfig.withBleDevice()

package/examples/capacitor/src/extra/custom_rfid.tsx

@@ -1,31 +1,13 @@
-import { DocReaderAction, DocumentReader, Results, RFIDConfig, RFIDDataFileType, RFIDErrorCodes, RFIDNotificationCodes } from "@regulaforensics/document-reader"
-import { displayResults, handleCompletion, setStatus } from "../main"
+import { DocReaderAction, DocumentReader, RFIDConfig, RFIDDataFileType, RFIDNotificationCodes } from "@regulaforensics/document-reader"
+import { displayResults, setStatus } from "../main"
 
-export enum RfidOption {
-    Basic,
-    Advanced,
-    SelfHostedUI
-}
-
-export const rfidOption: RfidOption = RfidOption.Basic
-
-export function advancedRfid() {
-    var config = new RFIDConfig(handleCompletion)
-
-    config.onChipDetected = () => console.log("Chip detected, reading rfid.")
-    config.onRetryReadChip = async (error) => console.log(await RFIDErrorCodes.getTranslation(error.code) + ". Retrying...")
-
-    DocumentReader.instance.rfid(config)
-}
+export const useRfidSelfHostedUI = false
 
-export function selfHostedUIRfid() {
-    var config = RFIDConfig.withoutUI((action, results, error) => {
-        if (DocReaderAction.stopped(action)) finish(results)
-        if (error != null) {
-            setStatus("Try again")
-            setDescription("Error" + error.message)
-            console.log(error.code + ": " + error.message)
-        }
+export function rfidSelfHostedUI() {
+    var config = RFIDConfig.withoutUI((action, results, _) => {
+        if (DocReaderAction.stopped(action)) stop()
+        if (DocReaderAction.finished(action)) displayResults(results)
+        if (DocReaderAction.interrupted(action)) setStatus("Error reading RFID")
     })
 
     config.onProgress = async (notification) => {
@@ -40,35 +22,40 @@ export function selfHostedUIRfid() {
     DocumentReader.instance.rfid(config)
 }
 
-function finish(results: Results) {
-    DocumentReader.instance.stopRFIDReader()
-    setShowing(false)
-    displayResults(results)
-}
-
 function setup() {
-    document.getElementById("cancel-rfid").onclick = () => finish(null)
-
     setStatus("Reading RFID")
     setDescription("Place your phone on top of the NFC tag")
-    setProgress(0)
+    setProgress(-1)
+    currentProgress = -1
     setShowing(true)
+    document.getElementById("cancel-rfid").onclick = () => stop()
 }
 
-var setDescription = (data: string) => document.getElementById("rfid-description").innerHTML = data
-var setProgress = (next: number) => {
+function stop() {
+    DocumentReader.instance.stopRFIDReader()
+    displayResults(null)
+    setShowing(false)
+}
+
+function setDescription(data) {
+    document.getElementById("rfid-description").innerHTML = data
+}
+
+var currentProgress = -1
+function setProgress(next) {
     var progress = document.getElementById("progress")
-    var previous = parseInt(progress.style.width.substring(0, progress.style.width.length - 1))
     // make progress bar look better
-    if (next <= 0) return // ignore idle 0s, leave progress at 100 while its not moving
-    if (next < previous) next = 0 // move to 0 if progress finaly started moving
+    if (next == 0) return // ignore idle 0s, leave progress at 100 while its not moving
+    if (next < currentProgress) next = 0 // move to 0 if progress finaly started moving
     if (next >= 95) next = 100 // rfid never returns 100 and it looks ugly, fix it
-    if (next < previous) progress.style.transition = 'none' // instantly reset progress
+    if (next < currentProgress) progress.style.transition = 'none' // instantly reset progress
     else progress.style.transition = 'width 0.5s' // smoothly increase progress
 
     progress.style.width = next + "%"
+    currentProgress = next
 }
-var setShowing = (data: boolean) => {
+
+function setShowing(data) {
     document.getElementById("main").style.display = data ? "none" : "flex"
     document.getElementById("custom-rfid").style.display = data ? "flex" : "none"
 }

package/examples/capacitor/src/main.css

@@ -1,8 +1,10 @@
 html,
 body {
-    width: 99%;
+    margin: 0;
+    width: 100%;
     height: 99vh;
     display: flex;
+    overflow: hidden;
     flex-direction: column;
 }
 
@@ -59,6 +61,7 @@ body {
     color: white;
     border: none;
     padding: 10px 20px;
+    justify-content: center;
     font-size: 16px;
     border-radius: 100px;
     cursor: pointer;

package/examples/capacitor/src/main.html

@@ -14,10 +14,6 @@
                 <img id="document-image" src="images/document.png" height="160px" width="200px">
             </div>
         </div>
-        <div id="bt-device" class="row" style="display: none;">
-            <input type="text" placeholder="Regula 0000" />
-            <button id="connect" class="button">Connect</button>
-        </div>
         <div id="scenario-container" class="column no-scroll" style="margin-top: 15px; background-color: rgba(0, 0, 0, 0.03);">
             <div id="scenarios" class="scroll"></div>
         </div>
@@ -29,6 +25,7 @@
             <button id="scan" class="button">Scan document</button>
             <button id="recognize" class="button">Scan image</button>
         </div>
+        <button id="connect" class="button" style="width: 360px; display: none;">Connect</button>
         <div style="padding-top: 20px;"></div>
     </div>
     <div id="custom-rfid" class="column no-scroll" style="display: none;">

package/examples/capacitor/src/main.tsx

@@ -1,20 +1,15 @@
-import { setupIonicReact } from '@ionic/react'
-import '@ionic/react/css/core.css'
-import './main.css'
-import { File } from '@awesome-cordova-plugins/file'
-import { DocumentReader, DocReaderException, InitConfig, DocReaderAction, Results, FieldType, GraphicFieldType, ResultType, RFIDConfig, ScannerConfig, Scenario, DocReaderScenario, RecognizeConfig } from '@regulaforensics/document-reader'
-import { StatusBar, Style } from '@capacitor/status-bar'
-import { setupBTDevice, useBtDevice } from './extra/bt_device'
-import { advancedRfid, rfidOption, RfidOption, selfHostedUIRfid } from './extra/custom_rfid'
-import { Camera, DestinationType, MediaType, PictureSourceType } from '@awesome-cordova-plugins/camera'
-
-const documentReader = DocumentReader.instance
-var selectedScenario = Scenario.MRZ
+import { DocumentReader, DocReaderAction, FieldType, GraphicFieldType, InitConfig, RecognizeConfig, ResultType, RFIDConfig, ScannerConfig, Scenario } from '@regulaforensics/document-reader'
+import { loadAsset, pickImage } from '../index'
+import { initializeWithBTDevice, setupBTDevice, useBtDevice } from './extra/bt_device'
+import { useRfidSelfHostedUI, rfidSelfHostedUI } from './extra/custom_rfid'
+
+var documentReader = DocumentReader.instance
+var selectedScenario
 var doRfid = false
 var isReadingRfid = false
 
-async function init() {
-  if (!await initializeReader()) return
+export async function init() {
+  if (!await initialize()) return
   setScenarios(documentReader.availableScenarios)
   setCanRfid(await documentReader.isRFIDAvailableForUse())
   setStatus("Ready")
@@ -31,11 +26,9 @@ async function scan() {
 
 async function recognize() {
   if (!await documentReader.isReady()) return
-  var image = await Camera.getPicture({
-    destinationType: DestinationType.DATA_URL,
-    mediaType: MediaType.PICTURE,
-    sourceType: PictureSourceType.PHOTOLIBRARY
-  })
+  var image = await pickImage()
+  if (image == null) return
+
   clearResults()
   documentReader.recognize(
     RecognizeConfig.withScenario(selectedScenario, { image: image }),
@@ -43,7 +36,7 @@ async function recognize() {
   )
 }
 
-export function handleCompletion(action: DocReaderAction, results?: Results, error?: DocReaderException) {
+export function handleCompletion(action, results, error) {
   handleException(error)
   if (DocReaderAction.stopped(action) && !shouldRfid(results)) {
     displayResults(results)
@@ -53,7 +46,7 @@ export function handleCompletion(action: DocReaderAction, results?: Results, err
   }
 }
 
-export async function displayResults(results?: Results) {
+export async function displayResults(results) {
   isReadingRfid = false
   clearResults()
   if (results == null) return
@@ -68,11 +61,17 @@ export async function displayResults(results?: Results) {
   setDocImage(docImage)
 }
 
-var readRfid = () => documentReader.rfid(new RFIDConfig(handleCompletion))
+var readRfid = () => {
+  documentReader.rfid(new RFIDConfig(handleCompletion))
+}
 
-var shouldRfid = (results?: Results) => doRfid && !isReadingRfid && results != null && results.chipPage != 0
+function shouldRfid(results) {
+  return doRfid &&
+    !isReadingRfid &&
+    results != null && results.chipPage != 0
+}
 
-async function initializeReader() {
+var initialize = async () => {
   setStatus("Initializing...")
 
   var license = await loadAsset("regula.license")
@@ -83,7 +82,7 @@ async function initializeReader() {
   return success
 }
 
-export function handleException(error: DocReaderException) {
+export function handleException(error) {
   if (error != null) {
     setStatus(error.message)
     console.log(error.code + ": " + error.message)
@@ -92,84 +91,84 @@ export function handleException(error: DocReaderException) {
 
 // --------------------------------------------------------------------------------------------------------------------
 
-async function loadAsset(path: string): Promise<string> {
-  var dir = await File.resolveDirectoryUrl(File.applicationDirectory + "public/assets")
-  var fileEntry = await File.getFile(dir, path, {})
-  var result = await new Promise<string>((resolve, _) => {
-    fileEntry.file(file => {
-      var reader = new FileReader()
-      reader.onloadend = (_) => resolve(reader.result as string)
-      reader.readAsDataURL(file)
-    })
-  })
-  return result
-}
-
-var documentUIImage: HTMLImageElement
-var portraitUIImage: HTMLImageElement
-document.addEventListener('deviceready', () => {
-  documentUIImage = document.getElementById("document-image") as HTMLImageElement
-  portraitUIImage = document.getElementById("portrait-image") as HTMLImageElement
+var documentUIImage
+var portraitUIImage
+export function main() {
+  documentUIImage = document.getElementById("document-image")
+  portraitUIImage = document.getElementById("portrait-image")
   document.getElementById("scan").onclick = () => scan()
   document.getElementById("recognize").onclick = () => recognize()
 
-  // btDevice
+  // custom rfid
+  if (useRfidSelfHostedUI) readRfid = () => rfidSelfHostedUI()
+
+  // bt device
   if (!useBtDevice) init()
-  else setupBTDevice()
+  else {
+    setupBTDevice()
+    initialize = initializeWithBTDevice
+  }
+}
 
-  // rfid
-  if (rfidOption == RfidOption.Advanced) readRfid = () => advancedRfid()
-  if (rfidOption == RfidOption.SelfHostedUI) readRfid = () => selfHostedUIRfid()
-})
+export function setStatus(data) {
+  if (data != null)
+    document.getElementById("status").innerHTML = data
+}
 
-export var setStatus = (data: string) => { if (data != null) document.getElementById("status").innerHTML = data }
-var setPortrait = (data: string) => { if (data != null) portraitUIImage.src = "data:image/png;base64," + data }
-var setDocImage = (data: string) => { if (data != null) documentUIImage.src = "data:image/png;base64," + data }
-var clearResults = () => {
+function setPortrait(data) {
+  if (data != null)
+    portraitUIImage.src = "data:image/png;base64," + data
+}
+
+function setDocImage(data) {
+  if (data != null)
+    documentUIImage.src = "data:image/png;base64," + data
+}
+
+function clearResults() {
   setStatus("Ready")
   portraitUIImage.src = "images/portrait.png"
   documentUIImage.src = "images/document.png"
 }
-var setScenarios = (data: DocReaderScenario[]) => {
-  const scenariosContainer = document.getElementById("scenarios")
-  data.forEach(scenario => scenariosContainer.appendChild(createScenarioElement(scenario)))
-}
-var createScenarioElement = (scenario: DocReaderScenario) => {
-  const div = document.createElement('div')
-  div.className = 'row radio'
-
-  const input = document.createElement('input')
-  input.type = 'radio'
-  input.name = 'scenario'
-  input.value = scenario.name
-  input.checked = scenario.name === selectedScenario
-
-  const span = document.createElement('span')
-  span.style.width = '200px'
-  span.style.paddingLeft = '5px'
-  span.textContent = scenario.caption
 
-  input.onclick = () => selectedScenario = scenario.name as Scenario
-  span.onclick = () => input.click()
-
-  div.appendChild(input)
-  div.appendChild(span)
-
-  return div
-}
-var setCanRfid = (data: boolean) => {
-  var checkbox = document.getElementById('rfid-checkbox') as HTMLInputElement
+function setCanRfid(data) {
+  var checkbox // implicitly any, since cordova sample is pure js
+  checkbox = document.getElementById('rfid-checkbox')
   var checkboxDescription = document.getElementById("rfid-checkbox-description")
   if (data) {
     checkbox.disabled = false
-    checkbox.onclick = () => {
+    checkboxDescription.innerHTML = "Process rfid reading"
+    var onclick = () => {
       doRfid = !doRfid
       checkbox.checked = doRfid
     }
-    checkboxDescription.innerHTML = "Process rfid reading"
-    checkboxDescription.onclick = () => checkbox.click()
+    checkbox.onclick = onclick
+    checkboxDescription.onclick = onclick
   }
 }
 
-setupIonicReact()
-StatusBar.setStyle({ style: Style.Light })
+function setScenarios(data) {
+  selectedScenario = Scenario.MRZ
+  var scenariosContainer = document.getElementById("scenarios")
+
+  data.forEach(scenario => {
+    var checked = selectedScenario == scenario.name ? "checked" : ""
+    var scenarioElement = `<div class="row radio">
+      <input type="radio" name="scenario" id="${scenario.name}" value="${scenario.name}" ${checked}>
+      <span id="${scenario.name}-caption" style="width: 200px; padding-left: 5px;">${scenario.caption}</span>
+    </div>`
+    scenariosContainer.insertAdjacentHTML("beforeend", scenarioElement)
+  })
+
+  data.forEach(scenario => {
+    var element
+    element = document.getElementById(scenario.name)
+    var elementCaption = document.getElementById(scenario.name + "-caption")
+    var onclick = () => {
+      selectedScenario = scenario.name
+      element.checked = true
+    }
+    element.onclick = onclick
+    elementCaption.onclick = onclick
+  })
+}

package/examples/cordova/README.md

@@ -10,3 +10,13 @@
   * Android: `npm run android`.
 
 **Note**: this 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.
+
+## Additional examples
+
+### Bluetooth device
+
+In order to connect to an external scanning device, change the `useBtDevice` constant to true in `src/extra/bt_device`, and set `btDeviceName` to the name of you device. After running the app, click `Connect`.
+
+### RFID self hosted UI
+
+This app also demonstraits how you can implement you own UI for the RFID reading process. To enable it, change the `useRfidSelfHostedUI` constant to true in `src/extra/custom_rfid`. Run the app and initiate RFID reading.

package/examples/cordova/config.xml

@@ -1,19 +1,23 @@
 <widget android-packageName="com.regula.dr.fullauthrfid" ios-CFBundleIdentifier="regula.DocumentReader" version="1.0.0"
     xmlns:android="http://schemas.android.com/apk/res/android">
     <name>DocumentReader</name>
+    <hook type="before_prepare" src="scripts/bundle.sh" />
     <platform name="android">
+        <resource-file src="www/db.dat" target="app/src/main/assets/Regula/db.dat" />
         <preference name="orientation" value="portrait" />
-        <preference name="GradlePluginKotlinEnabled" value="true" />
         <preference name="android-minSdkVersion" value="24" />
         <preference name="android-targetSdkVersion" value="35" />
+        <preference name="GradlePluginKotlinEnabled" value="true" />
         <config-file parent="/*" target="AndroidManifest.xml">
-            <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
+            <uses-permission android:name="android.permission.NFC" />
+            <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
         </config-file>
         <edit-config file="app/src/main/AndroidManifest.xml" mode="merge" target="/manifest/application">
             <application android:usesCleartextTraffic="true" />
         </edit-config>
     </platform>
     <platform name="ios">
+        <resource-file src="www/db.dat" />
         <preference name="orientation" value="portrait" />
         <preference name="DisallowOverscroll" value="true" />
         <config-file target="*-Info.plist" parent="NSCameraUsageDescription">