spindb 0.37.2 → 0.38.0

package/dist/engines/tigerbeetle/index.js

@@ -0,0 +1,559 @@
+/**
+ * TigerBeetle Engine Implementation
+ *
+ * TigerBeetle is a high-performance financial ledger database written in Zig,
+ * with a custom binary protocol (not REST, not SQL).
+ *
+ * Key characteristics:
+ * - Default port: 3000
+ * - Single binary: `tigerbeetle` (server + REPL client)
+ * - Two-step init: `tigerbeetle format` then `tigerbeetle start`
+ * - No auth, no multi-database, custom binary protocol
+ * - Health check: PID + TCP port (no HTTP endpoint)
+ * - Backup: stop-and-copy of single data file
+ * - REPL: `tigerbeetle repl --cluster=0 --addresses=port`
+ * - `--development` flag required for local dev
+ * - Abrupt shutdown (SIGTERM/SIGKILL) is safe by design
+ */
+import { spawn, execFileSync } from 'child_process';
+import { existsSync, openSync, closeSync } from 'fs';
+import { mkdir, writeFile, readFile, unlink, stat } from 'fs/promises';
+import { join } from 'path';
+import { BaseEngine } from '../base-engine.js';
+import { paths } from '../../config/paths.js';
+import { getEngineDefaults } from '../../config/defaults.js';
+import { platformService, isWindows } from '../../core/platform-service.js';
+import { configManager } from '../../core/config-manager.js';
+import { logDebug, logWarning } from '../../core/error-handler.js';
+import { processManager } from '../../core/process-manager.js';
+import { portManager } from '../../core/port-manager.js';
+import { tigerbeetleBinaryManager } from './binary-manager.js';
+import { getBinaryUrl } from './binary-urls.js';
+import { normalizeVersion, SUPPORTED_MAJOR_VERSIONS, TIGERBEETLE_VERSION_MAP, } from './version-maps.js';
+import { fetchAvailableVersions as fetchHostdbVersions } from './hostdb-releases.js';
+import { detectBackupFormat as detectBackupFormatImpl, restoreBackup, } from './restore.js';
+import { createBackup } from './backup.js';
+const ENGINE = 'tigerbeetle';
+const engineDef = getEngineDefaults(ENGINE);
+/**
+ * Default cluster ID for local single-node development.
+ * TigerBeetle requires a cluster ID for format, start, and REPL commands.
+ * Cluster 0 is the standard default for local/single-node usage.
+ */
+const DEFAULT_CLUSTER_ID = 0;
+export class TigerBeetleEngine extends BaseEngine {
+    name = ENGINE;
+    displayName = 'TigerBeetle';
+    defaultPort = engineDef.defaultPort;
+    supportedVersions = SUPPORTED_MAJOR_VERSIONS;
+    getPlatformInfo() {
+        return platformService.getPlatformInfo();
+    }
+    async fetchAvailableVersions() {
+        return fetchHostdbVersions();
+    }
+    getBinaryUrl(version, platform, arch) {
+        return getBinaryUrl(version, platform, arch);
+    }
+    resolveFullVersion(version) {
+        if (/^\d+\.\d+\.\d+$/.test(version)) {
+            return version;
+        }
+        return TIGERBEETLE_VERSION_MAP[version] || version;
+    }
+    getBinaryPath(version) {
+        const fullVersion = this.resolveFullVersion(version);
+        const { platform: p, arch: a } = this.getPlatformInfo();
+        return paths.getBinaryPath({
+            engine: 'tigerbeetle',
+            version: fullVersion,
+            platform: p,
+            arch: a,
+        });
+    }
+    async verifyBinary(binPath) {
+        const ext = platformService.getExecutableExtension();
+        const serverPath = join(binPath, 'bin', `tigerbeetle${ext}`);
+        return existsSync(serverPath);
+    }
+    async isBinaryInstalled(version) {
+        const { platform, arch } = this.getPlatformInfo();
+        return tigerbeetleBinaryManager.isInstalled(version, platform, arch);
+    }
+    async ensureBinaries(version, onProgress) {
+        const { platform, arch } = this.getPlatformInfo();
+        const binPath = await tigerbeetleBinaryManager.ensureInstalled(version, platform, arch, onProgress);
+        // Register binary in config
+        const ext = platformService.getExecutableExtension();
+        const toolPath = join(binPath, 'bin', `tigerbeetle${ext}`);
+        if (existsSync(toolPath)) {
+            await configManager.setBinaryPath('tigerbeetle', toolPath, 'bundled');
+        }
+        return binPath;
+    }
+    /**
+     * Initialize a new TigerBeetle data directory.
+     * Creates the directory and runs `tigerbeetle format` to initialize the data file.
+     */
+    async initDataDir(containerName, version, _options = {}) {
+        const dataDir = paths.getContainerDataPath(containerName, {
+            engine: ENGINE,
+        });
+        // Create data directory if it doesn't exist
+        if (!existsSync(dataDir)) {
+            await mkdir(dataDir, { recursive: true });
+            logDebug(`Created TigerBeetle data directory: ${dataDir}`);
+        }
+        const dataFile = join(dataDir, '0_0.tigerbeetle');
+        // Skip format if data file already exists (e.g., restoring from backup)
+        if (existsSync(dataFile)) {
+            logDebug(`TigerBeetle data file already exists: ${dataFile}`);
+            return dataDir;
+        }
+        // Get binary path for format command
+        const tigerbeetleBinary = await this.getTigerBeetlePath(version);
+        // Run tigerbeetle format to initialize the data file
+        logDebug(`Formatting TigerBeetle data file: ${dataFile}`);
+        try {
+            execFileSync(tigerbeetleBinary, [
+                'format',
+                `--cluster=${DEFAULT_CLUSTER_ID}`,
+                '--replica=0',
+                '--replica-count=1',
+                '--development',
+                dataFile,
+            ], {
+                timeout: 30000,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            logDebug(`TigerBeetle data file formatted successfully: ${dataFile}`);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            if (msg.includes('PermissionDenied')) {
+                throw new Error("TigerBeetle requires io_uring syscalls which are blocked by Docker's default seccomp profile.\n" +
+                    'Run your container with: docker run --security-opt seccomp=unconfined ...');
+            }
+            throw new Error(`Failed to format TigerBeetle data file: ${msg}`);
+        }
+        return dataDir;
+    }
+    // Get the path to tigerbeetle binary for a version
+    async getTigerBeetlePath(version) {
+        // Check config cache first
+        const cached = await configManager.getBinaryPath('tigerbeetle');
+        if (cached && existsSync(cached)) {
+            return cached;
+        }
+        const { platform, arch } = this.getPlatformInfo();
+        const fullVersion = normalizeVersion(version);
+        const ext = platformService.getExecutableExtension();
+        const binPath = paths.getBinaryPath({
+            engine: 'tigerbeetle',
+            version: fullVersion,
+            platform,
+            arch,
+        });
+        const tigerbeetlePath = join(binPath, 'bin', `tigerbeetle${ext}`);
+        if (existsSync(tigerbeetlePath)) {
+            return tigerbeetlePath;
+        }
+        throw new Error(`TigerBeetle ${version} is not installed. Run: spindb engines download tigerbeetle ${version}`);
+    }
+    /**
+     * Start TigerBeetle server
+     */
+    async start(container, onProgress) {
+        const { name, port, version, binaryPath } = container;
+        // Check if already running (idempotent behavior)
+        const alreadyRunning = await processManager.isRunning(name, {
+            engine: ENGINE,
+        });
+        if (alreadyRunning) {
+            return {
+                port,
+                connectionString: this.getConnectionString(container),
+            };
+        }
+        // Get TigerBeetle binary path
+        let tigerbeetleBinary = null;
+        const ext = platformService.getExecutableExtension();
+        if (binaryPath && existsSync(binaryPath)) {
+            const serverPath = join(binaryPath, 'bin', `tigerbeetle${ext}`);
+            if (existsSync(serverPath)) {
+                tigerbeetleBinary = serverPath;
+                logDebug(`Using stored binary path: ${tigerbeetleBinary}`);
+            }
+        }
+        if (!tigerbeetleBinary) {
+            try {
+                tigerbeetleBinary = await this.getTigerBeetlePath(version);
+            }
+            catch (error) {
+                const originalMessage = error instanceof Error ? error.message : String(error);
+                throw new Error(`TigerBeetle ${version} is not installed. Run: spindb engines download tigerbeetle ${version}\n` +
+                    `  Original error: ${originalMessage}`);
+            }
+        }
+        const containerDir = paths.getContainerPath(name, { engine: ENGINE });
+        const dataDir = paths.getContainerDataPath(name, { engine: ENGINE });
+        const logFile = paths.getContainerLogPath(name, { engine: ENGINE });
+        const pidFile = join(containerDir, 'tigerbeetle.pid');
+        const dataFile = join(dataDir, '0_0.tigerbeetle');
+        if (!existsSync(dataFile)) {
+            throw new Error(`TigerBeetle data file not found at ${dataFile}. Run: spindb create <name> --engine tigerbeetle`);
+        }
+        onProgress?.({ stage: 'starting', message: 'Starting TigerBeetle...' });
+        logDebug(`Starting TigerBeetle on port ${port}`);
+        const args = [
+            'start',
+            `--addresses=127.0.0.1:${port}`,
+            '--development',
+            dataFile,
+        ];
+        // Redirect stdout/stderr to log file via file descriptor
+        const logFd = openSync(logFile, 'a');
+        const spawnOpts = {
+            cwd: containerDir,
+            stdio: ['ignore', logFd, logFd],
+            detached: true,
+        };
+        if (isWindows()) {
+            spawnOpts.windowsHide = true;
+        }
+        const proc = spawn(tigerbeetleBinary, args, spawnOpts);
+        proc.unref();
+        // Close fd in parent — child inherited its own copy
+        closeSync(logFd);
+        if (!proc.pid) {
+            throw new Error('TigerBeetle server process failed to start (no PID)');
+        }
+        try {
+            await writeFile(pidFile, String(proc.pid));
+        }
+        catch {
+            // Non-fatal
+        }
+        // Wait for TigerBeetle to be ready (TCP port check)
+        const ready = await this.waitForReady(port);
+        if (ready) {
+            // On Windows, detached processes may have a different actual PID.
+            // Find the real PID by port and update the PID file (same pattern as QuestDB).
+            try {
+                const pids = await platformService.findProcessByPort(port);
+                if (pids.length > 0 && pids[0] !== proc.pid) {
+                    logDebug(`TigerBeetle actual PID ${pids[0]} differs from spawn PID ${proc.pid}, updating PID file`);
+                    await writeFile(pidFile, String(pids[0]));
+                }
+            }
+            catch {
+                // Non-fatal - PID file already has proc.pid from earlier write
+            }
+            return {
+                port,
+                connectionString: this.getConnectionString(container),
+            };
+        }
+        // Clean up the orphaned detached process before throwing
+        if (platformService.isProcessRunning(proc.pid)) {
+            try {
+                await platformService.terminateProcess(proc.pid, true);
+            }
+            catch {
+                // Ignore cleanup errors - best effort
+            }
+        }
+        // Check log for errors
+        let logError = '';
+        try {
+            const logContent = await readFile(logFile, 'utf-8');
+            const recentLog = logContent.slice(-2000);
+            if (recentLog.includes('PermissionDenied')) {
+                throw new Error("TigerBeetle requires io_uring syscalls which are blocked by Docker's default seccomp profile.\n" +
+                    'Run your container with: docker run --security-opt seccomp=unconfined ...');
+            }
+            if (recentLog.includes('Address already in use') ||
+                recentLog.includes('address already in use')) {
+                logError = `Port ${port} is already in use`;
+            }
+        }
+        catch (logReadError) {
+            // Re-throw io_uring error, ignore other log read failures
+            if (logReadError instanceof Error &&
+                logReadError.message.includes('io_uring')) {
+                throw logReadError;
+            }
+        }
+        const errorDetails = [
+            logError || 'TigerBeetle failed to start within timeout.',
+            `Binary: ${tigerbeetleBinary}`,
+            `Log file: ${logFile}`,
+        ]
+            .filter(Boolean)
+            .join('\n');
+        throw new Error(errorDetails);
+    }
+    /**
+     * Wait for TigerBeetle to be ready by checking if the port is listening.
+     * TigerBeetle has no HTTP health endpoint, so we use TCP port check.
+     */
+    async waitForReady(port, timeoutMs = 30000) {
+        const startTime = Date.now();
+        const checkInterval = 500;
+        while (Date.now() - startTime < timeoutMs) {
+            // Check if the port is no longer available (something is listening)
+            const available = await portManager.isPortAvailable(port);
+            if (!available) {
+                logDebug(`TigerBeetle ready on port ${port}`);
+                return true;
+            }
+            await new Promise((resolve) => setTimeout(resolve, checkInterval));
+        }
+        logDebug(`TigerBeetle did not become ready within ${timeoutMs}ms`);
+        return false;
+    }
+    /**
+     * Stop TigerBeetle server.
+     * SIGTERM is safe by design — TigerBeetle handles abrupt shutdown gracefully.
+     */
+    async stop(container) {
+        const { name, port } = container;
+        const containerDir = paths.getContainerPath(name, { engine: ENGINE });
+        const pidFile = join(containerDir, 'tigerbeetle.pid');
+        logDebug(`Stopping TigerBeetle container "${name}" on port ${port}`);
+        let pid = null;
+        // Read PID from file
+        if (existsSync(pidFile)) {
+            try {
+                const content = await readFile(pidFile, 'utf8');
+                pid = parseInt(content.trim(), 10);
+            }
+            catch {
+                // Ignore
+            }
+        }
+        // Fallback: find by port
+        if (!pid || !platformService.isProcessRunning(pid)) {
+            try {
+                const pids = await platformService.findProcessByPort(port);
+                if (pids.length > 0) {
+                    pid = pids[0];
+                }
+            }
+            catch {
+                // Ignore
+            }
+        }
+        // Kill process if found
+        if (pid && platformService.isProcessRunning(pid)) {
+            logDebug(`Killing TigerBeetle process ${pid}`);
+            try {
+                if (isWindows()) {
+                    await platformService.terminateProcess(pid, true);
+                }
+                else {
+                    await platformService.terminateProcess(pid, false);
+                    await new Promise((resolve) => setTimeout(resolve, 2000));
+                    if (platformService.isProcessRunning(pid)) {
+                        logWarning(`Graceful termination failed, force killing ${pid}`);
+                        await platformService.terminateProcess(pid, true);
+                    }
+                }
+            }
+            catch (error) {
+                logDebug(`Process termination error: ${error}`);
+            }
+        }
+        // Wait for termination
+        const terminationWait = isWindows() ? 3000 : 1000;
+        await new Promise((resolve) => setTimeout(resolve, terminationWait));
+        // Cleanup PID file
+        if (existsSync(pidFile)) {
+            try {
+                await unlink(pidFile);
+            }
+            catch {
+                // Ignore
+            }
+        }
+        logDebug('TigerBeetle stopped');
+    }
+    /**
+     * Get TigerBeetle server status.
+     * Uses PID file + process check, with port-based fallback.
+     * No HTTP health endpoint available.
+     */
+    async status(container) {
+        const { name, port } = container;
+        const containerDir = paths.getContainerPath(name, { engine: ENGINE });
+        const pidFile = join(containerDir, 'tigerbeetle.pid');
+        // Check PID file first
+        if (existsSync(pidFile)) {
+            try {
+                const content = await readFile(pidFile, 'utf8');
+                const pid = parseInt(content.trim(), 10);
+                if (!isNaN(pid) && pid > 0 && platformService.isProcessRunning(pid)) {
+                    return {
+                        running: true,
+                        message: `TigerBeetle is running (PID: ${pid})`,
+                    };
+                }
+            }
+            catch {
+                // Ignore
+            }
+        }
+        // Fallback: check by port
+        try {
+            const pids = await platformService.findProcessByPort(port);
+            if (pids.length > 0) {
+                return {
+                    running: true,
+                    message: `TigerBeetle is running (PID: ${pids[0]})`,
+                };
+            }
+        }
+        catch {
+            // Ignore
+        }
+        return { running: false, message: 'TigerBeetle is not running' };
+    }
+    async detectBackupFormat(filePath) {
+        return detectBackupFormatImpl(filePath);
+    }
+    /**
+     * Restore a backup.
+     * TigerBeetle must be stopped before restore.
+     */
+    async restore(container, backupPath, _options = {}) {
+        const { name } = container;
+        // Check if container is running
+        const statusResult = await this.status(container);
+        if (statusResult.running) {
+            throw new Error(`TigerBeetle container "${name}" must be stopped before restore. ` +
+                `Run: spindb stop ${name}`);
+        }
+        const dataDir = paths.getContainerDataPath(name, { engine: ENGINE });
+        return restoreBackup(backupPath, {
+            containerName: name,
+            dataDir,
+        });
+    }
+    /**
+     * Get connection string.
+     * TigerBeetle uses custom binary protocol — no URI scheme.
+     */
+    getConnectionString(container, _database) {
+        const { port } = container;
+        return `127.0.0.1:${port}`;
+    }
+    /**
+     * Open TigerBeetle REPL (interactive client).
+     * Uses stdio: 'inherit' pattern from SurrealDB.
+     */
+    async connect(container, _database) {
+        const { port, version } = container;
+        const tigerbeetleBinary = await this.getTigerBeetlePath(version);
+        const spawnOptions = {
+            stdio: 'inherit',
+        };
+        return new Promise((resolve, reject) => {
+            const proc = spawn(tigerbeetleBinary, [
+                'repl',
+                `--cluster=${DEFAULT_CLUSTER_ID}`,
+                `--addresses=127.0.0.1:${port}`,
+            ], spawnOptions);
+            proc.on('error', reject);
+            proc.on('close', () => resolve());
+        });
+    }
+    /**
+     * Create database — not supported.
+     * TigerBeetle has no database concept.
+     */
+    async createDatabase(_container, _database) {
+        throw new Error('TigerBeetle does not support multiple databases. ' +
+            'Each container is a single ledger instance.');
+    }
+    /**
+     * Drop database — not supported.
+     */
+    async dropDatabase(_container, _database) {
+        throw new Error('TigerBeetle does not support multiple databases. ' +
+            'Use `spindb delete <container>` to remove the instance.');
+    }
+    /**
+     * Get database size from data file.
+     */
+    async getDatabaseSize(container) {
+        const dataDir = paths.getContainerDataPath(container.name, {
+            engine: ENGINE,
+        });
+        const dataFile = join(dataDir, '0_0.tigerbeetle');
+        try {
+            const stats = await stat(dataFile);
+            return stats.size;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Dump from connection string — not supported.
+     * TigerBeetle uses a custom binary protocol that doesn't support remote dumps.
+     */
+    async dumpFromConnectionString(_connectionString, _outputPath) {
+        throw new Error('TigerBeetle does not support remote dumps.\n' +
+            'TigerBeetle uses a custom binary protocol that requires direct file access.\n' +
+            'To backup a remote TigerBeetle instance, stop the server and copy the data file directly.');
+    }
+    /**
+     * Create a backup.
+     * TigerBeetle requires the server to be stopped for backup.
+     */
+    async backup(container, outputPath, options) {
+        const { name } = container;
+        const dataDir = paths.getContainerDataPath(name, { engine: ENGINE });
+        // Verify server is stopped
+        const statusResult = await this.status(container);
+        if (statusResult.running) {
+            throw new Error(`TigerBeetle container "${name}" must be stopped before backup. ` +
+                `Run: spindb stop ${name}`);
+        }
+        return createBackup(dataDir, outputPath, options);
+    }
+    /**
+     * Run script — not supported.
+     * TigerBeetle uses a custom binary protocol, not SQL or REST.
+     */
+    async runScript(_container, _options) {
+        throw new Error('TigerBeetle does not support script execution.\n' +
+            'Use the TigerBeetle REPL for interactive operations: spindb connect <container>');
+    }
+    /**
+     * Execute query — not supported.
+     * TigerBeetle uses a custom binary protocol.
+     */
+    async executeQuery(_container, _query, _options) {
+        throw new Error('TigerBeetle does not support SQL or REST queries.\n' +
+            'Use the TigerBeetle REPL for interactive operations: spindb connect <container>\n' +
+            'Or use a TigerBeetle client library in your application.');
+    }
+    /**
+     * List databases — TigerBeetle has no database concept.
+     */
+    async listDatabases(container) {
+        return [container.database];
+    }
+    /**
+     * Create user — not supported.
+     * TigerBeetle has no authentication.
+     */
+    async createUser(_container, _options) {
+        throw new Error('TigerBeetle does not support user authentication.\n' +
+            'Access is controlled at the network level.');
+    }
+}
+export const tigerbeetleEngine = new TigerBeetleEngine();
+//# sourceMappingURL=index.js.map

package/dist/engines/tigerbeetle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../engines/tigerbeetle/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAqB,MAAM,eAAe,CAAA;AACtE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,sBAAsB,IAAI,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACjF,OAAO,EACL,kBAAkB,IAAI,sBAAsB,EAC5C,aAAa,GACd,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAkBvC,MAAM,MAAM,GAAG,aAAa,CAAA;AAC5B,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAE3C;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAE5B,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC/C,IAAI,GAAG,MAAM,CAAA;IACb,WAAW,GAAG,aAAa,CAAA;IAC3B,WAAW,GAAG,SAAS,CAAC,WAAW,CAAA;IACnC,iBAAiB,GAAG,wBAAwB,CAAA;IAE5C,eAAe;QACb,OAAO,eAAe,CAAC,eAAe,EAAE,CAAA;IAC1C,CAAC;IAED,KAAK,CAAC,sBAAsB;QAC1B,OAAO,mBAAmB,EAAE,CAAA;IAC9B,CAAC;IAED,YAAY,CAAC,OAAe,EAAE,QAAkB,EAAE,IAAU;QAC1D,OAAO,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,kBAAkB,CAAC,OAAe;QAChC,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,OAAO,uBAAuB,CAAC,OAAO,CAAC,IAAI,OAAO,CAAA;IACpD,CAAC;IAED,aAAa,CAAC,OAAe;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QACpD,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAA;QACvD,OAAO,KAAK,CAAC,aAAa,CAAC;YACzB,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,CAAC;YACX,IAAI,EAAE,CAAC;SACR,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,MAAM,GAAG,GAAG,eAAe,CAAC,sBAAsB,EAAE,CAAA;QACpD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,EAAE,CAAC,CAAA;QAC5D,OAAO,UAAU,CAAC,UAAU,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAAe;QACrC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAA;QACjD,OAAO,wBAAwB,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;IACtE,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,OAAe,EACf,UAA6B;QAE7B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAA;QAEjD,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,eAAe,CAC5D,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,UAAU,CACX,CAAA;QAED,4BAA4B;QAC5B,MAAM,GAAG,GAAG,eAAe,CAAC,sBAAsB,EAAE,CAAA;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,EAAE,CAAC,CAAA;QAC1D,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,aAAa,CAAC,aAAa,CAAC,aAAa,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;QACvE,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,aAAqB,EACrB,OAAe,EACf,WAAoC,EAAE;QAEtC,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC,aAAa,EAAE;YACxD,MAAM,EAAE,MAAM;SACf,CAAC,CAAA;QAEF,4CAA4C;QAC5C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACzC,QAAQ,CAAC,uCAAuC,OAAO,EAAE,CAAC,CAAA;QAC5D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;QAEjD,wEAAwE;QACxE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,yCAAyC,QAAQ,EAAE,CAAC,CAAA;YAC7D,OAAO,OAAO,CAAA;QAChB,CAAC;QAED,qCAAqC;QACrC,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEhE,qDAAqD;QACrD,QAAQ,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAA;QAEzD,IAAI,CAAC;YACH,YAAY,CACV,iBAAiB,EACjB;gBACE,QAAQ;gBACR,aAAa,kBAAkB,EAAE;gBACjC,aAAa;gBACb,mBAAmB;gBACnB,eAAe;gBACf,QAAQ;aACT,EACD;gBACE,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CACF,CAAA;YACD,QAAQ,CAAC,iDAAiD,QAAQ,EAAE,CAAC,CAAA;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAClE,IAAI,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CACb,iGAAiG;oBAC/F,2EAA2E,CAC9E,CAAA;YACH,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAA;QACnE,CAAC;QAED,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,kBAAkB,CAAC,OAAe;QACtC,2BAA2B;QAC3B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,aAAa,CAAC,aAAa,CAAC,CAAA;QAC/D,IAAI,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,MAAM,CAAA;QACf,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,eAAe,EAAE,CAAA;QACjD,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;QAC7C,MAAM,GAAG,GAAG,eAAe,CAAC,sBAAsB,EAAE,CAAA;QAEpD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC;YAClC,MAAM,EAAE,aAAa;YACrB,OAAO,EAAE,WAAW;YACpB,QAAQ;YACR,IAAI;SACL,CAAC,CAAA;QACF,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,EAAE,CAAC,CAAA;QAEjE,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,OAAO,eAAe,CAAA;QACxB,CAAC;QAED,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,+DAA+D,OAAO,EAAE,CAC/F,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,SAA0B,EAC1B,UAA6B;QAE7B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;QAErD,iDAAiD;QACjD,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE;YAC1D,MAAM,EAAE,MAAM;SACf,CAAC,CAAA;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO;gBACL,IAAI;gBACJ,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC;aACtD,CAAA;QACH,CAAC;QAED,8BAA8B;QAC9B,IAAI,iBAAiB,GAAkB,IAAI,CAAA;QAC3C,MAAM,GAAG,GAAG,eAAe,CAAC,sBAAsB,EAAE,CAAA;QAEpD,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,cAAc,GAAG,EAAE,CAAC,CAAA;YAC/D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,iBAAiB,GAAG,UAAU,CAAA;gBAC9B,QAAQ,CAAC,6BAA6B,iBAAiB,EAAE,CAAC,CAAA;YAC5D,CAAC;QACH,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,iBAAiB,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;YAC5D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,eAAe,GACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACxD,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,+DAA+D,OAAO,IAAI;oBAC9F,qBAAqB,eAAe,EAAE,CACzC,CAAA;YACH,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACrE,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACpE,MAAM,OAAO,GAAG,KAAK,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAA;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;QAEjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,sCAAsC,QAAQ,kDAAkD,CACjG,CAAA;QACH,CAAC;QAED,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAA;QAEvE,QAAQ,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAA;QAEhD,MAAM,IAAI,GAAG;YACX,OAAO;YACP,yBAAyB,IAAI,EAAE;YAC/B,eAAe;YACf,QAAQ;SACT,CAAA;QAED,yDAAyD;QACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAEpC,MAAM,SAAS,GAAiB;YAC9B,GAAG,EAAE,YAAY;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;YAC/B,QAAQ,EAAE,IAAI;SACf,CAAA;QAED,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,SAAS,CAAC,WAAW,GAAG,IAAI,CAAA;QAC9B,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,iBAAkB,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;QACvD,IAAI,CAAC,KAAK,EAAE,CAAA;QAEZ,oDAAoD;QACpD,SAAS,CAAC,KAAK,CAAC,CAAA;QAEhB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;QACxE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;QAED,oDAAoD;QACpD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;QAE3C,IAAI,KAAK,EAAE,CAAC;YACV,kEAAkE;YAClE,+EAA+E;YAC/E,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;gBAC1D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC5C,QAAQ,CACN,0BAA0B,IAAI,CAAC,CAAC,CAAC,2BAA2B,IAAI,CAAC,GAAG,qBAAqB,CAC1F,CAAA;oBACD,MAAM,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC3C,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,+DAA+D;YACjE,CAAC;YAED,OAAO;gBACL,IAAI;gBACJ,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC;aACtD,CAAA;QACH,CAAC;QAED,yDAAyD;QACzD,IAAI,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,MAAM,eAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,sCAAsC;YACxC,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,QAAQ,GAAG,EAAE,CAAA;QACjB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;YACnD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAA;YACzC,IAAI,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CACb,iGAAiG;oBAC/F,2EAA2E,CAC9E,CAAA;YACH,CAAC;YACD,IACE,SAAS,CAAC,QAAQ,CAAC,wBAAwB,CAAC;gBAC5C,SAAS,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAC5C,CAAC;gBACD,QAAQ,GAAG,QAAQ,IAAI,oBAAoB,CAAA;YAC7C,CAAC;QACH,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,0DAA0D;YAC1D,IACE,YAAY,YAAY,KAAK;gBAC7B,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EACzC,CAAC;gBACD,MAAM,YAAY,CAAA;YACpB,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG;YACnB,QAAQ,IAAI,6CAA6C;YACzD,WAAW,iBAAiB,EAAE;YAC9B,aAAa,OAAO,EAAE;SACvB;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAA;QAEb,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;IAC/B,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,YAAY,CACxB,IAAY,EACZ,SAAS,GAAG,KAAK;QAEjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,MAAM,aAAa,GAAG,GAAG,CAAA;QAEzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;YAC1C,oEAAoE;YACpE,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;YACzD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,QAAQ,CAAC,6BAA6B,IAAI,EAAE,CAAC,CAAA;gBAC7C,OAAO,IAAI,CAAA;YACb,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAA;QACpE,CAAC;QAED,QAAQ,CAAC,2CAA2C,SAAS,IAAI,CAAC,CAAA;QAClE,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,SAA0B;QACnC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;QAChC,MAAM,YAAY,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAA;QAErD,QAAQ,CAAC,mCAAmC,IAAI,aAAa,IAAI,EAAE,CAAC,CAAA;QAEpE,IAAI,GAAG,GAAkB,IAAI,CAAA;QAE7B,qBAAqB;QACrB,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;gBAC/C,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;gBAC1D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpB,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;gBACf,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,GAAG,IAAI,eAAe,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,QAAQ,CAAC,+BAA+B,GAAG,EAAE,CAAC,CAAA;YAC9C,IAAI,CAAC;gBACH,IAAI,SAAS,EAAE,EAAE,CAAC;oBAChB,MAAM,eAAe,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;gBACnD,CAAC;qBAAM,CAAC;oBACN,MAAM,eAAe,CAAC,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;oBAClD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;oBAEzD,IAAI,eAAe,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC1C,UAAU,CAAC,8CAA8C,GAAG,EAAE,CAAC,CAAA;wBAC/D,MAAM,eAAe,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;oBACnD,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,8BAA8B,KAAK,EAAE,CAAC,CAAA;YACjD,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,MAAM,eAAe,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;QACjD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAA;QAEpE,mBAAmB;QACnB,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,OAAO,CAAC,CAAA;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,qBAAqB,CAAC,CAAA;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,SAA0B;QACrC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;QAChC,MAAM,YAAY,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,iBAAiB,CAAC,CAAA;QAErD,uBAAuB;QACvB,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;gBAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;gBACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,eAAe,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpE,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,gCAAgC,GAAG,GAAG;qBAChD,CAAA;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;YAC1D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,gCAAgC,IAAI,CAAC,CAAC,CAAC,GAAG;iBACpD,CAAA;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAA;IAClE,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,QAAgB;QACvC,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAA;IACzC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CACX,SAA0B,EAC1B,UAAkB,EAClB,WAAmD,EAAE;QAErD,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;QAE1B,gCAAgC;QAChC,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACjD,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,oCAAoC;gBAChE,oBAAoB,IAAI,EAAE,CAC7B,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAEpE,OAAO,aAAa,CAAC,UAAU,EAAE;YAC/B,aAAa,EAAE,IAAI;YACnB,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,SAA0B,EAAE,SAAkB;QAChE,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;QAC1B,OAAO,aAAa,IAAI,EAAE,CAAA;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,SAA0B,EAAE,SAAkB;QAC1D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,CAAA;QAEnC,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAEhE,MAAM,YAAY,GAAiB;YACjC,KAAK,EAAE,SAAS;SACjB,CAAA;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,KAAK,CAChB,iBAAiB,EACjB;gBACE,MAAM;gBACN,aAAa,kBAAkB,EAAE;gBACjC,yBAAyB,IAAI,EAAE;aAChC,EACD,YAAY,CACb,CAAA;YAED,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YACxB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAClB,UAA2B,EAC3B,SAAiB;QAEjB,MAAM,IAAI,KAAK,CACb,mDAAmD;YACjD,6CAA6C,CAChD,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAChB,UAA2B,EAC3B,SAAiB;QAEjB,MAAM,IAAI,KAAK,CACb,mDAAmD;YACjD,yDAAyD,CAC5D,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,SAA0B;QAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,EAAE;YACzD,MAAM,EAAE,MAAM;SACf,CAAC,CAAA;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;QAEjD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAA;YAClC,OAAO,KAAK,CAAC,IAAI,CAAA;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,wBAAwB,CAC5B,iBAAyB,EACzB,WAAmB;QAEnB,MAAM,IAAI,KAAK,CACb,8CAA8C;YAC5C,+EAA+E;YAC/E,2FAA2F,CAC9F,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CACV,SAA0B,EAC1B,UAAkB,EAClB,OAAsB;QAEtB,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAA;QAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QAEpE,2BAA2B;QAC3B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACjD,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,mCAAmC;gBAC/D,oBAAoB,IAAI,EAAE,CAC7B,CAAA;QACH,CAAC;QAED,OAAO,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAA;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAS,CACb,UAA2B,EAC3B,QAA4D;QAE5D,MAAM,IAAI,KAAK,CACb,kDAAkD;YAChD,iFAAiF,CACpF,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAChB,UAA2B,EAC3B,MAAc,EACd,QAAuB;QAEvB,MAAM,IAAI,KAAK,CACb,qDAAqD;YACnD,mFAAmF;YACnF,0DAA0D,CAC7D,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,SAA0B;QAC5C,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CACd,UAA2B,EAC3B,QAA2B;QAE3B,MAAM,IAAI,KAAK,CACb,qDAAqD;YACnD,4CAA4C,CAC/C,CAAA;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAA"}

package/dist/engines/tigerbeetle/restore.js

@@ -0,0 +1,91 @@
+/**
+ * TigerBeetle restore module
+ * Supports restoring from a TigerBeetle data file backup.
+ *
+ * Restore copies the backup data file into the container's data directory.
+ * The server must be stopped before restore.
+ */
+import { copyFile, mkdir, stat } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { logDebug } from '../../core/error-handler.js';
+/**
+ * Detect backup format from a file path.
+ * TigerBeetle backups are single binary data files.
+ */
+export async function detectBackupFormat(filePath) {
+    if (!existsSync(filePath)) {
+        throw new Error(`Backup file not found: ${filePath}`);
+    }
+    const stats = await stat(filePath);
+    // TigerBeetle data files are regular files (not directories)
+    if (stats.isFile()) {
+        if (filePath.endsWith('.tigerbeetle')) {
+            return {
+                format: 'binary',
+                description: 'TigerBeetle data file',
+                restoreCommand: 'Copy to data directory (spindb restore handles this)',
+            };
+        }
+        // Check for common backup naming patterns
+        return {
+            format: 'binary',
+            description: 'TigerBeetle data file (assumed from file)',
+            restoreCommand: 'Copy to data directory (spindb restore handles this)',
+        };
+    }
+    return {
+        format: 'unknown',
+        description: 'Unknown backup format',
+        restoreCommand: 'Use a TigerBeetle data file (.tigerbeetle) for restore',
+    };
+}
+/**
+ * Restore from a TigerBeetle data file backup.
+ * Copies the backup file into the container's data directory.
+ */
+export async function restoreBackup(backupPath, options) {
+    const { dataDir } = options;
+    if (!existsSync(backupPath)) {
+        throw new Error(`Backup not found: ${backupPath}`);
+    }
+    const format = await detectBackupFormat(backupPath);
+    logDebug(`Detected backup format: ${format.format}`);
+    // Ensure data directory exists
+    if (!existsSync(dataDir)) {
+        await mkdir(dataDir, { recursive: true });
+    }
+    const targetPath = join(dataDir, '0_0.tigerbeetle');
+    logDebug(`Restoring TigerBeetle data file to: ${targetPath}`);
+    await copyFile(backupPath, targetPath);
+    return {
+        format: 'binary',
+        stdout: `Restored TigerBeetle data file to ${targetPath}`,
+        code: 0,
+    };
+}
+/**
+ * Parse TigerBeetle connection string
+ * Format: host:port or 127.0.0.1:port
+ *
+ * TigerBeetle uses a custom binary protocol (no URI scheme).
+ */
+export function parseConnectionString(connectionString) {
+    if (!connectionString || typeof connectionString !== 'string') {
+        throw new Error('Invalid TigerBeetle connection string: expected a non-empty string');
+    }
+    const trimmed = connectionString.trim();
+    // Parse host:port format
+    const parts = trimmed.split(':');
+    if (parts.length !== 2) {
+        throw new Error(`Invalid TigerBeetle connection string: "${trimmed}". ` +
+            'Expected format: host:port (e.g., 127.0.0.1:3000)');
+    }
+    const host = parts[0] || '127.0.0.1';
+    const port = parseInt(parts[1], 10);
+    if (isNaN(port) || port <= 0 || port > 65535) {
+        throw new Error(`Invalid TigerBeetle port: "${parts[1]}". Expected a number between 1 and 65535.`);
+    }
+    return { host, port };
+}
+//# sourceMappingURL=restore.js.map