Bluesky lança Protocol Services com docs e contratos claros
Bluesky Protocol Services
A Bluesky lançou o Bluesky Protocol Services, uma nova marca e site que organiza a infraestrutura pública que a empresa opera na rede AT Protocol. O objetivo é deixar claro para desenvolvedores quais serviços são mantidos pela Bluesky, quais são seus contratos de serviço e por onde começar, substituindo o antigo site docs.bsky.app.
Jetstream v2 e Network Replay
O principal lançamento é o Jetstream v2. O Jetstream é uma forma de consumir a rede em escala: o desenvolvedor descreve o recorte que deseja e recebe os dados como JSON via WebSocket. Até agora, porém, não havia acesso ao histórico da rede; para obter registros antigos era preciso fazer backfill manual dos repositórios antes de acompanhar o stream ao vivo.
A versão 2 adiciona um arquivo comprimido de toda a rede e um recurso chamado Network Replay. Ele permite recuperar dados de qualquer ponto no passado e depois alternar para o stream ao vivo sem lacunas. O fluxo envolve enviar filtros via POST para planSnapshot, baixar segmentos selados por HTTP simples e conectar o WebSocket quando alcançar o ponto atual. O processo é stateless no servidor: não há cursor por consumidor, assinatura registrada nem preparação no cliente.
Também é possível tirar apenas um snapshot da rede em um ponto no tempo, usando HTTP sem WebSocket. Isso permite análises sobre períodos de posts, recuperação após downtime e outros usos sem backfill local.
Como servir esses arquivos exige muita banda, a Bluesky agora exige token de API apenas para solicitações de arquivo histórico. O stream ao vivo continua aberto e sem autenticação, e não há plano de exigir autenticação para ele. As instâncias v2 estão ativas em wss://jetstream.us-west.bsky.network e wss://jetstream.us-east.bsky.network; as instâncias v1 continuarão funcionando por um tempo.
SDKs e documentação
A Bluesky também lançou SDKs do Jetstream em TypeScript e Go, cuidando de reconexão, deduplicação, gerenciamento de cursor e decodificação de eventos em tipos. O SDK TypeScript está disponível no npm, incluindo npmx; o SDK Go faz parte do projeto Jetstream.
O Bluesky TypeScript SDK foi reconstruído sobre @atproto/lex, abandonando caminhos legados de código da Bluesky. A mudança busca eliminar recomendações de SDKs deprecated, inclusive por LLMs. Código baseado em @atproto/api continua funcionando, e os guias da API servem como referência de migração.
Por fim, a referência HTTP em endpoints.bsky.app foi atualizada com os novos métodos network.bsky.jetstream.* e documentação dos endpoints WebSocket do Jetstream v2.