One call, however many devices.

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_messaging/firebase_messaging.dart';
import 'pusher_hub.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  // Lets notifications arrive while the app is terminated.
  FirebaseMessaging.onBackgroundMessage(pusherHubBackgroundMessageHandler);

  final pusherHub = PusherHub(
    appKey: 'YOUR_APP',
    publicKey: 'pk_live_your_public_key',
    baseUrl: 'https://pusherhub.com/api',
  );

  await pusherHub.registerDevice();

  runApp(MyApp());
}

// When someone signs in, attach this device to them — remembered
// across app restarts until logout().
await pusherHub.login('user-123');

// On sign-out, forget them; the device stays registered, anonymously.
await pusherHub.logout();

// Device model, brand, language and timezone, for segments.
await pusherHub.collectDeviceMetadata();

// Pass resolveLocation: true to also resolve state and city from GPS.
// Asks for location permission — only do this if your app already needs it.
await pusherHub.collectDeviceMetadata(resolveLocation: true);

final navigatorKey = GlobalKey<NavigatorState>(); // MaterialApp(navigatorKey: navigatorKey)

final pusherHub = PusherHub(
  appKey: 'YOUR_APP',
  publicKey: 'pk_live_your_public_key',
  baseUrl: 'https://pusherhub.com/api',
  onNotificationOpened: (data) {
    // Every tap — app open, in the background or closed — with the
    // notification's Custom Data, e.g. {"campaign_id": "232"}.
    final campaignId = data['campaign_id'];
    if (campaignId != null) {
      navigatorKey.currentState?.pushNamed('/campaign', arguments: campaignId);
    }
  },
);

final pusherHub = PusherHub(
  appKey: 'YOUR_APP',
  publicKey: 'pk_live_your_public_key',
  baseUrl: 'https://pusherhub.com/api',
  onNotificationClick: (deepLink) {
    // By default the SDK opens the link in an external browser.
    Navigator.of(context).pushNamed(deepLink);
  },
);

import com.pusherhub.sdk.PusherHub

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()

        PusherHub.initialize(
            context = this,
            appKey = "YOUR_APP",
            publicKey = "pk_live_your_public_key",
            baseUrl = "https://pusherhub.com/api",
        )

        PusherHub.registerDevice()
    }
}

PusherHub.registerDevice { PusherHub.collectDeviceMetadata() }

PusherHub.login("user-123")   // attach this device to a user, remembered until logout()
PusherHub.logout()            // forget them; stays registered, anonymously

// In the Activity that asked for POST_NOTIFICATIONS:
override fun onRequestPermissionsResult(
    requestCode: Int,
    permissions: Array<out String>,
    grantResults: IntArray,
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults)
    PusherHub.onRequestPermissionsResult(requestCode)
}

override fun onNewToken(token: String) {
    super.onNewToken(token)
    PusherHub.handleNewToken(token)
}

PusherHub.initialize(
    context = this,
    appKey = "YOUR_APP",
    publicKey = "pk_live_your_public_key",
    baseUrl = "https://pusherhub.com/api",
    onNotificationOpened = { data ->
        // Every tap — app open, in the background or closed — with the
        // notification's Custom Data, e.g. {"campaign_id": "232"}.
        data["campaign_id"]?.let { campaignId ->
            startActivity(Intent(this, CampaignActivity::class.java).putExtra("campaign_id", campaignId))
        }
    },
)

PusherHub.initialize(
    context = this,
    appKey = "YOUR_APP",
    publicKey = "pk_live_your_public_key",
    baseUrl = "https://pusherhub.com/api",
    onNotificationClick = { deepLink ->
        // Default behaviour opens the link in a browser.
        startActivity(Intent(this, DetailActivity::class.java).putExtra("link", deepLink))
    },
)

import com.pusherhub.sdk.PusherHub;

public class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        PusherHub.initialize(
            this,
            "YOUR_APP",
            "pk_live_your_public_key",
            "https://pusherhub.com/api"
        );

        PusherHub.registerDevice();
    }
}

PusherHub.registerDevice(() -> PusherHub.collectDeviceMetadata());

// Or with your own user ID:
PusherHub.registerDevice("user-123", () -> PusherHub.collectDeviceMetadata());

PusherHub.login("user-123");  // attach this device to a user, remembered until logout()
PusherHub.logout();           // forget them; stays registered, anonymously

@Override
public void onRequestPermissionsResult(
    int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults
) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    PusherHub.onRequestPermissionsResult(requestCode);
}

@Override
public void onNewToken(@NonNull String token) {
    super.onNewToken(token);
    PusherHub.handleNewToken(token);
}

PusherHub.initialize(
        this,
        "YOUR_APP",
        "pk_live_your_public_key",
        "https://pusherhub.com/api",
        null, // your deep-link listener, if you have one
        data -> {
            // Every tap — app open, in the background or closed — with the
            // notification's Custom Data, e.g. {"campaign_id": "232"}.
            String campaignId = data.get("campaign_id");
            if (campaignId != null) {
                startActivity(new Intent(this, CampaignActivity.class).putExtra("campaign_id", campaignId));
            }
        });

import UIKit

final class AppDelegate: NSObject, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil
    ) -> Bool {
        PusherHub.initialize(
            appKey: "YOUR_APP",
            publicKey: "pk_live_your_public_key",
            baseUrl: "https://pusherhub.com/api"
        )

        // Asks for notification permission, gets the FCM token and registers the device.
        PusherHub.registerDevice()
        return true
    }

    func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        PusherHub.didRegisterForRemoteNotifications(deviceToken: deviceToken)
    }

    func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
        PusherHub.didFailToRegisterForRemoteNotifications(error: error)
    }
}

import SwiftUI

@main
struct YourApp: App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) private var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
                .pusherHubMessageHost()   // optional: shows in-app messages
        }
    }
}

PusherHub.registerDevice {
    PusherHub.collectDeviceMetadata()   // model, app version, language, country, timezone
}

PusherHub.login(externalId: "user-123")   // attach this device to a user, remembered until logout()
PusherHub.logout()                          // forget them; stays registered, anonymously

PusherHub.initialize(
    appKey: "YOUR_APP",
    publicKey: "pk_live_your_public_key",
    baseUrl: "https://pusherhub.com/api",
    onNotificationOpened: { data in
        // Every tap — app open, in the background or closed — with the
        // notification's Custom Data, e.g. {"campaign_id": "232"}.
        NotificationRouter.shared.campaignId = data["campaign_id"]
    }
)

PusherHub.initialize(
    appKey: "YOUR_APP",
    publicKey: "pk_live_your_public_key",
    baseUrl: "https://pusherhub.com/api",
    onNotificationClick: { deepLink in
        // Default behaviour opens the link with UIApplication.open.
        router.open(deepLink)
    }
)

import PusherHub, { PusherHubMessageHost } from './PusherHub';

export default function App() {
  useEffect(() => {
    (async () => {
      await PusherHub.initialize({
        appKey: 'YOUR_APP',
        publicKey: 'pk_live_your_public_key',
        baseUrl: 'https://pusherhub.com/api',
      });

      PusherHub.attachNotificationHandlers();
      await PusherHub.registerDevice();
    })();
  }, []);

  return (
    <PusherHubMessageHost>
      <YourApp />
    </PusherHubMessageHost>
  );
}

await PusherHub.login('user-123');  // attach this device to a user, remembered until logout()
await PusherHub.logout();           // forget them; stays registered, anonymously

await PusherHub.collectDeviceMetadata();

await PusherHub.initialize({
  appKey: 'YOUR_APP',
  publicKey: 'pk_live_your_public_key',
  baseUrl: 'https://pusherhub.com/api',
  onNotificationOpened: (data) => {
    // Every tap — app open, in the background or closed — with the
    // notification's Custom Data, e.g. {"campaign_id": "232"}.
    // A tap that opened a closed app can come before navigation is ready:
    // keep it and navigate in <NavigationContainer onReady> (see the guide).
    if (data.campaign_id && navigationRef.isReady()) navigationRef.navigate('Campaign', { id: data.campaign_id });
  },
});

await PusherHub.initialize({
  appKey: 'YOUR_APP',
  publicKey: 'pk_live_your_public_key',
  baseUrl: 'https://pusherhub.com/api',
  onNotificationClick: (deepLink) => navigation.navigate(deepLink),
});

using PusherHubSDK;
using UnityEngine;

public static class PusherHubSetup
{
    // Runs once when the game starts — no GameObject or scene change needed.
    [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.AfterSceneLoad)]
    static void Init()
    {
        PusherHub.Initialize(
            appKey: "YOUR_APP",
            publicKey: "pk_live_your_public_key",
            baseUrl: "https://pusherhub.com/api");

        PusherHub.RegisterDevice();
    }
}

PusherHub.Login(currentUserId);  // attach this device to a player, remembered until Logout()
PusherHub.Logout();               // forget them; stays registered, anonymously

PusherHub.RegisterDevice(onComplete: () => PusherHub.CollectDeviceMetadata());

// Shows them now and every time the game returns to the foreground…
PusherHub.EnableInAppMessages();

// …or only at calm moments, e.g. when the main menu opens:
PusherHub.CheckForInAppMessages();

PusherHub.Initialize(
    appKey: "YOUR_APP",
    publicKey: "pk_live_your_public_key",
    baseUrl: "https://pusherhub.com/api",
    onNotificationOpened: data =>
    {
        // Every tap — game open, in the background or closed — with the
        // notification's Custom Data, e.g. {"campaign_id": "232"}.
        if (data.TryGetValue("campaign_id", out var campaignId)) CampaignScreen.Open(campaignId);
    });

PusherHub.Initialize(
    appKey: "YOUR_APP",
    publicKey: "pk_live_your_public_key",
    baseUrl: "https://pusherhub.com/api",
    onNotificationClick: link => OpenScreen(link));