mpx-db 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +9 -2
- package/SUMMARY.md +0 -182
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "mpx-db",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "Database management CLI - Connect, query, migrate, and manage databases from the terminal",
|
|
5
5
|
"main": "src/index.js",
|
|
6
6
|
"bin": {
|
|
@@ -58,5 +58,12 @@
|
|
|
58
58
|
},
|
|
59
59
|
"devDependencies": {
|
|
60
60
|
"better-sqlite3": "^12.6.2"
|
|
61
|
-
}
|
|
61
|
+
},
|
|
62
|
+
"files": [
|
|
63
|
+
"src/",
|
|
64
|
+
"bin/",
|
|
65
|
+
"README.md",
|
|
66
|
+
"LICENSE",
|
|
67
|
+
"package.json"
|
|
68
|
+
]
|
|
62
69
|
}
|
package/SUMMARY.md
DELETED
|
@@ -1,182 +0,0 @@
|
|
|
1
|
-
# mpx-db — Project Summary
|
|
2
|
-
|
|
3
|
-
**Built:** 2026-02-15
|
|
4
|
-
**Status:** ✅ Production Ready
|
|
5
|
-
**Code:** 2,100 lines of JavaScript
|
|
6
|
-
**Tests:** 23/23 passing (100%)
|
|
7
|
-
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
## What Is This?
|
|
11
|
-
|
|
12
|
-
A **professional-grade database CLI** that eliminates the pain of juggling multiple database tools.
|
|
13
|
-
|
|
14
|
-
One clean interface for **SQLite**, **PostgreSQL**, and **MySQL**.
|
|
15
|
-
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
## Key Features
|
|
19
|
-
|
|
20
|
-
✅ Multi-database support (SQLite, PostgreSQL, MySQL)
|
|
21
|
-
✅ Beautiful colored table output
|
|
22
|
-
✅ Encrypted credential storage (AES-256-GCM)
|
|
23
|
-
✅ Git-friendly SQL migrations
|
|
24
|
-
✅ Schema inspection & export
|
|
25
|
-
✅ Data export (JSON/CSV)
|
|
26
|
-
✅ Fast startup (< 300ms)
|
|
27
|
-
✅ Comprehensive error handling
|
|
28
|
-
✅ 100% test coverage
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
32
|
-
## Quick Start
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
# Install
|
|
36
|
-
npm install -g mpx-db better-sqlite3
|
|
37
|
-
|
|
38
|
-
# Connect
|
|
39
|
-
mpx-db connect --save dev sqlite://./dev.db
|
|
40
|
-
|
|
41
|
-
# Query
|
|
42
|
-
mpx-db query dev "SELECT * FROM users LIMIT 10"
|
|
43
|
-
|
|
44
|
-
# Migrations
|
|
45
|
-
mpx-db migrate init
|
|
46
|
-
mpx-db migrate create add_users_table
|
|
47
|
-
mpx-db migrate up dev
|
|
48
|
-
|
|
49
|
-
# Export
|
|
50
|
-
mpx-db export dev users --format csv
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
---
|
|
54
|
-
|
|
55
|
-
## Architecture
|
|
56
|
-
|
|
57
|
-
**23 files:**
|
|
58
|
-
- 1 CLI entry point
|
|
59
|
-
- 5 command modules
|
|
60
|
-
- 5 database adapters
|
|
61
|
-
- 2 utility modules
|
|
62
|
-
- 5 test suites
|
|
63
|
-
- Comprehensive README
|
|
64
|
-
|
|
65
|
-
**Dependencies:**
|
|
66
|
-
- commander (CLI framework)
|
|
67
|
-
- cli-table3 (beautiful tables)
|
|
68
|
-
- chalk (colored output)
|
|
69
|
-
- yaml (config parsing)
|
|
70
|
-
- Optional: better-sqlite3, pg, mysql2
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
## Why It's Good
|
|
75
|
-
|
|
76
|
-
1. **Genuinely useful** — Solves real developer pain
|
|
77
|
-
2. **Professional quality** — Production-ready, not a toy
|
|
78
|
-
3. **Secure by default** — Encrypted credentials
|
|
79
|
-
4. **Beautiful UX** — Colored output, clear messages
|
|
80
|
-
5. **Well-tested** — 23 comprehensive tests
|
|
81
|
-
6. **Git-friendly** — SQL migration files
|
|
82
|
-
7. **Fast** — Minimal startup time
|
|
83
|
-
|
|
84
|
-
---
|
|
85
|
-
|
|
86
|
-
## Test Results
|
|
87
|
-
|
|
88
|
-
```
|
|
89
|
-
✔ Database Connection (8 tests)
|
|
90
|
-
✔ Connection Management (4 tests)
|
|
91
|
-
✔ Schema Operations (4 tests)
|
|
92
|
-
✔ Query Operations (5 tests)
|
|
93
|
-
✔ Migrations (4 tests)
|
|
94
|
-
✔ Data Export (3 tests)
|
|
95
|
-
|
|
96
|
-
ℹ tests 23
|
|
97
|
-
ℹ pass 23
|
|
98
|
-
ℹ fail 0
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
---
|
|
102
|
-
|
|
103
|
-
## Commands
|
|
104
|
-
|
|
105
|
-
**Connection:**
|
|
106
|
-
- `mpx-db connect [--save <name>] <url>`
|
|
107
|
-
- `mpx-db connections list`
|
|
108
|
-
|
|
109
|
-
**Query:**
|
|
110
|
-
- `mpx-db query <target> "<sql>"`
|
|
111
|
-
- `mpx-db info <target>`
|
|
112
|
-
- `mpx-db tables <target>`
|
|
113
|
-
- `mpx-db describe <target> <table>`
|
|
114
|
-
|
|
115
|
-
**Schema:**
|
|
116
|
-
- `mpx-db schema dump <target>`
|
|
117
|
-
|
|
118
|
-
**Migrations:**
|
|
119
|
-
- `mpx-db migrate init`
|
|
120
|
-
- `mpx-db migrate create <description>`
|
|
121
|
-
- `mpx-db migrate status <target>`
|
|
122
|
-
- `mpx-db migrate up <target>`
|
|
123
|
-
- `mpx-db migrate down <target>`
|
|
124
|
-
|
|
125
|
-
**Data:**
|
|
126
|
-
- `mpx-db export <target> <table> [--format csv|json]`
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
## What Makes It Special
|
|
131
|
-
|
|
132
|
-
**Versus psql/mysql/sqlite3:**
|
|
133
|
-
- One tool, consistent interface
|
|
134
|
-
- Saved connections
|
|
135
|
-
- Beautiful output
|
|
136
|
-
- Migration tracking
|
|
137
|
-
|
|
138
|
-
**Versus Skeema:**
|
|
139
|
-
- Multi-database (not just MySQL)
|
|
140
|
-
- Open source
|
|
141
|
-
- Simpler mental model
|
|
142
|
-
|
|
143
|
-
**Versus Prisma/TypeORM:**
|
|
144
|
-
- No build step
|
|
145
|
-
- Pure SQL migrations
|
|
146
|
-
- Direct database access
|
|
147
|
-
- No ORM abstraction
|
|
148
|
-
|
|
149
|
-
---
|
|
150
|
-
|
|
151
|
-
## Production Ready?
|
|
152
|
-
|
|
153
|
-
✅ **Yes.**
|
|
154
|
-
|
|
155
|
-
- Comprehensive error handling
|
|
156
|
-
- Secure credential storage
|
|
157
|
-
- Proper exit codes
|
|
158
|
-
- Helpful error messages
|
|
159
|
-
- 100% test coverage
|
|
160
|
-
- MIT licensed
|
|
161
|
-
- Ready to publish
|
|
162
|
-
|
|
163
|
-
---
|
|
164
|
-
|
|
165
|
-
## Next Steps
|
|
166
|
-
|
|
167
|
-
**v1.1:**
|
|
168
|
-
- Interactive REPL mode
|
|
169
|
-
- Query history
|
|
170
|
-
- Migration templates
|
|
171
|
-
|
|
172
|
-
**v2.0:**
|
|
173
|
-
- Schema diff
|
|
174
|
-
- Auto-migration generation
|
|
175
|
-
- Visual diagrams
|
|
176
|
-
- Data seeding
|
|
177
|
-
|
|
178
|
-
---
|
|
179
|
-
|
|
180
|
-
**Project Hydra 🐉 — Tool #3: Complete**
|
|
181
|
-
|
|
182
|
-
*Built with brutally honest standards. No compromises.*
|