블루스카이 프로토콜 서비스: Jetstream v2 리플레이

블루스카이가 AT 프로토콜 네트워크에서 실행되는 공개 인프라를 위한 새 브랜드이자 웹사이트인 블루스카이 프로토콜 서비스를 출시했습니다. 주요 소식은 Jetstream v2로, HTTP를 통해 과거 네트워크 데이터를 가져온 다음 끊김 없이 실시간 WebSocket 스트림으로 전환할 수 있는 Network Replay 기능이 추가되었습니다.

Jetstream v2: 네트워크 리플레이

Jetstream은 WebSocket을 통해 AT 프로토콜 네트워크의 일부를 일반 JSON으로 구독할 수 있는 서비스입니다. 이전에는 Jetstream에서 과거 레코드를 가져올 수 없었고, 직접 리포지토리를 백필(backfill)해야 했습니다. Jetstream v2는 새로운 Network Replay 기능으로 이를 해결합니다.

작동 방식은 다음과 같습니다:

필터를 planSnapshot에 POST하여 과거 데이터 계획을 가져옵니다.
일반 HTTP를 통해 봉인된 세그먼트를 다운로드합니다.
팁(tip)에서 실시간 WebSocket에 연결하여 실시간으로 계속 수신합니다.

리플레이는 서버에서 상태 비저장(stateless)입니다: 소비자별 커서가 없고, 구독 등록도 없으며, 클라이언트 측 준비도 필요 없습니다. 또한 listSegments 및 getSegment를 사용하여 HTTP 전용으로 네트워크 스냅샷(특정 시점 복사)만 할 수도 있습니다.

이를 통해 로컬에서 백필하지 않고 과거 데이터에 대한 서버 측 분석이 가능합니다. 사용 사례로는 앱 구동, 한 달간의 게시물 분석, 다운타임 복구 등이 있습니다.

아카이브 제공은 대역폭 집약적이므로, 블루스카이는 이제 아카이브 요청에 API 토큰을 요구합니다. 라이브 테일은 계속 공개 및 무인증 상태로 유지됩니다. 라이브 스트림에 인증을 추가할 계획은 없습니다.

v2 인스턴스는 현재 사용 가능합니다:

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

기존 v1 인스턴스는 변경 없이 계속 실행되며, 라이브 테일은 동일하게 동작하므로 서둘러 마이그레이션할 필요가 없습니다.

새 Jetstream SDK

또한 TypeScript 및 Go용 공식 Jetstream SDK를 출시했습니다. 문서에 있는 TypeScript 예제입니다:

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

TypeScript SDK는 npm에 있으며, Go SDK는 Jetstream 프로젝트의 일부입니다.

lex 기반 블루스카이 TypeScript SDK 재건

블루스카이 TypeScript SDK는 @atproto/lex 기반으로 재구축되어 레거시 코드 경로를 제거했습니다. 프로토콜 레이어에서 app.bsky 레코드까지 종단 간 완전히 타입화되어 있습니다. 모든 새 문서 예제는 이를 사용합니다. 이전 @atproto/api도 여전히 작동하지만, 새 SDK는 더 이상 사용되지 않는 버전의 LLM 추천을 제거합니다.