Forge injects window.db into your HTML as it's served. Reads come from a snapshot embedded at request time (instant, no round trip). Writes go straight to the D1 database.

// list tables
db.tables()                         // ["users", "posts"]

// read rows — each row includes an `id`
db.all('users')                    // [{id:'r1', name:'Ada', age:36}, …]
db.find('users', r => r.age > 30)
db.get('users', 'r1')

// write — persists to D1, visible in the Database tab
db.insert('users', {name:'Grace', age:45})
db.update('users', 'r1', {age:37})
db.remove('users', 'r1')

// pull fresh data without a page reload
await db.refresh()