@capgo/capacitor-persona 8.0.0

package/ios/Sources/PersonaPlugin/PersonaPlugin.swift

@@ -0,0 +1,216 @@
+import Foundation
+import Capacitor
+import Persona2
+
+@objc(PersonaPlugin)
+public class PersonaPlugin: CAPPlugin, CAPBridgedPlugin {
+    public let identifier = "PersonaPlugin"
+    public let jsName = "Persona"
+    public let pluginMethods: [CAPPluginMethod] = [
+        CAPPluginMethod(name: "startInquiry", returnType: CAPPluginReturnPromise)
+    ]
+
+    @objc func startInquiry(_ call: CAPPluginCall) {
+        DispatchQueue.main.async {
+            guard let presenter = self.bridge?.viewController else {
+                call.reject("Unable to find a presenting view controller.")
+                return
+            }
+
+            do {
+                let inquiry = try self.buildInquiry(call: call)
+                inquiry.start(from: presenter)
+                call.resolve()
+            } catch let error as PersonaPluginError {
+                call.reject(error.localizedDescription)
+            } catch {
+                call.reject(error.localizedDescription)
+            }
+        }
+    }
+
+    private func buildInquiry(call: CAPPluginCall) throws -> Inquiry {
+        let inquiryId = call.getString("inquiryId")
+        let sessionToken = call.getString("sessionToken")
+        let templateId = call.getString("templateId")
+        let templateVersion = call.getString("templateVersion")
+        let referenceId = call.getString("referenceId")
+        let accountId = call.getString("accountId")
+        let locale = call.getString("locale")
+        let fields = makeInquiryFields(from: call.getObject("fields") ?? [:])
+        let environment = try parseEnvironment(call.getString("environment"))
+
+        if let inquiryId {
+            let builder = Inquiry.from(inquiryId: inquiryId, delegate: self)
+            if let sessionToken {
+                _ = builder.sessionToken(sessionToken)
+            }
+            if let locale {
+                _ = builder.locale(locale)
+            }
+            return builder.build()
+        }
+
+        if let templateId {
+            let builder = Inquiry.from(templateId: templateId, delegate: self)
+            if let referenceId {
+                _ = builder.referenceId(referenceId)
+            }
+            if let accountId {
+                _ = builder.accountId(accountId)
+            }
+            if !fields.isEmpty {
+                _ = builder.fields(fields)
+            }
+            if let environment {
+                _ = builder.environment(environment)
+            }
+            if let locale {
+                _ = builder.locale(locale)
+            }
+            return builder.build()
+        }
+
+        if let templateVersion {
+            if locale != nil {
+                throw PersonaPluginError.templateVersionLocaleUnsupported
+            }
+
+            guard let configuration = InquiryConfiguration.build(
+                templateVersion: templateVersion,
+                referenceId: referenceId,
+                accountId: accountId,
+                environment: environment,
+                fields: fields.isEmpty ? nil : fields
+            ) else {
+                throw PersonaPluginError.invalidConfiguration
+            }
+
+            return Inquiry(config: configuration, delegate: self)
+        }
+
+        throw PersonaPluginError.missingIdentifier
+    }
+
+    private func parseEnvironment(_ rawValue: String?) throws -> Environment? {
+        guard let rawValue = rawValue?.trimmingCharacters(in: .whitespacesAndNewlines), !rawValue.isEmpty else {
+            return nil
+        }
+        guard let environment = Environment(rawValue: rawValue.lowercased()) else {
+            throw PersonaPluginError.invalidEnvironment(rawValue)
+        }
+        return environment
+    }
+
+    private func makeInquiryFields(from dictionary: [String: Any]) -> [String: InquiryField] {
+        var output: [String: InquiryField] = [:]
+
+        for (key, value) in dictionary {
+            switch value {
+            case let value as String:
+                output[key] = .string(value)
+            case let value as Bool:
+                output[key] = .bool(value)
+            case let value as Int:
+                output[key] = .int(value)
+            case let value as Float:
+                output[key] = .float(value)
+            case let value as Double:
+                output[key] = .float(Float(value))
+            case let value as NSNumber:
+                if CFGetTypeID(value) == CFBooleanGetTypeID() {
+                    output[key] = .bool(value.boolValue)
+                } else if value.doubleValue.rounded() == value.doubleValue {
+                    output[key] = .int(value.intValue)
+                } else {
+                    output[key] = .float(value.floatValue)
+                }
+            case let value as Date:
+                output[key] = .datetime(value)
+            case let values as [String]:
+                output[key] = .multiChoices(values)
+            case let values as [Any]:
+                let stringValues = values.compactMap { $0 as? String }
+                output[key] = .multiChoices(stringValues)
+            default:
+                output[key] = .unknown
+            }
+        }
+
+        return output
+    }
+
+    private func serializeField(_ field: InquiryField) -> Any {
+        switch field {
+        case .string(let value):
+            return value ?? NSNull()
+        case .int(let value):
+            return value ?? NSNull()
+        case .float(let value):
+            return value ?? NSNull()
+        case .bool(let value):
+            return value ?? NSNull()
+        case .date(let value):
+            return value?.timeIntervalSince1970 ?? NSNull()
+        case .datetime(let value):
+            return value?.timeIntervalSince1970 ?? NSNull()
+        case .choices(let value):
+            return value ?? NSNull()
+        case .multiChoices(let value):
+            return value ?? []
+        case .unknown:
+            return NSNull()
+        @unknown default:
+            return NSNull()
+        }
+    }
+}
+
+extension PersonaPlugin: InquiryDelegate {
+    public func inquiryComplete(inquiryId: String, status: String, fields: [String: InquiryField]) {
+        let serializedFields = fields.mapValues(serializeField)
+        notifyListeners("inquiryComplete", data: [
+            "inquiryId": inquiryId,
+            "status": status,
+            "fields": serializedFields
+        ])
+    }
+
+    public func inquiryCanceled(inquiryId: String?, sessionToken: String?) {
+        var payload: [String: Any] = [:]
+        if let inquiryId {
+            payload["inquiryId"] = inquiryId
+        }
+        if let sessionToken {
+            payload["sessionToken"] = sessionToken
+        }
+
+        notifyListeners("inquiryCanceled", data: payload)
+    }
+
+    public func inquiryError(_ error: any Error) {
+        notifyListeners("inquiryError", data: [
+            "error": error.localizedDescription
+        ])
+    }
+}
+
+private enum PersonaPluginError: LocalizedError {
+    case missingIdentifier
+    case invalidEnvironment(String)
+    case invalidConfiguration
+    case templateVersionLocaleUnsupported
+
+    var errorDescription: String? {
+        switch self {
+        case .missingIdentifier:
+            return "At least one of inquiryId, templateId, or templateVersion must be provided."
+        case .invalidEnvironment(let value):
+            return "Unsupported Persona environment '\(value)'. Use 'production' or 'sandbox'."
+        case .invalidConfiguration:
+            return "Unable to build a Persona inquiry configuration with the provided options."
+        case .templateVersionLocaleUnsupported:
+            return "The locale option is not supported when starting an inquiry with templateVersion on iOS."
+        }
+    }
+}

package/ios/Tests/PersonaPluginTests/PersonaPluginTests.swift

@@ -0,0 +1,8 @@
+import XCTest
+@testable import PersonaPlugin
+
+final class PersonaPluginTests: XCTestCase {
+    func testPlaceholder() {
+        XCTAssertTrue(true)
+    }
+}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@capgo/capacitor-persona",
+  "version": "8.0.0",
+  "description": "Capacitor plugin for launching Persona Inquiry flows on iOS and Android.",
+  "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",
+    "CapgoCapacitorPersona.podspec"
+  ],
+  "author": "Martin Donadieu <martin@capgo.app>",
+  "license": "MPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cap-go/capacitor-persona.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Cap-go/capacitor-persona/issues"
+  },
+  "homepage": "https://capgo.app/docs/plugins/persona/",
+  "keywords": [
+    "capacitor",
+    "plugin",
+    "persona",
+    "inquiry",
+    "identity-verification"
+  ],
+  "scripts": {
+    "init-plugin": "./scripts/init-plugin.sh",
+    "verify": "bun run verify:ios && bun run verify:android && bun run verify:web",
+    "verify:ios": "xcodebuild -scheme CapgoCapacitorPersona -destination generic/platform=iOS",
+    "verify:android": "cd android && ./gradlew clean build test && cd ..",
+    "verify:web": "bun run build",
+    "lint": "bun run eslint && bun run prettier -- --check && bun run swiftlint -- lint",
+    "fmt": "bun run eslint -- --fix && bun run prettier -- --write && bun run swiftlint -- --fix --format",
+    "eslint": "eslint . --ext .ts",
+    "prettier": "prettier-pretty-check \"**/*.{css,html,ts,js,java}\" --plugin=prettier-plugin-java",
+    "swiftlint": "node-swiftlint",
+    "docgen": "docgen --api PersonaPlugin --output-readme README.md --output-json dist/docs.json",
+    "build": "bun run clean && bun run docgen && tsc && rollup -c rollup.config.mjs",
+    "clean": "rimraf ./dist",
+    "watch": "tsc --watch",
+    "prepublishOnly": "bun run build",
+    "check:wiring": "node scripts/check-capacitor-plugin-wiring.mjs"
+  },
+  "devDependencies": {
+    "@capacitor/android": "^8.0.0",
+    "@capacitor/cli": "^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",
+    "@types/node": "^24.10.1",
+    "eslint": "^8.57.1",
+    "eslint-plugin-import": "^2.31.0",
+    "husky": "^9.1.7",
+    "prettier": "^3.6.2",
+    "prettier-pretty-check": "^0.2.0",
+    "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"
+    }
+  }
+}