colinhacks/reylo

어떤 프로젝트인가요?

핵심 기능

• 01.sql 파일을 타입이 지정된 호출 가능한 쿼리 함수로 가져옵니다.
• 02개발 데이터베이스에서 SQL을 실행해 행과 매개변수의 타입을 도출합니다.
• 03SQL 오류를 tsc와 에디터에서 TypeScript 오류로 표시합니다.
• 04null 허용 여부, 결과 행 수, enum 유니온 타입을 추론합니다.
• 05Postgres, MySQL, SQLite를 지원하며 원하는 드라이버를 사용할 수 있습니다.

활용 사례

• 변경되는 데이터베이스 스키마에 맞춰 TypeScript 행 타입을 동기화할 때.
• ORM 없이 타입 안전성을 유지하면서 세밀하게 직접 작성한 SQL을 사용할 때.
• 코딩 에이전트가 쿼리를 변경할 때 타입 검사기로 오래된 호출부를 찾아내고 싶을 때.

빠른 시작

1. 1

   Reylo를 설치하세요

   npm install reylo
2. 2

   데이터베이스용 엔진(Postgres, MySQL 또는 SQLite)을 설치하세요

   npm install -D @reylosql/postgres
3. 3

   개발 데이터베이스를 가리키도록 .env에서 DATABASE_URL을 설정하세요

4. 4

   Node에서 Reylo를 로드해 코드를 실행하세요

   node --env-file=.env --import reylo/register main.ts

사용 전 알아둘 점

• !현재 베타 버전인 TypeScript 7.1이 필요합니다.
• !Node 24 이상과 실행 중인 개발 데이터베이스가 필요합니다.
• !타입 검사에는 tsc가 콘텐츠 매퍼를 실행할 수 있도록 --runExternalCode 플래그가 필요합니다.

Repolode 주간에 소개됨

• 제 2호 · 에이전트용 Rust 헤드리스 브라우저와 타입이 붙는 SQL 임포트

  TypeScript에서 .sql 파일을 import하면 타입이 붙은 쿼리 함수가 됩니다. 행과 파라미터 타입은 개발 DB 기준으로 추론되고, SQL 오류는 tsc 에러로 표시되며 코드 생성 단계가 없습니다.

포함된 컬렉션

토픽

자주 묻는 질문

reylo은(는) 무엇인가요?

코드 생성 단계 없이 .sql 파일을 TypeScript로 가져오고, 개발 데이터베이스에서 검증해 완전한 타입 추론을 제공합니다. Reylo를 사용하면 .sql 파일의 SQL 쿼리를 TypeScript로 가져와 함수처럼 호출할 수 있습니다. 개발 데이터베이스에서 쿼리를 준비해 SQL 자체로부터 결과 행과 매개변수의 타입을 도출하므로, 행 타입을 직접 작성하거나 동기화할 생성 파일을 관리할 필요가 없습니다.

reylo은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

reylo은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

reylo은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. reylo의 마지막 커밋은 2026년 11월 6일입니다.

reylo은(는) 어디에 사용할 수 있나요?

변경되는 데이터베이스 스키마에 맞춰 TypeScript 행 타입을 동기화할 때. ORM 없이 타입 안전성을 유지하면서 세밀하게 직접 작성한 SQL을 사용할 때. 코딩 에이전트가 쿼리를 변경할 때 타입 검사기로 오래된 호출부를 찾아내고 싶을 때.

reylo는 어떻게 설치하나요?

Reylo를 설치하세요: npm install reylo 데이터베이스용 엔진(Postgres, MySQL 또는 SQLite)을 설치하세요: npm install -D @reylosql/postgres 개발 데이터베이스를 가리키도록 .env에서 DATABASE_URL을 설정하세요 Node에서 Reylo를 로드해 코드를 실행하세요: node --env-file=.env --import reylo/register main.ts

reylo은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/colinhacks/reylo