TanStack DB 0.9.0, subset 공개 API 제거·온디맨드 로딩 동작 변경

핵심 요약

TanStack DB 0.9.0이 공개됐습니다. 이번 버전은 온디맨드 로딩·정렬 페이지네이션·replay 동작을 정비하는 동시에 일부 공개 subset API를 제거하고, LoadSubsetOptions와 내부 요청 데이터를 제출 이후 불변으로 취급하도록 동작을 변경했습니다.

주요 변경

• 취소·실패·정리·재시작 과정에서도 온디맨드 로딩 결과와 ordered pagination, replay 상태가 일관되게 유지되도록 처리 로직이 개선됐습니다.
• isWhereSubset, unionWherePredicates, minusWherePredicates, isOrderBySubset, isLimitSubset, isOffsetLimitSubset, isPredicateSubset, isLoadSubsetRequestSubsumedBy 등 사용되지 않던 공개 subset-algebra 헬퍼가 제거됐습니다.
• LoadSubsetOptions와 중첩 요청 데이터는 제출 이후 불변으로 취급됩니다. 기존 요청의 Date·바이트 배열·membership 배열·옵션 객체를 직접 변경하는 대신 새 객체를 만들어야 합니다.
• Replay 재획득은 기존 물리 lease를 해제한 뒤 새 lease를 시작하는 순차 방식으로 바뀌어, 커스텀 어댑터는 release와 load 사이의 공백을 처리할 수 있어야 합니다.

개발자 영향

제거된 subset 헬퍼를 직접 import한 코드는 업데이트가 필요합니다. 일반적인 쿼리와 기본 어댑터는 해당 API 제거의 직접 영향이 없지만, LoadSubsetOptions를 제출 후 수정하거나 자체 어댑터에서 replay 자원 수명을 관리하는 프로젝트는 0.9.0 업그레이드 전에 동작을 점검하는 편이 좋습니다.

발표 시각(KST): 2026년 9월 11일 05:34

원문 출처 보기 →