spindb 0.37.2 → 0.38.0

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

@@ -0,0 +1,163 @@
+/**
+ * TypeDB CLI utilities
+ *
+ * Helper functions for working with TypeDB command-line tools.
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { paths } from '../../config/paths.js';
+import { configManager } from '../../core/config-manager.js';
+import { platformService } from '../../core/platform-service.js';
+import { normalizeVersion } from './version-maps.js';
+export const TYPEDB_NOT_FOUND_ERROR = 'TypeDB binary not found. Run: spindb engines download typedb <version>';
+/** Default TypeDB credentials (TypeDB 3.x requires authentication) */
+export const TYPEDB_DEFAULT_USERNAME = 'admin';
+export const TYPEDB_DEFAULT_PASSWORD = 'password';
+/**
+ * Get standard TypeDB console connection arguments including authentication.
+ * TypeDB 3.x requires --username and --password for all console operations.
+ *
+ * @param tlsDisabled - When true (the default for local dev), appends --tls-disabled.
+ *   Pass false when connecting to a TLS-enabled TypeDB server.
+ */
+export function getConsoleBaseArgs(port, host = '127.0.0.1', tlsDisabled = true) {
+    const args = [
+        '--address',
+        `${host}:${port}`,
+        ...(tlsDisabled ? ['--tls-disabled'] : []),
+        '--username',
+        TYPEDB_DEFAULT_USERNAME,
+        '--password',
+        TYPEDB_DEFAULT_PASSWORD,
+    ];
+    return args;
+}
+/**
+ * Get the path to the typedb launcher binary
+ *
+ * First checks the config cache, then scans the downloaded binaries directory.
+ * Returns null if not found.
+ */
+export async function getTypeDBPath() {
+    // Check config cache first
+    const cached = await configManager.getBinaryPath('typedb');
+    if (cached && existsSync(cached)) {
+        return cached;
+    }
+    // Fall back to filesystem scan using the same logic as getTypeDBPathForVersion
+    const { TYPEDB_VERSION_MAP } = await import('./version-maps.js');
+    for (const version of Object.values(TYPEDB_VERSION_MAP)) {
+        const found = await getTypeDBPathForVersion(version);
+        if (found) {
+            await configManager.setBinaryPath('typedb', found, 'bundled');
+            return found;
+        }
+    }
+    return null;
+}
+/**
+ * Get the typedb binary path for a specific version
+ */
+export async function getTypeDBPathForVersion(version) {
+    const { platform, arch } = platformService.getPlatformInfo();
+    const fullVersion = normalizeVersion(version);
+    // TypeDB launcher is a .bat script on Windows, no extension on other platforms
+    const batExt = platform === 'win32' ? '.bat' : '';
+    const binPath = paths.getBinaryPath({
+        engine: 'typedb',
+        version: fullVersion,
+        platform,
+        arch,
+    });
+    const typedbPath = join(binPath, 'bin', `typedb${batExt}`);
+    if (existsSync(typedbPath)) {
+        return typedbPath;
+    }
+    return null;
+}
+/**
+ * Get the typedb_console_bin path for a specific version
+ */
+export async function getTypeDBConsolePath(version) {
+    const { platform, arch } = platformService.getPlatformInfo();
+    const fullVersion = normalizeVersion(version);
+    const ext = platformService.getExecutableExtension();
+    const binPath = paths.getBinaryPath({
+        engine: 'typedb',
+        version: fullVersion,
+        platform,
+        arch,
+    });
+    const consolePath = join(binPath, 'bin', 'console', `typedb_console_bin${ext}`);
+    if (existsSync(consolePath)) {
+        return consolePath;
+    }
+    return null;
+}
+/**
+ * Require the typedb binary path, throwing if not found
+ */
+export async function requireTypeDBPath(version) {
+    // If version provided, look for that specific version
+    if (version) {
+        const path = await getTypeDBPathForVersion(version);
+        if (path) {
+            return path;
+        }
+    }
+    // Try config cache
+    const cached = await getTypeDBPath();
+    if (cached) {
+        return cached;
+    }
+    throw new Error(TYPEDB_NOT_FOUND_ERROR);
+}
+/**
+ * Require the typedb_console_bin path, throwing if not found
+ */
+export async function requireTypeDBConsolePath(version) {
+    if (version) {
+        const path = await getTypeDBConsolePath(version);
+        if (path) {
+            return path;
+        }
+    }
+    // Try config cache
+    const cached = await configManager.getBinaryPath('typedb_console_bin');
+    if (cached && existsSync(cached)) {
+        return cached;
+    }
+    // Fall back to scanning all installed versions (same pattern as requireTypeDBPath)
+    const { TYPEDB_VERSION_MAP } = await import('./version-maps.js');
+    for (const ver of Object.values(TYPEDB_VERSION_MAP)) {
+        const found = await getTypeDBConsolePath(ver);
+        if (found) {
+            return found;
+        }
+    }
+    throw new Error('TypeDB console binary not found. Run: spindb engines download typedb <version>');
+}
+/**
+ * Validate a TypeDB identifier (database name)
+ * TypeDB identifiers follow specific rules:
+ * - Start with letter or underscore
+ * - Contain letters, digits, underscores, dashes
+ * - Max 63 characters
+ *
+ * @throws Error if identifier is invalid
+ */
+export function validateTypeDBIdentifier(identifier, type = 'database') {
+    if (!identifier) {
+        throw new Error(`${type} name cannot be empty`);
+    }
+    if (identifier.length > 63) {
+        throw new Error(`${type} name cannot exceed 63 characters`);
+    }
+    // TypeDB allows alphanumeric, underscores, and dashes
+    const validPattern = /^[a-zA-Z_][a-zA-Z0-9_-]*$/;
+    if (!validPattern.test(identifier)) {
+        throw new Error(`Invalid ${type} name "${identifier}". ` +
+            `Must start with a letter or underscore and contain only letters, digits, underscores, and dashes.`);
+    }
+}
+//# sourceMappingURL=cli-utils.js.map

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

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

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

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

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

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