Bunny.net rilascia il client ufficiale per Bunny Database basato su fetch

Bunny.net ha pubblicato il 2 settembre 2026 sul proprio blog ufficiale una nuova libreria per interrogare Bunny Database, il servizio di database compatibile SQLite lanciato dal provider in anteprima pubblica a febbraio. Il pacchetto si chiama @bunny.net/database-client e punta a un pubblico preciso: chi scrive codice per Bunny Edge Scripting, ma anche chi usa Deno, Bun o Node senza voler aggiungere dipendenze runtime.

La caratteristica tecnica che distingue la libreria dal resto dell'offerta sul mercato è semplice da verificare: si distribuisce globalmente, si interroga via HTTP e scala le letture con bassa latenza, e il client stesso si appoggia solo a fetch, senza librerie esterne da installare o aggiornare.

Come si usa

Chiamando connect() senza argomenti, il client legge le variabili BUNNY_DATABASE_URL e BUNNY_DATABASE_AUTH_TOKEN già impostate da bunny db link e da Edge Scripting. Le query passano per prepare().bind().all() o .first(), mentre le scritture usano run(), che restituisce metadati come rowsAffected e lastInsertRowid. Per le transazioni in un'unica chiamata HTTP c'è batch(): se uno degli statement fallisce, l'intera transazione va in rollback e il metodo rilancia l'errore dello statement che ha fallito, senza lasciare stati parziali. Per lo schema iniziale resta exec(), pensato per script multi-statement senza parametri né righe restituite; per schemi destinati a cambiare nel tempo, la documentazione rimanda ai comandi bunny db migrations create, apply e list, ancora etichettati come sperimentali.

Sul fronte errori, ogni eccezione arriva come DatabaseError con il codice SQLite originale allegato (per esempio SQLITE_CONSTRAINT), evitando il confronto di stringhe sui messaggi; anche i fallimenti di rete prima dell'esecuzione della query vengono incapsulati con codici NETWORK, TIMEOUT e ABORTED.

Sicurezza del token

Bunny.net ribadisce che il client va usato solo lato server: il token del database autorizza l'intera connessione, non la singola query, quindi non va mai esposto nel browser. Per limitare i danni in caso di fuga, la CLI permette di creare token con permessi ristretti, ad esempio bunny db tokens create --read-only --expiry 30d.

Esempi funzionanti sono disponibili per Bun, Node, Hono, Edge Scripting, Next.js, Astro e SvelteKit. Il pacchetto si installa con npm install @bunny.net/database-client, pnpm o bun add equivalenti; progetto aperto a contributi su GitHub e discussione su Discord, secondo quanto riportato nel blog di Bunny.net.