spindb 0.33.1 → 0.34.0

package/README.md

@@ -105,6 +105,15 @@ spindb connect cache                             # Open redis-cli
 spindb connect cache --iredis                    # Enhanced shell
 ```
 
+### Enhanced Shells & Visual Tools
+
+```bash
+spindb connect myapp --pgcli                     # Enhanced PostgreSQL shell
+spindb connect myapp --dblab                     # Visual TUI (table browser)
+spindb connect mydb --mycli                      # Enhanced MySQL/MariaDB shell
+spindb connect mydb --ui                         # Built-in Web UI (DuckDB)
+```
+
 ### Any Engine
 
 ```bash

package/cli/commands/connect.ts

@@ -27,6 +27,9 @@ import { getEngineDefaults } from '../../config/defaults'
 import { promptContainerSelect } from '../ui/prompts'
 import { uiError, uiWarning, uiInfo, uiSuccess } from '../ui/theme'
 import { Engine } from '../../types'
+import { configManager } from '../../core/config-manager'
+import { DBLAB_ENGINES, getDblabArgs } from '../../core/dblab-utils'
+import { downloadDblabCli } from './menu/shell-handlers'
 
 export const connectCommand = new Command('connect')
   .alias('shell')
@@ -55,6 +58,9 @@ export const connectCommand = new Command('connect')
     'Use iredis for enhanced Redis shell (auto-completion, syntax highlighting)',
   )
   .option('--install-iredis', 'Install iredis if not present, then connect')
+  .option('--dblab', 'Use dblab visual TUI (table browser, query editor)')
+  .option('--install-dblab', 'Download dblab if not present, then connect')
+  .option('--ui', 'Open built-in Web UI (DuckDB only)')
   .action(
     async (
       name: string | undefined,
@@ -70,6 +76,9 @@ export const connectCommand = new Command('connect')
         installLitecli?: boolean
         iredis?: boolean
         installIredis?: boolean
+        dblab?: boolean
+        installDblab?: boolean
+        ui?: boolean
       },
     ) => {
       try {
@@ -456,6 +465,96 @@ export const connectCommand = new Command('connect')
           }
         }
 
+        const useDblab = options.dblab || options.installDblab
+        if (useDblab) {
+          if (!DBLAB_ENGINES.has(engineName)) {
+            console.error(
+              uiError(`dblab is not supported for ${engineName} containers`),
+            )
+            process.exit(1)
+          }
+
+          let dblabPath = await configManager.getBinaryPath('dblab')
+
+          if (!dblabPath) {
+            if (options.installDblab) {
+              dblabPath = await downloadDblabCli()
+              if (!dblabPath) {
+                process.exit(1)
+              }
+            } else {
+              console.error(uiError('dblab is not installed'))
+              console.log()
+              console.log(chalk.gray('Download dblab:'))
+              console.log(chalk.cyan('  spindb connect --install-dblab'))
+              console.log()
+              console.log(chalk.gray('Or download manually from:'))
+              console.log(
+                chalk.cyan('  https://github.com/danvergara/dblab/releases'),
+              )
+              process.exit(1)
+            }
+          }
+
+          const dblabArgs = getDblabArgs(config, database)
+          const dblabProcess = spawn(dblabPath, dblabArgs, {
+            stdio: 'inherit',
+          })
+
+          await new Promise<void>((resolve) => {
+            dblabProcess.on('error', (err: NodeJS.ErrnoException) => {
+              if (err.code === 'ENOENT') {
+                console.log(uiWarning('dblab not found.'))
+                console.log(chalk.gray('  Download it with:'))
+                console.log(chalk.cyan('  spindb connect --install-dblab'))
+              } else {
+                console.error(uiError(err.message))
+              }
+              resolve()
+            })
+            dblabProcess.on('close', () => resolve())
+          })
+
+          return
+        }
+
+        if (options.ui) {
+          if (engineName !== Engine.DuckDB) {
+            console.error(
+              uiError('--ui is only available for DuckDB containers'),
+            )
+            process.exit(1)
+          }
+
+          const duckdbPath = await configManager.getBinaryPath('duckdb')
+          if (!duckdbPath) {
+            console.error(
+              uiError(
+                'DuckDB binary not found. Download it with: spindb engines download duckdb',
+              ),
+            )
+            process.exit(1)
+          }
+
+          const uiProcess = spawn(duckdbPath, [config.database, '-ui'], {
+            stdio: 'inherit',
+          })
+
+          await new Promise<void>((resolve) => {
+            uiProcess.on('error', (err: NodeJS.ErrnoException) => {
+              if (err.code === 'ENOENT') {
+                console.log(uiWarning('DuckDB binary not found.'))
+              } else {
+                console.error(uiError(err.message))
+              }
+              resolve()
+            })
+            uiProcess.on('close', () => resolve())
+          })
+
+          return
+        }
+
         console.log(uiInfo(`Connecting to ${containerName}:${database}...`))
         console.log()
 

package/cli/commands/menu/container-handlers.ts

@@ -53,7 +53,12 @@ import {
   formatBytes,
   box,
 } from '../../ui/theme'
-import { handleOpenShell, handleCopyConnectionString } from './shell-handlers'
+import {
+  handleOpenShell,
+  handleCopyConnectionString,
+  stopPgwebProcess,
+} from './shell-handlers'
+import { getPgwebStatus } from '../../../core/pgweb-utils'
 import { generatePassword } from '../../../core/credential-generator'
 import {
   saveCredentials,
@@ -591,16 +596,16 @@ export async function handleList(
   // Build the full choice list with footer items
   // IMPORTANT: Containers must come FIRST because filterableCount slices from index 0
   const summary = `${containers.length} container(s): ${parts.join('; ')}`
+  const headerItems = hasServerContainers
+    ? [
+        new inquirer.Separator(
+          chalk.cyan('── [Shift+Tab] toggle start/stop ──'),
+        ),
+      ]
+    : []
   const allChoices: (FilterableChoice | inquirer.Separator)[] = [
     ...containerChoices,
-    // Show toggle hint after containers (before footer) when server-based containers exist
-    ...(hasServerContainers
-      ? [
-          new inquirer.Separator(
-            chalk.cyan('── [Shift+Tab] toggle start/stop ──'),
-          ),
-        ]
-      : [new inquirer.Separator()]),
+    new inquirer.Separator(),
     new inquirer.Separator(summary),
     new inquirer.Separator(),
     { name: `${chalk.green('+')} Create new`, value: 'create' },
@@ -620,6 +625,7 @@ export async function handleList(
       emptyText: 'No containers match filter',
       enableToggle: hasServerContainers,
       defaultValue: options?.focusContainer,
+      headerItems,
     },
   )
 
@@ -660,6 +666,8 @@ export async function handleList(
     const result = await handleCreate()
     if (result === 'main') {
       await showMainMenu()
+    } else if (result) {
+      await showContainerSubmenu(result, showMainMenu)
     } else {
       await handleList(showMainMenu)
     }
@@ -775,6 +783,21 @@ export async function showContainerSubmenu(
         name: `${chalk.red('■')} Stop container`,
         value: 'stop',
       })
+
+      // Stop pgweb - only for PG-wire-protocol engines when pgweb is running
+      if (
+        config.engine === 'postgresql' ||
+        config.engine === 'cockroachdb' ||
+        config.engine === 'ferretdb'
+      ) {
+        const pgwebStatus = await getPgwebStatus(containerName, config.engine)
+        if (pgwebStatus.running) {
+          actionChoices.push({
+            name: `${chalk.redBright('■')} Stop pgweb (port ${pgwebStatus.port})`,
+            value: 'stop-pgweb',
+          })
+        }
+      }
     }
 
     // View logs - available anytime for server-based DBs
@@ -806,11 +829,11 @@ export async function showContainerSubmenu(
     new inquirer.Separator(chalk.gray(`── ${dataSectionLabel} ──`)),
   )
 
-  // Open shell - requires database selection for multi-db containers
+  // Open console - requires database selection for multi-db containers
   actionChoices.push(
     canDoDbAction
-      ? { name: `${chalk.blue('>')} Open shell`, value: 'shell' }
-      : disabledItem('>', 'Open shell'),
+      ? { name: `${chalk.blue('>')} Open console`, value: 'shell' }
+      : disabledItem('>', 'Open console'),
   )
 
   // Run script file - requires database selection for multi-db containers
@@ -991,6 +1014,10 @@ export async function showContainerSubmenu(
       await handleViewLogs(containerName)
       await showContainerSubmenu(containerName, showMainMenu, activeDatabase)
       return
+    case 'stop-pgweb':
+      await stopPgwebProcess(containerName, config.engine)
+      await showContainerSubmenu(containerName, showMainMenu, activeDatabase)
+      return
     case 'edit': {
       const newName = await handleEditContainer(containerName)
       if (newName === null) {

package/cli/commands/menu/index.ts

@@ -24,7 +24,8 @@ import { handleSettings } from './settings-handlers'
 import { configManager } from '../../../core/config-manager'
 import { createSpinner } from '../../ui/spinner'
 import { type MenuChoice, pressEnterToContinue } from './shared'
-import { getPageSize } from '../../constants'
+import { getPageSize, getEngineIcon } from '../../constants'
+import { getContainerPorts } from '../ports'
 
 // Track update check state for this session (only check once on first menu load)
 let updateCheckPromise: Promise<UpdateCheckResult | null> | null = null
@@ -76,6 +77,7 @@ async function showMainMenu(): Promise<void> {
       ? [
           { name: `${chalk.cyan('◉')} Containers`, value: 'list' },
           { name: `${chalk.green('+')} Create container`, value: 'create' },
+          { name: `${chalk.magenta('⊞')} Ports`, value: 'ports' },
         ]
       : [
           { name: `${chalk.green('+')} Create container`, value: 'create' },
@@ -138,6 +140,9 @@ async function showMainMenu(): Promise<void> {
     case 'list':
       await handleList(showMainMenu)
       break
+    case 'ports':
+      await handlePorts()
+      break
     case 'settings':
       await handleSettings()
       break
@@ -150,6 +155,72 @@ async function showMainMenu(): Promise<void> {
   }
 }
 
+async function handlePorts(): Promise<void> {
+  console.clear()
+  console.log(header('Ports'))
+  console.log()
+
+  const containers = await containerManager.list()
+
+  if (containers.length === 0) {
+    console.log(chalk.gray('  No containers found.'))
+    console.log()
+    await pressEnterToContinue()
+    return
+  }
+
+  const results = await Promise.all(
+    containers.map(async (config) => {
+      const { status, ports } = await getContainerPorts(config)
+      return { config, status, ports }
+    }),
+  )
+
+  // Only show containers that have ports (skip file-based DBs)
+  const withPorts = results.filter((r) => r.ports.length > 0)
+
+  if (withPorts.length === 0) {
+    console.log(chalk.gray('  No port-based containers found.'))
+    console.log()
+    await pressEnterToContinue()
+    return
+  }
+
+  console.log(
+    chalk.gray('  ') +
+      chalk.bold.white('NAME'.padEnd(22)) +
+      chalk.bold.white('ENGINE'.padEnd(18)) +
+      chalk.bold.white('PORT(S)'),
+  )
+  console.log(chalk.gray('  ' + '─'.repeat(66)))
+
+  for (const { config, status, ports } of withPorts) {
+    const engineIcon = getEngineIcon(config.engine)
+    const engineName = config.engine.padEnd(13)
+
+    const parts = ports.map((p, i) =>
+      i === 0 ? String(p.port) : `${p.port} ${chalk.gray(`(${p.label})`)}`,
+    )
+    const portDisplay = parts.join(chalk.gray(', '))
+
+    const statusIndicator =
+      status === 'running' ? chalk.green('●') : chalk.gray('○')
+
+    console.log(
+      chalk.gray('  ') +
+        statusIndicator +
+        ' ' +
+        chalk.cyan(config.name.padEnd(20)) +
+        engineIcon +
+        chalk.white(engineName) +
+        portDisplay,
+    )
+  }
+
+  console.log()
+  await pressEnterToContinue()
+}
+
 async function handleUpdate(): Promise<void> {
   console.clear()
   console.log(header('Update SpinDB'))