spindb 0.37.2 → 0.38.0

package/dist/engines/file-based-utils.js

@@ -0,0 +1,184 @@
+/**
+ * Centralized utilities for file-based engines (SQLite, DuckDB)
+ *
+ * This module is the single source of truth for:
+ * - Extension → engine mapping
+ * - Engine → valid extensions
+ * - Engine → registry
+ * - Container name derivation from filenames
+ * - Scanning for unregistered files
+ *
+ * All file-based engine behavior should go through this module
+ * so that adding a new file-based engine only requires changes here.
+ */
+import { readdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { resolve, extname } from 'path';
+import { Engine, isFileBasedEngine } from '../types/index.js';
+import { sqliteRegistry } from './sqlite/registry.js';
+import { duckdbRegistry } from './duckdb/registry.js';
+// ============================================================
+// Extension Mapping
+// ============================================================
+/**
+ * Map of file extensions to their corresponding file-based engine.
+ * This is the single source of truth for extension → engine detection.
+ */
+const EXTENSION_TO_ENGINE = {
+    '.sqlite': Engine.SQLite,
+    '.sqlite3': Engine.SQLite,
+    '.db': Engine.SQLite,
+    '.duckdb': Engine.DuckDB,
+    '.ddb': Engine.DuckDB,
+};
+/**
+ * Valid extensions per engine, derived from the extension map.
+ * Used for validation (e.g., ensuring a SQLite container only relocates to a SQLite extension).
+ */
+const ENGINE_EXTENSIONS = {
+    [Engine.SQLite]: ['.sqlite', '.sqlite3', '.db'],
+    [Engine.DuckDB]: ['.duckdb', '.ddb'],
+};
+/**
+ * Extension regex per engine (for stripping extensions from filenames).
+ */
+const ENGINE_EXTENSION_REGEX = {
+    [Engine.SQLite]: /\.(sqlite3?|db)$/i,
+    [Engine.DuckDB]: /\.(duckdb|ddb)$/i,
+};
+/**
+ * Combined regex matching any file-based engine extension.
+ */
+export const FILE_BASED_EXTENSION_REGEX = /\.(sqlite3?|db|duckdb|ddb)$/i;
+/**
+ * Detect which file-based engine a file belongs to based on its extension.
+ * Returns null if the extension is not recognized as a file-based database.
+ */
+export function detectEngineFromPath(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return EXTENSION_TO_ENGINE[ext] ?? null;
+}
+/**
+ * Get the valid file extensions for a file-based engine.
+ */
+export function getExtensionsForEngine(engine) {
+    return ENGINE_EXTENSIONS[engine];
+}
+/**
+ * Get all valid file-based database extensions.
+ */
+export function getAllFileBasedExtensions() {
+    return Object.keys(EXTENSION_TO_ENGINE);
+}
+/**
+ * Check if a file path has a valid extension for the given engine.
+ */
+export function isValidExtensionForEngine(filePath, engine) {
+    const ext = extname(filePath).toLowerCase();
+    return ENGINE_EXTENSIONS[engine].includes(ext);
+}
+/**
+ * Human-readable string of valid extensions for a file-based engine.
+ */
+export function formatExtensionsForEngine(engine) {
+    return ENGINE_EXTENSIONS[engine].join(', ');
+}
+/**
+ * Human-readable string of all valid file-based extensions.
+ */
+export function formatAllExtensions() {
+    return Object.keys(EXTENSION_TO_ENGINE).join(', ');
+}
+/**
+ * Get the registry for a file-based engine.
+ * Throws if the engine is not file-based.
+ */
+export function getRegistryForEngine(engine) {
+    switch (engine) {
+        case Engine.SQLite:
+            return sqliteRegistry;
+        case Engine.DuckDB:
+            return duckdbRegistry;
+        default:
+            if (isFileBasedEngine(engine)) {
+                throw new Error(`File-based engine "${engine}" has no registry configured in getRegistryForEngine()`);
+            }
+            throw new Error(`"${engine}" is not a file-based engine`);
+    }
+}
+// ============================================================
+// Container Name Derivation
+// ============================================================
+/**
+ * Derive a valid container name from a database filename.
+ * Removes the engine-specific extension and sanitizes for use as a container name.
+ *
+ * - Must start with a letter
+ * - Can contain letters, numbers, hyphens, underscores
+ * - Falls back to engine-specific default if result is empty
+ */
+export function deriveContainerName(fileName, engine) {
+    const extensionRegex = ENGINE_EXTENSION_REGEX[engine];
+    const fallback = engine === Engine.SQLite ? 'sqlite-db' : 'duckdb-db';
+    // Remove extension
+    const base = fileName.replace(extensionRegex, '');
+    // If nothing remains after extension removal, return engine-specific fallback
+    const sanitizedBase = base
+        .replace(/[^a-zA-Z0-9_-]/g, '-')
+        .replace(/^-+|-+$/g, '');
+    if (!sanitizedBase) {
+        return fallback;
+    }
+    // Convert to valid container name (alphanumeric, hyphens, underscores)
+    let name = base.replace(/[^a-zA-Z0-9_-]/g, '-');
+    // Ensure starts with letter
+    if (!/^[a-zA-Z]/.test(name)) {
+        name = 'db-' + name;
+    }
+    // Remove consecutive hyphens
+    name = name.replace(/-+/g, '-');
+    // Trim leading/trailing hyphens
+    name = name.replace(/^-+|-+$/g, '');
+    return name || fallback;
+}
+/**
+ * Scan a directory for unregistered file-based database files.
+ *
+ * @param engine The file-based engine to scan for
+ * @param directory Directory to scan (defaults to CWD)
+ * @returns Array of unregistered files
+ */
+export async function scanForUnregisteredFiles(engine, directory = process.cwd()) {
+    const absoluteDir = resolve(directory);
+    const registry = getRegistryForEngine(engine);
+    const extensionRegex = ENGINE_EXTENSION_REGEX[engine];
+    // Check if folder is ignored
+    if (await registry.isFolderIgnored(absoluteDir)) {
+        return [];
+    }
+    // Check if directory exists
+    if (!existsSync(absoluteDir)) {
+        return [];
+    }
+    try {
+        const entries = await readdir(absoluteDir, { withFileTypes: true });
+        const matchingFiles = entries
+            .filter((e) => e.isFile())
+            .filter((e) => extensionRegex.test(e.name))
+            .map((e) => ({
+            fileName: e.name,
+            absolutePath: resolve(absoluteDir, e.name),
+        }));
+        const unregistered = [];
+        for (const file of matchingFiles) {
+            if (!(await registry.isPathRegistered(file.absolutePath))) {
+                unregistered.push(file);
+            }
+        }
+        return unregistered;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=file-based-utils.js.map

package/dist/engines/file-based-utils.js.map

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

package/dist/engines/index.js

@@ -0,0 +1,124 @@
+import { postgresqlEngine } from './postgresql/index.js';
+import { mysqlEngine } from './mysql/index.js';
+import { mariadbEngine } from './mariadb/index.js';
+import { sqliteEngine } from './sqlite/index.js';
+import { duckdbEngine } from './duckdb/index.js';
+import { mongodbEngine } from './mongodb/index.js';
+import { ferretdbEngine } from './ferretdb/index.js';
+import { redisEngine } from './redis/index.js';
+import { valkeyEngine } from './valkey/index.js';
+import { clickhouseEngine } from './clickhouse/index.js';
+import { qdrantEngine } from './qdrant/index.js';
+import { meilisearchEngine } from './meilisearch/index.js';
+import { couchdbEngine } from './couchdb/index.js';
+import { cockroachdbEngine } from './cockroachdb/index.js';
+import { surrealdbEngine } from './surrealdb/index.js';
+import { questdbEngine } from './questdb/index.js';
+import { typedbEngine } from './typedb/index.js';
+import { influxdbEngine } from './influxdb/index.js';
+import { weaviateEngine } from './weaviate/index.js';
+import { tigerbeetleEngine } from './tigerbeetle/index.js';
+import { platformService } from '../core/platform-service.js';
+import { Engine, Platform } from '../types/index.js';
+// Engines not supported on Windows
+// These engines either don't have Windows binaries or have issues running on Windows
+// Note: FerretDB v1 supports Windows (v2 does not), so it's not blanket-blocked here.
+// Version-specific platform checks are handled by the engine itself.
+const WINDOWS_UNSUPPORTED_ENGINES = new Set([Engine.ClickHouse]);
+// Registry of available database engines
+export const engines = {
+    // PostgreSQL and aliases
+    [Engine.PostgreSQL]: postgresqlEngine,
+    postgres: postgresqlEngine,
+    pg: postgresqlEngine,
+    // MySQL and aliases
+    [Engine.MySQL]: mysqlEngine,
+    // MariaDB (standalone engine with downloadable binaries)
+    [Engine.MariaDB]: mariadbEngine,
+    maria: mariadbEngine,
+    // SQLite and aliases
+    [Engine.SQLite]: sqliteEngine,
+    lite: sqliteEngine,
+    // DuckDB and aliases
+    [Engine.DuckDB]: duckdbEngine,
+    duck: duckdbEngine,
+    // MongoDB and aliases
+    [Engine.MongoDB]: mongodbEngine,
+    mongo: mongodbEngine,
+    // FerretDB and aliases
+    [Engine.FerretDB]: ferretdbEngine,
+    ferret: ferretdbEngine,
+    fdb: ferretdbEngine,
+    // Redis and aliases
+    [Engine.Redis]: redisEngine,
+    // Valkey and aliases
+    [Engine.Valkey]: valkeyEngine,
+    // ClickHouse and aliases
+    [Engine.ClickHouse]: clickhouseEngine,
+    ch: clickhouseEngine,
+    // Qdrant and aliases
+    [Engine.Qdrant]: qdrantEngine,
+    qd: qdrantEngine,
+    // Meilisearch and aliases
+    [Engine.Meilisearch]: meilisearchEngine,
+    meili: meilisearchEngine,
+    ms: meilisearchEngine,
+    // CouchDB and aliases
+    [Engine.CouchDB]: couchdbEngine,
+    couch: couchdbEngine,
+    // CockroachDB and aliases
+    [Engine.CockroachDB]: cockroachdbEngine,
+    crdb: cockroachdbEngine,
+    // SurrealDB and aliases
+    [Engine.SurrealDB]: surrealdbEngine,
+    surreal: surrealdbEngine,
+    // QuestDB and aliases
+    [Engine.QuestDB]: questdbEngine,
+    quest: questdbEngine,
+    // TypeDB and aliases
+    [Engine.TypeDB]: typedbEngine,
+    tdb: typedbEngine,
+    // InfluxDB and aliases
+    [Engine.InfluxDB]: influxdbEngine,
+    influx: influxdbEngine,
+    // Weaviate and aliases
+    [Engine.Weaviate]: weaviateEngine,
+    wv: weaviateEngine,
+    // TigerBeetle and aliases
+    [Engine.TigerBeetle]: tigerbeetleEngine,
+    tb: tigerbeetleEngine,
+};
+// Get an engine by name
+export function getEngine(name) {
+    const engine = engines[name.toLowerCase()];
+    if (!engine) {
+        const available = [...new Set(Object.values(engines))].map((e) => e.name);
+        throw new Error(`Unknown engine "${name}". Available: ${available.join(', ')}`);
+    }
+    return engine;
+}
+// List all available engines (filtered by platform support)
+export function listEngines() {
+    const { platform } = platformService.getPlatformInfo();
+    const isWindows = platform === Platform.Win32;
+    const seen = new Set();
+    return Object.entries(engines)
+        .filter(([, engine]) => {
+        if (seen.has(engine))
+            return false;
+        seen.add(engine);
+        // Filter out unsupported engines on Windows
+        if (isWindows && WINDOWS_UNSUPPORTED_ENGINES.has(engine.name)) {
+            return false;
+        }
+        return true;
+    })
+        .map(([, engine]) => ({
+        name: engine.name,
+        displayName: engine.displayName,
+        defaultPort: engine.defaultPort,
+        supportedVersions: engine.supportedVersions,
+    }))
+        .sort((a, b) => a.displayName.localeCompare(b.displayName));
+}
+//# sourceMappingURL=index.js.map

package/dist/engines/index.js.map

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

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

@@ -0,0 +1,54 @@
+/**
+ * Shared InfluxDB REST API client utilities
+ */
+/**
+ * Make an HTTP request to InfluxDB REST API
+ *
+ * @param port - The HTTP port InfluxDB is listening on
+ * @param method - HTTP method (GET, POST, PUT, DELETE)
+ * @param path - API path (e.g., '/health', '/api/v3/query_sql')
+ * @param body - Optional body: object for JSON, string for text/plain (line protocol)
+ * @param timeoutMs - Request timeout in milliseconds (default: 30s)
+ */
+export async function influxdbApiRequest(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,
+        signal: controller.signal,
+    };
+    if (body !== undefined) {
+        if (typeof body === 'string') {
+            options.headers = { 'Content-Type': 'text/plain' };
+            options.body = body;
+        }
+        else {
+            options.headers = { 'Content-Type': 'application/json' };
+            options.body = JSON.stringify(body);
+        }
+    }
+    try {
+        const response = await fetch(url, options);
+        // Try to parse as JSON, fall back to text for endpoints like /health
+        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(`InfluxDB API request timed out after ${timeoutMs / 1000}s: ${method} ${path}`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+//# sourceMappingURL=api-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../engines/influxdb/api-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,MAAc,EACd,IAAY,EACZ,IAAuC,EACvC,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,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAA;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,OAAO,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,CAAA;YAClD,OAAO,CAAC,IAAI,GAAG,IAAI,CAAA;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,GAAG,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA;YACxD,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAE1C,qEAAqE;QACrE,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/influxdb/backup.js

@@ -0,0 +1,119 @@
+/**
+ * InfluxDB backup module
+ * Supports SQL-based backup using InfluxDB's REST API to export data
+ */
+import { mkdir, stat, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { dirname } from 'path';
+import { logDebug } from '../../core/error-handler.js';
+import { influxdbApiRequest } from './api-client.js';
+/**
+ * Create an SQL backup using InfluxDB's REST API
+ * Queries all tables and exports data as SQL INSERT statements
+ */
+export async function createBackup(container, outputPath, options) {
+    const { port } = container;
+    const database = options.database || container.database;
+    // Ensure output directory exists
+    const outputDir = dirname(outputPath);
+    if (!existsSync(outputDir)) {
+        await mkdir(outputDir, { recursive: true });
+    }
+    logDebug(`Creating InfluxDB SQL backup via REST API on port ${port} for database "${database}"`);
+    // Get list of tables in the database
+    const tablesResponse = await influxdbApiRequest(port, 'POST', '/api/v3/query_sql', {
+        db: database,
+        q: 'SHOW TABLES',
+        format: 'json',
+    });
+    if (tablesResponse.status !== 200) {
+        throw new Error(`Failed to list tables: ${JSON.stringify(tablesResponse.data)}`);
+    }
+    const tablesData = tablesResponse.data;
+    const tables = [];
+    // Extract user table names: include rows with 'iox' schema or no schema field,
+    // skip system schemas (information_schema, system, etc.)
+    if (Array.isArray(tablesData)) {
+        for (const row of tablesData) {
+            const schema = row.table_schema;
+            if (schema && schema !== 'iox')
+                continue;
+            const tableName = row.table_name ||
+                row.name ||
+                Object.values(row)[0];
+            if (tableName) {
+                tables.push(tableName);
+            }
+        }
+    }
+    logDebug(`Found ${tables.length} tables: ${tables.join(', ')}`);
+    // Build SQL dump
+    let sqlContent = `-- InfluxDB SQL Backup\n`;
+    sqlContent += `-- Database: ${database}\n`;
+    sqlContent += `-- Created: ${new Date().toISOString()}\n\n`;
+    for (const table of tables) {
+        logDebug(`Exporting table: ${table}`);
+        // Query column metadata to identify tag columns
+        // Tags use Dictionary(Int32, Utf8) type in InfluxDB 3.x
+        const tagColumns = [];
+        try {
+            const colResponse = await influxdbApiRequest(port, 'POST', '/api/v3/query_sql', {
+                db: database,
+                q: `SELECT column_name, data_type FROM information_schema.columns WHERE table_name = '${table.replace(/'/g, "''")}'`,
+                format: 'json',
+            });
+            if (colResponse.status === 200 && Array.isArray(colResponse.data)) {
+                for (const col of colResponse.data) {
+                    const dataType = String(col.data_type || '');
+                    if (dataType.includes('Dictionary')) {
+                        tagColumns.push(String(col.column_name));
+                    }
+                }
+            }
+        }
+        catch {
+            logDebug(`Warning: Could not query column metadata for ${table}`);
+        }
+        // Query all data from the table
+        const dataResponse = await influxdbApiRequest(port, 'POST', '/api/v3/query_sql', {
+            db: database,
+            q: `SELECT * FROM "${table.replace(/"/g, '""')}"`,
+            format: 'json',
+        });
+        if (dataResponse.status !== 200) {
+            logDebug(`Warning: Failed to export table ${table}: ${JSON.stringify(dataResponse.data)}`);
+            continue;
+        }
+        const rows = dataResponse.data;
+        if (Array.isArray(rows) && rows.length > 0) {
+            sqlContent += `-- Table: ${table}\n`;
+            if (tagColumns.length > 0) {
+                sqlContent += `-- Tags: ${tagColumns.join(', ')}\n`;
+            }
+            for (const row of rows) {
+                const columns = Object.keys(row);
+                const values = columns.map((col) => {
+                    const val = row[col];
+                    if (val === null || val === undefined)
+                        return 'NULL';
+                    if (typeof val === 'number')
+                        return String(val);
+                    if (typeof val === 'boolean')
+                        return val ? 'true' : 'false';
+                    return `'${String(val).replace(/'/g, "''")}'`;
+                });
+                sqlContent += `INSERT INTO "${table.replace(/"/g, '""')}" (${columns.map((c) => `"${c.replace(/"/g, '""')}"`).join(', ')}) VALUES (${values.join(', ')});\n`;
+            }
+            sqlContent += '\n';
+        }
+    }
+    // Write SQL content to file
+    await writeFile(outputPath, sqlContent, 'utf-8');
+    const stats = await stat(outputPath);
+    return {
+        path: outputPath,
+        format: 'sql',
+        size: stats.size,
+    };
+}
+//# sourceMappingURL=backup.js.map

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

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

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

@@ -0,0 +1,87 @@
+/**
+ * InfluxDB Binary Manager
+ *
+ * Handles downloading, extracting, and managing InfluxDB binaries from hostdb.
+ * Extends BaseBinaryManager for shared download/extraction logic.
+ *
+ * InfluxDB 3.x archives extract to a flat `influxdb/` directory:
+ *   influxdb/
+ *   ├── influxdb3           (server binary)
+ *   ├── python/             (bundled Python runtime)
+ *   │   └── lib/
+ *   │       └── libpython3.13.dylib
+ *   ├── LICENSE-APACHE
+ *   └── LICENSE-MIT
+ *
+ * The binary uses @executable_path/python/lib/libpython3.13.dylib, so python/
+ * must be in the same directory as the binary. We reorganize to:
+ *   bin/
+ *   ├── influxdb3
+ *   └── python/             (co-located for @executable_path resolution)
+ */
+import { mkdir, readdir } from 'fs/promises';
+import { join } from 'path';
+import { BaseBinaryManager, } from '../../core/base-binary-manager.js';
+import { moveEntry } from '../../core/fs-error-utils.js';
+import { logDebug } from '../../core/error-handler.js';
+import { getBinaryUrl } from './binary-urls.js';
+import { normalizeVersion } from './version-maps.js';
+import { Engine } from '../../types/index.js';
+class InfluxDBBinaryManager extends BaseBinaryManager {
+    config = {
+        engine: Engine.InfluxDB,
+        engineName: 'influxdb',
+        displayName: 'InfluxDB',
+        serverBinary: 'influxdb3',
+    };
+    getBinaryUrlFromModule(version, platform, arch) {
+        return getBinaryUrl(version, platform, arch);
+    }
+    normalizeVersionFromModule(version) {
+        return normalizeVersion(version);
+    }
+    parseVersionFromOutput(stdout) {
+        // Extract version from output like "influxdb3 3.8.0" or "InfluxDB 3 Edge v3.8.0"
+        const match = stdout.match(/v?(\d+\.\d+\.\d+)/);
+        return match?.[1] ?? null;
+    }
+    /**
+     * Override moveExtractedEntries to co-locate python/ with the binary.
+     *
+     * The influxdb3 binary references @executable_path/python/lib/libpython3.13.dylib,
+     * so the python/ directory must be inside bin/ alongside the binary.
+     * The default flat-structure handler would put python/ at binPath/python/ instead
+     * of binPath/bin/python/, causing a dylib load failure.
+     */
+    async moveExtractedEntries(extractDir, binPath) {
+        const entries = await readdir(extractDir, { withFileTypes: true });
+        // Find the influxdb directory (e.g., "influxdb" or "influxdb-3.8.0")
+        const influxDir = entries.find((e) => e.isDirectory() &&
+            (e.name === 'influxdb' || e.name.startsWith('influxdb-')));
+        const sourceDir = influxDir ? join(extractDir, influxDir.name) : extractDir;
+        const sourceEntries = influxDir
+            ? await readdir(sourceDir, { withFileTypes: true })
+            : entries;
+        // Create bin/ directory
+        const destBinDir = join(binPath, 'bin');
+        await mkdir(destBinDir, { recursive: true });
+        for (const entry of sourceEntries) {
+            const sourcePath = join(sourceDir, entry.name);
+            if (entry.name === 'influxdb3' || entry.name === 'influxdb3.exe') {
+                // Server binary → bin/
+                await moveEntry(sourcePath, join(destBinDir, entry.name));
+            }
+            else if (entry.name === 'python') {
+                // Python runtime → bin/python/ (must be co-located with binary for @executable_path)
+                await moveEntry(sourcePath, join(destBinDir, 'python'));
+            }
+            else {
+                // Licenses, metadata, etc. → binPath root
+                await moveEntry(sourcePath, join(binPath, entry.name));
+            }
+        }
+        logDebug('InfluxDB binaries reorganized with python/ co-located in bin/');
+    }
+}
+export const influxdbBinaryManager = new InfluxDBBinaryManager();
+//# sourceMappingURL=binary-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary-manager.js","sourceRoot":"","sources":["../../../engines/influxdb/binary-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EACL,iBAAiB,GAElB,MAAM,gCAAgC,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,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,qBAAsB,SAAQ,iBAAiB;IAChC,MAAM,GAAwB;QAC/C,MAAM,EAAE,MAAM,CAAC,QAAQ;QACvB,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,WAAW;KAC1B,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,iFAAiF;QACjF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QAC/C,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC3B,CAAC;IAED;;;;;;;OAOG;IACgB,KAAK,CAAC,oBAAoB,CAC3C,UAAkB,EAClB,OAAe;QAEf,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QAElE,qEAAqE;QACrE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,WAAW,EAAE;YACf,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAC5D,CAAA;QAED,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;QAC3E,MAAM,aAAa,GAAG,SAAS;YAC7B,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;YACnD,CAAC,CAAC,OAAO,CAAA;QAEX,wBAAwB;QACxB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACvC,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAE5C,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAE9C,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACjE,uBAAuB;gBACvB,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;YAC3D,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnC,qFAAqF;gBACrF,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAA;YACzD,CAAC;iBAAM,CAAC;gBACN,0CAA0C;gBAC1C,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;YACxD,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,+DAA+D,CAAC,CAAA;IAC3E,CAAC;CACF;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAA"}