@regulaforensics/document-reader 7.1.301-rc

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

@@ -0,0 +1,181 @@
+@file:SuppressLint("UseKtx")
+
+package com.regula.plugin.documentreader
+
+import android.annotation.SuppressLint
+import android.graphics.Bitmap
+import android.graphics.BitmapFactory
+import android.graphics.Canvas
+import android.graphics.drawable.BitmapDrawable
+import android.graphics.drawable.Drawable
+import android.util.Base64
+import org.json.JSONArray
+import org.json.JSONObject
+import java.io.ByteArrayOutputStream
+import kotlin.math.sqrt
+
+fun List<*>.toJson(): JSONArray {
+    val result = JSONArray()
+    for (i in indices)
+        when (val v = this[i]) {
+            null -> result.put(null)
+            is Map<*, *> -> result.put(v.toJson())
+            is List<*> -> result.put(v.toJson())
+            else -> result.put(v)
+        }
+    return result
+}
+
+fun Map<*, *>.toJson(): JSONObject {
+    val result = JSONObject()
+    for ((k, v) in this) {
+        when (v) {
+            null -> result.put(k as String, null)
+            is Map<*, *> -> result.put(k as String, v.toJson())
+            is List<*> -> result.put(k as String, v.toJson())
+            else -> result.put(k as String, v)
+        }
+    }
+    return result
+}
+
+fun Any?.toSendable(): Any? = this?.let {
+    if (it is JSONObject || it is JSONArray) it.toString()
+    else it
+}
+
+fun <T> List<T>?.toJson(toJson: (T?) -> Any?) = this?.let {
+    val result = JSONArray()
+    for (item in it) result.put(toJson(item))
+    result
+}
+
+fun <T> List<T>?.toJsonNullable(toJson: (T?) -> Any?) = this?.let {
+    val result = JSONArray()
+    for (item in it) result.put(toJson(item))
+    result
+}
+
+fun <T> JSONArray?.toList(fromJson: (JSONObject) -> T) = this?.let {
+    val result: MutableList<T> = ArrayList()
+    for (i in 0 until it.length()) result.add(fromJson(it.getJSONObject(i)))
+    result
+}
+
+fun <T> JSONArray.toList() = this.let {
+    val result = mutableListOf<T>()
+    @Suppress("UNCHECKED_CAST")
+    for (i in 0 until length()) result.add(get(i) as T)
+    result
+}
+
+inline fun <reified T> JSONArray?.toArray() = this?.let {
+    val result = arrayOfNulls<T>(length())
+    for (i in 0 until length()) result[i] = get(i) as T
+    result
+}
+
+inline fun <reified T> JSONArray?.toArray(fromJson: (JSONObject?) -> T) = this?.let {
+    val result = arrayOfNulls<T>(length())
+    for (i in 0 until length()) result[i] = fromJson(getJSONObject(i))
+    result
+}
+
+fun <T> Array<T>?.toJson() = this?.let {
+    val result = JSONArray()
+    for (i in it.indices) result.put(i, it[i])
+    result
+}
+
+fun <T> Array<T>?.toJson(toJson: (T?) -> JSONObject?) = this?.let {
+    val result = JSONArray()
+    for (i in indices) result.put(i, toJson(this[i]))
+    result
+}
+
+fun Any?.toIntArray() = (this as JSONArray?)?.let {
+    val result = IntArray(it.length())
+    for (i in 0 until it.length()) result[i] = it.getInt(i)
+    result
+}
+
+fun IntArray?.toJson() = this?.let {
+    val result = JSONArray()
+    for (i in it.indices) result.put(i, it[i])
+    result
+}
+
+fun JSONObject.forEach(action: (String, Any) -> Unit) {
+    val keys: Iterator<String> = keys()
+    while (keys.hasNext()) {
+        val key = keys.next()
+        action(key, get(key))
+    }
+}
+
+fun JSONObject.getJSONObjectOrNull(name: String): JSONObject? {
+    if (has(name) && get(name).toString() != "null") return getJSONObject(name)
+    return null
+}
+
+fun JSONObject.getIntOrNull(name: String): Int? {
+    if (has(name) && get(name).toString() != "null") return getInt(name)
+    return null
+}
+
+fun JSONObject.getDoubleOrNull(name: String): Double? {
+    if (has(name) && get(name).toString() != "null") return getDouble(name)
+    return null
+}
+
+fun JSONObject.getBooleanOrNull(name: String): Boolean? {
+    if (has(name) && get(name).toString() != "null") return getBoolean(name)
+    return null
+}
+
+fun JSONObject.getStringOrNull(name: String): String? {
+    if (has(name) && get(name).toString() != "null") return getString(name)
+    return null
+}
+
+internal object Convert {
+    fun String?.toByteArray(): ByteArray? {
+        var str = this ?: return null
+        if (str.startsWith("data")) str = str.substring(str.indexOf(",") + 1)
+        return Base64.decode(str, Base64.NO_WRAP)
+    }
+
+    fun ByteArray?.toBase64() = this?.let { Base64.encodeToString(it, Base64.NO_WRAP) }
+
+    fun Bitmap?.toBase64() = this?.let {
+        val byteArrayOutputStream = ByteArrayOutputStream()
+        it.compress(Bitmap.CompressFormat.JPEG, 100, byteArrayOutputStream)
+        byteArrayOutputStream.toByteArray().toBase64()
+    }
+
+    fun String?.toBitmap() = this?.let {
+        val decodedString = toByteArray()!!
+        var result = BitmapFactory.decodeByteArray(decodedString, 0, decodedString.size)
+        val sizeMultiplier = result.byteCount / 5000000
+        if (result.byteCount > 5000000) result = Bitmap.createScaledBitmap(result, result.width / sqrt(sizeMultiplier.toDouble()).toInt(), result.height / sqrt(sizeMultiplier.toDouble()).toInt(), false)
+        result
+    }
+
+    fun Any?.toDrawable() = (this as String?)?.let {
+        val decodedByte = it.toByteArray()!!
+        val bitmap = BitmapFactory.decodeByteArray(decodedByte, 0, decodedByte.size)
+        val density = context.resources.displayMetrics.density
+        val width = (bitmap.width * density).toInt()
+        val height = (bitmap.height * density).toInt()
+        BitmapDrawable(context.resources, Bitmap.createScaledBitmap(bitmap, width, height, false))
+    }
+
+    fun Drawable?.toBase64() = this?.let {
+        if (this is BitmapDrawable) if (bitmap != null) return bitmap.toBase64()
+        val bitmap: Bitmap = if (intrinsicWidth <= 0 || intrinsicHeight <= 0) Bitmap.createBitmap(1, 1, Bitmap.Config.ARGB_8888) else Bitmap.createBitmap(intrinsicWidth, intrinsicHeight, Bitmap.Config.ARGB_8888)
+        val canvas = Canvas(bitmap)
+        setBounds(0, 0, canvas.width, canvas.height)
+        draw(canvas)
+        bitmap.toBase64()
+    }
+}

package/examples/capacitor/README.md

@@ -0,0 +1,22 @@
+# Regula Document Reader Capacitor demo application
+
+## How to build demo application
+1. Download or the clone current repository using the command `git clone https://github.com/regulaforensics/npm-document-reader.git`.
+2. Put `regula.license` file at `public/assets/` (you can get a trial license [here](https://client.regulaforensics.com)).
+3. Put `db.dat` file at `public/assets/` (you can get a trial database [here](https://client.regulaforensics.com/customer/databases))
+4. Execute `npm run setup` within this directory.
+5. Run the app: 
+  * IOS: `npm run ios`.
+  * 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 your 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/android/app/build.gradle

@@ -0,0 +1,50 @@
+apply plugin: 'com.android.application'
+
+android {
+    namespace "com.regula.example.dr.capacitor"
+    compileSdkVersion rootProject.ext.compileSdkVersion
+    defaultConfig {
+        applicationId "com.regula.example.dr.capacitor"
+        minSdkVersion rootProject.ext.minSdkVersion
+        targetSdkVersion rootProject.ext.targetSdkVersion
+        versionCode 1
+        versionName "1.0"
+        aaptOptions {
+             // Files and dirs to omit from the packaged assets dir, modified to accommodate modern web apps.
+             // Default: https://android.googlesource.com/platform/frameworks/base/+/282e181b58cf72b6ca770dc7ca5f91f135444502/tools/aapt/AaptAssets.cpp#61
+            ignoreAssetsPattern '!.svn:!.git:!.ds_store:!*.scc:.*:!CVS:!thumbs.db:!picasa.ini:!*~'
+        }
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+repositories {
+    flatDir{
+        dirs '../capacitor-cordova-android-plugins/src/main/libs', 'libs'
+    }
+}
+
+dependencies {
+    implementation fileTree(include: ['*.jar'], dir: 'libs')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "androidx.coordinatorlayout:coordinatorlayout:$androidxCoordinatorLayoutVersion"
+    implementation "androidx.core:core-splashscreen:$coreSplashScreenVersion"
+    implementation project(':capacitor-android')
+    implementation project(':capacitor-cordova-android-plugins')
+}
+
+apply from: 'capacitor.build.gradle'
+
+try {
+    def servicesJSON = file('google-services.json')
+    if (servicesJSON.text) {
+        apply plugin: 'com.google.gms.google-services'
+    }
+} catch(Exception e) {
+    logger.info("google-services.json not found, google-services plugin not applied. Push Notifications won't work")
+}

package/examples/capacitor/android/app/capacitor.build.gradle

@@ -0,0 +1,22 @@
+// DO NOT EDIT THIS FILE! IT IS GENERATED EACH TIME "capacitor update" IS RUN
+
+android {
+  compileOptions {
+      sourceCompatibility JavaVersion.VERSION_21
+      targetCompatibility JavaVersion.VERSION_21
+  }
+}
+
+apply from: "../capacitor-cordova-android-plugins/cordova.variables.gradle"
+dependencies {
+    implementation project(':capacitor-app')
+    implementation project(':capacitor-haptics')
+    implementation project(':capacitor-keyboard')
+    implementation project(':capacitor-status-bar')
+    implementation "androidx.core:core:1.6.+"
+    implementation "androidx.webkit:webkit:1.4.0"
+}
+
+if (hasProperty('postBuildExtras')) {
+  postBuildExtras()
+}

package/examples/capacitor/android/app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

package/examples/capacitor/android/app/src/main/AndroidManifest.xml

@@ -0,0 +1,27 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@drawable/launcher"
+        android:label="Document"
+        android:supportsRtl="true"
+        android:theme="@style/AppTheme"
+        android:usesCleartextTraffic="true">
+        <activity
+            android:name=".MainActivity"
+            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|smallestScreenSize|screenLayout|uiMode|navigation"
+            android:exported="true"
+            android:launchMode="singleTask"
+            android:screenOrientation="portrait"
+            android:theme="@style/AppTheme.NoActionBarLaunch">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+    </application>
+
+    <uses-permission android:name="android.permission.NFC" />
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+</manifest>

package/examples/capacitor/android/app/src/main/java/com/regula/example/dr/capacitor/MainActivity.java

@@ -0,0 +1,5 @@
+package com.regula.example.dr.capacitor;
+
+import com.getcapacitor.BridgeActivity;
+
+public class MainActivity extends BridgeActivity {}

package/examples/capacitor/android/app/src/main/res/drawable/launcher.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+</adaptive-icon>

package/examples/capacitor/android/app/src/main/res/drawable/launcher_round.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+</adaptive-icon>

package/examples/capacitor/android/app/src/main/res/layout/activity_main.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    tools:context=".MainActivity">
+
+    <WebView
+        android:layout_width="match_parent"
+        android:layout_height="match_parent" />
+</androidx.coordinatorlayout.widget.CoordinatorLayout>

package/examples/capacitor/android/app/src/main/res/values/styles.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <!-- Base application theme. -->
+    <style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
+        <!-- Customize your theme here. -->
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+    </style>
+
+    <style name="AppTheme.NoActionBar" parent="Theme.AppCompat.DayNight.NoActionBar">
+        <item name="windowActionBar">false</item>
+        <item name="windowNoTitle">true</item>
+        <item name="android:background">@null</item>
+    </style>
+
+
+    <style name="AppTheme.NoActionBarLaunch" parent="Theme.SplashScreen">
+        <item name="android:background">@drawable/splash</item>
+    </style>
+</resources>

package/examples/capacitor/android/build.gradle

@@ -0,0 +1,30 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+
+buildscript {
+    
+    repositories {
+        google()
+        mavenCentral()
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.8.0'
+        classpath 'com.google.gms:google-services:4.4.2'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.25"
+
+        // NOTE: Do not place your application dependencies here; they belong
+        // in the individual module build.gradle files
+    }
+}
+
+apply from: "variables.gradle"
+
+allprojects {
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+task clean(type: Delete) {
+    delete rootProject.buildDir
+}

package/examples/capacitor/android/capacitor.settings.gradle

@@ -0,0 +1,15 @@
+// DO NOT EDIT THIS FILE! IT IS GENERATED EACH TIME "capacitor update" IS RUN
+include ':capacitor-android'
+project(':capacitor-android').projectDir = new File('../node_modules/@capacitor/android/capacitor')
+
+include ':capacitor-app'
+project(':capacitor-app').projectDir = new File('../node_modules/@capacitor/app/android')
+
+include ':capacitor-haptics'
+project(':capacitor-haptics').projectDir = new File('../node_modules/@capacitor/haptics/android')
+
+include ':capacitor-keyboard'
+project(':capacitor-keyboard').projectDir = new File('../node_modules/@capacitor/keyboard/android')
+
+include ':capacitor-status-bar'
+project(':capacitor-status-bar').projectDir = new File('../node_modules/@capacitor/status-bar/android')

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

@@ -0,0 +1,7 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-all.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/examples/capacitor/android/gradle.properties

@@ -0,0 +1,22 @@
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx1536m
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true
+
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app's APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=true