spindb 0.34.5 → 0.35.2

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

@@ -74,7 +74,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 +1729,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 +1797,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

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.json

@@ -185,7 +185,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 +195,7 @@
       "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)."
     },
     "couchdb": {
       "displayName": "CouchDB",

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(