function usePush(): {
  permission: boolean;
  requestPermission: () => Promise<boolean>;
  preferences: NotificationPreference | null;
  loading: boolean;
  error: Error | null;
  updatePreferences: (prefs: {
    marketingEnabled: boolean;
    transactionalEnabled: boolean;
    abandonedCartEnabled: boolean;
    orderUpdatesEnabled: boolean;
    promotionsEnabled: boolean;
  }) => Promise<void>;
  refetchPreferences: () => Promise<void>;
}

import { usePush } from 'react-native-stackfront-sdk';

function NotificationSettings() {
  const { permission, requestPermission, preferences, updatePreferences } = usePush();

  return (
    <View>
      <Text>
        Notifications: {permission ? 'Enabled' : 'Disabled'}
      </Text>
      {!permission && (
        <Button title="Enable Notifications" onPress={requestPermission} />
      )}

      {preferences && (
        <>
          <SwitchRow
            label="Marketing"
            value={preferences.marketingEnabled}
            onValueChange={(v) => updatePreferences({ ...preferences, marketingEnabled: v })}
          />
          <SwitchRow
            label="Order Updates"
            value={preferences.orderUpdatesEnabled}
            onValueChange={(v) => updatePreferences({ ...preferences, orderUpdatesEnabled: v })}
          />
          <SwitchRow
            label="Abandoned Cart"
            value={preferences.abandonedCartEnabled}
            onValueChange={(v) => updatePreferences({ ...preferences, abandonedCartEnabled: v })}
          />
        </>
      )}
    </View>
  );
}

// This happens automatically in useCustomer().login():
devices.linkCustomer(customerId);

POST /api/v1/sdk/notifications/track-open
{ campaign_id: "abc", player_id: "xxx" }

const { devices } = useStackfront();

await devices.requestPermission();         // request iOS/Android permission
await devices.unsubscribe();               // opt out completely
await devices.getPreferences(customerId);  // fetch notification preferences
await devices.updatePreferences(customerId, prefs); // update preferences
devices.getPlayerId();                     // get current OneSignal player ID

import { OneSignal } from 'react-native-onesignal';
OneSignal.User.pushSubscription.getIdAsync(); // get player ID