🦅 DB Manager CLI (@t3zcadev/db-manager)

Herramienta interactiva TUI para la gestión, respaldo, importación y clonado directo en vivo de bases de datos (MySQL, PostgreSQL y MongoDB).

Desarrollado y mantenido por T3zcaDev.

⚡ Uso Rápido

1. 🚀 Ejecución Instantánea sin Instalación (npx)

Ejecuta la herramienta directamente en tu terminal sin necesidad de instalar nada previamente:

npx @t3zcadev/db-manager

2. 📦 Instalación Global

Si la utilizas con frecuencia y prefieres tener el comando db-manager siempre disponible en tu sistema:

npm install -g @t3zcadev/db-manager

Una vez instalado, ejecútalo desde cualquier directorio:

db-manager

✨ Características Principales

• 🔄 Clonado Directo en Vivo (Stream A ➔ B): Transfiere bases de datos completas entre servidores o contenedores (ej. de Staging/Prod a tu entorno Local) mediante tuberías (pipes), sin necesidad de guardar archivos de dump temporales en disco.
• 📂 Detección Contextual de Proyectos (.env): Si ejecutas el CLI dentro de la carpeta de cualquier proyecto (NestJS, Next.js, Laravel, etc.), lee automáticamente las credenciales de la base de datos y agrega 📂 PROYECTO ACTUAL al inicio de tus entornos.
• ⚡ Auto-Creación de Bases de Datos Destino: Si intentas importar o clonar hacia una base de datos que aún no existe en el servidor local, el CLI la crea automáticamente (CREATE DATABASE IF NOT EXISTS) antes de inyectar las tablas.
• 📊 Sanitización Inteligente de Dumps MySQL: Elimina automáticamente sentencias conflictivas (DEFINER=..., USE ..., CREATE DATABASE ..., SQL_LOG_BIN) para garantizar restauraciones sin errores entre diferentes versiones o servidores.
• ⚡ Compresión Multinúcleo de Alto Rendimiento: Utiliza zstd -T0 o pigz / gzip junto a barras de progreso en tiempo real con pv.
• 🔒 Cifrado de Credenciales AES-256: Guarda tus conexiones de desarrollo o producción de forma segura con protección mediante clave maestra (Master Key).

🛠️ Opciones del Menú Interactivo

| Opción | Descripción | | :--- | :--- | | 📦 Exportar DB | Genera un respaldo comprimido (.sql.zst / .sql.gz) de una o varias BDs con indicador de progreso. | | 📥 Importar DB | Restaura un respaldo filtrado y sanitizado hacia una BD existente o crea una nueva automáticamente. | | 🔄 Clonar DB Directo (Stream A ➔ B) | Copia datos directamente entre dos entornos (ej. Prod -> Local) en tiempo real sin escribir en disco. | | ⚙️ Gestión de Conexiones | Agrega, edita o elimina servidores MySQL, PostgreSQL o MongoDB. | | 🛠️ Ajustes | Activa/Desactiva cifrado de credenciales, consulta la auditoría de operaciones o limpia respaldos antiguos. |

📢 Publicación de Actualizaciones en NPM

Cuando realices ajustes o nuevas funciones en el proyecto local:

cd ~/Proyectos/Personal/db-manager-cli

# 1. Incrementar versión de parche
npm version patch

# 2. Publicar en el registro de NPM
npm publish --access public

👤 Autor

T3zcaDev

• GitHub: @JonathanHerSa

📄 Licencia

Este proyecto está bajo la Licencia MIT.