Notificatiekanaal - Laravel Bluesky

Overzicht

laravel-bluesky integreert met het Notification-systeem van Laravel. Met BlueskyChannel verstuur je gewone posts en met BlueskyPrivateChannel directe berichten (DM’s).

Beschikbare kanalen

Kanaal	Gebruik
`BlueskyChannel`	Notificeren als gewone openbare post
`BlueskyPrivateChannel`	Notificeren als DM (privéchat) aan de ontvanger

De Notification-klasse

BlueskyChannel

Geef in via() BlueskyChannel::class op en geef in toBluesky() de inhoud van het bericht terug.

use Illuminate\Notifications\Notification;
use Revolution\Bluesky\Notifications\BlueskyChannel;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\RichText\TextBuilder;
use Revolution\Bluesky\Embed\External;

class TestNotification extends Notification
{
    public function via(object $notifiable): array
    {
        return [
            BlueskyChannel::class
        ];
    }

    public function toBluesky(object $notifiable): Post
    {
        $external = External::create(title: 'Title', description: 'test', uri: 'https://');

        return Post::build(function (TextBuilder $builder) {
                   $builder->text('test')
                           ->newLine()
                           ->tag('#Laravel');
        })->embed($external);
    }
}

Het gebruik van Post is hetzelfde als bij de Basic client. Ook TextBuilder, Embed en dergelijke kun je op dezelfde manier gebruiken.

BlueskyPrivateChannel

BlueskyPrivateMessage is vrijwel gelijk aan Post, maar ondersteunt alleen text, facets en embed. Als embed wordt alleen QuoteRecord ondersteund.

use Illuminate\Notifications\Notification;
use Revolution\Bluesky\Notifications\BlueskyPrivateChannel;
use Revolution\Bluesky\Notifications\BlueskyPrivateMessage;
use Revolution\Bluesky\RichText\TextBuilder;
use Revolution\Bluesky\Embed\QuoteRecord;
use Revolution\Bluesky\Types\StrongRef;

class TestNotification extends Notification
{
    public function via(object $notifiable): array
    {
        return [
            BlueskyPrivateChannel::class
        ];
    }

    public function toBlueskyPrivate(object $notifiable): BlueskyPrivateMessage
    {
        $quote = QuoteRecord::create(StrongRef::to(uri: 'at://', cid: 'cid'));

        return BlueskyPrivateMessage::build(function (TextBuilder $builder) {
                   $builder->text('test')
                           ->newLine()
                           ->tag('#Laravel');
        })->embed($quote);
    }
}

On-demand notificaties

Wil je zonder model ter plekke een ontvanger opgeven, gebruik dan Notification::route().

BlueskyChannel

use Illuminate\Support\Facades\Notification;
use Revolution\Bluesky\Notifications\BlueskyRoute;
use Revolution\Bluesky\Session\OAuthSession;
use App\Models\User;

// App password
Notification::route('bluesky', BlueskyRoute::to(identifier: config('bluesky.identifier'), password: config('bluesky.password')))
            ->notify(new TestNotification());

// OAuth
$user = User::find(1);
$session = OAuthSession::create([
    'did' => $user->did,
    'iss' => $user->iss,
    'refresh_token' => $user->refresh_token,
]);
Notification::route('bluesky', BlueskyRoute::to(oauth: $session))
            ->notify(new TestNotification());

BlueskyPrivateChannel

Voor DM’s is het opgeven van een receiver (de DID of handle van de ontvanger) verplicht. Daarnaast moet de ontvanger het ontvangen van DM’s hebben ingeschakeld.

Bij een app password heb je de bevoegdheid nodig om DM’s te versturen.
Bij OAuth is de scope transition:chat.bsky vereist.

use Illuminate\Support\Facades\Notification;
use Revolution\Bluesky\Notifications\BlueskyRoute;
use Revolution\Bluesky\Session\OAuthSession;
use App\Models\User;

// App password
Notification::route('bluesky-private', BlueskyRoute::to(identifier: config('bluesky.identifier'), password: config('bluesky.password'), receiver: 'did or handle'))
            ->notify(new TestNotification());

// OAuth
$user = User::find(1);
$session = OAuthSession::create([
    'did' => $user->did,
    'iss' => $user->iss,
    'refresh_token' => $user->refresh_token,
]);
Notification::route('bluesky-private', BlueskyRoute::to(oauth: $session, receiver: 'did or handle'))
            ->notify(new TestNotification());

Op Bluesky kun je geen DM naar jezelf sturen. Wil je jezelf notificeren, maak dan een apart account aan voor het versturen.

// Een DM naar jezelf sturen

use Illuminate\Support\Facades\Notification;
use Revolution\Bluesky\Notifications\BlueskyRoute;

Notification::route('bluesky-private', BlueskyRoute::to(identifier: 'sender identifier', password: 'sender password', receiver: 'your did or handle'))
            ->notify(new TestNotification());

Gebruik je altijd dezelfde afzender en ontvanger, bijvoorbeeld voor persoonlijk gebruik, dan kun je dit instellen in .env. Maak een account aan dat alleen voor versturen dient.

BLUESKY_SENDER_IDENTIFIER=sender did or handle
BLUESKY_SENDER_APP_PASSWORD=sender password
BLUESKY_RECEIVER=your did or handle

Notification::route('bluesky-private', BlueskyRoute::to(
    identifier: config('bluesky.notification.private.sender.identifier'),
    password: config('bluesky.notification.private.sender.password'),
    receiver: config('bluesky.notification.private.receiver'),
))->notify(new TestNotification());

Gebruikersnotificaties

Definieer de notificatierouting op een model dat de Notifiable-trait gebruikt.

BlueskyChannel

use Illuminate\Notifications\Notifiable;
use Revolution\Bluesky\Notifications\BlueskyRoute;
use Revolution\Bluesky\Session\OAuthSession;

class User
{
    use Notifiable;

    public function routeNotificationForBluesky($notification): BlueskyRoute
    {
        // App password
        return BlueskyRoute::to(identifier: $this->bluesky_identifier, password: $this->bluesky_password);

        // OAuth
        $session = OAuthSession::create([
            'did' => $this->did,
            'iss' => $this->iss,
            'refresh_token' => $this->refresh_token,
        ]);
        return BlueskyRoute::to(oauth: $session);
    }
}

$user->notify(new TestNotification());

BlueskyPrivateChannel

use Illuminate\Notifications\Notifiable;
use Revolution\Bluesky\Notifications\BlueskyRoute;
use Revolution\Bluesky\Session\OAuthSession;

class User
{
    use Notifiable;

    public function routeNotificationForBlueskyPrivate($notification): BlueskyRoute
    {
        // App password
        return BlueskyRoute::to(identifier: $this->bluesky_identifier, password: $this->bluesky_password, receiver: $this->receiver);

        // OAuth
        $session = OAuthSession::create([
            'did' => $this->did,
            'iss' => $this->iss,
            'refresh_token' => $this->refresh_token,
        ]);
        return BlueskyRoute::to(oauth: $session, receiver: $this->receiver);
    }
}

$user->notify(new TestNotification());

Je kunt ook de gebruiker zelf als ontvanger instellen.

public function routeNotificationForBlueskyPrivate($notification): BlueskyRoute
{
    // App password
    return BlueskyRoute::to(identifier: 'sender identifier', password: 'sender password', receiver: $this->did);
}

BlueskyRoute

De manier van opgeven verschilt per authenticatiemethode (app password of OAuth). Het gebruik van named arguments wordt aanbevolen.

use Revolution\Bluesky\Notifications\BlueskyRoute;
use Revolution\Bluesky\Session\OAuthSession;

// App password
BlueskyRoute::to(identifier: config('bluesky.identifier'), password: config('bluesky.password'))

// OAuth
$session = OAuthSession::create([
    'did' => '...',
    'iss' => '...',
    'refresh_token' => '...',
]);
BlueskyRoute::to(oauth: $session);

Als je alleen notificaties naar je eigen account stuurt, is een app password het eenvoudigst. Je hoeft geen rekening te houden met het verversen van het refresh_token en het werkt door alleen .env in te stellen.

BLUESKY_IDENTIFIER=
BLUESKY_APP_PASSWORD=

Het resultaat van de notificatie controleren

Net als in gewoon Laravel kun je met het NotificationSent-event de response na de notificatie bekijken.

use Illuminate\Notifications\Events\NotificationSent;
use Illuminate\Http\Client\Response;

class Listener
{
    public function handle(NotificationSent $event): void
    {
        // $event->channel  BlueskyChannel
        // $event->notifiable
        // $event->notification
        // $event->response  null|Response
    }
}

Source: docs/notification.md

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Notificatiekanaal - Laravel Bluesky

Overzicht

Beschikbare kanalen

De Notification-klasse

BlueskyChannel

BlueskyPrivateChannel

On-demand notificaties

BlueskyChannel

BlueskyPrivateChannel

Gebruikersnotificaties

BlueskyChannel

BlueskyPrivateChannel

BlueskyRoute

Het resultaat van de notificatie controleren

​Overzicht

​Beschikbare kanalen

​De Notification-klasse

​BlueskyChannel

​BlueskyPrivateChannel

​On-demand notificaties

​BlueskyChannel

​BlueskyPrivateChannel

​Gebruikersnotificaties

​BlueskyChannel

​BlueskyPrivateChannel

​BlueskyRoute

​Het resultaat van de notificatie controleren

Overzicht

Beschikbare kanalen

De Notification-klasse

BlueskyChannel

BlueskyPrivateChannel

On-demand notificaties

BlueskyChannel

BlueskyPrivateChannel

Gebruikersnotificaties

BlueskyChannel

BlueskyPrivateChannel

BlueskyRoute

Het resultaat van de notificatie controleren