composer require firsthand/nativephp-rich-push

php artisan native:plugin:register firsthand/nativephp-rich-push

'permissions' => [
    'push_notifications' => true,
],

RICH_PUSH_APNS_KEY_ID=ABC123DEFG
RICH_PUSH_APNS_TEAM_ID=XYZ987TEAM
RICH_PUSH_APNS_KEY_PATH=/secure/path/AuthKey_ABC123DEFG.p8
# RICH_PUSH_APNS_TOPIC defaults to NATIVEPHP_APP_ID
# RICH_PUSH_APNS_ENVIRONMENT=production   (TestFlight + App Store; "sandbox" for Xcode runs)

use Firsthand\RichPush\Facades\RichPush;
 
RichPush::enroll();                  // the system "Allow notifications?" prompt
RichPush::token();                   // the APNs token (iOS), once Apple hands it over
RichPush::status();                  // ['platform', 'permission', 'extension', 'token']

use Firsthand\RichPush\Events\NotificationTapped;
use Firsthand\RichPush\Facades\RichPush;
use Native\Mobile\Attributes\On;
use Native\Mobile\Edge\NativeComponent;
 
class Notifications extends NativeComponent
{
    public function allow(): void
    {
        RichPush::enroll();          // <native:pressable text="Allow" @press="allow" />
    }
 
    #[On(NotificationTapped::class)]
    public function opened(string $action, array $data): void
    {
        // a tap, or a button press, while the app is running
    }
 
    public function render()
    {
        return view('native.notifications', ['status' => RichPush::status()]);
    }
}

$result = RichPush::send($token, RichPush::message('New recipe')
    ->subtitle('From Aunt Carole')
    ->body('Lemon bars, the card from 1974')
    ->image('https://example.com/lemon-bars.jpg')   // or ->video(...), ->media(...) for GIFs
    ->badge(1)
    ->thread('family-recipes')
    ->data(['recipe_id' => 42]));
 
if ($result->tokenIsDead()) {
    $user->update(['apns_token' => null]);
} elseif (! $result->ok()) {
    logger()->warning($result->explanation());
}

php artisan rich-push:send <device-token> --image=https://example.com/roast.jpg

use Firsthand\RichPush\Notifications\RichPushChannel;
use Firsthand\RichPush\RichPushMessage;
 
class DinnerIsReady extends Notification
{
    public function via($notifiable) { return [RichPushChannel::class]; }
 
    public function toRichPush($notifiable): RichPushMessage
    {
        return RichPushMessage::create('Dinner is ready')->image($this->recipe->photo_url);
    }
}
 
// On the notifiable: one token or several
public function routeNotificationForRichPush(): array|string { return $this->apns_tokens; }
 
// Optional: called for each token Apple says is gone
public function richPushTokenDied(string $token, ApnsResult $result): void { /* forget it */ }

$message = RichPushMessage::create('Dinner is ready')->image($url);
 
$message->toFcm($fcmToken); // FCM HTTP v1 "message": image for Android + iOS, mutable-content set
$message->toApns();         // the raw APNs JSON body, for any other sender

import { enroll, token, status, takeTap, takeTaps, onNotificationTapped } from '@firsthand/nativephp-rich-push';
 
await enroll();
const t = await token(); // send it to your server
 
onNotificationTapped(({ id, data }) => router.visit(`/recipes/${data.recipe_id}`));
const tap = await takeTap();      // the tap that opened the app, or null
const presses = await takeTaps(); // every tap and button press waiting, oldest first

'categories' => [
    'recipe' => [
        ['id' => 'cook',  'title' => 'Start cooking', 'foreground' => true], // opens the app
        ['id' => 'later', 'title' => 'Remind me later'],                     // works without opening it
        ['id' => 'reply', 'title' => 'Reply', 'input' => true, 'placeholder' => 'Say something…'],
        ['id' => 'skip',  'title' => 'Skip', 'destructive' => true],         // shown in red
    ],
],

RichPush::message('Dinner is ready')->image($photo)->category('recipe')->data(['recipe_id' => 42]);

foreach (RichPush::takeTaps() as $tap) {   // oldest first; reading clears them
    match ($tap['action']) {
        'later' => Reminder::snooze($tap['data']['recipe_id']),
        'reply' => Comment::create(['recipe_id' => $tap['data']['recipe_id'], 'body' => $tap['text']]),
        default => null,
    };
}

use Firsthand\RichPush\Events\NotificationTapped;
use Native\Mobile\Attributes\On;
 
#[On(NotificationTapped::class)]          // #[OnNative(...)] in a Livewire web-view page
public function opened(string $id, string $action, array $data): void
{
    $this->redirect(route('recipes.show', $data['recipe_id']));
}

onNotificationTapped(({ id, action, data, text }) => { /* … */ });

use Firsthand\RichPush\Events\NotificationTapped;
use Native\Mobile\Testing\Native;
 
it('asks for permission, then follows a tap', function () {
    Native::fakeBridge()
        ->respondTo('RichPush.Status', ['platform' => 'ios', 'permission' => 'not_determined', 'extension' => true, 'token' => ''])
        ->respondTo('RichPush.TakeTaps', ['taps' => []])
        ->respondTo('RichPush.Enroll', ['requested' => true]);
 
    Native::test(Notifications::class)
        ->tap('Allow')
        ->emitNative(NotificationTapped::class, ['id' => 'N1', 'action' => 'open', 'data' => ['recipe_id' => 42]]);
 
    Native::fakeBridge()->assertCalled('RichPush.Enroll');
});