spindb 0.5.2 → 0.5.4

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.
Files changed (38) hide show
  1. package/README.md +188 -9
  2. package/cli/commands/connect.ts +334 -105
  3. package/cli/commands/create.ts +106 -67
  4. package/cli/commands/deps.ts +19 -4
  5. package/cli/commands/edit.ts +245 -0
  6. package/cli/commands/engines.ts +434 -0
  7. package/cli/commands/info.ts +279 -0
  8. package/cli/commands/list.ts +1 -1
  9. package/cli/commands/menu.ts +664 -167
  10. package/cli/commands/restore.ts +11 -25
  11. package/cli/commands/start.ts +25 -20
  12. package/cli/commands/url.ts +79 -0
  13. package/cli/index.ts +9 -3
  14. package/cli/ui/prompts.ts +20 -12
  15. package/cli/ui/theme.ts +1 -1
  16. package/config/engine-defaults.ts +24 -1
  17. package/config/os-dependencies.ts +151 -113
  18. package/config/paths.ts +7 -36
  19. package/core/binary-manager.ts +12 -6
  20. package/core/config-manager.ts +17 -5
  21. package/core/dependency-manager.ts +144 -15
  22. package/core/error-handler.ts +336 -0
  23. package/core/platform-service.ts +634 -0
  24. package/core/port-manager.ts +11 -3
  25. package/core/process-manager.ts +12 -2
  26. package/core/start-with-retry.ts +167 -0
  27. package/core/transaction-manager.ts +170 -0
  28. package/engines/mysql/binary-detection.ts +177 -100
  29. package/engines/mysql/index.ts +240 -131
  30. package/engines/mysql/restore.ts +257 -0
  31. package/engines/mysql/version-validator.ts +373 -0
  32. package/{core/postgres-binary-manager.ts → engines/postgresql/binary-manager.ts} +63 -23
  33. package/engines/postgresql/binary-urls.ts +5 -3
  34. package/engines/postgresql/index.ts +35 -4
  35. package/engines/postgresql/restore.ts +54 -5
  36. package/engines/postgresql/version-validator.ts +262 -0
  37. package/package.json +6 -2
  38. package/cli/commands/postgres-tools.ts +0 -216
@@ -3,130 +3,359 @@ import { spawn } from 'child_process'
3
3
  import chalk from 'chalk'
4
4
  import { containerManager } from '../../core/container-manager'
5
5
  import { processManager } from '../../core/process-manager'
6
+ import {
7
+ isUsqlInstalled,
8
+ isPgcliInstalled,
9
+ isMycliInstalled,
10
+ detectPackageManager,
11
+ installUsql,
12
+ installPgcli,
13
+ installMycli,
14
+ getUsqlManualInstructions,
15
+ getPgcliManualInstructions,
16
+ getMycliManualInstructions,
17
+ } from '../../core/dependency-manager'
6
18
  import { getEngine } from '../../engines'
7
19
  import { getEngineDefaults } from '../../config/defaults'
8
20
  import { promptContainerSelect } from '../ui/prompts'
9
- import { error, warning, info } from '../ui/theme'
21
+ import { error, warning, info, success } from '../ui/theme'
10
22
 
11
23
  export const connectCommand = new Command('connect')
12
24
  .description('Connect to a container with database client')
13
25
  .argument('[name]', 'Container name')
14
26
  .option('-d, --database <name>', 'Database name')
15
- .action(async (name: string | undefined, options: { database?: string }) => {
16
- try {
17
- let containerName = name
27
+ .option('--tui', 'Use usql for enhanced shell experience')
28
+ .option('--install-tui', 'Install usql if not present, then connect')
29
+ .option('--pgcli', 'Use pgcli for enhanced PostgreSQL shell (dropdown auto-completion)')
30
+ .option('--install-pgcli', 'Install pgcli if not present, then connect')
31
+ .option('--mycli', 'Use mycli for enhanced MySQL shell (dropdown auto-completion)')
32
+ .option('--install-mycli', 'Install mycli if not present, then connect')
33
+ .action(
34
+ async (
35
+ name: string | undefined,
36
+ options: {
37
+ database?: string
38
+ tui?: boolean
39
+ installTui?: boolean
40
+ pgcli?: boolean
41
+ installPgcli?: boolean
42
+ mycli?: boolean
43
+ installMycli?: boolean
44
+ },
45
+ ) => {
46
+ try {
47
+ let containerName = name
18
48
 
19
- // Interactive selection if no name provided
20
- if (!containerName) {
21
- const containers = await containerManager.list()
22
- const running = containers.filter((c) => c.status === 'running')
49
+ // Interactive selection if no name provided
50
+ if (!containerName) {
51
+ const containers = await containerManager.list()
52
+ const running = containers.filter((c) => c.status === 'running')
23
53
 
24
- if (running.length === 0) {
25
- if (containers.length === 0) {
26
- console.log(
27
- warning('No containers found. Create one with: spindb create'),
28
- )
29
- } else {
30
- console.log(
31
- warning(
32
- 'No running containers. Start one first with: spindb start',
33
- ),
34
- )
54
+ if (running.length === 0) {
55
+ if (containers.length === 0) {
56
+ console.log(
57
+ warning('No containers found. Create one with: spindb create'),
58
+ )
59
+ } else {
60
+ console.log(
61
+ warning(
62
+ 'No running containers. Start one first with: spindb start',
63
+ ),
64
+ )
65
+ }
66
+ return
35
67
  }
36
- return
68
+
69
+ const selected = await promptContainerSelect(
70
+ running,
71
+ 'Select container to connect to:',
72
+ )
73
+ if (!selected) return
74
+ containerName = selected
37
75
  }
38
76
 
39
- const selected = await promptContainerSelect(
40
- running,
41
- 'Select container to connect to:',
42
- )
43
- if (!selected) return
44
- containerName = selected
45
- }
77
+ // Get container config
78
+ const config = await containerManager.getConfig(containerName)
79
+ if (!config) {
80
+ console.error(error(`Container "${containerName}" not found`))
81
+ process.exit(1)
82
+ }
46
83
 
47
- // Get container config
48
- const config = await containerManager.getConfig(containerName)
49
- if (!config) {
50
- console.error(error(`Container "${containerName}" not found`))
51
- process.exit(1)
52
- }
84
+ const { engine: engineName } = config
85
+ const engineDefaults = getEngineDefaults(engineName)
86
+
87
+ // Default database: container's database or superuser
88
+ const database =
89
+ options.database ?? config.database ?? engineDefaults.superuser
53
90
 
54
- const { engine: engineName } = config
55
- const engineDefaults = getEngineDefaults(engineName)
91
+ // Check if running
92
+ const running = await processManager.isRunning(containerName, {
93
+ engine: engineName,
94
+ })
95
+ if (!running) {
96
+ console.error(
97
+ error(
98
+ `Container "${containerName}" is not running. Start it first.`,
99
+ ),
100
+ )
101
+ process.exit(1)
102
+ }
56
103
 
57
- // Default database: container's database or superuser
58
- const database = options.database ?? config.database ?? engineDefaults.superuser
104
+ // Get engine
105
+ const engine = getEngine(engineName)
106
+ const connectionString = engine.getConnectionString(config, database)
59
107
 
60
- // Check if running
61
- const running = await processManager.isRunning(containerName, {
62
- engine: engineName,
63
- })
64
- if (!running) {
65
- console.error(
66
- error(`Container "${containerName}" is not running. Start it first.`),
67
- )
68
- process.exit(1)
69
- }
108
+ // Handle --tui and --install-tui flags (usql)
109
+ const useUsql = options.tui || options.installTui
110
+ if (useUsql) {
111
+ const usqlInstalled = await isUsqlInstalled()
70
112
 
71
- // Get engine
72
- const engine = getEngine(engineName)
73
- const connectionString = engine.getConnectionString(config, database)
74
-
75
- console.log(info(`Connecting to ${containerName}:${database}...`))
76
- console.log()
77
-
78
- // Build client command based on engine
79
- let clientCmd: string
80
- let clientArgs: string[]
81
-
82
- if (engineName === 'mysql') {
83
- // MySQL: mysql -h 127.0.0.1 -P port -u root database
84
- clientCmd = 'mysql'
85
- clientArgs = [
86
- '-h', '127.0.0.1',
87
- '-P', String(config.port),
88
- '-u', engineDefaults.superuser,
89
- database,
90
- ]
91
- } else {
92
- // PostgreSQL: psql connection_string
93
- clientCmd = 'psql'
94
- clientArgs = [connectionString]
95
- }
113
+ if (!usqlInstalled) {
114
+ if (options.installTui) {
115
+ // Try to install usql
116
+ console.log(
117
+ info('Installing usql for enhanced shell experience...'),
118
+ )
119
+ const pm = await detectPackageManager()
120
+ if (pm) {
121
+ const result = await installUsql(pm)
122
+ if (result.success) {
123
+ console.log(success('usql installed successfully!'))
124
+ console.log()
125
+ } else {
126
+ console.error(
127
+ error(`Failed to install usql: ${result.error}`),
128
+ )
129
+ console.log()
130
+ console.log(chalk.gray('Manual installation:'))
131
+ for (const instruction of getUsqlManualInstructions()) {
132
+ console.log(chalk.cyan(` ${instruction}`))
133
+ }
134
+ process.exit(1)
135
+ }
136
+ } else {
137
+ console.error(error('No supported package manager found'))
138
+ console.log()
139
+ console.log(chalk.gray('Manual installation:'))
140
+ for (const instruction of getUsqlManualInstructions()) {
141
+ console.log(chalk.cyan(` ${instruction}`))
142
+ }
143
+ process.exit(1)
144
+ }
145
+ } else {
146
+ // --tui flag but usql not installed
147
+ console.error(error('usql is not installed'))
148
+ console.log()
149
+ console.log(
150
+ chalk.gray('Install usql for enhanced shell experience:'),
151
+ )
152
+ console.log(chalk.cyan(' spindb connect --install-tui'))
153
+ console.log()
154
+ console.log(chalk.gray('Or install manually:'))
155
+ for (const instruction of getUsqlManualInstructions()) {
156
+ console.log(chalk.cyan(` ${instruction}`))
157
+ }
158
+ process.exit(1)
159
+ }
160
+ }
161
+ }
96
162
 
97
- const clientProcess = spawn(clientCmd, clientArgs, {
98
- stdio: 'inherit',
99
- })
100
-
101
- clientProcess.on('error', (err: NodeJS.ErrnoException) => {
102
- if (err.code === 'ENOENT') {
103
- console.log(warning(`${clientCmd} not found on your system.`))
104
- console.log()
105
- console.log(chalk.gray(' Install client tools or connect manually:'))
106
- console.log(chalk.cyan(` ${connectionString}`))
107
- console.log()
108
-
109
- if (engineName === 'mysql') {
110
- console.log(chalk.gray(' On macOS with Homebrew:'))
111
- console.log(chalk.cyan(' brew install mysql-client'))
112
- } else {
113
- console.log(chalk.gray(' On macOS with Homebrew:'))
114
- console.log(
115
- chalk.cyan(' brew install libpq && brew link --force libpq'),
116
- )
163
+ // Handle --pgcli and --install-pgcli flags
164
+ const usePgcli = options.pgcli || options.installPgcli
165
+ if (usePgcli) {
166
+ if (engineName !== 'postgresql') {
167
+ console.error(error('pgcli is only available for PostgreSQL containers'))
168
+ console.log(chalk.gray('For MySQL, use: spindb connect --mycli'))
169
+ process.exit(1)
117
170
  }
118
- console.log()
171
+
172
+ const pgcliInstalled = await isPgcliInstalled()
173
+
174
+ if (!pgcliInstalled) {
175
+ if (options.installPgcli) {
176
+ console.log(info('Installing pgcli for enhanced PostgreSQL shell...'))
177
+ const pm = await detectPackageManager()
178
+ if (pm) {
179
+ const result = await installPgcli(pm)
180
+ if (result.success) {
181
+ console.log(success('pgcli installed successfully!'))
182
+ console.log()
183
+ } else {
184
+ console.error(error(`Failed to install pgcli: ${result.error}`))
185
+ console.log()
186
+ console.log(chalk.gray('Manual installation:'))
187
+ for (const instruction of getPgcliManualInstructions()) {
188
+ console.log(chalk.cyan(` ${instruction}`))
189
+ }
190
+ process.exit(1)
191
+ }
192
+ } else {
193
+ console.error(error('No supported package manager found'))
194
+ console.log()
195
+ console.log(chalk.gray('Manual installation:'))
196
+ for (const instruction of getPgcliManualInstructions()) {
197
+ console.log(chalk.cyan(` ${instruction}`))
198
+ }
199
+ process.exit(1)
200
+ }
201
+ } else {
202
+ console.error(error('pgcli is not installed'))
203
+ console.log()
204
+ console.log(chalk.gray('Install pgcli for enhanced PostgreSQL shell:'))
205
+ console.log(chalk.cyan(' spindb connect --install-pgcli'))
206
+ console.log()
207
+ console.log(chalk.gray('Or install manually:'))
208
+ for (const instruction of getPgcliManualInstructions()) {
209
+ console.log(chalk.cyan(` ${instruction}`))
210
+ }
211
+ process.exit(1)
212
+ }
213
+ }
214
+ }
215
+
216
+ // Handle --mycli and --install-mycli flags
217
+ const useMycli = options.mycli || options.installMycli
218
+ if (useMycli) {
219
+ if (engineName !== 'mysql') {
220
+ console.error(error('mycli is only available for MySQL containers'))
221
+ console.log(chalk.gray('For PostgreSQL, use: spindb connect --pgcli'))
222
+ process.exit(1)
223
+ }
224
+
225
+ const mycliInstalled = await isMycliInstalled()
226
+
227
+ if (!mycliInstalled) {
228
+ if (options.installMycli) {
229
+ console.log(info('Installing mycli for enhanced MySQL shell...'))
230
+ const pm = await detectPackageManager()
231
+ if (pm) {
232
+ const result = await installMycli(pm)
233
+ if (result.success) {
234
+ console.log(success('mycli installed successfully!'))
235
+ console.log()
236
+ } else {
237
+ console.error(error(`Failed to install mycli: ${result.error}`))
238
+ console.log()
239
+ console.log(chalk.gray('Manual installation:'))
240
+ for (const instruction of getMycliManualInstructions()) {
241
+ console.log(chalk.cyan(` ${instruction}`))
242
+ }
243
+ process.exit(1)
244
+ }
245
+ } else {
246
+ console.error(error('No supported package manager found'))
247
+ console.log()
248
+ console.log(chalk.gray('Manual installation:'))
249
+ for (const instruction of getMycliManualInstructions()) {
250
+ console.log(chalk.cyan(` ${instruction}`))
251
+ }
252
+ process.exit(1)
253
+ }
254
+ } else {
255
+ console.error(error('mycli is not installed'))
256
+ console.log()
257
+ console.log(chalk.gray('Install mycli for enhanced MySQL shell:'))
258
+ console.log(chalk.cyan(' spindb connect --install-mycli'))
259
+ console.log()
260
+ console.log(chalk.gray('Or install manually:'))
261
+ for (const instruction of getMycliManualInstructions()) {
262
+ console.log(chalk.cyan(` ${instruction}`))
263
+ }
264
+ process.exit(1)
265
+ }
266
+ }
267
+ }
268
+
269
+ console.log(info(`Connecting to ${containerName}:${database}...`))
270
+ console.log()
271
+
272
+ // Build client command based on engine and shell preference
273
+ let clientCmd: string
274
+ let clientArgs: string[]
275
+
276
+ if (usePgcli) {
277
+ // pgcli accepts connection strings
278
+ clientCmd = 'pgcli'
279
+ clientArgs = [connectionString]
280
+ } else if (useMycli) {
281
+ // mycli: mycli -h host -P port -u user database
282
+ clientCmd = 'mycli'
283
+ clientArgs = [
284
+ '-h',
285
+ '127.0.0.1',
286
+ '-P',
287
+ String(config.port),
288
+ '-u',
289
+ engineDefaults.superuser,
290
+ database,
291
+ ]
292
+ } else if (useUsql) {
293
+ // usql accepts connection strings directly for both PostgreSQL and MySQL
294
+ clientCmd = 'usql'
295
+ clientArgs = [connectionString]
296
+ } else if (engineName === 'mysql') {
297
+ // MySQL: mysql -h 127.0.0.1 -P port -u root database
298
+ clientCmd = 'mysql'
299
+ clientArgs = [
300
+ '-h',
301
+ '127.0.0.1',
302
+ '-P',
303
+ String(config.port),
304
+ '-u',
305
+ engineDefaults.superuser,
306
+ database,
307
+ ]
119
308
  } else {
120
- console.error(error(err.message))
309
+ // PostgreSQL: psql connection_string
310
+ clientCmd = 'psql'
311
+ clientArgs = [connectionString]
121
312
  }
122
- })
123
-
124
- await new Promise<void>((resolve) => {
125
- clientProcess.on('close', () => resolve())
126
- })
127
- } catch (err) {
128
- const e = err as Error
129
- console.error(error(e.message))
130
- process.exit(1)
131
- }
132
- })
313
+
314
+ const clientProcess = spawn(clientCmd, clientArgs, {
315
+ stdio: 'inherit',
316
+ })
317
+
318
+ clientProcess.on('error', (err: NodeJS.ErrnoException) => {
319
+ if (err.code === 'ENOENT') {
320
+ console.log(warning(`${clientCmd} not found on your system.`))
321
+ console.log()
322
+ console.log(
323
+ chalk.gray(' Install client tools or connect manually:'),
324
+ )
325
+ console.log(chalk.cyan(` ${connectionString}`))
326
+ console.log()
327
+
328
+ if (clientCmd === 'usql') {
329
+ console.log(chalk.gray(' Install usql:'))
330
+ console.log(chalk.cyan(' brew tap xo/xo && brew install xo/xo/usql'))
331
+ } else if (clientCmd === 'pgcli') {
332
+ console.log(chalk.gray(' Install pgcli:'))
333
+ console.log(chalk.cyan(' brew install pgcli'))
334
+ } else if (clientCmd === 'mycli') {
335
+ console.log(chalk.gray(' Install mycli:'))
336
+ console.log(chalk.cyan(' brew install mycli'))
337
+ } else if (engineName === 'mysql') {
338
+ console.log(chalk.gray(' On macOS with Homebrew:'))
339
+ console.log(chalk.cyan(' brew install mysql-client'))
340
+ } else {
341
+ console.log(chalk.gray(' On macOS with Homebrew:'))
342
+ console.log(
343
+ chalk.cyan(' brew install libpq && brew link --force libpq'),
344
+ )
345
+ }
346
+ console.log()
347
+ } else {
348
+ console.error(error(err.message))
349
+ }
350
+ })
351
+
352
+ await new Promise<void>((resolve) => {
353
+ clientProcess.on('close', () => resolve())
354
+ })
355
+ } catch (err) {
356
+ const e = err as Error
357
+ console.error(error(e.message))
358
+ process.exit(1)
359
+ }
360
+ },
361
+ )