iOS SDK reference

// Package.swift — add to dependencies:
.package(url: "https://github.com/Big-Terence/pushlane-ios-sdk", from: "0.1.0")

// Add to your app target:
.product(name: "PushlaneCore",  package: "pushlane-ios-sdk"),
.product(name: "PushlanePush",  package: "pushlane-ios-sdk"),
.product(name: "PushlaneInApp", package: "pushlane-ios-sdk"),

// Add to your NotificationServiceExtension target only:
.product(name: "PushlaneNotificationService", package: "pushlane-ios-sdk"),

import PushlaneCore
import PushlanePush
import PushlaneInApp

@main
struct MyApp: App {
    init() {
        // 1. Configure — call before any track/identify call.
        Pushlane.configure(
            apiBase:        URL(string: "https://<YOUR_WORKER>")!,
            tenantId:       "YOUR_TENANT_UUID",
            publishableKey: "lpk_live_…",             // from dashboard › Settings › API
            appGroup:       "group.com.example.myapp" // optional; needed for received events
        )

        // 2. Identify — set the user id before tracking events.
        if let userId = Auth.current?.id {
            Pushlane.identify(userId)
        }

        // 3. Session tracking + app_open event (once per cold launch).
        PushlaneInApp.start()

        // 4. Request push permission and register with APNs.
        PushlanePush.register()
    }
}

// Set (or update) the current user — call as soon as the user id is known.
Pushlane.identify("user_42")

// Log out — detach the external id from this device.
Pushlane.reset()

// Zero properties
Pushlane.track("paywall_dismissed")

// With properties
Pushlane.track("paywall_viewed", [
    "placement":  "onboarding",
    "paywall_id": "main",
])

// Mixed types
Pushlane.track("subscription_started", [
    "plan":      "annual",
    "price_usd": 49.99,
    "is_trial":  false,
])

// Explicit construction
PushlaneValue.string("hello")
PushlaneValue.int(42)
PushlaneValue.double(3.14)
PushlaneValue.bool(true)
PushlaneValue.array([.string("a"), .string("b")])

// Literal shorthand (inferred automatically in dictionary literals)
let props: [String: PushlaneValue] = [
    "name":  "Alice",  // .string
    "score": 100,      // .int
    "ratio": 0.5,      // .double
    "paid":  true,     // .bool
]

// AppDelegate.swift (UIKit) or Scene lifecycle equivalent

func application(
    _ app: UIApplication,
    didRegisterForRemoteNotificationsWithDeviceToken token: Data
) {
    PushlanePush.didRegister(deviceToken: token)
}

func application(
    _ app: UIApplication,
    didFailToRegisterForRemoteNotificationsWithError error: Error
) {
    PushlanePush.didFailToRegister(error: error)
}

// NotificationService.swift — in your NSE Xcode target
import PushlaneNotificationService

final class NotificationService: PushlaneNotificationService {
    // Return the SAME App Group id you passed to Pushlane.configure(appGroup:)
    override var pushlaneAppGroup: String? {
        "group.com.example.myapp"
    }
}

<!-- NSE target Info.plist — present in the Xcode template -->
<key>NSExtension</key>
<dict>
  <key>NSExtensionPointIdentifier</key>
  <string>com.apple.usernotifications.service</string>
  <key>NSExtensionPrincipalClass</key>
  <string>$(PRODUCT_MODULE_NAME).NotificationService</string>
</dict>

// Identify for Pushlane AND pass the same id to RevenueCat.
// Both SDKs must use the SAME userId or revenue events won't reach your flows.
let uid = Pushlane.identifyForRevenueCat(currentUser.id)
Purchases.configure(withAPIKey: "appl_…", appUserID: uid)