smoonb 1.0.6 → 1.0.8

package/package.json

@@ -1,66 +1,68 @@
-{
-  "name": "smoonb",
-  "version": "1.0.6",
-  "description": "Complete Supabase backup and migration tool. https://www.smoonb.com/#price",
-  "preferGlobal": false,
-  "preventGlobalInstall": true,
-  "main": "index.js",
-  "bin": {
-    "smoonb": "bin/smoonb.js"
-  },
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "start": "node bin/smoonb.js",
-    "preinstall": "node -e \"if(process.env.npm_config_global) { console.error('\\n❌ SMOONB NÃO DEVE SER INSTALADO GLOBALMENTE!\\n\\n📋 Para usar o smoonb, instale localmente no seu projeto:\\n   npm install smoonb\\n\\n💡 Depois execute com:\\n   npx smoonb backup\\n\\n🚫 Instalação global cancelada!\\n'); process.exit(1); }\"",
-    "postinstall": "echo '\\n✅ smoonb instalado com sucesso!\\n💡 Execute: npx smoonb backup\\n📖 Documentação: https://github.com/almmello/smoonb\\n'",
-    "lint": "eslint . --ext .js",
-    "lint:fix": "eslint . --ext .js --fix",
-    "build": "node scripts/build.js",
-    "build:check": "node scripts/build.js",
-    "prepublishOnly": "node scripts/build.js"
-  },
-  "keywords": [
-    "supabase",
-    "backup",
-    "migration",
-    "postgresql",
-    "edge-functions",
-    "database",
-    "cli",
-    "tool"
-  ],
-  "author": "Goalmoon Tecnologia LTDA <https://www.smoonb.com>",
-  "license": "SEE LICENSE IN LICENSE.md",
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "dependencies": {
-    "@supabase/supabase-js": "^2.93.0",
-    "adm-zip": "^0.5.16",
-    "chalk": "^4.1.2",
-    "commander": "^11.1.0",
-    "env-paths": "^4.0.0",
-    "inquirer": "^8.2.7"
-  },
-  "type": "commonjs",
-  "devDependencies": {
-    "eslint": "^9.38.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/almmello/smoonb.git"
-  },
-  "bugs": {
-    "url": "https://github.com/almmello/smoonb/issues"
-  },
-  "homepage": "https://www.smoonb.com",
-  "files": [
-    "bin/",
-    "src/",
-    "README.md",
-    "README.pt-BR.md",
-    "LICENSE",
-    "LICENSE.pt-BR.md",
-    "CHANGELOG.md"
-  ]
-}
+{
+  "name": "smoonb",
+  "version": "1.0.8",
+  "description": "Complete Supabase backup and migration tool. https://www.smoonb.com/#price",
+  "preferGlobal": false,
+  "preventGlobalInstall": true,
+  "main": "index.js",
+  "bin": {
+    "smoonb": "bin/smoonb.js"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.js",
+    "start": "node bin/smoonb.js",
+    "preinstall": "node -e \"if(process.env.npm_config_global) { console.error('\\n❌ SMOONB NÃO DEVE SER INSTALADO GLOBALMENTE!\\n\\n📋 Para usar o smoonb, instale localmente no seu projeto:\\n   npm install smoonb\\n\\n💡 Depois execute com:\\n   npx smoonb backup\\n\\n🚫 Instalação global cancelada!\\n'); process.exit(1); }\"",
+    "postinstall": "echo '\\n✅ smoonb instalado com sucesso!\\n💡 Execute: npx smoonb backup\\n📖 Documentação: https://github.com/almmello/smoonb\\n'",
+    "lint": "eslint . --ext .js",
+    "lint:fix": "eslint . --ext .js --fix",
+    "build": "node scripts/build.js",
+    "build:check": "node scripts/build.js",
+    "prepublishOnly": "npm test && npm run lint && npm run build",
+    "test:docker": "node tests/integration/circular-restore.js",
+    "test:restore:docker": "node tests/integration/verified-restore.js"
+  },
+  "keywords": [
+    "supabase",
+    "backup",
+    "migration",
+    "postgresql",
+    "edge-functions",
+    "database",
+    "cli",
+    "tool"
+  ],
+  "author": "Goalmoon Tecnologia LTDA <https://www.smoonb.com>",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.93.0",
+    "adm-zip": "^0.5.16",
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "env-paths": "^4.0.0",
+    "inquirer": "^8.2.7"
+  },
+  "type": "commonjs",
+  "devDependencies": {
+    "eslint": "^9.38.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/almmello/smoonb.git"
+  },
+  "bugs": {
+    "url": "https://github.com/almmello/smoonb/issues"
+  },
+  "homepage": "https://www.smoonb.com",
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "README.pt-BR.md",
+    "LICENSE",
+    "LICENSE.pt-BR.md",
+    "CHANGELOG.md"
+  ]
+}

package/src/commands/backup/index.js

@@ -267,7 +267,9 @@ module.exports = async (options) => {
     const dbSeparatedResult = await step03DatabaseSeparated(context);
     manifest.components.database_separated = {
       success: dbSeparatedResult.success,
-      method: 'supabase-cli',
+      method: 'supabase-cli',
+      warnings: dbSeparatedResult.warnings || [],
+      failed_files: dbSeparatedResult.failedFiles || [],
       files: dbSeparatedResult.files || [],
       total_size_kb: dbSeparatedResult.totalSizeKB || '0.0'
     };
@@ -339,7 +341,11 @@ module.exports = async (options) => {
     console.log(chalk.green(`\n🎉 ${getT('backup.complete.title')}`));
     console.log(chalk.blue(`📁 ${getT('backup.complete.location', { path: finalBackupDir })}`));
     console.log(chalk.green(`📊 ${getT('backup.complete.database', { fileName: databaseResult.fileName, size: `${databaseResult.size} KB` })}`));
-    console.log(chalk.green(`📊 ${getT('backup.complete.databaseSql', { count: dbSeparatedResult.files?.length || 0, size: `${dbSeparatedResult.totalSizeKB} KB` })}`));
+    if (dbSeparatedResult.success) {
+      console.log(chalk.green(`📊 ${getT('backup.complete.databaseSql', { count: dbSeparatedResult.files?.length || 0, size: `${dbSeparatedResult.totalSizeKB} KB` })}`));
+    } else {
+      console.log(chalk.yellow(`⚠️ ${getT('backup.steps.database.separated.incomplete', { files: (dbSeparatedResult.failedFiles || []).join(', ') })}`));
+    }
     console.log(chalk.green(`🔧 ${getT('backup.complete.databaseSettings', { fileName: databaseSettingsResult.fileName, size: `${databaseSettingsResult.size} KB` })}`));
     
     if (flags?.includeAuth && manifest.components.auth_settings) {

package/src/commands/backup/steps/03-database-separated.js

@@ -1,114 +1,161 @@
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs').promises;
-const { spawn } = require('child_process');
-const { t } = require('../../../i18n');
-
-function runWithElapsedTicker(command, args, env, label) {
-  return new Promise((resolve, reject) => {
-    const start = Date.now();
-    const ticker = setInterval(() => {
-      const elapsed = Math.floor((Date.now() - start) / 1000);
-      process.stdout.write(`\r     ⏱ ${label} ${elapsed}s`);
-    }, 1000);
-    const proc = spawn(command, args, {
-      stdio: ['ignore', 'pipe', 'pipe'],
-      shell: true,
-      env: { ...process.env, ...env }
-    });
-    proc.stderr.on('data', (chunk) => process.stderr.write(chunk));
-    proc.on('close', (code) => {
-      clearInterval(ticker);
-      process.stdout.write('\r' + ' '.repeat(60) + '\r');
-      if (code !== 0) reject(new Error(`Exited with code ${code}`));
-      else resolve();
-    });
-    proc.on('error', reject);
-  });
-}
-
-/**
- * Etapa 2: Backup Database Separado (SQL files para troubleshooting)
- */
-module.exports = async ({ databaseUrl, backupDir, accessToken }) => {
-  try {
-    const getT = global.smoonbI18n?.t || t;
-    console.log(chalk.white(`   - ${getT('backup.steps.database.separated.creating')}`));
-    
-    const dbUrl = databaseUrl;
-    const files = [];
-    let totalSizeKB = 0;
-    
-    // 1. Backup do Schema
-    console.log(chalk.white(`   - ${getT('backup.steps.database.separated.exportingSchema')}`));
-    const schemaFile = path.join(backupDir, 'schema.sql');
-    
-    try {
-      await runWithElapsedTicker(
-        `supabase db dump --db-url "${dbUrl}" -f "${schemaFile}"`,
-        [],
-        { SUPABASE_ACCESS_TOKEN: accessToken || '' },
-        getT('backup.steps.database.separated.exportingSchema')
-      );
-      const stats = await fs.stat(schemaFile);
-      const sizeKB = (stats.size / 1024).toFixed(1);
-      files.push({ filename: 'schema.sql', sizeKB });
-      totalSizeKB += parseFloat(sizeKB);
-      console.log(chalk.green(`     ✅ Schema: ${sizeKB} KB`));
-    } catch (error) {
-      console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.database.separated.schemaError', { message: error.message })}`));
-    }
-    
-    // 2. Backup dos Dados
-    console.log(chalk.white(`   - ${getT('backup.steps.database.separated.exportingData')}`));
-    const dataFile = path.join(backupDir, 'data.sql');
-    
-    try {
-      await runWithElapsedTicker(
-        `supabase db dump --db-url "${dbUrl}" --data-only -f "${dataFile}"`,
-        [],
-        { SUPABASE_ACCESS_TOKEN: accessToken || '' },
-        getT('backup.steps.database.separated.exportingData')
-      );
-      const stats = await fs.stat(dataFile);
-      const sizeKB = (stats.size / 1024).toFixed(1);
-      files.push({ filename: 'data.sql', sizeKB });
-      totalSizeKB += parseFloat(sizeKB);
-      console.log(chalk.green(`     ✅ Data: ${sizeKB} KB`));
-    } catch (error) {
-      console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.database.separated.dataError', { message: error.message })}`));
-    }
-    
-    // 3. Backup dos Roles
-    console.log(chalk.white(`   - ${getT('backup.steps.database.separated.exportingRoles')}`));
-    const rolesFile = path.join(backupDir, 'roles.sql');
-    
-    try {
-      await runWithElapsedTicker(
-        `supabase db dump --db-url "${dbUrl}" --role-only -f "${rolesFile}"`,
-        [],
-        { SUPABASE_ACCESS_TOKEN: accessToken || '' },
-        getT('backup.steps.database.separated.exportingRoles')
-      );
-      const stats = await fs.stat(rolesFile);
-      const sizeKB = (stats.size / 1024).toFixed(1);
-      files.push({ filename: 'roles.sql', sizeKB });
-      totalSizeKB += parseFloat(sizeKB);
-      console.log(chalk.green(`     ✅ Roles: ${sizeKB} KB`));
-    } catch (error) {
-      console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.database.separated.rolesError', { message: error.message })}`));
-    }
-    
-    return { 
-      success: files.length > 0, 
-      files, 
-      totalSizeKB: totalSizeKB.toFixed(1) 
-    };
-    
-  } catch (error) {
-    const getT = global.smoonbI18n?.t || t;
-    console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.database.separated.error', { message: error.message })}`));
-    return { success: false, files: [], totalSizeKB: '0.0' };
-  }
-};
-
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs').promises;
+const { spawn } = require('child_process');
+const { t } = require('../../../i18n');
+const { createPgDumpDiagnostics, hasReplicaRolePrologue } = require('../../../utils/pg-dump-diagnostics');
+
+function runWithElapsedTicker(command, args, env, label, collectWarnings = false) {
+  return new Promise((resolve, reject) => {
+    const start = Date.now();
+    const useTty = Boolean(process.stdout.isTTY);
+    const clearTicker = () => {
+      if (useTty) process.stdout.write('\r' + ' '.repeat(80) + '\r');
+    };
+    const diagnostics = createPgDumpDiagnostics(chunk => {
+      clearTicker();
+      process.stderr.write(chunk);
+    });
+    const ticker = useTty ? setInterval(() => {
+      const elapsed = Math.floor((Date.now() - start) / 1000);
+      process.stdout.write(`\r     ⏱ ${label} ${elapsed}s`);
+    }, 1000) : null;
+    let settled = false;
+    const finish = (error) => {
+      if (settled) return;
+      settled = true;
+      clearInterval(ticker);
+      clearTicker();
+      const result = diagnostics.end();
+      if (error) {
+        // A failed export must never hide the diagnostics already collected.
+        if (result.messages.length) process.stderr.write(result.messages.join('\n') + '\n');
+        reject(error);
+      } else resolve(result);
+    };
+    try {
+      const proc = spawn(command, args, {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: true,
+        env: { ...process.env, ...env }
+      });
+      // Drain stdout as well, so a verbose CLI cannot fill its pipe and hang.
+      proc.stdout.on('data', chunk => { clearTicker(); process.stdout.write(chunk); });
+      proc.stderr.on('data', chunk => {
+        if (collectWarnings) diagnostics.write(chunk);
+        else { clearTicker(); process.stderr.write(chunk); }
+      });
+      proc.on('close', code => finish(code === 0 ? null : new Error(`Exited with code ${code}`)));
+      proc.on('error', finish);
+    } catch (error) {
+      finish(error);
+    }
+  });
+}
+
+/**
+ * Etapa 2: Backup Database Separado (SQL files para troubleshooting)
+ */
+function createDatabaseSeparatedStep(runDump = runWithElapsedTicker) {
+  return async ({ databaseUrl, backupDir, accessToken }) => {
+    try {
+      const getT = global.smoonbI18n?.t || t;
+      console.log(chalk.white(`   - ${getT('backup.steps.database.separated.creating')}`));
+
+      const dbUrl = databaseUrl;
+      const files = [];
+      let totalSizeKB = 0;
+      const warnings = [];
+      const failedFiles = [];
+
+      // 1. Backup do Schema
+      console.log(chalk.white(`   - ${getT('backup.steps.database.separated.exportingSchema')}`));
+      const schemaFile = path.join(backupDir, 'schema.sql');
+
+      try {
+        await runDump(
+          `supabase db dump --db-url "${dbUrl}" -f "${schemaFile}"`,
+          [],
+          { SUPABASE_ACCESS_TOKEN: accessToken || '' },
+          getT('backup.steps.database.separated.exportingSchema')
+        );
+        const stats = await fs.stat(schemaFile);
+        const sizeKB = (stats.size / 1024).toFixed(1);
+        files.push({ filename: 'schema.sql', sizeKB });
+        totalSizeKB += parseFloat(sizeKB);
+        console.log(chalk.green(`     ✅ Schema: ${sizeKB} KB`));
+      } catch (error) {
+        failedFiles.push('schema.sql');
+        console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.database.separated.schemaError', { message: error.message })}`));
+      }
+
+      // 2. Backup dos Dados
+      console.log(chalk.white(`   - ${getT('backup.steps.database.separated.exportingData')}`));
+      const dataFile = path.join(backupDir, 'data.sql');
+
+      try {
+        const diagnostics = await runDump(
+          `supabase db dump --db-url "${dbUrl}" --data-only -f "${dataFile}"`,
+          [],
+          { SUPABASE_ACCESS_TOKEN: accessToken || '' },
+          getT('backup.steps.database.separated.exportingData'),
+          true
+        );
+        const stats = await fs.stat(dataFile);
+        if (diagnostics.circularForeignKeys) {
+          const replicaRolePrologue = await hasReplicaRolePrologue(dataFile);
+          warnings.push({ code: 'CIRCULAR_FOREIGN_KEYS', ...diagnostics, replicaRolePrologue });
+          console.log(chalk.cyan(`     ℹ️ ${getT('backup.steps.database.separated.circularSummary', { tables: diagnostics.tables.join(', ') })}`));
+          console.log(chalk.yellow(`     ⚠️ ${getT(replicaRolePrologue
+            ? 'backup.steps.database.separated.circularProtected'
+            : 'backup.steps.database.separated.circularUnprotected')}`));
+        }
+        const sizeKB = (stats.size / 1024).toFixed(1);
+        files.push({ filename: 'data.sql', sizeKB });
+        totalSizeKB += parseFloat(sizeKB);
+        console.log(chalk.green(`     ✅ Data: ${sizeKB} KB`));
+      } catch (error) {
+        failedFiles.push('data.sql');
+        console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.database.separated.dataError', { message: error.message })}`));
+      }
+
+      // 3. Backup dos Roles
+      console.log(chalk.white(`   - ${getT('backup.steps.database.separated.exportingRoles')}`));
+      const rolesFile = path.join(backupDir, 'roles.sql');
+
+      try {
+        await runDump(
+          `supabase db dump --db-url "${dbUrl}" --role-only -f "${rolesFile}"`,
+          [],
+          { SUPABASE_ACCESS_TOKEN: accessToken || '' },
+          getT('backup.steps.database.separated.exportingRoles')
+        );
+        const stats = await fs.stat(rolesFile);
+        const sizeKB = (stats.size / 1024).toFixed(1);
+        files.push({ filename: 'roles.sql', sizeKB });
+        totalSizeKB += parseFloat(sizeKB);
+        console.log(chalk.green(`     ✅ Roles: ${sizeKB} KB`));
+      } catch (error) {
+        failedFiles.push('roles.sql');
+        console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.database.separated.rolesError', { message: error.message })}`));
+      }
+
+      return {
+        success: files.length === 3,
+        warnings,
+        failedFiles,
+        files,
+        totalSizeKB: totalSizeKB.toFixed(1)
+      };
+
+    } catch (error) {
+      const getT = global.smoonbI18n?.t || t;
+      console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.database.separated.error', { message: error.message })}`));
+      return { success: false, files: [], warnings: [], failedFiles: ['schema.sql', 'data.sql', 'roles.sql'], totalSizeKB: '0.0' };
+    }
+  };
+}
+
+module.exports = createDatabaseSeparatedStep();
+module.exports.createDatabaseSeparatedStep = createDatabaseSeparatedStep;
+module.exports.runWithElapsedTicker = runWithElapsedTicker;

package/src/commands/backup/steps/06-realtime-settings.js

@@ -1,33 +1,19 @@
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs').promises;
-const { captureRealtimeSettings } = require('../../../utils/realtime-settings');
-const { t } = require('../../../i18n');
-
-/**
- * Etapa 5: Backup Realtime Settings via Captura Interativa
- */
-module.exports = async ({ projectId, backupDir, options }) => {
-  try {
-    const getT = global.smoonbI18n?.t || t;
-    console.log(chalk.white(`   - ${getT('backup.steps.realtime.capturing')}`));
-    
-    const result = await captureRealtimeSettings(projectId, backupDir, options?.skipRealtime);
-
-    const settings = result.settings !== undefined ? result.settings : result;
-    const source = result.source || 'interactive';
-    const reusedFrom = result.reusedFrom || null;
-
-    const stats = await fs.stat(path.join(backupDir, 'realtime-settings.json'));
-    const sizeKB = (stats.size / 1024).toFixed(1);
-
-    console.log(chalk.green(`     ✅ Realtime Settings capturadas: ${sizeKB} KB`));
-
-    return { success: true, settings, source, reusedFrom };
-  } catch (error) {
-    const getT = global.smoonbI18n?.t || t;
-    console.log(chalk.yellow(`     ⚠️ ${getT('backup.steps.realtime.error', { message: error.message })}`));
-    return { success: false };
-  }
-};
-
+const path = require('path');
+const fs = require('fs').promises;
+const { management } = require('../../restore/management');
+module.exports = async ({ projectId, accessToken, backupDir }) => {
+  try {
+    const settings = await management(
+      { targetProjectId: projectId, targetAccessToken: accessToken },
+      'config/realtime',
+    );
+    const captured_at = new Date().toISOString();
+    await fs.writeFile(
+      path.join(backupDir, 'realtime-settings.json'),
+      JSON.stringify({ project_id: projectId, captured_at, settings }, null, 2),
+    );
+    return { success: true, settings, source: 'management-api', captured_at };
+  } catch {
+    return { success: false, reason: 'realtime_api_capture_failed' };
+  }
+};

package/src/commands/backup/steps/07-storage.js

@@ -106,18 +106,13 @@ module.exports = async ({ projectId, accessToken, backupDir, supabaseUrl, supaba
       try {
         console.log(chalk.white(`   - ${getT('backup.steps.storage.processing', { bucketName: bucket.name })}`));
 
-        const objectsResponse = await fetch(`https://api.supabase.com/v1/projects/${projectId}/storage/buckets/${bucket.name}/objects`, {
-          headers: {
-            'Authorization': `Bearer ${accessToken}`,
-            'Content-Type': 'application/json'
-          }
-        });
-
-        let objects = [];
-        if (objectsResponse.ok) {
-          objects = await objectsResponse.json();
-        }
-
+        const { readDump, records } = require('../../restore/dump');
+        const dumpFile = (await fs.readdir(backupDir)).find(f => /\.backup(?:\.gz)?$/.test(f));
+        if (!dumpFile) throw new Error('Database inventory required for Storage metadata');
+        const dump = readDump(path.join(backupDir, dumpFile));
+        const objects = records(dump.tables.find(t => t.schema === 'storage' && t.name === 'objects'))
+          .filter(o => o.bucket_id === bucket.id).map(o => ({ ...o, metadata: JSON.parse(o.metadata || '{}') }));
+
         const bucketInfo = {
           id: bucket.id,
           name: bucket.name,