herdux-cli 0.1.1

package/README.pt-BR.md

@@ -0,0 +1,369 @@
+🇧🇷 Português | 🇺🇸 [English](./README.md)
+
+# Herdux — Database Workflow CLI
+
+<p align="center">
+  <strong>Infrastructure-grade power. Developer-grade experience.</strong>
+</p>
+
+Uma CLI rápida e interativa que remove a fricção dos workflows diários com bancos de dados locais, especialmente ao lidar com múltiplas instâncias e grandes datasets.
+
+![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Node](https://img.shields.io/badge/node-18%2B-43853d.svg)
+
+> Otimizado para ambientes locais e de desenvolvimento. O uso em produção é suportado com configuração explícita.
+
+<p align="center">
+  <img src=".github/herdux.gif" alt="herdux terminal gif" width="1220" />
+</p>
+
+---
+
+## ⚡ Início Rápido
+
+```bash
+npm install -g herdux-cli
+herdux doctor
+herdux list
+```
+
+É só isso. Você já está gerenciando bancos de dados.
+
+---
+
+## Por que Herdux?
+
+Gerenciar bancos de dados locais através de scripts bash ou binários crus é repetitivo, propenso a erros e doloroso em escala.
+
+### ❌ Sem Herdux
+
+```bash
+# Fazer backup de um banco
+pg_dump -U postgres -h localhost -p 5416 -Fc -f ./backups/mydb_2026-02-23.dump mydb
+
+# Depois dropar manualmente
+psql -U postgres -h localhost -p 5416 -c "DROP DATABASE mydb;"
+
+# Restaurar do backup
+pg_restore -U postgres -h localhost -p 5416 -d mydb --clean --if-exists ./backups/mydb_2026-02-23.dump
+
+# Verificar se as ferramentas estão instaladas
+psql --version && pg_dump --version && pg_restore --version
+```
+
+### ✅ Com Herdux
+
+```bash
+herdux backup mydb --drop --yes        # Backup + drop em um comando
+herdux restore ./backups/mydb.dump --db mydb   # Cria o banco (se faltar) e detecta o formato
+herdux clean                            # Multi-seleção e batch-drop de bancos
+herdux doctor                           # Verificação completa do sistema
+```
+
+Menos flags. Menos erros. Zero fadiga de terminal.
+
+---
+
+## 🎯 Para quem é o Herdux?
+
+O **Herdux** foi construído *por desenvolvedores, para desenvolvedores*. 
+
+Ele nasceu da frustração diária de ter que constantemente restaurar backups para testar um estado específico, dropar bancos corrompidos durante o desenvolvimento e lidar com binários crus de bancos de dados toda hora.
+
+Ele é especificamente projetado para desenvolvedores que:
+- Gerenciam infraestruturas locais e precisam verificar o tamanho dos discos antes de popular novos bancos.
+- Querem clonar, popular (seed) e resetar bancos de dados rapidamente sem precisar ler documentações complexas.
+- Precisam de fluxos seguros de backup & restore que não dependam de scripts bash frágeis.
+- Preferem ferramentas focadas no terminal (terminal-first).
+- Querem resolução previsível de conexões sem mágicas ocultas.
+
+Se você gerencia bancos de dados localmente e compartilha dessa dor, o Herdux foi criado para você.
+
+---
+
+## 🚀 Funcionalidades Principais
+
+- **📋 Listagem Inteligente** — Estratégia otimizada para clusters massivos. Flag opcional `--size` para análise de uso de disco, ordenado do maior para o menor.
+- **💾 Backup & Restore Inteligente** — Suporta formatos Custom (`.dump`) e Plain (`.sql`). Detecta automaticamente a ferramenta correta para restauração.
+- **🧹 Limpeza em Massa** — Multi-seleção de bancos, backup opcional e batch-drop. Recupere espaço em disco instantaneamente.
+- **🩺 Diagnóstico do Sistema** — Verificação completa de saúde com um único comando: binários, autenticação e conectividade.
+- **⚙️ Perfis Persistentes** — Salve configurações de servidor nomeadas. Alterne entre ambientes com `-s pg16`.
+- **🎯 Resolução Inteligente de Conexão** — Flags CLI explícitas → perfis → padrões salvos → auto-descoberta. Sempre previsível.
+
+---
+
+## 💡 Filosofia
+
+**Herdux** combina *herd* (manada/rebanho) e *UX* — entregando uma melhor Developer Experience ao gerenciar seus clusters de bancos de dados. O nome reflete nosso foco em melhorar a experiência de desenvolvimento ao gerenciar "manadas" de bancos.
+
+O **Herdux** segue três princípios:
+
+- **Segurança primeiro** — Nunca apaga dados sem confirmação explícita ou um backup verificado.
+- **Explícito sobre implícito** — A resolução de conexão segue uma prioridade estrita e documentada. Sem mágica.
+- **Otimização de workflow** — Cada comando é projetado para te salvar de tarefas repetitivas no terminal.
+
+---
+
+## 🔒 Segurança
+
+O **Herdux** trata operações destrutivas com cuidado:
+
+- **Nunca dropa um banco** sem confirmação explícita
+- **Aborta toda a operação** se um backup de segurança falhar durante o `herdux clean`
+- **Valida códigos de saída do `pg_dump`** antes de considerar um backup bem-sucedido
+- **Requer a flag `--drop`** intencionalmente — dropar nunca é o padrão
+- **`--yes` deve ser combinado com `--drop`** — não é possível pular confirmação sozinho
+
+> Se você solicitar um backup antes de dropar e esse backup falhar, o **Herdux** para imediatamente. Nenhum dado é perdido.
+
+---
+
+## 🧩 Requisitos
+
+- **Node.js** 18 ou superior
+- **Ferramentas cliente PostgreSQL** (`psql`, `pg_dump`, `pg_restore`) instaladas e disponíveis no `PATH`
+
+> [!TIP]
+> Execute `herdux doctor` após a instalação para verificar se tudo está configurado corretamente.
+
+---
+
+## 📦 Instalação
+
+**npm (recomendado):**
+
+```bash
+npm install -g herdux-cli
+```
+
+**Pelo código-fonte:**
+
+```bash
+git clone https://github.com/herdux/herdux.git
+cd herdux
+npm install
+npm run build
+npm link
+```
+
+---
+
+## 🛠️ Comandos
+
+### `herdux version`
+
+Mostra a versão da CLI e a versão do servidor PostgreSQL conectado.
+
+```bash
+herdux version
+```
+
+### `herdux doctor`
+
+Executa uma verificação completa de saúde do sistema:
+
+- Verifica se `psql`, `pg_dump` e `pg_restore` estão instalados e acessíveis
+- Tenta uma conexão real usando a configuração resolvida
+- Testa autenticação contra o servidor alvo
+
+```bash
+herdux doctor
+```
+
+---
+
+### 📋 `herdux list`
+
+Lista todos os bancos de dados no servidor conectado.
+
+```bash
+herdux list              # Listagem rápida (nome, owner, encoding)
+herdux ls --size         # Inclui tamanho em disco, ordenado do maior → menor
+```
+
+> [!NOTE]
+> A flag `--size` calcula o uso físico de disco via `pg_database_size()`. Em servidores com dezenas de bancos multi-GB, isso pode levar alguns minutos dependendo da velocidade do disco.
+
+---
+
+### `herdux create <nome>`
+
+Cria um novo banco de dados.
+
+```bash
+herdux create meu_novo_db
+```
+
+### `herdux drop <nome>`
+
+Remove um banco de dados com confirmação interativa.
+
+```bash
+herdux drop meu_banco_antigo
+```
+
+---
+
+### 🧹 `herdux clean` — Limpeza em Massa
+
+Trabalhando com bancos de desenvolvimento cheios de seeds? Precisa recuperar espaço em disco rápido?
+
+`herdux clean` permite:
+
+- **Multi-seleção** de bancos a partir de uma interface interativa com checkboxes
+- **Gerar backups de segurança opcionais** antes de qualquer ação destrutiva
+- **Batch-drop** de todos os bancos selecionados com segurança
+- **Abortar imediatamente** se qualquer backup falhar, prevenindo perda de dados
+
+```bash
+herdux clean
+```
+
+Projetado para o workflow real do desenvolvedor: clonar bancos, experimentar, depois limpar tudo de uma vez.
+
+---
+
+### 📦 `herdux backup <banco>`
+
+Gera um backup com timestamp em `./backups/`.
+
+```bash
+herdux backup mydb                       # Formato custom (.dump)
+herdux backup mydb --format plain        # SQL puro (.sql)
+herdux backup mydb --drop                # Backup, depois pergunta se quer dropar
+herdux backup mydb --drop --yes          # Backup + drop, sem perguntas
+herdux backup mydb -o ./meus-backups     # Diretório de saída personalizado
+```
+
+| Opção | Descrição |
+|---|---|
+| `-F, --format <tipo>` | `custom` (padrão, comprimido) ou `plain` (SQL puro) |
+| `-d, --drop` | Pergunta se deseja dropar o banco após backup bem-sucedido |
+| `-y, --yes` | Pula confirmação do drop (requer `--drop`) |
+| `-o, --output <dir>` | Diretório de saída (padrão: `./backups`) |
+
+---
+
+### 📥 `herdux restore <arquivo>`
+
+Restaura um banco de dados a partir de um arquivo de backup. Detecta automaticamente o formato:
+
+- `.sql` → usa `psql -f`
+- `.dump` ou qualquer outra extensão → usa `pg_restore`
+
+```bash
+herdux restore ./backups/mydb_2026-02-23.dump --db mydb
+herdux restore ./exports/data.sql --db mydb
+```
+
+Precisa sobrescrever a auto-detecção? Use `--format`:
+
+```bash
+herdux restore arquivo.bkp --db mydb --format custom
+herdux restore script.txt --db mydb --format plain
+```
+
+---
+
+## ⚙️ Configuração & Perfis de Servidor
+
+O `herdux` armazena configurações localmente em `~/.herdux/config.json`.
+
+### Definir Padrões Globais
+
+```bash
+herdux config set user postgres
+herdux config set password minha_senha
+herdux config set port 5432
+```
+
+### Perfis de Servidor Nomeados
+
+Gerencie múltiplas instâncias de banco de dados sem esforço:
+
+```bash
+herdux config add pg16 --port 5416
+herdux config add pg17 --port 5417 --user admin
+herdux config add staging --host 192.168.0.10 --port 5432
+```
+
+Depois conecte usando a flag `-s`:
+
+```bash
+herdux list -s pg16
+herdux backup mydb -s staging
+```
+
+### Visualizar & Gerenciar Config
+
+```bash
+herdux config list           # Mostra todas as configurações e perfis salvos
+herdux config get port       # Obtém um valor específico
+herdux config rm pg16        # Remove um perfil de servidor
+herdux config reset          # Limpa toda a configuração
+```
+
+---
+
+## 🔌 Prioridade de Conexão
+
+Ao resolver como se conectar, o **Herdux** segue uma ordem de prioridade estrita e previsível:
+
+| Prioridade | Fonte | Exemplo |
+|---|---|---|
+| 1️⃣ | **Flags CLI** | `herdux list --port 5417` |
+| 2️⃣ | **Perfil de servidor** | `herdux list -s pg16` |
+| 3️⃣ | **Padrões salvos** | `herdux config set port 5432` |
+| 4️⃣ | **Auto-descoberta** | Escaneia portas comuns; pergunta se encontrar múltiplas |
+
+Isso significa que a entrada explícita sempre vence. Sem surpresas.
+
+---
+
+## 🤔 Por que não pgAdmin?
+
+O **Herdux** não é um substituto de GUI.
+É um acelerador de workflow para desenvolvedores que vivem no terminal.
+
+Sem GUI. Sem overhead. Só velocidade.
+
+---
+
+## 🧠 Princípios de Design
+
+- Sem padrões ocultos (hidden defaults).
+- Sem mágicas destrutivas.
+- Resolução de conexão determinística.
+- Comandos explícitos e combináveis.
+
+---
+
+## 🐳 Suporte Docker (Em Breve)
+
+O **Herdux** poderá detectar e interagir com instâncias PostgreSQL rodando dentro de containers Docker — listando, conectando e gerenciando-as tão naturalmente quanto instâncias locais.
+
+---
+
+## 🗺 Roadmap
+
+Consulte o [ROADMAP.md](./ROADMAP.md) para ver nossos planos futuros detalhados, incluindo integração com Docker e backups criptografados.
+
+---
+
+## 🤝 Contribuindo
+
+PRs são bem-vindas! Por favor, abra uma issue primeiro para discutir mudanças significativas.
+
+```bash
+git clone https://github.com/herdux/herdux.git
+cd herdux
+npm install
+npm run dev
+```
+
+---
+
+## 📄 Licença
+
+MIT

package/dist/commands/backup.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerBackupCommand(program: Command): void;
+//# sourceMappingURL=backup.d.ts.map

package/dist/commands/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgG5D"}

package/dist/commands/backup.js

@@ -0,0 +1,66 @@
+import chalk from "chalk";
+import ora from "ora";
+import prompts from "prompts";
+import { checkPostgresClient, checkPgDump, } from "../services/environment.service.js";
+import * as backup from "../services/backup.service.js";
+import * as postgres from "../services/postgres.service.js";
+import * as config from "../services/config.service.js";
+import { resolveConnectionOptions } from "../utils/resolve-connection.js";
+import { join } from "path";
+import { homedir } from "os";
+export function registerBackupCommand(program) {
+    program
+        .command("backup <database>")
+        .description("Create a backup of a database")
+        .option("-o, --output <dir>", "Output directory for the backup (overrides global config)")
+        .option("-d, --drop", "Ask to drop the database after a successful backup")
+        .option("-y, --yes", "Skip confirmation when dropping (requires --drop)")
+        .option("-F, --format <type>", "Backup format format (custom, plain)", "custom")
+        .action(async (database, cmdOpts) => {
+        try {
+            await checkPostgresClient();
+            await checkPgDump();
+            const rawOpts = program.opts();
+            const opts = await resolveConnectionOptions(rawOpts, rawOpts.server);
+            if (cmdOpts.format !== "custom" && cmdOpts.format !== "plain") {
+                console.error(chalk.red(`\n✖ Invalid format "${cmdOpts.format}". Use "custom" or "plain".\n`));
+                process.exit(1);
+            }
+            const configDefaults = config.getDefault();
+            let finalOutputDir = cmdOpts.output;
+            if (!finalOutputDir) {
+                finalOutputDir =
+                    configDefaults.output || join(homedir(), ".herdux", "backups");
+            }
+            const spinner = ora(`Generating backup for "${database}"...`).start();
+            const outputPath = await backup.backupDatabase(database, finalOutputDir, opts, cmdOpts.format);
+            spinner.succeed(`Backup saved at ${chalk.cyan(outputPath)}\n`);
+            if (cmdOpts.drop) {
+                let shouldDrop = cmdOpts.yes;
+                if (!shouldDrop) {
+                    const response = await prompts({
+                        type: "confirm",
+                        name: "confirmDrop",
+                        message: `Are you sure you want to drop the database "${database}"?`,
+                        initial: false,
+                    });
+                    shouldDrop = response.confirmDrop;
+                }
+                if (shouldDrop) {
+                    const dropSpinner = ora(`Dropping database "${database}"...`).start();
+                    await postgres.dropDatabase(database, opts);
+                    dropSpinner.succeed(`Database "${database}" dropped successfully\n`);
+                }
+                else {
+                    console.log(chalk.gray(`  Skipped dropping database "${database}".\n`));
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\n✖ ${message}\n`));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=backup.js.map

package/dist/commands/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"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"}

package/dist/commands/clean.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerCleanCommand(program: Command): void;
+//# sourceMappingURL=clean.d.ts.map

package/dist/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2H3D"}

package/dist/commands/clean.js

@@ -0,0 +1,102 @@
+import chalk from "chalk";
+import ora from "ora";
+import prompts from "prompts";
+import { checkPostgresClient, checkPgDump, } from "../services/environment.service.js";
+import * as postgres from "../services/postgres.service.js";
+import * as backup from "../services/backup.service.js";
+import * as config from "../services/config.service.js";
+import { resolveConnectionOptions } from "../utils/resolve-connection.js";
+import { join } from "path";
+import { homedir } from "os";
+export function registerCleanCommand(program) {
+    program
+        .command("clean")
+        .description("Interactive bulk cleanup tool to drop multiple databases")
+        .action(async () => {
+        try {
+            await checkPostgresClient();
+            const rawOpts = program.opts();
+            const opts = await resolveConnectionOptions(rawOpts, rawOpts.server);
+            let spinner = ora("Fetching databases...").start();
+            const databases = await postgres.listDatabases(opts);
+            spinner.stop();
+            if (databases.length === 0) {
+                console.log(chalk.yellow("  No databases found to clean.\n"));
+                return;
+            }
+            const response = await prompts({
+                type: "multiselect",
+                name: "selectedDbs",
+                message: "Select databases to DROP (Space to select, Enter to confirm):",
+                choices: databases.map((db) => ({
+                    title: `${db.name} (owner: ${db.owner})`,
+                    value: db.name,
+                })),
+                min: 1,
+                hint: "- Space to select. Return to submit",
+            });
+            const selectedDbs = response.selectedDbs;
+            if (!selectedDbs || selectedDbs.length === 0) {
+                console.log(chalk.yellow("\n⚠ Clean operation cancelled.\n"));
+                return;
+            }
+            console.log(chalk.red(`\nYou selected ${selectedDbs.length} database(s) for deletion.`));
+            const backupResponse = await prompts({
+                type: "confirm",
+                name: "backupFirst",
+                message: "Would you like to backup these databases before dropping them?",
+                initial: true,
+            });
+            if (backupResponse.backupFirst) {
+                await checkPgDump();
+                const configDefaults = config.getDefault();
+                const backupDir = configDefaults.output || join(homedir(), ".herdux", "backups");
+                console.log(chalk.cyan("\nStarting backups..."));
+                for (const db of selectedDbs) {
+                    spinner = ora(`Backing up "${db}"...`).start();
+                    try {
+                        const outObj = await backup.backupDatabase(db, backupDir, opts, "custom");
+                        spinner.succeed(`Saved to ${outObj}`);
+                    }
+                    catch (err) {
+                        spinner.fail(`Failed to backup ${db}`);
+                        const message = err instanceof Error ? err.message : String(err);
+                        console.error(chalk.red(`  ↳ ${message}`));
+                        console.log(chalk.yellow("\n⚠ Aborting clean process to prevent data loss without backup."));
+                        process.exit(1);
+                    }
+                }
+            }
+            const confirmDelete = await prompts({
+                type: "confirm",
+                name: "confirm",
+                message: chalk.red(`Are you absolutely sure you want to DROP ${selectedDbs.length} database(s)? This action is irreversible.`),
+                initial: false,
+            });
+            if (!confirmDelete.confirm) {
+                console.log(chalk.yellow("\n⚠ Clean operation aborted.\n"));
+                return;
+            }
+            console.log();
+            for (const db of selectedDbs) {
+                spinner = ora(`Dropping "${db}"...`).start();
+                try {
+                    await postgres.dropDatabase(db, opts);
+                    spinner.succeed(`Dropped "${db}"`);
+                }
+                catch (err) {
+                    spinner.fail(`Failed to drop "${db}"`);
+                    const message = err instanceof Error ? err.message : String(err);
+                    console.error(chalk.red(`  ↳ ${message}`));
+                }
+            }
+            console.log(chalk.green(`\n✔ Clean operation completed!`));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red(`\n✖ ${message}\n`));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=clean.js.map

package/dist/commands/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"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"}

package/dist/commands/config.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerConfigCommand(program: Command): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuK5D"}