spindb 0.9.1 → 0.9.3

package/cli/commands/restore.ts

@@ -11,7 +11,7 @@ import {
   promptInstallDependencies,
 } from '../ui/prompts'
 import { createSpinner } from '../ui/spinner'
-import { success, error, warning } from '../ui/theme'
+import { uiSuccess, uiError, uiWarning } from '../ui/theme'
 import { tmpdir } from 'os'
 import { join } from 'path'
 import { getMissingDependencies } from '../../core/dependency-manager'
@@ -50,11 +50,13 @@ export const restoreCommand = new Command('restore')
           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',
                 ),
               )
@@ -72,7 +74,7 @@ export const restoreCommand = new Command('restore')
 
         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)
         }
 
@@ -83,7 +85,7 @@ export const restoreCommand = new Command('restore')
         })
         if (!running) {
           console.error(
-            error(
+            uiError(
               `Container "${containerName}" is not running. Start it first.`,
             ),
           )
@@ -113,7 +115,7 @@ export const restoreCommand = new Command('restore')
           missingDeps = await getMissingDependencies(config.engine)
           if (missingDeps.length > 0) {
             console.error(
-              error(
+              uiError(
                 `Still missing tools: ${missingDeps.map((d) => d.name).join(', ')}`,
               ),
             )
@@ -134,7 +136,7 @@ export const restoreCommand = new Command('restore')
 
           if (engineName === 'postgresql' && !isPgUrl) {
             console.error(
-              error(
+              uiError(
                 'Connection string must start with postgresql:// or postgres:// for PostgreSQL containers',
               ),
             )
@@ -143,7 +145,7 @@ export const restoreCommand = new Command('restore')
 
           if (engineName === 'mysql' && !isMysqlUrl) {
             console.error(
-              error(
+              uiError(
                 'Connection string must start with mysql:// for MySQL containers',
               ),
             )
@@ -152,7 +154,7 @@ export const restoreCommand = new Command('restore')
 
           if (!isPgUrl && !isMysqlUrl) {
             console.error(
-              error(
+              uiError(
                 'Connection string must start with postgresql://, postgres://, or mysql://',
               ),
             )
@@ -181,8 +183,8 @@ export const restoreCommand = new Command('restore')
               dumpSpinner.succeed('Dump created from remote database')
               backupPath = tempDumpPath
               dumpSuccess = true
-            } catch (err) {
-              const e = err as Error
+            } catch (error) {
+              const e = error as Error
               dumpSpinner.fail('Failed to create dump')
 
               const dumpTool = engineName === 'mysql' ? 'mysqldump' : 'pg_dump'
@@ -201,19 +203,19 @@ export const restoreCommand = new Command('restore')
               }
 
               console.log()
-              console.error(error(`${dumpTool} error:`))
+              console.error(uiError(`${dumpTool} error:`))
               console.log(chalk.gray(`  ${e.message}`))
               process.exit(1)
             }
           }
 
           if (!dumpSuccess) {
-            console.error(error('Failed to create dump after retries'))
+            console.error(uiError('Failed to create dump after retries'))
             process.exit(1)
           }
         } else {
           if (!backupPath) {
-            console.error(error('Backup file path is required'))
+            console.error(uiError('Backup file path is required'))
             console.log(
               chalk.gray('  Usage: spindb restore <container> <backup-file>'),
             )
@@ -226,7 +228,7 @@ export const restoreCommand = new Command('restore')
           }
 
           if (!existsSync(backupPath)) {
-            console.error(error(`Backup file not found: ${backupPath}`))
+            console.error(uiError(`Backup file not found: ${backupPath}`))
             process.exit(1)
           }
         }
@@ -237,7 +239,7 @@ export const restoreCommand = new Command('restore')
         }
 
         if (!backupPath) {
-          console.error(error('No backup path specified'))
+          console.error(uiError('No backup path specified'))
           process.exit(1)
         }
 
@@ -347,7 +349,7 @@ export const restoreCommand = new Command('restore')
           databaseName,
         )
         console.log()
-        console.log(success(`Database "${databaseName}" restored`))
+        console.log(uiSuccess(`Database "${databaseName}" restored`))
         console.log()
         console.log(chalk.gray('  Connection string:'))
         console.log(chalk.cyan(`  ${connectionString}`))
@@ -365,8 +367,8 @@ export const restoreCommand = new Command('restore')
           chalk.cyan(`  spindb connect ${containerName} -d ${databaseName}`),
         )
         console.log()
-      } catch (err) {
-        const e = err as Error
+      } catch (error) {
+        const e = error as Error
 
         const missingToolPatterns = [
           'pg_restore not found',
@@ -391,7 +393,7 @@ export const restoreCommand = new Command('restore')
           process.exit(1)
         }
 
-        console.error(error(e.message))
+        console.error(uiError(e.message))
         process.exit(1)
       } finally {
         if (tempDumpPath) {

package/cli/commands/run.ts

@@ -5,7 +5,7 @@ import { containerManager } from '../../core/container-manager'
 import { processManager } from '../../core/process-manager'
 import { getEngine } from '../../engines'
 import { promptInstallDependencies } from '../ui/prompts'
-import { error, warning } from '../ui/theme'
+import { uiError, uiWarning } from '../ui/theme'
 import { getMissingDependencies } from '../../core/dependency-manager'
 import { Engine } from '../../types'
 
@@ -26,7 +26,7 @@ export const runCommand = new Command('run')
 
         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)
         }
 
@@ -36,9 +36,7 @@ export const runCommand = new Command('run')
         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)
           }
@@ -49,7 +47,7 @@ export const runCommand = new Command('run')
           })
           if (!running) {
             console.error(
-              error(
+              uiError(
                 `Container "${containerName}" is not running. Start it first with: spindb start ${containerName}`,
               ),
             )
@@ -59,16 +57,16 @@ export const runCommand = new Command('run')
 
         if (file && options.sql) {
           console.error(
-            error('Cannot specify both a file and --sql option. Choose one.'),
+            uiError('Cannot specify both a file and --sql option. Choose one.'),
           )
           process.exit(1)
         }
 
         if (!file && !options.sql) {
-          console.error(error('Must provide either a SQL file or --sql option'))
-          console.log(
-            chalk.gray('  Usage: spindb run <container> <file.sql>'),
+          console.error(
+            uiError('Must provide either a SQL file or --sql option'),
           )
+          console.log(chalk.gray('  Usage: spindb run <container> <file.sql>'))
           console.log(
             chalk.gray('     or: spindb run <container> --sql "SELECT ..."'),
           )
@@ -76,7 +74,7 @@ export const runCommand = new Command('run')
         }
 
         if (file && !existsSync(file)) {
-          console.error(error(`SQL file not found: ${file}`))
+          console.error(uiError(`SQL file not found: ${file}`))
           process.exit(1)
         }
 
@@ -85,7 +83,7 @@ export const runCommand = new Command('run')
         let missingDeps = await getMissingDependencies(engineName)
         if (missingDeps.length > 0) {
           console.log(
-            warning(
+            uiWarning(
               `Missing tools: ${missingDeps.map((d) => d.name).join(', ')}`,
             ),
           )
@@ -102,7 +100,7 @@ export const runCommand = new Command('run')
           missingDeps = await getMissingDependencies(engineName)
           if (missingDeps.length > 0) {
             console.error(
-              error(
+              uiError(
                 `Still missing tools: ${missingDeps.map((d) => d.name).join(', ')}`,
               ),
             )
@@ -120,8 +118,8 @@ export const runCommand = new Command('run')
           sql: options.sql,
           database,
         })
-      } catch (err) {
-        const e = err as Error
+      } catch (error) {
+        const e = error as Error
 
         const missingToolPatterns = [
           'psql not found',
@@ -138,8 +136,12 @@ export const runCommand = new Command('run')
             .replace(' not found', '')
             .replace(' client', '')
           // Determine engine from the missing tool name
-          const toolEngine = missingTool === 'mysql' ? Engine.MySQL : Engine.PostgreSQL
-          const installed = await promptInstallDependencies(missingTool, toolEngine)
+          const toolEngine =
+            missingTool === 'mysql' ? Engine.MySQL : Engine.PostgreSQL
+          const installed = await promptInstallDependencies(
+            missingTool,
+            toolEngine,
+          )
           if (installed) {
             console.log(
               chalk.yellow('  Please re-run your command to continue.'),
@@ -148,7 +150,7 @@ export const runCommand = new Command('run')
           process.exit(1)
         }
 
-        console.error(error(e.message))
+        console.error(uiError(e.message))
         process.exit(1)
       }
     },

package/cli/commands/self-update.ts

@@ -3,7 +3,7 @@ import chalk from 'chalk'
 import inquirer from 'inquirer'
 import { updateManager } from '../../core/update-manager'
 import { createSpinner } from '../ui/spinner'
-import { success, error, info, header } from '../ui/theme'
+import { uiSuccess, uiError, uiInfo, header } from '../ui/theme'
 
 export const selfUpdateCommand = new Command('self-update')
   .alias('update')
@@ -24,7 +24,7 @@ export const selfUpdateCommand = new Command('self-update')
       if (!result) {
         checkSpinner.fail('Could not reach npm registry')
         console.log()
-        console.log(info('Check your internet connection and try again.'))
+        console.log(uiInfo('Check your internet connection and try again.'))
         console.log(chalk.gray('  Manual update: npm install -g spindb@latest'))
         process.exit(1)
       }
@@ -84,7 +84,7 @@ export const selfUpdateCommand = new Command('self-update')
         updateSpinner.succeed('Update complete')
         console.log()
         console.log(
-          success(
+          uiSuccess(
             `Updated from ${updateResult.previousVersion} to ${updateResult.newVersion}`,
           ),
         )
@@ -100,9 +100,9 @@ export const selfUpdateCommand = new Command('self-update')
       } else {
         updateSpinner.fail('Update failed')
         console.log()
-        console.log(error(updateResult.error || 'Unknown error'))
+        console.log(uiError(updateResult.error || 'Unknown error'))
         console.log()
-        console.log(info('Manual update: npm install -g spindb@latest'))
+        console.log(uiInfo('Manual update: npm install -g spindb@latest'))
         process.exit(1)
       }
     },

package/cli/commands/sqlite.ts

@@ -0,0 +1,247 @@
+import { Command } from 'commander'
+import chalk from 'chalk'
+import { existsSync } from 'fs'
+import { resolve, basename } from 'path'
+import { sqliteRegistry } from '../../engines/sqlite/registry'
+import {
+  scanForUnregisteredSqliteFiles,
+  deriveContainerName,
+} from '../../engines/sqlite/scanner'
+import { containerManager } from '../../core/container-manager'
+import { uiSuccess, uiError, uiInfo } from '../ui/theme'
+
+export const sqliteCommand = new Command('sqlite').description(
+  'SQLite-specific operations',
+)
+
+// sqlite scan
+sqliteCommand
+  .command('scan')
+  .description('Scan folder for unregistered SQLite files')
+  .option(
+    '-p, --path <dir>',
+    'Directory to scan (default: current directory)',
+  )
+  .option('--json', 'Output as JSON')
+  .action(async (options: { path?: string; json?: boolean }): Promise<void> => {
+    const dir = options.path ? resolve(options.path) : process.cwd()
+
+    if (!existsSync(dir)) {
+      if (options.json) {
+        console.log(
+          JSON.stringify({ error: 'Directory not found', directory: dir }),
+        )
+      } else {
+        console.error(uiError(`Directory not found: ${dir}`))
+      }
+      process.exit(1)
+    }
+
+    const unregistered = await scanForUnregisteredSqliteFiles(dir)
+
+    if (options.json) {
+      console.log(JSON.stringify({ directory: dir, files: unregistered }))
+      return
+    }
+
+    if (unregistered.length === 0) {
+      console.log(uiInfo(`No unregistered SQLite files found in ${dir}`))
+      return
+    }
+
+    console.log(
+      chalk.cyan(`Found ${unregistered.length} unregistered SQLite file(s):`),
+    )
+    for (const file of unregistered) {
+      console.log(chalk.gray(`  ${file.fileName}`))
+    }
+    console.log()
+    console.log(chalk.gray('  Register with: spindb attach <path>'))
+  })
+
+// sqlite ignore
+sqliteCommand
+  .command('ignore')
+  .description('Add folder to ignore list for CWD scanning')
+  .argument('[folder]', 'Folder path to ignore (default: current directory)')
+  .option('--json', 'Output as JSON')
+  .action(
+    async (folder: string | undefined, options: { json?: boolean }): Promise<void> => {
+      const absolutePath = resolve(folder || process.cwd())
+      await sqliteRegistry.addIgnoreFolder(absolutePath)
+
+      if (options.json) {
+        console.log(JSON.stringify({ success: true, folder: absolutePath }))
+      } else {
+        console.log(uiSuccess(`Added to ignore list: ${absolutePath}`))
+      }
+    },
+  )
+
+// sqlite unignore
+sqliteCommand
+  .command('unignore')
+  .description('Remove folder from ignore list')
+  .argument('[folder]', 'Folder path to unignore (default: current directory)')
+  .option('--json', 'Output as JSON')
+  .action(
+    async (folder: string | undefined, options: { json?: boolean }): Promise<void> => {
+      const absolutePath = resolve(folder || process.cwd())
+      const removed = await sqliteRegistry.removeIgnoreFolder(absolutePath)
+
+      if (options.json) {
+        console.log(JSON.stringify({ success: removed, folder: absolutePath }))
+      } else {
+        if (removed) {
+          console.log(uiSuccess(`Removed from ignore list: ${absolutePath}`))
+        } else {
+          console.log(uiInfo(`Folder was not in ignore list: ${absolutePath}`))
+        }
+      }
+    },
+  )
+
+// sqlite ignored (list ignored folders)
+sqliteCommand
+  .command('ignored')
+  .description('List ignored folders')
+  .option('--json', 'Output as JSON')
+  .action(async (options: { json?: boolean }): Promise<void> => {
+    const folders = await sqliteRegistry.listIgnoredFolders()
+
+    if (options.json) {
+      console.log(JSON.stringify({ folders }))
+      return
+    }
+
+    if (folders.length === 0) {
+      console.log(uiInfo('No folders are being ignored'))
+      return
+    }
+
+    console.log(chalk.cyan('Ignored folders:'))
+    for (const folder of folders) {
+      console.log(chalk.gray(`  ${folder}`))
+    }
+  })
+
+// sqlite attach (alias to top-level attach)
+sqliteCommand
+  .command('attach')
+  .description('Register an existing SQLite database (alias for "spindb attach")')
+  .argument('<path>', 'Path to SQLite database file')
+  .option('-n, --name <name>', 'Container name')
+  .option('--json', 'Output as JSON')
+  .action(
+    async (
+      path: string,
+      options: { name?: string; json?: boolean },
+    ): Promise<void> => {
+      try {
+        const absolutePath = resolve(path)
+
+        if (!existsSync(absolutePath)) {
+          if (options.json) {
+            console.log(
+              JSON.stringify({ success: false, error: 'File not found' }),
+            )
+          } else {
+            console.error(uiError(`File not found: ${absolutePath}`))
+          }
+          process.exit(1)
+        }
+
+        if (await sqliteRegistry.isPathRegistered(absolutePath)) {
+          const entry = await sqliteRegistry.getByPath(absolutePath)
+          if (options.json) {
+            console.log(
+              JSON.stringify({
+                success: false,
+                error: 'Already registered',
+                existingName: entry?.name,
+              }),
+            )
+          } else {
+            console.error(
+              uiError(`File is already registered as "${entry?.name}"`),
+            )
+          }
+          process.exit(1)
+        }
+
+        const containerName =
+          options.name || deriveContainerName(basename(absolutePath))
+
+        if (await containerManager.exists(containerName)) {
+          if (options.json) {
+            console.log(
+              JSON.stringify({
+                success: false,
+                error: 'Container name already exists',
+              }),
+            )
+          } else {
+            console.error(uiError(`Container "${containerName}" already exists`))
+          }
+          process.exit(1)
+        }
+
+        await sqliteRegistry.add({
+          name: containerName,
+          filePath: absolutePath,
+          created: new Date().toISOString(),
+        })
+
+        if (options.json) {
+          console.log(
+            JSON.stringify({
+              success: true,
+              name: containerName,
+              filePath: absolutePath,
+            }),
+          )
+        } else {
+          console.log(
+            uiSuccess(
+              `Registered "${basename(absolutePath)}" as "${containerName}"`,
+            ),
+          )
+          console.log()
+          console.log(chalk.gray('  Connect with:'))
+          console.log(chalk.cyan(`    spindb connect ${containerName}`))
+        }
+      } catch (error) {
+        const e = error as Error
+        if (options.json) {
+          console.log(JSON.stringify({ success: false, error: e.message }))
+        } else {
+          console.error(uiError(e.message))
+        }
+        process.exit(1)
+      }
+    },
+  )
+
+// sqlite detach (alias to top-level detach)
+sqliteCommand
+  .command('detach')
+  .description('Unregister a SQLite database (alias for "spindb detach")')
+  .argument('<name>', 'Container name')
+  .option('-f, --force', 'Skip confirmation')
+  .option('--json', 'Output as JSON')
+  .action(
+    async (
+      name: string,
+      options: { force?: boolean; json?: boolean },
+    ): Promise<void> => {
+      // Import dynamically to avoid circular dependency issues
+      const { detachCommand } = await import('./detach')
+
+      // Build args array
+      const args = ['node', 'detach', name]
+      if (options.force) args.push('-f')
+      if (options.json) args.push('--json')
+
+      await detachCommand.parseAsync(args, { from: 'node' })
+    },
+  )

package/cli/commands/start.ts

@@ -7,7 +7,7 @@ import { getEngine } from '../../engines'
 import { getEngineDefaults } from '../../config/defaults'
 import { promptContainerSelect } from '../ui/prompts'
 import { createSpinner } from '../ui/spinner'
-import { error, warning } from '../ui/theme'
+import { uiError, uiWarning } from '../ui/theme'
 
 export const startCommand = new Command('start')
   .description('Start a container')
@@ -23,10 +23,10 @@ export const startCommand = new Command('start')
         if (stopped.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('All containers are already running'))
+            console.log(uiWarning('All containers are already running'))
           }
           return
         }
@@ -41,7 +41,7 @@ export const startCommand = new Command('start')
 
       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)
       }
 
@@ -51,7 +51,9 @@ export const startCommand = new Command('start')
         engine: engineName,
       })
       if (running) {
-        console.log(warning(`Container "${containerName}" is already running`))
+        console.log(
+          uiWarning(`Container "${containerName}" is already running`),
+        )
         return
       }
 
@@ -72,7 +74,7 @@ export const startCommand = new Command('start')
       if (!result.success) {
         spinner.fail(`Failed to start "${containerName}"`)
         if (result.error) {
-          console.error(error(result.error.message))
+          console.error(uiError(result.error.message))
         }
         process.exit(1)
       }
@@ -110,9 +112,9 @@ export const startCommand = new Command('start')
       console.log(chalk.gray('  Connect with:'))
       console.log(chalk.cyan(`  spindb connect ${containerName}`))
       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/stop.ts

@@ -4,7 +4,7 @@ import { processManager } from '../../core/process-manager'
 import { getEngine } from '../../engines'
 import { promptContainerSelect } from '../ui/prompts'
 import { createSpinner } from '../ui/spinner'
-import { success, error, warning } from '../ui/theme'
+import { uiSuccess, uiError, uiWarning } from '../ui/theme'
 
 export const stopCommand = new Command('stop')
   .description('Stop a container')
@@ -17,7 +17,7 @@ export const stopCommand = new Command('stop')
         const running = containers.filter((c) => c.status === 'running')
 
         if (running.length === 0) {
-          console.log(warning('No running containers found'))
+          console.log(uiWarning('No running containers found'))
           return
         }
 
@@ -34,7 +34,7 @@ export const stopCommand = new Command('stop')
           spinner.succeed(`Stopped "${container.name}"`)
         }
 
-        console.log(success(`Stopped ${running.length} container(s)`))
+        console.log(uiSuccess(`Stopped ${running.length} container(s)`))
         return
       }
 
@@ -45,7 +45,7 @@ export const stopCommand = new Command('stop')
         const running = containers.filter((c) => c.status === 'running')
 
         if (running.length === 0) {
-          console.log(warning('No running containers found'))
+          console.log(uiWarning('No running containers found'))
           return
         }
 
@@ -59,7 +59,7 @@ export const stopCommand = new Command('stop')
 
       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)
       }
 
@@ -67,7 +67,7 @@ export const stopCommand = new Command('stop')
         engine: config.engine,
       })
       if (!running) {
-        console.log(warning(`Container "${containerName}" is not running`))
+        console.log(uiWarning(`Container "${containerName}" is not running`))
         return
       }
 
@@ -80,9 +80,9 @@ export const stopCommand = new Command('stop')
       await containerManager.updateConfig(containerName, { status: 'stopped' })
 
       spinner.succeed(`Container "${containerName}" stopped`)
-    } 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)
     }
   })