spindb 0.44.1 → 0.45.1

package/dist/engines/libsql/backup.js

@@ -0,0 +1,151 @@
+/**
+ * libSQL backup module
+ * Supports binary (file copy) and SQL dump backup formats
+ */
+import { mkdir, stat, cp } from 'fs/promises';
+import { existsSync, statSync } from 'fs';
+import { join, dirname } 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';
+import { writeFile } from 'fs/promises';
+/**
+ * Create a backup of a libSQL database
+ */
+export async function createBackup(container, outputPath, options) {
+    const format = (options.format || 'binary');
+    // Ensure output directory exists
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir)) {
+        await mkdir(outputDir, { recursive: true });
+    }
+    if (format === 'binary') {
+        return createBinaryBackup(container, outputPath);
+    }
+    return createSqlBackup(container, outputPath);
+}
+/**
+ * Create a binary backup by copying the database directory.
+ * sqld's --db-path creates a directory tree (data.db/dbs/default/data is the
+ * actual SQLite file, plus WAL, metastore, etc.). We copy the whole directory
+ * to preserve all state needed for a clean restore.
+ */
+async function createBinaryBackup(container, outputPath) {
+    const containerDir = paths.getContainerPath(container.name, {
+        engine: 'libsql',
+    });
+    const dbDir = join(containerDir, 'data', 'data.db');
+    if (!existsSync(dbDir)) {
+        throw new Error(`Database directory not found: ${dbDir}. Is the container initialized?`);
+    }
+    logDebug(`Creating binary backup of libSQL database: ${dbDir}`);
+    // Copy the entire data.db directory tree
+    await cp(dbDir, outputPath, { recursive: true });
+    // Calculate total size of the backup
+    let totalSize = 0;
+    const isDir = statSync(outputPath).isDirectory();
+    if (isDir) {
+        const { readdir } = await import('fs/promises');
+        async function sumDir(dir) {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    await sumDir(fullPath);
+                }
+                else {
+                    totalSize += (await stat(fullPath)).size;
+                }
+            }
+        }
+        await sumDir(outputPath);
+    }
+    else {
+        totalSize = (await stat(outputPath)).size;
+    }
+    return {
+        path: outputPath,
+        format: 'binary',
+        size: totalSize,
+    };
+}
+/**
+ * Create a SQL dump backup via the HTTP API
+ */
+async function createSqlBackup(container, outputPath) {
+    const { port, name } = container;
+    logDebug(`Creating SQL backup of libSQL database via HTTP API on port ${port}`);
+    // Load auth token if credentials are stored
+    const username = getDefaultUsername(Engine.LibSQL);
+    const creds = await loadCredentials(name, Engine.LibSQL, username);
+    const authToken = creds?.apiKey ?? undefined;
+    // Get all table names
+    const tablesResult = await libsqlQuery(port, "SELECT name, sql FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' AND name NOT LIKE '_litestream_%' ORDER BY name", { authToken });
+    const lines = [
+        '-- libSQL SQL dump',
+        `-- Server port: ${port}`,
+        `-- Date: ${new Date().toISOString()}`,
+        '',
+        'BEGIN TRANSACTION;',
+        '',
+    ];
+    for (const row of tablesResult.rows) {
+        const tableName = String(row[0]?.type === 'text' ? row[0].value : row[0]);
+        const createSql = String(row[1]?.type === 'text' ? row[1].value : row[1]);
+        const escapedName = tableName.replace(/"/g, '""');
+        lines.push(`${createSql};`);
+        lines.push('');
+        // Dump all rows
+        const dataResult = await libsqlQuery(port, `SELECT * FROM "${escapedName}"`, { authToken });
+        for (const dataRow of dataResult.rows) {
+            const values = dataRow.map((val) => {
+                if (val.type === 'null')
+                    return 'NULL';
+                if (val.type === 'integer')
+                    return val.value;
+                if (val.type === 'float')
+                    return String(val.value);
+                if (val.type === 'text')
+                    return `'${String(val.value).replace(/'/g, "''")}'`;
+                if (val.type === 'blob')
+                    return `X'${Buffer.from(val.base64, 'base64').toString('hex')}'`;
+                return 'NULL';
+            });
+            const columns = dataResult.cols.map((c) => `"${c.name.replace(/"/g, '""')}"`);
+            lines.push(`INSERT INTO "${escapedName}" (${columns.join(', ')}) VALUES (${values.join(', ')});`);
+        }
+        lines.push('');
+    }
+    // Get indexes
+    const indexResult = await libsqlQuery(port, "SELECT sql FROM sqlite_master WHERE type='index' AND sql IS NOT NULL ORDER BY name", { authToken });
+    for (const row of indexResult.rows) {
+        const sql = String(row[0]?.type === 'text' ? row[0].value : row[0]);
+        lines.push(`${sql};`);
+    }
+    // Get views
+    const viewResult = await libsqlQuery(port, "SELECT sql FROM sqlite_master WHERE type='view' ORDER BY name", { authToken });
+    for (const row of viewResult.rows) {
+        const sql = String(row[0]?.type === 'text' ? row[0].value : row[0]);
+        lines.push(`${sql};`);
+    }
+    // Get triggers
+    const triggerResult = await libsqlQuery(port, "SELECT sql FROM sqlite_master WHERE type='trigger' ORDER BY name", { authToken });
+    for (const row of triggerResult.rows) {
+        const sql = String(row[0]?.type === 'text' ? row[0].value : row[0]);
+        lines.push(`${sql};`);
+    }
+    lines.push('');
+    lines.push('COMMIT;');
+    lines.push('');
+    const content = lines.join('\n');
+    await writeFile(outputPath, content, 'utf-8');
+    const stats = await stat(outputPath);
+    return {
+        path: outputPath,
+        format: 'sql',
+        size: stats.size,
+    };
+}
+//# sourceMappingURL=backup.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * libSQL Binary Manager
+ *
+ * Handles downloading, extracting, and managing libSQL (sqld) 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 LibSQLBinaryManager extends BaseBinaryManager {
+    config = {
+        engine: Engine.LibSQL,
+        engineName: 'libsql',
+        displayName: 'libSQL',
+        serverBinary: 'sqld',
+    };
+    getBinaryUrlFromModule(version, platform, arch) {
+        return getBinaryUrl(version, platform, arch);
+    }
+    normalizeVersionFromModule(version) {
+        return normalizeVersion(version);
+    }
+    parseVersionFromOutput(stdout) {
+        // Extract version from output like "sqld 0.24.32" or "v0.24.32"
+        const match = stdout.match(/(?:sqld\s+)?v?(\d+\.\d+\.\d+)/);
+        return match?.[1] ?? null;
+    }
+}
+export const libsqlBinaryManager = new LibSQLBinaryManager();
+//# sourceMappingURL=binary-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-manager.js","sourceRoot":"","sources":["../../../engines/libsql/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,MAAM;KACrB,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,+BAA+B,CAAC,CAAA;QAC3D,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/libsql/binary-urls.js

@@ -0,0 +1,50 @@
+import { normalizeVersion } from './version-maps.js';
+import { buildHostdbUrl } from '../../core/hostdb-client.js';
+import { Engine } from '../../types/index.js';
+/**
+ * Supported platform identifiers for hostdb downloads.
+ * libSQL (sqld) does not have Windows binaries.
+ */
+const SUPPORTED_PLATFORMS = new Set([
+    'darwin-arm64',
+    'darwin-x64',
+    'linux-arm64',
+    'linux-x64',
+]);
+/**
+ * Get the hostdb platform identifier
+ *
+ * @param platform - Node.js platform (e.g., 'darwin', 'linux')
+ * @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 libSQL binaries from hostdb
+ *
+ * Format: https://registry.layerbase.host/libsql-{version}/libsql-{version}-{platform}-{arch}.tar.gz
+ *
+ * @param version - libSQL version (e.g., '0.24', '0.24.32')
+ * @param platform - Platform identifier (e.g., 'darwin', 'linux')
+ * @param arch - Architecture identifier (e.g., 'arm64', 'x64')
+ * @returns Download URL for the binary
+ */
+export function getBinaryUrl(version, platform, arch) {
+    const platformKey = `${platform}-${arch}`;
+    const hostdbPlatform = getHostdbPlatform(platform, arch);
+    if (!hostdbPlatform) {
+        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);
+    return buildHostdbUrl(Engine.LibSQL, {
+        version: fullVersion,
+        hostdbPlatform,
+        extension: 'tar.gz',
+    });
+}
+//# sourceMappingURL=binary-urls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-urls.js","sourceRoot":"","sources":["../../../engines/libsql/binary-urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,MAAM,EAA4B,MAAM,aAAa,CAAA;AAE9D;;;GAGG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,cAAc;IACd,YAAY;IACZ,aAAa;IACb,WAAW;CACZ,CAAC,CAAA;AAEF;;;;;;GAMG;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,CAAC,CAAA;IAE7C,OAAO,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE;QACnC,OAAO,EAAE,WAAW;QACpB,cAAc;QACd,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAA;AACJ,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostdb-releases.js","sourceRoot":"","sources":["../../../engines/libsql/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,WAAW;IAC7B,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"}