Feed Generator

Overzicht

Een Feed Generator is het mechanisme achter “algoritmische feeds” op Bluesky. Je kunt eigen feeds publiceren op basis van bijvoorbeeld specifieke keywords of gebruikerscriteria. Met laravel-bluesky implementeer je eenvoudig een Feed Generator in je Laravel-applicatie.

Officiële tutorial: Custom feeds maken

Officiële starter kit: bluesky-social/feed-generator

Een FeedGenerator-algoritme registreren

De eenvoudigste aanpak is om het algoritme als closure te registreren in AppServiceProvider::boot().

// Registreren in AppServiceProvider::boot()

use Illuminate\Http\Request;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\FeedGenerator\FeedGenerator;

FeedGenerator::register(name: 'artisan', algo: function(int $limit, ?string $cursor, ?string $user, Request $request): array {
    // De implementatie mag je zelf bepalen.

    // Authenticatie is vereist vanwege een tijdelijke API-beperking
    $response = Bluesky::login(identifier: config('bluesky.identifier'), password: config('bluesky.password'))
                       ->searchPosts(q: '#laravel', until: $cursor, limit: $limit);

    $cursor = data_get($response->collect('posts')->last(), 'indexedAt');

    $feed = $response->collect('posts')->map(function(array $post) {
        return ['post' => data_get($post, 'uri')];
    })->toArray();

    // Je kunt via het Request-object ook resultaten teruggeven afgestemd op de gebruiker.
    info('user: '.$user); // De DID van de gebruiker die het request doet. 'did:plc:***'
    info('header', $request->header());

    return compact('cursor', 'feed');
});

Gebruik voor name een URL-veilige string. De returnwaarde van het algoritme is een array met cursor en feed.

[
    'cursor' => '',
    'feed' => [
       ['post' => 'at://'],
       ['post' => 'at://'],
    ],
]

Alle routes die het pakket nodig heeft, worden automatisch geregistreerd.

http://localhost/xrpc/app.bsky.feed.getFeedSkeleton?feed=at://did:web:example.com/app.bsky.feed.generator/artisan
http://localhost/xrpc/app.bsky.feed.describeFeedGenerator
http://localhost/.well-known/did.json
De Service DID wordt automatisch gegenereerd op basis van de huidige URL (bijvoorbeeld did:web:example.com).

Het enige dat je zelf bepaalt, is de name van de FeedGenerator en de implementatie.

De feed publiceren (een command maken)

Alleen een FeedGenerator implementeren in je Laravel-app is niet genoeg om deze op Bluesky te publiceren. Maak een command dat publishFeedGenerator aanroept en voer het uit.

Het command genereren

php artisan make:command PublishGeneratorCommand

Het command implementeren

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Generator;

class PublishGeneratorCommand extends Command
{
    protected $signature = 'bluesky:publish-generator';

    protected $description = 'De FeedGenerator publiceren op Bluesky';

    public function handle()
    {
        $generator = Generator::create(did: 'did:web:example.com', displayName: 'Feed name')
                              ->description('Feed description');

        $res = Bluesky::login(identifier: config('bluesky.identifier'), password: config('bluesky.password'))
                      ->publishFeedGenerator(name: 'artisan', generator: $generator);

        dump($res->json());

        return 0;
    }
}

Het command uitvoeren

php artisan bluesky:publish-generator

Bij succes wordt er een link toegevoegd aan de feedlijst op je Bluesky-profiel. publishFeedGenerator werkt alleen informatie bij, dus je kunt het zo vaak uitvoeren als je wilt.

Meerdere FeedGenerators maken

Je maakt meerdere feeds door simpelweg register meerdere keren aan te roepen met een andere name.

// AppServiceProvider::boot()

use Revolution\Bluesky\FeedGenerator\FeedGenerator;

FeedGenerator::register(name: 'feed1', algo: function() {
    // Implementatie van feed1
});

FeedGenerator::register(name: 'feed2', algo: function() {
    // Implementatie van feed2
});

In het publicatiecommand roep je op dezelfde manier publishFeedGenerator meerdere keren aan.

// PublishGeneratorCommand

Bluesky::login(identifier: config('bluesky.identifier'), password: config('bluesky.password'));

$generator1 = Generator::create(did: 'did:web:example.com', displayName: 'Feed 1')
                       ->description('Feed 1');
Bluesky::publishFeedGenerator(name: 'feed1', generator: $generator1);

$generator2 = Generator::create(did: 'did:web:example.com', displayName: 'Feed 2')
                       ->description('Feed 2');
Bluesky::publishFeedGenerator(name: 'feed2', generator: $generator2);

Het algoritme in een aparte klasse

Door in plaats van een closure een aparte klasse te gebruiken, houd je je code beter georganiseerd. Maak een callable klasse die het FeedGeneratorAlgorithm-contract implementeert en registreer deze in de AppServiceProvider.

// Maak deze aan op een willekeurige plek

namespace App\FeedGenerator;

use Illuminate\Http\Request;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Contracts\FeedGeneratorAlgorithm;

class ArtisanFeed implements FeedGeneratorAlgorithm
{
    public function __invoke(int $limit, ?string $cursor, ?string $user, Request $request): array
    {
        // Authenticatie is vereist vanwege een tijdelijke API-beperking
        $response = Bluesky::login(identifier: config('bluesky.identifier'), password: config('bluesky.password'))
            ->searchPosts(q: '#laravel', until: $cursor, limit: $limit);

        $cursor = data_get($response->collect('posts')->last(), 'indexedAt');

        $feed = $response->collect('posts')->map(function (array $post) {
            return ['post' => data_get($post, 'uri')];
        })->toArray();

        info('user: '.$user);
        info('header', $request->header());

        return compact('cursor', 'feed');
    }
}

// AppServiceProvider::boot()

use Revolution\Bluesky\FeedGenerator\FeedGenerator;
use App\FeedGenerator\ArtisanFeed;

FeedGenerator::register(name: 'artisan', algo: ArtisanFeed::class);

Authenticatie

De authenticatiefunctionaliteit van de officiële starter kit is standaard ingeschakeld. Om deze uit te schakelen geef je aan validateAuthUsing een closure door die simpelweg de gebruikers-DID teruggeeft.

// AppServiceProvider::boot()

use Illuminate\Http\Request;
use Revolution\Bluesky\Crypto\JsonWebToken;
use Revolution\Bluesky\FeedGenerator\FeedGenerator;

FeedGenerator::validateAuthUsing(function (?string $jwt, Request $request): ?string {
    [, $payload] = JsonWebToken::explode($jwt);
    return data_get($payload, 'iss');
});

Feeds worden beïnvloed door de “taalinstellingen” van het account. Als de FeedGenerator wel posts ophaalt maar de feed niet zichtbaar is op Bluesky, controleer dan de taalinstellingen van je account.

Geavanceerd gebruik

Door met een Artisan-command en de task scheduler posts in een database op te slaan en in het algoritme alleen uit de database te lezen, krijg je een snelle feed zonder API-aanroepen.

// Voorbeeld: het algoritme geeft de feed terug vanuit de database

FeedGenerator::register(name: 'cached-feed', algo: function(int $limit, ?string $cursor): array {
    $query = \App\Models\Post::query()
        ->orderByDesc('indexed_at')
        ->limit($limit);

    if ($cursor) {
        $query->where('indexed_at', '<', $cursor);
    }

    $posts = $query->get();

    $cursor = $posts->last()?->indexed_at;

    $feed = $posts->map(fn ($post) => ['post' => $post->uri])->toArray();

    return compact('cursor', 'feed');
});

// Voorbeeld: periodiek posts verzamelen via de scheduler (routes/console.php)

use Illuminate\Support\Facades\Schedule;

Schedule::command('bluesky:collect-posts')->everyFiveMinutes();

Source: docs/feed-generator.md

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Overzicht

Een FeedGenerator-algoritme registreren

De feed publiceren (een command maken)

Meerdere FeedGenerators maken

Het algoritme in een aparte klasse

Authenticatie

Geavanceerd gebruik

​Overzicht

​Een FeedGenerator-algoritme registreren

​De feed publiceren (een command maken)

​Meerdere FeedGenerators maken

​Het algoritme in een aparte klasse

​Authenticatie

​Geavanceerd gebruik

Overzicht

Een FeedGenerator-algoritme registreren

De feed publiceren (een command maken)

Meerdere FeedGenerators maken

Het algoritme in een aparte klasse

Authenticatie

Geavanceerd gebruik