capacitor-microblink 0.2.0 → 0.3.1

package/Package.swift

@@ -11,7 +11,8 @@ let package = Package(
     ],
     dependencies: [
         .package(url: "https://github.com/ionic-team/capacitor-swift-pm.git", from: "8.0.1"),
-        .package(url: "https://github.com/MicroblinkPlatform/microblink-platform-ios.git", from: "1.7.0")
+        .package(url: "https://github.com/BlinkCard/blinkcard-ios.git", .upToNextMajor(from: "3000.0.0"))
+      
     ],
     targets: [
         .target(
@@ -19,8 +20,7 @@ let package = Package(
             dependencies: [
                 .product(name: "Capacitor", package: "capacitor-swift-pm"),
                 .product(name: "Cordova", package: "capacitor-swift-pm"),
-                .product(name: "BlinkCard", package: "microblink-platform-ios"),
-                .product(name: "MicroblinkPlatform", package: "microblink-platform-ios")
+                .product(name: "BlinkCardUX", package: "blinkcard-ios")
             ],
             path: "ios/Sources/MicroblinkPlugin"),
         .testTarget(

package/README.md

@@ -9,37 +9,45 @@ npm install capacitor-microblink
 npx cap sync
 ```
 
+### Android Auto Init (on app startup)
+
+If you want `initializeBlinkCard` to run automatically during Android plugin load (`onCreate` phase), set plugin config values:
+
+```ts
+// capacitor.config.ts
+plugins: {
+  Microblink: {
+    licenseKey: 'YOUR_BLINKCARD_LICENSE_KEY',
+    licensee: 'OPTIONAL_LICENSEE',
+  },
+}
+```
+
+### iOS Camera Permission
+
+BlinkCard scanning requires camera access on iOS.
+
+Add this key to your app `Info.plist`:
+
+```xml
+<key>NSCameraUsageDescription</key>
+<string>We need camera access to scan your card.</string>
+```
+
 ## API
 
 <docgen-index>
 
-* [`startVerification(...)`](#startverification)
 * [`scanCard(...)`](#scancard)
+* [`initializeBlinkCard(...)`](#initializeblinkcard)
+* [`terminateBlinkCard()`](#terminateblinkcard)
 * [Interfaces](#interfaces)
-* [Type Aliases](#type-aliases)
 
 </docgen-index>
 
 <docgen-api>
 <!--Update the source file JSDoc comments and rerun docgen to update the docs below-->
 
-### startVerification(...)
-
-```typescript
-startVerification(options: StartVerificationOptions) => Promise<StartVerificationResult>
-```
-
-Starts Microblink identity verification flow.
-
-| Param         | Type                                                                          |
-| ------------- | ----------------------------------------------------------------------------- |
-| **`options`** | <code><a href="#startverificationoptions">StartVerificationOptions</a></code> |
-
-**Returns:** <code>Promise&lt;<a href="#startverificationresult">StartVerificationResult</a>&gt;</code>
-
---------------------
-
-
 ### scanCard(...)
 
 ```typescript
@@ -57,45 +65,37 @@ Starts BlinkCard card scanning flow.
 --------------------
 
 
-### Interfaces
+### initializeBlinkCard(...)
 
+```typescript
+initializeBlinkCard(options: InitializeBlinkCardOptions) => Promise<InitializeBlinkCardResult>
+```
 
-#### StartVerificationResult
+Initializes BlinkCard SDK/license before scanning.
 
-| Prop                 | Type                                                      |
-| -------------------- | --------------------------------------------------------- |
-| **`canceled`**       | <code>boolean</code>                                      |
-| **`transactionId`**  | <code>string \| null</code>                               |
-| **`status`**         | <code>'accept' \| 'review' \| 'reject'</code>             |
-| **`cancelReason`**   | <code>'userCanceled' \| 'consentDenied'</code>            |
-| **`cardScanResult`** | <code><a href="#cardscanresult">CardScanResult</a></code> |
+| Param         | Type                                                                              |
+| ------------- | --------------------------------------------------------------------------------- |
+| **`options`** | <code><a href="#initializeblinkcardoptions">InitializeBlinkCardOptions</a></code> |
 
+**Returns:** <code>Promise&lt;<a href="#initializeblinkcardresult">InitializeBlinkCardResult</a>&gt;</code>
 
-#### CardScanResult
+--------------------
 
-| Prop             | Type                |
-| ---------------- | ------------------- |
-| **`cardNumber`** | <code>string</code> |
-| **`expiryDate`** | <code>string</code> |
-| **`owner`**      | <code>string</code> |
-| **`cvv`**        | <code>string</code> |
 
+### terminateBlinkCard()
+
+```typescript
+terminateBlinkCard() => Promise<TerminateBlinkCardResult>
+```
+
+Terminates BlinkCard SDK and clears cached plugin initialization state.
 
-#### StartVerificationOptions
+**Returns:** <code>Promise&lt;<a href="#terminateblinkcardresult">TerminateBlinkCardResult</a>&gt;</code>
+
+--------------------
 
-| Prop                             | Type                                                            |
-| -------------------------------- | --------------------------------------------------------------- |
-| **`workflowId`**                 | <code>string</code>                                             |
-| **`url`**                        | <code>string</code>                                             |
-| **`userId`**                     | <code>string</code>                                             |
-| **`isProcessingStoringAllowed`** | <code>boolean</code>                                            |
-| **`isTrainingAllowed`**          | <code>boolean</code>                                            |
-| **`note`**                       | <code>string</code>                                             |
-| **`givenOn`**                    | <code>number</code>                                             |
-| **`additionalRequestHeaders`**   | <code><a href="#record">Record</a>&lt;string, string&gt;</code> |
-| **`startTransactionPath`**       | <code>string</code>                                             |
-| **`cancelWorkflowPath`**         | <code>string</code>                                             |
-| **`workflowInfoPath`**           | <code>string</code>                                             |
+
+### Interfaces
 
 
 #### ScanCardResult
@@ -137,13 +137,25 @@ Starts BlinkCard card scanning flow.
 | **`enableEditScreen`**       | <code>boolean</code> |
 
 
-### Type Aliases
+#### InitializeBlinkCardResult
+
+| Prop              | Type                 |
+| ----------------- | -------------------- |
+| **`initialized`** | <code>boolean</code> |
 
 
-#### Record
+#### InitializeBlinkCardOptions
+
+| Prop             | Type                |
+| ---------------- | ------------------- |
+| **`licenseKey`** | <code>string</code> |
+| **`licensee`**   | <code>string</code> |
+
 
-Construct a type with a set of properties K of type T
+#### TerminateBlinkCardResult
 
-<code>{
 [P in K]: T;
 }</code>
+| Prop             | Type                 |
+| ---------------- | -------------------- |
+| **`terminated`** | <code>boolean</code> |
 
 </docgen-api>

package/android/build.gradle

@@ -6,6 +6,9 @@ ext {
 }
 
 buildscript {
+    ext {
+        kotlin_version = '2.2.0'
+    }
     repositories {
         google()
         mavenCentral()
@@ -13,10 +16,14 @@ buildscript {
     }
     dependencies {
         classpath 'com.android.tools.build:gradle:8.13.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
 
 apply plugin: 'com.android.library'
+apply plugin: 'org.jetbrains.kotlin.android'
+
+def jvmTargetVersion = project.hasProperty('jvmTargetVersion') ? project.property('jvmTargetVersion') : '17'
 
 android {
     namespace = "com.otto.microblink"
@@ -40,8 +47,11 @@ android {
         disable += ["Aligned16KB"]
     }
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_21
-        targetCompatibility JavaVersion.VERSION_21
+        sourceCompatibility JavaVersion.toVersion(jvmTargetVersion)
+        targetCompatibility JavaVersion.toVersion(jvmTargetVersion)
+    }
+    kotlinOptions {
+        jvmTarget = jvmTargetVersion
     }
 }
 
@@ -56,8 +66,8 @@ dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     implementation project(':capacitor-android')
     implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
-    implementation "com.microblink:blinkcard:2.12.0"
-    implementation "com.microblink:microblink-platform:1.7.0"
+    implementation("com.microblink:blinkcard-ux:3000.0.0")
+    implementation 'androidx.core:core-ktx:1.17.0'
     testImplementation "junit:junit:$junitVersion"
     androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
     androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"

package/android/src/main/java/com/otto/microblink/BlinkCardInitBridge.kt

@@ -0,0 +1,63 @@
+package com.otto.microblink
+
+import android.content.Context
+import com.microblink.blinkcard.core.BlinkCardSdk
+import com.microblink.blinkcard.core.BlinkCardSdkSettings
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.launch
+
+object BlinkCardInitBridge {
+    private fun resetSdkInstance() {
+        try {
+            val sdkField = BlinkCardSdk::class.java.getDeclaredField("sdkInstance")
+            sdkField.isAccessible = true
+            val existingSdk = sdkField.get(null) as? BlinkCardSdk
+            existingSdk?.close()
+            sdkField.set(null, null)
+        } catch (_: Throwable) {
+            // Best-effort reset. If reflection fails, initialization may still succeed.
+        }
+    }
+
+    @JvmStatic
+    fun initialize(
+        context: Context,
+        licenseKey: String,
+        licensee: String?,
+        callback: (Throwable?) -> Unit
+    ) {
+        CoroutineScope(Dispatchers.Main).launch {
+            resetSdkInstance()
+            val normalizedLicenseKey = licenseKey.trim()
+            val normalizedLicensee = licensee?.trim()?.takeIf { it.isNotEmpty() }
+            val settings = if (normalizedLicensee != null) {
+                BlinkCardSdkSettings(
+                    licenseKey = normalizedLicenseKey,
+                    licensee = normalizedLicensee
+                )
+            } else {
+                BlinkCardSdkSettings(
+                    licenseKey = normalizedLicenseKey
+                )
+            }
+            val result = BlinkCardSdk.initializeSdk(
+                context.applicationContext,
+                settings
+            )
+            callback(result.exceptionOrNull())
+        }
+    }
+
+    @JvmStatic
+    fun terminate(callback: (Throwable?) -> Unit) {
+        CoroutineScope(Dispatchers.Main).launch {
+            try {
+                resetSdkInstance()
+                callback(null)
+            } catch (error: Throwable) {
+                callback(error)
+            }
+        }
+    }
+}