Bluesky Protokoll-Dienste: Jetstream v2 mit Replay

Bluesky hat Bluesky Protocol Services gestartet, eine neue Marke und Website für die öffentliche Infrastruktur, die es im AT Protocol-Netzwerk betreibt. Die große Neuigkeit ist Jetstream v2, das Network Replay hinzufügt – eine Möglichkeit, historische Netzdaten über HTTP zu erhalten und dann ohne Lücke zum Live-WebSocket-Stream zu wechseln.

Jetstream v2: Network Replay

Jetstream ist ein Dienst, mit dem Sie einen Teil des AT Protocol-Netzwerks als einfaches JSON über WebSocket abonnieren können. Zuvor konnten Sie keine historischen Daten von Jetstream abrufen; Sie mussten Repos selbst befüllen. Jetstream v2 behebt dies mit der neuen Funktion Network Replay.

So funktioniert es:

Senden Sie Ihre Filter per POST an planSnapshot, um einen Plan für historische Daten zu erhalten.
Laden Sie die versiegelten Segmente über einfaches HTTP herunter.
Verbinden Sie sich an der Spitze mit dem Live-WebSocket, um in Echtzeit fortzufahren.

Das Replay ist serverlos: kein Cursor pro Verbraucher, keine Abonnementregistrierung, nichts für die Client-Seite. Sie können das Netzwerk auch nur über HTTP mit listSegments und getSegment und ohne Live-Tail erfassen.

Dies ermöglicht serverseitige Analysen über historische Daten ohne lokales Backfilling. Anwendungsfälle sind das Starten einer App, die Analyse eines Monats von Beiträgen oder die Wiederherstellung nach Ausfallzeiten.

Da das Bereitstellen von Archiven bandbreitenintensiv ist, verlangt Bluesky jetzt einen API-Token für Archivabrufe. Der Live-Tail bleibt offen und ohne Authentifizierung. Es gibt keine Pläne, Authentifizierung zum Live-Stream hinzuzufügen.

Die v2-Instanzen sind jetzt live:

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

Die bestehenden v1-Instanzen bleiben unverändert bestehen, und der Live-Tail verhält sich identisch, daher besteht keine Eile zu migrieren.

Neue Jetstream-SDKs

Außerdem wurden offizielle Jetstream-SDKs für TypeScript und Go veröffentlicht. Hier ist das TypeScript-Beispiel aus der Dokumentation:

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)
    }
}

Das TypeScript-SDK ist auf npm verfügbar; das Go-SDK ist Teil des Jetstream-Projekts.

Bluesky TypeScript SDK auf lex basiert

Das Bluesky TypeScript SDK wurde auf @atproto/lex neu aufgebaut, wodurch Legacy-Codepfade entfernt wurden. Es ist durchgängig typisiert, von der Protokollebene bis zu den app.bsky-Datensätzen. Alle neuen Dokumentationsbeispiele verwenden es. Das alte @atproto/api funktioniert weiterhin, aber das neue SDK macht LLM-Empfehlungen für veraltete Versionen überflüssig.