dbdock 1.1.24 → 1.2.0

package/dist/engines/mysql.engine.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mysqlEngine = void 0;
+const child_process_1 = require("child_process");
+const DUMP_BINARY = 'mysqldump';
+const CLIENT_BINARY = 'mysql';
+const DEFAULT_PORT = 3306;
+const CLIENT_TOOL_HINT = 'Please ensure MySQL/MariaDB client tools are installed:\n  macOS: brew install mysql-client\n  Ubuntu/Debian: sudo apt-get install mysql-client (or mariadb-client)';
+function resolveUser(conn) {
+    return conn.user || conn.username || process.env.DBDOCK_DB_USER || 'root';
+}
+function resolvePassword(conn) {
+    return conn.password || process.env.DBDOCK_DB_PASSWORD;
+}
+function buildEnv(conn) {
+    const password = resolvePassword(conn);
+    return password
+        ? { ...process.env, MYSQL_PWD: password }
+        : { ...process.env };
+}
+function connectionArgs(conn, defaultPort) {
+    return [
+        '-h',
+        conn.host || 'localhost',
+        '-P',
+        String(conn.port || defaultPort),
+        '-u',
+        resolveUser(conn),
+        '--protocol=TCP',
+    ];
+}
+function runQuery(conn, defaultPort, query) {
+    return new Promise((resolve, reject) => {
+        const proc = (0, child_process_1.spawn)(CLIENT_BINARY, [
+            ...connectionArgs(conn, defaultPort),
+            '-N',
+            '-B',
+            '-e',
+            query,
+            conn.database || '',
+        ].filter(Boolean), { env: buildEnv(conn) });
+        let output = '';
+        let errorOutput = '';
+        proc.stdout.on('data', (data) => {
+            output += data.toString();
+        });
+        proc.stderr.on('data', (data) => {
+            errorOutput += data.toString();
+        });
+        proc.on('close', (code) => {
+            if (code === 0)
+                resolve(output.trim());
+            else
+                reject(new Error(errorOutput || `Query failed (${code})`));
+        });
+        proc.on('error', reject);
+    });
+}
+exports.mysqlEngine = {
+    id: 'mysql',
+    label: 'MySQL / MariaDB',
+    defaultPort: DEFAULT_PORT,
+    defaultUser: 'root',
+    clientToolHint: CLIENT_TOOL_HINT,
+    fileExtension() {
+        return 'sql';
+    },
+    spawnDump(conn) {
+        const args = [
+            ...connectionArgs(conn, DEFAULT_PORT),
+            '--single-transaction',
+            '--quick',
+            '--routines',
+            '--triggers',
+            '--events',
+            '--default-character-set=utf8mb4',
+            conn.database || '',
+        ];
+        const process = (0, child_process_1.spawn)(DUMP_BINARY, args, { env: buildEnv(conn) });
+        return { process, stdout: process.stdout };
+    },
+    spawnRestore(conn) {
+        const args = [...connectionArgs(conn, DEFAULT_PORT), conn.database || ''];
+        return (0, child_process_1.spawn)(CLIENT_BINARY, args, { env: buildEnv(conn) });
+    },
+    testConnection(conn) {
+        return new Promise((resolve, reject) => {
+            const proc = (0, child_process_1.spawn)(CLIENT_BINARY, [...connectionArgs(conn, DEFAULT_PORT), '-e', 'SELECT 1'], { env: buildEnv(conn) });
+            let errorOutput = '';
+            proc.stderr.on('data', (data) => {
+                const message = data.toString();
+                if (!message.toLowerCase().includes('[warning]')) {
+                    errorOutput += message;
+                }
+            });
+            proc.on('close', (code) => {
+                if (code === 0)
+                    resolve();
+                else
+                    reject(new Error(`Database connection failed: ${errorOutput || `exit code ${code}`}`));
+            });
+            proc.on('error', (err) => {
+                reject(new Error(`Failed to execute mysql: ${err.message}\n\n${CLIENT_TOOL_HINT}`));
+            });
+        });
+    },
+    async getStats(conn) {
+        const database = conn.database || '';
+        const schemaFilter = database
+            ? `WHERE table_schema = '${database}'`
+            : `WHERE table_schema NOT IN ('mysql','information_schema','performance_schema','sys')`;
+        const [tableCount, sizeMb, rowCount] = await Promise.all([
+            runQuery(conn, DEFAULT_PORT, `SELECT COUNT(*) FROM information_schema.tables ${schemaFilter}`),
+            runQuery(conn, DEFAULT_PORT, `SELECT IFNULL(ROUND(SUM(data_length + index_length) / 1024 / 1024, 2), 0) FROM information_schema.tables ${schemaFilter}`),
+            runQuery(conn, DEFAULT_PORT, `SELECT IFNULL(SUM(table_rows), 0) FROM information_schema.tables ${schemaFilter}`),
+        ]);
+        return {
+            name: database || 'mysql',
+            tables: parseInt(tableCount) || 0,
+            size: sizeMb ? `${sizeMb} MB` : 'Unknown',
+            rows: rowCount ? parseInt(rowCount).toLocaleString() : '0',
+        };
+    },
+    formatDumpError(exitCode, errorMessages, conn) {
+        const errorMessage = errorMessages.join('\n');
+        const lower = errorMessage.toLowerCase();
+        const host = conn.host || 'localhost';
+        const port = conn.port || DEFAULT_PORT;
+        const username = resolveUser(conn);
+        const database = conn.database || '';
+        if (lower.includes('access denied')) {
+            return (`Authentication failed for user "${username}"\n\n` +
+                `Connection details:\n  Host: ${host}\n  Port: ${port}\n  Username: ${username}\n  Database: ${database}\n\n` +
+                `Please verify:\n` +
+                `  • Username and password are correct in dbdock.config.json\n` +
+                `  • User has access to the database from this host`);
+        }
+        if (lower.includes('unknown database')) {
+            return (`Database "${database}" does not exist\n\n` +
+                `Please verify:\n` +
+                `  • Database name is correct in dbdock.config.json\n` +
+                `  • Database exists on the server`);
+        }
+        if (lower.includes("can't connect") ||
+            lower.includes('connection refused') ||
+            lower.includes('econnrefused')) {
+            return (`Cannot connect to MySQL/MariaDB server\n\n` +
+                `Connection details:\n  Host: ${host}\n  Port: ${port}\n\n` +
+                `Please verify:\n` +
+                `  • The server is running\n` +
+                `  • Host and port are correct in dbdock.config.json\n` +
+                `  • Network/firewall allows connection`);
+        }
+        if (errorMessages.length > 0) {
+            return (`mysqldump failed with exit code ${exitCode}\n\n` +
+                `Error details:\n${errorMessage}\n\n` +
+                `Connection settings:\n  Host: ${host}\n  Port: ${port}\n  Username: ${username}\n  Database: ${database}`);
+        }
+        return `mysqldump failed with exit code ${exitCode}. Please check your database configuration.`;
+    },
+    formatRestoreError(errorOutput) {
+        const lower = errorOutput.toLowerCase();
+        if (lower.includes('access denied')) {
+            return ('Database authentication failed\n\n' +
+                'Please verify:\n  • Database username and password are correct\n  • The user has privileges on the target database');
+        }
+        if (lower.includes("can't connect") ||
+            lower.includes('connection refused')) {
+            return ('Failed to connect to database\n\n' +
+                'Please verify:\n  • The server is running\n  • Host and port are correct\n  • Firewall allows connection to the database port');
+        }
+        if (lower.includes('unknown database')) {
+            return ('Target database does not exist\n\n' +
+                'Please:\n  • Create the database first, or\n  • Update the database name in dbdock.config.json');
+        }
+        return `Database restore error:\n\n${errorOutput.trim()}`;
+    },
+    shouldIgnoreRestoreMessage(message) {
+        const lower = message.toLowerCase();
+        return (lower.includes('[warning]') ||
+            lower.includes('using a password on the command line'));
+    },
+};
+//# sourceMappingURL=mysql.engine.js.map

package/dist/engines/mysql.engine.js.map

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

package/dist/engines/postgres.engine.d.ts

@@ -0,0 +1,2 @@
+import { DatabaseEngine } from './engine.types';
+export declare const postgresEngine: DatabaseEngine;

package/dist/engines/postgres.engine.js

@@ -0,0 +1,257 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.postgresEngine = void 0;
+const child_process_1 = require("child_process");
+const DEFAULT_PORT = 5432;
+const CLIENT_TOOL_HINT = 'Please ensure PostgreSQL client tools are installed:\n  macOS: brew install postgresql\n  Ubuntu/Debian: sudo apt-get install postgresql-client';
+const FORMAT_FLAG = {
+    custom: 'c',
+    plain: 'p',
+    directory: 'd',
+    tar: 't',
+};
+const EXTENSION = {
+    custom: 'sql',
+    plain: 'sql',
+    directory: 'dir',
+    tar: 'tar',
+};
+function resolveUser(conn) {
+    return conn.user || conn.username || process.env.DBDOCK_DB_USER || 'postgres';
+}
+function resolvePassword(conn) {
+    return conn.password || process.env.DBDOCK_DB_PASSWORD;
+}
+function buildEnv(conn) {
+    const password = resolvePassword(conn);
+    return password
+        ? { ...process.env, PGPASSWORD: password }
+        : { ...process.env };
+}
+const RESTORE_IGNORE_PATTERNS = [
+    'NOTICE',
+    'WARNING',
+    'transaction_timeout',
+    'errors ignored on restore',
+    'unrecognized configuration parameter',
+    'already exists',
+    'does not exist',
+    'no privileges could be revoked',
+    'no privileges were granted',
+    'role .* does not exist',
+    'extension .* already exists',
+    'schema .* already exists',
+    'procedural language .* already exists',
+];
+exports.postgresEngine = {
+    id: 'postgresql',
+    label: 'PostgreSQL',
+    defaultPort: DEFAULT_PORT,
+    defaultUser: 'postgres',
+    clientToolHint: CLIENT_TOOL_HINT,
+    fileExtension(format = 'custom') {
+        return EXTENSION[format] || 'sql';
+    },
+    spawnDump(conn, options) {
+        const format = options.format || 'custom';
+        const args = [
+            '-h',
+            conn.host || 'localhost',
+            '-p',
+            String(conn.port || DEFAULT_PORT),
+            '-U',
+            resolveUser(conn),
+            '-d',
+            conn.database || 'postgres',
+            '-F',
+            FORMAT_FLAG[format] || 'c',
+            '--no-password',
+        ];
+        const process = (0, child_process_1.spawn)('pg_dump', args, { env: buildEnv(conn) });
+        return { process, stdout: process.stdout };
+    },
+    spawnRestore(conn) {
+        const args = [
+            '-h',
+            conn.host || 'localhost',
+            '-p',
+            String(conn.port || DEFAULT_PORT),
+            '-U',
+            resolveUser(conn),
+            '-d',
+            conn.database || 'postgres',
+            '-F',
+            'c',
+            '--clean',
+            '--if-exists',
+            '--no-owner',
+            '--no-acl',
+            '--no-password',
+        ];
+        return (0, child_process_1.spawn)('pg_restore', args, { env: buildEnv(conn) });
+    },
+    testConnection(conn) {
+        const args = [
+            '-h',
+            conn.host || 'localhost',
+            '-p',
+            String(conn.port || DEFAULT_PORT),
+            '-U',
+            resolveUser(conn),
+            '-d',
+            conn.database || 'postgres',
+            '-c',
+            'SELECT 1',
+            '--no-password',
+        ];
+        return new Promise((resolve, reject) => {
+            const proc = (0, child_process_1.spawn)('psql', args, { env: buildEnv(conn) });
+            let hasError = false;
+            proc.stderr.on('data', (data) => {
+                const message = data.toString();
+                if (!message.includes('NOTICE')) {
+                    hasError = true;
+                    reject(new Error(`Database connection failed: ${message}`));
+                }
+            });
+            proc.on('close', (code) => {
+                if (hasError)
+                    return;
+                if (code === 0)
+                    resolve();
+                else
+                    reject(new Error(`Database connection failed (exit code ${code})`));
+            });
+            proc.on('error', (err) => {
+                reject(new Error(`Failed to execute psql: ${err.message}\n\n${CLIENT_TOOL_HINT}`));
+            });
+        });
+    },
+    async getStats(conn) {
+        const database = conn.database || 'postgres';
+        const queries = [
+            `SELECT count(*) as table_count FROM information_schema.tables WHERE table_schema = 'public'`,
+            `SELECT pg_size_pretty(pg_database_size('${database}')) as size`,
+            `SELECT sum(n_live_tup) as total_rows FROM pg_stat_user_tables`,
+        ];
+        const baseArgs = [
+            '-h',
+            conn.host || 'localhost',
+            '-p',
+            String(conn.port || DEFAULT_PORT),
+            '-U',
+            resolveUser(conn),
+            '-d',
+            database,
+            '-t',
+            '--no-password',
+        ];
+        const env = buildEnv(conn);
+        const results = await Promise.all(queries.map((query) => new Promise((resolve, reject) => {
+            const proc = (0, child_process_1.spawn)('psql', [...baseArgs, '-c', query], { env });
+            let output = '';
+            let errorOutput = '';
+            proc.stdout.on('data', (data) => {
+                output += data.toString();
+            });
+            proc.stderr.on('data', (data) => {
+                errorOutput += data.toString();
+            });
+            proc.on('close', (code) => {
+                if (code === 0)
+                    resolve(output.trim());
+                else
+                    reject(new Error(errorOutput || `Query failed (${code})`));
+            });
+            proc.on('error', reject);
+        })));
+        return {
+            name: database,
+            tables: parseInt(results[0]) || 0,
+            size: results[1] || 'Unknown',
+            rows: results[2] ? parseInt(results[2]).toLocaleString() : '0',
+        };
+    },
+    formatDumpError(exitCode, errorMessages, conn) {
+        const errorMessage = errorMessages.join('\n');
+        const host = conn.host || 'localhost';
+        const port = conn.port || DEFAULT_PORT;
+        const username = resolveUser(conn);
+        const database = conn.database || 'postgres';
+        if (errorMessage.includes('database') &&
+            errorMessage.includes('does not exist')) {
+            const dbMatch = errorMessage.match(/database "([^"]+)" does not exist/);
+            const dbName = dbMatch ? dbMatch[1] : database;
+            return (`Database "${dbName}" does not exist\n\n` +
+                `Connection details:\n  Host: ${host}\n  Port: ${port}\n  Database: ${dbName}\n\n` +
+                `Please verify:\n` +
+                `  • Database name is correct in dbdock.config.json\n` +
+                `  • Database exists on the server\n` +
+                `  • You can connect: psql -h ${host} -p ${port} -U ${username} -d ${dbName}`);
+        }
+        if (errorMessage.includes('could not connect') ||
+            errorMessage.includes('Connection refused') ||
+            errorMessage.includes('ECONNREFUSED')) {
+            return (`Cannot connect to PostgreSQL server\n\n` +
+                `Connection details:\n  Host: ${host}\n  Port: ${port}\n\n` +
+                `Please verify:\n` +
+                `  • PostgreSQL server is running\n` +
+                `  • Host and port are correct in dbdock.config.json\n` +
+                `  • Network/firewall allows connection\n` +
+                `  • Test connection: psql -h ${host} -p ${port} -U ${username} -d ${database}`);
+        }
+        if (errorMessage.includes('authentication failed') ||
+            errorMessage.includes('password authentication failed')) {
+            return (`Authentication failed for user "${username}"\n\n` +
+                `Connection details:\n  Host: ${host}\n  Port: ${port}\n  Username: ${username}\n  Database: ${database}\n\n` +
+                `Please verify:\n` +
+                `  • Username and password are correct in dbdock.config.json\n` +
+                `  • User exists and has access to the database`);
+        }
+        if (errorMessage.includes('permission denied')) {
+            return (`Permission denied for user "${username}"\n\n` +
+                `The user does not have sufficient privileges to perform backup.\n\n` +
+                `Please verify:\n` +
+                `  • User has read permissions on the database\n` +
+                `  • Grant access: GRANT SELECT ON ALL TABLES IN SCHEMA public TO ${username};`);
+        }
+        if (errorMessages.length > 0) {
+            return (`pg_dump failed with exit code ${exitCode}\n\n` +
+                `Error details:\n${errorMessage}\n\n` +
+                `Connection settings:\n  Host: ${host}\n  Port: ${port}\n  Username: ${username}\n  Database: ${database}`);
+        }
+        return `pg_dump failed with exit code ${exitCode}. Please check your database configuration.`;
+    },
+    formatRestoreError(errorOutput) {
+        const lowerError = errorOutput.toLowerCase();
+        if (lowerError.includes('authentication failed')) {
+            return ('Database authentication failed\n\n' +
+                'Please verify:\n  • Database password is correct\n  • Database user has necessary permissions\n  • Database host and port are accessible');
+        }
+        if (lowerError.includes('connection refused') ||
+            lowerError.includes('could not connect')) {
+            return ('Failed to connect to database\n\n' +
+                'Please verify:\n  • Database server is running\n  • Host and port are correct\n  • Firewall allows connection to the database port');
+        }
+        if (lowerError.includes('permission denied')) {
+            return ('Database permission denied\n\n' +
+                'Please verify:\n  • Database user has CREATE/DROP privileges\n  • Try using a superuser account for restore');
+        }
+        if (lowerError.includes('database') &&
+            lowerError.includes('does not exist')) {
+            return ('Target database does not exist\n\n' +
+                'Please:\n  • Create the database first, or\n  • Update database name in dbdock.config.json');
+        }
+        if (lowerError.includes('corrupted') ||
+            lowerError.includes('invalid backup')) {
+            return ('Backup file appears to be corrupted\n\n' +
+                'Please:\n  • Try a different backup file\n  • Verify the encryption key matches if encryption is enabled');
+        }
+        return `Database restore error:\n\n${errorOutput.trim()}`;
+    },
+    shouldIgnoreRestoreMessage(message) {
+        const lower = message.toLowerCase();
+        return RESTORE_IGNORE_PATTERNS.some((pattern) => lower.includes(pattern.toLowerCase()));
+    },
+};
+//# sourceMappingURL=postgres.engine.js.map

package/dist/engines/postgres.engine.js.map

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

package/dist/engines/redis-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/engines/redis-worker.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ioredis_1 = __importDefault(require("ioredis"));
+const MODE = process.argv[2];
+const HEADER_BYTES = 4;
+const TTL_BYTES = 8;
+function buildClient() {
+    return new ioredis_1.default({
+        host: process.env.DBDOCK_REDIS_HOST || 'localhost',
+        port: parseInt(process.env.DBDOCK_REDIS_PORT || '6379', 10),
+        username: process.env.DBDOCK_REDIS_USERNAME || undefined,
+        password: process.env.DBDOCK_REDIS_PASSWORD || undefined,
+        db: parseInt(process.env.DBDOCK_REDIS_DB || '0', 10),
+        maxRetriesPerRequest: 1,
+        lazyConnect: true,
+    });
+}
+function writeAsync(chunk) {
+    return new Promise((resolve, reject) => {
+        process.stdout.write(chunk, (err) => (err ? reject(err) : resolve()));
+    });
+}
+function frame(key, ttlMs, payload) {
+    const head = Buffer.alloc(HEADER_BYTES + TTL_BYTES + HEADER_BYTES);
+    head.writeUInt32BE(key.length, 0);
+    head.writeBigInt64BE(BigInt(ttlMs), HEADER_BYTES);
+    head.writeUInt32BE(payload.length, HEADER_BYTES + TTL_BYTES);
+    return Buffer.concat([head, key, payload]);
+}
+async function dump() {
+    const client = buildClient();
+    await client.connect();
+    const stream = client.scanBufferStream({ count: 500 });
+    for await (const keys of stream) {
+        for (const key of keys) {
+            const payload = (await client.callBuffer('DUMP', key));
+            if (!payload)
+                continue;
+            const pttl = await client.pttl(key);
+            const ttlMs = pttl > 0 ? pttl : 0;
+            await writeAsync(frame(key, ttlMs, payload));
+        }
+    }
+    await client.quit();
+}
+async function restore() {
+    const client = buildClient();
+    await client.connect();
+    let buffer = Buffer.alloc(0);
+    const pending = [];
+    for await (const chunk of process.stdin) {
+        buffer = Buffer.concat([buffer, chunk]);
+        let offset = 0;
+        while (buffer.length - offset >= HEADER_BYTES + TTL_BYTES + HEADER_BYTES) {
+            const keyLen = buffer.readUInt32BE(offset);
+            const ttlMs = Number(buffer.readBigInt64BE(offset + HEADER_BYTES));
+            const payloadLen = buffer.readUInt32BE(offset + HEADER_BYTES + TTL_BYTES);
+            const total = HEADER_BYTES + TTL_BYTES + HEADER_BYTES + keyLen + payloadLen;
+            if (buffer.length - offset < total)
+                break;
+            const keyStart = offset + HEADER_BYTES + TTL_BYTES + HEADER_BYTES;
+            const key = buffer.subarray(keyStart, keyStart + keyLen);
+            const payload = buffer.subarray(keyStart + keyLen, keyStart + keyLen + payloadLen);
+            pending.push(client.callBuffer('RESTORE', key, String(ttlMs), payload, 'REPLACE'));
+            offset = keyStart + keyLen + payloadLen;
+        }
+        buffer = buffer.subarray(offset);
+    }
+    await Promise.all(pending);
+    await client.quit();
+}
+const run = MODE === 'restore' ? restore : dump;
+run().catch((err) => {
+    process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=redis-worker.js.map

package/dist/engines/redis-worker.js.map

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

package/dist/engines/redis.engine.d.ts

@@ -0,0 +1,2 @@
+import { DatabaseEngine } from './engine.types';
+export declare const redisEngine: DatabaseEngine;