이번 소식
TanStack이 한국시간 2026년 10월 13일 오전 8시 21분 공개한 릴리스에 React·Solid·Vue용 Start 패키지 1.169.0이 포함됐습니다. 서버 함수와 미들웨어에서 사용하던 inputValidator 메서드가 제거됐으며, 공식 릴리스는 이를 기존 코드의 수정이 필요한 호환성 변경(Breaking Changes)으로 분류했습니다.
달라진 점
createServerFn().inputValidator()와 createMiddleware().inputValidator()는 validator()와 같은 역할을 하는 사용 중단 예정 메서드였습니다. 이번 변경에서는 오래된 이름과 관련 타입을 제거했습니다.
공식 변경 안내의 전환 방법은 .inputValidator( 호출을 .validator(로 바꾸는 것입니다. 전달하는 인수와 자동으로 추론되는 타입은 같습니다. 옵션을 직접 읽는 코드의 options.inputValidator도 options.validator로 수정해야 합니다.
어떤 점이 달라지나요?
이 변경은 TanStack Start로 만든 애플리케이션에서 기존 메서드를 호출하는 개발자에게 해당합니다. 이미 validator()를 쓰는 부분은 이 제거에 따른 이름 변경이 필요하지 않지만, 오래된 호출을 남겨 둔 채 버전만 올려서는 안 됩니다.
공식 변경 안내는 남아 있는 inputValidator() 호출이 타입 검사에서 오류를 일으킨다고 설명합니다. 타입 검사를 거치지 않고 실행하면 해당 모듈을 불러올 때 TypeError가 발생한다고도 명시합니다. 업데이트 전에 서버 함수뿐 아니라 미들웨어와 옵션을 직접 읽는 부분까지 확인할 필요가 있습니다.
사용 전 확인할 점
사용 중인 코드에서 inputValidator 호출과 옵션 접근을 찾아 공식 안내에 따라 이름을 바꾸세요. 릴리스에는 여러 패키지가 함께 포함되며 버전 번호는 서로 다릅니다. React·Solid·Vue용 Start 패키지의 1.169.0 변경을 모든 Router 패키지의 같은 버전 변경으로 해석하지 않도록 확인하세요.
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.