Neon es un Postgres serverless totalmente gestionado. Neon separa cómputo y almacenamiento para ofrecer características modernas de desarrollador como autoescalado, ramificación, almacenamiento ilimitado y más.

---

Comienza creando un directorio de proyecto, inicializando el directorio usando bun init, y agregando el controlador serverless de Neon como una dependencia del proyecto.

mkdir bun-neon-postgres
cd bun-neon-postgres
bun init -y
bun add @neondatabase/serverless

---

Crea un archivo .env.local y agrega tu cadena de conexión de Neon Postgres.

DATABASE_URL=postgresql://usertitle:password@ep-adj-noun-guid.us-east-1.aws.neon.tech/neondb?sslmode=require

---

Pega el siguiente código en el archivo index.ts de tu proyecto.

import { neon } from "@neondatabase/serverless";

// Bun carga automáticamente DATABASE_URL desde .env.local
// Consulta: https://bun.com/docs/runtime/environment-variables para más información
const sql = neon(process.env.DATABASE_URL);

const rows = await sql`SELECT version()`;

console.log(rows[0].version);

---

Inicia el programa usando bun ./index.ts. La versión de Postgres debería imprimirse en la consola.

bun ./index.ts

PostgreSQL 16.2 on x86_64-pc-linux-gnu, compiled by gcc (Debian 10.2.1-6) 10.2.1 20210110, 64-bit

---

Este ejemplo usó la funcionalidad SQL-over-HTTP del controlador serverless de Neon. El controlador serverless de Neon también expone los constructores Client y Pool para habilitar sesiones, transacciones interactivas y compatibilidad con node-postgres.

Consulta la documentación de Neon para una visión completa del controlador serverless.