Services du protocole Bluesky : Jetstream v2 avec relecture réseau

Bluesky a lancé Bluesky Protocol Services, une nouvelle marque et un site web pour l'infrastructure publique qu'elle exploite sur le réseau AT Protocol. La grande nouvelle est Jetstream v2, qui ajoute Network Replay — un moyen d'obtenir des données réseau historiques via HTTP, puis de basculer sur le flux WebSocket en direct sans interruption.

Jetstream v2 : Network Replay

Jetstream est un service qui permet de s'abonner à une partie du réseau AT Protocol sous forme de JSON brut via WebSocket. Auparavant, vous ne pouviez pas obtenir de données historiques de Jetstream ; vous deviez remplir vous-même les référentiels. Jetstream v2 corrige cela avec une nouvelle fonctionnalité Network Replay.

Voici comment cela fonctionne :

• Envoyez vos filtres en POST à planSnapshot pour obtenir un plan pour les données historiques.
• Téléchargez les segments scellés via HTTP simple.
• Connectez-vous au WebSocket en direct au point de bascule pour continuer en temps réel.

La relecture est sans état côté serveur : pas de curseur par consommateur, pas d'enregistrement d'abonnement, rien à préparer côté client. Vous pouvez aussi simplement prendre un instantané du réseau (copie à un moment donné) via HTTP uniquement, en utilisant listSegments et getSegment, sans flux en direct.

Cela permet une analyse côté serveur sur des données historiques sans remplissage local. Les cas d'utilisation incluent le démarrage d'une application, l'analyse d'un mois de messages ou la récupération après une panne.

Étant donné que le service d'archives est gourmand en bande passante, Bluesky exige désormais un jeton API pour les demandes d'archives. Le flux en direct reste ouvert et non authentifié. Aucun projet d'ajout d'authentification au flux en direct.

Les instances v2 sont maintenant en ligne :

wss://jetstream.us-west.bsky.network
wss://jetstream.us-east.bsky.network

Les instances v1 existantes continuent de fonctionner sans changement, et le flux en direct se comporte de manière identique, donc aucune précipitation pour migrer.

Nouveaux SDK Jetstream

Ils ont également publié des SDK Jetstream officiels pour TypeScript et Go. Voici l'exemple TypeScript tiré de la documentation :

import { Jetstream } from '@bsky/jetstream'
import { app } from '@bsky/sdk/lexicons'

const js = new Jetstream('https://jetstream.us-east.bsky.network')
for await (const evt of js.live({ collections: [app.bsky.feed.post] })) {
    if (evt.kind === 'commit' && evt.commit.operation === 'create') {
        console.log(evt.commit.collection, evt.commit.record.text)
    }
}

Le SDK TypeScript est sur npm ; le SDK Go fait partie du projet Jetstream.

SDK TypeScript de Bluesky rebasé sur lex

Le SDK TypeScript de Bluesky est reconstruit sur @atproto/lex, supprimant les chemins de code hérités. Il est entièrement typé de bout en bout, de la couche protocole jusqu'aux enregistrements app.bsky. Tous les nouveaux exemples de documentation l'utilisent. L'ancien @atproto/api fonctionne toujours, mais le nouveau SDK élimine les recommandations des LLM vers des versions obsolètes.

Mises à jour sur endpoints.bsky.app

La référence HTTP sur endpoints.bsky.app a été mise à jour. L'ancien docs.bsky.app est remplacé par le nouveau site Protocol Services.

Toute l'infrastructure est open source et auto-hébergeable.