블루스카이, 개발자용 인프라 브랜드 '프로토콜 서비스' 출범… 제트스트림 v2 공개

블루스카이(Bluesky)가 자사가 운영하는 공개 인프라를 하나의 브랜드로 묶은 '블루스카이 프로토콜 서비스(Bluesky Protocol Services)'를 새로 선보였다. 블루스카이는 이용자에게 익숙한 SNS 앱 이외에도 AT 프로토콜(atproto) 네트워크 위에서 여러 서비스를 직접 돌려 왔다. 제트스트림(Jetstream) 인스턴스, 릴레이(relay), 그리고 atproto 기반의 블루스카이 API 엔드포인트가 그것이다. 문제는 이 인프라 위에서 무언가를 만들려는 개발자 입장에서 어디까지가 블루스카이가 서비스로 제공하는 영역이고 어디서 시작해야 하는지 문서만으로는 구분하기 어려웠다는 점이다. 이번 개편은 흩어져 있던 문서를 한곳에 모으고, 블루스카이가 보증하는 서비스 계약(service contract)의 범위를 명확히 하며, 기존 docs.bsky.app 사이트를 대체하는 것이 골자다.

제트스트림 v2와 네트워크 리플레이

이번 발표에서 가장 눈에 띄는 것은 제트스트림 v2다. 제트스트림은 원하는 데이터 범위를 지정하면 웹소켓(WebSocket)을 통해 평범한 JSON 형태로 이벤트를 받아 볼 수 있는 서비스로, 대규모로 네트워크를 다루려는 개발자에게 사실상 표준 진입점 역할을 해 왔다. 다만 한계가 있었다. 실시간 스트림(live tail)만 제공했기 때문에 네트워크에 이미 존재하던 과거 레코드가 필요하면 개발자가 직접 저장소(repo)를 백필(backfill)한 뒤 실시간 스트림으로 갈아타야 했다.

v2는 이 과거 데이터 처리 기능을 서버 쪽으로 옮겼다. 네트워크 전체를 압축한 아카이브를 서버가 보관하고, 이를 소비하는 새로운 방식인 '네트워크 리플레이(Network Replay)'를 추가했다. 사용자는 원하는 필터를 planSnapshot에 POST로 전달하고, 반환된 봉인 세그먼트를 일반 HTTP로 내려받은 다음, 마지막 시점에서 실시간 웹소켓에 한 번만 연결하면 과거부터 현재까지 끊김 없이 이어받을 수 있다. 이 과정은 서버 입장에서 상태를 갖지 않는(stateless) 구조로, 소비자별 커서나 별도 구독 등록, 클라이언트 단의 준비 작업이 필요 없다. 실시간 스트림을 붙이지 않고 특정 시점의 아카이브 복사본만 HTTP로 받아 오는 '스냅숏' 방식(listSegments·getSegment)도 지원한다.

인증 토큰과 실시간 스트림 정책

실무적으로 의미 있는 변화는 이 아카이브 요청에 API 토큰이 필요해졌다는 점이다. 아카이브 제공은 대역폭을 많이 소모하는 작업이라 서비스의 안정성과 운영 비용을 관리하기 위한 조치라는 설명이다. 다만 실시간 스트림은 여전히 인증 없이 개방된 상태로 유지되며, 블루스카이는 실시간 스트림에 인증 요건을 도입할 계획이 없다고 밝혔다. 이 구분은 무료로 실시간 데이터를 소비하던 기존 앱에는 영향이 없지만, 과거 데이터를 대량으로 끌어와 분석하거나 다운타임에서 복구하려는 서비스는 토큰 발급을 전제로 설계를 잡아야 한다는 뜻이다.

v2 인스턴스는 wss://jetstream.us-west.bsky.network와 wss://jetstream.us-east.bsky.network에서 이미 가동 중이다. 기존 v1 인스턴스도 당분간 그대로 유지되고 실시간 스트림 동작은 두 버전이 동일하기 때문에 서둘러 옮길 이유는 없다. 인프라는 종전과 마찬가지로 오픈소스이며 직접 호스팅도 가능하다.

SDK 정비와 기술 부채 청산

제트스트림은 평범한 JSON을 다루므로 원칙적으로 SDK가 필요 없지만, 재연결·중복 제거·커서 관리·이벤트 디코딩 같은 반복 작업은 공통적으로 발생한다. 블루스카이는 이를 처리해 주는 타입스크립트와 Go용 제트스트림 SDK를 새로 내놨다. 필터를 넘긴 제트스트림 객체를 만들고 디코딩된 타입 이벤트를 순회하는 방식으로, 타입스크립트 SDK는 npm에서, Go SDK는 제트스트림 프로젝트의 일부로 제공된다.

블루스카이 타입스크립트 SDK 자체도 지난 5월 안정 프리뷰로 승격된 lex SDK, 즉 @atproto/lex 위에서 재구축됐다. 이로써 블루스카이 전용 헬퍼를 위한 레거시 코드 경로를 더 이상 유지하지 않게 됐고, 프로토콜 계층부터 app.bsky 레코드까지 처음부터 끝까지 타입이 붙는다. 새 사이트의 모든 타입스크립트 예제가 이 SDK 기준으로 작성됐는데, 블루스카이는 이것이 자사의 코드 위생 개선일 뿐 아니라 대형 언어 모델(LLM)이 이미 폐기된 SDK를 추천하는 문제를 줄이는 효과도 있다고 설명했다. 기존 @atproto/api 코드는 그대로 동작하며, 블루스카이 API 가이드가 이전(migration) 참고 자료 역할을 한다.

HTTP 레퍼런스도 함께 갱신됐다. 리플레이를 구동하는 network.bsky.jetstream.* 메서드인 planBackfill, listSegments, getSegment, getBlock의 요청·응답 스키마를 열람할 수 있고, 제트스트림의 웹소켓 엔드포인트 문서까지 한곳에 모여 v2의 전체 표면을 한 자리에서 확인할 수 있다. 새 사이트, v2 인스턴스, SDK 프리뷰, 갱신된 레퍼런스는 모두 현재 이용 가능하며, 네트워크를 처음 접하는 개발자를 위한 시각적 안내(How It Works)도 제공된다. 정리하자면 이번 개편은 새 기능 발표라기보다, 그동안 블루스카이가 서비스로 제공해 온 범위를 명시하고 백필 부담을 서버로 옮겨 진입 장벽을 낮춘 인프라 정돈 작업에 가깝다.