iOS SDK

https://github.com/Abrova-co/abrova-push-ios-sdk.git

dependencies: [
    .package(url: "https://github.com/Abrova-co/abrova-push-ios-sdk.git", from: "0.1.16")
]

import AbrovaPush

import UIKit
import AbrovaPush

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

        // Only apiKey is required — connection settings are fetched
        // automatically during registration.
        let config = AbrovaPushConfig(apiKey: "ab_live_your_api_key")

        AbrovaPush.shared.initialize(config: config)
        AbrovaPush.shared.delegate = self

        return true
    }

    func application(_ application: UIApplication,
                     didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        // Forward the APNs token so the server can reach the device in background.
        AbrovaPush.shared.setAPNsToken(deviceToken)
    }

    func applicationDidBecomeActive(_ application: UIApplication) {
        // Open the Abrova real-time connection while the app is in foreground.
        AbrovaPush.shared.connect()
    }

    func applicationWillResignActive(_ application: UIApplication) {
        // Close the real-time connection when going to background.
        // VoIP pushes will still wake the app.
        AbrovaPush.shared.disconnect()
    }
}

import UIKit
import AbrovaPush

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()

        // Register on every launch: it keeps the device's token, app version
        // and last-seen time current on the server.
        AbrovaPush.shared.register(
            userId: "user_123",
            metadata: [
                "tier": "premium"
            ]
        )
    }
}

extension AppDelegate: AbrovaPushDelegate {
    func abrovaPush(_ abrovaPush: AbrovaPush, didReceiveMessage message: AbrovaPushMessage) {
        // New push notification — message.title, message.body, message.data
    }

    func abrovaPush(_ abrovaPush: AbrovaPush, didChangeConnectionState connected: Bool) {
        // Real-time connection state changed
    }

    func abrovaPush(_ abrovaPush: AbrovaPush, didRegisterWithDeviceId deviceId: String) {
        // Device registered with the Abrova backend
    }

    func abrovaPush(_ abrovaPush: AbrovaPush, didReceiveVoIPToken token: String) {
        // VoIP token for backend delivery
    }

    func abrovaPush(_ abrovaPush: AbrovaPush, didFailWithError error: Error) {
        // Connection or registration error
    }
}

┌────────────────────────────────────────────────────────────┐
│                    App State                                │
├─────────────────┬─────────────────┬────────────────────────┤
│   Foreground    │   Background    │   Killed/Terminated    │
├─────────────────┼─────────────────┼────────────────────────┤
│  Abrova         │      APNs       │         APNs           │
│  (real-time)    │ (VoIP optional) │    (VoIP optional)     │
└─────────────────┴─────────────────┴────────────────────────┘

AbrovaPush.shared.subscribeTopic("news")

// Later, when the user opts out
AbrovaPush.shared.unsubscribeTopic("news")

// Set user ID after login
AbrovaPush.shared.setUserId("user_123")

// Clear user ID after logout — also detaches the user on the server,
// so this device stops receiving the previous user's notifications
AbrovaPush.shared.clearUserId()

{
  "title": "New Message",
  "body": "You have a new message",
  "data": {
    "type": "voip_call",
    "screen": "chat",
    "chatId": "123"
  }
}

let config = AbrovaPushConfig(
    apiKey: "ab_live_your_api_key",
    usePushKit: false,
    useAPNs: true,
    showNotificationInForeground: false,
    autoConnect: true,
    appGroup: "group.com.yourcompany.yourapp",
    autoRefresh: true
)

func application(_ application: UIApplication,
                 didReceiveRemoteNotification userInfo: [AnyHashable: Any],
                 fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    AbrovaPush.shared.handleRemoteNotification(userInfo: userInfo)
    completionHandler(.noData)
}

AbrovaPush.shared.initialize(
    config: AbrovaPushConfig(
        apiKey: "ab_live_your_api_key",
        appGroup: "group.com.yourcompany.yourapp"
    )
)

import UserNotifications
import AbrovaPush

class NotificationService: UNNotificationServiceExtension {

    private static let appGroup = "group.com.yourcompany.yourapp"
    private static let apiKey = "ab_live_your_api_key"

    var contentHandler: ((UNNotificationContent) -> Void)?
    var bestAttemptContent: UNMutableNotificationContent?

    override func didReceive(
        _ request: UNNotificationRequest,
        withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
    ) {
        self.contentHandler = contentHandler
        bestAttemptContent = request.content.mutableCopy() as? UNMutableNotificationContent

        AbrovaPushServiceExtension.didReceive(
            request,
            apiKey: NotificationService.apiKey,
            appGroup: NotificationService.appGroup
        )

        contentHandler(bestAttemptContent ?? request.content)
    }

    override func serviceExtensionTimeWillExpire() {
        if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
            contentHandler(bestAttemptContent)
        }
    }
}