spindb 0.37.2 → 0.38.0

package/dist/engines/weaviate/api-client.js

@@ -0,0 +1,50 @@
+/**
+ * Shared Weaviate REST API client utilities
+ */
+/**
+ * Make an HTTP request to Weaviate REST API
+ *
+ * @param port - The HTTP port Weaviate is listening on
+ * @param method - HTTP method (GET, POST, PUT, DELETE)
+ * @param path - API path (e.g., '/v1/schema', '/v1/.well-known/ready')
+ * @param body - Optional JSON body for POST/PUT requests
+ * @param timeoutMs - Request timeout in milliseconds (default: 30s)
+ */
+export async function weaviateApiRequest(port, method, path, body, timeoutMs = 30000) {
+    const url = `http://127.0.0.1:${port}${path}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    const options = {
+        method,
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        signal: controller.signal,
+    };
+    if (body) {
+        options.body = JSON.stringify(body);
+    }
+    try {
+        const response = await fetch(url, options);
+        // Try to parse as JSON, fall back to text for endpoints like /v1/.well-known/ready
+        let data;
+        const contentType = response.headers.get('content-type') || '';
+        if (contentType.includes('application/json')) {
+            data = await response.json();
+        }
+        else {
+            data = await response.text();
+        }
+        return { status: response.status, data };
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error(`Weaviate API request timed out after ${timeoutMs / 1000}s: ${method} ${path}`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/engines/weaviate/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../engines/weaviate/api-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,MAAc,EACd,IAAY,EACZ,IAA8B,EAC9B,SAAS,GAAG,KAAK;IAEjB,MAAM,GAAG,GAAG,oBAAoB,IAAI,GAAG,IAAI,EAAE,CAAA;IAE7C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAA;IAEjE,MAAM,OAAO,GAAgB;QAC3B,MAAM;QACN,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;SACnC;QACD,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAA;IAED,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAE1C,mFAAmF;QACnF,IAAI,IAAa,CAAA;QACjB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;QAC9D,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7C,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAA;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,wCAAwC,SAAS,GAAG,IAAI,MAAM,MAAM,IAAI,IAAI,EAAE,CAC/E,CAAA;QACH,CAAC;QACD,MAAM,KAAK,CAAA;IACb,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAA;IACzB,CAAC;AACH,CAAC"}

package/dist/engines/weaviate/backup.js

@@ -0,0 +1,95 @@
+/**
+ * Weaviate backup module
+ * Supports snapshot-based backup using Weaviate's filesystem backup API.
+ *
+ * Weaviate's filesystem backup creates a directory at BACKUP_FILESYSTEM_PATH/<id>/
+ * containing backup metadata and class data. We copy this entire directory
+ * as the "snapshot" for backup/restore.
+ */
+import { mkdir, stat, cp, readdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { logDebug } from '../../core/error-handler.js';
+import { paths } from '../../config/paths.js';
+import { weaviateApiRequest } from './api-client.js';
+/**
+ * Create a snapshot backup using Weaviate's REST API.
+ * Triggers a filesystem backup, polls for completion, then copies the
+ * backup directory to the output path.
+ */
+export async function createBackup(container, outputPath, _options) {
+    const { port, name } = container;
+    // Ensure output parent directory exists
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir)) {
+        await mkdir(outputDir, { recursive: true });
+    }
+    // Generate a unique backup ID
+    const backupId = `spindb-backup-${Date.now()}`;
+    // Trigger backup creation via REST API
+    logDebug(`Creating Weaviate backup '${backupId}' via REST API on port ${port}`);
+    const response = await weaviateApiRequest(port, 'POST', '/v1/backups/filesystem', { id: backupId }, 600000);
+    if (response.status !== 200) {
+        throw new Error(`Failed to create Weaviate backup: ${JSON.stringify(response.data)}`);
+    }
+    logDebug(`Weaviate backup initiated: ${backupId}`);
+    // Poll for backup completion
+    const maxWait = 300000; // 5 minutes
+    const startTime = Date.now();
+    let backupCompleted = false;
+    while (Date.now() - startTime < maxWait) {
+        const statusResponse = await weaviateApiRequest(port, 'GET', `/v1/backups/filesystem/${backupId}`);
+        if (statusResponse.status === 200) {
+            const statusData = statusResponse.data;
+            if (statusData.status === 'SUCCESS') {
+                logDebug(`Weaviate backup completed: ${backupId}`);
+                backupCompleted = true;
+                break;
+            }
+            if (statusData.status === 'FAILED') {
+                throw new Error(`Weaviate backup failed: ${JSON.stringify(statusData)}`);
+            }
+            logDebug(`Backup status: ${statusData.status}, waiting...`);
+        }
+        await new Promise((r) => setTimeout(r, 1000));
+    }
+    if (!backupCompleted) {
+        throw new Error(`Weaviate backup '${backupId}' timed out after ${maxWait / 1000}s without completing`);
+    }
+    // Weaviate stores backup at BACKUP_FILESYSTEM_PATH/<backupId>/
+    // BACKUP_FILESYSTEM_PATH is set to <dataDir>/backups in start()
+    const dataDir = paths.getContainerDataPath(name, { engine: 'weaviate' });
+    const backupDir = join(dataDir, 'backups', backupId);
+    if (!existsSync(backupDir)) {
+        throw new Error(`Weaviate backup directory not found at ${backupDir} after completion`);
+    }
+    // Copy entire backup directory to output path
+    await cp(backupDir, outputPath, { recursive: true });
+    // Get total size of backup directory
+    const files = await readdir(backupDir, { recursive: true });
+    let totalSize = 0;
+    for (const file of files) {
+        try {
+            const filePath = join(backupDir, String(file));
+            const stats = await stat(filePath);
+            if (stats.isFile()) {
+                totalSize += stats.size;
+            }
+        }
+        catch {
+            // Skip inaccessible files
+        }
+    }
+    return {
+        path: outputPath,
+        format: 'snapshot',
+        size: totalSize,
+    };
+}
+/**
+ * Create a backup for cloning purposes
+ */
+export async function createCloneBackup(container, outputPath) {
+    return createBackup(container, outputPath, { database: 'default' });
+}
+//# sourceMappingURL=backup.js.map

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

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

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

@@ -0,0 +1,58 @@
+/**
+ * Weaviate Binary Manager
+ *
+ * Handles downloading, extracting, and managing Weaviate binaries from hostdb.
+ * Extends BaseBinaryManager for shared download/extraction logic.
+ *
+ * Note: Weaviate doesn't support --version flag (as of v1.35.x). We override
+ * verify() to just check binary existence instead of running it.
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { BaseBinaryManager, } from '../../core/base-binary-manager.js';
+import { getBinaryUrl } from './binary-urls.js';
+import { normalizeVersion } from './version-maps.js';
+import { Engine, Platform } from '../../types/index.js';
+import { paths } from '../../config/paths.js';
+class WeaviateBinaryManager extends BaseBinaryManager {
+    config = {
+        engine: Engine.Weaviate,
+        engineName: 'weaviate',
+        displayName: 'Weaviate',
+        serverBinary: 'weaviate',
+    };
+    getBinaryUrlFromModule(version, platform, arch) {
+        return getBinaryUrl(version, platform, arch);
+    }
+    normalizeVersionFromModule(version) {
+        return normalizeVersion(version);
+    }
+    parseVersionFromOutput(stdout) {
+        // Extract version from output like "weaviate v1.35.7" or "1.35.7"
+        const match = stdout.match(/(?:weaviate\s+)?v?(\d+\.\d+\.\d+)/);
+        return match?.[1] ?? null;
+    }
+    /**
+     * Override verify to just check binary existence.
+     * Weaviate doesn't support --version flag (as of v1.35.x).
+     * See: https://github.com/weaviate/weaviate/issues/6571
+     */
+    async verify(version, platform, arch) {
+        const fullVersion = this.getFullVersion(version);
+        const binPath = paths.getBinaryPath({
+            engine: this.config.engineName,
+            version: fullVersion,
+            platform,
+            arch,
+        });
+        const ext = platform === Platform.Win32 ? '.exe' : '';
+        const serverPath = join(binPath, 'bin', `${this.config.serverBinary}${ext}`);
+        if (!existsSync(serverPath)) {
+            throw new Error(`${this.config.displayName} binary not found at ${binPath}/bin/`);
+        }
+        // Just verify the binary exists - we can't run --version on Weaviate
+        return true;
+    }
+}
+export const weaviateBinaryManager = new WeaviateBinaryManager();
+//# sourceMappingURL=binary-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-manager.js","sourceRoot":"","sources":["../../../engines/weaviate/binary-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,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,EAAE,QAAQ,EAAa,MAAM,aAAa,CAAA;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,qBAAsB,SAAQ,iBAAiB;IAChC,MAAM,GAAwB;QAC/C,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,UAAU;KACzB,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,kEAAkE;QAClE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAA;QAC/D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,QAAkB,EAClB,IAAU;QAEV,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;QAChD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC;YAClC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAC9B,OAAO,EAAE,WAAW;YACpB,QAAQ;YACR,IAAI;SACL,CAAC,CAAA;QAEF,MAAM,GAAG,GAAG,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QACrD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC,CAAA;QAE5E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,wBAAwB,OAAO,OAAO,CACjE,CAAA;QACH,CAAC;QAED,qEAAqE;QACrE,OAAO,IAAI,CAAA;IACb,CAAC;CACF;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAA"}

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

@@ -0,0 +1,92 @@
+import { WEAVIATE_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 Weaviate binaries from hostdb
+ *
+ * Format: https://registry.layerbase.host/weaviate-{version}/weaviate-{version}-{platform}-{arch}.{ext}
+ *
+ * @param version - Weaviate version (e.g., '1', '1.35.7')
+ * @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, WEAVIATE_VERSION_MAP);
+    const ext = platform === Platform.Win32 ? 'zip' : 'tar.gz';
+    return buildHostdbUrl(Engine.Weaviate, {
+        version: fullVersion,
+        hostdbPlatform,
+        extension: ext,
+    });
+}
+/**
+ * Normalize version string to X.Y.Z format
+ *
+ * @param version - Version string (e.g., '1', '1.35', '1.35.7')
+ * @param versionMap - Optional version map for major version lookup
+ * @returns Normalized version (e.g., '1.35.7')
+ */
+function normalizeVersion(version, versionMap = WEAVIATE_VERSION_MAP) {
+    // Check if it's an exact key in the map (handles "1", "1.35", 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., "1.35"), 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(`Weaviate version '${version}' not in version map, may not be available in hostdb`);
+    return version;
+}
+//# sourceMappingURL=binary-urls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-urls.js","sourceRoot":"","sources":["../../../engines/weaviate/binary-urls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AACrD,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,oBAAoB,CAAC,CAAA;IACnE,MAAM,GAAG,GAAG,QAAQ,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAA;IAE1D,OAAO,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE;QACrC,OAAO,EAAE,WAAW;QACpB,cAAc;QACd,SAAS,EAAE,GAAG;KACf,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CACvB,OAAe,EACf,aAAqC,oBAAoB;IAEzD,oEAAoE;IACpE,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,8FAA8F;IAC9F,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,qBAAqB,OAAO,sDAAsD,CACnF,CAAA;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Shared Weaviate CLI utilities
+ *
+ * Provides common functions for locating Weaviate 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 weaviate binary
+ *
+ * Lookup order:
+ * 1. configManager cache (bundled/downloaded binaries from hostdb)
+ * 2. System PATH (fallback for system-installed weaviate)
+ *
+ * @returns Path to weaviate or null if not found
+ */
+export async function getWeaviatePath() {
+    // Check if we have a cached/bundled weaviate from hostdb
+    const cachedPath = await configManager.getBinaryPath('weaviate');
+    if (cachedPath && existsSync(cachedPath)) {
+        return cachedPath;
+    }
+    // Fallback to system PATH
+    return platformService.findToolPath('weaviate');
+}
+/**
+ * Error message for missing weaviate binary
+ * Directs users to download via hostdb (preferred) or system package manager (fallback)
+ */
+export const WEAVIATE_NOT_FOUND_ERROR = 'weaviate not found. Download Weaviate binaries:\n' +
+    '  spindb engines download weaviate\n' +
+    '\n' +
+    'Or run via Docker:\n' +
+    '  docker run -p 8080:8080 semitechnologies/weaviate\n' +
+    '\n' +
+    'See: https://weaviate.io/developers/weaviate/installation';
+//# sourceMappingURL=cli-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-utils.js","sourceRoot":"","sources":["../../../engines/weaviate/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,eAAe;IACnC,yDAAyD;IACzD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;IAChE,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAA;IACnB,CAAC;IAED,0BAA0B;IAC1B,OAAO,eAAe,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,mDAAmD;IACnD,sCAAsC;IACtC,IAAI;IACJ,sBAAsB;IACtB,uDAAuD;IACvD,IAAI;IACJ,2DAA2D,CAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hostdb-releases.js","sourceRoot":"","sources":["../../../engines/weaviate/hostdb-releases.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,MAAM,cAAc,GAAG,oBAAoB,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC,QAAQ;IACvB,WAAW,EAAE,UAAU;IACvB,UAAU,EAAE,oBAAoB;IAChC,sBAAsB,EAAE,wBAAwB;IAChD,gBAAgB,EAAE,cAAc;IAChC,aAAa,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,aAAa,EAAE;CAC3D,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAAC,sBAAsB,CAAA;AAC3E,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC,gBAAgB,CAAA"}