spindb 0.37.2 → 0.38.0

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

@@ -0,0 +1,286 @@
+/**
+ * PostgreSQL Version Validator
+ *
+ * Validates compatibility between pg_restore tool version and dump file version.
+ * PostgreSQL is backwards compatible - we only fail when dump_version > tool_version.
+ */
+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 { detectPackageManager } from '../../core/dependency-manager.js';
+import { detectInstalledPostgres, getDirectBinaryPath, findCompatibleVersion, } from '../../core/homebrew-version-manager.js';
+import { detectRemotePostgresVersion, } from './remote-version.js';
+const execAsync = promisify(exec);
+// =============================================================================
+// Version Parsing
+// =============================================================================
+/**
+ * Parse version from pg_dump/pg_restore --version output
+ * Examples:
+ *   "pg_restore (PostgreSQL) 16.1"
+ *   "pg_restore (PostgreSQL) 14.9 (Homebrew)"
+ *   "pg_dump (PostgreSQL) 17.0"
+ */
+export function parseToolVersion(output) {
+    const match = output.match(/(\d+)\.(\d+)(?:\.(\d+))?/);
+    if (!match) {
+        throw new Error(`Cannot parse version from: ${output}`);
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3] || '0', 10),
+        full: match[0],
+    };
+}
+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
+ *
+ * Plain SQL format: "-- Dumped from database version 16.1"
+ * Archive format: Uses `pg_restore -l` to read TOC header
+ */
+export async function parseDumpVersion(dumpPath, format, pgRestorePath) {
+    try {
+        if (format === 'custom' || format === 'directory') {
+            // Use pg_restore -l to get archive info
+            const restorePath = pgRestorePath || 'pg_restore';
+            const { stdout } = await execAsync(`"${restorePath}" -l "${dumpPath}" 2>&1 | head -20`);
+            // Look for: "; Dumped from database version 16.1"
+            const match = stdout.match(/Dumped from database version (\d+)\.(\d+)(?:\.(\d+))?/);
+            if (match) {
+                return {
+                    major: parseInt(match[1], 10),
+                    minor: parseInt(match[2], 10),
+                    patch: parseInt(match[3] || '0', 10),
+                    full: `${match[1]}.${match[2]}${match[3] ? `.${match[3]}` : ''}`,
+                };
+            }
+        }
+        else {
+            // Plain SQL format - read first 50 lines
+            const header = await readFirstLines(dumpPath, 50);
+            const match = header.match(/Dumped from database version (\d+)\.(\d+)(?:\.(\d+))?/);
+            if (match) {
+                return {
+                    major: parseInt(match[1], 10),
+                    minor: parseInt(match[2], 10),
+                    patch: parseInt(match[3] || '0', 10),
+                    full: `${match[1]}.${match[2]}${match[3] ? `.${match[3]}` : ''}`,
+                };
+            }
+        }
+    }
+    catch (error) {
+        logDebug('Failed to parse dump version', {
+            dumpPath,
+            format,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    return null; // Version not found in dump
+}
+// Get the version of pg_restore
+export async function getPgRestoreVersion(pgRestorePath) {
+    const { stdout } = await execAsync(`"${pgRestorePath}" --version`);
+    return parseToolVersion(stdout);
+}
+// =============================================================================
+// Compatibility Checking
+// =============================================================================
+/**
+ * Check version compatibility - ONLY fails when dump is NEWER than tool
+ *
+ * | Scenario | Result |
+ * |----------|--------|
+ * | pg_restore v16 + dump from v14 | ✅ Works (backwards compatible) |
+ * | pg_restore v16 + dump from v16 | ✅ Works (same version) |
+ * | pg_restore v14 + dump from v16 | ❌ Fails (dump newer than tool) |
+ * | pg_restore v16 + dump from v10 | ⚠️ Works with warning (very old) |
+ */
+export function checkVersionCompatibility(dumpVersion, toolVersion) {
+    // If we couldn't parse dump version, proceed with warning
+    if (!dumpVersion) {
+        return {
+            compatible: true,
+            dumpVersion: null,
+            toolVersion,
+            warning: 'Could not detect dump version. Proceeding anyway.',
+        };
+    }
+    // FAIL: Dump is newer than tool (e.g., pg_restore 14 + dump from 16)
+    if (dumpVersion.major > toolVersion.major) {
+        return {
+            compatible: false,
+            dumpVersion,
+            toolVersion,
+            error: `Backup was created with PostgreSQL ${dumpVersion.major}, ` +
+                `but your pg_restore is version ${toolVersion.major}. ` +
+                `Install PostgreSQL ${dumpVersion.major} client tools to restore this backup.`,
+        };
+    }
+    // WARN: Dump is very old (3+ major versions behind)
+    if (dumpVersion.major < toolVersion.major - 2) {
+        return {
+            compatible: true,
+            dumpVersion,
+            toolVersion,
+            warning: `Backup was created with PostgreSQL ${dumpVersion.major}. ` +
+                `Some features may not restore correctly.`,
+        };
+    }
+    // OK: Same version or dump is older (backwards compatible)
+    return { compatible: true, dumpVersion, toolVersion };
+}
+// =============================================================================
+// Main Validation Function
+// =============================================================================
+/**
+ * Validate that a dump file can be restored with the available pg_restore
+ *
+ * @throws SpinDBError if versions are incompatible
+ */
+export async function validateRestoreCompatibility(options) {
+    const { dumpPath, format, pgRestorePath } = options;
+    // Get tool version
+    const toolVersion = await getPgRestoreVersion(pgRestorePath);
+    logDebug('pg_restore version detected', { version: toolVersion.full });
+    // Get dump version
+    const dumpVersion = await parseDumpVersion(dumpPath, format, pgRestorePath);
+    if (dumpVersion) {
+        logDebug('Dump version detected', { version: dumpVersion.full });
+    }
+    else {
+        logDebug('Could not detect dump version');
+    }
+    // Check compatibility
+    const result = checkVersionCompatibility(dumpVersion, toolVersion);
+    if (!result.compatible) {
+        throw new SpinDBError(ErrorCodes.VERSION_MISMATCH, result.error, 'fatal', `Install PostgreSQL ${dumpVersion.major} client tools: brew install postgresql@${dumpVersion.major}`, { dumpVersion, toolVersion });
+    }
+    if (result.warning) {
+        logWarning(result.warning);
+    }
+    return { dumpVersion, toolVersion };
+}
+export async function getPgDumpVersion(pgDumpPath) {
+    const { stdout } = await execAsync(`"${pgDumpPath}" --version`);
+    return parseToolVersion(stdout);
+}
+/**
+ * Validate that a remote database can be dumped with the current pg_dump
+ *
+ * This checks BEFORE dumping to avoid creating incompatible dump files.
+ * Returns the recommended action if the current pg_dump is incompatible.
+ */
+export async function validateDumpCompatibility(options) {
+    const { connectionString, pgDumpPath } = options;
+    // Get local pg_dump version
+    const localVersion = await getPgDumpVersion(pgDumpPath);
+    logDebug('Local pg_dump version', { version: localVersion.full });
+    // Detect remote database version
+    const remoteVersion = await detectRemotePostgresVersion(connectionString);
+    logDebug('Remote database version', {
+        version: remoteVersion.fullVersion,
+        serverType: remoteVersion.serverType,
+    });
+    // Check compatibility: local tool must be >= remote version
+    if (localVersion.major >= remoteVersion.majorVersion) {
+        return {
+            compatible: true,
+            localToolVersion: localVersion,
+            remoteDbVersion: remoteVersion,
+            requiredAction: 'none',
+        };
+    }
+    // Version mismatch - check if we can use a direct path
+    const targetMajor = String(remoteVersion.majorVersion);
+    const directPath = await getDirectBinaryPath('pg_dump', targetMajor);
+    if (directPath) {
+        // Have a direct path to the correct version
+        return {
+            compatible: false,
+            localToolVersion: localVersion,
+            remoteDbVersion: remoteVersion,
+            requiredAction: 'use_direct_path',
+            alternativePath: directPath,
+            switchTarget: targetMajor,
+        };
+    }
+    // Check if any compatible version is installed via Homebrew
+    const compatibleVersion = await findCompatibleVersion(remoteVersion.majorVersion);
+    if (compatibleVersion) {
+        const altPath = await getDirectBinaryPath('pg_dump', compatibleVersion.majorVersion);
+        return {
+            compatible: false,
+            localToolVersion: localVersion,
+            remoteDbVersion: remoteVersion,
+            requiredAction: 'use_direct_path',
+            alternativePath: altPath || undefined,
+            switchTarget: compatibleVersion.majorVersion,
+        };
+    }
+    // Check if we could switch Homebrew (version is installed but not as direct path)
+    const installed = await detectInstalledPostgres();
+    const hasTarget = installed.some((v) => parseInt(v.majorVersion, 10) >= remoteVersion.majorVersion);
+    if (hasTarget) {
+        const best = installed
+            .filter((v) => parseInt(v.majorVersion, 10) >= remoteVersion.majorVersion)
+            .sort((a, b) => parseInt(a.majorVersion, 10) - parseInt(b.majorVersion, 10))[0];
+        return {
+            compatible: false,
+            localToolVersion: localVersion,
+            remoteDbVersion: remoteVersion,
+            requiredAction: 'switch_homebrew',
+            switchTarget: best.majorVersion,
+        };
+    }
+    // Need to install - provide platform-specific instructions
+    const installCmd = await getInstallCommand(targetMajor);
+    return {
+        compatible: false,
+        localToolVersion: localVersion,
+        remoteDbVersion: remoteVersion,
+        requiredAction: 'install',
+        switchTarget: targetMajor,
+        error: `Your pg_dump version (${localVersion.major}) cannot dump from PostgreSQL ${remoteVersion.majorVersion}. ` +
+            `Install PostgreSQL ${targetMajor} client tools: ${installCmd}`,
+    };
+}
+export async function getInstallCommand(majorVersion) {
+    const pm = await detectPackageManager();
+    if (!pm) {
+        return `Install PostgreSQL ${majorVersion} client tools for your platform`;
+    }
+    // Versioned package names per package manager
+    const packages = {
+        brew: `postgresql@${majorVersion}`,
+        apt: `postgresql-client-${majorVersion}`,
+        yum: `postgresql${majorVersion}`,
+        dnf: `postgresql${majorVersion}`,
+        pacman: 'postgresql-libs', // Arch doesn't version packages the same way
+    };
+    const pkg = packages[pm.id] || `postgresql-${majorVersion}`;
+    return pm.config.installTemplate.replace('{package}', pkg);
+}
+//# sourceMappingURL=version-validator.js.map

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

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

package/dist/engines/qdrant/api-client.js

@@ -0,0 +1,50 @@
+/**
+ * Shared Qdrant REST API client utilities
+ */
+/**
+ * Make an HTTP request to Qdrant REST API
+ *
+ * @param port - The HTTP port Qdrant is listening on
+ * @param method - HTTP method (GET, POST, PUT, DELETE)
+ * @param path - API path (e.g., '/collections', '/snapshots')
+ * @param body - Optional JSON body for POST/PUT requests
+ * @param timeoutMs - Request timeout in milliseconds (default: 30s)
+ */
+export async function qdrantApiRequest(port, method, path, body, timeoutMs = 30000) {
+    const url = `http://127.0.0.1:${port}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    const options = {
+        method,
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        signal: controller.signal,
+    };
+    if (body) {
+        options.body = JSON.stringify(body);
+    }
+    try {
+        const response = await fetch(url, options);
+        // Try to parse as JSON, fall back to text for endpoints like /healthz
+        let data;
+        const contentType = response.headers.get('content-type') || '';
+        if (contentType.includes('application/json')) {
+            data = await response.json();
+        }
+        else {
+            data = await response.text();
+        }
+        return { status: response.status, data };
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error(`Qdrant API request timed out after ${timeoutMs / 1000}s: ${method} ${path}`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/engines/qdrant/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../engines/qdrant/api-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,MAAc,EACd,IAAY,EACZ,IAA8B,EAC9B,SAAS,GAAG,KAAK;IAEjB,MAAM,GAAG,GAAG,oBAAoB,IAAI,GAAG,IAAI,EAAE,CAAA;IAE7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAA;IAEjE,MAAM,OAAO,GAAgB;QAC3B,MAAM;QACN,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;SACnC;QACD,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAA;IAED,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAE1C,sEAAsE;QACtE,IAAI,IAAa,CAAA;QACjB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;QAC9D,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7C,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAA;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,sCAAsC,SAAS,GAAG,IAAI,MAAM,MAAM,IAAI,IAAI,EAAE,CAC7E,CAAA;QACH,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAA;IACzB,CAAC;AACH,CAAC"}

package/dist/engines/qdrant/backup.js

@@ -0,0 +1,115 @@
+/**
+ * Qdrant backup module
+ * Supports snapshot-based backup using Qdrant's REST API
+ */
+import { mkdir, stat, copyFile, readdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { logDebug } from '../../core/error-handler.js';
+import { paths } from '../../config/paths.js';
+import { qdrantApiRequest } from './api-client.js';
+// Backup operations may take longer than the default timeout
+const BACKUP_TIMEOUT_MS = 600000; // 10 minutes
+/**
+ * Create a snapshot backup using Qdrant's REST API
+ * This creates a full snapshot of the entire Qdrant instance
+ */
+export async function createBackup(container, outputPath, _options) {
+    const { port, name } = container;
+    // Ensure output directory exists
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir)) {
+        await mkdir(outputDir, { recursive: true });
+    }
+    // Trigger snapshot creation via REST API
+    logDebug(`Creating Qdrant snapshot via REST API on port ${port}`);
+    const response = await qdrantApiRequest(port, 'POST', '/snapshots', undefined, BACKUP_TIMEOUT_MS);
+    if (response.status !== 200) {
+        throw new Error(`Failed to create Qdrant snapshot: ${JSON.stringify(response.data)}`);
+    }
+    const snapshotData = response.data;
+    const snapshotName = snapshotData?.result?.name;
+    if (!snapshotName) {
+        throw new Error(`Qdrant snapshot creation failed: no snapshot name returned`);
+    }
+    logDebug(`Qdrant snapshot created: ${snapshotName}`);
+    // The snapshot is stored in the data directory's snapshots folder
+    const dataDir = paths.getContainerDataPath(name, { engine: 'qdrant' });
+    const snapshotsDir = join(dataDir, 'snapshots');
+    const snapshotPath = join(snapshotsDir, snapshotName);
+    // Wait for the snapshot file to be ready and fully written
+    // Qdrant writes snapshots asynchronously, so we need to wait for both:
+    // 1. The file to exist
+    // 2. The file size to stabilize (no longer being written)
+    const maxWait = 60000; // 60 seconds
+    const startTime = Date.now();
+    let lastSize = -1;
+    while (Date.now() - startTime < maxWait) {
+        if (existsSync(snapshotPath)) {
+            try {
+                const currentStats = await stat(snapshotPath);
+                if (currentStats.size > 0 && currentStats.size === lastSize) {
+                    // Size hasn't changed, file is likely complete
+                    break;
+                }
+                lastSize = currentStats.size;
+            }
+            catch {
+                // File may have been deleted or inaccessible between existsSync and stat
+                // Reset lastSize and continue polling
+                lastSize = -1;
+            }
+        }
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    if (!existsSync(snapshotPath)) {
+        throw new Error(`Qdrant snapshot file not found at ${snapshotPath} after timeout`);
+    }
+    // Copy snapshot to output path
+    await copyFile(snapshotPath, outputPath);
+    const stats = await stat(outputPath);
+    return {
+        path: outputPath,
+        format: 'snapshot',
+        size: stats.size,
+    };
+}
+/**
+ * Create a backup for cloning purposes
+ * Uses snapshot format for reliable data transfer
+ */
+export async function createCloneBackup(container, outputPath) {
+    return createBackup(container, outputPath, { database: 'default' });
+}
+/**
+ * List available snapshots for a container
+ */
+export async function listSnapshots(container) {
+    const { name } = container;
+    const dataDir = paths.getContainerDataPath(name, { engine: 'qdrant' });
+    const snapshotsDir = join(dataDir, 'snapshots');
+    if (!existsSync(snapshotsDir)) {
+        return [];
+    }
+    const files = await readdir(snapshotsDir);
+    const snapshotFiles = files.filter((file) => file.endsWith('.snapshot'));
+    // Stat all snapshot files in parallel for better performance
+    // Filter out any files that fail to stat (e.g., deleted during iteration)
+    const statsResults = await Promise.all(snapshotFiles.map(async (file) => {
+        const filePath = join(snapshotsDir, file);
+        try {
+            const stats = await stat(filePath);
+            return {
+                name: file,
+                createdAt: stats.mtime.toISOString(),
+                size: stats.size,
+            };
+        }
+        catch {
+            // File may have been deleted between readdir and stat
+            return null;
+        }
+    }));
+    return statsResults.filter((result) => result !== null);
+}
+//# sourceMappingURL=backup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../engines/qdrant/backup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAG/C,6DAA6D;AAC7D,MAAM,iBAAiB,GAAG,MAAM,CAAA,CAAC,aAAa;AAE9C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAA0B,EAC1B,UAAkB,EAClB,QAAuB;IAEvB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;IAEhC,iCAAiC;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,CAAC;IAED,yCAAyC;IACzC,QAAQ,CAAC,iDAAiD,IAAI,EAAE,CAAC,CAAA;IAEjE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CACrC,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,SAAS,EACT,iBAAiB,CAClB,CAAA;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CACrE,CAAA;IACH,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAsC,CAAA;IACpE,MAAM,YAAY,GAAG,YAAY,EAAE,MAAM,EAAE,IAAI,CAAA;IAE/C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAA;IACH,CAAC;IAED,QAAQ,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAA;IAEpD,kEAAkE;IAClE,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAErD,2DAA2D;IAC3D,uEAAuE;IACvE,uBAAuB;IACvB,0DAA0D;IAC1D,MAAM,OAAO,GAAG,KAAK,CAAA,CAAC,aAAa;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC5B,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAA;IAEjB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,CAAC;QACxC,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAA;gBAC7C,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC5D,+CAA+C;oBAC/C,MAAK;gBACP,CAAC;gBACD,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAA;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,yEAAyE;gBACzE,sCAAsC;gBACtC,QAAQ,GAAG,CAAC,CAAC,CAAA;YACf,CAAC;QACH,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAC9C,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,qCAAqC,YAAY,gBAAgB,CAClE,CAAA;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;IAExC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAA;IAEpC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,SAA0B,EAC1B,UAAkB;IAElB,OAAO,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAA;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAA0B;IAO5D,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;IAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAE/C,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAA;IACzC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAA;IAExE,6DAA6D;IAC7D,0EAA0E;IAC1E,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;QACzC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAA;YAClC,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE;gBACpC,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;YACtD,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAC,CACH,CAAA;IAED,OAAO,YAAY,CAAC,MAAM,CACxB,CAAC,MAAM,EAAwC,EAAE,CAAC,MAAM,KAAK,IAAI,CAClE,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Qdrant Binary Manager
+ *
+ * Handles downloading, extracting, and managing Qdrant binaries from hostdb.
+ * Extends BaseBinaryManager for shared download/extraction logic.
+ */
+import { BaseBinaryManager, } from '../../core/base-binary-manager.js';
+import { getBinaryUrl } from './binary-urls.js';
+import { normalizeVersion } from './version-maps.js';
+import { Engine } from '../../types/index.js';
+class QdrantBinaryManager extends BaseBinaryManager {
+    config = {
+        engine: Engine.Qdrant,
+        engineName: 'qdrant',
+        displayName: 'Qdrant',
+        serverBinary: 'qdrant',
+    };
+    getBinaryUrlFromModule(version, platform, arch) {
+        return getBinaryUrl(version, platform, arch);
+    }
+    normalizeVersionFromModule(version) {
+        return normalizeVersion(version);
+    }
+    parseVersionFromOutput(stdout) {
+        // Extract version from output like "qdrant 1.16.3" or "v1.16.3"
+        const match = stdout.match(/(?:qdrant\s+)?v?(\d+\.\d+\.\d+)/);
+        return match?.[1] ?? null;
+    }
+}
+export const qdrantBinaryManager = new QdrantBinaryManager();
+//# sourceMappingURL=binary-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-manager.js","sourceRoot":"","sources":["../../../engines/qdrant/binary-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,GAElB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,MAAM,EAA4B,MAAM,aAAa,CAAA;AAE9D,MAAM,mBAAoB,SAAQ,iBAAiB;IAC9B,MAAM,GAAwB;QAC/C,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,QAAQ;QACrB,YAAY,EAAE,QAAQ;KACvB,CAAA;IAES,sBAAsB,CAC9B,OAAe,EACf,QAAkB,EAClB,IAAU;QAEV,OAAO,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC9C,CAAC;IAES,0BAA0B,CAAC,OAAe;QAClD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAES,sBAAsB,CAAC,MAAc;QAC7C,gEAAgE;QAChE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;QAC7D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC3B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAA"}

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

@@ -0,0 +1,92 @@
+import { QDRANT_VERSION_MAP } from './version-maps.js';
+import { buildHostdbUrl } from '../../core/hostdb-client.js';
+import { logDebug } from '../../core/error-handler.js';
+import { Engine, Platform } from '../../types/index.js';
+/**
+ * Supported platform identifiers for hostdb downloads.
+ * hostdb uses standard Node.js platform naming - this set validates
+ * that a platform/arch combination is supported, not transforms it.
+ */
+const SUPPORTED_PLATFORMS = new Set([
+    'darwin-arm64',
+    'darwin-x64',
+    'linux-arm64',
+    'linux-x64',
+    'win32-x64',
+]);
+/**
+ * Get the hostdb platform identifier
+ *
+ * hostdb uses standard platform naming that matches Node.js identifiers directly.
+ * This function validates the platform/arch combination is supported.
+ *
+ * @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_PLATFORMS.has(key) ? key : null;
+}
+/**
+ * Build the download URL for Qdrant binaries from hostdb
+ *
+ * Format: https://registry.layerbase.host/qdrant-{version}/qdrant-{version}-{platform}-{arch}.{ext}
+ *
+ * @param version - Qdrant version (e.g., '1', '1.16.3')
+ * @param platform - Platform identifier (e.g., 'darwin', 'linux', 'win32')
+ * @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) {
+        const supported = Array.from(SUPPORTED_PLATFORMS).join(', ');
+        throw new Error(`Unsupported platform: ${platformKey}. Supported platforms: ${supported}`);
+    }
+    // Normalize version (handles major version lookup and X.Y -> X.Y.Z conversion)
+    const fullVersion = normalizeVersion(version, QDRANT_VERSION_MAP);
+    const ext = platform === Platform.Win32 ? 'zip' : 'tar.gz';
+    return buildHostdbUrl(Engine.Qdrant, {
+        version: fullVersion,
+        hostdbPlatform,
+        extension: ext,
+    });
+}
+/**
+ * Normalize version string to X.Y.Z format
+ *
+ * @param version - Version string (e.g., '1', '1.16', '1.16.3')
+ * @param versionMap - Optional version map for major version lookup
+ * @returns Normalized version (e.g., '1.16.3')
+ */
+function normalizeVersion(version, versionMap = QDRANT_VERSION_MAP) {
+    // Check if it's an exact key in the map (handles "1", "1.16", etc.)
+    if (versionMap[version]) {
+        return versionMap[version];
+    }
+    const parts = version.split('.');
+    // If it's already a full version (X.Y.Z), return as-is
+    if (parts.length === 3) {
+        return version;
+    }
+    // For two-part versions (e.g., "1.16"), first try exact two-part key, then fall back to major
+    if (parts.length === 2) {
+        const twoPart = `${parts[0]}.${parts[1]}`;
+        if (versionMap[twoPart]) {
+            return versionMap[twoPart];
+        }
+        // Fall back to major version for latest patch
+        const major = parts[0];
+        const mapped = versionMap[major];
+        if (mapped) {
+            return mapped;
+        }
+    }
+    // Unknown version format - log and return as-is
+    // This may cause download failures if the version doesn't exist in hostdb
+    logDebug(`Qdrant version '${version}' not in version map, may not be available in hostdb`);
+    return version;
+}
+//# sourceMappingURL=binary-urls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-urls.js","sourceRoot":"","sources":["../../../engines/qdrant/binary-urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAa,MAAM,aAAa,CAAA;AAEzD;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,cAAc;IACd,YAAY;IACZ,aAAa;IACb,WAAW;IACX,WAAW;CACZ,CAAC,CAAA;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAkB,EAClB,IAAU;IAEV,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAA;IACjC,OAAO,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;AAClD,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,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5D,MAAM,IAAI,KAAK,CACb,yBAAyB,WAAW,0BAA0B,SAAS,EAAE,CAC1E,CAAA;IACH,CAAC;IAED,+EAA+E;IAC/E,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;IACjE,MAAM,GAAG,GAAG,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;IAE1D,OAAO,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE;QACnC,OAAO,EAAE,WAAW;QACpB,cAAc;QACd,SAAS,EAAE,GAAG;KACf,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CACvB,OAAe,EACf,aAAqC,kBAAkB;IAEvD,oEAAoE;IACpE,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAEhC,uDAAuD;IACvD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,8FAA8F;IAC9F,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;QACzC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,OAAO,UAAU,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;QACD,8CAA8C;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QACtB,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;QAChC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,0EAA0E;IAC1E,QAAQ,CACN,mBAAmB,OAAO,sDAAsD,CACjF,CAAA;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/engines/qdrant/cli-utils.js

@@ -0,0 +1,39 @@
+/**
+ * Shared Qdrant CLI utilities
+ *
+ * Provides common functions for locating Qdrant binaries,
+ * used by both backup.ts and restore.ts to avoid duplication.
+ */
+import { existsSync } from 'fs';
+import { configManager } from '../../core/config-manager.js';
+import { platformService } from '../../core/platform-service.js';
+/**
+ * Get the path to qdrant binary
+ *
+ * Lookup order:
+ * 1. configManager cache (bundled/downloaded binaries from hostdb)
+ * 2. System PATH (fallback for system-installed qdrant)
+ *
+ * @returns Path to qdrant or null if not found
+ */
+export async function getQdrantPath() {
+    // Check if we have a cached/bundled qdrant from hostdb
+    const cachedPath = await configManager.getBinaryPath('qdrant');
+    if (cachedPath && existsSync(cachedPath)) {
+        return cachedPath;
+    }
+    // Fallback to system PATH
+    return platformService.findToolPath('qdrant');
+}
+/**
+ * Error message for missing qdrant binary
+ * Directs users to download via hostdb (preferred) or system package manager (fallback)
+ */
+export const QDRANT_NOT_FOUND_ERROR = 'qdrant not found. Download Qdrant binaries:\n' +
+    '  spindb engines download qdrant\n' +
+    '\n' +
+    'Or run via Docker:\n' +
+    '  docker run -p 6333:6333 qdrant/qdrant\n' +
+    '\n' +
+    'See: https://qdrant.tech/documentation/guides/installation/';
+//# sourceMappingURL=cli-utils.js.map

package/dist/engines/qdrant/cli-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-utils.js","sourceRoot":"","sources":["../../../engines/qdrant/cli-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,uDAAuD;IACvD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC9D,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,0BAA0B;IAC1B,OAAO,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,+CAA+C;IAC/C,oCAAoC;IACpC,IAAI;IACJ,sBAAsB;IACtB,2CAA2C;IAC3C,IAAI;IACJ,6DAA6D,CAAA"}