spindb 0.37.2 → 0.38.0

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

@@ -0,0 +1,131 @@
+/**
+ * Shared MongoDB CLI utilities
+ *
+ * Provides common functions for locating MongoDB binaries,
+ * used by backup.ts, restore.ts, and index.ts to avoid duplication.
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { configManager } from '../../core/config-manager.js';
+import { platformService } from '../../core/platform-service.js';
+import { paths } from '../../config/paths.js';
+import { normalizeVersion } from './version-maps.js';
+/**
+ * Get the path to mongodump binary for a specific MongoDB version.
+ *
+ * Prioritizes SpinDB-managed binaries that match the container's version,
+ * falling back to system mongodump only if no matching version is found.
+ *
+ * Lookup order:
+ * 1. SpinDB-managed mongodump matching exact container version
+ * 2. SpinDB-managed mongodump matching major version
+ * 3. configManager cache (bundled/downloaded binaries from hostdb)
+ * 4. System PATH (fallback for system-installed mongodb-database-tools)
+ *
+ * @param containerVersion - Optional container's MongoDB version for version-matched lookup
+ * @returns Path to mongodump or null if not found
+ */
+export async function getMongodumpPath(containerVersion) {
+    // Try version-matched SpinDB binary if containerVersion is provided
+    if (containerVersion) {
+        const fullVersion = normalizeVersion(containerVersion);
+        const platformInfo = platformService.getPlatformInfo();
+        const ext = platformInfo.platform === 'win32' ? '.exe' : '';
+        // Try exact version match
+        const versionedBinPath = paths.getBinaryPath({
+            engine: 'mongodb',
+            version: fullVersion,
+            platform: platformInfo.platform,
+            arch: platformInfo.arch,
+        });
+        const versionedMongodump = join(versionedBinPath, 'bin', `mongodump${ext}`);
+        if (existsSync(versionedMongodump)) {
+            return versionedMongodump;
+        }
+        // Try major version match
+        const majorVersion = containerVersion.split('.')[0];
+        const installed = paths.findInstalledBinaryForMajor('mongodb', majorVersion, platformInfo.platform, platformInfo.arch);
+        if (installed) {
+            const installedMongodump = join(installed.path, 'bin', `mongodump${ext}`);
+            if (existsSync(installedMongodump)) {
+                return installedMongodump;
+            }
+        }
+    }
+    // Check if we have a cached/bundled mongodump from hostdb
+    const cachedPath = await configManager.getBinaryPath('mongodump');
+    if (cachedPath && existsSync(cachedPath)) {
+        return cachedPath;
+    }
+    // Fallback to system PATH
+    return platformService.findToolPath('mongodump');
+}
+/**
+ * Get the path to mongorestore binary for a specific MongoDB version.
+ *
+ * Prioritizes SpinDB-managed binaries that match the container's version,
+ * falling back to system mongorestore only if no matching version is found.
+ *
+ * Lookup order:
+ * 1. SpinDB-managed mongorestore matching exact container version
+ * 2. SpinDB-managed mongorestore matching major version
+ * 3. configManager cache (bundled/downloaded binaries from hostdb)
+ * 4. System PATH (fallback for system-installed mongodb-database-tools)
+ *
+ * @param containerVersion - Optional container's MongoDB version for version-matched lookup
+ * @returns Path to mongorestore or null if not found
+ */
+export async function getMongorestorePath(containerVersion) {
+    // Try version-matched SpinDB binary if containerVersion is provided
+    if (containerVersion) {
+        const fullVersion = normalizeVersion(containerVersion);
+        const platformInfo = platformService.getPlatformInfo();
+        const ext = platformInfo.platform === 'win32' ? '.exe' : '';
+        // Try exact version match
+        const versionedBinPath = paths.getBinaryPath({
+            engine: 'mongodb',
+            version: fullVersion,
+            platform: platformInfo.platform,
+            arch: platformInfo.arch,
+        });
+        const versionedMongorestore = join(versionedBinPath, 'bin', `mongorestore${ext}`);
+        if (existsSync(versionedMongorestore)) {
+            return versionedMongorestore;
+        }
+        // Try major version match
+        const majorVersion = containerVersion.split('.')[0];
+        const installed = paths.findInstalledBinaryForMajor('mongodb', majorVersion, platformInfo.platform, platformInfo.arch);
+        if (installed) {
+            const installedMongorestore = join(installed.path, 'bin', `mongorestore${ext}`);
+            if (existsSync(installedMongorestore)) {
+                return installedMongorestore;
+            }
+        }
+    }
+    // Check if we have a cached/bundled mongorestore from hostdb
+    const cachedPath = await configManager.getBinaryPath('mongorestore');
+    if (cachedPath && existsSync(cachedPath)) {
+        return cachedPath;
+    }
+    // Fallback to system PATH
+    return platformService.findToolPath('mongorestore');
+}
+/**
+ * Error message for missing mongodump
+ * Directs users to download via hostdb (preferred) or MongoDB website (fallback)
+ */
+export const MONGODUMP_NOT_FOUND_ERROR = 'mongodump not found. Download MongoDB binaries:\n' +
+    '  spindb engines download mongodb\n' +
+    '\n' +
+    'Or download from:\n' +
+    '  https://www.mongodb.com/try/download/database-tools';
+/**
+ * Error message for missing mongorestore
+ * Directs users to download via hostdb (preferred) or MongoDB website (fallback)
+ */
+export const MONGORESTORE_NOT_FOUND_ERROR = 'mongorestore not found. Download MongoDB binaries:\n' +
+    '  spindb engines download mongodb\n' +
+    '\n' +
+    'Or download from:\n' +
+    '  https://www.mongodb.com/try/download/database-tools';
+//# sourceMappingURL=cli-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-utils.js","sourceRoot":"","sources":["../../../engines/mongodb/cli-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,gBAAyB;IAEzB,oEAAoE;IACpE,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,WAAW,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;QACtD,MAAM,YAAY,GAAG,eAAe,CAAC,eAAe,EAAE,CAAA;QACtD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QAE3D,0BAA0B;QAC1B,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC;YAC3C,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,IAAI,EAAE,YAAY,CAAC,IAAI;SACxB,CAAC,CAAA;QAEF,MAAM,kBAAkB,GAAG,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,YAAY,GAAG,EAAE,CAAC,CAAA;QAC3E,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACnC,OAAO,kBAAkB,CAAA;QAC3B,CAAC;QAED,0BAA0B;QAC1B,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,MAAM,SAAS,GAAG,KAAK,CAAC,2BAA2B,CACjD,SAAS,EACT,YAAY,EACZ,YAAY,CAAC,QAAQ,EACrB,YAAY,CAAC,IAAI,CAClB,CAAA;QAED,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,GAAG,EAAE,CAAC,CAAA;YACzE,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACnC,OAAO,kBAAkB,CAAA;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,WAAW,CAAC,CAAA;IACjE,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,0BAA0B;IAC1B,OAAO,eAAe,CAAC,YAAY,CAAC,WAAW,CAAC,CAAA;AAClD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,gBAAyB;IAEzB,oEAAoE;IACpE,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,WAAW,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;QACtD,MAAM,YAAY,GAAG,eAAe,CAAC,eAAe,EAAE,CAAA;QACtD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QAE3D,0BAA0B;QAC1B,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC;YAC3C,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,IAAI,EAAE,YAAY,CAAC,IAAI;SACxB,CAAC,CAAA;QAEF,MAAM,qBAAqB,GAAG,IAAI,CAChC,gBAAgB,EAChB,KAAK,EACL,eAAe,GAAG,EAAE,CACrB,CAAA;QACD,IAAI,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;YACtC,OAAO,qBAAqB,CAAA;QAC9B,CAAC;QAED,0BAA0B;QAC1B,MAAM,YAAY,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QACnD,MAAM,SAAS,GAAG,KAAK,CAAC,2BAA2B,CACjD,SAAS,EACT,YAAY,EACZ,YAAY,CAAC,QAAQ,EACrB,YAAY,CAAC,IAAI,CAClB,CAAA;QAED,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,qBAAqB,GAAG,IAAI,CAChC,SAAS,CAAC,IAAI,EACd,KAAK,EACL,eAAe,GAAG,EAAE,CACrB,CAAA;YACD,IAAI,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;gBACtC,OAAO,qBAAqB,CAAA;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;IACpE,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,0BAA0B;IAC1B,OAAO,eAAe,CAAC,YAAY,CAAC,cAAc,CAAC,CAAA;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GACpC,mDAAmD;IACnD,qCAAqC;IACrC,IAAI;IACJ,qBAAqB;IACrB,uDAAuD,CAAA;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACvC,sDAAsD;IACtD,qCAAqC;IACrC,IAAI;IACJ,qBAAqB;IACrB,uDAAuD,CAAA"}

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

@@ -0,0 +1,77 @@
+/**
+ * MongoDB hostdb releases integration
+ *
+ * Fetches available MongoDB versions from the hostdb repository at
+ * https://github.com/robertjbass/hostdb
+ *
+ * hostdb provides pre-built MongoDB binaries for multiple platforms.
+ */
+import { logDebug } from '../../core/error-handler.js';
+import { FALLBACK_VERSION_MAP } from './version-maps.js';
+import { isNewerVersion } from '../../core/version-utils.js';
+import { mongodbBinaryManager } from './binary-manager.js';
+import { getAvailableVersions as getHostdbVersions } from '../../core/hostdb-metadata.js';
+import { Engine } from '../../types/index.js';
+/**
+ * Fetch available MongoDB versions from hostdb databases.json
+ * Falls back to locally installed versions, then hardcoded version map
+ */
+export async function fetchAvailableVersions() {
+    // Try to fetch from hostdb databases.json (authoritative source)
+    try {
+        const versions = await getHostdbVersions(Engine.MongoDB);
+        if (versions && versions.length > 0) {
+            const versionMap = {};
+            // Iterate over version strings (e.g., "7.0.28", "8.0.17", "8.2.3")
+            for (const fullVersion of versions) {
+                // Extract major.minor (e.g., "7.0.28" -> "7.0")
+                const parts = fullVersion.split('.');
+                if (parts.length >= 2) {
+                    const majorMinor = `${parts[0]}.${parts[1]}`;
+                    // Keep the latest full version for each major.minor
+                    if (!versionMap[majorMinor] ||
+                        isNewerVersion(fullVersion, versionMap[majorMinor])) {
+                        versionMap[majorMinor] = fullVersion;
+                    }
+                }
+            }
+            logDebug('Fetched MongoDB versions from hostdb', { versions: versionMap });
+            return versionMap;
+        }
+    }
+    catch (error) {
+        logDebug('Failed to fetch MongoDB versions from hostdb, checking local', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    // Offline fallback: return only locally installed versions
+    const installed = await mongodbBinaryManager.listInstalled();
+    if (installed.length > 0) {
+        const versionMap = {};
+        for (const binary of installed) {
+            // MongoDB uses X.Y format for major versions
+            const parts = binary.version.split('.');
+            if (parts.length >= 2) {
+                const majorMinor = `${parts[0]}.${parts[1]}`;
+                // Keep the latest full version for each major.minor
+                if (!versionMap[majorMinor] ||
+                    isNewerVersion(binary.version, versionMap[majorMinor])) {
+                    versionMap[majorMinor] = binary.version;
+                }
+            }
+        }
+        logDebug('Using locally installed MongoDB versions', {
+            versions: versionMap,
+        });
+        return versionMap;
+    }
+    // Last resort: return hardcoded version map
+    logDebug('Using fallback MongoDB version map');
+    return FALLBACK_VERSION_MAP;
+}
+// Get the latest full version for a major.minor version
+export async function getLatestVersion(majorMinor) {
+    const versions = await fetchAvailableVersions();
+    return versions[majorMinor] || null;
+}
+//# sourceMappingURL=hostdb-releases.js.map

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

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