spindb 0.34.3 → 0.35.2

package/engines/cockroachdb/hostdb-releases.ts

@@ -1,114 +1,26 @@
 /**
- * CockroachDB hostdb releases integration
+ * hostdb Releases Module for CockroachDB
  *
- * Fetches available versions from hostdb releases.json and provides
- * fallback to local version maps.
+ * Fetches CockroachDB binary information from the hostdb repository at
+ * https://github.com/robertjbass/hostdb
  */
 
-import { logDebug } from '../../core/error-handler'
+import { createHostdbReleases } from '../../core/hostdb-releases-factory'
 import {
   COCKROACHDB_VERSION_MAP,
   SUPPORTED_MAJOR_VERSIONS,
 } from './version-maps'
-
-const HOSTDB_RELEASES_URL =
-  'https://raw.githubusercontent.com/robertjbass/hostdb/main/releases.json'
-
-// Cache for fetched versions (expires after 5 minutes)
-let cachedVersions: Record<string, string[]> | null = null
-let cacheExpiry = 0
-const CACHE_TTL_MS = 5 * 60 * 1000
-
-type HostdbReleases = {
-  [engine: string]: {
-    versions: {
-      version: string
-      platforms: string[]
-    }[]
-  }
-}
-
-/**
- * Fetch available CockroachDB versions from hostdb
- * Returns a map of major version to available patch versions
- *
- * Falls back to local version maps if fetch fails
- */
-export async function fetchAvailableVersions(): Promise<
-  Record<string, string[]>
-> {
-  // Return cached versions if still valid
-  if (cachedVersions && Date.now() < cacheExpiry) {
-    return cachedVersions
-  }
-
-  try {
-    const response = await fetch(HOSTDB_RELEASES_URL)
-    if (!response.ok) {
-      throw new Error(`HTTP ${response.status}`)
-    }
-
-    const releases = (await response.json()) as HostdbReleases
-    const cockroachdbReleases = releases.cockroachdb
-
-    if (!cockroachdbReleases?.versions) {
-      throw new Error('No CockroachDB versions found in releases.json')
-    }
-
-    // Group versions by major version (YY.MM format)
-    const versionMap: Record<string, string[]> = {}
-
-    for (const { version } of cockroachdbReleases.versions) {
-      // Extract major version (e.g., "25" from "25.4.2")
-      const majorMatch = version.match(/^(\d+)/)
-      if (!majorMatch) continue
-
-      const majorVersion = majorMatch[1]
-      if (!versionMap[majorVersion]) {
-        versionMap[majorVersion] = []
-      }
-      versionMap[majorVersion].push(version)
-    }
-
-    // Sort versions within each major version (newest first)
-    for (const major of Object.keys(versionMap)) {
-      versionMap[major].sort((a, b) => {
-        const partsA = a.split('.').map(Number)
-        const partsB = b.split('.').map(Number)
-        for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
-          const diff = (partsB[i] || 0) - (partsA[i] || 0)
-          if (diff !== 0) return diff
-        }
-        return 0
-      })
-    }
-
-    // Cache the results
-    cachedVersions = versionMap
-    cacheExpiry = Date.now() + CACHE_TTL_MS
-
-    logDebug('Fetched CockroachDB versions from hostdb', { versionMap })
-    return versionMap
-  } catch (error) {
-    logDebug(`Failed to fetch hostdb releases: ${error}`)
-
-    // Fall back to local version maps
-    const fallbackMap: Record<string, string[]> = {}
-    for (const major of SUPPORTED_MAJOR_VERSIONS) {
-      const fullVersion = COCKROACHDB_VERSION_MAP[major]
-      if (fullVersion) {
-        fallbackMap[major] = [fullVersion]
-      }
-    }
-
-    return fallbackMap
-  }
-}
-
-/**
- * Clear the version cache (useful for testing)
- */
-export function clearVersionCache(): void {
-  cachedVersions = null
-  cacheExpiry = 0
-}
+import { cockroachdbBinaryManager } from './binary-manager'
+import { Engine } from '../../types'
+
+const hostdbReleases = createHostdbReleases({
+  engine: Engine.CockroachDB,
+  displayName: 'CockroachDB',
+  versionMap: COCKROACHDB_VERSION_MAP,
+  supportedMajorVersions: SUPPORTED_MAJOR_VERSIONS,
+  groupingStrategy: 'single-digit',
+  listInstalled: () => cockroachdbBinaryManager.listInstalled(),
+})
+
+export const fetchAvailableVersions = hostdbReleases.fetchAvailableVersions
+export const getLatestVersion = hostdbReleases.getLatestVersion

package/engines/cockroachdb/version-maps.ts

@@ -2,7 +2,7 @@
  * CockroachDB version mapping
  *
  * Maps short version aliases to full versions from hostdb releases.
- * MUST stay in sync with hostdb releases.json
+ * MUST stay in sync with hostdb databases.json
  */
 
 // Full version map for CockroachDB

package/engines/couchdb/binary-urls.ts

@@ -37,7 +37,7 @@ export function getHostdbPlatform(
 /**
  * Build the download URL for CouchDB binaries from hostdb
  *
- * Format: https://github.com/robertjbass/hostdb/releases/download/couchdb-{version}/couchdb-{version}-{platform}-{arch}.{ext}
+ * Format: https://registry.layerbase.host/couchdb-{version}/couchdb-{version}-{platform}-{arch}.{ext}
  *
  * @param version - CouchDB version (e.g., '3', '3.5.1')
  * @param platform - Platform identifier (e.g., 'darwin', 'linux', 'win32')

package/engines/duckdb/binary-urls.ts

@@ -12,7 +12,7 @@ import { Engine, type Platform, type Arch } from '../../types'
 /**
  * Build the download URL for DuckDB binaries from hostdb
  *
- * Format: https://github.com/robertjbass/hostdb/releases/download/duckdb-{version}/duckdb-{version}-{platform}-{arch}.{ext}
+ * Format: https://registry.layerbase.host/duckdb-{version}/duckdb-{version}-{platform}-{arch}.{ext}
  *
  * @param version - DuckDB version (e.g., '1', '1.4.3')
  * @param platform - Platform identifier (e.g., 'darwin', 'linux', 'win32')

package/engines/duckdb/index.ts

@@ -25,18 +25,10 @@ import { platformService } from '../../core/platform-service'
 import { paths } from '../../config/paths'
 import { duckdbBinaryManager } from './binary-manager'
 import { getBinaryUrl } from './binary-urls'
-import {
-  SUPPORTED_MAJOR_VERSIONS,
-  DUCKDB_VERSION_MAP,
-  normalizeVersion,
-} from './version-maps'
-import {
-  fetchHostdbReleases,
-  getEngineReleases,
-} from '../../core/hostdb-client'
+import { SUPPORTED_MAJOR_VERSIONS, normalizeVersion } from './version-maps'
+import { fetchAvailableVersions } from './hostdb-releases'
 import { logDebug } from '../../core/error-handler'
 import {
-  Engine,
   type Platform,
   type Arch,
   type ContainerConfig,
@@ -570,7 +562,7 @@ export class DuckDBEngine extends BaseEngine {
           throw new Error(
             `File not found (404) at ${url}. ` +
               `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(
@@ -680,69 +672,7 @@ export class DuckDBEngine extends BaseEngine {
   }
 
   async fetchAvailableVersions(): Promise<Record<string, string[]>> {
-    // Try to fetch from hostdb first
-    try {
-      const releases = await fetchHostdbReleases()
-      const duckdbReleases = getEngineReleases(releases, Engine.DuckDB)
-
-      if (duckdbReleases && Object.keys(duckdbReleases).length > 0) {
-        const result: Record<string, string[]> = {}
-
-        for (const major of SUPPORTED_MAJOR_VERSIONS) {
-          result[major] = []
-
-          // Find all versions matching this major version
-          for (const [, release] of Object.entries(duckdbReleases)) {
-            if (release.version.startsWith(`${major}.`)) {
-              result[major].push(release.version)
-            }
-          }
-
-          // Sort descending (latest first)
-          result[major].sort((a, b) => {
-            const partsA = a.split('.').map(Number)
-            const partsB = b.split('.').map(Number)
-            for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
-              const diff = (partsB[i] || 0) - (partsA[i] || 0)
-              if (diff !== 0) return diff
-            }
-            return 0
-          })
-        }
-
-        return result
-      }
-    } catch (error) {
-      logDebug('Failed to fetch DuckDB versions from hostdb, checking local', {
-        error: error instanceof Error ? error.message : String(error),
-      })
-    }
-
-    // Offline fallback: return only locally installed versions
-    const installed = await duckdbBinaryManager.listInstalled()
-    if (installed.length > 0) {
-      const result: Record<string, string[]> = {}
-      for (const binary of installed) {
-        const major = binary.version.split('.')[0]
-        if (!result[major]) {
-          result[major] = []
-        }
-        if (!result[major].includes(binary.version)) {
-          result[major].push(binary.version)
-        }
-      }
-      return result
-    }
-
-    // Last resort: return hardcoded version map
-    const result: Record<string, string[]> = {}
-    for (const major of SUPPORTED_MAJOR_VERSIONS) {
-      const fullVersion = DUCKDB_VERSION_MAP[major]
-      if (fullVersion) {
-        result[major] = [fullVersion]
-      }
-    }
-    return result
+    return fetchAvailableVersions()
   }
 
   // Helper to get duckdb path or throw a helpful error

package/engines/duckdb/scanner.ts

@@ -0,0 +1,22 @@
+/**
+ * DuckDB Scanner — thin wrapper around shared file-based-utils
+ */
+
+import { Engine } from '../../types'
+import {
+  scanForUnregisteredFiles,
+  deriveContainerName as sharedDeriveContainerName,
+  type UnregisteredFile,
+} from '../file-based-utils'
+
+export type { UnregisteredFile }
+
+export async function scanForUnregisteredDuckDBFiles(
+  directory?: string,
+): Promise<UnregisteredFile[]> {
+  return scanForUnregisteredFiles(Engine.DuckDB, directory)
+}
+
+export function deriveContainerName(fileName: string): string {
+  return sharedDeriveContainerName(fileName, Engine.DuckDB)
+}

package/engines/ferretdb/README.md

@@ -2,45 +2,52 @@
 
 ## Overview
 
-FerretDB is a MongoDB-compatible proxy that stores data in PostgreSQL. It requires **two binaries** to function:
+FerretDB is a MongoDB-compatible proxy that stores data in PostgreSQL. It supports **two major versions** with different backends:
 
-1. **ferretdb** - Stateless Go proxy (MongoDB wire protocol -> PostgreSQL SQL)
-2. **postgresql-documentdb** - PostgreSQL 17 with DocumentDB extension
+**v2 (default, macOS/Linux only):**
+1. **ferretdb** (hostdb: `ferretdb`) - Stateless Go proxy
+2. **postgresql-documentdb** (hostdb: `postgresql-documentdb`) - PostgreSQL 17 with DocumentDB extension
 
-This is a **composite engine** with unique binary management requirements.
+**v1 (all platforms including Windows):**
+1. **ferretdb** (hostdb: `ferretdb`) - Stateless Go proxy (same protocol, older version)
+2. **Plain PostgreSQL** - Standard PostgreSQL via `postgresqlBinaryManager` (shared with standalone PG containers)
+
+This is a **composite engine** with unique binary management requirements. The `isV1(version)` helper in `version-maps.ts` is the single branching point for all version-dependent behavior.
 
 ## Platform Support
 
-| Platform | Architecture | Status | Notes |
-|----------|--------------|--------|-------|
-| darwin | x64 | Supported | Both binaries available |
-| darwin | arm64 | Supported | Both binaries available (Apple Silicon) |
-| linux | x64 | Supported | Both binaries available |
-| linux | arm64 | Supported | Both binaries available |
-| win32 | x64 | **NOT SUPPORTED** | postgresql-documentdb has startup issues |
+| Platform | Architecture | v1 Status | v2 Status | Notes |
+|----------|--------------|-----------|-----------|-------|
+| darwin | x64 | Supported | Supported | Both backends available |
+| darwin | arm64 | Supported | Supported | Both backends available (Apple Silicon) |
+| linux | x64 | Supported | Supported | Both backends available |
+| linux | arm64 | Supported | Supported | Both backends available |
+| win32 | x64 | Supported | **NOT SUPPORTED** | v2: postgresql-documentdb has startup issues |
+
+### Windows Support
 
-### Windows Limitation
+FerretDB **v1 is supported on Windows**. v2 is not available on Windows because postgresql-documentdb fails to initialize properly. `spindb create` auto-selects v1 on Windows. `spindb engines download ferretdb 2` on Windows is blocked with a helpful error suggesting v1.
 
-FerretDB is **not available on Windows** due to postgresql-documentdb startup issues. The Windows binaries exist in hostdb, but the PostgreSQL backend fails to initialize properly. This has been extensively tested and currently requires WSL as a workaround.
+**Important hostdb note:** hostdb has `ferretdb` v2 proxy binaries for Windows but does NOT have `postgresql-documentdb` for Windows. This means the v2 proxy would download successfully but fail to start (no backend). The version-aware platform check in `binary-urls.ts` prevents this.
 
 ### macOS SIP / Container Limitations
 
-On macOS, System Integrity Protection (SIP) can block creating symlinks in system directories (e.g., `/usr/local`). In containerized or locked-down environments, even `sudo` may not permit writes to those paths. If you hit permission errors during setup, use a non-system install location or run with elevated privileges when available. See https://github.com/robertjbass/spindb#ferretdb for details.
+On macOS, System Integrity Protection (SIP) can block creating symlinks in system directories (e.g., `/usr/local`). In containerized or locked-down environments, even `sudo` may not permit writes to those paths. If you hit permission errors during setup, use a non-system install location or run with elevated privileges when available. See https://github.com/robertjbass/spindb#ferretdb for details. This only applies to v2 (DocumentDB's Homebrew-derived paths).
 
 ## Binary Packaging
 
 ### Archive Format
-- **Unix (macOS/Linux)**: `tar.gz` for both binaries
-- **Windows**: Not applicable (unsupported)
+- **Unix (macOS/Linux)**: `tar.gz` for both versions
+- **Windows**: `zip` for v1 proxy, plain PostgreSQL handled by `postgresqlBinaryManager`
 
-### FerretDB Archive Structure
+### FerretDB Archive Structure (both v1 and v2)
 ```
 ferretdb/
 └── bin/
     └── ferretdb          # Go proxy binary
 ```
 
-### postgresql-documentdb Archive Structure
+### postgresql-documentdb Archive Structure (v2 only)
 ```
 postgresql-documentdb/
 ├── bin/
@@ -57,7 +64,13 @@ postgresql-documentdb/
 └── share/               # Configuration and data files
 ```
 
-### Why Custom PostgreSQL Build?
+### v1 Backend (Plain PostgreSQL)
+
+v1 delegates backend management to `postgresqlBinaryManager`, which downloads standard PostgreSQL from hostdb. The PostgreSQL binaries are shared with standalone PostgreSQL containers — deleting a FerretDB v1 installation does NOT delete the shared PostgreSQL.
+
+**Caveat:** If `postgresqlBinaryManager.isInstalled()` finds an existing minimal PostgreSQL install (e.g., from a previous DocumentDB extraction) that only has server binaries (`postgres`, `pg_ctl`, `initdb`) but lacks client tools (`psql`), the engine falls back to `postgres --single` mode for pre-start database creation.
+
+### Why Custom PostgreSQL Build? (v2)
 
 The postgresql-documentdb bundle is a **custom PostgreSQL 17 build** that includes:
 - DocumentDB extension (MongoDB-compatible storage)
@@ -79,11 +92,15 @@ Homebrew PostgreSQL has hardcoded paths (`/opt/homebrew/lib/...`) that break on
 ```typescript
 // FerretDB versions
 export const FERRETDB_VERSION_MAP: Record<string, string> = {
-  '2': '2.7.0',
+  '1': '1.24.2',   // v1: plain PostgreSQL backend
+  '2': '2.7.0',    // v2: postgresql-documentdb backend
 }
 
-// postgresql-documentdb version format: {pg_major}-{documentdb_version}
+// v2 backend version format: {pg_major}-{documentdb_version}
 export const DEFAULT_DOCUMENTDB_VERSION = '17-0.107.0'
+
+// v1 backend: standard PostgreSQL major version
+export const DEFAULT_V1_POSTGRESQL_VERSION = '17'
 ```
 
 ## Implementation Details
@@ -91,14 +108,17 @@ export const DEFAULT_DOCUMENTDB_VERSION = '17-0.107.0'
 ### Composite Binary Manager
 
 FerretDB uses a custom `FerretDBCompositeBinaryManager` that:
-- Downloads both binaries atomically (rolls back if either fails)
-- Manages separate version tracking for FerretDB and DocumentDB
-- Handles platform-specific library requirements
+- Downloads both binaries atomically (rolls back if either fails) — v2 only
+- For v1, downloads FerretDB proxy then delegates PostgreSQL to `postgresqlBinaryManager`
+- `isV1(version)` branches all version-dependent behavior
+- `getBackendBinaryPath()` / `getBackendSpawnEnv()` abstract v1/v2 backend resolution
 
 ### Architecture
 
 ```
-MongoDB Client (:27017) -> FerretDB Proxy -> PostgreSQL+DocumentDB (:54320+)
+MongoDB Client (:27017) -> FerretDB Proxy -> PostgreSQL backend (:54320+)
+                                              v1: plain PostgreSQL
+                                              v2: PostgreSQL + DocumentDB
 ```
 
 ### Three Ports Per Container
@@ -111,11 +131,19 @@ FerretDB containers use **three ports**:
 ### FerretDB-Specific Startup Flags
 
 ```bash
+# v2:
 ferretdb \
-  --no-auth \                              # Disable SCRAM authentication
+  --no-auth \                              # Disable SCRAM authentication (v2 only)
   --debug-addr=127.0.0.1:${port + 10000} \ # Unique debug port per container
   --listen-addr=127.0.0.1:${port} \        # MongoDB wire protocol port
   --postgresql-url=postgres://postgres@127.0.0.1:${backendPort}/ferretdb
+
+# v1 (differences):
+ferretdb \
+  # no --no-auth (auth disabled by default in v1)
+  --debug-addr=127.0.0.1:${port + 10000} \
+  --listen-addr=127.0.0.1:${port} \
+  --postgresql-url=postgres://postgres@127.0.0.1:${backendPort}/ferretdb?sslmode=disable
 ```
 
 ### Linux LD_LIBRARY_PATH
@@ -123,10 +151,10 @@ ferretdb \
 On Linux, the bundled binaries need `LD_LIBRARY_PATH` set to find shared libraries:
 
 ```typescript
-getDocumentDBSpawnEnv(): { LD_LIBRARY_PATH: '/path/to/lib:$LD_LIBRARY_PATH' }
+getBackendSpawnEnv(): { LD_LIBRARY_PATH: '/path/to/lib:$LD_LIBRARY_PATH' }
 ```
 
-macOS uses `@loader_path` which doesn't need environment variables.
+macOS uses `@loader_path` which doesn't need environment variables. Applies to both v1 and v2.
 
 ### macOS Code Signing
 
@@ -163,9 +191,9 @@ Restore may fail with: `duplicate key value violates unique constraint`
 
 ### Uninstall Behavior
 
-When uninstalling FerretDB:
-- FerretDB proxy binary is deleted
-- postgresql-documentdb binary is **also deleted** (dedicated dependency)
+**v2:** Both FerretDB proxy and postgresql-documentdb are deleted. The postgresql-documentdb binary is a dedicated dependency not shared with other engines.
+
+**v1:** Only the FerretDB proxy is deleted. Plain PostgreSQL binaries are **NOT deleted** because they are shared with standalone PostgreSQL containers.
 
 This differs from QuestDB's PostgreSQL dependency (see QuestDB README).
 
@@ -173,7 +201,7 @@ This differs from QuestDB's PostgreSQL dependency (see QuestDB README).
 
 ### 1. Authentication Gotcha
 
-FerretDB 2.x enables SCRAM authentication by default. The `--setup-username` and `--setup-password` flags **do NOT exist** despite documentation suggestions. Use `--no-auth` instead.
+FerretDB 2.x enables SCRAM authentication by default. The `--setup-username` and `--setup-password` flags **do NOT exist** despite documentation suggestions. Use `--no-auth` instead. FerretDB 1.x has auth disabled by default (no flag needed).
 
 ### 2. Debug Port Conflicts
 
@@ -187,9 +215,17 @@ Like MongoDB, databases don't appear until data is written. The engine uses the
 
 Namespace is derived from container name: `my-app` -> `my_app` (dashes replaced with underscores).
 
-### 5. Windows Unsupported
+### 5. Windows: v2 Unsupported, v1 Supported
+
+Extensive testing confirmed postgresql-documentdb (v2 backend) does not start properly on Windows. FerretDB v1 uses plain PostgreSQL and works on all platforms including Windows. **Note:** hostdb has v2 proxy binaries for Windows but NOT the backend — the download command blocks v2 on Windows to prevent broken installs.
+
+### 6. v1 Binary Verification
+
+FerretDB v1 hostdb builds panic on `--version` because the source expects `build/version/version.txt` (via `//go:embed`). The hostdb build script must create this file. SpinDB skips `--version` verification for v1 (only checks binary exists).
+
+### 7. v1 Database Creation Without psql
 
-Extensive testing confirmed postgresql-documentdb does not start properly on Windows. WSL is the recommended workaround.
+If the PostgreSQL backend is a minimal install lacking `psql`, the engine uses `postgres --single` mode before server start to create the `ferretdb` database. This requires exclusive data directory access, so it runs before `pg_ctl start`.
 
 ## Docker E2E Test Notes
 
@@ -201,9 +237,9 @@ FerretDB Docker E2E tests verify:
 
 ## CI/CD Notes
 
-### Skipped on Windows
+### Windows CI
 
-FerretDB CI tests are skipped on Windows runners due to platform limitation.
+FerretDB v2 CI tests are skipped on Windows runners. v1 tests should run on all platforms.
 
 ### GitHub Actions Cache Step
 
@@ -214,11 +250,13 @@ FerretDB CI tests are skipped on Windows runners due to platform limitation.
     path: |
       ~/.spindb/bin/ferretdb-*
       ~/.spindb/bin/postgresql-documentdb-*
+      ~/.spindb/bin/postgresql-*
     key: ferretdb-${{ runner.os }}-${{ runner.arch }}-${{ hashFiles('engines/ferretdb/version-maps.ts') }}
 ```
 
 ## Related Documentation
 
 - [plans/FERRETDB.md](../../plans/FERRETDB.md) - Original implementation plan (may be outdated)
-- hostdb releases: [ferretdb-2.7.0](https://github.com/robertjbass/hostdb/releases/tag/ferretdb-2.7.0)
-- hostdb releases: [postgresql-documentdb-17-0.107.0](https://github.com/robertjbass/hostdb/releases/tag/postgresql-documentdb-17-0.107.0)
+- hostdb releases: [ferretdb-2.7.0](https://github.com/robertjbass/hostdb/releases/tag/ferretdb-2.7.0) (v2 proxy)
+- hostdb releases: [ferretdb-1.24.2](https://github.com/robertjbass/hostdb/releases/tag/ferretdb-1.24.2) (v1 proxy)
+- hostdb releases: [postgresql-documentdb-17-0.107.0](https://github.com/robertjbass/hostdb/releases/tag/postgresql-documentdb-17-0.107.0) (v2 backend)

package/engines/ferretdb/backup.ts

@@ -14,29 +14,34 @@ import { logDebug } from '../../core/error-handler'
 import { platformService } from '../../core/platform-service'
 import { ferretdbBinaryManager } from './binary-manager'
 import {
-  normalizeDocumentDBVersion,
   DEFAULT_DOCUMENTDB_VERSION,
+  DEFAULT_V1_POSTGRESQL_VERSION,
+  isV1,
 } from './version-maps'
 import type { ContainerConfig, BackupOptions, BackupResult } from '../../types'
 
 /**
- * Get the path to pg_dump from the postgresql-documentdb installation
+ * Get the path to pg_dump from the backend installation
+ * Uses version-aware backend resolution (v1 = plain PostgreSQL, v2 = postgresql-documentdb)
  */
 function getPgDumpPath(container: ContainerConfig): string {
-  const { backendVersion } = container
+  const { version, backendVersion } = container
   const { platform, arch } = platformService.getPlatformInfo()
+  const v1 = isV1(version)
 
-  const fullBackendVersion = normalizeDocumentDBVersion(
-    backendVersion || DEFAULT_DOCUMENTDB_VERSION,
-  )
-  const documentdbPath = ferretdbBinaryManager.getDocumentDBBinaryPath(
-    fullBackendVersion,
+  const effectiveBackendVersion = v1
+    ? backendVersion || DEFAULT_V1_POSTGRESQL_VERSION
+    : backendVersion || DEFAULT_DOCUMENTDB_VERSION
+
+  const backendPath = ferretdbBinaryManager.getBackendBinaryPath(
+    version,
+    effectiveBackendVersion,
     platform,
     arch,
   )
 
   const ext = platformService.getExecutableExtension()
-  return join(documentdbPath, 'bin', `pg_dump${ext}`)
+  return join(backendPath, 'bin', `pg_dump${ext}`)
 }
 
 /**
@@ -63,8 +68,11 @@ export async function createBackup(
   const pgDump = getPgDumpPath(container)
 
   if (!existsSync(pgDump)) {
+    const backendName = isV1(container.version)
+      ? 'PostgreSQL'
+      : 'postgresql-documentdb'
     throw new Error(
-      `pg_dump not found at ${pgDump}. Make sure postgresql-documentdb is installed.`,
+      `pg_dump not found at ${pgDump}. Make sure ${backendName} is installed.`,
     )
   }