spindb 0.31.4 → 0.33.1

package/cli/helpers.ts

@@ -224,6 +224,26 @@ export type InstalledQuestDBEngine = {
   source: 'downloaded'
 }
 
+export type InstalledTypeDBEngine = {
+  engine: 'typedb'
+  version: string
+  platform: string
+  arch: string
+  path: string
+  sizeBytes: number
+  source: 'downloaded'
+}
+
+export type InstalledInfluxDBEngine = {
+  engine: 'influxdb'
+  version: string
+  platform: string
+  arch: string
+  path: string
+  sizeBytes: number
+  source: 'downloaded'
+}
+
 export type InstalledEngine =
   | InstalledPostgresEngine
   | InstalledMariadbEngine
@@ -241,6 +261,8 @@ export type InstalledEngine =
   | InstalledCockroachDBEngine
   | InstalledSurrealDBEngine
   | InstalledQuestDBEngine
+  | InstalledTypeDBEngine
+  | InstalledInfluxDBEngine
 
 async function getPostgresVersion(binPath: string): Promise<string | null> {
   const ext = platformService.getExecutableExtension()
@@ -1088,6 +1110,114 @@ async function getInstalledQuestDBEngines(): Promise<InstalledQuestDBEngine[]> {
   return engines
 }
 
+// Get TypeDB version from binary path
+// TypeDB is a Rust binary but uses a launcher script. Check for server binary existence.
+async function getTypeDBVersion(binPath: string): Promise<string | null> {
+  const ext = platformService.getExecutableExtension()
+  const serverPath = join(binPath, 'bin', 'server', `typedb_server_bin${ext}`)
+  if (!existsSync(serverPath)) {
+    return null
+  }
+  // TypeDB server binary doesn't have a simple --version flag
+  // Return null to use directory-parsed version
+  return null
+}
+
+// Get installed TypeDB engines from downloaded binaries
+async function getInstalledTypeDBEngines(): Promise<InstalledTypeDBEngine[]> {
+  const binDir = paths.bin
+
+  if (!existsSync(binDir)) {
+    return []
+  }
+
+  const entries = await readdir(binDir, { withFileTypes: true })
+  const engines: InstalledTypeDBEngine[] = []
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    if (!entry.name.startsWith('typedb-')) continue
+
+    const parsed = parseEngineDirectory(entry.name, 'typedb-', binDir)
+    if (!parsed) continue
+
+    const actualVersion =
+      (await getTypeDBVersion(parsed.path)) || parsed.version
+    const sizeBytes = await calculateDirectorySize(parsed.path)
+
+    engines.push({
+      engine: 'typedb',
+      version: actualVersion,
+      platform: parsed.platform,
+      arch: parsed.arch,
+      path: parsed.path,
+      sizeBytes,
+      source: 'downloaded',
+    })
+  }
+
+  engines.sort((a, b) => compareVersions(b.version, a.version))
+
+  return engines
+}
+
+// Get InfluxDB version from binary path
+async function getInfluxDBVersion(binPath: string): Promise<string | null> {
+  const ext = platformService.getExecutableExtension()
+  const influxdbPath = join(binPath, 'bin', `influxdb3${ext}`)
+  if (!existsSync(influxdbPath)) {
+    return null
+  }
+
+  try {
+    const { stdout } = await execFileAsync(influxdbPath, ['--version'])
+    const match = stdout.match(/v?(\d+\.\d+\.\d+)/)
+    return match ? match[1] : null
+  } catch {
+    return null
+  }
+}
+
+// Get installed InfluxDB engines from downloaded binaries
+async function getInstalledInfluxDBEngines(): Promise<
+  InstalledInfluxDBEngine[]
+> {
+  const binDir = paths.bin
+
+  if (!existsSync(binDir)) {
+    return []
+  }
+
+  const entries = await readdir(binDir, { withFileTypes: true })
+  const engines: InstalledInfluxDBEngine[] = []
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue
+    if (!entry.name.startsWith('influxdb-')) continue
+
+    const parsed = parseEngineDirectory(entry.name, 'influxdb-', binDir)
+    if (!parsed) continue
+
+    const actualVersion =
+      (await getInfluxDBVersion(parsed.path)) || parsed.version
+    const sizeBytes = await calculateDirectorySize(parsed.path)
+
+    engines.push({
+      engine: 'influxdb',
+      version: actualVersion,
+      platform: parsed.platform,
+      arch: parsed.arch,
+      path: parsed.path,
+      sizeBytes,
+      source: 'downloaded',
+    })
+  }
+
+  engines.sort((a, b) => compareVersions(b.version, a.version))
+
+  return engines
+}
+
 // Get FerretDB version from binary path
 async function getFerretDBVersion(binPath: string): Promise<string | null> {
   const ext = platformService.getExecutableExtension()
@@ -1182,6 +1312,8 @@ const ENGINE_PREFIXES = [
   'cockroachdb-',
   'surrealdb-',
   'questdb-',
+  'typedb-',
+  'influxdb-',
 ] as const
 
 /**
@@ -1228,6 +1360,8 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     cockroachdbEngines,
     surrealdbEngines,
     questdbEngines,
+    typedbEngines,
+    influxdbEngines,
   ] = await Promise.all([
     getInstalledPostgresEngines(),
     getInstalledMariadbEngines(),
@@ -1245,6 +1379,8 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     getInstalledCockroachDBEngines(),
     getInstalledSurrealDBEngines(),
     getInstalledQuestDBEngines(),
+    getInstalledTypeDBEngines(),
+    getInstalledInfluxDBEngines(),
   ])
 
   return [
@@ -1264,6 +1400,8 @@ export async function getInstalledEngines(): Promise<InstalledEngine[]> {
     ...cockroachdbEngines,
     ...surrealdbEngines,
     ...questdbEngines,
+    ...typedbEngines,
+    ...influxdbEngines,
   ]
 }
 
@@ -1283,4 +1421,6 @@ export {
   getInstalledCockroachDBEngines,
   getInstalledSurrealDBEngines,
   getInstalledQuestDBEngines,
+  getInstalledTypeDBEngines,
+  getInstalledInfluxDBEngines,
 }

package/cli/index.ts

@@ -31,6 +31,7 @@ import { pullCommand } from './commands/pull'
 import { whichCommand } from './commands/which'
 import { exportCommand } from './commands/export'
 import { queryCommand } from './commands/query'
+import { usersCommand } from './commands/users'
 import { updateManager } from '../core/update-manager'
 import { configManager } from '../core/config-manager'
 import { setCachedIconMode } from './constants'
@@ -144,6 +145,7 @@ export async function run(): Promise<void> {
   program.addCommand(whichCommand)
   program.addCommand(exportCommand)
   program.addCommand(queryCommand)
+  program.addCommand(usersCommand)
 
   if (process.argv.length <= 2) {
     // Only show update notification in interactive menu mode (once at startup)

package/cli/ui/prompts.ts

@@ -472,40 +472,44 @@ export async function promptEngine(options?: {
 }): Promise<string> {
   const engines = listEngines()
 
-  type Choice =
-    | { name: string; value: string; short?: string }
-    | inquirer.Separator
-
-  const choices: Choice[] = engines.map((e) => ({
+  const engineChoices: FilterableChoice[] = engines.map((e) => ({
     name: `${getEngineIcon(e.name)} ${e.displayName} ${chalk.gray(`(versions: ${e.supportedVersions.join(', ')})`)}`,
     value: e.name,
     short: e.displayName,
   }))
 
+  const footerChoices: (FilterableChoice | inquirer.Separator)[] = [
+    new inquirer.Separator(),
+    new inquirer.Separator(
+      chalk.gray(`  ${engines.length} engines — type to filter`),
+    ),
+  ]
+
   if (options?.includeBack) {
-    choices.push(new inquirer.Separator())
-    choices.push({ name: `${chalk.blue('←')} Back`, value: BACK_VALUE })
-    choices.push({
+    footerChoices.push(new inquirer.Separator())
+    footerChoices.push({
+      name: `${chalk.blue('←')} Back`,
+      value: BACK_VALUE,
+    })
+    footerChoices.push({
       name: `${chalk.blue('⌂')} Back to main menu ${chalk.gray('(esc)')}`,
       value: MAIN_MENU_VALUE,
     })
-    choices.push(new inquirer.Separator())
   }
 
-  const { engine } = await escapeablePrompt<{ engine: string }>([
+  footerChoices.push(new inquirer.Separator())
+
+  const allChoices = [...engineChoices, ...footerChoices]
+
+  const engine = await filterableListPrompt(
+    allChoices,
+    'Select database engine:',
     {
-      type: 'list',
-      name: 'engine',
-      message: 'Select database engine:',
-      choices,
+      filterableCount: engineChoices.length,
       pageSize: getPageSize(),
+      emptyText: 'No engines match filter',
     },
-  ])
-
-  // Escape returns to main menu
-  if (engine === ESCAPE_VALUE) {
-    return MAIN_MENU_VALUE
-  }
+  )
 
   return engine
 }

package/config/backup-formats.ts

@@ -26,6 +26,8 @@ import {
   type CockroachDBFormat,
   type SurrealDBFormat,
   type QuestDBFormat,
+  type TypeDBFormat,
+  type InfluxDBFormat,
   type BackupFormatType,
 } from '../types'
 
@@ -61,6 +63,8 @@ export const BACKUP_FORMATS: {
   [Engine.CockroachDB]: EngineBackupFormats<CockroachDBFormat>
   [Engine.SurrealDB]: EngineBackupFormats<SurrealDBFormat>
   [Engine.QuestDB]: EngineBackupFormats<QuestDBFormat>
+  [Engine.TypeDB]: EngineBackupFormats<TypeDBFormat>
+  [Engine.InfluxDB]: EngineBackupFormats<InfluxDBFormat>
 } = {
   [Engine.PostgreSQL]: {
     formats: {
@@ -308,6 +312,30 @@ export const BACKUP_FORMATS: {
     supportsFormatChoice: false, // Only SQL format supported
     defaultFormat: 'sql',
   },
+  [Engine.TypeDB]: {
+    formats: {
+      typeql: {
+        extension: '.typeql',
+        label: '.typeql',
+        description: 'TypeQL dump - schema and data as TypeQL statements',
+        spinnerLabel: 'TypeQL',
+      },
+    },
+    supportsFormatChoice: false, // Only TypeQL format supported
+    defaultFormat: 'typeql',
+  },
+  [Engine.InfluxDB]: {
+    formats: {
+      sql: {
+        extension: '.sql',
+        label: '.sql',
+        description: 'SQL dump - time-series data as SQL statements',
+        spinnerLabel: 'SQL',
+      },
+    },
+    supportsFormatChoice: false, // Only SQL format supported
+    defaultFormat: 'sql',
+  },
 }
 
 /**

package/config/engine-defaults.ts

@@ -239,6 +239,32 @@ export const engineDefaults: Record<Engine, EngineDefaults> = {
     clientTools: ['questdb'],
     maxConnections: 0, // Not applicable - managed internally
   },
+  [Engine.TypeDB]: {
+    defaultVersion: '3',
+    defaultPort: 1729, // TypeDB main port (gRPC protocol)
+    portRange: { start: 1729, end: 1829 },
+    latestVersion: '3',
+    superuser: 'admin', // Default admin user (password: 'password')
+    connectionScheme: 'typedb', // TypeDB proprietary protocol
+    logFileName: 'typedb.log',
+    pidFileName: 'typedb.pid',
+    dataSubdir: 'data',
+    clientTools: ['typedb', 'typedb_console_bin'],
+    maxConnections: 0, // Not applicable - managed internally
+  },
+  [Engine.InfluxDB]: {
+    defaultVersion: '3',
+    defaultPort: 8086, // InfluxDB HTTP API port
+    portRange: { start: 8086, end: 8186 },
+    latestVersion: '3',
+    superuser: '', // No auth by default for local dev
+    connectionScheme: 'http',
+    logFileName: 'influxdb.log',
+    pidFileName: 'influxdb.pid',
+    dataSubdir: 'data',
+    clientTools: [], // InfluxDB uses REST API, no separate CLI tools
+    maxConnections: 0, // Not applicable for time-series DB
+  },
 }
 
 /**

package/config/engines-registry.ts

@@ -13,6 +13,7 @@ export type EngineConfig = {
   defaultPort: number | null
   runtime: 'server' | 'embedded'
   queryLanguage: string
+  scriptFileLabel: string | null
   connectionScheme: string
   superuser: string | null
   clientTools: string[]

package/config/engines.json

@@ -11,6 +11,7 @@
       "defaultPort": 5432,
       "runtime": "server",
       "queryLanguage": "sql",
+      "scriptFileLabel": "Run SQL file",
       "connectionScheme": "postgresql",
       "superuser": "postgres",
       "clientTools": ["psql", "pg_dump", "pg_restore"],
@@ -26,6 +27,7 @@
       "defaultPort": 3306,
       "runtime": "server",
       "queryLanguage": "sql",
+      "scriptFileLabel": "Run SQL file",
       "connectionScheme": "mysql",
       "superuser": "root",
       "clientTools": ["mysql", "mysqldump", "mysqladmin"],
@@ -41,6 +43,7 @@
       "defaultPort": 3307,
       "runtime": "server",
       "queryLanguage": "sql",
+      "scriptFileLabel": "Run SQL file",
       "connectionScheme": "mysql",
       "superuser": "root",
       "clientTools": ["mariadb", "mariadb-dump", "mariadb-admin"]
@@ -55,6 +58,7 @@
       "defaultPort": null,
       "runtime": "embedded",
       "queryLanguage": "sql",
+      "scriptFileLabel": "Run SQL file",
       "connectionScheme": "sqlite",
       "superuser": null,
       "clientTools": ["sqlite3", "sqldiff", "sqlite3_analyzer", "sqlite3_rsync"]
@@ -69,6 +73,7 @@
       "defaultPort": null,
       "runtime": "embedded",
       "queryLanguage": "sql",
+      "scriptFileLabel": "Run SQL file",
       "connectionScheme": "duckdb",
       "superuser": null,
       "clientTools": ["duckdb"],
@@ -85,6 +90,7 @@
       "defaultPort": 27017,
       "runtime": "server",
       "queryLanguage": "javascript",
+      "scriptFileLabel": "Run script file",
       "connectionScheme": "mongodb",
       "superuser": null,
       "clientTools": ["mongod", "mongosh", "mongodump", "mongorestore"],
@@ -100,6 +106,7 @@
       "defaultPort": 6379,
       "runtime": "server",
       "queryLanguage": "redis",
+      "scriptFileLabel": "Run command file",
       "connectionScheme": "redis",
       "superuser": null,
       "clientTools": ["redis-server", "redis-cli"],
@@ -115,6 +122,7 @@
       "defaultPort": 6379,
       "runtime": "server",
       "queryLanguage": "redis",
+      "scriptFileLabel": "Run command file",
       "connectionScheme": "redis",
       "superuser": null,
       "clientTools": ["valkey-server", "valkey-cli"],
@@ -131,6 +139,7 @@
       "defaultPort": 9000,
       "runtime": "server",
       "queryLanguage": "sql",
+      "scriptFileLabel": "Run SQL file",
       "connectionScheme": "clickhouse",
       "superuser": "default",
       "clientTools": ["clickhouse"],
@@ -147,6 +156,7 @@
       "defaultPort": 6333,
       "runtime": "server",
       "queryLanguage": "rest",
+      "scriptFileLabel": null,
       "connectionScheme": "http",
       "superuser": null,
       "clientTools": ["qdrant"],
@@ -163,6 +173,7 @@
       "defaultPort": 7700,
       "runtime": "server",
       "queryLanguage": "rest",
+      "scriptFileLabel": null,
       "connectionScheme": "http",
       "superuser": null,
       "clientTools": ["meilisearch"],
@@ -179,6 +190,7 @@
       "defaultPort": 27017,
       "runtime": "server",
       "queryLanguage": "javascript",
+      "scriptFileLabel": "Run script file",
       "connectionScheme": "mongodb",
       "superuser": null,
       "clientTools": ["ferretdb", "mongosh", "mongodump", "mongorestore"],
@@ -195,6 +207,7 @@
       "defaultPort": 5984,
       "runtime": "server",
       "queryLanguage": "rest",
+      "scriptFileLabel": null,
       "connectionScheme": "http",
       "superuser": null,
       "clientTools": ["couchdb"],
@@ -211,6 +224,7 @@
       "defaultPort": 26257,
       "runtime": "server",
       "queryLanguage": "sql",
+      "scriptFileLabel": "Run SQL file",
       "connectionScheme": "postgresql",
       "superuser": "root",
       "clientTools": ["cockroach"],
@@ -227,6 +241,7 @@
       "defaultPort": 8000,
       "runtime": "server",
       "queryLanguage": "surrealql",
+      "scriptFileLabel": "Run SurrealQL file",
       "connectionScheme": "ws",
       "superuser": "root",
       "clientTools": ["surreal"],
@@ -243,11 +258,46 @@
       "defaultPort": 8812,
       "runtime": "server",
       "queryLanguage": "sql",
+      "scriptFileLabel": "Run SQL file",
       "connectionScheme": "postgresql",
       "superuser": "admin",
       "clientTools": ["questdb"],
       "licensing": "Apache-2.0",
       "notes": "High-performance time-series database. PostgreSQL wire protocol on port 8812. Web Console at port+188. Bundled JRE (no Java required)."
+    },
+    "typedb": {
+      "displayName": "TypeDB",
+      "icon": "🤖",
+      "status": "integrated",
+      "binarySource": "hostdb",
+      "supportedVersions": ["3.8.0"],
+      "defaultVersion": "3.8.0",
+      "defaultPort": 1729,
+      "runtime": "server",
+      "queryLanguage": "typeql",
+      "scriptFileLabel": "Run TypeQL file",
+      "connectionScheme": "typedb",
+      "superuser": "admin",
+      "clientTools": ["typedb", "typedb-console"],
+      "licensing": "MPL-2.0",
+      "notes": "Strongly-typed database for knowledge representation and reasoning. TypeQL query language. Main port 1729, HTTP port 8000. Default credentials: admin/password."
+    },
+    "influxdb": {
+      "displayName": "InfluxDB",
+      "icon": "📈",
+      "status": "integrated",
+      "binarySource": "hostdb",
+      "supportedVersions": ["3.8.0"],
+      "defaultVersion": "3.8.0",
+      "defaultPort": 8086,
+      "runtime": "server",
+      "queryLanguage": "sql",
+      "scriptFileLabel": null,
+      "connectionScheme": "http",
+      "superuser": null,
+      "clientTools": ["influxdb3"],
+      "licensing": ["Apache-2.0", "MIT"],
+      "notes": "Purpose-built time-series database with SQL support. InfluxDB 3.x is a Rust rewrite using Apache Arrow/DataFusion. HTTP API on port 8086."
     }
   }
 }

package/config/engines.schema.json

@@ -27,6 +27,7 @@
         "defaultPort",
         "runtime",
         "queryLanguage",
+        "scriptFileLabel",
         "connectionScheme",
         "superuser",
         "clientTools"
@@ -72,9 +73,13 @@
         },
         "queryLanguage": {
           "type": "string",
-          "enum": ["sql", "javascript", "redis", "rest"],
+          "enum": ["sql", "javascript", "redis", "rest", "surrealql", "typeql"],
           "description": "Query language used by the engine"
         },
+        "scriptFileLabel": {
+          "type": ["string", "null"],
+          "description": "Menu label for running script files (e.g., 'Run SQL file', 'Run TypeQL file'). Null for REST API engines that don't support script files."
+        },
         "connectionScheme": {
           "type": "string",
           "description": "URI scheme for connection strings"

package/core/base-binary-manager.ts

@@ -44,6 +44,9 @@ export type BinaryManagerConfig = {
 export abstract class BaseBinaryManager {
   protected abstract readonly config: BinaryManagerConfig
 
+  /** Timeout for `--version` verification after download (ms). Override in subclass if needed. */
+  protected verifyTimeoutMs = 30_000
+
   /**
    * Get the download URL for a version.
    * Must be implemented by subclass to use engine-specific binary-urls module.
@@ -446,7 +449,9 @@ export abstract class BaseBinaryManager {
     }
 
     try {
-      const { stdout, stderr } = await spawnAsync(serverPath, ['--version'])
+      const { stdout, stderr } = await spawnAsync(serverPath, ['--version'], {
+        timeout: this.verifyTimeoutMs,
+      })
       // Log stderr if present (may contain warnings)
       if (stderr && stderr.trim()) {
         logDebug(`${this.config.serverBinary} stderr`, {

package/core/config-manager.ts

@@ -78,6 +78,10 @@ const SURREALDB_TOOLS: BinaryTool[] = ['surreal']
 
 const QUESTDB_TOOLS: BinaryTool[] = ['questdb']
 
+const TYPEDB_TOOLS: BinaryTool[] = ['typedb', 'typedb_console_bin']
+
+const INFLUXDB_TOOLS: BinaryTool[] = ['influxdb3']
+
 const ENHANCED_SHELLS: BinaryTool[] = [
   'pgcli',
   'mycli',
@@ -100,6 +104,8 @@ const ALL_TOOLS: BinaryTool[] = [
   ...COCKROACHDB_TOOLS,
   ...SURREALDB_TOOLS,
   ...QUESTDB_TOOLS,
+  ...TYPEDB_TOOLS,
+  ...INFLUXDB_TOOLS,
   ...SQLITE_TOOLS,
   ...DUCKDB_TOOLS,
   ...ENHANCED_SHELLS,
@@ -121,6 +127,8 @@ const ENGINE_BINARY_MAP: Partial<Record<Engine, BinaryTool[]>> = {
   [Engine.CockroachDB]: COCKROACHDB_TOOLS,
   [Engine.SurrealDB]: SURREALDB_TOOLS,
   [Engine.QuestDB]: QUESTDB_TOOLS,
+  [Engine.TypeDB]: TYPEDB_TOOLS,
+  [Engine.InfluxDB]: INFLUXDB_TOOLS,
 }
 
 export class ConfigManager {
@@ -352,6 +360,8 @@ export class ConfigManager {
     redis: { found: BinaryTool[]; missing: BinaryTool[] }
     valkey: { found: BinaryTool[]; missing: BinaryTool[] }
     meilisearch: { found: BinaryTool[]; missing: BinaryTool[] }
+    typedb: { found: BinaryTool[]; missing: BinaryTool[] }
+    influxdb: { found: BinaryTool[]; missing: BinaryTool[] }
     enhanced: { found: BinaryTool[]; missing: BinaryTool[] }
   }> {
     // First, scan ~/.spindb/bin/ for downloaded (bundled) binaries
@@ -405,6 +415,14 @@ export class ConfigManager {
         found: found.filter((t) => MEILISEARCH_TOOLS.includes(t)),
         missing: missing.filter((t) => MEILISEARCH_TOOLS.includes(t)),
       },
+      typedb: {
+        found: found.filter((t) => TYPEDB_TOOLS.includes(t)),
+        missing: missing.filter((t) => TYPEDB_TOOLS.includes(t)),
+      },
+      influxdb: {
+        found: found.filter((t) => INFLUXDB_TOOLS.includes(t)),
+        missing: missing.filter((t) => INFLUXDB_TOOLS.includes(t)),
+      },
       enhanced: {
         found: found.filter((t) => ENHANCED_SHELLS.includes(t)),
         missing: missing.filter((t) => ENHANCED_SHELLS.includes(t)),
@@ -601,6 +619,8 @@ export {
   COCKROACHDB_TOOLS,
   SURREALDB_TOOLS,
   QUESTDB_TOOLS,
+  TYPEDB_TOOLS,
+  INFLUXDB_TOOLS,
   SQLITE_TOOLS,
   DUCKDB_TOOLS,
   ENHANCED_SHELLS,