spindb 0.37.2 → 0.38.0

package/dist/config/engine-defaults.js

@@ -0,0 +1,303 @@
+/**
+ * Engine-specific default configurations
+ * Extracted for dependency injection pattern - allows each engine to define its own defaults
+ */
+import { Engine, ALL_ENGINES } from '../types/index.js';
+export const engineDefaults = {
+    [Engine.PostgreSQL]: {
+        defaultVersion: '18',
+        defaultPort: 5432,
+        portRange: { start: 5432, end: 5500 },
+        latestVersion: '18',
+        superuser: 'postgres',
+        connectionScheme: 'postgresql',
+        logFileName: 'postgres.log',
+        pidFileName: 'postmaster.pid',
+        dataSubdir: 'data',
+        clientTools: ['psql', 'pg_dump', 'pg_restore', 'pg_basebackup'],
+        maxConnections: 200, // Higher than default 100 for parallel builds (Next.js, etc.)
+    },
+    [Engine.MySQL]: {
+        defaultVersion: '8.4',
+        defaultPort: 3306,
+        portRange: { start: 3306, end: 3400 },
+        latestVersion: '9',
+        superuser: 'root',
+        connectionScheme: 'mysql',
+        logFileName: 'mysql.log',
+        pidFileName: 'mysql.pid',
+        dataSubdir: 'data',
+        clientTools: ['mysql', 'mysqldump', 'mysqladmin'],
+        maxConnections: 200, // Higher than default 151 for parallel builds
+    },
+    [Engine.MariaDB]: {
+        defaultVersion: '11.8',
+        defaultPort: 3307, // Different from MySQL to allow side-by-side
+        portRange: { start: 3307, end: 3400 },
+        latestVersion: '11.8',
+        superuser: 'root',
+        connectionScheme: 'mysql', // MariaDB uses MySQL protocol
+        logFileName: 'mariadb.log',
+        pidFileName: 'mariadb.pid',
+        dataSubdir: 'data',
+        clientTools: ['mysql', 'mysqldump', 'mysqladmin'],
+        maxConnections: 200, // Higher than default 151 for parallel builds
+    },
+    [Engine.SQLite]: {
+        defaultVersion: '3',
+        defaultPort: 0, // File-based, no port
+        portRange: { start: 0, end: 0 }, // N/A
+        latestVersion: '3',
+        superuser: '', // No authentication
+        connectionScheme: 'sqlite',
+        logFileName: '', // No log file
+        pidFileName: '', // No PID file (no server process)
+        dataSubdir: '', // File is the data
+        clientTools: ['sqlite3'],
+        maxConnections: 0, // N/A - file-based
+    },
+    [Engine.DuckDB]: {
+        defaultVersion: '1',
+        defaultPort: 0, // File-based, no port
+        portRange: { start: 0, end: 0 }, // N/A
+        latestVersion: '1',
+        superuser: '', // No authentication
+        connectionScheme: 'duckdb',
+        logFileName: '', // No log file
+        pidFileName: '', // No PID file (no server process)
+        dataSubdir: '', // File is the data
+        clientTools: ['duckdb'],
+        maxConnections: 0, // N/A - file-based
+    },
+    [Engine.MongoDB]: {
+        defaultVersion: '8.0',
+        defaultPort: 27017,
+        portRange: { start: 27017, end: 27100 },
+        latestVersion: '8.2',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'mongodb',
+        logFileName: 'mongodb.log',
+        pidFileName: 'mongod.pid',
+        dataSubdir: 'data',
+        clientTools: ['mongosh', 'mongodump', 'mongorestore'],
+        maxConnections: 0, // Not applicable for MongoDB
+    },
+    [Engine.Redis]: {
+        defaultVersion: '8',
+        defaultPort: 6379,
+        portRange: { start: 6379, end: 6400 },
+        latestVersion: '8',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'redis',
+        logFileName: 'redis.log',
+        pidFileName: 'redis.pid',
+        dataSubdir: 'data',
+        clientTools: ['redis-cli'],
+        maxConnections: 0, // Not applicable for Redis
+    },
+    [Engine.Valkey]: {
+        defaultVersion: '9',
+        defaultPort: 6379,
+        portRange: { start: 6379, end: 6479 },
+        latestVersion: '9',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'redis', // Use redis:// scheme for client compatibility
+        logFileName: 'valkey.log',
+        pidFileName: 'valkey.pid',
+        dataSubdir: 'data',
+        clientTools: ['valkey-cli'],
+        maxConnections: 0, // Not applicable for Valkey
+    },
+    [Engine.ClickHouse]: {
+        defaultVersion: '25.12',
+        defaultPort: 9000, // Native TCP port (HTTP is 8123)
+        portRange: { start: 9000, end: 9100 },
+        latestVersion: '25.12',
+        superuser: 'default', // Default user in ClickHouse
+        connectionScheme: 'clickhouse',
+        logFileName: 'clickhouse-server.log',
+        pidFileName: 'clickhouse.pid',
+        dataSubdir: 'data',
+        clientTools: ['clickhouse'],
+        maxConnections: 0, // Not applicable
+    },
+    [Engine.Qdrant]: {
+        defaultVersion: '1',
+        defaultPort: 6333, // HTTP REST API port (gRPC is 6334)
+        portRange: { start: 6333, end: 6400 },
+        latestVersion: '1',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'http',
+        logFileName: 'qdrant.log',
+        pidFileName: 'qdrant.pid',
+        dataSubdir: 'storage',
+        clientTools: [], // Qdrant uses REST API, no separate CLI tools
+        maxConnections: 0, // Not applicable for vector DB
+    },
+    [Engine.Meilisearch]: {
+        defaultVersion: '1',
+        defaultPort: 7700, // HTTP REST API port
+        portRange: { start: 7700, end: 7800 },
+        latestVersion: '1',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'http',
+        logFileName: 'meilisearch.log',
+        pidFileName: 'meilisearch.pid',
+        dataSubdir: 'data',
+        clientTools: [], // Meilisearch uses REST API, no separate CLI tools
+        maxConnections: 0, // Not applicable for search engine
+    },
+    [Engine.FerretDB]: {
+        defaultVersion: '2',
+        defaultPort: 27017, // MongoDB-compatible port
+        portRange: { start: 27017, end: 27100 },
+        latestVersion: '2',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'mongodb', // MongoDB-compatible protocol
+        logFileName: 'ferretdb.log',
+        pidFileName: 'ferretdb.pid',
+        dataSubdir: 'pg_data', // PostgreSQL backend data directory
+        clientTools: ['mongosh', 'mongodump', 'mongorestore'], // Uses MongoDB client tools
+        maxConnections: 200, // PostgreSQL backend default
+    },
+    [Engine.CouchDB]: {
+        defaultVersion: '3',
+        defaultPort: 5984, // CouchDB default HTTP port
+        portRange: { start: 5984, end: 6084 },
+        latestVersion: '3',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'http',
+        logFileName: 'couchdb.log',
+        pidFileName: 'couchdb.pid',
+        dataSubdir: 'data',
+        clientTools: [], // CouchDB uses REST API, no separate CLI tools
+        maxConnections: 0, // Not applicable
+    },
+    [Engine.CockroachDB]: {
+        defaultVersion: '25',
+        defaultPort: 26257, // CockroachDB default SQL port (HTTP UI at port + 1)
+        portRange: { start: 26257, end: 26357 },
+        latestVersion: '25',
+        superuser: 'root', // Default user in insecure mode
+        connectionScheme: 'postgresql', // Uses PostgreSQL wire protocol
+        logFileName: 'cockroach.log',
+        pidFileName: 'cockroach.pid',
+        dataSubdir: 'data',
+        clientTools: ['cockroach'],
+        maxConnections: 0, // Not applicable - managed internally
+    },
+    [Engine.SurrealDB]: {
+        defaultVersion: '2',
+        defaultPort: 8000, // SurrealDB default HTTP/WS port
+        portRange: { start: 8000, end: 8100 },
+        latestVersion: '2',
+        superuser: 'root', // Default user with password 'root'
+        connectionScheme: 'ws', // WebSocket for real-time connections
+        logFileName: 'surrealdb.log',
+        pidFileName: 'surrealdb.pid',
+        dataSubdir: 'data',
+        clientTools: ['surreal'],
+        maxConnections: 0, // Not applicable - managed internally
+    },
+    [Engine.QuestDB]: {
+        defaultVersion: '9',
+        defaultPort: 8812, // QuestDB PostgreSQL wire protocol port
+        portRange: { start: 8812, end: 8912 },
+        latestVersion: '9',
+        superuser: 'admin', // Default user with password 'quest'
+        connectionScheme: 'postgresql', // Uses PostgreSQL wire protocol
+        logFileName: 'questdb.log',
+        pidFileName: 'questdb.pid',
+        dataSubdir: 'db',
+        clientTools: ['questdb'],
+        maxConnections: 0, // Not applicable - managed internally
+    },
+    [Engine.TypeDB]: {
+        defaultVersion: '3',
+        defaultPort: 1729, // TypeDB main port (gRPC protocol)
+        portRange: { start: 1729, end: 1829 },
+        latestVersion: '3',
+        superuser: 'admin', // Default admin user (password: 'password')
+        connectionScheme: 'typedb', // TypeDB proprietary protocol
+        logFileName: 'typedb.log',
+        pidFileName: 'typedb.pid',
+        dataSubdir: 'data',
+        clientTools: ['typedb', 'typedb_console_bin'],
+        maxConnections: 0, // Not applicable - managed internally
+    },
+    [Engine.InfluxDB]: {
+        defaultVersion: '3',
+        defaultPort: 8086, // InfluxDB HTTP API port
+        portRange: { start: 8086, end: 8186 },
+        latestVersion: '3',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'http',
+        logFileName: 'influxdb.log',
+        pidFileName: 'influxdb.pid',
+        dataSubdir: 'data',
+        clientTools: [], // InfluxDB uses REST API, no separate CLI tools
+        maxConnections: 0, // Not applicable for time-series DB
+    },
+    [Engine.Weaviate]: {
+        defaultVersion: '1',
+        defaultPort: 8080, // Weaviate HTTP REST API port (gRPC is port + 1)
+        portRange: { start: 8080, end: 8180 },
+        latestVersion: '1',
+        superuser: '', // No auth by default for local dev
+        connectionScheme: 'http',
+        logFileName: 'weaviate.log',
+        pidFileName: 'weaviate.pid',
+        dataSubdir: 'data',
+        clientTools: [], // Weaviate uses REST/GraphQL API, no separate CLI tools
+        maxConnections: 0, // Not applicable for vector DB
+    },
+    [Engine.TigerBeetle]: {
+        defaultVersion: '0.16',
+        defaultPort: 3000,
+        portRange: { start: 3000, end: 3100 },
+        latestVersion: '0.16',
+        superuser: '', // No auth
+        connectionScheme: '', // Custom binary protocol, no URI scheme
+        logFileName: 'tigerbeetle.log',
+        pidFileName: 'tigerbeetle.pid',
+        dataSubdir: 'data',
+        clientTools: ['tigerbeetle'], // Single binary serves as both server and REPL
+        maxConnections: 0, // Not applicable
+    },
+};
+/**
+ * Type guard to check if a string is a valid Engine
+ */
+function isValidEngine(value) {
+    return value in engineDefaults;
+}
+/**
+ * Get engine defaults by name
+ * @param engine Engine (e.g., Engine.PostgreSQL or 'postgresql')
+ * @throws Error if engine is not found
+ */
+export function getEngineDefaults(engine) {
+    const normalized = engine.toLowerCase();
+    if (!isValidEngine(normalized)) {
+        const available = Object.keys(engineDefaults).join(', ');
+        throw new Error(`Unknown engine "${engine}". Available engines: ${available}`);
+    }
+    return engineDefaults[normalized];
+}
+// Check if an engine is supported
+export function isEngineSupported(engine) {
+    return isValidEngine(engine.toLowerCase());
+}
+// Get list of all supported engine names
+export function getSupportedEngines() {
+    return [...ALL_ENGINES];
+}
+/**
+ * Get Homebrew package name for PostgreSQL client tools
+ * Returns 'postgresql@18' format for versioned installs
+ */
+export function getPostgresHomebrewPackage() {
+    const version = engineDefaults[Engine.PostgreSQL].latestVersion;
+    return `postgresql@${version}`;
+}
+//# sourceMappingURL=engine-defaults.js.map

package/dist/config/engine-defaults.js.map

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

package/dist/config/engines-registry.js

@@ -0,0 +1,103 @@
+import { readFile } from 'fs/promises';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { ALL_ENGINES } from '../types/index.js';
+// Cache for loaded engines config
+let cachedEngines = null;
+// Get directory of this file for relative path resolution
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export async function loadEnginesJson() {
+    if (cachedEngines)
+        return cachedEngines;
+    const jsonPath = join(__dirname, 'engines.json');
+    let content;
+    try {
+        content = await readFile(jsonPath, 'utf-8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read engines.json at ${jsonPath}: ${message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to parse engines.json at ${jsonPath}: ${message}`);
+    }
+    // Structural validation: ensure parsed has expected shape
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error(`engines.json at ${jsonPath} has invalid structure: expected object`);
+    }
+    if (!parsed.engines || typeof parsed.engines !== 'object') {
+        throw new Error(`engines.json at ${jsonPath} has invalid structure: missing or invalid 'engines' field`);
+    }
+    // Runtime validation: ensure all engines are present
+    for (const engine of ALL_ENGINES) {
+        if (!(engine in parsed.engines)) {
+            throw new Error(`engines.json is missing engine: ${engine}. ` +
+                `All engines from the Engine enum must be present.`);
+        }
+    }
+    cachedEngines = parsed;
+    return cachedEngines;
+}
+export async function getEngineConfig(engine) {
+    const data = await loadEnginesJson();
+    return data.engines[engine];
+}
+export function getAllEngines() {
+    return [...ALL_ENGINES];
+}
+export function clearEnginesCache() {
+    cachedEngines = null;
+}
+/**
+ * Filter engines data to only include engines and versions supported on the given platform.
+ *
+ * - If an engine has `platforms` and the platformKey isn't listed, the engine is removed.
+ * - If an engine has `versionPlatforms`, versions whose entry excludes the platformKey are removed.
+ *   Versions with no entry in `versionPlatforms` are kept (assumed all-platform).
+ * - If filtering removes all versions, the engine is removed.
+ * - If the defaultVersion is removed, it's set to the first remaining version.
+ */
+export function filterEnginesByPlatform(enginesData, platformKey) {
+    const filtered = {};
+    for (const [name, config] of Object.entries(enginesData.engines)) {
+        // Engine-level platform check
+        if (config.platforms && !config.platforms.includes(platformKey)) {
+            continue;
+        }
+        // Version-level platform check
+        if (config.versionPlatforms) {
+            const filteredVersions = config.supportedVersions.filter((version) => {
+                const platforms = config.versionPlatforms[version];
+                // If no entry for this version, it's available on all platforms
+                if (!platforms)
+                    return true;
+                return platforms.includes(platformKey);
+            });
+            if (filteredVersions.length === 0) {
+                continue;
+            }
+            const defaultVersion = filteredVersions.includes(config.defaultVersion)
+                ? config.defaultVersion
+                : filteredVersions[0];
+            filtered[name] = {
+                ...config,
+                supportedVersions: filteredVersions,
+                defaultVersion,
+            };
+        }
+        else {
+            filtered[name] = config;
+        }
+    }
+    return {
+        ...enginesData,
+        engines: filtered,
+    };
+}
+//# sourceMappingURL=engines-registry.js.map

package/dist/config/engines-registry.js.map

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