kysely-org/kysely

🛡️ Kysely: viết SQL bằng TypeScript mà IDE tự gợi ý tên bảng, tên cột, kiểu dữ liệu

Type-safe SQL query builder — query như Knex, nhưng kết quả có kiểu chính xác và autocomplete hoạt động trên cả schema phức tạp.

Kysely (phát âm "Key-Seh-Lee") là thư viện TypeScript giúp bạn xây dựng câu SQL qua API thay vì nối chuỗi thủ công, đồng thời suy luận kiểu kết quả ngay tại compile time. Dự án lấy cảm hứng từ Knex.js, chạy trên Node.js, Deno, Bun, Cloudflare Workers và cả trình duyệt. Với hơn 14k sao GitHub, đây là lựa chọn quen thuộc cho ai muốn giữ quyền kiểm soát SQL thuần mà vẫn có trải nghiệm TypeScript xịn.

✨ Điểm nổi bật

• Type-safe query builder: chỉ cho phép truy cập bảng/cột hợp lệ trong từng phần của query, sai tên cột là lỗi compile ngay.
• Autocompletion toàn diện: IDE gợi ý tên bảng, cột, alias và kiểu trả về dựa trên schema bạn khai báo.
• Infer từ subquery, join, CTE: tự suy luận tên cột, alias và kiểu từ select con, join con và with — kể cả alias kiểu pet.name as pet_name.
• Nhiều dialect: PostgreSQL, MySQL, MSSQL, SQLite, PGlite và cộng đồng đóng góp thêm (CockroachDB, PlanetScale, D1, LibSQL...).
• Escape hatch cho SQL động: cung cấp sql template tag và DynamicModule cho trường hợp TypeScript không gõ được tại compile time.
• Transaction API: hỗ trợ giao dịch với callback hoặc transaction() object, dễ lồng nhiều thao tác.
• Migration độc lập: module kysely-migrations riêng để quản lý schema migration mà không bắt buộc dùng ORM.
• Chạy đa môi trường: Node.js, Deno, Bun, Cloudflare Workers, web browsers — cùng một API.

💡 Vì sao đáng chú ý

Điểm khác biệt lớn nhất của Kysely so với query builder truyền thống (Knex, knex-style) là cấp độ suy luận kiểu. Bạn khai báo interface database một lần, từ đó mọi select, insert, update, join đều được kiểm tra tên bảng, tên cột, kiểu trả về — kể cả khi bạn dùng subquery, CTE hay alias phức tạp. Viết xong, refactor schema, TypeScript báo ngay chỗ vỡ.

Dự án phù hợp với team muốn giữ SQL thuần (không bị che bởi ORM), nhưng không chịu nổi cảnh any và typo tên cột. Khi cần tối ưu query thủ công, Kysely không cản đường — bạn vẫn nhúng raw SQL qua template tag khi cần. Đó là lý do nhiều dự án chọn Kysely thay vì Prisma/TypeORM khi kiểm soát SQL là ưu tiên hàng đầu.

#TypeScript #SQL #QueryBuilder #TypeSafe #TiniX