spindb 0.9.0 → 0.9.2

package/README.md

@@ -227,6 +227,9 @@ spindb create mydb --port 5433               # Custom port
 spindb create mydb --database my_app         # Custom database name
 spindb create mydb --no-start                # Create without starting
 
+# Create, start, and connect in one command
+spindb create mydb --start --connect
+
 # SQLite with custom path
 spindb create mydb --engine sqlite --path ./data/app.sqlite
 ```
@@ -250,7 +253,9 @@ spindb create mydb --from "postgresql://user:pass@host:5432/production"
 | `--path` | File path for SQLite databases |
 | `--max-connections` | Maximum database connections (default: 200) |
 | `--from` | Restore from backup file or connection string |
+| `--start` | Start container after creation (skip prompt) |
 | `--no-start` | Create without starting |
+| `--connect` | Open a shell connection after creation |
 
 </details>
 
@@ -400,10 +405,12 @@ ENGINE        VERSION     SOURCE            SIZE
 🐘 postgresql 17.7        darwin-arm64      45.2 MB
 🐘 postgresql 16.8        darwin-arm64      44.8 MB
 🐬 mysql      8.0.35      system            (system-installed)
+🪶 sqlite     3.43.2      system            (system-installed)
 ────────────────────────────────────────────────────────
 
 PostgreSQL: 2 version(s), 90.0 MB
 MySQL: system-installed at /opt/homebrew/bin/mysqld
+SQLite: system-installed at /usr/bin/sqlite3
 ```
 
 #### `deps` - Manage client tools

package/cli/commands/backup.ts

@@ -12,7 +12,7 @@ import {
   promptInstallDependencies,
 } from '../ui/prompts'
 import { createSpinner } from '../ui/spinner'
-import { success, error, warning, formatBytes } from '../ui/theme'
+import { uiSuccess, uiError, uiWarning, formatBytes } from '../ui/theme'
 import { getMissingDependencies } from '../../core/dependency-manager'
 
 function generateTimestamp(): string {
@@ -70,11 +70,13 @@ export const backupCommand = new Command('backup')
           if (running.length === 0) {
             if (containers.length === 0) {
               console.log(
-                warning('No containers found. Create one with: spindb create'),
+                uiWarning(
+                  'No containers found. Create one with: spindb create',
+                ),
               )
             } else {
               console.log(
-                warning(
+                uiWarning(
                   'No running containers. Start one first with: spindb start',
                 ),
               )
@@ -92,7 +94,7 @@ export const backupCommand = new Command('backup')
 
         const config = await containerManager.getConfig(containerName)
         if (!config) {
-          console.error(error(`Container "${containerName}" not found`))
+          console.error(uiError(`Container "${containerName}" not found`))
           process.exit(1)
         }
 
@@ -103,7 +105,7 @@ export const backupCommand = new Command('backup')
         })
         if (!running) {
           console.error(
-            error(
+            uiError(
               `Container "${containerName}" is not running. Start it first.`,
             ),
           )
@@ -133,7 +135,7 @@ export const backupCommand = new Command('backup')
           missingDeps = await getMissingDependencies(config.engine)
           if (missingDeps.length > 0) {
             console.error(
-              error(
+              uiError(
                 `Still missing tools: ${missingDeps.map((d) => d.name).join(', ')}`,
               ),
             )
@@ -169,7 +171,7 @@ export const backupCommand = new Command('backup')
           format = 'dump'
         } else if (options.format) {
           if (options.format !== 'sql' && options.format !== 'dump') {
-            console.error(error('Format must be "sql" or "dump"'))
+            console.error(uiError('Format must be "sql" or "dump"'))
             process.exit(1)
           }
           format = options.format as 'sql' | 'dump'
@@ -204,7 +206,7 @@ export const backupCommand = new Command('backup')
         backupSpinner.succeed('Backup created successfully')
 
         console.log()
-        console.log(success('Backup complete'))
+        console.log(uiSuccess('Backup complete'))
         console.log()
         console.log(chalk.gray('  File:'), chalk.cyan(result.path))
         console.log(
@@ -213,8 +215,8 @@ export const backupCommand = new Command('backup')
         )
         console.log(chalk.gray('  Format:'), chalk.white(result.format))
         console.log()
-      } catch (err) {
-        const e = err as Error
+      } catch (error) {
+        const e = error as Error
 
         const missingToolPatterns = ['pg_dump not found', 'mysqldump not found']
 
@@ -233,7 +235,7 @@ export const backupCommand = new Command('backup')
           process.exit(1)
         }
 
-        console.error(error(e.message))
+        console.error(uiError(e.message))
         process.exit(1)
       }
     },

package/cli/commands/clone.ts

@@ -5,7 +5,7 @@ import { processManager } from '../../core/process-manager'
 import { getEngine } from '../../engines'
 import { promptContainerSelect, promptContainerName } from '../ui/prompts'
 import { createSpinner } from '../ui/spinner'
-import { error, warning, connectionBox } from '../ui/theme'
+import { uiError, uiWarning, connectionBox } from '../ui/theme'
 
 export const cloneCommand = new Command('clone')
   .description('Clone a container with all its data')
@@ -22,14 +22,14 @@ export const cloneCommand = new Command('clone')
 
         if (containers.length === 0) {
           console.log(
-            warning('No containers found. Create one with: spindb create'),
+            uiWarning('No containers found. Create one with: spindb create'),
           )
           return
         }
 
         if (stopped.length === 0) {
           console.log(
-            warning(
+            uiWarning(
               'All containers are running. Stop a container first to clone it.',
             ),
           )
@@ -51,7 +51,7 @@ export const cloneCommand = new Command('clone')
 
       const sourceConfig = await containerManager.getConfig(sourceName)
       if (!sourceConfig) {
-        console.error(error(`Container "${sourceName}" not found`))
+        console.error(uiError(`Container "${sourceName}" not found`))
         process.exit(1)
       }
 
@@ -60,7 +60,7 @@ export const cloneCommand = new Command('clone')
       })
       if (running) {
         console.error(
-          error(
+          uiError(
             `Container "${sourceName}" is running. Stop it first to clone.`,
           ),
         )
@@ -71,6 +71,16 @@ export const cloneCommand = new Command('clone')
         targetName = await promptContainerName(`${sourceName}-copy`)
       }
 
+      // Check if target container already exists
+      if (
+        await containerManager.exists(targetName, {
+          engine: sourceConfig.engine,
+        })
+      ) {
+        console.error(uiError(`Container "${targetName}" already exists`))
+        process.exit(1)
+      }
+
       const cloneSpinner = createSpinner(
         `Cloning ${sourceName} to ${targetName}...`,
       )
@@ -89,9 +99,9 @@ export const cloneCommand = new Command('clone')
       console.log(chalk.gray('  Start the cloned container:'))
       console.log(chalk.cyan(`  spindb start ${targetName}`))
       console.log()
-    } catch (err) {
-      const e = err as Error
-      console.error(error(e.message))
+    } catch (error) {
+      const e = error as Error
+      console.error(uiError(e.message))
       process.exit(1)
     }
   })

package/cli/commands/config.ts

@@ -9,7 +9,7 @@ import {
   ALL_TOOLS,
 } from '../../core/config-manager'
 import { updateManager } from '../../core/update-manager'
-import { error, success, header, info } from '../ui/theme'
+import { uiError, uiSuccess, header, uiInfo } from '../ui/theme'
 import { createSpinner } from '../ui/spinner'
 import type { BinaryTool } from '../../types'
 
@@ -95,9 +95,9 @@ export const configCommand = new Command('config')
             )
             console.log()
           }
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -208,9 +208,9 @@ export const configCommand = new Command('config')
             }
             console.log()
           }
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -224,14 +224,14 @@ export const configCommand = new Command('config')
         try {
           // Validate tool name
           if (!ALL_TOOLS.includes(tool as BinaryTool)) {
-            console.error(error(`Invalid tool: ${tool}`))
+            console.error(uiError(`Invalid tool: ${tool}`))
             console.log(chalk.gray(`  Valid tools: ${ALL_TOOLS.join(', ')}`))
             process.exit(1)
           }
 
           // Validate path exists
           if (!existsSync(path)) {
-            console.error(error(`File not found: ${path}`))
+            console.error(uiError(`File not found: ${path}`))
             process.exit(1)
           }
 
@@ -240,10 +240,10 @@ export const configCommand = new Command('config')
           const config = await configManager.getBinaryConfig(tool as BinaryTool)
           const versionLabel = config?.version ? ` (v${config.version})` : ''
 
-          console.log(success(`Set ${tool} to: ${path}${versionLabel}`))
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+          console.log(uiSuccess(`Set ${tool} to: ${path}${versionLabel}`))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -256,16 +256,16 @@ export const configCommand = new Command('config')
         try {
           // Validate tool name
           if (!ALL_TOOLS.includes(tool as BinaryTool)) {
-            console.error(error(`Invalid tool: ${tool}`))
+            console.error(uiError(`Invalid tool: ${tool}`))
             console.log(chalk.gray(`  Valid tools: ${ALL_TOOLS.join(', ')}`))
             process.exit(1)
           }
 
           await configManager.clearBinaryPath(tool as BinaryTool)
-          console.log(success(`Removed ${tool} configuration`))
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+          console.log(uiSuccess(`Removed ${tool} configuration`))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -278,7 +278,7 @@ export const configCommand = new Command('config')
         try {
           // Validate tool name
           if (!ALL_TOOLS.includes(tool as BinaryTool)) {
-            console.error(error(`Invalid tool: ${tool}`))
+            console.error(uiError(`Invalid tool: ${tool}`))
             console.log(chalk.gray(`  Valid tools: ${ALL_TOOLS.join(', ')}`))
             process.exit(1)
           }
@@ -287,15 +287,15 @@ export const configCommand = new Command('config')
           if (path) {
             console.log(path)
           } else {
-            console.error(error(`${tool} not found`))
+            console.error(uiError(`${tool} not found`))
             console.log(
               chalk.gray(`  Run 'spindb config detect' to auto-detect tools`),
             )
             process.exit(1)
           }
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -328,7 +328,7 @@ export const configCommand = new Command('config')
           }
 
           if (state !== 'on' && state !== 'off') {
-            console.error(error('Invalid state. Use "on" or "off"'))
+            console.error(uiError('Invalid state. Use "on" or "off"'))
             process.exit(1)
           }
 
@@ -336,18 +336,18 @@ export const configCommand = new Command('config')
           await updateManager.setAutoCheckEnabled(enabled)
 
           if (enabled) {
-            console.log(success('Update checks enabled on startup'))
+            console.log(uiSuccess('Update checks enabled on startup'))
           } else {
-            console.log(info('Update checks disabled on startup'))
+            console.log(uiInfo('Update checks disabled on startup'))
             console.log(
               chalk.gray(
                 '  You can still manually check with: spindb version --check',
               ),
             )
           }
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),

package/cli/commands/connect.ts

@@ -22,7 +22,7 @@ import {
 import { getEngine } from '../../engines'
 import { getEngineDefaults } from '../../config/defaults'
 import { promptContainerSelect } from '../ui/prompts'
-import { error, warning, info, success } from '../ui/theme'
+import { uiError, uiWarning, uiInfo, uiSuccess } from '../ui/theme'
 import { Engine } from '../../types'
 
 export const connectCommand = new Command('connect')
@@ -78,11 +78,13 @@ export const connectCommand = new Command('connect')
           if (connectable.length === 0) {
             if (containers.length === 0) {
               console.log(
-                warning('No containers found. Create one with: spindb create'),
+                uiWarning(
+                  'No containers found. Create one with: spindb create',
+                ),
               )
             } else {
               console.log(
-                warning(
+                uiWarning(
                   'No running containers. Start one first with: spindb start',
                 ),
               )
@@ -100,7 +102,7 @@ export const connectCommand = new Command('connect')
 
         const config = await containerManager.getConfig(containerName)
         if (!config) {
-          console.error(error(`Container "${containerName}" not found`))
+          console.error(uiError(`Container "${containerName}" not found`))
           process.exit(1)
         }
 
@@ -114,9 +116,7 @@ export const connectCommand = new Command('connect')
         if (engineName === Engine.SQLite) {
           if (!existsSync(config.database)) {
             console.error(
-              error(
-                `SQLite database file not found: ${config.database}`,
-              ),
+              uiError(`SQLite database file not found: ${config.database}`),
             )
             process.exit(1)
           }
@@ -127,7 +127,7 @@ export const connectCommand = new Command('connect')
           })
           if (!running) {
             console.error(
-              error(
+              uiError(
                 `Container "${containerName}" is not running. Start it first.`,
               ),
             )
@@ -145,17 +145,17 @@ export const connectCommand = new Command('connect')
           if (!usqlInstalled) {
             if (options.installTui) {
               console.log(
-                info('Installing usql for enhanced shell experience...'),
+                uiInfo('Installing usql for enhanced shell experience...'),
               )
               const pm = await detectPackageManager()
               if (pm) {
                 const result = await installUsql(pm)
                 if (result.success) {
-                  console.log(success('usql installed successfully!'))
+                  console.log(uiSuccess('usql installed successfully!'))
                   console.log()
                 } else {
                   console.error(
-                    error(`Failed to install usql: ${result.error}`),
+                    uiError(`Failed to install usql: ${result.error}`),
                   )
                   console.log()
                   console.log(chalk.gray('Manual installation:'))
@@ -165,7 +165,7 @@ export const connectCommand = new Command('connect')
                   process.exit(1)
                 }
               } else {
-                console.error(error('No supported package manager found'))
+                console.error(uiError('No supported package manager found'))
                 console.log()
                 console.log(chalk.gray('Manual installation:'))
                 for (const instruction of getUsqlManualInstructions()) {
@@ -174,7 +174,7 @@ export const connectCommand = new Command('connect')
                 process.exit(1)
               }
             } else {
-              console.error(error('usql is not installed'))
+              console.error(uiError('usql is not installed'))
               console.log()
               console.log(
                 chalk.gray('Install usql for enhanced shell experience:'),
@@ -194,7 +194,7 @@ export const connectCommand = new Command('connect')
         if (usePgcli) {
           if (engineName !== 'postgresql') {
             console.error(
-              error('pgcli is only available for PostgreSQL containers'),
+              uiError('pgcli is only available for PostgreSQL containers'),
             )
             console.log(chalk.gray('For MySQL, use: spindb connect --mycli'))
             process.exit(1)
@@ -205,17 +205,17 @@ export const connectCommand = new Command('connect')
           if (!pgcliInstalled) {
             if (options.installPgcli) {
               console.log(
-                info('Installing pgcli for enhanced PostgreSQL shell...'),
+                uiInfo('Installing pgcli for enhanced PostgreSQL shell...'),
               )
               const pm = await detectPackageManager()
               if (pm) {
                 const result = await installPgcli(pm)
                 if (result.success) {
-                  console.log(success('pgcli installed successfully!'))
+                  console.log(uiSuccess('pgcli installed successfully!'))
                   console.log()
                 } else {
                   console.error(
-                    error(`Failed to install pgcli: ${result.error}`),
+                    uiError(`Failed to install pgcli: ${result.error}`),
                   )
                   console.log()
                   console.log(chalk.gray('Manual installation:'))
@@ -225,7 +225,7 @@ export const connectCommand = new Command('connect')
                   process.exit(1)
                 }
               } else {
-                console.error(error('No supported package manager found'))
+                console.error(uiError('No supported package manager found'))
                 console.log()
                 console.log(chalk.gray('Manual installation:'))
                 for (const instruction of getPgcliManualInstructions()) {
@@ -234,7 +234,7 @@ export const connectCommand = new Command('connect')
                 process.exit(1)
               }
             } else {
-              console.error(error('pgcli is not installed'))
+              console.error(uiError('pgcli is not installed'))
               console.log()
               console.log(
                 chalk.gray('Install pgcli for enhanced PostgreSQL shell:'),
@@ -253,7 +253,9 @@ export const connectCommand = new Command('connect')
         const useMycli = options.mycli || options.installMycli
         if (useMycli) {
           if (engineName !== 'mysql') {
-            console.error(error('mycli is only available for MySQL containers'))
+            console.error(
+              uiError('mycli is only available for MySQL containers'),
+            )
             console.log(
               chalk.gray('For PostgreSQL, use: spindb connect --pgcli'),
             )
@@ -264,16 +266,18 @@ export const connectCommand = new Command('connect')
 
           if (!mycliInstalled) {
             if (options.installMycli) {
-              console.log(info('Installing mycli for enhanced MySQL shell...'))
+              console.log(
+                uiInfo('Installing mycli for enhanced MySQL shell...'),
+              )
               const pm = await detectPackageManager()
               if (pm) {
                 const result = await installMycli(pm)
                 if (result.success) {
-                  console.log(success('mycli installed successfully!'))
+                  console.log(uiSuccess('mycli installed successfully!'))
                   console.log()
                 } else {
                   console.error(
-                    error(`Failed to install mycli: ${result.error}`),
+                    uiError(`Failed to install mycli: ${result.error}`),
                   )
                   console.log()
                   console.log(chalk.gray('Manual installation:'))
@@ -283,7 +287,7 @@ export const connectCommand = new Command('connect')
                   process.exit(1)
                 }
               } else {
-                console.error(error('No supported package manager found'))
+                console.error(uiError('No supported package manager found'))
                 console.log()
                 console.log(chalk.gray('Manual installation:'))
                 for (const instruction of getMycliManualInstructions()) {
@@ -292,7 +296,7 @@ export const connectCommand = new Command('connect')
                 process.exit(1)
               }
             } else {
-              console.error(error('mycli is not installed'))
+              console.error(uiError('mycli is not installed'))
               console.log()
               console.log(chalk.gray('Install mycli for enhanced MySQL shell:'))
               console.log(chalk.cyan('  spindb connect --install-mycli'))
@@ -309,9 +313,13 @@ export const connectCommand = new Command('connect')
         const useLitecli = options.litecli || options.installLitecli
         if (useLitecli) {
           if (engineName !== Engine.SQLite) {
-            console.error(error('litecli is only available for SQLite containers'))
+            console.error(
+              uiError('litecli is only available for SQLite containers'),
+            )
             if (engineName === 'postgresql') {
-              console.log(chalk.gray('For PostgreSQL, use: spindb connect --pgcli'))
+              console.log(
+                chalk.gray('For PostgreSQL, use: spindb connect --pgcli'),
+              )
             } else if (engineName === 'mysql') {
               console.log(chalk.gray('For MySQL, use: spindb connect --mycli'))
             }
@@ -322,16 +330,18 @@ export const connectCommand = new Command('connect')
 
           if (!litecliInstalled) {
             if (options.installLitecli) {
-              console.log(info('Installing litecli for enhanced SQLite shell...'))
+              console.log(
+                uiInfo('Installing litecli for enhanced SQLite shell...'),
+              )
               const pm = await detectPackageManager()
               if (pm) {
                 const result = await installLitecli(pm)
                 if (result.success) {
-                  console.log(success('litecli installed successfully!'))
+                  console.log(uiSuccess('litecli installed successfully!'))
                   console.log()
                 } else {
                   console.error(
-                    error(`Failed to install litecli: ${result.error}`),
+                    uiError(`Failed to install litecli: ${result.error}`),
                   )
                   console.log()
                   console.log(chalk.gray('Manual installation:'))
@@ -341,7 +351,7 @@ export const connectCommand = new Command('connect')
                   process.exit(1)
                 }
               } else {
-                console.error(error('No supported package manager found'))
+                console.error(uiError('No supported package manager found'))
                 console.log()
                 console.log(chalk.gray('Manual installation:'))
                 for (const instruction of getLitecliManualInstructions()) {
@@ -350,9 +360,11 @@ export const connectCommand = new Command('connect')
                 process.exit(1)
               }
             } else {
-              console.error(error('litecli is not installed'))
+              console.error(uiError('litecli is not installed'))
               console.log()
-              console.log(chalk.gray('Install litecli for enhanced SQLite shell:'))
+              console.log(
+                chalk.gray('Install litecli for enhanced SQLite shell:'),
+              )
               console.log(chalk.cyan('  spindb connect --install-litecli'))
               console.log()
               console.log(chalk.gray('Or install manually:'))
@@ -364,7 +376,7 @@ export const connectCommand = new Command('connect')
           }
         }
 
-        console.log(info(`Connecting to ${containerName}:${database}...`))
+        console.log(uiInfo(`Connecting to ${containerName}:${database}...`))
         console.log()
 
         let clientCmd: string
@@ -415,7 +427,7 @@ export const connectCommand = new Command('connect')
 
         clientProcess.on('error', (err: NodeJS.ErrnoException) => {
           if (err.code === 'ENOENT') {
-            console.log(warning(`${clientCmd} not found on your system.`))
+            console.log(uiWarning(`${clientCmd} not found on your system.`))
             console.log()
             console.log(
               chalk.gray('  Install client tools or connect manually:'),
@@ -451,16 +463,16 @@ export const connectCommand = new Command('connect')
             }
             console.log()
           } else {
-            console.error(error(err.message))
+            console.error(uiError(err.message))
           }
         })
 
         await new Promise<void>((resolve) => {
           clientProcess.on('close', () => resolve())
         })
-      } catch (err) {
-        const e = err as Error
-        console.error(error(e.message))
+      } catch (error) {
+        const e = error as Error
+        console.error(uiError(e.message))
         process.exit(1)
       }
     },