iOS SDK

.package(url: "https://github.com/linktrail-io/ios-sdk.git", from: "0.0.11")

pod 'LinkTrailSDK', '~> 0.0.11'

import LinkTrailSDK

// At launch (SwiftUI App.init or AppDelegate). The API key is required — configure throws.
try LinkTrail.configure(apiKey: "lt_live_...")

// One hook — fires for deferred (first-launch) AND re-engagement links:
LinkTrail.shared?.onLink { link, source in
    router.route(to: link.path, customData: link.customData)
}

LinkTrail.shared?.onError { error in /* e.g. LinkTrailError.invalidAPIKey */ }

// Attributes the install and flushes queued events — without re-routing
// a user who has already been sent to their screen:
LinkTrail.shared?.setConsent(true)

// Revoke at any time (clears the queued events):
LinkTrail.shared?.setConsent(false)

// To attribute at init with no gate, opt out:
try LinkTrail.configure(apiKey: "lt_live_...",
                        options: LinkTrailOptions(requireConsent: false))

.onOpenURL { LinkTrail.shared?.handleDeepLink($0) }
.onContinueUserActivity(NSUserActivityTypeBrowsingWeb) { activity in
    if let url = activity.webpageURL { LinkTrail.shared?.handleDeepLink(url) }
}

// Universal Links (app already running or cold-started from a link):
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
    if let url = userActivity.webpageURL { LinkTrail.shared?.handleDeepLink(url) }
}

// Custom schemes (yourapp://…):
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    URLContexts.forEach { LinkTrail.shared?.handleDeepLink($0.url) }
}

// Custom + revenue events:
LinkTrail.shared?.trackEvent(name: "purchase", value: 59.99, currency: "USD")

// Cached results:
let attribution = LinkTrail.shared?.lastAttribution
let lastLink = LinkTrail.shared?.lastDeepLink

// Attribution hook (fires when an install is attributed):
LinkTrail.shared?.onAttribution { attribution in /* … */ }

// Defer the install call entirely (send it yourself later):
let lt = try LinkTrail.configure(apiKey: "lt_live_...",
                                 options: LinkTrailOptions(autoTrackInstall: false))
lt.trackInstall()

// ATT / SKAdNetwork:
await LinkTrail.shared?.requestTrackingAuthorization()
LinkTrail.shared?.registerForSKAdAttribution()
LinkTrail.shared?.updateConversionValue(42, coarseValue: .medium)

import LinkTrailSDK
import SwiftUI

// The install waits for the tap, so don't auto-track it.
try LinkTrail.configure(
  apiKey: "lt_live_...",
  options: LinkTrailOptions(autoTrackInstall: false,
                            clickTokenSource: .pasteButton)
)

// On your first-launch screen, render the SDK's paste control. The tap is the
// consent, so there is no "Allow Paste" alert: the SDK reads the token, fires
// the install, and onLink routes the recovered destination.
if #available(iOS 16.0, *) {
  LinkTrailPasteButton()
}