spindb 0.7.0 → 0.7.3

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

@@ -0,0 +1,331 @@
+import chalk from 'chalk'
+import inquirer from 'inquirer'
+import { spawn } from 'child_process'
+import { containerManager } from '../../../core/container-manager'
+import {
+  isUsqlInstalled,
+  isPgcliInstalled,
+  isMycliInstalled,
+  detectPackageManager,
+  installUsql,
+  installPgcli,
+  installMycli,
+  getUsqlManualInstructions,
+  getPgcliManualInstructions,
+  getMycliManualInstructions,
+} from '../../../core/dependency-manager'
+import { platformService } from '../../../core/platform-service'
+import { getEngine } from '../../../engines'
+import { createSpinner } from '../../ui/spinner'
+import { error, warning, info, success } from '../../ui/theme'
+import { pressEnterToContinue } from './shared'
+
+export async function handleCopyConnectionString(
+  containerName: string,
+): Promise<void> {
+  const config = await containerManager.getConfig(containerName)
+  if (!config) {
+    console.error(error(`Container "${containerName}" not found`))
+    return
+  }
+
+  const engine = getEngine(config.engine)
+  const connectionString = engine.getConnectionString(config)
+
+  // Copy to clipboard using platform service
+  const copied = await platformService.copyToClipboard(connectionString)
+
+  console.log()
+  if (copied) {
+    console.log(success('Connection string copied to clipboard'))
+    console.log(chalk.gray(`  ${connectionString}`))
+  } else {
+    console.log(warning('Could not copy to clipboard. Connection string:'))
+    console.log(chalk.cyan(`  ${connectionString}`))
+  }
+  console.log()
+
+  await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'continue',
+      message: chalk.gray('Press Enter to continue...'),
+    },
+  ])
+}
+
+export async function handleOpenShell(containerName: string): Promise<void> {
+  const config = await containerManager.getConfig(containerName)
+  if (!config) {
+    console.error(error(`Container "${containerName}" not found`))
+    return
+  }
+
+  const engine = getEngine(config.engine)
+  const connectionString = engine.getConnectionString(config)
+
+  // Check which enhanced shells are installed (with loading indicator)
+  const shellCheckSpinner = createSpinner('Checking available shells...')
+  shellCheckSpinner.start()
+
+  const [usqlInstalled, pgcliInstalled, mycliInstalled] = await Promise.all([
+    isUsqlInstalled(),
+    isPgcliInstalled(),
+    isMycliInstalled(),
+  ])
+
+  shellCheckSpinner.stop()
+  // Clear the spinner line
+  process.stdout.write('\x1b[1A\x1b[2K')
+
+  type ShellChoice =
+    | 'default'
+    | 'usql'
+    | 'install-usql'
+    | 'pgcli'
+    | 'install-pgcli'
+    | 'mycli'
+    | 'install-mycli'
+    | 'back'
+
+  const defaultShellName = config.engine === 'mysql' ? 'mysql' : 'psql'
+  const engineSpecificCli = config.engine === 'mysql' ? 'mycli' : 'pgcli'
+  const engineSpecificInstalled =
+    config.engine === 'mysql' ? mycliInstalled : pgcliInstalled
+
+  const choices: Array<{ name: string; value: ShellChoice } | inquirer.Separator> = [
+    {
+      name: `>_ Use default shell (${defaultShellName})`,
+      value: 'default',
+    },
+  ]
+
+  // Engine-specific enhanced CLI (pgcli for PostgreSQL, mycli for MySQL)
+  if (engineSpecificInstalled) {
+    choices.push({
+      name: `⚡ Use ${engineSpecificCli} (enhanced features, recommended)`,
+      value: config.engine === 'mysql' ? 'mycli' : 'pgcli',
+    })
+  } else {
+    choices.push({
+      name: `↓ Install ${engineSpecificCli} (enhanced features, recommended)`,
+      value: config.engine === 'mysql' ? 'install-mycli' : 'install-pgcli',
+    })
+  }
+
+  // usql - universal option
+  if (usqlInstalled) {
+    choices.push({
+      name: '⚡ Use usql (universal SQL client)',
+      value: 'usql',
+    })
+  } else {
+    choices.push({
+      name: '↓ Install usql (universal SQL client)',
+      value: 'install-usql',
+    })
+  }
+
+  choices.push(new inquirer.Separator())
+  choices.push({
+    name: `${chalk.blue('←')} Back`,
+    value: 'back',
+  })
+
+  const { shellChoice } = await inquirer.prompt<{ shellChoice: ShellChoice }>([
+    {
+      type: 'list',
+      name: 'shellChoice',
+      message: 'Select shell option:',
+      choices,
+      pageSize: 10,
+    },
+  ])
+
+  if (shellChoice === 'back') {
+    return
+  }
+
+  // Handle pgcli installation
+  if (shellChoice === 'install-pgcli') {
+    console.log()
+    console.log(info('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()
+        await launchShell(containerName, config, connectionString, 'pgcli')
+      } else {
+        console.error(error(`Failed to install pgcli: ${result.error}`))
+        console.log()
+        console.log(chalk.gray('Manual installation:'))
+        for (const instruction of getPgcliManualInstructions()) {
+          console.log(chalk.cyan(`  ${instruction}`))
+        }
+        console.log()
+        await pressEnterToContinue()
+      }
+    } else {
+      console.error(error('No supported package manager found'))
+      console.log()
+      console.log(chalk.gray('Manual installation:'))
+      for (const instruction of getPgcliManualInstructions()) {
+        console.log(chalk.cyan(`  ${instruction}`))
+      }
+      console.log()
+      await pressEnterToContinue()
+    }
+    return
+  }
+
+  // Handle mycli installation
+  if (shellChoice === 'install-mycli') {
+    console.log()
+    console.log(info('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()
+        await launchShell(containerName, config, connectionString, 'mycli')
+      } else {
+        console.error(error(`Failed to install mycli: ${result.error}`))
+        console.log()
+        console.log(chalk.gray('Manual installation:'))
+        for (const instruction of getMycliManualInstructions()) {
+          console.log(chalk.cyan(`  ${instruction}`))
+        }
+        console.log()
+        await pressEnterToContinue()
+      }
+    } else {
+      console.error(error('No supported package manager found'))
+      console.log()
+      console.log(chalk.gray('Manual installation:'))
+      for (const instruction of getMycliManualInstructions()) {
+        console.log(chalk.cyan(`  ${instruction}`))
+      }
+      console.log()
+      await pressEnterToContinue()
+    }
+    return
+  }
+
+  // Handle usql installation
+  if (shellChoice === 'install-usql') {
+    console.log()
+    console.log(info('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()
+        await launchShell(containerName, config, connectionString, 'usql')
+      } else {
+        console.error(error(`Failed to install usql: ${result.error}`))
+        console.log()
+        console.log(chalk.gray('Manual installation:'))
+        for (const instruction of getUsqlManualInstructions()) {
+          console.log(chalk.cyan(`  ${instruction}`))
+        }
+        console.log()
+        await pressEnterToContinue()
+      }
+    } else {
+      console.error(error('No supported package manager found'))
+      console.log()
+      console.log(chalk.gray('Manual installation:'))
+      for (const instruction of getUsqlManualInstructions()) {
+        console.log(chalk.cyan(`  ${instruction}`))
+      }
+      console.log()
+      await pressEnterToContinue()
+    }
+    return
+  }
+
+  // Launch the selected shell
+  await launchShell(containerName, config, connectionString, shellChoice)
+}
+
+async function launchShell(
+  containerName: string,
+  config: NonNullable<Awaited<ReturnType<typeof containerManager.getConfig>>>,
+  connectionString: string,
+  shellType: 'default' | 'usql' | 'pgcli' | 'mycli',
+): Promise<void> {
+  console.log(info(`Connecting to ${containerName}...`))
+  console.log()
+
+  // Determine shell command based on engine and shell type
+  let shellCmd: string
+  let shellArgs: string[]
+  let installHint: string
+
+  if (shellType === 'pgcli') {
+    // pgcli accepts connection strings
+    shellCmd = 'pgcli'
+    shellArgs = [connectionString]
+    installHint = 'brew install pgcli'
+  } else if (shellType === 'mycli') {
+    // mycli: mycli -h host -P port -u user database
+    shellCmd = 'mycli'
+    shellArgs = [
+      '-h',
+      '127.0.0.1',
+      '-P',
+      String(config.port),
+      '-u',
+      'root',
+      config.database,
+    ]
+    installHint = 'brew install mycli'
+  } else if (shellType === 'usql') {
+    // usql accepts connection strings directly for both PostgreSQL and MySQL
+    shellCmd = 'usql'
+    shellArgs = [connectionString]
+    installHint = 'brew tap xo/xo && brew install xo/xo/usql'
+  } else if (config.engine === 'mysql') {
+    shellCmd = 'mysql'
+    // MySQL connection: mysql -u root -h 127.0.0.1 -P port database
+    shellArgs = [
+      '-u',
+      'root',
+      '-h',
+      '127.0.0.1',
+      '-P',
+      String(config.port),
+      config.database,
+    ]
+    installHint = 'brew install mysql-client'
+  } else {
+    // PostgreSQL (default)
+    shellCmd = 'psql'
+    shellArgs = [connectionString]
+    installHint = 'brew install libpq && brew link --force libpq'
+  }
+
+  const shellProcess = spawn(shellCmd, shellArgs, {
+    stdio: 'inherit',
+  })
+
+  shellProcess.on('error', (err: NodeJS.ErrnoException) => {
+    if (err.code === 'ENOENT') {
+      console.log(warning(`${shellCmd} not found on your system.`))
+      console.log()
+      console.log(chalk.gray('  Connect manually with:'))
+      console.log(chalk.cyan(`  ${connectionString}`))
+      console.log()
+      console.log(chalk.gray(`  Install ${shellCmd}:`))
+      console.log(chalk.cyan(`  ${installHint}`))
+    }
+  })
+
+  await new Promise<void>((resolve) => {
+    shellProcess.on('close', () => resolve())
+  })
+}

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

@@ -0,0 +1,197 @@
+import chalk from 'chalk'
+import inquirer from 'inquirer'
+import { existsSync } from 'fs'
+import { readFile } from 'fs/promises'
+import { spawn } from 'child_process'
+import { containerManager } from '../../../core/container-manager'
+import { getMissingDependencies } from '../../../core/dependency-manager'
+import { getEngine } from '../../../engines'
+import { paths } from '../../../config/paths'
+import { promptInstallDependencies, promptDatabaseSelect } from '../../ui/prompts'
+import { error, warning, info, success } from '../../ui/theme'
+import { pressEnterToContinue } from './shared'
+
+export async function handleRunSql(containerName: string): Promise<void> {
+  const config = await containerManager.getConfig(containerName)
+  if (!config) {
+    console.error(error(`Container "${containerName}" not found`))
+    return
+  }
+
+  const engine = getEngine(config.engine)
+
+  // Check for required client tools
+  let missingDeps = await getMissingDependencies(config.engine)
+  if (missingDeps.length > 0) {
+    console.log(
+      warning(`Missing tools: ${missingDeps.map((d) => d.name).join(', ')}`),
+    )
+
+    const installed = await promptInstallDependencies(
+      missingDeps[0].binary,
+      config.engine,
+    )
+
+    if (!installed) {
+      return
+    }
+
+    missingDeps = await getMissingDependencies(config.engine)
+    if (missingDeps.length > 0) {
+      console.log(
+        error(
+          `Still missing tools: ${missingDeps.map((d) => d.name).join(', ')}`,
+        ),
+      )
+      return
+    }
+
+    console.log(chalk.green('  ✓ All required tools are now available'))
+    console.log()
+  }
+
+  // Strip quotes that terminals add when drag-and-dropping files
+  const stripQuotes = (path: string) =>
+    path.replace(/^['"]|['"]$/g, '').trim()
+
+  // Prompt for file path (empty input = go back)
+  console.log(chalk.gray('  Drag & drop, enter path (abs or rel), or press Enter to go back'))
+  const { filePath: rawFilePath } = await inquirer.prompt<{
+    filePath: string
+  }>([
+    {
+      type: 'input',
+      name: 'filePath',
+      message: 'SQL file path:',
+      validate: (input: string) => {
+        if (!input) return true // Empty = go back
+        const cleanPath = stripQuotes(input)
+        if (!existsSync(cleanPath)) return 'File not found'
+        return true
+      },
+    },
+  ])
+
+  // Empty input = go back to submenu
+  if (!rawFilePath.trim()) {
+    return
+  }
+
+  const filePath = stripQuotes(rawFilePath)
+
+  // Select database if container has multiple
+  const databases = config.databases || [config.database]
+  let databaseName: string
+
+  if (databases.length > 1) {
+    databaseName = await promptDatabaseSelect(
+      databases,
+      'Select database to run SQL against:',
+    )
+  } else {
+    databaseName = databases[0]
+  }
+
+  console.log()
+  console.log(info(`Running SQL file against "${databaseName}"...`))
+  console.log()
+
+  try {
+    await engine.runScript(config, {
+      file: filePath,
+      database: databaseName,
+    })
+    console.log()
+    console.log(success('SQL file executed successfully'))
+  } catch (err) {
+    const e = err as Error
+    console.log()
+    console.log(error(`SQL execution failed: ${e.message}`))
+  }
+
+  console.log()
+  await pressEnterToContinue()
+}
+
+/**
+ * View container logs with interactive options
+ */
+export async function handleViewLogs(containerName: string): Promise<void> {
+  const config = await containerManager.getConfig(containerName)
+  if (!config) {
+    console.error(error(`Container "${containerName}" not found`))
+    return
+  }
+
+  const logPath = paths.getContainerLogPath(config.name, {
+    engine: config.engine,
+  })
+
+  if (!existsSync(logPath)) {
+    console.log(
+      info(
+        `No log file found for "${containerName}". The container may not have been started yet.`,
+      ),
+    )
+    await pressEnterToContinue()
+    return
+  }
+
+  const { action } = await inquirer.prompt<{ action: string }>([
+    {
+      type: 'list',
+      name: 'action',
+      message: 'How would you like to view logs?',
+      choices: [
+        { name: 'View last 50 lines', value: 'tail-50' },
+        { name: 'View last 100 lines', value: 'tail-100' },
+        { name: 'Follow logs (live)', value: 'follow' },
+        { name: 'Open in editor', value: 'editor' },
+        { name: `${chalk.blue('←')} Back`, value: 'back' },
+      ],
+    },
+  ])
+
+  if (action === 'back') {
+    return
+  }
+
+  if (action === 'editor') {
+    const editorCmd = process.env.EDITOR || 'vi'
+    const child = spawn(editorCmd, [logPath], { stdio: 'inherit' })
+    await new Promise<void>((resolve) => {
+      child.on('close', () => resolve())
+    })
+    return
+  }
+
+  if (action === 'follow') {
+    console.log(chalk.gray('  Press Ctrl+C to stop following logs'))
+    console.log()
+    const child = spawn('tail', ['-n', '50', '-f', logPath], {
+      stdio: 'inherit',
+    })
+    await new Promise<void>((resolve) => {
+      process.on('SIGINT', () => {
+        child.kill('SIGTERM')
+        resolve()
+      })
+      child.on('close', () => resolve())
+    })
+    return
+  }
+
+  // tail-50 or tail-100
+  const lineCount = action === 'tail-100' ? 100 : 50
+  const content = await readFile(logPath, 'utf-8')
+  if (content.trim() === '') {
+    console.log(info('Log file is empty'))
+  } else {
+    const lines = content.split('\n')
+    const nonEmptyLines =
+      lines[lines.length - 1] === '' ? lines.slice(0, -1) : lines
+    console.log(nonEmptyLines.slice(-lineCount).join('\n'))
+  }
+  console.log()
+  await pressEnterToContinue()
+}

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

@@ -0,0 +1,94 @@
+import chalk from 'chalk'
+import inquirer from 'inquirer'
+import { updateManager } from '../../../core/update-manager'
+import { createSpinner } from '../../ui/spinner'
+import { header, success, error, warning, info } from '../../ui/theme'
+import { pressEnterToContinue } from './shared'
+
+export async function handleCheckUpdate(): Promise<void> {
+  console.clear()
+  console.log(header('Check for Updates'))
+  console.log()
+
+  const spinner = createSpinner('Checking for updates...')
+  spinner.start()
+
+  const result = await updateManager.checkForUpdate(true)
+
+  if (!result) {
+    spinner.fail('Could not reach npm registry')
+    console.log()
+    console.log(info('Check your internet connection and try again.'))
+    console.log(chalk.gray('  Manual update: npm install -g spindb@latest'))
+    console.log()
+    await pressEnterToContinue()
+    return
+  }
+
+  if (result.updateAvailable) {
+    spinner.succeed('Update available')
+    console.log()
+    console.log(chalk.gray(`  Current version: ${result.currentVersion}`))
+    console.log(
+      chalk.gray(`  Latest version:  ${chalk.green(result.latestVersion)}`),
+    )
+    console.log()
+
+    const { action } = await inquirer.prompt<{ action: string }>([
+      {
+        type: 'list',
+        name: 'action',
+        message: 'What would you like to do?',
+        choices: [
+          { name: 'Update now', value: 'update' },
+          { name: 'Remind me later', value: 'later' },
+          { name: "Don't check for updates on startup", value: 'disable' },
+        ],
+      },
+    ])
+
+    if (action === 'update') {
+      console.log()
+      const updateSpinner = createSpinner('Updating spindb...')
+      updateSpinner.start()
+
+      const updateResult = await updateManager.performUpdate()
+
+      if (updateResult.success) {
+        updateSpinner.succeed('Update complete')
+        console.log()
+        console.log(
+          success(
+            `Updated from ${updateResult.previousVersion} to ${updateResult.newVersion}`,
+          ),
+        )
+        console.log()
+        if (updateResult.previousVersion !== updateResult.newVersion) {
+          console.log(warning('Please restart spindb to use the new version.'))
+          console.log()
+        }
+      } else {
+        updateSpinner.fail('Update failed')
+        console.log()
+        console.log(error(updateResult.error || 'Unknown error'))
+        console.log()
+        console.log(info('Manual update: npm install -g spindb@latest'))
+      }
+      await pressEnterToContinue()
+    } else if (action === 'disable') {
+      await updateManager.setAutoCheckEnabled(false)
+      console.log()
+      console.log(info('Update checks disabled on startup.'))
+      console.log(chalk.gray('  Re-enable with: spindb config update-check on'))
+      console.log()
+      await pressEnterToContinue()
+    }
+    // 'later' just returns to menu
+  } else {
+    spinner.succeed('You are on the latest version')
+    console.log()
+    console.log(chalk.gray(`  Version: ${result.currentVersion}`))
+    console.log()
+    await pressEnterToContinue()
+  }
+}