@dbloomdb/cli

CLI do dbloom — gera DDL PostgreSQL (e mais 4 dialetos) a partir de specs declarativas, faz drift detection, reverse engineering, e expõe um servidor HTTP local que a UI consome.

Instalação

npm install -g @dbloomdb/cli
# ou
pnpm add -g @dbloomdb/cli

Comandos principais

dbloom generate <spec.yaml>            # gera SQL completo
dbloom validate <spec.yaml>            # valida sem gerar
dbloom migrate <prev.yaml> <curr.yaml> # gera ALTER baseado em diff
dbloom drift-sql <schema> <table>      # imprime query de introspecção
dbloom drift <spec.yaml> --json file   # compara spec vs banco

# Reverse engineering
dbloom import-from-db --profile <name> --schema <s>     # via conexão direta
dbloom import-from-db <introspection.json>              # via paste

# UI bridge
dbloom serve [--port 7474]             # HTTP server pra UI conectar

# Outros
dbloom profile <add|test|list|remove>  # profiles em ~/.dbloom/profiles.yaml
dbloom bronze <plan|apply|sync>        # translator de fontes ERP

Detalhes completos: dbloom help ou https://dbloom.mano.dev/help

Workflow típico

1. Configurar profile do banco-alvo (uma vez):

   read -srp "Senha: " DB_PWD && export DB_PWD
   dbloom profile add prod --type postgres --host db.exemplo.com --port 5432 \
     --database mydb --user app --password-ref env:DB_PWD
   dbloom profile test prod

2. Importar (gera *.dbloom.yaml):

   dbloom import-from-db --profile prod --schema public -p apex -o ./specs

3. Editar abrindo a pasta ./specs em https://dbloom.mano.dev/app (FS Access API).

4. Gerar SQL quando satisfeito:

   dbloom generate ./specs/public/country.dbloom.yaml -p apex -o country.sql

Dialetos suportados

PostgreSQL · MySQL · SQL Server · Oracle · SQLite — selecionável via -d ou -p vanilla-mysql etc.

Licença

MIT — ver LICENSE.