Home World News Show HN: Bun-sqlgen – Type-safe raw SQL for Bun, no ORM
World News

Show HN: Bun-sqlgen – Type-safe raw SQL for Bun, no ORM

Key Points

Type-safe SQL for Bun, no ORM — raw Bun.sql , live-checked against your schema. Tag a query with a name — sql. GetUser`...` — and its fully-typed, null-safe row appears right at the call site: no ORM, no generics, no hand-written types.

Type-safe SQL for Bun, no ORM — raw Bun.sql , live-checked against your schema. Tag a query with a name — sql.GetUser`...` — and its fully-typed, null-safe row appears right at the call site: no ORM, no generics, no hand-written types. Codegen plans every query against a real Postgres or SQLite database (no Docker needed), so wrong columns and bad SQL fail the build, not production — fast enough to rerun on every save. The runtime stays 100% Bun-native. Published as @ilbertt/bun-sqlgen — its README is the full guide: both dialects, nullability overrides, transactions, and configuration. bun add @ilbertt/bun-sqlgen - Migrations are the source of truth for your schema — put them in any folder: -- db/migrations/0001_init.sql CREATE TABLE users ( id bigint PRIMARY KEY GENERATED ALWAYS AS IDENTITY, email text NOT NULL, display_name text ); - Wrap your client with withTypes and tag each query with its name:import { withTypes } from '@ilbertt/bun-sqlgen'; import { SQL } from 'bun'; const sql = withTypes(new SQL(Bun.env.DATABASE_URL!)); export async function getUser(id: number) { const [user] = await sql.GetUser` SELECT id, email, display_name FROM users WHERE id = ${id} `; return user; // typed { id: string; email: string; display_name: string | null } } - Generate the types: bun bun-sqlgen generate 'src/**/*.ts' --migrations db/migrations This writes src/queries.gen.d.ts — commit it. With it in place,user.emial is a compile error anduser.display_name.length is flagged as possibly-null, all by plaintsc . Runnable projects live in the examples/ folder. Development setup and conventions are in CONTRIBUTING.md.
SQL (ORG) Bun (ORG) Bun.sql (ORG) GetUser (PERSON) Codegen (ORG) Docker (PERSON) @ilbertt (ORG)
Originally published by Hacker News Read original →