spindb 0.34.0 → 0.34.3

package/README.md

@@ -105,6 +105,18 @@ spindb connect cache                             # Open redis-cli
 spindb connect cache --iredis                    # Enhanced shell
 ```
 
+### InfluxDB
+
+```bash
+spindb create tsdata --engine influxdb --start
+spindb run tsdata ./seed.lp                      # Seed with line protocol
+spindb run tsdata -c "SHOW TABLES"               # Run inline SQL
+spindb run tsdata ./queries.sql                   # Run SQL file
+spindb connect tsdata                             # Interactive SQL console
+```
+
+> InfluxDB supports two file formats: `.lp` (line protocol) for writing data, `.sql` for queries.
+
 ### Enhanced Shells & Visual Tools
 
 ```bash
@@ -261,7 +273,7 @@ See [DEPLOY.md](DEPLOY.md) for comprehensive deployment documentation.
 - **Local only** - Databases bind to `127.0.0.1`. Remote connection support planned for v1.1.
 - **ClickHouse Windows** - Not supported (hostdb doesn't build for Windows).
 - **FerretDB Windows** - Not supported (postgresql-documentdb has startup issues on Windows).
-- **Qdrant, Meilisearch, CouchDB & InfluxDB** - Use REST API instead of CLI shell. Access via HTTP at the configured port.
+- **Qdrant, Meilisearch, CouchDB** - Use REST API instead of CLI shell. Access via HTTP at the configured port.
 
 ---
 

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

@@ -42,6 +42,7 @@ import {
 import { getEngine } from '../../../engines'
 import { createSpinner } from '../../ui/spinner'
 import { uiError, uiWarning, uiInfo, uiSuccess } from '../../ui/theme'
+import { logDebug } from '../../../core/error-handler'
 import { pressEnterToContinue } from './shared'
 import { paths } from '../../../config/paths'
 import { getEngineConfig } from '../../../config/engines-registry'
@@ -237,8 +238,8 @@ export async function handleOpenShell(
     engineSpecificValue = null
     engineSpecificInstallValue = null
   } else if (config.engine === 'influxdb') {
-    // InfluxDB uses REST API, no interactive shell
-    defaultShellName = 'Web Dashboard'
+    // InfluxDB uses influxdb3 query subcommand (same binary as server)
+    defaultShellName = 'influxdb3 query'
     engineSpecificCli = null
     engineSpecificInstalled = false
     engineSpecificValue = null
@@ -334,7 +335,11 @@ export async function handleOpenShell(
       value: 'api-info',
     })
   } else if (config.engine === 'influxdb') {
-    // InfluxDB: REST API only, no web dashboard or interactive shell
+    // InfluxDB: influxdb3 query CLI + API info
+    choices.push({
+      name: `▸ Use default shell (influxdb3 query)`,
+      value: 'default',
+    })
     choices.push({
       name: `ℹ Show API info`,
       value: 'api-info',
@@ -353,7 +358,7 @@ export async function handleOpenShell(
   } else {
     // Non-REST-API engines: show default shell option
     choices.push({
-      name: `>_ Use default shell (${defaultShellName})`,
+      name: `▸ Use default shell (${defaultShellName})`,
       value: 'default',
     })
   }
@@ -362,7 +367,7 @@ export async function handleOpenShell(
   if (engineSpecificCli !== null) {
     if (engineSpecificInstalled) {
       choices.push({
-        name: `⚡ Use ${engineSpecificCli} (enhanced features, recommended)`,
+        name: `★ Use ${engineSpecificCli} (enhanced features, recommended)`,
         value: engineSpecificValue!,
       })
     } else {
@@ -378,7 +383,7 @@ export async function handleOpenShell(
   if (engineConfig.queryLanguage === 'sql') {
     if (usqlInstalled) {
       choices.push({
-        name: '⚡ Use usql (universal SQL client)',
+        name: '★ Use usql (universal SQL client)',
         value: 'usql',
       })
     } else {
@@ -394,7 +399,7 @@ export async function handleOpenShell(
     const dblabPath = await configManager.getBinaryPath('dblab')
     if (dblabPath) {
       choices.push({
-        name: '⚡ Use dblab (visual TUI)',
+        name: '★ Use dblab (visual TUI)',
         value: 'dblab',
       })
     } else {
@@ -415,6 +420,15 @@ export async function handleOpenShell(
     })
   }
 
+  if (config.engine === 'questdb') {
+    const httpPort = config.port + 188
+    choices.push(new inquirer.Separator(chalk.gray(`───── Web Panel ─────`)))
+    choices.push({
+      name: `◎ Open Web Console (port ${httpPort})`,
+      value: 'browser',
+    })
+  }
+
   if (config.engine === 'duckdb') {
     choices.push(new inquirer.Separator(chalk.gray(`───── Web Panel ─────`)))
     choices.push({
@@ -487,6 +501,16 @@ export async function handleOpenShell(
       console.log()
       openInBrowser(playUrl)
       await pressEnterToContinue()
+    } else if (config.engine === 'questdb') {
+      // QuestDB Web Console on HTTP port (PG port + 188)
+      const httpPort = config.port + 188
+      const consoleUrl = `http://127.0.0.1:${httpPort}`
+      console.log()
+      console.log(uiInfo(`Opening QuestDB Web Console in browser...`))
+      console.log(chalk.gray(`  ${consoleUrl}`))
+      console.log()
+      openInBrowser(consoleUrl)
+      await pressEnterToContinue()
     }
     return
   }
@@ -1482,22 +1506,109 @@ async function launchShell(
     await pressEnterToContinue()
     return
   } else if (config.engine === 'influxdb') {
-    // InfluxDB: REST API only, no web dashboard
-    // This branch shouldn't be reached since we removed the 'default' choice,
-    // but handle gracefully just in case
-    console.log()
-    console.log(chalk.cyan('InfluxDB REST API:'))
-    console.log(chalk.white(`  HTTP: http://127.0.0.1:${config.port}`))
-    console.log()
-    console.log(chalk.gray('Example curl commands:'))
-    console.log(chalk.gray(`  curl http://127.0.0.1:${config.port}/health`))
-    console.log(
-      chalk.gray(
-        `  curl -H "Content-Type: application/json" http://127.0.0.1:${config.port}/api/v3/query_sql -d '{"db":"mydb","q":"SELECT 1"}'`,
-      ),
-    )
-    console.log()
-    await pressEnterToContinue()
+    // InfluxDB: influxdb3 query is one-shot (no REPL), use interactive loop
+    const engine = getEngine(config.engine)
+    const influxdbPath = await engine
+      .getInfluxDBPath(config.version)
+      .catch(() => null)
+    if (!influxdbPath) {
+      console.log(
+        uiWarning('influxdb3 not found. Run: spindb engines download influxdb'),
+      )
+      await pressEnterToContinue()
+      return
+    }
+    // Query available databases from the REST API
+    let db = database || config.name
+    try {
+      const resp = await fetch(
+        `http://127.0.0.1:${config.port}/api/v3/configure/database?format=json`,
+      )
+      if (resp.ok) {
+        const databases = (await resp.json()) as Array<Record<string, string>>
+        const dbNames = databases
+          .map((d) => d['iox::database'] || d.name)
+          .filter((n) => n && n !== '_internal')
+        if (dbNames.length === 0) {
+          console.log(
+            uiWarning(
+              'No databases exist yet. Write data first to create a database.',
+            ),
+          )
+          console.log(
+            chalk.gray(
+              `  curl -X POST "http://127.0.0.1:${config.port}/api/v3/write_lp?db=${db}" -H "Content-Type: text/plain" -d 'measurement,tag=value field=1'`,
+            ),
+          )
+          console.log()
+          await pressEnterToContinue()
+          return
+        }
+        if (!dbNames.includes(db)) {
+          if (dbNames.length === 1) {
+            db = dbNames[0]
+          } else {
+            const { chosenDb } = await escapeablePrompt<{ chosenDb: string }>([
+              {
+                type: 'list',
+                name: 'chosenDb',
+                message: 'Select database:',
+                choices: dbNames,
+              },
+            ])
+            db = chosenDb
+          }
+        }
+      }
+    } catch {
+      // Server may not support this endpoint; proceed with default db
+    }
+    console.log(chalk.cyan(`InfluxDB SQL Console (${db})`))
+    console.log(chalk.gray(`  Type SQL queries, or "exit" to quit.\n`))
+    let running = true
+    while (running) {
+      const { sql } = await escapeablePrompt<{ sql: string }>([
+        {
+          type: 'input',
+          name: 'sql',
+          message: chalk.blue('sql>'),
+        },
+      ])
+      const trimmed = (sql || '').trim()
+      if (
+        trimmed.toLowerCase() === 'exit' ||
+        trimmed.toLowerCase() === 'quit'
+      ) {
+        running = false
+        break
+      }
+      if (!trimmed) {
+        continue
+      }
+      const queryProcess = spawn(
+        influxdbPath,
+        [
+          'query',
+          '--host',
+          `http://127.0.0.1:${config.port}`,
+          '--database',
+          db,
+          '--',
+          trimmed,
+        ],
+        { stdio: 'inherit' },
+      )
+      await new Promise<void>((resolve) => {
+        queryProcess.on('error', (err) => {
+          console.error(uiError(`Query failed: ${err.message}`))
+          resolve()
+        })
+        queryProcess.on('close', () => {
+          logDebug('influxdb query process exited')
+          resolve()
+        })
+      })
+    }
     return
   } else if (config.engine === 'couchdb') {
     // CouchDB: Open Fauxton dashboard in browser (served at /_utils)

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

@@ -5,6 +5,7 @@ import { spawn } from 'child_process'
 import { containerManager } from '../../../core/container-manager'
 import { getMissingDependencies } from '../../../core/dependency-manager'
 import { getEngine } from '../../../engines'
+import { Engine } from '../../../types'
 import { paths } from '../../../config/paths'
 import { promptInstallDependencies, escapeablePrompt } from '../../ui/prompts'
 import { uiError, uiWarning, uiInfo, uiSuccess } from '../../ui/theme'
@@ -92,7 +93,51 @@ export async function handleRunSql(
   const filePath = stripQuotes(rawFilePath)
 
   // Use provided database or fall back to container's default
-  const databaseName = database || config.database
+  let databaseName = database || config.database
+
+  // InfluxDB: discover real databases (they're created implicitly on write)
+  // Cannot use engine.listDatabases() here because it falls back to
+  // container.database when the list is empty, hiding the "no databases"
+  // state that we need to detect for the .lp warning.
+  if (config.engine === Engine.InfluxDB) {
+    try {
+      const resp = await fetch(
+        `http://127.0.0.1:${config.port}/api/v3/configure/database?format=json`,
+      )
+      if (resp.ok) {
+        const databases = (await resp.json()) as Array<Record<string, string>>
+        const dbNames = databases
+          .map((d) => d['iox::database'] || d.name)
+          .filter((n) => n && n !== '_internal')
+        if (dbNames.length === 0 && !filePath.endsWith('.lp')) {
+          console.log(
+            uiWarning(
+              'No databases exist yet. Seed data with a .lp file first.',
+            ),
+          )
+          await pressEnterToContinue()
+          return
+        }
+        if (!dbNames.includes(databaseName)) {
+          if (dbNames.length === 1) {
+            databaseName = dbNames[0]
+          } else if (dbNames.length > 1) {
+            const { chosenDb } = await escapeablePrompt<{ chosenDb: string }>([
+              {
+                type: 'list',
+                name: 'chosenDb',
+                message: 'Select database:',
+                choices: dbNames,
+              },
+            ])
+            databaseName = chosenDb
+          }
+        }
+      }
+    } catch {
+      // Proceed with default
+    }
+  }
 
   console.log()
   console.log(uiInfo(`Running ${scriptType} file against "${databaseName}"...`))

package/config/engines.json

@@ -291,8 +291,8 @@
       "defaultVersion": "3.8.0",
       "defaultPort": 8086,
       "runtime": "server",
-      "queryLanguage": "sql",
-      "scriptFileLabel": null,
+      "queryLanguage": "rest",
+      "scriptFileLabel": "Run LP/SQL file",
       "connectionScheme": "http",
       "superuser": null,
       "clientTools": ["influxdb3"],

package/engines/base-engine.ts

@@ -161,6 +161,14 @@ export abstract class BaseEngine {
     throw new Error('typedb_console_bin not found')
   }
 
+  /**
+   * Get the path to the influxdb3 binary if available
+   * Default implementation throws; InfluxDB engine overrides this method.
+   */
+  async getInfluxDBPath(_version?: string): Promise<string> {
+    throw new Error('influxdb3 not found')
+  }
+
   /**
    * Get the path to the sqlite3 client if available
    * Default implementation returns null; SQLite engine overrides this method.

package/engines/influxdb/index.ts

@@ -1044,8 +1044,41 @@ export class InfluxDBEngine extends BaseEngine {
     const database = options.database || container.database
 
     if (options.file) {
-      // Read file content and execute as SQL
       const content = await readFile(options.file, 'utf-8')
+
+      // Ensure the database exists (InfluxDB creates DBs implicitly on write,
+      // but SQL queries fail if the DB doesn't exist yet)
+      const createDbResp = await influxdbApiRequest(
+        port,
+        'POST',
+        '/api/v3/configure/database',
+        { db: database },
+      )
+      if (createDbResp.status >= 400) {
+        throw new Error(
+          `Failed to create database "${database}": HTTP ${createDbResp.status} — ${JSON.stringify(createDbResp.data)}`,
+        )
+      }
+
+      // Line protocol files (.lp) → write via /api/v3/write_lp
+      if (options.file.endsWith('.lp')) {
+        const lines = content
+          .split('\n')
+          .filter((line) => line.trim().length > 0 && !line.startsWith('#'))
+          .join('\n')
+        const response = await influxdbApiRequest(
+          port,
+          'POST',
+          `/api/v3/write_lp?db=${encodeURIComponent(database)}`,
+          lines,
+        )
+        if (response.status >= 400) {
+          throw new Error(`Write error: ${JSON.stringify(response.data)}`)
+        }
+        return
+      }
+
+      // SQL files → execute via /api/v3/query_sql
       const statements = content
         .split('\n')
         .filter((line) => !line.startsWith('--') && line.trim().length > 0)
@@ -1076,6 +1109,18 @@ export class InfluxDBEngine extends BaseEngine {
     }
 
     if (options.sql) {
+      // Ensure database exists for inline SQL too
+      const createDbResp2 = await influxdbApiRequest(
+        port,
+        'POST',
+        '/api/v3/configure/database',
+        { db: database },
+      )
+      if (createDbResp2.status >= 400) {
+        throw new Error(
+          `Failed to create database "${database}": HTTP ${createDbResp2.status} — ${JSON.stringify(createDbResp2.data)}`,
+        )
+      }
       const response = await influxdbApiRequest(
         port,
         'POST',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spindb",
-  "version": "0.34.0",
+  "version": "0.34.3",
   "author": "Bob Bass <bob@bbass.co>",
   "license": "PolyForm-Noncommercial-1.0.0",
   "description": "Zero-config Docker-free local database containers. Create, backup, and clone a variety of popular databases.",