spindb 0.37.2 → 0.38.0

package/dist/engines/valkey/backup.js

@@ -0,0 +1,292 @@
+/**
+ * Valkey backup module
+ * Supports two formats:
+ * - RDB: Binary snapshot via BGSAVE (default, compact, fast restore)
+ * - Text: Human-readable Valkey commands (.valkey file)
+ */
+import { spawn } from 'child_process';
+import { copyFile, stat, mkdir, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { logDebug, logWarning } from '../../core/error-handler.js';
+import { paths } from '../../config/paths.js';
+import { getValkeyCliPath, VALKEY_CLI_NOT_FOUND_ERROR } from './cli-utils.js';
+/**
+ * Execute a Valkey command via stdin piping
+ * This is safer than shell command construction as it handles
+ * keys/values with spaces and special characters correctly
+ */
+async function execValkeyCommand(valkeyCli, port, command) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(valkeyCli, ['-h', '127.0.0.1', '-p', String(port)], {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('error', reject);
+        proc.on('close', (code) => {
+            if (code === 0 || code === null) {
+                resolve(stdout);
+            }
+            else {
+                reject(new Error(stderr || `valkey-cli exited with code ${code}`));
+            }
+        });
+        // Write command to stdin and close
+        proc.stdin.write(command + '\n');
+        proc.stdin.end();
+    });
+}
+/**
+ * Escape a string value for Valkey command output
+ * Wraps in single quotes and escapes backslashes and single quotes
+ */
+function escapeValkeyValue(value) {
+    // Escape backslashes first, then single quotes (order matters!)
+    // e.g., "test\'value" → "test\\\'value" (backslash and quote both escaped)
+    return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+}
+/**
+ * Create a text-based backup (.valkey file)
+ * Exports all keys as Valkey commands that can be replayed
+ */
+async function createTextBackup(container, outputPath) {
+    const { port } = container;
+    const valkeyCli = await getValkeyCliPath();
+    if (!valkeyCli) {
+        throw new Error(VALKEY_CLI_NOT_FOUND_ERROR);
+    }
+    const commands = [];
+    commands.push('# Valkey backup generated by SpinDB');
+    commands.push(`# Date: ${new Date().toISOString()}`);
+    commands.push('');
+    // Get all keys using KEYS * (for small datasets this is fine)
+    // For production with millions of keys, SCAN would be better
+    const keysOutput = await execValkeyCommand(valkeyCli, port, 'KEYS *');
+    // Use /\r?\n/ to handle both Unix (\n) and Windows (\r\n) line endings
+    const keys = keysOutput
+        .trim()
+        .split(/\r?\n/)
+        .map((k) => k.trim())
+        .filter((k) => k);
+    logDebug(`Found ${keys.length} keys to backup`);
+    for (const key of keys) {
+        // Get key type - quote key to handle spaces/special chars
+        const typeOutput = await execValkeyCommand(valkeyCli, port, `TYPE "${key.replace(/"/g, '\\"')}"`);
+        const keyType = typeOutput.trim();
+        // Get TTL
+        const ttlOutput = await execValkeyCommand(valkeyCli, port, `TTL "${key.replace(/"/g, '\\"')}"`);
+        const ttl = parseInt(ttlOutput.trim(), 10);
+        // Quote the key for output commands
+        const quotedKey = key.includes(' ') || /[*?[\]{}$`"'\\!<>|;&()]/.test(key)
+            ? `"${key.replace(/"/g, '\\"')}"`
+            : key;
+        switch (keyType) {
+            case 'string': {
+                const value = await execValkeyCommand(valkeyCli, port, `GET "${key.replace(/"/g, '\\"')}"`);
+                commands.push(`SET ${quotedKey} ${escapeValkeyValue(value.trim())}`);
+                break;
+            }
+            case 'hash': {
+                const hashData = await execValkeyCommand(valkeyCli, port, `HGETALL "${key.replace(/"/g, '\\"')}"`);
+                const lines = hashData
+                    .trim()
+                    .split(/\r?\n/)
+                    .map((l) => l.trim())
+                    .filter((l) => l);
+                if (lines.length >= 2) {
+                    const pairs = [];
+                    for (let i = 0; i < lines.length; i += 2) {
+                        const field = lines[i].trim();
+                        const value = lines[i + 1]?.trim() || '';
+                        // Quote field if it contains special chars
+                        const quotedField = field.includes(' ') || /[*?[\]{}$`"'\\!<>|;&()]/.test(field)
+                            ? `"${field.replace(/"/g, '\\"')}"`
+                            : field;
+                        pairs.push(`${quotedField} ${escapeValkeyValue(value)}`);
+                    }
+                    commands.push(`HSET ${quotedKey} ${pairs.join(' ')}`);
+                }
+                break;
+            }
+            case 'list': {
+                const listData = await execValkeyCommand(valkeyCli, port, `LRANGE "${key.replace(/"/g, '\\"')}" 0 -1`);
+                const items = listData
+                    .trim()
+                    .split(/\r?\n/)
+                    .map((l) => l.trim())
+                    .filter((l) => l);
+                if (items.length > 0) {
+                    const escapedItems = items.map((item) => escapeValkeyValue(item.trim()));
+                    commands.push(`RPUSH ${quotedKey} ${escapedItems.join(' ')}`);
+                }
+                break;
+            }
+            case 'set': {
+                const setData = await execValkeyCommand(valkeyCli, port, `SMEMBERS "${key.replace(/"/g, '\\"')}"`);
+                const members = setData
+                    .trim()
+                    .split(/\r?\n/)
+                    .map((l) => l.trim())
+                    .filter((l) => l);
+                if (members.length > 0) {
+                    const escapedMembers = members.map((m) => escapeValkeyValue(m.trim()));
+                    commands.push(`SADD ${quotedKey} ${escapedMembers.join(' ')}`);
+                }
+                break;
+            }
+            case 'zset': {
+                const zsetData = await execValkeyCommand(valkeyCli, port, `ZRANGE "${key.replace(/"/g, '\\"')}" 0 -1 WITHSCORES`);
+                const lines = zsetData
+                    .trim()
+                    .split(/\r?\n/)
+                    .map((l) => l.trim())
+                    .filter((l) => l);
+                if (lines.length >= 2) {
+                    const pairs = [];
+                    for (let i = 0; i < lines.length; i += 2) {
+                        const member = lines[i].trim();
+                        const score = lines[i + 1]?.trim() || '0';
+                        pairs.push(`${score} ${escapeValkeyValue(member)}`);
+                    }
+                    commands.push(`ZADD ${quotedKey} ${pairs.join(' ')}`);
+                }
+                break;
+            }
+            default:
+                logWarning(`Skipping key ${key} with unsupported type: ${keyType}`);
+        }
+        // Add EXPIRE if key has TTL
+        if (ttl > 0) {
+            commands.push(`EXPIRE ${quotedKey} ${ttl}`);
+        }
+    }
+    // Ensure output directory exists
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir)) {
+        await mkdir(outputDir, { recursive: true });
+    }
+    // Write commands to file
+    const content = commands.join('\n') + '\n';
+    await writeFile(outputPath, content, 'utf-8');
+    const stats = await stat(outputPath);
+    return {
+        path: outputPath,
+        format: 'text',
+        size: stats.size,
+    };
+}
+/**
+ * Create a backup using BGSAVE (RDB format)
+ *
+ * Valkey backups are RDB files (binary snapshots).
+ * The backup process:
+ * 1. Trigger BGSAVE command
+ * 2. Poll LASTSAVE until timestamp changes (backup complete)
+ * 3. Copy dump.rdb to output path
+ */
+async function createRdbBackup(container, outputPath) {
+    const { port, name } = container;
+    const valkeyCli = await getValkeyCliPath();
+    if (!valkeyCli) {
+        throw new Error(VALKEY_CLI_NOT_FOUND_ERROR);
+    }
+    // Trigger background save
+    let bgsaveResponse;
+    try {
+        bgsaveResponse = await execValkeyCommand(valkeyCli, port, 'BGSAVE');
+        bgsaveResponse = bgsaveResponse.trim();
+    }
+    catch (error) {
+        const execError = error;
+        throw new Error(`BGSAVE command failed: ${execError.message}`);
+    }
+    logDebug(`BGSAVE response: ${bgsaveResponse}`);
+    // Check for Valkey error responses in stdout
+    // Valkey returns errors like "ERR ..." or "(error) ..." in stdout
+    if (bgsaveResponse.startsWith('ERR') ||
+        bgsaveResponse.startsWith('(error)')) {
+        // Special case: if a save is already in progress, we can wait for it
+        if (bgsaveResponse.includes('Background save already in progress')) {
+            logDebug('BGSAVE already in progress, waiting for it to complete');
+        }
+        else {
+            throw new Error(`BGSAVE failed: ${bgsaveResponse}`);
+        }
+    }
+    else if (!bgsaveResponse.includes('Background saving started') &&
+        !bgsaveResponse.includes('Background save already in progress')) {
+        // Unexpected response - warn but continue (might be a different Valkey version)
+        logDebug(`Unexpected BGSAVE response (continuing anyway): ${bgsaveResponse}`);
+    }
+    // Wait for save to complete by checking rdb_bgsave_in_progress
+    // This is more reliable than LASTSAVE timestamp which has 1-second resolution
+    const startTime = Date.now();
+    const timeout = 60000; // 1 minute timeout
+    while (Date.now() - startTime < timeout) {
+        const infoOutput = await execValkeyCommand(valkeyCli, port, 'INFO persistence');
+        // Check if BGSAVE is still in progress
+        const inProgress = infoOutput.includes('rdb_bgsave_in_progress:1');
+        if (!inProgress) {
+            // Also check for errors
+            const statusMatch = infoOutput.match(/rdb_last_bgsave_status:(\w+)/);
+            const status = statusMatch?.[1];
+            if (status === 'err') {
+                throw new Error('BGSAVE failed. Check Valkey logs for details.');
+            }
+            logDebug('BGSAVE completed successfully');
+            break;
+        }
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    if (Date.now() - startTime >= timeout) {
+        throw new Error('BGSAVE timed out after 60 seconds');
+    }
+    // Get the RDB file path from Valkey data directory
+    const dataDir = paths.getContainerDataPath(name, { engine: 'valkey' });
+    const rdbPath = join(dataDir, 'dump.rdb');
+    if (!existsSync(rdbPath)) {
+        throw new Error(`RDB file not found at ${rdbPath} after BGSAVE. Check Valkey configuration.`);
+    }
+    // Ensure output directory exists
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir)) {
+        await mkdir(outputDir, { recursive: true });
+    }
+    // Copy RDB file to output path
+    await copyFile(rdbPath, outputPath);
+    const stats = await stat(outputPath);
+    return {
+        path: outputPath,
+        format: 'rdb',
+        size: stats.size,
+    };
+}
+/**
+ * Create a backup
+ * Supports two formats:
+ * - 'text': Human-readable Valkey commands (.valkey file)
+ * - 'rdb' (default): Binary RDB snapshot
+ */
+export async function createBackup(container, outputPath, options) {
+    // 'text' format means text-based commands for Valkey
+    if (options.format === 'text') {
+        return createTextBackup(container, outputPath);
+    }
+    // Default to RDB format
+    return createRdbBackup(container, outputPath);
+}
+/**
+ * Create a backup for cloning purposes
+ * Always uses RDB format for speed and reliability
+ */
+export async function createCloneBackup(container, outputPath) {
+    return createRdbBackup(container, outputPath);
+}
+//# sourceMappingURL=backup.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * Valkey Binary Manager
+ *
+ * Handles downloading, extracting, and managing Valkey 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 ValkeyBinaryManager extends BaseBinaryManager {
+    config = {
+        engine: Engine.Valkey,
+        engineName: 'valkey',
+        displayName: 'Valkey',
+        serverBinary: 'valkey-server',
+    };
+    getBinaryUrlFromModule(version, platform, arch) {
+        return getBinaryUrl(version, platform, arch);
+    }
+    normalizeVersionFromModule(version) {
+        return normalizeVersion(version);
+    }
+    parseVersionFromOutput(stdout) {
+        // Extract version from output like "Valkey server v=8.0.6 sha=00000000:0 malloc=jemalloc-5.3.0 bits=64 build=..."
+        // or "v=8.0.6" pattern
+        const match = stdout.match(/v=(\d+\.\d+\.\d+)/);
+        const altMatch = !match ? stdout.match(/(\d+\.\d+\.\d+)/) : null;
+        return match?.[1] ?? altMatch?.[1] ?? null;
+    }
+}
+export const valkeyBinaryManager = new ValkeyBinaryManager();
+//# sourceMappingURL=binary-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-manager.js","sourceRoot":"","sources":["../../../engines/valkey/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,eAAe;KAC9B,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,kHAAkH;QAClH,uBAAuB;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QAC/C,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAChE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC5C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAA"}

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

@@ -0,0 +1,98 @@
+import { VALKEY_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 Valkey binaries from hostdb
+ *
+ * Format: https://registry.layerbase.host/valkey-{version}/valkey-{version}-{platform}-{arch}.{ext}
+ *
+ * @param version - Valkey version (e.g., '8', '8.0.6')
+ * @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, VALKEY_VERSION_MAP);
+    const ext = platform === Platform.Win32 ? 'zip' : 'tar.gz';
+    return buildHostdbUrl(Engine.Valkey, {
+        version: fullVersion,
+        hostdbPlatform,
+        extension: ext,
+    });
+}
+/**
+ * Normalize version string to X.Y.Z format
+ *
+ * @param version - Version string (e.g., '8', '8.0', '8.0.6')
+ * @param versionMap - Optional version map for major version lookup
+ * @returns Normalized version (e.g., '8.0.6')
+ */
+function normalizeVersion(version, versionMap = VALKEY_VERSION_MAP) {
+    // Check if it's an exact key in the map (handles "8", "9", "8.0", 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., "8.0"), 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(`Valkey version '${version}' not in version map, may not be available in hostdb`);
+    return version;
+}
+/**
+ * Get the full version string for a major version
+ *
+ * @param majorVersion - Major version (e.g., '8', '9')
+ * @returns Full version string (e.g., '8.0.6') or null if not supported
+ */
+//# sourceMappingURL=binary-urls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-urls.js","sourceRoot":"","sources":["../../../engines/valkey/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,wEAAwE;IACxE,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,6FAA6F;IAC7F,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;AAED;;;;;GAKG"}

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

@@ -0,0 +1,38 @@
+/**
+ * Shared Valkey CLI utilities
+ *
+ * Provides common functions for locating Valkey 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 valkey-cli binary
+ *
+ * Lookup order:
+ * 1. configManager cache (bundled/downloaded binaries from hostdb)
+ * 2. System PATH (fallback for system-installed valkey-tools)
+ *
+ * @returns Path to valkey-cli or null if not found
+ */
+export async function getValkeyCliPath() {
+    // Check if we have a cached/bundled valkey-cli from hostdb
+    const cachedPath = await configManager.getBinaryPath('valkey-cli');
+    if (cachedPath && existsSync(cachedPath)) {
+        return cachedPath;
+    }
+    // Fallback to system PATH
+    return platformService.findToolPath('valkey-cli');
+}
+/**
+ * Error message for missing valkey-cli
+ * Directs users to download via hostdb (preferred) or system package manager (fallback)
+ */
+export const VALKEY_CLI_NOT_FOUND_ERROR = 'valkey-cli not found. Download Valkey binaries:\n' +
+    '  spindb engines download valkey\n' +
+    '\n' +
+    'Or install system-wide:\n' +
+    '  macOS: brew install valkey\n' +
+    '  Ubuntu: sudo apt install valkey-tools';
+//# sourceMappingURL=cli-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-utils.js","sourceRoot":"","sources":["../../../engines/valkey/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,gBAAgB;IACpC,2DAA2D;IAC3D,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,YAAY,CAAC,CAAA;IAClE,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,0BAA0B;IAC1B,OAAO,eAAe,CAAC,YAAY,CAAC,YAAY,CAAC,CAAA;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GACrC,mDAAmD;IACnD,oCAAoC;IACpC,IAAI;IACJ,2BAA2B;IAC3B,gCAAgC;IAChC,yCAAyC,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostdb-releases.js","sourceRoot":"","sources":["../../../engines/valkey/hostdb-releases.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,cAAc,GAAG,oBAAoB,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,kBAAkB;IAC9B,sBAAsB,EAAE,wBAAwB;IAChD,gBAAgB,EAAE,cAAc;IAChC,aAAa,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,aAAa,EAAE;CACzD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,CAAA;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC,gBAAgB,CAAA"}