TanStack DB 0.11.1, 변경 대기 상태 API 추가·조인 키 형식 변경

이번 소식

TanStack DB 0.11.1이 공개됐습니다. 화면 데이터를 동기화하는 개발 도구로, 이번 버전은 로컬 변경의 처리 상태를 확인하는 API를 추가하고 여러 데이터를 합친 결과의 키 충돌을 수정했습니다. 패치 버전이지만 일부 기존 코드의 점검이 필요합니다.

주요 변경

• tx.when('settled')로 트랜잭션 완료를 기다리고, $hasPendingWrites로 서버 반영 전에 화면에 먼저 적용한 로컬 변경이 남았는지 확인합니다. 기존 isPersisted.promise와 $synced는 사용 중단 권고 상태가 됐지만 아직 사용할 수 있습니다.
• collection.base로 로컬 임시 변경을 제외한 기준 데이터를 동기적으로 읽습니다. 이 읽기 자체가 데이터 동기화를 시작하지는 않습니다.
• 조인 결과의 키를 두 원본 키를 담은 JSON 배열 형식으로 바꿨습니다. 쉼표가 들어간 키나 숫자·문자열 키가 같은 값처럼 처리돼 행이 누락되는 문제를 막습니다.

영향 대상과 필요한 조치

이 도구를 쓰는 개발자는 조인 결과를 직접 만든 문자열 키로 조회하는 코드부터 새 형식과 대조해야 합니다. 새 완료 API도 변경 처리 함수가 끝나는 기준을 따르므로, 서버의 반영 확인이 필요하다면 그 함수에서 서버 응답까지 기다려야 합니다. 릴리스와 공식 변경 설명을 확인했으며 실제 앱 실행은 시험하지 않았습니다.

발표 시각(KST): 2026년 10월 2일 13:13:05 · 공식 GitHub 릴리스 게시 시각 기준

원문 출처 보기 →