spindb 0.44.1 → 0.45.1

package/dist/engines/libsql/restore.js

@@ -0,0 +1,219 @@
+/**
+ * libSQL restore module
+ * Supports binary (file copy) and SQL import restore formats
+ */
+import { existsSync } from 'fs';
+import { readFile, mkdir, cp, rm } from 'fs/promises';
+import { join } from 'path';
+import { logDebug } from '../../core/error-handler.js';
+import { paths } from '../../config/paths.js';
+import { loadCredentials, getDefaultUsername, } from '../../core/credential-manager.js';
+import { libsqlQuery } from './api-client.js';
+import { Engine, } from '../../types/index.js';
+/**
+ * Split SQL content into individual statements, respecting quoted strings
+ * and comments. Avoids breaking on semicolons inside string literals.
+ */
+function splitSqlStatements(content) {
+    const statements = [];
+    let current = '';
+    let inSingleQuote = false;
+    let inDoubleQuote = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    let i = 0;
+    while (i < content.length) {
+        const ch = content[i];
+        const next = content[i + 1];
+        if (inLineComment) {
+            if (ch === '\n') {
+                inLineComment = false;
+            }
+            i++;
+            continue;
+        }
+        if (inBlockComment) {
+            if (ch === '*' && next === '/') {
+                inBlockComment = false;
+                i += 2;
+                continue;
+            }
+            i++;
+            continue;
+        }
+        if (inSingleQuote) {
+            current += ch;
+            if (ch === "'" && next === "'") {
+                current += next;
+                i += 2;
+                continue;
+            }
+            if (ch === "'") {
+                inSingleQuote = false;
+            }
+            i++;
+            continue;
+        }
+        if (inDoubleQuote) {
+            current += ch;
+            if (ch === '"' && next === '"') {
+                current += next;
+                i += 2;
+                continue;
+            }
+            if (ch === '"') {
+                inDoubleQuote = false;
+            }
+            i++;
+            continue;
+        }
+        // Not inside any quote or comment
+        if (ch === '-' && next === '-') {
+            inLineComment = true;
+            i += 2;
+            continue;
+        }
+        if (ch === '/' && next === '*') {
+            inBlockComment = true;
+            i += 2;
+            continue;
+        }
+        if (ch === "'") {
+            inSingleQuote = true;
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch === '"') {
+            inDoubleQuote = true;
+            current += ch;
+            i++;
+            continue;
+        }
+        if (ch === ';') {
+            const trimmed = current.trim();
+            if (trimmed) {
+                statements.push(trimmed);
+            }
+            current = '';
+            i++;
+            continue;
+        }
+        current += ch;
+        i++;
+    }
+    const trimmed = current.trim();
+    if (trimmed) {
+        statements.push(trimmed);
+    }
+    return statements;
+}
+/**
+ * Detect the backup format from a file path
+ */
+export function detectBackupFormat(filePath) {
+    if (filePath.endsWith('.sql')) {
+        return {
+            format: 'sql',
+            description: 'SQL dump',
+            restoreCommand: `spindb restore <container> ${filePath}`,
+        };
+    }
+    if (filePath.endsWith('.db')) {
+        return {
+            format: 'binary',
+            description: 'Binary database copy',
+            restoreCommand: `spindb restore <container> ${filePath}`,
+        };
+    }
+    // Default to binary format for unknown extensions
+    return {
+        format: 'binary',
+        description: 'Binary database copy (assumed)',
+        restoreCommand: `spindb restore <container> ${filePath}`,
+    };
+}
+/**
+ * Restore a libSQL backup
+ */
+export async function restoreBackup(backupPath, options) {
+    if (!existsSync(backupPath)) {
+        throw new Error(`Backup file not found: ${backupPath}`);
+    }
+    const format = options.format || detectBackupFormat(backupPath).format;
+    if (format === 'sql') {
+        return restoreSqlBackup(backupPath, options);
+    }
+    return restoreBinaryBackup(backupPath, options);
+}
+/**
+ * Restore from a binary backup by copying the database directory.
+ * sqld's data.db is a directory tree, not a single file.
+ * Requires the server to be stopped.
+ */
+async function restoreBinaryBackup(backupPath, options) {
+    const dataDir = options.dataDir ||
+        join(paths.getContainerPath(options.containerName, { engine: 'libsql' }), 'data');
+    const dbPath = join(dataDir, 'data.db');
+    logDebug(`Restoring binary backup to ${dbPath}`);
+    // Ensure data directory exists
+    if (!existsSync(dataDir)) {
+        await mkdir(dataDir, { recursive: true });
+    }
+    // Remove existing data.db directory/file before restoring
+    if (existsSync(dbPath)) {
+        await rm(dbPath, { recursive: true, force: true });
+    }
+    // Copy the backup directory tree
+    await cp(backupPath, dbPath, { recursive: true });
+    return {
+        format: 'binary',
+        stdout: `Restored binary backup to ${dbPath}. Start the container to use it.`,
+    };
+}
+/**
+ * Restore from a SQL dump via the HTTP API
+ * Requires the server to be running
+ */
+async function restoreSqlBackup(backupPath, options) {
+    const port = options.port;
+    if (!port) {
+        throw new Error('SQL restore requires a running container. Start the container first, then retry.');
+    }
+    logDebug(`Restoring SQL backup via HTTP API on port ${port}`);
+    // Load auth token if credentials are stored
+    const username = getDefaultUsername(Engine.LibSQL);
+    const creds = await loadCredentials(options.containerName, Engine.LibSQL, username);
+    const authToken = creds?.apiKey ?? undefined;
+    const content = await readFile(backupPath, 'utf-8');
+    // Split into individual statements using a state machine that respects
+    // quoted strings and comments (avoids breaking on semicolons inside literals)
+    const statements = splitSqlStatements(content);
+    let executed = 0;
+    const failures = [];
+    for (const stmt of statements) {
+        // Skip transaction control statements - sqld handles transactions differently
+        if (/^(BEGIN|COMMIT|ROLLBACK)\b/i.test(stmt))
+            continue;
+        try {
+            await libsqlQuery(port, `${stmt};`, { authToken });
+            executed++;
+        }
+        catch (error) {
+            const message = error.message;
+            const preview = stmt.length > 80 ? `${stmt.slice(0, 80)}...` : stmt;
+            failures.push({ statement: preview, error: message });
+            logDebug(`Warning: statement failed during restore: ${message}`);
+        }
+    }
+    let summary = `Restored ${executed} SQL statements from backup.`;
+    if (failures.length > 0) {
+        summary += ` ${failures.length} statement(s) failed.`;
+        logDebug(`Restore failures:\n${failures.map((f) => `  ${f.statement}: ${f.error}`).join('\n')}`);
+    }
+    return {
+        format: 'sql',
+        stdout: summary,
+    };
+}
+//# sourceMappingURL=restore.js.map

package/dist/engines/libsql/restore.js.map

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

package/dist/engines/libsql/version-maps.js

@@ -0,0 +1,63 @@
+/**
+ * libSQL Version Maps
+ *
+ * TEMPORARY: This version map will be replaced by the hostdb npm package once published.
+ * Until then, manually keep this in sync with robertjbass/hostdb releases.json:
+ * https://github.com/robertjbass/hostdb/blob/main/releases.json
+ *
+ * When updating versions:
+ * 1. Check hostdb releases.json for available versions
+ * 2. Update LIBSQL_VERSION_MAP to match
+ */
+import { logDebug } from '../../core/error-handler.js';
+/**
+ * Map of major libSQL versions to their latest stable patch versions.
+ * Must match versions available in hostdb releases.json.
+ */
+export const LIBSQL_VERSION_MAP = {
+    // 1-part: major version -> latest
+    '0': '0.24.32',
+    // 2-part: major.minor -> latest patch
+    '0.24': '0.24.32',
+    // 3-part: exact version (identity mapping)
+    '0.24.32': '0.24.32',
+};
+/**
+ * Supported major libSQL versions (1-part format).
+ * Used for grouping and display purposes.
+ */
+export const SUPPORTED_MAJOR_VERSIONS = ['0'];
+/**
+ * Get the full version string for a major version.
+ *
+ * @param majorVersion - Major version (e.g., '0')
+ * @returns Full version string (e.g., '0.24.32') or null if not supported
+ */
+export function getFullVersion(majorVersion) {
+    return LIBSQL_VERSION_MAP[majorVersion] || null;
+}
+/**
+ * Normalize a version string to X.Y.Z format.
+ *
+ * @param version - Version string (e.g., '0', '0.24', '0.24.32')
+ * @returns Normalized version (e.g., '0.24.32')
+ */
+export function normalizeVersion(version) {
+    const fullVersion = LIBSQL_VERSION_MAP[version];
+    if (fullVersion) {
+        return fullVersion;
+    }
+    // Unknown version - warn and return as-is
+    const parts = version.split('.');
+    const isValidFormat = parts.length >= 1 &&
+        parts.length <= 3 &&
+        parts.every((p) => /^\d+$/.test(p));
+    if (!isValidFormat) {
+        logDebug(`libSQL version '${version}' has invalid format, may not be available in hostdb`);
+    }
+    else {
+        logDebug(`libSQL version '${version}' not in version map, may not be available in hostdb`);
+    }
+    return version;
+}
+//# sourceMappingURL=version-maps.js.map

package/dist/engines/libsql/version-maps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-maps.js","sourceRoot":"","sources":["../../../engines/libsql/version-maps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,kCAAkC;IAClC,GAAG,EAAE,SAAS;IACd,sCAAsC;IACtC,MAAM,EAAE,SAAS;IACjB,2CAA2C;IAC3C,SAAS,EAAE,SAAS;CACrB,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,CAAC,CAAA;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,OAAO,kBAAkB,CAAC,YAAY,CAAC,IAAI,IAAI,CAAA;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAA;IAC/C,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,0CAA0C;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAEhC,MAAM,aAAa,GACjB,KAAK,CAAC,MAAM,IAAI,CAAC;QACjB,KAAK,CAAC,MAAM,IAAI,CAAC;QACjB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAErC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,QAAQ,CACN,mBAAmB,OAAO,sDAAsD,CACjF,CAAA;IACH,CAAC;SAAM,CAAC;QACN,QAAQ,CACN,mBAAmB,OAAO,sDAAsD,CACjF,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

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

@@ -0,0 +1,111 @@
+/**
+ * libSQL version validation utilities
+ * Handles version parsing, comparison, and compatibility checking
+ */
+/**
+ * Parse a libSQL version string into components
+ * Handles formats like "0.24.32", "0.24", "v0.24.32"
+ */
+export function parseVersion(versionString) {
+    const cleaned = versionString.replace(/^v/, '').trim();
+    if (!cleaned)
+        return null;
+    const match = cleaned.match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?$/);
+    if (!match)
+        return null;
+    const major = Number(match[1]);
+    const minor = match[2] ? Number(match[2]) : 0;
+    const patch = match[3] ? Number(match[3]) : 0;
+    return { major, minor, patch, raw: cleaned };
+}
+/**
+ * Check if a libSQL version is supported by SpinDB
+ * Minimum supported version: 0.24.0
+ */
+export function isVersionSupported(version) {
+    const parsed = parseVersion(version);
+    if (!parsed)
+        return false;
+    // Support 0.24+
+    if (parsed.major === 0) {
+        return parsed.minor >= 24;
+    }
+    return parsed.major >= 1;
+}
+/**
+ * Get major version from full version string
+ * e.g., "0.24.32" -> "0"
+ */
+export function getMajorVersion(version) {
+    const parsed = parseVersion(version);
+    return parsed ? String(parsed.major) : version;
+}
+/**
+ * Get major.minor version from full version string
+ * e.g., "0.24.32" -> "0.24"
+ */
+export function getMajorMinorVersion(version) {
+    const parsed = parseVersion(version);
+    if (!parsed)
+        return version;
+    return `${parsed.major}.${parsed.minor}`;
+}
+/**
+ * Compare two libSQL versions
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b, null if either version cannot be parsed
+ */
+export function compareVersions(a, b) {
+    const parsedA = parseVersion(a);
+    const parsedB = parseVersion(b);
+    if (!parsedA || !parsedB) {
+        return null;
+    }
+    if (parsedA.major !== parsedB.major) {
+        return parsedA.major < parsedB.major ? -1 : 1;
+    }
+    if (parsedA.minor !== parsedB.minor) {
+        return parsedA.minor < parsedB.minor ? -1 : 1;
+    }
+    if (parsedA.patch !== parsedB.patch) {
+        return parsedA.patch < parsedB.patch ? -1 : 1;
+    }
+    return 0;
+}
+/**
+ * Check if a backup version is compatible with the restore version
+ * libSQL backups are generally compatible within major versions
+ */
+export function isVersionCompatible(backupVersion, restoreVersion) {
+    const backup = parseVersion(backupVersion);
+    const restore = parseVersion(restoreVersion);
+    if (!backup || !restore) {
+        return {
+            compatible: true,
+            warning: 'Could not parse versions, proceeding with restore',
+        };
+    }
+    // Cannot restore newer backup to older server
+    if (backup.major > restore.major) {
+        return {
+            compatible: false,
+            warning: `Cannot restore libSQL ${backupVersion} backup to ${restoreVersion} server. The backup is from a newer major version.`,
+        };
+    }
+    // Allow same major version
+    if (backup.major === restore.major) {
+        return { compatible: true };
+    }
+    // Allow upgrading from older major version (restore.major > backup.major)
+    return {
+        compatible: true,
+        warning: `Restoring libSQL ${backupVersion} backup to ${restoreVersion} server. libSQL will upgrade the data format on next save.`,
+    };
+}
+/**
+ * Validate that a version string matches supported format
+ */
+export function isValidVersionFormat(version) {
+    const parsed = parseVersion(version);
+    return parsed !== null;
+}
+//# sourceMappingURL=version-validator.js.map

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

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

package/dist/types/index.js

@@ -30,6 +30,7 @@ export var Engine;
     Engine["InfluxDB"] = "influxdb";
     Engine["Weaviate"] = "weaviate";
     Engine["TigerBeetle"] = "tigerbeetle";
+    Engine["LibSQL"] = "libsql";
 })(Engine || (Engine = {}));
 // Supported operating systems (matches Node.js process.platform)
 export var Platform;
@@ -69,6 +70,7 @@ export const ALL_ENGINES = [
     Engine.InfluxDB,
     Engine.Weaviate,
     Engine.TigerBeetle,
+    Engine.LibSQL,
 ];
 // File-based engines (no server process, data stored in user project directories)
 export const FILE_BASED_ENGINES = new Set([Engine.SQLite, Engine.DuckDB]);

package/dist/types/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spindb",
-  "version": "0.44.1",
+  "version": "0.45.1",
   "author": "Bob Bass <bob@bbass.co>",
   "license": "PolyForm-Noncommercial-1.0.0",
   "description": "Zero-config Docker-free local database containers. Create, backup, and clone a variety of popular databases.",
@@ -66,6 +66,7 @@
     "influxdb",
     "weaviate",
     "tigerbeetle",
+    "libsql",
     "layerbase",
     "docker-free",
     "tui",