spindb 0.37.2 → 0.38.0

package/dist/engines/mysql/version-validator.js

@@ -0,0 +1,266 @@
+/**
+ * MySQL/MariaDB Version Validator
+ *
+ * Validates compatibility between mysql client version and dump file version.
+ * MySQL is generally more lenient than PostgreSQL, but we still warn about:
+ * - MariaDB dumps being restored to MySQL (and vice versa)
+ * - Newer dumps being restored to older clients
+ */
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { createReadStream } from 'fs';
+import { createInterface } from 'readline';
+import { SpinDBError, ErrorCodes, logWarning, logDebug, } from '../../core/error-handler.js';
+import { getMysqlClientPath } from './binary-detection.js';
+const execAsync = promisify(exec);
+// =============================================================================
+// Version Parsing
+// =============================================================================
+/**
+ * Parse version from mysql --version output
+ * Examples:
+ *   "mysql  Ver 8.0.35 for macos14.0 on arm64 (Homebrew)"
+ *   "mysql  Ver 14.14 Distrib 5.7.44, for Linux (x86_64)" (MySQL 5.7)
+ *   "mysql  Ver 15.1 Distrib 10.11.6-MariaDB, for osx10.19 (arm64)"
+ *   "mysql from 11.4.3-MariaDB, client 15.2 for osx10.20 (arm64)"
+ */
+export function parseToolVersion(output) {
+    // Check for MariaDB - must explicitly contain "mariadb" in the string
+    // Note: Both MySQL 5.7 and MariaDB use "Distrib", but only MariaDB includes "-MariaDB"
+    const isMariaDB = output.toLowerCase().includes('mariadb');
+    let match = null;
+    if (isMariaDB) {
+        // MariaDB: "Distrib 10.11.6-MariaDB" or "from 11.4.3-MariaDB"
+        match = output.match(/(?:Distrib|from)\s+(\d+)\.(\d+)\.(\d+)/);
+    }
+    if (!match) {
+        // MySQL with Distrib: "Distrib 5.7.44" (MySQL 5.7 style)
+        match = output.match(/Distrib\s+(\d+)\.(\d+)\.(\d+)/);
+    }
+    if (!match) {
+        // MySQL: "Ver 8.0.35"
+        match = output.match(/Ver\s+(\d+)\.(\d+)(?:\.(\d+))?/);
+    }
+    if (!match) {
+        // Generic fallback
+        match = output.match(/(\d+)\.(\d+)(?:\.(\d+))?/);
+    }
+    if (!match) {
+        throw new Error(`Cannot parse version from: ${output}`);
+    }
+    return {
+        version: {
+            major: parseInt(match[1], 10),
+            minor: parseInt(match[2], 10),
+            patch: parseInt(match[3] || '0', 10),
+            full: match[0].replace(/^(Ver|Distrib|from)\s+/, ''),
+        },
+        variant: isMariaDB ? 'mariadb' : 'mysql',
+    };
+}
+// Read the first N lines of a file
+async function readFirstLines(filePath, lineCount) {
+    return new Promise((resolve, reject) => {
+        const lines = [];
+        const stream = createReadStream(filePath, { encoding: 'utf8' });
+        const rl = createInterface({ input: stream });
+        rl.on('line', (line) => {
+            lines.push(line);
+            if (lines.length >= lineCount) {
+                rl.close();
+                stream.destroy();
+            }
+        });
+        rl.on('close', () => {
+            resolve(lines.join('\n'));
+        });
+        rl.on('error', reject);
+        stream.on('error', reject);
+    });
+}
+/**
+ * Parse version from dump file header
+ *
+ * MySQL dump header:
+ *   -- MySQL dump 10.13  Distrib 8.0.35, for macos14.0 (arm64)
+ *   -- Server version   8.0.35
+ *
+ * MariaDB dump header:
+ *   -- MariaDB dump 10.19-11.4.3-MariaDB, for osx10.20 (arm64)
+ *   -- Server version   11.4.3-MariaDB
+ */
+export async function parseDumpVersion(dumpPath) {
+    try {
+        const header = await readFirstLines(dumpPath, 30);
+        // Detect variant
+        let variant = 'unknown';
+        if (header.includes('MariaDB dump') || header.includes('-MariaDB')) {
+            variant = 'mariadb';
+        }
+        else if (header.includes('MySQL dump')) {
+            variant = 'mysql';
+        }
+        // Try to get server version (more accurate than dump tool version)
+        // "-- Server version   8.0.35" or "-- Server version   11.4.3-MariaDB"
+        const serverMatch = header.match(/--\s*Server version\s+(\d+)\.(\d+)(?:\.(\d+))?/);
+        if (serverMatch) {
+            return {
+                version: {
+                    major: parseInt(serverMatch[1], 10),
+                    minor: parseInt(serverMatch[2], 10),
+                    patch: parseInt(serverMatch[3] || '0', 10),
+                    full: `${serverMatch[1]}.${serverMatch[2]}${serverMatch[3] ? `.${serverMatch[3]}` : ''}`,
+                },
+                variant,
+                serverVersion: header.match(/--\s*Server version\s+([^\n]+)/)?.[1],
+            };
+        }
+        // Fall back to Distrib version in header
+        // "Distrib 8.0.35" or "10.19-11.4.3-MariaDB"
+        let distribMatch = header.match(/Distrib\s+(\d+)\.(\d+)(?:\.(\d+))?/);
+        if (!distribMatch && variant === 'mariadb') {
+            // MariaDB format: "dump 10.19-11.4.3-MariaDB"
+            distribMatch = header.match(/dump\s+[\d.]+-(\d+)\.(\d+)\.(\d+)/);
+        }
+        if (distribMatch) {
+            return {
+                version: {
+                    major: parseInt(distribMatch[1], 10),
+                    minor: parseInt(distribMatch[2], 10),
+                    patch: parseInt(distribMatch[3] || '0', 10),
+                    full: `${distribMatch[1]}.${distribMatch[2]}${distribMatch[3] ? `.${distribMatch[3]}` : ''}`,
+                },
+                variant,
+            };
+        }
+        return { version: null, variant };
+    }
+    catch (error) {
+        logDebug('Failed to parse dump version', {
+            dumpPath,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return { version: null, variant: 'unknown' };
+    }
+}
+// Get the version of the mysql client
+export async function getMysqlClientVersion() {
+    const mysqlPath = await getMysqlClientPath();
+    if (!mysqlPath) {
+        throw new Error('mysql client not found');
+    }
+    const { stdout } = await execAsync(`"${mysqlPath}" --version`);
+    return parseToolVersion(stdout);
+}
+// =============================================================================
+// Compatibility Checking
+// =============================================================================
+/**
+ * Check version compatibility
+ *
+ * MySQL/MariaDB compatibility matrix:
+ * | Scenario | Result |
+ * |----------|--------|
+ * | MySQL 8 client + MySQL 8 dump | ✅ Works |
+ * | MySQL 8 client + MySQL 5.7 dump | ✅ Works (backwards compatible) |
+ * | MySQL 5.7 client + MySQL 8 dump | ⚠️ May have issues |
+ * | MariaDB client + MySQL dump | ⚠️ Warning (mostly compatible) |
+ * | MySQL client + MariaDB dump | ⚠️ Warning (mostly compatible) |
+ */
+export function checkVersionCompatibility(dumpInfo, toolVersion, toolVariant) {
+    const result = {
+        compatible: true,
+        dumpInfo,
+        toolVersion,
+        toolVariant,
+    };
+    // If we couldn't parse dump version, proceed with warning
+    if (!dumpInfo.version) {
+        result.warning = 'Could not detect dump version. Proceeding anyway.';
+        return result;
+    }
+    // Check for variant mismatch (MySQL vs MariaDB)
+    if (dumpInfo.variant !== 'unknown' &&
+        toolVariant !== 'unknown' &&
+        dumpInfo.variant !== toolVariant) {
+        result.warning =
+            `Dump was created with ${dumpInfo.variant === 'mariadb' ? 'MariaDB' : 'MySQL'}, ` +
+                `but restoring with ${toolVariant === 'mariadb' ? 'MariaDB' : 'MySQL'}. ` +
+                `This usually works, but some features may not be compatible.`;
+        return result;
+    }
+    // MySQL 8 introduced significant changes
+    // Restoring MySQL 8+ dump with MySQL 5.x client may fail
+    if (dumpInfo.version.major >= 8 && toolVersion.major < 8) {
+        result.compatible = false;
+        result.error =
+            `Dump was created with MySQL ${dumpInfo.version.major}, ` +
+                `but your mysql client is version ${toolVersion.major}. ` +
+                `MySQL 8 dumps may contain syntax not supported by older clients.`;
+        return result;
+    }
+    // MariaDB 10.x to MySQL may have issues with specific features
+    if (dumpInfo.variant === 'mariadb' &&
+        toolVariant === 'mysql' &&
+        dumpInfo.version.major >= 10) {
+        result.warning =
+            `Dump was created with MariaDB ${dumpInfo.version.full}. ` +
+                `Some MariaDB-specific features may not restore correctly to MySQL.`;
+        return result;
+    }
+    // Warn if dump is newer than tool (any variant)
+    if (dumpInfo.version.major > toolVersion.major) {
+        result.warning =
+            `Dump was created with version ${dumpInfo.version.full}, ` +
+                `but your client is version ${toolVersion.full}. ` +
+                `Some features may not restore correctly.`;
+        return result;
+    }
+    // Warn if dump is very old (5+ years)
+    if (dumpInfo.version.major < 5 ||
+        (dumpInfo.version.major === 5 && dumpInfo.version.minor < 7)) {
+        result.warning =
+            `Dump was created with MySQL ${dumpInfo.version.full}. ` +
+                `This is a very old version; some data types may not import correctly.`;
+        return result;
+    }
+    return result;
+}
+// =============================================================================
+// Main Validation Function
+// =============================================================================
+/**
+ * Validate that a dump file can be restored with the available mysql client
+ *
+ * @throws SpinDBError if versions are incompatible
+ */
+export async function validateRestoreCompatibility(options) {
+    const { dumpPath } = options;
+    // Get tool version
+    const { version: toolVersion, variant: toolVariant } = await getMysqlClientVersion();
+    logDebug('mysql client version detected', {
+        version: toolVersion.full,
+        variant: toolVariant,
+    });
+    // Get dump version
+    const dumpInfo = await parseDumpVersion(dumpPath);
+    if (dumpInfo.version) {
+        logDebug('Dump version detected', {
+            version: dumpInfo.version.full,
+            variant: dumpInfo.variant,
+        });
+    }
+    else {
+        logDebug('Could not detect dump version');
+    }
+    // Check compatibility
+    const result = checkVersionCompatibility(dumpInfo, toolVersion, toolVariant);
+    if (!result.compatible) {
+        throw new SpinDBError(ErrorCodes.VERSION_MISMATCH, result.error, 'fatal', 'Install a newer version of MySQL client tools', { dumpInfo, toolVersion, toolVariant });
+    }
+    if (result.warning) {
+        logWarning(result.warning);
+    }
+    return { dumpInfo, toolVersion, toolVariant };
+}
+//# sourceMappingURL=version-validator.js.map

package/dist/engines/mysql/version-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-validator.js","sourceRoot":"","sources":["../../../engines/mysql/version-validator.ts"],"names":[],"mappings":"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"}

package/dist/engines/postgresql/backup.js

@@ -0,0 +1,118 @@
+/**
+ * PostgreSQL Backup
+ *
+ * Creates database backups in SQL or custom (.dump) format using pg_dump.
+ */
+import { spawn } from 'child_process';
+import { stat } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { configManager } from '../../core/config-manager.js';
+import { getWindowsSpawnOptions, platformService, } from '../../core/platform-service.js';
+import { defaults } from '../../config/defaults.js';
+import { paths } from '../../config/paths.js';
+import { normalizeVersion } from './version-maps.js';
+/**
+ * Get pg_dump path for a specific PostgreSQL version.
+ *
+ * Prioritizes SpinDB-managed binaries that match the container's version,
+ * falling back to system pg_dump only if no matching version is found.
+ *
+ * @param containerVersion - The container's PostgreSQL version (e.g., "18" or "18.1.0")
+ * @returns Path to the version-matched pg_dump binary
+ */
+async function getPgDumpPath(containerVersion) {
+    // Normalize to full version (e.g., "18" -> "18.1.0")
+    const fullVersion = normalizeVersion(containerVersion);
+    // Get platform info for building the binary path
+    const platformInfo = platformService.getPlatformInfo();
+    const ext = platformInfo.platform === 'win32' ? '.exe' : '';
+    // Try to find SpinDB-managed pg_dump for the matching version
+    const versionedBinPath = paths.getBinaryPath({
+        engine: 'postgresql',
+        version: fullVersion,
+        platform: platformInfo.platform,
+        arch: platformInfo.arch,
+    });
+    const versionedPgDump = join(versionedBinPath, 'bin', `pg_dump${ext}`);
+    if (existsSync(versionedPgDump)) {
+        return versionedPgDump;
+    }
+    // Try to find any installed version for this major version
+    const majorVersion = containerVersion.split('.')[0];
+    const installed = paths.findInstalledBinaryForMajor('postgresql', majorVersion, platformInfo.platform, platformInfo.arch);
+    if (installed) {
+        const installedPgDump = join(installed.path, 'bin', `pg_dump${ext}`);
+        if (existsSync(installedPgDump)) {
+            return installedPgDump;
+        }
+    }
+    // Fall back to globally registered pg_dump (system binary)
+    const systemPgDump = await configManager.getBinaryPath('pg_dump');
+    if (systemPgDump) {
+        return systemPgDump;
+    }
+    throw new Error(`pg_dump not found for PostgreSQL ${containerVersion}. ` +
+        `Either download PostgreSQL binaries with 'spindb create --engine postgresql --version ${majorVersion}' ` +
+        'or install PostgreSQL client tools:\n' +
+        '  macOS: brew install libpq && brew link --force libpq\n' +
+        '  Ubuntu/Debian: apt install postgresql-client\n\n' +
+        'Or configure manually: spindb config set pg_dump /path/to/pg_dump');
+}
+/**
+ * Create a backup of a PostgreSQL database
+ *
+ * CLI equivalent:
+ * - SQL format: pg_dump -Fp -h 127.0.0.1 -p {port} -U postgres -d {database} -f {outputPath}
+ * - Dump format: pg_dump -Fc -h 127.0.0.1 -p {port} -U postgres -d {database} -f {outputPath}
+ */
+export async function createBackup(container, outputPath, options) {
+    const { port, version } = container;
+    const { database, format } = options;
+    const pgDumpPath = await getPgDumpPath(version);
+    // -Fp = plain SQL format, -Fc = custom format
+    const formatFlag = format === 'sql' ? '-Fp' : '-Fc';
+    return new Promise((resolve, reject) => {
+        const args = [
+            '-h',
+            '127.0.0.1',
+            '-p',
+            String(port),
+            '-U',
+            defaults.superuser,
+            '-d',
+            database,
+            formatFlag,
+            '-f',
+            outputPath,
+        ];
+        const spawnOptions = {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            ...getWindowsSpawnOptions(),
+        };
+        const proc = spawn(pgDumpPath, args, spawnOptions);
+        let stderr = '';
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('error', (err) => {
+            reject(err);
+        });
+        proc.on('close', async (code) => {
+            if (code === 0) {
+                // Get file size
+                const stats = await stat(outputPath);
+                resolve({
+                    path: outputPath,
+                    format: format === 'sql' ? 'sql' : 'custom',
+                    size: stats.size,
+                });
+            }
+            else {
+                const errorMessage = stderr || `pg_dump exited with code ${code}`;
+                reject(new Error(errorMessage));
+            }
+        });
+    });
+}
+//# sourceMappingURL=backup.js.map

package/dist/engines/postgresql/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../engines/postgresql/backup.ts"],"names":[],"mappings":"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"}

package/dist/engines/postgresql/binary-manager.js

@@ -0,0 +1,85 @@
+/**
+ * PostgreSQL Binary Manager
+ *
+ * Handles downloading, extracting, and managing PostgreSQL binaries from hostdb.
+ * PostgreSQL binaries include both server (postgres, pg_ctl, initdb) and client
+ * tools (psql, pg_dump, pg_restore, pg_basebackup).
+ *
+ * All platforms (macOS, Linux, Windows) download from hostdb - Windows uses
+ * EDB binaries that are uploaded to hostdb for consistency.
+ */
+import { BaseServerBinaryManager, } from '../../core/base-server-binary-manager.js';
+import { paths } from '../../config/paths.js';
+import { spawnAsync } from '../../core/spawn-utils.js';
+import { getBinaryUrl } from './binary-urls.js';
+import { normalizeVersion } from './version-maps.js';
+import { Engine, Platform } from '../../types/index.js';
+class PostgreSQLBinaryManager extends BaseServerBinaryManager {
+    config = {
+        engine: Engine.PostgreSQL,
+        engineName: 'postgresql',
+        displayName: 'PostgreSQL',
+        serverBinaryNames: ['postgres'],
+    };
+    getBinaryUrlFromModule(version, platform, arch) {
+        return getBinaryUrl(version, platform, arch);
+    }
+    normalizeVersionFromModule(version) {
+        return normalizeVersion(version);
+    }
+    parseVersionFromOutput(stdout) {
+        // Extract version from output like "postgres (PostgreSQL) 18.1"
+        const match = stdout.match(/postgres \(PostgreSQL\) ([\d.]+)/);
+        return match?.[1] ?? null;
+    }
+    /**
+     * Verify that PostgreSQL binaries are working
+     *
+     * PostgreSQL outputs version in format: "postgres (PostgreSQL) X.Y" or
+     * "postgres (PostgreSQL) X.Y - Percona Server for PostgreSQL X.Y.Z"
+     * This differs from MySQL/MariaDB's "Ver X.Y.Z" format.
+     */
+    async verify(version, platform, arch) {
+        const fullVersion = this.getFullVersion(version);
+        const binPath = paths.getBinaryPath({
+            engine: this.config.engineName,
+            version: fullVersion,
+            platform,
+            arch,
+        });
+        const ext = platform === Platform.Win32 ? '.exe' : '';
+        const serverPath = this.findServerBinaryPath(binPath, ext);
+        if (!serverPath) {
+            throw new Error(`${this.config.displayName} binary not found at ${binPath}/bin/`);
+        }
+        let stdout;
+        try {
+            const result = await spawnAsync(serverPath, ['--version']);
+            stdout = result.stdout;
+        }
+        catch (error) {
+            // Only wrap spawn/OS errors, not our validation errors
+            const err = error;
+            throw new Error(`Failed to verify ${this.config.displayName} binaries: ${err.message}`);
+        }
+        const reportedVersion = this.parseVersionFromOutput(stdout);
+        if (!reportedVersion) {
+            throw new Error(`Could not parse version from: ${stdout.trim()}`);
+        }
+        const expectedNormalized = this.stripTrailingZero(fullVersion);
+        const reportedNormalized = this.stripTrailingZero(reportedVersion);
+        // Check if versions match (e.g., "18.1.0" vs "18.1")
+        if (reportedNormalized === expectedNormalized) {
+            return true;
+        }
+        // Also accept if major.minor matches (e.g., expected "18.1.0", got "18.1")
+        const expectedMajorMinor = fullVersion.split('.').slice(0, 2).join('.');
+        const reportedMajorMinor = reportedVersion.split('.').slice(0, 2).join('.');
+        if (expectedMajorMinor === reportedMajorMinor) {
+            return true;
+        }
+        throw new Error(`Version mismatch: expected ${fullVersion}, got ${reportedVersion}`);
+    }
+}
+export const postgresqlBinaryManager = new PostgreSQLBinaryManager();
+//# sourceMappingURL=binary-manager.js.map

package/dist/engines/postgresql/binary-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-manager.js","sourceRoot":"","sources":["../../../engines/postgresql/binary-manager.ts"],"names":[],"mappings":"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"}

package/dist/engines/postgresql/binary-urls.js

@@ -0,0 +1,80 @@
+import { POSTGRESQL_VERSION_MAP } from './version-maps.js';
+import { buildHostdbUrl } from '../../core/hostdb-client.js';
+import { validateSemverLikeVersion } from '../../core/version-utils.js';
+import { Engine, Platform } from '../../types/index.js';
+// Supported platform/arch combinations for PostgreSQL hostdb binaries
+const SUPPORTED_PLATFORM_KEYS = new Set([
+    'darwin-arm64',
+    'darwin-x64',
+    'linux-arm64',
+    'linux-x64',
+    'win32-x64',
+]);
+/**
+ * Get the hostdb platform identifier
+ *
+ * hostdb uses standard platform naming (e.g., 'darwin-arm64', 'linux-x64')
+ * which matches Node.js platform identifiers directly.
+ *
+ * @param platform - Node.js platform (e.g., 'darwin', 'linux', 'win32')
+ * @param arch - Node.js architecture (e.g., 'arm64', 'x64')
+ * @returns hostdb platform identifier or null if unsupported
+ */
+export function getHostdbPlatform(platform, arch) {
+    const key = `${platform}-${arch}`;
+    return SUPPORTED_PLATFORM_KEYS.has(key) ? key : null;
+}
+/**
+ * Build the download URL for PostgreSQL binaries from hostdb
+ *
+ * Format: https://registry.layerbase.host/postgresql-{version}/postgresql-{version}-{platform}-{arch}.tar.gz
+ *
+ * @param version - PostgreSQL version (e.g., '17', '17.7.0')
+ * @param platform - Platform identifier (e.g., 'darwin', 'linux')
+ * @param arch - Architecture identifier (e.g., 'arm64', 'x64')
+ * @returns Download URL for the binary
+ */
+export function getBinaryUrl(version, platform, arch) {
+    const platformKey = `${platform}-${arch}`;
+    const hostdbPlatform = getHostdbPlatform(platform, arch);
+    if (!hostdbPlatform) {
+        throw new Error(`Unsupported platform: ${platformKey}`);
+    }
+    // Normalize version (handles major version lookup and X.Y -> X.Y.0 conversion)
+    const fullVersion = normalizeVersion(version, POSTGRESQL_VERSION_MAP);
+    const ext = platform === Platform.Win32 ? 'zip' : 'tar.gz';
+    return buildHostdbUrl(Engine.PostgreSQL, {
+        version: fullVersion,
+        hostdbPlatform,
+        extension: ext,
+    });
+}
+/**
+ * Normalize version string to X.Y.Z format
+ *
+ * @param version - Version string (e.g., '17', '17.7', '17.7.0')
+ * @param versionMap - Optional version map for major version lookup
+ * @returns Normalized version (e.g., '17.7.0')
+ * @throws TypeError if version string is malformed
+ */
+function normalizeVersion(version, versionMap = POSTGRESQL_VERSION_MAP) {
+    // Check if it's a major version in the map
+    if (versionMap[version]) {
+        return versionMap[version];
+    }
+    // Validate version format: must be numeric semver-like (X, X.Y, or X.Y.Z)
+    validateSemverLikeVersion(version, 'PostgreSQL');
+    // Normalize to X.Y.Z format
+    const parts = version.split('.');
+    if (parts.length === 2) {
+        return `${version}.0`;
+    }
+    return version;
+}
+/**
+ * Get the full version string for a major version
+ *
+ * @param majorVersion - Major version (e.g., '17')
+ * @returns Full version string (e.g., '17.7.0') or null if not supported
+ */
+//# sourceMappingURL=binary-urls.js.map

package/dist/engines/postgresql/binary-urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-urls.js","sourceRoot":"","sources":["../../../engines/postgresql/binary-urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAa,MAAM,aAAa,CAAA;AAEzD,sEAAsE;AACtE,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC;IACtC,cAAc;IACd,YAAY;IACZ,aAAa;IACb,WAAW;IACX,WAAW;CACZ,CAAC,CAAA;AAEF;;;;;;;;;GASG;AAEH,MAAM,UAAU,iBAAiB,CAC/B,QAAkB,EAClB,IAAU;IAEV,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAA;IACjC,OAAO,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AACtD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAe,EACf,QAAkB,EAClB,IAAU;IAEV,MAAM,WAAW,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAA;IACzC,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACxD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,WAAW,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,+EAA+E;IAC/E,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAA;IACrE,MAAM,GAAG,GAAG,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;IAE1D,OAAO,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE;QACvC,OAAO,EAAE,WAAW;QACpB,cAAc;QACd,SAAS,EAAE,GAAG;KACf,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,gBAAgB,CACvB,OAAe,EACf,aAAqC,sBAAsB;IAE3D,2CAA2C;IAC3C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED,0EAA0E;IAC1E,yBAAyB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAA;IAEhD,4BAA4B;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,OAAO,IAAI,CAAA;IACvB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;GAKG"}

package/dist/engines/postgresql/hostdb-releases.js

@@ -0,0 +1,21 @@
+/**
+ * hostdb Releases Module for PostgreSQL
+ *
+ * Fetches PostgreSQL binary information from the hostdb repository at
+ * https://github.com/robertjbass/hostdb
+ */
+import { createHostdbReleases } from '../../core/hostdb-releases-factory.js';
+import { POSTGRESQL_VERSION_MAP, SUPPORTED_MAJOR_VERSIONS, } from './version-maps.js';
+import { postgresqlBinaryManager } from './binary-manager.js';
+import { Engine } from '../../types/index.js';
+const hostdbReleases = createHostdbReleases({
+    engine: Engine.PostgreSQL,
+    displayName: 'PostgreSQL',
+    versionMap: POSTGRESQL_VERSION_MAP,
+    supportedMajorVersions: SUPPORTED_MAJOR_VERSIONS,
+    groupingStrategy: 'single-digit',
+    listInstalled: () => postgresqlBinaryManager.listInstalled(),
+});
+export const fetchAvailableVersions = hostdbReleases.fetchAvailableVersions;
+export const getLatestVersion = hostdbReleases.getLatestVersion;
+//# sourceMappingURL=hostdb-releases.js.map

package/dist/engines/postgresql/hostdb-releases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hostdb-releases.js","sourceRoot":"","sources":["../../../engines/postgresql/hostdb-releases.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AACzE,OAAO,EACL,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,cAAc,GAAG,oBAAoB,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC,UAAU;IACzB,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,sBAAsB;IAClC,sBAAsB,EAAE,wBAAwB;IAChD,gBAAgB,EAAE,cAAc;IAChC,aAAa,EAAE,GAAG,EAAE,CAAC,uBAAuB,CAAC,aAAa,EAAE;CAC7D,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,CAAA;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC,gBAAgB,CAAA"}