spindb 0.37.2 → 0.38.0

package/dist/core/query-parser.js

@@ -0,0 +1,449 @@
+/**
+ * Query result parsing utilities
+ * Converts various output formats (CSV, JSON, tab-separated) into QueryResult
+ */
+/**
+ * Parse CSV output into QueryResult
+ * Handles quoted fields and escaped quotes
+ */
+export function parseCSVToQueryResult(csv) {
+    const lines = csv.trim().split(/\r?\n/);
+    if (lines.length === 0 || (lines.length === 1 && !lines[0].trim())) {
+        return { columns: [], rows: [], rowCount: 0 };
+    }
+    // Parse header row
+    const columns = parseCSVLine(lines[0]);
+    // Parse data rows
+    const rows = [];
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line.trim())
+            continue;
+        const values = parseCSVLine(line);
+        const row = {};
+        for (let j = 0; j < columns.length; j++) {
+            row[columns[j]] = parseValue(values[j]);
+        }
+        rows.push(row);
+    }
+    return {
+        columns,
+        rows,
+        rowCount: rows.length,
+    };
+}
+/**
+ * Parse a single CSV line, handling quoted fields
+ */
+function parseCSVLine(line) {
+    const result = [];
+    let current = '';
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const char = line[i];
+        const nextChar = line[i + 1];
+        if (inQuotes) {
+            if (char === '"') {
+                if (nextChar === '"') {
+                    // Escaped quote
+                    current += '"';
+                    i++;
+                }
+                else {
+                    // End of quoted field
+                    inQuotes = false;
+                }
+            }
+            else {
+                current += char;
+            }
+        }
+        else {
+            if (char === '"') {
+                inQuotes = true;
+            }
+            else if (char === ',') {
+                result.push(current);
+                current = '';
+            }
+            else {
+                current += char;
+            }
+        }
+    }
+    result.push(current);
+    return result;
+}
+/**
+ * Parse tab-separated output into QueryResult (MySQL, MariaDB with -B flag)
+ */
+export function parseTSVToQueryResult(tsv) {
+    const lines = tsv.trim().split(/\r?\n/);
+    if (lines.length === 0 || (lines.length === 1 && !lines[0].trim())) {
+        return { columns: [], rows: [], rowCount: 0 };
+    }
+    // Parse header row
+    const columns = lines[0].split('\t');
+    // Parse data rows
+    const rows = [];
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line.trim())
+            continue;
+        const values = line.split('\t');
+        const row = {};
+        for (let j = 0; j < columns.length; j++) {
+            row[columns[j]] = parseValue(values[j]);
+        }
+        rows.push(row);
+    }
+    return {
+        columns,
+        rows,
+        rowCount: rows.length,
+    };
+}
+/**
+ * Parse JSON output into QueryResult (ClickHouse, SurrealDB, MongoDB)
+ */
+export function parseJSONToQueryResult(json) {
+    const data = JSON.parse(json);
+    // Handle array of objects (most common format)
+    if (Array.isArray(data)) {
+        if (data.length === 0) {
+            return { columns: [], rows: [], rowCount: 0 };
+        }
+        // Extract columns from first row's keys
+        const firstRow = data[0];
+        const columns = Object.keys(firstRow);
+        const rows = data.map((item) => item);
+        return {
+            columns,
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    // Handle single object result
+    if (typeof data === 'object' && data !== null) {
+        const obj = data;
+        const columns = Object.keys(obj);
+        return {
+            columns,
+            rows: [obj],
+            rowCount: 1,
+        };
+    }
+    // Handle scalar result
+    return {
+        columns: ['result'],
+        rows: [{ result: data }],
+        rowCount: 1,
+    };
+}
+/**
+ * Parse ClickHouse JSON format output
+ * ClickHouse returns: { data: [...], meta: [...], rows: N, statistics: {...} }
+ */
+export function parseClickHouseJSONResult(json) {
+    const result = JSON.parse(json);
+    const columns = result.meta?.map((m) => m.name) || [];
+    const rows = (result.data || []);
+    return {
+        columns,
+        rows,
+        rowCount: result.rows ?? rows.length,
+        executionTimeMs: result.statistics?.elapsed
+            ? result.statistics.elapsed * 1000
+            : undefined,
+    };
+}
+/**
+ * Parse SurrealDB JSON result format
+ *
+ * SurrealDB v2 with --json returns: [[{...}, {...}]] (double-nested array)
+ * Legacy format: [{ result: [...], status: "OK", time: "..." }]
+ */
+export function parseSurrealDBResult(json) {
+    const parsed = JSON.parse(json);
+    // SurrealDB returns an array of statement results
+    // For single query, take the first result
+    if (!Array.isArray(parsed) || parsed.length === 0) {
+        return { columns: [], rows: [], rowCount: 0 };
+    }
+    const firstResult = parsed[0];
+    // Determine format: SurrealDB v2 returns [[...]], legacy returns [{result: [...]}]
+    let data;
+    let executionTimeMs;
+    if (Array.isArray(firstResult)) {
+        // SurrealDB v2 format: [[{...}, {...}]]
+        data = firstResult;
+    }
+    else if (typeof firstResult === 'object' &&
+        firstResult !== null &&
+        'result' in firstResult) {
+        // Legacy format: [{result: [...], status: "OK", time: "..."}]
+        const legacyResult = firstResult;
+        data = legacyResult.result || [];
+        // Parse execution time (e.g., "1.234ms" or "1.234µs" or "1.234s")
+        if (legacyResult.time) {
+            const timeMatch = legacyResult.time.match(/([\d.]+)(µs|ms|s)/);
+            if (timeMatch) {
+                const value = parseFloat(timeMatch[1]);
+                const unit = timeMatch[2];
+                if (unit === 'µs')
+                    executionTimeMs = value / 1000;
+                else if (unit === 'ms')
+                    executionTimeMs = value;
+                else if (unit === 's')
+                    executionTimeMs = value * 1000;
+            }
+        }
+    }
+    else {
+        return { columns: [], rows: [], rowCount: 0 };
+    }
+    if (!Array.isArray(data) || data.length === 0) {
+        return { columns: [], rows: [], rowCount: 0 };
+    }
+    const firstRow = data[0];
+    const columns = Object.keys(firstRow);
+    const rows = data;
+    return {
+        columns,
+        rows,
+        rowCount: rows.length,
+        executionTimeMs,
+    };
+}
+/**
+ * Parse MongoDB shell output (EJSON format from mongosh --json=relaxed)
+ */
+export function parseMongoDBResult(json) {
+    const data = JSON.parse(json);
+    // Handle cursor result (array of documents)
+    if (Array.isArray(data)) {
+        if (data.length === 0) {
+            return { columns: [], rows: [], rowCount: 0 };
+        }
+        // MongoDB documents may have different fields per document
+        // Collect all unique keys
+        const columnSet = new Set();
+        for (const doc of data) {
+            if (typeof doc === 'object' && doc !== null) {
+                for (const key of Object.keys(doc)) {
+                    columnSet.add(key);
+                }
+            }
+        }
+        const columns = Array.from(columnSet);
+        const rows = data.map((doc) => {
+            if (typeof doc === 'object' && doc !== null) {
+                return doc;
+            }
+            return { value: doc };
+        });
+        return {
+            columns,
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    // Handle single document or scalar
+    return parseJSONToQueryResult(json);
+}
+/**
+ * Parse Redis command output based on command type
+ */
+export function parseRedisResult(output, command) {
+    const trimmed = output.trim();
+    const lines = trimmed.split(/\r?\n/);
+    const upperCommand = command.trim().toUpperCase();
+    // Determine command type from first word
+    const cmdWord = upperCommand.split(/\s+/)[0];
+    // Commands that return lists (one value per line)
+    const listCommands = ['KEYS', 'SMEMBERS', 'LRANGE', 'SINTER', 'SUNION'];
+    if (listCommands.includes(cmdWord)) {
+        const rows = lines
+            .filter((line) => line.trim())
+            .map((line) => ({ value: line }));
+        return {
+            columns: ['value'],
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    // HGETALL returns alternating key/value pairs
+    if (cmdWord === 'HGETALL') {
+        const rows = [];
+        for (let i = 0; i < lines.length - 1; i += 2) {
+            rows.push({
+                key: lines[i],
+                value: lines[i + 1],
+            });
+        }
+        return {
+            columns: ['key', 'value'],
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    // ZRANGE with WITHSCORES returns alternating member/score pairs
+    if (cmdWord === 'ZRANGE' && upperCommand.includes('WITHSCORES')) {
+        const rows = [];
+        for (let i = 0; i < lines.length - 1; i += 2) {
+            rows.push({
+                member: lines[i],
+                score: parseFloat(lines[i + 1]),
+            });
+        }
+        return {
+            columns: ['member', 'score'],
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    // SCAN returns cursor then list of keys
+    if (cmdWord === 'SCAN') {
+        // First line is cursor, rest are keys
+        const keys = lines.slice(1).filter((line) => line.trim());
+        const rows = keys.map((key) => ({ value: key }));
+        return {
+            columns: ['value'],
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    // TYPE returns a single type string
+    if (cmdWord === 'TYPE') {
+        return {
+            columns: ['type'],
+            rows: [{ type: trimmed }],
+            rowCount: 1,
+        };
+    }
+    // INFO returns key:value pairs
+    if (cmdWord === 'INFO') {
+        const rows = [];
+        for (const line of lines) {
+            if (line.startsWith('#') || !line.trim())
+                continue;
+            const colonIdx = line.indexOf(':');
+            if (colonIdx > 0) {
+                rows.push({
+                    key: line.slice(0, colonIdx),
+                    value: line.slice(colonIdx + 1),
+                });
+            }
+        }
+        return {
+            columns: ['key', 'value'],
+            rows,
+            rowCount: rows.length,
+        };
+    }
+    // Default: single result value
+    return {
+        columns: ['result'],
+        rows: [{ result: trimmed }],
+        rowCount: 1,
+    };
+}
+/**
+ * Parse REST API JSON response for vector/search databases
+ */
+export function parseRESTAPIResult(json) {
+    const data = JSON.parse(json);
+    // Handle Qdrant/Meilisearch result format with 'result' wrapper
+    if (typeof data === 'object' && data !== null) {
+        const obj = data;
+        // Qdrant format: { result: {...}, status: "ok", time: 0.001 }
+        if ('result' in obj) {
+            const result = obj.result;
+            // If result is an array
+            if (Array.isArray(result)) {
+                if (result.length === 0) {
+                    return { columns: [], rows: [], rowCount: 0 };
+                }
+                const firstItem = result[0];
+                if (typeof firstItem === 'object' && firstItem !== null) {
+                    const columns = Object.keys(firstItem);
+                    return {
+                        columns,
+                        rows: result,
+                        rowCount: result.length,
+                    };
+                }
+                // Array of primitives
+                return {
+                    columns: ['value'],
+                    rows: result.map((v) => ({ value: v })),
+                    rowCount: result.length,
+                };
+            }
+            // Single object result
+            if (typeof result === 'object' && result !== null) {
+                const columns = Object.keys(result);
+                return {
+                    columns,
+                    rows: [result],
+                    rowCount: 1,
+                };
+            }
+            // Scalar result
+            return {
+                columns: ['result'],
+                rows: [{ result }],
+                rowCount: 1,
+            };
+        }
+        // Meilisearch search format: { hits: [...], query: "...", processingTimeMs: ... }
+        if ('hits' in obj && Array.isArray(obj.hits)) {
+            const hits = obj.hits;
+            if (hits.length === 0) {
+                return { columns: [], rows: [], rowCount: 0 };
+            }
+            const columns = Object.keys(hits[0]);
+            return {
+                columns,
+                rows: hits,
+                rowCount: hits.length,
+                executionTimeMs: obj.processingTimeMs,
+            };
+        }
+        // CouchDB format: { rows: [...] }
+        if ('rows' in obj && Array.isArray(obj.rows)) {
+            const rows = obj.rows;
+            if (rows.length === 0) {
+                return { columns: [], rows: [], rowCount: 0 };
+            }
+            const columns = Object.keys(rows[0]);
+            return {
+                columns,
+                rows,
+                rowCount: rows.length,
+            };
+        }
+    }
+    // Fallback to generic JSON parsing
+    return parseJSONToQueryResult(json);
+}
+/**
+ * Parse a string value into appropriate type (number, boolean, null)
+ */
+function parseValue(value) {
+    if (value === undefined || value === '')
+        return null;
+    if (value === 'NULL' || value === '\\N')
+        return null;
+    if (value === 'true' || value === 't')
+        return true;
+    if (value === 'false' || value === 'f')
+        return false;
+    // Try parsing as number
+    const num = Number(value);
+    if (!isNaN(num) && value.trim() !== '') {
+        return num;
+    }
+    return value;
+}
+//# sourceMappingURL=query-parser.js.map

package/dist/core/query-parser.js.map

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

package/dist/core/spawn-utils.js

@@ -0,0 +1,90 @@
+/**
+ * Shared spawn utilities for executing commands safely
+ *
+ * This module provides a Promise-based wrapper around child_process.spawn
+ * with proper timeout handling and error messages.
+ */
+import { spawn } from 'child_process';
+/**
+ * Execute a command using spawn with argument array (safer than shell interpolation)
+ *
+ * @param command - The command to execute
+ * @param args - Array of arguments to pass to the command
+ * @param options - Optional configuration (cwd, timeout)
+ * @returns Promise resolving to { stdout, stderr }
+ * @throws Error if command fails, times out, or cannot be executed
+ */
+export function spawnAsync(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(command, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            cwd: options?.cwd,
+            env: options?.env ? { ...process.env, ...options.env } : undefined,
+        });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        let timer;
+        // Set up timeout if specified
+        if (options?.timeout && options.timeout > 0) {
+            timer = setTimeout(() => {
+                timedOut = true;
+                proc.kill('SIGKILL');
+                reject(new Error(`Command "${command} ${args.join(' ')}" timed out after ${options.timeout}ms`));
+            }, options.timeout);
+        }
+        const cleanup = () => {
+            if (timer)
+                clearTimeout(timer);
+        };
+        proc.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('close', (code) => {
+            cleanup();
+            if (timedOut)
+                return; // Already rejected by timeout
+            if (code === 0) {
+                resolve({ stdout, stderr });
+            }
+            else {
+                reject(new Error(`Command "${command} ${args.join(' ')}" failed with code ${code}: ${stderr || stdout}`));
+            }
+        });
+        proc.on('error', (err) => {
+            cleanup();
+            if (timedOut)
+                return; // Already rejected by timeout
+            reject(new Error(`Failed to execute "${command}": ${err.message}`));
+        });
+    });
+}
+/**
+ * Escape a string for use in a PowerShell single-quoted string.
+ * PowerShell escapes single quotes by doubling them: ' becomes ''
+ */
+function escapeForPowerShell(s) {
+    return s.replace(/'/g, "''");
+}
+/**
+ * Extract a ZIP archive using PowerShell Expand-Archive (Windows)
+ *
+ * @param zipFile - Path to the ZIP file
+ * @param destDir - Destination directory for extraction
+ * @throws Error if extraction fails
+ */
+export async function extractWindowsArchive(zipFile, destDir) {
+    // Escape paths to prevent command injection via single quotes
+    // Use -LiteralPath to treat the path literally (no wildcard expansion)
+    const safeZipFile = escapeForPowerShell(zipFile);
+    const safeDestDir = escapeForPowerShell(destDir);
+    await spawnAsync('powershell', [
+        '-NoProfile',
+        '-Command',
+        `Expand-Archive -LiteralPath '${safeZipFile}' -DestinationPath '${safeDestDir}' -Force`,
+    ]);
+}
+//# sourceMappingURL=spawn-utils.js.map

package/dist/core/spawn-utils.js.map

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

package/dist/core/start-with-retry.js

@@ -0,0 +1,90 @@
+/**
+ * Start with Retry
+ *
+ * Handles port race conditions by automatically retrying with a new port
+ * when the original port becomes unavailable between check and bind.
+ */
+import { portManager } from './port-manager.js';
+import { containerManager } from './container-manager.js';
+import { logWarning, logDebug } from './error-handler.js';
+import { isPortInUseError } from './fs-error-utils.js';
+import { getEngineDefaults } from '../config/defaults.js';
+/**
+ * Start a database container with automatic port retry on conflict
+ *
+ * This handles the race condition where a port is available when checked
+ * but taken by the time the database server tries to bind to it.
+ */
+export async function startWithRetry(options) {
+    const { engine, config, maxRetries = 3, onPortChange } = options;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            logDebug(`Starting ${engine.name} (attempt ${attempt}/${maxRetries})`, {
+                containerName: config.name,
+                port: config.port,
+            });
+            await engine.start(config);
+            return {
+                success: true,
+                finalPort: config.port,
+                retriesUsed: attempt - 1,
+            };
+        }
+        catch (error) {
+            const isPortError = isPortInUseError(error);
+            logDebug(`Start attempt ${attempt} failed`, {
+                containerName: config.name,
+                port: config.port,
+                isPortError,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            if (isPortError && attempt < maxRetries) {
+                const oldPort = config.port;
+                // Find a new available port, excluding the one that just failed
+                const { port: newPort } = await portManager.findAvailablePort({
+                    portRange: getEnginePortRange(config.engine),
+                });
+                // Update config with new port
+                config.port = newPort;
+                await containerManager.updateConfig(config.name, { port: newPort });
+                // Notify caller of port change
+                if (onPortChange) {
+                    onPortChange(oldPort, newPort);
+                }
+                // Log and retry
+                logWarning(`Port ${oldPort} is in use, retrying with port ${newPort}...`);
+                continue;
+            }
+            // Not a port error or max retries exceeded
+            return {
+                success: false,
+                finalPort: config.port,
+                retriesUsed: attempt - 1,
+                error: error instanceof Error ? error : new Error(String(error)),
+            };
+        }
+    }
+    // Should never reach here, but TypeScript needs a return
+    return {
+        success: false,
+        finalPort: config.port,
+        retriesUsed: maxRetries,
+        error: new Error('Max retries exceeded'),
+    };
+}
+function getEnginePortRange(engine) {
+    const engineDefaults = getEngineDefaults(engine);
+    return engineDefaults.portRange;
+}
+// Wrapper that simplifies the common use case
+export async function startContainerWithRetry(engine, config, options) {
+    const result = await startWithRetry({
+        engine,
+        config,
+        onPortChange: options?.onPortChange,
+    });
+    if (!result.success && result.error) {
+        throw result.error;
+    }
+}
+//# sourceMappingURL=start-with-retry.js.map

package/dist/core/start-with-retry.js.map

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