iOS SDK

import Tripwire

try TripwireClient.shared.configure(
    TripwireConfiguration(publishableKey: "pk_live_...")
)

// At action time (signup, login, checkout)
let handoff = try await TripwireClient.shared.getSession()

// Package.swift
dependencies: [
    .package(path: "../tripwire/sdks/ios"),
],

import SwiftUI
import Tripwire

@main
struct MyApp: App {
    init() {
        do {
            try TripwireClient.shared.configure(
                TripwireConfiguration(publishableKey: "pk_live_your_publishable_key")
            )
        } catch {
            // Reporting only — do not crash on Tripwire misconfiguration.
            print("Tripwire failed to configure:", error)
        }
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

public struct TripwireConfiguration: Sendable {
    public let publishableKey: String
    public var enableBehavioralSignals: Bool
    public var enableAntiTamper: Bool
    public var enableHiddenWebView: Bool
    public var enableCloudIdentifier: Bool
}

struct CheckoutView: View {
    func submit() async {
        do {
            let handoff = try await TripwireClient.shared.getSession()

            var request = URLRequest(url: URL(string: "https://api.example.com/checkout")!)
            request.httpMethod = "POST"
            request.setValue("application/json", forHTTPHeaderField: "Content-Type")
            request.httpBody = try JSONEncoder().encode(CheckoutRequest(
                items: cart,
                tripwire: .init(
                    sessionId: handoff.sessionId,
                    sealedToken: handoff.sealedToken
                )
            ))

            _ = try await URLSession.shared.data(for: request)
        } catch {
            // Degrade gracefully — see Error handling below.
        }
    }
}

public struct SessionHandoff: Sendable, Equatable {
    public let sessionId: String
    public let sealedToken: String
}

class CheckoutViewController: UIViewController {
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        TripwireClient.shared.observeTouches(on: view, contextId: "checkout")
    }
}

import WebKit

let webView = WKWebView(frame: .zero)
TripwireClient.shared.attach(to: webView)
webView.load(URLRequest(url: URL(string: "https://your-app.example.com/signup")!))

public struct TripwireError: Error, Sendable {
    public enum Code: String, Sendable {
        case invalidPublishableKey = "config.invalid_publishable_key"
        case notConfigured         = "client.not_configured"
        case sessionCreateFailed   = "session.create_failed"
        case batchPostFailed       = "transport.batch_post_failed"
        case handshakeExpired      = "session.handshake_expired"
        case rateLimited           = "transport.rate_limited"
        case serverUpgradeRequired = "transport.upgrade_required"
        case network               = "transport.network"
        case cryptoFailure         = "crypto.failure"
        case internalError         = "internal"
    }

    public let code: Code
    public let message: String
    public let underlying: Error?
    public let retryable: Bool
}

func tripwireHandoff() async -> SessionHandoff? {
    do {
        return try await TripwireClient.shared.getSession()
    } catch let err as TripwireError where err.retryable {
        return try? await TripwireClient.shared.getSession()
    } catch {
        reportError(error)
        return nil
    }
}