capacitor-microblink 0.0.1

package/CapacitorMicroblink.podspec

@@ -0,0 +1,18 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'CapacitorMicroblink'
+  s.version = package['version']
+  s.summary = package['description']
+  s.license = package['license']
+  s.homepage = package['repository']['url']
+  s.author = package['author']
+  s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
+  s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.ios.deployment_target = '16.0'
+  s.dependency 'Capacitor'
+  s.dependency 'MicroblinkPlatform', '1.7.0'
+  s.swift_version = '5.9'
+end

package/Package.swift

@@ -0,0 +1,30 @@
+// swift-tools-version: 5.9
+import PackageDescription
+
+let package = Package(
+    name: "CapacitorMicroblink",
+    platforms: [.iOS(.v16)],
+    products: [
+        .library(
+            name: "CapacitorMicroblink",
+            targets: ["MicroblinkPlugin"])
+    ],
+    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")
+    ],
+    targets: [
+        .target(
+            name: "MicroblinkPlugin",
+            dependencies: [
+                .product(name: "Capacitor", package: "capacitor-swift-pm"),
+                .product(name: "Cordova", package: "capacitor-swift-pm"),
+                .product(name: "MicroblinkPlatform", package: "microblink-platform-ios")
+            ],
+            path: "ios/Sources/MicroblinkPlugin"),
+        .testTarget(
+            name: "MicroblinkPluginTests",
+            dependencies: ["MicroblinkPlugin"],
+            path: "ios/Tests/MicroblinkPluginTests")
+    ]
+)

package/README.md

@@ -0,0 +1,92 @@
+# capacitor-microblink
+
+Capacitor plugin for microblink
+
+## Install
+
+```bash
+npm install capacitor-microblink
+npx cap sync
+```
+
+## API
+
+<docgen-index>
+
+* [`startVerification(...)`](#startverification)
+* [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>
+
+--------------------
+
+
+### Interfaces
+
+
+#### StartVerificationResult
+
+| 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> |
+
+
+#### CardScanResult
+
+| Prop             | Type                |
+| ---------------- | ------------------- |
+| **`cardNumber`** | <code>string</code> |
+| **`expiryDate`** | <code>string</code> |
+| **`owner`**      | <code>string</code> |
+| **`cvv`**        | <code>string</code> |
+
+
+#### StartVerificationOptions
+
+| 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>                                             |
+
+
+### Type Aliases
+
+
+#### Record
+
+Construct a type with a set of properties K of type T
+
+<code>{
 [P in K]: T;
 }</code>
+
+</docgen-api>

package/android/build.gradle

@@ -0,0 +1,63 @@
+ext {
+    junitVersion = project.hasProperty('junitVersion') ? rootProject.ext.junitVersion : '4.13.2'
+    androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.1'
+    androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.3.0'
+    androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.7.0'
+}
+
+buildscript {
+    repositories {
+        google()
+        mavenCentral()
+        maven { url "https://maven.microblink.com" }
+    }
+    dependencies {
+        classpath 'com.android.tools.build:gradle:8.13.0'
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    namespace = "com.otto.microblink"
+    compileSdk = project.hasProperty('compileSdkVersion') ? rootProject.ext.compileSdkVersion : 36
+    defaultConfig {
+        minSdkVersion project.hasProperty('minSdkVersion') ? rootProject.ext.minSdkVersion : 24
+        targetSdkVersion project.hasProperty('targetSdkVersion') ? rootProject.ext.targetSdkVersion : 36
+        versionCode 1
+        versionName "1.0"
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles "proguard-rules.pro"
+    }
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+    lint {
+        abortOnError = false
+        disable += ["Aligned16KB"]
+    }
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_21
+        targetCompatibility JavaVersion.VERSION_21
+    }
+}
+
+repositories {
+    google()
+    mavenCentral()
+    maven { url "https://maven.microblink.com" }
+}
+
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation project(':capacitor-android')
+    implementation "androidx.appcompat:appcompat:$androidxAppCompatVersion"
+    implementation "com.microblink:microblink-platform:1.7.0"
+    testImplementation "junit:junit:$junitVersion"
+    androidTestImplementation "androidx.test.ext:junit:$androidxJunitVersion"
+    androidTestImplementation "androidx.test.espresso:espresso-core:$androidxEspressoCoreVersion"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.CAMERA" />
+</manifest>

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

@@ -0,0 +1,213 @@
+package com.otto.microblink;
+
+import com.getcapacitor.JSObject;
+import com.getcapacitor.Plugin;
+import com.getcapacitor.PluginCall;
+import com.getcapacitor.PluginMethod;
+import com.getcapacitor.annotation.CapacitorPlugin;
+import com.microblink.platform.CardScanResult;
+import com.microblink.platform.MicroblinkPlatform;
+import com.microblink.platform.MicroblinkPlatformCancelState;
+import com.microblink.platform.MicroblinkPlatformCardScanResultListener;
+import com.microblink.platform.MicroblinkPlatformConfig;
+import com.microblink.platform.MicroblinkPlatformConsent;
+import com.microblink.platform.MicroblinkPlatformProxySettings;
+import com.microblink.platform.MicroblinkPlatformResult;
+import com.microblink.platform.MicroblinkPlatformResultListener;
+import com.microblink.platform.MicroblinkPlatformServiceSettings;
+import com.microblink.platform.MicroblinkPlatformUiSettings;
+
+import org.json.JSONException;
+
+import java.util.HashMap;
+import java.util.Iterator;
+import java.util.Map;
+
+@CapacitorPlugin(name = "Microblink")
+public class MicroblinkPlugin extends Plugin {
+
+    private PluginCall pendingCall;
+    private JSObject pendingCardScanResult;
+
+    @PluginMethod
+    public void startVerification(PluginCall call) {
+        if (pendingCall != null) {
+            call.reject("A verification flow is already running.");
+            return;
+        }
+
+        String workflowId = call.getString("workflowId");
+        String url = call.getString("url");
+        String userId = call.getString("userId");
+        Boolean isProcessingStoringAllowed = call.getBoolean("isProcessingStoringAllowed");
+        Boolean isTrainingAllowed = call.getBoolean("isTrainingAllowed");
+        String note = call.getString("note", "");
+        Long givenOn = call.getLong("givenOn", System.currentTimeMillis());
+
+        if (workflowId == null || workflowId.isEmpty()) {
+            call.reject("Missing required field: workflowId.");
+            return;
+        }
+        if (url == null || url.isEmpty()) {
+            call.reject("Missing required field: url.");
+            return;
+        }
+        if (userId == null || userId.isEmpty()) {
+            call.reject("Missing required field: userId.");
+            return;
+        }
+        if (isProcessingStoringAllowed == null) {
+            call.reject("Missing required field: isProcessingStoringAllowed.");
+            return;
+        }
+        if (isTrainingAllowed == null) {
+            call.reject("Missing required field: isTrainingAllowed.");
+            return;
+        }
+
+        MicroblinkPlatformConsent consent = new MicroblinkPlatformConsent(
+            userId,
+            isProcessingStoringAllowed,
+            isTrainingAllowed,
+            note,
+            givenOn
+        );
+
+        Map<String, String> additionalHeaders = new HashMap<>();
+        JSObject headersObject = call.getObject("additionalRequestHeaders");
+        if (headersObject != null) {
+            Iterator<String> keys = headersObject.keys();
+            while (keys.hasNext()) {
+                String key = keys.next();
+                try {
+                    Object rawValue = headersObject.get(key);
+                    if (rawValue != null) {
+                        additionalHeaders.put(key, String.valueOf(rawValue));
+                    }
+                } catch (JSONException ignored) {
+                    // Ignore malformed header value.
+                }
+            }
+        }
+
+        String startTransactionPath = call.getString("startTransactionPath", "");
+        String cancelWorkflowPath = call.getString("cancelWorkflowPath", "");
+        String workflowInfoPath = call.getString("workflowInfoPath", "");
+
+        MicroblinkPlatformProxySettings proxySettings = new MicroblinkPlatformProxySettings(
+            url,
+            startTransactionPath,
+            cancelWorkflowPath,
+            workflowInfoPath,
+            additionalHeaders
+        );
+        MicroblinkPlatformServiceSettings serviceSettings = new MicroblinkPlatformServiceSettings(
+            workflowId,
+            proxySettings,
+            consent
+        );
+        MicroblinkPlatformUiSettings uiSettings = new MicroblinkPlatformUiSettings();
+
+        MicroblinkPlatformResultListener resultListener = new MicroblinkPlatformResultListener() {
+            @Override
+            public void onVerificationFinished(MicroblinkPlatformResult result) {
+                JSObject payload = new JSObject();
+                payload.put("canceled", false);
+                payload.put("transactionId", result.getTransactionId());
+                payload.put("status", toResultStatus(result.getState()));
+                if (pendingCardScanResult != null) {
+                    payload.put("cardScanResult", pendingCardScanResult);
+                }
+                resolvePending(payload);
+            }
+
+            @Override
+            public void onVerificationCanceled(MicroblinkPlatformCancelState cancelState) {
+                JSObject payload = new JSObject();
+                payload.put("canceled", true);
+                payload.put("transactionId", cancelState.getTransactionId());
+                payload.put("cancelReason", toCancelReason(cancelState.getCancelReason()));
+                if (pendingCardScanResult != null) {
+                    payload.put("cardScanResult", pendingCardScanResult);
+                }
+                resolvePending(payload);
+            }
+        };
+
+        MicroblinkPlatformCardScanResultListener cardScanResultListener = new MicroblinkPlatformCardScanResultListener() {
+            @Override
+            public void onCardScanned(CardScanResult cardResult) {
+                JSObject cardScan = new JSObject();
+                cardScan.put("cardNumber", cardResult.getCardNumber());
+                cardScan.put("expiryDate", formatExpiry(cardResult));
+                cardScan.put("owner", cardResult.getOwner());
+                cardScan.put("cvv", cardResult.getCvv());
+                pendingCardScanResult = cardScan;
+            }
+        };
+
+        MicroblinkPlatformConfig config = new MicroblinkPlatformConfig(
+            resultListener,
+            serviceSettings,
+            uiSettings,
+            cardScanResultListener
+        );
+
+        pendingCall = call;
+        pendingCardScanResult = null;
+
+        if (getActivity() == null) {
+            clearPendingState();
+            call.reject("Unable to start verification: Activity is unavailable.");
+            return;
+        }
+
+        getActivity().runOnUiThread(() -> MicroblinkPlatform.INSTANCE.startVerification(getActivity(), config));
+    }
+
+    private String toResultStatus(MicroblinkPlatformResult.FinishedState state) {
+        if (state == MicroblinkPlatformResult.FinishedState.Accept) {
+            return "accept";
+        }
+        if (state == MicroblinkPlatformResult.FinishedState.Reject) {
+            return "reject";
+        }
+        return "review";
+    }
+
+    private String toCancelReason(MicroblinkPlatformCancelState.CancelReason reason) {
+        if (reason == MicroblinkPlatformCancelState.CancelReason.ConsentDenied) {
+            return "consentDenied";
+        }
+        return "userCanceled";
+    }
+
+    private String formatExpiry(CardScanResult cardResult) {
+        if (cardResult.getExpiryDate() == null) {
+            return "";
+        }
+        Integer month = cardResult.getExpiryDate().getMonth();
+        Integer year = cardResult.getExpiryDate().getYear();
+        if (month == null && year == null) {
+            return "";
+        }
+        String monthPart = month == null ? "00" : String.format("%02d", month);
+        String yearPart = year == null ? "0000" : String.valueOf(year);
+        return monthPart + "/" + yearPart;
+    }
+
+    private synchronized void resolvePending(JSObject payload) {
+        if (pendingCall == null) {
+            clearPendingState();
+            return;
+        }
+        PluginCall call = pendingCall;
+        clearPendingState();
+        call.resolve(payload);
+    }
+
+    private synchronized void clearPendingState() {
+        pendingCall = null;
+        pendingCardScanResult = null;
+    }
+}

package/dist/docs.json

@@ -0,0 +1,221 @@
+{
+  "api": {
+    "name": "MicroblinkPlugin",
+    "slug": "microblinkplugin",
+    "docs": "",
+    "tags": [],
+    "methods": [
+      {
+        "name": "startVerification",
+        "signature": "(options: StartVerificationOptions) => Promise<StartVerificationResult>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "StartVerificationOptions"
+          }
+        ],
+        "returns": "Promise<StartVerificationResult>",
+        "tags": [],
+        "docs": "Starts Microblink identity verification flow.",
+        "complexTypes": [
+          "StartVerificationResult",
+          "StartVerificationOptions"
+        ],
+        "slug": "startverification"
+      }
+    ],
+    "properties": []
+  },
+  "interfaces": [
+    {
+      "name": "StartVerificationResult",
+      "slug": "startverificationresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "canceled",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "transactionId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | null"
+        },
+        {
+          "name": "status",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "'accept' | 'review' | 'reject' | undefined"
+        },
+        {
+          "name": "cancelReason",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "'userCanceled' | 'consentDenied' | undefined"
+        },
+        {
+          "name": "cardScanResult",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "CardScanResult"
+          ],
+          "type": "CardScanResult"
+        }
+      ]
+    },
+    {
+      "name": "CardScanResult",
+      "slug": "cardscanresult",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "cardNumber",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "expiryDate",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "owner",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "cvv",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        }
+      ]
+    },
+    {
+      "name": "StartVerificationOptions",
+      "slug": "startverificationoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "workflowId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "url",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "userId",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "isProcessingStoringAllowed",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "isTrainingAllowed",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "note",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "givenOn",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "additionalRequestHeaders",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [
+            "Record"
+          ],
+          "type": "Record<string, string>"
+        },
+        {
+          "name": "startTransactionPath",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "cancelWorkflowPath",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        },
+        {
+          "name": "workflowInfoPath",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string | undefined"
+        }
+      ]
+    }
+  ],
+  "enums": [],
+  "typeAliases": [
+    {
+      "name": "Record",
+      "slug": "record",
+      "docs": "Construct a type with a set of properties K of type T",
+      "types": [
+        {
+          "text": "{\r\n    [P in K]: T;\r\n}",
+          "complexTypes": [
+            "K",
+            "T"
+          ]
+        }
+      ]
+    }
+  ],
+  "pluginConfigs": []
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,32 @@
+export interface StartVerificationOptions {
+    workflowId: string;
+    url: string;
+    userId: string;
+    isProcessingStoringAllowed: boolean;
+    isTrainingAllowed: boolean;
+    note?: string;
+    givenOn?: number;
+    additionalRequestHeaders?: Record<string, string>;
+    startTransactionPath?: string;
+    cancelWorkflowPath?: string;
+    workflowInfoPath?: string;
+}
+export interface CardScanResult {
+    cardNumber: string;
+    expiryDate: string;
+    owner: string;
+    cvv: string;
+}
+export interface StartVerificationResult {
+    canceled: boolean;
+    transactionId: string | null;
+    status?: 'accept' | 'review' | 'reject';
+    cancelReason?: 'userCanceled' | 'consentDenied';
+    cardScanResult?: CardScanResult;
+}
+export interface MicroblinkPlugin {
+    /**
+     * Starts Microblink identity verification flow.
+     */
+    startVerification(options: StartVerificationOptions): Promise<StartVerificationResult>;
+}

package/dist/esm/definitions.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"","sourcesContent":["export interface StartVerificationOptions {\n  workflowId: string;\n  url: string;\n  userId: string;\n  isProcessingStoringAllowed: boolean;\n  isTrainingAllowed: boolean;\n  note?: string;\n  givenOn?: number;\n  additionalRequestHeaders?: Record<string, string>;\n  startTransactionPath?: string;\n  cancelWorkflowPath?: string;\n  workflowInfoPath?: string;\n}\n\nexport interface CardScanResult {\n  cardNumber: string;\n  expiryDate: string;\n  owner: string;\n  cvv: string;\n}\n\nexport interface StartVerificationResult {\n  canceled: boolean;\n  transactionId: string | null;\n  status?: 'accept' | 'review' | 'reject';\n  cancelReason?: 'userCanceled' | 'consentDenied';\n  cardScanResult?: CardScanResult;\n}\n\nexport interface MicroblinkPlugin {\n  /**\n   * Starts Microblink identity verification flow.\n   */\n  startVerification(\n    options: StartVerificationOptions,\n  ): Promise<StartVerificationResult>;\n}\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { MicroblinkPlugin } from './definitions';
+declare const Microblink: MicroblinkPlugin;
+export * from './definitions';
+export { Microblink };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const Microblink = registerPlugin('Microblink', {
+    web: () => import('./web').then((m) => new m.MicroblinkWeb()),
+});
+export * from './definitions';
+export { Microblink };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,UAAU,GAAG,cAAc,CAAmB,YAAY,EAAE;IAChE,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;CAC9D,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { MicroblinkPlugin } from './definitions';\n\nconst Microblink = registerPlugin<MicroblinkPlugin>('Microblink', {\n  web: () => import('./web').then((m) => new m.MicroblinkWeb()),\n});\n\nexport * from './definitions';\nexport { Microblink };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,5 @@
+import { WebPlugin } from '@capacitor/core';
+import type { MicroblinkPlugin, StartVerificationOptions, StartVerificationResult } from './definitions';
+export declare class MicroblinkWeb extends WebPlugin implements MicroblinkPlugin {
+    startVerification(_options: StartVerificationOptions): Promise<StartVerificationResult>;
+}

package/dist/esm/web.js

@@ -0,0 +1,7 @@
+import { WebPlugin } from '@capacitor/core';
+export class MicroblinkWeb extends WebPlugin {
+    async startVerification(_options) {
+        throw this.unimplemented('Microblink is only available on Android and iOS.');
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ5C,MAAM,OAAO,aAAc,SAAQ,SAAS;IAC1C,KAAK,CAAC,iBAAiB,CACrB,QAAkC;QAElC,MAAM,IAAI,CAAC,aAAa,CAAC,kDAAkD,CAAC,CAAC;IAC/E,CAAC;CACF","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  MicroblinkPlugin,\n  StartVerificationOptions,\n  StartVerificationResult,\n} from './definitions';\n\nexport class MicroblinkWeb extends WebPlugin implements MicroblinkPlugin {\n  async startVerification(\n    _options: StartVerificationOptions,\n  ): Promise<StartVerificationResult> {\n    throw this.unimplemented('Microblink is only available on Android and iOS.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,21 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+const Microblink = core.registerPlugin('Microblink', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.MicroblinkWeb()),
+});
+
+class MicroblinkWeb extends core.WebPlugin {
+    async startVerification(_options) {
+        throw this.unimplemented('Microblink is only available on Android and iOS.');
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    MicroblinkWeb: MicroblinkWeb
+});
+
+exports.Microblink = Microblink;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +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 startVerification(_options) {\n        throw this.unimplemented('Microblink 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,iBAAiB,CAAC,QAAQ,EAAE;AACtC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,kDAAkD,CAAC;AACpF,IAAI;AACJ;;;;;;;;;"}

package/dist/plugin.js

@@ -0,0 +1,24 @@
+var capacitorMicroblink = (function (exports, core) {
+    'use strict';
+
+    const Microblink = core.registerPlugin('Microblink', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.MicroblinkWeb()),
+    });
+
+    class MicroblinkWeb extends core.WebPlugin {
+        async startVerification(_options) {
+            throw this.unimplemented('Microblink is only available on Android and iOS.');
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        MicroblinkWeb: MicroblinkWeb
+    });
+
+    exports.Microblink = Microblink;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +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 startVerification(_options) {\n        throw this.unimplemented('Microblink 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,iBAAiB,CAAC,QAAQ,EAAE;IACtC,QAAQ,MAAM,IAAI,CAAC,aAAa,CAAC,kDAAkD,CAAC;IACpF,IAAI;IACJ;;;;;;;;;;;;;;;"}

package/ios/Sources/MicroblinkPlugin/MicroblinkPlugin.swift

@@ -0,0 +1,168 @@
+import Foundation
+import Capacitor
+import MicroblinkPlatform
+
+@objc(MicroblinkPlugin)
+public class MicroblinkPlugin: CAPPlugin, CAPBridgedPlugin, MicroblinkPlatformSDKDelegate {
+    public let identifier = "MicroblinkPlugin"
+    public let jsName = "Microblink"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "startVerification", returnType: CAPPluginReturnPromise)
+    ]
+    private var pendingCallId: String?
+    private var sdk: MicroblinkPlatformSDK?
+    private var pendingCardScanResult: [String: Any]?
+
+    @objc public func startVerification(_ call: CAPPluginCall) {
+        if pendingCallId != nil {
+            call.reject("A verification flow is already running.")
+            return
+        }
+        guard let workflowId = call.getString("workflowId"), !workflowId.isEmpty else {
+            call.reject("Missing required field: workflowId.")
+            return
+        }
+        guard let url = call.getString("url"), !url.isEmpty else {
+            call.reject("Missing required field: url.")
+            return
+        }
+        guard let userId = call.getString("userId"), !userId.isEmpty else {
+            call.reject("Missing required field: userId.")
+            return
+        }
+        guard let isProcessingStoringAllowed = call.getBool("isProcessingStoringAllowed") else {
+            call.reject("Missing required field: isProcessingStoringAllowed.")
+            return
+        }
+        guard let isTrainingAllowed = call.getBool("isTrainingAllowed") else {
+            call.reject("Missing required field: isTrainingAllowed.")
+            return
+        }
+        guard let vc = bridge?.viewController else {
+            call.reject("No view controller available")
+            return
+        }
+
+        let givenOnMs = call.getDouble("givenOn") ?? Date().timeIntervalSince1970 * 1000
+        let givenOn = Date(timeIntervalSince1970: givenOnMs / 1000)
+        let consent = MicroblinkPlatformConsent(
+            userId: userId,
+            isProcessingStoringAllowed: isProcessingStoringAllowed,
+            isTrainingAllowed: isTrainingAllowed,
+            isGivenOn: givenOn,
+            note: call.getString("note")
+        )
+
+        let serviceSettings = MicroblinkPlatformServiceSettings(
+            workflowId: workflowId,
+            url: url,
+            consent: consent,
+            additionalRequestHeaders: call.getObject("additionalRequestHeaders") as? [String: String]
+        )
+        if let startTransaction = call.getString("startTransactionPath"), !startTransaction.isEmpty {
+            serviceSettings.startTransaction = startTransaction
+        }
+        if let cancelWorkflow = call.getString("cancelWorkflowPath"), !cancelWorkflow.isEmpty {
+            serviceSettings.cancelWorkflow = cancelWorkflow
+        }
+        if let workflowInfo = call.getString("workflowInfoPath"), !workflowInfo.isEmpty {
+            serviceSettings.getWorkflowInfo = workflowInfo
+        }
+
+        pendingCardScanResult = nil
+        bridge?.saveCall(call)
+        pendingCallId = call.callbackId
+        sdk = MicroblinkPlatformSDK(serviceSettings: serviceSettings, delegate: self)
+
+        let sdkViewController = sdk?.startSDK()
+        guard let sdkViewController else {
+            clearPendingState()
+            call.reject("Unable to start verification.")
+            return
+        }
+        vc.present(sdkViewController, animated: true)
+    }
+
+    public func microblinkPlatformSDKDidFinish(
+        viewController: UIViewController,
+        result: MicroblinkPlatformResult
+    ) {
+        var payload: [String: Any] = [
+            "canceled": false,
+            "transactionId": result.transactionId,
+            "status": mapStatus(result.status)
+        ]
+        if let pendingCardScanResult {
+            payload["cardScanResult"] = pendingCardScanResult
+        }
+        finalize(viewController: viewController, payload: payload)
+    }
+
+    public func microblinkPlatformSDKDidClose(
+        viewController: UIViewController,
+        cancelState: MicroblinkPlatformCancelState
+    ) {
+        var payload: [String: Any] = [
+            "canceled": true,
+            "transactionId": cancelState.transactionId as Any,
+            "cancelReason": mapCancelReason(cancelState.cancelReason)
+        ]
+        if let pendingCardScanResult {
+            payload["cardScanResult"] = pendingCardScanResult
+        }
+        finalize(viewController: viewController, payload: payload)
+    }
+
+    public func microblinkPlatformSDKDidFinishCardScanStep(
+        viewController: UIViewController,
+        cardScanResult: MicroblinkPlatformResultCardScanResult
+    ) {
+        pendingCardScanResult = [
+            "cardNumber": cardScanResult.cardNumber,
+            "expiryDate": cardScanResult.expiryDate,
+            "owner": cardScanResult.owner,
+            "cvv": cardScanResult.cvv
+        ]
+    }
+
+    private func mapStatus(_ status: MicroblinkPlatformResultStatus) -> String {
+        switch status {
+        case .accept:
+            return "accept"
+        case .review:
+            return "review"
+        case .reject:
+            return "reject"
+        @unknown default:
+            return "review"
+        }
+    }
+
+    private func mapCancelReason(_ reason: MicroblinkPlatformCancelReason) -> String {
+        switch reason {
+        case .userCanceled:
+            return "userCanceled"
+        case .consentDenied:
+            return "consentDenied"
+        @unknown default:
+            return "userCanceled"
+        }
+    }
+
+    private func finalize(viewController: UIViewController, payload: [String: Any]) {
+        viewController.dismiss(animated: true)
+        guard let pendingCallId, let call = bridge?.savedCall(withID: pendingCallId) else {
+            clearPendingState()
+            return
+        }
+        clearPendingState()
+        call.resolve(payload)
+        bridge?.releaseCall(withID: pendingCallId)
+    }
+
+    private func clearPendingState() {
+        pendingCallId = nil
+        pendingCardScanResult = nil
+        sdk = nil
+    }
+}

package/ios/Tests/MicroblinkPluginTests/MicroblinkTests.swift

@@ -0,0 +1,8 @@
+import XCTest
+@testable import MicroblinkPlugin
+
+class MicroblinkTests: XCTestCase {
+    func testPluginBuilds() {
+        XCTAssertTrue(true)
+    }
+}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "capacitor-microblink",
+  "version": "0.0.1",
+  "description": "Capacitor plugin for microblink",
+  "main": "dist/plugin.cjs.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "unpkg": "dist/plugin.js",
+  "files": [
+    "android/src/main/",
+    "android/build.gradle",
+    "dist/",
+    "ios/Sources",
+    "ios/Tests",
+    "Package.swift",
+    "CapacitorMicroblink.podspec"
+  ],
+  "author": "Otto the agent",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ottotheagent/microblink-capacitor.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ottotheagent/microblink-capacitor/issues"
+  },
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "native"
+  ],
+  "scripts": {
+    "verify": "npm run verify:ios && npm run verify:android && npm run verify:web",
+    "verify:ios": "xcodebuild -scheme CapacitorMicroblink -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "npm run build",
+    "lint": "npm run eslint && npm run prettier -- --check && npm run swiftlint -- lint",
+    "fmt": "npm run eslint -- --fix && npm run prettier -- --write && npm run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext ts",
+    "prettier": "prettier \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api MicroblinkPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "npm run clean && npm run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/core": "^8.0.0",
+    "@capacitor/docgen": "^0.3.1",
+    "@capacitor/ios": "^8.0.0",
+    "@ionic/eslint-config": "^0.4.0",
+    "@ionic/prettier-config": "^4.0.0",
+    "@ionic/swiftlint-config": "^2.0.0",
+    "eslint": "^8.57.1",
+    "prettier": "^3.6.2",
+    "prettier-plugin-java": "^2.7.7",
+    "rimraf": "^6.1.0",
+    "rollup": "^4.53.2",
+    "swiftlint": "^2.0.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@capacitor/core": ">=8.0.0"
+  },
+  "prettier": "@ionic/prettier-config",
+  "swiftlint": "@ionic/swiftlint-config",
+  "eslintConfig": {
+    "extends": "@ionic/eslint-config/recommended"
+  },
+  "capacitor": {
+    "ios": {
+      "src": "ios"
+    },
+    "android": {
+      "src": "android"
+    }
+  }
+}