capacitor-microblink 0.3.0 → 0.4.0

package/README.md

@@ -9,12 +9,38 @@ 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>
 
 * [`scanCard(...)`](#scancard)
 * [`initializeBlinkCard(...)`](#initializeblinkcard)
+* [`terminateBlinkCard()`](#terminateblinkcard)
 * [Interfaces](#interfaces)
 
 </docgen-index>
@@ -56,6 +82,19 @@ Initializes BlinkCard SDK/license before scanning.
 --------------------
 
 
+### terminateBlinkCard()
+
+```typescript
+terminateBlinkCard() => Promise<TerminateBlinkCardResult>
+```
+
+Terminates BlinkCard SDK and clears cached plugin initialization state.
+
+**Returns:** <code>Promise&lt;<a href="#terminateblinkcardresult">TerminateBlinkCardResult</a>&gt;</code>
+
+--------------------
+
+
 ### Interfaces
 
 
@@ -112,4 +151,11 @@ Initializes BlinkCard SDK/license before scanning.
 | **`licenseKey`** | <code>string</code> |
 | **`licensee`**   | <code>string</code> |
 
+
+#### TerminateBlinkCardResult
+
+| Prop             | Type                 |
+| ---------------- | -------------------- |
+| **`terminated`** | <code>boolean</code> |
+
 </docgen-api>

package/android/build.gradle

@@ -23,6 +23,8 @@ buildscript {
 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"
     compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
@@ -45,11 +47,11 @@ android {
         disable += ["Aligned16KB"]
     }
     compileOptions {
-        sourceCompatibility JavaVersion.VERSION_21
-        targetCompatibility JavaVersion.VERSION_21
+        sourceCompatibility JavaVersion.toVersion(jvmTargetVersion)
+        targetCompatibility JavaVersion.toVersion(jvmTargetVersion)
     }
     kotlinOptions {
-        jvmTarget = '21'
+        jvmTarget = jvmTargetVersion
     }
 }
 

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

@@ -8,6 +8,18 @@ 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,
@@ -16,14 +28,36 @@ object BlinkCardInitBridge {
         callback: (Throwable?) -> Unit
     ) {
         CoroutineScope(Dispatchers.Main).launch {
-            val result = BlinkCardSdk.initializeSdk(
-                context,
+            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 = licenseKey,
-                    licensee = licensee ?: ""
+                    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)
+            }
+        }
+    }
 }

package/android/src/main/java/com/otto/microblink/MicroblinkPlugin.java

@@ -1,16 +1,18 @@
 package com.otto.microblink;
 
+import android.Manifest;
 import android.content.Intent;
-import android.os.Build;
-
+import android.util.Log;
 import androidx.activity.result.ActivityResult;
 
 import com.getcapacitor.JSObject;
+import com.getcapacitor.PermissionState;
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.ActivityCallback;
 import com.getcapacitor.annotation.CapacitorPlugin;
+import com.getcapacitor.annotation.Permission;
 import com.microblink.blinkcard.core.BlinkCardSdkSettings;
 import com.microblink.blinkcard.core.result.CardAccountResult;
 import com.microblink.blinkcard.core.result.DateResult;
@@ -26,15 +28,63 @@ import com.microblink.blinkcard.ux.contract.ScanActivityResultStatus;
 import java.util.List;
 import java.util.function.Consumer;
 
-@CapacitorPlugin(name = "Microblink")
+@CapacitorPlugin(
+    name = "Microblink",
+    permissions = {
+        @Permission(alias = "camera", strings = { Manifest.permission.CAMERA })
+    }
+)
 public class MicroblinkPlugin extends Plugin {
+    private static final String TAG = "MicroblinkPlugin";
 
     private boolean isBlinkCardInitialized;
     private String blinkCardLicenseKey;
     private String blinkCardLicensee;
 
+    @Override
+    public void load() {
+        super.load();
+
+        String configuredLicenseKey = normalized(getConfig().getString("licenseKey"));
+        if (configuredLicenseKey == null) {
+            return;
+        }
+
+        String configuredLicensee = normalized(getConfig().getString("licensee"));
+        initializeBlinkCardLicense(configuredLicenseKey, configuredLicensee, errorMessage -> {
+            if (errorMessage != null) {
+                Log.w(TAG, "Auto initializeBlinkCard on load failed: " + errorMessage);
+            } else {
+                Log.i(TAG, "BlinkCard auto-initialized from plugin config.");
+            }
+        });
+    }
+
     @PluginMethod
     public void scanCard(PluginCall call) {
+        if (getPermissionState("camera") != PermissionState.GRANTED) {
+            requestPermissionForAlias("camera", call, "cameraPermissionCallback");
+            return;
+        }
+
+        performScanCard(call);
+    }
+
+    @com.getcapacitor.annotation.PermissionCallback
+    private void cameraPermissionCallback(PluginCall call) {
+        if (call == null) {
+            return;
+        }
+
+        if (getPermissionState("camera") != PermissionState.GRANTED) {
+            call.reject("Camera permission is required to scan cards.");
+            return;
+        }
+
+        performScanCard(call);
+    }
+
+    private void performScanCard(PluginCall call) {
         String providedLicenseKey = normalized(call.getString("licenseKey"));
         String providedLicensee = normalized(call.getString("licensee"));
 
@@ -54,7 +104,13 @@ public class MicroblinkPlugin extends Plugin {
             return;
         }
 
-        startBlinkCardScan(call, blinkCardLicenseKey, blinkCardLicensee);
+        initializeBlinkCardLicense(blinkCardLicenseKey, blinkCardLicensee, errorMessage -> {
+            if (errorMessage != null) {
+                call.reject(errorMessage);
+                return;
+            }
+            startBlinkCardScan(call, blinkCardLicenseKey, blinkCardLicensee);
+        });
     }
 
     @PluginMethod
@@ -78,6 +134,25 @@ public class MicroblinkPlugin extends Plugin {
         });
     }
 
+    @PluginMethod
+    public void terminateBlinkCard(PluginCall call) {
+        BlinkCardInitBridge.terminate(error -> {
+            if (error != null) {
+                call.reject("Failed to terminate BlinkCard SDK: " + error.getMessage());
+                return null;
+            }
+
+            isBlinkCardInitialized = false;
+            blinkCardLicenseKey = null;
+            blinkCardLicensee = null;
+
+            JSObject payload = new JSObject();
+            payload.put("terminated", true);
+            call.resolve(payload);
+            return null;
+        });
+    }
+
     private void startBlinkCardScan(PluginCall call, String licenseKey, String licensee) {
         if (getContext() == null) {
             call.reject("Unable to start BlinkCard scan: Context is unavailable.");
@@ -141,6 +216,7 @@ public class MicroblinkPlugin extends Plugin {
         }
 
         if (status == ScanActivityResultStatus.ErrorSdkInit) {
+            isBlinkCardInitialized = false;
             call.reject("BlinkCard scan failed because SDK initialization in scan activity failed.");
             return;
         }
@@ -160,37 +236,30 @@ public class MicroblinkPlugin extends Plugin {
 
         List<CardAccountResult> cardAccounts = result.getCardAccounts();
         if (cardAccounts != null && !cardAccounts.isEmpty()) {
-            CardAccountResult primaryAccount = null;
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
-                primaryAccount = cardAccounts.getFirst();
-                payload.put("cardNumber", primaryAccount.getCardNumber());
-                payload.put("cardNumberValid", primaryAccount.getCardNumberValid());
-                payload.put("cardNumberPrefix", primaryAccount.getCardNumberPrefix());
-                payload.put("cvv", primaryAccount.getCvv());
-                payload.put("expiryDate", toBlinkCardDate(primaryAccount.getExpiryDate()));
-            } else {
-                primaryAccount = cardAccounts.get(0);
-                payload.put("cardNumber", primaryAccount.getCardNumber());
-                payload.put("cardNumberValid", primaryAccount.getCardNumberValid());
-                payload.put("cardNumberPrefix", primaryAccount.getCardNumberPrefix());
-                payload.put("cvv", primaryAccount.getCvv());
-                payload.put("expiryDate", toBlinkCardDate(primaryAccount.getExpiryDate()));
-            }
-
+            CardAccountResult primaryAccount = cardAccounts.get(0);
+            payload.put("cardNumber", primaryAccount.getCardNumber());
+            payload.put("cardNumberValid", primaryAccount.getCardNumberValid());
+            payload.put("cardNumberPrefix", primaryAccount.getCardNumberPrefix());
+            payload.put("cvv", primaryAccount.getCvv());
+            payload.put("expiryDate", toBlinkCardDate(primaryAccount.getExpiryDate()));
         }
 
         call.resolve(payload);
     }
 
     private JSObject toBlinkCardDate(DateResult<String> dateResult) {
-        if (dateResult == null || dateResult.getDay() == null || dateResult.getMonth() == null || dateResult.getYear() == null) {
+        if (dateResult == null || dateResult.getMonth() == null || dateResult.getYear() == null) {
             return null;
         }
 
         JSObject date = new JSObject();
-        date.put("day", dateResult.getDay());
         date.put("month", dateResult.getMonth());
         date.put("year", dateResult.getYear());
+
+        if (dateResult.getDay() != null) {
+            date.put("day", dateResult.getDay());
+        }
+
         return date;
     }
 
@@ -216,9 +285,13 @@ public class MicroblinkPlugin extends Plugin {
     }
 
     private String normalized(String value) {
-        if (value == null || value.isEmpty()) {
+        if (value == null) {
+            return null;
+        }
+        String trimmed = value.trim();
+        if (trimmed.isEmpty()) {
             return null;
         }
-        return value;
+        return trimmed;
     }
 }

package/dist/docs.json

@@ -42,6 +42,18 @@
           "InitializeBlinkCardOptions"
         ],
         "slug": "initializeblinkcard"
+      },
+      {
+        "name": "terminateBlinkCard",
+        "signature": "() => Promise<TerminateBlinkCardResult>",
+        "parameters": [],
+        "returns": "Promise<TerminateBlinkCardResult>",
+        "tags": [],
+        "docs": "Terminates BlinkCard SDK and clears cached plugin initialization state.",
+        "complexTypes": [
+          "TerminateBlinkCardResult"
+        ],
+        "slug": "terminateblinkcard"
       }
     ],
     "properties": []
@@ -140,7 +152,7 @@
           "tags": [],
           "docs": "",
           "complexTypes": [],
-          "type": "number"
+          "type": "number | undefined"
         },
         {
           "name": "month",
@@ -261,6 +273,22 @@
           "type": "string | undefined"
         }
       ]
+    },
+    {
+      "name": "TerminateBlinkCardResult",
+      "slug": "terminateblinkcardresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "terminated",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        }
+      ]
     }
   ],
   "enums": [],

package/dist/esm/definitions.d.ts

@@ -1,5 +1,5 @@
 export interface BlinkCardDate {
-    day: number;
+    day?: number;
     month: number;
     year: number;
 }
@@ -20,6 +20,9 @@ export interface InitializeBlinkCardOptions {
 export interface InitializeBlinkCardResult {
     initialized: boolean;
 }
+export interface TerminateBlinkCardResult {
+    terminated: boolean;
+}
 export interface ScanCardResult {
     canceled: boolean;
     resultState?: 'empty' | 'uncertain' | 'valid' | 'stageValid';
@@ -41,4 +44,8 @@ export interface MicroblinkPlugin {
      * Initializes BlinkCard SDK/license before scanning.
      */
     initializeBlinkCard(options: InitializeBlinkCardOptions): Promise<InitializeBlinkCardResult>;
+    /**
+     * Terminates BlinkCard SDK and clears cached plugin initialization state.
+     */
+    terminateBlinkCard(): Promise<TerminateBlinkCardResult>;
 }

package/dist/esm/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface BlinkCardDate {\n  day: number;\n  month: number;\n  year: number;\n}\n\nexport interface ScanCardOptions {\n  licenseKey?: string;\n  licensee?: string;\n  extractOwner?: boolean;\n  extractExpiryDate?: boolean;\n  extractCvv?: boolean;\n  extractIban?: boolean;\n  allowInvalidCardNumber?: boolean;\n  enableEditScreen?: boolean;\n}\n\nexport interface InitializeBlinkCardOptions {\n  licenseKey: string;\n  licensee?: string;\n}\n\nexport interface InitializeBlinkCardResult {\n  initialized: boolean;\n}\n\nexport interface ScanCardResult {\n  canceled: boolean;\n  resultState?: 'empty' | 'uncertain' | 'valid' | 'stageValid';\n  processingStatus?:\n    | 'success'\n    | 'detectionFailed'\n    | 'imagePreprocessingFailed'\n    | 'stabilityTestFailed'\n    | 'scanningWrongSide'\n    | 'fieldIdentificationFailed'\n    | 'imageReturnFailed'\n    | 'unsupportedCard';\n  cardNumber?: string;\n  cardNumberValid?: boolean;\n  cardNumberPrefix?: string;\n  owner?: string;\n  cvv?: string;\n  iban?: string;\n  expiryDate?: BlinkCardDate | null;\n}\n\nexport interface MicroblinkPlugin {\n  /**\n   * Starts BlinkCard card scanning flow.\n   */\n  scanCard(options: ScanCardOptions): Promise<ScanCardResult>;\n\n  /**\n   * Initializes BlinkCard SDK/license before scanning.\n   */\n  initializeBlinkCard(\n    options: InitializeBlinkCardOptions,\n  ): Promise<InitializeBlinkCardResult>;\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface BlinkCardDate {\n  day?: number;\n  month: number;\n  year: number;\n}\n\nexport interface ScanCardOptions {\n  licenseKey?: string;\n  licensee?: string;\n  extractOwner?: boolean;\n  extractExpiryDate?: boolean;\n  extractCvv?: boolean;\n  extractIban?: boolean;\n  allowInvalidCardNumber?: boolean;\n  enableEditScreen?: boolean;\n}\n\nexport interface InitializeBlinkCardOptions {\n  licenseKey: string;\n  licensee?: string;\n}\n\nexport interface InitializeBlinkCardResult {\n  initialized: boolean;\n}\n\nexport interface TerminateBlinkCardResult {\n  terminated: boolean;\n}\n\nexport interface ScanCardResult {\n  canceled: boolean;\n  resultState?: 'empty' | 'uncertain' | 'valid' | 'stageValid';\n  processingStatus?:\n    | 'success'\n    | 'detectionFailed'\n    | 'imagePreprocessingFailed'\n    | 'stabilityTestFailed'\n    | 'scanningWrongSide'\n    | 'fieldIdentificationFailed'\n    | 'imageReturnFailed'\n    | 'unsupportedCard';\n  cardNumber?: string;\n  cardNumberValid?: boolean;\n  cardNumberPrefix?: string;\n  owner?: string;\n  cvv?: string;\n  iban?: string;\n  expiryDate?: BlinkCardDate | null;\n}\n\nexport interface MicroblinkPlugin {\n  /**\n   * Starts BlinkCard card scanning flow.\n   */\n  scanCard(options: ScanCardOptions): Promise<ScanCardResult>;\n\n  /**\n   * Initializes BlinkCard SDK/license before scanning.\n   */\n  initializeBlinkCard(\n    options: InitializeBlinkCardOptions,\n  ): Promise<InitializeBlinkCardResult>;\n\n  /**\n   * Terminates BlinkCard SDK and clears cached plugin initialization state.\n   */\n  terminateBlinkCard(): Promise<TerminateBlinkCardResult>;\n}\n"]}

package/dist/esm/web.d.ts

@@ -1,6 +1,7 @@
 import { WebPlugin } from '@capacitor/core';
-import type { InitializeBlinkCardOptions, InitializeBlinkCardResult, MicroblinkPlugin, ScanCardOptions, ScanCardResult } from './definitions';
+import type { InitializeBlinkCardOptions, InitializeBlinkCardResult, MicroblinkPlugin, ScanCardOptions, ScanCardResult, TerminateBlinkCardResult } from './definitions';
 export declare class MicroblinkWeb extends WebPlugin implements MicroblinkPlugin {
     scanCard(_options: ScanCardOptions): Promise<ScanCardResult>;
     initializeBlinkCard(_options: InitializeBlinkCardOptions): Promise<InitializeBlinkCardResult>;
+    terminateBlinkCard(): Promise<TerminateBlinkCardResult>;
 }

package/dist/esm/web.js

@@ -6,5 +6,8 @@ export class MicroblinkWeb extends WebPlugin {
     async initializeBlinkCard(_options) {
         throw this.unimplemented('BlinkCard is only available on Android and iOS.');
     }
+    async terminateBlinkCard() {
+        throw this.unimplemented('BlinkCard is only available on Android and iOS.');
+    }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAU5C,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,KAAK,CAAC,QAAQ,CAAC,QAAyB;QACtC,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,QAAoC;QAEpC,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  InitializeBlinkCardOptions,\n  InitializeBlinkCardResult,\n  MicroblinkPlugin,\n  ScanCardOptions,\n  ScanCardResult,\n} from './definitions';\n\nexport class MicroblinkWeb extends WebPlugin implements MicroblinkPlugin {\n  async scanCard(_options: ScanCardOptions): Promise<ScanCardResult> {\n    throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n  }\n\n  async initializeBlinkCard(\n    _options: InitializeBlinkCardOptions,\n  ): Promise<InitializeBlinkCardResult> {\n    throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n  }\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAW5C,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,KAAK,CAAC,QAAQ,CAAC,QAAyB;QACtC,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,QAAoC;QAEpC,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC,CAAC;IAC9E,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  InitializeBlinkCardOptions,\n  InitializeBlinkCardResult,\n  MicroblinkPlugin,\n  ScanCardOptions,\n  ScanCardResult,\n  TerminateBlinkCardResult,\n} from './definitions';\n\nexport class MicroblinkWeb extends WebPlugin implements MicroblinkPlugin {\n  async scanCard(_options: ScanCardOptions): Promise<ScanCardResult> {\n    throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n  }\n\n  async initializeBlinkCard(\n    _options: InitializeBlinkCardOptions,\n  ): Promise<InitializeBlinkCardResult> {\n    throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n  }\n\n  async terminateBlinkCard(): Promise<TerminateBlinkCardResult> {\n    throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -13,6 +13,9 @@ class MicroblinkWeb extends core.WebPlugin {
     async initializeBlinkCard(_options) {
         throw this.unimplemented('BlinkCard is only available on Android and iOS.');
     }
+    async terminateBlinkCard() {
+        throw this.unimplemented('BlinkCard is only available on Android and iOS.');
+    }
 }
 
 var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Microblink = registerPlugin('Microblink', {\n    web: () => import('./web').then((m) => new m.MicroblinkWeb()),\n});\nexport * from './definitions';\nexport { Microblink };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class MicroblinkWeb extends WebPlugin {\n    async scanCard(_options) {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n    async initializeBlinkCard(_options) {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,UAAU,GAAGA,mBAAc,CAAC,YAAY,EAAE;AAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;AACjE,CAAC;;ACFM,MAAM,aAAa,SAASC,cAAS,CAAC;AAC7C,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE;AAC7B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,MAAM,mBAAmB,CAAC,QAAQ,EAAE;AACxC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ;;;;;;;;;"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Microblink = registerPlugin('Microblink', {\n    web: () => import('./web').then((m) => new m.MicroblinkWeb()),\n});\nexport * from './definitions';\nexport { Microblink };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class MicroblinkWeb extends WebPlugin {\n    async scanCard(_options) {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n    async initializeBlinkCard(_options) {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n    async terminateBlinkCard() {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;;AACK,MAAC,UAAU,GAAGA,mBAAc,CAAC,YAAY,EAAE;AAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;AACjE,CAAC;;ACFM,MAAM,aAAa,SAASC,cAAS,CAAC;AAC7C,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE;AAC7B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,MAAM,mBAAmB,CAAC,QAAQ,EAAE;AACxC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ,IAAI,MAAM,kBAAkB,GAAG;AAC/B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;AACnF,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -12,6 +12,9 @@ var capacitorMicroblink = (function (exports, core) {
         async initializeBlinkCard(_options) {
             throw this.unimplemented('BlinkCard is only available on Android and iOS.');
         }
+        async terminateBlinkCard() {
+            throw this.unimplemented('BlinkCard is only available on Android and iOS.');
+        }
     }
 
     var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Microblink = registerPlugin('Microblink', {\n    web: () => import('./web').then((m) => new m.MicroblinkWeb()),\n});\nexport * from './definitions';\nexport { Microblink };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class MicroblinkWeb extends WebPlugin {\n    async scanCard(_options) {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n    async initializeBlinkCard(_options) {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,UAAU,GAAGA,mBAAc,CAAC,YAAY,EAAE;IAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;IACjE,CAAC;;ICFM,MAAM,aAAa,SAASC,cAAS,CAAC;IAC7C,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE;IAC7B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,MAAM,mBAAmB,CAAC,QAAQ,EAAE;IACxC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ;;;;;;;;;;;;;;;"}
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst Microblink = registerPlugin('Microblink', {\n    web: () => import('./web').then((m) => new m.MicroblinkWeb()),\n});\nexport * from './definitions';\nexport { Microblink };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\nexport class MicroblinkWeb extends WebPlugin {\n    async scanCard(_options) {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n    async initializeBlinkCard(_options) {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n    async terminateBlinkCard() {\n        throw this.unimplemented('BlinkCard is only available on Android and iOS.');\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":";;;AACK,UAAC,UAAU,GAAGA,mBAAc,CAAC,YAAY,EAAE;IAChD,IAAI,GAAG,EAAE,MAAM,mDAAe,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;IACjE,CAAC;;ICFM,MAAM,aAAa,SAASC,cAAS,CAAC;IAC7C,IAAI,MAAM,QAAQ,CAAC,QAAQ,EAAE;IAC7B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,MAAM,mBAAmB,CAAC,QAAQ,EAAE;IACxC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ,IAAI,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,iDAAiD,CAAC;IACnF,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/MicroblinkPlugin/MicroblinkPlugin.swift

@@ -2,6 +2,7 @@ import Foundation
 import Capacitor
 import Combine
 import SwiftUI
+import AVFoundation
 import BlinkCard
 import BlinkCardUX
 
@@ -11,7 +12,8 @@ public class MicroblinkPlugin: CAPPlugin, CAPBridgedPlugin {
     public let jsName = "Microblink"
     public let pluginMethods: [CAPPluginMethod] = [
         CAPPluginMethod(name: "initializeBlinkCard", returnType: CAPPluginReturnPromise),
-        CAPPluginMethod(name: "scanCard", returnType: CAPPluginReturnPromise)
+        CAPPluginMethod(name: "scanCard", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "terminateBlinkCard", returnType: CAPPluginReturnPromise)
     ]
 
     private enum PluginError: LocalizedError {
@@ -58,6 +60,12 @@ public class MicroblinkPlugin: CAPPlugin, CAPBridgedPlugin {
     }
 
     @objc public func scanCard(_ call: CAPPluginCall) {
+        ensureCameraPermission(call) { [weak self] in
+            self?.performScanCard(call)
+        }
+    }
+
+    private func performScanCard(_ call: CAPPluginCall) {
         if pendingBlinkCardCallId != nil {
             call.reject("A BlinkCard flow is already running.")
             return
@@ -100,6 +108,39 @@ public class MicroblinkPlugin: CAPPlugin, CAPBridgedPlugin {
         }
     }
 
+    private func ensureCameraPermission(_ call: CAPPluginCall, onGranted: @escaping () -> Void) {
+        let status = AVCaptureDevice.authorizationStatus(for: .video)
+        switch status {
+        case .authorized:
+            onGranted()
+        case .notDetermined:
+            AVCaptureDevice.requestAccess(for: .video) { granted in
+                DispatchQueue.main.async {
+                    if granted {
+                        onGranted()
+                    } else {
+                        call.reject("Camera permission is required to scan cards.")
+                    }
+                }
+            }
+        case .denied, .restricted:
+            call.reject("Camera permission is required to scan cards. Enable it in iOS Settings.")
+        @unknown default:
+            call.reject("Unable to determine camera permission status.")
+        }
+    }
+
+    @objc public func terminateBlinkCard(_ call: CAPPluginCall) {
+        Task {
+            await BlinkCardSdk.terminateBlinkCardSdk()
+            await MainActor.run {
+                self.blinkCardSdk = nil
+                self.isBlinkCardInitialized = false
+                call.resolve(["terminated": true])
+            }
+        }
+    }
+
     private func startBlinkCardScan(call: CAPPluginCall, sdk: BlinkCardSdk, presentingViewController: UIViewController) async throws {
         let extractionSettings = ExtractionSettings(
             extractIban: call.getBool("extractIban") ?? true,
@@ -192,16 +233,21 @@ public class MicroblinkPlugin: CAPPlugin, CAPBridgedPlugin {
 
     private func mapBlinkCardDate(_ date: DateResult?) -> [String: Int]? {
         guard let date,
-              let day = date.day,
               let month = date.month,
               let year = date.year else {
             return nil
         }
-        return [
-            "day": day,
+
+        var mappedDate: [String: Int] = [
             "month": month,
             "year": year
         ]
+
+        if let day = date.day {
+            mappedDate["day"] = day
+        }
+
+        return mappedDate
     }
 
     private func createBlinkCardSdk(licenseKey: String, licensee: String?) async throws -> BlinkCardSdk {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-microblink",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Capacitor plugin for microblink",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",