iOS SDK (v2.0+)

dependencies: [
    .package(url: "https://github.com/Aeropay-inc/aerosync-ios-sdk", from: "2.2.1")
]

import aerosync_ios_sdk

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>yourapp</string>
        </array>
    </dict>
</array>

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .onOpenURL { url in
                    // The SDK resolves the OAuth return automatically.
                    // Add any additional routing logic here if needed.
                }
        }
    }
}

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else { return }
    // Handle url
}

import SwiftUI
import aerosync_ios_sdk

struct BankLinkView: View {
    var body: some View {
        NavigationView {
            AerosyncSDK(
                token: "your-token-here",
                env: "sandbox",
                deeplink: "yourapp://connect",
                aeroPassUserUuid: "user-uuid-123",
                onEvent: { _ in },
                onSuccess: { data in print(data) },
                onClose: { _ in },
                onLoad: { _ in },
                onError: { _ in }
            )
        }
    }
}

import SwiftUI
import aerosync_ios_sdk

struct BankLinkView: View {
    @Environment(\.presentationMode) var presentationMode

    var body: some View {
        NavigationView {
            AerosyncSDK(
                token: "your-token-here",
                env: "sandbox",                    // "sandbox" or "production"
                deeplink: "yourapp://connect",
                aeroPassUserUuid: "user-uuid-123", // Required
                configurationId: "your-config-id", // Optional
                theme: "light",                    // "light" or "dark"
                manualLinkOnly: false,
                handleMFA: false,
                onEvent: { data in
                    // Widget events and page navigation signals
                },
                onSuccess: { data in
                    // Bank connection completed — parse data for credentials
                    print("Success: \(data)")
                },
                onClose: { _ in
                    presentationMode.wrappedValue.dismiss()
                },
                onLoad: { _ in
                    // Widget finished loading
                },
                onError: { error in
                    print("Error: \(error)")
                }
            )
            .navigationTitle("Link Your Bank")
        }
    }
}

AerosyncSDK(
    token: "your-token-here",
    env: "sandbox",
    deeplink: "yourapp://connect",
    aeroPassUserUuid: "user-uuid-123",
    handleMFA: true,
    jobId: "your-job-id",           // Required when handleMFA is true
    connectionId: "your-conn-id",   // Required when handleMFA is true
    onEvent: { _ in },
    onSuccess: { data in
        // MFA completed successfully
    },
    onClose: { _ in },
    onLoad: { _ in },
    onError: { error in
        print("MFA error: \(error)")
    }
)

struct ContentView: View {
    @State private var showWidget = false

    var body: some View {
        Button("Link Bank Account") {
            showWidget = true
        }
        .sheet(isPresented: $showWidget) {
            NavigationView {
                AerosyncSDK(
                    token: "your-token-here",
                    env: "sandbox",
                    deeplink: "yourapp://connect",
                    aeroPassUserUuid: "user-uuid-123",
                    onEvent: { _ in },
                    onSuccess: { data in
                        showWidget = false
                    },
                    onClose: { _ in
                        showWidget = false
                    },
                    onLoad: { _ in },
                    onError: { _ in }
                )
                .navigationTitle("Link Your Bank")
                .navigationBarTitleDisplayMode(.inline)
            }
        }
    }
}

{
  "type": "pageSuccess",
  "payload": {
    "connectionId": "33e1121dde934c5cb5b964b325e28728",
    "aeroPassUserUuid": "b120bcb5-2f39-48d3-a654-1c437c1ec175",
    "clientName": "Aeropay"
  }
}

{
  "type": "pageSuccess",
  "payload": {
    "accounts": [
      { "connectionId": "33e1121dde934c5cb5b964b325e28728", "accountType": "checking", "accountNumberDisplay": "••••1234" },
      { "connectionId": "84f2232eef045d6dc6a075436f39839", "accountType": "savings", "accountNumberDisplay": "••••5678" }
    ],
    "clientName": "Aeropay",
    "aeroPassUserUuid": "b120bcb5-2f39-48d3-a654-1c437c1ec175"
  }
}

onSuccess: { message in
    guard let result = AerosyncSuccessPayload.parse(from: message) else { return }
    switch result {
    case .multiAccount(let payload):
        for account in payload.accounts {
            print("\(account.accountType): \(account.accountNumberDisplay)")
        }
    case .singleAccount(let payload):
        print("Connected: \(payload.connectionId)")
    }
}

onSuccess: { data in
    guard let jsonData = data.data(using: .utf8),
          let json = try? JSONSerialization.jsonObject(with: jsonData) as? [String: Any],
          let payload = json["payload"] as? [String: Any] else { return }

    if let accounts = payload["accounts"] as? [[String: Any]] {
        // Multi-account: each entry has connectionId, accountType, accountNumberDisplay
    } else {
        let connectionId = payload["connectionId"] as? String
        // Use this to authenticate with the AeroSync API
    }
}