spindb 0.34.5 → 0.35.3

package/README.md

@@ -38,7 +38,7 @@ SpinDB supports **18 database engines** across **5 platform architectures**—al
 | 🪶 **SQLite** | Embedded SQL | ✅ | ✅ | ✅ | ✅ | ✅ |
 | 🦆 **DuckDB** | Embedded OLAP | ✅ | ✅ | ✅ | ✅ | ✅ |
 | 🍃 **MongoDB** | Document Store | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 🦔 **FerretDB** | Document Store | ✅ | ✅ | ✅ | ✅ | ❌ |
+| 🦔 **FerretDB** | Document Store | ✅ | ✅ | ✅ | ✅ | ⚠️ |
 | 🔴 **Redis** | Key-Value | ✅ | ✅ | ✅ | ✅ | ✅ |
 | 🔷 **Valkey** | Key-Value | ✅ | ✅ | ✅ | ✅ | ✅ |
 | 🏠 **ClickHouse** | Columnar OLAP | ✅ | ✅ | ✅ | ✅ | ❌ |
@@ -51,9 +51,9 @@ SpinDB supports **18 database engines** across **5 platform architectures**—al
 | 🤖 **TypeDB** | Knowledge Graph | ✅ | ✅ | ✅ | ✅ | ✅ |
 | 📈 **InfluxDB** | Time-Series | ✅ | ✅ | ✅ | ✅ | ✅ |
 
-**88 combinations. One CLI. Zero configuration.**
+**89 combinations. One CLI. Zero configuration.**
 
-> ClickHouse and FerretDB are available on Windows via WSL.
+> ClickHouse is available on Windows via WSL. FerretDB v1 is natively supported on Windows (uses plain PostgreSQL backend); v2 requires macOS/Linux.
 
 ---
 
@@ -272,7 +272,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).
+- **FerretDB Windows** - v1 supported natively (plain PostgreSQL backend). v2 not supported (postgresql-documentdb has startup issues); use WSL for v2.
 - **Qdrant, Meilisearch, CouchDB** - Use REST API instead of CLI shell. Access via HTTP at the configured port.
 
 ---

package/cli/commands/create.ts

@@ -22,7 +22,11 @@ import { startWithRetry } from '../../core/start-with-retry'
 import { TransactionManager } from '../../core/transaction-manager'
 import { isValidDatabaseName, exitWithError } from '../../core/error-handler'
 import { resolve } from 'path'
-import { Engine } from '../../types'
+import { Engine, Platform } from '../../types'
+import {
+  FERRETDB_VERSION_MAP,
+  isV1 as isFerretDBv1,
+} from '../../engines/ferretdb/version-maps'
 import type { BaseEngine } from '../../engines/base-engine'
 
 /**
@@ -535,6 +539,23 @@ export const createCommand = new Command('create')
           database = answers.database
         }
 
+        // FerretDB: force v1 on Windows (v2 requires postgresql-documentdb, not available on Windows)
+        // Runs after both CLI and interactive paths have resolved engine + version
+        if (
+          engine === Engine.FerretDB &&
+          !isFerretDBv1(version) &&
+          platformService.getPlatformInfo().platform === Platform.Win32
+        ) {
+          version = FERRETDB_VERSION_MAP['1']
+          if (!options.json) {
+            console.log(
+              chalk.yellow(
+                `  FerretDB v2 is not supported on Windows — using v1 (${version})`,
+              ),
+            )
+          }
+        }
+
         // Redis/Valkey use numbered databases (0-15), default to "0"
         // Other engines default to container name (with hyphens replaced by underscores for SQL compatibility)
         if (engine === Engine.Redis || engine === Engine.Valkey) {

package/cli/commands/engines.ts

@@ -53,6 +53,7 @@ import {
 import { Engine, Platform } from '../../types'
 import {
   loadEnginesJson,
+  filterEnginesByPlatform,
   type EngineConfig,
 } from '../../config/engines-registry'
 import { mysqlBinaryManager } from '../../engines/mysql/binary-manager'
@@ -74,7 +75,9 @@ import { typedbBinaryManager } from '../../engines/typedb/binary-manager'
 import { influxdbBinaryManager } from '../../engines/influxdb/binary-manager'
 import {
   DEFAULT_DOCUMENTDB_VERSION,
+  DEFAULT_V1_POSTGRESQL_VERSION,
   normalizeDocumentDBVersion,
+  isV1,
 } from '../../engines/ferretdb/version-maps'
 
 // Display manual installation instructions for missing dependencies
@@ -1727,26 +1730,41 @@ enginesCommand
       }
 
       if (['ferretdb', 'ferret'].includes(normalizedEngine)) {
-        // Check platform support
         const { platform } = platformService.getPlatformInfo()
-        if (platform === Platform.Win32) {
+
+        if (!version) {
+          // Auto-select v1 on Windows (v2 not supported)
+          if (platform === Platform.Win32) {
+            version = '1'
+            console.log(
+              chalk.gray(
+                '  Auto-selecting FerretDB v1 (v2 is not available on Windows)',
+              ),
+            )
+          } else {
+            console.error(uiError('FerretDB requires a version (e.g., 1 or 2)'))
+            process.exit(1)
+          }
+        }
+
+        // Block v2 on Windows with helpful message
+        if (platform === Platform.Win32 && !isV1(version)) {
           console.error(
-            uiError('FerretDB is not supported on Windows via hostdb'),
+            uiError(
+              'FerretDB v2 is not supported on Windows (postgresql-documentdb has startup issues)',
+            ),
           )
           console.log(
             chalk.gray(
-              '  FerretDB binaries are only available for macOS and Linux.',
+              '  Use FerretDB v1 instead, which uses plain PostgreSQL:',
             ),
           )
-          process.exit(1)
-        }
-
-        if (!version) {
-          console.error(uiError('FerretDB requires a version (e.g., 2)'))
+          console.log(chalk.cyan('    spindb engines download ferretdb 1'))
           process.exit(1)
         }
 
         const engine = getEngine(Engine.FerretDB)
+        const v1 = isV1(version)
 
         const spinner = createSpinner(
           `Checking FerretDB ${version} binaries...`,
@@ -1780,18 +1798,31 @@ enginesCommand
         )
         console.log(chalk.gray(`  FerretDB location: ${binPath}`))
 
-        // Also show postgresql-documentdb location
-        const fullDocumentDBVersion = normalizeDocumentDBVersion(
-          DEFAULT_DOCUMENTDB_VERSION,
-        )
-        const documentdbPath = ferretdbBinaryManager.getDocumentDBBinaryPath(
-          fullDocumentDBVersion,
-          ferretPlatform,
-          ferretArch,
-        )
-        console.log(
-          chalk.gray(`  postgresql-documentdb location: ${documentdbPath}`),
-        )
+        // Show backend location (version-dependent)
+        if (v1) {
+          const pgFullVersion = postgresqlBinaryManager.getFullVersion(
+            DEFAULT_V1_POSTGRESQL_VERSION,
+          )
+          const pgPath = paths.getBinaryPath({
+            engine: 'postgresql',
+            version: pgFullVersion,
+            platform: ferretPlatform,
+            arch: ferretArch,
+          })
+          console.log(chalk.gray(`  PostgreSQL backend location: ${pgPath}`))
+        } else {
+          const fullDocumentDBVersion = normalizeDocumentDBVersion(
+            DEFAULT_DOCUMENTDB_VERSION,
+          )
+          const documentdbPath = ferretdbBinaryManager.getDocumentDBBinaryPath(
+            fullDocumentDBVersion,
+            ferretPlatform,
+            ferretArch,
+          )
+          console.log(
+            chalk.gray(`  postgresql-documentdb location: ${documentdbPath}`),
+          )
+        }
 
         // Skip client tools check - FerretDB uses MongoDB client tools (mongosh)
         // which are installed separately via: spindb engines download mongodb
@@ -2126,7 +2157,10 @@ enginesCommand
   .option('--all', 'Include pending and planned engines')
   .action(async (options: { json?: boolean; all?: boolean }) => {
     try {
-      const enginesData = await loadEnginesJson()
+      const rawData = await loadEnginesJson()
+      const { platform, arch } = platformService.getPlatformInfo()
+      const platformKey = `${platform}-${arch}`
+      const enginesData = filterEnginesByPlatform(rawData, platformKey)
 
       if (options.json) {
         // Output full JSON

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

@@ -377,7 +377,23 @@ export async function handleCreate(): Promise<'main' | string | void> {
 
     const config = await containerManager.getConfig(containerNameFinal)
     if (config) {
-      await dbEngine.start(config)
+      try {
+        await dbEngine.start(config)
+      } catch (error) {
+        startSpinner.fail(`${dbEngine.displayName} failed to start`)
+        const e = error as Error
+        console.log()
+        console.log(uiError(e.message))
+        console.log()
+        // Clean up the container that was created but failed to start
+        try {
+          await containerManager.delete(containerNameFinal, { force: true })
+        } catch {
+          // Ignore cleanup errors
+        }
+        await pressEnterToContinue()
+        return
+      }
       await containerManager.updateConfig(containerNameFinal, {
         status: 'running',
       })

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

@@ -34,6 +34,7 @@ import {
   type InstalledInfluxDBEngine,
 } from '../../helpers'
 
+import { isV1 } from '../../../engines/ferretdb/version-maps'
 import { type MenuChoice } from './shared'
 
 export async function handleEngines(): Promise<void> {
@@ -285,50 +286,68 @@ async function handleDeleteEngine(
   try {
     await rm(enginePath, { recursive: true, force: true })
 
-    // FerretDB is a composite engine - also clean up postgresql-documentdb backend
-    // But only if no other FerretDB installations share it
+    // FerretDB is a composite engine - handle backend cleanup based on version
+    let backendStatus = ''
     if (engineName === 'ferretdb') {
       // enginePath is like: ~/.spindb/bin/ferretdb-2.7.0-darwin-arm64
-      // We need to find: ~/.spindb/bin/postgresql-documentdb-*-darwin-arm64
       const binDir = dirname(enginePath)
       const ferretDirName = basename(enginePath)
-      // Extract platform-arch from ferretdb directory name (e.g., "darwin-arm64")
+      // Extract version from directory name (e.g., "2.7.0" from "ferretdb-2.7.0-darwin-arm64")
       const parts = ferretDirName.split('-')
       const platformArch = parts.slice(-2).join('-') // "darwin-arm64"
 
-      const entries = await readdir(binDir, { withFileTypes: true })
-
-      // Check if other FerretDB installations exist for the same platform
-      // If so, don't delete the shared postgresql-documentdb backend
-      const otherFerretInstalls = entries.filter(
-        (entry) =>
-          entry.isDirectory() &&
-          entry.name.startsWith('ferretdb-') &&
-          entry.name.endsWith(platformArch) &&
-          entry.name !== ferretDirName,
+      // Extract version: remove "ferretdb-" prefix and "-platform-arch" suffix
+      const versionPart = ferretDirName.slice(
+        'ferretdb-'.length,
+        ferretDirName.length - `-${platformArch}`.length,
       )
 
-      if (otherFerretInstalls.length > 0) {
-        // Other FerretDB versions exist - skip documentdb deletion
-        spinner.text = `Skipping postgresql-documentdb (shared by ${otherFerretInstalls.length} other FerretDB install(s))`
+      if (isV1(versionPart)) {
+        // v1: Don't delete shared PostgreSQL binaries (used by standalone PG containers)
+        backendStatus =
+          ' (PostgreSQL backend kept — shared with standalone containers)'
       } else {
-        // No other FerretDB installs - safe to delete documentdb backend
-        const documentdbPattern = `postgresql-documentdb-`
-        for (const entry of entries) {
-          if (
-            entry.isDirectory() &&
-            entry.name.startsWith(documentdbPattern) &&
-            entry.name.endsWith(platformArch)
-          ) {
-            const documentdbPath = join(binDir, entry.name)
-            spinner.text = `Deleting postgresql-documentdb backend...`
-            await rm(documentdbPath, { recursive: true, force: true })
+        // v2: Clean up postgresql-documentdb backend if no other v2 FerretDB installs share it
+        const entries = await readdir(binDir, { withFileTypes: true })
+
+        // Check if other v2 FerretDB installations exist for the same platform
+        const otherV2Installs = entries.filter((entry) => {
+          if (!entry.isDirectory()) return false
+          if (!entry.name.startsWith('ferretdb-')) return false
+          if (!entry.name.endsWith(platformArch)) return false
+          if (entry.name === ferretDirName) return false
+          const otherVersion = entry.name.slice(
+            'ferretdb-'.length,
+            entry.name.length - `-${platformArch}`.length,
+          )
+          return !isV1(otherVersion)
+        })
+
+        if (otherV2Installs.length > 0) {
+          backendStatus = ` (postgresql-documentdb kept — shared by ${otherV2Installs.length} other v2 install(s))`
+        } else {
+          const documentdbPattern = `postgresql-documentdb-`
+          let cleaned = false
+          for (const entry of entries) {
+            if (
+              entry.isDirectory() &&
+              entry.name.startsWith(documentdbPattern) &&
+              entry.name.endsWith(platformArch)
+            ) {
+              const documentdbPath = join(binDir, entry.name)
+              spinner.text = `Deleting postgresql-documentdb backend...`
+              await rm(documentdbPath, { recursive: true, force: true })
+              cleaned = true
+            }
+          }
+          if (cleaned) {
+            backendStatus = ' (postgresql-documentdb backend also deleted)'
           }
         }
       }
     }
 
-    spinner.succeed(`Deleted ${engineName} ${engineVersion}`)
+    spinner.succeed(`Deleted ${engineName} ${engineVersion}${backendStatus}`)
   } catch (error) {
     const e = error as Error
     spinner.fail(`Failed to delete: ${e.message}`)

package/cli/ui/theme.ts

@@ -117,9 +117,12 @@ export function connectionBox(
 }
 
 export function formatBytes(bytes: number): string {
-  if (bytes === 0) return '0 B'
+  if (!Number.isFinite(bytes) || bytes <= 0) return '0 B'
   const units = ['B', 'KB', 'MB', 'GB', 'TB']
-  const i = Math.floor(Math.log(bytes) / Math.log(1024))
+  const i = Math.max(
+    0,
+    Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1),
+  )
   const value = bytes / Math.pow(1024, i)
   return `${value.toFixed(1)} ${units[i]}`
 }

package/config/engines-registry.ts

@@ -19,6 +19,8 @@ export type EngineConfig = {
   clientTools: string[]
   licensing?: string | string[]
   notes?: string
+  platforms?: string[]
+  versionPlatforms?: Record<string, string[]>
 }
 
 export type EnginesJson = {
@@ -92,3 +94,57 @@ export function getAllEngines(): Engine[] {
 export function clearEnginesCache(): void {
   cachedEngines = null
 }
+
+/**
+ * Filter engines data to only include engines and versions supported on the given platform.
+ *
+ * - If an engine has `platforms` and the platformKey isn't listed, the engine is removed.
+ * - If an engine has `versionPlatforms`, versions whose entry excludes the platformKey are removed.
+ *   Versions with no entry in `versionPlatforms` are kept (assumed all-platform).
+ * - If filtering removes all versions, the engine is removed.
+ * - If the defaultVersion is removed, it's set to the first remaining version.
+ */
+export function filterEnginesByPlatform(
+  enginesData: EnginesJson,
+  platformKey: string,
+): EnginesJson {
+  const filtered: Record<string, EngineConfig> = {}
+
+  for (const [name, config] of Object.entries(enginesData.engines)) {
+    // Engine-level platform check
+    if (config.platforms && !config.platforms.includes(platformKey)) {
+      continue
+    }
+
+    // Version-level platform check
+    if (config.versionPlatforms) {
+      const filteredVersions = config.supportedVersions.filter((version) => {
+        const platforms = config.versionPlatforms![version]
+        // If no entry for this version, it's available on all platforms
+        if (!platforms) return true
+        return platforms.includes(platformKey)
+      })
+
+      if (filteredVersions.length === 0) {
+        continue
+      }
+
+      const defaultVersion = filteredVersions.includes(config.defaultVersion)
+        ? config.defaultVersion
+        : filteredVersions[0]
+
+      filtered[name] = {
+        ...config,
+        supportedVersions: filteredVersions,
+        defaultVersion,
+      }
+    } else {
+      filtered[name] = config
+    }
+  }
+
+  return {
+    ...enginesData,
+    engines: filtered as Record<Engine, EngineConfig>,
+  }
+}

package/config/engines.json

@@ -144,7 +144,8 @@
       "superuser": "default",
       "clientTools": ["clickhouse"],
       "licensing": "Apache-2.0",
-      "notes": "Column-oriented OLAP database. Uses YY.MM.X.build versioning. Native port 9000, HTTP port 8123. WSL only on Windows."
+      "notes": "Column-oriented OLAP database. Uses YY.MM.X.build versioning. Native port 9000, HTTP port 8123. WSL only on Windows.",
+      "platforms": ["darwin-arm64", "darwin-x64", "linux-arm64", "linux-x64"]
     },
     "qdrant": {
       "displayName": "Qdrant",
@@ -185,7 +186,7 @@
       "icon": "🦔",
       "status": "integrated",
       "binarySource": "hostdb",
-      "supportedVersions": ["2.7.0"],
+      "supportedVersions": ["1.24.2", "2.7.0"],
       "defaultVersion": "2.7.0",
       "defaultPort": 27017,
       "runtime": "server",
@@ -195,7 +196,17 @@
       "superuser": null,
       "clientTools": ["ferretdb", "mongosh", "mongodump", "mongorestore"],
       "licensing": "Apache-2.0",
-      "notes": "MongoDB-compatible proxy using PostgreSQL as backend. Requires postgresql-documentdb."
+      "notes": "MongoDB-compatible proxy. v2 uses postgresql-documentdb (macOS/Linux). v1 uses plain PostgreSQL (all platforms incl. Windows).",
+      "versionPlatforms": {
+        "1.24.2": [
+          "darwin-arm64",
+          "darwin-x64",
+          "linux-arm64",
+          "linux-x64",
+          "win32-x64"
+        ],
+        "2.7.0": ["darwin-arm64", "darwin-x64", "linux-arm64", "linux-x64"]
+      }
     },
     "couchdb": {
       "displayName": "CouchDB",

package/config/engines.schema.json

@@ -114,6 +114,19 @@
         "notes": {
           "type": "string",
           "description": "Additional notes about the engine"
+        },
+        "platforms": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Supported platform-arch combos (e.g. 'darwin-arm64'). If omitted, all platforms are supported."
+        },
+        "versionPlatforms": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "description": "Per-version platform overrides. Keys are version strings, values are platform-arch arrays."
         }
       },
       "additionalProperties": false

package/core/base-binary-manager.ts

@@ -17,6 +17,7 @@ import { paths } from '../config/paths'
 import { spawnAsync } from './spawn-utils'
 import { moveEntry } from './fs-error-utils'
 import { logDebug } from './error-handler'
+import { fetchWithRegistryFallback } from './hostdb-client'
 import {
   type Engine,
   Platform,
@@ -186,7 +187,9 @@ export abstract class BaseBinaryManager {
 
       let response: Response
       try {
-        response = await fetch(url, { signal: controller.signal })
+        response = await fetchWithRegistryFallback(url, {
+          signal: controller.signal,
+        })
       } catch (error) {
         const err = error as Error
         if (err.name === 'AbortError') {
@@ -202,7 +205,7 @@ export abstract class BaseBinaryManager {
           throw new Error(
             `${this.config.displayName} ${fullVersion} binaries not found (404). ` +
               `This version may have been removed from hostdb. ` +
-              `Try a different version or check https://github.com/robertjbass/hostdb/releases`,
+              `Try a different version or check https://registry.layerbase.host`,
           )
         }
         throw new Error(
@@ -451,6 +454,7 @@ export abstract class BaseBinaryManager {
     try {
       const { stdout, stderr } = await spawnAsync(serverPath, ['--version'], {
         timeout: this.verifyTimeoutMs,
+        cwd: binPath,
       })
       // Log stderr if present (may contain warnings)
       if (stderr && stderr.trim()) {

package/core/base-document-binary-manager.ts

@@ -25,6 +25,7 @@ import { paths } from '../config/paths'
 import { spawnAsync, extractWindowsArchive } from './spawn-utils'
 import { isRenameFallbackError } from './fs-error-utils'
 import { logDebug } from './error-handler'
+import { fetchWithRegistryFallback } from './hostdb-client'
 import {
   type Engine,
   Platform,
@@ -203,14 +204,16 @@ export abstract class BaseDocumentBinaryManager {
       let response: Response
       let fileStream: ReturnType<typeof createWriteStream> | null = null
       try {
-        response = await fetch(url, { signal: controller.signal })
+        response = await fetchWithRegistryFallback(url, {
+          signal: controller.signal,
+        })
 
         if (!response.ok) {
           if (response.status === 404) {
             throw new Error(
               `${this.config.displayName} ${fullVersion} binaries not found (404). ` +
                 `This version may have been removed from hostdb. ` +
-                `Try a different version or check https://github.com/robertjbass/hostdb/releases`,
+                `Try a different version or check https://registry.layerbase.host`,
             )
           }
           throw new Error(

package/core/base-embedded-binary-manager.ts

@@ -23,6 +23,7 @@ import { paths } from '../config/paths'
 import { spawnAsync } from './spawn-utils'
 import { moveEntry } from './fs-error-utils'
 import { compareVersions } from './version-utils'
+import { fetchWithRegistryFallback } from './hostdb-client'
 import {
   type Engine,
   Platform,
@@ -201,7 +202,9 @@ export abstract class BaseEmbeddedBinaryManager {
 
       let response: Response
       try {
-        response = await fetch(url, { signal: controller.signal })
+        response = await fetchWithRegistryFallback(url, {
+          signal: controller.signal,
+        })
       } catch (error) {
         const err = error as Error
         if (err.name === 'AbortError') {
@@ -220,7 +223,7 @@ export abstract class BaseEmbeddedBinaryManager {
           throw new Error(
             `${this.config.displayName} ${fullVersion} binaries not found (404). ` +
               `This version may have been removed from hostdb. ` +
-              `Try a different version or check https://github.com/robertjbass/hostdb/releases`,
+              `Try a different version or check https://registry.layerbase.host`,
           )
         }
         throw new Error(

package/core/base-server-binary-manager.ts

@@ -23,6 +23,7 @@ import { pipeline } from 'stream/promises'
 import { paths } from '../config/paths'
 import { spawnAsync, extractWindowsArchive } from './spawn-utils'
 import { isRenameFallbackError } from './fs-error-utils'
+import { fetchWithRegistryFallback } from './hostdb-client'
 import {
   type Engine,
   Platform,
@@ -205,7 +206,9 @@ export abstract class BaseServerBinaryManager {
 
       let response: Response
       try {
-        response = await fetch(url, { signal: controller.signal })
+        response = await fetchWithRegistryFallback(url, {
+          signal: controller.signal,
+        })
       } catch (error) {
         const err = error as Error
         if (err.name === 'AbortError') {
@@ -224,7 +227,7 @@ export abstract class BaseServerBinaryManager {
           throw new Error(
             `${this.config.displayName} ${fullVersion} binaries not found (404). ` +
               `This version may have been removed from hostdb. ` +
-              `Try a different version or check https://github.com/robertjbass/hostdb/releases`,
+              `Try a different version or check https://registry.layerbase.host`,
           )
         }
         throw new Error(