iOS Quickstart - AppActor

// Configure once during app bootstrap.
await AppActor.configure(apiKey: "pk_YOUR_PUBLIC_APP_KEY")

// Fetch offerings and render your paywall from packages.
let offerings = try await AppActor.shared.offerings()
let current = offerings.current

// Purchase a package chosen in your own UI.
guard let package = current?.monthly else { return }
let result = try await AppActor.shared.purchase(package: package)

// Gate access from customer info and entitlements.
let info = try await AppActor.shared.getCustomerInfo()
let isPremium = info.hasActiveEntitlement("premium")

Identity and recovery reminders

Pass a stable appUserId during configure or login if your app already has accounts.
Use restorePurchases() for user-facing restore.
Use syncPurchases() for quiet StoreKit reconciliation.
Use explicit queue-drain recovery only when you truly need it.

Attributes and profile context

Use setAttributes(_:) for developer-defined custom fields only. Reserved system context is collected separately during configure, and integration or attribution data belongs on its dedicated APIs.