TanStack DB main, 복합 조인·개발용 컬렉션 설정 진단 추가

이번 소식

TanStack DB main 브랜치에 여러 동등 비교를 and()로 묶는 복합 조인과 개발 환경용 컬렉션 설정 진단이 병합됐습니다. 두 변경 모두 개발 브랜치 반영 단계이며 정식 릴리스 제공으로 확인된 상태는 아닙니다.

달라진 점

• 여러 필드로 조인: and(eq(…), eq(…)) 형태로 조건을 묶어 inner·left·right·full 조인에 사용할 수 있습니다. 가상 예시로 지역과 SKU가 모두 같은 항목을 연결하는 경우입니다. null·undefined가 포함된 키는 서로 일치하지 않습니다.
• 저수준 API 변경: 기존 단일 동등 비교 builder 문법은 유지됩니다. 다만 JoinClause를 직접 구성하는 코드는 left·right 필드 대신 on 조건식을 사용하도록 변경해야 합니다.
• 설정 오류 조기 안내: 함께 병합된 개발용 진단은 잘못된 createCollection 옵션을 알리고 oninsert 같은 오타에 올바른 이름을 제안합니다.

개발자가 확인할 점

지연 로딩에서는 복합 조건의 첫 동등 비교가 후보 데이터 로딩과 인덱스 선택에 쓰입니다. 공식 가이드에 따라 후보를 잘 좁히는 일반 필드 비교를 먼저 배치하고, 저수준 조인 코드를 쓴다면 구조 변경을 확인하세요. 이번 소식에서는 패키지 실행과 질의 결과를 직접 재현하지 않았습니다.

공식 출처·변경 시점

변경 시각(KST): 설정 진단 PR #1278은 2026년 10월 6일 06:46:01, 복합 조인 PR #861은 06:50:10에 main으로 병합됐습니다. 정식 출시 시각은 아닙니다.