원문 캡처 · wasp.sh
원문 캡처 · wasp.sh

Wasp 0.26은 작업 트리마다 사용 가능한 포트를 자동으로 찾아 여러 Wasp 앱을 한 컴퓨터에서 동시에 실행할 수 있게 한다. 인증 기본값을 개선하고 앱 구성과 빌드 정보를 확인하는 wasp show 명령도 추가했다.

wasp start는 기본 포트인 3000, 3001부터, wasp start db는 5432부터 사용 가능한 포트를 찾는다. 데이터베이스 포트도 앱이 찾아 연결하므로 작업 트리마다 별도의 개발 데이터베이스를 실행할 수 있다. 고정 포트가 필요하면 --client-port, --server-port, --db-port를 지정하면 된다. 새 작업 트리에서는 wasp install을 실행하고 .env 파일을 복사하되, .env.server의 DATABASE_URL은 제외해야 별도 개발 데이터베이스를 사용한다. 데이터베이스와 앱은 각각 다른 터미널에서 시작한다.

Wasp가 개발 포트와 URL을 관리하므로 .env.server의 WASP_SERVER_URL 또는 WASP_WEB_CLIENT_URL, .env.client의 REACT_APP_API_URL, vite.config.ts의 server.port를 직접 설정하면 오류가 발생한다. 변경 사항은 0.26 마이그레이션 안내에서 확인할 수 있다. 업그레이드 명령은 npm i -g @wasp.sh/wasp-cli@latest다.

wasp show spec은 페이지, 경로, 엔티티, 액션, 쿼리, API, CRUD, 작업 등 Wasp가 인식한 앱 구성을 출력한다. wasp show build는 마지막 빌드 정보를 보여준다. 두 명령은 프로젝트 폴더에서 실행하며, --json을 추가하면 구조화된 형식으로 출력한다. 기존 wasp info를 사용하던 코드는 wasp show build --json으로 바꾸고 lastCompile.waspVersion에서 값을 읽어야 한다. 자세한 내용은 CLI 참조 문서에 있다.

인증에서는 비밀번호를 재설정하면 모든 기기에서 로그아웃되고, 새 비밀번호를 확인하기 전에 재설정 토큰을 검증한다. 인증 이메일 재전송 제한은 마지막 인증 이메일 발송 시각을 기준으로 계산한다. 국제화된 주소와 대문자 이메일 주소 처리도 개선했으며, 지원되는 모든 가입 방식에서 onBeforeSignup이 userSignupFields보다 먼저 실행된다. 이 변경은 기본 적용되지만, 이메일 입력 요소의 유형이 type="text"로 바뀌므로 관련 E2E 테스트에서는 input[type="email"] 대신 input[name="email"]을 선택해야 할 수 있다. 자세한 내용은 인증 문서를 참고하면 된다.

문서 탐색 구조는 11개 상위 섹션에서 6개 섹션으로 개편됐다. 기존 링크는 계속 작동하고 이동한 페이지는 새 위치로 연결된다. llms.txt 파일도 새 구조를 따른다.

0.26에서는 컴파일 때 TypeScript 오류를 검사하므로 wasp compile, wasp start, wasp build가 오류가 있으면 중단한다. tsconfig.src.json을 업데이트해야 하고, 사용자 지정 Dockerfile은 생성된 types 디렉터리를 복사해야 한다. 배포 서버에는 PORT 환경 변수가 필요하며, 서버 상태 확인 경로는 GET /에서 GET /up으로 바뀌었다. Fly 배포 데이터베이스 옵션은 --db- 접두사로 시작하고, 최소 버전은 Fly CLI 0.4.82와 Railway CLI 5.28.0이다. 그 밖의 변경과 전체 안내는 마이그레이션 문서와 GitHub 릴리스 노트에서 확인할 수 있다.