@dbcube/cli 5.1.5 → 5.2.1

package/README.md

@@ -0,0 +1,59 @@
+# @dbcube/cli
+
+Command-line interface for [DBCube](https://www.npmjs.com/package/dbcube): schema management with `.cube` files, tracked migrations with rollback, seeders, triggers, TypeScript type generation and database introspection.
+
+## Installation
+
+```bash
+npm install -D @dbcube/cli
+npx dbcube init
+```
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `npx dbcube init` | Scaffold a new project (config + `dbcube/` + example schema) |
+| `npx dbcube generate` | Generate TypeScript types from `.table.cube` files |
+| `npx dbcube validate` | Validate every `.cube` file without executing (exit 1 on errors — CI-friendly) |
+| `npx dbcube doctor` | Diagnose config, binaries and database connectivity |
+| `npx dbcube dev` | Watch mode: saving a `.cube` file applies it automatically |
+| `npx dbcube run database:create` | Interactive database setup (config + physical creation) |
+| `npx dbcube run table:fresh` | Drop and recreate all tables (asks for written confirmation; `--force` for CI) |
+| `npx dbcube run table:refresh` | Apply schema changes **without** dropping data |
+| `npx dbcube run table:alter` | Apply pending `.alter.cube` migrations (`--dry-run`, `--all`) |
+| `npx dbcube migrate:status` | Show applied / pending / modified migrations |
+| `npx dbcube migrate:rollback` | Revert the last migration batch |
+| `npx dbcube run pull [db]` | Generate `.table.cube` files FROM an existing database (MySQL, PostgreSQL, SQLite) |
+| `npx dbcube run seeder:add` | Run `.seeder.cube` data seeders |
+| `npx dbcube run trigger:fresh` | Recreate triggers from `.trigger.cube` files |
+| `npx dbcube update` | Check and update the Rust engine binaries |
+| `npx dbcube run download <engine> [ver]` | Download a specific engine binary |
+| `npx dbcube -v` | Versions of CLI, packages, engines, Node and platform |
+
+Run `npx dbcube help` for the full reference.
+
+## Configuration
+
+`dbcube.config.js` (created by `init`):
+
+```js
+module.exports = function (config) {
+    config.set({
+        databases: {
+            myapp: {
+                type: "sqlite", // mysql | postgres | sqlite | mongodb
+                config: { DATABASE: "myapp" }
+            }
+        }
+    });
+};
+```
+
+## Documentation
+
+https://dbcube.org
+
+## License
+
+MIT

package/package.json

@@ -1,22 +1,38 @@
 {
   "name": "@dbcube/cli",
-  "version": "5.1.5",
-  "main": "index.js",
+  "version": "5.2.1",
+  "main": "src/index.js",
   "scripts": {
     "dbcube": "node src/index.js"
   },
   "bin": {
     "dbcube": "./src/index.js"
   },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "description": "",
+  "files": [
+    "src"
+  ],
+  "keywords": [
+    "dbcube",
+    "cli",
+    "database",
+    "migrations",
+    "mysql",
+    "postgresql",
+    "sqlite",
+    "orm"
+  ],
+  "author": "Albert Araya",
+  "license": "MIT",
+  "description": "Command-line interface for DBCube: schema management (.cube files), migrations with rollback, seeders, triggers, TypeScript type generation and database introspection.",
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
-    "@dbcube/schema-builder": "^5.1.7",
+    "@dbcube/schema-builder": "^5.2.1",
     "@inquirer/prompts": "^8.5.2",
     "alwait": "^1.0.0",
     "chalk": "4.1.2",
+    "dbcube": "^5.2.1",
     "dotenv": "^17.4.2",
     "fs-extra": "^11.3.5",
     "glob": "^13.0.6",

package/src/commands/run/database/create/index.js

@@ -3,7 +3,7 @@ const alwait = require('alwait');
 const ConfigFileUtils = require('../../../../utils/ConfigFileUtils');
 const { select, input } = require('@inquirer/prompts');
 const ora = require('ora');
-const { execSync } = require('child_process');
+const { execFileSync } = require('child_process');
 const path = require('path');
 
 /**
@@ -18,10 +18,9 @@ async function createNewDatabase() {
 
         // Fase 1: Ejecutar addDatabaseConfig.js
         console.log('🔧 Iniciando configuración de base de datos...');
-        const configCommand = `node "${path.join(__dirname, 'addDatabaseConfig.js')}"`;
 
         try {
-            execSync(configCommand, {
+            execFileSync(process.execPath, [path.join(__dirname, 'addDatabaseConfig.js')], {
                 stdio: 'inherit',
                 cwd: process.cwd()
             });
@@ -37,20 +36,20 @@ async function createNewDatabase() {
 
         try {
             databaseName = fs.readFileSync(tempFile, 'utf8');
-            // Limpiar el archivo temporal
-            fs.unlinkSync(tempFile);
         } catch (error) {
             console.error('❌ Error: No se pudo obtener el nombre de la base de datos configurada');
             process.exit(1);
+        } finally {
+            // Limpiar el archivo temporal pase lo que pase
+            try { fs.unlinkSync(tempFile); } catch { /* ya no existe */ }
         }
 
         console.log('\n🏗️ Iniciando creación física de la base de datos...');
 
-        // Fase 2: Ejecutar createDatabase.js
-        const createCommand = `node "${path.join(__dirname, 'createDatabase.js')}" --name="${databaseName}"`;
-
+        // Fase 2: Ejecutar createDatabase.js. execFileSync con array de
+        // argumentos: el nombre no pasa por el shell (sin inyección de comandos)
         try {
-            execSync(createCommand, {
+            execFileSync(process.execPath, [path.join(__dirname, 'createDatabase.js'), `--name=${databaseName}`], {
                 stdio: 'inherit',
                 cwd: process.cwd()
             });
@@ -75,10 +74,9 @@ async function createNewDatabase() {
 async function useExistingDatabase(databaseName) {
     try {
         // Ejecutar createDatabase.js con el nombre de la base de datos existente
-        const createCommand = `node "${path.join(__dirname, 'createDatabase.js')}" --name="${databaseName}"`;
-
+        // (execFileSync: el nombre no pasa por el shell, sin inyección de comandos)
         try {
-            execSync(createCommand, {
+            execFileSync(process.execPath, [path.join(__dirname, 'createDatabase.js'), `--name=${databaseName}`], {
                 stdio: 'inherit',
                 cwd: process.cwd()
             });

package/src/commands/run/pull.js

@@ -101,13 +101,70 @@ async function introspect(engine, dbName, motor) {
             if (!tables[fk.tn]) continue;
             tables[fk.tn].fks[fk.cn] = { table: fk.rt, column: fk.rc };
         }
+    } else if (motor === 'mongodb') {
+        // Introspección por muestreo: MongoDB no tiene esquema fijo, así que
+        // se infieren los tipos de los primeros 50 documentos por colección.
+        const listRes = await raw(engine, JSON.stringify({ listCollections: 1, nameOnly: true }));
+        const batch = listRes?.[0]?.cursor?.firstBatch ?? [];
+        const collections = batch
+            .map(c => c.name)
+            .filter(n => n && !n.startsWith('system.') && !n.startsWith('dbcube_'));
+
+        for (const coll of collections) {
+            const findRes = await raw(engine, JSON.stringify({ find: coll, limit: 50 }));
+            const docs = findRes?.[0]?.cursor?.firstBatch ?? [];
+
+            // campo -> { types: Set, seen: n, nullSeen: bool }
+            const fields = new Map();
+            for (const doc of docs) {
+                for (const [key, value] of Object.entries(doc)) {
+                    if (key === '_id') continue; // gestionado por MongoDB
+                    let f = fields.get(key);
+                    if (!f) { f = { types: new Set(), seen: 0, nullSeen: false }; fields.set(key, f); }
+                    f.seen++;
+                    if (value === null) { f.nullSeen = true; continue; }
+                    f.types.add(inferMongoCubeType(value));
+                }
+            }
+
+            tables[coll] = {
+                columns: [...fields.entries()].map(([name, f]) => {
+                    const types = [...f.types];
+                    const dataType = types.length === 1 ? types[0] : 'json'; // tipos mixtos → json
+                    return {
+                        name,
+                        dataType,
+                        length: dataType === 'varchar' ? '255' : null,
+                        nullable: f.nullSeen || f.seen < docs.length,
+                        defaultValue: null,
+                        isPk: false,
+                        autoinc: false,
+                        enumValues: null,
+                    };
+                }),
+                fks: {},
+            };
+        }
     } else {
-        throw new Error(`pull is not supported yet for motor '${motor}' (mysql, postgresql, sqlite available)`);
+        throw new Error(`pull is not supported yet for motor '${motor}' (mysql, postgresql, sqlite, mongodb available)`);
     }
 
     return tables;
 }
 
+function inferMongoCubeType(value) {
+    if (typeof value === 'boolean') return 'boolean';
+    if (typeof value === 'number') return Number.isInteger(value) ? 'int' : 'double';
+    if (typeof value === 'string') {
+        if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}/.test(value)) return 'datetime';
+        if (/^\d{4}-\d{2}-\d{2}$/.test(value)) return 'date';
+        return 'varchar';
+    }
+    // BSON dates llegan como {$date: ...} al serializar a JSON
+    if (value && typeof value === 'object' && '$date' in value) return 'datetime';
+    return 'json'; // objetos anidados y arrays
+}
+
 function renderCube(dbName, tableName, table) {
     let out = `@database("${dbName}");\n\n`;
     out += `@meta({\n    name: "${tableName}";\n    description: "Imported from existing database by dbcube pull";\n});\n\n`;

package/src/commands/run/seeder/add.js

@@ -16,14 +16,15 @@ async function main() {
     if (error.message.includes("reading 'init'")) {
       console.error('❌ Configuracion de base de datos no encontrada\n');
       console.error('Ejecute el comando para crear una nueva base de datos:');
-      console.error(`\tdbcube run create:database`);
+      console.error(`\tnpx dbcube run database:create`);
       console.error('\nO verifique que la base de datos este configurada en el archivo dbcube.config.js\n');
       process.exit(1);
     } else if (error.message.includes("reading 'getDatabase'")) {
       console.error('- Se sugiere cambiar el linea o crear la base de datos a la que se hace referencia.');
     } else {
-      console.error('Error aqui:', error);
-      console.error('Error aqui:', error.message);
+      console.error(`❌ ${error.message}`);
+      if (process.env.DEBUG) console.error(error);
+      process.exit(1);
     }
   }
 }

package/src/commands/run/table/fresh.js

@@ -1,35 +1,81 @@
-const { Schema } = require('@dbcube/schema-builder');
-const ConfigFileUtils = require('./../../../utils/ConfigFileUtils');
-
-async function main() {
-  try {
-    const args = process.argv.slice(2);
-    const runSeeders = args.includes('--seeder');
-
-    const configuredDatabases = await ConfigFileUtils.getConfiguredDatabases();
-
-    for (const config of configuredDatabases) {
-      const schema = new Schema(config.name);
-      await schema.freshTables();
-      if (runSeeders) {
-        await schema.executeSeeders();
-      }
-    }
-  } catch (error) {
-    if (error.message.includes("reading 'init'")) {
-      console.error('❌ Configuracion de base de datos no encontrada\n');
-      console.error('Ejecute el comando para crear una nueva base de datos:');
-      console.error(`\tdbcube run create:database`);
-      console.error('\nO verifique que la base de datos este configurada en el archivo dbcube.config.js\n');
-      process.exit(1);
-    } else if (error.message.includes("reading 'getDatabase'")) {
-      console.error('- Se sugiere cambiar el linea o crear la base de datos a la que se hace referencia.');
-    } else {
-      console.error('Error aqui:', error);
-      console.error('Error aqui:', error.message);
-    }
-  }
-}
-
-// Ejecutar el ejemplo
-main().catch(console.error);
+const chalk = require('chalk');
+const { Schema } = require('@dbcube/schema-builder');
+const ConfigFileUtils = require('./../../../utils/ConfigFileUtils');
+
+/**
+ * dbcube run table:fresh [--seeder] [--force]
+ * DESTRUCTIVO: dropea y recrea todas las tablas desde los .table.cube.
+ * Pide confirmación ESCRITA (el nombre de la base de datos) salvo con --force.
+ */
+async function confirmDestruction(databases) {
+  const { input } = require('@inquirer/prompts');
+
+  console.log('');
+  console.log(`  ${chalk.bgRed.white.bold(' ⚠ DESTRUCTIVE OPERATION ')}`);
+  console.log('');
+  console.log(`  ${chalk.red('table:fresh will DROP and recreate ALL tables.')}`);
+  console.log(`  ${chalk.red.bold('ALL DATA WILL BE PERMANENTLY LOST')} in:`);
+  for (const db of databases) {
+    console.log(`    ${chalk.yellow('•')} ${chalk.bold(db.name)} ${chalk.gray(`(${db.type})`)}`);
+  }
+  console.log('');
+  console.log(`  ${chalk.gray('To update schemas WITHOUT losing data use:')} ${chalk.white('npx dbcube run table:refresh')}`);
+  console.log('');
+
+  const expected = databases.length === 1 ? databases[0].name : 'all';
+  const answer = await input({
+    message: `Type ${chalk.bold(expected)} to confirm (anything else aborts):`,
+  });
+
+  return answer.trim() === expected;
+}
+
+async function main() {
+  try {
+    const args = process.argv.slice(2);
+    const runSeeders = args.includes('--seeder');
+    const force = args.includes('--force') || args.includes('-y') || args.includes('--yes');
+
+    const configuredDatabases = await ConfigFileUtils.getConfiguredDatabases();
+
+    if (!force) {
+      if (!process.stdin.isTTY) {
+        console.error(`\n${chalk.red('❌ table:fresh is destructive and needs confirmation.')}`);
+        console.error(`${chalk.gray('Non-interactive environment detected — pass')} ${chalk.white('--force')} ${chalk.gray('to proceed (e.g. in CI).')}\n`);
+        process.exit(1);
+      }
+      const confirmed = await confirmDestruction(configuredDatabases);
+      if (!confirmed) {
+        console.log(`\n${chalk.yellow('Aborted.')} ${chalk.gray('No changes were made.')}\n`);
+        process.exit(0);
+      }
+    }
+
+    for (const config of configuredDatabases) {
+      const schema = new Schema(config.name);
+      await schema.freshTables();
+      if (runSeeders) {
+        await schema.executeSeeders();
+      }
+    }
+  } catch (error) {
+    if (error.name === 'ExitPromptError') {
+      console.log(`\n${chalk.yellow('Aborted.')} ${chalk.gray('No changes were made.')}\n`);
+      process.exit(0);
+    }
+    if (error.message.includes("reading 'init'")) {
+      console.error('❌ Configuracion de base de datos no encontrada\n');
+      console.error('Ejecute el comando para crear una nueva base de datos:');
+      console.error(`\tdbcube run database:create`);
+      console.error('\nO verifique que la base de datos este configurada en el archivo dbcube.config.js\n');
+      process.exit(1);
+    } else if (error.message.includes("reading 'getDatabase'")) {
+      console.error('- Se sugiere cambiar el linea o crear la base de datos a la que se hace referencia.');
+    } else {
+      console.error('Error:', error.message);
+      process.exit(1);
+    }
+  }
+}
+
+main().catch(console.error);

package/src/commands/run/table/refresh.js

@@ -2,7 +2,6 @@ const { Schema } = require('@dbcube/schema-builder');
 const ConfigFileUtils = require('./../../../utils/ConfigFileUtils');
 
 async function main() {
-  console.clear();
   try {
     const configuredDatabases = await ConfigFileUtils.getConfiguredDatabases();
     // Recorrer cada archivo y mostrar su contenido
@@ -14,14 +13,15 @@ async function main() {
     if (error.message.includes("reading 'init'")) {
       console.error('❌ Configuracion de base de datos no encontrada\n');
       console.error('Ejecute el comando para crear una nueva base de datos:');
-      console.error(`\tdbcube run create:database`);
+      console.error(`\tnpx dbcube run database:create`);
       console.error('\nO verifique que la base de datos este configurada en el archivo dbcube.config.js\n');
       process.exit(1);
     } else if (error.message.includes("reading 'getDatabase'")) {
       console.error('- Se sugiere cambiar el linea o crear la base de datos a la que se hace referencia.');
     } else {
-      console.error('Error aqui:', error);
-      console.error('Error aqui:', error.message);
+      console.error(`❌ ${error.message}`);
+      if (process.env.DEBUG) console.error(error);
+      process.exit(1);
     }
   }
 }

package/src/commands/run/trigger/fresh.js

@@ -14,14 +14,15 @@ async function main() {
     if (error.message.includes("reading 'init'")) {
       console.error('❌ Configuracion de base de datos no encontrada\n');
       console.error('Ejecute el comando para crear una nueva base de datos:');
-      console.error(`\tdbcube run create:database`);
+      console.error(`\tnpx dbcube run database:create`);
       console.error('\nO verifique que la base de datos este configurada en el archivo dbcube.config.js\n');
       process.exit(1);
     } else if (error.message.includes("reading 'getDatabase'")) {
       console.error('- Se sugiere cambiar el linea o crear la base de datos a la que se hace referencia.');
     } else {
-      console.error('Error aqui:', error);
-      console.error('Error aqui:', error.message);
+      console.error(`❌ ${error.message}`);
+      if (process.env.DEBUG) console.error(error);
+      process.exit(1);
     }
   }
   console.log('\n');

package/src/commands/version.js

@@ -1,29 +1,66 @@
-const path = require('path');
-const fs = require('fs');
-const chalk = require('chalk');
-
-/**
- * Muestra la versión actual del CLI de Dbcube
- */
-async function showVersion() {
-    try {
-        // Leer el package.json del CLI
-        const packageJsonPath = path.join(__dirname, '../../package.json');
-        const packageData = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
-        
-        console.log(`\n${chalk.green('🚀 Dbcube CLI')}`);
-        console.log(`${chalk.cyan('Versión:')} ${chalk.bold(packageData.version)}`);
-        console.log(`${chalk.cyan('Nombre:')} ${packageData.name}`);
-        console.log(`${chalk.gray('Licencia:')} ${packageData.license}\n`);
-        
-    } catch (error) {
-        console.error('❌ Error al obtener la versión:', error.message);
-        process.exit(1);
-    }
-}
-
-// Ejecutar función
-showVersion().catch(error => {
-    console.error('Error fatal:', error);
-    process.exit(1);
-});
+const path = require('path');
+const fs = require('fs');
+const chalk = require('chalk');
+
+/**
+ * dbcube version — CLI, packages, engine binaries, and environment info.
+ */
+function readVersion(pkgPath) {
+    try {
+        return JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version;
+    } catch {
+        return null;
+    }
+}
+
+function findEngineVersions() {
+    const binDir = path.join(process.cwd(), '.dbcube', 'bin');
+    const engines = {};
+    try {
+        for (const f of fs.readdirSync(binDir)) {
+            const m = f.match(/^(query-engine|schema-engine|sqlite-engine)-v([\d.]+)-/);
+            if (m) engines[m[1]] = `v${m[2]}`;
+        }
+    } catch { /* no binaries downloaded yet */ }
+    return engines;
+}
+
+async function showVersion() {
+    try {
+        const cliVersion = readVersion(path.join(__dirname, '../../package.json'));
+        const row = (label, value, dim = false) =>
+            console.log(`  ${chalk.gray(label.padEnd(16))} ${dim ? chalk.gray(value) : chalk.white(value)}`);
+
+        console.log('');
+        console.log(`  ${chalk.green.bold('▣ DBCube CLI')} ${chalk.bold('v' + cliVersion)}`);
+        console.log(`  ${chalk.gray('─'.repeat(40))}`);
+
+        // Local package versions (when resolvable from the project)
+        const localPkgs = ['dbcube', '@dbcube/query-builder', '@dbcube/schema-builder', '@dbcube/core'];
+        for (const pkg of localPkgs) {
+            try {
+                const pkgJson = require.resolve(`${pkg}/package.json`, { paths: [process.cwd()] });
+                const v = readVersion(pkgJson);
+                if (v) row(pkg, 'v' + v);
+            } catch { /* not installed in this project */ }
+        }
+
+        const engines = findEngineVersions();
+        for (const [name, v] of Object.entries(engines)) {
+            row(name, `${v} ${chalk.gray('(rust)')}`);
+        }
+
+        console.log(`  ${chalk.gray('─'.repeat(40))}`);
+        row('node', process.version, true);
+        row('platform', `${process.platform}-${process.arch}`, true);
+        console.log('');
+    } catch (error) {
+        console.error('❌ Error al obtener la versión:', error.message);
+        process.exit(1);
+    }
+}
+
+showVersion().catch(error => {
+    console.error('Error fatal:', error);
+    process.exit(1);
+});

package/src/index.js

@@ -1,104 +1,162 @@
-#!/usr/bin/env node
-const path = require('path');
-
-// Obtener los argumentos pasados al comando
-const args = process.argv.slice(2);
-
-// Procesar los argumentos
-let mainCommand = '';
-const commandArgs = [];
-
-if (args.length > 0) {
-  // Si el primer argumento es "run", combinamos con el segundo para formar el comando
-  if (args[0] === 'run' && args.length > 1) {
-    mainCommand = 'run:' + args[1];
-    // Añadir el resto de argumentos
-    for (let i = 2; i < args.length; i++) {
-      commandArgs.push(args[i]);
-    }
-  } else if (args[0].includes('create:')) {
-    // Si es un comando create: lo usamos directamente
-    mainCommand = args[0];
-    // Añadir el resto de argumentos
-    for (let i = 1; i < args.length; i++) {
-      commandArgs.push(args[i]);
-    }
-  } else {
-    // Para otros comandos, usamos el primer argumento como comando
-    mainCommand = args[0];
-    // Añadir el resto de argumentos
-    for (let i = 1; i < args.length; i++) {
-      commandArgs.push(args[i]);
-    }
-  }
-}
-
-// Mapa de comandos para mapear nombres de comandos a rutas de archivo
-const commandMap = {
-  'run:table:fresh': '../src/commands/run/table/fresh.js',
-  'run:table:refresh': '../src/commands/run/table/refresh.js',
-  'run:table:alter': '../src/commands/run/table/alter.js',
-
-  'run:trigger:fresh': '../src/commands/run/trigger/fresh.js',
-
-  'run:seeder:add': '../src/commands/run/seeder/add.js',
-
-  'run:database:create': '../src/commands/run/database/create/index.js',
-  'run:database:create:config': '../src/commands/run/database/create/addDatabaseConfig.js',
-  'run:database:create:physical': '../src/commands/run/database/create/createDatabase.js',
-
-  'run:pull': '../src/commands/run/pull.js',
-
-  'run:download': '../src/commands/run/download.js',
-  'run:update': '../src/commands/run/update.js',
-
-  'init': '../src/commands/init.js',
-  'generate': '../src/commands/generate.js',
-  'validate': '../src/commands/validate.js',
-  'doctor': '../src/commands/doctor.js',
-  'dev': '../src/commands/dev.js',
-
-  'migrate:status': '../src/commands/migrate/status.js',
-  'migrate:rollback': '../src/commands/migrate/rollback.js',
-
-  'update': '../src/commands/update.js',
-
-  '--version': '../src/commands/version.js',
-  '-v': '../src/commands/version.js',
-
-  'help': '../src/commands/help.js',
-  '--help': '../src/commands/help.js',
-  '-h': '../src/commands/help.js',
-};
-
-// Función para ejecutar comandos basados en los argumentos
-async function executeCommand(command, commandArgs) {
-  // Verificar si el comando existe en el mapa
-  if (commandMap[command]) {
-    const examplePath = path.join(__dirname, commandMap[command]);
-
-    // Guardamos los argumentos originales
-    const originalArgv = process.argv;
-
-    try {
-      // Reemplazamos los argumentos con los que necesitamos pasar al script
-      process.argv = [process.argv[0], process.argv[1], ...commandArgs];
-      await require(examplePath);
-    } finally {
-      // Restauramos los argumentos originales
-      process.argv = originalArgv;
-    }
-  } else {
-    // Comando desconocido - mostrar help
-    const chalk = require('chalk');
-    console.log(`\n${chalk.red('❌ Unknown command:')} ${command} ${commandArgs.join(' ')}\n`);
-    console.log(`${chalk.cyan('Run')} ${chalk.yellow('npx dbcube help')} ${chalk.cyan('to see all available commands.')}\n`);
-    process.exit(1);
-  }
-}
-
-// Ejecutar el comando correspondiente
-executeCommand(mainCommand, commandArgs).catch(err => {
-  console.error('Error inesperado:', err);
-  process.exit(1);
-});
+#!/usr/bin/env node
+const path = require('path');
+const chalk = require('chalk');
+
+// Obtener los argumentos pasados al comando
+const args = process.argv.slice(2);
+
+// Procesar los argumentos
+let mainCommand = '';
+const commandArgs = [];
+
+if (args.length > 0) {
+  // Si el primer argumento es "run", combinamos con el segundo para formar el comando
+  if (args[0] === 'run' && args.length > 1) {
+    mainCommand = 'run:' + args[1];
+    for (let i = 2; i < args.length; i++) {
+      commandArgs.push(args[i]);
+    }
+  } else if (args[0].includes('create:')) {
+    mainCommand = args[0];
+    for (let i = 1; i < args.length; i++) {
+      commandArgs.push(args[i]);
+    }
+  } else {
+    mainCommand = args[0];
+    for (let i = 1; i < args.length; i++) {
+      commandArgs.push(args[i]);
+    }
+  }
+} else {
+  // Sin argumentos: mostrar ayuda en lugar de fallar
+  mainCommand = '--help';
+}
+
+// Mapa de comandos para mapear nombres de comandos a rutas de archivo
+const commandMap = {
+  'run:table:fresh': '../src/commands/run/table/fresh.js',
+  'run:table:refresh': '../src/commands/run/table/refresh.js',
+  'run:table:alter': '../src/commands/run/table/alter.js',
+
+  'run:trigger:fresh': '../src/commands/run/trigger/fresh.js',
+
+  'run:seeder:add': '../src/commands/run/seeder/add.js',
+
+  'run:database:create': '../src/commands/run/database/create/index.js',
+  'run:database:create:config': '../src/commands/run/database/create/addDatabaseConfig.js',
+  'run:database:create:physical': '../src/commands/run/database/create/createDatabase.js',
+  // Alias sin "run" (el help histórico lo documenta así)
+  'database:create': '../src/commands/run/database/create/index.js',
+
+  'run:pull': '../src/commands/run/pull.js',
+
+  'run:download': '../src/commands/run/download.js',
+  'run:update': '../src/commands/run/update.js',
+
+  'init': '../src/commands/init.js',
+  'generate': '../src/commands/generate.js',
+  'validate': '../src/commands/validate.js',
+  'doctor': '../src/commands/doctor.js',
+  'dev': '../src/commands/dev.js',
+
+  'migrate:status': '../src/commands/migrate/status.js',
+  'migrate:rollback': '../src/commands/migrate/rollback.js',
+
+  'update': '../src/commands/update.js',
+
+  'version': '../src/commands/version.js',
+  '--version': '../src/commands/version.js',
+  '-v': '../src/commands/version.js',
+
+  'help': '../src/commands/help.js',
+  '--help': '../src/commands/help.js',
+  '-h': '../src/commands/help.js',
+};
+
+// Distancia de Levenshtein para sugerencias "did you mean"
+function levenshtein(a, b) {
+  const m = Array.from({ length: a.length + 1 }, (_, i) => [i, ...Array(b.length).fill(0)]);
+  for (let j = 0; j <= b.length; j++) m[0][j] = j;
+  for (let i = 1; i <= a.length; i++) {
+    for (let j = 1; j <= b.length; j++) {
+      m[i][j] = Math.min(
+        m[i - 1][j] + 1,
+        m[i][j - 1] + 1,
+        m[i - 1][j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1)
+      );
+    }
+  }
+  return m[a.length][b.length];
+}
+
+function suggestCommand(input) {
+  // Candidatos: forma completa ("run table:fresh") y forma corta ("table:fresh"),
+  // ambos mostrando siempre la forma completa al usuario.
+  const candidates = [];
+  for (const c of Object.keys(commandMap)) {
+    if (c.startsWith('-')) continue;
+    if (c.startsWith('run:')) {
+      const display = 'run ' + c.slice(4);
+      candidates.push({ match: display, display });
+      candidates.push({ match: c.slice(4), display });
+    } else {
+      candidates.push({ match: c, display: c });
+    }
+  }
+
+  const scored = candidates
+    .map(({ match, display }) => ({ display, d: levenshtein(input.toLowerCase(), match.toLowerCase()) }))
+    .sort((x, y) => x.d - y.d);
+
+  if (scored.length === 0 || scored[0].d > Math.max(3, Math.floor(input.length / 2))) return [];
+
+  const seen = new Set();
+  return scored
+    .filter(s => s.d <= scored[0].d + 1)
+    .filter(s => !seen.has(s.display) && seen.add(s.display))
+    .slice(0, 3)
+    .map(s => s.display);
+}
+
+// Función para ejecutar comandos basados en los argumentos
+async function executeCommand(command, commandArgs) {
+  if (commandMap[command]) {
+    const examplePath = path.join(__dirname, commandMap[command]);
+    const originalArgv = process.argv;
+
+    try {
+      process.argv = [process.argv[0], process.argv[1], ...commandArgs];
+      await require(examplePath);
+    } finally {
+      process.argv = originalArgv;
+    }
+  } else {
+    // Comando desconocido: error claro + sugerencias
+    const typed = [args[0], args[1]].filter(Boolean).join(' ');
+    console.log('');
+    console.log(`  ${chalk.bgRed.white.bold(' ERROR ')} ${chalk.red(`Unknown command:`)} ${chalk.bold(typed)}`);
+
+    const suggestions = suggestCommand(typed);
+    if (suggestions.length > 0) {
+      console.log('');
+      console.log(`  ${chalk.cyan('Did you mean:')}`);
+      for (const s of suggestions) {
+        console.log(`    ${chalk.green('→')} ${chalk.white('npx dbcube ' + s)}`);
+      }
+    }
+
+    console.log('');
+    console.log(`  ${chalk.gray('Run')} ${chalk.yellow('npx dbcube help')} ${chalk.gray('to see all available commands.')}`);
+    console.log('');
+    process.exit(1);
+  }
+}
+
+// Ejecutar el comando correspondiente
+executeCommand(mainCommand, commandArgs).catch(err => {
+  console.log('');
+  console.log(`  ${chalk.bgRed.white.bold(' FATAL ')} ${chalk.red(err.message)}`);
+  console.log(`  ${chalk.gray('Run')} ${chalk.yellow('npx dbcube doctor')} ${chalk.gray('to diagnose your setup.')}`);
+  console.log('');
+  process.exit(1);
+});

package/src/utils/ConfigFileUtils.js

@@ -78,8 +78,9 @@ class ConfigFileUtils {
             }
             return arrayDatabases;
         } catch (error) {
-            console.error('Error al cargar las bases de datos desde ' + configPath, error);
-            return ['test1']; // Valor por defecto
+            // Fallar claro: devolver una DB inventada ocultaría el problema
+            // y haría que los comandos operen contra una base inexistente
+            throw new Error(`No se pudo cargar la configuración desde ${configPath}: ${error.message}`);
         }
     }
 

package/.npmignore

@@ -1,58 +0,0 @@
-# Directories
-examples
-
-# Ignorar dependencias y configuraciones de desarrollo
-node_modules/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# Ignorar carpetas y archivos irrelevantes
-.vscode/
-.lh
-.idea/
-.DS_Store
-Thumbs.db
-*.log
-
-# Ignorar configuraciones del proyecto
-.env
-.env.*.local
-package-lock.json
-
-# Ignorar archivos del sistema
-*.swp
-*.swo
-*.tmp
-*.temp
-
-# Ignorar carpetas de trabajo
-temp/
-logs/
-debug/
-
-# Ignorar archivos de compilación
-src/
-tsconfig.json
-tsconfig.tsbuildinfo
-
-# Ignorar pruebas y configuraciones
-tests/
-__tests__/
-__mocks__/
-coverage/
-jest.config.js
-
-# Ignorar documentación o ejemplos no necesarios
-docs/
-examples/
-
-# Asegurarse de incluir solo lo esencial
-!.npmignore
-tsconfig.json
-tsup.config.ts
-
-.dbcube
-dbcube
-.env
-*.db

package/bun.lock

@@ -1,192 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "@dbcube/cli",
-      "dependencies": {
-        "@dbcube/schema-builder": "^5.1.7",
-        "@inquirer/prompts": "^8.5.2",
-        "alwait": "^1.0.0",
-        "chalk": "4.1.2",
-        "dotenv": "^17.4.2",
-        "fs-extra": "^11.3.5",
-        "glob": "^13.0.6",
-        "ora": "5.4.1",
-        "unzipper": "^0.12.3",
-      },
-    },
-  },
-  "overrides": {
-    "chalk": "4.1.2",
-    "ora": "5.4.1",
-  },
-  "packages": {
-    "@dbcube/core": ["@dbcube/core@5.1.15", "", { "dependencies": { "chalk": "4.1.2", "deasync": "^0.1.31", "follow-redirects": "^1.16.0", "ora": "5.4.1", "unzipper": "^0.12.3" }, "bin": { "dbcube-core": "dist/bin.cjs" } }, "sha512-/sA4Mya1pqb77Ki8LVm8mPnQVZb6OFsfxjR58rP8OeAOp/uWDWrBfL5GFdi8+a2+oZYJvz5d1DA/nEBB3jYjSA=="],
-
-    "@dbcube/schema-builder": ["@dbcube/schema-builder@5.1.7", "", { "dependencies": { "@dbcube/core": "^5.1.15", "chalk": "^5.6.2", "ora": "^9.4.0" } }, "sha512-oTea6R1EgKxwRjI7N1IkFnMZZms3pOMzPVATUaCZzHiUSol+IgHZ5rYQJvGIGXAs1s4lGndE1OokISHoc6o89g=="],
-
-    "@inquirer/ansi": ["@inquirer/ansi@2.0.7", "", {}, "sha512-3eTuUO1vH2cZm2ZKHeQxnOqlTi9EfZDGgIe3BL3I4u+rJHocr9Fz86M4fjYABPvFnQG/gGK551HqDiIcETwU6Q=="],
-
-    "@inquirer/checkbox": ["@inquirer/checkbox@5.2.1", "", { "dependencies": { "@inquirer/ansi": "^2.0.7", "@inquirer/core": "^11.2.1", "@inquirer/figures": "^2.0.7", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-b6xmA/VlTe0ZgDQHDui+Nav470u7u49nRd8/iuhOcQPO9Ch7lGuogydhi2VOmNlZ+zXcM8IcPuNSwQcdJaF/kw=="],
-
-    "@inquirer/confirm": ["@inquirer/confirm@6.1.1", "", { "dependencies": { "@inquirer/core": "^11.2.1", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-eb8DBZcz/2qHWQda4rk2JiQk5h9QV/cVHi1yjt0f69WFZMRFn0sJTye3EAP8icut8UDMjQPsaH5KbcOogefrFQ=="],
-
-    "@inquirer/core": ["@inquirer/core@11.2.1", "", { "dependencies": { "@inquirer/ansi": "^2.0.7", "@inquirer/figures": "^2.0.7", "@inquirer/type": "^4.0.7", "cli-width": "^4.1.0", "fast-wrap-ansi": "^0.2.0", "mute-stream": "^3.0.0", "signal-exit": "^4.1.0" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-Qd6GJT1yVyrZZCfN8W2qKF5ApmqryXRhRKCuip8h01x2w/esJQ2XIYc6f9abMIHgKQdBfFTSOdbHRLAhuM09UA=="],
-
-    "@inquirer/editor": ["@inquirer/editor@5.2.2", "", { "dependencies": { "@inquirer/core": "^11.2.1", "@inquirer/external-editor": "^3.0.3", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-ZRVd/oD+sYsUd5zVm0NflqEzlqfYCyHNsqkHl2oWXEUHs12tCbcSFi+wVFEvD8+LGRaMUsVrE7qeo6lSG/S1Vg=="],
-
-    "@inquirer/expand": ["@inquirer/expand@5.1.1", "", { "dependencies": { "@inquirer/core": "^11.2.1", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-YmQpenjbFSHAK3sOd44puHh3V1KXXr+JiNpUztoSQ4drLh2rTVzTap/YtlAVu/5xavifIlBfNEzJ/neZJ1a/1g=="],
-
-    "@inquirer/external-editor": ["@inquirer/external-editor@3.0.3", "", { "dependencies": { "chardet": "^2.1.1", "iconv-lite": "^0.7.2" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-6thf5I8q7lZwzGLAxPaaGEREEkZ3nyePPDQ1oyobblxmEE8mqTLguScP7pDjUTAibiyb4hfXl+qjUEJ+di/aNA=="],
-
-    "@inquirer/figures": ["@inquirer/figures@2.0.7", "", {}, "sha512-aJ8TBPOGB6f/2qziPfElISTCEd5XOYTFckA2SGjhNmiKzfK/u4ot3v0DUzGVdUnKjN10EqnnEPck36BkyfLnJw=="],
-
-    "@inquirer/input": ["@inquirer/input@5.1.2", "", { "dependencies": { "@inquirer/core": "^11.2.1", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-9K/DDBSQpOyZSkt6sOVP9Vo0TR7atX2kuILsUu0x3wVcVbe97lJwIJKMLdMw25tDYuXl/qp6erT0Xs1rfmcfZg=="],
-
-    "@inquirer/number": ["@inquirer/number@4.1.1", "", { "dependencies": { "@inquirer/core": "^11.2.1", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-XF4IXAbPnGPgw0wsbC/i2tPcyfdZgDpUlhsqU0SfT4IRIGWha6Xm9VRgN5yYxJq+jnyXlfXI/nQ3ulfk0iEICA=="],
-
-    "@inquirer/password": ["@inquirer/password@5.1.1", "", { "dependencies": { "@inquirer/ansi": "^2.0.7", "@inquirer/core": "^11.2.1", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-3XBfF7DAsp5qeDsvN5Rd1HmbNokVvEQoUM0QLrRcybC9nX96w3Pbmu7qUsb3IT3J3jBvs2+mTXaKHOUsgHMLzg=="],
-
-    "@inquirer/prompts": ["@inquirer/prompts@8.5.2", "", { "dependencies": { "@inquirer/checkbox": "^5.2.1", "@inquirer/confirm": "^6.1.1", "@inquirer/editor": "^5.2.2", "@inquirer/expand": "^5.1.1", "@inquirer/input": "^5.1.2", "@inquirer/number": "^4.1.1", "@inquirer/password": "^5.1.1", "@inquirer/rawlist": "^5.3.1", "@inquirer/search": "^4.2.1", "@inquirer/select": "^5.2.1" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-IYR/3C/paEVVQYQvdDlFZVjRCJVYHHON0XXMH91KO9GSxs0TdKYWlUdvfQl2EfAHDxUaN3IBffkE/BDTh5nJ6g=="],
-
-    "@inquirer/rawlist": ["@inquirer/rawlist@5.3.1", "", { "dependencies": { "@inquirer/core": "^11.2.1", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-QqdTqQddL3qPX/PPrjobpsO25NZ4dWXgTLenrR445L2ptLEYE6Z+PD5c5CNDJNx4ugRgELAIpSIJxZaO2jJ2Og=="],
-
-    "@inquirer/search": ["@inquirer/search@4.2.1", "", { "dependencies": { "@inquirer/core": "^11.2.1", "@inquirer/figures": "^2.0.7", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-xJj8QWKRSrfKoBIITLZK61dD3zwo0Rz11fgDImku30/Oe81zMdIdGgrLY2h6RkJ+KZ/GhNYIRMKnH/62qBTA5g=="],
-
-    "@inquirer/select": ["@inquirer/select@5.2.1", "", { "dependencies": { "@inquirer/ansi": "^2.0.7", "@inquirer/core": "^11.2.1", "@inquirer/figures": "^2.0.7", "@inquirer/type": "^4.0.7" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-FlDndEUww8m7BfukO2nJa25vhD+H5jxxCv4oGioKqzyWz3nPHhhw4LKdYRSlXuAx7DsdWia7iyaBPKKS95Evfw=="],
-
-    "@inquirer/type": ["@inquirer/type@4.0.7", "", { "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-t28inv14nMQ1PhKpsJPY+kEs/c00qzeCOS2gTNRyTjG5d6qsVA2fItxW4hkvGZ5lvanGLdtCzVIx5dwdRpN1+g=="],
-
-    "alwait": ["alwait@1.0.0", "", {}, "sha512-o+jEoGVTJyvYDT5mOWkj2i4IsOC7SNCWGc/+o6rAfGx1x3jCBIeFsCwgW/3ZiNJ2dE3Hr1lzxC2a++6dLRLGqQ=="],
-
-    "ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
-
-    "ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="],
-
-    "balanced-match": ["balanced-match@4.0.4", "", {}, "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA=="],
-
-    "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="],
-
-    "bindings": ["bindings@1.5.0", "", { "dependencies": { "file-uri-to-path": "1.0.0" } }, "sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ=="],
-
-    "bl": ["bl@4.1.0", "", { "dependencies": { "buffer": "^5.5.0", "inherits": "^2.0.4", "readable-stream": "^3.4.0" } }, "sha512-1W07cM9gS6DcLperZfFSj+bWLtaPGSOHWhPiGzXmvVJbRLdG82sH/Kn8EtW1VqWVA54AKf2h5k5BbnIbwF3h6w=="],
-
-    "bluebird": ["bluebird@3.7.2", "", {}, "sha512-XpNj6GDQzdfW+r2Wnn7xiSAd7TM3jzkxGXBGTtWKuSXv1xUV+azxAm8jdWZN06QTQk+2N2XB9jRDkvbmQmcRtg=="],
-
-    "brace-expansion": ["brace-expansion@5.0.3", "", { "dependencies": { "balanced-match": "^4.0.2" } }, "sha512-fy6KJm2RawA5RcHkLa1z/ScpBeA762UF9KmZQxwIbDtRJrgLzM10depAiEQ+CXYcoiqW1/m96OAAoke2nE9EeA=="],
-
-    "buffer": ["buffer@5.7.1", "", { "dependencies": { "base64-js": "^1.3.1", "ieee754": "^1.1.13" } }, "sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ=="],
-
-    "chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],
-
-    "chardet": ["chardet@2.1.1", "", {}, "sha512-PsezH1rqdV9VvyNhxxOW32/d75r01NY7TQCmOqomRo15ZSOKbpTFVsfjghxo6JloQUCGnH4k1LGu0R4yCLlWQQ=="],
-
-    "cli-cursor": ["cli-cursor@3.1.0", "", { "dependencies": { "restore-cursor": "^3.1.0" } }, "sha512-I/zHAwsKf9FqGoXM4WWRACob9+SNukZTd94DWF57E4toouRulbCxcUh6RKUEOQlYTHJnzkPMySvPNaaSLNfLZw=="],
-
-    "cli-spinners": ["cli-spinners@2.9.2", "", {}, "sha512-ywqV+5MmyL4E7ybXgKys4DugZbX0FC6LnwrhjuykIjnK9k8OQacQ7axGKnjDXWNhns0xot3bZI5h55H8yo9cJg=="],
-
-    "cli-width": ["cli-width@4.1.0", "", {}, "sha512-ouuZd4/dm2Sw5Gmqy6bGyNNNe1qt9RpmxveLSO7KcgsTnU7RXfsw+/bukWGo1abgBiMAic068rclZsO4IWmmxQ=="],
-
-    "clone": ["clone@1.0.4", "", {}, "sha512-JQHZ2QMW6l3aH/j6xCqQThY/9OH4D/9ls34cgkUBiEeocRTU04tHfKPBsUK1PqZCUQM7GiA0IIXJSuXHI64Kbg=="],
-
-    "color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
-
-    "color-name": ["color-name@1.1.4", "", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="],
-
-    "core-util-is": ["core-util-is@1.0.3", "", {}, "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ=="],
-
-    "deasync": ["deasync@0.1.31", "", { "dependencies": { "bindings": "^1.5.0", "node-addon-api": "^1.7.1" } }, "sha512-/6/cXqkw4LPqBVK6H0Y3L4zT7yI3pxykxPXErQ2tDCw0LJyThWL5VpBCpUOWX0vPq2OnF1pzcXvlNnvCiOQJuA=="],
-
-    "defaults": ["defaults@1.0.4", "", { "dependencies": { "clone": "^1.0.2" } }, "sha512-eFuaLoy/Rxalv2kr+lqMlUnrDWV+3j4pljOIJgLIhI058IQfWJ7vXhyEIHu+HtC738klGALYxOKDO0bQP3tg8A=="],
-
-    "dotenv": ["dotenv@17.4.2", "", {}, "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw=="],
-
-    "duplexer2": ["duplexer2@0.1.4", "", { "dependencies": { "readable-stream": "^2.0.2" } }, "sha512-asLFVfWWtJ90ZyOUHMqk7/S2w2guQKxUI2itj3d92ADHhxUSbCMGi1f1cBcJ7xM1To+pE/Khbwo1yuNbMEPKeA=="],
-
-    "fast-string-truncated-width": ["fast-string-truncated-width@3.0.3", "", {}, "sha512-0jjjIEL6+0jag3l2XWWizO64/aZVtpiGE3t0Zgqxv0DPuxiMjvB3M24fCyhZUO4KomJQPj3LTSUnDP3GpdwC0g=="],
-
-    "fast-string-width": ["fast-string-width@3.0.2", "", { "dependencies": { "fast-string-truncated-width": "^3.0.2" } }, "sha512-gX8LrtNEI5hq8DVUfRQMbr5lpaS4nMIWV+7XEbXk2b8kiQIizgnlr12B4dA3ZEx3308ze0O4Q1R+cHts8kyUJg=="],
-
-    "fast-wrap-ansi": ["fast-wrap-ansi@0.2.0", "", { "dependencies": { "fast-string-width": "^3.0.2" } }, "sha512-rLV8JHxTyhVmFYhBJuMujcrHqOT2cnO5Zxj37qROj23CP39GXubJRBUFF0z8KFK77Uc0SukZUf7JZhsVEQ6n8w=="],
-
-    "file-uri-to-path": ["file-uri-to-path@1.0.0", "", {}, "sha512-0Zt+s3L7Vf1biwWZ29aARiVYLx7iMGnEUl9x33fbB/j3jR81u/O2LbqK+Bm1CDSNDKVtJ/YjwY7TUd5SkeLQLw=="],
-
-    "follow-redirects": ["follow-redirects@1.16.0", "", {}, "sha512-y5rN/uOsadFT/JfYwhxRS5R7Qce+g3zG97+JrtFZlC9klX/W5hD7iiLzScI4nZqUS7DNUdhPgw4xI8W2LuXlUw=="],
-
-    "fs-extra": ["fs-extra@11.3.5", "", { "dependencies": { "graceful-fs": "^4.2.0", "jsonfile": "^6.0.1", "universalify": "^2.0.0" } }, "sha512-eKpRKAovdpZtR1WopLHxlBWvAgPny3c4gX1G5Jhwmmw4XJj0ifSD5qB5TOo8hmA0wlRKDAOAhEE1yVPgs6Fgcg=="],
-
-    "glob": ["glob@13.0.6", "", { "dependencies": { "minimatch": "^10.2.2", "minipass": "^7.1.3", "path-scurry": "^2.0.2" } }, "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw=="],
-
-    "graceful-fs": ["graceful-fs@4.2.11", "", {}, "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ=="],
-
-    "has-flag": ["has-flag@4.0.0", "", {}, "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="],
-
-    "iconv-lite": ["iconv-lite@0.7.2", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3.0.0" } }, "sha512-im9DjEDQ55s9fL4EYzOAv0yMqmMBSZp6G0VvFyTMPKWxiSBHUj9NW/qqLmXUwXrrM7AvqSlTCfvqRb0cM8yYqw=="],
-
-    "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="],
-
-    "inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],
-
-    "is-interactive": ["is-interactive@1.0.0", "", {}, "sha512-2HvIEKRoqS62guEC+qBjpvRubdX910WCMuJTZ+I9yvqKU2/12eSL549HMwtabb4oupdj2sMP50k+XJfB/8JE6w=="],
-
-    "is-unicode-supported": ["is-unicode-supported@0.1.0", "", {}, "sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw=="],
-
-    "isarray": ["isarray@1.0.0", "", {}, "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ=="],
-
-    "jsonfile": ["jsonfile@6.2.0", "", { "dependencies": { "universalify": "^2.0.0" }, "optionalDependencies": { "graceful-fs": "^4.1.6" } }, "sha512-FGuPw30AdOIUTRMC2OMRtQV+jkVj2cfPqSeWXv1NEAJ1qZ5zb1X6z1mFhbfOB/iy3ssJCD+3KuZ8r8C3uVFlAg=="],
-
-    "log-symbols": ["log-symbols@4.1.0", "", { "dependencies": { "chalk": "^4.1.0", "is-unicode-supported": "^0.1.0" } }, "sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg=="],
-
-    "lru-cache": ["lru-cache@11.2.1", "", {}, "sha512-r8LA6i4LP4EeWOhqBaZZjDWwehd1xUJPCJd9Sv300H0ZmcUER4+JPh7bqqZeqs1o5pgtgvXm+d9UGrB5zZGDiQ=="],
-
-    "mimic-fn": ["mimic-fn@2.1.0", "", {}, "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg=="],
-
-    "minimatch": ["minimatch@10.2.2", "", { "dependencies": { "brace-expansion": "^5.0.2" } }, "sha512-+G4CpNBxa5MprY+04MbgOw1v7So6n5JY166pFi9KfYwT78fxScCeSNQSNzp6dpPSW2rONOps6Ocam1wFhCgoVw=="],
-
-    "minipass": ["minipass@7.1.3", "", {}, "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A=="],
-
-    "mute-stream": ["mute-stream@3.0.0", "", {}, "sha512-dkEJPVvun4FryqBmZ5KhDo0K9iDXAwn08tMLDinNdRBNPcYEDiWYysLcc6k3mjTMlbP9KyylvRpd4wFtwrT9rw=="],
-
-    "node-addon-api": ["node-addon-api@1.7.2", "", {}, "sha512-ibPK3iA+vaY1eEjESkQkM0BbCqFOaZMiXRTtdB0u7b4djtY6JnsjvPdUHVMg6xQt3B8fpTTWHI9A+ADjM9frzg=="],
-
-    "node-int64": ["node-int64@0.4.0", "", {}, "sha512-O5lz91xSOeoXP6DulyHfllpq+Eg00MWitZIbtPfoSEvqIHdl5gfcY6hYzDWnj0qD5tz52PI08u9qUvSVeUBeHw=="],
-
-    "onetime": ["onetime@5.1.2", "", { "dependencies": { "mimic-fn": "^2.1.0" } }, "sha512-kbpaSSGJTWdAY5KPVeMOKXSrPtr8C8C7wodJbcsd51jRnmD+GZu8Y0VoU6Dm5Z4vWr0Ig/1NKuWRKf7j5aaYSg=="],
-
-    "ora": ["ora@5.4.1", "", { "dependencies": { "bl": "^4.1.0", "chalk": "^4.1.0", "cli-cursor": "^3.1.0", "cli-spinners": "^2.5.0", "is-interactive": "^1.0.0", "is-unicode-supported": "^0.1.0", "log-symbols": "^4.1.0", "strip-ansi": "^6.0.0", "wcwidth": "^1.0.1" } }, "sha512-5b6Y85tPxZZ7QytO+BQzysW31HJku27cRIlkbAXaNx+BdcVi+LlRFmVXzeF6a7JCwJpyw5c4b+YSVImQIrBpuQ=="],
-
-    "path-scurry": ["path-scurry@2.0.2", "", { "dependencies": { "lru-cache": "^11.0.0", "minipass": "^7.1.2" } }, "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg=="],
-
-    "process-nextick-args": ["process-nextick-args@2.0.1", "", {}, "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag=="],
-
-    "readable-stream": ["readable-stream@3.6.2", "", { "dependencies": { "inherits": "^2.0.3", "string_decoder": "^1.1.1", "util-deprecate": "^1.0.1" } }, "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA=="],
-
-    "restore-cursor": ["restore-cursor@3.1.0", "", { "dependencies": { "onetime": "^5.1.0", "signal-exit": "^3.0.2" } }, "sha512-l+sSefzHpj5qimhFSE5a8nufZYAM3sBSVMAPtYkmC+4EH2anSGaEMXSD0izRQbu9nfyQ9y5JrVmp7E8oZrUjvA=="],
-
-    "safe-buffer": ["safe-buffer@5.1.2", "", {}, "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g=="],
-
-    "safer-buffer": ["safer-buffer@2.1.2", "", {}, "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg=="],
-
-    "signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
-
-    "string_decoder": ["string_decoder@1.1.1", "", { "dependencies": { "safe-buffer": "~5.1.0" } }, "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg=="],
-
-    "strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
-
-    "supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="],
-
-    "universalify": ["universalify@2.0.1", "", {}, "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw=="],
-
-    "unzipper": ["unzipper@0.12.3", "", { "dependencies": { "bluebird": "~3.7.2", "duplexer2": "~0.1.4", "fs-extra": "^11.2.0", "graceful-fs": "^4.2.2", "node-int64": "^0.4.0" } }, "sha512-PZ8hTS+AqcGxsaQntl3IRBw65QrBI6lxzqDEL7IAo/XCEqRTKGfOX56Vea5TH9SZczRVxuzk1re04z/YjuYCJA=="],
-
-    "util-deprecate": ["util-deprecate@1.0.2", "", {}, "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw=="],
-
-    "wcwidth": ["wcwidth@1.0.1", "", { "dependencies": { "defaults": "^1.0.3" } }, "sha512-XHPEwS0q6TaxcvG85+8EYkbiCux2XtWG2mkc47Ng2A77BQu9+DqIOJldST4HgPkuea7dvKSj5VgX3P1d4rW8Tg=="],
-
-    "duplexer2/readable-stream": ["readable-stream@2.3.8", "", { "dependencies": { "core-util-is": "~1.0.0", "inherits": "~2.0.3", "isarray": "~1.0.0", "process-nextick-args": "~2.0.0", "safe-buffer": "~5.1.1", "string_decoder": "~1.1.1", "util-deprecate": "~1.0.1" } }, "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA=="],
-
-    "restore-cursor/signal-exit": ["signal-exit@3.0.7", "", {}, "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ=="],
-
-    "unzipper/fs-extra": ["fs-extra@11.3.2", "", { "dependencies": { "graceful-fs": "^4.2.0", "jsonfile": "^6.0.1", "universalify": "^2.0.0" } }, "sha512-Xr9F6z6up6Ws+NjzMCZc6WXg2YFRlrLP9NQDO3VQrWrfiojdhS56TzueT88ze0uBdCTwEIhQ3ptnmKeWGFAe0A=="],
-  }
-}

package/dbcube.config.js

@@ -1,15 +0,0 @@
-require('dotenv').config({ quiet: true });
-
-    module.exports = function (config) {
-        config.set({
-            databases: {
-                test: {
-                    type: "sqlite",
-                    config:{
-                        DATABASE: process.env.DBCUBE_TEST_DATABASE
-                    }
-                },
-            }
-        });  
-    };
-    

package/pnpm-workspace.yaml

@@ -1,3 +0,0 @@
-onlyBuiltDependencies:
-  - '@dbcube/core'
-  - better-sqlite3

package/test-new-features.js

@@ -1,129 +0,0 @@
-/**
- * End-to-end test of the new query-builder features against the local
- * SQLite test database (daemon mode + transactions + new methods).
- * Run: node test-new-features.js
- */
-const { Database } = require('@dbcube/query-builder');
-
-const results = [];
-function check(name, condition, detail = '') {
-    results.push({ name, ok: !!condition, detail });
-    console.log(`${condition ? '✅' : '❌'} ${name}${detail ? ` — ${detail}` : ''}`);
-}
-
-async function main() {
-    const db = new Database('test');
-    const t0 = Date.now();
-
-    // 0. Clean slate for the test table via raw()
-    await db.raw('DROP TABLE IF EXISTS qa_items');
-    await db.raw('CREATE TABLE qa_items (uuid TEXT, id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT NOT NULL, qty INTEGER DEFAULT 0, price REAL)');
-    check('raw(): DDL ejecutado', true);
-
-    // 1. insert
-    const inserted = await db.table('qa_items').insert([
-        { name: 'alpha', qty: 10, price: 5.5 },
-        { name: 'beta', qty: 3, price: 2.0 },
-        { name: 'gamma', qty: 0, price: 9.9 },
-    ]);
-    check('insert(): 3 filas', Array.isArray(inserted));
-
-    // 2. raw with params
-    const rawRows = await db.raw('SELECT * FROM qa_items WHERE qty > ?', [1]);
-    check('raw() con parámetros', Array.isArray(rawRows) && rawRows.length === 2, `${rawRows.length} filas`);
-
-    // 3. exists / whereNotIn / offset
-    const hasAlpha = await db.table('qa_items').where('name', '=', 'alpha').exists();
-    const noDelta = await db.table('qa_items').where('name', '=', 'delta').exists();
-    check('exists()', hasAlpha === true && noDelta === false);
-
-    const notIn = await db.table('qa_items').whereNotIn('name', ['alpha']).get();
-    check('whereNotIn()', notIn.length === 2, `${notIn.length} filas`);
-
-    const offsetRows = await db.table('qa_items').orderBy('id', 'ASC').limit(10).offset(1).get();
-    check('offset()', offsetRows.length === 2 && offsetRows[0].name === 'beta');
-
-    // 4. paginate
-    const page = await db.table('qa_items').orderBy('id', 'ASC').paginate(1, 2);
-    check('paginate()', page.items.length === 2 && page.total === 3 && page.totalPages === 2 && page.hasNext === true,
-        JSON.stringify({ total: page.total, pages: page.totalPages }));
-
-    // 5. chunk
-    let chunkTotal = 0, chunkCalls = 0;
-    await db.table('qa_items').orderBy('id', 'ASC').chunk(2, rows => { chunkTotal += rows.length; chunkCalls++; });
-    check('chunk()', chunkTotal === 3 && chunkCalls === 2, `${chunkCalls} lotes, ${chunkTotal} filas`);
-
-    // 6. increment / decrement (atómico)
-    await db.table('qa_items').where('name', '=', 'beta').increment('qty', 5);
-    await db.table('qa_items').where('name', '=', 'alpha').decrement('qty', 4);
-    const beta = await db.table('qa_items').find('beta', 'name');
-    const alpha = await db.table('qa_items').find('alpha', 'name');
-    check('increment()/decrement()', beta.qty === 8 && alpha.qty === 6, `beta=${beta.qty} alpha=${alpha.qty}`);
-
-    // 7. upsert (SQLite necesita UNIQUE en la clave de conflicto)
-    await db.raw('CREATE UNIQUE INDEX IF NOT EXISTS qa_items_name ON qa_items(name)');
-    await db.table('qa_items').upsert([{ name: 'alpha', qty: 100, price: 1.0 }, { name: 'delta', qty: 7, price: 3.3 }], ['name']);
-    const alphaUp = await db.table('qa_items').find('alpha', 'name');
-    const delta = await db.table('qa_items').find('delta', 'name');
-    check('upsert()', alphaUp.qty === 100 && delta !== null, `alpha.qty=${alphaUp.qty}, delta insertado=${delta !== null}`);
-
-    // 8. having + selectRaw + groupBy
-    const grouped = await db.table('qa_items')
-        .selectRaw(['CASE WHEN qty > 5 THEN \'high\' ELSE \'low\' END AS bucket', 'COUNT(*) AS n'])
-        .groupBy('bucket')
-        .having('n', '>', 1)
-        .get();
-    check('selectRaw()+groupBy()+having()', Array.isArray(grouped) && grouped.length >= 1, JSON.stringify(grouped));
-
-    // 9. transaction commit
-    await db.transaction(async (trx) => {
-        await trx.table('qa_items').where('name', '=', 'beta').update({ price: 111 });
-        await trx.table('qa_items').insert([{ name: 'epsilon', qty: 1, price: 0.5 }]);
-    });
-    const betaTx = await db.table('qa_items').find('beta', 'name');
-    const eps = await db.table('qa_items').find('epsilon', 'name');
-    check('transaction() commit', betaTx.price === 111 && eps !== null);
-
-    // 10. transaction rollback
-    let rolledBack = false;
-    try {
-        await db.transaction(async (trx) => {
-            await trx.table('qa_items').where('name', '=', 'beta').update({ price: 999 });
-            throw new Error('forced failure');
-        });
-    } catch (e) {
-        rolledBack = e.message === 'forced failure';
-    }
-    const betaRb = await db.table('qa_items').find('beta', 'name');
-    check('transaction() rollback', rolledBack && betaRb.price === 111, `price=${betaRb.price} (esperado 111)`);
-
-    // 11. truncate
-    await db.raw('CREATE TABLE IF NOT EXISTS qa_tmp (uuid TEXT, id INTEGER PRIMARY KEY AUTOINCREMENT, v TEXT)');
-    await db.table('qa_tmp').insert([{ v: 'x' }, { v: 'y' }]);
-    await db.table('qa_tmp').truncate();
-    const tmpCount = await db.table('qa_tmp').count();
-    check('truncate()', Number(tmpCount) === 0);
-
-    // 12. Velocidad: 30 queries seguidas (daemon vs spawn)
-    const n = 30;
-    const t1 = Date.now();
-    for (let i = 0; i < n; i++) {
-        await db.table('qa_items').where('qty', '>', 0).limit(1).get();
-    }
-    const elapsed = Date.now() - t1;
-    const avg = (elapsed / n).toFixed(1);
-    check('velocidad: 30 queries seguidas', true, `${elapsed}ms total → ${avg}ms/query promedio`);
-
-    // Cleanup
-    await db.raw('DROP TABLE IF EXISTS qa_items');
-    await db.raw('DROP TABLE IF EXISTS qa_tmp');
-
-    const failed = results.filter(r => !r.ok);
-    console.log(`\n${failed.length === 0 ? '🎉 TODOS LOS TESTS PASARON' : `❌ ${failed.length} fallos`} (${results.length} checks, ${Date.now() - t0}ms)`);
-    process.exit(failed.length === 0 ? 0 : 1);
-}
-
-main().catch(e => {
-    console.error('💥 Test crashed:', e.message);
-    process.exit(1);
-});