smoonb 0.0.59 → 0.0.60

package/README.md

@@ -242,6 +242,39 @@ npx smoonb restore
 - ✅ `.backup.gz` (compactado) - Descompacta automaticamente antes de restaurar
 - ✅ `.backup` (descompactado) - Restaura diretamente
 
+### Importar Backup do Dashboard do Supabase
+
+Se você baixou um backup diretamente do Dashboard do Supabase (formato `.backup.gz`), você pode importá-lo para o formato esperado pelo smoonb:
+
+```bash
+npx smoonb import --file "caminho/completo/para/db_cluster-04-03-2024@14-16-59.backup.gz"
+```
+
+**O que o comando faz:**
+1. Lê o arquivo `.backup.gz` do Dashboard
+2. Extrai informações do nome do arquivo (data e hora)
+3. Cria uma pasta de backup no formato esperado (`backup-YYYY-MM-DD-HH-MM-SS`)
+4. Copia o arquivo para a pasta criada
+5. Deixa o backup pronto para ser encontrado pelo comando `restore`
+
+**Exemplo completo:**
+```bash
+# 1. Baixar backup do Dashboard do Supabase
+#    Arquivo: db_cluster-04-03-2024@14-16-59.backup.gz
+
+# 2. Importar o arquivo
+npx smoonb import --file "C:\Downloads\db_cluster-04-03-2024@14-16-59.backup.gz"
+
+# 3. Restaurar o backup importado
+npx smoonb restore
+# O backup importado aparecerá na lista de backups disponíveis
+```
+
+**Importante:**
+- O arquivo deve estar no formato do Dashboard: `db_cluster-DD-MM-YYYY@HH-MM-SS.backup.gz`
+- O caminho pode ser absoluto ou relativo
+- O comando criará a estrutura de pastas necessária automaticamente
+
 ### Verificação Pós-Restore
 
 ```bash
@@ -263,6 +296,7 @@ npx smoonb check
 |---------|-----------|
 | `npx smoonb backup` | Backup completo interativo usando Docker |
 | `npx smoonb restore` | Restauração interativa usando psql (Docker) |
+| `npx smoonb import --file <path>` | Importar arquivo .backup.gz do Dashboard do Supabase |
 | `npx smoonb check` | Verificação de integridade pós-restore |
 
 ## 🏗️ Arquitetura Técnica

package/bin/smoonb.js

@@ -23,11 +23,14 @@ const program = new Command();
 // Configuração básica do programa
 program
   .name('smoonb')
-  .description('Complete Supabase backup and migration tool - EXPERIMENTAL VERSION - USE AT YOUR OWN RISK')
+  .description('Complete Supabase backup and migration tool')
   .version(packageJson.version, '-v, --version', 'display version number')
   .addHelpText('before', () => {
     showBetaBanner();
-    return '';
+    return chalk.yellow.bold('\n⚠️  TERMO DE USO E AVISO DE RISCO\n') +
+      chalk.white('Ao prosseguir, você reconhece e concorda que o Supa Moonbase (smoonb) é fornecido "NO ESTADO EM QUE SE ENCONTRA" ("AS IS") e "CONFORME DISPONIBILIDADE", sem garantias de qualquer natureza—expressas, implícitas ou legais—incluindo, sem limitação, garantias de comercialização, adequação a um fim específico e não violação, na máxima extensão permitida pela lei aplicável. Operações de backup e restauração envolvem riscos, os ambientes variam amplamente e não é possível prever ou validar todas as configurações dos usuários. Você é o único responsável por validar seu ambiente, manter cópias independentes e verificar os resultados antes de utilizá-los em produção. O Supa Moonbase (smoonb) é construído com repositórios públicos, auditáveis e software livre, para auxiliar pessoas a simplificar seus fluxos, sem com isso criar qualquer garantia, promessa de suporte ou compromisso de nível de serviço.\n\n') +
+      chalk.white('Limitação de responsabilidade (PT-BR) — Na máxima extensão permitida por lei, a Goalmoon, seus contribuidores e licenciadores não serão responsáveis por danos indiretos, incidentais, especiais, consequentes, exemplares ou punitivos (incluindo perda de dados, interrupção de negócios ou lucros cessantes) decorrentes do uso, incapacidade de uso, das operações de backup/restauração realizadas com, ou dos resultados gerados pelo Supa Moonbase (smoonb). Em qualquer hipótese, a responsabilidade total por todas as reivindicações relacionadas ao Supa Moonbase (smoonb) não excederá o valor pago por você pelo Supa Moonbase (smoonb) nos 12 meses anteriores ao evento. Nada neste aviso exclui ou limita responsabilidades onde tais limites sejam proibidos por lei, incluindo (conforme aplicável) dolo ou culpa grave.\n\n') +
+      chalk.white('Observação para consumidores no Brasil (PT-BR) — Para consumidores brasileiros, este aviso não afasta direitos irrenunciáveis previstos no Código de Defesa do Consumidor (CDC); qualquer limitação aqui prevista só se aplica nos limites da lei e não impede a indenização obrigatória quando cabível.\n\n');
   })
   .addHelpText('after', () => {
     return chalk.cyan.bold(`
@@ -60,6 +63,14 @@ program
   .option('-o, --output <file>', 'Arquivo de saída do relatório', 'check-report.json')
   .action(commands.check);
 
+program
+  .command('import')
+  .description('Importar arquivo .backup.gz do Dashboard do Supabase')
+  .requiredOption('-f, --file <path>', 'Caminho completo do arquivo .backup.gz a importar')
+  .action(async (options) => {
+    await commands.import({ file: options.file });
+  });
+
 // Tratamento de erros
 program.on('command:*', function (operands) {
   console.error(chalk.red.bold('❌ Comando não reconhecido:'), operands[0]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smoonb",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "description": "Complete Supabase backup and migration tool - EXPERIMENTAL VERSION - USE AT YOUR OWN RISK",
   "preferGlobal": false,
   "preventGlobalInstall": true,

package/src/commands/import.js

@@ -0,0 +1,91 @@
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs').promises;
+const { ensureDir } = require('../utils/fsx');
+const { readEnvFile } = require('../utils/env');
+const { showBetaBanner } = require('../utils/banner');
+
+/**
+ * Comando para importar arquivo .backup.gz do Dashboard do Supabase
+ */
+module.exports = async (options) => {
+  showBetaBanner();
+  
+  try {
+    // Validar que o arquivo foi fornecido
+    if (!options.file) {
+      console.error(chalk.red('❌ Arquivo não fornecido'));
+      console.log(chalk.yellow('💡 Use: npx smoonb --import --file <caminho-completo-do-arquivo>'));
+      console.log(chalk.gray('   Exemplo: npx smoonb --import --file "C:\\Downloads\\db_cluster-04-03-2024@14-16-59.backup.gz"'));
+      process.exit(1);
+    }
+
+    const sourceFile = path.resolve(options.file);
+    
+    // Verificar se o arquivo existe
+    try {
+      await fs.access(sourceFile);
+    } catch {
+      console.error(chalk.red(`❌ Arquivo não encontrado: ${sourceFile}`));
+      process.exit(1);
+    }
+
+    // Verificar se é um arquivo .backup.gz
+    if (!sourceFile.endsWith('.backup.gz') && !sourceFile.endsWith('.backup')) {
+      console.error(chalk.red('❌ Arquivo deve ser .backup.gz ou .backup'));
+      process.exit(1);
+    }
+
+    // Ler .env.local para obter SMOONB_OUTPUT_DIR
+    const envPath = path.join(process.cwd(), '.env.local');
+    let outputDir = './backups';
+    
+    try {
+      const currentEnv = await readEnvFile(envPath);
+      outputDir = currentEnv.SMOONB_OUTPUT_DIR || './backups';
+    } catch {
+      // Se não conseguir ler .env.local, usar padrão
+      console.log(chalk.yellow('⚠️  Não foi possível ler .env.local, usando diretório padrão: ./backups'));
+    }
+
+    // Extrair informações do nome do arquivo
+    // Formato esperado: db_cluster-DD-MM-YYYY@HH-MM-SS.backup.gz
+    const fileName = path.basename(sourceFile);
+    const match = fileName.match(/db_cluster-(\d{2})-(\d{2})-(\d{4})@(\d{2})-(\d{2})-(\d{2})\.backup(\.gz)?/);
+    
+    if (!match) {
+      console.error(chalk.red('❌ Nome do arquivo não está no formato esperado do Dashboard'));
+      console.log(chalk.yellow('💡 Formato esperado: db_cluster-DD-MM-YYYY@HH-MM-SS.backup.gz'));
+      console.log(chalk.gray(`   Arquivo recebido: ${fileName}`));
+      process.exit(1);
+    }
+
+    const [, day, month, year, hour, minute, second] = match;
+    
+    // Criar nome da pasta no formato backup-YYYY-MM-DD-HH-MM-SS
+    const backupDirName = `backup-${year}-${month}-${day}-${hour}-${minute}-${second}`;
+    const backupDir = path.join(outputDir, backupDirName);
+    
+    // Criar diretório de backup
+    await ensureDir(backupDir);
+    console.log(chalk.blue(`📁 Criando diretório de backup: ${backupDirName}`));
+    
+    // Copiar arquivo para o diretório de backup
+    const destFile = path.join(backupDir, fileName);
+    await fs.copyFile(sourceFile, destFile);
+    
+    // Obter tamanho do arquivo
+    const stats = await fs.stat(destFile);
+    const sizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+    
+    console.log(chalk.green(`✅ Arquivo importado com sucesso!`));
+    console.log(chalk.blue(`📁 Localização: ${backupDir}`));
+    console.log(chalk.blue(`📦 Arquivo: ${fileName} (${sizeMB} MB)`));
+    console.log(chalk.cyan(`\n💡 Próximo passo: Execute 'npx smoonb restore' para restaurar este backup`));
+    
+  } catch (error) {
+    console.error(chalk.red(`❌ Erro ao importar arquivo: ${error.message}`));
+    process.exit(1);
+  }
+};
+

package/src/index.js

@@ -13,6 +13,7 @@ const { showBetaBanner } = require('./utils/banner');
 const backupCommand = require('./commands/backup');
 const restoreCommand = require('./commands/restore');
 const checkCommand = require('./commands/check');
+const importCommand = require('./commands/import');
 
 // Exportar utilitários
 const supabaseUtils = require('./utils/supabase');
@@ -218,7 +219,8 @@ module.exports = {
   commands: {
     backup: backupCommand,
     restore: restoreCommand,
-    check: checkCommand
+    check: checkCommand,
+    import: importCommand
   },
   
   // Utilitários