Servicios del Protocolo Bluesky: Jetstream v2 con Reproducción de Red

Bluesky lanzó Bluesky Protocol Services, una nueva marca y sitio web para la infraestructura pública que ejecuta en la red AT Protocol. La gran noticia es Jetstream v2, que añade Network Replay — una forma de obtener datos históricos de la red a través de HTTP y luego cambiar al stream WebSocket en vivo sin interrupciones.

Jetstream v2: Network Replay

Jetstream es un servicio que te permite suscribirte a una parte de la red AT Protocol como JSON simple a través de WebSocket. Anteriormente, no podías obtener registros históricos de Jetstream; tenías que hacer backfill de los repos tú mismo. Jetstream v2 soluciona eso con la nueva función Network Replay.

Así es como funciona:

• Envía tus filtros a planSnapshot para obtener un plan de datos históricos.
• Descarga los segmentos sellados a través de HTTP simple.
• Conéctate al WebSocket en vivo una vez que estés al día para continuar en tiempo real.

La reproducción es stateless en el servidor: sin cursor por consumidor, sin registro de suscripción, sin nada que preparar en el cliente. También puedes simplemente tomar una instantánea de la red (copia puntual) solo a través de HTTP, usando listSegments y getSegment, sin cola en vivo.

Esto permite análisis del lado del servidor sobre datos históricos sin necesidad de backfill local. Algunos casos de uso incluyen poner en marcha una aplicación, realizar análisis de un mes de publicaciones o recuperarse de un tiempo de inactividad.

Debido a que servir archivos consume mucho ancho de banda, Bluesky ahora requiere un token de API para solicitudes de archivo. La cola en vivo permanece abierta y sin autenticación. No hay planes de añadir autenticación al stream en vivo.

Las instancias v2 ya están activas:

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

Las instancias v1 existentes continúan funcionando sin cambios, y la cola en vivo se comporta de manera idéntica, así que no hay prisa por migrar.

Nuevos SDKs de Jetstream

También lanzaron SDKs oficiales de Jetstream para TypeScript y Go. Aquí está el ejemplo de TypeScript de la documentación:

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

El SDK de TypeScript está en npm; el SDK de Go es parte del proyecto Jetstream.

El SDK de TypeScript de Bluesky se basa en lex

El SDK de TypeScript de Bluesky se reconstruyó sobre @atproto/lex, eliminando rutas de código heredadas. Está completamente tipado de extremo a extremo, desde la capa de protocolo hasta los registros app.bsky. Todos los ejemplos de la nueva documentación lo utilizan. El antiguo @atproto/api sigue funcionando, pero el nuevo SDK elimina las recomendaciones de LLM de versiones obsoletas.

Actualizaciones en endpoints.bsky.app

La referencia HTTP en endpoints.bsky.app ha sido actualizada. El antiguo docs.bsky.app es reemplazado por el nuevo sitio de Protocol Services.

Toda la infraestructura es de código abierto y se puede autoalojar.