Bluesky Protocol Services: Jetstream v2 com Replay

A Bluesky lançou o Bluesky Protocol Services, uma nova marca e site para a infraestrutura pública que ela opera na rede AT Protocol. A grande novidade é o Jetstream v2, que adiciona o Network Replay — uma forma de obter dados históricos da rede via HTTP e depois mudar para o stream WebSocket ao vivo sem lacunas.

Jetstream v2: Network Replay

Jetstream é um serviço que permite assinar uma fatia da rede AT Protocol como JSON puro via WebSocket. Anteriormente, não era possível obter registros históricos do Jetstream; você tinha que preencher repositórios localmente. O Jetstream v2 corrige isso com um novo recurso de Network Replay.

Veja como funciona:

Faça POST dos seus filtros para planSnapshot para obter um plano de dados históricos.
Baixe os segmentos lacrados via HTTP simples.
Conecte-se ao WebSocket ao vivo uma vez no ponto final para continuar em tempo real.

O replay é sem estado no servidor: sem cursor por consumidor, sem registro de inscrição, nada para preparar no cliente. Você também pode apenas obter um snapshot da rede (cópia pontual) apenas via HTTP, usando listSegments e getSegment, sem live tail.

Isso permite análise no lado do servidor sobre dados históricos sem preencher localmente. Casos de uso incluem iniciar um App, rodar análise ao longo de um mês de posts ou se recuperar de inatividade.

Como servir arquivos consome muita banda, a Bluesky agora está exigindo um token de API para solicitações de arquivo. O live tail continua aberto e sem autenticação. Não há planos para adicionar autenticação ao stream ao vivo.

As instâncias v2 já estão ativas:

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

As instâncias v1 existentes continuam funcionando inalteradas, e o live tail se comporta de forma idêntica, então não há pressa para migrar.

Novos SDKs do Jetstream

Também lançaram SDKs oficiais do Jetstream para TypeScript e Go. Aqui está o exemplo em TypeScript da documentação:

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

O SDK TypeScript está no npm; o SDK Go faz parte do projeto Jetstream.

Bluesky TypeScript SDK Reconstruído em lex

O SDK TypeScript da Bluesky foi reconstruído sobre @atproto/lex, removendo caminhos de código legados. Ele é totalmente tipado de ponta a ponta, da camada de protocolo até os registros app.bsky. Todos os novos exemplos da documentação o usam. O antigo @atproto/api ainda funciona, mas o novo SDK elimina recomendações de LLM de versões desatualizadas.