PG Query SDK

PG Query SDK e uma biblioteca para trabalhar com PostgreSQL sem transformar o projeto num ORM pesado.

A ideia e simples: montar query com clareza, executar com seguranca e manter o resto da aplicacao limpo.

O que voce ganha

• query builder direto ao ponto
• build() para ver o SQL antes de executar
• transacoes com escopo proprio
• repositories com CRUD, pagina, hooks e soft delete
• suporte a migrations
• helpers para schema, functions e triggers
• SQL cru quando fizer mais sentido

Comece por aqui

• Documentacao
• Instalacao
• Primeiros passos
• Query Builder
• Transacoes
• Repositories
• Relacoes
• Migrations
• Schema e triggers
• SQL cru
• API
• Exemplos

Exemplo rapido

import { Database, PostgresDialect } from 'pg-query-sdk'

const db = new Database({
  connectionString: 'postgres://user:pass@localhost:5432/app_db',
  dialect: new PostgresDialect(),
})

const query = db
  .table('users')
  .select(['id', 'name', 'email'])
  .where({
    active: true,
    role: { op: 'IN', value: ['admin', 'manager'] },
  })
  .orderBy('name', 'ASC')
  .limit(10)

console.log(query.build()) 
// const rows = await query.execute()

Quando a lib ajuda mais

• quando voce quer enxergar o SQL de verdade
• quando precisa padronizar acesso ao banco em varios servicos
• quando o projeto ja cresceu e o acesso a dados ficou espalhado
• quando hooks, relacoes, trigger e migrations precisam ficar no mesmo lugar

Requisitos

• Node.js >=18
• pg como peer dependency

Licenca

MIT