mpx-db 1.0.0 → 1.0.3

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "mpx-db",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Database management CLI - Connect, query, migrate, and manage databases from the terminal",
   "main": "src/index.js",
   "bin": {
-    "mpx-db": "./bin/mpx-db.js"
+    "mpx-db": "bin/mpx-db.js"
   },
   "type": "module",
   "scripts": {
@@ -26,7 +26,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mesaplexdev/mpx-db"
+    "url": "git+https://github.com/mesaplexdev/mpx-db.git"
   },
   "homepage": "https://github.com/mesaplexdev/mpx-db#readme",
   "bugs": "https://github.com/mesaplexdev/mpx-db/issues",
@@ -34,6 +34,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
+    "better-sqlite3": "^12.6.2",
     "chalk": "^5.3.0",
     "cli-table3": "^0.6.5",
     "commander": "^12.1.0",
@@ -41,14 +42,10 @@
     "yaml": "^2.6.1"
   },
   "peerDependencies": {
-    "better-sqlite3": "^11.0.0",
     "mysql2": "^3.11.5",
     "pg": "^8.13.1"
   },
   "peerDependenciesMeta": {
-    "better-sqlite3": {
-      "optional": true
-    },
     "pg": {
       "optional": true
     },
@@ -56,7 +53,11 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "better-sqlite3": "^12.6.2"
-  }
+  "files": [
+    "src/",
+    "bin/",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ]
 }

package/src/cli.js

@@ -1,5 +1,8 @@
 import { Command } from 'commander';
 import chalk from 'chalk';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 import { handleConnect, listConnections, removeConnection } from './commands/connections.js';
 import { handleQuery } from './commands/query.js';
 import { showInfo, listTables, describeTable, dumpSchema } from './commands/schema.js';
@@ -12,12 +15,16 @@ import {
 } from './commands/migrate.js';
 import { exportData } from './commands/data.js';
 
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+
 const program = new Command();
 
 program
   .name('mpx-db')
   .description('Database management CLI - Connect, query, migrate, and manage databases')
-  .version('1.0.0');
+  .version(pkg.version);
 
 // Connect command
 program
@@ -134,6 +141,10 @@ program.exitOverride();
 try {
   await program.parseAsync(process.argv);
 } catch (err) {
+  // Ignore help and version display "errors"
+  if (err.code === 'commander.version') {
+    process.exit(0);
+  }
   if (err.code !== 'commander.help' && err.code !== 'commander.helpDisplayed') {
     console.error(chalk.red(`Error: ${err.message}`));
     process.exit(1);

package/src/commands/query.js

@@ -4,7 +4,7 @@ import { getConnection } from '../utils/config.js';
 import { createConnection } from '../db/connection.js';
 
 /**
- * Execute a query
+ * Execute a query or statement
  */
 export async function handleQuery(target, sql, options) {
   let db;
@@ -16,20 +16,38 @@ export async function handleQuery(target, sql, options) {
     // Connect
     db = await createConnection(connectionString);
     
-    // Execute query
+    // Determine if this is a SELECT query or a DML/DDL statement
+    const isSelectQuery = isQueryStatement(sql);
+    
+    // Execute
     const startTime = Date.now();
-    const rows = await db.query(sql);
-    const duration = Date.now() - startTime;
     
-    // Display results
-    if (rows.length === 0) {
-      console.log(chalk.yellow('No rows returned'));
+    if (isSelectQuery) {
+      // SELECT, PRAGMA, EXPLAIN, WITH - returns rows
+      const rows = await db.query(sql);
+      const duration = Date.now() - startTime;
+      
+      // Display results
+      if (rows.length === 0) {
+        console.log(chalk.yellow('No rows returned'));
+      } else {
+        displayTable(rows);
+      }
+      
+      console.log(chalk.gray(`\n${rows.length} row(s) in ${duration}ms`));
     } else {
-      displayTable(rows);
+      // INSERT, UPDATE, DELETE, CREATE, DROP, ALTER - returns affected rows
+      const result = await db.execute(sql);
+      const duration = Date.now() - startTime;
+      
+      console.log(chalk.green('✓ Statement executed successfully'));
+      console.log(chalk.gray(`  Affected rows: ${result.affectedRows}`));
+      if (result.insertId) {
+        console.log(chalk.gray(`  Insert ID: ${result.insertId}`));
+      }
+      console.log(chalk.gray(`  Duration: ${duration}ms`));
     }
     
-    console.log(chalk.gray(`\n${rows.length} row(s) in ${duration}ms`));
-    
   } catch (err) {
     console.error(chalk.red('✗ Query failed'));
     console.error(chalk.red(`  ${err.message}`));
@@ -41,6 +59,24 @@ export async function handleQuery(target, sql, options) {
   }
 }
 
+/**
+ * Determine if SQL is a query (returns rows) or a statement (modifies data)
+ */
+function isQueryStatement(sql) {
+  const trimmed = sql.trim().toUpperCase();
+  
+  // These keywords indicate a query that returns rows
+  const queryKeywords = ['SELECT', 'PRAGMA', 'EXPLAIN', 'WITH', 'SHOW', 'DESCRIBE', 'DESC'];
+  
+  for (const keyword of queryKeywords) {
+    if (trimmed.startsWith(keyword)) {
+      return true;
+    }
+  }
+  
+  return false;
+}
+
 /**
  * Display query results as table
  */

package/SUMMARY.md

@@ -1,182 +0,0 @@
-# mpx-db — Project Summary
-
-**Built:** 2026-02-15  
-**Status:** ✅ Production Ready  
-**Code:** 2,100 lines of JavaScript  
-**Tests:** 23/23 passing (100%)
-
----
-
-## What Is This?
-
-A **professional-grade database CLI** that eliminates the pain of juggling multiple database tools.
-
-One clean interface for **SQLite**, **PostgreSQL**, and **MySQL**.
-
----
-
-## Key Features
-
-✅ Multi-database support (SQLite, PostgreSQL, MySQL)  
-✅ Beautiful colored table output  
-✅ Encrypted credential storage (AES-256-GCM)  
-✅ Git-friendly SQL migrations  
-✅ Schema inspection & export  
-✅ Data export (JSON/CSV)  
-✅ Fast startup (< 300ms)  
-✅ Comprehensive error handling  
-✅ 100% test coverage
-
----
-
-## Quick Start
-
-```bash
-# Install
-npm install -g mpx-db better-sqlite3
-
-# Connect
-mpx-db connect --save dev sqlite://./dev.db
-
-# Query
-mpx-db query dev "SELECT * FROM users LIMIT 10"
-
-# Migrations
-mpx-db migrate init
-mpx-db migrate create add_users_table
-mpx-db migrate up dev
-
-# Export
-mpx-db export dev users --format csv
-```
-
----
-
-## Architecture
-
-**23 files:**
-- 1 CLI entry point
-- 5 command modules
-- 5 database adapters
-- 2 utility modules
-- 5 test suites
-- Comprehensive README
-
-**Dependencies:**
-- commander (CLI framework)
-- cli-table3 (beautiful tables)
-- chalk (colored output)
-- yaml (config parsing)
-- Optional: better-sqlite3, pg, mysql2
-
----
-
-## Why It's Good
-
-1. **Genuinely useful** — Solves real developer pain
-2. **Professional quality** — Production-ready, not a toy
-3. **Secure by default** — Encrypted credentials
-4. **Beautiful UX** — Colored output, clear messages
-5. **Well-tested** — 23 comprehensive tests
-6. **Git-friendly** — SQL migration files
-7. **Fast** — Minimal startup time
-
----
-
-## Test Results
-
-```
-✔ Database Connection (8 tests)
-✔ Connection Management (4 tests)  
-✔ Schema Operations (4 tests)
-✔ Query Operations (5 tests)
-✔ Migrations (4 tests)
-✔ Data Export (3 tests)
-
-ℹ tests 23
-ℹ pass 23
-ℹ fail 0
-```
-
----
-
-## Commands
-
-**Connection:**
-- `mpx-db connect [--save <name>] <url>`
-- `mpx-db connections list`
-
-**Query:**
-- `mpx-db query <target> "<sql>"`
-- `mpx-db info <target>`
-- `mpx-db tables <target>`
-- `mpx-db describe <target> <table>`
-
-**Schema:**
-- `mpx-db schema dump <target>`
-
-**Migrations:**
-- `mpx-db migrate init`
-- `mpx-db migrate create <description>`
-- `mpx-db migrate status <target>`
-- `mpx-db migrate up <target>`
-- `mpx-db migrate down <target>`
-
-**Data:**
-- `mpx-db export <target> <table> [--format csv|json]`
-
----
-
-## What Makes It Special
-
-**Versus psql/mysql/sqlite3:**
-- One tool, consistent interface
-- Saved connections
-- Beautiful output
-- Migration tracking
-
-**Versus Skeema:**
-- Multi-database (not just MySQL)
-- Open source
-- Simpler mental model
-
-**Versus Prisma/TypeORM:**
-- No build step
-- Pure SQL migrations
-- Direct database access
-- No ORM abstraction
-
----
-
-## Production Ready?
-
-✅ **Yes.**
-
-- Comprehensive error handling
-- Secure credential storage
-- Proper exit codes
-- Helpful error messages
-- 100% test coverage
-- MIT licensed
-- Ready to publish
-
----
-
-## Next Steps
-
-**v1.1:**
-- Interactive REPL mode
-- Query history
-- Migration templates
-
-**v2.0:**
-- Schema diff
-- Auto-migration generation
-- Visual diagrams
-- Data seeding
-
----
-
-**Project Hydra 🐉 — Tool #3: Complete**
-
-*Built with brutally honest standards. No compromises.*