spindb 0.7.0 → 0.7.5

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

@@ -0,0 +1,362 @@
+import chalk from 'chalk'
+import inquirer from 'inquirer'
+import { rm } from 'fs/promises'
+import { containerManager } from '../../../core/container-manager'
+import { processManager } from '../../../core/process-manager'
+import { createSpinner } from '../../ui/spinner'
+import { header, error, warning, info, formatBytes } from '../../ui/theme'
+import { promptConfirm } from '../../ui/prompts'
+import { getEngineIcon, ENGINE_ICONS } from '../../constants'
+import {
+  getInstalledEngines,
+  type InstalledPostgresEngine,
+  type InstalledMysqlEngine,
+} from '../../helpers'
+import {
+  getMysqlVersion,
+  getMysqlInstallInfo,
+} from '../../../engines/mysql/binary-detection'
+import { type MenuChoice } from './shared'
+
+export async function handleEngines(): Promise<void> {
+  console.clear()
+  console.log(header('Installed Engines'))
+  console.log()
+
+  const engines = await getInstalledEngines()
+
+  if (engines.length === 0) {
+    console.log(info('No engines installed yet.'))
+    console.log(
+      chalk.gray(
+        '  PostgreSQL engines are downloaded automatically when you create a container.',
+      ),
+    )
+    console.log(
+      chalk.gray(
+        '  MySQL requires system installation (brew install mysql or apt install mysql-server).',
+      ),
+    )
+    return
+  }
+
+  const pgEngines = engines.filter(
+    (e): e is InstalledPostgresEngine => e.engine === 'postgresql',
+  )
+  const mysqlEngine = engines.find(
+    (e): e is InstalledMysqlEngine => e.engine === 'mysql',
+  )
+
+  const totalPgSize = pgEngines.reduce((acc, e) => acc + e.sizeBytes, 0)
+
+  console.log()
+  console.log(
+    chalk.gray('  ') +
+      chalk.bold.white('ENGINE'.padEnd(14)) +
+      chalk.bold.white('VERSION'.padEnd(12)) +
+      chalk.bold.white('SOURCE'.padEnd(18)) +
+      chalk.bold.white('SIZE'),
+  )
+  console.log(chalk.gray('  ' + '─'.repeat(55)))
+
+  for (const engine of pgEngines) {
+    const icon = getEngineIcon(engine.engine)
+    const platformInfo = `${engine.platform}-${engine.arch}`
+
+    console.log(
+      chalk.gray('  ') +
+        chalk.cyan(`${icon} ${engine.engine}`.padEnd(13)) +
+        chalk.yellow(engine.version.padEnd(12)) +
+        chalk.gray(platformInfo.padEnd(18)) +
+        chalk.white(formatBytes(engine.sizeBytes)),
+    )
+  }
+
+  if (mysqlEngine) {
+    const icon = ENGINE_ICONS.mysql
+    const displayName = mysqlEngine.isMariaDB ? 'mariadb' : 'mysql'
+
+    console.log(
+      chalk.gray('  ') +
+        chalk.cyan(`${icon} ${displayName}`.padEnd(13)) +
+        chalk.yellow(mysqlEngine.version.padEnd(12)) +
+        chalk.gray('system'.padEnd(18)) +
+        chalk.gray('(system-installed)'),
+    )
+  }
+
+  console.log(chalk.gray('  ' + '─'.repeat(55)))
+
+  console.log()
+  if (pgEngines.length > 0) {
+    console.log(
+      chalk.gray(
+        `  PostgreSQL: ${pgEngines.length} version(s), ${formatBytes(totalPgSize)}`,
+      ),
+    )
+  }
+  if (mysqlEngine) {
+    console.log(chalk.gray(`  MySQL: system-installed at ${mysqlEngine.path}`))
+  }
+  console.log()
+
+  const choices: MenuChoice[] = []
+
+  for (const e of pgEngines) {
+    choices.push({
+      name: `${chalk.red('✕')} Delete ${e.engine} ${e.version} ${chalk.gray(`(${formatBytes(e.sizeBytes)})`)}`,
+      value: `delete:${e.path}:${e.engine}:${e.version}`,
+    })
+  }
+
+  if (mysqlEngine) {
+    const displayName = mysqlEngine.isMariaDB ? 'MariaDB' : 'MySQL'
+    choices.push({
+      name: `${chalk.blue('ℹ')} ${displayName} ${mysqlEngine.version} ${chalk.gray('(system-installed)')}`,
+      value: `mysql-info:${mysqlEngine.path}`,
+    })
+  }
+
+  choices.push(new inquirer.Separator())
+  choices.push({ name: `${chalk.blue('←')} Back to main menu`, value: 'back' })
+
+  const { action } = await inquirer.prompt<{ action: string }>([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'Manage engines:',
+      choices,
+      pageSize: 15,
+    },
+  ])
+
+  if (action === 'back') {
+    return
+  }
+
+  if (action.startsWith('delete:')) {
+    const [, enginePath, engineName, engineVersion] = action.split(':')
+    await handleDeleteEngine(enginePath, engineName, engineVersion)
+    await handleEngines()
+  }
+
+  if (action.startsWith('mysql-info:')) {
+    const mysqldPath = action.replace('mysql-info:', '')
+    await handleMysqlInfo(mysqldPath)
+    await handleEngines()
+  }
+}
+
+async function handleDeleteEngine(
+  enginePath: string,
+  engineName: string,
+  engineVersion: string,
+): Promise<void> {
+  const containers = await containerManager.list()
+  const usingContainers = containers.filter(
+    (c) => c.engine === engineName && c.version === engineVersion,
+  )
+
+  if (usingContainers.length > 0) {
+    console.log()
+    console.log(
+      error(
+        `Cannot delete: ${usingContainers.length} container(s) are using ${engineName} ${engineVersion}`,
+      ),
+    )
+    console.log(
+      chalk.gray(
+        `  Containers: ${usingContainers.map((c) => c.name).join(', ')}`,
+      ),
+    )
+    console.log()
+    await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'continue',
+        message: chalk.gray('Press Enter to continue...'),
+      },
+    ])
+    return
+  }
+
+  const confirmed = await promptConfirm(
+    `Delete ${engineName} ${engineVersion}? This cannot be undone.`,
+    false,
+  )
+
+  if (!confirmed) {
+    console.log(warning('Deletion cancelled'))
+    return
+  }
+
+  const spinner = createSpinner(`Deleting ${engineName} ${engineVersion}...`)
+  spinner.start()
+
+  try {
+    await rm(enginePath, { recursive: true, force: true })
+    spinner.succeed(`Deleted ${engineName} ${engineVersion}`)
+  } catch (err) {
+    const e = err as Error
+    spinner.fail(`Failed to delete: ${e.message}`)
+  }
+}
+
+async function handleMysqlInfo(mysqldPath: string): Promise<void> {
+  console.clear()
+
+  const installInfo = await getMysqlInstallInfo(mysqldPath)
+  const displayName = installInfo.isMariaDB ? 'MariaDB' : 'MySQL'
+
+  const version = await getMysqlVersion(mysqldPath)
+
+  console.log(header(`${displayName} Information`))
+  console.log()
+
+  const containers = await containerManager.list()
+  const mysqlContainers = containers.filter((c) => c.engine === 'mysql')
+
+  const runningContainers: string[] = []
+
+  if (mysqlContainers.length > 0) {
+    console.log(
+      warning(
+        `${mysqlContainers.length} container(s) are using ${displayName}:`,
+      ),
+    )
+    console.log()
+    for (const c of mysqlContainers) {
+      const isRunning = await processManager.isRunning(c.name, {
+        engine: c.engine,
+      })
+      if (isRunning) {
+        runningContainers.push(c.name)
+      }
+      const status = isRunning
+        ? chalk.green('● running')
+        : chalk.gray('○ stopped')
+      console.log(chalk.gray(`  • ${c.name} ${status}`))
+    }
+    console.log()
+    console.log(
+      chalk.yellow(
+        '  Uninstalling will break these containers. Delete them first.',
+      ),
+    )
+    console.log()
+  }
+
+  console.log(chalk.white('  Installation Details:'))
+  console.log(chalk.gray('  ' + '─'.repeat(50)))
+  console.log(
+    chalk.gray('  ') +
+      chalk.white('Version:'.padEnd(18)) +
+      chalk.yellow(version || 'unknown'),
+  )
+  console.log(
+    chalk.gray('  ') +
+      chalk.white('Binary Path:'.padEnd(18)) +
+      chalk.gray(mysqldPath),
+  )
+  console.log(
+    chalk.gray('  ') +
+      chalk.white('Package Manager:'.padEnd(18)) +
+      chalk.cyan(installInfo.packageManager),
+  )
+  console.log(
+    chalk.gray('  ') +
+      chalk.white('Package Name:'.padEnd(18)) +
+      chalk.cyan(installInfo.packageName),
+  )
+  console.log()
+
+  console.log(chalk.white('  To uninstall:'))
+  console.log(chalk.gray('  ' + '─'.repeat(50)))
+
+  let stepNum = 1
+
+  if (runningContainers.length > 0) {
+    console.log(chalk.gray(`  # ${stepNum}. Stop running SpinDB containers`))
+    console.log(chalk.cyan('  spindb stop <container-name>'))
+    console.log()
+    stepNum++
+  }
+
+  if (mysqlContainers.length > 0) {
+    console.log(chalk.gray(`  # ${stepNum}. Delete SpinDB containers`))
+    console.log(chalk.cyan('  spindb delete <container-name>'))
+    console.log()
+    stepNum++
+  }
+
+  if (installInfo.packageManager === 'homebrew') {
+    console.log(
+      chalk.gray(
+        `  # ${stepNum}. Stop Homebrew service (if running separately)`,
+      ),
+    )
+    console.log(chalk.cyan(`  brew services stop ${installInfo.packageName}`))
+    console.log()
+    console.log(chalk.gray(`  # ${stepNum + 1}. Uninstall the package`))
+    console.log(chalk.cyan(`  ${installInfo.uninstallCommand}`))
+  } else if (installInfo.packageManager === 'apt') {
+    console.log(chalk.gray(`  # ${stepNum}. Stop the system service`))
+    console.log(
+      chalk.cyan(
+        `  sudo systemctl stop ${installInfo.isMariaDB ? 'mariadb' : 'mysql'}`,
+      ),
+    )
+    console.log()
+    console.log(chalk.gray(`  # ${stepNum + 1}. Disable auto-start on boot`))
+    console.log(
+      chalk.cyan(
+        `  sudo systemctl disable ${installInfo.isMariaDB ? 'mariadb' : 'mysql'}`,
+      ),
+    )
+    console.log()
+    console.log(chalk.gray(`  # ${stepNum + 2}. Uninstall the package`))
+    console.log(chalk.cyan(`  ${installInfo.uninstallCommand}`))
+    console.log()
+    console.log(chalk.gray(`  # ${stepNum + 3}. Remove data files (optional)`))
+    console.log(
+      chalk.cyan('  sudo apt purge mysql-server mysql-client mysql-common'),
+    )
+    console.log(chalk.cyan('  sudo rm -rf /var/lib/mysql /etc/mysql'))
+  } else if (
+    installInfo.packageManager === 'yum' ||
+    installInfo.packageManager === 'dnf'
+  ) {
+    console.log(chalk.gray(`  # ${stepNum}. Stop the system service`))
+    console.log(
+      chalk.cyan(
+        `  sudo systemctl stop ${installInfo.isMariaDB ? 'mariadb' : 'mysqld'}`,
+      ),
+    )
+    console.log()
+    console.log(chalk.gray(`  # ${stepNum + 1}. Uninstall the package`))
+    console.log(chalk.cyan(`  ${installInfo.uninstallCommand}`))
+  } else if (installInfo.packageManager === 'pacman') {
+    console.log(chalk.gray(`  # ${stepNum}. Stop the system service`))
+    console.log(
+      chalk.cyan(
+        `  sudo systemctl stop ${installInfo.isMariaDB ? 'mariadb' : 'mysqld'}`,
+      ),
+    )
+    console.log()
+    console.log(chalk.gray(`  # ${stepNum + 1}. Uninstall the package`))
+    console.log(chalk.cyan(`  ${installInfo.uninstallCommand}`))
+  } else {
+    console.log(chalk.gray('  Use your system package manager to uninstall.'))
+    console.log(chalk.gray(`  The binary is located at: ${mysqldPath}`))
+  }
+
+  console.log()
+
+  await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'continue',
+      message: chalk.gray('Press Enter to go back...'),
+    },
+  ])
+}

package/cli/commands/menu/index.ts

@@ -0,0 +1,179 @@
+import { Command } from 'commander'
+import chalk from 'chalk'
+import inquirer from 'inquirer'
+import { containerManager } from '../../../core/container-manager'
+import { promptInstallDependencies } from '../../ui/prompts'
+import { header, error } from '../../ui/theme'
+import { getInstalledEngines } from '../../helpers'
+import {
+  handleCreate,
+  handleList,
+  handleStart,
+  handleStop,
+} from './container-handlers'
+import { handleBackup, handleRestore, handleClone } from './backup-handlers'
+import { handleEngines } from './engine-handlers'
+import { handleCheckUpdate } from './update-handlers'
+import { type MenuChoice } from './shared'
+
+async function showMainMenu(): Promise<void> {
+  console.clear()
+  console.log(header('SpinDB - Local Database Manager'))
+  console.log()
+
+  const containers = await containerManager.list()
+  const running = containers.filter((c) => c.status === 'running').length
+  const stopped = containers.filter((c) => c.status !== 'running').length
+
+  console.log(
+    chalk.gray(
+      `  ${containers.length} container(s): ${running} running, ${stopped} stopped`,
+    ),
+  )
+  console.log()
+
+  const canStart = stopped > 0
+  const canStop = running > 0
+  const canRestore = running > 0
+  const canClone = containers.length > 0
+
+  // Check if any engines are installed
+  const engines = await getInstalledEngines()
+  const hasEngines = engines.length > 0
+
+  // If containers exist, show List first; otherwise show Create first
+  const hasContainers = containers.length > 0
+
+  const choices: MenuChoice[] = [
+    ...(hasContainers
+      ? [
+          { name: `${chalk.cyan('◉')} Containers`, value: 'list' },
+          { name: `${chalk.green('+')} Create new container`, value: 'create' },
+        ]
+      : [
+          { name: `${chalk.green('+')} Create new container`, value: 'create' },
+          { name: `${chalk.cyan('◉')} Containers`, value: 'list' },
+        ]),
+    {
+      name: canStart
+        ? `${chalk.green('▶')} Start a container`
+        : chalk.gray('▶ Start a container'),
+      value: 'start',
+      disabled: canStart ? false : 'No stopped containers',
+    },
+    {
+      name: canStop
+        ? `${chalk.red('■')} Stop a container`
+        : chalk.gray('■ Stop a container'),
+      value: 'stop',
+      disabled: canStop ? false : 'No running containers',
+    },
+    {
+      name: canRestore
+        ? `${chalk.magenta('↓')} Restore backup`
+        : chalk.gray('↓ Restore backup'),
+      value: 'restore',
+      disabled: canRestore ? false : 'No running containers',
+    },
+    {
+      name: canRestore
+        ? `${chalk.magenta('↑')} Backup database`
+        : chalk.gray('↑ Backup database'),
+      value: 'backup',
+      disabled: canRestore ? false : 'No running containers',
+    },
+    {
+      name: canClone
+        ? `${chalk.cyan('⧉')} Clone a container`
+        : chalk.gray('⧉ Clone a container'),
+      value: 'clone',
+      disabled: canClone ? false : 'No containers',
+    },
+    {
+      name: hasEngines
+        ? `${chalk.yellow('⚙')} List installed engines`
+        : chalk.gray('⚙ List installed engines'),
+      value: 'engines',
+      disabled: hasEngines ? false : 'No engines installed',
+    },
+    new inquirer.Separator(),
+    { name: `${chalk.cyan('↑')} Check for updates`, value: 'check-update' },
+    { name: `${chalk.gray('⏻')} Exit`, value: 'exit' },
+  ]
+
+  const { action } = await inquirer.prompt<{ action: string }>([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'What would you like to do?',
+      choices,
+      pageSize: 12,
+    },
+  ])
+
+  switch (action) {
+    case 'create':
+      await handleCreate()
+      break
+    case 'list':
+      await handleList(showMainMenu)
+      break
+    case 'start':
+      await handleStart()
+      break
+    case 'stop':
+      await handleStop()
+      break
+    case 'restore':
+      await handleRestore()
+      break
+    case 'backup':
+      await handleBackup()
+      break
+    case 'clone':
+      await handleClone()
+      break
+    case 'engines':
+      await handleEngines()
+      break
+    case 'check-update':
+      await handleCheckUpdate()
+      break
+    case 'exit':
+      console.log(chalk.gray('\n  Goodbye!\n'))
+      process.exit(0)
+  }
+
+  await showMainMenu()
+}
+
+export const menuCommand = new Command('menu')
+  .description('Interactive menu for managing containers')
+  .action(async () => {
+    try {
+      await showMainMenu()
+    } catch (err) {
+      const e = err as Error
+
+      // Check if this is a missing tool error
+      if (
+        e.message.includes('pg_restore not found') ||
+        e.message.includes('psql not found') ||
+        e.message.includes('pg_dump not found')
+      ) {
+        const missingTool = e.message.includes('pg_restore')
+          ? 'pg_restore'
+          : e.message.includes('pg_dump')
+            ? 'pg_dump'
+            : 'psql'
+        const installed = await promptInstallDependencies(missingTool)
+        if (installed) {
+          console.log(chalk.yellow('  Please re-run spindb to continue.'))
+        }
+        process.exit(1)
+      }
+
+      console.error(error(e.message))
+      process.exit(1)
+    }
+  })

package/cli/commands/menu/shared.ts

@@ -0,0 +1,26 @@
+import chalk from 'chalk'
+import inquirer from 'inquirer'
+
+/**
+ * Menu choice type for inquirer list prompts
+ */
+export type MenuChoice =
+  | {
+      name: string
+      value: string
+      disabled?: boolean | string
+    }
+  | inquirer.Separator
+
+/**
+ * Helper to pause and wait for user to press Enter
+ */
+export async function pressEnterToContinue(): Promise<void> {
+  await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'continue',
+      message: chalk.gray('Press Enter to continue...'),
+    },
+  ])
+}